Sources connectées

Dans votre entrepôt de données

1. Créez un rôle et accordez des autorisations pour interroger et créer des tables dans un schéma.
2. Configurez votre entrepôt et donnez l’accès à ce rôle.
3. Créez un utilisateur pour ce rôle.
4. En fonction de votre configuration, vous devrez peut-être autoriser les IP de Braze dans votre politique de réseau Snowflake.

Dans le tableau de bord de Braze

5. Créez une nouvelle source connectée dans le tableau de bord de Braze. 6. Configurez les détails de la synchronisation pour la source connectée. 7. Récupérez la clé publique fournie dans le tableau de bord de Braze.

Dans votre entrepôt de données

8. Ajoutez la clé publique fournie dans le tableau de bord de Braze à l’utilisateur Snowflake pour l’authentification. Lorsque vous avez terminé, vous pouvez utiliser la source connectée pour créer un ou plusieurs segments CDI.

Étape 2.1 : Créer un rôle et accorder des autorisations

Créez un rôle pour votre source connectée. Ce rôle sera utilisé pour générer la liste des tables disponibles dans vos segments CDI, et pour interroger les tables sources afin de créer de nouveaux segments. Après la création de la source connectée, Braze découvre les noms et la description de toutes les tables disponibles pour l’utilisateur dans le schéma de la source.

Vous pouvez choisir d’accorder l’accès à toutes les tables d’un schéma ou d’accorder des privilèges uniquement à des tables spécifiques. Les tables auxquelles le rôle Braze a accès pourront être interrogées dans le segment CDI.

L’autorisation create table est nécessaire pour que Braze puisse créer une table avec les résultats de votre requête de segment CDI avant de mettre à jour le segment dans Braze. Braze créera une table temporaire par segment, et la table ne persistera que pendant que Braze met à jour le segment.

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;

Étape 2.2 : Définir l’entrepôt et donner accès au rôle Braze

1
2
3
CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Étape 2.3 : Configurer l’utilisateur

1
2
3
CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Vous partagerez les informations de connexion avec Braze et recevrez une clé publique à ajouter à l’utilisateur lors d’une étape ultérieure.

Étape 2.4 : Autoriser les IP de Braze dans votre politique de réseau Snowflake (optionnel)

Selon la configuration de votre compte Snowflake, vous pourrez avoir à autoriser les adresses IP suivantes au sein de votre politique réseau Snowflake. Pour plus d’informations sur cette opération, consultez la documentation pertinente de Snowflake sur la modification d’une politique de réseau.

• united states (us)
• european union (eu)

Étape 3.1 : Ajouter les informations de connexion et la table source de Snowflake

Créez une source connectée dans le tableau de bord de Braze. Accédez à Paramètres des données > Ingestion de données dans le cloud > Sources connectées, puis sélectionnez Créer une nouvelle synchronisation de données > Importation Snowflake.

Saisissez les informations relatives à votre entrepôt de données Snowflake et à votre schéma source, puis passez à l’étape suivante.

Étape 3.2 : Configurer les détails de la synchronisation

Choisissez un nom pour la source connectée. Ce nom sera utilisé dans la liste des sources disponibles lorsque vous créerez un nouveau segment CDI.

Configurez une durée d’exécution maximale pour cette source. Lors de la création ou de l’actualisation d’un segment, Braze interrompt automatiquement les requêtes qui dépassent la durée d’exécution maximale. La durée d’exécution maximale autorisée est de 60 minutes. Une durée d’exécution inférieure réduira les coûts encourus sur votre compte Snowflake.

Étape 3.3 : Notez la clé publique

Dans l’étape Test connection, notez la clé publique RSA. Vous en aurez besoin pour réaliser l’intégration dans Snowflake.

Ajoutez la clé publique que vous avez notée lors de la dernière étape à votre utilisateur dans Snowflake. Cela permettra à Braze de se connecter à Snowflake. Pour plus de détails sur la façon de procéder, consultez la documentation Snowflake.

Si vous souhaitez effectuer une rotation des clés à un moment donné, vous pouvez créer une nouvelle clé publique en allant dans Gestion de l’accès aux données dans Cloud Data Ingestion et en sélectionnant Générer une nouvelle clé pour le compte concerné.

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

Après avoir ajouté la clé à l’utilisateur dans Snowflake, sélectionnez Tester la connexion dans Braze, puis Terminé. Votre source connectée est maintenant créée et prête à être utilisée dans les segmentations CDI.

Vous pouvez configurer plusieurs intégrations avec Braze, mais chaque intégration doit être configurée pour connecter un schéma différent. Lors de la création de connexions supplémentaires, vous pouvez réutiliser les informations d’identification existantes si vous vous connectez au même compte Snowflake.

Si vous réutilisez le même utilisateur et le même rôle d’une intégration à l’autre, vous n’aurez pas besoin d’ajouter à nouveau la clé publique.