Häufig gestellte Fragen

Auf dieser Seite finden Sie Antworten auf einige häufig gestellte Fragen zur Cloud-Datenaufnahme.

Wie oft kann ein CDI-Sync ausgeführt werden?

Wiederkehrende Syncs können bis zu alle 5 Minuten oder nur einmal pro Monat ausgeführt werden. Standardmäßig beträgt das kürzeste Intervall, das Sie im Dashboard festlegen können, 15 Minuten. So können Sie die Rechenkosten Ihres Data Warehouse und das Anfragevolumen besser steuern. Wenn Sie bis zu alle 5 Minuten synchronisieren möchten, wenden Sie sich an den Braze-Support oder Ihren Customer-Success-Manager. Wenn Sie synchronisieren möchten, sobald sich Ihre Daten ändern, rufen Sie den Endpunkt Sync triggern auf. Weitere Informationen finden Sie unter Funktionsweise.

Warum habe ich eine E-Mail mit dem Betreff „Error in CDI Sync“ erhalten?

Diese Art von E-Mail weist in der Regel auf ein Problem mit Ihrer CDI-Einrichtung hin. Hier sind einige häufige Probleme und wie Sie sie beheben:

CDI kann mit Ihren Zugangsdaten nicht auf das Data Warehouse oder die Tabelle zugreifen

Das kann bedeuten, dass die Zugangsdaten in CDI falsch sind oder im Data Warehouse falsch konfiguriert wurden. Weitere Informationen finden Sie unter Data-Warehouse-Integrationen.

Die Tabelle wurde nicht gefunden

Aktualisieren Sie Ihre Integration mit der korrekten Datenbankkonfiguration oder erstellen Sie passende Ressourcen im Data Warehouse, z. B. database/table.

Der Katalog wurde nicht gefunden

Der in der Integration eingerichtete Katalog existiert in Braze nicht. Ein Katalog kann entfernt worden sein, nachdem die Integration eingerichtet wurde. Um das Problem zu beheben, aktualisieren Sie die Integration so, dass sie einen anderen Katalog verwendet, oder erstellen Sie einen neuen Katalog, dessen Name mit dem Katalognamen in der Integration übereinstimmt.

Warum habe ich die E-Mail „Row errors in your CDI sync“ erhalten?

Diese E-Mail bedeutet, dass ein Teil Ihrer Daten während der Synchronisierung nicht verarbeitet werden konnte. Den genauen Fehler finden Sie in den Logs in Braze unter CDI > Sync Log.

Wie behebe ich den Fehler „Time must be string in ISO8601 Format“ bei der CDI-Einrichtung?

Dieser Fehler bedeutet, dass der Event-Wert time in Ihrer CDI-Payload nicht in einem unterstützten Datums- und Zeitformat vorliegt.

Formatieren Sie time für Event- und Kauf-Payloads wie folgt:

• Als ISO-8601-String oder
• yyyy-MM-dd'T'HH:mm:ss:SSSZ

Wenn time fehlt, verwendet Braze UPDATED_AT als Event-Zeitpunkt.

Alle Anforderungen an die Payload finden Sie unter Tabelleneinrichtung für Cloud Data Ingestion.

Wie behebe ich Fehler bei „Test Connection“ und in Support-E-Mails?

• snowflake
• redshift
• bigquery
• databricks

Wie aktualisiere ich meine Einstellungen für E-Mail-Benachrichtigungen bei CDI-Integrationen?

Für jede Integration gibt es eine eigene Benachrichtigungseinstellung. Gehen Sie zur CDI-Seite und wählen Sie den Namen der Integration aus, die Sie aktualisieren möchten. Im Abschnitt Benachrichtigungseinstellungen können Sie festlegen, wie Sie Benachrichtigungen zur ausgewählten Integration erhalten.

Warum wird der Fehler „Incorrect Integration Object“ angezeigt?

Dieser Fehler tritt auf, wenn Sie die Benachrichtigungseinstellungen für eine CDI-Integration aktualisieren möchten und zwei oder mehr Workspaces Integrationen haben, die auf denselben Cloud-Storage-Bucket oder -Ordner verweisen. Jeder Cloud-Storage-Speicherort kann jeweils nur von einer Integration genutzt werden.

So beheben Sie das Problem:

1. Ermitteln Sie, welcher andere Workspace eine CDI-Integration mit demselben Speicherort verwendet.
2. Entfernen oder konfigurieren Sie die konkurrierende Integration im anderen Workspace neu.
3. Nachdem Sie den Konflikt behoben haben, können Sie die Benachrichtigungseinstellungen aktualisieren.

Der Fehler sollte dann nicht mehr angezeigt werden, und Sie sollten Ihre Benachrichtigungseinstellungen erfolgreich aktualisieren können. Wenn weiterhin Probleme auftreten, eröffnen Sie ein Support-Ticket.

Was passiert, wenn ein in der Zukunft liegender UPDATED_AT-Wert mit einer Integration synchronisiert wird?

CDI verwendet UPDATED_AT, um zu bestimmen, welche Daten neu sind. Nachdem ein in der Zukunft liegender UPDATED_AT-Wert synchronisiert wurde, werden alle Daten, die vor diesem zukünftigen Datum und dieser Uhrzeit liegen, nicht verarbeitet. So beheben Sie das Problem:

1. Korrigieren Sie UPDATED_AT.
2. Entfernen Sie alle alten Daten, die bereits mit Braze synchronisiert wurden.
3. Erstellen Sie eine neue Integration, um diese Tabelle erneut zu verarbeiten.

Warum stimmt „Rows Synced“ nicht mit der Anzahl in meinem Data Warehouse überein?

CDI verwendet UPDATED_AT, um zu entscheiden, welche Datensätze bei einer Synchronisierung übernommen werden. Sehen Sie sich diese Abbildung an, um zu verstehen, wie das funktioniert. Zu Beginn eines Synchronisierungslaufs fragt CDI Ihr Data Warehouse ab, um alle Datensätze abzurufen, deren UPDATED_AT später als der zuletzt verarbeitete UPDATED_AT-Wert ist. Datensätze mit genau dem Grenz-Zeitstempel können ebenfalls erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel haben. Jeder Datensatz, der zum Zeitpunkt der Abfrageausführung erfasst wird, wird in Braze synchronisiert. Hier sind häufige Fälle, in denen ein Datensatz möglicherweise nicht synchronisiert wird:

• Sie fügen der Tabelle Datensätze mit einem UPDATED_AT-Wert hinzu, der bereits verarbeitet wurde.
• Sie aktualisieren Werte von Datensätzen, nachdem diese bereits durch eine Synchronisierung verarbeitet wurden, lassen UPDATED_AT aber unverändert.
• Sie fügen Datensätze hinzu oder aktualisieren sie, während eine Synchronisierung läuft. Je nachdem, wann die CDI-Abfrage ausgeführt wird, kann es zu Race-Conditions kommen, die dazu führen, dass Datensätze nicht erfasst werden.

Tipp

Um dieses Verhalten künftig zu vermeiden, empfehlen wir, monoton steigende UPDATED_AT-Werte zu verwenden und die Tabelle während Ihres geplanten Synchronisierungslaufs nicht zu aktualisieren.

Benötige ich für große CDI-Importe überwiegend eindeutige UPDATED_AT-Werte?

Ja. Achten Sie bei Synchronisierungen mit hohem Volumen (zum Beispiel mehr als etwa 10 Millionen Zeilen) darauf, dass Ihre Quelldaten überwiegend eindeutige UPDATED_AT-Werte haben. Wenn zu viele Zeilen denselben Zeitstempel haben, wählt CDI Zeilen an Grenz-Zeitstempeln in späteren Synchronisierungen eher erneut aus. Das kann zu mehr doppelten Synchronisierungen und einem höheren Verbrauch an Datenpunkten führen.

Weitere Informationen zum Verhalten von CDI an Grenz-Zeitstempeln finden Sie unter Erneutes Synchronisieren von Zeilen mit doppelten Zeitstempeln vermeiden.

Wo führe ich diese SQL-Prüfungen aus?

Führen Sie die Prüfungen direkt im SQL-Editor Ihres Data Warehouse aus, und zwar für dieselbe Tabelle oder View, die Ihre CDI-Integration verwendet:

• Snowflake: Projects > Worksheets (weitere Informationen finden Sie unter Snowflake Worksheets)
• Redshift: Query Editor v2 (weitere Informationen finden Sie unter Using Amazon Redshift Query Editor v2)
• BigQuery: SQL-Workspace in BigQuery Studio (weitere Informationen finden Sie unter BigQuery Studio introduction)
• Databricks: SQL-Editor (SQL Warehouse) (weitere Informationen finden Sie unter Databricks SQL editor)
• Fabric: SQL-Abfrage-Editor

Gehen Sie so vor, bevor Sie eine große Synchronisierung aktivieren oder skalieren:

1. Ermitteln Sie die genaue CDI-Quelltabelle oder -View und das Synchronisierungsfenster, das Sie überprüfen möchten.
2. Öffnen Sie den SQL-Editor Ihres Warehouse, wählen Sie dieselbe Datenbank und dasselbe Schema aus, die CDI verwendet, und nutzen Sie eine Rolle mit Lesezugriff auf die Quelltabelle oder -View.
3. Führen Sie die Abfrage zur Zählung eindeutiger Zeitstempel aus, um zu ermitteln, wie viele eindeutige UPDATED_AT-Werte in diesem Fenster vorhanden sind.
4. Führen Sie die Abfrage aus, die nach UPDATED_AT gruppiert und Zeilen zählt, um Zeitstempel mit ungewöhnlich hoher Zeilenanzahl zu finden.
5. Wenn viele Zeilen identische Zeitstempel haben, passen Sie Ihren Aufnahmeprozess so an, dass aufeinanderfolgende Batches zunehmend neuere UPDATED_AT-Werte verwenden, oder erhöhen Sie die Genauigkeit der Zeitstempel, damit die Zeilen besser verteilt sind.
6. Führen Sie beide Abfragen erneut aus, bis die Konzentration reduziert ist, und starten oder skalieren Sie dann Ihre Synchronisierung.
7. Überwachen Sie nach dem Start unter CDI > Sync Log, ob an Grenz-Zeitstempeln ein unerwartetes Volumen erneuter Synchronisierungen auftritt.

Verwenden Sie Prüfungen wie diese in Ihrem Warehouse:

1
2
3
4
5
6
7

SELECT
  COUNT(*) AS total_rows,
  COUNT(DISTINCT UPDATED_AT) AS distinct_timestamps,
  ROUND(COUNT(*) * 1.0 / NULLIF(COUNT(DISTINCT UPDATED_AT), 0), 2) AS avg_rows_per_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP);

1
2
3
4
5
6
7
8
9

SELECT
  UPDATED_AT,
  COUNT(*) AS rows_at_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP)
GROUP BY UPDATED_AT
ORDER BY rows_at_timestamp DESC
LIMIT 20;

Wenn Ihr Warehouse LIMIT nicht unterstützt (zum Beispiel Fabric), verwenden Sie eine entsprechende Syntax wie TOP.

Warum kann eine CDI-Synchronisierung mit wenigen Zeilen trotzdem mehrere Minuten dauern?

Eine CDI-Synchronisierung umfasst eine feste Startphase, bevor die Verarbeitung der Zeilen beginnt. Da diese Startzeit bei Synchronisierungen unterschiedlicher Größe ähnlich ist, kann auch eine kleine Synchronisierung mehrere Minuten dauern und gemessen in Zeilen pro Minute langsamer wirken. Die gesamte Synchronisierungsdauer hängt außerdem von der Komplexität Ihrer Quellabfrage, der Struktur Ihrer Daten und der verfügbaren Kapazität in Ihrem Data Warehouse ab. Weitere Informationen finden Sie unter Data-Warehouse-Integrationen.

Bleibt die Reihenfolge während einer Synchronisierung erhalten, wenn mehrere Datensätze dieselbe ID haben?

Die Verarbeitungsreihenfolge ist nicht zu 100 % vorhersehbar. Wenn sich während einer Synchronisierung beispielsweise mehrere Zeilen mit derselben EXTERNAL_ID in der Tabelle befinden, können wir nicht garantieren, welcher Wert im endgültigen Profil landet. Wenn Sie dieselbe EXTERNAL_ID mit unterschiedlichen Attributen in der Payload-Spalte aktualisieren, werden alle Änderungen übernommen, sobald die Synchronisierung abgeschlossen ist.

Warum werden bei meiner CDI-Synchronisierung keine neuen Nutzer:innen erstellt?

Wenn in Ihrer CDI-Integration die Option Nur bestehende Nutzer:innen aktualisieren aktiviert ist, aktualisiert die Synchronisierung nur Nutzer:innen, die bereits in Braze existieren. Neue Nutzer:innen werden nicht erstellt. Verweist eine Zeile in Ihrer Synchronisierungstabelle auf eine EXTERNAL_ID, die zu keinem bestehenden Braze-Nutzerprofil passt, wird diese Zeile übersprungen.

Um über CDI neue Nutzer:innen zu erstellen, deaktivieren Sie in Ihren Integrationseinstellungen den Schalter Nur bestehende Nutzer:innen aktualisieren. Gehen Sie dazu zu Dateneinstellungen > Cloud-Datenaufnahme und wählen Sie eine Integration aus.

Welche Sicherheitsmaßnahmen gibt es für CDI?

Unsere Maßnahmen

Braze hat für CDI die folgenden Maßnahmen implementiert:

• Alle Zugangsdaten werden in unserer Datenbank verschlüsselt, und nur bestimmte Mitarbeitende haben authentifizierten Zugriff darauf.
• Wir verwenden verschlüsselte Verbindungen, um Daten an die Data Warehouses von Kund:innen zu übertragen.
• Wir senden Anfragen an die Braze-API-Endpunkte mit denselben API-Schlüsseln und TLS-Verbindungen, die wir auch unseren Kund:innen empfehlen.
• Wir aktualisieren unsere Bibliotheken regelmäßig und spielen alle Sicherheits-Patches ein.

Ihre Maßnahmen

Wir empfehlen Ihnen und Ihrem Team, auf Ihrer Seite die folgenden Sicherheitsmaßnahmen einzurichten:

• Beschränken Sie den Zugriff der Zugangsdaten auf das Minimum, das für den Betrieb von CDI erforderlich ist. Der Grund: Wir müssen auf den jeweiligen Tabellen und Views SELECT- (und COUNT-)Abfragen ausführen können.
• Beschränken Sie die IPs, die auf die Tabellen zugreifen können, auf die offiziell veröffentlichten Braze-IPs.