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.

SintaxisDescripció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).

  • tableau_<product_installer_name>.exe: es el instalador de Tableau del producto y la versión que va a instalar.

  • option1, option2, etc. es como desea que se ejecute el proceso de instalación.

  • PROPERTY1, PROPERTY2, etc. le permiten especificar opciones de configuración que debe aplicar el instalador durante el proceso de instalación.

Ejemplo:

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

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).

SintaxisDescripció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 --refresh y una clave de producto.

MacOS: Ejecute la opción -refresh del objeto de Tableau en la ruta de /Applications.

--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 -return y una clave de producto.

MacOS: Ejecute la opción -return del objeto de Tableau en la ruta de /Applications.

Configuración y almacenamiento

Use estos comandos para configurar las opciones de archivo y las ubicaciones de repositorio.

SintaxisDescripció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: "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>

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: "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>

Directorio utilizado para almacenar datos de la aplicación Electron.

Mientras --repository-location administra los activos de su negocio (registros y datos), --user-data-directory administra el motor interno de la aplicación.

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 --user-data-directory. Sin embargo, la cuenta de usuario que ejecuta el script debe tener permisos de “escritura” en ese directorio principal.

Ejemplo:

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"

Abrir archivos

Use estos comandos para abrir archivos de flujo de Tableau Prep .tfl y .tflx.

SintaxisDescripció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:"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"

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).

SintaxisDescripció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: "\[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

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: "\[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>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: "\[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

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.

SintaxisDescripción
--versionGenera 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: "\[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

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: /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)

Muestra el menú de ayuda para las opciones de línea de comandos.

¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!