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 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 (som0x00
till0x1F
,\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.
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:
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.