Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, ouvrez un ticket sur GitHub.

Foire aux questions

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

Pourquoi ai-je reçu l’e-mail suivant : « 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, reportez-vous à la section 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 créez les ressources correspondantes dans l’entrepôt de données, telles que database/table.

Le catalogue est introuvable

Le catalogue configuré dans l’intégration n’existe pas dans le catalogue de 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 dont le nom correspond à celui défini dans l’intégration.

Pourquoi ai-je reçu l’e-mail suivant : « Erreurs de ligne dans votre synchronisation CDI » ?

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 précise, consultez les journaux dans Braze en accédant à CDI > Journal de synchronisation.

Comment corriger les erreurs liées à Test Connection et aux e-mails d’assistance ?

Le test de connexion est lent

Le test de connexion s’exécute sur votre entrepôt de données : augmenter la capacité de l’entrepôt peut donc améliorer sa rapidité. L’utilisation d’une instance SQL serverless permet de réduire le temps de préchauffage et d’améliorer le débit des requêtes, mais peut entraîner des coûts d’intégration légèrement plus élevés.

Erreur de connexion à l’instance Snowflake : la requête entrante avec cette IP n’est pas autorisée à accéder à Snowflake

Essayez d’ajouter les adresses IP officielles de Braze à votre liste d’autorisation. Pour plus d’informations, reportez-vous à la section Intégrations d’entrepôts de données, ou autorisez les adresses IP correspondantes :

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.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Par exemple US-08, voici les adresses IP concernées :

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Par exemple US-10, voici les adresses IP concernées :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Par exemple AU-01, voici les adresses IP concernées :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Par exemple ID-01, voici les adresses IP concernées :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Par exemple JP-01, voici les adresses IP concernées :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Erreur lors de l’exécution SQL due à la configuration client : 002003 (42S02) : erreur de compilation SQL : n’existe pas ou non autorisé

Si la table n’existe pas, créez-la. Si elle existe déjà, vérifiez que l’utilisateur et le rôle disposent des autorisations de lecture sur cette table.

Impossible d’utiliser le schéma

Si vous recevez cette erreur, accordez l’accès à ce schéma pour l’utilisateur ou le rôle spécifié.

Impossible d’utiliser le rôle

Si vous recevez cette erreur, autorisez cet utilisateur à utiliser le rôle spécifié.

Accès utilisateur désactivé

Si vous recevez cette erreur, autorisez cet utilisateur à accéder à votre compte Snowflake.

Erreur de connexion à l’instance Snowflake avec la clé actuelle et l’ancienne clé

Si vous recevez cette erreur, assurez-vous que l’utilisateur utilise la clé publique actuelle telle qu’affichée dans votre tableau de bord de Braze.

Le test de connexion est lent

Accès refusé pour la relation {table_name}

Si vous recevez cette erreur :

Accordez la permission usage sur le schéma pour cet utilisateur.
Accordez la permission select sur la table pour cet utilisateur.

Erreur de création de connexion

Si vous recevez cette erreur, vérifiez que l’endpoint et le port Redshift sont corrects.

Erreur de création du tunnel SSH

Si vous recevez cette erreur :

Vérifiez que la clé publique affichée dans votre tableau de bord de Braze est bien présente sur l’hôte EC2 utilisé pour le tunnel SSH.
Vérifiez que votre nom d’utilisateur est correct.
Vérifiez que le tunnel SSH est correct.

Le test de connexion est lent

L’utilisateur n’a pas la permission d’interroger la table

Si vous recevez cette erreur, ajoutez les autorisations nécessaires pour que l’utilisateur puisse interroger la table.

Votre utilisation a dépassé le quota personnalisé

Si vous recevez cette erreur, votre quota doit être mis à jour pour que vous puissiez continuer à synchroniser au rythme actuel.

Table introuvable dans l’emplacement {region}

Si vous recevez cette erreur, vérifiez que votre table se trouve dans le bon projet et le bon ensemble de données.

Signature JWT invalide

Si vous recevez cette erreur, vérifiez que le service API BigQuery est activé pour votre compte.

Le test de connexion est lent

Le test de connexion s’exécute sur votre entrepôt de données : augmenter la capacité de l’entrepôt peut donc améliorer sa rapidité. Pour Databricks, il peut y avoir deux à cinq minutes de préchauffage lorsque Braze se connecte aux instances SQL Classic et Pro, ce qui entraîne des délais lors de la configuration et des tests de connexion, ainsi qu’au début des synchronisations planifiées. L’utilisation d’une instance SQL serverless permet de réduire ce temps de préchauffage et d’améliorer le débit des requêtes, mais peut entraîner des coûts d’intégration légèrement plus élevés.

La commande a échoué car l’entrepôt était arrêté

Si vous recevez cette erreur, assurez-vous que l’entrepôt Databricks est en cours d’exécution.

Service : Amazon S3 ; Code d’état : 403 ; Code d’erreur : 403 Forbidden

Si vous recevez cette erreur, consultez Databricks : Erreur Forbidden lors de l’accès aux données S3.

Comment mettre à jour mes préférences d’alerte 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 mettre à jour. Dans la section Préférences de notification, vous pouvez modifier la façon dont vous recevez les alertes pour 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. Une fois qu’un UPDATED_AT situé dans le futur a été synchronisé, toutes les données antérieures à cette date et heure ne seront pas traitées. Pour corriger cela :

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

Pourquoi le nombre de « lignes synchronisées » ne correspond-il pas à celui de mon entrepôt ?

CDI utilise UPDATED_AT pour décider quels enregistrements récupérer lors d’une synchronisation. Consultez cette illustration pour comprendre le fonctionnement. Au début d’une 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 des enregistrements après leur traitement 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 la prise en compte de certains enregistrements.

tip:

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.

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 prises en compte une fois la synchronisation terminée.

Pourquoi les nouveaux utilisateurs ne sont-ils pas créés à partir 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éé. 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 l’option Mettre à jour uniquement les utilisateurs existants dans les paramètres de votre intégration. Rendez-vous dans Paramètres des données > Ingestion de données dans le cloud et sélectionnez une intégration.

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

Nos mesures

Braze dispose des mesures suivantes pour CDI :

Toutes les informations d’identification sont chiffrées dans notre base de données, et seuls certains employés y ont accès après authentification.
Nous utilisons des connexions chiffrées pour récupérer les données depuis les entrepôts 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 (sécurité de la couche de transport) que nous recommandons à nos clients d’utiliser.
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é :

Restreindre l’accès des identifiants au minimum requis pour le fonctionnement de CDI. En effet, nous devons être en mesure d’exécuter des requêtes select (et count) sur les tables et vues spécifiques.
Restreindre les adresses IP pouvant accéder aux tables aux IP Braze publiées officiellement.

Modifier cette page sur GitHub

New Stuff!