Cloud Data Ingestion pour Microsoft Fabric
Cette page présente tout ce dont vous avez besoin pour synchroniser des données de Microsoft Fabric vers Braze avec Cloud Data Ingestion (CDI) : les ressources à créer dans Fabric, la connexion de la source et la création d’une synchronisation dans Braze, la table source pour chaque type de données et la résolution des problèmes propres à Fabric.
Aperçu de la configuration
- Configurez l’authentification pour Braze à l’aide de l’une des méthodes d’authentification prises en charge, puis accordez l’accès aux API Fabric.
- Configurez un espace de travail partagé et accordez-y l’accès au principal de service.
- Dans l’espace de travail Fabric partagé, configurez les tables ou les vues que vous souhaitez synchroniser avec Braze.
- Créez une nouvelle source et une nouvelle synchronisation dans le tableau de bord de Braze.
- Validez l’intégration et lancez la synchronisation.
Étape 1 : Configurer l’authentification
Braze se connecte à votre entrepôt Fabric avec la méthode d’authentification suivante :
| Méthode | Mode d’authentification de Braze | Informations à saisir dans Braze |
|---|---|---|
| Service principal | Braze authenticates as a Microsoft Entra ID service principal with a client secret. | Tenant ID, Principal ID, and Client Secret |
Service principal
Braze se connecte à votre entrepôt Fabric à l’aide d’un principal de service avec l’authentification Microsoft Entra ID. Créez un nouveau principal de service que Braze utilisera, puis accordez-lui l’accès aux ressources Fabric en suivant les étapes ci-dessous. Braze a 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
L’inscription d’une application nécessite l’autorisation de créer des inscriptions d’applications dans Microsoft Entra ID. Si vous ne disposez pas de cette autorisation, demandez à un administrateur Entra d’effectuer cette étape et de vous transmettre les identifiants.
- 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 onlycomme 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.

Azure ne permet pas de définir une expiration illimitée pour les secrets de principal de service. Pensez à actualiser les identifiants avant leur expiration afin de maintenir le flux de données vers Braze.
Étape 2 : Accorder l’accès aux ressources Fabric
Autorisez Braze à se connecter à votre instance Fabric. Dans votre portail d’administration Fabric, accédez à Paramètres > Gouvernance et informations > Portail d’administration > Paramètres du locataire.
- Dans Paramètres du développeur, activez Les principaux de service peuvent utiliser les API Fabric afin que Braze puisse se connecter à l’aide de Microsoft Entra ID.
- Dans Paramètres OneLake, activez Les utilisateurs peuvent accéder aux données stockées dans OneLake avec des applications externes à Fabric afin que le principal de service puisse accéder aux données depuis une application externe.
Étape 3 : Configurer un espace de travail partagé et accorder l’accès
Toutes les ressources Fabric que vous souhaitez connecter à Braze doivent se trouver dans un espace de travail partagé. Si vous utilisiez jusqu’à présent uniquement l’espace par défaut My Workspace, créez un nouvel espace de travail partagé :
- Dans le menu de navigation, sélectionnez Workspaces, puis + New workspace.
- Saisissez un nom pour l’espace de travail, puis sélectionnez Apply.
Une fois votre espace de travail partagé en place, accordez l’accès au principal de service :
- Sélectionnez l’espace de travail, puis Manage Access.
- Sélectionnez + Add people or groups.
- Recherchez et sélectionnez le nom du principal de service que vous avez créé à l’étape 1. S’il n’apparaît pas, vérifiez que vous avez bien activé le paramètre Service principals can use Fabric APIs à l’étape 2.
- Dans la liste déroulante des rôles, sélectionnez Contributor.
Le principal de service peut désormais accéder aux ressources d’entrepôt Fabric de cet espace de travail via leurs endpoints SQL, y compris l’entrepôt à utiliser pour Braze.
Étape 4 : Configurer votre table source
Les étapes de cette section créent une table avec une colonne payload. Si vous prévoyez plutôt de structurer vos données à l’étape Définition des données, vous pouvez utiliser une table ou une vue existante. Dans ce cas, ignorez l’étape de création de la table et accordez à Braze un accès en lecture aux tables ou vues que vous souhaitez synchroniser. Pour comparer les options, consultez Choisir une option de définition des données.
Braze prend en charge les tables et les vues dans les entrepôts Fabric. Si vous devez créer un nouvel entrepôt, créez-le dans l’espace de travail partagé de l’étape 3. Dans la console Fabric, accédez à Create > Data Warehouse > Warehouse.
Vous pouvez nommer l’entrepôt, le schéma et la table ou la vue comme vous le souhaitez, mais les noms de colonnes doivent correspondre aux définitions des onglets suivants.

Si vous utilisez une colonne payload, votre table ou vue source peut inclure des colonnes qui ne figurent pas dans les onglets suivants (par exemple, pour l’audit ou le hachage). Braze lit uniquement les colonnes décrites dans ces onglets ; les autres colonnes ne sont pas utilisées lors des synchronisations Cloud Data Ingestion.
Sélectionnez l’onglet correspondant au type de données que vous souhaitez synchroniser.
Les attributs utilisateur, les événements personnalisés et les événements d’achat utilisent tous la même structure de table source. Seul le contenu de payload diffère.
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
UPDATED_AT DATETIME2(6) NOT NULL,
PAYLOAD VARCHAR NOT NULL,
--at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
EXTERNAL_ID VARCHAR,
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR,
ALIAS_LABEL VARCHAR,
--braze_id can only be used to update existing users created through the Braze SDK
BRAZE_ID VARCHAR,
--If you include both email and phone, email is used as the primary identifier
EMAIL VARCHAR,
PHONE VARCHAR
)
GO
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.- Colonnes d’identifiant utilisateur - Votre table peut contenir une ou plusieurs colonnes d’identifiant utilisateur. Chaque ligne ne doit contenir qu’un seul identifiant (soit
external_id, soit la combinaison dealias_nameetalias_label, soitbraze_id,emailouphone). Une table source peut comporter des colonnes pour un, deux, trois, quatre ou les cinq types d’identifiants.EXTERNAL_ID- Identifie l’utilisateur que vous souhaitez mettre à jour. Cette valeur doit correspondre à la valeurexternal_idutilisée dans Braze.ALIAS_NAMEetALIAS_LABEL- Ces deux colonnes créent un objet alias d’utilisateur.alias_namedoit être un identifiant unique, etalias_labelindique le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seulalias_nameparalias_label.BRAZE_ID- L’identifiant utilisateur Braze. Il est généré par le SDK de Braze, et il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un ID Braze via l’ingestion de données cloud. Pour créer de nouveaux utilisateurs, indiquez un ID utilisateur externe ou un alias d’utilisateur.EMAIL- L’adresse e-mail de l’utilisateur. Si plusieurs profils partagent la même adresse e-mail, le profil mis à jour le plus récemment est prioritaire pour les mises à jour. Si vous incluez à la fois l’e-mail et le numéro de téléphone, l’e-mail sert d’identifiant principal.PHONE- Le numéro de téléphone de l’utilisateur. Si plusieurs profils partagent le même numéro de téléphone, le profil mis à jour le plus récemment est prioritaire pour les mises à jour.
payload- Il s’agit d’une chaîne de caractères JSON contenant les champs que vous souhaitez synchroniser avec l’utilisateur dans Braze.
Pour les synchronisations d’attributs, payload suit le format de l’objet des attributs utilisateur. Vous pouvez inclure des attributs personnalisés imbriqués, des tableaux d’objets et des statuts de groupe d’abonnement. Pour des exemples de payload, consultez Configuration de la table.
Les événements personnalisés utilisent la même table source que les attributs utilisateur. Créez la table présentée dans l’onglet Attributs utilisateur, puis remplissez payload avec un objet événement.
Pour synchroniser des événements, un nom d’événement est obligatoire. Formatez le champ time sous forme de chaîne de caractères ISO 8601 ou au format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Si le champ time est absent, Braze utilise la valeur de la colonne UPDATED_AT comme heure de l’événement. Les autres champs, notamment app_id et properties, sont facultatifs.
Vous pouvez synchroniser un événement par ligne.
{
"app_id" : "your-app-id",
"name" : "rented_movie",
"time" : "2013-07-16T19:20:45+01:00",
"properties": {
"movie": "The Sad Egg",
"director": "Alex Smith"
}
}
Les événements d’achat utilisent la même table source que les attributs utilisateur. Créez la table présentée dans l’onglet Attributs utilisateur, puis remplissez payload avec un objet achat.
Pour synchroniser des événements d’achat, product_id, currency et price sont obligatoires. Formatez le champ facultatif time sous forme de chaîne de caractères ISO 8601 ou au format yyyy-MM-dd'T'HH:mm:ss:SSSZ. Si le champ time est absent, Braze utilise la valeur de la colonne UPDATED_AT comme heure de l’événement. Les autres champs, notamment app_id, quantity et properties, sont facultatifs.
Vous pouvez synchroniser un événement d’achat par ligne.
{
"app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
"product_id" : "Completed Order",
"currency" : "USD",
"price" : 219.98,
"time" : "2013-07-16T19:20:30+01:00",
"properties" : {
"products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
{ "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
]
}
}
Avant de créer une synchronisation de catalogue, créez le catalogue cible dans Braze. Pour le processus complet relatif aux catalogues, consultez Synchroniser et supprimer les données de catalogue.
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
UPDATED_AT DATETIME2(6) NOT NULL,
PAYLOAD VARCHAR NOT NULL,
ID VARCHAR NOT NULL,
DELETED BIT
)
GO
Le nom de l’intégration doit correspondre exactement au nom du catalogue que vous avez créé dans Braze.
Braze recommande de créer une vue à partir de vos données de catalogue afin que la table source soit entièrement actualisée à chaque exécution d’une synchronisation. Par exemple, si vous disposez d’une table de données produit (product_catalog) avec un id et quatre attributs supplémentaires, vous pouvez synchroniser la vue suivante :
CREATE VIEW [braze].[user_update_example]
AS SELECT
id as ID,
CURRENT_TIMESTAMP as UPDATED_AT,
JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD
FROM [braze].[product_catalog] ;
Avant de créer une synchronisation d’objets de données, créez le type d’objet de données et ses champs dans Braze. Pour le processus complet, consultez Synchroniser les objets de données.
CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNTS_SYNC]
(
UPDATED_AT DATETIME2(6) NOT NULL,
OBJECT_ID VARCHAR NOT NULL,
PAYLOAD VARCHAR NOT NULL,
--the data object record associated with this OBJECT_ID should be deleted
DELETED BIT
)
GO
| Nom du champ | Type | Mode |
|---|---|---|
UPDATED_AT |
DATETIME2 | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
payload |
VARCHAR | REQUIRED |
DELETED |
BIT | NULLABLE |
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée dans la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.OBJECT_ID- L’identifiant de l’enregistrement de l’objet de données. Il doit correspondre à la valeurobject_idutilisée dans Braze pour ce type d’objet de données.payload- Une chaîne de caractères JSON contenant les champs et les valeurs à synchroniser. Chaque clé doit correspondre à un champ défini sur le type d’objet de données dans Braze.DELETED- Lorsque la valeur esttrue, Braze supprime l’enregistrement au lieu de le mettre à jour. Laissez cette valeur nulle ou àfalsepour les lignes que vous souhaitez créer ou mettre à jour.
Les noms de champs dans payload sont sensibles à la casse. Une clé nommée NAME ne correspond pas à un champ nommé name. Si la casse ne correspond pas, la validation signale la clé comme un champ non défini et indique comme manquant le champ qu’elle devait renseigner. Nommez vos clés exactement comme les champs apparaissent dans Paramètres des données > Objets de données.
Braze ne crée ni ne modifie les types d’objets de données pendant une synchronisation. Définissez le type et tous ses champs dans Braze avant de créer la synchronisation. Pour ajouter un champ par la suite, ajoutez-le d’abord au type, puis mettez à jour votre table source ou votre requête.
Par exemple, une valeur payload pour un compte avec un champ name et un champ team_id se présente ainsi :
{"name": "Acme Corp", "team_id": 42}
À l’étape Définition des données, sélectionnez le type de données Objets de données, puis choisissez votre Type d’objet de données. Les synchronisations d’objets de données prennent en charge Table et SQL.
Utilisez cette synchronisation pour associer des utilisateurs à des enregistrements d’objets de données, par exemple pour lier des utilisateurs aux comptes auxquels ils appartiennent. Créez la relation dans Braze avant de la synchroniser.
CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNT_USERS_SYNC]
(
UPDATED_AT DATETIME2(6) NOT NULL,
OBJECT_ID VARCHAR NOT NULL,
--at least one of external_id, alias_name and alias_label, email, or phone is required
EXTERNAL_ID VARCHAR,
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR,
ALIAS_LABEL VARCHAR,
EMAIL VARCHAR,
PHONE VARCHAR,
PAYLOAD VARCHAR,
DELETED BIT
)
GO
| Nom du champ | Type | Mode |
|---|---|---|
UPDATED_AT |
DATETIME2 | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
EXTERNAL_ID |
VARCHAR | NULLABLE |
ALIAS_NAME |
VARCHAR | NULLABLE |
ALIAS_LABEL |
VARCHAR | NULLABLE |
EMAIL |
VARCHAR | NULLABLE |
PHONE |
VARCHAR | NULLABLE |
payload |
VARCHAR | NULLABLE |
DELETED |
BIT | NULLABLE |
Chaque ligne nécessite OBJECT_ID ainsi qu’au moins un identifiant utilisateur : EXTERNAL_ID, la combinaison de ALIAS_NAME et ALIAS_LABEL, EMAIL ou PHONE. Utilisez payload pour les champs définis sur la relation elle-même.

Contrairement aux synchronisations d’attributs utilisateur, BRAZE_ID n’est pas pris en charge pour les synchronisations de relations utilisateur. Utilisez l’un des identifiants énumérés précédemment.
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée dans la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.OBJECT_ID- L’identifiant de l’enregistrement de l’objet de données. Il doit correspondre à la valeurobject_idutilisée dans Braze pour ce type d’objet de données.payload- Une chaîne de caractères JSON contenant les champs et les valeurs à synchroniser. Chaque clé doit correspondre à un champ défini sur le type d’objet de données dans Braze.DELETED- Lorsque la valeur esttrue, Braze supprime l’enregistrement au lieu de le mettre à jour. Laissez cette valeur nulle ou àfalsepour les lignes que vous souhaitez créer ou mettre à jour.
Les noms de champs dans payload sont sensibles à la casse. Une clé nommée NAME ne correspond pas à un champ nommé name. Si la casse ne correspond pas, la validation signale la clé comme un champ non défini et indique comme manquant le champ qu’elle devait renseigner. Nommez vos clés exactement comme les champs apparaissent dans Paramètres des données > Objets de données.
Braze ne crée ni ne modifie les types d’objets de données pendant une synchronisation. Définissez le type et tous ses champs dans Braze avant de créer la synchronisation. Pour ajouter un champ par la suite, ajoutez-le d’abord au type, puis mettez à jour votre table source ou votre requête.
À l’étape Définition des données, sélectionnez le type de données Relations utilisateur des objets de données, puis choisissez un Nom de relation, par exemple User (Account-User).
Utilisez cette synchronisation pour relier des enregistrements d’objets de données entre eux, par exemple pour lier des comptes à leurs comptes parents. Créez la relation dans Braze avant de la synchroniser.
CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNT_SUBACCOUNTS_SYNC]
(
UPDATED_AT DATETIME2(6) NOT NULL,
OBJECT_ID VARCHAR NOT NULL,
RELATED_OBJECT_ID VARCHAR NOT NULL,
PAYLOAD VARCHAR,
DELETED BIT
)
GO
| Nom du champ | Type | Mode |
|---|---|---|
UPDATED_AT |
DATETIME2 | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
RELATED_OBJECT_ID |
VARCHAR | REQUIRED |
payload |
VARCHAR | NULLABLE |
DELETED |
BIT | NULLABLE |
OBJECT_ID est l’enregistrement à partir duquel la relation commence, et RELATED_OBJECT_ID est l’enregistrement vers lequel elle pointe. Les deux sont obligatoires dans chaque ligne. Utilisez payload pour les champs définis sur la relation elle-même.
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée dans la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.OBJECT_ID- L’identifiant de l’enregistrement de l’objet de données. Il doit correspondre à la valeurobject_idutilisée dans Braze pour ce type d’objet de données.payload- Une chaîne de caractères JSON contenant les champs et les valeurs à synchroniser. Chaque clé doit correspondre à un champ défini sur le type d’objet de données dans Braze.DELETED- Lorsque la valeur esttrue, Braze supprime l’enregistrement au lieu de le mettre à jour. Laissez cette valeur nulle ou àfalsepour les lignes que vous souhaitez créer ou mettre à jour.
Les noms de champs dans payload sont sensibles à la casse. Une clé nommée NAME ne correspond pas à un champ nommé name. Si la casse ne correspond pas, la validation signale la clé comme un champ non défini et indique comme manquant le champ qu’elle devait renseigner. Nommez vos clés exactement comme les champs apparaissent dans Paramètres des données > Objets de données.
Braze ne crée ni ne modifie les types d’objets de données pendant une synchronisation. Définissez le type et tous ses champs dans Braze avant de créer la synchronisation. Pour ajouter un champ par la suite, ajoutez-le d’abord au type, puis mettez à jour votre table source ou votre requête.
À l’étape Définition des données, sélectionnez le type de données Relations des objets de données, puis choisissez un Nom de relation, par exemple Subaccount (Account-Account).
Les déclencheurs Canvas alimentent la personnalisation zero-copy. Pour la configuration du Canvas de destination et les points à prendre en compte, consultez Personnalisation zero-copy.
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
UPDATED_AT DATETIME2(6) NOT NULL,
PROPERTIES VARCHAR NOT NULL,
--at least one of external_id or alias_name and alias_label is required
EXTERNAL_ID VARCHAR,
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR,
ALIAS_LABEL VARCHAR
)
GO
Les synchronisations de déclencheurs Canvas diffèrent des autres synchronisations de données utilisateur sur trois points :
- Seuls les identifiants de type ID externe ou alias d’utilisateur sont pris en charge. Les adresses e-mail et les numéros de téléphone ne sont pas des identifiants pris en charge.
- Seuls les utilisateurs Braze existants peuvent être synchronisés. Il n’est pas possible de créer de nouveaux utilisateurs.
PROPERTIESremplace la colonnepayload. Il s’agit d’une chaîne de caractères JSON contenant les champs que vous souhaitez utiliser comme propriétés d’entrée du Canvas pour la personnalisation.
Votre table de déclencheurs Canvas doit contenir les colonnes suivantes :
UPDATED_AT- Le moment où cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.- Soit
EXTERNAL_ID, soitALIAS_NAMEetALIAS_LABELcomme colonne d’identifiant utilisateur. Ces colonnes identifient les utilisateurs pour lesquels vous souhaitez déclencher des messages Canvas.EXTERNAL_ID- Identifie l’utilisateur à faire entrer dans le Canvas. Cette valeur doit correspondre à la valeurexternal_idutilisée dans Braze.ALIAS_NAMEetALIAS_LABEL- Ces colonnes créent un objet alias d’utilisateur.alias_namedoit être un identifiant unique, etalias_labelindique le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seulalias_nameparalias_label.
PROPERTIES- Une chaîne de caractères JSON contenant les champs à rendre disponibles comme propriétés de personnalisation dans votre Canvas. Elle doit contenir des informations propres à chaque utilisateur.

Les propriétés ne sont pas obligatoires pour chaque ligne ou chaque utilisateur. En revanche, leurs valeurs doivent être une chaîne de caractères JSON valide. Si la ligne ne comporte aucune propriété, saisissez une chaîne vide {}.
Créez un principal de service et accordez-lui les autorisations nécessaires. Si vous disposez déjà d’identifiants issus d’une autre synchronisation, vous pouvez les réutiliser, mais assurez-vous qu’ils ont accès à la table des déclencheurs Canvas.
Pour commencer, sélectionnez le type de données Déclencheurs Canvas lors de la création d’une nouvelle synchronisation.
Les tables sources pour les suppressions d’utilisateurs doivent inclure un ou plusieurs types d’identifiants utilisateur ainsi qu’un horodatage UPDATED_AT. Les colonnes de payload ne sont pas prises en charge pour les données de suppression d’utilisateurs.
UPDATED_AT- L’heure à laquelle cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeurUPDATED_ATest postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être resynchronisées si de nouvelles lignes partagent ce même horodatage.- Colonnes d’identifiant utilisateur - Chaque ligne ne doit contenir qu’un seul identifiant : soit
external_id, soit la combinaison dealias_nameetalias_label, soitbraze_id. Une table source peut contenir des colonnes pour un, deux ou les trois types d’identifiants.EXTERNAL_ID- Identifie l’utilisateur que vous souhaitez mettre à jour. Cette valeur doit correspondre à la valeurexternal_idutilisée dans Braze.ALIAS_NAMEetALIAS_LABEL- Ces deux colonnes créent un objet alias d’utilisateur.alias_namedoit être un identifiant unique, etalias_labelindique le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seulalias_nameparalias_label.BRAZE_ID- L’identifiant utilisateur Braze. Il est généré par le SDK de Braze, et il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un ID Braze via Cloud Data Ingestion. Pour créer de nouveaux utilisateurs, indiquez un ID utilisateur externe ou un alias d’utilisateur.

N’incluez pas de colonne payload dans votre table pour la suppression d’utilisateurs. Pour éviter toute suppression accidentelle et définitive d’utilisateurs, la synchronisation échoue si une colonne de payload est présente dans la table source. Toutes les autres colonnes sont autorisées, mais Braze les ignore.
CREATE OR ALTER TABLE [warehouse].[schema].[users_deletes]
(
UPDATED_AT DATETIME2(6) NOT NULL,
--at least one of external_id, alias_name and alias_label, or braze_id is required
EXTERNAL_ID VARCHAR,
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR,
ALIAS_LABEL VARCHAR,
--braze_id can only be used to update existing users created through the Braze SDK
BRAZE_ID VARCHAR
)
GO
Sur la page Créer une synchronisation d’importation, définissez le Type de données sur Supprimer des utilisateurs afin que les actions appropriées soient effectuées lors de l’exécution de l’intégration. Pour plus d’informations, consultez Supprimer des utilisateurs avec Cloud Data Ingestion.

La suppression de profils utilisateur est irréversible. L’action de suppression retire définitivement les utilisateurs, ce qui peut entraîner des écarts dans vos données. Pour plus de détails, consultez Effets de la suppression des profils utilisateur.
Étape 5 : Obtenir la chaîne de connexion de l’entrepôt
Pour récupérer l’endpoint SQL de votre entrepôt, accédez à l’espace de travail dans Fabric, survolez le nom de l’entrepôt dans la liste des éléments, puis sélectionnez Copier la chaîne de connexion SQL.

Étape 6 : Autoriser les adresses IP de Braze dans votre pare-feu (facultatif)
Selon la configuration de votre compte Microsoft Fabric, vous devrez peut-être autoriser les adresses IP suivantes dans votre pare-feu afin de permettre le trafic provenant de Braze. Pour savoir comment l’activer, consultez la documentation sur Entra Conditional Access.
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.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Pour l’instance US-08, voici les adresses IP correspondantes :
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Pour l’instance US-10, voici les adresses IP correspondantes :
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Pour l’instance AU-01, voici les adresses IP correspondantes :
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Pour l’instance ID-01, voici les adresses IP correspondantes :
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Pour l’instance JP-01, voici les adresses IP correspondantes :
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Pour l’instance KR-01, voici les adresses IP correspondantes :
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Étape 7 : Créer une nouvelle source dans le tableau de bord de Braze
Dans le tableau de bord de Braze, accédez à Paramètres des données > Ingestion de données cloud > Sources, sélectionnez Ajouter une source de données, puis sélectionnez Microsoft Fabric.
Étape 7.1 : Ajouter les informations de connexion Microsoft Fabric
Choisissez un nom pour votre source et saisissez vos identifiants et votre configuration Microsoft Fabric.
- Nom des identifiants est un libellé qui désigne ces identifiants dans Braze. Choisissez une valeur qui vous aidera à les reconnaître.
- Saisissez les identifiants de la méthode d’authentification que vous avez configurée à l’étape 1. Saisissez Tenant ID, Principal ID, and Client Secret.
- Pour la Chaîne de connexion, consultez l’étape 5.
Étape 7.2 : Tester la connexion et se connecter à la source
Sélectionnez ensuite Tester la connexion. Une fois le test réussi, finalisez les paramètres restants et cliquez sur Se connecter à la source. Si la connexion échoue, un message d’erreur s’affiche pour vous aider à résoudre le problème.

Vous devez tester une source avec succès avant de pouvoir la créer. Si vous fermez la page de création, votre source n’est pas enregistrée.
Étape 8 : Créer une nouvelle synchronisation dans le tableau de bord de Braze
Allez dans Paramètres des données > Ingestion de données cloud > Synchronisations, puis sélectionnez Créer une synchronisation de données.
Configurer les détails de la synchronisation et définir vos données
Saisissez un nom pour votre synchronisation. Sélectionnez ensuite une source active et un type de données de synchronisation. Choisissez ensuite un mode de synchronisation et définissez vos données. Sélectionnez enfin Prévisualiser et valider.
Une fois la validation réussie, un aperçu des données s’affiche. Sélectionnez Suivant : Notifications pour continuer. Si la validation échoue, un message d’erreur s’affiche pour vous aider à résoudre le problème.

Vous devez valider une synchronisation avant de passer aux étapes suivantes. Si vous devez fermer la page de création de la synchronisation, sélectionnez Enregistrer comme brouillon pour conserver votre travail en cours.
Ajouter des préférences de notification
Saisissez une ou plusieurs adresses e-mail de contact pour recevoir les notifications d’erreurs de synchronisation. Braze utilise ces coordonnées pour vous informer des erreurs d’intégration, comme une perte inattendue de l’accès à une table.
Les adresses e-mail de contact reçoivent uniquement les notifications d’erreurs globales ou au niveau de la synchronisation, par exemple des tables manquantes ou des problèmes d’autorisations. Elles ne sont pas notifiées des problèmes au niveau des lignes. Les erreurs globales signalent des problèmes critiques de connexion qui empêchent l’exécution des synchronisations.
Il peut notamment s’agir des problèmes suivants :
- Problèmes de connectivité
- Manque de ressources
- Problèmes d’autorisations
- Espace insuffisant pour le niveau de catalogue (synchronisations de catalogues uniquement)
Définir la planification
Enfin, configurez votre synchronisation comme ponctuelle ou récurrente.
Les synchronisations ponctuelles s’exécutent uniquement lorsque vous sélectionnez Synchroniser maintenant dans le tableau de bord ou que vous appelez l’endpoint Déclencher une synchronisation.
Les synchronisations récurrentes peuvent s’exécuter aussi souvent que toutes les 5 minutes ou aussi rarement qu’une fois par mois. Par défaut, l’intervalle le plus court que vous pouvez définir dans le tableau de bord est de 15 minutes, ce qui vous aide à maîtriser les coûts de calcul de votre entrepôt de données et le volume de requêtes. Pour synchroniser jusqu’à toutes les 5 minutes, contactez le support Braze ou votre gestionnaire de la satisfaction client. Braze planifie les synchronisations récurrentes en UTC.

Vous devez valider une intégration avant qu’elle puisse passer de l’état Brouillon à l’état Actif. Si vous fermez la page de création, votre intégration est enregistrée et vous pouvez revenir sur la page de détails pour apporter des modifications et la valider.
Exécuter la synchronisation
Une fois activée, votre synchronisation s’exécute selon la planification configurée lors de la configuration. Pour lancer la synchronisation en dehors de sa planification ou récupérer les données les plus récentes, sélectionnez Synchroniser maintenant. Cette exécution n’a aucune incidence sur les synchronisations planifiées à venir. Pour démarrer automatiquement une synchronisation lorsque vos données sont mises à jour, appelez l’endpoint Déclencher une synchronisation depuis votre pipeline.
Configurer des intégrations ou des utilisateurs supplémentaires (facultatif)
Vous pouvez configurer plusieurs intégrations avec Braze. Lorsque vous créez des synchronisations supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte Fabric.
Si vous réutilisez le même utilisateur dans plusieurs intégrations, vous ne pourrez pas le supprimer dans le tableau de bord de Braze tant qu’il n’aura pas été retiré de toutes les synchronisations actives.
Utiliser Microsoft Fabric comme source connectée
Une source connectée est une alternative zéro copie à la synchronisation des données dans Braze. Braze interroge directement votre entrepôt Fabric pour créer des segments CDI, sans copier les données sous-jacentes. Pour en savoir plus sur les concepts, les limites et l’impact sur les coûts, consultez la page Sources connectées.
Étape 1 : Configurer l’authentification et accorder l’accès
Suivez la configuration décrite aux étapes 1, 2 et 3. Récupérez ensuite la chaîne de connexion de l’entrepôt comme indiqué à l’étape 5, puis autorisez les adresses IP de Braze comme indiqué à l’étape 6.
Dans votre espace de travail Fabric, configurez les données sources et accordez les autorisations à votre principal de service. La source connectée peut référencer une ou plusieurs tables. Assurez-vous donc que votre principal de service Braze a accès à toutes les tables que vous souhaitez inclure dans la source connectée.
Étape 2 : Créer la source connectée dans Braze
Accédez à Paramètres des données > Ingestion de données cloud > Sources connectées, sélectionnez Ajouter une source de données, puis Microsoft Fabric.
Dans Configurer la source, renseignez les éléments suivants :
- Identifiants : Nom des identifiants, Chaîne de connexion et les champs correspondant à votre méthode d’authentification. Saisissez Tenant ID, Principal ID, and Client Secret.
- Configuration : Base de données et Schéma
Si l’option Se connecter avec un tunnel SSH est disponible dans votre espace de travail et nécessaire à votre configuration, renseignez également Hôte du tunnel, Port du tunnel et Nom d’utilisateur du tunnel.
Choisissez un nom pour la source connectée. Ce nom apparaît dans la liste des sources disponibles lorsque vous créez une nouvelle extension de segment CDI.
Définissez une durée d’exécution maximale pour cette source. Braze interrompt automatiquement toute requête qui dépasse cette durée. La durée d’exécution maximale autorisée est de 60 minutes ; une durée plus courte réduit 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.

Si vos 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’augmenter la capacité Fabric.
Sélectionnez Tester la connexion pour vérifier que la liste des tables visibles par l’utilisateur correspond à vos attentes, puis sélectionnez Terminé. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.
Vous pouvez configurer plusieurs sources connectées avec Braze, mais chaque source doit se connecter à un schéma 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 Azure.
Formater un payload à partir de colonnes existantes
Si vous préférez stocker chaque attribut dans sa propre colonne en interne, vous devez convertir ces colonnes en chaîne de caractères JSON pour alimenter la synchronisation avec Braze. Utilisez cette requête dans Microsoft Fabric pour formater les colonnes sources en champs CDI.
CREATE TABLE [braze].[users] (
attribute_1 VARCHAR,
attribute_2 VARCHAR,
attribute_3 VARCHAR,
attribute_4 VARCHAR,
user_id VARCHAR
)
GO
CREATE VIEW [braze].[user_update_example]
AS SELECT
user_id as EXTERNAL_ID,
CURRENT_TIMESTAMP as UPDATED_AT,
JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD
FROM [braze].[users] ;
Pour plus de conseils d’optimisation, consultez les bonnes pratiques de l’ingestion de données cloud.
Résolution des problèmes
Le test de connexion est lent
Le test de connexion s’exécute sur votre entrepôt de données. Augmenter la capacité peut donc améliorer sa rapidité.
Le secret du principal de service a expiré
Azure n’autorise pas d’expiration illimitée pour les secrets de principal de service. Si les synchronisations commencent à échouer avec des erreurs d’authentification, actualisez le secret client dans Microsoft Entra ID et mettez à jour les identifiants dans Braze.
Où exécuter les vérifications SQL
Exécutez les vérifications de validation directement dans l’éditeur de requêtes SQL de Fabric, sur la même table ou vue que celle utilisée par votre intégration CDI. Fabric ne prend pas en charge LIMIT. Utilisez donc une syntaxe équivalente, comme TOP.
Pages connexes
- Configuration de la table pour connaître les colonnes requises et le formatage du payload
- Bonnes pratiques pour la planification des synchronisations et l’utilisation efficace des points de données
- Journaux de synchronisation et observabilité pour surveiller les exécutions de synchronisation
- FAQ pour les questions fréquentes communes à toutes les sources