Data Landing Zone

IMPORTANT
Questa pagina è specifica per Data Landing Zone sorgente connettore in Experience Platform. Per informazioni sulla connessione al Data Landing Zone destinazione connettore, fare riferimento al Data Landing Zone pagina della documentazione di destinazione.

Data Landing Zone è un Azure Blob con il provisioning di Adobe Experience Platform, ti consente di accedere a una struttura di archiviazione dei file sicura e basata su cloud per inserire i file in Platform. Puoi accedervi Data Landing Zone contenitore per sandbox e il volume totale di dati in tutti i contenitori è limitato al totale dei dati forniti con la licenza Platform Products and Services. Tutti i clienti di Platform e dei relativi servizi applicativi, ad esempio Customer Journey Analytics, Journey Orchestration, Intelligent Services, e Adobe Real-Time Customer Data Platform dispongono di un Data Landing Zone contenitore per sandbox. Puoi leggere e scrivere i file nel contenitore tramite Azure Storage Explorer o dall'interfaccia della riga di comando.

Data Landing Zone supporta l'autenticazione basata su SAS e i relativi dati sono protetti con Azure Blob meccanismi di sicurezza dello stoccaggio a riposo e in transito. L'autenticazione basata su SAS consente di accedere in modo sicuro al Data Landing Zone tramite una connessione Internet pubblica. Non sono necessarie modifiche di rete per accedere al Data Landing Zone Contenitore, che significa che non è necessario configurare elenchi consentiti o configurazioni per più aree geografiche per la rete. Platform impone una scadenza di sette giorni su tutti i file caricati in un Data Landing Zone contenitore. 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 avere un escape corretto: ! ' ( ) ; @ & = + $ , % # [ ]
  • I seguenti caratteri non sono consentiti: " \ / : | < > * ?.
  • Caratteri di percorso URL non validi non consentiti. Punti di codice come \uE000, anche se valido nei nomi di file NTFS, non è costituito da caratteri Unicode validi. Inoltre, alcuni caratteri ASCII o Unicode, come i caratteri di controllo (ad esempio 0x00 a 0x1F, \u0081e così via), non sono consentiti. Per le regole che disciplinano le stringhe Unicode in HTTP/1.1, consulta 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 Data Landing Zone contenitore.

In Azure Storage Explorer UI, seleziona l’icona di connessione nell’area di navigazione a sinistra. Il Seleziona risorsa viene visualizzata una finestra che fornisce le opzioni per la connessione. Seleziona Blob container per connettersi a Data Landing Zone.

select-resource

Quindi, seleziona URL firma di accesso condiviso (SAS) come metodo di connessione e quindi selezionare Successivo.

select-connection-method

Dopo aver selezionato il metodo di connessione, devi fornire un nome visualizzato e BlobURL SAS contenitore che corrisponde al tuo Data Landing Zone contenitore.

TIP
Puoi recuperare Data Landing Zone credenziali dal catalogo delle origini nell’interfaccia utente di Platform.

Fornisci Data Landing Zone URL SAS, quindi selezionare Successivo

enter-connection-info

Il Riepilogo viene visualizzata una finestra che fornisce una panoramica delle impostazioni, incluse informazioni Blob endpoint e autorizzazioni. Quando è pronto, seleziona Connetti.

riepilogo

Una connessione corretta aggiorna il tuo Azure Storage Explorer Interfaccia utente con Data Landing Zone contenitore.

dlz-user-container

Con Data Landing Zone contenitore connesso a Azure Storage Explorer, ora puoi iniziare a caricare i file sul tuo Data Landing Zone contenitore. Per caricare, seleziona Carica e quindi seleziona Carica file.

caricare

Dopo aver selezionato il file da caricare, devi identificare Blob digita che desideri caricare come e la directory di destinazione desiderata. Al termine, seleziona Carica.

Blob tipi
Descrizione
Blocca Blob
Blocca Blobs sono ottimizzate per caricare grandi quantità di dati in modo efficiente. Blocca Blobs sono l’opzione predefinita per Data Landing Zone.
Aggiungi Blob
Aggiungi Blobs sono ottimizzate per aggiungere dati alla fine del file.

upload-files

Carica i file nel tuo Data Landing Zone utilizzo dell’interfaccia della riga di comando

Puoi anche utilizzare l’interfaccia della riga di comando del dispositivo e accedere ai file di caricamento sul tuo 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 Azure Blob Storage API REST:

# 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

L’esempio che segue utilizza Microsoft’s Python v12 SDK per caricare un file in una Data Landing Zone:

TIP
Nell'esempio seguente viene utilizzato l'URI SAS completo per la connessione a un Azure Blob Contenitore, puoi utilizzare altri metodi e operazioni per l’autenticazione. Vedi questo Microsoft documento sull’SDK Python v12 per ulteriori informazioni.
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 tramite AzCopy

L’esempio che segue utilizza Microsoft’s AzCopy utilità per caricare un file in una Data Landing Zone:

TIP
Mentre l’esempio seguente utilizza copy , puoi utilizzare altri comandi e opzioni per caricare un file nel tuo Data Landing Zone, utilizzando AzCopy. Vedi questo Microsoft AzCopy documento per ulteriori informazioni.
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 estrarre i dati dal Data Landing Zone da contenitore a Adobe Experience Platform tramite API o l’interfaccia utente.

Utilizzo delle API

Utilizzo dell’interfaccia utente

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