Skip to content

Cloud-Datenaufnahme: SQL-Editor

Auf dieser Seite erfahren Sie, wie Sie den SQL-Editor der Braze Cloud-Datenaufnahme (CDI) verwenden, um Synchronisierungen mit SQL-Anfragen zu erstellen und zu validieren.

Der SQL-Editor der Cloud-Datenaufnahme ermöglicht es Ihnen, Synchronisierungen zu erstellen, indem Sie SQL-Anfragen direkt gegen Ihr Data Warehouse schreiben. Dadurch entfällt die Notwendigkeit, eine dedizierte CDI-Tabelle zu erstellen oder zu pflegen, was zuvor in Schritt 1.1 der Data-Warehouse-Integrationen erforderlich war.

Verwenden Sie den SQL-Editor, wenn Sie:

  • Daten synchronisieren möchten, ohne vorgelagerte Tabellen zu ändern
  • Mit Rohdaten in Ihrem Warehouse arbeiten möchten
  • Die Erstellung einer PAYLOAD-Spalte vermeiden möchten
  • Komplexere Datenanwendungsfälle mit SQL bearbeiten möchten

Voraussetzungen und Einschränkungen

Der SQL-Editor hat die folgenden Einschränkungen:

  • Verfügbar nur für Data-Warehouse-Quellen: Snowflake, Redshift, BigQuery, Databricks und Fabric.
  • Es werden nur einzelne, lesende Anfragen unterstützt.

Eine neue SQL-Editor-Synchronisierung erstellen

Befolgen Sie diese Schritte, um zuerst eine Quelle und dann eine Synchronisierung mit dem SQL-Editor zu erstellen. Wenn Sie bereits eine Quelle für CDI eingerichtet haben, können Sie direkt zu Schritt 3 springen.

1. Schritt: Snowflake-Rolle, Berechtigungen, Warehouse und Nutzer:in einrichten

Bevor Sie Ihre Snowflake-Quelle in CDI erstellen, stellen Sie sicher, dass die Snowflake-Nutzer:in, die Braze verwendet, Zugriff auf die Daten hat, die Sie abfragen möchten, sowie ein Warehouse zum Ausführen von Anfragen.

Schritt 1.1: (Optional) Datenbank und Schema erstellen

Falls erforderlich, erstellen Sie eine dedizierte Datenbank und ein Schema für Ihre CDI-Daten:

1
2

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Schritt 1.2: Rolle und Datenbankberechtigungen einrichten

Gewähren Sie Zugriff auf die Tabellen, die Sie synchronisieren möchten:

1
2
3
4
5

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.MY_USER_TABLE TO ROLE BRAZE_INGESTION_ROLE;

Sie können auch Zugriff auf mehrere oder zukünftige Tabellen gewähren, je nach Anwendungsfall. Um beispielsweise Zugriff auf alle zukünftigen Tabellen in einem Schema zu gewähren:

1

GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

Schritt 1.3: Warehouse einrichten und Zugriff für die Braze-Rolle gewähren

Erstellen Sie ein Warehouse, damit Braze Anfragen ausführen kann:

1
2

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;
GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Schritt 1.4: Snowflake-Nutzer:in erstellen

Erstellen Sie eine Nutzer:in für Braze und weisen Sie die Rolle zu:

1
2

CREATE USER BRAZE_INGESTION_USER;
GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Sie verwenden diese Nutzer:in, wenn Sie Ihre Snowflake-Quelle in Braze konfigurieren.

2. Schritt: Eine neue Quelle im Braze-Dashboard erstellen

In diesem Schritt erstellen Sie Ihre Snowflake-Quelle in Braze und validieren die Verbindung.

Schritt 2.1: Snowflake-Quelle hinzufügen

  1. Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud-Datenaufnahme > Quellen.
  2. Wählen Sie Datenquelle hinzufügen.
  3. Wählen Sie Snowflake.

Schritt 2.2: Verbindungsdetails eingeben

Wählen Sie einen Namen für Ihre Quelle und geben Sie Ihre Snowflake-Zugangsdaten und Konfiguration ein.

Schritt 2.3: RSA-Schlüssel-Einrichtung abschließen

Nachdem Sie Ihre Zugangsdaten und Konfiguration eingegeben haben, wählen Sie Save credentials und generieren Sie einen RSA-Schlüssel. Gehen Sie dann zurück zu Snowflake, um die Einrichtung abzuschließen. Fügen Sie den im Dashboard angezeigten öffentlichen Schlüssel der Nutzer:in hinzu, die Sie für die Verbindung von Braze mit Snowflake erstellt haben.

Weitere Informationen finden Sie unter Snowflake-Schlüsselpaar-Authentifizierung. Wenn Sie Schlüssel zu einem beliebigen Zeitpunkt rotieren möchten, kann Braze ein neues Schlüsselpaar generieren und den neuen öffentlichen Schlüssel bereitstellen.

1

ALTER USER BRAZE_INGESTION_USER SET RSA_PUBLIC_KEY='MIIBIjANBgkqhkiG9w0BA...';

Wählen Sie in Braze Test connection, um den Quellzugriff zu überprüfen, und erstellen Sie dann die Quelle.

3. Schritt: Eine neue Synchronisierung erstellen und Ihre SQL-Anfrage schreiben

  1. Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Synchronisierungen.
  2. Wählen Sie Create data sync.
  3. Wählen Sie eine beliebige Synchronisierung unter Data Type.
  4. Referenzieren Sie die Quelle aus Schritt 2.
  5. Wählen Sie SQL und schreiben Sie eine SQL-Anfrage, die Nutzerdaten aus Ihrem Warehouse zurückgibt. Ihre SQL-Anfrage definiert die Daten, die mit Braze synchronisiert werden. Das Anfrageergebnis wird zum Schema für Ihre Synchronisierung.

Sie können den Source Explorer verwenden, um verfügbare Tabellen und Views zum Synchronisieren zu durchsuchen, oder den KI-SQL-Generator nutzen, um Unterstützung von Braze Operator für Ihre SQL-Anfrage zu erhalten.

4. Schritt: Anfrage in der Vorschau anzeigen und validieren

Wählen Sie Preview and validate, um Ihre Anfrage auszuführen.

Die Vorschau:

  • Zeigt Ergebnisse im Tabellenformat an
  • Zeigt bis zu 100 Zeilen an
  • Zeigt bis zu 250 Spalten an

Für eine erfolgreiche Validierung muss Ihre SQL-Anfrage verschiedene erforderliche Spalten zurückgeben:

Synchronisierungsdatentyp Erforderliche Spalten
Attribute - Ein Nutzerbezeichner, einer von external_id, braze_id, alias_name und alias_label, E-Mail oder Telefonnummer.
- UPDATED_AT.
- Mindestens eine zusätzliche Spalte (Attribut) zum Synchronisieren.
Nutzer:innen löschen - Ein Nutzerbezeichner, einer von external_id, braze_id, alias_name und alias_label, E-Mail oder Telefonnummer.
- UPDATED_AT.
Canvas-Trigger - Ein Nutzerbezeichner, einer von external_id, braze_id, alias_name und alias_label, E-Mail oder Telefonnummer.
- UPDATED_AT.
Angepasste Events - Ein Nutzerbezeichner, einer von external_id, braze_id, alias_name und alias_label, E-Mail oder Telefonnummer.
- UPDATED_AT.
- NAME für den Event-Namen.
- TIME für den Event-Zeitpunkt. Falls nicht verfügbar, verwendet CDI UPDATED_AT als Ersatz.
Kauf-Events - Ein Nutzerbezeichner, einer von external_id, braze_id, alias_name und alias_label, E-Mail oder Telefonnummer.
- UPDATED_AT.
- PRODUCT_ID.
- CURRENCY.
- PRICE.
- TIME für den Zeitpunkt des Kauf-Events. Falls nicht verfügbar, verwendet CDI UPDATED_AT als Ersatz.
Katalog - ID für den Bezeichner des Katalogartikels.
- UPDATED_AT.
- Mindestens eine zusätzliche Spalte (Katalogfeld) zum Synchronisieren.
Konten - ID für den Kontobezeichner.
- NAME für den Kontonamen.
- UPDATED_AT.
- Mindestens eine zusätzliche Spalte (Kontofeld) zum Synchronisieren.

Zusätzliche Spalten außerhalb der erforderlichen Spalten werden als Attribute, Canvas-Kontexteigenschaften, Event-Eigenschaften, Katalogfelder bzw. Kontofelder synchronisiert. Hilfreiche Tipps zu Vorschau- und Validierungsfehlern und deren Behebung finden Sie unter Validierungsverhalten und Fehlerbehebung.

5. Schritt: Attribut-Zuordnung überprüfen und Synchronisierung erstellen

Wenn die Validierung erfolgreich ist, fahren Sie mit Next: Notifications fort und erstellen Sie Ihre Synchronisierung.

SQL-Einschränkungen

Nur SELECT-Anfragen verwenden

Es werden nur lesende Anfragen unterstützt.

Sie können verwenden:

  • SELECT
  • WITH (CTEs)
  • JOIN

Sie können nicht verwenden:

  • INSERT, UPDATE oder DELETE
  • CREATE oder DROP
  • Mehrere Anweisungen, getrennt durch ;

Eine einzelne Anweisung verwenden

Ihre Anfrage muss eine einzelne ausführbare Anweisung sein.

Validierungsverhalten

Der SQL-Editor validiert Ihre Anfrage, bevor Sie fortfahren können.

SQL-Fehler

Wenn Ihre Anfrage Syntaxfehler enthält:

  • Die Validierung schlägt fehl
  • Es wird keine Vorschau angezeigt
  • Ihr Warehouse gibt eine Fehlermeldung zurück

Kompilierungsfehler

Wenn Ihre Anfrage auf ungültige Tabellen, Spalten oder nicht autorisierte Objekte verweist:

  • Die Validierung schlägt fehl
  • Es wird keine Vorschau angezeigt
  • Ihr Warehouse gibt eine Fehlermeldung zurück

Verbindungsfehler

Wenn Braze keine Verbindung zu Ihrem Warehouse herstellen kann:

  • Die Validierung schlägt fehl
  • Es wird keine Vorschau angezeigt
  • Eine Verbindungsfehlermeldung wird angezeigt

Anfrage-Timeout

Wenn Ihre Anfrage zu lange läuft:

  • Braze beendet die Anfrage
  • Die Validierung schlägt fehl
  • Ein Timeout-Fehler wird angezeigt

Tabellenschema-Fehler

Wenn Ihre Anfrage kompiliert wird, kann die Validierung dennoch fehlschlagen, wenn:

  • Keine Bezeichner-Spalte gefunden wird
  • UPDATED_AT fehlt
  • Andere erforderliche Spalten fehlen

In diesem Fall wird die Vorschau dennoch angezeigt, um Ihnen bei einer erfolgreichen Validierung zu helfen. Details zu den erforderlichen Spalten für jeden Synchronisierungsdatentyp finden Sie unter 4. Schritt im vorherigen Abschnitt.

Ergebnisse mit null Zeilen

Wenn Ihre Anfrage null Zeilen zurückgibt:

  • Die Validierung ist erfolgreich
  • Sie können die Synchronisierung trotzdem erstellen
  • Es werden keine Nutzer:innen aktualisiert, bis Zeilen zurückgegeben werden

PAYLOAD-Unterstützung (Legacy)

Der SQL-Editor unterstützt Legacy-CDI-Tabellen, in denen eine PAYLOAD-Spalte vorhanden ist.

Wenn Ihre Anfrage Folgendes enthält:

  • Einen gültigen Bezeichner
  • UPDATED_AT
  • Eine PAYLOAD-Spalte
  • Zusätzliche Spalten

Dann:

  • Braze synchronisiert nur die PAYLOAD-Spalte
  • Braze ignoriert zusätzliche Spalten

Eine SQL-Synchronisierung bearbeiten

Beim Bearbeiten einer bestehenden Synchronisierung:

  • Jede SQL-Änderung erfordert eine erneute Validierung
  • Sie können ungültige Änderungen nicht speichern
  • Gültige Änderungen werden nach dem Speichern wirksam

Wenn bereits eine Synchronisierung läuft, werden Ihre Änderungen beim nächsten Durchlauf wirksam.

Fehlerbehebung

Dieser Abschnitt enthält häufige Fehler und Hinweise zur Fehlerbehebung.

„Keine Vorschau verfügbar“

Wenn „Keine Vorschau verfügbar“ angezeigt wird, kann einer der folgenden zugrunde liegenden Fehlertypen die Ursache sein.

Fehlertyp Schritte zur Behebung
„Keine Vorschau verfügbar“ Lesen Sie das Fehlerbanner für Hinweise.
„Verbindung zur Quelle nicht möglich“ Überprüfen Sie den konfigurierten Nutzernamen, den Account Locator und die RSA-Schlüsselpaar-Authentifizierungseinrichtung.
Stellen Sie sicher, dass das Warehouse läuft.
Bestätigen Sie den Netzwerkzugriff.
„SQL-Syntaxfehler“ Überprüfen Sie Ihre SQL-Syntax.
„Objekt existiert nicht oder nicht autorisiert“ Stellen Sie sicher, dass die Rolle SELECT-Zugriff auf die Tabelle hat.
Bestätigen Sie die Datenbank- und Schemaberechtigungen.
Überprüfen Sie Tippfehler im Tabellennamen.

„Bezeichner-Spalte erforderlich“

Stellen Sie sicher, dass Ihre Anfrage einen gültigen Bezeichner enthält, wie z. B. external_id.

„UPDATED_AT-Spalte fehlt“

Fügen Sie eine Zeitstempel-Spalte für die inkrementelle Synchronisierung hinzu.

„Weitere Spalten hinzufügen … Es sind keine Attribute/Katalogfelder/Kontofelder zum Synchronisieren vorhanden“

Fügen Sie mindestens eine zusätzliche Spalte neben dem Bezeichner und UPDATED_AT hinzu.

„Anfrageausführung hat das Zeitlimit überschritten“

Optimieren Sie Ihre Anfrage oder verwenden Sie ein größeres Warehouse.
New Stuff!