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.

Verbundene Quellen integrieren

Schritt 1: Ressourcen verbinden

Verbundene Quellen für die Cloud-Datenaufnahme erfordern eine gewisse Einrichtung 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.
Je nach Ihrer Konfiguration müssen Sie möglicherweise Braze-IPs in Ihrer Snowflake-Netzwerkrichtlinie zulassen.

Im Braze-Dashboard

Erstellen Sie eine neue verbundene Quelle im Braze-Dashboard.
Konfigurieren Sie die Synchronisierungsdetails für die verbundene Quelle.
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 zur Authentifizierung an. Wenn Sie fertig sind, können Sie die verbundene Quelle verwenden, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

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

Richten Sie die Quelldaten und erforderlichen Ressourcen in Ihrer BigQuery-Umgebung ein.
Erstellen Sie ein Dienstkonto und gewähren Sie Zugriff auf die BigQuery-Projekte und -Datensätze, die die zu synchronisierenden Daten enthalten.
Erstellen Sie eine neue verbundene Quelle im Braze-Dashboard.
Testen Sie die Integration.
Verwenden Sie die verbundene Quelle, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Richten Sie die Quelldaten und erforderlichen Ressourcen in Ihrer Databricks-Umgebung ein.
Erstellen Sie ein Dienstkonto und gewähren Sie Zugriff auf die Databricks-Projekte und -Datensätze, die die zu synchronisierenden Daten enthalten.
Erstellen Sie eine neue verbundene Quelle im Braze-Dashboard.
Testen Sie die Integration.
Verwenden Sie die verbundene Quelle, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Wichtig

Beim Verbinden von Braze mit Classic- und Pro-SQL-Instanzen kann es zu einer Aufwärmzeit von zwei bis fünf Minuten kommen, die 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 verbundene Quelle im Braze-Dashboard.
Testen Sie die Integration.
Verwenden Sie die verbundene Quelle, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Schritt 2: Data Warehouse einrichten

Richten Sie die Quelldaten und erforderlichen Ressourcen in Ihrer Data-Warehouse-Umgebung ein. Die verbundene Quelle 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 verbundenen Quelle verwenden möchten.

Schritt 2.1: Rolle erstellen und Berechtigungen erteilen

Erstellen Sie eine Rolle für Ihre verbundene Quelle. 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 verbundene Quelle 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, und die Tabelle bleibt nur bestehen, solange 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 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 das Flag auto-resume aktiviert haben. Ist dies nicht der Fall, müssen Sie Braze zusätzliche OPERATE-Berechtigungen für das Warehouse erteilen, damit Braze es einschalten 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 Verbindungsinformationen mit Braze teilen und in einem späteren Schritt einen Public Key erhalten, den Sie an die 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, aber die Integrationserstellung schlägt fehl, wenn eine Nutzer:in im selben Snowflake-Konto über mehrere Workspaces hinweg dupliziert wird.

Schritt 2.4: Braze-IPs in Ihrer 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 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

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 verbundene Quelle. 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 verbundene Quelle 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 für ein Schema 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, stehen in der CDI-Segmenterweiterung zur Abfrage zur Verfügung. Stellen Sie sicher, dass Sie der Nutzer:in Zugriff auf neue Tabellen gewähren, wenn diese erstellt werden, oder Standardberechtigungen für die Nutzer:in festlegen.

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 bestehen bleibt, solange Braze das Segment aktualisiert.

Schritt 2.2: Zugriff für Braze-IPs zulassen

Wenn Sie eine Firewall oder andere Netzwerkrichtlinien haben, 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 den Zugriff auf Ihre Daten in Redshift zu ermöglichen. 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 Eingangsregeln auf „Alle zulassen“ gesetzt 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 über einen SSH-Tunnel auf die Redshift-Daten zuzugreifen. Weitere Informationen finden Sie unter AWS: Wie greife ich von meinem lokalen Rechner 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

Schritt 2.1: 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: Bietet Braze Zugriff zum Ausführen von Abfragen, Lesen von Datensatz-Metadaten und Auflisten von Tabellen.
BigQuery Data Viewer: Bietet Braze Zugriff zum Anzeigen von Datensätzen und deren Inhalten.
BigQuery Job User: Bietet Braze Zugriff zum Ausführen von Jobs.
bigquery.tables.create Bietet Braze Zugriff zum Erstellen temporärer Tabellen während der Segmentaktualisierung.

Erstellen Sie ein Dienstkonto für Ihre verbundene Quelle. 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 verbundene Quelle 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, stehen in der CDI-Segmenterweiterung zur Abfrage zur Verfügung.

Nachdem Sie das Dienstkonto erstellt und Berechtigungen erteilt haben, generieren Sie einen JSON-Schlüssel. Weitere Informationen finden Sie unter Google Cloud: Dienstkontoschlüssel erstellen und löschen. Sie werden diesen später in das Braze-Dashboard hochladen.

Schritt 2.2: Zugriff für 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 2.1: Zugriffstoken erstellen

Damit Braze auf Databricks zugreifen kann, muss ein persönliches Zugriffstoken erstellt werden.

Wählen Sie in Ihrem Databricks-Workspace Ihren Databricks-Benutzernamen in der oberen Leiste aus und wählen Sie dann User Settings aus dem Dropdown-Menü.
Stellen Sie sicher, dass das Dienstkonto CREATE TABLE-Berechtigungen für das Schema hat, das für die verbundene Quelle 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.

Dieses Token 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 verbundene Quelle 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 bestehen bleibt, solange Braze das Segment aktualisiert.

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 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 2.1: Zugriff auf Fabric-Ressourcen gewähren

Braze stellt über einen Dienstprinzipal mit Entra-ID-Authentifizierung eine Verbindung zu Ihrem Fabric-Warehouse her. Sie erstellen einen neuen Dienstprinzipal für Braze und gewähren nach Bedarf Zugriff auf Fabric-Ressourcen. Braze benötigt die folgenden Angaben 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 keine unbegrenzte Gültigkeitsdauer für Dienstprinzipal-Geheimnisse. Denken Sie daran, die Zugangsdaten vor 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-Administratorportal zu Settings > Governance and insights > Admin portal > Tenant settings.

Aktivieren Sie unter Developer settings die Option „Service principals can use Fabric APIs“, damit Braze eine Verbindung über Microsoft Entra ID herstellen 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 auf Daten zugreifen kann.

Schritt 2.3: Warehouse-Verbindungszeichenfolge abrufen

Sie benötigen den SQL-Endpunkt für Ihr Warehouse, damit Braze eine Verbindung herstellen kann. Um den SQL-Endpunkt abzurufen, navigieren Sie zum Workspace in Fabric, bewegen Sie den Mauszeiger in der Elementliste über den Warehouse-Namen und wählen Sie Copy SQL connection string. Halten Sie diesen Wert für die Einrichtung der Zugangsdaten in Schritt 3 bereit.

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

Schritt 3: Verbundene Quelle im Braze-Dashboard erstellen

Schritt 3.1: Snowflake-Verbindungsinformationen und Quelltabelle hinzufügen

Erstellen Sie eine verbundene Quelle im Braze-Dashboard. Navigieren Sie zu Data Settings > Cloud Data Ingestion > Connected Sources, wählen Sie Add data source und dann Snowflake.

Geben Sie unter Setup source Folgendes ein:

Credentials: Account Locator, Username und Role
Configuration: Warehouse, Database und Schema

Wenn Sie neue Snowflake-Zugangsdaten erstellen, wählen Sie Save credentials and generate RSA key, bevor Sie die Verbindung testen.

Schritt 3.2: Synchronisierungsdetails konfigurieren

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

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht 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 Synchronisierungen und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Wenn Abfragen regelmäßig das Zeitlimit überschreiten und Sie eine maximale Laufzeit von 60 Minuten festgelegt haben, versuchen Sie, die Abfrageausführungszeit zu optimieren oder ein größeres Warehouse für die Braze-Nutzer:in bereitzustellen.

Schritt 3.3: Public Key notieren

Notieren Sie sich im Schritt Test connection 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 Setup source Folgendes ein:

Credentials: Redshift Host URL, Username, Password und Port
Configuration: Database und Schema

Aktivieren Sie bei Bedarf Connect with SSH Tunnel und geben Sie Tunnel Host, Tunnel Port und Tunnel Username ein.

Schritt 3.2: Synchronisierungsdetails konfigurieren

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

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht 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 Synchronisierungen und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Schritt 3.3: Public Key notieren (optional)

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

Schritt 3.1: BigQuery-Verbindungsinformationen und Quelltabelle hinzufügen

Geben Sie unter Setup source Folgendes ein:

Credentials: Credential name und laden Sie Ihren JSON key hoch
Configuration: Project und Dataset

Schritt 3.2: Synchronisierungsdetails konfigurieren

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

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht 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 Synchronisierungen und CDI-Segmenterweiterungen, die sie verwenden.

Hinweis

Schritt 3.3: Verbindung testen

Wählen Sie Test Connection, um zu überprüfen, ob die für die Nutzer:in sichtbare Tabellenliste Ihren Erwartungen entspricht, und wählen Sie dann Done. Ihre verbundene Quelle ist jetzt erstellt und kann in CDI-Segmenterweiterungen verwendet werden.

Schritt 3.1: Databricks-Verbindungsinformationen und Quelltabelle hinzufügen

Geben Sie unter Setup source Folgendes ein:

Credentials: Credential Name, Hostname, HTTP Path und Access Token
Configuration: Catalog und Schema

Schritt 3.2: Synchronisierungsdetails konfigurieren

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

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht 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 Synchronisierungen 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 Setup source Folgendes ein:

Credentials: Credentials Name, Tenant ID, Principal ID, Client Secret und Connection String
Configuration: Database und Schema

Wenn Connect with SSH Tunnel in Ihrem Workspace verfügbar und für Ihre Einrichtung erforderlich ist, geben Sie auch Tunnel Host, Tunnel Port und Tunnel Username ein.

Schritt 3.2: Synchronisierungsdetails konfigurieren

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

Konfigurieren Sie eine maximale Laufzeit für diese Quelle. Braze bricht 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 Synchronisierungen 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. Einzelheiten dazu 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 Data Ingestion zu Data Access Management navigieren und Generate New Key für das entsprechende Konto auswä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 Test Connection und dann Done. Ihre verbundene Quelle ist jetzt erstellt und kann in CDI-Segmenterweiterungen verwendet werden.

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 Test Connection und dann Done. Ihre verbundene Quelle ist jetzt erstellt und kann in CDI-Segmenterweiterungen verwendet werden.

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 schließen 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.

Verwendung 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 dem Braze-Nutzer:in mehr Rechenressourcen zuzuweisen (z. B. ein größeres Data Warehouse).

New Stuff!