Data Landing Zone

IMPORTANT
Questa pagina è specifica per il connettore Data Landing Zone source in Experience Platform. Per informazioni sulla connessione al connettore Data Landing Zone destination, consulta la Data Landing Zone pagina della documentazione di destinazione.

Data Landing Zone è un'interfaccia di archiviazione Azure Blob fornita da Adobe Experience Platform, che consente di accedere a una struttura di archiviazione dei file sicura e basata su cloud per inserire i file in Platform. È possibile accedere a un contenitore Data Landing Zone per sandbox e il volume totale di dati in tutti i contenitori è limitato ai dati totali forniti con la licenza di Platform Products and Services. Per tutti i clienti di Platform e delle relative applicazioni, ad esempio Customer Journey Analytics, Journey Orchestration, Intelligent Services e Adobe Real-Time Customer Data Platform, viene eseguito il provisioning con un contenitore Data Landing Zone per sandbox. È possibile leggere e scrivere i file nel contenitore tramite Azure Storage Explorer o l'interfaccia della riga di comando.

Data Landing Zone supporta l'autenticazione basata su SAS e i relativi dati sono protetti con meccanismi di protezione di archiviazione standard Azure Blob in modalità di riposo e transito. L'autenticazione basata su SAS consente di accedere in modo sicuro al contenitore Data Landing Zone tramite una connessione Internet pubblica. Non sono necessarie modifiche di rete per accedere al contenitore Data Landing Zone, pertanto non è necessario configurare elenchi consentiti o impostazioni per più aree geografiche per la rete. Platform applica un tempo di scadenza di sette giorni rigoroso su tutti i file caricati in un contenitore Data Landing Zone. Tutti i file vengono eliminati dopo sette giorni.

Vincoli di denominazione per file e directory

Di seguito è riportato un elenco di vincoli di cui è necessario tenere conto per la denominazione dei file o delle directory di archiviazione cloud.

  • I nomi dei componenti di directory e file non possono superare i 255 caratteri.
  • I nomi di file e directory non possono terminare con una barra (/). Se fornito, verrà rimosso automaticamente.
  • I seguenti caratteri URL riservati devono essere correttamente preceduti dall'escape: ! ' ( ) ; @ & = + $ , % # [ ]
  • I seguenti caratteri non sono consentiti: " \ / : | < > * ?.
  • Caratteri di percorso URL non validi non consentiti. I punti di codice come \uE000, sebbene validi nei nomi di file NTFS, non sono caratteri Unicode validi. Inoltre, alcuni caratteri ASCII o Unicode, come i caratteri di controllo (ad esempio da 0x00 a 0x1F, \u0081 e così via), non sono consentiti. Per le regole che regolano le stringhe Unicode in HTTP/1.1, vedere RFC 2616, Sezione 2.2: Regole di base e RFC 3987.
  • Non sono consentiti i seguenti nomi di file: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, carattere punto (.) e due caratteri punto (…).

Gestione dei contenuti dell’area di destinazione dati manage-the-contents-of-your-data-landing-zone

È possibile utilizzare Azure Storage Explorer per gestire il contenuto del contenitore Data Landing Zone.

Nell'interfaccia utente Azure Storage Explorer, selezionare l'icona di connessione nell'area di navigazione a sinistra. Viene visualizzata la finestra Seleziona risorsa che fornisce le opzioni per la connessione. Selezionare Blob container per connettersi a Data Landing Zone.

select-resource

Selezionare URL firma di accesso condiviso (SAS) come metodo di connessione, quindi selezionare Avanti.

select-connection-method

Dopo aver selezionato il metodo di connessione, è necessario fornire nome visualizzato e l'URL SAS del contenitore Blob che corrisponde al contenitore Data Landing Zone.

TIP
È possibile recuperare le credenziali di Data Landing Zone dal catalogo delle origini nell'interfaccia utente di Platform.

Fornisci l'URL SAS Data Landing Zone e seleziona Avanti

enter-connection-info

Viene visualizzata la finestra Riepilogo che fornisce una panoramica delle impostazioni, incluse informazioni sull'endpoint Blob e sulle autorizzazioni. Al termine, selezionare Connetti.

riepilogo

Una connessione riuscita aggiorna l'interfaccia utente di Azure Storage Explorer con il contenitore Data Landing Zone.

dlz-user-container

Con il contenitore Data Landing Zone connesso a Azure Storage Explorer, ora puoi iniziare a caricare i file nel contenitore Data Landing Zone. Per caricare, selezionare Carica, quindi selezionare Carica file.

carica

Dopo aver selezionato il file da caricare, è necessario identificare il tipo Blob che si desidera caricare e la directory di destinazione desiderata. Al termine, selezionare Carica.

Blob tipi
Descrizione
Blocca Blob
Il blocco Blobs è ottimizzato per il caricamento di grandi quantità di dati in modo efficiente. Blocco Blobs: opzione predefinita per Data Landing Zone.
Aggiungi Blob
Aggiunta di Blobs ottimizzata per l'aggiunta di dati alla fine del file.

upload-files

Carica i file in Data Landing Zone tramite l'interfaccia della riga di comando

È inoltre possibile utilizzare l'interfaccia della riga di comando del dispositivo e accedere ai file di caricamento in Data Landing Zone.

Caricare un file con Bash

Nell'esempio seguente vengono utilizzati Bash e cURL per caricare un file in un Data Landing Zone con l'API REST Azure Blob Storage:

# Set Azure Blob-related settings
DATE_NOW=$(date -Ru | sed 's/\+0000/GMT/')
AZ_VERSION="2018-03-28"
AZ_BLOB_URL="<URL TO BLOB ACCOUNT>"
AZ_BLOB_CONTAINER="<BLOB CONTAINER NAME>"
AZ_BLOB_TARGET="${AZ_BLOB_URL}/${AZ_BLOB_CONTAINER}"
AZ_SAS_TOKEN="<SAS TOKEN, STARTING WITH ? AND ENDING WITH %3D>"

# Path to the file we wish to upload
FILE_PATH="</PATH/TO/FILE>"
FILE_NAME=$(basename "$FILE_PATH")

# Execute HTTP PUT to upload file (remove '-v' flag to suppress verbose output)
curl -v -X PUT \
   -H "Content-Type: application/octet-stream" \
   -H "x-ms-date: ${DATE_NOW}" \
   -H "x-ms-version: ${AZ_VERSION}" \
   -H "x-ms-blob-type: BlockBlob" \
   --data-binary "@${FILE_PATH}" "${AZ_BLOB_TARGET}/${FILE_NAME}${AZ_SAS_TOKEN}"

Caricare un file con Python

Nell'esempio seguente viene utilizzato l'SDK Python v12 di Microsoft’s per caricare un file in un Data Landing Zone:

TIP
Nell'esempio seguente viene utilizzato l'URI SAS completo per la connessione a un contenitore Azure Blob, ma è possibile utilizzare altri metodi e operazioni per l'autenticazione. Per ulteriori informazioni, consulta questo Microsoft documento su Python v12 SDK.
import os
from azure.storage.blob import ContainerClient

try:
    # Set Azure Blob-related settings
    sasUri = "<SAS URI>"
    srcFilePath = "<FULL PATH TO FILE>"
    srcFileName = os.path.basename(srcFilePath)

    # Connect to container using SAS URI
    containerClient = ContainerClient.from_container_url(sasUri)

    # Upload file to Data Landing Zone with overwrite enabled
    with open(srcFilePath, "rb") as fileToUpload:
        containerClient.upload_blob(srcFileName, fileToUpload, overwrite=True)

except Exception as ex:
    print("Exception: " + ex.strerror)

Carica un file con AzCopy

Nell'esempio seguente viene utilizzata l'utilità Microsoft’s AzCopy per caricare un file in un Data Landing Zone:

TIP
Mentre l'esempio seguente utilizza il comando copy, è possibile utilizzare altri comandi e opzioni per caricare un file in Data Landing Zone, utilizzando AzCopy. Per ulteriori informazioni, vedere il Microsoft AzCopy documento.
set sasUri=<FULL SAS URI, PROPERLY ESCAPED>
set srcFilePath=<PATH TO LOCAL FILE(S); WORKS WITH WILDCARD PATTERNS>

azcopy copy "%srcFilePath%" "%sasUri%" --overwrite=true --recursive=true

Connetti Data Landing Zone a Platform

La documentazione seguente fornisce informazioni su come portare dati dal contenitore Data Landing Zone a Adobe Experience Platform utilizzando le API o l'interfaccia utente.

Utilizzo delle API

Utilizzo dell’interfaccia utente

IMPORTANT
I collegamenti privati non sono attualmente supportati per la connessione ad Experience Platform tramite Data Landing Zone. Gli unici metodi supportati per l'accesso sono i metodi elencati qui.
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089