Aide de Tableau Prep

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 des problèmes se présentent avec votre flux, que vous choisissiez de résoudre le problème vous-même ou que vous contactiez l’assistance pour obtenir de l’aide, vous devez généralement collecter les fichiers journaux et les fichiers de vidage après incident pour les analyser, et 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 à décrire les étapes exactes que vous avez suivies avant que l’erreur ne se produise et à fournir les fichiers du flux.

Collecter les fichiers journaux et les fichiers de vidage après incident

Les fichiers journaux de Tableau Prep sont stockés dans le dossier « Mon référentiel Tableau Prep ». qui se trouve par défaut à l’emplacement suivant :

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 ce qui se trouve dans le dossier « My Tableau Prep Repository/Logs ». Si vous exécutez Tableau Prep depuis la ligne de commande, incluez les fichiers journaux qui se trouvent ici : « My Tableau Prep Repository/Command Line Repository/Logs ».

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

Activer la journalisation des requêtes

Depuis la version 2026.2 de Tableau Prep Builder, 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. Cela peut être utile pour diagnostiquer des problèmes avec votre flux. Les fichiers journaux sont générés et stockés dans le dossier Requête.

Vous trouverez les fichiers de journalisation des requêtes dans le répertoire suivant :

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 afin de dépanner et d’obtenir des informations sur les erreurs et l’utilisation. Lors de l’utilisation du module d’extension LogSharkPrep.twbx, vous pouvez générer des classeurs avec un tableau de bord des erreurs et des flux pour vous aider à analyser et à visualiser les problèmes de préparation.

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 après incident

En plus des fichiers journaux, vous devez également collecter des fichiers de vidage après incident. Tout ce qui ne figure pas dans les fichiers journaux peut être détaillé ici et peut aider au 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 après incident, il est utile d’en créer pour les processus suivants.

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

Windows

1. Ouvrez le gestionnaire de tâches.

2. Faites un clic droit sur l’en-tête de la colonne et sélectionnez Nom du processus et Ligne de commande. Cela montre les différents processus et vous permet de sélectionner celui que vous souhaitez utiliser pour créer un fichier de vidage après incident.

3. Cliquez avec le bouton droit de la souris sur le processus de tabminerva.exe (précédemment prepservice.exe).

4. Sélectionnez Créer un fichier de vidage.

   Une boîte de dialogue s’ouvre et affiche l’emplacement du fichier de vidage après incident sur votre système.

MacOS

Sous MacOS, il existe deux types de fichiers de diagnostic qui peuvent servir au 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 principal : un instantané complet de la mémoire du processus au moment de l’arrêt.

Dans les deux cas, le processus Tableau Prep doit être terminé. Vous devrez relancer Tableau Prep après avoir collecté ces fichiers.

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

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

1. Ouvrez Terminal.

2. Exécutez la commande pgrep tabminerva | xargs kill -SEGV

   Cela met fin au 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.

3. Le rapport d’incident est enregistré dans : ~/Library/Logs/DiagnosticReports/

   Le nom du fichier est au format tabminerva_AAAA-MM-JJ-HHMMSS_machinename.crash ou tabminerva_AAAA-MM-JJ-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’un véritable incident.

Étape 2 : créer un fichier de configuration

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

Créez un fichier principal et terminez la session Tableau Prep

1. Ouvrez Terminal.

2. Exécutez la commande sudo chmod 1777 /cores pour accorder un accès en écriture au répertoire principal du fichier.

3. Exécutez la commande ulimit -c unlimited pour supprimer la limite de taille du fichier principal pour la session actuelle du terminal.

4. Exécutez la commande pgrep tabminerva | xargs kill -SEGV pour terminer le processus et générer le fichier principal.

5. Recherchez le fichier principal dans /cores/ . Celui-ci est nommé core.<process_id>.

Créer un fichier principal et laisser Tableau Prep s’exécuter

Cette option utilise un utilitaire gcore pour capturer le vidage principal 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.

1. Ouvrez Terminal.

2. Exécutez la commande sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)

   Cela enregistre le fichier principal 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 informatons 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).

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.

Autres articles de cette section