--- schema_version: "1" id: f8f411326143a77571ba6f6c01f4ba7923b78bf727fb74780504b7c5097a8874 title: tsm File Paths collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/server/cli_default_filepaths_tsm.md canonical_url: https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm source_site: help.tableau.com content_type: documentation content_hash: b2a567dffc88b4c11deff33764959f31649094e373956ce3d92016890be0207e description: View and change the default file path locations tsm commands use for backups and other files. --- [Pular para o conteúdo principal](#main-content) # tsm File Paths Certos comandos tsm leem ou gravam arquivos nos locais padrão. Esses locais são determinados por chaves de configuração `basefilepath` definidas para cada comando. O tsm pode ser usado para exibir o valor atual das chaves e alterar os locais. ### Conta de sistema NetworkService Em algumas empresas, políticas de segurança que restringem o acesso ao arquivo para contas do sistema são implementadas, como a conta NetworkService. Se você alterar os caminhos do arquivo tsm, verifique se a conta de sistema NetworkService tem permissão completa (com herança de permissões habilitada) para o caminho resultante. Além disso, se você alterar um caminho de arquivo que estava originalmente no caminho `*\data\tabsvc\*`, você deve manter as permissões do NetworkService do caminho original. Essa permissão deve ser mantida porque a conta de sistema NetworkService lida com operações pelo Controlador de administração do Tableau Server, Serviço de arquivo do cliente (Client File Service) e Serviço de coordenação do Tableau Server ### Permissões para o local do arquivo de backup/restauração Permissões necessárias para o site do arquivo de backup/restauração: - NetworkService: permissão de leitura/gravação/execução - Conta de serviço Run As: permissão de leitura/gravação/execução ## Localização padrão dos arquivos Durante os processos `tsm maintenance backup`, `restore`, e `ziplogs` e os processos `tsm sites export` e `sites import` , o Tableau Server usa os locais padrão dos arquivos criados ou usados por esses comandos. Para obter detalhes sobre os requisitos de espaço em disco para fazer backup do Tableau Server, consulte [Uso do espaço em disco para backup](https://help.tableau.com/current/server/pt-br/db_backup.htm#BackupDiskSpaceReqs). Como padrão: - Comandos de manutenção de tsm: - **backup** — O arquivo de backup `.tsbak` é criado em um local temporário no diretório de dados do nó inicial e, em seguida, salvo em: `:\data\tabsvc\files\backups` Por padrão, ele é: `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` `` Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no `D:\Tableau Server` o backup será salvo em: `D:\Tableau Server\data\tabsvc\files\backups` **Observação:** o comando de backup de manutenção do tsm não suporta os caminhos UNC (convenção de nomenclatura universal) de arquivo do Microsoft Windows, também conhecidos como "caminhos de rede" (\\\\\\\\), como o caminho para o local onde os arquivos de backup estão gravados. Em vez disso, use caminhos de sistema do arquivo local (:\\). - **backup** — local de preparo temporário. O arquivo de backup `.tsbak` é criado em um local temporário no diretório de dados do nó inicial. A partir da versão 2026.2.0, você pode especificar um local temporário alternativo para a criação do arquivo de backup. Isso pode ser útil se o arquivo de backup for grande ou se você tiver espaço limitado no nó inicial. Para obter mais informações, consulte [backuprestore.use\_custom\_staging\_dir.enabled](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#backuprestore_staging). - restore—O processo de restauração restaura um arquivo de backup de: `:\data\tabsvc\files\backups` Por padrão, ele é: `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` `` Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no `D:\Tableau Server` o processo de restauração usará um backup em: `D:\Tableau Server\data\tabsvc\files\backups` - ziplogs—O arquivo ziplogs é gerado em: `:\data\tabsvc\files\log-archives` Por padrão, ele é: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives` Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no `D:\Tableau Server` o arquivo de ziplogs será gerado em: `D:\Tableau Server\data\tabsvc\files\log-archives` - tsm sites - export—O arquivo .zip de exportação é gerado no seguinte diretório: `:\data\tabsvc\files\siteexports` Por padrão, ele é: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports` Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no `D:\Tableau Server` o arquivo de exportação .zip será gerado em: `D:\Tableau Server\data\tabsvc\files\siteexports` - import—Durante o processo de importação, o Tableau Server busca os arquivos em: `:\data\tabsvc\files\siteimports` Por padrão, ele é: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports` Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no `D:\Tableau Server` o processo de importação procurará arquivos em: `D:\Tableau Server\data\tabsvc\files\siteimports` ## Obter o local atual do arquivo Para ver o local atual do arquivo de um comando específico com `tsm configuration get`: - Para comandos de manutenção de tsm: - backup and restore: `tsm configuration get -k basefilepath.backuprestore` - ziplogs: `tsm configuration get -k basefilepath.log_archive` - Para comandos de sites tsm: - export `tsm configuration get -k basefilepath.site_export.exports` - import `tsm configuration get -k basefilepath.site_import.exports` ## Alterar locais atuais de caminho de arquivo base Você pode alterar alguns locais usados pelo TSM para ações de arquivo usando o comando `tsm configuration set` para atualizar as variáveis `basefilepath`. Para obter detalhes sobre caminhos específicos de arquivo base, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm). A alteração da variável `basefilepath` não move os arquivos existentes do diretório original para o novo. Para que os arquivos de backup, restauração e log, ou os arquivos de exportação e importação de site residam no novo diretório especificado, é necessário movê-los manualmente. Você é responsável por criar o novo local e por definir as permissões corretas para permitir o acesso ao tsm a qualquer arquivo que será colocado aqui e à estrutura de diretório contendo esses arquivos. Se você alterar o caminho do arquivo base de backup/restauração, deverá executar o comando [tsm maintenance validate-backup-basefilepath](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmValidateBackupBasefilepath) (disponível na versão 2022.1 e posterior) para verificar se as permissões estão configuradas corretamente. O comando `tsm maintenance backup` usa um local de preparo temporário no diretório de dados para ações de arquivo (montagem, extração) antes de salvar o arquivo de backup no local especificado pela variável `basefilepath.backuprestore`. A partir da versão 2026.2.0, se você configurar o TSM para usar o local especificado por `basefilepath.backuprestore`, o backup será montado em subdiretórios temporários sob o local especificado por `basefilepath.backuprestore`. Para versões anteriores à 2026.2.0, alterar o basefilepath não afeta o local onde o comando `tsm maintenance backup` monta o arquivo de backup. Não é possível especificar um local `basefilepath.backuprestore` na raiz de uma unidade. Deve estar em uma pasta. - Para comandos de manutenção de tsm: - `backup` e `restore` Para alterar o diretório usado pelo comandos `backup` e `restore` , , execute o comando a seguir: `tsm configuration set -k basefilepath.backuprestore -v ":\new\directory\path"` - Local de preparo de `backup` **Nota:** a capacidade de alterar o local de teste está disponível a partir da versão 2026.2.0. Para alterar o local de teste temporário usado pelos comandos `backup` para subdiretórios no local `basefilepath.backuprestore`, execute o seguinte comando: `tsm configuration set -k backuprestore.use_custom_staging_dir.enabled -v true` Quando definido como `true`, o comando `backup` usa diretórios temporários sob o local especificado pelo valor de `basefilepath.backuprestore`. - Para alterar o diretório dos ziplogs: `tsm configuration set -k basefilepath.log_archive -v ":\new\directory\path"` - Para comandos de sites tsm: - Para alterar o diretório de exportação de sites: `tsm configuration set -k basefilepath.site_export.exports -v ":\new\directory\path"` - Para alterar o diretório de importação de sites: `tsm configuration set -k basefilepath.site_import.exports -v ":\new\directory\path"` Após alterar o local padrão do arquivo, é necessário fazer o seguinte: 1. Aplique as alterações pendentes: `tsm pending-changes apply` Se as alterações pendentes exigirem uma reinicialização do servidor, o comando `pending-changes apply` exibirá um prompt para que você saiba que ocorrerá uma reinicialização. Esse prompt será exibido mesmo que o servidor esteja parado, porém, nesse caso, não há reinicialização. Cancele o prompt com a opção `--ignore-prompt`, mas isso não altera o comportamento de reinicialização. Se as alterações não exigirem uma reinicialização, elas serão aplicadas sem um prompt. Para obter mais informações, consulte [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply). 2. Interrompa o Tableau Server: `tsm stop` 3. Reinicie o Controlador TSM: `net stop tabadmincontroller_0` `net start tabadmincontroller_0` 4. Espere alguns minutos até que o controlador reinicie. Confirme se o controlador foi reiniciado com este comando: `tsm status -v` Quando for possível executar o comando e o Controlador de administração do Tableau Server estiver listado como "em execução", o controle terá reiniciado. 5. Inicie o Tableau Server: `tsm start`