Data Landing Zone

Data Landing Zone är ett Azure Blob-lagringsgränssnitt som tillhandahålls av Adobe Experience Platform, vilket ger dig tillgång till en säker, molnbaserad fillagringsfunktion för att hämta filer till plattformen. Du har åtkomst till en Data Landing Zone-behållare per sandlåda, och den totala datavolymen för alla behållare är begränsad till den totala datamängden som tillhandahålls med plattformsprodukten och tjänstlicensen. Alla kunder i Experience Platform har etablerats med en Data Landing Zone-behållare per sandlåda. Du kan läsa och skriva filer till behållaren via Azure Storage Explorer eller kommandoradsgränssnittet.

Data Landing Zone har stöd för SAS-baserad autentisering och dess data skyddas med standardsäkerhetsmekanismer för lagring i Azure Blob vid vila och överföring. Med SAS-baserad autentisering kan du få säker åtkomst till din Data Landing Zone-behållare via en offentlig internetanslutning. Du behöver inte göra några nätverksändringar för att komma åt din Data Landing Zone-behållare, vilket innebär att du inte behöver konfigurera några tillåtelselista- eller korsregionsinställningar för ditt nätverk. Experience Platform tillämpar en strikt 7-dagars förfallotid för alla filer och mappar som överförts till en Data Landing Zone-behållare. Alla filer och mappar tas bort efter sju dagar.

Namnbegränsningar för filer och kataloger

Nedan följer en lista över begränsningar som du måste ta hänsyn till när du namnger molnlagringsfiler eller -kataloger.

Hantera innehållet i din Data Landing Zone manage-the-contents-of-your-data-landing-zone

Du kan använda Azure Storage Explorer för att hantera innehållet i Data Landing Zone-behållaren.

I användargränssnittet för Azure Storage Explorer väljer du anslutningsikonen i den vänstra navigeringen. Fönstret Välj resurs visas med alternativ att ansluta till. Välj Blob container om du vill ansluta till Data Landing Zone.

Välj sedan URL för delad åtkomstsignatur (SAS) som anslutningsmetod och välj sedan Nästa.

När du har valt anslutningsmetod måste du sedan ange visningsnamn och Blobbehållar-SAS-URL:en som motsvarar Data Landing Zone-behållaren.

Ange din Data Landing Zone SAS-URL och välj sedan Nästa

Fönstret Sammanfattning visas med en översikt över dina inställningar, inklusive information om din Blob-slutpunkt och behörigheter. Välj Anslut när du är klar.

En anslutning uppdaterar användargränssnittet för Azure Storage Explorer med behållaren för Data Landing Zone.

Med din Data Landing Zone-behållare ansluten till Azure Storage Explorer kan du nu börja överföra filer till Data Landing Zone-behållaren. Om du vill överföra väljer du Överför och sedan Överför filer.

När du har valt den fil som du vill överföra måste du sedan identifiera den Blob-typ som du vill överföra den som och den målkatalog som du vill använda. När du är klar väljer du Överför.

Överför filer till Data Landing Zone med kommandoradsgränssnittet

Du kan också använda kommandoradsgränssnittet för enheten och få åtkomst till överföringsfiler till Data Landing Zone.

Överföra en fil med Bash

I följande exempel används Bash och cURL för att överföra en fil till en Data Landing Zone med REST API:t 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}"

Överföra en fil med Python

I följande exempel används Microsoft’s Python v12 SDK för att överföra en fil till en 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)

Överför en fil med AzCopy

I följande exempel används verktyget Microsoft’s AzCopy för att överföra en fil till en 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

Anslut Data Landing Zone till Platform

Dokumentationen nedan innehåller information om hur du hämtar data från din Data Landing Zone-behållare till Adobe Experience Platform med hjälp av API:er eller användargränssnittet.

Använda API:er

Använda gränssnittet