Referencia de línea de comandos de Tableau Prep
Puede interactuar con Tableau Prep usando la línea de comandos a través de la aplicación principal (Tableau Prep.exe) o a través de la interfaz de línea de comandos (tableau-prep-cli.bat).
Tableau Prep.exe: se utiliza para configurar cómo se inicializa la aplicación. Por ejemplo; instalación, activación, licencias, configuración de directorios de datos de usuario o solución de problemas del shell de Electron.
Tableau-prep-cli.bat: se utiliza para ejecutar flujos. Por ejemplo, pasar credenciales, parámetros y actualizar salidas de datos sin abrir la interfaz visual.
Este documento describe todas las opciones de sintaxis de línea de comandos que son compatibles con Tableau Prep y que están disponibles para los clientes, separadas por la utilidad donde está disponible.
En este documento no se incluye otra sintaxis de línea de comandos soportada que utilizan los desarrolladores y el soporte técnico de Tableau.
Aplicación de Tableau Prep
Las siguientes acciones se pueden realizar desde la línea de comandos de la aplicación Tableau Prep.exe.
Instalación
Instale Tableau Prep ejecutando el archivo .exe del instalador desde la línea de comandos del equipo como administrador. Para obtener más información, consulte Instalar desde la línea de comandos(El enlace se abre en una ventana nueva).
Nota: Esta opción solo está disponible para Windows.
| Sintaxis | Descripción |
|---|---|
tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2 | Ejecute el comando como administrador desde el directorio en el que se encuentra el archivo .exe o bien debe especificar una ruta completa a la ubicación de dicho archivo en el equipo. No ejecute desde un directorio compartido. Para obtener una lista de las opciones de instalación admitidas, consulte Opciones del instalador(El enlace se abre en una ventana nueva). Para obtener una lista de las propiedades del instalador admitidas, consulte Propiedades del instalador(El enlace se abre en una ventana nueva).
Ejemplo:
Este comando instala la versión 2026.2 de Tableau en modo silencioso (no muestra indicaciones, la IU ni el cuadro de diálogo de licencia). Finaliza la instalación sin reiniciar, acepta el acuerdo de licencia de usuario final (EULA) y desactiva la generación de informes de errores y de uso. |
Activación, licencia y registro
Use estos comandos para comprobar la licencia, activar el producto durante la instalación o después de la instalación y registrar el producto. Para obtener más información, consulte Activar Tableau Desktop y Tableau Prep Builder(El enlace se abre en una ventana nueva).
| Sintaxis | Descripción |
|---|---|
--activate <key> | Active el producto con la clave de producto suministrada. Se cierra con el código 0 en caso de éxito. De lo contrario, se cierra con un código de error. También acepta un solo guion (-activate). Para activar el producto durante la instalación, añada una sola línea de comandos que incluya la opción del instalador ACTIVATE_KEY "<clave>" y escriba la clave de producto entre comillas. |
--register | Registrar el producto. También acepta un solo guion (-register). Para registrar Tableau desde la línea de comandos, necesita completar de forma previa los valores del Registro (Windows) o de .plist (Mac) en todos los equipos donde se ejecutará Tableau Prep Builder. Para Windows, puede registrar el producto durante la instalación añadiendo una sola línea de comandos que incluya la opción del instalador REGISTER="1". Para obtener más información, consulte Registrar Tableau Desktop y Tableau Prep Builder(El enlace se abre en una ventana nueva). |
--check-license | Mostrar la interfaz de usuario de activación si no tiene licencia. |
--refresh | Actualiza las licencias con la fecha en la que caduca su periodo de mantenimiento actual y detiene los mensajes de caducidad. Se cierra con el código 0 en caso de éxito. También acepta un solo guion (-refresh). Windows: Ejecute tableau.exe con la opción MacOS: Ejecute la opción |
--return <key> | Desactive la clave de producto suministrada para que pueda reutilizarse. También acepta un solo guion (-return). Windows: Ejecute tableau.exe con la opción MacOS: Ejecute la opción |
Configuración y almacenamiento
Use estos comandos para configurar las opciones de archivo y las ubicaciones de repositorio.
| Sintaxis | Descripción |
|---|---|
--settings-file <file location> | Cargue los ajustes de configuración de la aplicación desde el archivo dado. Puede especificarse varias veces para admitir configuraciones con capas, como cuando se utiliza una configuración de servidor proxy global para un usuario y una configuración de base de datos específica para un flujo. Ejemplo de archivo .json: {
"connection-sources":[
{
"endpoint":"prod-db-server.company.com",
"username":"service_account_admin",
"password":"secure_password_123"
}
]
}Comando de ejemplo: Windows: MacOS |
--repository-location <file path> | Establezca el directorio del repositorio. De forma predeterminada, durante la instalación, Tableau Prep crea una carpeta en la carpeta Documentos llamada Mi repositorio de Tableau Prep. Esta carpeta contiene carpetas para flujos, fuentes de datos, conexiones, así como archivos de registro y una caché temporal. En entornos de servidor o de automatización, puede usar este comando para especificar una ubicación de repositorio alternativa e indicar la ejecución del flujo. Ejemplo: Windows: " MacOS: |
--user-data-directory <location> | Directorio utilizado para almacenar datos de la aplicación Electron. Mientras Como administrador, use esta marca si ejecuta Tableau Prep Builder en un entorno de alta concurrencia donde varios procesos necesitan estados de aplicación aislados o al solucionar errores persistentes de bloqueo de sesión en un servidor desatendido. Nota: Al ejecutar el comando, se crea automáticamente la carpeta especificada en Ejemplo: Windows: MacOS: |
Abrir archivos
Use estos comandos para abrir archivos de flujo de Tableau Prep .tfl y .tflx.
| Sintaxis | Descripción |
|---|---|
--tfl<file> | Abra el archivo de flujo .tfl especificado. Utilice comillas dobles si la ruta del archivo incluye espacios. Ejemplo: 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> | Abra el archivo de flujo empaquetado .tflx especificado. Ejemplo: Windows: MacOS: |
Aplicación de línea de comandos de Tableau Prep
Los siguientes comandos se pueden ejecutar mediante la interfaz de línea de comandos (tableau-prep-cli.bat) de Tableau Prep.
Actualizar la salida de flujo
Utilice estas opciones para ejecutar el flujo desde la línea de comandos para actualizar la salida del flujo. Este método le permite ejecutar solo un flujo a la vez. Para obtener más información y límites, consulte Actualizar los archivos de salida del flujo desde la línea de comandos(El enlace se abre en una ventana nueva).
| Sintaxis | Descripción |
|---|---|
-c, --connections <path> | La ruta al archivo de .json que contiene las credenciales de sus fuentes de datos y servidores. Tableau Prep Builder usa la información del archivo de flujo y el archivo .json de credenciales para ejecutar el flujo cuando tenga conexiones remotas. Para obtener más información, consulte Requisitos del archivo .json de credenciales(El enlace se abre en una ventana nueva). Si se conecta a una base de datos de Snowflake, asegúrese de incluir parámetros específicos como rol, almacén y, a veces, tokens de OAuth o autenticación del navegador externo. Ejemplo de archivo de configuración de .json: Snowflake: {
"connection-sources":[
{
"endpoint":"company_account.snowflakecomputing.com",
"username":"SVC_TABLEAU_PREP",
"password":"EncryptedPassword123",
"attributes":{
"warehouse": "DATA_LOAD_WH",
"role": "TRANSFORM_ROLE"
}
}
]
} Ejemplo: Windows: MacOS: |
- p, - - parameters | La ruta a un archivo de .json que anula los valores de los parámetros predeterminados en su flujo. Este es un archivo separado de su archivo credentials.json e incluye los nombres y valores de sus parámetros. Para obtener más información, consulte “Ejecutar flujos que incluyen valores de parámetros” en Requisitos del archivo .json de credenciales(El enlace se abre en una ventana nueva). Ejemplo: Windows: MacOS: |
-t,--tflFile <file path> | La ruta al archivo de flujo de Tableau Prep. |
-inc, --incrementalRefresh | Si no tiene Tableau Prep Conductor habilitado en el servidor para programar las ejecuciones de flujo, puede ejecutar usar este comando para ejecutar su flujo usando la actualización incremental. Para obtener más información, consulte Ejecutar el flujo con la actualización incremental habilitada. Ejemplo: Windows: MacOS: |
Comandos varios
Use estos comandos para imprimir la versión de Tableau Prep, activar el modo de depuración para depurar un proceso de flujo, deshabilitar la validación SSL, etc.
| Sintaxis | Descripción |
|---|---|
--version | Genera la versión actual de la CLI de Tableau Prep Builder y finaliza inmediatamente el proceso. |
-d, --debug | Activa el modo de depuración. Genera registros detallados en la carpeta del repositorio para solucionar problemas. Los archivos de registro se almacenan en: My Tableau Prep Builder Repository\Command Line Repository\Logs Ejemplo: Windows: MacOS: |
-dsv, --disableSslValidation | Deshabilita la validación de certificados SSL (útil para ciertos entornos de servidores internos). Cuando se ejecuta esta opción en MacOS, puede aparecer un cuadro de diálogo preguntando por el usuario y la contraseña. A partir de la versión 2019.3.2 de Tableau Prep Builder, puede usar este parámetro adicional para desactivar este cuadro de diálogo de cadena de claves. Ejemplo: MacOS: |
-h, --help) | Muestra el menú de ayuda para las opciones de línea de comandos. |
