Data Landing Zone

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. A tutti i clienti Experience Platform viene fornito 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. Experience Platform applica un tempo di scadenza di sette giorni rigoroso su tutti i file e le cartelle caricati in un contenitore Data Landing Zone. Tutti i file e le cartelle 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.

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.

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

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.

Fornisci l'URL SAS Data Landing Zone e seleziona Avanti

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

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

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.

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.

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:

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:

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