Questions fréquemment posées

Cette page contient des réponses à certaines questions fréquemment posées concernant 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 permet de gérer les coûts de calcul de votre entrepôt de données et le volume de requêtes. Pour synchroniser aussi souvent que toutes les 5 minutes, contactez le support 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 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 avec votre configuration CDI. Voici quelques problèmes courants et comment 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 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 configuration de base de données correcte 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 le catalogue 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 pour utiliser un autre catalogue ou créez un nouveau catalogue correspondant au nom du catalogue dans l’intégration.

Pourquoi ai-je reçu un e-mail intitulé « Row errors in your CDI sync » ?

Ce type d’e-mail signifie que certaines de vos données n’ont pas pu être traitées lors de la synchronisation. Pour identifier l’erreur spécifique, vous pouvez consulter les journaux dans Braze en accédant à CDI > Sync Log.

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

Cette erreur signifie que la valeur time de l’événement dans votre payload CDI n’est pas dans un format datetime pris en charge.

Pour les payloads d’événements et d’achats, formatez time comme suit :

• Une chaîne 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 consulter l’ensemble des exigences relatives aux payloads, référez-vous à Configuration des tables pour l’ingestion de données cloud.

Comment corriger les erreurs de Test Connection et les e-mails de support ?

• snowflake
• redshift
• bigquery
• databricks

Comment mettre à jour mes préférences d’alerte 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 mettre à jour. Dans la section Notification preferences, vous pouvez modifier la manière dont vous recevez 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 et que deux espaces de travail ou plus possèdent 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 quel autre espace de travail possède une intégration CDI utilisant le même emplacement de stockage.
2. Supprimez ou reconfigurez l’intégration en conflit dans l’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 apparaître et vous devriez pouvoir mettre à jour vos préférences de notification avec succès. 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 ?

CDI utilise UPDATED_AT pour déterminer quelles données sont nouvelles. Après la synchronisation d’un UPDATED_AT futur, toutes les données antérieures à cette date et heure future ne seront pas traitées. Pour corriger cela :

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 le nombre de « Rows Synced » ne correspond-il pas au nombre dans mon entrepôt de données ?

CDI utilise UPDATED_AT pour déterminer quels enregistrements récupérer lors d’une synchronisation. Consultez cette illustration pour comprendre le fonctionnement. Au début d’une exécution de synchronisation, CDI interroge votre entrepôt de données pour obtenir 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 également être re-synchronisé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 courants dans lesquels un enregistrement pourrait 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’un enregistrement après qu’il a été traité par une synchronisation, mais vous laissez UPDATED_AT inchangé.
• Vous ajoutez ou modifiez des enregistrements pendant qu’une synchronisation est en cours. Selon le moment où la requête CDI s’exécute, des conditions de concurrence peuvent empêcher certains enregistrements d’être récupérés.

Conseil

Pour éviter ces comportements à l’avenir, nous recommandons d’utiliser des valeurs UPDATED_AT croissantes de manière monotone et de ne pas mettre à jour la table pendant l’exécution de votre synchronisation planifiée.

Ai-je besoin de 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 source ont des valeurs UPDATED_AT majoritairement distinctes. Si trop de lignes partagent le même horodatage, CDI est plus susceptible de resélectionner des lignes aux horodatages limites lors des exécutions suivantes. Cela peut augmenter les synchronisations en double et la consommation de points de données.

Pour plus d’informations sur le comportement des limites CDI, consultez Éviter la resynchronisation des lignes avec des horodatages dupliqués.

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 utilisée par votre intégration CDI :

• Snowflake : Projects > Worksheets (pour plus d’informations, consultez Snowflake Worksheets)
• Redshift : Query Editor v2 (pour plus d’informations, consultez Using Amazon Redshift Query Editor v2)
• BigQuery : BigQuery Studio SQL workspace (pour plus d’informations, consultez BigQuery Studio introduction)
• Databricks : SQL editor (SQL warehouse) (pour plus d’informations, consultez Databricks SQL editor)
• Fabric : SQL query editor

Utilisez ce processus avant d’activer ou de mettre à l’échelle une synchronisation volumineuse :

1. Identifiez la table ou vue source CDI exacte et la fenêtre de synchronisation que vous souhaitez valider.
2. Ouvrez l’éditeur SQL de votre entrepôt de données et sélectionnez la même base de données et le même schéma utilisés par CDI, puis utilisez un rôle disposant d’un accès en lecture à la table ou vue source.
3. Exécutez la requête de comptage d’horodatages distincts pour mesurer combien de valeurs UPDATED_AT distinctes existent dans cette fenêtre.
4. Exécutez la requête qui regroupe par UPDATED_AT et compte les lignes pour trouver les horodatages avec un nombre de lignes anormalement élevé.
5. Si de nombreuses lignes partagent des horodatages identiques, ajustez votre processus d’ingestion de sorte que les lots consécutifs utilisent des valeurs UPDATED_AT progressivement plus récentes, ou augmentez la précision des horodatages afin que les lignes soient mieux réparties.
6. Réexécutez les deux requêtes jusqu’à ce que la concentration soit réduite, puis lancez ou mettez à l’échelle votre synchronisation.
7. Après le lancement, surveillez CDI > Sync Log pour détecter un volume de resynchronisation inattendu aux horodatages limites.

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

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 de données ne prend pas en charge LIMIT (par exemple, Fabric), utilisez une syntaxe équivalente telle que TOP.

Pourquoi une synchronisation CDI avec un petit nombre de lignes peut-elle prendre plusieurs minutes ?

Une synchronisation CDI comprend une phase de démarrage fixe avant le début du traitement des lignes. Comme ce temps de démarrage est similaire 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. Le temps total de synchronisation dépend toujours de la complexité de votre requête source, de la forme des 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 préservé si plusieurs enregistrements partagent le même ID ?

L’ordre de traitement n’est pas prévisible à 100 %. Par exemple, si plusieurs lignes avec le même EXTERNAL_ID figurent 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 différents attributs dans la colonne payload, toutes les modifications sont reflétées une fois la synchronisation terminée.

Pourquoi les nouveaux utilisateurs ne sont-ils pas créés à partir de ma synchronisation CDI ?

Si votre intégration CDI a l’option Update existing users only activée, seuls les utilisateurs qui existent déjà dans Braze sont mis à jour, et aucun nouvel utilisateur n’est créé. Cela signifie que 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 le basculeur Update existing users only dans les paramètres de votre intégration. Accédez à Data Settings > Cloud Data Ingestion et sélectionnez une intégration.

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

Nos mesures

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

• Tous les identifiants sont chiffrés dans notre base de données, et seuls certains employés disposent d’un accès authentifié.
• Nous utilisons des connexions chiffrées pour transférer les données vers les entrepôts de données des clients.
• Nous envoyons des requêtes aux endpoints de l’API Braze en utilisant les mêmes clés API et connexions TLS que celles que nous recommandons à nos clients.
• Nous mettons régulièrement à jour nos bibliothèques et appliquons 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 aux identifiants au minimum requis pour le fonctionnement du CDI. En effet, nous devons pouvoir exécuter des requêtes select (et count) sur les tables et vues spécifiques.
• Restreignez les adresses IP pouvant accéder aux tables aux adresses IP Braze officiellement publiées.