Häufig gestellte Fragen

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

Wie oft kann eine CDI-Synchronisation ausgeführt werden?

Wiederkehrende Synchronisationen können alle 5 Minuten oder auch nur einmal im Monat ausgeführt werden. Standardmäßig beträgt das kürzeste Intervall, das Sie im Dashboard einstellen können, 15 Minuten – das hilft, Ihre Warehouse-Rechenkosten und das Anfragevolumen zu steuern. Um die Synchronisation alle 5 Minuten auszuführen, wenden Sie sich an den Braze-Support oder Ihre:n Customer-Success-Manager:in. Um eine Synchronisation sofort auszulösen, sobald sich Ihre Daten ändern, rufen Sie den Endpunkt Trigger a sync auf. Weitere Informationen finden Sie unter Funktionsweise.

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 sie 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 entfernt werden, nachdem die Integration eingerichtet wurde. Um das Problem zu beheben, aktualisieren Sie entweder die Integration, um einen anderen Katalog zu verwenden, oder erstellen Sie einen neuen Katalog, der mit dem Katalognamen in der Integration übereinstimmt.

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

Diese Art von E-Mail bedeutet, dass einige Ihrer Daten während der Synchronisierung nicht verarbeitet werden konnten. Um den genauen 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 Events in Ihrem CDI-Payload nicht in einem unterstützten Datums-/Zeitformat vorliegt.

Formatieren Sie time in Event- und Kauf-Payloads als:

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

Wenn time weggelassen wird, verwendet Braze UPDATED_AT als Event-Zeit.

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

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

• snowflake
• redshift
• bigquery
• databricks

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

Jede Integration hat eigene Benachrichtigungseinstellungen. Navigieren Sie zur CDI-Seite und wählen Sie den Namen der Integration aus, die Sie aktualisieren möchten. Im Bereich Notification preferences 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 versuchen, die Benachrichtigungseinstellungen für eine CDI-Integration zu aktualisieren, und zwei oder mehr Workspaces Integrationen haben, die auf denselben Cloud-Speicher-Bucket oder -Ordner verweisen. Jeder Cloud-Speicherort kann jeweils nur von einer Integration verwendet werden.

So beheben Sie das Problem:

1. Ermitteln Sie, welcher andere Workspace eine CDI-Integration hat, die denselben Speicherort verwendet.
2. Entfernen oder rekonfigurieren Sie die konfliktverursachende Integration im anderen Workspace.
3. Nachdem der Konflikt beseitigt ist, können Sie die Benachrichtigungseinstellungen aktualisieren.

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

Was passiert, wenn ein zukünftiges UPDATED_AT mit einer Integration synchronisiert wird?

CDI verwendet UPDATED_AT, um zu entscheiden, welche Daten neu sind. Nachdem ein zukünftiges UPDATED_AT 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 „Synchronisierte Zeilen“ nicht mit der Anzahl in meinem Data Warehouse überein?

CDI verwendet UPDATED_AT, um zu entscheiden, welche Datensätze bei einer Synchronisierung abgerufen werden. Sehen Sie sich diese Abbildung an, um zu erfahren, wie es funktioniert. Zu Beginn einer Synchronisierung 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 an der exakten Grenze des Zeitstempels können ebenfalls erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen. 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 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 erfasst werden.

Tipp

Um dieses Verhalten künftig zu vermeiden, empfehlen wir die Verwendung von monoton ansteigenden UPDATED_AT-Werten und keine Aktualisierung der Tabelle während Ihrer geplanten Synchronisierung.

Brauche ich überwiegend eindeutige UPDATED_AT-Werte für große CDI-Importe?

Ja. Stellen Sie bei großvolumigen Läufen (zum Beispiel bei 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 Läufen Zeilen an Grenz-Zeitstempeln erneut auswählt. Dies kann zu vermehrten doppelten Synchronisierungen und einem höheren Datenpunktverbrauch führen.

Weitere Informationen zum CDI-Grenzverhalten 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 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-Abfrage-Editor

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, wählen Sie dieselbe Datenbank und dasselbe Schema aus, die von CDI verwendet werden, und verwenden Sie dann eine Rolle mit Lesezugriff auf die Quelltabelle oder -View.
3. Führen Sie die Abfrage zur Zählung eindeutiger Zeitstempel aus, um zu messen, wie viele eindeutige UPDATED_AT-Werte in diesem Fenster existieren.
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 Zeitstempelpräzision, 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 das unerwartete Resynchronisierungsvolumen bei 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;

Falls Ihr Data Warehouse LIMIT nicht unterstützt (zum Beispiel Fabric), verwenden Sie eine äquivalente 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 Bezug auf 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.

Bleibt die Reihenfolge bei einer Synchronisierung erhalten, 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 vorhandene 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 eine EXTERNAL_ID referenziert, die keinem vorhandenen Braze-Nutzerprofil entspricht, wird diese Zeile übersprungen.

Um neue Nutzer:innen über CDI zu erstellen, deaktivieren Sie den Schalter Nur vorhandene Nutzer:innen aktualisieren in Ihren Integrationseinstellungen. Navigieren Sie zu Data Settings > Cloud Data Ingestion 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 unserer 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 beziehen 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.