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 du tableau de bord de Braze à l’utilisateur Snowflake pour l’authentification. Une fois terminé, vous pouvez utiliser la source connectée pour créer une ou plusieurs Extensions de 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 Extensions de 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écouvrira les noms et la description de toutes les tables disponibles pour l’utilisateur dans le schéma 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. Toutes les tables auxquelles le rôle Braze a accès pourront être interrogées dans l’Extension de segments CDI.

L’autorisation create table est nécessaire pour que Braze puisse créer une table avec les résultats de votre requête d’Extension de segments 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 : Configurer 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;

Remarque

L’indicateur de reprise automatique doit être activé sur l’entrepôt. Si ce n’est pas le cas, vous devrez accorder à Braze des privilèges supplémentaires OPERATE sur l’entrepôt pour que Braze puisse l’activer au moment de l’exécution de la requête.

É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.

Remarque

Lorsque vous connectez différents espaces de travail au même compte Snowflake, vous devez créer un utilisateur unique pour chaque espace de travail Braze dans lequel vous créez une intégration. Au sein d’un espace de travail, vous pouvez réutiliser le même utilisateur entre les intégrations, mais la création d’une intégration échouera si un utilisateur du même compte Snowflake est dupliqué entre les espaces de travail.

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

Selon la configuration de votre compte Snowflake, vous devrez peut-être autoriser les adresses IP suivantes dans votre politique de réseau Snowflake. Pour plus d’informations, consultez la documentation Snowflake sur la modification d’une politique de réseau.

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

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

Créez une source connectée dans le tableau de bord de Braze. Accédez à Data Settings > Cloud Data Ingestion > Connected Sources, puis sélectionnez Create new data sync > Snowflake Import.

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 une nouvelle Extension de segments CDI.

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

Remarque

Si les requêtes expirent systématiquement alors que vous avez défini une durée d’exécution maximale de 60 minutes, essayez d’optimiser le temps d’exécution de vos requêtes ou de dédier un entrepôt plus important à l’utilisateur Braze.

Étape 3.3 : Noter la clé publique

Dans l’étape Test connection, notez la clé publique RSA. Vous en aurez besoin pour finaliser 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, 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 accédant à Data Access Management dans Cloud Data Ingestion et en sélectionnant Generate New Key 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 Test Connection dans Braze, puis sélectionnez Done. Votre source connectée est désormais créée et prête à être utilisée dans les Extensions de segments 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 identifiants existants 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.