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 wie Sie diese beheben können:

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 fehlerhaft 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: „Zeilenfehler in Ihrer CDI-Synchronisierung“?

Diese Art von E-Mail bedeutet, dass einige Ihrer Daten während der Synchronisierung nicht verarbeitet werden konnten. Um den spezifischen Fehler herauszufinden, 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 nicht angegeben wird, verwendet Braze UPDATED_AT als Ereigniszeit.

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

Wie behebe ich Fehler bei „Verbindung testen“ und 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 zur ausgewählten Integration erhalten.

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

CDI verwendet UPDATED_AT, um zu entscheiden, welche Daten neu sind. Nachdem ein zukünftiger UPDATED_AT-Wert synchronisiert wurde, werden alle Daten vor diesem zukünftigen Datum und Zeitpunkt nicht verarbeitet. 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 „Synchronisierte Zeilen“ nicht mit der Anzahl in meinem Data Warehouse überein?

CDI verwendet UPDATED_AT, um zu entscheiden, welche Datensätze während einer Synchronisierung abgerufen werden. Sehen Sie sich diese Darstellung an, um zu verstehen, wie es funktioniert. Zu Beginn eines Synchronisierungslaufs fragt CDI Ihr Data Warehouse ab, um alle Datensätze mit einem UPDATED_AT-Wert abzurufen, der nach dem zuletzt verarbeiteten UPDATED_AT-Wert liegt. Datensätze am exakten Grenz-Zeitstempel können ebenfalls erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen. Jeder Datensatz, der zum Zeitpunkt der Abfrageausführung abgerufen 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 durch eine Synchronisierung verarbeitet wurden, lassen UPDATED_AT jedoch 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 abgerufen werden.

Tipp

Um dieses Verhalten in Zukunft zu vermeiden, empfehlen wir die Verwendung monoton steigender UPDATED_AT-Werte und keine Aktualisierung der Tabelle während Ihres geplanten Synchronisierungslaufs.

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

Ja. Stellen Sie bei Importen mit hohem Volumen (z. B. mehr als ca. 10 Millionen Zeilen) sicher, dass Ihre Quelldaten überwiegend eindeutige 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 vermehrten doppelten Synchronisierungen und einem höheren Datenpunktverbrauch führen.

Weitere Informationen zum Grenzverhalten von CDI 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, gegen dieselbe Tabelle oder Ansicht, 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 query editor

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

1. Identifizieren Sie die genaue CDI-Quelltabelle oder -Ansicht und das Synchronisierungsfenster, das Sie validieren möchten.
2. Öffnen Sie den SQL-Editor Ihres Data Warehouse 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 -Ansicht.
3. Führen Sie die Abfrage zur Zählung eindeutiger Zeitstempel aus, um zu messen, 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 fortlaufend 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 kleinen Anzahl von Zeilen trotzdem mehrere Minuten dauern?

Eine CDI-Synchronisierung umfasst eine feste Anlaufphase, bevor die Zeilenverarbeitung beginnt. Da diese Anlaufzeit bei allen Synchronisierungsgrößen ähnlich ist, kann eine kleine Synchronisierung trotzdem mehrere Minuten dauern und in Zeilen pro Minute langsamer erscheinen. Die Gesamtdauer der Synchronisierung 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 landet. 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, und es werden keine neuen Nutzer:innen erstellt. Das bedeutet, dass eine Zeile in Ihrer Sync-Tabelle übersprungen wird, wenn sie eine EXTERNAL_ID referenziert, die keinem bestehenden Braze-Nutzerprofil entspricht.

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 jeweiligen Tabellen und Views auszuführen.
• Beschränken Sie die IPs, die auf die Tabellen zugreifen können, auf die offiziell veröffentlichten Braze-IPs.