Ajuda do Tableau Prep

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 Opções do instalador(O link abre em nova janela). Para obter uma lista das propriedades do instalador suportadas, consulte Propriedades do instalador(O link abre em nova janela).

• tableau_<product_installer_name>.exe é o instalador do Tableau para o produto e a versão que você está instalando.

• option1, option2 etc é como você deseja que o processo de instalação seja executado.

• PROPERTY1, PROPERTY2 etc especifica as configurações que o instalador deve fazer durante o processo de instalação.

Exemplo:

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

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.

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

Para ativar o produto durante a instalação adicione uma única linha de comando que inclua a opção do instalador ACTIVATE_KEY “<key>” e insira a chave do produto entre aspas.

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.

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.

Para obter mais informações, consulte Registre o Tableau Desktop e o Tableau Prep Builder(O link abre em nova janela).

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

Windows: execute o arquivo tableau.exe com a opção --refresh e uma chave de produto.

MacOS: Execute a opção -refresh no objeto do Tableau no caminho /Applications.

Desative a chave do produto fornecida para que possa ser reutilizada. Também aceita single-dash (-return).

Windows: execute o arquivo tableau.exe com a opção -return e uma chave de produto.

MacOS: Execute a opção -return no objeto do Tableau no caminho /Applications.

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.

Exemplo de arquivo. json:

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

Comando de exemplo:

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"

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.

Exemplo:

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"

Diretório usado para armazenar dados do aplicativo Electron.

Enquanto --repository-location gerencia os ativos da empresa (logs e dados), --user-data-directory gerencia o mecanismo interno do aplicativo.

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.

Observação: quando você executa o comando, ele cria automaticamente a pasta especificada em --user-data-directory. No entanto, a conta de usuário que executa o script deve ter permissões de “gravação” para esse diretório pai.

Exemplo:

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"

Abra o arquivo de fluxo de .tfl especificado. Use aspas duplas se o caminho do arquivo incluir espaços.

Exemplo:

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”

Abra o arquivo de fluxo .tflx empacotado especificado.

Exemplo:

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"

O caminho para o arquivo de .json que contém as credenciais para suas fontes de dados e servidores.

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 Requisitos do arquivo Credentials.json(O link abre em nova janela).

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.

Exemplo de arquivo de configurações .json - Snowflake:

{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						

Exemplo:

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

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.

Para obter mais informações, consulte “Executar fluxos que incluem valores de parâmetros” em Requisitos do arquivo Credentials.json(O link abre em nova janela).

Exemplo:

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

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.

Exemplo:

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

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

Exemplo:

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

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.

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.

Exemplo:

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

Exibe o menu de ajuda para as opções da linha de comando.