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 en 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, les licences, la définition de répertoires de données utilisateur ou le dépannage du shell Electron.

  • Tableau-prep-cli.bat : utilisé pour exécuter des flux. Par exemple : la transmission d’identifiants, les paramètres et les sorties de 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, en les distinguant selon l’utilitaire où elles sont disponibles.

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 d’installation .exe 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 n’est disponible que pour 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écifies un chemin d’accès complet vers l’emplacement du fichier .exe sur l’ordinateur. Ne lancez pas l’exécution depuis un répertoire partagé. Pour obtenir la liste des options du programme d’installation 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 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 : programme d’installation de Tableau pour le produit et la version que vous installez.

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

  • PROPERTY1, PROPERTY2, etc. permet de spécifier 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 Tableau version 2026.2 en mode silencieux (n’affiche pas les invites, ni l’interface utilisateur ni la boîte de dialogue de licence). Elle termine l’installation sans redémarrage, accepte le contrat de licence de l’utilisateur final (CLUF) 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>

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

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

--register

Pour enregistrer 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 seule ligne de commande 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 Pour afficher l’interface utilisateur d’activation si vous n’avez pas de licence.
--refresh

Pour mettre à jour les licences avec la date d’expiration de leur période de maintenance en cours et arrêter les messages d’expiration. Se termine par 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 chemin /Applications.

--return <key>

Pour désactiver la clé produit fournie afin de pouvoir la réutiliser. 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 chemin /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>

Pour charger les paramètres de configuration de l’application à partir du fichier donné. Peut être spécifié plusieurs fois afin de 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>

Pour définir le répertoire du référentiel. Par défaut, lors de l’installation, Tableau Prep crée un dossier dans votre dossier Documents appelé Mon dossier 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 l’exécution du flux 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.

Pendant 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 à simultanéité élevée où plusieurs processus ont besoin d’états d’application isolés, ou lors du dépannage d’erreurs persistantes de verrouillage de session sur un serveur headless.

Remarque : lorsque vous exécutez la commande, elle crée automatiquement le dossier spécifié dans --user-data-directory. Toutefois, le compte utilisateur exécutant le script doit disposer des autorisations « Écrire » sur ce 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"

Ouverture de 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 de 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 de ligne de commande Tableau Prep

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

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 limitations, 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>

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

Tableau Prep Builder utilise les informations 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 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. Il 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 planifier l’exécution des flux, vous pouvez exécuter cette commande pour exécuter votre flux à l’aide de l’actualisation incrémentielle. Pour plus d’informations, consultez Exécuter le flux avec l’actualisation incrémentielle activée.

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 afin de 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 : Mon dossier Tableau Prep Builder\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). Lors de l’exécution de cette option sous MacOS, une boîte de dialogue peut s’afficher et demander 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 pour les options command-line.

Merci de vos commentaires !Avis correctement envoyé. Merci