Data Landing Zone

IMPORTANT
Den här sidan är specifik för Data Landing Zone source-kopplingen i Experience Platform. Information om hur du ansluter till Data Landing Zone destination-kopplingen finns på Data Landing Zone dokumentationssidan för målet.

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 med Platform och dess program som Customer Journey Analytics, Journey Orchestration, Intelligent Services och Adobe Real-Time Customer Data Platform etableras 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. Plattformen tillämpar en strikt 7-dagars förfallotid för alla filer som överförs till en Data Landing Zone-behållare. Alla filer 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.

  • Katalog- och filkomponentnamn får inte innehålla fler än 255 tecken.
  • Katalog- och filnamn får inte sluta med ett snedstreck (/). Den tas bort automatiskt om den anges.
  • Följande reserverade URL-tecken måste ha escape-konverterats: ! ' ( ) ; @ & = + $ , % # [ ]
  • Följande tecken tillåts inte: " \ / : | < > * ?.
  • Ogiltiga URL-sökvägstecken tillåts inte. Kodpunkter som \uE000 är inte giltiga Unicode-tecken, men de är giltiga i NTFS-filnamn. Dessutom tillåts inte vissa ASCII- eller Unicode-tecken, som kontrolltecken (som 0x00 till 0x1F, \u0081 och så vidare). Information om regler som styr Unicode-strängar i HTTP/1.1 finns i RFC 2616, Section 2.2: Basic Rules och RFC 3987.
  • Följande filnamn tillåts inte: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, punkttecken (.) och två punkttecken (. .).

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.

select-resource

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

select-connection-method

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.

TIP
Du kan hämta dina Data Landing Zone-autentiseringsuppgifter från källkatalogen i plattformsgränssnittet.

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

enter-connection-info

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.

sammanfattning

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

dlz-user-container

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.

överföring

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.

Blob typer
Beskrivning
Blockera Blob
Blocket Blobs är optimerat för att överföra stora mängder data på ett effektivt sätt. Block Blobs är standardalternativet för Data Landing Zone.
Lägg till Blob
Tillägget Blobs är optimerat för att lägga till data i slutet av filen.

upload-files

Ö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:

TIP
I exemplet nedan används den fullständiga SAS-URI:n för att ansluta till en Azure Blob-behållare, men du kan använda andra metoder och åtgärder för att autentisera. Mer information finns i det här Microsoft dokumentet om 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)

Ö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:

TIP
I exemplet nedan används kommandot copy, men du kan använda andra kommandon och alternativ för att överföra en fil till Data Landing Zone med hjälp av AzCopy. Mer information finns i det här Microsoft AzCopy dokumentet.
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

IMPORTANT
Privata länkar stöds för närvarande inte vid anslutning till Experience Platform med Data Landing Zone. De enda metoder som stöds för åtkomst är de metoder som anges här.
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089