Verbundene Quellen

In Ihrem Data Warehouse

1. Erstellen Sie eine Rolle und erteilen Sie ihr Berechtigungen, um Tabellen in einem Schema abzufragen und zu erstellen.
2. Richten Sie Ihr Warehouse ein und gewähren Sie dieser Rolle Zugriff.
3. Erstellen Sie für diese Rolle eine:n Nutzer:in mit Workload Identity Federation oder einem RSA-Schlüsselpaar.
4. Je nach Konfiguration müssen Sie die IPs von Braze in Ihrer Snowflake-Netzwerkrichtlinie zulassen.

Im Braze-Dashboard

5. Erstellen Sie im Braze-Dashboard eine neue verbundene Quelle.
6. Konfigurieren Sie die Synchronisierungsdetails für die verbundene Quelle.
7. Rufen Sie bei einem RSA-Schlüsselpaar den Public Key ab. Kopieren Sie bei Workload Identity Federation die Anweisung aus dem Formular für die Zugangsdaten.

In Ihrem Data Warehouse

8. Hängen Sie bei einem RSA-Schlüsselpaar den Public Key an die Snowflake-Nutzer:in für die Authentifizierung an. Führen Sie bei Workload Identity Federation die Anweisung in einem Snowflake-Worksheet aus. Anschließend können Sie die verbundene Quelle verwenden, um eine oder mehrere CDI-Segmenterweiterungen zu erstellen.

Schritt 2.1: Rolle erstellen und Berechtigungen erteilen

Erstellen Sie eine Rolle, die Ihre verbundene Quelle verwenden soll. Mit dieser Rolle wird die Liste der in Ihren CDI-Segmenterweiterungen verfügbaren Tabellen erstellt, und Quelltabellen werden abgefragt, um neue Segmente zu erstellen. Nachdem die verbundene Quelle erstellt wurde, ermittelt Braze die Namen und Beschreibungen aller Tabellen, die der Nutzer:in im Quellschema zur Verfügung stehen.

Sie können Zugriff auf alle Tabellen eines Schemas 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.

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

1
2
3
4
5
6
7
8
9
10
11
12
13

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

1
2
3

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Hinweis

Für das Warehouse muss das Flag auto-resume aktiviert sein. Ist das nicht der Fall, 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

Braze authentifiziert sich bei Snowflake mit Workload Identity Federation oder einem RSA-Schlüsselpaar. Bestehende Zugangsdaten mit RSA-Schlüsselpaar funktionieren weiterhin, und Sie müssen sie nicht migrieren. Folgen Sie einer der beiden Methoden.

• workload identity federation
• key pair

1
2
3

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

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 mehrere Integrationen wiederverwenden. Die Erstellung der Integration schlägt jedoch fehl, wenn eine Nutzer:in desselben Snowflake-Kontos in mehreren Workspaces verwendet wird.

Schritt 2.4: IPs von Braze in Ihrer Snowflake-Netzwerkrichtlinie zulassen (optional)

Je nach Konfiguration Ihres Snowflake-Kontos müssen Sie die folgenden IP-Adressen in Ihrer Snowflake-Netzwerkrichtlinie zulassen. Weitere Informationen finden Sie in der Snowflake-Dokumentation zum Ändern einer Netzwerkrichtlinie.

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)

Schritt 3.1: Snowflake-Verbindungsinformationen und Quelltabelle hinzufügen

Erstellen Sie im Braze-Dashboard eine verbundene Quelle. Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Verbundene Quellen, wählen Sie Datenquelle hinzufügen und dann Snowflake aus.

Geben Sie unter Quelle einrichten Folgendes ein:

• Name der Zugangsdaten und die Authentifizierungsmethode, Workload Identity Federation oder Schlüsselpaar
• Zugangsdaten: Account Locator, Nutzername und Rolle
• Konfiguration: Warehouse, Datenbank und Schema

Wählen Sie bei Workload Identity Federation Anweisung kopieren aus, führen Sie die Anweisung in einem Snowflake-Worksheet aus und wählen Sie dann Zugangsdaten speichern aus. Wählen Sie bei einem Schlüsselpaar Zugangsdaten speichern und RSA-Schlüssel generieren aus, 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 senkt die Kosten, die für Ihr Snowflake-Konto anfallen. Diese Einstellung gilt für Abfragen, die über diese Quelle ausgeführt werden, einschließlich Synchronisierungen und CDI-Segmenterweiterungen, die die Quelle verwenden.

Hinweis

Wenn bei Abfragen regelmäßig Zeitüberschreitungen auftreten 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 ein größeres Warehouse zuzuweisen.

Schritt 3.3: Public Key notieren (Schlüsselpaar)

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

• workload identity federation
• key pair

1

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

Sie können mehrere Integrationen mit Braze einrichten, aber jede Integration sollte so konfiguriert werden, dass sie sich mit einem anderen Schema verbindet. Wenn Sie zusätzliche Verbindungen erstellen, können Sie vorhandene Zugangsdaten wiederverwenden, sofern Sie sich mit demselben Snowflake-Konto verbinden.

Wenn Sie dieselbe Key-Pair-Nutzer:in und Rolle für mehrere Integrationen wiederverwenden, müssen Sie den Public Key nicht erneut hinzufügen. Für Zugangsdaten mit Workload Identity Federation gibt es keinen Public Key, der hinzugefügt werden muss.