Exportieren von Datensätzen in Cloud-Speicher-Ziele

AVAILABILITY
  • 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:

Anwendung/Add-on
Stufe
Für den Export verfügbare Datensätze
Real-Time CDP
Prime
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.
Ultimate
  • 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.
Adobe Journey Optimizer
Prime
Weitere Informationen finden Sie in der Dokumentation zu Adobe Journey Optimizer .
Ultimate
Weitere Informationen finden Sie in der Dokumentation zu Adobe Journey Optimizer .
Customer Journey Analytics
Alle
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.
Data Distiller
Data Distiller (Add-on)
Abgeleitete Datensätze, die über Query Service erstellt wurden.

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.

Zielkatalogseite, die anzeigt, welche Ziele Datensatzexporte unterstützen.

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:

  1. Navigieren Sie zu Verbindungen > Ziele und wählen Sie die Registerkarte Katalog.

    Registerkarte „Zielkatalog“ mit hervorgehobenem Katalog-Steuerelement.

  2. Wählen Sie Aktivieren oder Datensätze exportieren auf der Karte aus, die dem Ziel entspricht, an das Sie Datensätze exportieren möchten.

    Registerkarte „Zielkatalog“ mit hervorgehobenem Steuerelement „Aktivieren“.

  3. Wählen Sie Datentypdatensätze und dann die Zielverbindung aus, in die Sie Datensätze exportieren möchten, und klicken Sie dann auf Weiter.

TIP
Wenn Sie ein neues Ziel zum Exportieren von Datensätzen einrichten möchten, wählen Sie Neues Ziel konfigurieren aus, um den Workflow Mit Ziel verbinden auszulösen.

Zielaktivierungs-Workflow mit hervorgehobenem Steuerelement „Datensätze“.

  1. 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.

Workflow für den Datensatzexport, der den Schritt „Datensätze auswählen“ zeigt, in dem Sie auswählen können, welche Datensätze exportiert werden sollen.

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.

Bearbeiten Sie die Steuerung des Zeitplans, die im Planungsschritt hervorgehoben ist.

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.

IMPORTANT
Der erste inkrementelle Dateiexport umfasst alle vorhandenen Daten im Datensatz, die als Aufstockung dienen. Der Export kann eine oder mehrere Dateien enthalten.

Workflow für den Datensatzexport, der den Planungsschritt zeigt.

  1. 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.
  2. Verwenden Sie den Zeitselektor zur Auswahl der Tageszeit im Format UTC, zu der der Export erfolgen soll.

  3. Verwenden Sie die Auswahl Datum , um das Intervall auszuwählen, in dem der Export stattfinden soll.

  4. Wählen Sie Speichern aus, um den Zeitplan zu speichern und mit dem Schritt Überprüfen fortzufahren.

NOTE
Bei Datensatzexporten haben die Dateinamen ein vordefiniertes Standardformat, das nicht geändert werden kann. Siehe Abschnitt Überprüfen eines erfolgreichen Datensatzexports, um weitere Informationen und Beispiele für exportierte Dateien zu erhalten.

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.

Bearbeiten Sie das Ordnerpfadsteuerelement, das im Planungsschritt hervorgehoben ist.

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.

Im modalen Fenster des benutzerdefinierten Ordners hervorgehobene Makroauswahl.

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.

Vorschau des Ordnerpfads im modalen Fenster des benutzerdefinierten Ordners hervorgehoben.

Ü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.

Arbeitsablauf für den Datensatzexport, der den Überprüfungsschritt anzeigt.

Ü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}.

TIP
Die erste Ebene in dieser Ordnerstruktur - 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:

Dateityp und Auswahl der Komprimierung beim Herstellen einer Verbindung zu einem Ziel zum Exportieren von Datensätzen.

Beachten Sie bei der Komprimierung den Unterschied im Dateiformat zwischen den beiden Dateitypen:

  • Beim Exportieren komprimierter JSON-Dateien ist das exportierte Dateiformat json.gz
  • 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:

  1. 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.

    Die Ansicht „Ziel durchsuchen“, wobei eine Zielverbindung angezeigt wird und der Rest unscharf gemacht wurde.

    note tip
    TIP
    Wählen Sie das Symbol Filter 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.
  2. 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 verfügbare Navigationsoption für Datensätze, die in der Spalte „Aktivieriungsdaten“ hervorgehoben ist.

  3. 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.

    Der Dialog „Datensatz entfernen“, der die Steuerung „Datensatz entfernen“ in der rechten Leiste anzeigt.

  4. Wählen Sie im Bestätigungsdialog die Option Entfernen aus, um den Datensatz sofort aus den Exporten in das Ziel zu entfernen.

    Dialogfeld mit der Option „Löschen des Datensatzes aus dem Datenfluss bestätigen“.

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.
+++

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6