Sources connectées
Les sources connectées offrent une alternative sans 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 aucune des 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 mises à disposition via votre source connectée CDI), puis de créer et de maintenir un groupe d’utilisateurs que vous pouvez cibler dans Braze.
Pour en savoir plus sur la création d’un Segment avec cette source, consultez les extensions de segments CDI.
Comme les sources connectées s’exécutent directement sur votre entrepôt de données, vous supportez l’ensemble des 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.
Sources prises en charge
Les sources connectées sont disponibles uniquement pour les entrepôts de données. Les sources de stockage de fichiers ne prennent pas en charge les sources connectées.
| Source | Instructions de configuration |
|---|---|
| Snowflake | Utiliser Snowflake comme source connectée |
| Amazon Redshift | Utiliser Redshift comme source connectée |
| Google BigQuery | Utiliser BigQuery comme source connectée |
| Databricks | Utiliser Databricks comme source connectée |
| Microsoft Fabric | Utiliser Microsoft Fabric comme source connectée |
Configurer une source connectée
La configuration d’une source connectée suit les quatre mêmes étapes pour chaque entrepôt de données. Les identifiants, les autorisations et le code SQL varient selon la source. Reportez-vous donc à la page de votre source pour connaître les commandes exactes.
- Configurez votre entrepôt de données. Créez les identifiants que Braze utilisera pour s’authentifier, puis accordez-leur l’accès aux tables que vous souhaitez interroger. La source connectée peut faire référence à une ou plusieurs tables. Assurez-vous donc que votre utilisateur Braze est autorisé à accéder à toutes les tables que vous souhaitez inclure dans la source connectée.
- Créez la source connectée dans Braze. Allez dans Paramètres des données > Ingestion de données cloud > Sources connectées, sélectionnez Ajouter une source de données, puis sélectionnez votre source. Saisissez les identifiants et la configuration de cette source.
- Configurez les détails de la source. Choisissez un nom et une durée d’exécution maximale.
- Finalisez la configuration de l’entrepôt et testez-la. Pour Snowflake, ainsi que pour Redshift lorsque vous utilisez un tunnel SSH, ajoutez la clé publique générée par Braze à l’utilisateur de votre entrepôt. Sélectionnez ensuite Tester la connexion, puis Terminé.
Vous devez tester une source avec succès avant qu’elle puisse passer de l’état « brouillon » à l’état « actif ». Si vous devez fermer la page de création, votre intégration est enregistrée : vous pourrez revenir sur la page de détails pour apporter des modifications et effectuer le test.
Autorisations à accorder
Quelle que soit la source utilisée, les identifiants Braze ont besoin de deux types d’accès :
- Un accès en lecture aux tables ou vues que vous souhaitez rendre disponibles dans les extensions de segments CDI. Vous pouvez accorder l’accès à toutes les tables d’un schéma ou d’un jeu de données, ou accorder des privilèges uniquement sur certaines tables. Toutes les tables auxquelles Braze a accès peuvent être interrogées dans l’extension de segment CDI.
- Un accès en création de table sur le schéma, afin que Braze puisse écrire les résultats de la requête de votre extension de segment CDI dans une table avant de mettre à jour le Segment dans Braze. Braze crée une table temporaire par Segment, et cette table ne subsiste que pendant la mise à jour du Segment par Braze.
Une fois la source connectée créée, Braze détecte les noms et les descriptions de toutes les tables accessibles aux identifiants dans le schéma source.
Durée d’exécution maximale
Configurez une durée d’exécution maximale pour chaque source connectée. Braze interrompt automatiquement toute requête qui la dépasse. La durée d’exécution maximale autorisée est de 60 minutes, et une durée plus courte réduit les coûts facturés sur votre compte d’entrepôt de données. 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.
Si les requêtes expirent régulièrement 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 d’allouer davantage de ressources de calcul (par exemple un entrepôt plus grand) à l’utilisateur Braze.
Configurer des sources supplémentaires (facultatif)
Vous pouvez configurer plusieurs sources connectées avec Braze, mais chaque source doit être configurée pour connecter un schéma ou un jeu de données différent. Lorsque vous créez des sources supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte d’entrepôt de données.
Pour Snowflake, si vous réutilisez le même utilisateur et le même rôle pour plusieurs intégrations, vous n’avez pas besoin d’ajouter à nouveau la clé publique.
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 en savoir plus sur la création d’un Segment à partir de cette source, consultez la documentation sur les extensions de segments CDI.