Katalogdaten synchronisieren und löschen
Diese Seite beschreibt, wie Sie Katalogdaten mit Cloud Data Ingestion (CDI) synchronisieren. Katalogsynchronisierungen werden für jede CDI-Quelle unterstützt. Die Quelltabelle bzw. das Dateiformat für jede Quelle ist auf der jeweiligen Seite dieser Quelle dokumentiert.
Schritt 1: Einen neuen Katalog erstellen
Bevor Sie eine neue CDI-Integration für Kataloge erstellen, müssen Sie einen neuen Katalog erstellen oder einen bestehenden Katalog auswählen, den Sie für die Integration verwenden möchten. Es gibt mehrere Möglichkeiten, einen neuen Katalog zu erstellen, und jede davon funktioniert für die CDI-Integration:
- Laden Sie eine CSV-Datei hoch.
- Erstellen Sie einen Katalog im Braze-Dashboard oder während der CDI-Einrichtung.
- Erstellen Sie einen Katalog über den Endpunkt „Katalog erstellen“.
Alle Änderungen am Katalogschema (zum Beispiel das Hinzufügen neuer Felder oder das Ändern eines Feldtyps) müssen über das Katalog-Dashboard vorgenommen werden, bevor aktualisierte Daten über CDI synchronisiert werden. Braze empfiehlt, diese Updates vorzunehmen, während die Synchronisierung pausiert ist oder keine Ausführung geplant ist. So vermeiden Sie Konflikte zwischen den Daten in Ihrem Data Warehouse und dem Schema in Braze.
Schritt 2: Katalog-Synchronisierung einrichten
Die Einrichtung einer Katalog-Synchronisierung entspricht weitgehend dem Vorgehen bei Nutzerdaten-Synchronisierungen aus derselben Quelle. Öffnen Sie die Seite Ihrer Quelle, wählen Sie für die Quelltabelle oder das Dateiformat den Tab Katalogartikel aus und schließen Sie die restliche Einrichtung auf dieser Seite ab.
| Quelle | Katalog-Einrichtung |
|---|---|
| Snowflake | Snowflake-Quelltabelle |
| Amazon Redshift | Redshift-Quelltabelle |
| Google BigQuery | BigQuery-Quelltabelle |
| Databricks | Databricks-Quelltabelle |
| Microsoft Fabric | Microsoft Fabric-Quelltabelle |
| Amazon S3 | Amazon S3-Dateiformate |
| Google Cloud Storage | Google Cloud Storage-Dateiformate |
| Azure Blob Storage | Azure Blob Storage-Dateiformate |
Unabhängig von der verwendeten Quelle gilt Folgendes:
- Wählen Sie beim Erstellen der Synchronisierung den Synchronisierungstyp Kataloge aus.
- Der Name der Integration muss exakt mit dem Namen des zuvor erstellten Katalogs übereinstimmen.
- Wenn Sie bereits Zugangsdaten aus einer bestehenden Synchronisierung haben, können Sie diese wiederverwenden. Stellen Sie aber sicher, dass Sie den Zugriff auf die Katalog-Quelltabelle erweitern.
Erforderliche Spalten
| Spalte | Erforderlich? | Beschreibung |
|---|---|---|
ID |
Ja | Die ID des Katalogartikels, der erstellt oder aktualisiert werden soll. |
PAYLOAD |
Ja | Ein JSON-String mit den Feldern, die mit dem Katalogartikel in Braze synchronisiert werden sollen. |
DELETED |
Optional | Wenn auf true gesetzt, wird der entsprechende Katalogartikel aus dem Katalog entfernt. |
UPDATED_AT |
Nur bei Data-Warehouse-Quellen | Der Zeitpunkt, zu dem diese Zeile aktualisiert oder hinzugefügt wurde. Dateispeicher-Quellen unterstützen keine UPDATED_AT-Spalten. |
So funktioniert die Integration
Das in diesem Abschnitt beschriebene Synchronisierungsverhalten gilt nur für Data-Warehouse-Integrationen. Bei Dateispeichern verarbeitet Braze neue Dateien, sobald sie in Ihren Bucket oder Container hochgeladen werden.
Bei jeder Synchronisierung ruft Braze alle Zeilen ab, deren UPDATED_AT nach dem zuletzt synchronisierten Wert liegt. Zeilen mit genau dem Grenz-Zeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel aufweisen.
Braze empfiehlt, in Ihrem Data Warehouse eine View aus Ihren Katalogdaten zu erstellen, um eine Quelltabelle einzurichten, die bei jeder Synchronisierung vollständig aktualisiert wird. Mit Views müssen Sie die Abfrage nicht jedes Mal neu schreiben. Ein ausgearbeitetes Beispiel im SQL-Dialekt Ihres Warehouse finden Sie im Tab Katalogartikel auf der Seite Ihrer Quelle.
Unabhängig davon, welche Quelle Sie verwenden:
- Die aus der Integration abgerufenen Daten werden verwendet, um Artikel im Zielkatalog anhand der angegebenen
idzu erstellen oder zu aktualisieren. - Wenn
DELETEDauftruegesetzt ist, wird der entsprechende Katalogartikel gelöscht. - Die Synchronisierung protokolliert keine Datenpunkte, aber alle synchronisierten Daten werden auf Ihre gesamte Katalognutzung angerechnet. Diese Nutzung wird anhand der insgesamt gespeicherten Daten gemessen, sodass Sie sich nicht darum kümmern müssen, nur geänderte Daten zu synchronisieren.