Exportieren von Datensätzen zu Cloud-Speicher-Zielen
endTime für den Export von Datensatzdatenflüssen eingeführt. Adobe hat außerdem für alle Datensatzexport-Datenflüsse, die vor dem 1. November 2024 erstellt wurden ein standardmäßiges Enddatum 1. September 2025.In diesem Artikel wird der Workflow erläutert, der zum Exportieren Datensätze von Adobe Experience Platform an Ihren bevorzugten Cloud-Speicherort, z. B. Amazon S3, SFTP-Speicherorte oder Google Cloud Storage, mithilfe der Experience Platform-Benutzeroberfläche erforderlich ist.
Sie können auch die Experience Platform-APIs zum Exportieren von Datensätzen verwenden. Weitere Informationen finden im Tutorial Exportieren von Datensätzen .
Datensätze, die exportiert werden können datasets-to-export
Die Datensätze, die Sie exportieren können, variieren je nach Experience Platform-Programm (Real-Time CDP, Adobe Journey Optimizer), der Ebene (Prime oder Ultimate) und allen Add-ons, die Sie erworben haben (z. B. Data Distiller).
In der folgenden Tabelle erfahren Sie, welche Datensatztypen Sie je nach Programm, Produktstufe und erworbenen Add-ons exportieren können:
- Profil- und Erlebnisereignis-Datensätze, die in der Experience Platform-Benutzeroberfläche nach der Aufnahme oder Erfassung von Daten über Quellen, Web SDK, Mobile SDK, Analytics Data Connector und Audience Manager erstellt wurden.
- Systemgenerierter Profil-Snapshot-Datensatz.
Video-Tutorial video-tutorial
Sehen Sie sich das folgende Video an, um eine End-to-End-Erklärung des auf dieser Seite beschriebenen Workflows, die Vorteile der Verwendung der Funktion „Datensatz exportieren“ und einige vorgeschlagene Anwendungsfälle zu erhalten.
Unterstützte Ziele supported-destinations
Derzeit können Sie Datensätze in die Cloud-Speicher-Ziele exportieren, die im Screenshot hervorgehoben und unten aufgeführt sind.
Wann Zielgruppen aktiviert oder Datensätze exportiert werden sollten when-to-activate-audiences-or-activate-datasets
Einige dateibasierte Ziele im Experience Platform-Katalog unterstützen sowohl die Zielgruppenaktivierung als auch den Datensatzexport.
- Erwägen Sie die Aktivierung von Zielgruppen, wenn Ihre Daten in Profilen gruppiert nach Zielgruppeninteressen oder Qualifikationen strukturiert sein sollen.
- Alternativ können Sie Datensatzexporte in Betracht ziehen, wenn Sie Rohdatensätze exportieren möchten, die nicht nach Zielgruppeninteressen oder Qualifizierungen gruppiert oder strukturiert sind. Sie können diese Daten für Berichte, Datenwissenschafts-Workflows und viele andere Anwendungsfälle verwenden. Als Administrator, Datentechniker oder Analyst können Sie beispielsweise Daten aus 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 für langfristige Speicheranforderungen speichern.
Dieses Dokument enthält alle Informationen, die zum Exportieren von Datensätzen erforderlich sind. Wenn Sie „Zielgruppen für Cloud Speicher- oder E-Mail-Marketing-Ziele aktivieren möchten, lesen Sie Aktivieren von Zielgruppendaten für Batch-Profil-Exportziele.
Voraussetzungen prerequisites
Beachten Sie die folgenden Voraussetzungen, um Datensätze zu exportieren:
- 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.
- Profildatensätze müssen für die Verwendung im Echtzeit-Kundenprofil aktiviert werden. Weitere Informationen wie Sie diese Option aktivieren.
Erforderliche Berechtigungen permissions
Zum Exportieren von Datensätzen benötigen Sie die View Destinations, View Datasets und Manage and Activate Dataset Destinations Zugriffssteuerungsberechtigungen. 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 eine Activate oder ein Export datasets verfügt, verfügen Sie über 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:
-
Wechseln Sie zu Connections > Destinations und wählen Sie die Registerkarte Catalog aus.
-
Wählen Sie Activate oder Export datasets auf der Karte aus, die dem Ziel entspricht, an das Sie Datensätze exportieren möchten.
-
Klicken Sie auf Data type Datasets und wählen Sie die Zielverbindung aus, in die Sie Datensätze exportieren möchten, und klicken Sie dann auf Next.
- Die Select datasets 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 an das Ziel exportieren möchten, und klicken Sie dann auf Next.
Planen des Datensatzexports scheduling
Verwenden Sie den Scheduling Schritt, um:
- Legen Sie ein Start- und Enddatum sowie eine Exportkadenz für Ihre Datensatzexporte fest.
- Konfigurieren Sie, ob die exportierten Datensatzdateien die vollständige Mitgliedschaft des Datensatzes exportieren sollen oder nur inkrementelle Änderungen an der Mitgliedschaft bei jedem Exportereignis.
- Passen Sie den Ordnerpfad an Ihrem Speicherort an, an den Datensätze exportiert werden sollen. Weitere Informationen zum (Bearbeiten des Exportordnerpfads.
Verwenden Sie das Edit schedule auf der Seite, um die Exportkadenz von Exporten zu bearbeiten und auszuwählen, ob vollständige oder inkrementelle Dateien exportiert werden sollen.
Die Option Export incremental files ist standardmäßig ausgewählt. Dies führt zu einem Trigger einer oder mehrerer Dateien, die einen vollständigen Schnappschuss des Datensatzes darstellen. Nachfolgende Dateien sind inkrementelle Ergänzungen zum Datensatz seit dem vorherigen Export. Sie können auch Export full files auswählen. Wählen Sie in diesem Fall die Once für einen einmaligen vollständigen Export des Datensatzes aus.
-
Verwenden Sie den Frequency, um die Exportfrequenz auszuwählen:
- Daily: Planung von inkrementellen Dateiexporten einmal täglich, jeden Tag, zum angegebenen Zeitpunkt.
- Hourly: Planung von inkrementellen Dateiexporten alle 3, 6, 8 oder 12 Stunden.
-
Verwenden Sie den Time, um die Tageszeit UTC Format auszuwählen, zu der der Export erfolgen soll.
-
Verwenden Sie den Date-Selektor, um das Intervall auszuwählen, in dem der Export stattfinden soll.
-
Wählen Sie Save aus, um den Zeitplan zu speichern, und fahren Sie mit dem Review Schritt fort.
Bearbeiten des Ordnerpfads edit-folder-path
Wählen Sie Edit folder path aus, um die Ordnerstruktur an 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 trennen Sie die Ordner mithilfe von / zwischen den Makros.
Nach Auswahl der gewünschten Makros können Sie eine Vorschau der Ordnerstruktur anzeigen, die an Ihrem Speicherort erstellt wird. Die erste Ebene in der Ordnerstruktur stellt die Folder path dar, die Sie angegeben haben, als Sie mit dem Ziel verbunden) Datensätze exportieren.
Best Practices für die Verwaltung mehrerer Datensätze best-practices-multiple-datasets
Beachten Sie beim Exportieren mehrerer Datensätze die folgenden Best Practices:
- Anforderungen an denselben Zeitplan: Gruppieren Sie Datensätze, die denselben Exportzeitplan (Häufigkeit, Typ) benötigen, in einem einzigen Datenfluss, um die Verwaltung zu erleichtern.
- Unterschiedliche Zeitplananforderungen: Erstellen Sie separate Datenflüsse für Datensätze, für die unterschiedliche Exportpläne oder Exporttypen erforderlich sind (inkrementell vs. vollständig). Dadurch wird sichergestellt, dass jeder Datensatz entsprechend seinen spezifischen Anforderungen exportiert wird.
- Vor dem Ändern überprüfen: Bevor Sie den Zeitplan für einen vorhandenen Datenfluss ändern, überprüfen Sie, welche Datensätze bereits über diesen Datenfluss exportiert werden, um unbeabsichtigte Änderungen an ihrem Exportverhalten zu vermeiden.
- Dokumentieren der Einrichtung: Verfolgen Sie, welche Datensätze sich in welchen Datenflüssen befinden, insbesondere bei der Verwaltung mehrerer Exportpläne über verschiedene Ziele hinweg.
Überprüfung review
Auf der Seite Review können Sie eine Zusammenfassung Ihrer Auswahl sehen. Wählen Sie Cancel aus, um den Fluss abzubrechen, Back, Ihre Einstellungen zu ändern, oder Finish, Ihre Auswahl zu bestätigen und mit dem Exportieren 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 an dem von Ihnen angegebenen Speicherort. Es ist damit zu rechnen, dass neue Dateien entsprechend dem von Ihnen angegebenen Exportzeitplan an Ihrem Speicherort abgelegt werden.
Experience Platform erstellt eine Ordnerstruktur am angegebenen Speicherort, in der die exportierten Datensatzdateien abgelegt werden. Das standardmäßige Exportmuster für Ordner wird unten gezeigt, Sie können jedoch die Ordnerstruktur mit Ihren bevorzugten Makros anpassen.
folder-name-you-provided - stellt die Folder path dar, die Sie angegeben haben, als Sie mit dem Ziel verbunden Datensätze 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 Mit Ziel verbinden können Sie die exportierten Datensatzdateien auswählen, die komprimiert werden sollen, wie unten dargestellt:
Beachten Sie den Unterschied im Dateiformat zwischen den beiden Dateitypen, wenn sie komprimiert werden:
- Beim Exportieren komprimierter JSON-Dateien wird das exportierte Dateiformat
json.gz. Das Format des 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 von komprimierten Parquet-Dateien wird das exportierte Dateiformat
gz.parquet
Exporte in JSON-Dateien werden unterstützt nur im komprimierten Modus. Exporte in Parquet-Dateien werden im 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 Benutzeroberfläche von Experience Platform und wählen Sie Destinations über die linke Navigationsleiste aus. Wählen Sie Browse in der oberen Kopfzeile aus, um Ihre vorhandenen Ziel-Datenflüsse anzuzeigen.
note tip TIP Wählen Sie das Symbol oben links, um das Sortier-Bedienfeld zu öffnen. Das Sortier-Bedienfeld bietet eine Liste aller Ihrer Ziele. Sie können mehr als ein Ziel aus der Liste auswählen, um eine gefilterte Auswahl von Datenflüssen anzuzeigen, die mit dem ausgewählten Ziel verknüpft sind.
-
Wählen Sie in der Spalte Activation data das Steuerelement für Datensätze aus, um alle Datensätze anzuzeigen, die diesem Exportdatenfluss zugeordnet sind.
-
Die Activation data für das Ziel wird angezeigt. Aktivieren Sie die Kontrollkästchen links in der Datensatzliste, um die Datensätze auszuwählen, die Sie entfernen möchten, und klicken Sie dann in der rechten Leiste auf Remove datasets , um den Trigger zum Bestätigungsdialogfeld zum Entfernen des Datensatzes anzuzeigen.
-
Wählen Sie im Bestätigungsdialog die Option Remove aus, um den Datensatz sofort aus den Exporten in das Ziel zu entfernen.
Berechtigungen für den Datensatzexport licensing-entitlement
Informationen dazu, wie viele Daten Sie pro Jahr für jede Experience Platform-Anwendung exportieren dürfen, finden Sie in den Produktbeschreibungsdokumenten. Sie können beispielsweise die Real-Time CDP-Produktbeschreibung () .
Beachten Sie, dass die Berechtigungen für den Datenexport für verschiedene Programme nicht additiv sind. Wenn Sie beispielsweise Real-Time CDP Ultimate und Adobe Journey Optimizer Ultimate erwerben, ist die Berechtigung für den Profilexport gemäß den Produktbeschreibungen höher als die beiden Berechtigungen. Die Berechnung Ihrer Volumenberechtigungen erfolgt anhand der Gesamtzahl der lizenzierten Profile und der Multiplikation mit 500 KB für Real-Time CDP Prime bzw. 700 KB für Real-Time CDP Ultimate, um zu bestimmen, wie viel Datenvolumen Ihnen zusteht.
Wenn Sie dagegen Add-ons wie Data Distiller erworben haben, stellt das Datenexportlimit, zu dem Sie berechtigt sind, die Summe aus der Produktebene und dem Add-on dar.
Sie können Ihre Profilexporte anhand Ihrer vertraglichen Beschränkungen im Dashboard Lizenznutzung“ anzeigen und .
Bekannte Einschränkungen known-limitations
Beachten Sie die folgenden Einschränkungen für die allgemeine Verfügbarkeit von Releases von Datensatzexporten:
- Experience Platform exportiert möglicherweise mehrere Dateien, selbst für kleine Datensätze. Der Datensatzexport ist für die Integration von System zu System ausgelegt und für Leistung optimiert, sodass die Anzahl der exportierten Dateien nicht angepasst werden kann.
- Die Namen exportierter Dateien können derzeit nicht angepasst 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, werden aus Datensatzexporten ausgeschlossen. Weitere Informationen finden Sie in der Leitplanken für geplante Datensatzexporte
Häufig gestellte Fragen faq
Können wir eine Datei ohne Ordner erzeugen, wenn wir nur unter / als Ordnerpfad speichern? Wenn wir keinen Ordnerpfad benötigen, wie werden dann Dateien mit doppelten Namen in einem Ordner oder Speicherort generiert?
/ zum Exportieren 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 zu einem Ordner und die Datendateien zu einem anderen Ordner weiterleiten?
Können wir die Reihenfolge oder den Zeitpunkt der Dateibereitstellung steuern?
Welche Formate sind für die Manifestdatei verfügbar?
Gibt es API-Verfügbarkeit für die Manifestdatei?
Können wir der Manifestdatei zusätzliche Details hinzufügen (d. h. die Anzahl der Einträge)? Wenn ja, wie?
flowRun-Entität verfügbar (abfragbar über API). Weitere Informationen finden Sie unter Überwachung von Zielen.Wie werden Datendateien aufgeteilt? Wie viele Datensätze pro Datei?
Können wir einen Schwellenwert (Anzahl der Datensätze pro Datei) festlegen?
Wie senden wir einen Datensatz erneut, wenn der erste Versand fehlerhaft ist?
Kann ich für verschiedene Datensätze im selben Datenfluss unterschiedliche Exportzeitpläne festlegen?