Cloud-Datenaufnahme für Snowflake
Auf dieser Seite finden Sie alles, was Sie benötigen, um Daten mit der Cloud-Datenaufnahme (CDI) von Snowflake mit Braze zu synchronisieren: die Ressourcen, die Sie in Snowflake erstellen müssen, wie Sie die Quelle verbinden und in Braze eine Synchronisierung erstellen, die Quelltabelle für jeden Datentyp sowie die Snowflake-spezifische Fehlerbehebung.
Einrichtung im Überblick
- Richten Sie in Ihrer Snowflake-Instanz die Tabellen oder Ansichten ein, die Sie mit Braze synchronisieren möchten.
- Richten Sie eine Rolle und ein Warehouse für Braze ein.
- Richten Sie eine Snowflake-Nutzer:in für Braze mit einer der unterstützten Authentifizierungsmethoden ein.
- Erstellen Sie im Braze-Dashboard eine neue Snowflake-Quelle und schließen Sie die Authentifizierung in Snowflake ab.
- Erstellen Sie im Braze-Dashboard eine Synchronisierung, validieren Sie die Integration und starten Sie die Synchronisierung.

Der Snowflake-Schnellstartleitfaden enthält Beispielcode und führt Sie durch die erforderlichen Schritte, um mit Snowflake Streams und CDI eine automatisierte Pipeline zur Synchronisierung von Daten mit Braze zu erstellen.
Schritt 1: Quelltabelle einrichten
Mit den Schritten in diesem Abschnitt erstellen Sie eine Tabelle mit einer Spalte PAYLOAD. Wenn Sie Ihre Daten stattdessen im Schritt Data definition strukturieren möchten, können Sie eine bestehende Tabelle oder View verwenden. Überspringen Sie in diesem Fall die Tabellenerstellung und gewähren Sie Braze Lesezugriff auf die Tabellen oder Views, die Sie synchronisieren möchten. Einen Vergleich der Optionen finden Sie unter Option für die Datendefinition auswählen.
Sie können Datenbank, Schema und Tabelle beliebig benennen, die Spaltennamen sollten jedoch den Definitionen in den folgenden Tabs entsprechen. Anstelle einer Tabelle können Sie auch eine View oder eine Materialized View verwenden.

Wenn Sie eine Spalte PAYLOAD verwenden, kann Ihre Quelltabelle oder View auch Spalten enthalten, die in den folgenden Tabs nicht aufgeführt sind (zum Beispiel für Auditing oder Hashing). Braze liest nur die in diesen Tabs beschriebenen Spalten; andere Spalten werden bei Synchronisierungen über die Cloud-Datenaufnahme nicht verwendet.
Wählen Sie den Tab für den Datentyp aus, den Sie synchronisieren möchten.
Nutzerattribute, angepasste Events und Kauf-Events verwenden alle dieselbe Struktur der Quelltabelle. Nur der Inhalt von PAYLOAD unterscheidet sich.
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
--at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
EXTERNAL_ID VARCHAR(16777216),
--if using user alias, both alias_name and alias_label are required
ALIAS_LABEL VARCHAR(16777216),
ALIAS_NAME VARCHAR(16777216),
--braze_id can only be used to update existing users created through the Braze SDK
BRAZE_ID VARCHAR(16777216),
--If you include both email and phone, email is used as the primary identifier
EMAIL VARCHAR(16777216),
PHONE VARCHAR(16777216),
PAYLOAD VARCHAR(16777216) NOT NULL
);
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder ihr hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenz-Zeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.- Spalten für Nutzer-Bezeichner – Ihre Tabelle kann eine oder mehrere Spalten für Nutzer-Bezeichner enthalten. Jede Zeile sollte nur einen Bezeichner enthalten (entweder
external_id, die Kombination ausalias_nameundalias_label,braze_id,emailoderphone). Eine Quelltabelle kann Spalten für einen, zwei, drei, vier oder alle fünf Bezeichnertypen enthalten.EXTERNAL_ID– Hiermit wird die Nutzer:in identifiziert, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendetenexternal_id-Wert übereinstimmen.ALIAS_NAMEundALIAS_LABEL– Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt.alias_namesollte ein eindeutiger Bezeichner sein, undalias_labelgibt den Typ des Alias an. Nutzer:innen können mehrere Aliasse mit unterschiedlichen Labels haben, aber nur einenalias_nameproalias_label.BRAZE_ID– Der Braze-Nutzer-Bezeichner. Er wird vom Braze SDK generiert. Über Cloud Data Ingestion können keine neuen Nutzer:innen mit einer Braze-ID erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.EMAIL– Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird bei Updates das zuletzt aktualisierte Profil priorisiert. Wenn Sie sowohl E-Mail-Adresse als auch Telefonnummer angeben, wird die E-Mail-Adresse als primärer Bezeichner verwendet.PHONE– Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird bei Updates das zuletzt aktualisierte Profil priorisiert.
PAYLOAD– Ein JSON-String mit den Feldern, die Sie mit dem Nutzerprofil in Braze synchronisieren möchten.
Bei Attribut-Synchronisierungen folgt PAYLOAD dem Format des Nutzerattribut-Objekts. Sie können verschachtelte angepasste Attribute, Arrays von Objekten und Abo-Gruppenstatus einschließen. Payload-Beispiele finden Sie unter Tabelleneinrichtung.
Angepasste Events verwenden dieselbe Quelltabelle wie Nutzerattribute. Erstellen Sie die im Tab User attributes gezeigte Tabelle und befüllen Sie PAYLOAD anschließend mit einem Event-Objekt.
Für die Synchronisierung von Events ist ein Event-Name erforderlich. Formatieren Sie das Feld time als ISO-8601-String oder im Format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Ist das Feld time nicht vorhanden, verwendet Braze den Wert der Spalte UPDATED_AT als Event-Zeitpunkt. Andere Felder, darunter app_id und properties, sind optional.
Sie können ein Event pro Zeile synchronisieren.
{
"app_id" : "your-app-id",
"name" : "rented_movie",
"time" : "2013-07-16T19:20:45+01:00",
"properties": {
"movie": "The Sad Egg",
"director": "Alex Smith"
}
}
Kauf-Events verwenden dieselbe Quelltabelle wie Nutzerattribute. Erstellen Sie die im Tab User attributes gezeigte Tabelle und befüllen Sie PAYLOAD anschließend mit einem Kauf-Objekt.
Für die Synchronisierung von Kauf-Events sind product_id, currency und price erforderlich. Formatieren Sie das optionale Feld time als ISO-8601-String oder im Format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Ist das Feld time nicht vorhanden, verwendet Braze den Wert der Spalte UPDATED_AT als Event-Zeitpunkt. Andere Felder, darunter app_id, quantity und properties, sind optional.
Sie können ein Kauf-Event pro Zeile synchronisieren.
{
"app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
"product_id" : "Completed Order",
"currency" : "USD",
"price" : 219.98,
"time" : "2013-07-16T19:20:30+01:00",
"properties" : {
"products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
{ "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
]
}
}
Bevor Sie eine Katalog-Synchronisierung erstellen, legen Sie den Zielkatalog in Braze an. Den vollständigen Katalog-Workflow finden Sie unter Katalogdaten synchronisieren und löschen.
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
--ID of the catalog item to be created or updated
ID VARCHAR(16777216) NOT NULL,
--Catalog fields and values that should be added or updated
PAYLOAD VARCHAR(16777216) NOT NULL,
--The catalog item associated with this ID should be deleted
DELETED BOOLEAN
);
Gewähren Sie der Braze-Rolle Zugriff auf diese Tabelle sowie auf Ihre anderen Quelltabellen:
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC TO ROLE BRAZE_INGESTION_ROLE;
Der Name der Integration muss exakt mit dem Namen des Katalogs übereinstimmen, den Sie in Braze erstellt haben.
Braze empfiehlt, eine View aus Ihren Katalogdaten zu erstellen, damit die Quelltabelle bei jeder Synchronisierung vollständig aktualisiert wird. Wenn Sie beispielsweise eine Tabelle mit Produktdaten (product_catalog_1) mit product_id und drei zusätzlichen Attributen haben, könnten Sie die folgende View synchronisieren:
CREATE VIEW BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC AS
SELECT
CURRENT_TIMESTAMP as UPDATED_AT,
product_id as id,
TO_JSON(
OBJECT_CONSTRUCT (
'attribute_1',
attribute_1,
'attribute_2',
attribute_2,
'attribute_3',
attribute_3)
)as PAYLOAD FROM "product_catalog_1";
Bevor Sie eine Datenobjekt-Synchronisierung erstellen, legen Sie den Datenobjekttyp und seine Felder in Braze an. Den vollständigen Workflow finden Sie unter Datenobjekte synchronisieren.
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
OBJECT_ID VARCHAR(16777216) NOT NULL,
PAYLOAD VARCHAR(16777216) NOT NULL,
--the data object record associated with this OBJECT_ID should be deleted
DELETED BOOLEAN
);
| Feldname | Typ | Modus |
|---|---|---|
UPDATED_AT |
TIMESTAMP_NTZ | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
PAYLOAD |
VARCHAR | REQUIRED |
DELETED |
BOOLEAN | NULLABLE |
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.OBJECT_ID– Der Bezeichner des Datenobjekt-Datensatzes. Dieser muss mit demobject_id-Wert übereinstimmen, der in Braze für diesen Datenobjekttyp verwendet wird.PAYLOAD– Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist.DELETED– Beitruelöscht Braze den Datensatz, anstatt ihn zu aktualisieren. Lassen Sie diesen Wert für Zeilen, die Sie erstellen oder aktualisieren möchten, leer (null) oder setzen Sie ihn auffalse.
Bei Feldnamen innerhalb von PAYLOAD wird zwischen Groß- und Kleinschreibung unterschieden. Ein Schlüssel namens NAME entspricht nicht einem Feld namens name. Wenn die Schreibweise nicht übereinstimmt, meldet die Validierung den Schlüssel als undefiniertes Feld und das Feld, das damit befüllt werden sollte, als fehlend. Benennen Sie Ihre Schlüssel genau so, wie die Felder unter Dateneinstellungen > Datenobjekte angezeigt werden.
Braze erstellt oder ändert während einer Synchronisierung keine Datenobjekttypen. Definieren Sie den Typ und alle seine Felder in Braze, bevor Sie die Synchronisierung erstellen. Wenn Sie später ein Feld hinzufügen möchten, fügen Sie es zuerst dem Typ hinzu und aktualisieren Sie anschließend Ihre Quelltabelle oder Abfrage.
Ein PAYLOAD-Wert für ein Konto mit den Feldern name und team_id sieht beispielsweise so aus:
{"name": "Acme Corp", "team_id": 42}
Gewähren Sie der Braze-Rolle Zugriff auf diese Tabelle:
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC TO ROLE BRAZE_INGESTION_ROLE;
Wählen Sie im Schritt Data definition den Datentyp Data Objects aus und wählen Sie dann Ihren Data object type. Datenobjekt-Synchronisierungen unterstützen Table und SQL.
Verwenden Sie diese Synchronisierung, um Nutzer:innen mit Datenobjekt-Datensätzen zu verknüpfen, etwa um Nutzer:innen den Konten zuzuordnen, zu denen sie gehören. Legen Sie die Beziehung in Braze an, bevor Sie sie synchronisieren.
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_USERS_SYNC (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
OBJECT_ID VARCHAR(16777216) NOT NULL,
--at least one of external_id, alias_name and alias_label, email, or phone is required
EXTERNAL_ID VARCHAR(16777216),
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR(16777216),
ALIAS_LABEL VARCHAR(16777216),
EMAIL VARCHAR(16777216),
PHONE VARCHAR(16777216),
PAYLOAD VARCHAR(16777216),
DELETED BOOLEAN
);
| Feldname | Typ | Modus |
|---|---|---|
UPDATED_AT |
TIMESTAMP_NTZ | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
EXTERNAL_ID |
VARCHAR | NULLABLE |
ALIAS_NAME |
VARCHAR | NULLABLE |
ALIAS_LABEL |
VARCHAR | NULLABLE |
EMAIL |
VARCHAR | NULLABLE |
PHONE |
VARCHAR | NULLABLE |
PAYLOAD |
VARCHAR | NULLABLE |
DELETED |
BOOLEAN | NULLABLE |
Jede Zeile benötigt OBJECT_ID sowie mindestens einen Nutzer-Bezeichner: EXTERNAL_ID, die Kombination aus ALIAS_NAME und ALIAS_LABEL, EMAIL oder PHONE. Verwenden Sie PAYLOAD für Felder, die in der Beziehung selbst definiert sind.

Im Gegensatz zu Synchronisierungen von Nutzerattributen wird BRAZE_ID bei Synchronisierungen von Nutzerbeziehungen nicht unterstützt. Verwenden Sie einen der zuvor aufgeführten Bezeichner.
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.OBJECT_ID– Der Bezeichner des Datenobjekt-Datensatzes. Dieser muss mit demobject_id-Wert übereinstimmen, der in Braze für diesen Datenobjekttyp verwendet wird.PAYLOAD– Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist.DELETED– Beitruelöscht Braze den Datensatz, anstatt ihn zu aktualisieren. Lassen Sie diesen Wert für Zeilen, die Sie erstellen oder aktualisieren möchten, leer (null) oder setzen Sie ihn auffalse.
Bei Feldnamen innerhalb von PAYLOAD wird zwischen Groß- und Kleinschreibung unterschieden. Ein Schlüssel namens NAME entspricht nicht einem Feld namens name. Wenn die Schreibweise nicht übereinstimmt, meldet die Validierung den Schlüssel als undefiniertes Feld und das Feld, das damit befüllt werden sollte, als fehlend. Benennen Sie Ihre Schlüssel genau so, wie die Felder unter Dateneinstellungen > Datenobjekte angezeigt werden.
Braze erstellt oder ändert während einer Synchronisierung keine Datenobjekttypen. Definieren Sie den Typ und alle seine Felder in Braze, bevor Sie die Synchronisierung erstellen. Wenn Sie später ein Feld hinzufügen möchten, fügen Sie es zuerst dem Typ hinzu und aktualisieren Sie anschließend Ihre Quelltabelle oder Abfrage.
Wählen Sie im Schritt Data definition den Datentyp Data Object User Relationships aus und wählen Sie dann einen Relationship name, zum Beispiel User (Account-User).
Verwenden Sie diese Synchronisierung, um Datenobjekt-Datensätze miteinander zu verknüpfen, etwa um Konten ihren übergeordneten Konten zuzuordnen. Legen Sie die Beziehung in Braze an, bevor Sie sie synchronisieren.
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_SUBACCOUNTS_SYNC (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
OBJECT_ID VARCHAR(16777216) NOT NULL,
RELATED_OBJECT_ID VARCHAR(16777216) NOT NULL,
PAYLOAD VARCHAR(16777216),
DELETED BOOLEAN
);
| Feldname | Typ | Modus |
|---|---|---|
UPDATED_AT |
TIMESTAMP_NTZ | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
RELATED_OBJECT_ID |
VARCHAR | REQUIRED |
PAYLOAD |
VARCHAR | NULLABLE |
DELETED |
BOOLEAN | NULLABLE |
OBJECT_ID ist der Datensatz, von dem die Beziehung ausgeht, und RELATED_OBJECT_ID ist der Datensatz, auf den sie verweist. Beide Felder sind in jeder Zeile erforderlich. Verwenden Sie PAYLOAD für Felder, die in der Beziehung selbst definiert sind.
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.OBJECT_ID– Der Bezeichner des Datenobjekt-Datensatzes. Dieser muss mit demobject_id-Wert übereinstimmen, der in Braze für diesen Datenobjekttyp verwendet wird.PAYLOAD– Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist.DELETED– Beitruelöscht Braze den Datensatz, anstatt ihn zu aktualisieren. Lassen Sie diesen Wert für Zeilen, die Sie erstellen oder aktualisieren möchten, leer (null) oder setzen Sie ihn auffalse.
Bei Feldnamen innerhalb von PAYLOAD wird zwischen Groß- und Kleinschreibung unterschieden. Ein Schlüssel namens NAME entspricht nicht einem Feld namens name. Wenn die Schreibweise nicht übereinstimmt, meldet die Validierung den Schlüssel als undefiniertes Feld und das Feld, das damit befüllt werden sollte, als fehlend. Benennen Sie Ihre Schlüssel genau so, wie die Felder unter Dateneinstellungen > Datenobjekte angezeigt werden.
Braze erstellt oder ändert während einer Synchronisierung keine Datenobjekttypen. Definieren Sie den Typ und alle seine Felder in Braze, bevor Sie die Synchronisierung erstellen. Wenn Sie später ein Feld hinzufügen möchten, fügen Sie es zuerst dem Typ hinzu und aktualisieren Sie anschließend Ihre Quelltabelle oder Abfrage.
Wählen Sie im Schritt Data definition den Datentyp Data Object Relationships aus und wählen Sie dann einen Relationship name, zum Beispiel Subaccount (Account-Account).
Canvas-Trigger ermöglichen Zero-Copy-Personalisierung. Informationen zur Einrichtung des Ziel-Canvas und zu wichtigen Hinweisen finden Sie unter Zero-Copy-Personalisierung.
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
--at least one of external_id or alias_name and alias_label is required
EXTERNAL_ID VARCHAR(16777216),
--if using user alias, both alias_name and alias_label are required
ALIAS_LABEL VARCHAR(16777216),
ALIAS_NAME VARCHAR(16777216),
PROPERTIES VARCHAR(16777216)
);
Canvas-Trigger-Synchronisierungen unterscheiden sich in drei Punkten von anderen Synchronisierungen von Nutzerdaten:
- Es werden nur externe IDs oder Nutzer-Aliase als Bezeichner unterstützt. E-Mail-Adressen und Telefonnummern werden als Bezeichner nicht unterstützt.
- Es können nur bestehende Braze-Nutzer:innen synchronisiert werden. Neue Nutzer:innen können nicht angelegt werden.
PROPERTIESersetzt die SpaltePAYLOAD. Dabei handelt es sich um einen JSON-String mit den Feldern, die Sie als Canvas-Entry-Eigenschaften für die Personalisierung verwenden möchten.
Ihre Canvas-Trigger-Tabelle benötigt die folgenden Spalten:
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile aktualisiert oder der Tabelle hinzugefügt wurde. Braze synchronisiert Zeilen, derenUPDATED_ATspäter als der zuletzt synchronisierte Wert liegt. Zeilen mit genau dem Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel haben.- Entweder
EXTERNAL_IDoderALIAS_NAMEundALIAS_LABELals Spalte für den Nutzer-Bezeichner. Diese identifizieren die Nutzer:innen, für die Sie Canvas-Messaging triggern möchten.EXTERNAL_ID– Identifiziert die Nutzer:innen, die in das Canvas eintreten sollen. Dieser Wert sollte mit dem in Braze verwendeten Wertexternal_idübereinstimmen.ALIAS_NAMEundALIAS_LABEL– Diese Spalten erstellen ein Nutzer-Alias-Objekt.alias_namesollte ein eindeutiger Bezeichner sein, undalias_labelgibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einenalias_nameproalias_label.
PROPERTIES– Ein JSON-String mit Feldern, die in Ihrem Canvas als Eigenschaften für die Personalisierung verfügbar sein sollen. Er sollte nutzerspezifische Informationen enthalten.

Eigenschaften sind nicht für jede Zeile oder jede:n Nutzer:in erforderlich. Die Werte der Eigenschaften müssen jedoch ein gültiger JSON-String sein. Geben Sie einen leeren String {} ein, wenn es für die Zeile keine Eigenschaften gibt.
Gewähren Sie der Braze-Rolle Zugriff auf diese Tabelle:
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC TO ROLE BRAZE_INGESTION_ROLE;
Wählen Sie zum Einstieg beim Erstellen einer neuen Synchronisierung den Datentyp Canvas Triggers aus.
Quelltabellen für das Löschen von Nutzer:innen sollten einen oder mehrere Nutzer-Bezeichnertypen und einen UPDATED_AT-Zeitstempel enthalten. Payload-Spalten werden für Daten zum Löschen von Nutzer:innen nicht unterstützt.
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile aktualisiert oder der Tabelle hinzugefügt wurde. Braze synchronisiert Zeilen, derenUPDATED_ATnach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.- Spalten für Nutzer-Bezeichner – Jede Zeile sollte nur einen Bezeichner enthalten: entweder
external_id, die Kombination ausalias_nameundalias_labeloderbraze_id. Eine Quelltabelle kann Spalten für einen, zwei oder alle drei Bezeichnertypen enthalten.EXTERNAL_ID– Dieser Wert identifiziert die Nutzer:in, die Sie aktualisieren möchten. Er sollte dem in Braze verwendetenexternal_id-Wert entsprechen.ALIAS_NAMEundALIAS_LABEL– Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt.alias_namesollte ein eindeutiger Bezeichner sein, undalias_labelgibt den Typ des Alias an. Nutzer:innen können mehrere Aliasse mit unterschiedlichen Labels haben, aber nur einenalias_nameproalias_label.BRAZE_ID– Der Braze-Nutzer-Bezeichner. Er wird vom Braze SDK generiert. Über Cloud Data Ingestion können keine neuen Nutzer:innen mit einer Braze-ID erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.

Fügen Sie Ihrer Tabelle zum Entfernen von Nutzer:innen keine PAYLOAD-Spalte hinzu. Um ein versehentliches, dauerhaftes Entfernen von Nutzer:innen zu verhindern, schlägt eine Synchronisierung fehl, wenn die Quelltabelle eine Payload-Spalte enthält. Alle anderen Spalten sind zulässig, werden von Braze jedoch ignoriert.
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_DELETES (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
--at least one of external_id, alias_name and alias_label, or braze_id is required
EXTERNAL_ID VARCHAR(16777216),
--if using user alias, both alias_name and alias_label are required
ALIAS_LABEL VARCHAR(16777216),
ALIAS_NAME VARCHAR(16777216),
--braze_id can only be used to update existing users created through the Braze SDK
BRAZE_ID VARCHAR(16777216)
);
Setzen Sie auf der Seite Create import sync den Data Type auf Delete Users, damit bei der Ausführung der Integration die richtigen Aktionen durchgeführt werden. Weitere Informationen finden Sie unter Nutzer:innen mit der Cloud-Datenaufnahme löschen.

Das Löschen von Nutzerprofilen kann nicht rückgängig gemacht werden. Die Löschaktion entfernt Nutzer:innen dauerhaft, was zu Abweichungen in Ihren Daten führen kann. Details finden Sie unter Auswirkungen des Löschens von Nutzerprofilen.
Schritt 2: Rolle und Warehouse einrichten
Schritt 2.1: Rolle und Datenbankberechtigungen einrichten
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.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;
Passen Sie die Namen bei Bedarf an, die Berechtigungen sollten jedoch dem vorangegangenen Beispiel entsprechen.
Schritt 2.2: Warehouse einrichten und der Braze-Rolle Zugriff gewähren
CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;
GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Für das Warehouse muss das Flag auto-resume aktiviert sein. Andernfalls gewähren Sie Braze zusätzliche OPERATE-Berechtigungen für das Warehouse, damit Braze es beim Ausführen der Abfrage aktivieren kann.
Schritt 2.3: Braze-IPs in der Snowflake-Netzwerkrichtlinie zulassen (optional)
Je nach Konfiguration Ihres Snowflake-Kontos müssen Sie möglicherweise die folgenden IP-Adressen in Ihrer Snowflake-Netzwerkrichtlinie zulassen. Weitere Informationen dazu finden Sie in der entsprechenden Snowflake-Dokumentation zum Ändern einer Netzwerkrichtlinie.
Für die Instanzen US-01, US-02, US-03, US-04, US-05, US-06, US-07 sind dies die relevanten IP-Adressen:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Für die Instanz US-08 sind dies die relevanten IP-Adressen:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Für die Instanz US-10 sind dies die relevanten IP-Adressen:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Für die Instanzen EU-01 und EU-02 sind dies die relevanten IP-Adressen:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Für die Instanz AU-01 sind dies die relevanten IP-Adressen:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Für die Instanz ID-01 sind dies die relevanten IP-Adressen:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Für die Instanz JP-01 sind dies die relevanten IP-Adressen:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Für die Instanz KR-01 sind dies die relevanten IP-Adressen:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Schritt 3: Authentifizierung einrichten
Braze verbindet sich mit Snowflake als Snowflake-Nutzer:in mit der Rolle aus Schritt 2. Richten Sie die Nutzer:in mit einer der folgenden Authentifizierungsmethoden ein:
| Methode | So authentifiziert Braze | Was Sie in Braze eingeben |
|---|---|---|
| Key pair authentication | Braze generates an RSA key pair and connects as a Snowflake user that has the public key assigned. | Username and Role |
Key pair authentication
Bei der Authentifizierung per Schlüsselpaar generiert Braze ein RSA-Schlüsselpaar, wenn Sie Ihre Zugangsdaten im Braze-Dashboard speichern. Den Public Key weisen Sie einem Snowflake-Nutzerkonto zu, über das sich Braze verbindet.
Nutzer:in einrichten
Erstellen Sie eine:n Nutzer:in für Braze und weisen Sie ihr:ihm die von Ihnen erstellte Rolle zu:
CREATE USER BRAZE_INGESTION_USER;
GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Wenn Sie verschiedene Workspaces mit demselben Snowflake-Konto verbinden, müssen Sie für jeden Braze-Workspace, in dem Sie eine Integration erstellen, eine:n eindeutige:n Nutzer:in anlegen. Innerhalb eines Workspace können Sie dieselbe:n Nutzer:in für mehrere Integrationen wiederverwenden. Die Erstellung einer Integration schlägt jedoch fehl, wenn ein:e Nutzer:in desselben Snowflake-Kontos in mehreren Workspaces verwendet wird.
Public Key zu Nutzer:in hinzufügen
Führen Sie diesen Schritt aus, nachdem Sie Ihre Zugangsdaten im Braze-Dashboard eingegeben und Zugangsdaten speichern ausgewählt haben. Braze generiert das Schlüsselpaar und zeigt den Public Key an. Fügen Sie den Public Key dem:der Nutzer:in hinzu, den:die Sie für Braze erstellt haben:
ALTER USER BRAZE_INGESTION_USER SET RSA_PUBLIC_KEY='MIIBIjANBgkqhkiG9w0BA...';
Für die Zuweisung des Schlüssels benötigen Sie in Snowflake mindestens SECURITYADMIN-Zugriff. Weitere Informationen finden Sie in der Snowflake-Dokumentation.
Um die Schlüssel zu rotieren, gehen Sie in Cloud Data Ingestion zu Datenzugriffsverwaltung und wählen Sie für das Konto Neuen Schlüssel generieren aus. Weisen Sie anschließend den neuen Public Key dem:der Nutzer:in zu. Wenn Sie dieselbe:n Nutzer:in und Rolle für mehrere Integrationen wiederverwenden, müssen Sie den Public Key nicht erneut hinzufügen.
Schritt 4: Eine neue Quelle im Braze-Dashboard erstellen
Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud-Datenaufnahme > Quellen, wählen Sie Datenquelle hinzufügen und dann Snowflake aus.
Schritt 4.1: Snowflake-Verbindungsinformationen hinzufügen
Wählen Sie einen Namen für Ihre Quelle, geben Sie Ihre Snowflake-Zugangsdaten und -Konfiguration ein und fahren Sie dann mit dem nächsten Schritt fort. Wählen Sie die Authentifizierungsmethode aus, die Sie in Schritt 3 eingerichtet haben, und geben Sie die zugehörigen Zugangsdaten ein:
- Key pair authentication: Username and Role
Bevor Sie fortfahren, überprüfen Sie den Wert, den Sie unter Snowflake Account Locator eingeben.
Geben Sie im Feld Snowflake Account Locator Ihren Snowflake-Konto-Bezeichner ein. Geben Sie nur den Wert des Konto-Bezeichners ein, zum Beispiel myorganization-myaccount. Fügen Sie weder https:// noch .snowflakecomputing.com oder einen Pfad hinzu.
So finden Sie Ihren Snowflake-Konto-Bezeichner:
- Wählen Sie in Snowsight Ihr Kontomenü aus.
- Wählen Sie View account details aus.
- Kopieren Sie den Wert unter Account identifier.
- Wenn Sie den Wert aus einer Snowflake-URL kopieren, verwenden Sie nur den Teil vor
.snowflakecomputing.com.
Schritt 4.2: Authentifizierung in Snowflake abschließen
Nachdem Sie Ihre Zugangsdaten und Konfiguration eingegeben haben, wählen Sie Zugangsdaten speichern aus. Bei der Schlüsselpaar-Authentifizierung generiert Braze ein RSA-Schlüsselpaar und zeigt den Public Key an. Kehren Sie zu Snowflake zurück und fügen Sie den Public Key dem Nutzer bzw. der Nutzerin hinzu, den bzw. die Sie für Braze erstellt haben.
Schritt 5: Erstellen Sie eine neue Synchronisierung im Braze-Dashboard
Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Synchronisierungen und wählen Sie Datensynchronisierung erstellen aus.
Synchronisierungsdetails konfigurieren und Daten definieren
Geben Sie einen Namen für Ihre Synchronisierung ein. Wählen Sie dann eine aktive Quelle und einen Synchronisierungsdatentyp aus. Wählen Sie anschließend einen Synchronisierungsmodus aus und definieren Sie Ihre Daten. Wählen Sie dann Vorschau und Validierung aus.
Nach erfolgreicher Validierung erscheint eine Vorschau der Daten. Wählen Sie Weiter: Benachrichtigungen, um fortzufahren. Schlägt die Validierung fehl, erscheint eine Fehlermeldung, die Ihnen bei der Fehlerbehebung hilft.

Sie müssen eine Synchronisierung erfolgreich validieren, bevor Sie mit den nächsten Schritten fortfahren können. Wenn Sie die Seite zur Erstellung der Synchronisierung schließen müssen, wählen Sie Als Entwurf speichern aus, um Ihren Arbeitsstand zu sichern.
Benachrichtigungseinstellungen hinzufügen
Geben Sie eine oder mehrere Kontakt-E-Mail-Adressen für Benachrichtigungen über Synchronisierungsfehler ein. Braze verwendet diese Kontaktinformationen, um Benachrichtigungen über Integrationsfehler zu versenden, etwa bei einem unerwarteten Verlust des Tabellenzugriffs.
Kontakt-E-Mail-Adressen erhalten nur Benachrichtigungen über globale Fehler oder Fehler auf Synchronisierungsebene, etwa fehlende Tabellen, fehlende Berechtigungen und Ähnliches. Probleme auf Zeilenebene werden nicht gemeldet. Globale Fehler weisen auf kritische Probleme mit der Verbindung hin, die die Ausführung von Synchronisierungen verhindern.
Zu solchen Problemen gehören unter anderem:
- Verbindungsprobleme
- Fehlende Ressourcen
- Probleme mit Berechtigungen
- Kein freier Speicherplatz in der Katalogstufe (nur Katalog-Synchronisierungen)
Zeitplan festlegen
Konfigurieren Sie Ihre Synchronisierung abschließend als einmalig oder wiederkehrend.
Einmalige Synchronisierungen werden nur ausgeführt, wenn Sie im Dashboard Jetzt synchronisieren auswählen oder den Endpunkt Synchronisierung triggern aufrufen.
Wiederkehrende Synchronisierungen lassen sich in Intervallen von 5 Minuten bis zu einem Monat ausführen. Standardmäßig beträgt das kürzeste Intervall, das Sie im Dashboard festlegen können, 15 Minuten. So lassen sich die Rechenkosten Ihres Data Warehouse und das Anfragevolumen besser steuern. Wenn Sie in Abständen von nur 5 Minuten synchronisieren möchten, wenden Sie sich an den Braze-Support oder Ihren Customer-Success-Manager. Braze plant wiederkehrende Synchronisierungen in UTC.

Sie müssen eine Integration erfolgreich validieren, bevor sie vom Status „Entwurf“ in den Status „Aktiv“ wechseln kann. Wenn Sie die Erstellungsseite schließen, wird Ihre Integration gespeichert. Sie können die Detailseite dann erneut aufrufen, um Änderungen vorzunehmen und die Integration zu validieren.
Synchronisierung ausführen
Nach der Aktivierung wird Ihre Synchronisierung nach dem Zeitplan ausgeführt, den Sie bei der Einrichtung konfiguriert haben. Wenn Sie die Synchronisierung außerhalb des Zeitplans ausführen oder die neuesten Daten abrufen möchten, wählen Sie Jetzt synchronisieren. Diese Ausführung hat keinen Einfluss auf zukünftige, regelmäßig geplante Synchronisierungen. Um eine Synchronisierung automatisch zu starten, sobald sich Ihre Daten aktualisieren, rufen Sie den Endpunkt Synchronisierung triggern aus Ihrer Pipeline auf.
Zusätzliche Integrationen oder Nutzer:innen einrichten (optional)
Sie können mehrere Integrationen mit Braze einrichten. Wenn Sie zusätzliche Synchronisierungen erstellen, können Sie vorhandene Zugangsdaten wiederverwenden, sofern Sie eine Verbindung zum Snowflake-Konto herstellen.
Wenn Sie denselben Nutzer und dieselbe Rolle für mehrere Integrationen wiederverwenden, müssen Sie den Public Key nicht erneut hinzufügen.
Snowflake als verbundene Quelle verwenden
Eine verbundene Quelle ist eine Zero-Copy-Alternative zur Synchronisierung von Daten in Braze. Braze fragt Ihre Snowflake-Instanz direkt ab, um CDI-Segmente zu erstellen, ohne die zugrunde liegenden Daten zu kopieren. Informationen zu Konzepten, Einschränkungen und Kostenauswirkungen finden Sie unter Verbundene Quellen.
Schritt 1: Eine Rolle erstellen und Berechtigungen erteilen
Erstellen Sie eine Rolle, die Ihre verbundene Quelle verwenden soll. Mit dieser Rolle wird die Liste der Tabellen generiert, die in Ihren CDI-Segmenterweiterungen verfügbar sind. Außerdem werden damit Quelltabellen abgefragt, um neue Segmente zu erstellen. Nachdem die verbundene Quelle erstellt wurde, ermittelt Braze die Namen und Beschreibungen aller Tabellen, die Nutzer:innen im Quellschema zur Verfügung stehen.
Sie können entweder Zugriff auf alle Tabellen in einem Schema gewähren oder nur für bestimmte Tabellen Berechtigungen erteilen. Alle Tabellen, auf die die Braze-Rolle Zugriff hat, können in der CDI-Segmenterweiterung abgefragt werden.
Die Berechtigung create table ist erforderlich, damit Braze eine Tabelle mit den Abfrageergebnissen Ihrer CDI-Segmenterweiterung erstellen kann, bevor das Segment in Braze aktualisiert wird. Braze erstellt pro Segment eine temporäre Tabelle, die nur so lange bestehen bleibt, wie Braze das Segment aktualisiert.
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 CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;
Die Einrichtung des Warehouse entspricht Schritt 2.2, die Einrichtung der Netzwerkrichtlinie entspricht Schritt 2.3. Richten Sie die Nutzer:in, mit der sich Braze verbindet, mit einer der Methoden aus Schritt 3: Authentifizierung einrichten ein.
Schritt 2: Die verbundene Quelle in Braze erstellen
Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Verbundene Quellen, wählen Sie Datenquelle hinzufügen und anschließend Snowflake aus.
Geben Sie unter Quelle einrichten Folgendes ein:
- Zugangsdaten: Account Locator und die Felder für Ihre Authentifizierungsmethode. Geben Sie Folgendes ein: Username and Role.
- Konfiguration: Warehouse, Datenbank und Schema
Wenn Sie bei der Schlüsselpaar-Authentifizierung neue Snowflake-Zugangsdaten erstellen, wählen Sie Zugangsdaten speichern und RSA-Schlüssel generieren aus, bevor Sie die Verbindung testen.
Wählen Sie einen Namen für die verbundene Quelle. Dieser Name wird in der Liste der verfügbaren Quellen angezeigt, wenn Sie eine neue CDI-Segmenterweiterung erstellen.
Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht alle Abfragen, die die maximale Laufzeit überschreiten, automatisch ab. Die maximal zulässige Laufzeit beträgt 60 Minuten. Eine kürzere Laufzeit senkt die Kosten, die in Ihrem Snowflake-Konto anfallen. Diese Einstellung gilt für alle Abfragen, die über diese Quelle ausgeführt werden, einschließlich Synchronisierungen und CDI-Segmenterweiterungen, die diese Quelle verwenden.
Notieren Sie sich bei der Schlüsselpaar-Authentifizierung den RSA Public Key im Schritt Verbindung testen. Sie benötigen ihn, um die Integration in Snowflake abzuschließen.
Schritt 3: Die Snowflake-Konfiguration abschließen
Fügen Sie bei der Schlüsselpaar-Authentifizierung den Public Key, den Sie sich im vorherigen Schritt notiert haben, Ihrer Nutzer:in in Snowflake hinzu, wie unter Public Key zur Nutzer:in hinzufügen beschrieben. Dadurch kann sich Braze mit Snowflake verbinden.
Nachdem Sie die Authentifizierung in Snowflake abgeschlossen haben, wählen Sie in Braze Verbindung testen und anschließend Fertig aus. Ihre verbundene Quelle ist jetzt erstellt und kann in CDI-Segmenterweiterungen verwendet werden.
Sie können mehrere verbundene Quellen mit Braze einrichten, allerdings sollte jede Quelle so konfiguriert sein, dass sie sich mit einem anderen Schema verbindet. Wenn Sie zusätzliche Verbindungen erstellen, können Sie vorhandene Zugangsdaten wiederverwenden, sofern Sie sich mit demselben Snowflake-Konto verbinden. Wenn Sie dieselbe Nutzer:in und Rolle für mehrere Integrationen verwenden, müssen Sie den Public Key nicht erneut hinzufügen.
Payload aus vorhandenen Spalten formatieren
Wenn Sie intern jedes Attribut lieber in einer eigenen Spalte speichern, müssen Sie diese Spalten in einen JSON-String umwandeln, um die Synchronisierung mit Braze zu befüllen. Verwenden Sie diese Abfrage in Snowflake, um Quellspalten in CDI-Felder zu formatieren.
CREATE TABLE "EXAMPLE_USER_DATA"
(attribute_1 string,
attribute_2 string,
attribute_3 number,
my_user_id string);
SELECT
CURRENT_TIMESTAMP as UPDATED_AT,
my_user_id as EXTERNAL_ID,
TO_JSON(
OBJECT_CONSTRUCT (
'attribute_1',
attribute_1,
'attribute_2',
attribute_2,
'yet_another_attribute',
attribute_3)
)as PAYLOAD FROM "EXAMPLE_USER_DATA";
Wenn Sie ein Attribut vollständig entfernen möchten, anstatt es auf null zu setzen, verwenden Sie TO_JSON(OBJECT_CONSTRUCT_KEEP_NULL(...)).
Weitere Hinweise zur Optimierung finden Sie unter Best Practices für die Cloud-Datenaufnahme.
Fehlerbehebung
„Verbindung testen“ läuft langsam
„Verbindung testen“ wird in Ihrem Data Warehouse ausgeführt. Eine höhere Warehouse-Kapazität kann daher die Geschwindigkeit verbessern. Eine serverlose SQL-Instanz verkürzt die Aufwärmzeit und erhöht den Abfragedurchsatz, kann aber etwas höhere Integrationskosten verursachen.
Fehler beim Verbinden mit der Snowflake-Instanz: Incoming request with IP is not allowed to access Snowflake
Fügen Sie die offiziellen Braze-IPs zu Ihrer IP-Allowlist hinzu. Weitere Informationen finden Sie unter Braze-IPs in der Snowflake-Netzwerkrichtlinie zulassen.
Fehler beim Ausführen von SQL aufgrund der Kundenkonfiguration: 002003 (42S02): SQL compilation error: does not exist or not authorized
Wenn die Tabelle nicht existiert, erstellen Sie sie. Wenn die Tabelle existiert, überprüfen Sie, ob der:die Nutzer:in und die Rolle über Leseberechtigungen für die Tabelle verfügen.
Schema konnte nicht verwendet werden
Wenn Sie diesen Fehler erhalten, gewähren Sie dem angegebenen Nutzer bzw. der angegebenen Rolle Zugriff auf dieses Schema.
Rolle konnte nicht verwendet werden
Wenn Sie diesen Fehler erhalten, erlauben Sie dem:der Nutzer:in, die angegebene Rolle zu verwenden.
Nutzerzugriff deaktiviert
Wenn Sie diesen Fehler erhalten, gewähren Sie dem:der Nutzer:in Zugriff auf Ihr Snowflake-Konto.
Fehler beim Verbinden mit der Snowflake-Instanz mit aktuellem und altem Schlüssel
Wenn Sie diesen Fehler erhalten, stellen Sie sicher, dass der:die Nutzer:in den aktuellen Public Key verwendet, der in Ihrem Braze-Dashboard angezeigt wird. Informationen zur Rotation von Schlüsseln finden Sie unter Public Key zum Nutzer hinzufügen.
Wo SQL-Prüfungen ausgeführt werden
Führen Sie Validierungsprüfungen direkt im Snowflake-SQL-Editor aus, und zwar für dieselbe Tabelle oder View, die Ihre CDI-Integration verwendet. Gehen Sie zu Projects > Worksheets. Weitere Informationen finden Sie unter Snowflake Worksheets.
Verwandte Seiten
- Tabellen-Setup für erforderliche Spalten und die Formatierung von Payloads
- Best Practices für die Planung von Synchronisierungen und eine effiziente Nutzung von Datenpunkten
- Synchronisierungsprotokolle und Beobachtbarkeit für das Monitoring von Synchronisierungsläufen
- FAQ für häufige Fragen zu allen Quellen