Exportieren von Datensätzen

In diesem Artikel wird beschrieben, wie der Customer Journey Analytics Export datasets verwendet werden kann, um den folgenden Anwendungsfall für den Datenexport zu implementieren:

Einführung

Durch den Export von Daten mit Experience Platform Export datasets können Sie Daten aus Ihren Customer Journey Analytics-Datenansichten an ein beliebiges Cloud-Speicher-Ziel exportieren.

Weitere Informationen

Sie können Rohdatensätze vom Data Lake in Experience Platform zu Cloud-Speicher-Zielen exportieren. Dieser Export erfolgt in der Experience Platform Destinations-Terminologie, die als Datensatzexport-Ziele bezeichnet wird. Eine Übersicht finden Sie unter Exportieren von Datensätzen in Cloud-Speicher-Ziele .

Die folgenden Cloud-Speicher-Ziele werden unterstützt:

Experience Platform-Benutzeroberfläche

Sie können den Export Ihrer Datensätze über die Experience Platform-Benutzeroberfläche planen. In diesem Abschnitt werden die erforderlichen Schritte beschrieben.

Ziel auswählen

Wenn Sie das Cloud-Speicher-Ziel ermittelt haben, an das Sie den Datensatz exportieren möchten, wählen Sie das Zielaus. Wenn Sie noch kein Ziel für Ihren bevorzugten Cloud-Speicher konfiguriert haben, müssen Sie eine neue Zielverbindung erstellen.

Im Zuge der Konfiguration eines Ziels können Sie Folgendes definieren:

Datensatz auswählen

Wenn Sie das Ziel ausgewählt haben, müssen Sie im nächsten Schritt Datensätze auswählen Ihren Datensatz aus der Liste der Datensätze auswählen. Wenn Sie mehrere geplante Abfragen erstellen und möchten, dass die Datensätze an dasselbe Cloud-Speicher-Ziel gesendet werden, können Sie die entsprechenden Datensätze auswählen. Weitere Informationen finden Sie unter Auswählen Ihrer Datensätze .

Planen des Datensatzexports

Schließlich möchten Sie den Export Ihres Datensatzes im Rahmen des Schritts Planung planen. In diesem Schritt können Sie den Zeitplan definieren und festlegen, ob der Datensatzexport inkrementell sein soll oder nicht. Weitere Informationen finden Sie unter Planen des Datensatzexports .

Abgeschlossene Schritte

Überprüfen Sie Ihre Auswahl und starten Sie den Export Ihres Datensatzes in das Cloud-Speicher-Ziel, wenn dies korrekt ist.

Zunächst müssen Sie verifizieren, dass der Datenexport erfolgreich war. Beim Exportieren von Datensätzen erstellt Experience Platform eine oder mehrere .json - oder .parquet -Dateien am Speicherort, der in Ihrem Ziel definiert ist. Erwarten Sie, dass neue Dateien entsprechend dem von Ihnen eingerichteten Exportplan an Ihrem Speicherort abgelegt werden. Experience Platform erstellt eine Ordnerstruktur am Speicherort, den Sie als Teil des ausgewählten Ziels angegeben haben, wo die exportierten Dateien abgelegt werden. Für jeden Exportzeitpunkt wird ein neuer Ordner nach folgendem Muster erstellt: folder-name-you-provided/datasetID/exportTime=YYYYMMDDHHMM. Der standardmäßige Dateiname wird nach dem Zufallsprinzip generiert, was sicherstellt, dass die Namen von exportierten Dateien eindeutig sind.

Flussdienst-API

Alternativ können Sie den Export von Datensätzen mithilfe von APIs exportieren und planen. Die erforderlichen Schritte werden in Exportieren von Datensätzen mithilfe der Flow Service-API dokumentiert.

Erste Schritte

Um Datensätze zu exportieren, stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen verfügen. Überprüfen Sie außerdem, ob das Ziel, an das Sie Ihren Datensatz senden möchten, den Export von Datensätzen unterstützt. Anschließend müssen Sie die Werte für erforderliche und optionale Kopfzeilenerfassen, die Sie in den API-Aufrufen verwenden. Außerdem müssen Sie die Verbindungsspezifikations- und Flussspezifikations-IDs des Ziels identifizieren, an das Sie Datensätze exportieren möchten.

Abrufen zulässiger Datensätze

Sie können eine Liste der für den Export infrage kommenden Datensätze abrufen und mithilfe der API GET /connectionSpecs/{id}/configs überprüfen, ob Ihr Datensatz Teil dieser Liste ist.

Erstellen der Quellverbindung

Als Nächstes müssen Sie eine Quellverbindungfür den Datensatz mit seiner eindeutigen ID erstellen, die Sie an das Cloud-Speicher-Ziel exportieren möchten. Sie verwenden die POST /sourceConnections -API.

Authentifizierung am Ziel (Basisverbindung erstellen)

Sie müssen jetzt eine Basisverbindung erstellen, um die Anmeldeinformationen mithilfe der API POST /targetConection für Ihr Cloud-Speicher-Ziel zu authentifizieren und sicher zu speichern.

Exportparameter angeben

Als Nächstes müssen Sie eine zusätzliche Zielverbindung erstellen, in der die Exportparameter für Ihren Datensatz gespeichert werden, indem Sie die API POST /targetConection erneut verwenden. Zu diesen Exportparametern gehören Speicherort, Dateiformat, Komprimierung und mehr.

Einrichten des Datenflusses

Richten Sie abschließend den Datenfluss 🔗 ein, um sicherzustellen, dass Ihr Datensatz mit der API POST /flows an Ihr Cloud-Speicher-Ziel exportiert wird. In diesem Schritt können Sie den Zeitplan für den Export mithilfe des Parameters scheduleParams definieren.

Validieren des Datenflusses

Um die erfolgreichen Ausführungen Ihres Datenflusses zu überprüfen, verwenden Sie die API GET /runs und geben Sie die Datenfluss-ID als Abfrageparameter an. Diese Datenfluss-ID ist eine Kennung, die beim Einrichten des Datenflusses zurückgegeben wird.

Überprüfen Sie einen erfolgreichen Datenexport. Beim Exportieren von Datensätzen erstellt Experience Platform eine oder mehrere .json - oder .parquet -Dateien am Speicherort, der in Ihrem Ziel definiert ist. Erwarten Sie, dass neue Dateien entsprechend dem von Ihnen eingerichteten Exportplan an Ihrem Speicherort abgelegt werden. Experience Platform erstellt eine Ordnerstruktur am Speicherort, den Sie als Teil des ausgewählten Ziels angegeben haben, wo die exportierten Dateien abgelegt werden. Für jeden Exportzeitpunkt wird ein neuer Ordner nach folgendem Muster erstellt: folder-name-you-provided/datasetID/exportTime=YYYYMMDDHHMM. Der standardmäßige Dateiname wird nach dem Zufallsprinzip generiert, was sicherstellt, dass die Namen von exportierten Dateien eindeutig sind.