Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Sources connectées

Les sources connectées constituent une alternative en zéro copie à la synchronisation directe des données avec la fonctionnalité d’ingestion de données cloud (CDI) de Braze. Une source connectée interroge directement votre entrepôt de données pour créer de nouveaux segments sans copier les données sous-jacentes dans Braze.

Après avoir ajouté une source connectée à votre espace de travail Braze, vous pouvez créer un segment CDI dans les extensions de segments. Les extensions de segments CDI vous permettent d’écrire du code SQL qui interroge directement votre entrepôt de données (en utilisant les données rendues disponibles via votre source connectée CDI) et de créer et gérer un groupe d’utilisateurs pouvant être ciblés dans Braze.

Pour plus d’informations sur la création d’un segment avec cette source, consultez les extensions de segments CDI.

Avertissement

Étant donné que les sources connectées s’exécutent directement sur votre entrepôt de données, vous supporterez tous les coûts liés à l’exécution de ces requêtes dans votre entrepôt de données. Les sources connectées n’enregistrent pas de points de données et les extensions de segments CDI ne consomment pas de crédits de segments SQL.

Intégration des sources connectées

Étape 1 : Connecter vos ressources

Les sources connectées de Cloud Data Ingestion nécessitent une configuration dans Braze et dans votre instance. Suivez ces étapes pour mettre en place l’intégration : certaines étapes seront réalisées dans votre entrepôt de données et d’autres dans votre tableau de bord de Braze.

Dans votre entrepôt de données

Créez un rôle et accordez les autorisations nécessaires pour interroger et créer des tables dans un schéma.
Configurez votre entrepôt et donnez accès à ce rôle.
Créez un utilisateur pour ce rôle.
Selon votre configuration, vous devrez peut-être autoriser les adresses IP de Braze dans votre politique réseau Snowflake.

Dans le tableau de bord de Braze

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

Dans votre entrepôt de données

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.

Configurez les données sources et les ressources requises dans votre environnement Redshift.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Configurez les données sources et les ressources requises dans votre environnement BigQuery.
Créez un compte de service et autorisez l’accès au(x) projet(s) et jeu(x) de données BigQuery contenant les données que vous souhaitez synchroniser.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Configurez les données sources et les ressources requises dans votre environnement Databricks.
Créez un principal de service (OAuth M2M) ou un jeton d’accès personnel, et autorisez l’accès aux catalogues et schémas Databricks contenant les données que vous souhaitez synchroniser.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Important

Il peut y avoir deux à cinq minutes de temps de préchauffage lorsque Braze se connecte aux instances SQL Classic et Pro, ce qui entraînera des délais lors de la configuration et des tests de connexion, ainsi que lors de la création et de l’actualisation des extensions de segments CDI. L’utilisation d’une instance SQL serverless réduira le temps de préchauffage et améliorera le débit des requêtes, mais pourra entraîner des coûts d’intégration légèrement plus élevés.

Créez un principal de service et autorisez l’accès à l’espace de travail Fabric qui sera utilisé pour votre intégration.
Dans votre espace de travail Fabric, configurez les données sources et accordez les autorisations à votre principal de service.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Étape 2 : Configurer votre entrepôt de données

Configurez les données sources et les ressources requises dans votre environnement d’entrepôt de données. La source connectée peut référencer une ou plusieurs tables. Assurez-vous donc que votre utilisateur Braze dispose des autorisations d’accès à toutes les tables souhaitées dans la source connectée.

Étape 2.1 : Créer un rôle et accorder les 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. Une fois la source connectée créée, Braze découvrira les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source.

L’autorisation create table est requise 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 la mise à jour du segment par Braze.

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

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Remarque

L’entrepôt doit avoir l’option auto-resume activée. Si ce n’est pas le cas, vous devrez accorder à Braze des privilèges OPERATE supplémentaires sur l’entrepôt afin que Braze puisse l’activer au moment d’exécuter la requête.

Étape 2.3 : Configurer l’utilisateur

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 pour plusieurs intégrations, mais la création d’une intégration échouera si un utilisateur du même compte Snowflake est dupliqué entre plusieurs espaces de travail.

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

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

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Créer un utilisateur et accorder les autorisations

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;

Créez un utilisateur pour votre source connectée. Cet utilisateur 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. Une fois la source connectée créée, Braze découvrira les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source. Si vous créez plusieurs intégrations CDI, vous pouvez accorder des autorisations au niveau du schéma ou gérer les autorisations à l’aide d’un groupe.

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 seront disponibles pour les requêtes dans l’extension de segments CDI. Veillez à accorder l’accès aux nouvelles tables à l’utilisateur lors de leur création, ou à définir des autorisations par défaut pour l’utilisateur.

L’autorisation create table est requise 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, qui ne persistera que pendant la mise à jour du segment par Braze.

Étape 2.2 : Autoriser l’accès aux adresses IP de Braze

Si vous disposez d’un pare-feu ou d’autres politiques réseau, vous devez donner à Braze un accès réseau à votre instance Redshift. Autorisez l’accès depuis les adresses IP suivantes correspondant à la région de votre tableau de bord de Braze.

Vous devrez peut-être également modifier vos groupes de sécurité pour autoriser l’accès de Braze à vos données dans Redshift. Assurez-vous d’autoriser explicitement le trafic entrant sur les adresses IP de la section suivante et sur le port utilisé pour interroger votre cluster Redshift (par défaut 5439). Vous devez autoriser explicitement la connectivité TCP Redshift sur ce port même si les règles entrantes sont configurées sur « tout autoriser ». De plus, il est important que l’endpoint du cluster Redshift soit accessible publiquement pour que Braze puisse se connecter à votre cluster.

Si vous ne souhaitez pas que votre cluster Redshift soit accessible publiquement, vous pouvez configurer un VPC et une instance EC2 pour utiliser un tunnel SSH afin d’accéder aux données Redshift. Pour plus d’informations, consultez AWS : Comment accéder à un cluster Amazon Redshift privé depuis ma machine locale ?

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Créer un compte de service et accorder les autorisations

Créez un compte de service dans GCP que Braze utilisera pour se connecter et lire les données de vos tables. Le compte de service doit disposer des autorisations suivantes :

BigQuery Connection User : permet à Braze d’établir des connexions.
BigQuery User : fournit à Braze l’accès pour exécuter des requêtes, lire les métadonnées des jeux de données et lister les tables.
BigQuery Data Viewer : fournit à Braze l’accès pour visualiser les jeux de données et leur contenu.
BigQuery Job User : fournit à Braze l’accès pour exécuter des tâches.
bigquery.tables.create : fournit à Braze l’accès pour créer des tables temporaires lors de l’actualisation des segments.

Créez un compte de service pour votre source connectée. Cet utilisateur 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. Une fois la source connectée créée, Braze découvrira les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source.

Vous pouvez choisir d’accorder l’accès à toutes les tables d’un jeu de données ou d’accorder des privilèges uniquement à des tables spécifiques. Les tables auxquelles le rôle Braze a accès seront disponibles pour les requêtes dans l’extension de segments CDI.

Après avoir créé le compte de service et accordé les autorisations, générez une clé JSON. Pour plus d’informations, consultez Google Cloud : Créer et supprimer des clés de compte de service. Vous la chargerez ultérieurement dans le tableau de bord de Braze.

Étape 2.2 : Autoriser l’accès aux adresses IP de Braze

Si vous avez des politiques réseau en place, vous devez donner à Braze un accès réseau à votre instance BigQuery. Autorisez l’accès depuis les adresses IP suivantes correspondant à la région de votre tableau de bord de Braze.

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Créer des identifiants pour Braze

Braze peut se connecter à Databricks via OAuth machine-à-machine (M2M) avec un principal de service, ou avec un jeton d’accès personnel. Braze recommande OAuth M2M. Les identifiants de jeton d’accès personnel existants continuent de fonctionner et vous n’avez pas besoin de les migrer.

Quelle que soit la méthode choisie, Braze utilise ces identifiants 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. Une fois la source connectée créée, Braze découvre les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source.

Vous pouvez accorder l’accès à toutes les tables d’un schéma ou accorder des privilèges uniquement à des tables spécifiques. Les tables auxquelles le rôle Braze a accès sont disponibles pour les requêtes dans l’extension de segments CDI.

L’autorisation CREATE TABLE est requise 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ée une table temporaire par segment, qui ne persiste que pendant la mise à jour du segment par Braze.

oauth m2m
jeton d'accès personnel

Créez un principal de service, générez un secret client et accordez au principal de service l’autorisation Can use sur votre entrepôt SQL. Pour les étapes détaillées, consultez Créer des identifiants pour Braze.
Accordez au principal de service l’accès au schéma utilisé pour la source connectée, y compris CREATE TABLE. Utilisez l’ID d’application du principal de service (la même valeur que l’ID client) comme bénéficiaire.

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>`;

Conservez l’ID client et le secret dans un endroit sûr jusqu’à ce que vous deviez les saisir dans le tableau de bord de Braze lors de l’étape de création des identifiants.

Dans votre espace de travail Databricks, sélectionnez votre nom d’utilisateur Databricks dans la barre supérieure, puis sélectionnez User Settings dans le menu déroulant.
Assurez-vous que le compte de service dispose des privilèges CREATE TABLE sur le schéma utilisé pour la source connectée.
Dans l’onglet Access tokens, sélectionnez Generate new token.
Saisissez un commentaire pour identifier ce jeton, par exemple « Braze CDI », et modifiez la durée de vie du jeton en la définissant comme illimitée en laissant le champ Lifetime (days) vide.
Sélectionnez Generate.
Copiez le jeton affiché, puis sélectionnez Done.

Conservez le jeton dans un endroit sûr jusqu’à ce que vous deviez le saisir dans le tableau de bord de Braze lors de l’étape de création des identifiants.

Étape 2.2 : Autoriser l’accès aux adresses IP de Braze

Si vous avez des politiques réseau en place, vous devez donner à Braze un accès réseau à votre instance Databricks. Autorisez l’accès depuis les adresses IP suivantes correspondant à la région de votre tableau de bord de Braze.

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Accorder l’accès aux ressources Fabric

Braze se connectera à votre entrepôt Fabric à l’aide d’un principal de service avec l’authentification Entra ID. Vous créerez un nouveau principal de service que Braze utilisera et accorderez l’accès aux ressources Fabric selon les besoins. Braze aura besoin des informations suivantes pour se connecter :

ID de locataire (également appelé répertoire) de votre compte Azure
ID de principal (également appelé ID d’application) pour le principal de service
Secret client pour permettre à Braze de s’authentifier

Dans le portail Azure, accédez au centre d’administration Microsoft Entra, puis à App Registrations.
Sélectionnez + New registration sous Identity > Applications > App registrations.
Saisissez un nom et sélectionnez Accounts in this organizational directory only comme type de compte pris en charge. Ensuite, sélectionnez Register.
Sélectionnez l’application (principal de service) que vous venez de créer, puis accédez à Certificates & secrets > + New client secret.
Saisissez une description pour le secret et définissez une période d’expiration. Ensuite, sélectionnez Add.
Notez le secret client créé afin de l’utiliser lors de la configuration de Braze.

Remarque

Azure ne permet pas d’expiration illimitée pour les secrets des principaux de service. N’oubliez pas d’actualiser les identifiants avant leur expiration afin de maintenir le flux de données vers Braze.

Étape 2.2 : Accorder l’accès aux ressources Fabric

Vous accorderez l’accès à Braze pour se connecter à votre instance Fabric. Dans votre portail d’administration Fabric, naviguez vers Settings > Governance and insights > Admin portal > Tenant settings.

Dans Developer settings, activez « Service principals can use Fabric APIs » pour que Braze puisse se connecter à l’aide de Microsoft Entra ID.
Dans OneLake settings, activez « Users can access data stored in OneLake with apps external to Fabric » pour que le principal de service puisse accéder aux données depuis une application externe.

Étape 2.3 : Obtenir la chaîne de connexion de l’entrepôt

Vous aurez besoin de l’endpoint SQL de votre entrepôt pour que Braze puisse se connecter. Pour récupérer l’endpoint SQL, accédez à l’espace de travail dans Fabric et, dans la liste des éléments, survolez le nom de l’entrepôt et sélectionnez Copy SQL connection string. Conservez cette valeur pour la configuration des identifiants à l’étape 3.

Étape 2.4 : Autoriser les adresses IP de Braze dans le pare-feu (facultatif)

Selon la configuration de votre compte Microsoft Fabric, vous devrez peut-être autoriser les adresses IP suivantes dans votre pare-feu pour permettre le trafic depuis Braze. Pour plus d’informations, consultez la documentation pertinente sur l’accès conditionnel Entra.

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 3 : Créer une source connectée dans le tableau de bord de Braze

É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, sélectionnez Add data source, puis sélectionnez Snowflake.

Dans Setup source, saisissez les informations suivantes :

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

Si vous créez de nouveaux identifiants Snowflake, sélectionnez Save credentials and generate RSA key avant de tester la connexion.

Étape 3.2 : Configurer les détails de 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 un temps d’exécution maximum pour cette source. Braze interrompra automatiquement toutes les requêtes qui dépassent le temps d’exécution maximum. Le temps d’exécution maximum autorisé est de 60 minutes ; un temps d’exécution inférieur réduira les coûts engagés sur votre compte Snowflake. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Si les requêtes expirent régulièrement et que vous avez défini un temps d’exécution maximum de 60 minutes, essayez d’optimiser le temps d’exécution de vos requêtes ou de dédier un entrepôt plus grand à l’utilisateur Braze.

Étape 3.3 : Noter la clé publique

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

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

Dans Setup source, saisissez les informations suivantes :

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

Si nécessaire, activez Connect with SSH Tunnel et saisissez Tunnel Host, Tunnel Port et Tunnel Username.

Étape 3.2 : Configurer les détails de 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 un temps d’exécution maximum pour cette source. Braze interrompra automatiquement toutes les requêtes qui dépassent le temps d’exécution maximum. Le temps d’exécution maximum autorisé est de 60 minutes ; un temps d’exécution inférieur réduira les coûts engagés sur votre compte Redshift. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Étape 3.3 : Noter la clé publique (facultatif)

Si vos identifiants ont l’option Connect with SSH Tunnel sélectionnée, notez la clé publique RSA à l’étape Test connection. Vous en aurez besoin pour finaliser l’intégration dans Redshift.

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

Dans Setup source, saisissez les informations suivantes :

Credentials : Credential name et chargez votre clé JSON
Configuration : Project et Dataset

Étape 3.2 : Configurer les détails de 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 un temps d’exécution maximum pour cette source. Braze interrompra automatiquement toutes les requêtes qui dépassent le temps d’exécution maximum. Le temps d’exécution maximum autorisé est de 60 minutes ; un temps d’exécution inférieur réduira les coûts engagés sur votre compte BigQuery. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Étape 3.3 : Tester la connexion

Sélectionnez Test Connection pour vérifier que la liste des tables visibles par l’utilisateur correspond à ce que vous attendez, puis sélectionnez Done. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.

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

Dans Setup source, saisissez les informations suivantes :

Credentials : Credential name, Authentication method, Hostname et HTTP path, ainsi que Client ID et Client secret (OAuth M2M) ou Access token (jeton d’accès personnel)
Configuration : Catalog et Schema

Étape 3.2 : Configurer les détails de 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 un temps d’exécution maximum pour cette source. Braze interrompra automatiquement toutes les requêtes qui dépassent le temps d’exécution maximum. Le temps d’exécution maximum autorisé est de 60 minutes ; un temps d’exécution inférieur réduira les coûts engagés sur votre compte Databricks. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Étape 3.3 : Tester la connexion

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

Dans Setup source, saisissez les informations suivantes :

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

Si Connect with SSH Tunnel est disponible dans votre espace de travail et nécessaire pour votre configuration, saisissez également Tunnel Host, Tunnel Port et Tunnel Username.

Étape 3.2 : Configurer les détails de 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 un temps d’exécution maximum pour cette source. Braze interrompra automatiquement toutes les requêtes qui dépassent le temps d’exécution maximum. Le temps d’exécution maximum autorisé est de 60 minutes ; un temps d’exécution inférieur réduira les coûts engagés sur votre compte Microsoft Fabric. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Si les requêtes expirent régulièrement et que vous avez défini un temps d’exécution maximum de 60 minutes, essayez d’optimiser le temps d’exécution de vos requêtes ou de dimensionner la capacité Fabric.

Étape 3.3 : Tester la connexion

Étape 4 : Finaliser la configuration de l’entrepôt de données

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, 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é.

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 maintenant créée et prête à être utilisée dans les extensions de segments CDI.

Si vous vous connectez via un tunnel SSH, ajoutez la clé publique que vous avez notée lors de la dernière étape à l’utilisateur du tunnel SSH.

Après avoir ajouté la clé à l’utilisateur, sélectionnez Test Connection dans Braze, puis sélectionnez Done. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.

Cela ne s’applique pas à BigQuery.

Cela ne s’applique pas à Databricks.

Cela ne s’applique pas à Microsoft Fabric.

Remarque

Vous devez tester la source avec succès avant qu’elle puisse passer de l’état « brouillon » à l’état « actif ». Si vous devez quitter la page de création, votre intégration sera enregistrée et vous pourrez revenir à la page de détails pour apporter des modifications et effectuer des tests.

Configuration d’intégrations ou d’utilisateurs supplémentaires (facultatif)

Vous pouvez configurer plusieurs intégrations avec Braze, mais chaque intégration doit être configurée pour se 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 pour plusieurs intégrations, vous n’aurez pas besoin d’ajouter à nouveau la clé publique.

Vous pouvez configurer plusieurs sources avec Braze, mais chaque source doit être configurée pour se connecter à un schéma différent. Lors de la création de sources supplémentaires, vous pouvez réutiliser les identifiants existants si vous vous connectez au même compte Redshift.

Vous pouvez configurer plusieurs sources avec Braze, mais chaque source doit être configurée pour se connecter à un jeu de données différent. Lors de la création de sources supplémentaires, vous pouvez réutiliser les identifiants existants si vous vous connectez au même compte BigQuery.

Utiliser la source connectée

Une fois la source créée, vous pouvez l’utiliser pour créer une ou plusieurs extensions de segments CDI. Pour plus d’informations sur la création d’un segment avec cette source, consultez la documentation sur les extensions de segments CDI.

Remarque

Si vos requêtes expirent régulièrement et que vous avez défini un temps d’exécution maximum de 60 minutes, essayez d’optimiser le temps d’exécution de vos requêtes ou d’allouer davantage de ressources de calcul (comme un entrepôt de données plus important) à l’utilisateur Braze.

New Stuff!