Questions fréquemment posées

Cette page contient des réponses à certaines questions fréquemment posées concernant l’ingestion de données cloud.

Pourquoi ai-je reçu un e-mail : « Erreur dans la synchronisation CDI » ?

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 mise en place 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 de caractères 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 l’ensemble des exigences relatives aux payloads, consultez Configuration des tables pour l’ingestion de données cloud.

Comment corriger les erreurs pour 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 possè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.

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 futures 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 où 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 mettez à jour les valeurs d’un enregistrement après qu’il a été traité par une synchronisation, mais vous laissez UPDATED_AT inchangé.
• Vous ajoutez ou mettez à jour 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 importations CDI volumineuses ?

Oui. Pour les exécutions à haut volume (par exemple, plus d’environ 10 millions de lignes), assurez-vous que vos données sources possèdent des valeurs UPDATED_AT majoritairement distinctes. Si trop de lignes partagent le même horodatage, le 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ée.

Pour plus d’informations sur le comportement aux limites du CDI, consultez Éviter la resynchronisation de 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 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

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

1. Identifiez la table ou vue source CDI exacte ainsi que 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 le 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 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 pour identifier les horodatages avec un nombre de lignes anormalement élevé.
5. Si de nombreuses lignes partagent des horodatages identiques, ajustez votre processus d’ingestion afin que les lots consécutifs utilisent des valeurs UPDATED_AT progressivement plus récentes, ou augmentez la précision des horodatages pour 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 encore prendre plusieurs minutes ?

Une synchronisation CDI inclut une période de démarrage fixe avant que le traitement des lignes ne commence. 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 termes 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, s’il y a plusieurs lignes avec le même EXTERNAL_ID dans la table lors d’une synchronisation, nous ne pouvons pas garantir quelle valeur se retrouvera 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 de 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 basculement 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 l’ingestion de données cloud (CDI) ?

Nos mesures

Braze a mis en place les mesures suivantes pour l’ingestion de données cloud :

• 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 effectuons des requêtes vers les 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é :

• Restreignez l’accès aux identifiants au minimum requis pour le fonctionnement de l’ingestion de données cloud. 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.