---
schema_version: "1"
id: a71b51d4124f2b4df29a593af9d4f37c27b1cd4bbbb685b87ab7b26c86398ad2
title: Referência da linha de comando do Tableau Prep
collection: tableau
version: current
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/current/pt-br/prep/prep_command_line_reference.md
canonical_url: https://help.tableau.com/current/prep/pt-br/prep_command_line_reference.htm
source_site: help.tableau.com
content_type: documentation
content_hash: eaf364a4d8bac340a5915f0438d1165fdd86fdc8e36bc1551be87a4315a7d22e
description: Reference for interacting with Tableau Prep through the command line.
---
[Pular para o conteúdo principal](#main-content)

# Referência da linha de comando do Tableau Prep

Você pode interagir com o Tableau Prep usando a linha de comando por meio do aplicativo principal (Tableau Prep.exe) ou da interface de linha de comando (tableau-prep-cli.bat).

- Tableau Prep.exe: usado para configurar como o aplicativo se inicializa. Por exemplo; instalar, ativar, licenciar, configurar diretórios de dados do usuário ou solucionar problemas do Electron shell.
- Tableau-prep-cli.bat: usado para executar fluxos. Por exemplo, passar credenciais, parâmetros e atualizar saídas de dados sem abrir a interface visual.

Este documento descreve todas as opções de sintaxe de linha de comando suportadas pelo Tableau Prep e disponíveis para os clientes, separadas pelo utilitário onde estão disponíveis.

A sintaxe de linha de comando adicional com suporte usada por desenvolvedores e o suporte do Tableau não está incluída neste documento.

## Aplicativo do Tableau Prep

As seguintes ações podem ser executadas na linha de comando do aplicativo Tableau Prep.exe.

### Instale

Instale o Tableau Prep executando o arquivo .exe do instalador a partir da linha de comando do computador como administrador. Para obter mais informações, ccconsulte [Instalar a partir da linha de comando](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm).

**Nota:** esta opção está disponível apenas para o Windows.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col style="width: 875px;"></colgroup><tbody><tr><th>Sintaxe</th><th>Descrição</th></tr><tr><td><code>tableau_&lt;product_installer_name&gt;.exe /option1 /option2 PROPERTY1 PROPERTY2</code></td><td><p>Execute o comando como administrador a partir do diretório onde o arquivo .exe está localizado ou especifique o caminho completo para a localização do arquivo .exe no computador. Não execute a partir de um diretório compartilhado. Para obter uma lista das opções do instalador suportadas, consulte <a href="https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_cli_ref.htm#installer-options" target="_blank">Opções do instalador</a>. Para obter uma lista das propriedades do instalador suportadas, consulte <a href="https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_cli_ref.htm#installer-properties" target="_blank">Propriedades do instalador</a>.</p><ul><li><p><code>tableau_&lt;product_installer_name&gt;.exe</code> é o instalador do Tableau para o produto e a versão que você está instalando.</p></li><li><p><code>option1, option2</code> etc é como você deseja que o processo de instalação seja executado.</p></li><li><p><code>PROPERTY1, PROPERTY2</code> etc especifica as configurações que o instalador deve fazer durante o processo de instalação.</p></li></ul><p>Exemplo:</p><p><code>tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"</code></p><p>Este comando instala o Tableau versão 2026.2 no modo silencioso (não exibe prompts, IU ou a caixa de diálogo de licença). Ele conclui a instalação sem uma reinicialização, aceita o contrato de licença do usuário final (EULA) e define os relatórios de erros e relatórios de uso como desativados.</p></td></tr></tbody></table>

### Ativação, licença e registro

Use esses comandos para verificar sua licença, ativar o produto durante ou após a instalação e registrar o produto. Para obter mais informações, consulte [Ativar o Tableau Desktop e o Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm#activate-tableau-desktop-and-tableau-prep-builder).

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintaxe</th><th>Descrição</th></tr><tr><td><code>--activate &lt;key&gt;</code></td><td><p>Ative o produto usando a chave do produto fornecida. Sai com o código 0 em caso de sucesso. Caso contrário, sai com um código de erro. Também aceita single-dash (-activate).</p><p>Para ativar o produto durante a instalação adicione uma única linha de comando que inclua a opção do instalador ACTIVATE_KEY “&lt;key&gt;” e insira a chave do produto entre aspas.</p></td></tr><tr><td><code>--register </code></td><td><p>Registre o produto. Também aceita single-dash (-register). Para registrar o Tableau usando a linha de comando, é necessário preencher previamente os valores de registro (Windows) ou .plist (Mac) em cada computador que executará o Tableau Prep Builder.</p><p>No Windows, você pode registrar o produto durante a instalação adicionando uma única linha de comando que inclui a opção REGISTER=“1” do instalador.</p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm#register-tableau-desktop-and-tableau-prep-builder" target="_blank">Registre o Tableau Desktop e o Tableau Prep Builder</a>.</p></td></tr><tr><td><code>--check-license </code></td><td>Exibe a interface de usuário de ativação, se não licenciado.</td></tr><tr><td><code>--refresh</code></td><td><p>Atualiza as licenças com a data de validade do período de manutenção vigente e interrompe as mensagens de expiração. Sai com o código 0 em caso de sucesso. Também aceita single-dash (-refresh).</p><p><b>Windows:</b> execute o arquivo tableau.exe com a opção <code>--refresh</code> e uma chave de produto.</p><p><b>MacOS:</b> Execute a opção <code>-refresh</code> no objeto do Tableau no caminho /Applications.</p></td></tr><tr><td><code>--return &lt;key&gt;</code></td><td><p>Desative a chave do produto fornecida para que possa ser reutilizada. Também aceita single-dash (-return).</p><p><b>Windows:</b> execute o arquivo tableau.exe com a opção <code>-return</code> e uma chave de produto.</p><p><b>MacOS:</b> Execute a opção <code>-return</code> no objeto do Tableau no caminho /Applications.</p></td></tr></tbody></table>

### Configuração e armazenamento

Use esses comandos para definir as configurações de arquivos e locais de repositório.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintaxe</th><th>Descrição</th></tr><tr><td><code>--settings-file &lt;file location&gt;</code></td><td><p>Carregue as definições de configuração do aplicativo a partir do arquivo fornecido. Pode ser especificado várias vezes para dar suporte a configurações em camadas, como quando você tem uma configuração global do servidor proxy usada por todos e uma configuração de banco de dados específica usada para um fluxo.</p><p>Exemplo de arquivo. json:</p><pre xml:space="preserve">{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}</pre><p>Comando de exemplo:</p><p><b>Windows</b>: <code>"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"</code></p><p><b>MacOS</b><code>: /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"</code></p></td></tr><tr><td><code>--repository-location &lt;file path&gt; </code></td><td><p>Defina o diretório do repositório. Por padrão, durante a instalação, o Tableau Prep cria uma pasta na pasta Documentos chamada Meu repositório do Tableau Prep. Essa pasta inclui pastas para fluxos, fontes de dados, conexões, bem como arquivos de registro e um cache temporário. Em ambientes de servidor ou automação, você pode usar este comando para especificar um local de repositório alternativo e apontar o fluxo executado para ele.</p><p>Exemplo:</p><p><b>Windows</b>: "<code>C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"</code></p></td></tr><tr><td><code>--user-data-directory &lt;location&gt;</code></td><td><p>Diretório usado para armazenar dados do aplicativo Electron.</p><p>Enquanto <code>--repository-location</code> gerencia os ativos da empresa (logs e dados), <code>--user-data-directory</code> gerencia o mecanismo interno do aplicativo.</p><p>Como administrador, use este sinalizador se estiver executando o Tableau Prep Builder em um ambiente de alta simultaneidade, onde vários processos precisam de estados de aplicativo isolados, ou ao solucionar erros persistentes de bloqueio de sessão em um servidor sem cabeça.</p><p class="note"><b>Observação</b>: quando você executa o comando, ele cria automaticamente a pasta especificada em <code>--user-data-directory</code>. No entanto, a conta de usuário que executa o script deve ter permissões de “gravação” para esse diretório pai.</p><p>Exemplo:</p><p><b>Windows</b>: <code> "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"</code></p></td></tr></tbody></table>

### Abrir arquivos

Use esses comandos para abrir arquivos .tfl e .tflx de fluxo do Tableau Prep.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintaxe</th><th>Descrição</th></tr><tr><td><code>--tfl&lt;file&gt;</code></td><td><p>Abra o arquivo de fluxo de .tfl especificado. Use aspas duplas se o caminho do arquivo incluir espaços.</p><p>Exemplo:</p><p><b>Windows</b>: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl"</p><p><b>MacOS</b>: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl “/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl”</p></td></tr><tr><td><code>--tflx&lt;file&gt; </code></td><td><p>Abra o arquivo de fluxo .tflx empacotado especificado.</p><p>Exemplo:</p><p><b>Windows</b>:<code>"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"</code></p></td></tr></tbody></table>

## Aplicativo de linha de comando do Tableau Prep

Os comandos a seguir podem ser executados usando a interface de linha de comandos (tableau-prep-cli.bat) do Tableau Prep.

### Atualizar saída de fluxo

Use essas opções para executar o fluxo via linha de comando para atualizar a saída de fluxo. Esse método permite executar apenas um fluxo de cada vez. Para obter mais informações e limitações, consulte [Atualizar arquivos de saída de fluxo a partir da linha de comando](https://help.tableau.com/current/prep/pt-br/prep_run_commandline.htm).

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintaxe</th><th>Descrição</th></tr><tr><td><code>-c, --connections &lt;path&gt;</code></td><td><p>O caminho para o arquivo de .json que contém as credenciais para suas fontes de dados e servidores.</p><p>O Tableau Prep Builder usa informações do arquivo de fluxo e do arquivo .json de credenciais para executar o fluxo quando você tiver conexões remotas. Para obter mais informações, consulte <a href="https://help.tableau.com/current/prep/pt-brprep_run_commandline.htm#credentials-json-file-requirements" target="_blank">Requisitos do arquivo Credentials.json</a>.</p><p>Se você se conectar a um banco de dados snowflake, certifique-se de incluir quaisquer parâmetros específicos, como Role, Warehouse e, às vezes, tokens OAuth ou autenticação de navegador externo.</p><p>Exemplo de arquivo de configurações .json - Snowflake:</p><pre xml:space="preserve">{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						</pre><p>Exemplo:</p><p><b>Windows</b>:<code> "\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"</code></p><p><b>MacOS</b>:<code> /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</code></p></td></tr><tr><td><code>- p,  - - parameters</code></td><td><p>O caminho para um arquivo .json que substitui os valores de parâmetro padrão em seu fluxo. Este é um arquivo separado do arquivo credentials.json e inclui os nomes e valores dos seus parâmetros.</p><p>Para obter mais informações, consulte “Executar fluxos que incluem valores de parâmetros” em <a href="https://help.tableau.com/current/prep/pt-brprep_run_commandline.htm#credentials-json-file-requirements" target="_blank">Requisitos do arquivo Credentials.json</a>.</p><p>Exemplo:</p><p><b>Windows</b>: <code>"\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json</code></p><p><b>MacOS</b>: <code>/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</code></p></td></tr><tr><td><code>-t,--tflFile &lt;file path&gt;</code></td><td>O caminho para o arquivo de fluxo do Tableau Prep.</td></tr><tr><td><code>-inc, --incrementalRefresh </code></td><td><p>Se você não tiver o Tableau Prep Conductor habilitado em seu servidor para agendar execuções de fluxo, poderá usar este comando para executar seu fluxo usando atualização incremental. Para obter mais informações, consulte Executar o fluxo com a atualização incremental ativada.</p><p>Exemplo:</p><p><b>Windows</b>: <code>"\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl</code></p></td></tr></tbody></table>

### Comandos diversos

Use esses comandos para imprimir a versão do Tableau Prep, ative o modo de depuração para depurar um processo de fluxo, desabilite a validação de SSL e muito mais.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintaxe</th><th>Descrição</th></tr><tr><td><code>--version</code></td><td>Produz a versão atual da CLI do Tableau Prep Builder e encerra imediatamente o processo.</td></tr><tr><td><code>-d, --debug </code></td><td><p>Ativa o modo de depuração. Gera logs detalhados na pasta do repositório para solução de problemas. Os arquivos de registro estão armazenados em: My Tableau Prep Builder Repository\Command Line Repository\Logs</p><p>Exemplo:</p><p><b>Windows</b>: <code>"\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl</code></p></td></tr><tr><td><code>-dsv, --disableSslValidation </code></td><td><p>Desabilita a validação de certificado SSL (útil para determinados ambientes de servidor interno). Ao executar esta opção no MacOS, uma caixa de diálogo pode ser exibida solicitando o usuário e a senha do keychain.</p><p>A partir da versão 2019.3.2 do Tableau Prep Builder, você pode passar esse parâmetro adicional para desabilitar essa caixa de diálogo de chaves.</p><p>Exemplo:</p><p><b>MacOS</b>: <code>/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</code></p></td></tr><tr><td><code>-h, --help</code></td><td><p>Exibe o menu de ajuda para as opções da linha de comando.</p></td></tr></tbody></table>