Zum Inhalt springen

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.

Verbundene Quellen

Verbundene Quellen sind eine Zero-Copy-Alternative zur direkten Synchronisierung von Daten mit dem Cloud-Datenaufnahme-Feature (CDI) von Braze. Eine verbundene Quelle fragt direkt Ihr Data Warehouse ab, um neue Segmente zu erstellen, ohne die zugrunde liegenden Daten nach Braze zu kopieren.

Nachdem Sie eine verbundene Quelle zu Ihrem Braze-Workspace hinzugefügt haben, können Sie innerhalb der Segmenterweiterungen ein CDI-Segment erstellen. CDI-Segmenterweiterungen ermöglichen es Ihnen, SQL-Befehle zu schreiben, die direkt Ihr Data Warehouse abfragen (unter Verwendung der Daten, die über Ihre verbundene CDI-Quelle verfügbar sind), und eine Gruppe von Nutzer:innen zu erstellen und zu pflegen, die innerhalb von Braze angesprochen werden können.

Weitere Informationen zum Erstellen eines Segments mit dieser Quelle finden Sie unter CDI-Segmenterweiterungen.

Warnung

Da verbundene Quellen direkt auf Ihrem Data Warehouse laufen, entstehen Ihnen alle Kosten, die mit der Ausführung dieser Abfragen in Ihrem Data Warehouse verbunden sind. Verbundene Quellen protokollieren keine Datenpunkte, und CDI-Segmenterweiterungen verbrauchen keine SQL-Segment-Credits.

Connected Sources integrieren

Schritt 1: Ressourcen verbinden

Connected Sources für die Cloud-Datenaufnahme erfordern einige Einrichtungsschritte in Braze und in Ihrer Instanz. Befolgen Sie diese Schritte, um die Integration einzurichten−einige Schritte werden in Ihrem Data Warehouse und einige im Braze-Dashboard durchgeführt.

In Ihrem Data Warehouse

Erstellen Sie eine Rolle und erteilen Sie Berechtigungen zum Abfragen und Erstellen von Tabellen in einem Schema.
Richten Sie Ihr Warehouse ein und gewähren Sie dieser Rolle Zugriff.
Erstellen Sie eine Nutzer:in für diese Rolle.
Abhängig von Ihrer Konfiguration müssen Sie möglicherweise Braze-IPs in Ihrer Snowflake-Netzwerkrichtlinie zulassen.

Im Braze-Dashboard

Erstellen Sie eine neue Connected Source im Braze-Dashboard.
Konfigurieren Sie die Sync-Details für die Connected Source.
Rufen Sie den im Braze-Dashboard bereitgestellten Public Key ab.

In Ihrem Data Warehouse

Hängen Sie den Public Key aus dem Braze-Dashboard an die Snowflake-Nutzer:in für die Authentifizierung an. Wenn Sie fertig sind, können Sie die Connected Source verwenden, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Richten Sie die Quelldaten und die erforderlichen Ressourcen in Ihrer Redshift-Umgebung ein.
Erstellen Sie eine neue Connected Source im Braze-Dashboard.
Testen Sie die Integration.
Verwenden Sie die Connected Source, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Richten Sie die Quelldaten und die erforderlichen Ressourcen in Ihrer BigQuery-Umgebung ein.
Erstellen Sie ein Dienstkonto, auf das Braze über Workload Identity Federation oder einen Dienstkontoschlüssel zugreift, und gewähren Sie Zugriff auf die BigQuery-Projekte und Datensätze, die die zu synchronisierenden Daten enthalten.
Erstellen Sie eine neue Connected Source im Braze-Dashboard.
Testen Sie die Integration.
Verwenden Sie die Connected Source, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Richten Sie die Quelldaten und die erforderlichen Ressourcen in Ihrer Databricks-Umgebung ein.
Erstellen Sie einen Dienstprinzipal für die OAuth-Machine-to-Machine-Authentifizierung (M2M) oder ein persönliches Zugriffstoken und gewähren Sie Zugriff auf die Databricks-Kataloge und -Schemas, die die zu synchronisierenden Daten enthalten.
Erstellen Sie eine neue Connected Source im Braze-Dashboard.
Testen Sie die Integration.
Verwenden Sie die Connected Source, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Wichtig

Beim Verbinden mit Classic- und Pro-SQL-Instanzen kann es zwei bis fünf Minuten Aufwärmzeit geben, was zu Verzögerungen bei der Verbindungseinrichtung und beim Testen sowie bei der Erstellung und Aktualisierung von CDI-Segmenterweiterungen führt. Die Verwendung einer serverlosen SQL-Instanz minimiert die Aufwärmzeit und verbessert den Abfragedurchsatz, kann jedoch zu etwas höheren Integrationskosten führen.

Erstellen Sie einen Dienstprinzipal und gewähren Sie Zugriff auf den Fabric-Workspace, der für Ihre Integration verwendet wird.
Richten Sie in Ihrem Fabric-Workspace die Quelldaten ein und erteilen Sie Ihrem Dienstprinzipal Berechtigungen.
Erstellen Sie eine neue Connected Source im Braze-Dashboard.
Testen Sie die Integration.
Verwenden Sie die Connected Source, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Schritt 2: Data Warehouse einrichten

Richten Sie die Quelldaten und die erforderlichen Ressourcen in Ihrer Data-Warehouse-Umgebung ein. Die Connected Source kann auf eine oder mehrere Tabellen verweisen. Stellen Sie daher sicher, dass Ihre Braze-Nutzer:in Zugriff auf alle Tabellen hat, die Sie in der Connected Source verwenden möchten.

Schritt 2.1: Rolle erstellen und Berechtigungen erteilen

Erstellen Sie eine Rolle für Ihre Connected Source. Diese Rolle wird verwendet, um die Liste der verfügbaren Tabellen in Ihren CDI-Segmenterweiterungen zu generieren und Quelltabellen abzufragen, um neue Segmente zu erstellen. Nachdem die Connected Source erstellt wurde, erkennt Braze die Namen und Beschreibungen aller Tabellen, die der Nutzer:in im Quellschema zur Verfügung stehen.

Die Berechtigung create table ist erforderlich, damit Braze eine Tabelle mit den Abfrageergebnissen Ihrer CDI-Segmenterweiterung erstellen kann, bevor das Segment in Braze aktualisiert wird. Braze erstellt eine temporäre Tabelle pro Segment, die nur so lange bestehen bleibt, wie Braze das Segment aktualisiert.

CREATE ROLE BRAZE_INGESTION_ROLE;

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

-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Schritt 2.2: 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

Für das Warehouse muss das Auto-Resume-Flag aktiviert sein. Falls nicht, müssen Sie Braze zusätzliche OPERATE-Berechtigungen für das Warehouse erteilen, damit Braze es aktivieren kann, wenn die Abfrage ausgeführt werden soll.

Schritt 2.3: Nutzer:in einrichten

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Sie werden die Verbindungsinformationen mit Braze teilen und in einem späteren Schritt einen Public Key erhalten, den Sie der Nutzer:in anhängen.

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 anlegen. Innerhalb eines Workspace können Sie dieselbe Nutzer:in für verschiedene Integrationen wiederverwenden. Die Integrationserstellung schlägt jedoch fehl, wenn eine Nutzer:in desselben Snowflake-Kontos über mehrere Workspaces hinweg dupliziert wird.

Schritt 2.4: Braze-IPs in Ihrer 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 hierzu 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 2.1: Nutzer:in erstellen und Berechtigungen erteilen

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

Erstellen Sie eine Nutzer:in für Ihre Connected Source. Diese Nutzer:in wird verwendet, um die Liste der verfügbaren Tabellen in Ihren CDI-Segmenterweiterungen zu generieren und Quelltabellen abzufragen, um neue Segmente zu erstellen. Nachdem die Connected Source erstellt wurde, erkennt Braze die Namen und Beschreibungen aller Tabellen, die der Nutzer:in im Quellschema zur Verfügung stehen. Wenn Sie mehrere CDI-Integrationen erstellen, möchten Sie möglicherweise Berechtigungen auf Schema-Ebene erteilen oder Berechtigungen über eine Gruppe verwalten.

Sie können Zugriff auf alle Tabellen in einem Schema gewähren oder Berechtigungen nur für bestimmte Tabellen erteilen. Alle Tabellen, auf die die Braze-Rolle Zugriff hat, können in der CDI-Segmenterweiterung abgefragt werden. Stellen Sie sicher, dass Sie der Nutzer:in bei der Erstellung neuer Tabellen Zugriff gewähren oder Standardberechtigungen für die Nutzer:in festlegen.

Schritt 2.2: Zugriff für Braze-IPs gewähren

Wenn Sie eine Firewall oder andere Netzwerkrichtlinien verwenden, müssen Sie Braze Netzwerkzugriff auf Ihre Redshift-Instanz gewähren. Erlauben Sie den Zugriff von den folgenden IPs, die der Region Ihres Braze-Dashboards entsprechen.

Möglicherweise müssen Sie auch Ihre Sicherheitsgruppen ändern, um Braze Zugriff auf Ihre Daten in Redshift zu gewähren. Stellen Sie sicher, dass Sie eingehenden Datenverkehr auf den IPs im folgenden Abschnitt 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 eingehenden Regeln auf „Alle zulassen“ eingestellt sind. Darüber hinaus ist es wichtig, dass der Endpunkt für den Redshift-Cluster öffentlich zugänglich ist, 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, um einen SSH-Tunnel für den Zugriff auf die Redshift-Daten zu verwenden. Weitere Informationen finden Sie unter AWS: Wie greife ich von meinem lokalen Computer auf einen privaten Amazon-Redshift-Cluster zu?

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.1: Zugangsdaten für Braze erstellen

Erstellen Sie ein Dienstkonto in GCP, das Braze zum Verbinden und Lesen von Daten aus Ihrer/Ihren Tabelle(n) verwendet. Das Dienstkonto sollte die folgenden Berechtigungen haben:

BigQuery Connection User: Ermöglicht Braze, Verbindungen herzustellen.
BigQuery User: Gibt Braze Zugriff zum Ausführen von Abfragen, Lesen von Datensatz-Metadaten und Auflisten von Tabellen.
BigQuery Data Viewer: Gibt Braze Zugriff zum Anzeigen von Datensätzen und deren Inhalten.
BigQuery Job User: Gibt Braze Zugriff zum Ausführen von Jobs.
bigquery.tables.create Gibt Braze Zugriff zum Erstellen temporärer Tabellen während der Segment-Aktualisierung.

Erstellen Sie ein Dienstkonto für Ihre Connected Source. Diese Nutzer:in wird verwendet, um die Liste der verfügbaren Tabellen in Ihren CDI-Segmenterweiterungen zu generieren und Quelltabellen abzufragen, um neue Segmente zu erstellen. Nachdem die Connected Source erstellt wurde, erkennt Braze die Namen und Beschreibungen aller Tabellen, die der Nutzer:in im Quellschema zur Verfügung stehen.

Sie können Zugriff auf alle Tabellen in einem Datensatz gewähren oder Berechtigungen nur für bestimmte Tabellen erteilen. Alle Tabellen, auf die die Braze-Rolle Zugriff hat, können in der CDI-Segmenterweiterung abgefragt werden.

Braze kann auf das Dienstkonto über Workload Identity Federation oder einen Dienstkontoschlüssel zugreifen. Vorhandene Dienstkontoschlüssel-Zugangsdaten funktionieren weiterhin und müssen nicht migriert werden. Eine Workload-Identity-Federation-Zugangsdaten können sowohl für BigQuery- als auch für Google Cloud Storage-Quellen verwendet werden.

workload identity federation
dienstkontoschlüssel

Richten Sie einen Workload-Identity-Pool, einen Anbieter und das Dienstkonto ein und binden Sie den Braze-Prinzipal an das Dienstkonto. Die Schritte finden Sie unter Google Cloud für Workload Identity Federation konfigurieren. Wenn Sie Workload Identity Federation bereits für eine andere BigQuery- oder Google Cloud Storage-Quelle eingerichtet haben, müssen Sie dies nicht wiederholen. Erteilen Sie dem vorhandenen Dienstkonto die in diesem Schritt aufgeführten Berechtigungen.

Generieren Sie nach dem Erstellen des Dienstkontos und dem Erteilen der Berechtigungen einen JSON-Schlüssel. Weitere Informationen finden Sie unter Google Cloud: Dienstkontoschlüssel erstellen und löschen. Sie laden diesen später in das Braze-Dashboard hoch.

Schritt 2.2: Zugriff für Braze-IPs gewähren

Wenn Sie Netzwerkrichtlinien verwenden, 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 2.1: Zugangsdaten für Braze erstellen

Braze kann sich über OAuth-Machine-to-Machine-Authentifizierung (M2M) mit einem Dienstprinzipal oder mit einem persönlichen Zugriffstoken mit Databricks verbinden. Braze empfiehlt OAuth M2M. Vorhandene persönliche Zugriffstoken-Zugangsdaten funktionieren weiterhin und müssen nicht migriert werden.

Unabhängig von der gewählten Methode verwendet Braze diese Zugangsdaten, um die Liste der verfügbaren Tabellen in Ihren CDI-Segmenterweiterungen zu generieren und Quelltabellen abzufragen, um neue Segmente zu erstellen. Nachdem die Connected Source erstellt wurde, erkennt Braze die Namen und Beschreibungen aller Tabellen, die der Nutzer:in im Quellschema zur Verfügung stehen.

Die Berechtigung CREATE TABLE ist erforderlich, damit Braze eine Tabelle mit den Abfrageergebnissen Ihrer CDI-Segmenterweiterung erstellen kann, bevor das Segment in Braze aktualisiert wird. Braze erstellt eine temporäre Tabelle pro Segment, die nur so lange bestehen bleibt, wie Braze das Segment aktualisiert.

oauth m2m
persönliches zugriffstoken

Erstellen Sie einen Dienstprinzipal, generieren Sie ein Client-Geheimnis und erteilen Sie dem Dienstprinzipal die Berechtigung Can use für Ihr SQL-Warehouse. Die Schritte finden Sie unter Zugangsdaten für Braze erstellen.
Erteilen Sie dem Dienstprinzipal Zugriff auf das Schema, das für die Connected Source verwendet wird, einschließlich CREATE TABLE. Verwenden Sie die Anwendungs-ID des Dienstprinzipals (denselben Wert wie die Client-ID) als Begünstigten.

GRANT USE CATALOG ON CATALOG `BRAZE-CLOUD-PRODUCTION` TO `APPLICATION_ID`;
GRANT USE SCHEMA, CREATE TABLE ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;
GRANT SELECT ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;

Ersetzen Sie APPLICATION_ID durch die Anwendungs-ID Ihres Dienstprinzipals.

Bewahren Sie die Client-ID und das Geheimnis an einem sicheren Ort auf, bis Sie sie im Braze-Dashboard während des Schritts zur Erstellung der Zugangsdaten eingeben müssen.

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.
Stellen Sie sicher, dass das Dienstkonto CREATE TABLE-Berechtigungen für das Schema hat, das für die Connected Source verwendet wird.
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 im Braze-Dashboard während des Schritts zur Erstellung der Zugangsdaten eingeben müssen.

Schritt 2.2: Zugriff für Braze-IPs gewähren

Wenn Sie Netzwerkrichtlinien verwenden, 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 2.1: Zugriff auf Fabric-Ressourcen gewähren

Braze verbindet sich mit Ihrem Fabric-Warehouse über einen Dienstprinzipal mit Entra-ID-Authentifizierung. Sie erstellen einen neuen Dienstprinzipal für Braze und gewähren nach Bedarf Zugriff auf Fabric-Ressourcen. Braze benötigt die folgenden Details für die 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 kein unbegrenztes Ablaufdatum für Dienstprinzipal-Geheimnisse. Denken Sie daran, die Zugangsdaten vor ihrem Ablauf zu aktualisieren, um den Datenfluss zu Braze aufrechtzuerhalten.

Schritt 2.2: Zugriff auf Fabric-Ressourcen gewähren

Sie gewähren Braze Zugriff, um eine Verbindung zu Ihrer Fabric-Instanz herzustellen. Navigieren Sie in Ihrem Fabric-Admin-Portal zu Einstellungen > Governance und Insights > Admin-Portal > Mandanteneinstellungen.

Aktivieren Sie unter Entwicklereinstellungen die Option „Dienstprinzipale können Fabric-APIs verwenden“, damit Braze über Microsoft Entra ID eine Verbindung herstellen kann.
Aktivieren Sie unter OneLake-Einstellungen die Option „Nutzer:innen können mit Apps außerhalb von Fabric auf in OneLake gespeicherte Daten zugreifen“, damit der Dienstprinzipal von einer externen App auf Daten zugreifen kann.

Schritt 2.3: Warehouse-Verbindungszeichenfolge abrufen

Sie benötigen den SQL-Endpunkt Ihres Warehouse, damit Braze eine Verbindung herstellen kann. Um den SQL-Endpunkt abzurufen, gehen Sie zum Workspace in Fabric, bewegen Sie den Mauszeiger in der Liste der Elemente über den Warehouse-Namen und wählen Sie SQL-Verbindungszeichenfolge kopieren. Halten Sie diesen Wert für die Einrichtung der Zugangsdaten in Schritt 3 bereit.

Schritt 2.4: 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 ermöglichen. 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 3: Connected Source im Braze-Dashboard erstellen

Schritt 3.1: Snowflake-Verbindungsinformationen und Quelltabelle hinzufügen

Erstellen Sie eine Connected Source im Braze-Dashboard. Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Connected Sources, wählen Sie Datenquelle hinzufügen und dann Snowflake.

Geben Sie unter Quelle einrichten Folgendes ein:

Zugangsdaten: Account Locator, Nutzername und Rolle
Konfiguration: Warehouse, Datenbank und Schema

Wenn Sie neue Snowflake-Zugangsdaten erstellen, wählen Sie Zugangsdaten speichern und RSA-Schlüssel generieren, bevor Sie die Verbindung testen.

Schritt 3.2: Sync-Details konfigurieren

Wählen Sie einen Namen für die Connected Source. Dieser Name wird in der Liste der verfügbaren Quellen angezeigt, wenn Sie eine neue CDI-Segmenterweiterung erstellen.

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht automatisch alle Abfragen ab, die die maximale Laufzeit überschreiten. Die maximal zulässige Laufzeit beträgt 60 Minuten; eine kürzere Laufzeit reduziert die Kosten, die auf Ihrem Snowflake-Konto anfallen. Diese Einstellung gilt für Abfragen, die über diese Quelle ausgeführt werden, einschließlich Syncs und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Wenn Abfragen regelmäßig ein Timeout erreichen und Sie eine maximale Laufzeit von 60 Minuten eingestellt haben, versuchen Sie, die Abfrageausführungszeit zu optimieren oder der Braze-Nutzer:in ein größeres Warehouse zuzuweisen.

Schritt 3.3: Public Key notieren

Notieren Sie sich im Schritt Verbindung testen den RSA-Public-Key. Sie benötigen ihn, um die Integration in Snowflake abzuschließen.

Schritt 3.1: Redshift-Verbindungsinformationen und Quelltabelle hinzufügen

Geben Sie unter Quelle einrichten Folgendes ein:

Zugangsdaten: Redshift-Host-URL, Nutzername, Passwort und Port
Konfiguration: Datenbank und Schema

Aktivieren Sie bei Bedarf Mit SSH-Tunnel verbinden und geben Sie Tunnel-Host, Tunnel-Port und Tunnel-Nutzername ein.

Schritt 3.2: Sync-Details konfigurieren

Wählen Sie einen Namen für die Connected Source. Dieser Name wird in der Liste der verfügbaren Quellen angezeigt, wenn Sie eine neue CDI-Segmenterweiterung erstellen.

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht automatisch alle Abfragen ab, die die maximale Laufzeit überschreiten. Die maximal zulässige Laufzeit beträgt 60 Minuten; eine kürzere Laufzeit reduziert die Kosten, die auf Ihrem Redshift-Konto anfallen. Diese Einstellung gilt für Abfragen, die über diese Quelle ausgeführt werden, einschließlich Syncs und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Schritt 3.3: Public Key notieren (optional)

Wenn bei Ihren Zugangsdaten Mit SSH-Tunnel verbinden ausgewählt ist, notieren Sie sich den RSA-Public-Key im Schritt Verbindung testen. Sie benötigen ihn, um die Integration in Redshift abzuschließen.

Schritt 3.1: BigQuery-Verbindungsinformationen und Quelltabelle hinzufügen

Geben Sie unter Quelle einrichten Folgendes ein:

Zugangsdaten: Name der Zugangsdaten und Authentifizierungsmethode sowie entweder Projektnummer, Workload-Identity-Pool-ID, Anbieter-ID und Dienstkonto-E-Mail (Workload Identity Federation) oder Ihren hochgeladenen JSON-Schlüssel (Dienstkontoschlüssel)
Konfiguration: Projekt und Datensatz

Schritt 3.2: Sync-Details konfigurieren

Wählen Sie einen Namen für die Connected Source. Dieser Name wird in der Liste der verfügbaren Quellen angezeigt, wenn Sie eine neue CDI-Segmenterweiterung erstellen.

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht automatisch alle Abfragen ab, die die maximale Laufzeit überschreiten. Die maximal zulässige Laufzeit beträgt 60 Minuten; eine kürzere Laufzeit reduziert die Kosten, die auf Ihrem BigQuery-Konto anfallen. Diese Einstellung gilt für Abfragen, die über diese Quelle ausgeführt werden, einschließlich Syncs und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Schritt 3.3: Verbindung testen

Wählen Sie Verbindung testen, um zu überprüfen, ob die Liste der für die Nutzer:in sichtbaren Tabellen Ihren Erwartungen entspricht, und wählen Sie dann Fertig. Ihre Connected Source ist jetzt erstellt und bereit für die Verwendung in CDI-Segmenterweiterungen.

Schritt 3.1: Databricks-Verbindungsinformationen und Quelltabelle hinzufügen

Geben Sie unter Quelle einrichten Folgendes ein:

Zugangsdaten: Name der Zugangsdaten, Authentifizierungsmethode, Hostname und HTTP-Pfad sowie entweder Client-ID und Client-Geheimnis (OAuth M2M) oder Zugriffstoken (persönliches Zugriffstoken)
Konfiguration: Katalog und Schema

Schritt 3.2: Sync-Details konfigurieren

Wählen Sie einen Namen für die Connected Source. Dieser Name wird in der Liste der verfügbaren Quellen angezeigt, wenn Sie eine neue CDI-Segmenterweiterung erstellen.

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht automatisch alle Abfragen ab, die die maximale Laufzeit überschreiten. Die maximal zulässige Laufzeit beträgt 60 Minuten; eine kürzere Laufzeit reduziert die Kosten, die auf Ihrem Databricks-Konto anfallen. Diese Einstellung gilt für Abfragen, die über diese Quelle ausgeführt werden, einschließlich Syncs und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Schritt 3.3: Verbindung testen

Schritt 3.1: Microsoft-Fabric-Verbindungsinformationen und Quelltabelle hinzufügen

Geben Sie unter Quelle einrichten Folgendes ein:

Zugangsdaten: Name der Zugangsdaten, Mandanten-ID, Prinzipal-ID, Client-Geheimnis und Verbindungszeichenfolge
Konfiguration: Datenbank und Schema

Wenn Mit SSH-Tunnel verbinden in Ihrem Workspace verfügbar und für Ihr Setup erforderlich ist, geben Sie auch Tunnel-Host, Tunnel-Port und Tunnel-Nutzername ein.

Schritt 3.2: Sync-Details konfigurieren

Wählen Sie einen Namen für die Connected Source. Dieser Name wird in der Liste der verfügbaren Quellen angezeigt, wenn Sie eine neue CDI-Segmenterweiterung erstellen.

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht automatisch alle Abfragen ab, die die maximale Laufzeit überschreiten. Die maximal zulässige Laufzeit beträgt 60 Minuten; eine kürzere Laufzeit reduziert die Kosten, die auf Ihrem Microsoft-Fabric-Konto anfallen. Diese Einstellung gilt für Abfragen, die über diese Quelle ausgeführt werden, einschließlich Syncs und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Schritt 3.3: Verbindung testen

Schritt 4: Data-Warehouse-Konfiguration abschließen

Fügen Sie den Public Key, den Sie im letzten Schritt notiert haben, Ihrer Nutzer:in in Snowflake hinzu. Dadurch kann Braze eine Verbindung zu Snowflake herstellen. Weitere Details hierzu finden Sie in der Snowflake-Dokumentation.

Wenn Sie die Schlüssel zu einem beliebigen Zeitpunkt rotieren möchten, können Sie einen neuen Public Key erstellen, indem Sie unter Cloud-Datenaufnahme zu Datenzugriffsverwaltung gehen und für das entsprechende Konto Neuen Schlüssel generieren wählen.

ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='{INSERT_YOUR_KEY}';

Nachdem Sie den Schlüssel der Nutzer:in in Snowflake hinzugefügt haben, wählen Sie in Braze Verbindung testen und dann Fertig. Ihre Connected Source ist jetzt erstellt und bereit für die Verwendung in CDI-Segmenterweiterungen.

Wenn Sie eine Verbindung über einen SSH-Tunnel herstellen, fügen Sie den Public Key, den Sie im letzten Schritt notiert haben, der SSH-Tunnel-Nutzer:in hinzu.

Nachdem Sie den Schlüssel der Nutzer:in hinzugefügt haben, wählen Sie in Braze Verbindung testen und dann Fertig. Ihre Connected Source ist jetzt erstellt und bereit für die Verwendung in CDI-Segmenterweiterungen.

Dies gilt nicht für BigQuery.

Dies gilt nicht für Databricks.

Dies gilt nicht für Microsoft Fabric.

Hinweis

Sie müssen eine Quelle erfolgreich testen, bevor sie vom Status „Entwurf“ in den Status „Aktiv“ wechseln kann. Wenn Sie die Erstellungsseite verlassen müssen, 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 sie sich mit einem anderen Schema verbindet. Beim Erstellen zusätzlicher Verbindungen können Sie vorhandene Zugangsdaten wiederverwenden, wenn Sie sich mit demselben Snowflake-Konto verbinden.

Wenn Sie denselben Nutzer und dieselbe Rolle über mehrere Integrationen hinweg verwenden, müssen Sie den Public Key nicht erneut hinzufügen.

Sie können mehrere Datenquellen mit Braze einrichten, aber jede Datenquelle sollte so konfiguriert werden, dass sie sich mit einem anderen Schema verbindet. Beim Erstellen zusätzlicher Datenquellen können Sie vorhandene Zugangsdaten wiederverwenden, wenn Sie sich mit demselben Redshift-Konto verbinden.

Sie können mehrere Datenquellen mit Braze einrichten, aber jede Datenquelle sollte so konfiguriert werden, dass sie sich mit einem anderen Datensatz verbindet. Beim Erstellen zusätzlicher Datenquellen können Sie vorhandene Zugangsdaten wiederverwenden, wenn Sie sich mit demselben BigQuery-Konto verbinden.

Nutzung der verbundenen Quelle

Nachdem die Quelle erstellt wurde, können Sie sie verwenden, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen. Weitere Informationen zum Erstellen eines Segments mit dieser Quelle finden Sie in der Dokumentation zu CDI-Segmenterweiterungen.

Hinweis

Wenn Abfragen regelmäßig das Zeitlimit überschreiten und Sie eine maximale Laufzeit von 60 Minuten festgelegt haben, sollten Sie versuchen, die Ausführungszeit Ihrer Abfrage zu optimieren oder der Braze-Nutzer:in mehr Rechenressourcen zuzuweisen (z. B. ein größeres Data Warehouse).

New Stuff!