Exportieren von Datensätzen

In diesem Artikel wird beschrieben, wie die Customer Journey Analytics Export datasets zur Implementierung des folgenden Anwendungsfalls für den Datenexport“ verwendet ​ kann:

Einführung

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

Im Gegensatz zu anderen Exportmethoden gibt es für Datensätze im Export keine feste Zeilenbegrenzung. Die Kapazität Ihres Cloud-Speicher-Ziels begrenzt die Exportgröße. Daher ist dies die bevorzugte Funktion, wenn Sie eine vollständige Rohkopie Ihrer Daten benötigen.

Weitere Informationen

Verwenden Sie Cloud-Speicherziele, um Rohdatensätze aus dem Data Lake in Experience Platform zu exportieren. Dieser Export wird in der Terminologie von Experience Platform-Zielen als Datensatzexportziele bezeichnet. Eine Übersicht finden Sie unter Exportieren von Datensätzen zu Cloud-Speicher-Zielen.

Die folgenden Cloud-Speicherziele werden unterstützt:

Experience Platform-Benutzeroberfläche

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

Ziel auswählen

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

Beim Konfigurieren eines Ziels können Sie Folgendes definieren:

Datensatz auswählen

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

Planen des Datensatzexports

Planen Sie abschließend den Datensatzexport im Rahmen des Schritts Planung. Definieren Sie in diesem Schritt den Zeitplan und ob der Datensatzexport inkrementell ist. Weitere Informationen ​ Sie unter „Planen ​ Datensatzexports“.

Letzte Schritte

Überprüfen Sie Ihre Auswahl und beginnen Sie, Ihren Datensatz an das Cloud-Speicher-Ziel zu exportieren.

Zunächst müssen Sie ​ erfolgreichen ​ überprüfen. Beim Exportieren von Datensätzen erstellt Experience Platform eine oder mehrere .json oder .parquet Dateien am Speicherort Ihres Ziels. Neue Dateien werden voraussichtlich entsprechend dem von Ihnen eingerichteten Exportzeitplan an Ihrem Speicherort abgelegt. Experience Platform erstellt eine Ordnerstruktur an dem Speicherort, den Sie als Teil des ausgewählten Ziels angegeben haben, und legt dort die exportierten Dateien ab. Für jeden Exportzeitpunkt wird ein neuer Ordner erstellt, der dem Muster folgt: 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.

Flow Service-API

Alternativ können Sie den Export von Datensätzen mithilfe von APIs exportieren und planen. Die hierfür 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. Stellen Sie außerdem sicher, dass das Ziel den Export von Datensätzen unterstützt. Sie können Ihren Datensatz an dieses Ziel senden. Anschließend müssen Sie ​ Werte für erforderliche und optionale Kopfzeilen ​, die Sie in den API-Aufrufen verwenden. Außerdem müssen Sie die Verbindungsspezifikations- und Flussspezifikations-IDs des Ziels identifizieren für das Sie Datensätze exportieren möchten.

Abrufen zulässiger Datensätze

Sie können eine Liste der geeigneten Datensätze abrufen um sie zu exportieren und mithilfe der GET /connectionSpecs/{id}/configs-API zu überprüfen, ob Ihr Datensatz Teil dieser Liste ist.

Quellverbindung erstellen

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

Beim Ziel authentifizieren (Basisverbindung erstellen)

Um Anmeldeinformationen für Ihr Cloud-Speicher-Ziel zu authentifizieren und sicher zu speichern​ erstellen Sie eine Basisverbindung ​ der POST /targetConnection-API.

Exportparameter angeben

Als Nächstes müssen Sie eine zusätzliche Zielverbindung erstellen, die die Exportparameter speichert für Ihren Datensatz mithilfe der POST /targetConnection-API. Zu diesen Exportparametern gehören Speicherort, Dateiformat, Komprimierung und mehr.

Einrichten eines Datenflusses

Um sicherzustellen, dass Ihr Datensatz in Ihr Cloud-Speicher-Ziel exportiert wird, richten Sie den Datenfluss ein indem Sie die POST /flows API verwenden. In diesem Schritt können Sie den Zeitplan für den Export mithilfe des scheduleParams definieren.

Validieren eines Datenflusses

Um erfolgreiche Ausführungen Ihres Datenflusses zu überprüfen verwenden Sie die GET /runs-API 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 einen erfolgreichen Datenexport. Beim Exportieren von Datensätzen erstellt Experience Platform eine oder mehrere .json oder .parquet Dateien am Speicherort Ihres Ziels. Neue Dateien werden voraussichtlich entsprechend dem von Ihnen eingerichteten Exportzeitplan an Ihrem Speicherort abgelegt. Experience Platform erstellt eine Ordnerstruktur an dem Speicherort, den Sie als Teil des ausgewählten Ziels angegeben haben, und legt dort die exportierten Dateien ab. Für jeden Exportzeitpunkt wird ein neuer Ordner erstellt, der dem Muster folgt: 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.