Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Data Warehouse-Speicherintegrationen

Auf dieser Seite erfahren Sie, wie Sie Braze Cloud-Datenaufnahme (CDI) verwenden, um relevante Daten mit Ihrer Snowflake-, Redshift-, BigQuery- und Databricks-Integration zu synchronisieren.

Einrichten von Data Warehouse-Integrationen

Cloud-Datenaufnahme-Integrationen erfordern einige Einstellungen auf der Seite von Braze und in Ihrer Data Warehouse-Instanz. Folgen Sie diesen Schritten, um die Integration einzurichten:

Richten Sie in Ihrer Snowflake-Instanz die Tabellen oder Ansichten ein, die Sie mit Braze synchronisieren möchten.
Erstellen Sie eine neue Snowflake-Quelle im Braze-Dashboard.
Rufen Sie den im Braze-Dashboard bereitgestellten Public Key ab und fügen Sie ihn zur Authentifizierung an die Snowflake-Nutzer:innen an.
Erstellen Sie eine Synchronisierung im Braze-Dashboard, testen Sie die Integration und starten Sie die Synchronisierung.

Tipp

Die Snowflake-Schnellstartanleitung enthält Beispielcode und führt Sie durch die erforderlichen Schritte zur Erstellung einer automatisierten Pipeline mit Snowflake Streams und CDI zur Synchronisierung von Daten zu Braze.

Stellen Sie sicher, dass Braze Zugriff auf die Redshift-Tabellen hat, die Sie synchronisieren möchten. Braze stellt die Verbindung zu Redshift über das Internet her.
Richten Sie in Ihrer Redshift-Instanz die Tabellen oder Ansichten ein, die Sie mit Braze synchronisieren möchten.
Erstellen Sie eine neue Quelle und Synchronisierung im Braze-Dashboard.
Testen Sie die Integration und starten Sie die Synchronisierung.

Hinweis

Die pro Synchronisierung verarbeiteten Zeilen hängen von der Performance Ihres Warehouse, der Netzwerklatenz und der Menge neuer Daten ab, die der Synchronisierungsabfrage entsprechen. Verwenden Sie den Sync-Verlauf der Integration im Dashboard, um die Dauer und Zeilenanzahl der letzten Durchläufe einzusehen.

Erstellen Sie ein Dienstkonto und erlauben Sie den Zugriff auf das/die BigQuery-Projekt(e) und den/die Datensatz/Datensätze, die die zu synchronisierenden Daten enthalten.
Richten Sie in Ihrem BigQuery-Konto die Tabellen oder Ansichten ein, die Sie mit Braze synchronisieren möchten.
Erstellen Sie eine neue Quelle und Synchronisierung im Braze-Dashboard.
Testen Sie die Integration und starten Sie die Synchronisierung.

Erstellen Sie ein Dienstkonto und erlauben Sie den Zugriff auf das/die Databricks-Projekt(e) und den/die Datensatz/Datensätze, die die zu synchronisierenden Daten enthalten.
Richten Sie in Ihrem Databricks-Konto die Tabellen oder Ansichten ein, die Sie mit Braze synchronisieren möchten.
Erstellen Sie eine neue Quelle und Synchronisierung im Braze-Dashboard.
Testen Sie die Integration und starten Sie die Synchronisierung.

Wichtig

Wenn Braze eine Verbindung zu Classic- und Pro SQL-Instanzen herstellt, kann es zu einer Aufwärmzeit von zwei bis fünf Minuten kommen, was zu Verzögerungen beim Verbindungsaufbau und beim Testen sowie zu Beginn geplanter Synchronisierungen führen kann. Die Verwendung einer serverlosen SQL-Instanz minimiert die Aufwärmzeit und verbessert den Abfragedurchsatz, kann aber zu etwas höheren Integrationskosten führen.

Erstellen Sie einen Dienstprinzipal und gewähren Sie Zugriff auf Fabric-APIs.
Richten Sie einen gemeinsamen Workspace ein und gewähren Sie dem Dienstprinzipal Zugriff darauf.
Richten Sie im gemeinsamen Fabric-Workspace die Tabellen oder Ansichten ein, die Sie mit Braze synchronisieren möchten.
Erstellen Sie eine neue Quelle und Synchronisierung im Braze-Dashboard.
Testen Sie die Integration und starten Sie die Synchronisierung.

1. Schritt: Tabellen oder Ansichten einrichten

Bevor Sie beginnen, lesen Sie Tabelleneinrichtung für Cloud-Datenaufnahme, um die Anforderungen an Quelltabellen im Vergleich zu den Formatierungsanforderungen für PAYLOAD zu verstehen.

Hinweis

Ihre Quelltabelle oder Ansicht kann Spalten enthalten, die nicht für Ihr Warehouse in den folgenden Tabs aufgeführt sind (z. B. für Auditing oder Hashing). Braze liest nur die in diesen Tabs beschriebenen Spalten; andere Spalten werden bei Cloud-Datenaufnahme-Synchronisierungen nicht verwendet.

Schritt 1.1: Tabelle einrichten

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
);

Sie können die Datenbank, das Schema und die Tabelle nach Belieben benennen, aber die Spaltennamen sollten mit der vorherigen Definition übereinstimmen.

UPDATED_AT – Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denen UPDATED_AT nach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt demselben Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen.
Nutzer:innen-Bezeichner-Spalten – Ihre Tabelle kann eine oder mehrere Nutzer:innen-Bezeichner-Spalten enthalten. Jede Zeile sollte nur einen Bezeichner enthalten (entweder external_id, die Kombination aus alias_name und alias_label, braze_id, email oder phone). Eine Quelltabelle kann Spalten für einen, zwei, drei, vier oder alle fünf Bezeichner-Typen enthalten.
- EXTERNAL_ID – Identifiziert die Nutzerin oder den Nutzer, die/den Sie aktualisieren möchten. Dieser Wert sollte dem in Braze verwendeten Wert external_id entsprechen.
- ALIAS_NAME und ALIAS_LABEL – Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt die Art des Alias an. Nutzer:innen können mehrere Aliasnamen mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Die Braze-Nutzer:innen-Kennung. Diese wird vom Braze SDK generiert, und neue Nutzer:innen können nicht mit einer Braze-ID über Cloud-Datenaufnahme erstellt werden. Um neue Nutzer:innen anzulegen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben E-Mail-Adresse vorhanden sind, wird das zuletzt aktualisierte Profil für Updates 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 Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben Telefonnummer vorhanden sind, wird das zuletzt aktualisierte Profil für Updates priorisiert.
PAYLOAD – Ein JSON-String mit den Feldern, die Sie mit der Nutzerin oder dem Nutzer in Braze synchronisieren möchten.

Schritt 1.2: 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;

Aktualisieren Sie die Namen nach Bedarf, aber die Berechtigungen sollten mit dem vorangegangenen Beispiel übereinstimmen.

Schritt 1.3: 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;

Hinweis

Das Warehouse muss die Option zur automatischen Wiederaufnahme aktiviert haben. Wenn dies nicht der Fall ist, gewähren Sie Braze zusätzliche OPERATE-Privilegien für das Warehouse, damit Braze es einschalten kann, wenn die Abfrage ausgeführt wird.

Schritt 1.4: Nutzer:in einrichten

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Nach diesem Schritt teilen Sie die Verbindungsinformationen mit Braze und erhalten einen Public Key, den Sie an die Nutzerin oder den Nutzer anhängen können.

Hinweis

Wenn Sie verschiedene Workspaces mit demselben Snowflake-Konto verbinden, müssen Sie für jeden Braze-Workspace, in dem Sie eine Integration erstellen, eine eigene Nutzerin oder einen eigenen Nutzer anlegen. Innerhalb eines Workspace können Sie dieselbe Nutzerin oder denselben Nutzer für verschiedene Integrationen wiederverwenden. Die Erstellung einer Integration schlägt jedoch fehl, wenn eine Nutzerin oder ein Nutzer mit demselben Snowflake-Konto in verschiedenen Workspaces dupliziert wird.

Schritt 1.5: 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.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Für die Instanz US-08 sind dies die relevanten IP-Adressen:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Für die Instanz US-10 sind dies die relevanten IP-Adressen:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Für die Instanzen EU-01 und EU-02 sind dies die relevanten IP-Adressen:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Für die Instanz AU-01 sind dies die relevanten IP-Adressen:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Für die Instanz ID-01 sind dies die relevanten IP-Adressen:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Für die Instanz JP-01 sind dies die relevanten IP-Adressen:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Für die Instanz KR-01 sind dies die relevanten IP-Adressen:

43.200.215.4
52.79.67.175
52.79.113.60

Schritt 1.1: Tabelle einrichten

Optional können Sie eine neue Datenbank und ein neues Schema für Ihre Quelltabelle einrichten:

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Erstellen Sie eine Tabelle (oder Ansicht) für Ihre CDI-Integration:

CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar,
   --If you include both email and phone, email is used as the primary identifier
   email varchar,
   phone varchar,
   payload varchar(max)
)

Sie können die Datenbank, das Schema und die Tabelle nach Belieben benennen, aber die Spaltennamen sollten mit der vorherigen Definition übereinstimmen.

UPDATED_AT – Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denen UPDATED_AT nach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt demselben Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen.
Nutzer:innen-Bezeichner-Spalten – Ihre Tabelle kann eine oder mehrere Nutzer:innen-Bezeichner-Spalten enthalten. Jede Zeile sollte nur einen Bezeichner enthalten (entweder external_id, die Kombination aus alias_name und alias_label, braze_id, email oder phone). Eine Quelltabelle kann Spalten für einen, zwei, drei, vier oder alle fünf Bezeichner-Typen enthalten.
- EXTERNAL_ID – Identifiziert die Nutzerin oder den Nutzer, die/den Sie aktualisieren möchten. Dieser Wert sollte dem in Braze verwendeten Wert external_id entsprechen.
- ALIAS_NAME und ALIAS_LABEL – Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt die Art des Alias an. Nutzer:innen können mehrere Aliasnamen mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Die Braze-Nutzer:innen-Kennung. Diese wird vom Braze SDK generiert, und neue Nutzer:innen können nicht mit einer Braze-ID über Cloud-Datenaufnahme erstellt werden. Um neue Nutzer:innen anzulegen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben E-Mail-Adresse vorhanden sind, wird das zuletzt aktualisierte Profil für Updates 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 Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben Telefonnummer vorhanden sind, wird das zuletzt aktualisierte Profil für Updates priorisiert.
PAYLOAD – Ein JSON-String mit den Feldern, die Sie mit der Nutzerin oder dem Nutzer in Braze synchronisieren möchten.

Schritt 1.2: Nutzer:in anlegen und Berechtigungen erteilen

CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

Dies sind die erforderlichen Mindestberechtigungen für diese Nutzerin oder diesen Nutzer. Wenn Sie mehrere CDI-Integrationen erstellen, möchten Sie möglicherweise Berechtigungen für ein Schema erteilen oder Berechtigungen über eine Gruppe verwalten.

Schritt 1.3: Zugriff auf Braze-IPs zulassen

Wenn Sie eine Firewall oder andere Netzwerkrichtlinien haben, müssen Sie Braze Netzwerkzugriff auf Ihre Redshift-Instanz gewähren. Ein Beispiel für den Redshift-URL-Endpunkt ist „example-cluster.ap-northeast-2.redshift.amazonaws.com“.

Einige wichtige Hinweise:

Möglicherweise müssen Sie auch Ihre Sicherheitsgruppen ändern, damit Braze auf Ihre Daten in Redshift zugreifen kann.
Stellen Sie sicher, dass Sie eingehenden Datenverkehr auf den IPs in der Tabelle und auf dem Port, der für die Abfrage Ihres Redshift-Clusters verwendet wird (Standard ist 5439), ausdrücklich zulassen. Sie sollten die Redshift-TCP-Verbindung an diesem Port ausdrücklich zulassen, auch wenn die Regeln für eingehende Verbindungen auf „Alle zulassen“ eingestellt sind.
Der Endpunkt für den Redshift-Cluster muss öffentlich zugänglich sein, damit Braze eine Verbindung zu Ihrem Cluster herstellen kann.
- Wenn Sie nicht möchten, dass Ihr Redshift-Cluster öffentlich zugänglich ist, können Sie eine VPC und eine EC2-Instanz einrichten, die einen SSH-Tunnel für den Zugriff auf die Redshift-Daten verwenden. Weitere Informationen finden Sie in diesem Beitrag im AWS Knowledge Center.

Erlauben Sie den Zugriff von den folgenden IPs, die der Region Ihres Braze-Dashboards entsprechen.

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.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Für die Instanz US-08 sind dies die relevanten IP-Adressen:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Für die Instanz US-10 sind dies die relevanten IP-Adressen:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Für die Instanzen EU-01 und EU-02 sind dies die relevanten IP-Adressen:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Für die Instanz AU-01 sind dies die relevanten IP-Adressen:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Für die Instanz ID-01 sind dies die relevanten IP-Adressen:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Für die Instanz JP-01 sind dies die relevanten IP-Adressen:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Für die Instanz KR-01 sind dies die relevanten IP-Adressen:

43.200.215.4
52.79.67.175
52.79.113.60

Schritt 1.1: Tabelle einrichten

Optional können Sie ein neues Projekt oder einen neuen Datensatz einrichten, der Ihre Quelltabelle enthält.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Erstellen Sie eine oder mehrere Tabellen für Ihre CDI-Integration mit den folgenden Feldern:

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp,
  --At least one of external_id, alias_name and alias_label, or braze_id is required
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, email is used as the primary identifier
  email STRING,
  phone STRING,
  payload JSON
);

Feldname	Typ	Modus
`UPDATED_AT`	TIMESTAMP	REQUIRED
`PAYLOAD`	JSON	REQUIRED
`EXTERNAL_ID`	STRING	NULLABLE
`ALIAS_NAME`	STRING	NULLABLE
`ALIAS_LABEL`	STRING	NULLABLE
`BRAZE_ID`	STRING	NULLABLE
`EMAIL`	STRING	NULLABLE
`PHONE`	STRING	NULLABLE

Sie können das Projekt, den Datensatz und die Tabelle nach Belieben benennen, aber die Spaltennamen sollten mit der vorherigen Definition übereinstimmen.

UPDATED_AT – Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denen UPDATED_AT nach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt demselben Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen.
Nutzer:innen-Bezeichner-Spalten – Ihre Tabelle kann eine oder mehrere Nutzer:innen-Bezeichner-Spalten enthalten. Jede Zeile sollte nur einen Bezeichner enthalten (entweder external_id, die Kombination aus alias_name und alias_label, braze_id, email oder phone). Eine Quelltabelle kann Spalten für einen, zwei, drei, vier oder alle fünf Bezeichner-Typen enthalten.
- EXTERNAL_ID – Identifiziert die Nutzerin oder den Nutzer, die/den Sie aktualisieren möchten. Dieser Wert sollte dem in Braze verwendeten Wert external_id entsprechen.
- ALIAS_NAME und ALIAS_LABEL – Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt die Art des Alias an. Nutzer:innen können mehrere Aliasnamen mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Die Braze-Nutzer:innen-Kennung. Diese wird vom Braze SDK generiert, und neue Nutzer:innen können nicht mit einer Braze-ID über Cloud-Datenaufnahme erstellt werden. Um neue Nutzer:innen anzulegen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben E-Mail-Adresse vorhanden sind, wird das zuletzt aktualisierte Profil für Updates 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 Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben Telefonnummer vorhanden sind, wird das zuletzt aktualisierte Profil für Updates priorisiert.
PAYLOAD – Ein JSON-String mit den Feldern, die Sie mit der Nutzerin oder dem Nutzer in Braze synchronisieren möchten.

Wichtig

BigQuery-Partitionierung

CDI unterstützt Partitionen für BigQuery. Wenn Sie nach einer Funktion von UPDATED_AT partitionieren (beispielsweise nach Tages-, Wochen- oder Stundenauflösung, abhängig von der Größe Ihres Datensatzes), kann BigQuery die zu scannenden Daten reduzieren. Dies verbessert die Performance und Effizienz bei sehr großen Tabellen.

Partitionieren Sie nicht nach anderen Feldern. Testen Sie verschiedene Konfigurationen, um die optimale Einstellung für Ihre spezifischen Daten zu ermitteln.

Alle CDI-Abfragen filtern nach UPDATED_AT, jedoch kann sich dieses Verhalten ändern. Entwerfen Sie Ihr Tabellenschema so, dass Abfragen diese Klausel nicht zwingend enthalten müssen.

Weitere Informationen finden Sie in der Dokumentation zur Partitionierung in BigQuery.

Schritt 1.2: Dienstkonto erstellen und Berechtigungen erteilen

Erstellen Sie ein Dienstkonto in GCP, über das Braze eine Verbindung herstellen und Daten aus Ihrer/Ihren Tabelle(n) lesen kann. Das Dienstkonto sollte über die folgenden Berechtigungen verfügen:

BigQuery Connection User: Ermöglicht Braze, Verbindungen herzustellen.
BigQuery User: Ermöglicht Braze, Abfragen auszuführen, Datensatz-Metadaten zu lesen und Tabellen aufzulisten.
BigQuery Data Viewer: Ermöglicht Braze, Datensätze und deren Inhalt einzusehen.
BigQuery Job User: Ermöglicht Braze, Aufträge auszuführen.

Wenn Sie das Dienstkonto erstellt und die Berechtigungen erteilt haben, erzeugen Sie einen JSON-Schlüssel. Weitere Informationen finden Sie unter Dienstkontoschlüssel erstellen und löschen. Laden Sie diesen Schlüssel in einem späteren Schritt im Braze-Dashboard hoch.

Schritt 1.3: Zugriff auf Braze-IPs zulassen

Wenn Sie Netzwerkrichtlinien eingerichtet haben, müssen Sie Braze Netzwerkzugriff auf Ihre BigQuery-Instanz gewähren. Erlauben Sie den Zugriff von den folgenden IPs, die der Region Ihres Braze-Dashboards entsprechen.

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.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Für die Instanz US-08 sind dies die relevanten IP-Adressen:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Für die Instanz US-10 sind dies die relevanten IP-Adressen:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Für die Instanzen EU-01 und EU-02 sind dies die relevanten IP-Adressen:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Für die Instanz AU-01 sind dies die relevanten IP-Adressen:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Für die Instanz ID-01 sind dies die relevanten IP-Adressen:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Für die Instanz JP-01 sind dies die relevanten IP-Adressen:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Für die Instanz KR-01 sind dies die relevanten IP-Adressen:

43.200.215.4
52.79.67.175
52.79.113.60

Schritt 1.1: Tabelle einrichten

Optional können Sie einen neuen Katalog oder ein neues Schema für Ihre Quelltabelle einrichten.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Erstellen Sie eine oder mehrere Tabellen für Ihre CDI-Integration mit den folgenden Feldern:

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp(),
  --At least one of external_id, alias_name and alias_label, or braze_id is required
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, email is used as the primary identifier
  email STRING,
  phone STRING,
  payload STRING, STRUCT, or MAP
);

Feldname	Typ	Modus
`UPDATED_AT`	TIMESTAMP	REQUIRED
`PAYLOAD`	STRING, STRUCT oder MAP	REQUIRED
`EXTERNAL_ID`	STRING	NULLABLE
`ALIAS_NAME`	STRING	NULLABLE
`ALIAS_LABEL`	STRING	NULLABLE
`BRAZE_ID`	STRING	NULLABLE
`EMAIL`	STRING	NULLABLE
`PHONE`	STRING	NULLABLE

Sie können das Schema und die Tabelle nach Belieben benennen, aber die Spaltennamen sollten mit der vorherigen Definition übereinstimmen.

UPDATED_AT – Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denen UPDATED_AT nach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt demselben Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen.
Nutzer:innen-Bezeichner-Spalten – Ihre Tabelle kann eine oder mehrere Nutzer:innen-Bezeichner-Spalten enthalten. Jede Zeile sollte nur einen Bezeichner enthalten (entweder external_id, die Kombination aus alias_name und alias_label, braze_id, email oder phone). Eine Quelltabelle kann Spalten für einen, zwei, drei, vier oder alle fünf Bezeichner-Typen enthalten.
- EXTERNAL_ID – Identifiziert die Nutzerin oder den Nutzer, die/den Sie aktualisieren möchten. Dieser Wert sollte dem in Braze verwendeten Wert external_id entsprechen.
- ALIAS_NAME und ALIAS_LABEL – Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt die Art des Alias an. Nutzer:innen können mehrere Aliasnamen mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Die Braze-Nutzer:innen-Kennung. Diese wird vom Braze SDK generiert, und neue Nutzer:innen können nicht mit einer Braze-ID über Cloud-Datenaufnahme erstellt werden. Um neue Nutzer:innen anzulegen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben E-Mail-Adresse vorhanden sind, wird das zuletzt aktualisierte Profil für Updates 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 Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben Telefonnummer vorhanden sind, wird das zuletzt aktualisierte Profil für Updates priorisiert.
PAYLOAD – Ein String oder Struct der Felder, die Sie mit der Nutzerin oder dem Nutzer in Braze synchronisieren möchten.

Schritt 1.2: Zugriffs-Token erstellen

Damit Braze auf Databricks zugreifen kann, muss ein persönliches Zugriffs-Token erstellt werden.

Wählen Sie in Ihrem Databricks-Workspace Ihren Databricks-Nutzernamen in der oberen Leiste aus und wählen Sie dann User Settings aus dem Dropdown-Menü.
Wählen Sie auf dem Tab „Zugriffs-Token“ die Option Generate new token.
Geben Sie einen Kommentar ein, der Ihnen hilft, dieses Token zu identifizieren, z. B. „Braze CDI“, und ändern Sie die Lebensdauer des Tokens auf „keine Lebensdauer“, indem Sie das Feld „Lifetime (days)“ leer lassen.
Wählen Sie Generate.
Kopieren Sie das angezeigte Token und wählen Sie dann Done.

Bewahren Sie das Token an einem sicheren Ort auf, bis Sie es im Braze-Dashboard während des Schritts zur Erstellung der Zugangsdaten eingeben müssen.

Schritt 1.3: Zugriff auf Braze-IPs zulassen

Wenn Sie Netzwerkrichtlinien eingerichtet haben, müssen Sie Braze Netzwerkzugriff auf Ihre Databricks-Instanz gewähren. Erlauben Sie den Zugriff von den folgenden IPs, die der Region Ihres Braze-Dashboards entsprechen.

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.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Für die Instanz US-08 sind dies die relevanten IP-Adressen:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Für die Instanz US-10 sind dies die relevanten IP-Adressen:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Für die Instanzen EU-01 und EU-02 sind dies die relevanten IP-Adressen:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Für die Instanz AU-01 sind dies die relevanten IP-Adressen:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Für die Instanz ID-01 sind dies die relevanten IP-Adressen:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Für die Instanz JP-01 sind dies die relevanten IP-Adressen:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Für die Instanz KR-01 sind dies die relevanten IP-Adressen:

43.200.215.4
52.79.67.175
52.79.113.60

Schritt 1.1: Dienstprinzipal einrichten und Zugriff gewähren

Braze stellt die Verbindung zu Ihrem Fabric-Warehouse über einen Dienstprinzipal mit Entra-ID-Authentifizierung her. Erstellen Sie einen neuen Dienstprinzipal, den Braze verwenden kann, und gewähren Sie bei Bedarf Zugriff auf Fabric-Ressourcen. Braze benötigt für die Verbindung die folgenden Angaben:

Tenant-ID (auch Verzeichnis-ID genannt) für Ihr Azure-Konto
Principal-ID (auch Anwendungs-ID genannt) für den Dienstprinzipal
Client-Geheimnis für die Authentifizierung von Braze

Navigieren Sie im Azure-Portal zum Microsoft Entra Admin Center und dann zu „App-Registrierungen“.
Wählen Sie + New registration unter Identity > Applications > App registrations.
Geben Sie einen Namen ein und wählen Sie dann Accounts in this organizational directory only als unterstützten Kontotyp aus. Wählen Sie dann Register.
Wählen Sie die soeben erstellte Anwendung (Dienstprinzipal) aus und navigieren Sie zu Certificates & secrets > + New client secret.
Geben Sie eine Beschreibung für das Geheimnis ein und legen Sie einen Ablaufzeitraum fest. Wählen Sie dann Add.
Notieren Sie sich das erstellte Client-Geheimnis für die Einrichtung von Braze.

Hinweis

Azure erlaubt keinen unbegrenzten Ablauf von Dienstprinzipal-Geheimnissen. Denken Sie daran, die Zugangsdaten zu aktualisieren, bevor sie ablaufen, um den Datenfluss zu Braze aufrechtzuerhalten.

Schritt 1.2: Zugang zu Fabric-Ressourcen gewähren

Gewähren Sie Braze den Zugang, um sich mit Ihrer Fabric-Instanz zu verbinden. Navigieren Sie in Ihrem Fabric-Administrationsportal zu Settings > Governance and insights > Admin portal > Tenant settings.

Aktivieren Sie in den Developer settings die Option Service principals can use Fabric APIs, damit Braze sich über Microsoft Entra ID verbinden kann.
Aktivieren Sie in den OneLake settings die Option Users can access data stored in OneLake with apps external to Fabric, damit der Dienstprinzipal auf Daten aus einer externen App zugreifen kann.

Schritt 1.3: Gemeinsamen Workspace einrichten und Zugriff gewähren

Alle Fabric-Ressourcen, die Sie mit Braze verbinden möchten, müssen in einem gemeinsamen Workspace platziert werden. Wenn Sie bisher nur den Standard-Workspace My Workspace verwendet haben, erstellen Sie einen neuen gemeinsamen Workspace:

Wählen Sie im Navigationsmenü Workspaces und dann + New workspace.
Geben Sie einen Name für den Workspace ein und wählen Sie Apply.

Nachdem Sie einen gemeinsamen Workspace haben, gewähren Sie dem Dienstprinzipal Zugriff:

Wählen Sie den Workspace aus und dann Manage Access.
Wählen Sie + Add people or groups.
Suchen Sie nach dem Namen des Dienstprinzipals, den Sie in Schritt 1.1 erstellt haben, und wählen Sie ihn aus. Wenn er nicht angezeigt wird, überprüfen Sie, ob Sie die Einstellung Service principals can use Fabric APIs in Schritt 1.2 aktiviert haben.
Wählen Sie im Rollen-Dropdown Contributor aus.

Der Dienstprinzipal kann nun über die SQL-Endpunkte auf Fabric-Warehouse-Ressourcen in diesem Workspace zugreifen, einschließlich des Warehouse, das für Braze verwendet wird.

Schritt 1.4: Tabelle einrichten

Braze unterstützt sowohl Tabellen als auch Ansichten in Fabric Warehouses. Wenn Sie ein neues Warehouse erstellen müssen, erstellen Sie es innerhalb des gemeinsamen Workspace aus Schritt 1.3. Gehen Sie in der Fabric-Konsole zu Create > Data Warehouse > Warehouse.

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
  --If you include both email and phone, email is used as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO

Sie können das Warehouse, das Schema und die Tabelle oder Ansicht beliebig benennen, aber die Spaltennamen sollten mit der vorangegangenen Definition übereinstimmen.

UPDATED_AT – Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denen UPDATED_AT nach dem zuletzt synchronisierten Wert liegt. Zeilen mit exakt demselben Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel aufweisen.
Nutzer:innen-Bezeichner-Spalten – Ihre Tabelle kann eine oder mehrere Nutzer:innen-Bezeichner-Spalten enthalten. Jede Zeile sollte nur einen Bezeichner enthalten (entweder external_id, die Kombination aus alias_name und alias_label, braze_id, email oder phone). Eine Quelltabelle kann Spalten für einen, zwei, drei, vier oder alle fünf Bezeichner-Typen enthalten.
- EXTERNAL_ID – Identifiziert die Nutzerin oder den Nutzer, die/den Sie aktualisieren möchten. Dieser Wert sollte dem in Braze verwendeten Wert external_id entsprechen.
- ALIAS_NAME und ALIAS_LABEL – Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt die Art des Alias an. Nutzer:innen können mehrere Aliasnamen mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Die Braze-Nutzer:innen-Kennung. Diese wird vom Braze SDK generiert, und neue Nutzer:innen können nicht mit einer Braze-ID über Cloud-Datenaufnahme erstellt werden. Um neue Nutzer:innen anzulegen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben E-Mail-Adresse vorhanden sind, wird das zuletzt aktualisierte Profil für Updates 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 Nutzerin oder des Nutzers. Wenn mehrere Profile mit derselben Telefonnummer vorhanden sind, wird das zuletzt aktualisierte Profil für Updates priorisiert.
PAYLOAD – Ein JSON-String mit den Feldern, die Sie mit der Nutzerin oder dem Nutzer in Braze synchronisieren möchten.

Schritt 1.5: Warehouse-Verbindungszeichenfolge abrufen

Um den SQL-Endpunkt für Ihr Warehouse abzurufen, gehen Sie zum Workspace in Fabric, bewegen Sie in der Liste der Elemente den Mauszeiger über den Warehouse-Namen und wählen Sie Copy SQL connection string.

Die Seite „Fabric Console“ in Microsoft Azure, auf der Sie die SQL-Verbindungszeichenfolge abrufen.

Schritt 1.6: Braze-IPs in der Firewall zulassen (optional)

Je nach Konfiguration Ihres Microsoft Fabric-Kontos müssen Sie möglicherweise die folgenden IP-Adressen in Ihrer Firewall zulassen, um den Datenverkehr von Braze zuzulassen. Weitere Informationen dazu finden Sie in der entsprechenden Dokumentation zu Entra Conditional Access.

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.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Für die Instanz US-08 sind dies die relevanten IP-Adressen:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Für die Instanz US-10 sind dies die relevanten IP-Adressen:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Für die Instanzen EU-01 und EU-02 sind dies die relevanten IP-Adressen:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Für die Instanz AU-01 sind dies die relevanten IP-Adressen:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Für die Instanz ID-01 sind dies die relevanten IP-Adressen:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Für die Instanz JP-01 sind dies die relevanten IP-Adressen:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Für die Instanz KR-01 sind dies die relevanten IP-Adressen:

43.200.215.4
52.79.67.175
52.79.113.60

2. Schritt: Neue Quelle im Braze-Dashboard erstellen

Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud Data Ingestion > Quellen, wählen Sie Datenquelle hinzufügen und dann Snowflake.

Schritt 2.1: Snowflake-Verbindungsinformationen hinzufügen

Wählen Sie einen Namen für Ihre Quelle und geben Sie Ihre Snowflake-Zugangsdaten und -Konfiguration ein. Fahren Sie dann mit dem nächsten Schritt fort.

Bevor Sie fortfahren, überprüfen Sie den Wert, den Sie im Feld Snowflake Account Locator eingeben.

Geben Sie im Feld Snowflake Account Locator Ihren Snowflake-Kontobezeichner ein. Geben Sie nur den Wert des Kontobezeichners ein, z. B. myorganization-myaccount. Fügen Sie weder https://, .snowflakecomputing.com noch einen Pfad hinzu.

So finden Sie Ihren Snowflake-Kontobezeichner:

Wählen Sie in Snowsight Ihr Kontomenü aus.
Wählen Sie View account details.
Kopieren Sie den Wert des Account identifier.
Wenn Sie aus einer Snowflake-URL kopieren, verwenden Sie nur den Wert vor .snowflakecomputing.com.

Schritt 2.2: Public Key zur Braze-Nutzerin oder zum Braze-Nutzer hinzufügen

Nachdem Sie Ihre Zugangsdaten und Konfiguration eingegeben haben, klicken Sie auf Save credentials, generieren Sie einen RSA-Schlüssel und kehren Sie zu Snowflake zurück, um die Einrichtung abzuschließen. Fügen Sie den im Dashboard angezeigten Public Key der Nutzerin oder dem Nutzer hinzu, die/den Sie für die Verbindung von Braze mit Snowflake erstellt haben.

Weitere Informationen dazu finden Sie in der Snowflake-Dokumentation. Wenn Sie die Schlüssel zu einem beliebigen Zeitpunkt rotieren möchten, kann Braze ein neues Schlüsselpaar erzeugen und den neuen Public Key bereitstellen.

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

Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud Data Ingestion > Quellen, wählen Sie Datenquelle hinzufügen und dann Amazon Redshift.

Schritt 2.1: Redshift-Verbindungsinformationen und Quelltabelle hinzufügen

Wählen Sie einen Namen für Ihre Quelle und geben Sie Ihre Redshift-Zugangsdaten und -Konfiguration ein. Wenn Sie einen privaten Netzwerktunnel verwenden, aktivieren Sie den Schieberegler und geben Sie die Tunnelinformationen ein. Fahren Sie dann mit dem nächsten Schritt fort.

Hinweis

Im Braze-Dashboard akzeptiert das Feld Database name nur Buchstaben (A–Z, a–z), Zahlen (0–9) und Unterstriche (_), obwohl Amazon Redshift zusätzliche Zeichen in Datenbankbezeichnern unterstützt.

Schritt 2.2: Verbindung testen und mit Quelle verbinden

Wählen Sie als Nächstes Test connection. Bei Erfolg schließen Sie die verbleibenden Einstellungen ab und klicken Sie auf Connect to Source. Wenn die Verbindung fehlschlägt, wird eine Fehlermeldung angezeigt, die Ihnen bei der Fehlerbehebung hilft.

Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud Data Ingestion > Quellen, wählen Sie Datenquelle hinzufügen und dann Google BigQuery.

Schritt 2.1: BigQuery-Verbindungsinformationen und Quelltabelle hinzufügen

Wählen Sie einen Namen für Ihre Quelle. Laden Sie dann den JSON-Schlüssel hoch und geben Sie einen Namen für das Dienstkonto an. Geben Sie anschließend die verbleibenden Konfigurationsfelder ein.

Schritt 2.2: Verbindung testen und mit Quelle verbinden

Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud Data Ingestion > Quellen, wählen Sie Datenquelle hinzufügen und dann Databricks.

Schritt 2.1: Databricks-Verbindungsinformationen und Quelltabelle hinzufügen

Wählen Sie einen Namen für Ihre Quelle und geben Sie Ihre Databricks-Zugangsdaten und -Konfiguration ein. Fahren Sie dann mit dem nächsten Schritt fort.

Schritt 2.2: Verbindung testen und mit Quelle verbinden

Hinweis

Sie müssen eine Quelle erfolgreich testen, bevor sie erstellt werden kann. Wenn Sie die Erstellungsseite schließen, wird Ihre Quelle nicht gespeichert.

Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Cloud Data Ingestion > Quellen, wählen Sie Datenquelle hinzufügen und dann Microsoft Fabric.

Schritt 2.1: Cloud-Datenaufnahme-Synchronisierung einrichten

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

Credentials Name ist eine Bezeichnung für diese Zugangsdaten in Braze – Sie können hier einen hilfreichen Wert festlegen.
Einzelheiten zum Abrufen von Tenant-ID, Principal-ID, Client-Geheimnis und Verbindungszeichenfolge finden Sie in den Schritten in Abschnitt 1.

Schritt 2.2: Verbindung testen und mit Quelle verbinden

Hinweis

Sie müssen eine Quelle erfolgreich testen, bevor sie erstellt werden kann. Wenn Sie die Erstellungsseite schließen, wird Ihre Quelle nicht gespeichert.

3. Schritt: Neue Synchronisierung im Braze-Dashboard erstellen

Gehen Sie zu Dateneinstellungen > Cloud Data Ingestion > Synchronisierungen und wählen Sie Datensynchronisierung erstellen.

Schritt 3.1: Synchronisierungsdetails konfigurieren und Verbindung testen

Wählen Sie einen Namen für Ihre Synchronisierung. Wählen Sie dann eine aktive Quelle aus und geben Sie Ihre Quelltabelle für die Synchronisierung ein. Wählen Sie einen Datentyp und klicken Sie auf Test Connection.

Bei Erfolg wird eine Vorschau der Daten angezeigt. Wählen Sie Next: Notifications, um fortzufahren. Wenn die Verbindung fehlschlägt, wird eine Fehlermeldung angezeigt, die Ihnen bei der Fehlerbehebung hilft.

Hinweis

Sie müssen eine Synchronisierung erfolgreich testen, bevor Sie mit den nächsten Schritten fortfahren können. Wenn Sie die Erstellungsseite der Synchronisierung verlassen müssen, klicken Sie auf Als Entwurf speichern, um Ihren Fortschritt zu sichern.

Schritt 3.2: Benachrichtigungseinstellungen hinzufügen

Geben Sie Kontakt-E-Mail-Adresse(n) für Benachrichtigungen über Synchronisierungsfehler ein. Braze verwendet diese Kontaktinformationen, um Benachrichtigungen über Integrationsfehler zu senden, z. B. über den unerwarteten Verlust des Tabellenzugriffs.

Kontakt-E-Mails erhalten nur Benachrichtigungen über globale oder synchronisierungsbezogene Fehler wie fehlende Tabellen, Berechtigungen und andere. Sie erhalten keine Benachrichtigungen über Fehler auf Zeilenebene. Globale Fehler weisen auf kritische Probleme mit der Verbindung hin, die die Ausführung von Synchronisierungen verhindern.

Solche Probleme können Folgendes umfassen:

Verbindungsprobleme
Mangel an Ressourcen
Berechtigungsprobleme
(Nur für Katalog-Synchronisierungen) Der Katalog-Tier hat keinen Platz mehr

Schritt 3.3: Zeitplanung

Konfigurieren Sie abschließend Ihre Synchronisierung als einmalig oder wiederkehrend.

Einmalige Synchronisierungen können manuell oder über die API ausgelöst werden.

Wiederkehrende Synchronisierungen können eine Häufigkeit von alle 15 Minuten bis einmal pro Monat haben. Braze plant die wiederkehrende Synchronisierung in der UTC-Zeitzone.

Schritt 3.1: Synchronisierungsdetails konfigurieren und Verbindung testen

Hinweis

Schritt 3.2: Benachrichtigungseinstellungen hinzufügen

Solche Probleme können Folgendes umfassen:

Verbindungsprobleme
Mangel an Ressourcen
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Der Katalog-Tier hat keinen Platz mehr

Schritt 3.3: Zeitplanung

Konfigurieren Sie abschließend Ihre Synchronisierung als einmalig oder wiederkehrend.

Einmalige Synchronisierungen können manuell oder über die API ausgelöst werden.

Wiederkehrende Synchronisierungen können eine Häufigkeit von alle 15 Minuten bis einmal pro Monat haben. Braze plant die wiederkehrende Synchronisierung in der UTC-Zeitzone.

Schritt 3.1: Synchronisierungsdetails konfigurieren und Verbindung testen

Hinweis

Schritt 3.2: Benachrichtigungseinstellungen hinzufügen

Verbindungsprobleme
Mangel an Ressourcen
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Der Katalog-Tier hat keinen Platz mehr

Schritt 3.3: Zeitplanung

Konfigurieren Sie abschließend Ihre Synchronisierung als einmalig oder wiederkehrend.

Einmalige Synchronisierungen können manuell oder über die API ausgelöst werden.

Wiederkehrende Synchronisierungen können eine Häufigkeit von alle 15 Minuten bis einmal pro Monat haben. Braze plant die wiederkehrende Synchronisierung in der UTC-Zeitzone.

Schritt 3.1: Synchronisierungsdetails konfigurieren und Verbindung testen

Hinweis

Schritt 3.2: Benachrichtigungseinstellungen hinzufügen

Solche Probleme können Folgendes umfassen:

Verbindungsprobleme
Mangel an Ressourcen
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Der Katalog-Tier hat keinen Platz mehr

Schritt 3.3: Zeitplanung

Konfigurieren Sie abschließend Ihre Synchronisierung als einmalig oder wiederkehrend.

Einmalige Synchronisierungen können manuell oder über die API ausgelöst werden.

Wiederkehrende Synchronisierungen können eine Häufigkeit von alle 15 Minuten bis einmal pro Monat haben. Braze plant die wiederkehrende Synchronisierung in der UTC-Zeitzone.

Schritt 3.1: Synchronisierungsdetails konfigurieren und Verbindung testen

Hinweis

Schritt 3.2: Benachrichtigungseinstellungen hinzufügen

Solche Probleme können Folgendes umfassen:

Verbindungsprobleme
Mangel an Ressourcen
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Der Katalog-Tier hat keinen Platz mehr

Schritt 3.3: Zeitplanung

Konfigurieren Sie abschließend Ihre Synchronisierung als einmalig oder wiederkehrend.

Einmalige Synchronisierungen können manuell oder über die API ausgelöst werden.

Wiederkehrende Synchronisierungen können eine Häufigkeit von alle 15 Minuten bis einmal pro Monat haben. Braze plant die wiederkehrende Synchronisierung in der UTC-Zeitzone.

Hinweis

Sie müssen eine Integration erfolgreich testen, bevor sie vom Entwurfsstatus in den aktiven Status übergehen kann. Wenn Sie die Erstellungsseite schließen, wird Ihre Integration gespeichert, und Sie können die Detailseite erneut aufrufen, um Änderungen vorzunehmen und zu testen.

Zusätzliche Integrationen oder Nutzer:innen einrichten (optional)

Sie können mehrere Integrationen mit Braze einrichten, aber jede Integration sollte so konfiguriert werden, dass eine andere Tabelle synchronisiert wird. Wenn Sie zusätzliche Synchronisierungen erstellen, können Sie vorhandene Zugangsdaten wiederverwenden, wenn Sie sich mit demselben Snowflake-Konto verbinden.

Wenn Sie dieselbe Nutzerin oder denselben Nutzer und dieselbe Rolle bei verschiedenen Integrationen wiederverwenden, müssen Sie den Public Key nicht erneut hinzufügen.

Wenn Sie dieselbe Nutzerin oder denselben Nutzer bei verschiedenen Integrationen wiederverwenden, können Sie die Nutzerin oder den Nutzer im Braze-Dashboard erst löschen, wenn sie/er aus allen aktiven Synchronisierungen entfernt wurde.

Ausführen der Synchronisierung

Nach der Aktivierung wird Ihre Synchronisierung nach dem bei der Einrichtung konfigurierten Zeitplan ausgeführt. Wenn Sie die Synchronisierung außerhalb des normalen Testzeitplans durchführen oder die neuesten Daten abrufen möchten, wählen Sie Sync Now. Dieser Lauf hat keine Auswirkungen auf regelmäßig geplante zukünftige Synchronisierungen.

New Stuff!