Azure Data Lake Storage Gen2-Verbindung
Übersicht overview
Auf dieser Seite erfahren Sie, wie Sie eine ausgehende Live-Verbindung zu Ihrem Azure Data Lake Storage Gen2 (ADLS Gen2) Data Lake herstellen, um regelmäßig Datendateien aus Experience Platform zu exportieren.
Herstellen einer Verbindung zu Ihrem ADLS Gen2 über API oder Benutzeroberfläche connect-api-or-ui
- Um über die Platform-Benutzeroberfläche eine Verbindung zu Ihrem ADLS Gen2-Speicherort herzustellen, lesen Sie die Abschnitte Mit dem Ziel verbinden und Zielgruppen für dieses Ziel aktivieren.
- Um programmgesteuert eine Verbindung zu Ihrem ADLS Gen2-Speicherort herzustellen, lesen Sie das Tutorial Aktivieren von Zielgruppen für dateibasierte Ziele mithilfe der Flow Service-API.
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Arten von Zielgruppen Sie an dieses Ziel exportieren können.
Exporttyp und -häufigkeit export-type-frequency
Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.
Datensätze exportieren export-datasets
Dieses Ziel unterstützt Datensatzexporte. Vollständige Informationen zum Einrichten von Datensatzexporten finden Sie in den Tutorials:
Dateiformat der exportierten Daten file-format
Beim Exportieren Zielgruppendaten erstellt Platform eine .csv-, parquet- oder .json-Datei an dem von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Unterstützte Dateiformate für den Export im Tutorial zur Zielgruppenaktivierung.
Beim Exportieren Datensätze erstellt Platform eine .parquet- oder .json-Datei an dem von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Überprüfen eines erfolgreichen Datensatzexports im Tutorial zum Exportieren von Datensätzen.
Herstellen einer Verbindung mit dem Ziel connect
Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Zielkonfigurations-Workflow die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.
Beim Ziel authentifizieren authenticate
Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder aus und wählen Sie Mit Ziel verbinden aus.
-
URL: Der Endpunkt für Azure Data Lake Storage Gen2. Das Endpunktmuster ist:
abfss://<container>@<accountname>.dfs.core.windows.net. -
Mandant: Die Mandanteninformationen, die Ihre Anwendung enthalten.
-
Service-Prinzipal-ID: Die Client-ID der Anwendung.
-
Service-Prinzipal-Schlüssel: Der Schlüssel der Anwendung.
-
Verschlüsselungsschlüssel: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihren exportierten Dateien eine Verschlüsselung hinzuzufügen. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.
Ausfüllen der Zieldetails destination-details
Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.
-
Name: Geben Sie einen bevorzugten Namen für das Ziel ein.
-
Beschreibung: Optional. Hier können Sie beispielsweise erwähnen, für welche Kampagne Sie dieses Ziel verwenden.
-
Ordnerpfad: Geben Sie den Pfad zum Zielordner ein, in dem die exportierten Dateien gespeichert werden.
-
Dateityp: Wählen Sie das Format aus, das Experience Platform für die exportierten Dateien verwenden soll. Bei Auswahl der Option CSV können Sie auch die Dateiformatierungsoptionen konfigurieren.
-
Komprimierungsformat: Wählen Sie den Komprimierungstyp aus, den Experience Platform für die exportierten Dateien verwenden soll.
-
Manifestdatei einschließen: Schalten Sie diese Option ein, wenn die Exporte eine JSON-Manifestdatei enthalten sollen, die Informationen zum Exportspeicherort, zur Exportgröße und mehr enthält. Das Manifest wird mit dem Format
manifest-<<destinationId>>-<<dataflowRunId>>.jsonbenannt. Anzeigen einer Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:flowRunId: Die Datenflussausführung die die exportierte Datei generiert hat.scheduledTime: Die Zeit in UTC, zu der die Datei exportiert wurde.exportResults.sinkPath: Der Pfad an Ihrem Speicherort, an dem die exportierte Datei abgelegt wird.exportResults.name: Der Name der exportierten Datei.size: Die Größe der exportierten Datei in Byte.
Aktivieren von Warnhinweisen enable-alerts
Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.
Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.
Aktivieren von Zielgruppen für dieses Ziel activate
-
Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen Zugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
-
Zum Exportieren Identitäten benötigen Sie die Berechtigung Identitätsdiagramm anzeigen Zugriffssteuerung.
Anweisungen Aktivieren von Zielgruppen für dieses Ziel finden SieAktivieren von Zielgruppendaten für Batch-Profil-).
Planung scheduling
Im Schritt Planung können Sie für Ihr Azure Data Lake Storage Gen2-Ziel den Exportplan einrichten, und Sie können dort auch den Namen Ihrer exportierten Dateien konfigurieren.
Zuordnen von Attributen und Identitäten map
Im Schritt Zuordnung können Sie festlegen, welche Attribute und Identitätsfelder für Ihre Profile exportiert werden sollen. Sie können auch festlegen, dass die Kopfzeilen in der exportierten Datei in einen beliebigen Anzeigenamen geändert werden. Weitere Informationen finden Sie im Zuordnungsschritt im Tutorial zur Benutzeroberfläche der Aktivierung von Batch-Zielen.
Überprüfen auf einen erfolgreichen Datenexport exported-data
Überprüfen Sie, ob die Daten erfolgreich exportiert wurden, indem Sie Ihren Azure Data Lake Storage Gen2-Speicher überprüfen, und stellen Sie sicher, dass die exportierten Dateien die erwarteten Profilpopulationen enthalten.