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.

Einrichtung von Data-Warehouse-Integrationen

Cloud Data Ingestion-Integrationen erfordern eine gewisse Einrichtung auf der Braze-Seite und in Ihrer Data-Warehouse-Instanz. Führen Sie die folgenden Schritte aus, um die Integration einzurichten:

Richten Sie in Ihrer Snowflake-Instanz die Tabellen oder Views 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 hängen Sie ihn an den Snowflake-Nutzer zur Authentifizierung an.
Erstellen Sie eine Synchronisierung im Braze-Dashboard, testen Sie die Integration und starten Sie die Synchronisierung.

Tipp

Der Snowflake-Schnellstartleitfaden enthält Beispielcode und führt durch die erforderlichen Schritte, um eine automatisierte Pipeline mit Snowflake Streams und CDI zur Datensynchronisierung mit Braze zu erstellen.

Stellen Sie sicher, dass der Braze-Zugriff auf die Redshift-Tabellen erlaubt ist, die Sie synchronisieren möchten. Braze verbindet sich über das Internet mit Redshift.
Richten Sie in Ihrer Redshift-Instanz die Tabellen oder Views 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 Warehouses, der Netzwerklatenz und der Menge neuer Daten ab, die der Synchronisierungsabfrage entsprechen. Verwenden Sie den Synchronisierungsverlauf der Integration im Dashboard, um Dauer und Zeilenanzahlen der letzten Durchläufe einzusehen.

Erstellen Sie ein Dienstkonto und erlauben Sie den Zugriff auf die BigQuery-Projekte und -Datensätze, die die zu synchronisierenden Daten enthalten.
Richten Sie in Ihrem BigQuery-Konto die Tabellen oder Views 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 die Databricks-Projekte und -Datensätze, die die zu synchronisierenden Daten enthalten.
Richten Sie in Ihrem Databricks-Konto die Tabellen oder Views 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

Es kann zwei bis fünf Minuten Aufwärmzeit geben, wenn Braze eine Verbindung zu Classic- und Pro-SQL-Instanzen herstellt, was zu Verzögerungen beim Verbindungsaufbau und -test sowie zu Beginn geplanter Synchronisierungen führen kann. Die Verwendung einer serverlosen SQL-Instanz minimiert die Aufwärmzeit und verbessert den Abfragedurchsatz, kann jedoch zu geringfügig höheren Integrationskosten führen.

Erstellen Sie einen Dienstprinzipal und gewähren Sie Zugriff auf Fabric-APIs.
Richten Sie einen gemeinsam genutzten Workspace ein und gewähren Sie dem Dienstprinzipal Zugriff darauf.
Richten Sie im gemeinsam genutzten Fabric-Workspace die Tabellen oder Views 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.

Schritt 1: Tabellen oder Views einrichten

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

Hinweis

Ihre Quelltabelle oder View kann Spalten enthalten, die nicht für Ihr Warehouse in den Tabs im folgenden Abschnitt aufgeführt sind (z. B. Auditing oder Hashing). Braze liest nur die in diesen Tabs beschriebenen Spalten; andere Spalten werden bei Cloud Data Ingestion-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 Datenbank, Schema und Tabelle beliebig benennen, die Spaltennamen sollten jedoch der obigen Definition entsprechen.

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 an der exakten Grenz-Zeitstempel-Grenze können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel verwenden.
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 Bezeichnertypen haben.
- EXTERNAL_ID – Identifiziert die Nutzer:in, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen.
- ALIAS_NAME und ALIAS_LABEL – Diese zwei Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Der Braze-Nutzer:innen-Bezeichner. Dieser wird vom Braze SDK generiert, und neue Nutzer:innen können nicht über eine Braze-ID durch Cloud Data Ingestion erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer:innen-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert. Wenn Sie sowohl E-Mail als auch Telefon angeben, wird die E-Mail als primärer Bezeichner verwendet.
- PHONE – Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert.
PAYLOAD – Dies ist ein JSON-String der Felder, die Sie mit der Nutzer:in 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, die Berechtigungen sollten jedoch dem obigen Beispiel entsprechen.

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

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Hinweis

Das Warehouse muss die Auto-Resume-Funktion aktiviert haben. Falls nicht, gewähren Sie Braze zusätzliche OPERATE-Berechtigungen auf dem 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;

Teilen Sie nach diesem Schritt die Verbindungsinformationen mit Braze, um einen Public Key zu erhalten, der an die Nutzer:in angehängt wird.

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 eindeutige Nutzer:in erstellen. Innerhalb eines Workspaces können Sie dieselbe Nutzer:in über verschiedene Integrationen hinweg wiederverwenden, die Integration schlägt jedoch fehl, wenn eine Nutzer:in im selben Snowflake-Konto über Workspaces hinweg dupliziert wird.

Schritt 1.5: Braze-IPs in der Snowflake-Netzwerkrichtlinie zulassen (optional)

Abhängig von der Konfiguration Ihres Snowflake-Kontos müssen Sie möglicherweise die folgenden IP-Adressen in Ihrer Snowflake-Netzwerkrichtlinie zulassen. Weitere Informationen zur Aktivierung 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
3.34.212.92
54.116.134.231
3.37.197.225

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 View) 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 Datenbank, Schema und Tabelle beliebig benennen, die Spaltennamen sollten jedoch der obigen Definition entsprechen.

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 an der exakten Grenz-Zeitstempel-Grenze können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel verwenden.
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 Bezeichnertypen haben.
- EXTERNAL_ID – Identifiziert die Nutzer:in, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen.
- ALIAS_NAME und ALIAS_LABEL – Diese zwei Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Der Braze-Nutzer:innen-Bezeichner. Dieser wird vom Braze SDK generiert, und neue Nutzer:innen können nicht über eine Braze-ID durch Cloud Data Ingestion erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer:innen-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert. Wenn Sie sowohl E-Mail als auch Telefon angeben, wird die E-Mail als primärer Bezeichner verwendet.
- PHONE – Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert.
PAYLOAD – Dies ist ein JSON-String der Felder, die Sie mit der Nutzer:in in Braze synchronisieren möchten.

Schritt 1.2: Nutzer:in erstellen 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 Mindestberechtigungen für diese Nutzer:in. Wenn Sie mehrere CDI-Integrationen erstellen, möchten Sie möglicherweise Berechtigungen auf Schema-Ebene erteilen oder Berechtigungen über eine Gruppe verwalten.

Schritt 1.3: Zugriff für Braze-IPs erlauben

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, um Braze den Zugriff auf Ihre Daten in Redshift zu ermöglichen.
Stellen Sie sicher, dass Sie den 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), explizit zulassen. Sie sollten die Redshift-TCP-Konnektivität auf diesem Port explizit zulassen, auch wenn die Eingangsregeln auf „Alle zulassen“ eingestellt sind.
Der Endpunkt für den Redshift-Cluster muss öffentlich zugänglich sein, damit Braze sich mit Ihrem Cluster verbinden kann.
- Wenn Sie nicht möchten, dass Ihr Redshift-Cluster öffentlich zugänglich ist, können Sie eine VPC und EC2-Instanz einrichten, um einen SSH-Tunnel für den Zugriff auf die Redshift-Daten zu verwenden. Weitere Informationen finden Sie im Beitrag des AWS Knowledge Centers.

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
3.34.212.92
54.116.134.231
3.37.197.225

Schritt 1.1: Tabelle einrichten

Optional können Sie ein neues Projekt oder einen neuen Datensatz 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 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 Projekt, Datensatz und Tabelle beliebig benennen, die Spaltennamen sollten jedoch der obigen Definition entsprechen.

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 an der exakten Grenz-Zeitstempel-Grenze können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel verwenden.
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 Bezeichnertypen haben.
- EXTERNAL_ID – Identifiziert die Nutzer:in, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen.
- ALIAS_NAME und ALIAS_LABEL – Diese zwei Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Der Braze-Nutzer:innen-Bezeichner. Dieser wird vom Braze SDK generiert, und neue Nutzer:innen können nicht über eine Braze-ID durch Cloud Data Ingestion erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer:innen-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert. Wenn Sie sowohl E-Mail als auch Telefon angeben, wird die E-Mail als primärer Bezeichner verwendet.
- PHONE – Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert.
PAYLOAD – Dies ist ein JSON-String der Felder, die Sie mit der Nutzer:in in Braze synchronisieren möchten.

Wichtig

BigQuery-Partitionierung

CDI unterstützt Partitionen für BigQuery. Wenn Sie nach einer Funktion von UPDATED_AT partitionieren (z. B. auf Tages-, Wochen- oder Stundenebene, je nach Größe Ihres Datensatzes), kann BigQuery die zu scannenden Daten eingrenzen. Dies verbessert die Performance und Effizienz bei sehr großen Tabellen.

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

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

Weitere Informationen finden Sie in der BigQuery-Partitionierungsdokumentation.

Schritt 1.2: Dienstkonto erstellen und Berechtigungen erteilen

Erstellen Sie ein Dienstkonto in GCP, das Braze verwenden kann, um eine Verbindung herzustellen und Daten aus Ihren Tabellen zu lesen. Das Dienstkonto sollte die folgenden Berechtigungen haben:

BigQuery Connection User: Ermöglicht Braze, Verbindungen herzustellen
BigQuery User: Ermöglicht Braze den Zugriff zum Ausführen von Abfragen, Lesen von Datensatz-Metadaten und Auflisten von Tabellen.
BigQuery Data Viewer: Ermöglicht Braze den Zugriff zum Anzeigen von Datensätzen und deren Inhalten.
BigQuery Job User: Ermöglicht Braze den Zugriff zum Ausführen von Jobs

Generieren Sie nach der Erstellung des Dienstkontos und der Erteilung der Berechtigungen 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 für Braze-IPs erlauben

Wenn Sie Netzwerkrichtlinien 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
3.34.212.92
54.116.134.231
3.37.197.225

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, or 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 Schema und Tabelle beliebig benennen, die Spaltennamen sollten jedoch der obigen Definition entsprechen.

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 an der exakten Grenz-Zeitstempel-Grenze können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel verwenden.
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 Bezeichnertypen haben.
- EXTERNAL_ID – Identifiziert die Nutzer:in, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen.
- ALIAS_NAME und ALIAS_LABEL – Diese zwei Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Der Braze-Nutzer:innen-Bezeichner. Dieser wird vom Braze SDK generiert, und neue Nutzer:innen können nicht über eine Braze-ID durch Cloud Data Ingestion erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer:innen-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert. Wenn Sie sowohl E-Mail als auch Telefon angeben, wird die E-Mail als primärer Bezeichner verwendet.
- PHONE – Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert.
PAYLOAD – Dies ist ein String oder Struct der Felder, die Sie mit der Nutzer:in in Braze synchronisieren möchten.

Schritt 1.2: Zugriffstoken erstellen

Damit Braze auf Databricks zugreifen kann, muss ein persönlicher Zugriffstoken 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 „Access tokens“ 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 unbegrenzt, 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 beim Schritt zur Erstellung der Zugangsdaten im Braze-Dashboard eingeben müssen.

Schritt 1.3: Zugriff für Braze-IPs erlauben

Wenn Sie Netzwerkrichtlinien 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
3.34.212.92
54.116.134.231
3.37.197.225

Schritt 1.1: Dienstprinzipal einrichten und Zugriff gewähren

Braze verbindet sich mit Ihrem Fabric-Warehouse über einen Dienstprinzipal mit Entra-ID-Authentifizierung. Erstellen Sie einen neuen Dienstprinzipal, den Braze verwenden kann, und gewähren Sie bei Bedarf Zugriff auf Fabric-Ressourcen. Braze benötigt die folgenden Details zur Verbindung:

Mandanten-ID (auch als Verzeichnis bezeichnet) für Ihr Azure-Konto
Prinzipal-ID (auch als Anwendungs-ID bezeichnet) für den Dienstprinzipal
Client-Secret für die Authentifizierung durch Braze

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

Hinweis

Azure erlaubt keine unbegrenzte Gültigkeit für Dienstprinzipal-Secrets. Denken Sie daran, die Zugangsdaten zu erneuern, bevor sie ablaufen, um den Datenfluss zu Braze aufrechtzuerhalten.

Schritt 1.2: Zugriff auf Fabric-Ressourcen gewähren

Gewähren Sie Braze Zugriff zur Verbindung mit Ihrer Fabric-Instanz. Navigieren Sie in Ihrem Fabric-Admin-Portal zu Settings > Governance and insights > Admin portal > Tenant settings.

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

Schritt 1.3: Gemeinsam genutzten Workspace einrichten und Zugriff gewähren

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

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

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

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

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

Schritt 1.4: Tabelle einrichten

Braze unterstützt sowohl Tabellen als auch Views in Fabric Warehouses. Wenn Sie ein neues Warehouse erstellen müssen, erstellen Sie es innerhalb des gemeinsam genutzten Workspaces aus Schritt 1.3. Gehen Sie im Fabric-Konsolenmenü 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 Warehouse, Schema und Tabelle oder View beliebig benennen, die Spaltennamen sollten jedoch der obigen Definition entsprechen.

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 an der exakten Grenz-Zeitstempel-Grenze können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel verwenden.
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 Bezeichnertypen haben.
- EXTERNAL_ID – Identifiziert die Nutzer:in, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen.
- ALIAS_NAME und ALIAS_LABEL – Diese zwei Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label.
- BRAZE_ID – Der Braze-Nutzer:innen-Bezeichner. Dieser wird vom Braze SDK generiert, und neue Nutzer:innen können nicht über eine Braze-ID durch Cloud Data Ingestion erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer:innen-ID oder einen Nutzer-Alias an.
- EMAIL – Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert. Wenn Sie sowohl E-Mail als auch Telefon angeben, wird die E-Mail als primärer Bezeichner verwendet.
- PHONE – Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird das zuletzt aktualisierte Profil für Aktualisierungen priorisiert.
PAYLOAD – Dies ist ein JSON-String der Felder, die Sie mit der Nutzer:in 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 den Mauszeiger über den Warehouse-Namen in der Elementliste und wählen Sie Copy SQL connection string.

Die Seite „Fabric Console“ in Microsoft Azure, auf der Nutzer:innen die SQL-Verbindungszeichenfolge abrufen sollten.

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

Abhängig von der Konfiguration Ihres Microsoft-Fabric-Kontos müssen Sie möglicherweise die folgenden IP-Adressen in Ihrer Firewall zulassen, um den Datenverkehr von Braze zu erlauben. Weitere Informationen zur Aktivierung 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
3.34.212.92
54.116.134.231
3.37.197.225

Schritt 2: Neue Quelle im Braze-Dashboard erstellen

Gehen Sie im Braze-Dashboard zu Data Settings > Cloud Data Ingestion > Sources, wählen Sie Add data source 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 für das Feld Snowflake Account Locator Ihren Snowflake-Kontobezeichner ein. Geben Sie nur den Kontobezeichner-Wert ein, z. B. myorganization-myaccount. Fügen Sie kein https://, .snowflakecomputing.com oder einen Pfad hinzu.

So finden Sie Ihren Snowflake-Kontobezeichner:

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

Schritt 2.2: Public Key zur Braze-Nutzer:in hinzufügen

Nachdem Sie Ihre Zugangsdaten und Konfiguration eingegeben haben, klicken Sie auf Save credentials, generieren Sie einen RSA-Schlüssel und gehen Sie 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 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 generieren und den neuen Public Key bereitstellen.

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

Gehen Sie im Braze-Dashboard zu Data Settings > Cloud Data Ingestion > Sources, wählen Sie Add data source 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 (_), auch wenn 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. Sobald der Test erfolgreich war, schließen Sie die verbleibenden Einstellungen ab und klicken Sie auf Connect to Source. Wenn die Verbindung fehlschlägt, wird eine Fehlermeldung angezeigt, die bei der Fehlerbehebung hilft.

Fehlerbehebung: Ungültiger Snapshot-Bezeichner

Wenn Braze während Test connection oder der Synchronisierungseinrichtung den Fehler Invalid snapshot identifier zurückgibt, kann Redshift die Snapshot-Referenz nicht auflösen, die beim Abfragen Ihres Quellobjekts verwendet wird.

In Redshift ist ein Snapshot eine zeitpunktbezogene Sicherung eines Clusters. Jeder Snapshot hat einen eindeutigen Bezeichner, den Redshift verwendet, um auf diesen Sicherungszustand zu verweisen. Weitere Informationen finden Sie unter Amazon Redshift-Snapshots und -Backups.

Dieser Fehler kann auftreten, wenn sich Metadaten ändern, während Braze das Quellobjekt validiert, z. B. während Vorgängen zum Kopieren, Wiederherstellen oder Replizieren von Snapshots. Weitere Informationen finden Sie unter Snapshots in eine andere AWS-Region kopieren und Einen Cluster aus einem Snapshot wiederherstellen.

Zur Fehlerbehebung:

Überprüfen Sie die Quelleinstellungen in Braze, einschließlich Cluster-Endpunkt, Datenbank, Schema und Objektname.
Führen Sie dieselbe Abfrage direkt in Redshift aus, um zu bestätigen, dass die Tabelle oder View lesbar und stabil ist.
Versuchen Sie es erneut, nachdem aktive Snapshot-, Wiederherstellungs-, Größenänderungs- oder Replikationsaktivitäten abgeschlossen sind.
Wenn das Problem weiterhin besteht, fragen Sie stattdessen eine materialisierte View anstelle einer sich häufig ändernden Basistabelle ab.

Eine materialisierte View speichert vorberechnete Abfrageergebnisse, die Sie nach einem Zeitplan aktualisieren können, was Lesevorgänge für CDI-Synchronisierungen stabiler machen kann. Weitere Informationen finden Sie unter Materialisierte Views in Amazon Redshift.

Beispiel:

CREATE MATERIALIZED VIEW ingestion.users_attributes_mv AS
SELECT updated_at, external_id, alias_label, alias_name, braze_id, email, phone, payload
FROM ingestion.users_attributes_sync;

REFRESH MATERIALIZED VIEW ingestion.users_attributes_mv;

Nachdem Sie die materialisierte View erstellt haben, verwenden Sie den Namen der materialisierten View als Quellobjekt in Ihrer Braze-CDI-Synchronisierung anstelle der Basistabelle.

Gehen Sie im Braze-Dashboard zu Data Settings > Cloud Data Ingestion > Sources, wählen Sie Add data source 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 dann die verbleibenden Konfigurationsfelder ein.

Schritt 2.2: Verbindung testen und mit Quelle verbinden

Gehen Sie im Braze-Dashboard zu Data Settings > Cloud Data Ingestion > Sources, wählen Sie Add data source 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 Data Settings > Cloud Data Ingestion > Sources, wählen Sie Add data source und dann Microsoft Fabric.

Schritt 2.1: Cloud Data Ingestion-Synchronisierung einrichten

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

Credentials Name ist ein Label für diese Zugangsdaten in Braze; Sie können hier einen hilfreichen Wert festlegen.
Einzelheiten zum Abrufen von Tenant-ID, Prinzipal-ID, Client-Secret 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.

Schritt 3: Neue Synchronisierung im Braze-Dashboard erstellen

Gehen Sie zu Data Settings > Cloud Data Ingestion > Syncs und wählen Sie Create data sync.

Schritt 3.1: Synchronisierungsdetails konfigurieren und Verbindung testen

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

Sobald der Test erfolgreich war, wird eine Vorschau der Daten angezeigt. Wählen Sie Next: Notifications, um fortzufahren. Wenn die Verbindung fehlschlägt, wird eine Fehlermeldung angezeigt, die bei der Fehlerbehebung hilft.

Hinweis

Sie müssen eine Synchronisierung erfolgreich testen, bevor Sie zu den nächsten Schritten fortfahren können. Wenn Sie die Erstellungsseite für die Synchronisierung schließen müssen, klicken Sie auf Save as draft, um Ihren Fortschritt zu speichern.

Schritt 3.2: Benachrichtigungseinstellungen hinzufügen

Geben Sie Kontakt-E-Mail-Adressen für Synchronisierungs-Fehlerbenachrichtigungen ein. Braze verwendet diese Kontaktinformationen, um Benachrichtigungen über Integrationsfehler zu senden, z. B. unerwarteten Verlust des Tabellenzugriffs.

Kontakt-E-Mails erhalten nur Benachrichtigungen über globale oder Synchronisierungs-Level-Fehler wie fehlende Tabellen, Berechtigungen und andere. Sie erhalten keine Benachrichtigungen über Probleme 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:

Konnektivitätsprobleme
Ressourcenmangel
Berechtigungsprobleme
(Nur für Katalog-Synchronisierungen) Katalogstufe hat keinen Speicherplatz 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 Frequenz 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:

Konnektivitätsprobleme
Ressourcenmangel
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Katalogstufe hat keinen Speicherplatz 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 Frequenz 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

Konnektivitätsprobleme
Ressourcenmangel
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Katalogstufe hat keinen Speicherplatz 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 Frequenz 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:

Konnektivitätsprobleme
Ressourcenmangel
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Katalogstufe hat keinen Speicherplatz 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 Frequenz 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:

Konnektivitätsprobleme
Ressourcenmangel
Berechtigungsprobleme

(Nur für Katalog-Synchronisierungen) Katalogstufe hat keinen Speicherplatz 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 Frequenz 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 Entwurfs- in den aktiven Zustand wechseln 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 sein, dass sie eine andere Tabelle synchronisiert. Beim Erstellen zusätzlicher Synchronisierungen können Sie vorhandene Zugangsdaten wiederverwenden, wenn Sie sich mit demselben Snowflake-Konto verbinden.

Wenn Sie dieselbe:n Nutzer:in und dieselbe Rolle über mehrere Integrationen hinweg wiederverwenden, müssen Sie den Public Key nicht erneut hinzufügen.

Wenn Sie dieselbe:n Nutzer:in über mehrere Integrationen hinweg wiederverwenden, können Sie diese:n Nutzer:in im Braze-Dashboard erst löschen, wenn er/sie aus allen aktiven Synchronisierungen entfernt wurde.

Synchronisierung ausführen

Nach der Aktivierung wird Ihre Synchronisierung gemäß dem während der Einrichtung konfigurierten Zeitplan ausgeführt. Wenn Sie die Synchronisierung außerhalb des normalen Testzeitplans ausführen oder die neuesten Daten abrufen möchten, wählen Sie Sync Now aus. Diese Ausführung hat keinen Einfluss auf regulär geplante zukünftige Synchronisierungen.

New Stuff!