Häufig gestellte Fragen

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

Warum habe ich eine E-Mail erhalten: „Fehler bei der CDI-Synchronisierung“?

Diese Art von E-Mail bedeutet in der Regel, dass ein Problem mit Ihrer CDI-Einrichtung vorliegt. Hier sind einige häufige Probleme und deren Lösungen:

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

Dies könnte bedeuten, dass die Zugangsdaten in CDI falsch sind oder im Data Warehouse nicht korrekt konfiguriert wurden. Weitere Informationen finden Sie unter Data-Warehouse-Integrationen.

Die Tabelle kann nicht gefunden werden

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

Der Katalog kann nicht gefunden werden

Der in der Integration eingerichtete Katalog existiert nicht im Braze-Katalog. Ein Katalog kann nach der Einrichtung der Integration entfernt worden sein. Um das Problem zu beheben, aktualisieren Sie entweder die Integration, um einen anderen Katalog zu verwenden, oder erstellen Sie einen neuen Katalog, der dem Katalognamen in der Integration entspricht.

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

Diese Art von E-Mail bedeutet, dass einige Ihrer Daten während der Synchronisierung nicht verarbeitet werden konnten. Um den spezifischen Fehler zu ermitteln, können Sie die Protokolle in Braze überprüfen, indem Sie zu CDI > Sync Log navigieren.

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

Dieser Fehler bedeutet, dass der time-Wert des Ereignisses in Ihrem CDI-Payload nicht in einem unterstützten Datums-/Zeitformat vorliegt.

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

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

Wenn time weggelassen wird, verwendet Braze UPDATED_AT als Ereigniszeitpunkt.

Die vollständigen Anforderungen an Payloads finden Sie unter Tabelleneinrichtung für Cloud-Datenaufnahme.

Wie behebe ich Fehler bei der Testverbindung und bei Support-E-Mails?

• snowflake
• redshift
• bigquery
• databricks

Wie aktualisiere ich meine E-Mail-Benachrichtigungseinstellungen für CDI-Integrationen?

Jede Integration hat ihre eigenen Benachrichtigungseinstellungen. Navigieren Sie zur CDI-Seite und wählen Sie den Namen der Integration aus, die Sie aktualisieren möchten. Im Abschnitt Notification preferences können Sie festlegen, wie Sie Benachrichtigungen zu der ausgewählten Integration erhalten.

Warum wird der Fehler „Incorrect Integration Object“ angezeigt?

Dieser Fehler tritt auf, wenn Sie versuchen, die Benachrichtigungseinstellungen für eine CDI-Integration zu aktualisieren, 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 verwendet werden.

So beheben Sie das Problem:

1. Ermitteln Sie, welcher andere Workspace eine CDI-Integration verwendet, die denselben Speicherort nutzt.
2. Entfernen oder konfigurieren Sie die konfliktverursachende Integration im anderen Workspace neu.
3. Nachdem der Konflikt behoben wurde, können Sie die Benachrichtigungseinstellungen aktualisieren.

Der Fehler sollte nicht mehr auftreten, und Sie sollten Ihre Benachrichtigungseinstellungen erfolgreich aktualisieren können. Falls weiterhin Probleme bestehen, erstellen Sie ein Support-Ticket.

Was passiert, wenn ein zukünftiger UPDATED_AT-Wert mit einer Integration synchronisiert wird?

CDI verwendet UPDATED_AT, um zu bestimmen, welche Daten neu sind. Nachdem ein zukünftiger UPDATED_AT-Wert synchronisiert wurde, werden keine Daten verarbeitet, die vor diesem zukünftigen Datum und dieser Uhrzeit liegen. Um dies zu beheben:

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 die Anzahl der „synchronisierten Zeilen“ 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 Darstellung an, um zu verstehen, wie das funktioniert. Zu Beginn eines Synchronisierungslaufs fragt CDI Ihr Data Warehouse ab, um alle Datensätze zu erhalten, deren UPDATED_AT-Wert nach dem zuletzt verarbeiteten UPDATED_AT-Wert liegt. Datensätze, die genau auf dem Grenz-Zeitstempel liegen, können ebenfalls erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel teilen. 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 Datensatzwerte, nachdem sie von einer 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, können Race-Conditions auftreten, die dazu führen, dass Datensätze nicht übernommen werden.

Tipp

Um dieses Verhalten in Zukunft zu vermeiden, empfehlen wir die Verwendung monoton steigender UPDATED_AT-Werte und das Vermeiden von Tabellenaktualisierungen während Ihres geplanten Synchronisierungslaufs.

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

Ja. Stellen Sie bei großen Datenmengen (z. B. mehr als ca. 10 Millionen Zeilen) sicher, dass Ihre Quelldaten überwiegend unterschiedliche UPDATED_AT-Werte aufweisen. Wenn zu viele Zeilen denselben Zeitstempel haben, ist es wahrscheinlicher, dass CDI bei späteren Durchläufen Zeilen an Grenz-Zeitstempeln erneut auswählt. Dies kann zu doppelten Synchronisierungen und einem höheren Datenpunktverbrauch führen.

Weitere Informationen zum Grenzverhalten von CDI finden Sie unter Erneute Synchronisierung von Zeilen mit doppelten Zeitstempeln vermeiden.

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

Führen Sie die Prüfungen direkt in Ihrem Data-Warehouse-SQL-Editor aus – gegen dieselbe Tabelle oder View, die von Ihrer CDI-Integration verwendet wird:

• 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: BigQuery Studio SQL Workspace (weitere Informationen finden Sie unter BigQuery Studio introduction)
• Databricks: SQL-Editor (SQL Warehouse) (weitere Informationen finden Sie unter Databricks SQL editor)
• Fabric: SQL-Abfrageeditor

Verwenden Sie diesen Prozess, bevor Sie eine große Synchronisierung aktivieren oder skalieren:

1. Identifizieren Sie die genaue CDI-Quelltabelle oder -View und das Synchronisierungsfenster, das Sie validieren möchten.
2. Öffnen Sie Ihren Data-Warehouse-SQL-Editor und wählen Sie dieselbe Datenbank und dasselbe Schema aus, die von CDI verwendet werden. Verwenden Sie dann eine Rolle mit Lesezugriff auf die Quelltabelle oder -View.
3. Führen Sie die Abfrage zur Zählung der unterschiedlichen Zeitstempel aus, um zu messen, wie viele unterschiedliche 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 progressiv neuere UPDATED_AT-Werte verwenden, oder erhöhen Sie die Zeitstempelpräzision, damit die Zeilen gleichmäßiger 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 das Volumen unerwarteter erneuter Synchronisierungen an Grenz-Zeitstempeln.

Verwenden Sie Prüfungen wie diese in Ihrem Data 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 Data Warehouse LIMIT nicht unterstützt (z. B. Fabric), verwenden Sie eine gleichwertige Syntax wie TOP.

Warum kann eine CDI-Synchronisierung mit einer geringen Anzahl von Zeilen dennoch mehrere Minuten dauern?

Eine CDI-Synchronisierung umfasst eine feste Startphase, bevor die Zeilenverarbeitung beginnt. Da diese Startzeit bei allen Synchronisierungsgrößen ähnlich ist, kann eine kleine Synchronisierung dennoch mehrere Minuten dauern und in Bezug auf Zeilen pro Minute langsamer erscheinen. Die gesamte Synchronisierungsdauer hängt weiterhin von der Komplexität Ihrer Quellabfrage, der Datenstruktur und der verfügbaren Kapazität in Ihrem Data Warehouse ab. Weitere Informationen finden Sie unter Data-Warehouse-Integrationen.

Wird bei einer Synchronisierung die Reihenfolge beibehalten, wenn mehrere Datensätze dieselbe ID haben?

Die Verarbeitungsreihenfolge ist nicht zu 100 % vorhersagbar. Wenn beispielsweise während einer Synchronisierung mehrere Zeilen mit derselben EXTERNAL_ID in der Tabelle vorhanden sind, kann nicht garantiert werden, welcher Wert letztendlich im Profil gespeichert wird. Wenn Sie dieselbe EXTERNAL_ID mit unterschiedlichen Attributen in der Payload-Spalte aktualisieren, werden alle Änderungen nach Abschluss der Synchronisierung übernommen.

Warum werden durch meinen CDI-Sync keine neuen Nutzer:innen erstellt?

Wenn in Ihrer CDI-Integration die Option Nur bestehende Nutzer:innen aktualisieren aktiviert ist, werden nur Nutzer:innen aktualisiert, die bereits in Braze vorhanden sind – neue Nutzer:innen werden nicht erstellt. Das bedeutet: Wenn eine Zeile in Ihrer Sync-Tabelle auf eine EXTERNAL_ID verweist, die keinem bestehenden Braze-Nutzerprofil entspricht, wird diese Zeile übersprungen.

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

Welche Sicherheitsmaßnahmen gibt es für CDI?

Unsere Maßnahmen

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

• Alle Zugangsdaten werden in unserer Datenbank verschlüsselt gespeichert, und nur bestimmte Mitarbeitende haben authentifizierten Zugriff darauf.
• Wir verwenden verschlüsselte Verbindungen, um Daten an die Data Warehouses der 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 regelmäßig unsere Bibliotheken und installieren alle Sicherheitspatches.

Ihre Maßnahmen

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

• Beschränken Sie den Zugriff auf Zugangsdaten auf das Minimum, das für den Betrieb von CDI erforderlich ist. Das liegt daran, dass wir in der Lage sein müssen, SELECT- (und COUNT-)Abfragen auf den spezifischen Tabellen und Views auszuführen.
• Beschränken Sie die IPs, die auf die Tabellen zugreifen können, auf die offiziell veröffentlichten Braze-IPs.