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“ verwendetkann:

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.

Weitere Informationen

Sie können Rohdatensätze aus dem Data Lake in Experience Platform an Cloud-Speicher-Ziele exportieren. Dieser Export wird in der Terminologie für Experience Platform-Ziele als Datensatzexportziele bezeichnet. Siehe Exportieren von Datensätzen zu Cloud-Speicher für eine Übersicht.

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 exportieren und planen. In diesem Abschnitt werden die beteiligten Schritte beschrieben.

Ziel auswählen

Wenn Sie das Cloud-Speicher-Ziel bestimmt 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 senden sollen, können Sie die entsprechenden Datensätze auswählen. Weitere finden Sie unterauswählen .

Planen des Datensatzexports

Schließlich möchten Sie den Datensatzexport als Teil des Schritts „Planung ​. In diesem Schritt können Sie den Zeitplan definieren und festlegen, ob der Datensatzexport inkrementell erfolgen soll oder nicht. Weitere Informationen Sie unter „PlanenDatensatzexports“.

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 an dem in Ihrem Ziel definierten Speicherort. 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. Überprüfen Sie außerdem, ob das Ziel, an das Sie Ihren Datensatz senden möchten, das Exportieren von Datensätzen unterstützt. 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)

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

Exportparameter angeben

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

Einrichten eines Datenflusses

Schließlich richten Sie den Datenfluss) ein um sicherzustellen, dass Ihr Datensatz mithilfe der POST /flows-API in Ihr Cloud-Speicher-Ziel exportiert wird. 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 an dem in Ihrem Ziel definierten Speicherort. 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.