Data Landing Zone

IMPORTANT
Den här sidan är specifik för Data Landing Zone källa i Experience Platform. Information om hur du ansluter till Data Landing Zone mål koppling, se Data Landing Zone måldokumentationssida.

Data Landing Zone är en Azure Blob lagringsgränssnittet 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 tillgång till en Data Landing Zone behållare per sandlåda och den totala datavolymen för alla behållare begränsas till den totala datamängd som ingår i din licens för plattformsprodukter och -tjänster. Alla kunder med Platform och dess tillämpningar som Customer Journey Analytics, Journey Orchestration, Intelligent Servicesoch Adobe Real-Time Customer Data 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 stöder SAS-baserad autentisering och dess data skyddas med standard Azure Blob Mekanismer för förvaringssäkerhet i vila och under transitering. SAS-baserad autentisering ger säker åtkomst till Data Landing Zone behållaren via en offentlig internetanslutning. Du behöver inte göra några nätverksändringar Data Landing Zone container, vilket betyder 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 escape-konverteras: ! ' ( ) ; @ & = + $ , % # [ ]
  • Följande tecken tillåts inte: " \ / : | < > * ?.
  • Ogiltiga URL-sökvägstecken tillåts inte. Kodpunkter som \uE000, som är giltigt i NTFS-filnamn, är inte giltiga Unicode-tecken. Dessutom kan vissa ASCII- eller Unicode-tecken, som kontrolltecken (som 0x00 till 0x1F, \u0081och så vidare) tillåts inte heller. Information om regler för Unicode-strängar i HTTP/1.1 finns i RFC 2616, avsnitt 2.2: Grundregler 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ållare.

I Azure Storage Explorer I användargränssnittet väljer du anslutningsikonen i den vänstra navigeringen. The Välj resurs visas så att du kan ansluta till dem. Välj Blob container för att ansluta till Data Landing Zone.

select-resource

Nästa, välj 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 en visningsnamn och Blobcontainer SAS-URL som motsvarar dina Data Landing Zone behållare.

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

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

enter-connection-info

The Sammanfattning visas så att du får en översikt över dina inställningar, inklusive information om Blob slutpunkt och behörigheter. När du är klar väljer du Anslut.

sammanfattning

Anslutningen uppdaterar Azure Storage Explorer Gränssnitt med Data Landing Zone behållare.

dlz-user-container

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

ladda upp

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

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

ladda upp filer

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

Du kan också använda kommandoradsgränssnittet på 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 Azure Blob Storage REST API:

# 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 kan du använda andra metoder och åtgärder för att autentisera. Se det här Microsoft dokument om Python v12 SDK för mer information.
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öra en fil med AzCopy

I följande exempel används Microsoft’s AzCopy verktyg för att överföra en fil till en Data Landing Zone:

TIP
När exemplet nedan använder copy kan du använda andra kommandon och alternativ för att överföra en fil till Data Landing Zone, använda AzCopy. Se det här Microsoft AzCopy dokument för mer information.
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 Data Landing Zone behållare till Adobe Experience Platform med 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