Data Landing Zone

IMPORTANT
Diese Seite ist spezifisch für den Data Landing Zone source -Connector im Experience Platform. Informationen zum Herstellen einer Verbindung zum Data Landing Zone Ziel-Connector finden Sie auf der Seite Data Landing Zone Zieldokumentation.

Data Landing Zone ist eine von Adobe Experience Platform bereitgestellte Azure Blob Speicherschnittstelle, über die Sie auf eine sichere, Cloud-basierte Dateispeichereinrichtung zugreifen können, um Dateien in Platform zu laden. Sie haben Zugriff auf einen Data Landing Zone-Container pro Sandbox, und das gesamte Datenvolumen über alle Container hinweg ist auf die Gesamtdaten beschränkt, die mit Ihrer Produkt- und Services-Lizenz von Platform bereitgestellt werden. Alle Experience Platform-Kunden erhalten einen Data Landing Zone -Container pro Sandbox. Sie können Dateien in Ihren Container über Azure Storage Explorer oder Ihre Befehlszeilenschnittstelle lesen und schreiben.

Data Landing Zone unterstützt die SAS-basierte Authentifizierung, und die Daten werden im Ruhezustand und bei der Übertragung mit standardmäßigen Azure Blob-Speichersicherheitsmechanismen geschützt. Mit der SAS-basierten Authentifizierung können Sie sicher über eine öffentliche Internetverbindung auf Ihren Data Landing Zone-Container zugreifen. Es sind keine Netzwerkänderungen erforderlich, damit Sie auf Ihren Data Landing Zone -Container zugreifen können. Dies bedeutet, dass Sie keine Zulassungslisten oder regionenübergreifenden Setups für Ihr Netzwerk konfigurieren müssen. Experience Platform erzwingt eine strikte Ablaufzeit von sieben Tagen für alle Dateien und Ordner, die in einen Data Landing Zone -Container hochgeladen wurden. Alle Dateien und Ordner werden nach sieben Tagen gelöscht.

NOTE
Wenn Sie über Azure Data Factory auf Data Landing Zone zugreifen möchten, müssen Sie einen verknüpften Dienst für Data Landing Zone mit den von Experience Platform bereitgestellten SAS-Anmeldedaten erstellen. Nachdem Sie den verknüpften Dienst erstellt haben, können Sie Ihre Data Landing Zone durchsuchen, indem Sie anstelle des standardmäßigen Stammpfads den Containerpfad auswählen.

Namensbeschränkungen für Dateien und Verzeichnisse

Im Folgenden finden Sie eine Liste von Einschränkungen, die Sie bei der Benennung Ihrer Cloud-Speicherdateien oder -Verzeichnisse berücksichtigen müssen.

  • Die Namen von Verzeichnis- und Dateikomponenten dürfen nicht länger als 255 Zeichen sein.
  • Verzeichnis- und Dateinamen dürfen nicht mit einem Schrägstrich (/) enden. Wenn angegeben, wird er automatisch entfernt.
  • Die folgenden Zeichen der reservierten URL müssen ordnungsgemäß maskiert sein: ! ' ( ) ; @ & = + $ , % # [ ]
  • Die folgenden Zeichen sind nicht zulässig: " \ / : | < > * ?.
  • Unzulässige URL-Pfadzeichen sind nicht zulässig. Code-Punkte wie \uE000 sind zwar in NTFS-Dateinamen gültig, aber keine gültigen Unicode-Zeichen. Darüber hinaus sind einige ASCII- oder Unicode-Zeichen, wie Steuerzeichen (z. B. 0x00 bis 0x1F, \u0081 usw.), ebenfalls nicht zulässig. Regeln für Unicode-Zeichenfolgen in HTTP/1.1 finden Sie unter RFC 2616, Abschnitt 2.2: Grundregeln und RFC 3987.
  • Die folgenden Dateinamen sind nicht zulässig: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, Punktzeichen (.) und zwei Punktzeichen (…).

Verwalten des Inhalts Ihrer Data Landing Zone manage-the-contents-of-your-data-landing-zone

Sie können Azure Storage Explorer verwenden, um die Inhalte Ihres Data Landing Zone-Containers zu verwalten.

Wählen Sie in der Benutzeroberfläche von Azure Storage Explorer das Verbindungssymbol im linken Navigationsbereich aus. Das Fenster Ressource auswählen wird angezeigt, in dem Sie Optionen für das Verbinden finden. Wählen Sie Blob container aus, um eine Verbindung zu Data Landing Zone herzustellen.

select-resource

Wählen Sie als Nächstes Shared Access Signature URL (SAS) als Verbindungsmethode und klicken Sie dann auf Weiter.

select-connection-method

Nach Auswahl Ihrer Verbindungsmethode müssen Sie als Nächstes einen Anzeigenamen und die BlobContainer-SAS-URL angeben, die Ihrem Data Landing Zone -Container entsprechen.

TIP
Sie können Ihre Data Landing Zone -Anmeldedaten aus dem Quellkatalog in der Platform-Benutzeroberfläche abrufen.

Geben Sie Ihre Data Landing Zone SAS-URL ein und wählen Sie dann Weiter aus.

enter-connection-info

Das Fenster Zusammenfassung wird angezeigt. Es gibt Ihnen einen Überblick über Ihre Einstellungen, einschließlich Informationen zu Ihrem Blob-Endpunkt und Berechtigungen. Wenn Sie bereit sind, klicken Sie auf Verbinden.

Zusammenfassung

Eine erfolgreiche Verbindung aktualisiert Ihre Benutzeroberfläche von Azure Storage Explorer mit Ihrem Data Landing Zone-Container.

dlz-user-container

Wenn Ihr Data Landing Zone -Container mit Azure Storage Explorer verbunden ist, können Sie jetzt mit dem Hochladen von Dateien in Ihren Data Landing Zone -Container beginnen. Wählen Sie zum Hochladen Hochladen und dann Dateien hochladen aus.

upload

Nachdem Sie die hochzuladende Datei ausgewählt haben, müssen Sie den Blob-Typ, als den Sie sie hochladen möchten, und das gewünschte Zielverzeichnis angeben. Wählen Sie abschließend Upload aus.

Blob types
Beschreibung
Block Blob
Block Blobs ist für das effiziente Hochladen großer Datenmengen optimiert. Block Blobs ist die Standardoption für Data Landing Zone.
Anhängen von Blob
Das Anhängen von Blobs ist für das Anhängen von Daten an das Ende der Datei optimiert.

upload-files

Hochladen von Dateien in Ihre Data Landing Zone über die Befehlszeilenschnittstelle

Sie können auch die Befehlszeilenschnittstelle Ihres Geräts verwenden und auf die Upload-Dateien zu Ihrem Data Landing Zone zugreifen.

Datei mit Bash hochladen

Im folgenden Beispiel werden Bash und cURL verwendet, um eine Datei mit der REST-API Azure Blob Storage in eine Datei mit dem Wert Data Landing Zone hochzuladen:

# 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}"

Datei mit Python hochladen

Im folgenden Beispiel wird Microsoft’s Python v12 SDK verwendet, um eine Datei in ein Data Landing Zone hochzuladen:

TIP
Im folgenden Beispiel wird zwar der vollständige SAS-URI verwendet, um eine Verbindung zu einem Azure Blob -Container herzustellen, Sie können jedoch andere Methoden und Vorgänge verwenden, um sich zu authentifizieren. Weitere Informationen finden Sie in diesem Microsoft Dokument im 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)

Eine Datei mit AzCopy hochladen

Im folgenden Beispiel wird das Dienstprogramm Microsoft’s AzCopy verwendet, um eine Datei in eine Data Landing Zone hochzuladen:

TIP
Im folgenden Beispiel wird zwar der Befehl copy verwendet, Sie können jedoch mithilfe von AzCopy andere Befehle und Optionen zum Hochladen einer Datei in Ihren Data Landing Zone verwenden. Weitere Informationen finden Sie in diesem Microsoft AzCopy Dokument .
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

Data Landing Zone mit Platform verbinden

Die folgende Dokumentation enthält Informationen dazu, wie Sie Daten aus Ihrem Data Landing Zone -Container mit APIs oder der Benutzeroberfläche in Adobe Experience Platform importieren können.

Verwenden von APIs

Verwenden der Benutzeroberfläche

IMPORTANT
Private Links werden derzeit nicht unterstützt, wenn eine Verbindung mit Experience Platform über den Data Landing Zone hergestellt wird. Die einzigen unterstützten Zugriffsmethoden sind die in hier aufgeführten Methoden.
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089