Ajuda do Tableau Server no Windows

É possível usar os comandos tsm sites para exportar um site existente e importá-lo para um novo site (também chamado de migração de site) e para importar o novo site. O comando unlock está disponível caso um erro bloqueie um site.

Os comandos tsm sites usarão o armazenamento de arquivos local para armazenar os dados de exportação e importação. Se estiver executando um cluster do Tableau com vários nós, execute os comandos tsm sites em um Tableau Server que estiver com o Processador de dados em execução. Para mais informações sobre o processo do processador de dados e os processos que o exigem, consulte Processos do Tableau Server.

Observação: ao migrar sites entre instâncias do Tableau Server, o site de destino deve estar em uma versão do Tableau Server que é igual ou posterior à versão do Tableau Server para o site de origem. Os sites de origem e de destino devem ser de versões compatíveis do Tableau Server.

Para obter as etapas mais abrangentes de como exportar um site, consulte Exportar ou importar um site.

tsm sites export

Exporta um site específico do Tableau Server para um arquivo .zip. Exporte um site para arquivar as configurações em um momento específico ou para completar a primeira etapa de um processo de migração de site.

Observação: os comandos tsm sites import e tsm sites export podem deixar um site em estado bloqueado se um erro ocorrer. Para desbloquear um site, use o comando tsm sites unlock.

Sinopse

tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options]

Opções

-f,--file <export-file>

Obrigatório.

Especifica o nome do arquivo no qual o Tableau Server salva todas as informações do site.

Este arquivo é gerado para o diretório definido na variável basefilepath.site_export.exports do TSM. Como padrão:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Para obter mais informações sobre os caminhos do arquivo e como criá-los, consulte tsm File Paths.

-id,--site-id <source-siteID>

Obrigatório.

A ID do site sendo exportado. Você poderá obter a ID do site pela URL quando estiver conectado a um site por meio de um navegador da Web. Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.

-ow,--overwrite

Opcional.

Substitui um arquivo de exportação do mesmo nome já existente.

--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 43.200 (720 minutos).

tsm sites import

Este comando usa o arquivo .zip criado com tsm sites export para gerar um conjunto de arquivos .csv que mostra como as configurações do site de origem exportado mapearão para o próximo site de destino.

Por padrão, o arquivo .zip é gerado e salvo no diretório siteexports, em:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Antes de usar este comando, copie o arquivo .zip para o diretório no qual o Tableau espera que ele esteja. Este local está definido na variável basefilepath.site_import.exports do TSM. Por padrão, o diretório de importação é:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

Para obter mais informações sobre os caminhos do arquivo e como criá-los, consulte tsm File Paths.

Observação: os comandos tsm sites import e tsm sites export podem deixar um site em estado bloqueado se um erro ocorrer. Para desbloquear um site, use o comando tsm sites unlock.

Sinopse

tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options]

Opções

-f,--file <export-file.zip>

Obrigatório.

Nome do arquivo .zip criado pelo processo tsm sites export, e que deve ser copiado no diretório de importação. Como padrão:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

-id,--site-id <target-siteID>

Obrigatório.

A ID do novo site para o qual está sendo importado (o site de destino). Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.

-c,--continue-on-ignorable-errors

Opcional.

Continuar importação de site se ocorrerem erros que podem ser ignorados. Esses erros podem indicar problemas com a importação de uma pasta de trabalho ou fonte de dados específica.

-k,--no-verify

Opcional.

Ignora a verificação de arquivos de mapeamento.

-m, --override-schedule-mapper <mapping-file.csv>

Opcional.

Agenda um arquivo de mapeamento para anular o mapeamento normal por nome.

--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 7.200 (120 minutos).

tsm sites import-verified

Especifica o diretório que contém arquivos de mapeamento .csv de um site exportado, para importar a um novo site. Esta é a etapa final de um processo de migração de site.

Sinopse

tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options]

Opções

-id,--site-id <target-siteID>

Obrigatório.

A ID do novo site para o qual está sendo importado (o site de destino). Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.

-w, --import-job-dir <importjob-directory>

Obrigatório.

Pai do diretório mappings que contém o arquivo .csv do site exportado (origem). O nome deste diretório pai inclui a ID de importação, a data e a hora. Por exemplo:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457

--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 7.200 (120 minutos).

tsm sites unlock

Use este comando para desbloquear um site.

Opções

-id,--site-id <target-siteID>

Obrigatório.

A ID do site sendo desbloqueado. Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.

-d, --desired-state <state to leave unlocked site in>

Opcional.

O estado em que o site deve ser deixado após ser desbloqueado. As opções são "ativo” e "suspenso”. O padrão é "ativo” se não for especificado.

Por exemplo:

tsm sites unlock -id mysite -d suspended

--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 300 (5 minutos).

Opções globais

-h, --help

Opcional.

Exibir a ajuda do comando.

-p, --password <senha>

Obrigatório, com -u ou --username se não tiver sessões ativas.

Especificar a senha do usuário especificado no -u ou --username.

Se a senha tiver espaços ou caracteres especiais, coloque-a entre aspas:

--password "my password"

-s, --server https://<hostname>:8850

Opcional.

Usar o endereço definido para o Gerenciador de serviços do Tableau. A URL deve começar com https, incluir a porta 8850 e usar o nome do servidor, não o endereço IP. Por exemplo, https://<tsm_hostname>:8850. Se nenhum servidor for especificado, o https://<localhost | dnsname>:8850 é considerado.

--trust-admin-controller-cert

Opcional.

Use este sinalizador para confiar no certificado autoassinado do controlador TSM. Para obter mais informações sobre confiança de certificado e conexões CLI, consulte Conexão de clientes do TSM.

-u, --username <usuário>

Obrigatório se nenhuma sessão estiver ativa, com -p ou --password.

Especificar uma conta de usuário. Se não incluir essa opção, o comando é executado usando as credenciais de logon.