Questions fréquemment posées

Cette page répond à certaines questions fréquemment posées sur l’ingestion de données cloud.

À quelle fréquence une synchronisation CDI peut-elle s’exécuter ?

Les synchronisations récurrentes peuvent s’exécuter jusqu’à 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 permet de 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 de Braze ou votre gestionnaire de la satisfaction client. Pour synchroniser dès que vos données changent, appelez l’endpoint Déclencher une synchronisation. Pour en savoir plus, consultez la section Fonctionnement.

Pourquoi ai-je reçu un e-mail « Error in CDI Sync » ?

Ce type d’e-mail signale généralement un problème dans la configuration de votre CDI. Voici quelques problèmes courants et la manière de les résoudre :

CDI ne parvient pas à accéder à l’entrepôt de données ou à la table avec vos identifiants

Les identifiants saisis dans CDI sont peut-être incorrects, ou mal configurés dans l’entrepôt de données. Pour en savoir plus, consultez les étapes de configuration sur votre page source.

La table est introuvable

Mettez à jour votre intégration avec la bonne configuration de base de données, ou créez les ressources correspondantes dans l’entrepôt de données, comme database/table.

Le catalogue est introuvable

Le catalogue configuré dans l’intégration n’existe pas dans les catalogues Braze. Il a pu être supprimé après la configuration de l’intégration. Pour résoudre le problème, mettez à jour l’intégration afin d’utiliser un autre catalogue, ou créez un nouveau catalogue dont le nom correspond à celui indiqué dans l’intégration.

Pourquoi ai-je reçu l’e-mail « Row errors in your CDI sync » ?

Ce type d’e-mail indique que certaines de vos données n’ont pas pu être traitées pendant la synchronisation. Pour connaître l’erreur précise, consultez les journaux dans Braze en accédant à CDI > Journal de synchronisation.

Comment corriger l’erreur « Time must be string in ISO8601 Format » lors de la configuration de CDI ?

Cette erreur indique que la valeur time de l’événement dans votre payload CDI n’utilise pas un format de date et d’heure pris en charge.

Pour les payloads d’événements et d’achats, formatez time de l’une des façons suivantes :

• Une chaîne de caractères au format ISO 8601
• yyyy-MM-dd'T'HH:mm:ss:SSSZ

Si time est omis, Braze utilise UPDATED_AT comme heure de l’événement.

Pour connaître toutes les exigences relatives au payload, consultez Configuration des tables pour l’ingestion de données cloud.

Comment corriger les erreurs liées à Tester la connexion et aux e-mails d’assistance ?

Tester la connexion s’exécute sur votre entrepôt de données : augmenter la capacité de votre entrepôt peut donc en améliorer la vitesse. Une instance SQL serverless réduit le temps de démarrage et améliore le débit des requêtes, mais elle peut entraîner des coûts d’intégration légèrement plus élevés.

Pour les messages d’erreur propres à votre source, consultez la section de résolution des problèmes sur la page de cette source :

Comment mettre à jour mes préférences d’alertes par e-mail pour les intégrations CDI ?

Chaque intégration dispose de ses propres préférences de notification. Accédez à la page CDI et sélectionnez le nom de l’intégration à mettre à jour. Dans la section Préférences de notification, vous pouvez choisir comment recevoir les alertes concernant l’intégration sélectionnée.

Pourquoi l’erreur « Incorrect Integration Object » s’affiche-t-elle ?

Cette erreur se produit lorsque vous tentez de mettre à jour les préférences de notification d’une intégration CDI alors que deux espaces de travail ou plus disposent d’intégrations pointant vers le même compartiment ou dossier de stockage cloud. Chaque emplacement de stockage cloud ne peut être utilisé que par une seule intégration à la fois.

Pour résoudre ce problème :

1. Identifiez l’autre espace de travail qui dispose d’une intégration CDI utilisant le même emplacement de stockage.
2. Supprimez ou reconfigurez l’intégration en conflit dans cet autre espace de travail.
3. Une fois le conflit supprimé, vous pouvez mettre à jour les préférences de notification.

L’erreur ne devrait plus apparaître, et vous devriez pouvoir mettre à jour vos préférences de notification. Si le problème persiste, ouvrez un ticket d’assistance.

Que se passe-t-il si un UPDATED_AT futur est synchronisé avec une intégration ?

La CDI utilise UPDATED_AT pour déterminer quelles données sont nouvelles. Une fois qu’un UPDATED_AT futur a été synchronisé, toutes les données antérieures à cette date et heure futures ne seront pas traitées. Pour corriger ce problème :

1. Corrigez UPDATED_AT.
2. Supprimez toutes les anciennes données déjà synchronisées avec Braze.
3. Créez une nouvelle intégration pour traiter à nouveau cette table.

Pourquoi « Lignes synchronisées » ne correspond-il pas au nombre de lignes dans mon entrepôt ?

CDI s’appuie sur UPDATED_AT pour déterminer les enregistrements à récupérer lors d’une synchronisation. Consultez cette illustration pour comprendre son fonctionnement. Au début de chaque synchronisation, CDI interroge votre entrepôt de données pour récupérer tous les enregistrements dont la valeur UPDATED_AT est postérieure à la dernière valeur UPDATED_AT traitée. Les enregistrements situés exactement à l’horodatage limite peuvent aussi être resynchronisés si de nouvelles lignes partagent cet horodatage. Tout enregistrement récupéré au moment de l’exécution de la requête est synchronisé dans Braze. Voici les cas les plus courants dans lesquels un enregistrement peut ne pas être synchronisé :

• Vous ajoutez des enregistrements à la table avec une valeur UPDATED_AT déjà traitée.
• Vous modifiez les valeurs d’enregistrements déjà traités par une synchronisation, sans mettre à jour UPDATED_AT.
• Vous ajoutez ou modifiez des enregistrements pendant une synchronisation. Selon le moment où la requête CDI s’exécute, des conditions de concurrence peuvent empêcher la récupération de certains enregistrements.

Conseil

Pour éviter ces situations à l’avenir, nous vous recommandons d’utiliser des valeurs UPDATED_AT strictement croissantes et de ne pas modifier la table pendant vos synchronisations planifiées.

Dois-je utiliser des valeurs UPDATED_AT majoritairement distinctes pour les imports CDI volumineux ?

Oui. Pour les exécutions à fort volume (par exemple, plus d’environ 10 millions de lignes), assurez-vous que vos données sources comportent des valeurs UPDATED_AT majoritairement distinctes. Si trop de lignes partagent le même horodatage, CDI risque davantage de sélectionner à nouveau les lignes situées aux horodatages limites lors des exécutions suivantes. Cela peut augmenter les synchronisations en double et la consommation de points de données.

Pour en savoir plus sur le comportement de CDI aux horodatages limites, consultez Éviter de resynchroniser les lignes avec des horodatages en double.

Où exécuter ces vérifications SQL ?

Exécutez les vérifications directement dans l’éditeur SQL de votre entrepôt de données, sur la même table ou vue que celle utilisée par votre intégration CDI :

• Snowflake : Projects > Worksheets (pour en savoir plus, consultez Snowflake Worksheets)
• Redshift : Query Editor v2 (pour en savoir plus, consultez Using Amazon Redshift Query Editor v2)
• BigQuery : espace de travail SQL de BigQuery Studio (pour en savoir plus, consultez BigQuery Studio introduction)
• Databricks : éditeur SQL (entrepôt SQL) (pour en savoir plus, consultez Databricks SQL editor)
• Fabric : éditeur de requêtes SQL

Suivez cette procédure avant d’activer ou de faire monter en charge une synchronisation volumineuse :

1. Identifiez précisément la table ou la vue source de CDI ainsi que la fenêtre de synchronisation à valider.
2. Ouvrez l’éditeur SQL de votre entrepôt et sélectionnez la même base de données et le même schéma que ceux utilisés par CDI, puis utilisez un rôle disposant d’un accès en lecture à la table ou à la vue source.
3. Exécutez la requête de comptage des horodatages distincts pour mesurer le nombre de valeurs UPDATED_AT distinctes dans cette fenêtre.
4. Exécutez la requête qui regroupe les lignes par UPDATED_AT et les compte, afin de repérer les horodatages présentant un nombre de lignes anormalement élevé.
5. Si de nombreuses lignes partagent des horodatages identiques, ajustez votre processus d’ingestion pour que les lots consécutifs utilisent des valeurs UPDATED_AT de plus en plus récentes, ou augmentez la précision des horodatages afin de mieux répartir les lignes.
6. Exécutez à nouveau les deux requêtes jusqu’à ce que la concentration diminue, puis lancez votre synchronisation ou faites-la monter en charge.
7. Après le lancement, surveillez CDI > Journal de synchronisation pour détecter tout volume de resynchronisation inattendu aux horodatages limites.

Utilisez des vérifications comme celles-ci dans votre entrepôt :

1
2
3
4
5
6
7

SELECT
  COUNT(*) AS total_rows,
  COUNT(DISTINCT UPDATED_AT) AS distinct_timestamps,
  ROUND(COUNT(*) * 1.0 / NULLIF(COUNT(DISTINCT UPDATED_AT), 0), 2) AS avg_rows_per_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP);

1
2
3
4
5
6
7
8
9

SELECT
  UPDATED_AT,
  COUNT(*) AS rows_at_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP)
GROUP BY UPDATED_AT
ORDER BY rows_at_timestamp DESC
LIMIT 20;

Si votre entrepôt ne prend pas en charge LIMIT (par exemple, Fabric), utilisez une syntaxe équivalente telle que TOP.

Pourquoi une synchronisation CDI comportant peu de lignes peut-elle quand même prendre plusieurs minutes ?

Une synchronisation CDI comprend une phase de démarrage fixe avant le début du traitement des lignes. Comme cette durée de démarrage est à peu près la même quelle que soit la taille de la synchronisation, une petite synchronisation peut tout de même prendre plusieurs minutes et sembler plus lente en nombre de lignes par minute. La durée totale de la synchronisation dépend également de la complexité de votre requête source, de la structure des données et de la capacité disponible dans votre entrepôt de données. Pour plus d’informations, consultez Sources de l’ingestion de données cloud.

Lors d’une synchronisation, l’ordre est-il conservé si plusieurs enregistrements partagent le même ID ?

L’ordre de traitement n’est pas entièrement prévisible. Par exemple, si plusieurs lignes ont le même EXTERNAL_ID dans la table lors d’une synchronisation, nous ne pouvons pas garantir quelle valeur sera retenue dans le profil final. Si vous mettez à jour le même EXTERNAL_ID avec des attributs différents dans la colonne payload, toutes les modifications sont prises en compte à la fin de la synchronisation.

Pourquoi aucun nouvel utilisateur n’est-il créé par ma synchronisation CDI ?

Si l’option Mettre à jour uniquement les utilisateurs existants est activée pour votre intégration CDI, seuls les utilisateurs qui existent déjà dans Braze sont mis à jour, et aucun nouvel utilisateur n’est créé. Ainsi, si une ligne de votre table de synchronisation fait référence à un EXTERNAL_ID qui ne correspond à aucun utilisateur Braze existant, cette ligne est ignorée.

Pour créer de nouveaux utilisateurs via CDI, désactivez l’option Mettre à jour uniquement les utilisateurs existants dans les paramètres de votre intégration. Accédez à Paramètres des données > Ingestion de données cloud, puis sélectionnez une intégration.

Quelles sont les mesures de sécurité pour la CDI ?

Nos mesures

Braze a mis en place les mesures suivantes pour la CDI :

• Tous les identifiants sont chiffrés dans notre base de données, et seuls certains employés disposent d’un accès authentifié à ces identifiants.
• Nous utilisons des connexions chiffrées pour acheminer les données vers les entrepôts de données des clients.
• Nous envoyons nos requêtes aux endpoints de l’API de Braze avec les mêmes clés API et connexions TLS (sécurité de la couche de transport) que celles que nous recommandons à nos clients.
• Nous mettons régulièrement à jour nos bibliothèques et appliquons tous les correctifs de sécurité.

Vos mesures

Nous vous recommandons, à vous et à votre équipe, de mettre en place les mesures de sécurité suivantes de votre côté :

• Limitez l’accès des identifiants au strict minimum nécessaire au fonctionnement de la CDI. En effet, nous devons pouvoir exécuter des requêtes select (et count) sur les tables et vues spécifiques.
• Limitez les IP autorisées à accéder aux tables aux IP officiellement publiées par Braze. Chaque page de source répertorie les IP à autoriser pour cette source.