Exportieren von Datensätzen in Cloud-Speicher-Ziele
- Diese Funktion steht Kunden zur Verfügung, die das Real-Time CDP Prime- oder Ultimate-Package, Adobe Journey Optimizer oder Customer Journey Analytics erworben haben. Wenden Sie sich für weitere Informationen an Ihren Adobe-Support-Mitarbeiter.
In diesem Artikel wird der Workflow erläutert, der zum Exportieren von Datensätzen aus Adobe Experience Platform in Ihren bevorzugten Cloud-Speicher wie Amazon S3, SFTP-Speicherorte oder Google Cloud Storage mithilfe der Experience Platform-Benutzeroberfläche erforderlich ist.
Sie können auch die Experience Platform-APIs verwenden, um Datensätze zu exportieren. Weitere Informationen finden Sie im Tutorial zur Export-Datensatz-API.
Für den Export verfügbare Datensätze datasets-to-export
Die Datensätze, die Sie exportieren können, variieren je nach Experience Platform-App (Real-Time CDP, Adobe Journey Optimizer), Ebene (Prime oder Ultimate) und den von Ihnen gekauften Add-ons (z. B. Data Distiller).
Verwenden Sie die nachstehende Tabelle, um zu verstehen, welche Datensatztypen Sie je nach Anwendung, Produktstufe und gekauften Add-ons exportieren können:
- Profil- und Erlebnisereignis-Datensätze, die in der Experience Platform-Benutzeroberfläche erstellt wurden, nachdem Daten über Quellen, Web SDK, Mobile SDK, Analytics Data Connector und Audience Manager erfasst oder erfasst wurden.
- systemgenerierter Profil-Snapshot-Datensatz.
Video-Tutorial video-tutorial
Sehen Sie sich das folgende Video an, um eine umfassende Erläuterung des auf dieser Seite beschriebenen Workflows, die Vorteile der Verwendung der Exportdataset-Funktion und einige empfohlene Anwendungsfälle zu erhalten.
Unterstützte Ziele supported-destinations
Derzeit können Sie Datensätze zu den im Screenshot hervorgehobenen und unten aufgeführten Cloud-Speicher-Zielen exportieren.
Wann Zielgruppen aktiviert oder Datensätze exportiert werden when-to-activate-audiences-or-activate-datasets
Einige dateibasierte Ziele im Experience Platform-Katalog unterstützen sowohl die Aktivierung der Zielgruppe als auch den Export von Datensätzen.
- Ziehen Sie die Aktivierung von Zielgruppen in Erwägung, wenn Ihre Daten in Profile strukturiert sein sollen, die nach Zielgruppeninteressen oder Qualifikationen gruppiert sind.
- Alternativ können Sie Datensatzexporte in Betracht ziehen, wenn Sie Rohdatensätze exportieren möchten, die nicht nach Zielgruppeninteressen oder Qualifikationen gruppiert oder strukturiert sind. Sie können diese Daten für Berichte, Datenwissenschaft-Workflows und viele andere Anwendungsfälle verwenden. Als Administrator, Data Engineer oder Analyst können Sie beispielsweise Daten von Experience Platform exportieren, um sie mit Ihrem Data Warehouse zu synchronisieren, in BI-Analyse-Tools oder externen Cloud ML-Tools verwenden oder in Ihrem System speichern, um langfristige Speicheranforderungen zu erfüllen.
Dieses Dokument enthält alle Informationen, die zum Exportieren von Datensätzen erforderlich sind. Wenn Sie Audiences aktivieren möchten, um Cloud-Speicher- oder E-Mail-Marketing-Ziele zu nutzen, lesen Sie den Abschnitt Aktivieren von Zielgruppendaten für Batch-Profilexportziele.
Voraussetzungen prerequisites
Um Datensätze in Cloud-Speicher-Ziele zu exportieren, müssen Sie erfolgreich eine Verbindung mit einem Ziel hergestellt haben. Wenn Sie es noch nicht getan haben, navigieren Sie zum Zielkatalog, durchsuchen Sie die unterstützten Ziele und konfigurieren Sie das Ziel, das Sie verwenden möchten.
Erforderliche Berechtigungen permissions
Zum Exportieren von Datensätzen benötigen Sie die Berechtigungen Ziele anzeigen, Datensätze anzeigen und Datensatzziele verwalten und aktivieren Zugriffskontrolle. Lesen Sie die Übersicht über die Zugriffskontrolle oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.
Um sicherzustellen, dass Sie über die erforderlichen Berechtigungen zum Exportieren von Datensätzen verfügen und dass das Ziel den Export von Datensätzen unterstützt, durchsuchen Sie den Zielkatalog. Wenn ein Ziel über die Steuerung Aktivieren oder Datensätze exportieren verfügt, dann haben Sie die entsprechenden Berechtigungen.
Auswählen des Ziels select-destination
Befolgen Sie die Anweisungen zum Auswählen eines Ziels, an das Sie Ihre Datensätze exportieren können:
-
Navigieren Sie zu Verbindungen > Ziele und wählen Sie die Registerkarte Katalog.
-
Wählen Sie Aktivieren oder Datensätze exportieren auf der Karte aus, die dem Ziel entspricht, an das Sie Datensätze exportieren möchten.
-
Wählen Sie Datentypdatensätze und dann die Zielverbindung aus, in die Sie Datensätze exportieren möchten, und klicken Sie dann auf Weiter.
- Die Ansicht Datensätze auswählen wird angezeigt. Fahren Sie mit dem nächsten Abschnitt fort, um die Datensätze auszuwählen, die exportiert werden sollen.
Auswählen Ihrer Datensätze select-datasets
Aktivieren Sie die Kontrollkästchen links neben den Datensatznamen, um die Datensätze auszuwählen, die Sie für das Ziel aktivieren möchten, und klicken Sie dann auf Weiter.
Planen des Datensatzexports scheduling
Verwenden Sie den Schritt Planung , um:
- Legen Sie ein Start- und ein Enddatum sowie eine Exportkadenz für Ihre Datensatzexporte fest.
- Konfigurieren Sie, ob die exportierten Datensatzdateien die vollständige Mitgliedschaft im Datensatz exportieren sollen oder nur inkrementelle Änderungen an der Mitgliedschaft bei jedem Auftreten eines Exports.
- Passen Sie den Ordnerpfad in Ihrem Speicherort an, an den Datensätze exportiert werden sollen. Erfahren Sie mehr darüber, wie Sie den Exportordnerpfad bearbeiten.
Verwenden Sie das Steuerelement Zeitplan bearbeiten auf der Seite, um den Exportkatalog zu bearbeiten und festzulegen, ob vollständige oder inkrementelle Dateien exportiert werden sollen.
Die Option Inkrementelle Dateien exportieren ist standardmäßig ausgewählt. Dies Trigger den Export einer oder mehrerer Dateien, die eine vollständige Momentaufnahme des Datensatzes darstellen. Nachfolgende Dateien werden seit dem vorherigen Export inkrementell zum Datensatz hinzugefügt. Sie können auch "Vollständige Dateien exportieren"auswählen. Wählen Sie in diesem Fall die Häufigkeit Einmal für einen einmaligen vollständigen Export des Datensatzes aus.
-
Verwenden Sie den Häufigkeitsselektor zur Auswahl der Exportfrequenz:
- Täglich: Planung von inkrementellen Dateiexporten einmal täglich, jeden Tag, zum von Ihnen festgelegten Zeitpunkt.
- Stündlich: Planung von inkrementellen Dateiexporten alle 3, 6, 8 oder 12 Stunden.
-
Verwenden Sie den Zeitselektor zur Auswahl der Tageszeit im Format UTC, zu der der Export erfolgen soll.
-
Verwenden Sie die Auswahl Datum , um das Intervall auszuwählen, in dem der Export stattfinden soll.
-
Wählen Sie Speichern aus, um den Zeitplan zu speichern und mit dem Schritt Überprüfen fortzufahren.
Ordnerpfad bearbeiten edit-folder-path
Wählen Sie Ordnerpfad bearbeiten aus, um die Ordnerstruktur in Ihrem Speicherort anzupassen, an dem exportierte Datensätze abgelegt werden.
Sie können mehrere verfügbare Makros verwenden, um einen gewünschten Ordnernamen anzupassen. Doppelklicken Sie auf ein Makro, um es zum Ordnerpfad hinzuzufügen, und verwenden Sie / zwischen den Makros, um die Ordner zu trennen.
Nach Auswahl der gewünschten Makros wird eine Vorschau der Ordnerstruktur angezeigt, die in Ihrem Speicherort erstellt wird. Die erste Ebene in der Ordnerstruktur stellt den Ordnerpfad dar, den Sie angegeben haben, als Sie mit dem Ziel verbunden sind, um Datensätze zu exportieren.
Überprüfung review
Auf der Seite Überprüfen können Sie eine Zusammenfassung Ihrer Auswahl sehen. Wählen Sie Abbrechen aus, um den Fluss abzubrechen, Zurück, um die Einstellungen zu ändern, oder Fertigstellen, um Ihre Auswahl zu bestätigen und mit dem Senden von Datensätzen an das Ziel zu beginnen.
Überprüfen eines erfolgreichen Datensatzexports verify
Beim Exportieren von Datensätzen erstellt Experience Platform eine oder mehrere .json - oder .parquet -Dateien am von Ihnen angegebenen Speicherort. Erwarten Sie, dass neue Dateien entsprechend dem von Ihnen angegebenen Exportplan an Ihrem Speicherort abgelegt werden.
Experience Platform erstellt eine Ordnerstruktur am angegebenen Speicherort, in der die exportierten Datensatzdateien abgelegt werden. Das Standardmuster für den Ordnerexport ist unten dargestellt, Sie können die Ordnerstruktur jedoch mit Ihren bevorzugten Makros anpassen 1}.
folder-name-you-provided - stellt den Ordnerpfad dar, den Sie angegeben haben, als Sie mit dem Ziel verbunden sind, um Datensätze zu exportieren.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.
Beispiele für Datensatzdateien sample-files
Das Vorhandensein dieser Dateien an Ihrem Speicherort bestätigt einen erfolgreichen Export. Um zu verstehen, wie die exportierten Dateien strukturiert sind, können Sie eine Parquet- oder JSON-Beispieldatei herunterladen.
Komprimierte Datensatzdateien compressed-dataset-files
Im Workflow Verbindung mit Ziel herstellen können Sie die zu komprimierenden exportierten Datensatzdateien auswählen, wie unten dargestellt:
Beachten Sie bei der Komprimierung den Unterschied im Dateiformat zwischen den beiden Dateitypen:
- Beim Exportieren komprimierter JSON-Dateien ist das exportierte Dateiformat
json.gz. Das Format der exportierten JSON ist NDJSON, das standardmäßige Austauschformat im Big-Data-Ökosystem. Adobe empfiehlt die Verwendung eines NDJSON-kompatiblen Clients zum Lesen der exportierten Dateien. - Beim Exportieren komprimierter Parquet-Dateien ist das exportierte Dateiformat
gz.parquet
Exporte in JSON-Dateien werden nur im komprimierten Modus unterstützt. Exporte in Parquet-Dateien werden in einem komprimierten und unkomprimierten Modus unterstützt.
Entfernen von Datensätzen aus Zielen remove-dataset
Gehen Sie wie folgt vor, um Datensätze aus einem vorhandenen Datenfluss zu entfernen:
-
Melden Sie sich bei der Experience Platform-Benutzeroberfläche an und wählen Sie Ziele über die linke Navigationsleiste aus. Wählen Sie Durchsuchen in der oberen Kopfzeile aus, um Ihre vorhandenen Ziel-Datenflüsse anzuzeigen.
note tip TIP Wählen Sie das Symbol 
-
Wählen Sie in der Spalte Aktivierungsdaten das Steuerelement für Datensätze aus, um alle Datensätze anzuzeigen, die diesem Exportdatenfluss zugeordnet sind.
-
Die Seite Aktivierungsdaten für dieses Ziel wird angezeigt. Verwenden Sie die Kontrollkästchen auf der linken Seite der Datensatzliste, um die Datensätze auszuwählen, die Sie entfernen möchten, und wählen Sie dann Datensätze entfernen in der rechten Leiste aus, um das Dialogfeld zum Entfernen von Datensätzen Trigger.
-
Wählen Sie im Bestätigungsdialog die Option Entfernen aus, um den Datensatz sofort aus den Exporten in das Ziel zu entfernen.
Berechtigungen für den Datensatzexport licensing-entitlement
In den Produktbeschreibungsdokumenten erfahren Sie, wie viele Daten Sie pro Experience Platform-Anwendung exportieren können. Sie können beispielsweise die Real-Time CDP-Produktbeschreibung hier anzeigen.
Beachten Sie, dass die Berechtigungen für Datenexporte für verschiedene Anwendungen nicht additiv sind. Wenn Sie beispielsweise Real-Time CDP Ultimate und Adobe Journey Optimizer Ultimate erwerben, ist die Profilexportberechtigung gemäß den Produktbeschreibungen die größere der beiden Berechtigungen. Ihre Volumenberechtigungen werden berechnet, indem Sie die Gesamtzahl der lizenzierten Profile mit 500 KB für Real-Time CDP Prime oder 700 KB für Real-Time CDP Ultimate multiplizieren, um festzustellen, zu welchem Datenvolumen Sie berechtigt sind.
Wenn Sie hingegen Add-ons wie Data Distiller erworben haben, stellt die Datenexport-Beschränkung, zu der Sie berechtigt sind, die Summe der Produktebene und des Add-ons dar.
Sie können Ihre Profilexporte anhand Ihrer vertraglichen Beschränkungen im Dashboard zur Lizenznutzung anzeigen und verfolgen.
Bekannte Einschränkungen known-limitations
Beachten Sie die folgenden Einschränkungen für die allgemeine Verfügbarkeit von Datensatzexporten:
- Derzeit können Sie nur inkrementelle Dateien exportieren, und für Ihre Datensatzexporte kann kein Enddatum ausgewählt werden.
- Experience Platform kann mehrere Dateien auch für kleine Datensätze exportieren. Der Datensatzexport wurde für die Integration von System zu System entwickelt und für die Leistung optimiert. Daher kann die Anzahl der exportierten Dateien nicht angepasst werden.
- Exportierte Dateinamen können derzeit nicht angepasst werden.
- Über API erstellte Datensätze können derzeit nicht exportiert werden.
- Die Benutzeroberfläche hindert Sie derzeit nicht daran, einen Datensatz zu löschen, während er an ein Ziel exportiert wird. Löschen Sie keine Datensätze, während sie an Ziele exportiert werden. Entfernen Sie den Datensatz aus einem Ziel-Datenfluss, bevor Sie ihn löschen.
- Überwachungsmetriken für Datensatzexporte werden derzeit mit Zahlen für Profilexporte gemischt, sodass sie nicht die tatsächlichen Exportzahlen widerspiegeln.
- Daten mit einem Zeitstempel, der älter als 365 Tage ist, sind von den Datensatzexporten ausgeschlossen. Weitere Informationen finden Sie in den Limits für geplante Datensatzexporte
Häufig gestellte Fragen faq
Können wir eine Datei ohne Ordner generieren, wenn wir einfach unter / als Ordnerpfad speichern? Wenn kein Ordnerpfad erforderlich ist, wie werden dann Dateien mit doppelten Namen in einem Ordner oder Speicherort generiert?
+++
Ab der Version vom September 2024 ist es möglich, den Ordnernamen anzupassen und sogar / für den Export von Dateien für alle Datensätze im selben Ordner zu verwenden. Adobe empfiehlt dies nicht für Ziele, die mehrere Datensätze exportieren, da systemgenerierte Dateinamen, die zu verschiedenen Datensätzen gehören, im selben Ordner gemischt werden.
+++
Können Sie die Manifestdatei an einen Ordner und Datendateien in einen anderen Ordner weiterleiten?
+++
Nein, es gibt keine Möglichkeit, die Manifestdatei an einen anderen Speicherort zu kopieren.
+++
Können wir die Sequenzierung oder den Zeitpunkt der Dateibereitstellung steuern?
+++
Es gibt Optionen zum Planen des Exports. Es gibt keine Optionen zum Verschieben oder Sequenzieren der Kopie der Dateien. Sie werden nach der Erstellung an Ihren Speicherort kopiert.
+++
Welche Formate sind für die Manifestdatei verfügbar?
+++
Die Manifestdatei liegt im JSON-Format vor.
+++
Gibt es API-Verfügbarkeit für die Manifestdatei?
+++
Für die Manifestdatei ist keine API verfügbar, sie enthält jedoch eine Liste mit Dateien, die den Export enthalten.
+++
Können der Manifestdatei zusätzliche Details hinzugefügt werden (d. h. die Datensatzanzahl)? Wenn ja, wie?
+++
Es ist nicht möglich, der Manifestdatei zusätzliche Informationen hinzuzufügen. Die Datensatzanzahl ist über die Entität flowRun verfügbar (über die API abgefragt). Weitere Informationen finden Sie unter Zielüberwachung.
+++
Wie werden Datendateien aufgeteilt? Wie viele Datensätze pro Datei?
+++
Datendateien werden nach der Standardpartitionierung im Experience Platform Data Lake aufgeteilt. Größere Datensätze haben eine höhere Anzahl von Partitionen. Die Standardpartitionierung kann vom Benutzer nicht konfiguriert werden, da sie für das Lesen optimiert ist.
+++
Können wir einen Schwellenwert festlegen (Anzahl an Datensätzen pro Datei)?
+++
Nein, das ist nicht möglich.
+++
Wie senden wir einen Datensatz erneut, wenn der erste Versand fehlerhaft ist?
+++
Bei den meisten Systemfehlern werden automatisch Wiederholungen durchgeführt.
+++