Häufig gestellte Fragen

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

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

Wiederkehrende Synchronisierungen können bis zu alle 5 Minuten oder auch nur einmal im Monat laufen. Standardmäßig ist das kürzeste Intervall, das Sie im Dashboard festlegen können, 15 Minuten. Das hilft Ihnen, die Rechenkosten Ihres Data Warehouse und das Anfragevolumen zu steuern. Wenn Sie bis zu alle 5 Minuten synchronisieren möchten, wenden Sie sich an den Braze-Support oder Ihre:n Customer-Success-Manager:in. Wenn Sie synchronisieren möchten, sobald sich Ihre Daten ändern, rufen Sie den Endpunkt Synchronisierung 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 bedeutet in der Regel, dass es ein Problem mit Ihrer CDI-Einrichtung gibt. Hier finden Sie 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 in den Einrichtungsschritten auf Ihrer Quellseite.

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 im Braze-Katalog nicht. Ein Katalog kann entfernt worden sein, nachdem die Integration eingerichtet wurde. Um das Problem zu beheben, aktualisieren Sie entweder die Integration, sodass sie einen anderen Katalog verwendet, oder erstellen Sie einen neuen Katalog, der dem Katalognamen in der Integration entspricht.

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 Wert des Event-Felds time in Ihrem CDI-Payload kein unterstütztes Datums- und Zeitformat hat.

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 Zeitpunkt des Events.

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

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

Test Connection läuft in Ihrem Data Warehouse. Mehr Kapazität im Warehouse kann die Ausführung daher beschleunigen. Eine Serverless-SQL-Instanz verkürzt die Aufwärmzeit und erhöht den Abfragedurchsatz, kann aber etwas höhere Integrationskosten verursachen.

Fehlermeldungen zu Ihrer jeweiligen Quelle finden Sie im Abschnitt zur Fehlerbehebung auf der Seite dieser Quelle:

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

Jede Integration hat ihre eigenen Benachrichtigungseinstellungen. 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 denselben Ordner verweisen. Jeder Cloud-Storage-Speicherort kann jeweils nur von einer Integration verwendet werden.

So beheben Sie den Fehler:

1. Ermitteln Sie, welcher andere Workspace eine CDI-Integration mit demselben Speicherort nutzt.
2. Entfernen oder konfigurieren Sie die konfliktverursachende 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 vor diesem zukünftigen Datum und dieser Uhrzeit nicht mehr 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 festzulegen, 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 und ruft alle Datensätze ab, deren UPDATED_AT später als der zuvor verarbeitete UPDATED_AT-Wert ist. Datensätze mit genau dem Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel haben. Alle Datensätze, die zum Zeitpunkt der Abfrage erfasst werden, werden mit 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 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, kann es zu Race-Conditions kommen, durch die 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 überwiegend eindeutige UPDATED_AT-Werte für große CDI-Importe?

Ja. Achten Sie bei umfangreichen Läufen (zum Beispiel mehr als etwa 10 Millionen Zeilen) darauf, dass Ihre Quelldaten überwiegend eindeutige UPDATED_AT-Werte enthalten. Wenn zu viele Zeilen denselben Zeitstempel haben, wählt CDI Zeilen an Grenz-Zeitstempeln in späteren Läufen mit höherer Wahrscheinlichkeit erneut aus. Das kann zu mehr doppelten Synchronisierungen und einem höheren Verbrauch von Datenpunkten 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 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 prü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 vielen Zeilen 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 Genauigkeit der Zeitstempel, damit die Zeilen besser verteilt sind.
6. Führen Sie beide Abfragen erneut aus, bis die Konzentration geringer ist, und starten oder skalieren Sie dann Ihre Synchronisierung.
7. Überwachen Sie nach dem Start unter CDI > Sync Log, ob an Grenz-Zeitstempeln unerwartet viele erneute Synchronisierungen auftreten.

Verwenden Sie in Ihrem Warehouse Prüfungen wie diese:

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 gleichwertige Syntax wie TOP.

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

Eine CDI-Synchronisierung beginnt mit einer festen Startphase, bevor die Zeilen verarbeitet werden. Diese Startzeit ist bei allen Synchronisierungsgrößen ähnlich. Deshalb kann auch eine kleine Synchronisierung mehrere Minuten dauern und, gemessen in Zeilen pro Minute, langsamer erscheinen. 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 Quellen für Cloud Data Ingestion.

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

Die Verarbeitungsreihenfolge ist nicht zu 100 % vorhersehbar. Wenn sich beispielsweise während einer Synchronisierung 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 angelegt?

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 angelegt. Verweist eine Zeile in Ihrer Synchronisierungstabelle also auf eine EXTERNAL_ID, die keinem bestehenden Braze-Nutzerprofil entspricht, wird diese Zeile übersprungen.

Wenn Sie über CDI neue Nutzer:innen anlegen möchten, deaktivieren Sie in Ihren Integrationseinstellungen die Option Nur bestehende Nutzer:innen aktualisieren. Gehen Sie dazu zu Dateneinstellungen > Cloud Data Ingestion 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 getroffen:

• Alle Zugangsdaten werden in unserer Datenbank verschlüsselt, und nur bestimmte Mitarbeitende haben authentifizierten Zugriff darauf.
• Wir verwenden verschlüsselte Verbindungen, um Daten aus den Data Warehouses unserer Kund:innen abzurufen.
• Wir stellen Anfragen an die API-Endpunkte von Braze mit denselben API-Schlüsseln und TLS-Verbindungen, die wir auch unseren Kund:innen empfehlen.
• Wir aktualisieren unsere Bibliotheken regelmäßig und spielen alle Sicherheitspatches 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. Wir müssen lediglich select (und count) auf den jeweiligen Tabellen und Views ausführen können.
• Beschränken Sie die IP-Adressen, die auf die Tabellen zugreifen können, auf die offiziell veröffentlichten IP-Adressen von Braze. Auf jeder Quellseite sind die IP-Adressen aufgeführt, die Sie für die jeweilige Quelle zulassen müssen.