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:

  • Nur für Data-Warehouse-Quellen verfügbar: Snowflake, Redshift, BigQuery, Databricks und Fabric.
  • Es werden nur einzelne, schreibgeschützte Abfragen unterstützt.

Erstellen einer neuen SQL-Editor-Synchronisierung

Folgen Sie diesen Schritten, 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.

Schritt 1: 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 auf ein Warehouse zum Ausführen von Anfragen.

Schritt 1.1: (Optional) Datenbank und Schema erstellen

Erstellen Sie bei Bedarf 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 je nach Anwendungsfall auch Zugriff auf mehrere oder zukünftige Tabellen gewähren. 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, in dem 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.

Schritt 2: 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 Zugangsdaten speichern 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 Public Key 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 die Schlüssel zu einem beliebigen Zeitpunkt rotieren möchten, kann Braze ein neues Schlüsselpaar generieren und den neuen Public Key bereitstellen.

1

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

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

Schritt 3: Neue Synchronisierung erstellen und SQL-Anfrage schreiben

  1. Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Synchronisierungen.
  2. Wählen Sie Datensynchronisierung erstellen.
  3. Wählen Sie eine beliebige Synchronisierung unter Datentyp.
  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 Abfrageergebnis 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 Hilfe von Braze Operator für Ihre SQL-Anfrage zu erhalten.

Schritt 4: Vorschau anzeigen und Anfrage validieren

Wählen Sie Vorschau und Validierung, 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 zur Darstellung des Event-Namens.
- TIME zur Darstellung der Event-Zeit. 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 zur Darstellung der Kauf-Event-Zeit. Falls nicht verfügbar, verwendet CDI UPDATED_AT als Ersatz.
Katalog - ID zur Darstellung des Katalogartikels-Bezeichners.
- UPDATED_AT.
- Mindestens eine zusätzliche Spalte (Katalogfeld) zum Synchronisieren.
Konten - ID zur Darstellung des Kontobezeichners.
- NAME zur Darstellung des Kontonamens.
- 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. Siehe Validierungsverhalten und Fehlerbehebung für hilfreiche Tipps zu Vorschau- und Validierungsfehlern und deren Behebung.

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

Wenn die Validierung erfolgreich ist, fahren Sie mit Weiter: Benachrichtigungen 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 Schritt 4 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 Abfrage Folgendes enthält:

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

Dann gilt:

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

SQL-Sync bearbeiten

Beim Bearbeiten eines bestehenden Syncs:

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

Wenn bereits ein Sync-Lauf ausgeführt wird, werden Ihre Änderungen beim nächsten Lauf 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!