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 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 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 plus d’informations, consultez Fonctionnement.

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

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

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

Cela peut signifier que les identifiants saisis dans CDI sont incorrects ou mal configurés dans l’entrepôt de données. Pour plus d’informations, consultez Intégrations d’entrepôts de données.

La table est introuvable

Essayez de mettre à jour votre intégration avec la bonne configuration de base de données ou de créer 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. Un catalogue peut avoir été 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 » ?

Cet e-mail signifie que certaines de vos données n’ont pas pu être traitées pendant la synchronisation. Pour identifier 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 signifie 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 manières suivantes :

• Une chaîne de caractères au format ISO 8601, ou
• 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 de test de connexion et les e-mails du support ?

• snowflake
• redshift
• bigquery
• databricks

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 que vous souhaitez modifier. 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 survient lorsque vous essayez de mettre à jour les préférences de notification d’une intégration CDI alors que plusieurs espaces de travail ont des 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 dont une intégration CDI utilise 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 résolu, vous pouvez mettre à jour les préférences de notification.

L’erreur ne devrait plus s’afficher, 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 une valeur UPDATED_AT future est synchronisée avec une intégration ?

CDI s’appuie sur UPDATED_AT pour identifier les nouvelles données. Une fois qu’une valeur UPDATED_AT future a été synchronisée, les données antérieures à cette date et heure ne sont plus traitées. Pour corriger ce problème :

1. Corrigez la valeur UPDATED_AT.
2. Supprimez 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 affiché dans mon entrepôt de données ?

CDI s’appuie sur UPDATED_AT pour déterminer quels enregistrements récupérer lors d’une synchronisation. Consultez cette illustration pour en comprendre le fonctionnement. Au début de chaque synchronisation, CDI interroge votre entrepôt de données afin de 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 sur l’horodatage limite peuvent également ê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 qui a déjà été traitée.
• Vous modifiez les valeurs d’enregistrements après leur traitement 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 avoir des valeurs UPDATED_AT majoritairement distinctes pour les importations CDI volumineuses ?

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 resélectionner des lignes aux horodatages limites lors des exécutions suivantes. Cela peut multiplier les synchronisations en double et augmenter 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 aux 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 table ou la vue utilisée par votre intégration CDI :

• Snowflake : Projects > Worksheets (pour plus d’informations, consultez Feuilles de calcul Snowflake)
• Redshift : Query Editor v2 (pour plus d’informations, consultez Utiliser Amazon Redshift Query Editor v2)
• BigQuery : espace de travail SQL de BigQuery Studio (pour plus d’informations, consultez Présentation de BigQuery Studio)
• Databricks : éditeur SQL (entrepôt SQL) (pour plus d’informations, consultez Éditeur SQL Databricks)
• 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 CDI ainsi que la fenêtre de synchronisation à valider.
2. Ouvrez l’éditeur SQL de votre entrepôt et sélectionnez la base de données et le schéma 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 par UPDATED_AT et compte les lignes 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. Relancez les deux requêtes jusqu’à ce que la concentration diminue, puis lancez ou faites monter en charge votre synchronisation.
7. Après le lancement, surveillez CDI > Journal de synchronisation pour détecter tout volume inattendu de resynchronisation 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 comme 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 similaire quelle que soit la taille de la synchronisation, une petite synchronisation peut quand même prendre plusieurs minutes et sembler plus lente en nombre de lignes par minute. La durée totale de la synchronisation dépend toujours de la complexité de votre requête source, de la structure de vos données et de la capacité disponible dans votre entrepôt de données. Pour plus d’informations, consultez Intégrations d’entrepôts de données.

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

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

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

Si l’option Mettre à jour uniquement les utilisateurs existants est activée dans votre intégration CDI, seuls les utilisateurs déjà présents dans Braze sont mis à jour, et aucun nouvel utilisateur n’est créé. Ainsi, toute ligne de votre table de synchronisation dont l’EXTERNAL_ID ne correspond à aucun utilisateur Braze existant 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. Pour cela, 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é à ceux-ci.
• Nous utilisons des connexions chiffrées pour récupérer les données dans 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 les mêmes connexions TLS 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 concernées.
• Limitez les adresses IP autorisées à accéder aux tables aux adresses IP de Braze officiellement publiées.