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.
| Syntaxe | Description |
|---|---|
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).
Exemple :
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).
| Syntaxe | Description |
|---|---|
--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 MacOS : Exécutez l’option |
--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 MacOS: Exécutez l’option |
Configuration et stockage
Utilisez ces commandes pour configurer les paramètres des fichiers et les emplacements de référentiel.
| Syntaxe | Description |
|---|---|
--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 : MacOS |
--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 : " MacOS : |
--user-data-directory <location> | Répertoire utilisé pour stocker les données de l’application Electron. Alors que 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 Exemple : Windows : MacOS : |
Ouvrir des fichiers
Utilisez ces commandes pour ouvrir les fichiers de flux Tableau Prep .tfl et .tflx.
| Syntaxe | Description |
|---|---|
--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 : MacOS : |
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).
| Syntaxe | Description |
|---|---|
-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 : MacOS : |
- 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 : MacOS : |
-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 : MacOS : |
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.
| Syntaxe | Description |
|---|---|
--version | Gé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 : MacOS : |
-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 : |
-h, --help) | Affiche le menu d’aide des options de ligne de commande. |
