Résoudre les problèmes de Tableau Prep Builder

Cet article répertorie les problèmes que vous pouvez rencontrer en utilisant Tableau Prep Builder et propose des suggestions pour les résoudre.

Lorsque vous résolvez les problèmes de votre flux, que ce soit en le déboguant par vous-même ou pour contacter l’assistance, vous devez généralement collecter les fichiers journaux et les fichiers de vidage sur incident pour les analyser, et également documenter les étapes nécessaires pour reproduire l’erreur. Le meilleur moyen d’aider le développeur ou l’équipe d’assistance à diagnostiquer le problème consiste à fournir les étapes exactes que vous avez suivies avant que l’erreur ne se produise, ainsi que le fichier de flux.

Collecte des fichiers journaux et des fichiers de vidage sur incident

Les fichiers journaux de Tableau Prep sont stockés dans le dossier Mon dossier Tableau Prep. Par défaut, l’emplacement est :

Windows : C:\Users\<username>\Documents\My Tableau Prep Repository\Logs.

MacOS : /users/<username>/Documents/My Tableau Prep Repository/Logs

Pour diagnostiquer correctement le problème, vous devez collecter tous les fichiers journaux. Si vous exécutez Tableau Prep Builder, il s’agit de tout le contenu du dossier « Mon dossier Tableau Prep/Logs ». Si vous exécutez Tableau Prep depuis la ligne de commande, incluez les fichiers journaux de « Mon dossier Tableau Prep/Référentiel de lignes de commande/Journaux ».

Ce tableau décrit les différents fichiers journaux générés.

Nom du fichier journal	Processus qui génère le fichier journal	Description
app.log	Tableau Prep.exe	Fichier journal de l’interface utilisateur. Produit par le code JavaScript exécuté dans le processus Electron.
backendProcessManager.log	Tableau Prep.exe	Produit par le code JavaScript qui démarre et surveille le processus Java.
preprestapi.log	Java.exe	Fichier journal produit par le code Java. Les entrées de journal concernant l’utilisation de l’API REST, la compilation, la gestion du cache, ainsi que le démarrage et l’arrêt du processus tabminerva (anciennement prepservice) doivent se trouver ici.
log.txt	prepservice.exe tabminerva.exe	Ce journal est produit par le code C++. Ce fichier journal inclut toutes les interactions avec la pile technologique partagée Tableau, y compris les connexions aux bases de données, les requêtes, l’exécution, la mise en cache externe, le pipeline de requête, les protocoles, etc.
tdeserver.txt	tdeserver64.exe	Il s’agit du fichier journal créé par l’ancien moteur de données Tableau. Tableau Prep utilise toujours le moteur de données Tableau.
tabprotosrv.txt	tabprotosrv.exe	Journal du serveur de protocoles. Tout ce qui utilise un pilote de base de données hébergé produira des lignes de journal dans ce fichier.
hyperd.log	hyperd.exe	Le journal hyper. Les requêtes et les erreurs liées aux requêtes sont ici.

Activer la journalisation des requêtes

Depuis Tableau Prep Builder version 2026.2, vous pouvez activer le paramètre Activer la journalisation des requêtes dans le menu Aide > Paramètres et Performances sans avoir à redémarrer l’application. Lorsqu’il est activé, ce paramètre génère un fichier de requête XML pour chaque requête exécutée par Tableau Prep Builder. Il peut être utile pour diagnostiquer des problèmes rencontrés avec votre flux. Les fichiers journaux sont générés et stockés dans le dossier Requête.

Menu d’aide dans Tableau Prep affichant les options du menu Paramètres et Performances.

Vous pouvez retrouver ces fichiers journaux de requête dans les répertoires suivants :

Windows : C:\Users\<username>\Documents\My Tableau Prep Repository\Query

MacOS : /users/<username>/Documents/My Tableau Prep Repository/Query

Exécution de LogShark

LogShark est un utilitaire de ligne de commande open source gratuit que vous pouvez utiliser pour extraire des informations des fichiers journaux Prep à des fins de dépannage et d’obtention d’informations sur les erreurs et l’utilisation. Le plug-in LogSharkPrep.twbx vous permet de générer des classeurs avec un tableau de bord des erreurs et des flux qui vous aide à analyser et à visualiser les problèmes Prep.

Pour plus d’informations sur l’installation et l’exécution de LogShark, consultez Configurer votre ordinateur pour LogShark.

Création de fichiers de vidage sur incident

Outre les fichiers journaux, vous souhaitez également collecter des fichiers de vidage sur incident. Tout ce qui ne figure pas dans les fichiers journaux peut être détaillé ici et aider lors du dépannage du démarrage de l’application, des exceptions ou des problèmes lors de l’interrogation de .hyper.

Lors de la création de fichiers de vidage sur incident, il est utile d’en créer pour les processus suivants.

Processus	Description
tabminerva.exe (précédemment prepservice.exe)	Il s’agit du processus natif qui héberge le reste de la logique métier de Tableau Prep. C’est également le processus qui contient la technologie native partagée de Tableau, y compris les connecteurs de base de données.
hyperd.exe	Il s’agit du processus de base de données hyper. À chaque fois qu’une requête échoue. Les vidages sur incident de Hyper peuvent être utiles en cas d’échec parce qu’une grande partie des actions de Tableau Prep implique des requêtes à Hyper.

Pour créer des fichiers de vidage sur incident, procédez comme suit, selon votre système d’exploitation.

Windows

Ouvrez le Gestionnaire de tâches.
Faites un clic droit sur l’en-tête de la colonne et sélectionnez Nom du processus et Ligne de commande. Les différents processus s’affichent et vous pouvez sélectionner celui que vous souhaitez utiliser pour créer un fichier de vidage sur incident.
Cliquez avec le bouton droit de la souris sur le processus de tabminerva.exe (précédemment prepservice.exe).
Sélectionnez Créer un fichier de vidage.
Une boîte de dialogue s’ouvre et affiche l’emplacement du fichier de vidage sur votre système.

MacOS

Sous MacOS, il existe deux types de fichiers de diagnostic utiles pour le dépannage de Tableau Prep :

Rapport d’incident : enregistre la pile des appels au moment de l’incident, de la même manière qu’une trace de pile.
Fichier core : instantané complet de la mémoire du processus au moment de l’arrêt.

La collecte des deux fichiers nécessite l’arrêt du processus Tableau Prep. Vous devrez relancer Tableau Prep après avoir collecté ces fichiers.

Prérequis : l’accès administrateur est requis pour la collecte de fichiers de base.

Étape 1 : Créer un rapport d’incident

Ouvrez le Terminal.
Exécutez la commande : pgrep tabminerva | xargs kill -SEGV
Elle arrête le processus de tabminerva.exe en lui envoyant un signal d’erreur de segmentation, ce qui entraîne la génération automatique d’un rapport d’incident par MacOS.
Trouvez le rapport d’incident enregistré dans : ~/Library/Logs/DiagnosticReports/
Le nom du fichier est au format tabminerva_YYYY-MM-DD-HHMMSS_machinename.crash ou tabminerva_YYYY-MM-DD-HHMMSS_machinename.ips

Lorsque vous envoyez ce fichier à l’assistance Tableau ou à l’équipe de développement, assurez-vous d’indiquer que vous avez intentionnellement envoyé un signal d’erreur de segmentation pour générer le rapport. C’est ce qui le distingue d’une véritable panne.

Étape 2 : Créer un fichier core

Utilisez l’une des options suivantes pour créer votre fichier core.

Créer un fichier core et terminer la session Tableau Prep

Ouvrez le Terminal.
Exécutez la commande sudo chmod 1777 /cores pour accorder un accès en écriture au répertoire de fichier core.
Exécutez la commande ulimit -c unlimited pour supprimer la limite de taille du fichier core pour la session actuelle du terminal.
Exécutez la commande pgrep tabminerva | xargs kill -SEGV pour terminer le processus et générer le fichier core.
Recherchez le fichier core qui se trouve dans /cores/ et est nommé core.<process_id>.

Créer un fichier core alors que Tableau Prep est toujours en cours d’exécution

Cette option utilise un utilitaire gcore pour capturer un vidage de mémoire d’un processus en cours d’exécution sans l’arrêter. Ce processus nécessite l’installation de l’outil de ligne de commande Xcode. Pour vérifier si cette option est installée, ouvrez votre Terminal et exécutez Bash xcode-select --install.

Ouvrez le Terminal.
Exécutez la commande sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)
Cela enregistre le fichier core sur /tmp/tabminerva.core. Tableau Prep continue de s’exécuter normalement.

Erreurs courantes en cas d’utilisation de la ligne de commande pour exécuter des flux

Vous pouvez exécuter des flux depuis la ligne de commande pour actualiser vos fichiers de sortie plutôt que d’ouvrir Tableau Prep Builder et d’exécuter chaque flux manuellement. Ce processus améliore l’efficacité de votre processus de flux, mais si votre syntaxe est incorrecte ou s’il vous manque des identifiants pour vos connexions ou emplacements de sortie, vous recevrez des erreurs lors de l’exécution de ce processus.

Pour une liste de toutes les options de ligne de commande prises en charge dans Tableau Prep, consultez Référence de ligne de commande de Tableau Prep(Le lien s’ouvre dans une nouvelle fenêtre).

Le tableau suivant décrit les erreurs courantes et leurs solutions. Pour des informations sur l’exécution des flux depuis la ligne de commande, consultez Actualiser les fichiers de sortie du flux depuis la ligne de commande(Le lien s’ouvre dans une nouvelle fenêtre).

Erreur	Cause	Solution
« Missing arguments » (Arguments manquants)	Il manque l’un des arguments de ligne de commande obligatoires.	Utilisez « tableau-prep-cli -help » pour voir une liste des arguments pour la ligne de commande.
« Unable to read the connections file. » (Impossible de lire le fichier de connexions)	Le fichier credentials.json contient des erreurs de syntaxe ou de format pour les connexions aux données entrantes.	Vérifiez la syntaxe pour les connexions aux données entrantes dans le fichier .json. Pour plus d’informations et pour des exemples, consultez Actualiser les fichiers de sortie du flux depuis la ligne de commande(Le lien s’ouvre dans une nouvelle fenêtre).
« There are errors in the flow. Unable to run the flow. Check that the credentials .json file includes all required credentials. Open the flow in Tableau Prep Builder to view error details. » (Erreurs dans le flux. Impossible d’exécuter le flux. Vérifiez que le fichier credentials.json inclut toutes les informations d’identification requises. Ouvrez le flux dans Tableau Prep Builder pour afficher les détails de l’erreur.)	Il manque des informations d’identification dans le fichier credentials.json pour les connexions entrantes, ou le flux comporte des erreurs.	Vérifiez que le fichier .json contient les informations d’identification nécessaires pour toutes les connexions, et ouvrez le fichier de flux dans Tableau Prep Builder pour voir s’il y a des erreurs dans le flux. Si le flux contient des erreurs, vous devez les corriger, puis republier le flux sur Tableau Server, puis essayer d’exécuter à nouveau le processus.
« Could not find match for <hostname of inputConnections > » (Impossible de trouver une correspondance pour <hostname of inputConnections >)	Il manque une entrée pour le nom d’hôte (nom du serveur) dans le fichier credentials.json.	Assurez-vous que le fichier credentials.json inclut les informations d’identification correctes pour le nom d’hôte (nom du serveur). Pour plus d’informations et pour des exemples, consultez Actualiser les fichiers de sortie du flux depuis la ligne de commande(Le lien s’ouvre dans une nouvelle fenêtre).
« We don’t have credentials of all connections in tfl/tflx file. The following connection(s) were not found: <hostname of inputConnections> » (Nous n’avons pas les informations d’identification de toutes les connexions dans le fichier tfl/tflx. Les connexions suivantes sont introuvables : <hostname of inputConnections>)	Le fichier credentials.json est manquant ou contient des informations d’identification incorrectes pour le nom d’hôte (nom du serveur) affiché dans le message d’erreur.	Assurez-vous que le fichier credentials.json inclut les informations d’identification correctes pour le nom d’hôte (nom du serveur) indiqué dans le message d’erreur. Pour plus d’informations et pour des exemples, consultez Actualiser les fichiers de sortie du flux depuis la ligne de commande.
« Error signing in server <serverUrl> as a user <userName>. Please check the credentials. » (Erreur de connexion au serveur <serverUrl> en tant qu’utilisateur <userName>. Vérifiez les informations d’identification)	Le fichier credentials.json comporte des informations d’identification incorrectes pour Tableau Server.	Vérifiez que le fichier credentials.json inclut tous les identifiants et éléments corrects pour la connexion de sortie. Pour plus d’informations et pour des exemples, consultez Actualiser les fichiers de sortie du flux depuis la ligne de commande.
« Could not sign in successfully as <userName> to server <serverUrl>(<contentUrl>) » (Impossible de se connecter en tant qu’utilisateur <userName> au serveur <serverUrl> (<contentUrl>))	Le fichier credentials.json comporte des informations d’identification incorrectes pour Tableau Server.	Vérifiez que le fichier credentials.json inclut tous les identifiants et éléments corrects pour la connexion de sortie. Pour plus d’informations et pour des exemples, consultez Actualiser les fichiers de sortie du flux depuis la ligne de commande.
« We don’t have credentials for Tableau Server to publish extract for one or more output nodes in tfl/tflx file. » (Nous n’avons pas les informations d’identification nécessaires pour que Tableau Server publie un extrait pour un ou plusieurs nœuds de sortie dans un fichier tfl/tflx.)	Le fichier credentials.json n’a pas été transmis en tant qu’argument de ligne de commande ou il manque les informations d’identification pour la connexion de sortie.	Vérifiez que le chemin d’accès du fichier credentials.json est inclus dans la ligne de commande et que le fichier credentials.json inclut tous les identifiants et éléments corrects pour la connexion de sortie. Pour plus d’informations et pour des exemples, consultez Actualiser les fichiers de sortie du flux depuis la ligne de commande.
« Loom rest api server not started » (Serveur API REST Loom non démarré)	La configuration de l’installation ou de l’environnement n’est pas correcte.	Vérifiez que Tableau Prep Builder est correctement installé et que vous exécutez la commande en tant qu’administrateur. Pour plus d’informations sur l’installation de Tableau Prep Builder, consultez Installer Tableau Desktop ou Tableau Prep Builder depuis l’interface utilisateur(Le lien s’ouvre dans une nouvelle fenêtre).
« Error. Flow file does not exist. » (Erreur. Le fichier de flux n’existe pas)	Le chemin d’accès au fichier de flux est incorrect.	Vérifiez que la ligne de commande inclut le chemin d’accès correct du fichier de flux.
« Error. Connections file does not exist. » (Erreur. Le fichier de connexions n’existe pas)	Le chemin d’accès du fichier credentials.json est incorrect.	Vérifiez que la ligne de commande inclut le chemin d’accès correct du fichier credentials.json.
« Impossible de trouver la correspondance pour <mapr01:5181>,<mapr02:5181>,<mapr03:5181> »	Vous devez spécifier un ID de port spécifique lors de la connexion à Apache Drill à l’aide de ZooKeeper .	Incluez un fichier credentials.json dans la ligne de commande qui spécifie « port » : 31010 pour les informations d’identification d’entrée.

Erreurs courantes dans Tableau Prep

Le tableau suivant décrit certaines erreurs courantes que vous pouvez rencontrer lors de l’utilisation de Tableau Prep, ainsi que les solutions à essayer.

Erreur	Cause	Solution	Article Knowledge
Impossible de se connecter à Tableau Server. Vérifiez que le serveur est en cours d’exécution et que l’URL est correcte. `tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationException`	Un proxy ou un pare-feu empêche le navigateur intégré de Tableau Prep Builder d’effectuer la négociation de connexion à Tableau Cloud.	Adressez-vous au service informatique pour établir la liste d’autorisations des URL de Tableau Cloud via le proxy. Déconnectez-vous et reconnectez-vous depuis Tableau Prep Builder. Si un script de configuration automatique du proxy est en place, vérifiez qu’il gère l’authentification sans demander d’informations d’identification.	Impossible de se connecter à Tableau Online depuis Tableau Prep Builder dans un environnement proxy avec authentification requise(Le lien s’ouvre dans une nouvelle fenêtre)
Il se peut que le certificat SSL requis soit manquant ou ne corresponde pas au certificat Tableau Server pour [serverhostname]. L’erreur peut aussi s’afficher sous « Unable to find requested certificate path for flow ID » (Impossible de trouver le chemin de certificat demandé pour l’ID de flux) lors de l’exécution de flux sur le serveur.	Fichier de chaîne de certificats SSL manquant sur Tableau Server ou le fichier de chaîne n’est pas installé sur l’ordinateur exécutant Tableau Prep Builder. Dans certains cas, le problème est causé par un équilibreur de charge AWS utilisant une stratégie TLS incompatible.	Vérifiez que le fichier de chaînes de certificat SSL est chargé sur Tableau Server. Installez le certificat sur l’ordinateur exécutant Prep Builder. Si vous double-cliquez sur « Installer le certificat » et sélectionnez l’option, puis que le message « The file is invalid for use as the following: Security Certificate » (Le fichier ne peut pas être utilisé comme suit : Certificat de sécurité) s’affiche, il se peut que le fichier de certificat lui-même soit incorrectement formaté. Adressez-vous au service informatique pour exporter un fichier de chaîne valide. Si vous êtes derrière un équilibreur de charge AWS, rétrogradez la stratégie à ELBSecurityPolicy-TLS-1-2-2017-01.	Erreur - Le certificat SSL requis est peut-être manquant ou ne correspond pas au certificat Tableau Server - Connexion depuis Tableau Prep(Le lien s’ouvre dans une nouvelle fenêtre)
Tableau Prep Builder a cessé de fonctionner parce qu’un processus sous-jacent s’est arrêté de manière inattendue. Si le problème persiste, essayez de réinstaller le produit.	Cette erreur peut être déclenchée par plusieurs facteurs : configuration VPN/réseau (confirmée par Cato Network VPN bloquant la communication localhost), interférence antivirus ou fichier de port corrompu lors de l’ouverture d’un fichier .tfl spécifique. Remarque : Tableau Prep Builder ne doit jamais être installé sur un nœud Tableau Server. Il s’agit d’une cause connue de cette erreur.	Réinstallez, vérifiez les exclusions antivirus, vérifiez la communication IPv4/IPv6 de l’hôte local S’il s’agit d’un VPN spécifique, testez avec un VPN alternatif pour isoler. Collaborez avec l’équipe réseau pour vérifier les blocages de l’hôte local S’il est lié à un fichier .tfl spécifique, collectez les journaux Prep et les vidages IPS pour enquêter sur les pannes du processus tabminerva Assurez-vous que Tableau Prep Builder n’est installé sur aucun nœud Tableau Server.	Erreur : Tableau Prep a cessé de fonctionner parce qu’un processus sous-jacent s’est arrêté de manière inattendue lors du démarrage de Tableau Prep(Le lien s’ouvre dans une nouvelle fenêtre)
« AqlProcessor evaluation failed: Canceled » (Échec de l’évaluation d’AqlProcessor : annulée) : le flux échoue après une étape de permutation	Problème connu lors de la modification de la valeur d’une colonne permutée après l’étape de permutation.	Remarque : ce correctif s’applique aux versions 2022.2 et ultérieures. Mettez à niveau vers une version couverte par le correctif. Pour contourner ce problème sur les anciennes versions, évitez de modifier les valeurs des colonnes permutées par étapes en aval de la permutation.	Erreur : Erreur système - Une erreur s’est produite lors de la communication avec la source de données (LoomDataSource) lors de la modification de la valeur d’une colonne permutée après l’étape de permutation(Le lien s’ouvre dans une nouvelle fenêtre)
« Unable to publish the data source » (Impossible de publier la source de données) : le flux s’exécute correctement localement ou lors de la sortie vers un fichier .hyper, mais échoue lors de la publication sur Tableau Cloud.	Le flux échoue si la taille du fichier temporaire dépasse les limites Tableau Cloud. On constate également ce problème lorsqu’un flux échoue avec des erreurs SQL liées à la mémoire (par exemple, des opérations JOIN volumineuses) qui apparaissent uniquement dans Tableau Cloud, et non localement.	Basculez la sortie vers un fichier .hyper local pour vérifier que le problème est spécifique à Cloud. Réduisez la complexité des flux, divisez-les en flux plus petits, supprimez les colonnes inutilisées ou utilisez des connexions en direct.	N/A
Prep Builder ne s’ouvre pas sous Windows. Les journaux de débogage affichent une erreur liée à un chemin d’accès au dossier temporaire relatif.	La variable d’environnement Windows TEMP est définie sur un chemin relatif (par exemple, `%USERPROFILE%\AppData\Local\Temp`) ou contient une entrée de chemin en double. Tableau Prep Builder requiert un chemin absolu.	Vérifiez que la variable d’environnement Windows TEMP est définie sur un chemin absolu (par exemple `C:\Users[username]\AppData\Local\Temp`) Supprimez toutes les entrées en double de la variable TEMP.	N/A

Autres articles de cette section

Retour en haut

Merci de vos commentaires !

Avis correctement envoyé. Merci

Aide de Tableau Prep