Référence de ligne de commande Tableau Prep

Vous pouvez interagir avec Tableau Prep à l’aide de la ligne de commande via l’application principale (Tableau Prep.exe) ou via l’interface de ligne de commande (tableau-prep-cli.bat ).

  • Tableau Prep.exe : utilisé pour configurer la façon dont l’application s’initialise. Par exemple; l’installation, l’activation, l’octroi de licences, la définition de répertoires de données utilisateur ou le dépannage de la couche Electron.

  • Tableau-prep-cli.bat : utilisé pour exécuter des flux. Par exemple, la transmission d’identifiants, de paramètres et l’actualisation des données sans ouvrir l’interface visuelle.

Ce document décrit toutes les options de syntaxe de ligne de commande prises en charge par Tableau Prep et mises à la disposition des clients, classées selon le service où il est disponible.

Les autres syntaxes de ligne de commande prises en charge utilisées par les développeurs et l’assistance Tableau ne sont pas incluses dans ce document.

Application Tableau Prep

Les actions suivantes peuvent être effectuées à partir de la ligne de commande de l’application Tableau Prep.exe.

Installation

Installez Tableau Prep en exécutant le fichier.exe du programme d’installation depuis la ligne de commande de l’ordinateur, en tant qu’administrateur. Pour plus d’informations, consultez Installer depuis la ligne de commande(Le lien s’ouvre dans une nouvelle fenêtre).

Remarque : Cette option est disponible uniquement sous Windows.

SyntaxeDescription
tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

Exécutez la commande en tant qu’administrateur depuis le répertoire où se trouve le fichier .exe, ou spécifiez un chemin d’accès complet vers l’emplacement du fichier .exe sur l’ordinateur. N’exécutez pas la commande à partir d’un répertoire partagé. Pour obtenir la liste des options du programme d’installation qui sont prises en charge, consultez Options du programme d’installation(Le lien s’ouvre dans une nouvelle fenêtre). Pour obtenir la liste des propriétés du programme d’installation qui sont prises en charge, consultez Propriétés du programme d’installation(Le lien s’ouvre dans une nouvelle fenêtre).

  • tableau_<product_installer_name>.exe est le programme d’installation de Tableau pour le produit et la version que vous installez.

  • option1, option2, etc représentent la manière dont vous souhaitez que le processus d’installation s’exécute.

  • PROPERTY1, PROPERTY2, etc. spécifient les paramètres de configuration que le programme d’installation doit effectuer durant le processus d’installation.

Exemple :

tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

Cette commande installe la version 2026.2 de Tableau en mode silencieux (n’affiche pas les invites, l’interface utilisateur ni la boîte de dialogue de licence). Elle complète l’installation sans redémarrage, accepte le contrat de licence de l’utilisateur final (EULA) et désactive les rapports d’erreur et les rapports d’utilisation.

Activation, licence et enregistrement

Utilisez ces commandes pour vérifier votre licence, activer le produit pendant ou après l’installation et enregistrer le produit. Pour plus d’informations, consultez Activer Tableau Desktop et Tableau Prep Builder(Le lien s’ouvre dans une nouvelle fenêtre).

SyntaxeDescription
--activate <key>

Activez le produit à l’aide de la clé produit fournie. Se termine avec le code « 0 » en cas de réussite. Sinon, se ferme avec un code d’erreur. Accepte également l’utilisation d’un seul tiret (-activate).

Pour activer le produit lors de l’installation, ajoutez une ligne de commande unique incluant l’option de programme d’installation ACTIVATE_KEY "<clé>" et ajoutez la clé produit entre les guillemets.

--register

Enregistrez le produit. Accepte également les tirets simples (-register). Pour enregistrer Tableau depuis la ligne de commande, vous devez pré-renseigner les valeurs de registre (Windows) ou .plist (Mac) sur chaque ordinateur qui exécutera Tableau Prep Builder.

Pour Windows, vous pouvez enregistrer le produit pendant l’installation en ajoutant une ligne de commande unique incluant l’option du programme d’installation REGISTER="1".

Pour plus d’informations, consultez Enregistrer Tableau Desktop et Tableau Prep Builder(Le lien s’ouvre dans une nouvelle fenêtre).

--check-license Affichez l’interface utilisateur d’activation si vous n’avez pas de licence.
--refresh

Met à jour les licences avec la date d’expiration de leur période de maintenance en cours et arrête les messages d’expiration. Se termine avec le code « 0 » en cas de réussite. Accepte également les tirets simples (-refresh).

Windows : Exécutez tableau.exe avec l’option --refresh et une clé produit.

MacOS : Exécutez l’option -refresh sur l’objet Tableau dans le répertoire /Applications.

--return <key>

Désactivez la clé produit fournie afin qu’elle puisse être réutilisée. Accepte également les tirets simples (-return).

Windows : Exécutez tableau.exe avec l’option -return et une clé produit.

MacOS:  Exécutez l’option -return sur l’objet Tableau dans le répertoire /Applications.

Configuration et stockage

Utilisez ces commandes pour configurer les paramètres des fichiers et les emplacements de référentiel.

SyntaxeDescription
--settings-file <file location>

Chargez les paramètres de configuration de l’application à partir du fichier donné. Peut être spécifié plusieurs fois pour prendre en charge les configurations superposées, par exemple lorsqu’une configuration de serveur proxy globale est utilisée par tout le monde et qu’une configuration de base de données spécifique est utilisée pour un flux.

Exemple de fichier .json :

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

Exemple de commande :

Windows : "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"

MacOS : /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"

--repository-location <file path>

Définissez le répertoire du référentiel. Par défaut, lors de l’installation, Tableau Prep crée un dossier dans votre dossier Documents qui appelle « Mon référentiel Tableau Prep ». Ce dossier comprend des dossiers pour les flux, les sources de données, les connexions, ainsi que des fichiers journaux et un cache temporaire. Dans des environnements de serveur ou d’automatisation, vous pouvez utiliser cette commande pour spécifier un autre emplacement de référentiel et pointer le flux exécuté vers celui-ci.

Exemple :

Windows : "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"

MacOS : /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"

--user-data-directory <location>

Répertoire utilisé pour stocker les données de l’application Electron.

Alors que --repository-location gère les ressources de votre entreprise (journaux et données), --user-data-directory gère le moteur interne de l’application.

En tant qu’administrateur, utilisez cet indicateur si vous exécutez Tableau Prep Builder dans un environnement à concurrence élevée où plusieurs processus nécessitent des états d’application isolés, ou lors du dépannage d’erreurs persistantes de verrouillage de session sur un serveur administré à distance.

Remarque : Lorsque vous exécutez la commande, elle crée automatiquement le dossier spécifié dans le répertoire --user-data-directory. Toutefois, le compte utilisateur exécutant le script doit disposer des autorisations d’écriture sur le répertoire parent.

Exemple :

Windows : "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"

MacOS : /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"

Ouvrir des fichiers

Utilisez ces commandes pour ouvrir les fichiers de flux Tableau Prep .tfl et .tflx.

SyntaxeDescription
--tfl<file>

Ouvrez le fichier de flux .tfl spécifié. Utilisez des guillemets doubles si le chemin d’accès à votre fichier inclut des espaces.

Exemple :

Windows : "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl"

MacOS : /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl"

--tflx<file>

Ouvrez le fichier de flux compressé .tflx spécifié.

Exemple :

Windows :"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"

MacOS : /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"

Application en ligne de commande Tableau Prep

Les commandes suivantes peuvent être exécutées à l’aide de l’interface en ligne de commande de Tableau Prep (tableau-prep-cli.bat).

Actualiser la sortie du flux

Utilisez ces options pour exécuter le flux depuis la ligne de commande afin d’actualiser la sortie du flux. Cette méthode vous permet d’exécuter un seul flux à la fois. Pour plus d’informations et pour connaître les limites, consultez Actualiser les fichiers de sortie de flux depuis la ligne de commande(Le lien s’ouvre dans une nouvelle fenêtre).

SyntaxeDescription
-c, --connections <path>

Le chemin d’accès au fichier .json contenant les identifiants pour vos sources de données et vos serveurs.

Tableau Prep Builder utilise l’information du fichier de flux et du fichier .json d’identifiants pour exécuter le flux dans le cas de connexions distantes. Pour plus d’informations, consultez la section Exigences du fichier d’identifiants .json(Le lien s’ouvre dans une nouvelle fenêtre).

Si vous vous connectez à une base de données Snowflake, assurez-vous d’inclure tous les paramètres spécifiques tels que le rôle, l’entrepôt et parfois les jetons OAuth ou l’authentification du navigateur externe.

exemple de fichier de paramètres .json - Snowflake :

{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						

Exemple :

Windows : "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"

MacOS : /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

- p, - - parameters

Chemin d’accès à un fichier .json qui remplace les valeurs de paramètre par défaut dans votre flux. Il s’agit d’un fichier distinct de votre fichier credentials.json et inclut les noms et les valeurs de vos paramètres.

Pour plus d’informations, consultez « Exécuter des flux qui incluent des valeurs de paramètre » dans Exigences du fichier d’identifiants .json(Le lien s’ouvre dans une nouvelle fenêtre).

Exemple :

Windows : "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json

MacOS : /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json

-t,--tflFile <file path>Chemin d’accès à votre fichier de flux Tableau Prep.
-inc, --incrementalRefresh

Si vous n’avez pas activé Tableau Prep Conductor sur votre serveur pour programmer l’exécution de vos flux, vous pouvez utiliser cette commande pour exécuter votre flux à l’aide d’actualisations incrémentielles. Pour plus d’informations, consultez Exécuter le flux en activant l’actualisation incrémentielle.

Exemple :

Windows : "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"

MacOS : /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl

Commandes diverses

Utilisez ces commandes pour imprimer votre version de Tableau Prep, activer le mode débogage pour déboguer un processus de flux, désactiver la validation SSL, etc.

SyntaxeDescription
--versionGénère la version actuelle de l’interface en ligne de commande Tableau Prep Builder et met immédiatement fin au processus.
-d, --debug

Active le mode débogage. Génère des journaux détaillés dans le dossier du référentiel à des fins de dépannage. Les fichiers journaux sont stockés dans : My Tableau Prep Builder Repository\Command Line Repository\Logs

Exemple :

Windows : "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"

MacOS : /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl

-dsv, --disableSslValidation

Désactive la validation du certificat SSL (utile pour certains environnements de serveur internes). Lorsque cette option est exécutée sous MacOS, une boîte de dialogue peut apparaître demandant l’utilisateur et le mot de passe du trousseau.

Depuis la version 2019.3.2 de Tableau Prep Builder, vous pouvez transmettre ce paramètre supplémentaire pour désactiver cette boîte de dialogue de trousseau.

Exemple :

MacOS : /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

-h, --help)

Affiche le menu d’aide des options de ligne de commande.

Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!