# tableau Tableau Server on Windows (server) - Full Documentation

<!-- document id=b504f85346bb8abd149c4505c9dd880211a200550c8c306b124c0cf4761e7f2e url=/tableau/current/pt-br/server/data_acceleration.md -->

[Pular para o conteúdo principal](#main-content)

# Aceleração da exibição

**Mudanças importantes para Aceleração de exibição e Aceleração de dados do Tableau**

O recurso Aceleração de exibição e as APIs de Aceleração de dados do Tableau foram descontinuados. Esses recursos foram descontinuados no Tableau Cloud em junho de 2026 e no Tableau Server versão 2026.2.

Os administradores e os proprietários de pastas de trabalho que têm licenças Creator ou Explorer podem acelerar as pastas de trabalho em Tableau Server. Os administradores podem suspender exibições individuais ou desativar a aceleração de seu site. A aceleração de exibição carrega exibições mais rapidamente ao pré-computar e buscar os dados da pasta de trabalho em um processo em segundo plano. Há dois gargalos em potencial ao carregar uma exibição:

1. Consulta (buscando dados da fonte de dados).
2. Renderização (criar os visuais, como desenhar formas ou renderizar um mapa).

O tempo necessário para carregar uma pasta de trabalho depende do tempo combinado necessário para executar essas duas etapas. No entanto, nem todas as exibições podem ser aceleradas. A aceleração de exibição melhora o desempenho da primeira etapa (consulta). Se a exibição estiver carregando lentamente por outros motivos que não a consulta, a aceleração da exibição não melhorará o desempenho da pasta de trabalho.

Quando os usuários criam exibições personalizadas sobre uma exibição acelerada, as dez exibições personalizadas mais usadas são pré-computadas automaticamente. Essas exibições personalizadas aceleradas não contam para o limite de exibição. As exibições personalizadas que não foram acessadas nos últimos 14 dias não serão aceleradas. Se você acelerar diretamente uma exibição personalizada, tanto a visualização original quanto a exibição personalizada serão aceleradas.

## Acelere sua exibição

1. Entre em um site no Tableau Server.
2. Na página inicial ou Explorar, navegue até a exibição que deseja acelerar.
3. Escolha o ícone Acelerar e selecione o comutador para Acelerar.

![Janela Aceleração de exibição](/tableau/current/pt-br/server/pt-br/Img/view_acceleration.png)

**Observação:** desativar o comutador Acelerar impede que os usuários acelerem uma visualização, mas não remove a opção de aceleração da visualização.

Você também pode acelerar exibições na página da pasta de trabalho se uma das três formas:

1. Selecione a exibição desejada e escolha Aceleração > Ativada no menu Ações.  
    ![Página de opção de aceleração no menu Ações na pasta de trabalho](/tableau/current/pt-br/server/pt-br/Img/viewacc_3.png)
2. Selecione o menu Mais opções (...) menu para a exibição desejada e escolha Aceleração > Ativada.  
    ![Página de opção de aceleração em nível de linha no menu Mais opções na pasta de trabalho](/tableau/current/pt-br/server/pt-br/Img/viewacc_2.png)
3. Para acelerar todas as exibições na pasta de trabalho, escolha Aceleração > Ativada no menu Mais opções (...).  
    ![Página de opção de aceleração no menu Mais opções na pasta de trabalho](/tableau/current/pt-br/server/pt-br/Img/viewacc_1.png)

**Observação:** a aceleração de exibição não está disponível no Tableau Desktop.

## Entenda por que a Aceleração de Exibição está indisponível, suspensa ou ineficaz.

### A Aceleração de exibição está indisponível

Há alguns cenários em que a aceleração não está disponível para uma exibição.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problemas</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Resolução</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A exibição não tem dados históricos do tempo necessário para executar consultas.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Cada vez que uma exibição é carregada, leva alguns minutos para que os dados de visualização fiquem disponíveis. Para uma exibição recém-criada, carregue-a e aguarde alguns minutos antes de tentar acelerá-la.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O tempo histórico necessário para executar consultas para a exibição é inferior a 2 segundos.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A aceleração não é aceita para tais exibições porque não melhorará significativamente o desempenho da exibição.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A exibição não tem credenciais inseridas.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para pré-calcular os dados, o Tableau precisa se conectar automaticamente à fonte de dados em segundo plano sem qualquer interação do usuário. Como resultado, a aceleração de dados só é compatível com pastas de trabalho com credenciais de conexão inseridas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A exibição tem funções baseadas no usuário ou tem uma fonte de dados com funções baseadas no usuário.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Atualmente, o Tableau não oferece suporte à aceleração dessas exibições. Exemplos de funções baseadas no usuário são USERDOMAIN() e USERNAME().</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O proprietário da exibição está inativo.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para pré-calcular os dados, o proprietário deve ser um usuário ativo. O Tableau não oferece suporte à aceleração de uma exibição se seu proprietário estiver inativo. <a href="https://help.tableau.com/current/server/pt-br/owner.htm#change-the-owner-of-a-content-resource" target="_blank">Alterar a propriedade</a> para um usuário ativo.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A política de atualização de dados da exibição é inferior a 2 horas.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O custo pode ser alto para acelerar exibições que são atualizadas com tanta frequência, e o Tableau não quer sobrecarregar o desempenho do seu site. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/data_freshness_policy.htm" target="_blank">Definir uma política de atualização de dados</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">O local atingiu o limite de exibições que podem ser aceleradas.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><a href="https://help.tableau.com/current/server/pt-br/data_acceleration.htm#manage-view-acceleration-on-your-site" target="_blank">Atualizar configurações do site</a> para aumentar o número máximo de exibições que podem ser aceleradas ou escolha Sem limite.</td></tr></tbody></table>

### A Aceleração de exibição está suspensa

Existem alguns cenários em que a aceleração está suspensa.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problemas</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Resolução</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A aceleração da exibição foi suspensa.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/current/server/pt-br/data_acceleration.htm#view-and-manage-accelerated-workbooks" target="_blank">Reativar a aceleração da exibição</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Existem trabalhos de aceleração em segundo plano em execução para pré-calcular os dados da exibição.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Se os trabalhos falharem regularmente, a exibição será suspensa automaticamente. Os trabalhos poderão falhar se:</p><ul><li>As credenciais de uma exibição expirarem. <a href="https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm#update-saved-credentials" target="_blank">Atualizar as credenciais da visualização</a>.</li><li>O proprietário da visualização ficar inativo. <a href="https://help.tableau.com/current/server/pt-br/owner.htm#change-the-owner-of-a-content-resource" target="_blank">Alterar a propriedade</a> para um usuário ativo.</li><li>A fonte de dados da exibição tiver sido excluída. Entre em contato com o proprietário da exibição para atualizar a fonte de dados.</li><li>A tarefa de pré-calcular os dados demorar muito e expirar. A Aceleração da exibição tem um tempo de execução máximo de 30 minutos. Entre em contato com o proprietário da visualização para otimizar a pasta de trabalho.</li></ul></td></tr></tbody></table>

### A Aceleração de exibição está ineficaz

A aceleração de exibição reduz o tempo necessário para executar consultas de uma exibição. Se o tempo necessário para executar consultas não for o gargalo para o tempo de carregamento da exibição, você não notará uma melhoria significativa no desempenho durante o carregamento da exibição. Da mesma forma, uma exibição geralmente contém muitas consultas. Você não pode acelerar consultas com funções transitórias, como now() ou usando filtros de data relativa. Se uma exibição tiver uma consulta de longa duração com funções transitórias, você não notará uma melhoria no desempenho durante o carregamento da exibição.

## Atualizar exibições aceleradas

### Atualização baseada em eventos de exibições aceleradas

Nas pastas de trabalho com uma extração, todas as exibições aceleradas serão atualizadas quando a atualização da extração for concluída. Quando uma pasta de trabalho é republicada ou renomeada, todas as exibições aceleradas da pasta de trabalho são atualizadas.

### Atualização baseada em agendamento de exibições aceleradas

Os agendamentos para atualização de exibições aceleradas só poderão ser configurados se uma pasta de trabalho tiver pelo menos uma fonte de dados ativa.

As exibições aceleradas para pastas de trabalho que utilizam fontes de dados ativas são atualizadas com base nas políticas de atualização de dados da pasta de trabalho. Se não houver um agendamento definido para atualização dos dados, a política padrão de atualização de dados será usada. Para obter mais informações, consulte [Editar uma política de atualização de pasta de trabalho dados](https://help.tableau.com/current/online/pt-br/data_freshness_policy.htm#edit-a-workbook-data-freshness-policy).

## Gerenciar a aceleração de exibição em seu site

Por padrão, a aceleração de visualização é permitida.

1. Entre em um site no Tableau Server.
2. No painel esquerdo, escolha Configurações.
3. Na guia Geral, role até a seção Aceleração de exibição.
4. Marque a caixa de seleção para permitir que criadores e exploradores acelerem as exibições em suas pastas de trabalho. Desmarque a caixa de seleção para desativar a Exibição acelerada para o site.  
    **Observação:** desmarcar a caixa de seleção impede que os usuários acelerem as visualizações em suas pastas de trabalho, mas não remove a opção de aceleração de suas visualizações.
5. Insira o número máximo de visualizações que podem ser aceleradas para seu site ou escolha Sem limite.  
    ![Configurações de Aceleração de exibição](/tableau/current/pt-br/server/pt-br/Img/admin_view_acceleration.png)

## Exibições aceleradas recomendadas

Com base no tempo de consulta e no uso de uma pasta de trabalho, a Tableau às vezes recomenda a aceleração para melhorar o desempenho de exibições e painéis mais lentos e populares. Se a aceleração estiver disponível para uma exibição, os usuários poderão recomendar a aceleração para uma exibição a cada 30 dias.

Quando um usuário acessa uma exibição, ele vê a opção Recomendar aceleração para o administrador de site ou proprietário da pasta de trabalho.

![Janela Aceleração de exibição. A aceleração reduz o tempo de carregamento inicial para exibições com consultas de execução longa. Envie uma recomendação ao proprietário da pasta de trabalho para acelerar essa exibição. Botão Recomendar aceleração](/tableau/current/pt-br/server/pt-br/Img/view_acceleration_recommend.png)

Quando o administrador de site ou o proprietário da pasta de trabalho acessa a mesma exibição, ele vê a opção de acelerar a exibição e vê quantos usuários recomendaram a aceleração.

![Janela Aceleração de exibição. A aceleração reduz o tempo de carregamento inicial para exibições com consultas de execução longa. Aceleração recomendada por 1 visualizador](/tableau/current/pt-br/server/pt-br/Img/view_acceleration_recommended.png)

### Gerenciar exibições recomendadas para aceleração

Como administrador de site, você pode ver quando o Tableau recomendou a aceleração para uma exibição:

1. Entre no site do Tableau.
2. No painel esquerdo, escolha Tarefas .
3. Na coluna Status de aceleração, verifique as exibições com um status Recomendado. Você também pode usar o Filtro no painel do lado direito para filtrar exibições com um status de Recomendado.

Recomendações personalizadas para aceleração como um proprietário ou administrador de uma pasta de trabalho:

1. Entre no site do Tableau.
2. No canto superior direito da página, escolha o ícone do menu da conta.
3. Selecione Meu conteúdo.
4. Selecione a guia Desempenho.
5. Na coluna Ações, escolha Acelerar.

## Suspenda automaticamente a aceleração para economizar recursos

Para conservar recursos, os administradores podem suspender automaticamente a aceleração para exibições que apresentam falhas consistentes. Os administradores podem definir um limite para o número de vezes que uma tarefa de aceleração pode falhar por dia, semana ou mês antes que a aceleração seja suspensa automaticamente.

1. Entre no site do Tableau.
2. No painel esquerdo, escolha Configurações.
3. Na guia Geral, role até a seção Aceleração de exibição.
4. Em Suspender automaticamente exibições aceleradas para economizar recursos, marque Permitir suspensão automática.
5. Insira o número de acelerações com falha que ocorrem em um período, antes que a aceleração da exibição seja suspensa.
6. Selecione o intervalo de tempo para amostragem: dia, semana ou mês.  
    Por exemplo, se você inserir 25 como o número e Semana como o período, a aceleração da exibição será suspensa se a exibição falhar mais de 25 vezes em um período de 7 dias.
7. Escolha Salvar.  
    
    ![Caixa de diálogo para definir o número máximo de falhas para aceleração](/tableau/current/pt-br/server/pt-br/Img/viewacc_4_Server.png)

## Visualizar e gerenciar pastas de trabalho aceleradas

1. Entre no site do Tableau.
2. No painel esquerdo, escolha Tarefas .
3. Selecione a guia Exibições aceleradas.
4. Escolha o menu Ações (...) para Retomar ou Suspender aceleração para a exibição ou exibições selecionadas.
![Guia Exibições aceleradas da página Tarefas](/tableau/current/pt-br/server/pt-br/Img/admin_acceleration_tasks.png)

## Gerenciar notificações de aceleração de exibição

Os administradores podem gerenciar se devem receber notificações para exibições que são suspensas automaticamente.

1. Entre no site do Tableau.
2. No painel esquerdo, escolha Configurações.
3. Na guia Geral, role a página até a seção Gerenciar notificações.
4. Para receber notificações de exibições suspensas automaticamente, marque a caixa Aceleração de visualizações.
5. Escolha Salvar.

Quando as exibições são suspensas automaticamente, as notificações são enviadas aos administradores do site e do servidor. A notificação inclui informações sobre por que a exibição foi suspensa e a hora em que a exibição foi suspensa. Selecione notificação para ir para a guia Exibições aceleradas da página Tarefas. Nessa página, os administradores podem filtrar o Status de aceleração para localizar exibições que foram suspensas automaticamente.

## Compreender o contexto do usuário para pré-computação

A pré-computação de pastas de trabalho aceleradas é realizada com o contexto do usuário de apenas um usuário. Este usuário é:

- o proprietário da pasta de trabalho (se não houver filtros de usuário na pasta de trabalho ou na fonte de dados, ou se houver filtros de usuário na fonte de dados, mas a fonte de dados for uma fonte de dados publicada).  
    \-ou-
- o usuário selecionado para a geração de miniaturas na última vez que a pasta de trabalho foi publicada (se houver filtros de usuário na pasta de trabalho, e a fonte de dados não for uma fonte de dados publicada).

## Entender o custo da aceleração de exibição

Habilitar esse recurso aumenta a carga de computação e o número de trabalhos nos processos do processador em segundo plano do Tableau Server porque a aceleração de dados busca os dados necessários de fontes de dados em um processo em segundo plano. Um trabalho em segundo plano para pré-computar os dados de uma pasta de trabalho habilitada é executado se o seguinte acontecer:

- A fonte de dados publicada e a pasta de trabalho é republicada (isso inclui o salvamento da criação na Web).
- Uma extração usada pela pasta de trabalho é atualizada.

Os administradores devem levar em consideração esses custos antes de habilitar a Aceleração de exibição para muitas pastas de trabalhos, ou agendar trabalhos de aceleração com muita frequência.

- As pastas de trabalho que estão sendo muito editadas e republicadas podem não ser adequadas porque cada republicação aciona uma pré-computação. Recomendamos a aceleração para pastas de trabalho publicadas para consumo.
- Se uma pasta de trabalho usar várias extrações, a atualização acionará a pré-computação dos dados. Assim, atualizações frequentes de extrações para pastas de trabalho habilitadas podem causar um pico na carga do trabalho em segundo plano, especialmente dado que, , por padrão, os trabalhos de Aceleração de , exibição são executados após a atualização bem sucedida da extração.
- Os dados pré-computados para pastas de trabalho são armazenados como exibições materializadas no Hyper.

<!-- document id=a89ac2f0d7ec9bae20e2a8b65b95cc27636ce39eaec067e77680299f21390326 url=/tableau/current/pt-br/server/teams_explore.md -->

[Pular para o conteúdo principal](#main-content)

# Acessar o conteúdo do Tableau no Microsoft 365

O aplicativo Tableau para Microsoft 365 está disponível no Teams, Word e PowerPoint.Com o aplicativo Teams, você pode interagir com exibições (visualizações) e métricas e compartilhá-las em mensagens, canais e reuniões.Com os suplementos do Word e do PowerPoint, você pode adicionar instantâneos de imagens de exibições e métricas a seus documentos e slides e atualizar esses instantâneos.

Para que o aplicativo Tableau esteja disponível no Microsoft 365, o administrador deve implantá-lo e conectá-lo ao site do Tableau.Para obter informações sobre como instalar o aplicativo Tableau como administrador, consulte [Configurar o aplicativo Tableau para Microsoft 365](https://help.tableau.com/current/server/pt-br/teams_set_up.htm).

Observação: se você tiver definido o idioma no Tableau ou no Microsoft 365 para um idioma com suporte para Tableau diferente do inglês (EUA), você poderá ver texto em inglês que não está localizado.

## Usar o aplicativo Teams

Se o administrador não pré-instalou o aplicativo para você, mas o implantou para sua organização, você mesmo pode instalá-lo.Para saber como, consulte [Adicionar um aplicativo ao Microsoft Teams](https://support.microsoft.com/pt-br/office/add-an-app-to-microsoft-teams-b2217706-f7ed-4e64-8e96-c413afd02f77) na documentação do Microsoft Teams.

O aplicativo Teams tem três guias: Tableau, Pulse e Configuração.A guia Tableau mostra as exibições que você adicionou como favoritas.A guia Pulse mostra as métricas que você segue e um resumo das informações sobre essas métricas.Esteja ciente de que a guia Pulse aparece apenas para sites do Tableau Cloud.A guia Configuração permite definir o site que o Microsoft Teams verifica ao pesquisar conteúdo e, se você for um administrador do Tableau, permite adicionar e remover configurações do site.

Se você não tiver exibições favoritas ou métricas seguidas, não verá nenhum conteúdo no aplicativo.Faça logon diretamente no site do Tableau para adicionar exibições como favoritas e seguir as métricas.Para obter mais informações, consulte [Marcar favoritos](https://help.tableau.com/current/pro/desktop/pt-br/favorites.htm) e [Seguir métricas](https://help.tableau.com/current/online/pt-br/pulse_explore_metrics.htm#follow-metrics).Embora seja possível adicionar outros tipos de conteúdo como favoritos, nenhum dos seus conteúdos favoritos, além das exibições, aparece no aplicativo Tableau.Se você quiser ver todas as exibições em uma pasta de trabalho, adicione cada exibição individual às suas favoritas.

### Explorar o conteúdo no Teams

Na guia Tableau ou Pulse, clique no cartão de uma exibição ou métrica para abrir a versão interativa completa.A exibição ou métrica interativa permite ver mais detalhes sobre os dados e filtrá-los com base em diferentes dimensões ou intervalos de tempo.

#### Pesquisar conteúdo

Se você souber o nome de uma exibição ou métrica, poderá procurá-la no aplicativo Tableau.Você também pode inserir a URL de uma exibição na barra de pesquisa para acessar conteúdo específico ou exibições personalizadas.

1. Na guia Tableau ou Pulse, selecione o ícone de pesquisa.
    
    ![Ponto de entrada da pesquisa do aplicativo Tableau](/tableau/current/pt-br/server/pt-br/Img/teams_app_search.png)
2. Insira o nome da exibição ou métrica.
3. Selecione o botão abrir ao lado do nome da exibição ou da métrica para acessar a versão interativa.

#### Seguir uma métrica

Cada métrica representa um conjunto exclusivo de filtros.Ao filtrar uma métrica existente, você criará uma nova métrica se ainda não existir uma com esses filtros.Siga a nova métrica para vê-la na guia Pulse e no resumo de informações.

1. Em uma métrica, selecione o ícone seguir (assinar esta métrica).
    
    ![Ícone Seguir em uma métrica](/tableau/current/pt-br/server/pt-br/Img/teams_app_follow.png)
    
    Você pode deixar de seguir a métrica selecionando o botão novamente.

#### Compartilhar conteúdo

1. Em uma exibição ou métrica, selecione o ícone compartilhar.
    
    ![Ícone Compartilhar](/tableau/current/pt-br/server/pt-br/Img/teams_app_share.png)
2. Selecione a pessoa, o bate-papo em grupo ou o canal com o qual compartilhar.
3. Selecione Compartilhar.

#### Alternar sites

1. Na guia Tableau ou Pulse, selecione o nome do site no menu de navegação.Se mais de um site estiver conectado ao aplicativo Tableau, você verá uma lista de sites.
    
    ![Opções de alternância de site](/tableau/current/pt-br/server/pt-br/Img/teams_app_switch_site.png)
2. Selecione o site para o qual deseja alternar.

### Adicionar conteúdo do Tableau a canais e reuniões

#### Fixar conteúdo em uma guia de canal

1. No canal onde deseja fixar o conteúdo do Tableau, selecione o ícone + para adicionar uma guia.
    
    ![Adicionar opções de guia de canal](/tableau/current/pt-br/server/pt-br/Img/teams_app_channel_tab.png)
2. Na lista de aplicativos, selecione o aplicativo Tableau.
3. Selecione o conteúdo a ser fixado.Para fixar uma exibição personalizada, selecione o botão de pesquisa e insira a URL da exibição.Você pode fixar uma exibição e até cinco métricas por guia.Para fixar mais conteúdo do Tableau, adicione uma segunda guia.
    
    ![Exibições e métricas do Tableau para fixar](/tableau/current/pt-br/server/pt-br/Img/teams_app_pin_content.png)
4. Selecione Salvar.
5. Como opção, para renomear a guia, selecione o menu suspenso na guia e, em seguida, selecione Renomear.
    
    ![Opção Renomear na guia Tableau](/tableau/current/pt-br/server/pt-br/Img/teams_app_rename_tab.png)

#### Adicionar o conteúdo do Tableau a uma reunião

Primeiro, você deve criar uma reunião e depois adicionar conteúdo do Tableau.Você não pode adicionar aplicativos de terceiros durante a criação de uma reunião.

1. No aplicativo Calendário, localize a reunião à qual pretende adicionar o conteúdo do Tableau e, em seguida, selecione Editar.
2. Selecione Mais opções.
3. Na barra de ferramentas, selecione Aplicativos.
4. Na lista de aplicativos, selecione o aplicativo Tableau.
5. Selecione o conteúdo a ser fixado.
6. Selecione Salvar.
7. Salve as alterações na reunião.
8. Depois de iniciar a reunião, selecione a guia Tableau.Isso abre o conteúdo do Tableau em um painel lateral, visível apenas para você.
9. No painel lateral, selecione o botão compartilhar para estágio.Isso torna o conteúdo visível para outras pessoas na reunião.Esteja ciente de que o conteúdo que você compartilha aparece para os outros da mesma forma que você o vê, de forma semelhante ao compartilhamento de tela.Se houver segurança em nível de linha nos dados, todos na reunião verão sua exibição dos dados.

### Compartilhar o conteúdo do Tableau em mensagens

Se você souber a URL de uma exibição ou métrica, poderá compartilhar rapidamente esse conteúdo colando a URL em uma mensagem.A extensão de mensagem do Tableau transforma o link em um cartão que mostra o título do conteúdo e uma miniatura, com um botão para abrir a exibição ou métrica interativa completa.Se você não souber a URL do conteúdo que deseja enviar, poderá procurar conteúdo para compartilhar.

1. Em uma mensagem, selecione o ícone + (Ações e aplicativos).
2. Selecione o aplicativo Tableau.
3. Pesquise no site do Tableau a exibição ou métrica que deseja compartilhar.
4. Selecione a exibição ou métrica.A geração do cartão para este conteúdo demora alguns instantes.
    
    ![Cartão de métrica em uma mensagem do Teams](/tableau/current/pt-br/server/pt-br/Img/teams_app_metric.png)
5. Envie a mensagem.

## Usar os suplementos do Word e do PowerPoint

O suplemento do Tableau aparece na guia Página inicial no Microsoft Word e no PowerPoint.Para saber como acessar um suplemento, consulte [Começar a usar seu suplemento do Office](https://support.microsoft.com/pt-br/office/start-using-your-office-add-in-82e665c4-6700-4b56-a3f3-ef5441996862) na documentação da Microsoft.Observe que, para que o aplicativo Tableau esteja disponível para uso, o administrador do Microsoft 365 precisa primeiro implantá-lo e conectá-lo a um site do Tableau.

### Adicionar uma visualização ou métrica a documentos e slides

Com o suplemento do Tableau, você pode adicionar um instantâneo de imagem de uma visualização ou métrica a seus documentos e slides.Observe que as métricas do Tableau Pulse estão disponíveis apenas para o Tableau Cloud.

Essas imagens mostram a hora em que foram adicionadas e o usuário que as adicionou, além dos links de imagem para o conteúdo no Tableau Cloud ou no Tableau Server.A imagem é a mesma para todos os usuários, portanto, se houver segurança em nível de linha aplicada aos dados, a imagem mostrará a exibição dos dados específica do usuário que adicionou a imagem.Se outros usuários abrirem o link de imagem no Tableau Cloud ou no Tableau Server, esses usuários verão a exibição interativa ou a métrica com suas credenciais aplicadas.

1. Na guia Página inicial, selecione o suplemento do Tableau.
2. Selecione Inserir imagem de visualização ou Inserir imagem do Pulse.
    
    ![Inserir opções de visualização ou métrica para o suplemento do Microsoft 365](/tableau/current/pt-br/server/pt-br/Img/microsoft_365_add_in.png)
3. Pesquise pelo nome da exibição ou métrica que deseja adicionar ou selecione entre suas exibições favoritas ou métricas seguidas.
4. Na visualização da exibição ou métrica, selecione Inserir imagem.

Se você tiver a URL do site do Tableau do conteúdo que deseja adicionar, poderá escolher Inserir conteúdo da URL.

#### Usar uma exibição personalizada para mostrar dados filtrados

Para adicionar uma exibição filtrada dos dados, insira uma exibição personalizada.

1. Abra a exibição no Tableau Server ou no Tableau Cloud.
2. Filtre a exibição para mostrar os dados que deseja incluir no instantâneo e, em seguida, crie uma exibição personalizada.Para obter mais informações, consulte [Usar exibições personalizadas](https://help.tableau.com/current/server/pt-br/customview.htm).
3. Abra o suplemento do Tableau no Word ou no PowerPoint.
4. Selecione Inserir conteúdo da URL e cole na URL da exibição personalizada.

### Atualizar uma visualização ou métrica

A imagem é um instantâneo tirado no momento em que você a adiciona.Se a imagem não representar mais os dados mais recentes, atualize-a.

1. Na guia Página inicial, selecione o suplemento do Tableau.
2. Selecione Atualizar dados.O suplemento do Tableau identifica todas as imagens do Tableau no documento ou nos slides.
3. Selecione o conteúdo que deseja atualizar e selecione Atualizar selecionado.

<!-- document id=b0f631bb4703c1abebb1ac99e52c764df9a3a4011cce9b9dc7a78cc582aaf811 url=/tableau/current/pt-br/server/service_remote.md -->

[Pular para o conteúdo principal](#main-content)

# Acessar o status remotamente

**Observação**: as informações neste artigo se referem ao status da página do Tableau Server. Para obter informações sobre o status da página do Tableau Server e do TSM, consulte [Exibir o status de processos do servidor](https://help.tableau.com/current/server/pt-br/service_viewstatus.htm).

Você deve ser um administrador do Tableau Server para ver a página Status do servidor, mas pode conceder acesso remoto a outros computadores para permitir o acesso a uma versão que pode ser lida pelo computador (XML) da tabela Status por usuários que não são administradores e por computadores diferentes do nó do Tableau Server inicial. Isso pode ser feito como parte de um processo de monitoramento remoto.

Para conceder acesso remoto ao status do Tableau:

1. Abra um prompt de comando como um administrador e digite o seguinte:
    
    ```
    tsm configuration set -k wgserver.systeminfo.allow_referrer_ips -v <ip address>
    ```
    
    No comando acima, `<ip address>` é o endereço IPv4 do computador para o qual você deseja habilitar o acesso remoto ao status XML do Tableau Server.
    
    Por exemplo:
    
    ```
    tsm configuration set -k wgserver.systeminfo.allow_referrer_ips -v 10.32.139.31
    ```
    
    Se estiver habilitando o acesso remoto para mais de um computador, use vírgulas para separar cada endereço IP.
    
    ```
    tsm configuration set -k wgserver.systeminfo.allow_referrer_ips -v 10.32.139.31,10.32.139.35
    ```
2. Confirme a alteração na configuração:
    
    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).
    
    Agora, os usuários de computadores com os endereços IP que foram adicionados podem exibir o status do processo do Tableau inserindo a URL `http://<server>/admin/systeminfo.xml` em um navegador ou em uma linha de comando (por exemplo, `curl http://jsmith/admin/systeminfo.xml`).
    
    Se o Tableau Server foi configurado para funcionar com um balanceador de carga ou servidor proxy, use o nome de host ou endereço IP do nó inicial do Tableau Server para acessar a versão XML da página de status.

Para obter detalhes sobre o XML retornado, consulte [Obter o status do processo como XML](https://help.tableau.com/current/server/pt-br/service_status_xml.htm).

<!-- document id=b0719eadab55983be35c89bc4aa6b449fe861a74f9f4f64aaadaf107b6e17468 url=/tableau/current/pt-br/server/to_connected_clients.md -->

[Pular para o conteúdo principal](#main-content)

# Acessar sites de clientes conectados

Por padrão, o Tableau Server permite que os usuários acessem o site diretamente de um _cliente_ do Tableau. Ele permite este acesso após o usuário fornecer as credenciais pela primeira vez que fizer logon por meio do cliente. Neste caso, um cliente é um aplicativo ou serviço do Tableau que pode trocar informações com o Tableau Server. Exemplos de clientes do Tableau incluem Tableau Desktop, Tableau Prep Builder e Tableau Mobile.

O Tableau Server estabelece um _cliente conectado_ ao criar um token de atualização seguro que identifica exclusivamente um usuário quando esse usuário faz logon no cliente.

<!-- document id=f5f4627f8b15f43c3dfd8b5e320caafe233fec4796be23ecb1ef8d5f14b10f84 url=/tableau/current/pt-br/server/runas_access.md -->

[Pular para o conteúdo principal](#main-content)

# Acesso aos dados com a conta de serviço Run As

Quando a Autenticação do Windows é configurada, a conta de serviço Run As requer permissões de leitura e consulta para os bancos de dados acessados pelo Tableau Server. Conforme projetado, as permissões da conta de serviço Run As resultam no acesso aos mesmos bancos de dados pelos usuários do Tableau Server com a função _Creator_ ou _Explorer (pode publicar)_. Os usuários com essas funções podem acessar e visualizar os bancos de dados com o mesmo nível de acesso que a conta de serviço Run As, ao se conectar aos bancos de dados usando a opção de Autenticação do Windows no Tableau Server.

Por exemplo, um usuário com a função Creator pode visualizar todos os bancos de dados com acesso concedido à conta de serviço Run As.

Se o usuário do Creator especificar o nome de host do banco de dados e selecionar a Autenticação do Windows ao criar uma nova fonte de dados em um navegador da Web, o usuário poderá visualizar os bancos de dados que têm permissão para a conta de serviço Run As.

O acesso de exibição aos ativos do banco de dados não se restringe aos usuários que se conectam ao Tableau Server com um navegador da Web. Usuários bem informados, com as mesmas funções observadas acima e conhecimento sobre os nomes de servidores do banco de dados, também podem criar pastas de trabalho com o Tableau Desktop que podem visualizar os bancos de dados que têm permissão para a conta de serviço Run As.

A funcionalidade descrita aqui é universal para todas as fontes de dados acessadas pela conta de serviço Run As, independentemente de como os usuários autenticam com o Tableau Server. Por exemplo, mesmo que os usuários autentiquem o Tableau Server com Kerberos ou SAML, o acesso deles a todas as fontes de dados configuradas pelo Run As será o mesmo. Os usuários do Creator ou Explorer (pode publicar) podem acessar todos os dados que têm permissão para a conta de serviço Run As.

## Recomendações

A organização deve avaliar se o acesso do usuário aos bancos de dados nesses cenários é aceitável. Geralmente, reduzir o uso e o escopo da conta de serviço Run As reduzirá a probabilidade de acesso inadvertido do usuário ao conteúdo do banco de dados. No entanto, reduzir o uso e o escopo da conta de serviço Run As também pode impor mais gerenciamento de credenciais para você e seus usuários.

Avalie as recomendações a seguir no contexto das necessidades da sua empresa e das políticas de acesso aos dados.

- Em primeiro lugar, você deve confiar em todos os usuários que têm funções de Creator ou Explorer (pode publicar). Você dependerá desses usuários para realizar as ações no Tableau com integridade.
- Se você não puder confiar em todos os usuários que têm direitos de publicação nas fontes de dados acessadas pela conta de serviço Run As, você deve considerar o uso de credenciais inseridas para essas fontes de dados.
- Se uma fonte de dados não for configurada para atualizações de extração automáticas, ou seja, a fonte de dados é acessada principalmente como uma conexão em tempo real, você pode utilizar a Delegação Kerberos. Para obter os requisitos, consulte [Habilitar a Delegação do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm).

<!-- document id=11613ba0913acd4770f49d7a1524507b3af5fa4f4ecdb574bc659429a170cbdb url=/tableau/current/pt-br/server/actions_url.md -->

[Pular para o conteúdo principal](#main-content)

# Ações de URL

Uma ação de URL é um hiperlink que aponta para uma página da Web, um arquivo ou outro recurso com base na Web fora do Tableau. Você pode usar as ações de URL para criar um e-mail ou link para obter informações adicionais sobre os dados. Para personalizar links com base em seus dados, você pode inserir automaticamente os valores de campo como parâmetros em URLs.

> [!TIP]
> 
> **Dica:** as ações de URL também podem abrir em um objeto de página da Web em um painel. Consulte [Ações e painéis](https://help.tableau.com/current/pro/desktop/pt-br/actions_dashboards.htm) para saber mais.

![Uma ação de URL é executada em um menu de dica de ferramenta. O link reflete o nome de ação, e não a URL de destino.](/tableau/current/pt-br/server/pt-br/Img/urlaction_tooltip.png)

Uma ação de URL é executada em um menu de dica de ferramenta. O link reflete o nome de ação, e não a URL de destino.

## Abrir uma página da Web com uma ação de URL

1. Em uma planilha, selecione Planilha > Ações. Em um painel, selecione Painel > Ações.
2. Na caixa de diálogo Ações, clique em Adicionar ação e selecione Ir para a URL.
3. Na caixa de diálogo subsequente, digite um nome para a ação. Para inserir variáveis de campo no nome, clique no menu Inserir à direita da caixa Nome.
    
    **Observação:** dê um nome descritivo à ação, pois o texto do link na dica de ferramenta é o nome da ação, não a URL. Por exemplo, ao se vincular a mais detalhes do produto, um nome apropriado poderia ser “Mostrar mais detalhes”.
4. Use a lista suspensa para selecionar uma planilha de origem ou uma fonte de dados. Se você selecionar uma fonte de dados ou um painel, poderá selecionar as planilhas individuais contidas nela.
    
    ![Um menu para escolher planilhas de origem e selecionar uma ação.](/tableau/current/pt-br/server/pt-br/Img/urlaction3.png)
5. Selecione como os usuários vão executar a ação.
    
    <table class="table--plain" style="width: 100%;"><colgroup><col><col></colgroup><tbody><tr><th style="text-align: left;">Se você escolher esta opção...</th><th style="text-align: left;">A ação será executada quando o usuário...</th></tr><tr><td><span class="uicontrol">Focalizar</span></td><td>Passar o mouse sobre uma marca na exibição. Esta opção é ideal para ações de destaque em um painel.</td></tr><tr><td><span class="uicontrol">Selecionar</span></td><td>Clicar em uma marca na exibição. Esta opção é ideal para todos os tipos de ações.</td></tr><tr><td><span class="uicontrol">Menu</span></td><td>Clicar com o botão direito do mouse (clicar pressionando a tecla Control, no Mac) em uma marca selecionada na exibição, em seguida, clicar em uma opção em uma dica de ferramenta (menu). Essa opção é ideal principalmente para ações de URL.</td></tr></tbody></table>
6. Para a URL de destino, especifique onde o link será aberto:
    - **Nova guia se não existir nenhum objeto de página da Web** - garante que a URL seja aberta em um navegador nas planilhas que não tenham objetos de página da Web. Essa é uma boa opção quando as Planilhas de origem são definidas como Todas ou uma fonte de dados.
    - **Nova guia do navegador** - abre no navegador padrão.
    - **Objeto de página da Web** - (disponível apenas para painéis com objetos de página da Web) é aberto no objeto de página da web selecionado.
    
    ![Três botões de opção para destino de URL: nova guia se não existir nenhum objeto de página da Web, nova guia do navegador e objeto de página da Web. Abaixo da opção de objeto de página da Web há uma caixa suspensa para selecioná-lo](/tableau/current/pt-br/server/pt-br/Img/urlaction-webpageobject.jpg)
    
    **Observação**: para opções de Nova guia, na primeira vez que a ação é executada, ela abre uma nova guia. Depois disso, a ação será aberta na mesma guia em vez de abrir outras adicionais.
7. Insira uma URL
    
    - A URL deve começar com um dos seguintes prefixos: `http`, `https`, `ftp`, `mailto`, `news`, `gopher`, `tsc`, `tsl`, `sms` ou `tel`
    
    **Observação**: se nenhum prefixo for inserido, `http://` é anexado automaticamente ao início e a ação de URL funcionará no Tableau Desktop. No entanto, se uma ação de URL sem prefixo for publicada no Tableau Server ou Tableau Cloud, ela falhará no navegador. Sempre forneça uma URL totalmente qualificada para ações se o painel for publicado.
    
    **Observação**: só é possível especificar um endereço ftp se um painel não contiver um objeto da Web. Se um objeto da Web existir, o endereço ftp não será carregado.
    
    - O Tableau Desktop também oferece suporte a caminhos locais como `C:\Example folder\example.txt`, bem como ações de URL de arquivo.
    - Para inserir os valores de campo e filtro como valores dinâmicos na URL, clique no menu Inserir à direita da caixa URL. Esteja ciente de que quaisquer campos referenciados devem ser usados na exibição. Para obter detalhes, consulte [Uso de valores de campo e filtro em URLs](#Using).
    
    ![Um formulário para adicionar uma ação de URL com um exemplo de hiperlink.](/tableau/current/pt-br/server/pt-br/Img/urlaction5.png)
    
    Abaixo da URL inserida, há um exemplo com hiperlink em que você pode clicar para testar.
8. (Opcional) Na seção Valores de dados, selecione qualquer uma das seguintes opções:
    - **Valores de dados criptografados que URLs não aceitam** - selecione esta opção se seus dados contiverem valores que usam caracteres não permitidos pelo navegador em uma URL. Por exemplo, se um de seus valores de dados contiver um E comercial, como “Vendas e finanças”, o E comercial deve ser convertido em caracteres que seu navegador entenda.
    - **Permitir vários valores via parâmetros de URL** - selecione esta opção caso esteja se vinculando a uma página da Web que receba listas de valores por meio de parâmetros da URL. Por exemplo, digamos que você selecione vários produtos em uma exibição e deseja ver os detalhes de cada produto hospedado em uma página da Web. Se o servidor puder carregar detalhes de vários produtos com base em uma lista de identificadores (ID ou nome do produto), será possível usar o recurso de multiseleção para enviar a lista de identificadores como parâmetros.
        
        Ao permitir vários valores, é necessário definir o caractere de escape do delimitador, que é o caractere que separa cada item na lista (por exemplo, uma vírgula). Também deve definir o Escape do delimitador, que é usado quando o caractere delimitador é utilizado em um valor de dados.

## Criar um e-mail com uma ação de URL

1. Em uma planilha, selecione Planilha > Ações. Em um painel, selecione Painel > Ações.
2. Na caixa de diálogo Ações, clique em **Adicionar ação** e selecione **Ir para a URL**.
3. Na lista suspensa Planilhas de origem, selecione a planilha que contém o campo com os endereços de e-mail para os quais deseja enviar.
4. Na caixa URL, faça o seguinte:
    
    - Digite **mailto:** e clique no menu Inserir à direita para selecionar o campo de dados que contém os endereços de e-mail.
    - Digite **?subject=** e insira um texto na linha de Assunto.
    - Digite **&body=** e clique no menu Inserir à direita para selecionar os campos de informações que deseja incluir no corpo do e-mail.
    
    No exemplo abaixo, o campo “E-mail” contém os endereços de e-mail, o assunto é “Informações sobre a cidade” e o texto do corpo de e-mail consiste nos dados da Cidade e do Estado associadas ao endereço de e-mail.
    
    ![ ](/tableau/current/pt-br/server/pt-br/Img/UsingActionEmail_BodyText.png):
5. (Opcional) Exiba os dados da sua pasta de trabalho no corpo do e-mail como uma lista vertical, em vez de uma lista horizontal. Por exemplo, suponha que você tenha uma lista horizontal de cidades, como Chicago, Paris, Barcelona, que gostaria de exibir verticalmente, desta maneira:
    
    Chicago  
    Paris  
    Barcelona
    
    Para tornar a lista vertical, na seção Valores de dados, faça o seguinte:
    
    - Desmarque **Codificar valores de dados que URLs não aceitam**
    - Selecione **Permitir vários valores por meio de parâmetros de URL**.
    - Digite **% 0a** na caixa de texto **Delimitador de valor** para adicionar quebras de linha entre cada item da lista. (Esses são os caracteres criptografados de URL para uma quebra de linha.)

## Uso de valores de campo e filtro em URLs

Quando os usuários acionam as ações de URL em marcas selecionadas, o Tableau pode enviar valores de campo, filtro e parâmetro como variáveis na URL. Por exemplo, se uma ação de URL se vincular a um site de mapeamento, você poderá inserir o campo de endereço para abrir automaticamente o endereço selecionado no site.

1. Na caixa de diálogo Editar ação de URL, comece a digitar a URL do link.
2. Posicione o cursor onde deseja inserir um valor de campo, parâmetro ou filtro.
3. Clique no menu Inserir à direita da caixa de texto e selecione o campo, parâmetro ou filtro que deseja inserir. A variável aparece dentro de suportes angulares. Você pode continuar adicionando quantas variáveis precisar.
    
    **Observação:** todos os campos referenciados devem ser usados na exibição. Caso contrário, o link não será exibido na visualização, mesmo que funcione quando você clicar em Testar link.
    
    ![Uma janela com campos para adicionar uma nova ação de URL.](/tableau/current/pt-br/server/pt-br/Img/parameter1.png)

### Inclusão de campos agregados

A lista de campos disponíveis inclui somente campos não agregados. Para usar valores de campo agregados como parâmetros de link, primeiro crie um campo calculado relacionado e adicione esse campo à exibição. (Se você não precisar do campo calculado na visualização, arraste-o para Detalhe no cartão Marcas.)

### Inserção de valores de parâmetro

Ao inserir valores de parâmetros, as ações de URL enviam o valor Exibir como por padrão. Para enviar o valor real, adicione os caracteres `~na` após o nome do parâmetro.

Por exemplo, digamos que você tenha um parâmetro que inclua endereços IP, com cadeias de caracteres Valor real, como 10.1.1.195, e cadeias de caracteres Exibir como usando valores mais amigáveis, como `Computer A (10.1.1.195)`. Para enviar o valor real, você revisaria o parâmetro na URL para ter esta aparência: `http://<IPAddress~na>/page.htm`.

<!-- document id=a421407cad50f29e8a31ac2e84d876d495035d20139e77c04eaf7b4aafda2514 url=/tableau/current/pt-br/server/adminview_users_all.md -->

[Pular para o conteúdo principal](#main-content)

# Ações por todos os usuários

As Ações por todos os usuários fornece o insight sobre como a instalação do Tableau Server é usada. É possível filtrar a exibição por ações e intervalo de tempo. Os administradores de servidor podem filtrar por site. A contagem de Usuários totais mostra o número de usuários que realizaram uma ação. Este valor não é afetado por filtros. A contagem de Usuários ativos mostra o número de usuários ativos que realizaram uma das ações selecionadas.

![Um gráfico de linhas exibe as ações realizadas pelos usuários em um servidor ao longo de um período de sete dias.](/tableau/current/pt-br/server/pt-br/Img/adminview_user_access.png)

Até três grupos separadores de linhas de tempo mostram como os usuários estão usando o Tableau Serverem um intervalo de tempo que você especifica (o padrão é os últimos 7 dias). Se nenhuma ação for selecionada para um determinado grupo, esse grupo não é exibido. Estes são os possíveis grupos:

- Acesso e interações − Mostra sua atividade de entrada (logon), o acesso à exibição e o uso da fonte de dados.
- Publicar e baixar − Mostra as publicações e downloads de fluxos, pastas de trabalho e fontes de dados.
- Assinaturas − Mostra contagens de e-mails de assinatura enviados para pastas de trabalho e exibições. Também mostra as contagens das execuções de fluxo.

Use a legenda na parte inferior para visualizar um subconjunto das ações exibidas. Clique em uma única ação para destacar a linha de ação ou **Ctrl + Clique** em várias ações para destacar mais de uma. Para desmarcar a seleção e exibir todas as ações selecionadas, clique em qualquer ação na legenda.

<!-- document id=1595069f3a8049c70c5896a41bef4197a27176d32674bdb943a5e699d4a3e686 url=/tableau/current/pt-br/server/adminview_user.md -->

[Pular para o conteúdo principal](#main-content)

# Ações por usuário específico

A exibição Ações por usuário específico oferece o insight sobre como cada usuário trabalha na instalação do Tableau Server. É possível filtrar a exibição por nome de usuário, ações e intervalo de tempo. Os administradores do servidor em instalações de vários sites podem filtrar por site.

![A visualização exibe as ações do servidor de um usuário na semana passada, com linhas distintas para cada tipo de ação, incluindo acesso e interações, publicação e downloads e assinaturas.](/tableau/current/pt-br/server/pt-br/Img/adminview_user_specific.png)

Até três grupos separadores de linhas de tempo mostram como um usuário selecionado está usando o Tableau Server em um intervalo de tempo que você especifica (o padrão é os últimos 7 dias). Se nenhuma ação for selecionada para um determinado grupo, ou se não houver ação, esse grupo não é exibido. Estes são os possíveis grupos:

- Acesso e interações − Mostra sua atividade de entrada (logon), o acesso à exibição e o uso da fonte de dados. Isso significa qualquer interação com uma Fonte de dados pelo usuário selecionado, incluindo atualizações de extração agendadas por esse usuário ou o acesso a uma pasta de trabalho associada a essa fonte de dados.
- Publicar e baixar − Mostra as publicações e downloads de fluxos, pastas de trabalho e fontes de dados.
- Assinaturas − Mostra contagens de e-mails de assinatura enviados para pastas de trabalho e exibições. Também mostra as contagens das execuções de fluxo.

Um gráfico de barras na parte inferior da exibição mostra quais itens o usuário selecionado está usando.

Use a legenda na parte inferior para visualizar um subconjunto das ações exibidas. Clique em uma única ação para destacar a linha de ação ou **Ctrl + Clique** em várias ações para destacar mais de uma. Para desmarcar a seleção e exibir todas as ações selecionadas, clique em qualquer ação na legenda.

<!-- document id=38c17c8f3c33da15b5c2d2e57d5fc833b8f0343b9015ffca639f4eaf5fc6365a url=/tableau/current/pt-br/server/adminview_users_recent.md -->

[Pular para o conteúdo principal](#main-content)

# Ações por usuários recentes

As Ações por usuários recentes mostram quais usuários logados estiveram ativos no Tableau Server nas últimas 24 horas. Isso pode ser útil se você necessita fazer alguma atividade de manutenção e quer saber quantos e quais usuários isso irá afetar, bem como o que estão fazendo no Tableau Server.

A exibição Ativo, Recentemente ativo e Ocioso em que os usuários estão atualmente conectados para o Tableau Server. Para essa exibição, um usuário ativo é aquele que faz uma ação nos últimos 5 minutos, um usuário ativo recente é aquele que fez uma ação por último em 30 minutos e um usuário ocioso é aquele que fez uma ação por último há mais de 30 minutos. As ações são exibidas na seção inferior da exibição.

![Uma tabela com duas seções. A primeira seção contém uma lista de usuários, seus nomes de sites associados e o horário de sua última atividade. A segunda seção exibe um gráfico de dispersão das ações do usuário ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/adminview_recentuser.png)

Selecione um usuário para ver somente as ações que o usuário realizou recentemente. Focalize uma ação para ver os detalhes dela.

![A dica de ferramenta mostra o tipo de ação que um usuário executou pela última vez e quando a ação aconteceu.](/tableau/current/pt-br/server/pt-br/Img/adminview_user_recent01.png)

<!-- document id=fd83fd9c406b3ee74721b2d817b8f9bb49daa347b201ee68173b3a9106d2ed3d url=/tableau/current/pt-br/server/capacity_add.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar capacidade ao Tableau Server

Talvez seja necessário adicionar capacidade à instalação do Tableau Server para permitir que você aumente o número de usuários (se tiver uma licença baseada em usuário) ou o número de núcleos (se tiver uma licença baseada em núcleo).

O Tableau fornecerá uma nova chave do produto que adiciona capacidade à instalação do Tableau Server existente. É necessário ativar essa chave e usá-la em conjunto com as chaves do produto existentes, para obter a capacidade combinada para a qual você está licenciado. Cada recurso (por exemplo, "Data Management") e tipo de licença (por exemplo, "Explorer") requer uma chave. Para obter mais informações sobre a relação entre chaves e licenças, consulte a [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList).

Siga as etapas abaixo para adicionar uma chave de produto ao Tableau Server.

Se o Tableau Server não estiver conectado à Internet, realize uma ativação off-line. Consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

**Observação:** se você atualizou para Tableau Server versão 2021.1 ou posterior, você não precisa mais reiniciar o Tableau Server quando adiciona capacidade. Para obter mais informações, consulte [Licenciamento de tempo de inatividade zero](https://help.tableau.com/current/server/pt-br/license_zero_downtime.htm).

1. Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.
2. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`
3. Clique em Licenciamento na guia Configuração e clique em Ativar licença:
    
    ![Página de configuração de licenciamento que exibe uma lista de licenças do Tableau Server e suas datas de expiração.](/tableau/current/pt-br/server/pt-br/Img/licensing.png)
4. Insira ou cole a nova chave do produto e clique em **Ativar**:
    
    ![Pop-up de ativação de licença com um campo para inserir uma chave de produto do Tableau Server de 20 dígitos.](/tableau/current/pt-br/server/pt-br/Img/license-activate02_tsm.png)
5. Após ativar a licença, você pode ser solicitado a se registrar no Tableau. Na página de Inscrição, insira as informações nos campos e clique em Inscrever.
    
    ![Etapa de registro do assistente de ativação do Tableau Server, com campos obrigatórios para preencher informações de contato, informações da empresa e detalhes regionais.](/tableau/current/pt-br/server/pt-br/Img/install_02_register.png)

1. Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.
2. Copie a chave do produto no computador.
3. Execute o seguinte comando:
    
    `tsm licenses activate --license-key <license key>`
4. Após ativar a licença, você pode precisar registrar o Tableau Server. Para fazer isso, crie um arquivo de registro e, em seguida, passe-o como uma opção com o comando `tsm register`.
    
    1. Gere um modelo que você possa editar executando o comando a seguir:
        
        `tsm register --template > /path/to/<registration_file>.json`
    2. Edite o arquivo modelo para criar o arquivo de registro completo.
        
        Aqui está um exemplo de um arquivo de registro no formato obrigatório:
        
        {
         "zip" : "97403",
         "country" : "USA",
         "city" : "Springfield",
         "last\_name" : "Simpson",
         "industry" : "Energy",
         "eula" : "yes",
         "title" : "Safety Inspection Engineer",
         "phone" : "5558675309",
         "company" : "Example",
         "state" : "OR",
         "department" : "Engineering",
         "first\_name" : "Homer",
         "email" : "homer@example.com"
        }
    3. Após salvar as alterações no arquivo, passe com a opção `--file` para registrar o Tableau Server:
        
        `tsm register --file /path/to/<registration_file>.json`
        
        Por exemplo:
        
        `tsm register --file C:\Users\mwatson\Documents\tableau-reg-file.json`

<!-- document id=0f1f3b030992570b11e8e15accbc3845018587c6ec33e5847e48472794b8e190 url=/tableau/current/pt-br/server/trusted_auth_trustIP.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar endereços IP confiáveis ou nomes de host ao Tableau Server

A primeira etapa da configuração da autenticação confiável é configurar o Tableau Server para reconhecer e confiar em solicitações de um ou mais servidores Web:

1. Abra o TSM em um navegador:
    
    https://<server\_name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique em Identidade e acesso na guia Configuração, em seguida clique em Autenticação confiável.
3. Em Autenticação confiável, para cada host confiável, insira o nome ou endereço IP e clique em Adicionar:
    
    ![Configurar a captura de tela de autenticação confiável](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-trustedauth.png)
    
    **Observações:**  
    Os valores definidos pelo usuário substituem completamente qualquer configuração anterior. Portanto, é obrigatória a inclusão da lista completa de hosts se desejar alterar uma lista existente.  
      
    Endereços IP estáticos são necessários: os servidores Web especificados precisam usar endereços IP estáticos, mesmo se usar nomes de host.  
      
    Caso tenha um ou mais servidores proxy entre o computador que está solicitando o ticket confiável (um dos configurados na etapa 2, conforme mostrado na [Autenticação confiável](https://help.tableau.com/current/server/pt-br/trusted_auth.htm)) e o Tableau Server, você também precisa adicioná-los como gateways usando a opção `tsm configuration set gateway.trusted`. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm) para obter as etapas de configuração.
4. Insira um valor em Comprimento do token (Opcional).
    
    O comprimento do token determina o número de caracteres em cada ticket confiável. A configuração padrão de 24 caracteres fornece 144 bits de aleatório. O valor pode ser definido como qualquer inteiro entre 9 e 255, inclusive.
5. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
6. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
7. Clique em Aplicar alterações e reiniciar.

1. Insira o seguinte comando:
    
    tsm authentication trusted configure -th <trusted IP address or host name>
    
    No comando acima, `<trusted IP address>` deve ser uma lista separada por vírgulas dos endereços IPv4 ou dos nomes de host dos servidores Web, com cada nome de host ou endereço IP entre aspas.
    
    **Observação**: os valores definidos pelo usuário sobrescrevem completamente qualquer configuração anterior. Portanto, é necessário incluir a lista completa de hosts no comando `tsm authentication trusted configure -th`. (Não é possível alterar a lista de hosts ao executar repetidamente o comando `tsm authentication trusted configure -th`.)
    
    Por exemplo:
    
    tsm authentication trusted configure -th "192.168.1.101", "192.168.1.102", "192.168.1.103" 
    
    ou
    
    tsm authentication trusted configure -th "webserv1", "webserv2", "webserv3" 
    
    **Observações:**  
    Cada nome de host ou endereço IP na lista deve estar entre aspas duplas, seguido de uma vírgula e um espaço após cada vírgula.  
    Os servidores da Web especificados precisam usar endereços IP estáticos, mesmo com nomes de host.
2. Caso tenha um ou mais servidores proxy entre o computador que está solicitando o ticket confiável (um dos configurados na etapa 2, conforme mostrado na [Autenticação confiável](https://help.tableau.com/current/server/pt-br/trusted_auth.htm)) e o Tableau Server, você também precisa adicioná-los como gateways usando a opção `tsm configuration set gateway.trusted`. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm) para obter as etapas de configuração.
3. Digite o seguinte comando para salvar as alterações a todos os arquivos de configuração de servidor:
    
    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).
    
    Há outras configurações de autenticação confiável opcionais (configurações de suporte herdado, logon e tempo limite) que podem ser selecionadas ao transferir um arquivo json para o Tableau Server. Consulte [Entidade trustedAuthenticationSettings](https://help.tableau.com/current/server/pt-br/entity_trusted_auth.htm).

Em seguida, você deverá [configurar seu servidor Web para receber tickets do Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_webrequ.htm).

<!-- document id=5e7877f93d3241c361db6a7d5db16e1bcbdc9aed5c671d7a020e3bc1ca424bae url=/tableau/current/pt-br/server/data_stories_create.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar Histórias com dados do Tableau a um painel

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Depois de [criar um painel](https://help.tableau.com/current/pro/desktop/pt-br/dashboards_create.htm), você pode adicionar o objeto Histórias com dados ao painel para exibir informações sobre sua visualização escritas no idioma natural. Hoje, as histórias de dados do Tableau são escritas apenas em inglês e estão disponíveis em Tableau Cloud, Tableau Server (versão 2023.1 e posterior) e Tableau Desktop. Não há limite de tamanho de dados ao criar Histórias com dados. No entanto, a geração da história expira após 45 segundos, se estiver tentando analisar muitos dados. Recomendamos o uso de Histórias com dados com visualizações de 1.000 ou menos pontos de dados.

**Observação:** a Histórias com dados do Tableau é aberta em uma janela pop-up, portanto, certifique-se de permitir pop-ups. Se você estiver usando o modo de tela cheia, as histórias com dados poderão ser abertas em uma nova guia.

1. Arraste o objeto História com dados para o painel do Tableau. Se você ainda não o fez, adicione uma planilha ao seu painel para usar as Histórias com dados do Tableau.  
    ![Objeto Histórias com dados com ícone de livro aberto encontrado no painel de edição do painel](/tableau/current/pt-br/server/pt-br/Img/data_story_object.png)
2. Na caixa de diálogo Histórias com dados, configure sua história escolhendo primeiro a planilha sobre a qual escrever. Quando você clica **Próximo**, o Tableau envia todos os dados da pasta de trabalho associada à instância do Tableau Cloud ou do Tableau Server na qual você está conectado.  
    ![Configure o painel com opções para escolher sobre qual folha você deseja escrever](/tableau/current/pt-br/server/pt-br/Img/data_story_configure_view.png)
3. Escolha as dimensões e medidas para incluir na história.  
    ![Configure o painel com a opção de arrastar e soltar dimensões e medidas que você deseja incluir em sua história](/tableau/current/pt-br/server/pt-br/Img/data_story_configure_field.png)
4. Escolha o tipo de história que melhor descreve seus dados:  
    ![Configure o painel com opções para escolher o tipo de história que melhor se adapta aos seus dados: Discreto, Contínuo, Percentual do todo ou Gráfico de dispersão](/tableau/current/pt-br/server/pt-br/Img/data_story_configure_story.png)  
    Discreto é melhor para valores qualitativos, como nomes ou datas, como em gráficos de barras ou colunas.  
    Contínuo é melhor para valores quantitativos ao longo do tempo, como um gráfico de linhas.  
    Percentual do todo é melhor para proporções de um todo, como um gráfico de pizza.  
    Gráfico de dispersão é melhor para relacionamentos entre valores numéricos, como um gráfico de gráfico de dispersão.
5. Clique em Concluído.

Para filtrar sua História com dados clicando em diferentes seções em sua visualização, abra o menu em sua visualização e clique em Usar como filtro.

Depois que sua história for gerada, clique em Configurações na parte superior do objeto História com dados para uma experiência guiada que ajuda a personalizar e contextualizar sua história. Para obter mais informações, consulte [Definir configurações para história com dados do Tableau](https://help.tableau.com/current/server/pt-br/data_stories_configure_edit.htm).  

**Observação:** se você tiver uma discrepância em suas Histórias com dados do Tableau (por exemplo, se os números em sua história forem diferentes da visualização), isso pode ser causado pela forma como sua visualização está configurada. Tente criar uma nova visualização em uma planilha diferente e, em seguida, adicione uma nova história com dados com a técnica [Use uma planilha oculta](https://help.tableau.com/current/server/pt-br/data_stories_more_data.htm#Use) para descobrir o problema subjacente.

<!-- document id=cfd4e07bbd05e74e6a3f6714022a4e8e22e142fc8deb2ddbb9c8ee7f737c4e06 url=/tableau/current/pt-br/server/image_role.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar imagens da Web dinamicamente a planilhas

No Tableau, sabemos que as imagens são uma ferramenta eficiente na análise de dados. Imagine que você está vendo uma visualização de vendas mensais de calçados. Os dados estão dizendo que você vendeu mais saltos altos do que calçados do tipo plataformas, mas você não consegue imaginar a diferença entre os dois tipos de sapato. É aí que entra a função de imagem. Você pode adicionar dinamicamente imagens da Web às suas planilhas e usá-las em seus cabeçalhos para adicionar detalhes visuais.  
  
![Visualização com imagens de sapatos junto com o tipo de sapato e vendas](/tableau/current/pt-br/server/pt-br/Img/imagerole_1.png)  

## Preparar a fonte de dados

A função de imagem pode ser atribuída a campos de dimensão discreta que contêm URLs que apontam para imagens da web. Para preparar seus dados, certifique-se de que seus campos de imagem atendam aos requisitos definidos pelo Tableau para receber uma função de imagem:

- Certifique-se de que as URLs naveguem para arquivos de imagem .png, .jpeg, .jpg, .svg, .webp, .jfif, .ico ou .gif.
- Verifique se cada URL começa com http ou https. Se um protocolo de transporte não estiver incluído, o Tableau assumirá https.
- Otimize o número de imagens usadas em seu conjunto de dados. Normalmente, você pode carregar até 500 imagens por campo.
- Certifique-se de que cada arquivo de imagem seja menor que 200 kb.

**Observação:** se você estiver usando o Tableau 23.1 ou anterior, as URLs devem navegar para arquivos de imagem com extensões de arquivo .jpg, .jpeg ou .png.  
  
No Tableau 23.2 e versões posteriores, há suporte para arquivos .gif, mas **animações** de .gif serão exibidas apenas no Tableau Cloud e no Tableau Server com uma renderização do lado do cliente. No Tableau Desktop e no Tableau Server com renderização no lado do servidor, o arquivo .gif será exibido como uma imagem estática.  
  
Dependendo da complexidade da sua visualização, o Tableau pode usar como padrão uma renderização do lado do servidor, o que limita o número de imagens a 100 por campo. Para saber mais sobre configurações de complexidade e renderização do lado do servidor, consulte [Configurar renderização do lado do cliente.](https://help.tableau.com/current/server/pt-br/browser_rendering.htm)

### Exemplo de conjuntos de dados

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: -1788px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Nome do produto</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">URL da imagem do produto</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Vendas de produtos</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Apartamentos</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/flats.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">12.118</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Salto alto</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/highheels.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">15.865</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tênis de corrida</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/runningshoes.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">14.200</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Salto tipo plataforma</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">https://img.example.com/wedges.png</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">8.665</td></tr></tbody></table>

## Atribuir uma função de imagem às URLs

Depois de se conectar à sua fonte de dados, você pode atribuir uma função de imagem às suas URLs na página Fonte de dados ou no painel Dados em uma planilha.

### Na página Fonte de dados:

1. Localize a coluna que tem URLs de imagem.
2. Clique com o botão direito do mouse (clique com a tecla Control no Mac) no ícone no canto superior esquerdo da coluna e selecione Função da imagem > URL .  
    O ícone muda para um ícone de imagem e suas imagens estão prontas para uso.  
      
    ![Opção de fonte de dados para atribuir uma função de imagem a URLs](/tableau/current/pt-br/server/pt-br/Img/imagerole_3.png)

### De uma planilha:

1. Abra uma nova planilha.
2. Localize um campo de dimensão discreta que tenha URLs de imagem.
3. Clique com o botão direito do mouse (clique com a tecla Control no Mac) no campo de dimensão e selecione Função da imagem > URL.  
    O ícone muda para um ícone de imagem e suas imagens estão prontas para uso.  
      
    ![Opção do painel Dados para atribuir uma função de imagem a dados](/tableau/current/pt-br/server/pt-br/Img/imagerole_2.png)

## Adicione imagens às suas visualizações

Na planilha, arraste o campo Função da imagem para a divisória Linhas ou Colunas. Agora você pode ver imagens junto com seus dados associados em sua visualização.  
  
![Crie uma função de imagem no painel de dados.](/tableau/current/pt-br/server/pt-br/Img/imagerole_addtoviz2.gif)

## Compartilhe suas visualizações

Você pode exportar suas pastas de trabalho com imagens e compartilhá-las. Certifique-se de que as imagens usadas em suas visualizações estejam disponíveis para serem visualizadas por todos com quem você compartilha suas visualizações. Por exemplo, se você estiver usando imagens hospedadas em um servidor interno protegido por um firewall, certifique-se de que todos com quem você compartilha a visualização tenham permissões suficientes para acessar as imagens. Neste exemplo, os usuários que visualizarem a visualização enquanto estiverem conectados ao mesmo servidor não deverão ter problemas para visualizar as imagens. Mas os usuários que exportam a visualização para um pdf em um servidor do Tableau Cloud podem não conseguir ver as imagens.

Se você exportar sua pasta de trabalho e seu visualizador tentar abri-la no Tableau 2022.3 ou anterior, o visualizador não poderá ver as imagens.

**Observação:** é uma prática recomendada sempre alinhar um campo de função de imagem com uma descrição de texto para tornar o conteúdo acessível para leitores de tela e outros softwares de acessibilidade.

## Solucionar problemas de conexões de imagens

Às vezes, as imagens não serão exibidas se você exceder o número de imagens permitido por campo, tiver arquivos de imagem grandes em uma visualização complexa ou estiver visualizando a visualização em um dispositivo móvel. Esta seção ajuda a solucionar esses erros.

### Nenhuma das imagens está sendo exibida na minha visualização

Há muitas imagens na visualização

Dependendo da complexidade da sua visualização, normalmente você pode carregar 500 imagens por campo. Se você tiver uma visualização complexa, pode ser padrão para renderização do lado do servidor. Com a renderização do lado do servidor, você pode carregar 100 imagens por campo.

Se você receber uma mensagem de erro informando que há muitas imagens na visualização, filtre as imagens e tente novamente.

O Tableau não pôde acessar as imagens

Se você receber ícones de imagem quebrados em vez de suas imagens, primeiro confirme se você tem permissões suficientes para visualizar as imagens (ou se, por exemplo, elas estiverem protegidas por um firewall). O Tableau deve poder acessar as imagens, e as imagens não podem exigir uma autenticação separada para visualizá-las.

Se você tem certeza de que tem permissão para visualizar as imagens e elas estão dentro dos requisitos de tamanho, verifique se as imagens da Web estão habilitadas na sua página de configurações.

No Tableau Desktop:

1. Na pasta de trabalho, clique em Ajuda na barra de ferramentas.
2. Selecione Configurações e desempenho > Definir segurança de exibição da Web do painel.
3. Certifique-se de que a opção Ativar objetos de página da Web e imagens da Web esteja marcada.

No Tableau Cloud:

1. Na página inicial, clique em Configurações.
2. Em geral, role para baixo e localize Objetos de página da Web e Imagens da Web.
3. Certifique-se de que a opção Ativar objetos de página da Web e imagens da Web esteja marcada.

### Algumas das imagens não estão sendo exibidas na minha visualização

O arquivo de imagem é muito grande

Cada arquivo de imagem deve ter menos de 200 kb para ser renderizado. Verifique o tamanho do arquivo de imagem e tente novamente.

Você está usando uma versão anterior do Tableau

Se você estiver usando o Tableau 23.1 ou anterior, apenas arquivos de imagem .png, .jpeg e .jpg são compatíveis. Atualize sua versão do Tableau ou use um tipo de arquivo compatível com a versão do Tableau que você está usando.

A URL da imagem deve começar com http ou https

Cada URL de imagem deve começar com http ou https. No momento, o Tableau não oferece suporte a chamadas FTP/SMTP. Verifique o formato da URL e tente novamente.

O arquivo de imagem deve ser uma URL

Uma função de imagem pode ser atribuída apenas a URLs que navegam para arquivos de imagem .png, .jpeg ou .jpg, .svg, .webp, .jfif, .ico, .bmp ou .gif. Verifique o formato da URL e tente novamente.

O tipo do arquivo de imagem não é compatível

Uma função de imagem pode ser atribuída apenas a URLs que navegam para arquivos de imagem .png, .jpeg ou .jpg, .svg, .webp, .jfif, .ico, .bmp ou .gif. Verifique o formato da URL e tente novamente.

Se você estiver usando o Tableau 23.1 ou anterior, apenas arquivos de imagem .png, .jpeg e .jpg são compatíveis. Atualize sua versão do Tableau ou use um tipo de arquivo compatível com a versão do Tableau que você está usando.  
No Tableau 23.2 e versões posteriores, há suporte para arquivos .gif, mas **animações** de .gif serão exibidas apenas no Tableau Cloud e no Tableau Server com uma renderização do lado do cliente. No Tableau Desktop e no Tableau Server com renderização no lado do servidor, o arquivo .gif será exibido como uma imagem estática.  

O arquivo de imagem contém caracteres inválidos

Uma função de imagem não pode ser atribuída a URLs com os seguintes caracteres:

< > & \\ ^ '

ou as seguintes sequências de caracteres:

.. \\\\. \\r\\n\\t

Verifique se a URL não contém nenhum desses caracteres ou sequências de caracteres e tente novamente.

### As imagens não estão sendo exibidas fora da minha planilha

As imagens não estão sendo exibidas na visualização na dica de ferramenta

A visualização na dica de ferramenta é processada com renderização do lado do servidor, que permite carregar até 100 imagens por campo. Verifique se você tem menos de 100 imagens por campo e tente novamente.

Para obter mais informações sobre renderização do lado do cliente e do servidor, consulte [Configurar renderização do lado do cliente.](https://help.tableau.com/current/server/pt-br/browser_rendering.htm)

Para saber mais sobre a visualização na dica de ferramenta, consulte [Criar exibições nas dicas de ferramenta (visualização em dica de ferramenta)](https://help.tableau.com/current/pro/desktop/pt-br/viz_in_tooltip.htm)

As imagens não estão sendo exibidas em Exibir em Miniatura

A Miniatura de exibição é processada com renderização do lado do servidor, que permite carregar até 100 imagens por campo. Verifique se você tem menos de 100 imagens por campo e tente novamente.

Para obter mais informações sobre renderização do lado do cliente e do servidor, consulte [Configurar renderização do lado do cliente.](https://help.tableau.com/current/server/pt-br/browser_rendering.htm)

As imagens não estão sendo exibidas quando exporto minha pasta de trabalho

Todas as exportações e recursos relacionados à exportação são processados com renderização do lado do servidor, que permite carregar até 100 imagens por campo. Verifique se você tem menos de 100 imagens por campo e tente novamente.

As imagens não estão sendo exibidas em um dispositivo móvel

Os dispositivos móveis têm um limite de complexidade menor que os computadores, portanto, o processamento é concluído por meio da renderização do lado do servidor, que permite carregar até 100 imagens por campo. Verifique se você tem menos de 100 imagens por campo e tente novamente.

Você pode alterar as configurações de complexidade em seu dispositivo móvel. Para obter mais informações sobre limites de complexidade, consulte [Configurar o limite de complexidade para computadores e dispositivos móveis.](https://help.tableau.com/current/server/pt-br/browser_rendering.htm#configure-the-complexity-threshold-for-computers-and-mobile-devices)

<!-- document id=a8595df5ab16bbdc2436708cf9eec233a3584f4346d1e2487a87031f05c5d2b5 url=/tableau/current/pt-br/server/data_stories_more_data.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar mais dados à sua história com dados do Tableau

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Atualmente, as histórias com dados são compatíveis com histórias com duas dimensões e uma medida, ou uma dimensão e até 10 medidas. Se você quiser escrever sobre dados que não precisa mostrar em seu painel, use uma planilha oculta para simplificar seu painel. Se você quiser adicionar mais de duas dimensões à sua história, concatene as dimensões ou crie várias histórias de dados e empilhe-as.  
  

## Use uma planilha oculta

Se você tiver dados que deseja incluir em uma História com dados do Tableau e não precisar mostrar todos os dados que geraram as informações, poderá usar uma planilha oculta para trazer medidas e dimensões adicionais para sua história sem sobrecarregar o painel.  
  

1. Arraste o objeto História com dados para seu painel para ver em quais planilhas você pode escrever na caixa de diálogo História com dados. Neste exemplo, há duas planilhas disponíveis para escrever.  
      
    ![Caixa de diálogo História com dados mostrando duas planilhas disponíveis: Turismo por país/região e Turismo ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/data_story_configure_view.png)

1. Traga outra fonte de dados, como "População", navegando até o menu à esquerda, selecionando Flutuante e arrastando essa planilha para o painel.  
      
    ![Caixa de diálogo História com dados mostrando três planilhas disponíveis: População, Turismo por país/região e Turismo ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/data_stories_hidden_3.png)

A caixa de diálogo História com dados é atualizada com a nova fonte de dados disponível.  

1. Clique em Layout e ajuste o tamanho para 1 x 1 para ocultar a planilha, mas mantenha os dados subjacentes em sua história.  
      
    ![A guia Painel com Flutuante selecionado.](/tableau/current/pt-br/server/pt-br/Img/data_stories_hidden_1.1.png)

Agora você pode configurar suas histórias usando esta planilha oculta.  

**Observação:** pode ser necessário desmarcar elementos de legenda adicionais para manter a planilha oculta.  

## Concatenar dimensões

Se seus dados contiverem três dimensões e uma medida e forem uma História discreta , você poderá concatenar (vincular) duas dessas dimensões criando um campo calculado.  
  

1. Na planilha que você deseja usar em sua história, clique em Análise e selecione Criar campo calculado.
2. Dê um nome ao campo calculado e use a fórmula a seguir para criar seu cálculo, usando o sinal + para unir as dimensões.  
    \[Dimensão 1\] + \[Dimensão 2\]  
      
    ![Uma caixa de cálculo que diz "\[População 0-14\]+\[População 15-64\]"](Img/data_stories_concatenate.png)

> [!TIP]
> 
> **Dica:** arraste suas dimensões para a caixa Campo calculado e coloque-as na fórmula.  

1. Clique em OK.
2. Arraste seu novo campo calculado para o painel Detalhe para torná-lo acessível em sua história com dados.

## Empilhe várias histórias com dados

Escreva sobre mais medidas e dimensões criando várias Histórias com dados e empilhando-as verticalmente ou horizontalmente em seu painel.  

Por exemplo, se você quiser criar uma história sobre receita real versus receita de referência, poderá criar duas histórias diferentes - uma com a receita real e a primeira referência e outra com a receita real e a segunda referência - e compará-las.

<!-- document id=826d90b4f8c15c3493305f428a742627aa0c53431cfdbfa87fea5d9d41527ffc url=/tableau/current/pt-br/server/sites_delete.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar ou excluir sites

O Tableau Server é fornecido com um site chamado Padrão. Os administradores de servidor podem adicionar ou excluir sites à medida que as necessidades de uma organização mudam.

## Adicionar um site

1. Execute um destes procedimentos:
    
    - Se estiver adicionando um site ao servidor pela primeira vez, selecione **Configurações** > **Adicionar um site** e, em seguida, clique em **Adicionar um site**.
        
        ![Adicione uma opção de Site com instruções para hospedar vários sites no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/sites_add_ss.png)
    - Se já tiver adicionado sites antes, no menu do site, clique em **Gerenciar todos os sites** e, em seguida, clique em **Novo site**.
        
        ![Opção do Tableau Cloud para adicionar um novo site.](/tableau/current/pt-br/server/pt-br/Img/sites_add_multi.png)
2. [Edite as configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm)para personalizá-lo para sua organização.

## Excluir sites

Os administradores de servidor podem excluir sites que foram adicionados ao Tableau Server. A exclusão de um site também remove pastas de trabalho e fontes de dados que foram publicadas no site, bem como usuários. Se um usuário pertencer a outros sites, eles não serão removidos. Para excluir permanentemente um usuário, vá para a página Usuários do servidor.

**Observação:** O site Padrão não pode ser excluído.

1. No menu do site, clique em **Gerenciar todos os sites** e, em seguida, clique em **Sites**.
2. Selecione o site que deseja remover e, em seguida, no menu Ações, clique em Excluir.
3. Clique em **Excluir** na caixa de diálogo de confirmação exibida.

<!-- document id=6b710b369675a2e90456cede2e2eedc8a12dfd064ddb94ec6284975b64eb8b55 url=/tableau/current/pt-br/server/projects_add.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar projetos e mover conteúdo para eles

O conteúdo do Tableau (como pastas de trabalho ou fontes de dados) precisa estar em um projeto. A partir do Tableau Server 2022.3 e do Tableau Cloud de outubro de 2022, se o Data Management estiver licenciado e o Catalog habilitado, os ativos externos (como bancos de dados e tabelas) também poderão estar em projetos. Os administradores de servidor e site podem adicionar ou remover projetos de nível superior em um site e mover o conteúdo publicado de um projeto para outro. Os líderes de projetos com funções de site adequadas podem adicionar ou remover projetos secundários e mover o conteúdo entre projetos nos quais têm acesso de Líder de projeto.

Este artigo contém as etapas para criar e mover projetos. Recomendamos se familiarizar com o seguinte conteúdo relacionado:

- Para saber sobre os projetos e quando e por que usá-los, consulte [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm).
- Antes de criar hierarquias de projetos, familiarize-se com [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#projectpermissions).
- Para ver as funções de site que permitem acesso completo de líder de projeto, consulte [Administração no nível do projeto](https://help.tableau.com/current/server/pt-br/projects.htm#project-admin).

## Adicione um projeto secundário (aninhado) ou de nível superior

1. Enquanto estiver conectado no Tableau Server como um administrador ou líder de projeto, selecione a guia Explorar, em seguida, faça um dos seguintes:
    
    - Selecione Novo > Projeto para criar um novo projeto de nível superior (somente administradores podem fazer isso).
    - Navegue até o projeto onde deseja criar um subprojeto e abra-o, em seguida selecione Novo > Projeto. Se você não tiver certeza de onde encontrar o projeto filho, selecione Todos os projetos no menu suspenso ao lado de Explorar ou use os filtros no canto superior direito.
2. Insira um nome e uma descrição para o projeto e, em seguida, clique em Criar.
    
    ![Nova caixa de diálogo de projeto com campos para nome e descrição do projeto.](/tableau/current/pt-br/server/pt-br/Img/projects_new1.png)
    
    É possível incluir formatação e hiperlinks na descrição do projeto. Selecione **Mostrar dicas de formatação** para a sintaxe. Também é possível [Adicionar uma imagem de projeto](https://help.tableau.com/current/server/pt-br/custom_projectimage.htm).
    
    Ao inserir a descrição de um projeto, inclua um espaço entre letras maiúsculas e parênteses para exibir o conteúdo dentro deles, como “PROJETO (a)”. A omissão deste espaço causará problemas de exibição na descrição do projeto.
    
    **Observação:** para editar uma descrição do projeto mais tarde, selecione o ícone de informações próximo ao nome e clique em **Editar**.

## Use a árvore de projetos para navegar pelos projetos

Por padrão, o painel Explorar exibe uma árvore de projetos para ajudar você a navegar facilmente pelos seus projetos. Você pode usar a árvore de projetos para encontrar subprojetos dentro de uma pasta de projeto. Você também pode usar a árvore de projetos para procurar projetos.  

![A árvore do projeto no painel Explorar no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Cloud_ProjectTree.png)  

Você pode ocultar e exibir a árvore do projeto clicando no ícone dela localizado no painel Explorar.  
  
![O ícone da árvore do projeto no painel Explorar no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Cloud_ProjectTreeIcon.png)  

> [!TIP]
> 
> **Observação**: para garantir que a árvore do projeto esteja visível, mantenha uma largura de janela do navegador de pelo menos 1441px na página Explorar. Uma janela mais estreita (1440px ou menos) ou uma tela de resolução mais baixa ocultará a árvore do projeto.

## Mover um recurso para outro projeto

1. Na seção Explorar, localize o ativo que deseja descrever. Você pode usar os filtros no canto superior direito para pesquisar ou navegar pela hierarquia do projeto.
2. No menu Ações(…) da pasta de trabalho, selecione Mover.
3. Selecione um novo projeto para a pasta de trabalho e, em seguida, clique em Mover conteúdo.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/projects_move_project.png)
    
    Mover um projeto inclui mover todo o conteúdo, incluindo projetos secundários e seus ativos.

### Como a movimentação dos projetos afeta as permissões

Ao mover um projeto, as permissões de Líder do projeto se adaptam ao novo ambiente do projeto.

- Quando a hierarquia do projeto de destino for **Bloqueada**, as permissões de Líder do projeto anteriores serão removidas e novas serão concedidas, de acordo com as definidas no nível superior da hierarquia de destino.
- Quando a hierarquia do projeto de destino for **Personalizada**, as permissões de Líder do projeto anteriores concedidas implicitamente serão removidas, as definidas explicitamente serão mantidas e as novas serão concedidas de acordo com as definidas no nível superior da hierarquia de destino.

Ao mover projeto e ativos, as permissões podem ser afetadas. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#moveproject).

## Excluir um projeto

Quando você exclui um projeto, todo o conteúdo do Tableau no projeto também é excluído. Se você deseja excluir um projeto, mas não o conteúdo, transfira o conteúdo para outro projeto e, em seguida, exclua o projeto.

Recursos externos, como bancos de dados e tabelas, não são excluídos, mas movidos para o Projeto padrão de recursos externos. (No Tableau Server 2022.3 e versões anteriores, os ativos podem ser encontrados em Ativos Externos.)

**Importante**

- Não é possível desfazer a exclusão de um projeto.
- A exclusão de um projeto exclui todo o conteúdo do Tableau, incluindo projetos secundários e seu conteúdo, mas não ativos externos.
- Você não pode excluir o projeto Padrão ou o Projeto padrão de ativos externos.

Para excluir um projeto:

1. Na seção Explorar, localize o projeto que deseja remover. Se você não tiver certeza de onde encontrar o projeto, selecione Todos os projetos no menu suspenso ao lado de Explorar ou use os filtros no canto superior direito.
2. No menu Ações (…) do projeto, selecione Excluir.
3. Confirme que deseja excluir o projeto.

## Requisitos para movimentação de ativos

Mover o ativo é efetivamente como removê-lo de um projeto e publicá-lo em outro. Para os não administradores, as permissões necessárias no projeto de origem são diferentes das permissões no projeto de destino.

### Função no site exigida

Para mover os ativos, os usuários devem ter uma das seguintes funções no site:

- Administrador do servidor (somente no Tableau Server)
- Creator (Administrador de site) ou Explorer (Administrador de site)
- Creator ou Explorer (pode publicar)

Os usuários com uma função no site Administrador do servidor ou Administrador de site não precisam de recursos adicionais.

### As permissões exigidas para o projeto no qual os usuários movem o conteúdo _para_

Os não administradores precisam ter o recurso de permissão Publicar para o projeto de destino.

### As permissões exigidas para o projeto no qual os usuários movem conteúdo _de_

Usuários não administradores devem

- Ser o proprietário do projeto, líder do projeto ou proprietário de conteúdo do projeto original
    
    OU
- Ter o recurso de permissão Mover do conteúdo (ou, para fontes de dados, ser o proprietário da fonte de dados). Ao mover um banco de dados com suas tabelas, o usuário deve ter o recurso Mover para o banco de dados _e_ as tabelas.

Para obter mais informações sobre como mover ativos, consulte [Mover conteúdo](https://help.tableau.com/current/server/pt-br/permissions.htm#MoveContent).

<!-- document id=16b6efcee798f2228bdd57cd4622893263896f6ae2d341f1637260fc7e6c0933 url=/tableau/current/pt-br/server/ipa_vconn_add_tables.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar tabelas à conexão

Na guia Tabelas:

Adicionar tabelas à conexão

**Adicionar tabelas**

Escolha uma opção:

- À esquerda, em **Tabelas** , clique duas vezes nos nomes da tabela ou selecione as tabelas e arraste-as para a painel **Tabelas** à direita. Inclua uma tabela de direitos, se estiver usando uma.
- Selecione ![Novo botão SQL personalizado](/tableau/current/pt-br/server/pt-br/Img/ipa_New_Custom_SQL_btn.png) para criar um esquema de tabela personalizado ou selecione Converter para SQL personalizado em uma tabela existente e use-a como ponto de partida para SQL personalizado.

Selecione ![O ícone de atualização de dados na barra de ferramentas do editor de conexão virtual](/tableau/current/pt-br/server/pt-br/Img/ipa_vconns_refresh_icon.png) para obter os dados mais recentes do banco de dados para todas as conexões.

**Ver e editar os detalhes da tabela**

1. Selecione uma tabela na guia Tabelas.
2. Na seção Detalhes da tabela, selecione um valor de coluna para fazer edições como ocultar ou renomear uma coluna ou alterar o tipo de dados.

Selecione o modo de tempo real ou de extração para tabelas

Defina tabelas individuais para o modo de tempo real ou de extração:

- Tempo real - Consultadas diretamente no banco de dados. (Em tempo real é o padrão.)
- Extração somente - Extraídas e salvas no Tableau.

Em Tabelas, selecione a tabela ou tabelas para as quais deseja alterar o modo e selecione Ações, e Mudar para tempo real ou Alterar para extração.

- Selecione Criar extratos pendentes para criar extratos ou Atualizar todas as extrações para atualizá-los após a criação.
- No menu de ações de uma revisão (...) > Extrair configurações para configurar a extração para atualização incremental.
- Agende atualizações de extração na página de conexão virtual após publicar a conexão.  
    [Ler o tópico de agendamento de extração](https://help.tableau.com/current/server/pt-br/dm_vconn_extract.htm)

Definir o estado de visibilidade da tabela

Use a alternância de Visibilidade para mostrar ou ocultar as tabelas dos usuários.

![Marca de verificação significa mostrar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_check_mark_show.png) Os usuários podem ver os dados da tabela. Crie uma política para controlar quais dados os usuários podem ver. (Visível é o padrão.)

![X significa esconder](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_x_hide.png) Os usuários não podem ver os dados da tabela. Você pode usar tabelas ocultas em uma política de dados e como uma tabela de direitos.

Consulte os detalhes da tabela

Selecionar uma tabela na parte superior da guia Tabelas para ver seus detalhes abaixo.

Alterne as informações da tabela que você vê usando estes ícones:

![O ícone de marca representa o tipo de dados da coluna.](/tableau/current/pt-br/server/pt-br/Img/ipa_Tag_16px_medium.png) Tipo de dados para cada coluna.

![O ícone da tabela representa os dados de amostra da coluna.](/tableau/current/pt-br/server/pt-br/Img/ipa_Table_16px_medium.png) Dados de amostra para cada coluna.

![O ícone do perfil representa o intervalo de valores da coluna.](/tableau/current/pt-br/server/pt-br/Img/ipa_Panes_show_16px_medium.png) Intervalo de valores em um histograma para cada coluna selecionada.

**Clipe rápido**: veja os detalhes da sua mesa.

Your browser does not support the video tag.

Veja as Chaves vinculadas Selecionadas em ![Ícone da tabela](/tableau/current/pt-br/server/pt-br/Img/ipa_Table_16px_medium.png) para ver quais colunas estão vinculadas a outras tabelas. As chaves vinculadas mostram apenas quando os bancos de dados têm informações de chave primária e externa.

Publique a conexão e defina as permissões

### Salvar um rascunho ou publicar uma conexão

Sua conexão é salva automaticamente como um rascunho enquanto você trabalha. Salve manualmente o rascunho clicando em ![Salvar ícone](/tableau/current/pt-br/server/pt-br/Img/ipa_Save_16px_medium.png).

Para compartilhar uma nova conexão virtual com outros usuários, você precisa publicá-la.

1. Clique em ![Botão Publicar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_publish_btn.png) no canto superior direito do editor.
2. Digite um nome para a conexão no campo Nome.
3. Selecione um projeto para salvar a conexão.
4. Clique ![Botão Publicar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_publish_btn.png)

Quando você edita uma conexão existente, ela permanece disponível para os usuários em seu estado publicado atual.

- Para salvar as atualizações de um rascunho, clique em ![Salvar ícone](/tableau/current/pt-br/server/pt-br/Img/ipa_Save_16px_medium.png).
- Para disponibilizar a conexão atualizada para os usuários, clique no ![Botão Publicar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_publish_btn.png)

### Definir permissões para que outras pessoas possam usar a conexão

Você publicou a conexão e está pronto para permitir que outras pessoas a usem. Para fazer isso, defina o recurso Conectar como Permitido.

1. Navegue até a conexão virtual.
2. Abra o menu Ações (...) e clique em Permissões.
3. Selecione a caixa sob o ícone Conectar para que a conexão seja permitida para todos os usuários.
    
    ![Recurso de conexão na caixa de seleção em Regras de permissões](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_connect_capability.png)
4. Clique em Salvar.

[Leia o tópico de publicação e permissões](https://help.tableau.com/current/server/pt-br/dm_vconn_publish_save.htm)

[Ler o tópico de conexões virtuais](https://help.tableau.com/current/server/pt-br/dm_vconn_create_conn.htm)

## Tarefas relacionadas

[Sobre o Editor de conexão virtual](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_editor.htm)

[Sobre políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_data_policy.htm)

[Criar e testar políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_create_data_policy.htm)

Não encontrou o que você precisa?

Fique online para ver [toda a ajuda do Tableau](https://www.tableau.com/pt-br/support/help)

<!-- document id=b1b44b2d6f9d98d9e1f0308238582a320c7cb3025613c280129b805f51c3ad8a url=/tableau/current/pt-br/server/distrib_lb.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar um balanceador de carga

É possível aumentar a confiabilidade do Tableau Server ao executar gateways em vários nós e configurar um balanceador de carga para distribuir as solicitações em todos eles. Diferentemente do processo de repositório, que pode ser ativo ou passivo, todos os processos de gateway são ativos. Caso um gateway em um cluster fique indisponível, o balanceador de carga para de enviar solicitações para ele. O algoritmo do balanceador de carga escolhido determina como os gateways encaminharão as solicitações do cliente.

- **Kerberos**: se for usar a autenticação do Kerberos, é necessário configurar o Tableau Server para o seu balanceador de carga antes de configurar o Tableau Server para o Kerberos. Para obter mais informações, consulte [Configurar o Kerberos](https://help.tableau.com/current/server/pt-br/config_kerberos.htm).
    
    A autenticação SSPI do Microsoft não é compatível com um balanceador de carga.
- **Balanceadores de carga testados**: os clusters do Tableau Server com vários gateways foram testados com balanceadores de carga Apache e F5.
    
    Se estiver usando um balanceador de carga Apache e criando exibições administrativas personalizadas, é necessário se conectar diretamente ao repositório do Tableau Server. Não é possível se conectar por meio do balanceador de carga.
- **URL do Tableau Server**: quando um balanceador de carga está na frente de um cluster do Tableau Server, a URL acessada pelos usuários do Tableau Server pertence ao balanceador de carga e não ao nó inicial do Tableau Server.
- **Endpoint do balanceador de carga único**: configure os balanceadores de carga para uma única URL de endpoint. Você não pode configurar diferentes hosts de endpoint para redirecionar a mesma implantação do Tableau Server. A URL externa única é definida no `gateway.public.host` ao configurar o Tableau Server, conforme descrito na [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).
- **Configurações de host confiável**: o computador que executa o balanceador de carga deve ser identificado para o Tableau Server como um host confiável, conforme descrito na [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).

## Configurar o Tableau Server para funcionar com um balanceador de carga

As configurações usadas para identificar um balanceador de carga para o Tableau Server são as mesmas usadas para identificar um Revertido servidor proxy. Se o cluster do Tableau Server exigir um servidor proxy e um balanceador de carga, ambos devem usar uma única URL externa definida em `gateway.public.host`, e todos os servidores proxy e balanceadores de carga devem ser especificados em `gateway.trusted` e `gateway.trusted_hosts`. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).

<!-- document id=48023e895be9e9ccd55d4eb8e799fdfa87c42ece9a508a951546bd85e2e9f7e6 url=/tableau/current/pt-br/server/data_stories_pop_up.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar um pop-up de Histórias com dados do Tableau ao painel

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Você pode colocar uma História com dados do Tableau em uma janela pop-up que permite aos usuários abrir uma história, lê-la e fechá-la quando terminarem. Essa é uma ótima maneira de economizar espaço sendo usado por painéis já estabelecidos ou de reduzir a confusão e informações em um painel.

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. Defina o contêiner como Flutuante clicando no menu e selecionando Flutuante.

> [!TIP]
> 
> **Dica:** outra maneira de definir o contêiner como Flutuante é manter pressionada a tecla shift enquanto arrasta o contêiner para o painel.

1. Navegue até a guia Layout na coluna da esquerda e defina a cor de fundo para branco.

![O painel Layout com o plano de fundo definido como 100% e branco.](/tableau/current/pt-br/server/pt-br/Img/data_stories_white_background.png)

1. Clique no menu associado ao seu contêiner flutuante para mostrar suas configurações e selecione Adicionar botão Mostrar/Ocultar. Isso cria um ícone "X" que permite mostrar ou ocultar sua história.

![Uma história de dados com um grande ícone X que permite que os usuários ocultem a história.](/tableau/current/pt-br/server/pt-br/Img/data_stories_x.png)

**Observação:** se sua história estiver selecionada, seu botão será parcialmente obscurecido pelas opções da barra lateral que fazem parte do objeto História com dados. Clique em qualquer lugar fora da história para revelar o botão.

1. Passe o mouse sobre o ícone "X" para mostrar instruções para abrir ou fechar a história. Neste exemplo, você está sendo solicitado a pressionar a tecla Alt ao mesmo tempo em que clica no ícone "X".

![Um objeto História com dados com um grande ícone X que permite aos usuários ocultar a história e uma dica de ferramenta que diz “Ocultar História com dados” (Alt+clique para ocultar)](/tableau/current/pt-br/server/pt-br/Img/data_stories_hide_story.png)

1. Recolha a história clicando no ícone "X" ao mesmo tempo em que pressiona a tecla indicada em seu prompt.

A história é recolhida, mas o menu permanece no painel para que o usuário possa expandir a história quando necessário. Você pode mover sua história flutuante e recolhível pelo painel conforme desejado.

<!-- document id=a8928a11c7829754c3a1b01f6e7f24646526a2597b9f52c883f210f9bafa5b59 url=/tableau/current/pt-br/server/startup.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar uma conta de administrador

A etapa final na ativação do Tableau Server é adicionar a conta inicial de administrador. O administrador terá acesso completo ao servidor, incluindo a capacidade de gerenciar usuários, grupos e projetos.

O servidor deve estar em execução ao criar o usuário administrativo inicial.

Se tiver configurado o repositório de identidades do Tableau Server para usar o LDAP ou Active Directory, o usuário administrativo inicial especificado deverá ser uma conta no diretório. O usuário administrativo inicial é geralmente diferente da conta do usuário no computador do Tableau Server usado para executar `tsm`.

No entanto, estas contas podem ser as mesmas configuradas para o repositório de identidades do Tableau Server para usar o Active Directory, e o usuário administrativo inicial é um membro do Administrador local grupo no computador do Tableau Server.

## Pré-requisitos

Antes de continuar com os procedimentos nesse tópico, conclua pré-requisitos a seguir, como descrito em [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm):

- [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm)
- [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm)
- [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm)

Ao concluir a inicialização do Tableau Server, o programa de instalação exibirá uma página para criar o administrador do Tableau Server.

- Se tiver configurado um armazenamento de identidades local, especifique um nome e senha que deseja usar.
- Caso tenha configurado um repositório de identidades do LDAP ou do Active Directory durante a instalação, será preciso especificar uma conta de usuário membro do diretório.
- O valor de `username` não pode incluir uma arroba (@), a menos que o sufixo do nome de usuário corresponda ao domínio primário do Tableau Server. Por exemplo, se o Tableau Server se conectar ao domínio "myco.com", o nome de usuário "user@example.com@myco.com" não pode ser usado.

Se a instalação for remota, é necessário fazer logon no TSM do computador físico onde o Tableau Server está sendo instalado, ou é possível acessar remotamente o computador e executar o comando [initialuser](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#initialu) do tabcmd de um shell.

Crie a conta administrativa inicial do Tableau Server.

- Se tiver configurado um armazenamento de identidades local, especifique um nome e senha que deseja usar.
- Caso tenha configurado um repositório de identidades do LDAP ou do Active Directory durante a instalação, será preciso especificar uma conta de usuário membro do diretório.
- O valor de `username` não pode incluir uma arroba (@), a menos que o sufixo do nome de usuário corresponda ao domínio primário do Tableau Server. Por exemplo, se o Tableau Server se conectar ao domínio "myco.com", o nome de usuário "user@example.com@myco.com" não pode ser usado.

Para criar o usuário inicial, execute o comando `tabcmd` a seguir:

`tabcmd initialuser --server http://localhost --username "<new-admin-username>"`

Por exemplo:

`tabcmd initialuser --server http://localhost --username "tableau-admin"`

Se você estiver executando o protocolo HTTP em uma porta diferente da 80, especifique a porta após o nome do host, por exemplo: `--server http://localhost:8080`.

Depois de executar o comando, o shell solicitará uma senha administrativa.

## Próximas etapas

Após criar a conta de administrador do Tableau Server, continue a instalação trabalhando por meio dos tópicos de configuração nas [Tarefas pós-instalação](https://help.tableau.com/current/server/pt-br/config_post_install.htm).

<!-- document id=6436bb829d921a746f3aeff69248e188a7f1821d090b5ff83fc2b9c154b72a3c url=/tableau/current/pt-br/server/custom_projectimage.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar uma imagem de projeto

Para ajudar a distinguir projetos que você gerencia no Tableau Server (e ajudar seus usuários a encontrá-los), você pode adicionar uma imagem que aparecerá na miniatura. Sua imagem deve atender aos seguintes requisitos:

- A imagem deve ser acessível usando o protocolo HTTPS. O diretório de rede compartilhado e os protocolos relacionados (UNC, SMB, AFP, NFS etc.) não são suportados. O protocolo HTTP para imagens de projeto não é compatível com o Google Chrome.
- Todos os usuários que acessam o projeto devem ter, no mínimo, permissão "somente leitura" na imagem de destino.
- A imagem deve ser um formato de internet comum: .jpg, png ou gif.

![Página de exploração personalizada com projetos classificados em TI, Desenvolvimento, Soluções para clientes e Estatísticas.](/tableau/current/pt-br/server/pt-br/Img/custom_projectimage.png)

## Definir uma imagem de projeto

1. Entre em um site no Tableau Server. Na lista de Projetos de nível superior aos quais tem acesso, selecione ou navegue até o projeto que deseja atualizar. Neste exemplo, adicionaremos uma imagem à pasta de projeto Estatísticas.
    
    Se você não tiver certeza de onde encontrar um projeto secundário, use a lista suspensa Explorar e selecione Todos os projetos.
2. Clique no ícone Detalhes (i), para abrir a caixa de diálogo Detalhes do projeto e clique em Editar.
    
    ![Página de detalhes do projeto mostrando o proprietário, a data de criação e opções para editar, alterar o proprietário e excluir o projeto.](/tableau/current/pt-br/server/pt-br/Img/custom_projectimage_2.png)
3. No campo Sobre, você pode inserir uma descrição do projeto (opcional), por exemplo, “Estatísticas globais e dos EUA”. No final da descrição do projeto, adicione a URL da sua imagem usando a sintaxe a seguir:
    
    `!http://www.example.com/image.png!`
    
    ![Página de detalhes do projeto mostrando estatísticas globais e dos EUA com opções para detalhes do projeto e edição.](/tableau/current/pt-br/server/pt-br/Img/custom_projectimage_3.png)
    
    Selecione Mostrar dicas de formatação para ver como é possível formatar o texto da descrição.
    
    **Observação:** as imagens inseridas nas descrições do projeto não podem ser redimensionadas ou posicionadas. O tamanho recomendado é 300 x 184 pixels. As imagens que não têm 300 x 184 pixels podem ser esticadas, reduzidas ou cortadas para se ajustarem à largura da miniatura. Além disso, elas devem ser adicionadas no final da descrição do projeto e estão incluídas em **!** (pontos de exclamação), caso contrário, não serão exibidas como miniatura.
4. Clique em Salvar.
    
    ![Página de exploração personalizada com projetos classificados em TI, Desenvolvimento, Soluções para clientes e Estatísticas.](/tableau/current/pt-br/server/pt-br/Img/custom_projectimage_4.png)

<!-- document id=864e744c63c8a6a562b5bdc52670e4aa0eeba84aa3cbdd259887b9e0393f7593 url=/tableau/current/pt-br/server/users_add_group.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar usuários a um grupo

Você pode organizar os usuários no Tableau Server em grupos para facilitar o gerenciamento de vários usuários. É possível criar grupos no servidor ou importá-los do Active Directory.

Se você estiver gerenciando usuários com um [Repositório de identidades externo](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm#external), como o Active Directory, adicione usuários a um grupo por meio do próprio armazenamento de identidade externo. Depois que os usuários são adicionados a um grupo no armazenamento de identidade externo, o Tableau Server é capaz de atualizá-los sincronizando o grupo de usuários no armazenamento de identidade externo com o grupo de usuários no Tableau Server.

Por exemplo, para manter a associação do grupo do Active Directory atualizada, recomendamos que você analise o seguinte:

- Os administradores de site podem sincronizar os grupos selecionados sob demanda em um site. Para obter mais informações, consulte [Sincronizar grupos do Active Directory em um site](https://help.tableau.com/current/server/pt-br/groups_create_adsync.htm).
- Os administradores de servidor podem sincronizar todos os grupos do Active Directory no servidor baseados em uma programação ou sob demanda. Para obter mais informações, consulte [Sincronizar todos os grupos do Active Directory no servidor](https://help.tableau.com/current/server/pt-br/groups_globalsync.htm).

**Observações:**

- No contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas. Quando os pools de identidades são configurados, você não pode adicionar pools a um pool de identidades.
- Adicionar pools a um [pool de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm) não é permitido. Somente usuários individuais podem ser adicionados a um pool de identidades.

Se você estiver gerenciando usuários com um [Armazenamento de identidades local](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm#local), use os procedimentos descritos a seguir para adicionar usuários a um grupo.

Para adicionar um usuário a um grupo, o grupo já deve existir.

## Adicionar usuários a um grupo (página Usuários)

1. Em um site, clique em **Usuários**.
2. Selecione os usuários que deseja adicionar a um grupo e depois clique em **Ações** > Associação a grupos.
    
    ![Uma lista de usuários com nomes de exibição, dois dos quais são selecionados para fazer parte de uma ação de grupo.](/tableau/current/pt-br/server/pt-br/Img/users7.png)
3. Na caixa de diálogo Membros do grupo, selecione os grupos e clique em **Salvar**.

## Adicionar usuários a um grupo (página Grupos)

1. Em um site, clique em **Grupos** e, em seguida, clique no nome do grupo.
    
    ![Uma lista de grupos com caixas de seleção para marcação.](/tableau/current/pt-br/server/pt-br/Img/groups_addusers_group.png)
2. Na página do grupo, clique em **Adicionar usuários**.
    
    ![Página do grupo mostrando o botão Adicionar usuários.](/tableau/current/pt-br/server/pt-br/Img/groups_addusers.png)
3. Na caixa de diálogo Adicionar usuários, selecione os usuários a serem adicionados e, em seguida, clique em **Adicionar usuários**.

<!-- document id=88d6f11c34f1ec936241f0f2368e497cf546f741a6c26820707ad12b7467bf23 url=/tableau/current/pt-br/server/sites_addusers.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar usuários a um site

Todas as pessoas que precisarem acessar o Tableau Server - seja para publicar, pesquisar editar o conteúdo ou administrar o site - devem ser adicionadas como um usuário. Os administradores têm as seguintes opções para adicionar usuários:

- Adicione uma conta de usuário local ou uma conta de usuário do Active Directory, como descrito adiante neste artigo.
    
    Também é possível adicionar usuários ao importar um grupo do Active Directory. Consulte [Criar grupos pelo Active Directory](https://help.tableau.com/current/server/pt-br/groups_create_ad.htm).
- [Importar usuários](https://help.tableau.com/current/server/pt-br/users_import.htm) por meio de um arquivo CSV criado usando as [Diretrizes do arquivo de importação CSV](https://help.tableau.com/current/server/pt-br/csvguidelines.htm).

## Acesso do administrador de site para o gerenciamento de usuários

Por padrão, os administradores de site podem adicionar e remover usuários em um site. Na página Configurações, os administradores de servidor podem revogar essa capacidade, para que apenas os administradores de servidor possam gerenciar os usuários do site.

> [!TIP]
> 
> **Dica**: os perfis de administrador concedem aos usuários não administradores recursos específicos relacionados ao gerenciamento de usuários e grupos sem aumentar o acesso ao conteúdo.

Um administrador de site pode editar uma conta de usuário local existente somente se o administrador tiver acesso a todos os sites dos quais o usuário é membro. Por exemplo, se Usuário1 for um membro dos sites A e B, um administrador do site B somente não poderá editar o nome completo do Usuário1 ou redefinir a senha.

**Observação:** ao usar a autenticação local, se um administrador de site puder adicionar e remover usuários, ele poderá saber se um nome de usuário está configurado como usuário em qualquer site do Tableau Server

## Adicionar usuários locais a um site

1. Entre no Tableau Server como um administrador e, se necessário, selecione o site.
2. Selecione Usuários. Na página Usuários, clique em Adicionar usuários e, em seguida, clique em Criar novo usuário.
    
    ![Uma caixa de diálogo com opções para adicionar novos usuários ou importar usuários de um arquivo CSV.](/tableau/current/pt-br/server/pt-br/Img/users1_local.png)
3. Insira um nome de usuário. Com a autenticação local, usar um endereço de e-mail para o nome de usuário é a melhor maneira de evitar conflitos de nome de usuário (por exemplo, _lrodriguez@example.com_ em vez de _lrodriguez_).
    
    ![Um formulário de criação de nova conta de usuário.](/tableau/current/pt-br/server/pt-br/Img/users2_local.png)
    
    Os nomes de usuário não diferenciam letras maiúsculas de minúsculas. Dentre os caracteres não permitidos nos nomes de usuário, estão inclusos o ponto e vírgula (;) e os dois pontos (:).
    
    Além disso, insira as informações nos campos a seguir:
    
    - Nome de exibição — digite um nome de exibição para o usuário (ex., _Laura Rodriguez_).
    - Senha — digite uma senha para o usuário.
    - Confirmar senha — digite a senha novamente.
    - E-mail — isto é opcional e pode ser adicionado mais tarde nas configurações de perfil do usuário.
4. Selecione uma função de site.
    
    Para obter definições das funções de site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).
5. Clique em Criar usuário.

## Adicionar os usuários do Active Directory a um site

Antes de adicionar usuários a um site, analise o [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm) para entender como vários domínios, a nomeação de domínio, o NetBIOS e o formato do nome de usuário do Active Directory influenciam o gerenciamento de usuário do Tableau.

1. Em um site, clique em Usuários, Adicionar usuários e Usuários do Active Directory.
    
    ![Uma caixa de diálogo para escolher como adicionar usuários ao site.](/tableau/current/pt-br/server/pt-br/Img/users_site_add_AD.png)
2. Insira um ou mais nomes de usuários (separados por ponto e vírgula).
    
    Por exemplo, _tdavis; jjohnson; hwilson_
    
    Se você estiver adicionando um usuário do mesmo domínio do Active Directory em que o servidor está sendo executado, basta digitar o Nome de usuário sem o domínio. O domínio do servidor será adotado.
    
    **Observação:** não insira o nome completo do usuário nesse campo, pois isso pode causar erros durante o processo de importação.
3. Selecione uma função de site.
    
    Para obter definições das funções de site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).
4. Clique em Importar usuários.

## Remover usuários locais

1. Entre no Tableau Server como administrador, selecione o site e abra a página Usuários.
2. Marque as caixas de seleção perto dos nomes dos usuários e, em seguida, no menu Ações selecione Remover.
    
    Se um usuário for membro apenas do site atual e não possui conteúdos, ele é removido do servidor.
    
    Se um usuário removido do site atual for membro de outros sites no servidor, seu status permanece inalterado nesses sites.

## Informações relacionadas

- Também é possível [Adicionar usuários ao Tableau Server](https://help.tableau.com/current/server/pt-br/users_add.htm), sem afiliação de site.
- Atualizar o Tableau Server para a versão 2018.1 ou posterior de uma versão anterior a 2018.1, sem ativar licenças baseadas em usuário, afeta os usuários aos quais a função de site Visualizador foi atribuída na versão de servidor antes da 2018.1.
    
    Para saber mais, consulte a seção“Licenças baseadas em usuário” em [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm#User-based) e consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

<!-- document id=9c3dd1613ee160635928df3557eaf29bd9df7760639a5b7c56f85b256d672f66 url=/tableau/current/pt-br/server/users_add.md -->

[Pular para o conteúdo principal](#main-content)

# Adicionar usuários ao Tableau Server

É possível adicionar usuários ao Tableau Server, um de cada vez ou em lotes. Adicione-os ao servidor como usuários não licenciados e, em seguida, adicione-os aos sites e atribua funções no site ao integrá-los ao Tableau Server. Ou você pode adicionar usuários aos sites e especificar suas funções no site ao mesmo tempo, sendo que nesse ponto eles estão prontos para fazer logon.

## Antes de começar

- Se o seu Tableau Server estiver configurado com um armazenamento de identidades externo Active Directory, consulte [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm) para compreender como o formato do nome de usuário de vários domínios, NetBIOS e Active Directory influenciam o gerenciamento de usuário do Tableau.
    
    **Observação:** no contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas.
- Verifique se você tem licenças de usuário de função suficientes e para sua base de usuários. Se tentar adicionar um usuário a uma função de site para a qual você não tem uma licença, então você receberá um erro.
- Para adicionar licenças de usuário à implantação do Tableau Server, visite o [Portal do cliente Tableau](http://customer.tableausoftware.com/) para adquirir licenças e as chaves do produto correspondentes. Depois de comprar licenças, consulte [Adicionar capacidade ao Tableau Server](https://help.tableau.com/current/server/pt-br/capacity_add.htm)para atualizar o servidor com as novas chaves.
- As etapas neste tópico descrevem como adicionar um usuário individual e atribuir a ele uma função de site. Para adicionar usuários em massa, consulte [Importar usuários](https://help.tableau.com/current/server/pt-br/users_import.htm).

## Quando adicionar usuários no servidor em vez de no site

Em um ambiente de site único, os administradores de servidor podem adicionar usuários na página Usuários.

![Opção para adicionar usuários no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/sites_add_user_ss_list.png)

Após a adição de um site ao Tableau Server, ele se torna um servidor de vários sites com a página Usuários de servidor (todos os usuários de servidor de cada site são exibidos) e com a página Usuários de site. Apenas administradores de servidor podem acessar a página Usuários do servidor e tanto os administradores de site quanto os administradores de servidor podem acessar a página Usuários de site.

![Usuários do site no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/sites_add_user_siteusers.png)

A página Usuários do servidor é o único local em que você pode atribuir usuários a vários sites, excluir usuários do servidor e, se o servidor estiver usando a autenticação local, redefinir senhas de usuários.

![Uma lista de usuários do Tableau Server com opção para adicionar usuários.](/tableau/current/pt-br/server/pt-br/Img/sites_addusers1.png)

## Adicionar um usuário ao servidor

Ao adicionar um usuário, o fluxo de trabalho muda dependendo se pelo menos um [pool de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm) está configurado para o Tableau Server.

### Nenhum pool de identidades configurado

Se nenhum pool de identidades estiver configurado, ou seja, o Tableau Server estiver usando apenas o provisionamento e a autenticação do usuário configurados durante a configuração do Tableau Server (também conhecido como pool inicial \[TSM configurado\]), siga as etapas descritas abaixo para adicionar um usuário.

1. No menu do site, selecione Gerenciar todos os sites > Usuários e clique em Adicionar usuários.
    
    Para adicionar um usuário a um site, selecione o site e acesse a página Usuários.
    
    ![Opção para adicionar usuários no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/sites_adduser_srv.png)
2. Execute um destes procedimentos:
    
    - Se o servidor estiver configurado para **autenticação local**, clique em Novo usuário e, em seguida, insira um nome de usuário. Com a autenticação local, a melhor maneira de evitar conflitos de nome de usuário é fornecer um endereço de e-mail para o nome de usuário. Por exemplo, _jsmith@example.com_ em vez de _jsmith_.
        
        Os nomes de usuário não diferenciam letras maiúsculas de minúsculas. Dentre os caracteres não permitidos nos nomes de usuário, estão inclusos o ponto e vírgula (;) e a vírgula (,).
    - Se o servidor estiver configurado para **Autenticação do Active Directory**, clique em Usuário do Active Directory. Se você estiver adicionando um usuário do mesmo domínio do Active Directory em que o Tableau Server está sendo executado, o domínio do servidor será utilizado e você poderá digitar o Nome de usuário sem o domínio.
        
        **Observação:** não insira o nome completo do usuário, pois isso pode causar erros durante o processo de importação.
3. Se o servidor estiver usando autenticação local, forneça o seguinte:
    
    - Nome de exibição — digite um nome de exibição para o usuário (ex., _John Smith_).
    - Senha — digite uma senha para o usuário.
    - Confirmar senha — digite a senha novamente.
    - E-mail — isto é opcional e pode ser adicionado mais tarde nas configurações de perfil do usuário.
    - Os usuários selecionados são Administradores de servidor: Especifique se o usuário deve ser um administrador do servidor.
    - Nome (associação a sites)/função de site: Se o usuário não for um administrador de servidor, você poderá designar um usuário a zero ou mais sites, incluindo uma função de site para cada site. Nessa ocasião, ainda não é necessário escolher a associação a sites e a função de site. Se você não especificar uma associação a sites e uma função no site para um novo usuário de servidor, esse usuário será adicionado somente como usuário de servidor, e sua função no site será Não licenciado. Para obter detalhes, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).
4. Clique em Criar.
    
    ![Adicione um novo usuário no formulário do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/sites_adduser_srv2.png)

### Um ou mais grupos de identidade configurados

Ao adicionar um usuário, se um ou mais grupos de identidades estiverem configurados, você deve primeiro selecionar um grupo de identidades ou o pool inicial (TSM configurado), que é o provisionamento e a autenticação do usuário configurados no TSM durante a configuração do Tableau Server.

1. No menu do site, selecione Gerenciar todos os sites > Usuários e clique em Adicionar usuários > Criar novo usuário.
    
    Para adicionar um usuário a um site, selecione o site e acesse a página Usuários.
    
    ![Opção para adicionar usuários no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/sites_adduser_srv_create_new_user.png)
2. Na caixa de diálogo Adicionar novos usuários, selecione o grupo de identidades ao qual deseja adicionar o usuário.
    
    ![Adicione novos usuários de um pool inicial.](/tableau/current/pt-br/server/pt-br/Img/sites_adduser_idpool_select.png)
3. Execute um destes procedimentos:
    
    - Se o grupo de identidades selecionado na etapa 2 estiver configurado para o armazenamento de identidade LOCAL e autenticação LOCAL:
        
        1. Na caixa de diálogo Novo usuário, na caixa de texto Nome de usuário, insira um nome de usuário. Com a autenticação local, a melhor maneira de evitar conflitos de nome de usuário é fornecer um endereço de e-mail para o nome de usuário. Por exemplo, _jsmith@example.com_ em vez de _jsmith_.
            
            Os nomes de usuário não diferenciam letras maiúsculas de minúsculas. Dentre os caracteres não permitidos nos nomes de usuário, estão inclusos o ponto e vírgula (;) e a vírgula (,).
            
            ![Caixa de diálogo Adicionar novo usuário.](/tableau/current/pt-br/server/pt-br/Img/sites_adduser_idpool_local_newuser.png)
        2. Insira as informações a seguir:
            
            - Nome de exibição — digite um nome de exibição para o usuário (ex., _John Smith_).
            - Senha — digite uma senha para o usuário.
            - Confirmar senha — digite a senha novamente.
            - E-mail (opcional) — isto é opcional e pode ser adicionado mais tarde nas configurações de perfil do usuário.
            - Os usuários selecionados são Administradores de servidor: Especifique se o usuário deve ser um administrador do servidor.
            - Função do Site: se o usuário não for um administrador de servidor, você poderá atribuir uma função de site. Nessa ocasião, ainda não é necessário escolher a função do site. Se você não especificar uma função no site para um novo usuário, esse usuário será adicionado somente como usuário de servidor, e sua função no site será Não licenciado. Para obter detalhes, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).
        3. Quando terminar, clique em Criar usuário.
    - Se o grupo de identidades selecionado na etapa 2 estiver configurado para LOCAL loja de identidade com autenticação OIDC:
        
        1. Na caixa de diálogo Novo usuário, na caixa de texto Nome de usuário, insira um nome de usuário. Com a autenticação local, a melhor maneira de evitar conflitos de nome de usuário é fornecer um endereço de e-mail para o nome de usuário. Por exemplo, _jsmith@example.com_ em vez de _jsmith_.
            
            Os nomes de usuário não diferenciam letras maiúsculas de minúsculas. Dentre os caracteres não permitidos nos nomes de usuário, estão inclusos o ponto e vírgula (;) e a vírgula (,).
            
            ![Caixa de diálogo Adicionar novo usuário.](/tableau/current/pt-br/server/pt-br/Img/sites_adduser_idpool_local_newuser_ad.png)
        2. Insira as informações a seguir:
            
            - Nome de exibição — digite um nome de exibição para o usuário (ex., _John Smith_).
            - Senha — digite uma senha para o usuário.
            - Identificador (opcional)— digite o identificador que deseja associar ao usuário. Os identificadores são para fins de correspondência de identidade. Para obter mais informações, veja [Nomes de usuário e identificadores no Tableau](https://help.tableau.com/current/server/pt-br/identity_pools.htm#usernames_identifiers).
            - E-mail (opcional) — isto é opcional e pode ser adicionado mais tarde nas configurações de perfil do usuário.
            - Site e Função do site — se o usuário não for um administrador de servidor, você poderá designar um usuário a zero ou mais sites, incluindo uma função de site para cada site. Nessa ocasião, ainda não é necessário escolher a associação a sites e a função de site. Se você não especificar uma associação a sites e uma função no site para um novo usuário de servidor, esse usuário será adicionado somente como usuário de servidor, e sua função no site será Não licenciado. Para obter detalhes, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).
            - Tornar os usuários selecionados Administradores do servidor— Especifique se o usuário deve ser um administrador do servidor.
        3. Quando terminar, clique em Criar usuário.
    - Se o grupo de identidades selecionado na etapa 2 estiver configurado para o armazenamento de identidade ACTIVE\_DIRECTORY ou LDAP:
        
        1. Digite o nome de usuário AD ou LDAP sem o domínio. Neste fluxo de trabalho, você está adicionando um usuário do mesmo domínio do Active Directory que Tableau Server foi configurado no TSM durante a configuração do Tableau Server. Portanto, o domínio do servidor será assumido e você poderá digitar o nome de usuário AD ou LDAP sem o domínio.
            
            **Observação:** não insira o nome completo do usuário, pois isso pode causar erros durante o processo de importação.
            
            ![Importar usuários do Active Directory.](/tableau/current/pt-br/server/pt-br/Img/sites_adduser_idpool_ad.png)
        2. Quando terminar, clique em Importar usuários.

<!-- document id=28c5c71a01e125ec78c50f6f5b2baa1ed946e30e7ede7c5324c8c484cbbc1cd2 url=/tableau/current/pt-br/server/dm_vconn_extract.md -->

[Pular para o conteúdo principal](#main-content)

# Agendar atualizações de extração para uma conexão virtual

Um dos benefícios das conexões virtuais é que você pode reutilizar a mesma extração várias vezes, reduzindo a proliferação de dados e removendo trabalhos de atualização de extração redundantes. Para garantir que os dados de extração sejam atualizados para qualquer conteúdo que use uma conexão virtual, você pode criar um agendamento de atualização de extração para as tabelas em sua conexão depois de publicar a conexão.

Você também pode agendar atualizações de extração de fontes de dados e pastas de trabalho que usam conexões virtuais. Veja [Agendar atualizações no Tableau Cloud](https://help.tableau.com/current/online/pt-br/schedule_add.htm) e [Atualizar dados em uma agenda](https://help.tableau.com/current/server/pt-br/schedule_add.htm) (TableauServer).

## Extrair tabelas

Consulte [Extrair dados da tabela](https://help.tableau.com/current/online/pt-br/dm_vconn_create_conn.htm#vconn_extract_table_data).

## Agendar atualizações de extração no Tableau Server

1. Navegue até a página de conexão virtual. (Na página Inicial ou Explorar, clique em Conexões virtuais no menu suspenso e selecione a conexão virtual.)
2. No topo da página, um título deve dizer Os dados são extraídos. Se ele diz Dados estão ativos, atualize seu navegador.
3. Selecione a guia Tarefas agendadas e clique em +Nova tarefa.
4. A caixa de diálogo Criar tarefa agendada é aberta. A caixa de diálogo Criar tarefa agendada parece diferente no Tableau Server e no Tableau Cloud. Se você estiver usando o Tableau Cloud, consulte [Agendar atualizações de extração para uma conexão virtual](https://help.tableau.com/current/online/pt-br/dm_vconn_extract.htm#schedule-extract-refreshes-on-tableau-cloud) na Ajuda do produto Tableau Cloud.
5. Selecione uma agenda no menu suspenso
6. Para casos em que várias tabelas usam extrações, selecione Dependente ou Independente. (No Tableau Server 2023.3 e versões anteriores, essas opções eram “Manter tabelas sincronizadas” e “Atualizar tabelas de forma independente”, mas o significado subjacente é o mesmo.)
    - Dependente significa que nenhuma das extrações será atualizada se uma ou mais tarefas de atualização de extração de tabelas falharem.
    - Independente significa que o sucesso ou a falha do trabalho de extração de uma tabela não afeta a atualização ou não das extrações de outras tabelas.
7. Selecione Tipo de atualização. Você pode configurar o tipo de extração no editor de conexão virtual. Para obter mais informações, consulte a seção Extrações incrementais de [Criar uma página de conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_create_conn.htm#incremental-extract). (No Tableau Server 2023.3 e versões anteriores, as conexões virtuais não oferecem suporte a extrações incrementais, portanto você não verá essas opções.)
    - Completo significa que as tarefas de atualização de extração completa serão executadas em todas as extrações na conexão virtual, independentemente de estarem configuradas para atualização de extração completa ou atualização de extração incremental.
    - Incremental significa que os trabalhos de atualização de extração incremental serão executados em todas as extrações incrementais na conexão virtual. Para todas as outras extrações na conexão virtual, serão executados trabalhos completos de atualização de extração.
8. Selecionar Adicionar ou editar tabelas para selecionar as tabelas que deseja atualizar.
9. Selecione OK.
10. Selecione Aplicar.
![](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_server_extract_sched.png)

## Limite de tempo para atualizações de extrações

Para garantir que as tarefas de atualização de longa duração não ocupem todos os recursos do sistema e não impeçam atualizações de outras extrações em seu site, as atualizações de extração para uma conexão virtual estão sujeitas a um limite de tempo de duas horas. Para obter mais informações sobre o limite de tempo para tarefas de atualização e sugestões para resolver esses erros, consulte [Limite de tempo para atualizações de extrações](https://help.tableau.com/current/online/pt-br/schedule_add.htm#timeout). Observação: a partir do Tableau Cloud de junho de 2024 e do Tableau Server 2024.2, as conexões virtuais oferecem suporte à atualização incremental para extrações de tabela. Antes dessa versão, as conexões virtuais davam suporte apenas a atualizações completas.

## Quem pode fazer isso

Para publicar uma conexão virtual ou definir permissões, você deve

- ter credenciais para o banco de dados ao qual a conexão virtual se conecta e
- ser um servidor ou administrador de site ou um Creator.

## Próxima etapa

Depois de agendar atualizações de extração para uma conexão virtual, você pode [Use uma conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_use.htm)

<!-- document id=9c2f2396d6e32fa87ee6f97fef2f1c5aedd2755e2ef2bbf9901a9a3b99b455d2 url=/tableau/current/pt-br/server/prep_conductor_schedule_flow_task.md -->

[Pular para o conteúdo principal](#main-content)

# Agendar tarefas de fluxo

**Observação**: os fluxos podem ser programados para serem executados no Tableau Cloud ou Tableau Server usando o Tableau Prep Conductor. O Prep Conductor está licenciado por meio do Data Management a cada implantação. Depois de adquirir e licenciar o Data Management, você deve habilitar o Prep Conductor.  
A partir da versão 2020.4.1, você não precisa mais da licença Data Management para publicar fluxos na Web. Como Creator, você também pode criar e editar fluxos diretamente em seu servidor. Para obter mais informações sobre os fluxos de criação na Web, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm).  

> [!IMPORTANT]
> 
> **Observação**: com a versão 2024.1, foram introduzidas alterações nos agendamentos de fluxo no Tableau Cloud. A guia Agendamentos no painel de navegação esquerdo foi removida e os usuários com permissões para agendar tarefas de fluxo agora podem criar agendamentos personalizados diretamente na guia Tarefas agendadas dos fluxos.

Para agendar fluxos para execução em um horário específico ou em uma base recorrente, crie tarefas agendadas. As tarefas agendadas dependem de agendas pré-configurados. As agendas são criadas pelo administrador do sistema. Para obter informações sobre como criar agendas no Tableau Server, consulte [Etapa 3: Criar agendas para tarefas de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_create_schedule_definitions.htm) na ajuda do Tableau Server. As tarefas agendadas são executadas com base na prioridade especificada na agenda. Apenas os administradores podem alterar uma prioridade de agenda. Para obter mais informações, consulte [Como os trabalhos do servidor agendados são priorizados](https://help.tableau.com/current/server/pt-br/task_prioritization.htm).

A partir da versão 2021.3, você pode vincular execuções de fluxo ao agendar tarefas para executar fluxos, um após o outro. Para obter mais informações, consulte [Agendar tarefas vinculadas](#linked_tasks) neste tópico.

A partir da versão 2022.1, você também pode executar tarefas vinculadas por meio da API REST usando os novos métodos de fluxo Consultar tarefas vinculadas , Consultar única tarefa vinculada e Executar tarefa vinculada agora. Para obter mais informações, consulte [Métodos de fluxo](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_flow.htm) na Ajuda da API REST do Tableau Server.

**Fluxos em execução que incluem parâmetros**

A partir da versão 2021.4, você pode incluir parâmetros de usuário em seus fluxos para torná-los mais dinâmicos. Quando o fluxo é executado, você é solicitado a inserir seus valores de parâmetro. Ao configurar fluxos em uma programação, você especifica valores de parâmetro nesse momento.

Você deve especificar os valores de parâmetro para quaisquer parâmetros necessários. Para parâmetros opcionais, você também pode inserir esses valores ou aceitar o valor atual (padrão) para o parâmetro. Para obter mais informações sobre a execução de fluxos com parâmetros, consulte [Executar fluxos em uma agenda](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm#run-flow-schedule) na ajuda do Tableau Prep.

A partir do Tableau Prep Builder e do Tableau Cloud versão 2023.2, você pode aplicar parâmetros de sistema de data ou hora aos nomes de saída de fluxo para tipos de saída de arquivo e de fonte de dados publicada. A hora de início é adicionada automaticamente ao nome da saída do fluxo.

**Observação**: seu administrador deve habilitar o servidor de parâmetros de fluxo e as configurações do site em seu servidor antes que você possa executar fluxos que incluem parâmetros no Tableau Server ou Tableau Cloud. Para obter mais informações, consulte **Criar e interagir com fluxos na Web** na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/web_author_flows.htm#flow-parameters) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/web_author_flows.htm#flow-parameters)

## Agendar uma tarefa de fluxo

1. Execute um destes procedimentos:
    - (versão 2022.1 e posterior) Na página Explorar, no modo de exibição de lista, no menu Ações, selecione Agendar fluxo > Tarefa única. Se você selecionar um fluxo na lista, também poderá usar o menu superior Ações.
        
        ![Agende um fluxo para uma única tarefa na guia Explorar.](/tableau/current/pt-br/server/pt-br/Img/prep_schedule_tasks_explore.jpg)
    - Na página Visão geral do fluxo, guia **Tarefas agendadas**, clique em **Nova tarefa** ou clique na lista suspensa e selecione Tarefa única.
        
        ![Agende um fluxo para uma única tarefa na guia Tarefas agendadas.](/tableau/current/pt-br/server/pt-br/Img/prep_schedule_tasks_overview.jpg)
        
        Se a etapa de saída não for atribuída a uma tarefa, você também poderá criar uma nova tarefa a partir da página Visão geral. Nessa página, no campo Agendas, clique em Criar nova tarefa.
2. Na caixa de diálogo **Nova tarefa**, na guia Tarefa única (Nova tarefa nas versões anteriores), selecione uma agenda na lista suspensa.
    
    ![Um menu suspenso de opções de agendamento para uma nova tarefa.](/tableau/current/pt-br/server/pt-br/Img/prep_server_newtask2.png)
3. Selecione uma das opções a seguir:
    
    - Incluir automaticamente todas as etapas de saída deste fluxo: (padrão) selecione esta opção para incluir todas as etapas de saída atuais e futuras para este fluxo na tarefa agendada. Conforme novas etapas de saída são adicionadas ao fluxo ao longo do tempo, elas são incluídas automaticamente no agendamento quando são executadas.
    - Selecionar as etapas de saída a serem incluídas nesta tarefa: marque esta opção e selecione manualmente as etapas de saída a serem incluídas nesta tarefa agendada. 
        
        Para incluir todas as etapas de saída na tarefa de fluxo, marque a caixa de seleção ao lado de Etapas de saída. Essa área não poderá ser editada se a opção Incluir automaticamente todas as etapas de saída para este fluxo for selecionada. Selecione o outro botão de opção para habilitar esta seção.
    
    ![Um formulário para criar uma tarefa que lista etapas de saída, nomes, locais e tipos de atualização.](/tableau/current/pt-br/server/pt-br/Img/prep_server_newtask.png)
4. (versão 2020.2.1 e posteriores) Selecione um Tipo de atualização. Para obter mais informações sobre essas configurações, consulte [Atualizar dados de fluxo usando atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm).
    
    **Observação**: a partir da versão 2020.2.1 e posteriores, se uma entrada estiver configurada para usar a atualização incremental e estiver associada a várias saídas, essas saídas deverão ser executadas juntas e deverão usar o mesmo tipo de atualização. Caso contrário, o fluxo falhará.
    
    - Atualização completa (padrão): atualize todos os dados e crie ou anexe dados à tabela com base na configuração de fluxo de saída.
    - Atualização incremental: atualize apenas as novas linhas e crie ou anexe dados à tabela com base na configuração de fluxo de saída. A opção de atualização incremental só estará disponível quando o fluxo estiver configurado para usar esse tipo de atualização.
        
        **Observação**: se nenhuma saída existente for encontrada, o Tableau Prep Conductor executa uma atualização completa em todas as saídas, independente da opção de execução que você selecionar. As execuções de fluxo subsequentes usarão o processo de atualização incremental e recuperarão e processarão apenas as novas linhas, a menos que os dados de configuração de atualização incremental não sejam perdidos ou a saída existente seja removida.
        
        ![Menu Nova tarefa com Atualização completa selecionada no menu suspenso Tipo de atualização. ](/tableau/current/pt-br/server/pt-br/Img/prep_incremental_server_task.png)
5. (opcional) Se você for o proprietário do fluxo, selecione Enviar e-mail quando terminar para notificar os usuários quando o fluxo for bem-sucedido. Para obter mais informações sobre como enviar notificações por email em execuções de fluxo, consulte [Notificar usuários sobre execuções de fluxo bem-sucedidas](https://help.tableau.com/current/server/pt-br/prep_conductor_subscribe_to_flow.htm).
6. (versão 2021.4 e posterior) Se os fluxos incluírem parâmetros, insira qualquer valor de parâmetro obrigatório ou opcional. Você deve inserir os valores necessários para que o fluxo seja executado.
    
    ![A caixa de diálogo Nova tarefa está aberta, e os Parâmetros obrigatórios estão sendo selecionados.](/tableau/current/pt-br/server/pt-br/Img/prep_parameters_schedule_task.png)
7. Clique em **Criar Tarefa** para criar a tarefa agendada.

## Agendar tarefas vinculadas

_Compatível com Tableau Server e Tableau Cloud, versão 2021.3.0 e posterior._

**Observação**: a partir da versão 2022.1, a funcionalidade de tarefas vinculadas é habilitada por padrão. Os administradores do servidor e do site podem desativar essa funcionalidade na página Configurações e nas agendas de fluxo na caixa de diálogo Agendas Nas versões anteriores, os administradores do servidor devem primeiro habilitar essa funcionalidade para usá-la e gerenciá-la. Para obter mais informações, consulte a [Etapa 2: Configurações de fluxo para o Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_server_site_settings.htm) e a [Etapa 3: Criar agendas para tarefas de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_create_schedule_definitions.htm) .

Use a opção Tarefas vinculadas para agendar até 20 fluxos para execução, um após o outro. Configure facilmente a lista de fluxo selecionando sua programação e, em seguida, selecione fluxos de downstream para executar na ordem que você escolher.

Os fluxos são executados na ordem especificada na lista. Use o menu para mover fluxos em sua lista ou adicionar novos fluxos upstream ou downstream à lista a qualquer momento.

Selecione as saídas que deseja incluir na execução do fluxo e defina as configurações para informar ao Tableau o que fazer com os fluxos restantes na agenda quando a execução do fluxo anterior falhar.

![A guia Tarefas vinculadas para agendar e automatizar execuções de fluxo do Tableau Prep.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks2.png)

1. Execute um destes procedimentos:
    - (versão 2022.1 e posterior) Na página Explorar, no modo de exibição de lista, no menu Ações, selecione Agendar fluxo > Tarefa vinculada. Se você selecionar vários fluxos na lista, também poderá usar o menu superior Ações.
        
        ![Agende um fluxo para uma única tarefa na guia Explorar.](/tableau/current/pt-br/server/pt-br/Img/prep_schedule_tasks_explore.jpg)
    - Na página Visão geral do fluxo, guia **Tarefas agendadas**, clique em **Nova tarefa** e selecione a guia Tarefa vinculada ou clique na lista suspensa e selecione Tarefa vinculada.
        
        ![Agende um fluxo para uma única tarefa na guia Tarefas agendadas.](/tableau/current/pt-br/server/pt-br/Img/prep_schedule_tasks_overview.jpg)
        
        Se a etapa de saída não for atribuída a uma tarefa, você também poderá criar uma nova tarefa a partir da página Visão geral. Nessa página, no campo Agendas, clique em Criar nova tarefa.
2. Na caixa de diálogo **Nova tarefa**, na guia Tarefas vinculadas, selecione uma agenda na lista suspensa. Apenas as agendas habilitadas para tarefas vinculadas são mostradas.
    
    ![Uma lista de possíveis agendas para tarefas.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_schedule.png)
3. Clique na lista suspensa Selecionar etapas de saída para selecionar as saídas de fluxo a serem executadas. Por padrão, todas as saídas de fluxo são incluídas. Para selecionar saídas específicas, desmarque a caixa de seleção Incluir todas as etapas de saída atuais e futuras para este fluxo.
    
    O fluxo em que a tarefa é iniciada é definido automaticamente como o primeiro fluxo a ser executado, mas você pode usar o menu para alterar a ordem de execução, após adicionar outros fluxos à sua lista.
    
    ![A guia Tarefas vinculadas mostra como você pode reordenar suas execuções de fluxo e definir seu tipo de atualização.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks3.png)
4. Selecione o tipo de atualização entre as seguintes opções:
    
    **Observação**: se uma entrada estiver configurada para usar a atualização incremental e estiver associada a várias saídas, essas saídas deverão ser executadas juntas e deverão usar o mesmo tipo de atualização. Caso contrário, o fluxo falhará.
    
    - Atualização completa (padrão): atualize todos os dados e crie ou anexe dados à tabela com base na configuração de fluxo de saída.
    - Atualização incremental: atualize apenas as novas linhas e crie ou anexe dados à tabela com base na configuração de fluxo de saída. A opção de atualização incremental só estará disponível quando o fluxo estiver configurado para usar esse tipo de atualização. Para obter mais informações, consulte [Atualizar dados de fluxo usando a atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm)
        
        **Observação**: se nenhuma saída existente for encontrada, o Tableau Prep Conductor executa uma atualização completa em todas as saídas, independente da opção de execução que você selecionar. As execuções de fluxo subsequentes usarão o processo de atualização incremental e recuperarão e processarão apenas as novas linhas, a menos que os dados de configuração de atualização incremental não sejam perdidos ou a saída existente seja removida.
5. (opcional) Se você for o proprietário do fluxo, selecione Enviar e-mail quando terminar para notificar os usuários quando o fluxo for bem-sucedido. Para obter mais informações sobre como enviar notificações por email em execuções de fluxo, consulte [Notificar usuários sobre execuções de fluxo bem-sucedidas](https://help.tableau.com/current/server/pt-br/prep_conductor_subscribe_to_flow.htm).
6. Adicione um aviso de qualidade de dados. Você pode ativar ou desativar o monitoramento de execução de fluxo no nível do fluxo para gerar um aviso de qualidade de dados que será exibido no fluxo se a execução do fluxo falhar. Para obter mais informações sobre como ativar avisos de qualidade de dados, consulte [Como ativar um aviso de qualidade de monitoramento](https://help.tableau.com/current/online/pt-br/dm_dqw.htm?source=productlink#how-to-turn-on-a-monitoring-quality-warning).
    
    - No menu Mais ações ![Ícone do menu Mais ações.](/tableau/current/pt-br/server/pt-br/Img/prep_moreoptions_icon.png "prep"), ao lado do nome do fluxo, selecione Rótulos de dados > Monitoramento de execução de fluxo.
    - Na caixa de diálogo Monitoramento de execução de fluxo, ative ou desative o monitoramento de execução de fluxo e, opcionalmente, insira uma mensagem de aviso para que os usuários dos dados estejam cientes dos problemas. A mensagem permanece até que o fluxo seja executado com sucesso.
    
    ![Menu para definir um aviso de qualidade de dados de fluxo.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_dqw_menu.png)
    
    ![Caixa de diálogo Monitoramento de execução de fluxo.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_dqw_flow_run_monitoring_page.png)
7. Defina suas opções de falha de fluxo restantes:
    - Parar as tarefas restantes: selecione esta opção para evitar que as tarefas downstream na lista sejam colocadas em fila para serem executadas.
    - Envie-me por e-mail: notificações por e-mail são enviadas automaticamente ao proprietário do fluxo e ao criador de tarefa vinculada quando o fluxo falha, é suspenso ou cancelado.
8. (versão 2021.4 e posterior) Se os fluxos incluírem parâmetros, insira qualquer valor de parâmetro obrigatório ou opcional. Você deve inserir os valores necessários para que o fluxo seja executado.
    
    ![Caixa de diálogo "Nova tarefa" com a guia "Tarefa vinculada" selecionada. A opção “Parâmetro obrigatório” está aberta.](/tableau/current/pt-br/server/pt-br/Img/prep_parameters_linked_tasks.png)
9. Clique no menu suspenso da 2ª tarefa para adicionar o próximo fluxo. Os fluxos que usam as saídas do fluxo anterior são mostrados automaticamente, ou clique em Exibir todos os fluxos para ver todos os fluxos disponíveis.
    
    Selecione um ou mais fluxos e clique em Adicionar ou clique em Adicionar próxima tarefa para adicionar mais tarefas de execução de fluxo à sua lista.
    
    ![A guia Tarefas vinculadas mostra como você pode adicionar mais fluxos às tarefas vinculadas.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks4.png)
    
    Se você não tiver permissão para executar o fluxo, deverá entrar em contato com o proprietário do fluxo para conceder permissões antes de adicionar o fluxo à sua lista.
    
    ![Uma janela de criação de tarefa vinculada com uma mensagem de erro informando que é necessária a permissão do proprietário do fluxo para executar o fluxo selecionado.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_no_permission.png)
10. Repita as etapas 3 a 5 para configurar suas opções de execução de fluxo.
    
    **Observação**: na versão 2021.4 e anterior, clique no ícone Editar![Ícone de lápis representando a função Editar.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_edit_icon.png) ao lado de seu novo fluxo para expandir o painel Opções.
11. (Opcional) Clique na lista suspensa ao lado de qualquer tarefa numerada para abrir o menu para alterar a ordem de suas tarefas de fluxo ou inserir novas tarefas entre as existentes.
    
    ![Um menu suspenso com opções para reordenar suas tarefas.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_move_menu.png)
12. Clique em **Criar tarefas** para criar as tarefas vinculadas agendadas.

### Quem pode fazer isso

- O administrador do servidor pode fazer isso em todos os sites no servidor. O administrador do site pode fazer isso nos sites aos quais têm acesso se as configurações do site que permitem que os usuários publiquem e agendem tarefas estiverem habilitadas.
- Nas tarefas vinculadas, o administrador do servidor pode fazer isso em todos os sites em que estão habilitadas as configurações do servidor para permitir que os usuários agendem tarefas vinculadas. O administrador do site pode fazer isso em sites aos quais eles têm acesso, se as configurações do site para permitir que os usuários agendem tarefas vinculadas estiverem habilitadas.
- Proprietários de fluxo e líderes de projeto com a função de site Creator podem criar tarefas de fluxo para fluxos ou projetos de sua propriedade, respectivamente.

Os administradores de site, os proprietários de fluxo e os líderes de projeto podem criar tarefas de fluxo para fluxos ou projetos que eles possuem respectivamente. Somente a função de site Creator e acima pode criar ou editar uma tarefa de fluxo.

Para obter mais informações, consulte [Definir funções de usuários no site](https://help.tableau.com/current/online/pt-br/users_site_roles.htm) e [Propriedade de conteúdo e permissões](https://help.tableau.com/current/online/pt-br/permissions.htm)

<!-- document id=83dcb1ae1ac0062d705f9135eb3d52bf401e1467baf199b6d8a4469be8692013 url=/tableau/current/pt-br/server/publish.md -->

[Pular para o conteúdo principal](#main-content)

# Agendas de atualização de extrações

Os autores do Tableau Desktop e os administradores de dados podem criar e publicar _extrações_ de dados. As extrações são cópias ou subconjuntos dos dados originais. Como as extrações são importadas para o processador de dados, as pastas de trabalho que se conectam às extrações normalmente são mais rápidas do que as que se conectam com dados em tempo real. As extrações também podem aumentar a funcionalidade.

## Antes de atualizar extrações

Quando uma atualização é executada em extrações criadas no Tableau 10.4 e versões anteriores (ou seja, em extrações .tde), elas são atualizadas automaticamente para o formato .hyper. Embora existam muitos benefícios em atualizar para uma extração .hyper, não será possível abir a extração em versões anteriores do Tableau Desktop. O Tableau 2024.2 é a última versão em que qualquer conteúdo baseado em .tde pode ser aberto. Para obter mais informações, consulte [Atualização de extrações para o formato .hyper](https://help.tableau.com/current/server/pt-br/extracting_upgrade.htm).

## Configurar agendas de atualização

Como administrador do servidor, você pode habilitar o agendamento para tarefas de atualização da extração e, em seguida, criar, alterar e reatribuir as agendas. As opções gerais de agendamento que você altera no servidor estão disponíveis como parte do processo de publicação, quando o usuário do Tableau Desktop publica uma extração.

As agendas criadas têm as seguintes opções:

Prioridade

A prioridade determina a ordem na qual as tarefas de atualização são executadas, onde 0 é a prioridade mais alta e 100 é a prioridade mais baixa. A prioridade é definida para 50 por padrão.

Modo de execução

O modo de execução indica aos processos do processador em segundo plano do Tableau Server se devem executar as atualizações em paralelo ou em série. As agendas executadas em paralelo usam todos os processos dos processadores em segundo plano disponíveis e as agendas em série executam somente em um processo do processador em segundo plano. No entanto, uma agenda pode conter uma ou mais tarefas de atualização e cada uma delas usará somente um processo do processador em segundo plano quando em modo paralelo ou serial. Isso significa que uma agenda em modo de execução paralelo usará todos os processos do processador em segundo plano **disponíveis** para executar as tarefas contidas nele em paralelo, mas cada tarefa usará somente um processo do processador em segundo plano. Uma agenda serial usa somente um processo do processador em segundo plano para executar uma tarefa de cada vez.

Por padrão, o modo de execução é definido como paralelo, para que as tarefas de atualização sejam concluídas tão rápido quanto possível. Para uma agenda muito grande que evite que outras agendas sejam executadas, uma opção é definir o modo de execução para serial (e definir uma menor prioridade).

Frequência

É possível definir a frequência para por hora, por dia, por semana ou por mês.

Para obter informações, consulte [Criar ou modificar uma agenda](https://help.tableau.com/current/server/pt-br/schedule_manage_create.htm).

## Atualizar manualmente as extrações

No ambiente da Web do Tableau Server, os administradores de site e servidor podem executar atualizações de extração sob demanda na página Agendas:

- Selecione a agenda e clique em Ações > Executar agora.

você também pode atualizar extrações pela linha de comando usando o comando tabcmd `refreshextracts`. Para obter mais informações, consulte [Comandos tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm).

## Atualizar extrações do Tableau Desktop

Os usuários do Tableau Desktop podem atualizar extrações que publicam e possuem. Eles podem fazer isso das seguintes maneiras:

- No momento da publicação: quando um autor publica uma pasta de trabalho ou fonte de dados que usa uma extração, esse autor pode adicioná-la a uma agenda de atualização do servidor. A atualização pode ser completa ou incremental.
    
    As atualizações incrementais referenciam uma coluna na extração que tem um tipo de dados de data, data/hora ou inteiro; como um carimbo de data e hora. O Tableau usa essa coluna para identificar novas linhas que precisam ser adicionadas à extração. Para obter mais informações, consulte [Atualizar extrações](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#extracting_refresh.htm) e [Agendar atualizações de extração ao publicar uma pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#publish_workbooks_schedules.htm) na Ajuda do Tableau.
- **Interface de usuário:** No Tableau Desktop, você pode usar os comandos de Atualizar na origem, Adicionar dados do arquivo e Adicionar dados da fonte de dados para carregar uma adição ou atualizar uma extração no Tableau Server. Um usuário pode querer fazer isso se o Tableau Server não tiver credenciais suficientes para acessar os dados subjacentes. Para obter mais informações, consulte [Atualizar extrações no Tableau Server](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#extracting_push.htm) na Ajuda do Tableau.
- **Utilitário de linha de comando da Extração de dados:** O utilitário Extração de Dados do Tableau é instalado com o Tableau Desktop. Você pode usá-lo para anexar ou atualizar uma extração publicada. Para obter mais informações, consulte [Utilitário de linha de comando da Extração de Dados do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#extracting_TDE.htm) na Ajuda do Tableau.

## Outros artigos nesta seção

<!-- document id=5f1eab0d6875d79096b3543380acbae0a8b91ecefe675b9235384940b35e1e50 url=/tableau/current/pt-br/server/server_process_admin-agent.md -->

[Pular para o conteúdo principal](#main-content)

# Agente de administração do Tableau Server

O agente administração monitora o Serviço de coordenação para alterações na configuração ou topologia e fornece novas configurações a cada serviço (configuração) ou implanta novos serviços e remove os antigos (topologia) O Agente de administração também verifica cada um dos serviços de status e relata ao Serviço de coordenação. Esse processo será configurado automaticamente em cada nó do cluster durante a instalação, não é necessária ou possível uma configuração.

O agente de administração também pode ser chamado de _agente de administração do TSM._

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Administration Agent</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Administration Agent não é visível na página Status. Use a CLI do TSM para exibir o status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Administration Agent são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>tabadminagent</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando um processo do Agente de administração falha? Todos os outros processos do Tableau Server em execução no mesmo nó serão exibidos como “indisponíveis” na página de status do TSM. O Tableau Server continuará funcionando conforme esperado, mas não será possível fazer alterações de configuração/topologia no cluster. Os processos do agente de administração com falha serão reiniciados automaticamente, contanto que o próprio computador esteja íntegro. Se o agente de administração não iniciar no nó, você poderá tentar iniciar o serviço manualmente executando o seguinte comando:

`sc start tabadminagent_0`

<!-- document id=482408ba4b41e0030ef6f1a56c138497b58d095f6b4e4087daa798e4d4b8c15f url=/tableau/current/pt-br/server/ipa_vconn_start.md -->

[Pular para o conteúdo principal](#main-content)

# Ajuda rápida

[Conectar a dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_connect.htm)

[Sobre o Editor de conexão virtual](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_editor.htm)

[Adicionar tabelas à conexão](https://help.tableau.com/current/server/pt-br/ipa_vconn_add_tables.htm)

[Sobre políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_data_policy.htm)

[Criar e testar políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_create_data_policy.htm)

Não encontrou o que você precisa?

Fique online para ver [toda a ajuda do Tableau](https://www.tableau.com/pt-br/support/help)

<!-- document id=4b46150cc48381985155dc11ba08cad85d2ffa57f199225f007e47802214c5d4 url=/tableau/current/pt-br/server/perf_tuning.md -->

[Pular para o conteúdo principal](#main-content)

# Ajuste de desempenho

Esta seção descreve como usar os dados de desempenho coletados para identificar formas de melhorar o desempenho do Tableau Server. Como dois ambientes de servidor nunca são idênticos, não podemos oferecer regras rápidas e diretas para ajustar o desempenho do servidor. No entanto, é possível chegar a conclusões sobre o desempenho de padrões nos dados coletados.

Por exemplo, há aumentos recorrentes? Algum dos padrões observados nas exibições administrativas corresponde a padrões similares no Monitor de Desempenho do Windows? Observar esses tipos de padrões pode orientá-lo em testes e ajustes incrementais.

A maior parte do ajuste de desempenho do Tableau Server resume-se a duas abordagens gerais:

- **[Otimizar para o tráfego de usuários](https://help.tableau.com/current/server/pt-br/perf_optimize_user_traffic.htm):** isso ajusta o servidor para responder às solicitações de usuários e para mostrar as exibições com rapidez.
- **[Otimizar para extrações](https://help.tableau.com/current/server/pt-br/perf_optimize_extracts.htm):** isso ajusta o servidor para atualizar extrações de fontes de dados publicadas. Se a sua organização tiver uma grande quantidade de dados e esses precisarem ser atualizados o mais rápido possível, talvez queira otimizar para atualizações de extração.
- **[Otimizar para ambientes - com muitas consultas de extração](https://help.tableau.com/current/server/pt-br/perf_tuning_long_queries_for_extracts.htm):** esta é uma configuração de servidor especializada para otimizar para desempenho de consulta de pastas de trabalho que usam extrações como sua fonte de dados.

A renderização de exibições e a atualização de extrações são responsáveis pela maior parte da carga no servidor, portanto você deve otimizar para a tarefa que gera mais interesse na sua organização.

Como uma prática recomendada, otimize suas pastas de trabalho para desempenho. Para obter mais informações e recursos sobre como otimizar as pastas de trabalho, consulte [Otimizar o desempenho da pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/performance_tips.htm).

## Outros artigos nesta seção

<!-- document id=049c76c947b15b3793d31c78007afeaa83326f2b8a3b096a807716c71b46a714 url=/tableau/current/pt-br/server/openid_auth_changing_idp.md -->

[Pular para o conteúdo principal](#main-content)

# Alteração de IdPs no Tableau Server para o OpenID Connect

Este tópico fornece informações sobre a alteração de um provedor de identidade (IdP), caso você tenha configurado o Tableau Server para usar o OpenID Connect.

## Alteração de provedores

Você pode decidir alterar o IdP que o Tableau Server está configurado para usar. Para fazer isso, siga o mesmo procedimento usado para configurar o primeiro IdP: estabeleça uma conta, obtenha a ID do cliente e o segredo, configure o Tableau Server com essas informações e forneça ao IdP a URL de redirecionamento para o Tableau Server. Para obter mais informações, consulte [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm).

### Redefinir identificadores de usuário

No entanto, também é necessário realizar uma etapa adicional: apague qualquer identificador de usuário (valores ou reivindicações `sub`) que já foi associado aos usuários do Tableau Server. O novo IdP terá diferentes valores `sub` para cada usuário e é necessário apagar os existentes para que o Tableau Server possa armazenar um novo valor `sub` quando o usuário fizer logon com o novo IdP.

Para limpar os valores sub para usuários, use o comando `tabcmd reset_openid_sub`. É possível redefinir (isto é, apagar) os valores `sub` para um usuário individual, como no exemplo a seguir:

`tabcmd reset_openid_sub --target-username jsmith`

Você também pode apagar o valor sub para todos os usuários com este comando:

`tabcmd reset_openid_sub --all`

**Observação:** limpar identificadores de usuário para membros de um [pool de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm) não é aceito.

<!-- document id=15c5a5c1e7a7c678e34ee57a5a0974e5b9857f0a06144124f3e8f2dd34fb959b url=/tableau/current/pt-br/server/rmt-postgres-perf-tuning.md -->

[Pular para o conteúdo principal](#main-content)

# Alterações de hardware para Servidor RMT - Sintonização do banco de dados PostgreSQL

Às vezes, você pode precisar atualizar ou alterar o hardware na máquina em que o Servidor RMT está instalado. Sempre que fizer alguma alteração de hardware, especificamente para memória e CPU, seria benéfico sintonizar o banco de dados PostgreSQL subjacente que está instalado com o Servidor RMT.

Ao instalar o Servidor RMT, o programa de configuração define o banco de dados PostgreSQL para otimizar o uso do hardware disponível na máquina. As otimizações de exemplo incluem o gerenciamento do tamanho do buffer e do cache. Alterar o hardware da máquina pode afetar o desempenho.

Use as etapas a seguir para garantir que a configuração seja atualizada para refletir a alteração no hardware:

1. Abra um prompt de comando PowerShell. Execute como administrador.
2. Navegue até o diretório de pré-requisitos na Resource Monitoring Tool do Tableau. Por padrão, está localizado em: _C:\\Program Files\\Tableau Resource Monitoring Tool\\prerequisites_.
    
    `cd C:\Program Files\Tableau Resource Monitoring Tool\master\`
3. Execute o seguinte comando:
    
    `.\tunePostgres.psl`
    
    Você deve ver uma mensagem que indica que o arquivo de configuração foi atualizado. Isso também afirmará que é necessária uma reinicialização do serviço PostgreSQL para que as alterações entrem em vigor. As atualizações no arquivo de configuração não exigem tempo de inatividade do servidor.
4. Reinicie o banco dados PostgreSQL. Você pode fazer isso durante o horário de inatividade, quando o Resource Monitoring Tool não está em uso.

<!-- document id=56ef834b48f2f947fdfdd56bae35480718a886b18c8e193a451e4247fbe7fbdf url=/tableau/current/pt-br/server/server_process_hot_topo.md -->

[Pular para o conteúdo principal](#main-content)

# Alterações de topologia dinâmica do Tableau Server

Com o lançamento do TSM, o Tableau Server também introduziu a capacidade de fazer alterações ou atualizações de determinadas topologias sem reiniciar o servidor. Elas são conhecidas como alterações de topologia dinâmica e são realizadas nos processos do Processador em segundo plano e do VizQL Server.

Você pode aumentar ou diminuir o número de instâncias de processador em segundo plano ou VizQL Server em um nó sem exigir uma reinicialização do Tableau Server, se o nó já tiver pelo menos uma instância do processo em execução. Você deve alterar somente o número de instâncias do Processador em segundo plano ou do VizQL Server. Se você também adicionar ou remover outro processo, ou se estiver adicionando a primeira instância do Processador em segundo plano ou VizQL Server a um nó ou removendo a última instância de qualquer um do nó, o Tableau Server exigirá uma reinicialização.

### Alterações de configuração dinâmicas

A partir da versão 2020.2.0 do Tableau Server, algumas alterações de configuração também podem ser feitas dinamicamente usando as chaves de configuração. Faça alterações de topologia dinâmica ao mesmo tempo em que faz alterações dinâmicas de configuração, sem precisar reiniciar o Tableau Server. Para obter mais informações sobre mudanças de configuração dinâmica, consulte [Notas de versão do Tableau Server](https://help.tableau.com/current/server/pt-br/whatsnew_server.htm#dynamic-config-20-2) em O que há de novo e alterado na versão 2020.2 no Tableau Server.

## Cenários de exemplo

Para entender melhor por que isso pode ser útil, considere estes exemplos:

- Processador em segundo plano: no final de um trimestre de vendas, sua equipe de vendas está usando o Tableau Server para monitorar seus números. Os painéis que dependem de extrações exibem aos vendedores seu desempenho. Qualquer atraso nas atualizações de extração significa que sua equipe não está vendo os números mais atualizados. Você pode adicionar novos processadores em segundo plano a qualquer nó que já tenha pelo menos um processador em segundo plano ou VizQL Server, além de aumentar a taxa de transferência das atualizações de extração, ajudando a garantir que os números sejam atualizados à medida que sua equipe termina o trimestre. Posteriormente, após o envio trimestral, você pode reduzir novamente as instâncias do processador em segundo plano para retornar o Tableau Server para sua configuração original.
- VizQL Server: da mesma forma, se o Tableau Server não puder monitorar as atualizações de exibição, você poderá adicionar rapidamente novas instâncias do VizQL Server a qualquer nó que já tenha pelo menos uma instância do VizQL Server ou processador em segundo plano configurada. No exemplo do processador em segundo plano acima, talvez você queira remover temporariamente os VizQL Servers para acomodar novos processadores em segundo plano e adicioná-los novamente antes que os seus usuários possam usá-los.

### Como fazer alterações de topologia dinâmica

Você pode fazer alterações de topologia dinâmica usando a interface do usuário da Web do TSM ou na linha de comando. Para usar a interface do usuário da Web, entre no TSM usando um navegador e, na guia Configuração, atualize o número de instâncias do processador em segundo plano ou do VizQL Server para o nó que está atualizando. Para obter detalhes, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm). Para fazer suas alterações usando a CLI do TSM, em um prompt de comando, execute o comando tsm topology set-process. Para obter detalhes, consulte [Alteração do número de processos em um nó](https://help.tableau.com/current/server/pt-br/config_nodes.htm#ChangeProcessCount).

### Impacto das alterações de topologia dinâmica

Ao fazer alterações de topologia dinâmica que removem instâncias existentes do VizQL Server ou do processador em segundo plano, essas instâncias serão removidas imediatamente. Esteja ciente dos possíveis impactos aos usuários e às tarefas em execução no momento:

- Processador em segundo plano: todas as tarefas em execução no momento serão encerradas. A lógica de repetição normal do Tableau Server reiniciará essas tarefas, usando outra instância do processador em segundo plano.
- VizQL Server: todas as sessões ativas no momento serão encerradas. Os usuários poderão ver uma mensagem de erro. A atualização do navegador deve corrigir o erro.

### Práticas recomendadas

O Tableau recomenda testar qualquer alteração de topologia dinâmica que planeja usar, antes de implementá-las no ambiente de produção. Isso o ajudará a entender completamente os possíveis impactos para os usuários e para as atualizações agendadas e as inscrições, além de permitir que você aproveite com mais eficiência a flexibilidade oferecida pela topologia dinâmica.

### Automatização das alterações de topologia dinâmica

Você pode automatizar as alterações de topologia dinâmica. Por exemplo, se você tiver a maior parte das atualizações de extração agendadas para noite e souber que o servidor tem capacidade extra porque os usuários não estão conectados, você pode usar um script ou outra ferramenta automatizada de implantação para adicionar instâncias do processador em segundo plano quando elas podem ser usadas com mais eficiência e removê-las antes do início do dia de trabalho.

Para obter automaticamente o status dos processos, use o comando `[tsm status](https://help.tableau.com/current/server/pt-br/cli_status_tsm.htm) -v` e analise a saída no script. Como alternativa, você pode usar a REST API do TSM para obter o status do servidor. A API está atualmente em alfa. Para obter mais detalhes, consulte [Obter status do servidor](https://help.tableau.com/v0.0/api/tsm_api/pt-br/docs/tsm-reference.htm#status).

Um script de amostra para definir quatro instâncias do processador em segundo plano no node2 pode ser semelhante ao seguinte:

echo Adding/Removing Processes
tsm topology set-process -pr backgrounder -n node2 -c 4
tsm pending-changes apply
echo Done!

## Informações adicionais

[Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm)

<!-- document id=8cf642a585ffec8a584e14e7ea1dcf7208b7cc5d77751326c50a73453046ca06 url=/tableau/current/pt-br/server/rmt-tableau-server-topology-changes.md -->

[Pular para o conteúdo principal](#main-content)

# Alterações de topologia do Tableau Server

Este artigo vai ajudá-lo a entender o que você precisa fazer ao realizar certas alterações de topologia no Tableau Server. As alterações incluem: adicionar ou remover um nó, adicionar ou remover um processo de um nó e alterar o número de processos em um nó.

## Adição de um nó

Ao adicionar um novo nó ao Tableau Server, você deve instalar o agente nele. Para obter mais informações sobre a instalação do Agente no cluster do Tableau Server, consulte [Instalar o Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-installation.htm#installing-agent-on-multinode-tableau-server). Até instalar o agente, as informações sobre esse nó não serão incluídas nos relatórios.

## Remoção de um nó

Ao remover um nó existente do cluster do Tableau Server, você deve atualizar o ambiente no Servidor RMT.

**Use as etapas a seguir para atualizar o ambiente:**

1. Faça logon na interface da Web do Servidor RMT.
2. No menu **Admin,** escolha **Ambientes**. Selecione o ambiente que deve refletir esta alteração.
    
    ![Menu Administrador da Resource Monitoring Tool do Tableau.](/tableau/current/pt-br/server/pt-br/Img/rmt-admin-environment-menu.png)
3. Escolha **Editar ambiente**. Isso abre as informações mais detalhadas sobre o ambiente.
    
    ![Botões para criar e editar ambientes.](/tableau/current/pt-br/server/pt-br/Img/rmt-env-edit.png)
4. Na guia **Servidores**, selecione o nó que foi removido do Tableau Server e escolha **Excluir**.
    
    Observação: o nome do host deve corresponder ao nome ou ao endereço IP do nó.
    
    ![O painel de controle Servidores dentro do ambiente Demo Dot.](/tableau/current/pt-br/server/pt-br/Img/rmt-remove-node.png)

## Novo registro de um Agente

Pode haver situações em que você pode querer registrar novamente um Agente. Um desses casos de uso pode ser quando você quiser apontar um nó ou todo o Tableau Cluster para um ambiente diferente. Outro exemplo pode ser se você tiver que refazer a imagem de um nó do Tableau Server e precisar instalar e registrar novamente o Agente. Use as seguintes instruções para registrar novamente o Agente.

Existem duas maneiras de registrar novamente o Agente, dependendo se você deseja preservar dados históricos de monitoramento:

1. Na interface da Web do Servidor RMT, navegue até **Administrador** -> **Ambientes**. Selecione o ambiente. Na guia **Servidores**, clique para editar o nó em que deseja registrar novamente o Agente. Isso traz à tona a página **Detalhes do servidor**. Selecione **Cancelar o registro** que remove o registro do Agente para este nó neste ambiente. Agora você pode executar o comando rmtadmin register e registrar o Agente neste nó. Este método preserva o histórico de monitoramento coletado neste nó.
2. Na interface da Web do Servidor RMT, navegue até **Administrador** -> **Ambientes**. Selecione o ambiente. Na guia **Servidores**, clique em excluir para remover completamente o registro do Agente para este nó neste ambiente. Isso também remove dados históricos de monitoramento que foram coletados neste nó. Use essa ação para cenários onde você não se importa em perder a história. Por exemplo, se você planeja apontar esse nó para um novo ambiente, pode ser aceitável remover os dados históricos e começar de novo.

**Observação:** na interface da Web do Servidor RMT, cada nó do Tableau Server é chamado de **Servidor**. Todo o Tableau Server constitui um ambiente. Para obter mais informações, consulte [Conceitos](https://help.tableau.com/current/server/pt-br/rmt-concepts.htm).

## Quem pode fazer isso

Para fazer alterações de topologia, você deve ser um administrador do Tableau Server e do Resource Monitoring Tool.

<!-- document id=0e03b03cf2c38abe2c2720565c14a787d2ce4be72aecc3075893da0102cfc373 url=/tableau/current/pt-br/server/runas_acct.md -->

[Pular para o conteúdo principal](#main-content)

# Alterar a conta de serviço Run As

Dependendo do ambiente e dos requisitos de acesso aos dados, talvez você queira ou precise alterar a conta de serviço Run As. Há dois cenários principais em que a conta de serviço Run As é alterada:

- Ao substituir a conta local Run As padrão (Serviço de rede) por uma conta de domínio. Se estiver operando em um ambiente no qual a maioria de suas fontes de dados é autenticada no contexto do Active Directory (segurança integrada do Windows NT), então será necessário configurar a conta de serviço Run As para usar uma conta de domínio, não a conta local (Serviço de rede).
- Ao alterar uma conta de serviço Run As de domínio existente para uma conta diferente.

Este tópico descreve ambos os cenários e como atualizar a senha da conta de serviço Run As.

A conta que você usa para serviço Run As não deve ser membro da conta Administradores locais ou Administradores de domínio. Em vez disso, recomendamos o uso de uma conta de usuário de domínio que não seja um administrador da conta de serviço Run As. Usar uma conta de domínio que não seja membro desses grupos de administradores é uma boa prática de segurança e pode ajudar a evitar o acesso a certas fontes de dados e pastas. Para obter informações sobre as práticas recomendadas ao criar uma conta de serviço Run As, consulte [Criação da conta de serviço Run As](#best) .

**Observação:** começando no Tableau Server versão 2023.3.x, se a conta de serviço Run As estiver configurada para usar uma conta de domínio, os administradores também deverão configurar uma lista de permissões de servidor para acesso a arquivos usando o comando `tsm configuration set`. A lista de permissões limita o acesso à fonte de dados baseada em arquivo a caminhos de diretório locais ou compartilhados especificados. Para obter mais informações e etapas para configurar uma lista de permissões de servidor, consulte [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm#11-configure-a-server-allowlist-for-filebased-data-sources).

## Substituição da conta local Run As padrão (Serviço de rede) por uma conta de domínio

Se você for substituir a conta Serviço de rede padrão por uma conta de domínio, é recomendável usar uma conta dedicada para a conta de serviço Run As. Siga estas etapas:

1. Crie a conta de serviço Run As no Active Directory
2. Configurar o Tableau Server para usar a conta de serviço Run As

### Criação da conta de serviço Run As

Siga as práticas recomendadas:

- É importante entender como a conta de serviço Run As acessa os dados em nome dos usuários da organização. Em alguns casos, os usuários podem acessar inadvertidamente dados para os quais suas contas de usuário não estão explicitamente autorizadas. Antes de criar uma conta de serviço Run As, analise o [Acesso aos dados com a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_access.htm).
- Crie uma conta dedicada no Active Directory para a conta de serviço Run As do Tableau Server. Em outras palavras, não use uma conta existente. Ao usar uma conta dedicada, você terá certeza de que os recursos de dados permitidos para o Tableau Server estarão acessíveis apenas pela conta de serviço Run As do Tableau Server.
- A conta de serviço Run As é usada para consultar a inscrição de usuários e grupos no Active Directory. Por padrão, a conta NetworkServices e os usuários de domínio padrão têm permissão para consultar o Active Directory. Não limite a leitura ou consulte permissões para a conta de serviço Run As.
- Não use uma conta com qualquer tipo de permissões administrativas de domínio. Especificamente, quando você criar uma conta no Active Directory, crie uma conta no Grupo de usuários de domínio. Não adicione a conta criada a qualquer grupo de segurança do Active Directory que eleve sem necessidade as permissões da conta.
- Conceda permissões das fontes de dados em seu diretório para essa única conta. A conta que você usará para a conta de serviço Run As precisa apenas de acesso de Leitura às fontes de dados e aos compartilhamentos de rede apropriados.
- Se os usuários na empresa forem autenticados com smartcards, desabilite a opção de logon do smartcard para a conta de serviço Run As.
- Caso tenha instalado o Tableau Server em uma unidade que não seja a do sistema, será necessário configurar a unidade do sistema para conceder permissões adicionais à conta de serviço Run As. A unidade do sistema é a unidade na qual o Windows está instalado. Por exemplo, se tiver instalado o Windows na unidade C:/, então C:/ é a sua unidade de sistema. Se você instalar o Tableau Server em qualquer outra unidade (D:/, E:/ etc), será necessário configurar permissões para a conta de serviço Run As na unidade do sistema. Consulte [](https://help.tableau.com/current/server/pt-br/runas_confirm.htm)[Configurações exigidas da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_confirm.htm) para obter mais informações.

### Configuração da conta de serviço Run As no Tableau Server

Depois de criar a conta de serviço Run As no Active Directory, configure o Tableau Server para usá-la.

Use a interface na Web do TSM para configurar a conta de serviço Run As pela primeira vez.

**Para configurar a conta de serviço Run As**

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Segurança, em seguida clique na guia Conta de serviço Run As.
3. Selecione Conta de usuário em seguida insira o nome de usuário e a senha da conta de serviço. Especifique o nome de domínio como `domain\account`, onde o nome de domínio é o nome NetBIOS do domínio onde o usuário reside:
    
    ![Janela de configuração Conta de serviço Run As do Tableau Server Manager com a Conta de usuário selecionada.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-runas.PNG)
4. Clique em Salvar para verificar o nome de usuário e senha.
5. Ao terminar, clique em Alterações pendentes, em seguida clique em Aplicar alterações e reiniciar..

Depois de atualizar a conta de serviço Run As, o Tableau Server configurará automaticamente as permissões no computador local para a conta inserida.

## Alteração de uma conta de serviço Run As de domínio existente para uma conta diferente

Para alterar uma conta de serviço Run As de domínio existente para uma conta diferente, aplique permissões para essa nova conta. Para aplicar permissões à sua conta de serviço Run As, primeiro é necessário redefinir as permissões, aplicando-as à conta de Serviço de rede padrão.

Antes de começar, verifique se a nova conta que será usada para a conta de serviço Run As está em conformidade com as práticas recomendadas, mencionadas anteriormente na seção [Criação da conta de serviço Run As](#best).

Este procedimento exige a reinicialização dos serviços do Tableau Server duas vezes, portanto realize este procedimento fora do horário comercial.

Usar a interface na Web do TSM

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Segurança, em seguida clique na guia Conta de serviço Run As.
3. Em Conta de usuário, selecione NT Authority\\NetworkService.
4. Clique em Salvar.
5. Ao terminar, clique em Alterações pendentes, em seguida clique em Aplicar alterações e reiniciar..
6. Depois que o servidor reiniciar, abra o TSM e navegue até a guia Conta de serviço Run As.
7. Selecione Conta de usuário em seguida insira o nome de usuário e a senha da conta de serviço. Especifique o nome de domínio como `domain\account`, onde o nome de domínio é o nome NetBIOS do domínio onde o usuário reside:
    
    ![Janela de configuração Conta de serviço Run As do Tableau Server Manager com a Conta de usuário selecionada.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-runas.PNG)
8. Clique em Salvar para verificar o nome de usuário e senha.
9. Ao terminar, clique em Alterações pendentes, em seguida clique em Aplicar alterações e reiniciar..
10. Revogue as permissões para a conta anterior. Consulte [Revogar permissões da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_change.htm).

Usar a CLI do TSM

1. Redefinir a conta de serviço Run As para o Serviço de rede. Execute o seguinte comando:
    
    `tsm configuration set -k service.runas.username -v "NT AUTHORITY\NetworkService"`
2. Execute o seguinte comando para salvar esta alteração e reiniciar:
    
    `tsm pending-changes apply`
3. Configure a conta de serviço Run As para a nova conta. Execute os seguintes comandos:
    
    `tsm configuration set -k service.runas.username -v <domain\username>`
    
    `tsm configuration set -k service.runas.password -v "<password>"`
    
    Coloque a senha entre aspas para garantir que os caracteres especiais na cadeia de caracteres sejam processados corretamente. Para exibir como a senha será armazenada, execute o comando a seguir:
    
    `tsm pending-changes list`
    
    A senha será validada com o Active Directory. Se válida, a senha será codificada e salva. O TSM não relatará sucesso ou falha.
4. Execute o seguinte comando para salvar e reiniciar:
    
    `tsm pending-changes apply`
    
    Solução de problemas:

- Verifique se o servidor foi iniciado. Se estiver em um estado degradado, talvez você tenha inserido uma senha incorreta. Exiba a senha armazenada executando o comando `configuration get`. Este comando vai descriptografar e exibir a senha no shell. Execute o seguinte comando:
    
    `tsm configuration get -k service.runas.password`
    
    Se a senha anterior estiver exibida, você não inseriu uma senha válida.
- Insira a senha correta (consulte a Etapa 3) e execute o seguinte comando para salvar e reiniciar:
    
    `tsm pending-changes apply`

6. Revogue as permissões para a conta anterior. Consulte [Revogar permissões da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_change.htm).

## Atualização da senha da conta de serviço Run As

Se a senha da conta de serviço Run As foi atualizada no Active Directory, é necessário atualizá-la para o Tableau Server. A senha da conta de serviço Run As é codificada e armazenada no Tableau Server. Para obter mais informações, consulte [Gerenciar segredos do servidor](https://help.tableau.com/current/server/pt-br/security_secret_storage.htm).

Se estiver executando o Tableau Server em uma implementação distribuída, precisará atualizar a senha somente com o TSM no nó inicial do cluster. O TSM distribuirá automaticamente essa configuração para todos os nós.

Usar a interface na Web do TSM

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Segurança, em seguida clique na guia Conta de serviço Run As.
3. Em Conta de usuário, insira a senha da conta de serviço.
4. Clique em Salvar para verificar a senha.
5. Ao terminar, clique em Alterações pendentes, em seguida clique em Aplicar alterações e reiniciar..

Usar a CLI do TSM

1. Defina a nova senha. Execute o seguinte comando:
    
    `tsm configuration set -k service.runas.password -v "<password>"`
    
    Coloque a senha entre aspas para garantir que os caracteres especiais na cadeia de caracteres sejam processados corretamente. Para validar que o escape dos caracteres especiais foi realizado corretamente, execute o seguinte comando para exibir como a senha será armazenada:
    
    `tsm pending-changes list`
    
    A senha será validada com o Active Directory. Se válida, a senha será codificada e salva. O TSM não relatará sucesso ou falha.
2. Execute o seguinte comando para salvar e reiniciar:
    
    `tsm pending-changes apply`
    
    Solução de problemas:

- Verifique se o servidor foi iniciado. Se estiver em um estado degradado, talvez você tenha inserido uma senha incorreta. Exiba a senha armazenada executando o comando `configuration get`. Este comando vai descriptografar e exibir a senha no shell. Execute o seguinte comando:
    
    `tsm configuration get -k service.runas.password`
    
    Se a senha anterior estiver exibida, você não inseriu uma senha válida.
- Insira a senha correta (consulte a Etapa 1) e execute o seguinte comando para salvar e reiniciar:
    
    `tsm pending-changes apply`

### Solução de problemas: atualizar a senha no console de Serviços da Microsoft

Em alguns casos, pode ocorrer falhas de serviço após atualizar a senha da conta de serviço Run As. Se isso acontecer, talvez seja necessário atualizar manualmente a senha do serviço do Tableau Server Services Manager. Atualize a senha no console de gerenciamento de Serviços da Microsoft.

Se você estiver executando o Tableau Server em uma implantação distribuída, execute o seguinte procedimento em cada nó do cluster.

1. Interrompa o Tableau Server.
    
    - Para usar a CLI do TSM, execute os comandos a seguir:
        
        `tsm stop`
    - Para usar a interface do usuário da Web do TSM, no canto superior direito da página, clique na lista suspensa ao lado do status, em seguida, em Interromper o Tableau Server:
        
        ![Menu suspenso com a opção Iniciar Tableau Server selecionada.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-stop-server.png)
2. Abra o snap-in do MMC dos Serviços no computador com Windows no qual o Tableau Server está em execução.
3. Clique duas vezes no serviço do Tableau Server Services Manager para abrir a página de propriedades.
4. Na página Propriedades do Tableau Server Services Manager, clique na guia Fazer logon e insira a senha da conta de serviço.
5. Clique em Aplicar, em seguida, em OK.
6. Reinicie o serviço do Tableau Server Services Manager clicando com o botão direito do mouse no nome do serviço, em seguida, em Reiniciar.
7. Inicie o Tableau Server.
    
    - Para usar a CLI do TSM, execute os comandos a seguir:
        
        `tsm start`
    - Para usar a interface do usuário da Web do TSM, no canto superior direito da página, clique na lista suspensa ao lado do status, em seguida, em Iniciar o Tableau Server.

## Tarefas relacionadas

A conta de serviço Run As é essencial para diversas operações no Tableau Server, especificamente aquelas que envolvem o acesso a dados remotos. Para evitar erros de acesso, revise as tarefas aqui e siga os links daquelas que se aplicam à sua situação.

- Se estiver executando o Tableau Server em uma organização com vários domínios do Active Directory, consulte [](https://help.tableau.com/current/server/pt-br/runas_domain.htm)[Requisitos de confiança de domínio para implantações do Active Directory](https://help.tableau.com/current/server/pt-br/runas_domain.htm).
- Para habilitar o logon único do Kerberos, é necessária a configuração adicional relacionada a conta de serviço Run As. Para habilitar o logon único do Kerberos com o Tableau Server, consulte [](https://help.tableau.com/current/server/pt-br/kerberos.htm)[Kerberos](https://help.tableau.com/current/server/pt-br/kerberos.htm).
- A habilitação da representação precisa de configuração adicional relacionada a conta de serviço Run As. Para implantar e habilitar a representação com Microsoft SQL Server, consulte [](https://help.tableau.com/current/server/pt-br/impers_SQL.htm)[Representação com credenciais SQL inseridas](https://help.tableau.com/current/server/pt-br/impers_SQL.htm).
- Caso tenha instalado o Tableau Server em uma unidade que não seja a do sistema, será necessário definir algumas permissões manualmente para a conta de serviço Run As. Consulte [](https://help.tableau.com/current/server/pt-br/runas_confirm.htm)[Configurações exigidas da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_confirm.htm) para obter mais informações.
- Se você alterou a conta de serviço Run As, recomendamos revogar as permissões da conta anterior. Consulte [Revogar permissões da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_change.htm).
- Se a sua empresa usa uma solução de proxy de encaminhamento, então pode ser necessário reconfigurar as configurações LAN locais no Tableau Server com a conta de serviço Run As. Consulte [Configurar um servidor proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/proxy.htm#Configur2) para obter mais informações. Neste cenário, a conta de serviço Run As também deve ser configurada temporariamente como a conta de logon do Controlador administrativo do Tableau Server para operações da chave do produto. Consulte [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm)
- Se você estiver usando a Resource Monitoring Tool em sua empresa, a conta de serviço Run As pode ser usada para autenticar e coletar informações de Hardware. Ao atualizar uma conta Run As, confirme a conectividade entre o RMT e o Tableau Server nas configurações do ambiente RMT:
    1. Entre no RMT como administrador.
    2. Navegue até a página Ambientes (Admin > Ambientes).
    3. Clique em Editar para o ambiente que foi atualizado.
    4. Na lista Servidores, confirme se cada servidor mostra o Serviço do agente como conectado. Passe o mouse sobre o status Conectado para ver um carimbo de data/hora da última mensagem de pulsação recebida.

<!-- document id=7027330dd7a5107701035a7e32e18f322f8aacb7b136a34e4d15ff0f4a868b79 url=/tableau/current/pt-br/server/logs_debug_level.md -->

[Pular para o conteúdo principal](#main-content)

# Alterar níveis de registro

Por padrão, o Tableau Services Manager (TSM) e o Tableau Server registram eventos no nível **Informações**. Você poderá alterar isso se precisar obter mais informações (se estiver trabalhando com o Suporte do Tableau, por exemplo).

Como prática recomendada, você não deve aumentar os níveis de registro, exceto em resolução de problemas, conforme instruído pelo Suporte. Você só deve definir um nível de registro como depuração ao investigar um problema específico. A alteração dos níveis de registro pode ter esses impactos:

- O aumento do nível de registro para `debug` ou `trace` aumenta o volume de informações registradas e pode ter um impacto significativo sobre o desempenho. Reproduza o problema e redefina o nível de registro como informações.
- Definir o nível de registro para `warn` or `error` pode reduzir tanto a quantidade de informações, de modo que não sejam úteis para o suporte do Tableau.

**Observação:** ao fazer login no`DEBUG` nível, as informações completas do ambiente são coletadas quando o Tableau é iniciado. Isso significa que, se você tiver informações confidenciais em uma variável de ambiente, elas poderão ser incluídas em um registro. Registrar no nível `INFO` padrão apenas reúne informações de ambiente seguro.

## Níveis de registro

Os níveis de registro a seguir são listados na ordem do volume de informações registradas crescente:

- off (desativado)
- fatal (fatal)
- error (erro)
- warn (aviso)
- info (the default) (informações (o padrão))
- debug (depuração)
- trace (rastreamento)

## Alterar níveis de registro

Defina os níveis de registro para processo do TSM e do Tableau Server usando as chaves de configuração **tsm configuration set**. A chave usada depende de qual componente do TSM ou do Tableau Server cujo nível de registro você deseja alterar.

### Configuração dinâmica de nível de registro

Na versão 2020.2, introduzimos a configuração dinâmica. A capacidade foi expandida em versões subsequentes. Se você estiver alterando apenas os níveis de registro de um ou mais desses componentes e estiver executando a versão apropriada do Tableau, poderá alterar os níveis de registro sem reiniciar o Tableau Server.

Esses níveis de registro são configuráveis dinamicamente, começando com estas versões:

- 2020.2 - serviços tsm (`tsm.log.level` ) e serviços de aplicativos de controle (`tsm.controllerapp.log.level` ).
- 2020.3 - processador em segundo plano (`backgrounder.log.level` ), controlador de cluster (`clustercontroller.log.level` ), servidor de dados (`dataserver.log.level` ), armazenamento de arquivos (`filestore.log.level` ), propriedades da fonte de dados (`tdsservice.log.level` ) e servidor VizQL (`vizqlserver.log.level` ).
- 2020.4 - adiciona contêiner de microsserviço interativo (`tomcatcontainer.log.level`) e servidor de aplicativo (`vizportal.log.level`).

## Chaves de configuração para alterar os níveis de registro

Esta tabela inclui chaves configuráveis dinamicamente e aquelas que não são configuráveis dinamicamente.

<table class="table--plain"><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Chave de configuração</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Local dos logs afetados</b><p>(o caminho começa com <code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>)</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tsm.log.level</code></p><p>Altera os níveis de registro do TSM para:&nbsp;activationservice, appzookeeper, backuprestore, clientfileservice, databasemaintenance, licenseservice, siteimportexport, tabadminagent, tabadmincontroller, tabsvc</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\&lt;service&gt;\&lt;service&gt;_node&lt;n&gt;-&lt;instance&gt;.log</code></p><p>exemplo:<code> \clientfileservice\clientservice_node1-0.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tsm.controlapp.log.level</code></p><p>Altera os níveis de registro do TSM para: aplicativos de controle</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\&lt;service&gt;\control_&lt;service&gt;_node&lt;n&gt;-&lt;instance&gt;.log</code></p><p>exemplos:<code> \clientfileservice\control_clientservice_node1-0.log</code></p><p><code> \filestore\control_filestore_node1-0.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code> &lt;process&gt;.native_api.log.level</code></p><p>Os nomes de processo válidos são processadores em segundo plano, vizportal, vizqlserver e dataserver</p><p><strong>Observação:</strong> esses não são dinamicamente configuráveis.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\vizqlserver\*.txt</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>backgrounder.log.level</code></p><p>Altera os níveis de registro para: processador em segundo plano</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\backgrounder\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>clustercontroller.log.level</code></p><p>Altera os níveis de registro para: controlador de cluster</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\clustercontroller\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>dataserver.log.level</code></p><p>Altera os níveis de registro para: servidor de dados</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\dataserver\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>filestore.log.level</code></p><p>Altera os níveis de registro para: armazenamento de arquivos</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\filestore\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>gateway.log.level</code></p><p>Altera os níveis de registro para: processos de controle de gateway</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\gateway\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>gateway.httpd.loglevel</code></p><p><strong>Observação:</strong>&nbsp;adicionado na versão 2021.3.0</p><p>Altera os níveis de registro para: gateway</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\gateway\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>hyper.log.level</code></p><p>Altera os níveis de registro para: Hyper</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\hyper\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tdsservice.log.level</code></p><p>Altera os níveis de registro para: serviço de propriedades de origem de dados</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\tdsservice\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tomcatcontainer.log.level</code></p><p>Altera os níveis de registro de microsserviços em: contêiner de microsserviço interativo e contêiner de microsserviço não interativo</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\tomcatcontainer\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>vizportal.log.level</code></p><p>Altera os níveis de registro para: servidor de aplicativos</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\vizportal\*.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>vizqlserver.log.level</code></p><p>Altera os níveis de registro para: servidor VizQL</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>\vizqlserver\*.log</code></p></td></tr></tbody></table>

Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

Se você estiver apenas alterando os níveis de registro dinamicamente configuráveis, não precisará parar ou iniciar o servidor (para obter mais informações, consulte [Configuração dinâmica de nível de registro](#DynamicLogLevel) acima). Se estiver alterando outros níveis de registro, é possível interromper o Tableau Server antes de alterar os níveis de registro e reiniciá-lo depois. Se este for o caso, você receberá uma solicitação.

Em uma instalação de vários nós do Tableau Server, defina os níveis de registro no nó inicial.

Para alterar o nível de registro:

1. (Opcional para níveis de registro configuráveis dinamicamente na versão 2020.2.0 e posterior) Interrompa o Tableau Server abrindo um prompt de comando e digitando:
    
    `tsm stop`
2. Defina o nível de registro digitando `tsm configuration set -k <config.key> -v <config_value>`
    
    em que `<config.key>` é uma das chaves na tabela acima e registro `<config_value>` é um nível de registro válido.
    
    Exemplos:
    
    - tsm configuration set -k backgrounder.native\_api.log.level -v debug
    - tsm configuration set -k tsm.log.level -v debug
    - tsm configuration set -k tsm.controlapp.log.level -v debug
3. Aplique as alterações pendentes por meio do comando `tsm pending-changes apply`.
4. (Opcional, somente se o servidor estiver interrompido) Inicie o Tableau Server executando o seguinte comando:
    
    `tsm start`

## Redefinir níveis de registro

Após reproduzir o problema e coletar informações sobre ele, redefina os níveis de registro para evitar impactos persistentes no desempenho e uso adicional de espaço em disco.

No Tableau Server 2026.2 e posterior, você pode exibir e redefinir todos os níveis de log de serviço para seus valores padrão com os comandos `tsm maintenance log-levels`. Para obter mais informações, consulte [tsm maintenance](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm).

- Para ver todas as configurações de nível de log antes de redefinir, execute:
    
    `tsm maintenance log-levels list`
- Para definir todas as configurações de nível de log com seus valores padrão, execute:
    
    `tsm maintenance log-levels reset`

Para obter versões anteriores do Tableau Server ou para redefinir chaves específicas, execute o comando `tsm configuration set` com a opção `-d`.

Exemplos:

- tsm configuration set -k backgrounder.native\_api.log.level -d
- tsm configuration set -k tsm.log.level -d

Você deve aplicar alterações pendentes após redefinir os níveis de log. Se você estiver redefinindo os níveis de registro dos processos do Tableau Server, verifique a lista de alterações pendentes. Se a atualização exigir uma reinicialização, interrompa o servidor, aplique as alterações e inicie-a novamente.

<!-- document id=2fc7092f727ede3e1412477623809ed689917d3e9a57b9dd562fde7239cee093 url=/tableau/current/pt-br/server/config_oauth_sfdc.md -->

[Pular para o conteúdo principal](#main-content)

# Alterar o OAuth do Salesforce.com para credenciais salvas

Por padrão, o conector Salesforce.com usa chaves gerenciadas para tokens do OAuth gerados para o Tableau Server pelo provedor de dados e compartilhados por todos os usuários no mesmo site. Você pode configurar o Tableau Server com a ID do cliente salvo e o segredo do cliente. Há três cenários em que você pode querer fazer isso:

- Conector do Salesforce — Se você estiver usando o conector do Salesforce, você pode configurar o Tableau Server com uma ID e segredo do cliente OAuth, para que o conector possa usar credenciais salvas.
- **Gravar no CRM Analytics —** Se você estiver gravando dados de fluxo do Tableau Prep no Salesforce CRM Analytics (versão 2022.3 e posterior), configure o Tableau Server com uma ID de cliente OAuth e um segredo, para que o fluxo possa ser executado no Tableau Server usando credenciais salvas.
- Einstein Discovery — Se você está integrando as extensões do Einstein Discovery com o Tableau Server, você precisa fazer essa ID do cliente e a configuração secreta. A capacidade de integrar Einstein Discovery e Tableau Server foi adicionada na versão 2021.1.0. Para obter mais informações, consulte [Configurar a Integração de Einstein Discovery](https://help.tableau.com/current/server/pt-br/config_einstein_extensions.htm)

Este tópico descreve como configurar as fontes de dados do Salesforce.com e as extensões do Einstein Discovery para as credenciais salvas do OAuth. Execute essas etapas para cada instância do Tableau Server.

Para obter mais informações sobre as chaves gerenciadas e as credenciais salvas, consulte [Conexões OAuth](https://help.tableau.com/current/server/pt-br/protected_auth.htm).

**Observações:** 

- O conector do Salesforce requer chave gerenciada (padrão), OAuth em todo o servidor ou OAuth específico do site.
- Para usar credenciais salvas para um site, o OAuth em todo o servidor deve ser configurado primeiro.
- O OAuth em todo o servidor pode ser usado se o OAuth em todo o site estiver configurado.
- Se estiver usando OAuth específico do site, cada site deve ser configurado individualmente.
- Para oferecer suporte a prompts de conexão em tempo real, conexões de edição e criação na Web, converta as chaves gerenciadas em credenciais salvas para evitar erros.

### Resumo das etapas

Configure o OAuth seguindo estas etapas gerais:

1. Configure a integração de aplicativo criando um aplicativo cliente externo (recomendado) ou um aplicativo conectado (obsoleto) no Salesforce.
2. Use as informações que você obteve na etapa 1 para configurar o Tableau Server.
3. (Opcional) Configure o OAuth específico do site.

## Etapa 1: configurar a integração de aplicativo no Salesforce

Para habilitar a integração do Tableau com o Salesforce, habilite primeiro a integração de aplicativo no Salesforce. É altamente recomendável usar aplicativos clientes externos. Você pode usar aplicativos conectados do Salesforce se eles estiverem disponíveis.

### Aplicativo cliente externo do Salesforce (recomendado)

A partir da Spring '26, os aplicativos clientes externos do Salesforce são a próxima geração de aplicativos conectados e são recomendados para habilitar a integração do Tableau com o Salesforce.

1. Entre com sua conta de desenvolvedor de Salesforce.com, clique no nome do usuário no canto superior direito da página e selecione Configuração.
2. No painel de navegação à esquerda, em Aplicativos, selecione Gerenciador de aplicativos.
3. No Gerenciador de aplicativos do Lightning Experience, clique em Novo aplicativo cliente externo.
4. No Gerenciador de aplicativos clientes externos, configure a chave do cliente, o segredo do cliente e a URL de retorno de chamada necessários na Etapa 2.
5. Clique em Criar.
6. Depois de criar o aplicativo, selecione a guia Configurações.
7. Marque a Chave do consumidor e o Segredo nas configurações do OAuth.

Quando concluir, acesse **Etapa 2: configurar o Tableau Server para Salesforce.com OAuth**.

Para obter mais informações sobre a criação de um aplicativo cliente externo, consulte [Criar um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&type=5) na Ajuda do Salesforce.

### Aplicativo conectado do Salesforce (obsoleto)

> [!WARNING]
> 
> **Importante:** A partir da versão Spring '26 do Salesforce, a criação de aplicativos conectados é restrita. Você pode continuar a usar aplicativos conectados existentes durante e após a Spring '26, mas o uso de aplicativos clientes externos é altamente recomendado. Para obter mais informações, consulte o seguinte na Ajuda do Salesforce: [Novos aplicativos conectados não podem mais ser criados na Spring '26](https://help.salesforce.com/s/articleView?id=005228017), [Criar um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&type=5) e [Migração de aplicativo conectado para aplicativo cliente externo.](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_to_external_client_app_migration.htm&type=5)

**Observação:**este procedimento documenta o processo no Salesforce Lightning. Se você estiver usando a interface tradicional, a navegação poderá ser diferente, mas a configuração será a mesma.

1. Entre usando sua conta de desenvolvedor de Salesforce.com, clique no nome de usuário no canto superior direito e selecione Configuração.
2. No painel de navegação esquerdo, em Aplicativos, pesquise por “Aplicativos clientes externos” e, em seguida, selecione Configurações de aplicativo cliente externo.
3. Clique em Novo aplicativo conectado.
4. Em Informações Básicas nomeie o aplicativo, toque no campo api para que ele preencha automaticamente no formato correto e insira um e-mail de contato para o aplicativo.
5. Na seção API \[Ativar configurações do OAuth\], selecione Ativar configurações de OAuth.
6. Nas novas configurações de OAuth exibidas, para URL de retorno da chamada, digite o nome de domínio totalmente qualificado do servidor usando o protocolo `https` e acrescente o seguinte texto à URL: `auth/add_oauth_token`.
    
    Por exemplo:
    
    `https://www.your_tableau_server.com/auth/add_oauth_token`
7. Mova os seguintes itens de Escopos de OAuth disponíveis para Escopos de OAuth selecionados:
    
    - Acesse o serviço de URL de identidade (id, perfil, e-mail, endereço, telefone)
    - Gerenciar dados do usuário por meio de APIs (api)
    - Execute solicitações a qualquer momento (refresh\_token, acesso offline)
8. Clique em Salvar.

Depois que você salva o aplicativo, o Salesforce preenche a seção da API com as seguintes IDs que você usará para configurar o Tableau Server:

- Chave do cliente
- Segredo do cliente
- URL de retorno da chamada

## Etapa 2: configurar Tableau Server para Salesforce.com OAuth

Depois de habilitar a integração do Tableau com o Salesforce e obter a chave do cliente, o segredo do cliente e a URL de retorno, você pode configurar conexões de dados e saídas do Tableau Server para Salesforce e o Einstein Discovery.

1. No computador com o Tableau Server, em um prompt de comando, execute os comandos a seguir.
    
    `tsm configuration set -k oauth.salesforce.client_id -v <your_customer_key>`
    
    `tsm configuration set -k oauth.salesforce.client_secret -v <your_customer_secret>`
    
    `tsm configuration set -k oauth.salesforce.redirect_uri -v <your_redirect_URL>`
2. (Opcional) Para alterar o servidor de logon padrão, digite o seguinte comando:
    
    `tsm configuration set -k oauth.salesforce.server_base_url -v <URL>`
3. Insira o comando a seguir para aplicar as alterações:
    
    `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).

## Configurar Oauth personalizado para um site

Você pode configurar um cliente Salesforce OAuth personalizado para um site.

Considere configurar um cliente OAuth personalizado para 1) substituir um cliente OAuth se configurado para o servidor ou 2) ativar o suporte para conexão segura a dados que requerem clientes OAuth exclusivos.

Quando um cliente OAuth personalizado é configurado, a configuração no nível do site tem precedência sobre qualquer configuração do lado do servidor, e todas as novas credenciais OAuth criadas usam o cliente OAuth no nível do site por padrão. Nenhuma reinicialização do Tableau Server é necessária para que as configurações tenham efeito.

**Importante:** as credenciais OAuth existentes estabelecidas antes da configuração do cliente OAuth personalizado podem ser usadas temporariamente, mas tanto os administradores do servidor quanto os usuários devem atualizar suas credenciais salvas para ajudar a garantir o acesso ininterrupto aos dados.

### 1: preparar a ID do cliente OAuth, a chave secreta do cliente e a URL de redirecionamento

Antes de configurar o cliente OAuth personalizado, você precisa das informações listadas abaixo. Depois de preparar essas informações, você pode registrar o cliente OAuth personalizado para o site.

- **ID do cliente OAuth e valor do segredo do cliente:** primeiro registre o cliente OAuth com o provedor de dados (conector) para recuperar a ID do cliente e o valor do segredo gerado para o Tableau Server.
- **URL de redirecionamento:** observe a URL de redirecionamento correto. Você precisará disso durante o processo de registro na **Etapa 2** abaixo.
    
    https://<your\_server\_name>.com/auth/add\_oauth\_token
    
    Por exemplo, https://example.com/auth/add\_oauth\_token

### 2: registre a ID do cliente OAuth e a chave secreta do cliente

Siga o procedimento descrito abaixo para registrar o cliente OAuth personalizado no site.

1. Entre no site do Tableau Server usando suas credenciais de administrador acesse a página de Configurações.
2. No Registro de clientes OAuth, clique no botão Adicionar cliente OAuth.
3. Insira as informações necessárias, incluindo as informações da **Etapa 1** acima:
    
    1. Para Tipo de conexão, selecione o conector, cujo cliente OAuth personalizado você deseja configurar.
    2. URL da instância OAuth é necessária se vários clientes OAuth estiverem sendo registrados. Caso contrário, é opcional.
    3. Para ID do cliente, Segredo do cliente e URL de redirecionamento, insira as informações que você preparou na **Etapa 1** acima.
    4. Clique no botão Adicionar cliente OAuth para concluir o processo de registro.
    
    ![Um formulário para a criação de um cliente OAuth, incluindo campos para tipo de conexão, URL da instância OAuth, ID do cliente, segredo do cliente e URL de redirecionamento.](/tableau/current/pt-br/server/pt-br/Img/oauth_custom.png)
4. (Opcional) Repita a etapa 3 para todos os conectores compatíveis.
5. Clique no botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações.

### 3: validar e atualizar as credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente para usar o cliente OAuth personalizado para o site.

1. Navegue até a página Minhas configurações da conta.
2. Em Credenciais salvas para fontes de dados, faça o seguinte:
    
    1. Clique em Excluir ao lado das credenciais salvas existentes para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima.
    2. Ao lado do nome do conector, clique em Adicionar e siga as instruções para 1) conectar-se ao cliente OAuth personalizado configurado na **Etapa 2** acima e 2) salvar as credenciais mais recentes.

### 4: notificar os usuários para atualizarem as credenciais salvas

Certifique-se de notificar os usuários do seu site para atualizar suas credenciais salvas para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima. Os usuários do site podem usar o procedimento descrito em [Atualizar credenciais salvas](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm#oauth_update_credentials) para atualizar as credenciais salvas.

## Gerenciar de tokens de acesso

Depois de configurar o servidor para OAuth, você pode permitir que os usuários gerenciem seus próprios tokens de acesso nas configurações de perfil ou pode gerenciá-los de maneira centralizada. Para obter mais informações, consulte [Permitir tokens de acesso salvos](https://help.tableau.com/current/server/pt-br/allow_saved_tokens.htm).

## Proxy de encaminhamento para autenticação OAuth

Para obter mais informações sobre como configurar um proxy de encaminhamento com autenticação OAuth para o Tableau Server (somente Windows), consulte [Configurar um proxy de encaminhamento para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm#server) na Ajuda do Tableau.

<!-- document id=86c95d711b0bcb683b8a5acda664cd10c657ec30281bf47d4e430fa9e3f9c41b url=/tableau/current/pt-br/server/reconfig_change_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Alterar o Repositório de identidades

As alterações de infraestrutura ou negócios podem precisar alterar o repositório de identidades no Tableau Server. Há dois tipos de repositório de identidades: local e externo. Ao instalar o Tableau Server, você configurou um repositório de identidades local ou externo.

Ao configurar o Tableau Server com um repositório de identidades local, todas as informações de usuário e de grupo são armazenadas e gerenciadas no repositório do Tableau Server. No cenário de armazenamento de identidades local, não há fonte externa para usuários e grupos.

Ao se configurar o Tableau Server com um repositório externo, todas as informações de usuário e de grupo são armazenadas e gerenciadas por um serviço de diretório externo. O Tableau Server deve sincronizar com o repositório de identidades externo para que cópias locais dos usuários e dos grupos existam no repositório do Tableau Server, mas o repositório de identidades externo é a fonte dominante de todos os dados de usuário e de grupo. OpenLDAP e Active Directory são exemplos de repositórios de identidades externos.

Para obter mais informações sobre o Repositório de identidades do Tableau, consulte [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm).

Você pode mudar de um repositório local para um externo, ou pode mudar de um repositório externo para um local. Em ambos os casos, para mudar o tipo do repositório de identidades, conclua estas etapas:

1. Desinstale e reinstale o Tableau Server. O procedimento para desinstalação e instalação limpa está no final deste tópico.
2. Restaure o conteúdo e permissões.
    
    Nestas etapas, o termo “restaurar” não se refere ao uso do comando `TSM maintenance restore` para restaurar o backup que você está fazendo. Não é possível restaurar um backup (`.tsbak`) criado em uma instância do Tableau Server que usa um armazenamento de identidades diferente do Tableau Server de destino. O backup é uma proteção de prática recomendada, caso você precise voltar à configuração original do Tableau Server.

![](/tableau/current/pt-br/server/pt-br/Img/Road-sign-alert.png)

## Aviso

Alterar o tipo de instalação no Tableau Server pode ser um processo complicado e demorado. Para evitar perda de dados ou abandono de conteúdo ou usuários, você precisará planejar este processo cuidadosamente. Em todos os casos, os filtros de usuário aplicados a pastas de trabalho e fontes de dados precisarão ser atualizados manualmente após a alteração.

Mais importante, determinar como você transferirá o conteúdo e permissões ao novo repositório de identidades após reinstalar o Tableau Server.

## Métodos para restauração de conteúdo e permissões

A lista a seguir descreve dois métodos para restauração do conteúdo e das permissões após reinstalar o Tableau Server. Selecione o método mais apropriado para os seus requisitos ambientais.

- **Método 1: usar exportação e importação de site** — Neste método, você começa exportando cada site na sua implementação existente. Em seguida, você instala o novo servidor e o configura para o novo tipo de repositório de identidades. Em seguida, você pode criar novos usuários no site padrão no novo servidor. Por fim, você importa todos os sites originais. Durante a etapa de importação, você pode mapear as identidades originais para os novos usuários que você criou no site padrão.
    
    **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.
    
    Como este método exporta todo o conteúdo e permissões em cada site, é ideal para empresas que precisam de réplicas de alta fidelidade do conteúdo e das permissões, após a conclusão da alteração do repositório de identidades. Algumas empresas solicitam uma alteração do repositório de identidades como o resultado de uma alteração de autenticação. Nesse caso, uma sintaxe diferente de nome de usuário é geralmente um requisito no novo modelo. Este método, que inclui um processo de mapeamento de nomes de usuários originais para novos nomes, fornece flexibilidade para tais cenários.
- **Método 2: instalação recente; os usuários republicam o conteúdo** — Neste método, você instala uma nova versão do Tableau Server e seleciona o novo tipo de repositório de identidades durante a instalação. Você também cria novos sites. Em seguida, você cria usuários e fornece acesso a eles que, por sua vez, republicam as pastas de trabalho e as fontes de dados. Diferente do outro método, neste você não reutiliza qualquer infraestrutura existente do Tableau Server.
    
    Este método é o mais apropriado para implementações menores, com usuários razoavelmente independentes e experientes em relação aos dados. De uma perspectiva administrativa, este método é o mais simples, pois você não está transferindo ativamente o conteúdo. No entanto, como você depende totalmente de usuários para republicar o conteúdo, este método pode não ser bem sucedido para grandes empresas ou para casos em que a supervisão centralizada de conteúdo é necessário.

## Filtros de usuário

Filtros de usuário são específicos do domínio. Por isso, quando o domínio do Tableau Server ou o tipo de autenticação se altera, os filtros não funcionam mais como o esperado. Embora os filtros de usuário sejam gerados pelo Tableau Server, após serem configurados pelo usuário, ele são armazenados nas pastas de trabalho e fontes de dados. Nenhum desses métodos de alteração do repositório de identidades modifica os conteúdos das pasta de trabalho ou das fontes de dados.

Ao planejar a alteração do repositório de identidades, também é necessário incluir uma tarefa final para corrigir filtragens de usuário em todas as pastas de trabalho e fontes de dados com o Tableau Desktop.

## Nomes de usuários e o armazenamento de identidades do Tableau

Se estiver usando o Método 1, é útil compreender como o Tableau Server armazena nomes de usuários no repositório de identidades do Tableau. O Tableau armazena todas as identidades de usuário no repositório, que coordena as permissões de conteúdo e associação ao site com vários serviços no Tableau Server. Geralmente, um repositório de identidades configurado para Active Directory armazena nomes de usuário no formato, `domain\username`. Algumas empresas usam um UPN (`jsmith@domain.lan`).

Por outro lado, as empresas que configuram o Tableau Server com repositório de identidades local normalmente criam nomes de usuário padrão e truncados, como `jsmith`.

Em todos os casos, esses nomes de usuários são cadeias de caracteres literais que devem ser exclusivas no repositório de identidades do Tableau. Se você estiver alterando de um tipo de repositório de identidades para outro, então sua autenticação de destino, SSO ou solução de provisionamento de usuário pode necessitar um formato de nome de usuário específico.

Portanto, para manter todas as permissões, conteúdo e viabilidade de usuário, uma das afirmações a seguir deve ser verdadeira após a alteração do tipo de repositório de identidades:

- Os novos nomes de usuário devem corresponder aos nomes de usuário originais, ou
- Os nomes de usuário originais devem ser atualizados para correspondência a um novo formato.

Se uma alteração de autenticação estiver guiado a alteração do repositório de identidades, o esquema da autenticação de destino definirá uma sintaxe de nome de usuário diferente de seus nomes de usuário originais. O Método 1 inclui um processo em que você pode mapear os nomes de usuário originais aos novos nomes de usuário.

É possível que o formato de nome de usuário original funcione com o novo tipo de autenticação. Por exemplo, se você usou nomes UPN em uma implementação de repositório de identidades local, pode ser capaz de usar os mesmos nomes de usuário em uma implementação do Active Directory. Você também poderia usar o formato `domain\username` para repositório de identidades local, desde que os usuários continuem a usá-lo para entrar no Tableau Server.

Se você estiver mudando do repositório de identidades local para o repositório externo do Active Directory, consulte o tópico [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm) como parte do seu processo de planejamento.

## Método 1: usar a exportação e importação do site

Use a mesma versão do Tableau Server para as operações de exportação e importação.

1. Exporte todos os sites no seu servidor. Consulte [Exportar ou importar um site](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm).
2. [Fazer backup, remover e reinstalar](#Back).
3. Crie novos usuários no Tableau Server. Você deve ter um novo usuário que corresponda a cada usuário no servidor original.
4. Importe os sites que você exportou na Etapa 1. Consulte [Exportar ou importar um site](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm). Durante a importação, você será avisado a mapear os novos usuários em relação aos usuários originais.

## Método 2: instalação nova — usuários republicam o conteúdo

Mesmo que não planeje transferir o conteúdo como parte da sua alteração do repositório de identidades, recomendamos que faça backup do servidor.

1. [Fazer backup, remover e reinstalar](#Back).
2. Crie usuários, sites e grupos.
3. Informe os seus usuários sobre o novo Tableau Server, forneça a eles credenciais e permita e que eles republiquem o conteúdo.

## Fazer backup, remover e reinstalar

Ambos os métodos incluem as etapas a seguir: 

1. Backup do Tableau Server
2. Remover o Tableau Server.
3. Reinstalar o Tableau Server com o novo tipo de repositório de identidades.

### Etapa 1: backup do Tableau Server

Como uma prática recomendada, faça backup do servidor antes de continuar.

Siga o procedimento, [Criar um backup usando a interface de linha de comandos (CLI) do TSM](https://help.tableau.com/current/server/pt-br/db_backup.htm#tsm-cli-steps). Execute o comando `backup` com a opção `–d`. A opção `–d` adiciona o carimbo de data.

Ao terminar, copie o arquivo de backup (`.tsbak`) em um local seguro que não seja parte da sua instalação do Tableau Server.

### Etapa 2: Remover o Tableau Server

É necessário remover completamente o Tableau Server do computador. Consulte [Remover o Tableau Server do computador](https://help.tableau.com/current/server/pt-br/remove_tableau.htm).

### Etapa 3: reinstalar o Tableau Server com o novo tipo de autenticação

1. Vá para o Portal do cliente Tableau, entre com seu nome de usuário e senha do Tableau e faça o download do Tableau Server.
2. Instale o Tableau Server. Consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm) para obter mais informações. Durante a instalação, você selecionará o novo tipo de repositório de identidades. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

<!-- document id=70a48b238ce8ba5721917645fe73f43b7822c020d944cb5d921979b1b5beef6c url=/tableau/current/pt-br/server/rmt-incidents-environment-down.md -->

[Pular para o conteúdo principal](#main-content)

# Incidentes de ambiente inativo

Os incidentes de _Ambiente inativo_ serão registrados como críticos quando detectarmos que o Tableau Server está off-line. A seguir, alguns casos de uso em que o Tableau Server é considerado offline por Resource Monitoring Tool do Tableau:

- O Resource Monitoring Tool não consegue obter uma resposta do Tableau Server. O Resource Monitoring Tool tentará novamente três vezes antes do incidente ser registrado.
- Se o Resource Monitoring Tool detectar que um processo está em todos os nós, um incidente ambiental será registrado.

O Resource Monitoring Tool sonda a página do Tableau Server `http://{TableauServerUrl}/admin/systeminfo.xml` a cada 30 segundos (por padrão) para verificar o status. Se o intervalo de 30 segundos de sondagem não for suficiente, aumente-o para 60 segundos. Se o status estiver off-line ou não responder dentro do valor definido para três intervalos de sondagem consecutivos, então um incidente crítico será criado.

**Observação:** o intervalo de sondagem não pode ser definido usando o comando set rmtadmin. Essa configuração só pode ser alterada editando o arquivo config.json."

Um trecho do exemplo de `config.json` está abaixo:

```
{  
  "background":  {  
   "run":true,
   "loglevel":"Information",
    "pollRates":  {  
      "processStatus":  30000  
      }  
    }  
}
```

| Chave | Tipo de dados | Obrigatório? | Descrição |
| --- | --- | --- | --- |
| `processStatus` | Número | Opcional | A quantidade de tempo em milissegundos para pausar entre a sondagem do status do Tableau Server. |

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=9e8485543d351ae4b3f6cae63ec27ae9e99ebce2ddd3c096fe14d6cdcfc0868a url=/tableau/current/pt-br/server/perf_analyze_sample_workbook.md -->

[Pular para o conteúdo principal](#main-content)

# Analisar os dados com a Pasta de trabalho de desempenho de exemplo

**Importante:** Antes de ler este tópico, é necessário concluir as etapas em [Coletar dados com o Monitor de Desempenho do Windows](https://help.tableau.com/current/server/pt-br/perf_collect_perfmon.htm) e [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm).

Para começar a analisar os dados coletados com o Monitor de Desempenho do Windows (PerfMon) e com o repositório do Tableau Server, baixe e use o exemplo de pasta de trabalho de desempenho fornecido pelo Tableau. A pasta de trabalho de exemplo contém planilhas para alguns dos indicadores de desempenho mais importantes, incluindo CPU e utilização de memória por processo, atividade do disco, tempos de carregamento da exibição e muito mais. Após baixar a pasta de trabalho, use-a como um ponto de partida para a sua exploração dos dados e estenda-a para atender às suas necessidades.

## Baixar a pasta de trabalho de desempenho de exemplo

1. Na pasta de trabalho inserida abaixo, clique no botão Baixar no canto inferior direito.
2. Navegue até o diretório onde foi feito o download da pasta de trabalho e clique duas vezes na pasta de trabalho para abri-la no Tableau Desktop.

## Editar as conexões para o repositório do Tableau Server

Após abrir a pasta de trabalho, você deve editar as conexões de dados, a fim de apontar para o repositório do PostgreSQL para a instalação do Tableau Server.

A pasta de trabalho de exemplo inclui as conexões de fonte de dados a seguir:

- **Tarefas em segundo plano** - uma conexão com o repositório do Tableau Server que une as tabelas `_background_tasks` e `_sites`.
- **Eventos do histórico**—uma conexão com o repositório do Tableau Server que une as tabelas `historical_events`, `hist_users` e `historical_event_types`.
- **Uso do recurso** — uma conexão com os dados coletados no PerfMon.
- **Sessões e tempos de carregamento** - uma conexão com o repositório do Tableau Server que une as tabelas `_users`, `_http_requests`, `_sessions` e `_sites`.

1. Em qualquer uma das planilhas da pasta de trabalho, clique com o botão direito do mouse na fonte de dados **Tarefas em segundo plano** no painel **Dados** e clique em **Editar fonte de dados**. (Observe que talvez seja necessário clicar com o botão direito do mouse em um painel e clicar em Reexibir todas as planilhas.)
    
    ![A caixa de diálogo Conexão do PostgreSQL exibe campos onde você pode inserir o endereço do servidor, o nome do usuário e a senha.](/tableau/current/pt-br/server/pt-br/Img/perf_repo_connection_workbook.png)
2. Substitua o endereço do servidor pelo nome do host ou endereço IP do seu servidor.
3. Insira a senha definida para o usuário `readonly`.
4. Clique em **OK**.
5. Repita as etapas acima para a fonte de dados **Sessões e tempos de carregamento**.

## Editar as conexões para os dados do PerfMon

1. Clique na guia **Fonte de dados**.
2. Na lista fonte de dados, selecione **Uso do recurso**.
    
    ![Selecione Uso do recurso na lista suspensa.](/tableau/current/pt-br/server/pt-br/Img/perf_ds_resource_usage.png)
3. No menu, clique em **Dados** > **Uso do recurso** > **Editar conexão**.
4. Navegue até o diretório onde você armazenou os dados do PerfMon.
5. Selecione o arquivo e clique em **Abrir**.

## Substituir as referências nos campos do PerfMon

Como os dados coletados no PerfMon incluem referências para nomes de host específicos, o usuário precisa substituir as referências na pasta de trabalho por nomes de campos específicos. Por exemplo, ao clicar na planilha da **CPU**, você pode observar que a maioria dos campos tem um ponto de exclamação vermelho ao lado. Isso indica que o campo está ausente na nova fonte de dados.

![Referências de fontes de dados quebradas são exibidas com um ponto de exclamação vermelho próximo a elas.](/tableau/current/pt-br/server/pt-br/Img/perf_broken_ds_reference.png)

Para mapear os campos em seus dados para os campos na pasta de trabalho, siga estas etapas:

1. Navegue até a planilha **CPU** ou até qualquer uma das planilhas que usam a fonte de dados Uso do recurso.
2. Clique com o botão direito do mouse na lista **Medidas**, que tem um ponto de exclamação vermelho ao lado.
3. Clique em **Substituir referências**.
4. Selecione o campo correspondente na caixa de diálogo.
    
    Como exemplo, experimente substituir as referências para **\\\\YOUR-SERVER\\LogicalDisk(C:)\\Current Disk Queue Length**.

## Atualizar cálculos

A pasta de trabalho de exemplo inclui cálculos que agregam a utilização do processador para múltiplos processos. Para exibir os dados de todos os processos em seu servidor, é preciso editar os cálculos para incluir instâncias adicionais de processos do servidor.

Por exemplo, o cálculo VizQL Server CPU % inclui uma referência a um processo:

\[\\\\YOUR-SERVER\\Process(vizqlserver)\\% Processor Time\]

No entanto, se o servidor executar mais de um processo de servidor VizQL, será necessário agregar o processo adicional ao cálculo. Por exemplo, insira o seguinte:

_\[\\\\YOUR-SERVER\\Process(vizqlserver)\\% Processor Time\] + \[\\\\YOUR-SERVER\\Process(vizqlserver#1)\\% Processor Time\]_

## Remover o filtro de data da extração

Para limitar a quantidade de dados incluídos na pasta de trabalho de desempenho de amostra (e reduzir o tamanho do download), a pasta de trabalho tem um filtro de data na extração incluída. As visualizações na pasta de trabalho ficam em branco até que o filtro de data seja removido.

1. Clique na guia Fonte de dados.
2. Na parte superior direita, clique em Editar.
    
    ![Clique em Editar ao lado dos botões de opção Conexão.](/tableau/current/pt-br/server/pt-br/Img/perf_edit_extract.png)
3. Selecione o filtro da fonte de dados.
4. Clique em Remover.
    
    ![Clique no botão Remover.](/tableau/current/pt-br/server/pt-br/Img/perf_remove_date_filter.png)

## Publicar no Tableau Server

Opcionalmente, ao terminar de atualizar a pasta de trabalho de desempenho, é possível publicá-la no Tableau Server para que as exibições na pasta de trabalho sejam acessíveis na interface do Tableau Server.

<!-- document id=e9f4b11a949eab6cf5ec35a3e738a38404703e161c1fbc673dd97141cb59eee4 url=/tableau/current/pt-br/server/requ.md -->

[Pular para o conteúdo principal](#main-content)

# Antes da instalação...

**Observação:** encontre informações adicionais sobre as especificações técnicas para o Tableau Server no site da Web do Tableau, [aqui.](http://www.tableau.com/pt-br/products/techspecs#server "Especificações técnicas do Tableau Server")

Este tópico inclui as solicitações e recomendações que devem ser consideradas antes de instalar o Tableau Server em um ambiente de produção.

- Se você não estiver familiarizado com o Tableau Server e desejar implementá-lo na sua organização, incentivamos que você implemente primeiro o Tableau Server como um único servidor em um ambiente de teste. A maneira mais fácil de fazer uma instalação de servidor único é seguir as etapas em [Começar a instalação](https://help.tableau.com/current/server/pt-br/jumpstart.htm).
- Se você estiver implantando o Tableau Server em um cluster distribuído, revise [Requisitos distribuídos](https://help.tableau.com/current/server/pt-br/distrib_requ.htm) além dos requisitos e das recomendações descritas neste tópico.

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Recomendações de hardware para instalações de produção

A lista a seguir descreve as recomendações _mínimas_ de hardware para uma instalação de nó único e uso de produção do Tableau Server:

**Importante:** essas recomendações são mínimas e podem não refletir os requisitos da sua instalação e organização. Por exemplo, há vários fatores que podem afetar os requisitos de espaço em disco, incluindo se você publicará ou não extrações, fluxos e o número de pastas de trabalho no Tableau Server. Para obter mais informações sobre o que pode afetar os requisitos de espaço livre em disco, consulte [Requisitos de espaço em disco](https://help.tableau.com/current/server/pt-br/requ_diskspace.htm).

<table class="table--plain"><colgroup><col><col style="width: 214px;"><col><col><col></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Tipo de instalação</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Processador</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>CPU</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>RAM</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Espaço livre em disco</i></p></th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3"><p>Nó único</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>64 bits (chipsets de x86_64)</li><li>Deve aceitar conjuntos de instruções SSE4.2 e POPCNT</li><li>Os processadores baseados em ARM não são suportados</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>8 núcleos (16 vCPUs), 2.0 GHz ou superior</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Versão 2022.3 e posteriores:</p><ul><li>128 GB</li></ul><p>Versão 2021.4.0 para versão 2022.1.x:</p><ul><li>64 GB</li></ul><p>Versão 2021.3.x e anteriores:</p><ul><li>32 GB</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>50 GB</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Se estiver adicionando o Tableau Prep Conductor à sua instalação do Tableau Server, recomendamos adicionar um segundo nó e dedicá-lo para a execução do Prep Conductor no Tableau Server. Esse nó deve ter um mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Memória de troca recomendada: configuração padrão do arquivo de paginação do Windows. </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>Implantações empresariais e de vários nós</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" colspan="4"><p colspan="4">Entre em contato com o Tableau para obter orientação técnica.</p><p>Os nós devem atender às recomendações mínimas de hardware ou excedê-las, exceto:</p><ul><li><p>Nós dedicados do Processador em segundo plano executando até duas instâncias nele, onde 4 núcleos podem ser aceitáveis.</p></li><li><p>Nó dedicado para o Tableau Prep Conductor: mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</p></li><li><p>Nó dedicado para Independent Gateway: mínimo de 2 núcleos (4 vCPUs), 8 GB de RAM e 100 GB de espaço livre em disco.</p></li></ul></td></tr></tbody></table>

**Importante:** o requisito de espaço em disco não pode ser verificado até que você inicialize o TSM.

- O espaço livre em disco será calculado após a extração do programa de Instalação do Tableau Server. O programa de instalação usa cerca de 1 GB de espaço. Pode ser necessário alocar espaço em disco adicional dependendo de vários fatores, como estar usando extrações.
- **Requisitos de espaço de armazenamento conectado à rede para armazenamento de arquivo externo:** se você estiver planejando configurar o [Tableau Server com armazenamento de arquivo externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm), precisará estimar a quantidade de espaço de armazenamento para dedicar em seu armazenamento conectado à rede.
    
    Estimativa do tamanho do armazenamento: você deve levar em consideração a quantidade de armazenamento necessária para publicar e atualizar as extrações. Além disso, você também deve levar em consideração o tamanho do backup do repositório, a menos que escolha especificamente a opção de fazer o backup do repositório separadamente, conforme descrito no tópico [Opção 2: repositório de backup separadamente](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm#backup-repository-separately)
    
    - Extrações:
        - Considere o número de extrações que será publicado no Tableau Server e o tamanho de cada extração. Teste as suas necessidades ao publicar várias extrações no Tableau Server e, em seguida, verifique o espaço em disco usado. Você pode usar essa quantidade de espaço em disco para ajudar a descobrir quantas extrações serão publicadas no Tableau Server no decorrer do tempo, além de como cada extração existente terá o tamanho aumentado.
        - Considere o espaço necessário pelo diretório temp durante uma atualização de extração. O diretório temp, que armazena uma extração durante a atualização, pode necessitar de um tamanho três vezes maior que o do arquivo final.
    - Backup do repositório:
        - Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório `<data directory>/pgsql/data/base`.
        - Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo `workgroup.pg_dump`.
- A contagem de núcleos baseia-se nos núcleos "físicos". Núcleos físicos podem representar hardware de servidor reais ou em uma máquina virtual (VM). O hyper-threading é ignorado para a finalidades de contar núcleos.
- A RAM mostrada é o mínimo recomendado para uma instalação de um nó único. A instalação pode funcionar melhor com mais RAM, dependendo da atividade, do número de usuários e dos trabalhos em segundo plano.

Para ver a lista completa de recomendações e os requisitos mínimos, consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm). Para as especificações de hardware, o Tableau testa a escalabilidade internamente, consulte [Recomendações de hardware para instalações de produção](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#Hardware).

Para implementações de nuvem públicas na Amazon Web Services e na Google Cloud Platform, a “vCPU” é na realidade uma CPU de hiper processamento e não um núcleo de CPU total. Ao dimensionar as instâncias na nuvem, é preciso ter o dobro de vCPU que o informado nos requisitos de núcleo de CPU do Tableau Server (8 vCPU necessária para uma instalação de avaliação gratuita mínima, 16 vCPU recomendada para uma instalação de nó único).

## Requisitos do sistema operacional

Os seguintes sistemas operacionais Microsoft Windows Server de 64 bits são aceitos

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 20%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 65%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">&nbsp;</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">2021.3.0 - 2023.3.0</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">2023.3.1 - 2026.2.x</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2016</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2019 (x64)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Windows Server 2022</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="text-align: center;"><strong>Observação:</strong>&nbsp;o Windows Server 2022 <em>não </em>é aceito em versões anteriores a 2023.3.1. A partir de abril de 2023, os instaladores de todas as versões do Tableau Server no Windows anteriores a 2023.3.1 bloquearão a instalação no Windows 2022.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr></tbody></table>

Todos os nós em um cluster de vários nós devem ter o mesmo tipo de sistema operacional e a mesma versão principal desse sistema operacional. Por exemplo, todos os nós do Windows Server 2022 .

Você não pode instalar uma instância de vários nós do Tableau Server em uma combinação de nós do Linux e do Windows.

## Diretório de instalação

Por padrão, o Tableau Server será instalado na unidade do sistema. A unidade na qual o Windows está instalado é a unidade do sistema. Na maioria dos casos, a unidade do sistema é a unidade C:\\. Neste caso padrão, o Tableau Server será instalado nos diretórios a seguir:

- `C:\Program Files\Tableau\Tableau Server\packages`
- `C:\ProgramData\Tableau\Tableau Server`

Não especifique um link simbólico ou um local para o diretório de dados em um volume de NFS (Network File System).

### Locais de instalação não padrão

Em vez de instalar na unidade do sistema, algumas organizações instalam aplicativos em uma unidade separada. Durante a instalação (ou com a instalação automática), é possível especificar um local diferente para a instalação. Se você selecionar um drive de instalação ou uma localização de pasta diferente durante a instalação, o diretório de dados do Tableau Server será instalado no mesmo caminho. Ou seja, se você instalar o Tableau em um local não padrão, o caminho `` `C:\ProgramData\Tableau\Tableau Server` `` padrão não será criado.

Ao instalar em um local não padrão, considere o seguinte:

- Pode ser necessário configurar as permissões de conta do usuário Run As manualmente. Se você não usar a conta local predefinida, NetworkServices, como a conta do serviço Run As, será necessário definir as permissões da conta que usará. É necessário definir essas permissões depois de definir Tableau Server. Consulte [Verificar permissões de pasta](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm).
- Os arquivos de log são armazenados em `<installation path or drive>\data\tabsvc\logs`. O caminho `` `C:\ProgramData\Tableau\Tableau Server`\data\tabsvc\logs `` em uma instalação padrão é convertido em `<installation path or drive>\data\tabsvc\logs`.
- Pode ser necessário especificar o mesmo local ao atualizar para as versões mais recentes do Tableau Server. Para obter mais informações sobre a atualização, consulte [Visão geral da atualização do Tableau Server](https://help.tableau.com/current/server/pt-br/upgrade.htm).
    
    **Observação:** se executar o Tableau Server em uma VM, localmente ou na nuvem, esteja ciente das possíveis complicações relacionadas ao licenciamento. Isso se aplica se você estiver executando o Tableau Server como um autônomo ou em um cluster. Se estiver apenas atualizando o Tableau Server na VM, não será necessário ações adicionais relacionadas ao licenciamento. Caso planeje clonar a VM para criar uma nova produção ou ambiente de teste para atualizar, será necessário desativar as licenças do Tableau Server antes da clonagem. Se não fizer isso, o novo ambiente de VM pode acabar com uma licença não confiável, e qualquer tentativa de atualização poderá falhar.
    
    Para clonar uma VM, certifique-se de que o Tableau Server seja não licenciado (todas as licenças estejam desativadas). Depois de clonar a VM, ative a licença do Tableau nela e dê continuidade à atualização.
- Ao instalar uma instância de vários nós do Tableau Server, o local de instalação (caminho) deve ser o mesmo em todos os nós.

## Tableau Prep Conductor

O Tableau Prep Conductor é um dos processos no Tableau Server. Ele executa um fluxo, verifica as credenciais de conexão e envia alertas se houver falha em um fluxo. O Tableau Prep Conductor usa a funcionalidade de agendamento e monitoramento do Tableau Server para automatizar os fluxos em execução para atualizarem a saída do fluxo, em vez de fazer logon no Tableau Prep Builder para executar manualmente fluxos individuais à medida que seus dados são alterados.

O Tableau Prep Conductor é licenciado separadamente e está disponível com a licença do Data Management Para obter mais informações sobre o licenciamento do Tableau Prep Conductor, consulte [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).

Recomendamos habilitar o Tableau Prep Conductor em um nó dedicado. Para obter mais informações:

- Se estiver instalando um novo Tableau Server, consulte [Etapa 1 (nova instalação): instalar o Tableau Server com o Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_conductor_new_install.htm).
- Se você estiver adicionando o Tableau Prep Conductor a uma instalação existente do Tableau Server, consulte o tópico [Etapa 1 (instalação existente): habilitar o Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_conductor_add_to_existing_install.htm).

## Requisitos adicionais

Certifique-se de que o seu ambiente também atenda aos requisitos adicionais a seguir:

**Nome de host**

- O Tableau Server deve resolver o hosthame para um endereço IP usando o servidor de nomes de domínio (DNS) ou com um arquivo de host local no computador que está executando o Tableau Server. Por padrão, os arquivos de host são armazenados em `\Windows\System32\Drivers\etc\hosts`.
- O nome de host do servidor não deve ser alterado após iniciar o Tableau Services Manager durante o processo de instalação. Por exemplo, isso pode acontecer se o pacote cloud-init for usado para inicializar uma máquina virtual e o Tableau Server for instalado nesta máquina.
- Os nomes do host que incluem sublinhado (\_) não são compatíveis com o Tableau Server.

**Capacidade de resposta do DNS**

Os servidores de nomes de domínio configurados para os nós do Tableau Server devem responder de forma rápida e confiável às consultas de registros A e AAAA para nomes de host usados durante a resolução de runtime. Isso inclui o retorno de respostas negativas oportunas (por exemplo, NXDOMAIN) quando um nome de host não está registrado. Respostas lentas do DNS ou tempos limite podem causar atrasos de conexão e consulta.

**Endereço IP estáticos**

O computador no qual o Tableau Server for instalado deve ter um endereço de IPv4 ou IPv6 estático.

Se IPv4 e IPv6 estiverem ativados ou várias placas de rede (NICs) estiverem sendo usadas, pode ocorrer um comportamento inesperado. Para obter mais informações, consulte a seguir:

- **Para implantações do Tableau Server em execução no Windows Server 2019:** alterações no comportamento de configuração IPv6 do Windows Server 2019 podem resultar em IPv6 tendo precedência sobre IPv4. Para verificar a precedência do IPv6, revise o artigo [Os IPs do Tableau Server foram alterados e nem todos os serviços TSM estão funcionando corretamente](https://help.salesforce.com/s/articleView?id=001474911&type=1) na Base de conhecimento do Tableau e atualize as configurações do computador.
- **Quando vários NICs estão sendo usados:** Em implantações em que vários NICs são usados, revise [Solucionar problemas de status de processos inconsistente](https://help.tableau.com/current/server/pt-br/trouble_inconsistent_process_status.htm) para melhores práticas.

**Drivers de banco de dados**

Para conectar-se a fontes de dados específicas, o computador no qual o Tableau Server for instalado deve ter os drivers de banco de dados corretos instalados. Para obter mais informações, consulte [Drivers de banco de dados](https://help.tableau.com/current/server/pt-br/dbdriver.htm).

**Portas disponíveis**

O TSM e Tableau Server precisam de uma porta TCP para que você os acesse. O padrão do TSM é a porta 8850 e o padrão do serviço de Gateway do Tableau Server é a porta 80. Recomendamos certificar que as portas 8850 e 80 não estejam sendo usadas no seu sistema antes de instalar o Tableau Server. Se essas portas não estiverem disponíveis, as portas de TSM e gateway podem ser dinamicamente remapeadas a números de porta diferente e, atualmente, não há interface para exibir para qual porta eles foram remapeados.

Se estiver instalando o Tableau Server em um computador que também executa o IIS (não é uma implantação recomendada), você deverá modificar o número da porta do gateway do Tableau para evitar conflito com o IIS. É possível especificar um número de porta de gateway diferente durante o processo de configuração.

Consulte [Portas do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/ports.htm).

**Configuração do firewall local**

Se você estiver executando um firewall no computador onde o Tableau Server será instalado, você precisará abrir as seguintes portas padrão para o tráfego do Tableau Server. Todos os números de porta, exceto 443, podem ser alterados.

<table class="simple-table" style=""><colgroup><col style="width: 10%;"><col style="width: 10%;"><col style="width: 50%;"><col><col></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th rowspan="2" style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Porta</th><th rowspan="2" style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">TCP/UDP</th><th rowspan="2" style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Usada por&nbsp;...</th><th colspan="2" class="TableStyle-Basic-Border-HeadD-Column1-Header1">TIPO DE INSTALAÇÃO</th></tr><tr class="TableStyle-Basic-Border-Head-Header1"><th style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Todos</th><th style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadD-Column1-Header1"><p>Distribuída / Alta disponibilidade</p></th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">80</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Gateway</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">443</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SSL. Quando o Tableau Server estiver configurado para SSL, o servidor de aplicativos redirecionará as solicitações para essa porta. Não altere essa porta.</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8850</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Services Manager.</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8060</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Banco de dados do PostgreSQL.</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8061</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Porta de verificação de backup do PostgreSQL</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><strong>X</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8000-9000</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Intervalo de portas reservado por padrão para mapeamento dinâmico de processos do Tableau</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><b>X</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">27000-27009</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Intervalo de portas usado pelo Tableau Server para serviço de Licenciamento. Esse intervalo deve estar aberto no nó que executa o serviço de Licenciamento e acessível por meio de outros nós. Por padrão, o nó inicial executa o serviço de Licenciamento.</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="text-align: center;">&nbsp;</td></tr></tbody></table>

Consulte [Portas do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/ports.htm)

Para obter informações sobre a configuração do firewall local do Windows, consulte a documentação do produto da Microsoft.

**Administrador local**

A conta usada para executar a Configuração deve ser um membro do grupo de administradores locais no computador Windows no qual o Tableau Server está instalado.

Por padrão, você também deve usar uma conta com direitos de administrador local para executar a interface do usuário na Web do Tableau Services Manager (TSM) e ferramentas CLI. No entanto, depois de instalar o Tableau Server, você pode especificar um grupo Windows para administração do TSM. Consulte [Configurar um grupo de administração do TSM personalizado](https://help.tableau.com/current/server/pt-br/security_tsm_admin_group.htm).

Use o TSM para configurar os componentes do Tableau Server que dependem do acesso a nível de sistema operacional, como processos, autenticação, arquivos de registro, licenciamento e alertas. Consulte [Autenticação TSM](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Authenti).

A administração específica do Tableau, como a importação de usuários, criação de sites, criação na Web etc., é executada por administradores do Tableau Server. Você pode configurar essas contas administrativas atribuindo funções aos usuários após a instalação. A conta inicial de administrador do Tableau Server é criada como parte do processo de instalação. Consulte [Adicionar uma conta de administrador](https://help.tableau.com/current/server/pt-br/startup.htm).

**Conta de serviço Run As**

A conta de serviço Run As para a execução do serviço do Tableau Server será útil se você estiver usando a autenticação NT com fontes de dados ou se estiver planejando fazer a representação do SQL Server. Para obter mais informações, consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm) e [Representação do SQL Server](https://help.tableau.com/current/server/pt-br/impers.htm).

Em algumas empresas, Políticas de grupo ou outras soluções de gerenciamento de sistema são usadas para padronizar permissões e contas nos servidores de aplicações. Se sua empresa executar tal solução, configure o sistema para acomodar as permissões de pasta exigidas pela conta de serviço Run As. Consulte [Verificar permissões de pasta](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm).

**Software antivírus**

O software antivírus que verifica os diretórios usados pelo Tableau Server pode interferir na instalação e no uso contínuo do Tableau Server. Em alguns casos, isso pode resultar em falhas de instalação, problemas de inicialização do Tableau Server ou afetar o desempenho. Se você planeja executar um software antivírus no computador que executa o Tableau Server, siga as recomendações na [Base de dados de conhecimento](https://kb.tableau.com/articles/howto/improving-performance-by-using-antivirus-exclusions?lang=pt-br).

_Continue para a próxima etapa: [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm)._

<!-- document id=2bc01388c341d720db386d0d1c1bdf8a95786c907007e47349f49e050e613ae6 url=/tableau/current/pt-br/server/lwc_uaf.md -->

[Pular para o conteúdo principal](#main-content)

# Aproveite as Funções de Atributo do Usuário (UAF) com os componentes de Web Lightning do Tableau

Você pode aproveitar as Funções de Atributos do Usuário (UAF) com seus componentes de Web Lightning (LWC) do Tableau View e do Pulse para exibir dados específicos com base nos atributos do usuário que está olhando uma visualização. [Funções de atributos do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm) forneça segurança em nível de linha para que as pessoas que visualizam sua visualização vejam apenas dados relevantes para elas. Para obter mais informações sobre UAFs, consulte [Desbloquear o poder da análise personalizada com funções de atributos do usuário](https://www.tableau.com/pt-br/blog/unlock-power-personalized-analytics-user-attribute-functions).

Pré-requisitos

- O logon único (SSO) com autenticação de token é configurado para os Componentes de Web Lightning do Tableau. [Consulte Configurar componentes do Web Lightning do Tableau e logon único (SSO) com autenticação de token](https://help.tableau.com/current/server/pt-br/lwc_seamless_auth.htm).
- O Tableau está configurado para capturar atributos do usuário em fluxos de trabalho de autenticação. Consulte [Permitir captura de atributos do usuário](https://help.tableau.com/current/server/pt-br/lwc_seamless_auth.htm#allow-capture-of-user-attributes).
- O conteúdo do Tableau a ser inserido inclui [funções de atributo do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm). Para obter um exemplo de como usar funções de atributo do usuário em uma pasta de trabalho do Tableau, consulte [Garantir que o criador do conteúdo inclua funções de atributo do usuário](https://help.tableau.com/current/api/embedding_api/pt-br/docs/embedding_api_user_attributes.html#4-ensure-the-content-author-includes-user-attribute-functions).

## Definições de declarações do Tableau UAF no Salesforce

As definições de declaração do Tableau UAF permitem que você inclua declarações para atributos de usuário no JWT. Os valores desses atributos podem ser extraídos de objetos Conta, Usuário, Oportunidade ou Caso no Salesforce. Quando usado com funções de atributo do usuário no conteúdo do Tableau, somente dados correspondentes aos atributos especificados são exibidos.

Por exemplo, um painel do Tableau pode ser configurado para mostrar apenas dados de vendas em que o valor na coluna de dados \[Estado/Província\] corresponda a um dos valores na declaração JWT para o atributo “estado”.

**Sintaxe**: USERATTRIBUTEINCLUDES('attribute\_name', valor esperado)

**Exemplo**: USERATTRIBUTEINCLUDES('state', \[State/Province\])

Criar uma definição de reivindicação no Salesforce pode incluir as informações específicas do usuário apropriadas no JWT. Neste exemplo, o atributo “estado” pode ser preenchido com valores de Contas em que o usuário atual é o Proprietário da Conta, extraindo valores do campo Estado/Província de Cobrança.

**Exemplo de definição de reivindicação**

- Nome da definição: state\_Account\_BillingState
- Nome do atributo: estado
- Objeto de destino: conta
- Campo do objeto de destino: estado/província de cobrança
- Relação do objeto de destino do visualizador: o visualizador atual é o proprietário da conta

No caso de um representante de vendas que possui contas em Washington, Oregon e Califórnia, o JWT incluirá uma declaração de “estado” com os valores \[WA, OR, CA\]. O painel do Tableau mostraria então apenas dados com valores de \[Estado/Província\] correspondentes a WA, OR ou CA.

## Suporte para usuários externos no Experience Cloud

As Funções de Atributo do Usuário (UAF) e o Mapeamento do Host são compatíveis com **usuários externos** acessando o Tableau por meio de sites do Experience Cloud. Isso permite que os atributos do Salesforce associados ao usuário externo conectado sejam incluídos no JWT, permitindo exibições personalizadas do Tableau com base nos dados desse usuário.

Os usuários externos incluem usuários autenticados do Experience Cloud, como usuários parceiros e da comunidade do cliente. **Usuários convidados não são aceitos.**

Para garantir a funcionalidade adequada:

- Os usuários externos devem ter acesso aos registros relevantes usados pelo UAF e Mapeamento de host.
- Os seguintes objetos devem ser configurados para permitir acesso externo (por exemplo, Somente leitura pública):
    - Token de função de atributo do usuário de análise
    - Mapeamento de host
- As declarações UAF devem ser criadas e configuradas por um usuário Salesforce interno com acesso de configuração.

Com a configuração de compartilhamento adequada, o UAF e o mapeamento de host funcionarão da mesma forma para usuários externos e internos.

## Criar uma definição

Para criar uma definição de atributo do usuário, siga estas etapas:

1. No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
2. No painel de navegação esquerdo, digite “Tableau” na barra de pesquisa Busca rápida.
3. Selecione a página de configurações Definição de reivindicações UAF do Tableau.
4. Selecione Criar novo .
5. Preencha os valores de definição:
    
    1. Nome da definição: insira um exclusiva nome. (Exemplo: state\_Account\_BillingState)
    2. Nome do atributo: insira o nome do atributo especificado pela função de atributo do usuário no Tableau. (Exemplo: estado)
    3. Objeto de destino: selecione o objeto de destino do qual você deseja extrair os valores. Atualmente, os LWCs do Tableau oferecem suporte aos objetos Usuário e Conta.
    4. Campo do objeto de destino: selecione o campo no objeto de destino do qual você deseja extrair os valores. (Exemplo: Estado/Província de cobrança)
    5. Relação entre o objeto de destino do visualizador: selecione a relação entre o visualizador atual e o objeto de destino. (Exemplo: o visualizador atual é o proprietário da conta).
6. Selecione Salvar. Ou, se quiser retornar à página de configurações de Definição de reivindicações UAF do Tableau sem salvar, selecione Cancelar.

## Adicionar uma definição a uma página do componente de Web Lightning do Tableau

### Página inicial, páginas Aplicativo e Registro de Lightning

Para adicionar uma definição:

1. Selecione Selecione….
2. Use as setas para mover as definições disponíveis para o campo Selecionado.
3. Selecione OK.
4. Repita para todos os componentes da Web Lightning do Tableau na mesma página. Para obter mais informações, consulte [Considerações para vários componentes na mesma página](#Consider).

### Páginas do Experience Cloud e a barra de utilitários

Insira uma lista separada por vírgulas de nomes de definições de reivindicações UAF. Para copiar nomes de definições, no aplicativo Salesforce, navegue até a página de configurações Definição de reivindicações do Tableau UAF e selecione Cópia.

### Considerações para vários componentes na mesma página

Se vários componentes da Web Lightning do Tableau View ou do Tableau Pulse forem adicionados à mesma página, cada componente deverá ter o mesmo conjunto de nomes de definição de UAF. Somente um dos componentes é autenticado para o Tableau, e essa sessão será usada para carregar ambos os componentes. Isso significa que as informações de atributo do usuário relevantes para ambos os componentes devem estar presentes nessa sessão, independentemente de qual componente faz a autenticação.

Por exemplo:

- Se você tiver dois componentes do Tableau View e um precisar de informações de atributo do usuário na Definição A e o outro precisar de informações de atributo do usuário na Definição B, ambos os componentes deverão incluir as Definições A e B.
- Se um componente do Tableau View precisar da Definição A, mas o componente do Tableau Pulse na mesma página não precisar de nenhuma informação de atributo do usuário, ambos os componentes deverão incluir a Definição A.

## Excluir uma definição

Para excluir uma definição de atributo do usuário, siga estas etapas:

1. No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
2. No painel de navegação esquerdo, digite “Tableau” na barra de pesquisa Busca rápida.
3. Selecione a página de configurações Definição de reivindicações UAF do Tableau.
4. Selecione Excluir para a definição que deseja excluir.

### Página inicial, páginas Aplicativo e Registro de Lightning

Se você excluir uma definição que já foi adicionada a um Tableau LWC, atualize a página no Lightning App Builder para atualizar as definições disponíveis. Definições excluídas são removidas automaticamente.

### Páginas do Experience Cloud e a barra de utilitários

Definições excluídas não são removidas automaticamente do campo do componente Tableau LWC. Definições excluídas no campo de componente Nomes de definição UAF não causará problemas, mas criará desordem e confusão desnecessárias. Para remover definições do campo do componente Tableau LWC, selecione o campo Nomes de definição do UAF e exclua manualmente todos os nomes que não estão mais em uso.

<!-- document id=a77aa9f6f566aebf96bf95b77fe80a97f67536bee7c462d97b60638635c91437 url=/tableau/current/pt-br/server/server_process_filestore.md -->

[Pular para o conteúdo principal](#main-content)

# Armazenamento de arquivo do Tableau Server

Este tópico descreve o processo de Armazenamento de arquivos quando configurado para ser executado localmente no Tableau Server. No entanto, o Armazenamento de arquivos pode ser executado localmente, bem como fora do Tableau Server. Para obter mais informações sobre o Armazenamento de arquivos externo do Tableau Server, consulte [Armazenamento de arquivos externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm).

O processo do Tableau Server File Store controla o armazenamento de extrações. Quando o Armazenamento de arquivos é instalado, uma instância de Data Engine também é instalada, a menos que o nó já tenha uma instância do processador de dados. Nos ambientes de alta disponibilidade (HA - High Availability), o File Store garante que as extrações sejam sincronizadas a nós de outros armazenamentos de arquivo, para que estejam disponíveis caso um nó de armazenamento de arquivo pare de funcionar.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">File Store</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de File Store é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do File Store são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>filestore</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## O comando decommission

Se desejar ou precisar remover uma instância do Armazenamento de arquivos, é necessário desativar o Armazenamento de arquivos, usando o comando `tsm topology filestore decommission` . Se não desativar o Armazenamento de arquivos antes de tentar removê-lo, será solicitado que execute essa ação. A desativação coloca a instância do Armazenamento de arquivos em modo de somente leitura e copia os dados exclusivos em outros contidos na instância no outro Armazenamento de arquivos do cluster. Quando um armazenamento de arquivos é desativado, isso é exibido na página Status, e quando todos os conteúdos exclusivos tiverem sido copiados em outros nós do Armazenamento de arquivos, o nó desativado é mostrado como pronto para remoção.

### Desativação do Armazenamento de arquivos quando co-localizado com o Controlador administrativo

O backup do Tableau é mais rápido quando uma instância do Armazenamento de arquivos está localizada no mesmo nó que o Controlador administrativo do TSM. Se estiver removendo uma instância do Armazenamento de arquivos que está co-localizada com o Controlador, será avisado sobre o impacto no desempenho dos backups.

<!-- document id=9cd2576725aa63ba618911d154fb06a5c27933d107af6595663dd096bb6437e7 url=/tableau/current/pt-br/server/server_external_filestore_storage.md -->

[Pular para o conteúdo principal](#main-content)

# Armazenamento de arquivos externo do Tableau Server

Este tópico fornece uma visão geral do Armazenamento de arquivos externo do Tableau Server.

O Armazenamento de arquivos do Tableau Server armazena extratos e revisões de pastas de trabalho. Normalmente, o Armazenamento de arquivos do Tableau Server é um processo integrado que é instalado localmente no Tableau Server. A partir do Tableau Server 2020.1, você pode configurá-lo para usar um armazenamento externo para armazenar os dados do Armazenamento de arquivos. O armazenamento externo deve ser um compartilhamento de rede, um armazenamento de arquivos dedicado que permite que vários usuários e dispositivos de cliente heterogêneos recuperem dados de uma capacidade de disco centralizada. Pode ser um Server Message Block (SMB) para Windows ou um Network File System (NFS) para instalações Linux. Os usuários de uma rede de área local (LAN) acessam o armazenamento compartilhado por meio de uma conexão Ethernet padrão.

Com esse novo recurso, agora o Tableau Server pode ser configurado de duas maneiras:

- Instalar o Armazenamento de arquivos localmente, o que significa que o Armazenamento de arquivos está instalado nos nós do Tableau Server.
- Use o Armazenamento de arquivos externos (a partir de 2020.1).

## Por que usar o armazenamento de arquivos externo?

O uso de armazenamento externo tem os seguintes benefícios principais em relação à instalação do Armazenamento de arquivos localmente:

- **Localização centralizada:** quando o Armazenamento de arquivos é instalado localmente, os dados precisam ser replicados em vários nós do Armazenamento de arquivos, o que consumirá a largura de banda da rede. Mover dados para um local centralizado eliminará a necessidade de execução do Armazenamento de arquivos em vários nós em um cluster do Tableau e a replicação entre os nós. Isso pode reduzir os requisitos de espaço em disco em um nó individual, além de reduzir o uso da largura de banda da rede, uma vez que os dados não serão replicados em vários nós.
- **Melhorar o tempo de backup:** as tecnologias de backup instantâneo são eficientes e ao usar o backup instantâneo dos dados do Tableau, você pode esperar reduzir significativamente a quantidade de tempo que leva para fazer um backup do Tableau.

## Gerenciamento do armazenamento de arquivos externo

### Gerenciamento de licenças

Para configurar o External File Store, você deve ter recursos do Advanced Management para o Tableau Server. Para obter mais informações, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm). Se você não tiver recursos do Advanced Management, verá o seguinte comportamento:

- Se tentar configurar o Tableau Server com o Armazenamento de arquivos externo durante a instalação, você verá uma mensagem de erro, mas poderá continuar a instalação e o repositório do Tableau Server será instalado localmente.
- Se você já estiver usando o Armazenamento de arquivos externo e Advanced Management não estiver mais disponível para sua instalação, você verá o seguinte comportamento:
    - Ocorrerá uma falha no servidor durante a reinicialização.
    - Ocorrerá uma falha nos backups.
    - Se você não tiver mais recursos do Advanced Management, mas tiver uma licença válida do Tableau Server, poderá migrar o Armazenamento de arquivos externo para o Armazenamento de arquivos local para que o servidor funcione novamente. Para obter mais informações sobre como migrar do repositório externo para o repositório local, consulte [Reconfigurar Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_reconfigure.htm).

### Cenários de migração compatíveis

- Como mover o Armazenamento de arquivos instalado localmente no Tableau Server para um armazenamento gerenciado externamente (armazenamento anexado à rede).
- Mova o Armazenamento de arquivos do armazenamento gerenciado externamente para o Tableau Server.

### Backup e restauração

O backup no Tableau Server com o Armazenamento de arquivos externo é diferente de como você criaria o backup ao instalar o Armazenamento de arquivos localmente. Para obter mais informações sobre como fazer backup e restauração no Tableau Server com o Armazenamento de arquivos externo, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm).

### Considerações de atualização

Não há etapas especiais necessárias ao atualizar o Tableau Server configurado com um armazenamento de arquivo externo. Você pode seguir o processo normal de atualização.

### Considerações de alta disponibilidade

O Tableau Server não gerencia ou configura a alta disponibilidade para o Armazenamento de arquivos externo. O armazenamento gerenciado pode ter soluções que ofereçam suporte à redundância e alta disponibilidade.

## Topologia

Ao configurar o Tableau Server com o Armazenamento de arquivos externo, você não executará mais o Armazenamento de arquivos localmente. A página Status do servidor indicará que o processo do Armazenamento de arquivos está em um nó externo.

Quando o Armazenamento de arquivos é configurado externamente ao Tableau Server, o Processador de dados e o Armazenamento de arquivos não são mais co-localizados. Durante a instalação, o Processador de dados continuará a ser instalado automaticamente com outros processos, conforme descrito em [Processador de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_engine2_intro.htm), exceto no Armazenamento de arquivos. No entanto, ao configurar o Tableau Server configurado com o Armazenamento de arquivos externo, poderá instalar o Processador de dados em um nó separado sem quaisquer outros processos.

Quando o Armazenamento de arquivos estiver configurada externamente, o Processador de dados acessará os dados do Armazenamento de arquivos (extrações) no sistema de armazenamento em toda a rede. Para garantir que o sistema geral atenda aos requisitos, há algumas coisas que você deve considerar para sua rede e sistema de armazenamento. Para obter mais informações, consulte [Considerações de desempenho para armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_performance.htm).

**O diagrama abaixo é uma versão resumida da topologia do Tableau Server com o Armazenamento de arquivos externo.**

![Um diagrama de um cluster do Tableau Server com um balanceador de carga externo, três nós com vários processos de servidor e um nó externo para armazenamento de arquivos.](/tableau/current/pt-br/server/pt-br/Img/tableau-server-external-filestore-topology-summary.png)

**O diagrama abaixo é uma versão detalhada da topologia do Tableau Server com o Armazenamento de arquivos externo e mostra todos os processos instalados em cada nó.**

![Um diagrama que mostra a arquitetura de uma implantação do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tableau-server-external-filestore-topology-detailed.png)

## Próximo

[Instalar o Tableau Server com o armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_new_install.htm)

## Outros artigos nesta seção

<!-- document id=a02b28aafb85b5282f2c691a24a1f305017da6a43cab6a11546542f5f6e3ed4c url=/tableau/current/pt-br/server/rmt-config-configFile.md -->

[Pular para o conteúdo principal](#main-content)

# Arquivo de configuração do RMT Server

Este tópico descreve as opções de configuração que você pode usar com o arquivo de configuração. Para fazer isso usando a interface da Web, consulte [Configuração do servidor do Resource Monitoring Tool](https://help.tableau.com/current/server/pt-br/rmt-config-configGui.htm).

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

O arquivo de configuração está localizado em `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\master\config\config.json`. Esse caminho pode variar dependendo da instalação.

**Observação:** os valores de configuração são salvos no arquivo de configuração. As alterações podem ser feitas diretamente neste arquivo, mas é aconselhável aproveitar as opções de configuração na interface do usuário e através do utilitário de linha de comando `rmtadmin`. As alterações no arquivo config exigirão uma reinicialização para ser aplicada.

Será preciso reiniciar o RMT Server após alterar o arquivo de configuração.

## Retenção de dados

Por padrão o Resource Monitoring Tool armazena duas semanas de dados detalhados e dez anos de dados agregados de relatórios.

Isso é configurável. Este é um trecho de exemplo que define as configurações de retenção de dados:

```
{  
  "db":  {  
    "cleanup":  {  
      "afterDays":  14,  
      "aggregate":  {  
        "afterDays":  3650  
      }  
    }  
  }  
}
```

### Configuração SMTP

Um trecho de exemplo `config.json` que define as informações SMTP:

```
{  
  "smtp":  {  
    "server":  "localhost",  
    "port":  25,  
    "username":  "my-username",  
    "password":  "my-password",  
    "requireSSL":  true  
  }  
}
```

A lista completa dos valores de configuração disponíveis na seção de configuração `smtp`:

| Chave | Tipo de dados | Obrigatório? | Descrição |
| --- | --- | --- | --- |
| `server` | Cadeia de caracteres | Opcional | O servidor SMTP a ser usado. Valor padrão: `localhost` |
| `port` | Número | Opcional | O número da porta do servidor SMTP. Valor padrão: `25` |
| `username` | Cadeia de caracteres | Opcional | O nome de usuário a ser utilizado se o servidor exigir autenticação. |
| `password` | Cadeia de caracteres | Opcional | A senha a ser utilizada se o servidor exigir autenticação. |
| `requireSSL` | Booleano | Opcional | `true`, se o servidor SMTP exigir SSL, caso contrário, `false`. Valor padrão: `false` |

## Configuração de notificação

Um trecho de exemplo `config.json` que define as informações de notificação:

```
{  
  "notifications":  {  
    "email":  {  
      "from":  "sender@domain.com",  
      "to":  "recipient1@domain.com,recipient2@domain.com"  
    }  
  }  
}
```

As informações de notificação global (conforme mostrado acima) podem ser substituídas de acordo com o ambiente na seção `environments`:

```
{  
  "environments":  {  
    "Environment1":  {  
      "notifications":  {  
        "email":  {  
          "from":  "sender@domain.com",  
          "to":  "recipient1@domain.com,recipient2@domain.com"  
        }  
      }  
    }  
  }  
}
```

A lista completa dos valores de configuração disponíveis na seção de configuração `notifications.email`:

| Chave | Tipo de dados | Obrigatório? | Descrição |
| --- | --- | --- | --- |
| `from` | Cadeia de caracteres | Obrigatório | O endereço de e-mail do remetente. |
| `to` | Cadeia de caracteres | Obrigatório | Os endereços de e-mail do destinatário. Vários endereços devem ser separados por vírgula ou ponto e vírgula. |
| `minimumIncidentSeverity` | Cadeia de caracteres | Opcional | A gravidade mínima do incidente em que os e-mails serão enviados. Valor padrão: `critical`. Veja também [Resource Monitoring Tool do Tableau - Incidentes](https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm). |

## Configuração de histograma

Os limites utilizados para gerar histogramas na interface da Web são configuráveis, usando uma matriz de valores que representam cada limite.

A lista completa de histogramas configuráveis na seção `monitoring.histograms`:

| Chave | Tipo de dados | Obrigatório? | Descrição |
| --- | --- | --- | --- |
| `viewLoadDuration` | Matriz de números | Opcional | Os limites do histograma para carregamentos da exibição. Os valores estão em milissegundos. Valor padrão: `[1000, 3000, 6000, 10000]` |
| `externalDataRequestDuration` | Matriz de números | Opcional | Os limites do histograma para solicitações externas de dados. Os valores estão em milissegundos. Valor padrão: `[1000, 3000, 6000, 10000]` |
| `backgroundTaskDuration` | Matriz de números | Opcional | Os limites do histograma para tarefas em segundo plano. Os valores estão em milissegundos. Valor padrão: `[60000, 300000, 600000, 1800000]` |

Como exemplo, para usar os seguintes intervalos de histograma para tudo globalmente:

- ≤ 1 segundo
- \> 1 segundo e ≤ 10 segundos
- \> 10 segundos e ≤ 30 segundos
- \> 30 segundos

A configuração seria da seguinte forma:

```
{  
  "monitoring":  {  
    "histograms":  {  
      "viewLoadDuration":  [1000,  10000,  30000],  
      "externalDataRequestDuration":  [1000,  10000,  30000],  
      "backgroundTaskDuration":    [1000,  10000,  30000]  
    }  
  }  
}
```

Os limites do histograma também podem ser definidos por ambiente. Como exemplo, para um ambiente cujo identificador é “staging-environment”, use os seguintes intervalos de histograma da exibição:

- ≤ 2,5 segundos
- \> 2,5 segundos e ≤ 5 segundos
- \> 5 segundos e ≤ 30 segundos
- \> 30 segundos e ≤ 1 minuto
- \> 1 minuto e ≤ 10 minutos
- \> 10 minutos

A configuração seria da seguinte forma:

```
{  
  "environments":  {  
    "staging-environment":  {  
      "monitoring":  {  
        "histograms":  {  
          "viewLoadDuration":  [2500,  5000,  30000,  60000,  600000]  
        }  
      }  
    }  
  }  
}
```

O “staging-environment” voltaria para a configuração global do histograma para tarefas em segundo plano.

## Versão TLS mínima

Por padrão, o RMT usará uma versão segura do TLS para criptografar o tráfego. A versão mínima padrão é 1.2, mas se você tiver requisitos de segurança específicos que exijam que versões mais antigas do TLS sejam desabilitadas, você pode modificar a seção `server.minimumTlsVersion` do arquivo de configuração para impor uma versão mínima do TLS, conforme mostrado no trecho de exemplo abaixo, onde a versão mínima é definida como 1.3. A lista de valores válidos para `minimumTlsVersion` é definida em [Protocolos Ssl do .Net Core](https://learn.microsoft.com/pt-br/dotnet/api/system.security.authentication.sslprotocols?view=net-8.0 "SslProtocols Enum").

```
"server":  {  
  "url":  "https://rmtserver:443",  
  "https":  {
    "enforce":  true,
    "certificate":  {  
      "mode":  Default,  
      "local":  {  
        "name":  null,
        "password":  null      
       },
      "store":  {
        "certificateThumbprint":  ""}  
     }, 
     "minimumTlsVersion":  "Tls13"
   },
```

### Configuração de incidente

Consulte [Incidentes](https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm) para obter informações sobre quais opções incidentes estão disponíveis e como configurá-las.

### RMT ServerLogging

Consulte [Arquivos de registro do Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm).

## Agente

O arquivo de configuração do serviço agente está localizado em `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\agent\config\config.json`. Esse caminho pode variar dependendo da instalação.

Será preciso reiniciar o serviço agente após alterar o arquivo de configuração.

### Detecção do Tableau Server

Em quase todas as situações, os agentes detectam automaticamente a instalação do Tableau Server e a única configuração necessária é o [processo de instalação do agente](https://help.tableau.com/current/server/pt-br/rmt-admin-installation.htm#agent-setup) padrão. Se desejar, você pode configurar manualmente as informações do Tableau Server pelo arquivo `config.json`.

Um trecho de exemplo `config.json` que define as informações do Tableau Server necessárias para executar o agente:

```
{  
  "agent":  {  
    "tableauServer":  {  
      "override":  true,  
      "productVersion":  2021.4,  
      "applicationDirectory":  "C:\\Tableau\\Tableau Server\\2021.4"  
    }  
  }  
}
```

As barras invertidas devem ter escape conforme mostrado acima para o formato JSON.

A lista completa dos valores de configuração disponíveis na seção de configuração `agent.tableauServer`:

| Chave | Tipo de dados | Obrigatório? | Descrição |
| --- | --- | --- | --- |
| `applicationDirectory` | Cadeia de caracteres | Obrigatório | O diretório raiz do aplicativo do Tableau Server. |
| `dataDirectory` | Cadeia de caracteres | Opcional | O diretório para obter os arquivos de dados do Tableau Server. |
| `override` | Booleano | Opcional | `true` para que os valores de configuração tenham precedência sobre quaisquer valores detectados automaticamente. `false` para que os valores de configuração atuem como um fallback para os valores detectados automaticamente. |
| `productVersion` | Número | Obrigatório | O número da versão do aplicativo do Tableau Server. |

### Registro do agente

Consulte [Arquivos de registro do Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm).

## Comum

Os valores de configuração comuns estão disponíveis nos aplicativos do RMT Server e Agente. Consulte as seções específicas do aplicativo para obter orientação sobre como localizar o arquivo de configuração.

Será preciso reiniciar o serviço do aplicativo após alterar o arquivo de configuração.

## Mensagens criptografadas

Para habilitar mensagens criptografadas, o servidor RabbitMQ deve ser configurado primeiro para permitir o TLS. Consulte a guia do administrador [Coleta de dados criptografados](https://help.tableau.com/current/server/pt-br/rmt-admin-encrypted-data-collection.htm) para obter mais detalhes.

Ao configurar o RMT Server ou Agente(s) para mensagens criptografadas:

- Os sinalizadores `enabled` e `certificateHostName` devem ser configurados para habilitar a criptografia.
- A variável `certificateHostName` DEVE corresponder ao nome canônico (CN=) no certificado do servidor ou a conexão falhará.
- Provavelmente, a configuração `port` na seção `mq` precisará ser alterada com base na porta TLS configurada como RabbitMQ.

```
{  
  "mq":  {  
    "port":  5671,  
    "tls":  {  
      "enabled":  true,  
      "certificateHostName":  "foo"  
    }  
  }  
}
```

A lista completa dos valores de configuração disponíveis na seção de configuração `mq.tls`:

| Chave | Tipo de dados | Obrigatório? | Descrição |
| --- | --- | --- | --- |
| `enabled` | Booleano | Opcional | `true` permite a criptografia TLS para conexões de mensagens. `false` usa conexões não criptografadas para mensagens. Valor padrão: `false` |
| `certificateHostName` | Cadeia de caracteres | Opcional | `certificateHostName` DEVE corresponder ao nome canônico (CN=) no certificado do servidor ou a conexão falhará. Valor padrão: `""` |

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=a3cea1353ddbb18138a97ed7e08e026200881c9b0472fb5da65fb9cbf98716b0 url=/tableau/current/pt-br/server/cmt-logfiles.md -->

[Pular para o conteúdo principal](#main-content)

# Arquivos de registro do Content Migration Tool do Tableau

O Content Migration Tool do Tableau gera arquivos de registro ao executar migrações. Isso pode ser útil para solucionar problemas.

**Observação:** para obter informações sobre todas as configurações do Content Migration Tool, consulte [Configurações do Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-settings.htm).

## Content Migration Tool Local do arquivo de registro

Para localizar os arquivos de registro do Content Migration Tool de dentro do Content Migration Tool:

1. Inicie o Content Migration Tool.
2. Clique em Help e Settings:
    
    ![A opção Configurações no menu suspenso Ajuda.](/tableau/current/pt-br/server/pt-br/Img/cmt-help-settings.png)
3. Na caixa de diálogo Settings , clique em Open Log Folder:
    
    ![Um cursor paira sobre o botão azul denominado “Abrir pasta de log”.](/tableau/current/pt-br/server/pt-br/Img/cmt-logfile-folder.png)
    
    Uma janela é aberta com os arquivos de registro.

Se estiver trabalhando com o Suporte do Tableau e for solicitado a enviar os arquivos de registro, você deve compactar os arquivos antes de enviá-los. Para obter mais informações sobre como enviar arquivos de registro para o Tableau, consulte a [Base de dados de conhecimento do Tableau](https://kb.tableau.com/articles/howto/alternative-method-for-sending-large-files?lang=pt-br).

## Quem pode fazer isso

Normalmente, as tarefas listadas acima só podem ser feitas por um usuário com acesso de administrador na máquina.

<!-- document id=eab438699d2fbe9d16a777feedad5f36c547ff6a7fca1390e24440a43feb9c81 url=/tableau/current/pt-br/server/rmt-admin-logs.md -->

[Pular para o conteúdo principal](#main-content)

# Arquivos de registro do Resource Monitoring Tool do Tableau

## Arquivos de registro

O Resource Monitoring Tool do Tableau inclui muitos componentes. Cada componente mantém seu próprio conjunto de arquivos de registro.

Por padrão, 31 arquivos de registro com um tamanho máximo de arquivo de 1 GB serão mantidos em cada conjunto. Os arquivos de registro que sobrarem serão excluídos automaticamente.

**Observação:** em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

### Componentes

<table class="simple-table"><colgroup><col style="width: 31%;"><col style="width: 41%;"><col style="width: 26%;"></colgroup><thead><tr class="header"><th><p>Componente</p><p>Para obter informações adicionais sobre serviços instalados com RMT, consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-services.htm" class="xref">Serviços da Resource Monitoring Tool (RMT)</a>.</p></th><th><p>Locais do arquivo de registro</p><p><code style="font-weight: normal;">C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\</code></p></th><th>Descrição</th></tr></thead><tbody><tr class="odd"><td>Processador em segundo plano</td><td><code>background\YYYYMMDD-pts.log</code></td><td>Registros gerados pelo processo em segundo plano geral.</td></tr><tr class="even"><td>Diretor</td><td><code>director\YYYYMMDD-pts.log</code></td><td>Registros gerados pelo processo em segundo plano do diretor.</td></tr><tr class="odd"><td>Host</td><td><code>host\YYYYMMDD.log</code></td><td>Registros gerados pelo host.</td></tr><tr class="even"><td>Servidor Web</td><td><code>web\YYYYMMDD-pts.log</code></td><td>Registros gerados pelo servidor Web.</td></tr><tr class="even"><td>RabbitMQ (Corretor de Mensagens)</td><td><code>rabbitmq/*.log</code></td><td>Logs gerados pelo RabbitMQ</td></tr><tr class="even"><td>PostgreSQL (repositório de dados local)</td><td><code>pgsql/*.log and *.csv</code></td><td>Logs gerados pelo banco de dados PostgreSQL local.</td></tr></tbody></table>

### Registros de segurança

O registro de segurança foi adicionado com a versão 2025.3.4. Você não verá esses registros ou pastas se estiver executando uma versão do RMT anterior a essa.

Para obter detalhes sobre registros de segurança, consulte [Resource Monitoring Tool do Tableau Arquivos de registro de segurança](https://help.tableau.com/current/server/pt-br/rmt-admin-logs-security.htm).

Para obter a solução de problemas avançada, o registro detalhado também pode ser habilitado para atividades mais internas. Esses registros de atividade são armazenados no diretório de log do componente associado.

| Atividade | Locais do arquivo de registro | Descrição |
| --- | --- | --- |
| Banco de dados | `logs\*\YYYYMMDD-ef.log` | Registros de consultas do banco de dados interno. Por padrão, somente os erros são gravados neste registro. Habilite alterando `db.logLevel` para `Debug` ou superior. |
| Fila de mensagens | `logs\*\YYYYMMDD-mq.log` | Registros de comunicação da fila de mensagens interna. Por padrão, este registro não será gerado. Habilite alterando `mq.logLevel` para `Debug` ou superior. |

## Configuração de nível de registro

Níveis de registro do Resource Monitoring Tool podem ser feito das seguintes maneiras:

- Interface da web do Resource Monitoring Tool: no menu Admin, navegue até Configuração e selecione a guia Avançado. Você pode definir os níveis de registro e também especificar se deseja incluir consultas de banco de dados e comunicações de fila de mensagens.
    
    Níveis de registro que você pode definir usando a interface da Web:
    
    | Nível |
    | --- |
    | Padrão: Inclui níveis de informação, aviso, erro e crítico |
    | Detalhado: inclui os níveis de informação, aviso, erro, crítico (tudo no padrão) e depuração |
- Configurações nos arquivos `config.json`. Os níveis de registro são configurados independentemente para cada componente. Os caminhos do arquivo de configuração padrão estão abaixo. Isto pode variar dependendo da pasta de instalação.
    
    | Instale | Localização padrão |
    | --- | --- |
    | Resource Monitoring Tool do Tableau | `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\master\config\config.json` |
    | Resource Monitoring Tool do Tableau Agente | `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\agent\config\config.json` |
    
    Níveis de registro que podem ser configurados usando o arquivo de configuração:
    
    | Nível |
    | --- |
    | Rastreamento |
    | Depuração |
    | Informações |
    | Aviso |
    | Erro |
    | Crítico |
    | Nenhum |
    
    Abaixo está um trecho demonstrando algumas configurações de nível de registro padrão:
    
    ```
    {  
      "db":  {  
        "logLevel":  "Error"  
      },  
      "mq":  {  
        "logLevel":  "Warning"  
      },  
      "server":  {  
        "background":  {  
          "logLevel":  "Information"  
        },  
        "director":  {  
          "logLevel":  "Information"  
        },  
        "web":  {  
          "logLevel":  "Information"  
        }  
      }  
    }
    ```

### Enviar arquivos de registro para o Suporte ao cliente do Tableau

Se estiver trabalhando com o Suporte do Tableau e for solicitado a enviar os arquivos de registro, você deve compactar os arquivos antes de enviá-los.

1. Conecte-se ao servidor RMT e cada servidor que tenha o agenteResource Monitoring Tool instalado.
2. Abra um prompt de comando e execute: `rmtadmin ziplogs <output file path>`, para criar um arquivo ZIP dos arquivos de registro.
    
    Para obter mais informações sobre como enviar arquivos de registro para o Tableau, consulte a [Base de dados de conhecimento do Tableau](https://kb.tableau.com/articles/howto/alternative-method-for-sending-large-files?lang=pt-br).

**Observação:** os arquivos de registro de instalação estão localizados em `%userprofile%\AppData\Local\Temp`. Por exemplo, `C:\Users\jsmith\AppData\Local\Temp`.

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

## Outros artigos nesta seção

<!-- document id=6d7615f44e53365883ad04a424af20355a77a426c818a31d507ac502b6104fc5 url=/tableau/current/pt-br/server/rmt-admin-tableau-logs.md -->

[Pular para o conteúdo principal](#main-content)

# Arquivos de registro do Tableau Server

Os agentes do Resource Monitoring Tool do Tableau monitoram os arquivos de registro do Tableau em tempo quase real e enviam mensagens de registro ao Servidor RMT para processamento e geração de relatórios.

Abaixo está uma lista dos arquivos de registro específicos do Tableau que são monitorados.

Todos os caminhos de diretório são relativos ao diretório de dados do Tableau Server. Por padrão, isso está em: `%PROGRAMDATA%\Tableau\Tableau Server\data\tabsvc`

| Diretório | Nome do arquivo |
| --- | --- |
| `logs\backgrounder` | `backgrounder-*.log` |
| `logs\httpd` | `*.log` |
| `logs\vizportal` | `vizportal-*.log` |
| `logs\dataserver` | `dataserver_*.txt` |
| `logs\vizqlserver` | `vizqlserver_*.txt` |

<!-- document id=fc91dfb032655839703dc143128dfdd7ac461bf32f2f8457e926375695e00a22 url=/tableau/current/pt-br/server/kerberos_runas_jdbc.md -->

[Pular para o conteúdo principal](#main-content)

# Ativar a autenticação Kerberos Run As para conectores JDBC

A partir da versão 2020.2, o Tableau Server é compatível com a autenticação Kerberos para conectores SMTP.

O Tableau Server pode ser configurado para usar uma conta de serviço Kerberos para acessar um banco de dados. Nesse cenário, o Tableau Server se conecta aos bancos de dados com uma conta de serviço, também conhecida como “conta de serviço Run As”. Esse cenário é chamado de “autenticação Run As”.

Consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm).

Para usar a autenticação Run As no Tableau Server, você deve primeiro criar uma pasta de trabalho ou fonte de dados no Tableau Desktop que use autenticação integrada. Quando você publicar no Tableau Server, terá a opção de usar a autenticação Run As. Ao criar uma fonte de dados com a Criação na Web, a autenticação Run As é a operação padrão se você selecionar autenticação integrada.

## Fontes de dados compatíveis

O Tableau é compatível com a delegação JDBC Kerberos com as seguintes fontes de dados:

- Oracle
- PostgreSQL

Se você estiver configurando a autenticação Run As para uma fonte de dados Oracle que usa um conector JDBC, siga o procedimento neste tópico. Como alternativa, se o conector executado no Tableau Server usar um driver nativo, você não precisará seguir os passos deste tópico. Em vez disso, siga os passos para criar uma conta de serviço Run As conforme documentado no tópico, [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm).

## Requisitos

A delegação do Kerberos exige o Active Directory.

- O armazenamento de informações do Tableau Server deve ser configurado para usar LDAP - Active Directory.
- O MIT KDC não é compatível.

## Processo de configuração

Esta seção fornece um exemplo do processo para ativar a autenticação Kerberos Run As.

1. Crie um arquivo keytab para a conta de serviço Run As.
    
    O exemplo a seguir usa a ferramenta ktab fornecida com o JDK. É possível baixar a ferramenta no [AdoptOpenJDK](https://adoptopenjdk.net/). Ao usar o ktab para criar o keytab, use um principal de logon no formato UPN (por exemplo, `service@EXAMPLE.COM`) e não um nome principal de serviço (por exemplo, `HTTP/service.example.com@EXAMPLE.COM`). Além disso, é possível gerar keytabs com o utilitário ktpass. Nesse caso, você pode usar qualquer estilo de nome principal.
    
    <JDK\_HOME>/bin/ktab -k E:/tmp/tabsrv.keytab -a tabsrv@EXAMPLE.COM
    
    O Tableau Server usará a conta de serviço Run As e o keytab associado para autenticar e fazer uma conexão direta com o banco de dados.
2. Copie o keytab no diretório de dados do Tableau Server e verifique se a conta de serviço Run As pode acessar e ler o arquivo keytab. Por padrão, o diretório de registro do Tableau Server encontra-se em `C:\ProgramData\Tableau`. Se estiver executando o Tableau Server em uma implantação distribuída, realize essa etapa em cada nó no cluster.
3. Execute os seguintes comandos TSM para definir a conta de serviço Run As e o caminho para o arquivo keytab:
    
    tsm configuration set -k native\_api.datasource\_runas\_principal -v tabsrv@EXAMPLE.COM
    tsm configuration set -k native\_api.datasource\_runas\_keytab\_path -v <path-to-file>kerberos.keytab
    
    Em alguns casos, o TSM pode retornar um erro mencionando o `--force-keys`. Caso tenha recebido esse erro, execute o comando novamente com o parâmetro `--force-keys` anexado ao argumento.
4. Crie um arquivo krb5.conf e instale em `C:\Windows` em todos os nós do Tableau Server.
    
    Se você já implantou um arquivo krb5.ini nos computadores da empresa, copie esse arquivo e use-o no Tableau Server. Para obter mais informações, consulte o tópico de Documentação do MIT Kerberos, [krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html).
    
    Para alterar a localização do arquivo de configuração Kerberos, execute o seguinte comando TSM:
    
    tsm configuration set -k native\_api.kerberos\_config\_path --force-keys -v "C:\\temp\\krb5.ini"
    
    O exemplo a seguir mostra um arquivo krb5.conf. O Suporte do Tableau não pode ajudar na criação do krb5.conf.
    
    \[libdefaults\]
    forwardable = true
    default\_realm = EXAMPLE.COM
    default\_tkt\_enctypes = rc4-hmac
    default\_tgs\_enctypes = rc4-hmac
    
    \[realms\]
    EXAMPLE.COM = {
    kdc = kdc.example.com
    admin\_server = kdc.example.com
    }
    
    \[domain\_realm\]
    .example.com = EXAMPLE.COM
    example.com = EXAMPLE.COM
5. Execute o seguinte comando do TSM para aplicar as alterações ao Tableau Server:
    
    `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).

<!-- document id=a51e0c1f9b3b916a27de38a448ef0905ed05bf7c4f34c017fe253824d25083a3 url=/tableau/current/pt-br/server/sites_gai_server.md -->

[Pular para o conteúdo principal](#main-content)

# Ativar a IA no seu site do Tableau Server

_Azure compatível com o Tableau Server versão 2025.3 e posterior._

Use o Tableau Agent no Tableau Desktop, no Tableau Prep Builder e na Web ao se conectar ao Tableau Server (todas as edições) quando a IA no Tableau estiver configurada e ativada para criação na Web e o Tableau Prep nas configurações do site.

Para obter informações sobre como configurar o Tableau Agent para o Tableau Cloud, consulte [Ativar a IA no seu site do Tableau Cloud](https://help.tableau.com/current/online/pt-br/setup_tabAI_site_setting.htm).

Os recursos de IA no Tableau podem ajudá-lo a analisar seus dados com mais eficiência. Quando você está usando o Tableau Prep, a IA pode sugerir etapas para limpar seus dados e pode até criar cálculos para você. Ao criar uma visualização, ela pode recomendar perguntas esclarecedoras para explorar seus dados, criar cálculos e ajudá-lo a criar visualizações atraentes diretamente de seus conjuntos de dados.

Para obter mais informações sobre como usar o Tableau Agent para criar visualizações ou limpar seus dados, consulte [Criar exibições e explorar dados com o Tableau Agent](https://help.tableau.com/current/pro/desktop/pt-br/desktop_einstein.htm) e [Criar fluxos do Tableau Prep com o Tableau Agent](https://help.tableau.com/current/prep/pt-br/prep_einstein.htm).

A IA no Tableau no Tableau Server exige que você se conecte ao seu próprio provedor de modelo de linguagem grande (LLM). Atualmente, você pode escolher OpenAI ou Azure OpenAI como seu provedor de LLM. O provedor de LLM selecionado é específico do site. O Azure OpenAI está disponível no Tableau Server a partir da versão 2026.2.

**Observação**: não é necessária capacidade adicional para ambientes baseados em núcleo ao usar o Tableau Agent no Tableau Server.

## PII, segurança de dados e suporte a vários idiomas

Ao usar os recursos de IA do Tableau com seu provedor OpenAI, suas solicitações não usam a camada de confiança do Einstein e seus recursos de governança de dados associados, incluindo mascaramento de PII integrado. O Tableau envia sua pergunta de usuário e uma pequena amostra aleatória de valores por campo para sua conta OpenAI.

Como esse processo não usa os recursos de segurança e mascaramento de PII da camada de confiança do Einstein, você dependerá das medidas de segurança do provedor de LLM para proteger dados confidenciais. Para obter mais informações, consulte [IA no Tableau e confiança](https://help.tableau.com/current/tableau/pt-br/tableau_gai_einstein_trust.htm).

## Considerações de faturamento

Ao se conectar ao Tableau Agent no Tableau Server, você usará sua própria instância de LLM ou o Azure OpenAI. Como seus dados estão fluindo por essa conexão dedicada, suas solicitações não passam pela camada de confiança do Einstein nem incorrem em qualquer cobrança associada. Seu uso será cobrado diretamente, de acordo com o contrato do seu provedor específico de LLM.

## Pré-requisitos para habilitar a IA no Tableau Server

Para configurar e ativar o Tableau Agent para o Tableau Server, você precisará do seguinte:

- Função de administrador no Tableau Server. A configuração de site da IA no Tableau é específica do site e, quando ativada, permite que todos os usuários com acesso a esse site usem o recurso de IA.
- Um contrato ativo com a OpenAI ou o Azure OpenAI.
- Sua chave de API. Você precisará disso para conectar o Tableau Server ao seu provedor de LLM OpenAI ou Azure OpenAI. Recomendamos seguir as práticas recomendadas de segurança padrão e alternar a chave da API regularmente.
- Se você estiver usando o Azure OpenAI, use um modelo implantado no Azure.
- Os modelos de LLM que o Tableau Agent utilizará para realizar tarefas como compreender as solicitações dos usuários e retornar resultados relevantes. O Tableau recomenda os seguintes modelos para obter melhores resultados:
    
    - Entender as solicitações do usuário: gpt-5-mini ou gpt-4o-mini
    - Executar tarefas analíticas: gpt-4o ou posterior
    - Contexto de dados do processo: text-embedding-3-small

## Recursos disponíveis

Os recursos de IA no Tableau a seguir estão disponíveis no Tableau Server:

- Criação na Web do Tableau: cria visualizações ou conclui tarefas para você usando uma interface de usuário conversacional: permitir que os usuários explorem dados, criem visualizações e cálculos conheçam informações com a assistência do Tableau Agent na criação na Web do Tableau Server e no Tableau Desktop (versão 2025.3 e posteriores). Para obter mais informações sobre o Tableau Agent, consulte [Explorar seus dados com o Tableau Agent](https://help.tableau.com/current/online/pt-br/web_author_einstein.htm).
- Tableau Prep: sugere etapas para limpar e transformar seus dados: permitir que os usuários limpem seus dados, criem campos calculados e criem fluxos com a ajuda do Tableau Agent. Esse recurso está disponível na criação na Web do Tableau Prep no Tableau Server e no Tableau Prep Builder (versão 2025.3 e posteriores). Para obter mais informações sobre o Tableau Agent no Tableau Prep, consulte [Criar fluxos do Tableau Prep com o Tableau Agent](https://help.tableau.com/current/prep/pt-br/prep_einstein.htm).

## Configurar IA no Tableau

As etapas para configurar a IA no Tableau e as informações que você precisa inserir são diferentes, com base no provedor de LLM selecionado. A configuração de um provedor de LLM diferente por site é aceita.

Ao configurar a conexão do LLM, você precisará especificar os modelos que deseja que o LLM use para executar tarefas.

- Tableau Agent para criação na Web: usa os modelos especificados para todos os processos.
- Tableau Agent para Prep: usa apenas o modelo especificado para o processo Criar tarefas de análise.

Essa configuração é universal e se aplica a todos os recursos de IA no Tableau que você ativa.

### Configurar OpenAI

1. Entre no Tableau Server como administrador de servidor.
2. No site onde você deseja ativar os recursos generativos de IA, selecione Configurações.
3. Na IA no Tableau, clique em Conectar.
    
    ![A configuração do site do Tableau Server para se conectar a um provedor de LLM.](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_connect.png)
4. Na caixa de diálogo Conectar-se ao LLM, selecione OpenAI para o provedor de LLM, em seguida, insira a chave de API do seu provedor de LLM e clique em Conectar.
    
    ![Caixa de diálogo Tableau Agent no Tableau Server - Conecte-se à OpenAI.](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_API_key_OpenAI.png)
    
    Depois de se conectar com sucesso ao seu provedor, você também pode editar, testar ou excluir sua conexão conforme necessário.
5. Para cada recurso de IA no Tableau que você deseja ativar, selecione Ativar.
6. Na caixa de diálogo Configurações do modelo, selecione os modelos de IA que o Tableau Agent utiliza para concluir seus processos. Selecione um modelo para todos os processos na caixa de diálogo.
    
    Se um modelo não for mais compatível com o OpenAI, os usuários receberão erros ao usar o Tableau Agent. No momento, você precisará atualizar essa configuração manualmente.
    
    ![Caixa de diálogo Configurações do modelo para Tableau Server e OpenAI](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_models_openAI.png)
    
    Selecione os modelos a seguir e clique em Aplicar. Esses modelos são recomendados pelo Tableau para um desempenho ideal.
    
    - Entender as solicitações do usuário: gpt-5-mini ou gpt-4o-mini
    - Executar tarefas de análise: gpt-4o ou posterior
    - Contexto de dados do processo: text-embedding-3-small
7. Na parte superior da página, clique em Salvar.
    
    ![Configuração do site IA no Tableau para Open AI.](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_models_selected_openAI.png)

### Configurar Azure OpenAI

1. Entre no Tableau Server como administrador de servidor.
2. No site onde você deseja ativar os recursos generativos de IA, selecione Configurações.
3. Na IA no Tableau, clique em Conectar.
    
    ![A configuração do site do Tableau Server para se conectar a um provedor de LLM.](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_connect.png)
4. Na caixa de diálogo Conectar-se ao LLM, selecione Azure OpenAI para o provedor do LLM, insira a chave de API do provedor do LLM e o nome do recurso. Você pode encontrar seu Nome de recurso no seu portal Azure OpenAI na URL do endpoint do Azure OpenAI. Por exemplo, se a URL for “https://acme-jsmith.openai.azure.com/”, o nome do recurso será “acme-jsmith”.
    
    ![Caixa de diálogo Conectar-se ao LLM para Tableau Server e Azure OpenAI.](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_API_key_Azure_OpenAI.png)
5. Clique em Conectar. Depois de se conectar com sucesso ao seu provedor, você também pode editar, testar ou excluir sua conexão conforme necessário.
6. Para cada recurso de IA no Tableau que você deseja ativar, selecione Ativar.
7. Na caixa de diálogo Configurações do modelo, insira os modelos de IA que o Tableau Agent utiliza para concluir seus processos. Selecione um modelo para todos os processos na caixa de diálogo.
    
    Se um modelo não for mais compatível com o Azure OpenAI, os usuários receberão erros ao usar o Tableau Agent. No momento, você precisará atualizar essa configuração manualmente.
    
    ![Caixa de diálogo Configurações do modelo para Azure OpenAI.](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_models_azure_openAI.png)
    
    Selecione os modelos a seguir e clique em Aplicar. Esses modelos são recomendados pelo Tableau para um desempenho ideal.
    
    - Entender as solicitações do usuário: gpt-5-mini ou gpt-4o-mini
    - Executar tarefas de análise: gpt-4o ou posterior
    - Contexto de dados do processo: text-embedding-3-small
8. Na parte superior da página, clique em Salvar.
    
    ![Configuração do site IA no Tableau para Tableau Server e Azure OpenAI.](/tableau/current/pt-br/server/pt-br/Img/tab_gai_server_models_selected_azure_openAI.png)

<!-- document id=e61a2fd563b0450366d0600569a9e02da919d21233c9501c18f1a50ec45c9b6c url=/tableau/current/pt-br/server/kerberos_delegation_jdbc.md -->

[Pular para o conteúdo principal](#main-content)

# Ativar delegação do Kerberos para conectores JDBC

A partir da versão 2020.2, o Tableau Server é compatível com a delegação do Kerberos para conectores JDBC.

A delegação do Kerberos permite que o Tableau Server use as credenciais do Kerberos do visualizador de uma pasta de trabalho ou exibição para executar uma consulta a pedido do visualizador. Essa opção é útil nas seguintes situações:

- É preciso saber quem está acessando os dados (o nome do visualizador será exibido nos logs de acesso da fonte de dados).
- Sua fonte de dados apresenta segurança em nível de linha, na qual usuários diferentes têm acesso a linhas diferentes.

## Fontes de dados compatíveis

O Tableau é compatível com a autenticação RunAs do JDBC Kerberos com as seguintes fontes de dados:

- Oracle
- PostgreSQL

Se você estiver configurando a delegação com uma fonte de dados Oracle que usa um conector JDBC, siga o procedimento neste tópico. Como alternativa, se o conector executado no Tableau Server usar um driver nativo, siga o procedimento no tópico de ajuda, [Habilitar a Delegação do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm).

## Requisitos

A delegação do Kerberos exige o Active Directory.

- O armazenamento de informações do Tableau Server deve ser configurado para usar LDAP - Active Directory.
- O MIT KDC não é compatível.

**Observação**: você não precisa ativar a conta Run As para atuar como sistema operacional.

## Processo de configuração

Esta seção fornece um exemplo do processo para habilitar a delegação do Kerberos.

1. O Tableau Server precisará de um ticket de serviço do Kerberos para delegar em nome do usuário que está iniciando a chamada para o banco de dados. Crie uma conta de domínio que será usada para delegar ao banco de dados fornecido. Essa conta é chamada de conta de serviço Run As. Neste tópico, o usuário de exemplo configurado como a conta Run As é `tabsrv@EXAMPLE.COM`.
    
    A conta deve ser configurada para delegação no Active Directory:
    
    1. Em um Servidor Windows conectado ao domínio do usuário, abra Usuários e computadores do Active Directory.
    2. Na página **Propriedades** da conta de serviço Run As, clique na guia **Delegação** e selecione **Confiar neste usuário para a delegação apenas em serviços específicos** e **Usar qualquer protocolo de autenticação**.
2. Crie um arquivo keytab para a conta de serviço Run As.
    
    O exemplo a seguir usa a ferramenta ktab fornecida com o JDK. É possível baixar a ferramenta no [AdoptOpenJDK](https://adoptopenjdk.net/). Ao usar o ktab para criar o keytab, use um principal de logon no formato UPN (por exemplo, `service@EXAMPLE.COM`) e não um nome principal de serviço (por exemplo, `HTTP/service.example.com@EXAMPLE.COM`). Além disso, é possível gerar keytabs com o utilitário ktpass. Nesse caso, você pode usar qualquer estilo de nome principal.
    
    <JDK\_HOME>/bin/ktab -k E:/tmp/tabsrv.keytab -a tabsrv@EXAMPLE.COM
    
    O Tableau Server usará a conta de serviço Run As e o keytab associado para autenticar e fazer uma conexão direta com o banco de dados.
3. Copie o keytab no diretório de dados do Tableau Server e verifique se a conta de serviço Run As pode acessar e ler o arquivo keytab. Por padrão, o diretório de registro do Tableau Server encontra-se em `C:\ProgramData\Tableau`. Se estiver executando o Tableau Server em uma implantação distribuída, realize essa etapa em cada nó no cluster.
4. Crie um arquivo krb5.conf e instale em `C:\Windows` em todos os nós do Tableau Server.
    
    Se você já implantou um arquivo krb5.ini nos computadores da empresa, copie esse arquivo e use-o no Tableau Server. Para obter mais informações, consulte o tópico de Documentação do MIT Kerberos, [krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html).
    
    Para alterar a localização do arquivo de configuração Kerberos, execute o seguinte comando TSM:
    
    tsm configuration set -k native\_api.kerberos\_config\_path --force-keys -v "C:\\temp\\krb5.ini"
    
    O exemplo a seguir mostra um arquivo krb5.conf. O Suporte do Tableau não pode ajudar na criação do krb5.conf.
    
    \[libdefaults\]
    forwardable = true
    default\_realm = EXAMPLE.COM
    default\_tkt\_enctypes = rc4-hmac
    default\_tgs\_enctypes = rc4-hmac
    
    \[realms\]
    EXAMPLE.COM = {
    kdc = kdc.example.com
    admin\_server = kdc.example.com
    }
    
    \[domain\_realm\]
    .example.com = EXAMPLE.COM
    example.com = EXAMPLE.COM
5. Execute os seguintes comandos do TSM para habilitar a delegação do Kerberos, defina a conta de serviço da delegação e associe o arquivo keytab à conta de serviço:
    
    tsm configuration set -k wgserver.delegation.enabled -v true
    tsm configuration set -k native\_api.datasource\_impersonation\_runas\_principal -v tabsrv@EXAMPLE.COM
    tsm configuration set -k native\_api.datasource\_impersonation\_runas\_keytab\_path -v <path-to-file>kerberos.keytab
    tsm configuration set -k native\_api.protocol\_transition\_a\_d\_short\_domain -v false
    tsm configuration set -k native\_api.protocol\_transition\_uppercase\_realm -v true
    
    Em alguns casos, o TSM pode retornar um erro mencionando o `--force-keys`. Caso tenha recebido esse erro, execute o comando novamente com o parâmetro `--force-keys` anexado ao argumento.
6. Execute o seguinte comando do TSM para aplicar as alterações ao Tableau Server:
    
    `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).

<!-- document id=d387685d63af3f8f0c90b2cd2be65e1f0f116e06ae9031c91e3b76390935683d url=/tableau/current/pt-br/server/activate.md -->

[Pular para o conteúdo principal](#main-content)

# Ativar e registrar o Tableau Server

Antes de usar o Tableau Server, é necessário ativá-lo e registrá-lo.

O Tableau Server exige pelo menos uma chave de produto que ativa o servidor e especifica o número de níveis de licença que você pode atribuir aos usuários. Você pode acessar sua chave do produto no [Portal do cliente](https://customer.tableau.com/).

Caso seja necessário ativar o Tableau Server em um computador offline, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm). Se precisar ativar as chaves de produto adicionais para acrescentar capacidade a uma instalação existente do Tableau Server, consulte [Adicionar capacidade ao Tableau Server](https://help.tableau.com/current/server/pt-br/capacity_add.htm).

## Pré-requisitos

Antes de continuar com os procedimentos neste tópico, conclua os seguintes pré-requisitos, como descrito em [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm):

- [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm)
- O TSM usa a porta 8850. Se você estiver executando um firewall local, abra a porta 8850.
- [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm)

1. Se o computador onde você estiver instalando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.
2. [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
    
    A conta que você usa deve ter privilégios administrativos no computador em que o TSM está instalado.
3. Na página **Ativar**, insira ou cole a chave do produto e clique em **Ativar chave de produto**.
    
    **Observação:** nas versões anteriores a 2023.3.0, uma opção para ativar uma licença de avaliação é exibida. Essa opção foi descontinuada (removida) a partir da versão 2023.3.0. Para saber mais sobre as opções de teste do Tableau Server, entre em contato com seu representante de conta.
    
    Depois que a chave do produto é ativada, ela aparece sob **Chaves do produto ativadas**.
    
    ![Uma tela de ativação do Tableau Server, apresentando um campo para a entrada da chave de produto de licença de 20 caracteres.](/tableau/current/pt-br/server/pt-br/Img/install_01_activate.png)
4. Para ativar outra chave do produto, digite sobre a chave que você acabou de inserir para adicionar a nova chave do produto, e clique em Ativar a chave do produto. Depois que a chave do produto é ativada, ela aparece sob Chaves do produto ativadas. Continue adicionando chaves do produto dessa maneira até terminar.
5. Quando terminar de ativar as chaves do produto, clique em Próximo.
    
    **Observação:** se as chaves do produto ativadas não tiverem a capacidade necessária, como não núcleos suficientes ou apenas uma chave de produto de função Viewer, o Tableau Services Manager exibirá a caixa de diálogo Licenças aplicadas insuficientes. Clique em Ativar outra chave do produto para adicionar outra chave do produto e aumentar a capacidade na instalação do Tableau Server.
    
    ![Uma notificação de que a ativação das chaves de produto para a implantação do Tableau Server é insuficiente.](/tableau/current/pt-br/server/pt-br/Img/install_01_insufficient_product_keys.png)
6. Na página Registrar, insira suas informações nos campos e clique em Registrar.
    
    ![Etapa de registro do assistente de ativação do Tableau Server, com campos obrigatórios para preencher informações de contato, informações da empresa e detalhes regionais.](/tableau/current/pt-br/server/pt-br/Img/install_02_register.png)

### Configurar para proxy de encaminhamento

Se o computador onde você estiver instalando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.

### Ativar o Tableau Server

Para ativar o Tableau Server para uso em produção, é necessário ter uma chave do produto.

Para ativar uma chave do produto, execute o comando a seguir:

```
tsm licenses activate -k <product key>
```

Para ativar uma avaliação gratuita de duas semanas, execute o comando a seguir:

```
tsm licenses activate -t
```

Se você não puder ativar o Tableau, por exemplo, se receber um erro como esse:

License Server not available

consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

**E se eu receber um erro de acesso negado ao tentar executar comandos do TSM?**

Verifique se a conta que está usando é um membro do grupo de Administradores locais no computador Windows onde está instalando o Tableau Server.

### Registrar o Tableau Server

Após a ativação, é necessário registrar o Tableau Server. Para fazer isso, crie um arquivo de registro e, em seguida, passe-o como uma opção com o comando `tsm register`.

1. Gere um modelo que você possa editar executando o comando a seguir:
    
    `tsm register --template > /path/to/<registration_file>.json`
2. Edite o arquivo modelo para criar o arquivo de registro completo.
    
    Aqui está um exemplo de um arquivo de registro no formato obrigatório:
    
    ```
    {
        "first_name" : "Andrew",
        "last_name" : "Smith",
        "phone" : "311-555-2368",
        "email" : "andrew.smith@mycompany.com",
        "company" : "My Company",
        "industry" : "Finance",
        "company_employees" : "500",			
        "department" : "Engineering",
        "title" : "Senior Manager",
        "city" : "Kirkland",
        "state" : "WA",
        "zip" : "98034",
        "country" : "United States",
        "opt_in" : "false",
        "eula" : "accept"
    }
    ```
    
    **Observações:**
    
    - O campo `opt_in` indica sua preferência para receber comunicações de marketing do Tableau. O valor padrão é `false` para muitos países. Leis específicas de cada país podem afetar o padrão para esse campo. Para obter mais informações, consulte [Informações de privacidade](https://www.salesforce.com/ap/company/privacy/) no site do Salesforce.
    - O campo `eula` confirma que você aceita o Contrato de licença do usuário final (EULA). O valor padrão é `accept`. Você deve aceitar o EULA para usar o Tableau Server. Se você não aceitar, não poderá executar o Tableau Server.
3. Após salvar as alterações no arquivo, passe com a opção `--file` para registrar o Tableau Server:
    
    `tsm register --file /path/to/<registration_file>.json`
    
    Por exemplo:
    
    `tsm register --file C:\Users\mwatson\Documents\tableau-reg-file.json`

Se você tiver uma chave do produto para Gerenciamento de Dados ou Advanced Management, deverá ativar essa chave para usar a funcionalidade adicional. As chaves do produto para essas licenças só devem ser ativadas depois que pelo menos uma chave do produto de capacidade tiver sido ativada no servidor.

- Para obter informações sobre o Tableau Data Management, consulte [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).
- Para obter informações sobre o Tableau Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

## Próxima etapa

- [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm)

## Outros artigos nesta seção

<!-- document id=0d10293a7fb852e79dcddf442d13ea5f4704fa025002e754fb60640e9873237c url=/tableau/current/pt-br/server/dm_catalog_enable.md -->

[Pular para o conteúdo principal](#main-content)

# Ativar o Tableau Catalog

O [Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) descobre e indexa todo o conteúdo no site do seu Tableau Cloud ou Tableau Server, incluindo pastas de trabalho, fontes de dados, planilhas, métricas e fluxos. (O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm).) A indexação é usada para coletar informações sobre o conteúdo, ou metadados, o esquema e a linhagem do conteúdo. Em seguida, com os metadados, o Catalog identifica todos os bancos de dados, arquivos e tabelas usadas pelo conteúdo no site do Tableau Cloud ou no Tableau Server.

O Catalog está disponível com a licença do Data Management. Para obter mais informações, consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm).

Além do Catalog, os metadados sobre seu conteúdo também podem ser acessados na [API de metadados do Tableau](https://help.tableau.com/current/api/metadata_api/pt-br/index.html) e na REST API do Tableau usando [Métodos de metadados](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_metadata.htm).

## Antes de ativar o Catalog

Como administrador do Tableau Server, há algumas coisas que você precisa considerar antes e durante a ativação do Catalog, para assegurar o desempenho ideal do Catalog no ambiente do Tableau Server.

### Versões obrigatórias

Antes de ativar o Catalog, verifique se você está executando _uma_ das seguintes versões do Tableau Server:

- No mínimo, o Tableau Server 2019.3.4 ou posterior
- No mínimo, o Tableau Server 2019.4.2 ou posterior
- No mínimo, o Tableau Server 2020.1.0 ou posterior
- No mínimo, o Tableau Server 2020.2.15 ou posterior
- Tableau Server 2020.3 e posterior

Para obter mais informações sobre por que essas versões são obrigatórias, consulte a [Base de dados de conhecimento do Tableau](https://kb.tableau.com/articles/issue/lineage-not-populating-permissions-not-effective-and-vizzes-load-slowly-after-upgrade?lang=pt-br).

### O que esperar ao ativar o Catalog

Quando o Catalog é ativado, o conteúdo já existente no Tableau Server é indexado imediatamente.

#### Ingestão inicial

O processo de indexação é composto por dois componentes primários, um deles é denominado ingestão inicial. A ingestão inicial pode ser dividida em outros dois componentes:

- Backfill de conteúdo
- Backfill de linhagem

É importante observar o status de backfill de conteúdo e linhagem mais tarde, ao monitorar o andamento e confirmar se o Catalog foi ligado com sucesso e está funcionando no ambiente do Tableau Server.

#### Velocidade de ingestão inicial

O tempo necessário para o Catalog indexar o conteúdo pela primeira vez depende de alguns fatores:

- **Quantidade de conteúdo no Tableau Server:** a quantidade de conteúdo é medida pelo número total de pastas de trabalho, métricas, fontes de dados publicadas e fluxos publicados no Tableau Server. Para obter mais informações, consulte [Espaço em disco para armazenar metadados](#Disk).
- **Número de contêineres de microsserviços não interativos:** O Catalog usa o contêiner de microsserviços não interativo para indexar todo o conteúdo no Tableau Server. Para obter mais informações, consulte [Memória para contêineres de microsserviços não interativos](#Memory).

Entender os fatores que afetam a ingestão inicial pode ajudar a medir o tempo de ativação e execução do Catalog no ambiente.

#### Espaço em disco para armazenar metadados

Durante a ingestão inicial, os metadados são gerados e armazenados no repositório do Tableau Server (banco de dados PostgreSQL “relationship”). A quantidade de espaço em disco necessária para armazenar os metadados é aproximadamente metade do espaço em disco atualmente usado pelo repositório (banco de dados PostgreSQL "workgroup").

Por exemplo, suponha que o repositório use 50 GB de espaço em disco antes de habilitar o Catalog, o repositório pode usar até 75 GB de espaço em disco após ativar o Catalog.

#### Memória para contêineres de microsserviços não interativos

A ingestão inicial é executada dentro do contêiner de microsserviços não interativo. O contêiner de microsserviços não interativo é um dos dois processos de [contêineres de microsserviços do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_container.htm). Por padrão, uma instância do microsserviço não interativo é adicionada a cada nó com um processador em segundo plano instalado.

Por padrão, a ingestão inicial em uma única instância do contêiner de microsserviços não interativo pode usar até 4 GB de memória no nó de segundo plano. Se a quantidade de conteúdo no Tableau Server exceder 10.000, um processo de contêiner de microsserviços não interativo pode exigir até 16 GB de memória no nó de segundo plano. Portanto, ao habilitar o Catalog, certifique-se de que cada nó de segundo plano tenha a capacidade disponível para suportar cada contêiner de microsserviços não interativo durante o processo inicial de ingestão.

Se estiver planejando adicionar mais contêineres de microsserviço não interativos para diminuir o tempo de ingestão inicial, primeiro determine quantos contêineres totais são necessários (usando [Etapa 2: estimar quanto tempo a ingestão inicial levará](#step2), abaixo) e, em seguida, verifique se o ambiente do Tableau Server está configurado com capacidade suficiente para suportar _todos_ os contêineres de microsserviços não interativos. Dependendo de como o ambiente do Tableau Server está configurado, pode não ser possível adicionar todos os contêineres que não são de microsserviço adicional necessário para diminuir o tempo inicial de ingestão.

### Práticas recomendadas para ativar o Catalog

Como a velocidade da ingestão inicial e os requisitos são exclusivos para cada ambiente do Tableau Server, o Tableau recomenda que você faça o seguinte ao ativar o Catalog:

- Certifique-se de que há espaço em disco suficiente que o repositório do Tableau Server possa usar para suportar os metadados adicionais que a ingestão inicial vai gerar e armazenar. Como regra geral, o repositório precisará de um espaço adicional de 50% do disco atualmente usado pelo repositório. Para obter mais informações sobre o uso do disco do Tableau Server, consulte [Espaço em disco do servidor](https://help.tableau.com/current/server/pt-br/adminview_space_all_nodes.htm).
- Dependendo da quantidade de conteúdo no Tableau Server, certifique-se de que cada nó do processador em segundo plano tenha pelo menos de 4 a 16 GB de memória disponível para cada instância de um contêiner de microsserviço não interativo durante a ingestão inicial.
- Realize o processo durante o fim de semana para permitir que a ingestão inicial seja concluída antes que os usuários comecem a utilizar os recursos do Catalog.
- Realize o processo em um ambiente de teste com conteúdo de produção primeiro. Isso porque o tipo de conteúdo que precisa ser ingerido pode desempenhar um papel significativo na velocidade de ingestão.

### Resumo das etapas para ativar o Catalog

As etapas a seguir resumem o processo para ativar e executar o Catalog no Tableau Server. As etapas devem ser realizadas em sequência.

1. [Determinar a quantidade de conteúdo no Tableau Server](#step1)
2. [Estimar o tempo de ingestão inicial](#step2)
3. [Diminuir o tempo de ingestão inicial](#step3)
4. [Ativar a licença do Data Management](#step4)
5. [Desativar os recursos do Catalog](#step5)
6. [Executar o comando tsm maintenance metadata-services](#step6)
7. [Monitorar o andamento da ingestão inicial e validar o status](#step7)
8. [Configurar o SMTP](#step8)
9. [Ativar os recursos do Catalog](#step9)

**Observação:** como a indexação de metadados sobre o conteúdo do Tableau no Tableau Server é alimentada pela API de metadados, é necessário habilitar a API de metadados para executar e usar o Catalog.

## Ativar o Catalog

#### Etapa 1: determinar a quantidade de conteúdo no Tableau Server

Para determinar a quantidade de conteúdo no Tableau Server, faça o seguinte:

1. Entre no Tableau Server usando as credenciais de administrador.
2. Vá para a página **Explorar**.
3. Clique no menu suspenso Projeto de nível superior e adicione os números ao lado de Todas as pastas de trabalho, Todas as métricas, Todas as fontes de dados e Todos os fluxos juntos. Essa é a quantidade total de conteúdo no Tableau Server.

#### Etapa 2: estimar o tempo de ingestão inicial

Para estimar o tempo que o Catalog levará para ingerir conteúdo no Tableau Server pela primeira vez (ingestão inicial), compare a configuração do _seu_ Tableau Server com uma configuração do Tableau Server de _linha de base_.

Para o Tableau Server com a seguinte configuração, a ingestão inicial pode levar cerca de 6 horas para ser concluída.

| Componentes | Valores de linha de base |
| --- | --- |
| Conteúdo | 17.000 pastas de trabalho, fontes de dados publicadas e fluxos |
| Contêineres de microsserviço não interativos | 10 |
| Ingestão | ~6 horas |

Se você tiver aproximadamente _metade_ do conteúdo no ambiente do Tableau Server, a ingestão inicial pode levar metade do tempo para ser concluída.

Por exemplo: 8.500 (pastas de trabalho, métricas, fontes de dados publicadas e fluxos) + 10 contêineres de microsserviço não interativos = ~3 horas (ingestão inicial)

Se você tiver aproximadamente _o dobro_ do conteúdo no ambiente do Tableau Server, a ingestão inicial pode levar o dobro do tempo para ser concluída.

Por exemplo: 34.500 (pastas de trabalho, métricas, fontes de dados publicadas e fluxos) + 10 contêineres de microsserviço não interativos = ~12 horas (ingestão inicial)

#### Etapa 3: diminuir o tempo de ingestão inicial

Como regra geral, o tempo que o Catalog leva para realizar a ingestão inicial está correlacionado com o número de contêineres de microsserviço não interativos. Para ajudar a diminuir o tempo de ingestão inicial, é possível aumentar o número de contêineres de microsserviço não interativos.

**Aumentar o número de contêineres de microsserviço não interativos**

Por padrão, um contêiner de microsserviço não interativos é adicionado a cada nó que possui um processador em segundo plano. Para ajudar a diminuir o tempo de ingestão inicial, o Tableau recomenda aumentar o número de contêineres de microsserviço não interativos usando o comando `tsm topology set-process`.

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute o comando: `tsm topology set-process --count <process_count> --node <node_ID> --process <process_name>`
    
    Por exemplo, para aumentar os contêineres de microsserviço não interativos no nó inicial para 4 contêineres, execute o seguinte comando:
    
    `tsm topology set-process --count 4 –-node node1 --process noninteractive`
    
    Para obter mais informações sobre a execução do comando e suas opções globais, consulte [tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess#TSMSetProcess).

**Importante:** antes de aumentar o número de contêineres de microsserviço não interativos, analise o seguinte: 

- A recomendação de aumentar os contêineres de microsserviço não interativos é para o número total de contêineres de microsserviço não interativo, e não para o total de contêineres de microsserviço não interativos por nó. Por exemplo, suponha que você tem 4 nós, mas deseja aumentar o número de contêineres de microsserviço não interativo para 8. O valor `--count` usando no comando tsm é 2.
- Para cada contêiner de microsserviço não interativo adicionado, 4 GB de memória adicional serão usados no nó e a carga será incluída no repositório do Tableau Server (banco de dados PostreSQL).
    
    - O Tableau recomenda que você aumente gradativamente os contêineres de microsserviço não interativos, no máximo, em 2 de cada vez, enquanto monitora de perto o ambiente do Tableau Server para evitar problemas com a utilização da CPU do repositório do Tableau Server (banco de dados PostgreSQL).
    - Esteja ciente de que, quando muitos contêineres de microsserviço não interativos são adicionados, a utilização da CPU do banco de dados PostgreSQL pode apresentar picos e failover. Os sintomas a serem observadas incluem erros de SQLException nos registros do vizportal. Para obter mais informações, consulte o tópico [Failover do repositório](https://help.tableau.com/current/server/pt-br/distrib_ha_failover.htm).

#### Etapa 4: ativar a licença do Data Management

(Requer Data Management)

Se ainda não tiver sido feito, você pode ativar o Data Management. Para obter mais informações, consulte [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).

#### Etapa 5 (opcional): desativar os recursos do Catalog de cada site

(Requer Data Management)

Como parte da ativação do Data Management, os recursos do Catalog são ativados por padrão. Devido ao processo de indexação e ao tempo de conclusão estimado, considere desativar temporariamente os recursos do Catalog de cada site para que os usuários do Tableau Server não possam acessar os recursos do Catalog, até que o Catalog esteja pronto e apto para fornecer resultados completos e precisos.

1. Entre no Tableau Server usando as credenciais de administrador.
2. No painel de navegação esquerdo, clique em Configurações.
3. Na guia Geral, em Tableau Catalog, desmarque a caixa de seleção Ativar Tableau Catalog.
4. Repita as etapas 2-3 para cada site no Tableau Server.

#### Etapa 6: executar o comando tsm maintenance metadata-services

Execute o comando `tsm maintenance metadata-services` para habilitar a API de metadados do Tableau. A execução do comando instaura a ingestão inicial. Se o Tableau Server estiver licenciado com Data Management, a execução do comando também ativa os recursos do Catalog (se não tiver sido desativado anteriormente).

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute o comando: `tsm maintenance metadata-services enable`
    
    Para obter mais informações sobre como executar o comando tsm, consulte [tsm maintenance](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cat_enable).

**Observações:** ao executar este comando, lembre-se dos seguintes pontos:

- Esse comando interrompe e inicia alguns serviços usados pelo Tableau Server, que faz com que determinadas funcionalidades, como os recursos de Recomendações, fiquem temporariamente indisponíveis.
- Um novo índice de metadados é criado neste momento. A execução deste comando nos momentos subsequentes criará e substituirá o índice anterior.

#### Etapa 7: monitorar o andamento da ingestão inicial e validar o status

A execução do comando tsm acima instaura o processo de ingestão inicial. Para garantir que o processo de ingestão inicial ocorra sem problemas, você pode monitorar o andamento dele, usando a API de Backfill. Para obter mais informações, consulte [Obter o status de ingestão inicial](https://help.tableau.com/current/server/pt-br/dm_tools_backfill.htm).

#### Etapa 8: configurar o SSL

Se ainda não estiver configurado para o Tableau Server, configure a instalação do SMTP. O SMTP oferece suporte ao envio de e-mail aos proprietários que precisam ser contatados sobre alterações nos dados. Para obter mais informações sobre a configuração do SMTP, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

#### Etapa 9 (opcional): ativar os recursos do Catalog de cada site

(Requer Data Management)

Se você desativou os recursos do Catalog antes da ativação do Catalog em um dos procedimentos acima, você deve ativar o Catalog para tornar seus recursos acessíveis aos usuários.

1. Entre no Tableau Server usando as credenciais de administrador.
2. No painel de navegação esquerdo, clique em Configurações.
3. Na guia Geral, em Tableau Catalog, marque a caixa de seleção Ativar Tableau Catalog.
4. Repita as etapas 2-3 para cada site no Tableau Server.

## Solucionar problemas do Catalog

Você ou os usuários podem encontrar um dos seguintes problemas ao usar o Catalog.

#### Mensagens de tempo limite e limite de nós excedidos

Para garantir que as tarefas do Catalog que precisam retornar um grande número de resultados, não esgotem todos os recursos do sistema do Tableau Server, o Catalog implementa tempo limite e limite de nós.

- **Tempo limite**
    
    Quando as tarefas do Catalog atingem o tempo limite, você e seus usuários veem a seguinte mensagem:
    
    “_Mostrando resultados parciais, o limite de tempo da solicitação foi excedido. Tente novamente mais tarde._” ou TIME\_LIMIT\_EXCEEDED
    
    Para resolver esse problema, como administrador do Tableau Server, você pode aumentar o tempo limite usando o comando `tsm configuration set –k metadata.query.limits.time`. Para obter mais informações, veja os tópicos [tsm configuration](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm) e a [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metadata_timeout).
    
    **Importante:** o aumento do tempo limite pode utilizar mais CPU por mais tempo, o que pode afetar o desempenho de outros processos no Tableau Server.
- **Limite de nós**
    
    Quando as tarefas do Catalog atingem o limite do nó, você e seus usuários veem a seguinte mensagem:
    
    NODE\_LIMIT\_EXCEEDED
    
    Para resolver esse problema, como administrador do Tableau Server, você pode aumentar o limite de nós usando o comando `tsm configuration set –k metadata.query.limits.count`. Para obter mais informações, veja os tópicos [tsm configuration](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm) e a [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metadata_nodelimit).
    
    **Importante:** o aumento do tempo limite pode afetar a memória do sistema.

#### Conteúdo ausente

- Se você suspeitar, após a ingestão inicial, que está faltando conteúdo no Catalog, você pode usar a API de eventos para ajudar a solucionar problemas. Eventos manipula o conteúdo de indexação no Tableau Server após a ingestão inicial. Para obter mais informações, consulte [Obter status de eventos](https://help.tableau.com/current/server/pt-br/dm_tools_eventing.htm).
- Quando a conexão entre um ativo externo inserido e seu conteúdo downstream do Tableau é removida, ele permanece no Catalog (ou na API de metadados do Tableau) até que seja automaticamente excluído por um processo em segundo plano executado todos os dias às 22:00:00 UTC (horário universal coordenado) . Por exemplo, suponha que uma pasta de trabalho, inicialmente publicada com um arquivo de texto inserido A, seja republicada com um arquivo de texto inserido B. O arquivo A permanece visível (ou passível de consulta) como um ativo externo até que os processos em segundo plano possam excluí-lo.
    
    Você pode desativar a execução desse processo em segundo plano se não quiser remover esses tipos de ativos externos ou se acreditar que ele consome recursos do sistema que você não deseja dedicar a esse processo. Como alternativa, você pode ajustar o número de ativos integrados externos que são excluídos. Para obter mais informações, veja os tópicos [features.DeleteOrphanedEmbeddedDatabaseAsset](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metadata_orphanembedded) e a [databaseservice.max\_database\_deletes\_per\_run](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metadata_orphanembedded_maxnumber).
    
    É possível monitorar esse processo de uma das duas formas:
    
    - O filtro no **trabalho único canoniza novamente os ativos de banco de dados/tabela existentes após um** tipo de tarefa de alteração de lógica de canonização na exibição do administrador [Tarefas em segundo plano para não extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm).
    - Consulte **Remoção concluída de bancos de dados inseridos órfãos** ou eventos **database\_service\_canonicalization\_change** [nos arquivos de registro](https://help.tableau.com/current/server/pt-br/logs_loc.htm) do Tableau Server.

#### Desempenho após ingestão inicial

Em alguns ambientes do Tableau Server, onde conteúdo específico é atualizado com muita frequência (por exemplo, através de horários de alta frequência ou linhas de comando ou solicitações de API), o processo de indexação pode superar a saturação. Nesses casos, como administrador do servidor, você pode considerar permitir que a limitação de eventos preserve melhor o desempenho do Catalog. Para obter mais informações, consulte [metadata.ingestor.pipeline.throttleEventsEnable](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metadata_eventthrottle_enable).

**Observação:** quando a limitação de eventos é habilitada, os usuários podem notar um atraso pretendido nas alterações de conteúdo no Catalog.

#### Erros de falta de memória

Em alguns casos, os erros de falta de memória do Tableau Server podem ocorrer como resultado de problemas com a ingestão de conteúdo complexo. Se você suspeitar que a ingestão é a causa dos erros de falta de memória no Tableau Server, entre em contato e trabalhe com o Suporte do Tableau para opter [metadata.ingestor.blocklist](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metadata_blocklist) para evitar a ingestão e ajudar a resolver o problema.

## Desativar o Catalog

É possível desativar o Catalog de uma das duas formas.

#### Desativar os recursos do Catalog de cada site

(Requer Data Management)

Você pode desativar os recursos do Catalog a qualquer momento. Quando os recursos do Catalog estão desabilitados, os recursos do Catalog, como a adição de avisos de qualidade de dados ou a capacidade de gerenciar as permissões de ativos de banco de dados e tabela de forma explícita, não são acessíveis. No entanto, o Catalog continua a indexar conteúdo publicado e os metadados são acessíveis a partir da API de metadados do Tableau e dos métodos de metadados na REST API do Tableau.

1. Entre no Tableau Server usando as credenciais de administrador.
2. No painel de navegação esquerdo, clique em Configurações.
3. Na guia Geral, em Tableau Catalog, desmarque a caixa de seleção Ativar Tableau Catalog.

#### Parar de indexar metadados

Para interromper a indexação do conteúdo publicado no Tableau Server, você pode desativar a API de metadados do Tableau. Para desabilitar a API de metadados, execute o comando `tsm maintenance metadata-services disable`. Para obter mais informações, consulte [tsm maintenance](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cat_disable).

## Outros artigos nesta seção

<!-- document id=cbc9c436d76aed85e4f1d0062d8127239311203226e0bf4e50a7b981822b2904 url=/tableau/current/pt-br/server/activate_off.md -->

[Pular para o conteúdo principal](#main-content)

# Ativar o Tableau Server off-line

Ao instalar o Tableau Server, você deve ativar pelo menos uma chave do produto, mas recomendamos que você ative todas as licenças do Tableau Server encontradas no Portal do cliente do Tableau. Isso ativa o servidor e especifica o número de níveis de licença que você pode atribuir aos usuários. Para ativações off-line no Tableau Server com ATR, você pode usar a ID de ativação off-line ou o nome da chave do produto listado no campo ID de ativação off-line no Portal do cliente do Tableau. Para obter informações sobre como encontrar a chave certa, consulte o artigo de conhecimento [Encontrar a chave correta para ativar no Tableau Server](https://help.salesforce.com/s/articleView?id=001464376&type=1).

Pode haver momentos em que você precise ativar licenças depois que o Tableau Server for instalado, por exemplo, se adicionar capacidade ao servidor ou obter uma nova chave do produto. Caso não tenha a chave do produto, você pode obtê-la no [Centro de contas do cliente do Tableau](http://myaccount.tableau.com/).

**Observação:** a ativação de qualquer chave de produto após o Tableau Server já ter sido iniciado exigirá a reinicialização do Tableau Server para que as alterações entrem em vigor.

Na maioria dos casos, você pode ativar sua chave diretamente no Tableau, seja durante a instalação, ou posteriormente, usando a página de licenças do Tableau Services Manager (TSM), mas há algumas circunstâncias que não permitem que você faça isso. Por exemplo, se o computador não estiver conectado à Internet ou tiver um firewall que restringe o acesso fora da intranet. Nesses casos, você precisa fazer uma ativação off-line.

### Ativação off-line e gerenciamento de licenças baseado em logon (LBLM)

A partir do Tableau Server versão 2023.1.0, a ativação off-line tem suporte para LBLM quando seu servidor está configurado para usar o serviço de autorização para execução (ATR). Você só pode configurar o Tableau Server para usar o serviço ATR durante uma nova instalação. Os clientes de atualização com instalações de servidor existentes precisam instalar uma nova instância do Tableau Server versão 2023.1.0 ou posterior e restaurar um backup da instalação existente para essa nova instância.

Para obter mais informações sobre esse processo, consulte [Utilização de uma abordagem azul/verde para atualizar o Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-blue-green.htm).

Para obter mais informações sobre o serviço ATR, consulte [Ativar o Tableau Server usando o serviço ATR (Autorização para execução)](https://help.tableau.com/current/server/pt-br/atr_service.htm).

### Ativação offline e licenças de assinatura atualizáveis (USL)

A ativação offline de licenças de assinatura atualizáveis requer etapas especiais. Para obter detalhes, consulte [Ativação de USL em ambientes offline ou desconectados](https://help.tableau.com/current/server/pt-br/license_usl.htm#USLActivatingOffline).

Há dois cenários nos quais você pode precisar fazer uma ativação off-line:

- Ativação off-line durante a instalação: para concluir uma ativação off-line ao instalar o Tableau Server.
- Ativação off-line de licenças após a instalação: para concluir uma ativação off-line após o servidor ser instalado estar funcionando.

## Visão geral de ativação off-line

A ativação off-line do Tableau Server depende do seu método de ativação (com ou sem o serviço de autorização para execução, ATR).

**Observação**: ao usar ATR e ativar uma licença USL para Tableau Server, você pode usar o **Nome da chave** do Produto ou o **ID de ativação off-line**. Recomendamos usar o Nome da chave porque você não precisa determinar o ID de ativação off-line.

A ativação off-line _sem_ ATR envolve as seguintes etapas:

1. Gere um arquivo de solicitação de ativação off-line.
2. Copie o arquivo de solicitação de ativação offline para um computador com acesso à Internet.
3. Carregue o arquivo de solicitação de ativação off-line no [site de ativação do Tableau](https://www.tableau.com/pt-br/support/activation).
4. Baixe o arquivo de resposta de ativação offline resultante do site . Você usará este arquivo para ativar o Tableau Server

### Mudanças no nome do arquivo de ativação off-line

A partir do Tableau Server versão 2023.1, o sistema de licenciamento do Tableau oferece suporte a duas tecnologias de licenciamento subjacentes. Do ponto de vista administrativo, a única diferença de configuração entre os dois sistemas são os tipos de arquivo que são gerados e consumidos para ativação offline. A tecnologia de licenciamento é determinada durante a instalação inicial do Tableau Server e não pode ser alterada após a instalação.  
  
Estamos nos referindo à versão legada (e ainda suportada) da tecnologia de licenciamento como FlexNet. A versão mais recente da tecnologia é chamada ATR. Para obter mais informações, consulte [Ativar o Tableau Server usando o serviço ATR (Autorização para execução)](https://help.tableau.com/current/server/pt-br/atr_service.htm). A tabela a seguir descreve a nomenclatura de nomenclatura de arquivo para cada tecnologia. A tabela também inclui a referência genérica.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 33%;"><col style="width: 33%;"><col style="width: 33%;"></colgroup><tbody><tr><th>Nome de arquivo genérico</th><th>Nomes de arquivos do Server ATR</th><th>Nomes do arquivo FlexNet</th></tr><tr><td>OfflineAtivationRequest</td><td>OfflineActivationRequestFile_yyyyMMdd.hhmmss.json</td><td>TableauOfflineActivationRequest.tlq</td></tr><tr><td>OfflineAtivationResponse</td><td>OfflineAtivaçãoLicenciamentoAtrs.zip</td><td>activation.tlf</td></tr></tbody></table>

**Observação:** Como esta documentação oferece suporte a várias versões do Tableau Server, usaremos a referência de nome de arquivo genérico (OfflineActivationRequest e OfflineActivationResponse) para o restante deste tópico. Você pode identificar a tecnologia de licenciamento usada pela instalação do Tableau Server de acordo com o tipo de arquivo gerado nas etapas a seguir.

Se você tentar ativar a chave do produto a partir da página de licenças TSM e vir uma caixa de diálogo que diz que a ativação on-line não está disponível, você pode ativar a chave off-line. O processo de ativação off-line deve ser concluído uma vez para cada chave do produto.

1. Clique em Ativar licença off-line.
    
    ![Uma caixa de diálogo informando que a ativação online não está disponível e oferecendo métodos de solução de problemas.](/tableau/current/pt-br/server/pt-br/Img/server_setup_offline_activate02.png)
2. Crie um arquivo de solicitação de ativação off-line (OfflineActivationRequest) para a chave do produto.
    
    Crie um arquivo OfflineActivationRequest que você carregará no site de ativação do Tableau. Se a chave do produto não for pré-preenchida no formulário, digite a chave e clique em Criar um arquivo off-line para gerar um arquivo OfflineActivationRequest no computador local.
    
    ![Como criar, fazer upload e enviar um arquivo off-line.](/tableau/current/pt-br/server/pt-br/Img/server_setup_offline_activate04.png)
    
    Copie o arquivo OfflineActivationRequest em um computador com acesso à Internet. Você precisa carregar esse arquivo no site de ativação do Tableau para gerar um arquivo de resposta de ativação.
3. Carregue e envie o arquivo OfflineActivationRequest.
    
    Você carregará e enviará o arquivo OfflineActivationRequest para o site de ativação do Tableau. Isso gera automaticamente um arquivo de ativação (OfflineActivationResponse) que você pode baixar e copiar novamente no computador com o Tableau Server.
    
    1. No computador onde você copiou o arquivo OfflineActivationRequest, abra um navegador e acesse [http://www.tableau.com/pt-br/support/activation](http://www.tableau.com/pt-br/support/activation) para abrir a página Ativação de suporte do Tableau.
    2. Na página Ativação off-line, clique em Escolher o arquivo para selecionar o arquivo OfflineActivationRequest.
    3. Clique em Upload do arquivo de ativação para enviar o arquivo para o site de ativação do Tableau.
    4. Clique no link `here` para baixar o arquivo OfflineActivationResponse para o seu computador.
        
        ![Mensagem de sucesso de ativação do Offlice.](/tableau/current/pt-br/server/pt-br/Img/server_setup_offline_activate08.png)
    5. Copie o arquivo OfflineActivationResponse para o computador em que o Tableau Server está instalado.
4. Faça upload do arquivo de OfflineAtivationResponse.
    
    No computador com o Tableau Server, clique em Upload do arquivo de ativação para carregar o arquivo OfflineActivationResponse no Tableau Server. Ao fazer isso com êxito, o botão Ativar chave do produto é habilitada.
    
    ![Um formulário que orienta você a enviar um arquivo de ativação.](/tableau/current/pt-br/server/pt-br/Img/server_setup_offline_activate09.png)
5. Clique em Ativar a chave do produto para concluir a ativação offline.
6. (Pule esta etapa se estiver instalando o Tableau Server pela primeira vez.) 
    
    Reinicie o Tableau Server para que as alterações de licenciamento entrem em vigor.

### Etapa 1. Fazer logon no Tableau Services Manager

Antes de dar continuidade, você deve fazer logon no Tableau Services Manager (TSM). Para fazer logon no TSM, execute o comando a seguir:

`[tsm login](https://help.tableau.com/current/server/pt-br/cli_login.htm) -u <username>`

#### E se eu não conseguir fazer logon?

Verifique se a conta que está usando é um membro do grupo de Administradores locais no computador Windows onde está instalando o Tableau Server.

### Etapa 2. Gere um arquivo de solicitação de ativação off-line.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Digite este comando para obter o seu arquivo de ativação off-line: 
    
    `tsm licenses get-offline-activation-file -k <product-key> -o <target-directory>`
    
    Você pode obter sua chave do produto no [Portal do cliente do Tableau](http://customer.tableau.com). O diretório de destino já deve existir. Para identificar a chave a ser usada para ativações off-line, consulte o artigo do Knowledge [Encontrar a chave correta para ativar no Tableau Server](https://help.salesforce.com/s/articleView?id=001464376&type=1).
    
    **Observação**: ao usar ATR e ativar uma licença USL para Tableau Server, você pode usar o **Nome da chave** do Produto ou o **ID de ativação off-line**. Recomendamos usar o Nome da chave porque você não precisa determinar o ID de ativação off-line.
3. Copie o arquivo de ativação off-line (OfflineActivationRequest) do diretório de destino para um computador com acesso à Internet.

### Etapa 3. Carregue a solicitação de ativação off-line no site de ativação do Tableau

1. No computador com acesso à Internet, acesse a página [Ativações de produto](http://www.tableau.com/pt-br/support/drivers/activation) do Tableau.
2. Conclua as instruções para carregar o arquivo OfflineActivationRequest.
    
    Isso cria um arquivo de resposta de ativação (OfflineActivationResponse).
3. Baixe o arquivo OfflineActivationResponse no site de ativação do Tableau.

### Etapa 4. Inicializar ou ativar a sua licença

1. Copie o arquivo OfflineAtivationResponse para um local acessível no seu computador com Tableau Server.
2. Execute o seguinte comando: 
    
    tsm licenses activate -f <path-and-activation-file> 
    
    **Observação:** ao usar o ATR para ativar o Tableau Server, `<path-and-activation-file>` deve apontar para o arquivo OfflineActivationResponse `.zip` empacotado. Não descompacte o arquivo OfflineActivationResponse antes de executar este comando.
3. (Pule esta etapa se estiver instalando o Tableau Server pela primeira vez.) 
    
    Reinicie o Tableau Server para que as alterações de licenciamento entrem em vigor: 
    
    tsm restart
4. (Opcional) Para verificar se todas as licenças estão ativadas, você pode executar este comando:
    
    tsm licenses list
    
    Se você concluiu as etapas acima, deverá ver uma mensagem de sucesso:
    
    Activation successful.
    
    O Tableau Server está ativado. Se precisar de mais ajuda, entre em contato com o [Suporte técnico do Tableau](http://www.tableau.com/pt-br/support/request).

<!-- document id=7342285c57376399eac473b856817fdb52e9439d1a6f95aa09038b71e89643aa url=/tableau/current/pt-br/server/atr_service.md -->

[Pular para o conteúdo principal](#main-content)

# Ativar o Tableau Server usando o serviço ATR (Autorização para execução)

Você pode usar o serviço ATR (Autorização para execução) do Server para ativar o Tableau Server implantado em ambientes locais, de nuvem, contêiner ou virtuais sem faltar ativações de licenças. O serviço ATR consegue isso fornecendo concessões de curto prazo de duração configurável (duração ATR) que vinculam a licença ao dispositivo até que a data de validade da chave do produto seja cumprida. O ATR lida com o rastreamento da capacidade de ativação, portanto, se houver uma alteração de hardware subjacente, não ocorrerão erros máximos de ativação. Esta opção é recomendada para todas as instalações do Tableau Server.

Se você estiver ativando o Tableau Server on-line (esse é o padrão),ele se conectará a vários locais da Internet para fins de licenciamento. Para obter mais informações, consulte [Como se comunicar com a Internet](https://help.tableau.com/current/server/pt-br/plan_network.htm).

Se estiver ativando o Tableau Server offline, você ainda poderá usar o serviço ATR para ativação, mas há pequenas diferenças em como a duração do ATR funciona com ativações offline. Para mais informações, veja [Duração ATR para ativações offline](#ATR2).

Recomendamos usar o serviço de autorização de execução do Server (ATR) para simplificar o licenciamento do servidor. Se você optar por não usar o Server ATR, usará a tecnologia de licenciamento herdada que não fornece os recursos de gerenciamento dinâmico do Server ATR.

A escolha do tipo de ativação será permanente para esta instalação do Tableau Server. Para alterar isso mais tarde, você deve fazer backup, remover e, em seguida, reinstalar o Tableau Server.

## Como funciona a ATR do Tableau Server

Quando o serviço ATR está ativado, o Tableau Server entra em contato periodicamente com um serviço de autorização de execução (ATR) hospedado pelo Tableau para verificar se o Tableau está autorizado a ser executado, com base na licença e na duração da janela de autorização (duração ou concessão do ATR). Desde que essa comunicação seja bem sucedida, o Tableau executa sem afetar o usuário.

Quando o Tableau Server é ativado offline e o ATR está habilitado, o Tableau Server não pode entrar em contato periodicamente com o serviço ATR para verificar se o Tableau está autorizado a ser executado. Em vez disso, o Tableau Server rastreia internamente a duração do ATR desde quando a chave do produto foi ativada offline pela primeira vez.

### Duração do ATR

Por padrão, uma instância do Tableau Server recebe uma concessão ATR de 5 dias (duração) para entrar em contato com o serviço ATR para verificação. Isso significa que após a autorização inicial, o Tableau Server poderá ser usado por cinco dias sem conexão de rede antes que a ativação expire. As verificações de autorização entre o Tableau Server e o serviço ATR são tentadas regularmente e, sempre que uma verificação é bem-sucedida, a duração do ATR é redefinida para seu comprimento total.

A frequência da verificação de autorização varia e depende da duração do ATR:

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td><b>Duração do ATR</b></td><td><b>Frequência de verificação de autorização</b></td></tr><tr><td>&lt; 4 horas</td><td>a cada 15 minutos</td></tr><tr><td>&lt; 24 horas</td><td>a cada 1 hora</td></tr><tr><td>&lt; 7 dias</td><td>a cada 12 horas</td></tr><tr><td>&gt; 7 dias</td><td>a cada 24 horas</td></tr></tbody></table>

Por exemplo: se a duração do ATR for 48 horas, o Tableau Server entrará em contato com o serviço ATR a cada 12 horas para concluir uma verificação de autorização, e a duração do ATR será redefinida para 48 horas após cada verificação de autorização bem-sucedida. A duração do ATR começará então a contar regressivamente até 0 até a próxima verificação de autorização. Se o computador do Tableau Server for desligada ou não houver acesso à Internet, o Tableau Server não poderá mais entrar em contato com o serviço ATR. Se isso acontecer, a duração do ATR não será redefinida para 48 horas e continuará em contagem regressiva até 0. Se o Tableau Server não for iniciado ou não puder se comunicar com o serviço ATR antes que a duração do ATR chegue a 0, a licença expirará e você deverá ativá-la novamente.

**Observação:** você deve manter o Tableau Server em execução o máximo possível. Se o Tableau Server não conseguir concluir uma verificação de autorização dentro do período de duração do ATR, o serviço ATR recuperará a concessão da licença e você precisará reativar sua licença.

Para ver a duração da ATR, consulte [tsm licenses atr-configuration get](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMAtr-configuration-get).

## Definir ou alterar a duração de ATR do Server

Ao usar a ATR do Server para ativar Tableau Server, você pode alterar a duração da ATR e usar uma configuração diferente do padrão de 432000 segundos (5 dias). Se você está criando um servidor de teste ou uma máquina virtual (VM) que terá uma vida útil curta, poderá querer encurtar a duração da ATR. Da mesma forma, se você tiver um servidor que planeja manter ativo por um longo tempo, poderá querer aumentar a duração da ATR.

Se você inicializar novas VMs com frequência, a redução da duração do ATR poderá permitir que VMs mais antigas liberem sua capacidade, permitindo que ela seja usada por novas VMs. Por outro lado, se aumentar a duração do ATR, os ciclos de renovação serão mais longos, mas a capacidade não será libertada com tanta frequência.

Para alterar a duração da ATR, use o comando `tsm licenses atr-configuration set –duration <value_in_seconds>`. Para obter mais informações, consulte [tsm licenses atr-configuration set](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMAtr-configuration-set).

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col><col><col></colgroup><tbody><tr><th><b>Duração da ATR em segundos</b></th><th><b>Mínimo</b></th><th><b>Máximo</b></th><th><b>Padrão</b></th></tr><tr><td><span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> (não contêiner)</td><td>3600 (1 hora)</td><td>7776000 (90 dias)</td><td>432000 (5 dias)</td></tr></tbody></table>

Para definir a duração da ATR e iniciar manualmente o Serviço de Ativação, execute os seguintes comandos:

**Observação:** você deve executar esses comandos como administrador em um prompt de comando. Dependendo da configuração do computador, talvez seja necessário executá-los na pasta C:\\Windows\\System32.

1. No nó inicial, abra um prompt de comando como administrador e use os comandos a seguir:
2. `tsm licenses atr-configuration set -–duration <value_in_seconds>`
3. `tsm pending-changes apply`
4. `net stop activationservice_0`
5. `net start activationservice_0`

## Duração ATR para ativações offline

Quando o Tableau Server é ativado offline, a duração do ATR é definida como um ano a partir do dia em que a chave do produto foi ativada offline ou até a data de renovação da chave do produto, o que ocorrer primeiro. Assim que a duração do ATR atingir a data definida, a chave do produto será desativada. Como o Tableau não consegue se comunicar com o serviço ATR em ambientes offline, não há verificações de autorização.

Se você usar o comando `tsm licenses atr-configuration get` para visualizar a duração do ATR para ativações offline, o resultado será `0`, o que é esperado. Para visualizar a duração do ATR para ativações offline, em vez disso, use o comando `ATRDiag -product "Tableau Server"`. Para obter mais informações, consulte [Referência de linha de comando ATRDiag.exe](https://help.tableau.com/current/server/pt-br/atrdiag.htm). Na saída resultante, a data `TTL End` é a que termina a duração do ATR.

### Atualização da duração do ATR em ambientes offline

Como as verificações de autorização não são possíveis em um ambiente off-line, a duração do ATR é definida como um valor fixo conforme descrito acima. Para evitar tempo de inatividade não planejado do servidor, esteja ciente da duração do ATR em sua instalação e planeje atualizar a duração do ATR antes que ela expire. A maneira de fazer isso depende se você tem uma chave USL ou uma chave não USL:

- **Chaves USL:** se você tiver uma chave USL, siga as instruções aqui: [Atualizações de direitos de licença off-line do USL](https://help.tableau.com/current/server/pt-br/license_usl.htm#USL).
- **Chaves não USL:** se você tiver uma chave não USL, a ativação off-line com ATR não será compatível. Etapas manuais devem ser tomadas. Para obter mais informações, consulte o artigo do Knowledge [Tableau Server 2023.1+: desativação de licença off-line com ATR não disponível](https://help.salesforce.com/s/articleView?id=001534333&type=1).

## Mover uma chave do produto do Server ATR para outro Tableau Server

Se você quiser parar de usar sua chave do produto em um Tableau Server existente e usá-lo em uma nova instalação do Tableau Server, você pode mover sua licença do Server ATR. Você pode querer mover chave do produto ao:

- Alternar entre ambientes de desenvolvimento ou pré-produção.
- Mover o Tableau Server para hardware atualizado.
- Mover o Tableau Server para infraestrutura em nuvem.
- Usar um Tableau Server efêmero, como uma máquina virtual (VM) ou contêiner.

## Desativar uma chave do produto para reutilização em outro Tableau Server

### Desative uma chave do produto na versão 2021.4 e posterior

Você pode remover as chaves do produto que foram ativadas usando o ATR do Server quando quiser recuperar a capacidade da licença de uma instalação do Tableau Server e usá-la em outra. Para obter mais informações sobre como recuperar uma chave do produto, consulte [Desativar a chave do produto](https://help.tableau.com/current/server/pt-br/license_deactivate.htm).

### Desative uma chave do produto na versão 2021.3 e anterior

Quando o serviço ATR é usado para ativar uma licença do Tableau Server, não é possível desativar manualmente a licença. Você pode ter uma produção e duas instalações de não produção por licença. Se você tiver ativações não utilizadas em uma licença, poderá ativar a mesma licença em outro Tableau Server. Se você não tiver mais ativações, ainda poderá ativar a licença depois que a concessão do ATR expirar, seguindo as seguintes etapas:

1. Desative a atualização existente do Tableau Server em sua ativação concedida. Você pode fazer isso usando qualquer um dos seguintes métodos:
    
    - Desligue o Tableau Server existente.
    - Desinstale Tableau Server existente.
    - Desconecte o Tableau Server existente da Internet, desconectando o cabo Ethernet ou desconectando o Wi-Fi.
2. Depois que a concessão do ATR expirar, você pode reutilizar a licença em outro Tableau Server.
3. No novo computador, instale o Tableau Server.
    
    Quando solicitado, ative o Tableau Server usando a mesma licença.

<!-- document id=f75a6f3dee225583f273a40e85f3d4ade3bca266255540305ac4b97241c53da6 url=/tableau/current/pt-br/server/adminview_background_task_delay.md -->

[Pular para o conteúdo principal](#main-content)

# Atraso de tarefas em segundo plano

**Observação:** esta exibição só está disponível para administradores de servidor. Para acessar exibições de servidor em implantações de vários sites, clique no menu do site e selecione **Gerenciar todos os sites**. Para obter informações sobre como navegar em exibições administrativas, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

A exibição Atraso da tarefa em segundo plano exibe o atraso das tarefas de fluxo, de atualização da extração e de assinatura, ou seja, o período entre quando elas foram agendadas para execução e quando realmente serão executadas. Você pode usar a exibição para ajudá-lo a identificar os locais em que o desempenho do servidor pode ser aprimorado ao distribuir as agendas da tarefa e ao otimizar as tarefas.

![Um gráfico de dispersão representa visualmente o tempo de espera por extratos e assinaturas ao longo de cinco dias.](/tableau/current/pt-br/server/pt-br/Img/adminview_background_task_delay.png)

Aqui estão as razões possíveis para os atrasos e as maneiras para reduzi-los:

- Muitas tarefas são agendadas para a mesma hora. Na exibição de exemplo, as tarefas que mostram atrasos longos estão agrupadas na mesma hora do dia, criando picos no tempo de espera. Observe que é possível pode definir o filtro Linha do tempo para um único dia, com o objetivo de visualizar as tarefas por hora e identificar as horas do dia com mais tarefas agendadas. Uma solução para esse problema seria distribuir as tarefas para horários fora do pico, reduzindo a carga do servidor.
- As tarefas específicas demoram muito tempo para execução e evitam que outras tarefas sejam executadas. Por exemplo, um trabalho de atualização de extração pode estar se conectando a uma fonte de dados lenta ou processando uma grande quantidade de dados. Use a exibição administrativa Tarefas de execução em segundo plano para extrações para identificar quais tarefas de atualização de extração estão sendo executadas com lentidão. Em seguida, otimize a tarefa de atualização de extração filtrando os dados agregando os dados ou criando várias fontes de dados para tabelas individuais em uma fonte de dados.
- Outros processos do servidor estão sendo executados ao mesmo tempo e estão consumindo os recursos do servidor ou diminuindo o desempenho. Monitore a utilização da CPU e da memória pelos processos do servidor para saber quais estão consumindo mais recursos e, em seguida, ajuste a configuração dos processos no seu servidor. Para obter mais informações sobre o monitoramento dos processos, consulte [Coletar dados com o Monitor de Desempenho do Windows](https://help.tableau.com/current/server/pt-br/perf_collect_perfmon.htm). Para obter mais informações sobre o ajuste de desempenho dos processos do servidor, consulte [Ajuste de desempenho](https://help.tableau.com/current/server/pt-br/perf_tuning.htm).

<!-- document id=4f362b80859e0097d15fe9bd83365e446cf2b85132c84fef08953afb37b6bfde url=/tableau/current/pt-br/server/grant_role.md -->

[Pular para o conteúdo principal](#main-content)

# Atribuição de licença no logon

A licença de concessão de login (Conceder função no logon) permite que usuários não licenciados em grupos específicos sejam licenciados quando eles entram em um site do Tableau. Isso simplifica o provisionamento de licenças para administradores e remove a necessidade do usuário de solicitar uma licença antes de usar o Tableau.

Para obter mais informações sobre os recursos de função no site e funções mínimas no site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

Por exemplo, imagine um grupo do Active Directory chamado Marketing com 100 usuários, mas apenas 25 usuários precisam acessar o Tableau Server. Um administrador de site ou servidor pode importar todos os usuários do grupo Marketing do Active Directory, definir a função mínima do site do grupo para Explorer e selecionar Conceder função no logon. Quando qualquer um dos usuários do Tableau em Marketing entrar no site do Tableau, eles receberão licenças Explorer. Os usuários que não precisam do Tableau Server permanecem sem licença, a menos que façam logon.

**Observação**: para obter mais informações sobre benefícios e práticas recomendadas, consulte [Conceder função no login](https://help.tableau.com/current/blueprint/pt-br/bp_license_management.htm#grant-role-on-sign-in) no Tableau Blueprint, ferramenta de planejamento do Tableau para organizações orientadas a dados.

## Ativar Conceder função no logon

Você pode habilitar Conceder função no logon em grupos novos ou existentes. As etapas a seguir explicam como usar a Conceder função no logon para adicionar novos usuários que são elegíveis para uma licença, mas podem não usá-la. Este pode ser o caso quando sua empresa tem vários usuários elegíveis, mas licenças limitadas do Tableau.

1. Em um site, clique em Grupos e, em seguida, clique em Adicionar grupo.
    
    Adicione novos usuários ao importar um grupo do Active Directory. Digite o nome do grupo que você deseja importar e selecione o nome do grupo na lista resultante.
    
    ![Caixa de diálogo para importar um grupo do Active Directory.](/tableau/current/pt-br/server/pt-br/Img/import_AD_group1.png)
2. Selecione a função mínima do site para os usuários e selecione Conceder função no logon.
    
    Todos os usuários do grupo Active Directory selecionado serão importados como usuários não licenciados. A função mínima do site definida para o grupo só será fornecida aos usuários do grupo que entrarem no Tableau Server.
    
    ![Caixa de diálogo para importar um grupo do Active Directory com o menu suspenso Função do site expandido e o Explorer (Administrador de site) selecionado.](/tableau/current/pt-br/server/pt-br/Img/import_AD_group2.png)
3. Clique em Importar.

**Observação:** a opção Conceder função de site no logon também pode ser ativada em grupos locais para fornecer funções mínimas do site aos membros do grupo quando eles entrarem no Tableau Server. Para obter mais informações, consulte [Criar um grupo local](https://help.tableau.com/current/server/pt-br/groups_create_local.htm).

## Modificação das funções de usuário com a Atribuição de função no logon

Se um usuário fizer parte de um grupo usando a Atribuição de função no logon, essa função de usuário não poderá ser definida como não licenciada ou sofrer downgrade para uma função inferior à função mínima no site definida para o grupo, independentemente de ter feito logon. No entanto, os administradores ou um usuário com um perfil de administrador com capacidades suficientes podem atualizar a função no site de um usuário manualmente.

Para fazer downgrade da função no site de um usuário ou cancelar a licença do usuário no site, remova o usuário dos grupos que ativaram a Atribuição de função no logon.

De acordo com os termos do [Contrato de licença do usuário final](https://mkt.tableau.com/legal/tableau_eula.pdf), as licenças atribuídas com base no Usuário autorizado podem ser reatribuídas permanentemente para novos usuários. Os usuários só podem sofrer downgrade para uma função no site inferior (incluindo Não licenciado) quando suspenderem permanentemente o acesso ao Software do servidor na função superior.

## Remoção dos usuários afetados pela Atribuição de função no logon

Você pode remover um usuário de um site apenas se o ele não possui conteúdo. Se você tentar remover um usuário que possui conteúdo, a função no site do usuário será definida como Não licenciado e removida de todos os grupos, mas o usuário não será removido do site. Para remover os proprietários de conteúdo, remova-os do grupo que ativou a Atribuição de função no site ou reatribua a propriedade de conteúdo para outro usuário. Para obter mais informações, consulte Remover usuários de um site no tópico da Ajuda [Exibir, gerenciar ou remover usuários](https://help.tableau.com/current/server/pt-br/users_view.htm).

Se o grupo padrão All Users ativou a Atribuição de função no site, os usuários que possuem conteúdo não poderão ser removidos do site ou ter sua licença cancelada. Para remover esses usuários ou cancelar sua licença, reatribua a propriedade do conteúdo para outro usuário e, em seguida, remova o usuário ou cancele sua licença.

A API REST do Tableau pode ser usada para reatribuir a propriedade de conteúdo de uma pasta de trabalho. Para obter mais informações, consulte o método [Atualizar pasta de trabalho](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_workbooks_and_views.htm#update_workbook) na ajuda da API REST. A API REST também pode ser usada para remover usuários do site e transferir a propriedade do conteúdo para outro usuário. Para obter mais informações, consulte o método [Remover usuário do site](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_users_and_groups.htm#remove_user_from_site) na ajuda da API REST.

Para obter mais informações sobre a alteração da propriedade de conteúdo no Tableau Server, consulte [Gerenciar propriedade de conteúdo](https://help.tableau.com/current/server/pt-br/owner.htm#change-the-owner-of-a-content-resource).

<!-- document id=0346f520528a665b4d478598f0e98f600212c9a80e3b149faff8c31e75ac2c4a url=/tableau/current/pt-br/server/server-upgrade-baseline-singlenode-setup.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização de servidor único - Executar instalação

## Executar a instalação

Siga estas etapas para atualizar uma instalação de nó único do Tableau Server.

1. Faça logon no computador com uma conta que seja membro do grupo de administradores locais.
    
    **Observação:** se o Tableau Server usar o Active Directory/LDAP para autenticação, você deverá usar uma conta de domínio ao fazer logon. Usar uma conta de administrador local resultará em erros ao executar o script de atualização.
2. Acesse a pasta na qual você copiou o programa de configuração do Tableau Server e execute-o.
3. O programa de instalação verifica os recursos do sistema para confirmar se o computador atende aos requisitos mínimos e às recomendações.
4. O programa de instalação exibe o local da sua versão existente e instalará a nova versão no mesmo local. Não é possível alterar a localização.
5. Quando a instalação for concluída, a última página do programa de instalação o informa que a atualização não foi terminada. Será preciso executar um script de atualização, `upgrade-tsm`, para concluir a atualização. Se o Tableau Server estiver sendo executado, o script informará isso e perguntará se deve interrompê-lo. O Tableau Server deve ser interrompido para concluir a atualização.
    
    **Observação:** se o script de atualização falhar, detalhes sobre a falha serão exibidos na janela de comando e você poderá refazer o script para tentar a atualização novamente. O script reinicia no ponto em que falhou. Isso economiza tempo e é um bom começo se o upgrade falhar. Para obter mais informações, consulte [Falhas de atualização](https://help.tableau.com/current/server/pt-br/trouble_install_upgrade.htm#CheckpointUpgradeTroubleshooting).
    
    Execute o script de atualização de uma das seguintes formas.
    
    - No programa de instalação:
        
        1. Selecione Iniciar o script de atualização automaticamente e clique em OK:
            
            ![Uma caixa de diálogo que indica que a atualização do Tableau Server ainda está em andamento.](/tableau/current/pt-br/server/pt-br/Img/tsm-installer-win_wix-tsm-to-tsm-upgrade-final-runscript.png)
        2. Uma janela de comando será aberta para o script. Como você está conectado como um usuário com direitos de administrador local, o script será executado usando suas credenciais. Se solicitado, digite a senha.
        
        Clicar em OK fechará a caixa de diálogo do programa de instalação. Se você desmarcar a opção para iniciar automaticamente o script de atualização, precisará executá-lo manualmente na linha de comando.
    - Na linha de comando:
        
        1. No nó inicial, abra um prompt de comando como um administrador.
            
            Você deve abrir uma nova janela de comando porque o programa Configuração atualiza o caminho para a nova instalação.
        2. Navegue até a pasta de scripts da nova instalação.
            
            Como padrão:
            
            `C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`
        3. Execute o script de atualização:
            
            `upgrade-tsm`
            
            Como você está conectado como um usuário com direitos de administrador local, o script será executado usando suas credenciais. Se solicitado, digite a senha. É possível especificar um usuário e senha diferentes ao executar o script usando as opções `--username` e `--password`.
            
            Para ver todas as opções do script `upgrade-tsm` , use a opção `-h`:  
            `upgrade-tsm -h`
6. Inicie o Tableau Server. Você pode fazer isso na interface do usuário na Web do TSM ou em um prompt de comando:
    
    - No TSM, clique em Tableau Server está parado e Iniciar Tableau Server.:
        
        ![Menu suspenso com a opção Iniciar Tableau Server selecionada.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-start-server.png)
    - Em um prompt de comando:
        
        1. Abra um novo prompt de comando como administrador.
        2. Insira este comando:
            
            `tsm start`
            
            Se receber um erro de que o comando não foi reconhecido, feche todas as janelas de comando e abra um prompt de comando como administrador.
7. O processo de atualização deixa suas pastas existentes no lugar. Você pode identificar isso pelo código de versão. Por exemplo:
    
    `C:\Program Files\Tableau\Tableau Server\packages\`

Continue para [Verificar a atualização do Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-verify-ug.htm).

<!-- document id=aa7088cb114574cca520a8231cc638a8ab7ab8e4e0f5b37a65b98957b2d7056f url=/tableau/current/pt-br/server/server-upgrade-baseline-multinode-setup.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização de vários nós - Executar instalação

## Executar a instalação

1. Faça logon no nó inicial com uma conta que seja membro do grupo de administradores locais.
    
    **Observação:** se o Tableau Server usar o Active Directory/LDAP para autenticação, você deverá usar uma conta de domínio ao fazer logon. Usar uma conta de administrador local resultará em erros ao executar o script de atualização.
2. Acesse a pasta na qual você copiou o programa de configuração do Tableau Server e execute-o. Isso instalará a nova versão do Tableau Server lado a lado da versão existente em execução.
3. O programa de instalação verifica os recursos do sistema para confirmar se o computador atende aos requisitos mínimos e às recomendações.
4. O programa de instalação exibe o local da sua versão existente e instalará a nova versão no mesmo local. Não é possível alterar o local de instalação.
5. Quando a instalação for concluída no nó inicial, a última página do programa de instalação o informa que a atualização não foi terminada. Será preciso executar um script de atualização para concluir a atualização. Deixe a janela de instalação aberta no nó inicial e prossiga com a instalação em todos os outros nós no cluster.
    
    **Importante:** você _deve_ instalar a nova versão em cada nó, antes de executar o script de atualização. _Não execute o script de atualização_ até que você tenha instalado a nova versão em todos os nós do cluster.

Continue a [Atualização de vários nós - Executar instalação em cada nó](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-multinode-setup-add-nodes.htm).

<!-- document id=1449d29dff511e7fdde89d02dae53cfa5b59d8c3938ab8fb2a8787b8db86a05c url=/tableau/current/pt-br/server/server-upgrade-baseline-multinode-setup-add-nodes.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização de vários nós - Executar instalação em cada nó

## Executar a instalação

Em cada nó adicional, acesse a pasta na qual você copiou o programa de instalação do Tableau Server e execute-o como fez no nó inicial. Isso instalará a nova versão do Tableau Server em cada nó, lado a lado com a versão existente em execução.

Quando a instalação for concluída em cada nó adicional, a última página do programa de instalação o informa que a atualização não foi terminada. Certifique-se de que a opção Iniciar o script de atualização automaticamente _não_ esteja selecionada e clique em OK para fechar a janela de instalação. Você executará o script de atualização após a nova versão ser instalada em todos os nós.

Continue a [Atualização de vários nós - Executar script de atualização](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-multinode-run-script.htm).

<!-- document id=82beb5a6ee22576633006e6c03dacad4cd1292ff3ba19f28dac71ac9cfeac3a8 url=/tableau/current/pt-br/server/server-upgrade-baseline-multinode-run-script.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização de vários nós - Executar script de atualização

**Observação importante:** em ambientes que usam a autenticação do Active Directory, a conta que executa o script de atualização deve ser um usuário de domínio. Esse usuário também deve ser membro do grupo de administradores locais no nó inicial. Executar o script com uma conta local que não faz parte do domínio resulta em um erro de comunicação do Active Directory.

## Executar o script de atualização

1. Depois de instalar a nova versão _em cada nó do cluster_, execute o script de atualização no nó inicial para concluir a atualização. Se o Tableau Server estiver sendo executado, o script informará isso e perguntará se deve interrompê-lo. O Tableau Server deve ser interrompido para executar o script de atualização.
    
    Se a última tela de instalação ainda estiver aberta, você poderá selecionar Iniciar o script de atualização automaticamente e uma janela de comando será aberta para executar o script. Ou você poderá executar o script diretamente de um prompt de comando.
    
    **Observação:** se o script de atualização falhar, detalhes sobre a falha serão exibidos na janela de comando e você poderá refazer o script para tentar a atualização novamente. O script reinicia no ponto em que falhou. Isso economiza tempo e é um bom começo se o upgrade falhar. Para obter mais informações, consulte [Falhas de atualização](https://help.tableau.com/current/server/pt-br/trouble_install_upgrade.htm#CheckpointUpgradeTroubleshooting).
    
    - Para executar o script de atualização no programa de configuração:
        
        1. Selecione Iniciar o script de atualização automaticamente e clique em OK:
            
            ![Uma caixa de diálogo que indica que a atualização do Tableau Server ainda está em andamento.](/tableau/current/pt-br/server/pt-br/Img/tsm-installer-win_wix-tsm-to-tsm-upgrade-final-runscript.png)
        2. Uma janela de comando será aberta para o script. Como você está conectado como um usuário com direitos de administrador local, o script será executado usando suas credenciais. Se solicitado, digite a senha.
        
        Clicar em OK fechará a caixa de diálogo do programa de instalação. Se você desmarcar a opção para iniciar automaticamente o script de atualização, precisará executá-lo manualmente na linha de comando.
    - Para executar o script de atualização no prompt de comando:
        
        1. Abra um prompt de comando como administrador.
            
            Você deve abrir uma nova janela de comando porque o programa Configuração atualiza o caminho para a nova instalação.
        2. Acesse o diretório de scripts da nova versão que você acabou de instalar.
            
            Como padrão:
            
            `C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`
        3. Execute o script de atualização:
            
            `upgrade-tsm`
            
            Como você está conectado como um usuário com direitos de administrador local, o script será executado usando suas credenciais. Se solicitado, digite a senha. É possível especificar um usuário e senha diferentes ao usar as opções `--username` e `--password`.
            
            Para ver todas as opções para o script upgrade-tsm, use a opção `-h`:
            
            `upgrade-tsm -h`
        
        Levará um tempo para que o script de atualização seja concluído.
2. Quando o script de atualização for concluído, inicie o Tableau Server. Você pode fazer isso na interface do usuário na Web do TSM ou em um prompt de comando:
    
    - No TSM, clique em Tableau Server está parado e Iniciar Tableau Server.:
        
        ![Menu suspenso com a opção Iniciar Tableau Server selecionada.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-start-server.png)
    - Em um prompt de comando:
        
        1. Abra um novo prompt de comando como administrador.
        2. Insira este comando:
            
            `tsm start`

Continue para [Verificar a atualização do Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-verify-ug.htm).

<!-- document id=4205810b7ac207495e14c1c67d3993b50cc956bb2da933e329a7113a3dd091f4 url=/tableau/current/pt-br/server/rmt-admin-upgrade-reference.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do RMT: referência técnica

Esta seção é um guia de referência técnica para os limites operacionais, caminhos do sistema e portas de rede verificados durante o processo de atualização. Use essas tabelas para diagnosticar rapidamente falhas de validação e alinhar seu ambiente com as linhas de base do RMT necessárias.

**Observação**: para nos alinhar com os valores de Igualdade de nossa empresa, atualizamos o RMT Master para o RMT Server. Em alguns casos, os caminhos e comandos de instalação do RMT Server podem usar o termo “master” em vez de “server”. Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## Verificações de integridade pré-atualização

A verificação de integridade pré-atualização inspeciona seu host do RMT Server ou Agent enquanto a instalação existente ainda está intacta, como serviços em execução, banco de dados acessível e gera um relatório detalhado PASS/FAIL/WARN. Ele executa mais de 80 verificações individuais em recursos do sistema, contas, permissões de arquivo, PostgreSQL, RabbitMQ, rede, arquivos de configuração e serviços RMT. A tabela a seguir lista as verificações realizadas antes da atualização. Se algum item retornar um status **FAIL** (Código de saída 2), a atualização será cancelada.

### Sistema e hardware

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 158px;"><col style="width: 23%;"><col style="width: 23%;"><col style="width: 438px;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Nome </strong></td><td><b>Plataformas</b></td><td style="text-align: center;"><strong>Condição de falha (FAIL)/aviso (WARN)</strong></td></tr><tr><td>Nº 1</td><td style="text-align: center;">Sistema operacional</td><td>Linux, Windows</td><td style="text-align: center;"><b>WARN</b> A versão do sistema operacional não está na lista de permissões pré-verificação. A lista suportada é RHEL 8.x/9.x, Ubuntu 20.04/22.04/24.04, CentOS Stream 8/9, Oracle Linux 8.x/9.x, AlmaLinux 8.x/9.x, Rocky Linux 8.x/9.x, Amazon Linux 2023 e Windows Server 2019/2022</td></tr><tr><td>Nº 2</td><td style="text-align: center;">Espaço em disco</td><td>Linux, Windows</td><td style="text-align: center;"><b>FAIL</b> RMT Server &lt; 20 GB ou Agent &lt; 5 GB livres. <b>WARN</b> RMT Server &lt; 50 GB ou Agent &lt; 10 GB livres</td></tr><tr><td>Nº 2a</td><td style="text-align: center;">Tipo de disco</td><td>Linux, Windows</td><td style="text-align: center;"><b>INFO</b> Informa se a unidade é SSD ou HDD</td></tr><tr><td>Nº 3</td><td style="text-align: center;"><p>RAM</p></td><td>Linux, Windows</td><td style="text-align: center;"><b>WARN</b> RMT Server &lt; 8 GB (mínimo) ou Agent &lt; 4 GB (mínimo)</td></tr><tr><td>Nº 4</td><td style="text-align: center;">Núcleos de CPU</td><td>Linux, Windows</td><td style="text-align: center;"><b>WARN</b> RMT Server &lt; 8 GB (mínimo) ou Agent &lt; 4 GB (mínimo)</td></tr><tr><td>Nº 4a</td><td style="text-align: center;">Instruções de CPU</td><td>Linux, Windows</td><td style="text-align: center;"><b>FAIL</b> (Linux): sse4_2 ou popcnt ausentes. <b>WARN</b> (Windows): CPU mais antiga detectada.</td></tr><tr><td>#4b</td><td style="text-align: center;">VC++ Redist</td><td>Windows</td><td style="text-align: center;"><b>FAIL</b> Visual Studio 2022 C++ Redistributable ausente.</td></tr><tr><td>#4c</td><td style="text-align: center;">OpenSSL DLLs</td><td>Windows</td><td style="text-align: center;"><b>INFO</b> Verifica libcrypto-3-x64.dll e libssl-3-x64.dll</td></tr><tr><td>Nº 5</td><td style="text-align: center;">Tempo de atividade do sistema</td><td>Linux, Windows</td><td style="text-align: center;font-weight: bold;">INFO: <span style="font-weight: normal;">Nota se &lt; 10 minutos (reboot bastante recente) ou &gt; 90 dias (patches pendentes)</span></td></tr><tr><td>Nº 6</td><td style="text-align: center;">Systemd em execução</td><td>Linux</td><td style="text-align: center;"><b>FAIL</b> systemd não está em execução, <b>PASS</b>: em execução ou degradado</td></tr><tr><td>Nº 7</td><td style="text-align: center;">Modo FIPS</td><td>Linux, Windows</td><td style="text-align: center;"><b>FAIL</b> (Windows): habilitado no registro, <b>PASS </b>FIPS desabilitado. <b>WARN</b> (Linux) Incompatibilidade com config.json. <b>PASS</b> Correspondência entre SO e configuração</td></tr><tr><td>Nº 7a</td><td style="text-align: center;">Versão do PowerShell</td><td>Windows</td><td style="text-align: center;"><b>INFO</b> <span style="font-weight: normal;">Versão do PowerShell</span></td></tr><tr><td>#7b</td><td style="text-align: center;">Localidade do sistema</td><td>Windows</td><td style="text-align: center;"><b>INFO</b> <span style="font-weight: normal;">Informações de localidade do sistema</span></td></tr><tr><td>#7c</td><td style="text-align: center;">Integridade do WMI</td><td>Windows</td><td style="text-align: center;"><b>WARN</b> O repositório WMI é inconsistente</td></tr></tbody></table>

### Contas e permissões

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 161px;"><col style="width: 23%;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td><b>Plataforma</b></td><td style="text-align: center;"><strong>Condição de falha (FAIL)/aviso (WARN)</strong></td></tr><tr><td>Nº 8</td><td style="text-align: center;">Conta de serviço</td><td>Linux, Windows</td><td style="text-align: center;"><b>FAIL</b> Conta de serviço do RMT ou serviço do Windows não encontrado</td></tr><tr><td>Nº 9</td><td style="text-align: center;">Associação ao grupo</td><td>Linux</td><td style="text-align: center;"><b>FAIL</b> Grupos de serviço necessários (por exemplo, rmtmasterapp, rmtmasterconfig e assim por diante) ausentes</td></tr><tr><td>Nº 10</td><td style="text-align: center;">Usuário Systemd</td><td>Linux</td><td style="text-align: center;"><b>FAIL</b> O usuário systemd daemon/linger não está ativo</td></tr><tr><td>Nº 44</td><td style="text-align: center;">pamtester instalado</td><td>Linux</td><td style="text-align: center;"><b>WARN</b> se não estiver instalado. Para corrigir isso, instale <code>yum install pamtester</code> ou <code>apt install libpam-runtime</code></td></tr></tbody></table>

#### Propriedade de diretório e permissões para Linux

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"><col style="width: 21%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Diretório</strong></td><td style="font-weight: bold;">Expected Owner:Group</td><td style="text-align: center;font-weight: bold;">Modo esperado</td></tr><tr><td>Nº 11</td><td style="text-align: center;">Config dir</td><td>tabrmt-master:rmtmasterconfig</td><td style="text-align: center;">2775</td></tr><tr><td>Nº 12</td><td style="text-align: center;">Log dir</td><td>tabrmt-master:rmtmasterlogs</td><td style="text-align: center;">2775</td></tr><tr><td>Nº 13</td><td style="text-align: center;">Data dir (+ PG/RMQ subdirs)</td><td>Component-appropriate</td><td style="text-align: center;">2775</td></tr><tr><td>Nº 14</td><td style="text-align: center;">Prerequisites dirs</td><td><code>root</code> ou usuário do componente</td><td style="text-align: center;">755</td></tr><tr><td>Nº 14a</td><td style="text-align: center;">Arquivo <code>rabbitmq-defaults</code></td><td>Group-writable necessário</td><td style="text-align: center;">g+w</td></tr><tr><td>Nº 15</td><td style="text-align: center;">SSL cert dir</td><td>tabrmt-master:rmtopenssl</td><td style="text-align: center;">2775</td></tr><tr><td>Nº 15a</td><td style="text-align: center;">Home directory</td><td>Usuário do componente</td><td style="text-align: center;">770</td></tr><tr><td>#15b</td><td style="text-align: center;"><code>/etc/profile.d/tabrmt-*.sh</code></td><td>root</td><td style="text-align: center;">padrão</td></tr><tr><td>#15c</td><td style="text-align: center;">Config dir setgid bit</td><td>--</td><td style="text-align: center;">2xxx obrigatório</td></tr><tr><td>Nº 16</td><td style="text-align: center;"><code>environment.bash</code></td><td>Usuário do componente</td><td style="text-align: center;">group-writable</td></tr></tbody></table>

Gravidade: **FAIL** na propriedade apenas para o conjunto de diretório de dados (Nº 13 e Nº 15). Todas as outras verificações do diretório Linux (Nº 11, Nº 12, Nº 14, Nº 14a, Nº 15a–c, Nº 16) emitem **WARN** sobre incompatibilidades de propriedade/modo porque a pós-instalação do instalador reaplica a propriedade durante a atualização. **WARN** se o modo de permissão estiver incorreto, mas a propriedade estiver correta.

#### Propriedade de diretório e permissões para Windows

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>Verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td style="font-weight: bold;">Gravidade</td></tr><tr><td>Nº 11</td><td style="text-align: center;">Config dir ACLs</td><td><b>FAIL</b> se o usuário do serviço não tiver FullControl</td></tr><tr><td>Nº 12</td><td style="text-align: center;">Log dir ACLs</td><td><b>FAIL</b> se o usuário de serviço não tiver Modify</td></tr><tr><td>Nº 13</td><td style="text-align: center;">Data dir ACLs (RMT Server)</td><td><b>FAIL</b> se o usuário do serviço não tiver FullControl nos diretórios de dados PG/RMQ</td></tr><tr><td>Nº 14</td><td style="text-align: center;">Prereqs dir ACLs (RMT&nbsp;Server)</td><td><b>WARN</b> se não tiver ReadAndExecute (aviso: cada atualização reinstala os MSIs prereq e suas ações pós-instalação reaplicam ACLs)</td></tr><tr><td>Nº 15</td><td style="text-align: center;">SSL cert dir ACLs (RMT&nbsp;Server)</td><td><b>FAIL</b> se o usuário do serviço não tiver FullControl</td></tr><tr><td>Nº 16a</td><td style="text-align: center;">Identidade do usuário de serviço</td><td><b>PASS</b> (informativo: mostra como usuário o serviço é executado)</td></tr><tr><td>#16b</td><td style="text-align: center;">Privilégio SeServiceLogonRight</td><td><b>INFO</b> se encontrado; <b>WARN</b> se não for encontrado ou se secedit falhar</td></tr><tr><td>#16c</td><td style="text-align: center;">ACLs do usuário de serviço em dirs do RMT</td><td><b>FAIL</b> se o usuário do serviço não tiver os direitos necessários</td></tr></tbody></table>

### Banco de dados (PostgreSQL)

Todas as verificações de PostgreSQL executam apenas no RMT Server.

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 233px;"><col style="width: 23%;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td><b>Requer a opção --</b><code style="font-weight: bold;">db-password</code></td><td style="text-align: center;"><strong>Condição de falha (FAIL)/aviso (WARN)</strong></td></tr><tr><td>Nº 17</td><td style="text-align: center;">Serviço PG</td><td>Não</td><td style="text-align: center;"><b>FAIL</b> Serviço local interrompido E desativado</td></tr><tr><td>Nº 18</td><td style="text-align: center;">Porta 5555 escutando</td><td>Não</td><td style="text-align: center;"><b>WARN</b> (grupo de seguranço/VPC / RDS) Não está ouvindo</td></tr><tr><td>Nº 19</td><td style="text-align: center;">DB Connection</td><td>Sim</td><td style="text-align: center;"><b>WARN</b> Não é possível se conectar ao banco de dados interno (erro de SSL, senha ou rede)</td></tr></tbody></table>

### Mensagens (RabbitMQ)

As verificações de mensagens (RabbitMQ) são executadas somente no RMT Server.

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 234px;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td style="text-align: center;"><strong>Condição de falha (FAIL)/aviso (WARN)</strong></td></tr><tr><td>Nº 22</td><td style="text-align: center;">Serviço RMQ</td><td style="text-align: center;"><b>FAIL</b> Serviço local interrompido E desativado</td></tr><tr><td>Nº 24</td><td style="text-align: center;">Fila de pendências</td><td style="text-align: center;"><b>WARN</b> Qualquer fila que tenha &gt; 10.000 mensagens</td></tr><tr><td>Nº 25</td><td style="text-align: center;">Usuários do RabbitMQ</td><td style="text-align: center;"><b>WARN</b> se o usuário padrão <code>guest</code> ainda existir</td></tr><tr><td>Nº 26</td><td style="text-align: center;">Conexões ativas</td><td style="text-align: center;"><b>INFO</b> somente. Relata o número de conexões ativas</td></tr><tr><td>Nº 27</td><td style="text-align: center;">Erlang cookie acessível</td><td style="text-align: center;"><b>WARN</b> se o arquivo de cookie estiver ausente, se as permissões estiverem erradas (deve ser o modo 400 ou 600)</td></tr><tr><td>Nº 27a</td><td style="text-align: center;">Conjunto ERLANG_HOME</td><td style="text-align: center;"><b>WARN</b> (Windows somente) se “ERLANG_HOME” não estiver definido ou se o caminho não existir.</td></tr><tr><td>#27b</td><td style="text-align: center;">Validade de SSL</td><td style="text-align: center;"><b>FAIL</b> Os certificados expiraram</td></tr><tr><td>#27c</td><td style="text-align: center;">Alarme de disco</td><td style="text-align: center;"><b>FAIL</b> &lt; 10 GB livres na partição RMQ (A atualização travará)</td></tr><tr><td>Nº 45</td><td style="text-align: center;">Diretório de certificados preenchido</td><td style="text-align: center;"><b>WARN</b> se cert dir existir, mas estiver vazio ou ausente arquivos de certificado esperados (server cert, key, CA cert)</td></tr></tbody></table>

### Rede e configuração

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 245px;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td style="text-align: center;"><strong>Condição de falha (FAIL)/aviso (WARN)</strong></td></tr><tr><td>Nº 28a/b</td><td style="text-align: center;">Comunicações Agent-Master</td><td style="text-align: center;"><b>WARN</b> O Agent não pode entrar em contato com o Master em 5671, 5672, 80 ou 443</td></tr><tr><td>Nº 33-35</td><td style="text-align: center;">JSON/Bash Config</td><td style="text-align: center;"><b>FAIL</b> config.json, setup.json ou environment.bash ausentes ou inválidos</td></tr><tr><td>Nº 36a</td><td style="text-align: center;">Versão conhecida e inválida</td><td style="text-align: center;"><b>FAIL</b> A versão atual é 2025.3.0 (Atualização de blocos de regressão)</td></tr></tbody></table>

### Serviços e backup

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 215px;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td style="text-align: center;"><strong>Condição de falha (FAIL)/aviso (WARN)</strong></td></tr><tr><td>Nº 38</td><td style="text-align: center;">Todos os serviços RMT em execução</td><td style="text-align: center;"><b>WARN</b> para cada serviço interrompido</td></tr><tr><td>Nº 38a</td><td style="text-align: center;">Processos encalhados</td><td style="text-align: center;"><b>FAIL</b> Processos tabrmt-* persistentes encontrados após a interrupção dos serviços</td></tr><tr><td>Nº 39</td><td style="text-align: center;">Processador em execução em segundo plano</td><td style="text-align: center;"><b>WARN</b> se o processo do host não estiver em execução</td></tr><tr><td>Nº 40</td><td style="text-align: center;">Lembrete de backup antes da atualização</td><td style="text-align: center;"><b>WARN</b> como lembrete para fazer backup da configuração antes de atualizar</td></tr><tr><td>Nº 41</td><td style="text-align: center;">Topologia</td><td style="text-align: center;"><b>INFO</b> somente. Relata o tipo de nó Master/Agent e (com banco de dados) o número de agentes ativos</td></tr><tr><td>Nº 42</td><td style="text-align: center;">Inventário de versão de componente</td><td style="text-align: center;"><b>INFO</b> somente. Relatórios sobre RMT, versões do PostgreSQL, RabbitMQ, OpenSSL</td></tr><tr><td>Nº 43</td><td style="text-align: center;">Resumo das especificações da máquina</td><td style="text-align: center;"><b>INFO</b> somente. Relatórios sobre SO, núcleos de CPU, RAM, espaço livre em disco</td></tr></tbody></table>

## Verificações de integridade pós-atualização

Essas verificações são executadas após a atualização. Eles não bloqueiam nada, e falhas não interrompem a atualização, mas indicam problemas pós-instalação.

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"><col style="width: 21%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>ID de verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td><b>Componente</b></td><td style="text-align: center;"><strong>Condição de falha (FAIL)/aviso (WARN)</strong></td></tr><tr><td>Nº 1a-d</td><td style="text-align: center;">Serviços e processos</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>FAIL</b> Os serviços Main, PG ou RMQ não estão em execução</td></tr><tr><td>Nº 2</td><td style="text-align: center;">Supervisor do processo de host</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>WARN</b> Processo do supervisor de host ausente (sem recuperação automática)</td></tr><tr><td>Nº 3a-b</td><td style="text-align: center;">Integridade do arquivo de configuração</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>FAIL</b> se houver JSON ausente ou inválido</td></tr><tr><td>Nº 4a-b</td><td style="text-align: center;">Permissões de arquivos</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>FAIL</b> Config/Log dirs não legíveis/graváveis por conta de serviço</td></tr><tr><td>Nº 5a-d</td><td style="text-align: center;">Escuta de porta</td><td>RMT&nbsp;Server</td><td style="text-align: center;"><b>FAIL</b> Web (443), AMQP (5672) ou DB (5555) não escutam</td></tr><tr><td>Nº 6</td><td style="text-align: center;">Conectividade PostgreSQL</td><td>RMT&nbsp;Server</td><td style="text-align: center;"><b>FAIL</b> PostgreSQL não aceita conexões</td></tr><tr><td>Nº 7</td><td style="text-align: center;">Status do RabbitMQ</td><td>Servidor RMT</td><td style="text-align: center;"><b>SKIP</b> se externo. <b>FAIL</b> após todas as novas tentativas esgotadas.</td></tr><tr><td>Nº 8a</td><td style="text-align: center;">Consumidores da fila</td><td>RMT&nbsp;Server</td><td style="text-align: center;"><b>WARN</b> Existe uma lista de pendências, mas não há consumidores ativos (trabalhadores Master, desconectados)</td></tr><tr><td>Nº 9</td><td style="text-align: center;">Alarmes RMQ</td><td>RMT&nbsp;Server</td><td style="text-align: center;"><b>FAIL</b> Alarmes de memória ativa ou recursos de disco detectados</td></tr><tr><td>Nº 10</td><td style="text-align: center;">Certificado SSL RabbitMQ</td><td>Servidor RMT</td><td style="text-align: center;"><b>FAIL</b> se o certificado expirou. <b>WARN</b> se os certificados expirarem dentro de 30 dias</td></tr><tr><td>Nº 11</td><td style="text-align: center;">Correspondência FIPS</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>FAIL</b> Incompatibilidades de estado FIPS do OS com configuração habilitada isFIPSEnabled</td></tr><tr><td>Nº 12</td><td style="text-align: center;">Resposta HTTP do servidor da Web</td><td>Servidor RMT</td><td style="text-align: center;">Faz o GET HTTP para “https://localhost:&lt;port&gt;/authentication/login”. <b>PASS</b> em 200 ou 302. <b>FAIL</b> se conexão recusada/estourar tempo limite. <b>WARN</b> sobre outros erros.</td></tr><tr><td>Nº 13</td><td style="text-align: center;">Validade do certificado HTTPS</td><td>RMT&nbsp;Server</td><td style="text-align: center;"><b>FAIL</b> O certificado TLS do servidor da Web expirou</td></tr><tr><td>Nº 14a-d</td><td style="text-align: center;">Espaço em disco</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>FAIL</b> &lt; 1 GB free. <b>WARN: </b>&lt; 5 GB free</td></tr><tr><td>Nº 15</td><td style="text-align: center;">Erros de log recentes</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>FAIL</b> Erros FATAL nos logs. <b>WARN</b>: ERROS CRÍTICOS</td></tr><tr><td>Nº 16</td><td style="text-align: center;">Status do RMT</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>FAIL</b> <code>rmtadmin</code> status retorna padrões de falha</td></tr><tr><td>Nº 17</td><td style="text-align: center;">Histórico de log do Agent</td><td>Agent</td><td style="text-align: center;">Verifica os arquivos de rastreamento de log (<code>.history, .json</code>) no diretório de dados do agente. <b>WARN</b> se os arquivos estiverem ilegíveis ou corrompidos</td></tr><tr><td>Nº 18a-f</td><td style="text-align: center;">Versão do inventário</td><td>RMT&nbsp;Server, Agent</td><td style="text-align: center;"><b>INFO</b> sobre versão do RMT, versão do PostgreSQL, versão do RabbitMQ, versão do Erlang/OTP, .NET Runtime (Windows)/OS (Linux), versão do OS (Windows)/Kernel (Linux)</td></tr></tbody></table>

## Códigos de saída da verificação de integridade

Use os códigos de saída a seguir para interpretar os resultados dos scripts de verificação de integridade pré e pós-atualização.

### Scripts pré-atualização

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"><col style="width: 421px;"></colgroup><tbody><tr><td><b>Código de saída</b></td><td style="text-align: center;"><strong>Status</strong></td><td><b>Comportamento da atualização</b></td></tr><tr><td>0</td><td style="text-align: center;">READY TO UPGRADE</td><td>Atualização continua</td></tr><tr><td>1</td><td style="text-align: center;">UPGRADE&nbsp;WITH&nbsp;CAUTION</td><td>Atualização continua; revisar avisos</td></tr><tr><td>2</td><td style="text-align: center;">Do not upgrade</td><td>Atualização cancelada</td></tr><tr><td>3</td><td style="text-align: center;">Script Error</td><td>Verificar o ambiente de execução</td></tr></tbody></table>

### Scripts pós-atualização

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 669px;"></colgroup><tbody><tr><td style="font-weight: bold;">Código de saída</td><td style="text-align: center;"><strong>Status</strong></td></tr><tr><td>0</td><td style="text-align: center;">ALL PASSED</td></tr><tr><td>1</td><td style="text-align: center;">WARNINGS PRESENT</td></tr><tr><td>2</td><td style="text-align: center;">CRITICAL FAILURES</td></tr></tbody></table>

## Alterações de gravidade do InstallerContext

Quando executadas com `-InstallerContext` durante atualizações MSI de Windows automáticas, as verificações a seguir se comportam de maneira diferente do padrão manual. O comportamento padrão (sem InstallerContext) \*já\* é WARN para os estados “stopped but not Disabled” / “port not listening”; FAIL está reservado para “Stopped+Disabled”. Em “-`InstallerContext`”, até mesmo a ramificação “Desativada” é relatada como WARN para que uma atualização em andamento orientada pelo instalador nunca seja vetada por um estado transitório que o instalador está prestes a corrigir.

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"><col style="width: 21%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>Verificação</b></td><td style="text-align: center;"><strong>Nome</strong></td><td><b>Padrão</b></td><td style="text-align: center;"><strong>InstallerContext</strong></td></tr><tr><td>Nº 17</td><td style="text-align: center;">Serviço PG</td><td><b>WARN</b> se parado, <b>FAIL</b> se parado e desativado, <b>INFO</b> se tudo parou</td><td style="text-align: center;">WARN</td></tr><tr><td>Nº 18</td><td style="text-align: center;">Porta PG</td><td><b>WARN</b> se não estiver ouvindo, <b>INFO</b> se todos os serviços estiverem parados</td><td style="text-align: center;">WARN</td></tr><tr><td>Nº 22</td><td style="text-align: center;">Serviço RabbitMQ</td><td><b>WARN</b> se Stopped, <b>FAIL</b> se Stopped+Disabled, <b>INFO</b> se tudo parou</td><td style="text-align: center;">WARN</td></tr><tr><td>Nº 23</td><td style="text-align: center;">Port 5672 (AMQP)</td><td><b>WARN</b> se não estiver ouvindo, <b>INFO</b> se todos os serviços estiverem parados</td><td style="text-align: center;">WARN</td></tr><tr><td>Nº 38a</td><td style="text-align: center;">Processos do RMT encalhados</td><td>(ver descrição da verificação)</td><td style="text-align: center;">SKIP (instalador gerencia o ciclo de vida do processo)</td></tr></tbody></table>

### Limites pré-atualização

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"><col style="width: 21%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>Limite</b></td><td style="text-align: center;"><strong>RMT&nbsp;Server</strong></td><td style="font-weight: bold;">Agent</td><td style="text-align: center;font-weight: bold;">Unidade</td></tr><tr><td>Espaço em disco FAIL</td><td style="text-align: center;">20</td><td>5</td><td style="text-align: center;">GB livres</td></tr><tr><td>Espaço em disco WARN</td><td style="text-align: center;">50</td><td>10</td><td style="text-align: center;font-weight: bold;"><span style="font-weight: normal;">GB livres</span></td></tr><tr><td>Temp dir FAIL</td><td style="text-align: center;">5</td><td>5</td><td style="text-align: center;">GB livres</td></tr><tr><td>Temp dir WARN</td><td style="text-align: center;">10</td><td>10</td><td style="text-align: center;font-weight: bold;"><span style="font-weight: normal;">GB livres</span></td></tr><tr><td>FALHA NA RAM</td><td style="text-align: center;">8</td><td>4</td><td style="text-align: center;font-weight: bold;"><span style="font-weight: normal;">GB</span></td></tr><tr><td>RAM WARN</td><td style="text-align: center;">16</td><td>8</td><td style="text-align: center;font-weight: bold;"><span style="font-weight: normal;">GB</span></td></tr><tr><td>CPU&nbsp;FAIL</td><td style="text-align: center;">4</td><td>2</td><td style="text-align: center;">núcleos</td></tr><tr><td>CPU&nbsp;WARN</td><td style="text-align: center;">8</td><td>4</td><td style="text-align: center;">núcleos</td></tr><tr><td>Tamanho do banco de dados FAIL</td><td style="text-align: center;">500</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>Tamanho do banco de dados WARN</td><td style="text-align: center;">200</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>Esquema Hangfire FAIL</td><td style="text-align: center;">10</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>Esquema Hangfire WARN</td><td style="text-align: center;">1</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>WAL dir FAIL (Windows)</td><td style="text-align: center;">10</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>WAL dir FAIL (Windows)</td><td style="text-align: center;">2</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>WAL dir FAIL (Linux)</td><td style="text-align: center;">10</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>Mnesia dir WARN</td><td style="text-align: center;">5</td><td>-</td><td style="text-align: center;">GB</td></tr><tr><td>Alarme de disco RabbitMQ FAIL</td><td style="text-align: center;">10</td><td>-</td><td style="text-align: center;">GB livres</td></tr><tr><td>Fila de pendências WARN</td><td style="text-align: center;">10.000</td><td>-</td><td style="text-align: center;">mensagens</td></tr><tr><td>Expiração do certificado WARN</td><td style="text-align: center;">30</td><td>30</td><td style="text-align: center;">dias</td></tr><tr><td>Retenção de limpeza WARN</td><td style="text-align: center;">180</td><td>-</td><td style="text-align: center;">dias</td></tr><tr><td>Proporção de tupla morta WARN</td><td style="text-align: center;">20</td><td>-</td><td style="text-align: center;">por cento</td></tr><tr><td>Batimento cardíaco obsoleto do Agent</td><td style="text-align: center;">15</td><td>-</td><td style="text-align: center;">minutos</td></tr><tr><td>Idade do driver de rede WARN</td><td style="text-align: center;">3</td><td>-</td><td style="text-align: center;">anos</td></tr><tr><td>Log dir size WARN</td><td style="text-align: center;">5</td><td>5</td><td style="text-align: center;">GB</td></tr><tr><td>Log dir size WARN (grave)</td><td style="text-align: center;">20</td><td>20</td><td style="text-align: center;">GB</td></tr></tbody></table>

### Limites pós-atualização

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 207px;"><col style="width: 23%;"><col style="width: 421px;"></colgroup><tbody><tr><td style="font-weight: bold;">Limite</td><td style="text-align: center;font-weight: bold;"><strong>Valor</strong></td><td style="font-weight: bold;">Unidade</td></tr><tr><td>Espaço em disco FAIL</td><td style="text-align: center;">1</td><td>GB livres</td></tr><tr><td>Espaço em disco WARN</td><td style="text-align: center;">5</td><td>GB livres</td></tr><tr><td>Expiração do certificado WARN</td><td style="text-align: center;">30</td><td>dias</td></tr><tr><td>Fila de pendências WARN</td><td style="text-align: center;">10.000</td><td>mensagens</td></tr><tr><td>Janela de varredura de log</td><td style="text-align: center;">60</td><td>minutos</td></tr><tr><td>Tentar novamente a inicialização do RabbitMQ</td><td style="text-align: center;">6 tentativas x 5 seg</td><td>30 segundos no total</td></tr></tbody></table>

## Versões mínimas de componentes suportadas

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"></colgroup><tbody><tr><td style="font-weight: bold;">Componente</td><td style="text-align: center;font-weight: bold;"><strong>Versão mínima</strong></td></tr><tr><td>RabbitMQ</td><td style="text-align: center;">&gt;= 3.10.10</td></tr><tr><td>Versão do Agent</td><td style="text-align: center;">&gt;= 2023.1.0</td></tr></tbody></table>

### Automação e integração de CI/CD

**No Linux:**

\`\`\`base  
\# Linux  
sudo bash rmt-pre-upgrade-check.sh --component master --db-password "$DB\_PASSWORD"  
EXIT\_CODE=$?  
if \[ $EXIT\_CODE -eq 2 \]; then  
echo "BLOCKED: Fix critical issues before upgrading"  
exit 1  
fi  
\`\`\`

**No Windows:**

\`\`\`powershell  
\# Windows  
.\\rmt-pre-upgrade-check.ps1 -Component master  
if ($LASTEXITCODE -eq 2) {  
Write-Error "BLOCKED: Fix critical issues before upgrading"  
exit 1  
}  
\`\`\`

## Referência sobre diretório de instalação

Para invocar manualmente os utilitários de diagnóstico subjacentes ou verificar sua estrutura de instalação, consulte os caminhos de diretório específicos da plataforma:

### Estrutura de diretórios do Linux

\`\`\`

`/opt/tableau/tabrmt/ # Install root`

+`-- master/ # Master application binaries`

`+-- agent/ # Agent application binaries`

`+-- prerequisites/ # Bundled dependencies`

`/var/opt/tableau/tabrmt/ # Data root`

`+-- master/config/ # config.json, setup.json`

`+-- master/logs/ # Application logs`

`+-- data/postgresql15/ # PostgreSQL data files`

`+-- data/rabbitmq313/ # RabbitMQ data/mnesia`

`+-- data/ssl/ # TLS certificates`

`/etc/opt/tableau/tabrmt/`

`+-- master/environment.bash # Master environment variables`

`+-- agent/environment.bash # Agent environment variables`

\`\`\`

### Estrutura de diretórios do Windows

\`\`\`

`C:\Program Files\Tableau\Tableau Resource Monitoring Tool\ # Install root`

`C:\ProgramData\Tableau\Tableau Resource Monitoring Tool\ # Data root`

\`\`\`

### Portas de rede necessárias

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 136px;"><col style="width: 23%;"><col style="width: 421px;"></colgroup><tbody><tr><td><b>Porta</b></td><td style="text-align: center;"><strong>Serviço</strong></td><td><b>Direção</b></td></tr><tr><td>80</td><td style="text-align: center;">Interface do usuário da Web do RMT (HTTP)</td><td>Entrada</td></tr><tr><td>443</td><td style="text-align: center;">Interface do usuário da Web do RMT (HTTPS)</td><td>Entrada</td></tr><tr><td>5672</td><td style="text-align: center;">RabbitMQ AMQP</td><td>Entrada no RMT Server</td></tr><tr><td>5671</td><td style="text-align: center;">RabbitMQ AMQP sobre TLS</td><td>Entrada no RMT Server</td></tr><tr><td>15672</td><td style="text-align: center;">Interface do usuário de gerenciamento do RabbitMQ</td><td>Local</td></tr><tr><td>25672</td><td style="text-align: center;">Nó interno do RabbitMQ</td><td>Local</td></tr><tr><td>5555</td><td style="text-align: center;">PostgreSQL interno</td><td>Local</td></tr></tbody></table>

<!-- document id=a932b7556698755c313f800f4e8ee2f44c5b2564192a27eeeeee23d67aa52388 url=/tableau/current/pt-br/server/server-upgrade-prepare-backup.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do Server - Backup do Tableau Server

Recomendamos _fortemente_ que você faça um backup da instalação do Tableau Server antes de começar o processo de atualização. Um backup feito antes de iniciar a atualização fornece os dados necessários para configurar uma versão de teste do ambiente atualizado e também oferece a capacidade de recuperação, se o processo de atualização falhar. Os backups não são uma etapa de inclusão durante as atualizações, exceto quando a atualização inclui uma atualização de versão secundária para PostGRES e, em seguida, uma atualização somente pg é criada para uso interno durante a atualização.

**Observações:** 

- Recomendamos desabilitar as inscrições e o agendamento em seu ambiente de produção imediatamente antes de fazer o backup e habilitá-los novamente depois da conclusão do backup. Fazer isso ajudará a evitar que seus usuários recebam inscrições e mensagens de e-mail duplicadas quando o backup é restaurado no ambiente de teste.
- Um backup completo pode levar um tempo significativo, se a instalação for grande ou tiver muitas extrações.
- Quaisquer alterações feitas entre o momento em que o backup foi feito e o momento da atualização serão perdidas, pois não estarão inclusas no backup.
- [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm).

Para fazer backup dos dados de configuração do servidor, use o comando `tsm settings`.

Ao usar o comando `tsm maintenance backup`, a data atual é anexada ao arquivo de backup:

tsm maintenance backup -f <backup\_file> -d

Para obter mais informações, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm).

Continue a [Atualização do servidor - Baixar instalação](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare-download-setup.htm).

<!-- document id=dc252fb2dd8bd1240d5df1ba0770acd45d34e81b3d34d8fca89bc2a558194268 url=/tableau/current/pt-br/server/server-upgrade-prepare-download-setup.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do servidor - Baixar instalação

Você deve baixar e copiar o programa de instalação do Tableau Server para o computador no qual o Tableau Server está em execução. Se você estiver executando uma implantação de vários nós do Tableau Server, copie o programa de Instalação em cada nó do cluster.

Para obter a versão mais recente do software Tableau Server, vá para o [Portal do Cliente](http://customer.tableau.com/). Ao adquirir o Tableau, você recebe um nome de usuário e senha para entrar no Portal do Cliente.

**Importante**: baixe e instale sempre a versão de manutenção mais recente da versão para a qual você está atualizando.

Continue para [Como funciona a atualização do Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-how-upgrade-works.htm).

<!-- document id=93ac42aba5cbe99873c45f86038a7ce619544998bb53707a2cb3dfb982ebb271 url=/tableau/current/pt-br/server/server-upgrade-prepare-gather-config.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do servidor - coletar detalhes de configuração

Se estiver executando uma atualização no local (não está atualizando o hardware como parte da atualização), então quase todos os dados de configuração serão preservados. A rigor, não é necessário coletar todas as informações de configuração nesse caso. No entanto, recomendamos coletar as informações conforme detalhado neste tópico. No pior cenário, caso a atualização falhe, então você terá um registro de todas as informações de configuração, caso precise restaurar. De qualquer forma, você pode usar os detalhes de configuração coletados para verificar a atualização quando concluída.

## Tirar capturas de tela

Uma maneira relativamente rápida de capturar as noções básicas da configuração é tirar capturas de tela das páginas da interface na Web do TSM e da área de administração do Tableau Server.

Clique em todas as páginas visíveis e tire capturas de tela:

- [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm)
- [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm)

## Contagem de objetos de registro

Quando estiver na área administrativa do Tableau Server, conte e registre o seguinte em cada site:

- Projetos, pastas de trabalho, exibições e fontes de dados
- Usuários e grupos

## Reunir arquivos de ativo

Muitos dos arquivos de apoio (certificados, metadados de IdP, logotipos etc) que você carrega no Tableau Server não são acessíveis com o TSM depois de carregá-los. Especificamente, os arquivos carregados e gerenciados pelo Serviço de arquivos do cliente são renomeados e ofuscados antes de serem distribuídos pela implantação. Esse processo também parametriza os atributos de arquivo exigidos pelos serviços do Tableau. Como resultado, os arquivos não são mapeados para um único local de arquivo no sistema de arquivos dos seguintes arquivos. Se tiver carregado qualquer um dos seguintes arquivos, certifique-se de ter cópias salvas do computador que está executando o Tableau Server:

- Arquivo de certificado SAML
- Arquivo-chave SAML
- Arquivo de metadados IdP SAML
- OpenID.static.file
- Arquivo Kerberos.keytab
- Arquivo keytab do Kerberos LDAP
- Arquivo de conf. Kerberos LDAP
- Arquivo de certificado SSL mútuo
- Arquivo de revogação SSL mútuo
- Arquivo de logotipo do cabeçalho de personalização
- Arquivo de logotipo de logon de personalização
- Arquivo de logotipo compacto de personalização

## Reunir informações de configuração personalizadas

Algumas informações de configuração não são exibidas nas páginas da Web do TSM ou do Tableau Server. Esta seção inclui detalhes de configuração que você pode precisar coletar dependendo de como personalizou sua implantação do Tableau.

### SMTP seguro

Se tiver configurado O TLS para Tableau Server, então precisará gravar as configurações relacionadas ao TLS, que não estão incluídas na configuração do Servidor de e-mail da Interface na Web do TSM.

Para coletar as configurações relacionadas ao TLS, execute `tsm configuration get` com os seguintes valores principais:

- `svcmonitor.notification.smtp.ssl_enabled`
- `svcmonitor.notification.smtp.ssl_required`
- `svcmonitor.notification.smtp.ssl_check_server_identity`
- `svcmonitor.notification.smtp.ssl_trust_all_hosts`
- `svcmonitor.notification.smtp.ssl_ciphers`
- `svcmonitor.notification.smtp.ssl_versions`

Por exemplo, para recuperar a lista de cifras configuradas para SMTP TLS, execute o seguinte comando:

tsm configuration get -k svcmonitor.notification.smtp.ssl\_ciphers

Encontrar mais informações sobre cada uma das chaves acima na seção da CLI do TSM da [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

### Extensões do Analytics

Se tiver configurado extensões do Analytics (antes chamadas de serviços externos), precisará registrar as informações de configuração. A atualização para o Tableau Server 2020.2 ou posterior removerá toda a configuração deste recurso.

Para recuperar a configuração de extensões do Analytics das versões do Tableau Server 2019.1 até 2020.1, execute o seguinte comando:

tsm security vizql-extsvc-ssl list

Para recuperar a senha armazenada para a conexão de extensões do Analytics (se houver), execute o comando tsm a seguir:

tsm configuration get -k vizqlserver.rserve.password

Você também deve ter uma cópia do certificado das extensões do Analytics se tiver configurado o SSL.

### Repositório externo

Isso só se aplica se você estiver usando a configuração do Repositório externo com o Tableau Server. Se você não tiver certeza se isso se aplica a você, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo.htm).

Se você estiver usando um Repositório externo, pode ser necessário executar etapas adicionais ao atualizar.

- **Nenhuma alteração de versão** — Se não houver alteração de versão no PostgreSQL, não serão necessárias ações especiais.
- **Alteração de versão secundária** — Se houver uma alteração de versão secundária no PostgreSQL, você precisará atualizar seu repositório externo antes de atualizar o Tableau Server. Na maioria dos casos, existem métodos no local para fazer isso. O método que você usa depende da localização do seu repositório e está além do escopo desta documentação.
- **Alteração de versão principal** — Se houver uma alteração de versão principal no PostgreSQL, você precisará seguir as etapas descritas em [Atualizar o Tableau Server com Repositório Externo para uma nova versão principal do PostgreSQL.](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm).
    
    As etapas incluem:
    
    1. Crie uma nova instância do banco de dados PostgreSQL. Para obter mais informações, consulte:
        - [Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_RDS.htm)
        - [Criar uma instância PostgreSQL do banco de dados do Azure no Azure](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_Azure.htm).
        - [Criar uma instância PostgreSQL no Google Cloud](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_gcp.htm)
        - [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm)
    2. Crie um arquivo de configuração e baixe o arquivo de certificado SSl para a nova instância que você criou na Etapa 1.
    
    Durante a atualização, você precisará apontar o Tableau Server para a nova instância usando o arquivo de configuração. O processo de atualização migrará o conteúdo do repositório externo atual para a nova instância. Para obter mais detalhes, consulte [Atualizar o Tableau Server com Repositório Externo para uma nova versão principal do PostgreSQL.](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm).

### Armazenamento de arquivo externo

Não há etapas, ações ou configurações especiais necessárias ao atualizar o Tableau Server configurado com armazenamento de arquivo externo. Você pode atualizar o Tableau Server usando o procedimento normal.

### Personalização da porta

Se tiver alterado o intervalo dinâmico da porta ou configurado as portas manualmente para o Tableau Server, registre as alterações feitas.

Execute o seguinte comando:

tsm topology list-ports

Para obter mais informações, consulte [Portas do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/ports.htm).

### Personalização de proxy

Se você estiver usando o OAuth e tiver feito alguma alteração no arquivo `net.properties` para Tableau Server na pasta `<drive>:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\conf`, você deve registrar as alterações feitas. O processo de atualização cria um novo `net.properties` e talvez seja necessário atualizar o novo após a atualização.

Você pode salvar uma cópia em um local seguro e usá-la após a atualização para comparar as diferenças com o arquivo recém-criado.

Para obter mais informações, consulte [Configurar um proxy para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm) no Tableau Desktop e na Ajuda de Criação na Web.

Prossiga para [Atualização do servidor - verificar o status do licenciamento](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare-verify-licensing.htm)

<!-- document id=bf197104019d6abcdaaa52462dc760ad2dfbcf76786aa0aee4e3b58bef3ba343 url=/tableau/current/pt-br/server/server-upgrade-baseline-disable-tasks.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do servidor - Desabilitar as tarefas agendadas

**Important:** você deve desabilitar as tarefas agendadas antes de realizar a atualização. Isso inclui todas as atualizações no conteúdo dos dados e deve ser feito antes de você criar seu backup de pré-atualização. Isso pode envolver a desabilitação de trabalhos acionados fora do Tableau Server, como aqueles iniciados por meio de atualizações de extração baseadas na API REST ou usando tabcmd.

Execute o procedimento a seguir para desabilitar todas as atualizações de extrações agendadas, fluxos e assinaturas.

1. [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm) como o administrador do Tableau Server.
2. Acesse a página Agendas em todo o servidor:
    
    - Em um Tableau Server onde há um único site (Padrão), clique em Agendas no painel à esquerda.
    - Em um Tableau Server com mais de um site, clique em Gerenciar todos os sites no menu suspenso na parte superior do painel à esquerda e, em seguida, clique em Agendas.
3. Na página Agendas, clique em Selecionar tudo.
4. No menu Ações, selecione Desabilitar e clique em Desabilitar no prompt exibido.

Continue a: [Atualização de servidor único - Executar instalação](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-singlenode-setup.htm) ou [Atualização de vários nós - Executar instalação](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-multinode-setup.htm)

<!-- document id=b29bd851a30e7607287c3171f71998db34e95eeeb623781e27af9b7bbc43955d url=/tableau/current/pt-br/server/server-upgrade-prepare-min-HW-recommendations.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do servidor - Recomendações mínimas de hardware

Para uso em produção, o computador no qual você atualiza o Tableau Server deverá atender ou exceder as recomendações mínimas de hardware. Estas recomendações são gerais. As necessidades reais do sistema para as instalações do Tableau Server podem variar com base em muitos fatores, incluindo o número de usuários e o número e tamanho das extrações. Se o programa de instalação determinar que o seu computador não atende às recomendações a seguir, você receberá um aviso, mas poderá continuar com o processo de instalação. As recomendações mínimas listadas aqui são indicadas como orientação geral. No entanto, as recomendações para seu ambiente podem variar. Para obter mais informações, consulte a [Seção de recomendações de hardware](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#hardware-recommendations) do tópico [Configurações de linha de base recomendadas](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm).

<table class="table--plain"><colgroup><col><col style="width: 214px;"><col><col><col></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Tipo de instalação</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Processador</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>CPU</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>RAM</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Espaço livre em disco</i></p></th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3"><p>Nó único</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>64 bits (chipsets de x86_64)</li><li>Deve aceitar conjuntos de instruções SSE4.2 e POPCNT</li><li>Os processadores baseados em ARM não são suportados</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>8 núcleos (16 vCPUs), 2.0 GHz ou superior</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Versão 2022.3 e posteriores:</p><ul><li>128 GB</li></ul><p>Versão 2021.4.0 para versão 2022.1.x:</p><ul><li>64 GB</li></ul><p>Versão 2021.3.x e anteriores:</p><ul><li>32 GB</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>50 GB</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Se estiver adicionando o Tableau Prep Conductor à sua instalação do Tableau Server, recomendamos adicionar um segundo nó e dedicá-lo para a execução do Prep Conductor no Tableau Server. Esse nó deve ter um mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Memória de troca recomendada: configuração padrão do arquivo de paginação do Windows. </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>Implantações empresariais e de vários nós</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" colspan="4"><p colspan="4">Entre em contato com o Tableau para obter orientação técnica.</p><p>Os nós devem atender às recomendações mínimas de hardware ou excedê-las, exceto:</p><ul><li><p>Nós dedicados do Processador em segundo plano executando até duas instâncias nele, onde 4 núcleos podem ser aceitáveis.</p></li><li><p>Nó dedicado para o Tableau Prep Conductor: mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</p></li><li><p>Nó dedicado para Independent Gateway: mínimo de 2 núcleos (4 vCPUs), 8 GB de RAM e 100 GB de espaço livre em disco.</p></li></ul></td></tr></tbody></table>

**Importante:** o requisito de espaço em disco não pode ser verificado até que você inicialize o TSM.

- O espaço livre em disco será calculado após a extração do programa de Instalação do Tableau Server. O programa de instalação usa cerca de 1 GB de espaço. Pode ser necessário alocar espaço em disco adicional dependendo de vários fatores, como estar usando extrações.
- **Requisitos de espaço de armazenamento conectado à rede para armazenamento de arquivo externo:** se você estiver planejando configurar o [Tableau Server com armazenamento de arquivo externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm), precisará estimar a quantidade de espaço de armazenamento para dedicar em seu armazenamento conectado à rede.
    
    Estimativa do tamanho do armazenamento: você deve levar em consideração a quantidade de armazenamento necessária para publicar e atualizar as extrações. Além disso, você também deve levar em consideração o tamanho do backup do repositório, a menos que escolha especificamente a opção de fazer o backup do repositório separadamente, conforme descrito no tópico [Opção 2: repositório de backup separadamente](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm#backup-repository-separately)
    
    - Extrações:
        - Considere o número de extrações que será publicado no Tableau Server e o tamanho de cada extração. Teste as suas necessidades ao publicar várias extrações no Tableau Server e, em seguida, verifique o espaço em disco usado. Você pode usar essa quantidade de espaço em disco para ajudar a descobrir quantas extrações serão publicadas no Tableau Server no decorrer do tempo, além de como cada extração existente terá o tamanho aumentado.
        - Considere o espaço necessário pelo diretório temp durante uma atualização de extração. O diretório temp, que armazena uma extração durante a atualização, pode necessitar de um tamanho três vezes maior que o do arquivo final.
    - Backup do repositório:
        - Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório `<data directory>/pgsql/data/base`.
        - Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo `workgroup.pg_dump`.
- A contagem de núcleos baseia-se nos núcleos "físicos". Núcleos físicos podem representar hardware de servidor reais ou em uma máquina virtual (VM). O hyper-threading é ignorado para a finalidades de contar núcleos.
- A RAM mostrada é o mínimo recomendado para uma instalação de um nó único. A instalação pode funcionar melhor com mais RAM, dependendo da atividade, do número de usuários e dos trabalhos em segundo plano.

Para ver a lista completa de recomendações e os requisitos mínimos, consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm). Para as especificações de hardware, o Tableau testa a escalabilidade internamente, consulte [Recomendações de hardware para instalações de produção](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#Hardware).

Para obter as recomendações do hardware para o Tableau Server na nuvem, consulte o seguinte:

- [Selecionar um tipo e um tamanho de instância AWS](https://help.tableau.com/current/server/pt-br/ts_aws_virtual_machine_selection.htm)
- [Selecionar um tipo e tamanho da máquina virtual do Google Compute Engine](https://help.tableau.com/current/server/pt-br/ts_gcp_virtual_machine_selection.htm)
- [Seleção de um tipo e um tamanho de máquina virtual do Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_virtual_machine_selection.htm)

## Determinação do hardware do computador

O programa de instalação do Tableau Server consulta o sistema operacional para determinar quantos núcleos físicos um computador tem. Para exibir as informações de hardware que o programa de instalação detectou no seu computador, abra o arquivo `tabadmin.log` na pasta a seguir do computador no qual o Tableau Server está sendo instalado:

<install directory>\\ProgramData\\Tableau\\Tableau Server\\logs\\tabadmin.log

No arquivo `tabadmin.log`, procure linhas similares às seguintes. essas linhas fornecem informações sobre os núcleos físicos e lógicos detectados pelo programa de instalação e usados para determinar a contagem de núcleos utilizada para o licenciamento.

2015-04-09 14:22:29.533 -0700\_DEBUG\_10.36.2.32:<machine name>\_:\_pid=21488\_0x2cd83560\_\_user=\_\_request=\_\_ Running hardware check

2015-04-09 14:22:29.713 -0700\_DEBUG\_10.36.2.32:<machine name>\_:\_pid=21488\_0x2cd83560\_\_user=\_\_request=\_\_ Detected 12 cores and 34281857024 bytes of memory

2015-04-09 14:22:29.716 -0700\_DEBUG\_10.36.2.32:<machine name>\_:\_pid=21488\_0x2cd83560\_\_user=\_\_request=\_\_ Hardware meets recommended specifications. Default values will be used.

### Determinando manualmente o número de núcleos em seu computador

**Observação:** esse procedimento substitui um processo antigo para determinar o número de núcleos usando o WMIC, que foi preterido pela Microsoft.

Para determinar manualmente quantos núcleos físicos há no servidor, você pode usar o Powershell. Isso é útil se você não souber se seu computador irá ou não atender aos requisitos mínimos de hardware para a instalação do Tableau Server.

1. Abra o Powershell.
2. Digite o seguinte comando, que lista os processadores lógicos, bem como os núcleos físicos:
    
    Get-CimInstance -ClassName Win32\_Processor | Select-Object DeviceID, NumberOfCores, NumberOfLogicalProcessors
    
    ![Uma janela de prompt de comando exibe a ID do dispositivo e o número de núcleos da CPU de um computador.](/tableau/current/pt-br/server/pt-br/Img/server_hardware_cores-powershell.jpg)
    
    Neste exemplo acima, o servidor tem um total de dezoito núcleos físicos, resultando em 36 núcleos lógicos.

Continue para [Atualização do servidor - Revisar o que mudou](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare-whats-changed.htm).

<!-- document id=35d36a7b77ee3aa722bd40c9c7de870351fac36711b81c47fcb9b79647b60355 url=/tableau/current/pt-br/server/server-upgrade-prepare-whats-changed.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do servidor - Revisar o que mudou

Este tópico inclui uma lista de mudanças importantes do produto no Tableau Server, começando pela versão 2019.1. As alterações listadas neste tópico podem afetar o processo de atualização, ou podem afetar a funcionalidade depois da atualização. Leia estas alterações com atenção e anote as alterações e as etapas de remediação que você precisará executar. Inclua essas etapas de remediação como parte do processo de atualização ou do plano de configuração pós-atualização.

Essa lista é cumulativa, por isso, se você estiver atualizando de uma versão anterior (por exemplo, 2019.1), leia a lista de alterações de cada versão entre a sua versão e a versão para qual está atualizando. Você também pode baixar a pasta de trabalho com a lista e usá-la para criar sua própria lista de verificação personalizada.

Para desenvolver um plano de verificação e teste mais eficiente, recomendamos que você também revise novos recursos antes de atualizar. Para ver uma lista completa de todos os recursos novos e alterados, selecione tudo listado no filtro **Status**.

Prossiga para [Atualização do servidor - coletar detalhes de configuração](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare-gather-config.htm).

<!-- document id=50c6d3fab4bc1f53399ed9c457716ec2715220f510ef367017ae6b4fa339d6ad url=/tableau/current/pt-br/server/server-upgrade-prepare-verify-accounts.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do servidor - Verificar contas

Antes de atualizar o Tableau Server, verifique se você tem senhas nas duas contas:

- Uma conta membro do grupo de administradores locais: a conta usada para instalar o Tableau Server deve ser membro do grupo de administradores locais.
- Conta de serviço Run As: se sua organização usar o Active Directory como repositório de identidades e/ou se você tiver configurado o Tableau Server para se conectar a fontes de dados no Active Directory, mantenha as credenciais da conta de serviço Run As em mãos à medida que executa a atualização.

A configuração do Tableau Server não modificará as permissões de diretório existentes durante o processo de atualização. Mas é uma prática recomendada verificar as configurações de permissão não padrão antes de executar a configuração:

- Se tiver instalado o Tableau Server em uma unidade não padrão (o padrão é normalmente `C:\Program Files`), verifique se as permissões da conta de serviço Run As estão em conformidade com as permissões necessárias especificadas em [Instalando em um local não padrão](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm#Installi).
- Além disso, se tiver permissões de escopo no computador que executa o Tableau Server, verifique se elas permissões estão em conformidade com as permissões de diretório necessárias especificadas em [Contas e permissões do Windows](https://help.tableau.com/current/server/pt-br/security_windows_accounts_perms.htm).

Prossiga para [Atualização do Server - Backup do Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare-backup.htm).

<!-- document id=ba2a515af162fe5315b2c097100c989a27a6bc184b59eb48fb071f67e8d4aa79 url=/tableau/current/pt-br/server/server-upgrade-prepare-verify-licensing.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do servidor - verificar o status do licenciamento

Antes de atualizar o Tableau Server, revise as chaves do produto instaladas no momento e compare-as com as chaves do produto, o vencimento da manutenção e as datas de término de licença listadas no Portal do cliente do Tableau.

É importante que todas as datas de validade e término associadas às chaves do produto estejam atualizadas antes da atualização.

**Etapa 1: exibir informações de expiração da licença**.

Execute o seguinte comando para visualizar todas as licenças instaladas na instalação do Tableau Server:

tsm licenses list

O comando [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList) retorna todas as licenças, cada uma com vários campos. Para atualização, você precisa anotar dois campos:

- Para cada licença de assinatura, anote a data no campo LIC EXP. O LIC EXP mostra a data de expiração da licença e que o Tableau Server deixará de funcionar.
- Para cada chave perpétua legada, anote o campo MAINT EXP. O MAINT EXP mostra a data de expiração do contrato de manutenção da implantação do Tableau Server.

Etapa 2: compare as datas de validade da licença do TSM com suas licenças no [Portal do cliente do Tableau](http://customer.tableausoftware.com/).

**Etapa 3: se necessário, atualize as licenças**.

Se a data de manutenção do TSM não estiver atualizada ou a data de validade ocorrer em breve ou não for a mesma da data listada no Portal do cliente do Tableau, atualize a licença.

Para atualizar a licença:

1. Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.
2. Abra o TSM em um navegador:
    
    http://<tsm-computer-name>:8850
3. Clique em **Configuração** e Licenciamento, em seguida clique em Atualizar tudo:
    
    ![Página de configuração de licenciamento que exibe uma lista de licenças do Tableau Server e suas datas de expiração.](/tableau/current/pt-br/server/pt-br/Img/licensing.png)

Se isso não atualizar a data de término de manutenção ou expiração, mas o Portal do cliente do Tableau mostrar datas de término atuais, entre em contato com o [Suporte técnico do Tableau](http://www.tableau.com/pt-br/support/request).

A reativação da chave do produto fará parte do processo de atualização.

Prossiga para [Atualização do servidor - Verificar contas](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare-verify-accounts.htm).

<!-- document id=9fc47d7cad3eddb61400df01bec33f9e31eaa1d8f3f4a4ddd35c9aa754709636 url=/tableau/current/pt-br/server/rmt-admin-tableau-upgrade.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do Tableau

Ao atualizar uma instalação do Tableau Server que é monitorada pelo Resource Monitoring Tool do Tableau, há algumas etapas adicionais que precisam ser seguidas.

## Garantir que o Resource Monitoring Tool suporte a nova versão do Tableau

Antes de atualizar o Tableau, você desejará certificar-se de que a versão do Resource Monitoring Tool instalada suporte à versão do Tableau para a qual você está atualizando.

A maneira mais rápida de verificar é fazer logon na interface da Web do Resource Monitoring Tool e navegar até a tela _Admin_ | _Environments_. Edite o ambiente que você está atualizando e verifique o menu suspenso da _Tableau Version_ para a versão à qual está sendo atualizada.

## Parar agentes

Os agentes do Resource Monitoring Tool devem ser interrompidos enquanto você atualiza o Tableau Server. Siga as etapas a seguir em cada máquina no cluster do Tableau Server.

1. Clique em _iniciar_, clique na caixa de pesquisa, digite `services.msc` e pressione ENTER.
2. Localize o serviço do Agente do Resource Monitoring Tool do Tableau e clique nele com o botão direito.
3. Clique em _Parar_ no menu de contexto.

## Atualizar o Tableau

Siga o processo normal para atualizar o Tableau Server. Esse processo é descrito [na documentação do Tableau Server](https://help.tableau.com/current/server/pt-br/upgrade.htm).

## Atualizar a versão do Tableau no Resource Monitoring Tool

1. Faça logon na interface da Web do Resource Monitoring Tool.
2. Vá para _Admin_ | _Environments_
3. Edite o ambiente que você atualizou.
4. Modifique a _Tableau Version_ para correspondência

## Reiniciar agentes

Após a conclusão da atualização, você estará pronto para reiniciar os agentes do Resource Monitoring Tool. Siga as etapas a seguir em cada máquina no cluster do Tableau Server.

1. Clique em _iniciar_, clique na caixa de pesquisa, digite `services.msc` e pressione ENTER.
2. Localize o serviço do Agente do Resource Monitoring Tool do Tableau e clique nele com o botão direito.
3. Clique em _Iniciar_ no menu de contexto.

## Quem pode fazer isso

Para atualizar o Resource Monitoring Tool, você deve ter o seguinte:

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.
- Resource Monitoring Tool Conta de administrador.

<!-- document id=11c79f1c6d6621edfdd95ef0a5f19eeaf4cac33e1727d6bb53f9b6c1f38d1b21 url=/tableau/current/pt-br/server/sug_plan.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do Tableau Server (Windows)

Siga o gráfico de fluxo abaixo e os tópicos vinculados para realizar uma atualização no local do Tableau Server.

Antes de iniciar a atualização, certifique-se de ter concluído a Preparação para a atualização. Para obter mais detalhes, consulte [Preparação para a atualização](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare.htm).

Se estiver migrando o Tableau Server para novo hardware como parte de sua atualização, consulte [Migrar para novo hardware](https://help.tableau.com/current/server/pt-br/upgrade_migrate.htm).

![Um fluxograma do processo de atualização do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/upgrade_tsmtotsm.png)

## Suporte e serviços para ajudar com atualizações do Tableau Server

As atualizações do Tableau Server exigem planejamento e testes. Elas geralmente são feitas durante os momentos em que os usuários não estão no Tableau Server. Se você planeja uma atualização durante um fim de semana e antecipa a necessidade de suporte técnico do Tableau, consulte as informações dos [Programas de Suporte Técnico](https://www.tableau.com/pt-br/support/services) no site do Tableau. A disponibilidade depende do seu nível de suporte. Se você quiser que o Tableau ajude no planejamento e atualização da instalação do Tableau Server, consulte nossa página de [atualização do Servidor de Serviços Globais do Tableau](https://www.tableau.com/pt-br/support/consulting/server-upgrade) para obter detalhes.

## Outros artigos nesta seção

<!-- document id=d47ab1fd2f9b533357dd5e1a059d22228fbd6ad40cd53b7c7f3225b8e41fb537 url=/tableau/current/pt-br/server/server_external_repo_upgrade_RDS_instance_type.md -->

[Pular para o conteúdo principal](#main-content)

# Atualizar a Instância de RDS

Se você achar que a instância de RDS atual em uso para hospedar o repositório do Tableau gera problema no desempenho, é possível atualizar a instância de RDS para um tamanho maior. Este tópico descreve as etapas que você pode usar para atualizar a instância de RDS.

1. [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm).
2. Interrompa o Tableau Server:
    
    `tsm stop`
3. Após confirmar que o servidor foi desativado, entre no Console de gerenciamento AWS e abra o console do Amazon RDS em
    
    https://console.aws.amazon.com/rds/.
4. No painel de navegação, escolha **Banco de dados**,e escolha a instância do banco de dados que deseja modificar.
5. Selecione **Modificar**. A página Modificar instância do banco de dados é exibida.
6. Modifique a instância de RDS ao configurar a classe de instância do banco de dado como a desejada.
7. Selecione **Aplicar imediatamente** para garantir que as alterações sejam aplicadas imediatamente. Para informações mais detalhadas, consulte [Modificar uma instância do banco de dados ao executar o banco de dados PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ModifyPostgreSQLInstance.html) no site da documentação AWS.
8. Monitore o status da instância de RDS no console do AWS. Pode demorar algum tempo, mas quando o status mostrar como Disponível, você poderá iniciar o Tableau Server e retomar as operações normais:
    
    `tsm start`

## Quem pode fazer isso

O administrador do Tableau Servidor que tenha acesso à conta RDS da Amazon pode executar todas as etapas necessárias para atualizar a instância do RDS da Amazon.

<!-- document id=2fc90c9232f6ffd683653095d9554c9632f62b9d806b77a42c1c6a6c061d2766 url=/tableau/current/pt-br/server/schedule_add.md -->

[Pular para o conteúdo principal](#main-content)

# Atualizar dados em uma agenda

Você pode agendar tarefas de atualização para as fontes de dados de extração publicadas e para as pastas de trabalho publicadas que se conectam às extrações. Novas agendas podem ser criadas pelos Administradores do Tableau Server na página Agendas. Para obter mais informações, consulte [Criar ou modificar uma agenda](https://help.tableau.com/current/server/pt-br/schedule_manage_create.htm).

Para obter informações sobre como atualizar as saídas de fluxo, consulte [](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm)[Agendar tarefas de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm).

Para evitar atualizações agendadas desnecessárias, considere oferecer aos usuários a capacidade de permissão para atualizar uma extração sob demanda. Para obter mais informações, consulte [Atualizar extrações](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm) para pastas de trabalho ou fontes de dados.

1. Quando estiver conectado ao Tableau Server, selecione Explorar no painel de navegação esquerdo e, dependendo do tipo de conteúdo que deseja atualizar, selecione Todas as pastas de trabalho ou Todas as fontes de dados no menu suspenso.
2. Marque a caixa de seleção da pasta de trabalho ou da fonte de dados que deseja atualizar e, em seguida, selecione Ações > Atualizar extrações.
3. Na caixa de diálogo Criar extração, selecione a guia Recomendado e conclua as seguintes etapas:
    
    1. Selecione o agendamento desejado.
    2. Se disponível, especifique se você deseja uma atualização completa ou incremental.
        
        Uma atualização completa é realizada por padrão. A atualização incremental estará disponível somente se tiver sido configurada no Tableau Desktop ou na criação da Web em Tableau Server antes da publicação da extração. Para obter mais informações, consulte [Atualizar extrações](https://help.tableau.com/current/pro/desktop/pt-br/extracting_refresh.htm) na Ajuda do Tableau.
    3. Clique no botão Agendar atualização.
        
        ![Uma caixa de diálogo para agendar atualizações de extração.](/tableau/current/pt-br/server/pt-br/Img/schedule_add1.png)

<!-- document id=4d9c028a1665b5d6c579c530d046e19d9b43eedd2ad0bdc4dbb7769c32c93a29 url=/tableau/current/pt-br/server/license_refresh.md -->

[Pular para o conteúdo principal](#main-content)

# Atualizar data de expiração e atributos da chave do produto

Ao usar o Server ATR e a Licença de assinatura atualizável (USL), você não precisa atualizar a(s) chave(s) do produto ao adquirir um novo período de assinatura, ou adicionar funções e/ou recursos a sua implantação. Isso ocorre porque as chaves de produto USL podem ser atualizadas para refletir as alterações na capacidade de licença, recurso e prazo de assinatura ao longo do tempo do Tableau Server, e o Server ATR atualiza automaticamente a(s) chave(s) do produto para você como um processo em segundo plano.

**Observação:** se você foi habilitado recentemente para USL juntamente com a renovação de sua assinatura, não poderá atualizar seu licenciamento conforme descrito aqui. Em vez disso, consulte o Portal do Cliente do Tableau para obter a nova chave de produto compatível com USL que deve ser ativada em sua implantação; consulte [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm). Suas chaves de produto originais não foram renovadas e não devem mais ser usadas em sua implantação.

Se você não estiver usando o ATR do servidor, poderá atualizar a(s) chave(s) do produto manualmente. Se você atualizar uma chave do produto de assinatura (termo) antes da data de validade ocorrer, a chave do produto não mudará, apenas a data de validade. Isso pode criar um descompasso entre as chaves do produto listadas no Portal do Cliente Tableau e as listadas na lista de chaves do produto TSM do Tableau Server. A chave do produto mudará quando na data de validade ou logo depois de ultrapassá-la. Se uma chave do produto de assinatura (com prazo) não for atualizada e tiver expirado, o Tableau deixará de funcionar e será necessário ativar uma nova chave do produto no Portal do cliente do Tableau para licenciar novamente a instalação do Tableau Server independentemente de você estar usando o ATR do servidor ou métodos de ativação manual.

Por outro lado, se a chave do produto for perpétua (legada) e sua manutenção expirar, o Tableau continuará operando, mas você não terá acesso a atualizações até que a manutenção seja renovada. Depois de renovar a manutenção, se não estiver usando o ATR do servidor, atualize a chave do produto existente para atualizar sua data de vencimento da manutenção. A chave do produto nunca mudará. Para obter mais informações sobre diferentes tipos de chaves do produto e licenças associadas, consulte a [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList).

**Observação**: este tópico descreve como atualizar a data de expiração do Tableau Server Advanced Management e Data Management. Para obter mais informações sobre a atualização da data de manutenção no Tableau Desktop, consulte [Atualizar a chave do produto](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm#refresh-the-product-key-tableau-desktop-only) no Guia de implantação do Tableau Desktop e do Tableau Prep.

## Antes de começar

Verifique a data de validade da sua licença. Visualize a data de validade seguindo o procedimento da interface na Web do TSM abaixo, ou executando [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList) no CLI.

- Compare a data com a data exibida no [Portal do cliente Tableau](http://customer.tableausoftware.com/).
- Caso o portal não exiba a data que você espera, entre em contato com o [Sucesso do cliente](https://www.tableau.com/pt-br/support/customer-success).
- Para renovar a licença, visite a página na Web [Renovação do Tableau.](https://www.tableau.com/pt-br/support/renew)

Se a data do TSM não corresponder à data exibida no Portal do cliente do Tableau e a seguinte operação de atualização falhar, entre em contato com o [Suporte do Tableau](https://www.tableau.com/pt-br/support).

**Observação:** para atualizar a chave do produto em um ambiente offline, visite o Portal do cliente do Tableau para obter a ID de ativação offline para sua última renovação e, em seguida, ative-a. Para obter mais informações sobre a ativação offline, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm). Ative todas as chaves do produto antes de iniciar o Tableau Server. Caso contrário, alguns usuários podem ficar sem licença.

1. Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.
2. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
3. Clique em **Configuração** e Licenciamento, em seguida clique em Atualizar tudo:
    
    ![Página de licenciamento com o botão Atualizar tudo destacado.](/tableau/current/pt-br/server/pt-br/Img/licensing-refresh.png)

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute o seguinte comando:
    
    `tsm licenses refresh`

<!-- document id=2f91e47b52d5a7058fc78c19783cbbdefd08c54abfd0c25a342c0508874add4e url=/tableau/current/pt-br/server/saml_update_cert.md -->

[Pular para o conteúdo principal](#main-content)

# Atualizar o certificado SAML

Depois de configurar a autenticação SSL, talvez seja necessário atualizar o certificado periodicamente. Em alguns casos, talvez você precise alterar o certificado para mudanças operacionais no ambiente de TI. Em ambos os casos, você deve usar o TSM ou a página de autenticação do site para atualizar o certificado SAML que já foi configurado.

Abaixo estão as etapas para atualizar o certificado e os arquivos-chave para implementações SAML específicas do servidor e do site.

## Certificado de atualização para SAML em todo o servidor

Para alterar ou atualizar o certificado (e o arquivo de chave correspondente, se necessário) para SAML em todo o servidor, siga as etapas abaixo:

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Interrompa o Tableau Server.
    
    Você pode fazer isso na interface de usuário da Web do TSM, clicando em Tableau Server em execução, e selecionando Parar o Tableau Server ou na linha de comando, usando o comando `[tsm stop](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm)`.
3. Na guia Configuração, selecione Identidade e acesso do usuário e, em seguida, a guia Método de autenticação.
    
    ![Configurações de autenticação de usuário do Tableau Services Manager](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-user-auth.png "Imagem")
4. Para Método de autenticação, selecione SAML.
5. Conclua as Etapas de 1 a 4 na interface gráfica do usuário para atualizar o arquivo de certificado SAML e trocar metadados entre o Tableau Server e seu IdP.
    
    ![Caixa de configuração do SAML.](/tableau/current/pt-br/server/pt-br/Img/saml_config.png)
6. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
7. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
8. Clique em Aplicar alterações e reiniciar.

Depois de alterar o certificado, você deve executar o `tsm pending-changes apply` para reiniciar os serviços do Tableau Server. Também recomendamos reiniciar quaisquer outros serviços no computador que usem o certificado SAML. Se estiver alterando um certificado raiz no sistema operacional, deverá reiniciar o computador.

## Atualizar certificado para SAML específico do site

O certificado utilizado para metadados do site Tableau é fornecido pelo Tableau e não é configurável. Para atualizar o certificado para SAML específico do site, você deve carregar um novo certificado para o seu IdP e trocar novamente os metadados com o Tableau Server.

1. Entre no site como um administrador de site ou servidor e selecione Configurações > Autenticação.
2. Nos tipos de autenticação, selecione Editar conexão para expandir de usuário.
3. Abra uma nova guia ou janela e entre na sua conta IdP.
4. Use as instruções fornecidas pela documentação do IdP para carregar um novo certificado SAML.
5. Baixe o novo arquivo de metadados XML para fornecer ao Tableau Server.
6. Retorne à página Autenticação no Tableau Server e, na etapa 4 da interface de usuário, importe o arquivo de metadados que você baixou do IdP.
7. Clique no botão Aplicar.

<!-- document id=857d97e6d1f0d96d14c0d57e24e935a29054eaf6b353f591b119906b8d9264f7 url=/tableau/current/pt-br/server/rmt-admin-upgrade.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização do Resource Monitoring Tool

Estas instruções são para atualizar uma instalação existente do Resource Monitoring Tool do Tableau.

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

**Observação:** o Resource Monitoring Tool executa uma atualização in-loco, atualizando sua instalação atual para a versão mais recente. Não desinstale a versão existente **antes** da atualização.

## Notas de atualização

**Considere o seguinte antes de iniciar o processo de atualização:**

1. A partir da versão 2025.3.6, o instalador do Tableau Resource Monitoring Tool (RMT) inclui scripts de verificação de integridade que validam automaticamente seu ambiente antes e depois das atualizações. Esses scripts não exigem nenhuma configuração ou privilégios adicionais para serem executados automaticamente. Você também pode optar por executá-los manualmente. Para obter mais informações, consulte [Scripts de verificação de integridade da atualização RMT](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade-health-scripts.htm).
2. Se você estiver planejando migrar para usar um repositório externo (PostgreSQL) ou serviço de fila de mensagens externo (RabbitMQ), verifique a seção de práticas recomendadas de upgrade nos tópicos a seguir:
    - [Práticas recomendadas de atualização](https://help.tableau.com/current/server/pt-br/rmt-external-repo.htm#upgrade-external-repo) para repositório externo
    - [Práticas recomendadas de atualização](https://help.tableau.com/current/server/pt-br/rmt-external-messagequeue.htm#upgrade-messagequeue) para fila de mensagens externas
3. A partir da versão 2022.3, o Resource Monitoring Tool do Tableau tem comunicações criptografadas integradas entre o RMT Server e os Agentes. No entanto, você precisará executar `rmtadmin rotate-mq-certificates` em todos os Agentes para habilitar o TLS. Isso se aplica ao RabbitMQ configurado localmente na mesma máquina que o RMT Server. Para obter mais detalhes sobre como fazer isso, consulte **Etapas de atualização com a ativação de TLS para RabbitMQ** abaixo.
4. Você pode precisar reiniciar a máquina durante uma atualização. Isso geralmente ocorre quando os arquivos estão bloqueados e não podem ser atualizados pelo instalador. Se necessário, você será solicitado pelo instalador. Devido a essa possibilidade, você pode querer considerar fazer suas atualizações fora do horário de trabalho.
5. Ao atualizar o Resource Monitoring Tool (Servidor e Agente), se você executar o instalador como um usuário do Windows diferente do usuário que executou a instalação original, o diretório de instalação personalizado usado inicialmente não poderá ser detectado pela atualização e a atualização será instalada em um diretório diferente.
6. Às vezes, o Resource Monitoring Tool vai modificar o banco de dados e, nesses casos, o processo de atualização incluirá uma migração de banco de dados. No caso de migração de banco de dados, você verá um banner de mensagem no topo da página na Web do RMT Server com uma estimativa de tempo para concluir o processo. Uma captura de tela de exemplo é mostrada abaixo:
    
    ![O banco de dados da Resource Monitoring Tool do Tableau mostra que a migração está 42% concluída.](/tableau/current/pt-br/server/pt-br/Img/rmt-upgrade-db-migration-collapsed.png)
    
    Ao expandir o banner, você pode consultar os detalhes do impacto da atualização. As alterações são exclusivas de cada versão e os detalhes mostrados são específicos da versão.
    
    ![O banco de dados da Resource Monitoring Tool do Tableau mostra que a migração está 42% concluída, com detalhes expandidos.](/tableau/current/pt-br/server/pt-br/Img/rmt-upgrade-db-migration-details.png)
7. O Resource Monitoring Tool é retrocompatível com as versões do Tableau Server, mas não é compatível com versões posteriores. Isso significa que a versão do Resource Monitoring Tooldeve ser igual ou posterior à versão do Tableau Server que você está monitorando.
    
    Por motivos de compatibilidade, a Tableau recomenda que você atualize o Resource Monitoring Tool primeiro e, em seguida, faça uma atualização do Tableau Server. Para obter mais informações, consulte [Compatibilidade do produto com o Tableau Server](https://help.tableau.com/current/server/pt-br/rmt-getting-started.htm#compat_table).

## Como atualizar o Resource Monitoring Tool

Recomendamos que você faça uma atualização in-loco de Resource Monitoring Tool. Se você desinstalar o Resource Monitoring Tool e instalar uma nova versão do banco de dados, isso pode resultar em corrupção de dados e você será solicitado a reinstalar a versão anterior e refazer o processo de atualização.

1. Faça logon no Resource Monitoring Tool em um navegador e confirme se está funcionando, antes de iniciar a atualização.
2. Copie a nova versão do programa de instalação do RMT Server na máquina do RMT Server.
3. Copie a nova versão do programa de instalação do RMT Agent para as máquinas onde você tem RMT Agents instalados. Os RMT Agents são instalados nos nós do Tableau Server que você está monitorando.
4. Em cada Tableau Server nó executando o serviço RMT Agent, interrompa cada RMT Agent usando o seguinte comando:
    
    `rmtadmin stop`
5. Na máquina que executa o serviço RMT Server, interrompa o RMT Server usando o seguinte comando:
    
    `rmtadmin stop`
6. No Gerenciador de Tarefas nas máquinas RMT Server e Agent, aguarde até que não haja nenhum processo em execução com Resource Monitoring Tool, tabrmt-master ou tabrmt-agent no nome antes de continuar na próxima etapa.
7. Execute o programa de instalação do RMT Server na máquina onde o RMT Server está instalado. Isso instala ou atualiza os pré-requisitos necessários e, em seguida, atualiza o RMT Server.
    
    Você não pode alterar o local de instalação para um diretório personalizado durante a atualização se o Resource Monitoring Tool foi instalado atualmente usando o local padrão.
8. Execute o programa de configuração do RMT Agent em todas as máquinas onde os RMT Agents estão instalados.
    
    **Importante:** a partir de 2021.4, você deve especificar uma conta de usuário Run As para o agente. Essa conta é usada para acessar o Tableau Server para coletar informações de monitoramento. Para a conta de usuário Run As, especifique a mesma conta que você usa atualmente para a conta de usuário Run As do Tableau Server. Se esta conta foi definida anteriormente para uma conta de usuário personalizada e não para a conta padrão (NT AUTHORITY/Serviço de Rede), durante o processo de atualização, ela será revertida para usar a conta padrão. Você pode usar o comando [rmtadmin service-setup](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm#rmtadmin%20service-setup) após a instalação para alterá-lo para a conta de usuário personalizada original.
9. Confirme se o RMT Server e os Agents estão em execução. Inicie os serviços e RMT Server e Agents se não reiniciarem automaticamente após a conclusão da atualização.
10. Faça logon em um navegador do Resource Monitoring Tool e confirme se está funcionando. Se a instalação não estiver funcionando, pode ser devido a um problema na conta de usuário usada para executar a atualização. Veja a [seção notas de atualização](#Upgrade) no início do tópico sobre a conta de usuário a ser usada para atualização.
    
    Para verificar se os RMT Agents foram atualizados, acesse o **Admin** menu, selecione **Environments**, e clique no ícone **Edit Environment** para ver os detalhes do ambiente. Na guia **Servidor**, você pode ver a versão do RMT Agent. Isso pode ser útil para determinar quais RMT Agents foram atualizados ao usar um cluster de vários nós do Tableau Server.

### Etapas de atualização com a ativação de TLS para RabbitMQ

Como os agentes em versões anteriores a 2022.3 têm se comunicado usando conexão não criptografada com o serviço de fila de mensagens RabbitMQ, ao atualizar para a versão 2022.3 ou posterior, esses agentes precisam ser atualizados para usar os novos detalhes de conexão segura. As etapas para fazer isso são as seguintes:

1. Depois de concluir as etapas de atualização descritas na seção acima, interrompa todos os agentes executando o seguinte comando:
    
    `rmtadmin stop --agent`
2. Baixe o arquivo bootstrap para o ambiente executando o seguinte comando:
    
    `rmtadmin bootstrap-file --env<myenvironment> --filename <The absolute or relative path including the file name>`
3. Execute o seguinte comando em cada uma das máquinas onde o Agent está instalado:
    
    `rmtadmin rotate-mq-certificate <BOOTSTRAP_FILE> --username=<RMT Server Username> --password-file=<RMT Server Password file name>`
4. Reinicie cada máquina do Agent após executar com sucesso o comando `rmtadmin rotate-mq-certificate`.

### Quem pode fazer isso

Para atualizar o Resource Monitoring Tool, será necessário ter as seguintes permissões:

- Administrador na máquina que você está instalando o Resource Monitoring Tool.
- Administrador do Tableau Server.
- Administrador do Resource Monitoring Tool.

## Outros artigos nesta seção

<!-- document id=ea388955202d901f7314120c3df7c6f4e13e4050dc7c663a5c2be47193f07dcc url=/tableau/current/pt-br/server/server_external_repo_upgrade_postgres.md -->

[Pular para o conteúdo principal](#main-content)

# Atualizar o Tableau Server com Repositório Externo para uma nova versão principal do PostgreSQL.

Quando há uma alteração no requisito de versão principal do PostgreSQL para o Tableau Server, existem algumas instruções específicas que você deve seguir para garantir que a atualização do Tableau Server seja bem sucedida. Por exemplo, o Tableau Server 2020.4 exige que o repositório use PostgreSQL versão 12. Esta é uma mudança de versão principal da versão 9.x do PostgreSQL usada nas versões do Tableau Server anteriores à 2020.4. Portanto, se você estiver atualizando de uma versão anterior do Tableau Server para a versão 2020.4 ou posterior, precisará seguir as etapas descritas nas seções a seguir para concluir a atualização.

Este tópico também inclui a compatibilidade do produto entre PostgreSQL e Tableau Server.

## Antes de atualizar

Você não pode fazer uma atualização no local para atualizar a versão do PostgreSQL na sua instância de Banco de dados PostgreSQL existente no Amazon RDS ou no Banco de dados do Azure para Banco de dados PostgreSQL. Em vez disso, você deve criar uma nova instância e apontar o Tableau Server para a nova instância durante a atualização. Use as seguintes informações para criar uma nova instância e prepare-se para a atualização:

1. Crie uma nova instância da instância do Banco de dados PostgeSQL:
    1. [Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_RDS.htm)
    2. [Criar uma instância PostgreSQL do banco de dados do Azure no Azure](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_Azure.htm).
    3. [Criar uma instância PostgreSQL no Google Cloud](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_gcp.htm)
    4. [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm)
2. As conexões SSL **não** são necessárias, mas recomendadas. Se você deseja configurar conexões SSL para comunicações entre o Tableau Server e o Repositório Externo, faça o seguinte:
    - **Amazon RDS:** consulte [Uso de SSL para criptografar a conexão a uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL).
    - Banco de dados do Azure: consulte [Configurar a conectividade TLS no banco de dados do Azure para PostgreSQL](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-ssl-connection-security).
    - **Instância do Google Cloud:** consulte [Como configurar certificados SSL/TLS](https://www.google.com/url?q=https://cloud.google.com/sql/docs/postgres/configure-ssl-instance&sa=D&source=docs&ust=1635271250769000&usg=AOvVaw3YRZJ0JQdXSkhNjdOxhuww)
    - **Instância PostgreSQL autônoma:** consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm#configure-ssl) .
3. Crie um arquivo de configuração para a nova instância criada na etapa 1.
    
    Crie um arquivo json com as seguintes definições de configuração:
    
    {
     "flavor":"<flavor name>",
     "masterUsername":"<admin user name>",
     "masterPassword":"<password>", 
     "host":"<instance host name>",
     "port":5432
    }
    
    - **flavor:** é o tipo de serviço externo que você usará para o repositório do Tableau Server.
        
        - Amazon RDS: use "rds"
        - Banco de dados do Azure: use "azure"
        - Banco de dados do Google Cloud: use "gcp"
        - Banco de dados PostgreSQL autônomo: use "generic"
    - **masterUsername:**
        
        - **Amazon RDS:** use "trilhas" para o nome de usuário. Esse é o usuário que você especificou ao criar a instância de RDS.
            
            > [!IMPORTANT]
            > 
            > Você deve usar “trilhas” como o masterUsername. Isso é necessário para que o repositório externo funcione corretamente com o Tableau Server.
        - **Instância de banco de dados do Azure, Google Cloud ou PostgreSQL autônoma:** escolha um nome de usuário que atenda aos seus requisitos. Recomendamos usar **postgres** como nome de usuário do Administrador. Se você optar por usar um nome de usuário diferente, certifique-se de que ele não comece com **pg**, ou **azure**. O nome de usuário também não pode ser **rails**, **tblwgadmin,** **tableau**, **readonly** ou **tbladminviews**.
    - **masterPassword:** esta é a mesma senha que você especificou ao criar a instância do banco de dados PostgreSQL.
    - **host:** este é o endpoint da instância de banco de dados PostgreSQL.
    - **port:** a porta do banco de dados que você especificou ao criar a instância de banco de dados PostgreSQL. A porta padrão para PostgreSQL é 5432.

## Upgrades do Tableau Server

**Observação:** se você estiver usando o Repositório externo do Tableau Server, deve atualizar o Tableau Server usando a opção de linha de comando.

A seguir, estão as etapas de alto nível de como especificar os parâmetros do repositório externo ao executar o script de atualização.

Para obter um passo a passo completo do processo de atualização do Tableau Server, consulte [Atualização das versões anteriores](https://help.tableau.com/current/server/pt-br/sug_plan.htm).

1. No Tableau Server, abra um prompt de comando como administrador.
    
    **Observação:** você deve abrir uma nova janela de comando porque o programa Configuração atualiza o caminho para a nova instalação.
2. Navegue até a pasta de scripts da nova instalação.
    
    Como padrão:
    
    `C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`
3. Execute o script de atualização e especifique o arquivo de configuração e o certificado SSL:
    
    `upgrade-tsm.cmd --external-repository-config-file=<json config file> --external-repository-cert-file=<SSL certificate file>`

## Compatibilidade entre produtos

A tabela abaixo lista a versão do PostgreSQL compatível com o Tableau Server. Use esta tabela para determinar a versão do PostgreSQL para instalar o Repositório Externo.

  
**Suporte ao Amazon RDS:** o Repositório externo que usa o Amazon RDS é compatível com as versões 2019.3 e posteriores do Tableau Server.  
**Suporte ao banco de dados do Azure:** o Repositório externo usando a instância do Banco de dados do Azure é compatível com as versões 2020.4 e posteriores do Tableau Server.

**Suporte ao Google Cloud:** o Repositório externo que usa o Google Cloud SQL é compatível com as versões 2021.4 e posteriores do Tableau Server.  
**Suporte à instância autônoma do PostgreSQL:** o repositório externo usando uma instalação autônoma do banco de dados PostgreSQL é compatível com as versões 2021.2 e posteriores do Tableau Server.

Suporte do Google Cloud Platform: o repositório externo usando uma instância PostgreSQL no Google Cloud Platform é compatível com as versões 2021.4 e posteriores do Tableau Server.

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Versões do Tableau Server</th><th>Versões mínimas compatíveis com PostgreSQL</th></tr><tr><td><p>2022.3.0 - 2022.3.7</p><p>2023.1.0 - 2023.1.4</p></td><td>13.7</td></tr><tr><td>2022.1.17 - 2022.1.19<p>2022.3.8 - 2022.3.19</p><p>2023.1.5 - 2023.1.15</p><p>2023.3.0 - 2023.3.8</p></td><td>13.11</td></tr><tr><td>2022.3.20 - 2022.3.x<p>2023.1.16 - 2023.1.x</p><p>2023.3.9 - 2023.3.x</p></td><td>13.14</td></tr><tr><td>2024.0 - 2024.2.8</td><td>15.6</td></tr><tr><td>2024.2.9 - 2024.2.13<p>2025.1.0 - 2025.1.6</p></td><td>15,10</td></tr><tr><td>2024.2.14 - 2024.2.16 <p>2025.1.7 - 2025.1.9</p></td><td>15,13</td></tr><tr><td><p>2024.2.17</p><p>2025.1.10</p><p>2025.3 - 2025.3.5</p></td><td>15,14</td></tr><tr><td>2025.3.6</td><td>15,16</td></tr><tr><td><p>2026.2.x</p></td><td>17,7</td></tr></tbody></table>

Compatibilidade herdada

A tabela abaixo inclui duas colunas:

1. Versão do PostgreSQL enviada com o Tableau Server, que é a versão instalada com Tableau Server para Repositórios locais.
2. Todas as versões de PostgreSQL compatíveis com o Repositório externo.

**Observações:**  
\- Para versões do PostgreSQL, antes da versão 10, os dois primeiros dígitos indicam a versão principal, e a versão secundária é representada pelo último dígito. Por exemplo, na versão 9.4.1, o 9.4 indica a versão principal e o .1 indica a versão secundária.  
\- Para as versões PostgreSQL 10 ou posterior, o primeiro dígito indica a versão principal, e a versão secundária é representada pelo último dígito. Por exemplo, na versão 11.1, 11 é a versão principal e .1 é a versão secundária.  
\- Uma versão do PostgreSQL com uma versão principal igual a, e uma versão menor maior do que, a versão Postgres enviada com o servidor Tableau é sempre aceitável para uso com o repositório externo, juntamente com quaisquer versões mais antigas explicitamente permitidas.

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr style="height: 35px;"><td>Versão do Tableau Server</td><td>Versão do PostgreSQL (enviada com o Tableau Server)</td><td>Versões alternativas de PostgreSQL compatíveis com o repositório externo</td></tr><tr><td>2019.3 - 2019.3.3</td><td>9.6.11</td><td><p>9.6.x, em que x é maior que 11</p></td></tr><tr><td>2019.3.4 - 2019.3.10</td><td>9.6.15</td><td>9.6.x, em que x é maior que 15</td></tr><tr><td>2019.3.11 - 2019.3.14</td><td>9.6.17</td><td>9.6.15, ou 9.6.x, em que x maior que 17</td></tr><tr><td>2019.4 - 2019.4.1</td><td>9.6.14</td><td>9.6.x, em que x é maior que 14</td></tr><tr><td>2019.4.2 - 2019.4.6</td><td>9.6.15</td><td>9.6.x, em que x é maior que 15</td></tr><tr><td>2019.4.7 - 2019.4.13</td><td>9.6.17</td><td>9.6.15, ou 9.6.x, em que x é maior que 17</td></tr><tr><td>2020.1 - 2020.1.6</td><td>9.6.15</td><td>9.6.x, em que x é maior que 15</td></tr><tr><td>2020.1.7 - 2020.3.2</td><td>9.6.17</td><td>9.6.15, ou 9.6.x, em que x é maior que 17</td></tr><tr><td>2020.4 - 2021.4</td><td>12.8</td><td><p>12.8 ou 12.x, em que x é maior que 8</p></td></tr><tr><td>2022.1 e posteriores</td><td>13.3</td><td>13.3 ou 13.x, em que x é maior que 3</td></tr></tbody></table>

## Quem pode fazer isso

Os administradores do Tableau Server podem fazer upgrade e configurar o Tableau Server.

<!-- document id=f8c3d043b58cb7b54f4a36bd7a22122d57316d43328d101a61ad321530c53de4 url=/tableau/current/pt-br/server/server_tsig_upgrade.md -->

[Pular para o conteúdo principal](#main-content)

# Atualizar o Tableau Server Independent Gateway

Este tópico orienta você no processo de atualização do Tableau Server Independent Gateway. O processo descrito neste tópico é o mesmo para todas as atualizações de versão. Isso significa que você pode usar esse processo para atualizações da versão principal (por exemplo, 2022.1 a 2023.1) e da versão de manutenção (2022.1.1 a 2023.1.1).

Você deve usar um instalador para o Tableau Server Independent Gateway com uma versão com uma versão principal que corresponda à versão do Tableau Server. Recomendamos à correspondência com as versões de manutenção (2022.1.1 ou 2022.1.2 por exemplo), mas não é um requisito. Se a alteração de "ativos estáticos" entre as versões e as versões não corresponderem, você poderá ver algum impacto inesperado na imagem. Por exemplo, os mapas podem não estar atualizados se o Independent Gateway for uma versão anterior ao Tableau Server.

## Visão geral

O processo de atualização do Independent Gateway é, na verdade, um processo de desinstalação e reinstalação do software. No entanto, você pode minimizar a configuração e o tempo de inatividade geral seguindo o processo conforme descrito neste tópico.

O processo descrito neste tópico pressupõe que você tenha uma implantação funcional do Tableau Server e do Independent Gateway do Tableau Server em execução. Se você estiver atualizando a implantação de back-end do Tableau Server como parte de sua atualização, recomendamos primeiro atualizar o(s) servidor(es) de Independent Gateway, validar a conectividade básica com um cliente do Tableau e, em seguida, prosseguir com a atualização do Tableau Server.

As etapas detalhadas neste tópico estão resumidas aqui:

1. Copie alguns arquivos existentes para uso durante a atualização.
2. Desinstale a versão instalada do gateway independente com o desinstalador do Windows.
3. Instale a nova versão do Independent Gateway.
4. Opcional: substitua o arquivo tsighk-auth pela cópia original.
5. Atualize as configurações de TLS.
6. Opcional: atualize o Tableau Server de back-end
7. Reinicie o serviço do Independent Gateway.

## Etapa 1: copie os arquivos para referência

Pode ser necessário fazer referência às definições de configuração armazenadas nos arquivos a seguir. Copie esses arquivos para um local seguro e acessível (os caminhos dos arquivos são o local padrão):

- ProgramData\\Tableau\\tableau\_tsig\\config\\tsighk-auth.conf
- ProgramData\\Tableau\\tableau\_tsig\\config\\httpd.conf.stub
- ProgramData\\Tableau\\tableau\_tsig\\config\\environment.bash

## Etapa 2: desinstalar o gateway independente

Para remover o gateway independente dos servidores, use o desinstalador do Windows

1. Abra o painel de controle e acesse Aplicativos instalados.
2. Selecione Gateway independente do Tableau Server e clique em Desinstalar.
3. Reinicie o computador.
4. Exclua a pasta config.old encontrada em `C:\ProgramData\Tableau\Tableau Server\independentgateway\config.old`

## Etapa 2: instale o Independent Gateway

Baixe a versão do Independent Gateway para a qual deseja atualizar e siga o mesmo procedimento de instalação conforme descrito no tópico [Instalar o Tableau Server com Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_new_install.htm) .

Assim como na instalação original, você precisará especificar as configurações de inicialização como parte da configuração. Para usar os mesmos valores, consulte o arquivo `enviornment.bash` que você copiou na etapa 1. Não substitua o novo arquivo bash pelo original.

## Etapa 4: (opcional) substitua o arquivo tsighk-auth pela cópia original

O arquivo `tsighk-auth` é um arquivo de configuração que armazena uma cadeia de caracteres exclusiva chamada authsecret. O authsecret é usado para verificar se o Tableau Server de back-end está se comunicando com uma instância confiável do Independent Gateway. Ao configurar a instância original do Independent Gateway, você precisava atualizar um arquivo de configuração no back-end do Tableau Server com o authsecret.

Se a política de segurança permitir, você poderá continuar usando o authsecret original no Independent Gateway. Isso evita o processo de atualização e reinicialização do Tableau Server de back-end com um novo authsecret.

Para manter o authsecret original, sobrescreva o arquivo `tsighk-auth.conf` (localizado em`ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf`) pela cópia que você salvou na etapa 1.

Se a política de segurança exigir que você atualize o authsecret, anote o novo authsecret que foi gerado pelo processo de instalação. Você atualizará o Tableau Server de back-end com o novo authsecret posteriormente no processo.

## Etapa 5: atualize as configurações de TLS de limpeza

Se você não configurou o TLS para comunicação de manutenção (HK) entre instâncias de gateway independente e a implantação do Tableau Server de back-end, você pode pular esta etapa.

Se você configurou o HK TLS, deverá copiar manualmente a configuração do arquivo `httpd.conf.stub` original no arquivo localizado em `ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub`). Não substitua o novo arquivo pelo arquivo original, pois o arquivo mais recente pode incluir outras configurações.

1. Atualize as definições de configuração TLS relevantes no seguinte bloco:
    
    <VirtualHost \*:${TSIG\_HK\_PORT}>
    SSLEngine on
    #TLS# SSLHonorCipherOrder on
    #TLS# SSLCompression off
    SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
    SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
    SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>
    
    Para obter mais informações sobre essas configurações, consulte [Configurar TLS no Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_configure_tls.htm).
2. Quando você terminar de atualizar `httpd.conf.stub`, salve-o.
3. Copie `httpd.conf.stub` e, em seguida, salve para substituir `httpd.conf` no mesmo diretório.

## Etapa 6: (opcional) atualize a implantação do Tableau Server de back-end

Se você copiou o arquivo authsecret original (`tsighk-auth.conf`) para a nova instância do Independent Gateway conforme descrito na etapa 4, então pode pular esta etapa.

Se você estiver atualizando o authsecret na implantação do Tableau Server de back-end, deverá atualizar o arquivo `tsig.json` no nó inicial com o novo authsecret. Consulte [Instalar o Tableau Server com Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_new_install.htm). Ao concluir, execute os seguintes comandos TSM:

tsm stop

tsm topology external-services gateway update -c tsig.json

tsm start

## Etapa 7: reinicie o serviço tsig-httpd

Quando você terminar com a configuração, reinicie o serviço `tsig-httpd`.

<!-- document id=74510b43e1fa55257a1db4b3dd1559c281598465584a38861e818c68529a5f71 url=/tableau/current/pt-br/server/data_stories_parameter_refresh.md -->

[Pular para o conteúdo principal](#main-content)

# Atualizar parâmetros em uma história com dados do Tableau

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Se você adicionou um parâmetro ao seu painel e está usando Histórias com dados, notará que clicar no parâmetro atualiza sua visualização, mas não a história. Isso acontece porque o parâmetro não atualiza os dados subjacentes como um filtro faz.

Para atualizar sua História com dados do Tableau com os dados do parâmetro, adicione um botão "atualizar" ao seu painel que atualiza a história para alinhamento com o parâmetro.

1. Criar uma nova planilha na pasta de trabalho.
2. Crie um Campo calculado na nova planilha com as seguintes informações:

> > Nome: Atualizar
> > 
> > Conteúdo: "atualizar"

![Um campo calculado chamado "Atualizar" e contém a palavra "atualizar"](/tableau/current/pt-br/server/pt-br/Img/data_stories_parameter_calcfield.png)

1. Clique em OK e arraste o novo campo calculado (Atualizar) para sua nova planilha.
2. Clique com o botão direito do mouse no campo e clique em Mostrar cabeçalho para ocultar o cabeçalho.

![O menu aberto para Atualizar com “Mostrar cabeçalho” selecionado.](/tableau/current/pt-br/server/pt-br/Img/data_stories_parameter_showheader.png)

1. Escolha uma forma para o seu botão.

![O menu aberto para Marcar com Quadrado selecionado.](/tableau/current/pt-br/server/pt-br/Img/data_stories_parameter_shape.png)

1. Retorne ao seu painel e arraste a planilha que contém o botão de atualização para seu painel ao lado do parâmetro.
2. Passe o mouse sobre o botão, selecione Mais opções e clique em Título para ocultar o título.
3. Passe o mouse sobre o botão e clique em Usar como filtro.

![O objeto é selecionado, o ícone do filtro é clicado e “Usar como filtro” é selecionado.](/tableau/current/pt-br/server/pt-br/Img/data_stories_parameter_refreshfilter.png)

1. Ajuste seu parâmetro e clique no novo botão de atualização. O botão atualiza sua história para alinhar com o parâmetro.

<!-- document id=e790de0614808c2712dacd753fbe6b5a05bb0bc0978568233bee5b00f52d5474 url=/tableau/current/pt-br/server/security_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Autenticação

A autenticação verifica a identidade de um usuário. Todos que precisam acessar o Tableau Server, seja para gerenciar o servidor ou para publicar, navegar ou administrar conteúdo, deverão ser representados como um usuário no repositório do Tableau Server. O método de autenticação pode ser executado pelo Tableau Server (“autenticação local”) ou a autenticação pode ser executada por um processo externo. No último caso, é necessário configurar o Tableau Server para tecnologias de autenticação externa, como Kerberos, SSPI, SAML ou OpenID. Em todos os casos, não importa se a autenticação acontece de forma local ou externa, cada identidade de usuário deve ser representada no repositório do Tableau Server. O repositório gerencia os metadados de autorização das identidades do usuário.

Procurando o Tableau Server no Linux? Consulte [Autenticação](https://help.tableau.com/current/server-linux/pt-br/security_auth.htm "Abre o tópico em uma nova guia do navegador").

Embora todas as identidades de usuários estejam representadas e armazenadas no repositório do Tableau Server, você deve gerencias as contas de usuários do Tableau Server em um armazenamento de identidades. Há duas opções de armazenamento de identidades: LDAP e local. Tableau Server suporta diretórios LDAP arbitrários, mas foi otimizado para a implementação LDAP do Active Directory LDAP. Como alternativa, se não estiver executando um diretório LDAP, use o armazenamento de identidades local do Tableau Server. Para obter mais informações, consulte [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm).

Conforme mostrado na seguinte tabela, o tipo do armazenamento de identidades implementado determinará, em parte, suas opções de autenticação.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"></colgroup><tbody><tr><th rowspan="2"><p rowspan="2">Armazenamento&nbsp;</p><p rowspan="2">De identidade</p></th><th colspan="9">Mecanismo de autenticação</th></tr><tr><td>Básico</td><td>SAML</td><td>SAML do site</td><td>Kerberos</td><td>(Somente Windows)<p>Automático</p><p>Logon</p><p>(Microsoft</p><p>SSPI)</p></td><td>OpenID<p>Conectar</p></td><td>Aplicativos conectados</td><td>Trusted<p>Auth</p></td><td>Mútuo<p>SSL</p></td></tr><tr><td>Local</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td></tr><tr><td>Active<p>Diretório</p></td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td></tr><tr><td>LDAP</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td></tr></tbody></table>

As permissões de acesso e de gerenciamento são implementadas por meio de funções no site. As funções no site definem quais usuários são administradores e quais usuários são consumidores e publicadores de conteúdo no servidor. Para obter mais informações sobre administradores, funções de site, grupos, Usuário convidado e tarefas administrativas relacionadas ao usuário, consulte [Usuários](https://help.tableau.com/current/server/pt-br/users.htm) e [Funções de site para usuários](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

**Observação**: no contexto de autenticação, é importante entender que os usuários não estão autorizados a acessar fontes de dados externas pelo Tableau Server somente pelo fato de possuírem uma conta no servidor. Em outras palavras, na configuração padrão, o Tableau Server não funciona como proxy para fontes de dados externas. Esse tipo de acesso exige configuração adicional da fonte de dados no Tableau Server ou autenticação na fonte de dados quando o usuário se conecta pelo Tableau Desktop.

## Compatibilidade de autenticação complementar

Alguns métodos de autenticação podem ser usados juntos. A tabela a seguir mostra os métodos de autenticação que podem ser combinados. As células marcadas com um "X" indicam um conjunto de autenticação compatível. Células em branco indicam conjuntos de autenticação incompatíveis.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 11%;"><col style="width: 11%;"><col style="width: 11%;"><col style="width: 11%;"><col style="width: 11%;"><col style="width: 11%;"><col style="width: 11%;"><col style="width: 11%;"><col style="width: 11%;"></colgroup><tbody><tr><th>&nbsp;</th><td>Aplicativos conectados</td><td>Autenticação confiável</td><td>SAML de servidor</td><td>SAML do site</td><td>Kerberos</td><td>(Somente Windows)<p>Logon automático (Microsoft</p><p>SSPI)</p></td><td>SSL mútuo</td><td>OpenID Connect</td></tr><tr><td>Aplicativos conectados do Tableau</td><td style="text-align: center;">N/A</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td></tr><tr><td>Autenticação confiável</td><td>&nbsp;</td><td style="text-align: center;">N/A</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td></tr><tr><td>SAML de servidor</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">N/A</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td></tr><tr><td>SAML do site</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">N/A</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td></tr><tr><td>Kerberos</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">N/A</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td></tr><tr><td>Logon automático (Microsoft SSPI)</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">N/A</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td></tr><tr><td>SSL mútuo</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">N/A</td><td style="text-align: center;">&nbsp;</td></tr><tr><td>OpenID Connect</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">N/A</td></tr><tr><td>Token de acesso pessoal (PAT)</td><td style="text-align: center;"><b>*</b></td><td style="text-align: center;"><b>*</b></td><td style="text-align: center;"><b>*</b></td><td style="text-align: center;"><b>*</b></td><td style="text-align: center;"><b>*</b></td><td style="text-align: center;"><b>*</b></td><td style="text-align: center;"><b>*</b></td><td style="text-align: center;"><b>*</b></td></tr></tbody></table>

**\*** Os PATs, por design, não funcionam diretamente com o mecanismo de autenticação listado nessas colunas para autenticação na API REST. Em vez disso, os PATs usam credenciais de conta de usuário do Tableau Server para autenticação na API REST.

## Compatibilidade de autenticação do cliente

### Autenticação manipulada por meio de uma interface de usuário (IU)

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"></colgroup><tbody><tr><th rowspan="2"><p rowspan="2">Clientes</p></th><th colspan="9">Mecanismo de autenticação</th><td>&nbsp;</td></tr><tr><td>Básico</td><td>SAML</td><td>SAML do site</td><td>Kerberos</td><td>(Somente Windows)<p>Automático</p><p>Logon</p><p>(Microsoft</p><p>SSPI)</p></td><td>OpenID<p>Conectar</p></td><td>Aplicativos conectados</td><td>Trusted<p>Auth</p></td><td>Mútuo<p>SSL</p></td><td>Token de acesso pessoal (PAT)</td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span></td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td>&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td>&nbsp;</td></tr><tr><td><p>Tableau Prep Builder</p></td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td>&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td>&nbsp;</td></tr><tr><td>Tableau Mobile</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X<p>(somente no iOS <b>*</b>)</p></td><td style="text-align: center;">X<p><b>**</b></p></td><td style="text-align: center;">X</td><td>&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td>&nbsp;</td></tr><tr><td>Navegadores da Web</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td style="text-align: center;">X<p><b>***</b></p></td><td style="text-align: center;">X</td><td style="text-align: center;">X</td><td>&nbsp;</td></tr></tbody></table>

**\*** O Kerberos SSO não é compatível com Android, mas é possível usar o nome de usuário e a senha. Para obter mais informações, veja [Observação 5: plataforma Android](https://help.tableau.com/current/server/pt-br/kerberos_browser.htm#note5).

**\*\*** SSPI não é compatível com a versão Workspace ONE do aplicativo Tableau Mobile.

**\*\*\*** Somente na inserção de fluxos de trabalho.

### Autenticação manipulada programaticamente

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"><col style="width: 9%;"></colgroup><tbody><tr><th rowspan="2"><p rowspan="2">Clientes</p></th><th colspan="9">Mecanismo de autenticação</th><td>&nbsp;</td></tr><tr><td>Básico</td><td>SAML</td><td>SAML do site</td><td>Kerberos</td><td>(Somente Windows)<p>Automático</p><p>Logon</p><p>(Microsoft</p><p>SSPI)</p></td><td>OpenID<p>Conectar</p></td><td>Aplicativos conectados</td><td>Trusted<p>Auth</p></td><td>Mútuo<p>SSL</p></td><td>Token de acesso pessoal (PAT)</td></tr><tr><td>API REST</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td></tr><tr><td>tabcmd 2.0</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">X</td></tr><tr><td>tabcmd</td><td style="text-align: center;">X</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td><td style="text-align: center;">&nbsp;</td></tr></tbody></table>

## Autenticação local

Se o servidor estiver configurado para usar autenticação local, o Tableau Server autenticará os usuários. Quando os usuários fazem logon e inserem suas credenciais pelo Tableau Desktop, tabcmd, API ou cliente da Web, o Tableau Server verificará as credenciais.

Para habilitar esse cenário, primeiro é necessário criar uma identidade para cada usuário. Para criar uma identidade, especifique um nome de usuário e uma senha. Para acessar ou interagir com conteúdo no servidor, também é necessário atribuir uma função no site aos usuários. As identidades de usuário podem ser adicionadas ao Tableau Server na interface de usuário do servidor, com os [Comandos tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm) ou a [API REST](https://help.tableau.com/current/api/rest_api/pt-br/help.htm#REST/rest_api.htm).

Também é possível criar grupos no Tableau Server para ajudar a gerenciar e a atribuir funções a grandes conjuntos de grupos de usuários relacionados (ex., “Marketing”).

Ao configurar o Tableau Server para a autenticação local, é possível definir políticas de senha e bloqueio de conta no caso de tentativas de senha mal sucedidas. Consulte [Autenticação local](https://help.tableau.com/current/server/pt-br/local_auth.htm).

**Observação:** o Tableau com autenticação multifatorial (MFA) está disponível apenas para Tableau Cloud.

## Soluções de autenticação externa

O Tableau Server pode ser configurado para funcionar com uma série de soluções de autenticação externa.

### NTLM e SSPI

Se você configurar o Tableau Server para usar o Active Directory durante a instalação, o NTLM será o método de autenticação padrão do usuário.

Quando um usuário faz logon no Tableau Server pelo Tableau Desktop ou por um cliente da Web, as credenciais são enviadas para o Active Directory, que então as verifica e envia um token de acesso para o Tableau Server. O Tableau Server gerenciará o acesso de usuário aos recursos do Tableau com base nas funções no site armazenadas no repositório.

Se o Tableau Server estiver instalado em um computador com Windows no Active Directory, opcionalmente, será possível habilitar o logon automático. Nesse cenário, o Tableau Server usará o SSPI da Microsoft para fazer logon dos usuários automaticamente com base no nome de usuário e na senha do Windows. Isso cria uma experiência semelhante à de logon único (SSO).

Não habilite o SSPI se planeja configurar o Tableau Server para SAML, autenticação confiável, uma balanceador de carga ou servidor proxy. O SSPI não é compatível com esses cenários. Consulte [tsm authentication sspi <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMSspi).

### Kerberos

É possível configurar o Tableau Server para usar o Kerberos para o Active Directory. Consulte [Kerberos](https://help.tableau.com/current/server/pt-br/kerberos.htm).

### SAML

É possível configurar o Tableau Server para usar a autenticação SAML (Security Assertion Markup Language). Com o SAML, um provedor de identidade externo (IdP) autentica as credenciais do usuário e depois envia uma asserção de segurança ao Tableau Server, que fornece as informações sobre a identidade do usuário.

Para obter mais informações, consulte [SAML](https://help.tableau.com/current/server/pt-br/saml.htm).

### OpenID Connect

O OpenID Connect (OIDC) é um protocolo de autenticação padrão que permite aos usuários fazer logon em um provedor de identidade (IdP) como o Google. Após fazerem logon com sucesso no IdP, eles entram automaticamente no Tableau Server. Para usar o OIDC no Tableau Server, o servidor deve ser configurado para usar o armazenamento de identidades local. Os armazenamentos de identidades Active Directory ou LDAP não são suportados com OIDC. Para obter mais informações, consulte [OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth.htm).

### SSL mútuo

Usando SSL mútuo, você pode fornecer aos usuários do Tableau Desktop, Tableau Mobile e a outros clientes aprovados do Tableau uma experiência segura e de acesso direto ao Tableau Server. Com o SSL mútuo, quando um cliente com um certificado SSL válido se conecta ao Tableau Server, o Tableau Server confirma a existência do certificado do cliente e autentica o usuário, com base no nome do usuário no certificado do cliente. Se o cliente não tiver um certificado SSL válido, o Tableau Server pode recusar a conexão. Para obter mais informações, consulte [Configurar autenticação do SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm).

### Aplicativos conectados

#### Confiança direta

Os aplicativos conectados ao Tableau permitem uma experiência de autenticação contínua e segura, facilitando uma relação de confiança explícita entre o site do Tableau Server e os aplicativos externos onde o conteúdo do Tableau é inserido. O uso de aplicativos conectados também permite uma maneira programática de autorizar o acesso à API REST do Tableau usando JSON Web Tokens (JWTs). Para obter mais informações, consulte [Uso de aplicativos conectados do Tableau para integração de aplicativos](https://help.tableau.com/current/server/pt-br/connected_apps.htm)

#### Confiança de EAS ou OAuth 2.0

Você pode registrar um servidor de autorização externo (EAS) com o Tableau Server para estabelecer uma relação de confiança entre o Tableau Server e um EAS usando o protocolo padrão OAuth 2.0. A relação de confiança oferece a seus usuários uma experiência de logon único, por meio de seu IdP, para o conteúdo inserido do Tableau. Além disso, registrar um EAS permite uma maneira programática de autorizar o acesso à API REST do Tableau usando JSON Web Tokens (JWTs). Para obter mais informações, consulte [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm).

### Autenticação confiável

A autenticação confiável (também referida como "tíquetes confiáveis") permite a configuração de uma relação confiável entre o Tableau Server e um ou mais servidores da Web. Quando o Tableau Server recebe solicitações de um servidor Web confiável, ele supõe que o servidor Web já tratou de qualquer autenticação necessária. O Tableau Server recebe a solicitação com um token ou ticket resgatável e apresenta ao usuário uma exibição personalizada que leva em consideração a função e as permissões do usuário. Para obter mais informações, consulte [Autenticação confiável](https://help.tableau.com/current/server/pt-br/trusted_auth.htm).

### LDAP

Você também pode configurar o Tableau Server para usar o LDAP para a autenticação do usuário. Os usuários são autenticados enviando suas credenciais ao Tableau Server, que tentará associar-se à instância do LDAP usando as credenciais do usuário. Se a associação funcionar, as credenciais serão válidas e o Tableau Server concederá uma sessão ao usuário.

A "associação" é a etapa de comunicação/autenticação que acontece quando um cliente tenta acessar um servidor LDAP. O Tableau Server faz isso sozinho ao realizar várias consultas relacionadas à não autenticação (como importar usuários e grupos).

Você pode configurar o tipo de associação que deseja que o Tableau Server use ao verificar as credenciais do usuário. O Tableau Server suporta associação GSSAPI e simples. As associações simples passam as credenciais diretamente para a instância do LDAP. Recomenda-se a configuração de SSL para criptografar a comunicação de associação. A autenticação nesse cenário pode ser fornecida pela solução LDAP nativa ou por um processo externo, como o SAML.

Para obter mais informações sobre como planejar e configurar o LDAP, consulte [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm#plan) e [Referência de configuração do armazenamento de identidades externo](https://help.tableau.com/current/server/pt-br/ldap_config.htm).

### SCIM

O sistema de gerenciamento de usuários entre domínios (SCIM) no Tableau Server é um padrão para automatizar o provisionamento e o gerenciamento de usuários e grupos de provedores de identidade (IdPs) externos baseados em nuvem. Embora o SCIM não seja um método de autenticação, ele provisiona usuários que se autenticam usando os métodos configurados para o Tableau Server. Para obter mais informações, consulte [SCIM](https://help.tableau.com/current/server/pt-br/scim_config_online.htm).

## Outros cenários de autenticação

- API REST: [Entrar e sair (Autenticação)](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api_concepts_auth.htm)
    
    **Observação**: a REST API e o tabcmd não oferecem suporte ao logon único (SSO) do SAML.
- Autenticação de dispositivo móvel: [Logon único para o Tableau Mobile](https://help.tableau.com/current/mobile/mobile-admin/Pt-br/admin_mobile_sso.htm)
- Confiança de certificado de clientes do TSM: [Conexão de clientes do TSM](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti)

## Autenticação de acesso a dados e de fonte de dados

É possível configurar o Tableau Server para oferecer suporte a uma série de protocolos de autenticação diferentes para várias fontes de dados distintas. A autenticação da conexão de dados pode ser independente da autenticação do Tableau Server.

Por exemplo, é possível configurar a autenticação do usuário no Tableau Server usando a autenticação local, enquanto a autenticação OAuth ou a do SAML estiver sendo configurada para fontes de dados específicas. Consulte [Autenticação de conexões de dados](https://help.tableau.com/current/server/pt-br/security_data_connection_auth.htm).

## Outros artigos nesta seção

<!-- document id=df24acb6648b3799984bc1773465ce81762d6063424acc4c69b62e1571949601 url=/tableau/current/pt-br/server/rmt-admin-authentication-PAM.md -->

[Pular para o conteúdo principal](#main-content)

# Autenticação baseada em PAM no Resource Monitoring Tool do Tableau (RMT)

A partir da versão 2025.2, a autenticação baseada em PAM para usuários delegados foi adicionada. Isso permite que os clientes implementem lógica de autenticação personalizada, se necessário.

Anteriormente, o RMT dependia apenas de `su` para a autenticação do usuário delegada, o que poderia levar a inconsistências se as políticas de autenticação subjacentes do Linux fossem diferentes entre o Tableau Server e o RMT. Ao adicionar suporte para PAM, o RMT se alinha ao fluxo de autenticação do Tableau Server, proporcionando mais flexibilidade e controle.

O RMT usa autenticação local (senhas específicas do RMT) ou delegada (credenciais baseadas no sistema operacional) para acesso de usuário, com a autenticação delegada exigindo que os usuários forneçam sua senha de rede padrão para logon. A autenticação é configurada no RMT Server por meio de sua interface da Web ou da ferramenta de linha de comando `rmtadmin`, em que os usuários podem ser adicionados ou seus modos de autenticação existentes alterados. A configuração adequada inclui garantir que o `username` seja inserido corretamente (sem domínio para autenticação delegada) e que as funções de servidor RMT corretas sejam atribuídas aos usuários. Para obter informações sobre as funções de servidor, consulte [Gerenciar usuários e autenticação no Resource Monitoring Tool do Tableau (RMT)](https://help.tableau.com/current/server/pt-br/rmt-server-roles.htm).

## Como funciona a autenticação baseada em PAM no RMT

Quando o RMT autentica um usuário delegado, ele segue o mesmo fluxo de autenticação do Tableau Server:

1. Serviço PAM personalizado (tableau)
    
    Inicialmente, o RMT tentará autenticar o usuário usando um serviço PAM personalizado chamado `tableau`, se presente em:
    
    /etc/pam.d/tableau
    
    Isso permite que os clientes definam suas próprias políticas de autenticação.
2. Serviço de logon PAM padrão
    
    Se o Tableau Service não estiver definido, o RMT voltará a usar o serviço de logon PAM padrão para autenticação.
3. autenticação baseada em su
    
    Se ambas as tentativas de PAM falharem, o RMT finalmente tentará a autenticação usando `su`.
    
    Esse é o método padrão de autenticação em versões anteriores a 2025.2 e continua válido para garantir a retrocompatibilidade com versões anteriores do RMT e ambientes existentes.

## Como habilitar a autenticação baseada em PAM no RMT

Para usar a autenticação baseada em PAM no RMT, os seguintes pré-requisitos devem ser atendidos:

1. 1\. Instale o `pamtester`
    
    O RMT usa `pamtester` para executar a autenticação PAM não interativa.
    
    Debian/Ubuntu:
    
    sudo apt install pamtester
    
    RHEL/CentOS:
    
    sudo yum install pamtester
2. Defina permissões para `pamtester`
    
    O binário `pamtester` deve receber as permissões apropriadas para permitir a autenticação:
    
    sudo chown root:root /usr/bin/pamtester  
    sudo chmod u+s /usr/bin/pamtester
    
    A permissão `setuid` (`u+s`) garante que `pamtester` possa ler `/etc/shadow`, que é necessário para que a maioria dos módulos PAM execute verificações de senha.

### Implementar um serviço PAM personalizado (opcional)

Se desejar implementar sua própria lógica de autenticação personalizada, você poderá definir um serviço PAM chamado `tableau`:

 `/etc/**pam.d/tableau**`

<!-- document id=73165e77ab99a6beaa2ab7a1fdcfe346511a5c1277a2205db6c85b9f7001698c url=/tableau/current/pt-br/server/trusted_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Autenticação confiável

Quando você insere exibições do Tableau Server em páginas da Web, todos que visitarem a página deverão ser um usuário licenciado no Tableau Server. Ao visitarem a página, os usuários são solicitados a entrarem no Tableau Server para que possam ver a exibição. Caso já tenha uma maneira de autenticar usuários na página da Web ou em seu aplicativo Web, você pode evitar essa solicitação e evitar que seus usuários precisem entrar duas vezes configurando a autenticação confiável.

A autenticação confiável simplesmente significa que você configurou um relacionamento confiável entre o Tableau Server e um ou mais servidores Web. Quando o Tableau Server recebe solicitações desses servidores Web confiáveis, ele supõe que o servidor já foi tratado, independentemente de a autenticação ser necessária.

Se seu servidor Web usar SSPI (Security Support Provider Interface), você não precisará configurar a autenticação confiável. É possível inserir exibições, e seus usuários terão acesso seguro a elas desde que sejam usuários e membros licenciados do Tableau Server do seu Active Directory.

**Observação:** os navegadores de cliente devem ser configurados para [permitir cookies de terceiros](https://help.tableau.com/current/server/pt-br/trusted_auth_trouble_cookie.htm) se desejar usar autenticação confiável com exibições inseridas.

## Como funciona a autenticação confiável

O diagrama abaixo descreve como a autenticação confiável funciona entre o navegador da Web do cliente, seu servidor Web e o Tableau Server.

![Um diagrama ilustra o fluxo de dados entre servidores Web, o Tableau Server e um navegador da Web do cliente.](/tableau/current/pt-br/server/pt-br/Img/trusted_auth_666x421.png)

![Um círculo azul com um número branco 1 no centro.](/tableau/current/pt-br/server/pt-br/Img/1ball.png)**O usuário visita a página da Web**: quando um usuário visita a página da Web com a exibição inserida do Tableau Server, a página da Web envia uma solicitação GET a seu servidor Web para o HTML dessa página.

![Um círculo azul com um número 2 branco no centro.](/tableau/current/pt-br/server/pt-br/Img/2ball.png)**O servidor Web envia POSTS ao Tableau Server**: o servidor Web envia uma solicitação POST ao Tableau Server confiável (por exemplo, `https://<server_name>/trusted`, não `https://<server_name>`). Essa solicitação POST deve ter um parâmetro `username`. O valor de `username` deve ser o nome de um usuário licenciado do Tableau Server. Se o Tableau Server estiver hospedando vários sites e a exibição estiver em um site que não seja o site padrão, a solicitação POST também deverá incluir um parâmetro `target_site`.

![Um círculo azul com um número 3 branco no centro.](/tableau/current/pt-br/server/pt-br/Img/3ball.png)**O Tableau Server cria um ticket**: O Tableau Server verifica o endereço IP ou o nome de host do servidor Web (192.168.1.XXX no diagrama acima) que enviou a solicitação POST. Se o servidor Web estiver listado como um host confiável, o Tableau Server criará um ticket na forma de uma cadeia de caracteres exclusiva. Os tickets devem ser resgatados em até três minutos, a contar de quando foram emitidos. O Tableau Server responde à solicitação POST com esse ticket. Ou se houver um erro e não for possível criar o ticket, o Tableau Server responderá com um valor de `-1`. O servidor deve ter um endereço IPv4. Os endereços IPv6 não são compatíveis Para obter mais informações, consulte [Valor de ticket -1 retornado pelo Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_trouble_1return.htm).

![Um círculo azul com um número 4 branco no centro.](/tableau/current/pt-br/server/pt-br/Img/4ball.png)**O servidor Web passa a URL para o navegador:** O servidor Web constrói a URL para a exibição e a insere no HTML da página. O tíquete está incluído (por exemplo,`https://<server_name>/trusted/<unique_ticket>/views/<view_name>` ) O servidor Web passa o HTML de volta ao navegador da Web do cliente.

![Um círculo azul com um número 5 branco no centro.](/tableau/current/pt-br/server/pt-br/Img/5ball.png)**O navegador solicita a exibição do Tableau Server:** o navegador da Web do cliente envia uma solicitação GET ao Tableau Server que inclui a URL com o ticket.

![Um círculo azul com um número 6 branco no centro.](/tableau/current/pt-br/server/pt-br/Img/6ball.png)**O Tableau Server resgata o ticket:** o Tableau Server resgata o ticket, cria uma sessão, conecta o usuário, remove o ticket da URL e envia a URL final da exibição inserida para o cliente. Os tíquetes confiáveis só podem ser resgatados para exibições.

A sessão permite ao usuário acessar qualquer uma das exibições que teria acesso se estivesse conectado ao servidor. Na configuração padrão, os usuários autenticados com tickets confiáveis têm acesso restrito, para que apenas as exibições estejam disponíveis. Eles não podem acessar pastas de trabalho, páginas de projeto ou outro conteúdo hospedado no servidor.

Para alterar este comportamento, consulte a opção `wgserver.unrestricted_ticket` em [wgserver.unrestricted\_ticket](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#unrestricted_tickets).

## Como um ticket confiável é armazenado?

O Tableau Server armazena tíquetes confiáveis no repositório do Tableau Server usando o seguinte processo:

1. O Tableau Server gera um ticket de duas partes: a primeira é uma ID exclusiva (UUID) codificada com Base64 e a segunda é uma cadeia de caracteres secreta aleatória de 24 caracteres.
2. O Tableau Server utiliza hash na cadeia de caracteres secreta e armazena-a com a ID exclusiva no repositório. A função hash usa a cadeia de caracteres secreta como entrada e um algoritmo para calcular uma cadeia de caracteres exclusiva. A cadeia de caracteres exclusiva protege a segurança da cadeia de caracteres secreta de usuários não autorizados.
3. O Tableau Server envia a UUID com Base64 e a cadeia de caracteres aleatória com 24 caracteres original para o cliente.
4. O cliente retorna a UUID com Base64 e a cadeia de caracteres aleatória com 24 caracteres original para o Tableau Server, como parte da solicitação para uma exibição.
5. O Tableau Server localiza o par de cadeias de caracteres com a UUID com Base64 e, em seguida, usa hash na cadeia de caracteres aleatória para verificar se corresponde a hash armazenada no repositório.

Esse processo garante que qualquer conteúdo de ticket armazenado no Tableau Server não possa ser usado para representar usuários ou acessar conteúdo protegido por autenticação. No entanto, como o ticket confiável completo é enviado via HTTP entre o Tableau Server e o cliente, o processo depende da transmissão segura e criptografada de dados HTTP. Portanto, recomendamos que você só implante tickets confiáveis via SSL/TLS ou por outra camada de criptografia de rede.

## Outros artigos nesta seção

<!-- document id=6434b1b58b2d801b86bc89cbfb9ff86e75195883ccb9fd609c6213ad496471e8 url=/tableau/current/pt-br/server/trusted_auth_testing.md -->

[Pular para o conteúdo principal](#main-content)

# Autenticação confiável de teste

As etapas abaixo fornecem um método que você pode usar para testar a recuperação de um ticket confiável do seu servidor da Web. Este teste simples pode ajudar a avaliar a conectividade entre o servidor Web e o Tableau Sever, e se a autenticação confiável foi ou não configurada corretamente.

**Importante**: o código de teste fornecido neste tópico executa do lado do cliente no navegador para fornecer uma validação visual rápida de que a autenticação confiável está configurada corretamente no Tableau Server. Se o navegador do cliente que carrega a página html não estiver no servidor da Web confiável, você pode ter que confiar temporariamente no IP do cliente. Na prática, você nunca deve confiar em endereços IP do cliente como parte da configuração de autenticação confiável. Todos os endereços IP confiáveis podem solicitar tickets como qualquer usuário, incluindo o administrador. Em um ambiente de produção, todos os fluxos de autenticação confiáveis devem ser executados do lado do servidor, entre o Tableau Server e os servidores da Web confiáveis.

Como o teste é executado em um navegador do cliente, ele não é uma réplica exata do caminho de comunicação em um ambiente de produção. Depois de executar com sucesso o teste, recomendamos que teste solicitando bilhetes para os usuários com uma solicitação de pós-verificação final do lado do servidor.

Um método de teste alternativo é executar um gerador de tickets confiável para testar a configuração. A URL a seguir faz referência a um gerador de tickets confiável que não é compatível com o Tableau. No entanto, o gerador tem sido usado por muitos clientes para testar a configuração de ticket confiável: [https://github.com/mkannan-tsi/Trusted-Ticket-Generator](https://github.com/mkannan-tsi/Trusted-Ticket-Generator).

## Etapa 1: adicionar um usuário de teste

Crie um usuário no Tableau Server que possa ser usado para testar a funcionalidade do ticket confiável. Consulte [Adicionar usuários ao Tableau Server](https://help.tableau.com/current/server/pt-br/users_add.htm). Adicione esse usuário a um site no servidor.

## Etapa 2: criar um página HTML de teste

Cole o código a seguir em um novo arquivo .html que você salvou na máquina do Tableau Server de onde está realizando o teste. É possível alterar os rótulos e os atributos de estilo conforme desejado.

<html>
<head>
<title>Trusted Ticket Requester</title>
<script type="text/javascript">
  function submitForm(){
    document.getElementById('form1').action =
    document.getElementById('server').value + "/trusted";
  }
</script>
<style type="text/css">
  .style1 {width: 100%;}
  .style2 {width: 429px;}
  #server {width: 254px;}
</style>
</head>
<body>
<h3>Trusted Ticketer</h3>
<form method="POST" id="form1" onSubmit="submitForm()">
  <table class="style1">
    <tr>
      <td class="style2">Username</td>
      <td><input type="text" name="username" value="" /></td>
    </tr>
    <tr>
      <td class="style2">Server</td>
      <td><input type="text" id="server" name="server" value="https://" /></td>
    </tr>
    <tr>
      <td class="style2">Client IP (optional)</td>
      <td><input type="text" id="client\_ip" name="client\_ip" value="" /></td>
    </tr>
    <tr>
      <td class="style2">Site (leave blank for Default site; otherwise enter the site name)</td>
      <td><input type="text" id="target\_site" name="target\_site" value="" /></td>
    </tr>
    <tr>
      <td class="style2"><input type="submit" name="submittable" value="Get Ticket" /></td>
      <td>&#160;</td>
    </tr>
  </table>
</form>
<h4>Be sure to add your IP as a Trusted IP address to the server</h4>
</body>
</html>

## Etapa 3: recuperar um ticket confiável do Tableau Server

O procedimento a seguir retornará um ticket confiável do Tableau Server.

1. Abra a página da Web criada na etapa anterior.
    
    ![Um formulário para adquirir um tíquete seguro fornecendo um nome de usuário, servidor e, opcionalmente, um IP de cliente e site.](/tableau/current/pt-br/server/pt-br/Img/trusted_auth_test.png)
    
    Essa operação requer JavaScript, portanto, o navegador da Web poderá solicitar a permissão para que os scripts sejam executados.
2. Nas caixas de texto, insira o seguinte:
    
    - **Username**: o usuário de teste criado na Etapa 1.
    - **Servidor**: o endereço do Tableau Server, por exemplo, `https://<server_name>`.
    - **IP do cliente (opcional)**: o endereço IP do computador do usuário, se estiver configurado para o IP de cliente confiável correspondente.
    - **Site**: o nome do site do Tableau Server no qual o usuário de teste é membro.
3. Clique em **Obter ticket**. Uma das seguintes opções será retornada:
    
    - **Um ticket exclusivo**: um ticket confiável é uma cadeia de caracteres composta por uma UUID codificada com Base64 e uma cadeia de caracteres aleatória de 24 caracteres, por exemplo, `9D1OlxmDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5`.
    - **\-1**: se o valor, `-1` for retornado, a configuração terá um erro. Consulte [Valor de ticket -1 retornado pelo Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_trouble_1return.htm).

## Etapa 4: testar acesso com um ticket confiável

Agora que você tem um ticket, é possível usá-lo para acessar o conteúdo no Tableau Server.

Crie uma URL com o ticket único gerado na etapa anterior para verificar o acesso com o ticket confiável. A sintaxe da URL é diferente se você estiver acessando um Tableau Server com um site único, em vez de um servidor que hospeda vários sites.

**URL de servidor de site padrão**

`https://<server_name>/trusted/<unique_ticket>/views/<workbook_name>/<view_name>`

**URL de servidor de site não padrão**

`https://<server_name>/trusted/<unique_ticket>/t/<site_name>/views/<workbook_name>/<view_name>`

As variáveis nas URLs são indicadas por parênteses (`<` e `>`). Todas as outras sintaxes são literais.

<!-- document id=802dc63d884a5a18b507a793741b533bc8e41803bc592f0622f0498ed7e3b8ea url=/tableau/current/pt-br/server/security_data_connection_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Autenticação de conexões de dados

Configure a autenticação de conexão de dados usando Kerberos, OAuth e logon único.

## Outros artigos nesta seção

## Mais informações

- [Definir uma conexão do Oracle para usar TNSNames.ora ou LDAP.ora](http://kb.tableau.com/articles/howto/setting-an-oracle-connection-to-use-tnsnames-ora-or-ldap-ora?lang=pt-br) (suporte do Tableau)

<!-- document id=a565653d1cccf26a3ec8de3811922b8f0336df8e3bfa96fce64528b82f5b20c7 url=/tableau/current/pt-br/server/local_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Autenticação local

Se o servidor estiver configurado para usar o armazenamento de autenticação local, o Tableau Server autenticará os usuários. Quando os usuários fazem logon e inserem suas credenciais, pelo Tableau Desktop, tabcmd, API ou cliente Web, o Tableau Server verifica as credenciais. Os nomes de usuário do Tableau armazenados no repositório são associados a direitos e permissões do Tableau Server. Após a verificação da autenticação, o Tableau Server gerencia o acesso do usuário (autorização) aos recursos do Tableau.

Para usar a autenticação local, você deve configurar o Tableau Server com um armazenamento de identidades local durante a Instalação. Não é possível usar a autenticação local se o Tableau Server tiver sido configurado com um armazenamento de identidades externo (LDAP, Active Directory etc.).

**Observação:** Os pools de identidades, que são uma ferramenta projetada para complementar e oferecer suporte a opções adicionais de provisionamento e autenticação de usuários que você pode precisar em sua organização, oferecem suporte apenas à autenticação OpenID Connect (OIDC). Para obter mais informações, veja [Provisionar e autenticar usuários usando grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Armazenamento de senha

Quando a autenticação local é usada, a senha do usuário com hash e salt é armazenada no repositório. As senhas nunca são armazenadas diretamente, em vez disso, o resultado de colocar salt e hash na senha é armazenado. O servidor usa a função de derivação PBKDF2 com a função de hashing HMAC SHA512.

## Definir configurações de senha

Depois de instalar o Tableau Server com autenticação local, você pode usar o Tableau Server Manager (TSM) para configurar várias configurações relacionadas à senha:

- Políticas de senha: essas políticas definem o requisito para a estrutura de senhas, como comprimento, tipos de caracteres e outros requisitos.
- Expiração de senha: habilite e especifique a expiração da senha.
- Limite da taxa de logon: o Tableau Server limita o tempo entre as tentativas de logon após os usuários inserirem 5 senhas incorretas. Os usuários precisarão aguardar alguns segundos antes de tentar logar novamente. Se os usuários continuarem a inserir senhas incorretas, eles deverão aguardar por períodos exponencialmente longos de tempo entre as tentativas de entrada. Por padrão, o tempo máximo entre tentativas de entrada é de 60 minutos.
    
    Bloquear o acesso à conta após muitas tentativas malsucedidas. Especifique quantas tentativas malsucedidas os usuários têm permissão para inserir antes de serem bloqueados. Para obter informações sobre como desbloquear o acesso a uma conta bloqueada, consulte [Exibir e gerenciar usuários em um site](https://help.tableau.com/current/server/pt-br/users_view.htm#ViewEditSiteUser).
- Redefinição de senha do usuário: permite que os usuários redefinam senhas. A ativação da redefinição de senha configurará o Tableau Server para exibir um link na página de logon. Os usuários que esquecerem as senhas ou desejarem redefinir uma senha podem clicar no link para iniciar um fluxo de trabalho de redefinição de senha. A redefinição de senha deve ser configurada usando o CLI do TSM, conforme descrito abaixo.

1. Abra o TSM em um navegador como administrador de servidor:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique em Identidade e acesso de usuário na guia Configuração, em seguida clique em Método de autenticação.
3. Selecione Autenticação local no menu suspenso para exibir as configurações de senha.
4. Configure as definições de senha e clique em Salvar alterações pendentes.
5. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
6. Clique em Aplicar alterações e reiniciar.

Para a configuração inicial das políticas de senha, recomendamos usar o modelo do arquivo de configuração abaixo para criar um arquivo json. Além disso, é possível definir qualquer chave de configuração única listada abaixo com a sintaxe descrita em [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet).

1. Copie o modelo json abaixo em um arquivo. Preencha os valores principais com a configuração da política de senha. Consulte a seção de referência a seguir para obter mais informações sobre as opções principais.
    
    {
    
    "configKeys": {
    
     "wgserver.localauth.policies.mustcontainletters.enabled": `false`,
    
      "wgserver.localauth.policies.mustcontainuppercase.enabled": `false`,
    
      "wgserver.localauth.policies.mustcontainnumbers.enabled": `false`,
    
      "wgserver.localauth.policies.mustcontainsymbols.enabled": `false`,
    
      "wgserver.localauth.policies.minimumpasswordlength.enabled": `false`,
    
      "wgserver.localauth.policies.minimumpasswordlength.value": `8`,
    
      "wgserver.localauth.policies.maximumpasswordlength.enabled": `false`,
    
      "wgserver.localauth.policies.maximumpasswordlength.value": `255`,
    
      "wgserver.localauth.passwordexpiration.enabled": `false`,
    
      "wgserver.localauth.passwordexpiration.days": `90`,
    
      "wgserver.localauth.ratelimiting.maxbackoff.minutes": `60`,
    
      "wgserver.localauth.ratelimiting.maxattempts.enabled": `false`,
    
      "wgserver.localauth.ratelimiting.maxattempts.value": _5_,
    
      "vizportal.password\_reset": `false`
    
    		}
    
    }
2. Execute `tsm settings import -f file.json` para passar o arquivo json com os valores adequados ao Tableau Services Manager e configurar o Tableau Server.
3. Execute o comando `tsm pending-changes apply` para aplicar as alterações. Consulte [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply).

### Referência do arquivo de configuração

Esta tabela lista todas as opções que podem ser usadas para configurar as políticas de senha.

wgserver.localauth.policies.mustcontainletters.enabled

Valor padrão: `false`

Exigir pelo menos uma letra nas senhas.

wgserver.localauth.policies.mustcontainuppercase.enabled

Valor padrão: `false`

Exigir pelo menos uma letra maiúscula nas senhas.

wgserver.localauth.policies.mustcontainnumbers.enabled

Valor padrão: `false`

Exigir pelo menos uma letra de número nas senhas.

wgserver.localauth.policies.mustcontainsymbols.enabled

Valor padrão: `false`

Exigir pelo menos um caractere especial nas senhas.

wgserver.localauth.policies.minimumpasswordlength.enabled

Valor padrão: `false`

Impor senhas com comprimento mínimo.

wgserver.localauth.policies.minimumpasswordlength.value

Valor padrão: `8`

O número vmínimo de caracteres que as senhas devem ter. Insira um valor entre `4` e `255`, inclusive. Você deve definir `wgserver.localauth.policies.minimumpasswordlength.enabled` como `true` para forçar esse valor.

wgserver.localauth.policies.maximumpasswordlength.enabled

Valor padrão: `false`

Impor senhas com comprimento máximo.

wgserver.localauth.policies.maximumpasswordlength.value

Valor padrão: `255`

O número máximo de caracteres que as senhas podem ter. Insira um valor entre `8` e `225`, inclusive. Você deve definir `wgserver.localauth.policies.maximumpasswordlength.enabled` como `true` para forçar esse valor.

wgserver.localauth.passwordexpiration.enabled

Valor padrão: `false`

Forçar expiração de senha.

wgserver.localauth.passwordexpiration.days

Valor padrão: `90`

O número de dias antes de uma senha expirar. Insira um valor entre `1` e `365`, inclusive. Você deve definir `wgserver.localauth.passwordexpiration.enabled` como `true` para forçar esse valor.

wgserver.localauth.ratelimiting.maxbackoff.minutes

Valor padrão: `60`

Tempo máximo entre tentativas de logon após um usuário inserir várias senhas incorretas. Insira um valor entre `5` e `1440`, inclusive.

wgserver.localauth.ratelimiting.maxattempts.enabled

Valor padrão: `false`

Aplicar bloqueio de conta após 5 senhas incorretas inseridas. Para alterar o número de senhas incorretas que acionarão o bloqueio de conta, defina `wgserver.localauth.ratelimiting.maxattempts.value`.

wgserver.localauth.ratelimiting.maxattempts.value

Valor padrão: `5`

O número de senhas incorretas que um usuário pode inserir para acionar o bloqueio da conta. Insira um valor entre `5` e `100`, inclusive. Você deve definir `wgserver.localauth.ratelimiting.maxattempts.enabled` como `true` para forçar esse valor.

vizportal.password\_reset

Valor padrão: `false`

Permitir que os usuários redefinam senhas. O Tableau Server deve ser configurado para enviar e-mail para que esse recurso funcione. Consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

<!-- document id=dd24c8799281cfa6dd072462d4e8909c672c65eefe9d60a2b08c07f76358e1cc url=/tableau/current/pt-br/server/ts_gcp_single_server.md -->

[Pular para o conteúdo principal](#main-content)

# Auto implantar um único Tableau Server no Google Cloud Platform

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

É possível instalar e executar o Tableau Server em uma máquina virtual (VM) do Google Compute Engine (GCE). Realize as tarefas a seguir para instalar e configurar o Tableau Server em uma VM do Google Compute Engine.

## Etapa 1: configurar uma VM do Google Compute Engine

Crie uma máquina virtual (VM) do Google Compute Engine onde o Tableau Server será instalado.

1. Faça logon no [Console do Google Cloud Platform](https://console.cloud.google.com/) (https://console.cloud.google.com/).
2. Caso ainda não tenha, crie um novo projeto e defina a cobrança. Para obter mais informações, consulte [Criação e gerenciamento de projetos](https://cloud.google.com/resource-manager/docs/creating-managing-projects) no site do Google.
3. No painel do Google Cloud Platform, no painel de navegação, em **Computar**, clique em **Compute Engine**.
4. Na caixa de diálogo **Instância de VM do Compute Engine**, clique em **Criar**.
5. Na página **Criar uma instância**, especifique as seguintes propriedades da instância:
    
    1. **Nome:** insira um nome para sua máquina virtual (VM).
    2. **Zona:** para ajudar a reduzir a latência, escolha a zona mais próxima a sua fonte de dados e usuários.
    3. **Tipo de máquina:** selecione uma VM que atenda aos [requisitos de sistema](https://help.tableau.com/current/server/pt-br/ts_gcp_virtual_machine_selection.htm) do Tableau Server. Por exemplo, selecione o tipo de máquina **n1-standard-16**, clique em **Personalizar**, em seguida aumente a memória para **64 GB**.
    4. **Contêiner:** se selecionado, desmarque a caixa de seleção **Implantar uma imagem de contêiner a esta instância de VM** (o padrão).
    5. **Disco de inicialização:** clique em **Alterar**, selecione **Windows Server 2016 Datacenter** com um disco persistente SSD de 128 GB SSD e, em seguida, clique em **Selecionar**.
    6. **Acesso de identidade e API:** use a configuração padrão.
    7. **Firewall:** selecione **Permitir tráfego HTTP** e **Permitir tráfego HTTPS**.
6. Ao concluir as configurações, revise sua seleções e clique em **Criar**.

## Etapa 2: conectar à sua VM do Google Compute Engine

Após criar sua máquina virtual (VM) do Google Compute Engine (GCE), é necessário conectá-la e prepará-la para instalar o Tableau Server.

1. No console **Compute Engine**, clique em **instâncias da VM**.
2. Na lista de instâncias da VM, selecione sua instância.
3. Na coluna **Conectar**, clique no menu suspenso **RDP**, em seguida em **Definir senha do Windows**.
4. Na caixa de diálogo **Definir nova senha do Windows**, no campo **Nome de usuário**, especifique um nome de usuário (ou deixe o nome padrão). Armazene o nome de usuário em um local seguro.
5. Clique em **Definir** para gerar uma senha. Pode demorar alguns segundos antes que a caixa de diálogo **Nova senha do Windows** seja exibida. Armazene a senha em um local seguro.
    
    **Importante:** essa é sua única oportunidade para copiar a senha.
6. Na página **Instancia da VM**, na coluna **Conectar**, clique no menu suspenso **RDP** e selecione **Baixar o arquivo RDP**. Salve o arquivo .rdp em seu computador.
7. Conecte-se a sua VM usando o arquivo .rdp salvo. Forneça o nome de usuário e senha gerados acima para a VM do Google Compute Engine. (Se já estiver conectado a uma rede do Windows, como a rede de sua empresa, selecione **Outro usuário** e insira as credenciais nas caixas.)
    
    Você verá uma ou mais mensagens o informando que a conexão remota não pode ser identificada. Isso é normal.
    
    **Observação:** o arquivo RDP faz referência à instância usando um endereço IP externo. Por padrão, este é um endereço IP efêmero, que pode ser renovado ao interromper ou iniciar o servidor. Nesse caso, será necessário ter uma nova cópia do arquivo RDP. Para uso a longo prazo, o GCP fornece endereços IP estatísticos a um custo adicional.
    
    O RDP (Remote Desktop) o conecta à VM do Google Compute Engine.

Para obter mais informações sobre como se conectar às VMs do Google Compute Engine, consulte [Como se conectar a instâncias](https://cloud.google.com/compute/docs/instances/connecting-to-instance) no site do Google.

## Etapa 3: instalar o Tableau Server em sua VM do Google Compute Engine

Instalar o Tableau Server em uma máquina virtual (VM) do Google Compute Engine (GCE) é semelhante a instalá-lo em qualquer outro servidor.

**Observações:**

- É possível selecionar a autenticação local ou a autenticação do Active Directory (AD) apenas durante a instalação inicial. O AD é requerido somente em configurações de vários trabalhos. Para obter mais informações, consulte [Configuração do Active Directory no Google Compute Engine](https://cloud.google.com/compute/docs/tutorials/setup-active-directory) no site do Google.
- O usuário Run As deve ser um usuário local na instância do servidor.

1. Copie o programa de instalação do Tableau Server na sua VM executando um dos seguintes procedimentos:
    
    - **Baixe o instalador diretamente**. Enquanto estiver conectado à VM, abra um navegador, vá até a [página de download do Tableau Server](http://www.tableau.com/pt-br/products/server/download) e baixe a versão do Tableau Server apropriada para o seu sistema operacional.
        
        **Observação:** a configuração de segurança padrão aprimorada no Windows Server determina que o Internet Explorer esteja sempre configurado como Alto para a zona da Internet e não pode ser alterado para essa zona. Dessa forma, ao navegar para sites públicos usando o Internet Explorer, é necessário adicioná-los à lista de sites confiáveis.
    - **Copiar o instalador para a VM**. Caso já tenha uma cópia do instalador do Tableau Server em seu computador, copie-a para a VM. Crie uma pasta na VM onde deseja colocar o instalador. No computador, faça upload do arquivo de instalação do Tableau Server (por exemplo, tableau-server-2020-2-3.x86\_64.rpm) para a VM. Para obter mais informações sobre como copiar arquivos para uma VM do Google Compute Engine, consulte [Transferir arquivos para instâncias](https://cloud.google.com/compute/docs/instances/transfer-files) no site do Google.
2. Execute o instalador do Tableau Server na VM para iniciar o processo de instalação do servidor. O processo de instalação funciona da mesma forma que em qualquer outro servidor. Para obter mais informações, consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).

## Etapa 4: acessar o Tableau Server a partir de um navegador remoto

Certifique-se de que somente os usuários autorizados possam acessar a máquina virtual (VM) do Google Compute Platform, onde você instalou o Tableau Server.

1. No console do Google Compute Platform, em **Computar**, clique em **Compute Engine**, em seguida em **Instâncias da VM**. Encontre o endereço IP externo associado à VM.
2. Em outro computador (não na VM), abra um navegador.
3. No navegador, digite o endereço IP externo do Tableau Server instalado na VM. Por exemplo, `http://13.64.47.61`.
    
    **Observação:** o IP externo é um endereço efêmero. É lançado ao interromper a instância e um novo IP externo é atribuído na reinicialização. Se interromper sua instância, pode ser necessário recuperar o novo endereço IP externo para acessar o servidor usando o navegador. A GCP fornece endereços IP estatísticos persistentes. Dessa vez a URL é solucionada corretamente e você é direcionado à página de logon de sua instância do Tableau Server.
4. Faça logon usando as credenciais do usuário administrador criado ao final do processo de instalação. Após entrar, você verá a página Conteúdo do Tableau Server.

Para obter mais informações sobre como controlar o acesso ao seu Tableau Server, consulte como configurar um [armazenamento de identidade](https://help.tableau.com/current/server-linux/pt-br/plan_identity_store.htm).

## Etapa 5: publicar dados no Tableau Server em sua VM do Google Compute Engine

Depois de configurar o Tableau Server em uma máquina virtual (VM) do Google Compute Engine (GCE), os usuários autorizados de sua empresa poderão publicar pastas de trabalho e fontes de dados no servidor. O processo funciona da mesma maneira que faria se o Tableau Server estivesse instalado no local, exceto que os usuários devem fazer logon no servidor que executa a VM.

Antes de permitir que os usuários façam publicações, verifique se cada um deles foi criado com a função no site de Publisher (Publicador) no Tableau Server e se têm permissões para Publisher (Publicador). Para obter mais informações, consulte [Adicionar usuários ao Tableau Server](https://help.tableau.com/current/server/pt-br/users_add.htm).

Para publicar pastas de trabalho e fontes de dados no Tableau Server, os usuários devem fazer logon no servidor usando o endereço IP do servidor em nuvem e as credenciais atribuídas anteriormente. Para obter mais informações, consulte [Como publicar pastas de trabalho no Tableau Server](https://help.tableau.com/current/pro/desktop/pt-br/help.htm).

## Etapa 6: gerenciar licenças do Tableau Server

Não é necessário gerenciar sua licença do Tableau Server se interromper a máquina virtual (VM) do Google Compute Engine (GCE) usando o console do Google Cloud Platform, ou de dentro da VM. Ao [interromper uma VM do Google Compute Engine](https://cloud.google.com/compute/docs/instances/stopping-or-deleting-an-instance) com disco SSD persistente usando o console da GCP Compute Engine, a VM [não resulta em alterações](https://cloud.google.com/compute/docs/instances/stopping-or-deleting-an-instance), mas os recursos anexados à VM resultam em alterações.

Excluir uma VM desaloca todos os seus recursos, incluindo armazenamento externo. Você pode excluir sua VM quando não precisar mais dela. Sempre desative sua licença do Tableau Server antes de interromper e excluir a VM.

Antes de excluir a VM, faça o seguinte:

1. Faça logon em sua VM.
2. Crie um backup do Tableau Server, em seguida copie o arquivo `.tsbak` em outro local, como o [Armazenamento da Google Cloud](https://cloud.google.com/compute/docs/instances/transfer-files), que será acessível depois que a VM não estiver mais disponível. Para obter mais informações, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).
3. Use o comando [tsm licenses deactivate](https://help.tableau.com/current/server-linux/pt-br/cli_licenses_tsm.htm#TSMDeactivate) para desativar sua chave do produto do Tableau Server. Agora você pode interromper e excluir sua VM.

<!-- document id=21953b400bf9ed0481dfc14a8df7c2a469371f9baacac85976844d6ade0c9507 url=/tableau/current/pt-br/server/ts_tableau_server_cloud_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Auto-hospedar o Tableau Server em um serviço de nuvem pública

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Mesmo que você não tenha seu próprio hardware de servidor e infraestrutura, é possível implantar uma instalação do Tableau Server de nível empresarial na nuvem. Criar uma solução baseada em nuvem tem várias vantagens em relação às instalações locais. Por exemplo, o custo total geral de propriedade para a criação de uma solução do Tableau Server na nuvem é normalmente inferior ao de uma solução local similar porque não é necessário comprar todo o hardware caro. Além disso, a nuvem pode oferecer uma melhor opção em termos de tempo de atividade, confiabilidade e tolerância a falhas, especialmente se você implantar a solução em diferentes regiões nas zonas de disponibilidade.

Procurando o Tableau Server no Linux? Consulte [Auto-hospedar o Tableau Server em um serviço de nuvem pública](https://help.tableau.com/current/server-linux/pt-br/ts_tableau_server_cloud_overview.htm "Abre o tópico em uma nova guia do navegador").

Você pode criar e escalonar o ambiente do Tableau nos seguintes ambientes de nuvem:

- **Amazon Web Services** - instale e gerencie o Tableau Server no Amazon Web Services (AWS). Para obter mais informações, consulte [Instalar o Tableau Server na Amazon Web Services](https://help.tableau.com/current/server/pt-br/ts_aws_welcome.htm).
- **Google Cloud Platform** - instale e gerencie o Tableau Server no Google Cloud Platform. Para obter mais informações, consulte [Instalar o Tableau Server no Google Cloud Platform](https://help.tableau.com/current/server/pt-br/ts_gcp_welcome.htm).
- **Microsoft Azure** - instale e gerencie o Tableau Server no Microsoft Azure. Para obter mais informações, consulte [Instalar o Tableau Server no Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_welcome.htm).

- **Alibaba Cloud** - instale e gerencie o Tableau Server na Alibaba Cloud. Para obter mais informações, consulte [Instalar o Tableau Server na Alibaba Cloud](https://help.tableau.com/current/server/pt-br/ts_alibaba_welcome.htm).

## Outros artigos nesta seção

<!-- document id=bc0fbaa4aea36c1ebe8ba34b8fe8d0a3fe0ee53019dbc014784d69e2ad76a5e1 url=/tableau/current/pt-br/server/ts_aws_single_server.md -->

[Pular para o conteúdo principal](#main-content)

# Autoimplantação de um único Tableau Server na AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Para obter a maior flexibilidade na segurança, escalonamento e capacidade, você pode realizar uma implantação automática do Tableau Server na AWS. Criar uma solução baseada em nuvem tem várias vantagens em relação às instalações locais. Por exemplo, o custo total geral de propriedade para a criação de uma solução do Tableau Server na nuvem é normalmente inferior ao de uma solução local similar porque não é necessário comprar todo o hardware caro. Além disso, a nuvem pode fornecer melhor tempo de atividade, confiabilidade e tolerância a falhas, especialmente se você implantar a sua solução em diferentes regiões nas Zonas de disponibilidade.

Ao implantar o Tableau Server em um cluster na AWS, recomendamos que use os volumes do Amazon Elastic Block Store (EBS) com Amazon EC2. O EBS fornece volumes de armazenamento de bloco persistentes para uso com instâncias do Amazon EC2. Você deve anexar um volume General Purpose (SSD) do EBS separado com um tamanho de, no mínimo, 100 GiB para permitir espaço de instalação do Tableau Server. Este tamanho de volume suporta um desempenho de linha de base de 300 operações de entrada/saída por segundo (IOPS) com a capacidade de pico de 3.000 IOPS. Para obter mais informações, consulte [General Purpose SSD (gp2) Volumes](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EBSVolumeTypes.html#EBSVolumeTypes_gp2) no Amazon EC2 User Guide for Windows Instances do site da AWS.

Para cargas de trabalho pesadas, em que o subsistema de armazenamento precisa oferecer um número mínimo absoluto de IOPS para desempenho, você pode criar um volume General Purpose (SSD) de EBS para conseguir até 10.000 IOPS com a proporção de 3 IOPS por GiB, ou usar um volume Provisioned IOPS (SSD) de EBS com o IOPS que você precisa. Nos dois casos, recomendamos o uso das instâncias otimizadas pelo EBS se você planeja executar extrações pesadas e fazer muito processamento de dados. Para obter informações sobre o desempenho do Tableau Server, consulte [Visão geral do desempenho do Tableau Server](https://help.tableau.com/current/server/pt-br/perf.htm).

Realize as tarefas a seguir para instalar e configurar o Tableau Server na nuvem da AWS.

## Etapa 1: criar uma Virtual Private Cloud (Nuvem Privada Virtual, VPC)

A primeira etapa é criar uma nuvem privada virtual (VPC) e adicionar uma [interface de rede elástica da Amazon](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_ElasticNetworkInterfaces.html) para fornecer um endereço MAC estático para a instância do Amazon EC2.

1. Entre no AWS e navegue até [o console da Amazon VPC](https://console.aws.amazon.com/vpc/) (https://console.aws.amazon.com/vpc/)
2. Use o seletor de região para escolher o local em que estão os outros recursos da AWS. Frequentemente, é a região mais próxima a você.
3. Em **Recursos**, clique em **Iniciar assistente de VPC**, na tela **Etapa 1: selecionar uma configuração de VPC**, clique em **VPC com uma única sub-rede pública** e, em seguida, clique em **Selecionar**.
4. Na tela **Etapa 2: VPC com uma única sub-rede pública**, forneça um nome à sua VPC e clique em **Criar VPC**. Você pode deixar todas as outras configurações com os valores padrão.

## Etapa 2: configurar rede e segurança

Para permitir que o tráfego de entrada chegue à sua VPC, limite o tráfego a três portas padrão (HTTP, HTTPS e RDP). Para obter mais informações, consulte Regras ACL de rede recomendadas para sua VPC no Guia do Usuário da Amazon Virtual Private Cloud no site da AWS.

1. Navegue até o [console do Amazon EC2](https://console.aws.amazon.com/ec2/) (https://console.aws.amazon.com/ec2/).
2. Use o seletor de região para escolher o local em que você criou a sua VPC.
3. No painel de navegação, clique em **Security Groups** e, em seguida, em **Criar Security Group**.
4. Na tela **Criar Security Group**, no campo **Nome do security group**, insira um nome para o seu security group.
5. No campo **Descrição**, insira uma descrição para o security group.
6. No campo **VPC**, selecione sua VPC na lista.
7. Clique na guia **Entrada**, clique em **Adicionar regra** e na lista **Tipo**, selecione **HTTP (80)** e na coluna **Origem**, escolha **Meu IP** para cada regra. Isso limita o tráfego de entrada ao seu computador. Em vez disso, para especificar uma faixa de endereço IP escolha **Personalizar** e, em seguida, insira a faixa na notação de CIDR.
    
    Para obter mais informações, consulte [Adding Rules to a Security Group](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/using-network-security.html#adding-security-group-rule) no Amazon EC2 User Guide for Windows Instances do site da AWS.
    
    **Observação:** esta porta é necessária para receber o tráfego da Web descriptografado de entrada.
8. Clique na guia **Adicionar regra**, na lista **Tipo**, selecione **HTTPS (443)** e na coluna **Origem**, escolha **Meu IP** para cada regra. Isso limita o tráfego de entrada ao seu computador. Em vez disso, para especificar uma faixa de endereço IP escolha **Personalizar** e, em seguida, insira a faixa na notação de CIDR.
    
    Para obter mais informações, consulte [Adding Rules to a Security Group](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/using-network-security.html#adding-security-group-rule) no Amazon EC2 User Guide for Windows Instances do site da AWS.
    
    **Observação:** esta porta é necessária para receber o tráfego da Web criptografado de entrada.
9. Clique na guia **Adicionar regra**, na lista **Tipo**, selecione **RDP (3389)** e na coluna **Origem**, escolha **Meu IP** para cada regra. Isso limita o tráfego de entrada ao seu computador. Em vez disso, para especificar uma faixa de endereço IP escolha **Personalizar** e, em seguida, insira a faixa na notação de CIDR.
    
    Para obter mais informações, consulte [Adding Rules to a Security Group](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/using-network-security.html#adding-security-group-rule) no Amazon EC2 User Guide for Windows Instances do site da AWS.
    
    **Observação:** essa porta é necessária para aceitar as solicitações do Remote Desktop Protocol (RDP), de modo que seja possível se conectar à instância do EC2.
10. Clique em **Criar**.

## Etapa 3: inicializar uma instância do Amazon EC2

Após criar a sua VPC, é possível inicializar uma instância do Amazon EC2 nela.

Para obter informações sobre como inicializar e conectar-se à instância do Windows, consulte [Getting Started with Amazon EC2 Windows Instances](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2Win_GetStarted.html) no User Guide for Windows Instances do Amazon EC2 no site da AWS.

1. Navegue até o [console do Amazon EC2](https://console.aws.amazon.com/ec2/) (https://console.aws.amazon.com/ec2/).
2. Use o seletor de região para escolher o local em que você criou a sua VPC.
3. Em **Criar instância**, clique em **Inicializar instância**.
4. Selecione uma Amazon Machine Image (AMI) que atenda aos [requisitos do sistema](https://help.tableau.com/current/server/pt-br/ts_aws_virtual_machine_selection.htm) para o Tableau Server.
5. Na tela **Etapa 2: escolher o tipo de instância**, selecione o tamanho de instância que deseja (por exemplo, m4.2xlarge).
    
    **Observação:** para o Tableau Server v10 em uma máquina virtual de 64 bits, é necessário, no mínimo, 4 núcleos físicos. Na AWS, isso significa 8 vCPUs. Para obter mais informações, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/) no site da AWS.
6. Clique em **Próximo: configurar detalhes da instância**.
7. Na tela **Etapa 3: configurar detalhes da instância**, na lista **Rede**, selecione sua VPC.
8. Clique pelas etapas no assistente até chegar em **Etapa 6: configurar security group**.
9. Na tela **Etapa 6: configurar security group**, clique em **Selecionar um security group existente** e, em seguida, selecione o grupo de segurança que você criou antes.
10. Clique em **Revisar e iniciar**, revise a sua configuração e clique em **Iniciar**.
11. Quando for solicitado, crie um novo par de chaves, baixe-o como um arquivo .pem e mantenha-o em local seguro. Você precisa do par de chaves para criar uma senha que poderá usar para se conectar à instância do Amazon EC2.
12. Ao concluir a criação e o download do seu par de chaves, clique em **Iniciar instâncias**.
13. Clique em **Exibir instâncias** e localize a sua instância na lista.
14. Copie a ID da instância. Ela será necessária para a próxima etapa.

## Etapa 4: criar um endereço de IP elástico para a VPC

Após iniciar sua instância do Amazon EC2, é possível criar e alocar um endereço IP estático e público à sua VPC.

1. Navegue até o [console da Amazon VPC](https://console.aws.amazon.com/vpc/) (https://console.aws.amazon.com/vpc/).
2. Use o seletor de região para escolher o local em que você criou a sua VPC.
3. No painel de navegação, clique em **Elastic IPs**.
4. Clique em **Alocar novo endereço** e, em seguida, clique em **Alocar**.
5. Na caixa de diálogo **Nova solicitação de endereço bem-sucedida**, clique no endereço Elastic IP.
6. No menu **Ação**, clique em **Associar endereço**.
7. Em **Tipo de recurso**, selecione **Instância**.
8. Na lista suspensa **Instância**, selecione sua instância e clique em **Associar**.
9. Copie o novo endereço IP privado. Você precisará fazer isso posteriormente.

## Etapa 5: fazer logon no Amazon EC2

Para executar o Tableau Server na AWS, instale-o na instância ou instâncias do Amazon EC2 que você acabou de configurar. Para começar, entre na instância do Amazon EC2 em que deseja instalar o Tableau Server.

Use o RDP (Remote Desktop Protocol) de um computador com o Microsoft Windows para conectar-se a uma instância do Amazon EC2 executando o Microsoft Windows. Se estiver se conectando de um computador com o Linux, é possível usar [rdesktop](http://www.rdesktop.org/) para conectar-se a uma instância do Amazon EC2 executando o Microsoft Windows. Para obter mais informações, consulte [Conexão à instância do Windows](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/connecting_to_windows_instance.html) no _Guia de usuário do Amazon EC2 para instâncias do Windows_ no site da AWS.

1. Navegue até o [console do Amazon EC2](https://console.aws.amazon.com/ec2/) (https://console.aws.amazon.com/ec2/).
2. Use o seletor de região para escolher o local em que você iniciou a sua instância.
3. No painel do EC2, clique em **Instâncias**.
4. Marque a caixa de seleção ao lado da sua instância e, em seguida, no menu **Ações**, clique em **Conectar**.
5. Na caixa de diálogo **Conectar-se à sua instância**, clique em **Baixar arquivo do Desktop Remoto** para criar um arquivo .rdp configurado para conectar-se à instância. O arquivo .rdp é configurado para se conectar ao endereço IP público da sua VPC, que você especificou no endereço Elastic IP criado.
6. Clique em **Obter senha** e selecione o arquivo .pem para o par de chaves que você criou antes. Isso preenche a chave privada no seu par de chaves.
7. Clique em **Descriptografar senha**. Quando a senha for exibida, anote o endereço DNS público, nome de usuário (como Administrador) e a senha.
8. Clique duas vezes no arquivo .rdp que você baixou antes.
9. Clique em **Conectar**. (Ignore as mensagens que indicam um publicador desconhecido.)
10. Insira o nome de usuário e a senha registrados há algumas etapas e clique em **OK**.
11. Não tenha medo de ignorar qualquer aviso de que o publicador da conexão remota é desconhecido. Clique em **Sim** para se conectar.

## Etapa 6: instalar o Tableau Server

Agora que você está conectado na instância do EC2, é possível instalar o Tableau Server. As etapas de instalação da instância do EC2 são as mesmas para qualquer computador. Para obter instruções, consulte [Instalar e configurar](https://help.tableau.com/current/server/pt-br/install.htm).

Após instalar o Tableau Server, criar uma conta de administrador do Tableau Server e fazer logon, é possível [adicionar usuários](https://help.tableau.com/current/server/pt-br/users_add.htm).

Se deseja executar um cluster do Tableau Server, instale um Tableau Server adicional nas instâncias adicionais do Amazon EC2. Para obter mais informações, consulte [Autoimplantar um Tableau Server na AWS em um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_aws_multiple_server.htm).

<!-- document id=a9ed8c2a17e4a76559aae25e840409307653a587f337c7d6bd563b2d963ab646 url=/tableau/current/pt-br/server/ts_aws_multiple_server.md -->

[Pular para o conteúdo principal](#main-content)

# Autoimplantação do Tableau Server na AWS em um ambiente distribuído

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode executar o Tableau Server em duas máquinas virtuais (VMs) em um ambiente distribuído, também conhecido como cluster. No entanto, se deseja executar o Tableau Server em um ambiente distribuído (HA) altamente disponível, é necessário inicializar três ou mais instâncias do Amazon EC2 do mesmo tipo e capacidade na sua Amazon Virtual Private Cloud (VPC) e configurá-las como nós adicionais.

O cenário a seguir pressupõe que você tenha três instâncias do Amazon EC2 e o Tableau Server instalado em cada instância. Uma instância é configurada como o nó inicial e as outras duas instâncias são configuradas como nós adicionais.

As etapas a seguir mostram como instalar e implementar o Tableau Server em um cluster de três instâncias do Amazon EC2, em uma configuração altamente disponível e escalonável.

## Etapa 1: criar uma Virtual Private Cloud (Nuvem Privada Virtual, VPC)

As etapas a seguir pressupõem que você tenha uma Amazon VPC com, no mínimo, seis sub-redes (três públicas e três privadas) em zonas de disponibilidade diferentes, conforme mostrado abaixo. Certifique-se de usar endereços IP estáticos ao configurar seus endereços IP. Para obter mais informações sobre como criar uma VPC com sub-redes públicas e privadas, consulte [Cenário 2: VPC com sub-redes pública e privada](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Scenario2.html) no Guia do Usuário da Amazon Virtual Private Cloud no site da AWS.

![Diagrama de uma nuvem privada virtual com três zonas de disponibilidade.](/tableau/current/pt-br/server/pt-br/Img/ts_aws_three_az.png)

Inicialize uma instância do EC2 em cada uma das três sub-redes na sua VPC para uso como gateways do Remote Desktop.

Para obter informações sobre como inicializar e conectar-se à instância do Windows, consulte [Getting Started with Amazon EC2 Windows Instances](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/EC2Win_GetStarted.html) no User Guide for Windows Instances do Amazon EC2 no site da AWS.

## (Opcional) Etapa 2: criar um AWS Directory Service para a VPC

Siga as etapas na seção [Criar um Microsoft AD Directory simples](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/how_to_create_simple_ad.html) , no _AWS Directory Service Administration Guide_no site da AWS, para criar um diretório baseado em Samba totalmente gerenciado na AWS. Quando você cria um diretório com o Microsoft AD, o AWS Directory Service cria dois servidores de diretório e servidores DNS. Os servidores de diretório são criados em diferentes sub-redes na sua Amazon VPC para redundância, de modo que o seu diretório permaneça acessível, mesmo se ocorrer uma falha.

Use as duas sub-redes privadas disponíveis na sua Amazon VPC para criar o Microsoft AD, de modo que você possa executar o Tableau Server pelas zonas de disponibilidade.

## Etapa 3: implementar três instâncias do Amazon EC2

Implemente três instâncias do Amazon EC2 em três Zonas de disponibilidade, conforme mostrado na figura abaixo. Você instalará o Tableau Server no primeiro nó como o servidor inicial, e o Tableau Server nos dois nós restantes como servidores adicionais. Todas as instâncias devem ser do mesmo tipo e capacidade.

Essas instâncias do Amazon EC2 podem ser unidas automaticamente ao domínio AD simples criado na etapa 2 pelo console ou pelas etapas 2 em [Joining a Windows Instance to an AWS Directory Service Domain](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-join-aws-domain.html) no Amazon EC2 User Guide para instâncias do Windows no site da AWS.

![Diagrama de uma arquitetura de várias zonas na AWS.](/tableau/current/pt-br/server/pt-br/Img/ts_aws_three_az_primary_worker_691x603.png)

Após inicializar as instâncias do EC2, conecte-as de uma das instâncias do Remote Desktop Gateway (RDGW) usando as credenciais descriptografadas para a conta do administrador local.

## Etapa 4: instalar e configurar o Tableau Server

Você instalará o Tableau Server nas instâncias do Amazon EC2 inicializadas na [Autoimplantação do Tableau Server na AWS em um ambiente distribuído](#Step3) e configurará as instâncias como servidor inicial e o restante como servidores adicionais. Para obter mais informações sobre a instalação e configuração do Tableau Server em um servidor inicial e servidores adicionais, consulte [Instalar o Tableau Server em nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

**Observação:** ao adicionar outros nós no Amazon Web Services (AWS), pode ser necessário editar o arquivo de hosts do Windows para adicionar uma entrada para cada um dos nós adicionais. Isso ocorre porque o DNS não pode resolver os nomes de instâncias da Elastic Compute Cloud (EC2).

Para editar o arquivo de host do Windows:

1. Execute o Notepad como administrador.
2. Abra o arquivo `C:\Windows\system32\drivers\etc\hosts`.
3. Adicione uma entrada no arquivo de hosts para cada um dos nós. Cada entrada deve incluir o endereço IP do nó seguido do nome de domínio.
4. Salve o arquivo.

## Etapa 5: criar um balanceador de carga para o cluster do Tableau Server

Siga as etapas descritas em [Conceitos básicos do Elastic Load Balancing](http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/load-balancer-getting-started.html) no Guia do Usuário do Elastic Load Balancing no site da AWS para inicializar um balanceador de carga dentro da sua VPC.

1. Na [Etapa 1: selecione um tipo de balanceador de carga](http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/load-balancer-getting-started.html#select-load-balancer-type), se você deseja que o balanceador de carga seja publicamente acessível, selecione as duas sub-redes públicas. Caso contrário, selecione **Criar um balanceador de carga interno** e escolha as duas sub-redes privadas.
    
    Se você optar por expor o balanceador de carga com endpoint público, não se esqueça de configurar o Elastic Load Balancing com SSL, conforme explicado em [Criar um Classic Load Balancer com um listener HTTPS](http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-create-https-ssl-load-balancer.html) no Guia do Classic Load Balancer de Elastic Load Balancing no site da AWS.
2. Na [Etapa 2: configurar seu Load Balancer e Listener](http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/load-balancer-getting-started.html#configure-load-balancer) das instruções, no Guia do Usuário do Elastic Load Balancing no site da AWS, certifique-se de que o seu security group seja configurado para permitir acesso na porta 80 ou 443 somente, com a origem limitada aos hosts ou faixas de hosts que acessarão o Tableau Server.
3. Na [Etapa 4: configurar seu grupo de destino](http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/load-balancer-getting-started.html#configure-target-group), é possível especificar o caminho de ping como /.
4. Na [Etapa 5: registrar destinos com seu grupo de destino](http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/load-balancer-getting-started.html#add-targets), selecione as instâncias do Tableau Server e certifique-se de que **Enable CrossZone Load Balancing** (Habilitar balanceamento de carga de CrossZone) esteja selecionado para que o balanceador de carga possa balancear a carga do tráfego entre as instâncias em várias zonas de disponibilidade.
5. Atualizar o Tableau Server para usar o balanceador de carga. Para obter mais informações, consulte [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm) na Ajuda do Tableau Server.

Como alternativa, você pode configurar o Tableau Server para trabalhar com um balanceador de carga ao realizar as seguintes etapas.:

1. Crie uma sub-rede para o seu balanceador de carga que tenha um bloco CIDR com bitmask /27 para 32 endereços IP.
    
    **Observação:** os endereços IP fornecidos pelo Elastic Load Balancing são dinâmicos e o Tableau Server precisa de uma lista de endereços IP estáticos para esta configuração. Para que isso funcione, estamos criando uma sub-rede com a menor faixa de CIDR possível, de modo que os endereços IP do balanceador de carga sejam limitados a um conjunto finito.
    
    Para as próximas etapas, usaremos a interface de linha de comando tsm, instalada no Tableau Server como padrão. Você pode usar o tsm para realizar as tarefas administrativas na linha de comando do Tableau Server. Para obter uma visão geral, consulte [Referência da linha de comando tsm](https://help.tableau.com/current/server/pt-br/tsm.htm) na Ajuda do Tableau Server.
2. No diretório bin do Tableau Server, insira o comando a seguir, onde o nome é a URL que será usada para acessar o Tableau Server pelo balanceador de carga:
    
    `tsm configuration set gateway.public.host "name"`
3. Insira o comando a seguir, em que server1, server2 e assim por diante são os endereços IP para a faixa CIDR especificada de sub-redes para o Elastic Load Balancing:
    
    `tsm configuration set gateway.trusted "server1,server2,..,server30"`
4. Aplique as alterações:
    
    `tsm apply-pending-changes`
    
    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).
5. Inicie o servidor para que as alterações entrem em vigor.
    
    `tsm start`

<!-- document id=c5ae745ce1ab1c44a8ff3ea27e9cb668f21c9ea757c76e90f332c97576674a8a url=/tableau/current/pt-br/server/ts_azure_multiple_server.md -->

[Pular para o conteúdo principal](#main-content)

# Autoimplantação do Tableau Server no Microsoft Azure em um ambiente distribuído

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode executar o Tableau Server em duas máquinas virtuais (VMs) em um ambiente distribuído, também conhecido como cluster. No entanto, para executar o Tableau Server em um ambiente distribuído altamente disponível (HA), é necessário iniciar três ou mais máquinas virtuais do Microsoft Azure (Virtual Machines, VMs) do mesmo tipo e com a mesma capacidade e configurá-las como nós de trabalho. Esse cenário pressupõe que você tenha três VMs do Microsoft Azure com o Tableau Server instalado em cada instância. Uma instância é configurada como o nó primário e as outras duas instâncias são configuradas como nós adicionais.

Use as etapas a seguir para instalar e implementar o Tableau Server em um cluster de três VMs do Microsoft Azure em uma configuração altamente disponível e escalonável.

## Etapa 1: criar uma Rede Virtual (VNet) do Azure

Você deve ter uma Rede Virtual (VNet) do Azure com uma sub-rede privada que inclua três zonas de disponibilidade. Para obter informações sobre como planejar e criar uma VNet com sub-redes públicas e privadas, consulte [Rede Virtual do Azure](https://docs.microsoft.com/en-us/azure/virtual-network/virtual-networks-overview), [Planejamento e design de Redes Virtuais do Azure](https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-vnet-plan-design-arm) e [Criar uma rede virtual com várias sub-redes](https://docs.microsoft.com/en-us/azure/virtual-network/virtual-networks-create-vnet-arm-pportal) no site do Microsoft Azure.

## (Opcional) Etapa 2: criar um serviço Azure Active Directory para a VNet

Siga as etapas em [Habilitar o Azure Active Directory Domain Services usando o portal do Azure](https://docs.microsoft.com/en-us/azure/active-directory-domain-services/active-directory-ds-getting-started), no site do Microsoft Azure, para criar um diretório baseado em Samba totalmente gerenciado no Microsoft Azure. Quando você cria um diretório com o Microsoft AD, o Azure Active Directory Service cria dois servidores de diretório e servidores DNS. Os servidores de diretório são criados em diferentes sub-redes na rede virtual para redundância, de modo que o diretório permaneça acessível, mesmo se ocorrer uma falha.

Use a sub-rede privada na VNet do Azure para criar o Microsoft AD, de modo que você possa executar o Tableau Server em zonas de disponibilidade.

**Observação:** se você quiser usar SSL com a implantação, use o Gateway de Aplicativo do Microsoft Azure em vez do Microsoft Azure Load Balancer.

![Um diagrama de uma implantação de várias zonas para o Tableau Server no Microsoft Azure.](/tableau/current/pt-br/server/pt-br/Img/ts_azure_three_zone_primary_worker.png)

## Etapa 3: implantar três VMs do Azure

Implante três máquinas virtuais (VMs) do Microsoft Azure em três [Zonas de disponibilidade](https://docs.microsoft.com/en-us/azure/availability-zones/az-overview#regions-that-support-availability-zones). Certifique-se de selecionar uma região que suporte Zonas de disponibilidade. Selecione uma VM que atenda aos [requisitos de sistema](https://help.tableau.com/current/server/pt-br/ts_azure_virtual_machine_selection.htm) do Tableau Server. Você usará um nó como o servidor inicial e dois novos nós como servidores adicionais. Todas as instâncias devem ser do mesmo tipo e capacidade.

Após iniciar as VMs do Microsoft Azure, conecte-se a elas de uma das instâncias do Remote Desktop Gateway (RDGW), usando as credenciais descriptografadas para a conta do administrador local.

## Etapa 4: instalar e configurar o Tableau Server

Você instalará o Tableau Server nas máquinas virtuais (VMs) do Microsoft Azure iniciadas na [Autoimplantação do Tableau Server no Microsoft Azure em um ambiente distribuído](#Step3) e configurará as instâncias como servidor inicial e o restante como servidores adicionais. Para obter mais informações sobre a instalação e a configuração do Tableau Server em um servidor inicial e em servidores adicionais, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

Use um host bastião para gerenciar o acesso às VMs na rede virtual. Para obter mais informações, consulte [Planejando um ambiente de bastiões](https://docs.microsoft.com/en-us/microsoft-identity-manager/pam/planning-bastion-environment) no site do Microsoft Azure.

## Etapa 5: criar um Azure Load Balancer para o cluster do Tableau Server

Leia a [Visão geral do Azure Load Balancer](https://docs.microsoft.com/en-us/azure/active-directory-domain-services/active-directory-ds-getting-started) no site do Microsoft Azure e siga as etapas para iniciar um balanceador de carga na Rede Virtual (VNet) do Azure.

1. Crie e inicie um balanceador de carga para a Internet ou um balanceador de carga acessível internamente:
    
    - Para iniciar um balanceador de carga público para a Internet, siga as etapas em [Balancear a carga de VMs entre zonas de disponibilidade com um Balanceador de Carga Standard usando o portal do Azure](https://docs.microsoft.com/en-us/azure/load-balancer/tutorial-load-balancer-standard-public-zone-redundant-portal) no site do Microsoft Azure e selecione as duas sub-redes públicas. Certifique-se de configurar o balanceador de carga com SSL, conforme explicado em [Configurar um gateway de aplicativo com terminação SSL usando o portal do Azure](https://docs.microsoft.com/en-us/azure/application-gateway/application-gateway-ssl-portal) no site do Microsoft Azure.
    - Para iniciar um balanceador de carga acessível internamente, siga as etapas em [Criar um balanceador de carga interno no portal do Azure](https://docs.microsoft.com/en-us/azure/load-balancer/load-balancer-get-started-ilb-arm-portal) no site do Microsoft Azure e selecione as duas sub-redes privadas.
2. Verifique se o grupo de segurança esteja configurado para permitir acesso somente na porta 80 ou 443, com a fonte limitada a hosts ou intervalos de hosts que acessarão o Tableau Server.
3. Especifique o caminho de ping como /.
4. Selecione as instâncias do Tableau Server e certifique-se de que **Habilitar balanceamento de carga CrossZone** () esteja selecionado para que o balanceador de carga possa balancear a carga do tráfego entre as instâncias em várias zonas de disponibilidade.
5. Atualize o Tableau Server para usar o balanceador de carga. Para obter mais informações, consulte [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm) na Ajuda do Tableau Server.

<!-- document id=29f4ad2431a5545f3686d1563876cab495e0f2636ab625f850b5e05353e2707f url=/tableau/current/pt-br/server/ts_alibaba_multiple_server.md -->

[Pular para o conteúdo principal](#main-content)

# Autoimplantar o Tableau Server na Alibaba Cloud em um ambiente distribuído

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode executar o Tableau Server em duas máquinas virtuais (VMs) em um ambiente distribuído, também conhecido como cluster. No entanto, para executar o Tableau Server em um ambiente distribuído altamente disponível (HA), é necessário iniciar três ou mais instâncias do Alibaba Cloud Elastic Compute Service (ECS) do mesmo tipo e com a mesma capacidade e configurá-las como nós adicionais. Esse cenário pressupõe que você tenha três instâncias de ECS com o Tableau Server instalado em cada instância. Uma instância é configurada como o nó inicial e as outras duas instâncias são configuradas como nós adicionais.

Use as etapas a seguir para instalar e implementar o Tableau Server em um cluster de três instâncias do ECS em uma configuração altamente disponível e escalonável.

## Etapa 1: criar uma Virtual Private Cloud (Nuvem Privada Virtual, VPC) da Alibaba

Você precisa ter uma Virtual Private Cloud (Nuvem Privada Virtual, VPC) existente da Alibaba no modo personalizado com uma sub-rede privada e pública em três zonas diferentes. Para obter mais informações sobre como planejar e criar uma rede VPC no modo personalizado com sub-redes personalizadas, consulte [Planejar e projetar uma VPC](https://www.alibabacloud.com/help/doc-detail/54095.htm) no site da Alibaba.

![Arquitetura de várias zonas com sub-redes públicas e privadas em cada zona.](/tableau/current/pt-br/server/pt-br/Img/ts_alibaba_three_zone.png)

## Etapa 2: implantar três instâncias do ECS

Implante três instâncias de ECS do mesmo tipo e com a mesma capacidade, na sub-rede privada, e distribua os nós entre as zonas disponíveis. Selecione as instâncias que atendam aos [requisitos de sistema](https://help.tableau.com/current/server/pt-br/ts_alibaba_virtual_machine_selection.htm) do Tableau Server. Você instalará o Tableau Server em cada uma das instâncias ECS e usará um nó como o servidor inicial e os outros dois nós como servidores adicionais.

Para obter mais informações sobre como instalar o Tableau Server em um ambiente Windows distribuído, consulte [Instalações distribuída e de alta disponibilidade do Tableau Server](https://help.tableau.com/current/server/pt-br/distrib_ha.htm) e [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

![Um diagrama de rede ilustra a arquitetura de implantação de um Tableau Server na Alibaba Cloud.](/tableau/current/pt-br/server/pt-br/Img/ts_alibaba_three_zone_primary_worker.png)

## Etapa 3: criar um balanceador de carga do servidor Alibaba para o cluster do Tableau Server

Leia [Implementar alta disponibilidade ao usar um balanceador de carga do servidor](https://www.alibabacloud.com/help/doc-detail/59331.html) no site da Alibaba e siga as etapas para iniciar um balanceador de carga na Virtual Private Cloud (Nuvem Privada Virtual, VPC) da Alibaba.

1. Crie e inicie um balanceador de carga voltado para a Internet. Siga as etapas em [Implementar alta disponibilidade ao usar um balanceador de carga do servidor](https://www.alibabacloud.com/help/doc-detail/59331.htm) no site Alibaba.
2. Verifique se o grupo de segurança do ECS esteja configurado para permitir acesso somente na porta 80 ou 443, com a fonte limitada a hosts ou intervalos de hosts que acessarão o Tableau Server. Para obter mais informações sobre grupos de segurança do ECS, consulte [Casos para configurar grupos de segurança do ECS](https://www.alibabacloud.com/help/doc-detail/65408.html) no site da Alibaba.
3. Especifique o caminho de ping como /.
4. Selecione as instâncias do Tableau Server e siga as instruções em [Obter balanceamento de carga entre as regiões com o Gerenciador de Tráfego Global](https://www.alibabacloud.com/help/doc-detail/85980.html) no site do Google, para que o balanceador de carga possa balancear o tráfego entre as instâncias em várias zonas.
5. Atualize o Tableau Server para usar o balanceador de carga. Para obter mais informações, consulte [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm) na Ajuda do Tableau Server.

<!-- document id=e6b4bdfe1ce4ba5d11a7e5aeca91461c9e4939080bf44d3c73c40f78679ca844 url=/tableau/current/pt-br/server/ts_gcp_multiple_server.md -->

[Pular para o conteúdo principal](#main-content)

# Autoimplantar o Tableau Server no Google Cloud Platform em um ambiente distribuído

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode executar o Tableau Server em duas máquinas virtuais (VMs) em um ambiente distribuído, também conhecido como cluster. No entanto, para executar o Tableau Server em um ambiente distribuído altamente disponível (HA), é necessário iniciar três ou mais máquinas virtuais (Virtual Machines, VMs) do Google Compute Engine (GCE) do mesmo tipo e com a mesma capacidade e configurá-las como nós de trabalho. Esse cenário pressupõe que você tenha três VMs do Google Compute Engine com o Tableau Server instalado em cada instância. Uma instância é configurada como o nó inicial e as outras duas instâncias são configuradas como nós adicionais.

Use as etapas a seguir para instalar e implantar o Tableau Server em um cluster de três VMs do Google Compute Engine em uma configuração altamente disponível e escalonável.

## Etapa 1: criar uma Virtual Private Cloud (Nuvem Privada Virtual, VPC) do Google Cloud Platform

Você precisa ter uma Virtual Private Cloud (Nuvem Privada Virtual, VPC) existente do Google Cloud Platform no modo personalizado com uma sub-rede privada e pública em três zonas diferentes. Para obter mais informações sobre como planejar e criar uma rede VPC no modo personalizado com sub-redes personalizadas, consulte [Uso de redes VPC](https://cloud.google.com/vpc/docs/using-vpc) no site do Google.

![Diagrama de três zonas de disponibilidade.](/tableau/current/pt-br/server/pt-br/Img/ts_gcp_three_zone.png)

## Etapa 1: crie um projeto da plataforma Google Cloud alinhado ao HIPAA

Referindo-se à [Configuração de um tutorial de projeto do Google Cloud alinhado ao HIPAA](https://cloud.google.com/solutions/setting-up-a-hipaa-aligned-project) e contando com o Kit de ferramentas de proteção de dados de serviços de saúde na nuvem, essa arquitetura ajuda você a construir uma infraestrutura baseada no Google Cloud com poucas etapas, tratando a configuração como código. O diagrama a seguir ilustra como a arquitetura ajuda você a atender às práticas recomendadas de segurança e conformidade usando blocos de construção reutilizáveis: um script de configuração do Geranciador de implantação na nuvem do Google Cloud e modelos de configuração parametrizados.

![Diagrama de três zonas de disponibilidade.](/tableau/current/pt-br/server/pt-br/Img/ts_gcp_three_zone.png)

## Etapa 2: implantar três VMs do Google Compute Engine

Implante três máquinas virtuais (VMs) do Google Compute Engine do mesmo tipo e com a mesma capacidade, na sub-rede privada, com cada VM na sua própria zona. Selecione as VMs que atendam aos [requisitos de sistema](https://help.tableau.com/current/server/pt-br/ts_gcp_virtual_machine_selection.htm) do Tableau Server. Você instalará o Tableau Server em cada uma das VMs do Google Compute Engine e usará um nó como o servidor inicial e os outros dois nós como servidores adicionais.

Para obter mais informações sobre como instalar o Tableau Server em um ambiente Windows distribuído, consulte [Instalações distribuída e de alta disponibilidade do Tableau Server](https://help.tableau.com/current/server/pt-br/distrib_ha.htm) e [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

![Diagrama de arquitetura com três zonas primárias.](/tableau/current/pt-br/server/pt-br/Img/ts_gcp_three_zone_primary_worker.png)

## Etapa 3: criar um balanceador de carga do Google Cloud Platform para o cluster do Tableau Server

Leia [Configuração de um balanceador de carga](https://cloud.google.com/iap/docs/load-balancer-howto) no site do Google e siga as etapas para iniciar um balanceador de carga na Virtual Private Cloud (Nuvem Privada Virtual, VPC) do Google Cloud Platform.

1. Crie e inicie um balanceador de carga para a Internet ou um balanceador de carga acessível internamente:
    
    - Para iniciar um balanceador de carga público para a Internet, siga as etapas em [Configuração do balanceamento de carga HTTP(S)](https://cloud.google.com/compute/docs/load-balancing/http/) no site do Google e selecione as duas sub-redes públicas. Certifique-se de configurar um balanceador de carga com SSL, como explicado em [Certificados SSL](https://cloud.google.com/compute/docs/load-balancing/http/ssl-certificates) no site do Google.
    - Para iniciar um balanceador de carga acessível internamente, siga as etapas em [Configuração do balanceamento de carga interno](https://cloud.google.com/compute/docs/load-balancing/internal/) no site do Google e selecione as duas sub-redes privadas.
2. Verifique se as regras de firewall de rede VPC estão configuradas para permitir acesso somente na porta 80 ou 443, com a fonte limitada a hosts ou intervalos de hosts que acessarão o Tableau Server. Para obter mais informações sobre as regras de firewall, consulte [Visão geral das regras de firewall](https://cloud.google.com/vpc/docs/firewalls) no site do Google.
3. Especifique o caminho de ping como /.
4. Selecione as instâncias do Tableau Server e siga as instruções em [Criação de balanceamento de carga entre regiões](https://cloud.google.com/compute/docs/load-balancing/http/cross-region-example) no site do Google, para que o balanceador de carga possa balancear o tráfego entre as instâncias em várias zonas.
5. Atualize o Tableau Server para usar o balanceador de carga. Para obter mais informações, consulte [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm) na Ajuda do Tableau Server.

<!-- document id=d1cd2380de34954b5f247ad7cc592e1a352ac278eeae3001a23f3de9b0a0dfef url=/tableau/current/pt-br/server/ts_alibaba_single_server.md -->

[Pular para o conteúdo principal](#main-content)

# Autoimplantar um único Tableau Server na Alibaba Cloud

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode implantar e executar o Tableau Server em uma instância do Elastic Compute Service (ECS) da Alibaba Cloud. Realize as tarefas a seguir para instalar e configurar o Tableau Server na instância do ECS.

## Etapa 1: configurar uma VPS

Crie uma nuvem virtual privada (VPC) na qual você iniciará a instância do ECS e instale o Tableau Server. Você também criará um switch virtual (VSwitch), que facilita as comunicações entre as instâncias do ECS.

1. Faça logon no [Console da Alibaba Cloud](https://account.alibabacloud.com/login/login.htm) (https://account.alibabacloud.com/login/login.htm).
2. No painel da Alibaba Cloud, em **Rede**, clique em **Nuvem virtual privada**.
3. Na lista suspensa da região, selecione a região em que deseja criar recursos.
4. No console da **VPC**, clique em **Criar VPC**.
5. Na página **Criar VPC**, especifique o seguinte:
    
    1. **Nome:** Digite um nome (até 128 caracteres) para a VPC.
    2. **Bloco IPv4 CIDR:** escolha uma faixa IPv4 CIDR privada.
        
        **Observação:** o bloco CIDR IPv4 não pode ser alterado depois que a VPC é criada.
    3. **Descrição:** digite uma descrição (até 256 caracteres) para descrever sua VPC.
6. Em VSwitch, especifique o seguinte:
    
    1. **Nome:** digite um nome (até 128 caracteres) para o switch virtual (VSwitch).
    2. **Zona:** selecione uma zona de disponibilidade.
    3. **Bloco IPv4 CIDR:** escolha uma faixa IPV4 CIDR privada.
    4. **Descrição:** digite uma descrição (até 256 caracteres) para descrever sua VSwitch.
7. Depois de concluir, revise suas seleções e clique em **OK**.

## Etapa 2: criar um grupo de segurança

Crie um grupo de segurança para uso com a sua instância do ECS. O grupo de segurança é um firewall virtual que permite ou nega acesso pela Internet à sua instância do ECS.

1. No painel da Alibaba Cloud, em **Produtos e serviços**, clique em **Serviço de computação elástica**.
2. Na página **Serviço de computação elástica** , em Rede e segurança, clique em **Grupos de segurança**.
3. Na página Grupos de segurança , clique em Criar grupo de segurança.
4. Na página **Criar grupo de segurança**, especifique o seguinte:
    
    1. **Modelo:** escolha Servidor Web do Windows.
    2. **Nome do grupo de segurança** Digite um nome (até 128 caracteres) para seu grupo de segurança.
    3. **Descrição:** digite uma descrição (até 256 caracteres) para descrever seu grupo de segurança.
    4. **Tipo de rede:** selecione VPC.
    5. **VPC:** selecione a VPC que criou anteriormente.
    6. **Marca:** digite um par chave/valor para marcar o grupo de segurança para facilitar a pesquisa/filtragem mais rápida posteriormente.
5. Clique em **OK** e, na caixa de diálogo Anotações , clique em Criar regras agora.
6. Para cada uma das portas listadas na guia Entrada , clique em Modificar e, no campo Objetos de Autorização, altere o intervalo de endereços IP para corresponder à sua rede e permitir que somente o tráfego dessa rede se conecte à sua instância do ECS.

## Etapa 3: configurar uma instância do ECS

Crie uma instância do ECS onde você instalará o Tableau Server.

1. No painel da Alibaba Cloud, em **Produtos e serviços**, clique em **Serviço de computação elástica**.
2. Na página **Serviço de Computação Elástica**, clique em **Instâncias**.
3. Na página **Instâncias** , clique em Criar instância.
4. Na página Serviço de Computação Elástica (ECS), clique em Personalizar.
5. Em Método de Faturamento, clique em Assinatura.
6. Em Região, selecione a região e a zona de disponibilidade em que você criou a VPC.
7. Em Tipo de Instância, selecione Geração atual, selecione Arquitetura X86 e, na lista Instâncias, selecione ecs.g5.4xlarge.
    
    **Observação:** alguns tipos de instância podem não estar disponíveis em todas as regiões.
8. Em Imagem, selecione Imagem pública e na lista de sistemas operacionais, selecione Windows Server e uma das versões suportadas, por exemplo, 2012 R2 Data Center Edition 64bit English Edition.
9. Em Armazenamento, em Disco do sistema, selecione Disco SSD Cloud e defina o tamanho como 50 GiB.
10. Em Disco de dados, clique em Adicionar disco, selecione Disco SSD Cloud e defina o tamanho como 100 GiB.
11. Em Duração, escolha o período de tempo pelo qual deseja alugar a instância e clique em Avançar: Rede.
12. Em Rede, selecione a VPC e a VSwitch que criou anteriormente.
13. Em Grupo de segurança, selecione o grupo de segurança criado anteriormente.
14. Clique em Avançar: Configurações do sistema e especifique a senha do administrador e o nome da instância.
15. Clique em Avançar: Agrupamento, especifique as marcas ou conjuntos de implantação e clique em Avançar: Visualizar.
16. Revise suas seleções, examine os Termos de serviço e clique em **Criar pedido**.

## Etapa 4: conectar-se à instância do ECS

Após criar sua instância do ECS, é necessário conectá-la e prepará-la para instalar o Tableau Server. Para obter mais informações sobre como se conectar a uma instância do ECS, consulte [Conectar-se a instâncias](https://www.alibabacloud.com/help/doc-detail/71529.htm) no site da Alibaba.

1. No painel da Alibaba Cloud, em **Produtos e serviços**, clique em **Serviço de computação elástica**.
2. Na página **Serviço de Computação Elástica**, clique em **Instâncias**.
3. Na lista de instâncias, selecione sua instância e clique em **Conectar**.
4. Se solicitado, digite suas credenciais da VNC.
5. Digite o nome de logon e a senha do Microsoft Windows e pressione Enter.

## Etapa 5: instalar o Tableau Server na sua instância do ECS

Instalar o Tableau Server na instância do ECS é semelhante a instalá-lo em qualquer outro servidor.

1. Copie o programa de instalação do Tableau Server na sua VM executando um dos seguintes procedimentos:
    
    - **Baixe o instalador diretamente**. Enquanto estiver conectado à VM, abra um navegador, vá até a [página de download do Tableau Server](http://www.tableau.com/pt-br/products/server/download) e baixe a versão de 64 bits do Tableau Server.
        
        **Observação:** a configuração de segurança padrão aprimorada no Windows Server determina que o Internet Explorer esteja sempre configurado como Alto para a zona da Internet e não pode ser alterado para essa zona. Dessa forma, ao navegar para sites públicos usando o Internet Explorer, é necessário adicioná-los à lista de sites confiáveis.
    - **Copiar o instalador para a VM**. Caso já tenha uma cópia do instalador do Tableau Server em seu computador, copie-a para a VM. Crie uma pasta na VM onde deseja colocar o instalador. No computador, faça upload do arquivo de instalação do Tableau Server (por exemplo, TableauServer-64bit-10.5.exe) para a instância.
2. Execute o instalador do Tableau Server na VM para iniciar o processo de instalação do servidor. O processo de instalação funciona da mesma forma que em qualquer outro servidor. Para obter mais informações, consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).

## Etapa 6: acessar o Tableau Server de um navegador remoto

Certifique-se de que os usuários possam acessar a instância do Alibaba Cloud ECS em que o Tableau Server foi instalado.

1. No console Serviços de computação elástica, clique em **Instâncias**, selecione sua instância na lista e localize o endereço IP externo.
2. Em outro computador (não na instância), abra um navegador.
3. No navegador, digite o endereço IP externo do Tableau Server instalado na instância. Por exemplo, `http://13.64.47.61`.
4. Faça logon usando as credenciais do usuário administrador criado ao final do processo de instalação. Após entrar, você verá a página Conteúdo do Tableau Server.

## Etapa 7: publicar dados para o Tableau Server na instância do ECS

Depois de configurar o Tableau Server em uma instância do ECS, os usuários de sua empresa poderão publicar pastas de trabalho e fontes de dados no servidor. O processo funciona da mesma maneira que faria se o Tableau Server estivesse instalado no local, exceto que os usuários devem fazer logon no servidor que executa a instância do ECS.

Antes de permitir que os usuários façam publicações, verifique se cada um deles foi criado com a função no site de Publisher (Publicador) no Tableau Server e se têm permissões para Publisher (Publicador). Para obter mais informações, consulte [Adicionar usuários ao Tableau Server](https://help.tableau.com/current/server/pt-br/users_add.htm).

Para publicar pastas de trabalho e fontes de dados no Tableau Server, os usuários devem fazer logon no servidor usando o endereço IP do servidor em nuvem e as credenciais atribuídas anteriormente. Para obter mais informações, consulte [Como publicar pastas de trabalho no Tableau Server](https://help.tableau.com/current/pro/desktop/pt-br/help.htm).

## Etapa 8: gerenciar licenças do Tableau Server

Não é necessário gerenciar sua licença do Tableau Server se interromper a instância do ECS usando o console da Alibaba Cloud, ou de dentro da própria instância. Quando você [interrompe uma instância](https://www.alibabacloud.com/help/doc-detail/25441.htm) usando o console ECS, a instância ainda pode receber encargos.

Excluir uma instância desaloca todos os seus recursos, incluindo armazenamento externo. Você pode excluir sua instância quando não precisar mais dela. Sempre desative sua licença do Tableau Server antes de interromper e excluir a instância.

Antes de excluir a instância, faça o seguinte:

1. Faça logon em sua instância.
2. Crie um backup do Tableau Server, em seguida copie o arquivo `.tsbak` em outro local, como o [Serviço de armazenamento de objeto da Alibaba Cloud](https://www.alibabacloud.com/help/doc-detail/31817.htm), que será acessível depois que a VM não estiver mais disponível. Para obter mais informações, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).
3. Use o comando [tsm licenses deactivate](https://help.tableau.com/current/server-linux/pt-br/cli_licenses_tsm.htm#TSMDeactivate) para desativar sua chave do produto do Tableau Server. Agora você pode interromper e excluir sua VM.

<!-- document id=fafe8d451e11d4494d78ba4150a40335dbf6ded9b8aa45e073cd69ba01f9f595 url=/tableau/current/pt-br/server/ts_azure_single_server.md -->

[Pular para o conteúdo principal](#main-content)

# Autoimplantar um único Tableau Server no Microsoft Azure

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode instalar e executar o Tableau Server em uma máquina virtual (VM, virtual machine) do Microsoft Azure. O Tableau Server é uma solução online para compartilhamento, distribuição e colaboração de conteúdo criado no Tableau.

Execute as seguintes tarefas para instalar e executar o Tableau Server em uma máquina virtual do Microsoft Azure:

## Etapa 1: configurar uma VM do Azure

Crie uma máquina virtual do Microsoft Azure onde o Tableau Server será instalado.

1. Entre no [portal do Microsoft Azure](https://portal.azure.com/) (https://portal.azure.com).
2. No painel do Microsoft Azure, clique em**Novo**.
3. Em **Azure Marketplace**, selecione **Calcular** e, em seguida, na folha **Nova**, clique em **Ver todos.**
4. Na folha **Calcular**, escolha **Windows Server** e, em seguida, na folha **Windows Server**, escolha **Datacenter do Windows Server 2016**.
5. Na folha **Datacenter do Windows Server 2016**, revise as informações. Na lista suspensa **Selecionar um modelo de implantação**, selecione **Gerenciador de recursos** e, em seguida, clique em **Criar**.
6. Na folha **Criar máquina virtual** - **Noções básicas**, especifique as informações a seguir:
    
    1. **Nome:** insira um nome para sua máquina virtual (VM). O nome deve ter no máximo 15 caracteres.
    2. **Tipo de disco da VM:** escolha SSD.
    3. **Nome de usuário:** insira seu nome de usuário. Esse nome de usuário será usado para fazer logon na VM usando o RDP (Remote Desktop Protocol).
    4. **Senha:** insira sua senha. Você usará essa senha para fazer logon na VM usando o RDP.
    5. **Assinatura:** a assinatura do Azure à qual a VM deve estar associada.
    6. **Grupo de recursos:** escolha **Criar novo** e, em seguida, insira o nome de um novo grupo de recursos para hospedar os recursos da VM.
    7. **Localização:** a localização do novo grupo de recursos.
7. Na parte inferior da folha **Noções básicas**, clique em **OK**.
8. Na folha **Criar máquina virtual** - **Escolher um tamanho**, clique em **Ver tudo** para ver todos os tamanhos de máquinas virtuais disponíveis.
9. Selecione uma VM que atenda aos [requisitos de sistema](https://help.tableau.com/current/server/pt-br/ts_azure_virtual_machine_selection.htm) do Tableau Server. Por exemplo, escolha o tamanho **DS13\_V2** e, em seguida, clique em **Selecionar**.
10. Na página **Criar máquina virtual** - **Configurações**, em **Rede**, clique em **Grupo de segurança de rede (firewall)**.
11. Na folha **Criar grupo de segurança de rede**, clique em **Adicionar uma regra de entrada**.
12. Em seguida, crie regras de entrada que permitem tipos específicos de tráfego da Internet na VM. Na folha **Adicionar uma regra de segurança de entrada**, na caixa da lista suspensa **Serviço**, escolha **HTTP**.
13. Na caixa **Prioridade**, atribua uma prioridade à regra, por exemplo, 100. Os números baixos são processados primeiro. Por exemplo, uma prioridade de regras de 100 será processada antes de uma prioridade de regras de 110.
14. Na caixa **Nome**, insira um nome para a regra de entrada, por exemplo, HTTP Port-80, e clique em **OK**.
15. Repita as etapas 11 a 14 para criar uma segunda regra para o serviço HTTPS com prioridade 101.
16. Quando concluído, a caixa de diálogo **Criar grupo de segurança de rede** deverá incluir três regras para permitir o acesso a RDP, HTTP e HTTPS. Clique em **OK**.
17. Na folha **Criar máquina virtual** - **Criar**, em **Resumo**, reveja as configurações e clique em **Criar**.
    
    Depois que o processo de implantação da VM for concluído e ela estiver em execução, clique no bloco da VM no Painel do Azure.
18. Em **Configurações**, clique em **Discos**.
    
    **Observação:** a VM foi provisionada com apenas um disco. Recomendamos adicionar um segundo disco e instalar o Tableau Server no seu próprio disco.
19. Na folha **Discos**, em **Discos de dados**, clique em **Adicionar discos de dados**. Na coluna **Nome**, na lista suspensa **Não há discos gerenciados disponíveis**, escolha **Criar disco**.
20. Na folha **Criar disco gerenciado**, no campo **Nome**, insira um nome para o disco.
21. Defina o campo **Tamanho (GiB)** para **128**, **512** ou **1024** e, em seguida, clique em **Criar**.
    
    **Observação:** mesmo que o campo **Tamanho** permita qualquer número, o Azure arredondará o armazenamento provisionado para um desses valores com base em três opções atuais de tamanho de disco do Armazenamento premium. Recomenda-se selecionar pelo menos **512** GiB, o que fornecerá uma quantidade minimamente aceitável de IOPS e taxa de transferência.
22. Na coluna **Hospedar armazenamento em cache**, selecione **Nenhum** e clique em **Salvar**.

## Etapa 2: conectar à VM do Azure

Use o RDP (Remote Desktop Protocol) de um computador com o Microsoft Windows para conectar-se a uma VM do Azure executando o Microsoft Windows. Caso esteja se conectando de um computador com o Linux, você poderá usar [rdesktop](http://www.rdesktop.org/) para se conectar à VM do Azure com o Microsoft Windows em execução. Para obter mais informações, consulte [Como se conectar e fazer logon em uma máquina virtual do Azure executando o Windows](https://docs.microsoft.com/pt-br/azure/virtual-machines/windows/connect-logon) no site do Microsoft Azure.

1. No Painel do Azure, clique no bloco da VM e, em seguida, em **Conectar** para baixar e usar o arquivo RDP para a VM.
    
    **Observação:** é possível salvar o arquivo RDP para conectar-se à VM a qualquer momento.
2. Clique duas vezes no arquivo RDP. Caso veja um aviso de que o publicador da conexão remota não pode ser identificado, clique em **Conectar**.
3. Na caixa de diálogo **Segurança do Windows**, insira o nome e a senha especificados anteriormente ao criar a instância e clique em **OK**.
    
    **Observação:** caso já esteja conectado a um domínio do Windows, a caixa de diálogo poderá oferecer opções para se conectar como o usuário de domínio. Neste caso, insira as credenciais em **Outro usuário**. No campo de senha, selecione o computador local como o domínio.

## Etapa 3: adicionar um segundo disco à VM do Azure

Você deve configurar o disco de dados adicionado antes que o Windows Server o reconheça. Você instalará Tableau Server neste disco na [Autoimplantar um único Tableau Server no Microsoft Azure](#Step4).

1. Na VM do Azure com Microsoft Windows, clique com o botão direito do mouse no botão **Iniciar** e escolha **Executar**.
2. Abra o **Gerenciamento de disco**. Digite **diskmgmt.msc** e, em seguida, pressione **Enter**.
3. Na caixa de diálogo **Inicializar disco**, clique em **OK**.
4. Clique com o botão direito do mouse em Disco 2 e escolha **Novo volume simples**.
5. No **Assistente de novo volume simples**, clique em **Próximo** em cada tela e aceite os valores padrão até chegar à tela final e, em seguida, clique em **Concluir**.
6. Quando solicitado a formatar o disco, clique em **Formatar disco** e, em seguida, na caixa de diálogo **Formatar novo volume**, clique em **Iniciar**.

## Etapa 4: instalar o Tableau Server na VM do Azure

Instalar o Tableau Server na máquina virtual (VM) do Microsoft Azure é semelhante a instalá-lo em qualquer outro servidor.

**Observação:**

- Você pode selecionar a autenticação local ou a autenticação do Active Directory. No entanto, se selecionar a autenticação do Active Directory, ele deverá estar configurado no Azure. Para obter mais informações, consulte [Instalar uma réplica do controlador de domínio do Active Directory em uma rede virtual do Azure](https://azure.microsoft.com/pt-br/documentation/articles/virtual-networks-install-replica-active-directory-domain-controller/) na documentação do Microsoft Azure.
- O usuário Run As deve ser um usuário local na instância do servidor.

1. Copie o programa de instalação do Tableau Server no disco de dados adicionado à VM fazendo o seguinte:
    
    - Copie o programa de instalação do Tableau Server no disco de dados adicionado à VM fazendo o seguinte:
        
        - **Baixe o instalador diretamente**. Enquanto estiver conectado à VM, abra um navegador, vá até a [página de download do Tableau Server](http://www.tableau.com/pt-br/products/server/download) e baixe a versão de 64 bits do Tableau Server.
            
            **Observação:** a configuração de segurança padrão aprimorada no Windows Server determina que o Internet Explorer esteja sempre configurado como Alto para a zona da Internet e não pode ser alterado para essa zona. Dessa forma, ao navegar para sites públicos usando o Internet Explorer, é necessário adicioná-los à lista de sites confiáveis.
        - **Copie o instalador para a VM**. Caso já tenha uma cópia do instalador do Tableau Server em seu computador, copie-a para o disco em que a VM foi adicionada. Crie uma pasta na VM onde deseja colocar o instalador. No computador, faça upload do arquivo de instalação do Tableau Server (por exemplo, TableauServer-64bit-10.5.exe) para a VM.
    - **Copie o instalador para a VM**. Caso já tenha uma cópia do instalador do Tableau Server em seu computador, copie-a para a VM. Crie uma pasta na VM onde deseja colocar o instalador. No computador, faça upload do arquivo de instalação do Tableau Server (por exemplo, TableauServer-64bit-10.5.exe) para a VM.
2. Execute o instalador do Tableau Server na VM para iniciar o processo de instalação do servidor. O processo de instalação funciona da mesma forma que em qualquer outro servidor. Para obter mais informações, consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).

## Etapa 5: acessar a VM do Azure de um navegador remoto

Certifique-se de que os usuários possam acessar a máquina virtual (VM) do Azure onde o Tableau Server foi instalado.

1. No portal do Microsoft Azure, navegue até a página **Visão geral** da VM. Observe o endereço IP público associado à VM.
2. (opcional) Para dar à VM um nome de host público, clique no endereço IP público.
3. Em outro computador (não na VM), abra um navegador.
4. No navegador, digite o endereço IP ou o nome DNS do Tableau Server instalado na VM.
    
    Exemplos:
    
    `http://13.64.47.61` ou `http://tableauonazure.westus.cloudapp.azure.com`
5. Se não conseguir se conectar à instância, consulte [Solução de problemas do Tableau Server no Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_troubleshooting.htm).

## Etapa 6: publicar dados para o Tableau Server na VM do Azure

Depois de configurar o Tableau Server na máquina virtual (VM) do Microsoft Azure, os usuários da empresa poderão publicar pastas de trabalho e fontes de dados para o Tableau Server na VM. O processo funciona da mesma maneira que ocorre se o Tableau Server estiver instalado no local, exceto que os usuários devem entrar no servidor executado na VM.

Antes de permitir que os usuários façam publicações, verifique se cada um deles foi criado com a função no site de Publisher (Publicador) no Tableau Server e se têm permissões para Publisher (Publicador). Para obter mais informações, consulte [Adicionar usuários ao Tableau Server](https://help.tableau.com/current/server/pt-br/users_add.htm).

Para publicar pastas de trabalho e fontes de dados no Tableau Server, os usuários devem entrar no servidor usando o endereço IP (ou nome do host DNS opcional) criado para a VM (por exemplo, `http://13.64.47.61` ou `http://tableauonazure.westus.cloudapp.azure.com`) e usar o nome de usuário e a senha atribuídos. Para obter mais informações, consulte [Como publicar pastas de trabalho no Tableau Server](https://help.tableau.com/current/pro/desktop/pt-br/help.htm) na documentação do Tableau.

## Etapa 7: gerenciar licenças do Tableau Server ao encerrar ou excluir a VM do Microsoft Azure

Verifique se a máquina virtual (VM) do Microsoft Azure usa um endereço MAC estático ou uma ID estática da VM. Se a VM do Microsoft Azure não estiver usando um endereço MAC estático ou uma ID estática da VM, você deve desativar a licença do Tableau Server antes de interromper a instância. Caso contrário, o Tableau Server pode ficar sem licença quando você desligar a VM do Microsoft Azure, que exige a reativação da licença ao reiniciar a VM. Além disso, ao interromper a VM usando o portal do Azure, os recursos são desalocados e as cobranças param de acumular, exceto para o armazenamento. No entanto, caso interrompa a VM encerrando o sistema operacional, os recursos não serão desalocados pelo Azure e as cobranças continuarão sendo acumuladas.

Excluir uma VM desaloca todos os seus recursos, incluindo armazenamento externo. Você pode excluir a VM quando não for mais necessária. Sempre desative sua licença do Tableau Server antes de interromper e excluir a VM.

Antes de excluir a VM, faça o seguinte:

1. Faça logon em sua VM.
2. Crie um backup do Tableau Server e copie o arquivo `.tsbak` para outro local, que será acessível depois que a VM não estiver mais disponível. Para obter mais informações, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).
3. Use o comando [tsm licenses deactivate](https://help.tableau.com/current/server-linux/pt-br/cli_licenses_tsm.htm#TSMDeactivate) para desativar sua chave do produto do Tableau Server. Agora você pode interromper e excluir sua VM.

<!-- document id=f0012d53228bdf52f23e664a4dee56fde965bf8c8f310706ee28d84d9be5ea2c url=/tableau/current/pt-br/server/extract_refresh.md -->

[Pular para o conteúdo principal](#main-content)

# Automatizar tarefas de atualização

Você pode associar tarefas de atualização de extração a agendas no Tableau Server para automatizar a atualização de extrações. Você também pode automatizar as atualizações da extração usando o tabcmd, um utilitário de linha de comando que você pode baixar para uso com o Tableau Server. Em particular, você pode usar o comando `refreshextracts` em combinação com outros comandos em seu próprio script. Por exemplo:

`tabcmd login - http://mytabserver -u jsmith -p P@ssw0rd! refreshextracts --datasource salesq4`

**Observação:** quando uma atualização é executada em extrações criadas no Tableau 10.4 e versões anteriores (ou seja, em extrações .tde), elas são atualizadas automaticamente para o formato .hyper. Embora existam diversos benefícios em atualizar para uma extração .hyper, não será possível abrir a extração usando as versões anteriores do Tableau Desktop. Para obter mais informações, consulte [Atualização de extrações para o formato .hyper](https://help.tableau.com/current/server/pt-br/extracting_upgrade.htm). 

## Observações

- O subintervalo é convertido automaticamente em UTC. Em ambientes que usam fusos horários diferentes de UTC, configure o subintervalo com base no UTC.

Para obter informações sobre o download do utilitário tabcmd, consulte [tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm).

<!-- document id=2a61cdca64b8e92cb50453fd9899ff238f8893f2ebf23dda5eac9bbefeaa8f66 url=/tableau/current/pt-br/server/license_automating.md -->

[Pular para o conteúdo principal](#main-content)

# Automatizar tarefas de licenciamento

Várias opções de linha de comando permitem realizar as tarefas comuns de licenciamento do Tableau Server com scripts automatizados.

Se você desejar executar essas tarefas de licenciamento do Tableau Desktop com scripts automatizados, consulte [Implantar o Tableau Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm) no Guia de implantação do Desktop.

## Opções da ferramenta de linha de comando e uma melhor automação do script

É possível usar um utilitário chamado `tabinstallck.exe` para criar scripts de ativação, atualização e desativação das chaves do produto do servidor. `tabinstallck.exe` é instalado no diretório \\bin do Tableau Server no nó inicial. Por padrão, ele é:

`C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>`

Também é possível usar `tsm licenses` para executar tarefas de licenciamento, como ativar ou desativar uma chave do produto do Tableau Server on-line ou off-line e obter arquivos relacionados para ativação ou desativação off-line. No entanto, Tableau Server já deve estar implantado e configurado. Automatize essas tarefas de licenciamento usando a [API do Gerenciador de serviços do Tableau](http://onlinehelp.tableau.com/v0.0/api/tsm_api/pt-br/index.htm). Além disso, `tabinstallck.exe` oferece uma maneira de fazer o script da etapa de licenciamento de uma nova instalação do Tableau Server que não está totalmente configurada.

Para usar `tabinstallck.exe`, execute os comandos ou crie scripts como um administrador no nó do Tableau Server primário.

**Observação**: o `tabinstallck.exe` não é compatível com ativação e desativação off-line. Para saber mais, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

## Operações da chave do produto com servidores proxy de encaminhamento

Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de tentar ativar, atualizar ou desativar chaves do produto.

## Ativar

Ative uma licença do Tableau Server com a opção `-activate`:

start/wait tabinstallck.exe -activate <product\_key>

## Atualizar

Atualize uma licença do Tableau Server com a opção `-refresh`:

start/wait tabinstallck.exe -refresh <product\_key>

## Desativar

Desative uma licença do Tableau Server com a opção `-return`:

start/wait tabinstallck.exe -return <product\_key>

## Exemplo

Veja o exemplo de um script para ativar o Tableau Server:

@echo off
start/wait tabinstallck.exe -activate <product\_key>
if %errorlevel% EQU 0 (ECHO SUCCESS) ELSE (ECHO FAILED)

## Solução do Erro

Quando você usa `tabinstallck.exe` para automatizar tarefas de licenciamento do Tableau Server, as informações de status são retornadas como um código de saída na variável de ambiente ERRORLEVEL. Se a ativação tiver êxito, o código de saída será `0` (zero). A tabela abaixo lista os códigos de saída do processo de ativação e os respectivos significados. Você também pode encontrar informações de erros no arquivo `tabinstallck.log`. Esse arquivo de log está na pasta \\logs do Tableau Server, por padrão:

`C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\`

A pasta ProgramData fica oculta por padrão.

Este script de exemplo mostra como ativar o Tableau Server e verificar se há erros específicos, como uma chave de produto inválida (536871018) e problemas de licenciamento gerais (536871012).

@echo off
start/wait tabinstallck.exe -activate  _<product\_key>_
if %errorlevel% EQU 536871018 (ECHO TABLEAU\_ERROR\_LICENSING\_INVALID\_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU\_ERROR\_LICENCING\_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)

<table class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>Código de saída</th><th>Mensagem</th><th>Valor</th></tr><tr><td><code>536871012</code></td><td><code>TABLEAU_ERROR_LICENSING_GENERAL</code></td><td>Ocorreu um erro desconhecido durante a operação de licenciamento.</td></tr><tr><td><code>536871013</code></td><td><code>TABLEAU_ERROR_LICENSING_INTERNAL</code></td><td>O produto não pode ser iniciado devido a um erro de licenciamento interno.</td></tr><tr><td><code>536871014</code></td><td><code>TABLEAU_ERROR_LICENSING_SETUP</code></td><td>O produto não pode ser iniciado devido a um erro de licenciamento interno.</td></tr><tr><td><code>536871015</code></td><td><code>TABLEAU_ERROR_LICENSING_CONNECT</code></td><td>Erro ao entrar em contato com o servidor de licenças do Tableau.</td></tr><tr><td><code>536871017</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_ASR</code></td><td>Erro ao ativar o ASR.</td></tr><tr><td><code>536871016</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_GENERAL</code></td><td>Falha na ativação, tente novamente.</td></tr><tr><td><code>536871018</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEY</code></td><td>Chave do produto inválida.</td></tr><tr><td><code>536871019</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINE</code></td><td>Não é possível concluir a ativação offline.</td></tr><tr><td><code>536871020</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODEL</code></td><td>Um erro foi retornado do servidor de licenças. Verifique o arquivo de registro do Tableau para obter mais informações.</td></tr><tr><td><code>536871021</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTS</code></td><td>Falha ao desativar a licença porque você chegou ao limite de desativações dessa licença.</td></tr><tr><td><code>536871033</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONS</code></td><td>Falha ao ativar a licença porque você chegou ao limite de ativações dessa licença.</td></tr><tr><td><code>536871022</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_GENERAL</code></td><td>Ocorreu um erro desconhecido durante a operação de desativação do licenciamento. Verifique sua chave de produto ou entre em contato com o suporte.</td></tr><tr><td><code>536871023</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUND</code></td><td>Nenhuma licença encontrada.</td></tr><tr><td><code>536871024</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED</code></td><td>Somente chaves de produto expiradas foram encontradas.</td></tr><tr><td><code>536871025</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIAL</code></td><td>Sua avaliação dessa versão terminou.</td></tr><tr><td><code>536871026</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTION</code></td><td>A chave de produto expirou.</td></tr><tr><td><code>536871027</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCE</code></td><td>A manutenção expirou.</td></tr><tr><td><code>536871028</code></td><td><code>TABLEAU_ERROR_LICENSING_RESYNC_GENERAL</code></td><td>Não foi possível sincronizar suas chaves de produto.</td></tr><tr><td><code>536871029</code></td><td><code>TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL</code></td><td>Ocorreu um erro durante o registro do produto.</td></tr><tr><td><code>536871030</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_INSTALL</code></td><td>Ocorreu um erro desconhecido durante as operações de licenciamento.</td></tr><tr><td><code>536871031</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALL</code></td><td>Ocorreu um erro desconhecido durante as operações de licenciamento.</td></tr><tr><td><code>536871032</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENT</code></td><td>O serviço de licenciamento FLEXnet não está presente no sistema.</td></tr></tbody></table>

<!-- document id=6a43867d801fe815560c5316fa2d4ef6fc7db609e6296bec9fe0eafda418e53c url=/tableau/current/pt-br/server/security_authorize.md -->

[Pular para o conteúdo principal](#main-content)

# Autorização

_Autorização_ refere-se a como e o que os usuários podem acessar e fazer no Tableau Server após a verificação da autenticação. A autorização inclui:

- o que os usuários podem fazer com o conteúdo hospedado no Tableau Server, incluindo projetos, sites, pastas de trabalho e exibições;
- o que os usuários podem fazer com as fontes de dados gerenciadas pelo Tableau Server;
- quais tarefas os usuários podem executar para administrar o Tableau Server, como definir configurações do servidor, executar as ferramentas da linha de comando, criar sites e outras tarefas.

A autorização dessas ações é gerenciada pelo Tableau Server e determinada por uma combinação das permissões e da função de site do usuário associadas a entidades específicas como pastas de trabalho e fontes de dados.

## Funções de site

As funções de site definem quem é um administrador. É possível atribuir administradores no nível do site ou do servidor. Para não administradores, as funções de site indicam o nível máximo de acesso que um usuário pode ter em determinado site, sujeito a um conjunto de permissões em ativos de conteúdo. Por exemplo, se for atribuída a função de site Viewer (Visualizador) para um usuário e para outro a de Creator(Criador)Creator

Para obter mais informações sobre as funções de site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

## Permissões

As permissões determinam se um usuário específico está autorizado ou não a realizar uma determinada ação em um ativo de conteúdo específico.

Como um administrador configurando um Tableau Server, é importante entender como as permissões são avaliadas. Entender o processo de permissões do Tableau permitirá que você defina e configure permissões em sites, projetos e em outros ativos para que seja possível controlar como o conteúdo e os dados são publicados, visualizados, extraídos e importados.

Quatro conceitos importantes a entender sobre permissões no Tableau são:

- **As permissões são baseadas em ativos**. As permissões são atribuídas a ativos de conteúdo individuais (projetos, fontes de dados, pastas de trabalho) e são concedidas a usuários ou grupos.
- **As permissões são implicitamente negadas e usuários que não são administradores devem ter permissão explícita para acessar o conteúdo**. O processo pelo qual o Tableau Server determina a permissão “permitir” ou “negar” é explicado em detalhes no tópico [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#EvaluatePermRules).
- **A herança de permissões existe apenas em projetos bloqueados e em pastas de trabalho com exibições em guias**. Quando as permissões de conteúdo são bloqueadas para projeto de nível superior, pastas de trabalho, exibições e fontes de dados em todo o projeto, a hierarquia usará o conjunto de permissões padrão no projeto de nível superior. Em pastas de trabalho salvas com a opção Mostrar planilhas como guias, as exibições nelas usarão as permissões da pasta de trabalho. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#projectpermissions).
- **Em um projeto que não está bloqueado, as permissões iniciais são uma cópia única das permissões de item do contêiner**. Uma fonte de dados ou pasta de trabalho inicia com as permissões padrão, mas os usuários autorizados podem, posteriormente, editar permissões nesses ativos. Para obter informações sobre as permissões padrão e projetos, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#LockProject).

O Tableau Server oferece uma infraestrutura flexível de permissões que permite que você gerencie o acesso a todo o conteúdo em incontáveis cenários. Para obter mais informações detalhadas, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

## Acesso a dados e autorização externa

Há cenários nos quais o Tableau Server e Desktop confiam em autorização externa para habilitar o acesso aos dados. Por exemplo:

- Os usuários que estiverem se conectando a fontes de dados externas podem precisar de uma autorização que está fora do escopo de autoridade do Tableau Server. Se os usuários publicarem uma fonte de dados externa, o Tableau Server gerenciará o acesso e os recursos dessa fonte de dados. Mas, se os usuários inserirem uma fonte de dados externa em uma pasta de trabalho, será responsabilidade do usuário que publica a pasta de trabalho determinar como outros usuários que abrirão a pasta de trabalho serão autenticados junto aos dados subjacentes aos quais a fonte de dados se conecta.
- Executar o Tableau Server em uma organização com o Active Directory, na qual o Tableau foi configurado com uma conta de Usuário Run As , resulta em uma dependência de autorização no Active Directory e no NTFS. Por exemplo, se você configurar o Tableau Server para usar a conta Run As para representar usuários que se conectam ao SQL, a autorização no nível do objeto depende do NTFS e do Active Directory.
- As formas como os usuários autenticam e são autorizados por soluções específicas de banco de dados podem ser diferentes. Conforme observado, o Tableau Server pode ser configurado para oferecer autorização de acesso quando uma fonte de dados é configurada, mas alguns bancos de dados autorizarão o acesso de acordo com seu próprio esquema de autenticação.

<!-- document id=975ec4bb6f900550f16bd6b959f3d7b9b1c3132057f8e3a236b3a94544902792 url=/tableau/current/pt-br/server/security_kms_azure.md -->

[Pular para o conteúdo principal](#main-content)

# Azure Key Vault

O Tableau Server tem três opções de Sistema de gerenciamento de chaves (KMS) que permitem ativar a criptografia em repouso. Duas delas exigem os recursos de Advanced Management, enquanto um local está disponível com todas as instalações do Tableau Server.

**Importante:** a partir de 16 de setembro de 2024, o Advanced Management não estará mais disponível como uma opção complementar independente. Os recursos do Advanced Management só estarão disponíveis se você o adquiriu anteriormente ou se você comprar determinadas edições de licença: Tableau Enterprise, Tableau Cloud+ ou Tableau+ Bundle (disponível para Tableau Cloud) ou Tableau Enterprise ou Tableau Server+ (disponível para Tableau Server).

A partir da versão 2019.3, o Tableau Server adicionou essas opções KMS: 

- Um KMS local que está disponível com todas as instalações. Para obter detalhes, consulte [Sistema de gerenciamento de chaves do Tableau Server](https://help.tableau.com/current/server/pt-br/security_kms.htm).
- Um KMS baseado em AWS, que vem como parte do Advanced Management. Para obter detalhes, consulte [Sistema de gerenciamento de chaves da AWS](https://help.tableau.com/current/server/pt-br/security_kms_aws.htm).

A partir da versão 2021.1, o Tableau Server adicionou outra opção de KMS: 

- Um KMS baseado em Azure, que vem como parte do Advanced Management. Isso está descrito abaixo.

## Azure Key Vault para criptografia em repouso

O Azure Key Vault está disponível como parte do Advanced Management no Tableau Server, a partir da versão 2021.1.0. Para obter mais informações, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

Se a empresa estiver implantando a Criptografia de extração de dados em repouso, opcionalmente, é possível configurar o Tableau Server para usar o Azure Key Vault como o KMS para criptografia de extração. Para ativar o Azure Key Vault, você deve implantar o Tableau Server no Azure. No cenário do Azure, o Tableau Server usa o Azure Key Vault para criptografar a chave raiz principal (RMK) para todas as extrações criptografadas. No entanto, mesmo se configurado para o Azure Key Vault, o repositório de chaves Java nativo e o KMS local do Tableau Server ainda são usados para o armazenamento seguro de segredos no Tableau Server. O Azure Key Vault só é usado para criptografar a chave mestra raiz para extrações criptografadas.

![Um diagrama ilustra várias chaves para criptografia de dados.](/tableau/current/pt-br/server/pt-br/Img/security_kms_azure_hierarchy.png)

A hierarquia de chaves do Tableau Server é configurada com o Azure Key Vault

## Configurar o Azure Key Vault para extrações criptografadas do Tableau Server

Para usar o Azure Key Vault para criptografar a chave raiz na hierarquia do KMS do Tableau Server, configure o Tableau Server conforme descrito nesta seção.

Antes de começar, verifique se os seguintes requisitos foram atendidos:

- O Tableau Server deve ser implantado no Azure.
- O Tableau Server deve ser configurado com uma licença do Advanced Management. Consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).
- Você deve ter controle administrativo sobre o Azure Key Vault onde a chave reside.

### Etapa 1: criar um cofre de chaves e uma chave para o Tableau Server no Azure

Os seguintes procedimentos são realizados no serviço do Azure Key Vault. As referências são incluídas na documentação do Azure.

1. Crie o cofre de chaves que você usará para o Tableau Server. Consulte o tópico do Azure, [Criar um cofre de chaves](https://docs.microsoft.com/pt-br/azure-stack/user/azure-stack-key-vault-manage-portal?view=azs-2008#create-a-key-vault).
2. Crie uma chave no cofre. Veja o tópico do Azure, [Gerenciar chaves e segredos](https://docs.microsoft.com/pt-br/azure-stack/user/azure-stack-key-vault-manage-portal?view=azs-2008).
    
    A chave deve ser um tipo RSA assimétrico, mas pode ser de qualquer tamanho (o Tableau Server não se importa com o tamanho da chave). Recomendamos que você use o Princípio do menor privilégio para ter segurança máxima.
    
    O Tableau requer permissões para executar as operações de comandos GET, UNWRAP KEY e WRAP KEY, e recomendamos permitir acesso para apenas esses comandos para obter menos privilégio. Atribua a política de acesso à VM em que você está executando o Tableau Server.
    
    Em uma implantação de vários nós do Tableau Server, a política de acesso deve ser atribuída a todos os nós do cluster do servidor.

### Etapa 2: coletar parâmetros de configuração do Azure

Você precisará do nome do cofre de chaves e do nome da chave do Azure.

### Etapa 3: configurar o Tableau Server para Azure Key Vault

Execute o seguinte comando no Tableau Server. Este comando reiniciará o servidor:

- ```
    tsm security kms set-mode azure --vault-name "<vault name>" --key-name "<key name>"
    ```
    
    As opções `--vault-name` e `--key-name` de cópias de cadeias de caracteres diretas do seu Azure Key Vault.
    
    Por exemplo, se o Azure Key Vault for chamado `tabsrv-keyvault` e a chave for `tabsrv-sandbox-key01` então o comando será:
    
    `tsm security kms set-mode azure --vault-name "tabsrv-keyvault" --key-name "tabsrv-sandbox-key01"`

### Etapa 4: habilitar criptografia em repouso

Consulte [Criptografia de extrações em repouso](security_ear.htm).

### Etapa 5: validar a instalação

1. Execute o seguinte comando:
    
    `[tsm security kms status](cli_security_tsm.htm#kms-status)`
    
    As seguintes informações podem ser retornadas:
    
    - Status: OK (indica que o cofre da chave está acessível pelo nó do controlador):
    - Modo: Azure Key Vault
    - Nome do cofre: <key\_vault\_name>
    - Nome da chave do Azure Key Vault:<key\_name>
    - Lista de UUIDs disponíveis para MEKs indicando qual chave está ativa
    - Informações de erro se os dados do KMS não forem acessíveis
2. Exibir registros após criptografar e descriptografar extrações:
    
    - Publicar extrações no site e criptografá-las. Consulte [Criptografia de extrações em repouso](security_ear.htm).
    - Acesse as extrações com o Tableau Desktop ou com a criação na Web em um navegador (isso descriptografa as extrações para uso).
    - Pesquise os arquivos de registro vizqlserver\_node para as cadeias de caracteres `AzureKeyVaultEnvelopeAccessor` e `AzureKeyVaultEnvelope`. O local padrão dos registros se encontra em `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs`
        
        Para atualizações de publicação e extração relacionadas ao Azure Key Vault, pesquise os registros do processador em segundo plano. Para obter mais informações sobre os registros, consulte [Locais de arquivo de registro e registros do Tableau Server](logs_loc.htm).

## Solucionar problemas de configuração

### Configuração incorreta em vários nós

Em uma configuração de vários nós para o Azure Key Vault, o comando `tsm security kms status` pode relatar status íntegro (OK), mesmo que outro nó no cluster esteja configurado incorretamente. A verificação de status KMS relata apenas sobre o nó em que o processo do Controlador de administração do Tableau Server está sendo executado. Ele não relata os outros nós do cluster. Por padrão, o processo do Controlador de administração do Tableau Server é executado no nó inicial do cluster.

Portanto, se outro nó estiver configurado incorretamente, de modo que o Tableau Server não possa acessar o Azure Key Vault, esses nós podem relatar estados de erro para vários serviços, que não seriam iniciados.

Se alguns serviços não iniciarem após definir o KMS como modo “azure”, execute o comando a seguir para reverter para o modo local: `tsm security kms set-mode local`.

## Atualizar a chave do Azure

Você atualiza a chave do Azure no Azure. Não há um período de atualização de chaves necessário ou agendado. Você pode atualizar sua chave criando uma nova versão da chave no Azure. Como o cofre de chaves e o nome da chave não mudam, não é necessário atualizar a configuração KMS no Tableau Server para cenários normais de atualização do Azure Key Vault.

## Backup e restauração com Azure Key Vault

Um backup do servidor pode ser obtido no modo Azure Key Vault sem configurações ou procedimentos adicionais. O backup contém cópias criptografadas da RMK e das MEKs. A descriptografia das chaves requer acesso e controle do Azure Key Vault.

Para o cenário de restauração, o servidor que está sendo restaurado pode estar no modo Azure Key Vault ou KMS Local. O único requisito é que o servidor para o qual o backup está sendo restaurado tenha acesso ao Azure Key Vault que o próprio backup usou.

<!-- document id=4d32479bd1fff18c56b57025e042a57c2d0006a257957cf7fbb38162aba9c8e5 url=/tableau/current/pt-br/server/db.md -->

[Pular para o conteúdo principal](#main-content)

# Backup e restauração

Um administrador do Tableau Server deve executar a manutenção regular do banco de dados, monitorar o uso do disco no servidor e apagar arquivos desnecessários para liberar espaço no servidor, além de fazer backup do Tableau Server e de seus dados. Executar essas etapas pode ajudar a garantir que o Tableau Server funcione com a máxima eficiência.

Use a ferramenta de linha de comando do Tableau Services Manager (TSM) para realizar o backup e restaurar os dados do Tableau. Os dados do Tableau incluem arquivos de dados de extração, bem como o próprio banco de dados PostgreSQL do Tableau Server, que armazena metadados da pasta de trabalho e do usuário e dados de configuração do servidor. Os arquivos de registro do Tableau Server capturam a atividade e podem ajudar você a diagnosticar problemas. Os logs são gravados em pastas no servidor e você pode arquivá-los e removê-los para economizar espaço em disco.

**Observação**: é possível usar o comando `tsm maintenance restore` para restaurar backups do Tableau Server criados usando o `tabadmin backup` e o `tsm maintenance backup`. Backups de bancos de dados feitos de outras maneiras e instantâneos da máquina virtual não são fontes válidas para restaurar o Tableau Server.

Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.

## Compatibilidade de plataforma

- É possível usar um backup criado com o Tableau Server no Linux para restaurar o Tableau Server no Windows.
- Você pode usar um backup criado com o Tableau Server no Windows para restaurar o Tableau Server no Linux. Para obter mais informações sobre como restaurar um backup do Windows no Tableau Server no Linux, consulte [Migrar o Tableau Server do Windows para o Linux](https://help.tableau.com/current/server-linux/pt-br/restore_from_backup_linux.htm).
- É possível usar um backup criado com o Tableau Server no Linux para restaurar o Tableau Server no Linux executando um sistema operacional Linux diferente.

## Uso do espaço em disco para backup e restauração

O espaço em disco livre necessário para criar um backup varia dependendo da quantidade de dados nos serviços de armazenamento de arquivos e Repositório do Tableau Server, além de sua localização com o serviço tabadmincontroller. Durante os backups, as tarefas em segundo plano para limpeza de extrações antigas são temporariamente pausadas. Isso significa que, durante o backup, as atualizações de extração deixarão os arquivos extras no lugar, adicionando ao uso de espaço em disco. Se o backup demorar muito ou se a organização usar muitas extrações regularmente atualizadas, isso poderá resultar em uma quantidade significativa de uso de espaço em disco temporário. Esses arquivos temporários serão removidos depois que o backup for concluído.

A tabela a seguir lista os requisitos de espaço em disco para backup com base em se o nó hospeda o repositório, no armazenamento de arquivos, no controlador ou alguma combinação deles. Em ambientes do Tableau Server com vários nós, você precisa estimar o espaço em disco necessário em cada nó.

<table style="max-width: 100%;" class="simple-table"><colgroup><col style="width: 110px;"><col style="width: 110px;"><col style="width: 107px;"><col></colgroup><tbody><tr><th>Repositório</th><th>Armazenamento de arquivo</th><th>Controlador</th><th>Espaço em disco necessário</th></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td>&nbsp;</td><td><p>Dados de repositório 3x + 250 MB</p><p>Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório <code>&lt;data directory&gt;/pgsql/data/base</code>.</p><p>Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo workgroup.pg_dump.</p></td></tr><tr><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td><p>Dados do armazenamento de arquivos 1.5x</p><p>Para obter uma estimativa dos dados do armazenamento de arquivos (extrações, fluxos etc.), verifique o tamanho do diretório <code>&lt;data directory&gt;/dataengine</code>.</p></td></tr><tr><td>&nbsp;</td><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr></tbody></table>

#### Requisitos de recuperação do espaço em disco

Você deve ter o espaço em disco adequado para que o processo de restauração do banco de dados seja executado com êxito.

Para restaurar o Tableau Server:

- Em nós de controlador, você precisa de espaço livre igual ao tamanho do arquivamento de backup.
- Em nós de repositório, você precisa de espaço livre igual ao triplo do tamanho dos dados do repositório no arquivamento de backup, além de 250 MB e do tamanho do diretório de dados pgsql.
- Em nós de armazenamento de arquivos, você precisa de espaço livre igual ao dobro do tamanho da pasta do mecanismo de dados no arquivamento de backup.

## Práticas recomendadas para backup do Tableau Server

Recomendamos seguir essas práticas recomendadas de segurança e desempenho.

### Proteger arquivos de backup

Embora os segredos de configuração sejam criptografados quando armazenados em disco internamente, ao exportar essas configurações para um arquivo, os segredos são gravados no arquivo em texto simples. O administrador é responsável pela proteção do arquivo de backup. Há várias opções disponíveis:

- Gravar o arquivo em um sistema de arquivos criptografado.
- Grave o arquivo em um disco que esteja fisicamente protegido e restrito a usuários específicos.
- Codifique o arquivo de backup.

### Maximizar a eficiência do backup

Há várias maneiras de maximizar a eficiência do backup. Seu ambiente pode afetar a eficiência de cada um deles, então teste com seus dados para ver o que funciona melhor.

**Otimização com configurações de topologia:**

- Colocalizar o Armazenamento de arquivos no mesmo nó que o Controlador de administração pode reduzir o tempo necessário para fazer backup do Tableau Server, reduzindo ou eliminando a necessidade de transferir dados entre nós durante o processo de backup. Isso é especialmente verdade se sua organização usa muitos extratos.
- A colocalização do repositório (pgsql) com o nó Controlador de administração também pode ajudar a reduzir o tempo de backup, mas a economia de tempo é menos significativa do que a do Armazenamento de arquivos.

O Controlador de administração geralmente está no nó inicial, a menos que você tenha tido uma falha no nó inicial e movido o controlador para outro nó.

Otimização com estratégias de backup:

Backup é um processo que utiliza muitos recursos. Se possível, é uma boa estratégia fazer seus backups durante os horários menos movimentados. No entanto, isso depende de seus requisitos de restauração e com que frequência os dados do Tableau Server são atualizados. Para obter uma explicação detalhada sobre backup e recuperação de desastres, consulte [Recuperação de desastres do Tableau Server](https://www.tableau.com/sites/default/files/whitepapers/disaster_recovery_whitepaper_0.pdf). Aqui estão algumas estratégias de backup, adote-as para suas necessidades

- **Tipo de armazenamento:** os discos de estado sólido são recomendados em geral para backups. O SSD ajuda a tornar logo os seus backups mais rápidos e completos, em comparação com os discos giratórios tradicionais.
- **Compactação de backup:** você tem a opção de executar seus backups com ou sem compactação. Quando você fizer seu backup com compactações, seu tamanho de backup será relativamente menor, mas você pode perceber um desempenho mais lento. Então, se o seu objetivo é mais velocidade, escolha a opção `--skip-compression`:
    
    Use a opção `--skip-compression` ao fazer backup do Tableau Server. Isso cria o backup sem usar compactação e resulta em um arquivo de backup maior, mas pode reduzir o tempo necessário para que o backup seja concluído. Para obter mais informações, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm).
- **Backup instantâneo:** essa opção só estará disponível se você tiver configurado o servidor Tableau Server com Armazenamento de arquivos externos. Embora o desempenho dos backups instantâneos dependa do tipo de armazenamento conectado à rede, em geral eles são mais rápidos do que os backups tradicionais do Tableau Server. Para obter mais informações, consulte [Armazenamento de arquivos externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm).

## Outros artigos nesta seção

<!-- document id=12485f5a1b75aeccd7e83464c542fa790f3beac74944f61a03359fb9898752e3 url=/tableau/current/pt-br/server/server_external_filestore_storage_backup_restore.md -->

[Pular para o conteúdo principal](#main-content)

# Backup e restauração com o Armazenamento de arquivos externo

Quando o Armazenamento de arquivos externo está habilitado no Tableau Server, você não pode usar o comando `tsm maintenance backup` de para fazer um backup dos dados do Armazenamento de arquivos e do repositório do Tableau Server. Em vez disso, use o processo de backup de instantâneos para criar um instantâneo de tempo do compartilhamento de rede.

- [Tableau Server configurado com o armazenamento de arquivos externo](#external-file-store)
- [O Tableau Server configurado com armazenamento de arquivos externos e repositório externo](#external-file-store-external-repo)

### Estratégias de backup:

A estratégia de backup usada depende do seu plano de recuperação. O processo de backup instantâneo pode não ser suficiente por si só, pois cria apenas um backup do armazenamento de arquivos (e dados do repositório, se solicitado) e há outras configurações e configurações que você pode precisar para fazer uma recuperação completa.

**Important:** você deve desabilitar as tarefas agendadas antes de realizar a atualização. Isso inclui todas as atualizações no conteúdo dos dados e deve ser feito antes de você criar seu backup de pré-atualização. Isso pode envolver a desabilitação de trabalhos acionados fora do Tableau Server, como aqueles iniciados por meio de atualizações de extração baseadas na API REST ou usando tabcmd.

Aqui estão alguns cenários que ilustram onde o processo de backup instantâneo pode ou não ser suficiente:

- **Tableau Server em espera** — Se você mantém um Tableau Server em espera para usar se seu servidor de produção estiver inoperante, criar um backup de instantâneo e restaurá-lo no servidor em espera em uma programação regular pode ser suficiente. Seu cronograma de backup deve ser baseado no objetivo de ponto de recuperação.
- **Novo Tableau Server, configuração existente não necessária** — Se você planeja usar uma nova instalação do Tableau Server em caso de desastre, mas não precisa necessariamente usar as configurações e configurações da sua instalação existente do Tableau Server, pode instalar uma nova instância do Tableau Server e use o instantâneo para restaurar seus dados.
- **Novo Tableau Server, configuração existente necessária —** Se você planeja usar uma nova instalação do Tableau Server que inclua suas configurações e configurações existentes, bem como a data de backup, você precisa de arquivos adicionais junto com o backup do instantâneo. Para fazer um backup completo, incluindo todas as configurações e definições, siga estas instruções:
    
    1. Exporte os dados de topologia e configuração. Isso exporta a maior parte da configuração e topologia do Tableau Server. Para obter mais informações, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm#backup-data-types).
    2. Crie um instantâneo do compartilhamento de rede do Armazenamento de arquivos (e dos dados de repositório, se desejado) conforme descrito na seção [Backup e restauração com o Armazenamento de arquivos externo](#Creating) deste tópico.
    3. Documente as configurações que não estão incluídas na exportação. Isso inclui valores para contas de usuário do sistema, configuração de implementação de serviço de coordenação e configurações personalizadas. Para obter mais informações, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm#backup-assets-that-require-a-manual-process).

## Tableau Server configurado com o armazenamento de arquivos externo

Quando você tem o Tableau Server configurado com um armazenamento de arquivo externo, seu processo de backup precisa incluir a criação de um backup de instantâneo pontual do compartilhamento de rede com o armazenamento de arquivo externo. O procedimento a seguir descreve como fazer isso.

**Observação:** se você tiver um armazenamento de arquivo externo e um repositório externo, consulte [O Tableau Server configurado com armazenamento de arquivos externos e repositório externo](#external-file-store-external-repo).

### Criação de um backup instantâneo

Use as seguintes etapas para criar um backup instantâneo:

1. Prepare-se para backup de instantâneos.
    
    Execute o comando a seguir para criar um arquivo de backup de repositório e copie-o temporariamente no compartilhamento de rede. O Tableau Server continua a operar normalmente durante o processo de instantâneo. Para garantir um instantâneo consistente, o processo interno que exclui as extrações não utilizadas será pausado. Este processo será retomado assim que você concluir o processo de backup, descrito em uma etapa posterior.
    
    `tsm maintenance snapshot-backup prepare`
    
    Você deverá ver a seguinte mensagem quando a etapa de preparação for concluída: **Preparação para backup de captura instantânea bem-sucedida**.
    
    Confirme se o arquivo de backup do repositório foi criado no compartilhamento de rede.
    
    **Observação:** a etapa de preparação cria um arquivo de backup do repositório e das chaves KMS e Asset. Se você estiver usando uma solução em nuvem para sua solução de chave de criptografia, precisará de acesso ao CMK usado para descriptografar as chaves necessárias para restauração. Para obter mais informações sobre a solução de chave de criptografia com a AWS, consulte o [Sistema de gerenciamento de chaves da AWS](https://help.tableau.com/current/server/pt-br/security_kms_aws.htm). Para obter mais informações sobre a solução de chave de criptografia com o Azure, consulte o [Azure Key Vault](https://help.tableau.com/current/server/pt-br/security_kms_azure.htm).
2. Crie um instantâneo do compartilhamento de rede.
    
    Use o processo apropriado para criar um instantâneo de seu compartilhamento de rede. O instantâneo é uma versão somente leitura do compartilhamento, tirada em um determinado momento. Isso incluirá os dados do armazenamento de arquivos, juntamente com o arquivo de backup do repositório que foi temporariamente copiado para o compartilhamento na etapa anterior. As etapas que você executa para criar esse instantâneo de compartilhamento de rede dependem da sua rede. Consulte a documentação de rede para obter detalhes.
3. Conclua o processo de backup de instantâneos.
    
    Execute o comando a seguir para concluir o processo de backup e reiniciar os processos internos pausados. Isso remove o arquivo de backup do repositório temporário que foi copiado para o compartilhamento de rede.
    
    `tsm maintenance snapshot-backup complete`
    
    Confirme se o arquivo de backup do repositório temporário foi removido do compartilhamento de rede.

### Restaurar um backup instantâneo

Essas etapas se aplicam a instalações do Tableau Server de nó único e de vários nós.

1. Interrompa o Tableau Server.
    
    No prompt de comando, execute o seguinte comando:
    
    `tsm stop`
2. Restaure seus dados de armazenamento de arquivos restaurando o instantâneo de compartilhamento de rede para sua rede. As etapas específicas dependerão da sua rede.
3. Restaure os dados do repositório.
    
    Use o comando restore a seguir para restaurar os dados do repositório:
    
    `tsm maintenance snapshot-backup restore`
    
    **Observação:** se você estiver usando uma solução em nuvem para sua solução de chave de criptografia, certifique-se de que o servidor onde o backup está sendo restaurado tenha acesso de descriptografia para a instância da nuvem onde o CMK é implantado.
4. Reinicie o Tableau Server.
    
    Em um prompt de comando, execute o seguinte comando:
    
    `tsm start`

## O Tableau Server configurado com armazenamento de arquivos externos e repositório externo

Quando você tem o Tableau Server configurado com um armazenamento de arquivo externo e um repositório externo, há etapas especiais que você precisa seguir para criar um backup. Isso inclui a criação de um backup instantâneo pontual do compartilhamento de rede com o armazenamento de arquivo externo e pode incluir o backup separado de seu repositório externo. O procedimento a seguir descreve como fazer isso.

**Observação:** se você tiver um armazenamento de arquivo externo, mas estiver usando o repositório padrão, consulte [Tableau Server configurado com o armazenamento de arquivos externo](#external-file-store).

### Backup do repositório

Quando você tem um armazenamento de arquivo externo e um repositório externo, tem duas opções para fazer backup dos dados do repositório. Existem razões pelas quais você pode escolher cada um destes:

- Inclua o backup do repositório com o instantâneo do compartilhamento de rede:
    
    Facilidade de gerenciamento. Você não precisa fazer um backup separado do repositório, e o backup está sincronizado com os dados do armazenamento de arquivos.
- Faça backup do repositório de forma independente:
    
    Fazer um backup de um Repositório externo separadamente pode ser mais rápido, especialmente se você estiver usando uma solução em nuvem que permita backups instantâneos da instância. O tamanho do arquivo de backup pode afetar significativamente o tempo necessário para se preparar para um instantâneo de compartilhamento de rede.

### Opção 1: Incluir backup de repositório com instantâneo de compartilhamento de rede

#### Criação de um backup instantâneo

1. Prepare-se para backup de instantâneos.
    
    Execute o comando a seguir para criar um arquivo de backup de repositório e copie-o temporariamente no compartilhamento de rede. O Tableau Server continua a operar normalmente durante o processo de instantâneo. Para garantir um instantâneo consistente, o processo interno que exclui as extrações não utilizadas será pausado. Este processo será retomado assim que você concluir o processo de backup, descrito em uma etapa posterior.
    
    `tsm maintenance snapshot-backup prepare --include-pg-backup`
    
    **Observação:** a partir de 2021.1, se você tiver o Armazenamento de arquivo externo e o Repositório externo ativados, _deverá_ usar a opção`--include-pg-backup` para criar o backup do repositório. Se você estiver atualizando a partir de uma versão anterior ao 2021.1 tiver scripts para executar ou agendar seus backups e quiser continuar a incluir o backup do repositório, adicione a opção `--include-pg-backup` no comando de preparação, conforme mostrado acima. Para versões anteriores a 2021.1, não precisa da opção, o backup do repositório é incluído automaticamente.
    
    Você deverá ver a seguinte mensagem quando a etapa de preparação for concluída: **Preparação para backup de captura instantânea bem-sucedida**.
    
    Confirme se o arquivo de backup do repositório foi criado no compartilhamento de rede.
    
    **Observação:** a etapa de preparação cria um arquivo de backup do repositório e das chaves KMS e Ativo. Se você estiver usando uma solução em nuvem para sua solução de chave de criptografia, precisará de acesso ao CMK usado para descriptografar as chaves necessárias para restauração. Para obter mais informações sobre a solução de chave de criptografia com a AWS, consulte o [Sistema de gerenciamento de chaves da AWS](https://help.tableau.com/current/server/pt-br/security_kms_aws.htm). Para obter mais informações sobre a solução de chave de criptografia com o Azure, consulte o [Azure Key Vault](https://help.tableau.com/current/server/pt-br/security_kms_azure.htm).
2. Crie um instantâneo do compartilhamento de rede.
    
    Use o processo apropriado para criar um instantâneo de seu compartilhamento de rede. O instantâneo é uma versão somente leitura do compartilhamento, tirada em um determinado momento. Isso incluirá os dados do armazenamento de arquivos, juntamente com o arquivo de backup do repositório que foi temporariamente copiado para o compartilhamento na etapa anterior. As etapas que você executa para criar esse instantâneo de compartilhamento de rede dependem da sua rede. Consulte a documentação de rede para obter detalhes.
    
    **Importante:** o instantâneo do compartilhamento de rede e do repositório backup deve ser concluído dentro de 3 horas após a conclusão da Etapa de preparação (etapa 1). Isso é para permitir garantir que os backups de Armazenamento de arquivos e de Repositório estejam em sincronia para permitir que a restauração funcione corretamente.
3. Conclua o processo de backup de instantâneos.
    
    Execute o comando a seguir para concluir o processo de backup e reiniciar os processos internos pausados. Isso também remove o arquivo de backup do repositório temporário que foi copiado para o compartilhamento de rede.
    
    `tsm maintenance snapshot-backup complete`

#### Restaurar um backup instantâneo

Essas etapas se aplicam a instalações do Tableau Server de nó único e de vários nós.

**Importante:** Se você fizer atualizações Azuis/Verdes ou atualizar manualmente o Tableau Server 2021.4 (ou anterior) usando o método de [manutenção tsm (backup e restauração)](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm) , você deverá habilitar`legacy-identity-mode` antes de poder restaurar para o Tableau Server 2022.1 (ou posterior). Para obter mais informações, consulte [Solucionar problemas com migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm).

1. Interrompa o Tableau Server.
    
    No prompt de comando, execute o seguinte comando:
    
    `tsm stop`
2. Restaure seus dados de armazenamento de arquivos restaurando o instantâneo de compartilhamento de rede para sua rede. As etapas específicas dependerão da sua rede.
3. Restaure os dados do repositório.
    
    Use o comando restore a seguir para restaurar os dados do repositório:
    
    `tsm maintenance snapshot-backup restore`
    
    **Observação:** se você estiver usando uma solução em nuvem para sua solução de chave de criptografia, certifique-se de que o servidor onde o backup está sendo restaurado tenha acesso de descriptografia para a instância da nuvem onde o CMK é implantado.
4. Reinicie o Tableau Server.
    
    Em um prompt de comando, execute o seguinte comando:
    
    `tsm start`

### Opção 2: repositório de backup separadamente

Essa opção é recomendada apenas quando a plataforma host para o Repositório externo permite que você faça backup instantâneo. Se você estiver usando o Azure como plataforma host, recomendamos usar a Opção 1.

#### Criar backups de instantâneos

1. Prepare-se para backup de instantâneos.
    
    Execute o comando a seguir para criar um arquivo de backup de repositório e copie-o temporariamente no compartilhamento de rede. O Tableau Server continua a operar normalmente durante o processo de instantâneo. Para garantir um instantâneo consistente, o processo interno que exclui as extrações não utilizadas será pausado. Este processo será retomado assim que você concluir o processo de backup, descrito em uma etapa posterior.
    
    `tsm maintenance snapshot-backup prepare`
    
    Você deverá ver a seguinte mensagem quando a etapa de preparação for concluída: **Preparação para backup de captura instantânea bem-sucedida**.
    
    **Observação:** a etapa de preparação cria um backup do das chaves KMS e Ativo. Se você estiver usando uma solução em nuvem para sua solução de chave de criptografia, precisará de acesso ao CMK usado para descriptografar as chaves necessárias para restauração. Para obter mais informações sobre a solução de chave de criptografia com a AWS, consulte o [Sistema de gerenciamento de chaves da AWS](https://help.tableau.com/current/server/pt-br/security_kms_aws.htm). Para obter mais informações sobre a solução de chave de criptografia com o Azure, consulte o [Azure Key Vault](https://help.tableau.com/current/server/pt-br/security_kms_azure.htm).
2. Crie um instantâneo do compartilhamento de rede.
    
    Use o processo apropriado para criar um instantâneo de seu compartilhamento de rede. O instantâneo é uma versão somente leitura do compartilhamento, tirada em um determinado momento. Isso incluirá seus dados de armazenamento de arquivos. As etapas que você executa para criar esse instantâneo de compartilhamento de rede dependem da sua rede. Consulte a documentação de rede para obter detalhes.
3. Crie um backup do repositório: use a tecnologia de backup da plataforma onde você está hospedando seu repositório externo para criar um backup.
    
    **Importante:** o instantâneo do compartilhamento de rede e do repositório backup deve ser concluído dentro de 3 horas após a conclusão da Etapa de preparação (etapa 1). Isso é para permitir garantir que os backups de Armazenamento de arquivos e de Repositório estejam em sincronia para permitir que a restauração funcione corretamente.
    
    Para obter mais informações sobre como criar um instantâneo da instância de DB da AWS, consulte [Criação de um instantâneo DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateSnapshot.html).
    
    Para obter mais informações sobre a criação de um backup da instância do Azure DB, consulte [Backup e restauração no servidor flexível](https://docs.microsoft.com/en-us/azure/postgresql/flexible-server/concepts-backup-restore) (PostgreSQL 12 e posterior) ou [Backup e restauração no servidor único](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-backup) (PostgreSQL 11 ou anterior).
    
    **Observação:** se você estiver usando uma solução em nuvem para sua solução de chave de criptografia, certifique-se de que o servidor onde o backup está sendo restaurado tenha acesso de descriptografia para instância da nuvem onde o CMK é implantado.
4. Conclua o processo de backup de instantâneos.
    
    Execute o comando a seguir para concluir o processo de backup e reiniciar os processos internos pausados.
    
    `tsm maintenance snapshot-backup complete`

#### Restaurar um backup instantâneo

Essas etapas se aplicam a instalações do Tableau Server de nó único e de vários nós.

1. Use o backup do banco de dados do Repositório externo. Se você estiver usando uma plataforma de nuvem para hospedar seu Repositório, geralmente, isso requer que você crie uma nova instância de banco de dados para restaurar o backup.
    
    Para obter instruções detalhadas sobre como criar uma nova instância, consulte a opção para sua solução de hospedagem em [Instalar repositório externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm#external-repo-install).
2. Use as instruções na Etapa 1 do tópico [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm) para criar um arquivo de configuração para a nova instância.
3. Interrompa o Tableau Server.
    
    No prompt de comando, execute o seguinte comando:
    
    `tsm stop`
4. Se a restauração do repositório externo exigir uma nova instância de banco de dados, use o seguinte comando para apontar o Tableau Server para a nova instância de banco de dados e, em seguida, aplique as alterações em Tableau Server:
    
    `tsm topology external-services repository replace-host -f <filename>.json -c <ssl certificate file>.pem`
    
    `tsm pending-changes apply`
    
    O arquivo `.json` é o arquivo de configuração que você criou na Etapa 2. O arquivo de certificado é o certificado SSL que você baixou da nova instância de banco de dados.
5. Restaure seus dados de armazenamento de arquivos restaurando o instantâneo de compartilhamento de rede para sua rede. As etapas específicas dependerão da sua rede.
    
    **Observação:** algumas tecnologias exigem que você crie um novo compartilhamento de rede ao fazer uma restauração. Se isso se aplicar ao armazenamento conectado à sua rede, você pode fazer sua restauração **antes** de interromper o Tableau Server. Se você estiver restaurando os dados do Armazenamento de arquivos para um novo compartilhamento de rede, você deve configurar o Tableau Server para usar o novo compartilhamento de rede. Para obter mais informações, consulte [Configurar o Tableau Server para usar um armazenamento externo diferente](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_reconfigure.htm#configure-new-storage).
6. Execute o seguinte comando para restaurar as chaves KMS e Ativo:
    
    `tsm maintenance snapshot-backup restore`
    
    **Observação:** se você estiver usando uma solução em nuvem para sua solução de chave de criptografia, certifique-se de que o servidor onde o backup está sendo restaurado tenha acesso de descriptografia para instância da nuvem onde o CMK é implantado.
7. Execute o seguinte comando para reiniciar o Tableau Server:
    
    `tsm start`

## Quem pode fazer isso

Os administradores do Tableau Server podem fazer backup e restaurar o Tableau Server. Além disso, você deve ter permissão para acessar e executar backups de instantâneos no armazenamento externo.

<!-- document id=4bcd327872fce7b2f42a19cca6555c7bc364b7701461f8e1a8db7cff15a1336c url=/tableau/current/pt-br/server/load_balancing_eq.md -->

[Pular para o conteúdo principal](#main-content)

# Balanceamento de carga de consulta de extração

Na versão 2020.2 do Tableau Server e posterior, o balanceamento de carga para consultas baseadas em extrações foi aprimorado e pode resultar em tempos de carga mais rápidos para painéis baseados em extração. Grandes implantações com muitas extrações e um alto volume de carregamentos de painel provavelmente verão a grande melhoria, especialmente se tiverem Hyper em execução em nós independentes. Implantações menores onde o Hyper está em execução em nós compartilhados com outros processos de servidor também podem ver melhorias no desempenho.

O hyper registra uma métrica de integridade do servidor sobre a quantidade de recursos que o Hyper está consumindo e também leva em conta a carga de outros processos do Tableau que podem estar sendo executados no mesmo nó do servidor. Com base nessas informações, as consultas de extração serão enviadas para um nó que tenha recursos disponíveis para processar a consulta. Além de avaliar os recursos do sistema, o balanceador de carga melhora a chance de que o nó para o qual você está é encaminhado tenha a extração já armazenada em cache. Isso reduz o número de extrações duplicadas entre os nós e melhora o uso de memória e I/O.

Para usar esse recurso, o Processo do servidor de cache deve estar ativo. Para obter mais informações, consulte [Servidor cache do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cache-server.htm). Se o Processo do servidor de cache não estiver ativado, o balanceamento de carga será automaticamente revertido para a funcionalidade anterior.

Esse recurso é ativado por padrão. Para desativá-lo, use os seguintes comandos tsm:

`tsm configuration set -k hyper_standalone.consistent_hashing.enabled -v false`

`tsm configuration set -k hyper_standalone.health.enabled -v false`

Aplique as alterações usando o seguinte comando tsm: `tsm pending-changes apply`

Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

<!-- document id=6ac6959c1dafd3b3a1129c28cc0fa320fb041ad71ba563d794cf00481c33a71a url=/tableau/current/pt-br/server/rmt-response-headers.md -->

[Pular para o conteúdo principal](#main-content)

# Cabeçalhos de resposta do Resource Monitoring Tool do Tableau (RMT)

Este artigo descreve como definir cabeçalhos de resposta personalizados do Resource Monitoring Tool do Tableau. Essa capacidade foi adicionada nas versões de manutenção de agosto de 2024 do RMT.

Quaisquer alterações nos cabeçalhos de resposta exigem uma reinicialização do RMT.

**Importante:** alterações nos cabeçalhos de resposta podem interromper o RMT. Se você fizer atualizações nos cabeçalhos, faça testes depois de fazer qualquer alteração para confirmar se o RMT está funcionando como deveria.

## Visualização e atualização de cabeçalhos de resposta personalizados

Você pode visualizar e alterar os cabeçalhos de resposta personalizados usando os comandos `rmtadmin get` e `rmtadmin set`.

### Obter uma lista de todos os cabeçalhos de resposta personalizados

Para visualizar uma lista de cabeçalhos de resposta personalizados definidos atualmente, execute este comando:

rmtadmin get server:web:responseheaders

Por exemplo:

\> rmtadmin get server:web:responseheaders
server:web:responseHeaders:Access-Control-Allow-Origin = \*
server:web:responseHeaders:Connection = Keep-Alive
server:web:responseHeaders:X-Frame-Options = DENY
server:web:responseHeaders:X-Cache-Info = not cacheable; meta data too large

### Obter o valor de um cabeçalho de resposta personalizado específico

Para obter um cabeçalho de resposta personalizado específico:

rmtadmin get server:web:responseheader:<some header>

Por exemplo:

\> rmtadmin get server:web:responseheader:X-Frame-Options
server:web:responseHeaders:X-Frame-Options = DENY

Se você tentar obter ou definir um cabeçalho de resposta personalizado inexistente, esse erro será exibido:

\> rmtadmin get server:web:responseheaders:<non-existent header>
\[ERR\] Config key not found. Key: server:web:responseHeaders:<non-existent header>

Você pode obter várias chaves. Todas as duplicatas são descartadas. As chaves inválidas serão listadas no final:

\> rmtadmin get server:web:responseheaders server:web:responseheaders:SomethingNew server:web:responseHeaders:Connection
server:web:responseHeaders:Access-Control-Allow-Origin = \*
server:web:responseHeaders:Connection = Keep-Alive
server:web:responseHeaders:X-Frame-Options = DENY
server:web:responseHeaders:X-Cache-Info = not cacheable; meta data too large
\[ERR\] Config key not found. Key: server:web:responseheaders:SomethingNew

### Definir ou atualizar um cabeçalho de resposta personalizado específico

Para definir ou alterar um cabeçalho de resposta personalizado específico:

rmtadmin set server:web:responseheader:<some header>

Por exemplo:

\> rmtadmin set server:web:responseheaders:X-Frame-Options = Allow
Config value set successfully. Key: server:web:responseHeaders:X-Frame-Options
server:web:responseHeaders:X-Frame-Options = Allow

Cabeçalhos são uma sequência do cabeçalho completo e quaisquer pares de chave-valor (se aplicável).

Por exemplo, isso define o tempo limite de manutenção ativa e os valores máximos:

rmtadmin set server:web:responseheader:connection "Keep-Alive: timeout=5, max=997"
Config value set successfully. Key: server:web:responseHeaders:Connection
server:web:responseHeaders:Connection = "Keep-Alive: timeout=5, max=997"

### Remover um cabeçalho de resposta personalizado

\> rmtadmin set server:web:responseheaders:X-Frame-Options --remove
Config value successfully removed. Key: server:web:responseHeaders:X-Frame-Options

#### Remover um valor de configuração comum

Não é possível remover um valor de configuração comum, você receberá um erro se tentar fazer isso:

\> rmtadmin set db:username --remove
\[ERR\] The --remove argument is not valid for this key. Key: db:username

#### Definir um valor de cabeçalho de resposta personalizado como um valor vazio

Com todas as chaves `rmtadmin set`, exceto o cabeçalho de resposta personalizado, você deve incluir um valor. Com cabeçalhos de resposta personalizados, você pode definir uma chave como sem valor. Este exemplo define a chave X-Frame-Options como um valor vazio:

\> rmtadmin set server:web:responseheaders:X-Frame-Options
Config value set successfully. Key: server:web:responseheaders:X-Frame-Options
server:web:responseheaders:X-Frame-Options =

Isso é diferente de remover o cabeçalho X-Frame-Options.

Por que você deveria fazer isso? O RMT gera alguns cabeçalhos de resposta personalizados por padrão e, se quiser impedir que o RMT inclua um cabeçalho, defina a chave como um valor vazio.

Por exemplo, por padrão, o RMT gera um cabeçalho de resposta com `X-Frame-Options = Deny`. É possível criar um cabeçalho de resposta personalizado para X-Frame-Options:

\> rmtadmin set server:web:responseheaders:X-Frame-Options ALLOW

Para voltar ao padrão, você pode removê-lo completamente ou defini-lo como DENY:

\> rmtadmin set server:web:responseheaders:X-Frame-Options --remove

Mas se você não quiser que o RMT envie alguma coisa, poderá definir o valor como um valor vazio:

\> rmtadmin set server:web:responseheaders:X-Frame-Options

## Cabeçalhos inválidos

O RMT permite que você defina cabeçalhos de resposta inválidos. Se o cabeçalho de resposta especificado não for válido, o RMT o avisará, mas permitirá que você defina o valor. É sua responsabilidade verificar se o RMT está funcionando corretamente após atualizar os cabeçalhos de resposta.

Não é possível definir “responseheaders”. Você só pode definir chaves filhas individuais no cabeçalho de resposta.

rmtadmin set server:web:responseheaders
\[ERR\] Key cannot be set: server:web:responseHeaders

> [!IMPORTANT]
> 
> **Importante:** Teste o RMT após fazer _quaisquer alterações_ nos cabeçalhos de resposta.

<!-- document id=2026d77b4e19dce6ef9b0d2f02a7475d051db81395b60e64a6e2c1605f6a744f url=/tableau/current/pt-br/server/security_http_headers.md -->

[Pular para o conteúdo principal](#main-content)

# Cabeçalhos de resposta HTTP

O Tableau Server suporta alguns dos cabeçalhos de resposta especificados no [OWASP Secure Headers Project](https://owasp.org/www-project-secure-headers/#div-headers).

Este tópico descreve como configurar os seguintes cabeçalhos de resposta para o Tableau Server:

- HTTP Strict Transport Security (HSTS)
- Referrer-Policy
- X-Content-Type-Options
- X-XSS-Protection

O Tableau Server também oferece suporte ao padrão da Política de segurança de conteúdo (CSP). A configuração da CSP não é abordada neste tópico. Consulte [Política de segurança de conteúdo](https://help.tableau.com/current/server/pt-br/security_csp.htm).

## Configuração dos cabeçalhos de resposta

Todos os cabeçalhos de resposta são configurados com o comando [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet).

Ao concluir a configuração dos cabeçalhos de resposta, execute [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#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).

## HTTP Strict Transport Security (HSTS)

O HSTS força a conexão dos clientes ao Tableau Server para se conectarem com HTTPS. Para obter mais informações, consulte a entrada da OWASP, [HTTP Strict Transport Security (HSTS)](https://owasp.org/www-project-secure-headers/#div-headers).

### Opções

gateway.http.hsts

Valor padrão: `false`

O cabeçalho do HTTP Strict Transport Security (HSTS) força os navegadores a usarem o HTTPS no domínio onde ele está habilitado.

gateway.http.hsts\_options

Valor padrão: `"max-age=31536000"`

Por padrão, a política do HSTS está definida para um ano (31536000 segundos). Este período especifica o tempo em que o navegador acessará o servidor por meio do HTTPS.

## Referrer-Policy

A partir da versão 2019.2, o Tableau Server inclui a capacidade de configurar o comportamento do cabeçalho HTTP Referrer-Policy. Essa política é habilitada com um comportamento padrão que incluirá a URL de origem de todas as conexões "seguras como" (política `no-referrer-when-downgrade`). Nas versões anteriores, o cabeçalho Referrer-Policy não foi incluído nas respostas enviadas pelo Tableau Server. Para obter mais informações sobre as várias opções de política compatíveis com o Referrer-Policy, consulte a entrada da OWASP, [Referrer-Policy](https://owasp.org/www-project-secure-headers/#div-headers).

### Opções

gateway.http.referrer\_policy\_enabled

Valor padrão: `true`

Para excluir o cabeçalho Referrer-Policy das respostas enviadas pelo Tableau Server, defina esse valor como `false`.

gateway.http.referrer\_policy

Valor padrão: `no-referrer-when-downgrade`

Esta opção define o referrer-policy para o Tableau Server. Você pode especificar qualquer uma das cadeias de caracteres de valor da política listadas na tabela [Referrer-Policy](https://owasp.org/www-project-secure-headers/#div-headers) na página da OWASP.

## X-Content-Type-Options

O cabeçalho de resposta X-Content-Type-Options do HTTP especifica que o tipo de MIME no cabeçalho Content-Type não deve ser alterado pelo navegador. Em alguns casos, onde o tipo de MIME não está especificado, o navegador pode tentar determiná-lo, avaliando as características da carga útil. O navegador exibirá o conteúdo em conformidade. Este processo é denominado "detecção". A interpretação errada do tipo de MIME pode levar à vulnerabilidades na segurança.

Para obter mais informações, consulte a entrada da OWASP, [X-Content-Type-Options](https://owasp.org/www-project-secure-headers/#div-headers).

### Opção

gateway.http.x\_content\_type\_nosniff

Valor padrão: `true`

Com essa opção, o cabeçalho X-Content-Type-Options do HTTP é definido, por padrão, como "não detecção".

## X-XSS-Protection

O cabeçalho de resposta HTTP X-XSS-Protection é enviado para o navegador para habilitar a proteção de scripts entre sites (XSS). O cabeçalho de resposta X-XSS-Protection substitui as configurações nos casos em que os usuários desabilitaram a proteção XSS no navegador.

Para obter mais informações, consulte a entrada da OWASP, [X-XSS-Protection](https://owasp.org/www-project-secure-headers/#div-headers).

### Opção

gateway.http.x\_xss\_protection

Valor padrão: `true`

Com essa opção, o cabeçalho de resposta X-XSS-Protection está habilitado por padrão.

## Outros artigos nesta seção

<!-- document id=9611dbb910b5b5534bfc983153777958fbd974372ac9dbeac0cb28555ca597c1 url=/tableau/current/pt-br/server/explain_data_lm_status.md -->

[Pular para o conteúdo principal](#main-content)

# Campos analisados em Explique os dados

O Explique os dados executa uma análise estatística em um painel ou planilha para localizar marcas discrepantes ou especificamente em uma marca selecionada. A análise também considera pontos de dados possivelmente relacionados da fonte de dados que não estão representados na exibição atual.

O Explique os dados pode não incluir todas as colunas da fonte de dados na análise. Em muitos casos, alguns tipos de campos serão automaticamente excluídos da análise. Para obter mais informações, consulte [Campos excluídos por padrão](#DefaultExcFields).

![Exiba campos analisados da exibição Explique os dados.](/tableau/current/pt-br/server/pt-br/Img/explaindata_viewfields.gif)

**Observação**: dimensões com mais de 500 valores exclusivos não serão consideradas para análise (a menos que permitido pelo autor em Configurações de Explique os dados).

Todos os usuários podem visualizar informações sobre quais campos estão incluídos ou excluídos na análise atual. Criators e Explorers com permissão de edição podem editar os campos usados pelo Explique os dados para análise estatística.

## Ver campos analisados por Explique os dados

Quando você expande uma explicação para uma medida que está contribuindo para o valor da marca, um link que indica o número de campos considerados na análise é exibido na parte inferior do painel Guia de dados.

![Detalhes do Explique os dados com um link para visualizar 14 dos 23 campos que são relevantes para o valor de soma mais alto.](/tableau/current/pt-br/server/pt-br/Img/explaindata_fieldslink.png)

Clique no link para ver a lista de campos incluídos ou excluídos da análise estatística atual.

Quando uma fonte de dados contém mais de 1.000 dimensões ou medidas não visualizadas, você pode ver um alerta perguntando se deseja que o Explique os dados considere mais campos. Clique em Explicar tudo para executar uma análise que inclua mais campos. A análise pode demorar mais para ser concluída.

#### Para visualizar os campos usados pelo Explique os dados para análise estatística

1. [Executar Explique os dados no painel, planilha ou marca](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm#RunExD).
2. No painel Guia de dados, em **Contribuindo com o valor de**, clique no nome de uma medida.  
      
    ![Detalhes do Explique os dados sobre uma marca analisada, com texto destacado que descreve um valor de soma de distância de viagem maior que o esperado de 8.800.](/tableau/current/pt-br/server/pt-br/Img/explaindata_viewfields1.png)
3. Clique no link _number-of-fields_ na parte inferior do painel.  
      
    ![Detalhes do Explique os dados sobre uma marca analisada, com o texto destacado dizendo "12 de 23 campos".](/tableau/current/pt-br/server/pt-br/Img/explaindata_viewfields2.png)

## Alterar campos usados para análise estatística

Creators e Explorers com permissões de edição podem selecionar campos a serem incluídos ou excluídos da análise estatística na guia Campos da caixa de diálogo Configurações de Explique os dados.

![Janela de Configurações de Explicar dados que fornece informações sobre as configurações de dados, incluindo campos e tipos de dados.](/tableau/current/pt-br/server/pt-br/Img/explaindata_settings.png)

Quando uma fonte de dados contém dimensões com um grande número de valores únicos (até 500), esses campos não serão considerados para análise.

#### Para editar o os campos usados pelo Explique os dados para análise estatística

As configurações dos campos analisados são aplicadas no nível da fonte de dados.

1. Execute Explique os dados em uma marca ao editar uma vista.
2. No painel Guia de dados, clique no ícone de configurações na parte inferior. Ou clique no botão Edit (Editar) na visualização Campos analisados ([como abrir campos analisados](#ViewAnalyzed)).  
      
    ![Botão Editar no painel Campos analisados.](/tableau/current/pt-br/server/pt-br/Img/explaindata_editfields.png)
3. Na caixa de diálogo Configurações de Explique os dados, clique na guia Campos.
4. Clique em uma seta suspensa ao lado do nome de um campo, selecione Automático ou Nunca incluir e clique em OK.  
      
    Observe que os campos devem ter menos de 500 valores exclusivos para serem incluídos na análise.  
      
    ![Janela de configurações do Explique os dados com uma medida selecionada e o menu suspenso expandido para revelar opções de inclusão ou exclusão do campo.](/tableau/current/pt-br/server/pt-br/Img/explaindata_excludefield.png)

## Campos excluídos por padrão

<table class="table--stripes" style="width: 100%; margin-left: 0; margin-right: auto;"><colgroup><col style="width: 45%;"><col style="width: 55%;"></colgroup><thead><tr><th>Campos excluídos por padrão</th><th>Razões para exclusão</th></tr></thead><tbody><tr><td><p>Todas as medidas não visualizadas quando existem mais de 1.000 medidas na fonte de dados.</p><p>Todas as dimensões não visualizadas quando existem mais de 1.000 dimensões na fonte de dados.</p></td><td><p>O cálculo de explicações para mais de 1.000 medidas ou dimensões não visualizadas pode levar mais tempo para ser realizado, às vezes vários minutos. Por padrão, estes campos são excluídos da análise inicial, mas você pode optar por incluí-los para uma análise posterior.</p><p>Nesta situação, você pode ver um alerta perguntando se deseja que o Explique os dados considere mais campos. Clique no link do alerta para obter mais informações. Clique em <span class="uicontrol">Explicar tudo</span> para executar uma análise que inclua mais campos.</p></td></tr><tr><td>Campos que usam geometria, latitude ou longitude</td><td>A geometria, latitude ou longitude em si não pode ser explicações. É altamente provável que quando a latitude ou a longitude for chamada como uma explicação, isso seja resultante de uma correlação falsa, e não uma possível explicação.</td></tr><tr><td>Dimensões com alta cardinalidade (dimensões com &gt; 500 membros)</td><td><p>As dimensões de cardinalidade levam mais tempo para serem calculadas. Dimensões com mais de 500 valores únicos não serão consideradas para análise.</p></td></tr><tr><td>Grupos, compartimentos ou conjuntos</td><td>Sem suporte no momento.</td></tr><tr><td>Cálculos de tabela</td><td>Os cálculos de tabela não podem ser analisados quando os cálculos da tabela estão em um nível de detalhe diferente da exibição.</td></tr><tr><td>Medidas não visualizadas que não podem ser calculadas como média</td><td>As medidas não visualizadas que não podem ser calculadas como média incluem aquelas que são campos calculados em que a expressão de cálculo inclui agregações (exibição como campos AGG(), quando adicionados à planilha).</td></tr><tr><td>Medidas discretas e dimensões contínuas</td><td>Sem suporte no momento.</td></tr><tr><td>Campos ocultos</td><td>Não disponível.</td></tr><tr><td>Campos calculados com erros</td><td>Não há valores presentes para analisar.</td></tr></tbody></table>

<!-- document id=f39d2efcb42d9c1660a68b2e19a5e5985ad7ece15af1b6205db03f156f1b07c5 url=/tableau/current/pt-br/server/tsm-jobs-cancel.md -->

[Pular para o conteúdo principal](#main-content)

# Cancelar trabalhos do TSM

Os trabalhos do TSM podem ser cancelados pela interface na Web do TSM ou pela CLI do TSM. Há muitos trabalhos do TSM, mas apenas alguns ser cancelados uma vez em andamento. Os trabalhos que ainda não foram inciados pode ser cancelado usando a CLI do TSM.

**Interface na Web do TSM**: em trabalhos que podem ser cancelados enquanto estão em execução, a opção Cancelar está disponível na caixa de diálogo Trabalho, conforme mostrado abaixo:

![Janela de confirmação Cancelar trabalho em execução.](/tableau/current/pt-br/server/pt-br/Img/tsm-job--confirm-cancel.png)

**TSM CLI:** para cancelar trabalhos usando a CLI do TSMI, consulte [tsm jobs](https://help.tableau.com/current/server/pt-br/cli_jobs_tsm.htm).

Para ver mais informações sobre os trabalhos do TSM em geral, consulte [Trabalhos do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/tsm-jobs.htm).

## Cancelar trabalhos em andamento

Apenas determinados trabalhos podem ser cancelados enquanto já estão em execução:Limpeza, Descomissionamento de Armazenamento de Arquivo, Gerar Backup, Reiniciar Servidor, Iniciar Servidor . O comportamento de cancelamento pode ser diferente dependendo do trabalho e do estado do trabalho no momento em que foi cancelado. Isso é explicado em detalhes abaixo:

- **Limpeza:** se você cancelar um trabalho de limpeza, ele vai interromper todos os serviços que iniciados para fazer a limpeza. Dependendo de quando foi cancelado, alguns arquivos podem ser excluídos e alguns podem ainda não ter sido excluídos, resultando em limpeza parcial.
- **Desativação do Armazenamento de arquivos:** se você cancelar esse trabalho, ele retornará a topologia do Armazenamento de arquivos do Tableau Server para o estado que estava antes de iniciar o processo de desativação.
- **Gerar backup:** se você cancelar esse trabalho, os serviços usados para backup serão interrompidos e o Tableau Server tentará excluir os arquivos que ele criou como parte do processo de backup.
- **Reiniciar o servidor**:
    - O trabalho é cancelado quando os processos do Tableau Server estão sendo interrompidos: o trabalho é cancelado, mas os serviços tentarão chegar a um estado interrompido.
    - O trabalho é cancelado enquanto os processos do Tableau Server estão sendo reiniciados: o trabalho é cancelado, mas os serviços tentarão reiniciar.
- **Iniciar o servidor**: o trabalho será cancelado, mas os processos ainda tentarão iniciar.
- **Interromper o servidor**: o trabalho será cancelado, mas os serviços tentarão parar.

Aqui estão algumas das principais razões pelas quais você pode querer cancelar um trabalho:

1. Uma vez que os trabalhos tsm só podem ser executados um de cada vez, você pode precisar cancelar um trabalho atual se precisar executar outro trabalho em vez disso.
2. Se o trabalho em execução incluir alterações no Tableau Server que você não pretendia fazer.

<!-- document id=afc32c43db15ed60a38e47ff47422ec0facbe8a23623f38619353c3f608176df url=/tableau/current/pt-br/server/cmt-use-cases.md -->

[Pular para o conteúdo principal](#main-content)

# Casos de uso do Content Migration Tool do Tableau

O Content Migration Tool do Tableau, como o nome sugere, é usado principalmente para migrar o conteúdo do Tableau Server de um site para outro. No entanto, existem muitos recursos na ferramenta que a tornam ideal para realizar várias tarefas relacionadas à migração e manutenção de conteúdo.

**Observação:** em muitos dos casos de uso, usamos o termo migração para descrever a movimentação de conteúdo de um ambiente, site ou projeto para outro. No entanto, tecnicamente o Content Migration Tool copia o conteúdo e não exclui nem arquiva automaticamente o conteúdo original ou de origem.

As informações abaixo descrevem alguns casos de uso comuns para utilizar o Content Migration Tool.

## Promoção de conteúdo

Você pode usar o Content Migration Tool para criar conteúdo em sites de desenvolvimento e fazer migrações rotineiras para promover o conteúdo em ambientes de preparo ou produção.

Siga estas etapas para promover conteúdo em ambientes de produção:

1. **Crie um plano** e selecione o site usado para desenvolvimento como origem e o site de preparo ou produção como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
    
    Quando você estiver migrando suas pastas de trabalho entre dois projetos no mesmo site, suas credenciais de entrada para a origem e o destino podem ser semelhantes ou idênticas. Nesse cenário, recomendamos o uso de tokens de acesso pessoal para uma conexão mais reutilizável. Para obter mais informações, consulte [Tokens de acesso pessoal](https://help.tableau.com/current/server/pt-br/security_personal_access_tokens.htm).
2. **Selecione o conteúdo** que você deseja migrar do site de origem. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário. Para obter mais informações, consulte Planejamento no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-2-planning).
3. Se você precisar fazer **alterações ou transformações** no conteúdo durante essa migração, também pode fazer essa configuração no plano. Isso é conhecido como **Mapeamento**. Os tipos de mapeamento que você pode fazer incluem:
    
    - **Alterações nas pastas de trabalho:** inclui renomear as pastas de trabalho e alterar o projeto de destino. Para obter uma lista completa de transformações da pasta de trabalho, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm).
        
        ![Um menu suspenso na janela Migração que lista opções para renomear pastas de trabalho, projetos, prefixos e sufixos.](/tableau/current/pt-br/server/pt-br/Img/cmt-workbook-mapping-options.png)
    - **Alterações nas fontes de dados:** inclui a substituição dos nomes de tabela ou esquema, configurações de fórmulas de cálculo e definição das informações de conexão. Para obter uma lista completa de transformações das fontes de dados, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm#step-3-workbook-transformations) (fontes de dados inseridas) e [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm#step-3-data-source-transformations) (fontes de dados publicadas).
        
        ![O menu suspenso Adicionar transformação para transformações de fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-mapping-options.png)
    - **Alterações nos usuários:** inclui alterações de domínio, usuário e nome de grupo no destino.
4. Quando estiver pronto, clique em **Executar a migração** para encerrar a fase de Planejamento e preparar-se para executar o plano.
5. **Para agendar** essa ação para ser executada regularmente, você pode [criar um script como trabalho](https://help.tableau.com/current/server/pt-br/cmt-scripting_migration_example.htm) usando o Executor do Content Migration Tool e agendá-lo. Para obter mais informações sobre como usar o Executor do Content Migration Tool, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).

## Personalização de conteúdo para clientes

Ao trabalhar em um cenário de consultoria, você pode personalizar o conteúdo para cada um dos clientes usando o Content Migration Tool. Cada pasta de trabalho funciona como modelo para o plano de migração, permitindo que você aplique estilo (texto, imagens, etc.) e substitua fontes de dados para clientes específicos.

**Siga estas etapas para personalizar o conteúdo para os clientes:**

1. **Crie um plano** e selecione o site de produção como origem e o site do cliente como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
2. **Na etapa Pastas de trabalho** do Plano de migração, use mapeamentos e transformações de pasta de trabalho para personalizar o conteúdo. Veja abaixo os dois exemplos de transformações utilizadas com frequência. Para obter uma lista completa de transformações da pasta de trabalho, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm).
    
    - Para personalizar o conteúdo, você pode usar as transformações Substituir imagem e Substituir texto para atualizar a pasta de trabalho com o nome e logotipo da empresa de um cliente.
    - Quando se trata de fontes de dados, você pode usar as transformações Substituir nome de tabela/esquema ou Definir SQL personalizado para modificar o conteúdo do cliente.
3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano.

## Migração de ambiente

Você pode usar o Content Migration Tool para migrar conteúdo entre os ambientes do Tableau Server.

Siga estas etapas para migrar conteúdo entre as implantações do Tableau:

1. **Crie um plano** e **selecione o site** em que deseja migrar como de origem. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
2. **Selecione o conteúdo** que você deseja migrar do site de origem. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário.
3. **Crie mapeamentos de permissões do usuário** para personalizar e proteger o conteúdo. Para obter mais informações, consulte [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm).
    
    ![Um menu com opções para planejar, mapear e executar uma migração, com mapeamento de usuários destacado.](/tableau/current/pt-br/server/pt-br/Img/cmt-user-mapping-options.png)
4. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano.

> [!TIP]
> 
> **Dicas**  
> \- Antes de realizar a migração de ambiente, entenda as [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm) ao usar o Content Migration Tool.  
> \- Você pode migrar o conteúdo em etapas, testar e validar o conteúdo iterativamente antes de concluir a migração final. Não há tempo de inatividade do servidor quando você usa esse método de migração. Pode ser uma substituição para importação/exportação do site.  
> \- A migração do Content Migration Tool não lida com credenciais inseridas, assinaturas e exibições personalizadas. Esses itens precisam ser migrados manualmente.

## Compartilhamento de conteúdo externo

Você pode usar o Content Migration Tool para compartilhar conteúdo interno com colaboradores externos, sem permitir o acesso ao site. Isso mantém os dados seguros e permite que você publique apenas as pastas de trabalho e fontes de dados selecionadas. Após compartilhar o conteúdo, os colaboradores entram no site do Tableau Server para exibir e fazer alterações, sem afetar o conteúdo armazenado no servidor interno.

Antes de continuar, verifique se o conteúdo que você está compartilhando é compatível entre os sites internos (origem) e externos (destino). O site externo deve estar executando a mesma versão do Tableau que o site interno ou posterior. Para obter mais informações sobre compatibilidade, consulte [Tornar as pastas de trabalho compatíveis entre as versões](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_compatibility.htm) na ajuda do Tableau Desktop.

**Siga estas etapas para compartilhar conteúdo externamente:**

1. **Trabalhe com** o administrador externo do site para determinar uma conta de usuário que tenha direitos de publicação no site. Você usará essa conta de usuário para criar o plano de migração. Para obter mais informações, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm) e [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).
2. **Prepare o conteúdo interno**. Como prática recomendada, é indicado separar o conteúdo no servidor interno para um projeto, com permissões bloqueadas e regras de governança rígidas. As pastas de trabalho e fontes de dados devem ser claramente rotuladas para indicar que o conteúdo é para uso externo. Para obter mais informações, consulte [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm).
    
    **Observação:** o conteúdo compartilhado com sites externos deve usar extrações de dados, a menos que a fonte de dados seja acessível publicamente. Para obter informações sobre a criação de extrações e a substituição de fontes de dados, consulte [Extrair os dados](https://help.tableau.com/current/pro/desktop/pt-br/extracting_data.htm) e [Substituir fontes de dados](https://help.tableau.com/current/pro/desktop/pt-br/connect_basic_replace.htm) na ajuda do Tableau Desktop.
    
    Se você implementou a segurança de nível de linha, essas fontes de dados devem ser atualizadas para refletir os filtros de usuário e outros detalhes do site externo. Para obter mais informações sobre a segurança de nível de linha, consulte [Restringir acesso no nível de linha dos dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters.htm) na ajuda do Tableau Desktop.
3. **Crie um plano** e selecione o site interno como origem e o site externo como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
4. **Selecione o conteúdo** que você deseja compartilhar com o site externo. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário.
5. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano.

## Validação de migrações de banco de dados

Este caso de uso é quando você pretende validar o conteúdo após uma migração dos bancos de dados subjacentes. Um exemplo de migração de banco de dados é a mudança do SQL Server para o Snowflake. O CMT pode ajudar você a validar se o conteúdo criado com base em ambas as fontes de dados é o mesmo antes de finalizar sua migração, mas não pode executar a migração real do banco de dados.

Siga estas etapas para validar as migrações de banco de dados:

1. **Crie um plano** e selecione o site do Tableau para usar como origem. Neste exemplo, descrevemos uma migração entre projetos no mesmo site do Tableau, portanto, selecione o mesmo site para seu destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
2. **Configure a migração** para copiar o conteúdo para um novo projeto. Vamos chamar o projeto de **origem** de **Projeto A** e o novo ou o projeto de **destino** de **Projeto B**.
    - Alterações em pastas de trabalho: crie um mapeamento de pasta de trabalho para alterar o Projeto A para o Projeto B. Para obter uma lista completa de transformações de pasta de trabalho, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm).
    - Alterações em fontes de dados: crie um mapeamento de fonte de dados para alterar o Projeto A para o Projeto B. Para obter uma lista completa de transformações de fontes de dados, consulte [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm).
3. **Verifique e execute** o plano. Quando estiver pronto, clique em **Executar a migração** para encerrar a fase de Planejamento e preparar-se para executar o plano.
4. **Atualize o conteúdo** no **Projeto B** com as novas conexões de banco de dados ou substitua as fontes de dados. Isso precisa ser feito manualmente por meio da criação.
5. **Teste cada pasta de trabalho** no **Projeto A** com a cópia no **Projeto B** e revise quanto a inconsistências nos dados em decorrência da alteração na fonte de dados.
6. Após confirmar que tudo está funcionando como esperado, **substitua o conteúdo** no Projeto A pelo o conteúdo atualizado no Projeto B.
    
    **Observação:** se o conteúdo já existir no projeto de destino e você não selecionar as opções de publicação Substituir pastas de trabalho mais recentes e Substituir fontes de dados mais recentes, o conteúdo não será copiado para o projeto de destino.

## Migração de conteúdo geográfico

Se você estiver mantendo um ambiente geograficamente distribuído de vários sites, você precisará que parte desse conteúdo seja compartilhada e acessada em todos os servidores. Este caso de uso descreve como migrar conteúdo entre servidores em diferentes regiões geográficas. O servidor pode estar no mesmo país ou em todos os continentes.

> [!TIP]
> 
> **Práticas recomendadas:**  
> \- Recomendamos priorizar o conteúdo que você mais precisa. O Content Migration Tool não deve ser usado para copiar ambientes de servidor inteiros para várias geografias.  
> \- Recomendamos migrar o conteúdo em uma direção, o que significa apenas Primário para Secundário. Neste caso, usamos o termo Primário para indicar o site de origem e Secundário para indicar o destino. Você pode ter um ou mais destinos criando vários planos de migração.

Siga estas etapas para migrar entre os Tableau Server distribuídos em diferentes regiões geográficas:

1. **Crie um plano** e selecione o site Primário como origem e o site Secundário como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
2. **Selecione o conteúdo** que você deseja compartilhar entre o Primário e o Secundário.
3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano.
4. **Para agendar** essa ação para ser executada regularmente, você pode [criar um script como trabalho](https://help.tableau.com/current/server/pt-br/cmt-scripting_migration_example.htm) usando o Executor do Content Migration Tool e agendá-lo. Para obter mais informações sobre como usar o Executor do Content Migration Tool, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).
5. **Revise o conteúdo** na origem **periodicamente** para determinar se novos itens devem ser adicionados ao plano de migração.

## Consolidar sites

Se você precisar combinar o conteúdo de vários sites em um único site (se, por exemplo, a reestruturação organizacional tiver mudado como os sites devem ser organizados), você poderá usar o Content Migration Tool para isso.

**Observação:** antes de consolidar sites, verifique se compreendeu as limitações ao migrar conteúdo usando o Content Migration Tool. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

Use as etapas a seguir para copiar todas as pastas de trabalho e fontes de dados de um site para outro:

1. Crie um plano e selecione o site em que deseja consolidar como origem. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
2. Na página Projetos de origem, selecione Todos os projetos e clique em Avançar.
    
    Se existir um projeto com o mesmo nome no site de destino, o conteúdo será migrado para a mesma pasta.
3. Na página Opções do projeto, selecione suas preferências para o site de destino e clique em Avançar.
    
    Se o conteúdo já existir no projeto de destino e você não selecionar a opção substituir, o conteúdo não será copiado para o projeto de destino.
4. Na tela Seleção de pasta de trabalho, selecione Todas as pastas de trabalho.
5. (Opcional) Se você estiver copiando fontes de dados publicadas:
    
    - No menu de navegação à esquerda, em Fontes de dados publicadas, clique em Seleção.
    - Selecione Todas as fontes de dados.
6. Clique em Executar migração e revise o plano de migração. Quando estiver satisfeito, clique em Executar na parte inferior da tela para executar a migração.

Repita essas etapas até que você tenha consolidado todos os sites. Para obter mais informações, consulte Planejamento no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-2-planning).

## Tarefas de manutenção

Você pode usar o Content Migration Tool para executar diversas tarefas de manutenção.

### Marcação de conteúdo obsoleto

Usando o Content Migration Tool, você pode gerenciar o conteúdo desatualizado para arquivamento. Por exemplo, construa um plano que seja executado em um cronograma regular que pode pegar automaticamente o conteúdo marcado como Conteúdo desatualizado e movê-lo para um Projeto de arquivamento. Depois de um certo período de tempo, as informações nesse projeto poderão ser eliminadas do sistema. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm).

### Restauração de conteúdo

Você pode usar o Content Migration Tool para restaurar o conteúdo removido (acidentalmente ou de propósito) do Tableau Server de produção com o conteúdo de um servidor de backup. O processo de restauração é simples e não requer tempo de inatividade, em comparação à restauração com um arquivo de backup.

Siga estas etapas para restaurar o conteúdo de um servidor de backup:

1. **Crie um plano** e selecione o Tableau Server de backup como origem e o servidor de produção como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
2. **Selecione o conteúdo** que você deseja restaurar do Tableau Server de backup.
3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano.
4. **Revise o conteúdo** no servidor de produção.

### Backup parcial

Depois de ter um ambiente de backup do Tableau Server, você pode usar o Content Migration Tool para transferir novo conteúdo da produção para o Tableau Server de backup. Se você não tiver configurado um ambiente do Tableau Server de backup, consulte o whitepaper [Recuperação de desastres do Tableau Server](https://www.tableau.com/learn/whitepapers/disaster-recovery-tableau-server) para obter mais informações

**Observações:**  
\- Antes de executar um backup parcial, certifique-se de entender as [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm) ao usar o Content Migration Tool. Você ainda pode precisar realizar periodicamente um backup completo e uma restauração para fazer backup de todo o conteúdo do Tableau Server. Para obter mais informações, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).  
\- O Content Migration Tool não deve ser usado para realizar seu primeiro backup.

Siga estas etapas para realizar um backup parcial do conteúdo:

1. **Crie um plano** e selecione o Tableau Server de backup como origem e o servidor de produção como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start).
2. **Selecione o conteúdo** em que você deseja fazer backup. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário. Para migrar apenas conteúdo novo, verifique se as opções de publicação Substituir pastas de trabalho mais recentes e Substituir fontes de dados mais recentes não foram selecionadas. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm).
3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano.
4. **Para agendar** essa ação para ser executada regularmente, você pode criar um script como trabalho usando o Executor do Content Migration Tool e agendá-lo. Para obter mais informações sobre como usar o Executor do Content Migration Tool, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).

<!-- document id=6ed82723d71a875058cc60049bca9a6c34913c1cbc47adbb7f12b4a6b364afd5 url=/tableau/current/pt-br/server/rmt-admin-wmi-classes.md -->

[Pular para o conteúdo principal](#main-content)

# Classes WMI

Os agentes do Resource Monitoring Tool do Tableau consultam várias classes WMI em intervalos regulares para monitorar vários aspectos do desempenho do servidor.

Abaixo está uma lista das classes WMI específicas que são consultadas.

| Classe | Categoria de monitoramento |
| --- | --- |
| `__InstanceCreationEvent` | Processos |
| `__InstanceDeletionEvent` | Processos |
| `Win32_LogicalDisk` | Disco |
| `Win32_NetworkAdapter` | Rede |
| `Win32_OperatingSystem` | Memória |
| `Win32_PerfFormattedData_Tcpip_NetworkInterface` | Rede |
| `win32_perfrawdata_perfdisk_physicaldisk` | Disco |
| `Win32_PerfRawData_PerfOS_Processor` | CPU |
| `Win32_PerfRawData_PerfProc_Process` | CPU |
| `Win32_PerfRawData_Tcpip_NetworkInterface` | Rede |
| `Win32_Process` | Processos |
| `Win32_Service` | Processos |

<!-- document id=a64667722e212d68eec1769990bf2286ff259d2676b7f4c3d2807a25fad94a3c url=/tableau/current/pt-br/server/server_clone.md -->

[Pular para o conteúdo principal](#main-content)

# Clone do Tableau Server

A partir da versão 2022.3 do Tableau Server, um novo comando tsm permite criar uma cópia da configuração e topologia de uma implantação do Tableau Server e usar isso para criar uma réplica exata da implantação original. O comando `tsm settings clone` cria um conjunto de arquivos (a "carga útil do clone") que inclui configurações, segredos, configuração e topologia, incluindo portas que estão sendo usadas e informações sobre serviços externos.

## Considerações de segurança

O comando `tsm settings clone` gera um conjunto de arquivos (a "carga útil do clone") que contém todos os segredos gerados por Tableau Server, bem como aqueles fornecidos pelo administrador do servidor durante a configuração, incluindo um keystore contendo pares de chaves e certificados. É extremamente importante para a segurança que você mantenha a carga útil do clone e o local de saída seguros. Para facilitar isso:

- Se o diretório de saída não existir, o tsm o criará com acesso restrito ao usuário que está executando o comando `tsm settings clone`.
- Se o diretório de saída existir quando você executar o comando, o tsm confirmará que ele pertence ao usuário que está executando o comando e que as permissões são limitadas apenas a esse usuário. Se o diretório não tiver as permissões esperadas, uma mensagem será exibida:
    
    The output directory '<path/to/directory>' exists, but must be restricted to owner only.

## Limitações da carga útil do clone

- A versão do Tableau Server sendo clonado deve corresponder à versão que está sendo criada. Você não pode instalar uma versão mais recente do Server usando uma carga útil de clone de uma versão mais antiga.

## Usando o comando clone para criar uma cópia do Tableau Server

Criando uma cópia clonada do Tableau Server é um processo de várias etapas, com as duas etapas de alto nível sendo:

1. Crie uma carga útil de clone da instalação do Tableau Server que deseja duplicar.
2. Use a carga útil do clone para instalar uma segunda implantação de Tableau Server. Você é responsável por corresponder a topologia das duas instalações, adicionando nós adicionais para corresponder à implantação original.

### Criando a carga útil do clone

Para gerar um conjunto de arquivos (carga útil do clone) que contém as configurações e configurações de topologia para Tableau Server , use o comando `[tsm settings clone](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm#TSMSettingsClone)`. O comando recebe um único argumento, o diretório de saída onde o conjunto de arquivos deve ser salvo:

tsm settings clone --output-directory <output\_directory>

Depois que a carga útil do clone for criada, você poderá usá-la ao instalar uma nova instância do Tableau Server com a configuração e topologia idênticas da instalação de origem.

### Usando a carga útil do clone para criar uma cópia do Tableau Server

Ao instalar o Tableau Server no Windows, o administrador do servidor deve seguir as seguintes etapas:

1. Defina a variável de ambiente `CLONE_ARTIFACT_DIR` para apontar para o local da carga útil do clone.
2. Execute o programa de instalação do Tableau Server como Administrador.
    
    Não inicialize o Tableau Server se sua topologia incluir nós adicionais. Você precisa adicionar esses nós antes de concluir o processo de inicialização do Tableau Server.
3. Opcional: adicione nós de trabalho
    
    Depois que o TSM for inicializado (mas antes de inicializar o Tableau Server), o administrador deverá adicionar nós adicionais se a topologia original tiver mais de um nó.
    
    Isso deve ser feito seguindo o processo padrão para adicionar novos nós, ou seja, gerar um arquivo bootstrap e executar o script initialize-tsm nos nós do trabalhador que fornecem o arquivo bootstrap.
    
    Para obter detalhes, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).
4. Inicialize o Tableau Server usando a interface da Web do TSM ou a interface de linha de comando:
    
    `tsm initialize`
5. Aguarde a inicialização do Tableau Server em todos os nós.

<!-- document id=6f339c3654acc525b6d42d6f647f34f1035eba48ef0c84ddb8544baa50aca05c url=/tableau/current/pt-br/server/rmt-admin-encrypted-data-collection.md -->

[Pular para o conteúdo principal](#main-content)

# Coleta de dados criptografados

Para garantir que a coleta de dados do Tableau Server para Resource Monitoring Tool do Tableau seja criptografada, as comunicações entre o servidor RMT e os agentes e as conexões com o repositório do Tableau Server precisam ser habilitadas para usar mensagens criptografadas.

## Para versões 2022.3 e posteriores

- Se o RabbitMQ estiver instalado na mesma máquina que o RMT Server (configuração local), o Resource Monitoring Tool do Tableau tem comunicações criptografadas integradas entre o RMT Server e os agentes. Não há necessidade de configuração para criptografia entre o RabbitMQ e o RMT Server.
- Se o RabbitMQ estiver hospedado externamente ao RMT Server (configuração externa), você deverá seguir as mesmas etapas descritas na seção [Para versões 2022.2 e anteriores](#For) deste tópico

Você ainda precisa habilitar e configurar [comunicações criptografadas com o banco de dados do repositório do Tableau Server](#Tableau) em ambos os casos mencionados acima.

## Configuração SSL do repositório do Tableau

1. Certifique-se de que o Tableau Server esteja configurado para usar conexões SSL para conexões Postgres internas. Para obter mais informações, consulte [Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm). O Resource Monitoring Tool permite que você use o arquivo de certificado ou a impressão digital para as conexões SSL. Se você planeja usar o arquivo de certificado, copie o arquivo de certificado gerado pelo Tableau Server para conexões SSL Postgres internas para a máquina onde você planeja instalar o Servidor RMT. Para obter mais informações, consulte [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm).
2. Na interface da Web do Servidor RMT, nos menus do Administrador, selecione Ambientes. Clique no ícone de edição de ambiente.
    
    Na seção Tableau Repository Configuration:
    
    1. Na caixa suspensa SSL Mode, selecione Prefer SSL ou Require SSL para configurar as conexões SSL no Repositório do Tableau. Escolher Disable significa que o SSL nunca será usado para fazer conexões do repositório do Tableau Server.
        
        No modo Prefer SSL, o Resource Monitoring Toolusará SSL na primeira tentativa, e se isso falhar, posteriormente tentará uma conexão não criptografada.
        
        No modo Require SSL, se a conexão SSL falhar, as conexões com o repositório do Tableau Server falharão completamente. Neste caso, as conexões de API REST do Tableau Server serão usadas para se comunicar com o Tableau Server.
    2. Você pode optar por fornecer a impressão digital gerada pelo Tableau Server ou copiar o arquivo **server.crt** para a máquina do Servidor Resource Monitoring Tool primário. Se você optar por copiar o arquivo de certificado, não precisará fornecer a impressão digital. Para obter mais informações, consulte [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm).

## Para versões 2022.2 e anteriores

A comunicação criptografada entre os Agentes e o Servidor RMT é possível executando o seguinte:

- [Configuração do RabbitMQ com certificados SSL/TLS.](#RabbitMQ)
- [Configuração do Servidor RMT e os agentes para habilitar mensagens criptografadas.](#Setup)
- [Configuração de conexões criptografadas no repositório do Tableau.](#Tableau).

## Configuração do RabbitMQ

Para obter detalhes sobre a instalação do servidor RabbitMQ, consulte a documentação do RabbitMQ para a [Instalação do TLS](https://www.rabbitmq.com/ssl.html).

## Instalação do Resource Monitoring Tool do Tableau

Depois que o RabbitMQ foi configurado para TLS, todos os aplicativos cliente: o Servidor RMT e todos os agentes do Resource Monitoring Tool do Tableau precisarão ser configurados para habilitar as mensagens criptografadas. Faça o seguinte na interface da Web do Servidor RMT:

1. Na máquina onde o Servidor RMT está instalado, acesse: _http://<hostname>/setup/server_.
2. Na seção Fila de mensagens, marque a caixa de seleção Habilitar TLS e forneça o Nome do host do certificado.
3. Atualizar as informações da porta, se necessário.

Ao configurar o Servidor RMT e agente para mensagens criptografadas:

- Os sinalizadores `enabled` e `certificateHostName` devem ser configurados para habilitar a criptografia.
- A variável `certificateHostName` deve corresponder ao nome canônico (CN=) no certificado do servidor ou a conexão falhará.
- O número da `port` precisará ser alterada com base na porta TLS configurada como RabbitMQ.

**Observação:** se os Agentes já estavam registrados antes da configuração do SSL, então você deve recadastrar o agente. Para fazer isso, baixe o novo arquivo bootstrap e registre o Agente usando o novo arquivo bootstrap. Para obter mais informações sobre o novo registro do Agente, consulte [Novo registro de um Agente](https://help.tableau.com/current/server/pt-br/rmt-tableau-server-topology-changes.htm#reregister-agent).

## Quem pode fazer isso

Para configurar a coleta de dados criptografados, você deve ser um administrador do Tableau Server e do Resource Monitoring Tool.

<!-- document id=f9c3075bb9d6aef3db953620c7b5d1ff343b826f83ab6d69de511f7b51e3cbef url=/tableau/current/pt-br/server/perf_collect_perfmon.md -->

[Pular para o conteúdo principal](#main-content)

# Coletar dados com o Monitor de Desempenho do Windows

Para monitorar o uso do recurso e os processos do servidor, você pode usar o Monitor de Desempenho do Windows (PerfMon), que está incluído no Windows Server. Use o PerfMon para coletar informações detalhadas sobre o desempenho, incluindo a frequência de uso da CPU, a quantidade de memória usada, as informações sobre cada processo do Tableau Server, e assim por diante.

Para obter informações sobre a função de cada processo do Tableau Server, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

**Isenção de responsabilidade**: estas informações se referem a um produto de terceiros. Este exemplo não é um endosso deste produto em relação a qualquer outro produto da concorrência.

Antes de usar o PerfMon, configure um conjunto de coletores de dados, o modo pelo qual o PerfMon armazena os dados que coleta. Para coletar informações sobre os processos do Tableau Server com PerfMon, o Tableau Server deve estar em execução quando você criar o conjunto de coletores de dados. Os dados que você coleta no PerfMon são frequentemente referidos como contadores de desempenho.

## Como coletar dados com o Monitor de desempenho do Windows

### Etapa 1: criar um novo conjunto de coletor de dados

1. Clique no menu Iniciar do Windows e pesquise "desempenho".
2. Clique com o botão direito do mouse em **Monitor de Desempenho** e, em seguida, em **Executar como administrador**.
3. No painel esquerdo, clique em **Conjuntos de Coletores de Dados**.
4. No painel direito, clique com o botão direito do mouse em **Definido pelo Usuário**, clique em Novo e, em seguida, em **Conjunto de Coletores de Dados**.
5. No assistente **Criar Novo Conjunto de Coletores de Dados**, insira um nome para o conjunto de coletores de dados. Por exemplo, você pode inserir **Desempenho do Tableau Server**.
6. Selecione **Criar Manualmente (Avançado)** e, em seguida, em **Avançar**.
7. Em **Criar Logs de Dados**, selecione **Contadores de Desempenho** e clique em **Avançar**.

### Etapa 2: selecionar contadores de desempenho

1. Defina o intervalo de amostra para 30 segundos.
2. Clique em **Adicionar**.
3. Selecione o computador ao qual deseja registrar os dados de desempenho.
    
    Se você executa o Tableau Server em um único computador, selecione **<Computador Local>**. Se você executa o Tableau Server em vários computadores, deve repetir algumas dessas etapas para coletar os dados sobre cada computador.
4. Selecione os contadores de desempenho da lista.
    
    A tabela a seguir lista alguns contadores de desempenho que recomendamos para rastrear o desempenho do Tableau Server.
    
    <table class="simple-table"><colgroup><col class="col-20pc"><col class="col-20pc"><col></colgroup><thead><tr><th>Categoria</th><th>Contadores de desempenho</th><th>Observações</th></tr></thead><tbody><tr><td><p>Disco lógico</p></td><td><p>Tamanho da fila do disco atual</p><p>Bytes de leitura em disco por seg.</p><p>Bytes de gravação em disco por seg.</p></td><td><p>O número das solicitações de gravação pendentes e a quantidade de bytes lidos e gravados à unidade de disco rígido do servidor. Selecione esses contadores para o disco no qual você instalou o Tableau Server (denominado <em>instância</em> no PerfMon).</p></td></tr><tr><td>Memória</td><td><p>% de bytes comprometidos em uso</p><p>MBytes disponíveis</p></td><td>A porcentagem de memória virtual em uso e a quantidade de memória disponível em megabytes.</td></tr><tr><td>Informações do processador</td><td><p>% de tempo do processador</p><p>% do utilitário do processador</p></td><td>A porcentagem de tempo que o processador está ativo e a porcentagem da capacidade de processamento sendo usada pelo processador.</td></tr><tr><td><p>Processo</p></td><td><p>% de tempo do processador</p><p>Bytes privados</p></td><td><p>A porcentagem da capacidade de processamento sendo usada por um determinado processo, e a quantidade de memória reservada para o processo. Selecione esses dois contadores para os processos a seguir (denominados <i>instâncias</i> no PerfMon):</p><ul><li><code>run-backgrounder</code> (Processador em segundo plano)</li><li><code>run-dataserver</code> (Servidor de dados)</li><li><code>redis-server</code> (Servidor de cache)</li><li><code>hyperd</code> (Processador de dados)</li><li><code>run-vizqlserver</code> (VizQL Server)</li></ul></td></tr></tbody></table>
    
    Para selecionar cada contador de desempenho:
    
    1. Clique duas vezes para selecionar uma categoria na lista suspensa.
    2. Selecione o contador ou contadores de desempenho que deseja usar.
    3. Em Instâncias do objeto selecionado, se apropriado, selecione o processo (ou instância) sobre o qual deseja coletar as informações.
        
        ![Uma caixa de diálogo que lista contadores disponíveis e adicionados.](/tableau/current/pt-br/server/pt-br/Img/everybody_perfmon_add_counters.png)
    4. Clique em **Adicionar**.
    5. Se você executa o Tableau Server em vários computadores, volte à etapa 3, selecione outro computador e, em seguida, repita as etapas acima.
        
        **Importante:** dependendo de como você configurou os processos do servidor para execução entre os computadores, deve monitorar somente um subconjunto de processos listados para cada computador. Por exemplo, é uma prática recomendada isolar os processos do processador em segundo plano em um computador separado. Como resultado, para aquele computador, você apenas monitoraria os processos do processador em segundo plano.
    6. Clique em **OK** e, em seguida, em **Avançar**.

### Etapa 3: Salvar o conjunto de coletores de dados

1. Navegue para o diretório no qual você deseja armazenar os dados e clique em **Avançar**.
    
    **Importante:** deve-se armazenar os dados em um local acessível pelo Tableau. Por exemplo, você pode desejar armazenar os dados em uma unidade de rede. Se não tiver uma unidade de rede mapeada, clique com o botão direito em **Este PC** e selecione **Adicionar um local de rede**.
2. Clique em **Concluir**.
3. No painel esquerdo da janela principal **Monitor de desempenho**, selecione o conjunto do coletor de dados criado.
4. No painel direito, clique com o botão direito do mouse no contador de desempenho **DataCollector01** e clique em **Propriedades**.
5. Selecione **Separado por vírgula** como o formato de registro e, em seguida, clique em **OK**.

### Etapa 4: Executar o conjunto dos coletores de dados

No painel esquerdo, clique com o botão direito no nome do conjunto do coletor de dados que você criou e clique em **Iniciar**. A ferramenta de Monitor de Desempenho do Windows começa a monitorar o seus servidor e a armazenar as informações no local especificado.

### Etapa 5: permitir acesso remoto para vários computadores

Para que o PerfMon colete dados sobre outros computadores, você precisa certificar-se de que eles possam ser acessados — ou seja, de que estejam na mesma rede e não tenham regras de firewall evitando o acesso. As regras de firewall que você precisa definir diferem de acordo com as versões do Windows, então você pode precisar entrar em contato com o seu administrador de rede para obter informações. Além disso, você deve certificar-se de que uma conta de usuário Run As tenha permissão para coletar os dados nos computadores remotos. Como padrão, o PerfMon executa o conjunto de coletor de dados como o usuário SYSTEM. Para alterar o usuário Run As, conclua as seguintes etapas:

1. No painel esquerdo do PerfMon, abra o nó Conjuntos do Coletor de Dados e, em seguida, o nó **Definido pelo Usuário**.
2. Clique com o botão direito do mouse no nome do conjunto do coletor de dados e, em seguida, clique em Propriedades.
3. Na seção **Run As** da guia **Geral**, clique no botão **Alterar** e especifique uma conta diferente.

<!-- document id=c0945d86743ad261e9d9379bebba05ee117170a42c4e2ae4ac28b901566bd012 url=/tableau/current/pt-br/server/perf_collect_server_repo.md -->

[Pular para o conteúdo principal](#main-content)

# Coletar dados com o repositório do Tableau Server

O repositório do Tableau Server é um banco de dados do PostgreSQL que armazena os dados sobre todas as interações do usuário, atualizações de extração e muito mais. É possível habilitar o acesso ao repositório e usar os dados nele para ajudar a analisar e entender o desempenho do Tableau Server.

**Importante:** não modifique diretamente o repositório. Isso pode interromper o Tableau Server. Qualquer modificação do repositório feita pelo cliente tornará sua instalação incompatível com o Tableau.

Procurando o Tableau Server no Linux? Consulte [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server-linux/pt-br/perf_collect_server_repo.htm)

Após conceder acesso ao repositório do Tableau Server, será possível criar exibições com os dados do repositório. As exibições criadas com esses dados são, às vezes, chamadas de exibições administrativas. Além de serem usadas para o monitoramento do desempenho, as exibições administrativas personalizadas podem ser usadas para rastrear a atividade do usuário, da pasta de trabalho e muito mais. Para obter mais informações sobre o tipo de dados que podem ser usados para essas exibições, consulte [Criar exibições administrativas personalizadas](https://help.tableau.com/current/server/pt-br/adminview_postgres.htm) e [Sobre o dicionário de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_dictionary.htm). Como alternativa, se estiver interessado somente nos dados de desempenho, poderá usar as tabelas de banco de dados pré-selecionadas na pasta de trabalho de desempenho de exemplo.

## Habilitar o acesso ao repositório do Tableau Server

Use o Tableau Desktop para conectar-se e consultar o repositório do Tableau Server usando dois usuários internos. O usuário denominado `tableau` tem acesso a várias exibições do banco de dados, que podem ser usadas como parte da criação de suas próprias análises da atividade do Tableau Server. O usuário denominado `readonly` tem acesso a tabelas adicionais do banco de dados, que podem ser usadas para criar exibições e assim gerar análises ainda mais detalhadas, e esse é o usuário que recomendamos que você use.

Antes que uma conexão com o repositório seja possível, é necessário habilitar o acesso do usuário `readonly` ao banco de dados. Use o comando `tsm data-access repository-access enable` para habilitar o acesso ao repositório. Ao habilitar o acesso ao repositório, você também cria uma senha para o usuário `readonly`. Você usará essa senha para acessar o repositório. Além disso, pode ser necessário ter a porta 8060 aberta no nó do repositório para que possa se conectar ao banco de dados.

1. Verifique se a porta 8060 está aberta no computador em que o repositório está instalado. Isso é necessário se você estiver se conectando remotamente.
2. Habilite o acesso ao repositório e crie uma senha para o usuário readonly:
    
    `tsm data-access repository-access enable --repository-username readonly --repository-password <PASSWORD>`
    
    Se sua senha incluir caracteres especiais, coloque-a entre aspas.
    
    Este comando reiniciará o Tableau Server.
    
    **Observação:** se posteriormente desejar desabilitar o acesso remoto ao repositório do Tableau Server, use o comando `tsm data-access repository-access disable`. O comando desabilita o acesso externo ao repositório. Isso não desabilitará o acesso do host local. Para obter mais informações, consulte [tsm data-access repository-access disable](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#repository-access-disable).

## Conectar-se ao repositório do Tableau Server

Esta seção descreve como se conectar a um conjunto personalizado de tabelas no repositório do Tableau Server. Para obter mais informações sobre as tabelas as quais é possível se conectar, consulte [Sobre o dicionário de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_dictionary.htm).

1. No Tableau Desktop, selecione Dados > Conectar a dados e selecione PostgreSQL como o banco de dados ao qual se conectar.
    
    **Observação**: talvez seja preciso instalar os drivers de banco de dados PostgreSQL. Faça download dos drivers em [www.tableau.com/pt-br/support/drivers](http://www.tableau.com/pt-br/support/drivers).
2. Na caixa de diálogo de conexão do PostgreSQL, insira o nome ou a URL para o Tableau Server na caixa de diálogo Servidor. Caso tenha uma instalação de servidor distribuída, insira o nome ou o endereço IP do nó em que o repositório está hospedado.
    
    Conecte-se usando a porta configurada para o pgsql.port, que é 8060, por padrão.
3. Especifique `workgroup` como o banco de dados ao qual se conectar.
4. Conecte-se usando o usuário e a senha especificados.
5. Clique na opção **Exigir SSL** se você tiver configurado o Tableau Server para usar SSL para se conectar ao repositório. Para obter mais informações, consulte [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm).
6. Clique em Conectar.
    
    ![Uma tela de login do PostgreSQL com campos para servidor, porta, banco de dados, nome de usuário e senha.](/tableau/current/pt-br/server/pt-br/Img/postgres_connection.png)
7. Selecione uma ou mais tabelas para conectar.
    
    O usuário do `tableau` tem acesso a todas as tabelas que começam com um sublinhado ou com `hist_`. Por exemplo, é possível se conectar a `_background_tasks` e `_datasources`. As tabelas `hist_` contêm informações sobre os usuários do servidor que não estão apresentadas atualmente na exibição [Ações por usuário específico](https://help.tableau.com/current/server/pt-br/adminview_user.htm). O usuário `readonly` tem acesso a tabelas adicionais que podem ser usadas para consultar outras informações sobre a utilização do servidor.
    
    ![Uma união de colunas de duas fontes de dados: tipos de eventos históricos e eventos históricos.](/tableau/current/pt-br/server/pt-br/Img/adminview_custom2.png)
8. Clique em Acessar planilha.

## Versão PostgreSQL

Use as etapas a seguir para encontrar a versão do PostgreSQL usada pelo Tableau Server:

1. Faça logon no Tableau Server diretamente ou por meio de uma conexão remota.
2. Iniciar o **Gerenciador de tarefas**.
3. Clique na guia **Detalhes**.
4. Clique com o botão direito do mouse em um dos processos postgres.exe e selecione **Propriedades** para ver a versão do PostgreSQL instalada.

Você também pode se conectar ao banco de dados do grupo de trabalho e emitir a seguinte consulta para obter a versão: `select version()`

## Outros artigos nesta seção

<!-- document id=d2ae8ad84dcb5940b1d949f03462f3430e52fcd35d006de18c30cd886cc69044 url=/tableau/current/pt-br/server/tabadmin_cmd.md -->

[Pular para o conteúdo principal](#main-content)

# tabadmin

A partir da versão 2018.2, o Tableau Server no Windows usa o Tableau Services Manager (TSM). O TSM substitui o utilitário de comando legado tabadmin e a ferramenta de configuração do Tableau Server. Se você tiver instalado ou atualizado para o Tableau Server no Windows 2018.2 ou posterior, precisará usar o TSM para configurar e gerenciar o Tableau Server. Para obter mais informações sobre o TSM, consulte [Migrar do Tabadmin para a CLI do TSM](https://help.tableau.com/v2021.4/server/pt-br/tabadmin_to_tsm_cli.htm).

<!-- document id=1d3ce988db1698425ac479170b0bd30bdd024af23bf7b5e130dc48c23eef6e36 url=/tableau/current/pt-br/server/tabcmd_cmd.md -->

[Pular para o conteúdo principal](#main-content)

# Comandos tabcmd

**Observação:** O utilitário de linha de comando tabcmd versão 2.0 está disponível em [Tabcmd do Tableau](https://tableau.github.io/tabcmd). Essa nova versão permite executar comandos tabcmd no MacOS e Linux e autenticar usando tokens de acesso pessoal (PATs). A versão 2.0 é baseada em endpoints públicos disponíveis no Tableau Server Client (TSC) baseado em Python. Essa versão mais recente tem suporte limitado ao Tableau Server.

Procurando o Tableau Server no Linux? Consulte [Comandos tabcmd](https://help.tableau.com/current/server-linux/pt-br/tabcmd_cmd.htm "Abre o tópico em uma nova guia do navegador").

Você pode usar os seguintes comandos com a ferramenta de linha de comando tabcmd:

[addusers](#id1999d76f-638e-47d4-86ac-fe8e206ed364) (para um grupo)  
[createextracts](#id5a3316ed-45bb-4da4-b557-1111112d4ac8)  
[creategroup](#idbfa546df-2be7-444f-8bb8-07978b127783)  
[createproject](#id5a3316ed-45bb-4da4-b557-58492b2d4ac8)  
[createsite](#id6f434e96-89d1-4aa2-a935-4c22fa1e2506)  
[createsiteusers](#idd1b7729f-dd20-475a-96f6-17fcd2577894)  
[createusers](#ide42a948a-cd9c-4b73-9ef2-3a58eda2d095)  
[decryptextracts](#decryptextracts_tabcmd)  
[delete _workbook-name_ ou _datasource-name_](#idfdf59712-84ed-4590-9471-541d316917a6)  
[deleteextracts](#id5a3316ed-45bb-4da4-b557-2222222d4ac8)  
[deletegroup](#id0d009916-bee3-4ef0-a6ac-22188c0e7f30)  
[deleteproject](#idfdf59712-84ed-4590-9471-541d316917a6)  
[deletesite](#id54a7f404-5d1b-452e-8273-0ab8396da641)  
[deletesiteusers](#deletesiteusers)  
[deleteusers](#id6a8ef3d6-d17b-4c31-be47-7b09437eeec0)  
[editdomain](#editdomain)  
[editsite](#id06d8e2e0-d7a1-4733-b0df-d1e02f66919b)  
[encryptextracts](#encryptextracts_tabcmd)  
[export](#id7cb8d032-a4ff-43da-9990-15bdfe64bcd0)  
[get _url_](#id7e0a0627-ad89-4135-a1c2-85b1d8472568)  
[initialuser](#initialuser)  
[listdomains](#listdomains)  
[listsites](#idc7467cb6-6cef-49bf-9358-a3e4addd5fa0)  
[logon](#id5fba51c9-5608-4520-8ceb-2caf4846a2be)  
[logout](#id8f512aec-57a4-4ed4-94c4-86e91ea9cc9c)  
[publish](#iddf805b62-18ff-4497-9245-adc6905b2084)  
[publishsamples](#publishsamples)  
[reencryptextracts](#reencryptextracts_tabcmd)  
[refreshextracts](#id4cdb3410-1c41-4dad-b1d2-306542ac9b32)  
[removeusers](#id5cc30cba-44b8-48b0-93d6-5707938d157a)  
[reset\_openid\_sub](#reset_sub)  
[runschedule](#idd9d99c44-c9be-4191-9191-402341775a3d)  
[set](#idfe12acaf-ed64-4f0c-8eb8-b83c9de12382)  
[syncgroup](#ide6a39f29-77ff-44f6-b946-c2b56b31a2f9)  
[upgradethumbnails](#upgradethumbnails)  
[validateidpmetadata](#validateidp)  
[version](#id825f5d18-529c-408a-b876-57693195bbdd)

## addusers _group-name_

Adiciona usuários ao grupo especificado.

**Exemplo**

`tabcmd addusers "Development" --users "users.csv"`

### Opções

`--users`

Adiciona os usuários do arquivo `.csv` conhecido ao grupo especificado. O arquivo deve ser uma lista simples com um nome de usuário por linha. Os nomes de usuário não diferenciam letras maiúsculas de minúsculas. Os usuários já devem ter sido criados no Tableau Server.

Se usar esse comando em arquivos`.csv` grandes no Tableau Server, um administrador de servidor pode habilitar configurações que ajudem a melhorar o desempenho.

Para obter mais informações, consulte [Diretrizes do arquivo de importação CSV](https://help.tableau.com/current/server/pt-br/csvguidelines.htm).

`--[no-]complete`

Quando definida como `complete`, essa opção exige que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Se não especificada, `--complete` será usada.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createextracts

Cria extrações para uma pasta de trabalho ou fonte de dados publicada.

### Opções

`-d`, `--datasource`

O nome da fonte de dados de destino para a criação de extração.

`--embedded-datasources`

Uma lista de nomes das fontes de dados inseridas separadas por espaço na pasta de trabalho destino. Coloque nomes de fontes de dados entre aspas duplas se contiverem espaços. Disponível somente ao criar extrações para uma pasta de trabalho.

`--encrypt`

Criar extração criptografada.

`--include-all`

Inclua todas as fontes de dados inseridas na pasta de trabalho de destino. Disponível somente ao criar extrações para a pasta de trabalho.

`--parent-project-path`

Caminho do projeto principal que contém o recurso de destino. Deve especificar o nome do projeto com --projeto.

`--project`

O nome do projeto que contém o recurso de destino. Necessário somente se a - pasta de trabalho ou - fonte de dados for especificada. Se não especificado, o projeto padrão 'Default' será usado.

`-u`, `-url`

O nome canônico do recurso conforme ele aparece na URL.

`-w`, `-workbook`

O nome da pasta de trabalho de destino para a criação de extração.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## creategroup _group-name_

Cria um grupo. Use `addusers` (para grupos locais) para adicionar usuários após a criação do grupo. Usar`syncgroup` (para grupos do Active Directory) para criar e sincronizar um grupo do Tableau Server com um grupo do Active Directory.

**Exemplo**

`tabcmd creategroup "Development"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createproject _project-name_

Cria um projeto.

**Exemplo**

`tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."`

### Opções

`-n`, `--name`

Especifica o nome do projeto que você deseja criar.

`--parent-project-path`

Especifica o nome do projeto principal para o projeto aninhado, como indicado na opção `-n`. Por exemplo, para especificar um projeto denominado "aninhado" que existe em um projeto "Principal", use a seguinte sintaxe: `--parent-project-path "Main" -n "Nested"`.

`-d`, `--description`

Especifica uma descrição para o projeto.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createsite _site-name_

Cria um site.

**Exemplos**

Crie um site denominado West Coast Sales. Uma ID de site `WestCoastSales` será automaticamente criada, o site não terá limite de cota de armazenamento e os administradores de site poderão adicionar e remover usuários:

`tabcmd createsite "West Coast Sales"`

Crie um site denominado `West Coast Sales` com a ID de site `wsales`:

`tabcmd createsite "West Coast Sales" -r "wsales"`

Impeça que os administradores de site adicionem usuários ao site:

`tabcmd createsite "West Coast Sales" --no-site-mode`

Defina uma cota de armazenamento, em MB:

`tabcmd createsite "West Coast Sales" --storage-quota 100`

### Opções

`-r`, `--url`

Usada em URLs para especificar o site. Diferente do nome do site.

`--user-quota`

Número máximo de usuários que podem ser adicionados ao site.

`--[no-]site-mode`

Permite ou nega a administradores de site a capacidade de adicionar ou remover usuários do site.

`--storage-quota`

Em MB, a quantidade de pastas de trabalho, extrações e fontes de dados que podem ser armazenadas no site.

`--extract-encryption-mode`

O modo de criptografia de extração do site pode ser **imposto**, **habilitado** ou **desabilitado**. Para obter mais informações, consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

`--run-now-enabled`

Permita ou negue aos usuários a execução manual de atualizações, fluxos ou agendamentos de extração. **true** para permitir que os usuários executem tarefas manualmente ou **false** para impedir que os usuários executem tarefas manualmente. Para obter mais informações, consulte [Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm).

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createsiteusers _filename.csv_

Adiciona usuários a um site, com base nas informações fornecidas em um arquivo de valores separados por vírgula (CSV). Se o usuário ainda não tiver sido criado no servidor, o comando cria o usuário antes de adicioná-lo ao site.

O arquivo CSV deve conter um ou mais nomes de usuário e também pode incluir (para cada usuário) senha, nome completo, tipo de licença, nível de administrador, publicador (sim/não) e endereço de e-mail. Pra obter informações sobre o formato do arquivo CSV, consulte [Diretrizes do arquivo de importação CSV](https://help.tableau.com/current/server/pt-br/csvguidelines.htm).

Como uma alternativa à inclusão de permissões a nível do administrador ou publicador no arquivo CSV, é possível transmitir informações a nível de acesso ao incluir a opção `--role` e especificar a função no site que deseja atribuir aos usuários listados no arquivo CSV.

Por padrão, os usuários são adicionados ao site no qual você está logado. Para adicionar usuários a um site diferente, inclua a opção global `--site` e especifique esse site. (Você deve ter permissões para criar os usuários no site especificado.)

Se o servidor contiver vários sites, você não pode adicionar administradores do servidor (sistema) por meio do comando `createsiteusers`. Em vez disso, use `createusers`. Se você especificar a função no site `ServerAdministrator` para a opção `--role`, o comando retornará um erro. Se o arquivo CSV incluir `System` como valor para o administrador, o valor é ignorado e o usuário recebe o tipo de licença `Unlicensed`.

Se o servidor contiver somente um site (o site padrão), você pode especificar `system` para o valor do administrador de um usuário, ou até mesmo atribuir a função no site `ServerAdministrator` usando a opção `--role`, se deseja que todos os usuários no arquivo CSV sejam administradores do sistema.

Por padrão, este comando cria usuários usando uma operação síncrona (ele aguarda que todas as operações sejam concluídas antes de continuar). Você pode usar a opção `--no-wait` para especificar uma operação assíncrona.

### Melhorar o desempenho para arquivos CSV grandes

Um administrador de servidor pode usar o comando `tabadmin set` para habilitar configurações que ajudam a melhorar o desempenho de arquivos CSV grandes. Para obter mais informações, consulte [Melhorar o desempenho de grandes arquivos CSV passados pelo tabcmd](https://help.tableau.com/current/server/pt-br/csvguidelines.htm#improve-performance-large-csv) no tópico Diretrizes do arquivo de importação CSV.

### Autenticação local

Se o servidor estiver configurado para usar autenticação local, as informações no arquivo CSV serão usadas para criar usuários.

### Autenticação do Active Directory

Se o servidor estiver configurado para usar a autenticação do Active Directory, as informações do usuário serão importadas do Active Directory e as informações de senha e nome amigável do arquivo CV serão ignoradas. Além disso, se um usuário for especificado no arquivo CSV, mas existir um usuário correspondente no Active Directory, esse usuário não será adicionado ao Tableau Server. Para os usuários do Active Directory, como não é garantido que o nome de usuário seja exclusivo entre os domínios, você deverá incluir o domínio como parte do nome de usuário. É possível especificar como `domain\username` ou `username@domain.com`; contudo, recomendamos usar o formato `domain\username`. Para obter mais informações, consulte [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm).

**Exemplo**

`tabcmd createsiteusers "users.csv" --role "Explorer"`

### Opções

`--admin-type`

Obsoleto. Em vez disso, use a opção `--role`.

`--auth-type`

Define o tipo de autenticação (`Local` ou `SAML`) para todos os usuários no arquivo `.csv`. Se não for especificada, o padrão é `Local`.

**Observação:** para usar a autenticação SAML, o site deve ser configurado para SAML específico do site em definições do Tableau Server. Para obter informações, consulte [Configurar SAML para um site específico](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).

`--[no-]complete`

Obsoleto. Comportamento de erro padrão: se houver mais de 3 erros em um espaço de dez linhas, então o comando falhará.

`--no-publisher`

Obsoleto. Em vez disso, use a opção `--role`.

`--nowait`

Não espere que os trabalhos assíncronos sejam concluídos.

`--publisher`

Obsoleto. Em vez disso, use a opção `--role`.

`--role`

Especifica uma função no site para todos os usuários no arquivo `.csv`. Quando você deseja atribuir funções no site usando a opção --role, crie um arquivo CSV separado para cada função no site.

Os valores válidos são: `ServerAdministrator`, `SiteAdministratorCreator`, `SiteAdministratorExplorer`, `SiteAdministrator`, `Creator`, `ExplorerCanPublish`, `Publisher`, `Explorer`, `Interactor`, `Viewer` e `Unlicensed`.

O padrão é `Unlicensed` para novos usuários e inalterado para usuários existentes. Os usuários são adicionados como não licenciados também no caso de uma instalação de servidor com base em usuário e se o comando `createsiteusers` criar um novo usuário, mas você já tiver atingido o limite de número de licenças para usuários.

**Observação:** em um Tableau Server de vários sites, se você deseja atribuir a função no site `ServerAdministrator` usando a opção `--role`, use o comando [`createusers`](#createusers) em vez do `createsiteusers`.

`--silent-progress`

Não exibe mensagens de progresso para o comando.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createusers _filename.csv_

Cria usuários no Tableau Server com base em informações fornecidas em um arquivo de valores separados por vírgula (CSV).

O arquivo CSV deve conter um ou mais nomes de usuário e também pode incluir (para cada usuário) senha, nome completo, tipo de licença, nível de administrador, publicador (sim/não) e endereço de e-mail. Pra obter informações sobre o formato do arquivo CSV, consulte [Diretrizes do arquivo de importação CSV](https://help.tableau.com/current/server/pt-br/csvguidelines.htm).

Como uma alternativa à inclusão de permissões a nível do administrador ou publicador no arquivo CSV, é possível transmitir informações a nível de acesso ao incluir a opção `--role` e especificar a função no site que deseja atribuir aos usuários listados no arquivo CSV.

Se o servidor tiver apenas um site (o site padrão), o usuário é criado e adicionado ao site. Se o servidor tiver vários sites, o usuário é criado, mas não será adicionado a nenhum site. Para adicionar usuários a um site, use [`createsiteusers`](#createsiteusers).

No caso de uma instalação de servidor com base em usuário, se o comando criar um novo usuário, mas você já tiver atingido o limite de número de licenças para usuários, esse usuário será adicionado como não licenciado.

### Autenticação local

Se o servidor estiver configurado para usar autenticação local, as informações no arquivo CSV serão usadas para criar usuários.

### Autenticação do Active Directory

Se o servidor estiver configurado para usar a autenticação do Active Directory, as informações do usuário serão importadas do Active Directory e as informações de senha e nome amigável do arquivo CV serão ignoradas. Além disso, se um usuário for especificado no arquivo CSV, mas existir um usuário correspondente no Active Directory, esse usuário não será adicionado ao Tableau Server. Para os usuários do Active Directory, como não é garantido que o nome de usuário seja exclusivo entre os domínios, você deverá incluir o domínio como parte do nome de usuário. É possível especificar como `domain\username` ou `username@domain.com`; contudo, recomendamos usar o formato `domain\username`. Para obter mais informações, consulte [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm).

**Exemplo**

`tabcmd createusers "users.csv" --role "ServerAdministrator"`

`tabcmd createusers "users.csv"`

### Opções

`--admin-type`

Obsoleto. Em vez disso, use a opção `--role`.

`--[no-]complete`

Obsoleto. Comportamento de erro padrão: se houver mais de 3 erros em um espaço de dez linhas, então o comando falhará.

`--no-publisher`

Obsoleto. Em vez disso, use a opção `--role`.

`--nowait`

Não espere que os trabalhos assíncronos sejam concluídos.

`--publisher`

Obsoleto. Em vez disso, use a opção `--role`.

`-r`, `--role`

Especifica uma função no site para todos os usuários no arquivo `.csv`. Quando você deseja atribuir funções no site usando a opção --role, crie um arquivo CSV separado para cada função no site.

Os valores válidos são: `ServerAdministrator`, `SiteAdministratorCreator`, `SiteAdministratorExplorer`, `SiteAdministrator`, `Creator`, `ExplorerCanPublish`, `Publisher`, `Explorer`, `Interactor`, `Viewer` e `Unlicensed`.

Em um servidor com vários sites, o comando não atribui o usuário a um site. Portanto, as únicas funções no site que o comando atribuirá com sucesso são `ServerAdministrator` e `Unlicensed`. Ao especificar qualquer outra função no site, o comando atribui a função de `Unlicensed`.

Em um servidor de site único, o usuário é criado e adicionado ao site padrão usando a função que você especificar.

No caso de uma instalação de servidor com base em usuário, se o comando criar um novo usuário, mas você já tiver atingido o limite de número de licenças para usuários, esse usuário será adicionado como não licenciado.

`--silent-progress`

Não exibe mensagens de progresso para o comando.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## decryptextracts

Descriptografa todas as extrações em um site. Se nenhum site for especificado, as extrações no site padrão serão descriptografadas. Para obter mais informações, consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

Dependendo do número e do tamanho das extrações, essa operação pode consumir recursos significativos do servidor. Considere executar este comando fora do horário comercial normal.

**Exemplo**

`tabcmd decryptextracts "West Coast Sales"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## delete _workbook-name_ ou _datasource-name_

Exclui do servidor a pasta de trabalho ou fonte de dados especificada.

Esse comando captura o nome da pasta de trabalho ou fonte de dados como está no servidor, e não o nome do arquivo de quando ele foi publicado.

**Exemplo**

`tabcmd delete "Sales_Analysis"`

### Opções

`-r`, `--project`

O nome do projeto que contém a pasta de trabalho ou a fonte de dados a ser excluída. Caso não esteja especificado, o projeto “Padrão” será adotado.

`--parent-project-path`

Especifica o nome do projeto principal para o projeto aninhado, como indicado na opção `-r`. Por exemplo, para especificar um projeto denominado "aninhado" que existe em um projeto "Principal", use a seguinte sintaxe: `--parent-project-path "Main" -r "Nested"`. Para projetos aninhados em vários níveis: `--parent-project-path "Main\Nested\Nested2 -r "Nested3`.

`--workbook`

O nome da pasta de trabalho que você deseja excluir.

`--datasource`

O nome da fonte de dados que você deseja excluir.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteextracts

Exclui extrações para uma pasta de trabalho ou fonte de dados publicada.

### Opções

`-d`, `--datasource`

O nome da fonte de dados de destino para a exclusão de extração.

`--embedded-datasources`

Uma lista de nomes das fontes de dados inseridas separadas por espaço na pasta de trabalho destino. Coloque nomes de fontes de dados entre aspas duplas se contiverem espaços. Disponível somente ao excluir extrações para uma pasta de trabalho.

`--encrypt`

Criar extração criptografada.

`--include-all`

Inclua todas as fontes de dados inseridas na pasta de trabalho de destino.

`--parent-project-path`

Caminho do projeto principal que contém o recurso de destino. Deve especificar o nome do projeto com --projeto.

`--project`

O nome do projeto que contém o recurso de destino. Necessário somente se a - pasta de trabalho ou - fonte de dados for especificada. Se não especificado, o projeto padrão 'Default' será usado.

`-u`, `-url`

O nome canônico do recurso conforme ele aparece na URL.

`-w`, `-workbook`

O nome da pasta de trabalho de destino para a exclusão de extração.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletegroup _group-name_

Exclui do servidor um grupo especificado.

**Exemplo**

`tabcmd deletegroup "Development"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteproject _project-name_

Exclui do servidor um projeto especificado.

Ao usar `tabcmd`, só é possível especificar projetos de nível superior na hierarquia de um projeto. Para automatizar tarefas que deseja realizar em um projeto incluso em um projeto principal, use a chamada a [API REST](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api_ref.htm%23API_Reference "Abre a referência da API REST em uma nova guia do navegador") equivalente do Tableau.

**Exemplo**

`tabcmd deleteproject "Designs"`

### Opção

`--parent-project-path`

Especifica o nome do projeto principal para o projeto aninhado, como indicado no comando. Por exemplo, para especificar um projeto denominado "Designs" que existe em um projeto "Principal", use a seguinte sintaxe: `--parent-project-path "Main" "Designs"`.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletesite _site-name_

Exclui do servidor um site especificado.

**Exemplo**

`tabcmd deletesite "Development"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletesiteusers _filename.csv_

Exclui os usuários do site no qual você estiver conectado. Os usuários que serão removidos são especificados em um arquivo que contém uma lista simples de um nome de usuário por linha. (Nenhuma informação adicional é necessária além do nome do usuário.)

Por padrão, se o servidor tiver apenas um site ou se o usuário pertencer a apenas um site, o usuário também é removido do servidor. Em uma instalação do Tableau Server Enterprise, se o servidor contiver vários sites, os usuários que recebem a função de site de **Administrador de servidor** são removidos do site, mas não do servidor.

Se o usuário possui conteúdo, a função de usuário é alterada para **Não licenciado**, mas ele não será removido do servidor ou site. O conteúdo ainda é propriedade desse usuário. Para remover o usuário completamente, você deve alterar o proprietário do conteúdo e, em seguida, tentar removê-lo novamente.

Se o usuário foi importado do Active Directory, ele é removido do site e, possivelmente, do servidor. No entanto, o usuário não será excluído do Active Directory.

**Exemplo**

`tabcmd deletesiteusers "users.csv"`

### Melhorar o desempenho para arquivos CSV grandes

Um administrador de servidor pode usar o comando `tabadmin set` para habilitar configurações que ajudam a melhorar o desempenho de arquivos CSV grandes. Para obter mais informações, consulte [Melhorar o desempenho de grandes arquivos CSV passados pelo tabcmd](https://help.tableau.com/current/server/pt-br/csvguidelines.htm#improve-performance-large-csv) no tópico Diretrizes do arquivo de importação CSV.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteusers _filename.csv_

Exclui os usuários listados no arquivo de valores separados por vírgula (`.csv`) especificado.

O arquivo`.csv` deve conter uma lista simples de um nome de usuário por linha.

**Exemplo**

`tabcmd deleteusers "users.csv"`

### Opções

`--[no-]complete`

Quando definida como `--complete`, essa opção exige que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Se não especificada, `--complete` será usada.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## editdomain

**Observação:** como prática recomendada, você deve fazer backup do Tableau Server antes de editar o domínio. O domínio é salvo no Repositório do Tableau e, se for alterado incorretamente, os administradores podem conseguir fazer logon.

Altera o apelido ou nome de domínio completo de um domínio do Active Directory no servidor. Um “apelido” de domínio é o nome de domínio NetBIOS do Windows.

É possível modificar o apelido para qualquer domínio que o servidor esteja usando. Em geral, você pode modificar o nome de domínio completo de qualquer domínio, exceto daquele que você usou para entrar. No entanto, caso o nome de usuário atualmente usado por você para entrar esteja no domínio atual e no novo domínio, você pode modificar o nome completo do domínio atual.

Para garantir que o Tableau Server possa se conectar a outros domínios do Active Directory, você também deve especificar domínios secundários aos quais o Tableau Server se conecta definindo a opção `wgserver.domain.whitelist` com o TSM. Para obter mais informações sobre domínios secundários e configuração da conexão, consulte [wgserver.domain.whitelist](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain).

Consulte [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm) para entender como vários domínios, mapeamento de nome de domínio e nomes de usuário interagem com o Tableau Server.

Para visualizar uma lista de domínios, use [listdomains](#listdomains).

**Exemplos**

`tabcmd editdomain --id 2 --nickname "new-nickname"`

`tabcmd editdomain --id 3 --name "new-name"`

### Opções

`--id`

A ID de domínio para alterar. Para obter uma lista de IDs de domínio, use [listdomains](#listdomains).

`--name`

O novo nome para o domínio.

`--nickname`

O novo apelido para o domínio.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## editsite _site-name_

Altera o nome de um site ou o nome de sua pasta Web. Você também pode usar esse comando para permitir ou negar aos administradores de site a capacidade de adicionar e remover usuários ou impedir que os usuários executem determinadas tarefas manualmente. Se os administradores de site tiverem direitos de gerenciamento de usuário, você poderá especificar quantos usuários eles podem adicionar a um site.

**Exemplos**

`tabcmd editsite wc_sales --site-name "West Coast Sales"`

`tabcmd editsite wc_sales --site-id "wsales"`

`tabcmd editsite wsales --status ACTIVE`

`tabcmd editsite wsales --user-quota 50`

### Opções

`--site-name`

O nome do site que é exibido.

`--site-id`

Usada na URL para identificar o site de forma exclusiva.

`--user-quota`

Número máximo de usuários que podem ser membros do site.

`--[no-]site-mode`

Permitir ou impedir que os administradores de site adicionem usuários ao site.

`--status`

Defina como `ACTIVE` para ativar um site ou `SUSPENDED` para suspender um site.

`--storage-quota`

Em MB, a quantidade de pastas de trabalho, extrações e fontes de dados que podem ser armazenadas no site.

`--extract-encryption-mode`

O modo de criptografia de extração do site pode ser **imposto**, **habilitado** ou **desabilitado**. Para obter mais informações, consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm). Dependendo do número e do tamanho das extrações, essa operação pode consumir recursos significativos do servidor.

`--run-now-enabled`

Permita ou negue aos usuários a execução manual de atualizações, fluxos ou agendamentos de extração. **true** para permitir que os usuários executem tarefas manualmente ou **false** para impedir que os usuários executem tarefas manualmente. Para obter mais informações, consulte [Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm).

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## encryptextracts

Criptografa todas as extrações em um site. Se nenhum site for especificado, as extrações no site padrão serão criptografadas. Para obter mais informações, consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

Dependendo do número e do tamanho das extrações, essa operação pode consumir recursos significativos do servidor. Considere executar este comando fora do horário comercial normal.

**Exemplo**

`tabcmd encryptextracts "West Coast Sales"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## export

Exporta uma exibição ou pasta de trabalho do Tableau Server e a salva em um arquivo. Esse comando também pode exportar apenas os dados usados para uma exibição. Os dados de visualização são exportados no nível de resumo. Para exportar dados detalhados, você deve usar a interface de usuário do Tableau Server. Para obter detalhes, consulte [Baixar exibições e pastas de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/export.htm).

Observe o seguinte quando for usar esse comando:

- **Permissões**: Para exportar, você deve ter a permissão Exportar imagem. Por padrão, essa permissão é autorizada ou herdada para todas as funções, embora as permissões possam ser definidas por pasta de trabalho ou exibição.
- **Exportando dados**: Para exportar apenas os dados para uma exibição, use a opção `--csv`. Ela exporta os dados de resumo usados em uma exibição para um arquivo .csv.
- **Como especificar a exibição, a pasta de trabalho ou os dados a serem exportados**:
    
    - Use parte da URL para identificar o que será exportado, especialmente a cadeia de caracteres `"workbook/view"` já que ela aparece na URL da pasta de trabalho ou da exibição. Não use o “nome amigável” e exclua a ID de sessão `:iid=_<n>_` do final da URL.
        
        Por exemplo, a exibição de amostra do Tableau _Detalhes do pedido_ na pasta de trabalho _Superstore_ tem uma URL parecida com essa: `<server_name>/#/views/Superstore/OrderDetails?:iid=2`
        
        Para exportar a exibição _Detalhes do pedido_, use a cadeia de caracteres `Superstore/OrderDetails`.
        
        _Não_ use `Superstore/Order Details` ou `Superstore/OrderDetails?:iid=2`.
    - Se o servidor executa vários sites e a exibição ou a pasta de trabalho está em um site que não seja o Padrão, use `-t <site_id>`.
    - Para exportar uma pasta de trabalho, obtenha a cadeia de caracteres da URL ao abrir uma exibição da pasta e a inclua na cadeia que for usar.
        
        No exemplo acima, para exportar a pasta de trabalho _Superstore_, use a cadeia de caracteres `Superstore/OrderDetails`.
    - Para exportar uma pasta de trabalho, ela deve ter sido publicada com a opção Mostrar planilhas como guias selecionada na caixa de diálogo Publicar do Tableau Desktop.
        
        **Observação:** não é possível exportar a pasta de trabalho do Tableau que contém as [exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm).
    - Para filtrar os dados que você baixa, adicione um filtro de parâmetro usando este formato:
        
        ?<filter\_name>=value
        
        ou, se filtrar em um parâmetro e esse parâmetro tiver um nome de exibição que corresponda ao nome de uma medida ou dimensão:
        
        `?Parameters.<filter_name>=value`
- O formato do arquivo salvo: Suas opções de formato dependem do que está sendo exportado. Uma pasta de trabalho somente pode ser exportada como um PDF, usando o argumento `--fullpdf`. É possível exportar uma exibição como um PDF (`--pdf`) ou um PNG (`--png`).
- **O nome e o local do arquivo salvo** (opcional): Se você não informar um nome, ele será derivado do nome de exibição ou pasta de trabalho. Se você não informar um local, o arquivo será salvo em seu diretório de trabalho atual. Caso contrário, você poderá especificar um caminho completo ou um que seja relativo ao seu diretório de trabalho atual.
    
    **Observação**: você deve incluir uma extensão de nome de arquivo, por exemplo, `.csv` ou `.pdf`. O comando não adiciona automaticamente uma extensão ao nome de arquivo que você fornece.
- **Objetos de página da Web do painel não incluídos em exportações para PDF**: Um painel pode conter opcionalmente um objeto de página da Web. Se você estiver executando uma exportação para PDF de um painel que contém um objeto de página da Web, esse objeto não será incluído no PDF.
- **Caracteres não ASCII e não padrão e exportações de PDF**: se você estiver exportando uma exibição ou pasta de trabalho com um nome que inclua um caractere fora do conjunto de caracteres ASCII ou não padrão, será necessário codificar o caractere com URL (ou codificar com percentual).
    
    Por exemplo, se o seu comando inclui a cidade `Zürich`, é necessário codificá-lo com URL como `Z%C3%BCrich`:
    
    `tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf`

**Limpeza do cache para usar dados em tempo real**

Opcionalmente, você pode adicionar o parâmetro de URL `?:refresh=yes` para forçar uma consulta de dados atualizados em vez de extrair os resultados do cache. Se você estiver usando o tabcmd com seu próprio script e o parâmetro de URL `refresh` estiver sendo muito usado, isso poderá prejudicar o desempenho. É recomendável usar `refresh` somente quando dados em tempo real são necessários, por exemplo, em um painel único em vez de uma pasta de trabalho inteira.

**Exemplos**

_Exibições_

`tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"`

`tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

`tabcmd export "Finance/InvestmentGrowth" --png`

`tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png`

_Pastas de trabalho_

`tabcmd export "Q1Sales/Sales_Report" --fullpdf`

`tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

### Opções

`-f`, `--filename`

Salva o arquivo com o nome de arquivo e extensão fornecidos.

`--csv`

Somente exibição. Exporte os dados da exibição (dados de resumo) no formato`.csv`.

`--pdf`

Somente exibição. Exportar como PDF.

`--png`

Somente exibição. Exportar como imagem em formato`.png`.

`--fullpdf`

Somente pasta de trabalho. Exportar como PDF. É preciso que a pasta de trabalho tenha sido publicada com a opção Mostrar planilhas como guias habilitada.

`--pagelayout`

Define a orientação da página (`landscape` ou `portrait`) do PDF exportado. Se não especificada, sua configuração do Tableau Desktop será usada.

`--pagesize`

Define o tamanho da página do PDF exportado como o seguinte: `unspecified`, `letter`, `legal`, `note folio`, `tabloid`, `ledger`, `statement`, `executive`, `a3`, `a4`, `a5`, `b4`, `b5` ou `quarto`. O padrão é `letter`.

`--width`

Define a largura em pixels. O padrão é 800 px.

`--height`

Define a altura em pixels. O padrão é 600 px.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## get _url_

Obtém o recurso de Tableau Server que é representado pela URL (parcial) especificada. O resultado é retornado como um arquivo.

Observe o seguinte quando for usar esse comando:

- **Permissões**: para obter um arquivo, você deve ter a permissão Baixar/salvar na Web como. Por padrão, essa permissão é autorizada ou herdada para todas as funções, embora as permissões possam ser definidas por pasta de trabalho ou exibição.
- **Especificando uma exibição ou pasta de trabalho para obter**: você pode especificar uma exibição para obter usando a cadeia de caracteres `"/views/<workbookname>/<viewname>.<extension>"`e especificar uma pasta de trabalho para obter usando a cadeia de caracteres `"/workbooks/<workbookname>.<extension>"`. Substitua `<workbookname>` e `<viewname>` com os nomes da pasta de trabalho e exibição, à medida que aparecem na URL, quando você abre a exibição em um navegador e substitui <extension> pelo tipo de arquivo que deseja salvar. Não use a ID da sessão no final da URL (`?:iid=<n>`) ou o nome "amigável"da pasta de trabalho ou exibição.
    
    Por exemplo, ao abrir _Totais regionais_ de uma exibição em uma pasta de trabalho chamada _Resumo de métricas_, a URL ficará parecida com:
    
    `/views/MetricsSummary_1/RegionalTotals?:iid=1`
    
    Use a cadeia de caracteres `/views/MetricsSummary_1/RegionalTotals.<extension>` para obter a exibição.
    
    Use a cadeia de caracteres `/workbooks/MetricsSummary_1.<extension>` para obter a pasta de trabalho.
    
    Ao baixar pastas de trabalho e exibições de Tableau Server, o conteúdo do arquivo .twb ou .twbx é armazenado em texto simples. Todos os dados, incluindo valores de filtro que podem fornecer pistas semânticas para os dados, poderão ser lidos por qualquer pessoa que abrir o arquivo.
- **Extensão do arquivo**: a URL deve incluir uma extensão de arquivo. A extensão determina o que é retornado. Uma exibição pode ser retornada no formato PDF, PNG ou CSV (somente dados de resumo). Uma pasta de trabalho do Tableau retorna como TWB se ele se conectar a uma fonte de dados publicada ou usar uma conexão ativa, ou um TWBX caso se conecte a uma extração de dados.
    
    **Observação**: se você estiver baixando uma exibição para um arquivo PDF ou PNG e incluir um parâmetro `--filename` com a extensão .pdf ou .png, não será necessário incluir uma extensão .pdf ou .png na URL.
- **O nome e o local do arquivo salvo** (opcional): o nome que você usa para `--filename` deve incluir a extensão do arquivo. Se você não informar um nome e extensão de arquivo, ambos serão derivados da cadeia de caracteres de URL. Se você não informar um local, o arquivo será salvo em seu diretório de trabalho atual. Caso contrário, você poderá especificar um caminho completo ou um que seja relativo ao seu diretório de trabalho atual.
- **Tamanho do PNG** (opcional): se o arquivo salvo estiver em PNG, você poderá especificar o tamanho, em pixels, na URL.

**Limpeza do cache para usar dados em tempo real**

Opcionalmente, você pode adicionar o parâmetro de URL `?:refresh=yes` para forçar uma consulta de dados atualizados em vez de extrair os resultados do cache. Se você estiver usando o tabcmd com seu próprio script, usar demais o parâmetro `refresh` poderá ter um impacto negativo sobre o desempenho. É recomendável usar `refresh` somente quando dados em tempo real são necessários, por exemplo, em um painel único em vez de uma pasta de trabalho inteira.

**Exemplos**

_Exibições_

`tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"`

`tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth.csv"`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png`

_Pastas de trabalho_

`tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## initialuser

Crie o usuário administrativo do Server inicial em um servidor que não tenha um usuário administrativo inicial definido. Isso cria um administrador do Server. Isso não cria um administrador do TSM.

**Observação**: o comando **tabcmd initialuser** não requer autenticação no Tableau Server, mas deve sr executado no nó inicial do servidor.

**Observações**:

- O comando **tabcmd initialuser** não requer autenticação no Tableau Server, mas deve sr executado no nó inicial do servidor.
- O valor de `username` não pode incluir uma arroba (@), a menos que o sufixo do nome de usuário corresponda ao domínio primário do Tableau Server. Por exemplo, se o Tableau Server se conectar ao domínio "myco.com", o nome de usuário "user@example.com@myco.com" não pode ser usado.

**Exemplos**

`tabcmd initialuser --username "admin" --password "password" --server http://localhost`

`tabcmd initialuser --username "admin" --password "password" --friendly "Tableau Admin" --server http://localhost`

Para solicitar a senha no shell, não inclua o parâmetro `--password` no comando. Por exemplo:

`tabcmd initialuser --username "admin" --server http://localhost`

### Opções

`-f`, `--friendly`

Cria o usuário administrativo inicial do Server com o nome de exibição.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## listdomains

Exibe uma lista de domínios do Active Directory que estão em uso no servidor, juntamente com os seus apelidos e IDs. Se o servidor estiver configurado para usar a autenticação local, o comando retorna apenas o nome de domínio `local`.

**Exemplo**

`tabcmd listdomains`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## listsites

Retorna uma lista de sites aos quais o usuário conectado pertence.

**Exemplo**

`tabcmd listsites --username adam --password mypassword`

### Opções

`--get-extract-encryption-mode`

O modo de criptografia de extração do site pode ser **imposto**, **habilitado** ou **desabilitado**. Para obter mais informações, consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## logon

Um usuário do Tableau Server faz logon.

Use as opções globais `--server`, `--site`, `--username`, `--password` para criar uma sessão.

**Observação**: quando você usa o comando **tabcmd login**, não é possível usar o logon único (SSO, single-sign-on) do SAML, mesmo se o servidor estiver configurado para usar o SAML. Para entrar, você deve inserir o nome de usuário e senha de um usuário criado no servidor. Você terá as permissões do usuário do Tableau Server pelo qual está logado. Para obter mais informações, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm) e [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

Se quiser fazer logon usando as mesmas informações que já foram usadas para criar uma sessão, basta especificar a opção `--password`. Serão usados o nome de usuário e servidor armazenados no cookie.

Se o servidor estiver usando uma porta diferente de 80 (o padrão), você deverá especificá-la.

Você só precisa da opção `--site` (`-t`) quando o servidor está executando vários sites e você está se conectando a um site que não seja o padrão. Se você não fornecer uma senha, uma será solicitada. Se a opção `--no-prompt` for especificada e nenhuma senha for fornecida, o comando falhará.

Após o logon, a sessão continuará até expirar no servidor ou até que o comando `logout` seja executado.

**Exemplo**

Conecta o usuário jsmith ao Tableau Server que executa no computador local:

`tabcmd login -s http://localhost -u jsmith -p password`

Conecta o administrador ao site Sales no sales-server:

`tabcmd login -s http://sales-server -t Sales -u administrator -p password`

`tabcmd login -s http://sales-server:8000 -t Sales -u administrator -p password`

Conecta o administrador ao site Sales no sales-server com o uso do SSL, mas não valida o certificado SSL do servidor:

`tabcmd login --no-certcheck -s https://sales-server -t Sales -u administrator -p password`

Estabelece um proxy avançado e uma porta para localhost:

`tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u jsmith -p password`

Conecta o usuário jsmith ao proxy reverso com o uso do SSL:

`tabcmd login -s https://myreverseproxy -u jsmith -p password`

### Opções

`-s`, `--server`

Se você estiver for executado de um computador com o Tableau Server que faça parte da rede, será possível usar `http://localhost`. Caso contrário, especifique a URL do computador, por exemplo, `http://bigbox.myco.com` ou `http://bigbox`.

Se o servidor estiver usando SSL, você precisará especificar `https://` na URL do computador.

No Tableau Cloud, especifique a URL completa, incluindo o pod no qual seu site está implantado. Por exemplo: `https://prod-useast-b.online.tableau.com`.

`-t`, `--site`

Inclua essa opção caso o servidor tenha vários sites e você estiver fazendo logon em um site que não seja o padrão.

A ID do site é usada na URL para identificá-lo com exclusividade. Por exemplo, um site chamado West Coast Sales pode ter uma ID west-coast-sales.

`-u`, `--username`

O nome de usuário do usuário que faz o logon. Para o Tableau Cloud, o nome de usuário é o endereço de e-mail do usuário.

`-p`, `--password`

Senha do usuário especificada para `--username`. Se você não fornecer uma senha, uma será solicitada.

`--password-file`

Permite que a senha seja armazenada no arquivo fornecido `filename.txt` em vez de na linha de comando para aumento da segurança.

`-x`, `--proxy`

Use para especificar o servidor proxy HTTP e a porta (Host:Porta) para a solicitação de tabcmd.

`--no-prompt`

Não solicita uma senha. Se nenhuma senha for especificada, o comando `login` falhará.

`--no-proxy`

Não usa um servidor proxy HTTP.

`--cookie`

Salva a ID de sessão no logon. Os comandos subsequentes não exigirão logon. Este valor é o padrão para o comando.

`--no-cookie`

Não salva as informações de ID da sessão após um logon bem-sucedido. Os comandos subsequentes exigirão logon.

`--timeout SECONDS`

O número de segundos que o servidor deve esperar antes de processar o comando `login`. Padrão: 30 segundos.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## logout

Faz logout no servidor.

**Exemplo**

`tabcmd logout`

## publish _filename.twb(x)_, _filename.tds(x)_, or _filename.hyper_

Publica a pasta de trabalho (.twb(x)), fonte de dados (.tds(x)) ou extração (.hyper) especificadas no Tableau Server.

Por padrão, se você estiver publicando uma pasta de trabalho, todas as planilhas da pasta de trabalho serão publicadas sem nomes de usuário ou senhas de banco de dados.

As permissões inicialmente atribuídas à pasta de trabalho ou fonte de dados são copiadas do projeto onde o arquivo é publicado. As permissões para o recurso publicado podem ser alteradas depois que o arquivo for publicado. 

Se a pasta de trabalho contiver filtros de usuário, será preciso especificar uma das opções de miniatura.

**Observação:** a publicação de fontes de dados estendidas ou compostas usando tabcmd não é compatível no momento. Se você publicar uma pasta de trabalho composta ou um arquivo de fonte de dados com tabcmd, ele não será vinculado corretamente aos seus arquivos pai no servidor.

**Exemplo**

`tabcmd publish "analysis.twbx" -n "Sales_Analysis" --db-username "jsmith" --db-password "secret-password"`

`tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"   --oauth-username "user-name" --save-oauth`

Se o arquivo não estiver no mesmo diretório de tabcmd, inclua o caminho completo do arquivo.

**Exemplo**

`tabcmd publish "\\computer\volume\Tableau Workbooks\analysis.twbx" -n "Sales_Analysis" --db-username "jsmith" --db-password "secret-password"`

`tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth`

### Opções

`-n`, `--name`

Nome da pasta de trabalho ou fonte de dados no servidor. Se omitida, a pasta de trabalho, fonte de dados ou extração de dados terá o nome do arquivo.

`-o`, `--overwrite`

Substitui a pasta de trabalho, fonte de dados ou extração de dados se ela já existir no servidor.

`-r`, `--project`

Publica a pasta de trabalho, fonte de dados ou extração de dados no projeto especificado. Publica no projeto “padrão” se não for especificado.

`--parent-project-path`

Especifica o nome do projeto principal para o projeto aninhado, como indicado na opção `-r`. Por exemplo, para especificar um projeto denominado "aninhado" que existe em um projeto "Principal", use a seguinte sintaxe: `--parent-project-path "Main" -r "Nested"`.

`--db-username`

Use essa opção para publicar um nome de usuário de banco de dados com a pasta de trabalho, fonte de dados ou extração de dados.

`--db-password`

Use essa opção para publicar uma senha de banco de dados com a pasta de trabalho, fonte de dados ou extração.

`--save-db-password`

Armazena a senha de banco de dados fornecida no servidor.

`--oauth-username`

Endereço de e-mail da conta do usuário. Conecta o usuário por meio de uma conexão OAuth pré-configurada, caso o usuário já tenha um token de acesso salvo para a fonte de dados na nuvem especificada em `--name`. Os tokens de acesso são gerenciados nas preferências do usuário.

Para conexões OAuth existentes com a fonte de dados, use essa opção em vez de `--db-username` e `--db-password`.

`--save-oauth`

Salva a credencial especificada por `--oauth-username` como credencial inserida na pasta de trabalho ou fonte de dados publicada.

Subsequentemente, quando o publicador ou administrador do servidor faz logon no servidor e edita a conexão dessa pasta de trabalho ou fonte de dados, as configurações da conexão mostrarão essa credencial OAuth como inserida no conteúdo.

Se quiser agendar atualizações de extração após publicar, você precisará incluir essa opção em `--oauth-username`. Isso é análogo a usar `--save-db-password` com uma conexão de banco de dados tradicional.

`--thumbnail-username`

Se a pasta de trabalho contiver filtros de usuário, as miniaturas serão geradas com base no que o usuário especificado pode ver. Não pode ser especificada quando a opção `--thumbnail-group` estiver definida.

`--thumbnail-group`

Se a pasta de trabalho contiver filtros de usuário, as miniaturas serão geradas com base no que o grupo especificado pode ver. Não pode ser especificada quando a opção `--thumbnail-username` estiver definida.

`--tabbed`

Quando uma pasta de trabalho com exibições com guias é publicada, cada planilha torna-se uma guia que os visualizadores podem usar para navegar pela pasta de trabalho. Observe que essa configuração substituirá qualquer segurança no nível de planilha.

`--append`

Anexa o arquivo de extração à fonte de dados existente.

`--replace`

Usa o arquivo de extração para substituir a fonte de dados existente.

`--disable-uploader`

Desabilita o carregador de arquivos incremental.

`--restart`

Reinicia o upload do arquivo.

`--encrypt-extracts`

Criptografa extrações ao publicar uma pasta de trabalho, fonte de dados ou extração no servidor. Para obter mais informações, consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## publishsamples

### Descrição

Publica pastas de trabalho de amostra do Tableau ao projeto especificado. Qualquer amostra existente será substituída.

### Sintaxe

`tabcmd publishsamples -n [project name] [Global options]`

**Exemplo**

Publique amostras no prijeto Vendas internas no site Padrão, como o usuário jsmith.

`tabcmd publishsamples -n "Inside Sales" -t "" -s localhost --username "jsmith" --password "secret-password"`

### Opções

`-n`, `--name`

Obrigatório. Publica amostras do Tableau ao projeto especificado. Se o nome do projeto incluir espaços, insira-o entre aspas.

`--parent-project-path`

Especifica o nome do projeto principal para o projeto aninhado, como indicado na opção `-n`. Por exemplo, para especificar um projeto denominado "aninhado" que existe em um projeto "Principal", use a seguinte sintaxe: `--parent-project-path "Main" -n "Nested"`.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## reencryptextracts

Criptografa novamente todas as extrações em um site com novas chaves de criptografia. Esse comando vai regenerar a chave de criptografia e a chave de criptografia de dados. Você deve especificar um site. Para obter mais informações, consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

Dependendo do número e do tamanho das extrações, essa operação pode consumir recursos significativos do servidor. Considere executar este comando fora do horário comercial normal.

**Exemplos**

`tabcmd reencryptextracts "Default"`

`tabcmd reencryptextracts "West Coast Sales"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## refreshextracts _workbook-name_ or _datasource-name_

Faz uma atualização completa ou incremental de extrações que pertencem à pasta de trabalho ou fonte de dados especificada.

Esse comando captura o nome da pasta de trabalho ou fonte de dados como ele aparece no servidor, e não o nome do arquivo quando ele foi publicado. Apenas um administrador ou o proprietário da pasta de trabalho ou fonte de dados tem permissão para executar essa operação.

**Observação:** este método falhará e resultará em um erro se o Administrador do servidor tiver desativado a configuração **Executar agora** para o site. Para obter mais informações, consulte [Configurações do Tableau Server](https://help.tableau.com/current/server/pt-br/maintenance_set.htm).

**Exemplos**

tabcmd refreshextracts --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --parent-project-path "Main" --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales\_ds --removecalculations

### Opções

`--incremental`

Executa a operação de atualização incremental.

`--synchronous`

Adiciona a operação de atualização completa à fila usada pelo processador em segundo plano para ser executada assim que o processador em segundo plano estiver disponível. Se um processador em segundo plano estiver disponível, a operação é executada imediamente. A operação de atualização aparece no relatório de Tarefas em segundo plano.

Durante uma atualização síncrona, o `tabcmd` mantém uma conexão em tempo real com o servidor, enquanto a operação de atualização está em andamento, sondando a cada segundo até que o trabalho em segundo plano esteja concluído.

**Observação:** a opção `--synchronous` não está disponível para fontes de dados atualizadas com o Tableau Bridge.

`--workbook`

O nome da pasta de trabalho que contém extrações para atualização. Se a pasta de trabalho tiver espaços no nome, coloque-o entre aspas.

`--datasource`

O nome da fonte de dados que contém extrações para atualização.

`--project`

Use com `--workbook` ou `--datasource` para identificar uma pasta de trabalho ou fonte de dados em um projeto que não seja o _padrão_. Caso não esteja especificado, o projeto Padrão será adotado.

`--parent-project-path`

Especifica o nome do projeto principal para o projeto aninhado, como indicado na opção `--project`.

Por exemplo:

- Para especificar um projeto denominado "aninhado" que existe em um projeto "Principal", use a seguinte sintaxe:
- \--parent-project-path "Main" --project "Nested"
- Para especificar um projeto chamado "Aninhado2" que está aninhado dentro do projeto "Aninhado":
- \--parent-project-path "Main/Nested" --project "Nested2"

`--url`

O nome da pasta de trabalho conforme ele aparece no URL. Uma pasta de trabalho publicada como “Análise de vendas” tem um nome de URL “SalesAnalysis”.

`--addcalculations`

Use com `--workbook` para materializar os cálculos na extração inserida da pasta de trabalho ou `--datasource` para materializar os cálculos na fonte de dados de extração. Adiciona a operação à consulta usada pelo processo do processador em segundo plano. Se um processador em segundo plano estiver disponível, a operação é executada imediatamente. Essa operação aparece na exibição administrativa [Tarefas em segundo plano para extrações](https://help.tableau.com/current/online/pt-br/adminview_backgrnd.htm) .

`--removecalculations`

Use com `--workbook` ou `--datasource` para remover cálculos que foram materializados previamente. Adiciona a operação à consulta usada pelo processo do processador em segundo plano. Se um processador em segundo plano estiver disponível, a operação é executada imediatamente. Essa operação aparece na exibição administrativa [Tarefas em segundo plano para extrações](https://help.tableau.com/current/online/pt-br/adminview_backgrnd.htm) .

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## reset\_openid\_sub

Limpa os identificadores do OpenID Connect (valores secundários) que já foram associados às identidades do Tableau Server. Consulte [Alteração de IdPs no Tableau Server para o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_changing_idp.htm).

**Exemplo**

`tabcmd reset_openid_sub --target-username jsmith`

### Opções

`--target-username`

Limpa o valor secundário do usuário individual especificado.

`--all`

Limpa os valores secundários de todos os usuários.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## removeusers _group-name_

Remove usuários do grupo especificado.

**Exemplo**

`tabcmd removeusers "Development" --users "users.csv"`

### Opções

`--users`

Remove os usuários no arquivo`.csv` fornecido do grupo especificado. O arquivo deve ser uma lista simples com um nome de usuário por linha.

Se usar esse comando em arquivos`.csv` grandes no Tableau Server, um administrador de servidor pode habilitar configurações que ajudem a melhorar o desempenho. Para mais informações, consulte [Melhorar o desempenho de grandes arquivos CSV passados pelo tabcmd](https://help.tableau.com/current/server/pt-br/csvguidelines.htm#improve-performance-large-csv)

`--[no-]complete`

Exige que todas as linhas sejam válidas para que qualquer alteração seja bem-sucedida. Se não especificada, `--complete` será usada.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## runschedule _schedule-name_

Executa as tarefas no agendamento especificado para o site no qual você está conectado no momento. Você não pode executar isso para todos os sites usando tabcmd. Para executar as tarefas na agenda para todos os sites, faça login na interface da Web, na página **Agendas**, selecione **Todos os sites** e **execute agora** na agenda.

Esse comando captura o nome da agenda como está especificado no servidor.

Esse comando não estará disponível para o Tableau Cloud.

**Observação:** este método falhará e resultará em um erro se o Administrador do servidor tiver desativado a configuração **Executar agora** para o site. Para obter mais informações, consulte [Configurações do Tableau Server](https://help.tableau.com/current/server/pt-br/maintenance_set.htm).

**Exemplo**

`tabcmd runschedule "5AM Sales Refresh"`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## set _setting_

Habilita a configuração especificada no servidor. Os detalhes sobre cada configuração podem ser vistos na página Manutenção do servidor.

Use um ponto de exclamação em frente ao nome da configuração para desabilitá-la. É possível habilitar ou desabilitar as seguintes configurações:

- `allow_scheduling`
- `embedded_credentials`
- `remember_passwords_forever`

**Exemplo**

`tabcmd set embedded_credentials`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## syncgroup _group-name_

Sincroniza um grupo do Tableau Server com um do Active Directory. Caso o grupo do Tableau Server ainda não exista, ele é criado e sincronizado com o grupo do Active Directory especificado.

Se o nome do grupo em si inclui um caractere "@" (a não ser como separador de domínio) será necessário fazer referência ao símbolo usando o formato hex "\\0x40".

**Exemplo**

`tabcmd syncgroup "Development"`

`tabcmd syncgroup "Dev\0x40West"`

**Observação**: caso sincronize um grupo no qual você é membro, estiver alterações feitas usando este comando não serão aplicadas ao seu usuário. Por exemplo, caso use este comando para remover o direito de administrador de usuários em um grupo no qual é membro, você ainda será um administrador ao finalizar o comando.

### Opções

`--grant-license-mode <grant-license-mode>`

Especifica se uma função deve ser concedida no logon. O padrão é `on-sync`. Os valores válidos são: `on-login`, `on-sync`. Se nenhum valor for especificado, pressupõe-se que seja `on-sync`, e a função padrão será concedida quando o grupo estiver sincronizado. Para obter mais informações, consulte [Modificação das funções de usuário com a Atribuição de função no logon](https://help.tableau.com/current/server/pt-br/grant_role.htm#GrantRoleOnSignin).

`--no-publisher`

Obsoleto. Em vez disso, use a opção `--role`.

`--overwritesiterole`

Use `--role` para permitir que a função de site de um usuário seja sobrescrita por uma função com menos privilégios. Por padrão, a função de site de um usuário pode ser promovida ao usar `--role`, mas não pode ser rebaixada. A opção `--overwritesiterole` rebaixa as funções de site de usuários, portanto use-a com cuidado.

`--publisher`

Obsoleto. Em vez disso, use a opção `--role`.

`-r`, `--role`

Especifica uma função no site para os usuários no grupo. O padrão é `Unlicensed`.

Os valores válidos são: `SiteAdministratorCreator`, `SiteAdministratorExplorer`, `SiteAdministrator`, `Creator`, `ExplorerCanPublish`, `Publisher`, `Explorer`, `Interactor`, `Viewer`, `Unlicensed`.

`--silent-progress`

Não exibe mensagens de progresso para o comando.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## upgradethumbnails

Começa e interrompe o trabalho de Atualizar miniaturas. Para saber mais, consulte [Tarefa Atualizar miniaturas](https://help.tableau.com/current/server/pt-br/adminview_backgrounder_upgrade_thumbnails.htm).

**Exemplos**

Para iniciar o trabalho de Atualizar miniaturas:

`tabcmd upgradethumbnails --server <serverURL>`

Para parar o trabalho de Atualizar miniaturas em andamento:

`tabcmd upgradethumbnails --server <serverURL> --stop`

### Opções

`--stop`

Quando especificado, interrompe o trabalho de Atualizar miniaturas em andamento. Se essa opção não estiver especificada, o trabalho de Atualizar miniatura será iniciado.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## validateidpmetadata

Identifica sites do Tableau Server configurados com IdPs usando o algoritmo de resumo inseguro, SHA-1. Este comando também identifica IdPs que estão usando certificados com um tamanho de chave RSA insuficiente ou tamanho de curva elíptica.

**Observação:** este comando está disponível apenas para SAML específico do site. Para obter mais informações, consulte [Configurar SAML para um site específico](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).

### Opções

`--digest-algorithms <ALGORITHMS>`

Uma lista de algoritmos de resumo separados por espaço. Os valores legais são `sha1` e`sha256` . Se não for especificado, o servidor usará os valores da definição de configuração do servidor, [wgserver.saml.blocklisted\_digest\_algorithms](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver5).

`--min-allowed-elliptic-curve-size <SIZE>`

Se não for especificado, o servidor usará os valores da definição de configuração do servidor, [wgserver.saml.min\_allowed.elliptic\_curve\_size](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver2).

`--min-allowed-rsa-key-size <SIZE>`

Se não for especificado, o servidor usará os valores da definição de configuração do servidor, [wgserver.saml.min\_allowed.rsa\_key\_size](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver4).

`--site-names <SITENAMES>`

Uma lista separada por espaços de nomes de sites nos quais a validação do certificado deve ser realizada. Se não for especificado, todos os sites serão inspecionados.

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## version

Exibe as informações de versão da instalação atual do utilitário tabcmd.

**Exemplo**

`tabcmd version`

Opções globais

As opções abaixo são usadas por todos os comandos `tabcmd`. As opções `--server`, `--user` e `--password` são exigidas pelo menos uma vez para iniciar a sessão. Um token de autenticação é armazenado, de modo que comandos subsequentes possam ser executados sem que essas opções sejam incluídas. Esse token permanece válido por cinco minutos após ter sido usado pelo último comando.

`-h`, `--help`

Exibe a ajuda do comando.

`-c`, `--use-certificate`

Use o certificado de cliente para entrar. Exigido quando o SSL mútuo está habilitado.

Para obter informações sobre como configurar o certificado de acordo com o sistema operacional do seu Tableau Server, comece com o seguinte tópico:

- **Windows:** [Configurar o SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")
- **Linux:** [Configurar o SSL mútuo](https://help.tableau.com/current/server-linux/pt-br/ssl_config_mutual.htm "Abrir o tópico em uma nova guia do navegador")

`-s`, `--server`

A URL Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-u`, `--user`

O nome de usuário do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`-p`, `--password`

A senha do Tableau Server, que é exigida pelo menos uma vez para iniciar a sessão.

`--password-file`

Permite que a senha seja armazenada no arquivo `.txt` fornecido, em vez de na linha de comando para aumento da segurança.

`-t`, `--site`

Indica que o comando se aplica ao site especificado pela Tableau Server ID do site, entre aspas simples e duplas. Para especificar o site Padrão, use uma sequência vazia com aspas simples ou duplas ('' ou "") ou use o padrão em aspas duplas ("Padrão"). A ID de site diferencia maiúsculas e minúsculas ao usar um token de autenticação em cache. Se as letras não corresponderem, você pode ser solicitado a fornecer uma senha, mesmo que o token ainda seja válido.

`-x`, `--proxy`

Host:Port

Use o proxy HTTP especificado.

`--no-prompt`

Quando especificada, o comando não solicitará uma senha. Se nenhuma senha válida for fornecida, o comando falhará.

`--no-proxy`

Quando especificado, um proxy HTTP não será usado.

`--no-certcheck`

Quando especificado, tabcmd (o cliente) não valida o certificado SSL do servidor.

`--[no-]cookie`

Quando especificada, a ID da sessão é salva no logon para que os comandos subsequentes não precisem fazer logon. Use o prefixo `no-` para não salvar a ID da sessão. A sessão é salva por padrão.

`--timeout`

Aguarda o número especificado de segundos para que o servidor conclua o processamento do comando. Por padrão, o processo aguardará até que o servidor responda.

`--`

Especifica o final das opções na linha de comando. Use `--` para indicar ao `tabcmd` que tudo que estiver após `--` não deve ser interpretado como uma definição de opção e, em vez disso, pode ser interpretado como um valor para o comando. Isso é útil caso precise especificar um valor no comando que inclui um hífen. O exemplo a seguir mostra como é possível usar `--` em um comando `tabcmd`, onde `-430105/Sheet1` é um valor obrigatório para o comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

**Dica**: para comandos Tabcmd 1.0 disponíveis para o Tableau Cloud, consulte [comandos tabcmd](https://help.tableau.com/current/online/pt-br/tabcmd_cmd.htm) .

<!-- document id=d2f97c52557a2f37d6eaa2c655c4fb12ee28af52ad6d08a63287f61636df8be6 url=/tableau/current/pt-br/server/jumpstart.md -->

[Pular para o conteúdo principal](#main-content)

# Começar a instalação

Este tópico fornece todas as etapas necessárias para executar uma instalação básica, de início rápido, do Tableau Server. O propósito da configuração descrita aqui é fornecer o caminho mais rápido e simples para uma instalação do Tableau Server. Use esse procedimento como prática, ou seja, para experimentar a instalação, o gerenciamento e a experiência de usuário do Tableau Server antes da verdadeira implantação do servidor.

**Importante**: não use esse procedimento como um recurso independente para a implantação do Tableau Server em um ambiente de produção. Para implantar o Tableau Server em um ambiente de produção, consulte o conteúdo em [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).

Os procedimentos neste tópico instalarão uma instância do Tableau Server para Windows usando o armazenamento de identidades local.

## Antes de começar

Analise o tópico, [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm). Este procedimento pressupõe a instalação do Windows no hardware adaptado de acordo com os requisitos ambientais especificados no tópico.

Observe que tal computador deve atender aos requisitos mínimos de hardware especificados em [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm). O programa de instalação não instalará o Tableau Server em sistemas que não atendam aos requisitos mínimos de hardware.

## Etapa 1: instalar o Tableau Server e iniciar o Tableau Services Manager

1. Clique duas vezes no arquivo de instalação.
2. Siga as instruções na tela para concluir a instalação e instale o aplicativo.
    
    ![Imagem da configuração que permite alterar o caminho do arquivo](/tableau/current/pt-br/server/pt-br/Img/tsm-install-path.png)
    
    O caminho de instalação padrão é `C:\Program Files\Tableau\Tableau Server`. Escolha um local diferente, incluindo uma unidade diferente, por meio de navegação ou digitação de um novo caminho.
    
    Se o prompt do Windows Defender Firewall for exibido, clique em Permitir acesso. Pode ser necessário fazer isso várias vezes para que a instalação seja concluída.
3. Clique em Próximo.
    
    ![Imagem da configuração que permite alterar o tipo de instalação](/tableau/current/pt-br/server/pt-br/Img/tsm-install-type.png)
    
    Na página Tipo de instalação do Server, também é onde você especifica se instalará o primeiro nó de uma instalação do Server ou nós adicionais em uma instalação de vários nós. Não é necessário alterar isso do padrão (Criar nova instalação do Tableau Server.) a menos que você esteja instalando um Tableau Server de vários nós. Se estiver instalando um Tableau Server de vários nós, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).
4. Clique em Próximo.
    
    ![Imagem da configuração que permite alterar o tipo de instalação](/tableau/current/pt-br/server/pt-br/Img/tsm-install-activation-type.png)
    
    Na página Tipo de ativação do produto, selecione se deseja usar o serviço ATR (Autorizado para execução) para ativar o Tableau Server e, em seguida, clique em Instalar.
5. Após a conclusão da instalação, clique em Concluir. O processo de instalação abrirá a página da Web de configuração do TSM no computador no qual ocorreu a instalação do Tableau Server.

## Etapa 2: ativar e registrar o Tableau Server

Antes de configurar o Tableau Server, é necessário ativar uma licença e registrar o produto. Para obter mais detalhes, consulte [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm).

1. [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Na página **Ativar**, insira ou cole a chave do produto e clique em **Ativar chave de produto**.
    
    Depois que a chave do produto é ativada, ela aparece sob **Chaves do produto ativadas**.
    
    ![Uma tela de ativação do Tableau Server, apresentando um campo para a entrada da chave de produto de licença de 20 caracteres.](/tableau/current/pt-br/server/pt-br/Img/install_01_activate.png)
3. Para ativar outra chave do produto, digite a nova chave do produto e clique em Ativar a chave do produto. Depois que a chave do produto é ativada, ela aparece sob Chaves do produto ativadas.
4. Quando terminar de ativar as chaves do produto, clique em Próximo.
    
    **Observação:** se as chaves do produto ativadas não tiverem a capacidade necessária, como não núcleos suficientes ou apenas uma chave de produto de função Viewer, o Tableau Services Manager exibirá a caixa de diálogo Licenças aplicadas insuficientes. Clique em Ativar outra chave do produto para adicionar outra chave do produto e aumentar a capacidade na instalação do Tableau Server.
    
    ![Uma notificação de que a ativação das chaves de produto para a implantação do Tableau Server é insuficiente.](/tableau/current/pt-br/server/pt-br/Img/install_01_insufficient_product_keys.png)
5. Na página Registrar, insira suas informações nos campos e clique em Registrar.
    
    ![Etapa de registro do assistente de ativação do Tableau Server, com campos obrigatórios para preencher informações de contato, informações da empresa e detalhes regionais.](/tableau/current/pt-br/server/pt-br/Img/install_02_register.png)

## Etapa 3: configurar o armazenamento de identidades local

É necessário configurar as definições de armazenamento de identidades. Esse procedimento simplifica a instalação ao definir o armazenamento de identidades para a autenticação local. Para obter mais detalhes sobre como personalizar esses padrões, consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

![Um formulário de configuração com configurações de instalação personalizáveis.](/tableau/current/pt-br/server/pt-br/Img/config_setup_default_win.png)

Após configurar as opções nesta página, clique em Inicializar.

O processo de inicialização pode levar alguns instantes. Quando a inicialização for concluída, a página a seguir será exibida:

![Caixa de diálogo de inicialização concluída com sucesso.](/tableau/current/pt-br/server/pt-br/Img/config_setup_initialize_complete.png)

## Etapa 4: adicionar conta de administrador

A etapa final na ativação do Tableau Server é adicionar a conta inicial de administrador. O administrador terá acesso completo ao servidor, incluindo a capacidade de gerenciar usuários, grupos e projetos. Obtenha mais detalhes em [Adicionar uma conta de administrador](https://help.tableau.com/current/server/pt-br/startup.htm).

Ao concluir a inicialização do Tableau Server, o programa de instalação exibirá uma página para criar o administrador do Tableau Server.

Especifique um nome e senha que deseja usar para a conta administrativa.

Se estiver instalando remotamente, é necessário fazer logon no TSM no computador onde o Tableau Server estiver instalando, ou você pode se conectar remotamente ao computador e executar o comando [initialuser](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#initialu) do tabcmd a partir de um shell.

Use a conta de administrador criada nesta etapa para acessar as páginas de administração na Web do Tableau Server. Consulte [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).

## Etapa 5: validar a instalação

Esta é uma etapa opcional. Contudo, uma boa maneira de validar a instalação do Tableau Server e garantir que esteja executando de forma adequada, é analisar as [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) inseridas no Tableau Server.

<!-- document id=966f128e74b40f071434e86eb04d3dfd06116363b371b5487004135006a32642 url=/tableau/current/pt-br/server/ssl_mutual_about.md -->

[Pular para o conteúdo principal](#main-content)

# Como a autenticação de SSL mútuo funciona

A autenticação do SSL mútuo (ou bidirecional) fornece uma combinação de fluxo de dados criptografados, autenticação mútua de servidor e cliente e a conveniência do acesso direto. Para usar o SSL mútuo com o Tableau Server, você precisa de:

- SSL externo configurado no Tableau Server.
- Um certificado SSL emitido pela CA confiável para o Tableau Server. O arquivo é uma concatenação de arquivos de certificação CA. Uma "CA" é uma _autoridade de certificação_ que emite certificados aos computadores clientes que se conectarão ao Tableau Server. A ação de upload do arquivo de certificado CA estabelece uma confiança, que permite ao Tableau Server autenticar os certificados individuais que são apresentados pelos computadores clientes.
- Um certificado em cada cliente que vai se conectar ao Tableau Server.
- Um Tableau Server configurado para usar SSL mútuo.

O Tableau Server e o cliente verificam se há um certificado válido, e o Tableau Server autentica o usuário, com base no nome de usuário no certificado do cliente.

A imagem a seguir mostra mais detalhes da sequência de eventos que ocorre com SSL mútuo.

![Um diagrama que mostra o processo de comunicação entre um usuário do Tableau Server e o Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/ssl_mutual02.png)

1. O usuário navega para o Tableau Server.
2. O Tableau Server envia seu certificado de SSL para o computador do cliente.
3. O computador do cliente verifica o certificado do Tableau Server.
4. O computador do cliente envia seu certificado para o Tableau Server.
5. Tableau Server verifica o certificado do cliente.
6. O Tableau Server faz referência ao nome de usuário no certificado do cliente para autenticar tal usuário.

<!-- document id=832ba82da2cba73bbe991625313721c6169c8975fe3fa04733ffad63be8df15f url=/tableau/current/pt-br/server/datasource_relationships_learnmorepage.md -->

[Pular para o conteúdo principal](#main-content)

# Como as relações diferem das uniões de colunas

As relações são uma forma dinâmica e flexível de combinar dados de várias tabelas para análises. Você não define tipos de união para relacionamento, portanto, não verá um diagrama de Venn ao criá-los.

Pense em uma relação como um contrato entre duas tabelas. Quando você está criando uma visualização com campos dessas tabelas, o Tableau traz dados dessas tabelas usando esse contrato para criar uma consulta com as uniões de colunas apropriadas.

- **Nenhum tipo de união de colunas antecipada**. Basta selecionar os campos correspondentes para definir um relacionamento ([nenhum tipo de união de colunas](#WhereAreJoins)). O Tableau primeiro tenta criar o relacionamento com base nas restrições de chave existentes e nomes de campo correspondentes. Em seguida, você pode verificar se eles são os campos que deseja usar ou adicionar mais pares de campo para definir melhor como as tabelas devem ser relacionadas.
- **Automático e com reconhecimento de contexto.** Os relacionamentos se diferem das uniões de colunas no que diz respeito ao tempo e ao contexto da análise. O Tableau seleciona automaticamente os tipos de união de colunas com base nos campos usados na visualização. Durante a análise, o Tableau ajusta os tipos de união de colunas de forma inteligente e preserva o nível nativo de detalhe nos dados. É possível ver as agregações no nível de detalhes dos campos da visualização, em vez de ter que pensar sobre as uniões subjacentes. Você não precisa usar expressões LOD, como FIXED, para deduplicar dados em tabelas relacionadas.
- **Flexível**. Os relacionamentos podem ser de muitos para muitos e compatíveis com uniões de colunas externas completas. Ao combinar tabelas usando relacionamentos, é como criar uma fonte de dados personalizada e flexível para cada visualização, tudo em uma única fonte de dados da pasta de trabalho. Como o Tableau consulta apenas tabelas necessárias com base em campos e filtros em uma visualização, você pode construir uma fonte de dados que pode ser usada para uma variedade de fluxos de analise.

Para obter mais informações, consulte [Relacionar os dados](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm) e [Não tenha medo de relacionamentos.](https://help.tableau.com/current/pro/desktop/pt-br/datasource_dont_be_scared.htm)

> [!TIP]
> 
> **As uniões de colunas ainda estão disponíveis como opção para combinar os dados**. Clique duas vezes em uma tabela lógica para acessar a tela de união de colunas. Para obter mais informações, consulte [Para onde foram as uniões de colunas?](#WhereAreJoins)

**Assista a um vídeo**: para obter uma introdução ao uso de relações no Tableau, assista a este vídeo de 5 minutos.

**Observação** : a interface para edição de relacionamentos mostrada neste vídeo pode ser um pouco diferente da versão atual, mas tem a mesma funcionalidade.

Veja também podcasts de vídeo sobre relacionamentos em [Análises de ação](https://action-analytics.com/library/), como [Por que o Tableau inventou os relacionamentos?](https://action-analytics.com/ep-1-why-did-tableau-invent-relationships/) Clique em "Podcast de vídeo" na [Biblioteca](https://action-analytics.com/library/) para ver mais.

Para obter informações relacionadas sobre como as consultas de relação funcionam, consulte essas publicações no blog do Tableau:

- [Relações, parte 1: apresentação da nova modelagem de dados no Tableau](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)
- [Relações, parte 2: dicas e truques](https://www.tableau.com/about/blog/2020/5/relationships-part-2-tips-and-tricks)
- [Relações, parte 3: fazer perguntas em várias tabelas relacionadas](https://www.tableau.com/about/blog/2020/6/relationships-part-3-asking-questions-across-multiple-related-tables)

## Características das relacionamentos e uniões de colunas

As relações são uma forma dinâmica e flexível de combinar dados de várias tabelas para análises. Recomenda-se o uso de relacionamentos como uma primeira abordagem para combinar os dados, pois isso torna a preparação e a análise de dados mais fáceis e intuitivas. [Usar as uniões somente quando você realmente precisar](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel_faq.htm#can-i-use-joins-between-logical-tables).

Aqui estão algumas vantagens de usar relacionamentos para combinar tabelas:

- Facilitam a definição, alteração e reutilização da fonte de dados.
- Facilitar a análise de dados em várias tabelas no nível correto de detalhes (LOD).
- Não exige o uso de expressões LOD ou cálculos LOD para análise em diferentes níveis de detalhes.
- Apenas consulta dados de tabelas com campos usados na visualização atual.

### Relações

- São exibidos como noodles flexíveis entre tabelas lógicas
- Requer a seleção de campos correspondentes entre duas tabelas lógicas
- Não requer que selecione tipos de união
- Disponibilize todos os dados de linha e coluna de tabelas relacionadas na fonte de dados
- Mantenha o nível de detalhe de cada tabela na fonte de dados e durante a análise
- Criam domínios independentes em vários níveis de detalhe. As tabelas não são mescladas na fonte de dados.
- Durante a análise, crie as uniões apropriadas automaticamente, com base nos campos em uso.
- Não duplique valores agregados (quando as Opções de desempenho são definidas como Muitos para Muitos)
- Mantenha valores de medida incompatíveis (quando as Opções de desempenho forem definidas como Alguns registros correspondem)

### Uniões de colunas

As uniões são uma maneira mais estática de combinar dados. As uniões devem ser definidas entre tabelas físicas antes da análise, e não podem ser alteradas sem afetar todas as planilhas usando essa fonte de dados. As tabelas unidas são sempre mescladas em uma única tabela. Como resultado, às vezes os dados unidos faltam valores incompatíveis ou duplica valores agregados.

- São exibidos com ícones do diagrama de Venn entre tabelas físicas
- Exigem que você selecione os tipos de união de colunas e as cláusulas de união
- As tabelas físicas com união de colunas são mescladas em uma única tabela lógica, com uma combinação fixa de dados
- Pode soltar valores de medidas incompatíveis
- Pode duplicar valores de agregação quando os campos estiverem em diferentes níveis de detalhe
- Cenários de suporte que exigem uma única tabela de dados, como filtros de extração e agregação

## Requisitos para uso de relacionamento

- Ao relacionar tabelas, os campos que definem as relações devem ter o mesmo tipo de dados. Alterar o tipo de dados na página Fonte de dados não altera esse requisito. O Tableau ainda usará o tipo de dados no banco de dados subjacente para consultas.
- Não é possível definir relações com base em campos geográficos.
- Relações circulares não são aceitos no modelo de dados.
- Não é possível definir relações entre fontes de dados publicadas.

### Fatores que limitam os benefícios do uso de tabelas relacionadas

- Dados sujos em tabelas (ou seja, tabelas que não foram criadas com um modelo bem estruturado em mente e contêm uma mistura de medidas e dimensões em várias tabelas) podem tornar a análise de várias tabelas mais complexa.
- O uso de filtros da fonte de dados limitará a capacidade de o Tableau fazer a separação de união nos dados. A separação de união é um termo que se refere ao modo como o Tableau simplifica as consultas, removendo uniões de colunas desnecessárias.
- Tabelas com muitos valores sem correspondência entre relações.
- Nas versões 2020.2 a 2024.1: interrelacionar várias tabelas de fatos com várias tabelas de dimensão (tentando modelar dimensões compartilhadas ou em conformidade). Na versão 2024.2 e posterior, você pode usar relações multifatoriais para resolver esses casos. Para obter mais informações, consulte [Análise de vários fatores com relações](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel.htm#multifact-análise) e [Sobre modelos de dados de relações de vários fatores](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm).

## Para onde foram as uniões de colunas?

Você ainda pode especificar as uniões de colunas entre tabelas na camada física de uma fonte de dados. Clique duas vezes em uma tabela lógica para acessar a tela Uniões de colunas/União de linhas na camada física e adicionar uniões de colunas ou de linhas.

Cada tabela lógica de nível superior contém pelo menos uma tabela física. Abra uma tabela lógica para exibir, editar ou criar uniões de colunas entre as tabelas físicas. Clique com o botão direito do mouse em uma tabela lógica e, em seguida, clique em Abrir. Ou basta clicar duas vezes na tabela para abri-la.

![Modelo de dados com duas uniões.](/tableau/current/pt-br/server/pt-br/Img/data_model_singletable_joins.gif)

Quando você cria uma fonte de dados, ela tem duas camadas. A camada de nível superior é a camada lógica da fonte de dados. Você combina os dados entre tabelas na camada lógica usando as relações.

A próxima camada é a camada física da fonte de dados. Você combina os dados entre tabelas na camada física usando as uniões de colunas. Para obter mais informações, consulte [Tabelas lógicas e físicas no modelo de dados](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel.htm).

![Um diagrama de modelo de dados exibe uma camada lógica com duas tabelas vinculadas por uma relação, e uma camada física que ilustra como as tabelas lógicas são construídas a partir de tabelas físicas.](/tableau/current/pt-br/server/pt-br/Img/data_model_layers_sm.png)

<!-- document id=29f0cbd8553facbad9855928cd0813b2bab6745c33ca7ff05b14549b664e1dc1 url=/tableau/current/pt-br/server/ssl_config_postgres.md -->

[Pular para o conteúdo principal](#main-content)

# Como configurar o SSL para comunicação interna com o Postgres

É possível configurar o Tableau Server para usar SSL (TLS) na comunicação criptografada entre o repositório do Postgres e outros componentes do servidor. Por padrão, a comunicação que está interna com os componentes do Tableau Server não é criptografada.

Enquanto habilita o suporte para o SSL interno, também é possível configurar o suporte para conexões diretas com o repositório dos clientes do Tableau, como o Tableau Desktop, o Tableau Mobile e os navegadores de Web da REST API.

**Observação:** a partir da versão 2026.2.0, você pode usar certificados personalizados para comunicação Postgres. Quando os certificados personalizados estão habilitados para Postgres, você não pode usar a interface do usuário do TSM para fazer alterações. Para ativar certificados personalizados, você precisa usar a linha de comando do TSM. Para obter detalhes sobre como habilitar certificados de repositório personalizados, consulte [tsm security repository-ssl enable](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#postres-ssl-enable).

1. Como administrador do servidor, abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Na guia Configuração, selecione Segurança > Repositório SSL.
    
    ![Captura de tela das configurações do Repositório SSL do TSM](/tableau/current/pt-br/server/pt-br/Img/postgres-ssl-config.png "Captura de tela das configurações do Repositório SSL do TSM")
3. Selecione uma das opções para usar o repositório SSL.
    
    - Necessário para todas as conexões—usa o SSL para comunicação interna do Tableau Server, e requer SSL para clientes do Tableau e qualquer cliente externo (não Tableau) que se conecta diretamente ao repositório, incluindo aqueles que usam o usuário **tableau** ou **readonly**.
        
        **Importante:** a menos que você conclua as etapas em [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm), para colocar os arquivos de certificado no local correto nos computadores clientes, clientes Tableau e clientes postgres externos não poderão validar a identidade do repositório do Tableau comparando certificados nos computadores cliente com o certificado SSL do computador do repositório.
    - Opcional para conexões do usuário— Quando ativado, o Tableau usa o SSL para comunicação interna do Tableau Server e suporta, mas não requer, SSL para conexões diretas ao servidor dos clientes Tableau e clientes externos.
    - Desativado para todas as conexões (padrão)—a comunicação interna do servidor não é codificada e o SSL não é necessário para conexões diretas dos clientes.
4. Clique em OK.
    
    As duas primeiras opções geram arquivos de certificado do servidor, **server.crt** e server.key, e os coloca no local a seguir:
    
    `C:/ProgramData/Tableau/Tableau Server/data/tabsvc/config/pgsql<version>/security`
    
    Use este arquivo .crt se precisar configurar clientes para conexões diretas.

Para habilitar o SSL para tráfego interno entre os componentes do servidor, execute os seguintes comandos:

`tsm security repository-ssl enable`

`tsm pending-changes apply`

### O que o comando faz

O comando `repository-ssl enable` gera arquivos de certificado do servidor, o qual ele coloca no local a seguir:

`C:/ProgramData/Tableau/Tableau Server/data/tabsvc/config/pgsql<version>/security`

Por padrão, esse comando define o Tableau Server para exigir SSL para tráfego entre o repositório e outros componentes do servidor, assim como para conexões diretas dos clientes do Tableau (para conexões por meio dos usuários **tableau** ou **readonly**).

Para concluir a configuração, execute as etapas descritas em [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm) para colocar os arquivos de certificado no local adequado nos computadores de cliente.

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

### Opção para habilitar o repository-ssl

Se deseja solicitar o SSL apenas para comunicação interna do Tableau Server, não para conexões diretas de aplicativos do cliente, use a opção a seguir com o comando `repository-ssl enable`:

`--internal-only`

### Ambientes do cluster

Ao executar o `repository-ssl enable` em um nó de um cluster, ele copiará o arquivo de certificado necessário para a mesma localização em cada nó.

Para obter mais informações sobre como baixar o certificado público para conexões diretas, consulte [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm).

<!-- document id=93cea4731fc7328f6d72408bdd9b5c8b77ba2f52779fa6b422c0292f50ef275e url=/tableau/current/pt-br/server/extracting_upgrade.md -->

[Pular para o conteúdo principal](#main-content)

# Atualização de extrações para o formato .hyper

Na versão 2018 do Tableau, introduzimos o formato `.hyper` para que as extrações do Tableau substituam o antigo formato `.tde`. O formato `.hyper` tem sido o padrão usado pelo Tableau para criar extrações desde 2018, e a grande maioria das extrações agora são arquivos `.hyper`. Desde o início de 2023, a Tableau descontinuou o suporte para o formato `.tde` no Tableau Cloud e Tableau Public. Para obter mais detalhes sobre obsoleto, consulte esta [postagem da Comunidade do Tableau](https://community.tableau.com/s/feed/0D54T00001BHiGwSAL).

## Descontinuação do suporte para arquivos .tde

A partir de 2023, o formato `.tde` para extrações do Tableau ficou obsoleto. Esse formato foi substituído pelo `.hyper` em 2018, mas continuou válido para arquivos enviados até março de 2023.

- Essa alteração ocorreu no Tableau Cloud e no Tableau Public a partir de março de 2023.
- A partir da versão 2023.1.0 do Tableau Server, o carregamento de arquivos de formato `.tde` é desabilitado.
- 2024.2 é a última versão do Tableau Desktop compatível com pastas de trabalho, fontes de dados ou marcadores baseados em .tde. As versões 2024.3 e posteriores suportam apenas o formato .hyper.

## Atualize manualmente sua extração .tde usando o Tableau Desktop

Ao gerenciar as extrações localmente, é possível atualizar manualmente uma extração `.tde` para `.hyper` usando o Tableau Desktop.

**Observação**: essa funcionalidade está disponível apenas nas versões do Tableau Desktop anteriores a 2024.2.

1. No Tableau Desktop, abra uma pasta de trabalho que use uma extração `.tde`.
2. Selecione a fonte de dados da extração no menu Dados e depois selecione Extração > Atualizar.
3. Selecione Arquivo > Salvar, que salva a pasta de trabalho e conclui a atualização da extração.

<!-- document id=53128ad8a5bf6de6b773cbefccde524bcdc2fde5618e714e9fae4c642312e192 url=/tableau/current/pt-br/server/openid_auth_signing_in.md -->

[Pular para o conteúdo principal](#main-content)

# Como fazer logon no Tableau Server usando o OpenID Connect

Este tópico fornece informações sobre o logon no Tableau Server com o OpenID Connect. Os tópicos a seguir fornecem informações sobre a configuração e uso do OpenID Connect com o Tableau Server.

- [OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth.htm)
- [Configurar o provedor de identidades para o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_idp_config.htm)
- [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm)
- Como fazer logon no Tableau Server usando o OpenID Connect (você está aqui)

## Como fazer logon usando o OpenID Connect

Depois que o Tableau Server é configurado para usar o OpenID Connect, os usuários que acessam o servidor e ainda não fizeram logon são redirecionados ao site do IdP, onde são solicitados a fazer logon. Os usuários inserem as credenciais do IdP. Em muitos casos, o usuário também é solicitado a autorizar que o IdP compartilhe as informações do Tableau Server, conforme o exemplo a seguir:

![Formulário do Google para permitir ou negar acesso.](/tableau/current/pt-br/server/pt-br/Img/Google-grant-access-db.png)

Quando o usuário efetua logon ao usar o OpenID Connect, o IdP envia um identificador de usuário exclusivo (conhecido no OpenID como o subvalor), como parte das informações redirecionadas ao Tableau Server. Este subvalor é associado à identidade do usuário do Tableau.

## Restrição de logon a administradores de servidor para ferramentas de linha de comando

As ferramentas da linha de comando para trabalhar com o Tableau Server (`tabcmd`, TSM e `tableau.com`) não oferecem suporte de logon com o OpenID Connect. Quando o OpenID Connect é habilitado para o servidor, essas ferramentas exigem o logon com o nome de usuário e a senha do Tableau Server.

Mesmo que os usuários normalmente sejam autenticados com o OpenID Connect, cada um tem um nome de usuário e senha do Tableau Server. Isso significa que os usuários podem usar as ferramentas de linha de comando, como `tabcmd`. Como medida de segurança, você pode garantir que _somente_ os administradores do sistema possam usar as ferramentas de linha de comando. Para fazer isso, use `tsm configuration set` para definir `wgserver.authentication.restricted` como `true`. Quando esta configuração for `true`, somente os administradores de servidor poderão fazer logon no Tableau Server com nome de usuário e senha; todos os outros usuários _deverão_ entrar no servidor com a opção de logon único (SSO), como o OpenID Connect. O efeito é que os usuários não administradores também não poderão usar as ferramentas da linha de comando. Para fazer essa alteração, execute a sequência de comandos TSM a seguir:

tsm configuration set -k wgserver.authentication.restricted -v true

tsm pending-changes apply

<!-- document id=d10793631b9043b1c2257a5b71d9619afdd844f350fc8b6804b04b1c9f449912 url=/tableau/current/pt-br/server/server-upgrade-how-upgrade-works.md -->

[Pular para o conteúdo principal](#main-content)

# Como funciona a atualização do Tableau Server

Ao atualizar do Tableau Server 2018.2 ou posterior, não desinstale a versão anterior. O processo de atualização é projetado para instalar uma nova versão lado a lado com a versão existente e, em seguida, alternar da versão anterior para a posterior.

Ao executar uma atualização de TSM para TSM (versão 2018.2.x para uma posterior), você deve deixar a versão existente ativa e funcionando até pouco antes da atualização, usando o script de atualização. Se você desinstalar a versão existente antes de atualizar, não será possível executar a atualização. Para os usuários finais, isso tem o impacto de reduzir o tempo de inatividade, pois a nova versão é instalada enquanto a existente está em execução. O único momento em que o servidor não está em execução é quando o script de atualização realmente está atualizando para a nova versão.

Depois de instalar a nova versão e atualizar, você poderá desinstalar a versão anterior quando optar por fazê-lo. Você pode deixar a versão mais antiga instalada indefinidamente, embora um dos motivos para a desinstalação seja liberar o espaço em disco usado por arquivos específicos da versão anterior. Para entender a diferença entre desinstalar o Tableau Server e remover todos os aspectos do Tableau Server completamente, consulte [Desinstalar o Tableau Server](https://help.tableau.com/current/server/pt-br/uninstall_server.htm).

A atualização do Tableau Server requer interromper e iniciar o servidor como parte do processo de atualização. Durante essa interrupção/reinicialização, o Tableau Server estará indisponível.

<!-- document id=94722b1bc2005d30bf827caba1707d92efce1261fb76588e8e1a668c39a3c7ce url=/tableau/current/pt-br/server/impers_how.md -->

[Pular para o conteúdo principal](#main-content)

# Como funciona a representação

Veja uma ilustração de como funciona a representação do usuário do banco de dados:

![Um diagrama que ilustra como o Tableau Server e o SQL Server interagem para representar visualizadores de pastas de trabalho.](/tableau/current/pt-br/server/pt-br/Img/impersonate.png)

Na ilustração acima, Jane Smith (MyCo\\jsmith) é uma representante de vendas da Costa Oeste e Henry Wilson (MyCo\\hwilson) cobre a Leste. No banco de dados do SQL Server, as permissões da conta de Jane, MyCo\\jsmith, fornecem apenas acesso ao dados da Costa Oeste. A conta de Henry, MyCo\\hwilson, pode acessar apenas os dados da Costa Leste.

Uma exibição foi criada, mostrando dados do país inteiro. Ela tem um conexão ativa com um banco de dados do SQL Server. Ambos os usuários entram no Tableau Server e clicam na exibição. O Tableau Server se conecta ao SQL Server usando uma conta de banco de dados com a permissão IMPERSONATE para a conta de banco de dados de cada usuário. Essa conta atua em nome da conta de banco de dados de cada usuário.

Quando a exibição é mostrada, ela é restringida pelas permissões de banco de dados individuais de cada usuário. Jane vê somente os dados de vendas da Costa Oeste; Henry vê apenas os dados da Costa Leste.

<!-- document id=43556a173955b99627948e045a96bb60f792c56387b791d167aaae206058a8a9 url=/tableau/current/pt-br/server/explain_data_explained.md -->

[Pular para o conteúdo principal](#main-content)

# Como funciona o Explique os dados

Use o Explique os dados como um ponto de partida incremental para explorar ainda mais seus dados. As possíveis explicações geradas ajudam a ver os diferentes valores que compõem ou estão relacionados com as marcas analisadas em uma exibição. Podem informar sobre as características dos pontos de dados na fonte de dados e como os dados podem estar relacionados (correlações) usando modelagem estatística. Essas explicações oferecem outra ferramenta para inspecionar dados e encontrar pistas interessantes sobre o que explorar a seguir.

**Observação**: o Explique os dados é uma ferramenta que revela e descreve os relacionamentos dos seus dados. Não é possível dizer o que está causando os relacionamentos ou como interpretar os dados. **Você é o especialista em seus dados.** O conhecimento de domínio e a intuição são fundamentais para ajudar a decidir quais características podem ser interessantes para explorar ainda mais, usando diferentes exibições.

Para obter informações relacionadas sobre como funciona o Explique os dados e como usá-lo para incrementar sua análise, consulte estas apresentações da Conferência do Tableau:

- [From Analyst to Statistician: Explain Data in Practice (1 hour) \[De Analista a Estatístico: o Explique os dados na prática (1 hora)\]](https://www.tableau.com/pt-br/events/tc/2019/analyst-statistician-explain-data-practice)
- [Leveraging Explain Data (45 minutes) \[Uso do Explique os dados (45 minutos)\]](https://www.tableau.com/pt-br/events/tc/2019/leveraging-explain-data)

## O que é o Explique os dados (ou não)

O Explique os dados é:

- Uma ferramenta e um fluxo de trabalho que aproveitam sua experiência sobre o domínio.
- Uma ferramenta que mostra relacionamentos em seus dados e recomenda o local para pesquisa.
- Uma ferramenta e um fluxo de trabalho que ajudam a agilizar a análise de dados e torná-la mais acessível a uma gama mais ampla de usuários.

O Explique os dados não é:

- Uma ferramenta de teste estatístico.
- Uma ferramenta para provar ou rejeitar hipóteses.
- Uma ferramenta que fornece uma resposta ou informa sobre qualquer causalidade nos seus dados.

Ao executar o Explique os dados nas marcas, tenha em mente os seguintes pontos:

- **Use dados granulares que possam ser agregados**. Esse recurso foi criado explicitamente para a análise de dados agregados. Significa que os dados devem ser granulares, mas as marcas selecionadas para Explique os dados devem ser agregadas ou resumidas mais detalhadamente. O Explique os dados não pode ser executado em marcas desagregadas (dados brutos) com nível de detalhe mais granular.
- **Considere a forma, o tamanho e a cardinalidade dos dados**. Embora possa ser usado com conjuntos de dados menores, o Explique os dados requer dados suficientemente amplos e contém marcas suficientes (granularidade) para criar um modelo.
- **Não presuma causalidade**. A correlação não é causa. As explicações são baseadas em modelos dos dados, mas não são explicações causais.
    
    Uma correlação significa que existe uma relação entre algumas variáveis de dados, digamos A e B. Não é possível afirmar apenas ao ver a relação nos dados que A está causando B, se B está causando A, ou se algo mais complicado está realmente acontecendo. Os padrões de dados são exatamente os mesmos em cada um desses casos e um algoritmo não pode dizer a diferença entre cada caso. Só porque duas variáveis parecem mudar, não significa necessariamente que uma causa a alteração na outra. Um terceiro fator pode estar fazendo com que ambas sejam alteradas, ou pode ser uma coincidência e pode não haver nenhuma relação causal.
    
    No entanto, você pode ter conhecimento extra que não está nos dados, que o ajuda a identificar o que está acontecendo. Um tipo comum de conhecimento extra seria uma situação em que os dados foram coletados em um experimento. Se você sabe que B foi escolhido por sorte, qualquer padrão consistente de diferença em A (que não seja apenas ruído aleatório) deve ser causado por B. Para obter uma descrição mais detalhada desses conceitos, consulte o artigo [Inferência causal em economia e marketing](https://www.pnas.org/content/pnas/113/27/7310.full.pdf) por Hal Varian.

## Como as explicações são analisadas e avaliadas

O Explique os dados executa uma análise estatística em um painel ou planilha para localizar marcas discrepantes ou especificamente em uma marca selecionada. A análise também considera pontos de dados possivelmente relacionados da fonte de dados que não estão representados na exibição atual.

Primeiramente, o Explique os dados prevê o valor de uma marca usando apenas os dados presentes na visualização. Em seguida, os dados que estão na fonte de dados (mas não na exibição atual) são considerados e adicionados ao modelo. O modelo determina o intervalo de valores previstos da marca, que está dentro de um desvio padrão do valor previsto.

### Qual é o intervalo esperado?

O valor esperado de uma marca é o valor mediano na faixa de valores esperada nos dados subjacentes em sua visualização. O intervalo esperado é o intervalo de valores entre o 15º e o 85º percentil que o modelo estatístico prevê para a marca analisada. O Tableau determina o intervalo esperado sempre que executa uma análise estatística em uma marca selecionada.

As possíveis explicações são avaliadas quanto à capacidade explicativa usando a modelagem estatística. Para cada explicação, o Tableau compara o valor esperado com o valor real.

| value | Descrição |
| --- | --- |
| Acima do esperado/Abaixo do esperado | Se um resumo de valor esperado indicar que a marca é _menor do que o esperado_ ou _maior do que o esperado_, significa que o valor agregado da marca está fora do intervalo de valores previstos no modelo estatístico da marca. Se um resumo de valor esperado indicar que a marca é _um pouco menor_ ou _pouco maior_ que o esperado, _mas , está dentro do intervalo de natural variação_, significa que o valor agregado da marca está dentro do intervalo de valores previstos da marca, mas é menor ou maior nesse intervalo de valores. |
| Valor esperado | Se uma marca tiver um valor esperado, significa que seu valor está dentro do intervalo esperado de valores que um modelo estatístico está prevendo para a marca. |
| Variação aleatória | Quando a marca analisada tem um número baixo de registros, pode não haver dados suficientes disponíveis para Explique os dados formarem uma explicação estatisticamente significativa. Se o valor da marca estiver fora do intervalo esperado, o Explique os dados não pode determinar se esse valor inesperado está sendo causado por variação aleatória ou por uma diferença significativa nos registros subjacentes. |
| Sem explicação | Quando o valor da marca analisada está fora do intervalo esperado e não se ajusta a um modelo estatístico usado para Explique os dados, nenhuma explicação é gerada. |

### Modelos usados para análise

O Explique os dados cria modelos dos dados em uma exibição para prever o valor de uma marca e em seguida, determina se uma marca é maior ou menor que o esperado de acordo com o modelo. Em seguida, ele considera informações adicionais, como a inclusão de colunas adicionais da fonte de dados na exibição ou a sinalização de exceções do registro, como explicações potenciais. Para cada explicação potencial, o Explique os dados se ajusta a um novo modelo e avalia se a marca é inesperada de acordo com as novas informações. As explicações são classificadas compensando a complexidade (quantas informações são adicionadas pela fonte de dados) em relação ao volume de variabilidade que precisa ser explicada. Melhores explicações são mais simples do que a variação que elas explicam.

<table class="table--stripes" style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 25%;"><col style="width: 75%;"></colgroup><thead><tr><th>Tipo de explicação</th><th>Avaliação</th></tr></thead><tbody><tr><td><p><b>Valores extremos</b></p></td><td><p>Os valores extremos são marcas agregadas que são exceções com base em um modelo das marcas visualizadas. A marca selecionada é considerada como contendo um valor extremo se um valor de registro estiver nos extremos dos valores previstos da distribuição para os dados.</p><p>Um valor extremo é determinado comparando a marca agregada com e sem o valor extremo. Se uma marca se tornar menos surpreendente ao eliminar esse valor, ela recebe uma pontuação mais alta.</p><p>Quando uma marca tem valores extremos, não significa que sejam valores atípicos, ou que você deve excluir esses registros da exibição. Esta escolha é sua, dependendo da sua análise. A explicação simplesmente aponta um valor extremo interessante na marca. Por exemplo, pode revelar um valor com digitação incorreta em um registro em que um custo da banana seja de 10 dólares em vez de 10 centavos. Ou pode revelar que um determinado vendedor tenha tido um bom trimestre.</p></td></tr><tr><td><p><b>Número de registros</b></p></td><td><p>A explicação do número de registros modela a soma agregada em termos da contagem agregada; o valor médio dos registros o modela em termos da média agregada. Quanto melhor o modelo explicar a soma, maior será a pontuação.</p><p>Essa explicação descreve se a soma é interessante porque a contagem está alta ou baixa ou porque a média é alta ou baixa.</p></td></tr><tr><td><p><b>Valor médio da marca</b></p></td><td><p>Esse tipo de explicação é usado para marcas agregadas que são somas. Explica se a marca é consistente com as outras marcas, porque em termos de sua contagem agregada ou média, observando a relação SUM(X) = COUNT(X) * AVG(X).</p><p>Essa explicação descreve se a soma é interessante porque a contagem está alta ou baixa ou porque a média é alta ou baixa.</p></td></tr><tr><td><p><b>Dimensões contribuintes</b></p></td><td><p>Esta explicação modela a medida-alvo da marca analisada em termos da repartição entre as categorias da dimensão não visualizada. A análise equilibra a complexidade do modelo com a forma como a marca é explicada.</p><p>Uma <i>dimensão oculta</i> é uma dimensão que existe na fonte de dados, mas não está sendo usada na exibição. Esse tipo de explicação é usado para somas, contagens e médias.</p><p>O modelo para dimensões ocultas é criado dividindo as marcas de acordo com os valores categorizados da coluna explicativa e criando um modelo com o valor que inclui todos os pontos de dados na visualização da fonte. Para cada linha, o modelo tenta recuperar cada um dos componentes individuais que fizeram cada marca. A análise indica se o modelo prevê melhor a marca quando os componentes correspondentes à dimensão não visualizada são modelados e, em seguida, aumentados, em vez de usar um modelo em que os valores da dimensão não visualizada não são conhecidos.</p><p>As explicações de dimensão agregada exploram se os valores de marca podem ser explicados corretamente, sem condições. Em seguida, as condições do modelo nos valores para cada coluna que é uma explicação potencial. As condições na distribuição de uma coluna explicativa devem resultar em uma previsão melhor.</p></td></tr><tr><td><p><b>Medidas contribuintes</b></p></td><td><p>Essa explicação modela a marca em termos dessa medida não visualizada, agregada à sua média nas dimensões visualizadas. Uma medição não <i>visualizada é uma medida</i> que existe na fonte de dados, mas não está sendo usada na exibição.</p><p>A explicação de Medidas contribuintes pode revelar uma relação linear ou quadrática entre a medida não visualizada e a medida de destino.</p></td></tr></tbody></table>

<!-- document id=232e27997e4cb0b09034dee087944598812eb2423de6d50c0d68b48aa1c5c346 url=/tableau/current/pt-br/server/task_prioritization.md -->

[Pular para o conteúdo principal](#main-content)

# Como os Trabalhos do servidor agendados são priorizados

## Trabalhos e tarefas

No Tableau Server, os usuários podem agendar atualizações de extração, assinaturas ou fluxos para serem executados periodicamente. Esses **itens agendados** são chamados de **tarefas**. O processo do Processador em segundo plano inicia instâncias exclusivas dessas tarefas para executá-las no horário agendado. As **instâncias exclusivas das tarefas** iniciadas como resultado são chamadas de **trabalhos**. Os**trabalhos** também são criados para execuções iniciadas **manualmente**, clicando na opção **Executar agora** .

Por exemplo, uma tarefa de atualização de extração é criada para ser executada diariamente às 9:00. Essa é uma tarefa de atualização de extração e, todos os dias às 9:00, um trabalho será criado para o Processador em segundo plano executar.

Você pode atribuir um número de prioridade a Tarefas e Agendas, usando valores de 1 a 100. Quanto menor o número, maior a prioridade, 1 é a maior prioridade e 100 é a menor.

## Regras prioritárias para trabalhos

Ao processar atualizações de extração agendadas, assinaturas e execuções de fluxo, o Tableau Server prioriza os trabalhos em segundo plano nesta ordem:

1. Qualquer trabalho que já estiver em progresso será concluído primeiro.
2. Qualquer tarefa ou agenda iniciada manualmente com Executar agora será iniciada quando o próximo processo do processador em segundo plano se tornar disponível. As tarefas de fluxo e agendas são exceções a essa regra. As execuções de fluxo usam a prioridade da tarefa atribuída para determinar a ordem em que devem ser executadas. Se não houver prioridade de tarefa atribuída, o padrão será 0, que é a prioridade mais alta.
    
    Observação: saiba mais sobre restringir as configurações de Executar agora- [Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm).
3. Os trabalhos com a maior prioridade (o número mais baixo) começam em seguida, independentemente de quanto tempo eles estiveram na fila.
    
    Para atualizações de extração e fluxos, esta é a prioridade da tarefa. A prioridade da tarefa é herdada da prioridade da agenda quando a tarefa é criada pela primeira vez. A prioridade de tarefa pode ser alterada posteriormente, mas a prioridade da tarefa retorna ao valor padrão quando a fonte de dados é republicada.
    
    Para assinaturas, esta é a prioridade da agenda. Se você ativou agendas personalizadas para assinaturas, a prioridade desses trabalhos será definida como 50.
    
    Por exemplo, um trabalho com uma prioridade 20 será executado antes de um trabalho com prioridade 50, mesmo se o segundo trabalho tiver aguardado mais tempo. Para alterar a prioridade da tarefa, consulte [Criar ou modificar uma agenda](https://help.tableau.com/current/server/pt-br/schedule_manage_create.htm).
4. Os trabalhos com a mesma prioridade são executados na ordem que foram adicionados à fila. O primeiro trabalho adicionado à fila é iniciado primeiro, em seguida, o segundo trabalho é iniciado.
5. Quando vários trabalhos de prioridade equivalente forem agendados para execução ao mesmo tempo, eles começam na ordem em que foram criados ou habilitados. Os trabalhos agendados para o mesmo horário são executados por tipo de tarefa e a categoria mais rápida de trabalhos começa primeiro: execuções de fluxo, seguidas de alertas orientados por dados, seguidos de trabalhos do sistema, seguidos de assinaturas, seguidas de criações de extração, seguidas de extrações incrementais e depois extrações completas.
    
    Os fluxos programados para execução, como parte de uma tarefa vinculada, recebem a mesma prioridade e são executados na ordem em que são definidos na tarefa vinculada. Para obter mais informações sobre tarefas vinculadas, consulte [Agendar tarefas vinculadas](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm#linked_tasks).
6. Como última medida de desempate, o processador em segundo plano usa o tempo histórico de execução. Os trabalhos que foram mais rápidos nas execuções anteriores, serão priorizados em relação aos que levaram mais tempo historicamente.

**Observação:** definir limites de recursos do backgrounder em um site específico terá uma fila adicional, pois esses trabalhos são selecionados após outros trabalhos de prioridade mais alta. Para obter detalhes, consulte [Limites de recursos do Processador em segundo plano do Tableau Server](https://help.tableau.com/current/server/pt-br/server-backgrounder-resource-limits.htm).

As seguintes limitações também impactam o momento de execução dos trabalhos:

- O número de trabalhos simultâneos é limitado ao número de processos em segundo plano configurados para o Tableau Server.
- Atualizações separadas para a mesma extração ou fontes de dados não podem ser executadas ao mesmo tempo.
- Os trabalhos associados a uma agenda configurada para executar em série, um por vez.

<!-- document id=511ff6591aaa22720d5f7a5d000dabfa468df441b0bf89d77e14cda2ac1b827e url=/tableau/current/pt-br/server/plan_network.md -->

[Pular para o conteúdo principal](#main-content)

# Como se comunicar com a Internet

Na maioria das empresas, o Tableau Server precisa se comunicar com a Internet. O Tableau Server foi projetado para operar dentro de uma rede interna protegida. Não configure o Tableau Server diretamente na Internet ou em um DMZ. Em vez disso, a comunicação entre a rede e a Internet deve ser mediada com servidores proxy. Se o computador que executa o Tableau Server não consegue acessar a Internet diretamente, é necessário implantar servidores proxy de encaminhamento para mediar o tráfego de dentro da rede aos destinos na Internet. O Tableau Server não oferece suporte à autenticação de proxy manual ou de passagem.

Para o tráfego de entrada, recomendamos a execução do Tableau Server por meio de servidores proxy reversos.

## Como o Tableau se comunica com a Internet

O Tableau Server precisa de acesso de saída para a Internet nestes cenários:

- Trabalho com mapas. O Tableau usa dados de mapa que são hospedados externamente.
    
    O Tableau Server precisa se conectar aos seguintes locais de Internet com a porta 443 para usar mapas:
    
    - mapsconfig.tableau.com
    - api.mapbox.com
    
    Se ele não conseguir fazer essas conexões, os mapas não carregarão.
    
    Teste a conectividade ao acessar cada um destes endereços em um navegador: [`https://mapsconfig.tableau.com/v1/config.json`](https://mapsconfig.tableau.com/v1/config.json) e [`https://api.mapbox.com/`](https://api.mapbox.com/) o solicitará a baixar um arquivo json.
    
    Se você usar um proxy para se conectar à Internet e não conseguir se conectar a `api.mapbox.com`, consulte [Trabalho com firewalls](https://docs.mapbox.com/help/troubleshooting/firewalls/) no site da Mapbox.
    
    Para o Tableau Server versão 2019.1 e anterior, consulte a documentação da sua versão: [Ajuda do Tableau](https://www.tableau.com/pt-br/support/help)
- Como conectar-se ao servidor de send-logs do Tableau.
    
    É possível fazer upload de arquivos de registro para o Tableau ao trabalhar com o Suporte. Consulte [`tsm maintenance send-logs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmSendLogs). Para fazer upload de arquivos com sucesso para o Tableau, o Servidor Tableau deve se comunicar com o servidor de send-logs na porta 443:
    
    - report-issue.tableau.com:443
    - crash-artifacts-747369.s3.amazonaws.com
    - s3-us-west-2-w.amazonaws.com
    - s3-w-a.us-west-2.amazonaws.com
- Enviando dados básicos do produto.
    
    O domínio, prod.telemetry.tableausoftware.com, é usado pelo Tableau para receber os Dados básicos do produto sobre a inicialização e o desligamento do processo. Também é usado para os dados mais gerais de uso do produto.
    
    O tráfego para este domínio ocorrerá na porta 80 (para registro inicial de nossos clientes de Dados de produto) e na porta 443 (para todo o tráfego subsequente).
    
    prod.telemetry.tableausoftware.com:80
    
    prod.telemetry.tableausoftware.com:443
- Licenciamento. Os produtos do Tableau se conectam à Internet para ativar chaves de produto. A menos que você ative o software Tableau com a [Ferramenta de ativação off-line](http://www.tableau.com/pt-br/support/activation), todos os produtos do Tableau devem ter acesso à Internet para validar as licenças. Especificamente, o Tableau requer acesso à Internet durante as seguintes operações de licenciamento: ativação, desativação e na data de manutenção da atualização. Para obter mais informações sobre essas operações, consulte [Gerenciar licenças](https://help.tableau.com/current/server/pt-br/license_manage.htm).
    
    O Tableau Server precisa se conectar aos seguintes locais na Internet ao ativar chaves de produto, registrar o produto e autenticar-se nos serviços de licenciamento do Tableau.
    
    - atr.licensing.tableau.com:443
    - licensing.tableau.com:443
    - register.tableau.com:443
    - o.ss2.us
    - s.ss2.us
    - crt.rootca1.amazontrust.com
    - crt.sca1b.amazontrust.com
    - crt.sca0a.amazontrust.com
    - crt.sca1a.amazontrust.com
    - crt.sca2a.amazontrust.com
    - crt.sca3a.amazontrust.com
    - crt.sca4a.amazontrust.com
    - \*.digicert.com
    - ocsp.\*.amazontrust.com
    - crl.\*.amazontrust.com
    - crt.rootg2.amazontrust.com
    
    As solicitações para os domínios acima podem ser feitas na porta 80 ou 443. A porta 80 é utilizada para validação de certificados (revogação, cadeia de certificados etc). A porta 443 é usada para conexões SSL.
    
    Solicitações aos domínios `ocsp.*.amazontrust.com` e `crl.*.amazontrust.com` são gerenciados pela Amazon para obter informações de revogação de certificados. Consulte [Características de certificados ACM](https://docs.aws.amazon.com/acm/latest/userguide/acm-certificate.html) para obter maiores informações. Recomendamos que você instale os certificados raiz da Amazon no armazenamento confiável de certificados no computador que executa o Tableau. Para baixar e instalar os certificados raiz da Amazon, consulte [Autoridades Certificadoras](https://www.amazontrust.com/repository/#cas) no site da Amazon Trust Services.
    
    Se o Tableau Server não conseguir fazer uma conexão enquanto estiver tentando ativar sua licença, você será solicitado a fazer uma ativação offline.
    
    Para diagnosticar a conectividade com o servidor de licenciamento do Tableau, cole a seguinte URL em um navegador ou em um prompt de comando curl no computador do Tableau Server.
    
    `https://atr.licensing.tableau.com/_status/healthz`
    
    Se o Tableau Server puder acessar o servidor de licenciamento, ele exibirá uma mensagem "OK". Caso contrário, um erro como "Não é possível acessar esta página" pode ser exibido. Para resolver esse problema, trabalhe com sua equipe de rede para desbloquear o acesso a atr.licensing.tableau.com:443 no computador do Tableau Server.
    
    Especificamente, para implantações em que o ATR está configurado, consulte [Etapa 4: verificar se as configurações de proxy não estão em conflito com as variáveis de ambiente do Windows](https://help.tableau.com/current/server/pt-br/proxy.htm#win-environ-var).
- Trabalho com dados externos ou na nuvem.
    
    O Tableau Server precisa se conectar ao seguinte local da Internet para os serviços Anaplan, Box, Dropbox, Google Drive, Google Sheets, OneDrive e Snowflake:
    
    `galop.connectors.tableau.com:443`: atualiza as configurações do ambiente.
- Trabalhar com extensões de painel do Tableau.
    
    Tableau Server precisa se conectar ao seguinte local da Internet para usar as extensões de painel em área restrita:
    
    `extensions.tableauusercontent.com: 443`
    
    Para obter mais informações, consulte [Gerenciar extensões de painel e visualização no Tableau Server](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm).
- Trabalhando com Slack.
    
    Se você estiver integrando o Tableau a um espaço de trabalho do Slack, há uma série de etapas que você precisa seguir, incluindo adicionar URLs específicas à lista de permissões do Tableau. Elas estão listadas [aqui](https://salesforce-internal.slack.com/help/urls "URLs do Slack para integração com o Tableau"). Para obter detalhes completos sobre como fazer isso, consulte [Integrar o Tableau com a área de trabalho do Slack](https://help.tableau.com/current/server/pt-br/slack_admin.htm).

O Tableau Server pode executar sem acesso à Internet. Para obter mais informações sobre a implantação do Tableau Server em empresas sem acesso à Internet, consulte [Instalar o Tableau Server em um ambiente desconectado (fisicamente isolado)](https://help.tableau.com/current/server/pt-br/install_air_gapped.htm).

Em várias empresas, os usuários também precisam acessar o Tableau Server de fora da rede (ou seja, pela Internet). Por exemplo, em diversas empresas, os usuários querem acessar o Tableau Server por seus dispositivos móveis para poder interagir com exibições armazenadas no servidor. Para configurar o acesso ao Tableau Server pela Internet ou por dispositivos móveis, é necessário usar um proxy reverso. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).

Como prática recomendada de segurança, não exponha a porta TSM (por padrão, `8850`) para a internet.

<!-- document id=5cae208b885d0df26695402eb9e510173b17332b19bd5203688c7872e4db5754 url=/tableau/current/pt-br/server/rmt-concepts.md -->

[Pular para o conteúdo principal](#main-content)

# Conceitos

Este documento explica brevemente alguns conceitos principais do Resource Monitoring Tool do Tableau e define alguma terminologia que você verá com frequência.

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. No entanto, você pode continuar a ver os termos nos comandos e opções da CLI e em outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## Agente

O agente do Resource Monitoring Tool é executado como um serviço em segundo plano em cada um dos servidores do Tableau. Ele deve ser instalado em todos os nós em uma instalação do Tableau Server qua você quer monitorar.

O agente é um processo leve que monitora a atividade do Tableau e o desempenho geral do servidor em que ele está instalado. Ele relata os detalhes ao Servidor do Resource Monitoring Tool.

## Servidor (Servidor RMT) do Resource Monitoring Tool

O Servidor do Resource Monitoring Tool hospeda o aplicativo Web com os quais os usuários interagem. Ele também faz grande parte do processamento em segundo plano para agrupar e monitorar os dados dos agentes. Usaremos o termo **Servidor RMT** para nos referir a este componente.

## Ambiente

O _ambiente_ é o termo usado para fazer referência a uma instalação de um único nó do Tableau Server ou um cluster do Tableau Server. Na interface da Web do Servidor RMT, cada nó do Tableau Server é chamado de **Servidor**.

O Resource Monitoring Tool pode monitorar várias instalações do Tableau Server. Por exemplo, você pode ter tanto a produção quanto a preparação dos Tableau Servers. No Resource Monitoring Tool, você pode criar dois ambientes (_Produção_ e _Preparação_) e monitorar os dois clusters do Tableau Server.

## Status do Ambiente

O _status do ambiente_ indica o estado do ambiente atual do Tableau. O status é determinado pelo número e tipo de incidentes e o status dos vários processos do Tableau. As seções a seguir descrevem o que cada status significa nesses termos.

#### OK

![Ícone Sucesso.](/tableau/current/pt-br/server/pt-br/Img/rmt-env-status-ok.png)

Nenhum aviso ou incidente crítico ocorreu hoje e não há atualmente nenhum processo com falha.

#### Aviso

![Ícone Aviso.](/tableau/current/pt-br/server/pt-br/Img/rmt-env-status-warning.png)

O Ambiente está em um estado **Aviso** quando qualquer um dos seguintes é verdadeiro:

- Pelo menos um incidente de aviso ocorreu hoje.
- Um processo **Não está licenciado.**
- Um processo está **Offline.**

#### Crítico

![Ícone Não.](/tableau/current/pt-br/server/pt-br/Img/rmt-env-status-critical.png)

O ambiente está em um estado **Crítico** quando qualquer um dos seguintes itens é verdadeiro:

- Pelo menos um incidente crítico ocorreu hoje.
- O gateway primário está **Offline.**
- Todas as instâncias de um processo **Não estão licenciadas.**
- Todas as instâncias de um processo estão **Offline.**

## Servidor

_Servidor_ é o termo usado para se referir a cada um dos nós na instalação do Tableau Server. Cada máquina em que você instala o agente do Resource Monitoring Tool é considerada um _Servidor_.

<!-- document id=cdf2f53eefbffafd216b2b6b1623f5ccfe884b91b6536c23ff4cc85a85ab67ab url=/tableau/current/pt-br/server/ipa_vconn_connect.md -->

[Pular para o conteúdo principal](#main-content)

# Conectar a dados

Antes de criar uma conexão virtual, você deve se conectar aos dados.

1. No painel Conexões, clique em ![Adicionar conexão](/tableau/current/pt-br/server/pt-br/Img/ipa_connect_button.png).
2. Escolha o conector para seus dados.
3. Insira as informações solicitadas.
4. Clique em Fazer logon. Para adicionar mais conexões, repita essas etapas. Em seguida, comece a criar uma conexão virtual.

Mais sobre [conectores compatíveis](https://help.tableau.com/current/pro/desktop/pt-br/exampleconnections_overview.htm)

## Tarefas relacionadas

[Sobre o Editor de conexão virtual](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_editor.htm)

Não encontrou o que você precisa?

Fique online para ver [toda a ajuda do Tableau](https://www.tableau.com/pt-br/support/help)

<!-- document id=74a075b77c5516507916c04584b1980b9f2c56dbea1f9bc7dd88ae18dfa4d64d url=/tableau/current/pt-br/server/config_oauth_sfdc_cdp.md -->

[Pular para o conteúdo principal](#main-content)

# Conectar o Tableau Server ao Salesforce Data Cloud

> [!WARNING]
> 
> A partir de 14 de outubro de 2025, o Data Cloud foi renomeado como Data 360. Durante essa transição, você pode ver referências a Data Cloud em nosso aplicativo e documentação. Embora o nome seja novo, a funcionalidade e o conteúdo permanecem inalterados.

O conector Salesforce Data Cloud foi lançado para o Tableau Desktop e Tableau Prep em 2023.2, para o Tableau Cloud em junho de 2023 e para o Tableau Server em 2023.3. Esse conector conecta perfeitamente o Tableau ao Data Cloud e está disponível para Tableau Desktop, Tableau Cloud, Tableau Server e Tableau Prep. Comparado ao conector CDP mais antigo, o conector Salesforce Data Cloud é mais fácil de conectar, mostra rótulos de objetos em vez de nomes de API e é alimentado por consultas aceleradas.

**Observação:** anteriormente, o Data Cloud era chamado de Customer Data Platform (CDP). O conector CDP foi descontinuado no Tableau Server 2023.3, ficou indisponível no Tableau Server 2024.2 e foi totalmente removido do Tableau Server 2025.1 e posteriores. Os ativos existentes que usam o conector CDP devem ser recriados usando o conector Salesforce Data Cloud.

Se você estiver usando o Tableau Desktop 2023.1 ou anterior, consulte [Tableau Server (versão 2023.1 e posteriores)](#Tableau).

## Tableau Server (versão 2023.3 ou posteriores)

### Etapa 1: habilitar a integração de aplicativo no Salesforce

Para habilitar a integração do Tableau com o Salesforce, habilite primeiro a integração de aplicativo no Salesforce. É altamente recomendável usar aplicativos clientes externos. Você pode usar aplicativos conectados do Salesforce se eles estiverem disponíveis.

#### Criar um aplicativo cliente externo (recomendado)

A partir da Spring '26, os aplicativos clientes externos do Salesforce são a próxima geração de aplicativos conectados e são recomendados para habilitar a integração do Tableau com o Salesforce.

1. Entre com sua conta de desenvolvedor de Salesforce.com, clique no nome do usuário no canto superior direito da página e selecione Configuração.
2. No painel de navegação à esquerda, em Aplicativos, selecione Gerenciador de aplicativos.
3. No Gerenciador de aplicativos do Lightning Experience, clique em Novo aplicativo cliente externo.
4. No Gerenciador de aplicativos clientes externos, configure a chave do cliente, o segredo do cliente e a URL de retorno de chamada necessários na Etapa 2.
5. Clique em Criar.
6. Depois de criar o aplicativo, selecione a guia Configurações.
7. Marque a Chave do consumidor e o Segredo nas configurações do OAuth.

Quando concluir, acesse **Etapa 2: configurar o Tableau Server para Salesforce.com OAuth**.

Para obter mais informações sobre a criação de um aplicativo cliente externo, consulte [Criar um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&type=5) na Ajuda do Salesforce.

#### Criar um aplicativo conectado do Salesforce (obsoleto)

> [!WARNING]
> 
> **Importante:** A partir da versão Spring '26 do Salesforce, a criação de aplicativos conectados é restrita. Você pode continuar a usar aplicativos conectados existentes durante e após a Spring '26, mas o uso de aplicativos clientes externos é altamente recomendado. Para obter mais informações, consulte o seguinte na Ajuda do Salesforce: [Novos aplicativos conectados não podem mais ser criados na Spring '26](https://help.salesforce.com/s/articleView?id=005228017), [Criar um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&type=5) e [Migração de aplicativo conectado para aplicativo cliente externo.](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_to_external_client_app_migration.htm&type=5)

O conector Salesforce Data Cloud exige que você crie um aplicativo conectado no Salesforce.

Tanto o conector Salesforce Data Cloud quanto o conector Salesforce podem usar o mesmo aplicativo conectado. Portanto, se já estiver usando o conector Salesforce, você só precisará adicionar os três escopos da Customer Data Platform listados na etapa 7 ao seu aplicativo conectado existente.

Para obter as etapas gerais, consulte [Definir configurações básicas do aplicativo conectado](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_create_basics.htm&type=5) na Ajuda do Salesforce. Como alternativa, siga as etapas descritas abaixo.

1. Entre usando sua conta de desenvolvedor de Salesforce.com, clique no nome de usuário no canto superior direito e selecione Configuração.
2. No painel de navegação esquerdo, em Aplicativos, pesquise por “Aplicativos clientes externos” e, em seguida, selecione Configurações de aplicativo cliente externo.
3. Clique em Novo aplicativo conectado.
4. Em Informações básicas nomeie o aplicativo, toque no campo APIfield para que ele preencha automaticamente no formato correto e insira um e-mail de contato para o aplicativo.
5. Na seção API \[Ativar configurações do OAuth\], selecione Ativar configurações de OAuth.
6. Nas novas configurações de OAuth exibidas, para URL de retorno da chamada, digite o nome de domínio totalmente qualificado do servidor usando o protocolo `https` e acrescente o seguinte texto à URL: `auth/add_oauth_token`.  
    Por exemplo:  
    `https://www.your_tableau_server.com/auth/add_oauth_token`
7. Mova os seguintes itens de Escopos de OAuth disponíveis para Escopos de OAuth selecionados:
    - Acesse o serviço de URL de identidade (id, perfil, e-mail, endereço, telefone)
    - Gerenciar dados do usuário por meio de APIs (api)
    - Execute solicitações a qualquer momento (refresh\_token, acesso offline)
    - Executar consultas ANSI SQL nos dados da plataforma de dados do cliente (cdp\_query\_api)
    - Gerenciar dados de perfil do Customer Data Platform (cdp\_profile\_api)
    - Gerenciar dados da API de ingestão da plataforma de dados do cliente (cdp\_ingest\_api)
8. Clique em Salvar.

Depois que você salva o aplicativo, o Salesforce preenche a seção da API com as seguintes IDs que você usará para configurar o Tableau Server:

- Chave do cliente
- Segredo do cliente
- URL de retorno da chamada

### Etapa 2: configurar o Tableau Server para Salesforce.com OAuth

Uma vez que seu aplicativo conectado seja criado no Salesforce e você tenha a chave do cliente, o segredo do cliente e a URL de retorno, você pode configurar o Tableau Server para conexões de dados e saídas do Salesforce e o Einstein Discovery.

1. No computador com o Tableau Server, em um prompt de comando, execute os comandos a seguir.  
    `tsm configuration set -k oauth.salesforce.client_id -v <your_customer_key>`  
    `tsm configuration set -k oauth.salesforce.client_secret -v <your_customer_secret>`  
    `tsm configuration set -k oauth.salesforce.redirect_uri -v <your_redirect_URL>`
2. (Opcional) Para alterar o servidor de logon padrão, digite o seguinte comando:  
    `tsm configuration set -k oauth.salesforce.server_base_url -v <URL>`
3. Insira o comando a seguir para aplicar as alterações:  
    `tsm pending-changes apply`  
    Se as alterações pendentes exigirem uma reinicialização do servidor, alterações pendentes 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.

## Configurar Oauth personalizado para um site

Para obter instruções de configuração, consulte o tópico [Conexões OAuth](https://help.tableau.com/current/server/pt-br/protected_auth.htm#configure-custom-oauth-for-a-site).

## Tableau Server (versão 2023.1 e posteriores)

> [!WARNING]
> 
> **Importante:** a Customer Data Platform foi descontinuada em outubro de 2023, ficou indisponível no Tableau Desktop 2024.2 e foi totalmente removida do Tableau Desktop 2025.1 e posteriores. Se você está usando ativos que utilizam o conector CDP, o Tableau recomenda fortemente que você atualize e use o conector Salesforce Data Cloud.

Esta seção descreve como conectar do Tableau Server ao Salesforce Customer Data Platform por meio da autenticação OAuth.

As etapas descritas nesta seção são necessárias para usar os dados do Salesforce Customer Data Platform no Tableau Server.

### Etapa 1: configurar o conector

1. Baixe o conector mais recente do Salesforce Customer Data Platform (arquivo Salesforce\_CDP.taco) no site [Conectores do Tableau Exchange](https://extensiongallery.tableau.com/products/270).
2. Mova o arquivo .taco para a pasta do conector do Tableau:

- Windows: `C:\Users[Windows User]\Documents\My Tableau Repository\Connectors`
- Linux: `/opt/tableau/connectors` OU `/var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/`

1. Reinicie o Tableau Server.

### Etapa 2: instale o driver JDBC do Customer Data Platform

**Observação:** O Tableau versão 2023.1 para Server é compatível apenas com o driver JDBC versão 18 e superior.

1. Baixe o driver JDBC mais recente (arquivo Salesforce-CDP-jdbc-\[versão\].jar) do site do Salesforce CDP GitHub: [https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases](https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases)
2. Mova o arquivo Salesforce-CDP-jdbc-\[version\].jar baixado para o seguinte local:

- Windows: `C:\Program Files\Tableau\Drivers`
- Linux: `/opt/tableau/tableau_driver/jdbc`

### Etapa 3: criar um aplicativo conectado ao Salesforce

> [!WARNING]
> 
> **Importante:** A partir da versão Spring '26 do Salesforce, a criação de aplicativos conectados é restrita. Você pode continuar a usar aplicativos conectados existentes durante e após a Spring '26, mas o uso de aplicativos clientes externos é altamente recomendado. Para obter mais informações, consulte o seguinte na Ajuda do Salesforce: [Novos aplicativos conectados não podem mais ser criados na Spring '26](https://help.salesforce.com/s/articleView?id=005228017), [Criar um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&type=5) e [Migração de aplicativo conectado para aplicativo cliente externo.](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_to_external_client_app_migration.htm&type=5)

Depois de criar os escopos de API, crie um aplicativo conectado. Para obter as etapas gerais, consulte [Definir configurações básicas do aplicativo conectado](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_create_basics.htm&type=5) na Ajuda do Salesforce. Como alternativa, siga as etapas descritas abaixo para gerenciar a delegação OAuth no Tableau Server.

1. Entre usando sua conta do Salesforce Customer Data Platform como um administrador, clique no nome de usuário no canto superior direito e selecione Configuração.
2. No painel de navegação esquerdo, em Aplicativos, pesquise por “Aplicativos clientes externos” e, em seguida, selecione Configurações de aplicativo cliente externo.
3. Clique em Novo aplicativo conectado.
4. Em Informações básicas nomeie o aplicativ conectdo (por exemplo, Exemplo.com), toque no campo API para que ele preencha automaticamente no formato correto e insira um e-mail de contato para o aplicativo.
5. Na seção API \[Ativar configurações do OAuth\], selecione Ativar configurações de OAuth e faça o seguinte:
    
    1. Nas novas configurações de OAuth exibidas, para URL de retorno da chamada, digite o nome de domínio totalmente qualificado (FQDN) do Tableau Server usando o protocolo `https` e acrescente o seguinte texto à URL: `/auth/add_oauth_token`.
        
        Por exemplo: `https://example.com/auth/add_oauth_token`
    2. Mova os seguintes itens de Escopos de OAuth disponíveis para Escopos de OAuth selecionados:
        
        - Gerenciar dados do usuário por meio de APIs (api)
        - Realizar solicitações em seu nome a qualquer momento (refresh\_token, offline\_access)
        - Gerenciar dados de perfil do Customer Data Cloud (cdp\_profile\_api)
        - Executar consultas ANSI SQL nos dados da plataforma de dados do cliente (cdp\_query\_api)
6. Quando concluir, clique em Salvar.
7. Vá para a lista do Gerenciador de aplicativos, navegue até o aplicativo conectado, clique na seta suspensa e selecione Gerenciar.

Depois que você salva o aplicativo, a seção API (Enable OAuth Settings) é preenchida com as seguintes IDs que você usará para configurar o Tableau Server:

- Chave do cliente
- Segredo do cliente
- URL de retorno da chamada
    
    **Observação:** salve a chave de consumidor, o segredo e a URL de retorno de chamada para uso posterior.

## Use OAuth com Customer Data Platform

Considere configurar um cliente OAuth personalizado para 1) substituir um cliente OAuth se configurado para o servidor ou 2) ativar o suporte para conexão segura a dados que requerem clientes OAuth exclusivos.

Depois que o aplicativo conectado é criado no Salesforce e você tem a Chave do consumidor, o Segredo do consumidor e a URL de retorno de chamada, você pode configurar o Tableau Server para as conexões OAuth de Customer Data Platform. Para começar, reúna as seguintes informações.

- **Chave do consumidor:** a chave do consumidor, também conhecida como ID do cliente no Tableau, é gerada com base no procedimento no final da Etapa 4. Copie este valor para `[your_consumer_key]` no seguinte comando tsm.
- **Segredo do consumidor:** o segredo do consumidor, também conhecida como segredo do cliente no Tableau, é gerada com base no procedimento no final da Etapa 4. Copie este valor para `[your_consumer_secret]` no seguinte comando tsm.
- **URL de retorno de chamada**: a URL de retorno de chamada, também conhecida como URL de redirecionamento no Tableau, é a URL do seu Tableau Server `https://example.com` e "`/auth/add_oauth_token`” anexado a ela. Copie este valor para `[your_callback_url]` no seguinte comando tsm.
- **ID de configuração:** o valor para o parâmetro `oauth.config.id` que você usa no seguinte tsm: `customer_360_audience`

##### Usar comandos do TSM para configuração do OAuth

Execute os seguintes comandos tsm para configurar o OAuth.

`tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}]" --force-keys`

`tsm pending-changes apply`

##### Configuração de vários conectores

Se você tiver vários conectores para definir, deverá incluir todos eles em um único comando. Por exemplo: 

`tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"custom_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}, {\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys`

`tsm pending-changes apply`

### Etapa 1: registrar a ID do cliente OAuth e o segredo do cliente

Conclua o procedimento a seguir para registrar o cliente OAuth personalizado em seu site.

1. Entre no Tableau Server usando as credenciais de administrador de site e navegue até a página **Configurações**.
2. No **Registro de clientes OAuth**, clique no botão **Adicionar cliente OAuth**.
3. Em **Tipo de conexão**, selecione Customer Data Platform.
4. Em Provedor OAuth, selecione **IDP personalizado**.
5. Insira a **ID do cliente**.
6. Insira o **Segredo do cliente**.
7. Insira a **URL do redirecionando**.
8. Em Escolher arquivo de configuração OAuth, selecione o botão **Escolher um arquivo** para carregar o arquivo de configuração.
9. Selecione o botão **Adicionar cliente OAuth** para concluir o processo de registro.
10. Selecione o botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações.

### Etapa 2: validar e atualizar as credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente.

1. Navegue até a página Minhas configurações da conta.
2. Em **Credenciais salvas para fontes de dados**, selecione **Excluir** ao lado das credenciais salvas existentes.
3. Ao lado do mesmo conector, selecione **Adicionar**.
4. Siga os prompts para se conectar ao conector Customer Data Platform.
5. Selecione **Salvar**.

### Etapa 3: notificar os usuários para atualizarem suas credenciais salvas

Certifique-se de notificar os usuários do site para atualizar suas credenciais salvas para o conector Customer Data Platform. Os usuários do site podem usar o procedimento descrito em Gerenciar credenciais salvas para conexões de dados para atualizar as credenciais salvas.

##### Consulte também

- Ajuda do Salesforce: [Configurar o Tableau no Customer Data Platform](https://help.salesforce.com/s/articleView?id=sf.c360_a_set_up_tableau_connected_app.htm&type=5&language=en_US)
- Ajuda do Salesforce: [Habilitar o Customer Data Platform no Tableau](https://help.salesforce.com/s/articleView?id=sf.c360_a_enable_tableau_connector.htm&type=5&language=en_US)
- Ajuda do Salesforce: [Como usar dados do Customer Data Platform no Tableau](https://help.salesforce.com/s/articleView?id=sf.c360_a_using_customer_360_aud_data_in_tableau.htm&type=5&language=en_US)

<!-- document id=96b78b4f419aca76f0a48061e4ab9c7b9d9a7ed1ef60da1739f1d178d2f9c17e url=/tableau/current/pt-br/server/datasource_wdc.md -->

[Pular para o conteúdo principal](#main-content)

# Conectores de dados da Web no Tableau Server

Os conectores de dados da Web (WDCs) são páginas da Web para conectar-se a dados acessíveis por HTTP para fontes de dados que ainda não têm um conector no Tableau. Os WDCs permitem a conexão dos usuários a quase todos os dados acessíveis pela Web e a criação de extrações para as pastas de trabalho. As fontes de dados para o WDC podem incluir serviços da Web internos, dados JSON, REST APIs e outras fontes disponíveis por HTTP ou HTTPS. Os usuários podem criar seus próprios WDC ou usar os conectores criados por outros.

Para obter informações sobre como usar o WDC no Tableau Desktop, consulte [Conector de dados da Web](https://help.tableau.com/current/pro/desktop/pt-br/examples_web_data_connector.htm) na documentação do Tableau Desktop.

Para obter informações sobre como criar um WDC, consulte a [documentação do conector de dados da Web](http://tableau.github.io/webdataconnector/) no Github.

## Antes de executar os conectores no Tableau Server

Como medida de segurança, o Tableau Server não executará os WDCs a menos que você aprove o conector, conforme explicado neste tópico.

**Observação**:é preciso ser um administrador do sistema para aprovar os WDCs para uso no Tableau Server.

Os WDCs precisam da sua aprovação porque contêm código executável e normalmente fazem solicitações a sites de terceiros. Antes de um usuário poder usar o WDC com o Tableau Server, será necessário adicionar o domínio e a porta usados pelo conector a uma lista segura, bem como incluir os domínios que um conector pode enviar e receber solicitações de uma lista segura secundária (lista autorizada secundária). Antes de fazer isso, recomendamos que avalie e teste o conector, para que saiba o que ele faz e a quais sites se conectam. Para obter mais informações, consulte [Teste e verificação dos conectores de dados da Web](https://help.tableau.com/current/server/pt-br/datasource_wdc_vetting.htm).

Ao adicionar um conector a listas seguras, você configura o Tableau Server para permitir conexões a uma URL em especial, onde o conector está hospedado e de uma URL que pode ser consultada pelo conector. Este é a única maneira de permitir que o Tableau Server execute os WDCs. Os conectores podem ser hospedados em um servidor dentro do firewall da sua empresa ou em um domínio externo. A importação de WDCs não é suportada pelo Tableau Server.

## Gerenciar conectores em uma lista segura

Para adicionar um WDC à lista segura, use o comando `tsm data-access web-data-connectors add`. Este comando e os comandos relacionados descritos abaixo permitem que as seguintes tarefas sejam executadas:

- Adicionar WDCs à lista segura e à lista segura secundária.
- Permitir ou proíbir todos os WDCs ou atualizações do WDC.
- Remover um ou mais conectores da lista de segurança.
- Listar todos os WDCs na lista de segura e lista segura secundária.

### A atualização de listas seguras do WDC requer uma reinicialização do servidor

Após executar qualquer comando que faça alterações nos WDCs, é necessário aplicar as alterações pendentes usando o comando `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).

### Adicionar conectores à lista segura e à lista segura secundária

Para adicionar um conector à lista segura e à lista segura secundária, use o comando [tsm data-access web-data-connectors add](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-add), fornecendo o nome, a URL da lista segura e as URLs da lista segura secundária. Você também pode gerenciar os WDCs usando [Entidade de web-data-connector-settings](https://help.tableau.com/current/server/pt-br/entity_wdc.htm). Após executar o comando, é necessário aplicar as alterações pendentes usando o comando `tsm pending-changes apply`. Um prompt avisa que o comando reiniciará o Tableau Server. Se o Tableau Server estiver em execução no momento, ele será reiniciado; caso contrário, ele ficará no estado interrompido sem reinicialização.

tsm data-access web-data-connectors add --name "USGS Earthquakes" --url https://tableau.github.io:443/webdataconnector/Examples/html/earthquakeUSGS.html --secondary https://tableau.github.io/.\*,https://earthquake.usgs.gov/.\*,https://maxcdn.bootstrapcdn.com/.\*,https://ajax.googleapis.com/.\*,https://connectors.tableau.com/.\*

Observações sobre formatação:

- Certifique-se de usar aspas retas ("e '), não aspas "inteligentes", em torno do nome do WDC. Use aspas duplas (") se o nome contiver um espaço.
- Para muitos WDCs, a porta especificada para a opção `--url` é 443 ou 80, mas é possível verificar o valor para o seu conector ao analisar os detalhes da fonte de dados no Tableau Server. Você deverá especificar o número da porta como parte da URL, se o WDC estiver utilizando SSL (HTTPS). Por exemplo, para usar a porta padrão para HTTPS, a URL pode parecer com o seguinte: `https://example.com:443/WDC/`.
- Uma URL ou uma lista de URLs delimitada por vírgulas deve ser especificado para a opção `--secondary`, que indica os domínios que fornecem as bibliotecas e fontes que o WDC precisa acessar. Essa opção não pode ser omitida ou deixada em branco, a menos que o WDC não use nenhum domínio secundário. Se você não sabe se o WDC usa domínios secundários ou quais são os domínios secundários, talvez seja necessário entrar em contato com o desenvolvedor do WDC. Você também pode optar por usar URLs curinga `http://.*` e `https://.*` para permitir todos os domínios. No entanto, recomendamos fortemente que você use URLs mais específicas para aumentar a segurança.
- Para adicionar um domínio inteiro à lista segura secundária, termine a URL do domínio com uma expressão curinga. Use `.*` como o curinga para indicar o domínio inteiro, como no exemplo a seguir `https://example.com/.*`.

### Permitir ou proibir todos os WDCs ou atualizações de WDCs

Para permitir ou proibir os WDCs ou as atualizações de extração de WDCs, use o comando `tsm data-access web-data-connectors allow` com as opções `-t` ou `-r`. Por padrão, atualizações de extrações WDCs e WDC são permitidas. Se você alterar esta configuração, é necessário executar o comando `tsm pending-changes apply`. Para obter mais informações sobre o comando e as opções globais, consulte [`tsm data-access web-data-connectors allow`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-allow).

### Remover um ou mais WDCs da lista segura

Para remover um ou mais WDCs da lista segura, use o comando `tsm data-access web-data-connectors delete`: Se você alterar esta configuração, é necessário executar o comando `tsm pending-changes apply`. Para obter mais informações, consulte [`tsm data-access web-data-connectors delete`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-delete).

### Listar todos os WDCs na lista segura

Para listar todos os WDCs na lista segura, use o comando `tsm data-access web-data-connectors list`: Para obter mais informações, consulte [`tsm data-access web-data-connectors list`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-list).

## Atualização da extração para um conector

Quando um usuário cria uma pasta de trabalho que utiliza um WDC, o Tableau Server cria uma extração de dados retornados pelo conector. Se o usuário, em seguida, publicar a pasta de trabalho, o processo de publicação envia a pasta de trabalho e a extração dos dados para o servidor.

O Tableau pode atualizar uma extração que foi criada por um WDC, assim como pode atualizar qualquer extração. Se o conector exigir credenciais para fazer logon na fonte de dados baseada na Web, será necessário garantir que as credenciais sejam inseridas com a fonte de dados e que o WDC esteja na lista segura do servidor. O Tableau Server não pode atualizar a extração se o conector precisar de credenciais e elas não estão inseridas na fonte de dados. Isto é porque a atualização pode ocorrer conforme uma agenda ou em algum contexto em segundo plano, e o servidor pode não solicitar as credenciais.

Atualmente, não há como autenticar novamente uma fonte de dados a partir do Tableau Server diretamente. Se a fonte de dados tiver credenciais que expiram, ou foi publicada sem inserir as credenciais, a pasta de trabalho e a extração de dados precisam ser publicadas novamente com as novas credenciais inseridas.

Se o processo em segundo plano que executa a operação de atualização falhar, ele cria um alerta e uma entrada de registro que indica esse problema. Os usuários poderão ver que a data e hora da extração não é alterada.

Para desabilitar a atualização para todos os WDCs, use o comando [`tsm data-access web-data-connectors allow -r false`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-allow).

### Solução de problemas

Se o servidor tiver problemas com a adição de conectores a uma lista segura, examine os arquivos de registro. Não se esqueça de verificar os arquivos de registro no nó do servidor inicial e nos outros nós que executam o processo de gateway. Para obter mais informações sobre os arquivos de registro, [Locais de arquivo de registro e registros do Tableau Server](https://help.tableau.com/current/server/pt-br/logs_loc.htm).

Se o problema for que o Tableau Server não consegue atualizar uma extração criada por um WDC, verifique se a configuração `webdataconnector.refresh.enabled` foi definida como `true`. Se estiver configurado para `false`, execute o seguinte comando para permitir atualizações de extração para todos os WDCs no servidor:

[`tsm data-access web-data-connectors allow -r true`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-allow)

**Observação**: a lista segura é a única maneira de permitir que o Tableau Server execute conectores de dados da Web. A importação dos conectores de dados da Web foi descontinuada a partir da versão 10.5.

<!-- document id=1b50697b244d96d82feaa4bf5d3ba313440cf4ca884484a00c6da00b6ef0201d url=/tableau/current/pt-br/server/protected_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Conexões OAuth

O Tableau Server é compatível com OAuth para vários conectores diferentes. Na maioria dos casos, a funcionalidade OAuth não estruturados não configuração adicional no Tableau Server.

No Tableau, quando os usuários entram em dados com um conector que usa OAuth, eles são redirecionados para a página de entrada do provedor de autenticação. Após fornecer as credenciais e autorizar o Tableau para acessar os dados, o provedor de dados envia ao Tableau um **token de acesso** que identifica exclusivamente as Tableau e os usuários. Este token de acesso é usado para acessar dados em nome dos usuários. Para obter mais informações, consulte [Visão geral do processo OAuth](#Overview) abaixo.

O uso de conexões baseadas em OAuth oferece os seguintes benefícios:

- **Segurança:** as credenciais de banco de dados nunca são mostradas nem armazenadas no Tableau Server, e o token de acesso pode ser usado apenas pelo Tableau em nome de usuários.
- **Praticidade:** Em vez de inserir ID e senha da fonte de dados em vários locais, você pode usar o token fornecido para determinado provedor de dados em todas as pastas de trabalhos e extrações de dados publicadas que acessam esse provedor de dados.
    
    **Observação:** para conexões em tempo real com os dados do Google BigQuery, cada visualizador de pasta de trabalho pode ter um token de acesso exclusivo que identifica o usuário, em vez de compartilhar uma única credencial de nome de usuário e senha.

## Visão geral do processo OAuth

As seguintes etapas descrevem um fluxo de trabalho no ambiente do Tableau que chama o processo OAuth.

1. Um usuário executa uma ação que exige acesso a uma fonte de dados baseada em nuvem.
    
    Por exemplo, você abre uma pasta de trabalho que foi publicada no Tableau Server.
2. O Tableau direciona o usuário para a página de logon do provedor de dados na nuvem. As informações enviadas para o provedor de dados identificam o Tableau como o site solicitante.
3. Quando o usuário entra nos dados, o provedor solicita que ele confirme a autorização para o acesso do Tableau Server aos dados.
4. Após a confirmação do usuário, o provedor de dados envia um token de acesso de volta ao Tableau Server.
5. O Tableau Server apresenta a pasta de trabalho e os dados para ao usuário.
    
    ![Um diagrama do fluxo de dados entre seu laptop, o Tableau Server e seu banco de dados.](/tableau/current/pt-br/server/pt-br/Img/protected_auth_server.png)

**Observação**: o suporte para tokens de atualização de uso único (às vezes chamados de tokens de atualização de uso único, tokens de atualização contínuos ou rotação de tokens de atualização) para conexões OAuth foi adicionado em Tableau Cloud na versão 2025.2 (inverno de 2025) e adicionado ao Tableau Server com a versão 2025.3, se o IDP do provedor de fonte de dados oferecer suporte a ele. Eles ainda não são compatíveis em conexões Tableau Bridge com Tableau Cloud. Se você usar a configuração do OAuth externo para a conexão, consulte a [Documentação de configuração e uso do OAuth](https://tableau.github.io/connector-plugin-sdk/docs/oauth "Documentos de configuração do OAuth") no GitHub para obter mais informações.

Os fluxos de trabalho do usuário a seguir podem usar o processo OAuth:

- Criação de uma pasta de trabalho e conexão à fonte de dados no Tableau Desktop ou no Tableau Server.
- Publicação de uma fonte de dados do Tableau Desktop.
- Entrar no Tableau Server de um _cliente_ aprovado, como o Tableau Mobile ou Tableau Desktop.

## Conectores de credenciais salvas padrão

_Credenciais salvas_ refere-se à funcionalidade em que o TTableau Server armazena tokens de usuário para conexões OAuth. Isso permite que os usuários salvem suas credenciais OAuth no perfil de usuário do Tableau Server. Depois de salvar as credenciais, elas não serão solicitadas ao publicar, editar ou atualizar posteriormente ao acessar o conector.

**Observação**: ao editar fluxos do Tableau Prep na Web, você ainda pode ser solicitado a autenticar novamente.

Os conectores a seguir usam credenciais salvas por padrão não precisam exigem configuração adicional no Tableau Server.

- Anaplan
- Box
- Dropbox
- Esri ArcGIS Server
- Google Ads
- Navegador de vendas do LinkedIn
- Marketo
- OneDrive e SharePoint Online (configuração adicional é necessária a partir de 2022.3)
- Oracle Eloqua
- ServiceNow ITSM
- Snowflake - O uso do “link privado” requer uma configuração adicional. Para obter mais informações, consulte [Configurar Snowflake OAuth para aplicativos de parceiros](https://docs.snowflake.net/manuals/user-guide/oauth-partner.html#configure-snowflake-oauth-for-partner-applications) no site Snowflake e [Configurar o OAuth para conexões do Snowflake no Tableau Server](https://help.tableau.com/current/server/pt-br/config_oauth_snowflake.htm).

Os conectores a seguir podem usar credenciais salvas com configuração adicional pelo administrador do servidor.

- Amazon Athena
    
    Para obter mais informações, consulte [Usar seu próprio provedor de identidade com o Amazon Athena](https://help.tableau.com/current/pro/desktop/pt-br/amazon_athena_idp.htm) na Ajuda do Tableau Desktop.
- Azure Data Lake Storage Gen2, Azure Synapse, Azure SQL Database, Databricks, OneDrive e SharePoint Online e SharePoint Lists (JDBC)
    
    [Configurar o Azure AD para Autenticação Moderna e OAuth](https://help.tableau.com/current/server/pt-br/config_oauth_azure_ad.htm).
- Dremio
    
    Para obter mais informações, consulte [Configurar OAuth para Dremio](https://help.tableau.com/current/server/pt-br/config_oauth_dremio.htm).
- Google Analytics, Google BigQuery, Google BigQuery (JDBC), Google Drive
    
    Para obter mais informações, consulte [Configurar o OAuth para Google.](https://help.tableau.com/current/server/pt-br/config_oauth_google.htm)
    
    **Observação:** se o Tableau Server não estiver listado na lista Aplicativos acessados no console de administração do Google, você poderá adicionar manualmente um novo aplicativo à lista usando sua ID de cliente. Para criar uma ID do cliente, consulte [Alterar o Google OAuth para credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_google.htm).
- Intuit QuickBooks Online
    
    Para obter mais informações, consulte [Configurar OAuth para QuickBooks Online do Intuit](https://help.tableau.com/current/server/pt-br/config_oauth_qbo.htm).
    
    OneDrive e SharePoint Online (a partir de 2022.3)
    
    Para obter mais informações, consulte [Configurar OAuth personalizado](https://help.tableau.com/current/server/pt-br/config_oauth_azure_ad.htm#custom) para um site
- Salesforce
    
    Para obter mais informações, consulte [Alterar o OAuth do Salesforce.com para credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm).
- Salesforce CDP
    
    Para obter mais informações, consulte [Conectar o Tableau Server ao Salesforce Data Cloud](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc_cdp.htm).
- Snowflake
    
    A partir da versão 2024.2. Para obter mais informações, consulte [Alterar o Snowflake OAuth para credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_snowflake.htm).

Todos os conectores compatíveis estão listados em Credenciais salvas para fontes de dados na página Minhas configurações de conta dos usuários no Tableau Server. Os usuários gerenciam as credenciais salvas para cada de conector.

![Uma lista de credenciais salvas para fontes de dados, com uma opção para limpar todas as credenciais salvas.](/tableau/current/pt-br/server/pt-br/Img/oauth-savedcreds.png)

### Tokens de acesso para conexões de dados

Você pode inserir as credenciais com base nos tokens de acesso com as conexões de dados, para habilitar o acesso direto após o processo de autenticação inicial. Os tokens de acesso permanecem válidos até um usuário do Tableau Server excluí-los ou o provedor de dados revogá-los.

É possível exceder o número de tokens de acesso permitido pelo seu provedor de fonte de dados. Se for esse o caso, quando um usuário criar um token, o provedor de dados usará o tempo decorrido desde o último acesso para determinar qual token invalidar para liberar espaço para.

### Tokens de acesso para autenticação por meio de clientes aprovados

Por padrão, sites do Tableau Server permitem que usuários acessem seus sites diretamente de clientes do Tableau aprovados, após fornecerem suas credenciais pela primeira vez que efetuarem logon. Esse tipo de autenticação também usa tokens de acesso do OAuth para armazenar as credenciais dos usuários com segurança.

Por obter mais informações, consulte [Desabilitar a autenticação do cliente](https://help.tableau.com/current/server/pt-br/devices_connected_credentials.htm).

## Conectores de chaves gerenciadas padrão

_Chaves gerenciadas_ refere-se à funcionalidade em que os tokens do OAuth são gerados para o Tableau Server pelo provedor e compartilhados por todos os usuários no mesmo site. Quando um usuário publica pela primeira vez na fonte de dados, o Tableau Server solicita ao usuário as credenciais de fonte de dados. O Tableau Server envia as credenciais para o provedor de fonte de dados, , que retorna os tokens do OAuth para o Tableau Server para usar em nome do usuário. Nas operações de publicação subsequentes, o token do OAuth armazenado pelo Tableau Server para a mesma classe e nome de usuário é usado para que o usuário não seja solicitado a fornecer as credenciais do OAuth. Se a senha da fonte de dados mudar, o processo anterior será repetido e o token antigo será substituído por um novo no Tableau Server.

A configuração adicional do OAuth no Tableau Server não é necessária para os conectores de chaves - gerenciadas padrão:

- Google Analytics, Google BigQuery e Google Sheets (obsoleto no Tableau versão 2022.1)
- Salesforce

### Limite e armazenamento de tokens

O Google tem o limite de a 50 tokens por usuário por aplicativo cliente (neste cenário, o Tableau Server é o aplicativo cliente). Como o token do OAuth é armazenado no Tableau Server e reutilizado pelo usuário, é improvável que o usuário exceda o limite de tokens.

Todos os tokens do usuário são criptografados em repouso quando armazenados no Tableau Server. Consulte [Gerenciar segredos do servidor](https://help.tableau.com/current/server/pt-br/security_secret_storage.htm) para obter mais informações.

### Remoção de registros de keychain não utilizados

Um registro de chaveiro gerenciado contém atributos de conexão como atributos secretos dbClass, nome de usuário e OAuth. Todos os registros de keychain gerenciados para um determinado site são mesclados, criptografados e armazenados em PostgreSQL.

Os registros são mantidos até mesmo para pastas de trabalho e fontes de dados que foram removidas. Com o tempo, esses registros podem crescer para tamanhos grandes que podem causar problemas.

Recomendamos a eliminação dos registros de keychain não usados periodicamente como uma tarefa regular de manutenção. Você pode visualizar o número de registros e os registros não usados armazenados em cada site. Você também pode excluir registros não usados.

![Uma caixa de diálogo para o gerenciamento de keychains de credenciais salvos. A caixa de diálogo inclui uma opção para exibir o número de keychains não utilizados e um botão para excluí-los.](/tableau/current/pt-br/server/pt-br/Img/oauth-purge-managed-keys.png)

Para acessar Limpeza de keychain gerenciado, entre nas páginas administrativas do Tableau Server, navegue até o site onde deseja excluir registros não usados e clique em Configurações.

### Limitações de cenário com chaves gerenciadas

Três cenários não são aceitos ao usar a chave gerenciada do OAuth com o Tableau Server:

- Ao solicitar credenciais OAuth em conexões em tempo real. Os usuários devem inserir as credenciais a conexões em tempo real com as chaves gerenciadas do OAuth.
- Ao editar a conexão de fonte de dados do OAuth no Tableau Server
- Criação na Web

### Converter chaves gerenciadas em credenciais salvas

Converta os conectores que usam chaves gerenciadas para usar credenciais salvas configurando o Tableau Server com um ID de cliente do OAuth e um segredo para cada conector. Ao converter esses conectores em credenciais salvas, os usuários poderão gerenciar as credenciais para cada tipo de conector na página Configurações da minha conta no Tableau Server. Além disso, solicitações de conexão em tempo real, edição de conexões e criação na Web também são compatíveis.

## Configurar um Oauth personalizado para um site

Para um subconjunto de conectores, você pode configurar o OAuth no nível do site configurando clientes OAuth personalizados. Para obter mais informações, consulte um dos tópicos a seguir:

- Para Azure Data Lake Storage Gen2, Banco de Dados SQL do Azure, Azure Synapse, Databricks, OneDrive e SharePoint Online e Listas do SharePoint (JDBC), consulte [Configurar Oauth personalizado para um site](https://help.tableau.com/current/server/pt-br/config_oauth_azure_ad.htm#custom).
- Para Dremio, consulte [Configurar OAuth para Dremio](https://help.tableau.com/current/server/pt-br/config_oauth_dremio.htm) .
- Para Google Analytics, Google BigQuery, Google Sheets (obsoleto no Tableau versão 2022.1), consulte [Configurar Oauth personalizado para um site](https://help.tableau.com/current/server/pt-br/config_oauth_google.htm#custom).

- Para o Salesforce, consulte [Configurar Oauth personalizado para um site](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm#custom).
- Para o Salesforce CDP, consulte [Conectar o Tableau Server ao Salesforce Data Cloud](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc_cdp.htm#custom).
- Para o Snowflake, consulte [Opção 2: configurar OAuth para conexões Snowflake por site](https://help.tableau.com/current/server/pt-br/config_oauth_snowflake.htm#custom).

## Outros artigos nesta seção

<!-- document id=8d9761300223ce13436f23ef5bb31cb5ee4852e64dc56983b4fc291ab88f890d url=/tableau/current/pt-br/server/metrics_admin.md -->

[Pular para o conteúdo principal](#main-content)

# Configuração de métricas

**Descontinuação do recurso de métricas herdado**

O recurso de métricas herdado do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3. Com o Tableau Pulse, desenvolvemos uma experiência aprimorada para monitorar métricas e fazer perguntas sobre seus dados. Para obter mais informações, veja [Criar métricas com o Tableau Pulse](https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm) para conhecer a nova experiência e [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm) para o recurso descontinuado.

As métricas são um tipo de conteúdo do Tableau que rastreia o valor de uma medida agregada, como a soma das vendas. Como as métricas são atualizadas com frequência e exibem o valor atual em um formato fácil de ver, elas são úteis para monitorar dados. Para saber mais sobre como os usuários trabalham com métricas, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/server/pt-br/metrics_create.htm).

Como administrador do Tableau Server, você tem a capacidade de controlar a frequência com que as métricas são atualizadas e como as falhas de atualização são resolvidas. Você também pode assegurar que os usuários possam criar ou desativar métricas para sites específicos ou para todo o servidor.

## Assegure que os usuários possam criar métricas

Quando as métricas estiverem habilitadas para um site, todos os usuários com a função no site de Creator ou Explorer (pode publicar) podem criar métricas se tiverem as permissões corretas.

As métricas são criadas nas exibições existentes em um site do Tableau. Para assegurar que os usuários possam criar métricas em uma exibição, verifique se:

- Os usuários têm o recurso de permissão de Criar/Atualizar métricas para a pasta de trabalho à qual a exibição pertence. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).
- A senha da fonte de dados é inserida, se necessário. Para obter mais informações, consulte [Editar conexões no Tableau Server](https://help.tableau.com/current/server/pt-br/connections_modify.htm).

## Desativar métricas para um site

As métricas são ativadas em todos os sites por padrão. É possível desativar as métricas de acordo com o site.

1. No site em que deseja desativar as métricas, no painel de navegação, clique em Configurações.
2. Em Tipo de conteúdo de métricas, desmarque Ativar métricas.
3. Clique em Salvar.

Quando você desativa o tipo de conteúdo de métricas, as métricas deixam de ser exibidas no site. Os dados das métricas existentes são mantidos, mas essas métricas não são mais atualizadas. Se você reativar as métricas, essas métricas serão exibidas novamente e as atualizações serão retomadas.

Você também pode desabilitar métricas em uma pasta de trabalho específica, negando o recurso de permissão Criar/Atualizar métricas. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

## Desativar métricas para um site

Além de desabilitar as métricas para sites específicos, você pode desabilitar as métricas em todo o servidor. Quando desabilitado no nível do servidor, as métricas não são atualizadas ou aparecem em nenhum site, os processos de métricas não são executados e as configurações do site para métricas não estão disponíveis. Os dados de métrica existentes são retidos, de modo que, se você reativar as métricas, essas métricas serão restauradas.

As métricas são ativadas por padrão. Para desabilitar as métricas, use a opção [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metrics-enable)`metricsservices.enabled`.

## Configurar a frequência com que as métricas são atualizadas

Quando uma métrica é atualizada, ela verifica novos dados por meio da exibição em que foi criada, conhecida como a exibição conectada. Você pode aumentar o tempo entre as atualizações se observar um impacto no desempenho do servidor - ou pode diminuí-lo se os usuários precisarem de dados mais atualizados.

As métricas que dependem de dados em tempo real são atualizadas a cada 60 minutos, por padrão. Para ajustar o intervalo de atualização para dados em tempo real, use a opção de configuração [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metrics-interval) `metricsservices.checkIntervalInMinutes`. Esta é uma configuração em todo o servidor.

As métricas que dependem de dados de extrações são atualizadas quando as extrações são atualizadas. Para controlar a frequência com que essas métricas são atualizadas, altere a frequência de atualização das extrações. Para obter mais informações, consulte [Agendas de atualização de extrações](https://help.tableau.com/current/server/pt-br/publish.htm).

## Configurar notificações de falha para atualizações das métricas

Se uma métrica não pode ser conectada aos dados necessários, ocorrerá uma falha na atualização. Quando ocorre falha na atualização da métrica 10 vezes seguidas, o proprietário da métrica recebe uma notificação por e-mail.

Para ajustar o número de falhas consecutivas antes de enviar um e-mail de aviso, use a opção [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metrics-warn) `metricsservices.failureCountToWarnUser`. Esta é uma configuração em todo o servidor.

## Configurar quando as atualizações das métricas forem suspensas

Se ocorrer falha na atualização das métricas 175 vezes seguidas, a atualização será suspensa. Uma vez que uma atualização das métricas é suspensa, o servidor não tentará mais verificar novos dados, até que a atualização seja retomada manualmente.

Para ajustar o número de falhas consecutivas antes de suspender uma atualização, use a opção [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#metrics-suspend) `metricsservices.maxFailedRefreshAttempts`. Esta é uma configuração em todo o servidor.

## Gerenciar métricas

Embora as métricas sejam criadas em uma exibição, elas não estão vinculadas à exibição como alertas ou assinaturas. Isso significa que você pode gerenciar métricas da mesma forma que gerencia pastas de trabalho, renomeando, movendo, marcando, excluindo ou definindo permissões em uma métrica.

Encontre métricas para gerenciar, navegando na hierarquia do projeto ou nos seguintes caminhos.

- Para ver todas as métricas em um site: navegue até a seção Explorar e selecione Todas as métricas.
- Para ver as métricas criadas em todas as exibições de uma pasta de trabalho: navegue até a pasta de trabalho e selecione a guia Métricas conectadas.
- Para ver as métricas criadas a partir de uma única visualização: Abra a visualização e selecione Assistir > Métricas na barra de ferramentas.

## Resolver falhas e suspensões de atualizações das métricas

Pode ocorrer falha nas atualizações das métricas por um dos seguintes motivos.

- A exibição conectada foi excluída ou modificada.
- As permissões foram alteradas para a exibição conectada.
- A senha da fonte de dados não está mais incorporada ou não é mais válida.
- O proprietário da métrica não tem a função de site necessária para atualizar a métrica. Uma função de site de Creator ou Explorer (pode publicar) é necessária.
- Houve um problema temporário de conectividade, que se resolverá.

**Observação:** se a atualização da métrica for suspensa porque o proprietário não tem a função de site necessária para que ela seja atualizada, não poderá retomar a atualização, a menos que altere o proprietário.

Para obter mais informações sobre por que ocorrem falhas nas atualizações das métricas e o que os usuários podem fazer para corrigi-las, consulte [Corrigir atualizações com falha](https://help.tableau.com/current/server/pt-br/metrics_create.htm#fix-failing-refreshes).

Incentive os usuários a substituir uma métrica se a exibição conectada tiver sido modificada de uma maneira que causou a falha da atualização, mas a exibição ainda está disponível. Os usuários podem substituir uma métrica criando uma métrica com o mesmo nome no mesmo projeto da métrica existente.

### Retomar atualizações suspensas

Se a causa da falha for corrigida, por exemplo, inserindo a senha correta para a fonte de dados, é possível retomar a atualização das métricas.

1. Localize a métrica afetada. Métricas com atualizações suspensas exibem o texto Atualização suspensa, em vez do tempo da última atualização, na grade e na exibição de lista.
2. Na mensagem de aviso, clique em Retomar a atualização.

O Tableau tenta realizar a atualização. Se essa tentativa for bem-sucedida, você receberá uma confirmação e a atualização será retomada de acordo com a agenda. Se a tentativa não for bem-sucedida, a atualização permanecerá suspensa. Você ou o proprietário da métrica pode excluir ou substituir a métrica ou mantê-la para fazer referência aos dados históricos.

## Monitorar atividade das métrica com exibições administrativas

Use as exibições administrativas do Tableau Server para monitorar as atualizações das métricas e ver quais usuários estão criando e visualizando as métricas.

1. Navegue até o site que deseja monitorar ou monitore a atividade em todo o servidor, selecionando Todos os Sites no seletor de sites.
2. No painel de navegação, clique em Status do site ou Status do servidor.
3. Selecione o painel que deseja inspecionar.
    - Para monitorar a atividade de atualização das métricas, abra o painel [Tarefas em segundo plano para não extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm).
        
        Filtro para as tarefas Localizar métricas para atualizar ou Atualizar todas as métricas em uma exibição.
    - Para ver quais usuários estão criando métricas, abra o painel [Ações por todos os usuários](https://help.tableau.com/current/server/pt-br/adminview_users_all.htm) ou [Ações por usuário específico](https://help.tableau.com/current/server/pt-br/adminview_user.htm).
        
        Filtro para a ação Criar métrica.
    - Para ver atividades recentes que envolvem métricas, abra o painel [Ações por usuários recentes](https://help.tableau.com/current/server/pt-br/adminview_users_recent.htm).
        
        Veja a lista de ações em Quais ações foram realizadas recentemente?

<!-- document id=1ba8a10958165162ec0d9298c2153a463dee3780a0f236ee691bff37c34a2302 url=/tableau/current/pt-br/server/server_baseline_config.md -->

[Pular para o conteúdo principal](#main-content)

# Configurações de linha de base recomendadas

Determinar a topologia (número de nós, de processos do Tableau Server) da sua implantação do Tableau Server requer considerar estas variáveis: seu ambiente, fontes de dados e gerenciamento para fornecer acesso aos dados de autoatendimento, fluxo de trabalho e uso. Contudo, você pode não ter informações suficientes sobre essas variáveis ao implantar o Tableau Server pela primeira vez Este tópico descreve três arquiteturas de linha de base que podem ser usadas como pontos iniciais para suas instalações do Tableau Server.

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Recomendações de hardware para instalações de produção

As recomendações de hardware para instalações de produção do Tableau Server abaixo são baseadas no hardware que a equipe do Tableau usa para testar a escalabilidade do Tableau Server. Sugerimos usar essas recomendações como pontos iniciais das suas implantações de produção. Para implantações de prova de conceito (PoC), recomendamos o uso do Tableau Cloud. Para obter mais informações, consulte [Requisitos de mínimos de hardware para instalação](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm#MinReq).

<table class="table--plain"><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Tipo de instalação</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Processador</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>CPU</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>RAM</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Espaço livre em disco</i></p></th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3"><p>Nó único</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>64 bits (chipsets de x86_64)</li><li>Deve aceitar conjuntos de instruções SSE4.2 e POPCNT</li><li>Os processadores baseados em ARM não são suportados</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>8 núcleos (16 vCPUs), 2.0 GHz ou superior</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Versão 2022.3 e posteriores:</p><ul><li>128 GB</li></ul><p>Versão 2021.4.0 para versão 2022.1.x:</p><ul><li>64 GB</li></ul><p>Versão 2021.3.x e anteriores:</p><ul><li>32 GB</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>500 GB - 1 TB</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Se estiver adicionando o Tableau Prep Conductor à sua instalação do Tableau Server, recomendamos adicionar um segundo nó e dedicá-lo para a execução do Prep Conductor no Tableau Server. Esse nó deve ter um mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Memória de troca recomendada: configuração padrão do arquivo de paginação do Windows. </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>Implantações empresariais e de vários nós</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" colspan="4"><p colspan="4">Entre em contato com o Tableau para obter orientação técnica.</p><p>Os nós devem atender às recomendações mínimas de hardware ou excedê-las, exceto:</p><ul><li><p>Nós dedicados do Processador em segundo plano executando até duas instâncias nele, onde 4 núcleos podem ser aceitáveis.</p></li><li><p>Nó dedicado para o Tableau Prep Conductor: mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</p></li><li><p>Nó dedicado para Independent Gateway: mínimo de 2 núcleos (4 vCPUs), 8 GB de RAM e 100 GB de espaço livre em disco.</p></li></ul></td></tr></tbody></table>

**Observação:** o Tableau recomenda afinidade de CPU dedicada para implantações que usam máquinas virtuais. Se estiver executando o Tableau Server em um ambiente virtual, use as práticas recomendadas de seu host da VM para a alocação vCPU em relação ao número de núcleos de CPU físicos no host da VM. Geralmente 2 vCPUs = 1 núcleo físico para o Tableau Server. Por exemplo, para instalações AWS, a recomendação mínima de núcleo 4 core é equivalente a 8 AWS vCPUs. Do mesmo modo, siga as práticas recomendadas pelo provedor de infraestrutura virtual para certificar-se de que o Tableau Server tem acesso aos recursos adequados de computação, memória e dados. Se estiver instalando o Tableau Server em um ambiente virtual ou em uma implantação com base em nuvem, consulte a seção [Máquinas virtuais e implantações da nuvem pública](#virtual_and_cloud) a seguir neste tópico.

### Estimação de espaço em disco

Há diversos fatores que afetam os requisitos de espaço em disco, incluindo se publicará ou não extrações, fluxos e o número de pastas de trabalho no Tableau Server. Para obter mais informações, consulte [Requisitos de espaço em disco](https://help.tableau.com/current/server/pt-br/requ_diskspace.htm).

## Configurações de linha de base

- [Instalações de servidor único](#single_server)
- [Instalação de dois nós - especializada para ambiente de extração mais intenso](#two_node_extract_heavy)
- [Instalação de dois nós - especializada para ambientes de fluxo](#two-node_flow_heavy)
- [Instalações de alta disponibilidade (HA)](#ha)

### Instalações de servidor único

#### Recomendações

Recomendamos usar apenas uma máquina para instalar o Tableau Server para implantações iniciais com uso limitado e que não são de missão crítica. As instalações de servidor único também podem ser expandida para instalação de vários nós conforme aumenta a carga de trabalho.

A seguir algumas instâncias de quando uma instalação de servidor único não for o recomendado para você:

- Se seu sistema for considerado de missão crítica e precisar ter alta disponibilidade. A alta disponibilidade é para minimizar o tempo de inatividade do sistema. É obtida eliminando pontos únicos de falha e tendo um mecanismo de failover confiável. O Tableau Server requer o mínimo de uma configuração de três nós para fornecer redundância e eliminar os pontos únicos de falha. Esse é um dos motivos principais para mover para uma configuração de vários nós.
- Se tiver muitos usuários ativos e muitas atualizações de extração, os dois tipos de carga podem estar competindo pelos mesmo recursos na máquina. Nesse cenário, uma configuração de servidor único pode não ser a opção adequada, pois você pode precisar de nós adicionais especializados para isolar as diferenças de carga de trabalho.

**Observação:** os usuários ativos representam as solicitações interativas, simultâneas feitas no Tableau Server, incluindo o consumo de painéis em um laptop ou dispositivo móvel, criação na Web e conexão a e consulta de fontes de dados publicadas.

#### Configuração do servidor

![Diagrama de topologia para um único nó do Tableau Server](/tableau/current/pt-br/server/pt-br/Img/baseline_config_onenode1.png)

- Nó de servidor único independente com todos os processos instalados.
- Por padrão, o instalador do Tableau Server configura o número de instâncias de processos com base no hardware da máquina. Recomendamos manter a configuração padrão como seu ponto inicial. Abaixo, o número de processos de uma máquina de 8 núcleos.
    
    - VizQL Server: definido como 2 instâncias (cálculo padrão: número de núcleos físicos dividido por 4, até o máximo de 4).
    - Processador em segundo plano, servidor cache e servidor de dados: definido como 2 instâncias.
    - Para todos os outros processos, apenas uma instância do processo é instalada, independente do hardware.

Observação: uma instância do Tableau Prep Conductor é configurada automaticamente com o Processador em segundo plano, quando você tem a Chave do produto do Gerenciamento de dados ativada no servidor. No entanto, recomenda-se que você tenha um nó dedicado para o Tableau Prep Conductor. Se você planeja ter fluxos no Tableau Server, recomendamos usar dois ou mais nós e dedicar um desses nós para executar somente fluxos. A configuração de exemplo descrita acima não inclui o Tableau Prep Conductor porque é um servidor de nó único.

## Instalações em vários nós

Executar o Tableau Server em mais de uma máquina é chamado de instalação em vários nós, instalação distribuída ou de cluster. Há vários motivos para escolher uma instalação em vários nós. Por exemplo,você pode ter ambientes de extração intensos, o que pode significar dedicar alguns recursos de hardware para o processador em segundo plano. Para sistemas com requisitos de alta disponibilidade, é necessário um ambiente de vários nós que tenha ao menos três nós.

### Instalação de dois nós - especializada para ambiente de extração mais intenso

#### Recomendações

Comece com uma instalação de dois nós quando as condições a seguir forem aplicáveis:

- **Extrair ambiente intenso:** a maioria das fontes de dados são extrações. Ter apenas algumas extrações extremamente grandes pode colocar sua implantação nessa categoria, como se você tivesse muitas extrações pequenas.
- **Extrações atualizadas com frequência**: atualizar uma extração é uma tarefa que consome muitos recursos da CPU. As implantações em que extrações são frequentemente atualizadas (por exemplo, várias vezes ao dia durante o horário comercial) são geralmente ajudados pela maior ênfase no processo em segundo plano, que lida com tarefas de atualização.

**Importante:** configurações de dois nós não atendem aos requisitos mínimos de alta disponibilidade. Se precisar de um sistema de alta disponibilidade, consulte [Instalações de alta disponibilidade (HA)](#ha).

#### Configuração do servidor

![Diagrama de topologia de um Tableau Server de dois nós com processo de Processador em segundo plano isolado no segundo nó](/tableau/current/pt-br/server/pt-br/Img/baseline_config_twonode_backgrounder_tsm1.png)

- No nó inicial, instale todos os processos, exceto o processador em segundo plano. Abaixo, o número de instâncias dos processos de uma máquina de 8 núcleos:
    
    - VizQL Server: definido como 2 instâncias. (Cálculo padrão: número de núcleos físicos dividido por 4, até um máximo de 4 ).
    - Servidor cache e servidor de dados: definido como 2 instâncias. Uma instância do Pergunte aos dados (Ask Data) é automaticamente configurada no nó que tem o Servidor de dados.
    
    - Index and Search Server: a memória do Index and Search Server é configurada para melhorar o desempenho usando a opção de configuração `indexandsearchserver.vmopts` do TSM. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).
    - Para todos os outros processos, apenas uma instância do processo é instalada, independente do hardware. Uma instância do Contêiner de microsserviço interativo é instalada em um nó que tem o Servidor de aplicativo habilitado e uma instância do Contêiner de microsserviço não interativo é instalada em um nó que tem o Processador em segundo plano habilitado.
- Isole o processador em segundo plano no nó adicional. Para calcular o número mínimo de processos do processador em segundo plano a ser executado neste nó, divida o número total de núcleos físicos do computador por 4. Para calcular o número máximo, divida os núcleos físicos totais do computador por dois. No exemplo mostrado acima, ambos os nós estão em máquinas com 8 núcleos físicos. Ao instalar o processador em segundo plano, o Tableau Server instala automaticamente uma instância do Processador de dados.

**Observação:** essa configuração pressupõe que você não tem o Tableau Prep Conductor habilitado no Tableau Server. Se o estiver usando o Tableau Prep Conductor para agendar e gerenciar fluxos e tiver intensa cargas pesado de extração, recomendamos que tenha pelo menos 3 nós e use a configuração de 3 nós descrita posteriormente neste tópico.

Ao monitorar e coletar dados sobre o desempenho e uso, você pode ajustas e configurar o número de instâncias desses processos. Por exemplo, no nó dedicado a executar o processador em segundo plano, inicialmente, você pode definir o número de processos do processador em segundo plano como o mínimo recomendado (número total de núcleos dividido por quatro), e aumentar o número de processos do processador em segundo plano posteriormente, se achar que:

- As extrações estão demoram muito para serem concluídas
- As assinaturas e alertas não estão sendo concluídas no tempo determinado

Para nós dedicados do processador em segundo plano ou do Tableau Prep Conductor, dependendo da carga de trabalho e dos recursos do sistema, pode ser necessário aumentar ou diminuir o número de instâncias do processador em segundo plano ou do Tableau Prep Conductor. Ajustar o número dessas instâncias pode impactar o desempenho do nó de maneiras positivas e negativas. Você é responsável por monitorar cuidadosamente os recursos de RAM e CPU e outros aspectos do Tableau Server para determinar a melhor configuração para seu ambiente e cargas de trabalho. As recomendações descritas aqui são pontos de partida projetados para lidar com o caso de uso médio e podem não ser adequadas às suas necessidades específicas. Se precisar de mais ajuda, entre em contato com os [Serviços profissionais do Tableau](https://www.tableau.com/pt-br/resources/teams-organizations/professional-services).

Para obter mais informações sobre o ajuste de desempenho, consulte o tópico [Ajuste de desempenho](https://help.tableau.com/current/server/pt-br/perf_tuning.htm).

### Instalação de dois nós - especializada para ambientes de fluxo

Comece com uma configuração de dois nós se estiver planejando publicar, agendar e gerenciar fluxos no Tableau Server.

**Importante:** configurações de dois nós não atendem aos requisitos mínimos de alta disponibilidade. Se precisar de um sistema de alta disponibilidade, consulte [Instalações de alta disponibilidade (HA)](#ha).

#### Configuração do servidor

![Diagrama de topologia de dois nós do Tableau Server com segundo nó dedicado do Prep Conductor. ](/tableau/current/pt-br/server/pt-br/Img/baseline_config_twonode_prepconductor1.png)

- No nó inicial, instale todos os processos. Abaixo, o número de instâncias dos processos de uma máquina de 8 núcleos:
    
    - VizQL Server: definido como 2 instâncias. (Cálculo padrão: número de núcleos físicos dividido por 4, até um máximo de 4 ).
    - Servidor cache e servidor de dados: definido como 2 instâncias. Uma instância do Pergunte aos dados (Ask Data) é automaticamente configurada no nó que tem o Servidor de dados.
    - Processador em segundo plano: mínimo de 2 e máximo de 4. O diagrama acima mostra o máximo para um nó de 8 núcleos. O Tableau Prep Conductor é configurado automaticamente no nó em que você instalou o processador em segundo plano. No nó inicial, defina a função de nó do processador em segundo plano para executar todos os tipos de trabalho incluindo fluxos que usam a configuração `tsm topology set-node-role` do tsm. Para obter mais informações, consulte [tsm topology set-node-role](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetNodeRole)
    - Index and Search Server: a memória do Index and Search Server é configurada para melhorar o desempenho usando a opção de configuração `indexandsearchserver.vmopts` do TSM. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).
    - Para todos os outros processos, apenas uma instância do processo é instalada, independente do hardware. Uma instância do Contêiner de microsserviço interativo é instalada em um nó que tem o Servidor de aplicativo habilitado e uma instância do Contêiner de microsserviço não interativo é instalada em um nó que tem o Processador em segundo plano habilitado.
- No segundo nó, configure o processador de segundo plano e o Tableau Prep Conductor para oferecer suporte aos fluxos.
    
    - Isole o processador em segundo plano no nó adicional e configure-o para executar somente fluxo. Use o comando `tsm topology set-node-role` do tsm para definir essa configuração. Para obter mais informações, consulte [tsm topology set-node-role](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetNodeRole)

**Observação:**se você tiver um ambiente de extração pesado e agendar e gerenciar fluxos em seu servidor, ou precisar dar suporte a fluxos com fluxos de trabalho pesados, recomendamos que você use a configuração de 3 nós descrita abaixo.

### Instalações de alta disponibilidade (HA)

#### Recomendações

Uma instalação de alta disponibilidade (HA) do Tableau Server é uma instalação distribuída projetada para maximizar a disponibilidade do Tableau Server. A alta disponibilidade significa que o sistema está disponível com o tempo de inatividade mínimo. Para criar redundância para itens de HA relacionados, como repositório, redundância de arquivo e failover, é necessário um **mínimo de três nós**. A tolerância para tempo de inatividade vai variar em cada empresa, além de depender dos SLAs definidos na sua empresa.

A alta disponibilidade é obtida ao eliminar pontos únicos de falha e ao detectar falhas e configurar um sistema de failover confiável. A HA no Tableau Server é obtida principalmente por:

- Redundância de arquivo com várias instâncias do Armazenamento de arquivos/Processador de dados
- Repositório ativo/passivo em dois nós.
- Index e Search Server em todos os três nós.
- Adicionar um balanceadores de carga externa para certificar-se de que a instalação é robusta para falhas de gateway e de que as solicitações sejam roteadas apenas para funcionamento dos processos de gateway.

#### Configuração do servidor

Configuração de três nós:

![Topologia básica de alta disponibilidade de três nós para o Tableau Server](/tableau/current/pt-br/server/pt-br/Img/baseline_config_ha_tsm1.png)

- Para criar redundância, você precisa adicionar mais nós para hospedar instâncias dos processos do repositório e do armazenamento de arquivo/processador de dados. Você pode adicionar instâncias de outros processos, incluindo várias instâncias de um processo em um nó.
- Para criar redundância para o tipo de tarefas do processador em segundo plano, faça com que um dos nós (nó inicial neste exemplo) execute todos os tipos de tarefas. Os processadores em segundo plano executam todos os tipos de tarefas por padrão. Em um dos nós adicionais, defina o processador em segundo plano para executar somente fluxos e o outro nó adicional para executar todas as tarefas, exceto os fluxos.
- O funcionamento bem-sucedido do Tableau Server depende de um Serviço de coordenação funcionando adequadamente. Para instalações de servidor de três ou mais nós, recomendamos que você adicione instâncias adicionais do Serviço de coordenação implantando um novo ensemble do Serviço de coordenação. Isso oferece redundância e disponibilidade aprimorada caso essa instância apresente problemas. Para obter mais informações, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
- A memória do Index and Search Server é adicionada a todos os três nós para redundância e pode ser configurada para melhorar o desempenho usando a opção de configuração `indexandsearchserver.vmopts` do TSM. Para obter mais informações, consulte [indexandsearchserver.vmopts](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#indexandsearchserver).
- Para reduzir a vulnerabilidade do sistema, você pode executar vários gateways e instâncias adicionais de alguns dos processos do servidor. O número mínimo de computadores necessários para alcançar essa configuração é três.
- O repositório também foi movido do nó inicial para um dos nós adicionais e uma segunda instância passiva foi adicionada a outro novo nó.
- Uma instância do Contêiner de microsserviço interativo é instalada em um nó que tem o Servidor de aplicativo habilitado e uma instância do Contêiner de microsserviço não interativo é instalada em um nó que tem o Processador em segundo plano habilitado.
    
    Para nós dedicados do processador em segundo plano ou do Tableau Prep Conductor, dependendo da carga de trabalho e dos recursos do sistema, pode ser necessário aumentar ou diminuir o número de instâncias do processador em segundo plano ou do Tableau Prep Conductor. Ajustar o número dessas instâncias no nó pode impactar o desempenho do nó de maneiras positivas e negativas. Você é responsável por monitorar cuidadosamente os recursos de RAM e CPU , e outros aspectos do Tableau Server para determinar a melhor configuração para seu ambiente e cargas de trabalho. As recomendações descritas aqui são pontos de partida projetados para lidar com o caso de uso médio e podem não ser adequadas às suas necessidades específicas. Se precisar de mais ajuda, entre em contato com os [Serviços profissionais do Tableau](https://www.tableau.com/pt-br/resources/teams-organizations/professional-services).

**OBSERVAÇÃO:** em determinadas circunstâncias, você pode desejar limitar os processos em execução no nó inicial. Os motivos para fazer isso incluem querer executar o menor número de processos possível no nó para limitar as solicitações de processamento nele. Você também pode remover os processos licenciados do Tableau Server do nó se tiver uma licença baseada em núcleo e não desejar que os núcleos do nó inicial sejam incluídos no seu uso do núcleo. Para obter mais informações sobre os processos de licença do Tableau Server, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm) do nó.

### Máquinas virtuais e implantações da nuvem pública

Em geral, as considerações e recomendações neste tópico se aplicam a todo o ambiente virtual e implantações da nuvem.

Se estiver executando o Tableau Server em um ambiente virtual, use as práticas recomendadas de seu host da VM para a alocação vCPU em relação ao número de núcleos de CPU físicos no host da VM. Geralmente 2 vCPUs = 1 núcleo físico para o Tableau Server. Por exemplo, para instalações AWS, a recomendação mínima de núcleo 4 core é equivalente a 8 AWS vCPUs.

Para obter mais informações sobre implantações baseadas em nuvem, consulte

- [Auto-hospedar o Tableau Server em um serviço de nuvem pública](https://help.tableau.com/current/server/pt-br/ts_tableau_server_cloud_overview.htm).

## Configurações além da linha de base

Se você estiver planejando um sistema cuja configuração está além dos limites documentados aqui, entre em contato com os [Serviços de consultoria do Tableau.](https://www.tableau.com/pt-br/support/consulting)

#### Considerações de uso de pico alto do VizQL

Para obter o desempenho ideal do Tableau Server, recomendamos isolar o repositório em um nó dedicado em sua implantação. Se você tiver uma licença do Advanced Management, execute o repositório como um banco de dados externo.

Se sua organização tiver um pico de carga de mais de 1.000 sessões VizQL por hora, também recomendamos executar o Tableau Server no Linux. Neste cenário, as sessões VizQL referem-se a qualquer ação do usuário que exibe ou gera visualizações do Tableau Server.

Para obter mais informações, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server-linux/pt-br/server_external_repo.htm).

#### Considerações sobre a recuperação de desastres

Embora as configurações de HA reduzam o tempo de inatividade, você ainda pode encontrar falhas em caso de um desastre ou falhas no hardware. Além das considerações acima, você deve avaliar a importância da recuperação de desastre em sua empresa e planejar uma implantação que o ajude a alcançar os objetivos da recuperação de desastre.

Ao planejar a recuperação de desastre (DR) no ambiente do Tableau, há dois fatores principais a serem considerados:

- Objetivo do tempo de recuperação (RTO), uma medida de quanto tempo de inatividade seu negócio pode aceitar antes de uma recuperação completa.
    
    - Influencia a frequência que você restaura os backups para um cluster alternativo e a quantidade de investimento na infraestrutura.
- Objetivo do ponto de recuperação (RPO), uma medida de quanta perda de dados seu negócio pode tolerar.
    
    - Influencia a frequência que você precisará fazer backups do seu sistema.
    - Para o Tableau Server, o RPO não pode ser mais curto que o tempo levado para concluir um backup completo do seu servidor.

O diagrama abaixo ilustra como planejar para uma gama de requisitos de RTO:

![Um diagrama exibe orientações para planejar os requisitos objetivos do tempo de recuperação.](/tableau/current/pt-br/server/pt-br/Img/baseline_config_dr.png)

#### Escalabilidade do Tableau Server

Estas configurações de linha de base pode não ser suficiente conforme suas necessidades aumentam e são alteradas, e pode ser necessário escalonar o Tableau Server para além dessas configurações. Como outras plataformas empresariais, o Tableau Server escala verticalmente ao adicionar processador, memória e espaço em disco a nós existentes, e escala horizontalmente ao adicionar mais nós a um cluster. Contudo, a escalabilidade e o desempenho são altamente dependentes de sistemas externos e atividade de usuário. A configuração do Tableau Server pode diferenciar dependendo de seus requisitos e variáveis:

![Um diagrama ilustra os fatores que influenciam o desempenho do banco de dados, incluindo ambiente, dados, carga de trabalho e uso.](/tableau/current/pt-br/server/pt-br/Img/baseline_config_variables.png)

Para obter mais informações sobre a escalabilidade Tableau Server e as variáveis que a afetam, consulte [Whitepaper de escabilidade do Tableau Server](https://www.tableau.com/pt-br/learn/whitepapers/tableau-server-scalability-10-5) .

<!-- document id=3b6a1c62bbf0ec8bd312f6ef448ec8364b2244569c7d9e0e426bf0d314477d3f url=/tableau/current/pt-br/server/mobile_security_settings-admin.md -->

[Pular para o conteúdo principal](#main-content)

# Configurações de segurança do aplicativo Tableau Mobile

Ajuste as políticas de segurança do Tableau Server para o aplicativo Tableau Mobile. Essas políticas ajudam a manter seus dados seguros verificando se os dispositivos móveis estão comprometidos e limitando determinadas interações com o aplicativo Tableau Mobile.

As políticas se aplicam apenas à versão padrão do Tableau Mobile, não às versões MAM do aplicativo. Se você implantou um aplicativo MAM, use o específico do Tableau Mobile, além das configurações do seu sistema MAM, para proteger o aplicativo.

## Configurações de segurança

Defina as configurações de segurança do Tableau Mobile na página de configurações do site do Tableau Server ou usando a API REST. Para obter mais informações sobre a API REST, consulte [Referência de configurações móveis](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_mobile_settings.htm) na ajuda da API REST do Tableau.

Para acessar a página de configurações do site:

1. Entre no seu site do Tableau Server como administrador.
2. No painel de navegação, selecione Configurações.
3. Selecione a guia Mobile.

A partir de , as configurações do Server 2023.1 relacionadas à segurança do dispositivo móvel estão disponíveis.

Essas configurações incluem a detecção das seguintes condições:

- Detecção de jailbreak
    
    Essa configuração é habilitada por padrão no nível Crítico e detecta se o aplicativo está sendo executado em um dispositivo com jailbreak ou raiz.
- Detecção de malware (somente dispositivos Android)
    
    Essa configuração é habilitada por padrão no nível Crítico e detecta se o dispositivo contém malware.
    
    > [!IMPORTANT]
    > 
    > Em setembro de 2025, o Tableau Mobile descontinuou o suporte para a configuração de detecção de malware. A configuração de detecção de malware foi removida da página de configurações do Tableau Cloud em setembro de 2025 e da página de configurações do Tableau Server no Tableau Server versão 2025.2.3. Qualquer configuração da definição de detecção de malware em versões anteriores do Tableau Server não tem efeito no aplicativo Tableau Mobile.
- Máximo de dias offline sem atualização de política
    
    Essa configuração é habilitada por padrão em nível Crítico com um máximo padrão de 14 dias. Ela determina se o aplicativo pode ser usado em um dispositivo que está offline (e, portanto, sem uma atualização de política) por mais tempo do que o máximo configurado.
- Impedir a depuração
    
    Essa configuração está ativada por padrão e não pode ser desativada. Ela detecta se o dispositivo possui um depurador anexado a ele.
- Compartilhamento de tela e capturas de tela (somente dispositivos Android)
    
    Essa configuração é habilitada por padrão e determina se um usuário do aplicativo Tableau Mobile pode compartilhar capturas de tela ou usar o compartilhamento de tela com o aplicativo.

Você pode alterar o nível de gravidade da configuração de Detecção de Jailbreak:

- **Aviso**: aplique a política e, se ela falhar, mostre uma mensagem de bloqueio que pode ser descartada.
- **Erro**: aplique a política e, se ela falhar, mostre uma mensagem de bloqueio até que o problema seja resolvido.
- **Crítico**: aplique a política e, se ela falhar, mostre uma mensagem de bloqueio e o aplicativo decidirá como lidar com o logoff/limpar a sessão por meio dos provedores. Esse é o padrão.

<!-- document id=30862f5820b31238861129556ee50c3af8d5be423207ea4236167e752d3c9bf7 url=/tableau/current/pt-br/server/cmt-settings.md -->

[Pular para o conteúdo principal](#main-content)

# Configurações do Content Migration Tool do Tableau

As configurações padrão do Content Migration Tool do Tableau funcionam na maioria dos casos, mas você pode alterá-las se necessário ou se estiver trabalhando com o Suporte do Tableau e for solicitado a fazer alterações.

Para exibir ou atualizar as configurações do Content Migration Tool:

1. Abra o Content Migration Tool.
2. Clique em Help > Settings. A caixa de diálogo Configurações é aberta:
    
    ![Guia Avançado da janela Configurações que mostra opções avançadas para a ferramenta de gerenciamento de conteúdo.](/tableau/current/pt-br/server/pt-br/Img/cmt-settings.png)  
    
    Diagnostics—Clique em Open Log Folder para abrir o local de registros. Aqui você pode exibir e compactar os registros se precisar enviá-los ao Tableau. Para obter mais informações, consulte [Arquivos de registro do Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-logfiles.htm).
    
    Selecione Enable Network Tracing se estiver trabalhando com o Suporte e for solicitado a incluir um rastreamento de rede nos registros. Isso se aplica até você desmarcar a opção ou reiniciar o Content Migration Tool.
    
    Security\- A chave de criptografia é gerada automaticamente na instalação. Se você alterar a chave de criptografia, todos os planos de migração com senhas inseridas criadas com a chave anterior não poderão ser abertos. Se você tiver várias instalações do Content Migration Tool do Tableau e quiser compartilhar os planos de migração, precisará verificar se a chave de criptografia usada em cada instância da ferramenta é a mesma.
    
    Migration Scripts– Por padrão, um aviso é exibido ao executar um plano de migração que inclui scripts de migração ou executáveis. Outros usuários podem editar esses arquivos, portanto, verifique se eles estão seguros antes de executar a migração. Ativar e desativar essa configuração também atualizará sua preferência de aviso para o console runner. Para obter mais informações, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).
    
    Tuning\- Em quase todos os casos, você pode deixar esses conjuntos para os padrões. Se você estiver trabalhando com o Suporte, talvez seja solicitado a alterar essas configurações.
    
    Temporary Files\- Selecione um local para arquivos temporários se desejar alterar o padrão. Este é o local em que o conteúdo é copiado durante uma migração. Talvez você queira alterá-lo se o local padrão não tiver espaço suficiente para manter temporariamente o conteúdo migrado.
    
    Networking\- Selecionar Allow Legacy HTTPS Connections fornece a capacidade de se conectar a instalações do Tableau Server executadas com configurações HTTPS mais antigas (por exemplo, SSL v3). Isso não é recomendado.

## Quem pode fazer isso

Normalmente, as tarefas listadas acima só podem ser feitas por um usuário com acesso de administrador na máquina em que Content Migration Tool está instalado.

<!-- document id=69038c9a56e445ea3a98f8a295b3e1840e1eb6c0455b2d46a17ec16a5640bf1c url=/tableau/current/pt-br/server/maintenance_set.md -->

[Pular para o conteúdo principal](#main-content)

# Configurações do servidor (geral e personalização)

As configurações a seguir estão disponíveis nas páginas Geral e Personalização em Servidor - Configurações.

Muitas dessas configurações são movidas da página Configurações do servidor para a página Configurações do site, quando há mais de um site no servidor. Elas são marcadas com “Move-se para configurações do site em servidores de vários sites".

## Geral

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 261px;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 437px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: left;">Configuração</th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: left;">Descrição</th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Nome de site e ID</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Especifica o nome do site visto na interface do usuário e a ID vista na URL do site. (Se estiver editando um site Padrão, não é possível alterar a ID.)<p>Você não pode alterar a parte "#/site" da URL (por exemplo, http://localhost/#/site/sales). Em ambientes de servidor de vários sites, estes segmentos aparecem na URL de sites diferentes do site Padrão.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Armazenamento </strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Selecione <span class="uicontrol">Limite do servidor</span> ou <span class="uicontrol">GB</span> e, para a segunda opção, insira o número de gigabytes que deseja como limite para o espaço de armazenamento para pastas de trabalho, extrações e outras fontes de dados publicadas.<p>Se você definir um limite de servidor e o site excedê-lo, os publicadores serão impedidos de carregar conteúdo novo até que o site esteja dentro do limite novamente. Os administradores de servidor podem rastrear em que ponto o site se encontra em relação ao seu limite usando as colunas Armazenamento máximo e Armazenamento usado na página Sites.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Histórico de revisão</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Especifica o número de versões anteriores de pastas de trabalho, fluxos e fontes de dados armazenadas no servidor.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Gerenciamento de usuários</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Determina se apenas os administradores de servidor podem adicionar e remover usuários e alterar as funções de site, ou se os administradores de site também podem fazer isso.<p>Se você permitir que os administradores de site gerenciem usuários, especifique quantos usuários eles podem adicionar ao site, selecionando uma destas opções:</p><ul><li>O Limite do servidor adiciona o número de licenças de assentos disponíveis do servidor. Para um servidor com licenciamento baseado em núcleo, não há limite.</li><li>O limite de site permite que os administradores de site adicionem usuários até um limite especificado por você.</li><li>O limite de função de site permite que um administrador de site adicione usuários de cada função de site até o limite de licença especificado para o site.</li></ul><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/view_licenses.htm" target="_blank">Exibir licenças do servidor</a>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Criação na Web</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se a criação baseada em navegador está habilitada para o site. Quando a criação na Web para pastas de trabalho é desativada, os usuários não podem criar ou editar pastas de trabalho publicadas no ambiente da Web do servidor, no entanto, devem usar o <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> para republicar a pasta de trabalho. Quando a criação na Web para fluxos é desativada, os usuários não podem criar ou editar fluxos publicados do ambiente da Web do servidor, mas devem usar o <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span> para republicar o fluxo.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/web_author_enable.htm" target="_blank">Definir acesso e funções de criação na Web de um site</a> na Ajuda do Tableau Cloud.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Tableau Prep Conductor</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se os usuários com permissões apropriadas podem agendar e monitorar fluxos. O Tableau Prep Conductor faz parte do Tableau <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/prep/pt-br/prep_conductor_get_started.htm" target="_blank">Sobre o Tableau Prep Conductor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Tableau Catalog</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Desativa os recursos do Catalog quando o site do Tableau Server ou Tableau Cloud é licenciado com <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#disable-catalog" target="_blank">Desabilitar o Catalog</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Configurações de e-mail</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Especifica o endereço e o rodapé de mensagens vistos em e-mails automáticos para alertas e assinaturas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Desempenho da pasta de trabalho após uma atualização agendada</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Pré-calcula pastas de trabalho visualizadas recentemente com atualizações programadas para abri-las mais rapidamente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_workbook_scheduled_refresh.htm" target="_blank">Configurar desempenho da pasta de trabalho após uma atualização agendada</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Métricas de desempenho da pasta de trabalho</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite que os usuários do site coletem métricas sobre o desempenho das pastas de trabalho, como a rapidez com que carregam. Para iniciar o registro, os usuários devem adicionar um parâmetro à URL da pasta de trabalho. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_record_create_server.htm" target="_blank">Criar um registro de desempenho</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Limpeza do keychain gerenciado</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite que os administradores do site gerenciem keychain de credenciais salvas para conexões OAuth no site. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/protected_auth.htm#removing-unused-keychain-records" target="_blank">Conexões OAuth</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Suspender automaticamente tarefas de atualização da extração</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para economizar recursos, o Tableau pode suspender automaticamente as tarefas de atualização de extração para pastas de trabalho inativas. Esse recurso se aplica apenas a agendas de atualização executadas semanalmente ou com mais frequência. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/extract_auto_suspend.htm" target="_blank">Suspender automaticamente as atualizações de extração para pastas de trabalho inativas</a> na Ajuda do Tableau Cloud.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Visibilidade do usuário</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla quais nomes de usuários e grupos são visíveis para outros usuários. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/user_visibility.htm" target="_blank">Gerenciar visibilidade do usuário</a> na ajuda do Tableau Cloud.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Disponibilidade de Pergunte aos dados</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se o Pergunte aos dados está ativado ou desativado por padrão para fontes de dados. Pergunte aos dados permite que os usuários consultem dados usando linguagem coloquial e veja automaticamente visualizações. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/ask_data.htm" target="_blank">Criar exibições automaticamente com o Pergunte aos dados (Ask Data)</a> na Ajuda do usuário do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Disponibilidade de Explique os dados</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se os usuários do site com as permissões apropriadas podem executar o Explique os dados e os autores podem acessar as configurações do Explique os dados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm" class="xref">Controle de acesso a Explique os dados</a>. Para saber mais sobre Explique os dados, consulte <a href="https://help.tableau.com/current/server/pt-br/explain_data.htm" class="xref">Descobrir insights mais rápido com Explique os dados</a> .</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Acesso automático a metadados sobre bancos de dados e tabelas</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Concede automaticamente aos usuários certos recursos para ativos externos usando permissões derivadas. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/dm_perms_assets.htm#derived_checkbox" target="_blank">Desativar permissões derivadas</a> na ajuda do Tableau Cloud.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Dados de linhagem confidenciais</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Especifica se os dados de linhagem confidenciais devem ser ofuscados ou filtrados quando os usuários não tiverem as permissões apropriadas aos metadados relacionados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/dm_perms_assets.htm#lineage_checkbox" target="_blank">Dados de linhagem de confidenciais</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><strong>Criptografia de extrações em repouso</strong></p><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite criptografar extrações .hyper enquanto elas são armazenadas no Tableau Server. Os administradores do Server podem impor a criptografia de todas as extrações no site ou permitir que os usuários criptografem todas as extrações associadas a determinadas pastas de trabalho publicadas ou fontes de dados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/security_ear.htm" target="_blank">Criptografia de extrações em repouso</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Tableau Mobile</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li><p>Ativar visualizações offline</p><p>Controla se as visualizações offline são geradas para exibição, quando os usuários acessam o site no Tableau Mobile. Para obter mais informações, consulte <a href="https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_snapshots.htm" target="_blank">Dados móveis do Tableau Desktop nos dispositivos</a> no Guia de implantação do Tableau Mobile.</p></li><li><p>Habilitar bloqueio de aplicativo</p><p>Requer um método biométrico ou senha do dispositivo para que os usuários abram o site no Tableau Mobile. Para obter mais informações, consulte <a href="https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_sso.htm#enable-app-lock-for-added-security" target="_blank">Habilitar bloqueio de aplicativos para adicionar segurança</a> no guia de implantação do Tableau Mobile.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Compartilhar </strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite que os usuários compartilhem itens diretamente com outros usuários. Quando um item é compartilhado, os destinatários recebem uma notificação e o item é adicionado à sua página Compartilhado comigo. Se isso não estiver ativado, os usuários só poderão copiar um link para compartilhar. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/shareworkbooks.htm" target="_blank">Compartilhar conteúdo da Web</a> na Ajuda do usuário do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Comentários</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se os usuários podem adicionar observações em um painel lateral de Comentários para cada exibição e exibe um @mention a outros usuários do Tableau para notificá-los por e-mail. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/comment.htm" target="_blank">Comentários nas exibições</a> na Ajuda do usuário do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Alertas orientados por dados</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite que os usuários recebam e-mails automaticamente quando os dados atingem os limites-chave. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/data_alerts.htm" target="_blank">Enviar alertas direcionados por dados</a> na Ajuda do usuário do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Marcação</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Especifica o número de marcas que os usuários podem adicionar aos itens. O limite padrão é 50 marcas e o máximo é 200. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/tags.htm" target="_blank">Usar marcas</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Recomendações para exibições</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se as recomendações aparecem no site e se os nomes dos usuários que olharam os itens recomendados mostram nas dicas de ferramentas de recomendação.<p class="note"><b>Observação:</b> se você usar o Tableau Server, o administrador poderá desativar as Recomendações.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Solicitar acesso</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite que os usuários enviem solicitações de acesso aos proprietários de conteúdo ou projetos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/Request_access.htm" target="_blank">Permitir que os usuários do site solicitem acesso ao conteúdo</a> na Ajuda do Tableau Cloud.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Uniões cruzadas de banco de dados</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Determina onde o processo de união acontece ao combinar dados de várias fontes. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/joining_tables.htm#integration" target="_blank">Combinar tabelas de diferentes bancos de dados</a> na Ajuda do usuário do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Tipo de conteúdo de métricas</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Controla se as métricas estão disponíveis no site. Quando ativado, os usuários podem criar métricas com base em visualizações e elas aparecem como um tipo de conteúdo. Quando desativadas, as métricas não aparecerão no site nem continuarão a sincronizar; no entanto, você pode habilitar novamente o recurso para trazer de volta métricas criadas anteriormente. Para obter mais informações, consulte "Configurar para Métricas" na <a href="https://help.tableau.com/current/online/pt-br/metrics_admin.htm" target="_blank">Ajuda do Tableau Cloud</a> ou <a href="https://help.tableau.com/current/server/pt-br/metrics_admin.htm" target="_blank">Ajuda do Tableau Server</a>.</p><div class="note--warning"><p><strong>Descontinuação do recurso de métricas herdado</strong></p><p>O recurso de métricas herdado do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3. Com o Tableau Pulse, desenvolvemos uma experiência aprimorada para monitorar métricas e fazer perguntas sobre seus dados. Para obter mais informações, veja <a href="https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm">Criar métricas com o Tableau Pulse</a> para conhecer a nova experiência e <a href="https://help.tableau.com/current/online/pt-br/metrics_create.htm">Criar e solucionar problemas de métricas (descontinuado)</a> para o recurso descontinuado.</p></div></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Fuso horário do site para extrações</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O fuso horário padrão para as fontes de dados baseadas em extrações em um site é o Tempo Universal Coordenado (UTC). Os administradores de site podem definir um fuso horário diferente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/tz_for_extracts.htm" target="_blank">Definir o fuso horário do site para extrações</a> na Ajuda do Tableau Cloud.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Executar agora </b><p>Em servidores de vários sites, isso aparece nas Configurações do servidor (na parte inferior da página) e nas Configurações do site.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Os administradores do servidor podem usar esta configuração para permitir ou impedir que os usuários executem as atualizações de extração, execuções de fluxo e assinaturas manualmente. Essa configuração pode ser aplicada no nível do servidor para incluir todos os sites no Tableau Server ou aplicada no nível do site para incluir apenas sites específicos.</p><ul><li>Por padrão, essa opção é definida para permitir que os usuários executem os trabalhos manualmente. Limpe a caixa de seleção para evitar que os usuários executem os trabalhos manualmente.</li><li>Isso se aplica apenas aos trabalhos iniciados manualmente por um usuário na interface da Web, chamadas de API REST ou comandos tabcmd. Os trabalhos iniciados nas tarefas agendadas continuarão a ser executados no horário da agenda e não serão afetados.</li><li>Selecione <span class="uicontrol">Executar agora</span> para permitir que os usuários alterem o tipo de conexão (Em tempo real/Extração) de fontes de dados na Web.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Gerenciar notificações</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla como os usuários do site podem receber notificações para eventos como extrações de trabalhos, execuções de fluxo ou quando outro usuário compartilha conteúdo com eles ou os menciona em um comentário. As notificações podem ser vistas em seu site do Tableau através do centro de notificação ou enviadas por e-mail. Quando uma notificação é ativada, os usuários podem configurar as preferências de notificação na página Configurações de conta.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Inscrições de fluxo</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se os proprietários de fluxo podem agendar e enviar e-mails com dados de saída de fluxo para si mesmos e para outras pessoas. Ao permitir assinaturas de fluxo, você pode controlar se os dados de saída de fluxo são incluídos no e-mail de assinatura e se os arquivos de saída de fluxo são anexados ao e-mail. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/prep_conductor_subscribe_to_flow.htm" class="xref">Notificar usuários sobre execuções de fluxo bem-sucedidas</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Objetos de página da Web</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se esses objetos do painel podem exibir URLs de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/dashboards_create.htm#Be_security-savvy" target="_blank">Segurança para objetos da página da Web</a> na Ajuda do usuário do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Espaço pessoal</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite que os usuários do site Creator e Explorer criem e salvem conteúdo em um Espaço pessoal privado. Quando o Espaço pessoal está ativado, você pode definir os limites de armazenamento do usuário. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/personal_space.htm" class="xref">Criar e editar conteúdo privado no espaço pessoal</a> .</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Coleções</strong><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se as coleções estão disponíveis. Quando você ativa as coleções, os usuários podem criar coleções para organizar o conteúdo e navegar pelas coleções disponibilizadas por outros usuários. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/collections.htm">Organizar itens em uma coleção</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Registro de clientes OAuth</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para um subconjunto de conectores, você pode registrar um cliente OAuth personalizado para o site e substituir um cliente OAuth que foi configurado para o servidor. Ao registrar um cliente OAuth personalizado, você habilita conexões novas e existentes para usar o cliente OAuth no nível do site, em vez do cliente OAuth em todo o servidor. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/protected_auth.htm#custom_oauth_server" class="xref">Configurar um Oauth personalizado para um site</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Aceleração da exibição</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se os usuários do site Creator e Explorer podem acelerar as exibições em suas pastas de trabalho do <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> para tempos de carregamento mais rápidos. Ao permitir a aceleração de exibição, você pode definir um número máximo de exibições a serem aceleradas e pode optar por suspender automaticamente a aceleração para exibições que falham repetidamente na tarefa de aceleração. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/data_acceleration.htm">Aceleração de exibição</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">Página inicial</span></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Vincula você à página inicial padrão atual do servidor para todos os usuários. Para obter informações sobre como alterar a página inicial padrão, consulte <a href="https://help.tableau.com/current/server/pt-br/maintenance_startpg.htm" class="xref">Definir a página inicial padrão para todos os usuários</a>. Os usuários individuais poderão substituir essa configuração (consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm" target="_blank">Acessar suas configurações de perfil e conta</a> para obter detalhes).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Acesso de visitantes </b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite que os usuários visualizem e interajam com exibições inseridas sem precisar entrar em uma conta do Tableau Server. A permissão pode ser atribuída à conta de usuário convidado para controlar a interatividade permitida para cada exibição. Essa opção estará disponível somente se você tiver uma licença de servidor baseada em núcleo.<p>Esta opção pode ser usada com <span class="uicontrol">Habilitar logon automático</span>, uma opção que pode ser selecionada durante a <a href="https://help.tableau.com/current/server/pt-br/config_general.htm">Instalação</a>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Credenciais inseridas ao conteúdo </strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li><p>Permitir que os publicadores insiram credenciais em uma fonte de dados, fluxo ou pasta de trabalho</p><p>Permite que publicadores anexem senhas a pastas de trabalho publicadas ou fluxos que autenticarão automaticamente usuários da Web para se conectarem a fontes de dados. As senhas são anexadas às pastas de trabalho ou entradas de fluxo e só podem ser acessadas no servidor. Por exemplo, quando uma pasta de trabalho é aberta no <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>, os usuários ainda precisarão inserir um nome de usuário e uma senha para se conectarem à fonte de dados. Quando essa configuração é desativada, todas as senhas inseridas existentes são salvas, mas não são usadas para autenticação. Se você ativar novamente essa configuração, os usuários não precisarão reinserir as senhas.</p></li><li><p>Permitir que os editores agendem execuções de fluxo e atualizações de extração</p><p>Permite que os publicadores atribuam pastas de trabalho ou fluxos a agendas. Essa opção só estará disponível se <span class="uicontrol">Permitir que os publicadores incorporem credenciais em uma fonte de dados, fluxo ou pasta de trabalho</span> estiver habilitada. Quando essa configuração estiver habilitada, os usuários do Tableau Desktop verão opções de agendamento na caixa de diálogo Publicar.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="sign_in_custom"></a><b>Personalização de logon</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Adicionar uma nota personalizada à página de logon do servidor. A configuração de logon permite adicionar texto. Você pode adicionar opcionalmente uma URL para tornar o texto um link. Essa nota também aparecerá se um usuário receber um sinal de erro.</p><p>As notas personalizadas não são exibidas no Tableau Mobile. Se o Tableau Server estiver configurado com <a href="https://help.tableau.com/current/server-linux/pt-br/identity_pools.htm" target="_blank">grupos de identidade</a>, a observação Personalização de logon aparece na página inicial do Tableau Server abaixo de todas as opções de logon e na página em que os usuários do pool inicial (TSM configurado) inserem seu nome de usuário e senha.</p><p>Para definir uma nota personalizada, entre em um site no <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>. No painel de navegação à esquerda, selecione <span class="uicontrol">Gerenciar todos os sites</span> na lista suspensa de sites. Selecione <span class="uicontrol">Configurações</span> e adicione uma mensagem para <span class="uicontrol">Personalização de logon</span>.</p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/customize.htm" class="xref">Personalizar seu servidor</a>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="Recommendations_admin"></a><strong>Cronograma de treinamento de recomendações</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">As recomendações têm duas formas: recomendações de fontes de dados e tabelas (para o Tableau Desktop) e recomendações de exibições (para o Tableau Server). As recomendações são baseadas na popularidade do conteúdo e no conteúdo usado por outros usuários determinados como similares ao usuário atual.<p>O cronograma de treinamento controla a frequência das verificações do servidor por novo conteúdo e novas informações de uso para manter as recomendações atualizadas. Conteúdo novo inclui fontes de dados e pastas de trabalho novas e atualizadas. Informações de uso novas incluem informações como "Laura Rodriquez usou a fonte de dados Serviços de catering" e "Henry Wilson acessou a exibição de Vendas mensais".</p><p>Se notar um impacto no desempenho do servidor, agende esse processo para ocorrer numa hora quando a carga do servidor estiver baixa. Para rastrear o impacto no desempenho, procure pelas tarefas “Treinador de recomendações” ou “Exibir treinador de recomendações” na exibição <a href="https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm" class="xref">Tarefas em segundo plano para não extrações</a>.</p><p>Se desejar desabilitar as Recomendações, altere a opção do <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#recommendations">tsm configuration set</a>, “recommendations.enabled”, para false. Se você quiser desativar apenas recomendações de exibições, altere a opção “recommendations.vizrecs.enabled” para false.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">Clientes conectados </span></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla se os usuários móveis devem entrar e fornecer as credenciais sempre que se conectarem ao Tableau Server, ou se os usuários podem se conectar com os próprios dispositivos ao Tableau Server, sem fornecer credenciais após eles autenticarem os dispositivos com êxito pela primeira vez. Por obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/devices_connected_credentials.htm" class="xref">Desabilitar a autenticação do cliente</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Idioma e localidade</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla o idioma usado para a interface de usuário do servidor e a localidade usada para exibições. Os usuários individuais podem substituir essa configuração na sua página de Configurações de conta. Além disso, as configurações do navegador da Web são avaliadas primeiro para determinar em qual idioma e local devem ser usadas. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/lang_intro.htm" class="xref">Idioma e localidade do Tableau Server</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Credenciais salvas para as fontes de dados </b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li><p>Permitir que os usuários salvem as senhas para fontes de dados</p><p>Permite que os usuários escolham "Lembrar minha senha" e salvem as senhas de fonte de dados entre várias visitas, navegadores e dispositivos. (Por padrão, os usuários podem escolher "Lembrar minha senha até eu fazer logout", que permite salvar a senha somente para uma única sessão do navegador.)</p><p>Como administrador, você pode <a href="https://help.tableau.com/current/server/pt-br/maintenance_clearpw.htm">apagar todas as senhas salvas</a> a qualquer momento. Além disso, os usuários podem limpar suas próprias senhas salvas.</p></li><li><p>Permitir que usuários salvem tokens de acesso OAuth para fontes de dados</p><p>Os usuários podem armazenar tokens de acesso com suas preferências de usuário. Os tokens de acesso são fornecidos por fontes de dados na nuvem que dão suporte a conexões OAuth e são usados no lugar de nomes de usuário e senhas para conceder acesso aos dados.</p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/protected_auth.htm" class="xref">Conexões OAuth</a></p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">Tarefas vinculadas</span><p>Em servidores de vários sites, isso aparece nas Configurações do servidor e nas Configurações do site.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Os administradores de servidor podem usar esta configuração para permitir que os usuários agendem tarefas de fluxo para serem executadas em sequência. Eles também podem permitir que os usuários acionem as tarefas de fluxo agendadas para execução usando <span class="uicontrol">Executar agora</span>.</p><p>Essa configuração pode ser aplicada no nível do servidor para incluir todos os sites no Tableau Server. A configuração pode ser desabilitada no nível do site para incluir apenas sites específicos.</p><p>Se a configuração for desabilitada depois que as tarefas vinculadas forem agendadas, todas as tarefas em execução serão concluídas, e as tarefas vinculadas agendadas serão ocultadas e não serão mais exibidas na guia <span class="uicontrol">Tarefas agendadas</span>.</p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm#linked_tasks" target="_blank">Agendar tarefas vinculadas</a>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><span class="uicontrol">Parâmetros de fluxo</span></p><p>Em servidores de vários sites, isso aparece nas Configurações do servidor e nas Configurações do site.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Permite que os usuários planejem e executem fluxos que incluem parâmetros.<br></p><p>Os administradores também podem ativar os parâmetros de fluxo para aceitar qualquer valor. Se esta opção for ativada, qualquer usuário de fluxo pode inserir qualquer valor em um parâmetro, potencialmente expondo dados aos quais o usuário não deve ter acesso.</p><p>Os parâmetros podem ser inseridos em uma etapa de entrada para nome de arquivo e caminho, nome de tabela ou ao usar consultas SQL personalizado, em uma etapa de saída para nome de arquivo e caminho e nome de tabela, e em qualquer tipo de etapa para filtros ou valores calculados.</p><p>As configurações de parâmetro de fluxo podem ser aplicadas no nível do servidor para incluir todos os sites no Tableau Server. As configurações podem ser desabilitadas no nível do site para incluir apenas sites específicos.</p><p>Para obter mais informações sobre como usar parâmetros, consulte <a href="https://help.tableau.com/current/prep/pt-br/prep_parameters.htm" target="_blank">Criar e usar parâmetros em fluxos</a> na ajuda do Tableau Prep.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Sincronização do Active Directory</strong><p>Só aparece quando o servidor é configurado para armazenamento de identidade AD.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controla a sincronização de todos os grupos do Active Directory no <span class="mc-variable Variables.ProductName variable">Tableau Server</span> com base em uma agenda que você especifica após selecionar a opção <span class="uicontrol">Sincronizar os grupos do Active Directory regularmente</span>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/groups_globalsync.htm#assertions" class="xref">Sincronizar os grupos do Active Directory no servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Redefinir configurações padrão</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Retorna qualquer configuração de servidor descrita aqui que foi alterada desde a configuração para o estado original.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="assertions"></a><b>Asserções para associações em grupo</b><p>Em servidores de vários sites, isso aparece nas páginas Configurações do servidor e Configurações do site.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Permite que a associação ao grupo local seja controlada e gerenciada pelo IdP ou por meio do aplicativo conectado, afirmando dinamicamente a associação ao grupo quando um usuário se autentica no Tableau Server. Requer configuração adicional na asserção SAML ou no token web JSON (JWT). Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/groups_create_local.htm#assertions" class="xref">Associação dinâmica a grupos usando asserções</a>.</p><p><b>Observação:</b> essa configuração em todo o servidor deve ser habilitada para permitir que a configuração em nível de site seja habilitada.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a name="group_sets"></a><b>Conjuntos de grupos</b><p>Move-se para configurações do site em servidores de vários sites.</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Habilita a página<span class="uicontrol"> Conjuntos de grupos</span> e a capacidade de criar conjuntos de grupos. Conjuntos de grupos podem ser usados por determinados usuários (administradores de servidor, administradores de sites, proprietários de projetos e proprietários de conteúdo) para aplicar regras de permissão que exigem que os usuários sejam membros de todos os grupos no conjunto de grupos para acessar conteúdo cujas permissões dependem do conjunto de grupos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/group_sets.htm" class="xref">Trabalhar com conjuntos de grupos</a>.</td></tr></tbody></table>

## Personalização

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 261px;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: left;">Configuração</th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: left;">Descrição</th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Banner de boas-vindas</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Adicione uma mensagem personalizada ao banner de boas-vindas na página inicial para que todos os usuários do servidor a vejam. A mensagem personalizada pode conter até 240 caracteres de texto e hiperlinks, além de uma pausa parágrafo. Os administradores também podem desabilitar o banner de boas-vindas padrão do Tableau para o servidor.</p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/customize.htm" class="xref">Personalizar seu servidor</a>.</p></td></tr></tbody></table>

## Dispositivos móveis

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col style="width: 196px;"><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td><strong>Tableau Mobile</strong></td><td><p>&nbsp;</p></td></tr><tr><td>Bloqueio do aplicativo</td><td>Requer um método biométrico ou senha do dispositivo para que os usuários abram o site no Tableau Mobile. Para obter mais informações, consulte <a href="https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_sso.htm#enable-app-lock-for-added-security" target="_blank">Habilitar bloqueio de aplicativos para adicionar segurança</a> no guia de implantação do Tableau Mobile.</td></tr><tr><td>Visualizações off-line</td><td>Controla se as visualizações offline são geradas para exibição, quando os usuários acessam o site no Tableau Mobile. Para obter mais informações, consulte <a href="https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_snapshots.htm" target="_blank">Dados móveis do Tableau Desktop nos dispositivos</a> no Guia de implantação do Tableau Mobile.</td></tr><tr><td><strong>Política de segurança do Mobile</strong><p>Adicionado na versão 2023.1. 0</p></td><td>Algumas políticas de segurança são ativadas automaticamente e não podem ser desativadas. As políticas de segurança móveis não estão disponíveis para versões MAM do Tableau Mobile.<p><strong>Observação:</strong> as políticas de segurança móvel configuradas no nível do site substituem as políticas de segurança móvel no nível do servidor.</p></td></tr><tr><td><p>Detecção de jailbreak</p></td><td>Controla se um usuário do aplicativo Tableau Mobile com um dispositivo com "jailbroken" ou "root" tem permissão para acessar o conteúdo no Tableau e qual nível de resposta ocorre quando um dispositivo com jailbreak ou rooting é detectado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.</td></tr><tr><td>Detecção de malware (somente Android)</td><td>Controla se a detecção de malware está habilitada para dispositivos móveis e qual nível de resposta ocorre quando o malware é detectado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<br></td></tr><tr><td>Máximo de dias offline sem atualização da política</td><td>Controla se há um número máximo de dias que um dispositivo móvel pode ficar offline e ainda usar o aplicativo. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<br></td></tr><tr><td>Impedir a depuração</td><td>Controla se os depuradores são impedidos em dispositivos móveis. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<br></td></tr><tr><td>Compartilhamento de tela e capturas de tela (somente Android)</td><td>Controla se um usuário do Tableau Mobile pode fazer capturas de tela ou usar o compartilhamento de tela enquanto estiver no aplicativo. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<br></td></tr></tbody></table>

<!-- document id=0737d057e3342e7d27d369d25e2d74ef6e95314daea423415934e82fd5937ede url=/tableau/current/pt-br/server/runas_confirm.md -->

[Pular para o conteúdo principal](#main-content)

# Configurações exigidas da conta de serviço Run As

A conta de serviço Run As precisa de permissões que permitam modificar configurações de arquivos e registro. Além disso, devido à conta de serviço Run As ser usada como o contexto de segurança do serviço do Gerenciador de aplicativo do Tableau Server (tabsvc), é preciso que a conta receba direitos para fazer logon como um serviço.

Essas permissões são definidas automaticamente quando você atualiza a conta de serviço Run As na Configuração do Tableau Server como descrito no tópico [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm).

Se você alterou a conta de serviço Run As, recomendamos revogar as permissões da conta anterior. Consulte [Revogar permissões da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_change.htm).

A conta que você usa para serviço Run As não deve ser membro da conta Administradores locais ou Administradores de domínio. Em vez disso, recomendamos o uso de uma conta de usuário de domínio que não seja um administrador da conta de serviço Run As. Usar uma conta de domínio que não seja membro desses grupos de administradores é uma boa prática de segurança e pode ajudar a evitar o acesso a certas fontes de dados e pastas. Para obter informações sobre as práticas recomendadas ao criar uma conta de serviço Run As, consulte [Criação da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm#best) .

Caso tenha alterado a conta de serviço Run As recentemente ou esteja recebendo erros de permissão, use esta seção para confirmar se o Tableau Server atende aos requisitos de permissão detalhados aqui. Se estiver executando uma instalação distribuída, todas as configurações de permissão da conta de serviço Run As devem ser as mesmas em todos os nós.

**Observação:** Não oculte os arquivos criados pelo instalador do Tableau Server.

## Outros artigos nesta seção

<!-- document id=0b002b7cf54b9bfb8d0245019c71296690eeba6598c3f974d522a398c801e9e4 url=/tableau/current/pt-br/server/config_einstein_extensions.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar a Integração de Einstein Discovery

Iniciando na versão 2021.1.0, o Tableau Server é compatível com a integração com o Einstein Discovery, disponibilizando previsões do Einstein Discovery para criadores e visualizadores de pastas de trabalho e painéis. A partir da versão 2021.2.0, as previsões do Einstein Discovery também estão disponíveis ao criar fluxos na Web.

O Einstein Discovery no Tableau é alimentado por [salesforce.com](http://salesforce.com/). Consulte seu contrato com a [salesforce.com](http://salesforce.com/) para obter os termos aplicáveis.

Para integrar o Einstein Discovery ao Tableau Server, existem várias etapas de configuração necessárias, incluindo algumas no Tableau Server, e algumas na organização Salesforce executando o Tableau CRM. Esta visão geral descreve essas etapas para extensões do painel, extensões do Analytics e extensões do Tableau Prep e fornece links para tópicos específicos com etapas para concluir a configuração do servidor.

Para obter detalhes sobre como usar as previsões do Einstein Discovery no Tableau, incluindo requisitos de licenciamento e permissão, consulte [Integrar as previsões do Einstein Discovery no Tableau](https://help.tableau.com/current/pro/desktop/pt-br/einstein_discovery_predictions.htm) no Tableau Desktop e na Ajuda de Criação na Web. Para obter informações sobre como adicionar previsões em fluxos, consulte [Adicionar previsões do Einstein Discovery ao seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_predictions.htm) .

## Extensão do painel do Einstein Discovery

A extensão do painel Einstein Discovery permite que os criadores da pasta de trabalho apareçam em tempo real no Tableau. A extensão do painel oferece previsões interativamente, sob demanda, usando dados de origem em uma pasta de trabalho do Tableau e um modelo baseado no Einstein Discovery implantado no Salesforce.

Para configurar o Tableau Server para a extensão do painel do Einstein Discovery ou a extensão do Analytics você precisa fazer o seguinte:

1. No Tableau Server:
    1. Habilite tokens OAuth salvos para conexões de dados e extensões no Tableau Server. [Permitir tokens de acesso salvos](https://help.tableau.com/current/server/pt-br/allow_saved_tokens.htm)
    2. Habilite extensões do painel para o servidor. Consulte [Gerenciar extensões de painel e visualização no Tableau Server](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm)
2. No Salesforce, na organização que executa o Einstein Discovery:
    1. [Configurar CORS no Salesforce.com para integração do Einstein Discovery no Tableau Server](https://help.tableau.com/current/server/pt-br/config_cors_sfdc.htm).
    2. No Salesforce, na organização que executa o Tableau CRM, crie um aplicativo conectado. Consulte [Etapa 1: configurar a integração de aplicativo no Salesforce](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm#createSF-connectedApp).
3. No Tableau Server, configure o servidor para credenciais SF OAuth salvas usando informações do aplicativo conectado. [Etapa 2: configurar Tableau Server para Salesforce.com OAuth](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm#configServerSF-SavedOAuth)

## Extensão de análise do Einstein Discovery

A extensão de análise Einstein Discovery oferece a seus usuários a capacidade de inserir previsões diretamente nos campos calculados do Tableau. Um script de cálculo de tabela solicita previsões de um modelo implementado no Salesforce ao passar a ID de previsão associada e dados de entrada exigidos pelo modelo. Use o Gerenciador de modelo no Salesforce para gerar automaticamente um script de cálculo de tabela tableau e, em seguida, cole esse script em um campo calculado para uso em uma pasta de trabalho do Tableau.

Para configurar o Tableau Server para a extensão analítica do Einstein Discovery ou do Analytics você precisa fazer o seguinte:

1. No Tableau Server:
    1. Habilite tokens OAuth salvos para conexões de dados e extensões no Tableau Server. [Permitir tokens de acesso salvos](https://help.tableau.com/current/server/pt-br/allow_saved_tokens.htm)
    2. Habilite extensões analíticas para o servidor e configure um tipo de conexão. Consulte:[Configurar conexões com extensões do Analytics](https://help.tableau.com/current/server/pt-br/config_r_tabpy.htm)
2. No Salesforce, na organização que executa o Einstein Discovery, crie um aplicativo conectado. Consulte [Etapa 1: configurar a integração de aplicativo no Salesforce](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm#createSF-connectedApp).
3. No Tableau Server, configure o servidor para credenciais SF OAuth salvas usando informações do aplicativo conectado. [Etapa 2: configurar Tableau Server para Salesforce.com OAuth](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm#configServerSF-SavedOAuth)

## Extensões Einstein Discovery no Tableau Prep

_Compatível com Tableau Server e Tableau Cloud a partir da versão 2021.2.0_

A extensão Einstein Discovery no Tableau Prep permite que os usuários incorporem previsões do Einstein diretamente em seus fluxos ao criar fluxos na Web.

Para configurar o Tableau Server ou Tableau Cloud para a extensão Einstein Discovery no Tableau Prep, você precisa fazer o seguinte:

1. No Tableau Server:
    1. Habilite tokens OAuth salvos para conexões de dados e extensões no Tableau Server. Consulte [Permitir tokens de acesso salvos](https://help.tableau.com/current/server/pt-br/allow_saved_tokens.htm)
    2. Habilite extensões do Tableau Prep para o servidor. Consulte [Habilitar as extensões do Tableau Prep](https://help.tableau.com/current/server/pt-br/web_author_flows.htm#prep_extensions) .
2. No Salesforce, na organização que executa o Einstein Discovery, crie um aplicativo conectado. Consulte [Etapa 1: configurar a integração de aplicativo no Salesforce](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm#createSF-connectedApp).
3. No Tableau Server, configure o servidor para credenciais SF OAuth salvas usando informações do aplicativo conectado. [Etapa 2: configurar Tableau Server para Salesforce.com OAuth](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm#configServerSF-SavedOAuth)

## Outros artigos nesta seção

<!-- document id=707468e9444980c5a426c0348330d3b46f1760331b435af1207fc09748403a00 url=/tableau/current/pt-br/server/browser_rendering.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar a renderização do lado do cliente

Quando o usuário navega até uma exibição no Tableau Server, o processamento necessário para mostrar a exibição, chamada _renderização_, pode ser realizado pelo seu dispositivo cliente ou pelo Tableau Server. A escolha depende da complexidade da exibição, que é determinada pelo número de marcas, linhas, colunas e muito mais. Se um modo de exibição for menos complexo, é mais rápido para um dispositivo cliente renderizar a exibição. Se uma exibição for menos complexa, será mais rápido enviar uma solicitação ao Tableau Server e utilizar a maior potência de computação do servidor.

**Nota:** há situações em que a renderização do lado do servidor é sempre executada, incluindo, mas não se limitando a, se uma exibição usa o tipo de marca de polígono ou o recurso de histórico de página. Nesses casos, a renderização do lado do servidor é feita, mesmo se a renderização feita pelo cliente estiver habilitada.

## Navegadores suportados

A renderização no lado do cliente é compatível com o Internet Explorer versão 9.0 ou posterior, o Firefox, o Chrome e o Safari. Todos esses navegadores da Web incluem o elemento HTML 5 `<canvas>`, que é necessário na renderização do lado do cliente.

A renderização do lado do cliente também é compatível com o aplicativo do Tableau Mobile.

## Configurar o limite de complexidade para computadores e dispositivos móveis

Como os computadores têm mais potência de processamento que os dispositivos móveis, o Tableau Server realiza mais renderizações do lado do cliente em computadores que no do dispositivo móvel.

Como administrador do servidor, ajuste o limite de complexidade para configurar quando a renderização do lado do cliente acontece em computadores e dispositivos móveis. Por exemplo, você pode diminuir o limite para dispositivos móveis se perceber que neles as exibições são exibidas lentamente. Ou, aumente os limites para reduzir o número de solicitações ao Tableau Server.

Por padrão, o limiar de complexidade dos navegadores da Web em computadores é 100. Para ajustar esse limiar de complexidade em computadores, use o comando a seguir:

`tsm configuration set -k vizqlserver.browser.render_threshold -v [new value]`

Por padrão, o limiar de complexidade dos dispositivos móveis é 60. Para ajustar esse limiar de complexidade em dispositivos móveis, use o comando a seguir:

`tsm configuration set -k vizqlserver.browser.render_threshold_mobile -v [new value]`

Por exemplo, para alterar o limite móvel para 40, insira o comando a seguir:

`tsm configuration set -k vizqlserver.browser.render_threshold_mobile -v 40`

Para obter mais informações sobre como usar o conjunto de opções tsm, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

## Desabilitar a renderização do lado do cliente

Como padrão, é possível realizar a renderização do lado do cliente, sendo recomendada para melhorar o desempenho das exibições. No entanto, desabilite temporariamente a renderização do lado do cliente para realizar testes ou se o seu servidor estiver for acessado principalmente por computadores ou dispositivos móveis com mínima potência de processamento.

Use o comando tabadmin a seguir para desabilitar a renderização do lado do cliente:

`tsm configuration set -k vizqlserver.browser.render -v false`

Para obter mais informações sobre como usar o conjunto de opções tsm, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

## Teste com o parâmetro de URL

Para testar a renderização no lado do servidor com base na sessão, digite `?:render=false` no final da URL da exibição. Por exemplo:

http://localhost/views/Supplies/MyView?:render=false

Se a renderização no lado do cliente for desabilitada no Tableau Server, insira `?:render=true` para habilitá-la para a sessão.

http://localhost/views/Supplies/MyView?:render=true

Você também pode testar limites de complexidade em particular em exibições individuais para ver se é apropriado ajustar o limite em todo o servidor para suas condições de servidor e rede. Por exemplo, você poderá achar que os pontos decisivos de complexidade mais baixa (como 80) ou mais alta (como 120) resultam em mais capacidade de resposta às interações do usuário. Para testar um limite, você pode manter a configuração padrão do servidor (habilitada para renderização no lado do cliente) e inserir o número do limite de teste ao final da URL da exibição. Por exemplo:

http://localhost/views/Supplies/MyView?:render=80

<!-- document id=66511a973d92d8f6dc44a9b8280a5a7a7a19ca9e68f08353c31c429ec7b413d9 url=/tableau/current/pt-br/server/data_alerts_admin.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar alertas orientados por dados

Quando os dados atingirem limites importantes para os seus negócios, os alertas orientados por dados enviarão notificações de e-mail automaticamente para pessoas especificadas pelo usuário. Como administrador do Tableau Server, defina os alertas assim como faz com as assinaturas. Para informações sobre como os usuários criam e gerenciam esses alertas, consulte [Enviar alertas orientados](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#data_alerts.htm) na Ajuda do usuário do Tableau.

**Observação:** para criar e receber alertas orientados por e-mail, os usuários necessitam ter acesso a bancos de dados e exibições relacionados. [Consulte esta lista de requisitos](https://help.tableau.com/current/server/pt-br/subscribe_alert_access.htm) para obter detalhes. Se os alertas estiverem habilitados para um site, qualquer usuário nesse site pode criá-los, exceto os usuários na função Viewer.

## Configurar o e-mail para alertas orientados por dados

1. Conclua as etapas em [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm) para que o servidor possa enviar o e-mail.
2. Ao visualizar um site, clique em Configurações na parte superior da janela do navegador.
3. Em Configurações de e-mail, insira um endereço "De" específico do site ou um rodapé de mensagem.
    
    O rodapé da mensagem e o endereço "De" de um site também podem ser usados em e-mails para inscrições.
4. Clique em Salvar.

## Gerenciar todos os alertas orientados por dados em um site

1. Na parte superior da janela do navegador, clique em Tarefas e em Alertas.
2. Selecione os alertas que deseja atualizar.
3. No menu Ações, faça o seguinte:
    
    - Adicione ou remova seu nome como um destinatário.
    - Edite alertas para alterar os limites de dados, os agendamentos de entrega e a lista completa de destinatários.
    - Altere a propriedade de alerta para diferentes usuários ou exclua os alertas.

## Desabilitar alertas orientados por dados em um site

Os alertas orientados por dados são compatíveis a todos os sites por padrão, mas os administradores podem desabilitá-los para sites específicos.

1. Ao visualizar um site, clique em Configurações no painel de navegação do lado esquerdo.
2. Em Alertas orientados por dados, desmarque Permitir que usuários criem alertas e recebam e-mails de alerta.
3. Clique em Salvar.

## Suspender alertas orientados por dados

Por padrão, uma assinatura é suspensa depois de 350 falhas de alerta consecutivas. Os administradores de servidor podem configurar o número limite de falhas de alerta antes que uma assinatura seja suspensa. Para alterar o número limite de falhas de alerta orientado por dados que podem ocorrer antes que os alertas sejam suspensos, use a opção do [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm), `dataAlerts.SuspendFailureThreshold`.

Isso define o limite do número de falhas de alertas consecutivas necessárias antes de suspender o alerta. Esta é uma configuração em todo o servidor. O valor limite se aplica a cada alerta orientado por dados configurado no servidor.

### Retomar alertas suspensos

Se um alerta falhar muitas vezes, você receberá uma notificação por e-mail informando que ele foi suspenso. Há algumas maneiras para os administradores ou proprietários de alerta retomarem um alerta suspenso:

- Na área Tarefas > Alertas das páginas na Web do Tableau, aparece um ícone na coluna ![Ícone Suspender alertas de dados.](/tableau/current/pt-br/server/pt-br/Img/suspend.jpg)Última verificação para indicar que o alerta está suspenso. Selecione ... > Retomar alerta para retomar o alerta.
- Clique em **Retomar alerta** no e-mail de notificação para retomar o alerta. Uma notificação permitirá que você retome o alerta ou indicará que a exibição foi alterada e o alerta deve ser excluído.
- A partir do painel Alertas da exibição ou pasta de trabalho afetada. Para retomar o alerta a partir de uma exibição ou pasta de trabalho, selecione **Alerta** para abrir o painel Alertas. Um ícone aparece ao lado do alerta suspenso. Selecione Ações > Retomar alerta no alerta afetado para retomar.

Os proprietários de alerta receberão um e-mail de notificação quando o alerta estiver funcionando novamente.

## Controlar com que frequência o servidor verifica os alertas orientados por dados

Por padrão, o Tableau Server faz verificações a cada 60 minutos para confirmar se as condições dos dados para os alertas são verdadeiras. Se observar impactos no desempenho, é possível personalizar este intervalo de tempo com a opção do [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm), `dataAlerts.checkIntervalInMinutes`.

Independentemente da configuração de `dataAlerts.checkIntervalInMinute`, o servidor também verifica alertas sempre que extrações na pasta de trabalho relacionado são atualizadas. Para verificar um alerta com mais frequência do que a configuração especifica, altere o agendamento de atualizações das extrações.

## Rastrear o processo de verificação de alerta do servidor

Na exibição [Tarefas em segundo plano para não extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm), é possível controlar o processo de verificação de alertas do servidor ao procurar estas tarefas:

- Localizar alertas de dados para verificação
- Verificar se a condição de alerta de dados é verdadeira

O usuário "Localiza" e limita as tarefas de "Verificar" para alertas que podem enviar no momento e-mails relacionados. Por exemplo, se um usuário escolher a frequência de e-mail "Diariamente no máximo", após a condição do alerta tornar-se verdadeira, o servidor aguardará 24 horas antes de verificar o alerta novamente.

Cada tarefa de "Verificar" usa o processador em segundo plano de um servidor ao carregar a exibição relacionada para avaliar a condição do alerta. Se todos os usuários visualizarem a mesma versão de uma exibição, ela será carregada apenas uma vez. Porém, se os usuários aplicarem filtros a uma exibição ou os dados visualizados são limitados pela segurança no nível de usuário, a exibição será carregada uma vez para cada destinatário.

## Identificar e corrigir alertas de falha

Como administrador, você pode proativamente identificar alertas com falha dos quais os usuários podem não estar cientes. Para verificar:

1. Selecione Status no menu do site.
2. Selecione Tarefas em segundo plano para não extrações.
3. No menu suspenso Tarefa, selecione a opção Verificar se o alerta de dados é verdadeiro.
4. Na extrema direita, clique em Erro para ver uma lista de alertas com falha.
5. Focalize o ícone de falha vermelho para exibir uma dica de ferramenta com detalhes do alerta.

Para determinar o proprietário do alerta, procure o número da ID do alerta na [tabela data\_alerts](https://help.tableau.com/current/server/pt-br/data_dictionary.htm#data_alerts_anchor) do Repositório do Tableau Server. (Na área de [gerenciamento de alerta](#Manage) de um site, você também pode procurar o nome do alerta abaixo do número, mas esteja ciente de que diversos alertas podem usar o mesmo nome.)

**Observação:** os proprietários de alertas serão automaticamente notificados quando um alerta falhar dez vezes. Os administradores podem personalizar quando os proprietários de alertas recebem notificações. Os usuários não serão notificados dos alertas que falharam antes da atualização para o Tableau Server 2018.1.

![Um alerta de verificação de dados com informações sobre o alerta e o ID do alerta de dados destacado.](/tableau/current/pt-br/server/pt-br/Img/alert_failure.png)

Normalmente, os alertas com falhas são causados por alterações de conteúdo noTableau Server. Incentive os usuários a recriar alertas caso ocorram alterações como estas:

- O campo de uma pasta de trabalho, de uma exibição ou de dados é removido ou renomeado.
- As credenciais de banco de dados inseridas nas pastas de trabalho expiram.
- Os alertas baseados em dados exigem credenciais incorporadas para conexões em tempo real. O uso de OAuth não é atualmente compatível com alertas.
- Uma fonte de dados se torna inacessível.

**Dica:** para receber um e-mail de forma automática quando os alertas falham, siga as etapas em [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm)e conecte-se com a tabela "background\_jobs". Nessa tabela, crie uma exibição personalizada que inclua o nome do trabalho "Verificar se a condição de alerta de dados é verdadeira" e seu código de conclusão. Depois, [configure um alerta orientado por dados](https://help.tableau.com/current/pro/desktop/pt-br/data_alerts.htm) para receber por e-mail sempre que um código de conclusão for igual a 1 (falha).

<!-- document id=3e631ac133576ee5625b38892f4dbc505f0d0c8add7e30c00f2c25e07d4df349 url=/tableau/current/pt-br/server/connected_apps_direct.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar aplicativos conectados com confiança direta

A partir do Tableau Server versão de 2022.1, os aplicativos conectados ao Tableau permitem uma experiência de autenticação perfeita e segura, facilitando uma relação de confiança explícita entre seu site do Tableau Server e aplicativos externos.

**Observações:**

- A funcionalidade de aplicativos conectados, sem interface do usuário, para o Tableau Server ficou disponível no Tableau Server versão 2021.4 através dos [métodos do aplicativo conectado](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_connected_app.htm) na API REST do Tableau.
- Para habilitar a inserção por meio de aplicativos conectados, o Tableau Server deve ser configurado para usar SSL para tráfego HTTP.
- Para que o token de sessão seja válido, os relógios do aplicativo externo e do servidor que hospeda o aplicativo externo devem ser definidos como Tempo Universal Coordenado (UTC). Se um dos relógios usar um padrão diferente, o aplicativo conectado não será confiável.

## Como os aplicativos conectados do Tableau funcionam com confiança direta

A relação de confiança entre o site do Tableau Server e o aplicativo externo é estabelecida e verificada por meio de um token de autenticação no padrão JSON Web Token (JWT), que usa um segredo compartilhado fornecido pelo aplicativo conectado ao Tableau e assinado pelo seu aplicativo externo.

### Principais componentes de um aplicativo conectado

Os seguintes componentes do conectado trabalham em conjunto com o JWT em seu aplicativo externo para autenticar usuários e exibir conteúdo inserido.

- **Segredos:** os segredos são chaves compartilhadas pelo Tableau e seu aplicativo externo. Eles são usados em assinaturas que formam o JWT. Um segredo é necessário ao usar aplicativos conectados para autenticação de inserção ou autorização da API REST. Os segredos podem ser criados em um aplicativo conectado, não expiram e permanecem válidos até serem excluídos.
- **Lista de permissões de domínio (pastas de trabalho inseridas somente):** você pode especificar uma lista de domínios permitidos em cada aplicativo conectado. O conteúdo do Tableau inserido por meio de um aplicativo conectado só é permitido nos domínios especificados. Isso ajuda a garantir que o conteúdo seja exposto nos domínios protegidos e aprovados por sua empresa.
- **Nível de acesso (pastas de trabalho inseridas somente):** você pode especificar qual conteúdo pode ser inserido, por meio de um aplicativo conectado, associando um aplicativo conectado a um projeto ou a todos os projetos. Se você especificar um projeto, apenas o conteúdo do projeto selecionado pode ser inserido por meio do aplicativo conectado. Se quiser especificar vários projetos, você deverá usar a API REST do Tableau.

### Fluxo de trabalho do aplicativo conectado

#### Inserindo fluxos de trabalho

O diagrama abaixo ilustra como funciona a autenticação entre seu aplicativo externo (servidor Web e página da Web) e o aplicativo conectado do Tableau.

![Um diagrama que ilustra o fluxo de dados entre uma página da Web, um aplicativo externo e o Tableau.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_how.png)

1. **O usuário visita a página da Web:** quando um usuário visita o conteúdo inserido em uma página da Web, ela envia uma solicitação GET ao seu aplicativo externo para recuperar o HTML dela.
2. **O aplicativo externo constrói um token de autenticação:** o aplicativo externo constrói um JWT, que contém um segredo do aplicativo conectado (consulte a Etapa 3 abaixo para requisitos JWT adicionais) e o escopo de acesso do usuário para o conteúdo inserido. O segredo é assinado pelo aplicativo externo e é usado para verificação do relacionamento de confiança em uma etapa posterior.
3. **O aplicativo externo responde com token de autenticação:** o aplicativo externo responde à página com o JWT na URL do conteúdo inserido chamado pela página da Web.
4. **A página da Web solicita conteúdo do Tableau**: com a tentativa de carregar o conteúdo inserido, a página da Web chama a URL do conteúdo inserido, que envia uma solicitação GET ao Tableau.
5. **O Tableau valida o token:** o Tableau recebe o JWT e verifica a relação de confiança com o aplicativo personalizado ao identificar o aplicativo externo e o segredo compartilhado usado no JWT. Em seguida, o Tableau cria uma sessão para o usuário. A sessão não apenas respeita os escopos de inserção definidos no JWT, mas também as restrições especificadas no aplicativo conectado, incluindo os domínios e projetos permitidos.
6. **O Tableau retorna o conteúdo com base no contexto de inserção restrito:** o conteúdo inserido carrega apenas quando a página está em um domínio permitido e o conteúdo é publicado em um projeto permitido (se aplicável). O usuário autenticado só pode interagir com o conteúdo inserido pelo escopo definido no JWT.

## Criar um aplicativo conectado

### Etapa 1: criar um aplicativo conectado

Crie um aplicativo conectado na página Configurações do Tableau Server.

1. Como um administrador de servidor, entre no Tableau Server.
2. No painel esquerdo, selecione Configurações > Aplicativos conectados.
3. Selecione a seta suspensa do botão Novo aplicativo conectado e selecione Confiança dieta.
    
    **Observação:** se você estiver usando o Tableau Server 2023.3 ou anterior, selecione o no botão Novo aplicativo conectado.
4. Na caixa de diálogo Criar aplicativo conectado, faça _uma_ das seguintes ações:
    - Para _fluxos de trabalho de autorização da API REST (incluindo fluxos de trabalho da API de metadados que usam a API REST para autenticação)_, na caixa de texto Nome do aplicativo conectado, insira um nome para o aplicativo conectado e selecione o botão Criar.
        
        **Observação:** você pode ignorar o nível de acesso e a lista de permissões de domínio ao configurar um aplicativo conectado para autorização para API REST e API de metadados.
    - Para _inserir fluxos de trabalho_, faça o seguinte:
        1. Na caixa de texto Nome do aplicativo conectado, insira um nome para o aplicativo conectado.
        2. No menu suspenso Aplica-se a, selecione Todos os projetos ou Apenas um projeto para controlar quais exibições ou métricas podem ser inseridas. Se você selecionar a opção "Somente um projeto", selecione o projeto específico para o escopo. Para obter mais informações sobre essas duas opções, consulte [Nível de acesso (somente para inserir fluxos de trabalho)](#projects) .
            
            **Observações:** 
            
            - No Tableau Servidor 2023.3, o Tableau descontinuou a capacidade de inserir métricas.
            - Começando com Tableau Server 2024.2, você pode especificar vários projetos usando a API REST do Tableau. Para obter mais informações, consulte os métodos [Criar aplicativo conectado](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_connected_app.htm#create_connectedapp) e [Atualizar aplicativo conectado](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_connected_app.htm#update_connectedapp) na Ajuda da API REST.
        3. Na lista de permissões de Domínio, especifique os domínios usando as regras descritas em [Formatação de domínio](#domain_formatting) abaixo para controlar onde as exibições ou métricas podem ser inseridas.
            
            **Importante:** recomendamos usar a lista de permissões de domínio como prática recomendada de segurança para garantir que o conteúdo do Tableau seja inserido apenas nos locais permitidos.
        4. Quando terminar, selecione o botão Criar.
            
            ![Um formulário para criar um aplicativo conectado, incluindo campos para nome do aplicativo, nível de acesso e lista de permissões de domínio.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_create.png)
5. Ao lado do nome dos aplicativos conectados, selecione o menu de ações e Ativar. Por motivos de segurança, um aplicativo conectado é definido como desabilitado por padrão quando criado.
    
    ![Caixa de diálogo para habilitar, editar ou excluir aplicativos conectados.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_action_menu.png)
6. Anote a ID do aplicativo conectado, também conhecido como ID do cliente, para usar na Etapa 3 abaixo.
    
    ![Seu ID de cliente e um botão "Copiar".](/tableau/current/pt-br/server/pt-br/Img/connectedapp_clientid.png)

### Etapa 2: gerar um segredo

Você pode gerar um total de dois segredos para cada aplicativo conectado. O segundo segredo pode ser usado para fins de rotação de segredos, para ajudar a proteger contra problemas se um segredo for comprometido.

1. Na página de detalhes do aplicativo conectado que você criou na Etapa 1, selecione Gerar novo segredo.
2. Anote a ID secreta e o valor secreto para usar na Etapa 3 abaixo.
    
    ![Data gerada, ID e valor de uma ação.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_secret.png)

### Etapa 3: configurar o JWT

Depois de gerar um segredo, você deseja habilitar seu aplicativo externo para enviar um JWT válido. O JWT é um padrão usado para transferir informações com segurança entre duas partes. O JWT é assinado pelo seu aplicativo externo para enviar informações com segurança ao Tableau Server. O JWT faz referência ao aplicativo conectado, ao usuário para o qual a sessão está sendo gerada e ao nível de acesso que o usuário deve ter.

Um JWT válido inclui as seguintes informações:

- ID do aplicativo conectado, também conhecido como ID do cliente, da Etapa 1
- ID secreta e valor secreto gerado na Etapa 2
- Reivindicações registradas e cabeçalho:<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 126px;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 126px;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Reivindicação</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Nome</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Descrição ou valor obrigatório</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>kid</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ID secreta</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Obrigatório (no cabeçalho). O identificador de chave secreto do aplicativo conectado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>iss</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Emissor</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Obrigatório (no cabeçalho). URI de emissor exclusivo que identifica o aplicativo de conexão confiável e a chave de assinatura.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>alg</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Algoritmo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Obrigatório (no cabeçalho). Algoritmo de assinatura JWT. Apenas HS256 é compatível.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>sub</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Assunto</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nome de usuário  do usuário autenticado do <span class="mc-variable Variables.ProductName variable">Tableau Server</span>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>aud</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Público</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O valor deve ser: "<code>tableau</code>"</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>exp</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Data de validade</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um JWT válido não deve ter expirado. O tempo de expiração (em UTC) do JWT deve estar dentro do período de validade máximo configurado O período máximo de validade pode ser configurado usando o comando tsm <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#connectedapps_max_expiration_period" class="xref">vizportal.oauth.connected_apps.max_expiration_period_in_minutes</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>jti</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ID do JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Necessário como uma declaração. A declaração JWT ID fornece um identificador exclusivo para o JWT e diferencia maiúsculas de minúsculas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>scp</code> "<p><b style="font-style: normal;">Importante:</b> não use "<code>scope</code>".</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Escopo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para fluxos de <i>inserir pastas de trabalho</i>, os valores com suporte incluem:<p>"<code>tableau:views:embed</code> "<br>“<code>tableau:views:embed_authoring</code>” Adicionado no Tableau Server 2022.3<br>"<code>tableau:metrics:embed</code>" (Descontinuado no Tableau Server 2023.3)<br>“<code>tableau:ask_data:embed</code>” (Adicionado no Tableau Server 2023.1)</p><p><b>Observações:</b></p><ul><li>Os valores devem ser passados como um tipo de lista.</li><li>Para <code>tableau:views:embed</code> e <code>tableau:views:embed_authoring</code>, o escopo respeita as permissões dos usuários já configuradas no <span class="mc-variable Variables.ProductName variable">Tableau Server</span> e permite que eles interajam com as ferramentas na exibição inserida, se disponível na exibição original.</li><li>Recomendamos que o código de inserção exclua o parâmetro da barra de ferramentas. Para obter mais informações, consulte <a href="#known_issues" class="xref">Problemas conhecidos (somente para inserir fluxos de trabalho)</a> abaixo.</li></ul><p>Para <i>fluxos de trabalho de autorização da API REST</i>, consulte <a href="https://help.tableau.com/current/server/pt-br/connected_apps_scopes.htm#scopes" class="xref">Métodos da API REST que dão suporte à autorização JWT</a>.</p><p>Para <i>Fluxos de trabalho da API de metadados que usam a API REST para autenticação</i>, o único escopo aceito é <code>tableau:content:read</code>.</p><p>Para <i>fluxos de trabalho do VizQL Data Service que usam a API REST para autenticação</i>, o único escopo aceito é <code>tableau:viz_data_service:read</code>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>https://tableau.com/groups</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Associação ao grupo dinâmica</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para <i>fluxos de trabalho inseridos</i> somente.<p>O valor deve corresponder ao nome de um ou mais grupos no Tableau Server. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/groups_create_local.htm#assertions" class="xref">Associação dinâmica a grupos usando asserções</a>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">(Atributo do usuário)</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">(Valores de atributo do usuário)</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Para <i>fluxos de trabalho inseridos</i> somente.<p>A partir do Tableau Server 2025.1, você pode incluir atributos de usuário no JWT. Em seguira, quando as funções de atributo do usuário são usadas no conteúdo inserido, o Tableau verifica o contexto do usuário autenticado e determina quais dados podem ser exibidos em tempo de execução.</p><p><b>Observações:</b></p><ul><li><p>Verifique a Ajuda <a href="https://help.tableau.com/current/api/embedding_api/pt-br/docs/embedding_api_user_attributes.html#known-issues" target="_blank">Embedding API v3 do Tableau</a> para <i>problemas conhecidos</i> e <i>limitações</i> que podem afetar seu fluxo de trabalho.</p></li><li><p>Para que o atributo do usuário funcione, 1) você deve habilitar a capacidade do atributo do usuário por meio do método <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#update_embedding_settings_for_site" target="_blank">Atualizar configurações de incorporação para um site</a> usando a API REST do Tableau e, como opção, habilite a opção TSM <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#uaf" target="_blank">features.VizDataServiceClientEnable</a> e 2) o autor do conteúdo deve criar uma <a href="https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm#user_attributes" target="_blank">função de atributo do usuário</a>.</p></li><li>Os atributos de usuário diferenciam letras maiúsculas de minúsculas.</li></ul></td></tr></tbody></table>

#### JWTs de exemplo

Aqui estão exemplos de JWTs nas linguagens Java e Python. Os exemplos Java e Python usam a biblioteca nimbus-jose-jwt e a biblioteca PyJWT, respectivamente.

**Java**

import com.nimbusds.jose.\*;
import com.nimbusds.jose.crypto.\*;
import com.nimbusds.jwt.\*;

import java.util.\*;

...

String secret = "secretvalue";
	String kid = "connectedAppSecretId";
	String clientId = "connectedAppClientId";
	List<String> scopes = new
ArrayList<>(Arrays.asList("tableau:views:embed"));
	String username = "username";
	JWSSigner signer = new MACSigner(secret);
	JWSHeader header = new
JWSHeader.Builder(JWSAlgorithm.HS256).keyID(kid).customParam("iss", clientId).build();
	JWTClaimsSet claimsSet = new JWTClaimsSet.Builder()
		.issuer(clientId)
		.expirationTime(new Date(new Date().getTime() + 60 \* 1000)) //expires in 1 minute
		.jwtID(UUID.randomUUID().toString())
		.audience("tableau")
		.subject("username")
		.claim("scp", scopes)
		
		
		.claim("Region", "East")
		.build();
	SignedJWT signedJWT = new SignedJWT(header, claimsSet);
	signedJWT.sign(signer);
	model.addAttribute("token", signedJWT.serialize());

**Python**

import jwt

token = jwt.encode(
	{
		"iss": connectedAppClientId,
		"exp": datetime.datetime.utcnow() + datetime.timedelta(minutes=5),
		"jti": str(uuid.uuid4()),
		"aud": "tableau",
		"sub": user,
		"scp": \["tableau:views:embed", "tableau:metrics:embed"\]
		        
	},
		connectedAppSecretKey,
		algorithm = "HS256",
		headers = {
		'kid': connectedAppSecretId,
		'iss': connectedAppClientId
        }
  )

Depois de configurar o JWT, quando o código for executado pelo aplicativo externo, ele gerará um token.

### Etapa 4: próximas etapas

#### Para inserir fluxos de trabalho

Após a configuração do JWT, você deve adicionar o código de inserção ao seu aplicativo externo. Certifique-se de incluir o JWT válido que você configurou na Etapa 3 acima no componente da Web chamado pelo aplicativo externo.

Para obter mais informações sobre como inserir conteúdo e recursos do Tableau compatíveis em fluxos de trabalho de inserção, consulte o seguinte:

- Insira conteúdo do Tableau usando a [API de incorporação do Tableau v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html).
- Atributos do usuário para controle de acesso baseado em atributos (ABAC), acesso sob demanda e associação dinâmica de grupo, consulte [Personalizar e controlar o acesso a dados](https://help.tableau.com/current/api/embedding_api/pt-br/docs/embedding_api_user_attributes.html) na API de incorporação do Tableau v3.
- Incorpore métricas, consulte o [tópico Incorporar métricas a páginas](https://help.tableau.com/current/pro/desktop/pt-br/embed_metrics.htm) da Web na Ajuda do Tableau. (Em Tableau Server 2023.3, o Tableau descontinuou a capacidade de incorporar métricas.)

**Observação:** para que os usuários se autentiquem com êxito, ao acessar o conteúdo incorporado, os navegadores devem ser configurados para permitir cookies de terceiros.

#### Para fluxos de trabalho de autorização da API REST

Após a configuração do JWT, você deve adicionar o JWT válido à solicitação de login da API REST para acesso autorizado. Para obter informações, consulte [Escopos de acesso para aplicativos conectados](https://help.tableau.com/current/server/pt-br/connected_apps_scopes.htm).

#### Para obter os fluxos de trabalho da API de metadados

Após a configuração do JWT, você deve adicionar o JWT válido à solicitação de login da API REST. Para obter informações, consulte [Escopos de acesso para aplicativos conectados](https://help.tableau.com/current/server/pt-br/connected_apps_scopes.htm).

#### Para tokens externos para fluxos de trabalho de SCIM

Após a configuração do JWT, você deve ter o recurso SCIM habilitado. Para obter mais informações, consulte [Configurar aplicativos conectados com confiança direta](#scim).

## Gerenciar um aplicativo conectado

A página de aplicativos conectados é onde você pode gerenciar todos os aplicativos conectados para o seu site. Você pode realizar tarefas como criar, excluir e desabilitar aplicativos conectados, bem como revogar ou gerar novos segredos se os segredos existentes tiverem sido comprometidos.

1. Como um administrador de servidor, entre no Tableau Server.
2. No painel esquerdo, selecione Configurações > Aplicativos conectados.
3. Marque a caixa de seleção ao lado do aplicativo conectado que deseja gerenciar e execute um ou mais dos seguintes procedimentos:
    
    - **Gere um novo segredo** de acordo com a linha do tempo de rotação especificada pelas políticas de segurança da sua organização. Para gerar um segredo adicional, clique no nome do aplicativo conectado e, em seguida, clique no botão Gerar novo segredo. Um aplicativo conectado pode ter no máximo dois segredos. Ambos os segredos podem estar ativos ao mesmo tempo, não expiram e permanecem válidos até serem excluídos.
    - **Revise os detalhes do aplicativo conectado** selecionando o nome do aplicativo conectado para ver quando o aplicativo conectado foi criado, seu ID, escopos de projeto e domínio e seus segredos.
    - **Altere o escopo ou domínio do projeto**, no menu Ações, selecione Editar. Faça as alterações e selecione Atualizar.
        
        **Observação:** se você alterar os escopos do projeto ou domínio e o conteúdo inserido não existir no novo projeto ou no novo domínio, a exibição ou métrica inserida não poderá ser exibida, e os usuários verão um erro ao acessar o conteúdo inserido.
    - **Exclua um segredo** selecionando o nome do aplicativo conectado. Na página do aplicativo conectado, clique em Ações ao lado do segredo e selecione Excluir. Na caixa de diálogo de confirmação, selecione Excluir novamente.
        
        **Observação:** se o segredo do aplicativo conectado estiver sendo usado por um aplicativo externo, a exibição ou métrica inserida não poderá ser exibida depois que o segredo for excluído. Para obter mais informações, consulte [Efeitos da desativação ou exclusão de um aplicativo conectado ou exclusão de um segredo](#effects) abaixo.
    - **Desative um aplicativo conectado**, no menu Ações, selecione Desativar. Se o aplicativo conectado estiver sendo usado por um aplicativo externo, um exibição ou métrica inserida não poderá ser exibida depois que o aplicativo conectado for desativado. Para obter mais informações, consulte [Efeitos da desativação ou exclusão de um aplicativo conectado ou exclusão de um segredo](#effects) abaixo.
    
    ![Um formulário que exibe dois códigos de cliente gerados aleatoriamente.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_details.png)

### Efeitos da desativação ou exclusão de um aplicativo conectado ou exclusão de um segredo

Para exibir conteúdo inserido ao seu usuário ou ativar o acesso à API RES por meio de um aplicativo conectado, o aplicativo conectado deve ser ativado e seu segredo gerado. Se o aplicativo conectado estiver sendo usado em seu aplicativo externo e for desativado ou excluído, ou seu segredo excluído ou substituído, os usuários receberão um erro 403.

Para evitar esse problema, certifique-se de que o aplicativo de conexão esteja habilitado, e o JWT esteja usando o ID secreto e o valor corretos.

### Nível de acesso (somente para inserir fluxos de trabalho)

Você pode selecionar um dos dois tipos de projeto ao configurar o nível de acesso de um aplicativo conectado. O nível de acesso controla qual conteúdo pode ser inserido.

- **Todos os projetos:** esta opção permite que o conteúdo de todos os projetos seja inserido
- **Apenas um projeto:** esta opção permite que apenas o conteúdo do projeto especificado seja inserido. Se o projeto especificado contiver projetos aninhados, a inserção de conteúdo nesses projetos aninhados não será habilitada.

**Sobre vários projetos**

A partir do Tableau Server 2024.2 , você poderá habilitar o conteúdo em vários projetos para um aplicativo conectado usando somente a API REST do Tableau. Para especificar quais projetos, use as “IDs do projeto” nos métodos [Criar um aplicativo conectado](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_connected_app.htm#create_connectedapp) ou [Atualizar um aplicativo conectado](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_connected_app.htm#update_connectedapp).

**Observação:** quando vários projetos são configurados para seu aplicativo conectado, o Tableau exibe **Vários projetos** para o nível de acesso do aplicativo conectado. Se você selecionar Apenas um projeto ou Todos os projetos e atualizar o aplicativo conectado, a opção “Vários projetos” não estará mais visível. Se precisar configurar o aplicativo conectado para vários projetos novamente, você deverá usar a API REST.

### Regras de lista de permissões de domínio (somente para inserir fluxos de trabalho)

A lista de permissões de domínio do aplicativo conectado permite que você restrinja o acesso ao conteúdo inserido do Tableau a todos os domínios ou alguns domínios; ou exclua alguns domínios ou bloqueie todos os domínios.

**Importante:** recomendamos usar a lista de permissões de domínio como prática recomendada de segurança para garantir que o conteúdo do Tableau seja inserido apenas nos locais permitidos.

#### Opções de domínio

Você pode selecionar uma das duas opções ao configurar a lista de permissões de domínio de um aplicativo conectado:

- **Todos os domínios:** como opção padrão, ela permite acesso irrestrito ao conteúdo inserido.
- **Apenas domínios específicos:** esta opção oferece a capacidade de reduzir o escopo do acesso ao conteúdo inserido. Se você usar esta opção, siga as regras de formatação especificadas na seção a seguir, [Formatação de domínio](#domain_formatting).

#### Formatação de domínio

Na caixa de texto da lista de domínios permitidos, você pode inserir um ou mais domínios usando os exemplos de formatação abaixo.

**Observação:** as regras de formatação de domínio também se aplicam ao usar os [métodos de Aplicativo conectado](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_connected_app.htm) na API REST do Tableau.

Aqui estão alguns exemplos de formatação com base em cenários comuns:

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Para especificar...</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Exemplo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Acesso de inserção</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Intervalo de domínios</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">*.myco.com</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O conteúdo inserido pode ser acessado em todos os subdomínios em myco.com.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Todas as portas</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">myco.com:*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O conteúdo inserido pode ser acessado de todas as portas em myco.com.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Porta específica</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">myco.com:8080</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O conteúdo inserido pode ser acessado pela porta 8080 somente em myco.com.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Múltiplos domínios discretos</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">myco.com<br>events.myco.com<br>ops.myco.com<br></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>O conteúdo inserido pode ser acessado em todos os três domínios.</p><p><b>Observação:</b> ao especificar vários domínios, digite cada domínio em uma nova linha ou separe os domínios com um espaço. Para a API REST, os domínios precisam ser separados por um espaço.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Somente tráfego seguro</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O conteúdo inserido pode ser acessado com segurança, independentemente do domínio.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tráfego seguro para todas as portas para vários domínios</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://*myco.com:*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O conteúdo inserido pode ser acessado com segurança de todas as portas em todos os subdomínios em myco.com.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Sem domínios</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">[sem domínios]</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">O acesso ao conteúdo inserido está bloqueado.</td></tr></tbody></table>

### Problemas conhecidos (somente para inserir fluxos de trabalho)

Existem alguns problemas conhecidos no uso de aplicativos conectados que serão abordados em uma versão futura.

- **Recursos da barra de ferramentas:** quando o conteúdo incorporado tem o parâmetro da barra de ferramentas definido, nem todos os recursos da barra de ferramentas funcionarão. Para contornar esse problema, recomendamos que você oculte o parâmetro da barra de ferramentas como no exemplo abaixo.
    
    <tableau-viz id='tab-viz' src='https://<your\_server>/t/<your\_site>/...'
    	toolbar='hidden'>
    </tableau-viz>

- **Fontes de dados publicadas:** as fontes de dados publicadas definidas como Solicitar usuário, para obter credenciais do banco de dados, não serão exibidas. Para contornar esse problema, se possível, recomendamos que os proprietários da fonte de dados incorporem suas credenciais de banco de dados.
- **Exibições inseridas em vários sites:** no Tableau Server 2023.1 e versões anteriores, alternar entre exibições em sites diferentes no mesmo navegador causa erro 1008: não foi possível buscar o segredo para o aplicativo de conexão. Para contornar esse problema, atualize para o Tableau Server 2023.3 ou posterior.

- **Objetos Pergunte aos dados em painéis inseridos:** os objetos Pergunte aos dados em painéis inseridos não serão carregados. (Em O Tableau Server 2024.2 descontinuará o Pergunte aos dados.)
- **Métricas e listas de permissão de domínio:** as visualizações de métricas inseridas serão exibidas apesar das restrições de acesso que podem ser especificadas nas listas de permissão de domínio dos aplicativos conectados. **Observação:** os dados de métricas acessados em barras de ferramentas de exibições inseridas funcionarão conforme o esperado. (Em Tableau Server 2023.3, o Tableau retirou a capacidade de incorporar métricas.)

## Solução de problemas

Você pode consultar [Solução de problemas de aplicativos conectados- Confiança direta](https://help.tableau.com/current/server/pt-br/connected_apps_troubleshoot.htm) para erros que podem estar associados ao aplicativo conectado e etapas de solução de problemas sugeridas.

<!-- document id=1d2368bd0486caf81e7b7d7f168fa2329eaaef91425bb03e78b3219649fac05b url=/tableau/current/pt-br/server/connected_apps_eas.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar aplicativos conectados com confiança OAuth 2.0

Como administrador do Tableau Server, você pode registrar um ou mais servidores de autorização externo (EASs) para estabelecer uma relação de confiança entre o TTableau Server e o EAS usando o protocolo padrão OAuth 2.0.

**Importante:**

- alguns dos procedimentos neste tópico requerem configuração com software e serviços de terceiros. Fizemos o possível para verificar os procedimentos para habilitar o recurso EAS no Tableau Server. No entanto, software e serviços de terceiros podem mudar ou sua organização pode ser diferente. Se você tiver problemas, consulte a documentação de terceiros para obter detalhes e suporte de configuração confiável.
- Para habilitar a inserção por meio do EAS, o Tableau Server deve ser configurado para usar SSL para tráfego HTTP.
- Para que o token de sessão seja válido, os relógios do aplicativo externo e do servidor que hospeda o aplicativo externo devem ser definidos como Tempo Universal Coordenado (UTC). Se um dos relógios usar um padrão diferente, o aplicativo conectado não será confiável.

## Como os aplicativos conectados do Tableau funcionam com a confiança do OAuth 2.0

A relação de confiança entre seu site do Tableau Server e o aplicativo externo são estabelecidos e verificados por meio de um token de autenticação no padrão JSON Web Token (JWT).

Quando o conteúdo inserido do Tableau é carregado em seu aplicativo externo, o fluxo de código de autorização e o fluxo OAuth são usados. Após os usuários fazerem logon com sucesso no IdP, eles entram automaticamente no Tableau Server. Siga as etapas descritas abaixo para registrar seu EAS com o Tableau Server

### Principais componentes de um aplicativo conectado

Os seguintes componentes do conectado trabalham em conjunto com o JWT em seu aplicativo externo para autenticar usuários e exibir conteúdo inserido.

- **Servidor de autorização externa (EAS):** o servidor, normalmente seu IdP, que funciona como a interface entre o usuário e o aplicativo externo. O servidor autentica e autoriza o acesso do usuário ao conteúdo protegido do Tableau.
- **URL do emissor:** a URL que identifica exclusivamente a instância do EAS.

### Fluxo de trabalho do aplicativo conectado

#### Inserindo fluxos de trabalho

O diagrama abaixo ilustra como funciona a autenticação entre o servidor de autorização externo (EAS), o aplicativo externo (servidor Web e página da Web) e o aplicativo conectado ao Tableau.

![](/tableau/current/pt-br/server/pt-br/Img/connectedapp_how_EAS.png)

1. **O usuário visita a página da Web:** quando um usuário visita o conteúdo inserido em uma página da Web, ela envia uma solicitação GET ao aplicativo externo.
2. **O aplicativo externo redireciona a solicitação para o EAS:** o aplicativo externo responde com uma página da Web que redireciona para o servidor de autorização externo (EAS).
3. **O usuário se autentica com o EAS:** o usuário autentica e autoriza com o EAS.
4. **O EAS responde à página da Web com código de autorização:** o EAS responde à página com um código de autorização e redireciona de volta para a página da Web.
5. **O EAS converte o código de autorização em JWT:** A página da Web chama o EAS para converter o código de autorização em um JWT, que a página da Web coloca na URL do conteúdo inserido.
6. **A página da Web solicita conteúdo do Tableau:** a página da Web carrega o iFrame e envia uma solicitação GET ao Tableau.
7. **O Tableau valida o token:** o Tableau valida o JWT na URL com a assinatura e responde com o conteúdo e respeita os escopos de inserção definidos no JWT.

## Criar um aplicativo conectado

### Etapa 1: antes de começar

Para registrar um EAS com o Tableau Server , você deve ter um EAS já configurado. Além disso, o EAS deve enviar um token da Web JSON (JWT) válido que contenha as declarações registradas e o cabeçalho listado na tabela abaixo.

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Reivindicação</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Nome</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Descrição ou valor obrigatório</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>kid</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ID da chave</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Obrigatório (no cabeçalho). Um identificador de chave exclusivo do provedor de identidade.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>iss</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Emissor</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Obrigatório (no cabeçalho ou como uma declaração). URI de emissor exclusivo que identifica o aplicativo de conexão confiável e a chave de assinatura.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>alg</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Algoritmo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Obrigatório (no cabeçalho). Algoritmo de assinatura JWT. Os nomes de algoritmos compatíveis estão listados na página <a href="https://www.javadoc.io/doc/com.nimbusds/nimbus-jose-jwt/2.21/com/nimbusds/jose/JWSAlgorithm.html" target="_blank">JWSAlgorithm de classe</a> na documentação javadoc.io. O algoritmo de assinatura pode ser configurado usando o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_algorithms" class="xref">vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>sub</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Assunto</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nome de usuário  do usuário autenticado do <span class="mc-variable Variables.ProductName variable">Tableau Server</span>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>aud</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Público</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>O valor deve ser: "<code>tableau</code>"</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>exp</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Data de validade</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um JWT válido não deve ter expirado. O tempo de expiração (em UTC) do JWT deve estar dentro do período de validade máximo configurado O período máximo de validade pode ser configurado usando o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_max_expiration_period" class="xref">vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>jti</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ID do JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A declaração JWT&nbsp;ID&nbsp;fornece um identificador exclusivo para o JWT e diferencia maiúsculas de minúsculas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>scp</code> "</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Escopo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Para fluxos de <i>inserir pastas de trabalho</i>, os valores com suporte incluem:</p><p>"<code>tableau:views:embed</code> "<br>"<code>tableau:views:embed_authoring</code> " (Adicionado no Tableau Server 2022.3)<br>"<code>tableau:metrics:embed</code>" (Descontinuado no Tableau Server 2023.3)<br>“<code>tableau:ask_data:embed</code>” (Adicionado no Tableau Server 2023.1. Descontinuado no Tableau Server 2024.2)</p><p><b>Observações:</b></p><ul><li>Os valores devem ser passados como um tipo de lista.</li><li>Para <code>tableau:views:embed</code>, o escopo respeita as permissões dos usuários já configuradas no <span class="mc-variable Variables.ProductName variable">Tableau Server</span> e permite que eles interajam com as ferramentas na exibição inserida, se disponível na exibição original.</li><li>Recomendamos que o código de inserção exclua o parâmetro da barra de ferramentas. Para obter mais informações, consulte <a href="#known_issues" class="xref">Problemas conhecidos (somente para inserir fluxos de trabalho)</a> abaixo.</li></ul><p>Para <i>fluxos de trabalho de autorização da API REST</i>, consulte <a href="https://help.tableau.com/current/server/pt-br/connected_apps_scopes.htm#scopes" class="xref">Métodos da API REST que dão suporte à autorização JWT</a>.</p><p>Para <i>Fluxos de trabalho da API de metadados que usam a API REST para autenticação</i>, o único escopo aceito é <code>tableau:content:read</code>.</p><p>Para <i>fluxos de trabalho do VizQL Data Service que usam a API REST para autenticação</i>, o único escopo aceito é <code>tableau:viz_data_service:read</code>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>https://tableau.com/groups</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Associação ao grupo dinâmica</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para <i>fluxos de trabalho inseridos</i> somente.<p>O valor deve corresponder ao nome de um ou mais grupos no Tableau Server. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/groups_create_local.htm#assertions" class="xref">Associação dinâmica a grupos usando asserções</a>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">(Atributos do usuário)</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">(Valores de atributo do usuário)</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Para <i>fluxos de trabalho inseridos</i> somente.</p><p>A partir do Tableau Server 2025.1, você pode incluir atributos de usuário no JWT. Em seguira, quando as funções de atributo do usuário são usadas no conteúdo inserido, o Tableau verifica o contexto do usuário autenticado e determina quais dados podem ser exibidos em tempo de execução.</p><p><b>Observações:</b></p><ul><li><p>Verifique a Ajuda <a href="https://help.tableau.com/current/api/embedding_api/pt-br/docs/embedding_api_user_attributes.html#known-issues" target="_blank">Embedding API v3 do Tableau</a> para <i>problemas conhecidos</i> e <i>limitações</i> que podem afetar seu fluxo de trabalho.</p></li><li>Para que o atributo do usuário funcione, 1) você deve habilitar a capacidade do atributo do usuário por meio do método <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#update_embedding_settings_for_site" target="_blank">Atualizar configurações de incorporação para um site</a> usando a API REST do Tableau e, como opção, habilite a opção TSM <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#uaf" target="_blank">features.VizDataServiceClientEnable</a> e 2) o autor do conteúdo deve criar uma <a href="https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm#user_attributes" target="_blank">função de atributo do usuário</a>.</li><li>Os atributos de usuário diferenciam letras maiúsculas de minúsculas.</li></ul></td></tr></tbody></table>

**Observação:** as reivindicações JWT acima estão documentadas na seção [Nomes de reivindicações registradas](https://datatracker.ietf.org/doc/html/rfc7519#section-4.1) na documentação distribuída pela organização Internet Engineering Task Force (IETF).

### Etapa 2: registrar o EAS com o Tableau Server

Ao registrar o EAS com o Tableau Server, você estabelece uma relação de confiança entre o EAS e o Tableau Server. Isso significa que, quando os usuários acessam o conteúdo do Tableau inserido no aplicativo externo, eles são redirecionados para se autenticar com o IdP. O EAS gera o token de autenticação, que é passado ao Tableau Server para verificação. Depois que a relação de confiança é verificada, o acesso ao conteúdo inserido é concedido os usuários.

**Observação:** alguns EAS são compatíves com a opção de exibir uma caixa de diálogo de consentimento que solicita a aprovação dos usuários para o aplicativo acessar o conteúdo do Tableau. Para garantir a melhor experiência para os usuários, recomendamos que você configure o EAS para consentir automaticamente a solicitação do aplicativo externo em nome dos usuários.

#### Sobre EAS em nível de site

A partir do Tableau Server 2024.2, você pode configurar o EAS no nível do site. Para registrar um EAS no nível do site, os aplicativos conectados devem estar habilitados no Tableau Server Manager (TSM).

Há duas maneiras de registrar o EAS em todo o servidor: usando a interface de usuário da Web do TSM ou usando a CLI do TSM.

Depois de registrar o EAS, a relação de confiança estabelecida se aplica a todos os sites no Tableau Server.

### Opção 1: usar a interface de usuário da Web do TSM

1. Como administrador do Tableau Server, faça logon na interface do usuário na Web do Tableau Services Manager (TSM). Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm#sign-in-to-the-tsm-web-ui).
2. Execute _um_ destes procedimentos:
    
    - No Tableau Server 2024.2 e posterior, navegue até a página Identidade e acesso do usuário > guia Aplicativos conectados.
    - No Tableau Server 2023.3 e versões anteriores, navegue até a página Identidade e acesso do usuário > guia Servidor de autorização.
3. Execute _um_ destes procedimentos:
    - No Tableau Server 2024.2 e posterior:
        
        1. Marque a caixa de seleção Habilitar aplicativos conectados.
        2. Selecione o segundo botão de opção, Permitir aplicativos conectados (configurar no nível do site) e confiança OAuth 2.0 em todo o servidor (configurar abaixo).
        3. Na caixa de texto URL do emissor, cole a URL do emissor do EAS.
        4. Clique no botão Salvar alterações pendentes.
            
            ![](/tableau/current/pt-br/server/pt-br/Img/connectedapp_eas_register_new.png)
    - No Tableau Server 2023.3 e versões anteriores:
        
        1. Marque a caixa de seleção Habilitar acesso OAuth para conteúdo inserido.
        2. Na caixa de texto URL do emissor, cole a URL do emissor do EAS.
        3. Clique no botão Salvar alterações pendentes.
            
            ![Registre um Formulário de servidor de autorização externo.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_eas_register.png)
4. Quando terminar, faça o seguinte:
    1. No canto superior direito da página, clique no botão Alterações pendentes.
    2. No canto inferior direito da página, clique no botão Aplicar alterações e reiniciar para interromper e reiniciar o Tableau Server.
        
        ![Uma lista de alterações de configuração externa pendentes para autorização com a opção para Aplicar ou Descartar alterações.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_eas_save.png)

### Opção 2: usando a CLI do TSM

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute os seguintes comandos:
    
    tsm configuration set -k vizportal.oauth.external\_authorization.enabled -v true
    tsm configuration set -k vizportal.oauth.external\_authorization\_server.issuer -v "<issuer\_url\_of\_EAS>"
    tsm restart

A partir do Tableau Server 2024.2, você pode registrar um ou mais EASs para um site. Depois de registar o EAS ao nível do local, a relação de confiança estabelecida aplica-se apenas ao local.

**Observação:** um pré-requisito para configurar o EAS em nível de site é que os aplicativos conectados estejam habilitados no TSM.

### Etapa 1: habilitar aplicativos conectados

1. Como administrador do Tableau Server, faça logon na interface do usuário na Web do Tableau Services Manager (TSM). Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm#sign-in-to-the-tsm-web-ui).
2. Navegue até a página Identidade e acesso do usuário > guia Aplicativos conectados.
3. Marque a caixa de seleção Habilitar aplicativos conectados.
4. Execute _um_ destes procedimentos:
    
    - Selecione o primeiro botão de opção, Permitir aplicativos conectados (configurar no nível do site) para permitir o registro de EAS apenas no nível do site.
        
        ![](/tableau/current/pt-br/server/pt-br/Img/connectedapp_eas_register_radio.png)
    - (Padrão) Selecione o segundo botão de opção, Permitir aplicativos conectados (configurar no nível do site) e confiança OAuth 2.0 em todo o servidor (configurar abaixo) para permitir o registro de EASs no nível do site e em todo o servidor. Se você escolher esta opção, certifique-se de que a URL do emissor especificado no nível do site seja diferente da URL do emissor em todo o servidor.
        
        ![](/tableau/current/pt-br/server/pt-br/Img/connectedapp_eas_register_radio_default.png)
5. Clique no botão Salvar alterações pendentes.
6. Quando terminar, faça o seguinte:
    1. No canto superior direito da página, clique no botão Alterações pendentes.
    2. No canto inferior direito da página, clique no botão Aplicar alterações e reiniciar para interromper e reiniciar o Tableau Server.

### Etapa 2: registrar o EAS

1. Como um administrador do Tableau Server, entre em Tableau Server.
2. No painel esquerdo, selecione Configurações > Aplicativos conectados.
3. Clique na seta suspensa do botão Novo aplicativo conectado e selecione OAuth 2.0 Trust.
4. Na caixa de diálogo Criar aplicativo conectado, faça o seguinte:  
    1. Na caixa de texto Nome, insira um nome para o aplicativo conectado.
    2. Na caixa de texto URL do emissor, cole a URL do emissor do EAS.
    3. Selecione o Habilitar aplicativo conectado. Por motivos de segurança, um aplicativo conectado é definido como desabilitado por padrão quando criado.
    4. Quando terminar, clique no botão Criar.
    ![](/tableau/current/pt-br/server/pt-br/Img/connectedapp_create_eas.png)
5. Depois que o aplicativo conectado for criado, copie a ID do site do aplicativo conectado. A ID do site é usada para a declaração "aud" (público) do JWT descrita na Etapa 1 acima.
    
    ![Detalhes do servidor de autorização externo, com um botão para copiar o ID do site.](/tableau/current/pt-br/server/pt-br/Img/connectedapp_eas_button_luid.png)

### Etapa 3: próximas etapas

#### Para inserir fluxos de trabalho

Depois de configurar o Tableau Server EAS, você deve adicionar o código inserido ao aplicativo externo. Certifique-se de incluir o JWT válido gerado por seu EAS, conforme descrito na Etapa 1, no componente da Web chamado pelo aplicativo externo.

Para obter mais informações sobre a inserção de conteúdo do Tableau, consulte o seguinte:

- Insira conteúdo do Tableau usando a [API de incorporação do Tableau v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html).
- Atributos do usuário para controle de acesso baseado em atributos (ABAC), acesso sob demanda e associação dinâmica de grupo, consulte [Personalizar e controlar o acesso a dados](https://help.tableau.com/current/api/embedding_api/pt-br/docs/embedding_api_user_attributes.html) na API de incorporação do Tableau v3.
- Incorpore métricas, consulte o [tópico Incorporar métricas a páginas](https://help.tableau.com/current/pro/desktop/pt-br/embed_metrics.htm) da Web na Ajuda do Tableau. (Em Tableau Server 2023.3, o Tableau descontinuou a capacidade de incorporar métricas.)

**Observação:** para que os usuários se autentiquem com êxito, ao acessar o conteúdo incorporado, os navegadores devem ser configurados para permitir cookies de terceiros.

##### Controlar onde o conteúdo pode ser inserido usando a lista de permissões de domínio para inserção

A partir de Tableau Server 2023.3, você e seus usuários podem controlar se o conteúdo do Tableau pode ser inserido sem restrições ou restrito a determinados domínios usando o método Atualizar as configurações de inserção para site na API REST do Tableau.

Por padrão, a configuração do site `unrestrictedEmbedding` para inserção está definida como `true` para permitir a inserção irrestrita. Como alternativa, você e seus usuários podem definir a configuração como `false` e especificar os domínios nos quais o conteúdo do Tableau em aplicativos externos pode ser inserido usando o parâmetro `allowList`.

Para obter mais informações, consulte uma das seguintes alternativas ou as duas:

- [Atualizar as configurações de inserção para site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#update_embedding_settings_for_site) na Ajuda da API REST do Tableau
- [Configuração do site do Tableau para inserção](https://help.tableau.com/current/api/embedding_api/en-us/docs/embedding_api_site.html#about-tableau-site-settings-for-embedding) na Ajuda da API v3 de inserção do Tableau.

#### Para fluxos de trabalho de autorização da API REST

Após a configuração do JWT, você deve adicionar o JWT válido à solicitação de login da API REST para acesso autorizado. Para obter informações, consulte [Escopos de acesso para aplicativos conectados](https://help.tableau.com/current/server/pt-br/connected_apps_scopes.htm).

#### Para obter os fluxos de trabalho da API de metadados

Após a configuração do JWT, você deve adicionar o JWT válido à solicitação de login da API REST. Para obter informações, consulte [Escopos de acesso para aplicativos conectados](https://help.tableau.com/current/server/pt-br/connected_apps_scopes.htm).

#### Para tokens externos para fluxos de trabalho de SCIM

Após a configuração do JWT, você deve ter o recurso SCIM habilitado. Para obter mais informações, consulte [Configurar aplicativos conectados com confiança OAuth 2.0](#scim).

### Problemas conhecidos (somente para inserir fluxos de trabalho)

Existem alguns problemas conhecidos no uso de aplicativos conectados que serão abordados em uma versão futura.

- **Recursos da barra de ferramentas:** quando o conteúdo incorporado tem o parâmetro da barra de ferramentas definido, nem todos os recursos da barra de ferramentas funcionarão. Para contornar esse problema, recomendamos que você oculte o parâmetro da barra de ferramentas como no exemplo abaixo.
    
    <tableau-viz id='tab-viz' src='https://<your\_server>/t/<your\_site>/...'
    	toolbar='hidden'>
    </tableau-viz>

- **Fontes de dados publicadas:** as fontes de dados publicadas definidas como Solicitar usuário, para obter credenciais do banco de dados, não serão exibidas. Para contornar esse problema, se possível, recomendamos que os proprietários da fonte de dados incorporem suas credenciais de banco de dados.
- **Exibições inseridas em vários sites:** no Tableau Server 2023.1 e versões anteriores, alternar entre exibições em sites diferentes no mesmo navegador causa erro 1008: não foi possível buscar o segredo para o aplicativo de conexão. Para contornar esse problema, atualize para o Tableau Server 2023.3 ou posterior.

### Solução de problemas

Quando o conteúdo inserido não consegue ser exibido em seu aplicativo externo ou a autorização da API REST do Tableau falha, você pode usar as ferramentas de desenvolvedor de um navegador, para inspecionar e identificar códigos de erro que podem estar associados com o recurso EAS habilitado no Tableau Server .

Consulte a tabela abaixo para revisar a descrição do código de erro e a resolução potencial.

<table style="width: 90%;margin-left: 0;margin-right: auto;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Código de erro</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Resumo</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Descrição</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Resolução ou explicação potencial</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">5</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SYSTEM_USER_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não foi possível encontrar o usuário do Tableau</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><br>Para resolver esse problema, verifique se o valor da declaração '<code>sub</code>' (Assunto) no JWT é "nome de usuário" para o Tableau Server autenticado. Este valor diferencia maiúsculas de minúsculas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">16</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">LOGIN_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Falha no logon</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esse erro normalmente é causado por um dos seguintes problemas de reivindicação no JWT:<ul><li>O '<code>exp</code>' (Tempo de expiração) excede o período de validade máximo padrão. Para resolver esse problema, analise <a href="https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm#jwt" target="_blank">as reivindicações registradas</a> necessárias para um JWT válido e certifique-se de que o valor correto seja usado. Para alterar o período máximo de validade, você pode usar o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_max_expiration_period" class="xref">vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes</a></li><li>O '<code>sub</code>' (Assunto) está chamando um usuário desconhecido. Para resolver esse problema, verifique se a declaração '<code>sub</code>' é "username". Este valor diferencia maiúsculas de minúsculas.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">67</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">FEATURE_NOT_ENABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O acesso sob demanda não é compatível</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O acesso sob demanda está disponível somente por meio de sites licenciados do Tableau Cloud.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10081</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_RETRIEVE_IDP_METADATA</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Endpoint de metadados EAS ausente</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se o EAS está configurado corretamente e se o emissor correto está sendo chamado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10082</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AUTHORIZATION_SERVER_ISSUER_NOT_SPECIFIED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Emissor ausente</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se o emissor correto está sendo chamado. Para alterar a URL do emissor, você pode usar o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_issuer" class="xref">vizportal.oauth.external_authorization_server.issuer</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10083</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BAD_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O cabeçalho JWT contém problemas</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">As declarações de '<code>kid</code>’ (ID secreta) ou '<code>clientId</code>' (Emissor) estão faltando no cabeçalho JWT. Para resolver esse problema, certifique-se de que essas informações estejam incluídas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10084</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_PARSE_ERROR</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT contém problemas</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver o problema, verifique o seguinte:<ul><li>O valor '<code>aud</code>' (Público) referenciado no JWT usa o valor "tableau". Este valor diferencia maiúsculas de minúsculas.</li><li>O '<code>aud</code>' (Público) e '<code>sub</code>' (Assunto) estão incluídos no JWT.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10085</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_FETCH_JWT_KEYS</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O JWT não conseguiu encontrar as chaves</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Não foi possível encontrar o segredo.<p>Para resolver esse problema, verifique se o emissor correto está sendo chamado. Para alterar a URL do emissor, você pode usar o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_issuer" class="xref">vizportal.oauth.external_authorization_server.issuer</a></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10087</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGN</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problema com o algoritmo de assinatura JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver o problema, você pode remover o algoritmo de assinatura. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_algorithms" class="xref">vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10088</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">RSA_KEY_SIZE_INVALID</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problema com requisitos de assinatura JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique com o EAS ou IdP se o JWT está sendo assinado com um tamanho de chave RSA de 2048.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10091</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_ALREADY_USED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT exclusivo necessário</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O JWT já foi usado no processo de autenticação. Para resolver esse problema, o EAS ou IdP deve gerar um novo JWT.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10092</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">NOT_IN_DOMAIN_ALLOW_LIST</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O domínio do conteúdo inserido não foi especificado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se a configuração <code>unrestrictedEmbedding</code> está definida como <code>true</code> ou se o parâmetro <code>domainAllowlist</code> inclui os domínios nos quais o conteúdo do Tableau está inserido usando o método <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#embedding_settings_for_site" target="_blank">Atualizar as configurações de inserção para site</a> na API REST do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10094</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MISSING_REQUIRED_JTI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ID do JWT ausente</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se o '<code>jti</code>' (ID do JWT) está incluído no JWT.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10096</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O '<code>exp</code>' (Tempo de expiração) excede o período de validade máximo padrão. Para resolver esse problema, analise <a href="https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm#jwt" target="_blank">as reivindicações registradas</a> necessárias para um JWT válido e certifique-se de que o valor correto seja usado. Para alterar o período máximo de validade, você pode usar o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_max_expiration_period" class="xref">vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes</a> </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10097</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MALFORMED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problemas com a reivindicação de escopos</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esse erro pode ocorrer quando o '<code>scp</code>' (Escopo) está faltando no JWT ou não foi passado como um tipo de lista. Para resolver esse problema, verifique '<code>scp</code>' é incluído no JWT e passado como um tipo de lista. Para obter ajuda na solução de problemas com um JWT, consulte <a href="https://jwt.io/" target="_blank">Depurador</a> no site auth0.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10098</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_UNSIGNED_OR_ENCRYPTED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT não está assinado ou criptografado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O Tableau não oferece suporte a JWT não assinado ou criptografado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10099</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MISSING_IN_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Declaração de escopos ausente</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O JWT não tem a declaração '<code>scp</code>' (Escopo) necessária. Para resolver esse problema, verifique se o '<code>scp</code>' está incluído no JWT. Para obter ajuda na solução de problemas com um JWT, consulte <a href="https://jwt.io/" target="_blank">Depurador</a> no site auth0.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10100</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_PERSISTENCE_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Erro inesperado de ID JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Houve um erro inesperado com o '<code>jti</code>' (ID JWT). Para resolver esse problema, um novo JWT com um novo '<code>jti</code>’ deve ser gerado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">10103</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">JWT_MAX_SIZE_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">JWT excede o tamanho máximo</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Esse erro pode ocorrer quando o tamanho do JWT excede 8.000 bytes. Para resolver esse problema, certifique-se de que apenas as declarações necessárias estejam sendo passadas para <span class="mc-variable Variables.ProductName variable">Tableau Server</span>.</td></tr></tbody></table>

<!-- document id=29a2ace365e66f6a1103af82b50ea19c2c160e5473285c75f17d447a7e9a41cd url=/tableau/current/pt-br/server/config_general.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar as definições do nó inicial

Este tópico descreve como definir as configurações fundamentais do servidor como parte do processo inicial de instalação do Tableau Server.

## Pré-requisitos

Antes de continuar com os procedimentos neste tópico, conclua os seguintes pré-requisitos, como descrito em [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm):

- [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm)
- [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm)

Após ter ativado e registrado o Tableau Server, o programa de instalação exibirá a página Configuração.

**Observação**: se você precisar configurar o Tableau Server para se conectar a um diretório LDAP que não seja um Active Directory, será necessário usar a CLI do TSM.

![Um formulário de configuração com configurações de instalação personalizáveis.](/tableau/current/pt-br/server/pt-br/Img/config_setup_default_win.png)

### Configurações do armazenamento de identidades

É obrigatório definir as configurações do armazenamento de identidades do computador com o Tableau Server. O armazenamento de identidades gerencia as contas do Tableau Server. Você pode configurar o armazenamento de identidades para sincronizar com um diretório externo (OpenLDAP ou Active Directory, por exemplo) ou configurá-lo para gerenciar e armazenar contas no Tableau Server. Se estiver usando um logon único na solução (OpenID, SAML, Kerberos etc), consulte os tópicos a seguir antes de configurar o armazenamento de identidades:

- [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm)
- [Autenticação](https://help.tableau.com/current/server/pt-br/security_auth.htm)

**Importante**: após configurar e aplicar as definições do armazenamento de identidades, ele não poderá ser alterado.

![Janela Armazenamento de identidades com o Active Directory selecionado e uma mensagem indicando que você não pode alterar o armazenamento de identidades após a inicialização.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-setup-id-store-ad.png)

Se você selecionar Active Directory, o Tableau Server preencherá os campos Domínio e NetBIOS do computador que executa a Configuração. Em alguns casos, a Configuração pode não exibir esses atributos. Para obter mais informações sobre como o Tableau Server se conecta e comunica com o Active Directory, consulte [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm).

**Permitir comunicações não criptografadas com Active Directory**

A infraestrutura do Active Directory deve gerenciar certificados e confiança em computadores associados ao domínio. Dessa forma, o canal de comunicação entre os recursos do Tableau Server e do Active Directory deve ser criptografado. Por padrão, o Tableau Server requer acesso de leitura ao canal criptografado ao Active Directory. Não recomendamos permitir comunicações não criptografadas com o Active Directory, pois essa configuração é vulnerável a ataques man-in-the-middle. No entanto, em alguns cenários de implantação, as organizações não criptografam o canal durante a configuração inicial. Se você precisar permitir temporariamente a comunicação não criptografada com o Active Directory, pode reativar a aplicação da comunicação criptografada posteriormente executando o comando tsm, [wgserver.domain.allow\_insecure\_connection](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver6), ou fazendo login na interface de usuário do TSM e alternando a configuração em Identidade e acesso do usuário > Armazenamento de identidades.

### Conta de serviço Run As

Por padrão, o Tableau Server é executado sob a conta Serviço de rede. Para usar uma conta que se adapte à autenticação NT com fontes de dados, especifique um nome de usuário e uma senha. Consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm) para saber mais sobre como criar e usar uma conta de usuário específica.

**Important**e: inclua o nome de domínio com o nome de usuário, por exemplo, `example\tableaurunas`.

Insira a senha que você criou para essa conta.

![Caixa de diálogo de configuração da conta de serviço Run As.](/tableau/current/pt-br/server/pt-br/Img/config_setup_runas.png)

### Porta de gateway

A porta padrão para acesso na Web ao Tableau Server (via HTTP) é a porta 80. Se o programa de instalação determinar que a porta 80 está em uso quando você instalar pela primeira vez o Tableau Server, uma porta alternativa (por exemplo, 8000) é usada e mostrada na caixa Número de porta.

Talvez você precise alterar a porta devido a outras necessidades de rede, por exemplo, se tiver um firewall de hardware ou proxy que proteja o host do Tableau Server, o que poderá tornar indesejável a execução de um sistema back-end na porta 80.

![O número da porta do gateway padrão é 80.](/tableau/current/pt-br/server/pt-br/Img/config_setup_gw.png)

### Dados de uso do produto

Por padrão, o Tableau Server compartilha dados de uso com o Tableau, nos ajudando a entender melhor como você usa nossos produtos, melhora sua experiência geral e cria recursos altamente inteligentes que tornam o Tableau ainda mais avançado.

Desmarque essa opção se não quiser que os dados de uso sejam enviados ao Tableau.

![Opção para desabilitar a capacidade de enviar dados de uso para o Tableau.](/tableau/current/pt-br/server/pt-br/Img/config_setup_prod_usage.png)

Você também pode alterar essa configuração após a instalação, na guia Manutenção do TSM na UI da Web do TSM ou usando a CLI do TSM. Para obter mais informações, consulte [Dados de uso do servidor](https://help.tableau.com/current/server/pt-br/usage_data_server.htm).

### Instalação da pasta de trabalho de amostra

Por padrão, o Tableau Server instalará pastas de trabalho de amostra no site Padrão quando você inicializar o servidor.

![Caixa de configuração com a opção para incluir pastas de trabalho de amostra.](/tableau/current/pt-br/server/pt-br/Img/config_setup_samples.png)

Como alternativa, é possível publicar as amostras depois da instalação com o comando tabcmd [publishsamples](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#publishsamples).

### Inicializar a instalação

Após configurar as opções nesta página, clique em Inicializar.

O processo de inicialização pode levar alguns instantes. Quando a inicialização for concluída, a página a seguir será exibida:

![Caixa de diálogo de inicialização concluída com sucesso.](/tableau/current/pt-br/server/pt-br/Img/config_setup_initialize_complete.png)

Primeiro, configure a instalação do armazenamento de identidades, das configurações de gateway e da pasta de trabalho de modelo. Em seguida, aplique as alterações, verifique a conexão LDAP (opcionalmente) e inicialize o Tableau Server

### Definir as configurações do armazenamento de identidades

É obrigatório definir as configurações do armazenamento de identidades do computador com o Tableau Server.

**Importante**: após configurar e aplicar as definições do armazenamento de identidades, ele não poderá ser alterado.

Use o modelo json em [Entidade identityStore](https://help.tableau.com/current/server/pt-br/entity_identity_store.htm) para criar um arquivo json. Depois de preencher as opções com os valores adequados, transfira o arquivo json com este comando:

`tsm settings import -f path-to-file.json`.

### Definir as configurações do gateway (opcional)

Dependendo dos seus requisitos de rede, pode ser necessário definir as configurações do gateway para o computador do Tableau Server. Por exemplo, se você ativar o SSL ou configurar o acesso ao Tableau Server com um proxy reverso, talvez precise definir as configurações do gateway. Consulte [Entidade gatewaySettings](https://help.tableau.com/current/server/pt-br/entity_gateway.htm) para mais informações.

Use o modelo json em [Entidade gatewaySettings](https://help.tableau.com/current/server/pt-br/entity_gateway.htm) para criar um arquivo json. Depois de preencher as opções com os valores adequados, transfira o arquivo json com este comando:

`tsm settings import -f path-to-json-file.json`.

### Configurar dados de uso do produto (opcional)

Por padrão, o Tableau Server compartilha dados de uso com o Tableau para nos ajudar a entender melhor como você usa nossos produtos. Isso nos permite melhorar sua experiência geral e criar recursos altamente inteligentes que tornam o Tableau ainda mais poderoso.

O Tableau coleta apenas dados comportamentais e de uso, nunca qualquer um dos seus valores de banco de dados confidenciais e seus dados de uso nunca serão compartilhados ou vendidos; a única finalidade é melhorar sua experiência no Tableau.

Se você não desejar compartilhar dados de uso do produto, utilize o modelo de json em [Entidade shareProductUsageDataSettings](https://help.tableau.com/current/server/pt-br/entity_usage.htm) para criar um arquivo json e especifique um valor de `false`. Em seguida, transmita o arquivo json com este comando:

`tsm settings import -f path-to-json-file.json`.

Você também pode alterar essa configuração após a instalação, na guia Manutenção do TSM ou usando a CLI do TSM. Para obter mais informações, consulte [Dados de uso do servidor](https://help.tableau.com/current/server/pt-br/usage_data_server.htm).

### Configurar a instalação da pasta de trabalho de amostra (opcional)

Por padrão, o Tableau Server instalará pastas de trabalho de amostra no site Padrão quando você inicializar o servidor.

Caso não deseje instalar as pastas de trabalho de amostra durante a instalação, execute o comando a seguir:

`tsm configuration set -k install.component.samples -v false`

Publique as amostras depois da instalação com o comando tabcmd [publishsamples](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#publishsamples), se desejar.

### Aplicar alterações pendentes à configuração

Agora que você criou e definiu a configuração inicial, deve aplicá-la. Quando você aplicar as alterações de configuração, o tsm verificará as definições estabelecidas antes de confirmá-las.

Para aplicar as alterações de configuração ao Tableau Server, execute este comando:

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

Quando este comando for concluído, os processos do TSM serão executados e o Tableau Server estará configurado, mas ainda não estará em execução.

### Verificar a configuração LDAP (opcional)

Se o armazenamento de identidades usa o LDAP, é recomendado verificar a conectividade de LDAP antes de prosseguir.

Para isso, execute os seguintes comandos antes de inicializar o servidor:

`tsm user-identity-store verify-user-mappings -v <user name>`

`tsm user-identity-store verify-group-mappings -v <group name>`

Os nomes de usuários e de grupos devem ser nomes válidos que existem no servidor LDAP ao qual você está se conectando. Se a conexão LDAP tiver sido configurada corretamente, os atributos de usuário ou grupo serão retornados para o shell. Se a conexão não estiver definida corretamente, retornará um erro.

### Inicializar o Tableau Server

- Para inicializar o Tableau Server, use a opção `--start-server`:
    
    `tsm initialize --start-server --request-timeout 1800`
    
    Isso economiza tempo, ao deixar o servidor funcionando após a instalação.
- Caso queira reconfigurar o Tableau Server após a inicialização, deixe a opção `--start-server` desativada:
    
    `tsm initialize --request-timeout 1800`
    
    Isso interrompe o servidor após a inicialização.

Inicie o Tableau Server. Se a opção `--start-server` não foi utilizada durante a inicialização e a configuração do Tableau Server já foi concluída, use este comando para iniciar o servidor:

`tsm start --request-timeout 900`

## Próxima etapa

Após concluir a inicialização, crie a conta de usuário do administrador do Tableau Server. Consulte [Adicionar uma conta de administrador](https://help.tableau.com/current/server/pt-br/startup.htm).

## Outros artigos nesta seção

<!-- document id=bde43ec285a2a301f50b4918ba166e81e6149d9018937bf291535c8c34395aa7 url=/tableau/current/pt-br/server/ssl_config_mutual.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar autenticação do SSL mútuo

Usando o SSL mútuo, é possível fornecer uma experiência de acesso direto ao Tableau Server a usuários do Tableau Mobile e a outros clientes aprovados do Tableau Desktop. Com o SSL mútuo, quando um cliente com um certificado SSL válido conecta-se ao Tableau Server, o Tableau Server confirma a existência do certificado do cliente e autentica o usuário, com base no nome de usuário no certificado. Se o cliente não tiver um certificado SSL válido, o Tableau Server poderá recusar a conexão.

Você também pode configurar o Tableau Server para retornar à autenticação de nome de usuário/senha se houver falha no SSL mútuo. Além disso, um usuário poderá fazer logon usando a API REST com um nome de usuário e senha (se existir), se a autenticação de fallback estiver configurada ou não.

## Limites de tempo da sessão de autenticação do usuário

Quando os usuários fazem logon com SSL mútuo, a sessão de autenticação é regida pelo mesmo método da configuração da sessão de autenticação global do Tableau Server.

Para clientes que se conectam ao Tableau Server usando um navegador da Web, a configuração da sessão de autenticação global é descrita na _Lista de verificação do reforço de segurança_, consulte Consulte [10\. Verificar a configuração de tempo da sessão](https://help.tableau.com/current/server/pt-br/security_harden.htm#10.).

As sessões para clientes conectados (Tableau Desktop, Tableau Mobile, Tableau Prep Builder e Bridge) usam tokens OAuth para manter os usuários conectados por meio do restabelecimento de uma sessão. Por padrão, todos os tokens de cliente OAuth são redefinidos após um ano. Um token de cliente expira quando não é usado em 14 dias. Você pode alterar esses valores ao definir as opções `refresh_token.absolute_expiry_in_seconds` e `refresh_token.idle_expiry_in_seconds`. Consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

## Uso de certificados

Antes de habilitar e configurar o SSL mútuo, você deve configurar o SSL externo. O SSL externo autentica o Tableau Server ao cliente e criptografa a sessão usando o certificado e a chave, necessários quando você configura o SSL externo.

Para SSL mútuo, é necessário um arquivo de certificado adicional. O arquivo é uma concatenação de arquivos de certificação CA. O tipo de arquivo deve ser `.crt`. Uma "CA" é uma _autoridade de certificação_ que emite certificados aos computadores clientes que se conectarão ao Tableau Server. A ação de upload do arquivo de certificado CA estabelece uma confiança, que permite ao Tableau Server autenticar os certificados individuais que são apresentados pelos computadores clientes.

Como parte do seu plano de recuperação de desastres, recomendamos manter um backup dos arquivos de certificado e revogação (se aplicável) em um local seguro fora do Tableau Server. Os arquivos de certificado e revogação que você adiciona ao Tableau Server serão armazenados e distribuídos a outros nós pelo Serviço de arquivos do cliente. No entanto, os arquivos não são armazenados em um formato recuperável. Consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

**Chave RSA e tamanhos de curva ECDSA**

O certificado CA usado para SSL mútuo deve ter uma força de chave RSA de 2048 ou um tamanho de curva ECDSA de 256.

Você pode configurar o Tableau Server para aceitar os tamanhos menos seguros definindo as respectivas chaves de configuração:

- ssl.client\_certificate\_login.min\_allowed.rsa\_key\_size
- ssl.client\_certificate\_login.min\_allowed.elliptic\_curve\_size

Consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

### Requisitos do certificado do cliente

Os usuários que se autenticam no Tableau Server com SSL mútuo devem apresentar um certificado de cliente que atenda aos requisitos mínimos de segurança.

**Algoritmo de assinatura**

Os certificados do cliente devem usar o algoritmo de assinatura SHA-256 ou maior.

O Tableau Server configurado para autenticação SSL mútua bloqueará a autenticação de usuários com certificados de clientes que usam o algoritmo de assinatura SHA-1.

Os usuários que tentarem fazer logon com certificados de cliente SHA-1 encontram um erro "Não foi possível entrar" e o seguinte erro será visível nos registros do VizPortal:

`Unsupported client certificate signature detected: [certificate Signature Algorithm name]`

Você pode configurar o Tableau Server para aceitar o algoritmo de assinatura SHA-1 menos seguro definindo a opção de configuração tsm [ssl.client\_certificate\_login.blocklisted\_signature\_algorithms](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#ssl.clie).

**Chave RSA e tamanhos de curva ECDSA**

O certificado do Cliente usado para SSL mútuo deve ter uma força de chave RSA de 2048 ou um tamanho de curva ECDSA de 256.

O Tableau Server falhará nas solicitações de autenticação mútua dos certificados do cliente que não atendam a esses requisitos. Você pode configurar o Tableau Server para aceitar os tamanhos menos seguros definindo as respectivas chaves de configuração:

- ssl.client\_certificate\_login.min\_allowed.rsa\_key\_size
- ssl.client\_certificate\_login.min\_allowed.elliptic\_curve\_size

Consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

1. [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm).
2. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
3. Na guia Configuração, selecione Identidade e acesso do usuário > Método de autenticação.
4. Em Método de autenticação, selecione SSL mútuo no menu suspenso.
5. Em SSL Mútuo, selecione Usar SSL mútuo e entrar automaticamente com os certificados do cliente.
6. Clique em Selecionar arquivo e faça upload do arquivo de certificado de autoridade de certificação (CA) no servidor.
    
    O arquivo (.crt) é um arquivo completo que inclui certificados de CAs que são usados para autenticação do cliente. O arquivo que você carrega deve ser uma concatenação dos vários arquivos de certificado codificados pelo PEM, por ordem de preferência.
7. Insira as informações de configuração SSL restantes da sua empresa.
    
    **Formato do nome de usuário**: quando o Tableau Server estiver configurado para SSL mútuo, o servidor vai obter o nome de usuário do certificado do cliente, para que possa estabelecer um logon direto para o usuário cliente. O nome usado pelo Tableau Server dependerá de como o Tableau Server é configurado para a autenticação do usuário:
    
    - Autenticação local—O Tableau Server usa UPN (User Principal Name) do certificado.
    - Active Directory (AD) — O Tableau Server usa LDAP (Lightweight Directory Access Protocol) para obter o nome do usuário.
    
    Como alternativa, você pode definir o Tableau Server para usar o CN (Common Name) do certificado do cliente.
    
    ![Captura de tela de configuração de autenticação de SSL mútuo](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-mutualssl.png)
8. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
9. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
10. Clique em Aplicar alterações e reiniciar.

### Etapas 1: exigir o SSL para comunicação de servidor externa

Para configurar o Tableau Server para usar o SSL para comunicação externa entre o Tableau Server e os clientes da Web, execute o comando `external-ssl enable` da forma a seguir, ao fornecer os nomes para os arquivos de certificado .crt e.key do servidor:

`tsm security external-ssl enable --cert-file <file.crt> --key-file <file.key>`

- Para `--cert-file` e `--key-file`, especifique o nome de arquivo e a localização onde os arquivos de chave (.key) e de certificado SSL (.crt) emitidos pela CA do servidor foram salvos.
- O comando acima pressupõe que o logon foi feito com um usuário que tem a função de site Administrador de servidor no Tableau Server. Em vez disso, use os parâmetros `-u` e `-p` para especificar um usuário administrador e uma senha.
- Se o arquivo de chave de certificado exigir uma frase secreta, inclua o parâmetro `--passphrase` e o valor.

### Etapa 2: configurar e habilitar SSL mútuo

Adicione a autenticação mútua entre o servidor e cada cliente, além de permitir que usuários clientes do Tableau sejam autenticados diretamente depois de fornecerem suas credenciais pela primeira vez.

1. Execute o seguinte comando:
    
    `tsm authentication mutual-ssl configure --ca-cert <certificate-file.crt>`
    
    Para `--ca-cert`, especifique a localização e o nome do arquivo do arquivo de certificado da lista de revogação.
    
    O arquivo (.crt) é um arquivo completo que inclui certificados de CAs que são usados para autenticação do cliente. O arquivo que você carrega deve ser uma concatenação dos vários arquivos de certificado codificados pelo PEM, por ordem de preferência.
2. Execute os comandos a seguir para habilitar SSL mútuo e aplicar as alterações:
    
    `tsm authentication mutual-ssl enable`
    
    `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).

### Opções adicionais para SSL mútuo

É possível usar `mutual-ssl configure` para configurar o Tableau Server para suportar as opções a seguir.

Para obter mais informações, consulte [tsm authentication mutual-ssl <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMMutualSSL).

#### Autenticação de fallback

Quando o Tableau Server for configurado para SSL mútuo, a autenticação é automática e os clientes devem ter um certificado válido. É possível configurar o Tableau Server para permitir uma opção de fallback, aceitar a autenticação do nome de usuário e da senha.

`tsm authentication mutual-ssl configure -fb true`

O Tableau Server aceita autenticação com nome de usuário e senha de clientes REST API, mesmo que a opção acima esteja definida como `false`.

#### Mapeamento de nome de usuário

Quando o Tableau Server está configurado para SSL mútuo, o servidor autenticará o usuário diretamente ao obter o nome de usuário do certificado de cliente. O nome que o Tableau Server usa depende de como o servidor é configurado para a autenticação do usuário:

- **Autenticação local**: usa o UPN (User Principal Name; Nome de usuário principal) do certificado.
- **Active Directory (AD)**: usa o LDAP (Lightweight Directory Access Protocol; Protocolo leve de acesso ao diretório) para obter o nome de usuário.

É possível substituir um destes padrões para definir que o Tableau Server use o nome comum.

`tsm authentication mutual-ssl configure -m cn`

Para obter mais informações, consulte [Mapeamento de um certificado de cliente para um usuário durante a autenticação mútua](https://help.tableau.com/current/server/pt-br/ssl_mutual_mapping_username.htm)

#### Lista de revogação de certificados (CRL)

Pode ser preciso especificar uma CRL se suspeitar que uma chave privada foi comprometida ou se uma autoridade de certificação (CA) não emitiu um certificado corretamente.

`tsm authentication mutual-ssl configure -rf <revoke-file.pem>`

<!-- document id=109523866be7bfeaf5ca56a616a098ca7fc5bace8db92507da51a77c475896fc url=/tableau/current/pt-br/server/config_cache.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar cache de dados

As exibições publicadas no Tableau Server são interativas e, às vezes, têm uma conexão ativa com um banco de dados. Como os usuários interagem com as exibições em um navegador da Web, os dados que são consultados são armazenados em um cache. As visitas subsequentes extrairão os dados desse cachê, se ele estiver disponível. Por padrão, o Tableau Server colocará em cache e reusará os dados pelo maior de tempo possível. Se desejar, altere esse comportamento configurando as opções de cache usando o comando `[tsm data-access caching set](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#caching-set)`.

1. Execute este comando:
    
    `tsm data-access caching set -r <value>`
    
    Em que <value> é uma destas opções:
    
    - **cadeia de caracteres pequena ou vazia (“ )**. Esse é o valor padrão e indica que o Tableau Server deve configurar o cache e sempre usar dados armazenados em cache, quando disponíveis.
    - <value>. "<value>" especifica o número máximo de minutos que os dados devem ser colocados em cache.
    - **sempre** ou **0** (zero). Esses valores indicam que o Tableau Server deve sempre obter os dados mais recentes e que o cache deve ser atualizado sempre que uma página for recarregada.
2. Aplique as alterações com o comando `tsm pending-changes apply`. Isto reiniciará o Tableau Server.

<!-- document id=90141deb5ca1e2795708202d8b4c60c27daa75f1ba64987e6d6a24cf4ee65133 url=/tableau/current/pt-br/server/config_encrypt_ldap.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar canal criptografado no armazenamento de identidade externo LDAP

O Tableau Server configurado para se conectar a um armazenamento de identidade LDAP externo deve consultar o diretório LDAP e estabelecer uma sessão. O processo de criação de uma sessão é chamado _associação_. Há diversas formas de associação. O Tableau Server é compatível com dois métodos de associação a um diretório LDAP:

- Associação simples: estabelece uma sessão ao autenticar com um nome de usuário e uma senha. Por padrão, o LDAP com associação simples não é criptografado. Se estiver configurando LDAP com associação simples, recomendamos habilitá-lo com SSL/TLS.
- **Associação ao GSSAPI:** o GSSAPI usa o Kerberos para autenticação. Quando configurada com um arquivo keytab, a autenticação é segura durante a associação ao GSSAPI. No entanto, o tráfego subsequente para o servidor LDAP não é criptografado. Recomendamos configurar o LDAP com SSL/TLS.
    
    Se você estiver executando o Tableau Server no Windows em um computador que faz parte de um domínio do Active Directory, não precisa configurar o GSAPI. A configuração da Interface gráfica do usuário do Tableau Server detectará e configurará a conexão do Active Directory para você usando Kerberos. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm). Não execute o LDAP com simples associação para comunicações do Active Directory.

Este tópico descreve como criptografar o canal para associação simples do LDAP para comunicações entre servidores de diretório Tableau Server e LDAP.

## Requisitos de certificado

- Você deve ter um certificado codificado em PEM x509 SSL/TLS válido que pode ser usado para criptografia. O arquivo de certificado deve ter uma extensão .crt.
- Certificados autoassinados não são aceitos.
- O certificado que você instala deve incluir `Key Encipherment` no campo de uso chave a ser usado para SSL/TLS. O Tableau Server usará apenas este certificado para criptografar o canal para o servidor LDAP. O vencimento, a confiança e o CRL e outros atributos não são validados.
- Se você estiver executando o Tableau Server em uma implantação distribuída, copie manualmente o certificado SSL para cada nó do cluster. Copie o certificado somente para os nós em que o processo do servidor de aplicativos do Tableau Server esteja configurado. Diferentemente de outros arquivos compartilhados em um ambiente de cluster, o certificado SSL usado para LDAP não será distribuído automaticamente pelo Serviço de arquivo do cliente.

- Se você estiver usando um certificado PKI ou não de terceiros, carregue o certificado raiz da CA no armazenamento confiável Java.

### Importação de certificado para o repositório de chaves do Tableau

Caso ainda não tenha certificados no computador configurado para o servidor LDAP, é necessário obter um certificado SSL para o servidor LDAP e importá-lo para o repositório de chaves do sistema Tableau.

Use a ferramenta "keytool" do Java para importar os certificados. Em uma instalação padrão, esta ferramenta está instalada com o Tableau Server em `C:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\bin\keytool.exe`.

Execute o comando a seguir como administrador para importar o certificado (você deve substituir o `<variables>` para o seu ambiente):

`"C:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\bin\keytool.exe" -importcert -file "C:\Program Files\Tableau\Tableau Server\<LDAP-certificate-file>.crt" -alias "<ldapserver.name>" -keystore "C:\ProgramData\Tableau\Tableau Server\tableauservicesmanagerca.jks" -storepass changeit -noprompt`

A senha para o repositório de chaves Java é `changeit`. (Não altere a senha do repositório de chaves Java).

## Método de criptografia LDAPS

O Tableau Server é compatível com LDAPS para criptografar o canal LDAP para uma associação simples.

O LDAP seguro, ou LDAPS, é um canal criptografado padrão que requer mais configuração. Especificamente, além de um certificado TLS no Tableau Server, você deve definir o nome do host e a porta LDAP segura para o servidor LDAP de destino.

## Configuração de canal criptografado para simples associação

Se sua organização usar um diretório LDAP diferente do Active Directory, siga os procedimentos aqui para configurar um canal criptografado para associação simples LDAP.

Esta seção descreve como configurar o Tableau Server para usar um canal criptografado para associação simples LDAP.

### Quando configurar

Você deve configurar o Tableau Server para usar um canal criptografado para vínculo simples LDAP, antes que o Tableau Server seja inicializado ou como parte da configuração do nó inicial, conforme mencionado na guia “Usar a CLI do TSM” em [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

### Para novas instalações do Tableau Server

Se sua organização usar um diretório LDAP diferente do Active Directory, então você não poderá usar a configuração de interface gráfica de usuário do TSM para configurar o armazenamento de identidade como parte da instalação do Tableau Server. Em vez disso, você deve usar arquivos de entidade JSON para configurar o armazenamento de identidade LDAP. Consulte [Entidade identityStore](https://help.tableau.com/current/server/pt-br/entity_identity_store.htm).

Antes de configurar a entidade de identityStore, importe um certificado SSL/TLS válido para o repositório de chaves do Tableau, conforme documentado anteriormente neste tópico.

Configurar o LDAPS requer definir as opções hostname e sslPort no arquivo JSON identityStore.

<!-- document id=6a417a984bc574fa884b4c34c15a1bff53f847535e737557bae10fe55262857c url=/tableau/current/pt-br/server/ssl_config_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar certificado SSL personalizado para TSM Controller

O Tableau Server Administration Controller (também conhecido como Controller) é o componente de gerenciamento para alterações de administração no cluster do Tableau Server. Por padrão, o Controller é executado no nó inicial (primeiro) de um cluster do Tableau Server. Embora seja tecnicamente possível executar vários Controllers em uma única implantação de cluster do Tableau, essa não é uma prática recomendada.

O Controller inclui uma API que pode ser gerenciada por vários clientes: TSM CLI, TSM Web Client, clientes REST (curl, postman), etc. Usando esses clientes, os administradores do Tableau Server podem fazer alterações de configuração no cluster de servidor. O Controller, juntamente com o Zookeeper, gerencia e executa as alterações de configuração nos nós.

**Importante:** a partir da versão 2025.2 (Tableau Desktop), 2025.3 (Tableau Server) e de junho de 2025 (Tableau Cloud), o Tableau usa OpenSSL 3.4.x e segurança de nível 2. A segurança de nível 2 requer chaves de 2048 bits ou mais. Todas as chaves de segurança de nível 1 existentes não funcionarão mais e você precisará gerar e implantar um novo par de chaves. Se você estiver gerando chaves com pelo menos 2048 bits, conforme recomendado, nenhuma ação será necessária. Para obter mais informações, consulte [Gerar uma chave](https://help.tableau.com/current/server/pt-br/ssl_cert_create.htm#generate-key).

## Funcionalidade TSM SSL padrão

**Observação** como é convenção, o termo “SSL” é usado aqui quando se refere ao uso de TLS para proteger o tráfego HTTPS.

Por padrão, a conexão do cliente é criptografada com SSL por meio de um certificado autoassinado criado pelo Tableau Server durante a instalação e renovado pelo Controller. Além da criptografia, a identidade (nome do host ou IP) da máquina host do Controller é validada em relação ao nome do assunto apresentado no certificado durante o handshake SSL. No entanto, como o certificado é autoassinado, a confiabilidade do certificado não é absoluta.

No caso da conexão CLI com o Controller, a incapacidade de confiar totalmente no certificado não é um grande risco de segurança, pois um ataque intermediário geralmente exigiria que um usuário mal-intencionado acessasse o cluster do Tableau Server em uma rede privada. Se um usuário mal-intencionado puder falsificar o certificado para o controlador no cenário CLI, o usuário mal-intencionado já possui “as chaves do reino”.

No entanto, no cenário em que os administradores estão se conectando ao Controller por IU da Web do TSM de fora da rede interna, a falta de validação do host por meio de autoridade de certificação confiável apresenta mais riscos de segurança.

Até recentemente, os clientes que executavam a IU da Web do TSM em uma máquina Windows podiam colocar o certificado CA do Tableau Server em um armazenamento raiz confiável do Windows. A maioria dos navegadores validaria a confiança do certificado em virtude dessa configuração. Hoje, o Chrome não valida mais (confia) em certificados autoassinados que são colocados no armazenamento confiável do sistema operacional. Agora, o Chrome (e a maioria dos principais navegadores) confiará apenas em certificados vinculados a uma CA raiz confiável de terceiros.

## Certificado personalizado SSL do Tableau Server v2023.1

O recurso de certificado SSL TSM personalizado fecha a lacuna de confiança, permitindo que os administradores configurem o TSM Controller com um certificado de identidade que se liga a uma CA raiz confiável de terceiros.

Há uma série de detalhes importantes para entender:

- A confiança para o certificado SSL personalizado do TSM é validada ao conectar com a IU da Web do TSM.
- A validação de confiança não é tentada para o cenário TSM CLI. Conforme descrito anteriormente, um ataque “man-in-the-middle” no cenário CLI não apresenta um risco crível.
- A cadeia de certificados pode ser incluída na configuração. A cadeia pode apresentar todos os certificados assinados por CAs intermediários. A cadeia pode terminar a qualquer momento e presume-se que quaisquer certificados ausentes da cadeia estejam instalados no armazenamento confiável do sistema operacional.

## Configuração

Você deve usar a CLI do TSM para configurar (ou atualizar) o certificado personalizado ou atualizar SSL para o TSM.

Consulte [tsm security custom-tsm-ssl enable](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#custom-tsm-ssl-enable).

<!-- document id=8e1c15ca32e2be8ec85a25a85a4732f3e33b7fdac9ce49b80cb5e3e871cdca26 url=/tableau/current/pt-br/server/lwc_seamless_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar componentes da Web Lightning do Tableau e logon único (SSO) com autenticação de token

Os componentes Web do Lightning (LWC) do Tableau permitem que os clientes do Salesforce arrastem e soltem visualizações do Tableau e métricas do Tableau Pulse nas páginas do Salesforce Lightning.

- O componente de exibição do Tableau permite adicionar exibições inseridas do Tableau Cloud ou do Tableau Server.
- O componente Tableau Pulse permite adicionar métricas inseridas do Tableau Pulse do Tableau Cloud.

A autenticação contínua do LWC do Tableau permite visualizar o conteúdo do Tableau usando tokens confiáveis do aplicativo conectado sem fazer login. A autenticação contínua é opcional para o Tableau de exibição do Tableau e necessária para o Tableau do Tableau Pulse.

> [!IMPORTANT]
> 
> **Importante**:  
> • os aplicativos do [Console do Salesforce](https://help.salesforce.com/s/articleView?id=sf.console2_about.htm&type=5) não oferecem suporte ao uso de componentes da Web Lightning do Tableau.  
> • As páginas de registro de caso não oferecem suporte ao uso de componentes da Web Lightning do Tableau com e-mails do Chatter.

## Adicionar URL confiável

A exibição do Tableau ou a URL do Pulse que você deseja adicionar à sua página do Lightning deve ser adicionado como uma URL confiável.

1. No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
2. No painel de navegação esquerdo, digite “URLs confiáveis” na barra de pesquisa Busca rápida.
3. Selecione a página de configurações URLs confiáveis.
4. Selecione Nova URL confiável.
5. Digite um Nome da API e URL, seguindo as instruções na página de configurações. **Observação**: a URL deve começar com https://
6. Para Contexto CSP, selecione Todos.
7. Para Diretivas CSP, marque todas as caixas.
8. Selecione Salvar.

## Ativar autenticação contínua para LWCs do Tableau

Os LWCs do Tableau View e do Tableau Pulse estão disponíveis no Lightning App Builder sem qualquer configuração. No entanto, o Tableau Pulse LWC requer autenticação de token para funcionar.

### Configurar definições do Salesforce

As seguintes etapas precisam ser concluídas apenas uma vez por um administrador de Salesforce:

1. No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
2. No painel de navegação esquerdo, digite “Tableau” na barra de pesquisa Busca rápida.
3. Selecione a página de configurações Inserção do Tableau.
4. Selecione a caixa de seleção para Ativar autenticação de logon único baseada em token.
    
    **Observação**: ambas as caixas devem ser marcadas para configurar o LWC do Tableau Pulse. Para o LWC de exibição do Tableau, você pode optar por não configurar a autenticação de token e, em vez disso, fazer login manualmente quando o componente for carregado.  
      
    Para usar o LWC de exibição do Tableau em dispositivos móveis, você deve ativar a autenticação baseada em token e configurar a autenticação contínua.
5. Em Selecionar o campo Identidade do usuário do Tableau, defina um campo de usuário no nível da organização para autenticar o usuário no Tableau. Você deve selecionar o campo de usuário do Salesforce que corresponde ao nome de usuário do Tableau. A lista suspensa mostra o valor do campo para o usuário atual ou nulo se nenhum valor for definido. Se nenhum dos campos de usuário corresponder ao nome de usuário do Tableau, selecione um campo vazio (por exemplo, ID da federação ou um campo personalizado). Em seguida, preencha o campo vazio com o nome de usuário do Tableau para seus usuários.
    
    **Observação**: a configuração do campo Identidade de usuário do Tableau se aplica a todos os usuários e não precisa ser definida individualmente.
6. Salve as alterações.
7. Se você for o administrador do Tableau, mantenha as configurações do Salesforce de Inserção do Tableau abertas enquanto você define as configurações do Tableau na próxima seção. Se você não é o administrador, compartilhe a URL do problema e o URI do JWKS com seu administrador do Tableau.

> [!TIP]
> 
> **Dica**: a configuração do campo Identidade de usuário do Tableau se aplica a todos os usuários e não precisa ser definida individualmente.

### Configurar as definições do Tableau

Em uma guia, abra a página de configurações do Tableau Embedding em sua organização Salesforce. Em outra guia, acesse o site do Tableau e siga estas instruções para configurar o aplicativo conectado.

Em Tableau Server, siga estas etapas:

1. Como administrador do Tableau Server, faça logon na interface da Web do Tableau Services Manager (TSM).
2. Navegue até Identidade e acesso do usuário e selecione a guia Servidor de autorização.
3. Marque a caixa de seleção para Habilitar o acesso OAuth para conteúdo inserido.
4. Insira a URL do emissor e o JWKS URI, que você pode encontrar na página de configurações do Tableau Embedding da organização Salesforce. Use o botão Copiar na página de configurações da organização para copiar o valor da URL do emissor e cole-o na página de interface da Web do TSM. Repita esse processo para o valor JWKS URI.

**Observação**: o campo URI do JWKS é marcado como opcional na interface da Web do TSM, mas esse valor é obrigatório para usar a autenticação contínua do Tableau LWC. O Tableau Server precisa ser capaz de acessar o URI JWKS para que a autenticação perfeita seja bem-sucedida.

6. Selecione Salvar alterações pendentes.
7. Selecione Alterações pendentes no canto superior direito da página e, em seguida, Aplicar aterações e reiniciar para interromper e reiniciar o Tableau Server.

Para obter mais informações, consulte [Registrar seu EAS com o Tableau Server](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm#step-2-register-your-eas-with--tableau-server).

Em Tableau Cloud, siga estas etapas:

1. Abra a página Configurações do Tableau e escolha a guia Aplicativos conectados.
2. No menu suspenso Novo aplicativo conectado, selecione Confiança OAuth 2.0.
3. Na caixa de diálogo Criar aplicativo conectado, insira a URL do emissor e o JWKS URI, que você pode encontrar na página de configurações do Tableau Embedding de Exibição da organização Salesforce. Use o botão Copiar na página de configurações da organização Salesforce para copiar o valor da URL do emissor e cole-o na página de configurações do Tableau. Repita esse processo para o valor JWKS URI.

> [!IMPORTANT]
> 
> **Importante:** a caixa de diálogo Criar aplicativo conectado indica o campo URI JWKS como opcional; no entanto, esse valor é necessário para usar a autenticação contínua do Tableau LWC.

5. Marque a caixa de seleção para Habilitar aplicativo conectado.
6. Selecione Criar.

**Observação:** o aplicativo conectado é denominado servidor de autorização externa.

Para obter mais informações, consulte [Registrar seu EAS com o Tableau Cloud](https://help.tableau.com/current/online/pt-br/connected_apps_eas.htm?_gl=1*1rfpjn7*_ga*NDAxMzE5Mi4xNjg5ODczMzE5*_ga_8YLN0SNXVS*TmVlZHMgR1RNIENvbmZpZ3VyYXRpb24uMi4xLjE2ODk4ODkwMDAuMC4wLjA.#step-2-register-your-eas-with--tableau-cloud).

Se você deseja criar um mapeamento de host para este site, deixe a guia Aplicativos Conectados aberta. Você pode usar a URL desta página e o botão Copiar ID do site para preencher os campos de mapeamento de host na seção a seguir.

## Permitir captura de atributos do usuário (somente Tableau Cloud)

Para alavancar [funções de atributo do usuário](https://help.tableau.com/current/online/pt-br/lwc_uaf.htm) com os LWCs do Tableau, você deve habilitar o acesso em fluxos de trabalho de autenticação.

1. Abra a página Configurações do Tableau e escolha a guia Autenticação.
2. Navegue até a seção Controle o acesso do usuário em fluxos de trabalho de autenticação.
3. Selecione a caixa de seleção para Habilitar captura de atributos do usuário em fluxos de trabalho de autenticação.

## Configurar ou editar mapeamento de host

Ao configurar o Tableau LWC, é importante entender como o mapeamento de host e os IDs do site funcionam, além de como as opções de autenticação afetam a configuração.

O mapeamento de host é opcional, mas é um recurso útil para usuários pela primeira vez, pois permite que os usuários evitem inserir um ID de site no painel de componente. Essencialmente, ele mapeia um site específico do Tableau para seu ID do site correspondente, de modo que, quando alguém insere uma exibição de um site com um mapeamento de host existente, ele não precisa inserir manualmente o ID do site. Quando o mapeamento de host e um ID do site são especificados, o mapeamento de host tem precedência.

Para autenticação:

- A **Autenticação em todo o Tableau Server** não deve adicionar um ID de site automaticamente.
- A **Autenticação em todo o site do Tableau** deve adicionar um ID de site para garantir o acesso adequado.

Siga estas etapas para criar ou editar um mapeamento de host.

### Criar um novo mapeamento de host

1. No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
2. No painel de navegação esquerdo, digite “Tableau” na barra de pesquisa Busca rápida.
3. Selecione a página de configurações Inserção do Tableau.
4. Na seção Mapeamento de host do Tableau, selecione Criar novo.
5. Preencha os detalhes do mapeamento do host:
    
    1. **URL do site do Tableau**: insira uma URL para o site do Tableau que você deseja mapear. A URL deve conter o nome do site, a menos que seja uma instalação local usando o site padrão.
        
        As URLs de site do Tableau devem ser semelhantes a uma das seguintes:
        
        - `https://<CloudPOD>.online.tableau.com/#/site/SITENAME/`
        - `https://<CloudPOD>.online.tableau.com/#/site/SITENAME/Home`
        - `https://<CloudPOD>.online.tableau.com/#/site/SITESAML/connectedApplications`
    2. **ID do site do Tableau**: insira o ID do site do Tableau que você deseja mapear. Você pode usar o botão Copiar ID do site na página de configurações do aplicativo conectado ou na caixa de diálogo Compartilhar.
    3. **Tipo de host do site do Tableau**: selecione Tableau Cloud, Tableau Server (EAS em nível de site) ou Tableau Server (EAS em todo o servidor).
    
    **Observação**: se você deseja criar um mapeamento de host para este site, deixe a guia Aplicativos Conectados aberta. Você pode usar a URL desta página e o botão Copiar ID do site para preencher os campos de mapeamento de host na seção a seguir.
6. Selecione Salvar. Ou, se quiser retornar à página de configurações de inserção do Tableau sem salvar, selecione Cancelar.

### Editar um mapeamento de host

**Observação**: se você salvou mapeamentos de host anteriores à versão 254.10, será necessário atualizar o tipo de host do Tableau. Para obter mais informações e instruções de correção, consulte [Atualizar o tipo de host para mapeamentos de host do Tableau salvos](#Update).

Você pode atualizar a ID do site e o tipo de host de um mapeamento existente. Se precisar alterar a URL do site, exclua o mapeamento existente e crie uma nova com a URL correta.

1. Na página de configurações do Tableau Embeddings do aplicativo Salesforce, selecione Editar ao lado de um mapeamento de host existente.
2. Edite os campos ID do site do Tableau ou Tipo de host do site do Tableau conforme necessário.
3. Selecione Salvar. Ou, se quiser retornar à página de configurações de inserção do Tableau sem salvar, selecione Cancelar.

## Criar definições de declarações de atributos de usuário

Você pode aproveitar as Funções de Atributos do Usuário (UAF) com seus componentes de Web Lightning (LWC) do Tableau View e do Pulse para exibir dados específicos com base nos atributos do usuário que está olhando uma visualização. Para obter mais informações, consulte [Aproveitar as funções de atributo do usuário (UAF) com os componentes da Web do Lightning do Tableau](https://help.tableau.com/current/online/pt-br/lwc_uaf.htm).

## Adicionar LWCs do Tableau a uma página do Lightning usando o Criador de aplicativo Lightning

Os LWCs do Tableau estão disponíveis apenas nas páginas aplicativo, inicial e registrar do Lightning. Para obter mais informações sobre os tipos de página do Lightning e como usar o Criador de aplicativo Lightning, consulte o Criador de aplicativo Lightning na Ajuda do Salesforce.

**Observação:** as páginas de registro de caso não oferecem suporte ao uso de componentes da Web Lightning do Tableau com e-mails do Chatter.

Para adicionar um Tableau View ou LWC do Tableau Pulse a uma página existente do Lightning, siga estas etapas:

1. Navegue até a página Lightning que deseja editar.
2. Selecione o ícone de engrenagem no canto superior direito.
3. Selecione Editar Página.
4. Prossiga para a seção **Adicionar um LWC do Tableau a uma página do Lightning** abaixo.

Para adicionar um Tableau View ou LWC do Tableau Pulse a uma nova página do Lightning, siga estas etapas:

1. No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
2. No painel de navegação esquerdo, digite “Criador de aplicativo Lightning” na barra de pesquisa Busca rápida.
3. Selecione a página de configuração Criador de aplicativo Lightning.
4. Selecione Nova.
5. Selecione o tipo de página que deseja criar. Os LWCs do Tableau estão disponíveis nas páginas Aplicativo, Página inicial e Registro.
6. Selecione Próximo.
7. Insira um nome e selecione um layout para a nova página e selecione Concluído.

### Adicionar o LWC do Tableau à página Lightning

1. Na lista Componentes no lado esquerdo da página, arraste e solte o componente de exibição do Tableau ou Tableau Pulse na página.
2. Configurar o LWC:
    - [Configurar o componente Web Lightning de exibições do Tableau](https://help.tableau.com/current/online/pt-br/lwc_tableau_view.htm)
    - [Configurar o Componente da Web Lightning do Tableau Pulse](https://help.tableau.com/current/online/pt-br/lwc_tableau_pulse.htm)

### Salvar e ativar a página

1. Ao terminar de adicionar e configurar um LWC de exibição do Tableau ou Tableau Pulse, selecione Salvar.
2. Se você tiver criado uma nova página, será solicitado que você ative a página para que ela fique visível aos usuários Selecione Ativar.
3. Em Configurações de página da página Ativação, insira um nome, escolha um ícone e selecione sua preferência de visibilidade.
4. (Opcional) Em Experiência de Lightning da página Ativação, você pode adicionar a página a vários aplicativos de Experiência de Lightning.
5. (Opcional): em Navegação móvel da página Ativação, você pode adicionar a página ao menu de navegação móvel.
6. Selecione Salvar.

## Componente da Web Lightning combinável do Tableau

O Componente da Web Lightning agora é combinável, permitindo que ele seja inserido em Componentes de Web Lightning do Tableau personalizados e layouts de página mais flexíveis.

Isso permite que os desenvolvedores incorporem visualizações do Tableau como parte de experiências maiores e personalizadas no Salesforce, em vez de ficarem limitados ao posicionamento independente em uma página. O componente pode ser usado em outros LWCs e renderizado dinamicamente com base na lógica do aplicativo.

Ao usar o LWC do Tableau em um contexto combinável, certifique-se de que todas as configurações necessárias para autenticação contínua ainda estejam aplicadas, incluindo:

- Configuração do Aplicativo Conectado
- URLs confiáveis
- Configurações de autenticação JWT
- Mapeamento de host e configuração da Função de atributo do usuário (UAF)

O uso combinável segue os mesmos padrões de autenticação e acesso a dados que o uso padrão.

## Inserir várias exibições do Tableau

Você pode inserir mais de uma exibição do Tableau em uma página do Salesforce Lightning, desde que todas as exibições venham do mesmo site. O Tableau oferece suporte apenas a uma única sessão, e essa sessão é específica do site. A sessão concedida mais recentemente eliminará a anterior.

Para inserir exibições do Tableau de vários sites, você deve criar uma página separada do Lightning que seja específica do site.

## Logon único do LWC do Tableau para dispositivos móveis

**Observação:** os LWCs do Tableau View e Pulse estão disponíveis no iOS 17.2.1+.

Considere as seguintes práticas recomendadas para evitar problemas para usuários móveis:

- Tipo de página Lightning: os usuários móveis podem acessar páginas de aplicativos e páginas de registro, mas não páginas iniciais.  
    
    **Observação:** as páginas de registro devem estar associadas a um tipo específico de registro.
- Se você usar a mesma página para usuários de desktop e dispositivos móveis, selecione Ativação para verificar se a página do Lightning está definida como o padrão da organização para os formatos de desktop e telefone.
- Considere a criação de páginas Lightning separadas para desktop e dispositivos móveis para fornecer uma experiência visual personalizada. A altura do componente de exibição do Tableau é fixa e não se ajusta dinamicamente a diferentes tamanhos de tela.
- Para adicionar uma barra de rolagem a uma visualização, selecione Mostrar barra de ferramentas no painel de propriedades do componente de exibição do Tableau.
- Para o tipo de página do aplicativo, selecione Ativação e selecione a guia Lightning Experience. Adicione sua página à lista do LightningBolt para facilitar a localização da página no celular.
- No celular, o iOS bloqueia o tráfego entre sites por padrão. Abra suas configurações móveis, selecione Configurações do Salesforce e ative Permitir rastreamento entre sites. Para obter mais informações, consulte [Permitir rastreamento entre sites](https://help.salesforce.com/s/articleView?id=sf.branded_apps_cross_site_tracking.htm&type=5).

## Solução de problemas do Tableau LWC SSO com autenticação de token

### Atualizar o tipo de host para mapeamentos de host do Tableau salvos

Se você salvou mapeamentos de host anteriores à versão 254.10, será necessário atualizar o tipo de host do Tableau.

1. Na página de configurações Inserção do Tableau, verifique se os mapeamentos de host salvos têm um dos seguintes tipos de host do Tableau: Tableau Cloud, Tableau Server (EAS em todo o servidor), ou Tableau Server (EAS em nível de site).
2. Se o mapeamento tiver algum outro tipo de host do Tableau (por exemplo, TABLEAU\_CLOUD ou TABLEAU\_SERVER), selecione Editar para editar o mapeamento do host.
3. Na página Editar mapeamento de host do Tableau, selecione a configuração apropriada no menu suspenso Tipo de host do site do Tableau e selecione Salvar.
4. Repita as etapas 1 a 3 para todos os mapeamentos salvos, conforme necessário.

### Verifique a configuração do Salesforce e do Tableau

1. Verifique se os valores da URL do emissor e do URI do JWKS correspondem nas configurações do Salesforce e do Tableau e o URI do JWKS termina com id/chaves.
    
    - Para o Tableau Cloud, abra a página do Tableau Embedding de Configurações do Salesforce em uma guia. Em outra guia, abra a guia de Aplicativos conectados de Configurações do Tableau. Na guia Aplicativos conectados, selecione Servidor de autorização externo e Editar. Verifique se os valores da URL do emissor e do URI do JWKS correspondem, e que o URI do JWKS termina com id/chaves.
    - Para o Tableau Server, abra a página do Tableau Embedding de Configurações do Salesforce em uma guia. Em seguida, faça logon na interface da Web do Tableau Services Manager (TSM), navegue até Identidade e acesso do usuário e, em seguida, abra a guia Servidor de autorização.
2. Verifique o mapeamento de host: se você salvou um mapeamento de host, verifique se ele tem a ID de site e o tipo de host corretos.

### Verifique o token JWT

No editor de propriedades do componente Web do Lightning de exibição do Tableau, selecione Modo de depuração para verificar se o token JWT está funcionando conforme esperado.

1. Abra os registros do console e copie o token.
2. Vá ao site [jwt.io](https://jwt.io/) e cole o token no campo Codificado.
3. Verifique o seguinte:

- O assunto (“sub”) corresponde ao nome de usuário do Tableau.
- Para Tableau Cloud e Tableau Server (EAS em nível de site), o público (“aud”) é “tableau: {site ID}”.  
    Para o Tableau (EAS em todo o servidor), o público (“aud”) é “tableau”.
- O escopo (“scp”) inclui “tableau:views:embed” e “tableau:insights:embed”.
- O servidor EAS do emissor (“iss”) está correto.

### Verifique a ativação da página

Às vezes, um usuário cria uma página do Lightning, mas ela não foi ativada ou atribuída a nenhum lugar, então os usuários não conseguem encontrá-la. Selecione Ativação para verificar se a página do Lightning está definida como o padrão da organização para os formatos pretendidos.

> [!TIP]
> 
> **Dica:** ao depurar, é útil arrastar e soltar um componente Rich Text em sua página. Adicione uma breve descrição do tipo de página e da URL de exibição que você está tentando inserir. Isso permite que você tenha certeza de que a página visualizada pelo usuário final é a página que o administrador está editando.

### Confirme se o LWC de exibição do Tableau está funcionando sem autenticação contínua (LWC de exibição do Tableau somente)

1. No painel de Exibição do Tableau da página do Lightning, desmarque a caixa de seleção Habilitar logon único e, em seguida, salve as alterações.
2. Em Tableau Server, verifique se o campo ID do site está vazio.
3. Se você estiver conectado ao Tableau em outra guia, saia. Certifique-se de que navegar até a URL de exibição redirecione você para a página de login do Tableau. Não faça logon.
4. Navegue até a página Lightning. O LWC de exibição do Tableau deve exibir um botão Faça logon no Tableau.
5. Selecione Faça logon no Tableau e insira suas credenciais do login do Tableau.  
    **Observação:** se a exibição não for carregada, isso indicará um problema mais amplo na autenticação no Tableau.

### Erro: a versão do componente LWC não é mais compatível (somente LWC de exibição do Tableau)

Para resolver este erro, siga essas etapas:

1. Na lista Componentes, procure por “Tableau,” e em seguida arraste e solte o novo componente Exibição do Tableau para a página.
2. Copie todas as propriedades do painel de Exibição do Tableau do componente antigo para o novo componente.
3. Selecione o ícone de exclusão no componente antigo.

### Erro: para habilitar o LWC do Tableau Pulse, entre em contato com seu administrador do Salesforce para configurar a autenticação contínua para o Tableau (somente LWC do Tableau Pulse)

Para resolver esse erro, siga as etapas nesta página para **Ativar autenticação contínua para LWC do Tableau**.

## Consulte também

[Solucionar problemas de aplicativos conectados](https://help.tableau.com/current/online/pt-br/connected_apps_troubleshoot.htm#)

[Registrar EAS para ativar SSO para conteúdo inserido](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm)

<!-- document id=4e5f3703e83ba5a439d8a538562aa6754e0f1ec10ef990826ff9ec14dd7595bc url=/tableau/current/pt-br/server/config_r_tabpy.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar conexões com extensões do Analytics

O Tableau é compatível com um conjunto de funções que os usuários podem usar para transmitir expressões a extensões do Analytics para integração com R, Python e Einstein Discovery.

**Observação**: você pode usar scripts R e Python para realizar operações de limpeza complexas em seus fluxos do Tableau Prep, mas a configuração e a funcionalidade com suporte podem ser diferentes. Para obter informações, consulte [Usar scripts R e Python em seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm) na ajuda do Tableau Prep.

Este tópico descreve como configurar os sites no Tableau Server com extensões do Analytics.

Como o Tableau Server fornece um mecanismo de autenticação, pode ser mais seguro expor a funcionalidade de extensões do Analytics para usuários no Tableau Server do que no Tableau Desktop.

Para obter mais informações sobre cenários de usuário e configurar o Tableau Desktop ou Tableau Cloud, consulte [Transmitir expressões para extensões do Analytics](https://help.tableau.com/current/pro/desktop/pt-br/r_connection_manage.htm), na _Ajuda do Tableau Desktop e da Criação na Web_.

As etapas de configuração neste artigo são específicas para pastas de trabalho. Para obter informações sobre como você pode usar scripts R e Python para incorporar dados de modelagem preditiva em seu fluxo, consulte [Usar scripts R e Python em seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm) na _Ajuda do Tableau Prep_ .

## SSL do servidor

Para configurar o SSL para extensões de análise, instale um certificado válido no computador que executa o Tableau Server. O certificado deve ser confiável pelo computador que executa o Tableau Server. O campo Assunto ou uma das entradas SAN deve corresponder exatamente ao URI da configuração do serviço de extensões de análise.

## Ativar extensões de análise

Antes de configurar extensões, você deve ativar extensões de análise em todo o servidor.

1. [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).
    - Se você tiver apenas um único site (padrão) no servidor, clique em Configurações e vá até a Etapa 2.
    - Se você tiver vários sites em seu servidor:
        1. Em Todos os sites, clique em Gerenciar todos os sites .
        2. Clique na guia Extensões.
2. Role até Extensões de análise, selecione Ativar extensões de análise e clique em Salvar.
    
    ![Opções de Extensões de análise mostradas com a caixa de seleção Ativar extensões de análise marcada.](/tableau/current/pt-br/server/pt-br/Img/analytics-extension-server.png)

## Configurar definições com a extensão de análise

1. [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).
2. Na página Configurações, clique na guia Extensões e faça rolagem até Extensões de análise. (Em implantações de vários sites do Tableau Server, navegue até o site onde deseja configurar extensões de análise e clique em Configurações\>Extensões.)
3. **Somente implantações em vários sites**: você deve ativar extensões de análise em cada site. Em Extensões de análise, selecione Ativar extensões de análise para site.
4. Em Extensões de análise, clique em Criar nova conexão.
5. Na caixa de diálogo Nova conexão, clique no tipo de conexão que deseja adicionar e insira as configurações do seu serviço de análise:
    
    ![A caixa de diálogo Nova conexão é exibida com quatro opções para seleções de tipo de conexão: TabPy, Einstein Discovery, RServe e Analytics Extensions API.](/tableau/current/pt-br/server/pt-br/Img/analytics-extension-site-cx-type.png)
6. As opções que você precisa configurar dependem do tipo de conexão que escolher:
    
    - Para conexões do Einstein Discovery, clique em Ativar.
    - Para conexões de API de extensões do Analytics, Rserve e TabPy, digite as seguintes informações:
        - Nome de conexão (obrigatório): especifique o tipo de servidor ao qual você está se conectando. O RSERVE é compatível com conexões a R usando o pacote Rserve. Tabpy é compatível com conexões com Python usando o TabPy , ou para outras extensões do Analytics.
        - Exigir SSL (recomendado): selecione esta opção para criptografar a conexão com o serviço de análise. Se você especificar uma URL `HTTPS` no campo Nome do host, então deverá selecionar essa opção.
        - Nome do host (obrigatório): especifique o nome ou a URL do computador em que o serviço de análise está sendo executado. Este campo diferencia maiúsculas de minúsculas.
        - Portas (obrigatório): especifique a porta para o serviço.
        - Entre com um nome de usuário e uma senha (recomendado): selecione esta opção para especificar o nome de usuário e a senha usados para autenticar no serviço de análise.
7. Clique em Criar.

### Editar ou excluir uma conexão de extensão de análise

Para editar ou excluir uma configuração, navegue até Extensões de análise na guia Extensões do seu site.

![Ícones Editar e Excluir destacados nas opções de Extensões de análise.](/tableau/current/pt-br/server/pt-br/Img/analytics-extension-edit-delete.png)

Clique no ícone Editar ou Excluir e siga as instruções para alterar a configuração.

## Requisito do cliente: cadeia de certificados intermediários para serviço externo do Rserve

Você deve instalar uma sequência de certificados completa nos computadores Tableau Desktop (Windows e Mac) que estão se conectando a uma conexão externa do Rserve por meio do Tableau Server. Esse requisito se deve à forma como Rserve gerencia o handshake em conexões seguras.

Importar um certificado raiz no Tableau Desktop não é suficiente; toda a cadeia de certificados deve ser importada para o computador cliente.

## Erros de script

O Tableau não pode verificar se as pastas de trabalho que usam uma extensão do Analytics serão renderizadas corretamente no Tableau Server. Pode haver cenários em que uma biblioteca estatística necessária esteja disponível no computador de um usuário, mas não na instância da extensão do Analytics que o Tableau Server está usando.

Um aviso será exibido quando você publicar uma pasta de trabalho se ela tiver exibições que usam uma extensão de análise.

Essa planilha contém scripts de serviço externo, que não podem ser visualizados na plataforma de destino até que o administrador configure uma conexão de serviço externo.

## Determinar o uso de extensões de análise

A partir da versão 2021.2, as configurações de extensões de análsie são mapeadas no nível da pasta de trabalho. Isso permite que os administradores usem exibições personalizadas para consultar o Repositório do Tableau e determinar quais pastas de trabalho estão usando quais extensões e com que frequência elas são usadas.

Para fazer isso, você precisa unir as colunas da tabela de conexões da pasta de trabalho às tabelas que mostram o uso da pasta de trabalho. Para obter detalhes sobre como criar e usar exibições administrativas personalizadas, consulte [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm) e [Criar exibições administrativas personalizadas](https://help.tableau.com/current/server/pt-br/adminview_postgres.htm) .

<!-- document id=c6d678fd90044b7d26517200896fbba79a3a6d816c3a265a9b3bcca915b8c4a0 url=/tableau/current/pt-br/server/config_cors_sfdc.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar CORS no Salesforce.com para integração do Einstein Discovery no Tableau Server

Na versão 2021.1.0, foi adicionada a capacidade de integrar as previsões do Einstein Discovery no Tableau Dashboards. Você pode fazer isso usando extensões de painel do Einstein Discovery. Um pré-requisito para isso é configurar o compartilhamento de recursos entre origens (CORS) na organização Salesforce que hospeda o Tableau CRM e inclui o modelo e as previsões que serão usadas.

Este procedimento explica como um administrador em uma organização Salesforce.com faria essa configuração. Você pode encontrar mais informações sobre o CORS na documentação do Salesforce, [Configurar a lista de permissão do Salesforce CORS](https://help.salesforce.com/s/articleView?id=sf.extend_code_cors.htm).

## Configurar o CORS para Einstein Discovery.

**Observação:**este procedimento documenta o processo no Salesforce Lightning. Se você estiver usando a interface tradicional, a navegação poderá ser diferente, mas a configuração será a mesma.

1. Entre usando sua conta de desenvolvedor de Salesforce.com, clique no nome do usuário no canto superior direito e selecione Configuração.
    
    ![Um ícone de engrenagem com uma dica de ferramenta que diz Configuração.](/tableau/current/pt-br/server/pt-br/Img/config_oauth_einstein_cxapp_setup.png)
2. Na coluna de navegação à esquerda, procure por "cors" e selecione CORS.
    
    ![Campo de pesquisa com CORS inserido como termo de pesquisa e o resultado da pesquisa CORS exibido.](/tableau/current/pt-br/server/pt-br/Img/config_cors_einstein_search.png)
3. Em CORS, na seção Lista de origens permitidas, clique em Novo.
    
    ![Janela de configuração do CORS com a Lista de origens permitidas exibida e um cursor pairando sobre o botão Novo.](/tableau/current/pt-br/server/pt-br/Img/config_cors_einstein_new.png)
4. Em Edição da lista de origens permitida do CORS, digite a URL do Tableau Server, começando com "https://".
    
    ![Janela de configuração do CORS com um padrão de URL original inserido e um cursor pairando sobre o botão Salvar.](/tableau/current/pt-br/server/pt-br/Img/config_cors_einstein_allow_list.png)
    
    Para obter mais informações sobre o padrão de URL, consulte a documentação do desenvolvedor do Salesforce: [https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/extend\_code\_cors.htm](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/extend_code_cors.htm)
5. Clique em Salvar.

<!-- document id=5885ed7982f1d5072c61627baa559af884fb88ad62d471ff11bb81424ea8ca63 url=/tableau/current/pt-br/server/perf_workbook_scheduled_refresh.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar desempenho da pasta de trabalho após uma atualização agendada

Para melhorar os tempos de carregamento de pastas de trabalho, o Tableau Server armazena em cache os resultados de consultas incluídas nas pastas de trabalho. Na maioria das pastas de trabalho, os resultados de consulta são computados e armazenados em cache quando são visualizados pela primeira vez por um usuário no Tableau Server. Porém, nas pastas de trabalho que se conectam a extrações de dados, o Tableau Server pode computar novamente os resultados de consulta quando são realizadas as tarefas de atualização de extrações correspondentes. Isso reduz o tempo de carregamento dessas pastas de trabalho quando são visualizadas pela primeira vez. Dessa forma, essa opção é ativada por padrão em pastas de trabalho visualizadas recentemente.

> [!IMPORTANT]
> 
> **Importante!** O aquecimento do cache de consulta externa estará obsoleto na versão 2023.1. Para melhorar os tempos de carregamento de exibição de pastas de trabalho do Tableau Server, você deve permitir a aceleração de exibição em seu site. Para obter mais informações, consulte [Aceleração de exibição](https://help.tableau.com/current/server/pt-br/data_acceleration.htm).

## Determinar o impacto do desempenho

Embora esta opção reduza o tempo de carregamento inicial de pastas de trabalho, computar novamente os resultados de pesquisa também aumenta o carregamento no Tableau Server. Caso a instalação do Tableau Server já tenha restrições de desempenho, desative esta opção ou diminua o limite de cache da pasta de trabalho.

Estes são alguns motivos possíveis para desativar a opção ou diminuir o limite:

- A exibição administrativa [Tarefas em segundo plano para não extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm) mostra muitos trabalhos com longo tempo de execução na categoria Aquecer cache de consulta externa em alteração de dados.
- A exibição administrativa [Atraso de tarefas em segundo plano](https://help.tableau.com/current/server/pt-br/adminview_background_task_delay.htm) mostra longos atrasos.
- O consumo de memória e CPU para processos de processador em segundo plano é sempre alto.

No entanto, observe que esta é apenas uma das opções que afeta o desempenho de tarefas em segundo plano. Para obter mais informações sobre o desempenho, consulte [Desempenho](https://help.tableau.com/current/server/pt-br/perf_toc.htm).

## Desativar o cache da pasta de trabalho no servidor

Para diminuir a carga no Tableau Server, desative o cache da pasta de trabalho após uma atualização agendada no nível do servidor. Se você desativar essa opção, o Tableau Server armazenará em cache os resultados de consulta de pastas de trabalho na primeira visualização das pastas de trabalho.

Use a seguinte opção do tsm configuration set para desativar o cache de pasta de trabalho após uma atualização agendada:

backgrounder.externalquerycachewarmup.enabled

Para obter mais informações sobre como usar e aplicar as opções do tms set, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

## Desativar o cache de pasta de trabalho em um site

Também é possível desativar o cache de pasta de trabalho após uma atualização agendada de um site individual. Por exemplo, você poderá fazer isso se houver um determinado site com muitas pastas de trabalho lentas que aumentam o carregamento no servidor.

1. Selecione o site do qual deseja desativar o cache de pasta de trabalho na lista suspensa de sites.
2. Clique em Configurações.
3. Na seção Desempenho da pasta de trabalho após uma atualização agendada, desmarque a caixa de seleção.

**Observação**: embora esta opção esteja disponível nas configurações de um site individual, você deve ter permissões de administrador de servidor para visualizá-la.

## Configurar o limite de cache da pasta de trabalho

O Tableau Server computa novamente os resultados de consulta apenas para pastas de trabalho que têm tarefas de atualização agendada e que foram visualizadas recentemente.

É possível aumentar ou diminuir o número de pastas de trabalho que estão armazenadas em cache após uma atualização agendada com a opção do tsm configuration set a seguir:

backgrounder.externalquerycachewarmup.view\_threshold

Por padrão, o limite é definido como 2.0. O limite é igual ao número de visualizações que uma pasta de trabalho recebeu nos últimos sete dias, dividido pelo número de atualizações agendadas nos próximos sete dias. (Se uma pasta de trabalho não foi visualizada nos últimos sete dias, provavelmente não será visualizada em breve. Por isso, o Tableau Server não usa recursos que computam novamente as consultas da pasta de trabalho.)

<!-- document id=dfd73d18057ec4e18412d66b1669d9b993e0b760253a8bf983acd97b5009a7fc url=/tableau/current/pt-br/server/identity_pools_manage.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar e gerenciar grupos de identidades

Para criar e gerenciar grupos de identidades, você precisa fazer chamadas programaticamente nos [Métodos de grupos de identidade](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods) usando o Tableau REST OpenAPI. Para adicionar ou gerenciar usuários em um grupo de identidades, você pode usar a interface de usuário (IU) do Tableau Server diretamente ou por meio da API REST do Tableau.

O processo de configuração dos grupos de identidades é resumido nas etapas a seguir.

1. **Configure o Tableau Server e estabeleça uma sessão**.
2. **Provisione usuários** configurando uma nova instância de armazenamento de identidades local. **Observação:** você pode pular esta etapa para usar um armazenamento de identidades local existente ou externo que você configurou no TSM durante a instalação do Tableau Server.
3. **Configurar autenticação** para autenticar seus usuários no Tableau Server usando o OpenID Connect (OIDC).
4. **Criar um pool de identidades** que usa o armazenamento de identidade e a autenticação OIDC que você configurou.
5. **Adicionar usuários a um grupo de identidades** usando a IU do Tableau Server ou a API REST para permitir que os usuários entrem no Tableau Server.

Após a configuração, você pode [testar](#test), [gerenciar](#manage) e [solucionar problemas](#troubleshoot) dos seus pools de identidade.

**Observação:** você pode usar a coleção Postman de [Pools de identidades](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/folder/12721794-b229dea8-ee9c-4fbb-80d1-7e9153c207ee) no workspace Postman do desenvolvedor do Salesforce para aprender, desenvolver e testar os métodos descritos neste tópico.

## Pré-requisitos

Antes de começar a usar os pools de identidades, os seguintes requisitos devem ser atendidos:

- A integração com um provedor de identidade OIDC (IdP), como Okta, já está configurada
- O Tableau Server 2023.1 ou anterior está em execução
- Você executou a [migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm) – isso é necessário para novas implantações do Tableau Server e atualizações do Tableau Server

## Introdução

### Etapa 1: configurar o Tableau Server e estabelecer uma sessão

A habilitação de alterações associadas à configuração de grupos de identidade requer uma configuração única do TSM e uma declaração de variáveis de sessão e host.

**Para configurar o Tableau Server**

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute o seguinte comando:
    
    1. `tsm configuration set -k gateway.external_url -v http://<host>`
    2. `tsm pending-changes apply`
    
    Por exemplo, você pode executar os seguintes comandos para configurar seu Tableau Server, http://myco:
    
    `tsm configuration set -k gateway.external_url -v http://myco`  
    `tsm pending-changes apply`
    
    Para obter mais informações, consulte [gateway.external\_url](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#gateway_external_url).
    
    **Observação:** a partir da versão 2025.3, a URL especificada é o endpoint usado para logout único (SLO), se habilitado.
3. (Opcional) Execute os seguintes comandos para adicionar uma descrição para o pool inicial (TSM configurado):
    
    1. `tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v "<description>"`
    2. `tsm pending-changes apply`
    
    Por exemplo, você pode executar os seguintes comandos para adicionar uma descrição "Entrar para funcionários da MyCo":
    
    `tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v "Sign-in for MyCo employees"`  
    `tsm pending-changes apply`
    
    Para obter mais informações, consulte [descrição de pool wgserver.authentication.identity\_pools.default](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#initial_pool_description).
4. (Opcional) Execute os seguintes comandos para concluir a ativação do logout único (SLO) e para o pool inicial (TSM configurado):
    
    `tsm authentication openid enable-slo`  
    `tsm authentication openid get-slo-redirect-url`
5. Entre no Tableau Server como administrador do site e selecione o seguinte:
    
    1. Acesse as ferramentas de desenvolvedor do navegador e navegue até os cookies do aplicativo.
    2. Observe o valor workgroup\_session\_id.
    
    Por exemplo, se estiver trabalhando no Chrome, clique com o botão direito do mouse em qualquer lugar na página inicial do Tableau Server, clique com o botão direito do mouse e selecione Inspecionar. Clique em Aplicativo no painel de navegação superior e clique em Cookies no painel de navegação esquerdo. Em Cookies, clique no nome do Tableau Server, como http://myco.com, e observe o valor workgroup\_session\_id no painel central.
6. No script ou na ferramenta de desenvolvedor de API que você está usando para fazer solicitações de grupos de identidade usando o Tableau REST OpenAPI, faça o seguinte:
    
    1. Adicione o valor workgroup\_session\_id como uma variável global.
    2. Além disso, adicione porta 80, host (sua URL do Tableau Server) e protocolo (HTTP ou HTTPS) às suas variáveis globais.
    
    Por exemplo, a tabela a seguir mostra as variáveis globais necessárias para seu Tableau Server, http://myco.

| Variável global | Valor |
| --- | --- |
| ID da sessão do grupo de trabalho | XXX\_2abcDefDwGVzPu1hCQ|FJk5Z6OroPCLEDTKkwDxaeA0YzrIY04f|ca608d3c-fc01-4e40-ae5e-9b2131e4e7xx |
| Porta | 80 |
| Host | http://myco |
| Protocolo | HTTP |

### Etapa 2: configurar a agenda de atualização

O Tableau Server exige que você configure um armazenamento de identidade para fornecer ou provisionar seus usuários do Tableau Server.

Ao configurar um pool de identidades, você pode usar um novo ou existente [armazenamento de identidades local](https://help.tableau.com/current/server-linux/pt-br/plan_identity_store.htm#local-identity-store) ou pode usar um [armazenamento de identidades externo](https://help.tableau.com/current/server-linux/pt-br/plan_identity_store.htm#external-identity-store), Active Directory (AD) ou Lightweight Directory Access Protocol (LDAP), se esse armazenamento de identidades externo foi configurado durante a instalação do Tableau Server.

**Observação:** instâncias AD ou LDAP novas que não são a instância AD ou LDAP que você configurou no TSM durante a instalação do Tableau Server (também conhecidas como o pool inicial, configurado pelo TSM) não são configuráveis com pools de identidades.

**Para configurar um armazenamento de identidades**

Para configurar um novo armazenamento de identidades local, use o procedimento abaixo. Pule para [Etapa 3: configurar autenticação](#step3) se quiser usar um armazenamento de identidades local existente ou o armazenamento de identidades que você configurou durante a instalação do Tableau Server.

1. Faça uma solicitação de [Entrar](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_authentication.htm#sign_in) à API REST do Tableau para gerar um token de credenciais.
    
    #### Exemplo
    
    ##### URI
    
    `POST https://myco/api/3.19/auth/signin`
2. Depois que o token de credenciais for gerado, adicione o token de credenciais ao cabeçalho de todas as solicitações de API subsequentes.
3. Configure o armazenamento de identidade chamando o endpoint [Configurar armazenamento de identidade](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_RegisterIdentityStoreTAG) usando a OpenAPI da API REST do Tableau.
4. Na solicitação, especifique o seguinte:
    
    1. Tipo. O valor do tipo é sempre 0 para um tipo de armazenamento de identidades local. Se quiser usar um armazenamento de identidades local existente ou o armazenamento de identidades que você configurou no TSM durante a instalação do Tableau Server, não será necessário configurar uma nova instância de armazenamento de identidades local. Em vez disso, pule para Etapa 3: configurar a autenticação, abaixo.
    2. Nome. O nome deve ser exclusivo.
    3. Nome de exibição. Isso é opcional.
    
    #### Exemplo
    
    ##### URI
    
    https://myco/api/-/authn-service/identity-stores/
    
    ##### Corpo da solicitação (JSON)
    
    ```
    {
    "type": "0",
    "name": "Local identity store #1",
    "display_name": "Local identity store #1"
    }
    ```
    
    ##### Corpo de resposta
    
    _Nenhum_

### Etapa 3: configurar autenticação

Você pode configurar o método de autenticação OpenID Connect (OIDC) para autenticar seus usuários.

**Observação:** atualmente, o OIDC é o único método de autenticação configurável com pools de identidades, independentemente do tipo de armazenamento de identidades usado com o pool de identidades.

**Configuração do proxy de encaminhamento (opcional)**

Se sua organização usar um servidor proxy de encaminhamento e o Tableau Server estiver instalado no Windows, talvez seja necessário configurar o Tableau Server para rotear solicitações OIDC para o IdP por meio do proxy. Para configurar o proxy, siga as etapas descritas em [Erro de logon “O OpenID Connect não está configurado corretamente no servidor”](#proxy) após configurar a autenticação.

**Para configurar a autenticação**

1. Depois de configurar um armazenamento de identidade, chame o endpoint [Criar configuração de autenticação](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_RegisterAuthConfiguration) usando a OpenAPI da API REST do Tableau.
2. Na solicitação, especifique o seguinte:
    
    1. Tipo de autenticação. O valor do tipo de autenticação é "`OIDC`".
    2. iFrame. O valor padrão de iFrame é "`false`".
    3. A ID do cliente OIDC necessária, o segredo do cliente, a URL de configuração, a declaração de ID, a autenticação do cliente e a declaração de nome de usuário.
        
        - O ID do cliente e o segredo do cliente são fornecidos pelo seu OIDC IdP.
        - A URL de configuração também é fornecida pelo seu IdP. A URL e normalmente pode usar o seguinte formato: `https://<idp_url>/.well-known/openid-configuration`.
        - O valor padrão da declaração de ID é "`sub`". Para obter mais informações, consulte [Alteração da reivindicação sub](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm#sub).
        - O valor padrão da autenticação do cliente é "`CLIENT_SECRET_BASIC`".
        - O valor padrão da declaração de nome de usuário é "`email`". Para obter mais informações, consulte [Padrão: uso de reivindicação de e-mail para mapear usuários](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm#email).
        
        **Sobre a reivindicação de nome de usuário**
        
        O Tableau usa a declaração de nome de usuário para fins de correspondência de identidade. Se você fornecer identificadores ao adicionar usuários ao Tableau Server, o identificador será usado para corresponder ao valor fornecido na declaração de nome de usuário. Se nenhum identificador for fornecido, o padrão do Tableau é o nome de usuário definido no Tableau Server.
        
        **Observações:**
        
        - Se você pretende usar essa configuração de autenticação com um pool de identidades que usa AD como seu armazenamento de identidades, certifique-se de que o usuário atribuído tenha o valor AD sAMAccountName na declaração de nome de usuário.
        - Se você pretende usar esta configuração de autenticação com um pool de identidade que usa LDAP como seu armazenamento de identidade, certifique-se de que o usuário atribuído tenha o valor de nome de usuário LDAP na declaração de nome de usuário.

#### Exemplo

##### URI

https://myco/api/-/authn-service/auth-configurations/

##### Corpo da solicitação (JSON)

```
{
"auth_type": "OIDC",
"iframed_idp_enabled": true,
"oidc": {
	"client_id": "Xxx1hotzhjv4tyCd08",
	"client_secret": "XxXd2NCxY-BiLu_zcIwr2lJZLziT_7sw9Fi6XX3",
	"config_url": "https://admin.okta.com/.well-known/openid-configuration",
	"custom_scope": "",
	"id_claim": "sub",
	"username_claim": "email",
	"client_authentication": "CLIENT_SECRET_BASIC",
	"essential_acr_values": "",
	"voluntary_acr_values": "",
	"prompt": "login,consent",
	"connection_timeout": 100,
	"read_timeout": 100,
	"ignore_domain": false,
	"ignore_jwk": false
	}
}
```

##### Corpo de resposta

_Nenhum_

### Etapa 4: criar um pool de identidades

Dependendo do armazenamento de identidades que você configurou durante a instalação do Tableau Server, o pool de identidades criado pode ter apenas uma das seguintes combinações de armazenamento de identidades e método de autenticação:

- Armazenamento de identidades AD + autenticação OIDC
- Armazenamento de identidades LDAP + autenticação OIDC
- Armazenamento de identidades local + autenticação OIDC

As duas primeiras combinações requerem que o pool inicial (configurado por TSM) seja configurado para usar AD ou LDAP.

**Para criar um pool de identidades**

O procedimento descrito abaixo cria um pool de identidades com a última combinação, "armazenamento de identidades local + autenticação OIDC".

1. Depois de configurar a autenticação OIDC, chame o endpoint [Criar pool de identidades](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_RegisterIdentityPool) usando a OpenAPI da API REST do Tableau.
2. Na solicitação, especifique o seguinte:
    
    1. Nome e descrição para seu pool de identidades. O nome e a descrição do grupo de identidades ficam visíveis para todos os usuários na página inicial do Tableau Server.
    2. ID da instância do armazenamento de identidades e ID da instância do tipo de autenticação.
        
        **Observações:**
        
        - Para obter a ID da instância do armazenamento de identidades e a ID da instância do tipo de autenticação, você pode chamar os pontos de extremidade [Listar armazenamentos de identidades](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_ListIdentityStoresTAG) e [Listar configurações de autenticação](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_ListAuthConfigurations).
        - Se deseja criar um pool de identidades que usa o armazenamento de identidades que você configurou no TSM durante a instalação do Tableau Server, o valor da instância do armazenamento de identidades é sempre `'1'`.
    
    #### Exemplo
    
    ##### URI
    
    https://myco/api/-/authn-service/identity-pools/
    
    ##### Corpo da solicitação (JSON)
    
    ```
    {
    "name": "MyCo contractors",
    "identity_store_instance": "2",
    "auth_type_instance": "0",
    "is_enabled": true,
    "description": "Sign-in for MyCo contractors"
    }
    ```
    
    #### Exemplo do corpo de resposta
    
    _Nenhum_
3. Depois de criar o pool de identidades, acesse suas configurações de IdP e defina o URI de redirecionamento de logon como `http://<host>/authn-service/authenticate/oidc/<identity_pool_id>/login.`
    
    Por exemplo, `http://myco/authn-service/authenticate/oidc/XXtgfe21-74d2-3h78-bdg6-g2g6h1234567/login`
    
    **Observação:** para obter a ID do pool de identidades, você pode chamar o endpoint [Listar pools de identidade](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_ListIdentityPools).

**Observações:**

- Você pode criar quantos grupos de identidades sua organização precisar.
- Outros tipos de armazenamento de identidade e métodos de autenticação são suportados pelo pool inicial (TSM) configurado. Para obter mais informações, consulte [Autenticação](https://help.tableau.com/current/server/pt-br/security_auth.htm).

### Etapa 5: adicionar usuários a um pool

Você pode usar o Tableau Server diretamente para adicionar usuários a um grupo de identidades. Os usuários devem pertencer ao pool inicial (TSM configurado) ou ser adicionados a um pool de identidades para entrar no Tableau Server. Ao adicionar usuários a um pool de identidades, seu fluxo de trabalho pode mudar dependendo do armazenamento de identidade que foi configurado com o pool de identidades.

**Para adicionar usuários**

O procedimento abaixo descreve como adicionar usuários a uma identidade por meio da interface do usuário do Tableau Server. No entanto, você pode adicionar usuários a um grupo de identidades usando a API REST do Tableau chamando o endpoint [Adicionar usuário ao pool de identidades](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_identity_pools.htm#add_user_to_idpool).

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites).
3. Clique no Adicionar usuários botão e selecione Criar novo usuário ou Importar usuários do arquivo.
    
    Para **Criar novo usuário**:
    
    1. Selecione o grupo de identidades ao qual deseja adicionar o novo usuário e clique em Avançar.
        
        1. Se você selecionou um pool de identidades configurado com um armazenamento de identidade AD ou LDAP, insira nomes de usuário, atribua associação ao site e funções no site. Quando terminar, clique no botão Importar usuários.
        2. Se você selecionou um pool de identidades configurado com um armazenamento de identidade local, insira o nome de usuário. A caixa de diálogo se expande para que você possa adicionar um nome de exibição, um identificador (na maioria dos casos), endereço de e-mail e definir o site e as funções do site. Quando terminar, clique no usuários botão Criar usuário.
            
            Para obter mais informações sobre nomes de usuário e como atribuir associação e funções de site ao site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).
            
            **Sobre nomes de usuário e identificadores no Tableau**
            
            Um nome de usuário é a informação que representa o usuário do sistema. Um identificador é usado para complementar as informações de nome de usuário e pode ser usado por armazenamentos de identidade externos como alternativas aos nomes de usuário.
            
            No Tableau, um nome de usuário é um valor imutável usado para entrar no Tableau e os identificadores são valores mutáveis usados na estrutura de identidade do Tableau como uma forma de corresponder os usuários aos seus nomes de usuário. Os identificadores permitem que o Tableau seja mais flexível porque podem se desviar do nome de usuário. Se houver alterações no nome de usuário no armazenamento de identidade externo, os administradores do Tableau Server podem atualizar o identificador para garantir que os usuários correspondam aos nomes de usuário corretos.
            
            Ao adicionar um usuário existente a um grupo de identidades, você pode esperar a capacidade de definir um identificador. Por exemplo, se um usuário existente pertence a um pool de identidade configurado com um armazenamento de identidade local e você deseja adicioná-lo a um pool de identidade configurado com um armazenamento de identidade do AD, solicitamos que você forneça o nome de usuário para pesquisar identificadores associados a esse usuário . Por outro lado, se um usuário existente pertencer a um pool de identidade configurado com um armazenamento de identidade do AD e você quiser adicioná-lo a um pool de identidade configurado com um armazenamento de identidade local, pedimos que você forneça um identificador opcional. Uma exceção a isso é se você deseja adicionar um usuário ao pool inicial (configurado por TSM) que está configurado com um armazenamento de identidade local e autenticação local. Você não poderá definir um identificador para esse usuário.
    
    Para **Importar usuários do arquivo**:
    
    1. Carregue um arquivo .csv que contenha as seguintes colunas na ordem listada:
        
        `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier`
        
        **Observação:** nome de usuário e senha são as únicas colunas obrigatórias. No entanto, se você não especificar o nome do pool de identidades, o usuário será adicionado ao pool inicial (TSM configurado). Para obter mais informações, consulte [Diretrizes do arquivo de importação CSV](https://help.tableau.com/current/server/pt-br/csvguidelines.htm).
        
        Por exemplo, suponha que você queira adicionar Henry Wilson e Fred Suzuki ao grupo de identidades General Contractors. Seu .csv pode conter os seguintes valores:
        
        `henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson`  
        `freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki`

**Observação:** quando um ou mais grupos de identidades são criados, a página inicial do Tableau Server é atualizada para incluir opções de entrada para usuários que são membros desses grupos de identidades. Para obter mais informações, veja [Provisionar e autenticar usuários usando grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Testar pools de identidade

Depois de configurar um pool de identidades, recomendamos que você o teste saindo do Tableau Server e entrando novamente como um usuário que pertence ao pool de identidades. Certifique-se de concluir o processo de login para garantir que a autenticação OIDC foi configurada corretamente.

**Observação:** Se você configurou uma descrição opcional para o pool inicial (TSM configurado) em [Etapa 1: configurar o Tableau Server e estabelecer uma sessão](#step1) ou fazer uma observação de [Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm) para o Tableau Server, sugerimos que a descrição seja específica para usuários que entram usando o pool inicial (TSM configurado), e a observação de Personalização de entrada se aplica a todos os usuários que entram no Tableau Server.

## Gerenciar pools de identidade

Você pode gerenciar os usuários em grupos de identidades na página Usuários no nível do servidor e no nível do site. Na página Usuários, você pode ver a quais grupos de identidades os usuários pertencem e detalhes resumidos sobre o grupo de identidades.

Para todas as outras tarefas de gerenciamento de pools de identidades, incluindo atualizar uma configuração de autenticação ou pool de identidades e excluir um armazenamento de identidade local ou pool de identidades, use o Tableau REST API OpenAPI descrito no [Métodos de grupos de identidade](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Identity-Pools-Methods).

## Solucionar problemas de pools de identidade

### Limitações de pools de identidade

Os pools de identidades estão disponíveis apenas com o Tableau Server.

**Observação:** no momento, os pools de identidades estão disponíveis apenas para configuração no nível do servidor. Os pools de identidades não podem ter como escopo um site.

### A página inicial do Tableau Server mostra erros de IdP

Na página inicial do Tableau Server, abaixo da opção de entrada principal, uma mensagem de erro relacionada ao IdP pode ser exibida ao lado de uma opção de entrada do grupo de identidades. Esse problema relacionado à autenticação OIDC pode ocorrer quando um ou ambos os itens a seguir forem verdadeiros: 1) O Tableau Server não foi configurado para enviar uma URL externa para o IdP e 2) as variáveis globais não foram declaradas.

Para resolver esse problema, certifique-se de concluir o procedimento descrito em [Etapa 1: configurar o Tableau Server e estabelecer uma sessão](#step1) acima.

### A página inicial do Tableau Server não mostra pools de identidades

Se o recurso de grupos de identidades estiver desativado, será possível ativá-lo novamente usando os seguintes comandos do TSM:

tsm configuration set -k features.IdentityPools -v true

tsm configuration set -k features.NewIdentityMode -v true

tsm configuration set -k wgserver.authentication.legacy\_identity\_mode.enabled -v false

tsm pending-changes apply

**Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado.

## Erro de logon “O OpenID Connect não está configurado corretamente no servidor”

Quando os usuários entram no Tableau Server, o seguinte erro aparece:

_“O OpenID Connect não está configurado corretamente no servidor. Para obter ajuda, entre em contato com o administrador do Tableau Server.”_

Se sua organização usar um servidor proxy de encaminhamento e o Tableau Server estiver instalado no Windows, talvez seja necessário configurar o Tableau Server para rotear solicitações OIDC para o IdP por meio do proxy. Para resolver esse problema, defina as configurações de proxy para o Tableau Server usando o TSM.

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute o seguinte comando para habilitar os proxies:
    
    1. `tsm configuration set -k tomcat.useSystemProxies -v true`
3. Execute os seguintes comandos para definir o host e a porta do proxy e reinicie o Tableau Server:
    
    1. `tsm configuration set -k tomcat.http.proxyHost -v <proxy_host>`
    2. `tsm configuration set -k tomcat.http.proxyPort -v <proxy_port>`
    3. `tsm pending-changes apply`
    
    **Observações:**
    
    - Substitua `<proxy_host>` e `<proxy_port>` pelas informações de proxy para seu ambiente. Não inclua “http://” em `<proxy_host>`.
    - Para proxies HTTPS, você pode usar os pares de chave-valor `tomcat.https.proxyHost` e `tomcat.https.proxyPort`.

<!-- document id=c465ff2eb20169009e3322199891d0617308784377c416e4c24f2fb872fc2bca url=/tableau/current/pt-br/server/external_actions_admin.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar Ações externas integração de fluxo

**Observação:** as ações externas no Tableau dependem em funcionalidade fornecida pelo Salesforce Flow. O recurso envia seus dados selecionados para o Salesforce Flow, que é executado em uma infraestrutura separada do Salesforce. O uso do Salesforce Flow e de outros produtos e serviços da Salesforce está sujeito ao seu contrato com a Salesforce.

Para obter mais informações sobre como usar o Ações externas, consulte [Integrar Ações externas](https://help.tableau.com/current/pro/desktop/pt-br/external_actions.htm).

## Requisitos de edições, funções de site e permissões

Para configurar e usar fluxos de trabalho do Ações externas, você e qualquer pessoa que usará fluxos de trabalho devem ter determinadas funções e permissões de site em edições do Salesforce e Tableau que aceitem Ações externas.

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col><col></colgroup><thead><tr><th>Produto</th><th>Edições</th><th>Funções e permissões de sites</th></tr></thead><tbody><tr><td>Tableau</td><td><a href="https://www.tableau.com/pt-br/products/cloud-bi" target="_blank">Tableau Cloud</a>, <a href="https://www.tableau.com/pt-br/products/desktop" target="_blank">Tableau Desktop</a> ou <a href="https://www.tableau.com/pt-br/products/server" target="_blank">Tableau Server</a> versões 2022.3 ou posteriores</td><td><p><b>Para criar ou editar um fluxo de trabalho:</b> Função de site <a href="https://help.tableau.com/current/blueprint/pt-br/bp_license_types.htm#tableau-creator" target="_blank">Creator</a> ou <a href="https://help.tableau.com/current/blueprint/pt-br/bp_license_types.htm#tableau-explorer" target="_blank">Explorer</a> (pode publicar) e permissões para editar e salvar pastas de trabalho (<a href="https://help.tableau.com/current/server-linux/pt-br/web_author_who.htm" target="_blank">Linux</a> | <a href="https://help.tableau.com/current/server/pt-br/web_author_who.htm" target="_blank">Windows</a>)</p><p><b>Para enviar dados</b>: baixe o recurso de permissão de dados resumidos <img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloadsumdata_icon.png" alt=""></p><p><b>Para usar um fluxo de trabalho:</b> qualquer função de site</p></td></tr><tr><td>Salesforce</td><td>Edição Essentials, Professional, Enterprise, Performance, Unlimited ou Developer (consulte <a href="https://help.salesforce.com/s/articleView?id=sf.overview_edition.htm&amp;type=5" target="_blank">Edições do Salesforce</a>)</td><td><p><b>Para criar ou editar um fluxo:</b> <a href="https://help.salesforce.com/s/articleView?id=sf.retail_task_admin_permission_flow.htm&amp;type=5" target="_blank">Gerenciar permissões de fluxo</a></p><p><b>Para usar um fluxo:</b> <a href="https://help.salesforce.com/s/articleView?id=sf.retail_task_admin_permission_flow.htm&amp;type=5" target="_blank">Permissão Executar fluxos</a> ou <a href="https://help.salesforce.com/s/articleView?id=sf.user_fields.htm&amp;type=5" target="_blank">configuração de Usuário de fluxo na página de detalhes do usuário</a> ou <i>substituir o comportamento padrão e restringir o acesso a perfis habilitados ou configuração de conjuntos de permissões</i> no nó de fluxo (consulte <a href="https://help.salesforce.com/s/articleView?id=sf.flow_distribute_security.htm&amp;type=5" target="_blank">Como funciona a segurança de fluxo?</a>)</p></td></tr></tbody></table>

## Requisitos de implantação para Ações externas

Para usar a extensão de fluxo de trabalho Ações externas, o administrador do Salesforce deve [criar um aplicativo conectado](https://help.salesforce.com/s/articleView?id=sf.connected_app_create.htm) no Salesforce para Tableau Server.

Além disso, o domínio do site do Tableau Server ou do Tableau Cloud onde a extensão será implantada deve ser adicionado à [lista de permissões do Salesforce Cross-Origin Resource Sharing (CORS)](https://help.salesforce.com/s/articleView?id=sf.extend_code_cors.htm) .

## Habilitar ou desabilitar Ações externas

No Tableau 2022.3 e posteriores, o recurso do Ações externas do Tableau é ativado por padrão. Para desativar o recurso, você pode usar a interface de linha de comando (CLI) do Tableau Services Manager (TSM) ou configure as configurações de nível de site.

### Usar a CLI do TSM

[Use a CLI do TSM](https://help.tableau.com/current/server/pt-br/tsm.htm) para definir o valor para a chave de configuração `vizqlserver.workflow_objects_enabled` para `tsm configuration set -k vizqlserver.workflow_objects_enabled -v false`.

Depois de alterar o valor da chave de configuração, certifique-se de aplicar a alteração usando o comando `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 ela 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).

### Modificar configurações no nível do site

Para obter mais informações sobre como personalizar as configurações de nível de site no Tableau Server, consulte [Referência de configurações de site](https://help.tableau.com/current/server/pt-br/sites_add.htm).

<!-- document id=583be00116014055045a2eb7b5199ce91fd312af8543c2f5579d6d8e4a8746a4 url=/tableau/current/pt-br/server/server_tsig_configure_auth_mod.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar módulo de autenticação com Independent Gateway

Uma prática de segurança comum é permitir que apenas solicitações autenticadas passem pelo firewall interno dos servidores DMZ. O Independent Gateway oferece suporte aos métodos tradicionais de autenticação do Tableau Server, mas também inclui propriedades de configuração que permitem integrar um módulo carregável httpd do Apache para autenticação personalizada.

Por exemplo, ao configurar o SAML no Tableau Server e um módulo de autenticação personalizado, você pode exigir que todos os usuários se autentiquem com seu IdP no Independent Gateway. Somente os usuários autenticados poderão acessar o Tableau Server, que, por sua vez, poderá autenticar e autorizar o acesso do usuário.

Para obter uma explicação mais detalhada desse esquema de autenticação, consulte [Pré-autenticação com um módulo AuthN](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part5.htm#preauthentication-with-an-authn-module) no Guia de implantação corporativa.

Para configurar o módulo de autenticação, você deve seguir as seguintes etapas:  

1. Gerar o arquivo de configuração do módulo de autenticação. Quando a configuração estiver concluída, cada módulo e suas diretivas de configuração serão tratados como opções de Include, tornando os arquivos incluídos logicamente parte da configuração geral do httpd.
2. Copie os arquivos de configuração para cada computador executando o Independent Gateway. Todos os arquivos devem ser copiados para os mesmos locais em cada computador do Independent Gateway. Cada arquivo é mapeado para uma propriedade de configuração gerenciada pelo Tableau Server.
3. Defina as propriedades de configuração com o comando `tsm configuration set` no Tableau Server.

Não edite o arquivo de configuração httpd (httpd.conf) no Independent Gateway, pois o Independent Gateway inclui lógica para atualizar a configuração httpd com base nas alterações feitas com comandos do TSM no Tableau Server.

## Exemplo de configuração do módulo de autenticação

Para obter um exemplo de configuração do módulo de autenticação de ponta a ponta, consulte [Exemplo de configuração de autenticação: SAML com IdP externo](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part5.htm#example-authentication-configuration-saml-with-external-idp) no Guia de implantação corporativa. O exemplo descreve como instalar e configurar o SAML com o módulo de autenticação Okta IdP e Mellon para uma implantação do Tableau Server em Linux em execução na AWS. Embora o exemplo descreva o processo para Linux, o exemplo de configuração também é útil para o Tableau Server no Windows.

## Propriedades de configuração

A tabela a seguir descreve os vários arquivos de configuração aos quais você pode fazer referência. Cada arquivo é mapeado para uma propriedade de configuração definida no Tableau Server. Use barras no caminho, mesmo no Windows (convenção httpd do Apache.) Você só precisa definir as propriedades necessárias para formular sua configuração de autenticação personalizada. Ignore quaisquer propriedades de configuração que não sejam necessárias.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 40%;"><col style="width: 60%;"></colgroup><tbody><tr><th>Propriedade de configuração</th><th>Descrição</th></tr><tr><td>gateway.tsig.authn_module_block</td><td>Aparece no final do conjunto de módulos httpd do Apache carregados normalmente. A intenção é que o arquivo inclua uma ou mais diretivas <code> LoadModule</code>. Os próprios módulos devem ser identificados com caminhos completos.</td></tr><tr><td>gateway.tsig.authn_global_block</td><td>Aparece depois de todas as referências de <code>LoadModule</code> e antes da maioria das outras diretivas httpd do Apache. A intenção é fornecer um local para quaisquer diretivas de configuração necessárias ao módulo personalizado.</td></tr><tr><td>gateway.tsig.authn_globalbottom_block</td><td>Aparece na parte inferior do arquivo de configuração, novamente no nível global. A intenção é fornecer um local para quaisquer diretivas de configuração necessárias ao módulo personalizado que devem vir especificamente após várias outras diretivas. (É improvável que você precise disso.)</td></tr><tr><td>gateway.tsig.authn_location_block</td><td>Aparece dentro de um bloco <code>&lt;Location "/"&gt;</code>, cobrindo todos os caminhos de URL.</td></tr><tr><td>gateway.tsig.authn_directory_block</td><td>Isso aparece dentro de um bloco <code>&lt;Directory "/"&gt;</code>, cobrindo todos os caminhos para arquivos servidos pelo Independent Gateway. (É improvável que você precise disso. A maioria dos arquivos atendidos pelo Independent Gateway são ativos estáticos não sensíveis, como imagens e arquivos JavaScript.)</td></tr><tr><td>gateway.tsig.authn_virtualhost_block</td><td><p>Aparece dentro de um ou dois blocos <code>&lt;VirtualHost&gt; </code>: um para TLS (se habilitado) e um para não TLS. Se configurado, o mesmo arquivo é incluído em ambos os locais. Se você precisar distinguir os dois casos, poderá usar a variável de ambiente HTTPS HTTPS padrão do Apache.</p></td></tr></tbody></table>

## O bloco `<Location "/tsighk">`

Além do bloco `<Location "/">` esperado para tráfego de solicitação normal, há também um bloco `<Location "/tsighk">` usado para atender solicitações internas de manutenção de Independent Gateway (HK). Essas solicitações de HK têm seus próprios protetores de autenticação e não funcionarão com soluções de SSO personalizadas típicas.

Você pode precisar excluir explicitamente seu módulo personalizado da tentativa de autenticação para o caminho de URL HK.

Para determinar se você precisa excluir o módulo, primeiro configure o módulo. Em seguida, procure solicitações de HK no log de acesso do Independent Gateway. Você deve ver pelo menos uma verificação de status uma ou duas vezes por minuto. Se essas solicitações estiverem recebendo um código de resposta 200, provavelmente tudo está OK. Por outro lado, se essas solicitações receberem um código de resposta 3xx (redirecionando para seu provedor de autenticação personalizado), você precisará fazer algo a respeito.

As possíveis soluções alternativas incluem:

- O bloco `<Location "/tsighk">` contém a diretiva `AuthType None`, e isso pode ser suficiente.
- O Independent Gateway httpd.conf tem a diretiva httpd padrão do Apache `[ProxyPreserveHost](https://httpd.apache.org/docs/2.4/mod/mod_proxy.html#proxypreservehost) On` . Se houver uma circunstância incomum que exija que esteja Desligado ou algum outro valor, esse valor pode ser definido com o item de configuração do TSM `gateway.tsig.proxypreservehost` .
- Você pode precisar de algumas diretivas específicas do módulo para desabilitar seu módulo de autenticação para `<Location "/tsighk">` . Você não pode modificar diretamente esse bloco no arquivo httpd.conf. Em vez disso, você pode fazer outro bloco `<Location "/tsighk">` em seu `gateway.tsig.authn_global_block` e deixar o httpd do Apache mesclá-los logicamente. Por exemplo, algumas versões do mod\_auth\_mellon, um popular módulo de autenticação de código aberto, requerem `MellonEnable Off` para seções onde não se aplica, mesmo se`AuthType None` é definido nessas seções.
- Ao criar uma seção `<Location "/tsighk">` adicional, conforme descrito no item anterior, você pode descobrir que a ordem de aparecimento das várias seções no arquivo httpd.conf faz diferença em como elas afetam umas às outras. A seção padrão `<Location "/tsighk">` aparece antes da seção padrão `<Location "/">`. Se sua experimentação mostrar que alguma ordem diferente é necessária, talvez seja necessário definir outra seção `<Location "/">` em seu bloco `gateway.tsig.authn_global_block`, além de outra seção `<Location "/tsighk">`, nesse caso você pode não precisar de algo em um bloco `gateway.tsig.authn_location_block`.

## Solucionar problemas de configuração do módulo de autenticação personalizado

Uma maneira prática de entender como o Independent Gateway comporá o arquivo httpd.conf é definir os itens de configuração do TSM com valores que apontam para arquivos vazios nos computadores do Independent Gateway. (Os arquivos devem existir, mas podem estar vazios.) Você pode então olhar para o arquivo httpd.conf do Independent Gateway para obter uma compreensão concreta de onde aparecerão as diretivas `Include` os vários arquivos de configuração.

Problemas de configuração no Independent Gateway httpd.conf podem resultar na não inicialização do serviço `tsig-httpd`. Outros problemas de configuração podem interferir no recebimento de atualizações de configuração do serviço complementar do Independent Gateway no cluster do Tableau Server. Uma maneira de recuperar, depois de corrigir o que causou o problema, é copiar `TSIG_DATA/config/httpd.conf.stub` para`TSIG_DATA/config/httpd.conf` e, em seguida, reiniciar o serviço `tsig-httpd`.

Para obter mais dicas de solução de problemas, consulte [Solução de problemas do Independent Gateway do Tableau Server](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part7.htm#troubleshooting-tableau-server-independent-gateway) no Guia de implantação corporativa (EDG). O EDG fornece exemplos de implantação do Tableau Server no Linux. As etapas de solução de problemas são úteis para as versões Windows ou Linux do Tableau Server.

<!-- document id=083317132b5f522b68ca6aba7d1c3fdc74f6d87493eacbca82b7808c50b71d96 url=/tableau/current/pt-br/server/config_nodes.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar nós

Use a interface do usuário na Web do Tableau Services Manager (TSM) ou os comandos da CLI para configurar a topologia de um nó. O nó inicial é configurado com um padrão que inclui todos os processos usados pelo TSM e o Tableau Server. Ao adicionar nós, é necessário especificar quais processos serão executados nesses nós e quantas instâncias esses processos executarão. Você também pode querer alterar a topologia do nó inicial, adicionando instâncias de processos existentes ou movendo alguns desses processos para os nós adicionais (isso é comum ao configurar uma instalação distribuída do Tableau Server).

**Observação:** não é possível remover o Armazenamento de arquivos ou o Repositório (pgsql) se esta for a única instância desse processo no cluster. Você deve ter pelo menos uma instância de cada um dos processos na sua instalação do Tableau Server. Além disso, deve adicionar a segunda instância e permitir que ela sincronize com a primeira, antes de remover o processo no nó original. Para obter mais informações, consulte [Mover o processo de repositório](https://help.tableau.com/current/server/pt-br/distrib_rep_move.htm) e [Mover o processo do Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/distrib_de_move.htm).

**Observação:** se tiver o agente Resource Monitoring Tool do Tableau instalado nesse nó, precisará atualizar o Servidor mestre para refletir as alterações que feitas um nó Resource Monitoring Tool do Tableau Server. As alterações incluem adicionar ou remover processos ou alterar a quantidade de processos em um nó. Para obter mais informações, consulte [Alterações de topologia do Tableau Server](https://help.tableau.com/current/server/pt-br/rmt-tableau-server-topology-changes.htm).

Na maioria dos casos, você pode fazer várias alterações na configuração do servidor. Exceções ocorrerão se você estiver movendo ou removendo uma instância do armazenamento de arquivos ou o repositório.

Para configurar seus nós do Tableau Server usando a interface na Web do TSM, faça o seguinte:

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração.
    
    As próximas etapas dependem das alterações de configuração que você deseja realizar.
    
    - **Adicionar processos** - para adicionar processos a um nó, especifique o número de instâncias desejadas no nó ou selecione a caixa do processo.
        
        Por exemplo, para adicionar quatro instâncias do processador em segundo plano e um gateway a um nó:
        
        1. Selecione a caixa Gateway:
            
            ![Um cursor passa sobre a caixa de seleção para uma configuração de "Gateway". ](/tableau/current/pt-br/server/pt-br/Img/tsm-clear-gateway.png)
        2. Defina a contagem do Processador em segundo plano como 4:
            
            ![Menu suspenso para o Processador em segundo plano expandido com o número quatro selecionado.](/tableau/current/pt-br/server/pt-br/Img/tsm-set-backgrounder.png)
            
            Adicionar o processador em segundo plano a um nó também adicionará uma instância do processador de dados caso ainda não exista uma no nó.
            
            **Observação:** a interface de usuário na Web do TSM limita a um máximo de 8 instâncias de processos que permitem selecionar o número de instâncias. Para configurar mais instâncias, use a linha de comando e o comando `TSM topology set-process` . Para obter mais informações, consulte [tsm topology set-process](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess).
    - **Alterar contagem de processos** - para alterar o número de processos em um nó, especifique o novo número ou selecione a caixa do processo.
    - **Remover um processo completamente** - para remover todas as instâncias de um processo de um nó, desmarque a caixa do processo ou defina a contagem como 0 (zero).
    
    Na maioria dos casos, a transferência de um processo de um nó para outro acontece quando a contagem de instâncias do processo no primeiro nó é definida como 0 (zero) e a contagem no segundo nó é definida como um valor diferente de zero.
    
    Se você estiver tentando fazer uma configuração que não é permitida (se, por exemplo, tentar remover um armazenamento de arquivo que não tenha sido desativado), será exibida uma mensagem informando isso.
3. Clique em Alterações pendentes na parte superior direita e em Aplicar alterações e reiniciar para confirmar as alterações e reiniciar o Tableau Server.

Para configurar os nós, execute comandos do nó inicial e use a ID do nó para especificar qual deles você está configurando. Para determinar a ID do nó, use o comando `[tsm topology list-nodes](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMListNodes)`. Use o comando `[tsm topology set-process](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess)` para adicionar, atualizar ou remover um processo em um nó. É preciso especificar o nó que está configurando, o processo que está adicionando, atualizando ou removendo e o número de instâncias do processo. Após definir a topologia para um nó, é necessário aplicar as alterações ao Tableau Server.

Aplique as alterações com o comando `[tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply)`. Depois que as alterações são aplicadas, o Tableau Server retorna ao estado anterior à execução do comando. Ou seja, se estava em execução, ele será reiniciado, e se estava parado, continuará parado após a aplicação das mudanças pendentes. Na maioria dos casos, se o Tableau Server está em execução ao aplicar as mudanças pendentes, o servidor é interrompido para que as alterações sejam aplicadas e, em seguida, é reiniciado. A exceção ocorre quando a quantidade de instâncias do Processador em segundo plano  ou do VizQL Server é alterada em um nó existente. Com essas alterações nos processos em um nó existente, o Tableau Server não precisa ser interrompido se estiver em execução.

Você precisa saber a ID de nó do nó que deseja configurar para realizar o processo. Para determinar a ID do nó, use este comando:

`tsm topology list-nodes -v`

**Observação:** os exemplos aqui mostram alguns nomes de processo. Para obter uma lista completa, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

### Adição de processos a um nó

Use o comando `tsm topology set-process` para adicionar um processo a um nó. É necessário especificar o nó que está configurando, o processo que está adicionando e o número de instâncias do processo.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó que você está alterando:
    
    `tsm topology list-nodes -v`
3. Especifique o processo e o número de instâncias para adicionar processos no nó.
    
    Por exemplo, este comando acrescenta duas instâncias de processador em segundo plano ao nó 1:
    
    `tsm topology set-process -n node1 -pr backgrounder -c 2`
4. Aplique as alterações:
    
    `tsm pending-changes apply`

### Alteração do número de processos em um nó

Altere o número de processos em um nó ao especificar um processo já configurado e oferecer um novo valor para o número de instâncias.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó que você está alterando:
    
    `tsm topology list-nodes -v`
3. Altere o número de processos no nó ao especificar um processo já configurado e oferecer um novo valor para o número de instâncias.
    
    Por exemplo, em um nó (node1) com processador em segundo plano, este comando altera o número de instâncias para quatro:
    
    `tsm topology set-process -n node1 -pr backgrounder -c 4`
4. Aplique as alterações:
    
    `tsm pending-changes apply`

### Remover todas as instâncias de um processo a partir de um nó

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó que você está alterando:
    
    `tsm topology list-nodes -v`
3. Para remover um processo de um nó, basta especificar uma contagem de 0 instâncias para o processo que deseja remover.
    
    Por exemplo, este comando remove o processo do processador em segundo plano do node1:
    
    `tsm topology set-process -n node1 -pr backgrounder -c 0`
4. Aplique as alterações:
    
    `tsm pending-changes apply`

### Transferir todas as instâncias de um processo de um nó para outro

Na maioria dos casos, a transferência de um processo de um nó para outro acontece ao definir para zero a contagem da instância do processo no primeiro nó e ao definir a contagem para um valor diferente de zero no segundo nó.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó que você está alterando:
    
    `tsm topology list-nodes -v`
3. Mova um processo de um nó para outro, especificando uma contagem de 0 instâncias para esse processo no primeiro nó e uma contagem de 1 ou mais para o segundo nó.
    
    Por exemplo, esses comandos removem o processador em segundo plano do node1 e adicionam duas instâncias dele ao node2:
    
    `tsm topology set-process -n node1 -pr backgrounder -c 0`
    
    `tsm topology set-process -n node2 -pr backgrounder -c 2`
4. Aplique as alterações:
    
    `tsm pending-changes apply`

<!-- document id=25d70421bf49e3cd10c49806b8b5f19a7195a1e8fb1c5341d3a9c8707f919be8 url=/tableau/current/pt-br/server/email.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar notificação de evento do servidor

Um administrador do Tableau Services Manager (TSM) pode configurar o Tableau Server para permitir notificações para os seguintes eventos:

- Atualizações de conteúdo
    - Falhas na extração (habilitadas por padrão)
    - Exibições de assinatura para usuários (desabilitadas por padrão)
- Monitoramento do processos de servidor
    - Alterações do status de servidor (desabilitadas por padrão)
    - Relatórios de licença do Desktop (desabilitados por padrão)
- Espaço no driver
    - Enviar alertas por e-mail quando o espaço em disco ultrapassar ou permanecer abaixo dos limites pré-configurados (desabilitado por padrão)
    - Registro do histórico de uso (habilitado por padrão)

**Observação:** é preciso configurar o SMTP antes de configurar as assinaturas ou as notificações. Para obter mais informações, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

1. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`.
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique em Notificações na guia Configuração e clique em Eventos.
3. Configurar definições de notificação para sua empresa:
    
    - Atualizações de conteúdo
        - Enviar e-mail sobre falhas na atualização das extrações
            
            Quando essa opção estiver ativada (o padrão), um administrador do servidor pode configurar notificações de e-mail para serem enviadas quando as atualizações de extração falharem. Essas mensagens são configuradas no nível do site. Dessa forma, mesmo que essa opção esteja ativada, as mensagens não são enviadas a menos que a opção Enviar e-mail para os proprietários de fontes de dados e pastas de trabalho quando houver falha de atualização programada estiver habilitada para um site (ela é habilitada por padrão). Para obter detalhes, consulte [Habilitar o agendamento da atualização de extração e a notificação de falha](https://help.tableau.com/current/server/pt-br/schedule_enable.htm)
        - Permitir que os usuários recebam e-mail para exibições que eles assinaram
            
            Quando essa opção estiver habilitada (por padrão, ela fica desabilitada), um administrador do servidor pode configurar um site para enviar e-mails de assinatura. Essas mensagens por e-mail são configuradas no nível do site e só podem ser configuradas quando essa opção estiver habilitada. Para obter detalhes, consulte [Configurar um site para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm).
            
            Quando os usuários inscrevem-se em uma pasta de trabalho ou exibição, um instantâneo da exibição é enviado por e-mail para eles de forma agendada, para que possam ter acesso às atualizações mais recentes sem precisar fazer logon no Tableau Server.
            
            Para permitir que os usuários anexem renderizações de PDF a e-mails de assinatura, selecione Permitir que os usuários adicionem anexos a exibições assinadas.
    - Monitoramento do processos de servidor
        - Envie e-mails para eventos de processo do Tableau Server (para cima, para baixo e falha)
            
            O Tableau Server envia uma mensagem por e-mail quando o processador de dados, o armazenamento de arquivos, o gateway ou os processos do servidor de repositório param ou reiniciam, ou quando o nó inicial do Tableau Server para ou reinicia.
            
            Caso a instalação executada seja de servidor único (todos os processos no mesmo computador), os alertas de integridade só serão enviados quando o Tableau Server estiver ativo. Nenhum alerta "inativo" é enviado. Em uma instalação distribuída configurada para failover, receber um alerta de inoperância significa que ocorreu falha no repositório ativo ou em uma instância de processador de dados, e um alerta de atividade subsequente significa que a instância passiva (repositório) ou uma segunda instância (processador de dados) do processo assumiu o controle.
            
            **Observação:** o Tableau Server foi projetado para ser autocorretivo. Se um serviço ou processo parar de responder ou falhar, o Tableau Server tentará reiniciá-lo. Isso pode levar de 15 a 30 minutos para ser concluído. Por isso, reagir imediatamente a alertas de serviço ou processo pode ser contraproducente, especialmente em uma instalação com serviços redundantes que podem lidar com solicitações durante a reinicialização.
        - Ativar o Tableau Desktop para relatórios de licenciamento
            
            Os dados de relatórios de licenciamento são originados no Tableau Desktop e enviados para o Tableau Server. Quando essa opção estiver ativada, o Tableau Server irá gerar e exibir o relatório administrativo para relatórios de licença do Desktop. Para obter informações sobre o relatório, consulte [Uso da licença do Desktop](https://help.tableau.com/current/server/pt-br/adminview_desktop_license_usage.htm).
        - Espaço no driver
            
            Habilitar notificações (alertas) para o espaço em disco restante no Tableau Server.
            
            - Enviar e-mails quando o espaço de unidade não utilizado cai abaixo dos limites
                
                É possível configurar o Tableau Server para enviar notificações por e-mail quando a utilização do espaço em disco em qualquer nó ultrapassar um limite ou permanecer abaixo do limite. E você pode configurar a frequência com que as notificações de limite são enviadas.
                
                Há dois limites que você deve definir, limite de Limite de aviso e Limite crítico. Eles são expressos como percentil do espaço em disco restante. O limite crítico deve ser inferior ao limite de aviso.
                
                Você também especifica a opção Enviar alerta de limite a cada . Isso determina a frequência, em minutos, de envio de avisos notificações críticas. O valor padrão é 60 minutos.
            - Grave informações de uso de espaço em disco e violações de limite para uso em exibições administrativas personalizadas
                
                Ao configurar o Tableau Server para registrar o uso do espaço em disco, as informações sobre o espaço livre são salvas no repositório e é possível exibir o histórico de uso utilizando as Exibições administrativas.
4. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
5. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
6. Clique em Aplicar alterações e reiniciar.

Os vários valores de notificação descritos acima podem ser definidos individualmente com o comando [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet). Como alternativa, é possível construir um arquivo json e transmitir todos os valores de configuração em uma operação. Os métodos estão descritos nesta seção.

### Definir valores de notificação individualmente

A tabela a seguir mostra os pares chave/valor que mapeiam para os eventos de notificação descritos anteriormente neste tópico. Use o comando [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet) com a sintaxe a seguir para definir um único par chave/valor:

`tsm configuration set -k <config.key> -v <config_value>`

Por exemplo, para habilitar notificações de falhas de trabalho, execute o comando a seguir:

`tsm configuration set -k backgrounder.notifications_enabled -v true`

<table class="simple-table" style="width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 50%;"><col style="width: 25%;"></colgroup><tbody><tr><th>Opção de notificação</th><th>Chave</th><th>Valor</th></tr><tr><td>Falhas de extração ou de execução de fluxo</td><td><code>backgrounder.notifications_enabled</code></td><td><code>true</code> | <code>false</code></td></tr><tr><td>Habilitar exibições de assinatura para usuários</td><td><code>subscriptions.enabled</code></td><td><code>true</code> | <code>false</code></td></tr><tr><td>Habilitar anexos de PDF para assinaturas</td><td><code>subscriptions.attachments_enabled</code></td><td><code>true</code> | <code>false</code></td></tr><tr><td>Tamanho máximo do anexo (MB) para notificações de assinatura</td><td><code>subscriptions.max_attachment_size_megabytes</code></td><td>valor inteiro, o padrão é <code>150</code></td></tr><tr><td>Alterações do status de servidor</td><td><code>svcmonitor.notification.smtp.enabled</code></td><td><code>true</code> | <code>false</code></td></tr><tr><td>Relatórios de licença</td><td><code>features.DesktopReporting</code></td><td><code>true</code> | <code>false</code></td></tr><tr><td>Limites de espaço restante: habilitar notificações por e-mail</td><td><code>storage.monitoring.email_enabled</code></td><td><code>true</code> | <code>false</code></td></tr><tr><td>Limites de espaço restante: porcentagem de aviso</td><td><code>storage.monitoring.warning_percent</code></td><td>valor inteiro, por exemplo <code>20</code></td></tr><tr><td>Limites de espaço restante: porcentagem crítica</td><td><code>storage.monitoring.critical_percent</code></td><td>valor inteiro, por exemplo <code>15</code></td></tr><tr><td>Definir intervalo de e-mail</td><td><code>storage.monitoring.email_interval_min</code></td><td>valor inteiro, em minutos, por exemplo, <code>25</code></td></tr><tr><td>Registrar histórico de utilização</td><td><code>storage.monitoring.record_history_enabled</code></td><td><code>true</code> | <code>false</code></td></tr></tbody></table>

Após concluir a definição de valores, é necessário executar o comando a seguir:

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

### Definir todos os valores de notificação com um único arquivo json

Para criar todas as configurações de notificações com uma única configuração, passe um arquivo json:

Copie e edite o seguinte modelo para criar um arquivo para sua configuração.

{
  "configKeys": {
    "backgrounder.notifications\_enabled": true,
    "subscriptions.enabled": true,
    "subscriptions.attachments\_enabled": true,
    "subscriptions.max\_attachment\_size\_megabytes": 150,
    "svcmonitor.notification.smtp.enabled": true,
    "features.DesktopReporting": true,
    "storage.monitoring.email\_enabled": true,
    "storage.monitoring.warning\_percent": 20,
    "storage.monitoring.critical\_percent": 15,
    "storage.monitoring.email\_interval\_min": 25,
    "storage.monitoring.record\_history\_enabled": true
  }
}

Após salvar o arquivo, passe-o com o comando a seguir:

`[tsm settings import](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm#TSMSet) -f <path-to-file.json>`

Para aplicar alterações, execute o seguinte comando:

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

<!-- document id=20fcffba5d2481eba8e6311ac688e28dba3cc145e0e62328635208ed89fbaad1 url=/tableau/current/pt-br/server/web_author_who.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o acesso à edição na Web, salvamento e download do conteúdo

Se você está habilitando a funcionalidade de criação na Web no seu site, pode configurar mais precisamente quais usuários têm acesso ela. Ao usar as funções e regras de permissão do site no nível de conteúdo, é possível permitir ou negar os recursos Editar na Web, Salvar, ou Baixar nos projetos, pastas de trabalho e fontes de dados.

**Observação:** este documento enfatiza que o uso da expressão _Edição na Web_ é para especificar o nome do recurso nas regras de permissões, sendo que a expressão _criação na Web_ refere-se à funcionalidade geral de criação e modificação de pastas de trabalho no servidor. No entanto, você pode se deparar com essas duas expressões sendo usadas de modo intercambiável.

## Por que permitir que os usuários trabalhem diretamente no site

Como administrador, a ideia de permitir que as pessoas preencham um site com conteúdo, aparentemente de forma indiscriminada, pode ser encarada com ceticismo. No entanto, com alguns controles, é possível limitar até que ponto vai essa participação e ao mesmo tempo fornecer importantes benefícios que o gerenciamento de conteúdo centralizado pode pode oferecer a você e aos usuários.

### Prós e contras da criação na Web

Alguns dos benefícios da criação na Web para publicadores e usuários corporativos incluem:

- Equipes de analistas que trabalham em colaboração com uma locação central de onde fornecem input.
- A possibilidade de conexão com fontes de dados e criação de pastas de trabalho ainda que os usuários não possuam o Tableau Desktop.
- Acesso ao conteúdo mesmo que não estejam usando o computador com o Tableau Desktop ou VPN, seja em um computador ou em um dispositivo móvel.
- Isso pode fornecer uma estrutura que permite uma consistência entre relatórios do Tableau. (Ao tornar as pastas de trabalho modelo disponíveis no site, os analistas podem baixar ou criar novas pastas de trabalho com conexões de dados, marca e formatação já definidas.)

Para administradores, os benefícios podem incluir:

- Menos implantações do Tableau Desktop para gerenciar e suportar.
- Menor número de computadores dependentes de drivers de bancos de dados instalados.
- Capacidade de gerenciar conteúdo.
- Monitoramento mais preciso do que os usuários estão fazendo com o Tableau.

Algumas desvantagens da edição na Web incluem:

- Para analistas, a funcionalidade de edição não é tão ampla quanto no Tableau Desktop (ainda que continue a avançar em direção a essa paridade).
- Para administradores, ter mais pessoas trabalhando no servidor pode significar a necessidade de atualização dos sistemas.
- Sem publicar as orientações gerais, a proliferação de conteúdo no site é esperada.  
    Isso pode confundir aqueles que dependem dos painéis e fontes de dados publicados no Tableau, levar a uma queda no desempenho do servidor e da qualidade dos dados e até mesmo afetar a segurança dos dados.

## Gerenciamento de permissões para ajudar usuários a evitar a proliferação do conteúdo

Para ajudar os usuários a evitarem a proliferação do conteúdo no site, muitos administradores do Tableau usam os projetos para permitir vários níveis de acesso ao conteúdo. Por exemplo, um projeto pode ser configurado para permitir que todos os usuários editem e salvem pastas de trabalho, enquanto outro permite que apenas editores aprovados salvem novos conteúdos.

Para ter uma ideia melhor de como funciona, consulte os recursos a seguir:

- [Configurar projetos, grupos, conjuntos de grupos e permissões para o serviço de autoatendimento gerenciado](https://help.tableau.com/current/server/pt-br/projects_data_gov.htm)
- [Autoatendimento escalável](https://www.tableau.com/pt-br/learn/whitepapers/governed-self-service-analytics-scale "Veja um white paper que descreve o ambiente de um servidos de autoatendimento controlado"), um whitepaper do Tableau por Rupali Jain.  
    Para visualizar o PDF, talvez seja necessário fornecer suas credenciais do site do Tableau. São as mesmas credenciais utilizadas nos fóruns da comunidade ou para o envio de casos de suporte.

## Coordenar edição e salvar recursos com as funções de site para o nível de acesso apropriado

Para editar, salvar e baixar as pastas de trabalho os usuários devem ter uma função de site que permita tais ações com os recursos - definidos nas regras de permissão - que permitem ou negam acesso relacionado a edição.

### Acesso de função de site

- Quando as permissões apropriadas são definidas no nível do conteúdo, as funções de site Creator ou Explorer (Explorador - pode publicar) permitem os comandos Salvar (substituir) e Salvar como/Baixar.
    
    Observe que **Arquivo > Salvar** está disponível apenas para o proprietário da pasta de trabalho. Quando o recurso de permissão **Salvar** tiver sido concedido no nível do projeto e da pasta de trabalho, um usuário que não seja proprietário poderá substituir a pasta de trabalho existente na criação da Web ao selecionar **Arquivo > Salvar como** e usar o mesmo nome da pasta de trabalho. Isso substitui o conteúdo existente, ele se torna o proprietário e obtém acesso total ao conteúdo.
- A função de site do Explorer (Explorador) pode receber os recursos **Edição na Web** e **Salvar como/Download** , mas não poderá salvar (nem substituir as alterações existentes ou salvas em uma nova pasta de trabalho).

Para obter mais informações, consulte [Edição na Web e criação na Web](https://help.tableau.com/current/server/pt-br/permissions.htm#webauthor).

<!-- document id=eb3870cf38f1cca0c0629444fda3bb1d48d6c1f9b0ef5029581b5b0e78c5b07f url=/tableau/current/pt-br/server/config_oauth_redshift_iam.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o Amazon Redshift IAM OAuth

A partir do Tableau 2023.3.2, você pode usar o OAuth 2.0/OIDC para federar a identidade de um provedor de identidade externo para o Amazon Redshift.

Estas instruções são para o serviço IAM da AWS mais antigo. Para integração de IDC de IAM, consulte [Configurar o OAuth do Amazon Redshift IAM Identity Center](https://help.tableau.com/current/server/pt-br/config_oauth_redshift_iam_idc.htm).

Dependendo do fornecedor de identidade, existem diferentes passos necessários para configurar a integração. Esta é uma visão geral de alto nível. O Tableau não pode fornecer instruções detalhadas sobre como configurar a AWS ou o IDP, mas a abordagem geral é descrita abaixo.

## Etapa 1: configurar o IDP

1. Crie clientes OAuth no IDP para Tableau Desktop e Tableau Server ou Tableau Cloud. O cliente Desktop deve ativar `PKCE` e usar redirecionamentos de `http://localhost`.
2. Adicione declarações personalizadas de uso para autorização de funções. Em particular, se você estiver usando o IAM original, talvez queira adicionar declarações para `DbUser` e `DbGroups`. Eles podem ser usados posteriormente em suas políticas do IAM.
3. Crie o arquivo de configuração do Tableau OAuth. Veja a documentação em [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "Documentação OAuth no GitHub") e os exemplos [aqui](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "Exemplos de OAuth no GitHub."). Aceitamos exemplos para outros IDPs.
    
    1. Certifique-se de prefixar as IDs de configuração do Tableau OAuth com “`custom_`”.
        
        **Observação:** as IDs de configuração do OAuth têm um limite máximo de 36 caracteres. IDs maiores que isso podem não gerar erros, mas não funcionarão.
    2. Se o seu IDP suportar porta localhost dinâmica, desative `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`. Se o seu IDP não for compatível, certifique-se de adicionar várias URLs de retorno de chamada de host local à lista de permissões no arquivo de configuração e no IDP.
4. Instale os novos arquivos de configuração do Tableau OAuth na pasta `OAuthConfigs` associada a cada aplicativo em hosts de desktop (Tableau Desktop, Tableau Prep Builder, Tableau Bridge) e em cada site do Tableau Server e do Tableau Cloud que usará o OAuth.

## Configurar o IDP na AWS

1\. Crie o modelo IDP na AWS. Veja os documentos da Amazon [Federação de Identidade Web](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_oidc.html "Documentação da AWS sobre Federação de Identidade Web") e [Criar provedor de identidade OIDC](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html "Documentação da AWS sobre a criação do provedor de identidade OIDC").

2\. Criar funções e políticas específicas para o PDI. Confira [Criar função para OIDC](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html "Documentação da AWS para criação de funções para OIDC") nos documentos da AWS.

## Configurar funções para usuários do Redshift

Anexe as políticas necessárias para o Redshift. Você pode usar declarações personalizadas no token autorizar funções. Existem vários exemplos com SAML [na documentação da AWS](https://docs.aws.amazon.com/redshift/latest/mgmt/options-for-providing-iam-credentials.html "Documentação da AWS para fornecer credenciais IAM"). Eles podem ser facilmente adaptados ao OAuth. No caso do OAuth, as reivindicações são apenas “`DbUser`”, “`DbGroups`” etc.

Aqui está um exemplo da política da documentação da AWS:

{  
"Version": "2012-10-17",  
"Statement": \[  
    {  
        "Effect": "Allow",  
        "Action": "redshift:GetClusterCredentials",  
        "Resource": \[  
            "arn:aws:redshift:us-west-1:123456789012:dbname:cluster-identifier/dev",  
            "arn:aws:redshift:us-west-1:123456789012:dbuser:cluster-identifier/${redshift:DbUser}",  
            "arn:aws:redshift:us-west-1:123456789012:cluster:cluster-identifier"  
        \],  
        "Condition": {  
            "StringEquals": {  
                "aws:userid": "AROAJ2UCCR6DPCEXAMPLE:${redshift:DbUser}@example.com"  
            }  
        }  
    },  
    {  
        "Effect": "Allow"  
        "Action": "redshift:CreateClusterUser",  
        "Resource": "arn:aws:redshift:us-west-1:12345:dbuser:cluster-identifier/${redshift:DbUser}"  
    },  
    {  
        "Effect": "Allow",  
        "Action": "redshift:JoinGroup",  
        "Resource": "arn:aws:redshift:us-west-1:12345:dbgroup:cluster-identifier/my\_dbgroup"  
    },  
    {  
        "Effect": "Allow",  
        "Action": \[  
            "redshift:DescribeClusters",  
            "iam:ListRoles"  
        \],  
        "Resource": "\*"  
    }  
\]  
}

## Conectar-se ao Redshift

O usuário deve especificar a função ARN a ser assumida e, em, selecionar a configuração do OAuth instalada anteriormente.

![](/tableau/current/pt-br/server/pt-br/Img/redshift_oauth__iam_connect.png)

Quando configurado corretamente, o usuário é redirecionado ao IDP para autenticar e autorizar tokens para o Tableau. O Tableau receberá tokens openid e de atualização. A AWS é capaz de validar o token e a assinatura do IDP, extrair o declarações do token, pesquisar o mapeamento do usuário para a função IAM e permitir ou bloquear o Tableau de assumir a função em nome do usuário. (em outras palavras, [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html "Documentação da AWS para AssumeRoleWithWebIdentity")).

## Tokens

Por padrão, o Redshift OAuth IAM passa o token de ID para o driver. Para clientes locais, incluindo aqueles que usam o Tableau Bridge, você pode usar um arquivo TDC para transmitir o token de acesso.

<connection-customization class='redshift' enabled='true' version='10.0'>
	<vendor name='redshift' />
	<driver name='redshift' />
	<customizations>
		<customization name='CAP\_OAUTH\_FEDERATE\_ACCESS\_TOKEN' value='yes'/>
	</customizations>
</connection-customization>
		

Para obter mais informações sobre como configurar e instalar arquivos .tdc, consulte [Personalizar e ajustar uma conexão](https://help.tableau.com/current/pro/desktop/pt-br/connect_customize.htm) e [Usar um arquivo .tdc com o Tableau Server](https://help.salesforce.com/s/articleView?id=001458291&type=1).

## Sobre a Federação de grupo

Ao usar a autenticação OAuth com uma função do IAM, você pode selecionar se deseja ou não usar a Federação de Grupo. Isso mudará a forma como o conector interage com a API de autenticação para interagir com o Redshift.

- Quando a caixa de Federeção de grupo (disponível nas versões 2025.1 e posteriores) estiver marcada durante a conexão, o driver Redshift usará a API [`getClusterCredentialsWithIAM`](https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentialsWithIAM.html) para obter credenciais em clusters provisionados.
- Quando a caixa Federação de grupo não estiver marcada, a API [`getClusterCredentials`](https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentials.html) será usada em seu lugar.

Essas duas APIs retornarão tokens IAM com propriedades ligeiramente diferentes. Para obter mais informações, consulte a documentação da API da AWS vinculada acima e [opções do driver ODBC](https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-configuration-options.html "Informações sobre como configurar o ODBC 2.0 com AWS").

#### Notas de uso

- Para Tableau Desktop e Tableau Prep Builder antes da versão 2024.3, isso pode ser definido no campo de configuração avançada do driver usando 'group\_federation=1'. Ele também pode ser configurado usando um arquivo TDC para definir propriedades de conexão personalizadas. Para obter mais informações sobre o uso do TDC, consulte [Personalização e ajuste das conexões](https://help.tableau.com/current/pro/desktop/pt-br/connect_customize.htm).
- A partir da versão 2024.3, há um campo group\_federation na caixa de diálogo de conexão para o ambiente local (Tableau Desktop, Tableau Prep Builder e Tableau Server). Isso estará disponível no Tableau Cloud a partir de 2025.1 (disponível em fevereiro de 2025).
- Para usar a Federação de grupo com o Tableau Server, group\_federation deve ser adicionado à lista de permissões de extras do ODBC. Para obter mais informações, consulte [Personalizar cadeia de caracteres de conexão para conectores nativos](https://help.tableau.com/current/pro/desktop/pt-br/connect_string_custom.htm).

## Okta

Se estiver usando o Okta, é melhor usar um “servidor de autorização personalizado” em vez do “servidor de autorização organizacional”. Os servidores de autorização personalizados são mais flexíveis. Existe um servidor de autorização personalizado criado por padrão, chamado “default”. A URL de autorização deve ter esta aparência:

https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize

![](/tableau/current/pt-br/server/pt-br/Img/redshift_oauth_iam_okta_800x332.png)

## Atualizar driver

Para Redshift OAuth usando o serviço IAM original, você pode usar:

- Driver Redshift ODBC v1 começando com a versão 1.59, que pode ser baixado em [https://docs.aws.amazon.com/redshift/latest/mgmt/configure-odbc-connection.html](https://docs.aws.amazon.com/redshift/latest/mgmt/configure-odbc-connection.html "Baixe o driver Redshift ODBC V1 da Amazon").
- Driver Redshift ODBC v2 começando com a versão 2.0.1.0, que pode ser baixado em [https://github.com/aws/amazon-redshift-odbc-driver/tags](https://github.com/aws/amazon-redshift-odbc-driver/tags "Baixe o driver Redshift ODBC V2 da Amazon"). Observe que não há driver v2 para OSX.

## Solução de problemas

A melhor maneira de diagnosticar erros é remover o Tableau da imagem. Em vez disso, você pode testar usando o gerenciador de drivers ou uma ferramenta semelhante. Isso é apenas para solução de problemas - você não deve usar um DSN ou o conector “Outro ODBC” para uso regular deste recurso. Para ajudar a garantir um teste válido, os parâmetros devem ser os mesmos mostrados abaixo, exceto pelas informações do cluster, banco de dados, token e namespace.

**Observação:** não especifique DbUser ou DbGroups na cadeia de conexão do DSN ao testar, pois Tableau não tem acesso a eles e não pode incluí-los na cadeia de conexão. Você pode incluí-lo nas declarações de token.

Se você vir uma mensagem de erro sobre token inválido/expirado vindo do driver na primeira conexão (ele terá um código de erro SQLState como \[28000\] ou \[08001\] na mensagem de erro), o Tableau concluiu com êxito o fluxo OAuth e falhou no driver. Isso significa que há uma configuração incorreta no lado da AWS ou no lado do IDP. Também pode haver erros de permissão ou autorização retornados pelo driver, o que também está fora do controle do Tableau.

Antes de começar a testar, primeiro você precisa obter um token de acesso (o padrão para IAM IDC) ou um token de acesso (se personalizado) para enviar ao driver.

Aqui está um exemplo com Okta. Quase todos os IDPs internos têm uma maneira de fazer isso que é bastante semelhante. Observe que para usar esse fluxo você precisa ter habilitado o tipo de concessão de senha do proprietário do recurso. Substitua a URL do IDP, o segredo do cliente, a ID do cliente, o nome de usuário e a senha.

curl -X POST "https://OKTA\_URL/v1/token" \\  
\-H 'accept: application/json' \\  
\-H "Authorization: Basic $(echo -n 'CLIENTID:CLIENTSECRET' | base64)" \\  
\-H "Content-Type: application/x-www-form-urlencoded" \\  
\-d "grant\_type=password&username=USER&password=PASSWORD&scope=openid"

Depois de obter o token, você pode usar um DSN para testar. Para Windows, pode usar o gerenciador de driver ODBC. No Mac, você pode usar a interface do gerenciador de driver iODBC. No Linux, você pode usar a ferramenta de linha de comando isql incluída no Tableau Server na pasta “customer-bin”.

Os plug-ins que usam um perfil de AWS fixo não funcionarão, a menos que você queira usar o mesmo perfil para todos os usuários para essa conexão. Os outros plugins OAuth requerem acesso direto ao navegador do sistema, o que não funciona no lado do servidor.

Abaixo está um exemplo de uso do gerenciador de driver ODBC no Windows.

![](/tableau/current/pt-br/server/pt-br/Img/redshift_oauth_iam_troubleshoot.jpg)

<!-- document id=6e9834d20f7c9c435cd68ae15ef70193cc60ec1cbbd6b344b3c0c7ccfff13af4 url=/tableau/current/pt-br/server/teams_set_up.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o aplicativo Tableau para Microsoft 365

O aplicativo Tableau para Microsoft 365 permite que seus usuários visualizem e compreendam seus dados sem interromper o fluxo de trabalho.Com o aplicativo Teams, seus usuários podem interagir com exibições (visualizações) e métricas do Tableau e receber resumos e alertas do Tableau Pulse para as métricas que seguem.Com os suplementos do Word e do PowerPoint, os usuários podem adicionar instantâneos de imagens de exibições e métricas a seus documentos e slides e atualizar esses instantâneos.

Como administrador do Tableau, você instala e configura o aplicativo para conectar seu site do Tableau existente à sua implantação do Microsoft 365.Você pode instalar o aplicativo para o Tableau Cloud diretamente do marketplace de aplicativos da Microsoft.Para instalar o aplicativo para o Tableau Server, você deve baixá-lo e fazer o carregamento lateral.

Para obter informações sobre como usar o aplicativo Tableau para Microsoft 365, consulte [Acessar o conteúdo do Tableau no Microsoft 365](https://help.tableau.com/current/server/pt-br/teams_explore.htm).Este artigo trata da configuração do aplicativo.

Observação: se você tiver definido o idioma no Tableau ou no Microsoft 365 para um idioma com suporte para Tableau diferente do inglês (EUA), você poderá ver texto em inglês que não está localizado.

## Consulte também

- [Perguntas frequentes sobre o aplicativo Tableau no GitHub](https://github.com/tableau/tableau-app-msft-teams)
- [Notas de versão no GitHub](https://github.com/tableau/tableau-app-msft-teams/blob/main/ReleaseNotes.md)
- [Tutorial de primeiros passos no YouTube](https://www.youtube.com/watch?v=nsa123RgCO0)

## Pré-requisitos

Para configurar o aplicativo Tableau para Microsoft 365, você precisa dos aplicativos, contas e configurações a seguir.

- Tableau Cloud ou Tableau Server versão 2023.1 ou posterior
- Uma conta de administrador de site para o Tableau Cloud ou uma conta de administrador de servidor para o Tableau Server
- Uma assinatura do Microsoft 365 para empresas
- Microsoft Teams, Word e PowerPoint
- Uma conta de administrador do Microsoft 365
- Licenças de usuário para o Tableau e o Microsoft 365 que são mapeadas entre si com base em um dos atributos de mapeamento de usuário
- Intervalos `4.152.0.0/15` de endereços IP e `20.2.0.0/16` adicionados à sua lista de permissões (somente se a filtragem de IP estiver habilitada no seu site do Tableau Cloud)

### Atributos de mapeamento de usuário

Para permitir o logon único com o Tableau, mapeie as contas de usuário no Microsoft 365 para as contas de usuário no Tableau.Você pode configurar esse mapeamento usando atributos do SDK do Microsoft Teams ou do perfil do Microsoft Entra de um usuário.

#### Atributos do SDK do Microsoft Teams

| Atributo | Descrição |
| --- | --- |
| [Preferred\_Username](https://learn.microsoft.com/pt-br/microsoftteams/platform/tabs/how-to/authentication/tab-sso-code#:~:text=user%27s%20display%20name.-,preferred_username,-%3A%20The%20app%20user%27s) | O endereço de e-mail do usuário do Microsoft Teams.Em alguns casos, esse valor difere do e-mail definido no Microsoft Entra. |
| [User Principal Name](https://learn.microsoft.com/pt-br/entra/identity/hybrid/connect/plan-connect-userprincipalname#what-is-userprincipalname) | A principal forma como os usuários fazem logon no Microsoft Entra. |

#### Atributos de perfil do Microsoft Entra

| Atributo | Descrição |
| --- | --- |
| [Primary Email](https://learn.microsoft.com/pt-br/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mail,-String) | Corresponde ao atributo `user.mail` e representa o endereço de e-mail do usuário. |
| [Mail Nickname](https://learn.microsoft.com/pt-br/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mailNickname,-String) | Corresponde ao atributo `user.mailNickname` e representa um alias do usuário. |
| [Employee ID](https://learn.microsoft.com/pt-br/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=a%20user.-,employeeId,-String) | Corresponde ao atributo `user.employeeId` e representa um identificador de funcionário atribuído pela organização. |
| [On-Premise Distinguished Name](https://learn.microsoft.com/pt-br/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesDistinguishedName,-String) | Corresponde ao atributo `user.onPremiseDistinguishedName` e representa o nome diferenciado (DN) sincronizado de um Active Directory local. |
| [On-Premise User Principal Name](https://learn.microsoft.com/pt-br/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesUserPrincipalName,-String) | Corresponde ao atributo `user.onPremiseUserPrincipalName` e representa o userPrincipalName sincronizado de um Active Directory local. |
| [On-premise SAM Account Name](https://learn.microsoft.com/pt-br/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%2C%20le\).-,onPremisesSamAccountName,-String) | Corresponde ao atributo `user.onPremiseSamAccountName` e representa o samAccountName sincronizado de um Active Directory local. |
| [Extension Attribute X](https://learn.microsoft.com/pt-br/graph/extensibility-overview?tabs=http) | O Microsoft Entra permite adicionar até 15 atributos extras ao perfil do Entra de um usuário.Se o nome de usuário do Tableau não existir no Microsoft Entra, use um atributo de extensão para armazenar o nome de usuário do Tableau para cada usuário do Entra. |

### Pré-requisitos adicionais do Tableau Server

O aplicativo Tableau usa chamadas de API para se comunicar com o Tableau Server e incorporar conteúdo interativo.Essas chamadas devem acessar o Tableau Server.

- Se o Tableau Server estiver protegido por um firewall, permita solicitações HTTP de entrada dos intervalos de IP 4.152.0.0/15 e 20.2.0.0/16.
- Certifique-se de que os usuários possam acessar o Tableau Server da mesma forma que acessam o Microsoft 365.
    - Se os usuários precisarem de uma VPN para acessar o Microsoft 365, o Tableau Server deverá estar acessível na mesma VPN.
    - Se os usuários conseguirem acessar o Microsoft 365 na Internet pública, o Tableau Server deverá estar acessível na Internet pública.
    - Se os usuários conseguirem acessar o Microsoft 365 por meio de aplicativos móveis, o Tableau Server deverá estar acessível em dispositivos móveis.

## Instalar o aplicativo para o Tableau Server

Para instalar o aplicativo para o Tableau Server, primeiro edite o manifesto do aplicativo para personalizar o nome do host.Em seguida, você pode optar por instalar o aplicativo Microsoft Teams, os suplementos do Word e do PowerPoint ou ambos.Para instalar o aplicativo para o Tableau Cloud, consulte o [guia de configuração do Tableau Cloud](https://help.tableau.com/current/online/pt-br/teams_set_up.htm).

### Baixar e editar o manifesto do aplicativo

1. No GitHub, [baixe o manifesto do aplicativo](https://github.com/tableau/tableau-app-msft-teams/raw/main/appManifest/tableau-app-for-teams-server.zip).
2. Extraia os arquivos do arquivo de manifesto `tableau-server-app-for-teams.zip`.
3. Abra o arquivo `manifest.json` em um editor de texto.
4. Procure `manifest.json` para `*.online.tableau.com` e substitua esse domínio pelo nome do host do seu ambiente do Tableau Server.Se a URL do seu Tableau Server for `https://analytics.company.com`, o nome do host será `analytics.company.com`.
5. Salve as alterações em `manifest.json`.
6. Compacte os arquivos na pasta `tableau-app-for-teams-server` para criar um arquivo zip que inclua suas alterações.

### Implantar o aplicativo Teams

#### Carregar o manifesto do aplicativo para o Microsoft Teams

As políticas de aplicativos da sua organização determinam se você pode instalar os aplicativos do Microsoft Teams.Pode ser necessária uma conta de administrador do Microsoft 365 para instalar aplicativos.

1. Abra o [centro de administração d Microsoft Teams](https://admin.teams.microsoft.com).
2. No painel de navegação, selecione Aplicativos do Teams > Gerenciar aplicativos.
3. Selecione Ações > Carregar novo aplicativo.
4. Carregue o arquivo `tableau-server-app-for-teams.zip` que você editou.Você receberá uma mensagem de confirmação com um link para gerenciar o aplicativo.

#### Instalar e fixar o aplicativo para seus usuários

Você pode instalar o aplicativo para disponibilizá-lo a todos ou a um subconjunto de seus usuários.Também é possível fixar o aplicativo para que ele apareça na barra de aplicativos para seus usuários.

1. Abra o [centro de administração d Microsoft Teams](https://admin.teams.microsoft.com).
2. No painel de navegação, selecione Aplicativos do Teams > Políticas de configuração.
3. Em Aplicativos instalados, selecione Adicionar aplicativos e adicione o aplicativo Tableau.
4. Opcionalmente, em Aplicativos fixados, selecione Adicionar aplicativos e adicione o aplicativo Tableau.
5. Salve as alterações.

Depois de adicionar o aplicativo Tableau, pode levar até 24 horas para que ele fique disponível para seus usuários.

### Instalar os suplementos do Word e do PowerPoint

A instalação do aplicativo para o Microsoft Teams não instala os suplementos do Word e do PowerPoint.Instale os suplementos separadamente no centro de administração do Microsoft 365.

1. Abra o [centro de administração d Microsoft 365](https://admin.cloud.microsoft.com).
2. No painel de navegação, selecione Agentes > Todos os agentes.
3. Selecione Carregar agente personalizado.
4. Carregue o arquivo `tableau-server-app-for-teams.zip` que você editou.
5. Escolha se deseja publicar o aplicativo para todos os usuários ou usuários específicos e se deseja pré-instalar o aplicativo.
6. Aceite as permissões.
7. Revise e conclua a implantação.

Depois de você concluir a implantação, pode levar até 72 horas para que o suplemento fique disponível para seus usuários.

## Configurar o aplicativo Tableau

Após instalar o aplicativo Tableau, o Microsoft Teams solicitará que você configure o aplicativo.Configure as informações do seu site para conectar o aplicativo ao seu site do Tableau.

### 1.Criar um aplicativo conectado

O aplicativo Tableau para Microsoft 365 usa um aplicativo conectado para autenticar usuários com logon único.Crie esse aplicativo conectado no Tableau Cloud ou Tableau Server.

1. No Tableau Cloud ou Tableau Server, crie um aplicativo conectado com confiança direta.Para obter mais informações, consulte [Configurar aplicativos conectados com confiança direta para Tableau Cloud](https://help.tableau.com/current/online/pt-br/connected_apps_direct.htm) ou [Configurar aplicativos conectados com confiança direta para Tableau Server](https://help.tableau.com/current/server/pt-br/connected_apps_direct.htm#create-a-connected-app).
    
    - Se você limitar a lista de permissões de domínio para o aplicativo conectado apenas a domínios específicos, adicione os seguintes domínios à lista de permissões.
        - `tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net`
        - `teams.microsoft.com`
        - `*.teams.microsoft.com`
    - Se os seus usuários acessarem o aplicativo de outras plataformas da Microsoft, adicione domínios adicionais da lista de [URLs do Microsoft 365](https://learn.microsoft.com/pt-br/microsoft-365/enterprise/urls-and-ip-address-ranges?view=o365-worldwide).
2. Habilite o aplicativo conectado.
3. Gere um segredo de aplicativo conectado.
4. Copie a ID do cliente do aplicativo conectado, a ID do segredo e o valor do segredo.Salve esses valores.Você precisa deles para configurar seu site do Tableau no Microsoft 365.

### 2.Adicionar a configuração do site ao aplicativo Tableau

Ao abrir o aplicativo Tableau no Microsoft Teams, se você ainda não tiver configurado o aplicativo, será exibida uma tela de configuração.Para acessar as opções de configuração do site no Word e no PowerPoint, selecione o botão Configurações na parte inferior do painel do suplemento.

1. No Rótulo, nomeie o site.Esse nome aparece para os usuários do aplicativo Microsoft 365.Se você não inserir um rótulo, o aplicativo exibirá o nome do site.Este campo é opcional.
2. No Nome do site do Tableau, insira o nome conforme aparece na URL do site.Por exemplo, para a URL `https://us-west-2b.online.tableau.com/#/site/mysitename/home`, você insere `mysitename`.Se você estiver conectando o aplicativo ao Tableau Server e quiser usar o site padrão, deixe este campo em branco.
3. Na URL base, insira a parte da URL do site que termina com `tableau.com`, por exemplo, `https://us-west-2b.online.tableau.com`.
4. No Atributos de mapeamento de usuário, selecione o atributo do Microsoft Entra usado para autenticar o usuário com logon único.
5. Na ID de aplicativo conectado, ID de segredo de aplicativo conectado e Valor de segredo de aplicativo conectado, cole os valores que você copiou quando criou o aplicativo conectado.
6. Selecione Adicionar configuração de site.

O aplicativo Tableau testa a conexão antes de salvar os detalhes da configuração.A configuração do site não será adicionada se o aplicativo não conseguir se conectar ao Tableau.Essa falha pode ocorrer porque o aplicativo conectado não consegue se autenticar, o aplicativo conectado não está habilitado, as informações do site estão incorretas ou porque a conta que você está usando não é uma conta de administrador do Tableau.Isso também pode significar que o aplicativo não consegue acessar o Tableau Server porque está atrás de um firewall.

## Adicionar ou excluir configurações de site

Depois de adicionar uma configuração de site, você pode adicionar sites adicionais ou excluir uma configuração de site existente.

1. No aplicativo Tableau para Microsoft Teams, selecione a guia Configuração.Ou, no painel do suplemento do Word ou PowerPoint, selecione o botão **Configurações**.
2. Em Configuração, selecione a guia Configuração de site do Tableau.
3. Para adicionar um site, selecione Adicionar detalhes do site.Para remover um site, selecione o ícone Excluir desse site.Para que essas opções apareçam, é necessário ser um administrador de site no site do Tableau ao qual você está conectado no momento.

<!-- document id=4e6446ee5d859b5fc83efe37130758780f553c7209b7e5ee1fd89a5dc7191656 url=/tableau/current/pt-br/server/config_oauth_azure_ad.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o Azure AD para Autenticação Moderna e OAuth

Os conectores Azure Synapse, Azure SQL Database, Azure Databricks, Azure Data Lake Gen2, OneDrive and SharePoint Online e Listas do SharePoint (JDBC) oferecem suporte à autenticação por meio do Azure AD configurando um cliente OAuth para o Tableau Server.

**Observação**: tokens de atualização de uso único (às vezes chamados de tokens de atualização contínua ou rotação de tokens de atualização) não são suportados para conexões OAuth do Azure/Entra ID com o Tableau no momento. O suporte para esses tokens está planejado para uma versão futura.

**Observação**: o suporte ao Azure AD só é aceito com o driver Microsoft [SQLServer 17.3](https://docs.microsoft.com/pt-br/sql/connect/odbc/using-azure-active-directory?view=sql-server-ver15)e posterior.

## Etapa 1: registrar o cliente OAuth para Azure

Siga as etapas abaixo para registrar e configurar um aplicativo OAuth para o Azure em um locatário específico do Azure.

1. Entre no [portal do Azure](https://portal.azure.com/).
2. Se você tiver acesso a vários locatários, selecione o locatário no qual deseja registrar um aplicativo.
3. Pesquise e selecione **Azure Active Directory**.
4. Em **Gerenciar**, selecione **Registros de aplicativos** e **Novo registro**.
5. Insira “Tableau Server OAuth” ou um valor semelhante como o **Nome**.
6. No campo **Tipos de conta com suporte** na página de registro do aplicativo, selecione quem pode usar este aplicativo.

**Observação**: se você quiser usar a ID do cliente e o Valor de segredo do cliente do seu aplicativo para contas em a diferentes locatários, certifique-se de escolher a segunda opção (Multilocatário).

8. No campo (opcional) **Redirecionar Uri**, escolha **Web** e, em seguida, insira o endereço de Internet do seu servidor anexado pela cadeia de caracteres, `/auth/add_oauth_token`.

Por exemplo: `https://your_server_url.com/auth/add_oauth_token`

10. Selecione **Registrar**. Após a conclusão do registro, o portal do Azure exibe o painel Visão geral do registro do aplicativo, que inclui a ID do aplicativo (cliente). Também conhecido como _ID do cliente_, esse valor identifica exclusivamente seu aplicativo na plataforma de identidade da Microsoft.
11. Copie a ID, ela será usado como o campo`[your_client_id]` nas etapas a seguir.
12. Selecione **Certificados e segredos** na barra à esquerda e escolha **Novo segredo do cliente**.
13. Adicione a descrição da segredo.
14. Selecione **Tempo de vida do segredo do cliente.**
15. Escolha **Adicionar** e copie o valor do segredo. O segredo será usado como`[your_client_secret_value]` nas etapas a seguir.
16. Selecione **permissões de API** na barra esquerda.
17. Escolha **Adicionar permissões**.
18. Selecione Microsoft Graph..
19. Escolha Permissões delegadas.
20. Em Selecionar permissões, selecione todas as permissões OpenId (email, offline\_access, openid, e perfil).
21. Escolha Adicionar permissões.
22. Adicionar permissões. Siga as etapas abaixo para os conectores que você está habilitando:
    - Banco de dados SQL do Azure
        1. Clique em Adicionar uma permissão.
        2. Selecione Minhas APIs.
        3. Clique em Banco de Dados SQL do Azure e, em seguida , Permissões delegadas.
        4. Selecione user\_impersonation e clique em Adicionar permissões.
    - OneDrive e SharePoint Online
    
    1. Clique em Adicionar uma permissão.
    2. Selecione Microsoft Graph..
    3. Clique em Permissões delegadas.
    4. Sob Selecionar permissões, na caixa de pesquisa de filtro, insira e adicione as seguintes permissões:
    
    - Files.Read.All
    - Sites.Read.All
    - User.Read
    
    - Listas do SharePoint (JDBC)
    
    1. Clique em Adicionar uma permissão.
    2. Selecione Microsoft Graph..
    3. Clique em Permissões delegadas.
    4. Sob Selecionar permissões, na caixa de pesquisa do filtro, insira e adicione a permissão User.Read.
    5. Clique em Adicionar uma permissão de novo.
    6. Selecione SharePoint.
    7. Clique em Permissões delegadas.
    8. Expanda a seção AllSites e, em seguida, selecione e adicione a permissão AllSites.Manage.

## Etapa 2: configurar o Tableau Server para Azure

Configurar o Tableau Server requer a execução de um comando do Tableau Server Manager (TSM). O Azure Data Lake Storage Gen2 requer um conjunto diferente de comandos do que o comando comum que é executado para o Azure Synapse, Banco de dados SQL do Azure ou Databricks.

### Configure o cliente OAuth padrão para Azure Data Lake Storage Gen2

Para configurar o Tableau Server para Data Lake Storage Gen2, você deve ter os seguintes parâmetros de configuração:

- **ID do cliente Azure OAuth:** a ID do cliente é gerada com base no procedimento na Etapa 1. Copie este valor para `[your_client_id]` no primeiro comando tsm.
- **Valor do segredo do cliente Azure OAuth:** o valor do segredo do cliente é gerado com base no procedimento na Etapa 1. Copie este valor para `[your_client_secret_value]` no segundo comando tsm.
- **URL do Tableau Server**: insira a URL do Tableau Server, como `https://myco.com`. Copie este valor para `[your_server_url]` no terceiro comando tsm.

Execute os seguintes comandos tsm para configurar o Tableau Server OAuth para Azure Data Lake Storage Gen2:

- `tsm configuration set -k oauth.azuredatalake_storage_gen2.client_id -v [your_client_id] --force-keys`
- `tsm configuration set -k oauth.azuredatalake_storage_gen2.client_secret -v [your_client_secret_value] --force-keys`
- `tsm configuration set -k oauth.azuredatalake_storage_gen2.redirect_uri -v [your_server_url]/auth/add_oauth_token --force-keys`
- `tsm pending-changes apply`

### Configurar o cliente padrão para Azure Synapse, Banco de dados SQL do Azure ou Azure Databricks

Para configurar o Tableau Server, você deve ter os seguintes parâmetros de configuração:

- **ID do cliente Azure OAuth:** gerada com base no procedimento na Etapa 1. Copie este valor para `[your_client_id]` no comando tsm.
- **Valor do segredo do Azure OAuthClient:** gerado com base no procedimento na Etapa 1. Copie este valor para `[your_client_secret_value]` no segundo comando tsm.
- **URL do Tableau Server:** essa é a URL do Tableau Server, como `https://myco.com`.
- **ID de configuração:**esse é o valor para o parâmetro `oauth.config.id` no comando tsm que se segue. Valores válidos:
    - Azure Synapse: `azure_sql_dw`
    - Banco de dados SQL do Azure: `azure_sqldb`
    - Databricks: `databricks`

Execute os seguintes comandos tsm para configurar o Azure AD para Azure Synapse, Banco de dados SQL do Azure ou Databricks. Por exemplo, para configurar o Azure Synapse:

`tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys`

`tsm pending-changes apply`

### Configurar um cliente OAuth padrão para OneDrive e SharePoint Online

Para configurar o Tableau Server para OneDrive e SharePoint Online, você deve ter os seguintes parâmetros de configuração:

- **ID do cliente Azure OAuth:** a ID do cliente é gerada com base no procedimento na Etapa 1. Copie este valor para \[your\_client\_id\] no primeiro comando tsm.
- **Valor do segredo do cliente Azure OAuth:** o valor do segredo do cliente é gerado com base no procedimento na Etapa 1. Copie este valor para \[your\_client\_secret\_value\] no segundo comando tsm.
- **URL do Tableau Server:** essa é a URL do Tableau Server, como `https://myco.com`. Copie este valor para \[your\_server\_url\] no terceiro comando tsm.

Execute os seguintes comandos tsm para configurar o Tableau Server OAuth para OneDrive e SharePoint Online:

- `tsm configuration set -k oauth.onedrive_and_sharepoint_online.client_id -v [your_client_id] --force-keys`
- `tsm configuration set -k oauth.onedrive_and_sharepoint_online.client_secret -v [your_client_secret_value] --force-keys`
- `tsm configuration set -k oauth.onedrive_and_sharepoint_online.redirect_uri -v [your_server_url]/auth/add_oauth_token --force-keys`
- `tsm pending-changes apply`

### Configurar um cliente OAuth padrão para Listas do SharePoint (JDBC)

Para configurar o Tableau Server para Listas do SharePoint (JDBC), você deve ter os seguintes parâmetros de configuração:

- **ID do cliente Azure OAuth:** a ID do cliente é gerada com base no procedimento na Etapa 1. Copie este valor para \[your\_client\_id\] no primeiro comando tsm.
- **Valor do segredo do cliente Azure OAuth:** o valor do segredo do cliente é gerado com base no procedimento na Etapa 1. Copie este valor para \[your\_client\_secret\_value\] no primeiro comando tsm.
- **URL do Tableau Server:** essa é a URL do Tableau Server, como `https://myco.com`. Copie este valor para \[your\_server\_url\] no primeiro comando tsm.

Execute os seguintes comandos tsm para configurar as Listas do SharePoint (JDBC) da Oauth do Tableau Server:

- `tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"cdata_sharepoint\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys`
- `tsm pending-changes apply`

### Configurar um cliente OAuth padrão para OneDrive (obsoleto)

Para configurar o Tableau Server para OneDrive (obsoleto), você deve ter os seguintes parâmetros de configuração:

- **ID do cliente Azure OAuth:** a ID do cliente é gerada com base no procedimento na Etapa 1. Copie este valor para \[your\_client\_id\] no primeiro comando tsm.
- **Valor do segredo do cliente Azure OAuth:** o valor do segredo do cliente é gerado com base no procedimento na Etapa 1. Copie este valor para \[your\_client\_secret\_value\] no segundo comando tsm.
- **URL do Tableau Server:** essa é a URL do Tableau Server, como `https://myco.com`. Copie este valor para \[your\_server\_url\] no terceiro comando tsm.

Para continuar, execute os seguintes comandos tsm para configurar o Tableau Server OAuth para OneDrive (obsoleto):

- `tsm configuration set -k oauth.onedrive.client_id -v [your_client_id] --force-keys`
- `tsm configuration set -k oauth.onedrive.client_secret -v [your_client_secret_value] --force-keys`
- `tsm configuration set -k oauth.onedrive.redirect_uri -v [your_server_url]/auth/add_oauth_token --force-keys`
- `tsm pending-changes apply`

### Cenários de reinicialização do servidor

Depois de configurar um cliente OAuth padrão, os cenários a seguir podem ocorrer.

- Um prompt de reinicialização será exibido se as alterações pendentes exigirem a reinicialização do servidor.
- Cancele o prompt com a opção `--ignore-prompt`, mas isso não interrompe a 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).

### Configuração de vários conectores

Se você tiver vários conectores para definir, deverá incluir todos eles em um único comando. Por exemplo:

`tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"databricks\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys`

`tsm pending-changes apply`

## Configurar Oauth personalizado para um site

Você pode configurar clientes personalizados do Azure Data Lake Storage Gen2, Azure Synapse, Azure SQL Database, Databricks OAuth, OneDrive e Sharepoint online e listas de Sharepoint (JDBC) para um site.

Considere configurar um cliente OAuth personalizado para 1) substituir um cliente OAuth se configurado para o servidor ou 2) ativar o suporte para conexão segura a dados que requerem clientes OAuth exclusivos.

Quando um cliente OAuth personalizado é configurado, a configuração no nível do site tem precedência sobre qualquer configuração do lado do servidor, e todas as novas credenciais OAuth criadas usam o cliente OAuth no nível do site por padrão. Nenhuma reinicialização do Tableau Server é necessária para que as configurações tenham efeito.

**Importante:** as credenciais OAuth existentes estabelecidas antes da configuração do cliente OAuth personalizado podem ser usadas temporariamente, mas tanto os administradores do servidor quanto os usuários devem atualizar suas credenciais salvas para ajudar a garantir o acesso ininterrupto aos dados.

### 1: preparar a ID do cliente OAuth, a chave secreta do cliente e a URL de redirecionamento

Antes de configurar o cliente OAuth personalizado, você precisa das informações listadas abaixo. Depois de preparar essas informações, você pode registrar o cliente OAuth personalizado para o site.

- **ID do cliente OAuth e valor do segredo do cliente:** primeiro registre o cliente OAuth com o provedor de dados (conector) para recuperar a ID do cliente e o valor do segredo gerado para o Tableau Server.
- **URL de redirecionamento:** observe a URL de redirecionamento correto. Você precisará disso durante o processo de registro na **Etapa 2** abaixo.
    
    https://<your\_server\_name>.com/auth/add\_oauth\_token
    
    Por exemplo, https://example.com/auth/add\_oauth\_token

### 2: registre a ID do cliente OAuth e a chave secreta do cliente

Siga o procedimento descrito abaixo para registrar o cliente OAuth personalizado no site.

1. Entre no site do Tableau Server usando suas credenciais de administrador acesse a página de Configurações.
2. No Registro de clientes OAuth, clique no botão Adicionar cliente OAuth.
3. Insira as informações necessárias, incluindo as informações da **Etapa 1** acima:
    
    1. Para Tipo de conexão, selecione o conector, cujo cliente OAuth personalizado você deseja configurar.
    2. URL da instância OAuth é necessária se vários clientes OAuth estiverem sendo registrados. Caso contrário, é opcional.
    3. Para ID do cliente, Segredo do cliente e URL de redirecionamento, insira as informações que você preparou na **Etapa 1** acima.
    4. Clique no botão Adicionar cliente OAuth para concluir o processo de registro.
    
    ![Um formulário para a criação de um cliente OAuth, incluindo campos para tipo de conexão, URL da instância OAuth, ID do cliente, segredo do cliente e URL de redirecionamento.](/tableau/current/pt-br/server/pt-br/Img/oauth_custom.png)
4. (Opcional) Repita a etapa 3 para todos os conectores compatíveis.
5. Clique no botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações.

### 3: validar e atualizar as credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente para usar o cliente OAuth personalizado para o site.

1. Navegue até a página Minhas configurações da conta.
2. Em Credenciais salvas para fontes de dados, faça o seguinte:
    
    1. Clique em Excluir ao lado das credenciais salvas existentes para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima.
    2. Ao lado do nome do conector, clique em Adicionar e siga as instruções para 1) conectar-se ao cliente OAuth personalizado configurado na **Etapa 2** acima e 2) salvar as credenciais mais recentes.

### 4: notificar os usuários para atualizarem as credenciais salvas

Certifique-se de notificar os usuários do seu site para atualizar suas credenciais salvas para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima. Os usuários do site podem usar o procedimento descrito em [Atualizar credenciais salvas](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm#oauth_update_credentials) para atualizar as credenciais salvas.

## Proxy de encaminhamento para autenticação OAuth

Para obter mais informações sobre como configurar um proxy de encaminhamento com autenticação OAuth para o Tableau Server (somente Windows), consulte [Configurar um proxy de encaminhamento para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm#server) na Ajuda do Tableau.

<!-- document id=2055ad854352b42d3acb5a4a585a792f403964c204af36a0aaf22b8c67fc9e55 url=/tableau/current/pt-br/server/config_kerberos.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o Kerberos

É possível configurar o Tableau Server para usar o Kerberos. Isso permite oferecer uma experiência de logon único (SSO) em todos os aplicativos da empresa. Antes de configurar o Tableau Server para Kerberos tenha certeza de que o seu ambiente atende aos [Requisitos do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_requ.htm).

**Observação:** a delegação restrita do Kerberos para SSO para Tableau Server não é aceita. (Delegação restrita para fontes de dados é aceita.) Para obter mais informações, consulte Logon único, SSO em [Requisitos do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_requ.htm).

Para configurar o Kerberos, é necessário habilitar o Kerberos primeiro e depois especificar um arquivo keytab para a autenticação do usuário. O arquivo keytab especificado deve ser configurado com um nome de provedor de serviços para o Tableau Server, com o propósito de autenticação do usuário. Se estiver usando a autenticação do Kerberos para as fontes de dados, essas credenciais deverão ser incluídas no arquivo keytab único especificado durante a configuração do Kerberos no Tableau Server.

Como parte do seu plano de recuperação de desastres, recomendamos manter um backup do arquivo keytab em um local seguro fora do Tableau Server. O arquivo keytab que você adicionar ao Tableau Server será armazenado e distribuído para outros nós pelo Serviço de Arquivos do Cliente. No entanto, o arquivo não é armazenado em um formato recuperável. Consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique em Identidade e acesso do usuário na guia Configuração, em seguida clique em Método de autenticação.
3. Em Método de autenticação, selecione Kerberos no menu suspenso.
4. Em Kerberos, selecione Habilitar Kerberos para acesso único (SSO).
5. Para copiar o arquivo keytab para o servidor, clique em Selecionar arquivo e navegue até o arquivo em seu computador.
    
    ![Configurar a captura de tela do Kerberos](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-kerberos.png)
6. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
7. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
8. Clique em Aplicar alterações e reiniciar.

1. Se estiver usando o Tableau Server em uma implementação de cluster distribuído, então será necessário distribuir manualmente o arquivo keytab em cada nó e depois definir as permissões. Copie o arquivo keytab para o mesmo diretório em cada nó do cluster. Após copiar o arquivo keytab em cada nó e definir suas permissões, execute os seguintes comandos TSM em um nó. A configuração será propagada para cada nó.
2. Digite o seguinte comando para especificar a localização e o nome do arquivo keytab:
    
    `tsm authentication kerberos configure --keytab-file <path-to-keytab_file>`
3. Digite o seguinte comando para habilitar o Kerberos:
    
    `tsm authentication kerberos enable`
4. Execute `tsm pending-changes apply` para aplicar as alterações.
    
    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).

## Confirmar configuração de logon único

Quando o Tableau Server tiver reiniciado, teste a sua configuração do Kerberos de um navegador da web em um computador diferente digitando o nome do Tableau Server na janela URL:

![Uma janela em branco do navegador da Web exibe "http://tableau\_server" na barra de endereço.](/tableau/current/pt-br/server/pt-br/Img/saml_browser.png)

Você deve ser autenticado automaticamente no Tableau Server.

<!-- document id=fd0d74e606c10571a35c2b91a7d25cb0f0e08b055a7e67668a6b16002eeb627a url=/tableau/current/pt-br/server/config_oauth_redshift_iam_idc.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o OAuth do Amazon Redshift IAM Identity Center

A partir do Tableau 2023.3.2, você pode usar o OAuth 2.0/OIDC para federar a identidade de um provedor de identidade externo para o Amazon Redshift.

Essas instruções são para o serviço AWS IAM IDC mais recente. Para integração original do IAM, consulte [Configurar o Amazon Redshift IAM OAuth](https://help.tableau.com/current/server/pt-br/config_oauth_redshift_iam.htm).

Dependendo do fornecedor de identidade, existem diferentes passos necessários para configurar a integração. Esta é uma visão geral de alto nível. O Tableau não pode fornecer instruções detalhadas sobre como configurar a AWS ou o IDP, mas esta é a abordagem geral.

Para alguns exemplos detalhados de implementação de autenticação com Redshift, consulte “[Integrar Tableau e Okta com Amazon Redshift usando AWS IAM Identity Center](https://aws.amazon.com/blogs/big-data/integrate-tableau-and-okta-with-amazon-redshift-using-aws-iam-identity-center/)” e “[Integrar Tableau e Microsoft Entra ID com Amazon Redshift usando AWS IAM Identity Center](https://aws.amazon.com/blogs/big-data/integrate-tableau-and-microsoft-entra-id-with-amazon-redshift-using-aws-iam-identity-center/)”.

## Etapa 1: configurar o IDP

1. Crie clientes OAuth no IDP para Tableau Desktop e Tableau Server ou Tableau Cloud. O cliente Desktop deve ativar `PKCE` e usar redirecionamentos de `http://localhost`.
2. Adicione quaisquer declarações personalizadas para autorização de funções.
3. Crie o arquivo de configuração do Tableau OAuth. Veja a documentação em [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "Documentação no GitHub para criar arquivos de configuração do Tableau OAuth.") e os [exemplos](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "Exemplos no GitHub para criar arquivos de configuração do Tableau OAuth."). Aceitamos exemplos para outros IDPs.
    
    1. Certifique-se de prefixar as IDs de configuração do Tableau OAuth com “`custom_`”.
        
        **Observação:** as IDs de configuração do OAuth têm um limite máximo de 36 caracteres. IDs maiores que isso podem não gerar erros, mas não funcionarão.
    2. Se o seu IDP suportar porta localhost dinâmica, desative `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`. Caso contrário, adicione várias URLs de retorno de chamada de host local à lista de permissões no arquivo de configuração e no IDP.
4. Instale os novos arquivos de configuração do Tableau OAuth na pasta `OAuthConfigs` associada a cada aplicativo em hosts de desktop (Tableau Desktop, Tableau Prep Builder, Tableau Bridge) e em cada site do Tableau Server e do Tableau Cloud que usará o OAuth.

## Etapa 2: configurar IDP e funções na AWS

Consulte a documentação da AWS para obter informações sobre como fazer isso.

## Etapa 3: conectar-se ao Redshift

1. Conecte-se ao Redshift.
2. Selecione OAuth para Authentication (Autenticação).
3. Selecione Identity Center para Federation Type (Tipo de Federação).
4. (Opcional) Especifique o Identity Center Namespace se necessário.

![](/tableau/current/pt-br/server/pt-br/Img/redshift_oauth_idc_connect.png "Caixa de diálogo de conexão ao Redshift")

Quando configurado corretamente, você será redirecionado ao IDP para autenticar e autorizar tokens para o Tableau. O Tableau receberá um token de acesso e tokens de atualização. Ele enviará o token de acesso ao driver para autenticação.

## Tokens

Por padrão, o Redshift OAuth para IAM IDC passa o token de acesso para o driver. Para clientes locais, incluindo aqueles que usam o Tableau Bridge, você pode usar um arquivo TDC para transmitir o token de ID.

<connection-customization class='redshift' enabled='true' version='10.0'>
	<vendor name='redshift' />
	<driver name='redshift' />
	<customizations>
		<customization name='CAP\_OAUTH\_FEDERATE\_ID\_TOKEN' value='yes'/>
	</customizations>
</connection-customization>

Para obter mais informações sobre como configurar e instalar arquivos .tdc, consulte [Personalizar e ajustar uma conexão](https://help.tableau.com/current/pro/desktop/pt-br/connect_customize.htm) e [Usar um arquivo .tdc com o Tableau Server](https://help.salesforce.com/s/articleView?id=001458291&type=1).

## Okta

Se você estiver usando o Okta, será melhor usar um “servidor de autorização personalizado” vez de em vez do “servidor de autorização organizacional”. Os servidores de autorização personalizados são mais flexíveis. Um servidor de autorização personalizado é criado por padrão e denominado "padrão". A URL de autorização deve ter esta aparência:

https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize

![](/tableau/current/pt-br/server/pt-br/Img/redshift_oauth_idc_okta_800x332.png)

## Atualizar o driver

Para o Redshift OAuth usando o serviço IAM IDC, você precisa usar pelo menos a versão 2.x do driver ODBC. Baixe a versão mais recente do driver Redshift ODBC encontrado em [https://github.com/aws/amazon-redshift-odbc-driver/tags](https://github.com/aws/amazon-redshift-odbc-driver/tags "Download do driver para Redshift ODBC versão 2"). Observe que ainda não há driver v2 para OSX.

## Solução de problemas do OAuth do IDC de IAM do Redshift

A melhor maneira de diagnosticar erros é remover o Tableau da imagem. Em vez disso, você pode testar usando o gerenciador de drivers ou uma ferramenta semelhante. Isso é apenas para solução de problemas - você não deve usar um DSN ou o conector “Outro ODBC” para uso regular deste recurso. Para ajudar a garantir um teste válido, os parâmetros devem ser os mesmos mostrados abaixo, exceto pelas informações do cluster, banco de dados, token e namespace.

Se você vir uma mensagem de erro sobre token inválido/expirado vindo do driver na primeira conexão (ele terá um código de erro SQLState como \[28000\] ou \[08001\] na mensagem de erro), o Tableau concluiu com êxito o fluxo OAuth e falhou no driver. Isso significa que há uma configuração incorreta no lado da AWS ou no lado do IDP. Também pode haver erros de permissão ou autorização retornados pelo driver, o que também está fora do controle do Tableau.

Antes de começar a testar, primeiro você precisa obter um token de acesso (o padrão para IAM IDC) ou um token de acesso (se personalizado) para enviar ao driver.

Aqui está um exemplo com Okta. Quase todos os IDPs internos têm uma maneira de fazer isso que é bastante semelhante. Observe que para usar esse fluxo você precisa ter habilitado o tipo de concessão de senha do proprietário do recurso. Substitua a URL do IDP, o segredo do cliente, a ID do cliente, o nome de usuário e a senha.

curl -X POST "https://OKTA\_URL/v1/token" \\  
\-H 'accept: application/json' \\  
\-H "Authorization: Basic $(echo -n 'CLIENTID:CLIENTSECRET' | base64)" \\  
\-H "Content-Type: application/x-www-form-urlencoded" \\  
\-d "grant\_type=password&username=USER&password=PASSWORD&scope=openid"

Depois de obter o token, você pode usar um DSN para testar. Para Windows, pode usar o gerenciador de driver ODBC. No Linux, você pode usar a ferramenta de linha de comando isql incluída no Tableau Server na pasta “customer-bin”.

O Tableau recomenda que você não use outros plugins para testar, porque eles podem não funcionar em um ambiente de servidor. Eles usam um perfil fixo da AWS ou exigem acesso direto a um navegador.

Abaixo está um exemplo de uso do gerenciador de driver ODBC no Windows.

![](/tableau/current/pt-br/server/pt-br/Img/redshift_oauth_idc_troubleshoot.png)

<!-- document id=db88cecbdb51fd8db5f053e34bca129f9463860bbb909c78941113b503d710a9 url=/tableau/current/pt-br/server/config_oauth_hana.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o OAuth externo para SAP HANA

A partir do Tableau 2024.3 para Tableau Cloud, você pode usar o OAuth 2.0/OIDC para federar a identidade de um provedor de identidade externo para o HANA.

Dependendo do fornecedor de identidade, existem diferentes passos necessários para configurar a integração. Esta é uma visão geral de alto nível.

## Configurar o IDP no HANA

Para obter informações sobre como configurar seu IdP no HANA, consulte [Login único usando tokens da Web JSON](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-security-guide/single-sign-on-using-json-web-tokens) no sistema de ajuda do SAP.

Aqui estão alguns exemplos de diferentes maneiras de configurar o IdP:

- Okta IdP usando HANA Cockpit: [Conecte-se no SAP HANA com uma conta Okta](https://help.alteryx.com/current/en/designer/data-sources/sap-hana/connect-to-sap-hana-cloud-with-okta-account.html#connect-to-sap-hana-cloud-with-okta-account)
- IdP do Azure usando o HANA Studio: [Configurando uma instância SAP HANA com OAuth ou SSO](https://www2.microstrategy.com/producthelp/Current/Gateway_Connections/WebHelp/Lang_1033/Content/sap_hana_instance_oauth_sso.htm)

## Configurar o IDP

1. Crie clientes OAuth no IDP para Tableau Desktop e Tableau Server ou Tableau Cloud. O cliente Desktop deve ativar [`PKCE`](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce)e usar redirecionamentos de `http://localhost`.
2. Crie o arquivo de configuração do Tableau OAuth. Para obter detalhes sobre como fazer isso, consulte [Configuração e uso do OAuth](https://tableau.github.io/connector-plugin-sdk/docs/oauth) em [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "Documentação OAuth no GitHub"), e exemplos [aqui](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "Exemplos de OAuth no GitHub."). Aceitamos exemplos para outros IDPs.
    
    1. Certifique-se de prefixar as IDs de configuração do Tableau OAuth com “`custom_`”.
        
        **Observação:** as IDs de configuração do OAuth têm um limite máximo de 36 caracteres. IDs maiores que isso podem não gerar erros, mas não funcionarão.
    2. Se o seu IDP suportar porta localhost dinâmica, desative `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`. Se o seu IDP não for compatível, certifique-se de adicionar várias URLs de retorno de chamada de host local à lista de permissões no arquivo de configuração e no IDP.
3. Instale os novos arquivos de configuração do Tableau OAuth na pasta `OAuthConfigs` associada a cada aplicativo em hosts de desktop (Tableau Desktop, Tableau Prep Builder, Tableau Bridge) e em cada o site do Tableau Server e do Tableau Cloud que usará o Oauth através da página de configurações do site. Para obter mais detalhes, veja [Configurações OAuth personalizadas no Desktop](https://tableau.github.io/connector-plugin-sdk/docs/oauth#custom-oauth-configs-on-desktop) e [Clientes OAuth em nível de site](https://tableau.github.io/connector-plugin-sdk/docs/oauth#site-level-oauth-clients).

## Conecte-se ao HANA

O usuário deve selecionar Entrar usando OAuth, e selecione o Provedor OAuth instalado anteriormente.

![](/tableau/current/pt-br/server/pt-br/Img/hana_connect.png)

## Okta

Se estiver usando o Okta, é melhor usar um “servidor de autorização personalizado” em vez do “servidor de autorização organizacional”. Os servidores de autorização personalizados são mais flexíveis. Existe um servidor de autorização personalizado criado por padrão, chamado “default”. A URL de autorização deve ter esta aparência:

https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize

![](/tableau/current/pt-br/server/pt-br/Img/redshift_oauth_iam_okta_800x332.png)

<!-- document id=61c1a93ffc1f9be22c6a2abe3902f6b497c17463d43ab91d0012fbed390683d0 url=/tableau/current/pt-br/server/config_oauth_snowflake_client_creds.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o OAuth externo para Snowflake: fluxo de credenciais do cliente

A autenticação de credenciais de cliente OAuth permite conexões de máquina para máquina com o Snowflake

sem a interação do usuário. Este método é ideal para:

- Contas de serviço para atualizações de dados automatizadas
- Trabalhos de extração agendada
- Pipelines de CI/CD
- Fontes de dados publicadas que exigem credenciais inseridas

Ao contrário do OAuth padrão (que usa o fluxo de código de autorização), o fluxo de credenciais do cliente não

solicita que os usuários façam logon. Em vez disso, o Tableau autentica diretamente com seu provedor de identidade usando um

ID do cliente e segredo.

**Observação:** o fluxo de credenciais do cliente exige o recurso OAuth externo do Snowflake com um provedor de identidade compatível. Isso é diferente do OAuth nativo do Snowflake.

## Antes de começar

Para usar credenciais de cliente OAuth com Snowflake, você precisa de:

| Requisito | Descrição |
| --- | --- |
| Provedor de identidade | Okta, Azure AD ou Ping Federate configurado para concessão de credenciais do cliente |
| Conta do Snowflake | Enterprise Edition ou superior com acesso ACCOUNTADMIN |
| Aplicativo OAuth | Serviços de API (Okta), registro de aplicativo (Azure AD) ou equivalentes |
| Escopos personalizados | Escopos para atribuição de função do Snowflake (por exemplo, “session:role:SYSADMIN”) |

## Configurar seu provedor de identidade

As etapas a seguir usam o Okta como exemplo. Para outros provedores, consulte a documentação para obter a configuração de credenciais do cliente.

### Etapa 1: criar um aplicativo de serviços de API

1. Entre no console do admin do Okta.
2. Acesse \*\***Aplicativos** > **Aplicativos**.
3. Selecione \*\***Criar integração de aplicativo**.
4. Escolha \*\***Serviços de API**\*\* e selecione \*\***Próximo**.
5. Insira um nome de aplicativo (por exemplo, `snowflake-tableau-service`).
6. Selecione **Salvar**.
7. Copie o **ID do cliente** e **Segredo do cliente**. Esses valores serão necessários posteriormente.

### Etapa 2: desabilitar o DPoP (se ativado)

A demonstração da prova de posse (DPoP) deve ser desabilitada para o fluxo de credenciais do cliente.

1. Nas configurações do aplicativo, acesse **Geral** \> **Credenciais do cliente**.
2. Desmarque a caixa de seleção **Exigir cabeçalho da demonstração da prova de posse (DPoP) em solicitações de token**.
3. Selecione **Salvar**.

### Etapa 3: adicionar escopos personalizados

O Snowflake requer escopos personalizados para atribuir funções à sessão autenticada.

1. Acesse **Segurança** > **API** \> **Servidores de autorização**.
2. Selecione o servidor de autorização **padrão** (ou o servidor personalizado).
3. Selecione a guia **Escopos** e, em seguida, **Adicionar escopo**.
4. Adicione estes escopos:
    
    | Nome do escopo | Descrição |
    | --- | --- |
    | snowflake | Escopo de acesso geral para Snowflake |
    | session:role:SYSADMIN | Atribui a função SYSADMIN (ajuste para sua função) |
    
    **Observação:** crie escopos adicionais para quaisquer outras funções de que sua conta de serviço precise.

### Etapa 4: configurar uma política de acesso

1. Selecione a guia **Políticas de acesso**.
2. Selecione uma política existente ou crie uma nova.
3. Adicione uma regra com estas configurações:
    
    - **Tipo de concessão:** credenciais do cliente
    - **Escopos:** quaisquer escopos (ou selecione escopos específicos)
4. Selecione **Criar regra** ou **Salvar**.

## Configurar o Snowflake

Execute as seguintes instruções SQL no Snowflake como ACCOUNTADMIN. Substitua os valores de marcador de posição pela sua configuração.

### Etapa 1: criar a integração do OAuth externa

USE ROLE ACCOUNTADMIN;

CREATE OR REPLACE SECURITY INTEGRATION okta\_oauth\_integration
  TYPE = EXTERNAL\_OAUTH
  ENABLED = TRUE
  EXTERNAL\_OAUTH\_TYPE = OKTA
  EXTERNAL\_OAUTH\_ISSUER = 'https://<your-okta-domain>.okta.com/oauth2/default'
  EXTERNAL\_OAUTH\_JWS\_KEYS\_URL = 'https://<your-okta-domain>.okta.com/oauth2/
default/v1/keys'
  EXTERNAL\_OAUTH\_TOKEN\_USER\_MAPPING\_CLAIM = 'sub'
  EXTERNAL\_OAUTH\_SNOWFLAKE\_USER\_MAPPING\_ATTRIBUTE = 'login\_name'
  EXTERNAL\_OAUTH\_AUDIENCE\_LIST = ('api://default', 'snowflake')
EXTERNAL\_OAUTH\_ANY\_ROLE\_MODE = 'ENABLE';

| Parâmetro | Descrição |
| --- | --- |
| `EXTERNAL_OAUTH_TYPE` | Seu provedor de identidade: `OKTA` , `AZURE` ou `PING_FEDERATE` |
| `EXTERNAL_OAUTH_ISSUER` | A URL do emissor do servidor de autorização |
| `EXTERNAL_OAUTH_JWS_KEYS_URL` | O endpoint JWKS para validação de token |
| `EXTERNAL_OAUTH_TOKEN_USER_MAPPING_CLA IM` | A declaração JWT que identifica o usuário. Use `sub` para Okta. |
| `EXTERNAL_OAUTH_ANY_ROLE_MODE` | Defina como `ENABLE` para permitir a atribuição de função por meio de escopos |

### Etapa 2: criar um usuário de serviço

Crie um usuário do Snowflake com um `LOGIN_NAME` que corresponde ao ID do cliente OAuth.

CREATE USER IF NOT EXISTS service\_account\_user  
  LOGIN\_NAME = '<your-okta-client-id>'  
  DISPLAY\_NAME = 'OAuth Service Account'  
  MUST\_CHANGE\_PASSWORD = FALSE  
  DISABLED = FALSE;
  
\-- Grant role to the service user  
GRANT ROLE SYSADMIN TO USER service\_account\_user;
  
\-- Set the default role  
ALTER USER service\_account\_user SET DEFAULT\_ROLE = 'SYSADMIN';
  
\-- Grant warehouse access  
GRANT USAGE ON WAREHOUSE <your-warehouse> TO USER service\_account\_user;
  
\-- Grant database and schema access  
GRANT USAGE ON DATABASE <your-database> TO USER service\_account\_user;  
GRANT USAGE ON SCHEMA <your-database>.<your-schema> TO USER  
service\_account\_user;  
GRANT SELECT ON ALL TABLES IN SCHEMA <your-database>.<your-schema> TO USER  
service\_account\_user;

**Importante:** o `LOGIN_NAME` deve corresponder exatamente à declaração `sub` no token do OAuth. Para aplicativos de serviços de API do Okta, este é o ID do cliente.

## Conectar por meio do Tableau Desktop

1. No Tableau Desktop, selecione **Conectar** \> **Snowflake**.
2. Insira os detalhes da conexão:
    
    | Campo | Valor |
    | --- | --- |
    | Servidor | URL da sua conta do Snowflake (por exemplo, `account.snowflakecomputing.com`) |
    | Função | A função a ser usada (por exemplo, `SYSADMIN`) |
    | Warehouse | Seu warehouse do Snowflake |
    | Autenticação | Credenciais de clientes OAuth |
3. Insira a configuração do OAuth:
    
    | Campo | Valor |
    | --- | --- |
    | URL de solicitação de token OAuth | `https://<your-okta-domain>.okta.com/oauth2/default/ v1/token` |
    | Username | Seu ID de cliente OAuth |
    | Senha | Seu segredo de cliente OAuth |
    | Escopo do OAuth | `snowflake session:role:SYSADMIN` |
    
    **Observação:** o escopo do OAuth deve incluir todos os escopos personalizados que você configurou para atribuição de função.
4. Selecione **Fazer logon**.

## Publicar no Tableau Cloud ou Tableau Server

Ao publicar uma pasta de trabalho ou fonte de dados que usa credenciais de cliente OAuth:

1. Na caixa de diálogo **Publicar**, selecione **Editar** ao lado de **Fontes de dados**.
2. Em **Autenticação**, selecione **Senha inserida**.
3. As credenciais do cliente são inseridas no conteúdo publicado.

**Importante:** ao contrário do OAuth padrão, as credenciais do cliente são tratadas como senhas inseridas. Os usuários que acessam o conteúdo publicado usam as credenciais de conta de serviço, não sua própria identidade.

### Rotação de credencial

Quando o segredo do cliente OAuth for rotacionado, atualize as credenciais inseridas no Tableau Cloud:

1. Entre no Tableau Cloud.
2. Navegue até a fonte de dados publicada.
3. Selecione **Conexões**.
4. Atualize a conexão com o novo segredo do cliente.

Para rotação automatizada, use a API REST do Tableau para atualizar as credenciais de conexão de maneira programática.

## Perguntas frequentes

### Quando devo usar credenciais de cliente OAuth em vez do OAuth padrão?

Use as credenciais do cliente quando você precisar de uma autenticação autônoma de máquina para máquina. Padrão

O OAuth requer interação do usuário para o logon inicial e reautenticação periódica. Credenciais do cliente

Usam uma identidade de conta de serviço e não exigem interação do usuário.

### Posso usar credenciais de cliente com o OAuth nativo do Snowflake?

Não. O OAuth nativo do Snowflake oferece suporte apenas ao fluxo do código de autorização. As credenciais do cliente exigem o OAuth externo com um provedor de identidade compatível (Okta, Azure AD ou Ping Federate).

### Como faço para lidar com a rotação secreta para conteúdo publicado?

Quando o segredo do cliente OAuth for rotacionado, atualize as credenciais inseridas no Tableau Cloud. Você pode fazer isso manualmente por meio da interface do usuário do Tableau Cloud ou de forma programática usando a API REST do Tableau. Considere automatizar esse processo como parte do fluxo de trabalho de rotação secreto.

### Por que minha conexão falha com um erro de função mesmo que EXTERNAL\_OAUTH\_ANY\_ROLE\_MODE esteja habilitado?

O Snowflake requer informações de função no token do OAuth. Adicione um escopo personalizado (por exemplo, `session:role:SYSADMIN`) ao servidor de autorização e inclua-o no campo Escopo do OAuth ao se conectar pelo Tableau.

## Solução de problemas

| Mensagem de erro | Causa | Solução |
| --- | --- | --- |
| “O usuário não existe ou não está autorizado” | O usuário do Snowflake `LOGIN_NAME` não corresponde ao ID do cliente OAuth | Defina o `LOGIN_NAME` do usuário para corresponder à declaração `sub` (ID do cliente para Okta) |
| “A função solicitada não está listada no token de acesso” | Escopo de função ausente no token | Adicione o escopo `session:role:<ROLE>` ao seu servidor de autorização e inclua-o no escopo OAuth |
| “Prova de DPoP inválida” | DPoP está habilitado no Okta | Desabilite “Exigir demonstração da prova de posse (DPoP)” no aplicativo Okta |
| “Escopo inválido” | Escopos personalizados não configurados | Adicione os escopos necessários ao servidor de autorização; não inclua `openid` |
| Falha na validação do token | URL de JWKS ou emissor incorreto | Verifique se `EXTERNAL_OAUTH_JWS_KEYS _URL` e `EXTERNAL_OAUTH_ISSUER` correspondem ao seu servidor de autorização |

## Consulte também

- [Configurar o OAuth para conexões do Snowflake no Tableau Server](https://help.tableau.com/current/server/pt-br/config_oauth_snowflake.htm) - Saiba mais sobre a autenticação OAuth padrão com Snowflake.
- [Integrações de segurança OAuth externo](https://docs.snowflake.com/en/user-guide/oauth-external-overview) - Documentação do Snowflake para configurar provedores OAuth externos.
- [Fluxo de credenciais do cliente Okta](https://developer.okta.com/docs/guides/implement-grant-type/clientcreds/main/) - Documentação do Okta para implementar as credenciais do cliente.
- [Atualizar conexão de fonte de dados](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_data_sources.htm#update_data_source_connection) - Referência da API REST do Tableau para atualizações de credenciais.

<!-- document id=b003138d9d2216dd55c3927d568e4ef0580685b08612a3a07b96874fa79263b6 url=/tableau/current/pt-br/server/config_oauth_snowflake.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o OAuth para conexões do Snowflake no Tableau Server

Há várias maneiras de configurar o OAuth para conexões do Snowflake, dependendo da versão do Tableau Server que você está usando e de quantos sites você está atualizando. Este tópico aborda a configuração de cada opção disponível.

- Para todas as versões do Tableau até a versão 2024.1, inclusive, o conector Tableau Snowflake usa, por padrão, um proxy OAuth hospedado na AWS (GALOP), que usa um ID de cliente e um segredo comuns. Você pode configurar opcionalmente o Tableau Server para usar um novo serviço OAuth executado no mesmo local da instância do Tableau. Isso requer o fornecimento de seu próprio ID de cliente e segredo, conhecido como OAuth personalizado, e pode ser configurado usando as instruções abaixo.
- A partir de 2024.2, o proxy GALOP será descontinuado e as instruções abaixo para configurar o OAuth personalizado serão **obrigatório**, pois agora usará o serviço OAuth local para autenticação.
- Para Tableau Desktop e Tableau Cloud versões 2024.3 e posteriores, você pode configurar um IdP de terceiros (OAuth externo) para o Snowflake. Para obter mais informações, consulte [OAuth externo para Snowflake](https://help.tableau.com/current/server/pt-br/snowflake_oauth_idp.htm).

Os benefícios fornecidos pelo OAuth personalizado incluem:

- Segurança aprimorada
- Você pode usar o OAuth em ambientes isolados que não conseguem se conectar ao OAuth Proxy (GALOP).
- Você não precisa listar com segurança os endereços IP do GALOP para executar o fluxo OAuth em VPCs AWS PrivateLink ou Azure Private Link.

## Etapa 1: configurar e registrar o cliente OAuth com Snowflake

Para usar uma configuração do OAuth personalizado no Tableau Server, você deve primeiro configurar e registrar seu cliente OAuth e obter um ID de cliente e um segredo de cliente no Snowflake. Para o Tableau Server versões 2024.2 e posteriores, esta etapa é necessária, independentemente da opção de configuração usada. Para registrar um cliente personalizado OAuth com Snowflake, siga o etapas descritas em [Configurar o Snowflake OAuth para clientes personalizados](https://docs.snowflake.com/en/user-guide/oauth-custom.html#configure-snowflake-oauth-for-custom-clients).  

Após registrar seu cliente OAuth no Snowflake usando as etapas do artigo do Snowflake vinculado acima, você usará os seguintes parâmetros do Snowflake para configurar o Tableau Server:

- URL da instância da conta
- ID do cliente
- Segredo do cliente
- URL de redirecionamento

**Observação**: o URL de redirecionamento é o mesmo quando inserido no Snowflake e no Tableau. O formato é:  
https://<your\_tableau\_server\_url>.com/auth/add\_oauth\_token  

## Etapa 2: configurar o Tableau Server para usar o OAuth para Snowflake

### Opção 1: configurar OAuth para conexões Snowflake usando TSM

Recomendamos usar esta opção quando precisar atualizar vários sites do Tableau Server de uma vez.

**Observação**: esta opção de configuração não está disponível para o uso em Tableau Cloud.

1. (Versões 2024.1 e anteriores) No computador do Tableau Server, execute o seguinte comando para ativar o serviço Snowflake OAuth:
    
    `tsm configuration set -k native_api.enable_snowflake_privatelink_on_server -v true`
    
    **Observação:** para versões 2024.2 e mais recentes, pule a etapa 1, independentemente de uma conexão privada Snowflake estar sendo usada ou não.
2. Copie, cole e personalize o seguinte comando em um editor de texto:
    
    `tsm configuration set -k oauth.snowflake.clients -v " [{\"oauth.snowflake.instance_url\":\"https://account.snowflakecomputing.com\", \"oauth.snowflake.client_id\":\"client_id_string\", \"oauth.snowflake.client_secret\":\"client_secret_string\", \"oauth.snowflake.redirect_uri\":\"http://your_server_url.com/auth/add_oauth_token\" }]"`
    
    A chave `oauth.snowflake.clients`obtém uma matriz de pares de chaves. Cada elemento no par de chaves deve estar entre aspas duplas. As aspas duplas devem ter `\"`.
    
    Para especificar várias URLs de instância de conta, separe cada cliente OAuth adicional entre chaves ({}) com uma vírgula (,), como neste exemplo:
    
    `tsm configuration set -k oauth.snowflake.clients -v " [{\"oauth.snowflake.instance_url\":\"https://account.snowflakecomputing.com\",\"oauth.snowflake.client_id\":\"client_id_string1\",\"oauth.snowflake.client_secret\":\"client_secret_string1\",\"oauth.snowflake.redirect_uri\":\"http://your_server_url.com/auth/add_oauth_token\" },{\"oauth.snowflake.instance_url\":\"https://account2.snowflakecomputing.com\",\"oauth.snowflake.client_id\":\"client_id_string2\",\"oauth.snowflake.client_secret\":\"client_secret_string2\",\"oauth.snowflake.redirect_uri\":\"http://your_server_url.com/auth/add_oauth_token\" }]"`
    
    Substitua os valores de cada chave:
    
    - URL da instância da conta: `oauth.snowflake.instance_url`
    - ID do cliente: `oauth.snowflake.client_id`
    - Segredo do cliente: `oauth.snowflake.client_secret`
    - URL de redirecionamento: `oauth.snowflake.redirect_uri`
    
    **Observação**: antes de executar o comando, verifique cuidadosamente a sintaxe. O TSM não validará essa entrada.
    
    Copie o comando na CLI do TSM e execute-o.
3. Insira o comando a seguir para aplicar as alterações:
    
    `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).

### Opção 2: configurar OAuth para conexões Snowflake por site

**Observação**: esta opção também está disponível para Tableau Cloud começando com a versão 2024.2.

Você pode configurar um cliente Snowflake OAuth personalizado no nível do site usando a interface do usuário do Tableau Server.

Considere configurar um cliente OAuth personalizado no nível do site para:

1. Substituir um cliente OAuth se configurado para o servidor
2. Habilitar suporte para conexão segura com dados que exigem clientes OAuth exclusivos.

Quando um cliente OAuth personalizado é configurado, a configuração no nível do site tem precedência sobre qualquer configuração em todo o servidor e todas as credenciais OAuth adicionadas recentemente usam o cliente OAuth no nível do site por padrão. Nenhuma reinicialização do Tableau Server é necessária para que as configurações do OAuth personalizado no nível do site entrem em vigor.

**Importante:** as credenciais OAuth existentes estabelecidas antes da configuração do cliente OAuth personalizado podem ser usadas temporariamente, mas os administradores e os usuários do Tableau Server devem atualizar suas credenciais salvas para ajudar a garantir o acesso ininterrupto aos dados.

#### Etapa 1: preparar a ID do cliente OAuth, a chave secreta do cliente e a URL de redirecionamento

Antes de configurar o cliente OAuth personalizado, você precisa das informações listadas abaixo. Depois de preparar essas informações, você pode registrar o cliente OAuth personalizado para o site. Para obter mais informações, consulte a seção **Etapa 1: configurar e registrar o cliente OAuth com Snowflake**, acima.

- **URL da instância da conta**
- **ID do cliente OAuth e segredo do cliente:** primeiro registre o cliente OAuth com o provedor de dados (conector) para recuperar a ID do cliente e o segredo gerado para o Tableau Server.
- **URL de redirecionamento:** observe a URL de redirecionamento correto. Você precisará disso durante o processo de registro na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server** abaixo.
    
    https://<your\_tableau\_server\_url>.com/auth/add\_oauth\_token

#### Etapa 2: adicionar o cliente OAuth ao site do Tableau Server

Siga o procedimento descrito abaixo para registrar o cliente OAuth personalizado no site.

1. (Versões 2024.1 e anteriores) No computador do Tableau Server, execute estes dois comandos para habilitar o serviço Snowflake OAuth:
    
    `tsm configuration set -k native_api.enable_snowflake_privatelink_on_server -v true`
    
    `tsm pending-changes apply`
    
    **Observação:** para versões 2024.2 e mais recentes, pule a etapa 1, independentemente de uma conexão privada Snowflake estar sendo usada ou não.
2. Entre no site do Tableau Server usando suas credenciais de administrador acesse a página de Configurações.
3. No Registro de clientes OAuth, clique no botão Adicionar cliente OAuth.
4. Insira as informações necessárias, incluindo as informações da **Etapa 1** acima:
    
    1. Para Tipo de conexão, selecione o conector, cujo cliente OAuth personalizado você deseja configurar.
    2. URL da instância OAuth é necessária se vários clientes OAuth estiverem sendo registrados. Caso contrário, é opcional.
    3. Para ID do cliente, Segredo do cliente e URL de redirecionamento, insira as informações que você preparou na **Etapa 1** acima.
    4. Clique no botão Adicionar cliente OAuth para concluir o processo de registro.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/oauth_custom.png)
5. Clique no botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações.

#### Etapa 3: validar e atualizar as credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente para usar o cliente OAuth personalizado para o site.

1. Navegue até a página Minhas configurações da conta.
2. Em Credenciais salvas para fontes de dados, faça o seguinte:
    
    1. Clique em Excluir ao lado das credenciais salvas existentes para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server** acima.
    2. Ao lado do nome do conector, clique em Adicionar e siga as instruções para 1) se conectar ao cliente OAuth personalizado que você configurou na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server** acima e 2) salvar as credenciais mais recentes.

#### Etapa 4: notificar os usuários para atualizarem as credenciais salvas

Certifique-se de notificar os usuários do seu site para atualizar suas credenciais salvas para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server**. Os usuários do site podem usar o procedimento descrito em [Atualizar credenciais salvas](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm#oauth_update_credentials) para atualizar as credenciais salvas.

## Proxy de encaminhamento para autenticação OAuth

Para obter mais informações sobre como configurar um proxy de encaminhamento com autenticação OAuth para o Tableau Server (somente Windows), consulte [Configurar um proxy de encaminhamento para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm#server) na Ajuda do Tableau.

<!-- document id=3072545c798a18e6342ac4cde5fa2669727c97c8a2e82ad3e7254e62146fa0a8 url=/tableau/current/pt-br/server/openid_auth_idp_config.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o provedor de identidades para o OpenID Connect

Este tópico fornece informações sobre a configuração de um provedor de identidade (IdP) para usar o OpenID Connect (OIDC) com Tableau Server . Esta é uma etapa contida em um processo de várias etapas. Os tópicos a seguir fornecem informações sobre a configuração e uso de OIDC com Tableau.

1. Visão geral do [OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth.htm)
2. Configurar o provedor de identidades para o OpenID Connect (você está aqui)
3. [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm)
4. [Como fazer logon no Tableau Server usando o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_signing_in.htm)

Antes de poder usar o OpenID Connect com o Tableau Server , é preciso ter uma conta com um provedor de identidade (IdP) e um projeto ou aplicativo com o IdP. Ao configurar o Tableau Server TCM , é preciso fornecer as seguintes informações:

- **ID do cliente:** é o identificador que o IdP atribuiu ao seu aplicativo.
- **Segredo do cliente:** este é um token usado pelo Tableau para verificar a autenticidade da resposta do IdP. Este valor é um segredo e deve ser mantido em segurança.
- **URL de configuração:** esta URL especifica a localização do documento de descoberta de configuração do provedor que contém os metadados do provedor OpenID.

#### URL de redirecionamento

Alguns IdPs precisarão de uma URL de redirecionamento para o site do o Tableau Server .

É possível criar manualmente a URL para o IdP com a seguinte sintaxe:

`<protocol>://<host>/vizportal/api/web/v1/auth/openIdLogin`

Por exemplo, `https://tableau.example.com/vizportal/api/web/v1/auth/openIdLogin`.

#### Algoritmo de assinatura

O Tableau Cloud oferece suporte a RS256 (RSA usando SHA-256).

#### Exemplo do processo IdP

O procedimento a seguir oferece uma descrição das etapas que você segue com o provedor. Como exemplo, o procedimento discute o uso do Google como um provedor. Entretanto, cada provedor tem alguma diferença no fluxo; portanto, os detalhes das etapas (e a ordem delas) podem variar dependendo do seu provedor.

1. Registre-se no site do desenvolvedor e faça logon. Por exemplo, para o Google, você pode ir ao console de desenvolvedores (Google Developers Console) nesta URL: [https://console.developers.google.com](https://console.developers.google.com)
2. Crie um novo projeto, aplicativo ou conta de parte confiante.
3. No painel do desenvolvedor, siga as etapas para obter uma ID de cliente do OAuth 2.0 e segredo do cliente. Guarde esses valores para uso posterior.
    
    **Observação**: guarde o segredo do cliente em um local seguro.
4. No site do desenvolvedor, localize a URL do endpoint que o IdP usa para a descoberta do OpenID Connect. Por exemplo, o Google usa a URL [https://accounts.google.com/.well-known/openid-configuration](https://accounts.google.com/.well-known/openid-configuration). Guarde essa URL para uso posterior.
    
    Como alternativa, se o IdP tiver fornecido um documento de descoberta estática, copie o arquivo em um diretório local do Tableau Server para mais tarde.

<!-- document id=1e6302c1a980ee42c0d0187caa3b49e3ba7afdb6fbd5a9244aa969688fc6d97d url=/tableau/current/pt-br/server/crashdata_server_config_keys.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o relato de falhas do servidor

A geração de relatórios de falha do servidor está desabilitada por padrão. Este tópico descreve como configurar o gerador de relatórios de falhas do servidor Os relatórios de falha são criptografados e enviados para o Tableau. Consulte o [Gerador de relatórios de falhas do servidor](https://help.tableau.com/current/server/pt-br/crashdata_server.htm) para obter mais informações.

Se sua organização usar um servidor proxy para se conectar à internet, você deve configurar o gerador de relatórios de falhas do servidor do Tableau para usar o proxy. Mesmo que já tenha configurado o Tableau Server para usar um proxy, também deverá configurar o gerador de relatórios de falhas do servidor separadamente. Para configurar o proxy para o gerador de relatórios de falhas do servidor, você deve usar o procedimento CLI do TSM conforme descrito neste tópico.

**Importante:** não habilite a geração de relatórios de falhas se os dados estiverem sujeitos a regulamentos de privacidade.

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Manutenção.
3. Em Outras tarefas de manutenção, no Gerador de relatórios de falhas do servidor, selecione Habilitar relatórios de falhas:
    
    ![Um gerador de relatórios de falhas do servidor com a opção de habilitar relatórios de falhas.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-crash-reporter.png)
4. Especifique a hora do dia agendada para fazer o upload de relatórios de falha para o Tableau.
5. Ao terminar, clique em Alterações pendentes, em seguida clique em Aplicar alterações e reiniciar..

Use o modelo de arquivo de configuração abaixo para criar um arquivo json. Depois de preencher as opções com os valores adequados, passe o arquivo json e aplique as configurações com os seguintes comandos:

`tsm settings import -f path-to-file.json`

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

Como o arquivo de configuração está usando a classe configKey, os valores passados não são validados pelo TSM como ao usar a classe configEntities. É possível verificar e definir opções individuais usando os comandos [tsm configuration](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm).

### Configurações de relato de falhas

As configurações de relato de falha no modelo abaixo especificam diversas opções de configuração do Tableau Server para o envio de relatórios de falha ao Tableau.

### Modelo de configuração

Use este modelo para definir as configurações do gateway.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

 {
	"configKeys": {
	 "servercrashupload.enabled": "true",
	 "servercrashupload.scheduled\_time": "1:00:00 UTC",
	 "servercrashupload.proxy\_server\_host": " ,
	 "servercrashupload.proxy\_server\_port": " ,
	 "servercrashupload.proxy\_server\_username": " ,
	 "servercrashupload.proxy\_server\_password": " ,
	 "servercrashupload.preserve\_upload\_packages": "false",
	 "servercrashupload.delete\_completed\_dumps": "false"
	 }
 }

### Referência do arquivo de configuração

Esta tabela inclui chaves que podem ser definidas para configurar a geração de relatórios de falha.

servercrashupload.enabled

Padrão: `false`.

Defina como `true` para habilitar a geração de relatórios de falha.

servercrashupload.scheduled\_time

Padrão: `1:00:00 UTC`

Especifica o horário agendado para iniciar o envio de falhas. Insira a hora no formato de 24 horas.

servercrashupload.proxy\_server\_host

Caso sua empresa use um servidor proxy para se conectar à Internet, especifique o nome do host.

servercrashupload.proxy\_server\_port

Caso sua empresa use um servidor proxy para se conectar à Internet, especifique o número da porta.

servercrashupload.proxy\_server\_username

Se o servidor proxy exigir a autenticação, especifique o nome de usuário com essa chave.

servercrashupload.proxy\_server\_password

Se o servidor proxy exigir a autenticação, especifique a senha com essa chave.

servercrashupload.preserve\_upload\_packages

Padrão: `false`.

Para salvar todos os pacotes criados para a geração de relatórios de falha, defina a chave como `true`.

Por padrão, todos os pacotes são salvos em `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\clustercontroller\tabcrashreporter`.

servercrashupload.delete\_completed\_dumps

Padrão: `false`.

Para excluir todos os despejos após o envio, defina esta chave como `true`.

<!-- document id=28de10127f70e34b38458f6e7eabb8f0089d5e9a7759528369395b2f2f50b24a url=/tableau/current/pt-br/server/config_smtp.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o SMTP

O Tableau Server pode enviar e-mail aos administradores do servidor sobre falhas no sistema e aos usuários do servidor sobre exibições em que estão inscritos e alertas. No entanto, primeiro é necessário configurar o servidor SMTP que o Tableau Server usa para enviar e-mail. Após configurar o SMTP, conclua as etapas para configurar notificações ([Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm)). Em seguida, ao iniciar ou reiniciar o servidor, ele acionará uma notificação de e-mail, o que confirma que as notificações foram configuradas corretamente.

Configurar o SMTP requer reiniciar os serviços do Tableau Server.

## SMTP seguro

Para habilitar e configurar TLS para SMTP, você deve usar a CLI do TSM, conforme descrito neste tópico. O Tableau Server só é compatível com STARTTLS (TLS oportunista ou explícito).

Se a sua organização não usar certificados públicos para verificar conexões TLS, você poderá carregar um certificado privado ao Tableau Server para verificar conexões confiáveis. Para obter mais informações, consulte o comando [tsm security custom-cert add](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#custom-cert-add).

Você também pode configurar o SMTP TLS para criptografia, somente desabilitando o processo de validação de certificado. Para obter mais informações, consulte a seção, _Referência do arquivo de configuração_, na guia _Usar o CLI do TSM_ abaixo.

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique em Notificações na guia Configuração e clique em Servidor de e-mail.
3. Insira as informações de configuração do SMTP da sua empresa:
4. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
5. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
6. Clique em Aplicar alterações e reiniciar.
7. Execute o `tsm email test-smtp-connection` para exibir e verificar a configuração da conexão. Consulte [tsm email test-smtp-connection](https://help.tableau.com/current/server/pt-br/cli_email.htm#tsm).

Para a configuração inicial do SMTP, recomendamos o uso do modelo de arquivo de configuração abaixo para criar o arquivo json. Além disso, é possível definir qualquer chave de configuração única listada abaixo com a sintaxe descrita em [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet).

1. Copie o modelo json abaixo em um arquivo.
    
    **Importante**: o modelo abaixo inclui opções comuns para a maioria das implantações. Depois de copiar o modelo para um arquivo de texto, você deve editar os valores de opção dos requisitos do servidor SMTP. Talvez seja necessário remover ou adicionar opções. Consulte a seção de referência a seguir para obter mais informações sobre as opções principais do SMTP compatíveis.
    
    {
    "configKeys": {
    	"svcmonitor.notification.smtp.server": "_SMTP server host name_",
    	"svcmonitor.notification.smtp.send\_account": "_SMTP user name_",
    	"svcmonitor.notification.smtp.port": 443,
    	"svcmonitor.notification.smtp.password": "_SMTP user account password_",
    	"svcmonitor.notification.smtp.ssl\_enabled": true,
    	"svcmonitor.notification.smtp.from\_address": "_From email address_",
    	"svcmonitor.notification.smtp.target\_addresses": "_To email address1,address2_",
    	"svcmonitor.notification.smtp.canonical\_url": "_Tableau Server URL_"
    	}
    }
2. Execute `tsm settings import -f file.json` para passar o arquivo json com os valores adequados ao Tableau Services Manager e configurar o Tableau Server para SMTP. O Tableau Services Manager validará os valores da entidade.
3. Execute o comando `tsm pending-changes apply` para aplicar as alterações. Consulte [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply).
4. Execute o `tsm email test-smtp-connection` para exibir e verificar a configuração da conexão. Consulte [tsm email test-smtp-connection](https://help.tableau.com/current/server/pt-br/cli_email.htm#tsm).

### Referência de configuração de CLI do SMTP

Esta tabela lista todas as opções que podem ser usadas para configurar o SMTP com CLI do TSM.

<table style="width: 100%;" class="simple-table"><thead><tr><th>Opção</th><th>Descrição</th></tr></thead><tbody><tr><td><code>svcmonitor.notification.smtp.server</code></td><td>Endereço do servidor SMTP.<p>Exemplo:</p><p><code>"svcmonitor.notification.smtp.server": "mail.example.com"</code></p></td></tr><tr><td><code>svcmonitor.notification.smtp.send_account</code></td><td>Nome de usuário da conta SMTP.</td></tr><tr><td><code>svcmonitor.notification.smtp.port</code></td><td>Número de porta do servidor SMTP. O padrão é 25.</td></tr><tr><td><code>svcmonitor.notification.smtp.password</code></td><td>Senha da conta do servidor SMTP.<p>Exemplo:</p><p><code>"svcmonitor.notification.smtp.password":"password"</code></p></td></tr><tr><td><code>svcmonitor.notification.smtp.ssl_enabled</code></td><td>Especifica se a conexão com o servidor SMTP é criptografada. O valor padrão é false.</td></tr><tr><td><code>svcmonitor.notification.smtp.ssl_required</code></td><td><p>Se habilitado, o Tableau Server se recusará a se conectar a servidores SMTP sem usar TLS. A opção <code>svcmonitor.notification.smtp.ssl_enabled</code> também deve ser definida como true.</p><p>O valor padrão é false.</p></td></tr><tr><td><code>svcmonitor.notification.smtp.ssl_check_server_identity</code></td><td><p>Se definido como true, o Tableau Server verificará a identidade do servidor SMTP, conforme especificado por <a href="http://www.ietf.org/rfc/rfc2595.txt" target="_blank">RFC 2595</a>. Essas verificações adicionais com base no conteúdo do certificado do servidor destinam-se a evitar ataques man-in-the-middle.</p><p>O valor padrão é false.</p></td></tr><tr><td><code>svcmonitor.notification.smtp.ssl_trust_all_hosts
						</code></td><td><p>Ao usar TLS, há certificados de confiança de todos os servidores de e-mail, ignorando a validade da cadeia de confiança do certificado. Ao definir essa chave como true, o TLS será usado somente para criptografar o tráfego para o host SMTP.</p><p>O valor padrão é false.</p></td></tr><tr><td><code>svcmonitor.notification.smtp.ssl_ciphers
						</code></td><td><p>Os conjuntos padrão e com suporte de pacotes de codificação são definidos pela versão do JDK instalada com o Tableau Server. Consulte a seção a seguir, <a href="#TLS_ciphers" class="xref">Criptografias do TLS</a>, para obter uma lista de criptografias compatíveis e padrão.</p><p>Para atualizar os pacotes de criptografia usados pelo Tableau Server para conexões SMTP TLS, insira uma lista de pacotes de criptografia separados por espaço em branco para esse valor. Por exemplo, <code>"TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 TLS_DHE_DSS_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384"</code>.</p></td></tr><tr><td><code>svcmonitor.notification.smtp.ssl_versions
						</code></td><td><p>As versões padrão do TLS permitidas nesta versão do Tableau Server são TLSv1, TLSv1.1, TLSv1.2 e TLSv1.3.</p><p>O suporte à versão TLS é definido pela versão do JDK instalada com o Tableau Server.</p><p>As versões com suporte do TLS são <code>SSLv2Hello, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3</code>.</p><p>Para atualizar as versões usadas pelo Tableau Server para conexões SMTP TLS, insira uma lista de versões separadas por espaço em branco para esse valor. Por exemplo, <code>"TLSv1.2 TLSv1.3"</code>.</p></td></tr><tr><td><code>svcmonitor.notification.smtp.from_address</code></td><td>O endereço de e-mail que enviará uma notificação se houver falha do sistema. O endereço de e-mail deve ter uma sintaxe válida (por exemplo, ITalerts@bigco.com ou noreply@mycompany), mas não precisa ser uma conta de e-mail real no Tableau Server. (No entanto, alguns servidores SMTP talvez precisem de uma conta de e-mail real.)<p class="note"><strong>Observação:</strong> é possível substituir o endereço de e-mail em todo o sistema site por site. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/sites.htm" class="xref">O que é um site</a>.</p><p>Exemplo:</p><p><code>"svcmonitor.notification.smtp.from_address": "donot-reply@example.com"</code></p></td></tr><tr><td><code>svcmonitor.notification.smtp.target_addresses</code></td><td>Endereço de e-mail para receber notificações. Se as notificações de e-mail estiverem habilitados, será necessário incluir pelo menos um endereço. Separe vários endereços por vírgulas.<p>Exemplo:</p><p><code>"svcmonitor.notification.smtp.target_addresses": "iluvdata@example.com"</code></p></td></tr><tr><td><code>svcmonitor.notification.smtp.canonical_url</code></td><td>URL do Tableau Server. Insira <code>http://</code> ou <code> https://</code>, seguido do nome ou endereço IP do Tableau Server. Usada no rodapé do e-mail de assinatura.<p>Exemplo:</p><p><code>"svcmonitor.notification.smtp.canonical_url": "http://myserver.example.com"</code></p></td></tr></tbody></table>

### Criptografias do TLS

Veja a seguir uma lista de criptografias do TLS compatíveis com o JDK incluído no Tableau Server. Nesta versão do Tableau Server, todas essas criptografias são habilitadas por padrão. Você pode especificar uma lista personalizada de criptografias para o seu SMTP, ao inserir uma lista separada por espaço em branco com a opção, `svcmonitor.notification.smtp.ssl_ciphers`, conforme descrito na tabela acima.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>TLS_RSA_WITH_AES_128_CBC_SHA256</p></td><td><p>TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384</p></td></tr><tr><td><p>TLS_DHE_DSS_WITH_AES_256_GCM_SHA384</p></td><td><p>TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256</p></td></tr><tr><td><p>TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384</p></td><td><p>TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA</p></td></tr><tr><td><p>TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA</p></td><td><p>TLS_RSA_WITH_AES_256_CBC_SHA256</p></td></tr><tr><td><p>TLS_RSA_WITH_AES_128_GCM_SHA256</p></td><td><p>TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384</p></td></tr><tr><td>TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256</td><td><p>TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256</p></td></tr><tr><td><p>TLS_DHE_DSS_WITH_AES_128_CBC_SHA256</p></td><td><p>TLS_DHE_DSS_WITH_AES_256_CBC_SHA</p></td></tr><tr><td><p>TLS_DHE_RSA_WITH_AES_128_CBC_SHA256</p></td><td>TLS_DHE_RSA_WITH_AES_256_CBC_SHA256</td></tr><tr><td><p>TLS_RSA_WITH_AES_256_GCM_SHA384</p></td><td><p>TLS_EMPTY_RENEGOTIATION_INFO_SCSV</p></td></tr><tr><td><p>TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384</p></td><td><p>TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA</p></td></tr><tr><td><p>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA</p></td><td><p>TLS_DHE_DSS_WITH_AES_256_CBC_SHA256</p></td></tr><tr><td><p>TLS_RSA_WITH_AES_256_CBC_SHA</p></td><td><p>TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256</p></td></tr><tr><td><p>TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256</p></td><td><p>TLS_DHE_RSA_WITH_AES_256_CBC_SHA</p></td></tr><tr><td><p>TLS_DHE_DSS_WITH_AES_128_GCM_SHA256</p></td><td><p>TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256</p></td></tr><tr><td><p>TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384</p></td><td><p>TLS_ECDH_RSA_WITH_AES_128_CBC_SHA</p></td></tr><tr><td><p>TLS_DHE_RSA_WITH_AES_256_GCM_SHA384</p></td><td><p>TLS_DHE_RSA_WITH_AES_128_CBC_SHA</p></td></tr><tr><td>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256</td><td>TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA</td></tr><tr><td>TLS_DHE_RSA_WITH_AES_128_GCM_SHA256</td><td><p>TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256</p></td></tr><tr><td>TLS_ECDH_RSA_WITH_AES_256_CBC_SHA</td><td><p>TLS_DHE_DSS_WITH_AES_128_CBC_SHA</p></td></tr><tr><td>TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA</td><td><p>TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384</p></td></tr><tr><td>TLS_RSA_WITH_AES_128_CBC_SHA</td><td>TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384</td></tr><tr><td>TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384</td><td>TLS_AES_256_GCM_SHA384</td></tr><tr><td>TLS_AES_128_GCM_SHA256</td><td>&nbsp;</td></tr></tbody></table>

<!-- document id=50f20f6910cb75111fba790ba1cc878a53010084d03837dce30a9a070062c32e url=/tableau/current/pt-br/server/ssl_config.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o SSL para tráfego de HTTP externo e do Tableau Server

Configure o Tableau Server para usar comunicações criptografadas por SSL (Secure Sockets Layer) em todo o tráfego HTTP externo. A configuração do SSL garante que o acesso ao Tableau Server seja seguro e que as informações confidenciais transmitidas entre o servidor e os clientes do Tableau (como Tableau Desktop, API REST, extensão do Analytics e assim por diante) sejam protegidas. As etapas sobre como configurar o servidor para SSL são descritas neste tópico; no entanto, primeiro, adquira um certificado de uma autoridade confiável e depois importe os arquivos de certificado no Tableau Server.

A autenticação por SSL mútuo não é compatível com o Tableau Mobile.

## Requisitos do certificado SSL

Adquira um certificado Apache SSL de uma autoridade confiável (por exemplo, Verisign, Thawte, Comodo, GoDaddy). Você também pode usar um certificado interno emitido por sua empresa. Certificados curinga, que permitem que você use SSL com muitos nomes de host dentro do mesmo domínio, também têm suporte.

Siga as diretrizes e os requisitos ao obter um certificado SSL para comunicação externa de e para o Tableau Server:

- Todos os arquivos de certificado deve ser certificados X509 codificados por PEM válidos com a extensão `.crt`.
- Use um certificado SSL SHA-2 (256 ou 512 bits). A maioria dos navegadores não se conectam a um servidor que apresenta um certificado SHA-1.
    
    **Importante:** a partir da versão 2025.2 (Tableau Desktop), 2025.3 (Tableau Server) e de junho de 2025 (Tableau Cloud), o Tableau usa OpenSSL 3.4.x e segurança de nível 2. A segurança de nível 2 requer chaves de 2048 bits ou mais. Todas as chaves de segurança de nível 1 existentes não funcionarão mais e você precisará gerar e implantar um novo par de chaves. Se você estiver gerando chaves com pelo menos 2048 bits, conforme recomendado, nenhuma ação será necessária. Para obter mais informações, consulte [Gerar uma chave](https://help.tableau.com/current/server/pt-br/ssl_cert_create.htm#generate-key).
- Além do arquivo de certificado, você também deve adquirir o arquivo de chave de certificado SSL correspondente. O arquivo chave deve ser um arquivo chave privado RSA ou DSA (com a extensão `.key` por convenção).
    
    Você pode usar a proteção por frase secreta no arquivo de chave. A frase secreta inserida durante a configuração será criptografada em períodos de inatividade. No entanto, se você desejar usar o mesmo certificado para SSL e SAML, use um arquivo de chave que _não_ seja protegido por frase secreta.
    
    Se o seu arquivo-chave estiver protegido por senha, você deverá verificar se o algoritmo criptográfico relacionado é compatível com a versão do Tableau Server em execução. O Tableau Server usa OpenSSL para abrir arquivos de chave protegidos por senha.
    
    O Tableau Server (2022.1.17, 2022.3.9, 2023.1.5 e mais recentes) executa o OpenSSL. As versões até 2025.1.x executam o OpenSSL 3.1. A partir da versão 2025.3, o Tableau usará o OpenSSL 3.4.0, que usa chaves de segurança de nível 2 (chaves de 2048 bits ou mais).
- Arquivo da cadeia de certificados SSL: um arquivo da cadeia de certificados é necessário para o Tableau Desktop no Mac e para o Tableau Prep Builder no Windows. O arquivo em cadeia também é necessário para o aplicativo Tableau Mobile se a cadeia de certificados do Tableau Server não for confiável pelo sistema operacional iOS ou Android no dispositivo móvel.
    
    O arquivo de cadeia é uma concatenação de todos os certificados que formam a cadeia de certificados para o certificado do servidor. Todos os certificados no arquivo devem ser x509 codificados por PEM, e o arquivo deve ter a extensão `.crt` (não `.pem`).
- O Tableau Server oferece suporte a certificados curinga para diversos subdomínios.
- Verifique se o domínio, nome do host ou endereço IP que os clientes usam para se conectar ao Tableau Server está incluído no campo Nomes alternativos do assunto (SAN). Muitos clientes (navegadores do Tableau Prep, Chrome e Firefox etc.) exigem uma entrada válida no campo SAN para estabelecer uma conexão segura.

**Observação:** se você planeja configurar o Tableau Server para logon único usando SAML, consulte [Uso do certificado SSL e arquivos-chave para SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm#Cert_Name) nos requisitos do SAML para ajudar a determinar se os mesmos arquivos de certificado devem ser usados para o SSL e o SAML.

## Configurar SSL para um cluster

É possível configurar um cluster do Tableau Server para usar SSL. Se o nó inicial estiver executando o processo de gateway (o que ele faz por padrão), é necessário configurar o SSL apenas nesse nó, usando as etapas descritas neste tópico.

### SSL com vários gateways

Um cluster do Tableau Server de alta disponibilidade pode incluir diversos gateways, antecedidos por um balanceador de carga. Se estiver configurando este tipo de cluster para SSL, há as seguintes opções:

- Configurar o balanceador de carga para SSL: o tráfego é codificado dos navegadores da Web do cliente até o balanceador de carga. O tráfego do balanceador de carga para os processos de gateway do Tableau Server não é criptografado. Nenhuma configuração SSL é necessária no Tableau Server. Tudo é controlado pelo balanceador de carga.
- **Configurar o Tableau Server para SSL**: o tráfego é codificado dos navegadores da Web do cliente até o balanceador de carga e do balanceador de carga aos processos de gateway do Tableau Server. Para obter mais informações, avance para a próxima seção.

### Informações de configuração adicionais dos ambientes de cluster do Tableau Server

Quando quiser usar o SSL em todos os nós do Tableau Server que executam um processo de gateway, conclua as etapas a seguir.

1. Configure o balanceador de carga para passagem SSL.
    
    Ou então, se desejar usar uma porta diferente da 443, poderá configurar o balanceador de carga externo para encerrar a porta não padrão do cliente. Neste cenário, o próximo passo é configurar o balanceador de carga para se conectar ao Tableau Server pela porta 443. Para obter assistência, consulte a documentação fornecida sobre o balanceador de carga.
2. Confira se o certificado do SSL foi emitido com o nome de host do balanceador de carga.
3. Configure o nó do Tableau Server para o SSL.
4. Se você estiver usando SSL mútuo, faça upload do arquivo de certificado SSL CA. Consulte `[tsm authentication mutual-ssl <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMMutualSSL)`.

O certificado SSL e os arquivos de chave serão distribuídos para cada nó como parte do processo de configuração.

## Preparação do ambiente

Ao obter arquivos de certificado da CA, salve-os em um local acessível pelo Tableau Server e observe os nomes dos arquivos .crt e .key do certificado, bem como o local em que foram salvos. Será necessário fornecer essas informações para o Tableau Server ao habilitar o SSL.

## Configurar o SSL no Tableau Server

Use o método mais confortável para você.

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Na guia Configuração, selecione Segurança > SSL externo.
    
    **Observação**: se você estiver atualizando ou alterando uma configuração existente, clique em Redefinir para limpar as configurações existentes antes de prosseguir.
3. Em SSL do servidor Web externo, selecione Habilitar SSL para comunicação do servidor.
4. Faça upload do certificado e arquivos-chave e, caso necessário para seu ambiente, faça upload do arquivo de cadeia e insira a fase secreta de chave:
    
    ![Configurar captura de tela de SSL](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-ssl.png)
    
    Se você estiver executando o Tableau Server em uma implantação distribuída, esses arquivos serão automaticamente distribuídos para cada nó apropriado no cluster.
5. Clique em Salvar alterações pendentes.
6. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
7. Clique em Aplicar alterações e reiniciar.

Depois de copiar os arquivos de certificado no computador local, execute os comandos a seguir:

`tsm security external-ssl enable --cert-file <path-to-file.crt> --key-file <path-to-file.key>`

`tsm pending-changes apply`

Consulte a referência de comando em [tsm security external-ssl enable](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#external-ssl-enable) para determinar se deseja incluir opções adicionais a `external-ssl enable`. O Tableau tem recomendações específicas para a opção `--protocols`.

O comando `external-ssl enable command` importa as informações dos arquivos .crt e .key. Quando este comando é executado em um nó de um cluster do Tableau Server, ele também distribui as informações para qualquer outro nó de gateway.

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

## Redirecionamento e registros de porta

Após configurar o servidor para SSL, ele aceita solicitações para a porta não SSL (o padrão é a porta 80) e automaticamente redireciona para a porta SSL 443.

**Observação**: o Tableau Server oferece suporte apenas à porta 443 como a porta segura. Ele não pode ser executado em um computador em que qualquer outro aplicativo esteja usando a porta 443.

Os erros de SSL são registrados no seguinte local. Use esse registro para solucionar problemas de validação e criptografia:

`\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\httpd\error.log`

## Alterar ou atualizar o certificado SSL

Depois de configurar o SSL, talvez seja necessário atualizar o certificado periodicamente. Em alguns casos, talvez você precise alterar o certificado para mudanças operacionais no ambiente de TI. Em ambos os casos, você deve usar o TSM para substituir o certificado SSL que já foi configurado para SSL externo.

Não copie um novo certificado no diretório de arquivos do sistema operacional. Em vez disso, ao adicionar o certificado com a interface do usuário na Web TSM ou o comando `tsm security external-ssl enable`, o arquivo do certificado é copiado para o armazenamento de certificados apropriado. Em uma implantação distribuída, o certificado também é copiado entre os nós no cluster.

Para alterar ou atualizar o certificado SSL (e o arquivo-chave correspondente, se necessário), siga as etapas na seção anterior deste tópico, [Configurar o SSL no Tableau Server](#config-ssl).

Depois de alterar o certificado, você deve executar o `tsm pending-changes apply` para reiniciar os serviços do Tableau Server. Também recomendamos reiniciar quaisquer outros serviços no computador que usem o certificado SSL. Se estiver alterando um certificado raiz no sistema operacional, deverá reiniciar o computador.

<!-- document id=a55fca8e287dad4b8342fff1465572f4f2062e2e1ef1d62affd3c467aa7c8e54 url=/tableau/current/pt-br/server/server_tsig_configure.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o Tableau Server com Independent Gateway

Este tópico descreve como configurar o Tableau Server com Independent Gateway para diferentes cenários de conexão e para um módulo de autenticação personalizado.

Para obter o procedimento de instalação, consulte [Instalar o Tableau Server com Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_new_install.htm) .

Para obter um exemplo de implantação de ponta a ponta em execução no Tableau Server para Linux na AWS, consulte [Configuração do nível da Web](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part5.htm) no Guia de implantação corporativa.

## Comparação entre conexão direta e relé

O Independent Gateway pode se comunicar diretamente com os processos back-end do Tableau Server em várias portas. Essa comunicação é chamada conexão _direta_ .

Como alternativa, você pode configurar o Independent Gateway para retransmitir a comunicação do cliente por uma única porta para o processo de gateway no Tableau Server. Essa comunicação é chamada conexão de _relé_.

A chave de configuração de TSM que define o tipo de conexão é `gateway.tsig.proxy_tls_optional`.

As seções a seguir descrevem como essas conexões diferem e como defini-las.

### Conexão direta

Nessa configuração, o Independent Gateway se comunica diretamente com os processos de back-end no Tableau Server por meio de várias portas. Isso requer que você abra as portas entre o firewall que separa o Independent Gateway da implantação de back-end do Tableau Server.

A implementação atual do Independent Gateway não oferece suporte a conexões TLS nesses processos.

Uma conexão direta permite que o Independent Gateway se comunique com os processos de back-end do Tableau Server sem proxy por meio do processo de Gateway. A conexão direta oferece melhor desempenho do que a conexão de relé alternativa.

#### Configuração

A conexão direta é a configuração padrão. Como tal, você não precisa executar um comando para configurá-lo. No entanto, se você precisar redefinir para a conexão direta padrão, execute os seguintes comandos:

tsm configuration set -k gateway.tsig.proxy\_tls\_optional -v all --force-keys   
tsm pending-changes apply

#### Gerenciar entrada da porta

Após a instalação, o Independent Gateway deve poder se comunicar com o Tableau Server em várias portas. Essas portas são atribuídas dinamicamente durante a configuração e estão no intervalo TCP 8000-9000. As portas específicas e os processos correspondentes usados para se comunicar com o Tableau Server são gravados em um arquivo CSV no computador que executa o Independent Gateway em `TSIG_DATA/config/httpd/proxy_targets.csv`.

**Observação**: o Independent Gateway é uma implementação construída no Apache httpd. Todos os comandos TSM que fazem referência a locais de arquivos usam barras, mesmo no Windows. Esta é uma convenção de httpd do Apache.

Use `proxy_targets.csv` para definir ou automatizar a configuração de entrada de porta por meio de sua rede para o Tableau Server. Recomendamos automatizar a configuração de entrada de porta, pois as portas podem ser alteradas se a implantação do Tableau Server de topologia for alterada. Adicionar nós ou reconfigurar processos na implantação do Tableau Server acionará alterações no acesso à porta exigido pelo Independent Gateway.

### Conexão de relé

Em uma configuração de conexão de retransmissão, o Independent Gateway não se conecta diretamente aos processos de back-end. Em vez disso, o Independent Gateway retransmite a comunicação para o processo de Gateway na implantação do Tableau Server de back-end por HTTP. Esse processo de retransmissão resulta em um salto extra e, portanto, degrada o desempenho em comparação com a configuração de conexão direta.

Um benefício de configurar o Independent Gateway como uma conexão de relé é proteger o tráfego com TLS. Consulte [Configurar TLS no Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_configure_tls.htm).

#### Configuração

Para configurar o Independent Gateway para conexão de retransmissão ao Tableau Server, execute os seguintes comandos:

tsm configuration set -k gateway.tsig.proxy\_tls\_optional -v none --force-keys
tsm pending-changes apply

## Protocolo de manutenção

As conexões diretas e de retransmissão exigem comunicação com o protocolo de manutenção (HK) do Tableau Server. O processo HK mantém o estado de configuração entre a implantação do Tableau Server de back-end e o Independent Gateway. Durante a instalação, o Tableau Server deve poder se comunicar com o Independent Gateway pela porta 21319.

Detalhes de comunicação do protocolo de limpeza:

- As solicitações de HK verificam o status do Independent Gateway e atualizam a configuração conforme necessário. Não há dados do cliente nessas solicitações. As configurações não incluem senhas ou outros segredos.
- Os arquivos de configuração contêm detalhes sobre a topologia de cluster do Tableau Server para que o Independent Gateway possa executar funções de proxy reverso. A configuração da topologia de cluster pode ser considerada confidencial porque a configuração pode fornecer informações de direcionamento para um invasor. Observe que esses dados de configuração seriam úteis apenas para invasores que poderiam acessar o cluster do Tableau Server.
- Os arquivos de atualização de configuração incluem uma verificação do conteúdo hash. Isso fornece uma camada extra de segurança para validar a integridade dos arquivos de configuração usados para atualizar o Independent Gateway.

Por padrão, o processo HK usa TCP 21319.

A partir do Tableau Server 2022.1.2, o TLS é compatível com a conexão HK. Consulte [Configurar TLS no Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_configure_tls.htm).

### Alterar a porta de HK

Você pode alterar a porta usada pelo protocolo HK como parte da inicialização do Independent Gateway. Consulte [Instalar switches e propriedades para o Tableau Server Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_install_switches.htm).

Para alterar a porta após a instalação, você pode executar novamente o script de pós-instalação para fornecer um valor diferente para `TSIG_HK_PORT` . Por padrão, o script está em `C:\Program Files\Tableau\Tableau Server\independentgateway\scripts\initialize-tsig.bat`.

## Locais do arquivo de registro

As entradas de registro mais úteis no Tableau Server estão no diretório do arquivo de registro `tabadminagent` . No entanto, se você estiver executando o Tableau Server em um cluster, deverá procurar em cada instância para localizar os registros tabadminagent mais recentes.

No Independent Gateway, os seguintes arquivos de log são gravados no diretório `TSIG_DATA/logs/` .

- `access.log`: o Independent Gateway será gravado em `access.log` para registro que é gerado pela configuração httpd.conf.stub. Arquivos de registro com carimbo de data/hora (por exemplo,`access_date.log`) são gerados pela configuração de httpd.conf.
- `error.log`
- `startup.log`

Esses registros também são retransmitidos na íntegra para a implantação do Tableau Server e armazenados em subdiretórios do diretório de registros do Controlador de cluster. Desse modo, os registros do Independent Gateway são incluídos no arquivo ziplog gerado pelo comando`[tsm maintenance ziplogs](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)`.

## Solução de problemas

Para obter dicas de solução de problemas, consulte [Solução de problemas do Independent Gateway do Tableau Server](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part7.htm#troubleshooting-tableau-server-independent-gateway) no Guia de implantação corporativa (EDG). O EDG fornece exemplos de implantação do Tableau Server no Linux. As etapas de solução de problemas são úteis para as versões Windows ou Linux do Tableau Server.

## Outros artigos nesta seção

<!-- document id=f8a0a18c068a8d9dfe7346ba3e163f14160118358b2796c9a265cfd26141537e url=/tableau/current/pt-br/server/distrib_ha_external_zk.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o Tableau Server para alta disponibilidade com nós exclusivos do Serviço de coordenação

O Serviço de coordenação é criado no [Apache ZooKeeper](https://cwiki.apache.org/confluence/display/ZOOKEEPER/Index), um projeto de código-fonte aberto, e coordena atividades no servidor, garantindo quorum no caso de falha e servindo como a fonte do "truth" relacionada à topologia, a configuração e o estado do servidor. O serviço é instalado automaticamente no nó inicial do Tableau Server, mas nenhuma instância adicional é instalada ao adicionar outros nós. Como o funcionamento bem-sucedido do Tableau Server depende que o Serviço de coordenação funcione adequadamente, recomendamos que, para instalações de servidor de três ou mais nós, você adicione instâncias adicionais do Serviço de coordenação ao implantar um novo ensemble do Serviço de coordenação. Isso oferece redundância e disponibilidade aprimorada caso essa instância apresente problemas.

O Serviço de coordenação pode gerar uma grande quantidade de E/S à medida que se comunica com outros componentes do servidor, portanto, se estiver executando o Tableau Server em computadores que atendem ou excedem os requisitos mínimos de hardware, é possível instalar o Tableau Server em uma configuração que usa nós somente de Serviço de coordenação Isso significa instalar o Serviço de coordenação em nós que não executam outros processos de servidor e removê-lo de quaisquer nós que executem outros processos de servidor. Este procedimento explica como fazer isso. Você também pode executar o ensemble do Serviço de coordenação nos mesmos nós que executam outros processos do Tableau Server. Para obter detalhes sobre como fazer isso, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

## Pré-requisitos

Antes de continuar com os procedimentos nesse tópico, conclua os pré-requisitos a seguir:

- [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm) - Instale o Tableau no nó inicial.
- [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm) - Instale o Tableau em pelo menos dois nós adicionais.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

## Implantar um ensemble em nós apenas do Serviço de coordenação

Uma forma de acomodar o alto impacto de E/S do Serviço de coordenação é implantar um ensemble nos nós que executam apenas o Serviço de coordenação e o Controlador de cluster. As etapas a seguir mostram como implantar um novo ensemble do Serviço de coordenação em um cluster de vários nós já existente do Tableau Server.

**Observação:** para uma licença do Tableau Server com base em núcleo, os nós apenas do serviço de coordenação não contam em relação à contagem total dos núcleos licenciados.

1. Acrescente mais nós ao seu cluster.
    
    Consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).
2. Se você adicionou os novos nós utilizando o TSM CLI, será necessário configurá-los com o Controlador de cluster (essa etapa não será necessária se os nós foram adicionados utilizando a interface de usuário da Web do TSM, pois o Controlador de cluster é adicionado automaticamente ao adicionar um nó com a interface de usuário da Web).
    
    No nó inicial, abra um prompt de comando como um administrador.
3. No nó inicial do cluster, configure os novos nós com uma instância do Controlador de cluster:
    
    `tsm topology set-process -pr clustercontroller -n <node4> -c 1`
    
    `tsm topology set-process -pr clustercontroller -n <node5> -c 1`
    
    `tsm topology set-process -pr clustercontroller -n <node6> -c 1`
    
    Se solicitado, faça logon como administrador do TSM.
4. Aplique as alterações de configuração. 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).
    
    `tsm pending-changes apply`
    
    Um aviso sobre a implantação de um ensemble do Serviço de coordenação é exibido porque você implantou um cluster de vários nós. Se esse for o único aviso, é possível substituí-lo com segurança usando a opção `--ignore-warnings` para aplicar as alterações de configuração apesar do aviso.
    
    ```
    tsm pending-changes apply --ignore-warnings
    ```
5. Confirme se todos os nós estão sendo executados:
    
    `tsm status -v`
6. No nó inicial de um cluster, abra uma sessão de terminal e digite este comando para interromper o Tableau Server:
    
    `tsm stop`
7. Obtenha as IDs de cada nó no cluster:
    
    `tsm topology list-nodes -v`
8. Use o comando `tsm topology deploy-coordination-service` para adicionar um novo ensemble do Serviço de coordenação ao adicioná-lo a nós específicos. Especifique os nós aos quais o Serviço de coordenação deve ser adicionado. O comando também torna o novo ensemble o de “produção” (o ensemble em uso) e remove o ensemble antigo.
    
    **Observação:**um prompt "y/n” é exibido, confirmando que uma reinicialização do servidor ocorrerá. Para executar o comando sem entrada, inclua a opção `--ignore-prompt`.
    
    Por exemplo, implante o Serviço de coordenação a três nós de um cluster de seis nós:
    
    `tsm topology deploy-coordination-service -n <node4,node5,node6>`
    
    Aguarde até que o comando seja concluído e você retorne ao prompt do sistema.
9. Inicie o Tableau Server:
    
    `tsm start`

<!-- document id=e3d261e08d56bb5f27784302394f5a974947022fd2e06920d87e4b3037de6d7d url=/tableau/current/pt-br/server/openid_auth_server_config.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o Tableau Server para OpenID Connect

Este tópico descreve como configurar o Tableau Server para usar o OpenID Connect (OIDC) para logon único (SSO, Single Sign-on). Esta é uma etapa contida em um processo de várias etapas. Os tópicos a seguir fornecem informações sobre a configuração e uso de OIDC com Tableau Server.

1. Visão geral do [OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth.htm)
2. [Configurar o provedor de identidades para o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_idp_config.htm)
3. Configurar Tableau Server para OpenID Connect (você está aqui)
4. [Como fazer logon no Tableau Server usando o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_signing_in.htm)

**Observações:**

- Antes de executar as etapas descritas aqui, você deve configurar o provedor de identidade OpenID (IdP), conforme descrito em [Configurar o provedor de identidades para o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_idp_config.htm).
- Os procedimentos descritos neste tópico podem se aplicar à autenticação OIDC configurada com pools de identidades. No entanto, primeiro siga [Provisionar e autenticar usuários usando grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm) e consulte este tópico, se necessário.
- A API REST do Tableau e o tabcmd não oferecem suporte ao logon único (SSO) do OIDC. Para usar o [tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm) ou a [API REST](https://help.tableau.com/current/api/rest_api/pt-br/help.htm "Abre a ajuda da API REST em uma nova guia"), os usuários devem fazer logon no Tableau Server usando uma conta do TableauID.

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Na guia CONFIGURAÇÃO, selecione Identidade e acesso do usuário > Método de autenticação.
3. Em Método de autenticação, selecione OpenID Connect no menu suspenso.
4. Em OpenID Connect, selecione Habilitar autenticação do OpenID para o servidor.
5. Insira as informações de configuração do OpenID da sua empresa:
    
    ![Imagem de uma configuração do OpenID Connect no TSM](/tableau/current/pt-br/server/pt-br/Img/tsm_ui_oidc.png)
    
    **Observações:**
    
    - Para a **Etapa 3:** se seu provedor depender de um arquivo de configuração hospedado no computador local (em vez de um arquivo hospedado em uma URL pública), você poderá especificar o arquivo com o [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC). Use a opção `--metadata-file <file_path>` para especificar um arquivo de configuração do IdP local.
    - Para a **Etapa 4:** a partir do Tableau Server 2025.3, você pode habilitar o logout único (SLO) e especificar uma URL para redirecionar seus usuários após serem desconectados.
    - Para a Etapa 5: a partir do Tableau Server 2026.2, você pode habilitar atributos de usuário e suas funções como parte do fluxo de trabalho de autenticação OIDC. Para obter mais informações, consulte [Atributos de usuário em declarações OIDC](https://help.tableau.com/current/server/pt-br/openid_auth.htm#user_attributes).
6. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
7. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
8. Clique em Aplicar alterações e reiniciar.

O procedimento nesta seção descreve como usar a interface de linha de comando de TSM para configurar o OpenID Connect. Como alternativa, use um arquivo de configuração para a configuração inicial do OpenID Connect. Consulte [Entidade openIDSettings](https://help.tableau.com/current/server/pt-br/entity_openid.htm).

1. Use o comando `configure` de [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC) para definir as seguintes opções exigidas:
    
    - `--client-id <id>`: especifica a ID do cliente do provedor que a IdP atribuiu ao aplicativo. Por exemplo, `“xxxkjwdlnaoiloadjkwha"`.
    
    - `--client-secret <secret>`: especifica o segredo do cliente do provedor. Este é um token usado pelo Tableau para verificar a autenticidade da resposta do IdP. Este valor é um segredo e deve ser mantido em segurança. Por exemplo, `“xxxhfkjaw72123="`.
    
    - `--config-url <url>` ou `--metadata-file <file_path>`: especifica a localização do arquivo json de configuração do provedor. Se o provedor hospedar um arquivo de descoberta JSON público, use `--config-url`. Caso contrário, especifique um caminho no computador local e o nome do arquivo para `--metadata-file`.
    
    - `--return-url <url>`: a URL do servidor. É normalmente o nome público do seu servidor, como `"http://example.tableau.com"`.
    
    Por exemplo, execute o comando:
    
    `tsm authentication openid configure --client-id “xxxkjwdlnaoiloadjkwha" --client-secret “xxxhfkjaw72123=" --config-url "https://example.com/openid-configuration" --return-url "http://tableau.example.com"`
    
    **Observação:** 
    
    - Existem configurações adicionais e opcionais que podem ser definidas para o Open ID Connect usando [Entidade openIDSettings](https://help.tableau.com/current/server/pt-br/entity_openid.htm). Como alternativa, você pode usar [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC). Além disso, se for necessário configurar o mapeamento de reivindicação de IdP, consulte [Opções para openid map-claims](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#Options2).
    - A partir do Tableau Server 2025.3, você pode usar o [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC) para habilitar opcionalmente o logout único (SLO).
2. Digite o seguinte comando para habilitar o Open ID Connect:
    
    `tsm authentication openid enable`
3. Execute `tsm pending-changes apply` para aplicar as alterações.
    
    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).

## Configurar OpenID para trabalhar com um proxy de encaminhamento

Por padrão, o Tableau Server ignora as configurações de proxy e envia todas as solicitações OpenID diretamente para o IdP.

A partir do Tableau Server 2021.2.2 e versões posteriores, se o Tableau estiver configurado para usar um proxy de encaminhamento para se conectar à Internet, você pode configurar o Tableau Server para usar o host proxy e as configurações de porta para entrar em contato com o IdP OpenID.

A forma como você configura o Tableau Server é diferente, dependendo de como você implementou o proxy de encaminhamento em sua organização:

- O proxy de encaminhamento é configurado no computador Windows em que o Tableau Server está sendo executado.
- O Tableau Server envia todo o tráfego de saída diretamente para um servidor proxy de encaminhamento em execução em sua organização.

### Configuração de proxy do sistema Windows

Se a sua organização configurou o proxy de encaminhamento em cada computador Windows, use este método para usar a configuração do proxy do sistema para OpenID onTableau Server. Execute os seguintes comandos:

tsm configuration set -k tomcat.useSystemProxies -v true

tsm pending-changes apply

### Servidor proxy de encaminhamento

Use o comando,[tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet), para fazer as alterações.

- Para hosts proxy HTTPS, use os seguintes pares de chave-valor:
    
    `-k tomcat.https.proxyHost -v host.domain`
    
    `-k tomcat.https.proxyPort -v port_number`
    
    Por exemplo, se o seu servidor proxy estiver em`https://proxy.example.lan:8443`, em seguida, execute os seguintes comandos:
    
    tsm configuration set -k tomcat.https.proxyHost -v proxy.example.lan
    
    tsm configuration set -k tomcat.https.proxyPort -v 8443
    
    tsm pending-changes apply
- Para hosts proxy HTTP, use os seguintes pares de chave-valor:
    
    `-k tomcat.http.proxyHost -v host.domain`
    
    `-k tomcat.http.proxyPort -v port_number`
    
    Depois de definir essas chaves, execute`tsm pending-changes apply`.

## Personalizar e controlar o acesso aos dados usando atributos de usuário

Os atributos de usuário são metadados de usuário definidos pela sua organização. Os atributos de usuário podem ser usados para determinar o acesso em um modelo de autorização típico de controle de acesso baseado em atributos (ABAC). Os atributos de usuário podem ser qualquer aspecto do perfil do usuário, incluindo cargos, associação departamental, nível de gerenciamento etc. Eles também podem estar associados a contextos de usuário de tempo de execução, como onde o usuário está conectado ou sua preferência de idioma.

Ao incluir atributos do usuário em seu fluxo de trabalho, você pode controlar e personalizar a experiência do usuário por meio de acesso e personalização de dados.

- **Acesso aos dados**: os atributos do usuário podem ser usados para impor políticas de segurança de dados. Isso garante que os usuários vejam apenas as informações que estão autorizados a ver.
- **Personalização**: ao passar atributos de usuário como localização e função, seu conteúdo pode ser personalizado para exibir apenas as informações relevantes para o usuário que o acessa, facilitando a localização das informações de que precisa.

**Resumo das etapas para passar atributos de usuário**

O processo de habilitar atributos de usuário em um fluxo de trabalho é resumido nas seguintes etapas:

1. Habilitar a configuração de atributos de usuário
2. Incluir atributos de usuário na asserção
3. Verificar se o autor do conteúdo inclui funções de atributo de usuário e filtros relevantes
4. Revisar o conteúdo

### Etapa 1: habilitar a configuração de atributos de usuário

Por motivos de segurança, os atributos de usuário só são validados em um fluxo de trabalho de autenticação quando a configuração de atributo de usuário é habilitada por um administrador de servidor.

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Na guia CONFIGURAÇÃO, selecione Identidade e acesso do usuário > Método de autenticação.
3. Em Método de autenticação, selecione SAML no menu suspenso.
4. **Sob Etapa 8**, marque a caixa de seleção Habilitar captura de atributos do usuário durante autenticação SAML.
5. Quando terminar, faça o seguinte:
    
    1. Clique em Salvar alterações pendentes.
    2. Clique no botão Alterações o pendentes na parte superior da página.
    3. Clique em Aplicar alterações e reiniciar.

### Etapa 2: incluir o atributo de usuário na asserção

Certifique-se de que a asserção contenha os atributos de usuário.

**Observação:** os atributos na resposta SAML estão sujeitos ao limite de 4096 caracteres, com exceção dos atributos `scope` ou `scp`. Se os atributos na resposta, incluindo os atributos do usuário, excederem esse limite, o Tableau vai remover os atributos e passar o atributo `ExtraAttributesRemoved`. O autor do conteúdo pode então criar um cálculo com o atributo `ExtraAttributesRemoved` para determinar como exibir o conteúdo aos usuários quando o atributo for detectado.

**Exemplo**

Suponha que você tenha um funcionário, Fred Suzuki, que é um gerente localizado na região Sul. Você quer garantir que, quando Fred revisar relatórios, ele só consiga ver os dados da região Sul. Em um cenário como este, você pode incluir o atributo de usuário Region na resposta SAML, como no exemplo abaixo.

<saml:Assertion xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
	<saml;Issuer">https://myidp.okta.com/saml</saml:Issuer">
   <saml;Subject">
	  <saml:NameId Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"fsuzuki@example.com</saml:NameID">
   <saml:AttributeStatement xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml:Attribute Name="Region" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml:AttributeValue">South</saml:AttributeValue">
    	</saml:Attribute">
   </saml:AttributeStatement">
</saml:Assertion">

### Etapa 3: verificar se o autor do conteúdo inclui funções de atributo

Verifique se o autor do conteúdo inclui as funções de atributo do usuário e filtros relacionados para controlar quais dados podem ser exibidos em seu conteúdo. Para garantir que as asserções de atributo do usuário sejam passadas para o Tableau, o conteúdo deve conter uma das seguintes funções de atributo do usuário:

- `USERATTRIBUTE('attribute_name')`
- `USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')`

A função usada pelo autor de conteúdo depende se os atributos do usuário devem retornar um único valor ou vários. Para obter mais informações sobre essas funções e exemplos de cada uma, consulte [Funções do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm#user_attributes) na Ajuda do Tableau.

**Observações:**

- Visualização do conteúdo com essas funções não está disponível durante a criação no Tableau Desktop ou Tableau Cloud. A função retornará NULL ou FALSE. Para garantir que as funções do usuário funcionem conforme o esperado, recomendamos que o autor revise as funções após disponibilizar o conteúdo.
- Para garantir que o conteúdo seja renderizado conforme o esperado, o autor do conteúdo pode considerar a inclusão de um cálculo que use `ExtraAttributesRemoved` que 1) verifica esse atributo e 2) determina o que fazer com o conteúdo se ele existir, como exibir uma mensagem. O Tableau só adicionará o atributo `ExtraAttributesRemoved` e removerá todos os outros atributos (exceto `scp` ou `scope`) quando os atributos no SAML XML excederem 4096 caracteres. Isso é para garantir o desempenho ideal e respeitar as limitações de armazenamento.

**Exemplo**

Continuando o exemplo introduzido na [Etapa 2: incluir o atributo de usuário na asserção](#step_pass_user_attribute) acima, para passar a asserção de atributo de usuário “Region” para uma pasta de trabalho, o autor pode incluir `USERATTRIBUTEINCLUDES`. Por exemplo, `USERATTRIBUTEINCLUDES('Region', [Region])`, onde “Region” é o atributo do usuário e \[Region\] é uma coluna nos dados. Usando o novo cálculo, o autor pode criar uma tabela com dados de Gerente e Vendas. Quando o cálculo é adicionado, a pasta de trabalho retorna os valores “False” conforme esperado.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_calc_view.png)

Para mostrar apenas os dados associados à região Sul na pasta de trabalho inserida, o autor pode criar um filtro e personalizá-lo para mostrar valores quando a região Sul for “True”. Quando o filtro é aplicado, a pasta de trabalho fica em branco, conforme esperado, porque a função está retornando valores “False” e o filtro é personalizado para mostrar apenas valores “True”.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_filter_view.png)

### Etapa 4: revisar o conteúdo

Revise e valide o conteúdo.

**Exemplo**

Para concluir o exemplo da [Etapa 3: verificar se o autor do conteúdo inclui funções de atributo](#step_include_uaf) acima, você pode ver que os dados de vendas na exibição são personalizados para Fred Suzuki porque o contexto de usuário dele é a região Sul.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_embedded_view_south.png)

Os gerentes das regiões representadas na pasta de trabalho devem ver o valor associado à sua região. Por exemplo, Sawdie Pawthorne, da região Oeste, vê dados específicos para sua região.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_embedded_view_west.png)

Os gerentes cujas regiões não estão representadas na pasta de trabalho verão uma pasta de trabalho em branco.

### Problemas conhecidos e limitações

Existem alguns problemas conhecidos e limitações que você deve considerar ao trabalhar com funções de atributo do usuário.

<!-- document id=a4d4f139a8a176d20544dfc164b71fc539ad4d86b094135dac0032f2b8359c8e url=/tableau/current/pt-br/server/config_oauth_impala.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar OAuth externos para Impala

A partir do Tableau 2025.3 para Tableau Desktop e Tableau Server e 2026.1 para Tableau Cloud, você pode usar o OAuth 2.0/OIDC para federar a identidade de um provedor de identidade externo para o Impala.

Dependendo do fornecedor de identidade, existem diferentes passos necessários para configurar a integração. Esta é uma visão geral de alto nível.

## Configurar o IdP no Impala

Para obter informações sobre como configurar seu IdP no Impala, consulte [Configuração da autenticação OAuth](https://docs.cloudera.com/cdp-private-cloud-base/7.1.9/impala-secure/topics/impala-oauth.html "Link para documentos do Cloudera para configuração de OAuth no Impala") na documentação do Cloudera.

## Configurar o IDP

1. Crie clientes OAuth no IDP para Tableau Desktop e Tableau Server ou Tableau Cloud. O cliente Desktop deve ativar [`PKCE`](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce)e usar redirecionamentos de `http://localhost`.
2. Crie o arquivo de configuração do Tableau OAuth. Para obter detalhes sobre como fazer isso, consulte [Configuração e uso do OAuth](https://tableau.github.io/connector-plugin-sdk/docs/oauth) em [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "Documentação OAuth no GitHub"), e exemplos [aqui](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "Exemplos de OAuth no GitHub."). Aceitamos exemplos para outros IDPs.
    
    1. Certifique-se de prefixar as IDs de configuração do Tableau OAuth com “`custom_`”.
        
        **Observação:** as IDs de configuração do OAuth têm um limite máximo de 36 caracteres. IDs maiores que isso podem não gerar erros, mas não funcionarão.
    2. Se o seu IDP suportar porta localhost dinâmica, desative `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`. Se o seu IDP não for compatível, certifique-se de adicionar várias URLs de retorno de chamada de host local à lista de permissões no arquivo de configuração e no IDP.
3. Instale os novos arquivos de configuração do Tableau OAuth na pasta `OAuthConfigs` associada a cada aplicativo em hosts de desktop (Tableau Desktop, Tableau Prep Builder, Tableau Bridge) e em cada o site do Tableau Server e do Tableau Cloud que usará o Oauth através da página de configurações do site. Para obter mais detalhes, veja [Configurações OAuth personalizadas no Desktop](https://tableau.github.io/connector-plugin-sdk/docs/oauth#custom-oauth-configs-on-desktop) e [Clientes OAuth em nível de site](https://tableau.github.io/connector-plugin-sdk/docs/oauth#site-level-oauth-clients).

## Conectar ao Impala

O usuário deve selecionar Entrar usando OAuth, e selecione o Provedor OAuth instalado anteriormente.

![](/tableau/current/pt-br/server/pt-br/Img/impala_oauth_connect.png)

<!-- document id=8488395f0f96925b0064ed47d0e2dc816fa807b35d00aa6bae65907db510c27a url=/tableau/current/pt-br/server/config_oauth_dremio.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar OAuth para Dremio

Este tópico descreve como configurar fontes de dados do Dremio para autenticação OAuth. Execute essas etapas para cada instância do Tableau Server.

A configuração do OAuth para Dremio consiste nas seguintes tarefas:

1. Registre um cliente OAuth com Dremio.
2. Use as informações que você obteve na Etapa 1 para configurar o Tableau Server para OAuth do Dremio.
3. (Opcional) Configure o OAuth específico do site.

## Etapa 1: registrar o cliente OAuth no Dremio

Use o tópico [Provedores de identidade](https://docs.dremio.com/cloud/api/identity-providers/) na documentação do Dremio para configurar um IdP compatível com Dremio e obter o ID do cliente OAuth e os parâmetros de configuração secretos necessários para configurar o Tableau Server para OAuth do Dremio.

## Etapa 2: configurar Tableau Server para OAuth do Dremio

Para configurar o Tableau Server para OAuth do Dremio, você usará os parâmetros listados abaixo no comando tsm a seguir.

- **ID do cliente Dremio:** a ID do cliente é gerada com base no procedimento na Etapa 1. Copie este valor para `[your_client_id]` no comando tsm.
- **Segredo do cliente Dremio:** o segredo do cliente é gerado com base no procedimento na Etapa 1. Copie este valor para `[your_client_secret]` no comando tsm.
- **URL do Tableau Server:** essa é a URL do Tableau Server, como `https://myco.com`. Copie este valor para `[your_server_url]` no comando tsm.
- **ID de configuração:** este é o valor para o parâmetro `oauth.config.id` que você usará no comando tsm: `dremio`

Execute os seguintes comandos tsm para configurar o OAuth para Dremio:

`tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys`

`tsm pending-changes apply`

### Configuração de vários conectores

Se você tiver vários conectores para definir, deverá incluir todos eles em um único comando. Por exemplo: 

`tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys`

`tsm pending-changes apply`

## Configurar Oauth personalizado para um site

Você pode configurar um OAuth para Dremio personalizado para um site.

Considere configurar um cliente OAuth personalizado para 1) substituir um cliente OAuth se configurado para o servidor ou 2) ativar o suporte para conexão segura a dados que requerem clientes OAuth exclusivos.

Quando um cliente OAuth personalizado é configurado, a configuração no nível do site tem precedência sobre qualquer configuração do lado do servidor, e todas as novas credenciais OAuth criadas usam o cliente OAuth no nível do site por padrão. Nenhuma reinicialização do Tableau Server é necessária para que as configurações tenham efeito.

**Importante:** as credenciais OAuth existentes estabelecidas antes da configuração do cliente OAuth personalizado podem ser usadas temporariamente, mas tanto os administradores do servidor quanto os usuários devem atualizar suas credenciais salvas para ajudar a garantir o acesso ininterrupto aos dados.

### 1: preparar a ID do cliente OAuth, a chave secreta do cliente e a URL de redirecionamento

Antes de configurar o cliente OAuth personalizado, você precisa das informações listadas abaixo. Depois de preparar essas informações, você pode registrar o cliente OAuth personalizado para o site.

- **ID do cliente OAuth e valor do segredo do cliente:** primeiro registre o cliente OAuth com o provedor de dados (conector) para recuperar a ID do cliente e o valor do segredo gerado para o Tableau Server.
- **URL de redirecionamento:** observe a URL de redirecionamento correto. Você precisará disso durante o processo de registro na **Etapa 2** abaixo.
    
    https://<your\_server\_name>.com/auth/add\_oauth\_token
    
    Por exemplo, https://example.com/auth/add\_oauth\_token

### 2: registre a ID do cliente OAuth e a chave secreta do cliente

Siga o procedimento descrito abaixo para registrar o cliente OAuth personalizado no site.

1. Entre no site do Tableau Server usando suas credenciais de administrador acesse a página de Configurações.
2. No Registro de clientes OAuth, clique no botão Adicionar cliente OAuth.
3. Insira as informações necessárias, incluindo as informações da **Etapa 1** acima:
    
    1. Para Tipo de conexão, selecione o conector, cujo cliente OAuth personalizado você deseja configurar.
    2. URL da instância OAuth é necessária se vários clientes OAuth estiverem sendo registrados. Caso contrário, é opcional.
    3. Para ID do cliente, Segredo do cliente e URL de redirecionamento, insira as informações que você preparou na **Etapa 1** acima.
    4. Clique no botão Adicionar cliente OAuth para concluir o processo de registro.
    
    ![Um formulário para a criação de um cliente OAuth, incluindo campos para tipo de conexão, URL da instância OAuth, ID do cliente, segredo do cliente e URL de redirecionamento.](/tableau/current/pt-br/server/pt-br/Img/oauth_custom.png)
4. (Opcional) Repita a etapa 3 para todos os conectores compatíveis.
5. Clique no botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações.

### 3: validar e atualizar as credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente para usar o cliente OAuth personalizado para o site.

1. Navegue até a página Minhas configurações da conta.
2. Em Credenciais salvas para fontes de dados, faça o seguinte:
    
    1. Clique em Excluir ao lado das credenciais salvas existentes para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima.
    2. Ao lado do nome do conector, clique em Adicionar e siga as instruções para 1) conectar-se ao cliente OAuth personalizado configurado na **Etapa 2** acima e 2) salvar as credenciais mais recentes.

### 4: notificar os usuários para atualizarem as credenciais salvas

Certifique-se de notificar os usuários do seu site para atualizar suas credenciais salvas para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima. Os usuários do site podem usar o procedimento descrito em [Atualizar credenciais salvas](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm#oauth_update_credentials) para atualizar as credenciais salvas.

## Proxy de encaminhamento para autenticação OAuth

Para obter mais informações sobre como configurar um proxy de encaminhamento com autenticação OAuth para o Tableau Server (somente Windows), consulte [Configurar um proxy de encaminhamento para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm#server) na Ajuda do Tableau.

<!-- document id=dd2564cab0829a54fffd904b9567f4b3b96fe685d410b023273a9fa428efb01a url=/tableau/current/pt-br/server/config_oauth_dropbox.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar OAuth para Dropbox

Este tópico descreve como configurar fontes de dados do Dropbox para autenticação OAuth. Execute as etapas para cada instância do Tableau Server.

A configuração do OAuth para Dropbox consiste nas seguintes tarefas:

1. Crie um novo aplicativo no console do aplicativo do portal do desenvolvedor do Dropbox.
2. Usar as informações obtidas como parte da criação do novo aplicativo conectado para configurar o servidor.
3. (Opcional) Configure o OAuth específico do site.

## Etapa 1: criar um novo aplicativo

1. Faça login no console do desenvolvedor do Dropbox e escolha **Consolte do aplicativo**.
2. Clique no botão **Criar aplicativo**.
3. Configure e nomeie seu aplicativo e escolha o botão **Criar aplicativo**.
4. Depois que o aplicativo for criado, navegue até a guia Permissões e verifique se a permissão files.content.read está selecionada.
5. Navegue até a guia **Configurações** e adicione um URI de redirecionamento usando o endereço de Internet do seu Tableau Server.
6. Adicione o seguinte texto ao final do URI: auth/add\_oauth\_token. Por exemplo:
7. https://your\_server\_url.com/auth/add\_oauth\_token
8. Copie a chave do aplicativo, o segredo do aplicativo e o URI de redirecionamento na guia **Configurações**.

## Etapa 2: configurar o Tableau Server para Dropbox

No computador do Tableau Server, abra o bash shell e execute os comandos tsm a seguir:

`tsm configuration set -k oauth.dropbox.redirect_uri -v <your_authorized_redirect_uri>`

`tsm configuration set -k oauth.dropbox.client_id -v <your_app_key>`

`tsm configuration set -k oauth.dropbox.client_secret -v <your_app_secret>`

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

## Configurar Oauth personalizado para um site

Você pode configurar um OAuth para Dropbox personalizado para um site.

Considere configurar um cliente OAuth personalizado para 1) substituir um cliente OAuth se configurado para o servidor ou 2) ativar o suporte para conexão segura a dados que requerem clientes OAuth exclusivos.

Quando um cliente OAuth personalizado é configurado, a configuração no nível do site tem precedência sobre qualquer configuração do lado do servidor, e todas as novas credenciais OAuth criadas usam o cliente OAuth no nível do site por padrão. Nenhuma reinicialização do Tableau Server é necessária para que as configurações tenham efeito.

**Importante:** as credenciais OAuth existentes estabelecidas antes da configuração do cliente OAuth personalizado podem ser usadas temporariamente, mas tanto os administradores do servidor quanto os usuários devem atualizar suas credenciais salvas para ajudar a garantir o acesso ininterrupto aos dados.

### 1: preparar a ID do cliente OAuth, a chave secreta do cliente e a URL de redirecionamento

Antes de configurar o cliente OAuth personalizado, você precisa das informações listadas abaixo. Depois de preparar essas informações, você pode registrar o cliente OAuth personalizado para o site.

- **ID do cliente OAuth e valor do segredo do cliente:** primeiro registre o cliente OAuth com o provedor de dados (conector) para recuperar a ID do cliente e o valor do segredo gerado para o Tableau Server.
- **URL de redirecionamento:** observe a URL de redirecionamento correto. Você precisará disso durante o processo de registro na **Etapa 2** abaixo.
    
    https://<your\_server\_name>.com/auth/add\_oauth\_token
    
    Por exemplo, https://example.com/auth/add\_oauth\_token

### 2: registre a ID do cliente OAuth e a chave secreta do cliente

Siga o procedimento descrito abaixo para registrar o cliente OAuth personalizado no site.

1. Entre no site do Tableau Server usando suas credenciais de administrador acesse a página de Configurações.
2. No Registro de clientes OAuth, clique no botão Adicionar cliente OAuth.
3. Insira as informações necessárias, incluindo as informações da **Etapa 1** acima:
    
    1. Para Tipo de conexão, selecione o conector, cujo cliente OAuth personalizado você deseja configurar.
    2. URL da instância OAuth é necessária se vários clientes OAuth estiverem sendo registrados. Caso contrário, é opcional.
    3. Para ID do cliente, Segredo do cliente e URL de redirecionamento, insira as informações que você preparou na **Etapa 1** acima.
    4. Clique no botão Adicionar cliente OAuth para concluir o processo de registro.
    
    ![Um formulário para a criação de um cliente OAuth, incluindo campos para tipo de conexão, URL da instância OAuth, ID do cliente, segredo do cliente e URL de redirecionamento.](/tableau/current/pt-br/server/pt-br/Img/oauth_custom.png)
4. (Opcional) Repita a etapa 3 para todos os conectores compatíveis.
5. Clique no botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações.

### 3: validar e atualizar as credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente para usar o cliente OAuth personalizado para o site.

1. Navegue até a página Minhas configurações da conta.
2. Em Credenciais salvas para fontes de dados, faça o seguinte:
    
    1. Clique em Excluir ao lado das credenciais salvas existentes para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima.
    2. Ao lado do nome do conector, clique em Adicionar e siga as instruções para 1) conectar-se ao cliente OAuth personalizado configurado na **Etapa 2** acima e 2) salvar as credenciais mais recentes.

### 4: notificar os usuários para atualizarem as credenciais salvas

Certifique-se de notificar os usuários do seu site para atualizar suas credenciais salvas para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima. Os usuários do site podem usar o procedimento descrito em [Atualizar credenciais salvas](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm#oauth_update_credentials) para atualizar as credenciais salvas.

## Proxy de encaminhamento para autenticação OAuth

Para obter mais informações sobre como configurar um proxy de encaminhamento com autenticação OAuth para o Tableau Server (somente Windows), consulte [Configurar um proxy de encaminhamento para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm#server) na Ajuda do Tableau.

<!-- document id=20e71fe16567669944208238ca991fb86f79f7b18345d036a6ce2b8dbb9ce8ac url=/tableau/current/pt-br/server/config_oauth_google.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar OAuth para Google

Por padrão, os conectores Google Analytics e Google BigQuery usam chaves gerenciadas para tokens do OAuth gerados para o Tableau Server pelo provedor e compartilhadas por todos os usuários no mesmo site. As conexões do Google Drive e Google BigQuery (JDBC) usam credenciais salvas por padrão e, a partir do Tableau 2022.3, exigem que o Tableau Server seja configurado com um ID de cliente OAuth e um segredo para o Google.

Converta os conectores que usam chaves gerenciadas para usar credenciais salvas configurando o Tableau Server com um ID de cliente do OAuth e um segredo para cada conector.

Este tópico descreve como configurar suas conexões do Google para OAuth com credenciais salvas. Execute essas etapas para cada instância do Tableau Server.

Para obter mais informações sobre as chaves gerenciadas e as credenciais salvas, consulte [Conexões OAuth](https://help.tableau.com/current/server/pt-br/protected_auth.htm).

**Observações:** 

- Todos os conectores baseados no Google requerem chave gerenciada (padrão), OAuth em todo o servidor ou OAuth específico do site.
- Para usar credenciais salvas para um site, o OAuth em todo o servidor deve ser configurado primeiro.
- O OAuth em todo o servidor pode ser usado se o OAuth em todo o site estiver configurado.
- Se estiver usando OAuth específico do site, cada site deve ser configurado individualmente.
- Para oferecer suporte a prompts de conexão em tempo real, conexões de edição e criação na Web, converta as chaves gerenciadas em credenciais salvas para evitar erros.

### Resumo das etapas

Configure o OAuth seguindo estas etapas gerais:

1. Habilite o acesso à API e crie o token de acesso do Google.
2. Use as informações que você obteve na etapa 1 para configurar o Tableau Server.
3. (Opcional) Configure o OAuth específico do site.
4. Crie e edite uma fonte de dados do Google.

## Obter uma ID de cliente e habilitar as APIs do Google

**Observação** Estas etapas refletem as configurações no console da Plataforma Google Cloud no momento em que este documento foi escrito. Para obter mais informações, consulte [Using OAuth 2.0 for Web Server Applications](https://developers.google.com/accounts/docs/OAuth2WebServer) (Uso do OAuth 2.0 para aplicativos de servidor Web) na ajuda do Google Developers Console.

1. Faça logon na [Google Cloud Platform](http://cloud.google.com/) e clique em Go to my console (Ir para meu console)..
2. No menu suspenso Selecionar um projeto, selecione Criar projeto.
3. No formulário de novo projeto exibido, preencha o seguinte:
    
    - Atribua ao projeto um nome significativo que reflita a instância do Tableau Server para a qual você usará esse projeto.
    - Determine se você deseja alterar a ID do projeto.
        
        **Observação** Depois de criar o projeto, você não poderá alterar a ID do projeto. Para obter mais informações, clique nos ícones de interrogação.
        
        ![Uma caixa de diálogo para criar um novo projeto.](/tableau/current/pt-br/server/pt-br/Img/config_oauth_google3.png)
4. Abra o novo projeto, navegue até APIs e Serviços > **Tela de consentimento de OAuth** e selecione o Tipo de usuário.
5. Clique na guia **Tela de consentimento de OAuth** e insira um nome significativo para o **Nome do produto** que aparece para os usuários.
6. Clique em **Credenciais** e na guia Criar credenciais, em seguida, em ID do cliente OAuth.
7. Na tela Criar ID do cliente de OAuth, preencha os campos necessários. Siga as etapas para autorizar seus tokens OAuth:
    
    - Selecione Aplicativo Web.
    - Insira um Nome do cliente.
    - Para **Origens JavaScript autorizadas**, clique em ADD URI e insira o nome de domínio do Tableau Server usando HTTP ou HTTPs.
    - Para o **URI redirecionado autorizado**, clique em ADD URI e substitua o texto existente pelo endereço da Internet do servidor e adicione o seguinte texto ao final dele: **auth/add\_oauth\_token**. Por exemplo:
        
        `https://your_server_url.com/auth/add_oauth_token`
8. Copie o URI redirecionado autorizado e cole-o em um local que você pode acessar pelo seu computador do Tableau Server:
9. Clique em Criar.
10. Copie os seguintes valores que o Google retorna e cole-os em um local que você pode acessar pelo seu computador do Tableau Server:
    
    - ID do cliente
    - Segredo do cliente
11. Em APIs de serviços, verifique se API do BigQuery, API do Google Drive (para habilitar Planilhas Google) ou API do Analytics está habilitada. Para habilitar as APIs, clique em **ENABLE API** na parte superior da página.
    
    **Observação:** para estabelecer uma conexão entre o Tableau Server e o Google Analytics 4, você deve ativar a API Admin do Google Analytics e a API de dados do Google Analytics no console do Google. Ao adicionar essas APIs, você pode evitar possíveis erros de permissão que possam surgir durante o processo.

## Configurar o Tableau Server para OAuth do Google

Usando as informações obtidas nas etapas executadas em [Obter uma ID de cliente e habilitar as APIs do Google](#configure-google), você pode configurar Tableau Server.

- No computador do Tableau Server, abra o shell e execute os seguintes comandos para especificar o token de acesso e o URI:
    
    `tsm configuration set -k oauth.google.client_id -v <your_client_ID>`
    
    `tsm configuration set -k oauth.google.client_secret -v <your_client_secret>`
    
    `tsm configuration set -k oauth.google.redirect_uri -v <your_authorized_redirect_URI>`
    
    `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).

## Configurar Oauth personalizado para um site

Você pode configurar um cliente Google OAuth personalizado para um site.

Considere configurar um cliente OAuth personalizado para 1) substituir um cliente OAuth se configurado para o servidor ou 2) ativar o suporte para conexão segura a dados que requerem clientes OAuth exclusivos.

Quando um cliente OAuth personalizado é configurado, a configuração no nível do site tem precedência sobre qualquer configuração do lado do servidor, e todas as novas credenciais OAuth criadas usam o cliente OAuth no nível do site por padrão. Nenhuma reinicialização do Tableau Server é necessária para que as configurações tenham efeito.

**Importante:** as credenciais OAuth existentes estabelecidas antes da configuração do cliente OAuth personalizado podem ser usadas temporariamente, mas tanto os administradores do servidor quanto os usuários devem atualizar suas credenciais salvas para ajudar a garantir o acesso ininterrupto aos dados.

### 1: preparar a ID do cliente OAuth, a chave secreta do cliente e a URL de redirecionamento

Antes de configurar o cliente OAuth personalizado, você precisa das informações listadas abaixo. Depois de preparar essas informações, você pode registrar o cliente OAuth personalizado para o site.

- **ID do cliente OAuth e valor do segredo do cliente:** primeiro registre o cliente OAuth com o provedor de dados (conector) para recuperar a ID do cliente e o valor do segredo gerado para o Tableau Server.
- **URL de redirecionamento:** observe a URL de redirecionamento correto. Você precisará disso durante o processo de registro na **Etapa 2** abaixo.
    
    https://<your\_server\_name>.com/auth/add\_oauth\_token
    
    Por exemplo, https://example.com/auth/add\_oauth\_token

### 2: registre a ID do cliente OAuth e a chave secreta do cliente

Siga o procedimento descrito abaixo para registrar o cliente OAuth personalizado no site.

1. Entre no site do Tableau Server usando suas credenciais de administrador acesse a página de Configurações.
2. No Registro de clientes OAuth, clique no botão Adicionar cliente OAuth.
3. Insira as informações necessárias, incluindo as informações da **Etapa 1** acima:
    
    1. Para Tipo de conexão, selecione o conector, cujo cliente OAuth personalizado você deseja configurar.
    2. URL da instância OAuth é necessária se vários clientes OAuth estiverem sendo registrados. Caso contrário, é opcional.
    3. Para ID do cliente, Segredo do cliente e URL de redirecionamento, insira as informações que você preparou na **Etapa 1** acima.
    4. Clique no botão Adicionar cliente OAuth para concluir o processo de registro.
    
    ![Um formulário para a criação de um cliente OAuth, incluindo campos para tipo de conexão, URL da instância OAuth, ID do cliente, segredo do cliente e URL de redirecionamento.](/tableau/current/pt-br/server/pt-br/Img/oauth_custom.png)
4. (Opcional) Repita a etapa 3 para todos os conectores compatíveis.
5. Clique no botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações.

### 3: validar e atualizar as credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente para usar o cliente OAuth personalizado para o site.

1. Navegue até a página Minhas configurações da conta.
2. Em Credenciais salvas para fontes de dados, faça o seguinte:
    
    1. Clique em Excluir ao lado das credenciais salvas existentes para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima.
    2. Ao lado do nome do conector, clique em Adicionar e siga as instruções para 1) conectar-se ao cliente OAuth personalizado configurado na **Etapa 2** acima e 2) salvar as credenciais mais recentes.

### 4: notificar os usuários para atualizarem as credenciais salvas

Certifique-se de notificar os usuários do seu site para atualizar suas credenciais salvas para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2** acima. Os usuários do site podem usar o procedimento descrito em [Atualizar credenciais salvas](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm#oauth_update_credentials) para atualizar as credenciais salvas.

## Criar e editar uma fonte de dados do Google

Em seguida, você deve publicar as fontes de dados do Google no servidor. Por exemplo, consulte o tópico do Tableau Desktop, [Google BigQuery](https://help.tableau.com/current/pro/desktop/pt-br/examples_googlebigquery.htm).

Depois de publicar as fontes de dados, a etapa final será editar a conexão da fonte de dados para usar o token de acesso inserido, que foi configurado anteriormente. Consulte [Editar conexões no Tableau Server](https://help.tableau.com/current/server/pt-br/connections_modify.htm).

## Gerenciamento de tokens de acesso

Depois de configurar o servidor para OAuth, você pode permitir que os usuários gerenciem seus próprios tokens de acesso nas configurações de perfil ou pode gerenciá-los de maneira centralizada. Para obter mais informações, consulte [Permitir tokens de acesso salvos](https://help.tableau.com/current/server/pt-br/allow_saved_tokens.htm).

## Proxy de encaminhamento para autenticação OAuth

Para obter mais informações sobre como configurar um proxy de encaminhamento com autenticação OAuth para o Tableau Server (somente Windows), consulte [Configurar um proxy de encaminhamento para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm#server) na Ajuda do Tableau.

<!-- document id=055529947c80dfc8caaeebb9bb23116fa822b72b2c79cb68169769423a7e915f url=/tableau/current/pt-br/server/config_oauth_qbo.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar OAuth para QuickBooks Online do Intuit

Este tópico descreve como configurar fontes de dados do QuickBooks Online do Intuit para autenticação OAuth. Execute essas etapas para cada instância do Tableau Server.

A configuração do OAuth para QuickBooks Online consiste nas seguintes tarefas:

1. Criar um aplicativo conectado na plataforma de desenvolvedor Intuit.
2. Usar as informações obtidas como parte do aplicativo conectado para configurar o servidor.
3. (Opcional) Configure o OAuth específico do site.

## Etapa 1: criar um aplicativo Intuit

1. Faça logon na conta de desenvolvedor do Intuit e, em seguida, clique em Meus aplicativos.
2. Na seção Começar a codificação, clique em Selecionar APIs.
3. Selecione **Contabilidade** e clique em Criar aplicativo.
4. Na seção Preparar o seu aplicativo para envio, clique no link para obter as chaves de produção.
    
    **Importante:** É necessário usar as chaves de produção em vez das chaves de desenvolvimento.
5. Copie o token do aplicativo, a chave de cliente de OAuth e o segredo de cliente de OAutht.

## Etapa 2: configurar o Tableau Server para QuickBooks Online do Intuit

- No computador do Tableau Server, abra o bash shell e execute os comandos a seguir:
    
    `tsm configuration set -k oauth.quickbooks.oauth_callback_uri -v http://YOUR-SERVER/auth/add_oauth_token`
    
    `tsm configuration set -k oauth.quickbooks.consumer_key -v <your_consumer_key>`
    
    `tsm configuration set -k oauth.quickbooks.consumer_secret -v <your_consumer_secret>`
    
    `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).

## Gerenciamento de tokens de acesso

Se executar um trabalho de atualização de extração para a sua fonte de dados do QuickBooks Online, o Tableau Server tenta renovar os tokens de acesso para você. Para ajudar a garantir que os seus tokens de acesso não expirem, execute os trabalhos de atualização de extração mais de uma vez por mês. Caso contrário, os tokens de acesso do QuickBooks Online irão expirar, provocando falha nos trabalhos de atualização de extração. Se os seus tokens de acesso expirarem, edite as credenciais salvas na página Configurações.

As credenciais salvas podem ser gerenciadas centralmente pelos seus usuários. Para obter mais informações, consulte [Permitir tokens de acesso salvos](https://help.tableau.com/current/server/pt-br/allow_saved_tokens.htm).

<!-- document id=2a7fc501ed17c790dc221c2da743a0129f556bec6e98c6ad4447412c8667b4b9 url=/tableau/current/pt-br/server/activate_proxy.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar operações da chave do produto com proxy de encaminhamento

Se o computador onde o Tableau Server está instalado tiver sido configurado para se conectar com um servidor proxy de encaminhamento, será necessário executar o procedimento neste tópico para ativar, atualizar ou desativar as chaves do produto para o Tableau Server.

Como alternativa, ative uma chave do produto off-line, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

Para acessar e configurar informações da chave do produto para sua instalação do Tableau Server, o serviço do Windows, o **Controlador administrativo do Tableau Server**, deve ser executado na conta do serviço Run As. Para uma operação normal, este serviço é executado na conta de sistema do Serviço de rede. Este procedimento descreve como especificar a conta de serviço Run As como a conta temporária usada para entrar no serviço do **Controlador administrativo do Tableau Server.** Após executar a operação da chave d produto com êxito, será necessário alterar as credenciais de logon de volta para a conta de sistema do Serviço de rede.

## Antes de começar

- Se estiver executando uma instalação distribuída do Tableau Server, execute o procedimento neste tópico no nó inicial do cluster.
- Para executar este procedimento, é necessário saber o nome e senha da conta de serviço Run As. Consulte [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm).
- Revise a configuração do proxy de encaminhamento. Os procedimentos abaixo são para empresas que configuraram o proxy de encaminhamento usando as “Propriedades da Internet” no computador Windows onde o Tableau Server está em execução. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).

## Etapa 1: verificar a configuração do proxy

1. Faça logon no computador no qual o Tableau Server está instalado ou será instalado.
2. Abra a caixa de diálogo Configurações da Rede Local (LAN). (Uma forma rápida de chegar a essa caixa de diálogo é pesquisar por `Internet Options` no menu Iniciar do Windows. Na caixa de diálogo Propriedades da Internet, clique na guia Conexões e clique em Configurações LAN.)
3. Em Servidor proxy, verifique se Usar um servidor proxy para seu LAN está selecionado e se o endereço e a porta do servidor proxy foram especificados.
    
    ![Uma caixa de diálogo com opções para configurar uma rede local.](/tableau/current/pt-br/server/pt-br/Img/proxy_forward_ie_lan_settings_config.png)

## Etapa 2: alterar temporariamente a conta de logon do serviço do Controlador administrativo do Tableau Server

1. Entre no mesmo computador verificado na Etapa 1 acima,
2. Abra o Console de gerenciamento da Microsoft Serviços (Local). (Uma forma rápida de chegar a esse console é pesquisar por `Services` no menu Iniciar do Windows.)
3. Clique com o botão direito do mouse no **Controlador administrativo do Tableau Server**, clique em Propriedades. Na página **Propriedades do Controlador administrativo do Tableau Server**, clique na guia Entrar.
4. Na guia Entrar, altere `Network Service` para sua conta de serviço Run As. Insira a senha e clique em OK.
5. No Console de gerenciamento da Microsoft, em Serviços (Local), clique com o botão direito do mouse no **Controlados administrativo do Tableau Server**, em seguida clique em Reiniciar.

## Etapa 3: alterar temporariamente a conta de logon do serviço de Ativação do Tableau Server

**Observação:** esta etapa se aplica às versões: 2023.1.3 ou posterior, 2022.3.7 ou posterior, 2022.1.15 ou posterior. A partir dessas versões, o Serviço de Ativação é instalado mesmo se você estiver usando o método de ativação Herdado.

1. Entre no mesmo computador verificado na Etapa 1 acima,
2. Abra o Console de gerenciamento da Microsoft. (Uma forma rápida de chegar a esse console é pesquisar por `Services` no menu Iniciar do Windows.)
3. Clique com o botão direito do mouse no **Serviço de ativação do Tableau Server**, clique em Propriedades.
4. Na página **Propriedades do Serviço de ativação do Tableau Server**, clique na guia Entrar.
5. Na guia Entrar, altere `Local System account` para sua conta de serviço Run As. Insira a senha e clique em OK.
6. No Console de gerenciamento da Microsoft, em Serviços (Local), clique com o botão direito do mouse no **Serviço de ativação do Tableau Server**, em seguida clique em Reiniciar.

## Etapa 4: ativar, atualizar ou desativar chaves do produto do Tableau.

Enquanto o Controlador administrativo do Tableau Server estiver em execução em sua conta de serviço Run As, é possível ativar, atualizar ou desativar a chave do produto do Tableau.

- Para ativar como parte do processo de instalação, consulte [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm).
- Para atualizar uma chave do produto, consulte [Atualizar data de expiração e atributos da chave do produto](https://help.tableau.com/current/server/pt-br/license_refresh.htm).
- Para desativar uma chave do produto, consulte [tsm licenses deactivate](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMDeactivate).

## Etapa 5: reverter a conta de logon para o Serviço de rede (Controlador Administrativo)

Após concluir a operação da chave do produto, será necessário alterar a conta de logon do Controlador administrativo do Tableau Server para a conta `Network Service`.

Reverta a conta de logon do Controlador Administrativo:

1. Abra o Console de gerenciamento da Microsoft Serviços (Local).
2. Clique com o botão direito do mouse no **Controlador administrativo do Tableau Server**, clique em Propriedades. Na página **Propriedades do Controlador administrativo do Tableau Server**, clique na guia Entrar.
3. Na guia Entrar, clique no botão Navegar.
4. Na caixa de diálogo Selecionar usuário, insira `Network Service`, e cliquem em OK para solucionar o nome e retornar para a guia Entrar.
5. Na guia Entrar, limpe as senhas da conta `Network Service` e clique em OK.
6. No Console de gerenciamento da Microsoft, em Serviços (Local), clique com o botão direito do mouse no **Controlados administrativo do Tableau Server**, em seguida clique em Reiniciar.

## Etapa 6: reverter a conta de logon para a conta do sistema local (Serviço de ativação)

Se você alterou a conta de logon do Serviço de ativação do Tableau Server (Etapa 3 acima), depois de concluir a operação da chave do produto, você deverá alterar a conta de logon de volta para a conta `Network Service`.

Reverta a conta de logon do Serviço de ativação:

1. Abra o Console de gerenciamento da Microsoft Serviços (Local).
2. Clique com o botão direito do mouse em **Serviço de ativação do Tableau Server** e clique em Propriedades.
3. Na página Propriedades do Serviço de ativação do Tableau Server, clique na guia Entrar.
4. Na guia Entrar, selecione Conta do sistema local e clique OK.
5. No Console de gerenciamento da Microsoft, em Serviços (Local), clique com o botão direito do mouse no **Serviço de ativação do Tableau Server**, em seguida clique em Reiniciar.

<!-- document id=ad2db96ffcc1bb474787cc5421575e4f2f2ce802fd9746dea6fc7743cb9f33a4 url=/tableau/current/pt-br/server/ssl_config_direct_cx.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar Postgres SSL para permitir conexões diretas de clientes

Quando Tableau Server estiver configurado para usar o SSL para comunicação interna com o repositório postgres, você também pode precisar que clientes Tableau e clientes postgres externos, que se conectam diretamente ao repositório, verifiquem a identidade do repositório postgres do Tableau, comparando o certificado SSL apresentado pela instância postgres interna com o certificado distribuído ao cliente Tableau ou postgres externo.

As conexões diretas incluem as que usam o usuário **tableau** ou **readonly**. Os exemplos de clientes Tableau incluem o Tableau Desktop, o Tableau Mobile, a REST API e navegadores da Web.

1. Habilite o SSL interno para o repositório executando os seguintes comandos:
    
    `tsm security repository-ssl enable`
    
    `tsm pending-changes apply`
    
    Isso habilita o suporte ao SSL interno e gera novos arquivos de chave e certificados de servidor e exige que todos os clientes do Tableau usem o SSL para se conectar ao repositório. Para obter opções e comandos repository-ssl adicionais, consulte [tsm security](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm).
    
    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. (Opcional) Se você configurou o computador cliente para validar as conexões Postgres SSL, deve importar o certificado gerado pelo Tableau Server para os computadores que executam o Tableau Desktop. Para cada computador cliente que se conectará diretamente ao repositório, faça o seguinte:
    
    - Copie o arquivo **server.crt** para o computador cliente. É possível encontrar esse arquivo no seguinte diretório:
        
        `C:/ProgramData/Tableau/Tableau Server/data/tabsvc/config/pgsql_0.<version_code>/security`
        
        **Observação**: não copie **server.key** para o computador cliente. Esse arquivo reside apenas no servidor.
    - Importe o certificado para o armazenamento de certificados do computador.
        
        Para obter informações, use a documentação do fabricante do sistema operacional.
3. (Opcional) Configure qualquer cliente externo (não Tableau) postgres (PgAdmin ou Dbeaver, por exemplo) para verificar a identidade do repositório postgres do Tableau Server. Faça isso no driver JDBC postgresql que o cliente está usando para conectar definindo a diretiva "sslmode" para "verify-ca" ou "verify-full". As opções disponíveis podem ser diferentes dependendo da versão do driver postgres que está sendo usado. Para obter mais informações, consulte a documentação da unidade sobre o suporte ao SSL.

<!-- document id=fe3fcdfe19f121ef5f38e1bc2e14538d66bdb218d99bf01d182639731f5a73c8 url=/tableau/current/pt-br/server/projects_data_gov.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar projetos, grupos, conjuntos de grupos e permissões para o serviço de autoatendimento gerenciado

Publicar no Tableau Cloud e no Tableau Server é fácil. Para algumas organizações, pode ser fácil _demais_. Há valor em criar uma estrutura controlada antes de permitir que os Creators publiquem seu próprio conteúdo.

Para manter as coisas organizadas e garantir que as pessoas possam encontrar e acessar o conteúdo certo, pode ser útil configurar seu site para autoatendimento gerenciado. Isso significa ter diretrizes e configurações para garantir que o conteúdo seja organizado, detectável e seguro sem ter gargalos no processo de publicação.

Este artigo apresenta um caminho possível para você, como administrador do site, configurar seu site para autoatendimento gerenciado:

1. Identificar os tipos de grupos e projetos necessários
2. Criar grupos e conjuntos de grupos
3. Remover as permissões que causarão ambiguidades e estabeleça padrões de permissão padrão
4. Criar projetos
5. Bloquear permissões de projeto

**Observação:** as informações fornecidas aqui são práticas adaptadas e simplificadas dos Visionários do Tableau e dos clientes que compartilharam as suas experiências.

## Planejamento da sua estratégia

As permissões no Tableau consistem em regras aplicadas ao conteúdo (projetos, pastas de trabalho etc.) de um grupo ou usuário. Essas regras de permissão são criadas permitindo ou negando recursos específicos.

![A interface de regras de permissão mostrando vários recursos permitidos e negados](/tableau/current/pt-br/server/pt-br/Img/perms_permissionrules.png)

Ter um plano abrangente para seus projetos, grupos e regras de permissão é útil se você estiver iniciando ou fazendo alterações. Os detalhes ficam a seu critério, mas há duas práticas importantes que recomendamos para todos os ambientes:

- Gerencie permissões em projetos, não partes individuais de conteúdo.
- Atribua permissões a grupos, não a usuários individuais.

Definir permissões no nível de usuário individual e nos ativos de conteúdo individuais complica rapidamente o gerenciamento.

### Usar um modelo de permissões fechadas

Os modelos gerais para permissões são _aberto_ ou _fechado_. Em um modelo aberto, os usuários recebem um alto nível de acesso e você explicitamente nega os recursos. Em um modelo fechado, os usuários normalmente recebem apenas o acesso necessário para realizarem suas tarefas. Esse é o modelo que os profissionais de segurança defendem. Os exemplos neste tópico seguem um modelo fechado.

Para obter mais informações sobre como as permissões do Tableau são avaliadas, consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm).

## Identificar os tipos de projetos e grupos necessários

Projetar uma estrutura para acomodar conteúdo (em projetos) e categorias de usuários (como grupos) ou cateforias de grupos (em conjuntos de grupos) pode ser a parte mais desafiadora da configuração de um site, mas facilita muito o gerenciamento contínuo.

**Projetos**: os projetos funcionam tanto como uma unidade de gerenciamento de permissões quanto como uma estrutura organizacional e de navegação. Tente criar uma estrutura de projeto que equilibre como as pessoas esperam encontrar conteúdo e permita permissões lógicas.

**Grupos ou conjuntos de grupos**: antes de criar grupos, pode ser útil encontrar temas comuns sobre como as pessoas interagem com o conteúdo. Tente identificar padrões que você pode usar para grupos ou criar grupos ou conjuntos de grupos e evite permissões únicas para usuários individuais.

Exemplo 1: estrutura do projeto e do grupo

Por exemplo, vamos imaginar um ambiente onde há conteúdo de toda a empresa que todos devem poder acessar, bem como algum conteúdo de RH que precisa ser restrito.

Os projetos incluem:

- **Conferência Acme Corp.** Isso incluirá fontes de dados e pastas de trabalho para vendas de ingressos, painéis para estratégia de conteúdo e planos de projeto para a conferência da empresa.
- **Sucesso do funcionário**. Isso incluirá fontes de dados anônimas e pastas de trabalho para a pesquisa interna de funcionários
- **Recursos Humanos**. Isso incluirá fontes de dados de RH e pastas de trabalho que devem estar disponíveis apenas para membros da equipe de RH.

Em seguida, os grupos devem corresponder ao que as pessoas precisam fazer:

- **Criadores de conteúdo principal**. Este grupo é para usuários que podem publicar em projetos de nível superior e têm amplo acesso a fontes de dados, mas que não precisam mover ou gerenciar conteúdo.
- **Criadores de conteúdo de RH.** Este grupo é para usuários que têm acesso a fontes de dados de RH e podem publicar no projeto de RH.
- **Usuários corporativos.** Este grupo é para usuários que devem poder acessar o conteúdo criado pelos Core Content Creators, mas nem devem saber que o conteúdo de RH existe.
- **Usuários de RH.** Este grupo é para usuários que devem poder acessar o conteúdo no projeto de RH, mas não têm direitos para criar ou publicar conteúdo.
- **Líderes do projeto principal.** Este grupo é para usuários que devem receber o status de líder de projeto nos projetos que não são de RH.

Exemplo 2: estrutura de grupo e conjunto de grupos

A partir de Tableau Server 2024.2, você poderá usar conjuntos de grupos para controlar ainda mais os recursos concedidos (ou negados) aos usuários ativando permissões no nível do conjunto de grupos. Quando as permissões são definidas no nível do conjunto de grupos, os usuários devem pertencer a todos os grupos nos conjuntos de grupos a serem avaliados.

**Observação:** as regras de permissão definidas por grupo são avaliadas após as regras de usuário e grupo.

Por exemplo, suponha que você criou os grupos para corresponder às necessidades das pessoas no Exemplo 1 acima. Você pode criar o seguinte conjunto de grupos para bloquear ainda mais o acesso ao RH:

- **Líderes de RH.** Este conjunto de grupos consiste em criadores de conteúdo de RH e líderes de projetos principais. Somente se os usuários neste conjunto de grupos pertencerem a ambos os grupos eles receberão o status de líder do projeto, a capacidade de acessar fontes de dados confidenciais de RH e de publicar no projeto de RH.

### Considerar as funções de site

Lembre-se de que as permissões estão vinculadas ao conteúdo, não a grupos ou usuários. Isso significa que você não pode conceder permissões de **Explorar** a um grupo no vácuo. Em vez disso, o grupo pode receber permissões de **Explorar** para um projeto e seu conteúdo. As funções do site, no entanto, são fornecidas a usuários específicos e podem definir ou limitar as permissões que eles podem ter. Para obter mais informações sobre como licenças, funções de site e permissões se unem, consulte [Permissões, funções de site e licenças](https://help.tableau.com/current/server/pt-br/permission_license_siterole.htm).

## Crie os grupos e conjuntos de grupos

Embora possa ser tentador criar os grupos e projetos assim que identificar o que precisa, é importante fazer as coisas em uma determinada ordem.

**Projetos**: os projetos não devem ser criados até que o projeto Padrão tenha sido configurado corretamente (veja a próxima seção). Isso ocorre porque os projetos de nível superior usam o projeto Padrão como modelo para suas regras de permissão.

**Grupos**: os grupos precisam ser criados antes que possam ser usados para criar regras de permissão. Os usuários ainda não precisam ser adicionados aos grupos, mas podem ser. Para obter mais informações sobre como criar grupos e adicionar usuários a eles, consulte [Grupos](https://help.tableau.com/current/server/pt-br/groups.htm) e [Adicionar usuários a um grupo](https://help.tableau.com/current/server/pt-br/users_add_group.htm).

**Conjuntos de grupos**: os grupos precisam ser criados antes que possam ser usados para criar regras de permissão. Os usuários ainda não precisam ser adicionados aos grupos, mas podem ser. Para obter mais informações, consulte [Trabalhar com conjuntos de grupos](https://help.tableau.com/current/server/pt-br/group_sets.htm).

> [!TIP]
> 
> **Dica**: criar vários grupos e projetos e definir as permissões manualmente pode ser entediante. Para automatizar esses processos, bem como torná-los reproduzíveis para atualizações futuras, realize essas tarefas usando os comandos [REST API](https://help.tableau.com/current/api/rest_api/pt-br/help.htm#REST/rest_api.htm). Use os comandos [tabcmd](https://help.tableau.com/current/server-linux/pt-br/tabcmd.htm) para tarefas como adicionar ou excluir um único projeto ou grupo e adicionar usuários, mas não para definir permissões.

### Participação em vários grupos

É possível incluir os usuários nos grupos HR Content Creators e Usuários de RH no grupo Usuários corporativos. Isso facilitaria a atribuição de permissões para usuários de conteúdo principal versus usuários comerciais para a maioria do conteúdo. No entanto, nesse cenário, o grupo de usuários corporativos não pode ser negado nenhum recurso na pasta de recursos humanos sem negar os usuários de RH também. Em vez disso, o grupo de usuários corporativos teria que ser deixado como não especificado, e os grupos específicos de criadores de conteúdo de RH e usuários de RH receberiam seus recursos aplicáveis.

Isso ocorre porque as permissões do Tableau são restritivas. Se o grupo de Usuários Comerciais tiver determinados recursos negados, essa Negação substituirá a regra Permitir de outra permissão para usuários em ambos os grupos.

#### Impacto dos conjuntos de grupos

Se as permissões atribuídas estiverem habilitadas no nível do conjunto de grupos, as permissões para cada grupo no conjunto de grupos não deverão ser especificadas ou negadas para permitir o recurso.

![Fluxograma de permissões em nível de grupo.](/tableau/current/pt-br/server/pt-br/Img/perms_evalflow_basic.png "fluxograma mostrando o fluxo de avaliação para permissões efetivas")

Ao decidir como a inscrição no grupo deve ser atribuída, é importante entender como as regras de permissão são avaliadas. Para obter mais informações, consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm).

## Remover as permissões que causarão ambiguidades e estabeleça padrões de permissão padrão

Cada site tem um grupo Todos os usuários e um projeto Padrão.

**Grupo Todos os usuários**: qualquer usuário adicionado ao site se torna membro do grupo Todos os usuários automaticamente. Para evitar qualquer confusão com as regras de permissão definidas em vários grupos, é melhor remover as permissões do grupo Todos os usuários.

**Projeto padrão**: o projeto Padrão funciona como um modelo para novos projetos no site. Todos os novos projetos de nível superior terão suas regras de permissão do projeto padrão. Estabelecer padrões de permissão de linha de base no projeto Padrão significa que você terá um ponto de partida previsível para novos projetos. (Observe que os projetos aninhados herdam as regras de permissão do projeto pai, não do projeto Padrão. )

Remova a regra de permissão para o grupo Todos os usuários no projeto padrão

1. Selecione a guia Explorar para abrir o projeto de nível superior no site.
2. No menu Padrão de Ação (…) do projeto, selecionePermissões.
3. Perto do nome de grupo Todos os usuários, selecione **…**, em seguida, selecione Excluir regra....

Isso permite que você estabeleça regras de permissão para os grupos sobre os quais você tem controle total, sem nenhuma permissão conflitante atribuída a Todos os usuários. Para obter mais informações sobre como várias regras são avaliadas para determinar permissões efetivas, consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm).

### Criar regras de permissão

Agora você pode configurar os padrões básicos de permissão para o projeto padrão que todos os novos projetos de nível superior herdarão. Você pode optar por manter as regras de permissão do projeto padrão vazias e criar permissões para cada novo projeto de nível superior individualmente. No entanto, se houver regras de permissão que devam ser aplicadas à maioria dos projetos, pode ser útil defini-las no projeto Padrão.

Lembre-se de que a caixa de diálogo de permissões de um projeto contém guias para cada tipo de conteúdo. **Você deve definir permissões para cada tipo de conteúdo no nível do projeto** ou os usuários terão acesso negado a esse tipo de conteúdo. (Um recurso só é concedido a um usuário se ele tiver uma permissão expressa. Deixar um recurso como Não especificado resultará na sua rejeição. Para obter mais informações, consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm).)

Dica: sempre que você criar uma regra de permissão no nível do projeto, verifique todas as guias de tipo de conteúdo.

Criar regras de permissão conforme desejado:

1. Clique em \+ Adicionar regra de grupo/usuário e comece a digitar para procurar um nome de grupo.
2. Para cada guia, escolha um modelo existente no menu suspenso ou crie uma regra personalizada clicando nos recursos.
3. Quando concluir, clique em Salvar.

Para obter mais informações sobre configuração de permissões, consulte [Definir permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#set-permissions).

Exemplo: permissões de nível de projeto para cada tipo de conteúdo

Para o nosso exemplo, a maioria dos projetos deve estar disponível para a maioria das pessoas. Para o projeto padrão, usaremos os [modelos de regras de permissão](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm#capabilities) para dar aos criadores de conteúdo principais direitos de publicação e a todos os outros a capacidade de interagir com pastas de trabalho e nada mais.

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Grupo</td><td style="font-weight: bold;">Projetos</td><td style="font-weight: bold;">Pastas de trabalho</td><td style="font-weight: bold;">Fontes de dados</td><td style="font-weight: bold;">(Outro conteúdo)</td></tr><tr><td style="font-weight: bold;">Criadores de conteúdo principal</td><td style="text-align: center;">Publicar</td><td style="text-align: center;">Publicar</td><td style="text-align: center;">Publicar</td><td style="text-align: center;">Exibição</td></tr><tr><td style="font-weight: bold;">Criadores de conteúdo de RH</td><td style="text-align: center;">Exibição</td><td style="text-align: center;">Explorar</td><td style="text-align: center;">Exibição</td><td style="text-align: center;">Nenhum</td></tr><tr><td style="font-weight: bold;">Usuários corporativos.</td><td style="text-align: center;">Exibição</td><td style="text-align: center;">Explorar</td><td style="text-align: center;">Exibição</td><td style="text-align: center;">Nenhum</td></tr><tr><td style="font-weight: bold;">Usuários de RH.</td><td style="text-align: center;">Exibição</td><td style="text-align: center;">Explorar</td><td style="text-align: center;">Exibição</td><td style="text-align: center;">Nenhum</td></tr><tr><td style="font-weight: bold;">Líderes do projeto principal.</td><td style="text-align: center;"><a href="https://help.tableau.com/current/server/pt-br/permissions_projects.htm#set-a-project-leader">Definir como líder de projeto</a></td><td style="text-align: center;">n/a</td><td style="text-align: center;">n/a</td><td style="text-align: center;">n/a</td></tr></tbody></table>

Esse padrão segue um modelo fechado e limita as permissões ao uso básico da maioria do conteúdo para a maioria dos usuários. À medida que novos projetos de nível superior são criados, essas regras serão herdadas por padrão, mas as regras de permissão podem ser modificadas por projeto conforme necessário. Lembre-se que o projeto de **Recursos Humanos** deve ter essas permissões removidas e seu próprio padrão estabelecido.

## Criar projetos e ajustar permissões

Depois que o projeto padrão for definido com seus modelos de permissões personalizados, você poderá criar o restante de seus projetos. Para cada projeto, você pode ajustar as permissões padrão, conforme adequado.

Para criar um projeto

1. Selecione a guia Explorar para abrir o projeto de nível superior no site.
2. Na lista suspensa Novo, selecione Projeto.
3. Dê um nome ao projeto e, se desejar, descreva-o.

Pode ser útil estabelecer uma convenção de nomenclatura. Por exemplo, a estrutura básica pode ser <DepartmentPrefix><Team> - <ContentUse>; como DevOps - Monitoramento.

A descrição aparece quando você passa o mouse sobre uma miniatura do projeto e na página de Detalhes do projeto. Uma boa descrição pode ajudar os usuários a saber que estão no lugar certo.

1. [Ajuste as permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#set-permissions) conforme necessário.
    1. Abra o novo projeto.
    2. No menu Ação (...), selecione Permissões
    3. Modifique quaisquer regras de permissão, conforme desejado. _Lembre-se de verificar todas as guias de conteúdo_.

## Bloquear permissões de conteúdo

Além das regras de permissão, os projetos têm uma configuração de permissão de conteúdo. Essa configuração pode ser realizada de duas maneiras, **Bloqueada** (recomendado) ou **Personalizável**.

Bloquear um projeto é uma forma de manter a consistência e garantir que todo o conteúdo do projeto tenha permissões uniformes (por tipo de conteúdo). Um projeto personalizável permite que usuários autorizados definam regras de permissão individuais em partes do conteúdo. Para obter mais informações, consulte [Bloquear permissões de conteúdo](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#lock-content-permissions).

Independentemente da configuração de permissão de conteúdo, as permissões são sempre impostas ao conteúdo.

## Possível estruturas do projeto

Algumas organizações acham útil ter projetos que atendem a propósitos específicos. Aqui estão alguns exemplos de projetos e seus usos pretendidos. Observe que esses são modelos de exemplo e você deve sempre testar a configuração em seu ambiente.

Para obter informações sobre quais recursos estão incluídos nos modelos de regra de permissão de cada tipo de conteúdo, consulte [Recursos de permissão](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm).

Exemplos: configurações de permissão para fins específicos

#### Pastas de trabalho compartilhadas para colaboração aberta no servidor

Qualquer pessoa no departamento pode publicar no projeto de colaboração aberta, durante o desenvolvimento do conteúdo. Os colegas podem colaborar usando a edição na Web no servidor. Algumas pessoas chamam isso de área restrita, outras de “staging” e assim por diante. Neste projeto, você pode permitir a edição na Web, o salvamento, o download e assim por diante.

Aqui habilite a colaboração, além de habilitar pessoas sem o Tableau Desktop para colaborar e fornecer feedback.

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Grupo</td><td style="font-weight: bold;">Projetos</td><td style="font-weight: bold;">Pastas de trabalho</td><td style="font-weight: bold;">Fontes de dados</td><td style="font-weight: bold;">(Outro conteúdo)</td></tr><tr><td style="font-weight: bold;">Administradores de dados</td><td>Publicar</td><td>Publicar</td><td>Publicar</td><td><i>TBD</i></td></tr><tr><td style="font-weight: bold;">Analistas</td><td>Publicar</td><td>Publicar</td><td>Explorar</td><td><i>TBD</i></td></tr><tr><td style="font-weight: bold;">Usuários corporativos.</td><td>Publicar</td><td>Publicar</td><td>Explorar</td><td><i>TBD</i></td></tr></tbody></table>

Lembre-se de que alguns recursos do modelo Publicar (como Substituir) podem ser [impedidos pela função de site de um usuário,](https://help.tableau.com/current/online/pt-br/permission_license_siterole.htm) mesmo que tenham esse recurso permitido.

**Observação**: "_TBD_" indica que essas regras de permissão não são facilmente determinadas pelo cenário e podem ser definidas, mas fazem sentido para um determinado ambiente.

#### Relatórios compartilhados que não podem ser editados

Este pode ser um projeto que pessoas cujo trabalho é criar pastas de trabalho e fontes de dados (os analistas e administradores de dados) podem publicar quando desejam disponibilizar o conteúdo a usuários corporativos para visualização, com a confiança de que o trabalho não poderá ser “emprestado” ou modificado.

Para esse tipo de projeto, negue todos os recursos que permitem a edição ou a remoção de dados do servidor para reuso. Você deve permitir recursos de exibição.

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Grupo</td><td style="font-weight: bold;">Projetos</td><td style="font-weight: bold;">Pastas de trabalho</td><td style="font-weight: bold;">Fontes de dados</td><td style="font-weight: bold;">(Outro conteúdo)</td></tr><tr><td style="font-weight: bold;">Administradores de dados</td><td>Publicar</td><td><i>TBD</i></td><td>Publicar</td><td><i>TBD</i></td></tr><tr><td style="font-weight: bold;">Analistas</td><td>Publicar</td><td>Publicar</td><td>Exibição</td><td><i>TBD</i></td></tr><tr><td style="font-weight: bold;">Usuários corporativos.</td><td>Exibição</td><td>Exibição</td><td>Nenhum</td><td>Nenhum</td></tr></tbody></table>

#### Fontes de dados avaliadas para conexão de analistas

Aqui, os Administradores de dados publicariam as fontes de dados que atendem a todos os seus requisitos de dados e se tornam a “fonte de verdade” para a sua empresa. Os líderes neste projeto podem certificar essas fontes de dados, para que apareçam primeiro nos resultados de pesquisa e estejam incluídas em fontes de dados recomendadas.

Neste caso, é necessário permitir Analistas autorizados a conectar pastas de trabalho a fontes de dados neste projeto, mas não a baixar ou editá-las. Você deve negar o recurso de exibição para esse projeto ao grupo de Usuários corporativos, de modo que eles não possam nem mesmo visualizar o projeto.

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Grupo</td><td style="font-weight: bold;">Projetos</td><td style="font-weight: bold;">Pastas de trabalho</td><td style="font-weight: bold;">Fontes de dados</td><td style="font-weight: bold;">(Outro conteúdo)</td></tr><tr><td style="font-weight: bold;">Administradores de dados</td><td>Publicar</td><td><i>TBD</i></td><td>Publicar</td><td><i>TBD</i></td></tr><tr><td style="font-weight: bold;">Analistas</td><td>Exibição</td><td>Nenhum</td><td>Exibição</td><td>Nenhum</td></tr><tr><td style="font-weight: bold;">Usuários corporativos.</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td></tr></tbody></table>

#### Conteúdo inativo

Outra possibilidade é segregar pastas de trabalho e fontes de dados não usadas por um período, conforme mostrado pelas exibições administrativas. É possível fornecer aos proprietários do conteúdo um prazo antes de o conteúdo ser removido do servidor.

A sua empresa escolhe se deseja fazer isso ou excluir diretamente dos projetos em andamento. Em um ambiente ativo, não tenha medo de escolher a remoção de conteúdo não usado.

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Grupo</td><td style="font-weight: bold;">Projetos</td><td style="font-weight: bold;">Pastas de trabalho</td><td style="font-weight: bold;">Fontes de dados</td><td style="font-weight: bold;">(Outro conteúdo)</td></tr><tr><td style="font-weight: bold;">Administradores de dados</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td></tr><tr><td style="font-weight: bold;">Analistas</td><td>Exibição</td><td>Exibição</td><td><i>TBD</i></td><td><i>TBD</i></td></tr><tr><td style="font-weight: bold;">Usuários corporativos.</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td></tr></tbody></table>

#### Fonte para modelos de pasta de trabalho

Este é um projeto no qual as pessoas podem baixar, mas não podem publicar ou salvar. É nele que os publicadores autorizados ou líderes de projeto disponibilizam modelos de pastas de trabalho. Os modelos com as fontes, cores, imagens e conexões de dados aprovadas pela sua empresa podem economizar o tempo dos autores e manter os relatórios com aparência consistente.

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Grupo</td><td style="font-weight: bold;">Projetos</td><td style="font-weight: bold;">Pastas de trabalho</td><td style="font-weight: bold;">Fontes de dados</td><td style="font-weight: bold;">(Outro conteúdo)</td></tr><tr><td style="font-weight: bold;">Autor autorizado</td><td>Publicar</td><td>Publicar</td><td>Publicar</td><td><i>TBD</i></td></tr><tr><td style="font-weight: bold;">Administradores de dados</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td></tr><tr><td style="font-weight: bold;">Analistas</td><td>Exibição</td><td><p><i>Modelo</i>: explorar</p><p>+&nbsp;</p><p><i>Recurso</i>:&nbsp;baixar pasta de trabalho/salvar uma cópia</p></td><td>Exibição</td><td>Nenhum</td></tr><tr><td style="font-weight: bold;">Usuários corporativos.</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td><td>Nenhum</td></tr></tbody></table>

## Próximas etapas

Além de projetos, grupos e permissões, outros temas de governança de dados incluem:

**Educação do usuário** 

Ajuda _todos_ os usuários do Tableau a se tornarem bons administradores de dados. As empresas mais bem-sucedidas no uso do Tableau criam grupos de usuários do Tableau, conduzem sessões de treinamento regulares e assim por diante.

Para uma abordagem comum de orientação dos usuários ao site, consulte [Portais personalizados baseados em painel](https://help.tableau.com/current/server/pt-br/portal_dashboard.htm).

Para obter dicas de publicação e certificação de dados, consulte os tópicos a seguir:

- [Usar certificação para ajudar usuários a encontrar dados confiáveis](https://help.tableau.com/current/server/pt-br/datasource_certified.htm)
- [Preparação para publicação em uma pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/publish_workbooks_prepare.htm "Obtenha dicas para publicações de pasta de trabalho") (links para a Ajuda do Tableau)
- [Práticas recomendadas para fontes de dados publicadas](https://help.tableau.com/current/pro/desktop/pt-br/publish_datasources_about.htm) (links para a Ajuda do Tableau)

**Otimize a atividade de atualização e assinatura da extração**

Se o Tableau Server é usado, crie políticas para as agendas de atualização e assinatura de extração para evitar que dominem os recursos do site. As apresentações do cliente na Conferência da Tableau pela Wells Fargo e Sprint abordam em detalhes esse assunto. Além disso, consulte os tópicos em [Ajuste de desempenho](https://help.tableau.com/current/server/pt-br/perf_tuning.htm).

Se você usa o Tableau Cloud, consulte os tópicos a seguir para se familiarizar com as maneiras de atualizar extrações:

- [Manter dados atualizados](https://help.tableau.com/current/online/pt-br/to_keep_data_fresh.htm)
- [Usar o Tableau Bridge para expandir as opções de atualização de dados](https://help.tableau.com/current/online/pt-br/to_sync_local_data.htm)

**Monitoramento**

Use as exibições administrativas para prestar atenção no desempenho do site e no uso do conteúdo.

[Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm)

<!-- document id=748343041cb9ec840cdd0fed6caa6804a1ca93ff36360fbc9d96360a160a396c url=/tableau/current/pt-br/server/proxy.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar proxies e balanceadores de carga para o Tableau Server

Na maioria das empresas, o Tableau Server precisa se comunicar com a Internet. O Tableau Server foi projetado para operar dentro de uma rede interna protegida. Não configure o Tableau Server diretamente na Internet ou em um DMZ. Em vez disso, a comunicação entre a rede e a Internet deve ser mediada com servidores proxy. O Servidor proxy avançado media o tráfego de dentro da rede para os destinos na Internet. Servidores proxy reversos e balanceadores de carga medeiam o tráfego da Internet para alvos dentro da rede.

## Quem deve ler este artigo?

Este artigo é destinado a profissionais de TI com experiência em redes gerais, balanceamento de carga e soluções de proxy de gateway. O artigo descreve como e quando o Tableau precisa de acesso à Internet e descreve como configurar sua rede e o Tableau para usar servidores proxy e de balanceamento de carga para acesso de e à Internet. Há diversas soluções de terceiros disponíveis, portanto, parte do conteúdo no artigo é necessariamente genérico.

Antes de configurar um servidor proxy, consulte [Como se comunicar com a Internet](https://help.tableau.com/current/server/pt-br/plan_network.htm).

## Configurar um servidor proxy de encaminhamento

Para habilitar a comunicação do Tableau Server com a Internet, implante o Tableau Server com um servidor proxy de encaminhamento. Quando o Tableau Server precisa acessar a Internet, ele não envia a solicitação diretamente para a Internet. Em vez disso, ele envia a solicitação para o proxy de encaminhamento, que, por sua vez, encaminha a solicitação. Os proxies avançados ajudam os administradores a gerenciar o tráfego para fora da Internet, em tarefas como balanceamento de carga, bloqueio de acesso a sites etc.

Se você usa um proxy de encaminhamento, é necessário configurar os computadores que executam o Tableau Server na rede para enviar o tráfego para o proxy de encaminhamento. O Tableau Server não oferece suporte à autenticação de proxy manual ou de passagem.

Se você estiver executando a autenticação OpenID com uma solução de proxy de encaminhamento, configurações adicionais são necessárias. Consulte [Configurar OpenID para trabalhar com um proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm#Configur).

### Configuração do Tableau Server no Windows para trabalhar com um proxy de encaminhamento

As etapas para configurar as opções de Internet no computador com o Tableau Server dependem de qual cenário descreve melhor a sua empresa:

- **Sua empresa não usa uma solução de proxy de encaminhamento**. Se a empresa não estiver executando uma solução de proxy e o computador no qual você está instalando o Tableau Server puder se comunicar com a Internet, não será necessário seguir os procedimentos especificados aqui.
- **Um solução de proxy é implantada e arquivos de configuração automática definem as configurações de conexão**. Se a sua organização usa arquivos de configuração automática (como arquivos PAC ou `.ins`) para especificar informações de conexão com a Internet, é possível usar essas informações na caixa de diálogo Configurações de rede local (LAN) no Windows. Para obter mais informações, consulte [Ativar detecção e configuração automática de configurações de navegador](https://technet.microsoft.com/pt-br/library/bb496465.aspx) no site de suporte da Microsoft.
- **Uma solução de proxy está implantada, mas os arquivos de configuração automática ainda não estão implantados**. Neste cenário, ajuste as configurações de LAN no computador com Windows que executa o Tableau Server para que as conexões ao servidor proxy sejam feitas sob o contexto de segurança da conta de usuário Run As. Também é necessário configurar `localhost` e outras instâncias internas do Tableau Server como exceções.

O procedimento a seguir descreve as etapas do último cenário, uma solução de proxy sem arquivos de configuração automática, onde o Tableau Server está sendo executado no Windows Server.

**Observação**: se estiver usando uma instalação distribuída do Tableau Server, execute os seguintes procedimentos no nó inicial do servidor e em cada nó adicional.

#### Etapa 1: adicionar a conta de serviço do usuário Run As ao grupo de Administradores locais

Para realizar este procedimento, faça logon no computador com o Tableau Server como a conta de serviço Run As. Por padrão, a política "logon local" não se aplica à conta de serviço Run As. Portanto, deve-se adicionar a conta de serviço Run As temporariamente ao grupo de Administradores Locais.

Caso ainda não tenha instalado o Tableau Server no computador, consulte [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm). Caso já tenha instalado o Tableau Server e configurado a conta de serviço Run As, será possível determinar o nome da conta de serviço Run As ao fazer logon na interface do usuário na Web do Tableau Server. A conta de serviço Run As do Tableau Server está listada na guia Geral da janela Configuração. Consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).

Adicione a conta de serviço Run As ao grupo de Administradores locais usando as etapas em [Adicionar um membro a um grupo local](https://technet.microsoft.com/pt-br/library/cc739265\(v=ws.10\).aspx) no site da Microsoft. Ao terminar de configurar as informações de proxy de encaminhamento, você removerá a conta de serviço Run As do grupo Administradores locais.

#### Etapa 2: configurar o servidor proxy nas configurações de LAN do Windows

1. Com a conta de serviço Run As, faça logon no computador no qual o Tableau Server está ou será instalado.
2. Abra a caixa de diálogo Configurações da Rede Local (LAN). (Uma forma rápida de chegar a essa caixa de diálogo é pesquisar por `Internet Options` no menu Iniciar do Windows. Na caixa de diálogo Propriedades da Internet, clique na guia Conexões e clique em Configurações LAN.)
3. Em Servidor proxy, selecione Usar um servidor proxy para a rede local, digite o endereço e a porta do servidor proxy e selecione Não usar um servidor proxy para endereços locais.

![Uma caixa de diálogo com opções para configurar uma rede local.](/tableau/current/pt-br/server/pt-br/Img/proxy_forward_ie_lan_settings_config.png)

Mantenha a caixa de diálogo aberta e vá para a próxima etapa.

#### Etapa 3: adicionar exceções para ignorar o servidor proxy

Você adiciona exceções a esta configuração de proxy para garantir que toda a comunicação em um cluster do Tableau Server (se tiver um agora ou terá um posteriormente) não seja roteada para o servidor proxy.

1. Na caixa de diálogo Configurações da Rede Local (LAN), clique Avançadas. (Esta opção estará disponível somente se você selecionar a opção para usar um servidor proxy para a sua LAN.)
2. Na caixa de diálogo Configurações de Proxy, digite o seguinte no campo Exceções.
    
    - `localhost`
    - Os nomes de host do servidor e endereços IP dos outros computadores com Tableau Server no mesmo cluster.
    
    Use ponto e vírgula para separar os itens.
3. Feche a caixa de diálogo configurações de proxy e a caixa de diálogo Configurações de rede local (LAN).
4. Na caixa de diálogo Opções da Internet, clique em OK para aplicar as definições.

Mantenha-se conectado ao computador e vá para a próxima etapa.

#### Etapa 4: verificar se as configurações de proxy não estão em conflito com as variáveis de ambiente do Windows

Algumas empresas definem as configurações de proxy direto como variáveis de ambiente no sistema operacional Windows. Se essas configurações estiverem definidas no computador onde o Tableau Server é executado, verifique se não há conflito com as configurações preenchidas aqui.

Essa verificação é importante se o Tableau Server estiver habilitado para licenciamento ATR. O licenciamento ATR é habilitado por padrão no Tableau Server versão 2021.4 e posterior.

1. No computador onde o Tableau Server é executado, insira "configurações avançadas do sistema" na caixa de pesquisa e, em seguida, pressione Enter para abrir a caixa **Propriedades do sistema**.
2. Na guia **Avançado**, clique em **Variáveis de ambiente**.
3. Vá até o campo **Variáveis do sistema**.
    
    Se `http_proxy` ou `https_proxy` for especificado, verifique se os valores não estão em conflito com o endereço do servidor proxy configurado na etapa anterior.
    
    - Se as configurações existentes não forem conflitantes, vá para a "Etapa 5: testar a configuração de proxy".
    - Se as configurações existentes entrarem em conflito, crie uma nova variável chamada `no_proxy` e digite:
        
        - o nome do host, o
        - Endereço IP
        
        Por exemplo, `localhost,192.168.0.10`. Para obter mais informações, consulte o artigo MSDN da Microsoft, [Definir variáveis de ambiente](https://msdn.microsoft.com/pt-br/library/hh272656\(v=vs.120\).aspx).
4. Clique em **OK**.

#### Etapa 5: verifique se as configurações de proxy WinHTTP não estão em conflito com as configurações de LAN do Windows

Se o ATR do servidor estiver habilitado (é habilitado por padrão no Tableau Server 2021.4 ou posterior), verifique se o proxy WinHTTP está configurado e não está em conflito com as configurações de LAN do Windows.

1. Com a conta de serviço Run As, faça logon no computador no qual o Tableau Server está ou será instalado.
2. Abra o prompt de comando e use o seguinte comando para confirmar a configuração atual:
    
    `netsh winhttp show proxy`
3. Configure o proxy para WinHTTP usando um dos seguintes métodos:
    
    - Use o seguinte comando se você importar a configuração das Configurações de LAN do Windows:
        
        `netsh winhttp import proxy source=ie`
    - Use o seguinte comando para configurar o proxy WinHTTP separadamente:
        
        `netsh winhttp set proxy _<proxy server>_ _<proxy bypass list>_`
    
    Para obter mais informações, consulte [Configurar o servidor proxy manualmente usando o comando netsh](https://docs.microsoft.com/en-us/microsoft-365/security/defender-endpoint/configure-proxy-internet?view=o365-worldwide#configure-the-proxy-server-manually-using-netsh-command) no site da Microsoft.
4. Confirme se as configurações de proxy não estão em conflito com outras configurações de proxy do Windows.

#### Etapa 6: testar as configurações de proxy

Para testar as novas configurações, enquanto ainda conectado na conta de serviço Run As no computador do Tableau Server, abra um navegador da Web e teste as URLs do Tableau a seguir:

[`https://mapsconfig.tableau.com/v1/config.json`](https://mapsconfig.tableau.com/v1/config.json) e [`https://api.mapbox.com/`](https://api.mapbox.com/) solicitará que você baixe um arquivo json.

#### Etapa 7: remover a conta de serviço Run As do grupo de Administradores locais

Após testar as configurações de proxy, remova a conta de serviço Run As do grupo de Administradores locais. Deixar a conta de serviço Run As no grupo de administradores aumenta as permissões da conta de serviço Run As e coloca a segurança em risco.

Reinicie o Tableau Server para que todas as alterações sejam aplicadas.

## Gerador de relatórios de falhas do servidor

Se sua organização usar um servidor proxy para se conectar à internet, você deve configurar o gerador de relatórios de falhas do servidor do Tableau para usar o proxy. Mesmo que já tenha configurado o Tableau Server para usar um proxy, também deverá configurar o gerador de relatórios de falhas do servidor separadamente. Para configurar o proxy para o gerador de relatórios de falhas do servidor, consulte [Configurar o relato de falhas do servidor](https://help.tableau.com/current/server/pt-br/crashdata_server_config_keys.htm).

## Como um proxy reverso e um balanceador funciona com o Tableau Server

Proxies reversos e balanceadores de carga são servidores que recebem solicitações de clientes externos (Internet) e as encaminham para o Tableau Server. Essas soluções disponibilizam o Tableau Server para a Internet sem precisar expor o endereço IP individual do Tableau Server à Internet. Elas também agem como uma autenticação ou dispositivos de passagem para que os dados não sejam armazenados de forma que pessoas de fora da empresa possam acessá-los. Este requisito pode ser importante para as organizações sujeitas a várias regulamentações de privacidade, como PCI, HIPAA ou SOX.

O diagrama a seguir ilustra o caminho de comunicação quando um cliente faz uma solicitação ao Tableau Server configurado para funcionar com um proxy reverso e/ou balanceador de carga (LB)

![Diagrama do fluxo de dados entre um computador, a nuvem e um servidor.](/tableau/current/pt-br/server/pt-br/Img/everybody_client_access_reverse_proxy.PNG)

1. Um cliente externo inicia uma conexão com o Tableau Server. O cliente usa uma URL pública configurada para o servidor proxy reverso/LB, como `https://tableau.example.com`. (O cliente não sabe que está acessando um proxy reverso/LB).
2. O proxy reverso mapeia essa solicitação, por sua vez, para uma solicitação no Tableau Server. Em alguns cenários, o proxy reverso pode ser configurado para autenticar o cliente (usando SSL/TLS) como uma pré-condição para passar a solicitação ao Tableau Server.
3. O Tableau Server recebe a solicitação e envia a resposta ao proxy reverso/LB.
4. O proxy reverso/LB envia o conteúdo de volta ao cliente. No que diz respeito ao cliente, ele apenas interagiu com o Tableau Server e não tem como saber que a comunicação passou por servidor(es) intermediário(s).

## TLS/SSL

Dependendo do cenário do gateway, considere configurar o proxy reverso e os servidores de balanceamento de carga para usar TLS/SSL para qualquer tráfego externo à sua rede. Isso ajuda a garantir a privacidade, a integridade do conteúdo e a autenticação. A menos que você tenha implantado outras medidas de segurança para proteger o tráfego entre o seu gateway de internet e o Tableau Server, também recomendamos configurar o SSL entre o proxy do gateway e o Tableau Server. É possível usar certificados internos ou autoassinados para criptografar o tráfego entre Tableau Servers e outros computadores internos.

## Acesso móvel

O Tableau Server adiciona um cabeçalho X-header a todas as respostas HTTP para sessões do Tableau Mobile. Por padrão, a maioria das soluções por proxy preservarão os X-headers. Se a sua solução de gateway não preservar os cabeçalhos X, será necessário configurar o servidor proxy e o balanceador de carga para preservar o seguinte cabeçalho para todas as respostas HTTP para sessões do cliente móvel: `X-Tableau: Tableau Server`.

Se você tiver configurado a autenticação no gateway, seu servidor proxy/LB deverá responder às solicitações HTTP do Tableau Mobile com uma resposta HTTP 302. A resposta 302 deve incluir um redirecionamento para a página de logon do provedor de identidade. Para visualizar um diagrama que descreve a sequência de autenticação 302, consulte [Sequência de autenticação do Tableau Mobile](https://community.tableau.com/s/question/0D54T00000G54tDSAR/tableau-mobile-reverse-proxy-authentication-sequence) na comunidade do Tableau.

## Proxy reverso, balanceador de carga e autenticação de usuário

O Tableau Server sempre autenticará os usuários. Isso significa que, mesmo que esteja autenticando conexões de entrada no gateway de sua empresa, o Tableau Server ainda assim autenticará o usuário.

No entanto, nem todos os clientes aceitarão a autenticação do usuário com uma solução de gateway:

- Para navegadores da Web compatíveis, use SAML, OpenID Connect, Kerberos, tíquetes confiáveis ou autenticação manual com um proxy reverso/LB.
- O Tableau Mobile suporta autenticação SAML ou manual com um proxy reverso/LB. A versão de iOS do Tableau Mobile suporta o Kerberos com um proxy reverso/LB. A mesma recomendação acima se aplica.
- O Tableau Prep não aceita autenticação com um proxy reverso ou balanceador de carga. Para acesso remoto, use uma solução VPN ou configure seus serviços de gateway para rotear o tráfego do Tableau Prep diretamente para o Tableau Server para autenticação.
- O Tableau Desktop oferece suporte à autenticação com um proxy reverso, desde que um módulo de autenticação esteja executando a pré-autenticação no proxy reverso antes que o tráfego seja roteado para o Tableau Server para autenticação final. Para obter mais informações, consulte a [Parte 5 - Configurando a camada da Web](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part5.htm) do _Guia de implantação do Tableau Server Enterprise_ e [Configurar módulo de autenticação com Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_configure_auth_mod.htm) .

Se a sua empresa for autenticada com o Active Directory:

- Active Directory com Habilitar logon automático (SSPI) não é compatível com o proxy reverso.
- O Tableau Server deve ser configurado para proxy reverso antes de configurá-lo para Kerberos. Para obter mais informações, consulte [Configurar o Kerberos](https://help.tableau.com/current/server/pt-br/config_kerberos.htm).

## Configurar o Tableau Server para funcionar com um servidor proxy reverso e/ou balanceador de carga

Antes de configurar o Tableau Server, você precisará coletar as informações a seguir sobre a configuração do servidor proxy. Para configurar o Tableau Server, use o comando `tsm configuration set`. As informações de coleta obrigatória correspondem às opções necessárias ao executar `tsm`.

A maioria das seguintes opções do tsm também é usada para configurar as implantações do Tableau Server que funcionam em segundo plano a um balanceador de carga. Para obter mais informações, consulte [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm).

<table class="simple-table"><colgroup><col style="width: 25%;"><col style="width: 50%;"><col style="width: 25%;"></colgroup><thead><tr><th>Item</th><th>Descrição</th><th>Opção <code>tsm configuration set</code> correspondente</th></tr></thead><tbody><tr><td style="font-weight: normal;"><span style="font-weight: normal;">Endereço IP</span> ou <code>CNAME</code></td><td><p>Você pode inserir um endereço IP&nbsp;ou um CNAME nessa opção.</p><p>O endereço ou endereços IP públicos dos servidores proxy e do balanceador de carga. O endereço IP deve estar no formato IPv4, como <code>203.0.113.0</code>, e deve ser um IP estático.</p><p>Caso não consiga fornecer um IP estático ou, se estiver usando proxies em nuvem ou balanceadores de carga externos, é possível especificar o valor DNS de CNAME (nome canônico) que os clientes usarão para se conectar ao Tableau Server. Este valor CNAME deve ser configurado na solução de proxy reverso para se comunicar com o Tableau Server.</p></td><td><code>gateway.trusted</code></td></tr><tr><td>FQDN</td><td>O nome de domínio totalmente qualificado que as pessoas usam para acessar o Tableau Server, como <code>tableau.example.com</code>. O Tableau Server não suporta alternância de contexto para essa opção. Por exemplo, a seguinte URL não é compatível: <code>example.com/tableau</code>.</td><td><code>gateway.public.host</code></td></tr><tr><td>Não FQDN</td><td>Qualquer nome de subdomínio para o servidores LB. No exemplo <code>tableau.example.com</code>, o nome do subdomínio é <code>tableau</code>.</td><td><code>gateway.trusted_hosts</code></td></tr><tr><td>Aliases</td><td>Quaisquer nomes alternativos públicos para os servidores proxy ou LB. Na maioria dos casos, os aliases são designados usando valores CNAME. Um exemplo seria um servidor proxy <code>bigbox.example.com</code> e entradas CNAME de <code>ftp.example.com</code> e <code>www.example.com</code>.</td><td><code>gateway.trusted_hosts</code></td></tr><tr><td>Portas</td><td>Os números de porta do tráfego do cliente para o servidor de proxy reverso.</td><td><p><code>gateway.public.port</code></p></td></tr></tbody></table>

Se estiver usando uma instalação distribuída do Tableau Server, execute os seguintes comandos `tsm` no nó inicial do cluster.

1. Insira o comando a seguir para definir o FQDN que os clientes usarão para acessar o Tableau Server por meio dos servidores proxy e/ou LB, em que `name` é o FQDN:
    
    `tsm configuration set -k gateway.public.host -v "_name_"`
    
    Por exemplo, se o Tableau Server for encontrado inserindo-se `https://tableau.example.com` no navegador, digite este comando:
    
    `tsm configuration set -k gateway.public.host -v "tableau.example.com"`
2. Digite o seguinte comando para definir o endereço ou o CNAME dos servidores proxy e ou LB, em que `server_address` é o endereço IPv4 ou valor CNAME:
    
    `tsm configuration set -k gateway.trusted -v "_server_ip_address_"`
    
    Se sua organização usa vários servidores proxy e/ou servidores LB, insira vários endereços IPv4, separando-os com vírgulas. Intervalos de IP não são suportados. Para melhorar a inicialização do Tableau Server, reduza o número de entradas em `gateway.trusted`.
3. Insira o comando a seguir para especificar nomes alternativos para os servidores proxy/LB, como seus nomes de domínio totalmente qualificados, quaisquer nomes de domínio não totalmente qualificados e quaisquer aliases. Se houver mais de um nome, separe-os por vírgula.
    
    `tsm configuration set -k gateway.trusted_hosts -v "_name1_, _name2_, _name3_"`
    
    Por exemplo:
    
    `tsm configuration set -k gateway.trusted_hosts -v "proxy1.example.com, proxy1, ftp.example.com, www.example.com"`
4. Se o servidor proxy estiver usando SSL para se comunicar com a Internet, execute o seguinte comando, que diz ao Tableau que o servidor de proxy reverso está usando a porta 443 em vez da porta 80:
    
    `tsm configuration set -k gateway.public.port -v 443`
    
    **Observação**: se o servidor proxy estiver usando SSL para se comunicar com o Tableau Server, o SSL deverá ser configurado e estar habilitado no Tableau Server.
5. Insira o comando a seguir para aplicar a alteração de configuração:
    
    `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).

## Configurar o proxy reverso ou o servidor de balanceamento de carga para funcionar com o Tableau Server

Quando um cliente acessa o Tableau Server por um proxy reverso ou balanceador de carga, cabeçalhos de mensagem específicos precisam ser preservados (ou adicionados). Especificamente, todos os servidores na cadeia de mensagens precisam ser representados nas configurações `gateway.trusted` e `gateway.trusted_hosts`.

O gráfico a seguir mostra cabeçalhos de exemplo de uma cadeia de mensagens de um salto na qual um servidor proxy está se comunicando diretamente com o Tableau Server:

![Um diagrama ilustra o fluxo de dados de um cliente para o Tableau por meio de um proxy.](/tableau/current/pt-br/server/pt-br/Img/everybody_client_access_config.png)

O gráfico a seguir mostra cabeçalhos de exemplo de uma cadeia de mensagens de vários saltos, na qual a mensagem passa por dois servidores proxy antes de se conectar ao Tableau Server:

![Um diagrama dos cabeçalhos passados de um cliente, por meio de dois proxies, para o servidor.](/tableau/current/pt-br/server/pt-br/Img/proxy_reverse_headers.png)

A tabela a seguir descreve o que são esses cabeçalhos e como eles estão relacionados às definições de configuração no Tableau Server:

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 25%;"><col style="width: 50%;"><col style="width: 25%;"></colgroup><tbody><tr><td style="font-weight: bold;">Cabeçalhos</td><td><b>Descrição</b></td><td><b>Configurações relacionadas do Tableau Server</b></td></tr><tr><td><code>REMOTE_ADDR</code> e <code>X-FORWARDED-FOR</code> (<code>XFF</code>)</td><td>O Tableau Server precisa desses cabeçalhos para determinar o endereço&nbsp;IP de origem das solicitações. O cabeçalho <code>X-FORWARDED-FOR</code> precisa apresentar a cadeia de endereço IP&nbsp;para o Tableau Server na ordem em que as conexões aconteceram.</td><td>O endereço IP definido em<code>gateway.trusted</code> deve ser igual ao IP apresentado em <code>REMOTE_ADDR</code>. Se você enviar vários endereços em<code>gateway.trusted</code>, um deles deve corresponder ao IP apresentado em <code>REMOTE_ADDR</code>.</td></tr><tr><td><code>HOST</code> e <code>X-FORWARDED&nbsp;HOST</code> (<code>XFH</code>)</td><td>Esses cabeçalhos são usados para gerar links absolutos para o Tableau Server quando ele responde ao cliente. O cabeçalho <code>X-FORWARDED-HOST</code> precisa apresentar nomes de host para o Tableau Server na ordem em que as conexões aconteceram.</td><td>Os nomes de host que são apresentados no cabeçalho <code>X-FORWARDED-HOST</code> devem ser incluídos nos nomes de host especificados em <code>gateway.trusted_hosts</code>.</td></tr><tr><td><code>X-FORWARDED-PROTO</code> (<code>XFP</code>)</td><td>Este cabeçalho é necessário se o SSL estiver habilitado para o tráfego do cliente para o proxy, mas não para o tráfego do proxy para o Tableau Server. <p>Os cabeçalhos <code> X-FORWARDED-PROTO</code> são importantes para cenários em que HTTP ou HTTPS não são mantidos ao longo de cada salto da rota de mensagem. Por exemplo, se o proxy reverso necessita de SSL para solicitações externas, mas o tráfego entre o proxy reverso e o Tableau Server não está configurado para usar SSL, os cabeçalhos <code>X-FORWARDED-PROTO</code> são necessários. Algumas soluções de proxy acrescentam os cabeçalhos <code>X-FORWARDED-PROTO</code> automaticamente, enquanto outras não. Finalmente, dependendo da sua solução proxy, você pode ter que configurar o encaminhamento de porta para traduzir a solicitação da porta 443 à porta 80.</p><p>Artigo KB relacionado: <a href="https://kb.tableau.com/articles/issue/unable-to-sign-in-and-invalid-username-or-password-error-with-saml-after-upgrading?lang=pt-br" target="_blank">Erro "Não é possível fazer logon" e "Nome de usuário ou senha inválida" com SAML após atualização</a>.</p></td><td><p>A configuração de porta no proxy reverso (conexões de entrada do cliente e conexões de saída para o Tableau Server) deve ser especificada nos parâmetros correspondentes: <code>gateway.public.port</code>, que é a porta que os clientes usam para se conectar ao proxy.</p><p>Se o servidor proxy estiver usando SSL para se comunicar com o Tableau Server, o SSL deve ser configurado e habilitado no Tableau Server.</p></td></tr></tbody></table>

## Validar a configuração do proxy reverso e do balanceador de carga

Para validar a configuração do gateway para o Tableau Server, publique pastas de trabalho e fontes de dados usando a criação na Web do Tableau Server ou o Tableau Desktop. Ao se conectar por um navegador da Web com o Tableau Server na Internet, verifique se você está usando um [navegador recomendado](https://www.tableau.com/pt-br/products/techspecs#server). Publique e visualize pastas de trabalho que usam fontes de dados existentes além de uma fonte de dados publicada por você. Use os links abaixo para se familiarizar com a conexão com o Tableau Server como um usuário final.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 65%;"><col style="width: 35%;"></colgroup><tbody><tr><th>Tarefa</th><th>Documentação</th></tr><tr><td>Visão geral da criação na Web.</td><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/web_author_home.htm" target="_blank">Usar o Tableau na Web</a></td></tr><tr><td>Faça logon no Tableau Server por meio do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou de um navegador da Web.</td><td><a href="https://help.tableau.com/current/pro/online/windows/pt-br/sign_in_server.htm" target="_blank">Fazer logon no Tableau Server ou Online</a></td></tr><tr><td>Publique uma pasta de trabalho no Tableau Server.</td><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/publish_workbooks_howto.htm" target="_blank">Publicar uma pasta de trabalho</a></td></tr><tr><td>Publique uma fonte de dados.</td><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/publish_datasources.htm" target="_blank">Publicar uma fonte de dados</a></td></tr><tr><td>Abrir pasta de trabalho pelo Tableau Server.</td><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/environ_workbooksandsheets_workbooks.htm#open-from-server" target="_blank">Como abrir pastas de trabalho no servidor</a></td></tr><tr><td>Sair do Server (com o Desktop).</td><td><a href="https://help.tableau.com/current/pro/online/windows/pt-br/sign_in_server.htm" target="_blank">Fazer logon no Tableau Server ou Online</a></td></tr><tr><td>Baixar pasta de trabalho em um navegador da Web.</td><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/export.htm" target="_blank">Baixar pastas de trabalho</a></td></tr><tr><td>Verifique para certificar-se de que tabcmd (de um cliente não servidor) funciona.</td><td><a href="https://help.tableau.com/current/server/pt-br/tabcmd.htm">tabcmd</a></td></tr></tbody></table>

## Tópicos relacionados

- [Requisitos de acesso à Internet do Tableau Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_proxy.htm)
- [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm)

<!-- document id=f1210c387e5d21f22d3501f1f55152e992dd82e78427b417437d90a798c0ff6a url=/tableau/current/pt-br/server/rmt-config-index-config.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar Resource Monitoring Tool do Tableau

Esta seção inclui tópicos que fornecem informações sobre como configurar o Resource Monitoring Tool do Tableau para atender às suas necessidades.

## Outros artigos nesta seção

<!-- document id=d38603fef606490a60a0e97f27377aaeb61da6d135eb22e982ea2ebf826b62a3 url=/tableau/current/pt-br/server/saml_config_adfs_server.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar SAML com AD FS no Tableau Server

Você pode configurar o Active Directory Federation Services (AD FS) como um provedor de identidade de SAML e adicionar o Tableau Server aos aplicativos de logon único suportados. Ao integrar o AD FS com o SAML e o Tableau Server, seus usuários poderão fazer logon no Tableau Server usando suas credenciais de rede padrão.

## Pré-requisitos

Antes de configurar o Tableau Server e o SAML com o AD FS, seu ambiente deve ter o seguinte:

- Um servidor que executa Microsoft Windows Server 2008 R2 (ou posterior) com AD FS 2.0 (ou posterior) e IIS instalados.
- Recomenda-se que você proteja o seu servidor AD FS (por exemplo, utilizando um proxy reverso). Quando o seu servidor AD FS puder ser acessado fora do firewall, o Tableau poderá redirecionar os usuários à página de logon hospedada pelo AD FS.
- O certificado SSL codificado usando a codificação SHA-2 (256 ou 512 bits), e que esteja em conformidade com os requerimentos listados nas seções a seguir:
    
    - [Requisitos do certificado SSL](https://help.tableau.com/current/server/pt-br/ssl_config.htm#cert-req)
    - [Requisitos de certificado e de provedor de identidades (IdP)](https://help.tableau.com/current/server/pt-br/saml_requ.htm#Certific) do SAML

## Etapa 1: verificar a conexão SSL com o AD FS

O AD FS requer uma conexão SSL. Caso não tenha feito, conclua as etapas em [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm), usando um certificado que atenda aos requisitos especificados acima.

Como alternativa, se o Tableau Server estiver configurado para funcionar com um proxy reverso ou balanceador de carga onde o SSL está sendo encerrado (comumente chamado de descarregamento de SSL), você não precisará configurar o SSL externo.

## Etapa 2: configurar SAML no Tableau Server

Conclua as etapas em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm), baixando os metadados do Tableau Server para um arquivo XML. Nesse ponto, volte aqui e continue para a próxima seção.

## Etapa 3: configurar o AD FS para aceitar solicitações de logon do Tableau Server

**Observação:** estas etapas refletem um aplicativo de terceiros e estão sujeitas a alteração sem o nosso conhecimento.

A configuração do AD FS para aceitar as solicitações de logon do Tableau Server é um processo de várias etapas, iniciando com a importação do arquivo de metadados XML do Tableau Server para o AD FS.

1. Realize uma das seguintes ações para abrir o **Assistente de confiança de terceira parte confiável**:

Windows Server 2008 R2:

1. Selecione **menu Iniciar** \> **para Ferramentas administrativas**\> **AD FS 2.0**.
2. No **AD FS 2.0**, em **Relacionamentos Confiáveis**, clique com o botão direito do mouse na pasta **Confianças de Terceira Parte Confiável** e, em seguida, clique em **Adicionar Confiança de Terceira Parte Confiável**.

Windows Server 2012 R2:

1. Abra o **Gerenciador de servidores** e, em seguida, no menu **Ferramentas**, clique em **Gerenciamento do AD FS**.
2. Em **Gerenciamento do AD FS**, no menu **Ação**, clique em **Adicionar Confiança de Terceira Parte Confiável**.

6. No **Assistente Adicionar Terceira Parte Confiável**, clique em **Iniciar**.
7. Na página **Selecionar fonte de dados**, selecione **Importar dados sobre a parte confiável de um arquivo** e clique em **Procurar** para encontrar o arquivo de metadados XML do Tableau Server. Por padrão, esse arquivo é chamado **samlspmetadata.xml**.
8. Clique em **Avançar** e na página **Especificar nome de exibição**, digite um nome e uma descrição para a confiança da parte confiável nas caixas **Nome de exibição** e **Observações**.
9. Clique em Avançar para ignorar a página **Configurar autenticação multifator agora**.
10. Clique em Avançar para ignorar a página **Escolher regras de autorização de emissão**.
11. Clique em Avançar para ignorar a página **Pronto para incluir confiança**.
12. Na página **Concluir**, selecione a caixa de seleção **Abrir a caixa de diálogo Editar Regras de Declarações para esta confiança de terceira parte confiável quando o assistente fechar**, e clique em **Fechar**.

O próximo passo é trabalhar na caixa de diálogo **Editar regras de declaração** para adicionar uma regra que garanta que as afirmações enviadas pelo AD FS coincidam com as afirmações esperadas pelo Tableau Server. No mínimo, o Tableau Server precisa de um endereço de e-mail. No entanto, incluir o nome e o sobrenome, além do e-mail, garantirá que os nomes de usuário exibidos no Tableau Server sejam os mesmos que os da sua conta AD.

1. Na caixa de diálogo Editar regras de declaração, clique em **Adicionar regra**.
2. Na página **Escolher tipo de regra**, para **Modelo da regra de declaração**, selecione **Enviar atributos LDAP como declarações** e, em seguida, clique em **Avançar**.
3. Na página **Configurar regra de declaração**, para **Nome da regra de declaração**, insira um nome que fizer sentido para você.
4. Para **Repositório de atributos**, selecione **Active Directory**, complete o mapeamento conforme mostrado abaixo e clique em **Concluir**.

O mapeamento diferencia maiúsculas de minúsculas, portanto verifique suas entradas. Esta tabela mostra atributos comuns e mapeamentos de declaração. Verifique os atributos com a configuração específica do Active Directory.

<table class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Atributo LDAP</th><th>Tipo de declaração de saída</th></tr><tr><td>SAM-Account-Name</td><td>ID de nome</td></tr><tr><td>SAM-Account-Name</td><td>username</td></tr><tr><td>Nome</td><td>firstName</td></tr><tr><td>Sobrenome</td><td>lastName</td></tr></tbody></table>

Se você estiver executando o AD FS 2016 ou posterior, deverá adicionar uma regra para transmitir todos os valores de solicitação. Se você estiver executando uma versão antiga do AD FS, vá para o próximo procedimento para exportar metadados do AD FS.

1. Clique em **Adicionar regra**.
2. Em **Solicitar modelo de regra,** escolha **Transmitir ou Filtrar uma solicitação de entrada.**
3. Em **Solicitar nome da regra**, digite Windows.
4. Na janela pop-up **Editar Regra - Windows**:
    - Em **Tipo de solicitação de entrada**, selecione **Nome da conta do Windows**.
    - Selecione **Transmitir todos os valores de solicitação**.
    - Clique em **OK**.

O próximo passo é exportar os metadados do AD FS que serão importados posteriormente para o Tableau Server. Verifique também se os metadados estão configurados e codificados corretamente para Tableau Server e verifique outros requisitos do AD FS para a sua configuração SAML.

1. Exporte os metadados de AD FS Federation para um arquivo XML e, em seguida, baixe o arquivo em **https://_<adfs server name>_/federationmetadata/2007-06/FederationMetadata.xml**.
2. Abra o arquivo de metadados em um editor de texto como Sublime Text ou Notepad++ e verifique se ele está corretamente codificado como UTF-8 sem BOM.
    
    Se o arquivo mostrar algum outro tipo de codificação, salve-o no editor de texto com a codificação correta.
3. Verifique se o AD FS está usando a autenticação com base em formulários. Os logons são realizados em uma janela do navegador, então você precisa que o AD FS tenha esse tipo de autenticação como padrão.
    
    Edite **c:\\inetpub\\adfs\\ls\\web.config**, pesquise pela marca **,** e mova a linha, de modo que ela apareça em primeiro na lista. Salve o arquivo para que o IIS possa recarregá-lo automaticamente.
    
    **Observação:** se você não visualizar o arquivo **c:\\inetpub\\adfs\\ls\\web.config**, o IIS não é instalado e configurado no servidor AD FS.
4. (Opcional) essa etapa é necessária somente se o AD FS estiver configurado como IDP para SAML específico ao site. Esta etapa não é necessária se o AD FS estiver configurado como IDP para SAML em todo o servidor.
    
    Configure um identificador de parte confiável AD FS adicional. Isso permite que o seu sistema solucione qualquer problema do AD FS ao sair do SAML.
    
    Execute um destes procedimentos:
    
    Windows Server 2008 R2:
    
    1. No **AD FS 2.0**, clique com o botão direito do mouse na parte confiável criada anteriormente para o Tableau Server e em clique em **Propriedades**.
    2. Na guia **Identificadores**, na caixa **Identificador da parte confiável**, insira **https://<tableauservername>/public/sp/metadata** e clique em **Adicionar**.
    
    Windows Server 2012 R2:
    
    1. Em **Gerenciamento de AD FS** na lista **Confianças de parte confiável**, clique com o botão direito do mouse na parte confiável criada anteriormente para o Tableau Server e clique em **Propriedades**.
    2. Na guia **Identificadores**, na caixa **Identificador da parte confiável**, insira **https://<tableauservername>/public/sp/metadata** e clique em **Adicionar**.
    
    **Observação**: o AD FS pode ser usado com o Tableau Server de uma única parte confiável para a mesma instância. O AD FS não pode ser usado para várias partes confiáveis na mesma instância, por exemplo, vários sites SAML do site ou configurações SAML do site e do servidor.

## Etapa 4: fornecer metadados do AD FS para o Tableau Server

1. Retorne à interface do usuário da Web do TSM e navegue até guia Configuração > Identidade e acesso do usuário > Método de autenticação.
2. Na Etapa 4 do painel de configuração do SAML, insira o local do arquivo XML exportado do AD FS e selecione Fazer upload .
    
    ![Captura de tela destacando a área da interface de dados do TSM onde você carrega metadados SAML IDP](/tableau/current/pt-br/server/pt-br/Img/saml_config_upload_idp_metadata.png)
3. Conclua as etapas restantes (asserções correspondentes e especifique o acesso do tipo de cliente) conforme especificado em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).
4. Salve e aplique as alterações.
5. Execute as etapas a seguir se essa não for a primeira vez que configura o SAML:
    
    1. Interrompa o Tableau Server, abra a CLI do TSM e execute os seguintes comandos:
        
        `tsm configuration set -k wgserver.saml.sha256 -v true`
        
        `tsm authentication saml configure -a -1`
    2. Aplique as alterações:
        
        `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).

<!-- document id=00cd590d2a40e2a02f121b07f4b15175c863aaaf284b37986deb948cc06dcfe7 url=/tableau/current/pt-br/server/saml_config_azure_server.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar SAML com IdP do Azure AD no Tableau Server

Você pode configurar o Azure AD como provedor de identidade do SAML (IdP) e adicionar o Tableau Server aos aplicativos de logon único (SSO) compatíveis. Ao integrar o Azure AD com o SAML e o Tableau Server, seus usuários poderão fazer logon no Tableau Server usando suas credenciais de rede padrão.

## Antes de começar: pré-requisitos

Antes de configurar o Tableau Server e o SAML com o Azure AD, seu ambiente deve ter o seguinte:

- O certificado SSL codificado usando a codificação SHA-2 (256 ou 512 bits), e que esteja em conformidade com os requerimentos listados nas seções a seguir:
    
    - [Requisitos do certificado SSL](https://help.tableau.com/current/server/pt-br/ssl_config.htm#cert-req)
    - [Requisitos de certificado e de provedor de identidades (IdP)](https://help.tableau.com/current/server/pt-br/saml_requ.htm#Certific) do SAML
- Se seus usuários estiverem entrando em um domínio que não seja o padrão, analise os [Requisitos do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm#multiple_domain) e [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm#multiple_domain) para garantir que o valor do atributo de domínio seja definido e definido, para evitar problemas de conexão posteriormente.

## Etapa 1: verificar a conexão SSL com o Azure AD

O Azure AD requer uma conexão SSL. Caso não tenha feito, conclua as etapas em [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm), usando um certificado que atenda aos requisitos especificados acima.

Como alternativa, se o Tableau Server estiver configurado para funcionar com um proxy reverso ou balanceador de carga onde o SSL está sendo encerrado (comumente chamado de descarregamento de SSL), você não precisará configurar o SSL externo.

Se sua organização usar o proxy do aplicativo Azure AD, consulte a seção abaixo,[Proxy do aplicativo Azure AD](#AzureAppProxy).

## Etapa 2: configurar SAML no Tableau Server

Conclua as etapas em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm), baixando os metadados do Tableau Server para um arquivo XML. Nesse ponto, volte aqui e continue para a próxima seção.

## Etapa 3: configurar regras de declaração do Azure AD

O mapeamento diferencia maiúsculas de minúsculas, portanto verifique suas entradas. Esta tabela mostra atributos comuns e mapeamentos de declaração. Você deve verificar os atributos com a configuração específica do Azure AD.

<table class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Atributo LDAP</th><th>Tipo de declaração de saída</th></tr><tr><td>onpremisessamaccountname</td><td>username</td></tr><tr><td>Nome</td><td><p>firstName</p><p><b>Observação:</b> isso é opcional.</p></td></tr><tr><td>Sobrenome</td><td><p>lastName</p><p><b>Observação:</b> isso é opcional.</p></td></tr><tr><td>netbiosname</td><td><p>domain</p><p><b>Observação:</b> isso só é necessário se você tiver usuários fazendo login em um domínio que não seja o padrão.</p></td></tr></tbody></table>

Em algumas organizações, o Azure AD como um IdP de SAML é usado com o Active Directory como o armazenamento de identidade do Tableau Server. Neste caso, `username` geralmente é o nome sAMAccountName. Consulte a documentação da Microsoft para identificar o atributo sAMAccountName dentro do Azure AD e mapear o atributo `username`.

## Etapa 4: fornecer metadados do Azure AD para o Tableau Server

1. Retorne à interface do usuário da Web do TSM e navegue até guia Configuração > Identidade e acesso do usuário > Método de autenticação.
2. Na Etapa 4 do painel de configuração do SAML, insira o local do arquivo XML exportado do Azure AD e selecione Fazer upload .
    
    ![Captura de tela destacando a área da interface de dados do TSM onde você carrega metadados SAML IDP](/tableau/current/pt-br/server/pt-br/Img/saml_config_upload_idp_metadata.png)
3. Conclua as etapas restantes (asserções correspondentes e especifique o acesso do tipo de cliente) conforme especificado em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm). Salve e aplique as alterações.
4. Execute as etapas a seguir se essa não for a primeira vez que configura o SAML:
    
    1. Interrompa o Tableau Server, abra o CLI do TSM e execute os seguintes comandos.
        
        `tsm configuration set -k wgserver.saml.sha256 -v true`
        
        `tsm authentication saml configure -a -1`
    2. Aplique as alterações:
        
        `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).

## Proxy de aplicativo do Azure AD

Se você estiver executando o Proxy de aplicativo do Azure AD Proxy na frente do Tableau Server, e o SAML estiver ativado, então precisará fazer uma configuração adicional para o Proxy de aplicativo do Azure AD.

O Tableau Server só pode aceitar tráfego em uma URL quando o SAML estiver ativado. No entanto, por padrão, o Proxy de aplicativo do Azure AD define URLs externa e interna.

Você deve definir esses dois valores para a mesma URL em seu domínio personalizado. Para obter mais informações, consulte a documentação da Microsoft, [Configurar domínios personalizados com o Proxy de Aplicativo do Azure AD](https://docs.microsoft.com/pt-br/azure/active-directory/manage-apps/application-proxy-configure-custom-domain).

## Solução de problemas

**Proxy de aplicativo do Azure AD**

Em alguns casos, os links para exibições são renderizados internamente, mas falham externamente quando o tráfego está cruzando um Proxy de aplicativo do Azure AD. O problema surge quando há um sinal de cerquilha (#) na URL e os usuários estão acessando o link em um navegador. O aplicativo Tableau Mobile é capaz de acessar URLs com um sinal de libra.

**Os tempos limites da sessão do usuário parecem ser ignorados**

Quando o Tableau Server é configurado para SAML, os usuários podem ter erros de login porque a configuração de idade máxima de autenticação do IdP está definida como um valor maior do que a configuração de idade máxima de autenticação do Tableau. Para resolver esse problema, você pode usar a opção de conjunto de configuração tsm `wgserver.saml.forceauthn` para exigir que o IdP reautentique o usuário sempre que o Tableau redirecionar a solicitação de autenticação, mesmo se a sessão do IdP para o usuário ainda estiver ativa.

Por exemplo, quando a configuração do Azure AD `maxInactiveTime` é maior do que a configuração do Tableau Server `maxAuthenticationAge`, o Tableau redireciona a solicitação de autenticação para o IdP, que subsequentemente envia ao Tableau uma declaração de que o usuário já está autenticado. No entanto, como o usuário foi autenticado fora do Tableau Server `maxAuthenticationAge`, o Tableau rejeita a autenticação do usuário. Nesses casos, você pode fazer um dos procedimentos a seguir:

- Habilite a opção `wgserver.saml.forceauthn` para exigir que o IdP reautentique o usuário sempre que o Tableau redirecionar a solicitação de autenticação. Para obter mais informações, consulte [wgserver.saml.forceauthn](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-saml-forceauthn).
- Aumente a configuração `maxAuthenticationAge` do Tableau Server. Para obter mais informações, consulte “a, --max-auth-age<max-auth-age>” no tópico de [tsm authentication](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#tsm-authentication-saml-configure).

**Incompatibilidade de AppID**

Ao revisar o arquivo vizportal.log, você pode ver o erro "_O público pretendido não corresponde ao destinatário_".

Para resolver esse problema, verifique se o appID corresponde ao que é enviado. O Azure acrescentará automaticamente "SPN" ao appID ao usar a ID do aplicativo com o aplicativo que está sendo usado. Você pode alterar o valor nas configurações do Tableau SAML adicionando o prefixo "SPN:" à ID do aplicativo.

Por exemplo: SPN:myazureappid1234

<!-- document id=eae7b94631de6aa630b621d52b299263d3dae9d0108518f13ace84b18164e894 url=/tableau/current/pt-br/server/saml_config_salesforce_server.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar SAML com IdP do Salesforce no Tableau Server

Este tópico fornece etapas do roteiro que descrevem como configurar o SAML no Tableau Server com o IdP do Salesforce.

Ele também explica como habilitar Lightning Web Component (LWC). O LWC permite que os administradores do Salesforce incorporem uma visualização do Tableau em uma página do Lightning. Quando o SSO é configurado para o LWC do Tableau Viz no Tableau Server, a experiência do usuário é perfeita: após o usuário entrar no Salesforce, as exibições inseridas do Tableau funcionarão sem autenticação adicional para o Tableau Server.

## Ativar o Salesforce como provedor de identidade SAML

Se você ainda não configurou o Salesforce como um IdP, siga o procedimento, [Habilitar o Salesforce como um provedor de identidade SAML](https://help.salesforce.com/articleView?id=sf.identity_provider_enable.htm&type=5), no site de ajuda do Salesforce.

Durante o processo para habilitar o Salesforce como um IdP de SAML, você especificará um certificado ou o Salesforce gerará um certificado autoassinado para uso com SAML. Baixe este certificado (arquivo .crt) e o arquivo de metadados do provedor associado (.xml). Esses ativos serão necessários para a próxima etapa.

## Configurar o SAML no Tableau Server

Usando o certificado e os arquivos de metadados que você baixou na etapa anterior, siga o procedimento em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).

Como parte do processo de configuração, você gerará uma ID de entidade SAML e um URL de login para o Tableau Server. Esses ativos serão necessários para a próxima etapa.

(Opcional) Depois de configurar o SAML em todo o servidor, você pode configurar o SAML específico do site no Tableau Server. Consulte [Configurar SAML para um site específico](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).

## Adicionar o Tableau Server como um aplicativo cliente externo ou aplicativo conectado no Salesforce

Para habilitar a integração do Tableau com o Salesforce, habilite primeiro a integração de aplicativo no Salesforce. É altamente recomendável usar aplicativos clientes externos. Você pode usar aplicativos conectados do Salesforce se eles estiverem disponíveis.

### Aplicativo cliente externo (recomendado)

Siga o procedimento descrito no tópico [Integrar um provedor de serviços SAML SSO como um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.meta_external_client_app_saml.htm&type=5), na Ajuda do Salesforce.

### Aplicativo conectado (obsoleto)

> [!WARNING]
> 
> **Importante:** A partir da versão Spring '26 do Salesforce, a criação de aplicativos conectados é restrita. Você pode continuar a usar aplicativos conectados existentes durante e após a Spring '26, mas o uso de aplicativos clientes externos é altamente recomendado. Para obter mais informações, consulte o seguinte na Ajuda do Salesforce: [Novos aplicativos conectados não podem mais ser criados na Spring '26](https://help.salesforce.com/s/articleView?id=005228017), [Criar um aplicativo cliente externo](https://help.salesforce.com/s/articleView?id=xcloud.create_a_local_external_client_app.htm&type=5) e [Migração de aplicativo conectado para aplicativo cliente externo.](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_to_external_client_app_migration.htm&type=5)

Siga o procedimento descrito no tópico [Integrar provedores de serviços como aplicativos conectados com SAML 2.0](https://help.salesforce.com/articleView?id=sf.connected_app_create_saml_sso.htm&type=5), na de Ajuda do Salesforce.

Nesse processo, você criará um novo aplicativo conectado (Tableau Server). Seguem alguns detalhes importantes:

- Selecione "Ativar SAML"
- Insira a ID da Entidade e a URL de Logon de retorno que você gerou ao configurar o Tableau na seção anterior. Por padrão, a URL de logon é `https://<tableauserver>/wg/saml/SSO/index.html`.
- Para o certificado IdP, certifique-se de selecionar o mesmo certificado que você especificou ou gerou quando ativou o Salesforce como um provedor SAML.
- Para permitir que os usuários entrem no Tableau Server na sua organização, gerencie o acesso ao seu aplicativo conectado atribuindo os perfis ou conjuntos de permissões apropriados.

## Habilitar Lightning Web Component

Para habilitar o LWC para SSO do SAML no Tableau Server, você deve habilitar a autenticação no quadro. Antes de habilitar o LWC, atualize para a versão de manutenção mais recente do Tableau Server. Dois detalhes adicionais da versão são importantes:

- Se você não estiver executando a versão de manutenção mais recente e os usuários estiverem executando os navegadores Chrome para acessar o Salesforce Lightning, reveja o artigo [Embedded Views Fail to Load After Updating to Chrome 80](https://kb.tableau.com/articles/issue/embedded-views-fail-to-load-after-updating-to-chrome-80?lang=pt-br).
- Se você estiver usando o LWC com SAML específico do site no Tableau Server, deverá executar o Tableau Server 2020.4 ou posterior.

Depois de configurar o SAML no Tableau Server, execute os seguintes comandos TSM para habilitar a autenticação no quadro:

`tsm configuration set -k wgserver.saml.iframed_idp.enabled -v true`

`tsm pending-changes apply`

## Inserir exibições do Tableau no Salesforce

Depois de configurar o Tableau Server para SSO, você pode instalar o LWC em sua organização Salesforce e inserir exibições do Tableau. Consulte [Inserir exibições do Tableau no Salesforce](https://help.tableau.com/current/pro/desktop/pt-br/embed_ex_lwc.htm).

<!-- document id=12ee28b36c70563d1db69af20138bfecfbb1a88d983db685f7ef4d9afd1f9895 url=/tableau/current/pt-br/server/config_saml.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar SAML em todo o servidor

Configure o SAML em todo o servidor, quando desejar que todos os usuários de logon único (SSO) no Tableau Server sejam autenticados por meio de um único provedor de identidade (IdP) do SAML ou como a primeira etapa para configurar um SAML específico do site em um ambiente de vários sites.

Se você configurou o SAML em todo o servidor e está pronto para configurar um site, consulte [Configurar SAML para um site específico](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).

As etapas de configuração do SAML que fornecemos pressupõem que:

- Você está familiarizado com as opções de configuração da autenticação SAML no Tableau Server, como descrito no tópico [SAML](https://help.tableau.com/current/server/pt-br/saml.htm).
- Você certificou-se de que seu ambiente atende os [Requisitos do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm) e obteve os arquivos de certificado do SAML descritos nos requisitos.

## Antes de começar

Como parte do seu plano de recuperação de desastres, recomendamos manter um backup de arquivos de certificado e IdP em um local seguro fora do Tableau Server. Os arquivos de ativos SAML que você carrega no Tableau Server serão armazenados e distribuídos a outros nós pelo Serviço de arquivos do cliente. No entanto, esses arquivos não são armazenados em um formato recuperável. Consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

**Observação:** se você usa os mesmos arquivos de certificado para o SSL, é possível usar, alternativamente, a localização do certificado existente para configurar o SAML e adicionar o arquivo de metadados do IdP àquele diretório ao baixá-lo mais tarde neste procedimento. Para obter mais informações, consulte [Uso do certificado SSL e arquivos-chave para SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm#Cert_Name) nos requisitos do SAML.

Se você estiver executando o Tableau Server em um cluster, os certificados SAML, as chaves e o arquivo de metadados serão automaticamente distribuídos nos nós quando você habilitar o SAML.

Este procedimento exige que você carregue os certificados SAML para o TSM, de forma que eles sejam armazenados e distribuídos corretamente na configuração do servidor. Os arquivos SAML devem estar disponíveis no navegador do computador local onde você executa a interface na Web do TSM neste procedimento.

Se você tiver coletado e salvado os arquivos SAML no Tableau Server conforme recomendado na seção anterior, execute a interface na Web do TSM no computador do Tableau Server onde você copiou os arquivos.

Se estiver executando a interface na Web do TSM a partir de um computador diferente, será necessário copiar todos os arquivos SAML localmente antes de continuar. Ao seguir o procedimento abaixo, navegue até os arquivos no computador local para carregá-los para o TSM.

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Na guia Configuração, selecione Identidade e acesso do usuário e, em seguida, a guia Método de autenticação.
    
    ![Configurações de autenticação de usuário do Tableau Services Manager](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-user-auth.png "Imagem")
3. Para Método de autenticação, selecione SAML.
4. Na seção SAML exibida, conclua a Etapa 1 na interface de usuário, inserindo as seguintes configurações (não marque ainda a caixa de seleção para habilitar o SAML para o servidor):
    
    - URL de retorno do Tableau Server—A URL que os usuários do Tableau Server vão acessar, como https://tableau-server.
        
        O uso de https://localhost ou uma URL com um barra à direita (por exemplo, http://tableau\_server/) não é compatível.
    - ID de entidade do SAML—A ID de entidade que identifica a instalação do Tableau Server para o IdP.
        
        Você pode inserir a URL do Tableau Server novamente aqui. Se você planeja habilitar o SAML específico do site posteriormente, essa URL também serve como base para cada ID exclusiva do site.
    - Certificado SAML e arquivos-chave\- clique em Selecionar arquivo para carregar cada um desses arquivos.
        
        Se estiver usando um arquivo de chave protegido por frase secreta PKCS#8, será necessário inserir a frase com o TSM CLI.
        
        `tsm configuration set -k wgserver.saml.key.passphrase -v <passphrase>`
        
        Após fornecer as informações necessárias na Etapa 1 na interface de usuário, o botão Baixar arquivo de metadados XML na Etapa 2 na interface de usuário será disponibilizado.
5. Agora, selecione a caixa de seleção Ativar autenticação de SAML para o servidor acima da Etapa 1 na interface de usuário.
6. Preencha as configurações restantes do SAML.
    
    1. Para as Etapas 2 e 3, troque os metadados entre o Tableau Server e o IdP. (Aqui talvez seja necessário verificar a documentação de IdP.)
        
        Selecione Baixar arquivo de metadados XML e especifique o local do arquivo.
        
        Se estiver configurando o SAML com o AD FS, poderá retornar a [Etapa 3: configurar o AD FS para aceitar solicitações de logon do Tableau Server](https://help.tableau.com/current/server/pt-br/saml_config_adfs_server.htm#step3-config-adfs) de "Configurar SAML com o AD FS no Tableau Server".
        
        Para outros IdPs, acesse a conta do IdP para adicionar o Tableau Server a seus aplicativos (como um provedor de serviços), fornecendo os metadados do Tableau, conforme necessário.
        
        Siga as instruções no site ou na documentação do IdP para baixar os metadados de IdP. Salve o arquivo .xml no mesmo local que contém o certificado SAML e os arquivos-chave. Por exemplo:
        
        `C:\Program Files\Tableau\Tableau Server\SAML\idp-metadata.xml`
    2. Retorne para a interface do usuário da Web no TSM. Na Etapa 4 na interface de usuário, insira o caminho para o arquivo de metadados de IdP e, em seguida, clique em Selecionar arquivo.
        
        ![Captura de tela destacando a área da interface de dados do TSM onde você carrega metadados SAML IDP](/tableau/current/pt-br/server/pt-br/Img/saml_config_upload_idp_metadata.png)
    3. Para a Etapa 5, em alguns casos, talvez seja necessário alterar os valores da asserção na configuração do Tableau Server para corresponder aos nomes da asserção que são transmitidos pelo IdP.
        
        Você pode encontrar nomes de asserção na configuração SAML do IdP. Se diferentes nomes de asserção forem enviados de seu IdP, atualize o Tableau Server para usar o mesmo valor de asserção.
        
        **Dica:** "asserções" são um componente-chave do SAML e o conceito de asserções de mapeamento pode ser complicado no começo. Colocar isso em um contexto de dados tabulares, no qual o nome de asserção (atributo) é equivalente a um cabeçalho de coluna na tabela, pode ajudar. Você insere o nome de "título", em vez de um exemplo de um valor que pode ser exibido nessa coluna.
    4. Para a Etapa 6, selecione os aplicativos do Tableau nos quais você deseja fornecer aos usuários uma experiência de logon único.
        
        **Observação**: a opção para desabilitar o acesso móvel é ignorada por dispositivos que executam a versão 19.225.1731 do aplicativo Tableau Mobile e superior. Para desabilitar o SAML nos dispositivos que executam essas versões, desabilite o SAML como uma opção de logon do cliente no Tableau Server.
    5. Para o redirecionamento de saída do SAML, se o IdP oferecer suporte ao logout único (SLO), insira a página para qual deseja redirecionar os usuários após se desconectarem, em relação ao caminho inserido para a URL de retorno do Tableau Server.
    6. (Opcional) Para a Etapa 7, faça o seguinte:
        
        - Adicione um valor separado por vírgula para o atributo `AuthNContextClassRef`. Para obter mais informações sobre como esse atributo é usado, consulte [Notas e requisitos de compatibilidade do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm#compatibility).
        - Especifique um atributo de domínio se não enviar o domínio como parte do nome de usuário (ou seja,`domain\username`). Para obter mais informações, consulte [Ao executar vários domínios](https://help.tableau.com/current/server/pt-br/saml_requ.htm#multiple_domains).
    7. (Opcional) Para a Etapa 8, marque a caixa de seleção Habilitar captura de atributos do usuário durante autenticação SAML. Para obter mais informações sobre atributos de usuários, consulte [Personalizar e controlar o acesso aos dados usando atributos de usuário](#user_attributes).
        
        ![](/tableau/current/pt-br/server/pt-br/Img/tsm_ui_saml_user_attributes.png)
7. Clique em Salvar alterações pendentes após ter inserido as informações de configuração.
8. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
9. Clique em Aplicar alterações e reiniciar.

### Antes de começar

Depois de começar, faça o seguinte:

- Vá para o site ou aplicativo do seu IdP e exporte o arquivo XML de metadados do IdP.
    
    Confirme se o XML de IdP inclui um elemento SingleSignOnService, no qual a associação é definida para `HTTP-POST`, conforme o exemplo a seguir:
    
    `<md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://SERVER-NAME:9031/idp/SSO.saml2"/>`

- Reúna os arquivos de certificado e coloque-os no Tableau Server.
    
    Na pasta Tableau Server, crie uma nova pasta chamada SAML e coloque as cópias do certificado SAML nela. Por exemplo:
    
    `C:\Program Files\Tableau\Tableau Server\SAML`
    
    Esta é a localização recomendada porque a conta de usuário que executa o Tableau Server tem as permissões necessárias para acessar essa pasta.

### Etapa 1: configurar URL de retorno, ID da entidade SAML e especificar arquivos de chave e certificado

1. Abra o shell de prompt de comando e defina as configurações de SAML para o servidor (substituindo valores de espaço reservado por nomes de arquivo e caminho de ambiente).
    
    `tsm authentication saml configure --idp-entity-id https://tableau-server --idp-metadata "C:\Program Files\Tableau\Tableau Server\SAML\<metadata-file.xml>" --idp-return-url https://tableau-server --cert-file "C:\Program Files\Tableau\Tableau Server\SAML\<file.crt>" --key-file "C:\Program Files\Tableau\Tableau Server\SAML\<file.key>"`
    
    Para obter mais informações, consulte `[tsm authentication saml configure](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#tsm-auth-saml-config)`.
2. Se estiver usando a chave PKCS#8 protegida por uma frase secreta, insira essa frase da seguinte forma:
    
    `tsm configuration set -k wgserver.saml.key.passphrase -v <passphrase>`
3. Se o SAML ainda não estiver habilitado no Tableau Server, por exemplo, você está configurando-o pela primeira vez ou desabilitou-o, habilite-o agora:
    
    `tsm authentication saml enable`
4. Aplique as alterações:
    
    `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).

### Etapa 2: gerar os metadados do Tableau Server e configurar o IdP

1. Execute o comando a seguir para gerar o arquivo de metadados XML do Tableau Server.
    
    `tsm authentication saml export-metadata -f <file-name.xml>`
    
    Você pode especificar um nome de arquivo ou omitir o parâmetro `-f` para criar um arquivo padrão chamado `samlmetadata.xml`.
2. No site de seu IdP ou em seu aplicativo:
    
    - Adicione o Tableau Server como um Provedor de serviços.
        
        Consulte a documentação do seu IdP para obter as informações sobre como fazer isso. Como parte do processo de configuração do Tableau Server como um Provedor de serviços, você importará o arquivo de metadados do Tableau Server que gerou do comando `export-metadata`.
    - Confirme se o seu IdP usa nome de usuário como o atributo para verificar os usuários.

### Etapa 3: corresponder asserções

Em alguns casos, talvez seja necessário alterar os valores da asserção na configuração do Tableau Server para corresponder aos nomes da asserção que são transmitidos pelo IdP.

Você pode encontrar nomes de asserção na configuração SAML do IdP. Se diferentes nomes de asserção forem enviados de seu IdP, atualize o Tableau Server para usar o mesmo valor de asserção.

**Dica:** "asserções" são um componente-chave do SAML e o conceito de asserções de mapeamento pode ser complicado no começo. Colocar isso em um contexto de dados tabulares, no qual o nome de asserção (atributo) é equivalente a um cabeçalho de coluna na tabela, pode ajudar. Você insere o nome de "título", em vez de um exemplo de um valor que pode ser exibido nessa coluna.

A tabela a seguir mostra os valores de asserção padrão e a chave de configuração que armazena o valor.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 33%;"><col style="width: 33%;"><col style="width: 34%;"></colgroup><tbody><tr><th>Asserção</th><th>Valor padrão</th><th>Chave</th></tr><tr><td>Username</td><td><code>username</code></td><td><code>wgserver.saml.idpattribute.username</code></td></tr><tr><td>Nome de exibição</td><td><code>displayName</code></td><td><p>O Tableau não oferece suporte a esse tipo de atributo.</p></td></tr><tr><td>E-mail</td><td><code>email</code></td><td><p>O Tableau não oferece suporte a esse tipo de atributo.</p></td></tr><tr><td>Domínio</td><td>(não mapeado por padrão)</td><td><code>wgserver.saml.idpattribute.domain</code></td></tr></tbody></table>

Para alterar um determinado valor, execute o comando `tsm configuration set` com o par de chave:valor apropriado.

Por exemplo, para alterar a asserção de `username` para o valor, `name`, execute os comandos a seguir:

`tsm configuration set -k wgserver.saml.idpattribute.username -v name`

`tsm pending-changes apply`

Como alternativa, você pode usar o comando `[tsm authentication saml map-assertions](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMmap_assertions)` para alterar um determinado valor.

Por exemplo, para definir a asserção de domínio para um valor chamado `domain` e especificar valor como "example.myco.com", execute os seguintes comandos:

`tsm authentication saml map-assertions --domain example.myco.com`

`tsm pending-changes apply`

### Opcional: desabilitar tipos de cliente usando SAML

Por padrão, o Tableau Desktop e o aplicativo Tableau Mobile permitem a autenticação SAML.

Caso seu IdP não suporte esta funcionalidade, é possível desabilitar o logon com SAML para clientes do Tableau usando os comandos a seguir:

`tsm authentication saml configure --desktop-access disable`

`tsm authentication saml configure --mobile-access disable`

**Observação**: a opção `--mobile-access disable` é ignorada por dispositivos que executam a versão 19.225.1731 do aplicativo Tableau Mobile e superior. Para desabilitar o SAML nos dispositivos que executam essas versões, desabilite o SAML como uma opção de logon do cliente no Tableau Server.

`tsm pending-changes apply`

### Opcional: adicionar valor AuthNContextClassRef

Adicione um valor separado por vírgula para o atributo `AuthNContextClassRef`. Para obter mais informações sobre como esse atributo é usado, consulte [Notas e requisitos de compatibilidade do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm#compatibility).

Para definir esse atributo, execute os comandos a seguir:

`tsm configuration set -k wgserver.saml.authcontexts -v <value>`

`tsm pending-changes apply`

## Testar a configuração

1. No navegador da Web, abra uma nova página ou guia e insira a URL do Tableau Server.
    
    ![Uma janela em branco do navegador da Web exibe "http://tableau\_server" na barra de endereço.](/tableau/current/pt-br/server/pt-br/Img/saml_browser.png)
    
    O navegador o direciona para o formulário de logon do IdP.
2. Insira seu nome de usuário do logon único e senha.
    
    ![Caixa de diálogo de logon do SAML com campos para nome de usuário e senha.](/tableau/current/pt-br/server/pt-br/Img/saml_idp_signon.png)
    
    O IdP verifica suas credenciais e o redireciona para a página inicial do Tableau Server.

## Personalizar e controlar o acesso aos dados usando atributos de usuário

Os atributos de usuário são metadados de usuário definidos pela sua organização. Os atributos de usuário podem ser usados para determinar o acesso em um modelo de autorização típico de controle de acesso baseado em atributos (ABAC). Os atributos de usuário podem ser qualquer aspecto do perfil do usuário, incluindo cargos, associação departamental, nível de gerenciamento etc. Eles também podem estar associados a contextos de usuário de tempo de execução, como onde o usuário está conectado ou sua preferência de idioma.

Ao incluir atributos do usuário em seu fluxo de trabalho, você pode controlar e personalizar a experiência do usuário por meio de acesso e personalização de dados.

- **Acesso aos dados**: os atributos do usuário podem ser usados para impor políticas de segurança de dados. Isso garante que os usuários vejam apenas as informações que estão autorizados a ver.
- **Personalização**: ao passar atributos de usuário como localização e função, seu conteúdo pode ser personalizado para exibir apenas as informações relevantes para o usuário que o acessa, facilitando a localização das informações de que precisa.

**Resumo das etapas para passar atributos de usuário**

O processo de habilitar atributos de usuário em um fluxo de trabalho é resumido nas seguintes etapas:

1. Habilitar a configuração de atributos de usuário
2. Incluir atributos de usuário na asserção
3. Verificar se o autor do conteúdo inclui funções de atributo de usuário e filtros relevantes
4. Revisar o conteúdo

### Etapa 1: habilitar a configuração de atributos de usuário

Por motivos de segurança, os atributos de usuário só são validados em um fluxo de trabalho de autenticação quando a configuração de atributo de usuário é habilitada por um administrador de servidor.

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Na guia CONFIGURAÇÃO, selecione Identidade e acesso do usuário > Método de autenticação.
3. Em Método de autenticação, selecione SAML no menu suspenso.
4. **Sob Etapa 8**, marque a caixa de seleção Habilitar captura de atributos do usuário durante autenticação SAML.
5. Quando terminar, faça o seguinte:
    
    1. Clique em Salvar alterações pendentes.
    2. Clique no botão Alterações o pendentes na parte superior da página.
    3. Clique em Aplicar alterações e reiniciar.

### Etapa 2: incluir o atributo de usuário na asserção

Certifique-se de que a asserção contenha os atributos de usuário.

**Observação:** os atributos na resposta SAML estão sujeitos ao limite de 4096 caracteres, com exceção dos atributos `scope` ou `scp`. Se os atributos na resposta, incluindo os atributos do usuário, excederem esse limite, o Tableau vai remover os atributos e passar o atributo `ExtraAttributesRemoved`. O autor do conteúdo pode então criar um cálculo com o atributo `ExtraAttributesRemoved` para determinar como exibir o conteúdo aos usuários quando o atributo for detectado.

**Exemplo**

Suponha que você tenha um funcionário, Fred Suzuki, que é um gerente localizado na região Sul. Você quer garantir que, quando Fred revisar relatórios, ele só consiga ver os dados da região Sul. Em um cenário como este, você pode incluir o atributo de usuário Region na resposta SAML, como no exemplo abaixo.

<saml:Assertion xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
	<saml;Issuer">https://myidp.okta.com/saml</saml:Issuer">
   <saml;Subject">
	  <saml:NameId Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"fsuzuki@example.com</saml:NameID">
   <saml:AttributeStatement xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml:Attribute Name="Region" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml:AttributeValue">South</saml:AttributeValue">
    	</saml:Attribute">
   </saml:AttributeStatement">
</saml:Assertion">

### Etapa 3: verificar se o autor do conteúdo inclui funções de atributo

Verifique se o autor do conteúdo inclui as funções de atributo do usuário e filtros relacionados para controlar quais dados podem ser exibidos em seu conteúdo. Para garantir que as asserções de atributo do usuário sejam passadas para o Tableau, o conteúdo deve conter uma das seguintes funções de atributo do usuário:

- `USERATTRIBUTE('attribute_name')`
- `USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')`

A função usada pelo autor de conteúdo depende se os atributos do usuário devem retornar um único valor ou vários. Para obter mais informações sobre essas funções e exemplos de cada uma, consulte [Funções do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm#user_attributes) na Ajuda do Tableau.

**Observações:**

- Visualização do conteúdo com essas funções não está disponível durante a criação no Tableau Desktop ou Tableau Cloud. A função retornará NULL ou FALSE. Para garantir que as funções do usuário funcionem conforme o esperado, recomendamos que o autor revise as funções após disponibilizar o conteúdo.
- Para garantir que o conteúdo seja renderizado conforme o esperado, o autor do conteúdo pode considerar a inclusão de um cálculo que use `ExtraAttributesRemoved` que 1) verifica esse atributo e 2) determina o que fazer com o conteúdo se ele existir, como exibir uma mensagem. O Tableau só adicionará o atributo `ExtraAttributesRemoved` e removerá todos os outros atributos (exceto `scp` ou `scope`) quando os atributos no SAML XML excederem 4096 caracteres. Isso é para garantir o desempenho ideal e respeitar as limitações de armazenamento.

**Exemplo**

Continuando o exemplo introduzido na [Etapa 2: incluir o atributo de usuário na asserção](#step_pass_user_attribute) acima, para passar a asserção de atributo de usuário “Region” para uma pasta de trabalho, o autor pode incluir `USERATTRIBUTEINCLUDES`. Por exemplo, `USERATTRIBUTEINCLUDES('Region', [Region])`, onde “Region” é o atributo do usuário e \[Region\] é uma coluna nos dados. Usando o novo cálculo, o autor pode criar uma tabela com dados de Gerente e Vendas. Quando o cálculo é adicionado, a pasta de trabalho retorna os valores “False” conforme esperado.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_calc_view.png)

Para mostrar apenas os dados associados à região Sul na pasta de trabalho inserida, o autor pode criar um filtro e personalizá-lo para mostrar valores quando a região Sul for “True”. Quando o filtro é aplicado, a pasta de trabalho fica em branco, conforme esperado, porque a função está retornando valores “False” e o filtro é personalizado para mostrar apenas valores “True”.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_filter_view.png)

### Etapa 4: revisar o conteúdo

Revise e valide o conteúdo.

**Exemplo**

Para concluir o exemplo da [Etapa 3: verificar se o autor do conteúdo inclui funções de atributo](#step_include_uaf) acima, você pode ver que os dados de vendas na exibição são personalizados para Fred Suzuki porque o contexto de usuário dele é a região Sul.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_embedded_view_south.png)

Os gerentes das regiões representadas na pasta de trabalho devem ver o valor associado à sua região. Por exemplo, Sawdie Pawthorne, da região Oeste, vê dados específicos para sua região.

![](/tableau/current/pt-br/server/pt-br/Img/uaf_embedded_view_west.png)

Os gerentes cujas regiões não estão representadas na pasta de trabalho verão uma pasta de trabalho em branco.

### Problemas conhecidos e limitações

Existem alguns problemas conhecidos e limitações que você deve considerar ao trabalhar com funções de atributo do usuário.

<!-- document id=ec844a3f53eb5d14eb8e3315b258ef5920e0190544fdc2adf28330bca71be35a url=/tableau/current/pt-br/server/saml_config_LWC.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar SAML para Lightning Web Component de visualização do Tableau

O Tableau fornece um Lightning Web Component (LWC) para incorporar uma visualização do Tableau dentro de uma página do Salesforce Lightning.

Este tópico descreve como ativar uma experiência SSO para visualizações de tableau incorporadas em uma página do Salesforce Lightning. O SSO para o cenário LWC de visualização do Tableau requer configuração SAML. O SAML IdP usado para autenticação do Tableau deve ser o Salesforce IdP ou o mesmo IdP usado para a sua instância Salesforce.

Neste cenário, os administradores da Salesforce podem arrastar e soltar o LWC da visualização do Tableau na página Lightning para incorporar uma visualização. ualquer exibição disponível para eles no Tableau Server pode ser exibida no painel de instrumentos inserindo a URL

Quando o logon único (SSO) é configurado para o Tableau Viz LWC no Tableau Tableau Server, a experiência do usuário é perfeita: após o usuário entrar no Salesforce, as exibições inseridas do Tableau funcionarão sem autenticação adicional para o Tableau Server.

Quando o SSO não estiver configurado, os usuários precisarão se autenticar novamente com o Tableau Server para exibir visualizações incorporadas do Tableau Server.

## Requisitos

- O SAML IdP usado para autenticação do Tableau deve ser o Salesforce IdP ou o mesmo IdP usado para a sua instância Salesforce. Consulte [Configurar SAML com IdP do Salesforce no Tableau Server](https://help.tableau.com/current/server/pt-br/saml_config_salesforce_server.htm)
- O SAML deve estar configurado no Tableau Server. Consulte [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm) ou [Configurar SAML para um site específico](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).
- O SAML deve ser configurado para o Salesforce.
- Instale o Lightning Web Component de visualização do Tableau. Consulte [Inserir exibições do Tableau no Salesforce](https://help.tableau.com/current/pro/desktop/pt-br/embed_ex_lwc.htm).

## Configuração do fluxo de trabalho de autenticação

Talvez você precise fazer configurações adicionais para otimizar a experiência de logon dos usuários que acessam o Lightning com as exibições inseridas do Tableau.

Se uma experiência do usuário de autenticação perfeita for importante, você precisa fazer algumas configurações adicionais. Neste contexto, "simples" significa que os usuários que acessarem a página Salesforce Lightning, onde o SSO do LWC de visualização do Tableau foi ativado, não serão obrigados a realizar qualquer ação para visualizar a exibição do Tableau incorporada. No cenário perfeito, se o usuário estiver conectado ao Salesforce, as exibições inseridas do Tableau serão mostradas sem nenhuma ação adicional do usuário. Esse cenário é habilitado pela _autenticação no quadro_.

Para uma experiência do usuário perfeita, você precisa habilitar a autenticação no quadro no TTableau Server e no IdP. As seções abaixo descrevem como configurar a autenticação no quadro.

Por outro lado, há cenários em que os usuários interagem com a página do Lightning, que exigirão que eles cliquem no botão "Entrar" para acessar a exibição inserida do Tableau. Esse cenário em que o usuário deve realizar outra ação para acessar a exibição inserida do Tableau é chamado de autenticação pop-up.

A autenticação pop-up é a experiência do usuário padrão, se você não habilitar a autenticação no quadro.

## Habilitar a autenticação no quadro no Tableau Server

Antes de habilitar a autenticação no quadro no Tableau Server, você já deve ter configurado e habilitado o SAML no Tableau Server.

Execute os comandos TSM a seguir para habilitar a autenticação no quadro:

`tsm configuration set -k wgserver.saml.iframed_idp.enabled -v true`

`tsm pending-changes apply`

**Observação**: a proteção contra clickjack é habilitada por padrão no Tableau Server. Quando você habilita a autenticação no quatro, a proteção contra clickjack é temporariamente desabilitada para a sessão. Você deve avaliar o risco de desabilitar a proteção contra clickjack. Consulte [Proteção contra roubo de clique](https://help.tableau.com/current/server/pt-br/clickjack_protection.htm).

### Histórico de revisões do Tableau Server

Para obter a melhor experiência do usuário, execute a versão de manutenção mais recente do Tableau Server.

Se você não estiver executando a versão de manutenção mais recente e os usuários estiverem executando os navegadores Chrome para acessar o Salesforce Lightning, reveja o artigo [Embedded Views Fail to Load After Updating to Chrome 80](https://kb.tableau.com/articles/issue/embedded-views-fail-to-load-after-updating-to-chrome-80?lang=pt-br).

## Habilitar a autenticação no quadro com seu SAML IdP

Como descrito acima, uma experiência perfeita de usuário de autenticação com o Salesforce Mobile requer suporte a IdP para autenticação no quadro. Essa funcionalidade também pode ser referida como "incorporação de iframe" ou "proteção de quadros" em IdPs.

### Domínios da lista de permissões do Salesforce

Em alguns casos, os IdPs só permitem permitir a autenticação no quadro por domínio. Nesses casos, defina os seguintes domínios curingas do Salesforce, quando você habilitar a autenticação no quadro:

`*.force`

`*.visualforce`

### Salesforce IdP

O Salesforce IdP aceita a autenticação no quadro por padrão. Você não precisa habilitar ou configurar a autenticação no quadro na configuração do Salesforce. No entanto, você deve executar o comando TSM no Tableau Server, conforme descrito acima.

### Okta IdP

Consulte _Incorporar Okta em um iframe_, no tópico Okta Help Center, [Opções gerais de personalização](https://help.okta.com/en/prod/Content/Topics/Settings/settings-customization-general.htm).

### Ping IdP

Veja o tópico de suporte do ping, [Como desativar o cabeçalho "X-Frame-Options=SAMEORIGIN" em PingFederate](https://support.pingidentity.com/s/article/How-to-Disable-the-X-Frame-Options-SAMEORIGIN-Header-in-PingFederate).

### OneLogin IdP

Consulte _Proteção de quadros_, no artigo OneLogin Knowledge Base, [Configurações de conta para proprietários de contas](https://onelogin.service-now.com/kb_view_customer.do?sysparm_article=KB0010304#:~:text=Framing%20protection%20allows%20granular%20customization,a%20user%20agent%20can%20access.).

### ADFS e EntraID IdP

A Microsoft bloqueou toda a autenticação no quadro e ela não pode ser ativada. Em vez disso, a Microsoft só oferece suporte à autenticação pop-up em uma segunda janela. Como resultado, o comportamento pop-up pode ser bloqueado por alguns navegadores, o que exigirá que os usuários aceitem pop-ups para os sites `force.com``visualforce.com`.

## Salesforce Mobile App

Se os usuários interagem principalmente com o Lightning no Salesforce Mobile App, você deve estar ciente dos seguintes cenários:

- O Salesforce Mobile App exige que você configure o SSO/SAML para exibir o Tableau inserido.
- O Salesforce Mobile App requer autenticação no quadro. A autenticação pop-up não funciona. Em vez disso, os usuários do Salesforce Mobile App verão o botão de logon do Tableau, mas não poderão entrar no Tableau.
- O Mobile App não funcionará no ADFS e no Azure AD IdP.
- O Mobile App usa tokens OAuth para habilitar o SSO. Há cenários em que o token OAuth atualiza e registra os usuários, exigindo que os usuários façam logon novamente. Para saber mais, consulte o artigo sobre KB do Tableau,[Tableau Viz Lightning Web Component no aplicativo móvel do Salesforce solicita logon](https://kb.tableau.com/articles/Issue/tableau-viz-lightning-web-component-salesforce-mobile-app-sso?lang=pt-br).
- O comportamento do SSO é diferente dependendo da versão do Salesforce Mobile App (iOS vs Android) e do IdP:<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>IdP</th><th>SO móvel</th><th>Comportamento do SSO</th></tr><tr><td rowspan="2">Salesforce IdP</td><td>Android</td><td rowspan="2">O SSO funciona inicialmente, mas os usuários precisarão fazer logon depois de algum tempo.</td></tr><tr><td>iOS</td></tr><tr><td rowspan="2">IdP externo</td><td>Android</td><td>O SSO não funciona. Os usuários precisarão fazer logon manualmente (O SSO ainda deve ser configurado para permitir que os usuários acessem as exibições inseridas do Tableau).</td></tr><tr><td>iOS</td><td>O SSO funciona inicialmente, mas os usuários precisarão fazer logon depois de algum tempo.</td></tr></tbody></table>

<!-- document id=e1de79624bd1d6e6e3e464c48fec10b32769d0e6122e6fe5041711f21c98d5da url=/tableau/current/pt-br/server/saml_site_specific.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar SAML para um site específico

Use o SAML específico ao site em um ambiente de vários sites quando quiser ativar o logon único e se você também usa os provedores de identidade (IdPs) do SAML ou aplicativos IdP. Ao habilitar o SAML do site, é possível especificar o aplicativo IdP ou IdP para cada site ou configurar alguns sites para usar o SAML e os outros para usar o método de autenticação para todo o servidor padrão.

Se quiser que todos os usuários usem o SAML e façam logon por meio do mesmo aplicativo IdP, consulte [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).

## Pré-requisitos para ativar o SAML específico ao site

Antes de ativar o logon único do SAML no nível de site, conclua os requisitos a seguir:

- O armazenamento de identidades do Tableau Server deve ser configurado para armazenamento de identidades local.
    
     Não é possível configurar o SAML específico do site se o Tableau Server estiver configurado com um armazenamento de identidade externo, como Active Directory ou OpenLDAP.
- Certifique-se de que o ambiente e o IdP atendem os [Requisitos do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm) gerais.
    
    Alguns recursos são suportados apenas em implantações do SAML em todo o servidor, incluindo mas não limitado a:
    
    - Os arquivos-chave protegidos por senha, que não são aceitos em implantações SAML específicas do site.
- Você deve configurar o SAML em todo o servidor antes de configurar o SAML específico do site. Você não precisa habilitar o SAML em todo o servidor, mas o SAML específico do site requer a configuração em todo o servidor. Consulte [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).
- Observe o local dos arquivos de certificado SAML. Você fornece isso ao [Configurar o servidor para oferecer suporte para SAML específico ao site](#add-site-saml-support).
    
    Para obter mais informações, consulte [Colocar os metadados e os arquivos de certificado no local apropriado](https://help.tableau.com/current/server/pt-br/config_saml.htm#generate-metadata) no tópico sobre configuração do SAML para todo o servidor.
- Adicione o Tableau Server como um provedor de serviço ao seu IdP. Essas informações estão disponíveis na documentação fornecida pelo IdP.
- Confirme se os relógios de sistema do computador que hospeda o SAML IdP do site e o que hospeda o Tableau Server estão com uma diferença de horário de até 59 segundos. O Tableau Server não tem uma opção de configuração para ajustar a distorção de resposta (diferença de tempo) entre o computador do Tableau Server e o IdP.

### Configurações em todo o site relacionadas ao SAML específico ao site

**Retornar URL e ID de entidade:** nas configurações para configurar o SAML específico do site, o Tableau fornece uma URL de retorno específico do site e um ID de entidade com base nessas configurações. A URL de retorno específica ao site e a ID de entidade não podem ser modificadas. Essas configurações são definidas pelo TSM, conforme descrito em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).

**Distorção de idade e resposta de autenticação:** as configurações de todo o servidor, a idade máxima de autenticação e a distorção de resposta não se aplicam ao SAML específico do site. Essas configurações são codificadas:

- O tempo máximo de autenticação refere-se a quanto tempo um token de autenticação do IdP é válido após ser emitido. O tempo máximo de autenticação codificado do SAML específico do site é de 24 dias.
- A inclinação da resposta é a diferença máxima em segundos entre o horário do Tableau Server e o horário da criação da asserção (com base no horário do servidor IdP) que ainda permite que a mensagem seja processada. O valor específico do site em código para isso é 59 segundos.

**Nome de usuário:** obrigatório. Além do atributo de configuração SAML em todo o servidor, o atributo de configuração SAML específico do site deve ser definido como "nome de usuário".

> **Observação:** para que o SAML específico do site opere com êxito com um padrão SAML de todo o servidor, o atributo username configurado para SAML de todo o servidor com a chave de configuração wgserver.saml.idpattribute.username deve ser "username". O IdP usado para SAML em todo o servidor deve fornecer o nome de usuário em um atributo chamado "nome de usuário".

![Um formulário para corresponder atributos de um provedor de identidade.](/tableau/current/pt-br/server/pt-br/Img/saml_config_site_match_asserts_server_username.png)

**HTTP POST e HTTP REDIRECT:** para SAML específico do site, o Tableau Server oferece suporte a HTTP-POST, HTTP-REDIRECT e HTTP-POST-SimpleSign.

## Configurar o servidor para oferecer suporte para SAML específico ao site

Após completar os pré-requisitos listados acima, você pode executar os comandos a seguir para configurar o servidor para suportar SAML específico ao site.

1. [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm). No mínimo, você deve executar o seguinte comando TSM (se você já configurou o SAML em todo o servidor, pule para a Etapa 2):
    
    `tsm authentication saml configure --idp-entity-id <tableau-server-entity-id> --idp-return-url <tableau-server-return-url> --cert-file <path-to-saml-certificate.crt> --key-file <path-to-saml-keyfile.key>`
2. Habilite o SAML do site. Execute os seguintes comandos:
    
    `tsm authentication sitesaml enable`
    
    `tsm pending-changes apply`

### Sobre os comandos

O comando `sitesaml enable` expõe a guia Autenticação na página Configurações de cada site na IU da Web do Tableau Server. Após a configuração do servidor para suportar o SAML de site, continue a [Configurar SAML para um site](#site_saml_config_for_a_site), para trabalhar com as configurações na guia Autenticação.

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

Caso queira analisar os comandos e as configurações que serão usadas ao executar `pending-changes apply`, execute o comando a seguir antes:

`tsm pending-changes list --config-only`

## Configurar SAML para um site

Esta seção o guia pelas etapas de configuração que aparecem na guia Autenticação, na página Configurações do Tableau Server. Em uma instalação do Tableau Server auto-hospedado, esta página aparece apenas quando o suporte para SAML específico ao site estiver habilitado no nível do servidor.

**Observação:** Para concluir esse processo, você precisará também da documentação que seu IdP fornecer. Procure tópicos que referenciam a configuração ou definição de um provedor de serviços para uma conexão SAML ou adição de um aplicativo.

Etapa 1: exportar metadados do Tableau

Para criar a conexão de entre o SAML e seu Tableau Server IdP, é necessário trocar os metadados exigidos entre os dois serviços. Para obter metadados do Tableau Server, escolha um dos seguintes métodos. Consulte a documentação de configuração de SAML do IdP para confirmar a opção correta.

- Selecione o botão Exportar metadados para baixar um arquivo XML que contenha a ID da entidade SAML do Tableau Server, URL do Assertion Consumer Service (ACS) e botão o certificado X.509.
    
    A ID da entidade é específica de site e baseada na ID de entidade em todo o servidor especificada ao habilitar o sites SAML no servidor. Por exemplo, se você especificou `https://tableau_server`, talvez você veja a seguinte ID de entidade para o site:
    
    `https://tableau_server/samlservice/public/sp/metadata?alias=48957410-9396-430a-967c-75bdb6e002a0`
    
    Não é possível modificar a ID de entidade específica de site ou a URL ACS gerada pelo Tableau.
- Selecione Baixar certificado, se o seu IdP espera as informações necessárias de uma maneira diferente. Por exemplo, se ele deseja que você insira a ID da entidade Tableau Server, a URL do ACS e o certificado X.509 em locais separados.
    
    A imagem a seguir foi editada para mostrar que essas configurações são as mesmas no Tableau Cloud e no Tableau Server.
    
    ![Um formulário com opções para recuperar metadados.](/tableau/current/pt-br/server/pt-br/Img/saml_site_auth_step1.png)

Etapas 2 e Etapa 3: etapas externas

Para a etapa 2, para importar os metadados exportados na etapa 1, faça logon na sua conta IdP e siga as instruções fornecidas pela documentação do IdP para enviar os metadados de Tableau Server.

Para a etapa 3, a documentação do IdP irá orientá-lo sobre como fornecer metadados ao provedor de serviço. Ela instruirá para você baixar um arquivo de metadados, ou exibirá o código XML. Se exibir o código XML, copie e cole-o em um novo arquivo de texto e salve o arquivo em uma extensão .xml.

Etapa 4: importar metadados do IdP para o site do Tableau

Na página de Autenticação no Tableau Server, importe o arquivo de metadados baixado do IdP ou configurado manualmente no XML, se fornecido.

**Observação:** se estiver editando a configuração, você precisará carregar o arquivo de metadados para que o Tableau saiba usar a ID da entidade do IdP e a URL do serviço SSO corretos.

Etapa 5: atributos do mapa

Os atributos contêm autenticação, autorização e outras informações sobre um usuário. Na coluna Nome de asserção do provedor de identidade (IdP), forneça os atributos que contêm as informações exigidas pelo Tableau Server.

- Nome de usuário ou e-mail: (obrigatório) insira o nome do atributo que armazena nomes de usuário ou endereços de e-mail.
- **Nome para exibição:** (opcional) alguns IdPs usam atributos separados para nomes e sobrenomes. Outros IdPs armazenam o nome completo em um atributo. Se você estiver usando SAML com autenticação local, o atributo de nome para exibição não será sincronizado com o SAML IdP.
    
    Selecione o botão que corresponda à maneira que seu IdP armazenar os nomes. Por exemplo, se o IdP combinar o nome e o sobrenome em um atributo, selecione Nome de exibição e insira o nome do atributo.
    
    ![Captura de tela da etapa 5 para configurar SAML de site para Tableau Server - atributos correspondentes](/tableau/current/pt-br/server/pt-br/Img/saml_config_site_match_asserts_server.png)

Etapa 6: gerenciar usuários

Selecionar usuários existentes do Tableau Server ou novos usuários que você deseja aprovar para logon único.

Quando você adiciona ou importa usuários, também pode especificar o tipo de autenticação deles. Na página Usuários, você pode alterar o tipo de autenticação dos usuários sempre após adicioná-los.

Para obter mais informações, consulte [Adicionar usuários a um site](https://help.tableau.com/current/server/pt-br/sites_addusers.htm) ou [Importar usuários](https://help.tableau.com/current/server/pt-br/users_import.htm) a [Definir o tipo de autenticação do usuário para SAML](https://help.tableau.com/current/server/pt-br/users_set_auth_type.htm).

**Importante:** usuários que se autenticam com um SAML específico a cada site podem pertencer a apenas um site. Se um usuário precisar acessar vários sites, defina o tipo de autenticação para o padrão do servidor. Dependendo de como o SAML específico a cada site foi configurado pelo administrador do servidor, o padrão do servidor é SAML de autenticação local ou de todo o servidor.

Etapa 7: solucionar problemas

Comece com as etapas de solução de problemas sugeridas na página Autenticação. Se essas etapas não resolverem o problema, consulte [Solucionar problemas do SAML](https://help.tableau.com/current/server/pt-br/saml_trouble.htm).

<!-- document id=759ab433513f1037c58ddaf2f07298b77dc780f7c4cb9a56df646ecad05c1098 url=/tableau/current/pt-br/server/distrib_cfs.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar Serviço de arquivo do cliente

O serviço de arquivos do cliente (CFS) gerencia a maioria dos arquivos compartilhados em um cluster com vários nós. Por exemplo, certificados, chaves e arquivos relacionados à autenticação (OpenID, SSL mútuo, SAML e Kerberos) e arquivos de personalização são gerenciados pelo CFS.

Uma única instância do CFS (Serviço de arquivo do cliente) é configurada no nó inicial ao instalar o Tableau Services Manager (TSM) e o Tableau Server pela primeira vez. Você pode e deve configurar instâncias adicionais em outros nós.

Em um cluster, se um nó que está executando sua única instância do CFS falhar, todos os arquivos gerenciados pelo CFS serão perdidos e você precisará preencher novamente esses arquivos do CFS, reimportando certificados e imagens personalizadas e fazendo quaisquer alterações de configuração relacionadas.Para obter uma lista de arquivos gerenciados pelo CFS, consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

Lembre-se destas limitações e recomendações:

- Deve haver pelo menos uma instância do CFS para qualquer instalação do Tableau Server. Não é possível remover todas as instâncias do CFS.
- Recomendamos não configurar mais de uma instância em qualquer nó. As instâncias adicionais não forneceriam qualquer benefício e seriam um desperdício de recursos.
- Recomendamos configurar uma instância do CFS em cada nó onde você implanta o Serviço de coordenação. Isso fornece redundância e ajuda a proteger o Tableau Server de erros inesperados no caso de falha de um nó.

Este artigo explica como adicionar ou remover uma instância do CFS. Não é possível configurar o CFS na interface do usuário na Web. É necessário usar o CLI para adicionar ou remover o CFS. O procedimento é o mesmo usado para adicionar um processo a um nó.

## Configurar o CFS em nós adicionais

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó ao qual você está adicionando o CFS:
    
    `tsm topology list-nodes -v`
3. Adicione o CFS ao nó especificando o nó, o processo e uma única instância.
    
    Por exemplo, este comando adiciona uma instância do CFS ao node2:
    
    `tsm topology set-process -n node2 -pr clientfileservice -c 1`
    
    Se você tentar adicionar uma instância do CFS a um nó que já foi configurado com o CFS, uma mensagem de erro informará que já existe uma instância no nó.
    
    Para adicionar o CFS a outros nós, repita essa etapa para cada nó.
4. Aplique as alterações:
    
    `tsm pending-changes apply`

<!-- document id=073ba257e818dd3cd3daf725f04a7f364cb6c532f4677432a4fd8a4e6c1ad241 url=/tableau/current/pt-br/server/snowflake_key_pair_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar o Tableau para autenticação de par de chaves do Snowflake

Para publicar pastas de trabalho ou fluxos usando fontes de dados do Snowflake protegidas com autenticação de par de chaves do Tableau Desktop ou Tableau Prep em um Tableau Cloud ou site do Tableau Server, você também deve configurar esse site para oferecer suporte a essas credenciais. Isso envolve adicionar seus detalhes de autenticação novos ou atualizados para autenticação do par de chaves Snowflake na seção Credenciais salvas das suas Configurações da conta.

**Observações**

- Para aceitar o uso de autenticação de par de chaves para se conectar ao Snowflake, instale um driver de ODBC do Snowflake com versão 3.4.0 ou posterior.
- Você precisa usar o OpenSSL versão 3.x ou mais recente para criar as chaves para esta autenticação.
- Cada instância do Tableau Desktop que usa dados do Snowflake protegidos pela autenticação de par de chaves exigirá que o usuário forneça o arquivo-chave como parte da conexão com os dados. Para obter mais informações, consulte [Snowflake](https://help.tableau.com/current/pro/desktop/pt-br/examples_snowflake.htm).
- Pastas de trabalho, fontes de dados e fluxos do Prep que contêm autenticação de par de chaves devem ser publicados no Tableau Cloud ou Tableau Server no Tableau Desktop ou Tableau Prep Builder.
- A autenticação de par de chaves não é aceita no momento para o seguinte:
    
    - Criação na Web de pasta de trabalho ou fonte de dados, incluindo a edição de pastas de trabalho ou fontes de dados publicadas existentes na Web
    - Criação na Web do Prep, incluindo a edição de fluxos existentes do Prep na Web
    - Conexões virtuais (VConns)

## Adicionar detalhes de autenticação de par de chaves

1. Entre no Tableau Cloud ou no Tableau Server e acesse a página Minhas configurações de conta.
2. Localize Credenciais salvas para fontes de dados na seção Segurança.
3. Ao lado de Snowflake, clique em Adicionar.
4. Na janela Adicionar uma nova credencial salva, selecione Autenticação de par de chaves e clique em Adicionar.
5. Na janela Adicionar credencial de autenticação de par de chaves, insira seu servidor Snowflake, sua Função (opcional) e o nome de usuário associado a essas credenciais.
    
    Observação: a função e o nome de usuário diferenciam maiúsculas de minúsculas e devem corresponder ao que foi salvo no Tableau Cloud ou no Tableau Server em Minhas configurações de conta > Informações do par de chaves do Snowflake.
6. Para Arquivo de chave privada, clique em Escolher um arquivo e selecione o arquivo .p8 que contém sua chave privada.
7. (Opcional) Se a chave tiver uma senha ou frase secreta associada a ela, insira-a no campo Senha campo e clique em Adicionar.

Agora você está pronto para compartilhar pastas de trabalho e fluxos protegidos pela autenticação de par de chaves de Tableau Desktop ou do Tableau Prep Builder para seu site.

## Consulte também

- [Snowflake](https://help.tableau.com/current/pro/desktop/pt-br/examples_snowflake.htm) - Aprenda a configurar uma conexão com o Snowflake para recuperar e analisar dados.

<!-- document id=8562b50bd2bcb8991c73787105e5a95447f84af9b2968dc671301b2a851f846c url=/tableau/current/pt-br/server/config_sap_hana_sso.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar SSO para SAP HANA

É possível configurar o Tableau Server para usar a delegação de SAML para fornecer uma experiência de Logon único (SSO) para SAP HANA. Esse cenário não depende da autenticação de SAML para o Tableau Server. Não é necessário usar o logon de SAML com o Tableau Server para usar a delegação de SAML do HANA; pode entrar no Tableau Server usando o método que escolher.

Com a delegação de SAML para SAP HANA, o Tableau Server funciona como um provedor de identidade (IdP).

## Antes de começar

Configurar a delegação de SAML com o SAP HANA requer configurações no Tableau Server e no SAP HANA. Este tópico oferece informações sobre a configuração do Tableau Server. Antes de configurar o Tableau Server, é necessário:

- Adquirir um certificado SAML e arquivo-chave do Tableau Server.
    - Arquivo de certificado deve ser um certificado x509 com codificação PEM com a extensão de arquivo .crt ou .cert. Este arquivo é usado pelo Tableau Server e também deve ser instalado no HANA.
    - A chave privada deve ser um arquivo de chave privada codificado por DER, no formato PKCS#8, não protegido por senha e com a extensão de arquivo .der. Este arquivo é usado somente pelo Tableau Server.
- Instalar os arquivos no HANA Para evitar erros de `libxmlsec` no HANA, recomendamos configurar o armazenamento de certificados na memória no SAP HANA. Para obter mais informações, consulte este [tópico de suporte SAP](https://launchpad.support.sap.com/#/notes/0002148434).
- Instale a versão mais recente do driver SAP HANA (a versão mínima é a 1.00.9) no Tableau Server.
- Configure a codificação de rede do Tableau Server como SAP HANA (recomendado).

Para obter mais informações sobre como gerar o certificado/par de chave, codificar a conexão SAML e configurar o SAP HANA, consulte [Como configurar o SAP HANA para o SSO do SAML com o Tableau Server](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX00000gUuG80AK "Link para a Comunidade do Tableau Trailhead") na Comunidade do Tableau Trailhead.

## Configurar o Tableau Server para usar SAML para SAP HANA:

O procedimento abaixo descreve como configurar o SAML para SAP HANA no Tableau Server usando `[tsm data-access](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#set-saml-delegation)`. Também é possível configurar o SAML para SAP HANA usando a [Entidade sapHanaSettings](https://help.tableau.com/current/server/pt-br/entity_sapHanaSettings.htm).

Se estiver executando o Tableau Server em uma implantação distribuída, execute o procedimento a seguir no nó inicial.

1. Coloque os arquivos de certificado em uma pasta chamada `saml`. Por exemplo:
    
    `C:\Program Files\Tableau\Tableau Server\SAML`
2. Execute os comandos a seguir para especificar o local do certificado e arquivos-chave:
    
    `tsm data-access set-saml-delegation configure --cert-key <cert-key> --cert-file <cert-file>`
    
    Onde `<cert-key>` e `<cert-file>` são caminhos de arquivo para a chave privada e para o arquivo de certificado, respectivamente.
    
    Por exemplo,
    
    `tsm data-access set-saml-delegation configure --cert-key "c:\Program Files\Tableau\Tableau Server\SAML\saml_key.der" --cert-file "c:\Program Files\Tableau\Tableau Server\SAML\saml_cert.crt"`
    
    Você pode especificar outras opções. Por exemplo, é possível especificar o formato do nome de usuário e como as credenciais são normalizadas. Consulte [tsm data-access](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#set-saml-delegation).
3. Execute os seguintes comandos para habilitar a delegação:
    
    `tsm data-access set-saml-delegation enable`
    
    `tsm configuration set -k wgserver.sap_hana_sso.enabled -v true`
    
    `tsm configuration set -k wgserver.delegation.enabled -v true`
4. Ao terminar, execute `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).

<!-- document id=d61f9d797779108f9460880eed518a2804f602fb692f381315e43ef83b238d22 url=/tableau/current/pt-br/server/server_tsig_configure_tls.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar TLS no Independent Gateway

O suporte a TLS para Independent Gateway está no Tableau Server 2022.1.2 e posterior.

Tanto o Tableau Server quanto o Tableau Server Independent Gateway usam o módulo SSL (mod\_ssl) criado com OpenSSL para implementar os recursos TLS (Transport Layer Security).

Devido à sua complexidade e natureza sensível à segurança, recomendamos que a configuração do TLS seja planejada e implementada por um profissional de TI que esteja familiarizado com o TLS no Apache httpd.

Em muitos casos, usamos "SSL" nos nomes de coisas para compatibilidade com as propriedades ou conceitos de configuração TSM ou Apache httpd existentes. "SSL" na verdade se refere a versões de protocolo agora consideradas inseguras e obsoletas. No entanto, o nome legado persiste e geralmente é usado de forma intercambiável com TLS como convenção. O Tableau Server e o Independent Gateway não são compatíveis com protocolos da era SSL.

**Importante:** a partir da versão 2025.2 (Tableau Desktop), 2025.3 (Tableau Server) e de junho de 2025 (Tableau Cloud), o Tableau usa OpenSSL 3.4.x e segurança de nível 2. A segurança de nível 2 requer chaves de 2048 bits ou mais. Todas as chaves de segurança de nível 1 existentes não funcionarão mais e você precisará gerar e implantar um novo par de chaves. Se você estiver gerando chaves com pelo menos 2048 bits, conforme recomendado, nenhuma ação será necessária. Para obter mais informações, consulte [Gerar uma chave](https://help.tableau.com/current/server/pt-br/ssl_cert_create.htm#generate-key).

## Exemplo de configuração do TSL

Para obter um exemplo de configuração TLS de ponta a ponta, consulte [Configurar SSL/TLS do balanceador de carga para o Tableau Server](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part6.htm#configure-ssltls-from-load-balancer-to-tableau-server) no Guia de implantação corporativa. O tópico mostra um exemplo passo a passo de configuração do TLS no Tableau Server no Linux em uma implantação da AWS. Embora o exemplo descreva o processo para Linux, o exemplo de configuração também é útil para o Tableau Server no Windows.

## Visão geral da configuração do TSL

Você pode configurar o TLS para HTTPS em qualquer uma das seguintes seções do caminho da Internet para o Tableau Server:

- Da rede externa (Internet ou balanceador de carga front-end) para o Independent Gateway
- De Independent Gateway para Tableau Server
- Para o processo de manutenção (HK) do Tableau Server para o Independent Gateway

Este tópico fornece procedimentos para configurar cada um desses saltos.

Você precisará fazer alterações de configuração nos computadores do Independent Gateway e no cluster do Tableau Server.

### Requisitos e considerações do certificado

Os requisitos de certificado para o Independent Gateway são os mesmos especificados para o Tableau Server "SSL externo". Consulte [Requisitos do certificado SSL](https://help.tableau.com/current/server/pt-br/ssl_config.htm#cert-req).

Outras considerações:

- Para simplificar o gerenciamento e a implantação de certificados e como prática recomendada de segurança, recomendamos o uso de certificados gerados por uma autoridade de certificação (CA) de terceiros confiável. Como alternativa, você pode gerar certificados autoassinados ou usar certificados de uma PKI para TLS. Nesse caso, preste atenção às opções de configuração para confiar em certificados de CA e validar certificados.
- Se sua implementação exigir o uso de um arquivo de cadeia de certificados, consulte o artigo da Base de Conhecimento, [Configurar TLS no Independent Gateway ao usar um certificado que tenha uma cadeia de certificados](https://kb.tableau.com/articles/HowTo/configure-tls-on-independent-gateway-when-using-intermediate-certificate?lang=pt-br) .
- Se você estiver executando várias instâncias do Independent Gateway, deverá distribuir certificados para cada computador no mesmo local (caminho do arquivo).
- Se você estiver executando uma implantação do Tableau Server com mais de um nó, os certificados carregados com comandos do TSM serão distribuídos automaticamente entre os nós. Execute todos os comandos do TSM no nó inicial.

## Configurações globais de TLS

As configurações a seguir são globais. As opções de configuração abaixo referem-se às chaves de configuração que devem ser definidas com o comando `tsm configuration set`. Os comandos devem incluir a opção `--force-keys`.

É improvável que você precise alterar esses valores.

Observe que cada par de chaves compartilha o mesmo formato de nomenclatura, em que a cadeia de caracteres ,`tsig`, define o valor do Independent Gateway. A chave que _não_ inclui a cadeia de caracteres, `tsig`, define o valor do processo de gateway no cluster do Tableau Server.

Se você não definir um valor para a chave `tsig`, o valor padrão do gateway do Tableau Server será usado.

`gateway.tsig.httpd.socache` ou `gateway.httpd.socache`

Padrão: `shmcb`

Valor alternativo: `dbm`

O tipo de armazenamento do Cache de Sessão SSL entre processos. Para obter mais informações sobre os tipos de armazenamento, consulte [Diretiva SSLSessionCache](https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslsessioncache) no site da Web Apache.

`gateway.tsig.httpd.shmcb.size` ou `gateway.httpd.shmcb.size`

Padrão: `2048000`

Quantidade de memória, em bytes, a ser usada para o buffer circular ao usar o tipo de armazenamento `shmcb`.

**Observação**: outra chave global é `gateway.tsig.ssl.key.passphrase.dialog`. Se aplicável, há apenas uma única configuração para `gateway.tsig.ssl.key.passphrase.dialog`. Por design, ele coleta senhas para todos os arquivos de chave privada criptografados na configuração. As seções aplicáveis posteriormente neste tópico descrevem o uso dessa chave.

## TLS externo para Independent Gateway

O processo de configuração de conexões externas para encerrar o TLS nos servidores de Independent Gateway é conceitualmente semelhante a como o "SSL externo" é configurado para um cluster do Tableau Server. A mecânica é diferente. O TSM não distribui automaticamente certificado e material de chave para nós de Independent Gateway. Além disso, o Independent Gateway não fornece automaticamente uma maneira de fornecer a senha da chave TLS opcional na inicialização.

As etapas a seguir descrevem como configurar o TLS de fonte externa para computadores Independent Gateway.

### Etapa 1: distribuir arquivos para computadores de Independent Gateway

1. Coloque certificados e arquivos relacionados em um local e com permissões que permitam que o serviço Independent Gateway (tsig-httpd) os leia. Recomendamos restringir o acesso aos arquivos de chave de forma que apenas o serviço Independent Gateway possa lê-los.
2. Coloque todos os arquivos, certificados e chaves exatamente nos mesmos locais em todos os computadores do Independent Gateway. Coloque os arquivos fora dos caminhos TSIG\_INSTALL e TSIG\_DATA para que eles não sejam removidos se você reinstalar ou atualizar o Independent Gateway.

### Etapa 2: atualizar variáveis de ambiente em computadores do Independent Gateway

Em cada computador do Independent Gateway, defina as variáveis de ambiente `TSIG_PORT` e `TSIG_PROTOCOL` para`443` (por convenção, mas qualquer número de porta TCP não utilizado é suportado) e `https` respectivamente.

Altere esses valores executando novamente a cadeia de caracteres de pós-instalação para fornecer um valor diferente para `TSIG_PORT` e `TSIG_PROTOCOL`. Por padrão, o script está em `C:\Program Files\Tableau\Tableau Server\independentgateway\scripts\initialize-tsig.bat`.

### Etapa 3: definir as propriedades de configuração do TLS em Tableau Server

A maioria das chaves de configuração do TSM na tabela a seguir são derivadas das diretivas httpd do Apache. Assim, os valores de configuração para essas chaves de configuração do TSM são mapeados diretamente para os valores válidos para a diretiva Apache correspondente. Os links para as diretivas correspondentes estão incluídos na tabela a seguir.

Em alguns casos, a configuração usará configurações de fallback se uma chave específica não estiver definida. Elas são chamadas na tabela abaixo.

As opções de configuração na tabela a seguir referem-se às chaves de configuração que você deve definir com o comando `tsm configuration set`. Todos os comandos devem incluir a opção`--force-keys`. Por exemplo:

tsm configuration set -k gateway.tsig.ssl.enabled -v true --force-keys

Depois de definir as chaves de configuração, você deve executar `tsm pending-changes apply`.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 40%;"><col style="width: 40%;"><col style="width: 20%;"></colgroup><tbody><tr><th>Propriedade de configuração</th><th>Descrição</th><th>Diretiva correspondente do Apache</th></tr><tr><td>gateway.tsig.ssl.enabled</td><td><p>Obrigatório.</p><p>Habilita TLS. Deve ser definido para <code>true</code>.</p></td><td>N/A</td></tr><tr><td>gateway.tsig.ssl.cert.file_name</td><td><p>Obrigatório.</p><p>Caminho + nome de arquivo do arquivo de certificado para Independent Gateway. Por exemplo, <code>/etc/ssl/certs/tsig-ssl.crt</code>.</p></td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcacertificatefile" target="_blank">SSLCertificateFile</a></td></tr><tr><td>gateway.tsig.ssl.key.file_name</td><td><p>Obrigatório.</p><p>Caminho + nome do arquivo de chave de certificado para o Independent Gateway. Por exemplo, <code>/etc/ssl/keys/tsig-ssl.key</code>.</p></td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcertificatekeyfile" target="_blank">SSLCertificateKeyFile</a></td></tr><tr><td>gateway.tsig.ssl.key.passphrase.dialog</td><td>Se sua chave requer uma senha, você deve configurar essa chave com a string correta esperada pela diretiva Apache httpd SSLPassPhraseDialog. Não insira a senha literal para esta chave. Consulte a documentação do Apache para obter informações sobre como configurar essa chave.<br>Essa configuração é global para o Independent Gateway.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslpassphrasedialog" target="_blank">Caixa de diálogo SSLPassPhrase</a></td></tr><tr><td><p>gateway.tsig.ssl.protocols</p><p>Fallback: ssl.protocols</p></td><td>Especifique as versões suportadas de SSL/TLS. Consulte <a href="https://help.tableau.com/current/server/pt-br/security_harden.htm" class="xref">Lista de verificação do reforço de segurança</a> para obter mais informações sobre a configuração padrão.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslprotocol" target="_blank">SSLProtocols</a></td></tr><tr><td><p>gateway.tsig.ssl.ciphersuite</p><p>Fallback:&nbsp;ssl.ciphersuite</p></td><td>Especifica as cifras que o cliente tem permissão para negociar para conexão SSL.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslciphersuite" target="_blank">SSLCipherSuite</a></td></tr><tr><td>gateway.tsig.ssl.client_certificate_login.required</td><td><p>Defina este valor como <code>true</code> para habilitar o TLS mútuo nesta conexão.</p><p>Você também deve definir a propriedade <code>gateway.tsig.ssl.cacert.file</code> conforme especificado abaixo.</p></td><td>N/A</td></tr><tr><td>gateway.tsig.ssl.cacert.file</td><td>Especifica o arquivo que contém os certificados de CA concatenados para o processo de autenticação do cliente.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcacertificatefile" target="_blank">SSLCACertificateFile</a></td></tr><tr><td>gateway.tsig.ssl.revocation.file</td><td>Especifica o arquivo que contém as listas de revogação de CA concatenadas para clientes que se conectam ao Independent Gateway.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcarevocationfile" target="_blank">SSLCARRevocationFile</a></td></tr><tr><td>gateway.tsig.ssl.redirect</td><td><p>Quando o gateway independente tiver sido configurado para TLS, esta opção forçará as solicitações do cliente da porta 80 (padrão) a redirecionar para o TLS.</p><p>Padrão: <code>true</code>.</p></td><td>N/A</td></tr><tr><td>gateway.tsig.ssl.redirect_from_port</td><td><p>Quando <code>gateway.tsig.ssl.redirect</code> está configurado para <code>true</code>, esta opção permite especificar a porta da qual o tráfego é redirecionado.</p><p>Padrão: <code>80</code>.</p></td><td>N/A</td></tr></tbody></table>

## Independent Gateway no Tableau Server

Esta seção descreve como criptografar a conexão entre o Independent Gateway e o Tableau Server.

### Etapa 1: configurar e habilitar o TLS no Tableau Server

Consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm).

Observe que "SSL" é, na verdade, uma implementação de TLS e "externo" refere-se a uma conexão externa ao Tableau Server. Nesse cenário, o Independent Gateway é a conexão "externa".

Recomendamos habilitar e verificar se os clientes podem se conectar com o TLS diretamente ao Tableau Server antes de configurar o Independent Gateway.

### Etapa 2: distribuir arquivos de certificado em computadores do Independent Gateway

Você precisará distribuir arquivos de certificado nos computadores do Independent Gateway se uma das seguintes condições for verdadeira:

- Você está usando certificados autoassinados ou PKI para os certificados TLS na implantação do Tableau Server.
- Você está habilitando o TLS mútuo na conexão do Independent Gateway com o Tableau Server.

Assim como todos os arquivos relacionados a TLS em computadores com Independent Gateway, você deve colocar os arquivos nos mesmos caminhos em cada computador. Além disso, todos os nomes de arquivo para arquivos compartilhados TLS devem ser os mesmos.

### Etapa 3: definir as propriedades de configuração do TLS em Tableau Server

A maioria das chaves de configuração do TSM na tabela a seguir são derivadas das diretivas httpd do Apache. Assim, os valores de configuração para essas chaves de configuração do TSM são mapeados diretamente para os valores válidos para a diretiva Apache correspondente. Os links para as diretivas correspondentes estão incluídos na tabela a seguir.

Em alguns casos, a configuração usará configurações de fallback se uma chave específica não estiver definida. Elas são chamadas na tabela abaixo.

As opções de configuração na tabela a seguir referem-se às chaves de configuração que você deve definir com o comando `tsm configuration set`. Todos os comandos devem incluir a opção`--force-keys`. Por exemplo:

tsm configuration set -k gateway.tsig.ssl.enabled -v true --force-keys

Depois de definir as chaves de configuração, você deve executar `tsm pending-changes apply`.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 40%;"><col style="width: 40%;"><col style="width: 20%;"></colgroup><tbody><tr><th>Propriedade de configuração</th><th>Descrição</th><th>Diretiva correspondente do Apache</th></tr><tr><td><p>gateway.tsig.ssl.proxy.cacertificatefile</p></td><td>Se sua organização usa um certificado TLS autossingrado ou gerado por PKI para o Tableau Server, você deve especificar um caminho para o arquivo de certificado CA raiz. Esse arquivo de certificado CA raiz deve ser armazenado nos computadores do Independent Gateway.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslproxycacertificatefile" target="_blank">SSLProxyCACertificateFile </a></td></tr><tr><td><p>gateway.tsig.ssl.proxy.protocols</p><p>Fallback: ssl.protocols</p></td><td>Especifique as versões suportadas de SSL/TLS. Consulte <a href="https://help.tableau.com/current/server/pt-br/security_harden.htm" class="xref">Lista de verificação do reforço de segurança</a> para obter mais informações sobre a configuração padrão.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslprotocol" target="_blank">SSLProtocols</a></td></tr><tr><td><p>gateway.tsig.ssl.proxy.ciphersuite</p><p>Fallback:&nbsp;ssl.ciphersuite</p></td><td>Especifica as cifras que o cliente tem permissão para negociar para conexão SSL.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslciphersuite" target="_blank">SSLCipherSuite</a></td></tr><tr><td>gateway.tsig.ssl.proxy.machinecertificatefile</td><td>Para TLS mútuo. Especifica o arquivo que contém os pares de chave de certificado concatenados para autenticação do Independent Gateway para o Tableau Server.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslproxymachinecertificatefile" target="_blank">SSLProxyMachineCertificateFile</a></td></tr><tr><td>gateway.tsig.ssl.proxy.verify</td><td><p>Especifique se o Independent Gateway deve verificar o certificado apresentado pelo Tableau Server.</p><p>O padrão é <code>require</code>.</p></td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslproxyverify" target="_blank">SSLProxyVerify</a></td></tr><tr><td>gateway.tsig.ssl.proxy.checkpeername</td><td><p>Especifique se o Independent Gateway inspeciona o certificado do Tableau Server para verificar se o nome da entidade corresponde ao nome do servidor.</p><p>O padrão é <code>off</code>.</p></td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslproxycheckpeername" target="_blank">SSLProxyCheckPeerName</a></td></tr><tr><td>gateway.tsig.ssl.proxy.checkpeerexpire</td><td><p>Especifique se o Independent Gateway inspeciona o certificado do Tableau Server para verificar a validade:</p><p>O padrão é <code>off</code>.</p></td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslproxycheckpeerexpire" target="_blank">SSLProxyCheckPeerExpire</a></td></tr></tbody></table>

### Etapa 4: carregar o certificado de CA raiz para o Tableau Server

Se o certificado TLS que você está usando nos computadores do Independent Gateway for um certificado autoassinado ou gerado por PKI, você deverá executar esta etapa adicional. Se o certificado TLS que você está usando no computador do Independent Gateway for um certificado de uma autoridade de certificação de terceiros confiável, você poderá ignorar esta etapa.

Copie o certificado de CA raiz usado para os computadores do Independent Gateway para o nó inicial do Tableau Server e execute os seguintes comandos:

tsm security custom-cert add -c <root-certificate-file-name>.pem
tsm pending-changes apply

## Conexão de manutenção do Tableau Server e o Independent Gateway

O processo de manutenção (HK) mantém o estado de configuração entre a implantação do Tableau Server de back-end e o Independent Gateway.

Quando o Independent Gateway é instalado, a configuração padrão fornece uma conexão HTTP não criptografada. O Independent Gateway escuta solicitações de manutenção originadas no cluster do Tableau Server (conforme você o definiu durante a instalação).

Se você estiver executando várias instâncias do Independent Gateway, todos os servidores deverão aceitar solicitações de manutenção com TLS ou todos sem TLS. Esta seção descreve como configurar a conexão HK para TLS. Esse processo requer a reinicialização do Tableau Server e resultará em tempo de inatividade.

Assim como nos cenários TLS anteriores descritos acima, muitas das alterações de configuração para a conexão HK são definidas nas propriedades de configuração gerenciadas pelo cluster do Tableau Server. No entanto, a configuração TLS de HK requer etapas adicionais no Independent Gateway.

### Etapa 1: distribuir arquivos para computadores de Independent Gateway

Se você habilitou o TLS com rede externa e Independent Gateway, você pode usar o mesmo certificado e arquivos de chave para a conexão HK.

Se você estiver usando os mesmos ativos, o único outro arquivo de certificado que você precisa distribuir é o certificado CA raiz do certificado usado pelo Tableau Server. Se o certificado TLS apresentado pelo Tableau Server for gerado por uma autoridade de certificação confiável de terceiros, você não precisará copiar um certificado de autoridade de certificação raiz para os computadores do Independent Gateway.

1. Coloque certificados e arquivos relacionados em um local e com permissões que permitam que o serviço Independent Gateway (tsig-httpd) os leia. Recomendamos restringir o acesso aos arquivos de chave de forma que apenas o serviço Independent Gateway possa lê-los.
2. Coloque todos os arquivos, certificados e chaves exatamente nos mesmos locais em todos os computadores do Independent Gateway.

### Etapa 2: importar o certificado de CA raiz do Independent Gateway para o armazenamento confiável do Tableau Server

Se o certificado TLS que você está usando nos computadores do Independent Gateway for um certificado autoassinado ou gerado por PKI, você deverá executar esta etapa adicional. Se o certificado TLS que você está usando no computador do Independent Gateway for um certificado de uma autoridade de certificação de terceiros confiável, você poderá ignorar esta etapa.

Você só pode carregar um certificado de CA raiz para o Tableau Server. Portanto, se você já carregou um certificado de CA raiz, o mesmo certificado de CA raiz deve assinar o certificado que você usará para conexão HK.

Copie o certificado de CA raiz usado para os computadores do Independent Gateway para o nó inicial do Tableau Server e execute os seguintes comandos:

tsm security custom-cert add -c <root-certificate-file-name>.pem
tsm pending-changes apply

### Etapa 3: atualizar variáveis de ambiente em computadores do Independent Gateway

Em cada computador do Independent Gateway , defina a variável ambiental `TSIG_HK_PROTOCOL` para`https` . Você pode especificar uma porta alternativa para HK (o padrão é 21319) configurando também a variável de ambiente `TSIG_HK_PORT`.

Altere esses valores executando novamente a cadeia de caracteres de pós-instalação para fornecer um valor diferente para `TSIG_HK_PROTOCOL` e `TSIG_HK_PORT`. Por padrão, o script está em `C:\Program Files\Tableau\Tableau Server\independentgateway\scripts\initialize-tsig.bat`.

### Etapa 4: atualizar httpd.conf.stub no Independent Gateway

Você deve atualizar o arquivo `httpd.conf.stub` em cada servidor Independent Gateway . O arquivo `httpd.conf.stub` é usado para propagar a configuração global do httpd.

O arquivo está localizado em `TSIG_DATA/config/httpd.conf.stub`.

1. Abra o arquivo `httpd.conf.stub` em um editor de texto. Você deve atualizar o bloco `<VirtualHost *:${TSIG_HK_PORT}>` com detalhes de configuração HK. O exemplo a seguir mostra as alterações necessárias:
    
    <VirtualHost \*:${TSIG\_HK\_PORT}>
     SSLEngine on
     #TLS# SSLHonorCipherOrder on
     #TLS# SSLCompression off
     SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
     SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
     SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>				
    
    Observações:
    
    - Por padrão, cada linha no bloco `<VirtualHost *:${TSIG_HK_PORT}>` é comentado pela cadeia de caracteres, `#TLS#`. Para "habilitar" uma linha no bloco, exclua a cadeia de caracteres `#TLS#` no início da linha.
    - Como em todas as configurações do httpd, cada arquivo referenciado requer um caminho absoluto para o arquivo.
    - `SSLCACertificateFile` especifica o certificado de CA raiz para a CA que gera o certificado apresentado pelo Tableau Server. Você só precisa definir isso se o certificado TLS usado pelo Tableau Server for autoassinado ou gerado por uma PKI.
2. Pare o serviço tsig-httpd.
    
    Você começará a receber verificações de status com falha neste ponto, indicando no TSM que seu componente de Independent Gateway está degradado.
3. Cópia de `httpd.conf.stub` para `httpd.conf`.
    
    O arquivo `httpd.conf` está no mesmo diretório. Substitua o arquivo `httpd.conf` pelo arquivo `httpd.conf.stub`.
4. Inicie o serviço tsig-httpd.
    
    Você continuará recebendo verificações de status com falha neste momento, indicando no TSM que seu componente de Independent Gateway está degradado. Essas verificações de status falharão até que você tenha concluído a configuração conforme descrito nas etapas a seguir.

### Etapa 5: defina as propriedades de configuração do TLS no Tableau Server

A aplicação das alterações de configuração requer uma reinicialização do servidor. Para evitar longos tempos de espera, recomendamos interromper o servidor antes de aplicar as alterações definidas aqui. Na Etapa 6, você executará um comando de atualização e reiniciará o TSM. Parar o TSM nesta fase da configuração resulta em um tempo de inatividade mais curto.

1. Pare o TSM. Execute o seguinte comando:
    
    tsm stop
2. A maioria das chaves de configuração do TSM na tabela a seguir são derivadas das diretivas httpd do Apache. Assim, os valores de configuração para essas chaves de configuração do TSM são mapeados diretamente para os valores válidos para a diretiva Apache correspondente. Os links para as diretivas correspondentes estão incluídos na tabela a seguir.
    
    Existem nomes de propriedades de configuração do TSM que incluem o nó `hk` no prefixo: `gateway.tsig.hk.xyz.abc`. Se configurados, esses valores são usados para a configuração HK TLS. Se não for definido, muitas propriedades de configuração usarão o fallback para `gateway.tsig.xyz.abc`, que podem ou não recair `gateway.xyz.abc`. A propriedade de configuração de fallback é listada quando relevante.
    
    As opções de configuração na tabela a seguir referem-se às chaves de configuração que você deve definir com o comando `tsm configuration set`. Todos os comandos devem incluir a opção`--force-keys`. Por exemplo:
    
    tsm configuration set -k gateway.tsig.hk.ssl.enabled -v true --force-keys
    
    <table style="width: 100%;" class="simple-table"><colgroup><col style="width: 40%;"><col style="width: 40%;"><col style="width: 20%;"></colgroup><tbody><tr><th>Propriedade de configuração</th><th>Descrição</th><th>Diretiva correspondente do Apache</th></tr><tr><td><p>gateway.tsig.hk.ssl.enabled</p><p>(Sem fallback)</p></td><td><p>Obrigatório.</p><p>Habilita TLS. Deve ser definido para <code>true</code>.</p></td><td>N/A</td></tr><tr><td><p>gateway.tsig.hk.ssl.cert.file_name</p><p>Fallback:</p><p>gateway.tsig.ssl.cert.file_name</p></td><td><p>Caminho + nome de arquivo do arquivo de certificado para Independent Gateway. Por exemplo, <code>/etc/ssl/certs/tsig-ssl.crt</code>.</p></td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcacertificatefile" target="_blank">SSLCertificateFile</a></td></tr><tr><td><p>gateway.tsig.hk.ssl.key.file_name</p><p>Fallback:</p><p>gateway.tsig.ssl.key.file_name</p></td><td><p>Caminho + nome do arquivo de chave de certificado para o Independent Gateway. Por exemplo, <code>/etc/ssl/keys/tsig-ssl.key</code>.</p></td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcertificatekeyfile" target="_blank">SSLCertificateKeyFile</a></td></tr><tr><td><p>gateway.tsig.ssl.key.passphrase.dialog</p><p>(Propriedade global)</p></td><td>Se sua chave requer uma senha, você deve configurar essa chave com a string correta esperada pela diretiva Apache httpd SSLPassPhraseDialog.<br>Essa configuração é global para o Independent Gateway.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslpassphrasedialog" target="_blank">Caixa de diálogo SSLPassPhrase</a></td></tr><tr><td><p>gateway.tsig.hk.ssl.protocols</p><p>Fallbacks:</p><p>gateway.tsig.ssl.protocols</p><p>ssl.protocols</p></td><td>Especifique as versões suportadas de SSL/TLS. Consulte <a href="https://help.tableau.com/current/server/pt-br/security_harden.htm" class="xref">Lista de verificação do reforço de segurança</a> para obter mais informações sobre a configuração padrão.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslprotocol" target="_blank">SSLProtocols</a></td></tr><tr><td><p>gateway.tsig.hk.ssl.ciphersuite</p><p>Fallbacks:</p><p>gateway.tsig.ssl.ciphersuite</p><p>ssl.ciphersuite</p></td><td>Especifica as cifras que o cliente tem permissão para negociar para conexão SSL.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslciphersuite" target="_blank">SSLCipherSuite</a></td></tr><tr><td><p>gateway.tsig.hk.ssl.client_certificate_login.required</p><p>(Sem fallback)</p></td><td><p>Defina este valor como <code>true</code> para habilitar o TLS mútuo nesta conexão.</p><p>Você também deve definir a propriedade <code>gateway.tsig.hk.ssl.cacert.file</code> conforme especificado abaixo.</p></td><td>N/A</td></tr><tr><td><p>gateway.tsig.hk.ssl.cacert.file</p><p>Fallback:</p><p>gateway.tsig.ssl.cacert.file</p></td><td>Especifica o arquivo que contém os certificados de CA concatenados para o processo de autenticação do cliente.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcacertificatefile" target="_blank">SSLCACertificateFile</a></td></tr><tr><td><p>gateway.tsig.hk.ssl.revocation.file</p><p>Fallback:</p><p>gateway.tsig.hk.ssl.revocation.file</p></td><td>Especifica o arquivo que contém as listas de revogação de CA concatenadas para clientes que se conectam ao Independent Gateway.</td><td><a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcarevocationfile" target="_blank">SSLCARRevocationFile</a></td></tr></tbody></table>
3. Aplique as alterações. Execute o seguinte comando:
    
    `tsm pending-changes apply`.

### Etapa 6: atualizar o arquivo de configuração JSON do Independent Gateway

A etapa final é atualizar a configuração do Independent Gateway com um arquivo JSON refletindo a mudança para`https` e, se aplicável, outros números de porta.

Consulte o tópico de instalação para obter mais informações sobre como editar este arquivo. Consulte [Etapa 3: habilitar o Independent Gateway no Tableau Server](https://help.tableau.com/current/server/pt-br/server_tsig_new_install.htm#TSIG-enableIG).

Depois de atualizar o arquivo JSON, execute os seguintes comandos:

tsm topology external-services gateway update -c tsig.json
tsm start

## Solução de problemas

Para obter dicas de solução de problemas, consulte [Solução de problemas do Independent Gateway do Tableau Server](https://help.tableau.com/current/guides/enterprise-deployment/pt-br/edg_part7.htm#troubleshooting-tableau-server-independent-gateway) no Guia de implantação corporativa (EDG). O EDG fornece exemplos de implantação do Tableau Server no Linux. As etapas de solução de problemas são úteis para as versões Windows ou Linux do Tableau Server.

<!-- document id=f4484c8011087f8703fd686e29023df91e446f93ade392b21dc906232a5c68c3 url=/tableau/current/pt-br/server/security_tsm_admin_group.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar um grupo de administração do TSM personalizado

Este tópico descreve como configurar um grupo de administração do TSM personalizado.

Por padrão, a conta de usuário usada para a administração do TSM deve ser um membro do grupo Administradores no computador que executa o Tableau Server. Em algumas organizações, a política de segurança exige a separação entre funções administrativas. Nesses cenários, a configuração padrão de administração do TSM não é permitida.

Você pode configurar o Tableau Server para usar um grupo arbitrário como um grupo de administração TSM personalizado. Uma vez configurado, qualquer usuário que seja membro do grupo personalizado poderá administrar o TSM.

Os usuários do grupo de administradores do Windows padrão ainda terão acesso total ao TSM.

## Etapa 1: criar um novo grupo

Você pode criar um grupo local do Windows ou um grupo no Active Directory. Recomendamos a criação de um grupo com configurações padrão. Não aplique ou remova permissões do grupo padrão criado pelo Windows.

**Observação**: o nome do grupo TSM padrão é `tsmadmin`. Se você criar o grupo Windows com o nome `tsmadmin`, então nenhuma configuração adicional no Tableau Server será necessária.

## Etapa 2: configurar o Tableau Server

O nome do grupo de administração de TSM personalizado é armazenado na chave de configuração `tsm.authorized.groups`. Se você quiser especificar um nome de grupo (diferente de `tsmadmin`) então você precisará atualizar a tecla de configuração `tsm.authorized.groups` e, em seguida, reiniciar o Tableau Server.

Use o comando tsm configuration set para definir o valor de nome do grupo. Por exemplo, para alterar o grupo administrativo do TSM para `myadmingroup`, execute os seguintes comandos:

tsm configuration set -k tsm.authorized.groups -v myadmingroup

tsm pending-changes apply

**Observações**

- Definir a chave de configuração `tsm.authorized.groups` substitui qualquer valor existente armazenado nessa chave.
- Você pode especificar vários grupos inserindo uma lista separada por vírgulas de nomes de grupos como o valor.

## Etapa 3: adicionar usuários ao novo grupo

Depois de terminar de configurar `tsm.authorized.groups`, qualquer usuário dos novos grupos que você especificou terá direitos administrativos de TSM completos no Tableau Server.

<!-- document id=02caaac2a33376254da2b29c504edd99f788c2f9db3523f37fac7ccd748b5144 url=/tableau/current/pt-br/server/subscribe.md -->

[Pular para o conteúdo principal](#main-content)

# Configurar um site para assinaturas

Quando os usuários inscrevem-se em uma pasta de trabalho ou exibição, um instantâneo da exibição é enviado por e-mail para eles de forma agendada, para que possam ter acesso às atualizações mais recentes sem precisar fazer logon no Tableau Server. Administradores, líderes de projeto com funções de site adequadas e proprietários de conteúdo têm a opção de inscrever outros usuários nas pastas de trabalho e exibições. Para obter mais informações, consulte [Inscrever-se em exibições.](https://help.tableau.com/current/pro/desktop/pt-br/subscribe_user.htm)

**Observação:** para criar e receber assinaturas, os usuários precisam ter acesso a bancos de dados e exibições relacionados. [Consulte esta lista de requisitos](https://help.tableau.com/current/server/pt-br/subscribe_alert_access.htm) para obter detalhes.

Procurando o Tableau Server no Linux? Consulte [Configurar um servidor para inscrições](https://help.tableau.com/current/server-linux/pt-br/subscribe.htm "Abre o tópico em uma nova guia do navegador").

## Pré-requisitos: configurar o servidor para enviar e-mails de assinatura

Antes que possa ativar assinaturas para um site, você precisa concluir as etapas para ativar assinaturas no servidor. Siga as etapas destes tópicos para configurar assinaturas no servidor.

1. [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm)
2. [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm)

## Habilitar assinaturas

Depois de configurar as notificações de eventos SMTP e de servidor, você pode habilitar as assinaturas.

Para habilitar assinaturas:

1. Entre no Tableau Server como administrador do servidor.
2. Acesse a guia Geral da página Configurações para o site que deseja configurar para assinaturas:
    
    - Se você tiver um único site, na navegação lateral, clique em Configurações e Geral.
    - Se você tiver vários sites, selecione o site que deseja configurar e clique em Configurações e Geral.
3. Role até Assinaturas e selecione as opções de assinatura para os usuários.
    
    **Observação:** as opções de assinatura só são visíveis após o administrador do TSM ativar a opção de configuração em todo o servidor, Permitir que os usuários recebam e-mail para exibições nas quais se inscreveram. Para obter detalhes, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).
    
    1. Selecione Permitir que usuários assinem pastas de trabalho e exibições
    2. (Opcional) Para permitir que os proprietários de conteúdo assinem outros usuários em seu conteúdo, selecione Permitir que os proprietários de conteúdo assinem outros usuários.
    3. (Opcional) Para permitir que os usuários incluam anexos a suas assinaturas, selecione Permitir que os usuários adicionem anexos a pastas de trabalho e exibições assinadas. Esta opção não estará disponível se o administrador do tsm não tiver habilitados anexos no TSM. Para obter detalhes, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).
4. (Opcional) Desça até Configurações de e-mail.
    
    1. Digite um Endereço de e-mail de que será exibido como o endereço “De” nas mensagens de e-mail.
    2. Digite um Rodapé de e-mail para mensagens de e-mail.
        
        O rodapé da mensagem e o endereço "De" e um rodapé de mensagem também são usados em e-mails para [alertas orientados por dados](https://help.tableau.com/current/server/pt-br/data_alerts_admin.htm).
5. (Opcional) Role até Rótulos de dados de alta visibilidade em assinaturas de exibição e de pasta de trabalho e selecione Incluir avisos de qualidade de alta visibilidade e rótulos de confidencialidade de alta visibilidade em e-mails de exibição e assinatura de pasta de trabalho. (Em versões anteriores: role até Avisos de qualidade de dados em assinaturas e selecione Incluir avisos de qualidade de dados em e-mails de assinatura .)
    
    **Observação:** os avisos de qualidade de dados em e-mails de assinatura só são visíveis quando o Tableau Catalog está habilitado. Para obter mais informações, consulte [Ativar o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm).
6. Clique em Salvar.

Para especificar as agendas de inscrição disponíveis para os usuários, consulte [Criar ou modificar uma agenda](https://help.tableau.com/current/server/pt-br/schedule_manage_create.htm).

## Testar inscrições em um site

1. [Inscreva-se em uma exibição](https://help.tableau.com/current/pro/desktop/pt-br/subscribe_user.htm).
2. No site com a assinatura que deseja testar, na navegação lateral, clique em Agendas.
3. Selecione a agenda escolhida para a inscrição e, em seguida, clique em Ações > Executar agora.
    
    Um instantâneo da exibição deve ser enviado por e-mail dentro de 10 minutos. Se tiver um problema, consulte [Solucionar problemas de assinaturas](https://help.tableau.com/current/server/pt-br/subscribe_trouble.htm).
    
    ![Um e-mail com uma visualização do Tableau que o usuário assinou.](/tableau/current/pt-br/server/pt-br/Img/subscribe_content_4.png)

## Gerenciar todas as inscrições do usuário

1. Na navegação lateral, clique em Tarefas e, em seguida, em Assinaturas.
    
    Todas as inscrições do usuário para o site atual são exibidas, incluindo informações como nome do assinante, nome de exibição e agendamento de entrega.
2. Selecione qualquer inscrição que deseja atualizar. No menu Ações, selecione Alterar agenda, Alterar assunto, Alterar o modo de exibição vazio ou Cancelar inscrição.
    
    (A opção de exibição vazia envia e-mails das incrições apenas quando existem dados em uma exibição. É uma boa opção para alertas de alta prioridade).

## Assinaturas suspensas

Por padrão, uma assinatura é suspensa depois de 5 falhas consecutivas e resulta no cancelamento de envio dos e-mails de assinatura. Para alterar o número limite de falhas de assinatura que podem ocorrer antes de serem suspensas, use a opção do tsm configuration set, backgrounder.subscription\_failure\_threshold\_for\_run\_prevention. Isso define o limite do número de falhas de assinatura consecutivas necessárias antes de suspender a assinatura. Esta é uma configuração em todo o servidor.

Somente administradores de servidor podem configurar o número limite de falhas na assinatura antes que uma assinatura seja suspensa.

Os administradores de servidor podem optar por receber notificações por e-mail quando uma assinatura for suspensa. Faça isso ao acessar **Configurações da minha conta -> Notificações de assinatura**. Esta configuração está a nível de site, de forma que deve ser configurada para site separadamente.

### Retomar assinaturas suspensas

Se uma assinatura falhar mais de cinco vezes, você receberá uma notificação por e-mail informando que a assinatura foi suspensa. Há algumas maneiras de retomar uma assinatura suspensa se você for o proprietário ou o administrador:

- Na área **Meu conteúdo** das páginas na Web do Tableau, aparece um ícone na coluna Última atualização para indicar que a assinatura está suspensa. **Selecione ... > Retomar assinatura** para retomar.
- Na guia **Assinaturas** da pasta de trabalho afetada, aparece um ícone na coluna de última atualização para indicar que a assinatura está suspensa. **Selecione ... > Retomar assinatura** para retomar.
- Na guia **Assinaturas**, em **Tarefas**, aparece um ícone na coluna de última atualização para indicar que a assinatura está suspensa. **Selecione ... > Retomar assinatura** para retomar (somente administradores de servidor).

Quando uma assinatura é retomada, a contagem de falha de alerta retorna a zero. A próxima avaliação da assinatura ocorrerá no próximo horário de avaliação agendado.

## Consulte também

[Assinar exibições](https://help.tableau.com/current/pro/desktop/pt-br/subscribe_user.htm) na Ajuda do Tableau Desktop e da Criação na Web.

[Administração no nível do projeto](https://help.tableau.com/current/server/pt-br/projects.htm#project-admin) para saber quais funções de site permitem recursos completos de líder de projeto.

<!-- document id=7484cbf2e8972334a77c7fa2ece284a63488f4032d304e6b04e07e8bba0c9c50 url=/tableau/current/pt-br/server/rmt-fips-compliance.md -->

[Pular para o conteúdo principal](#main-content)

# Conformidade com FIPS no Resource Monitoring Tool do Tableau

Este tópico apresenta a versão compatível com FIPS do Resource Monitoring Tool do Tableau (RMT). A conformidade com FIPS (Federal Information Processing Standard) foi adicionada ao RMT na versão 2025.3.

O FIPS 140-2 é um padrão de segurança de computador do governo dos EUA usado para aprovar módulos criptográficos. Essa conformidade garante que todas as operações criptográficas dentro do RMT atendam a rigorosos requisitos de segurança, fornecendo um ambiente mais seguro para seus dados.

## Sistemas operacionais compatíveis

O RMT é compatível com FIPS 140-2 nos seguintes sistemas operacionais:

- Linux: o RMT é compatível com FIPS nas distribuições RHEL 8. Se o seu sistema operacional RHEL 8 estiver com FIPS habilitado, instale o RMT com FIPS habilitado. Se o seu sistema operacional RHEL 8 não com FIPS habilitado, instale o RMT sem ativar o FIPS. Todas as outras distribuições suportadas devem estar em execução no modo não-FIPS para que o RMT seja instalado com êxito, o RMT deve ser instalado sem o FIPS habilitado.

## O que a conformidade com o FIPS significa para você

A funcionalidade do RMT é praticamente inalterada do ponto de vista do usuário. A conformidade com o FIPS é principalmente um aprimoramento que fortalece a postura de segurança do RMT.

- Segurança aprimorada: todos os dados em trânsito e em repouso, quando protegidos por módulos criptográficos, usarão algoritmos validados com o FIPS.
- Instalação: para novas instalações, o processo é o mesmo das versões anteriores. Saiba mais sobre como instalar o RMT no tópico [Instalar o Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-installation.htm).
- Atualizações:
    
    - Se você estiver instalando e não quiser executar o RMT no modo FIPS, o processo de atualização permanecerá o mesmo. Consulte [Atualização do Resource Monitoring Tool](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade.htm) para obter mais informações.
    - Se você deseja instalar o RMT no modo FIPS, você deve fazer uma nova instalação. Para obter detalhes, consulte [Atualização para uma versão do RMT compatível com FIPS](#Upgrading2FIPS) abaixo.

## Instalação e atualização do RMT 2025.3.0 ou posterior

O RMT compatível com FIPS (versão 2025.3.0 e posterior) usa um algoritmo diferente para arquivos de log do que as versões anteriores. Não é possível alternar os modos sem desinstalar completamente e reinstalar uma nova instância do RMT.

As etapas que você segue para instalar ou atualizar para RMT versão 2025.3.0 ou posterior dependem de vários fatores, incluindo:

- Qual sistema operacional você está usando
- Se esse sistema operacional está com FIPS habilitado
- Se você deseja executar o RMT no modo FIPS

### Instalação do RMT 2025.3.0 ou posterior

Instalar uma nova instância do RMT 2025.3+ não é diferente de instalar versões anteriores, exceto se você estiver instalando no RHEL 8. Se você estiver instalando o RMT no RHEL 8, precisará decidir se deseja instalar no modo FIPS.

**Nota:** todos os componentes do RMT (servidor e agentes) devem ser instalados com a mesma configuração de FIPS, com todos os FIPS habilitados ou nenhum FIPS habilitado. Não é possível misturar estados FIPS em componentes do RMT.

#### Instalação no Windows

Não há etapas especiais necessárias para instalar o RMT no Windows. O RMT será executado em um sistema Windows com FIPS habilitado sem erros, mas não é compatível com o FIPS. O RMT só é compatível com FIPS no RHEL 8.

#### Instalção no Linux

- Sistemas RHEL 8
    
    - Se o sistema operacional RHEL 8 estiver com FIPS habilitado, você deverá usar o alternador `--enable-fips` durante a instalação. A instalação falhará se você não usar o alternador.
    - Se o sistema operacional RHEL 8 não estiver com FIPS habilitado, você não poderá usar o alternador `--enable-fips`. A instalação falhará se você usar o alternador.
- todas as outras distribuições Linux
    
    - Você pode instalar o RMT desde que não esteja instalando no modo FIPS. Ocorrerá uma falha na instalação do RMT no modo FIPS.

### Atualização para uma versão do RMT compatível com FIPS

Ao atualizar de uma versão anterior a 2025.3.0 do RMT para a versão 2025.3.0 ou posterior, seu processo depende se você deseja ou não executar o RMT no modo FIPS.

- Sem FIPS: se você quiser atualizar para 2025.3.0 ou posterior, mas não precisar de FIPS, poderá seguir as etapas para uma atualização normal do RMT.
- Modo FIPS: se você quiser executar o RMT no modo FIPS no RHEL 8, você deve fazer uma desinstalação completa da versão existente e, em seguida, instalar a nova versão com o FIPS habilitado. Sua configuração e logs não são preservados.

Ao atualizar da versão 2025.3.x do RMT para qualquer versão posterior, seu processo depende se você deseja ou não alterar o status do FIPS.

- Sem FIPS: se você não precisar de FIPS e a versão da qual está atualizando não estiver com FIPS habilitado, você poderá seguir as etapas de uma atualização normal do RMT.
- Modo FIPS: se você quiser executar o RMT no modo FIPS no RHEL 8 e estiver atualizando uma instalação que já está em execução no modo FIPS, você poderá fazer uma atualização normal.
- Alterar o modo FIPS (passando de uma instalação com FIPS habilitado para uma instalação não FIPS, ou de uma instalação não FIPS para uma instalação com FIPS habilitado): você deve fazer uma desinstalação completa da versão existente e, em seguida, instalar a nova versão com FIPS habilitado. Sua configuração e logs não são preservados.

<!-- document id=748bcbedaa2dca9636923afbb1afd9d90bab20ebb45f31509efe9c6f9089647e url=/tableau/current/pt-br/server/license_product_keys.md -->

[Pular para o conteúdo principal](#main-content)

# Conhecer os modelos de licença e as chaves do produto

Este tópico descreve os diferentes modelos de licenciamento e as chaves do produto ou assinaturas que possam estar associadas a eles. Uma visão útil de como as chaves do produto são representadas no Tableau Server pode ser encontrada em [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList). O [Portal do cliente do Tableau](http://customer.tableausoftware.com/) também exibirá informações sobre a chave do produto, incluindo tipo e contagem de licenças.

Ao visualizar as chaves do produto usando [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList) (Tableau Server) ou no Portal do cliente do Tableau (Tableau Desktop e Tableau Prep Builder), observe os prefixos específicos do produto.

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td>Prefixo da chave do produto</td><td>Descrição</td></tr><tr><td>TC</td><td>A chave do produto Tableau Creator, pode ser usada para ativar ou desativar o <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> e o <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span>.</td></tr><tr><td>TD</td><td>A chave do produto <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>chave do produto, pode ser usada para ativar ou desativar o somente <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>. Essa é uma chave de produto herdada que não é mais vendida ou fornecida.</td></tr><tr><td>TS</td><td>A chave do produto <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> pode ser usada para ativar ou desativar o <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>. As chaves de produto do Tableau Server podem ser baseadas em função, núcleo ou recurso.</td></tr></tbody></table>

## Modelos de licenças com prazo

O modelo de licença com prazo do Tableau é definido pela métrica que permite o uso do Tableau Server. As licenças com prazo também são chamadas de licenças de assinatura. Atualmente, o Tableau vende acesso ao Tableau Server com licenças de assinatura. No modelo de licença por assinatura, os clientes pagam uma taxa de assinatura anual. Se a assinatura expirar, o software deixará de funcionar.

As licenças de assinatura do Tableau Server são assinaturas baseadas em função ou em núcleo. Uma única chave de licença pode ser adquirida com todas as funções e recursos e essa licença é chamada de Licença de Assinatura Atualizável (USL). Apenas uma chave precisa ser ativada no Tableau Server para representar toda a compra.

As licenças de assinatura anteriores (não USL) eram fornecidas com um tipo de função por chave e as licenças eram "empilhadas" e ativadas juntas para obter a configuração adquirida no Tableau Server.

- Uma _licença baseada em função_ permite implantar o Tableau Server em um único computador ou em vários computadores em um cluster. Cada usuário que acessa o Tableau Server deve estar licenciado e ter uma função. Os administradores podem adicionar usuários com base nas licenças disponíveis de cada tipo.
- Uma _licença baseada em núcleo_ não impõe restrições sobre o número de contas de usuário no Tableau Server. Em vez disso, a licença especifica o número máximo de núcleos do computador para que você possa executar o Tableau Server. Você pode instalar o Tableau Server em um único computador ou em vários computadores como um cluster de vários nós, desde que o número total de núcleos em todos os computadores não ultrapasse o total permitido pela licença.
    
    Nem todos os processos instalados com o Tableau Server afetam o cálculo do número total de núcleos usados. Um subconjunto de processos é considerado "processos licenciados". O licenciamento de núcleo é calculado somente em computadores que executam processos licenciados. Se um computador tem um ou mais processos licenciados instalados nele, os núcleos naquele computador representam o total de núcleos usados. Para obter mais informações sobre processos licenciados, consulte [Processos licenciados](https://help.tableau.com/current/server/pt-br/processes.htm#LicensedProcess).
- Uma _licença de assinatura atualizável_ permite consolidar licenças e atualizar seus Tableau Servers usando uma única chave do produto. Você pode adicionar novos recursos, ajustar a capacidade e aplicar renovações de licença a uma única licença existente do Tableau Server. Você não precisa mais adicionar novas licenças ou substituir as existentes. USL:
    
    - simplifica o gerenciamento de chaves reduzindo o número de chaves do produto que você deve gerenciar para facilitar a manutenção.
    - Minimiza as interrupções de serviço porque você não precisa reiniciar o Tableau Server após renovar uma licença, ajustar a capacidade ou adicionar novos recursos.

Para licenças de assinatura atualizáveis (USL), a chave do produto no portal do cliente do Tableau não muda mesmo quando atualizada com novos recursos ou alterações nas contagens de funções. Com o modelo de licença de assinatura não USL, você obtém uma nova chave no Portal do cliente após cada renovação de licença. Uma nova chave de produto aparecerá na interface de usuário da web do TSM depois que a chave de produto anterior expirar ao visualizar uma chave de produto de assinatura não USL. Para Licenças de Assinatura Atualizáveis (USL), sua chave do produto não muda na IU ou no Portal do cliente do Tableau. No Portal do cliente do Tableau, as licenças USL exibem uma caixa de seleção É chave USL selecionada na página Detalhes da licença ou **true** na coluna É chave USL na guia Licenças.

No resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList), o campo TYPE descreve a métrica de licença do usuário. Na interface de usuário da Web do Tableau Services Manager, passe o mouse sobre o campo Tipo (ou coluna) para verificar se a chave é uma chave do produto de Licença de assinatura atualizável (USL).

### Modelo de licença baseada em função

O Tableau oferece licenças com prazo baseadas em função que fornecem uma série recursos em faixas de preço variadas. Há quatro tipos de licenças com prazo baseadas em funções disponíveis: Display, Viewer, Explorer e Creator.

- _As licenças Display_ permitem que os usuários compartilhem e exibam o conteúdo do Tableau com um público interno amplo de usuários que consomem painéis por meio de exibições compartilhadas sem interação. Não há função de site separada para licenças de exibição; ao usar uma licença Display, os administradores criam uma conta de login dedicada para cada local Display licenciado, que não é o mesmo que a conta de login de um usuário individual, e atribuem a função de site máxima de Viewer.
- As _licenças Viewer_ permitem que os usuários visualizem e interajam com pastas de trabalho no Tableau Server. As licenças Viewer permitem que os usuários acessem o Tableau Mobile, adicionem comentários às pastas de trabalho, exportem visuais em diversos formatos, baixem dados de resumo da pasta de trabalho, criem assinaturas para si mesmo e recebam alertas orientados por dados.
- As _licenças Explorer_ são equivalentes às licenças baseadas em usuário disponíveis nas versões anteriores do Tableau Server, além de incluírem os recursos fornecidos nas licenças Viewer e funcionalidades adicionais. Uma licença Explorer permite acesso aos recursos de criação da pasta de trabalho usando um navegador da Web, além de um conjunto completo de recursos de colaboração.
- As _licenças Creator_ oferecem uma grande diversidade de recursos ao usar o Tableau Server, além de conceder uso do Tableau Desktop e do Tableau Prep Builder. Uma licença Creator permite todos os recursos disponíveis na licença Explorer, além dos seguintes recursos ao usar o Tableau Server:
    - Crie e publique novas pastas de trabalho a partir de uma nova fonte de dados.
    - Edite fontes de dados inseridas no painel Dados.
    - Crie e publique novas conexões de dados.
    - Use ativação do gerenciamento de licenças baseadas em logon no Tableau Desktop e Tableau Prep Builder.

**Observação**: os administradores do Tableau Server sempre terão a função mais alta disponível. Se você ativar uma chave de produto que contenha a função Creator, os administradores do Tableau Server assumirão essa função. Se a função mais alta disponível no Tableau Server for Explorer, o administrador do servidor assumirá essa função. Se uma função de Creator for adicionada a um servidor onde não há Creators atualmente ativados, quaisquer contas de Administrador de Servidor existentes usando licenças do Explorer serão convertidas automaticamente para usar licenças de Creator.  
  
As contas de administrador do TSM não exigem licenças.

Para licenças não USL, as chaves do produto são usadas para ativar e adicionar licenças ao Tableau Server. Quando uma atualização de capacidade ou funcionalidade é adquirida com uma chave de produto não USL, o Administrador do Tableau Server pode ativar essas chaves do produto adicionais. Para chaves do produto USL, uma chave do produto é ativada e contém todas as funções e recursos. Se uma licença USL foi atualizada para alterar funcionalidades, recursos ou contagens de funções, nenhuma chave do produto adicional será problemática ou precisará ser ativada.

Para chaves do produto de Licença de assinatura atualizável (USL), quando uma chave é atualizada com um novo termo de assinatura, recurso ou alteração de contagem de função, o serviço Server ATR obtém automaticamente essas atualizações e nenhuma chave adicional precisa ser ativada. As licenças USL e as ativações do Server ATR não exigem atualizações para obter essas alterações. Tudo será tratado pelo serviço Server ATR. Para uma chave do produto USL usando o método de ativação não Server ATR, as atualizações precisam ocorrer para obter a atualização para a chave de produto USL. Para chaves do produto não USL, quando uma atualização de capacidade ou funcionalidade é adquirida, são fornecidas chaves do produto adicionais no Portal do cliente do Tableau que você precisa ativar no Tableau Server.

Se você estiver usando chaves do produto não USL, selecione uma chave do produto do Tableau Server Creator no Portal do cliente do Tableau para garantir que você possa criar um Administrador do Tableau Server. As chaves do produto Explorer e Viewer podem ser ativadas para adicionar licenças adicionais. Uma vez que as chaves do produto forem ativadas, os administradores podem adicionar usuários e atribuir-lhes funções de site, que consomem automaticamente as licenças disponíveis.

No resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList), os campos CREATOR, EXPLORER, VIEWER exibem o número de licenças de cada tipo de licença de função. Para chaves do produto não USL, cada função é regida por sua própria chave de produto. Portanto, se sua empresa adquiriu licenças para as três funções, ative três chaves do produto. Para chave(s) de produto USL, uma chave tem todas as funções e recursos refletidos no TSM.

### Modelo de licença baseada em núcleo

Em um modelo de licenciamento de núcleo, a licença define o número de núcleos totais do computador em que o servidor pode ser executado, em vez de quantos usuários podem ser adicionados. Isso significa que o servidor pode aceitar usuários virtualmente ilimitados (como Explorers ou Viewers; o termo antigo para esses tipos de funções era "Interactors \[interagentes\]"). A licença baseada em núcleo também permite uma conta [Usuário Convidado](https://help.tableau.com/current/server/pt-br/users_guest.htm), o que não é possível com o licenciamento baseado em função.

No entanto, o licenciamento principal não inclui licenças Creator no servidor (essas funções de site estarão esmaecidas ao adicionar usuários).

Novas fontes de dados só podem ser adicionadas ao servidor se as publicações se originarem de Tableau Desktop ou por meio de um navegador por um usuário com função de site Creator no servidor. Portanto, deve haver (a) um usuário com função de site de Creator no servidor ou (b) um Tableau Desktop licenciado e um usuário com função de site de Explorer (pode publicar). Para a rota (b), existem duas maneiras de licenciar Tableau Desktop em uma organização de servidores baseada em núcleo:

- Pelo menos um de licença Creator baseada em função (que inclui o Tableau Desktop e o Tableau Prep Builder), ou
- Pelo menos um Tableau Desktop licenciado que usa uma chave do produto antiga do Tableau Desktop.

Observe que se uma licença Creator estiver empilhada em um servidor com licenciamento baseado em núcleo, essa licença Creator baseada em função será consumida por um administrador. A única maneira de atribuir uma função de site de Creator a um usuário não administrador é primeiro garantir que todos os administradores tenham licenças de Creator. Somente então licenças adicionais de Creator poderão ser usadas para atribuir uma função de site de Creator a usuários não administradores.

No resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList), o campo TYPE exibirá o número de núcleos licenciados. Além disso, o campo GUEST ACCESS exibirá `true`.

## Análise inserida modelo baseado em uso

A oferta de Análise inserida do Tableau é uma licença baseada em uso para Tableau Server disponibilizada para clientes que desejam inserir a funcionalidade do Tableau Server em uma solução externa para fornecer conteúdo e informações do Tableau aos clientes fora da empresa.

**Observação:** as licenças de Análise inserida não podem ser usadas no mesmo ambiente que as licenças de uso completo. Para mudar para uma licença de Análise inserida, primeiro desative suas licenças de uso total existentes e depois ative a licença de Análise inserida.

Por exemplo, considere uma empresa que executa um serviço onde analisa dados do consumidor e gera relatórios sobre padrões comportamentais em relação a diferentes demografias dos consumidores. Neste cenário, o Tableau Server atua no suporte a um aplicativo proprietário específico intitulado 'Analisador demográfico' e se conecta a arquivos TXT exportados e um banco de dados SQL. A empresa disponibiliza visualizações aos clientes em um portal seguro, onde eles fazem logon para gerenciar a conta e visualizar os resultados. Os usuários finais são identificados exclusivamente pela conta que usam para acessar o portal; isso determina o número de licenças do Server do Analytics inserido baseado em usuário.

A licença Análise inserida não é exibida no resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList). Para verificar a licença, entre em contato com o [Sucesso do cliente](https://www.tableau.com/pt-br/support/customer-success).

## Modelo de licença perpétua (antigo)

Antigamente, o Tableau vendia o acesso ao Tableau Server com licenças perpétuas. Embora essas licenças não estejam mais disponíveis, alguns clientes usam esse regime de licenciamento.

No modelo de licença perpétua, os clientes pagam uma assinatura de manutenção que é renovada anualmente. Se a manutenção expirar, o software continuará funcionando, mas o cliente perde o acesso ao suporte técnico e a atualizações de software. Não é mais possível adquirir manutenção anual para licenças perpétuas.

As licenças perpétuas foram vendidas para uma quantidade específica de usuários, chamados Interactors, ou para uma quantidade específica de núcleos:

- O licenciamento de Interactor é um modelo de usuário nomeado onde os clientes compraram licenças pelo assento, semelhante ao licenciamento atual baseado em função. No entanto, ao contrário do licenciamento baseado em função, em que diferentes funções de acesso são precificadas de acordo, no licenciamento de Interactor, as licenças foram desvinculadas por função. Os usuários licenciados podem ser Administradores do servidor, Administradores de site, Publishers, Interactors ou Viewers. As funções de usuário foram definidas pelo administrador apenas como um meio de gerenciar o acesso ao conteúdo e à configuração do servidor.
    
    Se você ativar uma chave válida do Server Interactor na versão 2020.4 ou posterior, a contagem do Interactor será mapeada para a função Explorer.
    
    As licenças principais perpétuas do Interactor não podem usar o gerenciamento de licenças baseado em login. Você deve adquirir uma licença de duração do Creator, também chamada de licença de assinatura do Creator, para usar gerenciamento de licenças baseadas em logon com Tableau Desktop ou Tableau Prep Builder.
- O licenciamento de núcleo perpétuo tem o mesmo modelo de licenciamento do núcleo de assinatura; ele especifica o número de núcleos de computador em que o software pode ser executado e é compatível com usuários ilimitados e uma conta de visitante.

No resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList), o TYPE arquivado exibe `Perpetual`. Observe também que a data MAINT EXP também é exibida.

## Edições de licença

As edições de licença incluem um conjunto de recursos e funcionalidades aos quais os usuários têm direito. As edições de licença não podem ser misturadas em uma implantação, o que significa que todos os usuários de uma implantação devem estar na mesma edição de licença. Considere as necessidades de toda a sua implantação ao selecionar a edição da licença.

### Edições de licença do Tableau Cloud

- #### Licença Tableau Standard Edition
    
    A edição Tableau Standard é a edição base do Tableau Cloud. Ela fornece acesso ao Tableau Cloud para cada usuário licenciado, governança, colaboração, preparação de dados e funcionalidade de análise visual.
- #### Licença Tableau Enterprise Edition
    
    A edição Enterprise foi projetada para ambientes de negócios sofisticados no Tableau Cloud. É ideal para organizações que exigem funcionalidades avançadas de administração, segurança e gerenciamento de dados para escalar para mais usuários em ambientes de dados mais complexos e atender aos padrões empresariais.
    
    Para obter mais informações e uma lista de recursos incluídos no Tableau Enterprise, consulte [Sobre o Tableau Enterprise](https://help.tableau.com/current/server/pt-br/to_tab_enterprise_features.htm).
- #### Licença Tableau Cloud+ Edition
    
    A edição Tableau Cloud+ está disponível exclusivamente para o Tableau Cloud. É feita sob medida para a adoção completa de análises de autoatendimento baseadas em IA. Abrange recursos premium adaptados para implantações maiores ou mais complexas, como funcionalidade premium de IA com o Tableau Agent, limite de 50 sites, Release Preview e Premier Success para Tableau Cloud.
    
    Para obter mais informações e uma lista de recursos incluídos na edição Tableau Cloud+, consulte [Sobre o Tableau Cloud+](https://help.tableau.com/current/online/pt-br/to_tab_plus_features.htm "Link para o tópico que abrange os recursos do Tableau+") na Ajuda do Tableau Cloud.
- #### Licença Tableau+ Bundle
    
    O Tableau+ Bundle está disponível para o Tableau Cloud. Inclui análise de agentes com Tableau Next e a licença da Tableau Cloud+ Edition.
    
    Para obter mais informações e uma lista de recursos incluídos no pacote Tableau+, consulte [Sobre o pacote Tableau+](https://help.tableau.com/current/online/pt-br/to_tab_plus_features.htm "Link para o tópico que abrange os recursos do Tableau+") na Ajuda do Tableau Cloud.

### Edições de licença do Tableau Server

- #### Licença Tableau Standard Edition
    
    A edição Tableau Standard é a edição base do Tableau Server. Ela fornece acesso ao Tableau Server para cada usuário licenciado, governança, colaboração, preparação de dados e funcionalidade de análise visual.
- #### Licença Tableau Enterprise Edition
    
    A edição Enterprise foi projetada para ambientes de negócios sofisticados no Tableau Server. É ideal para organizações que exigem funcionalidades avançadas de administração, segurança e gerenciamento de dados para escalar para mais usuários em ambientes de dados mais complexos e atender aos padrões empresariais.
    
    Para obter mais informações e uma lista de recursos incluídos no Tableau Enterprise, consulte [Sobre o Tableau Enterprise](https://help.tableau.com/current/server/pt-br/to_tab_enterprise_features.htm).
- #### Licença da edição Tableau Server+
    
    A edição Server+ foi projetada para organizações que desejam todo o potencial do Tableau Server com flexibilidade e inteligência para escalar ainda mais. É ideal para empresas que exigem ambientes de implantação expandidos (1 produção e até 6 ambientes adicionais de não produção para teste), configuração acelerada com contêineres pré-criados, e suporte premium de sucesso para impulsionar a adoção e maximizar o valor em toda a organização.
    
    Para obter mais informações e uma lista de recursos incluídos na edição Tableau Server+, consulte [Sobre o Tableau Server+](https://help.tableau.com/current/server/pt-br/tab_server_plus_features.htm).

## Licenciamento da conexão privada

Se você possui o Tableau Cloud com uma edição Tableau Enterprise ou Tableau Cloud+, ou o pacote Tableau+, o Private Connect está disponível para compra como uma licença adicional. Você precisa de uma licença complementar para cada Conexão privada.

Também precisa comprar blocos de uso de dados para enviar e receber dados pela Conexão privada. O uso de dados da conexão privada é cobrado por terabyte.

Os resumos mensais de uso são enviados conforme descrito em [Perguntas frequentes sobre o resumo mensal da conta](https://help.salesforce.com/s/articleView?id=000390885&type=1). Os administradores de nuvem que desejam estatísticas mais frequentes e granulares podem usar o [Registro de atividade](https://help.tableau.com/current/server/pt-br/activity_log_overview.htm) para obter o uso. A ID do endpoint da Conexão privada que aparece na lista de conexões privadas no Tableau Cloud Manager mapeia para `endpointID` em eventos do registro de atividades.

## Licenças de recursos

**Importante:** a partir de 16 de setembro de 2024, o Advanced Management e o Data Management não estarão mais disponíveis como opções complementares independentes. Os recursos do Advanced Management e do Data Management só estarão disponíveis se você os adquiriu anteriormente ou se você comprar determinadas edições de licença: Tableau Enterprise, Tableau Cloud+ ou Tableau+ Bundle (disponível para Tableau Cloud) ou Tableau Enterprise ou Tableau Server+ (disponível para Tableau Server).

As licenças de recursos são vendidas de forma diferente das outras licenças. Os recursos com licenças independentes devem ser licenciados para cada usuário (ou todos os núcleos) na implantação. Uma implantação inclui uma instalação de produção licenciada do Tableau Server e instalações licenciadas de não produção do Tableau Server, que oferecem suporte à instalação de produção.

Esses recursos são licenciados anualmente e no contexto do licenciamento, a disponibilidade desses recursos para a base de usuários é "tudo ou nada".

- Data Management
- Advanced Management
- Gerenciamento de licenças baseadas em logon

**Observação:** as licenças de assinatura atualizáveis incluem recursos e funções em uma licença. Você não precisa mais ativar várias licenças e chaves de produto para diferentes recursos e suas funções associadas.

### Data Management

A licença do Data Management inclui o Tableau Catalog e o Tableau Prep Conductor para uma única implantação do Tableau Server, que pode ser baseada em função ou núcleo. Para obter mais informações, consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm).

O Data Management pode exigir núcleos de recursos, que especificam o poder de computação usado para executar fluxos para o Prep Conductor. Os servidores com licenciamento baseado em núcleo devem comprar pelo menos quatro Núcleos de recursos (incluídos na edição Enterprise). Consulte [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).

No resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList), uma única chave do produto para o Data Management é indicada pelo campo DATA MANAGEMENT, que exibe `true` sob a licença apropriada.

### Advanced Management

Tableau Server Advanced Management é licenciado por implantação, que pode ser baseada na função ou no núcleo. Para obter mais informações sobre Advanced Management e os recursos incluídos, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

No resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList), uma única chave do produto para o Advanced Management é indicada pelo campo SERVER MANAGEMENT ADD-ON, que exibe `true` sob a licença apropriada.

### Gerenciamento de licenças baseadas em logon

O Gerenciamento de licenças baseadas em logon (LBLM) simplifica o licenciamento do Tableau Desktop e do Tableau Prep Builder. Em vez de usar chaves do produto, esses produtos são ativados quando um usuário com uma licença Creator autentica com o Tableau Server. Se um cliente estiver usando o Tableau Desktop ou o Tableau Prep Builder sem o Tableau Server, o LBLM não poderá ser usado.

**Observação**: a partir do Tableau Server versão 2023.1, o LBLM é compatível com implantações offline. Para implantar o Tableau Server com LBLM habilitado, você deve configurar o Tableau Server para usar o serviço Authorization-To-Run (ATR). Para obter mais informações, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

Para obter mais informações, consulte [Gerenciamento de licenças baseadas em logon](https://help.tableau.com/current/server/pt-br/license_lblm.htm).

No resultado retornado por [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList), uma única chave do produto para gerenciamento de licenças baseadas em logon é indicada pelo campo LBLM, que exibe `true` sob a licença apropriada.

<!-- document id=95554aadf18437a6421ab8e657f350451e2d5e22d0cf0fc595513c61ee44e66d url=/tableau/current/pt-br/server/server_external_filestore_performance.md -->

[Pular para o conteúdo principal](#main-content)

# Considerações de desempenho para armazenamento de arquivos externo

Este tópico lista os fatores que devem ser considerados quando você tem o Armazenamento de arquivos externo para garantir um ótimo desempenho.

Neste cenário em que o Armazenamento de arquivos está configurado fora do Tableau Server, você está armazenando as extrações em um compartilhamento de rede. Isso significa que o Tableau Server acessará esses dados em toda a rede. Para garantir um ótimo desempenho, recomendamos o seguinte:

- Use o sistema de armazenamento corporativo para garantir a confiabilidade e o alto desempenho de acesso aos dados.
- O sistema de armazenamento suporta bastante leitura IOPS:
    - Use unidades de estado sólido. Se o uso de discos giratórios for a única opção, use o mais rápido e o maior número possível.
- A infraestrutura de rede suporta o seguinte:
    
    - No mínimo, 10 GB Ethernet para suportar transferências de dados de alta velocidade entre o Tableau Server e o sistema de armazenamento.
    - No máximo, 10 milissegundos de latência de armazenamento entre o Tableau Server e o sistema de armazenamento.
    
    As recomendações acima são baseadas nos testes realizados pela equipe do Tableau. Os requisitos e o desempenho podem variar. Recomendamos que você crie seus próprios benchmarks para avaliar o desempenho e determinar os requisitos de recursos.
    
    Ao criar benchmarks, considere o desempenho geral do Tableau Server com os tempos de cargamento da pasta de trabalho como uma das principais métricas. Isso é especialmente relevante para essa configuração, já que o Armazenamento de arquivos externo afeta principalmente as pastas de trabalho baseadas em extração.
    
    Você pode usar [Tabjolt](https://github.com/tableau/tabjolt) para criar seus benchmarks.

## Quem pode fazer isso

Os administradores do Tableau Server monitoram o desempenho do Tableau Server. No entanto, existem considerações de rede, hardware e armazenamento que podem precisar de acesso para fazer alterações de configuração nesses recursos. Você também pode optar por trabalhar com o seu administrador de rede para fazer alterações, se não tiver acesso a esses recursos.

<!-- document id=e55f655fc6cb44264644d99c17d5c4c02546e3a484c9c4fdcb61f7671bc5601e url=/tableau/current/pt-br/server/migrate_server_to_cloud_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Considerações técnicas para migração do Tableau Server para o Tableau Cloud

Este tópico aborda a maioria das considerações técnicas que podem surgir em uma migração do Tableau Server para o Tableau Cloud. Ele foi escrito para administradores que gerenciam atualmente o Tableau Server e que estão considerando uma migração para o Tableau Cloud. Recomendamos que você revise este tópico como a etapa principal do seu plano de migração. Além disso, trabalhe com sua equipe de conta para entender se uma migração faz sentido para sua organização.

O tópico reflete os recursos do produto no Tableau Server 2023.3.

Para obter informações adicionais e para iniciar uma migração para o Tableau Cloud, visite o site [Migração para nuvem do Tableau](https://www.tableau.com/pt-br/solutions/tableau-migration) em Tableau.com.

## Esboço resumido

Este tópico está organizado em quatro áreas principais que são familiares aos administradores do Tableau. As tabelas a seguir mostram uma comparação resumida de recursos entre o Tableau Cloud e o Tableau Server em cada área principal. Para obter mais informações sobre um determinado recurso, consulte a seção correspondente posteriormente neste tópico.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col style="width: 33%;"></colgroup><tbody><tr><th colspan="3">Segurança, administração e governança</th></tr><tr><td>&nbsp;</td><th>Tableau Cloud</th><th>Tableau Server</th></tr><tr><td>Conformidade</td><td>Consulte o portal <a href="https://compliance.salesforce.com/en" target="_blank">Conformidade do Salesforce</a>. O acesso a este site pode exigir permissão do gerente da sua conta.</td><td>Gerenciado pelo cliente</td></tr><tr><td>Hospedagem e atualizações</td><td>Gerenciado pela Tableau</td><td>Gerenciado pelo cliente</td></tr><tr><td>Administração no nível Site</td><td>Padrão de site único</td><td>Gerenciado pelo cliente</td></tr><tr><td>Dados de telemetria</td><td>Limitados</td><td>Gerenciado pelo cliente</td></tr><tr><td>Dados de observabilidade</td><td><a href="https://help.tableau.com/current/online/pt-br/adminview_insights.htm" target="_blank">Informações administrativas</a> com <a href="https://help.tableau.com/current/online/pt-br/activity_log_overview.htm" target="_blank">Registro de atividade</a></td><td>Gerenciado pelo cliente com acesso ao repositório e <a href="https://help.tableau.com/current/server/pt-br/activity_log_overview.htm" target="_blank">Registro de atividade</a></td></tr></tbody></table>

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col style="width: 33%;"></colgroup><tbody><tr><th colspan="3">Conectividade dos dados</th></tr><tr><td>&nbsp;</td><th>Tableau Cloud</th><th>Tableau Server</th></tr><tr><td>Arquivos</td><td>Suportado</td><td>Suportado</td></tr><tr><td>Aplicativos e bancos de dados</td><td>Suportado, com limitações específicas do banco de dados</td><td>Suportado</td></tr><tr><td>Conectividade personalizada</td><td>Suporte limitado</td><td>Suportado</td></tr><tr><td>Fontes de dados de cubo</td><td>Não suportado</td><td>Suportado</td></tr></tbody></table>

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col style="width: 33%;"></colgroup><tbody><tr><th colspan="3">Gerenciamento e licenciamento de usuários</th></tr><tr><td>&nbsp;</td><th>Tableau Cloud</th><th>Tableau Server</th></tr><tr><td>Licenciamento</td><td><p>Interno: baseado em função</p><p>Externo: baseado em função e uso</p></td><td><p>Interno: baseado em função e núcleo</p><p>Externo: baseado em função e núcleo</p></td></tr><tr><td>SSO</td><td>Suportado</td><td>Suportado</td></tr><tr><td>Active Directory, Kerberos, LDAP directory</td><td>Não suportado</td><td>Suportado</td></tr><tr><td>Gerenciamento automatizado de usuários e grupos</td><td>Okta, OneLogin, Azure AD e <a href="https://github.com/tableau/TabProvision" target="_blank">ferramentas personalizadas</a></td><td>Active Directory, LDAP</td></tr></tbody></table>

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col style="width: 33%;"></colgroup><tbody><tr><th colspan="3">Extensibilidade e integrações externas</th></tr><tr><td>&nbsp;</td><th>Tableau Cloud</th><th>Tableau Server</th></tr><tr><td>Ferramentas automatizadas por meio de APIs</td><td>Suportado</td><td>Suportado</td></tr><tr><td>Integração R e Python</td><td>Suportado</td><td>Suportado</td></tr><tr><td>Incorporado</td><td>Suportado</td><td>Suportado</td></tr><tr><td>Personalização</td><td>Suporte limitado</td><td>Suportado</td></tr></tbody></table>

## Segurança, administração e governança

### Segurança e conformidade

Garanta que as certificações de segurança do Tableau Cloud atendam aos requisitos da sua organização. O Tableau Cloud está em conformidade com ISO 27001/27017/27018 e SOC 2/3 e atende aos requisitos de privacidade de dados, como os descritos no GDPR. Para ver uma lista completa e atualizada de certificações, acesse o portal [Conformidade do Salesforce](https://compliance.salesforce.com/en). O acesso a este site pode exigir permissão do gerente da sua conta.

Além disso, o Tableau Cloud e o Salesforce aderem aos mais rígidos padrões de segurança e privacidade de dados regionais. Os dados do cliente nunca saem da região em que estão hospedados. O Salesforce adota um modelo de responsabilidade compartilhada. Neste modelo, trabalhamos com você para garantir que todos os controles adequados de segurança e conformidade sejam habilitados pelo Salesforce e pela sua organização.

### Hospedagem e atualizações

O Tableau hospeda e gerencia o Tableau Cloud para clientes. O Tableau Cloud sempre executa a versão mais recente do Tableau. As principais atualizações são concluídas sem tempo de inatividade. a manutenção de rotina (atividades como atualizações, backups, ajuste de desempenho, etc.) é realizada para minimizar o desperdício. Caso seja necessário tempo de inatividade, a manutenção ocorre durante janelas pré-comunicadas. Para obter mais informações sobre o cronograma de manutenção do Tableau e como se inscrever para receber notificações de manutenção do Tableau Trust, consulte [Manutenção do sistema Tableau Cloud](https://help.tableau.com/current/online/pt-br/to_maintenance_schedule.htm).

O Tableau Cloud é executado na Amazon Web Services. Você pode optar por implantar seu site em qualquer uma das regiões da AWS listadas [aqui](https://help.tableau.com/current/pro/desktop/pt-br/publish_tableau_online_ip_authorization.htm).

O Tableau faz backups diários do ambiente para recuperação de desastres. No entanto, esses backups têm como objetivo restaurar o sistema como um todo. Os clientes são responsáveis por manter backups de todos os arquivos que desejam recuperar caso sejam removidos ou excluídos do Tableau Cloud.

### Administração no nível Site

Por padrão, as implantações do Tableau Cloud fornecem um único site para implantação do Tableau aos seus usuários. Um modelo de site único simplifica a administração do ambiente, ao mesmo tempo que permite cenários de governança abrangentes, conforme recomendado em [Projeto](https://help.tableau.com/current/blueprint/pt-br/bp_governance_in_tableau.htm#content-governance-in-tableau).

Para garantir um desempenho consistente em toda a plataforma, o Tableau Cloud restringe sites com limites de capacidade. Consulte [Capacidade do site do Tableau Cloud](https://help.tableau.com/current/online/pt-br/to_site_capacity.htm) para obter uma lista de tipos de capacidade e licenças associadas. As restrições de capacidade incluem limites para armazenamento geral e para tarefas que você pode realizar no site. Você pode avaliar se algum dos seus casos de uso seria afetado por esses limites conectando-se ao repositório do Tableau Server e comparando o uso com os limites de capacidade do site. Para obter mais informações sobre como se conectar ao repositório, consulte [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm)

### Dados de observabilidade

No Tableau Cloud, não é possível conectar-se diretamente ao banco de dados do repositório do Tableau Server. Em vez disso, os administradores do site têm acesso a um projeto chamado Informações administrativas que contém painéis de observabilidade e fontes de dados pré-construídos. [Consulte Usar as Informações administrativas para criar Exibições personalizadas](https://help.tableau.com/current/online/pt-br/adminview_insights.htm). Informações administrativas ajuda você a entender uso, desempenho, licenciamento, gerenciamento de usuários e muito mais. Você também pode usar as fontes de dados fornecidas para criar relatórios personalizados ou aproveitar as vantagens dos aceleradores criados com base nesses dados. Por exemplo, veja o [Acelerador de tempos de carregamento do painel](https://exchange.tableau.com/products/834). A retenção de dados padrão em Informações administrativas é de 90 dias. Com o Advanced Management você recebe um período de retenção estendido de 365 dias e tem acesso a [Registro de atividade](https://help.tableau.com/current/online/pt-br/activity_log_overview.htm) para dados de observabilidade mais detalhados.

### Exibir desempenho de carregamento

Exibir desempenho de carregamento pode variar entre o Tableau Cloud e o Tableau Server devido a diferenças nas configurações do ambiente do servidor e na disponibilidade de recursos. Esse desempenho é influenciado por uma série de fatores, incluindo:

- **Multilocação:** o Tableau Cloud é um ambiente multilocatário onde os recursos são compartilhados entre todos os sites do pod.
- **Configurações otimizadas do servidor:** a infraestrutura e as configurações do Tableau Server podem ser ajustadas para o desempenho do conteúdo, enquanto as configurações do Tableau Cloud são predefinidas.
- **Capacidade de recursos:** as velocidades de leitura/gravação de CPU, RAM e armazenamento disponíveis influenciam os tempos de análise, consulta e renderização.
- **Tráfego para exibições:** o volume de solicitações afeta diretamente a utilização de recursos e a carga nos processos envolvidos com os carregamentos de exibição.
- **Atividade de usuário mútua:** tarefas com uso intensivo de recursos executadas por outros usuários no mesmo pod podem afetar o desempenho.

## Conectividade dos dados

A localização dos seus dados determina qual das duas opções de conectividade você usa com o Tableau Cloud:

- O Tableau Cloud pode se conectar diretamente às fontes de dados em nuvem listadas abaixo. Para conexões diretas, alguns bancos de dados exigem autorização do Tableau Cloud para acessar essas fontes de dados antes da conexão. Consulte [Autorizar acesso a dados na nuvem publicados no Tableau Cloud](https://help.tableau.com/current/pro/desktop/pt-br/publish_tableau_online_ip_authorization.htm).
    
    Conectores compatíveis do Tableau Cloud
    
    <table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Alibaba AnalyticsDB para MySQL‡</p><p>Alibaba Data Lake Analytics‡</p><p>Amazon Athena‡</p><p>Amazon Aurora para MySQL‡</p><p>Amazon EMR&nbsp;Hadoop Hive‡</p><p>Amazon Redshift‡</p><p>Apache Drill‡</p><p>Azure Data Lake Storage Gen2‡</p><p>Azure Synapse Analytics&nbsp;(compatível com o SQL&nbsp;Server)</p><p>Box‡</p><p>Cloudera Hadoop‡</p><p>Databricks‡</p><p>Datorama by Salesforce‡</p><p>Denodo‡</p><p>Dremio by Dremio‡</p></td><td><p>Dropbox*‡</p><p>Esri Connector‡</p><p>Exasol‡</p><p>Google BigQuery*‡</p><p>Google Cloud SQL&nbsp;(compatível com MySQL)‡§</p><p>Google Drive‡</p><p>Hortonworks Hadoop Hive</p><p>Impala‡</p><p>Kyvos‡</p><p>MariaDB‡</p><p>Microsoft Azure SQL&nbsp;Database‡</p><p>Microsoft Azure Synapse Analytics‡</p><p>Microsoft SQL Server‡</p><p>MongoDB BI&nbsp;Connector‡</p><p>MySQL‡</p></td><td><p>OData‡</p><p>OneDrive*‡</p><p>Oracle‡</p><p>Pivotal Greenplum Database‡</p><p>PostgreSQL‡</p><p>Presto‡</p><p>Qubole Presto‡</p><p>Salesforce‡</p><p>SAP HANA (somente para conexões virtuais)‡</p><p>Listas do SharePoint‡</p><p>SingleStore (anteriormente MemSQL)‡</p><p>Snowflake‡</p><p>Spark SQL‡</p><p>Teradata**‡</p><p>Vertica‡</p></td></tr></tbody></table>
    
    \*Para obter mais informações sobre o uso do padrão OAuth 2.0 para conexões Google BigQuery, OneDrive e Dropbox no Tableau Cloud, consulte [Conexões OAuth](https://help.tableau.com/current/online/pt-br/protected_auth.htm).
    
    \*\*Atualmente, a criação na Web da Teradata não aceita a funcionalidade de banda de consulta. Consulte [Teradata](https://help.tableau.com/current/pro/desktop/pt-br/examples_teradata.htm) para obter mais detalhes.
    
    ‡Aceita conexões virtuais se você tiver o Data Management. Consulte [Sobre conexões virtuais e políticas de dados](https://help.tableau.com/current/online/pt-br/dm_vconn_overview.htm) na ajuda do Tableau Cloud para obter detalhes.
    
    §O Tableau Cloud não oferece suporte a SSL usando o Google Cloud SQL.
- Para dados armazenados localmente ou em uma rede de nuvem privada, você pode implantar o Tableau Bridge. Para obter uma lista de todos os conectores compatíveis ou não com o Tableau Bridge, consulte [Conectividade com Bridge](https://help.tableau.com/current/online/pt-br/to_sync_local_data.htm).

Se suas pastas de trabalho contiverem extrações de fontes de dados inseridas que levam mais de 10 minutos para serem atualizadas, recomendamos publicar cada fonte de dados separadamente da pasta de trabalho e depois atualizá-las individualmente. Essa abordagem evita tempos limite para consultas de longa duração. Para obter mais informações, consulte [Otimizar o desempenho de atualização do Bridge](https://help.tableau.com/current/online/pt-br/to_bridge_eds_performance.htm) e [Publicar uma fonte de dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_datasources.htm).

### Arquivos

O Tableau Cloud oferece suporte a vários tipos de arquivo. Arquivos hospedados em plataformas de nuvem como Google Drive, Dropbox, Box e S3 podem usar conectores diretos do Tableau Cloud para oferecer suporte a conexões em tempo real e de extração. O Tableau Bridge oferece suporte a conexões de dados baseadas em arquivo para extrações, mas não oferece suporte à conectividade em tempo real com dados baseados em arquivo.

### Aplicativos e bancos de dados

O Tableau Cloud oferece suporte à maioria dos mesmos conectores compatíveis com o Tableau Server, mas há algumas diferenças. Alguns bancos de dados exigem configuração específica para permitir a conectividade direta do Tableau Cloud. Consulte [Permitir conexões diretas com dados hospedados em uma plataforma de nuvem](https://help.tableau.com/current/online/pt-br/to_connect_live_sql.htm).

O Tableau Cloud e o Tableau Bridge não dão suporte à autenticação em um banco de dados usando Kerberos.

### Conectividade personalizada

O Tableau Cloud foi projetado para usar o mesmo conector de banco de dados para todos os clientes do Tableau Cloud e, portanto, não oferece suporte a soluções de conectividade específicas do cliente. As duas exceções notáveis são a Hyper API e o Tableau Bridge, que podem ser usados para estender ou personalizar sua conectividade. A Hyper API pode criar extrações que podem ser publicadas no Tableau Cloud. O Tableau Bridge pode ser usado para estender algumas opções de conectividade, por exemplo, ODBC, JDBC e conectores de dados da Web. Consulte [Conectividade com o Bridge](https://help.tableau.com/current/online/pt-br/to_sync_local_data.htm)

Não é possível personalizar a conectividade com o Conector SDK (.taco) no Tableau Cloud ou com o Tableau Bridge.

Se você estiver usando Conexões Virtuais como parte da oferta de Gerenciamento de Dados, poderá haver diferenças específicas para o conector desejado. Verifique se o Tableau Cloud ou o Tableau Bridge oferecem suporte ao seu cenário.

### Fontes de dados de cubo

O Tableau Cloud trabalho não oferece suporte às Fontes de dados Cube. Em vez disso, recomendamos que você se conecte diretamente ao banco de dados subjacente no qual o cubo foi criado para maior flexibilidade em sua análise.

### Preparação de dados

O Tableau Bridge trabalho não dá suporte à execução de fluxos do Tableau Prep com o Prep Conductor. Em vez disso, siga o processo no artigo da base de conhecimento, [Como executar fluxos do Tableau Prep Conductor com dados locais no Tableau Cloud](https://kb.tableau.com/articles/howto/how-to-run-tableau-prep-conductor-flows-with-on-premises-data-in-tableau-cloud?lang=pt-br), para automatizar a preparação de dados.

## Licenciamento e gerenciamento do usuário

### Licenciamento

O Tableau Cloud oferece suporte ao licenciamento com planos de assinatura baseados em funções. Saiba mais na página [Preços do Tableau](https://www.tableau.com/pt-br/pricing/teams-orgs). Para eliminar tarefas de gerenciamento de chaves, o Tableau Cloud usa como padrão licenciar usuários com gerenciamento de licenças baseado em login ([LBLM](https://help.tableau.com/current/online/pt-br/license_lblm.htm)). Licenças perpétuas herdadas e licenciamento baseado em núcleo de servidor não são aceitas.

O Tableau Cloud não oferece um usuário “convidado”. No entanto, os aplicativos conectados podem ser usados para fornecer conteúdo para uso mais amplo em sua organização. Consulte [Uso de aplicativos conectados do Tableau para integração de aplicativos](https://help.tableau.com/current/online/pt-br/connected_apps.htm).

Se você estiver licenciando o Tableau Cloud para usuários fora da sua organização, o licenciamento baseado em uso para esses casos de uso externos estará disponível. Consulte [Aumente a receita e reduza os custos com o licenciamento baseado no uso do Tableau Embedded Analytics](https://www.tableau.com/pt-br/blog/usage-based-licensing-scale-embedded-analytics-more-flexibility).

### Logon único

O Tableau Cloud oferece suporte ao logon único (SSO) por meio de SAML e OIDC. São aceitas integrações diretas com Okta, Azure AD, One Login, Salesforce, PingOne e muito mais.

Todos os usuários que acessam o Tableau Cloud devem utilizar a autenticação multifator (MFA) para autenticar no Tableau Cloud.

Se não estiver usando um provedor de SSO, você poderá usar o tipo de autenticação integrado do Tableau Cloud, TableauID com MFA. Você também pode criar soluções personalizadas com SAML ou usar [Aplicativos conectados](https://help.tableau.com/current/online/pt-br/connected_apps.htm) para soluções inseridas.

Para obter mais informações, consulte a seção [Autenticação](https://help.tableau.com/current/online/pt-br/security_auth.htm) na ajuda do Tableau Cloud.

### Active Directory, Kerberos e LDAP

O Tableau Cloud dados não oferece suporte à integração direta com o Active Directory. No entanto você pode [configurar SAML com Azure AD](https://help.tableau.com/current/online/pt-br/saml_config_azure_ad.htm) para integração com o Tableau Cloud.

Além disso, a maioria dos IdPs tem uma integração com o Active Directory que seria suficiente para autenticação com o Tableau Cloud. Por exemplo, veja [Integração com Active Directory (Okta)](https://help.okta.com/pt-br/Content/Topics/Directory/ad-agent-main.htm).

O Tableau Cloud dados não oferece suporte à autenticação Kerberos nem ao uso de LDAP como armazenamento de identidades.

### Gerenciamento automatizado de usuários e grupos

O Tableau Cloud usa o sistema para gerenciamento de identidade entre domínios (SCIM) para automatizar a troca de informações de identidade do usuário. Há diversas configurações específicas de IdP disponíveis no Tableau Cloud. Consulte [Automatizar o provisionamento de usuários e sincronização de grupos por meio de um provedor de identidade externo](https://help.tableau.com/current/online/pt-br/scim_config_online.htm).

A [API REST do Tableau](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm) e [tabcmd2.0](https://help.tableau.com/current/online/pt-br/tabcmd.htm) aceita muitas tarefas de automação de usuários e grupos.

O Tableau Cloud dados não oferece suporte à integração direta com o Active Directory para provisionamento de usuários ou grupos.

## Extensibilidade e integrações externas

### Ferramentas automatizadas

O Tableau Cloud oferece suporte a APIs REST, APIs Javascript, APIs de metadados, APIs de painel, Webhooks e incorporação em páginas HTML para usuários autenticados. Consulte [Ferramentas para desenvolvedores do Tableau](https://www.tableau.com/pt-br/developer/tools) Para maiores informações.

Recomendamos que você verifique seus casos de uso antes da migração.

Há algumas diferenças que você deve conhecer ao planejar sua estratégia de ferramentas automatizadas para o Tableau Cloud:

- O Tableau Server oferece suporte a APIs REST para administração em nível de servidor. O Tableau Cloud oferece suporte à administração em nível de site.
- O Tableau Server oferece suporte a uma lista global de conectores de dados da Web. O Tableau Cloud requer o uso do Bridge para executar atualizações de extração para conectores de dados da Web.
- Os conectores no Tableau Exchange são compatíveis apenas com o Tableau Server.

As APIs compatíveis com o Tableau Cloud são otimizadas para autenticação com tokens de acesso pessoal (PATs) do Tableau. Planeje refatorar suas ferramentas para usar a autenticação PAT como parte da migração para o Tableau Cloud. Consulte [Tokens de acesso pessoal](https://help.tableau.com/current/online/pt-br/security_personal_access_tokens.htm).

### Extensibilidade

O Tableau Cloud oferece suporte a extensões de análise com R e Python. Consulte [Configurar conexão com extensões do Analytics](https://help.tableau.com/current/online/pt-br/config_r_tabpy.htm). No entanto, o Tableau Bridge não oferece suporte a extensões analíticas, portanto, essas extensões só são compatíveis com fontes de dados que não exigem o Tableau Bridge.

O Tableau Cloud dados não oferece suporte a [Etapas de script R ou Python em um fluxo de preparação](https://help.tableau.com/current/prep/pt-br/prep_scripts.htm) criados ou publicados no Tableau Cloud.

### Incorporado

O Tableau Cloud oferece suporte à incorporação do Tableau em outros aplicativos. Ele oferece suporte à API de incorporação, a diversas opções de SSO e à API REST do Tableau para gerenciamento de usuários e conteúdo.

Há duas diferenças principais para incorporação com o Tableau Cloud e o Tableau Server:

- O Tableau Cloud oferece suporte a um modelo de licenciamento baseado em função de assinatura ou a um modelo de licenciamento baseado em uso para cenários de incorporação.
- O Tableau Cloud usa um modelo de locatário único. Para garantir a separação dos dados, você pode usar vários métodos diferentes. A estratégia de separação de dados que você usará será determinada pelas necessidades do seu negócio e pela solução de incorporação. Os seguintes tópicos de ajuda do Tableau Cloud fornecem mais informações:
    - [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/online/pt-br/projects.htm)
    - [Uso de aplicativos conectados do Tableau para integração de aplicativos](https://help.tableau.com/current/online/pt-br/connected_apps.htm)
    - [Gerenciar Visibilidade do usuário do site](https://help.tableau.com/current/online/pt-br/user_visibility.htm)
    - [Permissões](https://help.tableau.com/current/online/pt-br/permissions.htm)

### Personalizações

O Tableau Cloud permite personalizar alguns aspectos da experiência do usuário, como idioma, localidade, logotipos personalizados e imagens de projeto personalizadas. Consulte Personalizar configurações de site e conteúdo.

O Tableau Cloud não oferece suporte a URLs personalizadas, fontes personalizadas ou banners de boas-vindas personalizados.

<!-- document id=7dff08cceb43b0650d717ffa4967bf433d2492b48aa902b5382233d23daacb8d url=/tableau/current/pt-br/server/rmt-incidents-slow-query.md -->

[Pular para o conteúdo principal](#main-content)

# Incidentes de consulta lenta

Os incidentes de _Consulta lenta_ são acionados quando qualquer consulta de dados demora muito para ser concluída. Por padrão, um incidente de lentidão nas consultas acionará um aviso se alguma consulta de dados demorar pelo menos 30 segundos para ser executada.

Configure limites usando a interface na Web do Servidor RMT ou atualizando o arquivo de configuração `config.json`.

Para definir os limites para incidentes de consulta lenta, no menu **Administração,** selecione **Configuração** e vá acesse a guia **Incidentes**.

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Chave</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><b>Gravidade</b></td><td>Obrigatório</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>.</p></td></tr><tr><td><b>Duração</b></td><td>Obrigatório</td><td>A duração mínima para que uma consulta seja considerada lenta. Valores em segundos.</td></tr></tbody></table>

Um exemplo do trecho `config.json` definindo um incidente de Consulta lenta:

```
{  
 "monitoring":  {  
    "incidents":  {  
      "triggers":  [  
        {  
          "counter":  "DataQueryDuration",  
          "severity":  "critical",  
          "threshold":  45000  
        }  
      ]  
    }  
  }  
}
```

Este incidente de consulta lenta será acionado se uma consulta de dados tiver pelo menos 45 segundos para ser executada.

Os incidentes podem ser configurados por ambiente. Como exemplo, para um ambiente, cujo identificador era “staging-environment”, acionar um aviso quando a consulta de dados leva mais de 30 segundos para executar, a configuração teria a seguinte aparência:

```
{  
  "environments":  {  
    "staging-environment":  {  
     "monitoring":  {  
       "incidents":  {  
          "triggers":  [  
            {  
              "counter":  "DataQueryDuration",  
              "severity":  "warning",  
              "threshold":  30000  
            }  
          ]  
        }  
      }  
    }  
  }  
}
```

| Chave | Tipo de dados | Obrigatório? | Descrição |
| --- | --- | --- | --- |
| `counter` | Cadeia de caracteres | Obrigatório | Os incidentes de consulta lenta utilizam o identificador `DataQueryDuration`. |
| `severity` | Cadeia de caracteres | Opcional | Consulte [Nível de severidade do incidente](https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels). Valor padrão: `Warning` |
| `threshold` | Número | Obrigatório | A duração mínima para que uma consulta seja considerada lenta. Os valores estão em milissegundos. |

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=bab403a18791470d26b5411a31360429b2feda059ba45a83da90a23ae0f1490e url=/tableau/current/pt-br/server/runas.md -->

[Pular para o conteúdo principal](#main-content)

# Conta de serviço Run As

A conta de serviço _Run As_ é uma conta do Windows usada pelo Tableau Server ("runs as") quando ele acessa recursos. Por exemplo, o Tableau Server lê e grava arquivos no computador no qual está instalado. Pela perspectiva do Windows, o Tableau Server está fazendo isso como a conta de serviço Run As. Em alguns casos, o Tableau Server pode usar a conta do serviço Run As para acessar dados de fontes externas, como bancos de dados ou arquivos em um diretório de rede compartilhado.

Ao longo do planejamento da implantação do Tableau Server, é necessário determinar se a conta de serviço Run As padrão, configurado para ser executado no contexto da conta de Serviço de rede local (NT Authority\\Network Service), será suficiente para o que você precisa. Caso não seja, será necessário atualizar a conta de serviço Run As para ser executado em uma conta de domínio que tenha acesso aos recursos em seu(s) domínio(s) do Active Directory.

**Observação:** começando no Tableau Server versão 2023.3.x, se a conta de serviço Run As estiver configurada para usar uma conta de domínio, os administradores também deverão configurar uma lista de permissões de servidor para acesso a arquivos usando o comando `tsm configuration set`. A lista de permissões limita o acesso à fonte de dados baseada em arquivo a caminhos de diretório locais ou compartilhados especificados. Para obter mais informações e etapas para configurar uma lista de permissões de servidor, consulte [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm#11-configure-a-server-allowlist-for-filebased-data-sources).

Seja como for, é importante entender as implicações de segurança da conta que o Tableau Server usa para a conta de serviço Run As. Especificamente, se o Tableau Server precisar acessar outros servidores, compartilhamentos de arquivos ou bancos de dados que usam autenticação do Windows, a conta configurada para a conta de serviço Run As será usada para acessar esses recursos. A conta que é configurada para a conta de serviço Run As também deve ter permissões elevadas para o Tableau Server local. Uma prática recomendada de segurança geral é limitar o escopo de todas as contas de usuário às permissões mínimas necessárias. Fazemos a mesma recomendação conforme você planeja a conta de serviço Run As. Para obter mais informações, consulte [Acesso aos dados com a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_access.htm)

A conta que você usa para serviço Run As não deve ser membro da conta Administradores locais ou Administradores de domínio. Em vez disso, recomendamos o uso de uma conta de usuário de domínio que não seja um administrador da conta de serviço Run As. Usar uma conta de domínio que não seja membro desses grupos de administradores é uma boa prática de segurança e pode ajudar a evitar o acesso a certas fontes de dados e pastas. Para obter informações sobre as práticas recomendadas ao criar uma conta de serviço Run As, consulte [Criação da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm#best) .

É possível definir a conta de serviço Run As durante a instalação do Tableau Server ou atualizar a conta de serviço Run As usando a interface do usuário na Web do TSM. O Tableau Services Manager define as permissões da conta de serviço Run As, mas se você não tiver certeza de que a conta que deseja usar para ser o usuário Run As está de acordo com os requisitos, ou se tiver alterado a conta de serviço Run As e estiver recebendo erros de permissão, consulte [Configurações exigidas da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_confirm.htm).

![Janela de configuração Conta de serviço Run As do Tableau Server Manager com a Conta de usuário selecionada.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-runas.PNG)

## Conta padrão de serviço Run As: Serviço de rede

A conta de Serviço de rede é uma conta local predefinida com permissões limitadas que existem em todos os computadores Windows. Ainda que ela tenha acesso administrativo limitado ao computador local no qual ela é executada, ela tem mais acesso a recursos do que os membros do grupo de Usuários padrão do Active Directory. Por exemplo, o grupo de Serviço de rede pode gravar no Registro, no registro de eventos, e tem direitos especiais de conexão para serviços de aplicativos.

Por padrão, a conta de serviço Run As está definida como uma conta local chamada Serviço de rede. Use a conta de Serviço de rede padrão quando:

- estiver usando uma autenticação local do Tableau Server.
- todos os usuários em sua organização incluírem dados extraídos nas planilhas que estão carregando para o Tableau Server.
- estiver executando o Tableau Server em uma implantação de servidor único.
- fontes de dados externas que seus usuários acessam pelo Tableau Server não precisarem da segurança integrada do Windows NT ou Kerberos. Na maioria dos cenários de acesso a dados, bancos de dados Microsoft SQL Server, MSAS, Teradata e Oracle precisam de segurança integrada do Windows NT.

Ainda que a conta de Serviço de rede possa ser usada para acessar os recursos em computadores remotos no mesmo domínio do Active Directory, não recomendamos usar a conta padrão nesse tipo de cenário. Em vez disso, configure uma conta de domínio para a conta de serviço Run As caso o Tableau Server precise se conectar a fontes de dados em seu ambiente. Consulte [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm).

## Conta de serviço Run As: usuário de domínio

Em todos os cenários do Active Directory, recomendamos atualizar a conta de serviço Run As do Tableau Server com uma conta de usuário de domínio. Atualize a conta de serviço Run As para uma conta de usuário de domínio quando as fontes de dados acessadas pelo Tableau Server precisarem da segurança integrada Windows NT ou Kerberos.

Caso tenha feito uma implantação distribuída do Tableau Server, será possível atualizar a conta de serviço Run As com um usuário de domínio ou um grupo de trabalho do Windows. Em ambos os casos, use a mesma conta de usuário para todos os nós do servidor. Consulte [Requisitos distribuídos](https://help.tableau.com/current/server/pt-br/distrib_requ.htm) para obter mais informações.

Para configurar seu ambiente para usar uma conta de domínio, consulte [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm).

## Outros artigos nesta seção

<!-- document id=b7aca0d70beb9e688426f61958b074498a3c69c79c47a1eb89ea55b13f510997 url=/tableau/current/pt-br/server/security_windows_accounts_perms.md -->

[Pular para o conteúdo principal](#main-content)

# Contas e permissões do Windows

Este tópico descreve as contas usadas pelo Tableau Server e as permissões de pasta definidas pela instalação do Tableau Server.

## Contas

As seguintes contas são usadas pelo Tableau Server:

**Conta de administrador local**: a conta que você usa para instalar o Tableau Server deve ser membro do grupo de administradores locais. Para executar comandos do TSM ou acessar a UI da Web do TSM, a conta deve ser membro do grupo do administrador local. Consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).

**A conta de serviço Run As**: Muitos serviços são executados na conta que está configurada como conta de serviço Run As. Por padrão, a conta Serviço de rede é configurada como a conta de serviço Run As. No entanto, se o Tableau Server precisar acessar recursos no Active Directory, será necessário configurar a conta de serviço Run As para usar uma conta de usuário do Active Directory. Quando você especifica uma conta de usuário de domínio para a conta de serviço Run As, o Tableau Server definirá as permissões adequadas no computador local para a conta de usuário que você tiver especificado. A conta não deve ser membro do grupo de administradores locais. Para obter mais informações, consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm).

**Serviço de rede**: Os seguintes serviços são sempre executados como serviço de rede:

- Serviço de coordenação do Tableau Server
- Serviço de arquivo do cliente do Tableau Server
- Controlador de administração do Tableau Server

**Serviço local**: O serviço de licenciamento é executado na conta Serviço local.

**Sistema**: O serviço de agente de administração do Tableau Server é executado na conta Sistema. O serviço Agente de administração é responsável pela instalação, configuração e monitoramento de serviços.

## Permissões

O Windows atribui permissões padrão à raiz de cada disco rígido. Essas permissões são definidas para serem herdadas por subpastas e arquivos. A funcionalidade do Tableau Server depende desses modelos de permissão para instalações padrão:

- Grupo de administradores locais: esse grupo recebe permissão completa para todos os diretórios do computador. A conta System pertence implicitamente ao grupo de administradores locais. Como observado na seção anterior, a conta que você usa para instalar e executar o TSM deve ter acesso total ao computador, conforme concedido pela associação no grupo de Administradores locais. No entanto, depois de instalar o Tableau Server, você pode especificar um grupo Windows para administração do TSM. Consulte [Configurar um grupo de administração do TSM personalizado](https://help.tableau.com/current/server/pt-br/security_tsm_admin_group.htm).
- O grupo de usuários locais recebe permissões de leitura e execução. A conta especificada como a conta de serviço Run As deve ser membro do grupo de usuários locais. O Serviço de rede e o Serviço local pertencem implicitamente ao grupo de usuários locais.

Para obter mais informações sobre como a estrutura do diretório é implementada em uma instalação personalizada, consulte [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm#Non-defa).

<!-- document id=62c897d01b91f3fda3e2a654d4c77da59bb5ee2e9f81ac5eb8153137729be342 url=/tableau/current/pt-br/server/server_process_container.md -->

[Pular para o conteúdo principal](#main-content)

# Contêiners de microsserviço do Tableau Server

Por padrão, uma instância do Contêiner de microsserviço interativo é adicionada a cada nó que tem o Servidor de aplicativos (Vizportal) instalado e uma instância do Contêiner de microsserviço não interativo é adicionada a cada nó que tem o Processador em segundo plano instalado. Embora você não possa adicionar um Contêiner de microsserviço diretamente, é possível usar a CLI do TSM para alterar o número de instâncias para os dois Contêineres de microsserviço, quando necessário. Se todas as instâncias do Processador em segundo plano ou do Servidor de aplicativos forem removidas de um nó, o processo de contêiner também será removido.

Contêiner de microsserviço e os microsserviços:

- Contêiner de microserviço interativo:
    
    - Microsserviço MessageBus
    - Microsserviço de consulta de relação
    - Serviço de credenciais
    - Microsserviço de recomendações (adicionado na versão 2023.3.3)
- Contêiner de microserviço não interativo:
    
    - Microsserviço de ingestor de relação
    - Microsserviço de provedor de conteúdo externo
    - Microsserviço de provedor de fluxo
    - Microsserviço de provedor de conteúdo

## Visualização do status do Contêiner de microsserviço

Veja o status dos processos do Contêiner de microsserviço na página Status do TSM ou na linha de comando, usando o comando `tsm status -v`. Ao usar a página Status do TSM para [Exibir o status de processos do servidor](https://help.tableau.com/current/server/pt-br/service_viewstatus.htm), o status de cada processo de contêiner é apresentado, mas não é possível ver o status dos microsserviços no contêiner. Ao usar a linha de comando, mais detalhes são mostrados, incluindo o status de cada microsserviço individual.

### Status do Contêiner de microsserviço

O status de um processo de contêiner depende do status dos microsserviços dentro dele. Quando todos os microsserviços em um processo de contêiner estiverem em execução conforme o esperado, o status do contêiner é Ativo (na página Status do TSM) ou `running` (quando exibido a partir da linha de comando do TSM). Se todos os microsserviços em um processo de contêiner estiverem interrompidos, o status do contêiner é Erro (na página Status do TSM) ou `stopped` (a partir da linha de comando do TSM). Se um microsserviço for interrompido mas pelo menos um outro estiver em execução, o status do contêiner é Degradado (na página Status do TSM) ou `degraded` (a partir da linha de comando do TSM).

Quando todos os microsserviços em um processo de contêiner apresentarem o status em execução, o status será `Active`. Se algum microsserviço em um contêiner estiver em estado de erro (com status `stopped` ) o status do processo de contêiner será `degraded`. Se todos os microsserviços em um contêiner estiverem em estado de erro, o status será `error`.

Para exibir o status do Contêiner de microsserviço na página Status do TSM:

1. Abra o TSM em um navegador:
    
    http://<tsm-computer-name>:8850
2. Clique em **Status**:
    
    A página exibe o status dos processos do Contêiner de microsserviço interativo e do Contêiner de microsserviço não interativo, bem como o status de outros processos em execução como parte do TSM ou do Tableau Server.
    
    Não é possível ver o status de qualquer microsserviço individual dentro de um processo de contêiner, mas se o processo apresentar o status Ativo (marca verde), os microsserviços contidos nele estão em execução conforme o esperado. Para ver o status de microsserviços individuais, use a linha de comando do TSM.
    
    **Observação**: o status dos processos de contêiner não são exibidos na antiga página de status do Tableau Server. Para obter detalhes sobre as duas páginas de status e suas diferenças, consulte [Exibir o status de processos do servidor](https://help.tableau.com/current/server/pt-br/service_viewstatus.htm).

Para exibir o status do Contêiner de microsserviço na linhas de comando do TSM:

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute o seguinte comando:
    
    `tsm status -v`
    
    A saída do comando mostra o status dos serviços de contêiner e os microsserviços neles:
    
    node1: TABLEAUSVR01
    Status: RUNNING
    'Tableau Server Gateway 0' is running.
    'Tableau Server Application Server 0' is running.
    'Tableau Server Interactive Microservice Container 0' is running.
        'MessageBus Microservice 0' is running.
        'Relationship Query Microservice 0' is running.
    'Tableau Server VizQL Server 0' is running.
    'Tableau Server VizQL Server 1' is running.
    'Tableau Server VizQL Server 2' is running.
    'Tableau Server VizQL Server 3' is running.
    'Tableau Server Cache Server 0' is running.
    'Tableau Server Cache Server 1' is running.
    'Tableau Server Coordination Service 0' is running.
    'Tableau Server Cluster Controller 0' is running.
    'Tableau Server Search And Browse 0' is running.
    'Tableau Server Backgrounder 0' is running.
    'Tableau Server Backgrounder 1' is running.
    'Tableau Server Non-Interactive Microservice Container 0' is running.
         'Relationship Ingestor Microservice 0' is running.
         'External Content Provider Microservice 0' is running.
         'Flow Provider Microservice 0' is running.
         'Content Provider Microservice 0' is running.
    'Tableau Server Data Server 0' is running.
    'Tableau Server Data Server 1' is running.
    'Tableau Server Data Engine 0' is running.
    'Tableau Server File Store 0' is running.
    'Tableau Server Repository 0' is running (Active Repository).
    'Tableau Server Tableau Prep Conductor 0' is running.
    'Tableau Server Elastic Server 0' is running.
    'Tableau Server Ask Data 0' is running.
    'Tableau Server Administration Agent 0' is running.
    'Tableau Server Administration Controller 0' is running.
    'Tableau Server Service Manager 0' is running.
    'Tableau Server License Manager 0' is running.
    'Tableau Server Client File Service 0' is running.
    'Tableau Server Database Maintenance 0' is stopped.
    'Tableau Server Backup/Restore 0' is stopped.
    'Tableau Server Site Import/Export 0' is stopped.
    'Tableau Server SAML Service 0' is stopped.
    c:\\Program Files\\Tableau\\Tableau Server\\packages\\scripts.near.18.1216.1859>

<!-- document id=811768d0282cec26e90d349136f2f250baf5fbf183ad76a99ab3a0cf3abcc50f url=/tableau/current/pt-br/server/archive.md -->

[Pular para o conteúdo principal](#main-content)

# Conteúdo arquivado

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Outros artigos nesta seção

<!-- document id=2fbb279b473cbbd72dcc9e0ef09da13870c6c6f3aaeece4f89498c53a52204f7 url=/tableau/current/pt-br/server/adminview-stale-content.md -->

[Pular para o conteúdo principal](#main-content)

# Conteúdo obsoleto

A exibição Conteúdo obsoleto pode ser usada para identificar o conteúdo que não tenha sido usado ou acessado no período especificado (exibido como Limite de acesso obsoleto). Você pode definir esse período em dias. O valor mínimo para o período é 1 dia e o máximo é 120 dias.

Essa exibição também fornece as informações sobre o espaço em disco usado por conteúdo obsoleto e ativo.

> [!IMPORTANT]
> 
> Nas versões anteriores do Tableau Server, as exibições administrativas eram exibidas na mesma pasta de trabalho, em guias separadas. No entanto, as duas novas exibições administrativas são exibidas como pastas de trabalho separadas e não fazem parte da pasta de trabalho da exibição administrativa existente. Navegue até as novas exibições administrativas da página Servidor ou Status do site:  
> ![Página de status do site no Tableau Cloud com uma lista de opções de status do site, incluindo painel de informações básicas, estatísticas de conteúdo não utilizado e uso de licença baseado em login.](/tableau/current/pt-br/server/pt-br/Img/new-admin-views-nav.png)

## Resumo e filtros

![Um gráfico de barras revela que conteúdo obsoleto está ocupando 47% do espaço total do servidor.](/tableau/current/pt-br/server/pt-br/Img/admin-view-stale-content.png)

**A** - Na parte superior da exibição, você verá uma declaração que resume a quantidade de espaço usada pelo conteúdo obsoleto, em comparação ao espaço total utilizado. O espaço total utilizado é definido como a soma total do espaço em disco usado pelo conteúdo ativo e obsoleto.

**B** - Este resumo é seguido por um gráfico que fornece mais um detalhamento dos tipos de conteúdo obsoleto e o conteúdo considerado ativo - ou seja, o conteúdo que foi acessado no período abaixo do limite obsoleto. Você pode clicar no gráfico de barras e aplicá-lo para filtrar os dados mostrados na exibição.

**C** - Você pode ver e aplicar outras opções de filtro clicando no ícone de filtro. Este painel de filtro inclui:

• Limite obsoleto

• Site

• Projeto

• Proprietário do conteúdo

• Tamanho

• Tipo de conteúdo

![O painel Filtros permite que você classifique o conteúdo por critérios como limite de obsolescência, site, projeto, proprietário do conteúdo, tamanho e tipo de conteúdo.](/tableau/current/pt-br/server/pt-br/Img/admin-view-stale-content-filters.png)

Esses filtros são aplicados a toda a exibição.

## Detalhes

A exibição Conteúdo obsoleto tem três seções que fornecem detalhes, conforme descrito abaixo:

1. **A seção na parte superior esquerda** mostra o espaço total usado para o conteúdo selecionado. O eixo x mostra o número de dias que se passaram desde que o conteúdo foi aberto pela última vez. O eixo y mostra o tamanho. O gráfico também mostra o limite obsoleto.
    
    Defina o limite de desatualização desejado e use essa exibição para identificar o conteúdo mais desatualizado. Clique nas **Pastas de trabalho desatualizada** ou **Fontes de dados desatualizadas** na barra na parte superior para filtrar o conteúdo de interesse. Selecione as marcas à direita do Limite de acesso obsoleto para ver mais detalhes sobre o conteúdo. Os detalhes são exibidos na parte inferior esquerda.
    
    ![Um gráfico de linhas exibe o espaço cumulativo ocupado por todo o conteúdo desatualizado.](/tableau/current/pt-br/server/pt-br/Img/admin-view-stale-content-top-left-section.png)
2. **A seção na parte superior direita** mostra a quantidade de espaço usado por cada conteúdo selecionado. Por exemplo, se você selecionar pastas de trabalho Obsoletas, será exibido o espaço usado por cada pasta de trabalho obsoleta. Você pode usar essa seção para descobrir qual conteúdo é o mais obsoleto ou está ocupando mais espaço.
    
    Esta seção ajuda a identificar conteúdo que não é usado há muito tempo. Clique em **Pastas de trabalho desatualizadas** ou **Fontes de dados desatualizadas** na barra na parte superior. Selecione o conjunto mais antigo de conteúdo não utilizado (marcas na extrema direita) para ver mais detalhes. Os detalhes são exibidos na parte inferior esquerda. Esse pode ser o próximo conjunto de conteúdos a considerar para arquivamento ou exclusão, pois são conteúdos que ninguém tem usado, independente do tamanho.
    
    ![Um gráfico de dispersão representa visualmente a correlação entre os dias desde o último acesso e o espaço usado por cada objeto.](/tableau/current/pt-br/server/pt-br/Img/admin-view-stale-content-top-right-section.png)
3. **A seção na parte inferior** mostra informações detalhadas sobre o conteúdo selecionado, conforme mostrado abaixo:
    
    ![Uma tabela classificável com sete colunas: Tipo de conteúdo, Nome, Site, Projeto, Proprietário, Data de criação e Data do último uso.](/tableau/current/pt-br/server/pt-br/Img/admin-view-stale-content-bottom-section.png)

## Arquivar ou Excluir conteúdo obsoleto

A partir da versão 2020.3, a exibição administrativa Conteúdo obsoleto inclui um recurso que permite selecionar e marcar o conteúdo como obsoleto. Selecione o conteúdo na seção inferior ou na seção superior direita. Ao fazer uma seleção, verá o número de objetos e o tipo de conteúdo selecionados, como mostrado na captura de tela abaixo. Clique no botão Marcar objetos para marcar o conteúdo selecionado.

**Observação:** você pode marca até 1000 objetos por vez.

Na captura de tela mostrada abaixo, os conteúdos que não foram abertos nos últimos 160 dias ou mais estão selecionados para serem marcados como conteúdo obsoleto.

![Um painel destacando 179 pastas de trabalho e 29 fontes de dados que podem ser marcadas como Conteúdo Obsoleto.](/tableau/current/pt-br/server/pt-br/Img/admin-view-stale-content-select-content-to-tag.png)

Para encontrar todo o conteúdo marcado, na interface na Web do Tableau Server, navegue até Explorar. Selecione o filtro **Conteúdo obsoleto** para ver todo o conteúdo que tem a marca de conteúdo obsoleto. Agora é possível selecionar o conteúdo e movê-lo para um projeto que você usa para arquivar ou excluir o conteúdo.

![Contagem de pastas de trabalho marcadas como conteúdo obsoleto.](/tableau/current/pt-br/server/pt-br/Img/content-stale-content-tag.png)

Se você tiver o Advanced Management no Tableau Server, pode usar o Content Migration Tool do Tableau para gerenciar o arquivamento de conteúdo obsoleto em uma agenda regular. Por exemplo, construa um plano que seja executado em um cronograma regular que pode pegar automaticamente o conteúdo marcado como Conteúdo desatualizado e movê-lo para um Projeto de arquivamento. Depois de um certo período de tempo, as informações nesse projeto poderão ser eliminadas do sistema. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm).

<!-- document id=a05fb0ceec17e7ccdfcf75dc9d2d3b8613ed369307f8f28a2d41988857516d21 url=/tableau/current/pt-br/server/server_process_tsm-admin-controller.md -->

[Pular para o conteúdo principal](#main-content)

# Controlador de administração do Tableau Server

O processo do Controlador de administração hospeda a REST API do TSM para configurar e gerenciar a implantação do Tableau Server. Pode haver apenas uma única instância do Controlador de administração no cluster inteiro.

Esse processo será configurado automaticamente no nó inicial do cluster durante a instalação, não é necessária uma configuração.

O Controlador de administração também é chamado _Controlador TSM_  e _Controlador de Administração TSM_.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Administration Controller</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Administration Controller é visível na página Status, exibido como <span class="uicontrol">Controlador do TSM</span>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Administration Controller são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>tabadmincontroller</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## O que acontece quando o processo do Controlador de administração falha?

Se o Controlador de Administração falhar, o cluster do Tableau Server deverá continuar funcionando; no entanto, os comandos tsm e a interface do usuário da Web do TSM não estarão disponíveis. Você não poderá fazer alterações ou atualizações na configuração ou na topologia até que o Controlador de administração esteja funcionando e em execução. Como outros serviços do TSM, o Controlador de administração é reiniciado automaticamente se for interrompido ou ocorrer falhas.

Se o Controlador de administração não iniciar no nó, você poderá tentar iniciar o serviço manualmente executando o seguinte comando:

`sc start tabadmincontroller_0`

## Movimentação do Controlador de administração

Se o nó inicial falhar, você precisa mover o Controlador de administração e o Serviço de licenciamento para um nó diferente para que o Tableau Server possa continuar funcionando. Para obter detalhes sobre como fazer isso, consulte [Recuperação de falha no nó inicial](https://help.tableau.com/current/server/pt-br/distrib_ha_init_node_fail.htm).

## Reinicialização do Controlador de administração

Reinicie o Controlador de administração do TSM:

`net stop tabadmincontroller_0`

`net start tabadmincontroller_0`

**Observação:** você deve executar esses comandos como administrador em um prompt de comando. Dependendo da configuração do computador, talvez seja necessário executá-los na pasta `C:\Windows\System32`.

**Observação:** pode demorar alguns minutos para tabadmincontroller reiniciar. Se você tentar aplicar alterações pendentes na próxima etapa, antes que o controlador tenha reiniciado completamente, o TSM não conseguirá se conectar ao controlador. Use o comando `tsm status -v` para garantir que o controlador esteja funcionando. O Controlador de administração do Tableau Server deve ser listado como "em execução".

<!-- document id=1f45661af261fd29e2a26a9229782938f8e4a274c0056036612e72c9f504c631 url=/tableau/current/pt-br/server/explain_data_control_access.md -->

[Pular para o conteúdo principal](#main-content)

# Controle de acesso a Explique os dados

Seu acesso ao Explique os dados irá variar dependendo da função do seu site e das permissões de conteúdo. Explique os dados está sempre disponível para os autores no Tableau Desktop. Os autores com permissões de edição podem executar Explique os dados ao editar uma pasta de trabalho no Tableau Cloud ou Tableau Server.

Os autores também podem controlar se Explique os dados está disponível no modo de exibição em pastas de trabalho publicadas e quais tipos de explicação são exibidos.

Esteja ciente de que Explique os dados pode exibir valores de dimensões e medidas na fonte de dados que não estão representados na exibição. Como autor, você deve executar Explique os dados e testar as explicações resultantes, para garantir que dados confidenciais não sejam expostos em suas pastas de trabalho publicadas.

## Quem pode acessar Explique os dados

Explique os dados é habilitado por padrão no nível do site. Os administradores de servidor (Tableau Server) e os administradores de site (Tableau Cloud) podem controlar se Explique os dados está disponível para um site. Para obter mais informações, consulte [Desabilitar ou habilitar Explique os dados para um site](https://help.tableau.com/current/server/pt-br/explain_data_enable.htm).

<table class="table--plain"><colgroup><col style="width: 30%;"><col style="width: 70%;"></colgroup><thead><tr><th class="table--plain" style="text-align: left;">Modo</th><th class="table--plain" style="text-align: left;">Quem pode acessar</th></tr></thead><tbody><tr><td class="table--plain"><p><b>Modo de visualização</b></p></td><td class="table--plain"><p><b>Viewers</b>, <b>Explorers</b>, e <b>Creators</b> do Tableau, que têm o recurso de permissão de Executar Explique os dados, podem executar e explorar as explicações de Explique os dados no modo de exibição.</p></td></tr><tr><td class="table--plain"><p><b>Modo de edição</b></p><p style="font-weight: bold;">&nbsp;</p></td><td class="table--plain"><p>Os <b>Creators</b> do Tableau podem executar Explique os dados ao editar uma exibição no <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>, Tableau Cloud ou Tableau Server. Os <b>Explorers</b> com recursos de permissões de Executar Explique os dados e editar permissões podem executar Explique os dados ao editar uma pasta de trabalho no Tableau Cloud ou Tableau Server.</p><p>Creators e Explorers com permissão de edição podem abrir novas planilhas para análise posterior.</p><p>Eles também podem usar as configurações de Explique os dados para controlar quem pode usá-lo e o que eles podem ver.</p></td></tr></tbody></table>

## Controlar quem pode usar Explique os dados e o que eles podem ver

Uma combinação de configurações deve ser habilitada para disponibilizar o Explique os dados no modo de edição e no modo de exibição no Tableau Cloud e no Tableau Server.

### Modo de edição

Requisitos para que os autores executem Explique os dados ou editem as configurações de Explique os dados no modo de edição:

- Configuração do site: Disponibilidade de Explique os dados definida como Habilitar. Habilitado por padrão.
- Função de site: Creator ou Explorer (pode publicar) é necessária.
- Permissões: execute o recurso Explique os dados definido como Permitido. Não especificado por padrão. Se você abrir uma pasta de trabalho (Tableau versão 2022.1 ou anterior) que usou essa permissão no Tableau versão 2022.2 ou posterior, será necessário redefinir o recurso Executar dados explicativos para Permitido.

**Observação:** o recurso Baixar dados completos para um Creator ou Explorer (pode publicar) controla se eles veem a opção Exibir dados completos nas explicações de Valores extremos. Os Viewers sempre têm negado o recurso Baixar dados completos. No entanto, todos os usuários podem ver detalhes de nível de registro quando o tipo de explicação Valores extremos é habilitado nas configurações de Explique os dados.

Creators e Explorers com permissões de edição e o recurso de permissão Executar Explique os dados podem acessar as **Configurações de Explique os dados**, que fornecem opções para controlar:

- Os [tipos de explicação que são exibidos](#ControlExpTypes) no painel Guia de dados.
- Os [campos incluídos ou excluídos](#ControlFields) da análise estatística.

Essas opções são definidas para toda a pasta de trabalho e só podem ser definidas na caixa de diálogo Configurações de Explique os dados.

### Modo de visualização

Requisitos para que todos os usuários executem o Explique os dados no modo de visualização:

- Configuração do site: Disponibilidade de Explique os dados definida como Habilitar. Habilitado por padrão.
- Função de site: Creator, Explorer ou Viewer
- Permissões: execute o recurso Explique os dados definido como Permitido. Não especificado por padrão. Se você abrir uma pasta de trabalho (Tableau versão 2022.1 ou anterior) que usou essa permissão no Tableau versão 2022.2 ou posterior, será necessário redefinir o recurso Executar dados explicativos para Permitido.

**Observação**: para ver explicações sobre valores discrepantes detectados no Guia de dados, os usuários de uma visualização devem ter a permissão Explique os dados permitida para a pasta de trabalho ou exibição. O proprietário da pasta de trabalho precisará abrir as configurações de permissões para esta pasta de trabalho no Tableau Server ou Tableau Cloud e conceder a permissão Explique os dados para esse usuário.

### Abrir a caixa de diálogo Configurações de Explique os dados

1. No menu Análise, escolha Configurações de Explique os dados. Ou, no painel Guia de dados, clique no ícone de configurações (canto inferior direito).  
      
    ![Ícone de configurações do Explique os dados, representado por uma engrenagem.](/tableau/current/pt-br/server/pt-br/Img/explaindata_settingsbutton.png)

### Incluir ou excluir tipos de explicação exibidos por Explique os dados

Creatores e Exploreres com permissões de edição podem optar por excluir (ou incluir) tipos de explicação exibidos para todos os usuários da pasta de trabalho.

1. Na caixa de diálogo **[Configurações de Explique os dados](#OpenEXDsettings)**, clique na guia Tipos de explicação.  
      
    ![Uma lista de tipos de explicação do Explique os dados com caixas de seleção para marcar ou desmarcar cada tipo.](/tableau/current/pt-br/server/pt-br/Img/explaindata_explanationtypes.png)
2. Na lista de tipos de explicação, selecione ou desmarque um tipo de explicação.
3. Clique em OK.

Teste a configuração ao salvar e fechar a pasta de trabalho publicada e, em seguida, abrir uma exibição da pasta de trabalho no modo de visualização. Selecione uma marca que geralmente tem explicações de Valor extremo e, em seguida, execute Explique os dados para verificar os resultados da explicação.

### Incluir ou excluir campos usados para análise estatística

Creators ou Explorers com permissões de edição podem optar por excluir (ou incluir) campos que são elegíveis para análise.

1. No painel Explique os dados (canto inferior direito), clique no ícone de configurações. Ou escolha o botão Editar na [exibição Campos analisados](https://help.tableau.com/current/server/pt-br/explain_data_lm_status.htm#ViewAnalyzed).  
      
    ![Botão Editar no painel Campos analisados.](/tableau/current/pt-br/server/pt-br/Img/explaindata_editfields.png)
2. Na caixa de diálogo **[Configurações de Explique os dados](#OpenEXDsettings)**, clique na guia Campos.
3. Na lista de campos em Incluir, clique na seta suspensa e selecione Automático para incluir um campo elegível sempre que o Explique os dados for executado para essa pasta de trabalho.  
      
    Observe que os campos devem ter menos de 500 valores exclusivos para serem incluídos na análise.  
      
    ![Janela de configurações do Explique os dados com uma medida selecionada e o menu suspenso expandido para revelar opções de inclusão ou exclusão do campo.](/tableau/current/pt-br/server/pt-br/Img/explaindata_excludefield.png)  
      
    Selecione Nunca incluir para excluir explicitamente o campo.  
    Selecione Incluir Nenhum para executar uma análise estatística dos dados sem considerar os campos.  
    Selecione Redefinir para retornar às configurações padrão.
4. Clique em OK.

Teste a configuração salvando a pasta de trabalho publicada. Selecione uma marca, e, em seguida, execute Explique os dados para verificar resultados da explicação.

## Configure o Tableau para permitir que os usuários compartilhem explicações por e-mail e Slack

Os administradores do Tableau podem controlar se as explicações podem ser compartilhadas no modo de exibição por e-mail ou Slack para outros usuários do Tableau.

Siga estas etapas para permitir notificações e compartilhamento por e-mail e Slack no Tableau Cloud ou no Tableau Server:

1. Clique em Configurações.
2. Na guia Geral, role a página para baixo até Gerenciar notificações.
3. Para Colaboração, selecione Compartilhar no Tableau, E-mail e Slack .

Para compartilhar explicações pelo Slack, o aplicativo Tableau deve ser configurado para a área de trabalho Slack. Compartilhar explicações com o Slack está habilitado por padrão no Tableau Cloud.

No Tableau Server, um administrador precisará configurar o aplicativo Tableau para Slack. Para obter mais informações, consulte [Integrar o Tableau a uma área de trabalho do Slack](https://help.tableau.com/current/server/pt-br/slack_admin.htm).

<!-- document id=123bf19e77754226cf9eb7f25d23ce8db5756430c90e62f95eae445dd2345ff4 url=/tableau/current/pt-br/server/server_process_prep_flow_authoring.md -->

[Pular para o conteúdo principal](#main-content)

# Criação de fluxos do Tableau Prep

O processo de criação de fluxo do Tableau Prep fornece a experiência interativa de fluxo do Prep no navegador, que permite que os usuários criem e interajam com fluxos no Tableau Server para limpar e preparar dados. Para obter mais informações, consulte [Criar e interagir com fluxos na Web](https://help.tableau.com/current/server/pt-br/web_author_flows.htm). Adicionado na versão 2020.4.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Tableau Prep Flow Authoring </p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de Tableau Prep Flow Authoring é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do Tableau Prep Flow Authoring são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>floweditor</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

A criação do fluxo do Tableau Prep está ativada por padrão. Ela usa estes componentes:

- **Serviço de fluxo de preparação do Tableau**: usado pela Criação de fluxo do Tableau Prep para consulta de fontes de dados. Por padrão, ele é habilitado automaticamente em um nó que tenha a Criação de fluxo do Tableau Prep habilitada.
- **Processador de dados**: o processador de dados cria extrações de dados e consultas de processos. Por padrão, ele é habilitado automaticamente em um nó que tenha a Criação de fluxo do Tableau Prep habilitada.
- **Gateway**: o processo do Gateway controla todas as solicitações dos navegadores para o Tableau Server, o Tableau Desktop e outros clientes. Por padrão, ele é habilitado automaticamente em um nó que tenha a Criação de fluxo do Tableau Prep habilitada.

## Recomendações de desempenho e escala

A criação de fluxo do Tableau Prep pode exigir muita CPU e RAM. Recomenda-se monitorar o servidor e ajustar sua implantação conforme necessário, isolando a criação do fluxo em um nó separado ou adicionando recursos do servidor.

### Isolar a criação de fluxo autor em um nó separado

Executar a criação de fluxo do Tableau Prep em um nó separado isolará os fluxos de trabalho de outras cargas de trabalho do Tableau. Se você tem um servidor ocupado com muitas atualizações de extração, muita edição e exibição de visualizações e não quer causar interrupção nessa carga de trabalho, então é recomendável isolar a criação de fluxo do Prep em seu próprio nó de servidor. Isso significa que toda a edição de fluxo é direcionada para um nó dedicado. Para obter mais informações, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm).

**Observação:** a criação na Web do Prep usa serviços compartilhados como o Servidor de aplicativo (VizPortal), o repositório PostgreSQL, o Servidor de cache e o Hyper. Se esses serviços já estiverem no limite, eles também podem precisar de recursos adicionais devido à carga adicional da criação na Web do Prep. Para que a Criação na Web do Prep funcione, o servidor de cache deve estar em execução no nó de menor numeração onde está configurado. Por exemplo, se o servidor de cache estiver configurado nos nós 2, 3 e 4, mas estiver inativo no nó 2, a Criação na Web do Prep não funcionará. Para obter mais detalhes, consulte [O servidor de cache não está em execução no nó de menor numeração](https://help.salesforce.com/s/articleView?id=003962421&type=1) na base de dados de conhecimento.

Se você estiver executando o Tableau Server em um cluster de vários nós, poderá dedicar um ou mais nós para a execução do Processador em segundo plano. Usando o processo do Processador em segundo plano, você pode isolar cargas de trabalho em segundo plano, como Tableau Prep Conductor, de todas as suas cargas de trabalho interativas, como a Criação de fluxo do Prep e VizQL Server. Para obter mais informações, consulte [Processos do Processador em segundo plano do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_backgrounder.htm) e [Gerenciamento de carga de trabalho por meio das funções de nó](https://help.tableau.com/current/server/pt-br/server_node_roles.htm)

Para obter implantações de núcleo e baseadas no usuário, é altamente recomendável que pelo menos um nó seja dedicado aos fluxos para melhor desempenho. Embora você possa executar fluxos em qualquer núcleo de servidor licenciado, as compras de núcleos de recursos adicionais devem apenas executar o Tableau Prep Conductor, e não extrair atualizações ou processos VizQL.

### Adicionar recursos

À medida que você precisar de mais recursos, é possível adicionar mais nós ao ambiente de servidor. Ao planejar seus nós, vários fatores podem influenciar a decisão sobre quanto hardware adicional você precisa alocar.

 O principal a ser considerado ao planejar seus nós é o seguinte:

- O número de usuários simultâneos ou sessões simultâneas que você espera durante os horários de pico. O número de sessões simultâneas por usuário pode ser definido usando a opção TSM `maestro.sessionmanagement.maxConcurrentSessionPerUser`. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).
- O número de nós de entrada de dados que seus fluxos têm em média, bem como a quantidade de dados que eles têm. O limite máximo de amostragem de linha pode ser definido usando a opção TSM `maestro.app_settings.sampling_max_row_limit`. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).
- A complexidade dos fluxos que estão sendo criados e o número de nós. Em geral, tipos de nó como uniões de colunas e linhas, agregados e tabelas dinâmicas exigirão mais recursos.

### Licenciar ofertas adicionais

Licenças adicionais de Data Management e Advanced Management são necessárias para configurar nós.

<table style="width: 100%;"><colgroup><col style="width: 206px;"><col></colgroup><thead><tr><th>OFERTA</th><th>Permite que você:</th></tr></thead><tbody><tr><td><span class="mc-variable Variables.DM_sku variable">Data Management</span></td><td><p>Configure um nó para executar apenas fluxos ou configure um nó para executar todas as tarefas, exceto fluxos. O Tableau Prep Conductor deve estar em execução no nó.</p><p>A licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span> inclui Tableau Prep Conductor, que permite agendar e rastrear fluxos. Ela é para uma única implantação do Tableau Server, que pode ser baseada em funções ou em núcleo.</p><p>Como Creator, <span class="mc-variable Variables.DM_sku variable">Data Management</span> não é necessário para criar e editar fluxos diretamente em seu servidor.</p></td></tr><tr><td><span class="mc-variable Variables.ITM_name variable">Advanced Management</span></td><td>Configure onde os diferentes tipos de cargas de trabalho são processados por meio de regras de nó. Por exemplo, você pode executar fluxos em um nó e assinaturas e alertas em outro nó.</td></tr></tbody></table>

## Topologia e configuração

Para tornar a criação de fluxo do Tableau Prep altamente disponível, configure duas instâncias da criação de fluxo do Tableau Prep Flow em nós ao habilitá-lo.

Veja a seguir o exemplo de uma configuração em dois nós:

![Exemplo de uma configuração em dois nós](/tableau/current/pt-br/server/pt-br/Img/prep_flow_authoring_config2.png)

Veja a seguir o exemplo de uma página de status de configuração em dois nós:

![Exemplo de status de uma configuração em dois nós](/tableau/current/pt-br/server/pt-br/Img/prep_flow_authoring_status2.png)

Veja a seguir o exemplo de uma configuração em quatro nós:

![Exemplo de uma configuração em dois nós](/tableau/current/pt-br/server/pt-br/Img/prep_flow_authoring_config4.png)

Veja a seguir o exemplo de uma página de status de configuração em quatro nós:

![Exemplo de status de uma configuração em dois nós](/tableau/current/pt-br/server/pt-br/Img/prep_flow_authoring_status4.png)

<!-- document id=446964edebb792dbbae6b86fc92ce444455a5f2a1188f654a1c436028f7f2ef3 url=/tableau/current/pt-br/server/creator_connect.md -->

[Pular para o conteúdo principal](#main-content)

# Criadores: conectar a dados na Web

Antes de criar uma pasta de trabalho e uma exibição na Web, para analisar seus dados na Web, é necessário conectar-se aos seus dados. O Tableau suporta a conexão a fontes de dados da Web publicadas pelo Tableau Desktop ou, diretamente, a dados por meio do Tableau Cloud, Tableau Server ou Tableau Public.

A partir de 2019.3, o Tableau Catalog está disponível como parte da oferta do Data Management para Tableau Server e Tableau Cloud. Quando o Tableau Catalog estiver habilitado no ambiente, além de navegar e conectar-se a dados do Explorer, você também pode fazer isso em mais tipos de dados, como bancos de dados e tabelas, do Tableau Catalog. Para obter mais informações sobre o Tableau Catalog, consulte "Sobre Tableau Catalog" na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm). A partir de 2021.4, o Data Management inclui conexões virtuais, um ponto de acesso central aos dados. Para obter mais informações sobre as “Conexões virtuais e as políticas de dados”, consulte a ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_vconn_overview.htm) ou [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_vconn_overview.htm).

## Abrir a página Conectar-se a dados

Na Web, você usa a página Conectar-se a dados para acessar os dados. Depois de fazer logon no Tableau Cloud ou Tableau Server, você pode abrir esta página de duas maneiras:

- Página inicial \> Nova > Pasta de trabalho
- Explorer > Nova \> Pasta de trabalho

Se você estiver no Tableau Public, poderá abrir esta página no seu perfil de autor:

- Meu perfil \> Criar uma visualização

A caixa de diálogo Conectar-se a dados exibe uma lista rolável de conteúdo misto popular. Se você tem uma licença do Data Management, pode se conectar aos dados com uma conexão virtual e, se tem Data Management com o Tableau Catalog ativado, também pode se conectar a ativos externos, como bancos de dados, arquivos e tabelas.

O campo de pesquisa responsivo mostra uma lista de sugestões que é atualizada conforme você insere o texto. Filtre os resultados da pesquisa por tipo de dados, status de certificação ou outros filtros que dependem do tipo de dados selecionado. Por exemplo, alguns tipos de dados podem permitir que você filtre com base em marcas, tipo de conexão, avisos de qualidade de dados ou outros critérios. A aparência e o funcionamento das versões mais antigas da caixa de diálogo são um pouco diferentes, mas a função geral é semelhante.

![Conecte-se aos dados no Tableau Cloud com opções para se conectar a fontes de dados, conexões virtuais, bancos de dados e arquivos ou tabelas.](/tableau/current/pt-br/server/pt-br/Img/connect_to_data.png)

Na página Conectar-se a dados, as guias que você vê dependem do produto que você tem.

No Tableau Server, selecione uma das guias a seguir para conectar-se aos dados: Neste site, Arquivos e Conectores.

### Conectar-se a dados neste site

1. Selecione Neste site para navegar ou pesquisar as fontes de dados publicadas.
2. Selecione a fonte de dados em Nome e clique no botão Conectar.

**Observação:** além de conectar-se a fontes de dados, quando você tem o Data Management, é possível usar Neste site para se conectar a dados usando uma conexão virtual. Quando o Tableau Catalog está habilitado, também é possível se conectar a bancos de dados, arquivos e tabelas.

### Conectar-se a arquivos

O Tableau é compatível com carregamento de Excel, fontes de dados baseadas em texto (.xlsx, .csv, .tsv) e formatos de arquivo espaciais que exigem somente um arquivo (.kml, .geojson, .topojson, .json, arquivos no formato da Esri e os arquivos Geodatabases da Esri compactados em um \*.zip) diretamente no navegador. Na guia Arquivos do painel Conectar-se a dados, conecte-se a um arquivo o arrastando-o e soltando-o no campo ou clicando em Fazer upload por meio do computador. O tamanho máximo do arquivo que você pode carregar é 1 GB.

### Uso de conectores

Na guia Conectores, é possível conectar-se a dados armazenados em um banco de dados na nuvem ou em um servidor na sua empresa. É necessário fornecer informações de conexão para cada conexão de dados realizada. Por exemplo, para a maioria das conexões de dados, será necessário fornecer um nome de servidor e suas informações de logon.

Os [Conectores compatíveis](https://help.tableau.com/current/pro/desktop/pt-br/exampleconnections_overview.htm) contêm informações sobre como conectar o Tableau a cada um desses tipos de conectores, a fim de configurar a sua fonte de dados. Se o conector que você precisa não for exibido na guia Conectores, será possível se conectar aos dados por meio do Tableau Desktop e publicar sua fonte de dados no Tableau Cloud ou no Tableau Server para a criação na Web. Saiba mais sobre como [Publicar uma fonte de dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_datasources.htm) no Tableau Desktop.

Quando o Tableau se conecta com sucesso aos dados, a página Fonte de dados é aberta para que você possa preparar os dados para análise e começar a criar a exibição. Para saber mais, consulte [Criadores: preparar dados na Web](https://help.tableau.com/current/pro/desktop/pt-br/creator_data_prep.htm).

#### Conectores do Tableau Server

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Actian Matrix*</p><p>Alibaba AnalyticDB para MySQL‡</p><p>Alibaba Data Lake Analytics‡</p><p>Alibaba MaxCompute‡</p><p>Amazon Athena‡</p><p>Amazon Aurora para MySQL‡</p><p>Amazon EMR&nbsp;Hadoop Hive‡</p><p>Amazon Redshift‡</p><p>Apache Drill‡</p><p>Aster Database*</p><p>Azure Data Lake Storage Gen2‡</p><p>Box‡</p><p>Cloudera Hadoop‡</p><p>Databricks‡</p><p>Datorama by Salesforce‡</p><p>Denodo‡</p><p>Dremio by Dremio‡</p><p>Dropbox‡</p><p>Esri Connector‡</p><p>Exasol‡</p></td><td><p>Google BigQuery**‡</p><p>Google BigQuery JDBC**‡</p><p>Google Cloud SQL</p><p>Google Drive‡</p><p>Impala‡</p><p>Kognito*</p><p>Kyvos‡</p><p>Hortonworks Hadoop Hive</p><p>IBM BigInsights</p><p>IBM DB2‡</p><p>IBM PDA (Netezza)*</p><p>Kyvos‡</p><p>MariaDB‡</p><p>MarkLogic*</p><p>Microsoft Azure SQL Database‡</p><p>Microsoft Azure Synapse Analytics‡</p><p>Microsoft SQL Server‡</p><p>MonetDB*</p><p>MongoDB&nbsp;BI&nbsp;Connector‡</p><p>MySQL‡</p></td><td><p>OData‡</p><p>OneDrive‡</p><p>Oracle‡</p><p>Pivotal Greenplum Database‡</p><p>PostgreSQL‡</p><p>Progress OpenEdge*</p><p>Presto‡</p><p>Qubole Presto‡</p><p>SAP HANA (somente para conexões virtuais)‡</p><p>SAP Sybase ASE*</p><p>SAP Sybase IQ*</p><p>Salesforce‡</p><p>Listas do SharePoint‡</p><p>SingleStore (anteriormente MemSQL)‡</p><p>Snowflake‡</p><p>Spark&nbsp;SQL‡</p><p>Teradata***‡</p><p>Vertica‡</p></td></tr></tbody></table>

\*Não disponível em servidores Linux.

\*\*O Google BigQuery precisa de OAuth ao criar fontes de dados da Web. Saiba mais sobre como os administradores do servidor podem [Configurar OAuth para Google.](https://help.tableau.com/current/server/pt-br/config_oauth_google.htm)

\*\*\*Atualmente, a criação na Web da Teradata não aceita a funcionalidade de banda de consulta. Consulte [Teradata](https://help.tableau.com/current/pro/desktop/pt-br/examples_teradata.htm) para obter mais detalhes.

‡Aceita conexões virtuais se você tiver o Data Management. Consulte [Sobre conexões virtuais e políticas de dados](https://help.tableau.com/current/server/pt-br/dm_vconn_overview.htm) na ajuda do Tableau Server para obter detalhes.

#### Tableau Catalog Conectores compatíveis

O Tableau Catalog oferece suporte à conexão com um subconjunto dos conectores de dados com o qual o Tableau Server é compatível. Se uma fonte de dados, um banco de dados, um arquivo ou uma tabela estiver esmaecido, você não poderá se conectar usando o Tableau Server. No entanto, é possível se conectar no painel Conectar do Tableau Desktop, se você tem as permissões corretas.

No Tableau Cloud, selecione uma das guias a seguir para conectar-se a dados: Neste site, Arquivos, Conectores e Modelos de painel.

### Conectar-se a dados neste site

1. Selecione Neste site para navegar ou pesquisar as fontes de dados publicadas.
2. Selecione a fonte de dados em Nome e clique no botão Conectar

**Observação:** além de conectar-se a fontes de dados, quando você tem o Data Management, é possível usar Neste site para se conectar a dados usando uma conexão virtual. Quando o Tableau Catalog está habilitado, também é possível se conectar a bancos de dados, arquivos e tabelas.

### Conectar-se a arquivos

O Tableau suporta o upload de fontes de dados do Excel ou de texto (.xlsx, .csv, .tsv) diretamente no navegador. Na guia Arquivos do painel Conectar-se a dados, conecte-se a um arquivo do Excel ou de texto arrastando e soltando-o no campo ou clicando em Fazer upload por meio do computador. O tamanho máximo do arquivo que você pode carregar é 1 GB.

### Uso de conectores

Na guia Conectores, é possível conectar-se a dados armazenados em um banco de dados na nuvem ou em um servidor na sua empresa. É necessário fornecer informações de conexão para cada conexão de dados realizada. Por exemplo, para a maioria das conexões de dados, será necessário fornecer um nome de servidor e suas informações de logon.

[Conectores compatíveis](https://help.tableau.com/current/pro/desktop/pt-br/exampleconnections_overview.htm) têm informações sobre como conectar o Tableau aos dados usando conectores. Se o conector que você precisa não for exibido na guia Conectores, será possível se conectar aos dados por meio do Tableau Desktop e publicar sua fonte de dados no Tableau Cloud ou no Tableau Server para a criação na Web. Saiba mais sobre como [Publicar uma fonte de dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_datasources.htm) no Tableau Desktop.

**Observação**: se você não conseguir se conectar aos seus dados do Tableau Cloud, verifique se o banco de dados está acessível publicamente. O Tableau Cloud pode se conectar somente a dados que são acessíveis na Internet pública. Se os dados estiverem protegidos por uma rede privada, você poderá se conectar usando o Tableau Bridge. Para saber mais, consulte [Publicadores: usar o Tableau Bridge para manter os dados atualizados do Tableau Cloud](https://help.tableau.com/current/online/pt-br/qs_refresh_local_data.htm).

#### Conectores do Tableau Cloud

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Alibaba AnalyticsDB para MySQL‡</p><p>Alibaba Data Lake Analytics‡</p><p>Amazon Athena‡</p><p>Amazon Aurora para MySQL‡</p><p>Amazon EMR&nbsp;Hadoop Hive‡</p><p>Amazon Redshift‡</p><p>Apache Drill‡</p><p>Azure Data Lake Storage Gen2‡</p><p>Azure Synapse Analytics&nbsp;(compatível com o SQL&nbsp;Server)</p><p>Box‡</p><p>Cloudera Hadoop‡</p><p>Databricks‡</p><p>Datorama by Salesforce‡</p><p>Denodo‡</p><p>Dremio by Dremio‡</p></td><td><p>Dropbox*‡</p><p>Esri Connector‡</p><p>Exasol‡</p><p>Google BigQuery*‡</p><p>Google Cloud SQL&nbsp;(compatível com MySQL)‡§</p><p>Google Drive‡</p><p>Hortonworks Hadoop Hive</p><p>Impala‡</p><p>Kyvos‡</p><p>MariaDB‡</p><p>Microsoft Azure SQL&nbsp;Database‡</p><p>Microsoft Azure Synapse Analytics‡</p><p>Microsoft SQL Server‡</p><p>MongoDB BI&nbsp;Connector‡</p><p>MySQL‡</p></td><td><p>OData‡</p><p>OneDrive*‡</p><p>Oracle‡</p><p>Pivotal Greenplum Database‡</p><p>PostgreSQL‡</p><p>Presto‡</p><p>Qubole Presto‡</p><p>Salesforce‡</p><p>SAP HANA (somente para conexões virtuais)‡</p><p>Listas do SharePoint‡</p><p>SingleStore (anteriormente MemSQL)‡</p><p>Snowflake‡</p><p>Spark SQL‡</p><p>Teradata**‡</p><p>Vertica‡</p></td></tr></tbody></table>

\*Para obter mais informações sobre o uso do padrão OAuth 2.0 para conexões Google BigQuery, OneDrive e Dropbox no Tableau Cloud, consulte [Conexões OAuth](https://help.tableau.com/current/online/pt-br/protected_auth.htm).

\*\*Atualmente, a criação na Web da Teradata não aceita a funcionalidade de banda de consulta. Consulte [Teradata](https://help.tableau.com/current/pro/desktop/pt-br/examples_teradata.htm) para obter mais detalhes.

‡Aceita conexões virtuais se você tiver o Data Management. Consulte [Sobre conexões virtuais e políticas de dados](https://help.tableau.com/current/online/pt-br/dm_vconn_overview.htm) na ajuda do Tableau Cloud para obter detalhes.

§O Tableau Cloud não oferece suporte a SSL usando o Google Cloud SQL.

#### Tableau Catalog Conectores compatíveis

O Tableau Catalog oferece suporte à conexão com um subconjunto dos conectores de dados com o qual o Tableau Cloud é compatível. Se uma fonte de dados, um banco de dados, um arquivo ou uma tabela estiver esmaecido, você não poderá se conectar usando o Tableau Cloud. No entanto, é possível se conectar no painel Conectar do Tableau Desktop, se você tem as permissões corretas.

### Usar Dashboard Starters

No Tableau Cloud, é possível criar e analisar dados do Navegador de vendas do LinkedIn, Oracle Eloqua, Salesforce, ServiceNow ITSM e QuickBooks Online usando Dashboard Starters. Na guia Modelo de painel, na lista de designs predefinidos, selecione uma opção e clique em Usar painel. Consulte [Modelos básicos de painel para fontes de dados baseadas em nuvem](https://help.tableau.com/current/pro/desktop/pt-br/starters.htm) para obter detalhes.

### Criação na Web com o Tableau Bridge

Ao criar exibições de dados ou trabalhar diretamente na Web no Tableau Cloud, o Tableau Bridge fornece suporte completo de consulta para uma ampla variedade de bancos de dados e ambientes de dados na nuvem:

- **Conectores nomeados**: você pode estabelecer conexões de dados totalmente novas diretamente durante as sessões de criação na Web para quaisquer conectores nomeados com suporte expostos no painel de conexão do Tableau Cloud.
- **Conectores não nomeados/genéricos**: a criação na Web é totalmente compatível com determinados conectores de banco de dados não nomeados ao modificar conteúdo que já aponta para uma arquitetura funcional pré-existente apoiada pelo Bridge. Isso inclui:
    
    - A opção Editar fonte de dados pode não estar disponível para todos os conectores não nomeados.
    - Edição de uma fonte de dados inserida dentro de uma pasta de trabalho existente e em funcionamento.

O Tableau não oferece suporte à edição de fontes de dados publicadas por meio da criação na Web em todos os cenários. As limitações são as seguintes:

- A opção **Editar fonte de dados** pode não estar disponível para fontes de dados publicadas que usam conectores não nomeados (genéricos). O botão aparece esmaecido.
- A edição de uma fonte de dados publicada ao vivo que contém diversas conexões com fontes de dados do Bridge não é suportada atualmente e resultará em erro.

Para obter mais informações, consulte [Conectividade com o Bridge](https://help.tableau.com/current/online/pt-br/to_sync_local_data.htm).

No Tableau Public, você pode se conectar aos dados carregando um arquivo compatível.

### Conectar-se a arquivos

O Tableau suporta o upload de fontes de dados do Excel ou de texto (.xlsx, .csv, .tsv) diretamente no navegador. Na guia Arquivos do painel Conectar-se a dados, conecte-se a um arquivo do Excel ou de texto arrastando e soltando-o no campo ou clicando em Fazer upload por meio do computador. O tamanho máximo do arquivo que você pode carregar é 1 GB.

Se você não tiver um conjunto de dados, confira os [conjuntos de dados de amostra](https://public.tableau.com/pt-br/s/resources?qt-overview_resources=1#qt-overview_resources) gratuitos no site do Tableau Public.

### Uso de conectores

Na guia Conectores, é possível conectar-se a dados armazenados em um banco de dados na nuvem. É necessário fornecer informações de conexão para cada conexão de dados realizada. Por exemplo, para a maioria das conexões de dados, será necessário fornecer suas informações de logon.

[Conectores compatíveis](https://help.tableau.com/current/pro/desktop/pt-br/exampleconnections_overview.htm) têm informações sobre como conectar o Tableau aos dados usando conectores. Se o conector que você precisa não for exibido na guia Conectores, será possível se conectar aos dados por meio do Tableau Desktop e criar uma extração de dados.

**Observação**: se você não conseguir se conectar aos seus dados do Tableau Public, verifique se o banco de dados está acessível publicamente. O Tableau Public pode se conectar somente a dados que são acessíveis na Internet pública.

#### Conectores do Tableau Public

<table style="width: 100%;"><colgroup><col></colgroup><tbody><tr><td><p>Google Drive</p><p>OData</p></td></tr></tbody></table>

## Após conectar-se

Quando o Tableau se conecta aos dados, a página Fonte de dados é aberta para que você possa preparar os dados para análise e começar a criar a exibição. Para saber mais, consulte [Criadores: preparar dados na Web](https://help.tableau.com/current/pro/desktop/pt-br/creator_data_prep.htm).

## Manter dados atualizados na criação na Web

**Atualizar arquivos carregados no Tableau Cloud ou no Tableau Server**: se fizer o upload de um arquivo manualmente (Excel ou texto) para criação na Web, o Tableau não poderá atualizar o arquivo automaticamente. Para atualizar seus dados, selecione “Editar conexão” para fazer upload de uma nova versão do arquivo.

No Tableau Public, vá até a visualização e clique em Solicitar atualização. Você também pode manter os dados atualizados automaticamente selecionando “Mantenha esses dados em sincronia” no Tableau Desktop Public Edition.

**Atualizar fontes de dados publicadas baseadas em arquivos no Tableau Cloud**: se você tiver uma fonte de dados publicada no Tableau Cloud (publicada por meio do Tableau Desktop) que usa dados baseados em arquivos, você pode mantê-la atualizada usando o Tableau Bridge. Para obter mais informações, consulte [Ampliar as opções de atualização de dados usando o Tableau Bridge](https://help.tableau.com/current/online/pt-br/to_sync_local_data.htm).

A edição de uma fonte de dados publicada por meio da criação na Web não é suportada em todas as situações. As limitações são as seguintes:

- A opção Editar fonte de dados não está disponível para fontes de dados publicadas que usam conectores não nomeados (genéricos). O botão pode aparecer esmaecido.
- A edição de um PDS ativo, seja ele criado por meio da criação na Web ou publicado pelo Tableau Desktop, pode resultar em um erro de conexão. O Tableau Cloud pode tentar uma conexão direta com o banco de dados em vez de rotear por meio do Bridge, causando falha na solicitação.
- A edição de um PDS ativo que contém várias conexões com fontes de dados do Bridge não é suportada atualmente e resultará em erro.

Noções básicas sobre erros durante a criação na Web com Bridge

As mensagens de erro exibidas durante falhas de criação na Web podem não indicar claramente um problema relacionado ao Bridge. Cenários comuns e o que eles significam:

- Um erro de tempo limite de rede ou logon (por exemplo, “Ocorreu um erro específico da instância ou relacionado à rede” ou “Tempo limite de logon expirou”) pode indicar que o Tableau Cloud retorna a uma tentativa de conexão direta em vez de roteamento por meio do Bridge. Verifique se o cliente do Bridge está conectado e atribuído ao pool correto.
- O erro NO\_POOLED\_AGENTS\_ASSIGNED\_NAMED\_POOL indica que nenhum agente do Bridge está atribuído ao pool nomeado configurado para seu site. Atribua um cliente do Bridge ativo para resolver isso.
- Se o botão Editar fonte de dados estiver esmaecido, a fonte de dados usa um conector não nomeado para o qual a edição por meio da criação na Web não é suportada no momento.

<!-- document id=7be71eaaafe4e45ec0528f2b6d709bf57a76b65eeb62a0669f6f793c861af723 url=/tableau/current/pt-br/server/ask_data_lenses.md -->

[Pular para o conteúdo principal](#main-content)

# Criar ampliações que concentram Pergunte aos dados a públicos específicos

**Mudanças importantes chegando para Pergunte aos dados e Métricas**

Os recursos Pergunte aos dados e Métricas do Tableau serão descontinuados no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau AI e o Tableau Pulse estão reinventando a experiência com dados.](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-gpt)

A maioria das pessoas não precisa de informações de uma fonte de dados inteira; em vez disso, deseja visualizações de dados relevantes para a função de trabalho, como vendas, marketing ou suporte. Para otimizar Pergunte aos dados para públicos diferentes como esses, os autores do Tableau criam _ampliações_ separadas de Pergunte aos dados, que consultam um subconjunto selecionado de campos. Para os campos selecionados, os autores podem especificar sinônimos para nomes e valores de campo, refletindo os termos que o público-alvo usa na linguagem comum (por exemplo, "SF" para "São Francisco"). Os autores da ampliação personalizam as visualizações recomendadas que aparecem abaixo da caixa de consulta Pergunte aos dados, que fornecem respostas aos usuários com um único clique.

**Observação:** a ampliação de Pergunte aos dados pode ser criada apenas para fontes de dados publicadas separadamente em um site do Tableau. As ampliações não podem ser criadas para fontes de dados inseridas em pastas de trabalho ou com uma conexão virtual.

## Criar ou configurar uma página de ampliação no site do Tableau

Em seu site do Tableau, cada ampliação tem uma página separada onde os usuários podem consultar Pergunte aos dados e os autores podem configurar campos de ampliação, sinônimos e perguntas sugeridas.

![Uma ampliação de Pergunte aos dados](/tableau/current/pt-br/server/pt-br/Img/ask_data_lens_page.png)

Uma página de ampliação no site do Tableau

1. Para criar uma página de ampliação em seu site do Tableau, vá para uma página de fonte de dados e escolha Novo > Amplições de Perguntar aos dados .
    
    Para configurar uma ampliação existente, vá para a página da ampliação no seu site. (De um objeto Pergunte aos dados em um painel, é possível clicar no menu pop-up no canto superior e escolha Vá para a página de ampliação.)
2. Se você estiver criando uma nova ampliação, insira um nome, uma descrição e um local do projeto e clique em Publicar ampliação.
3. Na parte superior do painel Campos, clique no ícone de lápis: Em seguida, selecione os campos relevantes para os usuários de ampliação e clique em Salvar .
    
    ![Uma ampliação de Pergunte aos dados com o número de campos destacados.](/tableau/current/pt-br/server/pt-br/Img/ask_data_lens_fields.png)
4. À esquerda, focalize as tabelas ou os campos individuais e clique no ícone de lápis:
    
    ![Uma lista de campos com o ícone de edição ao lado de um valor.](/tableau/current/pt-br/server/pt-br/Img/ask_data_synonyms.png)
    
    Em seguida, faça uma das seguintes opções:
    
    - Forneça um nome mais representativo clicando no ícone de lápis à direita.
        
        ![Detalhes do campo com um ícone de edição.](/tableau/current/pt-br/server/pt-br/Img/ask_data_rename.png)
    - Adicione sinônimos comuns para nomes de campo e valores que os usuários do lens podem inserir em suas consultas.
    - Edite as descrições que aparecem quando os usuários passam o mouse sobre os campos

## Altere a lista de visualizações recomendadas

Para responder a consultas comuns de usuários de ampliações, você pode personalizar as visualizações recomendadas que aparecem abaixo da caixa de consulta.

### Adicionar ou substituir uma visualização recomendada

1. Insira uma consulta na caixa de texto e pressione Enter ou Return.
2. Depois que a visualização aparecer, no ícone de alfinete na barra de ferramentas, escolha Fixar nas visualizações recomendadas ou Substituir recomendação.
    
    ![Menu suspenso com duas opções: "Fixar nas visualizações recomendadas" e "Substituir recomendação".](/tableau/current/pt-br/server/pt-br/Img/ask_data_pin_recommended.png)
3. Para uma nova recomendação, digite um nome e escolha a seção em que deseja que apareça. Para obter uma recomendação de substituição, escolha a existente que deseja substituir.

### Edite títulos de seção e nomes de recomendação ou exclua recomendações

- Para editar um título de seção, clique no ícone de Lápis ![Ícone de lápis.](/tableau/current/pt-br/server/pt-br/Img/ask_data_edit_pencil.png) à direita do título.
- Para alterar o nome de uma recomendação existente, passe o cursor do mouse sobre ela e clique no ícone de Lápis ![Ícone de lápis.](/tableau/current/pt-br/server/pt-br/Img/ask_data_edit_pencil.png). Para Excluir uma recomendações, clique no X.
    
    ![Visualizações recomendadas](/tableau/current/pt-br/server/pt-br/Img/ask_data_lens_questions.png)

## Adicionar uma ampliação de Pergunte aos dados a um painel

Em um painel, você pode adicionar um objeto Pergunte aos dados que permite aos usuários consultar uma fonte de dados publicada por meio de uma ampliação em seu site do Tableau.

1. Ao editar um painel no Tableau Cloud ou Tableau Server, arraste o objeto Pergunte aos dados para a tela.
    
    **Observação:** no Tableau Desktop, você também pode arrastar um objeto de Pergunte aos dados para a tela para fins de posicionamento. Mas, para selecionar uma ampliação, você precisará publicar no Tableau Cloud ou Tableau Server e editar o objeto nesse local.
2. ![A área de objetos com Pergunte aos dados enfatizado.](/tableau/current/pt-br/server/pt-br/Img/ask_data_extension_to_canvas.png)
3. Selecione uma fonte de dados publicada previamente conectada à pasta de trabalho.
4. Para usar uma ampliação existente, selecione-a e clique em Usar ampliação.
    
    Ou, para criar um grupo, execute um dos seguintes procedimentos:
    
    - Se não houver ampliação para a fonte de dados, clique em Ir para a página da fonte de dados.
    - Se já existirem ampliações, clique no nome da fonte de dados na parte inferior da caixa de diálogo.
5. (Novas ampliações somentes) Conclua as etapas em [Criar ou configurar uma página de ampliação no site do Tableau](#Create).
6. Em Opções da barra de ferramentas para usuários de ampliações, selecione os botões que deseja disponibilizar aos usuários.
    - Adicionar visualização aos pinos permite que os usuários [adicionem à lista Visualizações recomendadas](#Change), que aparece logo abaixo da caixa de consulta.
    - Publicar como pasta de trabalho permite que os usuários [salvem visualizações como planilhas de pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/ask_data_share.htm#Save) no site do Tableau.
    - Compartilhar visualização permite que os usuários [compartilhem por e-mail, Slack ou um link](https://help.tableau.com/current/server/pt-br/ask_data.htm#Share).
        
        Na ampliação, as opções de publicação (ícone salvar), fixar e compartilhar aparecem no canto superior direito:
        
        ![Opções Salvar, Fixar e Compartilhar destacadas na barra de ferramentas de Pergunte aos dados.](/tableau/current/pt-br/server/pt-br/Img/ask_data_toolbar_options.png)
7. (Novas ampliações somente) Depois de terminar de criar a ampliação, volte ao objeto Ampliações em seu painel e clique em Atualizar. Em seguida, selecione a nova ampliação e clique em Usar ampliação.

## Aplicar uma ampliação diferente a um objeto do painel Pergunte aos dados

1. No menu suspenso na parte superior do objeto, selecione Configurar.
    
    ![Parte de uma visualização com a opção de configuração de Pergunte aos dados destacada.](/tableau/current/pt-br/server/pt-br/Img/ask_data_dashboard_configure.png)
2. Vá para [Adicionar uma ampliação de Pergunte aos dados a um painel](#Add) e repita as etapas 2 em diante.

## Alterar um nome de ampliação, descrição ou localização do projeto

1. Navegue até a página de ampliações no Tableau Cloud ou no Tableau Server.
2. À direita do nome da ampliação na parte superior da página, clique nos três pontos (...) e escolha Editar pasta de trabalho .
3. Clique em Editar detalhes da ampliação.

## Ver como as pessoas usam o Pergunte aos dados (Ask Data) com uma ampliação

Para proprietários de fonte de dados ou os autores da ampliação, o Pergunte aos dados fornece um painel que revela as consultas e campos mais populares, o número dos resultados de visualizações clicadas pelos usuários e outras informações úteis. Os filtros permitem restringir os dados para usuários e intervalos de tempo específicos. Essas estatísticas ajudam a otimizar ainda mais a ampliação para aumentar o sucesso dos usuários.

**Observação:** se você usar o Tableau Server, poderá acessar esses dados no repositório do Tableau Server para criar painéis personalizados.

1. No Tableau Server ou Tableau Cloud, navegue até uma página de ampliação.
2. À esquerda da caixa de texto Pergunte aos dados, clique no ícone de "Dicas de Pergunte aos dados".
    
    ![Passe o mouse sobre o ícone de informações que mostra a dica de ferramenta das dicas de Pergunte aos dados.](/tableau/current/pt-br/server/pt-br/Img/ask_data_tips_button.png)
3. No canto superior esquerdo da página do navegador, clique em Análises de uso.

## Permitir que os usuários lhe enviem perguntas sobre uma ampliação

Como um proprietário de ampliação, você pode permitir que os usuários enviem e-mails com perguntas sobre a estrutura de dados, resultados esperados e muito mais. Esta opção está ativada por padrão, mas você pode desativá-la seguindo as etapas abaixo.

1. No Tableau Server ou Tableau Cloud, navegue até uma página de ampliação.
2. À esquerda da caixa de texto Pergunte aos dados, clique no "i" mostrado acima em [Ver como as pessoas usam o Pergunte aos dados (Ask Data) com uma ampliação](#See) .
3. Na parte inferior da caixa de diálogo de dicas, clique no ícone de olho ao lado de "Contate o autor da ampliação" para ativar ou desativar o feedback.
    
    ![Otimize para a caixa de diálogo Pergunte aos dados com o ícone de olho destacado para mostrar a opção de mostrar ou ocultar a opção de entrar em contato com o autor da ampliação.](/tableau/current/pt-br/server/pt-br/Img/ask_data_disable_feedback.png)

## Permissões para publicar e visualizar ampliações

Para objetos Pergunte aos dados em painéis, nenhuma alteração nas permissões deve ser necessária: por padrão, os autores de pastas de trabalho existentes podem criar ampliações e os públicos de painéis existentes podem visualizá-las. Mas, para referência, aqui está um esboço detalhado das permissões de ampliação necessárias para ambos os painéis e acesso direto por meio de uma página de fonte de dados.

Para criar e publicar uma ampliação, o usuário precisa:

- Da função de usuário Creator ou Explorer
- Permissão de criação de ampliação para a fonte de dados (herdada por padrão da permissão de conexão)
- Permissão de gravação para o projeto pai no qual a ampliação foi publicada

Para acessar e interagir com uma ampliação publicada, um usuário precisa:

- Da função Viewer ou superior
- Conectar-se à permissão da fonte de dados.
- Ver permissão para a ampliação

**Observação:** por padrão, as permissões de ampliação, como Exibir, refletem as permissões de um projeto para pastas de trabalho. Se os administradores do Tableau quiserem alterar as permissões de ampliação padrão, eles podem fazer isso individualmente para cada projeto ou em massa usando a API de permissões.

<!-- document id=84e31df465ba0794ea36acb0506111172644f7773315d8c236be2a6ed64ff12e url=/tableau/current/pt-br/server/personal_space.md -->

[Pular para o conteúdo principal](#main-content)

# Criar e editar conteúdo privado no espaço pessoal

O Espaço pessoal é um local privado para todos os Explorers e Creators salvarem o conteúdo ao trabalhar em um site do Tableau. O conteúdo salvo no Espaço pessoal não pode ser compartilhado com outros usuários pode ser movido para um projeto quando você estiver pronto para que outros o vejam. No Espaço pessoal, você pode criar uma nova pasta de trabalho ou salvá-la no Espaço pessoal como uma cópia separada. Você também pode mover o conteúdo existente de sua propriedade para o Espaço pessoal para edição e, em seguida, voltar para um projeto mais tarde. Os exploradores podem baixar pastas de trabalho no Espaço pessoal, incluindo todos os dados incluídos na pasta de trabalho. As fontes de dados e os fluxos não podem ser salvos no seu Espaço pessoal.

## Privacidade no Espaço pessoal

O conteúdo salvo em seu espaço pessoal é visível apenas para você e os administradores do site. Os administradores do site não podem acessar diretamente o Espaço pessoal de nenhum usuário ou editar conteúdo no Espaço pessoal de outra pessoa, mas podem visualizar e gerenciar pastas de trabalho do Espaço pessoal. As pastas de trabalho do Espaço pessoal aparecem nos resultados da pesquisa do administrador e como um local da pasta de trabalho na página Explorar. Além disso, o menu de permissões não está disponível quando uma pasta de trabalho está no Espaço pessoal porque a pasta de trabalho é particular.

### Catálogo e espaço pessoal do Tableau

A partir do 2019.3, o Tableau Catalog está disponível com o Data Management no Tableau Cloud e no Tableau Server. Para obter mais informações, consulte "Sobre o Tableau Catalog”, na Ajuda do Tableau Server ou do Tableau Cloud.

Quando o Tableau Catalog está habilitado em seu ambiente de trabalho, as informações sobre as pastas de trabalho que você salva em seu Espaço pessoal são indexadas pelo Catalog. Essas pastas de trabalho estão incluídas nas contagens de linhagem; no entanto, apenas você pode ver as pastas de trabalho. Além disso, os usuários que navegam pela ferramenta de linhagem veem as Permissões necessárias em vez de informações sobre as pastas de trabalho em seu Espaço pessoal.

### Ferramentas de colaboração

Quando uma pasta de trabalho está no Espaço pessoal, algumas funcionalidades são desabilitadas, incluindo compartilhamento, métricas, comentários, alertas e assinaturas. Os alertas e inscrições existentes para você continuarão em execução, mas os alertas e inscrições para outras pessoas falharão, pois o conteúdo agora é privado. As métricas não podem ser criadas no Espaço pessoal mas continuarão funcionando se uma pasta de trabalho conectada for movida para lá. (O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm).)

Essas limitações são removidas quando a pasta de trabalho é movida ou salva em outro local. Por exemplo, se uma pasta de trabalho contiver comentários e for movida para o Espaço pessoal, os comentários existentes serão ocultados. Os comentários são restaurados quando a pasta de trabalho é movida para outro local.

### Extraia atualizações no Espaço pessoal

Para limitar o consumo de recursos, as atualizações de extração existentes continuam a ser executadas se tiverem sido agendadas, mas as novas atualizações de extração não podem ser agendadas enquanto uma pasta de trabalho estiver no Espaço pessoal.

## Encontre conteúdo no Espaço pessoal

Você pode acessar o Espaço pessoal no menu de navegação esquerdo para ver todo o conteúdo do Espaço pessoal ou criar uma nova pasta de trabalho e pode salvar nele ao criar ou editar uma pasta de trabalho em qualquer lugar do site.

![Guia Espaço pessoal no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/ps-navigation.png)

![Caminho para publicar uma pasta de trabalho no seu espaço pessoal.](/tableau/current/pt-br/server/pt-br/Img/ps-save.png)

Você também pode ver as pastas de trabalho no Espaço pessoal na página Explorar quando Todas as pastas de trabalho estiver selecionado e pode filtrar para o conteúdo do Espaço pessoal.

![Guia suspensa Explorar do Tableau Cloud com uma lista de pastas de trabalho e projetos.](/tableau/current/pt-br/server/pt-br/Img/ps-explore.png)

## Publicar uma pasta de trabalho no Espaço pessoal

O Espaço pessoal funciona como um projeto privado para você publicar uma pasta de trabalho nova ou existente no Tableau Cloud, Tableau Server ou Tableau Desktop.  

Se o Espaço pessoal estiver ativado, os rascunhos serão salvos automaticamente no Espaço pessoal, independentemente de qual projeto a nova pasta de trabalho foi criada.

Se o Espaço pessoal _não_ estiver habilitado, os rascunhos de novas pastas de trabalho serão salvos no projeto. No entanto, se uma nova pasta de trabalho for criada no projeto de nível superior, o rascunho não será salvo em nenhum lugar.

### Publicar um pasta de trabalho no Tableau Server ou Tableau Cloud

1. Com a pasta de trabalho aberta, selecione Arquivo > Publicar como.
2. Em Local, selecione Espaço pessoal.
    
    ![Caminho para publicar uma pasta de trabalho no seu espaço pessoal.](/tableau/current/pt-br/server/pt-br/Img/ps-save.png)

**Observação:** os Explorers só podem salvar pastas de trabalho no Espaço Pessoal e não podem ver uma caixa de diálogo de seleção de local.

### Publicar uma pasta de trabalho no Espaço pessoal do Tableau Desktop

A partir de 2023.1, você pode publicar uma pasta de trabalho no Espaço pessoal do Tableau Desktop.

1. Com a pasta de trabalho que deseja publicar aberta no Tableau Desktop, selecione Server > Publicar pasta de trabalho.
2. Em Projeto, selecione Espaço pessoal .
3. Em Fontes de dados, selecione Editar.
4. No pop-up Gerenciar fontes de dados em Tipo de publicação, selecione Incorporado na pasta de trabalho para todas as fontes de dados. Você deve incorporar fontes de dados ao publicar no Tableau Desktop, porque não pode publicar fontes de dados separadamente no Espaço pessoal.
5. Preencha o restante das opções de publicação como de costume. Para obter mais informações, consulte [Etapas abrangentes para publicar uma pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/publish_workbooks_howto.htm).

## Mova as pastas de trabalho para o espaço pessoal

Você pode mover uma pasta de trabalho existente para o Espaço pessoal se for o proprietário da pasta de trabalho e houver espaço em seu Espaço pessoal. Os limites de armazenamento do espaço pessoal são definidos pelos administradores.

Para mover uma pasta de trabalho para o Espaço pessoal:

- Selecione uma pasta de trabalho e clique no menu suspenso Ações.
- Selecione Mover.
- Em Local, selecione Espaço pessoal.

**Observação:** os Explorers só podem salvar pastas de trabalho no Espaço pessoal e podem não ver a ação Mover ou a caixa de diálogo de seleção de local.

Para obter mais informações, consulte [Executar ações](https://help.tableau.com/current/pro/desktop/pt-br/qs_content_page.htm#perform-actions) no tópico de ajuda Gerenciar conteúdo da Web.

Quando você move uma pasta de trabalho ou fonte de dados existente para o Espaço pessoal, ferramentas como compartilhamento, alertas e assinaturas ficam ocultas. As atualizações de extração existentes continuam a ser executadas se tiverem sido agendadas, mas os usuários não podem agendar novas atualizações de extração em seu Espaço pessoal.

As assinaturas e alertas existentes também continuam, mas não podem ser editados no Espaço pessoal e falharão se outros usuários forem os destinatários. As métricas conectadas existentes continuarão a ser atualizadas, mas a visualização conectada não ficará visível para outros usuários.

## Mover pastas de trabalho do espaço pessoal

Quando você remove uma pasta de trabalho do Espaço pessoal, ferramentas de colaboração como compartilhamento, alertas e assinaturas tornam-se visíveis e quaisquer comentários existentes reaparecem.

<!-- document id=3b53fcd986a6e88e77a0f3d11d12ee313a838e62b493075813297da3fa0a31fd url=/tableau/current/pt-br/server/web_author_flows.md -->

[Pular para o conteúdo principal](#main-content)

# Criar e interagir com fluxos na Web

A partir da versão 2020.4, você pode criar e interagir com fluxos no Tableau Server para limpar e preparar seus dados. Conecte-se aos seus dados, crie um novo fluxo ou edite um fluxo existente, e seu trabalho é automaticamente salvo a cada poucos segundos à medida que você prossegue. Crie fluxos de rascunho que só estão disponíveis para você ou publique seu fluxo para torná-lo disponível para terceiros. Execute os fluxos individuais diretamente na Web ou automaticamente de acordo com a agenda usando o Tableau, se Data Management estiver licenciado. Para obter mais informações, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm).

Para obter mais informações sobre a configuração do processo de Criação do fluxo do Tableau Prep no Tableau Server, consulte [Criação de fluxos do Tableau Prep](https://help.tableau.com/current/server/pt-br/server_process_prep_flow_authoring.htm).

Conclua as tarefas descritas neste artigo para habilitar a criação na Web para fluxos e outros recursos de fluxo na Web.

## Ativar ou desativar a criação na Web de fluxo para um site

Ativada por padrão, esta opção controla se os usuários podem criar e editar fluxos em Tableau Server ou Tableau Cloud

1. Em um navegador da Web, entre no servidor como administrador, acesse o site e clique em Configurações.
2. Na seção **Criação na Web**, desmarque ou selecione Fluxos. Deixe que os usuários editem fluxo no navegador. para ativar ou desativar a funcionalidade.
    
    ![As configurações de criação na Web, e a caixa para “Fluxos. Deixe que os usuários editem fluxos no navegador.” é marcada e destacada.](/tableau/current/pt-br/server/pt-br/Img/prep_pwa_admin.png)
3. Se você quiser que a alteração entre em vigor imediatamente, reinicie o servidor. Caso contrário, a alteração terá efeito depois que o cache da sessão do servidor expirar na próxima vez que um usuário fizer logon, depois que sair.

## Habilitar tarefas vinculadas

_Compatível com Tableau Cloud e Tableau Server versão 2021.3 e posterior._

Use a opção Tarefas vinculadas para agendar até 20 fluxos para execução, um após o outro. As tarefas vinculadas só podem ser executadas em agendamentos com a opção Tarefas vinculadas selecionada. Para obter mais informações sobre a configuração de tarefas vinculadas, consulte Agendar tarefas vinculadas.

A partir da versão 2022.1, as Tarefas vinculadas são habilitadas por padrão nas Configurações do servidor e para quaisquer novas agendas de fluxo que você criar. Nas versões anteriores, os administradores devem primeiro habilitar a opção.

Se você tiver vários sites, poderá desativar as Tarefas vinculadas para sites individuais desmarcando as caixas de seleção descritas abaixo.

Se a configuração for desabilitada depois que as tarefas vinculadas forem agendadas, todas as tarefas em execução serão concluídas, e as tarefas vinculadas agendadas serão ocultadas e não serão mais exibidas na guia Tarefas agendadas.

**Habilitar tarefas vinculadas** (versão 2021.4 e anterior)

1. Em um navegador da Web, entre no servidor como um administrador e acesse o site no qual deseja habilitar Tarefas vinculadas para fluxos. Neste site, clique em Configurações.
2. Na seção **Tarefas vinculadas**, selecione Permitir que os usuários agendem tarefas vinculadas para permitir que os administradores configurem agendas para executar tarefas vinculadas.
3. Selecione Permitir que os usuários executem tarefas vinculadas manualmente usando Executar agora para permitir que os usuários executem tarefas de fluxo vinculadas usando Executar agora.
    
    ![A configuração do site com duas caixas de seleção para permitir o agendamento ou a execução manual de tarefas vinculadas.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_settings.png)

## Habilitar parâmetros de fluxo

Permita que os usuários planejem e executem fluxos que incluem parâmetros. Os parâmetros permitem que os usuários escalonem os fluxos criando-os uma vez e, em seguida, alterando os valores dos parâmetros para acomodar diferentes cenários de dados.  

Os parâmetros podem ser inseridos em uma etapa de entrada para nome de arquivo e caminho, nome de tabela ou ao usar consultas SQL personalizado, em uma etapa de saída para nome de arquivo e caminho e nome de tabela, e em qualquer tipo de etapa para filtros ou valores calculados.

A partir do Tableau Prep Builder e do Tableau Cloud versão 2023.2, você pode adicionar parâmetros do sistema aos nomes de saída de fluxo para incluir automaticamente a data e hora de início da execução do fluxo.

As configurações de parâmetro de fluxo podem ser aplicadas no nível do servidor para incluir todos os sites no Tableau Server. As configurações podem ser desabilitadas no nível do site para incluir apenas sites específicos.

Para obter mais informações sobre como usar parâmetros nos fluxos, consulte [Criar e usar parâmetros em fluxos](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm) na ajuda do Tableau Prep.

1. Em um navegador da Web, entre no servidor como um administrador e acesse o site no qual deseja habilitar as extensões dos Parâmetros de fluxo. Neste site, clique em Configurações.
2. Na seção **Parâmetros de fluxo**, selecione Permitir que os usuários executem e agendem fluxos que usam parâmetros para habilitar a funcionalidade.
3. (versão 2023.2 e posterior) Selecione Permitir que parâmetros gerados pelo sistema, como data e hora, sejam aplicados aos nomes de saída para permitir que os usuários adicionem uma data ou hora ao nome da saída de fluxo em tempo de execução para tipos de saída de fonte de dados publicada e arquivo.
4. Selecione Permitir parâmetros que podem aceitar qualquer entrada para permitir que qualquer pessoa executando o fluxo insira qualquer valor de parâmetro no fluxo em tempo de execução.
    
    > [!IMPORTANT]
    > 
    > **Importante**: definir esta opção permite que qualquer usuário de fluxo insira qualquer valor em um parâmetro, potencialmente expondo dados aos quais o usuário não deve ter acesso.
    
    Se esta opção não for selecionada, os usuários podem selecionar apenas na lista predefinida de valores de parâmetro, e os fluxos que incluem parâmetros compatíveis com qualquer valor não podem ser executados ou planejados para execução.
    
    ![A caixa de diálogo Parâmetros de fluxo. Todas as caixas estão marcadas: Permitir que os usuários executem e agendem fluxos que usam parâmetros; Permitir que parâmetros gerados pelo sistema, como carimbos de data/hora, sejam aplicados aos nomes de saída; Permitir parâmetros que podem aceitar qualquer entrada. ](/tableau/current/pt-br/server/pt-br/Img/prep_parameters_settings.png)

## Habilitar o Tableau Prep Conductor

Se Data Management estiver licenciado, ative esta opção para permitir que os usuários agendem e rastreiem os fluxos no Tableau Server e Tableau Cloud. Para obter informações sobre os requisitos de configuração adicionais para Tableau Prep Conductor, consulte [Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/server_process_prep_conductor.htm).

1. Em um navegador da Web, entre no servidor como um administrador e acesse o site no qual deseja habilitar o Tableau Prep Conductor. Neste site, clique em Configurações.
2. Na seção **Tableau Prep Conductor** , selecione Permitir que os usuários agendem e monitorem os fluxos para habilitar a funcionalidade.
    
    ![Nas configurações do Tableau Prep Conductor, uma caixa para “Permitir que os usuários agendem e monitorem fluxos” está marcada.](/tableau/current/pt-br/server/pt-br/Img/prep_pwa_admin3.png)

## Habilitar Executar agora

Controle se os usuários ou apenas os administradores podem executar fluxos manualmente usando a opção Executar agora. Data Management não é necessário para executar fluxos manualmente.

1. Em um navegador da Web, entre no servidor como um administrador e acesse o site no qual deseja habilitar a Executar agora para fluxos. Neste site, clique em Configurações.
2. Na seção **Executar agora**, selecione Permitir que os usuários executem trabalhos manualmente usando Executar agora para habilitar a funcionalidade.
    
    ![Nas configurações de Executar agora, a caixa "Permitir que os usuários executem trabalhos manualmente usando Executar agora" está marcada.](/tableau/current/pt-br/server/pt-br/Img/prep_pwa_admin2.png)
    
    Desmarque a caixa de seleção se apenas Administradores de servidor puderem executar fluxos manualmente.

## Inscrições de fluxo

Controle se os usuários podem receber notificações de fluxo sobre tarefas planejadas para execuções de fluxo bem-sucedidas. Data Management é necessário para ativar as notificações.

1. Em um navegador da Web, entre no servidor como um administrador e acesse o site no qual deseja habilitar as assinaturas de fluxo. Neste site, clique em Configurações.
2. Na seção **Inscrições de fluxo**, selecione Permitir que os usuários enviem ou recebam e-mails que incluem dados de saída de fluxo para habilitar a funcionalidade. ![A configuração do site Inscrições de fluxo mostra a caixa de seleção marcada para enviar e receber notificações por e-mail.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_site.png)
    
    **Observação**: a opção de anexar um tipo de arquivo .csv ou .xlsx ao e-mail está disponível apenas para ambientes locais.

## Habilitar as extensões do Tableau Prep

_Compatível com Tableau Server e Tableau Cloud a partir da versão 2021.2.0_

Defina esta opção para controlar se os usuários podem se conectar ao Einstein Discovery para executar modelos preditivos em relação aos dados no fluxo.

Você pode usar os modelos do Einstein Discovery para fazer previsões de pontuação em massa para os dados no fluxo, ao criar fluxos na Web. As previsões podem ajudar você a tomar decisões bem fundamentadas e adotar ações para melhorar os resultados da sua empresa.

Você precisará definir configurações adicionais para incluir previsões em nosso fluxo. Para obter mais informações, consulte [Adicionar previsões do Einstein Discovery ao seu fluxo](https://help.tableau.com/current/prep/pt-br/prep_predictions.htm) e [Configurar integração do Einstein Discovery](https://help.tableau.com/current/server/pt-br/config_einstein_extensions.htm#einstein-discovery-tableau-prep-extensions).

1. Em um navegador da Web, entre no servidor como um administrador e acesse o site no qual deseja habilitar as extensões do Tableau Prep. Neste site, clique em Configurações > Extensões.
2. Na seção **Extensões do Tableau Prep** do Tableau, selecione Permitir que os usuários se conectem ao Einstein Discovery para habilitar a funcionalidade.
    
    ![Uma caixa de texto que descreve as extensões do Tableau Prep. A caixa “Permitir que o usuário se conecte ao Einstein Discovery” está marcada.](/tableau/current/pt-br/server/pt-br/Img/prep_pwa_admin_einstein_discovery.png)

## Ligar ou desligar o salvamento automático

Habilitado por padrão, esse recurso salva automaticamente o trabalho de fluxo de um usuário a cada poucos segundos.

Embora não seja recomendado, os administradores podem desabilitar o salvamento automático em um site usando o método “Atualizar site” da API REST do Tableau Server e a configuração `flowAutoSaveEnabled`. Para obter mais informações, consulte [Métodos de site da API REST do Tableau Server: site de atualização](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_sites.htm#update_site). Para obter mais informações sobre salvamento automático na Web, consulte [Ligar ou desligar o salvamento automático](#autosave).

Para obter mais informações sobre configurar sites, consulte [Referência de configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm) na ajuda do Tableau Server.

## Outros artigos nesta seção

<!-- document id=1fa108d730994026a6f00b9b1f3e583b219dfd0944be11d3e3356a65edfc1d8f url=/tableau/current/pt-br/server/metrics_create.md -->

[Pular para o conteúdo principal](#main-content)

# Criar e solucionar problemas de métricas (descontinuado)

## Métricas herdadas descontinuadas

Este artigo é sobre o recurso de métricas herdado do Tableau, que foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3.

O Tableau Pulse apresenta uma nova maneira de monitorar métricas. Com o Tableau Pulse, as métricas criadas são usadas para gerar informações sobre seus dados. Essas informações de dados são enviados diretamente aos usuários que seguem as métricas, para que possam aprender sobre as alterações em seus dados em seu fluxo de trabalho. Para obter mais informações, consulte [Criar Métricas com o Tableau Pulse](https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm).

Se você tiver métricas herdadas que deseja manter, anote a fonte de dados, a medida e a dimensão de tempo dessas métricas e recrie-as no Tableau Pulse. As métricas herdadas não serão migradas automaticamente para o Tableau Pulse.

As métricas fornecem uma maneira rápida de se manter informado sobre seus dados. Como as métricas são atualizadas automaticamente e exibem seu valor atual na grade e na exibição de lista de seu conteúdo, você pode verificar todos os números importantes de seu interesse em segundos.

![Grade de métricas de lucro com status bom e ruim](/tableau/current/pt-br/server/pt-br/Img/metrics_grid.png)

No nível mais básico, as métricas mostram o valor de uma medida agregada, como a soma das vendas. As métricas mais complexas podem incluir linhas de tempo, comparações e status que fornecem um indicador fácil de entender de seu desempenho em relação a um ponto anterior no tempo ou a um valor que você definiu.

Se você tiver um conjunto de painéis verificados com regularidade, crie métricas para os números que deseja monitorar e acompanhe-os em um só lugar, adicionando-os aos favoritos ou a uma coleção ou criando-os no mesmo projeto. Dessa forma, você não precisa carregar e filtrar os painéis, a menos que queira se aprofundar em seus dados.

## Encontrar métricas em seu site

Existem algumas maneiras de localizar métricas em seu site do Tableau. Para navegar por todas as métricas que você tem permissão para visualizar, navegue até a página Explorar e selecione Todas as métricas no menu de tipo de conteúdo.

Se você está procurando métricas relacionadas a uma determinada exibição ou pasta de trabalho, verifique as métricas conectadas para esse conteúdo. Para ver métricas conectadas para uma exibição, abra a exibição e, em seguida, clique em Observar > Métricas na barra de ferramentas da exibição. As métricas exibidas são ordenadas desde a data de criação mais nova até a mais antiga.

![Barra de ferramentas da exibição e métricas conectadas à exibição](/tableau/current/pt-br/server/pt-br/Img/metrics_connected_view.png)

Para ver as métricas criadas nas exibições de uma pasta de trabalho, abra a pasta de trabalho e clique na guia Métricas conectadas. Você pode classificar essas métricas usando um menu Classificar por.

![Página da pasta de trabalho e métricas conectadas à pasta de trabalho](/tableau/current/pt-br/server/pt-br/Img/metrics_connected_workbook.png)

## Componentes de uma métrica

Os únicos dados necessários para definir uma métrica são uma medida agregada. As métricas são criadas a partir de uma marca em uma vista, e a medida associada a essa marca define a métrica. A medida deve ser agregada, porque uma marca não agregada não mudará com o tempo. Para obter mais informações sobre dimensões e medidas, consulte [Dimensões e medidas, azul e verde](https://help.tableau.com/current/pro/desktop/pt-br/datafields_typesandroles.htm).

Uma métrica pode ser definida opcionalmente por uma dimensão de data e você pode configurar uma comparação e um status para sua métrica. Cada um desses componentes adicionará contexto aos dados apresentados no cartão métrico.

As métricas que possuem apenas uma medida definindo-as aparecerão como um único número. Este número será atualizado quando os dados forem atualizados, mas não haverá linha de tempo no cartão.

![Uma métrica de número único](/tableau/current/pt-br/server/pt-br/Img/metrics_single_number.png)

### Linha do tempo

Quando você seleciona uma marca para definir uma métrica, se a marca tiver uma dimensão de data associada a ela, essa dimensão se torna parte da definição da métrica. As métricas com uma dimensão de data mostram uma linha do tempo e você pode configurar a comparação histórica para a métrica. Por padrão, a comparação histórica é feita com a marca anterior.

Ao abrir uma página de detalhes da métrica, a linha de tempo mostra o valor da medida com base na granularidade da dimensão de data, por exemplo, vendas diárias ou usuários mensais. Focalize os pontos na linha do tempo para ver os valores históricos.

![Linha de tempo dos valores de vendas mensais](/tableau/current/pt-br/server/pt-br/Img/metrics_timeline.gif)

### Comparação

Existem dois tipos de comparações que você pode configurar para métricas: comparações históricas e comparações constantes. Você pode configurar uma comparação histórica apenas se uma métrica tiver uma dimensão de data associada a ela, mas comparações constantes podem ser adicionadas para qualquer tipo de métrica.

Uma comparação histórica é uma comparação relativa entre o valor atual e um número especificado de horas, dias ou outra unidade de tempo anterior. Por exemplo, você pode definir uma comparação entre o valor atual das vendas mensais e o valor de 12 meses atrás. Cada vez que os dados são adicionados a uma métrica, a comparação histórica será ajustada em relação à data ou hora dos novos dados.

![A métrica aumentou 20% em relação ao período de comparação](/tableau/current/pt-br/server/pt-br/Img/metrics_historical_comp.png)

As comparações constantes são para um único valor que não muda conforme novos dados são adicionados. Você pode definir uma comparação para representar um limite para ficar acima, por exemplo, se precisar manter uma taxa de entrega no prazo de 90%. Ou você pode definir uma meta cumulativa que você está trabalhando, por exemplo, uma meta de vendas mensal.

![Métrica de US$ 4.640 acima do valor de comparação](/tableau/current/pt-br/server/pt-br/Img/metrics_constant_comp.png)

### Status

Para métricas com uma comparação constante, você pode definir se estar acima, abaixo ou no valor de comparação é bom, ruim ou neutro. Uma métrica com um status “bom” exibirá uma marca de seleção ao lado do valor de comparação e o cartão da métrica terá uma faixa verde na parte superior. Uma métrica com um status “ruim” exibirá um X próximo ao valor de comparação e o cartão da métrica terá uma faixa vermelha na parte superior. As métricas com um status “neutro” aparecem da mesma forma que as métricas sem um indicador de status; não há ícone ou cor aplicada ao cartão.

![Métricas com status neutro, ruim e bom](/tableau/current/pt-br/server/pt-br/Img/metrics_status.png)

## Criar uma métrica com base em uma exibição

Se você tiver uma função no site de Creator ou Explorer (pode publicar), e você tem o recurso Criar/Atualizar Métrica na pasta de trabalho relevante, poderá criar métricas no Tableau Cloud ou no Tableau Server.

Antes de criar uma métrica, verifique as métricas conectadas para a visualização para certificar-se de que a métrica que você está planejando criar ainda não exista. Em vez de criar uma métrica duplicada, abra a métrica existente e adicione-a como favorita.

### Selecionar a marca para definir sua métrica

1. Acesse a exibição em que deseja criar uma métrica.
2. Na barra de ferramentas da exibição, selecione o botão Observar > Métricas.
    
    ![Barra de ferramentas da exibição com o botão de métricas destacado](/tableau/current/pt-br/server/pt-br/Img/metrics_toolbar.png)
    
    O painel Métricas é aberto.
3. Se o painel mostrar métricas conectadas, selecione o botão Criar para entrar no modo de criação.
4. Selecionar uma marca. Se encontrar um erro, consulte [Quando você não pode criar uma métrica](#when-you-cant).
    
    ![Seleção de uma marca em uma visualização de vários gráficos](/tableau/current/pt-br/server/pt-br/Img/metrics_mark_selection.png)
    
    A medida associada a esta marca define sua métrica. Os filtros aplicados à marca são aplicados à métrica. Se esta marca tiver uma dimensão de data associada a ela, essa dimensão de data também definirá sua métrica, e sua métrica exibirá uma linha de tempo.
    
    O painel Métricas mostra uma prévia da métrica. O valor na visualização é o valor mais recente da métrica, que pode diferir do valor da marca selecionada, se ela não era a mais recente na série de tempo. A visualização é atualizada conforme você tenta diferentes configurações.
    
    ![A visualização das configurações métricas](/tableau/current/pt-br/server/pt-br/Img/metrics_preview.gif)

### Descrever e configurar a métrica

As opções disponíveis para configurar a métrica dependem da marca que você selecionar e do tipo de comparação que você escolher.

1. O campo Nome é pré-preenchido com base na seleção. Você pode dar um nome diferente à métrica. Uma métrica deve ter um nome exclusivo dentro do projeto a que pertence.
2. Em Descrição, digite uma mensagem opcional para ajudar as outras pessoas a entenderem sua métrica. Por exemplo, descreva os filtros aplicados à métrica ou indicar a fonte de dados usada pela métrica.
3. Para o Intervalo de dados (apenas para métricas com uma dimensão de data), selecione uma das opções padrão ou defina um intervalo personalizado. Se a métrica tiver um grande número de marcas, limitar o intervalo de datas pode facilitar a leitura da linha do tempo.
4. Selecione o Tipo de comparação para a métrica: histórica ou constante.
5. Para comparações Históricas:
    
    - Insira o quanto antes você deseja comparar. A unidade de tempo da comparação é igual à granularidade dos seus dados, como horas ou meses.
    - Selecione Mostrar linha de comparação para incluir uma segunda linha para o período de comparação na linha do tempo.
6. Para comparações Constantes:
    
    - Insira o valor com o qual comparar. Não inclua vírgulas ou símbolos neste campo. Para inserir uma porcentagem, simplesmente digite o número sem o sinal de porcentagem, por exemplo, insira 25 em vez de 0,25 para uma meta de 25%. Quando você insere um valor de destino válido, a visualização é atualizada para mostrar o quão acima ou abaixo do destino está o valor atual.
    - Defina o Status da comparação para indicar se estar acima, igual ou abaixo do valor é bom, ruim ou neutro. Por padrão, o status é definido como neutro. Verifique a visualização da métrica para ver como os diferentes status afetam sua métrica.
7. Em Definição > Medida, selecione a medida a ser usada para sua definição a partir do menu suspenso. Esta opção só aparece se a marca selecionada tiver mais de uma medida associada a ela.

![Seleção da medida no menu suspenso](/tableau/current/pt-br/server/pt-br/Img/metrics_disambiguate.png)

### Finalizar sua métrica

1. Em Projeto, selecione Alterar localização para escolher um projeto diferente para a métrica. Por padrão, sua métrica será adicionada ao mesmo projeto ao qual a visualização pertence.
    
    Cada métrica em um projeto deve ter um nome exclusivo. Como o nome e o projeto de uma métrica são inicialmente definidos com base na marca selecionada, você pode entrar em conflito ao tentar salvar sua métrica, se outro usuário já tiver criado uma métrica com base nessa marca. Escolha um projeto ou nome diferente para sua métrica ou, se quiser sobrescrever a métrica existente, consulte [Substituir uma métrica](#overwrite).
2. Clique no botão Criar.
    
    Uma mensagem será exibida com um link para a métrica no projeto em que você a adicionou.
    
    ![Mensagem de sucesso](/tableau/current/pt-br/server/pt-br/Img/metrics_success.png)
3. Verifique se as permissões para sua métrica estão corretas, seguindo as orientações em [Definir permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#set-permissions).
    
    Por padrão, uma métrica herda as permissões do projeto em que foi criada. Qualquer pessoa com acesso à sua métrica poderá ver os dados da métrica, mesmo se não tiver permissão para acessar a exibição conectada ou fonte de dados.

Agora que criou uma métrica, você pode gerenciar a métrica da mesma forma que gerencia outras partes independentes de conteúdo em seu site do Tableau. Embora as métricas sejam criadas com base em uma exibição, elas existem independentemente dela, ao contrário de alertas ou assinaturas acionadas por dados. Você pode mover a métrica para um projeto diferente sem mover a exibição conectada. Para obter informações sobre como gerenciar conteúdo em seu site do Tableau, consulte [Gerenciar conteúdo da Web](https://help.tableau.com/current/pro/desktop/pt-br/qs_content_page.htm).

### Substituir uma métrica

Depois que uma métrica é criada, você pode alterar o nome, a descrição e a configuração da métrica, mas não pode alterar como a métrica é definida. Se quiser alterar os dados que a métrica usa, você deve sobrescrevê-los. Para sobrescrever uma métrica, você precisa ser o proprietário da métrica ou receber o recurso de permissão correto.

1. Para sobrescrever uma métrica, crie uma métrica com o mesmo nome no mesmo projeto da métrica deseja substituir.
    
    A caixa de diálogo Substituir métrica será exibida.
2. Clique no botão Substituir.

Quando você substitui uma métrica, a métrica continua sendo exibida para quem a adicionou aos favoritos, e as alterações realizadas nas permissões da métrica anterior serão aplicadas à nova métrica.

### Quando você não pode criar uma métrica

Se você selecionar uma marca em um gráfico que não é compatível com as métricas, receberá uma mensagem de erro explicando por que não pode criar uma métrica. A tabela abaixo resume esses cenários.

<table class="table--plain"><colgroup><col style="width: 34%;"><col></colgroup><thead><tr><th>Motivo</th><th>Cenários</th></tr></thead><tbody><tr><td>Você não tem as permissões corretas.</td><td><ul><li>O proprietário da pasta de trabalho ou um administrador negou o recurso Criar/Atualizar métrica. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/permissions.htm">Permissões</a>.</li></ul></td></tr><tr><td>Você não pode acessar os dados completos.</td><td><ul><li>A segurança a nível de linha ou os filtros do usuário limitam os dados que você pode ver. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters.htm">Restrição de acesso no nível de linha de dados</a>.</li></ul></td></tr><tr><td>A senha da fonte de dados da pasta de trabalho não está incorporada ou não é mais válida.</td><td><ul><li>A pasta de trabalho solicita uma senha. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/publishing_sharing_authentication.htm">Definir credenciais para acessar os dados de trabalho publicados</a>.</li></ul></td></tr><tr><td>Os dados não estão no nível correto de granularidade.</td><td><ul><li>Os dados no gráfico não são agregados. As métricas utilizam agregações, como soma ou média. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/calculations_aggregation.htm">Agregação de dados no Tableau</a>.</li><li>Há vários valores por célula de dados, um resultado da combinação de dados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/multipleconnections_troubleshooting.htm">Solucionar problemas da Combinação de dados</a>.</li></ul></td></tr><tr><td>A dimensão de data não é compatível.</td><td><ul><li>O gráfico inclui partes da data e valores de data. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/dates_levels.htm">Alterar níveis de data</a>.</li><li>A dimensão de data usa o calendário ISO 8601 em vez do calendário gregoriano padrão. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/dates_calendar.htm">Calendário ISO-8601 baseado em semana</a>.</li><li>A dimensão da data é agregada no nível personalizado de Mês / Ano ou Mês / Dia / Ano. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/dates_custom.htm">Datas personalizadas</a>.</li></ul></td></tr></tbody></table>

## Editar a configuração de uma métrica

A partir de 2022.2, você pode alterar a configuração de uma métrica. A configuração de uma métrica inclui a comparação, o intervalo de datas e o indicador de status. As opções de configuração disponíveis dependem do tipo de métrica. As métricas com uma linha do tempo permitem definir uma comparação histórica ou uma comparação constante. A métrica de número único suporta apenas uma comparação constante.

A configuração de uma métrica não inclui a definição de métrica (a dimensão de medida e data que gera o valor da métrica). Se você quiser alterar a definição, substitua a métrica por uma nova métrica.

Para editar a configuração de uma métrica, você deve ter o recurso de substituição para a métrica.

1. Abra a página de detalhes da métrica que você deseja editar.
2. Passe o cursor sobre a seção de configuração. Clique em qualquer lugar na seção para entrar no modo de edição.
    
    ![Seção de configuração de métricas ao passar o mouse](/tableau/current/pt-br/server/pt-br/Img/metrics_edit_config.png)
3. Para uma métrica de linha do tempo, defina o intervalo de datas a ser exibido no cartão de métrica e nos detalhes.
4. Selecionar o tipo de comparação Para uma comparação constante, defina um valor de comparação e um status. Para uma comparação histórica, defina com quanto tempo você deseja comparar e escolha se deseja mostrar uma linha de comparação na linha do tempo.
5. Clique em Salvar. Suas alterações de configuração aparecerão para qualquer pessoa que visualizar a métrica.

## Como as métricas se atualizam

Quando uma métrica é atualizada, ela verifica a exibição conectada (a exibição da métrica foi criada a partir de) dos novos dados. Uma atualização não atualiza necessariamente o valor de uma métrica, pois pode não haver alterações nos dados.

As métricas são atualizadas em uma frequência com base no cronograma de atualização de uma extração ou, para dados em tempo real, a cada 60 minutos. O tempo da última atualização é exibido na métrica.

## Corrigir atualizações com falha

Se uma métrica não for capaz de acessar a exibição conectada ou seus dados subjacentes, a atualização falhará. Se a atualização da métrica falhar, você receberá uma notificação, que indica o tempo da falha e a métrica afetada.

Pode ocorrer falha nas atualizações das métricas por um dos seguintes motivos.

- A exibição conectada foi excluída ou modificada.
- As permissões foram alteradas para a exibição conectada.
- A senha da fonte de dados não está mais incorporada ou não é mais válida.
- O proprietário da métrica não tem a função de site necessária para atualizar a métrica. Uma função de site de Creator ou Explorer (pode publicar) é necessária.
- Houve um problema temporário de conectividade, que se resolverá.

Para identificar a causa da falha, analise os detalhes da métrica. Certifique-se de que o proprietário da métrica tenha a função de site necessária para atualizar a métrica. Em seguida, inspecione a Exibição conectada.

![Exibição conectada à métrica destacada em Detalhes da métrica](/tableau/current/pt-br/server/pt-br/Img/metric_details.png)

### Se a exibição conectada ainda estiver listada

Abra a exibição para investigar a causa da falha.

Se a exibição for carregada, verifique se ela inda contém a medida e a dimensão (opcional) de data que definem a métrica.

- Se a exibição parecer inalterada, talvez você não tenha mais permissão para atualizar as métricas dela. O proprietário do conteúdo ou um administrador do Tableau pode alterar o recurso de permissão Criar/Atualizar métrica. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).
- Se a medida não estiver mais presente, a exibição foi modificada, portanto, a métrica não pode se conectar aos dados necessários para atualizar. O proprietário do conteúdo ou um administrador do Tableau pode verificar o histórico de revisão e restaurar versões anteriores. Para obter mais informações, consulte [Exibir histórico de revisões](https://help.tableau.com/current/pro/desktop/pt-br/qs_revision_history.htm#view-revision-history)

Se a exibição não carregar, mas em vez disso solicitar uma senha ou exibir um erro ao conectar-se à fonte de dados, a senha da fonte de dados não está inserida ou não é mais válida. O proprietário do conteúdo ou um administrador do Tableau pode editar a conexão da fonte de dados para incorporar a senha. Para obter mais informações, consulte [Editar conexões](https://help.tableau.com/current/online/pt-br/to_connections_modify.htm).

### Se não houver exibição conectada listada

A exibição foi excluída ou você não tem mais permissão para acessá-la. Entre em contato com o administrador do Tableau para obter assistência.

## Retomar atualizações suspensas

Se uma atualização falhar muitas vezes, ela será suspensa. Você receberá uma notificação se a atualização de sua métrica for suspensa.

Quando uma atualização de métrica é suspensa, o Tableau não tenta mais obter novos dados da métrica. Métricas com atualizações suspensas continuam a apresentar dados históricos.

Se a causa da falha for corrigida, você pode retomar a atualização.

1. Abra a métrica afetada.
2. Na mensagem de aviso, clique em Retomar a atualização.

O Tableau tenta realizar a atualização. Se essa tentativa for bem-sucedida, você receberá uma notificação e a atualização será retomada dentro do cronograma. Se a tentativa não for bem-sucedida, sua atualização permanece suspensa.

Tente substituir a métrica se a exibição conectada ainda estiver disponível. Para obter mais informações, consulte [Substituir uma métrica](#overwrite). Caso contrário, você pode manter a métrica para fazer referência aos dados antigos ou excluir a métrica.

**Observação:** se a atualização da métrica for suspensa porque você não tem a função de site necessária para que ela seja atualizada, não poderá retomar a atualização ou excluir a métrica.

## Métricas aparecem no Tableau Catalog

A partir do 2019.3, o Tableau Catalog está disponível com o Data Management no Tableau Cloud e no Tableau Server. Quando o Tableau Catalog é ativado em seu ambiente, você pode ver métricas na ferramenta de linhagem do Catalog, e métricas afetadas por avisos de qualidade de dados exibem esses avisos. Para obter mais informações sobre Tableau Catalog, consulte "Sobre o Tableau Catalog”, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm).

Quando você tem métricas definidas para os números que deseja monitorar, é importante saber se os dados em que as métricas se baseiam são afetados de alguma forma. Você pode usar o Catalog de algumas maneiras para saber isso. Primeiro, os avisos de qualidade de dados definidos nos dados em que sua métrica se baseia são mostrados na métrica. Esses avisos aparecem quando você abre uma métrica no Tableau Mobile e no Tableau Server e Tableau Cloud quando você paira sobre uma métrica na exibição da grade e na página de detalhes métricos, como mostrado abaixo:

![Métrica com aviso de qualidade de dados](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_metrics.png)

Para obter mais informações, consulte "Configurar um aviso de qualidade de dados" na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_dqw.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_dqw.htm).

Você também pode usar a ferramenta de linhagem no Tableau Catalog para ver as fontes upstream em que a sua métrica se baseia. Ao fazer uma análise de impacto, você pode ver quais métricas são afetadas se uma determinada coluna ou uma tabela é alterada ou obsoleta, ou se determinadas pastas de trabalho são removidas. Incluir métricas na linhagem significa que o Catalog dá uma visão completa das mudanças de impacto que podem ter sobre os ativos em seu ambiente.

![Impacto na linhagem quando filtrada por um campo](/tableau/current/pt-br/server/pt-br/Img/dm_lineage_filter.png)

Para obter mais informações, consulte "Usar linhagem para análise de impacto" na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_lineage.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_lineage.htm).

<!-- document id=ba3561dff3d57fd681aee70ade6acfbcb97161ab7f2889c941d661c4f04db866 url=/tableau/current/pt-br/server/ipa_vconn_create_data_policy.md -->

[Pular para o conteúdo principal](#main-content)

# Criar e testar políticas de dados

Use uma política de dados para filtrar dados em qualquer exibição, fonte de dados ou fluxo que usa a conexão virtual. Use uma coluna em uma tabela de políticas ou uma tabela de direitos para filtrar os dados apenas para o que o usuário deve ver.

- **Tabela de política** - as tabelas que são filtradas.
- **Coluna de política** - coluna usada para filtrar os dados.
- **Tabela de direitos** - uma tabela que inclui uma coluna que você pode usar para filtrar os dados. Use quando as tabelas de política não incluem uma coluna de política.

Adicionar tabelas à política

Para criar uma política de dados:

1. Clique ![botão Criar Nova Política](/tableau/current/pt-br/server/pt-br/Img/ipa_Create_New_Policy_btn.png)
2. Clique no nome padrão na guia para renomear a política.
3. Clique duas vezes no nome da tabela no painel esquerdo para adicionar tabelas à política de dados.

[Leia o tópico completo](https://help.tableau.com/current/server/pt-br/dm_vconn_create_conn.htm#select-tables-to-include-in-the-connection)

Mapear colunas da tabela

Para cada tabela de política, mapeie uma coluna na tabela de política para uma coluna de política ou uma tabela de direitos.

### Mapear para uma colunas de política

1. Clique em ![O botão Adicionar coluna ao mapa.](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_add_col_map_btn.png) para adicionar uma ou mais colunas a serem usadas para filtrar os dados.
2. Nomeie a coluna de política. Você usará esse nome na condição da política.
3. Para cada tabela de política, use o menu suspenso para selecionar a coluna da tabela que mapeia para a coluna da política.
4. Repita esse processo para quantas colunas de política você deseja usar na condição de política.

**Clipe rápido:** mapeie uma coluna da tabela para uma coluna de política e escreva uma condição de política para uma política de dados que filtra faturas por vendedor.

Your browser does not support the video tag.

[Leia o tópico completo](https://help.tableau.com/current/server/pt-br/dm_vconn_create_rlspolicy.htm#filter-with-a-policy-column-from-a-policy-table)

### Mapear para uma tabela de direitos

1. Selecione a tabela de direitos, arraste-a para a direita e solte-a em Adicionar como tabela de direitos. Você pode usar uma tabela de qualquer conexão ou banco de dados como uma tabela central de direitos que protege tabelas em muitos outros bancos de dados.
2. Para cada tabela de políticas, clique no menu suspenso e selecione as colunas para mapear a tabela de políticas para a tabela de direitos.

**Clipe rápido:** mapeie uma tabela de direitos (com colunas ID do funcionário e Nome completo) para colunas da tabela de política e escreva uma condição de política para a política de dados.

Your browser does not support the video tag.

[Leia o tópico completo](https://help.tableau.com/current/server/pt-br/dm_vconn_create_rlspolicy.htm#filter-with-policy-column-from-an-entitlement-table)

Escrever uma condição de política

Uma condição de política é um cálculo que geralmente usa uma função de usuário para definir o acesso em nível de linha. Mais sobre as [Funções do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm) na ajuda online.

Uma condição de política:

- É obrigatório em uma política de dados.
- Deve ser avaliada como verdadeira ou falsa.
- Mostra as linhas quando a condição da política é verdadeira.

Exemplo:

`FULLNAME() = [EmployeeName]`

[Leia o tópico completo](https://help.tableau.com/current/server/pt-br/dm_vconn_create_rlspolicy.htm#write-a-policy-condition)

Teste sua política de dados usando Visualizar como usuário

Teste sua política para ver os dados como o usuário os vê e verifique se ela está funcionando conforme o esperado.

1. Selecione a tabelas.
2. Na seção Detalhes da tabela, selecione ![Uma caixa de seleção rotulada como "Com política aplicada".](/tableau/current/pt-br/server/pt-br/Img/ipa_vconns_with_policy_applied.png)
3. Clique em Visualizar como usuário, selecione um Grupo (opcional) e um Usuário.
4. Verifique se a política mostra os dados corretos para esse usuário nos detalhes da tabela.
5. Repita para outros usuários conforme necessário.

[Leia o tópico completo](https://help.tableau.com/current/server/pt-br/dm_vconn_test_preview.htm)

Publique a conexão e defina as permissões

### Salvar um rascunho ou publicar uma conexão

Sua conexão é salva automaticamente como um rascunho enquanto você trabalha. Salve manualmente o rascunho clicando em ![Salvar ícone](/tableau/current/pt-br/server/pt-br/Img/ipa_Save_16px_medium.png).

Para compartilhar uma nova conexão virtual com outros usuários, você precisa publicá-la.

1. Clique em ![Botão Publicar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_publish_btn.png) no canto superior direito do editor.
2. Digite um nome para a conexão no campo Nome.
3. Selecione um projeto para salvar a conexão.
4. Clique ![Botão Publicar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_publish_btn.png)

Quando você edita uma conexão existente, ela permanece disponível para os usuários em seu estado publicado atual.

- Para salvar as atualizações de um rascunho, clique em ![Salvar ícone](/tableau/current/pt-br/server/pt-br/Img/ipa_Save_16px_medium.png).
- Para disponibilizar a conexão atualizada para os usuários, clique no ![Botão Publicar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_publish_btn.png)

### Definir permissões para que outras pessoas possam usar a conexão

Você publicou a conexão e está pronto para permitir que outras pessoas a usem. Para fazer isso, defina o recurso Conectar como Permitido.

1. Navegue até a conexão virtual.
2. Abra o menu Ações (...) e clique em Permissões.
3. Selecione a caixa sob o ícone Conectar para que a conexão seja permitida para todos os usuários.
    
    ![Recurso de conexão na caixa de seleção em Regras de permissões](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_connect_capability.png)
4. Clique em Salvar.

[Leia o tópico de publicação e permissões](https://help.tableau.com/current/server/pt-br/dm_vconn_publish_save.htm)

## Tarefas relacionadas

[Sobre o Editor de conexão virtual](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_editor.htm)

[Adicionar tabelas à conexão](https://help.tableau.com/current/server/pt-br/ipa_vconn_add_tables.htm)

[Sobre políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_data_policy.htm)

Não encontrou o que você precisa?

Fique online para ver [toda a ajuda do Tableau](https://www.tableau.com/pt-br/support/help)

<!-- document id=47f0a58dc3f9b862188d82187a110f421ef8dec7105334b77020ae443cf4cc69 url=/tableau/current/pt-br/server/adminview_postgres.md -->

[Pular para o conteúdo principal](#main-content)

# Criar exibições administrativas personalizadas

Além das exibições administrativas predefinidas disponíveis na página Manutenção do Servidor, você pode usar o Tableau Desktop para consultar e criar suas próprias análises de atividade do servidor. Para fazer isso, é possível conectar-se e consultar as exibições no repositório do Tableau Server usando um dos dois usuários internos "tableau" ou "readonly".

Para se conectar ao repositório do Tableau Server, consulte [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm).

- Usuário **tableau** — O usuário tableau tem acesso às exibições especiais e a um subconjunto de tabelas no banco de dados do repositório. Estas exibições e tabelas são fornecidas para que os administradores possam criar exibições administrativas personalizadas. O Tableau se esforça em limitar as alterações a essas tabelas e exibições, assim, as exibições personalizadas criadas com elas não param de funcionar.
- O usuário **readonly** — O usuário readonly tem acesso a um grande número de tabelas do repositório, fornecendo mais dados sobre o uso do servidor. Os administradores também podem usar isso para criar exibições administrativas personalizadas, mas muitas das tabelas são destinadas principalmente para oferecer suporte ao funcionamento do Tableau Server e podem ser alteradas ou removidas sem aviso prévio. Isto significa que as exibições criadas dessas tabelas podem não funcionar quando a estrutura do banco de dados é alterada.

Para exemplos de exibições administrativas personalizadas, consulte a [Comunidade do Tableau](https://help.tableau.com/current/server/pt-br/%3Chttps://community.tableau.com/s/global-search/%40uri#q=custom admin views&t=All&f:content-type-facet=[Community]>). Você também pode usar a pasta de trabalho temporária gerada ao visualizar as Exibições administrativas inseridas.

Antes que você possa conectar-se usando um dos usuários internos, é necessário habilitar o acesso ao banco de dados do Tableau Server. Após ter feito isso, você pode usar Tableau Desktop para conectar-se e consultar o banco de dados como o usuário do tableau ou o usuário readonly.

A opção [auditing.enabled](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#auditing) do `tsm configuration set` controla se o Tableau Server coleta o histórico de atividades do usuário e outras informações no repositório. Ela é habilitada por padrão. Um aspecto a ser observado é que a coleta de eventos de histórico afeta o tamanho do arquivo de backup do Tableau Server (.tsbak).

- Todas as tabelas `hist_` são controladas pela opção [wgserver.audit\_history\_expiration\_days](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver) do `tsm configuration set`, que controla quantos dias de histórico do evento são mantidos no repositório, e seu valor padrão é de 183 dias.
- A tabela `_http_requests` é apagada de todos os dados mais antigos que 7 dias ao executar o [tsm maintenance cleanup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cleanup) com a opção `--http-requests-table`. Para obter mais informações, consulte [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm).
- A tabela `_background_tasks` é apagada automaticamente e mantém os dados armazenados por 30 dias.
- Todas as outras tabelas cujos nomes começam com o prefixo "\_" contêm dados atuais.

Para obter mais informações sobre as tabelas no repositório do Tableau Server, consulte [Dicionário de dados do banco de dados do grupo de trabalho](https://tableau.github.io/tableau-data-dictionary/2023.1/data_dictionary.htm).

<!-- document id=40edd396d1c139030bd3e7c8ef2da322ffceb8baf8bb35a4285f1a16b991a043 url=/tableau/current/pt-br/server/ask_data.md -->

[Pular para o conteúdo principal](#main-content)

# Criar exibições automaticamente com o Pergunte aos dados (Ask Data)

**Mudanças importantes chegando para Pergunte aos dados e Métricas**

Os recursos Pergunte aos dados e Métricas do Tableau serão descontinuados no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau AI e o Tableau Pulse estão reinventando a experiência com dados.](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-gpt)

O Pergunte aos dados permite que você digite uma pergunta em uma linguagem comum e obtenha instantaneamente uma resposta certa no Tableau. As respostas são apresentadas na forma de visualizações de dados automáticas, sem a necessidade de arrastar e soltar campos manualmente ou de entender as nuances da sua estrutura de dados.

O Pergunte aos dados permite fazer perguntas sofisticadas naturalmente, com suporte a conceitos analíticos fundamentais como séries de tempo e análise espacial, além de um entendimento de sentenças coloquiais como "last year" e "most popular".  
  
![Crie uma visualização usando Pergunte aos dados](/tableau/current/pt-br/server/pt-br/Img/askdata_1.gif)  

## Navegando para as ampliações de Pergunte aos dados

Antes de consultar uma fonte de dados com Pergunte aos dados, [um autor do Tableau deve primeiro criar uma ampliação](https://help.tableau.com/current/pro/desktop/pt-br/ask_data_lenses.htm) que especifica o subconjunto de campos de dados que a ampliação usa.

No Tableau, aqui estão todos os lugares onde você pode acessar uma ampliação Pergunte aos dados:

- Na página Todas as ampliações no nível superior do seu site do Tableau Cloud ou Tableau Server.
    
    ![Ampliação de análise de campanhas publicitárias e envio para Pergunte aos dados.](/tableau/current/pt-br/server/pt-br/Img/ask_data_all_lenses.png)
- Na guia Pergunte aos dados de uma fonte de dados para as quais a ampliação foi criada.
    
    ![A página de fonte de dados da Superloja é exibida com três opções de ampliações conectadas destacadas.](/tableau/current/pt-br/server/pt-br/Img/ask_data_connected_lenses.png)
- Em um objeto Pergunte aos dados em um painel.
    
    ![Um painel com um mapa, um gráfico de dispersão e uma lista de classificação de clientes.](/tableau/current/pt-br/server/pt-br/Img/ask_data_in_dashboard.png)

## Solicitar dados de uma página de ampliação ou objeto de painel

### Navegue até uma lente e saiba mais sobre seus dados

1. Navegue até uma ampliação por meio da página Todas as ampliações do seu site do Tableau, a guia Perguntar aos dados para uma fonte de dados ou um objeto Perguntar aos dados em um painel.
2. (Opcional) Em Visualizações recomendadas, clique em uma entrada para ver rapidamente as visualizações que o autor da ampliação criou para sua organização.
    
    Se as recomendações não atenderem às suas necessidades atuais de análise de dados, [crie uma consulta](#Build) para criar sua própria pergunta.
3. No painel Dados à esquerda, passe rapidamente o mouse sobre cada campo para saber mais sobre os dados que ele contém.
    
    ![Visualize com a sequência de caracteres do país destacada no painel lateral e os detalhes do país exibidos, incluindo o número de valores exclusivos do país e uma lista de nomes de países.](/tableau/current/pt-br/server/pt-br/Img/ask_data_tooltip.png)
    
    Em um objeto de painel mais limitado, o painel Dados pode estar oculto, mas você pode ver as mesmas informações clicando no menu suspenso Campos.
    
    ![Um painel com o menu Campos destacado.](/tableau/current/pt-br/server/pt-br/Img/ask_data_dashboard_fields.png)

### Criar consultas inserindo texto

1. Digite na caixa que diz Campos ou valores de pesquisa para criar uma visualização.
    
    ![Campo de pesquisa para adicionar campos ou valores a uma visualização.](/tableau/current/pt-br/server/pt-br/Img/ask_data_ask_textbox.png)
2. Conforme você digita, Pergunte aos dados pesquisa campos de dados, funções e valores de cadeia de caracteres e exibe os resultados em uma lista suspensa. Clique nos itens da lista para adicioná-los à entrada atual, mostrada acima da caixa de pesquisa. Para criar automaticamente uma visualização usando a entrada atual, pressione Enter a qualquer momento.
    
    ![A interface do usuário de Pergunte aos dados para pesquisa, com o menu suspenso de preenchimento automático sendo exibido](/tableau/current/pt-br/server/pt-br/Img/ask_data_entity_search.png)
    
    Modificar uma consulta pesquisando campos e funções analíticas
    
    A. Entrada atual B. Filtros atuais C. Caixa de pesquisa D. Campos retornados E. Funções analíticas retornadas F. Valores dos campos retornados

### Criar consultas adicionando frases sugeridas

O Tableau sugerirá frases com base nas consultas mais comuns feitas em sua ampliação e por outras pessoas em sua organização. Ao abrir sua ampliação, você notará sugestões que o ajudarão a obter respostas rápidas para perguntas comuns.

Você pode adicionar essas sugestões à sua consulta clicando nelas. Conforme você adiciona frases à consulta, as sugestões são atualizadas dinamicamente com frases mais relevantes. A exibição é criada automaticamente com cada seleção.  
  
![Crie uma visualização usando Pergunte aos dados](/tableau/current/pt-br/server/pt-br/Img/askdata_2.gif)  

### Criar consultas adicionando campos e filtros

1. Clique em Adicionar campo ou Adicionar filtro.
    
    ![O Phrase Builder de Pergunte aos dados com as opções Adicionar campo e Adicionar filtro destacadas.](/tableau/current/pt-br/server/pt-br/Img/ask_data_click_phrasebuilder.png)
2. Clique no campo desejado. (Para restringir uma lista longa, primeiro digite na caixa Campos de pesquisa.)
    
    ![O Phrase Builder de Pergunte aos dados com a medida Vendas selecionada para visualização.](/tableau/current/pt-br/server/pt-br/Img/ask_data_click_phrasebuilder_2.png)
3. Defina quaisquer subopções (como tipo de agregação para um campo numérico ou agrupamento para campos de cadeia de caracteres e data).
4. Para adicionar mais campos ou filtros, clique no sinal de mais.
    
    ![O Phrase Builder de Pergunte aos dados com o ícone de adição destacado.](/tableau/current/pt-br/server/pt-br/Img/ask_data_click_phrasebuilder_3.png)

### Veja como os elementos da sua consulta são aplicados

Para ver como os elementos da sua consulta são aplicados, passe o mouse sobre eles na caixa de texto ou na interpretação acima dela. Palavras que não são usadas ficam acinzentadas, ajudando você a reformular sua consulta de uma forma mais clara para Pergunte aos dados.

![Mapeamento de Pergunte aos dados.](/tableau/current/pt-br/server/pt-br/Img/ask_data_mapping.gif)

## Reformule sua pergunta

Você pode reformular as perguntas clicando em opções, campos de dados e filtros na interface do usuário.

### Alterar o tipo de visualização

Se a visualização padrão não revelar completamente seus dados, clique no menu, no canto superior direito, e escolha entre estes tipos de visualizações compatíveis:

- Gráfico de barras
- Barras de Gantt
- Mapa de variações
- Histograma
- Gráfico de linhas
- Mapa
- Gráfico de pizza
- Dispersão
- Gráfico de barras empilhado
- Tabela de texto
- Mapa em árvore

![Uma visualização de um mapa dos Estados Unidos exibe o lucro médio por cidade, e um menu suspenso é destacado para mostrar as seguintes opções para alterar o tipo de visualização: mapa, gráfico de barras, tabela de texto, barras empilhadas, mapa de varição e mapa de árvore.](/tableau/current/pt-br/server/pt-br/Img/ask_data_viz_change.png)

**Observação:** para criar determinados tipos de visualização automaticamente, o Pergunte aos dados (Ask Data) certas vezes adiciona campos como "Número de registros" às suas entradas.

### Alterar campos, filtros e dados exibidos

O Pergunte aos dados (Ask Data) oferece diversas formas de ajustar como os valores de campo são exibidos.

- Para alternar os campos usados para os eixos vertical e horizontal, clique no botão Trocar eixos ![Botão Trocar eixos.](/tableau/current/pt-br/server/pt-br/Img/environ_swap.png) à esquerda do menu de seleção de visualização:
    
    ![O ícone de trocar eixos.](/tableau/current/pt-br/server/pt-br/Img/ask_data_swap_axes_context.png)
- Para alterar um campo, primeiro clique nele na entrada da consulta e, em seguida, clique no nome do campo abaixo. (Para alterar os campos usados em cálculos de diferenças, consulte [Comparar diferenças ao longo do tempo](#Compare).)
    
    ![A medida de emissões de CO2 é destacada.](/tableau/current/pt-br/server/pt-br/Img/ask_data_change_field.png)
- Para alterar a agregação ou o tipo de agrupamento de um campo (por exemplo, de média para soma), clique no nome do campo na caixa de texto e escolha uma agregação ou agrupamento diferente.
    
    ![Opções de seleção do método de agregação mostradas para soma, média ou mediana com média selecionada.](/tableau/current/pt-br/server/pt-br/Img/ask_data_aggtype_short.png)
- Para filtros categóricos, clique em valores (por exemplo, "excluir Estados Unidos" no exemplo abaixo) para alterar valores específicos ou inserir parâmetros curinga.
    
    ![O ajuste do filtro Pergunte aos dados é mostrado com um valor de país excluído.](/tableau/current/pt-br/server/pt-br/Img/ask_data_adjust_filter.png)
- Para justar um intervalo numérico, clique em palavras como "alto" ou "barato".
    
    ![O ajuste do filtro Pergunte aos dados é mostrado com as opções de ajuste do intervalo de lucro.](/tableau/current/pt-br/server/pt-br/Img/ask_data_adjust_range.png)
- Para excluir um campo ou filtro, passe o cursor sobre ele e clique no X.

### Ajustar filtros de data

Para ajustar um filtro de data, clique em palavras como "último" ou "anterior". Em seguida, clique em uma das seguintes opções:

- Datas específicaspara inserir um período específico ou valor de data
- Datas relativas para mostrar um intervalo de datas em relação aos dias atuais
- Intervalo de datas para inserir pontos específicos de início e fim

Datas específicas oferecem algumas opções exclusivas no menu Detalhe de data:

- As opções de Período mostram um único intervalo de data contínua
- As opções de Valor de data mostram intervalos que podem se repetir em vários períodos. (Por exemplo, para ver o desempenho de vendas combinadas para o primeiro trimestre ao longo de vários anos, em Valor de data, escolha Trimestres.)

![Uma caixa de diálogo de filtro de data para datas específicas. ](/tableau/current/pt-br/server/pt-br/Img/ask_data_specific_date.png)

## Comparar diferenças ao longo do tempo

O Pergunte aos dados permite comparar períodos com frases como "ano a ano" ou "trimestre a trimestre". Os resultados são exibidos como cálculos de tabela de diferença ou diferença percentual nas pastas de trabalho que você salva no Pergunte aos dados.

![Gráfico de linhas mostrando a diferença anual na soma das vendas em relação à data do pedido, com a diferença anual destacada.](/tableau/current/pt-br/server/pt-br/Img/ask_data_yoy.png)

Na caixa de texto, clique em um cálculo de diferença para escolher outros campos, métodos de agregação e períodos.

![Uma caixa de diálogo mostra opções para calcular a diferença nas vendas médias em relação à data do pedido ou à data de envio.](/tableau/current/pt-br/server/pt-br/Img/ask_data_yoy_revise.png)

## Aplicar cálculos simples

O Pergunte aos dados (Ask Data) é compatível com cálculos simples entre duas medidas, que podem ser aplicados usando estes símbolos:

+ soma as medidas

\- calcula a diferença entre elas

\* multiplica

/ divide

Nas pastas de trabalho salvas do Pergunte aos dados (Ask Data), esses cálculos não se tornam campos calculados, e sim cálculos ad hoc nas divisórias Colunas, Linhas ou Marcas.

![Uma visualização com a opção de cálculos de Pergunte ao dados destacada mostrando uma equação onde a soma do lucro é dividida pela soma das vendas.](/tableau/current/pt-br/server/pt-br/Img/ask_data_calculations.png)

## Adicionar planilhas com outras visualizações

Para criar rapidamente várias visualizações diferentes de uma ampliação, adicione planilhas em Pergunte aos dados.

Na parte inferior da página da Web, faça um dos seguintes procedimentos:

- Clique no ícone Adicionar planilha à direita das planilhas nomeadas.
    
    ![Guias de planilhas rotuladas como Planilha 1 e Planilha 2, com um botão para adicionar uma nova planilha.](/tableau/current/pt-br/server/pt-br/Img/ask_data_sheets.png)
- Clique com o botão direito do mouse em um nome de planilha e escolha Duplicar ou Excluir.
    
    (Para renomear as planilhas do Pergunte aos dados (Ask Data), salve-as em uma nova pasta de trabalho.)

## Compartilhe as visualizações de Pergunte aos dados por e-mail, Slack ou um link

Você pode compartilhar visualizações de Pergunte aos dados com qualquer pessoa que tenha acesso a uma ampliação.

1. No canto superior direito do navegador, clique no ícone Compartilhar.
    
    ![Ícone Compartilhar](/tableau/current/pt-br/server/pt-br/Img/ask_data_link.png)
2. Faça um dos seguintes procedimentos:

- Para compartilhar a visualização por e-mail ou Slack, insira nomes de usuário específicos na caixa de texto. (A integração de e-mail e Slack deve ser configurada previamente pelo administrador do Tableau.)
- Para copiar uma URL que você pode colar em e-mails personalizados e outras mensagens, clique em Copiar link.

## Envie feedback para o proprietário da ampliação

Se você tiver dúvidas sobre a estrutura de uma ampliação ou sobre a melhor forma de usá-la com Pergunte aos dados, pode enviar feedback diretamente para o autor. (Esta opção é ativada por padrão, mas os autores da ampliação podem desativá-la.)

1. À esquerda da caixa de consulta para Pergunte aos dados, clique no ícone Dicas de Pergunte aos dados.
    
    ![Passe o mouse sobre o ícone de informações que mostra a dica de ferramenta das dicas de Pergunte aos dados.](/tableau/current/pt-br/server/pt-br/Img/ask_data_tips_button.png)
2. Na parte inferior da caixa de diálogo de dicas, clique em Entrar em contato com o autor da ampliação.

## Dicas para consultas bem-sucedidas

À medida que você estrutura perguntas para o Pergunte aos dados, aplique essas dicas para obter melhores resultados.

- **Use plavras-chave** — Por exemplo, em vez de "Quero ver todos os países nos quais estes aeroportos estão", tente "por aeroporto e país".
- **Use as palavras exatas para nomes e valores de campo** — Por exemplo, se sua fonte de dados incluir os campo Código do aeroporto, Nome do aeroporto, Região do aeroporto, especifique-os pelo nome.
- **Veja uma lista classificada** — Termos de mapas do Pergunte aos dados (Ask Data), como "melhor" e "pior" para 1 principal e 1 inferior, respectivamente. Se quiser ver classificações mais amplas, use "alto" e "baixo" em vez disso. Por exemplo, insira "casas com baixo preço".
- **Cálculos de tabela de consulta** - Em expressões de consulta para campos de cálculo de tabela, observe que você não pode filtrar, limitar ou incluir "diferença ano após ano".
- **Coloque valores incomumente longos entre aspas** — Se quiser analisar valores de campo longos que contenham retornos de linha, guias ou mais de dez palavras, coloque-os entre aspas. Para melhorar o desempenho, Pergunte aos dados não indexa campos desse comprimento, ou algo além dos primeiros 200.000 valores de campo exclusivos.

## Outros artigos nesta seção

<!-- document id=78c39d914c895f17291d53f8d58d53ee6866a0ff21b5923b6ba25729021b9acc url=/tableau/current/pt-br/server/web_author.md -->

[Pular para o conteúdo principal](#main-content)

# Criar exibições e explorar dados na Web

Crie e interaja com exibições na Tableau Server. Para obter mais informações, consulte os tópicos a seguir na Ajuda do Tableau para usuários.

[Usar o Tableau na Web](https://help.tableau.com/current/pro/desktop/pt-br/web_author_home.htm)

[Fazer um tour no site do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/navigating.htm)

[Editar exibições na Web](https://help.tableau.com/current/pro/desktop/pt-br/web_author_build_view.htm)

[Unir colunas de dados](https://help.tableau.com/current/pro/desktop/pt-br/joining_tables.htm)

[Criar um painel](https://help.tableau.com/current/pro/desktop/pt-br/dashboards_create.htm)

[Criar uma história](https://help.tableau.com/current/pro/desktop/pt-br/story_create.htm)

[Inserir exibições e painéis em páginas da Web](https://help.tableau.com/current/pro/desktop/pt-br/embed_landing.htm)

[Tornar as pastas de trabalho compatíveis entre as versões](https://help.tableau.com/current/pro/desktop/pt-br/publish_version_compatibility.htm)

## Alertas e inscrições

[Solucionar problemas de assinaturas](https://help.tableau.com/current/server/pt-br/subscribe_trouble.htm)

[Enviar alertas acionados por dados no Tableau Cloud ou no Tableau Server](https://help.tableau.com/current/pro/desktop/pt-br/data_alerts.htm)

## Outros artigos nesta seção

<!-- document id=e1d23b5749c1361c112ce35145badba2da7fc71415f70ea06e223c5ba96134cf url=/tableau/current/pt-br/server/datasource_extract.md -->

[Pular para o conteúdo principal](#main-content)

# Criar extrações na Web

Você pode extrair suas fontes de dados na Web (sem usar o Tableau Desktop) para melhorar o desempenho da fonte de dados e aceitar funções analíticas adicionais. Quando você extrair sua fonte de dados, o Tableau copiará os dados do seu armazenamento remoto de dados para o Tableau Server ou Tableau Cloud. Para saber mais sobre os benefícios de extrair seus dados, consulte [Extrair seus dados](https://help.tableau.com/current/pro/desktop/pt-br/extracting_data.htm). Na Web, você pode extrair enquanto estiver na Criação da Web ou enquanto estiver no Servidor de conteúdo.

## Criar extrações na criação na Web

Agora é possível criar extrações diretamente na criação na Web, com configurações de extração padrão.

### Extrair uma fonte de dados incorporada na criação na Web

![Página da fonte de dados mostrando o tipo de conexão de extração](/tableau/current/pt-br/server/pt-br/Img/datasource_extract1w_border.png)

Conclua as etapas a seguir para criar uma extração na criação na Web.

> [!TIP]
> 
> **Dica**: recomenda-se finalizar seu modelo de dados antes de criar a extração. A criação da extração pode levar muito tempo, e a extração é invalidada por qualquer alteração no seu modelo de dados, como a adição de novas tabelas lógicas.

1. Selecione a guia Fonte de dados no canto inferior esquerdo do painel de criação na Web. Para novas pastas de trabalho, você começará na guia Fonte de dados.
2. No canto superior direito, altere o tipo de conexão de Em tempo real para Extração.
3. Selecione Criar extração. Você verá a caixa de diálogo Criar extração.

A criação da extração pode levar muito tempo, e você pode fechar a sessão durante a criação. Para garantir que a criação da sua extração não seja perdida, na caixa de diálogo, escolha Notificar-me quando estiver concluído para especificar um local para que a pasta de trabalho extraída seja salva. Se o extração for bem-sucedido, sua pasta de trabalho será salva no local especificado e você receberá uma notificação de que poderá continuar a sessão de criação na Web.

Se sua criação de extração falhar, você receberá uma notificação de que não foi possível criar a extração e poderá restaurar suas alterações não salvas, reabrindo a pasta de trabalho original na criação na Web.

### Defina suas configurações de extração

Você pode configurar uma ou mais das opções a seguir para informar o Tableau como armazenar, definir os filtros e limitar a quantidade de dados na extração.

![Página de extração de dados mostrando a seleção de tabelas lógicas ou físicas](/tableau/current/pt-br/server/pt-br/Img/incremental_refresh_extract_data.png)

**Decidir como os dados de extração devem ser armazenados**

Você pode escolher que o Tableau armazene os dados em sua extração usando uma de duas estruturas (esquemas): tabelas lógicas (esquema desnormalizado) ou várias físicas (esquema normalizado). Para obter mais informações sobre tabelas lógicas e físicas, consulte [O modelo de dados do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel.htm). A opção escolhida depende do que você precisa.

Tabelas lógicas

Tabelas lógicas armazenam dados usando uma tabela de extração para cada tabela lógica na fonte de dados. Tabelas físicas que definem uma tabela lógica são mescladas e armazenadas com essa tabela lógica. Por exemplo, se uma fonte de dados fosse composta por uma única tabela lógica, os dados seriam armazenados em uma tabela única.

Se uma fonte de dados fosse composta por três tabelas lógicas (cada uma com várias tabelas físicas), os dados da extração seriam armazenados em três tabelas - uma para cada tabela lógica.

Selecione Tabelas lógicas que desejar limitar o volume de dados na extração com propriedades de extração adicionais, como filtros de extração, agregação, N principal ou outros recursos que requerem dados desnormalizados. Use também quando os dados utilizarem as funções de passagem (RAWSQL). Essa é a estrutura padrão usada pelo Tableau para armazenar dados de extração.

Se usar essa opção quando sua extração contiver uniões de colunas, as uniões serão aplicadas quando a extração for criada.  

Tabelas físicas

Tabelas físicas armazenam dados usando uma tabela de extração para cada tabela física na fonte de dados.

Selecione Tabelas físicas se a extração é composta por tabelas combinadas com uma ou mais uniões de igualdade e atende às condições de uso da opção Tabelas físicas listadas abaixo. Se usar essa opção, as uniões de colunas serão executadas no momento da consulta.

Essa opção pode aprimorar consideravelmente o desempenho e ajudar a reduzir o tamanho do arquivo de extração. Para obter mais informações sobre como o Tableau recomenda o uso da opção Tabelas físicas, consulte [Dicas de uso da opção Tabelas físicas](https://help.tableau.com/current/pro/desktop/pt-br/extracting_data.htm#noramlized_tips) na ajuda do Tableau Desktop.

Em alguns casos, é possível usar essa opção como uma solução alternativa para segurança a nível de linha. Para obter mais informações sobre a segurança de nível de linha usando o Tableau, consulte [Restringir acesso no nível de linha dos dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters.htm) na ajuda do Tableau Desktop.  

### Condições de uso da opção Tabelas físicas

Para armazenar a extração usando a opção Tabelas físicas, os dados na extração devem atender a todas as condições listadas abaixo.

- Todas as uniões de colunas entre tabelas físicas são uniões de igualdade (=).
- Os tipos de dados das colunas usadas para relações uniões de colunas são idênticos.
- Nenhuma função de passagem (RAWSQL) usada.
- Nenhuma atualização incremental configurada.
- Nenhum filtro de extração configurado.
- Nenhum N principal ou amostragem configurados.
- Quando a extração é armazenada como tabelas físicas, não é possível anexar dados a ela.
- Em tabelas lógicas, não é possível anexar dados a extrações com mais de uma tabela lógica.

**Observação:** as opções Tabelas lógicas e Tabelas físicas afetam somente a maneira como os dados na extração são armazenados. As opções não afetam como as tabelas na extração são exibidas na página Fonte de dados.

**Determinar a quantidade de dados para a extração** 

Selecione Adicionar para definir um ou mais filtros a fim de limitar a quantidade de dados a serem extraídos com base em campos e em seus valores.

**Agregar os dados na extração** 

Selecione Agregar dados para dimensões visíveis para agregar as medidas utilizando a opção padrão. A agregação dos dados consolida as linhas, pode minimizar o tamanho do arquivo de extração e aumentar o desempenho.

Ao optar por agregar os dados, também é possível selecionar Agregar datas para um nível de data especificado, como Ano, Mês etc. Os exemplos seguintes mostram como os dados serão extraídos para cada opção de agregação disponível.

<table class="TableStyle-Basic-Border" style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><span class="uicontrol">Dados originais</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><img src="https://help.tableau.com/current/server/pt-br/Img/aggregate1.png" style="text-align: center;" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-family: Merriweather;">Cada registro é mostrado como uma linha separada. Há sete linhas em seus dados.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><span class="uicontrol">Agregar dados para dimensões visíveis</span><p><i>(sem acumular)</i></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><img src="https://help.tableau.com/current/server/pt-br/Img/aggregate2.png" style="text-align: center;" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-family: Merriweather;">Registros com a mesma data e região foram agregados em uma única linha. Há cinco linhas na extração.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="font-family: Merriweather;"><span class="uicontrol">Agregar dados para dimensões visíveis<br></span><i>(acumular datas até Mês)</i></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="font-family: Merriweather;"><img src="https://help.tableau.com/current/server/pt-br/Img/aggregate3.png" style="text-align: center;" alt=""></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="font-family: Merriweather;">As datas foram acumuladas até o nível de Mês e os registros com a mesma região foram agregados em uma única linha. Há três linhas na extração.</td></tr></tbody></table>

Escolher quais colunas extrair

Selecione o número de linhas que deseja extrair.

Você pode extrair todas as linhas ou as linhas N superiores. Primeiro, o Tableau aplica os filtros e a agregação e, em seguida, extrai o número de linhas dos resultados filtrados e agregados. O número de opções de linhas depende do tipo de fonte de dados da qual você está extraindo.

**Observações:**

- Nem todas as fontes de dados oferecem suporte à amostragem. Portanto, a opção Amostragem pode não estar disponível na caixa de diálogo Extrair dados.
- Qualquer campo ocultado em primeiro lugar na página Fonte de dados ou na guia da planilha será excluído da extração.

Definir as Configurações de atualização incremental

A maioria das fontes de dados oferecem suporte à atualização incremental. Em vez de atualizar toda a extração, você pode configurá-la para adicionar apenas as linhas que são novas desde a última vez em que extraiu os dados.

Por exemplo, talvez haja uma fonte de dados que seja atualizada diariamente com as novas transações de vendas. Em vez de recriar toda a extração a cada dia, você pode apenas adicionar as novas transações que ocorreram no dia. Para ter atualização incremental como opção ao agendar uma atualização, você deve primeiro definir as configurações.

Periodicamente, você pode querer fazer uma atualização completa para garantir que tenha os dados mais atualizados.

**Observação:** se a estrutura de dados das alterações de dados de origem (por exemplo, uma nova coluna for adicionada), você precisará fazer uma atualização completa da extração antes de poder começar a fazer atualizações incrementais novamente.

### Configurar atualização incremental

Siga as etapas abaixo para configurar a atualização incremental de uma extração. Certifique-se de ter selecionado Todas as linhas na seção Número de linhas.

As atualizações incrementais somente pode ser definida quando você está extraindo em todas as linhas no banco de dados. Não é possível atualizar de forma incremental uma amostra de extração.

1. Expanda a seção Atualização incremental.
2. Marque a caixa **Atualização incremental**.
3. Escolha uma tabela para atualizar.
4. Selecione uma coluna a ser usada para identificar novas linhas.
5. (Opcional) Insira uma quantidade de tempo e uma unidade de tempo nos campos Intervalo mínimo de datas para atualização para extrair novos dados adicionados desde a última atualização e também substituir um subintervalo de dados existentes na extração para capturar alterações que podem ter ocorrido na fonte de dados. Você tem a opção de definir o período de várias maneiras, de segundos a anos, neste campo. Por exemplo, você pode inserir “2” e “meses” para que a atualização da extração obtenha todas as novas linhas, além de atualizar os dados dos dois meses anteriores.

**Observação**: configurar atualizações de extração junto com uma data mínima para atualização pode ser complexo de entender. Antes de usar, consulte [Configurar uma atualização de extração incremental](https://help.tableau.com/current/pro/desktop/pt-br/extracting_refresh.htm#configure-an-incremental-extract-refresh).

![](/tableau/current/pt-br/server/pt-br/Img/subrange_incremental_refresh.png)

### Usar configurações avançada

Você pode expandir as **Configurações avançadas** para estabelecer como novas linhas são recuperadas.

**Observação:** se você definiu um intervalo mínimo de datas para atualização, o recurso Configurações avançadas não estará acessível.

Configurações avançadas permitem substituir as últimas linhas adicionadas atualizando valores iguais ou maiores que o último valor registrado ou reter as últimas linhas adicionadas apenas atualizando a extração com valores maiores que o último valor registrado.

Na primeira abordagem, o Tableau permite que os usuários atualizem extrações de forma incremental com uma coluna-chave não exclusiva, como data, data e hora ou ID.

Este método adiciona uma nova etapa ao executar uma atualização incremental. O Tableau primeiro excluirá as linhas da extração que sejam iguais ao valor mais alto visto anteriormente. O Tableau então consulta todas as linhas maiores ou iguais ao valor mais alto anterior, que coletará todas as linhas excluídas e quaisquer novas.

Por outro lado, você ainda pode optar por não substituir as últimas linhas adicionadas e adicionar apenas linhas com valores maiores que o último valor registrado.

Para finalizar, selecione **Criar extração**.

#### Considerações ao atualizar extrações

**Edição de uma extração:**

Se você estiver editando uma extração existente, a última atualização será mostrada para que seja possível assegurar que a extração com os dados corretos está sendo atualizada.

**Atualização completa:**

A atualização completa substitui todas as linhas pelos dados da fonte de dados original sempre que você atualiza a extração. Uma atualização completa pode demorar mais e ser cara no banco de dados.

**Precisão de data/hora e extrações:**

O processador de dados, que é o mecanismo subjacente usado pelo Tableau para criar extrações, armazena os valores de tempo com a precisão de até 3 casas decimais.

Se você especificar uma coluna de data e hora ou de carimbo de data e hora para Identificar novas linhas usando coluna e o seu banco de dados usar uma precisão maior que a do Tableau, pode ser que você receba linhas duplicadas após uma atualização em incrementos.

Por exemplo, se o banco de dados tem duas linhas, sendo uma com o valor de data e hora de 2015-03-13 17:30:56.502352 e outra com 2015-03-13 17:30:56.502852, o Tableau armazenará ambas as linhas usando um valor de data e hora de 2015-03-13 17:30:56.502 criando, assim, linhas duplicadas.

### Limitações

- Não é possível criar extrações para fontes de dados inseridas que fazem referência a fontes de dados publicadas. Como solução alternativa, crie a extração diretamente na fonte de dados publicada. Para obter mais informações, consulte Extrair uma fonte de dados publicada no servidor de conteúdo.
- Você não pode criar extrações para fontes de dados baseadas em arquivos. As fontes de dados baseadas em arquivos já possuem recursos especiais de desempenho e a adição de extração não oferece benefícios de desempenho.
- Esse recurso não se aplica a fontes de dados baseadas no Bridge no Tableau Cloud.
- Limitação de SQL personalizado: consultas SQL personalizadas não são compatíveis com configurações avançadas. Os usuários que dependem de SQL personalizado precisarão ajustar sua abordagem se desejarem usar as configurações avançadas para atualização incremental.

## Criar extrações no servidor de conteúdo

### Extrair uma fonte de dados publicada no servidor de conteúdo

![Página de fontes de dados mostrando a opção de extração no menu](/tableau/current/pt-br/server/pt-br/Img/datasource_extract2_wborder.png)

Conclua as etapas a seguir para extrair uma fonte de dados publicada.

1. Faça login como administrador ou como proprietário da fonte de dados.
2. Na guia Conteúdo, selecione Explorar e, em seguida, Fonte de dados.
3. Selecione uma fonte de dados clicando no nome da Fonte de dados.
4. Na parte superior da tela, o nome da Fonte de dados, selecione o menu suspenso que diz **Em tempo real**.
5. Altere o tipo de conexão de **Em tempo real** para **Extração**. Se a criptografia de extração no recurso em repouso estiver ativada no site, selecione **Criptografado** ou **Não criptografado**.
6. Se você vir uma mensagem de erro sobre credenciais inseridas, insira as credenciais na fonte de dados. Para fazer isso, escolha **Editar conexão**. Selecione “Senha inserida em conexão” e depois escolha **Salvar**.

### Extrair uma fonte de dados inserida no servidor de conteúdo

![A opção de extração no menu de ações da página de fontes de dados](/tableau/current/pt-br/server/pt-br/Img/datasource_extract3w_border.png)

Conclua as etapas a seguir para extrair uma ou mais fontes de dados que estão inseridas em uma pasta de trabalho publicada.

1. Faça login como administrador ou como proprietário da fonte de dados.
2. Navegue até a pasta de trabalho publicada.
3. Navegue até a guia Fontes de dados
4. Selecione uma ou mais fontes de dados.
5. Escolha o botão **Ação**.
6. Selecione **Extração**. Se a criptografia de extração no recurso em repouso estiver ativada no site, selecione **Criptografado** ou **Não criptografado**.

### Limitações

- As credenciais de conexão devem ser inseridas na fonte de dados.
- Não é possível criar extrações para fontes de dados inseridas que fazem referência a fontes de dados publicadas. Como solução alternativa, [crie a extração diretamente na fonte de dados publicada](#extract-published-data-source).
- Você não pode criar extrações para fontes de dados baseadas em arquivos. As fontes de dados baseadas em arquivos já possuem recursos especiais de desempenho e a adição de extração não oferece benefícios de desempenho.
- A partir da versão 2023.1, alterar uma conexão ativa para um extrato no Servidor de conteúdo removerá todos os filtros de extrato que foram criados anteriormente no Tableau Desktop ou Criação na Web.
- Esse recurso não se aplica a fontes de dados baseadas no Bridge no Tableau Cloud.

## Manter dados de extraídos atualizados

Depois que os dados são extraídos, você pode configurar opcionalmente uma agenda de atualização de extração para mantê-los atualizados. Para obter mais informações, consulte [Atualizar dados em uma agenda](https://help.tableau.com/current/server/pt-br/schedule_add.htm).

## Monitorar e gerenciar extrações

Os administradores de servidor podem monitorar a criação na exibição de administrador **Tarefas em segundo plano para extrações.** Para obter mais informações, consulte [Tarefas em segundo plano para extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd.htm).

Os administradores de servidores podem gerenciar extrações na página Trabalhos. Para obter mais informações, consulte [Gerenciar trabalhos do Processador em segundo plano no Tableau Server](https://help.tableau.com/current/server/pt-br/server_backgrounder_job_management.htm).

Os trabalhos de criação de extração, como trabalhos de atualização de extração, tem um limite máximo de consulta antes do tempo limite. Isso é para evitar que os trabalhos sejam executados para sempre e usem uma quantidade ilimitada de recursos do servidor. O tempo limite de consulta à extração pode ser configurado por administradores de servidor usando a configuração da interface da linha de comando TSM `backgrounder.querylimit`Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

Os administradores de servidores podem gerenciar a criação na Web. Para obter mais informações, consulte [Definir acesso de criação na Web ou funções de um site](https://help.tableau.com/current/server/pt-br/web_author_enable.htm).

<!-- document id=d3783f4f50b3b5a727e73ef2f0c1fc96b0fffd7eb6632db0deda74a59fdda1e3 url=/tableau/current/pt-br/server/groups_create_ad.md -->

[Pular para o conteúdo principal](#main-content)

# Criar grupos pelo Active Directory

Você pode importar grupos do Active Directory para criar grupos correspondentes no Tableau Server e um usuário para cada membro de um grupo do AD que ainda não exista no servidor.

**Observação:** no contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas.

Cada usuário recebe uma função no site como parte do processo de importação. Se um dos usuários importados existir no Tableau Server, a função de site atribuída durante o processo de importação é aplicada somente se ela der ao usuário mais acesso ao servidor. Importar usuários não diminui as funções do site.

## Antes de começar

Antes de importar os grupos, revise [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm) para compreender como o formato do nome de usuário de vários domínios, NetBIOS e Active Directory influenciam o gerenciamento de usuário do Tableau.

## Importar do AD para adicionar um grupo

Como parte da adição de um grupo de usuários ao Tableau Server, você importa um grupo do Active Directory (AD). Ao importar um grupo, você primeiro insere o nome do grupo para procurá-lo.

A inserção de um nome de grupo, por padrão, faz com que o Tableau Server execute uma consulta curinga (por exemplo, \*marketing\*) no AD (ou LDAP) para maximizar os resultados da pesquisa. Se você estiver trabalhando em um grande armazenamento de identidades AD (ou LDAP), poderá ocorrer um tempo limite antes de poder selecionar com êxito o grupo a ser importado.

Para ajudar a economizar tempo e evitar possíveis problemas de tempo limite durante o processo de importação, considere pesquisar um nome de grupo usando um dos seguintes métodos:

- **Correspondência exata:** o método mais eficiente para pesquisar um nome de grupo, insira o nome exato do grupo incluindo aspas ("") antes e depois da cadeia de caracteres inserida. Por exemplo, **"marketing"**.
- **Correspondência parcial:** digite uma parte do nome do grupo e inclua um asterisco (\*) precedendo e seguindo a cadeia de caracteres digitada. Por exemplo, **\*ket\***.
- **Começa com:** Insira a parte inicial do nome do grupo seguida por um asterisco (\*). Por exemplo, **mercado\***.
- **Termina com:** Insira um asterisco (\*) seguido pela parte final do nome do grupo. Por exemplo, **\*ing**.

**Observação:** esses métodos também se aplicam à forma como o Tableau Server pesquisa usuários.

1. Em um site, clique em Grupos e, em seguida, clique em Adicionar grupos.
2. Digite o nome do grupo do Active Directory que você deseja importar e selecione o nome do grupo na lista resultante. Use um dos métodos de filtragem acima para melhorar o desempenho.
    
    Se você estiver importando um grupo do mesmo domínio do AD em que o servidor está sendo executado, poderá digitar o nome do grupo do AD sem o domínio. O domínio do servidor será adotado.
    
    ![Caixa de diálogo para importar um grupo do Active Directory.](/tableau/current/pt-br/server/pt-br/Img/import_AD_group1.png)
3. Selecione a função de site mínima para os usuários.
    
    ![Caixa de diálogo para importar um grupo do Active Directory com o menu suspenso Função do site expandido e o Explorer (Administrador de site) selecionado.](/tableau/current/pt-br/server/pt-br/Img/import_AD_group2.png)
4. (Opcional) selecione Conceder função ao entrar para fornecer novas funções e licenças do site quando os usuários do grupo entrarem. Para obter mais informações, consulte [Atribuição de licença no logon](https://help.tableau.com/current/server/pt-br/grant_role.htm).
5. Clique no botão Importar.

**Observação:** Não é possível alterar o nome dos grupos importados do Active Directory. O nome do grupo só pode ser alterado no Active Directory.

<!-- document id=699bc70308c8d8cc4504dc217d602c92d79aa7e378146fae0fe81af1d034e361 url=/tableau/current/pt-br/server/schedule_manage_create.md -->

[Pular para o conteúdo principal](#main-content)

# Criar ou modificar uma agenda

A página Agendas é acessível apenas pelos administradores do Tableau Server. Ela apresenta uma lista de agendas que inclui o nome, o tipo, a que se destinam (escopo), o número de tarefas, o comportamento (processamento serial ou simultâneo) e quando elas estão agendadas para execução.

**Observação**: se as agendas personalizadas para assinaturas forem habilitadas em um ou mais sites, os usuários controlarão as agenda de suas assinaturas nesses sites. Para saber mais, consulte [Habilitar agendas personalizadas para assinaturas](https://help.tableau.com/current/server/pt-br/schedule_enable_custom.htm).

## Para criar uma nova agenda

1. Em um site, clique em Agendas.
2. Clique em **Nova agenda**.

![Uma caixa de diálogo de criação de cronograma com status do site, análise e configurações. Uma lista de opções de status do site inclui painel de controle, estatísticas de conteúdo não utilizado e uso de licença baseado em login.](/tableau/current/pt-br/server/pt-br/Img/new-schedule-create.png)

4. Especifique um Nome descritivo para a agenda.
5. Selecione um **Tipo de tarefa** com a qual a agenda lidará: atualizações de extrações, execuções de fluxos ou entregas de inscrições.
6. Você deve definir uma prioridade de 1 a 100, onde 1 é a prioridade mais alta. Essa é a prioridade que será atribuída às tarefas por padrão. Se duas tarefas estiverem pendentes na fila, o processador em segundo plano avaliará a prioridade da tarefa em relação às atualizações de extração e fluxos, e a prioridade da agenda em relação às assinaturas para determinar qual será executada primeiro. Para obter mais informações, consulte [Como os Trabalhos do servidor agendados são priorizados](https://help.tableau.com/current/server/pt-br/task_prioritization.htm).
7. Execução: escolha se uma agenda será executada em paralelo ou em série. Agendas que são executadas em paralelo são executadas em todos os processos do processador em segundo plano para que sejam concluídas com mais rapidez.
    
    **Observação:** as agendas para a mesma pasta de trabalho sempre serão executadas em série, mesmo que você defina essa opção em paralelo.
8. Conclua a definição da agenda. É possível definir uma agenda por hora, dia, semana ou mês. A **frequência** é preenchida automaticamente com base nas seleções efetuadas.
    
    ![Um menu de navegação com status do site, análise e configurações. Uma lista de opções de status do site inclui painel de controle, estatísticas de conteúdo não utilizado e uso de licença baseado em login.](/tableau/current/pt-br/server/pt-br/Img/new-schedule-monthly.png)
9. Clique em Criar.

## Para modificar uma agenda existente

1. Navegue até a página Agendas.
2. Selecione uma agenda existente, clique na seta suspensa Ações e, em seguida, selecione **Editar configurações**.
    
    ![Uma lista de atualizações de extração agendadas com opções para editar configurações, executar agora, renomear ou excluir.](/tableau/current/pt-br/server/pt-br/Img/sched8.png)
3. Conclua a definição da agenda e clique em Salvar.

## Regras de criação e modificação de agendas

Estas são as regras que você deve seguir ao criar novas agendas ou modificar agendas existentes.

**Observação:** se você tiver agendas que não seguem essas regras, deve modificá-las de acordo. Não seguir as regras pode resultar em um comportamento inesperado e as tarefas podem não ser executadas no horário agendado.

- As agendas executadas a cada 15 ou 30 minutos devem ter horários de início e término na hora. Exemplos de hora: das 05:00 às 06:00.

- As agendas diárias de qualquer recorrência devem ter o mesmo minuto de início e de término. Por exemplo, das 10:35 às 16:35. A hora pode ser diferente. No entanto, se a agenda diária for definida para acontecer apenas uma vez por dia, ela só precisa da hora de início e não da hora de término.

## Consulte também

[Gerenciar tarefas](https://help.tableau.com/current/server/pt-br/task.htm)

[Agendas de atualização de extrações](https://help.tableau.com/current/server/pt-br/publish.htm)

[Agendar tarefas de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm)

<!-- document id=2d06eebc1b08fb2973e4b83d4a88030fcb752fadcf63a5f8927fc83013b97cc1 url=/tableau/current/pt-br/server/data_stories_relationship_story.md -->

[Pular para o conteúdo principal](#main-content)

# Criar relacionamentos de medidas personalizadas em suas Histórias com dados do Tableau

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Você pode criar uma história de relacionamento em História com dados do Tableau para ver como os dados se comparam a outro conjunto de dados. Para construir uma história de relacionamento, você deve ter pelo menos duas medidas e uma dimensão. Os dados que você deseja comparar geralmente são agrupados em uma coluna de dados chamada algo como "Ano" ou "Mês", com valores como "2022" ou "Março".

Você pode [Criar um campo calculado simples](https://help.tableau.com/current/pro/desktop/pt-br/calculations_calculatedfields_formulas.htm) para separar "2022" de "2021" (ou março de fevereiro), para poder comparar os dois períodos em uma história de relacionamento.  
  

1. Comece na planilha que você deseja usar em sua História com dados.
2. Clique em Análise e selecione Criar campo calculado.
3. Crie um campo calculado como "Período atual".  
      
    ![Um campo calculado que diz: If DATETRUNC ('year', \[Year\])= {MAX(DATETRUNC('year', \[Year\]))} THEN \[Number of Records\] END](Img/data_stories_calcfield_current.png)

> [!TIP]
> 
> **Dica:** siga a estrutura do campo calculado mostrado aqui, mas substitua seus próprios nomes de dimensão ou medida (texto laranja).  

1. Crie um campo calculado como "Período anterior".  
      
    ![Um campo calculado que diz: If DATETRUNC ('year', \[Year\])= DATEADD('year', -1, {MAX(DATETRUNC('year', \[Year\]))}) THEN \[Number of Records\] END](Img/data_stories_calcfield_previous.png)

1. Arraste as novas medidas para a marca Detalhe.
2. No seu painel, clique na história e adicione as duas novas medidas às suas Histórias com dados.  
      
    ![Caixa de diálogo História com dados aberta na guia Campo com dimensões e medidas disponíveis.](/tableau/current/pt-br/server/pt-br/Img/data_stories_calcfield_addnew.png)

1. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
2. Na caixa de diálogo Histórias com dados, clique na guia Campos.
3. Configure uma história de relacionamento com as duas medidas personalizadas.  
      
    ![A caixa de diálogo de configurações de Histórias com dados é aberta na guia Relacionamentos. A caixa Atual/Mais recente vs Período anterior está marcada. As medidas relacionadas são SUM(Período Anterior) e SUM(Período Atual).](/tableau/current/pt-br/server/pt-br/Img/data_stories_set_relationship.png)

1. Clique em Salvar.

Sua história agora escreve frases que comparam as medidas personalizadas.

<!-- document id=4d4c35dae43fabfe080e5cdf8b41ec04f2f9aa0191c22baa29dc5afc644330f5 url=/tableau/current/pt-br/server/server_external_repo_configure_standalone.md -->

[Pular para o conteúdo principal](#main-content)

# Criar um banco de dados PostgreSQL como uma instalação autônoma

A partir da versão 2021.2, você pode hospedar o repositório do Tableau Server separadamente como uma instalação autônoma. Isso é diferente de usar um serviço de nuvem gerenciado, como AWS RDS ou Banco de Dados do Azure. Essa configuração pode ser feita localmente, no AWS EC2 ou em uma VM do Azure. Essa instalação do Repositório do Tableau Server será chamada de Repositório Externo Autônomo.

Para ver uma lista completa de hosts que você pode usar para o repositório externo, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo.htm).

Este tópico fornece orientação sobre os requisitos e configurações necessários para que o Tableau Server se conecte a uma instalação PostgreSQL e use-a como o Repositório Externo do Tableau Server. Este tópico não fornece instruções detalhadas sobre como instalar o PostgreSQL. Recomendamos que você siga a [documentação no site do PostgreSQL](https://www.postgresql.org/docs/) para obter essas informações.

## Requisitos e recomendações

- **Recomendações de hardware:** CPU e armazenamento dependem de seus requisitos. Para instalações menores, você deve ter pelo menos 50 GB de armazenamento em disco e um sistema com processador quádruplo (ou 4 núcleos virtuais) com 32 GB de RAM. Revise a orientação [neste tópico](https://help.tableau.com/current/server/pt-br/requ_diskspace.htm#backup-and-restore-processes) para calcular os requisitos de espaço em disco para backup e restauração. A recomendação geral é começar com mais recursos de hardware e reduzir após o monitoramento.
- **Rede:** a instância de banco de dados PostgreSQL deve ser acessível por meio de todos os nós no cluster do Tableau Server. Uma das maneiras de fazer isso é tornar a instância de banco de dados PostgreSQL um membro de um grupo de segurança, que tenha as permissões de acesso necessárias por meio de todos os nós no cluster do Tableau Server.
- **Compatibilidade de versão:** a compatibilidade da versão do PostgreSQL deve coincidir com a versão usada pelo Repositório do Tableau Server, quando instalada localmente. Para obter mais informações sobre compatibilidade, consulte [Compatibilidade entre produtos](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm#postgres-ts-compat).
- **Segurança:** conexões seguras entre o Tableau Server e o repositório externo usando SSL **não são** necessárias, mas recomendadas.
    
    Se você não deseja configurar conexões seguras entre o Tableau Server e o Repositório externo, deve configurar o Banco de dados do PostgreSQL autônomo para permitir conexões não criptografadas.

## Criar uma instância de banco de dados PostgreSQL autônoma

### Etapa 1: instalar e inicializar o PostgreSQL

1. Use a [documentação do PostgreSQL](https://www.postgresql.org/docs/) para instalar a instância do banco de dados PostgreSQL e servir como o repositório externo do Tableau Server. Você pode querer configurar um cluster de banco de dados PostgreSQL para atender a quaisquer requisitos de alta disponibilidade.
2. Instale o pacote contrib que inclui a extensão uuid-ossp. Este módulo é usado para gerar os UUIDS que o Tableau Server usa para chaves no banco de dados.
3. Inicialize a instância do PostgreSQL.

### Etapa 2: configurar a instância PostgreSQL

Você usará dois arquivos de configuração para configurar a instância PostgreSQL:

- `pg_hba`: é o arquivo de configuração para autenticação baseada em host.
- `postgresql.conf`: é o arquivo de configuração geral do servidor.

Por padrão, esses arquivos estão localizados aqui:

C:\\Program Files\\PostgreSQL\\<version>\\Data

#### Configurações de superusuário

Escolha um nome de usuário que atenda aos seus requisitos. Recomendamos usar **postgres** como nome de usuário do Administrador. Se você optar por usar um nome de usuário diferente, certifique-se de que ele não comece com **pg**. O nome de usuário também não pode ser **rails**, **tblwgadmin,** **tableau**, **readonly** ou **tbladminviews**.

> [!IMPORTANT]
> 
> **Esse é um requisito para que o repositório externo funcione corretamente com o Tableau Server.**

#### Rede e segurança

Verifique se a instância do banco de dados pode ser acessada por todos os nós do Tableau Server. Isso geralmente envolve a criação de um grupo de segurança que permite acesso a partir dos nós.

#### Opções de banco de dados

A porta pode ser qualquer valor, mas é recomendável deixá-la como padrão `5432`.

#### Parâmetros de atualização

Da perspectiva do Tableau Server, a maioria dos valores de parâmetros da instância pode ser definida como padrão. Você pode modificar os valores dos parâmetros se tiver requisitos específicos de desempenho ou registro, mas recomendamos que os parâmetros a seguir sejam definidos com os valores padrão e não sejam alterados:

- `standard_conforming_strings`
- `escape_string_warning`

Recomendamos também o valor para o `work_mem` ser definido para pelo menos `16384` para ajudar a evitar problemas de desempenho.

#### Configurar as conexões remotas

Use as etapas a seguir para atualizar os arquivos de configuração:

1. Por padrão, a configuração no `postgresql.conf` é definida para ouvir apenas as conexões locais. Habilite conexões remotas fazendo as seguintes alterações na seção de conexões e autenticação do arquivo `postgresql.conf`:
    
    Adicione esta linha para permitir conexões remotas:
    
    `listen_addresses = '*'`
2. Reinicie a instância PostgreSQL.

### Configurar o SMTP

Conexões seguras entre o Tableau Server e o Repositório Externo **não** são necessárias, mas recomendadas.

Para configurar conexões criptografadas entre o Tableau Server e o Repositório Externo, siga a orientação e as etapas detalhadas descritas abaixo:

Ao configurar o Tableau Server para usar a instância de banco de dados PostgreSQL autônoma, você precisará fornecer uma autoridade de certificação raiz confiável (CA) que é usada para verificar a conexão com o servidor. Idealmente, o certificado de servidor da instância autônoma do PostgreSQL deve especificar um nome de host resolvível para que o Tableau Server possa usar sslmode, **verify-full**. Este modo verifica se o certificado do servidor PostgreSQL foi assinado por uma CA confiável e se o nome do host no certificado do servidor PostgresSQL corresponde ao nome do host usado para se conectar à instância do PostgreSQL. No entanto, se isso não for possível, sslmode, **verify-ca** apenas verificará se o certificado do servidor Postgres foi assinado por uma CA confiável.

O procedimento a seguir fornece as etapas gerais para gerar um certificado de CA raiz no servidor PostgreSQL. Para obter informações mais detalhadas, leia a [documentação SSL](https://www.postgresql.org/docs/12/ssl-tcp.html) no site PostgreSQL (O link aponta para a versão 12):

1. Gere uma chave de autoridade de certificação (CA) raiz de assinatura.
2. Crie o certificado de CA raiz.
3. Crie o certificado e a chave relacionada (por exemplo - `server.csr` e `server.key`) para o servidor PostgreSQL. O nome do assunto do certificado deve corresponder ao nome DNS do servidor PostgreSQL. O nome do assunto é definido com a opção -subj com o formato`/CN=<private DNS name>`:
4. Assine o novo certificado com o certificado CA que você criou na etapa 2.
5. Copie os arquivos crt e key para o diretório de dados (`/pgsql/<version>/data`)
6. O arquivo `pg_hba.conf` controla as conexões com o banco de dados. Adicione a seguinte linha para permitir conexões remotas. Por exemplo:
    
    `host all all 10.0.0.0/8 md5`
7. Para ativar o SSL, adicione ou atualize o arquivo `postgresql.conf` com:
    
    `ssl = on`
    
    Para restringir as conexões apenas a SSL, use _hostssl_ em vez de _host_.

## Alta disponibilidade e recuperação de desastres

O Tableau Server não gerencia ou configura a alta disponibilidade para o repositório externo. O banco de dados PostgreSQL é compatível com várias soluções para esses fins, incluindo replicação e envio de registro. Para obter mais informações, consulte a [documentação de alta disponibilidade](https://www.postgresql.org/docs/current/high-availability.html) no site de PostgreSQL.

No caso de um desastre, se você precisar configurar uma nova instância do PostgreSQL, certifique-se de seguir estas etapas para configurar o Tableau Server para usar a nova instância.

1. **Crie um novo arquivo de configurações JSON** contendo informações de conexão para a nova instância RDS. Para obter mais informações sobre a criação de um arquivo de configurações JSON, consulte **Etapa 1** em [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm).
2. **Use o comando** `tsm topology external-services repository replace-host` para apontar o seu Tableau Server à nova instância do PostgreSQL.
    
    Para mais informações sobre o comando `tsm topology external-services repository replace-host`, consulte [tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm).

## Quem pode fazer isso

Somente os administradores do Tableau Server podem configurar o Tableau Server para usar o repositório externo. Se você estiver usando AWS EC2 ou a VM do Azure para configurar um Repositório externo autônomo, precisará ter contas para acessar essas plataformas.

<!-- document id=1e965646ef625e6d38ee22ebd3fc1f79a91547af0a15f60b1812f0a8de385411 url=/tableau/current/pt-br/server/groups_create_local.md -->

[Pular para o conteúdo principal](#main-content)

# Criar um grupo local

Os grupos locais são criados usando o sistema interno de gerenciamento de usuários do Tableau Server. Depois de criar um grupo, você pode adicionar e remover usuários, bem como definir uma função mínima do site para conceder aos usuários do grupo quando eles fizerem logon.

1. Em um site, clique em **Grupos** e, em seguida, clique em Grupo local.
    
    ![Caixa de diálogo para criar um novo grupo local ou do Active Directory.](/tableau/current/pt-br/server/pt-br/Img/grantrole_atgroup.png)
2. Digite um nome para o grupo.
3. Para definir uma função mínima do site para o grupo, selecione Conceder função do site no logon e selecione uma função mínima do site na lista suspensa.
    
    ![Formulário de criação Novo grupo local.](/tableau/current/pt-br/server/pt-br/Img/grant_localgroup.png)
4. Clique em Criar.

## Associação dinâmica a grupos usando asserções

A partir do Tableau Server 2024.2, se você tiver a autenticação SAML configurada ou usar aplicativos conectados do Tableau para incorporar fluxos de trabalho, poderá controlar dinamicamente a associação ao grupo por meio de asserções. Quando configurado, em tempo de execução durante a autenticação do usuário, o Tableau recebe a declaração e avalia a associação em grupos e, portanto, o conteúdo cujas permissões dependem desses grupos. Os usuários são atribuídos ao grupo com base na asserção, e a associação só será válida enquanto os usuários estiverem conectados.

O processo para controlar dinamicamente a associação ao grupo por meio de asserções requer 1) habilitar a configuração e 2) garantir que as reivindicações de associação ao grupo sejam incluídas nas asserções.

**Observação:** usuários adicionados dinamicamente por meio de asserções não aparecem como usuários no Tableau Server.

### Etapa 1: ativar a configuração

Esse recurso tem duas configurações, uma configuração em todo o servidor e uma configuração em nível de site. A configuração em nível de site só poderá ser ativada se a configuração em todo o servidor tiver sido habilitada primeiro. Considere ativar a configuração no nível do site se você tiver o SAML do site ou aplicativos conectados configurados.

Por motivos de segurança, a associação ao grupo só será validada em um fluxo de trabalho de autenticação se a configuração estiver ativada.

1. Entre no Tableau Servidor e navegue para a página Configurações.
    
    **Observação:** para um servidor de vários sites, navegue até a página Configurações em todos os sites.
2. No título Asserções para associação de grupo, selecione a caixa de seleção Permitir asserções de grupo para permitir a associação ao grupo por meio de asserções SAML ou JWT.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/abac_assertions_setting_server.png)
3. (Opcional) Se você tiver SAML de site ou aplicativos conectados configurados no nível do site, faça o seguinte:
    
    1. Navegue até o site, acesse a página Configurações e, em seguida, no título Asserções para associação ao grupo, marque a caixa de seleção Permitir asserções de grupo para habilitar a associação ao grupo por meio de asserções SAML ou JWT.
    2. Marque a caixa de seleção do tipo de asserção aplicável para habilitar.

Para obter mais informações sobre as configurações, consulte um dos seguintes tópicos:

- [Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm)
- Nível do site - [Referência de configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm)

### Etapa 2: garantir que as reivindicações de associação ao grupo sejam incluídas na declaração

Duas declarações de associação de grupo personalizadas devem ser incluídas na respectiva declaração SAML, OIDC ou JWT para especificar a associação de grupo. As duas reivindicações de associação de grupo personalizada são:

- Grupo: `https://tableau.com/groups`
- Nomes de grupos: esses nomes devem corresponder aos nomes dos grupos locais em Tableau Server exatamente.

Para obter exemplos de afirmações, consulte uma das seguintes seções:

- [Associação dinâmica a grupos usando asserções SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm#assertions)
- Aplicativos conectados – confiança direta: [JWTs de exemplo](https://help.tableau.com/current/server/pt-br/connected_apps_direct.htm#example)

<!-- document id=eb1663228b549f92a6bf7b2efbddbf6bbc589ba19947516aab8faf474b46c7a7 url=/tableau/current/pt-br/server/datasource_mfr_build.md -->

[Pular para o conteúdo principal](#main-content)

# Criar um modelo de dados de relacionamento de vários fatos

A análise geralmente envolve reunir tabelas de dados que não têm um relacionamento direto entre si, mas que ambos se relacionam com as mesmas informações comuns, como data ou local. Este tipo de análise é por vezes denominada análise de vários fatos com dimensões compartilhadas.

Para realizar esse tipo de análise no Tableau, crie uma fonte de dados que use várias tabelas base conectadas por tabelas compartilhadas.

- _Tabelas básicas_ são as tabelas mais à esquerda no modelo de dados na guia Fonte de dados. Para obter orientação sobre como determinar quais tabelas usar como tabelas base, consulte [Quando usar um modelo de relação de vários fatos](https://help.tableau.com/current/server/pt-br/datasource_mfr_when_to_use.htm).
- _Tabelas compartilhadas_ são tabelas downstream com várias relações de entrada. Essas tabelas contêm campos que podem agrupar campos não relacionados durante a análise em uma visualização. Data e Local são exemplos de tabelas comumente compartilhadas.

## Criar o modelo

Criar um modelo de dados de relacionamento multifatorial é essencialmente o mesmo que criar qualquer outra fonte de dados que use relações, mas com duas peças adicionais: tabelas base adicionais e várias relações de entrada para tabelas compartilhadas.

1. [Conecte-se aos seus dados](https://help.tableau.com/current/pro/desktop/pt-br/basicconnectoverview.htm). Você pode usar [múltiplas conexões de dados](https://help.tableau.com/current/pro/desktop/pt-br/datasource_plan.htm#tableau-data-sources) se suas tabelas não estiverem todas no mesmo banco de dados.
2. Arraste uma tabela para a tela para criar a primeira tabela base.
3. Arraste outra tabela do painel esquerdo para a área de destino Nova tabela base.
    
    ![A tela de modelagem de dados com uma tabela base existente e uma área para soltar para Nova tabela base](/tableau/current/pt-br/server/pt-br/Img/mfr_new_base_table.png)
    
    O Tableau mostra um aviso de que você está criando um modelo de dados com diversas tabelas base. Recomendamos que você configure um modelo de tabela base múltipla somente se seus dados precisarem dele. Caso contrário, use um modelo de tabela base única para evitar as complexidades que acompanham um modelo de tabela base múltipla.
    
    ![um modelo de dados com duas tabelas base, uma com um aviso para múltiplas tabelas base](/tableau/current/pt-br/server/pt-br/Img/mfr_multi_base_table_warning.png)
4. Arraste outro campo para a tela e relacione-o a uma das tabelas base. [Configure cada relação, se necessário](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm#create-and-define-relationships).
    
    ![uma tabela downstream sendo adicionada ao modelo de dados](/tableau/current/pt-br/server/pt-br/Img/mfr_build_downstream.png)
5. Passe o mouse sobre a tabela base ainda não relacionada para exibir um sinal de mais (informalmente conhecido como “almôndega”).
    
    ![tabela base de Clubes com um cursor sobre ela e o sinal de mais de “almôndega” exibido](/tableau/current/pt-br/server/pt-br/Img/mfr_build_meatball_base.png)
6. Arraste o ícone do sinal de mais para a tabela compartilhada para criar um novo relacionamento de entrada (também conhecido como “macarrão”).
    
    ![uma almôndega arrastando um novo macarrão para uma tabela existente downstream](/tableau/current/pt-br/server/pt-br/Img/mfr_build_meatball.png)
7. _Opcional:_ continue adicionando tabelas downstream e tabelas base. Clique e arraste o ícone do sinal de mais para criar tabelas compartilhadas, conforme necessário.

**Observação**: em vez de começar com as tabelas base, você também pode criar primeiro um modelo de tabela base única e adicionar mais tabelas base posteriormente.

## Explorar o modelo

Um modelo de dados com múltiplas tabelas base é construído com relações, mas nem todas as tabelas estão relacionadas entre si no mesmo grau. Cada tabela base define uma _árvore_, que contém todas as tabelas relacionadas a essa tabela base, diretamente relacionadas ou downstream de uma tabela relacionada. Existem tabelas compartilhadas em diversas árvores. Para obter mais informações sobre graus de parentesco, consulte [Sobre modelos de dados de relação de vários fatos](https://help.tableau.com/current/server/pt-br/datasource_mfr_multiple_base_tables.htm).

Ao visualizar um modelo com diversas tabelas base, há diversas opções para explorar e gerenciar o modelo de dados. Essas opções são especialmente úteis quando um modelo de dados é complexo.

![um modelo de dados com quatro tabelas base e várias tabelas compartilhadas, bem como tabelas downstream não compartilhadas](/tableau/current/pt-br/server/pt-br/Img/mfr_build_complex_model.png)

Um exemplo de modelo de dados complexo com quatro tabelas base, várias tabelas compartilhadas e tabelas downstream. As tabelas downstream são compartilhadas e não compartilhadas entre as tabelas base.

A versão 2024.2 introduziu alguns novos detalhes de layout para o modelo de dados. Em um modelo de dados de relacionamento de vários fatos, os relacionamentos são agrupados para ajudar a rastrear quantos relacionamentos de entrada uma tabela tem. As tabelas compartilhadas (e as tabelas compartilhadas downstream) têm um contorno mais pronunciado do que as tabelas que não são compartilhadas.

### Terminologia

Tabelas em um modelo de dados de tabela base múltipla têm funções específicas. Tabelas base e tabelas compartilhadas são as únicas tabelas que devem existir em um modelo de dados de relacionamento multifator. (Sem mais de uma tabela base, não é um modelo de dados de relacionamento multifator. Sem uma tabela compartilhada conectando as tabelas base, não é um modelo de dados válido.)

Devido à natureza frequentemente complexa desses modelos, é útil ter uma terminologia compartilhada:

- _Tabelas base_ estão na extrema esquerda e não têm relacionamentos futuros.
    - No exemplo, Estoque, Marketing, Vendas e Suporte são tabelas base.
- _Tabelas de sub-base_ estão entre uma tabela base e uma tabela compartilhada.
    - No exemplo, Peças é uma tabela sub-base.
- _Tabelas compartilhadas_ ter mais de um relacionamento de entrada.
    - No exemplo, Produtos, Datas, Cliente e Fornecedor são tabelas compartilhadas.
- _Tabelas compartilhadas downstream_ tem exatamente um relacionamento de entrada e tem uma tabela compartilhada em algum lugar acima deles.
    - No exemplo, Subcategoria e Categoria são tabelas compartilhadas downstream.
- _Tabelas não compartilhadas downstream_ têm exatamente um relacionamento de entrada e não têm tabelas compartilhadas a montante deles.
    - No exemplo, não há tabelas não compartilhadas downstream.

![Um modelo de dados que define os termos tabela base, tabela sub-base, tabela não compartilhada downstream, tabela compartilhada e tabela compartilhada downstream.](/tableau/current/pt-br/server/pt-br/Img/mfr_terminology.png)

Teste sua compreensão: identifique os tipos de tabelas na fonte de dados de exemplo

![um modelo de dados com quatro tabelas base e várias tabelas compartilhadas, bem como tabelas downstream não compartilhadas](/tableau/current/pt-br/server/pt-br/Img/mfr_build_complex_model.png)

- **Tabelas base**: Inventário, Marketing, Vendas e Suporte
- **Tabela de sub-base:** Peças
- **Mesas compartilhadas:** Produtos, Datas, Cliente e Fornecedor
- **Tabelas compartilhadas downstream:** Subcategoria e Categoria
- **Tabelas não compartilhadas downstream:** nenhum

### Identificar uma árvore de relação

Passe o mouse sobre uma tabela para destacar as tabelas às quais ela está relacionada. O Tableau enfatiza a árvore dessa tabela e tira a ênfase das tabelas não relacionadas.

![o modelo complexo, com a árvore de uma tabela base destacada e as outras tabelas esmaecidas](/tableau/current/pt-br/server/pt-br/Img/mfr_build_highlightedtree.png)

A árvore da tabela base Marketing consiste em duas tabelas compartilhadas, Datas e Produtos, e tabelas compartilhadas downstream Subcategoria e categoria.

### Ver detalhes da relação

Passe o mouse sobre uma relação ou pacote de relações para ver os detalhes em uma dica de ferramenta.

![Um pacote triplo de macarrão, com uma dica que contém uma linha para os detalhes de cada relação](/tableau/current/pt-br/server/pt-br/Img/mfr_build_noodle_bundle.png)

As relações de entrada para a tabela Produtos incluem três relacionamentos individuais para as tabelas base Estoque, Marketing e Vendas.

### Selecionar uma relação

Quando um relacionamento é selecionado, ele é destacado em azul na tela e seus detalhes aparecem no painel Detalhes da tabela. O painel Detalhes da tabela é onde você pode [inspecionar ou modificar a cláusula de relação](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm#create-a-relationship).

Há diversas maneiras de selecionar uma relação:

- Clique em uma linha de relação (macarrão) na tela. Toda relação tem uma zona clicável que seleciona apenas aquele macarrão.
- Clique com o botão direito ou clique com a tecla Control pressionada em uma tabela na tela para abrir seu menu. Selecione a opção Selecionar relação e escolha qual relação de tabela você deseja.
- Clique em um pacote de relacionamentos na tela para exibir uma dica de ferramenta persistente (passar o mouse sobre um pacote exibe a dica de ferramenta, clicar para fazê-la persistir). Em seguida, selecione uma linha nos detalhes da dica de ferramenta para destacar essa relação no modelo.
- Abra o menu na barra de ferramentas do painel Detalhes da tabela e selecione a relação desejada. Você também pode usar este menu para selecionar uma tabela específica e ver sua visualização no painel.
    
    ![o menu no painel Detalhes da tabela](/tableau/current/pt-br/server/pt-br/Img/mfr_build_table_details_menu.png)

### Trocar com tabela base

As tabelas intermediárias em uma relação entre uma tabela base e tabelas compartilhadas oferecem a opção de trocar a tabela downstream pela tabela base. Essa é uma mudança puramente visual para ajudar na compreensão conceitual e não altera a estrutura do modelo de dados.

Clique com o botão direito ou clique com a tecla Control pressionada em uma tabela downstream e selecione Trocar com tabela base (nome da tabela). A opção de troca também está presente apenas na tabela downstream e não na tabela base.

A opção de troca não está disponível para tabelas que alterariam o modelo de dados se trocadas, como tabelas compartilhadas ou tabelas compartilhadas downstream. Somente tabelas não compartilhadas downstream ou tabelas sub-base podem ser trocadas com tabelas base.

#### _Exemplo_

Neste exemplo, as tabelas **Informações do salão** e **Vendas de sorvete** podem ser trocadas sem alterar a estrutura fundamental do modelo de dados. Nenhuma outra tabela pode ser trocada.

- As vendas de sorvete estão relacionadas às informações do salão e à tabela de datas compartilhada.
- As informações do salão estão relacionadas às vendas de sorvete e à tabela de localização compartilhada.
- O clima está relacionado às tabelas compartilhadas de data e local.

Esses dois modelos são conceitualmente equivalentes:

![duas versões de modelos de dados equivalentes onde uma tabela base e sua tabela downstream não compartilhada são trocadas](/tableau/current/pt-br/server/pt-br/Img/mfr_swapbase_icecream.png)

### Recolher uma tabela base

Você também pode recolher um caminho de relacionamento, ou árvore, apenas para sua tabela base para simplificar a exibição do modelo de dados temporariamente.

Clique nos botões Recolher ![](/tableau/current/pt-br/server/pt-br/Img/mfr_icon_collapse.png) ou Expandir ![](/tableau/current/pt-br/server/pt-br/Img/mfr_icon_expand.png) em uma tabela base para recolher ou expandir toda a sua árvore. Como alternativa, clique com o botão direito ou com a tecla Ctrl pressionada em uma tabela downstream e selecione Recolher este caminho ou Recolher outros caminhos. Essa opção não está disponível em tabelas compartilhadas ou em tabelas downstream de tabelas compartilhadas.

Recolher uma árvore em sua tabela base é puramente visual e não acionará o alerta de Tabelas não relacionadas. Um caminho recolhido é indicado por uma tabela base com uma tabela empilhada e um botão Expandir. O recolhimento afeta todas as tabelas e relacionamentos que são relevantes apenas para essa árvore, portanto, as tabelas compartilhadas com um caminho não recolhido não ficam ocultas.

Use o botão de Expansão ![](/tableau/current/pt-br/server/pt-br/Img/mfr_icon_expand.png) para reabrir a tabela base e tudo na árvore.

![a árvore da tabela base de suporte sendo recolhida e expandida](/tableau/current/pt-br/server/pt-br/Img/mfr_build_collapsetree_gif.gif)

## Solução de problemas

### Criar uma única fonte de dados

Todas as tabelas devem estar relacionadas de alguma forma com toda a fonte de dados. Se houver alguma tabela que não esteja relacionada ao modelo de dados geral, um alerta será exibido. O alerta permanece até que nenhuma tabela ou árvore esteja totalmente separada do restante do modelo de dados. Quando o alerta está ativo, a fonte de dados não pode ser publicada e você não pode usá-la em uma análise.

Você pode abrir o alerta e definir Tabelas não relacionadas visualmente separadas para identificar quais tabelas acionaram o alerta. Essa opção é útil quando você tem um modelo complexo e precisa identificar quais tabelas ainda não estão relacionadas ao restante do modelo de dados.

#### _Exemplo_

Nas etapas em [Criar um modelo](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_build.htm#Build), um alerta aparece na Etapa 4 antes que uma relação seja incluída para conectar a segunda tabela base.

![Uma mensagem de alerta de tabela não relacionada](/tableau/current/pt-br/server/pt-br/Img/mfr_build_unrelated_alert.png)

Definir Tabelas não relacionadas visualmente separadas para Habilitado move a tabela **Clubes** embaixo da linha Tabelas não relacionadas. Relacionar **Clubes** a **Alunos** resolve o alerta.

![Um modelo de dados com uma tabela não relacionada abaixo de uma linha vermelha pontilhada denominada Tabelas não relacionadas](/tableau/current/pt-br/server/pt-br/Img/mfr_build_visuallyseparate.png)

#### Resolver um ciclo

Mesmo que algumas tabelas não estejam diretamente relacionadas entre si, todo o modelo de dados deve ser coeso. Neste exemplo, cada tabela base define uma árvore, mas não há nenhuma tabela compartilhada conectando-as. Esse não é um modelo válido para análise.

![Um modelo de dados com duas tabelas base cujas árvores distintas não se sobrepõem](/tableau/current/pt-br/server/pt-br/Img/mfr_build_unrelated1.png)

Os dois grupos de tabelas relacionadas precisam ser combinados através de uma tabela compartilhada...

![O mesmo modelo de dados, agora conectado a uma tabela compartilhada](/tableau/current/pt-br/server/pt-br/Img/mfr_build_unrelated2.png)

...ou o modelo de dados precisa ser criado como duas fontes de dados separadas.

![O mesmo modelo de dados, dividido em duas fontes de dados](/tableau/current/pt-br/server/pt-br/Img/mfr_build_unrelated3.png)

### Restrições do modelo de dados

Alguns caminhos de relações entre tabelas não são aceitos em um modelo de tabela multibase. Se você não conseguir eliminar a almôndega ao tentar criar um segundo relacionamento de entrada em uma tabela, verifique se a estrutura que você está tentando criar é compatível com o Tableau. Exemplos de modelos não aceitos incluem:

#### Ciclos

Ciclos – onde há mais de um caminho de relações de uma tabela upstream para a mesma tabela downstream – não são aceitos. Essa estrutura sem suporte às vezes é chamada de gravata borboleta. Para modelar esse tipo de relacionamento entre tabelas no Tableau, use várias tabelas base em vez de uma gravata borboleta convertendo a tabela downstream em outra tabela base.

![um diagrama de uma gravata borboleta e outro diagrama com a tabela downstream alterada para uma tabela base adicional](/tableau/current/pt-br/server/pt-br/Img/mfr_build_bowtie_tableauified.png)

O modelo de dados deve ser um _gráfico acíclico direcionado_. Isso significa que toda relação de entrada em uma tabela deve ser rastreável upstream até uma tabela base diferente.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col></colgroup><tbody><tr><td><b>Não aceito</b>. A Tabela X tem dois relacionamentos de entrada que são de tabelas downstream da Tabela Base A</td><td><b>Aceito</b>. As tabelas S e T têm várias relações de entrada, mas cada uma vem de uma tabela base diferente.</td><td><b>Aceito</b>. Embora possa parecer visualmente que há um ciclo, as relações de entrada da Tabela S e da Tabela T podem ser rastreadas até diferentes tabelas base.</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_build_cycle1.png" alt="modelo de dados não aceito devido a um ciclo"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_build_cycle2.png" alt="modelo de dados aceito com uma gravata borboleta convertida em uma segunda tabela base"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_build_cycle3.png" alt="um modelo de dados suportado com relações de entrada para tabelas compartilhadas rastreáveis para diferentes tabelas base"></td></tr></tbody></table>

#### Tabelas compartilhadas aninhadas

Tabelas compartilhadas aninhadas não são aceitas. Qualquer tabela downstream de uma tabela compartilhada (uma tabela com várias relações de entrada) só pode ter uma relação de entrada.

![modelo não aceito com uma tabela compartilhada aninhada](/tableau/current/pt-br/server/pt-br/Img/mfr_build_nestedshared.png)

Não aceito. A tabela T está downstream de uma tabela compartilhada e não pode receber uma relação de entrada adicional.

<!-- document id=1afe8532dd10c98f500ecc45194519b7cef2295656003eb543a054c4bb312210 url=/tableau/current/pt-br/server/perf_record_create_server.md -->

[Pular para o conteúdo principal](#main-content)

# Criar um registro de desempenho

O recurso Registro de desempenho no Tableau, registra informações de desempenho sobre eventos importantes à medida que você interage com uma pasta de trabalho. Você pode visualizar as métricas de desempenho em uma pasta de trabalho criada pelo Tableau para analisar e solucionar diferentes eventos que são conhecidos por afetar o desempenho:

- Execução de consultas
- Compilação de consulta
- Codificação geográfica
- Conexões com fonte de dados
- Cálculos de layout
- Geração de extrações
- Combinação de dados
- Renderização do servidor (somente o Tableau Server)

O suporte do Tableau poderá solicitar que você crie uma pasta de trabalho de desempenho durante o diagnóstico de problemas de desempenho.

Procurando o Tableau Server no Linux? Consulte [Criar um registro de desempenho](https://help.tableau.com/current/server-linux/pt-br/perf_record_create_server.htm "Abre o tópico em uma nova guia do navegador").

## Iniciar um registro de desempenho para um site

Por padrão, o registro de desempenho não é habilitado para o site. Um administrador do servidor pode habilitar o registro de desempenho em cada site.

1. Navegue para o site que você deseja habilitar um registro de desempenho.
2. Selecione Configurações:
    
    ![Página de métricas de desempenho da pasta de trabalho.](/tableau/current/pt-br/server/pt-br/Img/server-workbook-perf-metrics-settings.png)
3. Em Métricas de desempenho da pasta de trabalho, selecione Gravar métricas desempenho da pasta de trabalho.
4. Selecione Salvar.

## Iniciar um registro de desempenho para uma exibição

1. Abra a exibição para registrar o desempenho.
    
    Quando você abre uma exibição, o Tableau Server anexa ":iid=<_n_\>" após a URL. Esta é uma ID da sessão. Por exemplo:
    
    http://10.32.139.22/#/views/Coffee\_Sales2013/USSalesMarginsByAreaCode?:iid=1
2. Digite `:record_performance=yes&` no final da URL de exibição, imediatamente antes da ID da sessão. Por exemplo:
    
    http://10.32.139.22/#/views/Coffee\_Sales2013/USSalesMarginsByAreaCode?:record\_performance=yes&:iid=1
3. Selecione o botão **Atualizar** na barra de ferramentas.
4. Carregue a exibição.

## Exibir um registro de desempenho

Enquanto um registro de desempenho está em execução, um novo ícone é exibido na barra de menu:

![](/tableau/current/pt-br/server/pt-br/Img/server_perf_recording.png)

Use isso para exibir um registro de desempenho:

1. Clique no ícone Consultar os dados de registro de desempenho para abrir uma pasta de trabalho de desempenho. É um instantâneo atualizado de dados de desempenho. Você pode continuar a tirar instantâneos adicionais enquanto trabalha com a exibição; os dados de desempenho são cumulativos.
2. Mova para uma página diferente ou remova `:record_performance=yes` da URL para interromper a gravação.

## Uso de um registro de desempenho

Para obter informações sobre como interpretar um registro de desempenho, consulte [Interpretar um registro de desempenho](https://help.tableau.com/current/server/pt-br/perf_record_interpret_server.htm).

<!-- document id=1cb0a2d9dc6f89b2de273fc7d77c5369d6406ace8b558d77fbd1d3f36dd4ce1c url=/tableau/current/pt-br/server/subscribe_user.md -->

[Pular para o conteúdo principal](#main-content)

# Criar uma assinatura para uma exibição ou pasta de trabalho

As assinaturas enviam um instantâneo de imagem ou PDF de uma exibição ou pasta de trabalho por e-mail em intervalos regulares, sem precisar fazer logon no Tableau Server.

**Observação**: os administradores vão determinar se as assinaturas estarão ativadas para um site.

Se o Tableau Catalog estiver ativado para um site, os administradores também podem determinar se os e-mails de assinatura incluem avisos de qualidade de dados upstream relevantes. O Tableau Catalog está disponível como parte do Data Management. Para obter mais informações, consulte [Sobre o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm).

## Configurar uma assinatura para você mesmo ou para outras pessoas

Ao abrir uma exibição no Tableau Server, se visualizar um ícone de inscrição (![Ícone Inscrição.](/tableau/current/pt-br/server/pt-br/Img/subscribe_icon.png)) na barra de ferramentas, você poderá se inscrever nessa exibição ou na pasta de trabalho inteira. Você pode assinar outros usuários com permissão para exibir o conteúdo, se for proprietário de uma pasta de trabalho, se for um líder de projeto com uma função de site apropriada ou se for um administrador.

1. De uma seção de Explorar do seu site, selecione Todas as pastas de trabalho ou Todas as exibições, ou abra o projeto que contém a exibição a qual deseja assinar.
    
    ![Menu do tipo conteúdo](/tableau/current/pt-br/server/pt-br/Img/subscribe_content_1a.png)
2. Abra a exibição diretamente ou após abrir a pasta de trabalho onde ela está incluída. Os filtros aplicados à exibição não serão refletidos na assinatura. Para inscrever usuários em uma exibição filtrada, salve uma exibição personalizada com esses filtros e, em seguida, inscreva usuários nessa exibição. Para obter informações sobre como criar visualizações personalizadas, consulte [Usar exibições personalizadas](https://help.tableau.com/current/server/pt-br/customview.htm).
3. Na barra de ferramentas da exibição, selecione o botão Observar > Assinaturas.
    
    ![Caminho de assinatura na barra de ferramentas do Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/subscribe_toolbar.png)
4. Adicione usuários ou grupos do Tableau que deseja receber a assinatura. Para receber uma assinatura, os usuários devem ter as permissões Visualizar e Baixar Imagem/PDF e suas contas também devem ter endereços de e-mail.
    
    Se você for o proprietário da pasta de trabalho, clique em Inscrever-me.
    
    Observações: 
    
    - Ao assinar um grupo, cada usuário é adicionado individualmente no momento em que a assinatura é criada. Se mais usuários forem adicionados ao grupo posteriormente, você deverá inscrever novamente o grupo para que os novos usuários recebam a assinatura. Da mesma forma, os usuários removidos posteriormente do grupo não terão suas assinaturas removidas automaticamente, a menos que suas permissões para a exibição assinada sejam removidas.
    - Você não pode assinar um conjunto de grupo.
5. Escolha se os e-mails de assinatura incluirão a exibição atual ou toda a pasta de trabalho. Se a exibição contiver dados somente quando existirem informações de alta prioridade, selecione Não enviar se a exibição estiver vazia.
6. Escolha o formato do seu instantâneo: como uma imagem PNG, um anexo PDF ou ambos. Observe que as métricas Pulse estão incluídas em instantâneos no formato PNG, mas não em PDFs.
    
    - Se for em PDF, escolha o tamanho do papel e a orientação que você gostaria de receber.
        
        ![Um menu no formato PDF com listas suspensas para tamanho e orientação do papel.](/tableau/current/pt-br/server/pt-br/Img/subscription_paper.png)
7. Para explicar os e-mails de assinatura, personalize a linha de assunto e adicione uma mensagem.
    
    **Observação:** para atualizar a mensagem de assinatura, você deve cancelar a assinatura existente e criar uma nova assinatura com uma mensagem diferente. Para obter mais informações, consulte [Atualizar ou cancelar uma assinatura](#Unsubscribe).
8. Quando a pasta de trabalho usa uma extração de dados em uma conexão publicada, você pode escolher uma frequência:
    
    - Quando os dados se atualizam: envia somente quando os dados na exibição ou na pasta de trabalho são atualizados por agendas de atualização.
    - Na agenda selecionada: escolha uma agenda para a assinatura.
9. Se a frequência não for definida para quando os dados forem atualizados, escolha uma agenda:
    
    - Escolha as agendas de inscrição estabelecidas pelo administrador.
    - Para sites com [agendas personalizadas habilitadas](https://help.tableau.com/current/server-linux/pt-br/schedule_enable_custom.htm), clique na seta suspensa à esquerda das configurações atuais.
        
        ![A agenda é cinco dias por semana, às 8:00.](/tableau/current/pt-br/server/pt-br/Img/subscribe_options_online_sched.png)
        
        Depois, especifique uma agenda personalizada que envia e-mails de inscrição sempre que você desejar. (O tempo de entrega exato pode variar se a carga do servidor for alta).
        
        ![Um agendador configurado para repetir a cada hora, de segunda a sexta, das 9h às 17h.](/tableau/current/pt-br/server/pt-br/Img/self_subscribe_topic.png)
        
        Para alterar o fuso horário, clique no link Fuso horário para acessar a página de configurações da sua conta.
10. Clique em Assinar.

Ao receber um e-mail de assinatura, você pode selecionar a imagem (ou o link no corpo da mensagem para assinaturas em PDF) a ser levada para a exibição ou pasta de trabalho no Tableau Server

## Atualizar ou cancelar uma assinatura

É possível cancelar uma assinatura existente ou fazer alterações no formato, agendamento, assunto ou modo de exibição vazia de uma assinatura.

1. Acesse as configurações da sua conta no Tableau Server, executando um dos seguintes procedimentos:
    
    - Clique em Gerenciar minhas inscrições na parte inferior de um e-mail de inscrição.
        
        ![Link para gerenciar sua assinatura.](/tableau/current/pt-br/server/pt-br/Img/subscribe_remove.png)
    - Efetue logon no Tableau Server. Na parte superior da página, selecione seu ícone de usuário e, em seguida, Meu conteúdo.
        
        ![Menu de assinatura com opções para Meu conteúdo.](/tableau/current/pt-br/server/pt-br/Img/subscribe_remove2.png)
2. Clique em Assinaturas.
3. Marque a caixa de seleção ao lado da exibição cuja assinatura você deseja cancelar, clique em Ações e depois clique em Cancelar assinatura ou selecione a opção de assinatura que gostaria alterar.

## Retomar ou excluir assinaturas suspensas

Às vezes, as assinaturas falham por causa de um problema com a pasta de trabalho ou um problema em carregar a exibição. Se uma assinatura falhar mais de cinco vezes, você receberá uma notificação por e-mail informando que a assinatura foi suspensa. Há algumas maneiras de retomar uma assinatura suspensa se você for o proprietário ou o administrador:

- Na área Meu conteúdo das páginas na Web do Tableau, aparece um ícone na coluna Última atualização para indicar que a assinatura está suspensa. Selecione ... > Retomar assinatura para retomar.
- Na guia Assinaturas da pasta de trabalho afetada, aparece um ícone na coluna de última atualização para indicar que a assinatura está suspensa. Selecione ... > Retomar assinatura para retomar.

Você receberá um e-mail de notificação quando a assinatura estiver funcionando novamente.

## Consulte também

[Alterar as configurações da assinatura](https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm#change-subscription-settings) na Ajuda do Tableau Desktop e da Criação na Web.

Consulte [Administração no nível de projeto](https://help.tableau.com/current/online/pt-br/projects.htm#project-admin "O link abre o artigo em uma nova guia do navegador.") na Ajuda do Tableau Cloud para saber quais funções de site permitem os recursos completos do Líder de projeto.

<!-- document id=ef5ed40bf2fad1fef6d47ece19ec1dc5ab823677d67c04e9712b23f7ca7c97de url=/tableau/current/pt-br/server/dm_vconn_create_conn.md -->

[Pular para o conteúdo principal](#main-content)

# Criar uma conexão virtual

Uma conexão virtual é um tipo de conteúdo do Tableau que fornece um ponto de acesso central compartilhável para dados, bem como suporte à segurança em nível de linha no nível de conexão. A criação de uma conexão virtual é um processo de várias etapas. Este tópico aborda a conexão com os dados que você deseja compartilhar e o trabalho na guia Tabelas do editor de conexão virtual.

## Conectar a dados

Para criar uma conexão virtual no Tableau Cloud ou Tableau Server:

1. Na página Início ou Explorar, clique em Novo > Conexão virtual.
2. Na caixa de diálogo Conectar a dados, selecione o conector dos seus dados. Para obter uma lista de conectores compatíveis para conexões virtuais, consulte [Creators: conectar-se a dados](https://help.tableau.com/current/pro/desktop/pt-br/creator_connect.htm#connector_list) na ajuda do Tableau Desktop e Criação na Web.
3. Insira as informações solicitadas. As credenciais inseridas são salvas na conexão virtual, portanto, os usuários da conexão não precisam inserir credenciais para se conectar aos dados.
4. Clique em Entrar se solicitado. Para adicionar outra conexão, clique em![O sinal de adição para inserir uma conexão no editor de conexão virtual](/tableau/current/pt-br/server/pt-br/Img/ipa_vconns_add_connection_plus.png) e selecione um conector, insira as credenciais e entre.

Uma conexão virtual pode ter várias conexões. Cada conexão acessa um banco de dados ou arquivo.

**Observação:** para o Tableau Cloud, as conexões virtuais que se conectam aos dados da rede privada usam o Tableau Bridge para manter os dados atualizados. Para obter mais informações sobre a configuração do Tableau Bridge, consulte [Configurar e gerenciar pool de clientes do Bridge](https://help.tableau.com/current/online/pt-br/to_enable_bridge_live_connections.htm) Para obter informações sobre as conexões aceitas, consulte [Conectividade com o Bridge](https://help.tableau.com/current/online/pt-br/to_sync_local_data.htm).

## Adicionar outra conexão

Conforme necessário, adicione outra conexão a uma conexão virtual e conecte-se a mais de um banco de dados clicando em![O sinal de adição para inserir uma conexão no editor de conexão virtual](/tableau/current/pt-br/server/pt-br/Img/ipa_vconns_add_connection_plus.png) perto de **Conexões**. Você pode adicionar uma conexão a um servidor ou banco de dados diferente ou ao mesmo servidor ou banco de dados.

Com várias conexões, é possível:

- Use uma tabela de qualquer conexão ou banco de dados como uma tabela de direitos em uma política de dados que proteja tabelas de outras conexões e bancos de dados.
- Adicione ou substitua tabelas em uma conexão virtual por tabelas de um banco de dados diferente. Por exemplo, digamos que você migre dados de um banco de dados para outro. No editor de conexão virtual, você pode adicionar uma conexão ao segundo banco de dados e substituir as tabelas existentes do primeiro banco de dados por tabelas do segundo.
- Adicione várias conexões ao mesmo servidor ou banco de dados. Isso pode ser útil quando você precisa, por exemplo, acessar dados do mesmo banco de dados, mas com credenciais diferentes.
- Compartilhe um grupo de tabelas relacionadas ou destinadas a serem usadas juntas de onde estejam localizadas fisicamente. Por exemplo, a partir de vários bancos de dados, você pode agrupar tabelas relacionadas a informações de funcionários.

Ao abrir uma conexão virtual para editá-la, se solicitado, você deve autenticar as conexões em sequência. Se alguma conexão falhar na autenticação, você não poderá editar a conexão virtual.

## Selecionar as tabelas para incluir na conexão

Se necessário, selecione um banco de dados para visualizar as tabelas nele.

1. À esquerda, em Tabelas , selecione as tabelas e clique ou arraste-as para a guia Tabelas à direita. Você pode incluir tabelas de diferentes conexões. Inclua uma tabela de direitos, se estiver usando uma.
2. (Opcional) Clique em Novo SQL personalizado para criar um esquema de tabela personalizado.

**Observação:** as conexões virtuais não são compatíveis com tabelas que têm um tipo de dados espaciais.

## Selecione o modo de tempo real ou de extração para tabelas

Você pode definir tabelas individuais - sejam elas de várias conexões ou não - para o modo em tempo real ou de extração na mesma conexão virtual.

- Tempo real - as tabelas são consultadas diretamente no banco de dados. (Em tempo real é o padrão.)
- Extrações - as tabelas são extraídas e salvas no Tableau.

Por exemplo, você pode definir algumas tabelas para o modo de extração para que não sejam afetadas pela geração de relatórios ou tráfego intenso de clientes.

Em Tabelas, selecione a tabela ou tabelas para as quais deseja alterar o modo e selecione Ações, e Mudar para tempo real ou Alterar para extração. Como alternativa, selecione o Menu Ações (...) na linha da tabela e selecione Em tempo real ou Extrair.

### Extrações incrementais

A partir do Tableau Cloud de junho de 2024 e do Tableau Server 2024.2, você pode configurar extrações de tabela para atualização incremental.

Ao configurar uma extração incremental, você especifica uma coluna-chave que é usada para identificar novas linhas. Quando a extração incremental for atualizada, somente as linhas em que a coluna-chave aumentou serão adicionadas à extração. Menos linhas processadas significam um trabalho de atualização de extração mais rápido e menos carga no banco de dados.

Por exemplo, suponha que temos um extrato para a tabela **Batedores**, e os dados na extração são:

<table style="width: 100%;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><strong>Ano</strong></td><td><strong>Equipe</strong></td></tr><tr><td>1978</td><td>Leões</td></tr><tr><td>1979</td><td>Tigres</td></tr></tbody></table>

A tabela **Batedores** está configurada para atualização de extração incremental e a coluna-chave é **Ano**.

A tabela ativa é atualizada com uma nova linha para **1980**:

<table style="width: 100%;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><strong>Ano</strong></td><td><strong>Equipe</strong></td></tr><tr><td>1978</td><td>Leões</td></tr><tr><td>1979</td><td>Tigres</td></tr><tr><td>1980</td><td>Ursos</td></tr></tbody></table>

Quando a extração da tabela **Batedores** for atualizada de forma incremental, somente as linhas que excederem o maior valor na coluna-chave da extração serão adicionadas. Neste caso, isso significa que a linha **1980** é adicionada ao extrato. Em vez de atualizar todo o arquivo de extração, apenas uma linha é processada e anexada.

Você ainda poderá fazer uma atualização completa em uma extração configurada para atualização incremental se quiser atualizar toda a extração.

Para configurar a atualização incremental para uma extração de tabela:

1. Altere o tabela de Em tempo real para Extração.
2. Selecione o Menu Ações (...) na linha da tabela e selecione Extrair configurações....
3. Marque Habilitar atualização incremental.
4. Selecione uma coluna de incremento para usar ao determinar quais linhas adicionar.
5. Selecione Salvar configurações.  
    ![Extrair caixa de diálogo de configurações com atualização incremental ativada](/tableau/current/pt-br/server/pt-br/Img/vconn-extract-settings.png)

### Converter para SQL personalizado

A partir do Tableau Cloud de junho de 2024 e do Tableau Server 2024.2, você pode aproximar o SQL usado para se conectar a uma tabela e usá-lo como ponto de partida para seu próprio SQL personalizado. O SQL personalizado permite filtrar ou fazer outras alterações na consulta que podem modificar o conjunto de resultados. Criando o SQL personalizado desta forma em vez de usar Novo SQL personalizado no painel de dados tem menos impacto nas conexões virtuais existentes. Os ativos downstream veem a tabela como a mesma tabela em vez de uma nova.

Para converter uma tabela em SQL personalizado:

1. Selecione o menu Ações (...) na linha da tabela.
2. Selecione Converter para SQL personalizado.
3. Na caixa de diálogo Editar SQL personalizado, edite o SQL conforme necessário.
4. Selecione Gerar tabela.

Observação: o SQL que aparece primeiro na caixa de diálogo deve ser considerado um ponto de partida e pode não funcionar sem modificação. O editor de conexão virtual não tem informações detalhadas sobre a sintaxe SQL específica usada na conexão. Se você encontrar erros ao selecionar o botão Gerar tabela, tente remover ou alterar aspas simples, aspas duplas, aspas invertidas e colchetes para tornar o SQL compatível com o banco de dados que você está usando.

Para editar o SQL personalizado

1. Selecione o menu Ações (...) na linha da tabela.
2. Selecione Editar SQL personalizado.
3. Na caixa de diálogo Editar SQL personalizado, edite o SQL.
4. Selecione Gerar tabela.

Para retornar a tabela ao seu estado padrão, sem SQL personalizado:

1. Selecione o menu Ações (...) na linha da tabela.
2. Selecione Substituir.
3. Na caixa de diálogo substituir tabela, selecione o nome da tabela original.
4. Selecione OK.

### Extrair dados de tabela

Depois que uma ou mais tabelas forem alteradas de em tempo real para extraídas, mas ainda não foram extraídas, clique em Criar extrações pendentes (ou Executar extrações pendentes no Tableau Server 2023.3 e anterior) para executar as extrações pendentes. Depois que todas as extrações pendentes forem executadas, clique em Atualizar todas as extrações (ou Execute todas as extrações no Tableau Server 2023.3 e versões anteriores) para extrair todos os dados da tabela naquele momento.

Como alternativa, no Tableau Cloud de junho de 2024 ou no Tableau Server 2024.2 e posterior, selecione o menu Ações (...) na linha da tabela e selecione Atualizar extração.... Se a atualização incremental não estiver configurada para a tabela, você só poderá selecionar Atualizar (completo). Se a atualização incremental estiver configurada, você poderá escolher Atualizar (completo) para atualizar a extração completamente ou Atualização (incremental) para atualizar incrementalmente a extração.

Você deve executar todas as extrações pendentes antes de publicar a conexão virtual. Você não pode editar a conexão enquanto as extrações estão geradas.

Agende atualizações de extração das tabelas na sua conexão virtual, na página de conexão virtual, após publicar a conexão. Consulte [Agendar atualizações de extração para uma conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_extract.htm)

## Definir o estado de visibilidade da tabela

Use a alternância de Visibilidade na guia Tabelas para mostrar ou ocultar tabelas e seus dados dos usuários.

![Marca de verificação significa mostrar](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_check_mark_show.png) Os usuários podem ver os dados da tabela. Você pode criar uma política de dados para controlar quais dados os usuários podem ver. (Visível é o padrão.)

![X significa esconder](/tableau/current/pt-br/server/pt-br/Img/ipa_vconn_x_hide.png) Os usuários não podem ver os dados da tabela. Você pode usar tabelas ocultas em uma política de dados e como uma tabela de direitos.

## Consulte os detalhes da tabela

Clique em uma tabela na parte superior da guia Tabelas para ver seus detalhes. Você pode fazer edições simples na seção Detalhes da tabela, como alterar o nome de uma tabela, ocultar ou renomear uma coluna ou alterar um tipo de dados.

Alterne as informações da tabela que você vê usando estes ícones:

<table style="width: 100%;"><colgroup><col style="width: 30px;"><col></colgroup><tbody><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/ipa_Tag_16px_medium.png" alt="O ícone de marca representa o tipo de dados da coluna."></td><td>Uma lista de colunas na tabela e o tipo de dados de cada coluna.</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/ipa_Table_16px_medium.png" alt="O ícone da tabela representa os dados de amostra da coluna."></td><td>Dados de amostra para cada coluna e chaves vinculadas, se disponíveis. As Chaves vinculadas mostram quais colunas estão vinculadas a outras tabelas. Elas são visíveis apenas quando os bancos de dados têm informações de chave primária e externa.</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/ipa_Panes_show_16px_medium.png" alt="O ícone do perfil representa o intervalo de valores da coluna."></td><td>O intervalo de valores em um histograma para cada coluna selecionada.</td></tr></tbody></table>

Your browser does not support the video tag.

## Atualizar dados do banco de dados

Clique no ícone de atualização![O ícone de atualização na barra de ferramentas do editor de conexão virtual](/tableau/current/pt-br/server/pt-br/Img/ipa_vconns_refresh_icon.png) na barra de ferramentas para obter os dados mais recentes do banco de dados para todas as conexões em uma conexão virtual, incluindo:

- As listas de bancos de dados, tabelas e colunas. Ambas as tabelas incluídas e não incluídas em uma conexão virtual são atualizadas.
- Dados de tabela e histograma.

Para tabelas no modo ao vivo, a atualização recupera a lista mais recente de bancos de dados, tabelas e colunas e os dados mais recentes da tabela e do histograma. Para tabelas no modo de extração, a atualização recupera a lista atualizada de tabelas e colunas. Mas para ver os dados mais recentes da tabela e do histograma, você deve iniciar uma nova extração. Por exemplo, quando há uma nova coluna em uma tabela de banco de dados e você clica no ícone de atualização, a nova coluna aparece no editor, mas seus dados não. Para ver os dados mais atuais, você deve iniciar uma nova extração.

A atualização de dados invalida quaisquer dados atualmente armazenados em cache. Fechar e reabrir o editor, alternar as tabelas do modo de extração para o modo ao vivo e alterar uma credencial de conexão, como nome de usuário ou senha, também atualiza os dados.

## Quem pode fazer isso

Para criar uma conexão virtual, você deve

- ter credenciais para o banco de dados ao qual a conexão virtual se conecta e
- ser um servidor ou administrador de site ou um Creator.

## Próximas etapas

Depois que as tabelas forem adicionadas e configuradas na guia Tabelas, você pode escolher [Criar uma política de dados para segurança em nível de linha](https://help.tableau.com/current/server/pt-br/dm_vconn_create_rlspolicy.htm) ou [Publicar uma conexão virtual e definir permissões](https://help.tableau.com/current/server/pt-br/dm_vconn_publish_save.htm) .

## Consulte também

[Use um arquivo .properties para personalizar uma conexão JDBC](https://help.tableau.com/current/pro/desktop/pt-br/connect_customize.htm) — Se estiver personalizando uma conexão baseada em JDBC, você também poderá fazer personalizações em um arquivo . PROPERTY

<!-- document id=1d3ab417a801f12f833d062b2c806391f628ad21316979e482556317cd55aca9 url=/tableau/current/pt-br/server/data_stories.md -->

[Pular para o conteúdo principal](#main-content)

# Criar uma História com dados do Tableau (somente em inglês)

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Se você já escreveu um resumo executivo do painel do Tableau, então sabe que pode ser demorado. Leva tempo para escolher quais insights compartilhar, e você precisa reescrever seus resumos toda vez que os dados são atualizados. As Histórias com dados do Tableau geram automaticamente insights narrativos em seu painel, economizando tempo e apresentando insights relevantes. Conforme você explora as visualizações em seu painel, as histórias escritas pelo ajuste do Histórias de dados, permitindo que você se aprofunde nos dados e identifique insights importantes mais rapidamente.

De onde você já está trabalhando no Tableau, pode adicionar rapidamente o objeto Histórias com dados ao seu painel. E você pode personalizar os termos e métricas usados em sua história, para que Histórias de dados falem o idioma usado pela sua empresa.

Hoje, você pode escrever e visualizar uma história de dados do Tableau em qualquer lugar que usar o Tableau. Depois de criar sua história, você também poderá visualizar sua História com dados no Tableau Mobile. No entanto, as Histórias com dados não serão incluídas se você exportar seu painel, por exemplo, para um PDF.

## Entender como as histórias de dados lidam com os dados

Para escrever histórias de dados, o Tableau usa um serviço hospedado em seu ambiente Tableau Cloud ou Tableau Server. Quando você [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm) ou visualizar uma história de dados em um painel, o Tableau envia os dados da planilha associados ao ambiente ao qual você está conectado (ou seja, seu site do Tableau Cloud ou sua instância do Tableau Server), usando os padrões de segurança descritos em [Segurança na nuvem](https://help.tableau.com/current/online/pt-br/to_security.htm) e [Segurança no Tableau Server](https://help.tableau.com/current/server/pt-br/security.htm). Histórias com dados podem ser gravadas e visualizadas de qualquer lugar que você usar o Tableau.

## Saiba como as Histórias com dados são gravadas

As Histórias com dados do Tableau foram desenvolvidas com geração de linguagem natural (NLG) baseada em regras. As Histórias com dados realizam análises automatizadas para determinar fatos relevantes e precisos sobre os dados subjacentes, desde cálculos básicos até estatísticas mais avançadas. Para gravar uma história, as Histórias com dados usam uma biblioteca de modelos de linguagem predefinidos para sintetizar esses fatos em informações de linguagem natural. As Histórias com dados processam esses modelos em tempo de execução, usando os dados de resumo mais atualizados da planilha do Tableau à qual estão conectados. Você pode aproveitar o [recurso de linguagem personalizado](https://help.tableau.com/current/pro/desktop/pt-br/data_stories_customize.htm) para gerar seus próprios modelos de linguagem, adicionar funções e definir regras de negócios, ajudando você a criar uma História com dados mais relevante e contextual.

**Observação:** as Histórias com dados não usam IA generativa, modelos de linguagem grandes (LLMs) ou aprendizado de máquina para gravar informações e histórias.

## Gerenciar histórias de dados para seu site

Os administradores do Tableau podem escolher se as Histórias com dados do Tableau estão disponíveis para o site. O Histórias de dados está ativado por padrão.

1. Entre no site do Tableau.
2. No painel esquerdo, escolha **Configurações**.
3. Na guia **Geral**, role até a seção **Disponibilidade de histórias com dados**.
4. Escolha se deseja **Ativar** ou **Desativar** Histórias com dados.

**Observação:** se as Histórias com dados estiverem desativadas, reativar o recurso restaurará as Histórias com dados que já estavam nos painéis.

## Outros artigos nesta seção

<!-- document id=194e37bb95afb3e9edfe5d7a9f9969bf2924f1d84e422a71be3a065caf9fc541 url=/tableau/current/pt-br/server/server_external_repo_configure_RDS.md -->

[Pular para o conteúdo principal](#main-content)

# Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS

A partir da versão 2019.3, você pode hospedar seu Repositório externo na Plataforma AWS Cloud. Este tópico descreve como criar uma instância de banco de dados PostgreSQL RDS da AWS para usar como repositório externo do Tableau Server.

Para ver uma lista completa de hosts que você pode usar para o repositório externo, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo.htm).

## Requisitos e recomendações

- No mínimo, use uma instância com 8vCPUs e 32 GB de RAM. Esse é o tamanho mínimo recomendado para a instância do AWS RDS a ser usado no repositório externo do Tableau Server, mas os requisitos exatos variam de acordo com os requisitos e o uso. Recomendamos o uso de 16 vCPUs e 128 GB de RAM de tipos de instâncias otimizadas para memória do Amazon RDS para obter um bom desempenho.
    
    Você pode começar com um tipo de instância menor e, se posteriormente você achar que precisa de um tipo de instância maior, pode atualizar a instância RDS existente. Para obter mais informações, consulte [Atualizar a Instância de RDS](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_RDS_instance_type.htm).
    
    A comunicação segura entre o Tableau Server e a instância de banco de dados PostgreSQL externa usando conexões SSL **não** é necessária, mas recomendada.
- A instância de banco de dados PostgreSQL deve ser acessível por meio de todos os nós no cluster do Tableau Server. Uma das maneiras de fazer isso é tornar a instância de banco de dados PostgreSQL um membro de um grupo de segurança, que tenha as permissões de acesso necessárias por meio de todos os nós no cluster do Tableau Server.
- A versão do PostgreSQL deve coincidir com a versão usada pelo Tableau Server quando instalada localmente. O Tableau Server 2020.4 usa o PostgreSQL versão 12.
- O Tableau gera senhas automaticamente para uso interno por usuários internos do banco de dados. Essas senhas têm 32 caracteres e consistem em letras minúsculas e números. Eles não podem ser acessados ou configurados por um administrador. A instância externa do PostgreSQL pode permitir que você defina uma política de senha (isso dependerá da plataforma que você está usando). Se você especificar uma política que inclua tipos de caracteres diferentes de números e letras minúsculas, isso poderá causar erros ao configurar o Tableau Server para usar o repositório externo.

## Criar uma instância de banco de dados PostgreSQL no RDS da Amazon

### Etapa 1: criar um grupo de parâmetros

Os parâmetros de PostgreSQL definidos para uma instância de PostgreSQL local no arquivo _postgresql.conf_ são mantidos no grupo de parâmetros de banco de dados para a instância de banco de dados. Ao criar uma instância de banco de dados, os parâmetros no grupo de parâmetros de banco de dados associado são carregados.

Da perspectiva do Tableau Server, a maioria dos parâmetros pode ser definida como padrão. Você pode modificar os valores dos parâmetros se tiver requisitos específicos de desempenho ou registro, mas recomendamos que os parâmetros a seguir sejam deixados com os valores padrão e não sejam alterados:

- `standard_conforming_strings`
- `escape_string_warning`

Recomendamos também o valor para o `work_mem` ser definido para pelo menos 16384 para ajudar a evitar problemas de desempenho.

Para obter mais informações e uma lista completa de parâmetros de PostgreSQL, consulte [Trabalho com parâmetros de PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.html#Appendix.PostgreSQL.CommonDBATasks.Parameters) no site AWS.

### Etapa 2: criar uma instância de banco de dados PostgreSQL no RDS da Amazon

Para criar uma nova instância de banco de dados PostgreSQL, siga as instruções fornecidas no [site de documentação da Amazon](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html).

Abaixo estão as opções de configuração e os valores recomendados para a nova instância de banco de dados PostgreSQL:

- **Especificações da instância**
    
    - Usar o grupo de parâmetros criado na **Etapa 1**.
    - Use a versão compatível do PostgreSQL para a versão do Tableau Server usada. Para obter uma lista completa das versões do PostgreSQL compatíveis com as versões do Tableau Server, consulte [Compatibilidade entre produtos](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm#postgres-ts-compat).
    - Usar a classe de instância de banco de dados que é db.m4.2xlarge ou maior.
    - Alocar pelo menos 100 GB de armazenamento.
    - Tipo de armazenamento e IOPS de provisionamento: deixar padrão (as recomendações podem mudar dependendo do teste de carregamento).
- **Configurações**
    
    - Você **deve** usar **trilhas** como nome de usuário mestre.
        
        > [!IMPORTANT]
        > 
        > **Esse é um requisito para que o repositório externo funcione corretamente com o Tableau Server.**
    - Escolha uma senha que atenda aos requisitos do AWS.
- **Rede e segurança**
    
    - Verifique se a instância do RDS pode ser acessada por todos os nós do Tableau Server. Isso geralmente envolve a criação de um grupo de segurança que permite acesso a partir dos nós.
- **Opções de banco de dados**
    
    - Não crie um banco de dados inicial. O nome do Banco de dados deve ficar em branco, pois o Tableau Server criará os bancos de dados necessários na instância do RDS.
    - A porta pode ser qualquer valor, mas é recomendável deixá-la como padrão 5432.
    - Defina o Grupo de parâmetros de banco de dados como o criado na **Etapa 1**.
    - Deixe a autenticação de banco de dados IAM desabilitada.
- **Criptografia**
    
    - Você pode escolher se deseja criptografia ou não.
- **Backup**
    
    - Esta seção refere-se a backups automatizados do AWS e não a backups do Tableau Server. É possível especificar as configurações que atendem aos requisitos.
- Monitoramento
    
    - É possível especificar as configurações com base nos seus requisitos.
- **Exportações de registro**
    
    - É possível especificar as configurações com base nos seus requisitos.
- **Manutenção**
    
    - Desabilite a atualização automática da versão secundária. O Tableau Server é criado para usar uma versão específica do PostgreSQL. Você será solicitado a atualizar a versão do PostgreSQL, se necessário, durante a atualização do Tableau Server.
- **Proteção contra exclusão**
    
    - É possível especificar as configurações com base nos seus requisitos.

### Etapa 3: Obter o endpoint da instância de banco de dados PostgreSQL

Após criar a instância de banco de dados PostgreSQL, não é possível utilizá-la até que a inicialização seja concluída pelo AWS e isso pode demorar alguns minutos. Quando a instância estiver pronta, obtenha as informações do endpoint que você usará para configurar o Tableau Server para usar essa instância no repositório do Tableau Server.

### Etapa 4: baixar o arquivo de certificado SSL (arquivo .pem)

As conexões seguras entre o Tableau Server e o Repositório externo usando SSL **não** é necessária, mas recomendada.

Se quiser configurar conexões seguras entre o Tableau Server e o Repositório externo, você precisará do arquivo .perm ao configurar o Tableau Server para usar a instância DB para o seu Repositório do Tableau Server. Para obter mais informações, consulte [Uso de SSL para criptografar a conexão com a uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL).

Se você não precisa usar conexões seguras entre o Tableau Server e o Repositório externo, precisa configurar a instância RDS para permitir conexões não criptografadas.

> [!IMPORTANT]
> 
> **Importante:** se, como parte de um vencimento planejado do certificado SSL da instância RDS, você precisa atualizar sua instância RDS com o novo arquivo de certificado, você também precisa atualizar as configurações do Tableau Server para usar o novo arquivo de certificado. Você pode fazer isso ao baixar o arquivo mais recente e executar o comando _tsm topology external-services repository replace-host_ e fornecer o novo arquivo de certificado.

## Configuração de alta disponibilidade para o banco de dados PostgreSQL

O Tableau Server não gerencia ou configura a alta disponibilidade para o repositório externo. O RDS da Amazon oferece recursos de alta disponibilidade que podem ser usados para fornecer alta disponibilidade, gerenciar failover etc. Para obter mais informações, consulte a [Alta disponibilidade do RDS da Amazon](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.MultiAZ.html).

## Recuperação de desastres do banco de dados PostgreSQL

Em caso de desastre, talvez seja necessário configurar uma nova instância RDS. Há outros cenários em que você pode precisar se recuperar de um problema com a instância RDS. Por exemplo, ao atualizar o Tableau Server, também pode precisar atualizar a versão PostgreSQL na instância RDS. Caso a atualização do PostgreSQL não seja bem sucedida, pode ser necessário usar uma nova instância RDS. Nesses cenários, para configurar o Tableau Server para usar a nova instância RDS, siga as seguintes etapas:

1. **Restaurar o instantâneo em uma nova instância RDS.** O AWS não é compatível com restaurar um instantâneo em uma instância RDS existente. Para obter mais informações sobre backup e restauração de instantâneos RDS, consulte [Backup e restauração do Amazon RDS](https://aws.amazon.com/rds/details/backup/).
2. **Crie um novo arquivo de configurações JSON** contendo informações de conexão para a nova instância RDS. Para obter mais informações sobre a criação de um arquivo de configurações JSON, consulte **Etapa 1** em [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm).
3. **Use o **comando**** `tsm topology external-services repository replace-host` para direcionar o Tableau Server para a nova instância RDS.
    
    Para mais informações sobre o comando `tsm topology external-services repository replace-host`, consulte [tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm).

## Quem pode fazer isso

Somente os administradores do Tableau Server podem configurar o Tableau Server para usar o repositório externo. Você também precisará de uma conta do AWS para criar uma instância RDS.

## Próximas etapas

Para novas instalações: [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm)

Se você deseja configurar o Tableau Server existente para usar um repositório externo, consulte [Reconfigurar o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo_reconfigure.htm).

<!-- document id=f025e04e325089500042070a01973e10dae365a175c332e89cdd63b25804fcad url=/tableau/current/pt-br/server/server_external_repo_configure_Azure.md -->

[Pular para o conteúdo principal](#main-content)

# Criar uma instância PostgreSQL do banco de dados do Azure no Azure

A partir da versão 2020.4, você pode hospedar seu Repositório externo na Plataforma Azure Cloud. Este tópico descreve como criar uma instância de banco de dados do Azure para PostgreSQL para usar como repositório externo do Tableau Server.

## Requisitos e recomendações

- Recomendamos que você use servidor otimizado de memória 8 vCore com 50 GB de armazenamento para o repositório externo do Tableau Server, mas os requisitos exatos variam de acordo com suas exigências e uso. Se você já tiver um Tableau Server, avalie o uso do repositório existente para determinar as necessidades de armazenamento.
    
    Você também pode dimensionar seus recursos se achar que precisa de mais. Para obter mais informações, consulte [Dimensionamento dos recursos do Banco de Dados do Azure do PostgreSQL](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-pricing-tiers#scale-resources).
- Comunicações seguras entre o Tableau Server e a instância externa de banco de dados PostgreSQL usando o SSL são recomendadas, mas não necessárias.
    
    Se você não deseja usar conexões seguras entre o Tableau Server e o Repositório externo, deve configurar o Banco de dados do Azure para permitir conexões não criptografadas.
- A instância de banco de dados PostgreSQL deve ser acessível por meio de todos os nós no cluster do Tableau Server. A instância do banco de dados deve ser configurada para permitir conexões de todos os nós do Tableau Server. Há duas maneiras de fazer isto:
    
    - Esta é a maneira mais segura: Configure o banco de dados do Azure para a instância PostgreSQL para permitir apenas acesso privado através do endpoint do serviço de Rede Virtual. Para obter mais informações, consulte [Usar endpoints de serviço de Rede Virtual e regras para o Banco de Dados do Azure para PostgreSQL](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-data-access-and-security-vnet) e [Criar e gerenciar endpoints de serviço de VNet.](https://docs.microsoft.com/pt-br/azure/postgresql/howto-manage-vnet-using-portal)
        
        Você também pode querer rever o [tópico de visão geral](https://docs.microsoft.com/en-us/azure/virtual-network/virtual-networks-overview) nas redes virtuais do Azure.
    - Como alternativa, o Banco de dados do Azure para PostgreSQL pode ser configurado para permitir conexões de uma série de endereços IP públicos. Esse método expõe o endpoint do Banco de dados do Azure ao acesso público na Internet.
- Ao configurar a instância do Banco de dados do Azure, recomendamos o uso de **postgres** como nome de usuário do Administrador. Se você optar por usar um nome de usuário diferente, certifique-se de que ele não comece com **pg**, ou **azure**. O nome de usuário também não pode ser **rails**, **tblwgadmin,** **tableau**, **readonly** ou **tbladminviews**.
- A versão do PostgreSQL deve coincidir com a versão usada pelo Tableau Server quando instalada localmente. Para obter uma lista completa das versões do PostgreSQL compatíveis com as versões do Tableau Server, consulte [Compatibilidade entre produtos](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm#postgres-ts-compat).
- O Tableau gera senhas automaticamente para uso interno por usuários internos do banco de dados. Essas senhas têm 32 caracteres e consistem em letras minúsculas e números. Eles não podem ser acessados ou configurados por um administrador. A instância externa do PostgreSQL pode permitir que você defina uma política de senha (isso dependerá da plataforma que você está usando). Se você especificar uma política que inclua tipos de caracteres diferentes de números e letras minúsculas, isso poderá causar erros ao configurar o Tableau Server para usar o repositório externo.

## Criar uma instância de banco de dados PostgreSQL no Azure

### Etapa 1: criar uma sub-rede delegada para o Banco de dados do Azure para instância do PostgreSQL

Essa etapa é um pré-requisito para configurar o acesso privado para sua opção de rede, quando você criar a instância. Configurar acesso privado ao banco de dados é essencial para comunicações seguras. Isso permite que as máquinas virtuais criadas em qualquer lugar dessa Rede virtual se conectem à instância do banco de dados, o que não ocorre com as máquinas virtuais fora da Rede virtual.

Na mesma rede virtual onde você está hospedando seu Tableau Server, crie uma nova sub-rede delegada para a instância do Banco de dados do Azure. Para obter mais informações sobre a configuração de acesso privado, consulte [Opções de rede para banco de dados do Azure para PostgreSQL – Servidor flexível](https://docs.microsoft.com/pt-br/azure/postgresql/flexible-server/concepts-networking#private-access-vnet-integration) no site do Azure.

### Etapa 2: criar uma instância de Banco de dados do Azure para PostgreSQL

Para criar um novo Banco de dados do Azure para PostgreSQL, siga as instruções fornecidas no [site de documentação do Azure](https://docs.microsoft.com/pt-br/azure/postgresql/flexible-server/quickstart-create-server-portal).

Abaixo estão as opções de configuração e os valores necessários e nossas recomendações para a nova instância do repositório PostgreSQL:

- **Detalhes do servidor**
    
    - Especifique Nenhum como a Fonte de dados para criar um novo servidor.
    - Para o nome de usuário Administrador, recomendamos o uso de **postgres** como nome de usuário do Administrador. Se você optar por usar um nome de usuário diferente, certifique-se de que ele não comece com **pg**, ou **azure**. O nome de usuário também não pode ser **rails**, **tblwgadmin,** **tableau**, **readonly** ou **tbladminviews**.
    - Escolha uma senha que atenda aos requisitos do Azure.
    - Use a versão compatível do PostgreSQL para a versão do Tableau Server usada. Para obter uma lista completa das versões do PostgreSQL compatíveis com as versões do Tableau Server, consulte [Compatibilidade entre produtos](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm#postgres-ts-compat).
    - Alocar pelo menos 512GB de armazenamento.
    - As extensões uuid-ossp e unaccent devem ser permitidas para uso por usuários "azure\_pg\_admin" no Banco de dados do Azure para PostgreSQL.
- **Computação e armazenamento**
    
    - No mínimo, use o Servidor flexível com nível de computador de propósito geral e tamanho de computador Standard\_D8s\_v3 (8 vCores, 32 GB de RAM).
- **Opções de rede**
    
    - Selecione Acesso privado (Rede virtual). Isso garante comunicações privadas e seguras para o banco de dados.
- Alta disponibilidade
    
    - Habilite a opção de alta disponibilidade de acordo com seus requisitos.
- **Backup**
    
    - Defina o período de retenção de acordo com seus requisitos. Esta seção refere-se a backups automatizados do Azure e não a backups do Tableau Server. É possível especificar as configurações que atendem aos requisitos.

### Etapa 3: configurar uma regra de firewall em nível de servidor

Uma vez criado o banco de dados, configure uma regra de firewall em nível de servidor para permitir o acesso aos nós do Tableau Server.

Verifique se a instância do banco de dados pode ser acessada por todos os nós do Tableau Server usando a sub-rede dedicada descrita na Etapa 1.

### Etapa 4: configurar a instância do banco de dados do Azure para PostgreSQL.

Da perspectiva do Tableau Server, a maioria dos valores de parâmetros da instância pode ser definida como padrão. Você pode modificar os valores dos parâmetros se tiver requisitos específicos de desempenho ou registro, mas recomendamos que os parâmetros a seguir sejam deixados com os valores padrão e não sejam alterados:

- `standard_conforming_strings`
- `escape_string_warning`

Recomendamos também o valor para o `work_mem` ser definido para pelo menos 16384 para ajudar a evitar problemas de desempenho.

Para obter informações sobre como configurar parâmetros do servidor, consulte esta [documentação do Azure](https://docs.microsoft.com/pt-br/azure/postgresql/howto-configure-server-parameters-using-portal#viewing-and-editing-parameters).

### Etapa 5: obter o endpoint da instância de banco de dados PostgreSQL

Quando a instância estiver pronta, obtenha as informações do endpoint que você usará para configurar o Tableau Server para usar essa instância no repositório do Tableau Server.

### Etapa 6: baixar o arquivo de certificado SSL

As comunicações seguras entre o Tableau Server e o Repositório externo usando SSL **não** é necessária, mas recomendada.

Se você deseja configurar conexões seguras entre o Tableau Server e o Repositório externo, baixe o arquivo de certificado: Você precisará desse arquivo de certificado ao configurar o Tableau Server para usar este repositório externo. Para obter mais informações, consulte [Configurar a conectividade TLS no banco de dados do Azure para PostgreSQL](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-ssl-connection-security).

Se você não precisa usar conexões seguras entre o Tableau Server e o Repositório externo, configure o Banco de dados do Azure para permitir conexões não criptografadas.

## Configuração de alta disponibilidade para o banco de dados PostgreSQL

O Tableau Server não gerencia ou configura a alta disponibilidade para o repositório externo. O Azure oferece recursos de alta disponibilidade que podem ser usados para fornecer alta disponibilidade. Para obter mais informações, consulte [Alta disponibilidade do Banco de dados do Azure](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-hyperscale-high-availability).

## Recuperação de desastres do banco de dados PostgreSQL

Em caso de desastre, talvez seja necessário configurar uma nova instância do Banco de dados do Azure para PostgreSQL. Há outros cenários em que você pode precisar se recuperar de um problema com a instância do banco de dados. Nesses cenários, para configurar o Tableau Server para usar a nova instância do banco de dados do Azure, siga as seguintes etapas:

1. **Restaurar o backup para uma nova instância do Banco de dados do Azure.** No Banco de dados do Azure para PostgresQL, realizar uma restauração cria um novo servidor com base nos backups do servidor original. Para obter mais informações sobre o backup e a restauração do banco de dados do Azure para PostgreSQL, consulte [Backup e restauração do Banco de Dados do Azure para PostgreSQL.](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-backup)
2. **Crie um novo arquivo de configurações JSON** com informações de conexão para a instância do Banco de dados do Azure para PostgreSQL. Para obter mais informações sobre a criação de um arquivo de configurações JSON, consulte **Etapa 1** em [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm).
3. **Use o comando** `tsm topology external-services repository replace-host` para apontar o Tableau Server para a nova instância do Banco de dados do Azure para PostgreSQL.
    
    Para mais informações sobre o comando `tsm topology external-services repository replace-host`, consulte [tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm).

## Quem pode fazer isso

Somente os administradores do Tableau Server podem configurar o Tableau Server para usar o repositório externo. Você também precisará de uma conta do Azure para criar um Banco de dados do Azure.

## Próximas etapas

Para novas instalações: [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm)

Se você deseja configurar o Tableau Server existente para usar um repositório externo, consulte [Reconfigurar o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo_reconfigure.htm).

<!-- document id=7a39bac85a13d0926a91b4e51b2d4087b408f4b085b4e2877da45244ec7bc01b url=/tableau/current/pt-br/server/server_external_repo_configure_gcp.md -->

[Pular para o conteúdo principal](#main-content)

# Criar uma instância PostgreSQL no Google Cloud

A partir da versão 2021.4, você pode hospedar seu Repositório externo do Tableau Server na Google Cloud Platform. Este tópico descreve como criar uma instância de PostgreSQL no Google Cloud para usar como repositório externo do Tableau Server.

Para ver uma lista completa de hosts que você pode usar para o repositório externo, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo.htm).

## Requisitos e recomendações

- No mínimo, use o tipo de máquina de alta memória com 8vCPUs e 32 GB de RAM. Esse é o tamanho mínimo recomendado para a instância do PostgreSQL a ser usado no repositório externo do Tableau Server, mas os requisitos exatos variam de acordo com os requisitos e o uso. Recomendamos o tipo de instância de alta memória com 16 vCPUs e 128 GB de RAM para um bom desempenho na maioria dos cenários.
- A comunicação segura entre o Tableau Server e a instância de banco de dados PostgreSQL externa usando conexões SSL não é necessária, mas recomendada.
- A instância de PostgreSQL deve ser acessível por meio de todos os nós no cluster do Tableau Server. Uma das maneiras de fazer isso é tornar a instância de banco de dados PostgreSQL um membro de um grupo de segurança, que tenha as permissões de acesso necessárias por meio de todos os nós no cluster do Tableau Server.
- A versão do PostgreSQL instalada precisa usar uma versão compatível. Para obter mais informações, consulte [Compatibilidade entre produtos](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm#postgres-ts-compat) para obter informações sobre as versões compatíveis.
- O Tableau gera senhas automaticamente para uso interno por usuários internos do banco de dados. Essas senhas têm 32 caracteres e consistem em letras minúsculas e números. Eles não podem ser acessados ou configurados por um administrador. A instância externa do PostgreSQL pode permitir que você defina uma política de senha (isso dependerá da plataforma que você está usando). Se você especificar uma política que inclua tipos de caracteres diferentes de números e letras minúsculas, isso poderá causar erros ao configurar o Tableau Server para usar o repositório externo.

## Criar uma instância PostgreSQL do banco de dados no Google Cloud

### Etapa 1: criar uma nova instância PostgreSQL

Crie uma instância PostgreSQL usando as instruções fornecidas no site do Google, [aqui](https://cloud.google.com/sql/docs/postgres/create-instance).

Recomendamos o uso de um tipo de máquina com muita memória, com 16 vCPUs e 128 GB de RAM.

### Etapa 2: configurar sinalizadores de banco de dados para sua instância PostgreSQL

Da perspectiva do Tableau Server, a maioria dos valores de parâmetros da instância pode ser definida como padrão. Você pode modificar os valores dos parâmetros se tiver requisitos específicos de desempenho ou registro, mas recomendamos que os parâmetros a seguir sejam deixados com os valores padrão e não sejam alterados:

- `standard_conforming_strings`
- `escape_string_warning`

Recomendamos também o valor para o `work_mem` ser definido para pelo menos 16384 para ajudar a evitar problemas de desempenho.

Para obter mais informações sobre sinalizadores de banco de dados, consulte [este tópico](https://www.google.com/url?q=https://cloud.google.com/sql/docs/postgres/flags&sa=D&source=docs&ust=1635271250753000&usg=AOvVaw1dZNOfdZ1CEnSfup_wasnb) no site do Google.

### Etapa 3: obter o endpoint da instância de banco de dados PostgreSQL

Quando a instância estiver pronta, obtenha as informações do endpoint que você usará para configurar o Tableau Server para usar essa instância no repositório do Tableau Server.

### Etapa 4: baixar o arquivo de certificado SSL

As comunicações seguras entre o Tableau Server e o Repositório externo usando SSL não é necessária, mas recomendada.

Para configurar conexões seguras entre o Tableau Server e o Repositório externo, você precisará usar o arquivo de certificado ao configurar o Tableau Server para usar este repositório externo. Para obter mais informações, consulte [Configuração de certificados de SSL/TLS](https://www.google.com/url?q=https://cloud.google.com/sql/docs/postgres/configure-ssl-instance&sa=D&source=docs&ust=1635271250769000&usg=AOvVaw3YRZJ0JQdXSkhNjdOxhuww) no site do Google.

## Configuração de alta disponibilidade para o banco de dados PostgreSQL

O Tableau Server não gerencia ou configura a alta disponibilidade para o repositório externo. O Google Cloud oferece recursos de alta disponibilidade que podem ser usados para fornecer alta disponibilidade. Para obter mais informações, consulte a [Habilitar a disponibilidade alta em uma instância](https://cloud.google.com/sql/docs/postgres/configure-ha) no site do Google.

## Recuperação de desastres do banco de dados PostgreSQL

Em caso de desastre, talvez seja necessário configurar um novo banco de dados do PostgreSQL para a instância do PostgreSQL. Há outros cenários em que você pode precisar se recuperar de um problema com a instância do banco de dados. Nesses cenários, para configurar o Tableau Server para usar a nova instância do PostgreSQL, siga as seguintes etapas:

1. **Restaure o backup para uma nova instância do PostgreSQL.** Na plataforma Google Cloud, você pode optar por restaurar para a mesma instância ou criar uma nova instância. Para obter mais informações, consulte a [Restaurar uma instância](https://cloud.google.com/sql/docs/postgres/backup-recovery/restoring) no site do Google.  
    
    Recomendamos criar uma nova instância e executar as etapas a seguir para recuperá-la.
2. Se isso for uma nova instância, **Crie um novo arquivo de configurações JSON** com informações de conexão para a instância do Banco de dados do Azure para PostgreSQL. Para obter mais informações sobre a criação de um arquivo de configurações JSON, consulte **Etapa 1** em [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm).
3. **Use o comando** `tsm topology external-services repository replace-host` para apontar o Tableau Server para a nova instância do Banco de dados do Azure para PostgreSQL.
    
    Para mais informações sobre o comando `tsm topology external-services repository replace-host`, consulte [tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm).

## Quem pode fazer isso

Somente os administradores do Tableau Server podem configurar o Tableau Server para usar o repositório externo. Você também precisará de uma conta do Google Cloud para criar a instância do banco de dados PostgreSQL.

## Próximas etapas

Para novas instalações: [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm)

Se você deseja configurar o Tableau Server existente para usar um repositório externo, consulte [Reconfigurar o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo_reconfigure.htm).

<!-- document id=40bfd27515c9998e7c99ec520c6b024cb7e4813d79a5898d4f4feb6845a3c7cc url=/tableau/current/pt-br/server/dm_vconn_create_rlspolicy.md -->

[Pular para o conteúdo principal](#main-content)

# Criar uma política de dados para segurança em nível de linha

Use uma política de dados para aplicar segurança em nível de linha a uma ou mais tabelas na conexão virtual. Uma política de dados filtra os dados, garantindo que os usuários vejam apenas os dados que deveriam ver. As políticas de dados se aplicam a conexões em tempo real e de extração.

## Sobre políticas de dados

Uma política de dados tem três componentes:

![Um exemplo dos três componentes de uma política de dados no editor de conexão virtual](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_policy_components.png)

1. As tabelas às quais se aplica, chamadas de tabelas de políticas. Essas são as tabelas filtradas.
2. As colunas mapeadas que definem os relacionamentos entre tabelas (por exemplo, entre tabelas de direitos e de fatos) e entre colunas de tabela e de política. Uma coluna de política é a usada para filtrar dados.
3. A condição da política, que é uma expressão ou cálculo avaliado para cada linha no momento da consulta. Se a condição da política for TRUE, a linha será mostrada na consulta.

Ao criar uma política de dados, você precisa de uma coluna para filtrar os dados. Essa coluna é chamada de coluna de política. Os dados são filtrados pela condição da política, geralmente usando uma função do usuário, como USERNAME() ou FULLNAME().

Se sua tabela de políticas inclui uma coluna que você pode filtrar, use essa coluna como sua coluna de políticas.

Quando uma tabela de política não inclui essa coluna, use uma tabela de direitos com uma coluna que você pode usar para filtrar os dados. Uma tabela de direitos é uma tabela que inclui uma coluna de política que você pode usar para filtrar tabelas de política, e outra coluna que você pode relacionar (mapear) a uma coluna em uma tabela de política (conforme mostrado na imagem de exemplo de política de dados acima).

## Filtrar com uma coluna de política de uma tabela de política

A maneira mais comum de filtrar dados é usar uma coluna na tabela que contém os dados que você deseja filtrar. Use essa coluna como uma coluna de política e, em seguida, mapeie as colunas de tabela apropriadas para a coluna de política.

Para usar uma coluna de política para filtrar seus dados, primeiro, adicione tabelas à política no painel esquerdo. Para adicionar uma tabela, execute um dos seguintes procedimentos:

- Clique duas vezes no nome da tabela.
- Clique na seta suspensa perto do nome da tabela e selecione Gerenciar tabela com política.
- Ou arraste a tabela para a direita e solte-a na Adicionar como tabela de política.

Depois que uma tabela é adicionada a uma política, um ícone de escudo ![Ícone de política de dados](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_shield_18.png) aparece à direita do nome da tabela no painel esquerdo, indicando que é uma tabela de política.

Em seguida, mapeie as colunas para criar um relacionamento entre o nome da coluna na tabela e o nome da coluna de política. Use o nome da coluna da política na condição da política de dados para controlar o acesso aos dados no nível da linha para os usuários:

1. Clique em +Adicionar coluna ao mapa para adicionar uma ou mais colunas que você usará para filtrar os dados.
2. Nomeie a coluna de política. Você usará esse nome na condição da política.
3. Para cada tabela à qual a política se aplica, use o menu suspenso para selecionar a coluna da tabela que mapeia para a coluna da política.
4. Repita esse processo para quantas colunas de política você deseja usar na condição de política.

Your browser does not support the video tag.

> [!TIP]
> 
> **Dica:** em vez de usar o botão +Adicionar coluna ao mapa, você pode começar a digitar o cálculo na área de condição da política e usar o preenchimento automático para escolher o nome da coluna, que então preencherá as informações da coluna da política na Etapa 1.

Your browser does not support the video tag.

### Um exemplo usando uma coluna de política de uma tabela de política

![Diagrama de uma política de dados que usa uma coluna de política de uma tabela de política para filtrar dados](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_policy_table_diagram.png)

1. A tabela Vendas tem uma coluna \[Vendedor\] e a tabela Região possui uma coluna \[RepVendas\]. Os dados de Vendedor e RepVendas correspondem ao nome completo dos usuários do Tableau em seu site.
2. Você quer filtrar os dados de Vendas e Região por Vendedor, então nomeie a coluna de política "Vendedor" e, em seguida, mapeie a coluna Vendedor de Vendas e a coluna RepVendas de Região para a coluna de política Vendedor.
3. Em seguida, escreva a condição de política para filtrar ambas as tabelas. Use a coluna de política \[Vendedor\] e a função de usuário FULLNAME() para que cada usuário possa ver apenas seus próprios dados.

## Filtrar com coluna de política de uma tabela de direitos

As tabelas de direitos são usadas quando sua tabela de políticas não contém uma coluna pela qual você pode filtrar. Você pode usar a tabela de direitos para mapear uma coluna na tabela de dados para uma coluna na tabela de direitos. Observe o seguinte:

- Certifique-se de incluir a tabela de direitos como uma tabela na conexão virtual. Você pode usar uma tabela de qualquer conexão ou banco de dados como uma tabela central de direitos que protege tabelas em muitos outros bancos de dados. Em alguns casos, uma tabela de direitos que está no mesmo banco de dados das tabelas que você está protegendo pode ser um risco de segurança em potencial devido ao potencial de expor dados de funcionários. E ter uma tabela de direitos em um banco de dados diferente pode facilitar o controle de permissões, por exemplo, conceder a alguém acesso a um banco de dados.
- Se não quiser que os usuários de conexão virtual vejam a tabela de direitos, você pode alternar a configuração na coluna Visibilidade na guia Tabelas para ocultá-la. Quando oculta, a tabela de direitos ainda está disponível para filtragem de política, mas não pode ser usada em visualizações ou fontes de dados de pasta de trabalho.

**Observação**: a conexão direta a uma saída de fluxo (arquivo .hyper) não é compatível com a tabela de direitos. A saída do fluxo deve gravar diretamente no banco de dados.

Para usar uma tabela de direitos para filtrar seus dados:

1. Adicione as tabelas de dados às quais deseja que a política de dados se aplique. Execute um destes procedimentos:
    - Clique duas vezes no nome da tabela.
    - Clique na seta suspensa perto do nome da tabela e selecione Gerenciar tabela com política.
    - Ou arraste a tabela para a direita e solte-a na Adicionar como tabela de política.
2. Depois que uma tabela é adicionada a uma política, um ícone de escudo ![Ícone de política de dados](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_shield_18.png) aparece à direita do nome da tabela no painel esquerdo, indicando que é uma tabela de política.
3. Selecione a tabela de direitos e:
    - Clique na seta suspensa e selecione Usar como tabela de direito.
    - Ou arraste a tabela para a direita e solte-a em Adicionar como tabela de direito.
4. Para cada tabela à qual a política se aplica, clique no menu suspenso e selecione a coluna para mapear a tabela na política para a tabela de direitos.
    
    Your browser does not support the video tag.

### Um exemplo usando uma coluna de política de uma tabela de direitos

![Diagrama de uma política de dados que usa uma coluna de política de uma tabela de direitos para filtrar dados](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_entitlement_diagram.png)

1. Os dados que você deseja filtrar têm uma coluna EMP\_ID, mas não uma coluna de nome de funcionário. No entanto, você tem uma segunda tabela que inclui colunas para EMP\_ID e FULL NAME do funcionário. E os valores na coluna FULL NAME do funcionário correspondem ao nome completo dos usuários do Tableau em seu site.
2. Você pode adicionar a tabela Funcionários à política como uma tabela de direitos e, em seguida, mapear o nome da coluna da tabela de políticas EMP\_ID para o nome da coluna de direitos EMP\_ID de cada tabela.
3. Em seguida, use a função FULLNAME() na condição de política para combinar o nome completo do usuário do Tableau Server com a coluna \[FULL NAME\] da tabela de direitos (que é a coluna de política) para que cada usuário possa ver apenas os próprios dados.

## Escrever uma condição de política

A última etapa na criação de uma política de dados é escrever uma condição de política, que é um cálculo ou expressão usada para definir o acesso em nível de linha. As condições de política costumam ser usadas para limitar o acesso a usuários ou grupos por meio de funções de usuário.

Uma condição de política:

- É obrigatório em uma política de dados.
- Deve ser avaliada como verdadeira ou falsa.
- Mostra as linhas quando a condição da política é verdadeira.

Quando você fecha uma guia de política, ela não descarta seu trabalho.

### Exemplos de condições de política

Mostra apenas as linhas em que o valor da coluna Região é Norte:

`[Region] = "North"`

Permite que um usuário conectado veja as linhas em que o nome do usuário corresponde ao valor em EmployeeName:

`FULLNAME() = [EmployeeName]`

Permite que os membros do grupo Gerentes vejam todas as linhas, enquanto os usuários podem ver apenas as linhas em que seu nome de usuário corresponde ao valor na coluna employee\_name:

`ISMEMBEROF('Managers') OR USERNAME() = [employee_name]`

### Funções do Tableau compatíveis com condições de política

As condições de política são compatíveis com um subconjunto de funções do Tableau:

- Lógico (exceto relacionado a nulos)
- Cadeia de caracteres
- Usuário
- Data
- Número: MIN, MID, MAX

Para ver quais funções específicas são suportadas, no editor de conexão virtual, na guia Políticas de Dados, consulte o painel Referência à direita.

**Observação**: se a conexão virtual tiver uma política de dados que contenha [funções do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm) (por exemplo, `USERNAME()`) e você se conecta a ela de uma pasta de trabalho ou fonte de dados e cria uma extração lá, a extração conterá apenas as linhas que correspondem à política de dados de conexão virtual no momento em que a extração é criada. Para aproveitar uma conexão virtual com funções de usuário na política de dados, use uma conexão ativa da pasta de trabalho ou fonte de dados para a conexão virtual em vez de uma extração.

## Quem pode fazer isso

Para criar uma política de dados, você deve

- ter credenciais para o banco de dados ao qual a conexão virtual se conecta e
- ser um servidor ou administrador de site ou um Creator.

## Próximas etapas

Depois de criar uma política de dados, a próxima etapa é verificar se ela funciona conforme o esperado. Consulte [Testar a segurança em nível de linha com visualização como usuário](https://help.tableau.com/current/server/pt-br/dm_vconn_test_preview.htm) . Ou, se você estiver pronto para compartilhar a conexão virtual e suas políticas de dados com outras pessoas, consulte [Publicar uma conexão virtual e definir permissões](https://help.tableau.com/current/server/pt-br/dm_vconn_publish_save.htm).

## Recursos

Para obter informações detalhadas sobre cálculos, consulte [Como entender os cálculos no Tableau](https://help.tableau.com/current/pro/desktop/pt-br/calculations_calculatedfields_understand.htm) no Tableau Desktop e na ajuda de Criação na Web.

Para obter informações sobre as funções do usuário, consulte [Funções do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm) no Tableau Desktop e na ajuda de Criação na Web.

Para obter informações sobre outras opções de segurança em nível de linha no Tableau, consulte [Visão geral das opções de segurança em nível de linha no Tableau](https://help.tableau.com/current/server/pt-br/rls_options_overview.htm) na ajuda do Tableau Server.

<!-- document id=c5a83011bfc822c253ca583ad27a45088b051714359853ca4fa9d2d52fffc8e7 url=/tableau/current/pt-br/server/security_ear.md -->

[Pular para o conteúdo principal](#main-content)

# Criptografia de extrações em repouso

A criptografia de extrações em repouso é um recurso de segurança que permite que você criptografe extrações .hyper enquanto elas estão armazenadas no Tableau Server.

Os administradores do Tableau Server podem aplicar a criptografia de todas as extrações no site ou permitir que os usuários especifiquem a criptografia de todas as extrações associadas a determinadas pastas de trabalho ou fontes de dados publicadas.

## Limitações

Antes de serem criptografadas, as extrações de arquivos .tde mais antigas devem ser atualizadas para extrações de arquivos .hyper. Isso acontece automaticamente como parte do trabalho de criptografia. Para obter mais informações sobre o impacto da atualização de extração, consulte [Atualização de extrações para o formato .hyper](https://help.tableau.com/current/server/pt-br/extracting_upgrade.htm).

Os arquivos temporários e os arquivos de cache não são criptografados em repouso com esse recurso.

As pastas de trabalho (.twb) e os arquivos de fonte de dados (.tds) não são criptografados com esse recurso. Esses arquivos conterão metadados como nomes de coluna e instruções de formatação da tabela do banco de dados. Em alguns casos, eles podem conter alguns dados da fileira se estiverem incluídos nos filtros. 

Outros arquivos de dados, como arquivos Excel ou JSON, não são criptografados com esse recurso, a menos que sejam convertidos em extrações antes de serem publicados.

Quando as extrações são baixadas do servidor, elas são descriptografadas.

## Visão geral do desempenho

### Aumento no carregamento do processador em segundo plano

É possível ver um aumento leve a moderado no carregamento do processador em segundo plano, ao ativar a criptografia em repouso. A criptografia e a descriptografia são operações extremamente intensivas. A criptografia em repouso altera as tarefas atuais do processador em segundo plano e apresenta novos trabalhos a serem executados no processador em segundo plano. O aumento geral no carregamento do processador em segundo plano depende do número e do tamanho das extrações afetadas e da frequência com que os cenários abaixo se aplicam.

- **Publicação inicial**: ao publicar pastas de trabalho ou fontes de dados usando extrações que devem ser criptografadas, a criptografia ocorre nos processadores em segundo plano do servidor.
- **Atualizações de extração do Tableau Server**: atualizações completas e incrementais de extrações criptografadas no Tableau Server consumirão a CPU um pouco mais.
- **Atualizações de extração do Tableau Bridge e aplicativos de terceiros (por exemplo, Informática, Alteryx)**: esses fluxos exigirão novos trabalhos de criptografia, agendados nos processadores em segundo plano para qualquer extração atualizada, resultando em um aumento leve a moderado no carregamento do processador em segundo plano.
- **Criptografia e descriptografia de extrações em pastas de trabalho e fontes de dados já publicadas**: se a configuração do site para criptografia em repouso estiver definida como **Habilitar**, os usuários poderão optar por criptografar ou descriptografar extrações em pastas de trabalho e fontes de dados já publicadas no Tableau Server. Dependendo do número e do tamanho das extrações, isso causará um amento leve a moderado no carregamento dos processadores em segundo plano.
- **Alteração do modo de criptografia de um site**: ao alterar a configuração de um site para criptografia em repouso para **Desabilitar** ou **Aplicar**, o processador em segundo plano descriptografará ou criptografará todas as extrações existentes no site, respectivamente. Dependendo do número e do tamanho das extrações, isso pode aumentar significativamente o carregamento nos processadores em segundo plano até que todas as extrações sejam descriptografadas ou criptografadas.
- **Encaminhamento das chaves de criptografia**: O encaminhamento das chaves de criptografia faz com que os processadores em segundo plano criptografem novamente todas as extrações existentes publicadas nesse site, usando novas chaves de criptografia. Dependendo do número e do tamanho das extrações, isso pode aumentar significativamente o carregamento nos processadores em segundo plano até que todas as extrações sejam criptografadas novamente.

Se estiver operando na capacidade ou acima, considere:

- Incluir processos e recursos adicionais do processador em segundo plano.
- Deixar que os usuários criptografem pastas de trabalho e fontes de dados individuais, em vez de impor a criptografia para todo o site ou desabilitar a criptografia em repouso para sites onde isso não é necessário. Observe que as atualizações de extração agendadas e ad hoc prevalecerão sobre os trabalhos de criptografia e descriptografia.

### Aumento no tempo de carregamento e carga de trabalho da visualização

O desempenho da consulta, por exemplo, ao carregar ou interagir com uma visualização ou painel, exigirá que os dados sejam descriptografados uma vez, quando carregados do disco para a memória. Isso resultará em um pequeno aumento no tempo de carregamento e no consumo da CPU em nós de trabalho para o primeiro usuário que carregar uma pasta de trabalho. Isso não afetará os outros usuários que acessarem essas pastas de trabalho ao mesmo tempo, pois os dados já estarão descriptografados na memória.

### Impacto no backup e na restauração

As extrações criptografadas nos backups permanecem criptografadas. O tamanho dos arquivos de backup (.tbks) pode aumentar até 50-100% devido à ineficiência da compactação em extrações criptografadas. O aumento de tamanho depende do número de extrações criptografadas, entre outros fatores. O tempo para restaurar um backup que contém extrações criptografadas pode aumentar ligeiramente devido ao tempo de troca das chaves de criptografia.

Se a instalação do Tableau Server tiver muitas ou somente extrações criptografadas, considere desabilitar a compactação durante os backups para melhorar significativamente o tempo. Para saber mais sobre o backup do TSM backup, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm).

## Aplicar criptografia em repouso em um site

Os administradores do Tableau Server podem aplicar a criptografia de todas as extrações no site.

1. Em um navegador da Web, entre no Tableau Server como administrador do servidor.
2. Vá para o site que deseja configurar.
3. Clique em **Configurações**.
4. Role para baixo até a seção Criptografia de extração em repouso.  
    Clique em **Aplicar** para criptografar todas as extrações publicadas e armazenadas no site.  
    A criptografia de todas as extrações existentes armazenadas no site pode demorar alguns instantes.
5. Clique em **Salvar**

## Habilitar criptografia em repouso em um site

Os administradores do Tableau Server podem permitir que os usuários especifiquem a criptografia de todas as extrações associadas a determinadas pastas de trabalho ou fontes de dados publicadas.

1. Em um navegador da Web, entre no Tableau Server como administrador do servidor.
2. Vá para o site que deseja configurar.
3. Clique em **Configurações**.
4. Role para baixo até a seção Criptografia de extração em repouso.
5. Clique em **Habilitar** para permitir que os usuários criptografem opcionalmente as extrações no site.  
    A alteração para Habilitar cancelará os trabalhos pendentes de descriptografia e criptografia. Os trabalhos de criptografia não são criados.
6. Clique em **Salvar**

## Desabilitar criptografia em repouso em um site

1. Em um navegador da Web, entre no Tableau Server como administrador do servidor.
2. Vá para o site que deseja configurar.
3. Clique em **Configurações**.
4. Role para baixo até a seção Criptografia de extração em repouso.
5. Clique em **Desabilitar** para impedir extrações criptografadas no site.  
    Alterar para Desabilitar descriptografará todas as extrações criptografadas existentes. A descriptografia de todas as extrações armazenadas no site pode demorar alguns instantes.
6. Clique em **Salvar**

## Exibir modo de criptografia de extração para todos os sites

1. Em um servidor de vários sites, clique em Gerenciar todos os sites no menu do site.
    
    **Observação:** a opção Gerenciar todos os sites é exibida apenas quando você está conectado como administrador do servidor.
2. Clique em Sites.
3. O modo de criptografia de cada site é exibido na coluna **Criptografia de extração em repouso**.

## Criptografar ou descriptografar extrações para uma pasta de trabalho ou fonte de dados publicada

**Observação**: a opção de criptografar ou descriptografar as extrações associadas a uma pasta de trabalho ou fonte de dados publicada específica está disponível somente quando a configuração do site para criptografia em repouso está definida como **Habilitar**. Quando um site é definido como Desabilitar, todo o conteúdo não é criptografado. Quando um site é definido como Aplicar, todo o conteúdo é criptografado.  
**Observação:** você deve ser o proprietário ou administrador.

1. Vá para a página de pasta de trabalho ou fonte de dados publicada.
2. Clique no menu suspenso que diz **Extração criptografada** ou **Extração descriptografada**.
3. Selecione **Descriptografada**.  
    Você verá a seguinte mensagem: “Descriptografia de extração”.  
    \-ou-  
    Selecione **Criptografada**.  
    Um trabalho de criptografia é iniciado.

Como alternativa, é possível criptografar ou descriptografar extrações no menu de ação de exibição do cartão, menu de ação de exibição de lista e menu de ação na seção de cabeçalho.

## Criptografar ou descriptografar vários itens

1. Vá para a página Fontes de dados.
2. Marque a caixa de seleção ao lado de uma ou mais fontes de dados.
3. No lado superior esquerdo da página da Fontes de dados, clique em **Ações**.
4. Clique em **Criptografar** ou **Descriptografar**.

## Exibir status de criptografia de um único item

1. Faça logon em um site.
2. Vá para a página de uma única fonte de dados.  
    \-ou-  
    Vá para uma página de uma única pasta de trabalho para uma pasta de trabalho com fontes de dados incorporadas.
3. O status da criptografia é exibido na página.

## Filtrar fontes de dados por status de criptografia

1. No site, clique em **Explorar**.
2. No canto superior direito, clique no menu suspenso Explorar: projetos de nível superior e selecione **Todas as fontes de dados**.
3. Clique no ícone de filtro.
4. Role para baixo até a seção “Em tempo real ou extração” e selecione uma opção de filtro: Todos, Em tempo real, Extrações, Extrações descriptografadas, Extrações criptografadas, Criptografia atual ou Descriptografia atual.
5. Marque a caixa de seleção ao lado de "Incluir arquivos .tde e .hyper" se quiser incluir as conexões "Em tempo real para arquivo .tde" e “Em tempo real para arquivo .hyper” nos resultados do filtro.

## Filtrar pastas de trabalho por status de criptografia

1. No site, clique em **Explorar**.
2. No canto superior direito, clique no menu suspenso Explorar: projetos de nível superior e selecione **Todas as pastas de trabalho**.
3. Clique no ícone de filtro.
4. Role para baixo até a seção “Em tempo real ou extração” e selecione uma opção de filtro: Todos, Em tempo real, Extrações, Publicadas, Extrações descriptografadas, Extrações criptografadas, Criptografia atual ou Descriptografia atual.
5. Marque a caixa de seleção ao lado de "Incluir arquivos .tde e .hyper" se quiser incluir as conexões "Em tempo real para arquivo .tde" e “Em tempo real para arquivo .hyper” nos resultados do filtro.  
    As pastas de trabalho com menos uma conexão correspondente à seleção do filtro serão exibidas.

## Exibir status das tarefas em segundo plano para criptografar ou descriptografar extrações

1. No site, clique em **Status do site**.
2. Clique em **Tarefas em segundo plano para não extrações**, para ver os detalhes das tarefas em segundo plano concluídas e pendentes.  
    Observação: **tarefas em segundo plano para não extrações** incluem todas as tarefas que não estão relacionadas a atualizações de extração, portanto, inclui os trabalhos de criptografia.
3. No menu Tarefa, selecione **Criptografar extrações** ou **Descriptografar extrações** e clique em **Aplicar**.
4. No menu Intervalo de tempo, selecione um intervalo.  
    Você verá as tarefas em segundo plano para "Criptografar extrações" ou "Descriptografar extrações" para todas as fontes de dados e pastas de trabalho publicadas de acordo com a extração.

## O utilitário tabcmd

O utilitário de linha de comando tabcmd tem comandos e opções para controlar a criptografia de extração. Para obter mais informações, consulte a documentação [tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm).

### Especificar o modo de criptografia de extração ao criar um site

`tabcmd createsite <site-name> --extract-encryption-mode [enforced | enabled | disabled]`

### Especificar o modo de criptografia de extração ao editar um site

`tabcmd editsite <site-name> --extract-encryption-mode [enforced | enabled | disabled]`

### Obter o modo de criptografia de extração ao listar sites

`tabcmd listsites --get-extract-encryption-mode`

### Criptografar extrações ao publicar uma pasta de trabalho, fonte de dados ou extração no servidor

`tabcmd publish "filename.hyper" –-encrypt-extracts`

### Descriptografar todas as extrações em um site

**Observação:** dependendo do número e do tamanho das extrações, essa operação pode consumir recursos significativos do servidor. Considere executar este comando fora do horário comercial normal.

`tabcmd decryptextracts <site-name>`

### Criptografar todas as extrações em um site

**Observação:** dependendo do número e do tamanho das extrações, essa operação pode consumir recursos significativos do servidor. Considere executar este comando fora do horário comercial normal.

`tabcmd encryptextracts <site-name>`

### Criptografar novamente todas as extrações em um site com novas chaves de criptografia

Você deve especificar um site.

**Observação:** dependendo do número e do tamanho das extrações, essa operação pode consumir recursos significativos do servidor. Considere executar este comando fora do horário comercial normal.

`tabcmd reencryptextracts <site-name>`

Para obter mais informações, consulte [reencryptextracts](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#reencryptextracts_tabcmd).

## API Rest do Tableau Server

Com a API REST do Tableau Server, é possível gerenciar os recursos do Tableau Server de maneira programática. É possível usar esse acesso para criar seus próprios aplicativos, ou para criar scripts de interações com os recursos do Tableau Server.

Para saber mais, consulte [Métodos de criptografia de extração](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_extract_and_encryption.htm).

<!-- document id=d0d9d348640631b3a3cbeeaa8eca18af3e1ac618bd8799967933cf8266d54a65 url=/tableau/current/pt-br/server/usage_data_basic_product_data.md -->

[Pular para o conteúdo principal](#main-content)

# Dados básicos do produto

Por padrão, os produtos Tableau enviam dados de uso para o Tableau para que possamos entender como os clientes usam nosso software e obter informações sobre onde eles são bem-sucedidos e onde eles podem encontrar problemas que podemos resolver. Por exemplo, esses dados podem nos ajudar a saber onde os upgrades estão comumente falhando, e nos permitem fazer alterações no produto para resolver esses problemas ou identificar qual parte da nossa base de usuários precisa ser informada sobre um problema de segurança que se aplica a uma versão específica do Tableau Server. Você pode desativar o envio desses dados na hora da instalação ou posteriormente. Para obter detalhes sobre como fazer isso, consulte as instruções para [Tableau Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_setting_changes.htm#usage) ou [Tableau Server](https://help.tableau.com/current/server/pt-br/usage_data_server.htm).

Mesmo quando você desabilitar o envio de dados de uso do produto, determinados dados básicos do produto são enviados ao Tableau. Estes Dados básicos do produto incluem informações sobre produtos e seus processos, incluindo qual produto ou processo está sendo executado, quando eles iniciam, em que sistema operacional eles estão executando, informações de licenciamento, qual máquina ou cluster de máquinas enviou os dados (usando identificadores pseudoanonimizados exclusivos) e se o produto está configurado para enviar dados de uso do produto.

Você pode desativar o envio de dados básicos do produto no nível da máquina ou no nível corporativo, bloqueando o tráfego enviado para **prod.telemetry.tableausoftware.com**.

## Desabilitação do compartilhamento de dados básicos do produto em computadores individuais

**Importante:** este procedimento envolve modificar seu arquivo local `hosts` Se você não sabe o que é isso, não deve mudá-lo. Você só deve fazer essa alteração se entender as implicações de fazer alterações no arquivo, saber como alterar o arquivo e ter feito um backup do arquivo por segurança.

Modificar os arquivos `hosts` altera o comportamento da rede para computadores. Instruções detalhadas para modificar os arquivos `hosts` são fornecidas por provedores de sistemas operacionais como Microsoft, Apple ou Distribuições Linux.

1. Faça uma cópia do arquivo de hosts existentes e salve-a em um computador que não seja o seu computador Tableau. Este é o seu backup, caso você precise reverter suas alterações. Não comece a modificar o arquivo até que você tenha feito uma cópia de backup dele.
2. Modifique o arquivo do seu computador `hosts` para incluir essas linhas:

\# Stops sending Product Usage to Tableau (prod.telemetry.tableausoftware.com).
# Learn more here: http:\\\\tableau.com\\derived-data
127.0.0.1    prod.telemetry.tableausoftware.com

A primeira e a segunda linhas são comentários, explicando a terceira linha.

A terceira linha impede que todo o tráfego `prod.telemetry.tableausoftware.com` (`http://prod.telemetry.tableausoftware.com/`) ) deixe sua máquina local enviando-a para o endereço de loopback interno do host. Os dados não são enviados para fora do computador.

## Desativação do compartilhamento de Dados básicos do produto no nível corporativo

Para desativar o envio de Dados básicos do produto em um nível corporativo, modifique o Firewall de rede para evitar tráfego de saída para `prod.telemetry.tableausoftware.com`.

Este domínio é usado pelo Tableau para receber os Dados básicos do produto sobre o lançamento e o desligamento do processo. Também é usado para os dados mais gerais de uso do produto. Ao bloquear o tráfego para este domínio, você impedirá que ambos os tipos de dados sejam enviados.

O tráfego para este domínio ocorrerá nas Portas 80 (para registro inicial de nossos clientes de Dados de produto) e na Porta 443 (para todo o tráfego subsequente). Para evitar completamente que os dados do produto sejam enviados, bloqueie todo o tráfego para este domínio.

Para obter detalhes sobre como configurar o firewall de rede, consulte seu fornecedor ou seu departamento interno de TI. O Tableau não pode fornecer estas instruções.

<!-- document id=e19520bd656faa930b62366cdcbba85db9c48ced342944166634a0a4a67a4fc5 url=/tableau/current/pt-br/server/usage_data_server.md -->

[Pular para o conteúdo principal](#main-content)

# Dados de uso do servidor

O administrador do Tableau Server pode controlar se os dados de uso do Tableau Server são enviados para o Tableau. Por padrão, essa opção está habilitada e pode ser desabilitada na instalação inicial, ou após instalar o Tableau Server, usando a interface de usuário da Web ou a linha de comando do TSM. Para obter detalhes sobre esses dados de uso, consulte [Dados de uso do produto Tableau](http://tableau.com/derived-data).

Além dos dados de uso do produto, os produtos Tableau enviam dados básicos do produto para o Tableau. Esses dados são enviados se você desativou ou não o envio de dados de uso do produto. Você pode desativar o envio de Dados básicos do produto separadamente. Para obter detalhes, consulte [Dados básicos do produto](https://help.tableau.com/current/server/pt-br/usage_data_basic_product_data.htm).

## Desabilitar o compartilhamento de dados de uso

Você pode desabilitar o compartilhamento de dados de uso ao instalar o Tableau Server ou a qualquer momento após a instalação.

### Desabilitar o compartilhamento de dados de uso na instalação

Para desabilitar o compartilhamento de dados de uso com o Tableau quando você estiver instalando o Tableau Server, desmarque a opção durante a configuração inicial do servidor. Para obter detalhes, consulte [Dados de uso do produto](https://help.tableau.com/current/server/pt-br/config_general.htm#product_data).

### Desabilitar o compartilhamento de dados de uso após a instalação

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Manutenção.
3. Em Outras tarefas de manutenção, em Dados de uso do servidor, desmarque Enviar dados de uso para melhorar os recursos do Tableau:
    
    ![Mensagem de Dados de uso de produtos solicitando permissão para coletar informações sobre o uso do seu recurso.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-server-usage.png)
4. Ao terminar, clique em Alterações pendentes, em seguida clique em Aplicar alterações e reiniciar..

Se você não desejar compartilhar dados de uso do produto, desabilite a opção utilizando este comando de configuração tsm:

tsm configuration set -k shareproductusagedata.enabled -v false

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

## Outros artigos nesta seção

<!-- document id=8cfd1c1b76f5a9dcc828dd0601f2f1ff24be0edfb3589373d3424835b3a70781 url=/tableau/current/pt-br/server/data_freshness_policy.md -->

[Pular para o conteúdo principal](#main-content)

# Defina uma política de atualização de dados para caches de consulta

## Entenda a atualização dos dados para caches de consulta

Você criou sua pasta de trabalho e sua equipe a adora. Mas às vezes as pessoas precisam clicar no botão Atualizar para que os dados mais atualizados apareçam na visualização. Você construiu a pasta de trabalho usando uma conexão ativa, então por que os dados precisam ser atualizados? A resposta é desempenho.

Para melhorar o desempenho, o Tableau armazena os resultados em cache das consultas usadas para recuperar os dados, para que as visitas subsequentes possam reutilizar e retornar os dados armazenados em cache com mais rapidez. Você pode clicar no botão Atualizar para recuperar os dados atualizados, mas isso pode aumentar os custos potenciais de desempenho.

Para equilibrar o desempenho e a atualização dos dados, defina uma política de atualização dos dados para sua pasta de trabalho. Quando você define uma política de atualização de dados, seus dados são atualizados no momento que você especifica. O Tableau não visualiza dados em cache que não atendem à política de atualização que você definiu.

## Escolha o que é melhor para sua pasta de trabalho

Algumas pessoas podem não querer o cache para que tenham sempre os dados mais recentes, enquanto outras podem querer caches grandes para reduzir a sobrecarga e melhorar o desempenho da pasta de trabalho. A primeira etapa para definir uma política de atualização de dados é decidir o que é certo para sua empresa.

O Tableau Cloud atualiza os dados armazenados em cache a cada 12 horas por padrão, e os proprietários da pasta de trabalho podem definir políticas de atualização de dados no nível da pasta de trabalho.

No Tableau Server, os administradores do servidor podem [definir uma política de cache padrão para todos os sites no servidor](https://help.tableau.com/current/server/pt-br/config_cache.htm), e os proprietários da pasta de trabalho podem definir políticas de atualização de dados no nível da pasta de trabalho.

**Observação:** as políticas de atualização de dados não estão disponíveis no Tableau Desktop ou para pastas de trabalho que usam fontes de dados baseadas em arquivo e extração.

## Editar uma política de atualização de dados da pasta de trabalho

Para editar uma política de atualização de dados da pasta de trabalho, você deve ser o proprietário da pasta de trabalho e a pasta de trabalho deve ter uma conexão ativa com a fonte de dados.

1. Faça logon em um site no Tableau Cloud ou no Tableau Server.
2. Na página inicial ou de exploração, navegue até a pasta de trabalho para a qual deseja definir uma política.
3. Use o ícone de três pontos (mais opções) para abrir o menu.
4. Selecione Editar política de atualização de dados....
5. Escolha uma das seguintes opções:  
    Padrão do site (12 horas)  
    Sempre ativo (o Tableau sempre obterá os dados mais recentes)  
    Certifique-se de que os dados sejam atualizados a cada  
    Certifique-se de que os dados sejam atualizados em
6. Selecione OK.

O padrão do site atualiza seus dados a cada 12 horas, o que é uma ótima opção se seu público usa regularmente o painel, mas não precisa de dados atualizados.

Sempre ativo fornece os dados mais recentes em todos os momentos, o que pode aumentar o tempo de carregamento.

Garanta que os dados sejam atualizados a cada... permite que você especifique com que freqüência os dados são atualizados com a granularidade de minutos, horas, dias ou semanas.

Certifique-se de que os dados sejam atualizados em... permite que você programe a hora e o dia para atualizações de dados. Se você tiver uma reunião importante todas as segundas, quartas e sextas-feiras às 09:00, horário do Pacífico, poderá definir a atualização de seus dados para ocorrer às 08:45 todas as segundas, quartas e sextas-feiras, para ter os dados mais recentes quando sua reunião começa.

<!-- document id=6402f8831dfa54ad5b73da225df8ec1887694c65c1e65babe91e78806e005a44 url=/tableau/current/pt-br/server/entity_library.md -->

[Pular para o conteúdo principal](#main-content)

# Definições de entidade e Modelos

É possível usar as definições de entidade e modelos com o comando `tsm settings import` para fazer várias configurações do Tableau Server.

## Outros artigos nesta seção

<!-- document id=0c335bf518b5d967e22c27672d7c3f5079a2d489729773fcb8f58de509dbb65b url=/tableau/current/pt-br/server/maintenance_startpg.md -->

[Pular para o conteúdo principal](#main-content)

# Definir a página inicial padrão para todos os usuários

Em uma nova implantação, quando os usuários entram no ambiente de criação na Web do Tableau Server, eles são encaminhados para a tela da Página inicial que exibe um banner de boas-vindas com base na função. A Página inicial também mostra exibições recentes, favoritos e o conteúdo mais visualizado do site. Como o administrador de servidor, você pode alterar a página de destino padrão dos usuários no nível de servidor e site. Por exemplo, você pode mostrar todas as pastas de trabalho e, quando o usuário fizer logon, ele verá as pastas de trabalho as quais tem acesso.

### Para definir a página inicial padrão para todos os usuários

1. Exiba a página ou exibição filtrada que deseja que seja a página padrão que os usuários verão ao fazer logon no site.
2. Selecione seu ícone de perfil no canto superior direito da página.
3. Para definir a página inicial para:
    
    - Todos os usuários em um site: clique em Definir como Página inicial e Para usuários neste site.
    - Todos os usuários no servidor: clique em Definir como Página inicial e Para todos os usuários do servidor.
    
    ![Menu para definir a página inicial para todos os usuários do servidor.](/tableau/current/pt-br/server/pt-br/Img/maintenance_set_defaultpg.png)

## Páginas iniciais e hierarquia definidas pelo usuário

Os usuários podem definir suas próprias páginas iniciais por meio do ícone do perfil e redefinir as páginas iniciais nas configurações da conta (consulte [Acessar suas configurações de perfil e conta](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#useracct.htm)).

Se um usuário definir sua própria página inicial, ela substituirá qualquer página inicial definida por um administrador do servidor. Na próxima vez que o usuário fizer logon, ele será encaminhado para a página inicial definida. Se um administrador do servidor definir páginas iniciais para um servidor e um site, os usuários terão como padrão a página inicial definida para eles (se houver), a página inicial do site e a página inicial do servidor. Se o usuário ou o administrador não tiver definido uma página inicial, os usuários terão como padrão a Página inicial.

<!-- document id=d48c1910c4071afb298289d9e7ba7a1e28838594947adc175c5247074ef660ee url=/tableau/current/pt-br/server/web_author_enable.md -->

[Pular para o conteúdo principal](#main-content)

# Definir acesso de criação na Web ou funções de um site

Os administradores do Tableau Server podem especificar no site se os usuários têm ou não permissão para editar as exibições publicadas no ambiente da Web e configurar outra funcionalidade de criação na Web.

Por padrão, a funcionalidade de criação na Web está habilitada para todos os sites, Usuários com o recurso Edição na Web podem criar e editar pastas de trabalho diretamente no servidor. Desative essa funcionalidade caso deseje que os usuários visualizem e interajam com as pastas de trabalho publicadas sem causar alterações nas informações principais.

As etapas abaixo descrevem como configurar a criação na Web e outra funcionalidade associada para todo um site: Para um controle mais granular sobre quais usuários podem usar a edição na Web, use projetos, grupos e permissões. Consulte [Definir acesso de Edição na Web, Salvar e Baixar conteúdo](https://help.tableau.com/current/server/pt-br/web_author_who.htm).

Para obter informações sobre como ativar a Criação para fluxos na Web, consulte [Criar e interagir com fluxos na Web](https://help.tableau.com/current/server/pt-br/web_author_flows.htm) .

## Ativar ou desativar a criação na Web para um site

1. Em um navegador da Web, entre no servidor como um administrador e acesse o site para o qual deseja habilitar a criação na Web. Neste site, clique em Configurações.
2. Na seção **Criação na Web**, selecione Pastas de trabalho. Deixe que os usuários editem pastas de trabalho em seu navegador. para habilitar a funcionalidade.
    
    Desmarque a caixa de seleção para desativar a criação na Web para o site.
    
    ![Tornar as visualizações do seu site não editáveis](/tableau/current/pt-br/server/pt-br/Img/web_author_disable4.png)
3. Se o site já estiver em produção e você quiser que a alteração entre em vigor imediatamente, reinicie o servidor.
    
    Caso contrário, a alteração terá efeito depois que o cache da sessão do servidor expirar na próxima vez que um usuário fizer logon, depois que sair.

### Observações

- Ao habilitar a criação na Web, certifique-se de que, nas pastas de trabalho e exibições apropriadas, a regra de permissão para um usuário ou grupo permite o recurso **Edição na Web**.
- Se optar por desabilitar a criação na Web em um site de produção e não concluir a última etapa para reiniciar o servidor, é possível que os usuários continuem com acesso à criação até que façam logout ou até que os caches da sessão expirem.

## Ver quais sites permitem a criação na Web

Para confirmar quais sites permitem criação na Web, no menu de seleção de site, clique em Gerenciar todos os sites e vá para a página Sites.

![A página Sites mostra quais sites permitem a criação na Web.](/tableau/current/pt-br/server/pt-br/Img/web_author_disable3.png)

## Sobre uniões de colunas entre banco de dados

Para melhorar o desempenho das uniões de colunas entre bancos de dados, o Tableau agora decidirá por padrão se deve executar as uniões de colunas dentro do Tableau usando o Hyper ou mover os dados para o banco de dados ativo conectado como uma tabela temporária e executar as uniões nele.

A opção em Configurações para cada site configurar uniões de colunas entre bancos de dados ainda está visível, mas não pode mais ser alterado do padrão.

![Configuração de uniões de coluna entre bancos de dados com opções para sempre executá-las no banco de dados ou deixar que o Tableau decida onde unir.](/tableau/current/pt-br/server/pt-br/Img/cross_database_join_web_setting.png)

Para obter mais informações, consulte [Melhorar o desempenho da união entre bancos de dados](https://help.tableau.com/current/pro/desktop/pt-br/joining_tables.htm#cross_dbase_joins_perf).

<!-- document id=5187c8c92276805c0723ccea625704c1e643833ac3c9b1ad56479b97e9694211 url=/tableau/current/pt-br/server/data_stories_drivers.md -->

[Pular para o conteúdo principal](#main-content)

# Definir as configurações da história com dados do Tableau: drivers

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Hipoteticamente, digamos que suas vendas mês a mês aumentaram significativamente. O que motivou esse aumento nas vendas? E o que pode ter prejudicado (compensado) esse aumento de vendas? A configuração de drivers em sua história com dados pode responder a essas perguntas.

Nas histórias com dados, os direcionadores contribuem para um valor total. Compensadores diminuem um valor total. Você encontrará informações sobre drivers e compensadores em histórias discretas e contínuas. E essas informações facilitam a compreensão exata do que está acontecendo nos dados e por quê.

## Definir drivers de dimensão

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Drivers.
4. Na seção Drivers da dimensão, selecione o tipo de driver que tem o maior impacto em sua análise:  
    Para Contagem, defina o número máximo de colaboradores e compensadores.  
    Para % Individual , defina limites para escrever sobre colaboradores e compensadores individuais.  
    Para % cumulativo , defina limites para escrever sobre colaboradores e compensadores com base em seu valor coletivo.
5. Clique em Salvar.

## Compreender os tipos de driver de dimensão

- Contagem especifica o número de entidades (colaboradores e compensadores) chamadas em sua história. Por exemplo, use Contagem para ver os três principais colaboradores e compensadores em seus dados.
- A % individual define um limite e valores superiores a esse limite são incluídos em sua história. Por exemplo, use % individual para especificar que você deseja escrever apenas sobre entidades que representam mais de 5% do valor total.
- A % cumulativa define um limite percentual do valor total que as entidades incluídas representam coletivamente. Por exemplo, use % cumulativo para especificar que você deseja escrever sobre as entidades que contribuíram com pelo menos 90% desse valor total. Neste exemplo, as entidades são escritas em ordem de magnitude até que o valor cumulativo dessas entidades represente 90% do valor total.

## Usar colaboradores secundários

Para usar colaboradores secundários, você deve ter uma segunda dimensão que não seja o tempo. Quando você usa colaboradores secundários, cada driver sobre o qual é escrito também tem detalhes e drivers para seu colaborador secundário. Por exemplo, se você estiver analisando as vendas da loja, um colaborador secundário seria uma classe dentro de um departamento. Colaboradores secundários permitem uma análise mais profunda. Mas os colaboradores secundários também podem conter muitas informações para caber em uma única frase em sua história.

## Definir drivers de métrica

Para medidas compostas por outras medidas de subcategoria, a análise do driver pode explicar o impacto que cada medida teve no valor de nível superior. Por exemplo, os custos de material e os custos operacionais contribuem para o custo total.

Para usar drivers de métrica, você deve ter várias medidas para análise de métrica. Em seguida, você pode especificar as relações entre cada medida.

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Drivers.
4. Na seção Drivers de métrica, primeiro escolha a medida que é uma subcategoria de outra medida.
5. Em seguida, escolha a medida que é a categoria principal.
6. Clique em Salvar.

> [!TIP]
> 
> **Dica:** a configuração de verbosidade também se aplica a drivers. Ao alterar a configuração de detalhamento da sua história, você pode ajustar a maneira como as informações são escritas. Se você usar alto detalhamento, verá mais informações entre parênteses. Se você usar baixo detalhamento, obterá uma visão escrita mais concisa sobre seus drivers. Para obter mais informações, consulte [Definir as configurações de História com dados do Tableau: narrativa](https://help.tableau.com/current/server/pt-br/data_stories_narrative.htm).

![Animação de clicar no ícone Configurações em um Objeto de História com dados, definindo drivers de dimensão, definindo drivers de métrica e salvando.](/tableau/current/pt-br/server/pt-br/Img/data_stories_drivers.gif)

<!-- document id=cecaa0668426b62352be1997786a74d030237fc37d5299f11ab744ae77d78b31 url=/tableau/current/pt-br/server/data_stories_display.md -->

[Pular para o conteúdo principal](#main-content)

# Definir as configurações da história com dados do Tableau: exibição

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Você pode configurar como o texto é exibido em sua História com dados do Tableau, como cor e tamanho da fonte. Você também pode escolher se sua história usa listas com marcadores ou parágrafos.

## Configure a exibição da sua história

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Exibição.
4. Escolha se deseja que a estrutura da sua história seja Tópicos ou Parágrafos.
5. Escolha o Tamanho da fonte.
6. Escolha cores para representar mudanças boas e ruins (disponíveis para histórias contínuas).
7. Escolha se deseja usar o Pedido dinâmico.
8. Escolha se deseja usar uma Exibição condensada.
9. Clique em Salvar.

## Entenda quando usar as configurações de exibição da história

Para usar cores, a história deve ser contínua. Ao usar cores, você pode escolher cores da paleta para representar mudanças boas e mudanças ruins. Para que sua história saiba se uma mudança é boa ou ruim, você deve atribuir significado a valores maiores na guia Características . Para obter mais informações, consulte [Definir as configurações de História com dados do Tableau: características](https://help.tableau.com/current/server/pt-br/data_stories_characteristics.htm). Depois de configurar sua exibição, os estilos e cores são aplicados em sua história com base nos limites da linha de tendência ou análise de segmento.

Se você ativar o Ordenamento dinâmico, as informações para medidas em uma história serão ordenadas dinamicamente do melhor ao pior valor médio. Se você já tem um pedido que deseja manter, desative o Pedido dinâmico.

Se você ativar a Visualização condensada, o espaço adicional será removido da sua história. Isso é útil se você não tiver muito espaço extra em seu painel ou quando tiver vários objetos de História com dados em um painel.

<!-- document id=02bca1ee06ba33ff8ac777466a9f6544fe93bcba7b86f3b7053cb3d94908e51e url=/tableau/current/pt-br/server/data_stories_relationships.md -->

[Pular para o conteúdo principal](#main-content)

# Definir as configurações da história com dados do Tableau: relacionamentos

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

A configuração Relacionamentos permite atribuir relações entre medidas em História com dados do Tableau que têm várias medidas. Para configurar Relacionamentos, sua história deve ter uma dimensão e várias medidas. Para obter mais informações, consulte [Criar relacionamentos de medidas personalizadas em suas Histórias com dados do Tableau](https://help.tableau.com/current/server/pt-br/data_stories_relationship_story.htm).

Há dois tipos de relacionamentos:

- Real versus benchmark
- Período atual/mais recente versus período anterior

Use Real versus Benchmark quando quiser saber se seu desempenho está acima ou abaixo de seus benchmarks de desempenho, por exemplo, ao gerar relatórios de cotas. Esse tipo de relacionamento também é útil para identificar pontos de dados que exigem análise adicional porque estão significativamente acima ou abaixo do seu benchmark. Para usar Real versus Benchmark, as medidas que você está comparando devem ter o mesmo tipo de valor.

Use Períoso atual/mais recente versus anterior quando quiser ver se seus principais indicadores de desempenho (KPIs) estão aumentando, diminuindo ou permanecendo consistentes ao longo do tempo. Para usar o Período atual/mais recente versus anterior, você deve usar um tipo de história discreto. Para obter mais informações, consulte [Escolha o tipo de história certa para sua história com dados do Tableau Desktop](https://help.tableau.com/current/server/pt-br/data_stories_story_types.htm).

Além disso, você pode usar as relações Real versus Benchmark e Período atual/mais recente versus anterior simultaneamente. As medidas em sua visualização que não fazem parte dos relacionamentos configurados são descritas em parágrafos separados.

## Criar relacionamento real versus benchmark para histórias contínuas ou discretas

Use o relacionamento Real versus benchmark quando uma medida for uma referência para outras medidas. Por exemplo, você pode comparar as vendas reais com uma meta de vendas, para que sua história escreva informações sobre se você superou ou não sua meta. Quando você usa esse tipo de relacionamento, a história remove o conteúdo desnecessário e se concentra no que é mais importante – comparar uma métrica com seu benchmark associado.

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Campos.
4. Marque a caixa para Real versus Benchmark.
5. Primeiro, selecione a medida que é o benchmark.
6. Em seguida, selecione a medida que você deseja comparar com a referência.
7. Clique em Salvar.

## Criar relacionamento de período atual/mais recente versus anterior

Use a relação Período atual/mais recente versus anterior para comparar o desempenho de duas medidas em um período. Por exemplo, você pode comparar dois produtos para ver qual produto gerou mais receita no último ano.

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Campos.
4. Marque a caixa para Período atual/mais recente versus anterior.
5. Primeiro selecione a medida para o período anterior.
6. Em seguida, selecione a medida para o período atual.
7. Insira o rótulo do período que você está medindo, por exemplo, ano.
8. Escolha o número de períodos a medir.
9. Clique em Salvar.

<!-- document id=fbf24d511efc8454942674c98c8cd8292819a0a1c62c1cc2d6fbd967358d9576 url=/tableau/current/pt-br/server/runas_datasource.md -->

[Pular para o conteúdo principal](#main-content)

# Definir as configurações de conexão da fonte de dados

Para autenticar automaticamente seus usuários quando a pasta de trabalho que eles estiverem acessando se conectar a uma fonte de dados ativa, autenticada por Windows, configure sua conexão de dados do Tableau com a opção Usar a Autenticação do Windows selecionada:

<table class="Simple" style="border-top: none; border-bottom: none; border-left: none; border-right: none;"><colgroup><col title="1" style="width: 47;"><col title="2" style="width: 5;"><col title="3" style="width: 48;"></colgroup><thead><tr><th style="border-bottom: none; border-right: none; border-top: none; border-left: none;">Autenticação do Windows</th><th style="border-bottom: none; border-left: none; border-right: none; border-top: none;">&nbsp;</th><th style="border-bottom: none; border-left: none; border-top: none; border-right: none;">Nome de usuário e senha</th></tr></thead><tbody><tr><td style="border-top: none; border-bottom: none; border-right: none; border-left: none;">Autentica com a conta de usuário Run As do servidor</td><td style="border-top: none; border-bottom: none; border-left: none; border-right: none;">&nbsp;</td><td style="border-top: none; border-bottom: none; border-left: none; border-right: none;">Cada usuário do Tableau Server é solicitado a fornecer credenciais de banco de dados</td></tr><tr><td style="border-top: none; border-right: none; border-bottom: none; border-left: none;"><img src="https://help.tableau.com/current/server/pt-br/Img/auth1.png" style="text-align: left;" alt="Uma caixa de diálogo com campos vazios para entrar em um Microsoft SQL Server para usar na autenticação."></td><td style="border-top: none; border-left: none; border-right: none; border-bottom: none;">&nbsp;</td><td style="border-top: none; border-left: none; border-bottom: none; border-right: none;"><img src="https://help.tableau.com/current/server/pt-br/Img/auth2.png" style="text-align: left;" alt="Uma caixa de diálogo com um nome de usuário e uma senha inseridos para entrar em um Microsoft SQL Server para autenticação."></td></tr></tbody></table>

É importante entender como a conta de serviço Run As acessa os dados em nome dos usuários da organização. Em alguns casos, os usuários podem acessar inadvertidamente dados para os quais suas contas de usuário não estão explicitamente autorizadas. Antes de permitir que os usuários acessem os dados com a conta de serviço Run As, analise o [Acesso aos dados com a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_access.htm).

<!-- document id=27af50b89c4e16733b4755cd6ea2b148ff14d4327755bc51179666f293889cef url=/tableau/current/pt-br/server/data_stories_analytics.md -->

[Pular para o conteúdo principal](#main-content)

# Definir as configurações de história com dados do Tableau: Análises

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Dentro de sua História com dados do Tableau, você pode escolher sobre quais análises escrever e quando essas análises são escritas. Diferentes tipos de análise estão disponíveis dependendo do seu tipo de história e de quantas dimensões e medidas sua história tem. No entanto, a análise não tem suporte atualmente para tipos de história de gráfico de dispersão. Para obter mais informações, consulte [Escolha o tipo de história certa para sua história com dados do Tableau Desktop](https://help.tableau.com/current/server/pt-br/data_stories_story_types.htm).

## Configurar análises para sua história

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Análise.
4. Clique nos interruptores para ativar diferentes tipos de análise.
5. Para Segmentos e Linha de tendência, expanda Configurações para definir limites para realizar essas análises.
6. Clique em Salvar.

## Entenda os diferentes tipos de análise

### Correlação

Use Correlação para identificar correlações estatísticas verdadeiras entre duas séries. Se você tiver mais de duas séries, todas as combinações serão analisadas quanto a correlações. Por exemplo, você pode ativar a Correlação para identificar quando dois produtos são frequentemente comprados juntos.

### Clustering

Use Clustering para identificar grupos distintos de pontos de dados (clusters) usando uma única análise estatística. Por exemplo, você pode ativar o Clustering para identificar quando um produto é muito popular em uma região geográfica específica.

### Distribuição

Use Distribuição para classificar pontos de dados em relação uns aos outros usando observações não estatísticas, como média, mediana, distorção etc. Por exemplo, você pode ativar Distribuição para identificar qual produto tem a maior taxa de lucro.

### Segmentos

Use Segmentos para destacar alterações dignas de nota em pontos de dados em uma série. Primeiro, defina a porcentagem mínima de alteração sobre a qual você deseja escrever em um segmento. As alterações que ficam abaixo do limite definido não são descritas. Por exemplo, se você definir seu limite de segmento para alterações superiores a 60%, sua história não escreverá sobre um vale em uma série temporal que apresente uma redução de 30%.

Depois de definir seu limite, escolha se deseja Aplicar formatação e defina a porcentagem mínima de alteração que deseja formatar.

### Linha de tendência

Use a Linha de tendência para calcular uma linha de melhor ajuste linear e identificar os dados que se enquadram em uma porcentagem definida de confiança. Os dados com alta variabilidade têm um nível de confiança mais baixo do que os dados mais consistentes e esse nível de confiança afeta se as linhas de tendência são gravadas. Você pode usar linhas de tendência para histórias que tenham uma dimensão e uma medida ou pode usar linhas de tendência em uma pesquisa detalhada. Para obter mais informações sobre detalhamentos, consulte [Definir as configurações de História com dados do Tableau: narrativa](https://help.tableau.com/current/server/pt-br/data_stories_narrative.htm) .

Defina a porcentagem mínima de confiança para sua linha de tendência. Se você definir seu limite em 95%, mas uma linha de tendência puder ser desenhada com 90% de confiança, sua história não escreverá sobre linhas de tendência. Depois de definir seu limite, escolha se deseja Aplicar formatação. Em seguida, defina a porcentagem mínima de alteração que você deseja formatar.

As Histórias com dados do Tableau sobre linhas de tendência comunicam a mudança absoluta ao longo de um período. A história escrita sobre sua linha de tendência varia dependendo do nível de detalhamento que você definiu para sua história. Se sua história usa muita verbosidade, então sua história escreve sobre o valor R-quadrado, que é um conceito estatístico que quantifica o quão bem seus dados se ajustam à linha de tendência. Para obter mais informações sobre as configurações de detalhamento, consulte [Definir as configurações de História com dados do Tableau: narrativa](https://help.tableau.com/current/server/pt-br/data_stories_narrative.htm).

Nas configurações da Linha de tendência, você também pode escolher quantos períodos no futuro você deseja que sua história escreva previsões. Quando você usa previsões, sua história usa a inclinação e a interceptação da linha de tendência para calcular os valores previstos para períodos futuros. A confiança da previsão adiciona limites superiores e inferiores ao limite de confiança que você definiu para linhas de tendência. Você pode usar previsões quando sua história tiver pelo menos 30 pontos de dados lineares.

### Volatilidade

Use Volatilidade para analisar desvios padrão ao longo do tempo. Por exemplo, use Volatilidade quando quiser que sua história escreva sobre valores que estão fora do intervalo médio de seus dados.

## Divida como as análises são usadas para gerar histórias

Neste ponto, você pode estar se perguntando como funcionam as análises para diferentes tipos de história. Vamos dar uma olhada em um exemplo para cada tipo de história e dividir cada frase na história.

### Entenda a análise de histórias discretas

Como as histórias contínuas medem tendências ao longo do tempo, Histórias de dados escreve sobre desempenho, progressão, médias, totais, sequências, volatilidade, segmentos e previsões.

O exemplo a seguir de uma história contínua é sobre vendas por mês:

![Uma história de exemplo com informações de texto sobre vendas por mês. O texto desta imagem é transcrito na tabela a seguir.](/tableau/current/pt-br/server/pt-br/Img/data_stories_continuous_analytics.png)

<table style="border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Exemplo de história</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Detalhamento da história</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>As vendas médias foram de <b>US$ 47.858</b> em todos os <b>48</b> meses.</li><li>O valor mínimo foi de <b>US$ 4.520</b> (fevereiro de 2014) e o máximo foi de <b>US$ 118.448</b> (novembro de 2017).</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">As duas primeiras frases usam funções de média e intervalo para escrever sobre os valores médio, máximo e mínimo no período que você está analisando.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>As vendas aumentaram <b>489%</b> ao longo da série, mas terminaram com uma tendência de queda, diminuindo no último mês.</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A terceira frase é sobre o desempenho geral da medida ao longo do período. Por exemplo, uma frase pode ser sobre se as vendas aumentaram, diminuíram ou tiveram uma tendência diferente durante um período específico.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>O maior aumento individual em base percentual ocorreu em março de 2014 ( <b>+1.132%</b> ). No entanto, o maior aumento único em base absoluta ocorreu em setembro de 2014 ( <b>+US$ 53.868</b> ).</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A quarta frase usa análise de progressão. Esta frase descreve o maior aumento e diminuição com base na medida durante o período usando uma base percentual e uma base absoluta.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Das <b>três</b> séries, a relação mais forte foi entre Corporate e Home Office, que apresentou correlação positiva moderada, sugerindo que à medida que uma (Corporate) aumenta, a outra (Home Office) geralmente também aumenta, ou vice-versa.</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esta frase é uma informação de <b>Correlação</b>. Esse tipo de informação analítica escreve sobre correlações notáveis entre diferentes séries em seus dados.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>As vendas experimentaram ciclicidade, repetindo cada ciclo a cada <b>12</b> meses. Havia também um padrão de ciclos menores que se repetiam a cada <b>três</b> meses.</li><li>As vendas tiveram um <b>pico positivo significativo entre outubro de 2014 (US$ 31.453) e fevereiro de 2015 (US$ 11.951), subindo para US$ 78.629 em novembro de 2014</b> .</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esta frase é uma informação de <b>Segmento</b>. Esse tipo de informação analítica escreve sobre aumentos e diminuições notáveis ao longo do tempo.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>A <b>tendência linear geral da série subiu para US$ 902 por mês</b> para uma mudança absoluta de <b>US$ 42.394</b> ao longo da série. Se essa tendência continuar no próximo mês, as vendas <b>deverão ser de cerca de US$ 69.958</b>.</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Esta frase é um insight da <b>Linha de tendência</b>. Esse tipo de informação escreve sobre como as tendências se ajustam aos seus dados com uma certa porcentagem de confiança, e as linhas de tendência permitem que você faça previsões com base em tendências históricas.</td></tr></tbody></table>

### Entenda a análise de histórias discretas

Como as histórias discretas permitem comparar valores e entender a distribuição dos dados, a história escreve sobre distribuição, médias, totais e agrupamentos ou agrupamentos nos dados.

O exemplo a seguir de uma história discreta é sobre vendas por produto:

![Uma história de exemplo com informações de texto sobre vendas por produto. O texto desta imagem é transcrito na tabela a seguir.](/tableau/current/pt-br/server/pt-br/Img/data_stories_discrete_analytics.png)

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Exemplo de história</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Detalhamento da história</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>As vendas totais são de <b>US$ 2,3</b> milhões em todos os <b>17</b> produtos.</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A primeira frase calcula o valor total da sua medida.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>As vendas de <b>US$ 2,3</b> milhões foram impulsionadas por <u>Telefones</u> com <b>US$ 330.007</b>, <u>Cadeiras</u> com <b>US$ 328.449</b> e <u>Armazenamento</u> com <b>US$ 223.844</b> .</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A segunda frase escreve sobre os drivers de dimensão. Neste exemplo, os direcionadores de dimensão são os produtos que mais contribuíram para as vendas totais.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>A distribuição é positivamente enviesada, pois a média de <b>US$ 135.129</b> é maior que a mediana de <b>US$ 114.880</b> .</li><li>As vendas estão relativamente concentradas com <b>78%</b> do total representado por <b>oito</b> dos <b>17</b> produtos (<b>47%</b>).</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A terceira e quarta frases analisam a distribuição dos dados. Isso analisa as médias, medianas, concentração de dados (se houver) e como os dados são distorcidos. Isso ajuda a identificar o quão equilibradas essas variáveis agrupadas são comparadas umas com as outras.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Os <b>dois</b> principais produtos combinam mais de um quarto (<b>29%</b>) das vendas totais.</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esta frase usa <span class="uicontrol">Clustering</span> para escrever sobre medidas que podem ser agrupadas. Isso ajuda a identificar se existem grupos distintos que se destacam nos dados.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li><u>Telefones</u> (<b>US$ 330.007</b>) é mais de duas vezes maior que a média dos <b>17</b> produtos.</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">A frase final escreve sobre notáveis valores discrepantes.</td></tr></tbody></table>

### Entenda a análise para histórias de dispersão

Os tipos de histórias de dispersão são mais bem usados para entender a relação entre duas medidas e, por esse motivo, as histórias de dispersão requerem 2 a 3 medidas. A análise de gráfico de dispersão escreve sobre o relacionamento (regressão) entre duas medidas e escreve sobre grupos (clusters) dentro dos dados, se existirem.

O exemplo a seguir de uma história de gráfico de dispersão é sobre lucro e vendas em uma dimensão:

![Uma história de exemplo com informações de texto sobre lucro e vendas. O texto desta imagem é transcrito na tabela a seguir.](/tableau/current/pt-br/server/pt-br/Img/data_stories_scatter_analytics.png)

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Exemplo de história</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Detalhamento da história</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>À medida que a quantidade aumentava e o lucro aumentava, as vendas aumentavam com base nos dados fornecidos. Especificamente, quando a quantidade aumentou em <b>1</b>, as vendas aumentaram <b>US$ 49,55</b> , e quando o lucro aumentou em <b>US$ 1,00</b> , as vendas aumentaram <b>US$ 1,20</b>.</li><li>Poucos clientes se desviaram dessa relação geral, indicando um bom ajuste.</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">As duas primeiras frases são alimentadas por análise de regressão. A regressão mostra como uma medida afeta outra. Observe que, na primeira frase, a história identificou uma relação entre lucro e vendas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Quando organizados em grupos de valores semelhantes de lucro, quantidade e vendas, um grupo distinto se destaca. Foram <b>651</b> clientes que tiveram valores de lucro entre <b>-US$ 6.626</b> e <b>US$ 1.488</b>, quantidade entre <b>2</b> e <b>122</b> e vendas entre <b>US$ 4,83</b> e <b>US$ 5.690</b> .</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A terceira frase é derivada de agrupamento. A análise de clustering tenta identificar os principais grupos ou clusters em todas as variáveis nos dados.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li><u>Tamara Chand</u>, <u>Raymond Buch</u>e <u>Sanjit Chand</u>, entre outros foram discrepantes com altos valores de lucro e vendas. Sean Miller se destacou com baixo lucro e alto valor de vendas.</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A quarta frase é escrita sobre valores discrepantes – valores que ficam significativamente acima ou abaixo da média.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>O valor mínimo para lucro é <b>-US$6.626</b> (<u>Cindy Stewart</u>) e o valor máximo é <b>US$ 8.981</b> (<u>Tamara Chand</u>), uma diferença de <b>US$ 15.608</b> . O lucro médio por cliente é de <b>US$ 361</b> e a mediana é de <b>US$ 228</b>.</li><li>O valor mínimo para quantidade é <b>2</b> (<u>Anthony O'Donnell</u>) e o valor máximo é <b>150</b> (<u>Jonathan Doherty</u>), uma diferença de <b>148</b> . A quantidade média por cliente é <b>47,76</b> e a mediana é <b>44</b> .</li><li>A distribuição das vendas varia de <b>US$ 4,83</b> (<u>Thais Sissman</u>) para <b>US$ 25.043</b> (<u>Sean Miller</u>), uma diferença de <b>US$ 25.038</b> . A média de vendas por cliente é de <b>US$ 2.897</b> e a mediana é de <b>US$ 2.256</b>.</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">As frases restantes para histórias de gráficos de dispersão usam análise de intervalo e média para escrever informações.</td></tr></tbody></table>

### Entenda a análise de porcentagem de histórias inteiras

Porcentagem de tipos de histórias inteiras são melhores para entender qual parte de um todo uma dimensão ou medida representa.

O exemplo a seguir de uma porcentagem de toda a história é sobre vendas por segmento:

![Uma história de exemplo com informações de texto sobre vendas por segmento. O texto desta imagem é transcrito na tabela a seguir.](/tableau/current/pt-br/server/pt-br/Img/data_stories_pie_analytics.png)

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Exemplo de história</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Detalhamento da história</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li><p>O SUM(Vendas) total é de 2,3 milhões em todas as três entidades.</p></li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A primeira frase calcula o valor total da sua medida.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li><p>O SUM(Vendas) de 2,3 milhões foi impulsionado pelo Consumidor com 1,2 milhão, Corporate com 706.146 e Home Office com 429.653.</p></li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A segunda frase escreve sobre impulsionadores. Neste exemplo, os impulsionadores são os segmentos que mais contribuíram para as vendas totais.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>O valor mínimo é 429.653 (Home Office) e o máximo é 1,2 milhão (Consumidor), uma diferença de 731.748, com média de 765.734.</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">A frase final analisa a distribuição dos dados.</td></tr></tbody></table>

<!-- document id=e467933970fec5759774a81c5f805d9aeb970905db6cd2724dbccd01a36ff76e url=/tableau/current/pt-br/server/data_stories_characteristics.md -->

[Pular para o conteúdo principal](#main-content)

# Definir as configurações de História com dados do Tableau: características

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Na sua história com dados do Tableau, você pode definir as configurações de características para dar contexto aos seus dados e obter histórias mais perspicazes. Por exemplo, na sua história, você pode especificar que, no contexto de vendas, um número maior é bom. Mas no contexto de reclamações de clientes, um número maior é ruim.

## Usar dimensões e medir características

A formatação da sua história e número se ajusta com base na medida. Por padrão, todos os seus escritores de história medem valores como números, e sua história não realizará nenhum cálculo adicional nem aplicará nenhuma regra de renderização especial.

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Características.
4. Configure sua formatação, como tipo de número, casas decimais e valores negativos.
5. Clique em Salvar.

## Saiba mais sobre as características da medida

### Formatação

Se os valores forem formatados como Porcentagens, a história escreverá sobre diferenças de pontos percentuais, em vez de alterações percentuais, como faria uma história para valores numéricos. Quando você formata um número como Porcentagem na guia Características, a História com dados multiplica o valor do número por 100 para criar a porcentagem exibida em sua história.

Se os valores forem formatados como Moeda, você poderá especificar sua moeda preferida. Você também pode especificar como deseja que valores grandes (números maiores que um milhão) sejam formatados, por exemplo, US$ 1,3 milhão em vez de US$ 1.300.000,00.

Para Números e Moeda, você pode especificar como deseja que valores grandes e valores negativos sejam escritos. Se você optar por ter valores negativos escritos entre parênteses, poderá ver parênteses aninhados em sua história quando o valor negativo for escrito em uma frase entre parênteses.

Ao escolher a formatação de Número , você também pode especificar se deseja que números menores ou iguais a 10 sejam soletrados (em vez de usar um numeral) em sua história.

Para casas decimais, Dinâmico é a opção padrão. Isso significa que a história é arredondada para diferentes casas decimais, dependendo de quão grande ou pequeno é o número. Se o valor percentual for menor que 10, o número terá duas casas decimais. Se o valor percentual for maior que 10, o número será arredondado para o número inteiro mais próximo. Você também pode especificar quantas casas decimais deseja usar, que são usadas de forma consistente em toda a sua história.

### Conteúdo

Você pode atribuir significado a valores maiores. Por exemplo, valores maiores para vendas são bons, mas valores maiores para perdas são ruins.

Além disso, você pode escolher como agregar valores por soma ou média. É uma prática recomendada escolher o mesmo método de agregação que você está usando na visualização. Para medidas de proporção, escolha Média e defina a proporção selecionando as medidas de componente dessa medida de proporção. As medidas que são componentes de uma razão devem ser somadas.

![Menu de configurações aberto na guia Características com agregado definido como média, proporção ativada e uma proporção criada para lucro e vendas.](/tableau/current/pt-br/server/pt-br/Img/data_stories_ratio.png)

Para medidas cumulativas (disponíveis apenas para histórias contínuas), escolha **Soma** e especifique que a medida já é cumulativa. Histórias contínuas escrevem sobre o total da medida em toda a série.

### Classificação

Para classificar valores de dimensão, clique no ícone de seta para cima/para baixo para classificar com base nos valores de tempo mais antigos ou mais recentes em sua dimensão.

**Observação:** a classificação de valores de dimensão está disponível apenas para histórias contínuas.

<!-- document id=edbcac5bfc0ea404fa44d9b277a053f60e066b42c01c7f3f741d52ed921c0b9c url=/tableau/current/pt-br/server/data_stories_narrative.md -->

[Pular para o conteúdo principal](#main-content)

# Definir as configurações de História com dados do Tableau: narrativa

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Você pode personalizar as configurações narrativas da sua História com dados do Tableau. Especificamente, você pode especificar o detalhamento e o nível de detalhes analíticos em sua história e pode adicionar termos exclusivos aos seus dados. Essas configurações ajudam você a escrever uma história que usa a linguagem certa e fala com o nível certo de detalhes para seu painel.

## Definir a verbosidade

A verbosidade especifica a extensão e os detalhes analíticos escritos em sua história. Se você escolher muita verbosidade, sua história terá informações mais longas com análise mais analítica. Se você escolher pouca verbosidade, sua história será mais concisa com menos detalhes.

Se você permitir que os visualizadores alterem o detalhamento, os visualizadores de painéis publicados poderão alterar o nível de detalhamento no objeto História com dados. Isso é útil quando seu painel é usado por um público mais amplo com espectadores que desejam níveis variados de detalhes de sua história.

## Definir detalhamentos

Um detalhamento inclui duas dimensões e os detalhamentos descrevem figuras associadas a cada dimensão do seu painel.

Digamos que você tenha um painel que tenha vendas mensais por categoria de produto. Sua história está configurada para escrever sobre as dimensões **Tempo** e **Categoria**. Nesse caso, esta história inclui uma informação para cada Categoria que descreve seu desempenho na e através da dimensão **Tempo**.

Ao definir o número máximo de detalhamentos, você pode controlar quantas informações são incluídas em sua história. As informações de detalhamento também são classificadas com base no significado atribuído às características da medida. À medida que o número de pesquisas é reduzido, as medidas de desempenho mais baixo (medidas que recebem um significado Ruim) são eliminadas.

## Adicionar termos de dimensão

Ao adicionar termos, você pode definir a maneira como cada uma de suas medidas e dimensões são rotuladas e referenciadas em sua história.

1. [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm).
2. No seu painel, clique no ícone Configurações no canto superior esquerdo do objeto Histórias com dados.
3. Na caixa de diálogo Histórias com dados, clique na guia Narrativa.
4. Expanda a dimensão para ver como ela será escrita tanto no singular quanto no plural.
5. Clique em Adicionar termo para adicionar outra variação para sua história usar para descrever sua dimensão.
6. Clique em Salvar.

Sua história usa (aleatoriamente) os termos que você adicionou ao escrever sobre uma dimensão.

## Gerenciar rótulos de medida

Da mesma forma que as dimensões, você pode gerenciar rótulos usados para medidas em sua história.

1. Na guia Narrativa, expanda a medida para ver seu rótulo.
2. Insira o novo rótulo que você deseja usar para sua medida.
3. Clique em Salvar.

<!-- document id=5b025aeb994123cc0013220902d5ffe5da0a10d1040ba616d6e011edb9b9c151 url=/tableau/current/pt-br/server/data_stories_configure_edit.md -->

[Pular para o conteúdo principal](#main-content)

# Definir configurações para história com dados do Tableau

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Depois de você [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm), poderá configurar e editar História com dados do Tableau completa para que ela seja adaptada às suas necessidades – use um idioma específico para seus dados, especifique sobre quais análises são escritas e personalize como a História com dados do Tableau é exibida.

## Outros artigos nesta seção

<!-- document id=f229da551868344be6dca745a87e3e6ecc2d03ca336555d1548100a4bbbdce87 url=/tableau/current/pt-br/server/users_site_roles.md -->

[Pular para o conteúdo principal](#main-content)

# Definir funções dos usuários no site

Ao adicionar usuários a um site no Tableau Server, independente do tipo de licença deles, é necessário designá-lo uma _função no site_. A função no site significa o nível máximo de acesso que um usuário pode ter no site. Juntamente com as permissões de conteúdo, a função no site determina quem pode publicar, interagir ou apenas exibir o conteúdo publicado, ou quem pode gerenciar os usuários e administrar o próprio site.

Procurando o Tableau Server no Linux? Consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server-linux/pt-br/users_site_roles.htm "Abre o tópico em uma nova guia do navegador").

## Como as licenças de usuário, funções de site e permissões de conteúdo funcionam juntas

A interseção de um tipo de licença do usuário, função no site e permissões de conteúdo determinam o nível de acesso que um usuário dispõe no site do Tableau.

**Observação:** a contagem do nível de licença na parte superior do cabeçalho na guia Usuários do servidor pode ser diferente da contagem no filtro Função máxima do usuário devido ao fato de alguns usuários terem funções diferentes nos sites.

1. O tipo de licença está associado ao usuário. A função que deseja atribuir ao usuário no site determina o tipo de licença que ele exige.
    
    Em um ambiente de vários sites no Tableau Server, uma licença de usuário se aplica a todos os sites que o usuário for membro.
2. A função no site também está definida no nível de usuário. Em um ambiente de vários sites, você atribui funções de site em cada um deles. Por exemplo, o mesmo usuário pode ter a função “Creator de administrador de site” em um site e a função Viewer em outro.
    
    A função de site define os recursos máximos que o usuário pode ter.
3. A disponibilidade dos recursos máximos da função no site para usuários depende do conjunto de permissões nos recursos de conteúdo (projetos, fontes de dados, pastas de trabalho).

Por exemplo, digamos que um usuário dispõe do seguinte acesso em um site:

- Licença de Creator (devido ao acesso em outro site)
- Função no site de Explorer (neste site)
- Capacidade de permissão de salvar em um projeto (neste site)

Nesse cenário, a licença permite conectar e criar novas fontes de dados no ambiente de edição na Web ou no Tableau Desktop, e uma regra de permissão permite que eles salvem em um projeto. No entanto, sua função de site os impede de salvar, portanto, suas permissões efetivas não incluem o recurso de salvamento. O usuário ou o grupo não pode publicar conteúdo no projeto.

Mesmo que um usuário tenha uma licença de Creator e uma função de site de Creator, se ele não tiver o recurso de salvar em pelo menos um projeto, ele não poderá publicar algo no site.

Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

## Alterar a função de site de um usuário

1. Faça logon no site como administrador do servidor ou do site, ou como um usuário com um perfil de administrador com permissões suficientes, e acesse a área Usuários.
    
    Se você for um administrador de site e não visualizar a área Usuários, verifique com o administrador de servidor se ele negou os recursos de gerenciamento de usuários para os administradores de site.
2. Selecione os usuários e, em seguida, selecione Ações > Função de site.
    
    ![Uma tabela de usuários do site com um menu suspenso aberto mostra a opção para remover usuários.](/tableau/current/pt-br/server/pt-br/Img/users_siterole_change.png)
3. Selecione a nova função de site e clique em Alterar função de site.
    
    ![Selecione a nova função do site.](/tableau/current/pt-br/server/pt-br/Img/users_siterole_change_select_new.png)
    
    Você pode passar o ponteiro do mouse sobre o ícone de informações para exibir uma matriz, que mostra o nível máximo de recursos gerais que cada função de site permite. Para obter mais informações, vá até [Recursos gerais permitidos com cada função de site](#site-role-capabilities-summary).

## Recursos gerais permitidos com cada função de site

A tabela a seguir lista os tipos de licença, o nível mais alto de função no site permitido com cada um deles e resume os recursos máximos permitidos por cada função no site.

### O que este artigo abrange e onde encontrar o que não apresentamos aqui

- Essas informações se concentram em funções no _site_ e são mais generalizadas. Para obter uma lista de tarefas específicas comuns disponíveis de acordo com a função da _licença_, consulte a matriz na guia [Para equipes e organizações](https://www.tableau.com/pt-br/pricing/teams-orgs "Abra a página de preços do Tableau para ver o licenciamento baseado em assinatura em uma nova janela do navegador.") da página de preços do Tableau.
- Para saber mais sobre a relação entre o licenciamento baseado em núcleo e o licenciamento baseado no usuário, como as licenças são transferidas ou outros cenários de transição específicos do licenciamento, comece pelos seguintes tópicos:
    
    [Migrar do licenciamento baseado em núcleo para o licenciamento baseado em função](https://help.tableau.com/current/server/pt-br/licensing_migrate_from_core.htm)
    
    [Solucionar problemas de licenciamento](https://help.tableau.com/current/server/pt-br/unlicensed.htm)
    
    [Modelo de licença baseada em núcleo](https://help.tableau.com/current/server/pt-br/license_product_keys.htm#Core-bas) (Conhecer os modelos de licença e chaves do produto)

### Funções de site do Tableau

<table class="simple-table" style="width: 100%;"><colgroup><col style="width:20%"><col style="width:60%"></colgroup><thead><tr><th style="background-color:#ccc;">Nome de função de site</th><th style="background-color:#ccc;">Recursos máximos que esta função no site permite</th></tr></thead><tbody><tr><th colspan="2" style="background-color:#eaeaea;"><p><strong>Funções no site que usam uma licença de <span class="mc-variable Variables.sku-creator variable">Creator</span></strong></p></th></tr><tr><td colspan="2"><p>—Os usuários com essas funções no site têm acesso aos clientes do Tableau, como Tableau Prep, <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>, Tableau Bridge e Tableau&nbsp;Mobile.</p></td></tr><tr><td><p>Administrador de servidor</p></td><td><p>Disponível apenas no Tableau Server; não se aplica ao Tableau Cloud.</p><p>Esta função no site sempre ocupa a licença mais alta ativada no servidor entre o Creator e o Explorer. Ela permite acesso irrestrito às definições de configuração do ambiente do navegador do Tableau Server para todos os sites no servidor, a usuários e grupos, além de todos os ativos de conteúdo, como fluxos, projetos, fontes de dados (incluindo informações de conexão) e pastas de trabalho.</p><p>Conecte-se às fontes de dados publicadas ou dados externos do Tableau por meio do navegador, <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou Tableau Prep; crie e publique novas fontes de dados; crie e publique pastas de trabalho.</p></td></tr><tr><td><p><span class="mc-variable Variables.siterole-siteadmin-author variable">Creator (Administrador de site)</span></p></td><td><p>Este é o nível de acesso mais elevado para o Tableau Cloud.</p><p>Acesso irrestrito ao conteúdo, conforme descrito acima, mas no nível do site. Conecte-se ao Tableau ou dados externos no navegador, <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou Tableau Prep; crie novas fontes de dados; crie e publique conteúdo.</p><p>No Tableau Server, os administradores de servidor podem ou não permitir que os administradores de site gerenciem usuários e atribuam funções de site e associação ao site. Por padrão, no Tableau Server e sempre no Tableau Cloud, esses recursos são permitidos aos administradores de site.</p></td></tr><tr><td><p><span class="mc-variable Variables.siterole-author variable">Creator</span></p></td><td><p>Isso é semelhante à antiga função Publicador, mas permite novos recursos. Essa função do usuário no site oferece a não administradores o nível máximo de acesso ao <em>conteúdo</em>.</p><p>Conecte-se ao Tableau ou a dados externos no navegador, crie e publique fluxos, fontes de dados e pastas de trabalho, tenha acesso aos Dashboard Starters e use recursos de interação nas exibições publicadas. Também pode se conectar aos dados do Tableau Prep ou do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>, publicar (fazer upload/salvar) e baixar fluxos, pastas de trabalho e fontes de dados.</p><p>Essa função no site pode receber um perfil de administrador que concede recursos administrativos específicos sem acesso a todo o conteúdo.</p></td></tr><tr><th colspan="2" style="background-color:#eaeaea;"><p>Funções no site que usam uma licença de <span class="mc-variable Variables.sku-explorer variable">Explorer</span></p></th></tr><tr><td colspan="2"><p>—Os usuários com essas funções no site podem acessar o servidor no navegador ou no Tableau Mobile.</p></td></tr><tr><td><p>Administrador de servidor</p></td><td><p>Apenas no Tableau Server; não se aplica ao Tableau Cloud.</p><p>Se o Explorer for o tipo de licença mais alto ativado no servidor quando um novo usuário administrador de servidor for criado, a função de site do usuário será Administrador de servidor. No entanto, o usuário não terá todos os recursos de conexão e publicação que vêm apenas com a licença Creator.</p><p>Com a licença de Explorer, um administrador de servidor tem acesso irrestrito às definições de configuração do ambiente do navegador do Tableau Server para todos os sites no servidor, a usuários e grupos, além de todos os ativos de conteúdo, como projetos, fluxos, fontes de dados (incluindo informações de conexão) e pastas de trabalho.</p><p>No entanto, com a licença do Explorer, um Administrador do servidor não pode se conectar a dados externos do navegador para criar uma nova fonte de dados. Ele pode criar ou publicar pastas de trabalho e fontes de dados do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>. Com relação à publicação, eles têm os mesmos recursos que a função de site Explorer (pode publicar). Eles não podem publicar fluxos do Tableau Prep.</p></td></tr><tr><td><p>Explorer (Administrador de site)</p></td><td><p>Mesmo acesso ao site e à configuração de usuário que o Creator (Administrador de site), mas não pode se conectar a dados externos ou a conexões virtuais no ambiente de edição na Web.</p><p>Pode se conectar às fontes de dados do Tableau para criar novas pastas de trabalho, assim como editar e salvar pastas de trabalho existente. Não é possível editar e salvar fluxos existentes. Não é possível publicar fluxos do Tableau Prep.</p></td></tr><tr><td><p>Explorer (pode publicar)</p></td><td><p>Pode publicar pastas de trabalho da Web usando as fontes de dados existentes, navegar e interagir com exibições publicadas e usar todos os recursos de interação.</p><p>No ambiente de edição na Web, é possível editar e salvar as pastas de trabalho existentes. Não é possível salvar novas fontes de dados independentes nas conexões de dados inseridas nas pastas de trabalho e não é possível se conectar a dados externos ou conexões virtuais e criar novas fontes de dados. Pode executar fluxos se as permissões <span class="uicontrol">Executar fluxos</span> forem concedidas. Não é possível editar e salvar fluxos existentes.</p><p>Essa função no site pode receber um perfil de administrador que concede recursos administrativos específicos sem acesso a todo o conteúdo.</p></td></tr><tr><td><p>Explorer</p></td><td><p>Pode navegar e interagir com exibições publicadas. Pode assinar conteúdo, criar alertas orientados por dados, se conectar às fontes de dados publicadas do Tableau e abrir pastas de trabalho no ambiente de criação na Web para consultas de ad hoc, mas não pode salvar o trabalho. Não é possível conectar-se a uma conexão virtual Não é possível publicar ou executar fluxos do Tableau Prep, mesmo se as permissões <span class="uicontrol">Executar fluxos</span> forem concedidas. Não é possível editar e salvar fluxos existentes.</p><p>Essa função no site pode receber um perfil de administrador que concede recursos administrativos específicos sem acesso a todo o conteúdo.</p></td></tr><tr><th colspan="2" style="background-color:#eaeaea;"><p>Funções no site que usam uma licença de Viewer</p></th></tr><tr><td><p>Viewer</p></td><td><p>É possível ver as exibições publicadas criadas por outros e usar a maioria dos os recursos de interação. É possível assinar as exibições e fazer download como imagens ou dados de resumo. Não é possível conectar-se a dados; criar, editar ou publicar conteúdo; definir alertas de dados; ou receber um perfil de administrador.</p><p>Para obter uma lista de recursos específicos, consulte a coluna <strong>Viewer</strong> na matriz, na <a alt="Link opens the Tableau license pricing page in a new browser tab" href="https://www.tableau.com/pt-br/pricing/teams-orgs" target="_blank" title="O link abre a página de preços do Tableau em uma nova guia do navegador">página de preços do Tableau</a>.</p></td></tr><tr><th colspan="2" style="background-color:#eaeaea;"><p>Outras funções de site</p></th></tr><tr><td><p>Não licenciado</p></td><td><p>Usuários não licenciados não podem fazer logon no <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> ou no <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>. Os usuários recebem a função de Não licenciado nas seguintes circunstâncias:</p><ul><li><p>você importa usuários de um arquivo CSV e seu nível de licença é definido como não licenciado.</p></li><li><p>O número de licenças disponíveis é atingindo no momento que você adiciona ou importa os usuários.</p></li><li><p>Você remove um usuário que é proprietário do conteúdo no site. O usuário continuará como proprietário do conteúdo, mas não poderá fazer nada com ele.</p></li><li><p>Uma chave do produto expirou. Consulte <a href="https://help.tableau.com/current/server/pt-br/license_refresh.htm" class="xref">Atualizar data de expiração e atributos da chave do produto</a>.</p></li></ul><p></p></td></tr></tbody></table>

## Quem pode publicar conteúdo

As funções de site a seguir permitem o nível especificado de acesso de publicação.

- Administrador do servidor (apenas no Tableau Server), Creator (Administrador de site) e Creator permitem acesso completo de conexão e publicação.
    
    Isso inclui a conexão a dados e à publicação de novos fluxos, novas pastas de trabalho e novas fontes de dados do Tableau Desktop e do ambiente de edição na Web. Além disso, as funções de site permitem editar e salvar pastas de trabalho publicadas existentes, ou publicação de atualizações em fontes de dados existentes.
- O Explorer (pode publicar) e o Explorer (Administrador de site) possuem recursos de publicação limitados, conforme descrito em [Recursos gerais permitidos com cada função de site](#site-role-capabilities-summary).
- Explorer, Viewer , Somente leitura e Não licenciado não permitem publicação.

## Funções de site, importação e sincronização do Active Directory

Quando você importa usuários de um diretório externo como o Active Directory, pode especificar a função do site. Se um usuário não for ainda um membro de qualquer site no servidor, ele será adicionado ao site com a função atribuída. Ao sincronizar grupos de um diretório externo, a função de site será aplicada através da configuração Função mínima do site na página Grupos - Detalhes.

**Observação:** no contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas.

Se um usuário já existir no site do Tableau Server, a função de site atribuída durante o processo de importação ou sincronização será aplicada, se conceder ao usuário mais acesso ao site. A importação ou a sincronização de grupos e usuários AD pode promover a função no site de um usuário, mas não rebaixa essa função.

Se o usuário já tem a capacidade de publicar, essa capacidade será mantida.

A matriz abaixo mostra as regras aplicadas a funções de site na importação.

**Observação:** os cabeçalhos abreviados da linha **Importar função de site** indicam a função de site especificada para importação. Os cabeçalhos da coluna **Função de site atual** representam a função de site do usuário atual. Os valores da tabela representam a função de site resultante abreviada.

- Administrador de site:SA
- Creator (Administrador de site): CS
- Explorer (Administrador de site): ES
- Creator: C
- Explorer: E
- Explorer (pode publicar): EP
- Viewer: V
- Não licenciado:U

<table class="simple-table" style="width: 100%;"><colgroup><col style="width: 30%;"><col style="width: 10%;"><col style="width: 5%;"><col style="width: 5%;"><col style="width: 5%;"><col style="width: 10%;"><col style="width: 10%;"><col style="width: 10%;"></colgroup><thead><tr><th style="background-color: #ffffff;padding-left: 5px;padding-right: 5px;padding-top: 5px;padding-bottom: 5px;border-right-style: solid;border-right-width: 1px;border-right-color: #000000;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #000000;">&nbsp;</th><th colspan="7" style="text-align: center;background-color: #808080;padding-left: 5px;padding-right: 5px;padding-top: 5px;padding-bottom: 5px;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #000000;">Função de site atual</th></tr></thead><thead><tr><th style="background-color: #808080;padding-left: 5px;padding-right: 5px;padding-top: 5px;padding-bottom: 5px;border-right-style: solid;border-right-width: 1px;border-right-color: #000000;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #000000;">Importar a função do site</th><th style="background-color: #dcdcdc;"><p>CS</p></th><th style="background-color: #dcdcdc;"><p>C</p></th><th style="background-color: #dcdcdc;"><p>ES</p></th><th style="background-color: #dcdcdc;"><p>EP</p></th><th style="background-color: #dcdcdc;"><p>E</p></th><th style="background-color: #dcdcdc;"><p>V</p></th><th style="background-color: #dcdcdc;"><p>U</p></th></tr></thead><tbody><tr><td style="background-color: #dcdcdc;font-weight: bold;"><p>Creator (Administrador de site)</p><p>(CS)</p></td><td>CS</td><td>CS</td><td>CS</td><td>CS</td><td>CS</td><td>CS</td><td>CS</td></tr><tr><td style="background-color: #dcdcdc;font-weight: bold;"><p>Explorer (Administrador de site)</p><p>(ES)</p></td><td>CS</td><td>ES</td><td>ES</td><td>ES</td><td>ES</td><td>ES</td><td>ES</td></tr><tr><td style="background-color: #dcdcdc;font-weight: bold;"><p>Creator</p><p>(C)</p></td><td>CS</td><td>C</td><td>ES</td><td>C</td><td>C</td><td>C</td><td>C</td></tr><tr><td style="background-color: #dcdcdc;font-weight: bold;"><p>Explorer (pode publicar)</p><p>(EP)</p></td><td>CS</td><td>C</td><td>ES</td><td>EP</td><td>EP</td><td>EP</td><td>EP</td></tr><tr><td style="background-color: #dcdcdc;font-weight: bold;"><p>Explorer</p><p>(E)</p></td><td>CS</td><td>C</td><td>ES</td><td>EP</td><td>E</td><td>E</td><td>E</td></tr><tr><td style="background-color: #dcdcdc;font-weight: bold;"><p>Viewer</p><p>(V)</p></td><td>CS</td><td>C</td><td>ES</td><td>EP</td><td>E</td><td>V</td><td>V</td></tr><tr><td style="background-color: #dcdcdc;font-weight: bold;"><p>Não licenciado</p><p>(U)</p></td><td>CS</td><td>C</td><td>ES</td><td>EP</td><td>E</td><td>V</td><td>U</td></tr></tbody></table>

<!-- document id=203ec48fb3abeab40f7ac4915ca39ad7a409ef0b76e8c03e238c8a49697df8a9 url=/tableau/current/pt-br/server/tz_for_extracts.md -->

[Pular para o conteúdo principal](#main-content)

# Definir o fuso horário do site para extrações

O fuso horário padrão para as fontes de dados baseadas em extrações em um site é o Tempo Universal Coordenado (UTC). Os administradores do Server podem definir um fuso horário diferente.

Para definir o fuso horário do site para extrações:

1. Entre no Tableau como um administrador.
2. No site que deseja configurar, clique em `Settings`.
3. Na seção `Site Time Zone for Extracts`, selecione um fuso horário e clique em `Save`.

Em campos calculados, as funções como NOW() ou TODAY() se baseiam no fuso horário. Para obter mais informações sobre Extrações, consulte [Extrair seus dados](https://help.tableau.com/current/pro/desktop/pt-br/extracting_data.htm) na Ajuda do Tableau Desktop.

A configuração do fuso horário, além de ser usada para fontes de dados baseadas em extrações, também afeta as extrações internas. Por exemplo, quando o Tableau se conecta a fontes de dados baseadas em arquivo, como arquivos de texto, uma extração é automaticamente criada internamente. Da mesma forma, isso acontece quando o Tableau usa uma extração interna para integrar dados de diferentes fontes.

A configuração do fuso horário também afeta como as legendas do filtro de data relativa são renderizadas.

**Observação:** ao visualizar uma pasta de trabalho em um navegador, as legendas de filtro de data relativa (por exemplo, “últimos 7 dias”) são exibidas usando seu fuso horário local. No entanto, os arquivos exportados (Baixar > Imagem ou Download > PDF) são renderizados no pod do Tableau Cloud, que usa o fuso horário do pod. Isso pode fazer com que a legenda do filtro exportada seja diferente da visualização do seu navegador em até um dia. Isso afeta apenas o texto da legenda e seus dados subjacentes permanecem precisos. Para manter legendas consistentes no navegador e nas exibições exportadas, use um **Intervalo de datas** Em vez disso, filtre com datas de início e término fixas.

<!-- document id=d1984494ad3011aad1e5c9c310e04a0913afedf198f12d8557a41755ee3bf569 url=/tableau/current/pt-br/server/users_set_auth_type.md -->

[Pular para o conteúdo principal](#main-content)

# Definir o tipo de autenticação do usuário para SAML

Em um site que foi configurado para administradores SAML específicos do site, os administradores podem especificar o tipo de autenticação dos usuários. Por exemplo, se Tableau Server tiver sido configurado para SAML específico de site e SAML em todo o servidor, os administradores podem especificar que usuários autenticam com SAML específico do site e que usuários autenticam com SAML em todo o servidor.

Você pode atribuir o método de autenticação no momento que adiciona usuários ao Tableau Server, assim como em qualquer momento posterior.

1. Quando você tiver efetuado logon no site do Tableau Server, selecione **Usuários**.
2. Na página Usuários dosite, marque as caixas de seleção próximas aos usuários que receberão um tipo de autenticação.
3. No menu Ações, selecione Autenticação.
    
    ![Um menu de ações com a opção de autenticação.](/tableau/current/pt-br/server/pt-br/Img/users_set_authentication.png)
4. Na caixa de diálogo Autenticação, selecione SAML de site ou Padrão do site.

## Observações

- Usuários que se autenticam com um SAML específico do site somente podem pertencer a um site. Se um usuário precisar pertencer a vários sites, defina o tipo de autenticação para o padrão do servidor. Dependendo de como o SAML específico a cada site foi configurado pelo administrador do servidor, o padrão do servidor é SAML de autenticação local ou de todo o servidor.
- Se você alterar a autenticação dos usuários de SAML específico do site, na próxima vez que efetuarem logon, eles serão direcionados ao site do provedor de identidade para fornecer as credenciais.

<!-- document id=d7019f2ee61c83d58f3525abd2b9afeed6b19af777e8b94ab83ff140d1917f67 url=/tableau/current/pt-br/server/dm_dqw.md -->

[Pular para o conteúdo principal](#main-content)

# Definir um aviso de qualidade de dados

Os avisos de qualidade de dados são um recurso de Tableau Catalog, parte da oferta do Data Management para Tableau Server e Tableau Cloud. (Para obter mais informações sobre Tableau Catalog, consulte "Sobre o Tableau Catalog”, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm).)

Quando o Tableau Catalog está habilitado em seu ambiente, você pode definir avisos de qualidade de dados em ativos de dados, para que os usuários desses dados estejam cientes dos problemas. Por exemplo, você pode desejar que os usuários saibam que uma fonte de dados ficou obsoleta ou que uma atualização falhou para uma fonte de dados de extração.

Você pode definir avisos de qualidade de dados em fontes de dados, bancos de dados, tabelas, fluxos, conexões virtuais, tabelas de conexão virtual e colunas.

Avisos de qualidade de dados para fontes de dados, bancos de dados, tabelas e fluxos foram introduzidos na versão 2019.3 para Tableau Cloud e Tableau Server. Avisos de qualidade de dados para conexões virtuais e tabelas de conexões virtuais foram adicionados no Tableau Cloud de março de 2022 e no Tableau Server 2022.1, e para colunas no Tableau Cloud de outubro de 2022 e no Tableau Server 2022.3.

## Sobre os avisos de qualidade de dados

Há dois tipos de avisos de qualidade de dados: avisos de qualidade que você define e avisos de qualidade que o Tableau define, quando uma atualização de extração ou execução de fluxo falha, também conhecidos como avisos de monitoramento de qualidade.

- **Avisos de qualidade que você define**: um aviso de qualidade definido fica visível para os usuários até que você ou outro usuário o remova.
- **Monitoramento de aviso de qualidade**: se você ativar um aviso de qualidade de monitoramento para um ativo de extração ou fluxo, o Tableau adicionará automaticamente um aviso de qualidade ao ativo quando uma atualização de extração ou execução de fluxo falhar. Posteriormente, se a atualização da extração ou a execução do fluxo forem bem-sucedidas, o Tableau removerá automaticamente o aviso de qualidade.

A partir do Tableau Cloud de outubro de 2023 e do Tableau Server 2023.3, além de definir avisos de monitoramento no nível do ativo, você também pode ativar ou desativar a atualização de extrações e o monitoramento de execução de fluxo para todo o site de uma só vez. Para obter informações sobre monitoramento em todo o site, consulte [Monitoramento em todo o site para atualização de extração e falhas na execução de fluxo](#sitewide_monitoring_dqw).

**Observação:** você pode ativar e modificar os dois tipos de avisos de qualidade de dados usando a API REST. Para obter mais informações, consulte o rótulo e aviso de qualidade de dados dos [Métrodos de metadados](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_metadata.htm) do Tableau na Ajuda da API REST do Tableau.

## Onde aparecem os avisos de qualidade de dados

No Tableau Cloud e no Tableau Server, quando você define um aviso em uma fonte de dados, fluxo, banco de dados, tabela, coluna, conexão virtual ou tabela de conexão virtual, o aviso fica visível para os usuários do ativo e qualquer ativo downstream dele. Por exemplo, um conjunto de avisos em uma tabela é visível para usuários que procuram um painel que dependem dessa tabela. Os usuários veem um ícone de aviso na guia Detalhes dos dados do painel e podem abrir o painel para ver mais informações.

![Aviso de qualidade de dados no painel Detalhes de dados](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_server_wkbk.png)

Avisos de qualidade de dados aparecem ao explorar alguns tipos de conteúdo em uma exibição de lista:

![Coluna de aviso de qualidade de dados na exibição de lista](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_list_view.png)

Os avisos de qualidade de dados também aparecem na parte superior das páginas de ativos:

![Aviso de qualidade de dados na página de recursos](/tableau/current/pt-br/server/pt-br/Img/dm_label_dqw_masthead.png)

No Tableau Desktop, os usuários veem um ícone próximo à fonte de dados no painel Dados quando

- Há um aviso em uma fonte de dados usada na pasta de trabalho ou
- há um aviso upstream na fonte de dados usada na pasta de trabalho

Observação: os avisos de qualidade de dados para colunas e conexões não precisam aparecem no Tableau Desktop.

Para ver os detalhes do aviso, focalize o ícone de aviso.

![Aviso de qualidade de dados no Painel Dados](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_label_in_data_pane.png)

Além disso, na Criação na Web do Tableau Cloud, você pode visualizar todas as propriedades de rótulo de um objeto no painel de dados (conexão de dados ou campo) selecionando Detalhes do catálogo na conexão de dados ou campo.

### Visibilidade

Os avisos de qualidade de dados podem ser classificados como de alta visibilidade. Avisos de qualidade de alta visibilidade parecem mais urgentes e aparecem em mais lugares. Por exemplo, um aviso de alta visibilidade em uma fonte de dados gera uma notificação quando alguém abrir uma visualização que dependa dela.

![Exibição publicada com informações de aviso de qualidade de dados](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_hv_alert.png)

O ícone e o emblema dos avisos de qualidade de alta visibilidade são amarelos ou laranja, enquanto os avisos de qualidade de visibilidade padrão são azuis.

Se mais de um aviso de qualidade se aplicar a um ativo (porque o ativo tem mais de um aviso de qualidade ou herda avisos upstream), o crachá inclui um número e a cor é determinada pelo rótulo de maior visibilidade. Por exemplo, se dois avisos de qualidade se aplicarem a um ativo, um dos quais com visibilidade padrão e outro com alta visibilidade, o selo será amarelo ou laranja.

![](/tableau/current/pt-br/server/pt-br/Img/dm_label_dqw_badge_2_labels.png)

## Avisos de qualidade de dados em assinaturas

Os administradores podem ativar avisos de qualidade de dados em assinaturas de e-mail. Se este recurso estiver ativado, os e-mails que os usuários recebem incluem avisos de qualidade de dados de alta visibilidade para essa exibição, com links para:

- Exibições ou pastas de trabalho relevantes com o painel Detalhes dos dados aberto.
- Ativos upstream relevantes, como fontes de dados, tabelas ou bancos de dados.

Os administradores podem ativar os avisos de qualidade de dados em assinaturas de email selecionando a opção Rótulos de dados de alta visibilidade nas assinaturas de exibição e pasta de trabalho (anteriormente, a opção Avisos de qualidade de dados em assinaturas) na página de configurações do site Tableau Server ou Tableau Cloud. Para obter mais informações, consulte [Rótulos de dados de alta visibilidade em assinaturas de exibição e de pasta de trabalho](https://help.tableau.com/current/server/pt-br/sites_add.htm#data-quality-warnings-in-subscriptions) na Referência de configurações do site.

## Como definir um aviso de qualidade

Você pode definir vários avisos de qualidade de dados diferentes em um ativo. A partir do Tableau Cloud de junho de 2023 e Tableau Server 2023.3, um administrador pode adicionar à lista de avisos de qualidade de dados disponíveis [personalizando rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm).

A partir do Tableau Cloud de junho de 2023 e Tableau Server 2023.3, "dados confidenciais" não são mais um aviso de qualidade de dados, mas sim um rótulo de sensibilidade. Para obter mais informações, consulte [Rótulos de sensibilidade](https://help.tableau.com/current/server/pt-br/dm_labels_sensitivity.htm). No Tableau Server 2023.1 e anterior, os "dados confidenciais" continuam sendo um aviso de qualidade de dados.

Os seguintes avisos de qualidade de dados são integrados:

- Aviso
- Obsoleto
- Dados obsoletos
- Sob manutenção

Para anexar um aviso de qualidade de dados a um ativo:

Observação: a partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar e remover avisos de qualidade usando a caixa de diálogo consolidada de Rótulos de dados em vez de caixas de diálogo separadas para cada tipo de rótulo. Para obter informações sobre a caixa de diálogo Rótulos de dados, consulte [A caixa de diálogo Rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#data-labels-dialog).

1. Pesquise ou navegue até o ativo. As etapas de navegação dependem do tipo de ativo ao qual você deseja adicionar o aviso de qualidade:

- Fonte de dados ou conexão virtual - na página Explorar, selecione Todas as fontes de dados ou Todas as conexões virtuais.
- Tabela de conexão virtual - na página Explorar, selecione Todas as conexões virtuais e selecione a conexão virtual que contém a tabela de conexão virtual que você deseja certificar. Em seguida, selecione a tabela de conexão virtual.
- Banco de dados ou tabela - na página Explorar, navegue até o banco de dados ou tabela. Na página Ativos externos, selecione Bancos de dados e arquivos ou Tabelas e objetos.
- Coluna – na página Explorar, navegue até a tabela. Na página Ativos externos, selecione Tabelas e objetos de dados e navegue até a tabela. Em seguida, encontre a coluna na lista.

3. Selecione o menu de ações (. . .) ao lado do ativo e em seguida selecione Rótulos de dados > Aviso de qualidade de dados. (Para colunas no Tableau Server 2022.3 e versões anteriores, selecione a coluna e clique no menu suspenso de ações e selecione Aviso de qualidade.)  
    ![Menu suspenso Rótulos de dados com o cursor selecionando "Aviso de qualidade de dados..."](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_quality_warning_menu.png)
4. Marque a caixa de seleção ao lado dos avisos de qualidade que você deseja anexar ao ativo. Como opção, se você souber o nome de um aviso de qualidade, poderá pesquisá-lo na parte superior da caixa de diálogo e marcar a caixa de seleção ao lado dele. (No Tableau Server 2023.3 e versões anteriores, você só pode anexar um aviso de qualidade a cada ativo. Use o botão de alternância Mostrar aviso ou a caixa de seleção Ativar aviso para ativar um aviso de qualidade para esse ativo e selecione o aviso desejado na lista suspensa.)
5. Defina o nível de visibilidade.
6. Se desejar, insira uma mensagem para exibir aos usuários. (No Tableau Server 2023.3 e anterior, uma mensagem é necessária.) Você pode formatar o texto em uma mensagem com negrito, sublinhado e itálico e incluir um link ou uma imagem. Para ver dicas de formatação de texto, clique no ícone de informações (i) acima do botão Salvar.  
    ![Caixa de diálogo Rótulos de dados com a guia Aviso de qualidade selecionada](/tableau/current/pt-br/server/pt-br/Img/dm_label_data_labels_dialog_dqw.png)
7. Selecione Salvar.

## Remover um aviso de qualidade de dados

Quando um aviso não se aplica mais, você pode removê-lo navegando até o ativo de dados com o aviso.

Observação: a partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar e remover avisos de qualidade usando a caixa de diálogo consolidada de Rótulos de dados em vez de caixas de diálogo separadas para cada tipo de rótulo. Para obter informações sobre a caixa de diálogo Rótulos de dados, consulte [A caixa de diálogo Rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#data-labels-dialog).

1. Selecione o menu de ações (. . .) ao lado do ativo e selecione Aviso de qualidade. (Para colunas no Tableau Server 2022.3 e versões anteriores, selecione a coluna e clique no menu suspenso de ações e selecione Aviso de qualidade.)
2. Desmarque as caixas ao lado dos avisos de qualidade que você deseja remover do ativo. (No Tableau Server 2023.3 e versões anteriores, use o botão de alternância Mostrar aviso ou a caixa de seleção Ativar aviso para desativar um aviso de qualidade para esse ativo.)
3. Desligue o aviso.
4. Selecione Salvar.

## Como ativar um aviso de qualidade de monitoramento

Você pode configurar o Tableau para monitorar dois eventos: extrair falha de atualização da fonte de dados e falha de execução de fluxo. Quando o evento ocorre, o Tableau gera um aviso de qualidade que aparece nos mesmos locais que um aviso manual de qualidade.

Você pode ativar o monitoramento explicitamente na extração ou com fluxo ou, a partir do Tableau Cloud de outubro de 2023 e do Tableau Server 2023.3, você pode ativar o monitoramento em todo o site para todas as atualizações de extração e falhas de execução de fluxo. Para obter informações sobre monitoramento em todo o site, consulte [Monitoramento em todo o site para atualização de extração e falhas na execução de fluxo](#sitewide_monitoring_dqw).

Para monitorar explicitamente uma atualização de extração ou uma falha na execução do fluxo:

1. Selecione o menu de ações (. . .) ao lado da fonte de dados de extração ou fluxo para o qual deseja criar um aviso e, em seguida, selecione a opção apropriada:

- No Tableau Cloud e Tableau Server 2023.3 e posterior:

- Dados qualidade > Monitoramento de atualização de extração
- Rótulos de dados > Monitoramento de execução de fluxo

- No Tableau Server 2023.1 e versões anteriores:

- Aviso de qualidade > Monitoramento de atualização de extração
- Aviso de qualidade > Monitoramento de execução de fluxo

3. Ative o aviso.
4. Defina o nível de visibilidade. (Versões mais antigas das caixas de diálogo possuem uma caixa de seleção para alta visibilidade.)
5. Se desejado, insira uma mensagem para os usuários verem nos detalhes do aviso se a atualização da extração ou a execução do fluxo falharem. Você pode formatar o texto em uma mensagem com negrito, sublinhado e itálico e incluir um link ou uma imagem. Para ver dicas de formatação de texto, clique no ícone de informações (i) acima do botão Salvar.
6. Clique em Salvar.

![Janela Monitoramento de execução de fluxo com mensagem de exemplo que diz: "Esta execução de fluxo falhou. Entre em contato com Ashley Garcia."](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_flow_run_dialog.png)

## Como desativar um aviso de qualidade de monitoramento

Para desativar o monitoramento de uma falha na atualização de extração ou na execução do fluxo:

1. Selecione o menu de ações (. . .) ao lado da fonte de dados de extração ou fluxo para o qual deseja criar um aviso e, em seguida, selecione a opção apropriada:
    - No Tableau Cloud e Tableau Server 2023.3 e posterior:
        - Dados qualidade > Monitoramento de atualização de extração
        - Rótulos de dados > Monitoramento de execução de fluxo
    - No Tableau Server 2023.1 e versões anteriores:
        - Aviso de qualidade > Monitoramento de atualização de extração
        - Aviso de qualidade > Monitoramento de execução de fluxo
2. Desligue o aviso.
3. Clique em Salvar.

## Monitoramento em todo o site para atualização de extração e falhas na execução de fluxo

A partir do Tableau Cloud de outubro de 2023 e do Tableau Server 2023.3, um administrador pode ativar o monitoramento em todo o site para adicionar ou remover avisos de qualidade de dados para falhas de atualização de extração e falhas de execução de fluxo. Você pode controlar esse recurso por meio da página Configurações, na seção Atualização de extração e monitoramento de execução de fluxo:

![Configuração de monitoramento de atualização de extração e execução de fluxo](/tableau/current/pt-br/server/pt-br/Img/monitoring_dqw_setting.png)

Essas configurações estão ativadas por padrão para todos os novos sites. Os sites que existiam antes da mudança terão as configurações desativadas, mas um administrador poderá ativá-las.

**Observação**: notificações de aviso de qualidade de dados não são exibidas para atualizações de extração que usam o Tableau Bridge.

### Interação entre monitoramento em todo o site e monitoramento explícito

A interação entre o monitoramento explícito dos ativos e o monitoramento de todos os ativos em todo o local é a seguinte:

- Se o monitoramento estiver explicitamente ativado para um ativo _e_ o monitoramento em todo o site estiver ativado, as configurações explícitas no ativo terão precedência sobre a configuração de todo o site. Essas configurações incluem propriedades como nível de visibilidade e mensagem.
- Quando você desativa o monitoramento em todo o site:
    - Ativos _com_ o monitoramento explicitamente ativado não são alterados.
    - Ativos _sem_ o monitoramento explicitamente ativado interromperá o monitoramento de falhas de atualização de extração ou de execução de fluxo, e os avisos que surgiram anteriormente de falhas de atualização de extração ou de execução de fluxo nesses ativos são removidos.
    - O desempenho da ingestão do catálogo pode ser temporariamente reduzido à medida que o Catálogo ingere novamente ativos que podem não ter mais rótulos de aviso.

O monitoramento em todo o site foi lançado no Tableau Cloud em outubro de 2023 e no Tableau Server 2023.3. Não há interação entre monitoramento explícito e monitoramento em todo o site nas versões anteriores.

## Quem pode definir os avisos de qualidade

Para definir um aviso de qualidade de dados, você deve:

- ser um servidor ou administrador de site ou
- ter o recurso Sobrescrever para o ativo.

## Personalizar avisos de qualidade de dados

A partir do Tableau Cloud de junho de 2023 e do Tableau Server 2023.3, usando o gerenciador de rótulos na página Rótulos de dados ou a API REST, um administrador pode alterar os avisos de qualidade de dados que os usuários veem na caixa de diálogo de aviso de qualidade de dados ou criar avisos inteiramente novos. Para obter mais informações, consulte [Gerenciar rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm).

<!-- document id=bcb37dae2abb39df8407b7286e252430226c4f1de02b6f9f9683c5449d94f4e9 url=/tableau/current/pt-br/server/devices_connected_credentials.md -->

[Pular para o conteúdo principal](#main-content)

# Desabilitar a autenticação do cliente

Depois que os clientes conectados do Tableau (por exemplo, Tableau Desktop, Tableau Mobile, Tableau Prep Builder etc.) e os tokens de acesso pessoal (PATs) fazem logon com êxito no Tableau Server, eles são autenticados automaticamente no futuro. As sessões de clientes conectados e os PATs são gerenciados por tokens de atualização.

Por padrão, os tokens de atualização de são redefinidos depois de um ano. Se um token de atualização não for usado em 14 dias, ele vai expirar. Como um administrador do servidor, você pode alterar esses valores ao definir as opções `refresh_token.absolute_expiry_in_seconds` e `refresh_token.idle_expiry_in_seconds`. Consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

Como administrador do Tableau Server, você também pode desabilitar a autenticação automática do para clientes conectados. Neste caso, a expiração da sessão é regida unicamente pelo comportamento da sessão do Tableau Server, que gerencia sessões de criação na Web. Consulte [10\. Verificar a configuração de tempo da sessão](https://help.tableau.com/current/server/pt-br/security_harden.htm#10.). As sessões de criação na Web não são consideradas como um "cliente conectado" e não usam tokens de atualização do .

Para desconectar imediatamente os clientes conectados do Tableau Server e exigir que os usuários façam logon cada vez que se conectarem:

1. Entre no Tableau Server como administrador de servidor.
2. No menu do site, clique em Gerenciar todos os sites e clique em Configurações > Geral.
3. Em Clientes conectados, desmarque a caixa de seleção Permitir que os clientes se conectem automaticamente ao Tableau Server.
4. Clique no botão Salvar na parte superior ou inferior da página.

**Observação:** essa configuração descrita acima só se aplica a clientes conectados e não afeta a criação e o resgate de PATs.

<!-- document id=00ed90a652cec6210964d2e14aa2a1e1d93d3acfc010e8126a928a1db22295de url=/tableau/current/pt-br/server/explain_data_enable.md -->

[Pular para o conteúdo principal](#main-content)

# Desabilitar ou habilitar Explique os dados para um site

Explique os dados está habilitado para sites por padrão, mas os administradores do Tableau podem desabilitá-lo.

1. Vá para as configurações Gerais do site.
2. (Tableau Server somente) Na seção Criação na Web, selecione Permitir que os usuários editem pastas de trabalho em seu navegador.
3. Na seção Disponibilidade do Explique os dados, escolha entre estas opções:
    
    - Ativar permite que Creators e Explorers com as permissões apropriadas executem Explique os dados no modo de edição. Permite que todos os usuários com as permissões apropriadas executem Explique os dados quando estiver habilitado para o modo de visualização.
    - Desativar impede que todos os usuários executem Explique os dados ou acessem as configurações de Explique os dados nas pastas de trabalho.
4. No Tableau Cloud e Tableau Server 2023.3 ou posterior, para usar o Explique os dados:
    
    - Na seção Disponibilidade do Guia de Dados, selecione Mostrar. Para obter mais informações sobre o Guia de Dados, consulte [Explorar Painéis com Guia de dados](https://help.tableau.com/current/server/pt-br/data_guide.htm).

<!-- document id=e31de65f74752726f6bfd03a241cc2a80fea6990a0a07e91e69e31b070e793fe url=/tableau/current/pt-br/server/ask_data_enable.md -->

[Pular para o conteúdo principal](#main-content)

# Desabilitar ou habilitar Pergunte aos dados para um site

**Mudanças importantes chegando para Pergunte aos dados e Métricas**

Os recursos Pergunte aos dados e Métricas do Tableau serão descontinuados no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau AI e o Tableau Pulse estão reinventando a experiência com dados.](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-gpt)

Pergunte aos dados está habilitado para sites por padrão, mas os administradores do Tableau podem desabilitá-lo.

1. Vá para as configurações Gerais do site.
2. (Tableau Server somente) Na seção Criação na Web, selecione Permitir que os usuários editem pastas de trabalho em seu navegador.
3. Na seção Disponibilidade do Pergunte aos dados, escolha entre estas opções:
    
    - Habilitado permite a criação de ampliação de Pergunte aos dados para todas as fontes de dados publicadas.
    - Desabilitado oculta Pergunte aos dados em todo o site, enquanto preserva informações sobre ampliações criadas anteriormente para que possam ser restauradas se Pergunte aos dados for reativado.

**Observação:** a partir da versão 2019.4.5, os administradores do Tableau Server podem configurar se o Pergunte aos dados está ativado ou não por padrão.

<!-- document id=ccfe6fdc0f37eb6e399fc3ea313c4aa13b1ede55309da62a19ce1fce974271d5 url=/tableau/current/pt-br/server/license_deactivate.md -->

[Pular para o conteúdo principal](#main-content)

# Desativar a chave do produto

Há alguns cenários em que você deve desativar uma chave de produto:

- Ao alterar uma configuração de hardware
- Ao alterar chaves do produto
- Ao mover uma chave do produto para uma nova instalação

## Antes de começar

Verifique se você está removendo as chaves do produto apropriadas. Visualize os detalhes da licença ao executar [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList) no CLI.

1. Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.
2. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
3. Clique em **Configuração** e Licenciamento.
    
    ![Janela de licenciamento mostrando uma licença que vai expirar em breve.](/tableau/current/pt-br/server/pt-br/Img/license_deactivate.png)
4. Selecione a chave de produto que deseja desativar e clique em Desativar licença.
5. Depois que a chave for desativada, reinicie o Tableau Server.
    
    **Observação:** se nenhuma outra chave do produto permanecer ativada antes da reinicialização, o Tableau Server não será reiniciado em um estado utilizável. Se isso ocorrer, você não poderá usar o Tableau Server até ativar uma nova chave de produto no TSM.

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute os seguintes comandos:
    
    `tsm licenses deactivate --license-key <product-key>`
    
    `tsm restart`

<!-- document id=63c3f8f4f99acc69a91f944f8fbed373372308f872ddec7edc7dfee4e0d3471d url=/tableau/current/pt-br/server/deactivate_off.md -->

[Pular para o conteúdo principal](#main-content)

# Desativar o Tableau Server offline

Se o Tableau Server não tiver acesso à Internet, você poderá usar as instruções neste tópico para desativá-lo. Será necessário um segundo computador com acesso à Internet para concluir o processo de ativação.

**Observação:** no momento, você não poderá desativar o Tableau Server 2023.1.0 ou superior se o serviço ATR estiver habilitado em sua implantação do Tableau Server. Para obter mais informações, consulte o artigo do Knowledge [Tableau Server 2023.1+: desativação de licença off-line com ATR não disponível](https://help.salesforce.com/s/articleView?id=001534333&type=1).

1. No nó inicial do Tableau Server, crie um diretório para armazenar o arquivo de desativação off-line criado na próxima etapa.
2. Faça logon no TSM usando uma conta de administrador do Tableau e execute o seguinte comando:
    
    `tsm licenses get-offline-deactivation-file -k <productkey> -o <deactivation-file-directory>`
3. Mova o arquivo `TableauOfflineDeactivationRequest.tlq` do diretório do arquivo de desativação especificado no comando anterior para usar um computador confiável com acesso à Internet.
4. No computador confiável com acesso à Internet, abra um navegador da Web e visite a página [Ativações de produtos](http://www.tableau.com/pt-br/support/drivers/activation) na página do Tableau. Siga as instruções na página para enviar seu arquivo `TableauOfflineDeactivationRequest.tlq`.
    
    **Observação:** este processo não funcionará com o navegador Microsoft Edge.
5. Quando solicitado, salve o arquivo de retorno da chave do produto (`return.tlr`) da página **Ativações de produtos**.
6. Mova o arquivo de retorno da chave do produto (`return.tlr`) do computador confiável com acesso à Internet para o nó inicial do Tableau Server que executa o serviço do Servidor de licenciamento.
7. Faça logon no TSM usando uma conta de administrador do Tableau e execute o seguinte comando:
    
    `tsm licenses deactivate -f <path-to-license-key-return-file>`
    
    `tsm restart`
    
    **Observação**: a `tsm restart` etapa se aplica somente quando o servidor ainda possui uma ou mais licenças válidas. Depois que todas as licenças forem desativadas, o Tableau Server não pode ser inicializado, e executar a reinicialização do tsm resultará na permanência do servidor em um estado pouco funcional.

<!-- document id=55fcf08bf84827d5190d5ea27b6b31251407c30fe5c5ffc15c71746fff0e5722 url=/tableau/current/pt-br/server/explain_data.md -->

[Pular para o conteúdo principal](#main-content)

# Descobrir insights mais rápido com Explique os dados

Explique os dados no Guia de dados ajuda você a inspecionar, descobrir e aprofundar as marcas em uma visualização à medida que explora seus dados. Você pode usar o Explique os dados para analisar painéis, planilhas ou marcas selecionadas para possíveis discrepâncias e correlações nos dados subjacentes. Explique os dados cria modelos estatísticos e propõe explicações possíveis para marcas individuais em uma visualização, incluindo dados potencialmente relacionados da fonte de dados que não são usados na exibição atual.

Para obter informações sobre como executar o Explique os dados e explorar as explicações, consulte [Introdução a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm).

**Observação**: este tópico descreve como o Explique os dados funciona no Tableau 2021.2 e em versões posteriores. Se você tiver uma versão anterior do Tableau, leia este tópico na [versão 2021.1 da ajuda de Explique os dados](https://help.tableau.com/v2021.1/pro/desktop/pt-br/explain_data.htm "Link para a versão anterior deste tópico de ajuda no Tableau versão 2021.1").

Ao criar diferentes exibições, use o Explique os dados como ponto de partida para ajudar a explorar os dados mais detalhadamente e fazer mais perguntas. Para obter mais informações, consulte [Como o Explique os dados ajuda a aumentar sua análise](#How). Para obter informações sobre quais características tornam uma fonte de dados mais interessante para uso com Explique os dados, consulte [Requisitos e considerações para uso do Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_requirements.htm).

## Acesso para Explique os dados

Explique os dados é habilitado por padrão no nível do site. Os administradores de servidor (Tableau Server) e os administradores de site (Tableau Cloud) podem controlar se Explique os dados está disponível para um site. Para obter mais informações, consulte [Desabilitar ou habilitar Explique os dados para um site](https://help.tableau.com/current/server/pt-br/explain_data_enable.htm).

Os autores que podem editar pastas de trabalho e têm o recurso de permissão Executar Explique os dados para uma pasta de trabalho podem executar Explique os dados no modo de edição. Todos os usuários com o recurso Executar Explique os dados podem executar dados explicativos no modo de exibição no Tableau Cloud e no Tableau Server.

Quando permitido pelos administradores do site, as explicações podem ser compartilhadas no modo de exibição por e-mail ou Slack com outros usuários do Tableau Cloud e do Tableau Server. Para obter mais informações, consulte [Configure o Tableau para permitir que os usuários compartilhem explicações por e-mail e Slack](https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm#ConfigureSlackEmail) .

Os autores podem usar as configurações de Explique os dados para controlar quais tipos de explicação são exibidos no painel Guia de dados.

Para obter informações sobre como controlar o acesso aos dados explicativos, tipos de explicação e campos, consulte [Controle de acesso a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm).

## Como o Explique os dados ajuda a aumentar sua análise

Explique os dados é uma ferramenta que revela e descreve os relacionamentos dos seus dados. Não é possível dizer o que está causando os relacionamentos ou como interpretar os dados. **Você é o especialista em seus dados.** O conhecimento de domínio e a intuição são fundamentais para ajudar a decidir quais características podem ser interessantes para explorar ainda mais, usando diferentes exibições. Para obter as informações relacionadas, consulte [Como funciona o Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_explained.htm) e [Requisitos e considerações para uso do Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_requirements.htm).

Para obter mais informações sobre como funciona o Explique os dados e como usá-lo para incrementar sua análise, consulte estas apresentações da Conferência do Tableau:

- [From Analyst to Statistician: Explain Data in Practice (1 hour) \[De Analista a Estatístico: o Explique os dados na prática (1 hora)\]](https://www.tableau.com/pt-br/events/tc/2019/analyst-statistician-explain-data-practice)
- [Leveraging Explain Data (45 minutes) \[Uso do Explique os dados (45 minutos)\]](https://www.tableau.com/pt-br/events/tc/2019/leveraging-explain-data)

## Outros artigos nesta seção

<!-- document id=038d1647713a7983ecdabbe98f87f2ff723aaf057a7f450ba7ec4ca6f9108e2f url=/tableau/current/pt-br/server/perf_toc.md -->

[Pular para o conteúdo principal](#main-content)

# Desempenho

Você pode monitorar e ajustar o desempenho do Tableau Server.

## Outros artigos nesta seção

<!-- document id=a1f3e99aeb643313c9eef7665e64572b375ccf7a1d3199fac25b2b8e58f1dc95 url=/tableau/current/pt-br/server/adminview_performance_flows.md -->

[Pular para o conteúdo principal](#main-content)

# Desempenho das execuções de fluxo

Use esta exibição para ver o histórico de desempenho de todos os fluxos de um site. Você pode filtrar por Nome do fluxo, Nome da etapa de saída, Proprietário do fluxo, Tipo de execução (agendada ou Ad Hoc), além da hora em que a execução de fluxo foi iniciada. Para obter informações sobre outras exibições administrativas disponíveis para fluxos, consulte [Monitorar integridade e desempenho do fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_monitor_flow.htm).

![Uma exibição administrativa mostrando o desempenho do fluxo ao longo do tempo. Cada ponto no gráfico corresponde a uma execução de fluxo específica, exibindo o nome do fluxo, a etapa de saída, o proprietário do fluxo, o tipo de execução e os horários de início e término.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_flow_performance.png)

Estas são algumas perguntas que você pode responder usando essa exibição:

- **Quais tarefas de fluxo estão agendadas no momento?** – Para fazer isso, use o filtro Hora de início e selecione o período desejado. Por exemplo, para ver tarefas de fluxo agendadas nas próximas três horas, selecione **Horas** -> **Próximo** -> e digite **3**.
- **Qual é a duração das tarefas de fluxo?** - Para responder isso, clique em uma marca na exibição para ver detalhes, incluindo a duração da tarefa.

**Quantos fluxos foram executados com ad hoc e quantos foram agendados?** - Para responder isso, use o filtro **Tipo de execução** e selecione **Ad hoc** ou **Agendado**.

**Observação**: isso não é funcional nesta versão e não filtrará os dados.

Além das perguntas descritas acima, estes são alguns exemplos de informações que poderão ser coletadas:

- Os fluxos executados com mais frequência terão mais marcas.
- Para ver quantos fluxos estão em execução ao mesmo tempo, passe o mouse sobre uma marca que exiba “**Em andamento**” ou “**Pendente"** e selecione “**Manter apenas**” para filtrar todas as execuções de fluxo que estão em execução no momento.
- Para ver quantos fluxos estão em execução ao mesmo tempo durante um intervalo de tempo específico, selecione um intervalo para o filtro **Hora de início**. Por exemplo, você pode escolher “**Próximas três horas**” para ver quais fluxos estarão em execução nas próximas três horas.

<!-- document id=1e6d48eef93ca7b6672a6b10cea15abd1a5f118cf2c9a31ee0403e60f7488838 url=/tableau/current/pt-br/server/adminview_performance_views.md -->

[Pular para o conteúdo principal](#main-content)

# Desempenhos das exibições

**Observação:** esta exibição só está disponível para administradores de servidor. Para acessar exibições de servidor em implantações de vários sites, clique no menu do site e selecione **Gerenciar todos os sites**. Para obter informações sobre como navegar em exibições administrativas, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

A exibição administrativa de Desempenho das exibições exibe o tempo necessário para as exibições serem carregadas e quantas sessões estão sendo executadas ao mesmo tempo no servidor.

**Importante:** se você atualizar de uma versão mais antiga do Tableau Server para a versão 2025.1.x ou posterior, esteja ciente de que a maneira como a exibição é calculada faz parecer que os tempos de carregamento aumentam significativamente. Isso não reflete uma alteração real no desempenho da exibição. Isso se deve a uma mudança na forma como o gráfico é exibido.

![Um gráfico de série temporal exibe os tempos de carregamento das exibições na semana passada, um gráfico de barras ilustra as contagens de sessões e um gráfico de barras horizontais delineia as exibições individuais.](/tableau/current/pt-br/server/pt-br/Img/adminview_performance_of_views.png)

Você pode comparar os picos no número de sessões com picos em períodos de carregamento lento, para identificar as horas do dia em que o tráfego intenso do usuário está tornando o servidor mais lento. Você também pode consultar cada exibição por tempo de carregamento para compreender quais exibições demoram mais para carregar. Para obter mais informações sobre como otimizar o servidor, consulte [Otimizar para o tráfego de usuários](https://help.tableau.com/current/server/pt-br/perf_optimize_user_traffic.htm).

Algumas exibições podem demorar muito para carregar, independentemente de quando são visualizadas. Você pode identificar quais pastas de trabalho precisam ser otimizadas com a exibição administrativa Estatísticas para tempos de carregamento. Algumas maneiras simples de otimizar as pastas de trabalho incluem:

- Exibir menos informações em cada exibição.
- Dividir as exibições.
- Reduzir o número de filtros.
- Usar extrações de dados.

<!-- document id=c8449623298732978e5dad4b6e55bbdf2bdbe6c00ff9b350611dfe955554a859 url=/tableau/current/pt-br/server/rmt-admin-uninstallation.md -->

[Pular para o conteúdo principal](#main-content)

# Desinstalação do Resource Monitoring Tool

Os instaladores do Resource Monitoring Tool incluem desinstaladores. Se estiver executando no Windows, execute a desinstalação em **Adicionar / Remover Programas**.

**Observação:** se você tiver problemas ao tentar desinstalar o Resource Monitoring Tool, consulte [Solucionar erros de desinstalação do RMT](https://help.tableau.com/current/server/pt-br/rmt-troubleshoot-uninstall.htm).

Use as etapas a seguir para desinstalar o Resource Monitoring Tool.

1. Para garantir uma desinstalação limpa, remova todos os programas a seguir:
    
    Programas instalados no Servidor RMT:
    
    - Resource Monitoring Tool do Tableau
    - Resource Monitoring Tool do Tableau Configuração Erlang
    - Resource Monitoring Tool do Tableau Configuração PostgreSQL
    - Resource Monitoring Tool do Tableau Pré-requisitos
    - Resource Monitoring Tool do Tableau Instalação dos pré-requisitos
    - Resource Monitoring Tool do Tableau Configuração RabbitMQ
    
    Nas máquinas Agent, desinstale o Agent do. Resource Monitoring Tool do Tableau
2. Depois de desinstalar todos os programas listados acima, exclua o diretório da Resource Monitoring Tool do Tableau nas máquinas do RMT Server e no Agent. A localização padrão do diretório de dados é `C:\Program Files\Tableau\Tableau Resource Monitoring Tool`.
    
    **Observação:** se você não excluir o diretório da Resource Monitoring Tool do Tableau, algumas informações como o nome de usuário, as senhas e as definições de configuração serão mantidas e reutilizadas se você for para uma reinstalação subsequente do Resource Monitoring Tool.

## Quem pode fazer isso

Para desinstalar o Resource Monitoring Tool, você deve ter o seguinte:

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.
- Resource Monitoring Tool Conta de administrador.

<!-- document id=e3b3670a9fc2d2d9abb203c9fb4265b14f6fc459b9121e55584a5203d5c38699 url=/tableau/current/pt-br/server/uninstall_server.md -->

[Pular para o conteúdo principal](#main-content)

# Desinstalar o Tableau Server

Não desinstale o Tableau antes da atualização. Para obter detalhes sobre atualização, consulte [Atualização do Tableau Server (Windows)](https://help.tableau.com/current/server/pt-br/sug_plan.htm).

A partir da versão 2018.2, é possível ter várias versões do Tableau Server instaladas ao mesmo tempo. Isso permite executar a maior parte de uma atualização enquanto uma versão existente está em execução e reduz o tempo de inatividade e o impacto para os usuários. Depois de atualizar, você pode desinstalar a versão anterior. Isso libera espaço em disco. Não é necessário desinstalar a versão anterior.

Este artigo explica como desinstalar versões anteriores depois de atualizar para uma versão mais recente.

## Desinstalação e remoção completa do Tableau Server

Existem dois cenários principais de "desinstalação" compatíveis com o Tableau Server no Windows:

- **Desinstalar o Tableau Server:** _após atualizar_ para uma nova versão do Tableau Server, você pode desinstalar a versão anterior para liberar espaço em disco. Continue a leitura para obter informações sobre como desinstalar o Tableau.
- **Remover o Tableau Server:** se você quiser remover o Tableau Server completamente de um computador, use um script fornecido pelo Tableau para remover o Tableau Server e todos os arquivos relacionados. _Esse procedimento remove todos os dados, bem como os componentes do servidor, portanto, só deverá ser realizado se você souber que deseja redefinir o computador para um estado anterior ao Tableau._ Poderá ser necessário fazer isso se o Suporte técnico recomendar essa etapa ao solucionar um problema de instalação. É recomendável criar um backup dos dados antes de remover o Tableau. Salve o arquivo de backup em um local seguro no computador que não faça parte da instalação do Tableau. Remova completamente o Tableau Server sem desinstalar nenhuma versão primeiro. O script desinstalará todas as versões existentes encontradas no computador. Se já tiver desinstalado a versão existente e agora quiser remover o Tableau completamente, você poderá encontrar o script para fazer isso em um local temporário. Para obter mais detalhes, consulte [Remover o Tableau Server do computador](https://help.tableau.com/current/server/pt-br/remove_tableau.htm).

## Desinstalar uma versão do Tableau Server

Ao atualizar de uma versão do TSM para outra, mantenha a versão anterior até que tenha concluído a atualização. _E então_ pode desinstalá-la.

Use o Painel de controle para desinstalar uma versão anterior do Tableau Server após a atualização. A partir da versão 2018.2, é possível ter várias versões do Tableau Server instaladas ao mesmo tempo. Todas as versões instaladas ficam visíveis no Painel de controle, mas apenas uma versão está em execução (em geral, a versão em execução será a versão para a qual você atualizou, mas se não tiver concluído o processo de atualização, poderá ser uma versão anterior). Depois de concluir a atualização, você pode desinstalar a versão anterior.

**Importante:** a partir da versão 2018.2, a desinstalação do Tableau Server não criará um backup dos dados. Como uma prática recomendada, sempre crie um backup de seus dados antes de atualizar ou desinstalar o Tableau. Isso garante que possa reinstalar e restaurar os dados, se desejar. Salve o backup em um local seguro no computador que não faça parte da instalação do Tableau Server.

Para desinstalar uma versão do Tableau Server:

1. Abra o Painel de controle, clique em Desinstalar um programa e localize a versão que você deseja desinstalar.
    
    Certifique-se de selecionar a versão correta para desinstalar:
    
    - A desinstalação de versões anteriores do Tableau Server não afeta a versão em execução e simplesmente remove arquivos desnecessários dessas versões anteriores.
    - **Não** desinstale a versão atual e em execução. A desinstalação da versão atual em execução do Tableau Server para o servidor e remove pastas e arquivos específicos do servidor, mas pode deixar alguns elementos. A desinstalação não cria um backup dos dados do repositório.
2. Com a versão do Tableau Server selecionada, clique em Desinstalar.

## Outros artigos nesta seção

<!-- document id=96840fda252193d5b41d7e46aba9b6f8cb292cd9dbeb9cc5658284a220e90fbc url=/tableau/current/pt-br/server/server_tsig_uninstall.md -->

[Pular para o conteúdo principal](#main-content)

# Desinstalar o Tableau Server Independent Gateway

Este tópico orienta você no processo de desinstalação do Tableau Server Independent Gateway.

## Desinstalando o Independent Gateway

A desinstalação do Independent Gateway é um processo de duas etapas:

1. Desabilite a instância de Independent Gateway no Tableau Server usando o TSM.
    
    Para desabilitar o Independent Gateway no Tableau Server, execute este comando no prompt de comando do nó inicial do Tableau Server:
    
    tsm topology external-services gateway disable
2. Desinstale a instância do Independent Gateway que você está atualizando do computador em que ela está sendo executada.
    
    Para desinstalar o Independent Gateway de um computador com Windows, execute o programa de instalação e selecione Desinstalar. Quando o programa de instalação termina, o Independent Gateway foi desinstalado.

Para desinstalar uma instância do Independent Gateway, remova-a do cluster de servidores usando o TSM e, em seguida, após o Tableau Server estiver totalmente reconfigurado, desinstale o Independent Gateway do computador em que foi instalado. Quando você usa o TSM para remover a instância do Tableau Server, o TSM não envia mais comunicações para a instância do Independent Gateway, portanto, o Independent Gateway não tem conhecimento de nenhuma alteração de configuração, porém continua a responder com base na última configuração conhecida, e o Tableau Server continua a aceitar essas respostas. Você também precisa remover a instância do Independent Gateway do computador em que ela está sendo executada.

<!-- document id=d106916996d6d92f454cac40c5ac4b2412d55bfa3b3ed9aa9668c414cb11009e url=/tableau/current/pt-br/server/ipa_server_whats_new.md -->

[Pular para o conteúdo principal](#main-content)

# Destaques do lançamento

No Tableau Server, versão 2025.3:

- **Tableau Agent no Tableau Server:** agora obtenha acesso aos recursos de IA generativa do Tableau Agent no Tableau Prep, Tableau Desktop e Criação na Web fazendo logon no Tableau Server.
- **Suporte a SCIM:** permite que os administradores do servidor habilitem o SCIM no nível de site para automatizar o provisionamento e a sincronização de usuários e grupos ao usar autenticação SAML específica do site.
- **Extensões confiáveis do Tableau:** um novo subconjunto de extensões verificadas com segurança do Tableau Exchange que são hospedadas pelo Tableau, fornecendo funcionalidade controlada e simplificada, agora está disponível.
- **Alterações do Tableau Mobile:** a configuração de segurança do aplicativo Tableau Mobile para detecção de malware foi descontinuada.

[Ver uma lista completa](https://help.tableau.com/current/server/pt-br/whatsnew_server.htm)

## Outros artigos nesta seção

<!-- document id=b5069b6eb0c095f0e8b392a726886f05ee05d9cf682cdcb81136ff95352b3231 url=/tableau/current/pt-br/server/publishing_sharing_authentication.md -->

[Pular para o conteúdo principal](#main-content)

# Definir credenciais para o acesso aos dados publicados

Ao publicar uma pasta de trabalho no Tableau Cloud ou Tableau Server, você pode publicar a fonte de dados à qual ela se conecta como parte da pasta de trabalho (_inserida_ na pasta de trabalho) ou como fontes de dados separadas e independentes. Além disso, se a fonte de dados que está publicando exigir autenticação, você poderá personalizar como as credenciais são obtidas.

O tipo de autenticação da sua fonte de dados não depende da forma como os usuários entram no site do Tableau Cloud ou do Tableau Server. Por exemplo, para conceder o acesso direto aos dados em uma pasta de trabalho, você deve inserir as credenciais designadas de um usuário do banco de dados na conexão da fonte de dados. Contudo, qualquer pessoa que visualize a pasta de trabalho ainda precisa ser capaz de entrar no site do Tableau Cloud ou do Tableau Server para abrir a pasta de trabalho.

Este tópico descreve como configurar a autenticação nas conexões de dados como parte do processo de publicação.

**Observação:** este tópico não se aplica a conexões que não precisam de autenticação, como arquivos de texto ou do Excel.

## Definir o tipo de autenticação

Para vários tipos de conexão, é possível inserir um nome de usuário e senha do banco de dados, ou usar logon único (SSO). As exceções específicas serão descritas posteriormente neste tópico.

As etapas a seguir descrevem como configurar a autenticação como parte da publicação de uma fonte de dados ou pasta de trabalho. Você pode fazer isso para cada conexão na fonte de dados.

1. Na caixa de diálogo Publicar pasta de trabalho, vá para a área Fontes de dados, que lista as conexões de pasta de trabalho e selecione Editar.
2. No menu suspenso Gerenciar fontes de dados, após decidir se deseja publicar a fonte de dados separadamente ou como parte da pasta de trabalho, selecione um tipo de autenticação para cada conexão na fonte de dados. Os tipos de autenticação disponíveis dependem do tipo de conexão e podem incluir um ou mais dos seguintes:
    - Avisar usuário: os usuários devem inserir suas próprias credenciais de banco de dados para acessar os dados publicados ao carregar a visualização ou a pasta de trabalho.
    - Senha inserida: as credenciais usadas para conectar aos dados serão salvas com a conexão e usadas por todos que acessam a fonte de dados ou pasta de trabalho publicada.
    - Execução do servidor como conta: uma única conta de serviço do Kerberos é usada para autenticar o usuário. No Windows, é a conta que o Tableau Server executa. No Linux, ele pode ser qualquer conta Kerberos.
    - Credenciais do visualizador: as credenciais do visualizador são passadas para o banco de dados usando SSO (normalmente Kerberos).
    - Representar com conta incorporada ou Representar com a conta de serviço Run As do servidor: A representação usando credenciais incorporadas se conecta com as credenciais incorporadas e, em seguida, alterna para a identidade do visualizador (somente para bancos de dados que oferecem suporte a isso). A representação que usa a conta de serviço Executar como é semelhante, mas, primeiro, se conecta à conta de serviço Kerberos antes de alternar para a identidade do visualizador.
    - Atualização não habilitada ou Permitir acesso à atualização: estas opções aparecem ao se publicar uma extração de dados na nuvem, como do Salesforce, e as credenciais do banco de dados são necessárias para acessar os dados subjacentes. Permitir o acesso à atualização insere as credenciais na conexão, para que seja possível configurar atualizações dessa extração em uma agenda regular.

**Importante:** como você deseja manter os novos dados atualizados também é um fator.

- Se você deseja configurar uma agenda de atualização automática, deve inserir a senha na conexão.
- Se estiver publicando uma conexão de dados da nuvem no Tableau Cloud, as etapas de publicação o alertarão se você precisar adicionar o Tableau Cloud à lista autorizada de provedores de dados.
- Não é possível publicar uma extração criada a partir de uma fonte de dados delegada de Kerberos, segura no nível da linha.

### Conexões com Dropbox e ao OneDrive

Para o Dropbox e o OneDrive, ao publicar uma fonte de dados ou pasta de trabalho e selecionar Senha inserida, o Tableau cria uma credencial salva e a insere na fonte de dados ou na pasta de trabalho.

### Conexões da pasta de trabalho às fontes de dados do Tableau

Ao publicar uma pasta de trabalho que se conecta à uma fonte de dados do Tableau Cloud ou Tableau Server, em vez de configurar as credenciais para acessar os dados subjacentes, o usuário define se a pasta de trabalho pode acessar a fonte de dados publicada na qual ela se conecta. Independentemente do tipo de dados original, a escolha de acesso às fontes de dados do servidor sempre será com uma senha inserida ou solicitada pelos usuários.

Ao selecionar a opção para solicitar aos usuários, o usuário que abrir a pasta de trabalho deve ter as permissões para Exibir e Conectar na fonte de dados para visualizar os dados. Se você selecionar a opção de senha inserida, os usuários poderão ver as informações na pasta de trabalho, mesmo que não tenham as permissões para Visualizar ou Conectar.

### Conexões virtuais

A partir do Tableau Cloud e Tableau Server 2022.3 e Tableau Desktop 2022.4, ao publicar conteúdo do Tableau como uma fonte de dados ou pasta de trabalho que usa uma conexão virtual e selecionar Inserir senha ou Inserir credenciais, o visualizador do conteúdo terá suas permissões para se conectar e consultar a conexão virtual. No entanto, quaisquer políticas de dados associadas à conexão virtual são sempre avaliadas usando a identidade do visualizador, não a sua.

Por exemplo, você publica uma pasta de trabalho que usa uma conexão virtual. Para permitir que os visualizadores da pasta de trabalho se conectem e consultem dados por meio da conexão virtual, insira suas permissões para se conectar e consultar a conexão virtual. Em seguida, quaisquer políticas de dados associadas à conexão virtual impedem que os visualizadores da pasta de trabalho acessem quaisquer dados confidenciais.

Ao avaliar se as tabelas em uma conexão virtual podem ser visualizadas e acessadas, a identidade do criador do conteúdo é usada. No entanto, ao avaliar quaisquer políticas de dados associadas às tabelas em uma conexão virtual, a identidade do visualizador é usada. E o criador de conteúdo só pode incorporar permissões de conexão à conexão virtual – não permissões de edição.

Se você optar por não inserir permissões, somente os usuários com permissões para acessar a pasta de trabalho ou a fonte de dados e com permissões de conexão à conexão virtual poderão acessar a pasta de trabalho ou a fonte de dados.

As opções de senha de incorporação e credenciais de incorporação para conexões virtuais não funcionam em Tableau Cloud 2022.2, Tableau Server 2022.1 e Tableau Desktop 2022.3 e anterior. Se você selecionar essas opções antes de atualizar para 2022.3 (para Tableau Cloud e Tableau Server) ou 2022.4 (para Tableau Desktop), as opções funcionarão conforme o esperado após a atualização. Em seguida, você pode inserir suas permissões para consultar uma conexão virtual.

## Consulte também

- Se você publicar no Tableau Server, consulte [Editar conexões](https://help.tableau.com/current/server/pt-br/help.htm#connections_modify.htm) na Ajuda do Tableau Server.
- Se publicar no Tableau Cloud e a pasta de trabalho se conectar a dados do Salesforce, Google Analytics, Planilhas Google, Google BigQuery, OneDrive, Dropbox e QuickBooks Online, consulte [Atualizar dados com o uso das credenciais salvas](https://help.tableau.com/current/online/pt-br/to_fresh_data_saved_credentials.htm) na Ajuda do Tableau Cloud.
- Se você for um administrador do Tableau Server procurando mais informações sobre autenticação, consulte os tópicos da ajuda do Tableau Server, "Autenticação" ([Windows](https://help.tableau.com/current/server/pt-br/security_auth.htm) | [Linux](https://help.tableau.com/current/server-linux/pt-br/security_auth.htm)) e "Autenticação da conexão de dados” ([Windows](https://help.tableau.com/current/server/pt-br/security_data_connection_auth.htm) | [Linux](https://help.tableau.com/current/server-linux/pt-br/security_data_connection_auth.htm)).

<!-- document id=259efa5dcdb39d1c1dc1c4a5e52c6413a78da9264848efbe9b8b55788c60ac1e url=/tableau/current/pt-br/server/csvguidelines.md -->

[Pular para o conteúdo principal](#main-content)

# Diretrizes do arquivo de importação CSV

Você pode adicionar usuários em massa ao criar um arquivo de valores separados por vírgula (CSV) com informações do usuário e ao importar o arquivo. Você pode incluir atributos no arquivo CSV, como o nível de licença e o acesso de publicação, para serem aplicados aos usuários ao mesmo tempo que são importados.

Este tópico aborda os detalhes do próprio arquivo CSV. Para importar usuários usando o CSV, você pode:

- Usar as páginas de administração do servidor ou do site. Para obter informações, consulte [Importar usuários](https://help.tableau.com/current/server/pt-br/users_import.htm).
- Usar o utilitário `tabcmd`. Para obter mais informações, consulte [createsiteusers filename.csv](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894).

É possível importar usuários no nível de site ou servidor. Se você importar usuários para o servidor (não para um site específico), eles não serão atribuídos a um site e serão importados como Unlicenseds.

**Observação:** salvo indicação em contrário, as diretrizes especificadas neste tópico se aplicam ao Tableau Server configurado com ou sem [pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Requisitos de formato do arquivo CSV

O arquivo CSV para importação de usuários tem os seguintes requisitos de formatação:

- Sem cabeçalhos de coluna. Tableau Server pressupõe que cada linha no arquivo representa um usuário.
- O formato UTF-8 com a marca de ordem de byte (BOM) só é compatível ao importar para sites. Se estiver importando para o Tableau Cloud Manager, use o formato UTF-8 e remova qualquer BOM de seus arquivos.
    - As codificações de caracteres, como BIG-5, devem ser convertidas em UTF-8. Isso é possível abrindo o arquivo em um editor de texto e usando o comando Salvar como.
    - Se o caractere `@` estiver presente no campo **nome de usuário** para qualquer coisa que não seja um separador de domínio, ele deverá estar no formato hexadecimal: `\0x40`. Por exemplo, `user@fremont@mycompany.com` deve ser `user\0x40fremont@mycompany.com`.

## Estrutura de coluna necessária no arquivo CSV

O arquivo não deve conter uma linha de cabeçalho. Nem todas as colunas precisam ser preenchidas, mas a estrutura de coluna necessária deve ser preservada, incluindo todos os delimitadores de vírgula esperados.

A estrutura da coluna varia por produto e por ferramenta de importação. Verifique se você está usando a estrutura apropriada para seu ambiente:

- **Tableau Cloud:** nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail
- **Tableau Cloud with Tableau Cloud Manager (TCM):** URI do locatário ou do site, nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, capacidade de publicação, endereço de e-mail, tipo de autenticação
- **Tableau Server:** nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail
- **Tableau Server usando pools de identidades:** nome de usuário, senha, nome de exibição, nível de licença, nível de administrador, recurso de publicação, endereço de e-mail, nome do pool de identidades, identificador

Consulte a seção de detalhes da coluna abaixo para obter mais informações sobre os valores possíveis para cada coluna.

> [!WARNING]
> 
> **Importante:** a ordem da coluna é importante. A primeira coluna é tratada como o nome de usuário, a segunda como a senha, a terceira como nome de exibição etc., independentemente do conteúdo das colunas. Mesmo que você opte por omitir os valores de um campo, ainda será necessário incluir o delimitador de vírgula desse campo.

## Detalhes de coluna do Tableau Server

**Observação**: se você não estiver conectado a um site específico e estiver importando usuários no nível de servidor, poderá atribuir apenas as funções no site Administrador do servidor e Unlicensed.

Estrutura de coluna para o arquivo CSV: `username, password, display name, license level, admin level, publishing capability, email address`

### Detalhes da coluna 

**Username:** _obrigatório_. O nome do usuário.

- Se o servidor estiver configurado para usar o Active Directory, este valor deve corresponder a um usuário definido no Active Directory. Se o nome de usuário não for exclusivo nos domínios, inclua o domínio como parte do nome de usuário (por exemplo, `example\Adam` ou `adam@example`).
- Se for adicionar usuários a um [pool de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm), certifique-se do seguinte:

- Se adicionar um usuário a um pool de identidades que usa o AD como seu armazenamento de identidades, certifique-se de usar o valor AD sAMAccountName para o nome do usuário.
- Se adicionar um usuário a um pool de identidade que usa LDAP como seu armazenamento de identidade, certifique-se de usar o valor de nome de usuário do LDAP para nome de usuário.

**Password** senha para o usuário. A necessidade dessa coluna depende da configuração do servidor:

- Autenticação local: _obrigatória_. A aplicação do campo de senha obrigatório foi iniciada no Tableau Server 2024.2. Para obter mais informações, consulte o artigo de conhecimento [Ocorre “errorCode=134” inesperado ao tentar adicionar usuários por meio de tabcmd no Tableau Server 2024.2](https://help.salesforce.com/s/articleView?id=002277940&type=1).
- Active Directory: _ignorado_. Como prática recomendada, deixe esta coluna em branco.

**Display name**: o nome de exibição faz parte da informação usada para identificar um usuário no servidor. A utilização dessa coluna depende da configuração do servidor:

- Autenticação local: se o nome de exibição do usuário já estiver em uso, o Tableau Server atualizará as informações existentes do usuário com as configurações no arquivo CSV.
- Active Directory: _ignorado_. Como prática recomendada, deixe esta coluna em branco.

**License level:** pode ser **Creator (Criador)**, **Explorer (Explorador)**, **Viewer (Visualizador)** ou **Unlicensed**.

- Se o nível de licença for Creator, o recurso de publicação deverá ser Yes/True/1
- Se você tiver uma instalação de servidor baseada em usuário e a adição de usuários exceder o número de usuários permitido pela sua licença, os usuários serão adicionados como não licenciados.
- Se você usar `tabcmd` e especificar a licença, mas a importação de usuários exceder os seus limites de licença, os usuários serão importados como não licenciados.

**Administrator level**: pode ser **System**, **Site** ou **None** e determina se o usuário será importado como um administrador.

- System = administrador do servidor, Site = administrador do site e None = não é administrador.
- Se não estiver conectado a um site específico e estiver importando usuários no nível de servidor, poderá atribuir apenas o Administrador do servidor e Unlicensed.
- Se você usar a interface do usuário da Web para importar usuários, poderá definir a função no site de administrador como System apenas se importar o arquivo no nível de servidor (todos os sites). Se você estiver conectado a um site específico e a coluna de administrador para um usuário no arquivo CSV estiver definida como System, o Tableau Server importará tal usuário como administrador de site.

**Publishing capability:** pode ser **Yes/True/1** ou **No/False/0**. Se você usar a interface do usuário da Web, o recurso de publicação será usado somente se a importação for realizada enquanto você estiver conectado a um determinado site.

- Se o nível de licença for Creator, o recurso de publicação deverá ser Yes/True/1
- Se o nível de licença for Explorer, o valor do recurso de publicação será o que distingue a função no site entre Explorer (pode publicar) e Explorer
- Se o nível de licença for Viewer ou Unlicensed, o usuário não poderá publicar, independentemente do valor desta coluna

**Email address**: o endereço de e-mail faz parte da informação usada para identificar um usuário no servidor. Se o endereço de e-mail já estiver sendo usado, o Tableau Server atualiza as informações existentes do usuário com as configurações no arquivo CSV.

As colunas deixadas em branco ainda devem ser delimitadas com vírgulas para preservar a estrutura da coluna.

### Pools de identidade

Se você adicionar usuários a um pool de identidades, as seguintes colunas serão necessárias além das colunas padrão:

Estrutura de coluna para o arquivo CSV: `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier`

Detalhes adicionais da coluna:

**Nome do pool de identidade:** o nome do pool de identidades ao qual você deseja adicionar o usuário. Se você estiver adicionando usuários a um pool de identidades e não especificar o nome desse pool, os usuários serão adicionados ao grupo inicial (TSM configurado), que é o conjunto de usuários que foram provisionados no TSM durante a instalação do Tableau Server.

**Identificador:** o identificador do usuário que você deseja adicionar. Os identificadores são usados apenas para fins de correspondência de identidade. Para obter mais informações, veja [Nomes de usuário e identificadores no Tableau](https://help.tableau.com/current/server/pt-br/identity_pools.htm#usernames_identifiers).

- Autenticação local: _opcional_
- Active Directory ou LDAP: _obrigatório_

#### Adicionar usuários em massa com pools de identidades

Você pode usar o processo de importação de CSV para:

- Adicionar usuários em massa a grupos de identidades adicionais. **Observação:** você não pode usar o processo de importação de CSV para substituir o grupo de identidades ao qual um usuário já pertence por outro grupo de identidades. Se você adicionar um usuário existente com um valor de grupo de identidades diferente, ele será adicionado a esse grupo de identidades adicional.
- Adicione identificadores em massa para usuários que ainda não os possuem. **Observação:** se você adicionar um identificador diferente para um usuário no mesmo pool, ele não substituirá o identificador existente desse usuário. Em vez disso, um novo registro identificador será criado para esse usuário.

### Exemplo de importação de CSV para o Tableau Server

> [!TIP]
> 
> **Dica**: lembre-se de que a estrutura é: `username, password, display name, license level, admin level, publishing capability, email address`.

O exemplo a seguir mostra um arquivo CSV que contém as informações de vários usuários.

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@example.com  
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com  
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com  
michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com

- Se você importar este arquivo enquanto gerencia um site, quatro usuários são adicionados a esse site. A configuração `Administrator` para o usuário Michelle é`System`. No entanto, como você está importando os usuários para um site, o Tableau Server fornece a Michelle a função no site Creator (Administrador de site). Três usuários têm permissão para publicar.
- Se você importar este arquivo enquanto gerencia o servidor, quatro usuários são adicionados ao servidor, mas não a qualquer site. Apenas um usuário é importado como administrador de servidor, os outros são definidos como Unlicensed.

#### Exemplos de pools de identidades.

> [!TIP]
> 
> **Dica**: lembre-se de que a estrutura é: `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier`.

O exemplo a seguir mostra um arquivo CSV que contém informações de dois usuários adicionados a um pool de identidades.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson  
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki

O exemplo a seguir mostra um arquivo CSV que contém informações de dois usuários adicionados a um pool de outras identidades opcional.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson  
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki

O exemplo a seguir mostra um arquivo CSV que contém informações de dois usuários sem identificadores existentes.

janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang  
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez

### Melhorar o desempenho de grandes arquivos CSV passados pelo tabcmd

**Observação:** essas configurações se aplicam ao Tableau Server versão 2022.1 e anteriores. O serviço de pesquisa e indexação afetado está obsoleto desde versão 2022.3 e descontinuado (removido completamente) em 2023.3.

Um administrador do servidor pode ativar as configurações do servidor que ajudam a melhorar o desempenho para a importação de arquivos CSV grandes por meio de comandos tabcmd. Para isso, é possível usar o comando `tsm configuration set` com as seguintes opções:

- `vizportal.csv_user_mgmt.index_site_users`
- `vizportal.csv_user_mgmt.bulk_index_users`
- `searchserver.index.bulk_query_user_groups`

Em suma, essas opções constroem um índice de usuários após o processamento do arquivo CSV, em vez de um a um ao longo do processo de adição no banco de dados do servidor. Isso reduz o número de chamadas para o banco de dados e a memória necessária para processar o arquivo. Essas opções `tsm configuration set` se aplicam aos comandos `tabcmd createsiteusers`, `deletesiteusers`, `addusers` e `removeusers`.

Para obter as descrições dessas configurações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

## Configurações de CSV e funções no site

As configurações de nível de licença, administrador e publicação de um usuário determinam como a função no site do usuário é definida durante o processo de importação. A seguir, é mostrado como as funções no site devem ser capturadas no CSV.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 30%;"><col style="width: 30%;"><col style="width: 20%;"><col></colgroup><tbody><tr><td style="font-weight: bold;">Função no site</td><td style="font-weight: bold;">License level</td><td style="font-weight: bold;">Administrator level</td><td style="font-weight: bold;">Publishing capability</td></tr><tr><td><p><b>Administrador de servidor </b></p><p><i>Essa função será válida somente se você estiver importando usuários durante o gerenciamento do servidor (ou seja, sem estar conectado a um site específico). </i></p></td><td>Qualquer um, mas a função no site Administrador do servidor sempre usa uma licença Creator se houver uma disponível. Se nenhuma licença de Creator estiver disponível, consulte <a href="https://help.tableau.com/current/server/pt-br/unlicensed.htm" class="xref">Solucionar problemas de licenciamento</a> para saber sobre como o Tableau Server lida com isso.</td><td>System</td><td>True</td></tr><tr><td><p><b>Creator (Administrador de site)</b> ou <b>Explorer (Administrador de site)</b></p><p><i>Essas funções serão válidas somente se você estiver importando usuários quando estiver conectado a um site específico.</i></p></td><td>Creator ou Explorer</td><td>Site</td><td>True</td></tr><tr><td><b>Creator</b></td><td>Creator</td><td>None</td><td>True</td></tr><tr><td><b>Explorer (pode publicar)</b></td><td>Explorer</td><td>None</td><td>True</td></tr><tr><td><b>Explorer</b></td><td>Explorer</td><td>None</td><td>False</td></tr><tr><td><b>Viewer</b></td><td>Viewer</td><td>None</td><td>False</td></tr><tr><td><b>Unlicensed</b></td><td>Unlicensed</td><td>None</td><td>False</td></tr></tbody></table>

<!-- document id=a48861cd76c5ae4030c61683566f38a5f9db37d1ccb5079ca133342d3f3c792e url=/tableau/current/pt-br/server/perf_guidelines.md -->

[Pular para o conteúdo principal](#main-content)

# Diretrizes gerais de desempenho

## Hardware e software

**Adicione mais núcleos e memória**: Independentemente de estar executando o Tableau Server em um computador ou em vários, a regra geral é: quanto mais núcleos de CPU e mais RAM, melhor desempenho você terá. Certifique-se de que você atende aos requisitos de hardware e software recomendados para o Tableau Server.

Se estiver executando o Tableau Server em um ambiente virtual, use as práticas recomendadas de seu host da VM para a alocação vCPU em relação ao número de núcleos de CPU físicos no host da VM.

## Repositório externo

Para obter o desempenho ideal do Tableau Server, recomendamos isolar o repositório em um nó dedicado em sua implantação. Se você tiver uma licença do Advanced Management, execute o repositório como um banco de dados externo.

Se sua organização tiver um pico de carga de mais de 1.000 sessões VizQL por hora, também recomendamos executar o Tableau Server no Linux. Neste cenário, as sessões VizQL referem-se a qualquer ação do usuário que exibe ou gera visualizações do Tableau Server.

Para obter mais informações, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server-linux/pt-br/server_external_repo.htm).

## Configuração

**Agende atualizações para horários fora de pico**: Use a exibição administrativa adminview\_backgrnd.htm para ver suas agendas de tarefas de atualização e backup. Use a exibição administrativa [Tarefas em segundo plano para extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd.htm) para ver sua programação de atualizações e backup. Suas tarefas de atualização devem ser agendadas para horários alternativos que não se sobreponham à sua janela de backup.

**Verifique o cache**: O cache Tableau Server responde às solicitações de clientes rapidamente, especialmente para exibições que se conectam aos bancos de dados ativos. Use o comando [tsm data-access caching list](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#caching-list) para confirmar se a frequência do armazenamento em cache está definida como `low` (esse é o padrão).

O Tableau Server usa um cache de consulta para armazenar resultados de consulta. O tamanho do cache de consulta é definido automaticamente com base na quantidade de memória disponível do sistema, desde que você não tenha configurado ele manualmente. O cache de consulta consiste no cache de consulta lógica, no cache de metadados e no cache de consulta nativo. As configurações padrão são adequadas para a maioria das situações, mas é possível configurá-las manualmente usando a interface da linha de comando TSM. As configurações de TSM são: `native_api.InitializeQueryCacheSizeBasedOnWeights`, `native_api.QueryCacheMaxAllowedMB`, `native_api.LogicalQueryCacheMaxAllowedWeight`, `native_api.MetadataQueryCachMaxAllowedWeight`, `native_api.NativeQueryCacheMaxAllowedWeight` e `native_api.QueryCacheEntryMaxAllowedInPercent`. Para obter mais informações, consulte [native\_api.InitializeQueryCacheSizeBasedOnWeights](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#querycachesizeadaptiveinit).

**Considere alterar as configurações de memória de duas sessões**:

- **Tempo limite da sessão VizQL**: O tempo limite padrão da sessão do VizQL é de 30 minutos. Mesmo se uma sessão VizQL estiver ociosa, ela ainda estará consumindo memória e ciclos de CPU. Caso seja possível fazer isso com um limite inferior, use as [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm) para alterar a configuração do `vizqlserver.session.expiry.timeout`.
- **Limpeza de sessão VizQL**: Por padrão, as sessões VizQL são mantidas na memória até mesmo quando o usuário navega afastado de uma exibição. Isso reduz a necessidade de recriar exibições, mas consome mais memória da sessão. Para liberar memória, encerre as sessões quando os usuários deixarem as exibições, alterando o valor da configuração `vizqlserver.clear_session_on_unload` para `true`. (Independentemente dessa configuração, as sessões do aplicativo Tableau Mobile sempre são mantidas na memória, melhorando o desempenho móvel.)

**Avalie a configuração de seus processos**: O Tableau Server é dividido em seis componentes diferentes chamados processos de servidor. Embora a configuração padrão tenha sido desenvolvida para trabalhar em uma ampla gama de cenários, você também pode reconfigurá-la para atingir diferentes metas de desempenho. Mais especificamente, você pode controlar em quais computadores os processos são executados e quantos são executados. Consulte [Ajuste de desempenho](https://help.tableau.com/current/server/pt-br/perf_tuning.htm) para obter as diretrizes gerais para implantações de um, dois e três nós.

## Software antivírus

O software antivírus que verifica os diretórios usados pelo Tableau Server pode interferir na instalação e no uso contínuo do Tableau Server. Em alguns casos, isso pode resultar em falhas de instalação, problemas de inicialização do Tableau Server ou afetar o desempenho. Se você planeja executar um software antivírus no computador que executa o Tableau Server, siga as recomendações na [Base de dados de conhecimento](https://kb.tableau.com/articles/howto/improving-performance-by-using-antivirus-exclusions?lang=pt-br).

## Gerenciador de recursos do servidor (SRM)

O Gerenciador de recursos do servidor (SRM, Server Resource Manager) monitora os recursos do sistema que cada processo do Tableau está usando, bem como o uso total de Tableau Server no sistema. Se um processo específico ou o produto como um todo ocupar muitos recursos do sistema, o SRM pode notificar os processos para liberá-los ou reiniciá-los.

Os limites que determinam quando o SRM notificará ou reiniciará um processo são definidos nas opções de configuração do SRM. A equipe de desenvolvimento do Tableau definiu as configurações padrão com base em testes internos e não recomenda que sejam alteradas pelo usuário direto.

Se estiver observando o uso excessivo de recursos do sistema, recomendamos entrar em contato com o Suporte do Tableau para ajudar a determinar se essas opções de configuração precisam ser modificadas, a fim de resolver o problema enfrentado.

<!-- document id=820cbc9417e45bc5ab66e929da5f32d84106d006559f81955d81f11e270b709a url=/tableau/current/pt-br/server/sites_availability.md -->

[Pular para o conteúdo principal](#main-content)

# Disponibilidade de site

Um site pode ser suspendido ou bloqueado devido a uma importação de site malsucedida, ou porque um administrador de servidor escolheu suspendê-lo por um período de tempo.

Quando um site é suspenso, somente o administrador de servidor pode ativar o site para disponibilizá-lo novamente.

**Observação**: se um site for bloqueado e você não puder acessar a página Sites pela interface do servidor, use o comando [tsm sites unlock](https://help.tableau.com/current/server/pt-br/cli_sites_tsm.htm#TSMUnlock) para alterar o estado para ativo.

## Para ativar ou suspender um site

1. No menu do site, clique em Gerenciar todos os sites e, em seguida, clique em Sites.
2. Selecione o site e, em seguida, selecione Ações > Ativar ou Suspender.
    
    ![Uma lista de sites do Tableau com um menu suspenso aberto, com a ação “Ativar...” selecionada.](/tableau/current/pt-br/server/pt-br/Img/sites_activate.png)

<!-- document id=f4612fc6ef286daa99f2abfa183f875109ec3605c024c7e4f167c3129fad72a2 url=/tableau/current/pt-br/server/dbdriver.md -->

[Pular para o conteúdo principal](#main-content)

# Drivers de banco de dados

Os conectores do Tableau exigem um driver para se comunicar com o banco de dados. Antes de poder se conectar à fonte de dados com o Tableau Server, você deve instalar os drivers para as fontes de dados às quais deseja se conectar. É possível encontrar links para os drivers e instruções de instalação para todos os conectores suportados na [Página de download de drivers](https://www.tableau.com/pt-br/support/drivers).

**Importante:** A partir da versão 2023.1.0, instale o driver PostgreSQL se quiser usar as .[exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) integradas. Você pode encontrar isso na [página de Download do driver](https://www.tableau.com/pt-br/support/drivers).

## Instalação de drivers em um servidor com vários nós

É necessário instalar os drivers para as fontes de dados no nó inicial de um cluster do Tableau Server. Caso instale o Tableau Server em vários nós, é necessário instalar os drivers em todos os nós que executem qualquer um dos seguintes processos:

- Servidor de aplicativos (Vizportal)
- Processador em segundo plano
- Servidor de dados
- VizQL Server

## Parar o servidor antes de atualizar os drivers

Ao atualizar um driver, recomendamos que você pare o Tableau Server antes de instalar a nova versão do driver e desinstalar o antigo. Isso pode não ser necessário para todos os drivers, mas a pausa do Servidor garante que todas as conexões usem o driver atualizado sem conflitos.

<!-- document id=87db2368b95c814e642c9f1e29ebc9fd5148d36dfb03084456f5b24715984b32 url=/tableau/current/pt-br/server/connections_modify.md -->

[Pular para o conteúdo principal](#main-content)

# Editar conexões no Tableau Server

Os administradores e os proprietários de fonte de dados podem gerenciar as informações que descrevem como uma fonte de dados publicada se conecta aos dados subjacentes. Essas informações incluem o nome ou o endereço do servidor do banco de dados, a porta do servidor, o nome de usuário e se a senha está ou não incluída na conexão.

**Observação:** a capacidade de editar as conexões é determinada principalmente pela sua função do site, em vez de suas permissões na fonte de dados. Para editar as conexões, a função no site deve ser Administrador do servidor, Administrador de site ou Creator. Se a sua função for Creator, é necessário que seja também o proprietário da fonte de dados.

1. Faça logon no site que tem as fontes de dados que você deseja modificar e, na guia Conteúdo, selecione Explorar > Fontes de dados.
2. Selecione o nome da fonte de dados com a conexão que deseja atualizar.
    
    Mostre filtros para procurar pela fonte de dados ou diminua o escopo da lista de fontes de dados. Os valores digitados nos campos Nome do servidor e Nome de usuário do banco de dados são tratados como expressões regulares.
3. Na exibição Conexões, selecione o menu Ações (…) da fonte de dados, em seguida, selecione Editar conexão.
    
    ![Lista de conexões de fonte de dados com um menu suspenso expandido para mostrar a opção Editar conexão.](/tableau/current/pt-br/server/pt-br/Img/ds_connect3.png)
    
    Para editar várias fontes de dados, selecione as fontes de dados que deseja editar e, em seguida, clique no menu Ações e Editar conexão.
4. Atualize as informações de conexão.
    
    Para Nome do servidor, se deseja usar o endereço IP, certifique-se de que o banco de dados ou o driver suporte esse tipo de conexão. Se não suportar, insira o nome do servidor de banco de dados.
    
    Consulte também [Tipos de autenticação para os dados do Google, Salesforce e WDC](#google-sfdc-auth) posteriormente neste tópico.
    
    ![Caixa de diálogo Editar conexão com opções para editar o nome do servidor, a porta do servidor, o nome de usuário e a senha da conexão de dados selecionada.](/tableau/current/pt-br/server/pt-br/Img/ds_connect4.png)
    
    **Observação:** o botão Conexão de teste está desabilitado nas versões 2021.4 e posteriores quando Solicitar senha ao usuário, se necessário é selecionado.
5. Clique em Salvar.
6. Atualize a página do navegador para que suas alterações entrem em vigor.

## Tipos de autenticação para os dados do Google, Salesforce e WDC

Google BigQuery, Google Analytics, Salesforce.com e muitas conexões do conector de dados da web (WDC) usam o padrão de autenticação OAuth, que usa tokens de acesso seguros em vez de credenciais brutas de nome de usuário e senha. Com OAuth, as credenciais de banco de dados não precisam ser armazenadas no Tableau, e todos os usuários se conectam por esse token de acesso, incluindo os usuários do Tableau Desktop que desejam criar ou editar pastas de trabalho que se conectam à fonte de dados.

As seções a seguir descrevem as opções de conexão do Salesforce. As opções do conector de dados da Web variam, mas todas requerem que a conexão seja estabelecida usando o formulário de logon do provedor na Web para determinar o token de acesso.

### Opções de autenticação do Google

Ao editar as conexões do Google BigQuery ou Google Analytics, selecione uma das seguintes opções na caixa de diálogo Editar conexão:

- Selecione Inserir credenciais do Google BigQuery (ou do Google Analytics) na conexão para se autenticar usando uma conta designada. Em seguida, escolha uma conta existente na lista ou selecione autenticar conta agora... para adicionar uma nova.
    
    Quando você adiciona uma nova conta, a página de logon do Google é exibida. Depois que você fornecer suas credenciais de banco de dados, o Google solicita que você confirme o acesso do Tableau aos dados. Quando você clica em Aceitar, o Google retorna um token de acesso a ser usado na conexão com os dados.
    
    **Observação**: Se você criar extrações de sua fonte de dados do Google, selecione essa primeira opção para poder programar tarefas de atualização.
- Selecione Solicitar credenciais do Google BigQuery/Analytics ao usuário para exigir que os usuários se conectem usando seus próprios tokens de acesso individuais ou façam logon sempre que se conectarem.

### Opções de autenticação do Salesforce.com

**Observação:** isso só se aplica se o Tableau Server estiver configurado para usar credenciais salvas para Salesforce com o OAuth. Se o servidor não estiver configurado para isso, use o processo padrão acima para modificar conexões. Para obter mais informações sobre a configuração do Tableau Server para usar credenciais salvas com o OAuth, consulte [Alterar o OAuth do Salesforce.com para credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm).

Ao editar conexões do Salesforce.com, é possível selecionar qualquer uma das seguintes opções na caixa de diálogo Editar conexão:

- Selecione Nome de usuário e senha do Salesforce inseridos na conexão para usar um método de autenticação tradicional.
- Selecione Credenciais do Salesforce inseridas na conexão para usar uma conexão OAuth e agendar tarefas de atualização e, em seguida, selecione uma conta existente na lista ou clique em Adicionar uma conta do Salesforce para adicionar uma nova.
    
    Quando você adicionar uma nova conta, a página de logon do Salesforce.com será exibida. Depois de fornecer suas credenciais de bancos de dados, o Salesforce.com solicita que você confirme o acesso do Tableau aos dados. Quando você permite o acesso ao Tableau, o Salesforce.com cria um token de acesso com o qual se conecta aos dados.
    
    ![Configurações para editar uma conexão de dados selecionada e inserir credenciais de autenticação.](/tableau/current/pt-br/server/pt-br/Img/connections7a.png)
- Selecione Nenhuma autenticação do Salesforce para exigir que os usuários façam logon no Salesforce.com sempre que se conectarem. (Esta opção não permite agendar atualizações de extrações.)

## Monitorar andamento

Quando você salva as alterações na caixa de diálogo Editar conexão, ela mostra o progresso. Se você fechar a caixa de diálogo, as modificações continuarão sendo executadas em segundo plano até serem concluídas. Tableau Server fará o maior número de alterações possível. Todas as falhas serão ignoradas, mas não impedirão outras alterações. Por exemplo, se você tentar alterar o nome do servidor e adicionar uma senha a várias conexões, os nomes de servidor serão alterados e as senhas nas pastas de trabalho também. No entanto, como não é possível adicionar uma senha a uma fonte de dados, as senhas para as fontes de dados não serão alteradas.

Para obter informações sobre como verificar o progresso dessas tarefas, consulte [Tarefas em segundo plano para extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd.htm).

<!-- document id=66a4ad063b9dda8cc8bb220cab3d2d354503039ae34de7d8d6fd09f4d33837fe url=/tableau/current/pt-br/server/edit_datasources.md -->

[Pular para o conteúdo principal](#main-content)

# Editar uma fonte de dados publicada

Imagine que você publicou uma fonte de dados e sua equipe está usando-a em várias pastas de trabalho. Este é um bom começo, mas você tem algumas mudanças em mente que melhorarão muito a fonte de dados. Antes de implementar essas alterações, você quer ver a aparência das alterações propostas no Tableau. E o mais importante, você precisa testar as alterações para garantir que não prejudiquem as pastas de trabalho existentes que usam a fonte de dados.

Editar uma fonte de dados publicada permite que você teste alterações e faça melhorias nela, enquanto a mantém como uma única fonte de dados.

**Observação**: somente usuários com uma função de site de Creator podem editar fontes de dados publicadas no navegador.

Como alternativa, você pode _estender_ uma fonte de dados publicada fazendo as alterações em uma nova fonte de dados. Uma fonte de dados publicada estendida sobrepõe suas substituições em uma nova fonte de dados sem alterar a original e mantém uma conexão com essa fonte de dados original. Para obter mais informações, consulte [Expandir fontes de dados publicadas](https://help.tableau.com/current/pro/desktop/pt-br/datasource_extend_compose.htm).

## Editar e testar as alterações

Esteja você criando uma nova fonte de dados publicada ou editando uma fonte de dados publicada existente, é possível criar relacionamentos e modificar o modelo de dados na página Fonte de dados sem sair do navegador. Em seguida, use o Scratchpad para testar suas alterações, criar pastas, organizar hierarquias e renomear campos e aliases antes de publicar sua fonte de dados. Ao editar sua fonte de dados, você terá todos os mesmos recursos e funcionalidades que possui ao criar no Tableau Cloud. Para obter mais informações, consulte [Criação na Web em comparação com os recursos do Tableau Desktop](https://help.tableau.com/current/pro/desktop/pt-br/server_desktop_web_edit_differences.htm)

Para editar uma fonte de dados publicada:

1. Na página Iniciar ou Explorar, navegue até a fonte de dados que deseja editar.
2. Clique em Editar fontes de dados.  
    ![Botão Editar fontes de dados](/tableau/current/pt-br/server/pt-br/Img/edit_published_data_source.png)
3. Clique na página Fonte de dados para fazer uniões de coluna ou editar o esquema.
4. Clique na planilha Scratchpad.
5. No painel Dados, crie pastas, organize hierarquias, renomeie campos e aliases ou atualize metadados que são salvos com a fonte de dados publicada.
6. Arraste e solte os campos no bloco de notas para garantir que as alterações estejam funcionando conforme o esperado.
7. Clique em Publicar.

Assim como faz com as pastas de trabalho, você também pode Publicar como se quiser fazer uma cópia da fonte de dados.

**Observação:** os espaços pessoais não oferecem suporte a fontes de dados publicadas.

## Reverter alterações

Para reverter para a última versão da fonte de dados publicada:

1. Navegue até a fonte de dados que deseja reverter.
2. Clique em Arquivo.
3. Escolha Reverter para publicado .

![Menu suspenso de arquivo, opção Reverter para publicado](/tableau/current/pt-br/server/pt-br/Img/revert_to_published.png)

Isso reverte para a versão publicada mais recente dessa fonte de dados.

## Entenda as conexões compatíveis

A edição de fontes de dados publicadas não oferece suporte a fontes de dados que usam senhas inseridas no Tableau Cloud e Tableau Server.

Além disso, a página Fonte de dados não está disponível para tipos de conexão de fonte de dados publicada que não é compatível, incluindo, mas não se limitando aos tipos de arquivo .hyper. Para ver quais tipos de conexão são compatíveis, consulte [Criadores: conectar a dados na Web](https://help.tableau.com/current/server/pt-br/creator_connect.htm) .

## Saiba mais sobre as permissões

Para editar uma fonte de dados publicada, você precisará de uma licença de criador que tenha as permissões Salvar ou Salvar como para fontes de dados na respectiva pasta. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/online/pt-br/permissions.htm).

## Editar fontes de dados publicadas por um fluxo

Se você fizer edições em uma fonte de dados publicada por um fluxo, as alterações serão substituídas durante o próximo fluxo agendado. Em vez disso, edite a fonte de dados no fluxo. Para obter mais informações, consulte [Publicar um fluxo para o Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm).

<!-- document id=959d5535110f0e15b36101aa4354a700866b0fadbec2590171156c52115dc8c2 url=/tableau/current/pt-br/server/datasource_mfr_relatedness_messages.md -->

[Pular para o conteúdo principal](#main-content)

# Entenda as dicas de ferramentas para modelos de dados de relação de vários fatos

**Observação**: para fontes de dados de tabela única ou fontes de dados de tabela de base única, todas as tabelas estão relacionadas. Tudo nesta página se refere a diversas fontes de dados da tabela base.

## Relação em nível de campo

Os modelos de dados com múltiplas tabelas base têm muita flexibilidade na forma como as tabelas podem se relacionar — ou não — entre si. A relação entre _tabelas_ é uma constante baseada no modelo de dados. No entanto, a relação entre _Campos_ em uma visualização depende de quais campos estão ativos (ou seja, quais campos estão em uso nas divisórias da planilha como pílulas). No nível de uma única visualização, o Tableau avalia os campos ativos em pares para determinar [como eles se relacionam](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#fieldlevel).

Um ícone não relacionado ![ícone não relacionado](/tableau/current/pt-br/server/pt-br/Img/mfr_icon_unrelated.png) em um campo significa que ele não está relacionado a pelo menos outro campo na visualização. Este ícone pode aparecer em um comprimido em uma divisória ou no painel Dados. (Em alguns casos, pode haver um ícone relacionado ![](/tableau/current/pt-br/server/pt-br/Img/MFR_icon_related.png "ícone de relacionamento").) Passar o mouse sobre o ícone abre uma dica com mais informações. Existem mensagens diferentes para diferentes tipos de relacionamento de campo, incluindo:

- Pares dimensão-dimensão não relacionados
- Pares de dimensão-medida não relacionados
- Dimensões de junção
- Pares de filtros não relacionados

> [!TIP]
> 
> **Dica**: no Tableau, as dimensões agregadas, como ATTR(dimensão) ou MIN(dimensão), agem como medidas.

As mensagens também variam um pouco dependendo se o campo está em uso em uma divisória ou no painel Dados.

- **Em uma divisória**: a dica de ferramenta para pílulas nas divisórias fornece informações sobre como os campos na visualização estão relacionados entre si e qual o impacto disso na forma como o Tableau calculou os resultados.
- **No painel Dados**: a dica de ferramenta para campos no painel de dados fornece informações sobre o que _aconteceria_ se esse campo fosse adicionado à visualização. Os campos no painel Dados também podem ser destacados com texto cinza claro se não estiverem relacionados a nenhum campo na visualização.

Existem vários recursos que podem ser adicionados ao comentário do campo, como cálculos de tabela e comentários fornecidos pelo usuário. Todas essas informações são exibidas em uma dica de ferramenta unificada.

![](/tableau/current/pt-br/server/pt-br/Img/unified_tooltip.png "Dica de ferramenta para um campo com informações sobre relacionamento, cálculos de tabela e um comentário do usuário")

### Conheça o seu modelo de dados

Sempre que você estiver trabalhando com um modelo de dados que contém relações multifatoriais, é útil consultar o modelo regularmente na página. Use a opção [Exibir modelo de dados](https://help.tableau.com/current/pro/desktop/pt-br/viewdatamodel.htm) (menu Planilha > Exibir modelo de dados) para abrir uma caixa de diálogo com o modelo de dados que você pode consultar em uma guia de planilha.

Os exemplos neste tópico são baseados em um modelo de dados com duas tabelas base, Classes e Clubes, e duas tabelas compartilhadas, Alunos e Salas.

![um modelo de dados com duas tabelas base, Classes e Clubes, e uma tabela compartilhada, Alunos](/tableau/current/pt-br/server/pt-br/Img/mfr_basic_4table_model.png)

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"></colgroup><tbody><tr><td><p><b>Classes</b></p></td><td><p><b>Clubes</b></p></td><td><p><b>Alunos</b></p></td><td><b>Salas</b></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_ex_viewdata_classes_r.png" alt="Visualize os dados da tabela Classes, mostrando três campos e seus valores"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_ex_viewdata_clubs_r.png" alt="Visualize os dados da tabela Clubes, mostrando três campos e seus valores"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_ex_viewdata_students_r.png" alt="Visualize os dados da tabela Alunos, mostrando três campos e seus valores"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_ex_viewdata_rooms_r.png" alt="Visualize os dados para a tabela Salas, mostrando três campos e seus valores"></td></tr><tr><td><p>Campos:</p><ul><li><b>Classes</b>, uma dimensão com valores de Noções básicas de aninhamento, músicas avançadas, voo para iniciantes e chamadas de alarme 101</li><li><b>Sala</b>, uma dimensão usada para se relacionar com a tabela Salas</li><li><b>Aluno</b>, uma dimensão usada para se relacionar com a tabela Alunos</li><li><b>Comprimento</b>, uma medida</li></ul></td><td><p>Campos:</p><ul><li><b>Clube</b>, uma dimensão com valores de Fotografia, Viagem, Malabarismo, Arte e Primeiros Socorros</li><li><b>Sala</b>, uma dimensão usada para se relacionar com a tabela Salas</li><li><b>Aluno</b>, uma dimensão usada para se relacionar com a tabela Alunos</li><li><b>Taxas</b>, uma medida</li></ul></td><td><p>Campos:</p><ul><li><b>Piloto de ônibus</b>, uma dimensão com valores de sim ou não</li><li><b>Aluno</b>, uma dimensão com valores de Finch, Cardinal, Sparrow, Robin e Jay. Usado para relacionar com as tabelas de base</li><li><b>Idade</b>, uma medida</li></ul></td><td><p>Campos:</p><ul><li><b>Sala</b>, uma dimensão com valores de Cedro, Amieiro, Bordo, Abeto e Madrone</li><li><b>Galhos</b>, uma medida</li></ul></td></tr></tbody></table>

## Par dimensão-dimensão não relacionado

Dimensões não relacionadas são unidas de forma cruzada, o que pode resultar em combinações de membros de dimensão nos cabeçalhos que não refletem combinações reais de dados nas tabelas subjacentes.

A mensagem para um par dimensão-dimensão não relacionado é:

- **Em uma divisória**: dimensões não relacionadas mostram todas as combinações possíveis de valores. Não relacionado a: _<list of dimensions>_
- **No painel Dados**: se usada, esta dimensão mostrará todas as combinações possíveis de valores com dimensões não relacionadas: _<list of dimensions>_
- **Acinzentado no painel Dados**: esta dimensão não está relacionada a nenhuma dimensão na viz. Se usada, ela mostrará todas as combinações possíveis de valores com outras dimensões não relacionadas.

E para um filtro não relacionado é:

- **Na visualização**: este campo não é filtrado por filtros não relacionados: _<filters>_
- **No painel Dados**: se usado, este campo será ignorado por filtros não relacionados: _<filters>_

Uniões de coluna cruzadas podem ser operações caras que prejudicam o desempenho. Por isso, o Tableau também exibirá um [Caixa de diálogo de aviso de relação](https://help.tableau.com/current/server/pt-br/datasource_mfr_multiple_base_tables.htm#Relatedn) se você adicionar uma dimensão não relacionada à visualização.

## Dimensões de junção

Embora existam razões analiticamente relevantes para visualizar dimensões não relacionadas sozinhas, um “caminho feliz” comum para análise com várias tabelas base é usar uma dimensão de junção adicional. Na presença de uma dimensão de junção, as dimensões não relacionadas não são mais unidas de forma cruzada, mas sim com uniões de coluna externas. As uniões de coluna externas ainda podem introduzir valores nulos, mas os cabeçalhos dos membros de dimensão são reduzidos de todas as combinações possíveis para combinações que são relevantes para pelo menos um lado da união de coluna externa. Elas também não têm o mesmo potencial de impactos no desempenho que as uniões de coluna cruzadas. Se não houver outros problemas de relacionamento que exijam um ícone não relacionado, uma dimensão de junção mostrará, em vez disso, um ícone relacionado ![](/tableau/current/pt-br/server/pt-br/Img/MFR_icon_related.png "ícone relacionado").

A mensagem para uma dimensão de junção é:

- **Em uma divisória**: esta dimensão une os seguintes campos: lista de campos: _<list of fields>_
- **No painel Dados**: se usada, essa dimensão unirá os seguintes campos: lista de campos: _<list of fields>_
- **Esmaecido no painel Dados**: _não se aplica, a junção ocorre apenas em uma visualização_

Comparando dimensões não relacionadas com dimensões em junção

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>Não relacionado: união de colunas cruzada</p></td><td><p>União: união de colunas externa de uniões de colunas internas intermediárias</p></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_tt_unrelateddims.png" alt="Uma união de colunas cruzada com uma linha para cada combinação de Classe e Clube"><p><span class="caption">Uma visualização mostrando uma união de colunas cruzada de Classe e Clube com linhas para cada combinação de Músicas Avançadas/Chamadas de Alarme 101/Voo para iniciantes/Noções Básicas de Aninhamento com Arte/Primeiros Socorros/Malabarismo/Fotografia. </span></p></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_tt_unrelateddimsstitched_252.png" alt="Uma união de colunas externa dos resultados da classe estudantil e do clube estudantil"><p><span class="caption">Uma visualização que mostra os resultados de uma união de colunas externa da união de colunas interna Aluno-Classe e da união de colunas interna Aluno-Clube. Nem todas as combinações de classes e clubes estão representadas e há filas para alunos e clubes sem turma.</span></p></td></tr></tbody></table>

## Par dimensão-medida não relacionado

Para obter informações sobre como os valores de medida são calculados e por que a relação das dimensões é importante, consulte [Uma observação sobre como os valores de medida são calculados](#computemeasures).

A mensagem da medida é:

- **Em uma divisória**: esta medida não pode ser dividida em dimensões não relacionadas listadas>: _<list of dimensions>_.
- **No painel Dados**: se usada, esta medida não será dividida por dimensões não relacionadas: _<list of dimensions>_
- **Esmaecido no painel Dados**: esta medida não está relacionada a nenhuma dimensão na visualização. Se usada, ela não será quebrada.

A mensagem para a dimensão é:

- **Em uma divisória**: esta dimensão não pode decompor medidas não relacionadas: _<list of measures>_
- **No painel Dados**: se usada, esta dimensão não quebrará medidas não relacionadas: _<list of measures>_
- **Esmaecido no painel Dados**: esta dimensão não está relacionada a nenhuma medida na visualização. Se usada, ela não quebrará valores de medida.

E para um filtro não relacionado é:

- **Na visualização**: este campo não é filtrado por filtros não relacionados: _<filters>_
- **No painel Dados**: se usado, este campo será ignorado por filtros não relacionados: _<filters>_

O resultado em uma visualização é um valor repetido para a medida nos valores da dimensão não relacionada. Esse comportamento é semelhante a quando uma expressão LOD é usada para definir o nível de agregação de uma medida em um nível de detalhe diferente da granularidade nativa da visualização. Uma dimensão não relacionada é essencialmente EXCLUÍDA do cálculo do valor agregado da medida.

![](/tableau/current/pt-br/server/pt-br/Img/mfr_measures_repeated.png "Uma visualização onde o valor das quotas está vinculado ao clube, e os clubes são repetidos em todas as classes")

## Ainda não relacionado

Campos com relacionamentos potenciais são chamados [ainda não relacionado](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#notyet) e são avaliados como não relacionados na visualização. [Resolver](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#resolve) campos ainda não relacionados é feito de forma diferente da resolução de campos realmente não relacionados (que só podem ser unidos), então a dica de ferramenta indica por que eles são considerados não relacionados.

A mensagem para a dimensão depende se ela ainda não está relacionada a outra dimensão, medida ou filtro.

- Para um par dimensão-dimensão, a mensagem para a dimensão é: 
    - **Em uma divisória**: dimensões não relacionadas mostram todas as combinações possíveis de valores. Essa dimensão ainda não está relacionada e, portanto, é tratada como não relacionada ao seguinte: _<list of dimensions>_
    - **No painel Dados**: se usada, esta dimensão ainda não estará relacionada e, portanto, será tratada como não relacionada ao seguinte: _<list of dimensions>_
- Para um par dimensão-medida, a mensagem para a dimensão é: 
    - **Em uma divisória**: esta dimensão ainda não está relacionada e, portanto, não pode ser decomposta no seguinte: _<list of measures>_
    - **No painel Dados**: se usada, esta dimensão ainda não estará relacionada e, portanto, não quebrará o seguinte: _<list of measures>_
- Para um par dimensão-filtro, a mensagem para a dimensão é: 
    - **Em uma divisória**: este campo ainda não está relacionado e, portanto, é ignorado por estes filtros: _<list of filters>_
    - **No painel Dados**: se usado, este campo ainda não estará relacionado e, portanto, será ignorado por filtros não relacionados: _<list of filters>_

A mensagem da medida depende se ela ainda não está relacionada a uma dimensão ou a um filtro.

- Para um par medida-dimensão, a mensagem para a medida é: 
    - **Em uma prateleira**: esta medida ainda não está relacionada e, portanto, não pode ser decomposta no seguinte: _<list of dimensions>_
    - **No painel Dados**: se usada, essa medida ainda não estará relacionada e, portanto, não será dividida pelo seguinte: _<list of dimensions>_
- Para um par medida-filtro, a mensagem para a medida é: 
    - **Em uma divisória**: este campo ainda não está relacionado e, portanto, é ignorado por estes filtros: _<list of filters>_
    - **No painel Dados**: se usado, este campo ainda não estará relacionado e, portanto, será ignorado por filtros não relacionados: _<list of filters>_

Para obter informações sobre como os valores de medida são calculados e por que a relação das dimensões é importante, consulte [Uma observação sobre como os valores de medida são calculados](#computemeasures).

## Relacionado ambiguamente

Campos com mais de um possível relacionamento ativo são chamados [ambiguamente relacionado](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#ambiguamente) e são avaliados como não relacionados na visualização. [Resolver](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#resolve) campos ambiguamente relacionados é feito de forma diferente do que resolver campos realmente não relacionados (que só podem ser unidos), então a dica de ferramenta explica por que eles são considerados não relacionados.

A mensagem para a dimensão é:

- **Em uma divisória**: esta dimensão está relacionada de forma ambígua e, portanto, não pode ser decomposta no seguinte: _<list of measures>_
- **No painel Dados**: se usada, esta dimensão estará ambiguamente relacionada e, portanto, não será decomposta no seguinte: _<list of measures>_

A mensagem para a medida depende se a ambiguidade está em uma dimensão ou em um filtro.

- Para um par medida-dimensão, a mensagem para a medida é: 
    - **Em uma divisória**: esta medida está ambiguamente relacionada e, portanto, não pode ser decomposta no seguinte: _<list of dimensions>_
    - **No painel Dados**: se usada, essa medida estará ambiguamente relacionada e, portanto, não será dividida pelo seguinte: _<list of dimensions>_
- Para um par medida-filtro, a mensagem para a medida é: 
    - **Em uma divisória**: esta medida está ambiguamente relacionada e, portanto, é ignorado por estes filtros: _<list of filters>_
    - **No painel Dados**: se usada, esta medida será relacionada ambiguamente e, portanto, ignorada pelos seguintes filtros: _<list of filters>_

Para obter informações sobre como os valores de medida são calculados e por que a relação das dimensões é importante, consulte [Uma observação sobre como os valores de medida são calculados](#computemeasures).

## Medir de uma tabela compartilhada

Quando uma dimensão de uma tabela compartilhada (como Alunos) é usada, ela une as dimensões de tabelas não relacionadas (como Classes e Clubes). Mas e se, em vez de uma dimensão, você usar uma medida da tabela Alunos? Medidas não podem ter junção.

![um modelo de dados com duas tabelas base, Classes e Clubes, e uma tabela compartilhada, Alunos](/tableau/current/pt-br/server/pt-br/Img/mfr_basic_3table_model.png)

Em um caso em que há dimensões não relacionadas visualizadas juntas, a medida não pode ser dividida por essas dimensões simultaneamente. (Para obter informações sobre como os valores de medida são calculados e por que a relação das dimensões é importante, consulte [Uma observação sobre como os valores de medida são calculados](#computemeasures).) Nesse caso, tratamos a medida como não relacionada à combinação de dimensões, mesmo que ela esteja relacionada a qualquer dimensão individualmente.

Para resolver esse tipo de ambiguidade e evitar que a medida seja delimitada por tabela, as dimensões não relacionadas podem ser unidas ou uma ou mais dimensões podem ser removidas até que haja um caminho de relacionamento claro para agregar a medida.

### Todas as dimensões não estão relacionadas entre si

A mensagem para uma medida compartilhada entre dimensões não relacionadas é:

- **Em uma divisória**: esta medida só pode ser decomposta por uma destas dimensões de cada vez: _<bulleted list of dimensions>_
- **No painel Dados**: se usada, esta medida só pode ser dividida em uma destas dimensões por vez: _<bulleted list of dimensions>_

A mensagem para cada dimensão é:

- **Em uma divisória**: esta dimensão não pode decompor a medida _<measure>_ em combinação com as seguintes dimensões: _<bulleted list of dimensions>_
- **No painel Dados**: se usada, esta dimensão não pode decompor a medida _<measure>_ em combinação com os as seguintes dimensões: _<bulleted list of dimensions>_

### Algumas dimensões estão relacionadas entre si

Se algumas das dimensões estiverem relacionadas entre si, as dimensões relacionadas poderão dividir a medida sem a presença da dimensão não relacionada. É útil saber se alguma das dimensões está relacionada entre si. (Por exemplo: se uma visualização for feita com dimensões relacionadas Dim1 e Dim2 e uma dimensão DimA que não esteja relacionada a nenhuma delas, uma medida da tabela compartilhada não estará igualmente relacionada a todas as três dimensões. Dim1 e Dim2 não entram em conflito um com o outro, mas ambos entram em conflito com DimA. Para resolver removendo campos, você pode remover apenas DimA ou Dim1 e Dim2.)

Nessa situação, as dimensões são listadas em grupos na mensagem de dica de ferramenta.

A mensagem para a medida compartilhada entre grupos de dimensões não relacionadas é:

- **Em uma divisória**: esta medida só pode ser decomposta por um dos seguintes grupos de dimensões de cada vez: _<bulleted list of dimensions>_
- **No painel Dados**: se usada, esta medida só pode ser decomposta em um dos seguintes grupos de dimensões por vez: _<bulleted list of dimensions>_

A mensagem para cada dimensão é:

- **Em uma divisória**: esta dimensão não pode decompor a medida _<measure>_ em combinação com os seguintes grupos de dimensões: _<bulleted list of dimensions>_
- **No painel Dados**: se usada, grupos de esta dimensão não pode decompor a medida _<measure>_ em combinação com os seguintes grupos de dimensões: _<bulleted list of dimensions>_

## Medida relacionada

Quando uma medida está relacionada a algumas dimensões na visualização, mas não a outras, a medida pode ter uma mensagem adicional na dica de ferramenta que explica a quais dimensões ela está relacionada. Isso pode ajudar a explicar como a medida é agregada. Esta mensagem só aparece quando a medida também não está relacionada a uma dimensão na visualização. Caso contrário, é um comportamento padrão que a medida seja agregada ao nível de detalhe de suas medidas relacionadas.

A mensagem da medida é:

- **Em uma divisória**: esta medida é agregada ao nível de detalhe das dimensões relacionadas: _<dimensions in the viz this measure is related to>_
- **No painel Dados**: se usada, esta medida será agregada ao nível de detalhe das dimensões relacionadas: _<dimensions in the viz this measure is related to>_

Essa mensagem tem como objetivo ajudar a identificar as dimensões que são consideradas quando o valor da medida é calculado. Para obter informações sobre como os valores de medida são calculados e por que a relação das dimensões é importante, consulte [Uma observação sobre como os valores de medida são calculados](#computemeasures).

## Filtros

A relação também é avaliada para campos na divisória de filtros em comparação com campos ativos na visualização.

Um ícone e uma dica de ferramenta aparecem quando um filtro não está relacionado a pelo menos um campo da visualização. O campo de filtro e o campo na visualização têm uma dica de ferramenta.

A mensagem para um filtro é: 

- **Filtro não relacionado**: este filtro não se aplica a campos não relacionados: _<fields>_
- **Filtro ambíguo**: este filtro ignora as seguintes medidas porque está ambiguamente relacionado a elas: _<list of measures>_
- **Filtro ainda não relacionado**: filter ignora os seguintes campos porque ainda não está relacionado a eles: lista de campos: _<list of fields>_

O comportamento dos filtros também depende da sua relação com outros campos na visualização. Um filtro não afeta os valores dos campos aos quais não está relacionado. A menos que o filtro não seja definido como nenhum valor (excluindo tudo ou incluindo nada), a visualização permanecerá inalterada para quaisquer campos que não estejam relacionados ao filtro. No entanto, desmarcar todas as opções do filtro retornará uma visualização em branco.

![Uma visualização com um filtro não relacionado mostrando que desmarcar opções no controle de filtro interativo não afeta a visualização](/tableau/current/pt-br/server/pt-br/Img/mfr_tt_unrelatedfilter.png)

Duas capturas de tela da visualização com um filtro não relacionado, mostrando que desmarcar opções no controle de filtro interativo não afeta a visualização

Os campos relacionados são filtrados conforme esperado. Em uma visualização mais complexa com uma combinação de campos relacionados e não relacionados (como em um contexto de união), o filtro afetará apenas os valores relacionados ao campo de filtro.

## Uma observação sobre como os valores de medida são calculados

Quando uma medida não está relacionada a uma dimensão, ela não pode ser dividida pelos membros dessa dimensão (ou seja, você não pode dividir a duração média da turma por clube quando os clubes não têm duração de turma). Em vez disso, a medida será agregada em um nível diferente dos cabeçalhos do membro da dimensão na exibição.

Terminologia para dimensões e medidas

No quadro, _medidas_ são _agregações_ – elas são agregadas até a _granularidade_ definida pelas _dimensões_ na exibição. O valor de uma medida depende, portanto, do contexto das dimensões. Por exemplo, “número de caixas de cereais” depende se nos referimos ao estoque total ou ao número de caixas por marca.

_Dimensões_ geralmente são campos categóricos, como país ou marca. No Tableau, as dimensões definem a granularidade ou o _nível de detalhe_, da exibição. Normalmente, queremos agrupar nossos dados em marcas por alguma combinação de categorias. As dimensões que usamos para criar a exibição determinam quantas marcas temos.

_Agregação_ refere-se a como os dados estão combinados. A agregação padrão do Tableau é SUM. Você pode alterar a agregação para outras opções, incluindo: média, mediana, contagem distinta, mínimo e assim por diante. _Granularidade_ refere-se ao nível de detalhamento da medida, o que é controlado pelas Relacionado dimensões relacionadas. A menos que a granularidade da medida esteja no nível da linha (também conhecida como desagregada), seu valor deverá ser agregado.

#### Exemplo

![uma tabela de valores para o número de caixas de cereais, em cinco marcas e três tamanhos de caixas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_cereal_rawdata.png)

**Qual é o valor de “número de caixas de cereal?”**

Bem, isso depende do tipo de agregação e da granularidade definida pelas dimensões.

- Agregações:
    - Soma (ou total)
    - Average
- Granularidade:
    - Escopo da tabela/totalmente agregada (as barras azuis no exemplo)
    - Dividido pela dimensão **Marca** (as barras coloridas no exemplo)

![Um painel com quatro visualizações, uma para o número de caixas no escopo da tabela resumida (54), uma com o número médio de caixas no escopo da tabela (6) e, em seguida, versões dessas duas divididas pelas cinco marcas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_cereal.png)

### O valor de uma medida segue os membros da dimensão

O valor de uma medida é determinado pelas dimensões às quais ela está relacionada. Uma medida sem uma dimensão relacionada é delimitada por tabela. Uma medida com uma dimensão relacionada é dividida pelos membros da dimensão relacionada (ou seja, o valor da medida é calculado para cada membro da dimensão). Se os membros de uma dimensão relacionada forem repetidos devido à presença de uma dimensão não relacionada, os valores da medida serão repetidos com base nos membros da dimensão.

1. Uma medida sem uma dimensão é delimitada por uma tabela para o valor geral.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/mfr_measures_tablescoped.png)
2. Uma medida, na presença apenas de uma dimensão não relacionada, tem escopo de tabela e é repetida para os membros da dimensão não relacionada.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/mfr_measures_tablescoped_unrelated.png)
3. Uma medida na presença de uma dimensão relacionada é dividida de forma mais granular e seu valor é calculado por membro da dimensão relacionada.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/mfr_measures_broken_down.png)
4. Uma medida, na presença de uma dimensão não relacionada e uma dimensão relacionada, é dividida pela dimensão à qual está relacionada. Sempre que esses membros de dimensão relacionados forem repetidos para dimensões não relacionadas, o valor da medida será rastreado junto com seu membro de dimensão relacionado.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/mfr_measures_broken_down_and_repeated.png)
    
    Como as mensalidades são por clube, o valor das mensalidades de cada clube é repetido toda vez que o clube é repetido.

<!-- document id=99edb8fbefc959c5c5f5cd6334a77903b2ced0663ae78036411eb6c863e07f80 url=/tableau/current/pt-br/server/entity_wdc.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade de web-data-connector-settings

Esta entidade é usada para gerenciar as configurações do conector de dados da Web (WDC). Para saber mais sobre o uso de WDCs no Tableau Server, consulte [Conectores de dados da Web no Tableau Server](https://help.tableau.com/current/server/pt-br/datasource_wdc.htm) e [tsm data-access](https://help.tableau.com/current/server/pt-br/cli_data-access.htm).

Use o modelo de arquivo de configuração abaixo para criar um arquivo .json. Depois de preencher as opções com os valores correspondentes, passe o arquivo .json e aplique as configurações usando os seguintes comandos:

`tsm settings import -f /path/to/file.json`

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

### Configurações do conector de dados da Web

As configurações do conector de dados da Web (WDC) no modelo abaixo especificam se os WDCs estão habilitados, se a atualização de WDCs está habilitada e as listas seguras principais e secundárias. As listas seguras indicam quais URLs do WDC são aprovadas para uso na instalação do Tableau Server e os domínios ou URLs nos quais um conector pode enviar e receber solicitações.

### Modelo de configuração

Use este modelo para definir as configurações do WDC.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

{
  "configEntities": {
    "web-data-connector-settings": {
      "\_type": "webDataConnectorSettingsType",
      "refreshEnabled": true,
      "whitelist": {
        "https://www.example.com:443/wdc/": {
          "secondaryWhitelist": \[
          "https://www.example.com/.\*",
          "https://www.coolapi.com/.\*"
          \]
        }
      },
      "enabled": true
    }
  }
}

{
  "configEntities": {
    "web-data-connector-settings": {
      "\_type": "webDataConnectorSettingsType",
      "refreshEnabled": true,
      "whitelist": {
        "https://www.example.com:443/wdc/": {
          "secondaryWhitelist": \[
          "https://www.example.com/.\*"
          \]
        },
        "https://www.mysite.com:443/coolwdc/": {
          "secondaryWhitelist": \[
          "https://www.mysite.com/.\*",
          "https://www.coolapi.com/.\*"
          \]
        }
      },
      "enabled": true
    }
  }
}

### Referência do arquivo de configuração

Esta tabela contém todas as opções que podem ser incluídas no conjunto de entidades `web-data-connector-settings`.

\_type

Obrigatório.

Valor: `webDataConnectorSettingsType`

Não altere.

refreshEnabled

Defina como `false` para desabilitar a atualização de WDCs. O padrão é `true`.

lista autorizada

Obrigatório.

Pode conter um ou mais conjuntos de correspondência de listas seguras e listas seguras secundárias (um conjunto por WDC). A primeira URL fornecida é a lista segura, é nela que você especifica a URL e a porta do WDC, formatados da seguinte maneira:

`<scheme>://<host>:<port>/<path>`

Para muitos WDCs, o valor `<port>` é 443, que é a porta padrão para HTTPS, mas é possível verificar o valor para o seu conector ao analisar os detalhes da fonte de dados no Tableau Server ou no Tableau Cloud.

secondaryWhitelist

Obrigatório.

Especifica os domínios ou URLs aos quais um conector pode enviar solicitações e receber solicitações de, por exemplo, bibliotecas JavaScript externas, REST APIs ou arquivos locais. Para adicionar um domínio inteiro a esta lista de segurança secundária, você pode usar uma expressão curinga `.*` no final da URL, como mostrado no exemplo a seguir:

`https://www.example.com/.*`  

enabled

Defina como `false` para desabilitar o uso de WDCs. O padrão é `true`.

<!-- document id=95145298c05d8dfa09a17d070e89411afc0964fa07ca6002d55807bb06133932 url=/tableau/current/pt-br/server/entity_gateway.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade gatewaySettings

É necessário definir as configurações de gateway do computador do Tableau Server.

Use o modelo de arquivo de configuração abaixo para criar um arquivo json. Depois de preencher as opções com os valores adequados, passe o arquivo json e aplique as configurações com os seguintes comandos:

`tsm settings import -f /path/to/file.json`

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

### Configurações do gateway

As configurações do gateway no modelo abaixo especificam as definições HTTP do Tableau Server. Recomendamos usar o SSL/TLS. O Tableau Server é inserido no código para usar a porta 443 do SSL/TLS. Portanto, se o SSL for habilitado, não é necessário atualizar a entidade gatewaySettings.

### Modelo de configuração

Use este modelo para definir as configurações do gateway.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

{
  "configEntities": {
	 "gatewaySettings": {
	  "\_type": "gatewaySettingsType",
	   "port": 80,
	   "sslRedirectEnabled": true,
	   "publicHost": "localhost"
	 }
	}			
 }

### Referência do arquivo de configuração

Esta tabela contém todas as opções que podem ser incluídas no conjunto de entidades `"gatewaySettings"`.

\_type

Obrigatório.

Valor: `"gatewaySettingsType"`

Não altere.

port

Especifica a porta HTTP. A porta 80 é a Padrão.

sslRedirectEnabled

Opções: `true` ou `false`.

publicHost

Especifica o nome de host do serviço http/s.

trustedIPs

Especifica endereços IP confiáveis que se comunicam com o Tableau Server. Os endereços IP confiáveis incluem servidores proxy de upstream e servidores que são usados para autenticação confiável no Server. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm) e [Adicionar endereços IP confiáveis ou nomes de host ao Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_trustIP.htm).

Se estiver executando o Tableau Server em um cluster, todos os outros nós do cluster serão incluídos automaticamente no arquivo de configuração correspondente que esta entidade atualiza. Sendo assim, se especificar um novo valor para `trustedIPs`, inclua os endereços IP dos outros nós no valor.

Essa opção tem uma lista de cadeias de caracteres, o que requer passar cada IP ou host entre aspas, separados por uma vírgula (sem espaço) e entre colchetes. Por exemplo: `["192.168.1.101","192.168.1.102","192.168.1.103"]` ou `["webserv1","webserv2","webserv3"]`.

trustedHosts

Especifica endereços IP confiáveis que se comunicam com o Tableau Server. Normalmente este valor contém uma lista de servidor proxy de upstream. Os valores no trustedHosts são usados para determinar os objetivos de solicitação do cliente.

Se estiver executando o Tableau Server em um cluster, todos os outros nós do cluster serão incluídos automaticamente no arquivo de configuração correspondente que esta entidade atualiza. Sendo assim, se especificar um novo valor para `trustedIPs`, inclua os endereços IP dos outros nós no valor.

Essa opção tem uma lista de cadeias de caracteres, o que requer passar cada IP ou host entre aspas, separados por uma vírgula (sem espaço) e entre colchetes. Por exemplo: `["192.168.1.101","192.168.1.102","192.168.1.103"]` ou `["webserv1","webserv2","webserv3"]`.

<!-- document id=5e7aab775d9ea0f85e0975567e29419201280eddf87e44d723fa216d45f028ae url=/tableau/current/pt-br/server/entity_identity_store.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade identityStore

O Tableau Server exige um repositório de identidades para guardar informações de usuário e de grupo. Consulte os tópicos [Autenticação](https://help.tableau.com/current/server/pt-br/security_auth.htm) e [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm) antes de configurar o repositório de identidades pela primeira vez. Após instalar o armazenamento de identidades no Tableau Server, não é possível alterá-lo sem reinstalar o servidor.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

## Antes de começar

Consulte as informações a seguir:

- Se não for utilizar o repositório de identidades local, usará alguma versão do LDAP. Nesse caso, trabalhe com o administrador de diretório/LDAP para configurar o Tableau Server para os requisitos do esquema LDAP e de associação.
- A Configuração do Tableau Server está otimizada para o Active Directory. Se você estiver instalando no Active Directory, recomendamos configurar o repositório de identidades com a [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm#tsm-ui-steps).
- A associação ao LDAP não depende de autenticação do usuário. Por exemplo, é possível configurar o Tableau Server para usar a associação simples para autenticar o diretório LDAP e, em seguida, configurar o Tableau Server para autenticar usuários com o Kerberos após a instalação.
- Não se conecte ao LDAP com uma associação simples por meio de uma conexão não protegida. Por padrão, o LDAP com associação simples envia dados em cleartext. Use o LDAPS para criptografar o tráfego com uma associação simples. Consulte [Configurar canal criptografado no armazenamento de identidade externo LDAP](https://help.tableau.com/current/server/pt-br/config_encrypt_ldap.htm).
- Para usar a autenticação do Kerberos para associação ao LDAP com o serviço do Tableau Server, precisará de um arquivo keytab para associação GSSAPI, conforme descrito nas seções a seguir. Consulte também [Saiba mais sobre os requisitos do Keytab.](https://help.tableau.com/current/server/pt-br/kerberos_keytab.htm). No contexto do Kerberos, a associação GSSAPI é tudo que precisa durante a instalação básica do Tableau Server. Após você instalar o servidor, é possível [configurar o Kerberos para autenticação do usuário](https://help.tableau.com/current/server/pt-br/config_kerberos.htm) e [delegação do Kerberos para fonte de dados](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm).
- Neste tópico, fazemos a distinção entre _LDAP_ (o protocolo da conexão com serviços do diretório) e um _servidor LDAP_ (uma implementação de um serviço de diretório). Por exemplo, o `slapd` é um servidor LDAP que é parte de um projeto do OpenLDAP.
- Valide a configuração LDAP antes de inicializar o servidor, consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).
- Importar arquivos de configuração JSON apenas como parte da configuração inicial. Se precisar fazer alterações LDAP depois de importar o arquivo de configuração JSON e o Tableau Server inicializado, não tente importar novamente o arquivo JSON. Em vez disso, faça mudanças individuais de chaves com comandos nativos tsm ou com `tsm configuration set`. Consulte [Referência de configuração do armazenamento de identidades externo](https://help.tableau.com/current/server/pt-br/ldap_config.htm).

## Modelos de configuração

Os modelos JSON nesta seção são usados para configurar o Tableau Server com diferentes cenários de repositório de identidades. A menos que esteja configurando um repositório de identidades local, precisará selecionar e editar um modelo de arquivo de configuração específico para o ambiente LDAP.

Considere usar a [Ferramenta de configuração do repositório de identidades do Tableau](https://tagyoureit.github.io/tableau-identitystore-config-tool/) para gerar o arquivo de configuração LDAP JSON. A ferramenta em si não é compatível com o Tableau. Contudo, usar um arquivo JSON criado pela ferramenta em vez de criar um arquivo manualmente não altera o status compatível do seu servidor.

Selecione um modelo de armazenamento de identidades para editar:

- Local
- LDAP - Active Directory
- OpenLDAP - Associação GSSAPI
- OpenLDAP - Associação simples

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

### Local

Se sua empresa ainda não possui um Active Directory ou servidor LDAP para autenticação de usuário, configure o local como o tipo de armazenamento de identidades. Ao selecionar local, você usa o Tableau Server para criar e gerenciar usuários.

Uma maneira alternativa de configurar o Tableau Server para o repositório de identidades local é executar a GUI de configuração e selecionar "Local" durante o processo de instalação. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

{
  "configEntities": {
    "identityStore": {
       "\_type": "identityStoreType",
       "type": "local"
     }
   }
}			
		

![](/tableau/current/pt-br/server/pt-br/Img/Road-sign-alert.png)

### Importante

Os modelos de configuração LDAP abaixo são exemplos. Os modelos, conforme apresentados, não configurarão a conectividade LDAP na sua organização. Você deve trabalhar com o administrador do diretório para editar os valores de modelo do LDAP para obter uma implantação bem-sucedida.  
  
Além disso, todos os arquivos referenciados em configEntities devem estar no computador local. Não especifique caminhos UNC.

### LDAP - Active Directory

A Configuração do Tableau Server está otimizada para o Active Directory. Se você estiver instalando no Active Directory, configure o repositório de identidades com a [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm#tsm-ui-steps).

É necessária uma conexão criptografada com o Active Directory. Consulte [Configurar canal criptografado no armazenamento de identidade externo LDAP](https://help.tableau.com/current/server/pt-br/config_encrypt_ldap.htm).

Se, por algum motivo, você não conseguir configurar o repositório de identidades para se comunicar com o Active Directory com a interface na Web do TSM, use esse modelo JSON para configurar o Tableau Server para se conectar ao Active Directory. Esse modelo usa a associação GSSAPI (Kerberos) para autenticar o serviço do Tableau Server para o Active Directory. O Tableau Server inclui suporte para o esquema do Active Directory. Sendo assim, se você definir a opção `"directoryServiceType"` como `"activedirectory"`, não será necessário fornecer as informações de esquema na opção `"identityStoreSchemaType"`.

{
  "configEntities":{
    "identityStore": {
		"\_type": "identityStoreType",
		"type": "activedirectory",
		"domain": "your-domain.lan",
		"nickname": "YOUR-DOMAIN-NICKNAME",
		"directoryServiceType": "activedirectory",
		"bind": "gssapi",
		"kerberosKeytab": "<path to local key tab file>",
		"kerberosConfig": "/etc/krb5.conf",
		"kerberosPrincipal": "your-principal@YOUR.DOMAIN"
		}
	}
}			

Recomendamos a associação ao Active Directory com o GSSAPI. Contudo, é possível conectar usando associação simples e LDAPS. Para conectar com associação simples, altere `bind` para `simple`, remova as três entidades do Kerberos e adicione as opções `port`/`sslPort`, `username` e `password`. Os exemplos a seguir mostram o Active Directory com json de associação simples.

{
  "configEntities":{
	"identityStore": {
		"\_type": "identityStoreType",
		"type": "activedirectory",
		"domain": "your-domain.lan",
		"nickname": "YOUR-DOMAIN-NICKNAME",
		"directoryServiceType": "activedirectory",
		"hostname": "optional-ldap-server", 
		"sslPort": "636",
		"bind": "simple",
		"username": "username",
		"password": "password"	
		}
	}
}			
		

### OpenLDAP - Associação GSSAPI

Use o modelo abaixo para configurar o OpenLDAP com a associação GSSAPI. Não use esse modelo se sua empresa estiver executando o Active Directory. Se estiver instalando no Active Directory, use o modelo acima, LDAP - Active Directory.

Na maioria dos casos, as empresas que usam o OpenLDAP com GSSAPI (Kerberos) usarão um arquivo keytab para armazenar credenciais. No exemplo a seguir, um arquivo keytab é usado para as credenciais de autenticação.

Contudo, é possível fornecer as credenciais por meio das entidades `username` e `password`.

Além disso, é possível especificar um keytab, um par de nome de usuário e senha. Nesse caso, o Tableau Server tentará usar o keytab, mas se a autenticação falhar por alguma razão, ele fará o fallback e usará as credenciais de nome de usuário e senha.

{
  "configEntities":{
		"identityStore": {
			"\_type": "identityStoreType",
			"type": "activedirectory",
			"domain": "your-domain.lan",
			"nickname": "YOUR-DOMAIN-NICKNAME",
			"directoryServiceType": "openldap",
			"bind": "gssapi",
			"kerberosKeytab": "<path to local key tab file>",
			"kerberosConfig": "/etc/krb5.conf",
			"kerberosPrincipal": "your-principal@YOUR.DOMAIN",
			"identityStoreSchemaType": {
			   "userBaseFilter": "(objectClass=inetOrgPerson)",
			   "userUsername": "user",
			   "userDisplayName": "displayname",
			   "userEmail": "email",
			   "userCertificate": "certificate",
			   "userThumbnail": "thumbnail",
			   "userJpegPhoto": "photo",
			   "groupBaseFilter": "(objectClass=groupofNames)",
			   "groupName": "groupname",
			   "groupEmail": "groupemail",
			   "groupDescription": "groupdescription",
			   "member": "member",
			   "distinguishedNameAttribute": "",
			   "serverSideSorting": "",
			   "rangeRetrieval": "",
			   "userClassNames": \["inetOrgPerson","someClass2"\],
			   "groupClassNames": \["groupOfUniqueNames1","groupOfUniqueNames2"\]
			   }
		   }			
	  }			
}
		

### OpenLDAP - Associação simples

{
  "configEntities":{
		"identityStore": {
			"\_type": "identityStoreType",
			"type": "activedirectory",
			"domain": "my.root",
			"nickname": "",
			"hostname": "optional-ldap-server",
			"port": "389",
			"directoryServiceType": "openldap",
			"bind": "simple",
			"username": "cn=username,dc=your,dc=domain",
			"password": "password",
			"identityStoreSchemaType": {
			   "userBaseFilter": "(objectClass=inetOrgPerson)",
			   "userUsername": "user",
			   "userDisplayName": "displayname",
			   "userEmail": "email",
			   "userCertificate": "certificate",
			   "userThumbnail": "thumbnail",
			   "userJpegPhoto": "photo",
			   "groupBaseFilter": "(objectClass=groupofNames)",
			   "groupName": "groupname",
			   "groupEmail": "groupemail",
			   "groupDescription": "groupdescription",
			   "member": "member",
			   "distinguishedNameAttribute": "",
			   "serverSideSorting": "",
			   "rangeRetrieval": "",
			   "userClassNames": \["inetOrgPerson","someClass2"\],
			   "groupClassNames": \["groupOfUniqueNames1","groupOfUniqueNames2"\]
			   }
		 }
  }
}			
		

## Referência do modelo de configuração

### Opções de armazenamento de identidades compartilhado

type

Onde deseja armazenar as informações da identidade do usuário. Pode ser `local` ou `activedirectory`. (Caso deseje se conectar a qualquer servidor do LDAP, selecione `activedirectory`.)

domain

O domínio do computador no qual o Tableau Server foi instalado.

nickname

O apelido do domínio. Também é chamado de nome NetBIOS nos ambientes do Windows.

A opção `nickname` é necessária para todas as entidades LDAP. Se sua organização não exigir um apelido /NetBIOS, envie uma chave em branco, por exemplo: `"nickname": ""`.

### Opções de associação GSSAPI LDAP

directoryservicetype

O tipo de serviço de diretório ao qual você deseja se conectar. Pode ser `activedirectory` ou `openldap`.

kerberosConfig

O caminho para o arquivo de configuração do Kerberos no computador local. Se você estiver instalando o Active Directory, não recomendamos usar o arquivo de configuração do Kerberos ou o arquivo keytab existente que já possa estar no PC unido pelo domínio. Consulte [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm).

kerberosKeytab

O caminho para o arquivo keytab do Kerberos no computador local. É recomendado criar um arquivo keytab com chaves especificas ao serviço do Tableau Server e que você não compartilhe o arquivo keytab com outros aplicativos do computador.

kerberosPrincipal

O nome principal do servidor do Tableau Server na máquina do host. O keytab deve ter permissões para este principal. Não utilize um keytab existente do sistema. Em vez disso, recomendamos que você registre um novo nome principal do servidor. Para ver os principais em um determinado keytab, execute o comando `klist -k`. Consulte [Saiba mais sobre os requisitos do Keytab.](https://help.tableau.com/current/server/pt-br/kerberos_keytab.htm).

### Opções de associações simples do LDAP

directoryservicetype

O tipo de serviço de diretório ao qual você deseja se conectar. Pode ser `activedirectory` ou `openldap`.

hostname

O nome de host do servidor LDAP. Você pode inserir um nome de host ou endereço IP para este valor. O host especificado aqui será usado apenas para consultas de usuário/grupo no domínio primário. Se as consultas de usuário/grupo estiverem em outros domínios (não no domínio primário), o Tableau Server não usará esse valor, mas, em vez disso, consultará o DNS para identificar o controlador de domínio apropriado.

port

Use esta opção para especificar a porta não segura do servidor LDAP. O plaintext normalmente é 389.

sslPort

Use esta opção para ativar o LDAPS. Especifique a porta segura do servidor LDAP. A porta do LDAPS normalmente é a 636. Para usar o LDAPS, você também deve especificar a opção hostname. Consulte [Configurar canal criptografado no armazenamento de identidade externo LDAP](https://help.tableau.com/current/server/pt-br/config_encrypt_ldap.htm).

username

O nome de usuário que deseja usar para se conectar ao serviço do diretório. A conta especificada deve ter permissão para consultar o serviço do diretório. Para o Active Directory, insira o nome de usuário, por exemplo, `jsmith`. Para servidores LDAP, insira o nome diferenciado (DN) do usuário que deseja usar para se conectar. Por exemplo, você pode inserir `cn=username,dc=your-local-domain,dc=lan`.

password

A senha do usuário que deseja usar para se conectar ao servidor LDAP.

### Opções de LDAP compartilhado

As opções a seguir podem ser definidas para implementações de LDAP genérico, OpenLDAP ou do Active Directory.

bind

O modo pelo qual você deseja autenticar a comunicação do serviço do Tableau Server ao serviço de diretório do LDAP. Insira `gssapi` para GSSAPI (Kerberos).

domain

Em ambientes do Active Directory, especifique o domínio em que o Tableau Server está instalado, por exemplo, "example.lan".

Para LDAP sem AD: a cadeia de caracteres desse valor é exibida na coluna "Domínio" das ferramentas de gerenciamento de usuários. Você pode inserir uma cadeia de caracteres arbitrária, mas a chave não pode ficar em branco.

root

Somente LDAP. Não especifique para Active Directory.

Se você não usar um componente dc na raiz do LDAP ou se quiser especificar uma raiz mais complexa, será necessário definir a raiz do LDAP. Use o formato "o=my,u=root". Por exemplo, para o domínio, `example.lan`, a raiz seria `"o=example,u=lan"`.

membersRetrievalPageSize

Esta opção determina o número máximo de resultados retornados por uma consulta LDAP.

Por exemplo, considere um cenário em que o Tableau Server está importando um grupo LDAP que contém 50.000 usuários. Tentar importar um número de usuários tão grande em uma única operação não é uma prática recomendada Quando essa opção estiver definida como 1500, o Tableau Server importará os primeiros 1500 usuários na primeira resposta. Depois que esses usuários forem processados, o Tableau Server solicitará os próximos 1500 usuários do servidor LDAP e assim por diante.

Recomendamos modificar essa opção apenas para acomodar os requisitos do servidor LDAP

### Opções do `identityStoreSchemaType`

Se configurar uma conexão LDAP com um servidor LDAP, é possível inserir informações de esquema específicas do servidor LDAP no objeto `identityStoreSchemaType`.

**Importante**: se estiver se conectando ao Active Directory (`"directoryServiceType": "activedirectory"`), não configure estas opções.

userBaseFilter

O filtro que deseja usar para os usuários do Tableau Server. Por exemplo, é possível especificar um atributo de classe do objeto e um atributo de unidade organizacional.

userUsername

O atributo que corresponde aos nomes de usuário no servidor LDAP.

userDisplayName

O atributo que corresponde aos nomes de exibição do usuário no servidor LDAP.

userEmail

O atributo que corresponde aos endereços de e-mail do usuário no servidor LDAP.

userCertificate

O atributo que corresponde aos certificados de usuário no servidor LDAP.

userThumbnail

O atributo que corresponde às imagens em miniatura do usuário no servidor LDAP.

userJpegPhoto

O atributo que corresponde às imagens de perfil do usuário no servidor LDAP.

groupBaseFilter

O filtro que deseja usar para os grupos de usuários do Tableau Server. Por exemplo, é possível especificar um atributo de classe do objeto e um atributo de unidade organizacional.

groupName

O atributo que corresponde aos nomes de grupo no servidor LDAP.

groupEmail

O atributo que corresponde aos endereços de e-mail do grupo no servidor LDAP.

groupDescription

O atributo que corresponde às descrições de grupo no servidor LDAP.

member

O atributo que descreve a lista de usuários em um grupo.

distinguishedNameAttribute

O atributo que armazena os nomes diferenciados de usuários. Este atributo é opcional, mas aprimora o desempenho das consultas do LDAP.

serverSideSorting

Se o servidor LDAP está configurado para classificação do lado do cliente dos resultados de consultas. Se o servidor LDAP for compatível com a classificação do lado do servidor, defina essa opção como `true`. Caso não tenha certeza de que seu servidor LDAP suporta essa classificação, insira `false`, pois uma configuração incorreta pode causar erros.

rangeRetrieval

Se o servidor LDAP está configurado para retornar um intervalo de resultados de consulta de uma solicitação. Isso significa que os grupos com muitos usuários serão solicitados em conjuntos pequenos, em vez de todos de uma vez. Os servidores LDAP que suportam uma recuperação abrangente terão melhor desempenho para consultas grandes. Se o servidor LDAP for compatível com a recuperação de intervalo, defina essa opção como `true`. Caso não tenha certeza de que seu servidor LDAP suporta a recuperação de intervalo, insira `false`, pois uma configuração incorreta pode causar erros.

groupClassNames

Por padrão, o Tableau Server pesquisa por classe de objeto do grupo LDAP que contenham a cadeia de caracteres “group”. Se os objetos do grupo LDAP não correspondem com o nome de classe padrão, substitua o padrão configurando este valor. É possível fornecer vários nomes de classe separados por vírgulas. Essa opção tem uma lista de cadeias de caracteres, o que requer passar cada classe entre aspas, separados por uma vírgula (sem espaço) e entre colchetes. Por exemplo: `["basegroup","othergroup"]`.

userClassNames

Por padrão, o Tableau Server pesquisa por classes de objeto do usuário LDAP que contenham a cadeia de caracteres “user” e “inetOrgPerson”. Se os objetos do usuário LDAP não usarem estes nomes de classe padrão, substitua o padrão configurando este valor. É possível fornecer vários nomes de classe separados por vírgulas. Essa opção tem uma lista de cadeias de caracteres, o que requer passar cada classe entre aspas, separados por uma vírgula (sem espaço) e entre colchetes. Por exemplo: `["userclass1",userclass2”]`.

## Importar o arquivo JSON

Depois de editar o arquivo JSON, passe o arquivo e aplique as configurações usando os seguintes comandos:

`tsm settings import -f path-to-file.json`

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

<!-- document id=54977cce24f96559f815caca25df13e1bb0af0a0ad4cef36a2bf79acac509300 url=/tableau/current/pt-br/server/entity_kerberos.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade kerberosSettings

Antes de configurar a autenticação do Kerberos, revise [Requisitos do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_requ.htm).

Use o modelo de arquivo de configuração abaixo para criar um arquivo json. Depois de preencher as opções com os valores adequados, passe o arquivo json e aplique as configurações com os seguintes comandos:

`tsm settings import -f /path/to/file.json`

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

## Modelo de configuração

Use esse modelo para configurar as definições do Kerberos.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

Após finalizar a configuração inicial da autenticação do Kerberos, use a subcategoria [tsm authentication kerberos <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMKerb) para definir valores adicionais.

{
  "configEntities": {
	"kerberosSettings": {
		"\_type": "kerberosSettingsType",
		"enabled": "true",
		"keytabFile": "/path/to/keytab\_file"
        }
     }			
 }

## Referência do arquivo de configuração

A lista a seguir inclui todas as opções que podem ser incluídas com o conjunto de entidades `"kerberosSettings"`.

Opção

Valor

enabled

Opções: `true` ou `false`.

Habilita a autenticação do Kerberos.

keytabFile

Obrigatório.

Caminho para um arquivo keytab válido do Kerberos.

dBClasses

Lista separada por vírgulas de classes de banco de dados para credenciais globais. Pode ser exigida para conexões com fontes de dados Cloudera.

<!-- document id=940aafe0887320fc55c7f133363a0b1de2ac9aa9fe642f653c15b161477c8e82 url=/tableau/current/pt-br/server/entity_mutual_ssl.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade mutualSSLSettings

Antes de configurar SSL mútuo, consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm).

A entidade `mutualSSLSettings` combina as configurações de SSL e de SSL mútuo. Para SSL mútuo, é necessário que o SSL externo tenha sido habilitado e configurado corretamente.

As entidades TSM usam JSON e pares de chave-valor. Use o modelo de arquivo de configuração abaixo para criar um arquivo .json. Forneça valores das chaves adequadas pra seu ambiente, em seguida transmita o arquivo .json para o Tableau Server com os comandos a seguir:

`tsm settings import -f <path-to-file.json>`

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

## Modelo de configuração

Use este modelo para configurar o SSL mútuo.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

{
  "configEntities": {
    "mutualSSLSettings": {
        "\_type": "mutualSSLSettingsType",
        "sslEnabled": true,
        "proxyLogin": false,
        "clientCertRequired": true,
        "caCertFile": "required",
        "keyFileName": "required",
        "keyPassphrase": "",
        "chainFile": "",
        "revocationFile": "",
        "redirect": false,
        "fallbackToPassword": true,
        "protocols": "",
        "cipherSuite": "",
        "forceHttpsForPublicEmbed": false
    }
  }
}

## Referência do arquivo de configuração

sslEnabled

Habilitar SSL. Este é um pré-requisito da habilitação do SSL mútuo.

clientCertRequired (MutualSSL)

Definido como true para habilitar a autenticação por SSL mútuo. Definido como false para desabilitar.

caCertFile (MutualSSL)

Obrigatório.

Especificar o arquivo de certificado emitido pela Autoridade de certificação para SSL bidirecional. O caminho do arquivo deve ser legível pelo Tableau Server.

certFileName

Especificar o arquivo que contém a concatenação de certificados PEM codificados pela CA que formam a cadeia de certificados para o certificado do servidor.

Como alternativa, o arquivo de referência pode ser o mesmo que caCertFile quando os certificados da CA são anexados diretamente ao certificado do servidor para conveniência.

keyFileName

Se a chave não estiver combinada com o certificado, use essa chave de configuração para apontar para o arquivo de chave. Caso você tenha tanto uma chave privada RSA quanto uma DSA, é possível fazer a configuração de maneira paralela (por exemplo, para permitir o uso de cifras DSA).

keyPassphrase

Opcional. Frase de segurança do arquivo de certificado. A frase de segurança inserida será criptografada em períodos de inatividade.

**Observação:** se você criar um arquivo de chave de certificado com uma frase de segurança, não será possível reutilizar a chave de certificado SSL para SAML.

revocationFile

Especifica o caminho do arquivo para um arquivo de Certificate Revocation List (.crl) da CA do SSL.

Redirect

Padrão: true. Especifica se o Tableau Server deve redirecionar solicitações http como https para o endpoint correspondente.

clientCertMapping (MutualSSL)

Especifica o método para recuperar o nome de usuário do certificado.

Valores aceitos: `ldap`, `upn`, `cn`

- Para um servidor usando autenticação local, a definição padrão é `upn`(Nome principal de usuário).
- Quando a autenticação do Tableau Server está configurada para o Active Directory (AD) o padrão é `ldap` (Protocolo de acesso aos diretórios leves). Isso comanda o servidor a acessar o AD para validar o usuário, e ignora os nomes no certificado.

É possível definir `cn` para que qualquer um dos dois tipos de autenticação usem CN no Nome de exibição do assunto no certificação.

Para obter mais informações, consulte [Mapeamento de um certificado de cliente para um usuário durante a autenticação mútua](https://help.tableau.com/current/server/pt-br/ssl_mutual_mapping_username.htm).

fallbackToPassword (MutualSSL)

Defina como true para fornecer a usuários a opção de fazer logon no Tableau Server usando nome de usuário e senha em caso de falha da autenticação por SSL mútuo. Defina como false para remover essa opção de fallback.

protocols

Liste as versões do protocolo de Segurança de camada de transporte (TLS) que deseja permitir ou cancelar a permissão.

Valor padrão: `"all -SSLv2 -SSLv3"`

Entretanto, recomendamos que você use a seguinte configuração:

`"all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1"`

Para obter mais informações, consulte [tsm security external-ssl enable](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#external-ssl-enable). Para obter mais informações, consulte a documentação online da Apache.

cipherSuite

Liste criptografias que serão autorizadas ou recusadas para SSL.

Valor padrão: `"HIGH:MEDIUM:!aNULL:!MD5:!RC4:!3DES:!CAMELLIA:!IDEA:!SEED"`

Consulte a página do [Criptografias de OpenSSL](https://www.openssl.org/docs/man1.0.2/man1/ciphers.html) para obter o formato de lista de codificação. Tenha cuidado ao alterar esta opção. Os valores padrão não permite criptografias que não são mais consideradas suficientemente seguras.

proxyLogin

Padrão: false. Indica que o Tableau Server usa um proxy para o SSL somente no momento de logon. Controla o protocolo que o servidor reporta para o Tableau Desktop referente a APIs de logon.

forceHTTPForPublicEmbed

Valor padrão: false. Força o uso de SSL pelo código de exibições inseridas.

<!-- document id=f275e4ce64f946fe135b12f65e4d66ba3c75ed9da6af648beeaf09709b0dd8ac url=/tableau/current/pt-br/server/entity_openid.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade openIDSettings

Antes de configurar a autenticação do OpenID, consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm).

Use o modelo de arquivo de configuração abaixo para criar um arquivo json. Depois de preencher as opções com os valores adequados, passe o arquivo json e aplique as configurações com os seguintes comandos:

`tsm settings import -f path-to-file.json`

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

## Modelo de configuração

Use este modelo para definir configurações do OpenID.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

Depois de concluir a configuração inicial do OIDC, use a subcategoria [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC) para definir mais valores.

{
	"configEntities": {
	    "openIDSettings": {
		"\_type": "openIDSettingsType",
		"enabled": true,
		"clientId": "required",
		"clientSecret": "required",
		"configURL": "required if staticFile value is not set",
		"staticFile": "required if configURL value is not set",
		"externalURL": "required"
		}
	  }
}		

## Referência do arquivo de configuração

A lista a seguir inclui todas as opções que podem ser incluídas com o conjunto de entidades `"openIDSettings"`.

\_type

Obrigatório.

Não altere.

enabled

Obrigatório.

Defina como `true`.

clientId

Obrigatório.

Especifica a ID do cliente do provedor que o IdP designou para o aplicativo. Por exemplo, `“laakjwdlnaoiloadjkwha"`.

clientSecret

Obrigatório.

Especifica o segredo do cliente do provedor. Este é um token usado pelo Tableau para verificar a autenticidade da resposta do IdP. Este valor é um segredo e deve ser mantido em segurança.

Por exemplo, `“fwahfkjaw72123="`.

configURL

Obrigatório.

Especifica a URL de configuração do provedor. Se você não especificar uma URL de configuração, exclua essa opção e defina um caminho e nome de arquivo para o `staticFile`.

staticFile

Obrigatório.

Especifica o caminho local para o documento JSON de descoberta OIDC estático. Se você não especificar um arquivo estático, exclua essa opção e especifique uma url para o `configURL`.

externalURL

Obrigatório.

A URL do servidor. Ela é normalmente o nome público do seu servidor, como `http://example.tableau.com`.

connectionTimeout

Opcional.

Especifica a extensão do limite de tempo da conexão em segundos. O padrão é `10`.

readTimeout

Opcional.

Especifica a extensão do limite de tempo de leitura em segundos. O padrão é `30`.

ignoreDomain

Defina isso como `true`, se o seguinte for verdadeiro:

- Você está usando endereços de e-mail como nomes de usuário no Tableau Server
- Você forneceu aos usuários no IdP vários nomes de domínio
- Você quer ignorar a parte de nome de domínio da recuperação `email` no IdP

Antes de prosseguir, revise os nomes de usuário que serão usados como um resultado da configuração desta opção como `true`. Podem ocorrer conflitos do nome de usuário. Em caso de conflito de nome de usuário, o risco de divulgação de informações é alto. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm).

ignoreJWK

Defina como `true` se o seu IdP não oferecer suporte à validação JWK. Neste caso, recomendamos autenticar a comunicação com o seu IdP usando TLS mútuo ou outro protocolo de segurança da camada de rede. O padrão é `false`.

customScope

Especifica um valor de escopo personalizado relacionado ao usuário que pode ser usado para consultar o IdP. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm).

idClaim

Altere este valor se o seu IdP não usar a recuperação `sub` para identificar exclusivamente os usuários do token ID. A recuperação IdP especificada deve conter uma única e exclusiva cadeia de caracteres.

usernameClaim

Altere este valor para a recuperação IdP que a sua empresa usará para corresponder nomes de usuários, conforme armazenado no Tableau Server.

clientAuthentication

Especifica o método de autenticação de cliente personalizado para OpenID Connect.

Para configurar o Tableau Server para usar o Salesforce IdP, defina esse valor como `client_secret_post`.

iFramedIDPEnabled

Defina como `true` para permitir que o IdP seja exibido em um iFrame. O IdP deve desabilitar a proteção contra roubo de cliques para permitir a apresentação do iFrame.

<!-- document id=d14775adb6d34a7ccb80f6a1aded02817f2197e9b7bfee0ceb17f0bdf51b7302 url=/tableau/current/pt-br/server/entity_saml.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade samlSettings

Este artigo contém um modelo e materiais de referência para a configuração de SAML para todo o servidor no Tableau Server, que é feita por meio de um arquivo de configuração com chaves e valores para a entidade `samlSettings`. Essas informações complementam as etapas de configuração SAML em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).

Para criar um modelo de configuração de SAML e aplicá-lo ao Tableau Server, conclua estas etapas:

1. Leia com atenção as duas seguintes seções que descrevem o modelo e sua estrutura ([Definições e categorias de modelos](#value-categories) e [Modelo de configuração samlSettings](#saml-config-template)).
2. Cole o código JSON contido no modelo em um novo arquivo de texto e salve-o usando a extensão .json.
3. Use a [Referência de entidade de configuração de SAML](#saml-config-entity-reference) para obter ajuda sobre como fornecer valores quando for necessário.
4. Adicione pares de chave/valor opcionais específicos ao seu ambiente. Por exemplo, se seu arquivo de chave do certificado SAML solicitar uma frase secreta, será necessário especificar a frase secreta no parâmetro `wgserver.saml.key.passphrase` usando o comando [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet).
5. [Passar o arquivo de configuração para o Tableau Server](#apply-config-template).

## Definições e categorias de modelos

O modelo usa placeholders para cada valor de chave. Esses placeholders são categorizados da seguinte maneira:

- **Obrigatório:** atributos com o valor `"required"` devem ser substituídos pelos dados válidos, antes que o comando de configuração seja executado. Consulte a referência do arquivo de configuração para obter valores válidos.
- **Inserido no código:** nomes de atributos com um sublinhado (\_) como prefixo, por exemplo `"_type"` têm valores inseridos no código. Não altere esses valores.
- **Valores padrão:** atributos que são definidos para um valor que não é `"required"` são valores padrão. Eles são atributos exigidos que você pode alterar de acordo com o que for adequado para o seu ambiente.
- **Conjuntos vazios:** valores vazios (`""`) podem ser passados como estão, ou você pode oferecer um valor para a sua instalação.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

## Modelo de configuração samlSettings

Cole este código em um arquivo de texto e faça as alterações relevantes para seu ambiente, usando a referência abaixo.

{
  "configEntities": {
    "samlSettings": {
      "\_type": "samlSettingsType",
      "enabled": true,
      "returnUrl": "required",
      "entityId": "required",
      "certFile": "required",
      "keyFile": "required",
      "idpMetadataFile": "required",
      "idpDomainAttribute": "",
      "idpUsernameAttribute": "required"
    }
  }
}

## Referência de entidade de configuração de SAML

A lista a seguir inclui todas as opções que podem ser incluídas com o conjunto de entidades `"samlSettings"`.

idpMetadataFile

Obrigatório. O caminho e o nome do arquivo para o arquivo XML gerado pelo IdP. Os metadados de XML devem incluir o atributo do nome do usuário (asserção).

Se as etapas descritas em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm) foram seguidas, o valor a ser inserido aqui será:

`"C:\ProgramData\Tableau\Tableau Server\data\saml\<metadata-file.xml>"`

enabled

true | false

Obrigatório. Indica se a autenticação SAML está ativada. Não defina esta opção para `true` antes de definir outras opções de configuração SAML necessárias.

returnURL

A URL que os usuários do Tableau Server digitam no navegador para acessar o servidor, como `https://tableau_server.example.com`. Esse valor é usado para criar o atributo URL ACS ao configurar o IdP.

entityId

Obrigatório. O valor da ID da entidade do provedor de serviços (neste caso, Tableau Server).

Identifica a configuração do Tableau Server para o IdP. Recomendamos que você digite o mesmo valor da opção `returnURL`.

idpUsernameAttribute

Obrigatório. Nos metadados do IdP, encontre o atributo usado para especificar os valores de nome de usuário e insira o nome desse atributo. O padrão é `username`.

certFile

Obrigatório. Digite o local e o nome do arquivo de certificado x509 (.crt) para SAML. Por exemplo:

`"C:\ProgramData\Tableau\Tableau Server\data\saml\<file.crt>"`

Para obter mais informações, consulte [Requisitos do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm) e [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).

keyFile

Obrigatório. Especifique o local do arquivo de chave privada (.key) que acompanha o arquivo de certificado. Por exemplo:

`"C:\ProgramData\Tableau\Tableau Server\data\saml\<file.key>"`

**Observação**: se você estiver usando uma chave RSA PKCS#8 que requer uma frase secreta, você deve definir a senha usando uma entidade configKey (consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm)) ou com [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet). A chave para a frase secreta que usa esses métodos é `wgserver.saml.key.passphrase`. O valor deve ser uma cadeia de caracteres não nula.

idpDomainAttribute

Para organizações que usam LDAP ou Active Directory, esse valor especifica qual atributo SAML que o Tableau Server consultará para determinar o nome de domínio. Por exemplo, se o IdP especificar o nome de domínio no atributo `domain`, então você especificaria `domain` para esse valor. **Observação** : para empresas que têm usuários entrando em vários domínios, esse valor é obrigatório.

Se você não fornecer um valor para esta chave, o valor usado depende da configuração de armazenamento de identidades do Tableau Server:

- Para o armazenamento de identidades local, o valor `idpDomainAttribute` é ignorado.
- Para Active Directory ou armazenamentos de identidades LDAP, o Tableau usa o FQDN da definição de configuração `wgserver.domain.default`.
    
    Para obter o valor de `wgserver.domain.default`, é possível executar o seguinte comando:
    
    `tsm configuration get --key wgserver.domain.default`

desktopNoSAML

true | false

Opcional. Permitem que os usuários utilizem a autenticação SAML quando fazem logon no Tableau Desktop.

Por padrão, isso não é definido, portanto o comportamento efetivo é equivalente à configuração como false. Se o logon único dos aplicativos de cliente do Tableau não funcionar com seu IdP, é possível definir isso como verdadeiro para desabilitar a autenticação SAML por meio do Tableau Desktop.

appNoSAML

true | false

Opcional. Permita o uso de SAML para fazer logon de versões mais antigas do aplicativo Tableau Mobile. Os dispositivos que executam a versão 19.225.1731 do aplicativo Tableau Mobile e ignoram essa opção. Para desabilitar os dispositivos que executam a versão 19.225.1731 e posteriores do Tableau Mobile, desabilite o SAML como uma opção de logon do cliente no Tableau Server.

logoutEnabled

true | false

Opcional. Permite um logout único \[SLO\] para usuários que fizeram logon com o SAML. O padrão é `true`.

Os metadados de configuração IdP devem incluir um único endpoint de logout com vinculação POST.

Esta configuração se aplica apenas para SAML em todo o servidor

Quando definida para `false`, o Tableau Server não tentará o logout único \[SLO\].

logoutUrl

Opcional. Insere a URL de redirecionamento usada depois que os usuários saem do servidor. Definir esta opção requer que `logoutEnabled` seja definido para `true`.

Por padrão, esta é a página de logon do Tableau Server. Você pode especificar uma URL absoluta ou relativa.

maxAuthenticationAge

Opcional. Especifica o número máximo de segundos permitidos entre a autenticação do usuário com o IdP e o processamento da mensagem AuthNResponse. O valor padrão é -1, o que significa que maxAuthenticationAge não está definido ou é ignorado por padrão. Antes de fevereiro de 2022, o valor padrão era 7200 (2 horas).

Para otimizar o comprimento da sessão, use o mesmo valor de tempo limite que é definido no IdP.

maxAssertionTime

Opcional. Determina o número máximo de segundos, desde a criação, em que uma asserção de SAML pode ser usada. O valor padrão é 3000 (50 minutos).

sha256Enabled

true | false

Opcional. O tipo de assinatura que o Tableau Server usará ao enviar mensagens para o IdP. Quando definido para `true`, o Tableau Server assinará mensagens com o algoritmo de assinatura SHA 256. Quando definido para `false`, o Tableau Server assinará mensagens com SHA 1. O padrão é `true`.

Esta opção define o algoritmo de assinatura para as seguintes mensagens que o Tableau Server assina: 

- Mensagens AuthnRequest quando `signRequests` estiver habilitado.
- Mensagens LogoutRequest se `logoutEnabled` estiver habilitado.

signRequests

true | false

Opcional. Especifica se o Tableau Server assinará os AuthnRequests enviados ao IdP. Os pedidos assinados nem sempre são necessários para todos os IDPs. Recomendamos assinar solicitações para garantir a opção mais segura ao configurar o SAML. Para verificar se seu IdP aceita solicitação assinada, inspecione os metadados do IdP: se `wantAuthnRequestsSigned` estiver definido para `true`, então seu IdP aceitará solicitações assinadas.

O valor padrão é: `true`. Para desativar as solicitações assinadas, defina essa opção como `false`.

acceptableAuthnContexts

Opcional. Define o atributo SAML `AuthNContextClassRef`. Este atributo opcional impõe a validação de certos "contextos" de autenticação em fluxos iniciados pelo IdP. Defina um conjunto separado por vírgulas para este atributo. Quando esse atributo é definido, o Tableau Server valida que a resposta SAML contém pelo menos um dos valores listados. Se a resposta SAML não contiver um dos valores configurados, a autenticação será rejeitada, mesmo que o usuário tenha autenticado com sucesso com o IdP.

Deixar essa opção em branco resultará em comportamento padrão: qualquer resposta SAML autenticada com sucesso resultará em um usuário sendo concedido a uma sessão dentro do Tableau Server.

iFramedIdpEnabled

true | false

Opcional. O valor padrão é `false`, ou seja, quando os usuários selecionam o botão de fazer logon em uma exibição inserida, o formulário de logon do IdP é aberto em uma janela pop-up.

Ao definir como true, e um usuário de servidor SAML que já tenha feito logon acessar uma página da Web com uma exibição inserida, não será necessário que ele faça logon para visualizar a exibição.

É possível definir isso como true apenas se o IdP oferece suporte a logon dentro de um iframe. A opção de iframe é menos segura do que o uso de um pop-up, por isso nem todos os IdPs oferecem suporte a ela. Se a página de logon do IdP implementar proteção contra clickjack, como a maioria faz, não será possível exibir a página de logon em um iframe e o usuário não conseguirá fazer logon.

Se o seu IdP oferece suporte a fazer logon por meio de um iframe, pode ser necessário habilitá-lo de maneira explícita. No entanto, mesmo que seja possível usar essa opção, ela desabilita a proteção contra clickjack do Tableau Server para SAML e por isso ela ainda apresenta um risco de segurança.

## Passar o arquivo de configuração para o Tableau Server

Depois de fornecer um valor apropriado para cada entidade incluída no modelo, use os seguintes comandos para passar o arquivo .json e aplicar os ajustes ao Tableau Server.

`tsm settings import -f path-to-file.json`

`tsm pending-changes apply`

## Consulte também

Ao concluir a configuração inicial do SAML, use [tsm authentication mutual-ssl <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMMutualSSL) para definir valores adicionais.

Para obter a referência da linha de comando referente à configuração do SAML, consulte [tsm authentication saml <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMsaml).

<!-- document id=3dce1c6a21adb3b81eba8669e03d660c98af0f215254bd4ea3f15358ab51d12b url=/tableau/current/pt-br/server/entity_sapHanaSettings.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade sapHanaSettings

Use a entidade sapHanaSettings para configurar a delegação SAML para SAP HANA.

Consulte [Configurar SSO para SAP HANA](https://help.tableau.com/current/server/pt-br/config_sap_hana_sso.htm) antes de continuar.

Use o modelo de arquivo de configuração abaixo para criar um arquivo json. Depois de preencher as opções com os valores adequados, passe o arquivo json e aplique as configurações com os seguintes comandos:

`tsm settings import -f path-to-file.json`

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

### Configurações SAML  do SAP HANA

As configurações no modelo abaixo especificam as configurações do Tableau Server em um cenário de delegação SAML com SAP HANA.

### Modelo de configuração

Use este modelo para definir as configurações de autenticação confiável.

Todos os referenciados em configEntities devem estar no computador local. Não especifique caminhos UNC.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

{
  "configEntities": {
	"sapHanaSettings": {
	"\_type": "sapHanaSettingsType",
	"enabled": "true",
	"usernameFormat": "username",
	"usernameCase": "preserve",
	"certFile": "path-to-cert\_file",
	"keyFile": "path-to-key\_file"
	 }
	}
}		

### Referência do arquivo de configuração

Esta tabela contém todas as opções que podem ser incluídas no conjunto de entidades `"gatewaySettings"`.

enabled

Obrigatório.

Valores: `true` ou `false`

usernameFormat

Valores: `username`, `domain_and_username`, ou `email`

Especifica o formato de credencial do nome de usuário.

usernameCase

Valores: `lower`, `upper`, ou `preserve`

Especifica o caso de nome da entrada do usuário.

certFile

Especifica o caminho do arquivo e o nome do arquivo de certificado no computador local.

Por exemplo, `"c:\\Program Files\\Tableau\\Tableau Server\\SAML\\saml_cert.crt"`.

keyFile

Especifica o caminho do arquivo e o nome da chave de certificado no computador local.

Por exemplo, `"c:\\Program Files\\Tableau\\Tableau Server\\SAML\\saml_key.der"`.

<!-- document id=b40044892a89efba21267eb7325a1e023e7046b202a86069447e524dee564fec url=/tableau/current/pt-br/server/entity_usage.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade shareProductUsageDataSettings

Antes de configurar essa entidade, consulte [Dados de uso do produto](https://help.tableau.com/current/server/pt-br/config_general.htm#product_data) para entender melhor os dados comportamentais e de uso que o Tableau coleta. (Seus valores de banco de dados confidenciais nunca são incluídos.)

Use o modelo de arquivo de configuração abaixo para criar um arquivo json. Depois de preencher as opções com os valores adequados, passe o arquivo json e aplique as configurações com os seguintes comandos:

`tsm settings import -f /path/to/file.json`

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

## Modelo de configuração

Use este modelo para definir as configurações de dado de uso do produto.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

{
  "configEntities": {
	"shareProductUsageDataSettings": {
		"\_type": "shareProductUsageDataSettingsType",
		"enabled": "true"
        }
     }			
 }

## Referência do arquivo de configuração

A lista a seguir inclui todas as opções que podem ser incluídas com o conjunto de entidades `"shareProductUsageDataSettings"`:

\_type

Valor obrigatório: `shareProductUsageDataSettingsType`

enabled

Opções: `true`ou `false`

O padrão, `true`, compartilha dados de uso do produto do servidor com o Tableau.

<!-- document id=503e3f4386153d41d7a1d22bdd23511ec53f916ce695089f750e01f261437fc0 url=/tableau/current/pt-br/server/entity_trusted_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Entidade trustedAuthenticationSettings

Antes de configurar a autenticação confiável, consulte [Autenticação confiável](https://help.tableau.com/current/server/pt-br/trusted_auth.htm).

Use o modelo de arquivo de configuração abaixo para criar um arquivo json. Depois de preencher as opções com os valores adequados, passe o arquivo json e aplique as configurações com os seguintes comandos:

`tsm settings import -f /path/to/file.json`

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

## Modelo de configuração

Use este modelo para definir as configurações de autenticação confiável.

**Importante:** todas as opções de entidade diferenciam maiúsculas de minúsculas.

Para obter mais explicações sobre arquivos de configuração, entidades e chaves, consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).

Depois de concluir a configuração inicial da autenticação confiável, use a subcategoria [tsm authentication trusted <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMTrusted) para definir mais valores.

{
"configEntities": {
	"trustedAuthenticationSettings": {
		"\_type": "trustedAuthenticationSettingsType",
		"trustedHosts": \["webserv1","webserv2","webserv3"\]
		}
	}
}

## Referência do arquivo de configuração

A lista a seguir inclui todas as opções que podem ser incluídas com o conjunto de entidades `"trustedAuthenticationSettings"`.

trustedHosts

Obrigatório.

Os endereços IP ou nomes do host de servidores da Web que solicitam tíquetes confiáveis do Tableau Server.

Essa opção tem uma lista de cadeias de caracteres, o que requer passar cada IP ou host entre aspas, separados por uma vírgula (sem espaço) e entre colchetes. Por exemplo: `["192.168.1.101","192.168.1.102","192.168.1.103"]` ou `["webserv1","webserv2","webserv3"]`.

Os valores que você especificar sobrescrevem qualquer configuração anterior. Portanto, é obrigatória a inclusão da lista completa de hosts ao configurar esse valor.

tokenLength

Opcional.

O valor pode ser definido como qualquer inteiro entre 9 e 255, inclusive.

Determina o número de caracteres em cada ticket confiável. A configuração padrão de `24` caracteres fornece 144 bits de aleatório. Esta opção é ignorada, a menos que `useV2Tickets` esteja definido como `true`, o que não é uma prática recomendada.

logLevel

Opcional.

`all` | `debug` | `info` | `warn` | `error` | `fatal` | `off`

Padrão: `info`

Especifica o nível de registro para processos relacionados à criação e recuperação de tickets confiáveis. Consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

timeoutInSeconds

Opcional.

Padrão: `180`

Especifica a duração (em segundos) para invalidar tickets confiáveis após sua criação.

tryCount

Opcional.

Inteiro.

Padrão: `10`

Especifica a quantidade de tentativas para criar uma entrada de ticket confiável.

use9DigitToken

Opcional.

`true` | `false`

Padrão: `false`

Quando definido como `true`, os tickets têm nove dígitos (como na versão 8.0 e anterior) e a opção `tokenLength` é ignorada. Esta opção é usada para o suporte temporário do código herdado.

**Aviso**: definir esta opção como `true` prejudica muito o poder de segurança da autenticação de tíquete confiável.

useV2Tickets

Opcional.

`true` | `false`

Padrão: `false`

Especifica se o Tableau Server deve retornar um formato de URL herdado para solicitações de tíquete confiáveis. O formato de URL herdado inclui uma cadeia de 24 caracteres codificada com Base64. A partir do Tableau Server 10.3, a URL retornada foi atualizada e inclui uma UUID codificada Base64 e uma cadeia de 24 caracteres aleatória e segura. Somente defina a opção como `true` se tiver implementado tíquetes confiáveis com código personalizado que exige o formato de URL herdado. Em vez disso, recomendamos atualizar o seu código personalizado para aceitar o novo formato de URL.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 30%;"><col style="width: 70%;"></colgroup><tbody><tr></tr></tbody></table>

<!-- document id=6ca6a107cb21b56f6baa9259b72476db7c22545b725ae346fb1206444095b5da url=/tableau/current/pt-br/server/trusted_auth_trouble_cookie.md -->

[Pular para o conteúdo principal](#main-content)

# Erro de restrição de cookie

Quando um usuário entra no Tableau Server, um cookie de sessão é armazenado em seu navegador local. O cookie armazenado é a forma como o Tableau Server mantém que o usuário que entrou foi autenticado e pode acessar o servidor. Como o cookie é definido com o mesmo domínio ou subdomínio que a barra de endereços do navegador, ele é considerado um cookie primário. Se o navegador de um usuário estiver configurado para bloquear cookies primários, ele não conseguirá entrar no Tableau Server.

Quando um usuário entra no Tableau Server por meio de uma exibição inserida, ou em um ambiente em que a autenticação confiável tenha sido configurada, o mesmo acontece: um cookie é armazenado. Nesse caso, entretanto, o navegador trata o cookie como um cookie de terceiros. Isso acontece porque o cookie é definido com um domínio que é diferente daquele mostrado na barra de endereços do navegador. Se o navegador da web do usuário estiver configurado para bloquear cookies de terceiros, a autenticação no Tableau Server falhará. Para evitar que isso ocorra, os navegadores da web devem ser configurados para permitir cookies de terceiros.

<!-- document id=79630196ffc8aa628e84219816861eff03ecbc6477f21972882609275c6730a9 url=/tableau/current/pt-br/server/trusted_auth_trouble_vizql.md -->

[Pular para o conteúdo principal](#main-content)

# Erro na comunicação com o servidor (403)

Se o Tableau Server estiver configurado para a autenticação confiável, é possível que esse erro apareça após abrir uma nova exibição em um navegador e tentar navegar de volta para as exibições abertas anteriormente.

O Tableau Server fornece proteção contra a reutilização não autorizada de sessões VizQL por meio das [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm) `vizqlserver.protect_sessions`, definidas como `true` por padrão. Como o Tableau Server é configurado para autenticação confiável, você pode não precisar deste nível de proteção Para desabilitar essa opção, você pode usar as [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm) para mudá-la `vizqlserver.protect_sessions` para `false`. A partir de 2024.2.0, o Tableau Server sempre impede que sessões VizQL sejam reutilizadas depois da saída do usuário original.

<!-- document id=983f85d7b88c48b56b5130119fd1cb5e2b907bbc9d8186fcee04bb4c6622490d url=/tableau/current/pt-br/server/ts_aws_scaling.md -->

[Pular para o conteúdo principal](#main-content)

# Escalonamento do Tableau Server na AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

O Tableau Server foi projetado para escalonamento vertical com mais núcleos e memória da CPU e horizontal com a adição de servidores. Esta arquitetura permite maximizar o uso dos recursos de computação e fornecer uma capacidade de escalonamento em massa.

Para criar redundância, é necessário adicionar mais servidores, que hospedam cópias dos processos do repositório, do armazenamento de arquivos e outros. Nesse cenário, é necessário isolar o servidor inicial em seu próprio nó e, idealmente, executar o mínimo de processos de servidor possível.

**Observação:** embora seja possível dividir uma licença de 8 núcleos em duas máquinas de 4 núcleos, recomendamos o escalonamento em incrementos e apenas em máquinas de 8 núcleos.

## Balanceamento de carga

Na AWS, o ELB (Elastic Load Balancing, Balanceamento de carga elástico) distribui automaticamente o tráfego de aplicativos recebido em várias instâncias do Amazon EC2 na nuvem. Ele permite atingir níveis maiores de tolerância a falhas nos aplicativos e fornece facilmente a quantidade exigida de capacidade de balanceamento de carga, necessária para distribuir o tráfego do aplicativo.

Use o ELB para distribuir solicitações em vários gateways em um cluster do Tableau Server. Na imagem abaixo, todos os três nós têm gateways, usados para encaminhar solicitações para processos de servidor disponíveis. Ao contrário do processo de repositório, não há nenhum processo de gateway passivo ou em espera, todos estão ativos. Ao adicionar um balanceador de carga a um cluster do Tableau Server, a URL acessada pelos usuários do Tableau Server pertencerá ao balanceador de carga e não ao Tableau Server inicial.

![Um fluxograma ilustra a arquitetura de balanceamento de carga em três Tableau Servers.](/tableau/current/pt-br/server/pt-br/Img/ts_aws_elb.png)

## Alta disponibilidade

Agora que você forneceu redundância para o armazenamento de arquivos, o repositório e o gateway ao adicionar vários nós, também é possível criar redundância para o Tableau Server inicial. É possível fazer isso ao criar um backup do Tableau Server inicial. Embora o backup deva ser licenciado durante a instalação, ele não conta como um dos três ambientes permitidos no Contrato de licença do usuário final (EULA) do Tableau.

Para configurar para alta disponibilidade, é necessário executar um cluster de failover. Neste caso, o Tableau Server inicial pode estar executando menos ou nenhum processo do Tableau Server. Para obter mais informações, consulte [Alta disponibilidade](https://help.tableau.com/current/server/pt-br/distrib_ha.htm) na Ajuda do Tableau Server.

<!-- document id=1a26477878019676c32a7f93790adce39ba73cd499db3312873f9239acbf8df3 url=/tableau/current/pt-br/server/data_stories_story_types.md -->

[Pular para o conteúdo principal](#main-content)

# Escolha o tipo de história certa para sua história com dados do Tableau Desktop

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Ao [Adicionar Histórias com dados do Tableau a um painel](https://help.tableau.com/current/server/pt-br/data_stories_create.htm), é importante escolher o tipo certo de história para seus dados. Você quer sua história sobre tendências ao longo do tempo? Ou você quer sua história sobre dois valores que você está comparando? Para ajudar você a contar a história certa, este tópico descreve os diferentes tipos de histórias, incluindo um exemplo de cada tipo de história.

## Contínuo

Histórias contínuas são melhores para analisar tendências ou progresso ao longo do tempo.

Quando você cria uma história contínua, ela inclui conteúdo para desempenho, segmentos, volatilidade e linhas de tendência. A história também inclui análise de contribuição e correlação para histórias que usam mais de uma dimensão. Para usar uma história contínua, sua planilha deve ter:

- 1 dimensão que tem entre 1 e 10 medidas
- 2 dimensões e até 3 medidas

O exemplo a seguir é uma história contínua para um gráfico de linhas que tem uma única dimensão e várias medidas:

![Gráficos de três linhas com um exemplo de história contínua](/tableau/current/pt-br/server/pt-br/Img/data_stories_continuous.png)

## Discreto

Histórias discretas são melhores para comparar valores e entender a distribuição de dados em cada valor. Quando você cria uma história discreta, ela inclui conteúdo sobre a distribuição e agrupamentos ou clusters nos dados. E a história inclui análise de contribuição para planilhas que usam várias dimensões.

Considere usar uma história discreta quando quiser:

- Entenda os direcionadores de seus principais indicadores de desempenho (KPIs) em relatórios de vendas.
- Identifique e entenda os valores discrepantes rapidamente durante a descoberta de dados.
- Identifique tendências que não são facilmente observáveis no visual ao realizar uma auditoria.
- Descubra informações de utilização complexos instantaneamente para análise geográfica.
- Identifique e destaque os principais relacionamentos, por exemplo, entre vendas e lucro.

Para usar uma história discreta, sua planilha deve ter:

- 1 dimensão que tem entre 1 e 10 medidas
- 2 dimensões e até 3 medidas

O exemplo a seguir é uma história discreta para um gráfico de barras que tem uma única dimensão e duas medidas:

![Um gráfico de barras com um exemplo de história discreta](/tableau/current/pt-br/server/pt-br/Img/data_stories_discrete.png)

## Porcentagem de inteiro

Porcentagem de histórias inteiras são melhores para gráficos de pizza. Para usar uma porcentagem de toda a história, sua planilha deve ter:

- 1 dimensão
- 1 medida

O exemplo a seguir é uma porcentagem de toda a história que usa um gráfico de pizza com uma única dimensão e uma única medida:

![Um gráfico de pizza com uma porcentagem de todo o exemplo da história](/tableau/current/pt-br/server/pt-br/Img/data_stories_percent.png)

## Gráficos de dispersão

Histórias de dispersão são melhores para entender a relação entre duas medidas. Quando você cria uma história de gráfico de dispersão, a história inclui conteúdo sobre o relacionamento (regressão) entre duas medidas. E a história inclui conteúdo sobre grupos (clusters) dentro dos dados, quando eles existem.

Considere usar uma história de dispersão quando quiser:

- Destaque os relacionamentos entre duas medidas para identificar o impacto (análise de regressão).
- Identifique e entenda os valores discrepantes que estão acima ou abaixo dos limites definidos.
- Analise como seus dados são distribuídos.

Para usar uma história de gráfico de dispersão, sua planilha deve ter:

- 1 dimensão
- 2 ou 3 medidas

**Nota:** quando você cria sua história do gráfico de dispersão, a primeira medida selecionada é tratada como a variável independente e a segunda medida é a variável dependente.

O exemplo a seguir é uma história de gráfico de dispersão que usa um gráfico de dispersão que tem uma única dimensão e duas medidas:

![Um gráfico de dispersão com um exemplo de história de gráfico de dispersão](/tableau/current/pt-br/server/pt-br/Img/data_stories_scatter.png)

<!-- document id=cb79f9be5852a99a36d43816608e7589040a2ea0df5dc214a56edd76c2efa1b6 url=/tableau/current/pt-br/server/connected_apps_scopes.md -->

[Pular para o conteúdo principal](#main-content)

# Escopos de acesso para aplicativos conectados

A partir do Tableau Server versão 2022.3 , ao usar aplicativos conectados ao Tableau, você pode chamar e acessar programaticamente a API REST do Tableau por meio de seu aplicativo personalizado em nome dos usuários do Tableau Server. O acesso à API REST é habilitado por um JSON Web Token (JWT) definido como parte da solicitação inicial de login. O JWT deve conter escopos que definam os métodos da API REST que estão disponíveis para seu aplicativo personalizado e seus usuários por meio do aplicativo conectado.

Autorize o acesso à API REST usando aplicativos conectados para:

- Aprimore a segurança — usar um JWT como token de portador é inerentemente mais seguro do que armazenar e gerenciar senhas de usuários administrativos por meio de arquivos .env em cofres
- Aumente a eficiência — usar um JWT como token de portador permite uma representação simplificada com uma solicitação para o endpoint de login em vez de duas solicitações
- Estenda e automatize integrações complexas do Tableau e consultas de back-end, como recuperação dinâmica de conteúdo e filtragem avançada

## Ações de escopo

Os aplicativos conectados usam escopos que concedem acesso a ações de conteúdo ou administrativas por meio dos [Métodos da API REST que dão suporte à autorização JWT](#scopes) (abaixo). Um escopo é uma cadeia de caracteres separada por dois pontos que começa com o namespace `tableau`, seguido pelo recurso do Tableau ao qual o acesso está sendo concedido, como`datasources` e termina com a ação permitida no recurso, como`update`.

As ações que um escopo pode realizar incluem:

- `create`
- `read`
- `run`
- `update`
- `download`
- `delete`

Por exemplo, um escopo que permite que seu aplicativo personalizado chame o método [Atualizar fonte de dados](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_data_sources.htm#update_data_source) se parece com: `tableau:datasources:update`

## Tipos de escopo

O tipo de escopo que você usa depende do conteúdo ou da ação administrativa que deseja habilitar. Os escopos geralmente se enquadram em um dos seguintes tipos: leitura de conteúdo, individual, curinga e categoria cruzada.

- Escopo de **leitura de conteúdo:** o escopo de leitura de conteúdo, `tableau:content:read`, habilita métodos GET compatíveis para conteúdo do Tableau. Ao usar esse escopo, você habilita ações nas categorias da API REST. Mais especificamente, usando esse escopo, você habilita métodos GET para fontes de dados, métricas, exibições, pastas de trabalho, projetos e sites. A partir de Tableau Server 2023.3, você também especifica esse escopo em um JWT que será usado para criar um token de credenciais para uso com a [API de metadados](https://help.tableau.com/current/api/metadata_api/pt-br/docs/meta_api_auth.html). A partir de Tableau Server 2025.1, você também especifica esse escopo em um JWT que será usado para criar um token de credenciais para uso com o [VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/pt-br/index.html).
    
    **Observação:** para habilitar métodos GET para ações administrativas, como usuários e grupos, você pode usar seus escopos individuais.
- **Escopos individuais:** para habilitar conteúdo suportado e ações administrativas, você pode usar seus escopos individuais. Um escopo individual geralmente é associado a um único método e categoria da API REST.
    
    Exemplos:
    
    - Para permitir publicar ou atualizar uma ação de fonte de dados, você pode usar o escopo individual `tableau:datasources:create` ou`tableau:datasources:update`, respectivamente.
    - Para ações administrativas como adicionar ou remover usuários, você pode usar o escopo individual `tableau:users:create` ou `tableau:users:delete`, respectivamente.
    
    **Observação:** existem alguns escopos individuais que podem permitir ações nas categorias da API REST. Por exemplo, `tableau:views:download` permite ações nas categorias de API REST de exibição de dados e pastas de trabalho.
- **[Escopos curinga:](#wildcard)** para determinados escopos, você pode substituir a ação pelo caractere curinga (\*) para habilitar ações com suporte em uma categoria de API REST específica.
    
    Exemplos:
    
    - Você pode usar o escopo curinga `tableau:projects:*` para habilitar as ações de criação, exclusão e atualização na categoria API REST de projetos.
    - Você pode usar o escopo curinga `tableau:users:*` para habilitar as ações de obter lista, adição, exclusão e atualização na categoria API REST de usuários.
    - Você pode usar o escopo curinga `tableau:tasks:*` para habilitar as ações de obter/listar, adicionar, excluir, atualizar e executar ações de categorias de API REST de extração e assinaturas. Além disso, esse escopo permite atualizar a fonte de dados (se for uma extração) e atualizar a pasta de trabalho.
- **[Escopos de categoria cruzada:](#cross)** além do escopo de leitura de conteúdo, há alguns escopos adicionais que, se usados, habilitam ações com suporte em diferentes categorias de API REST.
    
    Exemplos:
    
    - Se estiver usando o escopo `tableau:tasks:run`, você habilitará ações nas fontes de dados e categorias de API REST de pastas de trabalho.
    - Novamente, se estiver usando o escopo `tableau:views:download`, habilite ações nas categorias API REST de exibição de dados e pasta de trabalho.
    - Se estiver usando escopos de permissões como `tableau:permissions:update` ou`tableau:permissions:delete`, você ativa ações nas fontes de dados, pastas de trabalho e categorias de API REST de projetos.

## Resumo de como autorizar o acesso à API REST

A lista a seguir resume as etapas para solicitar acesso à API REST por meio de um JWT:

1. **Crie um aplicativo conectado** usando um dos seguintes métodos:
    - [Configurar aplicativos conectados com confiança direta](https://help.tableau.com/current/server/pt-br/connected_apps_direct.htm)
    - [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm)
2. **Gere um JWT válido** — em tempo de execução, seu aplicativo personalizado gerará um JWT válido, configurado com os escopos que você incluiu
3. **Faça uma solicitação de [login](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_authentication.htm#sign_in)** — seu aplicativo personalizado fará uma solicitação de login usando o JWT para retornar um token de credenciais do Tableau e um ID do site (LUID)
4. **Use o token de acesso do Tableau em solicitações** subsequentes — em chamadas subsequentes da API REST, use 1) o token de credenciais do Tableau como o valor de cabeçalho [`X-Tableau-Auth`](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#using_auth_token) e 2) o ID do site (LUID) no URI de solicitação

### Exemplo

Por exemplo, suponha que você crie um aplicativo conectado usando confiança direta. Usando confiança direta, seu aplicativo personalizado que chama a API REST gera um JWT válido usando o ID do cliente e o segredo do cliente gerados pelo aplicativo conectado.

**Escopos no JWT**

Para autorizar com êxito o acesso à API REST, o JWT também deve conter os escopos que definem os recursos da API REST. Por exemplo, para habilitar vários métodos relacionados à fonte de dados, você pode incluir os seguintes escopos no JWT:

`"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"`

Ou

`"tableau:content:read","tableau:datasources:*","tableau:tasks:run"`

**Observação:** os valores devem ser passados como um tipo de lista.

**URI de solicitação de logon**

Para fazer uma chamada para a API REST, seu aplicativo personalizado deve primeiro fazer uma solicitação de logon para gerar um token de credenciais do Tableau.

```
POST https://myco/api/3.17/auth/signin
```

**Corpo da solicitação**

Para autorizar o acesso à API REST usando um JWT, o corpo da solicitação de logon deve conter o JWT válido, como no exemplo abaixo.

```
<tsRequest>
   <credentials jwt="eyJpc3MiOiI4ZTFiNzE3Mi0zOWMzLTRhMzItODg3ZS1mYzJiNDExOWY1NmQiLCJhbGciOiJIUzI1NiIsImtpZCI6ImIwMTE1YmY5LTNhNGItNGM5MS1iMDA5LWNmMGMxNzBiMWE1NiJ9.eyJhdWQiOiJ0YWJsZWF1Iiwic3ViIjoicm1vaGFuQHRhYmxlYXUuY29tIiwic2NwIjpbInRhYmxlYXU6c2l0ZXM6cmVhZCJdLCJpc3MiOiI4ZTFiNzE3Mi0zOWMzLTRhMzItODg3ZS1mYzJiNDExOWY1NmQiLCJleHAiOjE2NDg2Njg0MzksImp0aSI6IjY1ZWFmMmYxLTNmZTgtNDc5Ny1hZmRiLTMyODMzZDVmZGJkYSJ9.mUv2o4gtBTrMVLEXY5XTpzDQTGvfE2LGi-3O2vdGfT8">
    <site contentUrl="mycodotcom"/>
   </credentials>
</tsRequest>
```

**Corpo de resposta**

A solicitação de logon produz o seguinte corpo de resposta, que inclui o token de credenciais do Tableau.

```
<tsResponse>
   <credentials token="12ab34cd56ef78ab90cd12ef34ab56cd">
    <site id="9a8b7c6d5-e4f3-a2b1-c0d9-e8f7a6b5c4d" contentUrl=""/>
    <user id="9f9e9d9c-8b8a-8f8e-7d7c-7b7a6f6d6e6d" />
   </credentials>
</tsResponse>
```

Depois que o token de credenciais do Tableau for gerado, adicione-o ao cabeçalho de todas as solicitações subsequentes da API REST.

**Cabeçalho**

X-Tableau-Auth:12ab34cd56ef78ab90cd12ef34ab56cd

Todas as solicitações subsequentes da API REST usando o token de acesso do Tableau são delimitadas pelos escopos no JWT.

## Métodos da API REST que dão suporte à autorização JWT

Os escopos para aplicativos conectados concedem ao seu aplicativo personalizado acesso aos recursos da API REST do Tableau em nome dos usuários

### Como encontrar escopos

Você pode encontrar o escopo necessário para um método com suporte a JWT em seu bloco de propriedades na Ajuda da [API REST do Tableau](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm). Se um escopo não estiver listado no bloco de propriedades do método, o acesso a esse método não poderá ser controlado por um JWT.

Por exemplo, um escopo que permite chamar o método [Consultar site](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_site.htm#query_site) na API REST do Tableau é `tableau:sites:read`.

**Observações:**

- Ambos os métodos [Entrar](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_authentication.htm#sign_in) e [Sair](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_authentication.htm#sign_out) são compatíveis com a autorização JWT, mas não requerem escopos para serem usados a partir de Tableau Server 2023.3..
- Para escopos compatíveis com a API de inserção v3, consulte um dos seguintes:
    - [Configurar aplicativos conectados com confiança direta](https://help.tableau.com/current/server/pt-br/connected_apps_direct.htm)
    - [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm)
- A partir do Tableau Server 2025.3, um subconjunto de escopos listados também oferece suporte à autorização da API REST por meio de tokens de acesso unificados (UATs). Isso significa que os aplicativos conectados e os escopos UAT são os mesmos.

### Tipo de escopos

#### Sobre escopos curinga (\*)

Os escopos curinga usam o caractere curinga (\*) em vez de uma ação específica, para habilitar diversas ações aceitas em uma categoria específica da API REST do Tableau.

#### Exemplos

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 25%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 75%;"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">Escopo</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">Métodos ativados</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:datasources:*</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite criar, atualizar e atualizar métodos de fonte de dados de conexão.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:metrics:*</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Habilita ações de consulta, atualização e exclusão de métricas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:workbooks:*</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite publicar, atualizar, baixar e visualizar as ações da pasta de trabalho da imagem.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:groups:*</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite criar, consultar, atualizar e excluir ações de grupos.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:projects:*</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite criar, excluir e atualizar métodos de projetos.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:users:*</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite obter/listar, adicionar, excluir e atualizar métodos de usuários.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>tableau:tasks:*</code><p><b>Observação:</b> este escopo também é de categoria cruzada.</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Permite obter/listar, adicionar, excluir, atualizar e executar métodos para extrações e tarefas de assinatura.<p>Habilita métodos de atualização para fontes de dados de pastas de trabalho.</p></td></tr></tbody></table>

#### Sobre escopos entre categorias

Os escopos entre categorias permitem diversas ações com suporte em várias categorias da API REST do Tableau.

#### Exemplos

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 25%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 75%;"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">Escopo</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">Métodos ativados</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:content:read</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite métodos de leitura/lista para conteúdo do Tableau, incluindo fontes de dados, métricas, visualizações, pastas de trabalho, projetos e sites.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:tasks:run</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite executar métodos para fontes de dados, pastas de trabalho e extrações.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:views:download</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite métodos de download para visualizar dados e pastas de trabalho.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>tableau:tasks:*</code><p><b>Observação:</b> este escopo também é curinga.</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Permite obter/listar, adicionar, excluir, atualizar e executar métodos para extrações e tarefas de assinatura.<p>Habilita métodos de atualização para fontes de dados de pastas de trabalho.</p></td></tr></tbody></table>

## Solucionar problemas de escopos

### 401001 - erro de login

Se você encontrar o erro 401001, o corpo da resposta **de login** será anexado com um dos seguintes códigos de erro adicionais específicos de aplicativos conectados: 16, 10084 ou 10085.

Por exemplo, no corpo da resposta a seguir, "10084" é o código de erro dos aplicativos conectados que você pode usar para ajudar a solucionar problemas ao fazer login no Tableau Server usando um JWT para autorização de API REST.

<error code="401001">  
  "summary": "Signin Error",
  "detail": "Error signing in to Tableau Cloud (10084)"
</error>

Para ajudar a resolver o problema, consulte a descrição do código de erro aplicável e suas possíveis causas.

- **16: Não foi possível encontrar o usuário** — esse erro pode ocorrer porque o "`sub`" (nome de usuário) foi especificado

- **10084: Não foi possível analisar o token de acesso** — esse erro pode ocorrer pelos seguintes motivos:
    
    - O JWT é inválido ou ocorreu um problema inesperado
    - O "`aud` " (público) incorreto foi especificado
    - Para confiança direta, houve um problema ao assinar o segredo
- **10085: Não foi possível buscar o segredo para verificar a assinatura do ID do cliente** — esse erro pode ocorrer pelos seguintes motivos:
    
    - ID de cliente incorreto em "`iss` " especificada
    - Para confiança direta, "`kid` " (ID secreta) incorreta foi especificada
    - Para EAS, não foi possível recuperar as chaves do JWKSource

### 401002 - erro de acesso não autorizado

Se você encontrar o erro 401002 e tiver confirmado que possui as permissões apropriadas para fazer a solicitação, certifique-se de que o escopo incluído no JWT esteja correto e corresponda à solicitação que você está tentando fazer. Para obter uma lista de endpoints e escopos com suporte, consulte a seção [Métodos da API REST que dão suporte à autorização JWT](#scopes) acima.

<!-- document id=d60d87415b8ec576a06f2322587ce9f83fc4540fdfcb5f25ba71551e03403c11 url=/tableau/current/pt-br/server/adminview_space_all_nodes.md -->

[Pular para o conteúdo principal](#main-content)

# Espaço em disco do servidor

**Observação:** esta exibição só está disponível para administradores de servidor. Para acessar exibições de servidor em implantações de vários sites, clique no menu do site e selecione **Gerenciar todos os sites**. Para obter informações sobre como navegar em exibições administrativas, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

Use a exibição de Espaço em disco do servidor para visualizar a quantidade de espaço em disco em uso no computador ou computadores que executam o Tableau Server, onde esse espaço em disco faz referência apenas à partição na qual o Tableau Server está instalado. Também é possível usar essa exibição para identificar mudanças bruscas no uso do espaço em disco.

Esta exibição relata o uso do espaço em disco como um valor em GB decimal. Se o sistema operacional dos computadores do Tableau Server informar o valor usando GB binário, os valores poderão ser diferentes.

Para uma instalação distribuída, a exibição mostra informações sobre cada computador no cluster.

![O gráfico de barras exibe o uso mais recente do espaço em disco, enquanto um gráfico de linhas mostra o uso do espaço livre em disco em gigabytes no último mês para cinco servidores distintos.](/tableau/current/pt-br/server/pt-br/Img/adminview_space_all_nodes.png)

A exibição do Espaço em disco do servidor inclui dois gráficos:

- **Qual é o uso do espaço em disco mais recente?** — Esse gráfico mostra o uso do espaço em disco dos últimos 30 dias, em gigabytes e como uma porcentagem. O espaço em disco refere-se apenas à partição onde o Tableau Server está instalado.
- **Qual foi a tendência do espaço em disco no último mês?** — Esse gráfico mostra as alterações no uso do espaço em disco ao longo do último mês. Coloque o ponteiro em uma linha para ver a quantidade exata de espaço livre em disco de um ponto no tempo.

Quando o Tableau Server estiver com pouco espaço em disco, é possível remover arquivos para ter mais espaço livre.

Para obter mais informações, consulte [Solucionar problemas de uso do espaço em disco nos nós do Tableau Server](https://help.tableau.com/current/server/pt-br/trouble_disk_space.htm)

**Dica:** é possível fazer com que o Tableau Server envie notificações quando o espaço livre em disco ficar abaixo de um limite especificado. Para obter mais informações, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).

<!-- document id=c1d6c25fecd80121f7ee7c4a8cfbc63bf5fb665793c25dfc4d2afb768d6cdad9 url=/tableau/current/pt-br/server/adminview_stats_load_time.md -->

[Pular para o conteúdo principal](#main-content)

# Estatísticas para tempos de carregamento

A exibição Estatísticas para utilização do tempo mostra quais exibições são as mais caras em relação ao desempenho do servidor. É possível filtrar por exibição e intervalo de tempo. Os administradores de servidor podem filtrar por site. Também é possível limitar a exibição com base no tempo de carregamento em segundos, usando o filtro deslizante Tempo de Carregamento. O tempo de carregamento é para o servidor. Dependendo do navegador e da rede do seu cliente, o tempo de carregamento real pode variar um pouco.

O gráfico Tempo médio de carregamento mostra o tempo médio de carregamento para exibições baseadas nos filtros que você definiu. Focalize um ponto para ver os detalhes. Selecione um ponto na linha para atualizar o restante da exibição para a seleção:

![O gráfico de linhas exibe os tempos de carregamento das visualizações na última hora, enquanto o gráfico de dispersão visualiza os tempos de carregamento das visualizações individuais.](/tableau/current/pt-br/server/pt-br/Img/adminview_loadtime.png)

A exibição Tempo exato de carregamento mostra o tempo exato para carregar as exibições listadas. Uma linha vertical mostra o tempo de carregamento médio para cada exibição. Selecione uma marca para observar os detalhes de uma instância específica do carregamento da exibição:

![Uma tabela com uma lista de visualizações e seus tempos de carregamento.](/tableau/current/pt-br/server/pt-br/Img/adminview_load_time_exact.png)

<!-- document id=383e5ca0f0c1d24cc418c5455bc2ed1d3affc42f2504637a04fb1c302f3978b1 url=/tableau/current/pt-br/server/adminview_space.md -->

[Pular para o conteúdo principal](#main-content)

# Estatísticas para utilização do espaço

A exibição Estatísticas para utilização do espaço pode ajudar a identificar qual conteúdo do Tableau usa mais espaço em disco no servidor. A utilização do espaço em disco é exibida por usuário, projeto e tamanho do conteúdo do Tableau (pasta de trabalho, fonte de dados, saída de fluxo ou conexão virtual) e é arredondada para o número inferior mais próximo.

Observe que as conexões virtuais exigem Data Management. Consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm) para obter detalhes.

Para abrir essa exibição, clique em Status do site no painel de navegação esquerdo e, em Painel, clique em Estatísticas para uso do espaço.

![Um gráfico de barras na exibição do administrador mostra a utilização do espaço em um site, categorizada por usuário, projeto, pasta de trabalho e fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/adminview_space.png)

Use o filtro Tamanho mínimo para controlar qual conteúdo do Tableau é exibido, com base na quantidade de espaço que ocupa.

Três gráficos de barra oferecem a você as informações sobre utilização de espaço no seu Tableau Server:

- Quais usuários usam mais espaço—Mostra os usuários proprietários de fontes de dados e pastas de trabalho que usam mais espaço. Clique em um nome de usuário para filtrar os próximos dois gráficos para tal usuário. Clique na barra de fonte de dados ou na barra de pasta de trabalho para um usuário filtrar os próximos dois gráficos daquele tipo de objeto para aquele usuário. Clique no usuário selecionado ou barra para limpar a seleção.
- Quais projetos usam mais espaço—Mostra os projetos com fontes de dados e pastas de trabalho que usam mais espaço. Se um usuário ou tipo de objeto for selecionado no gráfico Quais usuários usam mais espaço, as informações específicas à seleção serão exibidas.
- Quais pastas de trabalho, fontes de dados, fluxos e conexões virtuais usam mais espaço — mostra qual conteúdo do Tableau usa mais espaço. As barras são codificadas por cor, com base no tempo decorrido desde a última atualização.

Mova o cursor sobre qualquer barra para exibir detalhes da utilização:

![Os usuários são organizados por site, com sua respectiva utilização de espaço representada em um gráfico de barras na visualização do administrador.](/tableau/current/pt-br/server/pt-br/Img/adminview_space_usage02.png)

Clique em uma barra para selecioná-la e, baseado nisso, atualizar as outras áreas da exibição.

<!-- document id=15a9b5049cfb4e744d083930ad98d5644a0b0d07e39d1ebbf1c146fdbe857659 url=/tableau/current/pt-br/server/prep_conductor_add_to_existing_install.md -->

[Pular para o conteúdo principal](#main-content)

# Etapa 1 (instalação existente): habilitar o Tableau Prep Conductor

Este tópico descreve como habilitar o Tableau Prep Conductor na instalação existente do Tableau Server.

O Tableau Prep Conductor é compatível somente com o Tableau Server versão 2019.1 ou posteriores. Se estiver usando o Tableau Server 2018.3 ou anteriores, primeiro atualize-o para a versão 2019.1 antes de habilitar o Tableau Prep Conductor na instalação do Tableau Server.

O Tableau Prep Conductor está licenciado por meio do Data Management de cada implantação, que está baseada em usuário ou núcleo. Uma implantação inclui uma instalação de produção licenciada do Tableau Server e instalações licenciadas de não produção do Tableau Server, que oferecem suporte à instalação de produção. Para obter mais informações sobre a implantação, consulte o [Guia de implantação do Tableau](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_welcome.htm).

Este tópico descreve como habilitar o Tableau Prep Conductor na instalação existente do Tableau Server.

## Antes de atualizar

### Preparar para a atualização:

- [Saiba antes de atualizar](https://help.tableau.com/current/server/pt-br/upgrade_know_before.htm)
- [Licenciamento do Tableau Prep Conductor](https://help.tableau.com/current/prep/pt-br/prep_conductor_licensing.htm)
- [Requisitos de hardware e recomendações do Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm)

### Configurar gateway público

Se o Tableau Server estiver configurado com uma das seguintes opções:

- Balanceador de carga para distribuir solicitações entre gateways.
- Proxy reverso para autenticar solicitações de cliente externo (Internet) e descarregar a criptografia baseada em SSL.

Você deve definir as seguintes configurações de gateway público:

`tsm configuration set -k gateway.public.host -v <name>` (Essa deve ser a URL usada pelos usuários para acessar o Tableau Server)

`tsm configuration set -k gateway.public.port -v 443`

Para obter mais informações sobre a definição de configurações de gateway, consulte [Configuração de proxies para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm#configure-tableau-server-to-work-with-a-reverse-proxy-server).

## Instalações do Tableau Server que usam licenças baseadas em usuário

A topologia recomendada para uma instalação de produção do Tableau Server é um nó dedicado para a execução de fluxos. Para obter mais informações, consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm).

### Instalações de nó único do Tableau Server

Se tiver uma instalação do Tableau Server de nó único, é recomendável adicionar um segundo nó e dedicá-lo à execução de fluxos.

1. Execute a atualização na sua instalação atual do Tableau Server usando as informações dos tópicos abaixo:
    
    - [Windows](https://help.tableau.com/current/server/pt-br/upgrade.htm)
    - [Linux](https://help.tableau.com/current/server-linux/pt-br/upgrade.htm)
        
        Quando chegar à etapa **Ativar**, use as chaves do produto do Tableau Server para ativar o Tableau Server.
        
        Todas as chaves do produto estão disponíveis no [Portal do cliente](http://customer.tableau.com/).
2. Ao concluir a instalação, adicione a chave do produto do Data Management para habilitar o Tableau Prep Conductor no seu nó. As chaves do produto Data Management, assim como as outras chaves do servidor, estão disponíveis no [Portal do cliente](http://customer.tableau.com/).
    
    - Na interface da Web do Tableau Services Manager, clique em **Licenciamento** na guia **Configuração** e em **Ativar licença**.
    - Insira ou cole a nova chave do produto e clique em **Ativar**.
    - Na página **Registrar**, insira suas informações nos campos e clique em **Registrar**.
3. Você será solicitado a reiniciar o servidor. Reinicie o servidor e verifique se o Tableau Prep Conductor está habilitado e em execução.
    
    - Na interface da Web do Tableau Services Manager, clique na guia **Status** para ver o status. Se o Tableau Prep Conductor estiver habilitado e em execução, você o verá na lista de processos como **Ativo**. Se o Tableau Prep Conductor não estiver habilitado, você o verá na lista de processos, mas sem as informações de status.
        
        **Tableau Prep Conductor não habilitado:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor não está habilitado.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_disabled_singlenode.png)
        
        **Tableau Prep Conductor habilitado e em execução:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor está habilitado e em execução.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_enabled_singlenode.png)
4. Adicione um segundo nó à instalação do Tableau Server. O instalador habilitará determinados processos necessários, como o Controlador de cluster. Ative o Processador em segundo plano, pois ele é necessário para executar tarefas de fluxo agendadas. Ao habilitar o Processador em segundo plano, o instalador habilita automaticamente uma única instância do Processador de dados e do Tableau Prep Conductor no nó. Não adicione outros processos nesse nó.
5. Execute os comandos a seguir para dedicar este nó apenas a tarefas de fluxo. Para obter mais informações sobre as funções do nó, consulte [Funções do nó no Tableau Server](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).
    
    - Obtenha a nodeID do seu nó dedicado para ver a lista de serviços em cada nó:
        
        `tsm topology list-nodes -v`.
    - Defina a função do nó dedicado usando a nodeID obtida ao executar o comando descrito acima:
        
        `tsm topology set-node-role -n <nodeID> -r flows`.
    - Aplique as alterações e reinicie o servidor:
        
        `tsm pending-changes apply`.
    - Revise o status para garantir que todos os processos estejam ativos, em execução e configurados corretamente:
        
        `tsm status -v`.

Você adicionou com sucesso o Tableau Prep Conductor à sua instalação do Tableau Server.

### Instalações de vários nós do Tableau Server

1. Execute a atualização na sua instalação atual do Tableau Server usando as informações dos tópicos abaixo:
    
    - [Windows](https://help.tableau.com/current/server/pt-br/upgrade.htm)
    - [Linux](https://help.tableau.com/current/server-linux/pt-br/upgrade.htm)
        
        Quando chegar à etapa **Ativar**, use as chaves do produto do Tableau Server para ativar o Tableau Server.
        
        Todas as chaves do produto estão disponíveis no [Portal do cliente](http://customer.tableau.com/).
2. Ao concluir a instalação, adicione a chave do produto do Data Management para habilitar o Tableau Prep Conductor. O Tableau Prep Conductor é habilitado automaticamente nos nós em que o Processador em segundo plano já está habilitado. As chaves do produto Data Management, assim como as outras chaves do servidor, estão disponíveis no [Portal do cliente](http://customer.tableau.com/).
    
    - Na interface da Web do Tableau Services Manager, clique em **Licenciamento** na guia **Configuração** e em **Ativar licença**.
    - Insira ou cole a nova chave do produto e clique em **Ativar**.
    - Na página **Registrar**, insira suas informações nos campos e clique em **Registrar**.
3. Você será solicitado a reiniciar o servidor. Reinicie o servidor e verifique se o Tableau Prep Conductor está habilitado e em execução.
    
    - Na interface da Web do Tableau Services Manager, clique na guia **Status** para ver o status de todos os processos. Se o Tableau Prep Conductor estiver habilitado e em execução, você o verá na lista de processos como **Ativo**. Se o Tableau Prep Conductor não estiver habilitado, você o verá na lista de processos, mas sem as informações de status.
        
        **Tableau Prep Conductor não habilitado:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor não está habilitado.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_disabled_multinode.png)
        
        **Tableau Prep Conductor habilitado e em execução:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor está habilitado e em execução.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_enabled_multinode.png)
4. Adicione um novo nó à instalação do Tableau Server. O instalador habilitará determinados processos necessários, como o Controlador de cluster. Ative o Processador em segundo plano, pois ele é necessário para executar tarefas de fluxo agendadas. Ao habilitar o Processador em segundo plano, o instalador habilita automaticamente uma única instância do Processador de dados e do Tableau Prep Conductor no nó. Não adicione outros processos nesse nó.
    
    **Observação:** o nó dedicado é contabilizado em relação à contagem total de ensemble do Serviço de coordenação. Talvez seja necessário implantar um Serviço de coordenação no novo nó, dependendo do número total de nós no cluster, incluindo o novo nó dedicado. Para obter mais informações, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
5. Execute o comando a seguir para dedicar este nó apenas às operações relacionadas ao fluxo. Para obter mais informações sobre as funções do nó, consulte [Funções do nó no Tableau Server](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).
    
    - Obtenha a nodeID do seu nó dedicado para ver a lista de serviços em cada nó:
    - `tsm topology list-nodes -v`.
    - Defina a função do nó dedicado usando a nodeID obtida ao executar o comando descrito acima:
    - `tsm topology set-node-role -n <nodeID> -r flows`.
    - Aplique as alterações e reinicie o servidor:
    - `tsm pending-changes apply`.
    - Revise o status para garantir que todos os processos estejam ativos, em execução e configurados corretamente:
    - `tsm status -v`.
6. Nesta etapa, você pode ter o Tableau Prep Conductor habilitado em outros nós. Por padrão, o Processador em segundo plano em um nó executa todos os tipos de tarefas, incluindo as de fluxo. Para isolar o Tableau Prep Conductor e as tarefas de fluxo apenas para nós específicos, é possível configurar os Processadores em segundo plano para executar um dos seguintes procedimentos:

- Executar somente tarefas de fluxo: `tsm topology set-node-role -n <nodeID> -r flows`.
- Executar todas as outras tarefas, exceto os fluxos: `tsm topology set-node-role -n <nodeID> -r no-flows`.

Você adicionou com sucesso o Tableau Prep Conductor à sua instalação do Tableau Server.

## Instalações do Tableau Server que usam licenças baseadas em núcleo

A topologia recomendada para uma instalação de produção do Tableau Server é um nó dedicado para a execução de fluxos. Para obter mais informações, consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm).

O Data Management para licenças baseadas em núcleo inclui chaves do produto que habilitam o Tableau Prep Conductor para o Tableau Server, bem omo os núcleos do Tableau Prep Conductor que vêm em unidades de quatro. Os núcleos do Tableau Prep Conductor devem ser aplicados ao nó dedicado à execução de fluxos. Essas chaves do produto, assim como as outras chaves do servidor, estão disponíveis no [Portal do cliente](http://customer.tableau.com/).

Para saber mais sobre o licenciamento do Tableau Prep Conductor, consulte [Licenciamento do Tableau Prep Conductor para o Tableau Server](https://help.tableau.com/current/prep/pt-br/prep_conductor_licensing.htm).

### Instalações de nó único do Tableau Server

Se tiver uma instalação do Tableau Server de nó único, é recomendável adicionar um segundo nó e dedicá-lo à execução de fluxos.

1. Execute a atualização na sua instalação atual do Tableau Server usando as informações dos tópicos abaixo:
    
    - [Windows](https://help.tableau.com/current/server/pt-br/upgrade.htm)
    - [Linux](https://help.tableau.com/current/server-linux/pt-br/upgrade.htm)
2. Ative as chaves do produto. Isso habilitará o Tableau Prep Conductor nos nós em que o Processador em segundo plano já está habilitado. Quando você estiver usando o licenciamento baseado no núcleo, aplique tanto a chave do produto Data Management quanto a chave do produto Resource Core para a implantação do Tableau. A primeira chave permite que os fluxos sejam executados no Tableau Server, embora o Tableau Prep Conductor e a segunda chave adicionem os núcleos adicionais para os nós do Tableau Prep Conductor. Todas as chaves do produto estão disponíveis no [Portal do cliente](http://customer.tableau.com/).
    
    - Na interface da Web do Tableau Services Manager, clique em **Licenciamento** na guia **Configuração** e em **Ativar licença**.
    - Insira ou cole a nova chave do produto e clique em **Ativar**.
    - Na página **Registrar**, insira suas informações nos campos e clique em **Registrar**.
3. Você será solicitado a reiniciar o servidor. Reinicie o servidor e verifique se o Tableau Prep Conductor está habilitado e em execução.
    
    - Na interface da Web do Tableau Services Manager, clique na guia **Status** para ver o status. Se o Tableau Prep Conductor estiver habilitado e em execução, você o verá na lista de processos como **Ativo**. Se o Tableau Prep Conductor não estiver habilitado, você o verá na lista de processos, mas sem as informações de status.
        
        **Tableau Prep Conductor não habilitado:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor não está habilitado.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_disabled_singlenode.png)
        
        **Tableau Prep Conductor habilitado e em execução:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor está habilitado e em execução.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_enabled_singlenode.png)
4. Adicione um segundo nó à instalação do Tableau Server. O instalador habilitará determinados processos necessários, como o Controlador de cluster. Ative o Processador em segundo plano, pois ele é necessário para executar tarefas de fluxo agendadas. Ao habilitar o Processador em segundo plano, o instalador habilita automaticamente uma única instância do Processador de dados e do Tableau Prep Conductor no nó. Não adicione outros processos nesse nó.
    
    > [!IMPORTANT]
    > 
    > **Importante:** o número de núcleos físicos neste computador deve ser igual ou inferior à quantidade de núcleos do Tableau Prep Conductor adquiridos. Por exemplo, se você adquiriu quatro núcleos do Tableau Prep Conductor, seu nó pode ter somente até quatro núcleos físicos. Para entender como o licenciamento do Tableau Prep Conductor funciona, consulte [Licenciamento do Tableau Prep Conductor para o Tableau Server](https://help.tableau.com/current/prep/pt-br/prep_conductor_licensing.htm).
5. Execute os comandos a seguir para dedicar este nó apenas a tarefas de fluxo. Para obter mais informações sobre as funções do nó, consulte [Funções do nó no Tableau Server](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).
    
    - Obtenha a nodeID do seu nó dedicado para ver a lista de serviços em cada nó:
        
        `tsm topology list-nodes -v`.
    - Defina a função do nó dedicado usando a nodeID obtida ao executar o comando descrito acima:
        
        `tsm topology set-node-role -n <nodeID> -r flows`.
    - Aplique as alterações e reinicie o servidor: `tsm pending-changes apply`.
    - Revise o status para garantir que todos os processos estejam ativos, em execução e configurados corretamente:
        
        `tsm status -v`.

Você adicionou com sucesso o Tableau Prep Conductor à sua instalação do Tableau Server.

### Instalações de vários nós do Tableau Server

1. Execute a atualização na sua instalação atual do Tableau Server usando as informações dos tópicos abaixo:
    
    - [Windows](https://help.tableau.com/current/server/pt-br/upgrade.htm)
    - [Linux](https://help.tableau.com/current/server-linux/pt-br/upgrade.htm)
2. Ative as chaves do produto. Isso habilitará o Tableau Prep Conductor nos nós em que o Processador em segundo plano já está habilitado. Quando você estiver usando o licenciamento baseado no núcleo, aplique tanto a chave do produto Data Management quanto a chave do produto Resource Core para a implantação do Tableau. A primeira chave permite que os fluxos sejam executados no Tableau Server, embora o Tableau Prep Conductor e a segunda chave adicionem os núcleos adicionais para os nós do Tableau Prep Conductor. Todas as chaves do produto estão disponíveis no [Portal do cliente](http://customer.tableau.com/).
    
    - Na interface da Web do Tableau Services Manager, clique em **Licenciamento** na guia **Configuração** e em **Ativar licença**.
    - Insira ou cole a nova chave do produto e clique em **Ativar**.
    - Na página **Registrar**, insira suas informações nos campos e clique em **Registrar**.
3. Você será solicitado a reiniciar o servidor. Reinicie o servidor e verifique se o Tableau Prep Conductor está habilitado e em execução.
    
    - Na interface da Web do Tableau Services Manager, clique na guia **Status** para ver o status. Se o Tableau Prep Conductor estiver habilitado e em execução, você o verá na lista de processos como **Ativo**. Se o Tableau Prep Conductor não estiver habilitado, você o verá na lista de processos, mas sem as informações de status.
        
        **Tableau Prep Conductor não habilitado:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor não está habilitado.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_disabled_multinode.png)
        
        **Tableau Prep Conductor habilitado e em execução:**
        
        ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor está habilitado e em execução.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_enabled_multinode.png)
4. Adicione um novo nó à instalação do Tableau Server. É recomendável um nó dedicado para executar operações relacionadas ao fluxo em instalações de produção do Tableau Server. O instalador habilitará determinados processos necessários, como o Controlador de cluster. Ative o Processador em segundo plano, pois ele é necessário para executar tarefas de fluxo agendadas. Ao habilitar o Processador em segundo plano, o instalador habilita automaticamente uma única instância do Processador de dados no nó. Não adicione outros processos nesse nó.
    
    **Observação:** o nó dedicado é contabilizado em relação à contagem total de ensemble do Serviço de coordenação. Talvez seja necessário implantar um Serviço de coordenação no novo nó, dependendo do número total de nós no cluster, incluindo o novo nó dedicado. Para obter mais informações, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
    
    > [!IMPORTANT]
    > 
    > **Importante:**  
    > O número de núcleos físicos neste computador deve ser igual ou inferior à quantidade de núcleos do Tableau Prep Conductor adquiridos. Por exemplo, se você adquiriu quatro núcleos do Tableau Prep Conductor, seu nó pode ter somente até quatro núcleos físicos. Para entender como o licenciamento do Tableau Prep Conductor funciona, consulte [Licenciamento do Tableau Prep Conductor para o Tableau Server](https://help.tableau.com/current/prep/pt-br/prep_conductor_licensing.htm).
5. Execute os comandos a seguir para dedicar este nó apenas a tarefas de fluxo. Isso habilitará o Tableau Prep Conductor no novo nó. Para obter mais informações, consulte [Funções do nó no Tableau Server](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).
    
    - Obtenha a nodeID do seu nó dedicado para ver a lista de serviços em cada nó:
        
        `tsm topology list-nodes -v`.
    - Defina a função do nó dedicado usando a nodeID obtida ao executar o comando descrito acima:
        
        `tsm topology set-node-role -n nodeID -r flows`.
    - Aplique as alterações e reinicie o servidor:
        
        `tsm pending-changes apply`.
    - Revise o status para garantir que todos os processos estejam ativos, em execução e configurados corretamente:
        
        `tsm status -v`.
6. Nesta etapa, você pode ter o Tableau Prep Conductor habilitado em outros nós que tenham o Processador em segundo plano. Por padrão, o Processador em segundo plano em um nó executa todos os tipos de tarefas, incluindo as de fluxo. Para isolar o Tableau Prep Conductor e as operações de fluxo apenas para nós específicos, é possível configurar os processadores em segundo plano para executar um dos seguintes procedimentos:
    
    - Executar somente tarefas de fluxo:
        
        `tsm topology set-node-role -n <nodeID> -r flows`.
    - Executar todas as outras tarefas, exceto os fluxos:
        
        `tsm topology set-node-role -n <nodeID> -r no-flows`.

## Próxima etapa

[Etapa 2: Configurações de fluxo para o Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_server_site_settings.htm).

### Quem pode fazer isso

Administradores do Tableau Server podem instalar e atualizá-lo, e habilitar o Tableau Prep Conductor no Tableau Server.

<!-- document id=aebcafdf21a72a4ca06dfcc24f119b552baf482135e7f79c6cc904310cb728f9 url=/tableau/current/pt-br/server/prep_conductor_new_install.md -->

[Pular para o conteúdo principal](#main-content)

# Etapa 1 (nova instalação): instalar o Tableau Server com o Tableau Prep Conductor

Este tópico descreve como usar o Tableau Prep Conductor em uma nova instalação do Tableau Server.

O Tableau Prep Conductor é compatível somente com o Tableau Server versão 2019.1 ou posteriores.

O Tableau Prep Conductor está licenciado por meio do Data Management a cada implantação. Uma implantação inclui uma instalação de produção licenciada do Tableau Server e instalações licenciadas de não produção do Tableau Server, que oferecem suporte à instalação de produção. Para obter mais informações sobre a implantação, consulte o [Guia de implantação do Tableau](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_welcome.htm).

## Antes da instalação

A topologia recomendada para uma instalação de produção do Tableau Server é um nó dedicado para a execução de fluxos. Se tiver planejando ter uma instalação do Tableau Server de nó único, é recomendável adicionar um segundo nó e dedicá-lo à execução de fluxos.

- Revise as recomendações de hardware para o Tableau Server e o Tableau Prep Conductor.
    - [Requisitos mínimos de hardware e recomendações para a instalação do Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm) no Windows.
    - [Requisitos mínimos de hardware e recomendações para a instalação do Tableau Server](https://help.tableau.com/current/server-linux/pt-br/server_hardware_min.htm) no Linux.

## Instalar o Tableau Server e habilitar o Tableau Prep Conductor

Use as instruções fornecidas nos tópicos a seguir para instalar o Tableau Server.

[Windows: instalar o Tableau Server](https://help.tableau.com/current/server/pt-br/jumpstart.htm)

[Tópico Linux: instalar o Tableau Server](https://help.tableau.com/current/server-linux/pt-br/jumpstart.htm)

Quando chegar à etapa **Ativar**, use as chaves do produto do Tableau Server para ativar o Tableau Server.

Todas as chaves do produto estão disponíveis no [Portal do cliente](http://customer.tableau.com/).

### Configurar gateway público

Se o Tableau Server estiver configurado com uma das seguintes opções:

- Balanceador de carga para distribuir solicitações entre gateways.
- Proxy reverso para autenticar solicitações de cliente externo (Internet) e descarregar a criptografia baseada em SSL.

Você deve definir as seguintes configurações de gateway público:

`tsm configuration set -k gateway.public.host -v <name>` (Essa deve ser a URL usada pelos usuários para acessar o Tableau Server)

`tsm configuration set -k gateway.public.port -v 443`

Para obter mais informações sobre a definição de configurações de gateway, consulte [Configuração de proxies para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm#configure-tableau-server-to-work-with-a-reverse-proxy-server).

### Habilitar o Tableau Prep Conductor

Use as etapas a seguir para adicionar a chave do produto do Data Management ao Tableau Server. Esse processo requer que o Tableau Server seja reiniciado.

**Observação:** se você estiver usando o licenciamento baseado no núcleo, aplique tanto a chave do produto Data Management quanto a chave do produto Resource Core para a implantação do Tableau. A primeira chave permite que os fluxos sejam executados no Tableau Server, embora o Tableau Prep Conductor e a segunda chave adicionem os núcleos adicionais para os nós do Tableau Prep Conductor. Todas as chaves do produto estão disponíveis no [Portal do cliente](http://customer.tableau.com/).

1. Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de continuar.
2. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`
3. Clique em Licenciamento, na guia Configuração e clique em Ativar licença:
4. Insira ou cole a **chave do produto do Data Management** e clique em **Ativar**.
5. Na página Registrar, insira suas informações nos campos e clique em Registrar.
6. Siga os prompts e reinicie o Tableau Server após a conclusão do registro.

### Verificar se o Tableau Prep Conductor está habilitado e em execução

Ao ativar a chave do produto de Data Management, uma única instância do Tableau Prep Conductor é habilitada automaticamente em qualquer nó que tenha o Processador em segundo plano habilitado.

**Use as etapas a seguir para verificar se ele está habilitado e em execução:**

1. Abra um navegador e insira a URL do Tableau Server e anexe a porta da IU da Web do TSM dedicada. A URL deve ser semelhante aos exemplos abaixo:
    
    https://localhost:8850/ (se estiver trabalhando diretamente no computador do servidor)
    
    https://MarketingServer:8850/ (se souber o nome do servidor)
    
    https://10.0.0.2:8850/ (se souber o endereço IP do servidor)
    
    Na página de logon exibida, insira o nome de usuário e a senha do administrador.
    
    **Observação:** o Tableau Server cria e configura um certificado autoassinado durante o processo de instalação. Esse certificado é usado para criptografar o tráfego para a IU da Web do TSM. Como é um certificado autoassinado, por padrão, o navegador não confiará nele. Portanto, o navegador exibirá um aviso sobre a confiabilidade do certificado antes de permitir a conexão.
2. Na interface da Web do Tableau Services Manager, clique na guia **Status** para ver o status.
    
    - Se o Tableau Prep Conductor estiver habilitado e em execução, você o verá na lista de processos e ele será exibido como **Ativo** em pelo menos um nó. Se o Tableau Prep Conductor não estiver habilitado, você o verá na lista de processos, mas sem as informações de status de nenhum dos nós.
        
        **Tableau Prep Conductor não habilitado:**
        
        ![Tableau Prep Conductor não habilitado](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_disabled_multinode.png)
    
    **Tableau Prep Conductor habilitado e em execução. Na imagem abaixo, o Tableau Prep Conductor está habilitado no nó 1 e nó 3:**
    
    ![A guia Status da interface da Web do Tableau Services Manager mostra que o Tableau Prep Conductor está habilitado e em execução.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_TPC_enabled_multinode.png)

## Dedicar um nó para o Tableau Prep Conductor

No nó que você está planejando dedicar para executar fluxos, habilite o Processador em segundo plano se ele ainda não estiver habilitado. É recomendável que você não execute outros processos, como o VizQL Server, nesse nó.

Como esse nó está dedicado à execução fluxos, configure o Processador em segundo plano para executar apenas as tarefas de fluxo. Por padrão, o Processador em segundo plano executa todos os tipos de tarefas, incluindo fluxos, atualizações de extração e assinaturas. Para obter mais informações, consulte [Funções do nó no Tableau Server](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).

Execute os seguintes comandos tsm nesse nó dedicado para executar apenas as tarefas de fluxo:

1. Execute o comando a seguir para permitir que os Processadores em segundo plano desse nó executem apenas as tarefas de fluxo.
    
    `tsm topology set-node-role -n node1 -r flows`
2. Defina a função de nó no nó inicial para nenhum fluxo. O processador em segundo plano nesse nó executará todas as tarefas, exceto os fluxos:
    
    `tsm topology set-node-role -n node1 -r no-flows`
3. Aplicar as alterações e reiniciar o Tableau Server:
    
    `tsm pending-changes apply`

### Instalações em vários nós

Se você tiver mais de dois nós na instalação do Tableau Server, poderá optar por configurar outros nós para executar todas as tarefas que não sejam os fluxos:

1. Restrinja um nó para não permitir fluxos. Este comando remove o Tableau Prep Conductor desse nó e os Processador em segundo plano do nó não executarão as tarefas de fluxo.
    
    `tsm topology set-node-role -n node1 -r no-flows`
2. Aplicar as alterações e reiniciar o Tableau Server:
    
    `tsm pending-changes apply`

## Próxima etapa

[Etapa 2: Configurações de fluxo para o Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_server_site_settings.htm)

### Quem pode fazer isso

Os administradores de servidor podem instalar o Tableau Server e habilitar o Tableau Prep Conductor.

<!-- document id=0cf021862d044fac21c2abf7d85b4138bb70b12a3ea22d9d1bee65cd761cede6 url=/tableau/current/pt-br/server/prep_conductor_configure_server_site_settings.md -->

[Pular para o conteúdo principal](#main-content)

# Etapa 2: Configurações de fluxo para o Tableau Server

Este tópico descreve as diversas configurações de fluxo que podem ser definidas para o Tableau Server. Para obter mais informações sobre as diferentes configurações necessárias para ativar a autoria da web para fluxos, consulte [Criar e interagir com fluxos na Web](https://help.tableau.com/current/server/pt-br/web_author_flows.htm).

## Configurações de publicação, agendamento e credencial

Ao ativar o Tableau Prep Conductor usando a chave do produto de Gerenciamento de dados, ele será habilitado para toda a instalação do Tableau Server. Você pode posteriormente modificar e personalizar a configuração dos sites.

Use as instruções a seguir para definir as configurações relacionadas aos fluxos para todos os sites ou sites individuais:

Use as instruções a seguir para entrar nas páginas de administração do Tableau Server:

- Windows: [Páginas de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).
- Linux: Páginas de administração do Tableau Server.

**Configurar se o fluxo de publicação e agendamento deve ser permitido para um site:**

1. **Permitir que os usuários publiquem e agendem fluxos:** por padrão, ao habilitar o Tableau Prep Conductor, essa configuração também é habilitada. Se você tiver vários sites, poderá desativar seletivamente o Tableau Prep para o servidor de sites individuais. Se você desabilitar essa configuração para um site que permitia fluxos, consulte [Consequência de desabilitar o Tableau Prep Conductor](#Implicat) para obter mais informações.
    
    Na página **Geral**, em **Configurações**, vá para a seção **Tableau Prep Conductor** e desmarque a caixa de seleção **Permitir que usuários agendem e monitorem os fluxos**.
2. **Permitir que os usuários vinculem execuções de fluxo usando Tarefas vinculadas (versão 2021.3 e posterior):** Permite que os usuários agendem tarefas de fluxo para serem executadas uma após a outra. A partir da versão 2022.1, esta opção é habilitada por padrão. Nas versões anteriores, os administradores precisavam habilitar esse recurso primeiro.
    
    Se você tiver vários sites, pode desativar seletivamente as Tarefas vinculadas para sites individuais, mas a opção deve ser habilitada primeiro no nível de Configurações do servidor
    
    Se a configuração for desabilitada depois que as tarefas vinculadas forem agendadas, todas as tarefas em execução serão concluídas, e as tarefas vinculadas agendadas serão ocultadas e não serão mais exibidas na guia Tarefas agendadas.
3. **Credenciais inseridas**
    
    **\- Permitir que os publicadores insiram credenciais em uma fonte de dados, um fluxo ou uma pasta de trabalho**: essa configuração permite que os publicadores anexem senhas aos fluxos publicados que autenticarão automaticamente os usuários da Web.
    
    **\- Permitir que os publicadores agendem execuções de fluxo e atualizações de extração de dados**: essa opção estará disponível apenas se a configuração acima estiver habilitada. Quando essa configuração estiver habilitada, os publicadores verão opções de agendamento na caixa de diálogo Publicar.

### Consequência de desabilitar o Tableau Prep Conductor

Se você desabilitar o Tableau Prep Conductor depois de usá-lo por um tempo, não poderá ver os fluxos, agendas, tarefas e outros itens relacionados aos fluxos. A tabela a seguir fornece mais informações sobre o que pode ou não ser visualizado ao desabilitar completamente o Tableau Prep para o servidor ou apenas para sites específicos:

<table class="simple-table" style="width: 100%;"><colgroup><col><col><col><col style="width: 139px;"></colgroup><tbody><tr><td>&nbsp;</td><td><b>Prep não habilitado no nível de servidor</b></td><td><b>Prep habilitado no nível de servidor, mas desabilitado para um site</b></td><td><b>Prep habilitado para servidor e site</b></td></tr><tr><td><b>Mostrar fluxos</b></td><td>Sim</td><td>Sim</td><td>Sim</td></tr><tr><td><b>Mostrar tarefas/agendas na exibição do servidor</b></td><td>Não</td><td>Sim</td><td>Sim</td></tr><tr><td><b>Mostrar tarefas/agendas na exibição do site</b></td><td>Não</td><td>Não</td><td>Sim</td></tr><tr><td><b>Mostrar configuração do site (somente para administradores do servidor)</b></td><td>Sim (desabilitado)</td><td>Sim</td><td>Sim</td></tr><tr><td><b>Mostrar status do TSM</b></td><td>Sim (o Tableau Prep Conductor não é exibido)</td><td>Sim</td><td>Sim</td></tr><tr><td><b>Mostrar configurações do TSM</b></td><td>Sim (desabilitado)</td><td>Sim</td><td>Sim</td></tr></tbody></table>

> [!IMPORTANT]
> 
> **Importante**: as tarefas agendadas continuarão a ser executadas mesmo quando o Tableau Prep Conductor estiver desabilitado para esse site, mas ocorrerão falhas.

## Configurar notificações para falhas de fluxo

Você pode configurar o Tableau Server para enviar notificações por e-mail para falhas de execução do fluxo. As notificações são enviadas para falhas que ocorrem ao executar os fluxos por meio de uma tarefa vinculada tarefa agendada, tarefa vinculada ou uma execução manual usando a opção de menu **Executar agora**. Você deve primeiro habilitar a configuração em todo o servidor e, em seguida, configurar no nível de site.

### Para habilitar a notificação por e-mail em todo o servidor

Você pode usar a interface da Web do Tableau Services Manager (TSM) ou a CLI do TSM, conforme descrito abaixo:

Usar a interface na Web do TSM

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850.
2. Clique em Notificações na guia Configuração e clique em Servidor de e-mail.
3. Insira as informações do servidor de e-mail.
4. Clique na guia **Eventos**.
5. Em **Atualizações de conteúdo**, selecione **Enviar e-mails quando há falhas de execuções de fluxo, trabalhos de criptografia ou atualizações de extração**, se ainda não estiver ativado por padrão.
6. Clique em Salvar alterações pendentes depois de inserir suas informações de configuração.
7. Clique em Aplicar alterações e reiniciar.

Usar a CLI do TSM

Os valores da notificação podem ser definidos individualmente com o comando tsm configuration set:

Windows: [tsm configuration](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#tsm-configuration-set).

Linux: [tsm configuration.](https://help.tableau.com/current/server-linux/pt-br/cli_configuration_tsm.htm#tsm-configuration-set)

#### Definir os valores da notificação

Use o comando tsm configuration set com a seguinte sintaxe para

habilitar as notificações de falha de fluxo e execute o comando a seguir:

`tsm configuration set -k backgrounder.notifications_enabled -v true`

**Observação:** isso habilitará a notificação por e-mail para falhas de atualização de extração e de fluxo.

Após concluir a definição dos valores, execute o comando a seguir:

`tsm pending-changes apply`

O comando pending-changes apply exibirá um prompt para informar que reiniciará o Tableau Server se o servidor estiver em execução. O prompt será exibido mesmo que o servidor esteja parado, porém, nesse caso, não há reinicialização. Cancele o prompt usando a opção --ignore-prompt, mas isso não alterará o comportamento de reinicialização.

### Para configurar a notificação para um site:

Na página **Geral** **em Configurações**, role até a configuração Gerenciar notificações e selecione os tipos de notificação que você deseja que os usuários do site recebam.

Você pode receber notificações por e-mail no site do Tableau ou em sua área de trabalho do Slack, se o administrador conectou seu site ao Slack. Para obter informações, consulte [Referência das propriedades do site](https://help.tableau.com/current/server/pt-br/sites_add.htm).

![Central de notificação de configuração do site](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_notification_center22_1.png)

**Observação:** recrie suas configurações de notificação ao atualizar de 2020.4 ou anterior para 2021.1 e posterior. Configurações de notificações mais antigas não são movidas automaticamente para a configuração de Gerenciar notificações.

## Próxima etapa

[Etapa 3: Criar agendas para tarefas de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_create_schedule_definitions.htm)

### Quem pode fazer isso

Os administradores do Tableau Server podem definir as configurações no nível de servidor e de site. Os administradores de site do Tableau podem definir as configurações no nível de site.

<!-- document id=e93802beedd9bc3ba92799a1ae7b4e91f4d1a3b2ea7ebad89971118ff3632194 url=/tableau/current/pt-br/server/prep_conductor_create_schedule_definitions.md -->

[Pular para o conteúdo principal](#main-content)

# Etapa 3: Criar agendas para tarefas de fluxo

## Criar uma nova agenda:

1. Na guia **Agendas**, clique em **Nova Agenda**.
    
    ![A guia Agendas no Tableau Server ou Tableau Cloud mostra o botão Novas agendas.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_schedules.png)
2. Insira as seguintes informações na caixa de diálogo **Nova agenda** e clique em **Criar**.
    
    - **Nome:** digite um nome descritivo para a agenda. Normalmente, isso inclui a descrição da frequência da agenda.
    - **Tipo:** selecione Fluxo como o tipo de tarefa.
    - **Prioridade:** defina uma prioridade padrão de 1 a 100, em que 1 é a prioridade mais alta. Esse valor será atribuído às tarefas por padrão. Se duas tarefas estiverem pendentes na fila, aquela com a prioridade mais alta será executada primeiro. Se não houver prioridade de tarefa atribuída, o padrão será 0, que é a prioridade mais alta. Somente os administradores podem alterar a prioridade da tarefa. Para obter mais informações, consulte [Como os trabalhos do servidor agendados são priorizados](https://help.tableau.com/current/server/pt-br/task_prioritization.htm).
    - **Execução:** escolha se um agendamento será executado em paralelo ou em série. Agendas executadas em paralelo são executadas em todos os processos do processador em segundo plano disponíveis para que possam ser concluídas mais rapidamente.
    - Tarefas vinculadas (versão 2021.3 e posterior): marque a caixa de seleção se a agenda puder ser usada para agendar fluxos para execução um após o outro. Tarefas vinculadas requerem um método de execução Paralelo.
        
        A partir da versão 2022.1, esta opção é habilitada por padrão. Em versões anteriores, o administrador do servidor deve habilitar primeiro as tarefas vinculadas para o servidor, antes que você possa configurar agendamentos para oferecer suporte a tarefas vinculadas. Para obter mais informações, consulte [Etapa 2: Configurações de fluxo para o Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_server_site_settings.htm).
    - **Frequência:** você pode definir uma agenda horária, diária, semanal ou mensal.
        
        ![A caixa de diálogo Criar agenda no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_new_schedule.png)

## Próxima etapa

[Etapa 4: Lista de permissões para locais de entrada e saída](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm)

### Quem pode fazer isso

Os administradores do Tableau Server podem criar e modificar as agendas. As agendas são criadas no nível do servidor e aplicam-se a todos os sites em um servidor.

<!-- document id=e9bded35a7850127fe6252257ba8f71f8518cb60bb2818a14a687f87780e8239 url=/tableau/current/pt-br/server/prep_conductor_configure_network_shares.md -->

[Pular para o conteúdo principal](#main-content)

# Etapa 4: Lista de permissões para locais de entrada e saída

Este tópico descreve as regras que se aplicam a esse recurso e como usar a lista de permissões para os diretórios da rede.

As conexões de entrada e saída do fluxo podem precisar se conectar a bancos de dados ou a arquivos nos diretórios da rede. Você deve usar a lista de permissões para os diretórios nos quais deseja permitir o acesso. As conexões de entrada e saída poderão se conectar apenas aos dados nos locais listados na lista de permissões. Por padrão, nenhuma conexão é permitida.

**Observação**: você ainda pode publicar os fluxos e os dados incorporados no arquivo de fluxo (tflx) no Tableau Server, mas o fluxo falhará se os diretórios não forem incluídos na lista de permissões da organização.

## Como usar a lista de permissões para os locais de entrada e saída

As regras a seguir se aplicam e devem ser consideradas ao definir esta configuração:

- Os caminhos do diretório devem ser acessíveis pelo Tableau Server. Esses caminhos são verificados durante a inicialização do servidor e no tempo de execução do fluxo e **não** são verificados no momento da publicação do fluxo no Tableau Server.
- Se o fluxo ler ou gravar em um arquivo .hyper em um compartilhamento de rede, adicione o caminho ao diretório que contém o arquivo para a lista de permissões native\_api.allowed\_paths. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#nativeapiallowedpaths).
- Os caminhos do diretório de rede devem ser absolutos e não podem conter caracteres curinga ou outros símbolos de passagem de caminho. Por exemplo, `\\myhost\myShare\*` **ou** `\\myhost\myShare*` são caminhos inválidos e não teriam permissão. A maneira correta de usar a lista de permissões para qualquer pasta no _myShare_ seria `\\myhost\myShare` **ou** `\\myhost\\myShare\`.
    
    **Observação:** a configuração `\\myhost\myShare` não permitirá `\\myhost\myShare1`. Para permitir as duas pastas, use a lista de permissões para elas como \\\\myhost\\myShare; \\\\myhost\\myShare1.
- **Windows:**
    
    - O valor pode ser `*`, (por exemplo, `tsm configuration set -k maestro.input.allowed_paths -v "*"`) para permitir qualquer diretório de rede, ou uma lista específica de caminhos do diretório de rede, delimitado por um ponto e vírgula (**;**). Se você especificar uma lista de caminhos de diretório, certifique-se de especificar diretórios específicos em vez da raiz do compartilhamento de arquivos.
    - Se o caminho contiver espaços ou caracteres especiais, será necessário usar aspas simples ou duplas. O uso de aspas simples ou duplas dependerá do shell usado.
    - Nenhum caminho do diretório local é permitido, mesmo quando o valor for definido como `*`.
    - Para salvar a saída de fluxo para um compartilhamento de rede, você deve primeiro [configurar uma conta de serviço de usuário Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm)no Tableau Server. Você não pode salvar fluxos para um compartilhamento de rede usando a conta padrão do sistema. Em seguida, configure o diretório de destino no compartilhamento de rede para permissões de controle total para a conta de usuário Run As que você criou.
        
        Dependendo de como sua organização gerencia permissões de pasta aninhadas, você pode precisar conceder permissões adicionais na hierarquia da pasta, com um mínimo de permissão de Pasta de Leitura, Gravação, Execução, Exclusão e Lista, para permitir que a conta de usuário Run As acesse a pasta de destino.
- **Linux:**
    
    - O valor pode ser `*`, (for example, `tsm configuration set -k maestro.input.allowed_paths -v "*"`), o que significa que qualquer caminho, incluindo o local (com exceção de alguns caminhos do sistema configurados usando “native\_api.internal\_disallowed\_paths”) ou uma lista de caminhos, é delimitado por um ponto e vírgula (**;**).
    - Você deve usar uma versão do kernel igual ou posterior a 4.7. A lista de permissões de e para um compartilhamento de rede não é compatível com as versões do kernel anteriores a 4.7. Em versões anteriores, quando a saída é gravada em um compartilhamento de rede, o hyper falha na saída de arquivos, resultando em falhas de fluxo no tempo de execução. Ao ler arquivos de entrada de um compartilhamento de rede em versões anteriores, as execuções de fluxo falham. Para verificar a versão do kernel, no terminal Linux, digite o comando `uname -r`. Isso exibirá a versão completa do kernel em execução na máquina com Linux. Observe que para o Red Hat Enterprise Linux, o kernel versão 4.7 e posteriores estão disponíveis apenas com o Red Hat Enterprise Linux versão 8.
    - Para salvar a saída de fluxo para um compartilhamento de rede, a conta Linux local que tem acesso aos recursos do Tableau Server deve receber permissões de Controle Total para o diretório de destino no compartilhamento de rede. Se um caminho estiver na lista permitida de fluxos e na lista internal\_disallowed, a internal\_disallowed terá preferência.  
        Os pontos de montagem para os caminhos de entrada e saída usados pelos fluxos devem ser configurados usando a chave de configuração `native_api.unc_mountpoints`. Por exemplo:  
        `tsm configuration set -k native_api.unc_mountpoints -v 'mountpoints'`  
        Para obter informações sobre como configurar isso, consulte este artigo da Base de conhecimento do Tableau: [Tableau Server no Linux - Como se conectar a um diretório compartilhado do Windows](https://kb.tableau.com/articles/howto/tableau-server-on-linux-how-to-connect-to-a-windows-shared-directory?lang=pt-br).

Use os comandos a seguir para criar uma lista de caminhos do diretório de rede permitidos:

**Para conexões de entrada:**

`tsm configuration set -k maestro.input.allowed_paths -v your_networkdirectory_path_1;your_networkdirectory_path_2`

`tsm pending-changes apply`

**Para conexões de saída:**

`tsm configuration set -k maestro.output.allowed_paths -v your_networkdirectory_path_1;your_networkdirectory_path_2`

`tsm pending-changes apply`

> [!IMPORTANT]
> 
> Importante:  
> Esses comandos substituem as informações existentes pelas novas informações fornecidas. Se quiser adicionar um novo local em uma lista existente, forneça uma lista de todos os locais existentes e o novo que deseja adicionar. Use os comandos a seguir para visualizar a lista atual de locais de entrada e saída:  
>   
> `tsm configuration get -k maestro.input.allowed_paths   tsm configuration get -k maestro.output.allowed_paths`  

## Próxima etapa

[Etapa 5: Configurações opcionais do servidor](https://help.tableau.com/current/server/pt-br/prep_conductor_config_server_optional.htm)

### Quem pode fazer isso

No Windows, os membros do grupo de Administradores do computador local podem executar comandos _tsm._

No Linux, os membros do grupo **tsmadmin** podem executar comandos _tsm._ O grupo **tsmadmin** pode ser configurado usando a configuração _tsm.authorized.groups_.

<!-- document id=d9b685cae92f647140759cae177d84ac58294733ebaf41401cf29eef82d052e1 url=/tableau/current/pt-br/server/prep_conductor_config_server_optional.md -->

[Pular para o conteúdo principal](#main-content)

# Etapa 5: Configurações opcionais do servidor

As opções descritas neste tópico não são necessárias para habilitar a publicação e o agendamento de fluxos no Tableau Server. Elas podem ser usadas para personalizar seu ambiente de acordo com suas necessidades.

## Definir o período de tempo limite para fluxos

Defina limites de tempo para duração de execução de um fluxo de forma a garantir que as tarefas subsequentes não sejam impedidas devido a tarefas interrompidas. As duas opções de comando _tsm_ a seguir determinam quanto tempo uma tarefa de fluxo pode ser executada antes que a tarefa em segundo plano do fluxo seja cancelada. Esses dois comandos determinam o valor total de tempo limite para tarefas de fluxo.

O `backgrounder.default_timeout.run_flow` número de segundos antes de uma tarefa de execução de fluxo ser cancelada.

Por exemplo:

`tsm configuration set -k backgrounder.default_timeout.run_flow -v <new value>`

`tsm pending-changes apply`

(Valor padrão: 14400 segundos ou 4 horas)

O comando `backgrounder.extra_timeout_in_seconds` define o número de segundos além da configuração em `backgrounder.querylimit` antes de um processador em segundo plano ser cancelado. Essa configuração garante que um trabalho interrompido não retenha os trabalhos subsequentes. A configuração aplica-se a processos listados em `backgrounder.timeout_tasks`.

Por exemplo:

`tsm configuration set -k backgrounder.extra_timeout_in_seconds -v <value>`

(Valor padrão: 1800 segundos ou 30 minutos)

Verifique os recursos disponíveis nos fluxos de execução do servidor. Recomenda-se que você tenha um nó dedicado para o Tableau Prep Conductor.

## Definir o limite para tarefas de fluxo suspensas

Por padrão, uma tarefa de fluxo é suspensa após 5 falhas consecutivas de tarefas de fluxo. Para alterar o número limite das falhas de tarefa de fluxo que podem ocorrer antes de serem suspensas, use o seguinte comando de conjunto de configurações tsm:

`tsm configuration set -k backgrounder.flow_failure_threshold_for_run_prevention -v <number>`

Isso define o limite para o número de tarefas de fluxo consecutivas com falhas necessárias antes de suspender as tarefas. Esta é uma configuração em todo o servidor.

### Quem pode fazer isso

Os administradores do Tableau Server podem fazer alterações nas configurações do servidor.

<!-- document id=505ffc2efe82a39f5d924b2c8205513d6dd91295a11dda31dd001e4c72768b20 url=/tableau/current/pt-br/server/groups_delete.md -->

[Pular para o conteúdo principal](#main-content)

# Excluir grupos

Você pode excluir qualquer grupo do servidor com a exceção do grupo Todos os usuários. Quando um grupo é excluído, os usuários são removidos do grupo, mas não são excluídos do servidor.

1. Entre para Tableau Server site como um administrador.
2. No painel de navegação esquerdo, clique em Grupos.
3. Na página Grupos, selecione um ou mais grupos a serem excluídos.
4. Selecione Ações \> Excluir.
    
    ![Página Grupos mostrando dois grupos selecionados e a ação Excluir grupo destacada.](/tableau/current/pt-br/server/pt-br/Img/groups6.png)

## Efeitos da exclusão de grupos

### Grupos em conjuntos de grupos

A partir de Tableau Server 2024.2), grupos podem ser adicionados a conjuntos de grupos. Quando as permissões de conteúdo dependem de um conjunto de grupos, os recursos de conteúdo são avaliados quando os usuários pertencem a todos os grupos do conjunto de grupos. Se um grupo que pertence a um conjunto de grupos for excluído, ele poderá alterar o acesso do usuário ao conteúdo do Tableau quando as permissões de conteúdo dependerem do conjunto de grupos.

<!-- document id=bf1468958791cd3c8c8574fee369c30203bef529706562b1c6f0fc223226688b url=/tableau/current/pt-br/server/connect_basic_initialsql.md -->

[Pular para o conteúdo principal](#main-content)

# Executar o SQL inicial

**Observação**: o Tableau Prep Builder versão 2019.2.2 e posterior oferece suporte ao uso de SQL inicial, mas ainda não oferece suporte a todas as mesmas opções suportadas por Tableau Desktop. Para obter informações sobre como usar o SQL inicial com o Tableau Prep Builder, consulte [Use o SQL inicial para consultar suas conexões](https://help.tableau.com/current/prep/pt-br/prep_connect.htm#initial_SQL) na Ajuda do Salesforce do Tableau Prep Builder.

Ao se conectar a alguns bancos de dados, você pode especificar um comando SQL inicial que será executado ou usar um valor em cache quando uma conexão for feita no banco de dados, por exemplo, ao abrir a pasta de trabalho, atualizar uma extração, fazer logon ou publicar no Tableau Server.

**Observação:** o SQL inicial é diferente de uma conexão de SQL personalizado. Uma conexão de SQL personalizado define uma relação (ou tabela) para emitir consultas. Para obter mais informações, consulte [Conectar a uma consulta de SQL personalizado](https://help.tableau.com/current/pro/desktop/pt-br/customsql.htm).

Você pode usar este comando para:

- Configurar tabelas temporárias para serem usadas durante a sessão.
- Configurar um ambiente de dados personalizado.

Você tem a opção de adicionar um comando de SQL inicial na caixa de diálogo Conexão do servidor ou na página Fonte de dados.

Observação: Se a sua fonte de dados aceita a execução em uma instrução SQL, SQL inicial aparece no canto inferior esquerdo da caixa de diálogo Conexão com o servidor no Tableau Desktop. Para obter informações sobre a sua fonte de dados, consulte [Conectores compatíveis](https://help.tableau.com/current/pro/desktop/pt-br/exampleconnections_overview.htm).

## Para usar o SQL inicial

1. Na caixa de diálogo Conexão com o servidor, clique em SQL inicial. Ou, na página Fonte de dados, selecione Dados > SQL inicial, ou Dados > Faixa de consulta e SQL inicial, dependendo do banco de dados ao qual você vai se conectar.
2. Insira o comando SQL na caixa de texto SQL inicial. É possível usar o menu suspenso Inserir para passar parâmetros para sua fonte de dados.
    
    ![Configuração inicial de SQL com um campo de texto para inserir instruções SQL.](/tableau/current/pt-br/server/pt-br/Img/connect_basic_initialsql.png)

**Observação:** o Tableau não examina se há erros na instrução. Essa instrução SQL é enviada ao banco de dados na conexão.

Sua licença de software pode impedi-lo de usar o SQL inicial com sua conexão. Se você publicar no Tableau Server, o servidor deverá ser configurado para permitir as instruções de SQL inicial. Por padrão, o software do servidor é configurado para permitir que essas instruções sejam executadas quando a pasta de trabalho é carregada em um navegador da Web.

Os administradores podem configurar o servidor para ignorar instruções de SQL inicial usando o comando `tsm configuration set`:

`tsm configuration set -k vizqlserver.initialsql.disabled -v true`

Se o servidor não permitir as instruções de SQL inicial, a pasta de trabalho será aberta, mas os comandos de SQL inicial não serão enviados.

Para obter mais informações sobre o comando `tsm configuration set`, consulte a [Ajuda do Tableau Server](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet).

## Parâmetros em uma instrução de SQL inicial

Você pode passar parâmetros para a sua fonte de dados em uma instrução de SQL inicial. A lista a seguir traz vários benefícios do uso de parâmetros em uma instrução SQL inicial.

- É possível configurar a representação usando os parâmetros TableauServerUser ou TableauServerUserFull.
- Se a fonte de dados for compatível, é possível configurar a segurança em nível de linha (por exemplo, para Oracle VPD ou SAP Sybase ASE), para garantir que os usuários visualizarão os dados que estão autorizados.
- É possível fornecer mais detalhes no logon, por exemplo, a versão do Tableau ou o nome da pasta de trabalho.

Os parâmetros a seguir são compatíveis com uma instrução de SQL inicial:

<table class="table--plain"><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">Parâmetro</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">Descrição</span></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">Exemplo de valor retornado</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauServerUser</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O nome de usuário do usuário de servidor atual. Use ao configurar a representação na servidor. Retorna uma cadeia de caracteres vazia se o usuário não estiver conectado ao Tableau Server.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">jsmith</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauServerUserFull</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O nome de usuário e o domínio do usuário do servidor atual. Use ao configurar a representação na servidor. Retorna uma cadeia de caracteres vazia se o usuário não estiver conectado ao Tableau Server.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">domain.lan\jsmith</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauApp</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O nome do aplicativo do Tableau.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> Professional</p><p>Tableau Server</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauVersion</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A versão do aplicativo do Tableau.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">9.3</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><span class="uicontrol">WorkbookName</span></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">O nome da pasta de trabalho do Tableau. Use apenas em pastas de trabalho com uma fonte de dados incluída.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Análise financeira</td></tr></tbody></table>

> [!WARNING]
> 
> **Aviso:** o Tableau Desktop não inclui o domínio. Você pode incluí-lo se não estiver usando delegação e definir tsm configuration set -k DelegationUseFullDomainName=-v true--force-keys

Os exemplos a seguir mostram maneiras diferentes de usar os parâmetros em uma instrução de SQL inicial.

- Esse exemplo define o contexto de segurança no Microsoft SQL Server:
    
    `EXECUTE AS USER = [TableauServerUser] WITH NO REVERT;`
- Esse exemplo mostra como, em uma fonte de dados DataStax, você pode usar os parâmetros para adicionar detalhes ao registro ou para configurar uma variável de sessão para o controle dos dados:
    
    `SET TABLEAUVERSION [TableauVersion];`
- Este exemplo pode ser usado para ajustar a segurança no nível de linha para Oracle VPD:
    
    `begin`
    
     `DBMS_SESSION.SET_IDENTIFIER([TableauServerUser]);`
    
    `end;`
    
    Observação: os blocos de Oracle PL/SQL precisam de um ponto e vírgula à direita para finalizar o bloco. Consulte a documentação da Oracle para obter a sintaxe apropriada.

### Adiar a execução para o servidor

Você pode adiar uma instrução de SQL inicial, para que ela seja executada apenas no servidor. Uma razão de adiamento da execução para o servidor é se não houver permissão para executar os comandos que configuram a representação. Use as marcas <ServerOnly></ServerOnly> para colocar os comandos que serão executados somente no servidor.

Exemplo:

CREATE TEMP TABLE TempTable(x varchar(25));
INSERT INTO TempTable VALUES (1);
<ServerOnly>INSERT INTO TempTable Values(2);</ServerOnly>

### Segurança e representação

Quando você usar o parâmetro TableauServerUser, TableauServerUserFull em uma instrução SQL inicial, uma conexão dedicada que não poderá ser compartilhada com outros usuários será criada. Isso também poderá restringir o compartilhamento de cache, o que pode melhorar a segurança, mas também pode prejudicar o desempenho.

## Solucionar problemas de 'criar tabela' para conexões MySQL e Oracle

#### Em conexões MySQL, as tabelas não estão listadas depois de usar o SQL inicial para criar uma tabela

Depois de se conectar ao MySQL e executar uma instrução SQL inicial, as tabelas podem não ser exibidas devido à forma como o Tableau estrutura a consulta.

CREATE TABLE TestV1.testtable77(testID int);

Para solucionar esse problema, adicione `IF NOT EXISTS` à instrução SQL:

CREATE TABLE IF NOT EXISTS TestV1.TestTable(testID int);

#### Em conexões Oracle, usar o SQL inicial para criar uma tabela faz com que o Tableau pare

Depois que você se conecta ao Oracle e executa uma instrução SQL inicial, o Tableau fica com uma roda giratória devido à maneira como o Tableau estrutura a consulta.

CREATE TABLE TEST\_TABLE (TESTid int)

Para solucionar esse problema, use a seguinte instrução SQL:

BEGIN
EXECUTE IMMEDIATE 'create table test\_table(testID int)';
EXCEPTION
WHEN OTHERS THEN NULL;
END;

<!-- document id=7b30033b345bfe0f8c6449c02e052054f27e51fdffdfce918322b8eecdf7e6d8 url=/tableau/current/pt-br/server/backup_restore.md -->

[Pular para o conteúdo principal](#main-content)

# Executar um backup e uma restauração completos do Tableau Server

Use as seguintes etapas para fazer backup da sua implantação do Tableau Server. Especificamente, estas etapas descrevem como recuperar um clone de um servidor em uma coleção de dados e ativos de backup.

**Observação:** a execução do processo de backup pode demorar muito tempo. Como nenhum outro trabalho pode ser executado durante o backup, recomendamos que você execute o backup fora do horário comercial.

## Tipos de dados de backup

Há dois tipos de dados de backup que o Tableau Server pode gerar. Recomendamos realizar backups de cada tipo, caso você necessite restaurar um servidor em um cenário de recuperação:

- **Dados gerenciados pelo** Tableau Server**:** consistem no banco de dados ou repositório PostgreSQL e Armazenamento de arquivos do Tableau, que contém metadados da pasta de trabalho e do usuário, arquivos de extração de dados e dados de configuração do site. Quando você usa o TSM para criar um backup, tudo isso é salvo em um único arquivo criado com a extensão .tsbak. O backup desses dados é feito com o comando `[tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm)`.
    
    > [!IMPORTANT]
    > 
    > **Observação:** quando um armazenamento de arquivo externo é configurado, você não pode usar o comando `tsm maintenance backup` para fazer backup dos dados do Tableau Server. Para obter informações sobre como fazer backup desses dados, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm).
    
    - Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.
    - Você só pode restaurar um arquivo de backup para uma versão do Tableau Server que seja a mesma ou mais recente que a versão em que o backup foi criado. Você não pode restaurar para uma versão mais antiga do Tableau.
    - **Importante:** Se você fizer atualizações Azuis/Verdes ou atualizar manualmente o Tableau Server 2021.4 (ou anterior) usando o método de [manutenção tsm (backup e restauração)](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm) , você deverá habilitar`legacy-identity-mode` antes de poder restaurar para o Tableau Server 2022.1 (ou posterior). Para obter mais informações, consulte [Solucionar problemas com migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm).
    - A partir da versão 2022.3, não há suporte para backups criados usando tabadmin ("backups pré-TSM"). Você não pode restaurar um backup pré-TSM para Tableau Server versão 2022.3 ou posterior.
- Dados de configuração e de topologia: incluem a maioria das informações de configuração do servidor que são necessárias para a recuperação completa de um servidor. SMTP, alertas, alguns ativos de autenticação são exemplos de dados de configuração exportáveis para backup. Os dados de topologia definem como os processos do Tableau Server são configurados em implantações de servidor único e de vários nós. O backup dos dados de configuração e de topologia é feito com o comando `[tsm settings export](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm#TSMExport)`.

**Observação:** é possível alterar o valor padrão do caminho do arquivo usado pelo comando `[tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm)`. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

## Ativos de backup que necessitam de processo manual

Alguns dados de configuração não estão incluídos no comando `tsm settings export` e, portanto, devem ser documentados e restaurados manualmente. Os dados de configuração a seguir são excluídos da operação `tsm settings export`. O seu processo de manutenção de backup deve incluir a documentação dos seguintes dados de configuração do Tableau Server:

- Contas de usuário do sistema. A instalação do Tableau Server cria um usuário não privilegiado, `NetworkService`. Essa conta é usada para acessar os recursos do Tableau Server. Se você não a alterou, não precisa documentá-la.
- Configuração de implantação de serviço de coordenação. Se estiver executando em um cluster com vários nós, documente quais nós estão executando o processo de serviços de coordenação. Para visualizar a configuração do processo em seus nós, execute `tsm topology list-nodes -v`.
- Configurações de personalização Se a sua empresa usar um cabeçalho personalizado ou logotipos de logon para as páginas da Web do Tableau Server, inclua uma cópia desses ativos no seu portfólio de backup. Consulte [tsm customize](https://help.tableau.com/current/server/pt-br/cli_customize.htm).
- A maioria dos ativos de autenticação. Embora os locais dos arquivos possam ser incluídos em um arquivo exportado `settings.json`, a maioria dos arquivos de certificado, arquivos de chave, arquivos keytab ou outros ativos relacionados à autenticação não têm backup do TSM. Verifique se qualquer um desses ativos que você está tentando mover não precisará ser recriado.
    
    Existem três exceções:
    
    - O certificado público e a chave privada para o banco de dados PostgreSQL (se ativado) são copiados.
    - O certificado e a chave do SSL externo são copiados e incluídos nos dados de configuração.
    - O certificado personalizado instalado por [tsm security custom-cert add](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#custom-cert-add) (se adicionado) é copiado.
    
    No entanto, todos os outros ativos relacionados à autenticação não são salvos em um backup. Por exemplo, se você habilitou o acesso ao banco de dados PostgreSQL com o comando [tsm data-access repository-access enable](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#repository-access-enable), assegure-se de documentar os pares de nome/senha para cada conta configurada. Essas credenciais não são salvas no backup. O certificado e a chave do SSL mútuo não estão incluídos no backup.
- Ativos LDAP. O TSM não faz backup de arquivos keytab, arquivos de configuração ou outros ativos relacionados ao LDAP.

Os segredos do servidor interno e as senhas do repositório são configurações relacionadas à criptografia que não são exportadas. Entretanto, você não precisa documentar os valores de configuração. Novos segredos serão criados como parte do processo de restauração quando a nova instância for inicializada.

## Backup do Tableau Server para recuperação

O Tableau Server inclui comandos executados para gerar dados de backup para o Tableau Server.

Antes de fazer backup do Tableau Server, verifique se as permissões estão configuradas corretamente para os seguintes cenários:

- O Tableau Server instalado em uma unidade não padrão: se você tiver instalado o Tableau Server em uma unidade ou pasta não padrão, será necessário configurar manualmente as permissões para a conta de Serviço de rede. Talvez seja necessário configurar também permissões adicionais para a conta de serviço Run As. Consulte [Instalando em um local não padrão](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm#Installi).
- Ao fazer backup do Tableau Server no Windows para uma unidade de rede, a conta da Máquina deve ter acesso de gravação ao compartilhamento de rede onde os arquivos de backup são gravados (normalmente esse não é o caso e você é responsável fazer essa configuração, se quiser fazer backup do servidor para um compartilhamento de rede).

Para fazer backup dos dados de topologia e configuração do servidor, use o comando [tsm settings](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm).

1. Os dados de topologia e configuração são incluídos ao executar o comando `[tsm settings export](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm#TSMExport)`. Os dados são exportados como um arquivo json. Especifique o nome e a localização do arquivo json ao executar o seguinte comando:
    
    `tsm settings export -f <filename>.json`
    
    **Observação:** como o backup contém segredos, recomendamos que você criptografe o backup e o armazene em um local seguro. Para obter mais informações sobre os segredos do Tableau Server, consulte [Gerenciar segredos do servidor](https://help.tableau.com/current/server/pt-br/security_secret_storage.htm).
2. Backup dos dados do repositório e do Armazenamento de arquivos. O backup dos dados do repositório é feito com o comando `[tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm)`. Especifique o nome e a localização do arquivo de backup ao executar o seguinte comando:
    
    `tsm maintenance backup -f <filename>.tsbak -d`
    
    O arquivo de backup é reunido em um local temporário no diretório de dados e, em seguida, gravado no diretório definido na variável `basefilepath.backuprestore` do TSM. Como padrão:
    
    `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ```<filename>.tsbak`
    
    Para obter mais informações sobre os arquivos de backup e como alterar o local, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm). **Observação:** mesmo ao alterar o local do backup, o processo de backup usa um local temporário no diretório de dados para reunir o arquivo de backup.
    
    > [!IMPORTANT]
    > 
    > **Observação:** quando o Armazenamento de arquivos é configurado fora do Tableau Server, não é possível usar o comando tsm maintenance backup para fazer backup dos Dados do Tableau Server. Para obter mais informações sobre como fazer backup desses dados, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm).

## Restauração de uma funcionalidade do núcleo do Tableau Server

O procedimento abaixo usa os ativos das duas seções anteriores para reconstruir um Tableau Server em um cenário de recuperação.

**Observação**: se for necessário restaurar apenas o repositório em um Tableau Server que, fora isso, funcione normalmente, consulte [Restaurar de um backup](https://help.tableau.com/current/server/pt-br/db_restore.htm#db). Se você estiver executando uma implantação distribuída e o seu nó inicial falhou, consulte [Recuperação de falha no nó inicial](https://help.tableau.com/current/server/pt-br/distrib_ha_init_node_fail.htm).

Os seguintes ativos precisam estar disponíveis:

- Dados de topologia e configuração: é o arquivo json gerado pelo comando `tsm settings export`.
- Arquivo de backup de repositório: este é o arquivo com uma extensão .tsbak gerada pelo comando `tsm maintenance backup`.
    
    Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.
    
    Ao usar o `tsm maintenance restore` para restaurar os dados do Tableau, os arquivos de dados de extração e os conteúdos do banco de dados PostgreSQL são substituídos pelo conteúdo do arquivo de backup (`.tsbak`). Se você estiver executando uma instalação distribuída do Tableau Server, execute a restauração no nó que executa o Controlador TSM (geralmente é o nó inicial).
- Ativos de backup: esses ativos incluem a lista de configurações documentadas, conforme citado na seção anterior.

Para restaurar um Tableau Server independente

1. No computador onde deseja restaurar o Tableau Server, [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm). Se a sua empresa usou contas de usuário de sistema não padrão, conforme descrito no começo da seção deste tópico, será necessário especificar os usuários durante esta etapa.
2. [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm).
3. (Opcional). Configure o firewall local. Consulte "Configuração do firewall local" em [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm).
4. (Opcional). Verifique o LDAP.
5. Inicialize o Tableau Server. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).
6. Importe os dados de topologia e configuração. Copie o arquivo de backup json de topologia e configuração para o computador pessoal. Importe o arquivo de configuração executando o seguinte comando:
    
    `tsm settings import -f <filename>.json`
7. (Opcional). Aplique as alterações pendentes. Em um prompt de comando, execute:
    
    `tsm pending-changes apply`
8. Reinicie o Tableau Server. Em um prompt de comando, execute:
    
    `tsm restart`
9. Restaure os dados do repositório. Consulte [Restaurar de um backup](https://help.tableau.com/current/server/pt-br/db_restore.htm#db).

Para restaurar um cluster do Tableau Server

1. No nó inicial, [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm). Se a sua empresa usou contas de usuário de sistema não padrão, conforme descrito no começo da seção deste tópico, será necessário especificar os usuários durante esta etapa.
2. No nó inicial, [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm).
3. (Opcional). No nó inicial, configure o firewall local. Consulte "Configuração do firewall local" em [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm).
4. No nó inicial, verifique o LDAP (opcional) e inicialize o Tableau Server. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).
5. No nó inicial, execute `tsm topology nodes get-bootstrap-file --file <path\file>.json`.
6. Copie o arquivo bootstrap.json para todos os nós adicionais do cluster.
7. Em cada nó adicional do cluster, instale o pacote do Tableau Server.
8. No nó inicial, execute o `tsm topology list-nodes -v` e verifique se os nomes dos nós não foram alterados nas configurações de topologia exportadas. _Se os nomes dos nós foram alterados, as configurações de topologia devem ser atualizadas manualmente com novos nomes ou os processos devem ser configurados manualmente_.
9. O processo do Controlador do cluster é necessário em todos os nós e precisa ser adicionado explicitamente. A partir do nó inicial, adicione uma instância do Controlador do cluster a cada nó adicional, em que `<nodeID>` é a ID de um dos nós adicionais. Adicione o processo a cada nó separadamente. Neste exemplo, adicionamos o Controlador do cluster aos nós 2 e 3:
    
    tsm topology set-process -n node2 -pr clustercontroller -c 1
    tsm topology set-process -n node3 -pr clustercontroller -c 1
    tsm pending-changes apply
10. No nó inicial, [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm). A configuração de ensemble deve corresponder à sua configuração anterior.
11. No nó inicial, importe os dados de topologia e configuração. Copie o arquivo de backup json de topologia e configuração para o computador pessoal. Importe o arquivo de configuração executando o seguinte comando:
    
    `tsm settings import -f <filename>.json`
12. No nó inicial, aplique as alterações pendentes. Em um prompt de comando, execute:
    
    `tsm pending-changes apply`
13. No nó inicial, reinicie o Tableau Server. Em um prompt de comando, execute:
    
    `tsm restart`
14. No nó inicial, restaure os dados do repositório. Consulte [Restaurar de um backup](https://help.tableau.com/current/server/pt-br/db_restore.htm#db).

## Restaurar outra funcionalidade

Se o servidor anterior tiver sido configurado com os seguintes recursos, você precisará reabilitar e reconfigurá-los no servidor restaurado:

- **Soluções de autenticação:** SSL externo, OpenID, SAML (em todo o servidor e em nível de site) e autenticação confiável. Consulte [Autenticação](https://help.tableau.com/current/server/pt-br/security_auth.htm). Os arquivos de certificado, arquivos-chave e outros ativos dessas soluções não estão incluídos no backup e devem ser reconfigurados no servidor restaurado.
    
    - **Mais sobre SSL externo:** o certificado e a chave para SSL externo estão incluídos nos dados de configuração de backup e são restaurados automaticamente. No entanto, você deve reativar e reconfigurar o SSL externo no servidor restaurado. Consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm).
    - **Mais sobre SAML:** cconsulte o artigo de conhecimento sobre a reconfiguração do SAML após uma restauração - [“Incapaz de iniciar o Tableau Server devido ao erro ‘Falha ao carregar a chave privada SP da nossa configuração SAML’ após a restauração do backup completo”](https://help.salesforce.com/s/articleView?id=001475210&type=1).
- **Personalizações do site:** consulte [tsm customize](https://help.tableau.com/current/server/pt-br/cli_customize.htm).
- **Para habilitar o acesso ao repositório do PostgreSQL:** consulte [tsm data-access repository-access enable](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#repository-access-enable).

## Criptografe novamente as extrações após a restauração

Opcionalmente, se estiver usando o recurso de criptografia de extração em repouso, depois que o backup for restaurado, você poderá criptografar novamente as extrações usando chaves de criptografia diferentes. Consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

Execute o `tabcmd reencryptextracts <site-name>` para criptografar novamente as extrações em determinado site. Para obter mais informações, consulte [reencryptextracts](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#reencryptextracts_tabcmd). Execute esse comando em cada site que armazena extrações criptografadas. Dependendo do número de extrações criptografadas no site, essa operação pode consumir uma carga significativa de processamento de servidor. Considere executar essa operação fora do horário comercial.

<!-- document id=6803c375f062a804840fa21a76e78e970a61512c9ef303b00b65d5a4dec739ce url=/tableau/current/pt-br/server/config_file_example.md -->

[Pular para o conteúdo principal](#main-content)

# Exemplo de arquivo de configuração

Este artigo fornece um exemplo de arquivo de configuração JSON completo, com entidades gatewaySettings e identityStore especificadas. Além disso, uma chave de configuração define o tempo limite do gateway como 900 segundos.

O arquivo de configuração pode ser diferente dependendo das opções que precisam ser configuradas.

Durante a instalação, é possível definir vários arquivos de configuração .json. Para definir os valores de cada arquivo no Tableau Server, o seguinte comando deve ser executado uma vez para cada arquivo de configuração:

`tsm settings import -f path-to-file.json`

Depois de definir os arquivos de configuração, execute [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply) para aplicar as alterações a todos os arquivos .json definidos.

{
   "configEntities": {
      "gatewaySettings": {
         "\_type": "gatewaySettingsType",
         "port": 80,
         "publicHost": "localhost",
         "publicPort": 80
      },
      "identityStore": {
         "\_type": "identityStoreType",
         "type": "local",
         "domain": "example.lan",
         "nickname": "EXAMPLE"
      }
    },
     "configKeys": {
        "gateway.timeout": "900"
     }
}

## Entidades e chaves

Como demonstrado no exemplo acima, existem duas classes de parâmetros de configuração: configEntities e configKeys.

**configEntities**

Alguns tipos de configurações são executadas por meio de conjuntos de entidades mapeados para cenários específicos, como o repositório de identidades e as configurações de gateway. Ao passar um conjunto de configEntities com o comando `tsm settings import -f path-to-file.json`, TSM valida da configuração. Se os valores passados forem inválidos, o TSM apresentará um erro. Isso permite a realização de alterações durante o processo de configuração em vez de verificar uma falha de configuração durante a inicialização ou o tempo de execução.

As entidades podem ser definidas somente ao incluir um bloco configEntities em um arquivo .json.

**Importante**: todos os arquivos referenciados em configEntities devem estar no computador local. Não especifique caminhos UNC.

configKeys

As entidades cobrem somente uma pequena parte dos valores de configuração que podem ser definidos. Centenas de chaves correspondem aos parâmetros armazenados em arquivos .yml. O Tableau Server usa esses parâmetros para armazenar todas as informações de configuração para todos os serviços.

As chaves individuais podem ser definidas com o comando [tsm configuration](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm). Entretanto, durante a implantação, é mais conveniente configurá-las com outros cenários de configuração em arquivos JSON, como mostrado acima.

Diferente das configEntities, as configKeys não são validadas.

**Observação:** não é recomendado definir parâmetros não documentados em [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

<!-- document id=9c7b5c01c5201abcb24a5b51c137e023b08c43ab005ab8580fa12a15d03f6e9d url=/tableau/current/pt-br/server/ssl_cert_create.md -->

[Pular para o conteúdo principal](#main-content)

# Exemplo: Certificado SSL - Gerar uma chave e CSR

Importante: este exemplo tem por objetivo oferecer direções gerais a profissionais de TI experientes com requisitos e configuração de SSL. O procedimento descrito neste artigo é um dos vários métodos disponíveis que podem ser usados para gerar os arquivos exigidos. O processo descrito aqui deve ser tratado como um exemplo e não como uma recomendação.

* * *

Ao configurar o Tableau Server para que ele use a criptografia Secure Sockets Layer (SSL), isso o ajuda a garantir que o acesso ao servidor seja seguro, e que os dados enviados entre o Tableau Server e o Tableau Desktop estejam protegidos.

Procurando o Tableau Server no Linux? Consulte [Exemplo: Certificado SSL - Gerar uma chave e CSR](https://help.tableau.com/current/server-linux/pt-br/ssl_cert_create.htm "Abre o tópico em uma nova guia do navegador").

O Tableau Server usa o Apache, que inclui [OpenSSL](http://www.openssl.org/). Use o kit de ferramentas OpenSSL para gerar um arquivo chave e o Certificate Signing Request (Solicitação de assinatura de certificado, CSR) que podem ser usados para obter um certificado SSL assinado.

As versões 2022.1.17, 2022.3.9, 2023.1.5 e 2025.1.x do Tableau Server executam o OpenSSL 3.1.

**Importante:** a partir da versão 2025.2 (Tableau Desktop), 2025.3 (Tableau Server) e de junho de 2025 (Tableau Cloud), o Tableau usa OpenSSL 3.4.x e segurança de nível 2. A segurança de nível 2 requer chaves de 2048 bits ou mais. Todas as chaves de segurança de nível 1 existentes não funcionarão mais e você precisará gerar e implantar um novo par de chaves. Se você estiver gerando chaves com pelo menos 2048 bits, conforme recomendado, nenhuma ação será necessária. Para obter mais informações, consulte [Gerar uma chave](#generate-key).

## Etapas para gerar uma chave e CSR

Para configurar o Tableau Server para que use SSL, é necessário ter um certificado SSL. Para obter o certificado SSL, conclua estas etapas:

1. [Definir a variável do ambiente de configuração OpenSSL (opcional).](#Set)
2. [Gerar um arquivo chave](#generate-key).
3. [Criar uma Solicitação de Assinatura de Certificado (CSR)](#generate-csr).
4. [Enviar o CSR a uma autoridade de certificação (CA) para obter o certificado SSL](#send-csr).
5. [Usar a chave e o certificado para configurar o Tableau Server para usar SSL](#config-server).

É possível encontrar informações adicionais na [página de Perguntas Frequentes do SSL](http://httpd.apache.org/docs/2.2/ssl/ssl_faq.html#realcert) no site da Apache Software Foundation.

### Configurar um certificado para vários nomes de domínio

O Tableau Server habilita o SSL para vários domínios. Para configurar esse ambiente, é necessário modificar o arquivo de configuração OpenSSL, openssl.conf, e configurar um certificado Subject Alternative Name (SAN) no Tableau Server. Consulte [Para certificados SAN: modifique o arquivo de configuração OpenSSL](#san-certs) a seguir.

### Definir a variável do ambiente de configuração OpenSSL (opcional)

Para evitar usar o argumento `-config` com cada uso do openssl.exe, é possível usar a variável de ambiente `OPENSSL_CONF`, para garantir que o arquivo de configuração correto seja usado e que todas as alterações de configuração feitas em procedimentos subsequentes neste artigo gerem os resultados esperados (por exemplo, é preciso definir a variável de ambiente para adicionar um SAN ao seu certificado).

Abra um prompt de comando como um administrador e execute o seguinte comando:

`set OPENSSL_CONF=c:\Program Files\Tableau\Tableau Server\packages\apache.<version_code>\conf\openssl.cnf`

**Observação**: ao definir a variável do ambiente de configuração Open SSL, não coloque o caminho do arquivo entre aspas.

### Gerar uma chave

Gere um arquivo de chave que será usado para gerar um pedido de assinatura de certificado.

1. Abra o prompt de comando como administrador, e navegue pelo diretório **Apache** do Tableau Server. Por exemplo, execute o comando a seguir:
    
    `cd C:\Program Files\Tableau\Tableau Server\packages\apache.<version_code>\bin`
2. Execute o comando a seguir para criar o arquivo chave:
    
    `openssl.exe genrsa -out <yourcertname>.key 4096`.
    
    **Observações:**
    
    - este comando usa um comprimento de 4096 bits para a chave. Escolha um comprimento de bit com, no mínimo, 2048 bits, pois a comunicação criptografada com um comprimento de bit menor é menos segura. Se um valor não for proporcionado, 512 bits é usado.
    - Para criar chaves RSA PKCS#1 com as versões 2021.3.26, 2021.4.21, 2022.1.17, 2022.3.9, 2023.1.5 e posteriores do Tableau Server, você deve usar a opção adicional `-traditional` ao executar o comando `openssl genrsa` baseado no OpenSSL 3.1. Para obter mais informações sobre as opções, consulte [https://www.openssl.org/docs/man3.1/man1/openssl-rsa.html](https://www.openssl.org/docs/man3.1/man1/openssl-rsa.html).

### Criar uma solicitação de assinatura de certificado a ser enviada a uma autoridade de certificação

Use o arquivo de chave criado com o procedimento acima para gerar a Certificate Signing Request (Solicitação de Assinatura de Certificado, CSR). Envie o CSR para uma autoridade de certificação (CA) para obter o certificado assinado.

**Importante:** se deseja configurar um certificado SAN para usar o SSL em vários domínios, primeiro conclua as etapas na seção [Para certificados SAN: modifique o arquivo de configuração do OpenSSL](#san-certs) e, em seguida, retorne a essa etapa para gerar um CSR.

1. Execute o comando a seguir para criar um arquivo de certificate signing request (solicitação de assinatura de certificado, CSR):
    
    `openssl.exe req -new -key yourcertname.key -out yourcertname.csr`.
    
    Se a variável do ambiente de configuração OpenSSL não foi definida,`OPENSSL_CONF`, uma das mensagens a seguir poderão aparecer:
    
    - Uma mensagem de erro sobre a falha no carregamento das informações de configuração. Neste caso, redigite o comando acima com o seguinte parâmetro:`-config ..\conf\openssl.cnf`.
    - Um aviso que o diretório `/usr/local/ssl` não pôde ser encontrado. Este diretório não existe no Windows, basta ignorar esta mensagem. O arquivo será criado com sucesso.
    
    Para definir uma variável de ambiente de configuração OpenSSL, consulte a seção [Definir a variável do ambiente de configuração OpenSSL (opcional)](#Set) neste artigo.
2. Quando solicitado, insira as informações obrigatórias.
    
    **Observação:** para **Nome comum**,digite o nome do Tableau Server. O nome do Tableau Server é a URL que será usada para acessar o Tableau Server. Por exemplo, se o Tableau Server for acessado ao digitar `tableau.example.com` na barra de endereços do navegador, então o `tableau.example.com` é o nome comum. Se o nome comum não coincidir com o nome do servidor, haverá erros quando um navegador ou o Tableau Desktop tentar conectar-se ao Tableau Server.

### Enviar o CSR a uma autoridade de certificação para obter o certificado SSL

Envie o CSR a um certificate authority (autoridade de certificação, CA) comercial para solicitar o certificado digital. Para informações, consulte o artigo da Wikipedia [Autoridade de certificação](http://en.wikipedia.org/wiki/Certificate_authority) e outros artigos relacionados que possam ajudá-lo a decidir qual CA usar.

### Usar a chave e o certificado para configurar o Tableau Server

Quando você tem a chave e o certificado da CA, pode configurar o Tableau Server para usar o SSL. Para ver as etapas, consulte [Configurar SSL externo](https://help.tableau.com/current/server/pt-br/ssl_config.htm).

## Para certificados SAN: modifique o arquivo de configuração do OpenSSL

Na instalação padrão do OpenSSL, alguns recursos não são habilitados por padrão. Para usar o SSL com vários nomes de domínio, antes de gerar o CSR, complete estas etapas para modificar o arquivo **openssl.cnf**.

1. Abra o Windows Explorer e navegue até a pasta **conf** do Apache para o Tableau Server.
    
    Por exemplo: `C:\Program Files\Tableau\Tableau Server\packages\apache.<version_code>\conf`
2. Abra **openssl.cnf** em um editor de texto e encontre a seguinte linha: `req_extensions = v3_req`
    
    Esta linha pode ter recebido comentários com o sinal (#) no início.
    
    ![O código demonstra como definir extensões a serem adicionadas a uma solicitação de certificado.](/tableau/current/pt-br/server/pt-br/Img/creating-ssl-cert-and-key1.png)
    
    Se a linha tiver comentários, retire-os apagando os caracteres **#** e **espaço** do começo da linha.
3. Vá até a seção **\[ v3\_req \]** do arquivo. As primeiras linhas apresentam o seguinte texto:
    
    `# Extensions to add to a certificate request`.  
    `basicConstraints = CA:FALSE   keyUsage = nonRepudiation, digitalSignature, keyEncipherment`
    
    Após a linha **keyUsage**, insira a seguinte linha:
    
    `subjectAltName = @alt_names`.
    
    Se você estiver criando um certificado SAN autoassinado, faça o seguinte para conceder a permissão de assinatura no certificado:
    
    1. Añada <code>`cRLSign`</code> y <code>`keyCertSign`</code> a la línea <strong>**keyUsage**</strong> del siguiente modo: `keyUsage = nonRepudiation, digitalSignature, keyEncipherment, cRLSign, keyCertSign`
    2. Após a linha **keyUsage**, insira a seguinte linha:`subjectAltName = @alt_names`
4. Na seção **\[alt\_names\]**, forneça os nomes de domínio que deseja usar com o SSL.
    
    `DNS.1 = [domain1]`.  
    `DNS.2 = [domain2]   DNS.3 = [etc]`
    
    A imagem a seguir mostra os resultados em destaque, com o texto de marcação que seria substituído pelos seus nomes de domínio.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/creating-ssl-cert-and-key2.png)
5. Salve e feche o arquivo.
6. Conclua as etapas na seção acima [Criar uma solicitação de assinatura de certificado a ser enviada a uma autoridade de certificação](#generate-csr).

## Informações adicionais

Caso prefira usar uma versão diferente do OpenSSL, faça o download em [Open SSL for Windows](http://gnuwin32.sourceforge.net/packages/openssl.htm).

<!-- document id=58dc7768508aa9bf99680399f2af76e67166e206f8002228093199da352613d3 url=/tableau/current/pt-br/server/distrib_ha_install_3node.md -->

[Pular para o conteúdo principal](#main-content)

# Exemplo: Instalar e configurar um cluster HA de três nós

Uma instalação de alta disponibilidade de vários nós do Tableau Server pode ajudar a maximizar a disponibilidade do Tableau Server. Ao configurar uma implantação de vários nós do Tableau Server, todas as etapas executadas são projetadas para integrar redundância, ajudando a reduzir o tempo de inatividade possível. Além de aprimorar a eficiência ao mover ou adicionar processos de servidor a nós adicionais, é possível criar uma instalação de alta disponibilidade (HA) do Tableau Server ao satisfazer os requisitos a seguir:

- Adicione nós adicionais, com um total de ao menos três nós
- Implante um ensemble do Serviço de coordenação em, no mínimo, três nós
- Adicione uma instância do CFS (Serviço de arquivo do cliente) em pelo menos um nó adicional (recomendamos adicionar uma instância em cada nó executando o Serviço de coordenação)
- Adicione uma segunda instância de Armazenamento de arquivo em um dos nós adicionais (O processador de dados será instalado automaticamente, se ele ainda não estiver no nó)
- Adicione uma segunda instância do repositório (pgsql) em um dos nós adicionais

Uma instalação do Tableau Server que inclui essas adições terão redundância integrada e suportarão failover caso haja um problema no repositório. Este exemplo mostra como fazer isso e muito mais.

## Um sistema de servidor único

Após instalar o Tableau Server neste nó inicial, você terá um sistema executando tudo que precisa para funcionar. Ele tem, pelo menos, uma instância de todos os processos do servidor e é a configuração mais básica do Tableau Server. Ela não tem nenhuma redundância. A topologia do servidor se parece com isso (alguns processos específicos de TSM não são mostrados):

![Um diagrama ilustra uma configuração de servidor de nó único.](/tableau/current/pt-br/server/pt-br/Img/baseline_config_onenode1_200x1028.png)

## Um sistema de três nós

Para criar redundância, você precisa adicionar mais nós para hospedar instâncias dos processos do repositório e do processador de dados/armazenamento de arquivo. Você pode adicionar instâncias de outros processos, incluindo várias instâncias de um processo em um nó. Além disso, para reduzir a vulnerabilidade do sistema, você pode executar vários gateways e instâncias adicionais de alguns dos processos do servidor. O número mínimo de computadores necessários para alcançar essa configuração é três.

No diagrama abaixo, o processo de armazenamento do arquivo foi adicionado ao nó inicial e colocado em ambos nós adicionais. Uma segunda instância passiva do repositório também foi adicionada àquela dos outros nós novos. Finalmente, os processos de servidor (mostrados em azul) foram adicionados aos nós adicionais para fornecer redundância.

![Um diagrama ilustra uma configuração de servidor de três nós.](/tableau/current/pt-br/server/pt-br/Img/baseline_config_ha_tsm1.png)

## Etapas de configuração

Este procedimento descreve como configurar um cluster do Tableau Server de HA de três nós com duas instâncias de repositório e duas instâncias de armazenamento de arquivo/processador de dados nos nós adicionais, conforme descrito acima.

## Antes de começar

Antes de instalar o Tableau Server em quaisquer nós adicionais, tenha certeza de que cada nó adicional atende aos requisitos distribuídos. Consulte [Requisitos distribuídos](https://help.tableau.com/current/server/pt-br/distrib_requ.htm) para obter detalhes.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

### Etapa 1: instalar o nó inicial

Consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).

### Etapa 2: gerar um arquivo de bootstrap para os nós adicionais

1. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração e, na caixa Adicionar um nó, clique em Baixar arquivo bootstrap.
    
    ![Uma lista de processos e o número de instâncias em uma implantação do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-linux-generate-bootstrap.png)
    
    O arquivo bootstrap é criado e copiado no computador local.
    
    As credenciais inseridas são incluídas no arquivo bootstrap, por padrão. Se você não quiser credenciais inseridas no arquivo bootstrap, desmarque a opção Incluir credenciais temporárias no arquivo. Se você quiser desabilitar completamente a capacidade de incluir credenciais inseridas nos arquivos bootstrap de nó, defina uma opção de configuração para o servidor. Consulte [features.PasswordlessBootstrapInit](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#pwdlessbootstrap) para obter mais detalhes.

### Etapa 3: instalar e inicializar o nó 2

1. Copie o instalador original usado no primeiro computador, juntamente ao arquivo bootstrap gerado e coloque-os em um local acessível do novo computador no qual o Tableau Server está sendo adicionado. Isso pode ser um compartilhamento de rede montado, ou diretamente no computador.
2. Se estiver executando um firewall local, será necessário configurar as regras de firewall para todos os nós no cluster. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall).
3. No novo nó, execute o programa de instalação do Tableau Server. Esse deve ser o mesmo programa de instalação executado no nó inicial para instalar o Tableau Server. Aceite os termos do contrato de licença e clique em **Avançar**.
4. O local de instalação deve ser o mesmo em todos os nós.
    
    Insira o local de instalação ou clique em Procurar para navegar até o local de instalação. Clique em **Próximo** para continuar.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/tsm-install-path.png)
5. Durante a instalação, você será solicitado a selecionar um tipo de instalação.
    
    Selecione Incluir nó adicional ao cluster do Tableau Server existente Clique em Próximo para continuar.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/tsm-install-type-additional.png)
6. A opção **Usar ATR para ativação do produto** definida para o Nó 1 será selecionada automaticamente:
    
    **Importante:** a partir da versão 2025.1.0, esta tela não será mais exibida. O serviço ATR é usado por padrão. Se você quiser usar o serviço de licenciamento legado, deverá instalar o Tableau Server a partir da linha de comando usando o `ACTIVATIONSERVICE` alterne para especificar a opção não padrão. Para obter mais informações, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm)
    
    ![](/tableau/current/pt-br/server/pt-br/Img/tsm-install-activation-type-additional.png)
    
    Clique em **Instalar** para continuar.
    
    Se o prompt do Windows Defender Firewall for exibido, clique em Permitir acesso. Pode ser necessário fazer isso várias vezes para que a instalação seja concluída.
7. No instalador, depois que os arquivos do Tableau Server forem copiados, você será solicitado a fornecer o arquivo bootstrap e o nome e a senha do administrador do TSM:
    
    ![Uma janela de configuração com campos em branco para o arquivo de Bootstrap, o nome de usuário do TSM e a senha do TSM.](/tableau/current/pt-br/server/pt-br/Img/tsm-installer-node-config.png)
    
    Insira o local do arquivo de inicialização ou clique em Procurar para navegar até o local. Se o arquivo de bootstrap não incluir credenciais inseridas ou se essas credenciais expiraram, digite o nome de usuário e a senha do administrador do TSM. Essas credenciais devem ser as do usuário usado durante o processo de instalação no nó inicial.
    
    Clique em Próximo para continuar.
8. Uma janela do navegador é aberta e você é solicitado a fazer logon no TSM. Insira o nome de usuário e a senha do administrador do TSM.
    
    Se nenhuma janela do navegador for aberta automaticamente, abra uma janela e navegue até o TSM:
    
    `https://<tsm-computer-name>:8850`
9. No TSM, clique em Configuração.
    
    Uma mensagem é exibida, informando que o nó foi adicionado:
    
    ![Mensagem indicando que um novo nó foi adicionado a um cluster no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-node-added.png)
10. Clique em Continuar.

### Etapa 4: instalar e inicializar o nó 3

Repita a Etapa 3 acima.

### Etapa 5: configurar o novo nó com uma topologia mínima

Para concluir o processo de adicionar novos nós ao cluster, é necessário configurá-los com uma topologia mínima. Com uma topologia mínima, a única alteração pendente será a adição do Controlador de cluster, que é necessário em cada nó. Se quiser outros processos nos nós, você pode adicionar a maioria deles ao mesmo tempo. Esse exemplo apenas configura os nós com o Controlador de cluster.

1. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração. Uma mensagem deve informar que novos nós foram adicionados.
    
    ![Mensagem indicando que um novo nó foi adicionado a um cluster no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-node-added.png)
    
    Clique em Continuar para descartar a mensagem.
3. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
    
    Se você estiver configurando um cluster de três ou mais nós, um aviso de ensemble do Serviço de coordenação será exibido. Você pode continuar. Você implantará um ensemble do Serviço de coordenação em uma etapa separada.
4. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.
    
    Quando o Tableau Server é reiniciado, os nós são incluídos com a topologia mínima necessária.

### Etapa 6: implantar um ensemble do Serviço de coordenação

Se instalar um total de três ou mais nós, implante também um ensemble do Serviço de coordenação. Se não fizer isso, receberá uma mensagem de aviso sempre que fizer alterações na configuração ou na topologia do servidor. É possível ignorar esta mensagem, mas, como uma prática recomendada, você deve implantar um ensemble do Serviço de coordenação para vários nós.

Ao instalar o Tableau Server, uma única instância do Serviço de coordenação é instalada no nó inicial. O TSM e o Tableau Server dependem do Serviço de coordenação para funcionarem adequadamente. Sendo assim, de forma a fornecer redundância e garantir disponibilidade nas instalações de vários nós, configure instâncias adicionais do Serviço de coordenação ao implantar um ensemble do Serviço de coordenação. Os ensembles do Serviço de coordenação estão instalados com uma, três ou cinco instâncias do Serviço de coordenação. Em uma instalação de três nós do Tableau Server, o número recomendado de instâncias do Serviço de coordenação é três: um em cada nó.

Não tente implantar um ensemble do Serviço de coordenação se houver outras mudanças pendentes. Descarte ou aplique quaisquer alterações pendentes antes de implantar um novo ensemble do Serviço de coordenação.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

As etapas a seguir mostram como implantar um novo ensemble do Serviço de coordenação em um cluster de três nós do Tableau Server já existente, assim como limpar o ensemble antigo.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Interrompa o Tableau Server:
    
    `tsm stop`
    
    Se solicitado, faça logon como administrador do TSM.
    
    Alguns processos do TSM permanecerão em execução, inclusive o Controlador de administração e o Agente de administração.
3. Confirme que não há alterações pendentes:
    
    `tsm pending-changes list`
    
    Se houver alterações pendentes, você precisará descartá-las ou aplicá-las. A aplicação de alterações pendentes levará algum tempo:
    
    - Descartar as alterações
        
        tsm pending-changes discard
    
    ou
    
    - Aplique as alterações:
        
        tsm pending-changes apply
    
    Aguarde até que o comando seja concluído e você retorne ao prompt do sistema.
4. Obtenha as IDs de cada nó no cluster:
    
    `tsm topology list-nodes -v`
5. Use o comando `tsm topology deploy-coordination-service` para adicionar um novo ensemble do Serviço de coordenação ao adicioná-lo a nós específicos. Você deve especificar o(s) nó(s) ao(s) qual(is) o Serviço de Coordenação deve ser adicionado, usando a ID do nó real para identificar cada nó. O comando também torna o ensemble de “produção” (o ensemble em uso) no ensemble novo e remove o antigo, a menos que a implantação falhe. Se isso acontecer, veja a etapa 6 abaixo.
    
    **Observação:**um prompt "y/n” é exibido, confirmando que uma reinicialização do servidor ocorrerá. Para executar o comando sem entrada, inclua a opção `--ignore-prompt`.
    
    Por exemplo, implante o Serviço de coordenação em todos os nós de um cluster de três nós, sendo eles: nó1, nó2, nó3
    
    `tsm topology deploy-coordination-service -n node1,node2,node3`
    
    Aguarde até que o comando seja concluído e você retorne ao prompt do sistema.
6. (Opcional) Se a implantação falhar, você precisa executar o comando `tsm topology cleanup-coordination-service` para remover o conjunto implantado sem sucesso. Para obter detalhes sobre a execução do comando, consulte [tsm topology cleanup-coordination-service](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMCleanupCoordination).
7. Inicie o Tableau Server:
    
    `tsm start`

Para obter mais informações e detalhes sobre a implantação de um novo ensemble do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

### Etapa 7: configure o CFS (Serviço de arquivo do cliente) em nódulos adicionais

Adicione o CFS em nós adicionais. Recomendamos que você adicione o CFS a cada nó que executa o Serviço de coordenação.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó ao qual você está adicionando o CFS:
    
    `tsm topology list-nodes -v`
3. Adicione o CFS ao nó especificando o nó, o processo e uma única instância.
    
    Por exemplo, este comando adiciona uma instância do CFS ao node2:
    
    `tsm topology set-process -n node2 -pr clientfileservice -c 1`
    
    Se você tentar adicionar uma instância do CFS a um nó que já foi configurado com o CFS, uma mensagem de erro informará que já existe uma instância no nó.
    
    Para adicionar o CFS a outros nós, repita essa etapa para cada nó.
4. Aplique as alterações:
    
    `tsm pending-changes apply`

### Etapa 8: configurar processos para o nó 2

1. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração.
3. Especifique os processos e número de instâncias que devem ser executados no primeiro nó adicional.
    
    Neste exemplo:
    
    1. Selecione Gateway.
    2. Defina a contagem do Servidor de aplicativos (vizportal) como 2.
    3. Defina a contagem do VizQL Server como 2.
    4. Defina a contagem do Servidor cache como 2.
    5. Defina a contagem do Processador em segundo plano como 2.
        
        Adicionar o processador em segundo plano a um nó também adicionará uma instância do processador de dados caso ainda não exista uma no nó.
    6. Defina a contagem do Servidor Dados como 2.
    7. Selecionar Armazenamento de arquivo.
    8. Selecione Repositório (pgsql).
    9. Selecione Serviço de Métricas. (O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm).)
    10. Selecione Serviço de mensagens.
    11. Selecione Propriedades da fonte de dados.
    12. Selecione Serviço de exploração de conteúdo.
    13. Selecione Serviço de coleta.
    14. Selecione Search and Index Server.
    
    Os processos específicos e as contagens de processos definidos dependerão do ambiente e das necessidades organizacionais. Ao adicionar um outro processo, alguns processos são adicionados automaticamente. Para obter mais informações, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm) e [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).
    
    **Observação:** a interface de usuário na Web do TSM limita a um máximo de 8 instâncias de processos que permitem selecionar o número de instâncias. Para configurar mais instâncias, use a linha de comando e o comando `TSM topology set-process` . Para obter mais informações, consulte [tsm topology set-process](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess).

### Etapa 9: configurar processos para o nó 3

1. No TSM, na guia Configuração, especifique os processos e número de instâncias que devem ser executados no primeiro nó adicional.
    
    Neste exemplo:
    
    1. Selecione Gateway.
    2. Defina a contagem do Servidor de aplicativos (vizportal) como 2.
    3. Defina a contagem do VizQL Server como 2.
    4. Defina a contagem do Servidor cache como 2.
    5. Defina a contagem do Processador em segundo plano como 2.
        
        Adicionar o processador em segundo plano a um nó também adicionará uma instância do processador de dados caso ainda não exista uma no nó.
    6. Defina a contagem do Servidor Dados como 2.
    7. Selecionar Armazenamento de arquivo.
    8. Selecione Serviço de Métricas. (O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm).)
    9. Selecione Propriedades da fonte de dados.
    10. Selecione Serviço de exploração de conteúdo.
    11. Selecione Serviço de coleta.
    12. Selecione Search and Index Server.
2. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
    
    A lista Alterações pendentes é exibida.
3. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.

**Observação:** esse método de instalação a partir da linha de comando requer que você defina as variáveis de ambiente do Windows em cada nó adicional para o nome de usuário e senha de um administrador no nó inicial. Para obter um método de automação alternativo da instalação do Tableau Server sem a inclusão de credenciais codificadas, consulte [Instalação automatizada do Tableau Server](https://help.tableau.com/current/server/pt-br/automated_install_windows.htm).

### Etapa 1: instalar o nó inicial

Consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).

### Etapa 2: gerar um arquivo de bootstrap para os nós adicionais

Para instalar o Tableau Server em mais computadores, use o mesmo instalador usado no nó inicial e o arquivo "bootstrap" gerado no nó inicial.

**Importante**: o arquivo do bootstrap contém uma cópia do arquivo do repositório de chaves principal, usado para criptografar os segredos da configuração. O arquivo também pode ter credenciais inseridas válidas por um período predeterminado (consulte [tabadmincontroller.auth.expiration.minutes](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#tabadminctrlrauthexpire)) e servir como um cookie de sessão. Recomendamos fortemente que você tome medidas adicionais para proteger o arquivo bootstrap.

1. Após instalar o Tableau Server no nó inicial, gere o arquivo bootstrap do nó.
2. No nó inicial, abra um prompt de comando como um administrador.
3. Digite este comando para gerar o arquivo bootstrap:
    
    `tsm topology nodes get-bootstrap-file --file <path\file>.json`
    
    As credenciais inseridas são incluídas no arquivo bootstrap, por padrão. Se você não quiser que o arquivo bootstrap inclua credenciais, use a opção `-nec` ou `--no-embedded-credentials`:
    
    `tsm topology nodes get-bootstrap-file --file <path\file>.json --no-embedded-credentials`.
    
    Se você quiser desabilitar completamente a capacidade de incluir credenciais inseridas nos arquivos bootstrap de nó, defina uma opção de configuração para o servidor. Consulte [features.PasswordlessBootstrapInit](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#pwdlessbootstrap) para obter mais detalhes.

### Etapa 3: instalar e inicializar o nó 2

1. Copie o instalador original usado no primeiro computador, juntamente ao arquivo bootstrap gerado e coloque-os em um local acessível do novo computador no qual o Tableau Server está sendo adicionado. Isso pode ser um compartilhamento de rede montado, ou diretamente no computador.
2. Se estiver executando um firewall local, será necessário configurar as regras de firewall para todos os nós no cluster. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall).
3. No novo nó, execute o programa de instalação do Tableau Server. Esse deve ser o mesmo programa de instalação executado no nó inicial para instalar o Tableau Server.
    
    TableauServer-64bit-<version>.exe /silent ACCEPTEULA=1 EMBEDDEDCREDENTIAL=1 BOOTSTRAPFILE="path\\bootstrapfile"
    
    Para obter mais informações sobre os switches que você pode usar com o Programa de instalação, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm).

### Etapa 4: instalar e inicializar o nó 3

Instale o Tableau Server no nó 3:

1. Copie o instalador original usado no primeiro computador, juntamente ao arquivo bootstrap gerado e coloque-os em um local acessível do novo computador no qual o Tableau Server está sendo adicionado. Isso pode ser um compartilhamento de rede montado, ou diretamente no computador.
2. Se estiver executando um firewall local, será necessário configurar as regras de firewall para todos os nós no cluster. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall).
3. No novo nó, execute o programa de instalação do Tableau Server. Esse deve ser o mesmo programa de instalação executado no nó inicial para instalar o Tableau Server.
    
    TableauServer-64bit-<version>.exe /silent ACCEPTEULA=1 EMBEDDEDCREDENTIAL=1 BOOTSTRAPFILE="path\\bootstrapfile"
    
    Para obter mais informações sobre os switches que você pode usar com o Programa de instalação, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm).

### Etapa 5: adicionar um processo aos nós adicionais

1. No nó inicial, configure uma instância do controlador do cluster em cada nó adicional.
    
    `tsm topology set-process -n <nodeID_second-node> -pr clustercontroller -c 1`
    
    `tsm topology set-process -n <nodeID_third-node> -pr clustercontroller -c 1`
2. Aplique as alterações na configuração do nó:
    
    ```
    tsm pending-changes apply --ignore-warnings
    ```
    
    Um aviso sobre a implantação de um ensemble do Serviço de coordenação aparece porque você implantou um cluster de três nós. Use a opção `--ignore-warnings` para aplicar as alterações na configuração apesar do aviso. Você implantará um novo ensemble do Serviço de coordenação na próxima etapa.

### Etapa 6: implantar um ensemble do Serviço de coordenação

Se instalar um total de três ou mais nós, implante também um ensemble do Serviço de coordenação. Se não fizer isso, receberá uma mensagem de aviso sempre que fizer alterações na configuração ou na topologia do servidor. É possível ignorar esta mensagem, mas, como uma prática recomendada, você deve implantar um ensemble do Serviço de coordenação para vários nós.

Ao instalar o Tableau Server, uma única instância do Serviço de coordenação é instalada no nó inicial. O TSM e o Tableau Server dependem do Serviço de coordenação para funcionarem adequadamente. Sendo assim, de forma a fornecer redundância e garantir disponibilidade nas instalações de vários nós, configure instâncias adicionais do Serviço de coordenação ao implantar um ensemble do Serviço de coordenação. Os ensembles do Serviço de coordenação estão instalados com uma, três ou cinco instâncias do Serviço de coordenação. Em uma instalação de três nós do Tableau Server, o número recomendado de instâncias do Serviço de coordenação é três: um em cada nó.

Não tente implantar um ensemble do Serviço de coordenação se houver outras mudanças pendentes. Descarte ou aplique quaisquer alterações pendentes antes de implantar um novo ensemble do Serviço de coordenação.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

As etapas a seguir mostram como implantar um novo ensemble do Serviço de coordenação em um cluster de três nós do Tableau Server já existente, assim como limpar o ensemble antigo.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Interrompa o Tableau Server:
    
    `tsm stop`
    
    Se solicitado, faça logon como administrador do TSM.
    
    Alguns processos do TSM permanecerão em execução, inclusive o Controlador de administração e o Agente de administração.
3. Confirme que não há alterações pendentes:
    
    `tsm pending-changes list`
    
    Se houver alterações pendentes, você precisará descartá-las ou aplicá-las. A aplicação de alterações pendentes levará algum tempo:
    
    - Descartar as alterações
        
        tsm pending-changes discard
    
    ou
    
    - Aplique as alterações:
        
        tsm pending-changes apply
    
    Aguarde até que o comando seja concluído e você retorne ao prompt do sistema.
4. Obtenha as IDs de cada nó no cluster:
    
    `tsm topology list-nodes -v`
5. Use o comando `tsm topology deploy-coordination-service` para adicionar um novo ensemble do Serviço de coordenação ao adicioná-lo a nós específicos. Você deve especificar o(s) nó(s) ao(s) qual(is) o Serviço de Coordenação deve ser adicionado, usando a ID do nó real para identificar cada nó. O comando também torna o ensemble de “produção” (o ensemble em uso) no ensemble novo e remove o antigo, a menos que a implantação falhe. Se isso acontecer, veja a etapa 6 abaixo.
    
    **Observação:**um prompt "y/n” é exibido, confirmando que uma reinicialização do servidor ocorrerá. Para executar o comando sem entrada, inclua a opção `--ignore-prompt`.
    
    Por exemplo, implante o Serviço de coordenação em todos os nós de um cluster de três nós, sendo eles: nó1, nó2, nó3
    
    `tsm topology deploy-coordination-service -n node1,node2,node3`
    
    Aguarde até que o comando seja concluído e você retorne ao prompt do sistema.
6. (Opcional) Se a implantação falhar, você precisa executar o comando `tsm topology cleanup-coordination-service` para remover o conjunto implantado sem sucesso. Para obter detalhes sobre a execução do comando, consulte [tsm topology cleanup-coordination-service](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMCleanupCoordination).
7. Inicie o Tableau Server:
    
    `tsm start`

Para obter mais informações e detalhes sobre a implantação de um novo ensemble do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

### Etapa 7: configure o CFS (Serviço de arquivo do cliente) em nódulos adicionais

Adicione o CFS em nós adicionais. Recomendamos que você adicione o CFS a cada nó que executa o Serviço de coordenação.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó ao qual você está adicionando o CFS:
    
    `tsm topology list-nodes -v`
3. Adicione o CFS ao nó especificando o nó, o processo e uma única instância.
    
    Por exemplo, este comando adiciona uma instância do CFS ao node2:
    
    `tsm topology set-process -n node2 -pr clientfileservice -c 1`
    
    Se você tentar adicionar uma instância do CFS a um nó que já foi configurado com o CFS, uma mensagem de erro informará que já existe uma instância no nó.
    
    Para adicionar o CFS a outros nós, repita essa etapa para cada nó.
4. Aplique as alterações:
    
    `tsm pending-changes apply`

### Etapa 8: configurar processos para o nó 2

1. No nó inicial, defina a topologia para o nó 2. A topologia determina quais processos devem ser executados no nó e quantas instâncias de cada processo devem ser executadas. Para obter detalhes sobre a configuração de nós, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm). O processador de dados é adicionado automaticamente com a adição de outros processos. Para obter detalhes sobre quando o processador de dados é adicionado, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).
    
    1. Obtenha o node-id do novo nó: `tsm topology list-nodes -v`
    2. Especifique os processos individuais que serão executados no novo nó:
        
        `tsm topology set-process -n <node-id> -pr gateway -c 1`
        
        `tsm topology set-process -n <node-id> -pr vizqlserver -c 2`
        
        `tsm topology set-process -n <node-id> -pr vizportal -c 2`
        
        `tsm topology set-process -n <node-id> -pr backgrounder -c 2`
        
        `tsm topology set-process -n <node-id> -pr cacheserver -c 2`
        
        `tsm topology set-process -n <node-id> -pr indexandsearchserver -c 1`
        
        `tsm topology set-process -n <node-id> -pr dataserver -c 2`
        
        `tsm topology set-process -n <node-id> -pr filestore -c 1`
        
        `tsm topology set-process -n <node-id> -pr pgsql -c 1`
        
        `tsm topology set-process -n <node-id> -pr metrics -c 1`
        
        `tsm topology set-process -n <node-id> -pr activemqserver -c 1`
        
        `tsm topology set-process -n <node-id> -pr tdsservice -c 1`
        
        `tsm topology set-process -n <node-id> -pr contentexploration -c 1`
        
        `tsm topology set-process -n <node-id> -pr collections -c 1`
2. Aplique as alterações da configuração do nó. Uma mensagem indicará que o Tableau Server será reinicializado.
    
    ```
    tsm pending-changes apply
    ```

### Etapa 9: configurar processos para o nó 3

No nó inicial, defina a topologia para o nó 3. A topologia determina quais processos devem ser executados no nó e quantas instâncias de cada processo devem ser executadas. O processador de dados é adicionado automaticamente com a adição de outros processos. Para obter detalhes sobre quando o processador de dados é adicionado, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

1. Obtenha o node-id do novo nó:
    
    `tsm topology list-nodes -v`
2. Especifique os processos individuais que serão executados no novo nó:
    
    `tsm topology set-process -n <node-id> -pr gateway -c 1`
    
    `tsm topology set-process -n <node-id> -pr vizqlserver -c 2`
    
    `tsm topology set-process -n <node-id> -pr vizportal -c 2`
    
    `tsm topology set-process -n <node-id> -pr backgrounder -c 2`
    
    `tsm topology set-process -n <node-id> -pr cacheserver -c 2`
    
    `tsm topology set-process -n <node-id> -pr indexandsearchserver -c 1`
    
    `tsm topology set-process -n <node-id> -pr dataserver -c 2`
    
    `tsm topology set-process -n <node-id> -pr filestore -c 1`
    
    `tsm topology set-process -n <node-id> -pr metrics -c 1`
    
    `tsm topology set-process -n <node-id> -pr tdsservice -c 1`
    
    `tsm topology set-process -n <node-id> -pr contentexploration -c 1`
    
    `tsm topology set-process -n <node-id> -pr collections -c 1`
3. Aplique a configuração do nó. Uma mensagem indicará que o Tableau Server será reinicializado.
    
    ```
    tsm pending-changes apply
    ```
4. Inicie o servidor:
    
    `tsm start`

### Etapa 10: configurar regras de firewall (opcional)

Se estiver executando um firewall local, será necessário configurar as regras de firewall para todos os nós no cluster. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall) .

## Adicionar um balanceador de carga

Nesse ponto, todos os três nós têm gateways, usados para encaminhar solicitações para processos de servidor disponíveis. Todos os gateways estão ativos, mas, para reduzir o potencial de tempo de inatividade no cluster, é possível configurar um balanceador de carga. Para obter mais informações, consulte [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm).

<!-- document id=73e4d826e0fb5bd169b17d5ec212537fdfbc6fdb2e088feee0a4f43fc12d22e3 url=/tableau/current/pt-br/server/cmt-scripting_migration_example.md -->

[Pular para o conteúdo principal](#main-content)

# Exemplo: scripting do plano de migração

**Observação:** este tópico inclui um script de amostra que você pode usar como base para criar scripts de uma migração de vários planos que atenda as suas necessidades e ambiente. Este script deve ser usado somente como um exemplo, e não ser executado no estado em que se encontra. Para obter informações sobre como usar o executor do console, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).

O utilitário de linha de comando do Content Migration Tool do Tableau para executar migrações pode ser usado para automatizar a execução de um plano de migração de um agendador externo (como o Agendador de tarefas do Windows) ou de um script personalizado. O executor do console só executa um plano de migração (armazenado em um arquivo .edt) por vez. Se você tiver um grupo de planos de migração que deseja executar como um grupo, poderá usar um script personalizado em combinação com o executor do console do Content Migration Tool.

O exemplo abaixo é gravado no PowerShell e usa o executor do console para executar uma lista de planos de migração como um grupo.

O exemplo de código a seguir demonstra:

- A execução de vários planos de migração como um grupo usando o executor do console.
- Opcionalmente, suspenda a implantação do grupo de planos imediatamente quando qualquer migração única do grupo falhar.
- O uso do código de saída do executor do console para determinar se a migração falhou ou registrou avisos.

\# List of migration plans to execute as a group.
$planFiles = @(
	'customer 1.tcmx',
	'customer 2.tcmx'
)

# True of false whether to continue with the next plan if a migration fails.
$continueOnFailure = $false
			
# Path to the CMT console runner executable
$runnerExe = 'C:\\Program Files (x86)\\Tableau\\Tableau Content Migration Tool\\tabcmt-runner.exe'

# Store the exit code from the previously run migration plan.
$lastResult = -1
			
# Loop through and run each migration plan one at a time.
$planFiles | % {
	$file = $\_
			
	if ($lastResult -ge 2 -and -not($continueOnFailure)) {
		Write-Warning "Skipping plan because previous migration failed. \`nSkipped plan: $file"
		return
	}
			
	Write-Verbose "Running migration plan: $file"
	& $runnerExe $file
       $lastResult = $LASTEXITCODE
 
 	if ($lastResult -ge 2) {
		Write-Error "Migration failed. See output or log file for error details.\`nPlan: $file" -ErrorAction 'Continue'
	}
	elseif ($lastResult -eq 1) {
		Write-Warning "Migration completed with warnings. See output or log file for warning details.\`nPlan: $file"
	}
}

## Quem pode fazer isso

Para criar planos de migração, você deve ter todos o seguinte:

- Permissões de administrador na máquina Content Migration Tool.
- Uma conta de usuário do site do Tableau com uma função Explorer (Explorador) ou superior.
- Permissões Exibir e baixar pasta de trabalho/Salvar uma cópia no site de origem.
- Direitos de publicação no site de destino.

<!-- document id=0ecb8f5374dadee4830a68968ef4cdc55a3c17b1e3cec8a78dfac075a9086a86 url=/tableau/current/pt-br/server/server-helm-examples.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server Helm Chart - Exemplos

**Importante**: esta documentação pressupõe um conhecimento do Helm e de Helm Charts e não tenta fornecer exemplos prescritivos detalhados. Ele foi criado para clientes que estão familiarizados com o Tableau Server e com o Helm e Helm Charts.

## Introdução

Este documento fornece exemplos para implantação do Tableau Server usando um Helm Chart em várias configurações e cenários.

## Download e distribuição do Helm Chart

Os Helm Charts serão enviados como parte da ferramenta de configuração Tableau Server em um contêiner (`tableau-server-container-setup-tool-<version>.tar.gz`) e pode ser baixado na página [Download do Tableau Server](http://tableau.com/pt-br/support/releases/server/latest).

Após a extração, os arquivos dos Helm Charts necessários ficam em `helm/tableau` .

## Exemplo 1: um único nó com o NodePort

deploymentMode: "single"  
service:  
primary:  
type: NodePort  
secrets:  
licenseKey: "YOUR-LICENSE-KEY"

## Exemplo 2: múltiplos nós com o Load Balancer (três trabalhadores)

Para implantações com múltiplos nós, use `worker.replicaCount ≥ 1`, no qual o número é a quantidade de trabalhadores. O exemplo abaixo usa três trabalhadores.

deploymentMode: "multinode"  
primary:  
  replicaCount: 1  
worker:  
  replicaCount: 3  
service:  
  primary:  
    type: LoadBalancer  
persistence:  
  bootstrap:  
    enabled: true  
    accessMode: ReadWriteMany  
secrets:  
  licenseKey: "YOUR-LICENSE-KEY"

### Exemplo 3: produção com Ingress e TLS

deploymentMode: "single"  
ingress:  
  enabled: true  
  className: "nginx"  
  hosts:  
    - host: tableau.company.com  
      paths:  
        - path: /  
          pathType: Prefix  
  tls:  
    - secretName: tableau-tls  
      hosts:  
        - tableau.company.com  
service:  
  primary:  
    type: ClusterIP  
persistence:  
  storageClass: "fast-ssd"  
  size: 500Gi  
primary:  
  resources:  
    limits:  
      cpu: "8"  
      memory: "16Gi"  
    requests:  
      cpu: "4"  
      memory: "8Gi"

## Recursos adicionais

- [Tableau Server Helm Chart - Visão geral](https://help.tableau.com/current/server/pt-br/server-in-container_helm-chart.htm)
- [Tableau Server Helm Chart - Pré-requisitos](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm)
- [Tableau Server Helm Chart - Implantação](https://help.tableau.com/current/server/pt-br/server-helm-deploy.htm)
- [Tableau Server Helm Chart - Solução de problemas](https://help.tableau.com/current/server/pt-br/server-helm-troubleshooting.htm)
- [Tableau Server Helm Chart - Exemplos](#)
- [Documentação do Tableau Server](https://help.tableau.com/current/server-linux/en-us/)

<!-- document id=eccfb293990029a73f07b722f7a0046d967bde6f90a1a83edb4e38d2b1d3709a url=/tableau/current/pt-br/server/rmt-incidents-slow-view.md -->

[Pular para o conteúdo principal](#main-content)

# Incidentes de exibições lentas

Os incidentes de _Exibição lenta_ são acionados quando qualquer solicitação de exibição demora muito para carregar.

Por padrão, um incidente de exibição lenta acionará um aviso se qualquer solicitação de exibição tiver pelo menos 1 minuto para ser carregada.

## Configurar limites de incidentes de exibição lenta

Para definir os limites para incidentes de consulta lenta, no menu **Administração,** selecione **Configuração** e acesse a guia **Incidentes.**

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Chave</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><b>Gravidade</b></td><td>Obrigatório</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>.</p></td></tr><tr><td><b>Duração</b></td><td>Obrigatório</td><td>A duração mínima para que uma consulta seja considerada lenta. Valores em segundos.</td></tr><tr><td><b>Usuários do Tableau</b></td><td>Obrigatório</td><td><p>Esse limite pode ser aplicado a usuários específicos quando eles fazem solicitações de visualização ou para todos os usuários. O padrão é <b>Todos os usuários</b>.</p></td></tr><tr><td><b>Conteúdo</b></td><td>Obrigatório</td><td><p>O conteúdo inclui pastas de trabalho e exibições. Este limite pode ser aplicado a uma única exibição ou a todas as exibições. Se uma pasta de trabalho for especificada, o limite será aplicado a todas as exibições nessa pasta de trabalho. Para especificar uma exibição, use a URL de compartilhamento. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/embed_structure.htm">Como as URLs de exibição são estruturadas</a>.<br>Você também pode excluir certas exibições ou pastas de trabalho especificando exceções.</p><p>O padrão é <b>Todas as exibições╡</b></p></td></tr></tbody></table>

Somente um incidente é criado por solicitação de exibição. O Resource Monitoring Tool avalia todos os gatilhos de incidentes e, se vários gatilhos corresponderem a uma solicitação de exibição específica, os gatilhos são classificados em ordem de prioridade e especificidade. O gatilho de classificação mais alta é usado para criar o incidente.

Por exemplo, um gatilho com gravidade crítica é classificado mais alto do que gravidade de aviso.

<!-- document id=59a0c34674b8af12d5cccc65ba6e4c8651485632e1e8c8e5476bfb86df06bc36 url=/tableau/current/pt-br/server/adminview.md -->

[Pular para o conteúdo principal](#main-content)

# Exibições administrativas

A página Status contém uma pasta de trabalho do Tableau integrada, com várias exibições administrativas. Essas exibições ajudam a monitorar os diferentes tipos de atividade no servidor ou site.

**Importante:** a partir da versão 2023.1.0, instale o driver do PostgreSQL se quiser usar as exibições administrativas internas. Você pode encontrar o driver e as instruções de instalação na [página Download do driver](https://www.tableau.com/pt-br/support/drivers).  
  
**Upgrade:** se você estiver fazendo upgrade no local, o driver existente continuará funcionando e não será necessário instalar o novo driver, mas o download e a instalação do driver fornecerão a versão mais atualizada. Se estiver fazendo upgrade ao instalar uma nova instância do Tableau Server, você precisará baixar o driver.

## Navegando para exibições administrativas

Para visualizar as exibições administrativas, clique em Status. Administradores de site podem ver exibições administrativas do site deles. Os administradores de vários sites podem ver exibições do site atual.

Em um servidor com vários sites, os administradores de servidor podem ver exibições em todo o servidor. Clique no menu do site e, em seguida, clique em Gerenciar todos os sites para acessar os menus do servidor.

![Um menu com opções para Início, Explorar, Favoritos, Recentes, Usuários, Grupos, Agendamentos, Tarefas, Status do servidor e Configurações.](/tableau/current/pt-br/server/pt-br/Img/nav_status_multi_site_serveradmin.png)

Para ver as exibições para sites individuais em um servidor com vários sites, clique no menu do site, selecione o nome do site e, em seguida, clique em Status do site.

![Um menu com opções para Início, Explorar, Favoritos, Recentes, Usuários, Grupos, Agendamentos, Tarefas, Status do servidor e Configurações.](/tableau/current/pt-br/server/pt-br/Img/nav_status_multi_site_serveradmin01.png)

## Outros artigos nesta seção

<!-- document id=9b6d57cb50e6be41c8313cb535d1843aa938a679625258f35aa17898e4c46c23 url=/tableau/current/pt-br/server/prep_conductor_admin_views.md -->

[Pular para o conteúdo principal](#main-content)

# Exibições administrativas para fluxos

As exibições administrativas podem ser usadas para monitorar as atividades relacionadas aos fluxos, histórico de desempenho e o espaço em disco usado. A página **Status** contém uma pasta de trabalho do Tableau incorporada com várias exibições administrativas que podem ser usadas para monitorar diferentes tipos de servidor ou atividade de site.

Para as instalações do **Tableau Server**, instale os drivers do PostgreSQL para poder ver as exibições Administrativas. Para obter mais informações, consulte [Drivers do banco de dados](https://help.tableau.com/current/server-linux/pt-br/dbdriver.htm) (Linux), [Drivers do banco de dados](https://help.tableau.com/current/server/pt-br/dbdriver.htm) (Windows). Os administradores de servidor podem usar essas exibições para ver a atividade no nível do servidor (agregada para todos os sites) ou para um site específico. Somente administradores de servidor podem filtrar por site.

## Quem pode fazer isso?

Os administradores do Tableau Server e administradores do Tableau Site podem exibir e trabalhar com exibições administrativas. Somente administradores de servidor podem filtrar por site.

## Ações por todos os usuários

Use esta exibição para obter uma visão de como os fluxos estão sendo usados. Isso inclui ações como publicar, baixar e executar fluxos. É possível filtrar a exibição por ações, sites e intervalo de tempo. A contagem de Usuários totais mostra o número de usuários que realizaram uma ação. Este valor não é afetado por filtros. A contagem de usuários ativos mostra o número de usuários que estiveram ativos durante o período selecionado e realizaram uma das ações selecionadas.

![Uma visão administrativa mostrando um gráfico de linhas sobre fluxos e como eles estão sendo usados.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_action_allusers.png)

## Ações por usuário específico

Use esta exibição para reunir insights sobre como um usuário individual está trabalhando com fluxos. Você pode filtrar a exibição por nome de usuário, tipo de ação, intervalo de tempo e por site.

![Uma exibição administrativa que mostra como um usuário individual está trabalhando com fluxos.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_action_specificuser.png)

## Ações por usuários recentes

Esta exibição mostra quais usuários estiveram ativos no Tableau Server nas últimas 24 horas.

Isso pode ser útil se você necessita fazer alguma atividade de manutenção no servidor e quer saber quantos e quais usuários isso irá afetar, bem como o que eles estão fazendo.

A exibição **Ativo**, **Recentemente ativo** e **Ocioso** em que os usuários estão atualmente conectados para o Tableau Server.

Para essa exibição, um usuário ativo é aquele que faz uma ação nos últimos 5 minutos, um usuário ativo recente é aquele que fez uma ação por último em 30 minutos e um usuário ocioso é aquele que fez uma ação por último há mais de 30 minutos.

Selecione um usuário para ver somente as ações que o usuário realizou recentemente. Focalize uma ação para ver os detalhes dela.

![Uma exibição administrativa mostra quais usuários de fluxos estiveram ativos no Tableau Server Tableau Cloud nas últimas 24 horas.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_action_recentusers.png)

## Atraso de tarefas no processador em segundo plano

Essa exibição mostra o atraso das tarefas de atualização da extração, assinatura e tarefas de fluxo, ou seja, o período entre quando elas estão agendadas para execução e quando elas realmente serão executadas. Você pode usar a exibição para ajudar a identificar os locais em que o desempenho do servidor pode ser aprimorado ao distribuir as agendas da tarefa e ao otimizar as tarefas.

![Uma exibição administrativa mostrando os tempos de espera de Extração, Assinatura e Fluxo.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_backgrounder_delays.png)

Os possíveis motivos para os atrasos e as formas de reduzi-los incluem o seguinte:

- Muitas tarefas são agendadas para a mesma hora.
    
    Na exibição de exemplo, as tarefas que mostram atrasos longos estão agrupadas na mesma hora do dia, criando picos no tempo de espera. É possível definir o filtro Linha do tempo para um único dia, com o objetivo de visualizar as tarefas por hora e identificar as horas do dia quando muitas tarefas são agendadas ao mesmo tempo. Uma solução seria distribuir as tarefas para horários fora do pico, reduzindo a carga do servidor.
- Outros processos do servidor sendo executados ao mesmo tempo estão consumindo os recursos do servidor ou diminuindo o desempenho.
    
    Monitore a utilização da CPU e da memória pelos processos do servidor para identificar quais estão consumindo mais recursos e, em seguida, ajuste a configuração dos processos no seu servidor.
    
    Para obter mais informações sobre o monitoramento dos processos, consulte [Coletar dados com o Monitor de Desempenho do Windows](https://help.tableau.com/current/server/pt-br/perf_collect_perfmon.htm).

## Tarefas em segundo plano para não extrações

Tarefas em segundo plano são criadas para executar fluxos (agendados e ad hoc). Você pode usar esta exibição para ver quantas tarefas de fluxo foram bem-sucedidas ou falharam neste site. Para obter detalhes sobre uma tarefa, focalize seu ícone.

![Uma exibição administrativa mostra quantas tarefas de fluxo foram bem-sucedidas ou falharam neste site.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_backgrounder_tasks.png)

## Desempenho das execuções de fluxo

Use esta exibição para ver o histórico de desempenho de todos os fluxos de um site. Você pode filtrar por Nome do fluxo, Nome da etapa de saída, Proprietário do fluxo, Tipo de execução (agendada ou Ad Hoc), além da hora em que a execução de fluxo foi iniciada.

![Uma exibição administrativa mostrando o desempenho do fluxo ao longo do tempo. Cada ponto no gráfico corresponde a uma execução de fluxo específica, exibindo o nome do fluxo, a etapa de saída, o proprietário do fluxo, o tipo de execução e os horários de início e término.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_flow_performance.png)

As perguntas que você pode responder usando esta exibição incluem:

- **Quais tarefas de fluxo estão agendadas no momento?** – Para fazer isso, use o filtro Hora de início e selecione o período desejado. Por exemplo, para ver tarefas de fluxo agendadas nas próximas três horas, selecione **Horas** -> **Próximo** -> e digite **3**.
- **Qual é a duração das tarefas de fluxo?** - Para responder isso, clique em uma marca na exibição para ver detalhes, incluindo a duração da tarefa.
- **Quantos fluxos foram executados com ad hoc e quantos foram agendados?** - Para responder isso, use o filtro **Tipo de execução** e selecione **Ad hoc** ou **Agendado**.

Essa exibição também pode mostrar as seguintes informações:

- Os fluxos com a frequência de execução mais alta têm mais marcas.
- Para ver os fluxos que estão atualmente em execução ao mesmo tempo, passe o mouse sobre uma marca que exiba “**Em andamento**” ou “**Pendente"** e selecione “**Manter apenas**” para filtrar todas as execuções de fluxo que estão em execução no momento.
- Para ver os fluxos que estão em execução ao mesmo tempo durante um intervalo de tempo específico, selecione um intervalo para o filtro **Hora de início**. Por exemplo, selecione “**Próximas três horas**” para ver quais fluxos estarão em execução nas próximas três horas.

## Estatísticas para utilização do espaço

Use esta exibição para identificar quais saídas de fluxo estão ocupando mais espaço em disco no servidor. A utilização do espaço em disco é exibida por usuário, projeto e tamanho da saída de fluxo e é arredondada para o número inferior mais próximo:

![Uma exibição administrativa mostra quais saídas de fluxo estão ocupando mais espaço em disco no servidor.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_admin_views_spaceusage.png)

Use o filtro Tamanho mínimo para controlar quais saídas de fluxo são exibidas, baseadas na quantidade de espaço que ocupam. Use o filtro de tipo de objeto para fluxos.

- **Quais usuários usam mais espaço** – Essa seção mostra os usuários proprietários de fluxos (quando filtrados para fluxo) que ocupam mais espaço. Clique em um nome de usuário para filtrar os próximos dois gráficos para tal usuário.
- **Quais projetos usam mais espaço** – Essa seção mostra os projetos com fluxos (quando filtrados para fluxo) que ocupam mais espaço.
- **Quais pastas de trabalho, fonte de dados e fluxos usam mais espaço** - Esta seção mostra os fluxos (quando filtrados para fluxos) que ocupam mais espaço.

## Quem pode fazer isso

- **Administradores do Tableau Server**:
    - Configurar notificações por e-mail no nível do servidor
    - Configurar notificações por e-mail para um site
    - Ver erros
    - Retomar tarefas suspensas
    - Ver alertas
    - Ver status de processos
- **Administradores do site do Tableau**:
    - Configurar notificações por e-mail no nível do site
    - Ver erros
    - Retomar tarefas suspensas
    - Ver alertas
- **Proprietários de fluxo, líderes de projeto e qualquer usuário que tenha permissões para visualizar o fluxo**:
    - Ver erros
    - Retomar tarefas suspensas
    - Ver alertas (proprietários de fluxo)

<!-- document id=efeb263e0ec05e5d3333512cab6867129cf2bf5d94cbdb86fbe00f096c7bf3ae url=/tableau/current/pt-br/server/adminview_bucket.md -->

[Pular para o conteúdo principal](#main-content)

# Exibições administrativas pré-criadas

As exibições administrativas são ferramentas de monitoramento poderosas que podem ajudá-lo a otimizar o Tableau Server e a melhor compreender como os seus usuários interagem com o conteúdo do Tableau. As exibições administrativas listadas à direita estão incluídas no Tableau Server. Clique no link de uma exibição para saber mais sobre como interpretar e usar as informações que ela fornece.

Para criar a sua própria exibição administrativa, consulte [Criar exibições administrativas personalizadas](https://help.tableau.com/current/server/pt-br/adminview_postgres.htm).

## Outros artigos nesta seção

<!-- document id=a08a10b8014865f69d78f57bab9c04762b78364dfadc03d1eda00502cfc207e6 url=/tableau/current/pt-br/server/datasource_view_attributes.md -->

[Pular para o conteúdo principal](#main-content)

# Exibir atributos de fonte de dados

Na área Conteúdo do ambiente de criação na Web do Tableau Server, é possível filtrar a exibição para mostrar apenas fontes de dados ou conexões e seus atributos.

## Exibir fontes de dados por nome

Para filtrar por nome de fonte de dados, em Explorar, selecione Fontes de dados.

![](/tableau/current/pt-br/server/pt-br/Img/ds_connect1.png)

Os atributos na lista de nomes da fonte de dados incluem o seguinte:

- **Tipo**—o ícone próximo ao nome da fonte de dados indica se a fonte de dados está publicada como uma conexão em tempo real (![](/tableau/current/pt-br/server/pt-br/Img/datasource_icon_published.png)) uma conexão de extração (![](/tableau/current/pt-br/server/pt-br/Img/datasource_icon_extract.png)) ou inserida em uma pasta de trabalho (![](/tableau/current/pt-br/server/pt-br/Img/datasource_icon_embedded.png)).
    
    - Selecione o nome de uma fonte de dados publicada para abrir a página de fonte de dados, com guias para visualização das conexões e pastas de trabalho conectadas.
    - Selecionar o nome de uma fonte de dados inserida abre uma pasta de trabalho associada à fonte de dados, com guias para a visualização de outros dados aos quais ela se conecta.
- Conecta-se a—Indica o nome do servidor do banco de dados ou do arquivo de dados. Isso poderia ser um banco de dados fora do Tableau Server, uma extração ou uma fonte de dados publicada.
- Ativa ou última extração—Esta coluna indica a você se a conexão com os dados está ativa ou se é uma conexão com uma extração, quando a extração foi atualizada pela última vez.

## Exibir uma lista de conexões

Para filtrar por tipo de conexão, na lista Exibir, selecione Conexões.

![Menu suspenso Mostrar como com opções para mostrar como fontes de dados ou conexões.](/tableau/current/pt-br/server/pt-br/Img/ds_connect2.png)

Os atributos de conexão incluem:

- Conecta-se a—Indica o nome do servidor do banco de dados ou do arquivo de dados. Isso poderia ser um banco de dados fora do Tableau Server, uma extração ou uma fonte de dados publicada.
- Tipo de conexão—Mostra o tipo de dados. **Tableau Server** indica que a conexão é a uma fonte de dados publicada no site. Mecanismo de Dados do Tableau significa que a fonte de dados tem uma extração armazenada no servidor de dados do Tableau.

<!-- document id=57ef8cd7e07bc82b14b307a8376be73e1bfd16c5f2b80575a91f4137972eedfc url=/tableau/current/pt-br/server/service_viewstatus.md -->

[Pular para o conteúdo principal](#main-content)

# Exibir o status de processos do servidor

Para exibir o status do processo do servidor, execute um comando da CLI do TSM ou acesse a interface do usuário na Web ou as páginas de administração do TSM no Tableau Server.

## Exibição de status do processo com a CLI do TSM

Execute o seguinte comando:

`tsm status -v`

Este comando produz todos os processos configurados na instância e o status correspondente.

## Exibição de status do processo na interface do usuário na Web

Há duas localizações no Tableau Server ou no Tableau Services Manager (TSM) em que os administradores podem visualizar o estado dos processos do Tableau. Talvez você possa acessar um ou os dois locais, dependendo de como sua conta e servidor forem configurados. A maioria das informações de status de processo exibidas estão duplicadas nas duas páginas Status. Esta seção explica cada página e identifica quais são específicas para cada uma.

**Observação** As páginas de status exibidas em ambos os locais da interface do usuário na Web mostram um subconjunto dos processos totais configurados em um determinado nó. Para exibir todos os processos, execute o comando da CLI do TSM, `tsm status -v`.

- A página de status do Tableau Services Manager (TSM) é acessível no TSM e pode ser visualizada por administradores do TSM. Você deve poder fazer logon no TSM para visualizá-la. Para obter informações de logon no TSM, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
- A página de status do Tableau Server aparece na interface do usuário na Web do Tableau Server e é acessível para administradores do Tableau Server. Essa página inclui processos do Tableau Server, além de links para a documentação de solução de problemas caso um processo não esteja executando conforme o esperado. Se passar o cursor pelo indicador de status de um processo, uma dica de ferramente mostra o nome do nó e a porta onde o processo está sendo executado. A página de status do Tableau Server não mostra os processos do TSM. Para obter informações sobre o logon no Tableau Server como um administrador, consulte [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).

### Página de status do Tableau Services Manager (TSM)

A página de status do TSM mostra o estado dos processos de servidor, incluindo o Controlador TSM e o Servidor de licença. Esses dois processos não são exibidos na página de status do Tableau Server.

![Uma tabela que exibe o status dos processos em três nós do servidor.](/tableau/current/pt-br/server/pt-br/Img/statusTSM.png)

Os possíveis indicadores de status estão listados na parte inferior da tabela:

![Cinco ícones de status do sistema: Ativo, Ocupado, Degradado, Erro e Parado.](/tableau/current/pt-br/server/pt-br/Img/statusTSM-icons.png)

### Páginas de status do Tableau Server

![Status de processos do servidor.](/tableau/current/pt-br/server/pt-br/Img/statusServer.png)

Os possíveis indicadores de status estão listados na parte inferior da tabela:

![Seis marcadores de status diferentes: ativo, ocupado, passivo, sem licença, inativo e status indisponível.](/tableau/current/pt-br/server/pt-br/Img/statusServer-icons.png)

Quando o Tableau Server esiver funcionando corretamente, a maioria dos processos serão mostrados como Ativo, Ocupado ou Passivo (Repositório):

- **Ativo**—o processo está funcionando como planejado. Consulte o Armazenamento de arquivo em [Solucionar problemas dos processos do servidor](https://help.tableau.com/current/server/pt-br/service_status_troubleshoot.htm) para obter detalhes a respeito de possíveis estados ativos.
- **Ocupado** — O processo está concluindo uma tarefa. Consulte o Armazenamento de arquivo e Repositório em [Solucionar problemas dos processos do servidor](https://help.tableau.com/current/server/pt-br/service_status_troubleshoot.htm) para obter mais informações.
- **Passivo** — O repositório está no modo passivo, ou um processo não pode receber tráfego. Consulte o Repositório e Index and Search Server em [Solucionar problemas dos processos do servidor](https://help.tableau.com/current/server/pt-br/service_status_troubleshoot.htm) para obter mais informações.
- **Não licenciado** — O processo não é licenciado.
- **Inativo** —o processo está inoperante. As implicações variam, dependendo do processo.
- **Status indisponível** — O Tableau Server não conseguiu determinar o status do processo.

Se houver informações adicionais, uma mensagem será exibida sob o ícone de status e links para a documentação adequada:

![O arquivo está pronto para remoção.](/tableau/current/pt-br/server/pt-br/Img/status_filestore_ready.png)

**Observação:** o Tableau Server foi projetado para ser autocorretivo. Se um serviço ou processo parar de responder ou falhar, o Tableau Server tentará reiniciá-lo. Isso pode levar de 15 a 30 minutos para ser concluído. Por isso, reagir imediatamente a alertas de serviço ou processo pode ser contraproducente, especialmente em uma instalação com serviços redundantes que podem lidar com solicitações durante a reinicialização.

Para obter mais informações sobre como solucionar problemas de status do processo, consulte [Solucionar problemas dos processos do servidor](https://help.tableau.com/current/server/pt-br/service_status_troubleshoot.htm).

### Nó externo

Alguns processos podem ser configurados fora do Tableau Server. Por exemplo, o Armazenamento de arquivos pode ser configurado em um SAN ou NAS, o repositório pode ser implantado em uma instância AWS RDS. Nesses casos, a página de status do Tableau Server mostra esses processos no **Nó externo** com o status **E** e a página de status do Tableau Services Manager (TSM) mostra esses processos no **nó externo** com uma marca de verificação para indicar que o processo está configurado externamente.

**Página de status do Tableau Server Manager (TSM) mostrando o Armazenamento de arquivos conforme configurado fora do Tableau Server:**

![Janela de status do Tableau Server Manager com armazenamento de arquivos externo selecionado.](/tableau/current/pt-br/server/pt-br/Img/tsm-status-external-file-store.png)

**Página de status do Tableau Server mostrando o Armazenamento de arquivos conforme configurado fora do Tableau Server:**

![Uma tabela mostra o estado atual dos processos do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/server-status-external-file-store.png)

## Outros artigos nesta seção

<!-- document id=d7d5b38b2ef4d83eb76d2d0d934b30c3a0477138c34958fcc119515396561698 url=/tableau/current/pt-br/server/users_view.md -->

[Pular para o conteúdo principal](#main-content)

# Exibir, gerenciar ou remover usuários

Os administradores de servidor podem gerenciar os usuários de um site podendo adicionar e remover usuários, definir os grupos que eles são membros, definir suas fontes de site, entre outras coisas. Os administradores de servidor podem gerenciar usuários em vários sites de uma só vez na página Todos os sites.

> [!TIP]
> 
> **Dica**: os [Perfis de administrador](https://help.tableau.com/current/server/pt-br/admin_profiles.htm) concedem aos usuários não administradores recursos específicos relacionados ao gerenciamento de usuários e grupos sem aumentar o acesso ao conteúdo.

Exibir e gerenciar usuários em um site

Entre em um site como um administrador de servidorou um usuário com um perfil de administrador com recursos suficientes e selecione Usuários. Nesta página, você pode realizar qualquer um dos seguintes procedimentos para gerenciar usuários:

- Definir associações a grupos, definir funções de site ou remover o usuário do site. Se tiver configurado o site para logon único de SAML, é possível definir o tipo de autenticação de usuários selecionados. Se o servidor estiver configurado para políticas de senha e bloqueio de acesso à conta, você poderá desbloquear o acesso à conta de um usuário. Se o seu servidor estiver configurado para um ou mais [grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm), você pode adicionar ou remover usuários.
    
    ![A lista de usuários do site com o menu de ações.](/tableau/current/pt-br/server/pt-br/Img/user_site_remove_server.png)
- Selecione um nome de usuário para visualizar os detalhes sobre ele, como conteúdos que ele possui, exibições que eles assinam, as configurações de conta.
    
    A página Configurações de usuário estará disponível quando as condições a seguir forem verdadeiras:
    
    - O usuário é um membro apenas de sites que o administrador de site controla
    - Os administradores de site podem gerenciar usuários como padrão. Os administradores do Tableau Server podem alterar esse acesso para administradores do site.
    
    ![O perfil do usuário com Ações destacadas.](/tableau/current/pt-br/server/pt-br/Img/user_site_view_settings2.png)
    
    Se o servidor estiver configurado para usar o sistema interno de gerenciamento de usuários (autenticação local), você poderá editar o **Nome de exibição**, o E-mail e a **Senha** dos usuários depois que eles forem adicionados. Se estiver fazendo muitas alterações, perceberá que é mais fácil importar as alterações de um arquivo CSV. Para obter detalhes, consulte [Importar usuários](https://help.tableau.com/current/server/pt-br/users_import.htm) e [Diretrizes do arquivo de importação CSV](https://help.tableau.com/current/server/pt-br/csvguidelines.htm).

Exibir e editar usuários do servidor

Entre no Tableau Server como administrador de servidor. No menu do site, selecione Gerenciar todos os sites, em seguida selecione Usuários.

Gerenciar a associação de usuários ao site

Por padrão, os administradores de servidor e site, ou um usuário com um perfil de administrador com recursos suficientes, podem gerenciar usuários no nível de site individual. Além disso, os administradores de servidor podem gerenciar usuários e suas funções nos vários sites. Isso é feito no nível Todos os sites (no nível do servidor).

1. No menu do site, selecione **Gerenciar todos os sites**, em seguida selecione Usuários.
2. Na página Usuários servidores, marque as caixas de seleção próximas aos usuários e selecione Ações > Associação ao site.
3. Selecione um ou mais sites e uma função no site para cada e depois clique em Salvar.

Pesquisar usuários (ou grupos ou sites)

Para pesquisar um usuário específico (ou grupo ou site), use o alternador de filtro na parte superior direita para exibir a caixa de pesquisa e o filtro da função no site. Em seguida, use a caixa de pesquisa ou os filtros para encontrar os usuários (ou grupo ou site) que desejar. A operação de pesquisa verifica os atributos de nome de exibição e nome de usuário.

A caixa de pesquisa oferece suporte ao caractere curinga (\*). Por exemplo, pesquisar por `John*` retornará todos os nomes que comecem com _John_.

Além disso:

- A partir do Tableau Server 2021.4.1, você pode usar o caractere curinga (\*) com um caractere especial para pesquisar nomes que contenham caracteres especiais. Por exemplo, `sync-*` ou `*sync-*`.
- A partir do Tableau Server 2022.1.13, ao pesquisar nomes com diacríticos, os nomes devem ser inseridos com diacríticos exatos para retornar resultados relevantes. Por exemplo, para pesquisar _Jose_, digite `José`. Procurar por `Jose` não retornará resultados.
- A partir do Tableau Server 2022.3.5, você pode usar o caractere curinga (\*) com condições AND ou OR ao filtrar nomes de usuários. Por exemplo, pesquisar `*aw* AND John*` retorna todos os usuários cujos nomes de usuário contêm _aw_ e cujos nomes começam com _John_.
    - Observe que o curinga com AND ou OR só está disponível durante a filtragem de nomes de usuários, não de nomes de exibição.

![Uma barra de pesquisa e menus suspensos para filtrar por função no site.](/tableau/current/pt-br/server/pt-br/Img/user_view_search.png)

Remover usuários de um site

Você pode remover um usuário apenas se o usuário não possuir nenhum conteúdo (projetos, pastas de trabalho, exibições, fontes de dados, coleções ou alertas de dados, por exemplo). Ao tentar remover um usuário proprietário de conteúdo, a função dele no site será definida como não **licenciado**, mas o usuário não será removido.

Se o grupo padrão Todos os usuários habilitar Conceder função do site no logon, o conteúdo do usuário deve ser reatribuído a outro usuário ou removido antes que ele seja não licenciado ou removido. Para obter mais informações sobre Atribuição de função no logon, consulte [Remoção dos usuários afetados pela Atribuição de função no logon](https://help.tableau.com/current/server/pt-br/grant_role.htm#remove). Para obter mais informações sobre como alterar a propriedade do conteúdo, consulte [Gerenciar propriedade de conteúdo](https://help.tableau.com/current/server/pt-br/owner.htm)

**Observação:** no Tableau Server, quando um administrador remove um usuário de um site (e o usuário pertence apenas àquele site), o usuário também é excluído do servidor.

1. Entre em um site como um administrador, ou um usuário com um perfil de administrador com recursos suficientes, e acesse a página Usuários. Selecione um ou mais usuários para remover e, em seguida, selecione Ações > Remover do site.
    
    ![A lista de usuários do site com o menu de ações.](/tableau/current/pt-br/server/pt-br/Img/user_site_remove_server.png)
2. Clique no botão **Remover usuários** na caixa de diálogo de confirmação.

Remover usuários do servidor

Você só poderá remover um usuário se ele não for um proprietário de conteúdo (projetos, pastas de trabalho, exibições ou fontes de dados). Ao tentar remover um usuário proprietário de conteúdo, a função dele no site será definida como Não licenciado, mas o usuário não será removido.

Se o usuário for membro de vários sites e proprietário de conteúdo em algum deles, ele será removido apenas dos sites nos quais não possui conteúdo. O usuário permanecerá membro dos sites nos quais possui conteúdo, mas rebaixado à função Não licenciado.

1. No menu do site, clique em Gerenciar todos os sites e clique em Usuários. Em um ambiente de site único, clique em Usuários.
    
    Selecione um ou mais usuários para excluir e depois clique em Ações > Excluir.
    
    ![Formulário para excluir usuários no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/user_srvr_delete.png)
2. Clique em **Excluir** na caixa de diálogo de confirmação.

Alterar as senhas de usuários de um único site

Para alterar a senha de um usuário com associação a um único site, entre no Tableau Server como administrador de servidor ou de site ou um usuário com um perfil de administrador com capacidades suficientes.

1. Verifique se o site corretos está selecionados no menu.
2. Clique em Usuários.
3. Clique no nome de exibição de um usuário.
4. Clique em Configurações.
5. Clique no link Alterar senha, edite a senha e clique em Salvar senha.
    
    ![Clique no link Alterar senha nas configurações do usuário.](/tableau/current/pt-br/server/pt-br/Img/users_change_password.png)

Alterar as senhas de usuários de vários sites

Para alterar a senha de um usuário com associação a vários sites, entre no Tableau Server como administrador de servidor.

1. No menu do site, clique em Gerenciar todos os sites.
2. Clique em Usuários.
3. Clique no nome de exibição de um usuário.
4. Clique no link Alterar senha, edite a senha e clique em Salvar senha.
    
    ![Um formulário para alterar sua senha.](/tableau/current/pt-br/server/pt-br/Img/users_change_password2.png)

<!-- document id=4ed6672196d6158875c27baabc74026754c2fbc63c188adda49919fe3832ade4 url=/tableau/current/pt-br/server/rmt-tds-files.md -->

[Pular para o conteúdo principal](#main-content)

# Explorar dados de monitoramento usando arquivos de fonte de dados do Tableau

O Resource Monitoring Tool do Tableau inclui gráficos inseridos que podem ser usados para monitorar e analisar a integridade e o desempenho do Tableau Server. Os aproveitamentos dos dados do Resource Monitoring Tool do Tableau podem ser baixados como arquivos de fonte de dados do Tableau (.tds) para exploração no Tableau Desktop. Você pode baixar os arquivos .tds no menu **Admin** usando a interface da Web do Resource Monitoring Tool. Esses métodos funcionam para configurações de repositório local e externo.

![Menu suspenso Administrador no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/rmt-tds-menu.png)

A seguir, está uma lista de arquivos de fonte de dados do Tableau (.tds) que você pode baixar:

- **Tarefas em segundo plano**: inclui informações sobre tarefas agendadas de processador em segundo plano, como atualizações de extração, assinaturas e fluxos.
- **Consultas de dados**: informações sobre todas as consultas executadas pelo Tableau Server.
- **Solicitações de gateway**: solicitações HTTP manipuladas pelo Tableau Server, incluindo detalhes da sessão do VizQL Server.
- **Incidentes**: incidentes registrados pelo Resource Monitoring Tool.
- **Desempenho do servidor**: informações sobre processos e hardware do Tableau Server coletadas pelo Resource Monitoring Tool.
- **Entidades do Tableau**: informações sobre os sites, projetos, pastas de trabalho e modos de exibição do Tableau Server reunidas pelo Resource Monitoring Tool.

## Requisitos

- A criptografia utilizada é o SCRAM-SHA-256, que é aceita pelo Tableau Desktop 2020.4 e posterior.

## Ativa o acesso ao banco de dados PostgreSQL do Resource Monitoring Tool

O arquivo de fonte de dados (.tds) do Tableau Server contém uma conexão com o Banco de dados PostgreSQL do Resource Monitoring Tool. Antes que uma conexão com arquivo .tds seja possível, é necessário habilitar o acesso do usuário `readonly` ao banco de dados PostgreSQL do Resource Monitoring Tool. Assim que o usuário `readonly` tenha acesso, você pode então usar o nome de usuário `readonly` e a senha para se conectar ao Banco de dados PostgreSQL do Resource Monitoring Tool do arquivo .tds no Tableau Desktop.

### Resource Monitoring Tool versões 2022.3 e posteriores:

#### Resource Monitoring Tool com repositório local:

1. Na máquina RMT Server, habilite o acesso ao banco de dados PosgreSQL do Resource Monitoring Tool para o usuário `readonly`:
    
    `rmtadmin data-access ReadOnly`
2. Reinicie o Banco de dados PostgreSQL do Resource Monitoring Tool para que a alteração de configuração entre em vigor:
    
    `rmtadmin restart --db`
3. Recupere a senha do usuário `readonly`:
    
    `rmtadmin get db.readOnlyPassword`

#### Resource Monitoring Tool com repositório externo:

Você deve configurar a instância do RDS para permitir acesso ao Tableau Desktop. Recupere o nome de usuário e a senha do banco de dados PostgreSQL do Resource Monitoring Tool e use-os para baixar arquivos.tds. Para obter mais informações, consulte [documentação no site da AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ConnectToPostgreSQLInstance.html).

### Resource Monitoring Tool versões 2022.2 e anteriores:

1. Abra o arquivo `postgresql.conf` em um editor de texto. Por padrão, o arquivo está localizado em: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\data\postgresql<version>`
2. Atualize `Listen_addresses = 'localhost'` para `Listen_addresses = '*'`.
    
    **Observação:** você deve remover o '`#` ' desta linha.
3. Abra o arquivo `pg_hba.conf` em um editor de texto. esse arquivo está localizado no mesmo diretório que o do arquivo `postresql.conf`. Por padrão o arquivo está localizado em: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\data\postgresql<version>`
4. Adicione o seguinte ao final do arquivo `pg_hba.conf` e, em seguida, salve o arquivo:
    
    `host all all 0.0.0.0/0 scram-sha-256`
    
    `host all all ::/0 scram-sha-256`
5. Reinicie o Banco de dados PostgreSQL do Resource Monitoring Tool para que as alterações de configuração entrem em vigor:
    
    `rmtadmin restart --db`
6. Recupere a senha do usuário `readonly`:
    
    `rmtadmin get db.readOnlyPassword`

## Conectar-se aos arquivos .tds RMT do Tableau Desktop

Depois que o acesso ao banco de dados PostgreSQL do Resource Monitoring Tool foi habilitado para o usuário `readonly`, você pode se conectar aos arquivos .tds baixados do Tableau Desktop.

1. No Tableau Desktop, vá para **Arquivo > Abrir** e selecione o arquivo .tds baixado da Interface Web do Resource Monitoring Tool.
    
    **Observação**: talvez seja preciso instalar os drivers de banco de dados PostgreSQL. Faça download dos drivers em [www.tableau.com/pt-br/support/drivers](http://www.tableau.com/pt-br/support/drivers).
    
    Se o Tableau Desktop não se conectar automaticamente ao banco de dados Postgres do Resource Monitoring Tool depois de abrir o arquivo .tds, talvez seja necessário inserir manualmente o nome de usuário `readonly` e a senha na janela de edição da conexão no Tableau Desktop.

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função de servidor **Baixar arquivos TDS**.

<!-- document id=c5c522e720de9fcafede3e0c17369c22af18e770de2c3a668bda808c2cd935bd url=/tableau/current/pt-br/server/data_guide.md -->

[Pular para o conteúdo principal](#main-content)

# Explorar Painéis com Guia de dados

Você já descobriu um novo painel do Tableau e se perguntou o que os dados significam ou como usá-los? Ou você já publicou um novo painel e desejou incluir instruções sobre como usar seu painel?

O Guia de dados fornece informações úteis sobre um painel e insights sobre os dados por trás dele. O Guia de dados permite que os criadores de painéis forneçam um contexto mais explicativo para usuários finais – como descrições e links para recursos – diretamente no painel. E o Guia de dados apresenta automaticamente informações fornecidas pelo [Explique os dados](https://help.tableau.com/current/pro/desktop/pt-br/explain_data.htm) para ajudar os usuários a encontrar valores discrepantes e aprender sobre as explicações para uma marca. O Explique o Viz (desenvolvido por Explique os dados) identifica medidas discrepantes e potenciais principais impulsionadores por trás delas.

Esses detalhes contextualmente relevantes podem ajudar os usuários do painel a navegar e usar novos painéis com mais facilidade, permitindo que os usuários encontrem insights mais rapidamente, tenham confiança de que estão analisando os dados certos, forneçam contexto para os dados e estabeleçam confiança em sua compreensão da visualização.

Como alternativa, se você tiver um site do Tableau Cloud com o Tableau+, poderá usar o recurso de narrativas do painel do Tableau Agent para explorar seu painel usando a IA. Para obter mais informações, consulte [Criar narrativas do painel com o Tableau Agent (Beta)](https://help.tableau.com/current/pro/desktop/pt-br/dashboard-narratives.htm).

## Personalizar o Guia de dados como autor

1. No painel, escolha o botão Editar.
2. Escolha Guia de dados na barra de ferramentas.
3. No painel Guia de Dados, digite uma descrição para ajudar seus usuários finais a entender a finalidade do seu painel.
4. Selecione Adicionar link e insira um rótulo descritivo para o texto do link e a URL.
5. Escolha OK.
6. Selecione uma visualização (uma planilha no painel). O Guia de dados é atualizado automaticamente para que você possa adicionar uma descrição e recursos relevantes para cada visualização no painel.
7. Digite uma descrição e adicione links relevantes para a visualização.
8. Escolha OK.

> [!TIP]
> 
> **Dica:** para usar o Guia de dados, escrever um texto alternativo personalizado e melhorar a acessibilidade de suas visualizações, consulte [Mostrar mais texto e torná-lo útil](https://help.tableau.com/v0.0/pro/desktop/pt-br/accessibility_create_view.htm#show-more-text-and-make-it-helpful).

## Explore o Guia de dados como usuário do painel

1. No painel, escolha Guia de dados na barra de ferramentas.
2. Leia a descrição do painel e explore os recursos fornecidos pelo autor do painel.
3. Expanda Dados neste painel e Valores atípicos detectados para saber mais sobre os dados subjacentes usados no painel.
4. Selecione uma visualização (objeto no painel).
5. Leia a descrição da visualização e explore os recursos fornecidos pelo autor do painel.
6. Expanda Resumo de dados e Valores atípicos detectados para saber mais sobre os dados nessa visualização.
7. Selecione uma marca ou várias marcas, como uma barra em um gráfico ou uma região em um mapa, para ver informações sobre Dados nesta marca e Filtros aplicados. Selecione uma única marca para ver possíveis Explicações para seu valor.  
      
    ![Animação curta mostrando como o Guia de dados exibe diferentes informações quando você clica em um painel, uma visualização ou uma marca](/tableau/current/pt-br/server/pt-br/Img/data_guide_ovw.gif)

## Explore o Guia de dados em diferentes níveis

Por padrão, o Guia de dados é fechado quando você abre uma pasta de trabalho. E você pode abrir o Guia de Dados na barra de ferramentas. Na parte superior do painel Guia de Dados, você vê o nome do painel ou visualização que você selecionou. Como autor de painel, você pode escrever descrições para o painel e para visualizações individuais que compõem seu painel.

### Entenda os detalhes no nível do painel

No nível do painel, Guia de dados:

- Exibe o nome, o autor e a data da última publicação do painel.
- Pode incluir uma descrição escrita pelo autor do painel e links para recursos relacionados, como vídeos ou páginas wiki.
- Lista as fontes de dados usadas pelo painel e detalhes sobre os dados, como quais dimensões e medidas são usadas.
- Revela valores atípicos detectados no painel que são identificados pelo Explique os dados. Para obter mais informações, consulte [Introdução a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm).  
      
    ![O painel Guia de dados no nível do painel](/tableau/current/pt-br/server/pt-br/Img/data_guide_dashboard_level.png)

### Compreender os detalhes no nível da visualização

Quando um usuário seleciona uma visualização específica (objeto de painel), Guia de dados:

- Exibe o nome da visualização.
- Pode incluir uma descrição escrita pelo autor do painel e links para recursos relacionados, como vídeos ou páginas wiki.
- Lista as fontes de dados usadas pelo painel, incluindo as dimensões e medidas usadas.
- Lista os filtros aplicados e os dados usados na visualização, para que você possa identificar como os dados estão sendo influenciados pelos filtros com os quais os usuários interagem. Somente filtros que um usuário pode alterar são mostrados.
- Tem um resumo dos dados usados​na visualização, incluindo o número de pontos de dados e detalhes de classificação.
- Revela valores atípicos detectados na visualização que são identificados pelo Explique os dados. Para obter mais informações, consulte [Introdução a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm).  
      
    ![O painel Guia de dados no nível de visualização](/tableau/current/pt-br/server/pt-br/Img/data_guide_viz_level.png)

### Entender os detalhes no nível da marca

Quando um usuário seleciona uma marca (ou marcas), como uma região em um mapa, o Guia de dados:

- Exibe o nome da marca.
- Lista os filtros aplicados e os dados usados na visualização para que você saiba o que está incluído e o que está excluído.
- Revela valores atípicos detectados na visualização que são identificados pelo Explique os dados. Para obter mais informações, consulte [Introdução a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm).
    
      
    ![O painel Guia de dados no nível da marca](/tableau/current/pt-br/server/pt-br/Img/data_guide_mark_level.png)

## Controlar a visibilidade do Guia de dados

Por padrão, o Guia de dados é fechado quando você abre uma pasta de trabalho. Quando você abre ou fecha o Guia de dados, ele permanece nesse estado para todas as pastas de trabalho no site. Na versão 2023.1 ou posterior, um administrador de servidor pode ocultar o Guia de dados para todos os usuários. Isso remove o botão Guia de dados da barra de ferramentas do Tableau em todas as pastas de trabalho do site. Para ocultar o Guia de dados:

1. No painel esquerdo, escolha Configurações.
2. Na guia Geral, role até a seção Disponibilidade de Guia de dados.
3. Escolha Ocultar.
4. Escolha Salvar.

<!-- document id=6a6716378634f92cd33bfd14c8f22261295f13f10888cdf5abc11863e1bcc8e8 url=/tableau/current/pt-br/server/sites_exportimport.md -->

[Pular para o conteúdo principal](#main-content)

# Exportar ou importar um site

**Observação:** para obter informações detalhadas sobre a migração de sites do Tableau Server para Tableau Cloud, consulte nosso [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

É possível provisionar um novo site do Tableau Server ao importar (migrar) as informações de outro site. Para fazer isso, exporte as informações do site existente (o site de _origem_) para um arquivo. Em seguida, conclua as etapas para verificar e importar essas informações para o site de _destino_.

## Opções de migração de site

É possível migrar um site de qualquer uma dessas maneiras:

- Para outro site na mesma instância do Tableau Server.
- Para um site em uma instância diferente do Tableau Server.
- No Tableau Server no Windows para o Tableau Server no Linux ou vice-versa.

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

## Limitações de migração de site

### Quais informações são preservadas na exportação do site

- O arquivo de exportação preserva as pastas de trabalho, projetos, fontes de dados e usuários. Isso inclui conjuntos de permissões para conteúdo, listas de favoritos do usuário e cotas do site.
- As exibições personalizadas dos usuários são preservadas; contudo, dependendo do tipo de migração de site, as URLs da exibição personalizada podem ser alteradas de uma forma que detalhem os indicadores do usuário para suas exibições.
- Ao exportar um site no Tableau Server para importar para outro site no Tableau Server, as agendas de atualizações de assinaturas e de extrações são preservadas.

### Quais informações não são preservadas na exportação do site

- Os dados de utilização, que aparecem nas exibições administrativas do site, não são preservados. Por exemplo, contagens de exibição e fonte de dados, ações de usuários e dados de desempenho.
- Os trabalhos do processador em segundo plano que estão em andamento enquanto um site está sendo exportado, não serão exportados e exibidos no novo site quando a importação for concluída.
- Os tokens de acesso OAuth inseridos nas conexões de dados são redefinidos. Para essas fontes de dados, será necessário editar as conexões e autenticar novamente os dados subjacentes.
- As agendas e tarefas de fluxos de preparação não estão incluídas. Eles precisarão ser migrados manualmente.
- O conteúdo salvo no Espaço pessoal dos usuários não está incluído.
- As coleções não serão incluídas nas exportações de sites até o Tableau Server 2025.3.
- Durante a migração de sites entre diferentes tipos de armazenamento de identidades (Local para Active Directory/LDAP ou Active Directory/LDAP para Local), os filtros de usuário que usam Grupos serão interrompidos devido a diferenças de declaração de domínio. Após a migração, você deve recriar de forma manual esses filtros de usuário em todas as pastas de trabalho e fontes de dados afetadas no site de destino (especificamente aquelas que usam a função `ISMEMBEROF()`).

## Preparar os sites de origem e destino

Antes de exportar um site, conclua a lista de verificação a seguir para preparar os dois ambientes. Algumas dessas instruções dependem de se ambos sites estão na mesma instância de servidor ou em separadas instâncias.

### Excluir o conteúdo obsoleto

Confira se o site de origem contém apenas o que você quer importar para o novo site. Como prática recomendada, remova do site de origem tudo o que você não deseja incluir no novo site, sejam esses itens incluídos em uma exportação/importação ou que precisem ser migrados manualmente. Exclua pastas de trabalho, fontes de dados ou projetos não utilizados. Se você tiver fluxos do Prep ou agendas de fluxo que não usa mais, exclua-os também.

### Remover usuários obsoletos

Confirme se todos os usuários do servidor são licenciados e remova as contas que não são mais utilizadas. Você não pode remover usuários durante o processo de importação, pois, se os dois sites estiverem na mesma instância de servidor, todos os usuários exportados do site de origem sejam importados para o site de destino.

### Criar ou identificar o site de destino

Você deve importar um arquivo de site para um site já existente na instância do Tableau Server de destino. Como o processo de importação remove tudo do site de destino que não está incluído no arquivo de importação, recomendamos que a importação seja realizada para um site vazio. Para obter mais informações, consulte [Adicionar ou editar sites](https://help.tableau.com/current/server/pt-br/sites_add.htm).

### Localizar IDs do site

O comando tsm que você usa para exportar ou importar um site requer um parâmetro que utiliza a ID do site. Você poderá obter a ID do site pela URL quando estiver conectado a um site por meio de um navegador da Web.

Se somente um site existir no servidor, ele é chamado Padrão. Quando estiver conectado ao site Padrão, a URL do navegador será semelhante a:

`https://server-name/#/projects`

Na URL, a ausência do parâmetro `/site` indica que é o site Padrão. A ID do site padrão é "Padrão", sem aspas.

Em uma implantação do Tableau Server em vários sites, a URL do navegador inclui `#/site/` seguida pela ID do site. A URL a seguir aparece ao navegar até a página Exibições em um site com ID `finance`:

`https://localhost/#/site/finance/views`

![Uma janela do navegador da Web exibe um endereço do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/ms_URL.png)

### Verificar o armazenamento de identidades

É possível exportar de e importar para sites que não usem o mesmo tipo de armazenamento de identidades de usuário, mas será necessário modificar os arquivos de mapeamento usados para a importação. Esta etapa, interna ao processo de importação, é descrita em [Etapa 3: verificar se as configurações do site estão mapeadas corretamente](#verify-site-mappings).

### Criar usuários no servidor de destino, se necessário

O processo de importação de site atribui usuários ao site de destino. Se o site de origem for em uma instância do Tableau Server, que não seja o site de destino, será necessário criar usuários no servidor de destino antes de realizar a importação. Se os dois sites estiverem na mesma instância do Tableau Server, o site de destino terá acesso aos usuários existentes e esta etapa pode ser ignorada.

### Configurar o servidor de destino para fornecer assinaturas

As assinaturas são importadas, mas é necessário configurar o servidor para fornecê-las. Para obter mais informações, consulte [Configurar um site para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm).

### Verificar agendas

A página Agendas lista as agendas existentes para atualizações e assinaturas de extração:

![Agenda de assinatura e atualização de extração.](/tableau/current/pt-br/server/pt-br/Img/sites_schedule.png)

Para migrações **de um site do Tableau Server para outro**, atualizações e assinaturas atribuídas a agendas padrão no site de origem são mapeadas para as mesmas agendas no site de destino. Se o site de origem tem agendas que não existem no site de destino, e este estiver em outra instância do Tableau Server, será necessário criar agendas neste site de destino para as quais as agendas de origem serão mapeadas. É possível editar os arquivos de mapeamento para garantir que isso seja feito da maneira desejada.

## Dicas para importação para um destino com menos usuários e agendas

Quando um site de destino tem menos usuários e agendas que um site de origem, a importação de vários para um não é compatível. A melhor forma de resolver isso dependerá dos sites de origem e destino fazerem parte na mesma instância do Tableau Server.

Você pode adotar uma das seguintes abordagens aplicáveis ao caso de uso de migração do site:

- Remova os usuários ou agendas adicionais do site de origem antes de exportar. Essa é a melhor opção caso os dois sites estejam na mesma instância do servidor.
- Adicione os usuários ou agendas ausentes ao site de destino antes de começar a importação. Essa opção é a necessária se o site de destino estiver em outra instância do servidor.
- Adicione usuários ou agendas ausentes ao site de destino no meio do processo de importação e atualize manualmente os arquivos de mapeamento. Essa opção só é válida se os dois sites estiverem na mesma instância.
- Mapeie manualmente os usuários ou agendas para usuários e agendas diferentes no local de destino durante o processo de importação. Esta opção será necessária se o nome de usuário difere entre os servidores — por exemplo, o usuário exportado chamado _adavis@company.com_ é definido no site de destino como _davisa_.

## Migração de um site

Você deve usar os comandos `tsm sites` para concluir o processo de migração do site. As etapas abaixo orientam você sobre a exportação de informações do site de origem, o mapeamento das configurações do site e a importação dos arquivos mapeados para o site de destino.

### Etapa 1: exportar um site

Na máquina de origem do Tableau Server, digite um comando a seguir:

`tsm sites export --site-id <source-siteID> --file <filename>`  

O Tableau Server deverá estar em execução ao usar o comando `export`. Durante o processo de exportação, o Tableau Server bloqueia o site que você está exportando.

Por exemplo, para exportar um site com a ID **weather-data** no arquivo **export-file.zip**, digite o seguinte:

`tsm sites export --site-id weather-data --file export-file`

Como padrão, o Tableau Server salva `<export-file>.zip` para `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports`. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm#import-file-location).

### Etapa 2: gerar os arquivos de mapeamento de importação

Para gerar arquivos de importação para o site de destino, você precisa do arquivo .zip criado após as etapas em [Etapa 1: exportar um site](#export-site-steps).

1. Na máquina de destino do Tableau Server, copie o arquivo .zip exportado para o diretório em que o Tableau Server espera encontrar os arquivos para importação. Por exemplo:
    
    `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports`
2. Verifique se o site de destino já existe no Tableau Server, pois o processo de importação não criará um novo site. Para obter mais informações, consulte [Preparar os sites de origem e destino](#before-you-export).
3. Execute o comando a seguir na máquina de destino do Tableau Server (o Tableau Server deve estar em execução):
    
    `tsm sites import --site-id <target-siteID> --file <export-file.zip>`
    
    Este comando gera um conjunto de arquivos .csv que mostram como as configurações do site serão mapeadas para o site de destino. Nas etapas descritas na seção a seguir deste artigo, você confirma esses mapeamentos e os ajusta quando necessário.
    
    Por padrão, os arquivos .csv são gerados para um diretório `mappings` criado em `siteimports`. Por exemplo:
    
    `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_<id>_<date-time>\mappings`
    
    Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm#import-file-location).

### Etapa 3: verificar se as configurações do site estão mapeadas corretamente

Os arquivos .csv gerados na seção anterior descrevem como os recursos do site de origem serão atribuídos ao site de destino, quando a importação estiver concluída. Os itens nos arquivos que o Tableau Server não conseguiu mapear, mas que você precisa editar, são indicados por uma série de pontos de interrogação (`???`). Para concluir o processo de importação, você precisa substituir os pontos de interrogação por atribuições válidas no site de destino.

**Importante:** alguns requisitos se aplicam aos usuários de mapeamento, agendas e recursos de conteúdo publicado, especialmente quando os sites de origem e destino estão em instâncias do Tableau Server separadas. Para obter mais informações, consulte [Preparar os sites de origem e destino](#before-you-export) em etapas anteriores descritas neste artigo.

#### Para verificar os arquivos de mapeamento

1. Navegue até o diretório que contém os arquivos de mapa .csv gerados pelo comando `tsm sites import`. Como padrão:
    
    `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_<id>_<date-time>\mappings`
2. Use seu editor de texto preferido para abrir um dos arquivos .csv no diretório `mappings` e faça o seguinte.
    
    1. Confirme se os mapeamentos estão corretos.
    2. Se uma entrada mostrar uma série de pontos de interrogação (`???`), substitua-os por um valor válido.
        
        Para obter as descrições da configurações em cada um desses arquivos, use as tabelas em [Mapeamento da referência de conteúdo do arquivo](#map-file-reference) mais adiante neste artigo.
    3. Salve as alterações e preserve a formatação do arquivo CSV.
    
    Repita esse processo para os arquivos .csv remanescentes.

### Etapa 4: importar os arquivos mapeados corretamente para o site de destino

Após verificar os mapeamentos do site nos arquivos .csv, importe as configurações para o novo site para concluir o processo de migração.

1. Execute o comando a seguir na máquina de destino do Tableau Server:
    
    `tsm sites import-verified --import-job-dir <import-id-directory> --site-id <target-siteID>`
    
    Por exemplo:
    
    `tsm sites import-verified --import-job-dir "C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457"   --site-id new-site`
2. Quando a mensagem de sucesso aparecer, entre no novo site e confirme se tudo foi importado conforme o esperado.

**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`.

## Mapeamento da referência de conteúdo do arquivo

As tabelas a seguir listam as colunas em cada um dos arquivos de mapeamento criados quando o comando `tsm site import` é executado.

### Nome de arquivo CSV: mappingsDomainMapperForGroups

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 35%;"><col style="width: 15%;"><col style="width: 50%;"></colgroup><tbody><tr><th><p>Título da coluna</p></th><th><p>Pode ser editado?</p></th><th><p>Descrição</p></th></tr><tr><td><p>source_name</p></td><td><p>Não</p></td><td><p>Um nome de grupo de usuários no site de origem.</p></td></tr><tr><td><p>source_domain_name</p></td><td><p>Não</p></td><td><p>O tipo de armazenamento de identidades do usuário no site de origem: <b>local</b> (no caso de armazenamento de identidades local) ou um nome de domínio (no caso do Active Directory ou armazenamento de identidades externo LDAP).</p></td></tr><tr><td><p>target_domain_name</p></td><td><p>Sim*</p></td><td><p>O tipo de armazenamento de identidades no site de origem: <b>local</b>, no caso de armazenamento de identidades local, ou um nome de domínio (como example.com ou examplo.Ian) no caso do Active Directory ou armazenamento de identidades externo LDAP.</p><p>*Para o grupo <span class="uicontrol">Todos os usuários</span>, mantenha o valor <b>target_domain_name</b> definido como <b>local</b>, mesmo que o seu servidor de destino esteja configurado para armazenamento de identidades do Active Directory. O grupo <b>Todos os usuários</b> é um grupo de usuários padrão especial que precisa existir em cada Tableau Server.</p></td></tr></tbody></table>

### Nome de arquivo CSV: mappingsScheduleMapper

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 35%;"><col style="width: 15%;"><col style="width: 50%;"></colgroup><tbody><tr><th><p>Título da coluna</p></th><th><p>Pode ser editado?</p></th><th><p>Descrição</p></th></tr><tr><td><p>source_name</p></td><td><p>Não</p></td><td><p>Os nomes das agendas de extração ou assinatura padrão e personalizadas no site de origem.</p></td></tr><tr><td><p>source_scheduled_action_type</p></td><td><p>Não</p></td><td><p>O tipo de agenda, <b>Atualizar extração</b> para atualizações de extração ou <b>Inscrições</b> para fornecê-las no site de origem.</p></td></tr><tr><td><p>target_name</p></td><td><p>Sim</p></td><td><p>Os nomes das agendas personalizadas no site de destino. Você pode editar esse valor. Por exemplo, se o nome da agenda é <b>Atualização de sexta</b> no site de origem, você pode renomeá-lo como <b>Atualização de sexta</b> no site de destino.</p></td></tr><tr><td><p>target_scheduled_action_type</p></td><td><p>Não*</p></td><td><p>O tipo de agenda, <b>Atualizar extração</b> para atualizações de extração ou <b>Inscrições</b> para fornecimentos de inscrição no site de destino.</p><p>*Se aparecerem pontos de interrogação (<code>???</code>) nesta coluna, substitua-os por <b>Atualizar extração</b> ou <b>Assinaturas</b>, para corresponder à entrada exibida sob <b>source_scheduled_action_type</b>.</p></td></tr></tbody></table>

### Nome de arquivo CSV: mappingsSiteMapper

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 35%;"><col style="width: 15%;"><col style="width: 50%;"></colgroup><tbody><tr><th><p>Título da coluna</p></th><th><p>Pode ser editado?</p></th><th><p>Descrição</p></th></tr><tr><td><p>source_url_namespace</p></td><td><p>Não</p></td><td><p>ID do site de origem.</p></td></tr><tr><td><p>target_url_namespace</p></td><td><p>Não</p></td><td><p>A ID&nbsp;do site de destino.</p></td></tr></tbody></table>

### Nome de arquivo CSV: mappingsSystemUserNameMapper

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 35%;"><col style="width: 15%;"><col style="width: 50%;"></colgroup><tbody><tr><th><p>Título da coluna</p></th><th><p>Pode ser editado?</p></th><th><p>Descrição</p></th></tr><tr><td><p>source_name</p></td><td><p>Não</p></td><td><p>O atributo do nome de um usuário no site de origem.</p></td></tr><tr><td><p>source_domain_name</p></td><td><p>Não</p></td><td><p>O tipo de armazenamento de identidades no site de origem: <b>local</b> (para armazenamento de identidades local), um nome de domínio (para armazenamento de identidades no Active Directory ou LDAP) ou <span class="uicontrol">externo</span>.</p></td></tr><tr><td><p>target_name</p></td><td><p>Sim</p></td><td><p>O atributo de nome de usuário que será atribuído ao site de destino na importação.</p><p>Confirme se todos os nomes de usuário na lista estão no servidor de destino e substitua os pontos de interrogação (<code>???</code>) pelos nomes de usuário existentes no servidor de destino.</p><p>Não é possível criar nomes de usuário adicionando linhas ao arquivo CSV. Da mesma forma, não é possível remover nomes excluindo linhas.</p><p>É possível editar um nome de usuário na coluna <b>target_name</b> para ficar diferente do nome de usuário correspondente na origem, visto que o usuário já existe no servidor de destino usando esse outro nome.</p><p>Por exemplo, um usuário pode ter um valor <b>source_name</b> de <b>agarcia@company.com</b> e um valor <b>target_name</b> de <b>ashleygarcia@company.com</b>.</p><p>É possível mapear um usuário do site de origem para somente um nome de usuário no site de destino.</p></td></tr><tr><td><p>target_domain_name</p></td><td><p>Sim</p></td><td><p>O tipo de armazenamento de identidades do usuário no site de destino: <b>local</b> (no caso de armazenamento de identidades local) ou um nome de domínio (no caso do Active Directory ou armazenamento de identidades externo LDAP).</p></td></tr></tbody></table>

### Nome do arquivo CSV: MappingsScheduleRecurrenceMapperWithAutoCreation

Esse arquivo não exige atualizações.

<!-- document id=7b6f2857ed5396006e54245639a128b1cc90d46766c9c367449cdd09f261b7ef url=/tableau/current/pt-br/server/ts_table_extensions.md -->

[Pular para o conteúdo principal](#main-content)

# Extensões da tabela

As Extensões da tabela permitem que você crie novas tabelas de dados com um script de extensões do Analytics. Você pode escrever um script TabPy ou Rserve personalizado e, opcionalmente, adicionar uma ou mais tabelas de entrada. As extensões de tabela são compatíveis com Tableau Cloud, Tableau Server e Tableau Desktop. Este documento é voltado para o Tableau Server.

**Observação:** os dados são atualizados sempre que você abre uma pasta de trabalho ou atualiza uma fonte de dados.

### Benefícios

As Extensões da tabela têm os seguintes benefícios para usuários novos e experientes.

- Processamento de dados mais rápido
- Editor de código baixo
- Integra-se a [Pergunte aos dados](https://help.tableau.com/current/server/pt-br/ask_data.htm) e [Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm)
- Integra-se com TabPy e Rserve
- Os resultados podem ser usados para construir painéis ou visualizações.

## Pré-requisitos

Antes de poder usar extensões de tabela, você deve preencher a lista a seguir.

- Configurar uma extensão de análise
    - Para conhecer as etapas de configuração de conexões de extensão de análise, consulte [Configurar conexões com extensões do Analytics](https://help.tableau.com/current/server/pt-br/config_r_tabpy.htm).
- Publique sua pasta de trabalho.

## Criar uma extensão de tabela

Para criar uma nova extensão de tabela, conclua as etapas abaixo.

1. Abra uma pasta de trabalho publicada.

**Observação:** a pasta de trabalho deve ser publicada antes que você possa adicionar uma extensão de tabela.

3. Em **Planilhas**, escolha **Nova extensão de tabela**.
    
    ![menu de conexões](/tableau/current/pt-br/server/pt-br/Img/new_table_extension.png)
4. (Opcional) Arraste as planilhas para o painel de extensão da tabela.
5. Em **Escolher uma conexão**, selecione uma extensão de análise.
    
    ![menu suspenso de extensões do Analytics](/tableau/current/pt-br/server/pt-br/Img/choose_analytics_extension.png)
6. Em **Script**, insira seu script.
7. Selecione **Aplicar**.
8. Escolha **Atualizar agora**, e os resultados aparecerão na guia **Tabela de saída**.
    
    ![tabela de resultados de saída](/tableau/current/pt-br/server/pt-br/Img/table_extension_output_table.png)
9. No campo **Nome** digite um nome para a nova extensão da tabela.
10. Vá para a guia da planilha e publique a pasta de trabalho para salvá-la.

**Observação:** se você editar a tabela de entrada, deverá pressionar **Aplicar** novamente antes de poder ver ou usar os dados atualizados da tabela de saída.

> [!TIP]
> 
> **Dica de solução de problemas**: se a extensão da sua tabela estiver apresentando um erro, tente usar o botão circular **Atualizar** **fonte** **de dados**, localizado ao lado do botão **Salvar**.

### **Extensões de tabela versus extensões do Analytics**

O Tableau tem alguns recursos diferentes com "extensão" no nome. Embora alguns desses produtos não estejam relacionados, as extensões de tabela e as extensões do Analytics estão. O recurso de extensões de tabela depende de uma conexão com extensões do Analytics para funcionar. Detalharemos cada recurso.

#### Extensões da tabela

O recurso de extensões de tabela permite criar cálculos de pasta de trabalho que enviam dados e um script de processamento para sua extensão de análise. Os resultados retornados são exibidos como uma tabela na guia Fonte de dados e como medidas e dimensões na pasta de trabalho.

#### Extensões do Analytics

O recurso de extensões do Analytics permite estender os cálculos dinâmicos do Tableau com linguagens de programação como Python, ferramentas externas e plataformas externas. Após criar uma conexão com uma extensão de análise, você se comunicará com seu serviço externo por meio de campos calculados. Para obter mais informações, consulte [Configurar conexões com extensões do Analytics](https://help.tableau.com/current/server/pt-br/config_r_tabpy.htm).

<!-- document id=bf3f677c158ca53527e3eb2ce833bcbeb5539bcce6d3bf0fd460484528a7a79d url=/tableau/current/pt-br/server/distrib_ha_failover.md -->

[Pular para o conteúdo principal](#main-content)

# Failover de repositório

Em uma instalação do Tableau Server, o banco de dados do repositório (pgsql) é um dos processos-chave obrigatórios. O repositório do Tableau Server armazena informações sobre usuários e grupos do Tableau Server, além de atribuições de grupo, permissões, projetos, fontes de dados, metadados de extrações e informações sobre atualizações. Como isso é essencial para o funcionamento do servidor, o Tableau Server fornece um "failover" automático integrado ao repositório quando o servidor é instalado em um ambiente distribuído que atende a requisitos específicos.

## Failover automático de repositório

O failover automático de repositório significa que se houver um problema com o repositório ativo do Tableau Server, o servidor alterna automaticamente para o repositório passivo. Isso não acontece imediatamente para proteger contra problemas efêmeros com o repositório que não justificam uma troca, mas se o repositório estiver indisponível por mais de 1-5 minutos, ocorrerá o failover. Por exemplo, se o serviço PostgresSQL subjacente falhar, o failover ocorrerá em cerca de um minuto. No entanto, outros problemas de configuração podem não desencadear uma falha por até 5 minutos.

Para que o failover automático de repositório funcione, a instalação do Tableau Server requer:

- No mínimo, três nós
- Duas instâncias do repositório instalado
    
    Opcional, mas altamente recomendado:
- A implantação de um ensamble de Serviços de coordenação de vários nós

Ao atender essas condições, o failover do repositório ocorrerá se o repositório ativo ficar indisponível, devido a um problema com o processo ou uma problema com o nó em que o processo é executado. Se o repositório original ficar disponível novamente (por exemplo, se o nó for reiniciado e todos os processos forem executados normalmente), ele é transformado em repositório passivo, disponível para failover, se necessário.

## Failover manual de repositório

Existem muitos motivos para voltar ao repositório original após o failover. Um deles seria se a instância do repositório for instalada em um computador com mais recursos. Para fazer isso, use o comando `tsm topology failover-repository` com o objetivo de alternar manualmente para o repositório original. Para obter mais informações, consulte [tsm topology failover-repository](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMFailoverRepository).

## Repositório ativo de preferência

Ao configurar o Tableau Server você tem a opção de especificar um nó como o repositório ativo de preferência. Quando o Tableau Server estiver configurado para failover de repositório, o nó do repositório ativo de preferência é aquele usado para o repositório ativo. Esta etapa é opcional, e caso um nó do repositório ativo de preferência não seja especificado, o Tableau Server irá selecionar o nó do repositório ativo ao iniciar.

Para configurar o repositório ativo de preferência, use o comando `tsm configuration set` para definir a opção `pgsql.preferred_host`:

`tsm configuration set -k pgsql.preferred_host -v "<host_name>"`

**Observação:** o `host_name` diferencia maiúsculas de minúsculas e deve corresponder ao nome do nó mostrado na saída do `tsm status -v`.

Configure um nó de repositório ativo de preferência se quiser que o Tableau Server selecione um nó específico ao iniciar. Você pode desejar fazer isso se tiver um servidor em particular que queira usar para seu repositório ativo (um computador com mais espaço no disco ou na memória, por exemplo), ou se estiver usando exibições administrativas personalizadas. Exibições administrativas personalizadas possuem informações de conexão inseridas que referem-se ao repositório para o qual as exibições foram criadas. Para obter mais informações sobre como se conectar ao repositório do Tableau Server, consulte [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm)

<!-- document id=789e4ea3b44c189e58401e4bd3782d7839d45e28f28228b2e04495e8673e65cf url=/tableau/current/pt-br/server/rmt-incidents-extract-failure.md -->

[Pular para o conteúdo principal](#main-content)

# Incidentes de falha de extração

Os incidentes de _Falha na extração_ serão registrados como um aviso, quando houver uma falha de extração no Tableau.

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=d1ffe987a7a42347ee7b022fc20911cad31c4e3a48953401f93660ff2d3e068c url=/tableau/current/pt-br/server/db_backup.md -->

[Pular para o conteúdo principal](#main-content)

# Fazer backup dos dados do Tableau Server

É importante fazer backup do Tableau Server regularmente como parte da manutenção e administração apropriada do seu servidor. É possível usar o comando `tsm maintenance restore` para restaurar backups do Tableau Server criados usando o comando `tsm maintenance backup`. Backups de bancos de dados feitos de outras maneiras e instantâneos da máquina virtual não são fontes válidas para restaurar o Tableau Server, então é importante ter um backup atualizado.

Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.

Procurando o Tableau Server no Linux? Consulte [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server-linux/pt-br/db_backup.htm "Abre o tópico em uma nova guia do navegador").

Os dados do Tableau Server incluem arquivos de dados de extração, bem como o banco de dados PostgreSQL do Tableau, que contém metadados da pasta de trabalho e do usuário e dados de configuração. Quando você usa o TSM para criar um backup, tudo isso é salvo em um único arquivo criado com a extensão .tsbak. Se você estiver executando uma instalação distribuída do Tableau Server, é feito um backup dos dados de todos os nós.

A frequência dos seus backups depende do seu ambiente, incluindo a intensidade de uso de seu servidor e o número e a frequência de alterações do conteúdo e do usuário. Qualquer alteração ou atualização que acontecer após o backup será perdida se houver uma falha no sistema e você precisar restaurar o Tableau Server. Quanto mais atividade, mais frequentemente você precisará fazer backup no servidor.

Além de backups agendados regularmente, _sempre_ crie um backup antes de atualizar para uma nova versão do Tableau Server. O processo de atualização não cria um backup, exceto quando a versão do PostGRES está sendo atualizada e, em seguida, o processo de atualização cria um backup somente do PostGRES para ser usado internamente.

Para ajudar na proteção contra perda de dados, após criar o backup, armazene o arquivo .tsbak em um computador que não faça parte da instalação do Tableau Server.

## Uso do espaço em disco para backup

O espaço em disco livre necessário para criar um backup varia dependendo da quantidade de dados nos serviços de armazenamento de arquivos e Repositório do Tableau Server, além de sua localização com o serviço tabadmincontroller. Durante os backups, as tarefas em segundo plano para limpeza de extrações antigas são temporariamente pausadas. Isso significa que, durante o backup, as atualizações de extração deixarão os arquivos extras no lugar, adicionando ao uso de espaço em disco. Se o backup demorar muito ou se a organização usar muitas extrações regularmente atualizadas, isso poderá resultar em uma quantidade significativa de uso de espaço em disco temporário. Esses arquivos temporários serão removidos depois que o backup for concluído.

A tabela a seguir lista os requisitos de espaço em disco para backup com base em se o nó hospeda o repositório, no armazenamento de arquivos, no controlador ou alguma combinação deles. Em ambientes do Tableau Server com vários nós, você precisa estimar o espaço em disco necessário em cada nó.

<table style="max-width: 100%;" class="simple-table"><colgroup><col style="width: 110px;"><col style="width: 110px;"><col style="width: 107px;"><col></colgroup><tbody><tr><th>Repositório</th><th>Armazenamento de arquivo</th><th>Controlador</th><th>Espaço em disco necessário</th></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td>&nbsp;</td><td><p>Dados de repositório 3x + 250 MB</p><p>Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório <code>&lt;data directory&gt;/pgsql/data/base</code>.</p><p>Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo workgroup.pg_dump.</p></td></tr><tr><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td><p>Dados do armazenamento de arquivos 1.5x</p><p>Para obter uma estimativa dos dados do armazenamento de arquivos (extrações, fluxos etc.), verifique o tamanho do diretório <code>&lt;data directory&gt;/dataengine</code>.</p></td></tr><tr><td>&nbsp;</td><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr></tbody></table>

## Otimização de backup no Tableau Server

Há várias maneiras de maximizar a eficiência do backup. Seu ambiente pode afetar a eficiência de cada um deles, então teste com seus dados para ver o que funciona melhor.

**Otimização com configurações de topologia:**

- Colocalizar o Armazenamento de arquivos no mesmo nó que o Controlador de administração pode reduzir o tempo necessário para fazer backup do Tableau Server, reduzindo ou eliminando a necessidade de transferir dados entre nós durante o processo de backup. Isso é especialmente verdade se sua organização usa muitos extratos.
- A colocalização do repositório (pgsql) com o nó Controlador de administração também pode ajudar a reduzir o tempo de backup, mas a economia de tempo é menos significativa do que a do Armazenamento de arquivos.

O Controlador de administração geralmente está no nó inicial, a menos que você tenha tido uma falha no nó inicial e movido o controlador para outro nó.

Otimização com estratégias de backup:

Backup é um processo que utiliza muitos recursos. Se possível, é uma boa estratégia fazer seus backups durante os horários menos movimentados. No entanto, isso depende de seus requisitos de restauração e com que frequência os dados do Tableau Server são atualizados. Para obter uma explicação detalhada sobre backup e recuperação de desastres, consulte [Recuperação de desastres do Tableau Server](https://www.tableau.com/sites/default/files/whitepapers/disaster_recovery_whitepaper_0.pdf). Aqui estão algumas estratégias de backup, adote-as para suas necessidades

- **Tipo de armazenamento:** os discos de estado sólido são recomendados em geral para backups. O SSD ajuda a tornar logo os seus backups mais rápidos e completos, em comparação com os discos giratórios tradicionais.
- **Compactação de backup:** você tem a opção de executar seus backups com ou sem compactação. Quando você fizer seu backup com compactações, seu tamanho de backup será relativamente menor, mas você pode perceber um desempenho mais lento. Então, se o seu objetivo é mais velocidade, escolha a opção `--skip-compression`:
    
    Use a opção `--skip-compression` ao fazer backup do Tableau Server. Isso cria o backup sem usar compactação e resulta em um arquivo de backup maior, mas pode reduzir o tempo necessário para que o backup seja concluído. Para obter mais informações, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm).
- **Backup instantâneo:** essa opção só estará disponível se você tiver configurado o servidor Tableau Server com Armazenamento de arquivos externos. Embora o desempenho dos backups instantâneos dependa do tipo de armazenamento conectado à rede, em geral eles são mais rápidos do que os backups tradicionais do Tableau Server. Para obter mais informações, consulte [Armazenamento de arquivos externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm).

## Criar um backup usando a interface de linha de comandos (CLI) do TSM

Use o comando `tsm maintenance backup` para criar um backup dos dados gerenciados pelo Tableau Server. Estes dados incluem arquivos de dados de extração e o banco de dados PostgreSQL do Tableau, que contém metadados da pasta de trabalho e do usuário.

**Importante:** não use a opção `pg-only` ao gerar um backup, a menos que seja instruído pelo Suporte do Tableau. Essa opção fará backup apenas do repositório e _não pode_ ser usada para restaurar seu servidor. Seu uso principal é para solução de problemas, e o Suporte do Tableau solicitará que você crie um backup de `--pg-only` se for necessário.

Antes de fazer backup do Tableau Server, verifique se as permissões estão configuradas corretamente para os seguintes cenários:

- O Tableau Server instalado em uma unidade não padrão: se você tiver instalado o Tableau Server em uma unidade ou pasta não padrão, será necessário configurar manualmente as permissões para a conta de Serviço de rede. Talvez seja necessário configurar também permissões adicionais para a conta de serviço Run As. Consulte [Instalando em um local não padrão](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm#Installi).
- Ao fazer backup do Tableau Server no Windows para uma unidade de rede, a conta da Máquina deve ter acesso de gravação ao compartilhamento de rede onde os arquivos de backup são gravados (normalmente esse não é o caso e você é responsável fazer essa configuração, se quiser fazer backup do servidor para um compartilhamento de rede).

Para fazer backup dos dados de configuração do servidor, use o comando [tsm settings](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm). Ao usar o comando `tsm maintenance backup`, a data atual é anexada ao arquivo de backup:

`tsm maintenance backup -f <backup_file> -d`

Para obter mais informações, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm).

## Criar um backup de pré-atualização

Você deve sempre criar um backup antes de atualizar o Tableau Server. Também é possível criar um backup durante a execução do Tableau Server e minimizar a quantidade de tempo de indisponibilidade do servidor durante a atualização. O processo para criar um backup de pré-atualização é o mesmo para a criação de backups regulares, com uma consideração adicional para as instalações distribuídas.

**Observação:** desinstale o Tableau Server de dos nós que não serão incluídos na nova instalação para evitar conflitos entre os nós mais antigos e a nova instalação.

## Backups durante upgrades

Durante uma atualização do Tableau Server, quando necessário, um backup temporário do banco de dados é criado para permitir migrações que ocorrem como parte de atualizações. Isso é feito durante a atualização e, na maioria dos casos, não tem impacto perceptível no processo de atualização. Em certos casos especiais, pode haver impactos adicionais:

- Atualizações para o Tableau Server 2022.1 (ou posterior) da versão 2021.4 (ou anterior) —Se você fizer atualizações Azuis/Verdes ou atualizar manualmente o Tableau Server 2021.4 (ou anterior) usando o método de [manutenção tsm (backup e restauração)](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm) , você deverá habilitar`legacy-identity-mode` antes de poder restaurar para o Tableau Server 2022.1 (ou posterior). Para obter mais informações, consulte [Solucionar problemas com migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm).
- Principais atualizações de pgsql — Se uma atualização incluir uma atualização de versão principal no banco de dados usada para o repositório do Tableau, o backup de atualização interna será feito sem compactação para economizar tempo. Isso requer espaço adicional de disco temporário durante o processo de atualização.
    
    Versões do Tableau Server que incluem uma atualização de banco de dados de versão principal; 2020.4.

## Agendamento e gerenciamento de backups

A partir de 2020.4.0, você pode usar comandos tsm para agendar um backup. Você precisa fazer isso na linha de comando (não há interface do TSM para agendar backups). O comando `[tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm)` permite que você crie e atualize os horários de backup. Os comandos `[tsm schedules](https://help.tableau.com/current/server/pt-br/cli_schedules_tsm.htm)` lhe dão a capacidade de visualizar, excluir, pausar, retomar e atualizar horários.

### Para agendar um backup:

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute o seguinte comando:
    
    tsm maintenance backup -f <backup-file> -sr <recurrence> -st <time-to-run> -sd <days-to-run> -sn <schedule-name>
    
    Por exemplo, para criar uma agenda de backup chamada "backup mensal" executada no dia 15 de cada mês às 2 da manhã e gerar um arquivo chamado `<yyyy.mm.dd.hh.mm>-ts-mid_month_backup.tsbak`:
    
    tsm maintenance backup -f ts-mid\_month\_backup -sr monthly -st 02:00 -sd 15 -sn monthly-backup

### Para visualizar um backup agendado:

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute o seguinte comando:
    
    tsm schedules list 
    
    Você pode classificar os horários pelo horário de execução agendado, do mais cedo para o mais recente, ou pelo nome usando as opções `--next-run` ou `--schedule-name`. Você pode exibir alternadamente detalhes para uma única agenda usando a opção `--schedule-id`. Quando você visualiza uma única agenda, você vê detalhes adicionais sobre ela, incluindo quando foi criada, quantas vezes foi executada e opções específicas usadas quando ela é executada. As opções de trabalho são mostradas no formato JSON como "Job args".

### Para atualizar um backup agendado:

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute o seguinte comando:
    
    tsm schedules update --schedule-id <ID> --schedule-time <time-to-run> --schedule-recurrence <frequency> --schedule-days <day-to-run>
    
    **Observações:** oara adicionar ou alterar um nome, use o comando `tsm-maintenance-backup`.

### Para suspender ou retomar uma agenda de backup:

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute um dos seguintes comandos:
    
    - Para suspender uma agenda:
        
        tsm schedules suspend --schedule-id <scheduleID>
    - Para retomar uma agenda suspensa:
        
        tsm schedules resume --schedule-id <scheduleID>

## Criar o script para o processo de backup

Caso faça o backup frequentemente, talvez deseje criar um script que execute o backup e as tarefas relacionadas. Essas tarefas incluem:

- Limpe arquivos e pastas antes de executar o backup.
- Executar o próprio backup.
- Copiar o arquivo de backup em um computador separado para proteção.

Esta seção discute os comandos `tsm` que podem ser usados em conjunto para executar um backup e as tarefas relacionadas.

**Observação:** o TSM é um arquivo de lote. Para executar comandos tsm em outro arquivo de lote, use o comando `call` . Por exemplo, "`call tsm maintenance ziplogs`”. Executar essa ação retornará o controle para o arquivo de lote. Você também precisa fazer autenticação no TSM antes de emitir qualquer comando. Para obter mais informações, consulte [Autenticação com a CLI tsm](https://help.tableau.com/current/server/pt-br/tsm.htm#Authenti).

### Remover arquivos de log e limpar pastas temporárias

É possível limpar o arquivo de registro antigo do Tableau Server e os arquivos temporários para reduzir o tempo de criação de um backup e garantir que o arquivo de backup seja o menor possível.

Para limpar os arquivos de log anteriores a alguns dias, execute o seguinte comando:

`[tsm maintenance cleanup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cleanup)`

### Executar o backup

**Observação:** Ao fazer backup do Tableau Server no Windows para uma unidade de rede, a conta da Máquina deve ter acesso de gravação ao compartilhamento de rede onde os arquivos de backup são gravados (normalmente esse não é o caso e você é responsável fazer essa configuração, se quiser fazer backup do servidor para um compartilhamento de rede).

Para criar o backup, use o comando `[tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm)`:

`tsm maintenance backup --file <backup_file> --append-date`

Observe o seguinte sobre o comando:

- Adicione `--append-date` ao comando para incluir a data no nome de arquivo de backup.
- O arquivo de backup é reunido em um local temporário no diretório de dados e, em seguida, gravado no diretório definido na variável `basefilepath.backuprestore` do TSM. Como padrão:
    
    `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ```<filename>.tsbak`
    
    Para obter mais informações sobre os arquivos de backup e como alterar o local, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm). **Observação:** mesmo ao alterar o local do backup, o processo de backup usa um local temporário no diretório de dados para reunir o arquivo de backup.

### Copiar um arquivo de backup em outro computador

Como uma prática recomendada, após a criação do backup, copie o arquivo de backup em outro local, que seja separado do Tableau Server.

<!-- document id=876506afdba095d2a1e7626eba70af51198df2643c36fc47de37f7356914cb05 url=/tableau/current/pt-br/server/sign_in_server_admin.md -->

[Pular para o conteúdo principal](#main-content)

# Fazer logon na área de administração do Tableau Server

Como um administrador de servidor no Tableau Server, você pode acessar configurações de administração para configurar sites, usuários, projetos e executar outras tarefas relacionadas ao conteúdo.

Se desejar alterar configurações do servidor como processador, armazenamento em cache, autenticação, implantação distribuída e outras configurações relacionadas, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).

Se você usa o Tableau Desktop e quer fazer logon no Tableau Server para publicar ou acessar conteúdo e fontes de dados, consulte [Fazer logon no Tableau Server do Tableau Desktop](https://help.tableau.com/current/pro/desktop/pt-br/sign_in_server.htm).

Como fazer logon nas páginas de administração do Tableau Server:

1. Abra o seu navegador e insira a URL do servidor. Aqui estão alguns exemplos de como a URL pode ser:
    
    `http://localhost/` (se estiver trabalhando diretamente no computador do servidor)
    
    `http://MarketingServer/` (se você souber o nome do servidor)
    
    `http://10.0.0.2/` (se você souber o endereço IP do servidor)
    
    Se o servidor _não_ estiver usando a porta 80, é necessário incluir o número da porta na URL como nesses exemplos:
    
    `http://localhost:8000/`
    
    `http://MarketingServer:8080/`
    
    `http://10.0.0.2:8888/`
    
    ... em que `8000` ou `8080` ou `8888` é a porta que você configurou.
    
    O Tableau Server exibe uma das seguintes páginas, dependendo se [pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm) estão configurados:
    
    - Quando nenhum pool de identidades estiver configurado, uma página onde você pode inserir um nome de usuário e senha.
        
        ![Tela de logon do Tableau com campos para nome de usuário e senha.](/tableau/current/pt-br/server/pt-br/Img/idpools_no_landing_page.png)
    
    - Quando os pools de identidades são configurados, a página de destino do Tableau Server com opções de entrada primária (pool inicial \[TSM configurado\]) e secundária (pools de identidades).
        
        ![A página inicial de logon do Tableau com opções separadas para contratados gerais e consultores fazerem logon.](/tableau/current/pt-br/server/pt-br/Img/idpools_landing_page.png)
2. Insira as credenciais para o administrador de servidor criado ao terminar a instalação do Tableau Server.
    
    Você é então levado para a página principal do site Padrão e está pronto para criar usuários e sites, e para gerenciar conteúdo.

## Redefinir a conta e senha do administrador do servidor

Se você perdeu a senha da conta inicial de administrador do servidor, execute os seguintes comandos:

1. [tsm reset](https://help.tableau.com/current/server/pt-br/cli_reset_tsm.htm).
2. `tabcmd initialuser`. Consulte [initialuser](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#initialu).

## Outros artigos nesta seção

<!-- document id=9b549b661526039f4e6bdd8f118df2d1d5903d56321df995fa2b6f35a9884763 url=/tableau/current/pt-br/server/sign_in_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# Fazer logon na interface do usuário na Web do Tableau Services Manager

Esse tópico explica como fazer logon na interface do usuário na Web do Tableau Server. As páginas de Web do TSM são usadas para definir as configurações do Tableau Server, como autenticação do usuário, processos de servidor, armazenamento em cache, entre outras configurações relacionadas ao servidor. Além disso, é possível configurar o TSM a partir do shell de uma linha de comando. Consulte [Referência da linha de comando tsm](https://help.tableau.com/current/server/pt-br/tsm.htm).

> [!IMPORTANT]
> 
> **Importante:** o logon no TSM _não_ é o mesmo que o para entrar no Tableau Server. O TSM é usado para configurar o servidor e requer uma conta com privilégios administrativos no computador que executa o TSM. Dependendo de como sua empresa está organizada, o administrador do TSM pode ser um usuário que não tem uma conta do Tableau Server. Um administrador do Tableau Server tem acesso a páginas administrativas para criação e edição de sites, usuário, produto e outras tarefas relacionadas ao usuário. Para obter informações sobre o logon no Tableau Server como um administrador, consulte [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).

Se você usa o Tableau Desktop e quer fazer logon no Tableau Server para publicar ou acessar conteúdo e fontes de dados, consulte [Fazer logon no Tableau Server do Desktop](https://help.tableau.com/current/pro/desktop/pt-br/sign_in_server.htm).

## Requisitos

- A conta usada para fazer logon no TSM deve ter autorização para fazer alterações no computador local no qual o Tableau Server está instalado.
    
    Como padrão, a conta usada para fazer logon no TSM deve ser um membro do grupo de administradores o computador Windows no qual o Tableau Server está instalado. Como alternativa, você pode especificar um grupo do Windows para administração TSM. Consulte [Configurar um grupo de administração do TSM personalizado](https://help.tableau.com/current/server/pt-br/security_tsm_admin_group.htm).
- Se você estiver executando uma implantação distribuída do Tableau Server, insira o nome do host ou o endereço IP do computador com o nó inicial em execução. As credenciais inseridas devem ter acesso administrativo ao computador que está executando o nó inicial, conforme especificado acima.
- Especifique um protocolo HTTPS na URL do servidor. O Tableau Server instala um certificado autoassinado como parte do processo de instalação. Sendo assim, o protocolo deve ser especificado como `https`. Para obter mais informações sobre o certificado autoassinado e a confiança de certificado para conexões TSM, consulte [Conexão de clientes do TSM](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).
- Especifique a porta da interface do usuário na Web do TSM (`8850`) na URL.
- Se você estiver executando um firewall local, abra a porta 8850.
- Você deve especificar o nome do host ou o endereço IP do computador que está executando o TSM. Caso tenha configurado uma solução de balanceamento de carga ou proxy na frente do Tableau Server, não especifique o balanceador de carga ou o endereço de proxy.
- Como prática recomendada de segurança, não exponha a porta TSM (por padrão, `8850`) para a internet.

## Fazer logon na interface do usuário na Web do TSM

1. Abra um navegador e insira a URL do Tableau Server, em seguida anexe a porta dedicada da interface do usuário na Web do TSM.
    
    Aqui estão alguns exemplos de como a URL pode ser:
    
    `https://localhost:8850/` (se estiver trabalhando diretamente no computador do servidor)
    
    `https://MarketingServer:8850/` (se você souber o nome do servidor)
    
    `https://10.0.0.2:8850/` (se você souber o endereço IP do servidor)
2. Na página de logon exibida, insira o nome de usuário e a senha do administrador.
    
    **Observação**: o Tableau Server cria e configura um certificado autoassinado durante o processo de instalação. Esse certificado é usado para criptografar o tráfego para a interface do usuário da Web no TSM. Como é um certificado autoassinado, o navegador não confiará nele por padrão. Se estiver entrando na interface do usuário na Web do TSM de um computador remoto (ou seja, fora do cluster do Tableau), seu navegador exibirá um aviso sobre a confiabilidade do certificado antes de permitir que se conecte.
    
    ![página de logon do Tableau Services Manager. requer conta com direitos administrativos locais](/tableau/current/pt-br/server/pt-br/Img/login-tsm-gui.png)

<!-- document id=9daaa5b3bcfd1b1a1060096058c607f06170ccd3ae53fa07cc092e628b4bdd94 url=/tableau/current/pt-br/server/perf_resources.md -->

[Pular para o conteúdo principal](#main-content)

# Ferramentas de monitoramento de desempenho

Este tópico descreve os recursos externos que podem ser usados para monitorar e ajustar o desempenho.

O Tableau Server inclui várias ferramentas que você pode usar para monitorar o desempenho e a saúde do servidor. Para obter mais informações sobre essas ferramentas, consulte [Visão geral do monitoramento de desempenho](https://help.tableau.com/current/server/pt-br/perf_monitor.htm).

**Isenção de responsabilidade**: este tópico inclui informações sobre produtos de terceiros e da comunidade compatíveis. Observe que, ainda que façamos todos os esforços para manter as referências ao conteúdo de terceiros e da comunidade precisas, as informações fornecidas aqui podem mudar sem aviso prévio. Para obter as informações mais atualizadas, consulte a documentação para os produtos referenciados aqui. Para saber mais sobre as ferramentas compatíveis da comunidade, consulte [Níveis de suporte para ferramentas de TI e de desenvolvedor](https://www.tableau.com/pt-br/support-levels-it-and-developer-tools).

- [TabJolt](https://github.com/tableau/tabjolt). Uma ferramenta de teste de carregamento e desempenho que você pode usar para entender como Tableau Server escala com suas cargas de trabalho, em seu ambiente, assim como para informar a escalabilidade e necessidades de capacidade. A seguir, alguns casos de uso principais para quando você usaria o TabJolt:
    
    - Para estabelecer uma linha de base para implementações de teste e desempenho do servidor, antes de transferi-las para ambientes de produção.
    - Em um Tableau Server novo, para ajudar a entender como o novo servidor escala em seu ambiente, especificamente para seu hardware e carga de trabalho?
    - Antes de atualizar para entender como a nova versão vai escalar em seu ambiente.
    - Para encontrar a melhor configuração de implantação de servidor, dado seu hardware, pastas de trabalho e ambientes.
- [Reprodutor](https://community.tableau.com/s/question/0D54T00000CWd7cSAD/replayer). Uma ferramenta que pode reproduzir o tráfego de usuário real baseado no log de um Tableau Server em qualquer outro servidor ou configuração. Reproduz sessões de vários usuários ou de um único usuário do Tableau Server. A Reprodução pode ser usada da seguinte forma:
    
    - Reproduza sessões específicas do Tableau Server e filtre a sessão com base na hora de início ou RequestID.
    - Use-a para simular condições de carga, para testar como dimensionar e equilibrar as instalações do Tableau Server.
    - Realize testes de regressão, executando e comparando cenários completos de usuário para as atualizações do Tableau Server.
    - Capture e relate as exceções HTTP que ocorrem em uma sessão de usuário único.
    - Reproduza um defeito para poder solucionar o problema e verificar se foi corrigido.
- [Scout](https://community.tableau.com/s/question/0D54T00000G54CP/getting-started-scout). Uma ferramenta exploratória que captura as métricas de desempenho em todas as pastas de trabalho no Tableau Desktop e Tableau Server Estas são algumas formas de usar o Scout:
    
    - Encontre pastas de trabalho lentas no servidor.
    - Verifique as melhorias ou regressões de desempenho depois de configurar o servidor ou alterar topologias.
    - Verifique se as pastas de trabalho e painéis estão carregando corretamente após atualizar para um novo Tableau Server.
    - Verifique se as pastas de trabalho estão funcionando corretamente após as alterações na fonte de dados.
- [TabMon](https://github.com/tableau/TabMon). Uma ferramenta de monitoramento que usa o Monitor de Desempenho do Windows e Java Management Extensions para gravar os dados de desempenho sobre o Tableau Server em um banco de dados do PostGreSQL.
- [Microsoft System Center.](https://www.microsoft.com/pt-br/cloud-platform/system-center-2012-r2) Um conjunto de produtos de gerenciamento do servidor para monitoramento, configuração, automação, e muito mais.
- [Sitescope](https://software.microfocus.com/pt-br/products/sitescope-application-monitoring/overview). Uma ferramenta de monitoramento de aplicativos sem agente.
- [Zabbix](http://www.zabbix.com/). Uma ferramenta de monitoramento em tempo real de código aberto.
- [Splunk](http://www.splunk.com/). Uma ferramenta para monitoramento e análise de dados do computador, incluindo os logs.
- [Graylog](https://www.graylog.org/). Uma ferramenta de gerenciamento de logs de código aberto.

<!-- document id=859aa1ca5862bb85f70d8b2097aea8e7f48610ae05230d605b795d3409b2fe06 url=/tableau/current/pt-br/server/tableau_admin_salesforce_integration.md -->

[Pular para o conteúdo principal](#main-content)

# Folha de controle do administrador do servidor: integração do Salesforce

Procurando o Tableau Server no Linux? Consulte a [Folha de controle do administrador do servidor: integração do Salesforce](https://help.tableau.com/current/server-linux/pt-br/tableau_admin_salesforce_integration.htm "Abre o tópico em uma nova guia do navegador") .

  

## Ciências empresariais

![Adicionar descrição da imagem](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_Business-Services_big.png)

- [Configurar a Integração de Einstein Discovery](https://help.tableau.com/current/server/pt-br/config_einstein_extensions.htm)
- [Integrar previsões do Einstein Discovery no Tableau](https://help.tableau.com/current/pro/desktop/pt-br/einstein_discovery_predictions.htm)
- [Explorar previsões no Tableau com a extensão do painel Einstein Discovery](https://help.tableau.com/current/pro/desktop/pt-br/einstein_discovery_dashboard_extension.htm)
- [Einstein Discovery: passar expressões com extensões de análise](https://help.tableau.com/current/pro/desktop/pt-br/r_connection_manage.htm#Einstein2)

## Conectar e inserir dados do Salesforce

![Implante na nuvem.](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_ConnectToData_big.png)

- [Inserir exibições do Tableau no Salesforce](https://help.tableau.com/current/pro/desktop/pt-br/embed_ex_lwc.htm)
- [Criar fonte de dados do Salesforce](https://help.tableau.com/current/pro/desktop/pt-br/examples_salesforce.htm)
- [Conectar o Tableau Server ao Salesforce Data Cloud](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc_cdp.htm)
- [Github: Lightning Web Component para inserir o Tableau ao Salesforce](https://github.com/tableau/tableau-viz-lwc)
- [Trailhead: inserir visualizações do Tableau no Salesforce](https://trailhead.salesforce.com/en/content/learn/projects/embed-tableau-visualizations-in-salesforce)

## Autenticação

![Implante o Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_Collaborate_big.png)

- [Alterar o OAuth do Salesforce.com para credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm)
- [Configurar SAML com IdP do Salesforce no Tableau Server](https://help.tableau.com/current/server/pt-br/saml_config_salesforce_server.htm)
- [Configurar SAML para Lightning Web Component de visualização do Tableau](https://help.tableau.com/current/server/pt-br/saml_config_LWC.htm)

<!-- document id=7fc43cd79c8bbd23d306c53b84803e9ab12137a8456f1e8f87d0007f2b0e45a0 url=/tableau/current/pt-br/server/datasource_cube.md -->

[Pular para o conteúdo principal](#main-content)

# Fontes de dados de cubo

As fontes de dados de cubo (multidimensionais) têm certas características que as tornam únicas no Tableau.

As fontes de dados em cubo não oferecem suporte a conexões de passagem. Isso significa que quando uma fonte de dados em cubo é publicada, você não pode fazer uma conexão do Tableau Server usando uma fonte de dados. Também significa que você não pode criar uma pasta de trabalho usando a fonte de dados no Tableau Server.

Publicar uma fonte de dados em cubo no Tableau Server permite-lhe armazenar a fonte de dados no servidor. No entanto, para usar a fonte de dados, você deve baixar a fonte de dados no Tableau Desktop e usá-la localmente. Para baixar uma fonte de dados publicada, é necessário:

- A permissão Baixar/salvar como para a fonte de dados. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#permissioncapabilities).
- Corrija os drivers instalados e as portas abertas no computador em que o Tableau Desktop está instalado.

Para mais informações sobre o uso de fontes de dados de cubo com o Tableau Desktop, consulte [Fontes de dados de cubo](https://help.tableau.com/current/pro/desktop/pt-br/cubes.htm).

<!-- document id=8caae27353840ceb04a8aa59140bbc6e3d203acae06a8071a47748d798cbfe3e url=/tableau/current/pt-br/server/datasource.md -->

[Pular para o conteúdo principal](#main-content)

# Fontes de dados do Tableau Server

Quando os usuários do Tableau querem compartilhar conexões de dados definidas por eles, é possível publicar fontes de dados no Tableau Server. Quando uma fonte de dados é publicada no servidor, outros usuários podem se conectar a ela das próprias pastas de trabalho. Quando os dados na fonte de dados do Tableau são atualizados, todas as pastas de trabalho que se conectam a ela recebem as alterações.

Procurando o Tableau Server no Linux? Consulte [Fontes de dados do Tableau Server](https://help.tableau.com/current/server-linux/pt-br/datasource.htm "Abre o tópico em uma nova guia do navegador").

Uma fonte de dados do Tableau Server é composta de metadados que descrevem:

- **As informações da conexão**: definem se os dados estão em um banco de dados em tempo real ou em uma extração e quais desses dados trazer para o Tableau.
- **Personalização e limpeza**: inclui informações que facilitam o uso eficiente dos dados. Por exemplo, cálculos, conjuntos, grupos, compartimentos, parâmetros, formatação de campo personalizado e outros.
- **Instruções de acesso aos dados e de atualização**: inclui a localização do servidor do banco de dados subjacente (independente de ser local ou na nuvem), caminhos de rede para dados baseados em arquivos, informações de segurança como credenciais ou tokens de acesso e informações relacionadas.

Além de ajudar os usuários a criar consistência e confiabilidade nos dados, as fontes de dados do Tableau oferecem vantagens para você como administrador. Como várias pastas de trabalho podem se conectar a uma fonte de dados, é possível minimizar a proliferação da fonte de dados e economizar espaço de armazenamento e tempo de processamento. Quando você baixa uma pasta de trabalho que se conecta a uma fonte de dados do Tableau que tenha uma conexão de extração, a extração permanece no servidor, o que reduz o tráfego na rede. Finalmente, se a conexão exigir um driver de banco de dados, será necessário instalar e manter o driver apenas no servidor, em vez de no computador de cada usuário. Se você usa o Tableau Cloud, todos os drivers suportados estão disponíveis para as fontes de dados publicadas no seu site.

## Gerenciando fontes de dados

É possível realizar algumas ou todas as tarefas de gerenciamento em uma fonte de dados se você tiver um dos seguintes níveis de acesso:

- Administrador do servidor ou do site
- Líder de projeto ou proprietário do projeto no qual a fonte de dados é publicada
    
    O acesso completo de líder de projeto está disponível apenas com algumas funções de site. Para obter informações, consulte [Administração no nível do projeto](https://help.tableau.com/current/server/pt-br/projects.htm#project-admin).
- Proprietário da fonte de dados

A não ser que você seja um administrador do servidor ou do site, é possível que não tenha acesso a todas as tarefas de gerenciamento. Por exemplo, se o menu Permissões não está disponível, provavelmente as permissões do projeto estão bloqueadas, o que nega a configuração de permissões em pastas de trabalho e fontes de dados individuais.

**Dica:** uma prática recomendada é designar uma pessoa ou equipe para gerenciar todas as fontes de dados publicadas em um projeto ou em todo o site, para que todas as fontes de dados possam ser mantidas sob o mesmo conjunto de diretrizes.

Para realizar as tarefas de gerenciamento às quais você tem acesso, faça o seguinte:

1. Faça logon no site e, na guia Conteúdo, selecione Explorar > Fontes de dados.
2. Em uma fonte de dados, selecione o menu Ações (…).
    
    ![](/tableau/current/pt-br/server/pt-br/Img/data_source_actions_server.png)

- Nova pasta de trabalho ou download: crie uma nova pasta de trabalho no ambiente do navegador que se conecta a uma fonte de dados. Ou baixe a fonte de dados para uso local.
- **Marca:** adicionar ou remover marcas de teclado. As marcas podem conter uma única palavra ou várias, delimitadas por uma vírgula.
- Mover: mover uma fonte de dados de um projeto para outro. Isso exige configurações específicas em cada projeto. Para obter informações, consulte [Requisitos para movimentação de ativos](https://help.tableau.com/current/server/pt-br/projects_add.htm#move-perms)
- **Permissões:** visualize ou atualize permissões que especificam a quais usuários ou grupos podem se conectar, modificar ou baixar fontes de dados. Se esta ação não estiver disponível, as permissões do projeto poderão estar bloqueadas, e apenas o líder de projeto ou o administrador poderá alterá-las.
- **Alterar proprietário:** tornar alguém um proprietário, dá a ele acesso completo.
- **Atualizar extrações:** se uma fonte de dados inclui uma extração, é possível atribuir a extração a uma agenda de atualização.
    
    Para obter informações consulte [Atualizar dados em uma agenda](https://help.tableau.com/current/server/pt-br/schedule_add.htm).
- **Exibir o histórico de revisões da fonte de dados**
- **Excluir:** a exclusão da fonte de dados afeta as pastas de trabalho conectadas a ela. Antes de excluir uma fonte de dados, certifique-se de que nenhuma pasta de trabalho esteja conectada a ela ou edite as pastas de trabalho relevantes para usar outra fonte de dados.

Para fontes de dados que são conexões proxy, os administradores podem ficar atentos ao modo como os usuários se autenticam no banco de dados e se os drivers apropriados estão instalados. Para obter informações, consulte [Drivers de banco de dados](https://help.tableau.com/current/server/pt-br/dbdriver.htm) e [Segurança de dados](https://help.tableau.com/current/server/pt-br/security_data.htm).

## Restrições

As fontes de dados publicadas geralmente funcionam como fontes de dados com curadoria e confiáveis. Portanto, há restrições sobre como elas podem ser modificadas e usadas.

Pseudônimos e cálculos não podem ser editados.

- Novos pseudônimos também não podem ser criados. Os campos podem ser duplicados e a cópia pode ter alias.
- Novos cálculos podem ser criados. O cálculo existente também pode ser copiado, e a cópia pode ser editada.

Relacionamentos e adesões não podem ser editados.

Fontes de dados publicadas não podem ser usadas em uniões de colunas ou relacionamentos.

- Use combinações para combinar fontes de dados publicadas.

<!-- document id=bb41dcdda4c4ee122dae1140420535fcaca9e9174661aeac1eca4d214b3c4c8b url=/tableau/current/pt-br/server/formatting_animations.md -->

[Pular para o conteúdo principal](#main-content)

# Formatar animações

Anime as visualizações para destacar melhor as mudanças de padrões nos dados, revelar picos e valores discrepantes e ver como os pontos de dados se agrupam e se separam.

As animações transitam visualmente entre as configurações de filtro, classificação e zoom, diferentes páginas e alterações nos filtros, parâmetros e ações definidas. À medida que as visualizações são animadas em resposta a essas alterações, os viewers podem ver mais claramente como os dados são diferentes, o que os ajuda a tomar decisões mais bem informadas.

## Noções básicas de animações simultâneas e sequenciais

Ao criar animações, você pode escolher entre dois estilos diferentes: simultâneo ou sequencial. Estes exemplos de cada tipo.

### Animações simultâneas

As animações simultâneas padrão são mais rápidas e funcionam bem quando mostram as alterações de valor nos gráficos e painéis mais simples.

![Uma animação do Tableau.](/tableau/current/pt-br/server/pt-br/Img/animations.gif)  
Clique na imagem acima para reproduzir a animação.

### Animações sequenciais

As animações sequenciais levam mais tempo, mas esclarecem as alterações complexas, mostrando o passo a passo.

![Uma animação sequencial.](/tableau/current/pt-br/server/pt-br/Img/animations_sequential.gif)  
Clique na imagem acima para reproduzir a animação.

## Animar visualizações em uma pasta de trabalho

Quando você cria uma nova pasta de trabalho, o Tableau habilita animações para sua visualização por padrão. Você pode ativar ou desativar as animações no nível do usuário e da pasta de trabalho.  

1. Selecione Formatar > Animações.
2. Se você quiser animar todas as planilhas, em Padrão de pasta de trabalho, clique em Ativar. Em seguida, execute estes procedimentos:
    - Para Duração, selecione uma predefinição ou especifique uma duração personalizada de até 10 segundos.
    - Para Estilo, selecione Simultâneo para reproduzir todas as animações de uma só vez ou Sequencial para esmaecer marcas, mover e classificar marcas e depois esmaecê-las.
3. Para substituir os padrões da pasta de trabalho para determinada planilha, altere as configurações em Planilha selecionada.
    
    **Observação:** na seção Planilha selecionada, o “(Padrão)” indica uma configuração que reflete automaticamente a configuração Padrão da pasta de trabalho relacionada.
    
    ![Painel de animações com opções para configurar animações no nível da pasta de trabalho ou da planilha.](/tableau/current/pt-br/server/pt-br/Img/animations_pane.png)

Para reproduzir uma animação, clique no botão Reproduzir na barra de ferramentas. No botão Repetir, você também pode escolher a velocidade de repetição da animação: velocidade real, dobro de velocidade ou metade da velocidade.

![Menu suspenso do botão de repetição para escolher a velocidade de repetição](/tableau/current/pt-br/server/pt-br/Img/replay_speed.png)

## Redefinir configurações de animação para uma pasta de trabalho

Você pode redefinir as animações para que uma pasta de trabalho inteira retorne às configurações padrão de animação. Saiba que essa ação desativa as animações por padrão.

1. Selecione Formatar > Animações.
2. Na parte central do painel Animações clique em Redefinir todas as planilhas.

## Desativar completamente todas as animações

Quando você cria uma nova pasta de trabalho, as animações são habilitadas por padrão. Se você achar que as animações estão distraindo ao exibir as visualizações, é possível desativá-las completamente para que nunca sejam reproduzidas. (Essa não é uma configuração em todo o sistema. Cada usuário precisa aplicá-la separadamente.)

- No Tableau Desktop, selecione Ajuda > Configurações e desempenhoe desmarque Ativar animações.
- No Tableau Cloud ou no Tableau Server, clique na imagem de perfil ou nas iniciais no canto superior direito do navegador e selecione Minhas configurações de conta. Em seguida, desça até a parte inferior da página, desmarque Ativar animaçõese clique em Salvar Alterações.

**Nota:** quando as animações são desativadas, você ainda pode selecionar Formato > Animações no modo de criação e ajustar as configurações - mas elas não terão efeito.

## Formatar decimais para animações de eixos

Se o número de casas decimais para uma medida for definido como padrão, o número de decimais mostrado durante a animação do eixo pode flutuar durante a animação dos eixos. Para evitar isso, formate o número de casas decimais exibidas para uma medida. Para mais informações, consulte [Formatar números e valores Nulos](https://help.tableau.com/current/pro/desktop/pt-br/formatting_specific_numbers.htm).

## Por que as animações não são reproduzidas

### Renderização do servidor

As animações não serão reproduzidas se uma visualização for renderizada pelo servidor. Para garantir que as visualizações sejam renderizadas em um computador ou dispositivo móvel do cliente, use estas técnicas:

- Se você for um autor de visualização, [reduza a complexidade da visualização](https://help.tableau.com/current/pro/desktop/pt-br/perf_visualization.htm).
- Se você for um administrador do Tableau Server, [aumente o limite de complexidade para renderização do lado do cliente](https://help.tableau.com/current/server/pt-br/browser_rendering.htm).

**Observação:** em computadores com processamentos menos potentes, as animações podem parecer instáveis, mas os usuários podem continuar interagindo com as visualizações sem atrasos na capacidade de resposta.

### Navegadores e recursos não compatíveis

As animações são compatíveis com todos os navegadores da Web, exceto o Internet Explorer.

Os seguintes recursos do Tableau não são animados:

- Mapas, polígonos e marcas de densidade nos navegadores da Web
- Marcas de pizza e texto
- Cabeçalhos
- Previsões, tendências e linhas de referência
- Trilhas de história da página (Se uma visualização as incluir, desligue as animações para evitar comportamentos inesperados.)

<!-- document id=399f95491d7ef2dbd7e6d06fc7c28f0baa92679723420b4df8e63e7b085cdf09 url=/tableau/current/pt-br/server/formatting_specific_numbers.md -->

[Pular para o conteúdo principal](#main-content)

# Formatar números e valores Nulos

Você pode especificar o formato dos valores numéricos exibidos em sua visualização, incluindo medidas, dimensões, parâmetros, campos calculados e rótulos de eixo.Ao especificar um formato numérico, você pode selecionar um conjunto de formatos padrão, como número, moeda, científico e porcentagem.Você também pode definir um formato de número personalizado com a opção de incluir caracteres especiais.

Quando uma medida contém valores nulos, você pode usar a formatação para lidar com os valores nulos de uma maneira diferente, como substituir valores nulos por zeros ou ocultá-los.

## Para o Tableau Desktop

### Especificar um formato de número

1. Clique com o botão direito do mouse (clique pressionando a tecla Control no Mac) em um número na exibição e selecione Formatar.
2. No painel Formatar, clique no menu suspenso Números.
3. Selecione um formato de número.
    
    Alguns formatos requerem configurações adicionais.Por exemplo, caso Científico seja selecionado, também será necessário especificar o número de casas decimais.
    
    ![Painel de formatação com opções para selecionar a quantidade de casas decimais para números científicos.](/tableau/current/pt-br/server/pt-br/Img/numbers1.png)

Esta é uma lista dos formatos de número e das opções associadas que estão disponíveis no Tableau.

<table class="table--plain"><tbody><tr><td style="text-align: center;">FORMATO DE NÚMERO</td><td style="text-align: center;">OPÇÕES DE FORMATO</td></tr><tr><td><b>Automático</b>: o formato é selecionado automaticamente com base no formato especificado pela fonte de dados ou pelos dados contidos no campo.</td><td>Nenhuma.</td></tr><tr><td><b>Número (padrão)</b>: o formato se baseia na localidade selecionada.</td><td><b>Localidade</b>:o formato de número é alterado com base no local geográfico selecionado.</td></tr><tr><td><b>Número (personalizado)</b>: o formato é personalizado de acordo com a sua preferência.</td><td><p><b>Casas decimais</b>: o número de casas decimais a serem exibidas.</p><p><b>Valores negativos</b>: como os valores serão exibidos.</p><p><b>Unidades</b>: o número será exibido usando as unidades especificadas.Por exemplo, se o número for 20.000 e as unidades em milhar, o número será exibido como 20K.</p><p><b>Prefixo/Sufixo</b>: caracteres que precederão e seguirão cada número exibido.</p><p><b>Incluir separadores de milhares</b>: em que o número mostrará separadores a cada milhar (exemplo: 100.000 vs. 100000).</p></td></tr><tr><td><b>Moeda (padrão)</b>: o formato e o símbolo de moeda se baseiam na localidade selecionada.</td><td><b>Localidade</b>: formato de moeda baseado no local geográfico selecionado.</td></tr><tr><td><b>Moeda (personalizada)</b>: o formato e o símbolo de moeda são personalizados de acordo com a sua preferência.</td><td><p><b>Casas decimais</b>: o número de casas decimais a serem exibidas.</p><p><b>Valores negativos</b>: como os valores serão exibidos.</p><p><b>Unidades</b>: o número será exibido usando as unidades especificadas.Por exemplo, se o número for 20.000 e as unidades em milhar, o número será exibido como 20K.</p><p><b>Prefixo/Sufixo</b>: caracteres que precederão e seguirão cada número exibido.</p><p><b>Incluir separadores de milhares</b>: em que o número mostrará separadores a cada milhar (exemplo: 100.000 vs. 100000).</p></td></tr><tr><td><b>Científico</b>: os números são exibidos em notação científica.</td><td><b>Decimal</b>: o número de casas decimais a serem exibidas.</td></tr><tr><td><b>Porcentagem</b>: os números são exibidos como uma porcentagem com o símbolo de percentual.O valor de 1 é interpretado como 100% e 0 como 0%</td><td><b>Decimal</b>: o número de casas decimais a serem exibidas.</td></tr><tr><td><b>Personalizado</b>: o formato se baseia totalmente no que foi especificado nas opções de formato.</td><td><b>Personalizado</b>: digite o formato desejado, incluindo os caracteres especiais (opcional).Consulte “Definir um formato de número personalizado” para obter detalhes.</td></tr></tbody></table>

### Dimensionar valores automaticamente

Com o token `[scale]`, você pode formatar cadeias de caracteres de números personalizadas para dimensionar dinamicamente os valores e anexar os sufixos do Sistema internacional de unidade (SI) apropriados com base em sua magnitude.

Esse token é ideal quando um único campo abrange várias magnitudes (como milhares e milhões), o que garante que cada valor seja exibido claramente em um formato legível, evitando a necessidade de uma unidade uniforme em toda a coluna.

Embora as Unidades de exibição (como Milhares, milhão ou bilhões) imponham uma única unidade fixa em todos os valores em um campo, o token `[scale]` aplica o dimensionamento dinâmico por valor individual.

- **Unidades de exibição**: melhor para impor unidades uniformes em todos os números.
- **Token `[scale]`**: melhor para formatação adaptável, em nível de valor em um único campo.

#### Como o token `[scale]` funciona

Aplicando `[scale]` a um formato personalizado aciona o seguinte processo:

- O Tableau avalia cada ponto de dados individualmente.
- Os valores são divididos por potências de 1.000, conforme apropriado.
- A saída é anexada com um sufixo SI correspondente.

#### Exemplos de formatação de valor escalonado

Usando 0.0`[scale]`:

- 12 renderizações como 12,0
- 1.000 renderizações como 1,0k
- 1.500.000 renderizações como 1,5M
- 2.300.000.000 renderizações como 2,3G
- 0,004 é renderizado como 4,0m

#### Usar `[scale]` em uma cadeia de caracteres de valor personalizada

1. Clique com o botão direito (ou pressione Control + clique no macOS) no número de destino na sua exibição e escolha Formatar.
2. Vá para o painel Formatar, abra o menu suspenso Números e selecione Personalizado.
3. Insira o token `[scale]` na caixa de entrada Formatar (por exemplo, `0.0[scale]`).

#### Observações importantes sobre sufixos e unidades

- `[scale]` utiliza prefixos SI padrão, incluindo `k`, `M`, `G` e `T` para números maiores e `m`, `µ` e `n` para números menores.
- Os prefixos de unidade SI são diferentes dos rótulos Unidades de exibição padrão.Por exemplo, 1.000.000.000 é exibido usando `G` (giga) em vez de `B` (bilhões).
- A marca `[scale]` é digitada diretamente na cadeia de texto de formatação do número personalizado.

### Definir um formato de número personalizado

Para aplicar um formato de número personalizado à sua visualização:

1. Clique com o botão direito do mouse (clique pressionando a tecla Control no Mac) em um número na exibição e selecione Formatar.
2. No painel Formatar, clique no menu suspenso Números e selecione Personalizar.
3. No campo Formato , defina suas preferências de formatação usando a seguinte sintaxe:`Positive number format;Negative number format;Zero values`.

Ao definir seu código de formato de número, lembre-se de que:

- Você pode especificar a formatação para até três tipos de números na seguinte ordem: números positivos, números negativos e zeros.
- Cada tipo de número deve ser separado por um ponto e vírgula (;).
- Se você especificar apenas um tipo de número, o formato desse tipo será usado para todos os números.
- Se você especificar dois tipos de números, o formato do primeiro tipo será aplicado a números positivos e zeros, enquanto o formato do segundo tipo será aplicado a números negativos.
- Se você ignorar tipos em seu código de formato de número, deverá incluir um ponto e vírgula (;) para cada um dos tipos ausentes.

#### Exemplos de formatos de números personalizados

Consulte a tabela a seguir para obter exemplos de códigos de formato de número personalizado comumente usados que você pode usar em sua visualização.

A sintaxe tem três partes: `<positive number format>;<negative number format>;<zero format>` separados por ponto e vírgula.

<table class="table--plain"><tbody><tr><td style="text-align: center;">CASO DE USO</td><td><p style="text-align: center;">SINTAXE DO CÓDIGO DE NÚMERO</p></td><td style="text-align: center;">SAÍDA DE EXEMPLO</td></tr></tbody><tbody><tr><td>Mostrar apenas valores positivos</td><td><p>#,##; ;</p><p>(observe um espaço em branco após o 2º e 3º ponto e vírgula)</p></td><td>Valores positivos: 1.234<br>Valores negativos: (somente o espaço em branco é exibido)<br>Valores zero: (somente o espaço em branco é exibido)</td></tr><tr><td>Mostrar apenas valores negativos</td><td>;-#,##;</td><td>Valores positivos: (nada é exibido)<br>Valores negativos: -1.234<br>Valores zero: (nada é exibido)</td></tr><tr><td>Mostrar apenas valores zero</td><td>;;0;</td><td>Valores positivos: (nada é exibido)<br>Valores negativos: (nada é exibido)<br>Valores zero: 0</td></tr><tr><td>Ocultar valores zero</td><td>#,###;-#,###;;</td><td>Valores positivos: 1.234<br>Valores negativos: -1.234<br>Valores zero: (nada é exibido)</td></tr><tr><td>Mostrar valores negativos entre parênteses</td><td>#,###;(#,###);;</td><td>Valores positivos: 1.234<br>Valores negativos: (1.234)<br>Valores zero: (nada é exibido)</td></tr><tr><td>Adicionar um prefixo de caractere a um valor</td><td>$#,###.##;-$#,###.##;$0;</td><td>Valores positivos: $1.234,56<br>Valores negativos: -$1.234,56<br>Valores zero: $0</td></tr><tr><td>Adicionar um sufixo de caractere a um valor</td><td>#%;-#%;0%;</td><td>Valores positivos: 12%<br>Valores negativos: -34%<br>Valores zero: 0%</td></tr><tr><td>Adicionar descritores de texto</td><td>"$"#,#" Excedente";"$"-##" Escassez"; "$"0;</td><td>Valores positivos: $1.234 Excedente<br>Valores negativos: $-1.234 Escassez<br>Valores zero: $0</td></tr></tbody></table>

Existem várias maneiras de personalizar o formato do número para atender às suas necessidades.Para obter mais orientações e exemplos de código, consulte [Revisrar as diretrizes para personalizar um formato de número](https://support.microsoft.com/pt-br/office/review-guidelines-for-customizing-a-number-format-c0a1d1fa-d3f4-4018-96b7-9c9354dd99f5) na Base de Conhecimento da Microsoft.

**Observação:** há pequenos desvios entre as opções descritas pela Microsoft e as disponíveis no Tableau.Por exemplo, os formatos de número personalizados que alinham o texto nas colunas não são relevantes no Tableau.Além disso, os formatos de número personalizados para o texto do código de cores não são aplicáveis porque você pode aplicar cores ao texto usando o cartão Marcas.(Para obter mais informações sobre a aplicação da cor, consulte [Controlar a aparência das marcas na exibição](https://help.tableau.com/current/pro/desktop/pt-br/viewparts_marks_markproperties.htm).)Certifique-se de usar apenas formatos de número personalizados que se aplicam ao Tableau.

#### Incluir caracteres especiais em um formato de número personalizado

Um dos benefícios da formatação de número personalizada é a capacidade de incluir caracteres ou símbolos especiais.Os símbolos podem facilitar a compreensão rápida de comparações entre medidas e cálculos em sua visualização.

Por exemplo, digamos que você queira mostrar uma comparação mensal dos lucros de três dos produtos mais vendidos da sua empresa.Em vez de usar o rótulo padrão para mostrar que o lucro desses produtos mudou +5%, -2% e 0% do rótulo do mês passado, você pode definir o formato de número personalizado da seguinte forma para mostrar essas alterações como ▲5%,▼ 2% e ►0.

![Formato de número personalizado definido usando caracteres especiais](/tableau/current/pt-br/server/pt-br/Img/CustomNumberFormatCode.png)

### Definir o formato de número padrão para um campo

Clique com o botão direito do mouse (clique pressionando a tecla Control no Mac) em um campo no painel Dados e selecione Propriedades padrão > Formato de número.

Na caixa de diálogo subsequente, especifique um formato de número para ser usado sempre que o campo for adicionado à exibição.O formato de número padrão é salvo com a pasta de trabalho.Também é exportado quando você exporta as informações de conexão.

**Observação:** a formatação de números usando o painel Formatar substitui qualquer formatação que você possa ter aplicado em outro lugar.

### Formatar uma medida como moeda

A exibição na imagem a seguir mostra o lucro ao longo do tempo.Observe que os valores do lucro no eixo vertical não estão formatados como moeda.

![](/tableau/current/pt-br/server/pt-br/Img/FormattingNumbersDates_InitialView.png)

**Para formatar os números como moeda:**

1. Clique com o botão direito do mouse no eixo Lucro e escolha **Formatar**.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/FormattingNumbersDates_FormatAxis.png)
2. Na guia Eixo do painel Formatar, em Escala, selecione a lista suspensa **Números** e, em seguida, selecione uma das seguintes opções:
    
    **Moeda (Padrão)** para adicionar um sinal de dólar e duas casas decimais para os números.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/FormattingNumbersDates_FormatCurrency.png)
    
    **Moeda (personalizada)** para especificar o número de casas decimais, como tratar os valores negativos, as unidades, se um prefixo ou sufixo e separadores de caractere devem ser incluídos.

### Usar a localidade para especificar formatos de número

Por padrão, o Tableau usa as configurações de região e idioma do seu computador para formatar números.Mas uma das opções é definir explicitamente uma localidade diferente no painel **Formatar**.

As etapas seguintes mostram como definir o franco suíço, usando a mesma exibição da seção anterior.

1. Clique com o botão direito do mouse no eixo Lucro e escolha **Formatar**.
2. Na guia Eixo, em Escala, selecione a lista suspensa **Números** e, em seguida, **Moeda (padrão)**.
3. Na lista suspensa **Localidade**, os itens aparecem no formato **Idioma (país)**.Para este exemplo, selecione **Alemão (Suíça)**.A exibição atualiza para mostrar os números das vendas como francos suíços, formatados para o idioma alemão.

**Dica:** é possível alterar a configuração de moeda padrão, de modo que toda vez que a medida de Lucro for arrastada para uma exibição, ela usará as configurações desejadas.No painel Dados, clique com o botão direito em **Lucro** (ou outra medida monetária) e selecione **Propriedades padrão** > **Formato de número**.Em seguida, formate o campo conforme mostrado acima.

### Formatar valores nulos

Quando uma medida contém valores nulos, geralmente eles serão plotados em uma exibição como zero.No entanto, às vezes, isso altera a exibição e você acaba suprimindo todos os valores nulos de uma vez.Você pode formatar cada medida para manipular valores nulos de uma única forma.

**Para formatar valores nulos para um determinado campo:**

1. Clique com o botão direito do mouse na exibição que tem valor nulo (ou clique pressionando a tecla Control no Mac) e escolha Formatar.
2. Vá para a guia **Painel**.
3. Na área Valores especiais, especifique se o campo deve mostrar o valor nulo usando um indicador no canto inferior direito da exibição, plotá-los em um valor padrão (como zero para campos numéricos), ocultar os valor, mas conectar linha, ou ocultar e quebrar a linha para indicar que o valor nulo existe.
    
    ![Painel de formatação com opções sobre como mostrar valores nulos.](/tableau/current/pt-br/server/pt-br/Img/nullvalues3.png)
4. Se o texto for especificado no campo **Texto,** ele aparecerá na exibição para valor nulo quando os rótulos de marca estiverem ativados.Consulte [Mostrar e ocultar rótulos de marca](https://help.tableau.com/current/pro/desktop/pt-br/annotations_marklabels_showhideworksheet.htm#show-and-hide-individual-mark-labels).

**Observação**: a área Valores especiais não está disponível para dimensões ou medidas discretas.

## Para Tableau Server ou Tableau Cloud

### Especificar um formato de número

Ao criar uma exibição na Web, é possível especificar o formato de número de um campo usado na exibição.

1. No modo de criação na Web, clique com o botão direito do mouse na exibição e selecione **Formatar número**.
    
    ![Menu de contexto de medição com opção para formatar números.](/tableau/current/pt-br/server/pt-br/Img/format_numbers_web1.png)
2. Na caixa de diálogo exibida, selecione um formato de número.
    
    Alguns formatos fornecem cadeias de caracteres adicionais.Por exemplo, ao selecionar Moeda, você também pode especificar o número de casas decimais, bem como as unidades e a necessidade de incluir ou não separadores, como vírgulas.
    
    Neste exemplo, Vendas tem formatação de Moeda com as casas decimais e unidades de milhares (k).Os números de vendas na exibição são atualizados com essas definições.Os rótulos e dicas de ferramenta são atualizados também.
    
    ![Um menu suspenso com opções para formatar números como automáticos, número padrão, número personalizado, moeda padrão, moeda personalizada, porcentagem, científicos ou personalizados.](/tableau/current/pt-br/server/pt-br/Img/format_numbers_web2.png)
    
    Esta é uma lista dos formatos de número e das opções associadas que estão disponíveis no Tableau.
    
    <table class="table--plain"><tbody><tr><td style="text-align: center;">FORMATO DE NÚMERO</td><td style="text-align: center;">OPÇÕES DE FORMATO</td></tr></tbody><tbody><tr><td><b>Automático</b>: o formato é selecionado automaticamente com base no formato especificado pela fonte de dados ou pelos dados contidos no campo.</td><td>Nenhuma.</td></tr><tr><td><b>Número (personalizado)</b>: o formato é personalizado de acordo com a sua preferência.</td><td><p><b>Casas decimais</b>: o número de casas decimais a serem exibidas.</p><p><b>Unidades</b>: o número será exibido usando as unidades especificadas.Por exemplo, se o número for 20.000 e as unidades em milhar, o número será exibido como 20K.</p><p><b>Incluir separadores</b>: se o número mostrará separadores a cada milhar (exemplo: 100.000 vs. 100000).</p></td></tr><tr><td><b>Moeda (personalizada)</b>: o formato e o símbolo de moeda são personalizados de acordo com a sua preferência.</td><td><p><b>Casas decimais</b>: o número de casas decimais a serem exibidas.</p><p><b>Unidades</b>: o número será exibido usando as unidades especificadas.Por exemplo, se o número for 20.000 e as unidades em milhar, o número será exibido como 20K.</p><p><b>Incluir separadores</b>: se o número mostrará separadores a cada milhar (exemplo: 100.000 vs. 100000).</p></td></tr><tr><td><b>Porcentagem (Personalizado)</b>: os números são exibidos como uma porcentagem com o símbolo de percentual.O valor de 1 é interpretado como 100% e 0 como 0%</td><td><b>Casas decimais</b>: o número de casas decimais a serem exibidas.</td></tr><tr><td><b>Científico (Personalizado)</b>: os números são exibidos em notação científica.</td><td><b>Casas decimais</b>: o número de casas decimais a serem exibidas.</td></tr></tbody></table>

<!-- document id=f0e1dc644db50eb8fd7bff7cf606f13c37107af545c6baa0eb45020eb163fca6 url=/tableau/current/pt-br/server/dates_custom_date_formats.md -->

[Pular para o conteúdo principal](#main-content)

# Formatos de data personalizados

Este artigo discute o uso do campo de formato de data personalizado para formatar as datas em uma exibição. Para obter uma visão geral de como o Tableau trabalha com datas, consulte [Datas e horários](https://help.tableau.com/current/pro/desktop/pt-br/dates.htm) ou [Alteração de níveis de data](https://help.tableau.com/current/pro/desktop/pt-br/dates_levels.htm) . Para definir as propriedades de data para uma **fonte de dados**, consulte [Propriedades de data para uma fonte de dados](https://help.tableau.com/current/pro/desktop/pt-br/date_properties.htm).

## Como encontrar o campo de formato de data personalizado

### Formatar um campo de data em uma exibição (Tableau Desktop)

Para formatar um campo de data na exibição no Tableau Desktop, clique com o botão direito do mouse (clique pressionando Control, no Mac) no campo e escolha Formatar.

![Menu de contexto de uma exibição que mostra a opção de formato destacada.](/tableau/current/pt-br/server/pt-br/Img/date_format_view.png)

Isso abrirá o painel Formatar à esquerda da exibição. Selecione o campo Datas.

![Painel de cabeçalho com o menu suspenso de formatação de data destacado.](/tableau/current/pt-br/server/pt-br/Img/date_format_pane.png)

O Tableau apresenta uma lista de formatos disponíveis. Se você estiver trabalhando com uma parte de data discreta, verá as opções relevantes para essa parte de data (como automática, dois dígitos e quatro dígitos como as opções para **YEAR(\[Order Date\])**). Para datas contínuas ou discretas de Data exata, o último item na lista é Personalizar. Você pode especificar uma data personalizada usando os símbolos de formatação listados na tabela Símbolos de formatos de data compatíveis, sozinhos ou combinados.

### Formatar um campo de data em uma exibição (Tableau Cloud e Tableau Server)

Para formatar um campo de data na exibição no Tableau Cloud e Tableau Server, clique com o botão direito do mouse (clique pressionando Control, no Mac) no campo e escolha Formatar data.  
  
![](/tableau/current/pt-br/server/pt-br/Img/CustomDate_Cloud.png)  
  

### Formatar um campo de data no painel Dados (somente Tableau Desktop)

Para formatar um campo de data no painel Dados, clique com o botão direito no campo e escolha Propriedades padrão > Formato de dados.

![Janela de formato de data padrão com várias opções de formato de data e a opção personalizada selecionada.](/tableau/current/pt-br/server/pt-br/Img/date_format_custom.png)

Os formatos de data listados na tabela são compatíveis quando a sua pasta de trabalho está conectada a uma extração do Tableau ou tem uma conexão em tempo real com a fonte de dados que também é compatível com o formato de data. (Consulte a documentação de sua fonte de dados para verificar se o formato de data desejado é compatível).

O Tableau recupera o formato de data na fonte de dados. O Tableau Server também pode recuperar formatos de data da conta de usuário Run As no servidor que executa o Tableau Server.

**Observação:** os formatos de data a seguir podem não ser os mesmos que os utilizados com a função [Conversão de tipo](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_typeconversion.htm). Consulte [Converter cadeias de caracteres em campos de data](https://help.tableau.com/current/pro/desktop/pt-br/data_dateparse.htm) para obter mais informações sobre como usar a função DATEPARSE.

## Símbolos de formatos de data compatíveis

Use os símbolos a seguir para criar um formato de data personalizado.

<table cols="2" style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 87px;" class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Símbolo</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Descrição</b></td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">(<b>:</b>)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Separador de hora. Em alguns <span class="unresolvedLink">locais</span>, um caractere diferente é usado para representar o separador de hora. O separador de hora separa horas, minutos e segundos quando os valores da hora são formatados. Na prática, o caractere que é usado como separador de hora na saída formatada é determinado pelas configurações do sistema.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">(<b>/</b>)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="unresolvedLink">Separador de data</span>. Em alguns locais, um caractere diferente é usado para representar o separador de data. O separador de data separa o dia, mês e ano quando os valores da data são formatados. Na prática, o caractere que é usado como separador de data na saída formatada é determinado pelas configurações do sistema.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">c</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe a data como <code>ddddd</code> e a hora como<br><code>ttttt</code>, nesta ordem. Exibe somente as informações de data, se não houver parte fracional no número de série da data; exibe somente as informações de tempo, se não houver parte inteira.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">d</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o dia como um número sem um zero à esquerda (1-31).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">dd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o dia como um número com um zero à esquerda (01-31).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o dia como uma abreviação (dom, sáb).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">dddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o dia como um nome completo (domingo, sábado).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ddddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe a data como uma data completa (incluindo dia, mês e ano), formatada de acordo com a configuração de formato de data curta do seu sistema. O formato de data curta padrão é <code>m/d/yy</code>.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">dddddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe um número de série de data como uma data completa (incluindo dia, mês e ano) formatada de acordo com a configuração de data longa reconhecida pelo seu sistema. O formato de data longa padrão é <code>mmmm dd, yyyy</code>.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">aaaa</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O mesmo que dddd, mas é a versão localizada da cadeia de caracteres.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">w</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o dia da semana como um número (1 para domingo e 7 para sábado).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ww</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe a semana do ano como um número (1-54).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">M</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o mês como um número sem um zero à esquerda (1 12). Se <code>m</code> vier logo após de <code>h</code> ou <code>hh</code>, o minuto é exibido, em vez do mês.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o mês como um número com um zero à esquerda (01-12). Se <code>m</code> vier logo após de <code>h</code> ou <code>hh</code>, o minuto é exibido, em vez do mês.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MMM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o mês como uma abreviação (jan-dez).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MMMM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o mês como nome do mês completo (janeiro-dezembro).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MMMMM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o mês como uma abreviatura de uma única letra (J-D)</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">oooo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O mesmo que MMMM, mas localizado.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">q</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o trimestre como um número (1-4).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">y</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o dia do ano como um número (1-366).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">yy</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o ano como um número de 2 dígitos (00-99).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">yyyy</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o ano como um número de 4 dígitos (100-9999).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">h</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe a hora como um número sem os zeros à esquerda (0-23).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Hh</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe a hora como um número com zeros à esquerda (00-23).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">N</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o minuto como um número sem zeros à esquerda (0 59).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Nn</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o minuto como um número com zeros à esquerda (00 59).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">S</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o segundo como um número sem os zeros à esquerda (0 59).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ss</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe o segundo como um número com zeros à esquerda (00 59).</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">000</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe os milissegundos. Usa um caractere de ponto final como separador, antes de especificar os milissegundos.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">t t t t t</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Exibe uma hora como hora completa (incluindo hora, minuto e segundo), formatada usando o separador de hora definido pelo formato de hora reconhecido pelo seu sistema. Um zero à esquerda será exibido se a opção de zero à esquerda for selecionada e a hora estiver antes de 10:00 ou 22:00. O formato de hora padrão é <code>h:mm:ss</code>.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AM/PM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Usa o relógio de 12 horas e exibe AM em letra maiúscula com qualquer hora antes do meio-dia; exibe um PM em letra maiúscula com qualquer hora entre meio-dia e 11:59 P.M.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">am/pm</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Usa o relógio de 12 horas e exibe AM em letra minúscula com qualquer hora antes do meio-dia; exibe um PM em letra minúscula com qualquer hora entre meio-dia e 11:59 P.M.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A/P</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Usa o relógio de 12 horas e exibe A em letra maiúscula com qualquer hora antes do meio-dia; exibe um P em letra maiúscula com qualquer hora entre meio-dia e 11:59 P.M.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">a/p</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Usa o relógio de 12 horas e exibe A em letra minúscula com qualquer hora antes do meio-dia; exibe um P em letra minúscula com qualquer hora entre meio-dia e 11:59 P.M.</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">AMPM</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Usa o relógio de 12 horas e exibe a <span class="unresolvedLink">cadeia de caracteres literal</span> AM conforme definida pelo seu sistema com qualquer hora antes do meio-dia; exibe a cadeia de caracteres literal PM conforme definida pelo seu sistema com qualquer hora entre meio-dia e 11:59 P.M. AM/PM pode ser em minúscula e maiúscula, mas letra da cadeia caracteres exibida corresponde à cadeia de caracteres definida pelas configurações do seu sistema. O formato padrão é AM/PM.</td></tr></tbody></table>

## Exemplos de formatos de data personalizados

É possível usar qualquer um dos símbolos do formato de data na tabela acima sozinho ou combinado com outro.

Especificar um formato personalizado yyyy-MM-dd HH:mm:ss.000 criaria datas no formato 2015-05-10 11:22:16.543. Esse formato pode ser adequado para dados científicos.

Especificar um formato personalizado DDDD DD criaria datas que mostram o Dia da semana e o Dia, como mostrado abaixo.

![](/tableau/current/pt-br/server/pt-br/Img/FormattingNumbersDates_CustomDateFinal.png)

Especificar um formato personalizado `yy-mm-dd (dddd)` criaria datas no formato **18-01-04 (quinta-feira)**.

Especificar um formato personalizado t `"Q"1 YYYY` criaria datas que mostram **Q1 2018**.

## Suporte para formatos de data japoneses baseados em era

O Tableau aceita os formatos de data japoneses baseados em era imperial (Wareki). Veja como aplicar um formato de data baseado em era a um campo na sua exibição:

1. Defina a localidade da pasta de trabalho como Japonês.
2. Clique com o botão direito do mouse no campo na exibição para o qual deseja definir o formato de data.
3. Escolha Formatar.
4. No painel Formatar, na lista suspensa Datas, selecione um formato.

Se o formato que você deseja não estiver listado, será possível criar seu próprio formato de data. Para fazer isso, escolha Formatação personalizada na caixa Datas, em seguida, digite seu formato usando os placeholders de data do Tableau. Os placeholders de ano baseados em era a seguir estão disponíveis:

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Símbolo</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Descrição</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">g</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nome de era curto (como H para a era Heisei).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">gg</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nome da era (como 平成).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ggg</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nome de era longo (para o japonês, isso é o mesmo que o nome de era regular).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">e</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Ano baseado em era, como 1 para o primeiro ano de uma era.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">ee</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Ano baseado em era, como 01 para o primeiro ano de uma era. Se houver somente um dígito, o ano baseado em era terá um zero adicionado na frente.</td></tr></tbody></table>

Se a localidade da pasta de trabalho não é japonês, será possível criar um formato de data personalizado e, em seguida, inserir o código de idioma !ja\_JP! na frente do seu formato, de modo que seja semelhante a:

`!ja_JP! gg ee"年"mm"月"dd"日"`

O código de idioma força a data a ser tratada como se fosse uma data japonesa.

As datas baseadas em era que não forem completamente aceitas pela exibição do navegador do Tableau Server. Particularmente, se você publicar uma pasta de trabalho que contenha filtro interativo, os placeholders e ou g atualizada, não serão preenchidos:

![ ](/tableau/current/pt-br/server/pt-br/Img/japaneseEra.png)

Para evitar este problema, não mostre datas baseadas em era nos filtros interativos se a sua pasta de trabalho for visualizada em um navegador.

## Utilização de um texto literal em um formato de data

Você pode desejar que o seu formato de data inclua algumas palavras ou frases, como **Trimestre fiscal q de yyyy**. Entretanto, se você digitar este texto diretamente na caixa de formato do Tableau, ele pode tratar as letras como partes de datas:

![ ](/tableau/current/pt-br/server/pt-br/Img/dateFormatEscape.png)

Para evitar que o Tableau faça isso, coloque entre aspas duplas as letras e palavras que não deveriam ser tratadas como parte de datas: `"Fiscal Quarter" q "of" yyyy`.

Se desejar uma citação literal dentro de uma seção citada, insira este código: `"\""`. Por exemplo, o formato `"Fiscal "\"" Quarter"` seria formatado como **Fiscal " Quarter**.

## Sintaxe de formato na função DATEPARSE para fontes de dados de extração

Se estiver usando a função DATEPARSE em uma extração, use a sintaxe definida pelo Unicode Consortium.

Esta tabela lista os formatos aceitos pela função DATEPARSE.

<table class="table-plain"><colgroup><col class="Column-Column1"><col class="Column-Column1"><col class="Column-Column1"></colgroup><tbody><tr class="Body-Body1"><th class="BodyE-Column1-Body1" style="font-weight: bold;">Parte da data</th><th class="BodyE-Column1-Body1" style="font-weight: bold;">Símbolo</th><th class="BodyE-Column1-Body1" style="font-weight: bold;">Saída de exemplo</th></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Ano</td><td class="BodyE-Column1-Body2"><p>yy</p><p>y, yyyy</p><p>Y</p></td><td class="BodyE-Column1-Body2"><p>26</p><p>2026</p><p>2026 (usado para calendários baseados na Semana do ano)</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Trimestre do ano</td><td class="BodyE-Column1-Body1"><p>Q</p><p>QQ</p><p>QQQ</p><p>QQQQ</p></td><td class="BodyE-Column1-Body1"><p>2</p><p>02</p><p>Q2</p><p>Segundo trimestre</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Mês</td><td class="BodyE-Column1-Body1"><p>M</p><p>MM</p><p>MMM</p><p>MMMM</p></td><td class="BodyE-Column1-Body1"><p>9</p><p>09</p><p>Set</p><p>Setembro</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Semana do ano</td><td class="BodyE-Column1-Body2">w, ww</td><td class="BodyE-Column1-Body2">47</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Dia da semana</td><td class="BodyE-Column1-Body2"><p>E, EE, EEE</p><p>EEEE</p><p>EEEEE</p></td><td class="BodyE-Column1-Body2"><p>Seg</p><p>Segunda-feira</p><p>M</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Dia do mês</td><td class="BodyE-Column1-Body1"><p>d</p><p>dd</p></td><td class="BodyE-Column1-Body1"><p>1, 15</p><p>01, 15</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Dia do ano (1-365)</td><td class="BodyE-Column1-Body2">D</td><td class="BodyE-Column1-Body2">23, 143</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2"><p>Hora (1-12)</p></td><td class="BodyE-Column1-Body2"><p>h</p><p>hh</p></td><td class="BodyE-Column1-Body2"><p>8</p><p>08</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Hora (0-23)</td><td class="BodyE-Column1-Body2"><p>H</p><p>HH</p></td><td class="BodyE-Column1-Body2"><p>8</p><p>08</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Minuto</td><td class="BodyE-Column1-Body1"><p>m</p><p>mm</p></td><td class="BodyE-Column1-Body1"><p>8</p><p>08</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Segundo em um minuto</td><td class="BodyE-Column1-Body2"><p>s</p><p>ss</p></td><td class="BodyE-Column1-Body2"><p>5</p><p>05</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Segundo fracionado</td><td class="BodyE-Column1-Body1"><p>S</p><p>SS</p><p>SSS</p><p>SSSS</p></td><td class="BodyE-Column1-Body1"><p>2</p><p>23</p><p>235</p><p>2350</p></td></tr><tr class="Body-Body2"><td class="BodyB-Column1-Body2">Milissegundos durante o dia</td><td class="BodyB-Column1-Body2">A</td><td class="BodyB-Column1-Body2">34532</td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Período (marcador am/pm)</td><td class="BodyE-Column1-Body1">a, aa, aaa</td><td class="BodyE-Column1-Body1">AM, am, PM</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Fuso horário</td><td class="BodyE-Column1-Body2"><p>z, zz, zzz</p><p>zzzz</p><p>Z, ZZ, ZZZ</p><p>ZZZZ</p></td><td class="BodyE-Column1-Body2"><p>PDT</p><p>Horário de Verão do Pacífico</p><p>-0800</p><p>PST-08:00</p></td></tr></tbody></table>

Para obter uma lista completa de símbolos de data, consulte [Visão geral da formatação de data e nos Componentes internacionais](https://unicode-org.github.io/icu/userguide/format_parse/datetime/) de uma página Unicode.

**Observação:** Alguns formatos de data não são compatíveis com todos os tipos de bancos de dados e arquivos.

### Observações sobre formatos de data em extrações .hyper

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;width: 80%;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Unidade de tempo</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">Observações</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-era" target="_blank">Era</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">n/a</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-year" target="_blank">Ano</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Todos os símbolos são aceitos em extrações .hyper, exceto “U”.</p><p><b>Observações:</b></p><ul><li><p>valores negativos representam um ano antes de Cristo (AC). Por exemplo, <code>DATEPARSE('y','-10'</code>) retorna o primeiro mês de janeiro de 11BC e <code>DATEPARSE('y','-0')</code> retorna o primeiro mês de janeiro de 1BC.</p></li><li><p>Ao trabalhar com o ano do calendário “y”, o padrão “yy” solicita dois dígitos de baixa ordem do ano. Para os números &lt; 70, a função DATEPARSE retorna o ano 2000+x. Para os números &gt;=70, a função DATEPARSE retorna o ano 1900+x.</p></li><li><p>Ao trabalhar com “Y” em calendários baseados em “data de semana ISO”, a transição de ano ocorre em um limite de semana e pode ser diferente da transição de ano de calendário. A designação "Y" é usada em conjunto com o caractere padrão "w" no calendário de ano-semana ISO. O sistema de data de semana&nbsp;ISO é efetivamente um sistema de calendário de semanas bissextas, parte da norma de data e hora de ISO&nbsp;8601. Igual ao “y”, os valores negativos de “Y” representam um ano antes de Cristo (AC).</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-month" target="_blank">Mês</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Todos os símbolos são aceitos em extrações .hyper, exceto “I”.</p><p><b>Observações:</b>&nbsp;</p><ul><li><p>as designações de mês são usadas juntamente com “d” para o número do dia.</p></li><li><p>Em contraste com ICU, as extrações .hyper permitem valores de 1 a 12. Outros valores causam um erro.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-week" target="_blank">Semana</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Todos os símbolos são aceitos em extrações .hyper, exceto “W”.</p><p><b>Observações:</b></p><ul><li><p>ao trabalhar com "w", em contraste com ICU, as extrações .hyper permitem somente semanas válidas. Um ano tem 52 ou 53 semanas (ISO&nbsp;8601). A função DATEPARSE valida a entrada. Por exemplo, um erro ocorre na 53ª semana de 2016, porque a 53ª semana não existe em 2016.</p></li><li><p>Ao trabalhar com “W”, ICU&nbsp;não aceita essa designação, mas é útil para datas como a primeira segunda-feira de setembro.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-day" target="_blank">Dia</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>Observações:</b></p><ul><li><p>ao trabalhar com "d", em contraste com ICU, as extrações .hyper permitem somente números de dias válidos. Por exemplo, um erro ocorre para o 31º dia de fevereiro.</p></li><li><p>ao trabalhar com "d", em contraste com ICU, as extrações .hyper permitem somente números de dias válidos. Por exemplo, um erro ocorre para o 366º dia de 2017.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-hour" target="_blank">Hora</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Apenas os símbolos "h"&nbsp;e "H" são compatíveis em exportações .hyper.</p><p><b>Observações:</b></p><ul><li><p>ao trabalhar com "h", a extração .hyper não permite valores negativos para este campo. Valores negativos causam um erro.</p></li><li><p>ao trabalhar com "h", as extrações .hyper não permitem valores negativos para este campo. Valores negativos causam um erro.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-minute" target="_blank">Minuto</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Observação:</b>&nbsp;em contraste com ICU, as extrações .hyper não permitirão valores negativos para este campo. Valores negativos causarão um erro.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-second" target="_blank">Segundo</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>Observações:</b>&nbsp;</p><ul><li><p>em contraste com ICU, as extrações .hyper não permitirão valores negativos para este campo. Valores negativos causarão um erro.</p></li><li>Ao trabalhar com "S," <code>DATEPARSE('ss.SSSS', '12.3456')</code> retorna 1990-01-01 00:00:12:3456 AD.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-quarter" target="_blank">Trimestre</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Observação:</b>&nbsp;em contraste com ICU, as extrações .hyper somente permitem valores de 1 a 4. Todos os outros valores causam um erro.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-weekday" target="_blank">Dia da semana</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>Observações:</b>&nbsp;</p><ul><li><p>ao trabalhar com “e” mais “ee”, em contraste com ICU, as extrações .hyper permitem somente valores de 1 a 7. Todos os outros valores causam um erro.</p></li><li><p>Ao trabalhar com “c..cc”, em contraste com ICU, as extrações .hyper permitem somente valores de 1 a 7. Todos os outros valores causam um erro.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-period" target="_blank">Período</a></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">n/a</td></tr></tbody></table>

<!-- document id=5d392bd9f0b4c7d2ac8b99b296e15d41827661b6325243400487245ad483b456 url=/tableau/current/pt-br/server/subscribe_alert_access.md -->

[Pular para o conteúdo principal](#main-content)

# Garantir o acesso a inscrições e alertas orientados por dados

Para garantir que os usuários visualizem os botões de Inscrever-se e Alerta na barra de ferramentas do Tableau Server e possam receber os e-mails relacionados, faça o seguinte:

- **Configurar SMTP e notificações de eventos no Tableau Server**: consulte [Configurar um site para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm).
- **Verifique se os usuários têm um endereço de e-mail no Tableau Server**: os usuários podem atualizar o endereço de e-mail na [página de configurações da conta](http://onlinehelp.tableau.com/current/pro/desktop/pt-br/useracct.htm).
- **Credenciais de banco de dados inseridas ou não são exigidas**: Para enviar os dados por e-mail em uma exibição, o Tableau Server precisa acessar os dados sem o envolvimento do usuário. Isso pode ser realizado usando uma pasta de trabalho com credenciais de banco de dados inseridas, uma fonte de dados do Tableau Server ou dados que não exijam credenciais (como um arquivo incluído na pasta de trabalho no momento da publicação).
- **Verifique se os usuários podem acessar as pastas de trabalho e exibições necessárias**: o acesso a pastas de trabalho e exibições no servidor é controlado pela permissão da Exibição. Para receber imagens de conteúdo em mensagens de e-mail, os usuários também precisam da permissão Baixar imagem/PDF. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#permissioncapabilities).
- **Evitar autenticação confiável para exibições inseridas**: se você usar tickets restritos (o padrão) para renderizar uma exibição inserida, os botões Inscrever-se e Alerta não serão exibidos.
    
    (Alertas apenas) Certifique-se de que os usuários possam acessar fontes de dados publicadas com os recursos Exibição e Conectar.

<!-- document id=de2a125d7701fc022e908755ffdfde825e5e0948f8be1330433af8595a2b6749 url=/tableau/current/pt-br/server/crashdata_server.md -->

[Pular para o conteúdo principal](#main-content)

# Gerador de relatórios de falhas do servidor

O administrador do Tableau Server pode ativar uma opção para permitir o envio de logs e arquivos relacionados ao Tableau quando o servidor tiver um problema que resulte em uma falha. Esses arquivos são usados pelo Tableau para identificar e abordar problemas que provocam falhas. Por padrão, essa opção está desativada e só deve ser ativada em organizações que não estejam sujeitas a regulamentos relacionados à privacidade de dados.

**Importante:** não habilite a geração de relatórios de falhas se os dados estiverem sujeitos a regulamentos de privacidade.

Caso o Tableau Server tenha um problema que resulte em uma falha, arquivos de registro e de despejo são gerados. Se o recurso de carregamento dos dados de falha estiver ativado, esses arquivos serão coletados automaticamente e compactados em um pacote criptografado que será enviado no horário agendado em segundo plano. O pacote criptografado é enviado em partes pequenas para limitar o impacto no desempenho de rede. Somente um relatório de falhas é compactado e carregado por vez (um novo relatório de falha não é compactado até que o pacote anterior tenha sido carregado) e enviado na ordem "primeiro a entrar, primeiro a sair". Agende o envio para uma janela de pouco uso para reduzir ainda mais o impacto para os usuários.

O pacote criptografado é composto de arquivos de despejo de falha e de registros que incluem o seguinte:

- Arquivos de despejo principais e de falhas
- Arquivos de registro de erros relacionados à falha
- Arquivo de manifesto da extensão relacionados à falha

Os arquivos podem conter dados que incluem:

- Informações específicas da máquina (por exemplo: hardware, sistema operacional, domínio).
- Um instantâneo do conteúdo da memória no momento da falha, incluindo nos detalhes da atividade do aplicativo, como informações sobre as conexões de dados, ações tomadas pelo usuário no Tableau e dados utilizados no Tableau.
- As informações no Tableau, incluindo as identificáveis pelo cliente.

## Outros artigos nesta seção

<!-- document id=93f5b27df13881e3e591c1cc1449ce2ad562666948bcf568c05e66c0c1aac9f2 url=/tableau/current/pt-br/server/server_process-resource-limits-manager.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciador de limites de recursos do Tableau Server

Essa opção foi apresentada no Tableau Server 2022.1.

O Gerenciador de Limites de Recursos do Tableau Server rastreia o uso de recursos de segundo plano em relação aos limites de recursos definidos para garantir que os limites de recursos sejam aplicados corretamente.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Resource Limits Manager</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">A situação do Resource Limits Manager é visível apenas no TSM CLI.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Registros gerados por  Resource Limits Manager  são encontrados em <code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\allegro</code>.</p><ul><li>Os registros de configuração são incluídos nos registros do Processador em segundo plano.</li><li>Os registros de consumo de recursos são incluídos nos registros do vizportal.</li></ul><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</p></td></tr></tbody></table>

O Gerenciador de Limites de Recurso é instalado automaticamente e por padrão no nó inicial do Tableau Server. Não recomendamos adicionar mais processos ou configurá-los em nós adicionais do Tableau Server.

O uso máximo de memória é definido como 512 MB.

**O que acontece quando o Gerenciador de Limites de Recursos falha?**

Os limites de recursos não serão mais aplicados, mas os trabalhos continuarão a ser executados usando os recursos disponíveis do Processador em segundo plano. O comportamento será semelhante ao cenário em que não há limites de recursos definidos.

Você pode ver o status usando o comando tsm - tsm status -v

<!-- document id=3bc940f28b693a5a677f0c131d341b4a772e023aa123db3e9a793378c7c4cf9c url=/tableau/current/pt-br/server/server_process_service-manager.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciador de serviço do Tableau Server

O Gerenciador de serviços gerencia o ciclo de vida dos processos de negócios do Tableau Server:

- Gateway
- Repositório e controlador do cluster
- Armazenamento de arquivo
- Serviço do aplicativo
- Serviço SAML
- Processador em segundo plano
- Servidor de dados
- VizQL Server
- Processador de Dados
- Servidor de cache
- Procurar e Navegar

Este processo será configurado automaticamente em cada nó do cluster durante a instalação.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Service Manager</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Service Manager não está visível na página Status. Use a CLI do TSM para exibir o status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Service Manager são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>tabsvc</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha em um processo do Gerenciador de serviços? Também ocorrerá falha em todos os serviços de negócios desse nó. Dependendo dos serviços executados no nó, o Tableau Server poderá ser executado em um estado degradado.

O Gerenciador de serviços será reiniciado automaticamente se a máquina estiver sem problemas. Se o Gerenciador de serviços não iniciar no nó, tente iniciar os serviços manualmente executando o seguinte comando:

`sc start tabsvc_0`

<!-- document id=f2455ea13d3c89b306daa769e16054a31bfb3a10c0c60c075779d34914428582 url=/tableau/current/pt-br/server/server_node_roles.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciamento de carga de trabalho por meio das funções de nó

Usando as funções de nó, é possível configurar onde certos tipos de cargas de trabalho são processados na instalação do Tableau Server. Os recursos das funções de nó permitem dedicar e dimensionar recursos para cargas de trabalho específicas. Você pode configurar funções de nó para o Processador em segundo plano e Armazenamento de Arquivo.

A função de nó do Processador em segundo plano especifica o tipo de tarefas em segundo plano que devem ser executadas em um nó, enquanto a função de nó Armazenamento de arquivo especifica o tipo de carga de trabalho de extração que deve ser executada em um nó. Ambas as funções de nó são especificadas em um nível de nó. Embora essas funções de nó possam trabalhar de forma independente para otimizar a carga de trabalho selecionada, as duas funções de nó em combinação podem ser usadas para especializar nós de servidor e executar preferencialmente cargas de trabalho selecionadas para otimizar o desempenho e extrair cargas de trabalho pesadas. Essa combinação é discutida com mais detalhes posteriormente na seção [Funções de nó de armazenamento de arquivos](#file-store-node-roles)

## Funções de nó do processador em segundo plano

O processo do Processador em segundo plano executa as tarefas do Tableau Server, incluindo atualizações de extração, assinaturas, tarefas de fluxo, tarefas “Executar agora” e tarefas iniciadas por _tabcmd_. A execução de todas essas tarefas pode usar muitos recursos da máquina. Se você tiver mais de um nó do Processador em segundo plano no cluster, é possível gerenciar a carga de trabalho do Processador em segundo plano especificando o tipo de tarefas que um Processador em segundo plano pode executar em um nó, usando o recurso da função de nó do Processador em segundo plano.

Essa opção de configuração está disponível no momento somente por meio dos comandos CLI do TSM e é útil apenas em clusters de vários nós. Se você tiver apenas um nó, o Processador em segundo plano será definido para executar todas as tarefas por padrão e isso não pode ser alterado.

### Uso das funções de nó do Processador em segundo plano

O recurso da função de nó do Processador em segundo plano destina-se a proporcionar mais controle e governança sobre o local em que certos tipos de cargas de trabalho do Processador em segundo plano são processados na instalação do Tableau Server e permite dedicar e dimensionar recursos para cargas de trabalho específicas.

Por exemplo, se a implantação tiver muitas extrações e os usuários estiverem executando muitas atualizações de extração ou trabalhos de criptografia, talvez seja interessante dedicar um nó para atualizações de extração. Da mesma forma, no caso de assinaturas, se a instalação do Tableau Server processar muitas assinaturas e você quiser garantir que outros trabalhos não consumam os recursos de assinaturas, é possível dedicar um nó para assinaturas. Nesses casos, também seria interessante dedicar outros nós do processador em segundo plano às cargas de trabalho que não se referem a atualizações de extração ou assinaturas.

Para oferecer suporte à alta disponibilidade, o Tableau recomenda ter vários nós dedicados a uma carga de trabalho específica. Por exemplo, se você dedicar um nó para atualizações de extração, deverá também configurar um segundo nó para processar a carga de trabalho da atualização de extração. Dessa forma, se um nó dedicado a atualizações de extração estiver indisponível, as atualizações de extração ainda poderão ser processadas pelo outro nó.

### Opções de configuração

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Trabalhos</b></td></tr><tr><td>todos os trabalhos (padrão)</td><td>Todos os trabalhos do Tableau Server</td></tr><tr><td>fluxos</td><td>Trabalhos de execução de fluxo.</td></tr><tr><td>nenhum fluxo</td><td>Todos os trabalhos, exceto fluxos.</td></tr><tr><td>atualizações de extração</td><td><p>Trabalhos criados para:</p><p>Atualizações incrementais, atualizações completas, criptografia e descriptografia de todas as extrações, incluindo as extrações criadas pelas saídas de fluxo.</p></td></tr><tr><td>assinaturas</td><td>Trabalhos de assinatura</td></tr><tr><td>system</td><td>Trabalhos de manutenção do sistema que interagem com outros processos do <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>. Por exemplo, limpeza de trabalhos travados, coleta de eventos de banco de dados e sincronização do Active Directory.</td></tr><tr><td>atualizações de extração e assinaturas</td><td>Atualizações de extração, criptografia e descriptografia de todas as extrações, incluindo as extrações criadas pelas saídas de fluxo e trabalhos de assinatura.</td></tr><tr><td>nenhuma atualização de extração</td><td>Todos os trabalhos, exceto as atualizações de extração, criptografia e descriptografia de extração de todas as extrações, incluindo as extrações criadas pelas saídas de fluxo.</td></tr><tr><td>nenhuma assinatura</td><td>Todos os trabalhos, exceto assinaturas.</td></tr><tr><td>nenhuma atualização de extração e assinatura</td><td>Todos os trabalhos, exceto as atualizações de extração, criptografia e descriptografia de todas as extrações, incluindo as extrações criadas pelas saídas de fluxo e assinaturas.</td></tr><tr><td>no-system</td><td>Todos os trabalhos, exceto trabalhos de manutenção do sistema.</td></tr></tbody></table>

Para obter mais informações sobre como usar os comandos tsm para definir a função de nó, consulte [tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm).

**Observação:** fazer configurações para funções de nó requer uma reinicialização do servidor e exigirá algum tempo de inatividade. Para obter mais informações, consulte [tsm pending-changes](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm).

#### Requisitos da licença

Ao configurar um nó para realizar apenas um tipo específico de tarefas, como fluxos, atualizações de extração e assinaturas, você deve ter uma das seguintes licenças ativadas no Tableau Server:

- Para configurar um nó para executar fluxos, você deve ter uma licença válida do Data Management ativada no servidor e o Tableau Prep Conductor em execução nesse nó. Para saber mais sobre o Tableau Prep Conductor, consulte [Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm).
- Para configurar um nó para executar atualizações de extração, assinaturas e qualquer combinação relacionada a atualizações de extração e assinaturas, você deve ter os recursos do Advanced Management habilitados no Tableau Server. Se a licença expirar ou for desativada, você verá um erro sempre que fizer uma alteração na configuração do Servidor. Para obter mais informações sobre o Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

> [!IMPORTANT]
> 
> Importante!  
> Embora os fluxos, atualizações de extração e assinaturas possam ser caros e consumir muitos recursos, eles não são os únicos trabalhos que podem exigir recursos dedicados. No **grupo de todos os trabalhos**, existe uma variedade de trabalhos do Sistema que o Processador em segundo plano executa, como a geração de miniatura para pastas de trabalho. Verifique se os nós que executam trabalhos que não se referem a atualizações de extração, assinaturas ou fluxos têm recursos de máquina suficientes.

Para obter mais informações sobre como configurar as funções de nó usando os comandos do TSM, consulte [tsm topology set-node-role](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetNodeRole).

#### Considerações

Há algumas regras que você deve considerar ao configurar as funções de nó do Processador em segundo plano indicadas abaixo:

- Somente uma configuração da função de nó pode ser definida para um nó de cada vez. Não é possível configurar várias funções de nó em um nó.
- Para configurar uma função de nó, deve haver pelo menos um processo do Processador em segundo plano nesse nó.
- Se você tiver apenas um nó do Processador em segundo plano, configure esse nó para executar todos os trabalhos. Essa é a configuração padrão e não requer licenciamento adicional.
- Se você tiver mais de um nó do Processador em segundo plano, ele deve ser configurado para gerenciar todos os trabalhos. Isso pode ser feito das seguintes maneiras:
    
    - Configure um dos nós para executar todos os trabalhos usando a opção Todos os trabalhos. Essa é a maneira mais fácil e direta.
    - Usando uma das configurações de exceção em um dos nós:
        
        - nenhum fluxo
        - nenhuma assinatura
        - nenhuma atualização de extração
        - nenhuma atualização de extração e assinatura

Por exemplo, em um cluster onde existem três processadores em segundo plano, você pode ter um nó configurado para executar fluxos, um para executar assinaturas e atualizações de extração e um para executar todos os trabalhos, exceto fluxos, assinatura e atualizações de extração.

**Observação:** a capacidade de especificar funções de nó para executar fluxos ou executar todos os trabalhos, exceto fluxos ou executar todos os trabalhos foi introduzida na versão 2019.1.

## Funções de nó de armazenamento de arquivos

O [Armazenamento de arquivo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_filestore.htm) controla o armazenamento das extrações. Há três categorias amplas de cargas de trabalho que dependentes da extração.

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td><b>Extrair carga de trabalho</b></td><td><b>Serviço de execução</b></td></tr><tr><td>Atualizar</td><td>Processador em segundo plano</td></tr><tr><td>Consulta</td><td>Processador de Dados</td></tr><tr><td>Back-up/Restaurar</td><td>Back-up/Restaurar</td></tr></tbody></table>

O gerenciamento de funções de nó do armazenamento de arquivos combinado ao Processador em segundo plano oferece aos administradores de servidor a capacidade de especializar nós de servidor para dar preferência à execução de cargas de trabalho selecionadas para otimizar o desempenho de todas as categorias de cargas de trabalho com uso intendo de extrações.

É possível especializar um nó para executar cargas de trabalho de consulta de extração por meio de uma topologia que tem apenas nós independentes do Processador de dados. Para obter mais informações, consulte [Otimizar para ambientes - com muitas consultas de extração](https://help.tableau.com/current/server/pt-br/perf_tuning_long_queries_for_extracts.htm). No entanto, isso está às custas da cargas de trabalho de atualização de extração, que são executadas pelos nós do Processador em segundo plano. Com a abordagem de isolamento com base na topologia, as cargas de trabalho de atualização intensas do Processador em segundo plano podem ficar mais lentas, pois nenhum nó do Processador em segundo plano possui um Armazenamento de arquivo, o que direciona todo o tráfego de atualização de extrações para a rede.

Com a opção de configuração da função de nó de armazenamento de arquivos, é possível designar certos nós de servidor que processam consultas de extração a serem selecionadas na lista de nós de servidor que podem fazer isso. Isso ajuda a acelerar as cargas de trabalho, como atualizações de backup e extração, permitindo que os administradores de servidor habilitem o Armazenamento de arquivos em nós de servidor do Processador em segundo plano, o que impede que as consultas de extração sejam executadas nesses nós. Esse recurso é útil se você tiver uma carga de trabalho de consulta e de atualização com uso intenso de extrações e quiser atingir o desempenho ideal da consulta de extração e desempenho de atualização.

### Diretrizes para otimizar a atualização de extração e backup ou restauração das cargas de trabalho.

Comece a partir de uma topologia com nós especializados do Mecanismo de dados (consulte [Otimizar para ambientes - com muitas consultas de extração](https://help.tableau.com/current/server/pt-br/perf_tuning_long_queries_for_extracts.htm)).

**Observação:** no diagrama e procedimento abaixo, o nó 1 é o Nó Inicial, o nó 2 é o Nó Adicional 1, o nó 3 é o Nó Adicional 2 e o nó 4 é o Nó Adicional 3.

![Topologia 1 - Nós de mecanismo de dados dedicados](/tableau/current/pt-br/server/pt-br/Img/perf_config_query_extract.png)Topologia 1 - Nós de mecanismo de dados dedicados

1. Adicionar armazenamento de arquivo ao nó 1.  
    `tsm topology set-process -n node1 -pr filestore -c 1`
2. Designar Nó 3 e Nó 4 para preferencialmente executar cargas de trabalho de consultas de extrações  
    `tsm topology set-node-role -n node3, node4 -r extract-queries`
3. Designar o Nó 1 para executar preferencialmente as cargas de trabalho com uso intenso de extrações.  
    `tsm topology set-node-role -n node1 -r extract-refreshes`
4. Designar o Nó 2 para executar preferencialmente as cargas de trabalho sem uso intenso de extrações.  
    `tsm topology set-node-role -n node2 -r no-extract-refreshes`
5. Aplique as alterações pendentes.  
    `tsm pending-changes apply`

![Topologia 2](/tableau/current/pt-br/server/pt-br/Img/perf_config_query_extract_2.png)Topologia 2 - Nó de armazenamento extra de arquivos

**Observação:** na implantação do Tableau Server, adicionar funções de armazenamento de arquivos aos nós existentes aumentará temporariamente o I/O de rede entre todos os nós do Armazenamento de arquivos enquanto o novo Armazenamento de arquivos estiver sendo sincronizado. A duração dessa operação depende do volume de dados no Armazenamento de arquivos e da capacidade de largura de banda da rede. O status da sincronização pode ser monitorado usando a GUI na Web do TSM. Se você estiver adicionando mais de um Armazenamento de arquivos à implantação, é recomendável adicioná-los consecutivamente e aguardar a conclusão da sincronização inicial entre cada adição do Armazenamento de arquivos.

#### Gerenciamento de carga de trabalho de consulta de extração de ajuste

Quando as consultas de extração de assinaturas de e-mail e alertas métricos estão sendo executadas ao mesmo tempo em que os usuários estão visualizando de forma interativa as exibições baseadas em extrações, os usuários podem ter tempos de carga mais lentos do que a visualização normal. Use as seguintes funções de nó para ajustar como essas cargas de trabalho são priorizadas.

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td><b>Função de nó para usar</b></td><td><b>Tipo de carga de trabalho de consulta de extração</b></td><td><b>Exemplo</b></td></tr><tr><td><code>extract-queries</code></td><td>agendada</td><td>assinaturas de e-mail e alertas métricos</td></tr><tr><td><code>extract-queries-interactive</code></td><td>interactive</td><td>usuários visualizando uma exibição baseada em extração</td></tr></tbody></table>

Se a implantação do servidor estiver vendo crescimento em assinaturas de e-mail e alertas métricos, você poderá adicionar nós e atribuir a função de nó `extract-queries` que os torna mais disponíveis para lidar com assinaturas e alertas.

Se a implantação do servidor estiver observando o crescimento de usuários visualizando exibições baseadas em extrações, você pode adicionar nós e atribuir a função de nó `extract-queries-interactive`, que os torna priorizar consultas interativas de extração para reduzir os tempos de carga de visualização baseados em extrações. A função do nó `extract-queries-interactive` é uma preferência e não um isolamento rigoroso. Isso significa que as consultas serão encaminhadas para nós que tenham a função de nó `extract-queries-interactive` atribuída. Se você tiver vários nós com a função `extract-queries-interactive`, as consultas serão encaminhadas com base na integridade do nó.

Por exemplo, adicione um nó e atribua-o para executar preferencialmente as cargas de trabalho `extract-queries-interactive`.

- `tsm topology set-node-role -n node4 -r extract-queries-interactive`

### Opções de configuração

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Trabalhos</b></td></tr><tr><td>todos os trabalhos (padrão)</td><td>Todos os trabalhos do Tableau Server</td></tr><tr><td>extract-queries</td><td>Tarefas criadas para consultas de extração. Os nós selecionados serão executados como all-jobs e priorizarão o processamento das consultas de extração.</td></tr><tr><td>extract-queries-interactive</td><td>Tarefas criadas para consultas de extração. Os nós selecionados serão executados como todos os trabalhos e priorizarão o processamento de consultas de extração interativas, como aquelas que são executadas quando um usuário está olhando para sua tela e aguardando o carregamento de um painel baseado em extração. Esta é uma configuração avançada e só deve ser usada se o cluster tiver uma carga de trabalho pesada de assinatura e alertas, que faz com que os usuários tenham um desempenho diminuído em tempos de carregamentos de visualização que são executados na mesma hora que carregamentos agendados.</td></tr></tbody></table>

Para obter mais informações sobre como configurar as funções de nó usando os comandos do TSM, consulte [tsm topology set-node-role](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetNodeRole).

#### Requisitos da licença

Para configurar um nó para executar consultas de extração, você deve ter uma licença válida do Advanced Management ativada no Tableau Server.

## Como ver as funções do nó

Use o comando a seguir para ver quais funções de nó estão configuradas atualmente no Tableau Server:  
`tsm topology list-nodes -v`

## Quem pode fazer isso

Os administradores do Tableau Server podem configurar funções de nó e ativar as chaves do produto necessárias.

<!-- document id=e657b6b3b67415c4baaece86d314d9ce2915ec44fe11e99f36758bd56696b2c9 url=/tableau/current/pt-br/server/license_lblm.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciamento de licenças baseadas em logon

O Gerenciamento de licenças baseadas em logon ajuda a gerenciar o licenciamento para usuários com funções Creator no Tableau Server e Tableau Cloud. Os usuários com funções Explorer ou Viewer não podem usar esse recurso. Se você estiver usando assinaturas baseadas em função com o Tableau Server ou o Tableau Cloud, poderá simplificar o gerenciamento de licenças usando o gerenciamento de licenças baseadas em logon para eliminar as chaves do produto separadas do Tableau Desktope do Tableau Prep Builder. Basta gerenciar uma ou mais chaves do produto do Tableau Server local ou, no caso do Tableau Cloud, não precisa gerenciar nenhuma chave do produto.

Você só precisa de um site Tableau Server ou Tableau Cloud para autorizar um indivíduo Tableau Desktop ou Tableau Prep Builder. O Gerenciamento de licenças baseadas em logon é habilitado por instância de produção da implantação do Tableau Server. Atribua funções Creator aos usuários que usam o Tableau Server, Tableau Desktop e Tableau Prep Builder para ativação de licença e gerenciamento centralizado de licenças. Além disso, o gerenciamento de licenças baseadas em logon oferece a você mais visibilidade sobre o uso da licença.

Use exibições administrativas do Tableau Server e Tableau Cloud para ver a atribuição e uso dos assentos Creator em um só local. As exibições administrativas fornecem informações sobre quem está usando as licenças Creator, e mostra o aluguel de licenças mais recente e a versão de ambos Tableau Desktop e Tableau Prep Builder, o que ajuda a monitorar suas implantações do Tableau.

O seguinte produtos do Tableau são compatíveis com gerenciamento de licenças baseadas em logon:

- Tableau Cloud
- Tableau Server
- Tableau Desktop
- Tableau Prep Builder

Se seu Tableau Server não está habilitado para gerenciamento de licenças baseadas em logon, entre em contato com o representante de vendas da Tableau para obter uma chave de produto habilitada para gerenciamento de licenças baseadas em logon.

## Como funciona o gerenciamento de licenças baseadas em logon

Quando o gerenciamento de licenças baseadas em logon está sendo usado, o Tableau Desktop ou o Tableau Prep Builder entra em contato periodicamente com o Tableau Server ou com o Tableau Cloud para verificar se o usuário é um Creator e para obter uma autorização de execução. O Tableau Server ou Tableau Cloud entra em contato com o serviço para autorizar a execução (ATR) hospedado no Tableau para verificar se o cliente do Tableau Desktop tem permissão para ativação. O serviço ATR hospedado no AWS verifica e gerencia a licença e a duração da janela de autorização. Os diagramas abaixo mostram o processo de comunicação entre o cliente, Tableau Server ou Tableau Cloud e o serviço de licenciamento.

O Tableau usa portas comuns (80 e 443) para fazer solicitações de Internet. Na maioria dos casos, o computador em que o Tableau Desktop ou o Tableau Prep Builder está instalado e a rede executada já estão configurados para permitir o acesso necessário. Para obter mais informações sobre as portas usadas pelo Tableau, consulte [Portas do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/ports.htm).

#### Gerenciamento de licenças baseadas em logon com Tableau Cloud

![Um diagrama que mostra o processo de comunicação entre os componentes de licença e licenciamento para gerenciamento de licenças baseado em logon com o Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/virtual_desktop_online_lblm.png)

#### Gerenciamento de licenças baseadas em logon com Tableau Server

![Um diagrama mostrando o processo de comunicação entre os componentes de licença e licenciamento para gerenciamento de licenças baseado em logon com o Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/virtual_desktop_server_lblm.png)

1. Você instala o Tableau Desktop ou o Tableau Prep Builder e seleciona **Ativar com as credenciais**. Você entra no site do Tableau Cloud ou do Tableau Server.
2. O Tableau Cloud ou o Tableau Server verifica se você é um Creator. Se não for o Creator, você receberá um erro. Se for o Creator, o Tableau Cloud ou o Tableau Server se comunica com o serviço ATR.
3. O serviço ATR retorna uma concessão ATR para o Tableau Cloud ou o Tableau Server.
4. O Tableau Cloud ou o Tableau Server fornece uma concessão ATR para o Tableau Desktop ou o Tableau Prep Builder para finalizar a ativação.

## Usar gerenciamento de licenças baseadas em logon

Para usar o gerenciamento de licenças baseado em logon, é necessário utilizar o Tableau Cloud ou instalar o Tableau Server e ativá-lo com uma chave do produto habilitada para gerenciamento de licenças baseadas em logon. O usuário final precisa ser atribuído à função Creator em qualquer um Tableau Cloud ou Tableau Server, e esse usuário precisará instalar Tableau Desktop. Embora o usuário possa ativar Tableau Desktop em até dois computadores, apenas uma licença Creator precisa ser alocada.

**Observação**: a partir do Tableau Server versão 2023.1, o LBLM é compatível com implantações offline. Para implantar o Tableau Server com LBLM habilitado, você deve configurar o Tableau Server para usar o serviço Authorization-To-Run (ATR). Para obter mais informações, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

### Etapa 1: instalar o Tableau Server

Se você já tiver o Tableau Server instalado, pule para a [(Opcional) Etapa 2: alterar as configurações de gerenciamento de licenças baseado em logon](#Step_2). Caso contrário, você precisará instalar o Tableau Server:

1. Consulte o capítulo [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) para instalar o Tableau Server.
2. Durante a ativação, você deve inserir uma chave do produto do Tableau Server que seja compatível com a assinatura baseada em função e ao gerenciamento de licenças baseadas em logon.
3. Adicione usuários ao Tableau Server e defina-os a uma das três funções Creator de Administrador de servidor, Creator de administrador de site ou Creator. Isso atribui uma licença Creator a esses usuários no Tableau Server. Para obter mais informações, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

> [!IMPORTANT]
> 
> **Importante:** se você usando clientes conectados e o gerenciamento de licenças baseadas em logon, não [desabilite a autenticação automática do cliente](https://help.tableau.com/current/server/pt-br/devices_connected_credentials.htm). Além disso, não saia do Tableau Server usando interface do usuário de desktop conectada após a habilitação do gerenciamento de licenças baseadas em logon. Por outro lado, gerenciamento de licenças baseadas em logon não pode atualizar automaticamente a ativação da licença ou fornecer dados atuais para o relatório de uso do LBLM no Tableau Server ou Tableau Cloud. Para obter mais informações sobre o desktop conectado, consulte [Manter o Tableau Desktop conectado ao Tableau Server ou Online](https://help.tableau.com/current/pro/desktop/pt-br/sign_in_server.htm#automatically-keep-tableau-desktop-connected-to-tableau-server-or-online).

### (Opcional) Etapa 2: alterar as configurações de gerenciamento de licenças baseado em logon

O Gerenciamento de licenças baseadas em logon está habilitado por padrão para Tableau Cloud, Tableau Server e Tableau Desktop. No entanto, você pode mudar algumas definições de gerenciamento de licenças baseadas em logon.

Desabilitar o gerenciamento de licenças baseadas em logon no Tableau Server

Embora gerenciamento de licenças baseadas em logon seja o método preferido de ativação para Tableau Desktop e Tableau Prep Builder, você pode ter instalações do Tableau Server em sua organização usadas para testes que não precisam usar o gerenciamento de licenças baseadas em logon. No Tableau Server, use o utilitário de linha de comando do Tableau Services Manager (TSM) para desativar o gerenciamento de licenças baseadas em logon.

Para desativar o gerenciamento de licenças baseadas em logon, em um prompt de comando, digite:

`tsm configuration set -k licensing.login_based_license_management.enabled -v false`

`tsm pending-changes apply`

Altere as configurações do gerenciamento de licenças baseadas em logon no Tableau Desktop ou no Tableau Prep Builder durante a instalação

Para alterar as configurações do gerenciamento de licenças baseadas em logon na linha de comando, você pode executar o arquivo .exe do instalador na linha de comando do computador como administrador. Caso precise extrair os arquivos .msi, siga as instruções para [Extrair e executar o instalador (MSI) do Windows](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm#msi).

Para usar uma duração diferente do padrão de 14 dias/1.209.600 segundos, inclua o switch `ATRREQUESTEDDURATIONSECONDS`. Por exemplo:

`tableauDesktop-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 ATRREQUESTEDDURATIONSECONDS=43200`

Você deve executar o comando do diretório em que o arquivo .exe está localizado ou especificar um caminho completo para o local do arquivo .exe no computador. Não execute o programa de instalação em um diretório compartilhado na sua rede. Em vez disso, baixe o arquivo .exe em um diretório no computador onde a instalação está em execução.

O exemplo a seguir mostra o comando do instalador do Windows que desabilita o gerenciamento de licenças baseadas em logon:

`tableauDesktop-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 LBLM=disabled`

ou

`tableauPrepBuilder-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 LBLM=disabled`

Para definir a URL padrão para o Tableau Server que você deseja que os usuários usem para ativação ao utilizar o gerenciamento de licenças baseadas em logon, adicione a opção `ACTIVATIONSERVER` ou `WorkGroupServer`.

Para atualizar o exe:

`tableauDesktop-64bit-2021-4-0.exe /quiet /norestart ACCEPTEULA=1 ACTIVATIONSERVER=http://<tableau_server_url>`

Para atualizar o registro:

`reg.exe add HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau 2024.2\Settings /f /v WorkGroupServer /d https://<tableau_server_url>`

**Observação:** a opção `ACTIVATIONSERVER` destina-se apenas à ativação pela primeira vez. Se você tiver feito login anteriormente nesta versão do Tableau, use a opção `WorkGroupServer` (Windows) ou `WorkgroupServer` (macOS). Por exemplo, se estiver usando o Tableau Desktop no Windows e já fez logon com sucesso, você não pode usar a opção `WorkGroupServer` para especificar um servidor de ativação. No Tableau Desktop para macOS, você pode usar a opção `WorkgroupServer`. No macOS, essa opção diferencia maiúsculas de minúsculas e usa um "g" minúsculo.

Altere o gerenciamento de licenças baseadas em logon no Tableau Desktop editando o registro

Se o Tableau Desktop já estiver instalado, você pode alterar as configurações do gerenciamento de licenças baseadas em logon, editando o registro do Windows.

Para desativar o gerenciamento de licenças baseadas em logon:

`reg.exe add HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ATR /f /v LBLM /d disabled`

Para tornar o gerenciamento de licenças baseadas em logon a única opção de logon:

`reg.exe add HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ATR /f /v LBLM /d required`

Ou você pode ativar, desativar ou tornar obrigatório o gerenciamento de licenças baseadas em logon, editando o registro:

1. Como administrador do computador que executa o Tableau Desktop, faça um backup do arquivo de registro antes de alterá-lo.
2. Edite o registro e, em `HKEY_LOCAL_MACHINE\SOFTWARE\Tableau`, localize a colmeia chamada ATR e modifique o valor LBLM para refletir a configuração desejada:
    
    1. Nome: LBLM.
    2. Dados: ativado, desativado ou obrigatório.
3. Reinicie o Tableau para que as alterações tenham efeito.

Altere as configurações do gerenciamento de licenças baseadas em logon no Tableau Desktop no macOS

Para alterar as configurações do gerenciamento de licenças baseadas em logon no macOS, execute os comandos a seguir em uma janela de terminal para atualizar o arquivo de preferências e instale ou reinicie o Tableau Desktop.

Para desativar o gerenciamento de licenças baseadas em logon:

`sudo defaults write /Library/Preferences/com.tableau.ATR LBLM "disabled"`

Para tornar o gerenciamento de licenças baseadas em logon a única opção de logon:

`sudo defaults write /Library/Preferences/com.tableau.ATR LBLM "required"`

Para definir a URL padrão do Tableau Server que você deseja que os usuários usem para ativação ao usar o gerenciamento de licenças baseadas em logon no macOS.

Ativação pela primeira vez:

`sudo defaults write /Library/Preferences/com.tableau.ATR LBLM "required"`

Ativações subsequents:

`sudo defaults write /Library/Preferences/com.tableau.Tableau-<version> Settings.WorkgroupServer "https://<tableau_server_url>"`

**Observação:** no Tableau Desktop para macOS, você pode usar a opção `WorkgroupServer`. No macOS, essa opção diferencia maiúsculas de minúsculas e usa um "g" minúsculo.

#### Configurações do Gerenciamento de licenças baseadas em logon

Você usa as seguintes configurações para alterar o gerenciamento de licenças baseadas em logon, definir a duração do ATR e definir a URL do servidor de ativação.

<table class="simple-table" style="width: 100%;"><colgroup><col style="width: 154px;"><col style="width: 155px;"><col style="width: 587px;"></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Valor</b></td><td><b>Descrição</b></td></tr><tr><td><code>LBLM</code></td><td>ativado, desativado ou obrigatório</td><td><p>Definidas como <code>enabled</code> (o padrão), as telas de licenciamento apresentarão as duas opções para ativação (chave do produto ou credenciais).</p><p>Definido como <code>disabled</code>, o <span class="mc-variable Variables.IBA_lowercase variable">gerenciamento de licenças baseadas em logon</span> não aparecerá nas telas de licenciamento.</p><p>Definido como <code>required</code>, o <span class="mc-variable Variables.IBA_lowercase variable">gerenciamento de licenças baseadas em logon</span> é a única maneira de ativar o <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> (quando a tela de licenciamento for exibida, ele oferecerá apenas a opção de credenciais para ativação).</p><p class="note"><b>Observação:</b> quando o <code>LBLM</code> é definido como habilitado ou obrigatório, o relatório também é habilitado.</p></td></tr><tr><td><code>ATRREQUESTEDDURATIONSECONDS</code></td><td>1209600</td><td><p>Define a autorização para executar a duração (ATR) (em segundos), que é o tempo que uma instância do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> e Tableau Prep Builder está autorizada a executar. O padrão é de 1209600 segundos (14 dias). Não use vírgulas como separadores no valor.</p></td></tr><tr><td><code>ACTIVATIONSERVER</code></td><td><p>http://&lt;tableau_server_url&gt;</p></td><td>Para a ativação pela primeira vez, define a URL padrão do <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> que você deseja que os usuários usem para ativação.</td></tr><tr><td><code>WorkGroupServer</code> (Windows)<code>WorkgroupServer</code> (Mac OS)</td><td><p>http://&lt;tableau_server_url&gt;</p></td><td><p>Para atualizações no registro do Windows ou plist do macOS, defina a URL padrão para o <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> que você deseja que os usuários usem para ativação.</p><p class="note"><b>Observação:</b> no <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> no macOS, você usaria a opção WorkgroupServer. No macOS, essa opção diferencia maiúsculas de minúsculas e usa um "g" minúsculo.</p></td></tr><tr><td><code>REPORTINGFREQUENCYSECONDS</code></td><td>3600</td><td>Define o padrão (em segundos) para a frequência com que o relatório do <span class="mc-variable Variables.IBA_lowercase variable">gerenciamento de licenças baseadas em logon</span> é enviado para o <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> ou o <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>. A configuração mínima é de 60 segundos, e o padrão é de 3600 segundos (uma hora). Altere esta configuração para reduzir a carga ou no <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> ou reduzir o tráfego da rede. Não importa qual seja a duração do contrato de locação (ATR) de autorização para execução, o <code>REPORTINGFREQUENCYSECONDS</code> define o intervalo de tempo para o qual o cliente do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span> relata as ativações do <span class="mc-variable Variables.IBA_lowercase variable">gerenciamento de licenças baseadas em logon</span> de volta para <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> ou <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>.</td></tr></tbody></table>

Configuração adicional para implantações virtuais

O Tableau Desktop e o Tableau Prep Builder entram em contato periodicamente com o Tableau Cloud ou com o Tableau Server para verificar se a execução do Tableau está autorizada, com base na licença. Em seguida, o Tableau Cloud ou o Tableau Server entra em contato com o serviço ATR para verificar a licença e a duração da janela de autorização.

Ao configurar uma implantação virtual (não persistente) do Tableau Desktop ou do Tableau Prep Builder, a duração deve ser definida como um dos valores mais baixos, como 4 ou 8 horas, para evitar uma mensagem de erro de ativação por uso excessivo. Após o retorno da máquina virtual (VM), o serviço ATR lidará com o monitoramento de ativação.

Os seguintes sinalizadores devem ser usados em uma imagem de origem, antes da publicação do Tableau Desktop para os usuários finais. Cada usuário final ativará o software fazendo logon no Tableau Server ou no Tableau Cloud com cada nova VM entregue. Uma chave do produto não precisa ser inserida se o usuário final for um Tableau Creator no Tableau Server ou no Tableau Cloud.

Se estiver usando o gerenciamento de licenças baseadas em logon para o Tableau Desktop ou para o Tableau Prep Builder em uma VM, talvez você receba uma mensagem de erro afirmando que suas informações de licença foram alteradas, sempre que iniciar uma nova VM para o Tableau Desktop ou para o Tableau Prep Builder. Esse erro força uma reinicialização, que solicita que você ative o Tableau Desktop novamente. Esse erro ocorre porque o serviço ATR envia um novo token que não corresponde ao cache de licença.

#### Microsoft Windows

Para evitar que o erro ocorra no Microsoft Windows, você pode usar as opções `SYNCHRONOUSLICENSECHECK` e `SILENTLYREGISTERUSER` com o instalador do Windows. Por exemplo:

`tableau-setup-std-tableau-2024 SYNCHRONOUSLICENSECHECK="true" SILENTLYREGISTERUSER="true" ATRREQUESTEDDURATIONSECONDS=14400`

ou

`tableauDesktop-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 ATRREQUESTEDDURATIONSECONDS=14400 ACTIVATIONSERVER=http://<tableau_server_url> SYNCHRONOUSLICENSECHECK="true" SILENTLYREGISTERUSER="true"`

Se Tableau Prep Builder e Tableau Desktop estiverem sendo entregues em um Desktop virtual, `ATRREQUESTEDDURATIONSECONDS` só precisa ser definido durante a instalação do Tableau Desktop. No entanto, se você planeja instalar o Tableau Prep Builder como autônomo, precisará definir `ATRREQUESTEDDURATIONSECONDS` durante a instalação do Tableau Prep Builder.

Ou você pode editar as seguintes chaves do registro na imagem de origem:

`Reg key path: HKLM\SOFTWARE\Tableau\<Tableau version>\Settings\`

`Reg key (String value, need to set to true to make that feature enabled)`

`SynchronousLicenseCheck`

`SilentlyRegisterUser`

#### macOS

Para evitar que o erro ocorra no macOS, execute o seguinte comando para definir o sinalizador `LicenseCache.Desktop` para `'false'` .

`sudo defaults write ~/Library/Preferences/com.tableau.Tableau-<version>.plist LicenseCache.Desktop false`

### (Opcional) Etapa 3: alterar a duração da autorização para executar (ATR)

As configurações padrão do gerenciamento de licenças baseadas em logon para a duração de autorização para execução (ATR) são apropriadas para a maioria dos ambientes, mas você pode alterá-las, se necessário. O Gerenciamento de licenças baseadas em logon usa a duração padrão da autorização para executar (ATR) de 1.209.600 segundos (14 dias), que é o período que uma instância do Tableau Desktop e do Tableau Prep Builder está autorizada a executar. Isso significa que após a autorização inicial, você poderia usar o Tableau sem qualquer conexão de rede por 14 dias, antes de expirar a ativação.

O valor de duração padrão do gerenciamento de licenças baseadas em logon não é apropriado para fornecer uma solução de entrega de VM não persistente aos usuários finais. A duração do ATR deve ser reduzida para 4 ou 12 horas, dependendo do uso da VM. Quando uma nova VM for entregue a um usuário final, uma nova autorização para executar o token será criada. Quando a VM é retornada, esse token também é retornado e pode ser usado na autorização para executar a solicitação da nova VM.

**Observação:** o gerenciamento de licenças baseadas em logon usa a hierarquia a seguir ao determinar a duração de ATR.

1. **Serviço ATR** – Estabelece as durações de ATR mínima (4 horas/14400 segundos) e máxima (90 dias/7776000 segundos) aplicáveis a todos os usuários/instalações. Especifica a duração padrão de ATR (14 dias/1209600 segundos) se nada for especificado pelo Tableau Server ou pelo Tableau Desktop.
2. **Tableau Server** - opcionalmente, é possível especificar uma duração de ATR máxima (`licensing.login_based_license_management.max_requested_duration_seconds` or `licensing.login_based_license_management.default_requested_duration_seconds`) para todas as instalações do Tableau Desktop. Usando essas configurações de duração do ATR, você pode definir globalmente a duração padrão do ATR e a duração máxima do ATR para todos os clientes do Tableau Desktop, o que elimina a necessidade de entrar individualmente em cada cliente do Tableau Desktop para definir a duração do ATR. A configuração máxima do Serviço ATR pode estar entre o mínimo de 4 horas (14.400 segundos) e o máximo de 180 dias (15.552.000 segundos).
3. **Tableau Desktop** – opcionalmente, é possível especificar a duração de ATR (`ATRREQUESTEDDURATIONSECONDS`) para o computador em que está instalado. Se necessário, você pode alterar a duração padrão do ATR (14 dias/1209600 segundos) para uma configuração dentro do serviço de ATR mínimo (4 horas/14400 segundos) e máximo (90 dias/7776000 segundos). Essa duração de ATR local substitui todas as durações definidas pelo Serviço ATR ou pelo Tableau Server. No entanto, essa duração padrão de ATR não pode ser superior à duração máxima de ATR definida no Tableau Server.

Altere a duração ATR para Tableau Desktop ou Tableau Prep Builder usando Tableau Server

No Tableau Server, você usa a linha de comando do Tableau Services Manager (TSM) para definir a duração ATR.

Para definir a duração de ATR, em um prompt de comando, digite:

`tsm configuration set -k licensing.login_based_license_management.default_requested_duration_seconds -v <value in seconds>`

`tsm pending-changes apply`

Para definir a duração máxima de ATR, em um prompt de comando, digite:

`tsm configuration set -k licensing.login_based_license_management.max_requested_duration_seconds -v <value in seconds>`

`tsm pending-changes apply`

Altere a duração ATR no Tableau Desktop editando o registro

Para usar uma duração que não seja o padrão de 14 dias/1209600 segundos, atualize a configuração de registro `ATRRequestedDurationSeconds`. Por exemplo:

1. Como administrador do computador que executa o Tableau Desktop, faça um backup do arquivo de registro antes de alterá-lo.
2. Edite o registro e, em `HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ATR`, atualize o ATRRequestedDurationSeconds da seguinte forma (0 usa a configuração padrão):
    1. Nome: localize o valor de cadeia de caracteres chamado `ATRRequestedDurationSeconds`.
    2. Dados: atualize o tempo de duração em segundos. Por exemplo, adicione 43200 para definir uma duração de 12 horas.
3. Reinicie o Tableau para que as alterações tenham efeito.

Altere a duração ATR do Tableau Desktop no macOS

Para usar uma duração que não seja o padrão de 14 dias/1209600 segundos, inclua a configuração de preferência `ATRRequestedDurationSeconds`. Por exemplo:

`sudo defaults write /Library/Preferences/com.tableau.ATR ATRRequestedDurationSeconds -string "43200"`

### Etapa 4: ativar o Tableau Desktop

1. Execute a configuração do Tableau Desktop.
2. A tela Ativar Tableau incluirá a opção Ativar ao fazer logon em um servidor.
    
    ![Janela de ativação da licença do Tableau.](/tableau/current/pt-br/server/pt-br/Img/license_lblm.png)
3. Clique em Ativar ao fazer logon em um servidor e siga um destes procedimentos:
    
    - Se estiver usando o Tableau Cloud, clique no link do Tableau Cloud.
    - Se estiver usando o Tableau Server, insira a URL do Tableau Server e clique em Conectar.
    
    Quando solicitado, insira credenciais válidas para um usuário com uma assinatura de função Creator e clique em OK.

## Exibir uso de licenças baseadas em logon

Você pode visualizar o uso de licenças baseadas em logon no Tableau Cloud ou Tableau Server. O relatório mostra usuários, hosts, função do usuário, produto, versão, ativações, licenças de Creator em uso, licenças de Creator que não estão em uso e quando uma licença de Creator foi usada pela última vez. É possível exibir os dados dos últimos 30 dias até no máximo 183 dias.

Para visualizar a exibição administrativa de Uso de licença Gerenciamento de licenças baseadas em logon:

1. No Tableau Cloud ou Tableau Server, no painel de navegação, clique em Status do site.
    
    ![Página de status do site que exibe uma lista de painéis que monitoram a atividade do site.](/tableau/current/pt-br/server/pt-br/Img/lblm.png)
2. Na página Status do site, clique em Uso de licenças baseadas em logon.
3. Opcional. Na tela do relatório, você pode alterar a janela de tempo para mostrar quando as licenças foram usadas pela última vez, filtrar ações, filtrar o nome do usuário e classificar por colunas.
    
    ![Exemplo de um relatório de uso de gerenciamento de licenças baseado em logon.](/tableau/current/pt-br/server/pt-br/Img/lblm_usage_report.png)

## Solução de problemas

Você pode encontrar uma das seguintes mensagens de erro ao usar o gerenciamento de licenças baseadas em logon. Use as informações abaixo para resolver o problema.

### O Gerenciamento de licenças baseadas em logon não está habilitado no Tableau Server

Se o gerenciamento de licenças baseadas em logon estiver disponível como opção de ativação no Tableau Desktop, mas não estiver habilitado no Tableau Server ou se o Tableau Server não tiver uma licença apta do gerenciamento de licenças baseadas em logon, a seguinte mensagem de erro poderá ser exibida:

_O Gerenciamento de licenças baseadas em logon não está habilitado no servidor ao qual você se conectou. Selecione um servidor diferente para se conectar, use uma chave do produto para ativar a licença ou inicie uma avaliação para começar a trabalhar imediatamente._

Entre em contato com o administrador e certifique-se de que você esteja usando uma chave do produto do Tableau Server habilitada para gerenciamento de licenças baseada em login. Para verificar se você ativou a chave do produto apropriada, na interface de usuário da Web do TSM, clique em Configuração e, em seguida, clique em Licenciamento. Para obter orientação sobre como ativar licenças, consulte [tsm licenses activate](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMActivate). O Gerenciamento de licenças baseadas em logon deve ser ativado por padrão, a menos que tenha sido anteriormente desativado pelo administrador do servidor.

### O Gerenciamento de licenças baseadas em logon não está habilitado no Tableau Desktop

Se o gerenciamento de licenças baseadas em logon não estiver habilitado no Tableau Desktop, você não terá a opção de ativar o Tableau usando suas credenciais.

Se a opção do gerenciamento de licenças baseadas em logon tiver sido desativada durante a instalação ou com uma atualização, consulte [Etapa 2: Habilitar gerenciamento de licenças baseadas em logon](#Step_2).

### A data de expiração da chave do produto não muda após a compra de uma assinatura anual

Após adquirir uma renovação do Tableau Server, e o novo prazo de assinatura ser refletido no Tableau Server, pode levar até 24 horas para que a nova data de expiração apareça em Gerenciar chaves do produto no Tableau Desktop.

### Você não tem uma licença do Creator

Ao tentar ativar por meio do Tableau Desktop, a seguinte mensagem de erro pode ser exibida:

_Você não tem uma licença do Creator. Entre em contato com o administrador para obter uma._

Esse erro é exibido se você não foi designado a uma função do Creator. Se você pertence a vários sites do Tableau Cloud ou do Tableau Server, é necessário entrar no site onde tem a função Creator ao usar o gerenciamento de licenças baseadas em logon. Caso contrário, você receberá esse erro.

Para verificar se a chave do produto que você ativou no servidor inclui licenças de Creator, abra a interface de usuário da Web do TSM e clique em Configuração e, em seguida, clique em Licenciamento.

### Você ativou o número máximo de computadores

Ao tentar ativar por meio do Tableau Desktop, a seguinte mensagem de erro pode ser exibida:

_Você ativou o número máximo de vezes permitidas na sua conta do Tableau. Você deve aguardar a ativação da licença em outro computador pessoal expirar, antes de ativar o Tableau novamente._

Esse erro é exibido quando você ativou o Tableau em vários computadores com as mesmas credenciais de usuário do Creator e excedeu o número máximo de ativações. Aguarde até que o token para autorizar a execução (ATR) expire em um dos computadores atuais, antes de tentar ativar um novo computador. Se você estiver usando máquinas virtuais não persistentes (VMs), será possível diminuir a duração de ATR para evitar que esse erro ocorra novamente.

#### Encurtar a duração do token ATR para a ativação máxima

Se você encontrar esse erro de uso máximo ao usar uma implantação virtual não persistente, é possível encurtar a duração do ATR para 4 horas (14400) segundos para evitar o erro no futuro. Como alternativa, em vez de alterar a duração em uma área de trabalho individual, você pode definir a duração padrão no Tableau Serverpara afetar todos os usuários.

As etapas a seguir encurtam o aluguel em um computador previamente ativado com gerenciamento de licenças baseadas em logon que não será mais usado, a fim de liberar uma licença para ser ativada em um novo computador:

1. Abra um Prompt de comando como administrador em um computador com Tableau Desktop que não será mais usado.
2. Navegue até o diretório de binários do Tableau (\\bin), usando o seguinte comando.
    
    Windows: `cd Program Files\Tableau\Tableau <version>\bin`
    
    Mac: `cd /Applications/Tableau\ Desktop\ <version>.app/Contents/MacOS`
3. Execute o seguinte comando para definir a duração como 4 horas, em segundos (por exemplo, 14.400).
    
    Windows: `atrdiag.exe -setDuration 14400`
    
    Mac: `sudo ./atrdiag -setDuration 14400`
4. Exclua o token ATR anterior usando o seguinte comando:
    
    Windows: `atrdiag.exe -deleteAllATRs`
    
    Mac: `./atrdiag -deleteAllATRs`
5. Em seguida, substitua o token ATR existente. Abra o Tableau Desktop. O Tableau exibe a mensagem “Licença alterada”. Clique em Sair para fechar e reabrir automaticamenteTableau Desktop .
6. Na caixa de diálogo de registro, clique em Ativar e reative o Tableau Desktop através de Tableau Server usando o gerenciamento de licenças baseadas em logon, que substituirá o token existente.
7. Feche o Tableau Desktop e aguarde a duração de ATR passar (por exemplo, 4 horas) para que o token de ATR expire e libere uma licença de usuário. Não abra o Tableau Desktop antes que a duração do ATR tenha decorrido. Certifique-se de que a duração do ATR tenha decorrido. O token ATR TTL End deve mostrar uma data e hora no futuro (por exemplo, 4 horas a partir de agora).
    
    Windows: `atrdiag.exe`
    
    Mac: `./atrdiag`
8. Depois que o token ATR expirar e você conseguir fazer logon no Tableau Server em um novo computador.

#### Para retornar o computador pessoal a um estado não licenciado

1. Abra um prompt de comando como administrador.
2. Navegue até o diretório Binários do Tableau (\\bin), usando o seguinte comando:
    
    `cd Program Files\Tableau\Tableau <version>\bin`
3. Execute o seguinte comando:
    
    Windows: `atrdiag.exe –deleteAllATRs`
    
    Mac: `./atrdiag.exe –deleteAllATRs`

**Observação:** esta ação remove somente o token de ATR do computador pessoal. Isso não libera as licenças de usuário. A licença de usuário só é liberada depois que o token de ATR excluído expira.

### Suas credenciais do Tableau são inválidas

Ao tentar ativar por meio do Tableau Desktop, a seguinte mensagem de erro pode ser exibida:

_Suas credenciais do Tableau são inválidas. Entre em contato com o administrador para redefinir sua conta._

Este erro é exibido quando a licença Tableau não é reconhecida. Entre em contato com seu administrador.

### O relógio do computador não está sincronizado com a hora atual

Ao tentar ativar por meio do Tableau Desktop, a seguinte mensagem de erro pode ser exibida:

_O relógio do computador não está sincronizado com a hora atual. Sincronize o relógio do computador para a hora atual e tente ativar Tableau._

Esse erro é exibido quando o relógio do computador não está sincronizado com a hora atual. Sincronize o relógio do computador com um servidor de horário na Internet ou ative a sincronização automática de hora.

### Não é possível ativar com suas credenciais

Ao tentar ativar o Tableau, a seguinte mensagem de erro pode ser exibida:

_O Tableau Server não pode verificar suas informações de licenciamento pela Internet. Entre em contato com o administrador para verificar a conexão com a Internet._

Este erro é exibido quando a porta `atr.licensing.tableau.com:443` não está aberta em todos os nós do Servidor de aplicativos (VizPortal) ou você tem um proxy que não está configurado corretamente para encaminhar o tráfego para o servidor de licenciamento do Tableau.

Para diagnosticar a conectividade com o servidor de licenciamento do Tableau, cole a seguinte URL (`https://atr.licensing.tableau.com/_status/healthz`) em um navegador ou em um prompt de comando curl.

<!-- document id=ecd3407534195563e899c05badfa8fb8189f40c5196bd1b4811e8e8e8cf7b2bc url=/tableau/current/pt-br/server/users_manage_ad.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciamento de usuários em implantações com armazenamentos de identidades externos

Este tópico descreve detalhes técnicos importantes com os quais você deve estar familiarizado caso use o armazenamento de identidades externo para gerenciar usuários no Tableau Server. O Tableau Server é compatível com a conexão a um diretório externo usando LDAP. Nesse cenário, o Tableau Server importa os usuários do diretório LDAP externo para o repositório do Tableau Server como usuários do sistema.

## Diretórios LDAP arbitrários

O nome de usuário do sistema no Tableau é o atributo que você define como parte da configuração LDAP, por exemplo "cn". Isso ocorre para o recurso de importação individual do usuário e para a sincronização de grupo. Consulte a [Referência de configuração do armazenamento de identidades externo](https://help.tableau.com/current/server/pt-br/ldap_config.htm).

### Comportamento de associação do usuário ao fazer login

Pode ser necessário atualizar sua configuração LDAP para permitir a vinculação com nomes de usuário anexados ao DN. Especificamente, você precisará atualizar sua configuração LDAP quando o Tableau Server for configurado com um diretório LDAP arbitrário. (por exemplo, OpenLDAP) que usa endereços de UPN ou de e-mail como nomes de usuário.

O Tableau Server pesquisará um determinado usuário com base no nome de usuário fornecido durante a entrada. O Tableau Server tentará então se vincular ao nome de usuário anexado ao DN. Se o Tableau Server for configurado com GSSAPI, o nome de usuário @ REALM (nome de domínio) será usado.

## Active Directory

Este conteúdo, no restante deste tópico, presume que você tenha familiaridade com o gerenciamento de usuários do Active Directory e com os conceitos básicos de esquema e domínio do Active Directory.

Se você estiver instalando no Active Directory, instale o Tableau Server em um computador que esteja vinculado ao domínio do Active Directory.

**Observação:** no contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas.

### Autenticação de usuário do Active Directory e Tableau Server

O Tableau Server armazena todos os nomes de usuário no armazenamento de identidades do Tableau Server, que é gerenciado pelo repositório. Quando o Tableau Server é configurado para usar o Active Directory para autenticação, você primeiro deve importar as identidades dos usuários do Active Directory para o repositório. Quando os usuários fazem logon no Tableau Server, as credenciais são passadas para o Active Directory, que é responsável pela autenticação do usuário; o Tableau Server não faz a atutenticação. (Por padrão, o NTLM é usado para a autenticação, mas você pode habilitar o Kerberos ou o SAML para a funcionalidade de logon único, no entanto, em todos esses casos, a autenticação é de responsabilidade do Active Directory). No entanto, os nomes de usuário do Tableau armazenados no repositório são associados a direitos e permissões do Tableau Server. Portanto, depois que a autenticação for verificada, o Tableau Server gerenciará o acesso do usuário (autorização) aos recursos do Tableau.

**Observação:** as Entidades de Segurança estrangeira (FSP) só são aceitas no Tableau Server no Windows.

### Atributos de nome de usuário do Active Directory e do Tableau Server

O Active Directory identifica exclusivamente objetos de usuário usando diversos atributos. (Para obter detalhes, consulte [Atributos de nome de usuário](https://msdn.microsoft.com/pt-br/library/ms677605\(v=vs.85\).aspx) no site do MSDN). O Tableau Server confia em dois atributos de nome de usuário do Active Directory:

- `sAMAccountName`. Este atributo especifica o nome de logon que foi originalmente projetado para uso com versões mais antigas do Windows. Em muitas organizações, esse nome é combinado com o nome NetBIOS para autenticação, usando um formato como `example\jsmith`, em que `example` é o nome NetBIOS e `jsmith` é o valor `sAMAccountName`. Devido ao design original no Windows, o valor `sAMAccountName` deve ser menor que 20 caracteres.
    
    No console administrativo **Usuários e computadores do Active Directory** do Windows, esse valor fica no campo rotulado **Nome de logon do usuário (pré-Windows 2000)** na guia **Conta** do objeto do usuário.
- `userPrincipalName` (UPN). Esse atributo especifica um nome de usuário no formato `jsmith@example.com`, em que `jsmith` é o prefixo UPN e `@example.com` é o sufixo UPN.
    
    No console administrativo **Usuários e computadores do Active Directory** do Windows, UPN é a concatenação de dois campo na guia **Conta** do objeto de usuário: o campo **Nome de logon do usuário** e a lista suspensa de domínio ao lado.

### Adição de usuários do Active Directory

Você pode [adicionar usuários individualmente](https://help.tableau.com/current/server/pt-br/users_add.htm) do Active Directory, digitando-os no ambiente de servidor ou criando um arquivo CSV e importando os usuários. Você também pode adicionar usuários do Active Directory [criando um grupo pelo Active Directory](https://help.tableau.com/current/server/pt-br/groups_create_ad.htm) e importando todos os usuários do grupo. O resultado pode ser diferente dependendo da abordagem utilizada.

**Importação do prefixo UPN como nome de usuário**

Você não pode importar o UPN inteiro como um nome de usuário.

Na maioria dos casos, o nome de usuário que o Tableau Server importará para o armazenamento de identidade será o valor sAMAccountName. Para obter mais informações sobre exceções a esse comportamento, consulte [Importando o prefixo UPN como nome de usuário em cenários não padrão com o Active Directory](https://kb.tableau.com/articles/HowTo/importing-upn-prefix-as-username-in-non-standard-scenarios-with-active-directory?lang=pt-br) na ajuda da Base de conhecimento do Tableau.

#### Adição de grupos de usuários

Se você importar um grupo de usuário do Active Directory, o Tableau importará todos os usuários do grupo usando `sAMAccountName`.

### Comportamento de sincronização ao remover usuários do Active Directory

Os usuários não podem ser automaticamente removidos do Tableau Server por meio de uma operação de sincronização do Active Directory. Os usuários que forem desabilitados, excluídos ou removidos dos grupos no Active Directory permanecem no Tableau Server, para que seja possível fazer uma auditoria e reatribuir o conteúdo do usuário antes de remover completamente a conta.

No entanto, o Tableau Server atuará sobre objetos de usuário diferentes com base em como o status do objeto do usuário é alterado no Active Directory. Há dois cenários: excluir/desabilitar usuários no Active Directory ou remover usuários de grupos sincronizados no Active Directory.

Quando um usuário é excluído ou desabilitado no Active Directory e, em seguida, o grupo dele é sincronizado no Tableau Server, o seguinte ocorre:

- O usuário é removido do grupo do Tableau Server que foi sincronizado.
- A função do usuário é definida como "não licenciado”.
- O usuário ainda pertencerá ao grupo Todos os usuários.
- O usuário não consegue entrar no Tableau Server.

Quando um usuário é removido de um grupo no Active Directory e, em seguida, o grupo é sicronizado no Tableau Server, o seguinte ocorre:

- O usuário é removido do grupo do Tableau Server que foi sincronizado.
- A função do usuário é retida: ela não é definida como “não licenciada”.
- O usuário ainda pertencerá ao grupo Todos os usuários.
- O usuário ainda terá permissão para o Tableau Server com acesso a tudo que o grupo Todos os usuários tem permissão de usar.

Em ambos os casos, para remover completamente o usuário do Tableau Server, o administrador de servidor terá que excluir o usuário da página Usuários do servidor no Tableau Server.

### Apelidos de domínio

No Tableau Server, o apelido de domínio é equivalente ao nome de domínio NetBIOS do Windows. Em uma floresta do Active Directory do Windows, um nome de domínio totalmente qualificado (FQDN) pode ter qualquer nome arbitrário NetBIOS. O nome NetBIOS é usado como o identificador de domínio quando um usuário faz logon no Active Directory.

Por exemplo, o FQDN `west.na.corp.lan` pode ser configurado com um nome NetBIOS (apelido) de `SEATTLE`. O usuário `jsmith` no domínio pode fazer logon no Windows usando qualquer um dos seguintes nomes de domínio:

- `west.na.corp.example.com\jsmith`
- `SEATTLE\jsmith`

Se desejar que seus usuários se conectem ao Tableau Server com o nome NetBIOS em vez do FQDN, você precisará verificar se o valor do apelido de cada domínio no qual o logon dos usuários está definido. Consulte [editdomain](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#editdoma) para obter informações sobre como visualizar e definir o valor do apelido para cada domínio.

### Suporte a vários domínios

Você pode adicionar usuários e grupos de um domínio que é diferente do domínio do computador do Tableau Server nesses casos:

- A confiança bidimensional foi estabelecida entre os domínios do servidor e dos usuários.
- O domínio do servidor confia no domínio dos usuários (confiança unidirecional). Consulte [Requisitos de confiança de domínio para implantações do Active Directory](https://help.tableau.com/current/server/pt-br/runas_domain.htm).

Na primeira vez que você adicionar um usuário ou grupo do domínio não-servidor, deverá especificar o nome de domínio totalmente qualificado com o nome do usuário/grupo. Quaisquer usuários ou grupos adicionais que você adicione por esse domínio poderão ser adicionados usando o apelido do domínio, desde que o apelido corresponda ao nome NetBIOS. Se o Tableau Server for conectado a vários domínios, você também deve especificar outros domínios aos quais o Tableau Server se conecta definindo a opção `wgserver.domain.whitelist` (versão 2020.3 e anterior) ou `wgserver.domain.accept_list` (versão 2020.4 e posterior) com TSM. Para obter mais informações, consulte [wgserver.domain.whitelist](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain) ou [wgserver.domain.accept\_list](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain-acceptlist).

#### Nomes de exibição duplicados

O gerenciamento de usuários com o mesmo nome de exibição no Tableau pode ser confuso, se os nomes de exibição do usuário não forem exclusivos em vários domínios. O Tableau Server exibirá o mesmo nome para dois usuários. Por exemplo, considere uma organização com dois domínios, example.lan e example2.lan. Se o usuário John Smith existir em ambos os domínios, adicioná-lo a grupos e outras tarefas administrativas será confuso no Tableau Server. Nesse cenário, considere atualizar o nome de exibição no Active Directory para um dos usuários, a fim de diferenciar as contas.

### Faça logon no Tableau Server com o nome NetBIOS

Os usuários podem fazer logon no Tableau Server usando o apelido de domínio (nome NetBIOS), por exemplo, `SEATTLE\jsmith`.

O Tableau Server não pode consultar o nome NetBIOS de um determinado FQDN. Como resultado, o Tableau define o apelido de um determinado FQDN de acordo com a primeira entrada no namespace. Por exemplo, com o FQDN `west.na.corp.lan`, o Tableau define o apelido como `west`.

Portato, você poderá precisar atualizar o apelido do domínio no Tableau Server antes que os usuários possam fazer logon com o apelido. Se você não atualizar o apelido, os usuários precisarão fazer logon usando um nome de domínio totalmente qualificado. Para obter mais informações, consulte [Usuários de novo domínio não conseguem fazer logon e não aparecem na lista de usuários](https://help.salesforce.com/s/articleView?id=001473117&type=1) na base de dados de conhecimento do Tableau.

<!-- document id=84d8e6fede9ad7d4e751c64c1046017ba00530a24777dc9db89f80d23c4c6e9b url=/tableau/current/pt-br/server/identity_migration_manage.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar a migração de identidade

Como administrador, você pode monitorar e gerenciar a migração de identidade, incluindo alterar quando os trabalhos de migração são executados, por meio da página dedicada de migração de identidade disponível na página Usuários do Tableau Server. Essa página está disponível durante o processo de migração.

![Página de visão geral da migração de identidade.](/tableau/current/pt-br/server/pt-br/Img/id_mig_main.png)

Os trabalhos de migração são projetados para serem executados em segundo plano sem interromper ou interferir no uso do Tableau Server. No entanto, se necessário, você pode fazer ajustes que afetam a frequência com que os trabalhos de migração são executados, quando os trabalhos de migração são executados e por quanto tempo os trabalhos de migração podem ser executados.

Geralmente, a migração pode levar de 3 minutos a 10 dias, dependendo do tamanho da implantação do Tableau Server e de quaisquer alterações nas configurações padrão feitas durante a migração. Por exemplo, se você tiver 10.000 usuários, a migração poderá levar cerca de 30 minutos.

**Observação:** enquanto os trabalhos de migração estão em execução, todos os recursos de autenticação e relacionados ao usuário funcionam normalmente.

## Gerenciar trabalhos de migração de identidade

Você pode gerenciar os seguintes aspectos da migração de identidade.

Resolver conflitos de identidade

Para revisar os conflitos de identidade que você pode encontrar durante a migração, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) .

Alterar a programação diária do trabalho de migração

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade.

1. Ao lado do título Visão geral da migração, clique no botão Editar agendamento.
2. Na caixa de diálogo Editar agendamento, altere quando e com que frequência os trabalhos podem ser executados.
    
    **Observação:** você pode ignorar as opções de Prioridade e Execução nesta caixa de diálogo.
    
    ![Caixa de diálogo Editar agendamento com opções para editar a frequência de migrações.](/tableau/current/pt-br/server/pt-br/Img/id_mig_schedule.png)
3. Quando concluir, clique em Atualizar.

Iniciar um trabalho de migração

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade.

1. Em qualquer guia, selecione um usuário ou vários usuários.
2. No menu Ações, selecione Repetir a migração ou Reconhecer, dependendo do que você precisa fazer.
    
    ![Menu suspenso de ações Migração de identidade com opções para Repetir a migração ou Reconhecer.](/tableau/current/pt-br/server/pt-br/Img/id_mig_actions.png)
3. Ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento.
4. Selecione Executar agora .
    
    ![Menu suspenso para editar o agendamento de migração com a opção para executar agora destacada.](/tableau/current/pt-br/server/pt-br/Img/id_mig_runnow.png)

Pausar a migração de identidade

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade.

1. Ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento.
2. Selecione Desativar.

Reinicie a migração de identidade

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade.

1. Ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento.
2. Selecione Ativar.

## Alterar as configurações de migração de identidade

Para reduzir qualquer tensão potencial que a migração de identidade possa causar em seu Tableau Server, a migração é configurada para ser executada com as configurações padrão listadas abaixo.

### Configurações de migração

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">Tipo</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">comando tsm</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">Padrão</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Procedimento</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Agenda de trabalhos</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">N/A</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">03:00, diariamente até concluir</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Configurável na página Migração de identidade, consulte <a href="#schedule" class="xref">Alterar a programação diária do trabalho de migração</a> acima.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Solicitações de identidade do usuário por segundo (taxa)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tsm authentication identity-migration configure -–rate</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Até 5</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="2"><p>Se necessário, você pode usar o comando <code>tsm authentication identity-migration</code> para alterar as configurações de migração listadas acima usando as etapas abaixo.</p><ol><li value="1">Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.</li><li value="2"><p>Execute um ou ambos os comandos descritos em <a href="https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#tsm_identity_mig_config"><code>tsm authentication identity-migration</code></a> .</p><p>Por exemplo, para alterar o tempo de execução e a taxa do trabalho individual de seus valores padrão, você pode executar o seguinte comando:</p><p><code>tsm authentication identity-migration configure --job-run-time 180 --rate 3</code></p></li></ol></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tempo de execução de fluxo individual</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tsm authentication identity-migration configure -–job-run-time</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">120 minutos</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a name="enable"></a>Habilitar a migração de identidade</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>tsm configuration set -k features.IdentityMigrationBackgroundJob</code></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>false</code></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Ao habilitar a migração de identidade, o Tableau Server pode usar o serviço de identidade para armazenar e gerenciar informações de identidade do usuário.</p><ol><li value="1"><p>Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.</p></li><li value="2"><p>Executo o seguinte comando:</p><p><code>tsm configuration set -k features.IdentityMigrationBackgroundJob -v true</code></p></li></ol><p><b>Observação:</b> a migração de identidade e o Serviço de Identidade são um pré-requisito para certas capacidades como <a href="https://help.tableau.com/current/server/pt-br/identity_pools.htm" target="_blank">pools de identidades</a>. Para obter mais informações sobre o comando tsm, consulte <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#identity_migration" class="xref">features.IdentityMigrationBackgroundJob</a>.</p></td></tr></tbody></table>

### Desabilitar a migração de identidade

Se você atualizou para as versões 2021.4.21, 2022.1.17, 2022.3.9 e 2023.1.5 do Tableau Server, talvez seja necessário desabilitar a migração de identidade. Ao desabilitar a migração de identidade, o Tableau Server não poderá usar o serviço de identidade para armazenar e gerenciar informações de identidade do usuário.

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute o seguinte comando:
    
    `tsm configuration set -k features.IdentityMigrationBackgroundJob -v false`

**Observação:** a migração de identidade e o Serviço de Identidade são um pré-requisito para certas capacidades como [pools de identidades](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Conclua a migração de identidade e configure o Serviço de Identidade

Depois que todos os conflitos de usuário forem resolvidos ou endereçados e os trabalhos de migração forem executados, você deverá configurar o Tableau Server para usar o Serviço de identidade para concluir o processo de migração de identidade.

### Etapa 1: validar e concluir a migração de identidade

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade para verificar se a migração foi iniciada.
    
    Você pode monitorar e gerenciar seu progresso usando a página dedicada de migração de identidade disponível na página Usuários do Tableau Server. Para obter mais informações, consulte [Gerenciar a migração de identidade](#) .
3. Resolva ou reconheça todos os conflitos de identidade conforme descrito em [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) para que a guia Todas as falhas exiba "0" como na imagem abaixo.
    
    ![Resumo da migração de identidade mostrando zero falhas.](/tableau/current/pt-br/server/pt-br/Img/id_mig_failures_acknowledge.png)
4. Execute _um_ destes procedimentos:
    
    - Para executar o trabalho de migração de identidade agora, ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento e selecione Executar agora.
        
        ![Menu suspenso para editar o agendamento de migração com opções para desativar ou executar agora.](/tableau/current/pt-br/server/pt-br/Img/id_mig_overview_runnow.png)
    - Como alternativa, você pode aguardar a execução do trabalho de migração durante o próximo horário agendado.
5. Após a conclusão da migração, na página Migração de identidade, valide se a Visão geral da migração mostra 100% concluída.
    
    ![Barra de progresso da migração de identidade indicando 100% de conclusão.](/tableau/current/pt-br/server/pt-br/Img/id_mig_complete.png)

### Etapa 2: configurar o Tableau Server para usar o serviço de identidade

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute os seguintes comandos dependendo da versão do Tableau Server que você está executando:
    
    - Para as versões 2022.1.8 (e posteriores), 2022.3.10 (e posteriores), 2023.1.6 (e posteriores) e posteriores do Tableau Server:
        
        ```
        tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
        ```
    - Para as versões 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server:
        
        ```
        tsm authentication legacy-identity-mode disable
        ```
    
    **Observação:** depois de executar um dos comandos acima, a página dedicada de Migração de identidade é removida e não está mais acessível. A página só é acessível quando `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled` is `true` ou `tsm authentication legacy-identity-mode` está ativado.

Depois que o Tableau Server é configurado para usar o Serviço de Identidade, quando os usuários entram no Tableau Server, o Tableau Server pesquisa suas identidades de usuário usando seus identificadores no repositório de identidades configurado. A partir dos identificadores, os identificadores exclusivos universais (UUID) são retornados e usados para corresponder às identidades de usuário existentes do Tableau Server. Esse processo gera sessões para os usuários e conclui o fluxo de trabalho de autenticação.

### Etapa 3: habilitar pools de identidade

1. Execute os seguintes comandos:
    
    ```
    tsm configuration set -k features.IdentityPools -v true
    tsm pending-changes apply
    ```

**Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado.

<!-- document id=630b1a831cbae0a725d50f2e7fff261627bf89a61b188401999fc75ce6658de7 url=/tableau/current/pt-br/server/permissions_section.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar acesso ao conteúdo

Gerencie quem pode acessar o conteúdo no site e definir as permissões que regem a propriedade de conteúdo.

## Outros artigos nesta seção

<!-- document id=95117dd277051d007bbfa420c56d946736040fc8c04e0af9f853d719b3beb0e7 url=/tableau/current/pt-br/server/manage_stored_credentials.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar credenciais salvas para as conexões de dados

As credenciais salvas permitem a conexão com uma fonte de dados sem a solicitação das credenciais. As credenciais salvas para a conexão podem ser tokens de acesso OAuth ou de outro tipo, como nome de usuário e senha. Você pode gerenciar as credenciais salvas na página de configurações da sua conta.

No Tableau Server, se o administrador do servidor permite salvar as credenciais, é possível localizá-las e gerenciá-las na seção Credenciais salvas na página Minhas configurações de conta. Se não for possível visualizar a seção Credenciais salvas, consulte o administrador sobre a permissão para salvar credenciais. Para obter mais informações, consulte [Permitir tokens de acesso salvos](https://help.tableau.com/current/server/pt-br/allow_saved_tokens.htm).

**Observação**: ao editar fluxos do Tableau Prep na Web, você ainda pode ser solicitado a autenticar novamente.

## Testar conexões usando credenciais salvas

Se o conector suporta funcionalidade de teste, é possível testar a conexão pelo uso das credenciais salvas.

1. Enquanto estiver conectado ao Tableau Server ou Tableau Cloud, exiba sua página de Configurações de conta.
2. Na seção Credenciais salvas, selecione o link Testar ao lado da conexão armazenada que deseja testar.

Esse teste confirma se o Tableau Cloud ou o Tableau Server podem acessar a sua conta pelo uso da credencial salva correspondente. Se o teste for bem-sucedido, mas não for possível acessar os dados por meio da conexão gerenciada, confirme se as credenciais informadas para essa conexão podem acessar os dados.

Por exemplo, se a conexão foi criada, acidentalmente, usando a conta pessoal do Gmail, mas outra conta é usada para acessar o banco de dados do Google Analytics, será necessário excluir as credenciais salvas e fazer logon nos dados usando a conta do Gmail adequada.

## Atualizar credenciais salvas

Para ajudar a garantir o acesso ininterrupto aos dados do conteúdo existente do Tableau após a configuração de um cliente OAuth personalizado para o seu site, recomendamos que você atualize as credenciais salvas. Para atualizar as credenciais salvas, você pode excluir as credenciais salvas anteriormente para um determinado conector e adicioná-las novamente.

Quando você adiciona credenciais salvas novamente, tanto o conteúdo novo quanto o existente do Tableau acessarão os dados usando o cliente OAuth personalizado configurado pelo administrador do servidor . Para obter mais informações sobre clientes OAuth personalizados, consulte [Configurar um Oauth personalizado para um site](https://help.tableau.com/current/server/pt-br/protected_auth.htm#custom_oauth_server).

1. Entre no Tableau Server e acesse a página Minhas configurações de conta.
2. Em Credenciais salvas para fontes de dados, faça o seguinte:
    
    1. Clique em Excluir ao lado das credenciais salvas para um conector.
    2. Ao lado do mesmo conector, clique em Adicionar e siga as instruções para 1) conectar-se ao cliente OAuth personalizado sobre o qual o administrador do site o notificou e 2) salvar as credenciais mais recentes.

## Desmarcar todas as credenciais salvas

Quando você seleciona Limpar todas as credenciais salvas, os seguintes itens são removidos de sua conta de usuário:

- Todas as credenciais salvas para conexões que são armazenadas na sua conta.
    
    **Cuidado:** se alguma dessas credenciais salvas estiver armazenada em pastas de trabalho ou fontes de dados publicadas, sua exclusão também removerá o acesso à fonte de dados desses locais. Efetivamente, isso é como “mudar as fechaduras” em qualquer lugar onde as credenciais salvas afetadas sejam usadas.
- As senhas usadas para acessar extrações de dados ou pastas de trabalho publicadas que se conectam a elas.

## Remover credenciais salvas

Para remover o acesso do Tableau aos dados, exclua da sua conta as credenciais salvas associadas a estes dados. Após excluir as credenciais, será necessário fazer logon para acessar os dados da próxima vez. Isso cria novas credenciais salvas.

Seu administrador pode escolher que todos os usuários usem as mesmas credenciais compartilhadas para conexão com a fonte de dados. Nesse caso, a credencial salva é associada à conexão de dados para todos usuários e não aparece em Credenciais salvas na página Configurações de conta.

**Observação:** se você for um usuário do Tableau Server e não puder excluir credenciais salvas, pergunte ao administrador se ele desmarcou a opção Permitir que usuários salvem tokens de acesso da fonte de dados nas configurações do servidor.

<!-- document id=bd3ef47f4ac3bf4340a746967c5792ea9cc1c8637ab9b7d5b0379c229ff44a4c url=/tableau/current/pt-br/server/manage_data_section.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar dados

Você pode se conectar e gerenciar os dados usados no Tableau.

## Outros artigos nesta seção

<!-- document id=d32f84831dae2a9b591463e3c0ca9323aff8f9cd7077d8544e64f0cc7f424601 url=/tableau/current/pt-br/server/dashboard_extensions_server.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar extensões de painel e visualização no Tableau Server

As extensões do Tableau são aplicativos Web que podem ajudar a estender as análises fornecidas em uma pasta de trabalho do Tableau. As extensões integram-se perfeitamente para interagir com o resto da pasta de trabalho do Tableau, usando a [API de extensões do Tableau](https://tableau.github.io/extensions-api).

As extensões de painel são executadas em áreas do painel personalizadas e podem interagir com o restante do painel. As extensões de painel dão aos usuários a capacidade de interagir com outros aplicativos diretamente do Tableau. As extensões de visualização são executadas em planilhas e oferecem aos usuários a capacidade de usar tipos de visualização personalizados. Os usuários do Tableau acessam extensões de painel como objetos de painel e acessam extensões de visualização por meio do cartão Marcas da planilha.

**Observação:** os administradores de servidor têm a capacidade de habilitar as extensões de painel e visualização no servidor ou bloquear extensões específicas de serem executadas. Os administradores podem adicionar extensões à lista de permissões e controlar o tipo de dados que as extensões podem acessar. Além disso, o administrador de servidor pode configurar se os usuários no site verão prompts ao adicionar ou exibir extensões. Os administradores de servidor também têm a capacidade de bloquear extensões específicas de serem usadas em todos os sites. Para obter informações sobre a segurança de extensão e as opções de implantação recomendadas, consulte [Segurança de extensão - Práticas recomendadas para implantação](https://help.tableau.com/current/server/pt-br/security_extensions.htm).

Para obter informações sobre o uso de extensões de painel no Tableau, consulte [Usar extensões de painel](https://help.tableau.com/current/pro/desktop/pt-br/dashboard_extensions.htm).  

Para obter informações sobre como usar extensões de visualização, consulte [Adicionar extensões de visualização à sua planilha](https://help.tableau.com/v0.0/pro/desktop/pt-br/viz_extensions.htm).

Procurando pelo Tableau Cloud? Consulte [Gerenciar extensões de painel no Tableau Cloud.](https://help.tableau.com/current/online/pt-br/dashboard_extensions_server.htm "Abre o tópico em uma nova guia do navegador")

## Antes de executar as extensões no Tableau Server

As extensões são uma plataforma aberta, mas, em geral, há dois padrões a serem considerados:

- Extensões confiáveis do Tableau, que são extensões que foram especificamente analisadas e implantadas em hosts gerenciados pelo Tableau. Essas extensões incluem soluções criadas e gerenciadas pelo Tableau; soluções criadas por parceiros do Tableau Exchange que são implantadas com o serviço de revisão e host do Tableau; e soluções hospedadas no ambiente protegido de nossas extensões de área restrita herdadas.
- Extensões habilitadas para rede, que são extensões hospedadas em qualquer host de terceiros. As extensões habilitadas para rede podem ser úteis quando os desenvolvedores optam por gerenciar a entrega de suas extensões sem o envolvimento do Tableau. Isso inclui extensões que os parceiros gerenciam diretamente para fornecer melhor suporte à produção; extensões hospedadas e implantadas em sua própria rede local ou extensões que exigem comunicação com serviços de terceiros fora do Tableau. As extensões habilitadas para rede têm acesso completo à Web.

**Observação:** o Tableau oferece suporte à integração com o Salesforce Einstein Discovery por meio da extensão de painel do Einstein Discovery. Essa é uma extensão especial que tem acesso a dados em Salesforce.com e é permitida por padrão. Não é considerada uma extensão habilitada para rede ou uma extensão em área restrita. Para obter mais informações sobre a integração do Einstein Discovery, consulte [Notas de versão do Tableau Server](https://help.tableau.com/current/server/pt-br/whatsnew_server.htm#2021-1-einstein-predictions).

### Extensões confiáveis do Tableau

A partir de 2025.3, as extensões confiáveis do Tableau representam o subconjunto de extensões do Tableau Exchange que foram elevadas para uso. As extensões confiáveis são hospedadas em hosts do Tableau e são necessárias para limitar a comunicação entre clientes de usuário e o Tableau. Essas extensões foram testadas para comunicações de rede e verificadas quanto a vulnerabilidades antes da implantação. Esse padrão de extensão é usado para fornecer um acesso mais controlado às extensões. Esse padrão inclui:

- As extensões de área restrita são hospedadas pelo Tableau e empregam padrões W3C, como a política de segurança de conteúdo (CSP), para garantir que a extensão não possa fazer chamadas de rede fora do host de área restrita do Tableau. Uma extensão de área restrita pode consultar dados, mas o ambiente de área restrita bloqueia explicitamente a comunicação desses dados para outros locais. As extensões de área restrita são compatíveis com o Tableau 2019.4 e posteriores. Por padrão, as extensões de área restrita podem ser executadas se as extensões estiverem ativadas para o site.
- As extensões criadas pelo Tableau são soluções desenvolvidas e mantidas ativamente pela equipe de desenvolvimento do Tableau. As extensões criadas pelo Tableau são explicitamente projetadas para direcionar as comunicações para o cliente do usuário, em vez de consultar os dados do usuário. Por padrão, isso limita o risco de exfiltração e retenção de dados. As extensões criadas pelo Tableau também passam pelos padrões Salesforce Software Development Life Cycle (SDLC). Por padrão, as extensões criadas pelo Tableau poderão ser executadas se as extensões estiverem ativadas para o site.
- As extensões confiáveis criadas por parceiros do Tableau são soluções desenvolvidas e mantidas ativamente por parceiros credenciados do Tableau e do Salesforce que contribuem para o Tableau Exchange. Os desenvolvedores do Tableau validam essas soluções de terceiros por meio de testes manuais antes de serem implantadas como extensões confiáveis do Tableau. Os desenvolvedores do Tableau realizam testes funcionais e de comunicação de rede e verificações automatizadas de código das extensões antes de serem implantadas em um host do Tableau dedicado. As extensões confiáveis criadas por parceiros do Tableau podem ser habilitadas para uso pelo administrador do Tableau.

### Extensões habilitadas para rede

As extensões habilitadas para rede são aplicativos Web e podem ser executadas em qualquer computador configurado como servidor Web. Isso inclui computadores locais, computadores em seu domínio e serviços Web de terceiros. Como as extensões habilitadas para rede podem ser hospedadas em servidores de terceiros e ter acesso aos dados na pasta de trabalho, é necessário permitir as extensões confiáveis. Consulte [Testar a segurança das extensões habilitadas para rede](#Test).

### Configurações de extensões padrão

Os administradores podem usar as configurações das extensões no Tableau Server para controlar e limitar aquelas que podem ser executadas.

- Por padrão, as extensões podem ser executadas a menos que estejam explicitamente desabilitadas. Isso é gerenciado pelo administrador de servidor em todos os sites ou pode ser desabilitado para qualquer site específico pelo administrador de site.
- Recomendamos permitir o uso de extensões confiáveis do Tableau. Por padrão, a extensão de área restrita e as extensões criadas pelo Tableau serão habilitadas para serem executadas se as extensões estiverem habilitadas para o site; extensões confiáveis criadas por parceiros do Tableau podem ser habilitadas pelo administrador.
- Por padrão, as extensões habilitadas para rede não serão permitidas, a menos que tenham sido explicitamente adicionadas à lista de permissões. Somente as extensões que usam o protocolo HTTPS são permitidas, o que garante um canal criptografado para envio e recebimento de dados (a única exceção é para `http://localhost`). Algumas extensões exigem permissões completas de dados (acesso aos dados subjacentes). Essas extensões não podem ser executadas no Tableau Server, a menos que você adicione a extensão explicitamente à lista de permissões e conceda o acesso da extensão aos dados completos.

## Controlar o uso de extensões

Os administradores de servidor podem controlar uma configuração global para permitir extensões em todos os sites do servidor. Os administradores do servidor também podem adicionar extensões, incluindo extensões de área restrita, à lista de bloqueio global para impedir que sejam executadas (consulte [Bloquear extensões específicas](#Block)). Por padrão, todas as extensões de área restrita são ativadas no servidor, mas os administradores de site podem optar por substituir o padrão e proibir extensões de área restrita para o site.

### Alterar a configuração global que habilita as extensões no servidor

1. Para alterar essa configuração do servidor, vá até Gerenciar todos os sites > Configurações > Extensões. Se o servidor tiver apenas um site único, os controles globais aparecerão na página de configurações do site.
2. Em Extensões de visualização e painel, marque ou desmarque a caixa de seleção Permitir que extensões sejam executadas neste servidor. Se essa opção não estiver selecionada, as extensões não terão permissão para serem executadas. Essa configuração global substitui as configurações de Permitir que extensões sejam executadas neste site para cada site.

### Alterar as configurações padrão de um site

Os administradores do servidor podem controlar se as extensões são ativadas para o site e se as extensões confiáveis do Tableau são permitidas no site. Ou seja, caso as extensões estejam habilitadas no servidor, as configurações padrão do site permitem o uso de extensões de área restrita e criadas pelo Tableau no site, desde que as extensões não estejam especificamente bloqueadas no servidor. As configurações padrão do site permitem que extensões habilitadas para rede sejam executadas quando registradas na lista de permissões do site. Qualquer extensão pode ser explicitamente adicionada à lista de permissões, que então habilita essa extensão para uso no site.

1. Para alterar essas configurações de site, vá até Configurações > Extensões.
2. Em Extensões de painel e visualização, configure estas opções:
    
    - Permitir que extensões sejam executadas neste site
    - Permitir que extensões confiáveis sejam executadas neste site

Os administradores de servidor podem adicionar ou remover extensões da lista segura de um site. Ao adicionar uma extensão à lista de permissões, você pode configurar permissões que permitem que a extensão tenha acesso (se necessário) a todos os dados. Consulte [Adicionar extensões à lista de permissões e configurar a extensão](#Add)

## Usar a lista de permissões

Use a lista de permissões para permitir que extensões específicas sejam executadas em um site. A lista de permissões é usada principalmente para extensões habilitadas para rede. Ao contrário das extensões confiáveis do Tableau, que são fornecidas por hosts conhecidos do Tableau e têm permissão para execução por padrão, as extensões habilitadas para rede não são permitidas, a menos que tenham sido explicitamente adicionadas à lista de permissões. A lista de permissões também permite controlar se os usuários são solicitados a conceder permissão para permitir a execução da extensão e se a extensão tem acesso aos dados completos (dados subjacentes) na pasta de trabalho.

Por padrão, as extensões confiáveis do Tableau têm permissão para serem executadas, o que inclui extensões de área restrita e criadas pelo Tableau. Não é necessário adicioná-las à lista de permissões, a menos que as configurações padrão tenham sido alteradas e elas não sejam mais permitidas. O mesmo vale para extensões confiáveis criadas por parceiros do Tableau. Se elas forem permitidas, você não precisará adicioná-las explicitamente à lista de permissões.

### Identificar a URL de uma extensão

Como um aplicativo da Web, uma extensão está associada a uma URL. Você pode usar essa URL para testar e verificar a extensão. Além disso, use a URL para adicionar a extensão à lista segura e permitir acesso aos dados completos ou à lista de bloqueio para negar acesso.  
Para permitir extensões habilitadas para rede ou outras extensões, você precisa localizar a URL da extensão e, em seguida, adicionar a URL à lista de permissões. Ao adicionar a URL à lista de permissões, você está aprovando a comunicação com o aplicativo Web. Há várias maneiras de determinar a URL da extensão.  

#### No Tableau Exchange  

Ao usar uma extensão baixada do Tableau Exchange, você pode encontrar a URL da extensão na página de listagem do Exchange. Abra o bloco da extensão, em Especificações técnicas, procure a URL sob o título, Hospedado em.

![Um bloco do Tableau Exchange para uma extensão mostrando onde encontrar a URL hospedada](/tableau/current/pt-br/server/pt-br/Img/gallery_ext_url_350x187.png)  

#### No arquivo de manifesto  

Se você tiver um arquivo de manifesto da extensão (`.trex`), um arquivo XML que define as propriedades da extensão, você poderá encontrar a URL do elemento `<source-location>`. Você poderá recuperar o arquivo de manifesto se baixar a extensão do Tableau Exchange usando o navegador da Web. Abra o arquivo de manifesto em um editor de texto.

```

<source-location>
    <url>https://www.example.com/myExtension.html</url>
</source-location>

				
```

#### Identificar uma extensão de painel usando a caixa de diálogo Sobre

Para extensões de painel, você pode encontrar a URL nas propriedades de extensão encontradas no menu de contexto de extensão de painel. No menu Mais opções, clique em Sobre.

![Um menu de contexto com opções incluindo Sobre, Recarregar, Opções de depuração, Flutuante, Corrigir largura, Editar largura, Selecionar contêiner de layout, Desmarcar e Remover do painel.](/tableau/current/pt-br/server/pt-br/Img/about_extension_menu_224x217.png)

A caixa de diálogo Sobre lista o nome da extensão, o autor, o site do autor e a URL da extensão.

![Uma caixa de diálogo com detalhes sobre a extensão de amostra da fonte de dados, como URL, número de versão e ID da instância.](/tableau/current/pt-br/server/pt-br/Img/about_extension_url_281x209.png)

### Adicionar extensões à lista de permissões e configurar a extensão

Para permitir que os usuários acessem extensões habilitadas para rede, adicione a extensão à lista de permissões do site. Por padrão, ao adicionar uma extensão à lista de permissões, a extensão só tem acesso aos dados resumidos (ou agregados). Além disso, é possível controlar se os usuários veem um prompt pedindo que permitam o acesso da extensão aos dados. Você pode querer adicionar uma extensão à lista segura (uma extensão de sandbox, por exemplo) apenas para que possa configurar se os usuários verão o prompts. Quando você ocultar o prompt de usuários, a extensão poderá ser executada imediatamente.

1. Vá até Configurações > Extensões.
2. Em Habilitar extensões específicas, adicione a URL da extensão. Consulte [Identificar a URL de uma extensão](#Identify).
    
    **Dica:** você pode usar um ponto final e um asterisco (`.*`) como um curinga na URL para permitir todas as extensões em um determinado domínio ou local. Por exemplo, para permitir todas as extensões no domínio exemplo.com que usam a porta 8080, você adicionaria a URL: `https://example.com:8080/.*`. Para mais informações, veja [Usar expressões regulares na URL da lista segura](#RegEx).
3. Escolha Permitir ou Negar à extensão Acesso aos dados completos.
    
    O acesso aos dados completos é o acesso aos dados subjacentes na exibição, não apenas aos dados de resumo ou agregados. O acesso aos dados completos também inclui informações sobre as fontes de dados, como os nomes das conexões, campos e tabelas. Normalmente, se você estiver adicionando uma extensão que deseja usar à lista segura, você também deseja permitir que a extensão tenha acesso a todos os dados, se a extensão exigir isso. Antes de adicionar extensões à lista segura, certifique-se de [Testar a segurança das extensões habilitadas para rede](#Test).
4. Escolha Mostrar ou Ocultar os Prompts do usuário.
    
    Os usuários veem os prompts por padrão quando estão adicionando uma extensão de painel a um painel, ou uma extensão de visualização a uma planilha, ou quando estão interagindo com uma visualização que tem uma extensão. O prompt apresenta detalhes da extensão aos usuários e indica se ela tem acesso aos dados completos. O prompt dá aos usuários a capacidade de permitir ou negar que a extensão seja executada. Você pode ocultar esse prompt de usuários, permitindo que a extensão seja executada imediatamente.

### Verifique se a extensão tem permissões para acessar a pasta de trabalho ou exibição

Um painel ou uma extensão de visualização requer acesso aos dados visíveis na exibição. Os dados visíveis são os dados agregados de resumo apresentados em uma planilha ou um painel. Verifique se a pasta de trabalho ou exibição tem permissão para Baixar dados de resumo. A extensão não baixa os dados. A extensão requer apenas permissão para que possa interagir com os dados na exibição.

## Bloquear extensões específicas

A política global padrão permite o uso de extensões no Tableau. Por padrão, as extensões de área restrita e criadas pelo Tableau podem ser executadas. Os sites têm permissão para habilitar extensões confiáveis criadas por parceiros e quaisquer extensões habilitadas para rede que constem na lista de permissões. Os administradores de servidor podem impedir que extensões específicas sejam executadas ao adicioná-las à lista de bloqueio do servidor. Se uma extensão estiver na lista de bloqueio global, ela substituirá qualquer configuração da extensão na lista segura de um site.

1. Para adicionar uma extensão à lista de bloqueio do servidor, vá até Gerenciar todos os sites > Configurações > Extensões. Em instalações de site único, a lista de bloqueio está na página de configuração Extensões do site.
2. Em Bloquear extensões específicas, adicione a URL da extensão. Consulte [Identificar a URL de uma extensão](#Identify).

### Usar expressões regulares na URL da lista segura

Em geral, ao adicionar uma extensão à lista segura, você deve usar a URL específica da extensão. No entanto, há momentos em que você pode querer permitir várias extensões hospedadas no mesmo domínio e local. Neste caso, é conveniente utilizar um curinga na URL. As configurações de extensão suportam o uso de expressões regulares.

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 162px;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 540px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Expressão regular</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Descrição</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>.</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um ponto final (.)&nbsp;é um curinga que você pode usar para corresponder a qualquer caractere. Se precisar especificar um ponto final (.) na URL em vez de um curinga, você pode escapar do caractere com uma barra invertida (<code>\.</code>).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>*</code></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Um asterisco (*)&nbsp;é um quantificador que especifica uma ou mais instâncias do caractere anterior.</td></tr></tbody></table>

Tenha cuidado ao usar curingas para não tornar a lista de permissões muito permissiva e permitir inadvertidamente o acesso a extensões que não deveriam ter acesso.

A tabela a seguir mostra alguns exemplos de uso de expressões regulares na URL. Observe que esses exemplos não mostram o protocolo e a URL completa da extensão. Somente extensões que usam o protocolo HTTPS são permitidas (com exceção de http://localhost).

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 242px;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 304px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Para especificar...</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Exemplo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Especifica</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Intervalo de domínios</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">.*\.example.com</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Todos os subdomínios em example.com.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Todas as portas</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">example.com:.*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">As extensões têm acesso permitido de todas as portas em example.com.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Todas as extensões em domínio, porta e caminho</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">example.com:8080/xyz/.*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Todas as extensões no domínio example.com que usam a porta 8080 e estão localizadas em zyz têm acesso permitido.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Todas as portas para vários domínios</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">.*\.example.com:.*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Permite acesso a extensões em todas as portas em todos os subdomínios em example.com.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Todas as extensões em um domínio e caminho que correspondam ao padrão</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">example.com/t.c/.*</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Permite acesso a extensões em execução em example.com em pastas que correspondem ao padrão t.c. Por exemplo, tic, tac, toc.</td></tr></tbody></table>

## Testar a segurança das extensões habilitadas para rede

As extensões são aplicativos Web que interagem com dados no Tableau usando a API de extensões. Se você optar por permitir extensões habilitadas para rede que não são diretamente revisadas e gerenciadas pelo Tableau, os usuários deverão estar cientes de que essas extensões podem fazer chamadas de rede e ter acesso a recursos na Internet. O Tableau recomenda testar e entender as extensões habilitadas para rede antes que elas sejam lançadas para ampla adoção.  

### Examinar os arquivos de origem

As extensões incluem vários arquivos HTML, CSS e JavaScript, além de um arquivo de manifesto XML (\*.trex) que define as propriedades na extensão. Ao analisar uma extensão habilitada para rede, recomendamos entrar em contato diretamente com o desenvolvedor da extensão para obter acesso e permissão para revisar. O Tableau não distribui nem fornece acesso a arquivos de origem de outro desenvolvedor.

Se o código de uma extensão estiver disponível publicamente no GitHub, poderá ser examinado ou baixado lá. No arquivo de manifesto (`*.trex`), você pode encontrar o local de origem ou a URL, indicando onde a extensão está hospedada, o nome do autor, além do site ou empresa do autor para entrar em contato e obter suporte. O elemento `<source-location>` especifica a URL, o elemento `<author>` especifica o nome da empresa e o site a ser contatado para suporte (`website="SUPPORT_URL"`). O site é o link Obter suporte que o usuário vê na caixa de diálogo Sobre para a extensão do painel.

As extensões fazem referência a bibliotecas JavaScript externas, como a biblioteca jQuery ou as bibliotecas de API para terceiros. Valide que a URL das bibliotecas externas aponta para um local confiável da biblioteca. Por exemplo, se a extensão fizer referência à biblioteca jQuery, certifique-se de que ela esteja em um site que é considerado padrão e seguro.

Todas as extensões devem usar o protocolo HTTPS (`https://`) para hospedar suas extensões. Examine os arquivos de origem da extensão para garantir que as referências a bibliotecas externas que também estejam usando o HTTPS ou estejam hospedadas no mesmo site da extensão. A única exceção à solicitação do HTTPS é se a extensão estiver hospedada no mesmo computador com o Tableau (`http://localhost`).

Na medida do possível, tente entender o que o código está fazendo. Em particular, tente entender como o código está criando solicitações para os sites externos e quais informações são enviadas na solicitação. Verifique se algum dado fornecido pelo usuário está validado a impedir o script entre sites.

### Entenda o acesso aos dados

As extensões do Tableau trabalham principalmente com os dados agregados de resumo apresentados em uma planilha ou um painel. No entanto, a API de extensões do Tableau fornece métodos que podem acessar os dados subjacentes quando a extensão declara que precisa de acesso total aos dados. Esses métodos podem acessar os nomes de tabelas ativas e campos na fonte de dados, as descrições de resumo das conexões da fonte de dados e os dados subjacentes em uma planilha. Se uma extensão utiliza algum desses métodos em uma exibição, o desenvolvedor da extensão deve declarar que a extensão requer permissão a dados completos no arquivo de manifesto (`.trex`). A declaração se parece com o seguinte.

```

<permissions>
   <permission>full data</permission>
</permissions>
```

O Tableau usa essa declaração para fornecer um prompt aos usuário no momento da execução, que oferece a opção de permitir o acesso. Se a extensão usar algum desses métodos sem declarar uma permissão de dados completos no arquivo de manifesto, ela será carregada, mas as chamadas do método falharão.

Para obter informações sobre como uma extensão acessa os dados a partir do painel e dos métodos JavaScript usados, consulte [Acesso aos dados subjacentes](https://tableau.github.io/extensions-api/docs/security/trex_data_access) na API de extensões do Tableau. Para entender melhor o que a extensão pode obter sobre os dados, é possível usar a extensão de painel de amostra [DataSources](https://github.com/tableau/extensions-api/tree/master/Samples/Dashboard/DataSources) (disponível no [Repositório GitHub da API de extensões do Tableau](https://github.com/tableau/extensions-api)) para ver quais dados são expostos quando o método `getDataSourcesAsync()` é chamado.

### Testar a extensão em um ambiente isolado

Se possível, o Tableau recomenda testar a extensão em um ambiente que esteja isolado do seu ambiente de produção e de computadores de usuário. Por exemplo, adicione uma extensão de painel ou visualização a uma lista segura em um computador de teste ou máquina virtual que esteja executando uma versão do Tableau Server que não é usada para a produção.

### Monitorar o tráfego criado pela extensão de painel

Para avaliar as possíveis chamadas de rede utilizadas por uma extensão habilitada para rede, utilize ferramentas de depuração da Web, como [Fiddler](http://www.telerik.com/fiddler), [Charles HTTP proxy](http://www.charlesproxy.com/) ou [Wireshark](https://www.wireshark.org/) para examinar as solicitações e respostas feitas pela extensão. Certifique-se de que entendeu qual conteúdo a extensão está exigindo. Examine o tráfego para garantir que a extensão não esteja lendo os dados ou o código que não são diretamente relacionados à finalidade da extensão.

<!-- document id=2b851eb27f38948e6a5bdce32b139648984f50d7c358e62c491359af8720aeed url=/tableau/current/pt-br/server/license_manage.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar licenças

Você pode gerenciar suas licenças Tableau Server e visualizar o uso da licença.

## Outros artigos nesta seção

<!-- document id=19f1f8f5327ac6a0077552bd71c002be6cfb112cf2f8fc93f88707fdf826dcb5 url=/tableau/current/pt-br/server/site_role_limit.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar os limites das funções de site

Os administradores do servidor podem criar limites de função no site para definir um número máximo de licenças de cada tipo (Creator, Explorer ou Viewer) que podem ser consumidas em determinado site. Depois que um administrador do servidor estabelece um limite de função no site, os administradores de site podem adicionar usuários (que consomem licenças automaticamente) até esse limite de função no site. Se um usuário for membro de vários sites no servidor, ele será contado no limite de função de cada site, mas consumirá apenas uma licença (que corresponde à função no site mais alta que ele desempenha no servidor). Os administradores do servidor não são descontados dos limites de função no site.

Para saber mais sobre os recursos de cada função no site, consulte Licenças baseadas no usuário na ajuda do Tableau Server [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm#userbased-licenses). Para obter informações para os administradores do servidor sobre como configurar os limites de função no site, consulte [Referência de configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm).

## Criar limites de função em um site

Antes de permitir que os administradores de site gerenciem os usuários, você pode Exibir licenças do servidor para determinar como alocar licenças em todo o Servidor ou Adicionar capacidade para novos usuários ao Servidor.

Os administradores do servidor podem configurar os limites de função no site por meio da página Configurações na interface do usuário da Web ou da [API REST.](https://help.tableau.com/v2020.1/api/rest_api/en-us/REST/rest_api_whats_new.htm#whats-new-rest-api-37-for-tableau-server-20201-and-tableau-online)

Para definir um limite de função no site:

1. Acesse a guia Geral da página Configurações do site.
    - Se você tiver um único site, na navegação lateral, clique em Configurações e Geral.
    - Se você tiver vários sites, selecione o site que deseja configurar e clique em Configurações e Geral.
2. Em Gerenciamento de usuários, especifique que os administradores do servidor e site podem adicionar e remover usuários.
3. Em Limitar o número de usuários a: selecione Limite de função no site
4. Defina um limite para Creators, Explorers e Viewers.
5. Clique em Salvar

Os administradores do servidor podem definir limites de função no site de acordo com as seguintes restrições:

- Um limite de função no site não pode exceder o número de licenças desse tipo que foram ativadas no servidor
- Um limite de função no site não pode ser menor do que o número de usuários dessa função no site já presente para esse site
- Se um limite for definido para qualquer tipo de licença, um limite deverá ser definido para todos os tipos de licença.
- Se o limite para uma função for deixado em branco, o limite de licença do servidor será usado.

## Quando os limites de função no site foram atingidos

Se um usuário for adicionado a um site como Explorer, ele consumirá uma licença de Explorer, a menos que o site tenha atingido seu limite de função definido para Explorer. Nesse caso, podem ocorrer algumas coisas diferentes:

- Se houver licenças disponíveis em um nível mais alto, o usuário será adicionado ao site como um Explorer, mas consumirá uma licença de Creator.
- Se não houver licenças mais altas, o usuário será adicionado ao site como usuário Não licenciado.

Os limites de função de site podem ser afetados por usuários que consomem licenças diferentes das funções de site atribuídas a eles (Viewers (Visualizadores) que consomem licenças Explorer (Explorador), por exemplo). Nesse caso, os administradores podem cancelar a licença desses usuários e, em seguida, atualizar as cotas de função de site. Para obter mais informações sobre como solucionar problemas de licenciamento, consulte [Solucionar problemas de licenciamento](https://help.tableau.com/current/server/pt-br/unlicensed.htm).

<!-- document id=38de499c49265de6afea931cf987ab390a99189651b2cfc0412ef43c73bff6e4 url=/tableau/current/pt-br/server/permissions_projects.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar permissões com projetos

Os projetos podem simplificar o gerenciamento de permissões com recursos como projetos aninhados, visibilidade do projeto, líderes de projeto não administrativos e permissões de bloqueio.

> [!TIP]
> 
> **Dica**: como as permissões são definidas no nível de projeto é importante, especialmente para o projeto Padrão. Quando um novo projeto de nível superior é criado, ele herda suas regras de permissão padrão (para todos os tipos de conteúdo) do projeto Padrão. Quando um novo projeto é criado aninhado dentro de outro projeto, o projeto secundário herda suas regras de permissão padrão do projeto primário.

## Administração de projetos

Os projetos são contêineres usados para organizar e gerenciar o acesso ao conteúdo. Ao conceder privilégios não administrativos para gerenciar projetos, determinadas tarefas de administração de conteúdo podem ser tratadas no nível de projeto.

**Líderes de projeto**: os projetos podem ter líderes de projeto, usuários definidos como um Líder de projeto. Essa configuração concede automaticamente ao usuário seus recursos máximos (dependendo da função de site) para esse projeto. Os líderes de projeto com função no site do Explorer (pode publicar) e acima todos os recursos. Os líderes do projeto são essencialmente administradores locais do projeto sem acesso às configurações do site ou do servidor.

**Hierarquia**: somente os administradores podem criar projetos de nível superior. Os proprietários de projeto e líderes de projeto podem criar projetos aninhados dentro de seus projetos.

Os proprietários e líderes de projeto têm total acesso administrativo ao projeto e seu conteúdo, bem como a qualquer projeto aninhado contido nele. Em uma hierarquia, os líderes de projeto recebem implicitamente o acesso de líder a todo o conteúdo secundário. Para remover o acesso de líder de projeto, você deve fazê-lo no nível da hierarquia em que a função foi atribuída explicitamente.

**Propriedade**: um projeto pode ter vários líderes de projeto, mas cada projeto tem exatamente um proprietário. Por padrão, um projeto é de propriedade do usuário que o criou. 

O proprietário de um projeto pode ser alterado pelo proprietário existente ou por um administrador. (Os líderes do projeto não podem alterar a propriedade do projeto, apenas a propriedade do conteúdo). Os projetos podem pertencer a usuários com uma função de site de Explorador (pode publicar), Creator ou administrador. A propriedade do projeto pode ser alterada mesmo se um projeto estiver bloqueado.

**Exclusão**: o maior parte do conteúdo só pode existir dentro de um projeto. Apenas administradores podem criar e excluir projetos de nível superior, mas os líderes de projetos podem criar ou excluir projetos aninhados.

A exclusão de projetos também exclui todo o conteúdo do Tableau e os projetos aninhados contidos neles. Para excluir um projeto sem perder seu conteúdo, mova o conteúdo para outro projeto primeiro. Não é possível desfazer a exclusão dos projetos.

Os ativos externos são tratados de maneira diferente. Eles não precisam estar em um projeto. Os recursos externos não são excluídos se o projeto for excluído e continuar aparecendo em Recursos externos. Consulte [Ativos externos que não estão em projetos](https://help.tableau.com/current/server/pt-br/dm_perms_assets.htm#external_assets_not_in_projects) para obter mais informações.

Para se aprofundar mais na administração de projetos, consulte [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm) e [Adicionar projetos e mover conteúdo para eles](https://help.tableau.com/current/server/pt-br/projects_add.htm).

## Projetos especiais

Padrão: o projeto denominado "Padrão" é um projeto especial. Quando outros projetos de nível superior são criados, eles usam o projeto padrão como modelo e copiam todas as suas regras de permissão dele (mas não a configuração de Permissões do ativo). O projeto Padrão não pode ser excluído, movido ou renomeado, mas sua descrição pode ser alterada. Ele não tem proprietário por padrão, mas pode ser atribuído um.

Projeto padrão de ativos externos: em Tableau Cloud e Tableau Server 2023.1 e posterior, se você tiver uma licença do Data Management com o Catalog ativado, o projeto denominado “Projeto padrão de ativos externos” aparecerá quando o Catalog precisar mover ativos externos novos ou existentes para ele. O Catalog coloca novos ativos externos e ativos externos de projetos excluídos no projeto padrão de ativos externos. O projeto não tem regras de permissão por padrão, portanto, os administradores do servidor e do site são os únicos usuários que podem vê-lo, a menos que sejam adicionadas permissões. Ele não pode ser excluído, movido ou renomeado, mas sua descrição pode ser alterada. Ele não tem proprietário por padrão, mas pode ser atribuído um.

## Definir um líder de projeto

Os líderes de projeto são usuários que têm acesso semelhante a administrador para um projeto específico ou hierarquia de projetos.

Para atribuir o status de líder de projeto a um grupo ou usuário

1. Abra caixa de diálogo Permissões do projeto Padrão.
2. Selecione uma regra de permissão existente ou clique em \+ Adicionar Regra de grupo/usuário e escolha o grupo ou usuário desejado.
3. Abra o menu de ação (...) dessa regra de permissão e selecione Definir Líder de projeto....

**Observação**: se o menu Ação incluir uma opção para Ativar "Definir o líder de projeto", isso precisa ser selecionado antes que o grupo ou o usuário possa ser definido como líder de projeto. Essa opção só aparece quando esse grupo ou usuário foi negado o recurso Líder de projeto (antes da versão 2020.1). Esse recurso negado precisa ser removido antes que possa ser definido como líder de projeto.

Depois que uma regra de permissão estabelece um líder de projeto, os modelos e recursos não podem ser editados porque todos os recursos são permitidos para líderes de projeto. Se um líder de projeto for estabelecido em um projeto que contém projetos aninhados, eles herdado o status de líder de projetos em todos os projetos aninhados e seu conteúdo.

O status Líder de projeto é sempre aplicado para baixo por toda a hierarquia do projeto e só pode ser removido do nível onde foi definido. Para remover o status Líder de projeto, siga as mesmas etapas mas selecione Remover como líder de projeto do menu de ação. Depois que um grupo ou usuário tenha sido removido como líder do projeto, essa regra de permissão terá todos os recursos definidos como Não especificado. Isso pode significar que o acesso e recursos desse projeto serão removidos se não houver outra regra de permissão dando-lhes permissões ao conteúdo. Para manter o acesso ao projeto e seu conteúdo, eles precisarão ter recursos definidos como qualquer outro grupo ou usuário.

**Observação**: os líderes de projeto podem atualizar trechos em seus projetos na maioria das circunstâncias. Eles não podem atualizar extrações se forem apenas o líder de um projeto aninhado (em vez de um projeto de nível superior) e o projeto de nível superior estiver _bloqueado (incluindo projetos aninhados)_.

## Bloquear permissões de ativos

As regras de permissão definidas no nível de projeto atuam como um padrão para conteúdo salvo nesse projeto e nos projetos aninhados que ele contiver. Se essas regras padrão de nível de projeto são aplicadas ou apenas preliminares depende da configuração de Permissão de ativo. Essa configuração pode ser realizada de duas maneiras, Bloqueada (recomendado) ou Personalizável. Bloquear um projeto remove a capacidade dos proprietários de conteúdo de modificar as regras de permissão no conteúdo. As permissões de bloqueio podem ser aplicadas a projetos aninhados ou apenas ao próprio projeto principal.

- Quando as Permissões de ativo são Bloqueadas (incluindo projetos aninhados), as regras de permissão definidas no nível de projeto são aplicadas a todo os ativos e todos os projetos aninhados.
- Quando as Permissões de ativo são **Bloqueadas** (_não_ incluindo projetos aninhados), as regras de permissão definidas no nível de projeto são aplicadas aos ativos no projetos. Projetos aninhados podem ser configurados independentemente com suas próprias regras de permissão e definidos como bloqueados ou personalizáveis.
- Quando as Permissões de ativos são personalizáveis, as regras de permissão definidas no nível de projeto são aplicadas a todo o conteúdo do projeto por padrão. No entanto, as regras de permissão podem ser modificadas para ativos individuais durante ou após a publicação.

**Observação**: se as regras de permissão forem bloqueadas ou personalizáveis, as permissões de conteúdo serão sempre aplicadas. _Bloqueadas_ e _personalizáveis_ referem-se apenas à forma como as permissões no nível de projeto são herdadas pelo conteúdo no projeto e quem pode alterá-las. Mesmo em um projeto com permissões personalizáveis, apenas usuários específicos podem modificar permissões (conteúdo ou proprietário de projeto, líder de projeto, administradores ou aqueles com o recurso Permissão definida).

Em um projeto bloqueado:

- As regras de permissão do projeto por tipo de conteúdo são aplicadas a todo o ativos.
- Somente administradores, proprietários de projeto e líderes de projeto podem modificar as permissões.
- Os proprietários de conteúdo perdem o recurso Definir permissão, mas mantêm todos os outros recursos em seu conteúdo.
- As permissões são previsíveis para todo o conteúdo em um projeto.

Em um projeto personalizável:

- As regras de permissão do projeto são aplicadas por padrão, quando o conteúdo é publicado no projeto ou quando projetos aninhados são criados, mas as permissões podem ser modificadas durante a publicação ou após a criação do conteúdo.
- Qualquer usuário com o recurso Definir permissões pode modificar as regras de permissão desse conteúdo.
- Os proprietários do conteúdo têm todos os recursos em seu conteúdo.
- As permissões podem ser diferentes em todo o conteúdo do projeto.
- Quaisquer alterações nas permissões no projeto pai personalizável não são aplicadas aos projetos aninhados.

### Definir ativos de conteúdo (bloquear um projeto)

Novos projetos de nível superior herdam todas as regras de permissão iniciais do projeto Padrão, mas não a configuração de Permissões de ativos, que é definida como Personalizável. Isso pode ser alterado para Bloqueada, se desejado.

Para configurar permissões de ativos:

1. Você deve estar conectado ao site como administrador, proprietário do projeto ou líder de projeto
2. Abra caixa de diálogo Permissões de um projeto.
3. Ao lado de Permissões de ativos no canto superior esquerdo, clique no link Editar e selecione a opção desejada na caixa de diálogo Permissões de ativos

![Caixa de diálogo Permissões de ativos com a opção Bloqueado selecionada.](/tableau/current/pt-br/server/pt-br/Img/perms_lockproject.png)

**Observação**: se o canto superior esquerdo não mostrar um link **Editar** na etapa 3 acima, use a caixa de diálogo Permissões de um (a) projeto aninhado ou uma parte de conteúdo em um projeto bloqueado, nesse caso o link deve levá-lo ao projeto de gestão, (b) parte de conteúdo em um projeto personalizável, que não mostrará nada, ou (c) exibição, que indicará como as permissões de exibição estão atreladas à pasta de trabalho. Para obter mais informações sobre a interação de permissões de exibições e pastas de trabalho, consulte [Mostrar ou ocultar as guias de planilha](https://help.tableau.com/current/server/pt-br/permissions.htm#sheettabs).

### Alterar permissões de ativos

Quando a configuração de Permissão de ativos de um projeto é alterada, o resultado depende da nova configuração. Alterações nas regras de permissão em uma hierarquia bloqueada devem ser feitas no nível de projeto de gestão.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 60%;"></colgroup><tbody><tr><td style="font-weight: bold;">Mudar de</td><td style="font-weight: bold;">Mudar para</td><td style="font-weight: bold;">Resultado</td></tr><tr><td rowspan="2" style="font-weight: normal;">Bloqueada (incluindo projetos aninhados)</td><td style="font-weight: normal;">Bloqueada</td><td><p>Não modifica as regras de permissão existentes.</p><p>Qualquer projeto aninhado se torna personalizável.</p></td></tr><tr><td style="font-weight: normal;">Personalizável</td><td><p>Não modifica as regras de permissão existentes, embora se tornem personalizáveis.</p><p>Qualquer projeto aninhado se torna personalizável.</p></td></tr><tr><td style="font-weight: normal;" rowspan="2">Bloqueada</td><td style="font-weight: normal;">Bloqueada (incluindo projetos aninhados)</td><td><p>Substitui as regras de permissão personalizadas existentes para todos os projetos aninhados e seu conteúdo. Isso não pode ser desfeito.</p></td></tr><tr><td style="font-weight: normal;">Personalizável</td><td><p>Não modifica as regras de permissão existentes, embora se tornem personalizáveis.</p><p>Quaisquer projetos aninhados mantêm suas configurações de permissão de conteúdo e regras de permissão.</p></td></tr><tr><td style="font-weight: normal;" rowspan="2">Personalizável</td><td style="font-weight: normal;">Bloqueada (incluindo projetos aninhados)</td><td>Substitui as regras de permissão personalizadas existentes do conteúdo no projeto e todos os projetos aninhados e seu conteúdo. Isso não pode ser desfeito.</td></tr><tr><td style="font-weight: normal;">Bloqueada</td><td><p>Substitui as regras de permissão personalizadas existentes para conteúdo no projeto. Isso não pode ser desfeito.</p><p>Quaisquer projetos aninhados mantêm suas regras de permissão e permanecem personalizáveis.</p></td></tr></tbody></table>

### Mova projetos e conteúdo

#### Mova o conteúdo do Tableau e os ativos externos

Quando o _conteúdo do Tableau_ ou _ativos externos_ é movido entre projetos com configurações de permissão diferentes, as configurações de Permissão de ativos determinam a lógica de como as permissões são aplicadas.

- Mover os ativos para um projeto bloqueado substituirá as regras de permissão existentes e imporá as permissões do destino.
- Mover os ativos para um projeto personalizável manterá as regras de permissão existentes no ativo.

**Observação**: antes do Tableau Server 2022.3 e do Tableau Cloud de junho de 2022, os ativos externos não podiam estar em projetos e as permissões nas tabelas eram gerenciadas por meio da configuração de Permissões de tabela do banco de dados pai. A partir do Tableau Server 2022.3 e do Tableau Cloud de junho de 2022, os ativos externos podem estar em projetos. Se um banco de dados ou uma tabela for movida para um projeto, as configurações mais antigas para controlar as permissões da tabela por meio do banco de dados serão ignoradas e as permissões do banco de dados ou da tabela seguirão a lógica de outros ativos.

#### Mover projetos

Quando um _projeto_ é movido para outro, as configurações de permissões no projeto que está sendo movido são mantidas, a menos que o item de destino tenha escopo para incluir projetos aninhados. (As permissões do projeto, neste caso, significam os recursos Exibir e Publicar para o próprio projeto.)

- Se o projeto de destino estiver definido como**bloqueado (incluindo projetos aninhados),** as permissões do projeto que está sendo movido _e o conteúdo_ são substituídas.
- Se o projeto de destino estiver definido como **bloqueado** (sem incluir projetos aninhados), as permissões do projeto que está sendo transferido não são substituídas. Se o projeto movido está bloqueado ou é personalizável é mantido da configuração original.
- Se o projeto de destino for definido como **personalizável,** as permissões do projeto que está sendo movido não são substituídas, mas agora são editáveis.

Se o projeto que está sendo movido foi anteriormente aninhado um principal que estava _bloqueado (incluindo projetos aninhados),_ quando movido, o projeto assume a configuração _bloqueado (incluindo projetos aninhados)_ e se torna o projeto de gestão dos projetos que contiver. Observação: esse é o mesmo resultado se um projeto for movido para se tornar um projeto de alto nível.

Tenha cuidado ao mover projetos aninhados bloqueados

Mover projetos aninhados dentro de _ambientes bloqueados (incluindo projetos aninhados)_ pode ser complicado. Um projeto pode ser movido para uma situação que impeça o usuário de movê-lo novamente.

Se um projeto aninhado pertencer a um usuário diferente do projeto de gerenciamento e o projeto de gerenciamento estiver definido como _bloqueado (incluindo projetos aninhados)_ , um projeto aninhado pode acabar impossibilitado de ser movido por qualquer pessoa, exceto um administrador.

Por exemplo, considere um projeto de nível superior bloqueado (incluindo projetos aninhados) pertencente ao usuário A e dois projetos aninhados pertencentes ao usuário B. Se o usuário B mover um projeto aninhado para dentro do outro, ele não poderá movê-lo de volta - e nem o usuário A.

- O usuário B não pode mover **Projeto aninhado 2** porque não tem direitos para mover direitos no **projeto de nível superior** como um destino.
- O usuário A não pode mover **Projeto aninhado 2** porque não tem direitos de movimentação sobre ele.
- Um líder de projeto no **Projeto de nível superior** não pode movê-lo, mesmo que o líder do projeto se desloque para projetos aninhados.
- Somente um administrador pode mover **Projeto aninhado 2** nesta configuração.

![Um projeto de nível superior com um ícone de cadeado e o nome "usuário A" próximo a ele, com "projeto aninhado 1" dentro e "projeto aninhado 2" dentro dele. Ambos os projetos aninhados são de propriedade do usuário B.](/tableau/current/pt-br/server/pt-br/Img/move_locked_nested_projects.png "Captura de tela da janela mover conteúdo")

## Coleções

Ao contrário dos projetos, que contêm conteúdo, uma coleção pode ser considerada uma lista de links para conteúdo. As permissões do projeto podem ser herdadas pelo conteúdo do projeto, mas as permissões para uma coleção não afetam o conteúdo adicionado à coleção. Isso significa que diferentes usuários podem ver diferentes números de itens em uma coleção, dependendo de quais itens eles têm permissão para ver. Para garantir que os usuários possam ver todos os itens em uma coleção, ajuste as permissões para esses itens individualmente.

As permissões para uma coleção podem ser alteradas usando a caixa de diálogo de permissões ou concedendo acesso ao compartilhar uma coleção, se você for um administrador ou o proprietário da coleção. Para obter mais informações, consulte [Gerenciar permissões de coleções](https://help.tableau.com/current/pro/desktop/pt-br/collections.htm#permissions).

#### Coleções privadas

Quando uma coleção é criada, ela é privada por padrão. Uma coleção privada aparece na página Minhas coleções do proprietário, mas não aparece na lista de todas as coleções em um site. Coleções privadas são coleções sem regras de permissão adicionadas. Ao contrário de outros tipos de conteúdo, as coleções não têm o grupo “Todos os usuários” adicionado por padrão. Quando você adiciona regras de permissão a uma coleção, ela não é mais sinalizada como privada. Para retornar uma coleção a um estado privado, remova as regras de permissão.

As coleções privadas podem ser visualizadas pelo proprietário da coleção, bem como pelos administradores, cuja função de site lhes dá permissões efetivas para visualizar todas as coleções.

<!-- document id=e286acd6bd78f944d5880bbcd12704a23de935ed43df727deb43c852fa427440 url=/tableau/current/pt-br/server/dm_perms_assets.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar permissões para ativos externos

O Tableau Cloud e o Tableau Server fornecem um espaço para acessar e gerenciar o conteúdo publicado. Quando o Tableau Cloud ou o Tableau Server é licenciado com o Data Management, você tem acesso ao Tableau Catalog. O Tableau Catalog adiciona um espaço complementar e um conjunto de recursos ao site para rastrear e gerenciar os metadados e a linhagem de ativos externos usados pelo conteúdo publicado no site.

## O Tableau Catalog indexa conteúdo e ativos

O Catalog descobre, rastreia e armazena os metadados do conteúdo publicado no Tableau Cloud ou no Tableau Server.

O Catalog indexa os metadados para o seguinte:

- **Conteúdo do Tableau:** pastas de trabalho, fontes de dados, fluxos, projetos, métricas, conexões virtuais, tabelas de conexões virtuais, usuários e sites. (O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm).)
- **Ativos externos:** bancos de dados (incluindo arquivos de dados) e tabelas (incluindo objetos semelhantes a tabelas) associadas ao conteúdo do Tableau.
    
    O Catalog classifica os metadados de ativos externos provenientes de fora do ambiente do Tableau. Os ativos externos podem ser armazenados em muitos formatos diferentes, como um servidor de banco de dados ou um arquivo .json local.
    
    O Catalog rastreia somente os metadados dos dados externos e não rastreia os dados subjacentes de forma alguma (brutos ou agregados).

Os metadados do Catalog incluem o seguinte: 

- **Informações de linhagem** ou a relação entre itens. Por exemplo, a tabela de Vendas tem uma relação com a fonte de dados Superstore e a pasta de trabalho de amostra Superstore.
- Informações do esquema. Alguns exemplos incluem:
    - Nomes de tabelas, nomes de coluna e tipos de coluna. Por exemplo, a Tabela A contém as Colunas A, B e C, que são tipos INT, VARCHAR e VARCHAR.
    - Nome do banco de dados e local do servidor. Por exemplo, Database\_1 é um banco de dados SQL Server em http://example.net.
    - Nome da fonte de dados e os nomes e tipos dos campos que a fonte de dados contém. Por exemplo, a fonte de dados da Superloja possui os campos AA, BB e CC. O campo CC é um campo calculado que faz referência ao campo AA e ao campo BB.
- **Informações coletadas**, adicionadas ou gerenciadas do usuário. Por exemplo, descrições de itens, certificações, contatos do usuário, avisos de qualidade de dados e muito mais.

### Como funciona o Tableau Catalog?

O Tableau Catalog indexa todo o conteúdo publicado no Tableau Cloud ou no Tableau Server para rastrear metadados de linhagem e esquema. Por exemplo, os metadados são provenientes de pastas de trabalho, pastas de trabalho em pacote, fontes de dados e do repositório do Tableau Server ou Tableau Cloud.

Como parte do processo de indexação, os metadados de linhagem e esquema sobre ativos externos (bancos de dados, tabelas e outros objetos) usados pelo conteúdo publicado também são indexados.

**Observação:** além de acessar o Catalog do Tableau Cloud ou do Tableau Server, os metadados indexados também podem ser acessados pela API de metadados do Tableau e pela API REST do Tableau Server. Para obter mais informações sobre a API de metadados do Tableau ou os métodos de metadados na API REST, consulte [API de metadados do Tableau](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_metadata.htm) e [métodos de metadados](https://help.tableau.com/current/api/metadata_api/pt-br/index.html) na API REST do Tableau Server, respectivamente.

## Permissões para metadados

As permissões controlam quem está autorizado a visualizar e gerenciar os ativos externos e quais metadados são mostrados por meio da linhagem.

**Observação:** se o Tableau Cloud ou o Tableau Server não estiver licenciado com o Data Management, então, por padrão, apenas os administradores poderão ver os metadados do banco de dados e da tabela por meio da API de metadados do Tableau.

### Acesso aos metadados

As permissões usadas para acessar os metadados por meio do Catalog (ou da API de metadados) funcionam de modo semelhante às permissões de acesso ao conteúdo por meio do Tableau Cloud ou do Tableau Server, com algumas considerações adicionais para dados confidenciais que podem ser expostos por linhagem e pelos recursos concedidos a ativos externos.

#### Permissões para o conteúdo do Tableau

O Catalog segue os recursos de Exibição e Gerenciamento já implementados pelo conteúdo existente do Tableau para controlar os metadados que você pode ver e gerenciar no conteúdo do Tableau. Para obter informações mais gerais sobre esses recursos, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#permissioncapabilities).

#### Permissões para ativos externos usando _permissões derivadas_

Quando o Tableau Cloud ou o Tableau Server estiver licenciado com o Data Management, por padrão, o Catalog usa as _permissões derivadas_ para conceder automaticamente os recursos a ativos externos. As permissões derivadas são permissões para ativos externos derivados do conteúdo do Tableau ao qual estão associados.

O recurso Exibir:

- Se você for o proprietário de uma pasta de trabalho, uma fonte de dados ou um fluxo, poderá ver os metadados de banco de dados e tabela usados _diretamente_ por essa pasta de trabalho, essa fonte de dados ou esse fluxo. Consulte as [Observações adicionais sobre a linhagem](#addnotes).
- Se você for um proprietário ou líder de projeto, poderá ver todos os metadados de banco de dados e tabela usados pelo conteúdo publicado no projeto.
- Os arquivos inseridos usam as permissões do conteúdo da fonte (como a pasta de trabalho, fonte de dados ou fluxo), em vez das permissões derivadas do ativo externo (o banco de dados ou tabela). Por exemplo, se você conseguir ver uma pasta de trabalho com um arquivo inserido, verá o arquivo inserido e seus metadados usados por essa pasta de trabalho.

Os recursos Substituir e Definir permissões:

- Se você for o proprietário de um fluxo, poderá editar e gerenciar permissões para os metadados banco de dados e de tabela usados pela saída de fluxo.

**Observação:** no caso de fluxos, os recursos mencionados acima se aplicam somente após o fluxo ter sido executado com êxito pelo menos uma vez sob o proprietário atual do fluxo.

**Verificar permissões**

Como um administrador ou alguém que tenha recebido a capacidade de definir permissões para um ativo, você pode validar quem tem permissões derivadas seguindo as etapas abaixo.

1. Faça logon no Tableau Cloud ou no Tableau Server.
2. No painel de navegação esquerdo, clique em Ativos externos.
3. No menu suspenso, selecione Bancos de dados e arquivos ou Tabelas e objetos.  
    **Observação:** arquivos locais, como arquivos .json ou .csv, são agrupados como ativos externos em Bancos de dados.
4. Marque a caixa de seleção ao lado do banco de dados ou da tabela cujas permissões você deseja modificar e selecione Ações > Permissões.
5. Na caixa de diálogo Permissões, clique em \+ Adicionar regra de grupo/usuário e comece a digitar para procurar um grupo ou usuário.
6. Nas regras de permissão, valide as permissões clicando em um nome de grupo ou usuário para ver as permissões efetivas abaixo.
    
    ![Caixa de diálogo Permissões que mostra as permissões efetivas de um usuário](/tableau/current/pt-br/server/pt-br/Img/dm_perms_derived.png)

**Ordem de precedência para permissões derivadas em ativos externos**

Quando as permissões derivadas são configuradas para o site do Tableau Cloud ou Tableau Server, o nível de acesso de cada usuário a ativos externos depende do conteúdo associado do Tableau e da ordem de precedência de regras que o Tableau usa para seu conteúdo.

O Tableau segue estas regras, prosseguindo para a próxima regra, somente se a atual avalia como “negado”. Se alguma regra avaliar como “permitido”, o recurso será permitido e o Tableau interromperá a avaliação. Esta lista de regras baseia-se nas [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#EvaluatePermRules).

Para o recurso Exibir:

1. Função administrativa
2. Licença
3. Líder do projeto (conteúdo do Tableau)
4. Proprietário do projeto (conteúdo do Tableau)
5. Proprietário do conteúdo (conteúdo do Tableau)
6. _Permissões derivadas_ (aplicam-se apenas a ativos externos e ao recurso de Exibição)
    1. Função administrativa
    2. Licença
    3. Líder do projeto (ativos externos)
    4. Proprietário do projeto (ativos externos)
    5. Proprietário do conteúdo (ativos externos)
7. Permissões explícitas

Para os recursos Substituir e Definir permissões: 

1. Função administrativa
2. Licença
3. Líder do projeto (conteúdo do Tableau)
4. Proprietário do projeto (conteúdo do Tableau)
5. Proprietário do conteúdo (conteúdo do Tableau)
6. Permissões explícitas (conteúdo do Tableau)
7. _Permissões derivadas_ (aplica-se apenas a ativos externos e aos recursos Substituir e Definir permissões para obter saídas de fluxo)
    1. Função administrativa
    2. Licença
    3. Líder do projeto (ativos externos)
    4. Proprietário do projeto (ativos externos)
    5. Proprietário do conteúdo (ativos externos)

**Desativar permissões derivadas**

Como administrador, você pode desativar a configuração padrão das permissões derivadas de um site para conceder manualmente as permissões explícitas aos bancos de dados e às tabelas.

1. Entre no Tableau Cloud ou no Tableau Server como administrador.
2. No painel de navegação esquerdo, clique em Configurações.
3. Na guia Geral, em Acesso automático aos metadados sobre bancos de dados e tabelas, desmarque a caixa de seleção Conceder automaticamente aos usuários autorizados o acesso aos metadados sobre bancos de dados e tabelas.
    
    **Observação:** as mensagens de aviso de qualidade de dados em bancos de dados e tabelas visíveis para os usuários por meio de permissões derivadas permanecerão visíveis para esses usuários, mesmo se a caixa de seleção não estiver marcada.

### Definir permissões em ativos externos individuais

Para conceder permissões adicionais aos usuários para exibir, editar (substituir) e gerenciar ativos externos, um administrador pode conceder esses recursos explicitamente em bancos de dados ou tabelas individuais para usuários ou grupos.

A partir do Tableau Server 2022.3 e do Tableau Cloud de setembro de 2022, você pode organizar ativos externos em projetos. A herança de permissões para ativos externos funciona da mesma forma que para outros ativos do conteúdo do Tableau, conforme descrito no tópico [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#permissionfundamentals), e pode simplificar o gerenciamento de permissões.

**Resumo dos recursos de permissões**

A tabela a seguir mostra os recursos que você pode definir para ativos externos:

<table class="table--plain"><colgroup><col style="width: 25%;"><col><col style="width: 25%;"></colgroup><tbody><tr><th>Recurso</th><th>Descrição</th><th>Modelo</th></tr><tr><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição<br></p></td><td><p>Veja o ativo de banco de dados ou tabela.</p></td><td>Exibição</td></tr><tr><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</p></td><td><p>Adicionar ou editar avisos de qualidade de dados e descrições do ativo de banco de dados ou tabela. Antes da versão 2020.1, o recurso de Substituição era chamado de Salvar.</p></td><td>Publicar</td></tr><tr><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover.">Mover</p></td><td>Mova o ativo de banco de dados ou tabela.</td><td>Administração</td></tr><tr><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</p></td><td><p>Conceder ou negar permissões para o ativo de banco de dados ou tabela.</p></td><td>Administração</td></tr></tbody></table>

**Definir permissões em um banco de dados ou uma tabela**

Para definir permissões em bancos de dados ou tabelas, use o procedimento a seguir.

1. Entre no Tableau Cloud ou no Tableau Server como administrador ou alguém com acesso à capacidade de “Definir permissões”.
2. Encontre o banco de dados ou tabela. Você pode fazer isso por meio de Explorar (a partir do Tableau Server 2022.3 e o Tableau Cloud de setembro de 2022) se souber a localização atual do banco de dados ou da tabela, ou por meio de Ativos externos para ver uma lista de todos os bancos de dados, tabelas e arquivos.
    
    - Explorar - No painel de navegação esquerdo, clique em Explorar e localize o projeto em que o banco de dados ou a tabela está.
    - Ativos externos - No painel de navegação esquerdo, clique em Ativos externos. No menu suspenso, selecione Bancos de dados e arquivos ou Tabelas e objetos (Observação: arquivos locais, como arquivos .json ou .csv são agrupados como ativos externos em Bancos de dados.)
3. Marque a caixa de seleção ao lado do banco de dados ou da tabela cujas permissões você deseja modificar e selecione Ações > Permissões.
4. Na caixa de diálogo Permissões, clique em \+ Adicionar regra de grupo/usuário e comece a digitar para procurar um grupo ou usuário.
5. Selecione um modelo de função de permissão para aplicar um conjunto inicial de recursos para o grupo ou usuário e, em seguida, clique em Salvar. Os modelos disponíveis são: Exibir, Publicar, Administração, Nenhum e Negado.
6. Para personalizar mais a regra, clique em um recurso na regra para defini-lo como Permitido ou Negado ou deixe-o como Não especificado. Clique em Salvar quando terminar.
7. Configure as regras adicionais que desejar para outros grupos ou usuários.
8. Nas regras de permissão, valide as permissões clicando em um nome de grupo ou usuário para ver as permissões efetivas abaixo.
    
    ![Permissões de usuário para o banco de dados adventureworks](/tableau/current/pt-br/server/pt-br/Img/dm_perms_set.png)

**Ativos externos que não estão em projetos**

Existem alguns cenários em que um ativo externo não está em um projeto:

- Os ativos externos descobertos pelo Catalog antes da existência do Projeto padrão de ativos externos (Tableau Cloud de dezembro de 2022/Servidor 2023.1) não estarão em um projeto, a menos que tenham sido movidos para um desde então.
- Ativos externos que tiveram seu projeto excluído antes do Projeto padrão de ativos externos existentes (Tableau Cloud dezembro de 2022/Servidor 2023.1) não estarão em um projeto, a menos que tenham sido movidos para um desde então.
- No Tableau Server 2022.1 e versões anteriores, os ativos externos não podem ser movidos para projetos.

Se um ativo externo não estiver em um projeto, as permissões para ativos externos funcionarão como no Tableau Server 2022.1 e no Tableau Cloud de junho de 2022 e anteriores. Ou seja, as permissões de banco de dados e de tabela são controladas independentemente do conteúdo em projetos, e as permissões de tabela podem ser gerenciadas por meio de permissões de banco de dados. Quando as permissões são definidas no nível do banco de dados dessa maneira, essas permissões podem servir como um modelo para quaisquer tabelas filhas recém-descobertas e indexadas desse banco de dados. Além disso, as permissões de banco de dados também podem ser bloqueadas de modo que as tabelas secundárias sempre usem as permissões definidas no nível de banco de dados.

Observação: você não pode bloquear (ou desbloquear) permissões para um banco de dados se o banco de dados estiver em um projeto.

Para bloquear (ou desbloquear) permissões para o banco de dados, use o procedimento a seguir:

1. Entre no Tableau Cloud ou no Tableau Server como administrador ou alguém com acesso à capacidade de “Definir permissões”.
2. No painel de navegação esquerdo, clique em Ativos externos. Por padrão, a página Ativos externos mostra uma lista de bancos de dados e arquivos.
3. Marque a caixa de seleção ao lado do banco de dados cujas permissões você deseja bloquear, selecione Ações > Permissões e, em seguida, clique no link Editar permissões da tabela.
4. Na caixa de diálogo Permissões da tabela no banco de dados, selecione Bloqueada e clique em Salvar.
5. Para desbloquear as permissões, clique em Editar novamente e selecione Personalizado.

### Informações de linhagem de acesso

O Catalog (e a API de metadados) podem expor metadados de relacionamentos e dependências, também chamados de _linhagem_, entre o conteúdo do Tableau e os ativos externos no Tableau Cloud ou no Tableau Server. A linhagem mostra três pontos principais:

- Como os itens se relacionam entre si, direta ou indiretamente
- Quantos desses itens se relacionam entre si
- Os dados confidenciais sobre os itens da linhagem se tiver as permissões apropriadas

**Dados de linhagem confidenciais**

Em alguns casos, a linhagem pode conter dados confidenciais, como mensagens de aviso de qualidade de dados, conteúdo ou nomes de ativos, ou itens e metadados relacionados.

Por padrão, as informações completas da linhagem são exibidas para todos os usuários, enquanto seus dados confidenciais são bloqueados para usuários específicos que não possuem os recursos de Exibição apropriados. O conceito de bloqueio de dados confidenciais é chamado de ofuscação.

A ofuscação permite que todos os metadados na linhagem sejam visíveis, mantendo seus dados confidenciais bloqueados de usuários específicos que não possuem os recursos de Exibição apropriados. Esse padrão permite fluxos de trabalho que dependem de uma análise de impacto completa.

Se a ofuscação de dados confidenciais na linhagem não for suficiente para sua organização, certas partes da linhagem, incluindo seus dados confidenciais, podem ser filtradas.

A filtragem omite certas partes da linhagem (e áreas relacionadas à linhagem, como detalhes de dados) para usuários específicos que não têm os recursos de Exibição apropriados para seus dados confidenciais. Como a filtragem omite partes da linhagem, ela evita fluxos de trabalho que dependem de uma análise de impacto completa.

Para alterar o modo como os dados confidenciais são tratados, faça o seguinte:

1. Entre no Tableau Cloud ou no Tableau Server como administrador.
2. No painel de navegação esquerdo, clique em Configurações.
3. Na guia Geral, em Informações confidenciais de linhagem, selecione o botão de opção que melhor trata as informações de linhagem para todos os usuários no site do Tableau Cloud ou no Tableau Server.

**Observações adicionais sobre a linhagem**

- **Se você tiver o recurso de Exibição para os ativos relacionados,** poderá ver quando e quais ativos e conteúdo se relacionam entre si e seus metadados confidenciais.
    
    Por exemplo, você pode ver 1) os nomes, os avisos de qualidade de dados e o número total de bancos de dados e tabelas upstream relacionados e 2) o número combinado de planilhas (visíveis e ocultas) na linhagem da pasta de trabalho downstream do ativo que você está avaliando.
- **Se você _não_ tiver o recurso de Exibição para os ativos relacionados,** poderá sempre ver quando os ativos se relacionam entre si.
    
    Por exemplo, você pode ver 1) se existem bancos de dados e tabelas upstream relacionados na linhagem e 2) o número total de bancos de dados ou de tabelas relacionadas ao ativo que você está avaliando.
    
    No entanto, não é possível ver os metadados associados a esses ativos quando não tiver o recurso de exibição para eles. Quando os metadados são bloqueados devido a permissões limitadas, ou quando o ativo está em um Espaço pessoal, você vê Permissões necessárias.
    
    ![Exemplo de um ativo onde a permissão é necessária](/tableau/current/pt-br/server/pt-br/Img/dm_perms_required_related.png)
- **Se você _não_ tiver o recurso de Exibição para os ativos relacionados,** poderá sempre ver quando os ativos forem certificados.
    
    No entanto, se você não tiver o recurso Exibir, não poderá ver informações confidenciais relacionadas à certificação, como os nomes dos bancos de dados e tabelas relacionados. Quando os metadados são bloqueados devido a permissões limitadas, ou quando o ativo está em um Espaço pessoal, você vê **Permissões necessárias**.
    
    ![Exemplo de um ativo onde a permissão é necessária](/tableau/current/pt-br/server/pt-br/Img/dm_perms_required_cert_message.png)
    
    Para obter mais informações sobre linhagem, consulte [Usar linhagem para análise de impacto](https://help.tableau.com/current/server/pt-br/dm_lineage.htm).

**Observações adicionais sobre marcas descobertas através de dados de linhagem**

Além do conteúdo do Tableau, os ativos externos também podem ser marcados. Embora as marcas sejam sempre visíveis, itens marcados que você vê através de dados de linhagem podem ser ofuscados (padrão) ou filtrados como descrito anteriormente neste tópico.

Quando os itens marcados são ofuscados:

- **Se você tiver o recurso Exibir para itens marcados**, poderá ver os itens marcados e itens marcados relacionados, além de todos os metadados.
- **Se você não tiver o recurso Exibir para itens marcados**:
    
    - Você pode ver o tipo de itens marcados e relacionados, mas não pode ver metadados sensíveis sobre os itens. Por exemplo, suponha que você use um filtro de marca para ver itens com a marca "Notável". Embora você possa ver que existem itens de banco de dados marcados com "Notável", não pode ver os nomes dos bancos de dados marcados.
    - É possível ver quantos itens relacionados marcados existem. Por exemplo, suponha que você faça uma consulta de marca em "Notável". Sua consulta retorna cinco bancos de dados marcados.

Quando os itens marcados são filtrados, os itens marcados e relacionados que você vê estão limitados apenas aos itens para os quais você tem o recurso Exibir.

Para obter mais informações sobre marcas, consulte [Itens marcados](https://help.tableau.com/current/pro/desktop/pt-br/tags.htm) na Ajuda do Tableau Desktop.

Possível incompatibilidade entre os resultados de ativos e os resultados de conteúdo

Quando o Catalog mostra informações de linhagem, ele fornece informações sobre o conteúdo do Tableau e os ativos externos. A linhagem do Catalog sempre mostra a contagem real ou o resultado dos itens associados. No entanto, em outras áreas do site, você poderá ver menos itens. Isso pode ser devido aos seus recursos de Exibição. Fora do Catalog, você vê apenas o conteúdo permitido por suas permissões.

Por exemplo, suponha que está observando a fonte de dados Superstore. A linhagem da fonte de dados Superstore mostra quantas tabelas subjacentes upstream estão conectadas à fonte de dados e quantas pastas de trabalho downstream dependem da fonte de dados. No entanto, como você pode não ter permissões para ver todas essas pastas de trabalho downstream, o número de pastas de trabalho relacionadas na linhagem do Catalog (total real) pode ser maior que o número de pastas de trabalho na guia Pastas de trabalho conectadas (o que você tem permissão para ver) .

Pode haver outros motivos, que não estão relacionados a permissões, pelos quais você pode ver uma incompatibilidade as contagens de ativos e de conteúdo. Para obter mais informações, consulte [Usar linhagem para análise de impacto](https://help.tableau.com/current/server/pt-br/dm_lineage.htm).

## Quem pode fazer isso

As informações a seguir resumem os tipos de usuários que podem executar as tarefas descritas neste tópico.

Site do Tableau Cloud ou administrador do Tableau Server

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 277px;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1"><span class="mc-variable Variables.DM_sku variable">Data Management</span></th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Recurso</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">Requisitos</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="6"><b>Licenciado</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ver ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nenhum</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Editar ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nenhum</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Alterar permissões em ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nenhum</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Conceder aos usuários a capacidade de ver ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>Padrão:</b> quando "permissões derivadas" está ativo, seus usuários podem ver metadados em ativos externos para o conteúdo que possuem ou para o conteúdo que é publicado em um projeto do qual eles são líderes ou proprietários.</p><p><b>Ad-hoc:</b>&nbsp;configure permissões explícitas de <span class="uicontrol">Exibição</span> em um ativo externo especificado.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Conceder aos usuários a capacidade de editar ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Configure permissões explícitas de "gravar" ou <span class="uicontrol">Substituir</span> em um ativo externo especificado (se não for concedido automaticamente porque o usuário é um proprietário de fluxo).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Conceder aos usuários a capacidade de alterar permissões em ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Configure explicitamente "editar" ou <span class="uicontrol">Definir permissões</span> em um ativo externo especificado (se não for concedido automaticamente porque o usuário é um proprietário de fluxo).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="6"><b>Não licenciado</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Veja todos os ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Aplica-se apenas à API de metadados</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Editar ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #dcdcdc;">Requer <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Alterar permissões em ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #dcdcdc;">Requer <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Conceder aos usuários a capacidade de ver ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>Aplica-se apenas à API de metadados:</b></p><p>Você pode ativar permissões derivadas, como descrito acima. Se "permissões derivadas" estiver ativo, seus usuários podem ver metadados em ativos externos para o conteúdo que possuem ou para o conteúdo que é publicado em um projeto do qual eles são líderes ou proprietários.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Conceder aos usuários a capacidade de editar ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #dcdcdc;">Requer <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Conceder aos usuários a capacidade de alterar permissões em ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="background-color: #dcdcdc;">Requer <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr></tbody></table>

Usuário com licença Creator (Criador) ou Explorer (Explorador)

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 277px;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1"><span class="mc-variable Variables.DM_sku variable">Data Management</span></th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Recurso</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">Requisitos</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3"><b>Licenciado</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ver ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>Padrão:</b> quando "permissões derivadas" é habilitado pelo administrador de site do Tableau Cloud ou administrador do Tableau Server, você pode ver os metadados em ativos externos do conteúdo que você possui ou do conteúdo que é publicado em um projeto do qual você é líder ou proprietário.</p><p><b>Ad-hoc:</b> veja os metadados em ativos externos aos quais ele recebeu permissões explícitas de <span class="uicontrol">Exibição</span>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Editar ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Edite os metadados em um ativo externo que lhe foram concedidas permissões explícitas de "gravação" ou <span class="uicontrol">Substituição</span> no (se não for concedido automaticamente porque o usuário é um proprietário de fluxo).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Alterar permissões em ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Altere as permissões em um ativo externo que foi concedido permissões explícitas de "edição" ou <span class="uicontrol">Definir permissões</span> no ((se não for concedido automaticamente porque o usuário é um proprietário de fluxo).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Conceder permissões a outros usuários para ver ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Altere as permissões em um ativo externo que foi concedido permissões explícitas de "edição" ou <span class="uicontrol">Definir permissões</span> no ((se não for concedido automaticamente porque o usuário é um proprietário de fluxo).</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="4"><b>Não licenciado</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ver ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>Aplica-se apenas à API de metadados:</b></p><p>Se "permissões derivadas" for habilitada pelo seu administrador de site do Tableau Cloud ou administrador do Tableau Server, você pode ver metadados em ativos externos para o conteúdo que você possui, ou para o conteúdo que é publicado em um projeto do qual você é líder ou proprietário.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Editar ativos e seus metadados</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="3" style="background-color: #dcdcdc;"><p rowspan="5">&nbsp;</p><p rowspan="5">Requer <span class="mc-variable Variables.DM_sku variable">Data Management</span></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Alterar permissões em ativos e seus metadados</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Conceder permissões a outros usuários para ver ativos e seus metadados</td></tr></tbody></table>

<!-- document id=635cc166b6d1364c81b29010faae3c7a959b0be889e1209957f05c8dc747f465 url=/tableau/current/pt-br/server/owner.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar propriedade de conteúdo

Ao publicar uma fonte de dados, pasta de trabalho, ou fluxo no Tableau Server ou criar um projeto, você se torna o _proprietário_. Um proprietário de conteúdo, líder de projeto com função de site adequada ou administrador pode alterar a propriedade de um ativo de conteúdo. Depois que a propriedade for alterada, o proprietário original não tem nenhuma conexão especial com o item do conteúdo, e sua capacidade de acessá-lo é determinada pelas permissões dele no projeto ou no item.

## Quem pode alterar ou receber a propriedade, por tipo de conteúdo

Poder alterar ou receber propriedades depende de suas permissões e de seu relacionamento com o ativo de conteúdo, conforme descrito na tabela a seguir.

**Observação:** o acesso completo de líder de projeto está disponível apenas com algumas funções de site. Para obter informações, consulte [Administração no nível do projeto](https://help.tableau.com/current/server/pt-br/projects.htm#project-admin).

<table class="simple-table"><colgroup><col style="width: 30%;" title="1"><col style="width: 30%;" title="2"><col style="width: 40%;" title="2"></colgroup><tbody><tr><td><b>Tipo de ativo de conteúdo</b></td><td><b>Quem pode alterar propriedades</b></td><td><b>Quem pode receber propriedades</b></td></tr><tr><td><p><strong>Projetos de nível superior</strong></p></td><td><ul><li>Administrador de servidor<sup>1</sup></li><li>Administrador de site</li></ul></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li><span class="mc-variable Variables.siterole-author variable">Creator</span></li><li>Explorer (pode publicar)</li></ul></td></tr><tr><td><p><strong>Projetos secundários (aninhados)</strong></p></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Proprietário do projeto</li></ul></td><td><p>Qualquer administrador ou proprietário, <i>excluindo</i> <span class="mc-variable Variables.sku-explorer variable">Explorer</span> e <span class="mc-variable Variables.siterole-basic variable">Viewer</span>.</p></td></tr><tr><td><strong>Pastas de trabalho e fontes de dados</strong><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Proprietário de pasta de trabalho ou fonte de dados</li><li>O líder ou proprietário do projeto que contém o item</li></ul></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li><span class="mc-variable Variables.siterole-author variable">Creator</span></li><li>Explorer (pode publicar)</li></ul></td></tr><tr><td><strong>Métricas</strong> (O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/metrics_create.htm">Criar e solucionar problemas de métricas (descontinuado)</a>.)</td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Proprietário da métrica</li><li>O líder ou proprietário do projeto que contém o item</li></ul></td><td><p>Qualquer administrador ou usuário do site, <i>excluindo</i> <span class="mc-variable Variables.sku-explorer variable">Explorer</span> e <span class="mc-variable Variables.siterole-basic variable">Viewer</span>.</p></td></tr><tr><td><strong>Fluxos</strong><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Proprietário do fluxo (2025.2 e posterior)</li></ul></td><td><ul><li><p>Administrador de servidor</p></li><li><p>Administrador de site</p></li><li><p><span class="mc-variable Variables.siterole-author variable">Creator</span></p></li></ul><p class="note"><b>Observação</b>: a partir da versão 2025.1, os administradores do servidor e do site só podem alterar o proprietário para eles próprios.</p></td></tr><tr><td><strong>Funções de dados</strong><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Proprietário de função de dados</li><li>O líder ou proprietário do projeto que contém o item</li></ul></td><td><p>Qualquer administrador ou usuário do site, excluindo <span class="mc-variable Variables.sku-explorer variable">Explorer</span> e <span class="mc-variable Variables.siterole-basic variable">Viewer</span>.</p></td></tr><tr><td><strong>Coleções</strong></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Proprietário da coleção</li></ul></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li><span class="mc-variable Variables.siterole-author variable">Creator</span></li><li><span class="mc-variable Variables.sku-explorer variable">Explorer</span></li><li><span class="mc-variable Variables.siterole-basic variable">Viewer</span></li></ul></td></tr><tr><td><strong>Conexões virtuais</strong><sup>2</sup></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Proprietário da conexão virtual</li></ul></td><td><ul><li>Administrador de servidor</li><li>Administrador de site</li><li>Creator</li></ul></td></tr></tbody></table>

1 A função no site “Administrador do servidor” se aplica apenas ao Tableau Server; não ao Tableau Cloud.

2 Conexões virtuais requerem Data Management. Consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm) para obter detalhes. Observe que para editar uma conexão virtual, você deve ter as credenciais do banco de dados.

## Considerações para a alteração da propriedade de conteúdo

- Antes de remover um usuário do Tableau Server, tenha certeza de que ele não é proprietário de nenhum ativo de conteúdo.
    - Se o usuário não for proprietário de conteúdo, primeiro, reatribua a propriedade desses ativos antes de excluir o usuário. Caso contrário, a função no site dos ativos será definida como Não licenciado, mas não será excluída, e apenas um administrador poderá executar determinadas ações nesse conteúdo. Reatribua a propriedade de pastas de trabalho ou fontes de dados com credenciais incorporadas antes de definir a função de site do usuário como Não licenciado ou excluir o usuário.
    - Se você alterar a propriedade de uma pasta de trabalho, fonte de dados ou fluxo que inclua credenciais incorporadas para se conectar a dados subjacentes, as credenciais incorporadas serão excluídas e você precisará se autenticar novamente para se conectar.
    
    **Nota:** isso não se aplica a credenciais inseridas que usam chaves gerenciadas. Nesses casos, as credenciais são preservadas mesmo após a alteração de propriedade.
    
    As conexões com fontes de dados publicadas são autenticadas usando o proprietário do fluxo original e autorizadas com base em suas permissões. O novo proprietário precisaria das permissões de leitura/gravação necessárias para essa fonte de dados. Caso contrário, o fluxo falharia ao tentar se conectar ou gravar na fonte de dados.
    
    - A propriedade das fontes de dados de entrada ou saída para um fluxo também pode precisar ser transferida para o novo proprietário ou suas permissões para a fonte de dados podem precisar ser atualizadas.
    - Para atualizar suas credenciais inseridas basta editar as informações de conexão no Tableau Server. Para obter mais informações, consulte [Editar conexões](https://help.tableau.com/current/server/pt-br/connections_modify.htm). Para fluxos, você pode abrir e editar o fluxo na criação na Web do Tableau Prep e republicá-lo com as novas credenciais.
- Você só pode transferir a propriedade em fluxos publicados. Não é possível alterar a propriedade de rascunhos do fluxo.
- Se você não bloquear as permissões para os projetos, garanta que os usuários aos quais fornece conteúdo saibam suas diretrizes de permissões, ou sua conta para permissões ao alterar a propriedade. Em projetos desbloqueados, por padrão, os proprietários do conteúdo podem definir permissões em seu conteúdo. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#LockProject).
- Embora seja possível alterar o proprietário de uma métrica para um usuário com uma função de site de Viewer ou Explorer, isso não é recomendado, pois fará com que a atualização da métrica seja suspensa. Uma função de site de Creator ou Explorer (pode publicar) é necessária para atualizar, substituir ou excluir uma métrica.

## Alterar o proprietário de um recurso de conteúdo

1. Faça login no ambiente da Web do Tableau Server e, no menu de navegação, selecione Explorar.
2. Navegue até o conteúdo que você quer atribuir a outra pessoa.
    - Se desejar reatribuir vários do mesmo tipo de conteúdo, como várias pastas de trabalho, por exemplo, selecione o tipo de conteúdo do menu suspenso.
    - Se desejar reatribuir vários itens dentro do mesmo projeto, navegue até o projeto.
        
        Se não tiver certeza de onde encontrar um projeto secundário, exiba os filtros e selecione Mostrar todos os projetos.
    - Se você quiser reatribuir vários itens de conteúdo com o mesmo proprietário, encontre o usuário em página Usuários.
3. Selecione os itens que você deseja reatribuir e selecione Ações > **Alterar proprietário**.
    
    Os outros comandos de menu exibidos dependem do tipo de conteúdo.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/owner_wkbks_change.png)
4. Digite o nome do usuário ou selecione-o na lista.
    
    ![Um formulário para alterar o proprietário de pastas de trabalho e fluxo selecionados.](/tableau/current/pt-br/server/pt-br/Img/owner_change_256.png)
5. Selecione **Alterar proprietário**.

<!-- document id=f41f58fa72f8a4820b2ce299b15bdf4edf7e759e7d692bbc4d0f0daf3eaf1f5e url=/tableau/current/pt-br/server/dm_labels_manage.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar rótulos de dados

A partir do Tableau Cloud de outubro de 2023 e do Tableau Server 2023.3, se você tiver uma licença Data Management e for administrador, poderá usar o gerenciador de etiquetas para criar ou editar nomes e categorias de etiquetas. Essas personalizações afetam a maneira como os rótulos aparecem no Tableau quando os usuários interagem com os rótulos.

Observação: você também pode usar os métodos labelValues e labelCategories da API REST para criar e editar rótulos e categorias de rótulos. (Os administradores do Tableau Cloud podem criar e modificar nomes e descrições de rótulos usando os métodos labelValues desde junho de 2023 do Tableau Cloud.) Para obter mais informações, consulte os Métodos de metadados na [Referência da API REST](https://help.tableau.com/v0.0/api/rest_api/pt-br/REST/rest_api_ref_metadata.htm).

## Gerenciador de etiquetas

Para usar o gerenciador de etiquetas, faça login como administrador e selecione Rótulos de dados no painel de navegação esquerdo.

![Uso do item de menu Rótulos de dados para acessar a página Rótulos de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_manager_data_labels_menu_item.png)

Como alternativa, se você estiver conectado como administrador e abrir a caixa de diálogo Rótulos de dados para rotular um ativo, um link Gerenciar rótulos é exibido no canto inferior. O link Gerenciar rótulos leva à página Rótulos de dados. (No Tableau Server 2023.3 e versões anteriores, o link Gerenciar rótulos é exibido nos menus suspensos de seleção de rótulo da certificação individual, aviso de qualidade de dados, rótulo de sensibilidade e caixas de diálogo de rótulo personalizado.)

![Uso do link Gerenciar rótulos para acessar a página Rótulos de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_manager_alt_entry_point_248.png)

A página do gerenciador de rótulos mostra uma linha para cada rótulo, classificada por categoria de rótulo. Cada linha inclui a categoria do rótulo, o nome (aqui conhecido como valor), um menu Ações (...) para executar ações nesse rótulo, visibilidade e descrição.

![A página Rótulos de dados e a lista de rótulos](/tableau/current/pt-br/server/pt-br/Img/dm_label_manager_label_list_246.png)

Use o gerenciador de rótulos para:

- **Editar rótulos integrados**
    - Por exemplo: você altera o nome do aviso de qualidade integrado "Em manutenção" para "Modo de manutenção".
    - Por exemplo: você altera a visibilidade dos rótulos de monitoramento de atualização de extração de visibilidade padrão para alta visibilidade, para que sejam exibidos nas exibições.
- **Criar novos rótulos para as categorias integradas e existentes**
    - Por exemplo: você adiciona um novo rótulo de sensibilidade chamado "Confidencial".
- **Reverter um rótulo integrado para seu nome, descrição e visibilidade padrão**
    - Por exemplo: você alterou anteriormente o nome do aviso de qualidade "Dados obsoletos" para "Desatualizado" e deseja revertê-lo para seu nome padrão.
- **Criar categorias personalizadas**
    - Por exemplo: você cria uma nova categoria de etiqueta chamada “Departamento” com a intenção de adicionar rótulos para diferentes unidades de negócios.
- **Criar novos rótulos em categorias personalizadas**
    - Por exemplo: você cria novos rótulos "Vendas", "Serviços" e "Operações" para a categoria "Departamento" recém-criada.

## Propriedades de rótulos de dados

Um rótulo tem um nome, uma categoria e uma descrição. Rótulos com categoria de Aviso de Qualidade ou Sensibilidade também possuem um nível de visibilidade.

### Nome

O nome do rótulo é o nome comum do rótulo conforme aparece em vários lugares. Por exemplo, aqui o nome do rótulo “Obsoleto” é selecionado na guia Aviso de qualidade da caixa de diálogo Rótulos de dados.

![Nome do rótulo na caixa de diálogo Aviso de qualidade de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_value_name.png)

Aqui o nome do rótulo “Aviso” aparece no superior da página da tabela “Batters” e novamente nos detalhes do rótulo.

![Nome do rótulo no topo da página da tabela](/tableau/current/pt-br/server/pt-br/Img/dm_label_value_name_on_sticker.png)

### Categoria

A categoria do rótulo afeta onde e como o rótulo aparece, se ele aparece em ativos que são downstream naquele ao qual está anexado, e quais partes são personalizáveis etc. Por exemplo, avisos de qualidade e rótulos de sensibilidade aparecem em ativos downstream, mas outros rótulos com outras categorias não. Outro exemplo: você pode alterar a descrição de um selo de certificação, mas não o nome.

As categorias integradas são certificação, aviso de qualidade e sensibilidade.

Para categorias personalizadas, os usuários veem o nome da categoria nas guias de categoria vertical da caixa de diálogo Rótulos de dados, entre outros locais. Por exemplo, aqui o nome da categoria “Departamento” aparece nas guias verticais da categoria, no topo da lista de nomes de rótulos e em outros lugares.

![Seleção de categoria na caixa de diálogo Mais rótulos de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_category_in_data_labels_dialog_248.png)

### Descrição

A descrição do rótulo aparece em vários lugares, inclusive na caixa de diálogo Rótulos de dados, e ajuda o usuário a entender para que serve o rótulo. Por exemplo, a descrição do rótulo deste aviso de qualidade diz “Este ativo não é mais mantido e não deve ser usado”.

![Descrição do rótulo na caixa de diálogo Aviso de qualidade de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_value_description.png)

### Visibilidade

A visibilidade de um rótulo determina sua aparência. Rótulos de alta visibilidade aparecem em mais lugares e podem parecer mais urgentes para o usuário. Você só pode definir o nível de visibilidade nos rótulos de Aviso de qualidade ou Sensibilidade. Além disso, se um rótulo tiver uma categoria de Aviso de qualidade, os usuários com permissões poderão substituir a visibilidade padrão em cada ativo ao qual anexarem um rótulo de Aviso de qualidade. Para obter mais informações, consulte os tópicos [Definir um aviso de qualidade de dados](https://help.tableau.com/current/server/pt-br/dm_dqw.htm#high_visibility) e [Rótulos de sensibilidade](https://help.tableau.com/current/server/pt-br/dm_labels_sensitivity.htm#visibility).

## Criar um rótulo de dados

Para criar um rótulo:

1. Na página Rótulos de dados, selecione Novo rótulo.
2. Selecione uma categoria no menu suspenso Rótulo de categoria.
3. Insira o nome do rótulo no campo Valor do rótulo.
4. Insira uma descrição do rótulo no campo Descrição do rótulo. Você pode formatar o texto com negrito, sublinhado e itálico e incluir um link ou uma imagem. Para ver dicas de formatação de texto, focalize no ícone de informações (i) acima do botão Salvar.
5. Se o rótulo tiver uma categoria de Aviso de qualidade ou sensibilidade, defina o nível de visibilidade. Para obter mais informações, consulte [Visibilidade](#Visibility).
6. Selecione Salvar.

![Caixa de diálogo Novo rótulo](/tableau/current/pt-br/server/pt-br/Img/dm_label_manager_new_label_248.png)

### Limitações para criação de rótulos

- Não é possível criar um rótulo na categoria de certificação. A categoria de certificação permite apenas o rótulo único e integrado.
- Não é possível criar novos avisos de monitoramento. No entanto, os avisos de falha na atualização da extração e de falha na execução do fluxo podem ser editados de maneiras limitadas, conforme descrito na seção “Editar um rótulo”.
- O comprimento máximo para um nome de rótulo é de 128 caracteres no Tableau Cloud e no Tableau Server 2024.2 e posterior. O comprimento máximo para um nome de rótulo é de 24 caracteres no Tableau Server 2023.3 e anterior.
- O comprimento máximo para uma descrição de rótulo é de 500 caracteres.

## Editar um rótulo de dados

Para editar um rótulo existente:

1. Na página Rótulos de dados, selecione o menu Ações (...) na linha do rótulo. Ou selecione a linha usando sua caixa de seleção à esquerda e clique no menu suspenso Ações na parte superior da lista de rótulos.
2. Selecione Editar.
3. (Opcional) Altere o nome do rótulo usando o campo Valor do rótulo.
4. (Opcional) Altere a descrição do rótulo usando o campo Descrição do rótulo.
5. (Opcional) Se o rótulo tiver uma categoria de Aviso de qualidade ou Sensibilidade, defina o nível de visibilidade. Para obter mais informações, consulte [Visibilidade](#Visibility).
6. Selecione Salvar.

### Limitações para edição de rótulos

- Não é possível alterar a categoria de um rótulo existente.
- O comprimento máximo para um nome de rótulo é de 128 caracteres no Tableau Cloud e no Tableau Server 2024.2 e posterior. O comprimento máximo para um nome de rótulo é de 24 caracteres no Tableau Server 2023.3 e anterior.
- O comprimento máximo para uma descrição de rótulo é de 500 caracteres.

As diferentes categorias de rótulos permitem diferentes graus de edição de rótulos. A tabela a seguir lista as propriedades editáveis dos rótulos com as categorias fornecidas:

<table class="table--plain"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td><p><strong>Categorias do rótulo</strong></p></td><td><p><strong>Pode editar a categoria do rótulo</strong></p></td><td><p><strong>Pode editar nomes de rótulos</strong></p></td><td><p><strong>Pode editar descrições de rótulos</strong></p></td><td><p><strong>Pode editar a visibilidade do rótulo</strong></p></td></tr><tr><td><p>Certificação</p></td><td><p>Não</p></td><td><p>Não</p></td><td><p>Sim</p></td><td><p>N/A</p></td></tr><tr><td><p>Aviso de qualidade</p></td><td><p>Não</p></td><td><p>Sim<sup>1</sup></p></td><td><p>Sim</p></td><td><p>Sim<sup>2</sup></p></td></tr><tr><td><p>Sensibilidade</p></td><td><p>Não</p></td><td><p>Sim</p></td><td><p>Sim</p></td><td><p>Sim</p></td></tr><tr><td><p>Personalizar</p></td><td><p>Não</p></td><td><p>Sim</p></td><td><p>Sim</p></td><td><p>N/A</p></td></tr></tbody></table>

1 _Não é possível editar o nome do rótulo (valor do rótulo) dos avisos de atualização de extração ou de monitoramento de execução de fluxo._  
2 _O nível de visibilidade definido para avisos de qualidade é a visibilidade padrão. Os usuários com permissão podem substituir a visibilidade padrão ao anexar um aviso de qualidade a um ativo. Para obter mais informações, consulte_ [Visibilidade](#Visibility)_._

## Excluir um rótulo de dados

Para excluir um rótulo existente:

1. Na página Rótulos de dados, selecione o menu Ações (...) na linha do rótulo. Ou selecione a linha usando sua caixa de seleção à esquerda e clique no menu suspenso Ações na parte superior da lista de rótulos.
2. Selecione Excluir.

### Limitações para exclusão de rótulos

- Você não pode excluir um rótulo integrado. Os rótulos integrados são os rótulos padrão em Tableau Server.

## Reverter um rótulo de dados integrado aos seus padrões

Se um administrador editou anteriormente um rótulo integrado, o menu Ações para esse rótulo contém Reverter para o rótulo padrão. Reverter um rótulo para seus padrões retorna o nome (valor), a descrição e a visibilidade do rótulo para seus padrões integrados.

![Revertendo um rótulo integrado para seus padrões](/tableau/current/pt-br/server/pt-br/Img/dm_label_manager_revert_built-in_label_246.png)

## Criar uma categoria de rótulo de dados

Para criar uma categoria de rótulo:

1. Na página Rótulos de dados, selecione Novo rótulo.
2. Na caixa de diálogo Novo rótulo, selecione Nova categoria.
3. Digite o nome da categoria no campo Nome da Categoria.
4. Insira uma descrição da categoria no campo Descrição do rótulo. Você pode formatar o texto com negrito, sublinhado e itálico e incluir um link ou uma imagem. Para ver dicas de formatação de texto, focalize no ícone de informações (i) acima do botão Salvar.
5. Selecione Salvar.

![Caixa de diálogo Adicionar nova categoria](/tableau/current/pt-br/server/pt-br/Img/dm_label_manager_new_category_248.png)

### Limitações para a criação de categorias de rótulos

- O comprimento máximo para um nome de categoria é de 128 caracteres no Tableau Cloud e no Tableau Server 2024.2 e posterior. O comprimento máximo para um nome de categoria é de 24 caracteres no Tableau Server 2023.3 e anterior.
- O comprimento máximo para uma descrição de categoria é de 500 caracteres.

## Editar uma categoria de rótulo de dados

Para editar uma categoria de rótulo:

1. Na página Rótulos de dados, selecione a categoria do rótulo e selecione o ícone de lápis. Ou nas caixas de diálogo Novo rótulo ou Editar rótulo, selecione a categoria no menu suspenso Categoria de etiqueta e selecione o ícone de lápis ao lado de Descrição da categoria.
2. (Opcional) Altere o nome da categoria usando o campo Nome da categoria.
3. (Opcional) Altere a descrição da categoria usando o campo Descrição da categoria.
4. Selecione Salvar.

### Limitações para edição de categorias de rótulos

- Você não pode editar uma categoria integrada.
- O comprimento máximo para um nome de categoria é de 128 caracteres no Tableau Cloud e no Tableau Server 2024.2 e posterior. O comprimento máximo para um nome de categoria é de 24 caracteres no Tableau Server 2023.3 e anterior.
- O comprimento máximo para uma descrição de categoria é de 500 caracteres.

## Excluir uma categoria de rótulo de dados

Atualmente, não há um método para excluir uma categoria de rótulo por meio da interface Tableau Server regular. Para excluir uma categoria usando a API REST, consulte o [Método Excluir categoria de rótulo](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_metadata.htm#delete_label_category) na Referência da API REST.

## Cenários para personalização

### Cenário: personalizar um rótulo de dados integrado

Suponha que você decida que o aviso de qualidade de dados denominado "Aviso" pode ser mais específico. Como administrador, você altera o nome do rótulo do padrão ("Aviso") para algo que considera mais útil para sua organização: "Não aprovado". O nome do rótulo "Não aprovado" agora aparece nas caixas diálogo do rótulo quando os usuários estão selecionando rótulos.

Como alternativa, você pode alterar a descrição do rótulo para que o usuário aprenda mais sobre o aviso na caixa de diálogo do rótulo. Por exemplo: "Este ativo não atende aos padrões de qualidade exigidos pelo departamento de marketing."

### Cenário: criar um rótulo de dados personalizado

Suponha que você queira que os usuários tenham um controle mais granular sobre a classificação da sensibilidade dos ativos. Você cria dois rótulos de sensibilidade com os nomes “Público” e “PII”. Os nomes de valor de rótulo personalizado "Público" e "PII" agora aparecem nos menus suspensos e nas descrições, juntamente com o rótulo de sensibilidade integrado.

### Cenário: criar uma nova categoria de rótulo de dados e rótulos de dados associados

Suponha que você precise identificar as unidades de negócios responsáveis pelos ativos. Você cria uma categoria de rótulo chamada “Departamento”. Em seguida, você cria três rótulos – “Vendas”, “Serviço” e “Operações” – com “Departamento” como categoria. A categoria "Departamento" e os três rótulos associados agora aparecem na caixa de diálogo Mais rótulos de dados para os usuários anexarem aos ativos.

<!-- document id=b509c4d32b0d86d0921258c7d2b4b3dee40c59bfdc02582ab93984e2ee0f2048 url=/tableau/current/pt-br/server/security_secret_storage.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar segredos do servidor

O Tableau Server precisa armazenar vários segredos que usa para realizar inúmeras funções, normalmente a proteção da comunicação interna, a comunicação com outros aplicativos ou o sistema operacional, bem como a comunicação segura com os clientes. Neste contexto, o termo _segredo_ pode se referir a uma senha, a uma chave de segurança ou outra cadeia de caracteres usada para autenticar uma entidade a outra.

Há duas categorias de segredos necessárias para executar o Tableau Server. Elas diferem de acordo com o modo de geração dos segredos:

- **Segredos gerados por administradores**. Incluem as credenciais e segredos associados à conta de usuário Run As e às credenciais SMTP usadas pelo Tableau Server.
- **Segredos automaticamente gerados por vários processos no sistema**. Por exemplo, um segredo necessário para proteger a comunicação entre o Controlador de cluster e os processos do ZooKeeper. Além disso, várias senhas diferentes são necessárias para cada usuário de serviço e programático que se comunica com o Postgres.

A maioria dos segredos é criptografada enquanto em repouso. Quando um segredo for necessário, ele será descriptografado no tempo de execução.

Este tópico descreve como funciona o armazenamento de segredos e o que é necessário para gerenciar corretamente o armazenamento de segredos no Tableau Server.

## Compreensão de como funciona o armazenamento de segredos

Durante a instalação, o Tableau Server gera e armazena uma chave mestra no repositório de chaves do Java. A chave mestra é usada para criptografar uma chave de criptografia de configuração usada em todo o sistema.

Sempre que um novo segredo é criado ou atualizado, o segredo é criptografado com a chave de criptografia de configuração. O valor criptografado é, em seguida, armazenado com o seu parâmetro de configuração correspondente em um arquivo YAML no servidor. Os parâmetros com um valor criptografado usam o formato, `ENC(<encrypted string>)`, em que `<encrypted string>` é uma cadeia de caracteres criptografada com codificação Base64.

No tempo de execução, quando um determinado segredo precisa ser acessado, os valores criptografados são lidos na memória e descriptografados com a chave de criptografia de configuração.

No caso de alterações pendentes, em que os segredos são inseridos durante uma alteração de configuração, toda a transação é criptografada. Nesse cenário, após inserir um segredo e salvar a alteração pendente, ele será transmitido ao Serviço de coordenação (por meio de SSL criptografado). O Serviço de coordenação criptografa o segredo e o armazena até que as alterações pendentes sejam aplicadas. Quando as alterações são aplicadas, o segredo (ainda criptografado) é promovido à versão de configuração atual.

O Tableau Server criptografa segredos com o AES de 256 bits no modo GCM. As chaves usadas para armazenamento seguro são diferentes das chave de recurso usadas para criptografar as credenciais de banco de dados inseridas antes que sejam armazenadas no repositório.

### Quem tem acesso à chave mestra?

Em uma instalação padrão, o armazenamento de chave do Java para o Tableau Server está instalado na pasta `\ProgramData\Tableau\Tableau Server\data\tabsvc\crypto\keystores\`. Se você instalar o Tableau em uma unidade que não seja do sistema, o caminho será `<install drive>:\Tableau\Tableau Server\data\tabsvc\crypto\keystores\`. Por padrão, as contas a seguir têm acesso a esse diretório:

- Conta de usuário Run As (se configurada)
- Conta do Windows local predefinida no NetworkService
- Conta do Windows local predefinida no LocalSystem
- Membros do grupo Administradores do computador

### Importar e exportar informações de configuração

O Tableau Services Manager apresenta o recurso para importar e exportar informações de configuração por meio do [tsm settings export](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm#TSMExport).

**Observação**: esta versão do Tableau Server não suporta a restauração das informações de configuração a partir de um backup. Em vez disso, é recomendável usar os comandos de configuração de exportação e importação para fazer backup das informações de configuração e restaurá-las.

Embora os segredos de configuração sejam criptografados quando armazenados em disco internamente, ao exportar a configuração para um arquivo, os segredos são gravados no arquivo em texto simples. O administrador é responsável pela proteção desse arquivo. Há várias opções disponíveis:

- Gravar o arquivo em um sistema de arquivos criptografado.
- Gravar o arquivo em um diretório restrito a grupos ou usuários específicos por permissões do sistema de arquivos.
- Codifique o arquivo de saída.

### Proteção de segredos para operações de importação e exportação

Use um toolset de terceiros, como o OpenSSL, para codificar a saída do backup.

### Nós do cluster

Ao adicionar um novo nó ao cluster do Tableau Server, primeiro é necessário gerar o arquivo de configuração do nó ([tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#topology-get-bootstrap-file)). O arquivo de configuração de nó contém uma cópia do arquivo principal do repositório de chaves, usado para criptografar os segredos da configuração.

**Importante**: é altamente recomendável tomar medidas adicionais para proteger o arquivo de configuração de nó ao exportar um arquivo de configuração com segredos.

Ao [instalar e configurar o Tableau Server no novo nó](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm), será necessário fornecer o arquivo de configuração do nó para o comando `initialize-tsm`.

### Registro de evento de armazenamento de segredos

Os eventos a seguir relacionados ao armazenamento de segredos são registrados:

- Geração de novas chaves de criptografia
- A chave de criptografia é movida ou alterada
- Criptografia de um novo valor no arquivo de configuração

Para obter mais informações sobre os arquivos de registro e o local em que são armazenados, consulte [Trabalhar com arquivos de log](https://help.tableau.com/current/server/pt-br/logs_working_with.htm).

## Gerenciar segredos

Como administrador do Tableau Server, a tarefa mais importante relacionada ao armazenamento de segredos é atualizá-los periodicamente. Em alguns casos (solução de problemas ou auditoria de servidor), pode ser necessário recuperar uma senha.

Para outras operações, como atualização de versões, backup e restauração, ou adição de novos nós a um cluster, conforme observado acima, o Tableau Server gerencia o armazenamento de segredos e os processos relacionados automaticamente.

### Atualizar segredos

É aconselhável atualizar os segredos periodicamente de acordo com a política de segurança da sua empresa.

Para atualizar a chave mestra e gerar segredos automaticamente, execute o [tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#regenerate-tokens).

### Recuperar senhas

Em alguns casos, será necessário recuperar uma senha para solução de problemas ou outras operações. Por exemplo, pode-se precisar das credenciais do usuário Postgres somente leitura geradas e criptografadas pelo Tableau Server. Nesses casos, é possível usar um comando tsm que recuperará e descriptografará a senha.

Para recuperar uma senha, abra o prompt de comando e emita um comando `tsm configuration get` para um dos parâmetros listados na tabela abaixo.

Por exemplo, para recuperar uma senha para o usuário Postgres somente leitura, digite o comando a seguir:

`tsm configuration get -k pgsql.readonly_password`

O comando retornará a senha em texto simples:

`$ tsm configuration get -k pgsql.readonly_password`

`password`

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><th>Configuration Parameter</th><th>Description</th></tr><tr><td>clustercontroller.zookeeper.password</td><td>Password for cluster controller to connect to zookeeper.</td></tr><tr><td>indexandsearchserver.client.password             
						

					</td><td>Password for logging into Index and Search Server. 

					</td></tr><tr><td>indexandsearchserver.ssl.admin.cert.bytes             
					</td><td>Admin certificate that is used for administrative access to the Index and Search Server. The admin certificate is used to generate the node certificate. 

					</td></tr><tr><td>indexandsearchserver.ssl.admin.key.file_bytes 
					</td><td>Certificate key for administrative access to the Index and Search Server. 

					</td></tr><tr><td>indexandsearchserver.ssl.node.cert.bytes </td><td>Certificate that is used for Index and Search Server node-to-node communication.

					</td></tr><tr><td>            
						indexandsearchserver.ssl.node.key.file_bytes             
					</td><td>Certificate key that is used for Index and Search Server node-to-node communication.</td></tr><tr><td>indexandsearchserver.ssl.root.cert.bytes             
					</td><td>Certificate that is used to sign the admin and node certificates . This certificate is used by TSM&nbsp;for health check and by NLP&nbsp;to connect to Index and Search Server. 

					</td></tr><tr><td>indexandsearchserver.ssl.root.key.file_bytes </td><td>Certificate key for root certificate.

					</td></tr><tr><td>filestore.zookeeper.password</td><td>Password for filestore to connect to zookeeper.</td></tr><tr><td>hyper.connection.init_password 

					</td><td>Password used to initialize the Hyper database for user <code>tableau_internal_user</code> and is then used for connecting to Hyper.

					</td></tr><tr><td>jdbc.password</td><td>Password for the rails Postgres user.</td></tr><tr><td>kms.persistent_store 

					</td><td>A collection of master encryption keys (MEKs) used by the Key Management System.

					</td></tr><tr><td>maestro.rserve.password             
						</td><td>Password for connecting to an external Rserve instance used by Tableau Prep Conductor for running flows that have nodes with R scripts. 

					</td></tr><tr><td>maestro.tabpy.password</td><td>Password for connecting to an external TabPy (Python server) instance used by Tableau Prep Conductor for running flows that have nodes with Python scripts. 

					</td></tr><tr><td>oauth.google.client_secret</td><td>Client secret of the Google Cloud Platform account. </td></tr><tr><td>oauth.quickbooks.consumer_secret</td><td>Consumer secret of the Intuit developer account. </td></tr><tr><td>oauth.salesforce.client_secret</td><td>Client secret of the Salesforce developer account. </td></tr><tr><td>pgsql.adminpassword</td><td><p>Senha para o usuário do Postgres tblwgadmin.</p><p class="note"><b>Observação</b>: embora o parâmetro de configuração esteja criptografado nos arquivos de configuração do Tableau (tabsvc.yml, workgroup.yml), esta senha é armazenada em texto simples nos arquivos usados pelo SAML.</p></td></tr><tr><td>pgsql.readonly_password</td><td>Password for the readonly Postgres user.</td></tr><tr><td>pgsql.remote_password</td><td>Password for the tableau Postgres user.</td></tr><tr><td>redis.password </td><td><p>Senha para o Redis.</p><p class="note"><b>Observação</b>: embora o parâmetro de configuração esteja criptografado nos arquivos de configuração do Tableau (tabsvc.yml, workgroup.yml), a configuração ainda seria em texto simples no arquivo redis.conf consumido pelo aplicativo Redis. O Redis não dá aceita senhas criptografadas/protegidas.</p></td></tr><tr><td>servercrashupload.proxy_server_password</td><td>Password for custom proxy server used to upload crash reports.</td></tr><tr><td>service.runas.password</td><td>Password of the Run As users. Stored temporarily.</td></tr><tr><td>ssl.cert.file_bytes             
					</td><td>The content of one of the three SSL certificate files uploaded by the administrator. The certificate files are required to enable secure external connections to Tableau Server. </td></tr><tr><td>ssl.chain.file_bytes 
					</td><td>The chain file(s) for the certificates uploaded by the administrator for external SSL.</td></tr><tr><td>ssl.key.file_bytes</td><td>Key file(s) for the certificates uploaded by the administrator for external SSL.</td></tr><tr><td>ssl.key.passphrase</td><td>Optional passphrase used to protect the external SSL key.</td></tr><tr><td>svcmonitor.notification.smtp.password</td><td>SMTP Server password supplied by the administrator through TabConfig.exe.</td></tr><tr><td>tabadminservice.password</td><td>Password for the service that allows server admins to download log files through the web interface.</td></tr><tr><td>vizportal.openid.client_secret</td><td>This is the password ("provider client secret") used for  OpenID Connect SSO.</td></tr><tr><td>
                        vizqlserver.external_proxy_password
                    </td><td>Password used to authenticate to an external proxy.</td></tr><tr><td>wgserver.domain.password</td><td>Password used to bind to Active Directory. </td></tr><tr><td>wgserver.saml.key.passphrase</td><td>Passphrase used to access the PKCS#8 SAML key file.</td></tr><tr><td>zookeeper.tsm.password</td><td>Password that TSM&nbsp;uses to connect to Zookeeper coordination service</td></tr></tbody></table>

<!-- document id=d43a939c315f4e92d6db9596713be30b6964f968c272269808f7aac9e79653e5 url=/tableau/current/pt-br/server/manage_server.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar servidor

Após instalar o Tableau Server, é possível personalizar e gerenciar seu servidor. Por exemplo, você pode gerenciar segurança, licenças, sites, assinaturas e alertas orientados por dados e muito mais.

## Outros artigos nesta seção

<!-- document id=588b4ed4a30d4f9d77535de6fb48fd0c9f4e4cb309023b608308904cddbc681c url=/tableau/current/pt-br/server/sites_toc.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar sites em um servidor

Você pode planejar e gerenciar seus sites no Tableau Server. Gerencie usuários e grupos dos seus sites, gerencie projetos e acesse conteúdo, gerencie dados e crie e interaja com modos de exibição na Web.

## Outros artigos nesta seção

<!-- document id=503e64f56d2edd6a318eb803516e880d8c3ffe42acb18ad8c039196e4c6121c1 url=/tableau/current/pt-br/server/manage_site.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar sites individuais

Além de planejar os sites no Tableau, você pode gerenciar usuários, grupos e projetos e controlar o acesso ao conteúdo, gerenciar os dados do site e interagir com modos de exibição na Web.

## Outros artigos nesta seção

<!-- document id=8ffb3044270b8e3501fa71b76588df687fcd2afcf8c127fdfa3a24cca772f740 url=/tableau/current/pt-br/server/task.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar tarefas

Os administradores podem alterar a prioridade das atualizações de extração agendadas relacionadas a outras tarefas do servidor, atualizar manualmente as extrações ou excluir as agendas. Eles também podem alterar a prioridade para agendas de fluxo.

## Gerenciar tarefas de atualização

1. Entre no site que tem as agendas que deseja gerenciar e clique em Tarefas.
2. Selecione uma ou mais atualizações de extração agendadas.
3. No menu Ações, faça o seguinte:
    
    - Selecione Alterar agenda e escolha uma nova agenda na lista.
    - Selecione Executar agora para atualizar manualmente.
        
        **Observação:** caso uma extração não tenha uma atualização agendada, você poderá atualizá-la sob demanda na página Conexões de dados.
    - Selecione Alterar prioridade e insira um número entre 1 e 100 para mover a extração para cima ou para baixo na lista de prioridade.
        
        ![Uma caixa de diálogo para alterar a prioridade de atualização de um extrato selecionado.](/tableau/current/pt-br/server/pt-br/Img/sched5.png)
    - Selecione Excluir para remover totalmente o agendamento das fontes de dados selecionadas.

## Gerenciar tarefas de fluxo

Os administradores podem alterar a frequência de uma agenda de fluxo, alterar a prioridade, bem como editar uma agenda para um fluxo ou executar manualmente o fluxo, tudo na página Tarefas.

1. Entre no site que tem as agendas que deseja gerenciar e clique em Tarefas.
2. Na guia Fluxo, selecione um ou mais fluxos que deseja gerenciar.
3. No menu Ações, faça o seguinte:
    
    - Selecione Executar agora para executar os fluxos manualmente.
    - Selecione Editar tarefa para editar a tarefa de fluxo.
    - Selecione Alterar agenda, escolha uma nova agenda na lista e selecione Alterar frequência.
    - Selecione Alterar prioridade e insira um número entre 1 e 100 para mover o fluxo para cima ou para baixo na lista de prioridade.
        
        ![Caixa de diálogo Prioridade de mudanças.](/tableau/current/pt-br/server/pt-br/Img/prep_schedule_tasks_change_priority.png)
    - Selecione Excluir para remover totalmente o agendamento dos fluxos selecionados.

## Consulte também

[Habilitar o agendamento da atualização de extração e a notificação de falha](https://help.tableau.com/current/server/pt-br/schedule_enable.htm)

<!-- document id=599b6fb6acbcfb500d745f9df60c565cbbb5c02e8dffb47c47b69383b5664ac4 url=/tableau/current/pt-br/server/server_backgrounder_job_management.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar trabalhos do Processador em segundo plano no Tableau Server

No Tableau Server, os usuários podem agendar atualizações de extração, assinaturas ou fluxos para serem executados periodicamente. Esses itens agendados são chamados de **Tarefas**. O processo do Processador em segundo plano inicia instâncias exclusivas dessas tarefas para executá-las no horário agendado. As instâncias exclusivas das tarefas iniciadas como resultado são chamadas de **Trabalhos**. Os trabalhos também são criados para execuções iniciadas manualmente, clicando na opção **Executar agora** na interface da Web, programaticamente por meio da API REST ou dos comandos tabcmd.

Por exemplo, uma tarefa de atualização de extração é criada para ser executada diariamente às 9:00. Essa é uma tarefa de atualização de extração e, todos os dias às 9:00, um trabalho será criado para o Processador em segundo plano executar. Além dos trabalhos gerados pelo usuário, o Processador em segundo plano também faz uma série de trabalhos do Sistema em nome do usuário, a fim de dar suporte aos fluxos de trabalho gerais do Tableau, como a geração de miniatura.

A execução de todos esses trabalhos pode significar que o Processador em segundo plano usa muitos recursos várias vezes ao dia. Usando o recurso Gerenciamento de trabalhos, os administradores de servidor e site podem obter mais detalhes sobre esses trabalhos que ocorrem em seu Servidor ou Site e tomar medidas a respeito desses trabalhos, a fim de gerenciar melhor o uso de recursos do servidor. Os trabalhos do sistema só podem ser exibidos pelos Administradores do servidor e são filtrados por padrão.

As configurações **Executar agora** na página de configurações **Geral** também possibilitam o gerenciamento dos recursos, permitindo ou impedindo que os usuários executem os trabalhos manualmente. Por padrão, essa opção é selecionada para permitir que os usuários executem os trabalhos manualmente. Limpe a caixa de seleção para evitar que os usuários executem os trabalhos manualmente. Para saber mais sobre o gerenciamento de recursos do Processador em segundo plano, consulte [Processos do Processador em segundo plano do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_backgrounder.htm)

A página Trabalhos que contém as informações sobre os trabalhos pode ser acessada, navegando até o menu **Tarefas existentes** do menu de navegação esquerdo.

**Observação:** as informações sobre os trabalhos só podem ser visualizadas pelos administradores do Servidor e site.

## Visão geral

Este tópico descreve como exibir e entender as informações exibidas na página Trabalhos.

Na parte superior da página, há estatísticas de alto nível para o número de trabalhos com **Falha**, **Concluídos** e **Cancelados** nas últimas 24 horas. Para Administradores do servidor, isso também inclui os Trabalhos do sistema. A aplicação de filtros não altera esses valores.

![Marque a caixa de seleção Mostrar trabalhos do sistema nas opções de filtro de trabalhos.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_management.png)

Para cada trabalho gerado, há uma ID de trabalho, o status desse trabalho, a prioridade, o tipo de tarefa de que o trabalho foi gerado, o tempo de execução atual (se o trabalho estiver em andamento, o tempo da fila atual), bem como o tempo médio de execução e em fila.

O Tableau registra tempos de execução históricos e os tempos em fila para calcular o tempo médio de execução e o tempo médio na fila. Os tempos médios de execução e os tempos médios de fila são calculados como médias ponderadas usando a seguinte fórmula: (tempo de execução atual ou média de tempo de fila x 4) + tempo de execução ou tempo de fila mais recente)/ 5.

A ID de trabalho pode ser útil ao visualizar os trabalhos nas **Exibições administrativas** e também pode ser usada para consultar o Banco de [dados](https://tableau.github.io/tableau-data-dictionary/2019.4/data_dictionary.htm)dos grupos de trabalho. Ao clicar na ID de trabalho, você verá informações mais detalhadas sobre o trabalho, como a LUID de trabalho, o nome do projeto, a agenda, o nome do conteúdo, o proprietário do conteúdo, o criador do trabalho, e o nome do site. O nome do site é exibido se você navegar até a página Trabalhos, usando o menu **Gerenciar todos os sites**.

![Os detalhes do trabalho 617 incluem uma ID exclusiva, nome do projeto, cronograma, conteúdo, proprietário, criador e data da última execução bem-sucedida.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_details.png)

**Observação:** clicar em **Atualizar agora** na página **Fontes de dados** mostrará apenas as informações de LUID na caixa de diálogo **Detalhes do trabalho.**

> [!IMPORTANT]
> 
> **Importante:** os trabalhos que existiam 24 horas ou menos antes de uma atualização para o Tableau Server 2019.4 não terão dados para o **Tempo médio em fila**, **Tempo médio de execução**, **Último tempo de execução bem-sucedida** e **Criador de trabalhos** na página **Trabalhos**.

### Tipos de tarefa

Existem vários tipos de tarefas:

- Extrações: isso inclui a criação de extração, as atualizações de extração incrementais e as atualizações de extração completas. Para obter mais informações sobre atualizações de extração, consulte [Início rápido: atualizar extrações em cronograma](https://help.tableau.com/current/server/pt-br/qs_refresh_extracts.htm)
- Assinaturas: inclui assinaturas para pastas de trabalho e exibições. Para obter mais informações, consulte [Configurar um site para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm).
- Fluxo: inclui fluxos agendados e manuais. Confira [Capacidade de tempo de execução do trabalho](https://help.tableau.com/current/online/pt-br/to_site_capacity.htm) para obter informações sobre o tempo máximo de execução para fluxos e [Capacidade de trabalhos simultâneos](https://help.tableau.com/current/online/pt-br/to_site_capacity.htm) para limites de capacidade ao executar trabalhos de fluxo simultâneos. Agendar mais fluxos do que o número de blocos de recursos que você possui pode resultar em erro. Consulte o artigo da Base de dados de conhecimento [Trabalho de fluxo pendente](https://kb.tableau.com/articles/Issue/flow-job-pending-with-cannot-run-because-your-site-has-reached-its-concurrency-limit-for-extract-refreshes?lang=pt-br) para obter mais informações.
    
    A partir da versão 2025.2, a caixa de diálogo Detalhes do trabalho mostrará um link para o fluxo Tableau Prep. Navegue rapidamente até a página do Local do fluxo para obter mais detalhes sobre o fluxo. Se o fluxo foi excluído, o link não será exibido.
    
    ![Caixa de diálogo Detalhes do trabalho mostrando um link para o fluxo Tableau Prep](/tableau/current/pt-br/server/pt-br/Img/prep_jobs_flow_link.png)
- Criptografia: inclui o seguinte:
    
    - Extrair criptografia e descriptografia
    - Criptografia e descriptografia de fluxo
    - Rechaveamento de extrações e fluxos
- Sistema: inclui todos os Trabalhos do sistema que o Processador em segundo plano controla nos bastidores para oferecer suporte ao Tableau Server.

### Filtros

É possível filtrar para ver apenas determinados trabalhos. Os filtros disponíveis são por tipo de Status do trabalho, Tipo de tarefa e Intervalo de tempo. Para o filtro Intervalo de tempo, você pode escolher entre 1 e 24 horas, em incrementos de quatro horas. A opção de filtrar em Trabalhos do sistema está disponível se você for um Administrador do servidor.

## Cancelamento de trabalhos

As atualizações de extração, assinaturas e trabalhos de execução de fluxo podem ser canceladas. Você pode cancelar apenas um trabalho de cada vez e não há suporte para a seleção de vários trabalhos de uma só vez para cancelamento.

Ao cancelar uma tarefa, um e-mail com o tempo que o trabalho foi cancelado, o conteúdo afetado e o tempo de execução do trabalho antes de ser cancelado será enviado para os destinatários selecionados na caixa de diálogo **Cancelar trabalho**. Além disso, você pode adicionar suas observações personalizadas a serem incluídas no e-mail.

Se você não selecionar nenhum destinatário, a tarefa será cancelada, mas nenhum e-mail será enviado.

Para cancelar um trabalho, clique nas elipses ao lado da ID de trabalho e use a caixa de diálogo para cancelar o trabalho:

![Botão Cancelar.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_cancel.png)

![Caixa de diálogo Cancelar tarefa com a caixa de seleção para enviar um e-mail aos administradores do site sobre tarefas canceladas destacada.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_cancel_dialog.png)

## Status

Há sete tipos de status em que os trabalhos podem estar e passar o mouse sobre cada status exibirá informações mais relevantes.

- **Concluído:** este trabalho aparece como **Concluído com êxito** e você pode ver a hora em que o trabalho foi concluído na dica de ferramenta exibida, ao passar o mouse sobre o status.
    
    ![Uma marca de seleção verde aparece ao lado da palavra “Concluído”.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_completed.png)
    
    ![Uma mensagem indica que um trabalho foi concluído com sucesso em 13 de junho de 2019, às 10h23.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_completed_tootip.png)
- **Em andamento:** este trabalho aparece como **Em Andamento**. O tempo pelo qual o trabalho está sendo executado é exibido na dica de ferramenta ao passar o mouse sobre o status.
    
    ![Ícone de Em andamento.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_inprogress.png)
    
    ![Uma dica de ferramenta mostrando o tempo de execução do trabalho em andamento.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_inprogress_tooltip.png)
- **Em andamento:** este trabalho está **Em andamento**, mas está **atrasado**. O Tableau rastreia os tempos médios de execução do mesmo trabalho e, se o tempo de execução atual for maior do que o tempo médio de execução, o trabalho será considerado atrasado. O tempo maior do que a média pelo qual o trabalho está sendo executado e o tempo médio de execução são fornecidos na dica de ferramenta exibida ao passar o mouse sobre o status.
    
    ![Ícone em andamento indicando um tempo de execução do trabalho maior do que as execuções anteriores.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_late.png)
    
    ![Uma dica de ferramenta mostrando o tempo de execução do trabalho em andamento que excede os tempos de execução anteriores.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_late_tooltip.png)
- **Pendente:** este trabalho está **Pendente** no momento, aguardando para ser executado quando houver capacidade disponível do Processador em segundo plano. O tempo pelo qual o trabalho está na fila é exibido na dica de ferramenta ao passar o mouse sobre o status.
    
    ![Ícone de Trabalho na fila.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_queued.png)
    
    ![Uma dica de ferramenta mostrando o tempo de fila em andamento.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_queued_tooltip.png)
- **Pendente:** o fluxo não pode ser executado porque o número de blocos de recursos é menor que o número de fluxos agendados, e o site atingiu seu limite de simultaneidade.
    
    ![Ícone de Trabalho na fila.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_queued.png)
    
    ![](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_pending_flow.png)
- **Pendente:** este trabalho está **Pendente** no momento, mas está **atrasado**. O Tableau rastreia os tempos médios de fila do mesmo trabalho e, se o tempo de fila atual for maior do que o tempo médio de fila, o trabalho será considerado atrasado. O tempo maior do que a média pelo qual o trabalho está na fila é fornecido na dica de ferramenta exibida ao passar o mouse sobre o status.
    
    ![Ícone de Tarefa na fila indicando um tempo de fila maior do que as execuções anteriores.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_queued_late.png)
    
    ![Uma dica de ferramenta mostrando o tempo de fila em andamento que excede os tempos de fila anteriores.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_queued_late_toolip.png)
- **Cancelado:** este trabalho foi **Cancelado** por um administrador do Servidor ou Site. A hora em que o trabalho foi cancelado e o tempo em que foi executado antes do cancelamento são fornecidos na dica de ferramenta ao passar o mouse sobre o status.
    
    ![Um ponto de exclamação amarelo e a palavra "Cancelado".](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_canceled.png)
    
    ![Uma mensagem indica que um trabalho foi cancelado em 11 de junho de 2019 às 21h55 após ser executado por 29,5 minutos.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_canceled_tooltip.png)
- **Falha:** este trabalho está sendo exibido como **Falha**. A hora em que o trabalho falhou, o tempo em que foi executado antes de falhar e o motivo pelo qual o trabalho falhou são fornecidos na dica de ferramenta ao passar o mouse sobre o status.
    
    ![Um ponto de exclamação vermelho ao lado da palavra “Falha”.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_failed.png)
    
    ![A mensagem indica que uma tarefa falhou em 11 de junho de 2019 às 4h23 após ser executada por 51,6 minutos devido a credenciais inválidas.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_failed_tooltip.png)
- **Suspenso:** esta tarefa está sendo exibida como **Falha** com um ícone de pausa. Se a tarefa falhar 5 vezes consecutivamente, ela será suspensa. As tarefas suspensas ainda estão disponíveis, mas o Processador em segundo plano não criará trabalhos para essas tarefas até que sejam retomadas pelo usuário.
    
    ![Ícone de Trabalho suspenso.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_suspended.png)
    
    ![Uma dica de ferramenta explicando que tarefas suspensas não podem ser executadas.](/tableau/current/pt-br/server/pt-br/Img/backgrounder_job_suspended_details.png)

<!-- document id=f2994d79c7a3415f834ef380a0bd17496ec623d061c9f9bede30afbf1823e346 url=/tableau/current/pt-br/server/prep_conductor_manage_flow.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar um fluxo

Após publicar um fluxo no Tableau Server ou no Tableau Cloud, você pode gerenciar seus fluxos e alterá-los conforme necessário. Este tópico descreve as várias ações que você pode adotar para gerenciar os fluxos.

**Observação**: o conteúdo neste tópico se aplica ao Tableau Server e ao Tableau Cloud, as exceções são denominadas especificamente.

## Gerenciamento de fluxos

**Esta é uma lista de ações que você pode adotar para gerenciar seus fluxos:**

- **Criar fluxos:** como Creator, a partir da versão 2020.4, você pode criar fluxos diretamente na Web. Na página Inicial, clique em Criar > Fluxo ou na página Explorar, clique em Novo > Fluxo. Para obter mais informações, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm).
- **Editar fluxos:** como Creator, a partir da versão 2020.4, você pode editar fluxos diretamente na Web. Navegue até a lista de fluxos, selecione Ações e clique em Editar fluxo, ou abra um fluxo e clique no botão Editar.
    
    Quando você edita um fluxo, suas alterações são colocadas em estado de rascunho. Quando terminar, publique o fluxo para confirmar suas alterações e criar uma nova versão do fluxo. Para obter mais informações, consulte [Salvamento automático e como trabalhar com rascunhos](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm#autosave).
    
    Você pode editar a conexão de dados usando a opção de menu Editar conexão da exibição Conexões, no menu Ações (…) para a fonte de dados. A nova conexão é salva e usada na próxima vez que o fluxo é executado no Tableau Prep Conductor. No entanto, quando você abre o fluxo para visualizá-lo, a conexão original persiste e não será atualizada até que você edite o fluxo, atualize o conector e o publique novamente.
    
    Se você abrir, editar e republicar o fluxo sem alterar a conexão original, quaisquer alterações de conexão feitas usando o menu Editar conexão serão sobrepostas e substituídas pela conexão original.
- **Carregar fluxos** (versão 2026.2.4 e posterior) Como Creator, você pode carregar um arquivo de fluxo no Tableau Cloud a partir das páginas Início ou Explorar, assim como nas pastas de trabalho do Tableau. As credenciais de incorporação não são aceitas no momento. Após o carregamento do fluxo, você pode editar a conexão ou editar o fluxo e republicá-lo com as credenciais inseridas.
    
    Se você carregar um fluxo que resulta em um servidor diferente, após carregá-lo, será necessário editar a saída para apontar para o projeto correto no novo servidor antes de executar o fluxo.
- **Executar fluxos:** como um Creator, você pode executar manualmente um fluxo, além de criar tarefas agendadas de fluxos que são executadas em um momento específico. O usuários com Explorer (podem publicar) também poderão executar fluxos se o Administrador do servidor conceder essa permissão.
- **Observação**: não é necessário usar o Data Management para executar fluxos manualmente, mas é necessário para agendar a execução de fluxos.
- Navegue até a lista de fluxos, selecione um ou mais fluxos que deseja executar, selecione Ações e clique em Executar agora.
- **Marcas:** marcas são palavras-chave que você pode criar para os fluxos que ajudam a localizar, filtrar e categorizar conteúdo. Os autores podem adicionar marcas nos fluxos ao publicá-los. No entanto, você também pode adicionar marcas a qualquer pasta de trabalho, exibição ou fonte de dados para qual tenha a permissão de acesso, além de poder excluir quaisquer marcas adicionadas. Você pode adicionar uma marca a uma lista de fluxos.
    
    Navegue até a lista de fluxos, selecione um ou mais itens que deseja marcar, selecione Ações e clique em Marcar. Para adicionar uma marca a um fluxo específico, é possível usar a lista de fluxos, conforme descrito acima. Na guia Visão geral, abra o Fluxo, selecione Ações e clique em Marcar.
- **Alterar proprietário:** administradores e proprietários de fluxos podem alterar os proprietários de qualquer Creator em seu site. Nas versões 2025.1 e anteriores, eles só podiam alterar o proprietário para eles mesmos. Para obter mais informações, consulte [Gerenciar propriedade de conteúdo](https://help.tableau.com/current/online/pt-br/owner.htm?).
- **Permissões:** você pode definir permissões para usuários e especificar se eles podem executar ações de edição, como salvar, baixar, mover para um projeto diferente e excluir. Além disso, é possível especificar quem pode exibir e executar o fluxo.
- **Baixar:** você pode baixar um fluxo para exibi-lo ou modificá-lo usando o Tableau Prep Builder. Para baixar um fluxo, você precisa de permissões para download. Por padrão, você terá essa permissão se for o proprietário, mas talvez precise adicioná-la para outros usuários.
- **Histórico de revisões:** quando você faz uma alteração no fluxo e publica-o novamente no mesmo projeto, com o mesmo nome, uma nova versão do fluxo é criada. O histórico de revisões pode ser exibido ao selecioná-lo no menu de ações. Os proprietários de fluxo têm permissões para restaurar uma versão anterior de um fluxo.
- **Mover:** você pode mover fluxos entre projetos. Para mover um fluxo, os usuários precisam da permissão para Mover. Por padrão, você terá essa permissão para os fluxos de sua propriedade, mas talvez seja necessário adicioná-la para outros usuários.
- **Renomear:** você pode renomear um fluxo. Para renomear um fluxo, os usuários precisam da permissão para Salvar. Por padrão, você terá essa permissão para os fluxos de sua propriedade, mas talvez seja necessário adicioná-la para outros usuários.
- **Excluir:** você pode excluir um fluxo. Para excluir um fluxo, os usuários precisam da permissão para Excluir. Por padrão, você terá essa permissão para os fluxos de sua propriedade, mas talvez seja necessário adicioná-la para outros usuários. A partir da versão 2025.3, você pode recuperar fluxos excluídos da Lixeira. Para obter mais informações, consulte [Recuperar fluxos excluídos](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#recover-deleted-flows).

### Quem pode fazer isso

Administrador do Tableau Server

**As tarefas a seguir podem ser executadas em todos os sites:**

- Criar fluxos
- Editar fluxos publicados
- Carregar fluxos
- Ver uma lista de todos os rascunhos de fluxos
- Executar fluxos
- Excluir fluxos
- Ativar e configurar a Lixeira
- Recuperar fluxos excluídos
- Baixar fluxos
- Alterar proprietário
- Alterar permissões
- Alterar projeto
- Adicionar/remover marcas
- Alterar descrição
- Alterar nome
- Atualizar a tarefa de fluxo
- Excluir a tarefa de fluxo
- Criar uma tarefa de fluxo\*
- Gerenciamento de versões\*

\*Algumas condições adicionais se aplicam a estas ações:

- Para criar uma tarefa de fluxo:
    
    - Uma agenda de fluxo deve estar disponível. No Tableau Server, somente os Administradores do servidor podem criar uma agenda. Além do Tableau Cloud, os usuários com permissões para agendar tarefas de fluxo podem criar uma agenda personalizada. Para obter mais informações, consulte [Agendar tarefa de fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm).
    - O fluxo deve ter pelo menos uma etapa de saída.
    - A versão do fluxo deve ser compatível com a versão do Tableau Server.
- Gerenciamento de versões:
    
    - O histórico de revisões deve estar habilitado no site.
    - A função do usuário tem permissão para publicar no projeto.

Administrador de site do Tableau

**As tarefas a seguir podem ser executadas nos fluxos publicados nos sites com a permissão de administrador de site para:**

- Criar fluxos
- Editar fluxos publicados
- Carregar fluxos
- Ver uma lista de todos os rascunhos de fluxos
- Executar fluxos
- Excluir fluxos
- Ativar e configurar a Lixeira
- Recuperar fluxos excluídos
- Baixar fluxos
- Alterar proprietário
- Alterar permissões
- Alterar projeto
- Adicionar/remover marcas
- Alterar descrição
- Alterar nome
- Atualizar a tarefa de fluxo
- Excluir a tarefa de fluxo
- Criar uma tarefa de fluxo\*
- Gerenciamento de versões\*

Algumas condições adicionais se aplicam a estas ações:

- Para criar uma tarefa de fluxo:
    
    - Uma agenda de fluxo deve estar disponível. No Tableau Server, somente os Administradores do servidor podem criar uma agenda. Além do Tableau Cloud, os usuários com permissões para agendar tarefas de fluxo podem criar uma agenda personalizada. Para obter mais informações, consulte [Agendar tarefa de fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm).
    - O fluxo deve ter pelo menos uma etapa de saída.
    - A versão do fluxo deve ser compatível com a versão do Tableau Server.
- Gerenciamento de versões:
    
    - O histórico de revisões deve estar habilitado no site.
    - A função do usuário tem permissão para publicar no projeto.

Líder do projeto

**As tarefas a seguir podem ser executadas nos fluxos publicados nos projetos com permissões de líder de projeto:**

- Criar fluxos
- Editar fluxos publicados
- Carregar fluxos
- Executar fluxos
- Excluir
- Baixar
- Alterar permissões
- Alterar projeto
- Adicionar/remover marcas
- Alterar descrição
- Alterar nome
- Atualizar a tarefa de fluxo
- Excluir a tarefa de fluxo
- Criar uma tarefa de fluxo\*
- Gerenciamento de versões\*

\*Algumas condições adicionais se aplicam a estas ações:

- Para criar uma tarefa de fluxo:
    
    - Uma agenda de fluxo deve estar disponível. No Tableau Server, somente os Administradores do servidor podem criar uma agenda. Além do Tableau Cloud, os usuários com permissões para agendar tarefas de fluxo podem criar uma agenda personalizada. Para obter mais informações, consulte [Agendar tarefa de fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm).
    - O fluxo deve ter pelo menos uma etapa de saída.
    - A versão do fluxo deve ser compatível com a versão do Tableau Server.
- Gerenciamento de versões:
    
    - O histórico de revisões deve estar habilitado no site.
    - A função do usuário tem permissão para publicar no projeto.

Proprietário do projeto

**As tarefas a seguir podem ser executadas nos fluxos publicados nos projetos de sua propriedade:**

- Criar fluxos
- Editar fluxos publicados
- Carregar fluxos
- Executar fluxos
- Excluir
- Baixar
- Alterar permissões
- Alterar projeto
- Adicionar/remover marcas
- Alterar descrição
- Alterar nome
- Atualizar a tarefa de fluxo
- Excluir a tarefa de fluxo
- Criar uma tarefa de fluxo\*
- Gerenciamento de versões\*

\* Algumas condições adicionais se aplicam a estas ações:

- Para criar uma tarefa de fluxo:
    
    - Uma agenda de fluxo deve estar disponível. No Tableau Server, somente os Administradores do servidor podem criar uma agenda. Além do Tableau Cloud, os usuários com permissões para agendar tarefas de fluxo podem criar uma agenda personalizada. Para obter mais informações, consulte [Agendar tarefa de fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm).
    - O fluxo deve ter pelo menos uma etapa de saída.
    - A versão do fluxo deve ser compatível com a versão do Tableau Server.
- Gerenciamento de versões:
    
    - O histórico de revisões deve estar habilitado no site.
    - A função do usuário tem permissão para publicar no projeto.

Proprietário do fluxo

**As tarefas a seguir podem ser executadas nos fluxos de sua propriedade:**

- Criar fluxos
- Editar rascunhos (fluxos que possuem) e fluxos publicados
- Carregar fluxos
- Executar fluxos
- Excluir fluxos
- Recuperar fluxos excluídos (com a Lixeira ativada pelo administrador)
- Baixar fluxos
- Alterar proprietário
- Alterar permissões
- Alterar projeto
- Adicionar/remover marcas
- Alterar descrição
- Alterar nome
- Atualizar a tarefa de fluxo
- Excluir a tarefa de fluxo
- Criar uma tarefa de fluxo\*
- Gerenciamento de versões\*

\*Algumas condições adicionais se aplicam a estas ações:

- Para criar uma tarefa de fluxo:
    
    - Uma agenda de fluxo deve estar disponível. No Tableau Server, somente os Administradores do servidor podem criar uma agenda. Além do Tableau Cloud, os usuários com permissões para agendar tarefas de fluxo podem criar uma agenda personalizada. Para obter mais informações, consulte [Agendar tarefa de fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm).
    - O fluxo deve ter pelo menos uma etapa de saída.
    - A versão do fluxo deve ser compatível com a versão do Tableau Server.
- Gerenciamento de versões:
    
    - O histórico de revisões deve estar habilitado no site.
    - A função do usuário tem permissão para publicar no projeto.

Usuário com licença de Creator (Criador)

**As tarefas a seguir podem ser executadas:**

- Criar fluxos
- Editar rascunhos (fluxos que possuem) e fluxos publicados
- Carregar fluxos
- Executar fluxos (com permissões de Executar fluxo)
- Excluir (com permissões para excluir)
- Recuperar fluxos excluídos (com a Lixeira ativada pelo administrador)
- Baixar (com permissões para download ou salvar como e de leitura)
- Alterar permissões (com permissões para alteração)
- Alterar o projeto (com permissões para movimentação e para gravação no projeto de destino)
- Adicionar/remover marcas (com permissões de leitura)
- Alterar descrição (com permissões para Salvar)
- Alterar nome (com permissões para Salvar)
- Atualizar tarefa de fluxo (com permissões para Executar)
- Excluir tarefa de fluxo (com permissões para Executar)
- Criar uma tarefa de fluxo\* (com permissões para Executar)
- Gerenciamento de versões\* (com permissões para exibição, leitura, salvar como e download)

\* Algumas condições adicionais se aplicam a estas ações:

- Para criar uma tarefa de fluxo:
    
    - Uma agenda de fluxo deve estar disponível. No Tableau Server, somente os Administradores do servidor podem criar uma agenda. Além do Tableau Cloud, os usuários com permissões para agendar tarefas de fluxo podem criar uma agenda personalizada. Para obter mais informações, consulte [Agendar tarefa de fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm).
    - O fluxo deve ter pelo menos uma etapa de saída.
    - A versão do fluxo deve ser compatível com a versão do Tableau Server.
- Gerenciamento de versões:
    
    - O histórico de revisões deve estar habilitado no site.
    - A função do usuário tem permissão para publicar no projeto.

Usuário com licença de Explorer (Explorador)

**As tarefas a seguir podem ser executadas:**

**Observação**: a partir da versão 2020.4, os usuários com licença Explorer não podem mais executar fluxos no Tableau Server, mesmo que o Administrador do servidor atribua as permissões Executar fluxo: permitido.

- Os usuários da licença Explorer (pode publicar) com permissões Executar fluxo: permitidos podem executar fluxos no Tableau Server e no Tableau Cloud.
- Excluir (com permissões para excluir)
- Recuperar fluxos excluídos, com permissões de Explorer (pode publicar) e a Lixeira ativada pelo administrador
- Baixar (com permissões para download ou salvar como e de leitura)
- Alterar permissões (com permissões para alteração)
- Alterar o projeto (com permissões para movimentação e para gravação no projeto de destino)
- Adicionar/remover marcas (com permissões de leitura)
- Alterar descrição (com permissões para Salvar)
- Alterar nome (com permissões para Salvar)
- Atualizar tarefa de fluxo (com permissões para Executar)
- Excluir tarefa de fluxo (com permissões para Executar)
- Criar uma tarefa de fluxo\* (com permissões para Executar)
- Gerenciamento de versões\* (com permissões para exibição, leitura, salvar como e download)

\*Algumas condições adicionais se aplicam a estas ações:

- Para criar uma tarefa de fluxo:
    
    - Uma agenda de fluxo deve estar disponível. No Tableau Server, somente os Administradores do servidor podem criar uma agenda. Além do Tableau Cloud, os usuários com permissões para agendar tarefas de fluxo podem criar uma agenda personalizada. Para obter mais informações, consulte [Agendar tarefa de fluxo](https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm).
    - O fluxo deve ter pelo menos uma etapa de saída.
    - A versão do fluxo deve ser compatível com a versão do Tableau Server.
- Gerenciamento de versões:
    
    - O histórico de revisões deve estar habilitado no site.
    - A função do usuário tem permissão para publicar no projeto.

Usuário com licença de Viewer (Visualizador)

Os visualizadores não podem gerenciar fluxos, mas podem exibir o fluxo e suas diferentes versões.

Para obter mais informações sobre os recursos completos que você pode definir nos fluxos, consulte [Recursos de permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=8f2551d9913436292b86394b03a567c40f4ad74ba700c03590d266b42ac0971b url=/tableau/current/pt-br/server/rmt-server-roles.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar usuários e autenticação no Resource Monitoring Tool do Tableau (RMT)

Quando você instala o RMT, cria um usuário administrador durante a configuração. Esse usuário tem permissões para executar todas as tarefas no RMT Server. Posteriormente, você pode adicionar outros usuários e especificar quais tarefas eles podem executar relacionadas ao RMT.

## Adicionar um usuário local

Para adicionar usuários ao RMT, clique no botão Administrador menu e selecione Usuários (esta opção pode não estar disponível caso você não tenha configurado um ambiente).

Para adicionar um novo usuário em Resource Monitoring Tool:

1. No menu **Admin**, selecione Users.
2. Clique em New User.
3. Forneça um nome de usuário, senha e aplique as funções de servidor.
4. Clique em Save.

## Adicionar um usuário delegado

A partir da versão 2023.1, os usuários podem ser autenticados usando suas credenciais de conta de domínio em vez de usar uma senha separada armazenada localmente no RMT. Quando um usuário configurado para autenticação delegada entra no RMT, o RMT passa o usuário e a senha digitada para o sistema operacional (SO) do computador para verificação.

**Observação:** a partir da versão 2025.2, você pode usar a autenticação PAM para autenticação delegada. Para obter detalhes, consulte [Autenticação baseada em PAM no Resource Monitoring Tool do Tableau (RMT)](https://help.tableau.com/current/server/pt-br/rmt-admin-authentication-PAM.htm).

Para adicionar um novo usuário delegado em Resource Monitoring Tool:

1. No menu **Admin**, selecione Users.
2. Clique em New User. O padrão é um usuário local.
3. Selecione Sistema operacional (delegado).
4. Forneça um Nome de usuário.
    
    Certifique-se de digitar _apenas_ o nome de usuário. Não inclua domínios.
    
    Ao entrar no RMT, o usuário fornecerá sua senha de rede padrão e o sistema operacional verificará isso.
5. Delecione as funções de servidor que o usuário deve ter. Para obter mais detalhes sobre as funções do servidor, consulte abaixo.
6. Clique em Save.

## Alterar a autenticação do usuário

Com a versão 2023.1.0 ou posterior, você pode alterar um usuário existente de um tipo de autenticação para outro. Para alterar a autenticação de um usuário existente:

1. Clique no ícone Editar.
2. Selecione osModo de autenticação desejado:
    - Se você está mudando para o modo Sistema operacional (delegado), só precisa digitar o nome de usuário (sem domínio). O usuário fornecerá sua própria senha ao entrar. E a senha existente armazenada no RMT é excluída e não pode ser restaurada.
    - Se você está mudando para o modo RMT (Local), você precisa digitar um nome de usuário e senha. Eles são armazenados localmente pelo RMT.
3. Confirme as Funções do Servidor selecionadas para o usuário.
4. Clique em **Salvar** para salvar suas alterações.

## Funções de servidor no Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau tem várias funções de servidor que você pode atribuir a um usuário para dar permissões de executar certas tarefas.

A tabela a seguir lista as funções disponíveis e o que cada função permite que o usuário faça:

| Funções de servidor | Descrição da função |
| --- | --- |
| Baixar pacotes de registro | Baixar arquivos de registro. |
| Baixar arquivos TDS | Baixar arquivos **.tds.** |
| Gerar relatórios de chargeback | Criar relatórios de chargeback. |
| Gerenciamento de servidores/ambientes | Tem permissões para atualizar todas as configurações. |
| Gerenciamento de usuários | Criar e editar usuários. |
| Gerenciamento de webhook | Gerenciar configurações de notificação do Slack. |

### Solucionar problemas de autenticação

Para obter detalhes sobre como solucionar problemas de entrada e autenticação do usuário, consulte [Solucionar problemas de autenticação de usuário](https://help.tableau.com/current/server/pt-br/rmt-troubleshoot-user-signin.htm).

## Outros artigos nesta seção

<!-- document id=dff075a1f4bd2f51e398f43d5aedbf109bd07fc2e1f2029df3706d387d3472dd url=/tableau/current/pt-br/server/users.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar usuários e grupos

Adicione usuários aos sites do Tableau e defina suas funções de site, que determina o nível de acesso de cada usuário. Além disso, crie grupos de usuários e habilite o acesso de convidados aos sites.

## Outros artigos nesta seção

<!-- document id=28d6c19adcc99f1dd41b4fcf7733d8b5dd9c8e8b3fd30c3a6ed45933133163e2 url=/tableau/current/pt-br/server/groups.md -->

[Pular para o conteúdo principal](#main-content)

# Grupos

Crie e exclua grupos de usuários, adicione usuários a um grupo e sincronize grupos com o Active Directory.

## Outros artigos nesta seção

<!-- document id=076825931dfa909651de51cc051e46d9357e911b8ada70ef83d4a509921be0f7 url=/tableau/current/pt-br/server/user_visibility.md -->

[Pular para o conteúdo principal](#main-content)

# Gerenciar Visibilidade do usuário do site

Por padrão, todos os usuários do site poderão ver aliases, propriedade de projeto e comentários de outros usuários quando as permissões permitirem. A configuração Visibilidade do usuário permite que os administradores gerenciem se os usuários com funções de site Viewer e Explorer vêem outros usuários e grupos no site, o que pode ser importante para sites usados por vários clientes. Para saber mais sobre as funções que os usuários exercem no site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

## Limitar a visibilidade do usuário

Definir a Visibilidade do usuário como **Limitada** afeta determinadas ferramentas de colaboração e oculta as informações do usuário no Tableau Cloud e no Tableau Server. A Visibilidade do usuário limitada desativa o recurso para Viewers e Explorers (exceto Explorers (Administradores de site) ou remove as informações do usuário de outras áreas. Observe que Creators e administradores ainda verão as informações do usuário, quando a Visibilidade do usuário for definida como Limitada.

Para limitar a visibilidade do usuário para Explorers e Viewers (exceto Explorers (Administradores de site)):

- Navegue até a página Configurações do site
- Selecione Limitado na configuração Visibilidade do usuário

Veja a seguir uma lista de áreas de site afetadas quando a Visibilidade do usuário é definida como Limitada. A menos que o recurso esteja desativado para todos os usuários, somente Explorers ou Viewers não administradores serão afetados.

<table style="width: 100%;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Área</td><td style="font-weight: bold;">Impacto</td></tr><tr><td>Pesquisa</td><td>Informações do usuário não exibidas</td></tr><tr><td>Proprietários do conteúdo</td><td>Informações do usuário não exibidas (Explorers e Viewers não podem se ver, mas podem ver conteúdo deles em Meu conteúdo)</td></tr><tr><td>Imagens do perfil</td><td>Informações do usuário não exibidas</td></tr><tr><td>Assinaturas</td><td><p>Informações do usuário não exibidas</p><p>&nbsp;</p></td></tr><tr><td>Recomendações</td><td>Usuários semelhantes não exibidos (todos os usuários)</td></tr><tr><td>Adicionar/editar tags</td><td>Explorers e Viewers podem ver as tags, mas não podem excluí-las ou modificá-las</td></tr><tr><td>"Quem viu esta exibição?"</td><td>Desabilitado</td></tr><tr><td>Análise de uso do Pergunte aos dados</td><td>Desabilitado</td></tr><tr><td>Caixas de diálogo de permissões</td><td>Desabilitado</td></tr><tr><td>Compartilhamento nomeado</td><td>Desabilitada (todos os usuários)</td></tr><tr><td>Alertas</td><td><p>Desabilitada (todos os usuários)</p><p>Os alertas existentes pausados</p></td></tr><tr><td>Comentários</td><td>Desabilitada (todos os usuários)</td></tr><tr><td>Exibições publicas personalizadas</td><td><p>Desabilitada (todos os usuários)</p><p>As exibições personalizadas públicas existentes aparecem como privadas</p></td></tr><tr><td>Solicitar acesso</td><td>Desabilitada (todos os usuários)</td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span></td><td><p>Publicação de pastas de trabalho desativada no Desktop</p><p>Informações do usuário não exibidas nos filtros do usuário</p></td></tr><tr><td>Tableau Pulse</td><td>O botão para ver e gerenciar seguidores não aparece nas métricas</td></tr><tr><td>O Tableau Catalog (com <span class="mc-variable Variables.DM_sku variable">Data Management</span>)</td><td><p>Informações do usuário não exibidas</p></td></tr></tbody></table>

Quando a Visibilidade do usuário está definida como Limitada, as chamadas da API REST do Tableau Server e da API de metadados se comportam conforme descrito na tabela acima. Ainda é possível fazer chamadas de API que fazem referência a uma ID de usuário conhecida.

Os usuários de um site podem interagir com as exibições e modificá-las, como a aplicação de filtros. Se esse usuário compartilhar a exibição modificada com outras pessoas ou se o usuário criar algo a partir dessa exibição modificada (como uma métrica ou uma exibição personalizada privada), o nome desse usuário será exibido na URL. Assegure que a URL dessa exibição modificada seja distribuída apenas para usuários que podem ver o nome dessa pessoa.

**Observação**: se um usuário é membro de vários sites, inserir um e-mail na página de logon do Tableau Cloud retornará os nomes de todos os sites de que o usuário é membro.

### Práticas recomendadas para limitar a visibilidade do usuário

Os administradores também podem verificar se as informações de usuário e grupo não estão visíveis das seguintes formas:

- Configure as permissões para fornecer somente conteúdo às partes apropriadas. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).
    - A Visibilidade do usuário limitada oculta as informações de identificação do usuário na pesquisa, mas pode retornar o conteúdo que o usuário publicou, incluindo ao pesquisar pelo nome do proprietário, se a pessoa que está pesquisando tiver permissão de exibição para esse conteúdo.
    - Um usuário que publica uma pasta de trabalho com um título duplicado no mesmo projeto pode ver um aviso de que já existe uma pasta de trabalho com esse título.
- Aplique a segurança em nível de linha quando necessário.
- Verifique se os metadados nos painéis não contêm informações do usuário.
- Verifique se os cálculos acessíveis aos usuários não contêm metadados do usuário (por exemplo, filtros de usuário).

## Restaurar a visibilidade do usuário completa

Quando os administradores definem a Visibilidade do usuário novamente como Completa, os recursos desativados para todos os usuários por Visibilidade do usuário limitada (como comentários e alertas) permanecem desligados. Os administradores podem reativar esses recursos na página Configurações do site.

Todas as configurações de recursos anteriores não são retidas quando a Visibilidade do usuário está definida como Completa e os recursos afetados não são ativados automaticamente.

<!-- document id=25d5384be25cdcbeb03199887234d6397a9ab894bfdd1e5f0fcb5c3aaa1ffe90 url=/tableau/current/pt-br/server/rmt-performance-charts.md -->

[Pular para o conteúdo principal](#main-content)

# Gráficos de desempenho da Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau inclui painéis que ajudam a monitorar e analisar várias métricas de desempenho, como uso de recursos de hardware, atividade do usuário e status dos processos do Tableau Server. Eles podem ser úteis para identificar gargalos de desempenho e a integridade geral do Tableau Server.

Esse tópico descreve as informações nos gráficos da página **Desempenho.** A página de desempenho fornece uma visão do painel da integridade geral do Tableau Server e inclui as seguintes guias:

1. **Ambiente:** um painel das métricas de desempenho específicas para o ambiente que você selecionou.
2. **Servidores:** concentra-se nas métricas de recursos de hardware.
3. **Insights:** destaca as visualizações mais lentas e as atualizações de extração mais longas.
4. **Status:** status dos processos do Tableau Server. Informações sobre cada processo nos nós, estejam eles ativos, ocupados ou inativos. Isso é semelhante ao que você pode ver na página Configurações do Tableau Server.

![Menu suspenso Desempenho no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/rmt-perf-charts-tabs.png)

## Guia Ambiente

Os gráficos na guia de ambiente fornecem uma visão geral da integridade do Tableau Server.

- O lado esquerdo da página tem métricas relacionadas a recursos: Desempenho, Processos do Tableau e Tarefas em segundo plano.
- Os gráficos do lado direito se concentram na atividade do usuário e no impacto: Usuários simultâneos, Solicitações de carregamento de exibição lenta e Solicitações de carregamento de exibição total.

> [!TIP]
> 
> **Dicas de navegação:**  
> No canto superior esquerdo da página, você pode selecionar uma linha do tempo que será aplicada a todos os gráficos desta página. Você também pode selecionar um intervalo de tempo escolhendo uma parte de um gráfico específico (seleção de intervalo).  
> \- Quando você faz uma seleção de intervalo nos gráficos de desempenho de hardware e tarefas em segundo plano, a linha do tempo atua como um filtro para todos os gráficos nesta guia.  
> \- Quando você fizer uma seleção de intervalo no carregamento de exibição lenta e gráficos de atividades do usuário, será automaticamente levado para a página Atividade que fornece mais detalhes para o intervalo de tempo selecionado.

### Gráfico de desempenho

As informações neste gráfico mostram a integridade geral e o uso dos recursos de hardware para cada nó do Tableau Server. Os recursos de hardware incluídos neste gráfico são CPU, memória, fila de disco e rede.

**Observação:** as informações de rede não estão disponíveis e não têm suporte no momento para o Tableau Server em execução no Linux.

### Gráfico de processos do Tableau

Use este gráfico para obter mais detalhes sobre um nó específico e os processos em execução nesse nó. **A partir de 2021.4**, quase todos os processos do Tableau Server são rastreados, com algumas exceções, como controlador de cluster e processo configurados externamente ao cluster do Tableau Server, como repositório externo, repositório de arquivos externo e Independent Gateway. Este gráfico permite que você identifique os processos que estão aumentando a utilização da CPU ou da memória em um nó específico. O gráfico é atualizado dinamicamente para destacar os dez principais processos que estão usando a maioria dos recursos em um nó para o período selecionado.

**Observação:** alguns subprocessos do Tableau Server, como tabprotosrv, postgres e gateway, não são capturados pelo RMT Server e podem causar discrepâncias aparentes entre o gráfico Desempenho e a soma de todos os valores do gráfico Processos do Tableau.

### Gráfico de tarefas em segundo plano

O gráfico é uma visão geral do volume de tarefas em segundo plano, categorizadas pelo tipo de tarefa. Use o botão de alternância para ver o número total de tarefas, a duração média dessas tarefas e um histograma que mostra o tempo de execução para o período selecionado. Essa pode ser uma maneira rápida de fazer uma busca detalhada e ver quais tarefas estão demorando muito para serem executadas.

### Gráfico de usuários simultâneos

Este gráfico mostra o número de usuários que enviaram solicitações no tempo selecionado.

**Observação:** quando você seleciona uma parte deste gráfico, ele vai automaticamente para a página de atividade relacionada e mostra as informações para aquele período específico.

### Gráfico de solicitações de carregamento de exibição lenta

Este gráfico usa uma **linha de base** que é estabelecida para cada exibição e a usa para comparar o tempo que leva para renderizar aquela exibição e determinar se a exibição está demorando mais do que o esperado.

**Na versão 2021.4** a linha de base é estabelecida calculando o valor médio das primeiras 10 vezes que uma pasta de trabalho específica é renderizada.

**Na versão 2021.4.1** e posterior, a linha de base é estabelecida calculando o percentil 95 de 50 vezes que uma pasta de trabalho específica é renderizada com sucesso.

Quando uma linha de base é estabelecida, toda vez que a mesma pasta de trabalho é renderizada no futuro, o tempo gasto para carregá-la é então comparado à sua linha de base. Dependendo se o tempo gasto para renderizar a exibição está dentro do intervalo esperado ou em vários graus fora do intervalo esperado, eles são categorizados da seguinte forma:

- **Normal:** <= 2x a linha de base
- **Longo:** > = 2x a linha de base
- **Muito longo:** >= 4x a linha de base
- **Falha:** falha ao carregar ou resultou em erro

Essa linha de base e as comparações se aplicam apenas à renderização inicial da exibição. Ela se aplica a ações subsequentes, como seleções de filtro. Além disso, quando você publica uma nova versão da pasta de trabalho, ela dispara um recálculo da linha de base.

**Observação:** quando você seleciona uma parte deste gráfico, ele vai automaticamente para a página de atividade relacionada e mostra as informações para aquele período específico.

Para obter uma orientação detalhada sobre como usar este gráfico e investigar o desempenho com renderização de exibição, consulte [Investigação de solicitações de carregamento de exibição lenta](https://help.tableau.com/current/server/pt-br/rmt-slow-view-load-requests.htm) .

### Gráfico de solicitações de carregamento de exibição lenta

Esse gráfico dá uma ideia geral de quantas exibições foram renderizadas em um período. Ele é útil para avaliar o escopo do impacto de um incidente específico.

**Observação:** quando você seleciona uma parte deste gráfico, ele vai automaticamente para a página de atividade relacionada e mostra as informações para aquele período específico.

## Guia Servidores

Os gráficos nesta guia fornecem uma visão mais detalhada do gráfico de **Desempenho** na guia **Ambiente.**

## Guia Informações

### Exibições mais lentas

Este gráfico mostra as exibições mais lentas ordenadas por duração média do carregamento da exibição. O indicador de ponto laranja representa a maior duração do carregamento da exibição. O período representado aqui é o intervalo completo de dados disponíveis, o padrão é 2 semanas.

### Atualizações de extração mais longas

Este gráfico mostra as tarefas Atualizar extração mais lentas ordenadas por duração. As extrações da fonte de dados e as extrações da pasta de trabalho são consideradas. Elas podem ser distinguidas pelo ícone ao lado do nome. O período representado aqui é o intervalo completo de dados disponíveis, o padrão é 2 semanas.

## Guia Status

Essa guia lista os processos do Tableau Server e os status em cada nó do cluster do Tableau Server. Isso não inclui os processos do Tableau Server configurados externamente ao cluster do Tableau Server, como Repositório Externo, Armazenamento de Arquivo Externo e Independent Gateway.

## Quem pode fazer isso

Qualquer usuário da Resource Monitoring Tool pode visualizar os gráficos.

## Tópicos relacionados

- [Monitore o desempenho do Tableau Server com a Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-charts.htm)
- [Páginas de atividade da Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-activity-charts.htm)
- [Páginas de conteúdo da Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-content-pages.htm)

<!-- document id=8a41b975152ef574d98a012510b4aa08836a312d0a4f320552585349784a73db url=/tableau/current/pt-br/server/runas_os.md -->

[Pular para o conteúdo principal](#main-content)

# Habilitar a conta de serviço Run As para atuar como sistema operacional

Para usar a delegação do Kerberos com o Tableau Server, você deve configurar a conta de serviço Run As para atuar como sistema operacional em cada nó do Tableau Server.

1. No computador que está executando o Tableau Server, selecione Iniciar > Painel de controle > Ferramentas administrativas > Política de segurança local.
2. Na janela Configurações locais de segurança, expanda Políticas locais, clique em Atribuições de direitos do usuário e depois clique com o botão direito do mouse em Atuar como parte de um sistema operacional e selecione Propriedades.
    
    ![A janela Política de segurança local exibe as configurações de Atribuição de direitos do usuário, com a configuração "Agir como parte do sistema operacional" destacada.](/tableau/current/pt-br/server/pt-br/Img/runas_os.png)
3. Na janela Propriedades de Atuar como um sistema operacional, clique em Adicionar usuário ou grupo.
4. Digite o `<domain>\<username>` para a conta de serviço Run As do Tableau Server (por exemplo: `MYCOMPANY\tableau_server`) e clique em Verificar nomes.
5. Quando a conta for resolvida corretamente, ela será sublinhada. Clique em OK.
6. Clique em OK para fechar as janelas Política de segurança local.

<!-- document id=70e4cbe90a0b8f874805f81c2aae83976ec63b23db81d19ea1267b10caaef42f url=/tableau/current/pt-br/server/kerberos_delegation.md -->

[Pular para o conteúdo principal](#main-content)

# Habilitar a Delegação do Kerberos

A delegação do Kerberos permite que o Tableau Server use as credenciais do Kerberos do visualizador de uma pasta de trabalho ou exibição para executar uma consulta a pedido do visualizador. Essa opção é útil nas seguintes situações:

- É preciso saber quem está acessando os dados (o nome do visualizador será exibido nos logs de acesso da fonte de dados).
- Sua fonte de dados apresenta segurança em nível de linha, na qual usuários diferentes têm acesso a linhas diferentes.

## Fontes de dados compatíveis

O Tableau é compatível com a delegação Kerberos com as estas fontes de dados:

- Cloudera: Hive/Impala
- Denodo
- Hortonworks
- MSAS
- Oracle
- PostgreSQL
- Spark
- SQL Server
- Teradata
- Vertica
- TIBCO

## Requisitos

A delegação do Kerberos exige o Active Directory.

- O [armazenamento de identidade](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm) do Tableau Server deve ser configurado para usar o Active Directory.
- O computador onde o Tableau Server está instalado deve ser unido ao domínio do Active Directory.
- O MIT Kerberos KDC não é compatível.
- Uma conta de domínio deve ser configurada como a conta de serviço Run As no Tableau Server. Consulte [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm). Se os usuários estiverem em um domínio do Active Directory diferente do domínio do Tableau e da fonte de dados, a confiança do domínio deverá ser configurada. Consulte [Requisitos de confiança de domínio para implantações do Active Directory](https://help.tableau.com/current/server/pt-br/runas_domain.htm).
- Delegação configurada. Conceder direitos de delegação para a conta de serviço Run As do banco de dados de destino SPNs. Esta conta do serviço Run As é autoridade delegada para acessar os recursos em nome do usuário de origem iniciante.
- Se você estiver configurando a delegação no Tableau Server 2020.2 ou posterior, com uma fonte de dados Oracle, usando um conector JDBC, consulte [Ativar delegação do Kerberos para conectores JDBC](https://help.tableau.com/current/server/pt-br/kerberos_delegation_jdbc.htm). A partir do Tableau 2020.2, o conector Oracle usa JDBC.

## Criação na Web e autenticação Kerberos do usuário

Ao configurar o Conectar a dados para um determinado destino, você pode selecionar autenticação integrada ou Windows como método de autenticação preferencial. No entanto, para cenários de criação na Web, o comportamento padrão será usar a conta de serviço Kerberos (conta “Executar como”).

Para ativar credenciais de usuário em cenários de criação na Web com delegação Kerberos, você deve fazer uma configuração adicional usando o TSM. Execute os seguintes comandos:

tsm configuration set -k native\_api.WebAuthoringAuthModeKerberosDelegation -v true

tsm pending-changes apply

Após fazer esta configuração, a Delegação Kerberos se torna a operação padrão ao selecionar a autenticação integrada com criação na Web. No entanto, esta configuração não impedirá que os criadores de conteúdo acessem a conta do serviço. Os criadores ainda podem publicar conteúdo conectado à conta de serviço Run As usando o Tableau Desktop ou outros métodos.

Para obter mais informações sobre a conta de serviço Run As, consulte [Acesso aos dados com a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_access.htm).

## Processo de configuração

Esta seção fornece um exemplo do processo para habilitar a delegação do Kerberos. O cenário também inclui nomes de exemplo para ajudar a descrever as relações entre os elementos de configuração.

1. Em todos os nós no Tableau Server, configure o usuário Run As para atuar como parte do sistema operacional. Para obter mais informações, consulte [Habilitar a conta de serviço Run As para atuar como sistema operacional](https://help.tableau.com/current/server/pt-br/runas_os.htm).
2. O Tableau Server precisará de um ticket de serviço do Kerberos para delegar em nome do usuário que está iniciando a chamada para o banco de dados. Crie uma conta de domínio que será usada para delegar ao banco de dados fornecido. Essa conta é chamada de conta de serviço Run As. Neste exemplo, o usuário de exemplo configurado como a conta de delegação/Run As é `tabsrv@example.com`.
    
    A conta deve ser configurada com um usuário e computadores do Active Directory em um servidor do Windows conectado ao domínio do usuário:
    
    - Abra a página **Propriedades** da conta de serviço Run As, clique na guia **Delegação** e selecione **Confiar neste usuário para a delegação apenas em serviços específicos** e **Usar qualquer protocolo de autenticação**.
3. Execute o seguinte comando TSM para habilitar a delegação do Kerberos:
    
    `tsm configuration set -k wgserver.delegation.enabled -v true`
4. Execute o seguinte comando do TSM para aplicar as alterações ao Tableau Server:
    
    `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).
5. (Opcional) Configure o Tableau Server para usar o formato principal do MIT Kerberos.
    
    Por padrão, o Tableau Server gera entidades do Kerberos usando o nome abreviado do Active Directory. Por exemplo, se o Tableau Server executar a delegação do Kerberos para um usuário no `EXAMPLE.COM`, com um nome abreviado `EXAMPLE`, o nome principal será: `user@example`.
    
    Se o banco de dados estiver em execução no Linux, talvez seja necessário ajustar o mapeamento `auth_to_local` no arquivo krb5.conf. Para obter informações sobre como editar o arquivo krb5.conf, consulte [Configuração de vários domínios da delegação do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_trouble.htm#multi). Como alternativa, você pode configurar o Tableau Server para usar o nome de domínio completo para as entidades do Kerberos executando os seguintes comandos:
    
    tsm configuration set -k native\_api.protocol\_transition\_a\_d\_short\_domain -v false --force-keys
    tsm configuration set -k native\_api.protocol\_transition\_uppercase\_realm -v true --force-keys
    tsm pending-changes apply
6. Habilite a delegação para as conexões de dados:
    
    - **SQL Server** — Consulte [Habilitação da delegação do Kerberos para SQL Server](https://community.tableau.com/s/question/0D54T00000CWcplSAD/enabling-kerberos-delegation-for-sql-server) na Comunidade do Tableau.
    - **MSAS** — Consulte [Habilitação da delegação do Kerberos para MSAS](https://community.tableau.com/s/question/0D54T00000G54sYSAR/enabling-kerberos-delegation-for-msas) na Comunidade do Tableau.
    - **PostgreSQL** — Consulte [Habilitação da delegação do Kerberos para PostgreSQL](https://community.tableau.com/s/question/0D54T00000G54ssSAB/enabling-kerberos-delegation-for-postgresql) na Comunidade do Tableau.
    - **Teradata** — Consulte [Habilitação da delegação do Kerberos para Teradata](https://community.tableau.com/s/question/0D54T00000G54tCSAR/enabling-kerberos-delegation-for-teradata) na Comunidade do Tableau.
    - **Oracle** — Consulte [Habilitação da delegação do Kerberos para Oracle](https://community.tableau.com/s/news/a0A4T000002O42jUAC/enable-kerberos-delegation-for-oracle) na Comunidade do Tableau.
    - **Cloudera**—Consulte [Habilitação da delegação do Kerberos para Hive/Impala](https://community.tableau.com/s/question/0D54T00000CWdINSA1/enable-delegation-for-hiveimpala) na Comunidade do Tableau.
    - **Vertica**— Consulte [Habilitação da delegação do Kerberos para Vertica](https://community.tableau.com/s/question/0D54T00000CWd5sSAD/enabling-kerberos-delegation-for-vertica) na Comunidade do Tableau.
    - **TIBCO—**Consulte [Configuração do Kerberos para uso com TDV](https://docs.tibco.com/pub/tdv/8.8.0/doc/html/en-US/StudioHelp/index.html#Administration/Configuring_Kerberos_for_Use_with_TDV.html) no Guia de Administração de Visualização de Dados da TIBCO.
    
    ## Consulte também
    
    [Solucionar problemas do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_trouble.htm)

## Outros artigos nesta seção

<!-- document id=48f6baf6ff795f4d8b152549c67bbf59c4effa0241732875862a953caaeca701 url=/tableau/current/pt-br/server/schedule_enable_custom.md -->

[Pular para o conteúdo principal](#main-content)

# Habilitar agendas personalizadas para assinaturas

As agendas personalizadas para assinaturas permitem que os usuários recebam mensagens de e-mail em uma agenda definida por eles, em vez de usarem uma agenda fixa definida por um administrador do servidor. As agendas personalizadas para assinaturas estão disponíveis para os usuários do Tableau Cloud desde março de 2017 e, agora, essas agendas podem ser habilitadas por site na versão 2018.2 do Tableau Server. Habilitar agendas personalizadas para assinaturas é uma alteração permanente em qualquer site no qual você realizar essa alteração. Qualquer site no qual você não habilitar agendas personalizadas permanecerá com as agendas fixas definidas por um administrador do servidor.

## Habilitar agendas personalizadas

Para poder habilitar agendas personalizadas em um ou mais sites, primeiro você deve habilitar agendas personalizadas no Tableau Server e, depois, em um ou mais sites nesse servidor. Para obter mais informações sobre como habilitar assinaturas no Tableau Server, consulte [Configurar um site para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm).

**Etapa 1: habilitar agendas personalizadas no Tableau Server**

Em um prompt de comando com permissões de administrador do Tableau, execute os seguintes comandos:

```
tsm configuration set -k features.SelfServiceSchedules -v true
tsm pending-changes apply
```

Essa operação reiniciará o Tableau Server.

**Etapa 2: habilitar agendas personalizadas em um site**

1. Faça logon no Tableau Server como administrador do servidor, usando um navegador da Web:
    
    ```
    https://<hostname>/#/login
    ```
2. Navegue até a página **Configurações do site** de um site e, depois, habilite agendas personalizadas:
    
    1. Clique em **Todos os sites** e escolha um dos sites na lista suspensa.
    2. Clique em **Configurações**.
    3. Em **Assinaturas** na guia **Geral**, marque a seguinte caixa de seleção: **Converter permanentemente de agendas fixas criadas por administradores em agendas personalizadas criadas por usuários. (Não é possível desfazer essa ação)**.
    4. Clique em **Salvar**.

Quando agendas personalizadas são habilitadas em um site, todas as agendas fixas com uma assinatura são convertidas em agendas personalizadas equivalentes.

<!-- document id=944032a528ad0b8188275236a85ad837073a8953aa6d6e36575c8c3ac67e01e7 url=/tableau/current/pt-br/server/ports_jmx.md -->

[Pular para o conteúdo principal](#main-content)

# Habilitar as portas JMX

Para ajudá-lo a lidar com um problema no Tableau Server, o Suporte do Tableau poderá solicitar que você habilite as portas JMX do servidor. Essas portas podem ser usadas para o monitoramento e a solução de problemas, geralmente com uma ferramenta como o JConsole. Nas versões 2022.1 e posteriores, as portas JMX podem ser habilitadas com segurança e este é o método recomendado. Nas versões anteriores a 2022.1, você só pode habilitar as portas não seguras.

## Habilitar as portas do JMX seguro

A partir da versão 2022.1 do Tableau Server, você pode ativar as portas JMX com segurança. Este procedimento explica como habilitar o JMX seguro. Para ativar o JMX em versões anteriores, consulte [Habilitar as portas do JMX não seguro](#EnableUnsecureJMX) abaixo.

Para habilitar as portas do JMX seguro no Tableau Server:

1. Abra um prompt de comando como usuário com acesso de administrador ao computador em que o TSM está instalado.
2. Execute este comando:
    
    tsm maintenance jmx enable
    
    O comando tem várias opções que você pode fornecer ao executá-lo. Se você não fornecer nenhuma opção ao executar o comando, serão solicitadas opções com base nas respostas fornecidas.
    
    Por exemplo:
    
    C:\\Windows\\system32>tsm maintenance jmx enable
    We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX?
    (y/n): y
    JMX access is readonly by default. Would you like to add readwrite access?
    (y/n): n
    Would you like to enable SSL?
    (y/n): y
    Would you like to require client authentication (mTLS)?
    (y/n): n
    Enabling JMX with the specified settings. This will perform a server restart. Do you want to continue?
    (y/n): y
    Starting enable JMX asynchronous job.
    
    Para obter mais informações sobre o comando e suas opções, consulte [tsm maintenance jmx enable](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#jmx_enable).

Habilitar as portas do JMX não seguro

Para versões do Tableau Server anteriores a 2022.1.0, se você estiver ativando portas do JMX, elas só poderão ser ativadas desprotegidas.

**Importante** habilitar as portas do JMX não seguro pode representar algum risco de segurança. É altamente recomendável usar JMX seguro. Se você não tiver uma versão do Tableau Server compatível com isso, esteja ciente do risco e reduza-o limitando o acesso às portas do JMX ao menor número de clientes que for prático para o seu cenário. Normalmente se limita o acesso por meio das regras de firewall do host, um dispositivo de segurança externo ou regras de roteamento.

Para habilitar as portas do JMX no Tableau Server:

1. [Interrompa o servidor.](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm#stop)
2. Insira o seguinte comando:
    
    ```
    tsm configuration set -k service.jmx_enabled -v true
    ```
3. 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).
4. Reinicie o Serviço de coordenação e o Controlador de administração do TSM:
    
    `net stop appzookeeper_0`
    
    `net start appzookeeper_0`
    
    `net stop tabadmincontroller_0`
    
    `net start tabadmincontroller_0`
    
    **Observação:** você deve executar esses comandos como administrador em um prompt de comando. Dependendo da configuração do computador, talvez seja necessário executá-los na pasta `C:\Windows\System32`.
    
    Pode demorar alguns minutos para tabadmincontroller reiniciar. Se você tentar aplicar alterações pendentes na próxima etapa, antes que o controlador tenha reiniciado completamente, o TSM não conseguirá se conectar ao controlador. Use o comando `tsm status -v` para garantir que o controlador esteja funcionando. O Controlador de administração do Tableau Server deve ser listado como "em execução".
5. [Inicie o servidor](https://help.tableau.com/current/server/pt-br/cli_start_tsm.htm#start).

## Como as portas JMX são determinadas

Como padrão, as portas JMX atribuídas dinamicamente, de dentro de uma faixa de portas disponíveis. Para obter detalhes sobre como a atribuição de porta é feita, e como substituir o mapeamento dinâmico, consulte [Portas do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/ports.htm).

<!-- document id=6e30b501ef08036d42d198780d35ae3d52f5bbe7a23869622d6b8acbbd81e19c url=/tableau/current/pt-br/server/prep_conductor_config_server_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Habilitar e configurar o Tableau Prep Conductor no Tableau Server

_Azure compatível com o Tableau Server versão 2019.1 e posterior._

O Tableau Prep Conductor está licenciado por meio do Data Management de cada implantação, que está baseada em usuário ou núcleo. Uma implantação inclui uma instalação de produção licenciada do Tableau Server e instalações licenciadas de não produção do Tableau Server, que oferecem suporte à instalação de produção. Para obter mais informações sobre a implantação, consulte o [Guia de implantação do Tableau](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_welcome.htm).

Para obter mais informações sobre como funciona o licenciamento do Tableau Prep Conductor, consulte [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).

### Topologia do servidor

Quando você instala o Tableau Server e habilita o Tableau Prep Conductor, usando a chave do produto do Data Management, o Tableau Prep Conductor é habilitado automaticamente por padrão pelo programa de instalação.

Para instalações de vários nós, por padrão, uma instância do Tableau Prep Conductor é habilitada em qualquer nó que tenha o processador em segundo plano instalado. No exemplo abaixo, o Tableau Prep Conductor está habilitado nos nó 2 e 3, onde o processador em segundo plano também está habilitado, mas não nos nós 1,4 e 5.

![A página Status do Tableau Server mostrando o Tableau Prep Conductor habilitado nos nós 2 e 3, onde os processadores em segundo plano também estão habilitados, mas não nos nós 1,4 e 5.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_multinode.png)

Abaixo, uma representação visual desse fluxo de trabalho:

![Um fluxograma que orienta você no processo de instalação e configuração de um novo Tableau Server, bem como na atualização de um existente.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_config_server_workflow.png)

## Próxima etapa:

Novas instalações do Tableau Server: [Etapa 1 (nova instalação): instalar o Tableau Server com o Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_conductor_new_install.htm)

Instalações existentes do Tableau Server: [Etapa 1 (instalação existente): habilitar o Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_conductor_add_to_existing_install.htm)

### Quem pode fazer isso

Os administradores de servidor podem instalar o Tableau Server e habilitar o Tableau Prep Conductor.

As configurações a nível de servidor podem ser configuradas pelos administradores do Tableau Server e configurações a nível de site podem ser configuradas pelos administradores do Tableau Server e do site.

## Outros artigos nesta seção

<!-- document id=112b28cff95be65129218678f350ed1afa4d23b3935fa12402f9a72d29f917d5 url=/tableau/current/pt-br/server/config_sap_bw_sso.md -->

[Pular para o conteúdo principal](#main-content)

# Habilitar logon único para SAP BW

Ao iniciar o Tableau 10.2, você pode configurar o suporte para logon único (SSO) do Tableau para SAP NetWeaver Business Warehouse (SAP BW). Para usar este recurso, é necessário instalar e configurar o software em ambos Tableau Server e Tableau Desktop.

A configuração desse recurso é um desafio que inclui requisitos rigorosos de versão e ambiente, bem como um engenheiro SAP para ajudá-lo a realizá-la com sucesso.

Os requisitos e as instruções detalhadas estão disponíveis em [Configurar logon único para SAP BW](https://community.tableau.com/s/question/0D54T00000CWdNzSAL/configure-single-signon-for-sap-bw) na Comunidade do Tableau.

<!-- document id=616f1f8ed593eb317b5b9b544ae95a1c3f25214feb09a5cc073bf4e23e67c98c url=/tableau/current/pt-br/server/schedule_enable.md -->

[Pular para o conteúdo principal](#main-content)

# Habilitar o agendamento da atualização de extração e a notificação de falha

Os publicadores podem agendar atualizações de extração quando duas condições forem atendidas:

- O Tableau Server está configurado para enviar mensagens de e-mail quando ocorrer falha nas atualizações de extração. Essa configuração é realizada por um administrador do Tableau Server Manager (TSM) e fica ativa por padrão. Para obter detalhes, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).
- O site ou sites em que você deseja permitir que os publicadores agendem atualizações de extração estão configurados para enviar e-mail quando ocorrer falha na atualização. Essa configuração é realizada por um administrador do servidor no Tableau Server e fica ativa por padrão. As instruções abaixo explicam como fazer isso se essa configuração não estiver ativada.

Enquanto estiver habilitando o agendamento, você pode decidir se também habilita o envio de e-mail para os proprietários das fontes de dados ou das pastas de trabalho que forem atualizadas quando essas atualizações de extração não forem concluídas com sucesso. É possível ler mais sobre esses e-mails abaixo. Ao habilitar a notificação de falha da atualização, os proprietários do conteúdo que têm atualizações agendadas podem optar individualmente pelo cancelamento, ao alterar as configurações de conta.

1. Entre no Tableau Server como administrador de servidor.
2. Acesse a guia Geral da página Configurações para o site que deseja configurar para assinaturas:
    
    - Se você tiver um único site, na parte superior da janela do navegador, clique em Configurações e Geral.
    - Se você tiver vários sites, selecione o site que deseja configurar e clique em Configurações e Geral.
3. Na página Geral, faça o seguinte:
    
    - Role até as configurações de Gerenciar notificações e marque Extrair trabalhos.
        
        Se uma atualização agendada de uma fonte de dados específica falhar, o e-mail é enviado apenas para o proprietário dessa fonte de dados, não para os proprietários de pastas de trabalho que se conectam a ela.
    - Em Credenciais inseridas, selecione as duas opções para permitir que publicadores insiram credenciais e agendem atualizações de extração. (Agendas de atualização automática exigem credenciais inseridas para que o Tableau Server possa acessar os dados diretamente.)
        
        **Observação**: em um servidor com vários sites, as notificações de falha são uma configuração do site e as credenciais inseridas são uma configuração do servidor. Para configurar credenciais inseridas em um servidor de vários sites, selecione Gerenciar todos os sites e Configurações.

## Gerenciamento de agendas no servidor

Pode ser mais apropriado em sua empresa o gerenciamento de credenciais inseridas e a atualização de agendas centralizados no servidor. Se fizer isso, você pode desmarcar as caixas de seleção na seção Credenciais inseridas, descrita nas etapas assim, para que os publicadores do Tableau Desktop não vejam as opções de agendas durante a publicação.

O gerenciamento centralizado das agendas permite que você distribua as tarefas de atualização de extração e de assinatura, para que possa executá-las quando a maioria dos usuários estiver off-line. Ela também permite que você visualize quais credenciais estão inseridas nas conexões.

## Como funcionam os e-mails de falha da atualização

A notificação por e-mail de uma atualização de extração com falhas lista o nome da extração e a localização no servidor, fornece a hora da última atualização bem-sucedida, o número de vezes consecutivas que a atualização falhou e sugere o motivo da falha e a possível solução.

Após cinco falhas consecutivas, a agenda de atualização é suspensa até que você ou o proprietário dos dados realize uma ação para resolver a causa da falha, como atualizar as credenciais de banco de dados ou um caminho para o arquivo de dados original.

## Habilitar e-mails de falha de atualização para não administradores

**Observação:** esta opção não está disponível para fontes de dados publicadas criadas ou atualizadas a partir do Bridge.

Por padrão, somente os proprietários do conteúdo recebem notificações se houver um problema ao atualizar um extrato. No entanto, os administratores têm a opção de receber notificações caso uma extração não seja bem-sucedida.

Para habilitar notificações por e-mail quando uma extração falhar, abra o menu de contexto (**...**) no painel de extração, selecione Notificação de falha de extração, e selecione **Sim** para receber notificações, ou **Não** para parar as notificações.

![Menu contendo notificação de falha de extração](/tableau/current/pt-br/server/pt-br/Img/extract_failure_notify_menu.png "menu de contexto")

**Observação**: se o usuário atual for proprietário da extração, a capacidade de ativar ou desativar as notificações de falha não estará disponível usando o menu de contexto.

### Como é determinada a data da última atualização bem-sucedida

A data e a hora da última atualização bem-sucedida são mostradas quando a última atualização ocorreu dentro de um número de dias. Por padrão, são 14 dias, e esse valor é definido em `wgserver.alerts.observed_days`. Se o número de dias desde a última atualização bem-sucedida exceder o número especificado nessa configuração, a mensagem no e-mail mostrará "não ocorreu nos últimos _N_ dias".

<!-- document id=b4111898af41ea1afa9152a24a0e3b5263225ef04d9402e57ab836b306a4d038 url=/tableau/current/pt-br/server/rmt-incidents-hardware.md -->

[Pular para o conteúdo principal](#main-content)

# Incidentes de hardware

_Hardware_ Os incidentes monitoram o próprio servidor. Eles podem ser usados para ajudar a identificar problemas do servidor que podem afetar o desempenho do Tableau Server.

Você pode definir limites para os seguintes problemas:

- Utilização da CPU
- Memória disponível
- Uso de memória
- Espaço em disco livre

Os seguintes incidentes são configurados por padrão quando você instala um novo Resource Monitoring Tool do Tableau:

- Quando o espaço em disco disponível fica abaixo de 10 GB por 10 minutos ou mais, um incidente de aviso é registrado e, quando o disco disponível fica abaixo de 5 GB por 10 minutos ou mais, um incidente crítico é registrado.
- Quando a memória disponível fica abaixo de 8 GB por mais de 10 minutos, um incidente de aviso é registrado.
- Quando a utilização da CPU em todo o servidor é de 80% ou mais por 5 minutos, um incidente de aviso é registrado.

**Nota:** os incidentes relacionados à memória são configurados em múltiplos binários de bytes.

Configure limites usando a interface na Web do Servidor RMT ou atualizando o arquivo de configuração `config.json`.

Para definir os limites para incidentes de hardware, no menu **Admin**, selecione **Configuração** e acesse a guia **Incidentes**.

Para **Utilização da CPU**, defina o seguinte:

Para definir os limites para incidentes de hardware, no menu **Admin**, selecione **Configuração** e acesse a guia **Incidentes**.

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Chave</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><b>Gravidade</b></td><td>Obrigatório</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>.</p></td></tr><tr><td><b>Processo</b></td><td>Obrigatório</td><td>O limite se aplica a todo o Tableau Server ou a um único processo conforme especificado.</td></tr><tr><td><b>Limite inicial</b></td><td>Obrigatório</td><td>A utilização da CPU deve exceder o valor especificado antes que um incidente seja criado e monitorado. Defina a porcentagem e a duração desse limite.</td></tr><tr><td><b>Limite final</b></td><td>Opcional</td><td>A utilização da CPU deve ficar abaixo do valor especificado antes que um incidente seja considerado resolvido.</td></tr></tbody></table>

Para **memória disponível**, defina o seguinte:

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Chave</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><b>Gravidade</b></td><td>Obrigatório</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>.</p></td></tr><tr><td><b>Limite inicial</b></td><td>Obrigatório</td><td>A memória disponível deve ficar abaixo do valor especificado antes que um incidente seja criado e monitorado. Defina a porcentagem e a duração desse limite.</td></tr><tr><td><b>Limite final</b></td><td>Opcional</td><td>A memória disponível deve ficar acima do valor especificado antes que um incidente seja considerado resolvido.</td></tr></tbody></table>

Para **Utilização da memória**, defina o seguinte:

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Chave</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><b>Gravidade</b></td><td>Obrigatório</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>.</p></td></tr><tr><td><b>Processo</b></td><td>Obrigatório</td><td>O limite se aplica a todo o Tableau Server ou a um único processo conforme especificado.</td></tr><tr><td><b>Limite inicial</b></td><td>Obrigatório</td><td>A utilização da memória deve ser igual ao valor especificado antes que um incidente seja criado e monitorado. Defina a porcentagem e a duração desse limite.</td></tr><tr><td><b>Limite final</b></td><td>Opcional</td><td>A utilização da memória deve ficar abaixo do valor especificado antes que um incidente seja considerado resolvido.</td></tr></tbody></table>

Para **espaço em disco livre**, defina o seguinte:

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Chave</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><b>Gravidade</b></td><td>Obrigatório</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>.</p></td></tr><tr><td><b>Limite inicial</b></td><td>Obrigatório</td><td>O espaço em disco livre deve ficar abaixo do valor especificado antes que um incidente seja criado e monitorado. Defina a porcentagem e a duração desse limite.</td></tr><tr><td><b>Limite final</b></td><td>Opcional</td><td>O espaço em disco livre deve ficar acima do valor especificado antes que um incidente seja considerado resolvido.</td></tr></tbody></table>

Para **Tamanho da fila em disco**, defina o seguinte:

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Chave</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><b>Gravidade</b></td><td>Obrigatório</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>.</p></td></tr><tr><td><b>Limite inicial</b></td><td>Obrigatório</td><td>O tamanho da fila em disco deve ser igual ao valor especificado antes que um incidente seja criado e monitorado. Defina a porcentagem e a duração desse limite.</td></tr><tr><td><b>Limite final</b></td><td>Opcional</td><td>O tamanho da fila em disco deve ficar abaixo do valor especificado antes que um incidente seja considerado resolvido.</td></tr></tbody></table>

Um trecho do exemplo de `config.json` definindo dois incidentes de hardware:

```
{  
 "monitoring":  {  
    "incidents":  {  
      "triggers":  [  
        {  
          "counter":  "DiskSpaceAvailableKB",  
          "severity":  "warning",  
          "threshold":  1048576  
        },  
        {  
          "counter":  "ProcessorTimePercent",  
          "severity":  "warning",  
          "threshold":  0.95,  
          "thresholdDuration":  300000,  
          "endThreshold":  0.90,  
          "endThresholdDuration":  5000  
        }  
      ]  
    }  
  }  
}
```

- O incidente **DiskSpaceAvailableKB** acionará um aviso quando o espaço em disco disponível ficar abaixo de 10 GB.
- O incidente **ProcessorTimePercent** acionará um aviso assim que a CPU tiver pelo menos 95% de utilização por mais de 5 minutos. O incidente será considerado resolvido após a utilização da CPU abaixo, de 90% para 5 segundos.

As configurações padrão podem ou não atender aos requisitos, e podem ser alteradas com base no seu ambiente. Como exemplo, para um ambiente, cujo identificador era “staging-environment”, acionar um aviso quando o espaço em disco disponível ficar abaixo de 2 GB, a configuração teria a seguinte aparência:

```
{  
  "environments":  {  
    "staging-environment":  {  
     "monitoring":  {  
        "incidents":  {  
          "triggers":  [  
            {  
              "counter":  "DiskSpaceAvailableKB",  
              "severity":  "warning",  
              "threshold":  2097152  
            }  
          ]  
        }  
      }  
    }  
  }  
}
```

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col><col></colgroup><thead><tr><th>Chave</th><th>Tipo de dados</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td><code style="font-style: normal;">counter</code></td><td>Cadeia de caracteres</td><td>Obrigatório</td><td><p>O identificador do incidente de hardware a ser monitorado. As opções disponíveis são:</p><ul><li><code>ProcessorTimePercent</code></li><li><code>DiskSpaceAvailableKB</code></li><li><code>DiskQueueTotalLength</code></li><li><code>MemoryAvailableKB</code></li><li><code>MemoryCommittedKB</code></li></ul></td></tr><tr><td><code>severity</code></td><td>Cadeia de caracteres</td><td>Opcional</td><td><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm#incident-severity-levels">Nível de severidade do incidente</a>. Valor padrão: <code>Warning</code></p></td></tr><tr><td><code>threshold</code></td><td>Número</td><td>Obrigatório</td><td>O limite que deve ser excedido antes que um incidente seja monitorado.</td></tr><tr><td><code>thresholdDuration</code></td><td>Número</td><td>Opcional</td><td>A quantidade de tempo em milissegundos para monitorar a situação antes de acionar um incidente. Se não especificado, um incidente será acionado assim que o <code>threshold</code> for alcançado.</td></tr><tr><td><code>endThreshold</code></td><td>Número</td><td>Opcional</td><td>O limite que deve ser excedido antes que um incidente seja considerado resolvido.</td></tr><tr><td>endThresholdDuration</td><td>Número</td><td>Opcional</td><td>A quantidade de tempo em milissegundos para monitorar a situação antes de concluir um incidente. Se não especificado, um incidente será resolvido assim que o <code>endThreshold</code> for alcançado. Se <code>endThreshold</code> não estiver definido, <code>threshold</code> será usado.</td></tr></tbody></table>

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=b25481561fbfd5e27d199d24a24034de120f613c567dfba3497119c81b6ac7f3 url=/tableau/current/pt-br/server/dm_adminview_dqw.md -->

[Pular para o conteúdo principal](#main-content)

# História de aviso de qualidade de dados

Quando o Tableau Catalog está habilitado, os administradores do site podem ver como os avisos de qualidade de dados estão sendo usados no site usando a exibição de administração pré-criada, História de aviso de qualidade de dados.

Para obter mais informações sobre Tableau Catalog, parte do Data Management, consulte "Sobre o Tableau Catalog”, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm).

Na página Status do site, selecione o painel História de aviso de qualidade de dados:

![Exibição administrativa da História de aviso de qualidade de dados](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_admin_view0.png)

O painel mostra quantos avisos de qualidade de dados estão ativos durante um período. Ele também mostra quantos avisos foram alterados (criados, atualizados e excluídos) durante esse mesmo período.

## Veja detalhes de aviso

Sob os gráficos de linha estão os detalhes sobre os avisos de qualidade de dados, incluindo:

- **Data e hora** - Quando o aviso foi criado ou alterado pela última vez.
- **Tipo de conteúdo** - O tipo de ativo no qual o aviso está definido, como um banco de dados, tabela ou fonte de dados.
- **Nome do conteúdo** \- Nome do ativo no qual o aviso é definido.
- **Alterado por** - Nome da pessoa que criou ou última mudou o aviso.
- **Status** - Se o aviso está ativo ou inativo.
- **Tipo** \- O tipo de aviso pode ser dados obsoletos, aviso, dados preteridos, confidenciais ou em manutenção.
- **Visibilidade** \- O aviso pode ser configurado para ter visibilidade normal (o padrão) ou alta.
- **Mensagem** \- A mensagem que o criador do aviso escreveu para exibir aos usuários quando visualizam os detalhes do aviso.

## História de aviso de filtro

Ao analisar a história de aviso de qualidade de dados, você pode clicar em uma marca na exibição para filtrar os detalhes mostrados abaixo da exibição.

![Painel Histórico de aviso de qualidade de dados que exibe a quantidade de alertas de qualidade de dados ativos e modificados ao longo do tempo](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_admin_view.png)

Os números no eixo Dia representam a data dentro do intervalo de tempo. Por exemplo, se hoje é 18 de novembro, e você filtrar para os últimos 7 dias, o eixo Dia mostra 12-18.

Mais filtros estão disponíveis quando você clica no ícone do filtro no canto superior direito: filtro por intervalo de tempo e por tipo de conteúdo.

### Filtrar por intervalo de tempo

Você pode configurar o intervalo de tempo de anos a minutos.

![Um menu de filtro que permite selecionar um intervalo de tempo](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_admin_view_filter_time.png)

### Filtrar por tipo de conteúdo

Você pode ver todos os avisos de qualidade de dados em seu site, ou pode filtrar para ver avisos para tipos específicos de ativos, como fonte de dados ou tabela:

![Um menu de filtro com opções para intervalo de tempo e tipo de conteúdo](/tableau/current/pt-br/server/pt-br/Img/dm_dqw_admin_view_filter_type.png)

## Acessar dados de história de aviso de qualidade de dados

Além de usar a exibição de administrador de História de aviso de qualidade de dados, você também pode acessar dados de história de aviso de qualidade de dados no banco de dados postgreSQL de "grupo de trabalho" do repositório do Tableau Server. Antes de acessá-los, você deve [ativar o acesso ao Repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#enable-access-to-the-tableau-server-repository).

Consulte [Sobre o dicionário de dados do Tableau](https://help.tableau.com/current/server/pt-br/data_dictionary.htm) para obter um link para abrir o dicionário de dados mais recente em que você pode pesquisar essas tabelas com dados de história de aviso de qualidade:

- historical\_events
- historical\_event\_types
- hist\_data\_quality\_indicators
- data\_quality\_indicators

## Quem pode fazer isso

Para definir um aviso de qualidade de dados, você deve ser um administrador de servidor ou site:

<!-- document id=0c84568f747e9faa18d6bd35d5e17c06546407d504c8493efa0caad0ba69b2d4 url=/tableau/current/pt-br/server/trusted_auth_trouble_401.md -->

[Pular para o conteúdo principal](#main-content)

# HTTP 401 - Não autorizado

Se você receber um **erro 401- Não autorizado**, pode ser por um dos seguintes motivos: 

- Você pode ter configurado o Tableau Server para usar o Active Directory com SSPI. Se o servidor Web usar SSPI, não será necessário configurar a autenticação confiável. É possível inserir exibições, e seus usuários terão acesso a elas desde que sejam usuários licenciados do Tableau Server e membros do seu Active Directory. Para obter mais informações, consulte [tsm authentication sspi <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMSspi).
    
    **Observação:** SSPI só pode ser configurado no Tableau Server para Windows.
- Ou um **erro de redirecionamento 302** após a implantação do Tableau Server , é provável que o código do ticket confiável que você escreveu para criar a URL do cliente não tenha sido atualizado para representar o formato da URL do ticket de duas partes. Para obter mais informações, consulte [Obter um ticket do Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_webrequ.htm).

<!-- document id=3bee1bb15091c31653b8a0b006aa2a99041e2c06c9f3e0c8942ab78c55af4794 url=/tableau/current/pt-br/server/trusted_auth_trouble_404.md -->

[Pular para o conteúdo principal](#main-content)

# HTTP 404 – Arquivo não encontrado

Você poderá receber esse erro se o código do seu programa fizer referência a uma URL do Tableau Server que não existe. Por exemplo, o servidor Web pode construir uma URL inválida que não pode ser encontrada quando a página da Web tenta recuperá-la.

Outra causa para esse erro é se você não inseriu servidores Web confiáveis, conforme especificado em [Adicionar endereços IP confiáveis ou nomes de host ao Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_trustIP.htm). Se você já inseriu os servidores Web confiáveis, verifique se os endereços IP ou os nomes do host estão corretos.

<!-- document id=8a767def68ff45b9af81897f91cfdbf2d9d6a60f69e1c46d2918a80e975c7485 url=/tableau/current/pt-br/server/extract_refresh_alert.md -->

[Pular para o conteúdo principal](#main-content)

# Identificar alertas de atualização de extração

Quando o Tableau Server não puder concluir uma atualização agendada, um alerta é exibido para indicar que houve uma falha na atualização. Se uma atualização agendada falhar cinco vezes consecutivas, o Tableau Server a suspende. Quando uma atualização estiver suspensa, o Tableau Server não tenta executá-la novamente até que alguém tente corrigir a causa da falha.

**Observação:** o número de falhas consecutivas de uma atualização é definido como cinco por padrão, mas pode ser alterado por um administrador do Tableau Server, usando o comando `backgrounder.failure_threshold_for_run_prevention`. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

![Menu Alertas com três ícones relacionados.](/tableau/current/pt-br/server/pt-br/Img/maintenance_alerts.png)

Você só verá o menu Alertas se houver uma falha na atualização da extração e você estiver:

- Um administrador de sistema ou site.
- Não foi possível atualizar o autor da pasta de trabalho ou da fonte de dados.
- Não foi possível atualizar o autor de uma pasta de trabalho que se conecta a uma fonte de dados.

Ao abrir o menu Alertas, você pode ver mais informações sobre as falhas de atualização:

![Detalhes de um alerta de manutenção para uma fonte de dados desatualizada.](/tableau/current/pt-br/server/pt-br/Img/maintenance_alerts_details.png)

Quando uma Fonte de dados é listada como Inserida isso significa que a definição da fonte de dados (que inclui coisas como as credenciais da fonte de dados ou o nome do banco de dados) está inserida ou reside dentro da própria pasta de trabalho, criada originalmente no Tableau Desktop.

Quando o nome de uma fonte de dados ou de uma pasta de trabalho estiver listado como Fonte de dados (por exemplo, Fonte de dados: sales\_data), significa que ela é uma fonte de dados do Tableau Server. A definição da fonte de dados reside no Tableau Server.

No painel de Dados do Tableau Desktop, você pode determinar se a fonte de dados está no Tableau Server ou se é local. Se a fonte de dados estiver no servidor, um ícone do Tableau será exibido ao lado do nome da fonte de dados, em vez de um ícone do banco de dados:  

![Um menu com uma opção destacada para dados de população.](/tableau/current/pt-br/server/pt-br/Img/data_source_ts_icon.png)

## Resolvendo problemas na atualização da extração

Para solucionar os problemas de atualização, tome uma das seguintes ações, com base na causa indicada no alerta:

- **Erros relacionados à validação de token ou credenciais do usuário**
    
    Alguns problemas de atualização de extração podem ser solucionados clicando no alerta Detalhes de conexão. Marque a caixa de seleção perto da fonte de dados problemática, clique em Ações > Editar conexão e, em seguida, insira a informação ausente. Clique em Salvar quando terminar. Após você atualizar as informações de conexão, o Tableau Server reinicia a agenda de atualização.
    
    Se, ao publicar a pasta de trabalho ou fonte de dados por meio do Tableau Desktop, você originalmente incorporou as credenciais ou outras informações de conexão de dados , é possível republicar a pasta de trabalho ou fonte de dados. Como parte do processo de publicação, você pode optar por iniciar uma nova agenda de atualização. Se uma nova agenda não for escolhida, o Tableau Server reinicia a agenda existente.
- **Erros que indicam que o banco de dados estava inacessível**
    
    Confirme que o banco de dados está online e que você pode efetuar logon para acessar os dados. Você pode usar o link Tentar novamente no alerta para reiniciar a agenda de atualização.
- **Erros ao usar os filtros de usuário ou representação**
    
    Consulte a [Base de dados de conhecimento do Tableau](https://kb.tableau.com/articles/issue/extract-refresh-unsuccessful-when-using-user-filters?lang=pt-br).

Se o problema não puder ser corrigido editando-se a conexão de dados, você precisará resolvê-lo no Tableau Desktop e republicar a pasta de trabalho.

**Dica:** Os administradores podem editar as conexões de dados a qualquer momento na página Conexão de dados, acessível em cada site, clicando na guia Conteúdo e Conexão de dados.

<!-- document id=d4be547b5c0279086245cf49eab21fff0877cda3625aa2e38e419b5a24dd8e52 url=/tableau/current/pt-br/server/lang_intro.md -->

[Pular para o conteúdo principal](#main-content)

# Idioma e localidade do Tableau Server

O Tableau Server foi traduzido para vários idiomas. As configurações de idioma e localidade do servidor afetam os usuários. A definição de Idioma controla itens de UI (interface de usuário), como menus e mensagens. A definição de Localidade controla itens nas exibições, como formatação de número e moeda.

Os administradores podem configurar o idioma e a localidade com base em todo o servidor (consulte [](https://help.tableau.com/current/server/pt-br/maintenance_set.htm)[Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm) e os usuários individuais podem definir suas próprias configurações ([consulte Suas configurações de conta](https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm)) . Se um usuário configurar seu próprio idioma e localidade, suas configurações substituirão as do servidor.

## Idiomas compatíveis

O Tableau Server foi traduzido para vários idiomas. Consulte a seção "Internacionalização" da página [Especificação técnica do Tableau Server](https://www.tableau.com/pt-br/products/techspecs#server) para obter mais informações.

## Configurações padrão

O idioma padrão para Tableau Server é determinado durante a instalação. Se o computador host for configurado em um idioma que o Tableau Server suporta, o Tableau Server será instalado nesse idioma como padrão. Se o computador for configurado em um idioma que não é suportado, o Tableau Server será instalado em inglês como idioma padrão.

## Como o idioma e a localidade são determinados

Outra influência em que idioma e localidade são exibidos quando um usuário clica em uma exibição é o navegador da Web do usuário. Se um usuário do servidor não tiver especificado uma definição de Idioma na página Conta de usuário e o navegador da Web for definido para um idioma com suporte do Tableau Server, o idioma do navegador será usado, mesmo se o próprio Tableau Server estiver definido para um idioma diferente.

Vejamos um exemplo: Suponhamos que o Tableau Server tenha uma configuração que abranja todo o sistema definindo Inglês como o Idioma para todos os usuários. O usuário do servidor, Claude, não tem um idioma especificado na sua página Conta de usuário do Tableau Server. O navegador de Claude usa alemão (Alemanha) para seu idioma/localidade.

Quando o Claude entra no Tableau Server, a UI do servidor aparecerá em alemão. Quando ele clica em uma exibição, esta usa a localidade Alemanha para números e moeda. Se Claude tivesse definido Idioma e Localidade da sua conta de usuário para francês (França), a UI e a exibição teriam sido exibidas em francês. A definição da conta de usuário dele substitui as definições do navegador da Web e ambas têm preferência sobre a configuração de todo o sistema do Tableau Server.

Outra definição que precisa ser lembrada é a de Localidade no Tableau Desktop (Arquivo \> Localidade da pasta de trabalho). Essa definição determina a localidade dos dados na exibição, como qual moeda é listada ou como os números são formatados. Por padrão, Localidade no Tableau Desktop é definida como Automática. No entanto, um autor pode substituir isso selecionando uma localidade específica. Usando o exemplo acima, se o autor da Exibição A definisse Localidade para grego (Grécia), determinados aspectos dos dados na Exibição A seriam exibidos usando a localidade grego (Grécia).

O Tableau Server usa essas configurações, nesta ordem de precedência, para determinar o idioma e a localidade:

1. Localidade da pasta de trabalho (definida no Tableau Desktop)
2. Configurações de idioma/localidade da Conta de usuário do Tableau Server
3. Idioma/localidade do navegador da Web
4. Configurações de idioma/localidade da página Manutenção do Tableau Server
5. Configurações de idioma/localidade do computador host

<!-- document id=1d2580d7c828577eec7d26da1ae7c06ac71e30426c29536b981eb4ab2e402339 url=/tableau/current/pt-br/server/server-helm-deploy.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server Helm Chart - Implantação

**Importante**: esta documentação pressupõe um conhecimento do Helm e de Helm Charts e não tenta fornecer exemplos prescritivos detalhados. Ele foi criado para clientes que estão familiarizados com o Tableau Server e com o Helm e Helm Charts.

Este tópico orienta você nas etapas de alto nível de implantação do Tableau Server no Kubernetes usando um Helm Chart.

## Pré-requisitos

Antes de começar, verifique se os pré-requisitos foram atendidos. Para obter mais informações, consulte [Tableau Server Helm Chart - Pré-requisitos](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm).

### Download do Helm Chart

Os Helm Charts serão enviados como parte da ferramenta de configuração Tableau Server em um contêiner (`tableau-server-container-setup-tool-<version>.tar.gz`) e pode ser baixado na página [Download do Tableau Server](http://tableau.com/pt-br/support/releases/server/latest).

Após a extração, os arquivos dos Helm Charts necessários ficam em `helm/tableau` .

## Visão geral rápida sobre usar um Helm Chart para implantar o Tableau Server

**Importante**: esta é uma descrição básica e de alto nível da implantação do Tableau Server usando Helm Charts. Não se destina a representar um procedimento completo. Pressupõe conhecimento do Helm e dos Helm Charts.

Antes de começar, certifique-se de que você atendeu aos pré-requisitos para implantação do Tableau Server usando Helm Charts. Consulte [Tableau Server Helm Chart - Pré-requisitos](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm) para obter mais informações.

### Adicionar sua chave de licença a values.yaml

Edite `values.yaml` e defina sua chave de ativação de licença.

### Implantar o Tableau Server com um único nó

Implante uma instância com um único nó do Tableau Server executando esses comandos em um prompt (substitua o namespace da sua versão por `<namespace>`, por exemplo `tableau` ou `default`):

helm install tableau-server ./helm/tableau-server \\  
  -n <namespace> \\  
  --create-namespace \\
  -f ./helm/tableau-server/values-single.yaml

### Implantar o Tableau Server com múltiplos nós

Implante uma instância com múltiplos nós do Server executando esses comandos em um prompt e usando a mesma convenção de namespace como a que está acima:

helm install tableau-server ./helm/tableau-server \\  
\-n <namespace> \\  
\--create-namespace \\
-f ./helm/tableau-server/values-multinode.yaml

## Pasta de execução com múltiplos nós do EKS (namespace + PV de bootstrap estático)

Esta seção descreve a ordem de operações do EKS: namespace dedicado, complemento do CSI do EFS, IAM na função de nó, PV de bootstrap estático e Helm.

1. Crie um namespace dedicado.
    
    Deve corresponder a `claimFef.namespace` no PV de bootstrap. Este exemplo usa `tableau`.
    
    kubectl create namespace tableau-server
    kubectl get namespace tableau
2. Confirme se o complemento do CSI do EFS existe.
    
    Se o complemento estiver ausente, crie-o e aguarde até que o status seja `ACTIVE`:
    
    kubectl get csidriver efs.csi.aws.com
    aws eks describe-addon \\
      --cluster-name <cluster-name> \\  
      --addon-name aws-efs-csi-driver \\
      --region <region> \\
      --query 'addon.status'
3. Confirme a Storageclass:
    
    `efs-bootstrap` Storageclass — Execute se ainda não estiver instalado. Consulte [Pré-requisitos do Amazon Elastic Kubernetes Service (EKS)](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm#EKS-Prereq-storageclass) para obter mais informações.
    
    kubectl get csidriver efs.csi.aws.com
    aws eks describe-addon \\
      --cluster-name <cluster-name> \\  
      --addon-name aws-efs-csi-driver \\
      --region <region> \\
      --query 'addon.status'
4. Confirme o PV de bootstrap estático.
    
    `claimRef` deve referir-se ao mesmo namespace e nome de PVC que o Helm Chart cria (`tableau-server-bootstrap`). Substituir `fs-...` com o ID do sistema de arquivos EFS:
    
    cat > /tmp/tableau-bootstrap-pv.yaml <<'EOF'
    apiVersion: v1
    kind: PersistentVolume
    metadata:
      name: tableau-bootstrap-pv
    spec:
      capacity:
        storage: 1Gi
      volumeMode: Filesystem
      accessModes:
        - ReadWriteMany
    persistentVolumeReclaimPolicy: Retain
    storageClassName: efs-bootstrap
    claimRef:
      namespace: tableau
      name: tableau-server-bootstrap
    csi:
      driver: efs.csi.aws.com
      volumeHandle: <fs-xxxxxxxxxxxxxxxxx>
    EOF
    kubectl apply -f /tmp/tableau-bootstrap-pv.yaml
    kubectl get pv tableau-bootstrap-pv
5. IAM na função de instância do nó.
    
    Anexe o cliente EFS e as políticas somente leitura do EC2. Consulte [Pré-requisitos do Amazon Elastic Kubernetes Service (EKS)](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm#EKS-Prereq-storageclass) para saber mais sobre como resolver `<your-node-instance-role>` do grupo de nós.
    
    `efs-bootstrap` Storageclass — Execute se ainda não estiver instalado. Consulte [Pré-requisitos do Amazon Elastic Kubernetes Service (EKS)](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm#EKS-Prereq-storageclass) para obter mais informações.
    
    kubectl get csidriver efs.csi.aws.com
    aws eks describe-addon \\
      --cluster-name <cluster-name> \\  
      --addon-name aws-efs-csi-driver \\
      --region <region> \\
      --query 'addon.status'
6. Valores
    
    Em `values-multinode.yaml` (ou uma sobreposição), defina o modo do PV como estático manualmente
    
    persistence:
      bootstrap:  
        createPV: false  
        volumeName: tableau-bootstrap-pv  
        storageClass: efs-bootstrap
7. Garanta que `image.repository`, `image.tag` e os segredos/Licença estejam definidos conforme necessário.
8. Instalar o Helm Chart
    
    Instale o Helm Chart no mesmo namespace que o PV `claimRef`:
    
    helm install tableau-server ./helm/tableau-server \\
      -n tableau \\  
      -f ./helm/tableau-server/values-multinode.yaml
9. Verifique o armazenamento e os pods:
    
    kubectl get pv,pvc -n tableau
    kubectl get pods -n tableau -w
10. Status do PVC de dados
    
    PVCs de dados podem ser mostrar o status `Pending` rapidamente até que os volumes do EBS sejam anexados. Todos os PVCs devem fazer a transição para `Bound`, depois `Running` e, por fim, `READY 1/1`.
11. Topologia (opcional)
    
    Se o gancho pós-instalação estiver desabilitado, talvez seja necessário definir o nó `clustercontroller` e aplicar as alterações pendentes (consulte Automação da topologia pós-instalação (Gancho) posteriormente neste documento). O comando `tsm pending-changes apply` pode resultar em avisos sobre a distribuição do Index and Search Server ou o ensemble do Serviço de coordenação quando você tem vários nós do Tableau. Trate esses avisos conforme documentado em [Index and Search Server](https://help.tableau.com/current/server/pt-br/server_process_index-and-search.htm) e [Serviço de coordenação do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_coordination.htm).

### Instalação personalizada

1. Personalizar valores
    
    cp ./helm/tableau-server/values.yaml   
    ./helm/tableau-server/my-values.yaml  
    \# Edit ./helm/tableau-server/my-values.yaml with your configuration
2. Instalar com valores personalizados
    
    helm install tableau-server ./helm/tableau-server -f ./helm/tableau-server/my-values.yaml

## Configuração

### Modos de implantação

#### Implantação com um único nó

A implantação com um único nó executa o Tableau Server como um contêiner monolítico.

Use `values-single.yaml` ou defina:

deploymentMode: "single"  
primary:  
  replicaCount: 1  
worker:  
  replicaCount: 0

#### Implantação com múltiplos nós

A implantação de múltiplos nós executa um principal e um ou mais trabalhadores. Defina o número de trabalhadores com `worker.replicaCount` — Use 1, 2 ou qualquer valor superior permitido pela capacidade do cluster e pela topologia do Tableau. O gráfico cria `tableau-server-worker-0 … tableau-server-worker-(N-1)` para `replicaCount: N`.

Use `values-multinode.yaml` (o exemplo padrão usa dois trabalhadores) ou defina explicitamente:

deploymentMode: "multinode"  
primary:  
  replicaCount: 1  
worker:  
  replicaCount: 3    # example: three workers

Alinhamento de topologia: `values-multinode.yaml` envio com amostra `config.configJson` topologia (IDs de nós, como `node1`, `node2`, `node3`). Se você alterar `worker.replicaCount` ou reorganizar os serviços, atualize essa topologia (e quaisquer atribuições de processos do Tableau relacionadas) para que o número e as funções dos nós do TSM correspondam à sua implantação, consulte a ajuda do Tableau Server sobre clustering e layout de processos.

### Opções de configuração de chave

#### Configuração da imagem

image:  
  repository: tableau\_server\_image  
  tag: "latest"  
  pullPolicy: IfNotPresent  
  pullSecrets: \[\]

#### Licença e segredos

secrets:
  licenseKey: "YOUR-LICENSE-KEY"  
  tsmRemotePassword: "password"  
  tableauUsername: "admin"  
  tableauPassword: "password"

Como alternativa, você pode definir esses parâmetros usando variáveis de ambiente:

env:  
  LICENSE\_KEY: "YOUR-LICENSE-KEY"  
  TSM\_REMOTE\_PASSWORD: "password"  
  TABLEAU\_USERNAME: "admin"  
  TABLEAU\_PASSWORD: "password"

Recomendamos usar um arquivo separado (por exemplo, `secrets.yaml`) e passá-lo com o alternador `-f`.

`secrets.yaml`:

secrets:  
  licenseKey: "YOUR-LICENSE-KEY"  
  tsmRemotePassword: "YOUR-TSM-PASSWORD"  
  tableauUsername: "YOUR-ADMIN-USER"  
  tableauPassword: "YOUR-ADMIN-PASSWORD"

Exemplo de instalação/atualização com `secrets.yaml`:

helm upgrade --install tableau-server ./helm/tableau-server \\  
  -n default \\  
  -f ./helm/tableau-server/values-multinode.yaml \\  
  -f ./helm/tableau-server/secrets.yaml

**Observação:** fazer referência a um segredo do Kubernetes pré-existente (por exemplo, s`ecrets.existingSecret`) não é aceito no momento. O único método compatível é o uso de valores de Chart com um arquivo com valores de segredos separado.

#### Repositório PostgreSQL externo

O Helm Chart não habilita um repositório externo por padrão usando chaves de valores dedicadas.

Recomendamos que você siga estas etapas para habilitar um repositório externo:

1. Implante o Chart e confirme se o primário está intacto.
2. Executar os comandos `tsm external repository` do Tableau no pod primário.
3. Aplique as alterações pendentes.

Exemplo de fluxo de trabalho (descoberta de comandos e aplicação):

\# Discover command syntax for your Tableau version
kubectl exec -n default tableau-server-primary-0 -- sh -lc 'tsm topology external-services repository enable --help'  
\# After enabling external repository with Tableau-supported args/options:  
kubectl exec -n default tableau-server-primary-0 -- sh -lc 'tsm pending-changes apply -iw --ignore-prompt'  
kubectl exec -n default tableau-server-primary-0 -- sh -lc 'tsm status -v'

Observações:

- A configuração do repositório externo é específica para a versão do Tableau usada (modo SSL, opções de failover, campos de credenciais). Para obter mais informações, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo.htm) e a [tsm topology](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm).
- No caso de implantações de clientes, armazene credenciais de banco de dados em segredos do Kubernetes e evite usar texto simples no histórico do shell.

#### Armazenamento persistente

persistence:  
  enabled: true  
  storageClass: "standard"  
  accessMode: ReadWriteOnce  
  size: 100Gi  
  
  # Bootstrap volume (required for multi-node)  
  bootstrap:  
    enabled: true  
    storageClass: "standard"  
    accessMode: ReadWriteMany  
    size: 1Gi  
    createPV: false

Para clusters que usam CSI do EFS estático (por exemplo, com `mounttargetip`), o Helm pode gerenciar PV e o PVC de bootstrap:

persistence:  
  bootstrap:  
    enabled: true  
    storageClass: "efs-bootstrap"  
    accessMode: ReadWriteMany  
    size: 1Gi  
    createPV: true  
    permissionsFix:  
      enabled: true  
    pv:  
      name: "tableau-bootstrap-pv"  
      csi:  
        driver: efs.csi.aws.com  
        volumeHandle: "fs-xxxxxxxx"  
        volumeAttributes:  
          mounttargetip: "10.x.x.x"

`permissionsFix.enabled` adiciona um contêiner de init que `chown/chmods /docker/config/bootstrap` para que o processo do Tableau (UID/GID 999:998) possa gravar o `bootstrap.json` em montagens de EFS compartilhadas com o padrão `root:root`.

Quando `createPV: true`, o gráfico cria o PV de bootstrap com base em valores (por exemplo, `tableau-bootstrap-pv`) e vincula `tableau-server-bootstrap` a ele.

Se você gerencia o PV de bootstrap manualmente, crie `tableau-bootstrap-pv` primeiro e, em seguida, instale o Helm com `createPV: false` e `volumeName: tableau-bootstrap-pv:`

apiVersion: v1
kind: PersistentVolume
metadata:
  name: tableau-bootstrap-pv
spec:
  capacity:
    storage: 1Gi
  volumeMode: Filesystem
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  storageClassName: efs-bootstrap
  csi:
    driver: efs.csi.aws.com
    volumeHandle: fs-xxxxxxxx
    volumeAttributes:
      mounttargetip: 10.x.x.x

kubectl apply -f tableau-bootstrap-pv.yaml
kubectl get pv tableau-bootstrap-pv

#### Limites de recursos

primary:
  resources:
    limits:
      cpu: "4"
      memory: "8Gi"
    requests:
      cpu: "2"
      memory: "4Gi"

worker:
  resources:
    limits:
      cpu: "4"
      memory: "8Gi"
    requests:
      cpu: "2"
      memory: "4Gi"

#### Configuração de serviço

service:
  primary:
    type: ClusterIP  # or NodePort, LoadBalancer
    ports:
      http: 80
      https: 8080
      tsm: 8850

#### Entrada

ingress:
  enabled: true
  className: "nginx"
  hosts:
    - host: tableau.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: tableau-tls
      hosts:
        - tableau.example.com

#### Pasta de execução de configuração de entrada (exemplo: Controlador de entrada NGINX)

1. Instale um controlador de entrada no cluster (obrigatório antes de habilitar a entrada do Chart).
2. Defina os valores de entrada no arquivo de valores:
    
    ingress:  
      enabled: true  
      className: "nginx"  
      annotations:  
        nginx.ingress.kubernetes.io/proxy-body-size: "64m"  
        nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"  
        nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"  
      hosts:  
        - host: tableau.example.com  
          paths:  
            - path: /  
              pathType: Prefix  
      tls:  
        - secretName: tableau-tls  
          hosts:  
            - tableau.example.com
3. Crie o registro DNS apontando Tableau.example.com para seu endpoint de balanceador de entrada/carga.
4. Crie um segredo TLS (ou use cert-manager) no namespace da versão.
5. Gráfico de implantação/atualização e verifique a entrada:
    
    helm upgrade --install tableau-server ./helm/tableau-server -n default -f ./helm/tableau-server/values.yaml  
    kubectl get ingress -n default  
    kubectl describe ingress tableau-server

Para obter mais informações, consulte:

- [Conceito de entrada do Kubernetes](https://kubernetes.io/DCs/concepts/services-network/ingress)
- [Guia de implantação de ingress-nginx](https://kubernetes.github.io/ingress-nginx/deploy/)
- [Introdução ao cert-manager](https://cert-manager.io/docs/tutorials/getting-started-aks-letsencrypt/)

#### Verificações de integridade

O Chart oferece suporte a sondas de inicialização, atividade e prontidão. A investigação da inicialização permite uma inicialização longa (por exemplo, failedThreshold: 200 × PeriodSeconds) antes da execução de atividade/prontidão:

healthChecks:
  startup:
    enabled: true
    initialDelaySeconds: 300
    periodSeconds: 15
    timeoutSeconds: 30
    failureThreshold: 200
  liveness:
    enabled: true
    initialDelaySeconds: 300
    periodSeconds: 30
    timeoutSeconds: 10
    failureThreshold: 3
  readiness:
    enabled: true
    initialDelaySeconds: 300
    periodSeconds: 10
    timeoutSeconds: 5
    failureThreshold: 3

Para pods de trabalho com múltiplos nós, o Chart usa o padrão `worker.healthChecks.enabled: false` para evitar falhas de investigação falsa quando os trabalhadores executam conjuntos de processos limitados (por exemplo, agente de administração + controlador de cluster somente).

### Uso

#### Acessar o Tableau Server

Após a instalação, acesse o Tableau Server com base na configuração do seu serviço:

- **ClusterIP**: usar encaminhamento de porta ou entrada
- **NodePort**: acesso via `<node-ip>:<node-port>`
- **Load Balancer**: acesso via IP externo fornecido

#### Usar comandos TSM

\# Get pod name
POD\_NAME=$(kubectl get pods -l app.kubernetes.io/component=primary -o jsonpath='{.items\[0\].metadata.name}')

# Run tabcmd
kubectl exec -it $POD\_NAME -- tsm status
kubectl exec -it $POD\_NAME -- tsm configuration get

#### Usar o tabcmd

\# Get pod name
POD\_NAME=$(kubectl get pods -l app.kubernetes.io/component=primary -o jsonpath='{.items\[0\].metadata.name}')

# Run tabcmd
kubectl exec -it $POD\_NAME -- tabcmd login -u admin -p password
kubectl exec -it $POD\_NAME -- tabcmd sites

#### Visualizar logs do Tableau Server

\# Primary node logs
kubectl logs -l app.kubernetes.io/component=primary -f

# Worker node logs (multi-node)
kubectl logs -l app.kubernetes.io/component=worker -f

# All logs
kubectl logs -l app.kubernetes.io/instance=tableau-server -f

#### Acesso via shell

\# Get pod name
POD\_NAME=$(kubectl get pods -l app.kubernetes.io/component=primary -o jsonpath='{.items\[0\].metadata.name}')

# Open shell
kubectl exec -it $POD\_NAME -- /bin/bash

### Atualizar

#### Atualizar o Helm Chart do Tableau Server

helm upgrade tableau-server ./helm/tableau-server -f ./helm/tableau-server/values.yaml

#### Atualizar com novos valores

helm upgrade tableau-server ./helm/tableau-server -f ./helm/tableau-server/new-values.yaml

### Automação de topologia pós-instalação (hook)

Para instalações com múltiplos nós, este Chart pode executar uma tarefa de hook pós-instalação/pós-atualização que:

- aguarda que os nós trabalhadores se registrem no TSM
- define a atribuição de processo do trabalhador `clustercontroller`
- executa `tsm pending-changes apply -iw --ignore-prompt` quando alterações estão pendentes

Configuração:

hooks:
  autoApplyWorkerTopology:
    enabled: true
    kubectlImage: "bitnami/kubectl:latest"
    timeoutSeconds: 3600

Padrões:

- Desabilitado em `values.yaml`
- em `values-multinode.yaml`, verifique `hooks.autoApplyWorkerTopology.enabled` (pode ser `true` ou `false` dependendo da versão; habilitar para a configuração `clustercontroller` de trabalhador não manipulado)

Verifique a execução do hook:

kubectl get jobs -n default
kubectl get pods -n default -l job-name=tableau-server-hook-topology
kubectl logs -n default job/tableau-server-hook-topology

Fallback manual se o hook estiver desabilitado ou falhar; executar `tsm topology set-process` para cada nó do TSM trabalhador (normalmente node2 até node(1+N) quando você tem N trabalhadores; confirme os IDs usando `tsm topology list-nodes -v`):

kubectl exec -n default tableau-server-primary-0 -- sh -lc '
tsm topology set-process -n node2 -pr clustercontroller -c 1
tsm topology set-process -n node3 -pr clustercontroller -c 1
# Add one line per additional worker node, e.g. for four workers:
# tsm topology set-process -n node4 -pr clustercontroller -c 1
# tsm topology set-process -n node5 -pr clustercontroller -c 1
tsm pending-changes apply -iw --ignore-prompt
tsm topology list-nodes -v

tsm status -v

**Nota:** não use `-iw` ou `tsm pending-changes apply`. A opção `-ig` não é válida neste ambiente.

### Desinstalação

helm uninstall tableau-server

**Aviso**: isso excluirá todos os recursos, incluindo os volumes persistentes. Certifique-se de fazer backup dos dados antes de desinstalar.

#### Etapas de validação

Antes do lançamento ou ao alterar o Chart, execute:

1. Lint:
    
    helm lint helm/tableau-server -f helm/tableau-server/values-single.yaml  
    helm lint helm/tableau-server -f helm/tableau-server/values-multinode.yaml
2. Modelo (exemplo):
    
    helm template tableau-server helm/tableau-server -f helm/tableau-server/values-single.yaml  
    helm template tableau-server helm/tableau-server -f helm/tableau-server/values-multinode.yaml
3. Teste de instalação (opcional):
    
    1. Em um namespace de teste, execute `helm install` com values-single ou values-multinode..
    2. Execute `kubectl rollout status` (para StatisticalSet, aguarde o pod Pronto) e verificações básicas de ativação (por exemplo, `tsm status` ou HTTP para o serviço).

Para uma solução de problemas detalhada, consulte [Tableau Server Helm Chart - Solução de problemas](https://help.tableau.com/current/server/pt-br/server-helm-troubleshooting.htm).

## Recursos adicionais

- [Documentação do Tableau Server](https://help.tableau.com/current/server-linux/en-us/)
- [Documentação do Helm](https://helm.sh/docs/)
- [Atualização do Helm Chart](https://helm.sh/docs/helm/helm_upgrade/)

<!-- document id=771a296e4246dfd32b73dee9faaed1dbf5ad0e4c73dd72323883617ab8912ca3 url=/tableau/current/pt-br/server/install.md -->

[Pular para o conteúdo principal](#main-content)

# Implantar

Os tópicos desta seção disponibilizam informações sobre como instalar, configurar e atualizar o Tableau Server no Windows.

Procurando o Tableau Server no Linux? Consulte [Instalar e configurar o Tableau Server](https://help.tableau.com/current/server-linux/pt-br/install.htm "Abre o tópico em uma nova guia do navegador").

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Outros artigos nesta seção

<!-- document id=bdf8c623a60089bcc60a8990dfe275708627a64ee16cd4bf50b1ad82bd4368b4 url=/tableau/current/pt-br/server/distrib_ha_zk.md -->

[Pular para o conteúdo principal](#main-content)

# Implantar um ensemble do Serviço de coordenação

O Serviço de coordenação é criado no [Apache ZooKeeper](https://cwiki.apache.org/confluence/display/ZOOKEEPER/Index), um projeto de código-fonte aberto, e coordena atividades no servidor, garantindo quorum no caso de falha e servindo como a fonte do "truth" relacionada à topologia, a configuração e o estado do servidor. O serviço é instalado automaticamente no nó inicial do Tableau Server, mas nenhuma instância adicional é instalada ao adicionar outros nós. Como o funcionamento bem-sucedido do Tableau Server depende que o Serviço de coordenação funcione adequadamente, recomendamos que, para instalações de servidor de três ou mais nós, você adicione instâncias adicionais do Serviço de coordenação ao implantar um novo ensemble do Serviço de coordenação. Isso oferece redundância e disponibilidade aprimorada caso essa instância apresente problemas.

- [Requisitos de hardware](#HardwareReqs)
- [O quórum do Serviço de coordenação](#ZKquorum)
- [Implantar um novo ensemble do Serviço de coordenação](#DeployZKEnsemble)

## Requisitos de hardware

O hardware usado para executar o Tableau Server pode afetar o modo de execução do Serviço de coordenação. Em particular:

- **Memória**. O Serviço de coordenação mantém as informações de estado na memória. Originalmente, o consumo da memória é pequeno, não sendo um fator no desempenho geral do servidor.
- **Velocidade do disco**. Devido ao armazenamento de informações de estado no disco, o serviço aproveita a velocidade rápida do disco nos computadores de nó individual.
- **Velocidade de conexão** entre os nós. O serviço comunica-se continuamente entre nós de cluster; uma velocidade rápida de conexão entre os nós fornece uma sincronização mais eficiente.

Como o Serviço de coordenação é repleto de E/S, se estiver executando o Tableau Server em computadores que correspondem aos ou excedem os requisitos mínimos de hardware, é interessante configurar um ensemble do Serviço de coordenação que coloca o serviço em nós não utilizados por outro processo de servidor. Isso reduz a chance de atrasos devido à conflito de E/S entre processos de servidor. Para obter informações sobre como implantar um ensemble em nós exclusivos do Serviço de coordenação dedicados, consulte [Configurar o Tableau Server para alta disponibilidade com nós exclusivos do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_external_zk.htm).

## O quórum do Serviço de coordenação

Para garantir que o Serviço de coordenação funcione adequadamente, o serviço requer um _quorum_, um número mínimo de instâncias do serviço. Isso significa que o número de nós em sua instalação afeta a quantidade de instâncias do Serviço de coordenação que precisarão ser configuradas em seu ensemble.

#### Número de instâncias do Serviço de coordenação a serem usadas

O número máximo de instâncias do Serviço de coordenação permitidas em um ensemble no Tableau Server depende de quantos nós do Tableau Server existem em sua implantação. Configurar um ensemble do Serviço de coordenação com base nestas diretrizes:

| Número total de nós do servidor | Número recomendado de nós do Serviço de Coordenação no ensemble (deve ser 1, 3 ou 5) | Observações |
| --- | --- | --- |
| 1 a 2 nós | 1 nó | Esse é o padrão e não requer alterações, a não ser que deseje mover o Serviço de coordenação do nó inicial para um nó adicional. |
| 3 a 4 nós | 3 nós | Um conjunto de Serviço de coordenação de 3 nós permite que um dos nós do conjunto falhe sem causar a falha do Tableau Server. |
| 5 ou mais nós | 3 nós  
ou 5 nós | O número máximo de instâncias do Serviço de coordenação que você pode instalar é cinco. Um conjunto de Serviço de coordenação de 3 nós permite que um dos nós do conjunto falhe sem causar a falha do Tableau Server. Um conjunto de 5 nós permite que dois nós do conjunto falhe sem causar a falha do Tableau Server.  
  
Para a maioria das instalações, três nós do Serviço de Coordenação são adequados, e devido à natureza de E/S intensa do Serviço de coordenação, essa é a configuração mais performática.  
  
Se a alta disponibilidade for sua prioridade absoluta, você pode querer considerar a implantação de um conjunto de Serviço de coordenação de 5 nós. Isso fornece a maior redundância no caso de um ou mais nós falharem, mas exigirá mais recursos do sistema. Um máximo de dois nós do conjunto pode falhar sem afetar o Tableau Server (desde que outros serviços no nó também existam em nós ainda em funcionamento).  
  
Para reduzir o impacto no desempenho, localize o Serviço de Coordenação em nós que estão executando menos os outros serviços ou considere usar nós somente de Serviço de Coordenação. Para obter detalhes, consulte [Configurar o Tableau Server para alta disponibilidade com nós exclusivos do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_external_zk.htm). |

## Implantar um novo ensemble do Serviço de coordenação

Se instalar um total de três ou mais nós, implante também um ensemble do Serviço de coordenação. Se não fizer isso, receberá uma mensagem de aviso sempre que fizer alterações na configuração ou na topologia do servidor. É possível ignorar esta mensagem, mas, como uma prática recomendada, você deve implantar um ensemble do Serviço de coordenação para vários nós.

Ao instalar o Tableau Server, uma única instância do Serviço de coordenação é instalada no nó inicial. O TSM e o Tableau Server dependem do Serviço de coordenação para funcionarem adequadamente. Sendo assim, de forma a fornecer redundância e garantir disponibilidade nas instalações de vários nós, configure instâncias adicionais do Serviço de coordenação ao implantar um ensemble do Serviço de coordenação. Os ensembles do Serviço de coordenação estão instalados com uma, três ou cinco instâncias do Serviço de coordenação. Em uma instalação de três nós do Tableau Server, o número recomendado de instâncias do Serviço de coordenação é três: um em cada nó.

Não tente implantar um ensemble do Serviço de coordenação se houver outras mudanças pendentes. Descarte ou aplique quaisquer alterações pendentes antes de implantar um novo ensemble do Serviço de coordenação.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

As etapas a seguir mostram como implantar um novo ensemble do Serviço de coordenação em um cluster de três nós do Tableau Server já existente, assim como limpar o ensemble antigo.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Interrompa o Tableau Server:
    
    `tsm stop`
    
    Se solicitado, faça logon como administrador do TSM.
    
    Alguns processos do TSM permanecerão em execução, inclusive o Controlador de administração e o Agente de administração.
3. Confirme que não há alterações pendentes:
    
    `tsm pending-changes list`
    
    Se houver alterações pendentes, você precisará descartá-las ou aplicá-las. A aplicação de alterações pendentes levará algum tempo:
    
    - Descartar as alterações
        
        tsm pending-changes discard
    
    ou
    
    - Aplique as alterações:
        
        tsm pending-changes apply
    
    Aguarde até que o comando seja concluído e você retorne ao prompt do sistema.
4. Obtenha as IDs de cada nó no cluster:
    
    `tsm topology list-nodes -v`
5. Use o comando `tsm topology deploy-coordination-service` para adicionar um novo ensemble do Serviço de coordenação ao adicioná-lo a nós específicos. Você deve especificar o(s) nó(s) ao(s) qual(is) o Serviço de Coordenação deve ser adicionado, usando a ID do nó real para identificar cada nó. O comando também torna o ensemble de “produção” (o ensemble em uso) no ensemble novo e remove o antigo, a menos que a implantação falhe. Se isso acontecer, veja a etapa 6 abaixo.
    
    **Observação:**um prompt "y/n” é exibido, confirmando que uma reinicialização do servidor ocorrerá. Para executar o comando sem entrada, inclua a opção `--ignore-prompt`.
    
    Por exemplo, implante o Serviço de coordenação em todos os nós de um cluster de três nós, sendo eles: nó1, nó2, nó3
    
    `tsm topology deploy-coordination-service -n node1,node2,node3`
    
    Aguarde até que o comando seja concluído e você retorne ao prompt do sistema.
6. (Opcional) Se a implantação falhar, você precisa executar o comando `tsm topology cleanup-coordination-service` para remover o conjunto implantado sem sucesso. Para obter detalhes sobre a execução do comando, consulte [tsm topology cleanup-coordination-service](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMCleanupCoordination).
7. Inicie o Tableau Server:
    
    `tsm start`

<!-- document id=a6c5c83905f8d741b5c08e97618a6b8c5e3558b0eb83a7ad55935ce6b1c8d0f0 url=/tableau/current/pt-br/server/users_import.md -->

[Pular para o conteúdo principal](#main-content)

# Importar usuários

Para automatizar o processo de adição de usuários a um site, você pode criar um arquivo CSV que contenha as informações do usuário e, em seguida, importar o arquivo.

Administradores do site ou um usuário com um perfil de administrador com permissões suficientes podem importar usuários para um site específico; administradores do servidor (somente Tableau Server) podem importar usuários no nível do servidor para adicioná-los posteriormente a vários sites.

**Observação:**Este tópico contém etapas para importação, pressupondo que você já tenha criado o arquivo CSV. Se você ainda não tiver criado o arquiv, consulte [Diretrizes do arquivo de importação CSV](https://help.tableau.com/current/server/pt-br/csvguidelines.htm) para obter uma lista de requisitos de formato de arquivo e opções de importação.

## Adicionar usuários por um arquivo CSV

As etapas a seguir descrevem como adicionar usuários a um site ou ao servidor. As imagens mostram a adição de usuários no nível do site.

1. Execute um destes procedimentos:
    
    - Para adicionar usuários no nível do site, selecione Usuários e Adicionar usuários.
        
        ![Botão Adicionar usuários selecionado para revelar opções para adicionar usuários ao site, com a opção Importar do arquivo selecionada.](/tableau/current/pt-br/server/pt-br/Img/import_users_csv.png)
    - Para adicionar usuários no nível do servidor em um servidor de **site único**, selecione Usuários e Adicionar usuários.
    - Para adicionar usuários no nível do servidor em um servidor de **vários sites**, abra a lista de sites e selecione Gerenciar todos os sites. Selecione Usuários e Adicionar usuários.
2. Clique em Importar usuários do arquivo, em seguida, em Procurar e navegue até o arquivo e depois clique em Importar usuários.
    
    ![Uma caixa de diálogo para importar usuários de um arquivo.](/tableau/current/pt-br/server/pt-br/Img/users_import_local.png)
    
    O Tableau exibe os resultados do processo de importação.
    
    ![Caixa de diálogo de sucesso da importação de usuários.](/tableau/current/pt-br/server/pt-br/Img/users_import_local2.png)
3. Clique em Concluído.

## Como as funções de site de usuários são atribuídas ou mantidas

Ao importar no nível de site ou em um servidor de site único por meio do `tabcmd`, é possível especificar a função no site de todos os usuários no arquivo CSV. Se um usuário já existir no site do Tableau Server, a função de site atribuída durante o processo de importação será aplicada, mesmo que seja mais restritiva do que a função de site existente dos usuários. A exceção é que você não pode afetar a função de site de um administrador do servidor.

Em um servidor de vários sites, ao importar usuários na página Usuários do servidor, cria usuários de servidor sem afiliação de site. Como esses usuários não pertencem a um site, eles não podem ter uma função de site. A única função de site que um usuário pode ter no nível do servidor é Não licenciado ou Administrador de servidor.

Também é possível especificar a função no site do usuário ao atribuir uma associação a sites a um usuário. Para obter informações, consulte [Gerenciar a associação de usuários ao site](https://help.tableau.com/current/server/pt-br/users_view.htm#manage-site-membership).

## Importação no nível de servidor em ambientes de vários sites

Se o servidor estiver executando vários sites e você for um administrador de servidor, será possível importar um arquivo CSV de dois locais. Em relaçã a contas de usuários existentes, cada localização tem recursos diferentes.

- A página Usuários de servidor aparece em um ambiente de vários sites. Somente os administradores do servidor podem acessar essa página.
    
    ![Uma tabela de usuários do servidor, incluindo seus nomes de exibição, nomes de usuários, funções do site, número de grupos e últimas datas de login.](/tableau/current/pt-br/server/pt-br/Img/usersimport_srvrusers.png)
    
    Você pode importar arquivos CSV daqui, se deseja atualizar as contas de usuário existentes, além de adicionar novas contas. Por exemplo, se você importar um arquivo que tenha uma nova senha para cada usuário existente, suas senhas serão redefinidas.
- A página Usuários do site.
    
    ![Uma tabela de usuários do site, incluindo seus nomes de exibição, nomes de usuário, funções no site, número de grupos e datas do último login.](/tableau/current/pt-br/server/pt-br/Img/usersimport_siteusers.png)
    
    Os administradores de servidor podem adicionar novas contas de usuário com as importações de CSV. Se o arquivo CSV incluir usuários existentes, os campos Senha e Nome de exibição devem coincidir com os existentes ou devem ficar em branco. Se novas senhas ou nomes completos forem usados, haverá falha na importação.

## Importação para um ambiente de site único

Administradores de servidor e site em um servidor de site único realizam importações de usuários de um CSV na página Usuários de um site.

![Uma tabela que lista os usuários do site, seus nomes de usuário, funções, número de grupos e última data de login.](/tableau/current/pt-br/server/pt-br/Img/userimport_ss_users.png)

## Importação de vários sites versus de único site

Os usuários podem pertencer a mais de um site no mesmo servidor, mas devem usar as mesmas credenciais para cada site. Isso torna-se importante ao adicionar usuários em um site e eles já pertencerem a um site diferente. Se você tentar importar um usuário já existente e se as credenciais do usuário no arquivo CSV não corresponderem às credenciais existentes, haverá uma falha na importação desse usuário.

Se, ao importar usuários para um site, achar que eles já existem no servidor, é possível tentar deixar o campo **Senha** em branco no arquivo CSV (ao incluir os delimitadores do campo). Se um usuário definido no CSV já existir em outro site, o usuário será adicionado ao site que estiver recebendo a importação. No entanto, se o usuário ainda _não_ existir no servidor, ele será criado e a janela de importação do CSV alertará que o novo usuário não tem uma senha. Depois, é possível usar as páginas do administrador de servidor para atribuir uma senha a qualquer usuário que ainda não tenha uma.

**Observação**: se o servidor está configurado para usar o Active Directory para autenticação, as senhas dos usuários são gerenciadas pelo Active Directory e é possível deixar o campo de senha em branco no arquivo CSV.

<!-- document id=2802e409275b6443bdd4f89676c5521c25d402944b3967b717f3a490ec4629d1 url=/tableau/current/pt-br/server/rmt-incidents-agents-unlicensed.md -->

[Pular para o conteúdo principal](#main-content)

# Incidentes de agente

[Agentes não licenciados](#Agents) (crítico)

[Versão do Agente incompatível](#Incompat) (crítica)

[Falha na rotação da credencial da fila de mensagens do agente](#MQCredFail) (crítica)

[Agente inativo](#Agent) (aviso)

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## Agentes não licenciados

Os incidentes de _agents não licenciados_ serão registrados como críticos ao detectar que o Tableau Server não foi devidamente licenciado para usar o Resource Monitoring Tool do Tableau.

Para monitorar o Tableau Server usando o Resource Monitoring Tool, o Tableau Server deve ser licenciado com o Advanced Management do Tableau.

No estado não licenciado, os agentes deixam de coletar dados e enviar ao RMT Server. No entanto, você pode continuar vendo os dados coletados anteriormente quando o ambiente estava devidamente licenciado.

Para solucionar esse problema, licencie o Tableau Server com Advanced Management. Para obter mais informações, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

**Observação:** pode levar até uma hora depois de adicionar uma licença válida ao Tableau Server para que o incidente seja liberado.

Há outras causas possíveis que podem causar um incidente **Agents Unlicensed**:

- As credenciais da API do Tableau Server podem não estar corretas. Na página de configuração do ambiente, verifique se o nome de usuário e a senha estão corretos e que a conta utilizada tem a função Administrador de servidor no Tableau Server.
- Não é possível se conectar à API REST do Tableau Server. Certifique-se de que a API REST está habilitada no Tableau Server e que o Tableau Server está em execução.
    
    Para solucionar o problema de conectividade da AP RESTI, no menu **Admin**, selecione **Environments**, clique em **Edit Environment** no ambiente que deseja modificar e, na guia **Environment Details**, clique no botão **Test Connection** da seção **Tableau Server REST API** do lado direito da página.
- O RMT Server não conseguiu se conectar ao Tableau Server, provavelmente devido a uma conectividade de rede ou problema semelhante.

## Versão do Agente incompatível

Incidentes incompatíveis de Agente serão registrados como críticos quando um ou mais Agentes no ambiente estiverem em uma versão que não é compatível com a versão do RMT Server.

Para resolver o problema, você precisa ter certeza de que o Agente está em uma versão compatível com a versão atual do RMT Server.

Utilize uma das seguintes de solução de problemas para resolver isso:

- Recomendamos que o RMT Server e todos os Agentes estejam na mesma versão.

- Se o Agente estiver em uma versão anterior à versão mínima compatível, você deverá atualizá-lo para pelo menos a versão mínima compatível listada no relatório de incidente.
- Se o agente estiver em uma versão posterior à versão do RMT Server, recomendamos que você atualize o RMT Server para a mesma versão posterior também. Pode ser necessário atualizar outros Agentes, dependendo da versão em que eles estão atualmente.

### Atualização dos Agentes:

Use as etapas a seguir para atualizar o Agente:

1. Baixe o programa de instalação do Agente e copie-o para o nó do Tableau Server onde o Agente precisa ser atualizado. O Agente deve estar na mesma versão do RMT Server ou usar uma versão compatível com a versão do RMT Server. Os detalhes do incidente fornecem a versão mínima compatível.
2. Pare o serviço do Agente do Resource Monitoring Tool do Tableau em todos os nós do Tableau Server usando o seguinte comando:
    
    `rmtadmin stop --agent`
3. Execute o programa de configuração do Agente que precisa ser atualizado.
    
    **Observação:** se estiver usando um local não padrão, forneça o local de instalação personalizado clicando na página **Customize** do EULA. O Tableau recomenda usar _\\Tableau\\Tableau Resource Monitoring Tool_ como o local de instalação do Agente. Exemplo de local não padrão: **D:\\Tableau\\Tableau Resource Monitoring Tool**.
4. Confirme se o Agente está em execução e foi atualizado. Você pode exibir o status de registro do Agente navegando até a guia **Admin** -> **Ambientes** -> **Editar o ambiente** -> **servidores** para ver uma lista completa de nós do Tableau Server e o status do Agente.

### Atualização do RMT Server

Atualize o RMT Server se um ou mais Agentes estiverem em uma versão posterior.

Use as etapas a seguir para atualizar o RMT Server:

1. Faça logon no Resource Monitoring Tool no navegador e confirme se está funcionando, antes de iniciar a atualização.
2. Copie o programa de configuração do RMT Server para a máquina onde o RMT Server está instalado.
3. Interrompa o serviço **Agente** do Windows do Resource Monitoring Tool do Tableau em todos os Agentes.
4. Interrompa o serviço do Windows do Resource Monitoring Tool do Tableau no RMT Server.
    
    **Observação:** depois que os serviços forem interrompidos, é recomendável verificar se os processos da Resource Monitoring Tool estão em execução: qualquer um com tabrmt-agent ou tabrmt-master. Isto não inclui PostgreSQL ou RabbitMQ.
5. Pode levar um certo tempo para interromper totalmente todos os processos em execução no RMT Server, por isso, no Gerenciador de Tarefas, aguarde até que não haja processos em execução com Resource Monitoring Tool no nome antes da próxima etapa.
6. Execute o programa de configuração no RMT Server. Isso instala ou atualiza os pré-requisitos necessários e, em seguida, atualiza o RMT Server.
    
    **Observação:** se estiver usando um local não padrão, forneça o local de instalação personalizado clicando na página **Customize** do EULA. O Tableau recomenda usar _\\Tableau\\Tableau Resource Monitoring Tool_ como o local de instalação do RMT Server. Exemplo de local não padrão: **D:\\Tableau\\Tableau Resource Monitoring Tool**.
7. Confirme se os serviços Agente e RMT Server estão em execução. Inicie os serviços Agente e RMT Server se não reiniciarem automaticamente após a conclusão da atualização.

## Falha na rotação da credencial da fila de mensagens do agente

A partir da versão 2021.3, como prática recomendada de segurança, as credenciais para conexões entre o Agente e o Rabbit MQ devem ser exclusivas para esse Agente. As credenciais exclusivas são criadas durante uma nova instalação ou atualizadas ao fazer upgrade para 2021.3.

Durante a atualização, se houver problemas de rede, o processo de atualização de credenciais pode falhar, resultando em um relatório de incidente crítico. Isso, no entanto, não interrompe o processo de atualização e o processo de atualização continuará. Depois que a atualização for concluída, a Resource Monitoring Tool tentará novamente diariamente para criar as credenciais exclusivas. Um relatório de incidente crítico é criado para a falha inicial e todas as tentativas subsequentes com falha. Durante esse tempo, o Agente continuará a trabalhar usando as credenciais anteriores até que novas credenciais sejam criadas.

O problema pode ser resolvido sozinho, mas se persistir, faça o seguinte:

- Verifique se os agentes podem se conectar ao RMT Server.
- Verifique se há problemas de firewall entre o Agente e o RMT Server.

## Agente inativo

Os incidentes Agente inativo serão registrados como avisos quando o Resource Monitoring Tool do Tableau não puder se comunicar com os Agentes do Tableau Server.

Utilize as seguintes etapas de solução de problemas:

1. Certifique-se de que o hardware que hospeda os Agentes esteja em execução e disponível para se comunicar com o RMT Server.
2. Certifique-se de que o serviço do Agente foi registrado com êxito e está em execução. Você pode exibir o status de registro do Agente navegando até a guia **Admin** -> **Ambientes** -> **Editar o ambiente** -> **servidores** para ver uma lista completa de nós do Tableau Server e o status do Agente.

### Sondagem de agente e tempos de criação de incidentes

- O agente envia uma _mensagem de heartbeat_ para o servidor do Resource Monitoring Tool a cada 5 minutos.
- O servidor do Resource Monitoring Tool verifica se a _mensagem de heartbeat_ mais recente do Agente tem menos de 15 minutos.
    
    - Se a última _mensagem de heartbeat_ recebida do Agente tiver menos de 15 minutos, o Agente será considerado online e nenhum incidente será criado, e todos os incidentes de **Agente Inativo** existentes serão apagados.
    - Se a última _mensagem de heartbeat_ recebida do Agente tiver mais de 15 minutos, será considerada a primeira tentativa com falha. A cada minuto depois disso, uma verificação é feita mais duas vezes. Se após três tentativas (primeira tentativa e duas tentativas) ainda não houver nenhuma mensagem de heartbeat recente, será criado um incidente **Agente Inativo.**
    
    **Observação:** com base no intervalo de sondagem descrito acima, leva cerca de 17 (15+1+1) minutos para que um incidente de **inatividade do agente** seja criado depois que o agente estiver offline.

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=7a1c297e1cbebe4a0e10d4efbc064309870975ba734b962499ddd0b424436613 url=/tableau/current/pt-br/server/rmt-incidents-hyper-spooling.md -->

[Pular para o conteúdo principal](#main-content)

# Incidentes de Hyper Spooling

Os incidentes do _Spooling do Hyper_ serão registrados como um aviso quando as consultas Hyper forem colocadas em spool no disco. Normalmente, isso acontece quando não há memória disponível suficiente e o processo do Processador de dados do Tableau Server muda para spool gravando temporariamente no disco. O tópico do [Processador de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_engine2_intro.htm) descreve isso com mais detalhes na seção de uso de memória.

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=35dd09d7963e10c0a8e687bd06654de44397057e7815b63fb5e82e57100ec0b1 url=/tableau/current/pt-br/server/server_process_index-and-search.md -->

[Pular para o conteúdo principal](#main-content)

# Index and Search Server

O processo do Index and Search Server do Tableau Server, baseado no OpenSearch, lida com pesquisa, filtro, recuperação e exibição rápidas de metadados de conteúdo em seu site do Tableau Server. A partir da versão 2023.3 do Tableau Server, o Index and Search Server substitui completamente o processo de pesquisa e navegação.

## Configuração do servidor

O Index and Search Server é instalado automaticamente no nó inicial.

### Configuração em vários nós

Para configurar o Index and Search Server para alta disponibilidade, configure o processo em vários nós. Recomendamos que você configure um número ímpar de instâncias do Index and Search Server. Em clusters do Tableau Server com 3 ou mais nós, você deve configurar o Index and Search Server em pelo menos três nós diferentes.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Index and Search Server</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do   Index and Search Server é visível na Página de status e pode ser acessado usando a CLI TSM para visualizar. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Registros gerados por  Index and Search Server  são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>indexandsearchserver</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

**O que acontece quando o Index and Search Server falha?**

Se o Index and Search Server falhar, os usuários ainda poderão fazer logon no Tableau Server, mas os diferentes tipos de conteúdo (pastas de trabalho, projetos, fontes de dados e exibições, por exemplo) não aparecerão na página inicial, na barra de pesquisa ou na página Explorar. As pastas de trabalho e visualizações existentes ainda devem estar acessíveis e totalmente funcionais se acessadas em uma URL marcada. O conteúdo não está realmente ausente. Em vez disso, o conteúdo não está sendo retornado nos resultados da pesquisa; ele será exibido novamente após a reinicialização do Index and Search Server. Um Index and Search Server é reiniciado automaticamente; desde que o computador não tenha problemas, o serviço será reiniciado.

Se mais de um Index and Search Server estiver configurado e em execução em vários nós quando a falha ocorrer, as solicitações feitas a um Index and Search Server com falha também falharão, mas as solicitações subsequentes serão roteadas para instâncias funcionais do Index and Search Server. Cada instância do Index and Search Server indexa todos os nós do cluster, portanto, enquanto uma instância do Index and Search Server estiver em execução, os resultados ainda serão retornados em todos os nós.

## Ajuste de desempenho

O tamanho da pilha do Index and Search Server pode ser configurado usando o comando `tsm set configuration` com a opção `indexandsearchserver.vmopts`. Para obter mais informações, consulte [indexandsearchserver.vmopts](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#indexandsearchserver)

## Reindexação

Durante a restauração, o processo de restauração iniciará uma reindexação completa do conteúdo e dos ativos externos gerenciados pelo Tableau Server. O processo de reindexação consome recursos de CPU que podem ser perceptíveis durante o backup e restauração.

<!-- document id=595fc1beeec0ac4edb27baa4f03fa9423d774e6f4122fc2cc576abff365d0124 url=/tableau/current/pt-br/server/qs_refresh_extracts.md -->

[Pular para o conteúdo principal](#main-content)

# Início rápido: atualizar extrações em cronograma

Em pastas de trabalho publicadas que se conectam a extrações de dados, você pode configurar o servidor para atualizar as extrações em uma agenda recorrente, para que todas as pastas de trabalho conectadas a essas extrações sempre mostrem os dados mais atualizados.

Para agendar atualizações, é necessário ter permissões de administrador ou proprietário dos dados.

**Observação:** este tópico aplica-se a extrações publicadas no Tableau Server. No Tableau Cloud, a forma de atualização de extrações depende dos dados subjacentes aos quais elas se conectam. Para obter mais informações, consulte [Manter dados atualizados](https://help.tableau.com/current/online/pt-br/to_keep_data_fresh.htm).

## 1 Programar um agendamento no servidor

Entre no servidor, vá até a página Agendas e clique em **Nova agenda**.

![Liste todas as atualizações de extração agendadas.](/tableau/current/pt-br/server/pt-br/Img/refresh_extracts1.png)

O Tableau fornece algumas agendas de atualização. Crie as agendas adicionais que precisa.

## 2 Habilitar atualizações de extração agendadas e falhas por e-mail

Como um administrador de servidor ou site, é possível habilitar agendas, bem como uma notificação por e-mail quando houver falha nas atualizações de extração.

Selecione Configurações e, em seguida, vá para a página Geral.

- Em Notificação por e-mail, selecione Enviar e-mail para os proprietários da fonte de dados e da pasta de trabalho quando houver falhas nas atualizações agendadas.
- Em Credenciais inseridas, selecione as duas caixas de seleção para permitir que os publicadores insiram as credenciais e agendem as atualizações de extração.
    
    ![Configurações gerais com caixas de seleção para notificações por e-mail e credenciais inseridas.](/tableau/current/pt-br/server/pt-br/Img/refresh_extracts2.png)

## 3 Publicar uma pasta de trabalho com uma extração

No Tableau Desktop, selecione **Servidor** > **Publicar pasta de trabalho**. Se não estiver conectado, entre no servidor. Na caixa de diálogo **Publicar pasta de trabalho no Tableau Server**, clique em **Agendamentos e autenticação**. Em **Agendamento de extração**, selecione o agendamento na lista.

![Um formulário para publicar uma pasta de trabalho no Tableau Server com opções para definir um cronograma de atualização.](/tableau/current/pt-br/server/pt-br/Img/refresh_extracts3.png)

Se os dados originais exigirem autenticação, também será necessário selecionar como deseja que as pessoas os acessem.

## 4 Monitorar desempenho da atualização

Monitore tarefas agendadas visualizando **Tarefas em segundo plano para extrações** na página **Status**.

![Uma lista de itens de status do servidor, incluindo tarefas em segundo plano para extrações.](/tableau/current/pt-br/server/pt-br/Img/refresh_extracts4.png)

<!-- document id=0ff79081b7ff7dcc7f0534b4f639f698902142763c31f2c41862cb00d8907454 url=/tableau/current/pt-br/server/qs_permissions.md -->

[Pular para o conteúdo principal](#main-content)

# Início rápido: permissões

Uma regra de permissão é um conjunto de recursos que define qual acesso um grupo ou usuário tem a uma parte do conteúdo, como uma pasta de trabalho, projeto ou fonte de dados.

Para gerenciar permissões com eficiência:

- Remova as permissões do grupo Todos os usuários antes de criar mais grupos
- Configure permissões de modelo no projeto **Padrão** antes de criar mais projetos
- Gerenciar permissões a grupos, não a usuários individuais
- Gerenciar permissões para projetos, não conteúdo

## Criar regras de permissão de grupo para projetos

Para obter detalhes sobre as etapas a seguir, consulte o [artigo principal sobre permissões](https://help.tableau.com/current/server/pt-br/permissions.htm). Este guia de início rápido é uma visão geral e não captura muitos detalhes importantes sobre permissões e gerenciamento de permissões.

### 1\. Adicionar usuários aos grupos

Uma maneira comum de gerenciar permissões é usar grupos para usuários que devem ter as mesmas permissões.

1. Se necessário, adicione usuários ao site.
2. Em um site, selecione **Grupos**.
3. Se necessário, crie um grupo usando a opção **Adicionar grupo**.
4. Clique no nome de um grupo para abri-lo e use o botão **Adicionar usuários** para adicionar usuários existentes ao grupo.

### 2\. Acessar as configurações de permissões no nível do projeto

A página Explorar exibe o conteúdo do site. Use o menu suspenso para exibir Projetos de nível superior ou Todos os projetos (para ver também projetos aninhados).

Navegue até o projeto que deseja atualizar, abra o menu Ações (…), em seguida, selecione Permissões.

![Um menu suspenso com opções para compartilhar, adicionar a coleções, renomear, mover, alterar permissões, alterar proprietário e excluir o projeto.](/tableau/current/pt-br/server/pt-br/Img/project_permissions_actionmenu.png)

### 3\. Criar uma regra de permissões

Selecione **Adicionar regra de grupo/usuário** para criar uma nova regra de permissão.

A lista suspensa de modelo oferece um atalho para aplicar um conjunto inicial de recursos para o grupo.

Se desejar, personalize a regra de permissão clicando em um recurso para defini-lo como **Permitido** ou **Negado** ou deixe-o como **Não especificado**.

![Níveis de permissão para o projeto.](/tableau/current/pt-br/server/pt-br/Img/permissionrule.jpg)

O recurso de um usuário para definir permissões é baseada na função de site e como o recurso Definir permissões está configurado.

### 4\. Exibir as permissões em vigor do usuário

Após salvar a regra de permissões do grupo, é possível exibir as permissões em vigor de cada usuário. Clique no nome do grupo para visualizar os usuários do grupo e suas permissões. Focalize a caixa do recurso para ver uma dica de ferramenta com detalhes informando se um recurso é permitido ou negado.

#### Funções de site

A função de site, função que um usuário exerce no site, determina o máximo de permissões possíveis para esse usuário.

- Os Administradores de servidor e de site podem acessar todo o conteúdo do site e executar ações neles.
- Os proprietários sempre têm acesso completo ao conteúdo que publicaram. Quando as permissões do projeto principal não estiverem bloqueadas, os proprietários poderão alterar as permissões do conteúdo publicado.

Para obter mais informações, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm) e [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm).

#### Lógica de permissão

- **Negado** tem prioridade sobre **Permitido**.
- **Não especificado** resulta em **Negado** se não houver outras permissões especificadas.
- Permissões específicas de usuário para o conteúdo têm precedência em relação às permissões de grupo no conteúdo. Em outras palavras, as permissões de usuário superam as permissões de grupo.

Para obter mais informações, consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm).

<!-- document id=4aea52c073ccf569f08f091f7e58937e83c78b7b0fbd750534dd39654993df5d url=/tableau/current/pt-br/server/license_lblm_quick_start.md -->

[Pular para o conteúdo principal](#main-content)

# Início rápido: use o gerenciamento de licenças baseado em login com Tableau Server

Você pode usar as etapas a seguir para começar a trabalhar rapidamente com gerenciamento de licenças baseadas em logon.

### Etapa 1: instalar Tableau Server

Para usar o gerenciamento de licenças baseadas em logon para ativar o Tableau, você deve instalar a versão 2021.1 do Tableau Server ou posterior e ativá-lo com uma chave de produto habilitada para gerenciamento de licenças baseadas em logon. O Gerenciamento de licenças baseadas em logon permite que os usuários do Tableau Creator façam login e ativem o Tableau Desktop ou o Tableau Prep Builder.

**Observação:** se a chavde do produto Tableau Server não está habilitada para gerenciamento de licenças baseadas em logon no Portal do cliente do Tableau, entre em contato com seu representante de conta do Tableau.

Os tópicos a seguir fornecem informações adicionais sobre a instalação do Tableau Server e uso do gerenciamento de licenças baseadas em logon para ativar Tableau Desktop e Tableau Prep Builder:

- [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm)
- [Introdução ao Tableau Server No Windows](https://help.tableau.com/current/server/pt-br/get_started_server.htm)

Para alterar as definições de configuração do gerenciamento de licenças baseadas em logon ou para desabilitar gerenciamento de licenças baseadas em logon no Tableau Server, consulte [Alterar as configurações de gerenciamento de licença com base em login](https://help.tableau.com/current/server/pt-br/license_lblm.htm#Step_2).

### Etapa 2: adicionar usuários autorizados a Tableau Server

Depois de ativar o Tableau Server, você pode [adicionar usuários autorizados](https://help.tableau.com/current/server/pt-br/users_add.htm). Ao adicionar usuários, você precisará selecionar a função do site para esse usuário, por exemplo, Creator, Explorer ou Administrador do site. Usuários que irão ativar o Tableau Desktop ou Tableau Prep Builder deve ser atribuído a uma função de site Creator (Creator ou Creator administrador do site). Para obter mais informações sobre as funções de site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

### Etapa 3: ativar Tableau Desktop ou Tableau Prep Builder

Um usuário criador deve baixar e instalar Tableau Desktop e/ou Tableau Prep Builder em seu computador antes que eles possam ser ativados usando gerenciamento de licenças baseadas em logon. Para obter mais informações, consulte [Instalar o Tableau Desktop ou Tableau Prep Builder da interface do usuário](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_download_and_install.htm).

1. Inicie o Tableau Desktop ou Tableau Prep Builder.
    
    Se esta for a primeira vez que você iniciou o Tableau Desktop ou Tableau Prep Builder, você tem a opção de iniciar uma avaliação gratuita de 14 dias do Tableau Prep Builder, baixar o Tableau Desktop Free Edition ou ativar o Tableau.
2. Clique em Ativar o Tableau.
3. Na tela Ativar o Tableau, clique em Ativar entrando em um servidor, para entrar e ativar o Tableau usandogerenciamento de licenças baseadas em logon.
4. Quando solicitado, especifique a URL para Tableau Server para entrar usando suas credenciais.
5. Depois de ser autenticado por Tableau Server,Tableau Desktop e/ou Tableau Prep Builder estão ativados e prontos para uso.

<!-- document id=d0d901b3b8fd9e7efbb3afcbbf4c5bdba9cdcdf174187bab10f08d07e3babb11 url=/tableau/current/pt-br/server/automated_install_windows.md -->

[Pular para o conteúdo principal](#main-content)

# Instalação automatizada do Tableau Server

Você pode usar o `SilentInstaller.py`, um script Python [compatível com a comunidade](https://www.tableau.com/pt-br/support-levels-it-and-developer-tools "Abre em um novo painel"), para automatizar uma nova instalação do Tableau Server. É possível baixar o script e usá-lo como gravado, ou modificá-lo de acordo com suas necessidades.

## Vantagens de usar um instalador automático

- Com um único comando, é possível instalar, configurar e executar uma instância de trabalho do Tableau Server.
- O script `SilentInstaller.py` pode ser executado sem a entrada do usuário, possibilitando a automação.
- A configuração pode ser definida uma vez e usada em todas as suas instalações, tornando-a um processo de repetição.

### Quando não usar o instalador automatizado

- Se você estiver instalando o Tableau Server pela primeira vez, é recomendado testar a instalação manualmente, antes de automatizar o processo. Qualquer problema que bloqueie a instalação é mais fácil de resolver interativamente. Depois de solucionar esse problema, é possível executar uma instalação automatizada do Tableau Server usando o script `SilentInstaller.py`.
- Se estiver testando ou tentando novos parâmetros de configuração, como métodos de autenticação, é recomendado realizar a Instalação manualmente primeiro. O Tableau Services Manager (TSM) valida as entidades da configuração e rejeita os parâmetros de configuração não válidos. Uma vez identificados os parâmetros corretos, é possível usar o instalador automatizado.
- Se você não puder ou não desejar inserir senhas em arquivos secretos, usar o instalador automático pode não ser uma opção para você.

## Antes de começar

Consulte [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm) para verificar se o Microsoft Windows Server foi instalado no computador que atende aos requisitos de sistema operacional e os requisitos mínimos de hardware para o Tableau Server.

**Observação:** se estiver instalando o Tableau Serverem um ambiente de produção, consulte as **recomendações** mínimas de hardware. As recomendações mínimas representam a configuração mínima de hardware necessária para uma instalação de produção do Tableau Server.

Para executar uma instalação automatizada, use o script `SilentInstaller.py`, que depende do pacote de instalação do Tableau Server como entrada. Antes de começar, recomendamos baixar os pacotes a seguir:

1. Baixe o [Python 3.5](https://www.python.org/downloads/windows/) ou versões posteriores e instale no computador em que deseja instalar o Tableau Server.
2. Baixe o script `SilentInstaller.py` e o pacote do instalador do Tableau Server:
    
    1. Baixe o script `SilentInstaller.py` no [GitHub](https://github.com/tableau/server-install-script-samples/tree/master/windows/tsm/SilentInstaller), junto com config.template.json, registration.template.json, secrets.template.json e os três modelos bootstrap (bootstrap.template.json, topologyBootstrap.template.json, e workerBootstrap.template.json).
    2. Selecione e baixe o **pacote do instalador do Tableau Server** apropriado na página [Downloads dos produtos do Tableau Server](https://www.tableau.com/pt-br/support/releases/server/). O escolhido depende da versão do Microsoft Windows Server que deseja usar.
3. Copie os pacotes e modelos para uma pasta no computador, ou um lugar acessível por ele, onde o Tableau Server será instalado.

## Como usar o script SilentInstaller.py

O script `SilentInstaller.py` instala o pacote do instalador do Tableau Server, cria os diretórios, define as permissões necessárias para executar o Tableau Server e inicia a instalação do Tableau Services Manager (TSM). Depois que instalação do TSM for concluída, o script `SilentInstaller.py` executa os comandos `tsm` para instalar, configurar e iniciar o Tableau Server. Por padrão, o script `SilentInstaller.py` ativa uma licença de avaliação gratuita durante a instalação. Caso tenha uma chave do produto, é possível fornecê-la na linha de comando ou ativá-la após executar o script `SilentInstaller.py`. A maioria das opções da linha de comando no instalador automatizado são as mesmas usadas pelo comando [tsm initialize](https://help.tableau.com/current/server/pt-br/cli_initialize_tsm.htm).

O script `SilentInstaller.py` pode ser executado em três modos: instalar o nó inicial, instalar nós adicionais e atualizar a topologia do cluster. Ao executar uma instalação pra um cluster distribuído, execute o `SilentInstaller.py` com a opção de instalar o nó inicial no nó inicial. Execute o `SilentInstaller.py` com a opção de instalar nós adicionais em cada nó adicional. Por último, execute o `SilentInstaller.py` com a opção de atualizar a topologia do cluster no nó inicial.

O script `SilentInstaller.py` deve ser executado sem a interação de usuário, então é necessário colocar todos os parâmetros nos argumentos obrigatórios passados para o script `SilentInstaller.py`. Como alternativa, também é possível colocar os argumentos obrigatórios no arquivo bootstrap. Você pode usar os [Modelos de arquivo de configuração, registro e de segredos](#Configur) fornecidos.

Use as etapas abaixo para executar uma instalação não supervisionada:

### Etapa 1: instale o instalador automático

1. Faça logon no computador como um usuário com acesso de administrador.
2. Baixe e instale o script `SilentInstaller.py`, modelos e arquivos bootstrap.

### Etapa 2: crie arquivos para fornecer informações adicionais de configuração necessárias para a execução da instalação automática

Como o script `SilentInstaller.py` foi feito para ser executado sem interação com o usuário, é necessário fornecer as seguintes informações adicionais:

1. Copie os modelos, **config.template.json**, **registration.template.json** e **secrets.template.json**, para outro diretório como seu diretório inicial. Não recomendamos editar os arquivos de modelo diretamente.
2. Edite o arquivo **config.template.json** e forneça as definições de configuração do nó inicial. É necessário fornecer as configurações do repositório de identidades do computador com o Tableau Server. Dependendo dos requisitos de rede, pode ser necessário fornecer as configurações do gateway. A opção de colocar em cache é definida para cache e reuso dos dados pelo maior de tempo possível. Os exemplos de pasta de trabalho estão instalados por padrão. O modelo inclui as informações mínimas necessárias, portanto ele é um ponto de partida. Para obter mais informações sobre as configurações, consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).
3. Edite o arquivo **registration.template.json** para fornecer as informações necessárias para o registro do Tableau Server. Para obter mais informações, consulte [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm).
4. Edite o arquivo **secrets.template.jsonsecrets.template.json** e forneça o nome de usuário e senha do administrador do TSM e das contas de administrador do Tableau Server.
    
    - A conta de administrador do TSM deve ser do mesmo usuário que o administrador do Windows que executa o script.
    - A conta do administrador do Tableau Server é a conta inicial criada pelo instalador e é usada para o administrador do Tableau Server.

### Etapa 3: execute a instalação automática

1. Faça logon no computador como um usuário com acesso de administrador.
    
    #### Instalar o nó inicial
    
    O script `SilentInstaller.py` executa os comandos adequados para instalar, ativar a licença, configurar e iniciar o Tableau Services Manager. Execute o `SilentInstaller.py -h` e o `SilentInstaller.py install –h` para visualizar a lista completa de opções e seus valores padrão.
    
    **Para instalar o nó inicial:**
    
    No nó inicial, em um prompt do Python, digite:
    
    `SilentInstaller.py install --secretsFile secrets.json --configFile myconfig.json --registrationFile registration.json TableauServer-64bit-<version>.exe`
    
    Ou, como alternativa:
    
    `SilentInstaller.py --bootstrapFile <bootstrap file path>`
    
    <table class="simple-table"><colgroup><col style="width: 15%;"><col style="width: 85%;"><col><col></colgroup><thead><tr><td><p>Opção de script</p></td><td><p>Descrição</p></td></tr></thead><tbody><tr><td><strong>Switches necessários</strong></td><td>&nbsp;</td></tr><tr><td><p>--configFile &lt;file path&gt;</p></td><td><p>O caminho relativo ou absoluto para o arquivo JSON de <a href="#ConfigFile">Configuração do servidor</a>.</p></td></tr><tr><td><p>--secretsFile &lt;file path&gt;</p></td><td><p>O caminho relativo ou absoluto do <a href="#SecretsFile">Arquivos de segredos</a> que descreve as credenciais da conta Windows para autenticar para o Tableau Services Manager (TSM), e o nome de usuário/senha do usuário administrador inicial do Tableau Server. O arquivo de segredos também inclui a chave do produto que deseja usar para ativar o Tableau Server. Por padrão, o modelo do arquivo de segredos contém uma licença de avaliação.</p><p class="note"><b>Observação:</b> fornecer a senha no arquivo de segredos é opcional. Contudo, se as senhas não forem encontradas no arquivo de segredo, elas precisarão ser fornecidas durante a instalação.</p><p>O pacote do instalador automatizado inclui o modelo do arquivo de segredos.</p></td></tr><tr><td><p>--registrationFile &lt;file path&gt;</p></td><td><p>O caminho relativo ou absoluto do arquivo <a href="#RegFile">Registro de servidor</a> que contém as informações de registro do Tableau Server.</p><p>O pacote do instalador automatizado inclui o modelo do arquivo de registro.</p></td></tr><tr><td><p>&lt;installer executable file path&gt;</p></td><td><p>O caminho relativo ou absoluto do instalador do Tableau Services Manager (TSM).</p></td></tr><tr><td><strong>Switches opcionais</strong></td><td>&nbsp;</td></tr><tr><td><p>--installDir &lt;file path&gt;</p></td><td><p>O diretório de instalação do <span class="mc-variable Variables.ProductName variable">Tableau Server</span>. Se não fornecer um caminho, o diretório padrão <b>C:\Program Files\Tableau\Tableau Server</b> será usado.</p></td></tr><tr><td><p>--dataDir &lt;file path&gt;</p></td><td><p>O local onde a configuração de software e os dados do Tableau Server estão armazenados. Se não fornecer um caminho, o diretório padrão <b>C:\ProgramData\Tableau</b> será usado para os arquivos de configuração de dados.</p></td></tr><tr><td><p>--installerLog &lt;file path&gt;</p></td><td><p>O diretório existente onde os arquivos de log do instalador estão gravados. Se um caminho diferente não for informado, os arquivos de log serão gravados em seu diretório TEMP.</p></td></tr><tr><td><p>--controllerPort &lt;port number&gt;</p></td><td><p>A porta na qual o controlador do Tableau Services Manager (TSM) deve ser executada.</p></td></tr><tr><td><p>--coordinationserviceClientPort &lt;port number&gt;</p></td><td><p>A porta do cliente ZooKeeper.</p></td></tr><tr><td><p>--coordinationservicePeerPort &lt;port number&gt;</p></td><td><p>A porta com par do ZooKeeper.</p></td></tr><tr><td><p>--coordinationserviceLeaderPort &lt;port number&gt;</p></td><td><p>A porta líder do ZooKeeper.</p></td></tr><tr><td><p>--start</p></td><td><p>Se o servidor deve ser iniciado quando a instalação estiver concluída.</p></td></tr></tbody></table>
    
    #### Instalar nós adicionais
    
    O script `SilentInstaller.py` executa os comandos adequados para instalar o Tableau Services Manager (TSM) no nó adicional. Execute o `SilentInstaller.py installWorker –h` para visualizar a lista completa de opções e seus valores padrão.
    
    **Para instalar nós adicionais:**
    
    Em cada nó inicial, em um prompt do Python, digite:
    
    `SilentInstaller.py workerInstall --secretsFile secrets.json --nodeConfigurationFile nodeConfiguration.json TableauServer-64bit-<version>.exe`
    
    <table class="simple-table"><colgroup><col style="width: 15%;"><col style="width: 85%;"><col><col></colgroup><thead><tr><td><p>Opção</p></td><td><p>Descrição</p></td></tr></thead><tbody><tr><td><p>--secretsFile &lt;file path&gt;</p></td><td><p>Obrigatório. O caminho relativo ou absoluto do <a href="#SecretsFile">Arquivos de segredos</a> que descreve as credenciais da conta Windows para autenticar para o Tableau Services Manager (TSM), e o nome de usuário/senha do usuário administrador inicial do Tableau Server. O arquivo de segredos também inclui a chave do produto que deseja usar para ativar o Tableau Server. Por padrão, o modelo do arquivo de segredos contém uma licença de avaliação.</p><p class="note"><b>Observação:</b> fornecer a senha no arquivo de segredos é opcional. Contudo, se as senhas não forem encontradas no arquivo de segredo, elas precisarão ser fornecidas durante a instalação.</p><p>O pacote do instalador automatizado inclui o modelo do arquivo de segredos.</p></td></tr><tr><td><p>--nodeConfigurationFile &lt;file path&gt;</p></td><td><p>Obrigatório. Caminho do arquivo de configuração do nó para a instalação do nó adicional.</p></td></tr><tr><td><p>(installer executable) &lt;file path&gt;</p></td><td><p>Obrigatório. O argumento do script é o caminho, absoluto ou relativo, para o executável do instalador do Tableau Services Manager, adquirido por meio dos canais usuais, como baixados do site do Tableau. Este script é compatível apenas para uso com o Tableau Services Manager.</p></td></tr><tr><td><p>--installDir &lt;file path&gt;</p></td><td><p>Opcional. O diretório de instalação do <span class="mc-variable Variables.ProductName variable">Tableau Server</span>. Se estiver em branco, o diretório padrão <b>C:\Program Files\Tableau\Tableau Server</b> será usado.</p></td></tr><tr><td><p>--dataDir &lt;file path&gt;</p></td><td><p>Opcional. O local onde a configuração de software e os dados do Tableau Server estão armazenados. Se estiver em branco, o diretório padrão <b>C:\ProgramData\Tableau</b> será usado para os arquivos de configuração de dados.</p></td></tr><tr><td><p>--installerLog &lt;file path&gt;</p></td><td><p>Opcional. O diretório existente onde os arquivos de log do instalador estão gravados. Se estiver em branco, os arquivos de log serão gravados no diretório TEMP do usuário.</p></td></tr></tbody></table>
    
    **Observação:** o arquivo de configuração do nó é salvo automaticamente depois de instalar o primeiro nó usando o `SilentInstaller.py`. Ele pode ser encontrado no diretório de trabalho do script.
    
    #### Atualizar topologia do cluster
    
    O script `SilentInstaller.py` executa os comandos adequados para atualizar a topologia do cluster, conforme desejado para o Tableau Services Manager (TSM). Execute o `SilentInstaller.py updateTopology –h` para visualizar a lista completa de opções e seus valores padrão.
    
    Para atualizar a topologia do cluster:
    
    No nó inicial, em um prompt do Python, digite:
    
    `SilentInstaller.py updateTopology --secretsFile secrets.json --configFile myconfig.json`
    
    <table class="simple-table"><colgroup><col style="width: 15%;"><col style="width: 85%;"><col><col></colgroup><thead><tr><td><p>Opção</p></td><td><p>Descrição</p></td></tr></thead><tbody><tr><td><p>--secretsFile &lt;file path&gt;</p></td><td><p>Obrigatório. O caminho relativo ou absoluto do <a href="#SecretsFile">Arquivos de segredos</a> que descreve as credenciais da conta Windows para autenticar para o Tableau Services Manager (TSM), e o nome de usuário/senha do usuário administrador inicial do Tableau Server. O arquivo de segredos também inclui a chave do produto que deseja usar para ativar o Tableau Server. Por padrão, o modelo do arquivo de segredos contém uma licença de avaliação.</p><p class="note"><b>Observação:</b> fornecer a senha no arquivo de segredos é opcional. Contudo, se as senhas não forem encontradas no arquivo de segredo, elas precisarão ser fornecidas durante a instalação.</p><p>O pacote do instalador automatizado inclui o modelo do arquivo de segredos.</p></td></tr><tr><td><p>--configFile &lt;file path&gt;</p></td><td><p>Obrigatório. O caminho relativo ou absoluto do arquivo <a href="#ConfigFile">Topologia do servidor</a> que descreve a topologia do Tableau Server a ser atualizada. Apenas a parte topologyVersion do arquivo será aplicada, outras configurações serão ignoradas.</p></td></tr></tbody></table>

## Modelos de arquivo de configuração, registro e de segredos

Use os modelos de exemplo a seguir para transmitir dados para o script `SilentInstaller.py`.

### Exemplo de modelo do arquivo de segredos

{
    "local\_admin\_user":" ,
    "local\_admin\_pass":" ,
    "content\_admin\_user":" ,
    "content\_admin\_pass":" ,
    "product\_keys":\["trial"\]
}

O local\_admin\_user é a conta Windows a ser autenticada para o Tableau Services Manager.

O content\_admin\_user é o usuário administrativo inicial, que age como um superusuário em todo o Tableau Server no que diz respeito à criação e ao gerenciamento de usuários, sites etc.

Ao instalar nós adicionais ou atualizar a topologia do cluster, essas credenciais são ignoradas porque o usuário administrador inicial já foi criado quando o nó inicial foi instalado.

O product\_keys é a chave usada para ativar o Tableau Services Manager. Se várias chaves forem especificadas, elas serão ativadas uma por uma. No caso do modo de não instalação, essas chaves são ignoradas porque as licenças já foram ativadas.

### Exemplo do modelo de arquivo de configuração do servidor

```
{
"configEntities":{
    "runAsUser":{
        "_type":"runAsUserType",
        "name":"NT AUTHORITY\\NetworkService"
    },
    "gatewaySettings":{
        "_type":"gatewaySettingsType",
        "port":80,
        "firewallOpeningEnabled":true,
        "sslRedirectEnabled":true,
        "publicHost":"****replace me****",
        "publicPort":80,
        "sslEnabled":false,
        "sslPort":443
    },
    "identityStore":{
        "_type":"identityStoreType",
        "type":"local",
        "domain":"****Domain Name Here****",
        "nickname":"****Domain Nickname Here****"
    }
},
"topologyVersion":{
    "nodes":{
        "****insert nodeId (lowercase) here****": {
            "services": {
                "filestore": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "tabadmincontroller": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "clientfileservice": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "dataserver": {
                    "instances":[
                        {
                        "instanceId":"0"
                        },
                        {
                        "instanceId":"1"
                        }
                    ]
                },
                "cacheserver": {
                    "instances":[
                        {
                        "instanceId":"0"
                        },
                        {
                        "instanceId":"1"
                        }
                    ]
                },
                "vizqlserver": {
                    "instances":[
                        {
                        "instanceId":"0"
                        },
                        {
                        "instanceId":"1"
                        }
                    ]
                },
                "backgrounder": {
                    "instances":[
                        {
                        "instanceId":"0"
                        },
                        {
                        "instanceId":"1"
                        }
                    ]
                },
                "appzookeeper": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "pgsql": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "dataengine": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "licenseservice": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "searchserver": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "clustercontroller": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "tabsvc": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "vizportal": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "tabadminagent": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "clientfileservice": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                },
                "gateway": {
                    "instances":[
                        {
                        "instanceId":"0"
                        }
                    ]
                }
            }
        }
    }
}
}
			
```

### Exemplo do modelo de arquivo de registro do servidor

```
{
    "first_name" : "Andrew",
    "last_name" : "Smith",
    "phone" : "311-555-2368",
    "email" : "andrew.smith@mycompany.com",
    "company" : "My Company",
    "industry" : "Finance",
    "company_employees" : "500",			
    "department" : "Engineering",
    "title" : "Senior Manager",
    "city" : "Kirkland",
    "state" : "WA",
    "zip" : "98034",
    "country" : "United States",
    "opt_in" : "true",
    "eula" : "true"
}
```

<!-- document id=fab30f9c8f6448abea1c9cce768c7a8fa16a75ca431f04b9608b4ae9e28116da url=/tableau/current/pt-br/server/cmt-install.md -->

[Pular para o conteúdo principal](#main-content)

# Instalação do Content Migration Tool do Tableau

A instalação do Content Migration Tool do Tableau é simples e fácil.

## Requisitos de instalação

A ferramenta Content Migration Tool é executada em um computador Windows e pode se conectar aos sites do Tableau Cloud e Tableau Server 19.3 e posteriores com uma licença de documento válida do Advanced Management. Para obter mais informações sobre as versões de compatibilidade, consulte [Introdução ao Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-getting-started.htm).

O computador que você instala o Content Migration Tool deve atender aos requisitos abaixo:

- Microsoft Windows 10 ou mais recente (x64)
- Intel Core i3 ou AMD Ryzen 3 (Dual Core)
- 4 GB de memória ou maior
- Pode se conectar aos sites de origem e destino. Os dois sites devem ter uma licença válida do [Advanced Management](https://help.tableau.com/current/server/pt-br/itm_intro.htm) para migração do conteúdo.
- HHD de 2 GB ou maior. A unidade em que a pasta `\temp` reside deve ter espaço em disco suficiente para armazenar uma cópia de todo o conteúdo que está sendo migrado em uma única migração. Todo conteúdo é armazenado localmente no disco e excluído quando a migração é concluída.
- Ter espaço livre em disco suficiente para manter o aplicativo e seus logs.

Além disso, confirme se a API REST está habilitada no Tableau Server (este é o padrão). Use o comando `tsm configuration get -k api.server.enabled` para confirmar isso. Um valor de retorno `true` significa que a API REST está habilitada. Para criar a API REST, use o comando `tsm configuration set`. Para obter mais informações, consulte [api.server.enabled](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#rest_api_enabled).

## Instalação do Content Migration Tool

Para instalar o Content Migration Tool:

1. Baixe o instalador Content Migration Tool (`Tabcmt-64bit-<version>.exe`) para a sua versão do Tableau Server na página de downloads do [Tableau Advanced Management](https://www.tableau.com/pt-br/support/releases/server-management).
2. Execute o Content Migration Tool no programa de Instalação.
    
    **Observação:** a execução do programa de Instalação do Content Migration Tool substituirá a versão anterior.
3. Após ler o EULA, selecione I agree to the license terms and conditions e clique em Install.
4. Se a caixa de diálogo Controle da conta de usuário for aberta, clique em Yes para permitir que o instalador faça alterações.

## Atualizar o Content Migration Tool

Atualizar para a versão mais recente do Content Migration Tool garante que você aproveite os recursos e as correções mais recentes incluídos em cada nova versão.

**Importante:**

- A execução do programa de Instalação do Content Migration Tool substituirá a versão anterior.
- O Content Migration Tool não é compatível com a instalação lado a lado das versões anteriores.

Para atualizar o Content Migration Tool:

1. Faça logon na máquina em que o Content Migration Tool está instalado. Se houver instâncias de Content Migration Tool aberto, salve seu plano de migração e saia do aplicativo.
2. Siga as etapas listadas em [Instalar Content Migration Tool](#install-cmt) para baixar o instalador mais recente e concluir a atualização.

## Instalar Content Migration Tool com a linha de comando

Se você for um administrador local na máquina, é possível instalar o Content Migration Tool na linha de comando.

### Instalar interruptores

Especifique uma ou mais opções na linha de comando do instalador. Por exemplo:

`Tabcmt-64bit-2022-3-0.exe /quiet /norestart`

<table class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td>Switch</td><td>Descrição</td><td>Comentários</td></tr><tr><td><code>/install</code> | <code>/repair</code> | <code>/uninstall</code> | <code>/layout</code> "<code>&lt;directory&gt;</code>"</td><td><p>Execute a configuração para instalar, reparar ou desinstalar o tabcmd ou <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span>, com o <code>/layout</code>, crie uma cópia local completa do pacote de instalação no diretório especificado.</p></td><td>O padrão é instalar, exibir a interface do usuário e todos os prompts. Se nenhum diretório for especificado em uma nova instalação, <code>C:\Program Files\Tableau\Tableau Content Migration Tool</code> será assumido. Se o <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> já estiver instalado, a Instalação assumirá o mesmo local da instalação atual.</td></tr><tr><td><code>/passive</code></td><td><p>Execute a Instalação com interface do usuário mínima e sem prompts.</p></td><td>O <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> não iniciará automaticamente quando for instalado no modo <code>/passive</code>. Para iniciar <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span>, abra o aplicativo manualmente.</td></tr><tr><td><code>/quiet</code> | <code>/silent</code></td><td><p>Executar a instalação em modo totalmente silencioso e não supervisionado. Nenhuma interface do usuário ou prompts são exibidos.</p></td><td>O <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> não iniciará automaticamente quando for instalado no modo <code>/silent</code> ou <code>/quiet</code> Para iniciar <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span>, abra o aplicativo manualmente.<p class="note"><b>Observação:</b> use <code>/silent</code> ou <code>/quiet</code>, mas não ambos.</p></td></tr><tr><td><code>/norestart</code></td><td><p>Execute a Instalação sem reiniciar o Windows, mesmo que seja necessária uma reinicialização.</p></td><td><p class="note"><strong>Observação: </strong>em casos raros específicos, uma reinicialização não pode ser cancelada, mesmo quando essa opção é usada. Isso é mais provável quando uma reinicialização do sistema anterior foi ignorada, por exemplo, durante a instalação de outro software.</p></td></tr></tbody></table>

## Quem pode fazer isso

Um usuário com acesso de Administrador na máquina.

<!-- document id=d3b62a8063b02b8fdcad3235b15b61fa715313b8fc8118d15ead84b6160b8e71 url=/tableau/current/pt-br/server/rmt-admin-installation.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau tem dois componentes principais: RMT Server e Agente.

Os pré-requisitos do Resource Monitoring Tool e o RMT Server devem ser instalados no hardware dedicado para garantir que tenham os recursos necessários e que não haja conflito de acesso para os recursos da máquina com outros programas ou software. Eles não devem ser instalados no computador do Tableau Server, exceto em casos excepcionais (por exemplo, para fins de demonstração limitada em ambientes não relacionados à produção).

Os agentes são instalados em todos os nós do Tableau Server que você deseja monitorar.

O instalador para instalar o Resource Monitoring Tool pode ser encontrado no [Site de downloads do Advanced Management](https://www.tableau.com/pt-br/support/releases/server-management). Baixe todos os arquivos que começam com **Tabrmt**.

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## Histórico de versões de instalação

Esta seção chama mudanças significativas no processo de instalação. Use esta seção para entender quais alterações foram feitas dependendo da sua versão atual e da versão para a qual você está atualizando.

- A partir da versão **2025.3.4**, uma atualização do instalador do Windows alterou um pouco o fluxo de trabalho. As caixas de diálogo que você vê podem ter palavras ligeiramente diferentes das versões anteriores, e o local de instalação não padrão pode ser configurado na caixa de diálogo de boas-vindas, clicando em Options.
- A partir da versão **2022.3**, você tem a opção de configurar o serviço de mensagens RabbitMQ e o banco de dados PostgreSQL usado pelo Resource Monitoring Tool em uma plataforma de nuvem. Atualmente, o AWS AMQ for RabbitMQ e o banco de dados Amazon RDS for PostgreSQL são compatíveis. Com essa adição, você pode optar por instalar o repositório e o serviço de fila de mensagens com o RMT Server na mesma máquina ou separadamente na plataforma AWS.
- A partir da versão **2020.4**, o Resource Monitoring Tool pode ser instalado em máquinas com Linux. Anteriormente Resource Monitoring Tool a instalação era suportada apenas em máquinas Windows.

## Antes de instalar o Resource Monitoring Tool

- Revise os seguintes requisitos e instruções:
    - [Requisitos mínimos de hardware e recomendações para o Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-min-hardware-req.htm)
    - [Lista de verificação de pré-instalação - Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-install-checklist.htm)
    - O sistema operacional a seguir é compatível:
        - Windows Server 2022 (a partir da versão 2023.3.1)
        - Windows Server 2016
        - Windows Server 2019
- Verifique se a instalação do Tableau Server que você vai monitorar está licenciada com a licença Advanced Management. Você deve ter uma licença válida do Advanced Management para usar o Resource Monitoring Tool.
- Examine o tamanho dos registros do Tableau Server. Depois que o Agente é instalado e configurado, os dados de histórico relevantes aos processos do Resource Monitoring Tool do Tableau Server são registrados antes dos dados serem exibidos. Se houver um grande volume de dados históricos de registro, talvez demore para processar as informações que, por sua vez, podem resultar em um atraso no processamento de eventos mais recentes no Servidor.
    
    Se estiver preocupado com o atraso e não tiver as informações históricas, você poderá fazer o seguinte para limpar os arquivos existentes:
    
    - [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm) e considere os [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm) antes de remover os arquivos de registro.
    
    **Observação:** os dados de desempenho, como uso de CPU e uso de memória não são reunidos usando dados de registro histórico, e são coletados depois que o Agente é instalado e configurado para que a limpeza de dados históricos não afete os dados de desempenho.
- Habilite o usuário interno somente leitura para o Repositório do Tableau Server. Este usuário é utilizado ao instalar o Agente do Resource Monitoring Tool. **Isso é necessário a partir da versão 2022.3.** Para obter mais informações, consulte [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#enable-access-to-the-tableau-server-repository).
- Determine se você deseja configurar o repositório e o serviço de fila de mensagens externo ao Resource Monitoring Tool.

### Arquitetura de instalação

Uma exibição de alto nível da configuração do Resource Monitoring Tool. Este diagrama mostra dois clusters do Tableau Server monitorados pelo RMT Server.

![Diagrama ilustrando as relações entre um servidor mestre e clusters do Tableau Server para produção e desenvolvimento/teste.](/tableau/current/pt-br/server/pt-br/Img/rmt-setup-architecture.png)

Uma exibição detalhada dos componentes do Resource Monitoring Tool instalados no RMT Server e no Agente.

![Um diagrama que mostra os programas e as dependências da Resource Monitoring Tool do Tableau.](/tableau/current/pt-br/server/pt-br/Img/rmt-setup-architecture-details.png)

## Visão geral da instalação

O RMT Server pode ser instalado em qualquer sistema operacional e não depende do sistema operacional no qual o Agente está instalado. Isso significa que você pode instalar o RMT Server e Agente em diferentes sistemas operacionais.

No entanto, o Agente está instalado em nós do Cluster do Tableau Server, portanto, a escolha do sistema operacional para o Agente depende da instalação do Tableau Server.

Você pode monitorar vários clusters do Tableau Server usando a mesma Resource Monitoring Tool. Cada cluster do Tableau deve ser configurado como um ambiente separado.

### Configuração externa

O repositório e o serviço de fila de mensagens podem ser hospedados externamente ao RMT Server na plataforma AWS. Para hospedar o repositório, use a instância do AWS RDS e, para fila de mensagens, use o AWS AMQ. Para obter mais detalhes sobre a configuração, instruções passo a passo e outros detalhes, consulte:

- [Repositório externo para Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-external-repo.htm)
- [Serviço de fila de mensagens externo (RabbitMQ) para Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-external-messagequeue.htm)

### Instalação no Windows

Você pode usar a interface da Web ou a linha de comando para instalar o RMT Server e o Agente.

Aqui estão as etapas para instalar o Resource Monitoring Tool:

1. Instale o RMT Server [usando a interface da Web](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install.htm) ou [usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install-cli.htm).
    
    Ao iniciar o instalador do Resource Monitoring Tool, o programa de configuração vai instalar certos programas necessários para executar o Resource Monitoring Tool primeiro. Os programas instalados incluem RabbitMQ, Erlang e um banco de dados PostgreSQL dedicado. Em seguida, ele vai instalar o RMT Server.
2. Instale o Agente [usando a interface da Web](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install.htm) ou [usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install-cli.htm).
    
    Instale o Agente em todos os nós do Tableau Server. O Agente envia informações sobre o uso e o desempenho do Tableau Server para o RMT Server para relatório.

### Antivírus

Recomendamos que você exclua os [Arquivos de registro do Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm) das verificações de antivírus. Isso melhorará o desempenho evitando contenção quando o Resource Monitoring Tool gravar nos arquivos de registro.

### HTTPS

Como prática recomendada, você deve usar HTTPS para proteger as informações confidenciais e credenciais do usuário.

A configuração **Exigir HTTPS** nas definições do servidor é usada para comunicações entre os usuários e o RMT Server. Também é usada ao registrar um agente. As comunicações regulares entre Agente e RMT Server para coletar dados são feitas por meio do Rabbit MQ.

Inicialmente, o RMT Server é instalado com um certificado autoassinado, e usará esse certificado de comunicação HTTPS, que inclui a comunicação durante o registro do Agente. Você pode usar seu próprio certificado para substituir o certificado autoassinado. Isso pode ser feito durante a instalação do RMT Server, na página Configuração do servidor, ou após a conclusão da instalação. A seção a seguir descreve os requisitos:

#### Requisitos e modo de certificado SSL

A Resource Monitoring Tool é compatível com os seguintes modos de utilização de Certificados SSL:

- **Padrão:** este modo usa o certificado de autoassinatura padrão fornecido pelo instalador.
- **Armazenamento:** este modo permite que você digite a impressão digital de um certificado na loja de certificados do Windows.
- **Local:** este modo permite especificar um certificado baseado em arquivo na pasta `<installation directory>\config`. Por padrão ele é `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config`.

Se você estiver usando seu próprio certificado, poderá selecionar **Local** ou **Armazenar**.

- É possível escolher **Local**, você deve ter o certificado, a autoridade de certificado e chaves privadas disponíveis nos arquivos agrupados ou em um único arquivo.
- Se você escolher a opção **Armazenar**, poderá armazenar o certificado e a impressão digital com antecedência e consultá-lo durante a instalação. O certificado e a chave privada precisam estar em pacote juntos e devem ser capazes de ser referenciados de uma única impressão digital. O certificado em pacote deve ser armazenado em um local específico que é definido pelos requisitos .NET e está documentado no site da Microsoft [aqui](https://docs.microsoft.com/pt-br/dotnet/api/system.security.cryptography.x509certificates.storename?view=netcore-3.1). Depois de importar o certificado na máquina, você pode usá-lo para configurar o HTTPS.

Siga estas diretrizes e requisitos para o seu certificado:

- Você deve ter um certificado HTTPS (como X.509) para os domínios apropriados. Isso depende das políticas de segurança locais e requisitos de certificado. Por exemplo, se o Resource Monitoring Tool estiver usando um proxy de passagem CName ou SSL, talvez seja necessário usar um certificado SAN. Para vários subdomínios, certificados curinga são aceitos.
- O Resource Monitoring Tool aceita apenas os formatos PKCS #12 e PEM.
- O servidor da Web Resource Monitoring Tool requer um certificado e uma chave privada e, como opção, uma cadeia de confiança.
    
    A chave privada pode ser RSA ou DSA.
    
    Ela pode ser fornecida em um único arquivo ou arquivos agrupados.
    
    - Exemplos de arquivo único:
        - PKCS # 12: um único arquivo com as extensões de arquivo .pfx ou .p12.
        - PEM: certificado codificado por PEM + chave privada (mais CAs intermediários opcionalmente encadeados até CA raiz), em um único arquivo com a extensão .pem. Os itens no arquivo não precisam estar em uma ordem específica.
    - Exemplos de arquivo agrupado:
        - Certificado codificado por PEM em um arquivo .crt ou .cer MAIS
        - Chave privada codificada por PEM em um arquivo .key MAIS (opcionalmente)
        - Autoridade de certificação codificada por PEM em um ou mais arquivos .ca

### Locais de arquivo e diretório padrão:

#### RMT Server:

- Diretório de instalação: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master`
- Arquivo de configuração: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json`
- Diretório de registros: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs`

#### Agente:

- Diretório de instalação: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent`
- Diretório de registros: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\logs`

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.
- Resource Monitoring Tool Conta de administrador.

## Próxima etapa

Instale o RMT Server:

- [Usando a interface na Web](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install.htm)
- [Usando linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install-cli.htm)

## Outros artigos nesta seção

<!-- document id=247a92e7ba9954229e353215d8b5c8915fa6e5b09bf6a433adaca44cfb34b3ed url=/tableau/current/pt-br/server/install_config_top.md -->

[Pular para o conteúdo principal](#main-content)

# Instalação e configuração do Tableau Server

Os tópicos referenciados na parte inferior desta página descrevem as etapas de instalação e configuração do Tableau Server. Se estiver instalando uma implantação distribuída (cluster), use as etapas neste tópico para instalar o nó inicial e, em seguida, instalar nós adicionais, consulte [Instalações distribuída e de alta disponibilidade do Tableau Server](https://help.tableau.com/current/server/pt-br/distrib_ha.htm).

Depois de executar a instalação, é necessário continuar a configuração ao ativar uma licença, registrar o Tableau Server e configurar várias definições, inclusive a autenticação.

## Em que versão você está instalando ou atualizando?

Começando com o Tableau Server na versão 2019.4.0 do Windows, um novo programa de configuração é usado para instalar e atualizar o Tableau Server. Se você estiver instalando ou atualizando **para** a versão 2019.3.x ou anterior, consulte a Ajuda do Tableau Server 2019.3 para obter instruções.

## Outros métodos de instalação

Há alguns métodos alternativos para a instalação do Tableau Server.

- Se quiser um procedimento de início rápido para instalar o Tableau Server em um ambiente de não produção, consulte [Começar a instalação](https://help.tableau.com/current/server/pt-br/jumpstart.htm).
- Os tópicos incluídos nesta seção de instalação descrevem como instalar o Tableau Server no Windows usando o instalador interativo. Se você quiser instalar o Tableau Server usando uma linha de comando, consulte [Instalação automatizada do Tableau Server](https://help.tableau.com/current/server/pt-br/automated_install_windows.htm).
- Se estiver instalando o Tableau Server em um ambiente sem conexão à Internet, consulte [Instalar o Tableau Server em um ambiente desconectado (fisicamente isolado)](https://help.tableau.com/current/server/pt-br/install_air_gapped.htm).
- Além disso, é possível instalar o Tableau Server em várias plataformas de nuvem. Consulte [Auto-hospedar o Tableau Server em um serviço de nuvem pública](https://help.tableau.com/current/server/pt-br/ts_tableau_server_cloud_overview.htm).

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Antes de começar

Para instalar o Tableau Server, é necessário que o seu computador atenda aos requisitos de hardware. Você receberá uma mensagem que informa se o seu computador atende os requisitos mínimos, mas não satisfaz os requisitos mínimos recomendados. Neste caso, o hardware do computador pode suportar uma instalação de avaliação do Tableau, mas não é adequada para um ambiente de produção. Para obter mais informações, consulte [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm).

## Etapas de instalação

As etapas a seguir descrevem como instalar o Tableau Server em um único computador. Use as etapas para instalar o Tableau Server em uma implantação de servidor único. Use as etapas para instalar o nó inicial em uma implantação de vários nós do Tableau Server. Execute as etapas em sequência.

1. [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm)
2. [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm)
3. [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm)
4. [Adicionar uma conta de administrador](https://help.tableau.com/current/server/pt-br/startup.htm)

## Outros artigos nesta seção

<!-- document id=c4ded66e6f7f404f56595d2691bc8ed704771cf34650d69a6737662a22a25bca url=/tableau/current/pt-br/server/distrib_ha.md -->

[Pular para o conteúdo principal](#main-content)

# Instalações distribuída e de alta disponibilidade do Tableau Server

Este tópico descreve diferentes tipos de implantação de instalação para o Tableau Server.

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Tipos de instalação

A forma mais simples de executar o Tableau Server é instalar um nó único. Com esse tipo de instalação você terá um Tableau Server completamente funcional, com todos os processos do Tableau Services Manager (TSM) e do Tableau Server executados nesse nó único, mas essa pode não ser a melhor forma de usar o Tableau Server. A instalação do Tableau fica a seu critério, com base nas necessidades da sua empresa e nos seus recursos; adicione nós e configure o Tableau para alta disponibilidade. As opções de instalação incluem:

- **Instalação de nó único**—Esse tipo de instalação é razoável para testar, executar avaliações e para ambientes que aceitam tempos de inatividade ocasionais e disponibilidade de sistema devido a falta de redundância. Todos os processos do servidor são executados em uma única máquina. Há menos redundância e medidas de segurança no caso de um problema com um dos processos de servidor. Além disso, é necessário garantir que o computador em que o Tableau Server será instalado possui os recursos necessários para suportar os processos e demandas dos usuários e dos dados.
- **Instalação distribuída**—Esse tipo de instalação também é chamado de instalação de vários nós e requer vários computadores para instalar e executar os processos do servidor nos nós distribuídos. Espalhar os processos de servidor por vários nós pode aumentar a confiabilidade e eficácia do Tableau Server ao fornecer redundância e potência de computação adicional. Com a configuração adequada, uma instalação distribuída também pode fornecer um failover de repositório automático. Para obter informações sobre failover, consulte [Failover de repositório](https://help.tableau.com/current/server/pt-br/distrib_ha_failover.htm).
- **Instalação de alta disponibilidade (HA, High Availability)**—Uma instalação de alta disponibilidade do Tableau Server é um tipo especial da instalação de vários nós, com um mínimo de três nós e várias instâncias dos processos principais (Repositório, Processador de dados/Repositório de arquivos \[hyper\], Serviço de coordenação e Serviço de arquivo do cliente) em diversos computadores. Com esse tipo de instalação, há uma redundância integrada dos processos principais, incluindo vários Armazenamentos de arquivo e Failover de repositório automático. O objetivo é minimizar o tempo de inatividade do sistema, eliminando pontos únicos de falha e permitindo, sempre que possível, a detecção de falhas com failover.
    
    O tempo de inatividade ainda é possível no caso de uma falha inicial do nó ou quando um nó executando o Servidor de aplicativos (VizPortal) está se recuperando de uma falha. Painéis e exibições podem carregar mais lentamente do que o esperado, e tempos limite são possíveis, dependendo de como seu sistema está configurado e sendo usado. Para obter mais informações sobre a falha inicial do nó, consulte [Se um nó inicial falhar](#IfInitialNodeFails) abaixo.

O primeiro computador no qual você instalou o Tableau, o "nó inicial”, tem algumas características únicas. Três processos executam apenas no nó inicial e não podem ser movidos para qualquer outro nó exceto em uma situação de falha, o Serviço de Licença (Gerenciador de licenças), o Serviço de Ativação e o Controlador do TSM (Controlador de administração). O Tableau Server inclui um script que automatiza a movimentação desses processos para um dos outros nós existentes, para que obtenha acesso completo de volta ao TSM e mantenha o Tableau Server em execução.

Dois outros processos são inicialmente incluídos no nó inicial, mas podem ser adicionados ou movidos para nós adicionais, o CFS (Serviço de arquivos do cliente) e o Serviço de coordenação. Dependendo de como sua instalação foi configurada com o CFS e o serviço de coordenação, você também pode precisar tomar medidas para reimplantá-los.

Para obter informações sobre como mover o serviço de licenciamento e o controlador TSM do nó inicial para outro nó, consulte [Recuperar-se de uma falha no nó inicial](#Recover) abaixo.

### Repositório externo

Para obter o desempenho ideal do Tableau Server, recomendamos isolar o repositório em um nó dedicado em sua implantação. Se você tiver uma licença do Advanced Management, execute o repositório como um banco de dados externo.

Se sua organização tiver um pico de carga de mais de 1.000 sessões VizQL por hora, também recomendamos executar o Tableau Server no Linux. Neste cenário, as sessões VizQL referem-se a qualquer ação do usuário que exibe ou gera visualizações do Tableau Server.

Para obter mais informações, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server-linux/pt-br/server_external_repo.htm).

## Pré-requisitos

Estas instruções supõem que o cluster atende os [Requisitos distribuídos](https://help.tableau.com/current/server/pt-br/distrib_requ.htm).

Todos os nós em um cluster de vários nós devem ter o mesmo tipo de sistema operacional e a mesma versão principal desse sistema operacional. Por exemplo, todos os nós do Windows Server 2022 .

Você não pode instalar uma instância de vários nós do Tableau Server em uma combinação de nós do Linux e do Windows.

### Licenciamento

Você deve ter uma chave do produto válida para o Tableau Server. O tipo de licença que você tem pode determinar em quantos nós você pode instalar o Tableau. Para obter mais informações sobre licenciamento, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

## Criar uma instalação distribuída do Tableau Server

Estas são as etapas a serem seguidas para criar uma instalação distribuída do Tableau Server:

1. Comece com a instalação do Tableau Server no nó inicial.
    
    Para obter detalhes, consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).
2. Gere um arquivo de configuração do nó (bootstrap) no nó inicial.
    
    Para obter detalhes, consulte [Gerar o arquivo bootstrap do nó](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm#Generate_bootstrapCLI).
3. Instale o Tableau Server em um nó adicional usando o arquivo bootstrap do nó.
4. Configure o nó adicional com os processos que deseja executar nele.
5. Repita as Etapas 3 e 4 para todos os nós adicionais que deseja instalar.
6. Implante um novo ensemble do Serviço de coordenação.
    
    Para obter mais informações, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
7. Adicione o Serviço de arquivo do cliente a cada nó que está executando o Serviço de Coordenação.
    
    Para obter mais informações, consulte [Configurar Serviço de arquivo do cliente](https://help.tableau.com/current/server/pt-br/distrib_cfs.htm).

## Criar uma instalação de alta disponibilidade no Tableau Server

Uma instalação de alta disponibilidade do Tableau Server é um tipo especial de instalação distribuída, projetada para acomodar falhas nos componentes principais do servidor sem a perda da funcionalidade do servidor. Para criar essa instalação, siga as mesmas etapas usadas para criar uma implantação distribuída, mas inclua etapas adicionais, para que a implantação se torne altamente disponível. As etapas adicionais incluem ao menos dois nós adicionais (para garantir um mínimo de três nós no cluster), a adição de uma segunda instância do repositório e de uma segunda instância do processador de dados/repositório de arquivos, incluir processos de gateway adicionais e e a implantação de um ensemble do Serviço de Coordenação. Além disso, é possível adicionar um balanceador de carga para distribuir solicitações entre os processos de gateways.

Em um nível mais alto, estas são as etapas seguidas para criar uma instalação de alta disponibilidade do Tableau Server:

1. Comece com a instalação do Tableau Server no nó inicial.
    
    Para obter detalhes, consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).
2. Gere um arquivo de configuração do nó (bootstrap) no nó inicial.
    
    Para obter detalhes, consulte [Gerar o arquivo bootstrap do nó](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm#Generate_bootstrapCLI).
3. Instale o Tableau Server em ao menos um nó adicional usando o arquivo bootstrap do nó.
    
    Para obter mais informações, consulte [Instalar e configurar um nó adicional](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm#Install_additional_nodeCLI).
4. Configure cada nó adicional com os processos que deseja executar nele. Isso deve incluir uma segunda cópia do repositório do Tableau Server e uma segunda cópia do processador de dados e repositório de arquivos, assim como instâncias adicionais do gateway.
    
    Para obter mais informações, consulte [Configurar o nó adicional](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm#Config_additnl_nodeCLI).
5. Implante um ensemble do Serviço de coordenação.
    
    Para obter mais informações, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
6. Adicione o Serviço de arquivo do cliente a cada nó que está executando o Serviço de Coordenação.
    
    Para obter mais informações, consulte [Configurar Serviço de arquivo do cliente](https://help.tableau.com/current/server/pt-br/distrib_cfs.htm).
7. (Opcional) Configure um balanceador de carga.
    
    Para obter mais informações, consulte [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm).

Parar mais detalhes, consulte [Exemplo: Instalar e configurar um cluster HA de três nós](https://help.tableau.com/current/server/pt-br/distrib_ha_install_3node.htm).

## Se um nó inicial falhar

Se houver um problema com o nó inicial e você tiver processos redundantes em seus outros nós, não há garantia de que o Tableau Server continuará em execução.

- O Tableau Server pode continuar em execução por até 72 horas após uma falha inicial do nó, antes que a falta do serviço de licenciamento afete outros processos. Se afetar, seus usuários ainda poderão fazer logon, ver e usar seus conteúdos depois da falha no nó inicial, mas você não poderá reconfigurar o Tableau Server, pois não tem acesso ao Controlador de administração.
- Se você estiver executando uma versão do Tableau Server 2021.4.2 (ou anterior) configurada para ATR, os problemas com o nó inicial tornarão todas as funcionalidades do servidor indisponíveis. Isso é verdade se o nó tiver um problema ou se você o interromper intencionalmente (por exemplo, para fazer um patch no nível do sistema).

Mesmo quando configurado com processos redundantes, _é possível que o Tableau Server não continue a funcionar após a falha do nó inicial_. Isso acontece mesmo quando uma instalação é configurada para alta disponibilidade. Isso significa que é necessário mover os dois processos exclusivos para outro nó em execução o mais rápido possível. Se o seu nó inicial falhar por motivos que sejam recuperáveis em uma quantidade de tempo relativamente pequena (por exemplo, uma falha no hardware que você pode corrigir), em primeiro lugar, tente ativar o nó novamente sem usar o procedimento abaixo.

## Recuperar-se de uma falha no nó inicial

Com uma instalação do Tableau Server, o nó inicial inclui dois serviços que estão instalados apenas nesse nó, o serviço de licença e o Controlador de TSM. Se houver um problema com o nó inicial, o Tableau Server pode para de funcionar, mesmo se estiver configurado para alta disponibilidade. Para se recuperar de uma situação de falha do nó inicial, é possível mover o Controlador TSM e o Serviço de licença para um dos nós adicionais já configurados. Isso permite se recuperar da falha com recursos já existentes no cluster. Não é necessário configurar um nó inicial passivo caso o nó inicial falhe.

Para obter detalhes sobre como se recuperar de uma falha no nó inicial, consulte [Recuperação de falha no nó inicial](https://help.tableau.com/current/server/pt-br/distrib_ha_init_node_fail.htm).

## Configurar um ensemble do Serviço de coordenação em nós adicionais

A configuração de um Serviço de coordenação em vários nós fornece duplicação adicional de processos e, portanto, reduz a possibilidade do tempo de inatividade do servidor devido a um problema com um dos nós do Serviço de coordenação. Para obter detalhes sobre como implantar um ensemble do Serviço de coordenação em um cluster, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

## Adicionar o CFS (Serviço de arquivo do cliente) a nódulos adicionais

O Tableau Server exige pelo menos uma instância do CFS (Serviço de arquivo do cliente). Adicionar instâncias adicionais de CFS a outros nós fornece duplicação adicional de processos e, portanto, reduz a possibilidade do tempo de inatividade do servidor devido a um problema com um dos nós de CFS. Recomendamos que você configure uma instância do CFS (Serviço de arquivo do cliente) em cada um dos nós em que o Serviço de coordenação está implantado. Para obter detalhes sobre como configurar o CFS em outros nós, consulte [Configurar Serviço de arquivo do cliente](https://help.tableau.com/current/server/pt-br/distrib_cfs.htm).

## Verificação da licença de serviço do Tableau Server

Uma série de processos é instalada quando você instala o Tableau Server. Alguns destes processos dependem da existência de uma licença do Tableau Server válida, enquanto outros processos instalados não. O subconjunto do Tableau Server, que exige uma licença do Tableau Server válida, é considerado um "processo licenciado".

Quando um processo licenciado é iniciado ou reiniciado, ele verifica com o serviço do Gerenciador de licenças do Tableau Server no nó primário a existência de uma licença válida. Quando o Gerenciador de licenças valida a licença, o processo é totalmente funcional e capaz de responder às solicitações de outros processos doTableau Server. Depois que um processo licenciado receber uma confirmação do Gerenciador de licenças, ele não precisará confirmar novamente a licença por 72 horas ou até que o processo reinicie. Se o processo não conseguir verificar a licença (por exemplo, se o nó primário não estiver disponível), ele não funcionará, mas continuará a verificação da existência de uma licença válida até que ela seja confirmada. Para visualizar quando ocorreu a verificação de licenciamento mais recente, consulte os arquivos de log na pasta ou diretório `ProgramData\Tableau\Tableau Server\data\tabsvc\logs\licenseservice` . Para obter mais informações sobre processos licenciados, consulte [Processos licenciados](https://help.tableau.com/current/server/pt-br/processes.htm#LicensedProcess).

## Outros artigos nesta seção

<!-- document id=9b65705f63ab29deb98b737d42d79b9a1833162f2f219cdabeba4d487731fa41 url=/tableau/current/pt-br/server/install_additional_nodes.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar e configurar nós adicionais

Depois de instalar o Tableau Server em um computador (ou nó), o servidor estará pronto para uso, mas não possui redundância. Caso haja um problema com um processo ou com o computador em si, o Tableau Server pode ficar indisponível. Alem disso, todos os processos estão em execução em um único computador, então pode ocorrer disputa por recursos neste computador.

É possível estender a instalação do Tableau Server ao adicionar o Tableau aos nós adicionais, criando uma instalação distribuída. Este artigo descreve as etapas gerais para a instalação do Tableau Server em nós adicionais e supõe que o Tableau em já esteja instalado no nó inicial. Para obter mais informações sobre a instalação do Tableau no nó inicial, consulte [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm).

Se você estiver instalando o Tableau Server em vários nós, será necessário instalar e configurar um nó de cada vez. Isso facilita a solução de problemas que talvez você possa encontrar.

**Importante**: você deve adicionar e configurar nós adicionais quando puder concluir completamente o processo ao aplicar alterações pendentes. Adicionar um nó sem concluir, aplicando alterações pendentes, pode fazer com que os usuários não possam entrar no Tableau Server.

## Local da instalação

A localização da instalação do Tableau Server deve ser a mesma em todos os nós de um cluster. Isso é válido para instalações na localização padrão ou em localização não padrão.

### Gerar o arquivo bootstrap do nó

1. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração e, na caixa Adicionar um nó, clique em Baixar arquivo bootstrap.
    
    ![Uma lista de processos e o número de instâncias em uma implantação do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-linux-generate-bootstrap.png)
    
    O arquivo bootstrap é criado e copiado no computador local.
    
    As credenciais inseridas são incluídas no arquivo bootstrap, por padrão. Se você não quiser credenciais inseridas no arquivo bootstrap, desmarque a opção Incluir credenciais temporárias no arquivo. Se você quiser desabilitar completamente a capacidade de incluir credenciais inseridas nos arquivos bootstrap de nó, defina uma opção de configuração para o servidor. Consulte [features.PasswordlessBootstrapInit](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#pwdlessbootstrap) para obter mais detalhes.

### Instalar e configurar um nó adicional

Antes de começar, verifique se o arquivo bootstrap do nó está correto. Por exemplo, se tiver executado o `[tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#regenerate-tokens)` depois de gerar um arquivo bootstrap, a inicialização falhará.

1. Copie o instalador original usado no primeiro computador, juntamente ao arquivo bootstrap gerado e coloque-os em um local acessível do novo computador no qual o Tableau Server está sendo adicionado. Isso pode ser um compartilhamento de rede montado, ou diretamente no computador.
2. Se estiver executando um firewall local, será necessário configurar as regras de firewall para todos os nós no cluster. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall).
3. No novo nó, execute o programa de instalação do Tableau Server. Esse deve ser o mesmo programa de instalação executado no nó inicial para instalar o Tableau Server. Aceite os termos do contrato de licença e clique em **Avançar**.
4. O local de instalação deve ser o mesmo em todos os nós.
    
    Insira o local de instalação ou clique em Procurar para navegar até o local de instalação. Clique em **Próximo** para continuar.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/tsm-install-path.png)
5. Durante a instalação, você será solicitado a selecionar um tipo de instalação.
    
    Selecione Incluir nó adicional ao cluster do Tableau Server existente Clique em Próximo para continuar.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/tsm-install-type-additional.png)
6. A opção **Usar ATR para ativação do produto** definida para o Nó 1 será selecionada automaticamente:
    
    **Importante:** a partir da versão 2025.1.0, esta tela não será mais exibida. O serviço ATR é usado por padrão. Se você quiser usar o serviço de licenciamento legado, deverá instalar o Tableau Server a partir da linha de comando usando o `ACTIVATIONSERVICE` alterne para especificar a opção não padrão. Para obter mais informações, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm)
    
    ![](/tableau/current/pt-br/server/pt-br/Img/tsm-install-activation-type-additional.png)
    
    Clique em **Instalar** para continuar.
    
    Se o prompt do Windows Defender Firewall for exibido, clique em Permitir acesso. Pode ser necessário fazer isso várias vezes para que a instalação seja concluída.
7. No instalador, depois que os arquivos do Tableau Server forem copiados, você será solicitado a fornecer o arquivo bootstrap e o nome e a senha do administrador do TSM:
    
    ![Uma janela de configuração com campos em branco para o arquivo de Bootstrap, o nome de usuário do TSM e a senha do TSM.](/tableau/current/pt-br/server/pt-br/Img/tsm-installer-node-config.png)
    
    Insira o local do arquivo de inicialização ou clique em Procurar para navegar até o local. Se o arquivo de bootstrap não incluir credenciais inseridas ou se essas credenciais expiraram, digite o nome de usuário e a senha do administrador do TSM. Essas credenciais devem ser as do usuário usado durante o processo de instalação no nó inicial.
    
    Clique em Próximo para continuar.
8. Uma janela do navegador é aberta e você é solicitado a fazer logon no TSM. Insira o nome de usuário e a senha do administrador do TSM.
    
    Se nenhuma janela do navegador for aberta automaticamente, abra uma janela e navegue até o TSM:
    
    `https://<tsm-computer-name>:8850`
9. No TSM, clique em Configuração.
    
    Uma mensagem é exibida, informando que o nó foi adicionado:
    
    ![Mensagem indicando que um novo nó foi adicionado a um cluster no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-node-added.png)
10. Clique em Continuar.

### Configurar o nó adicional com o controlador de cluster

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração. Uma mensagem deve informar que o novo nó foi adicionado.
    
    ![Mensagem indicando que um novo nó foi adicionado a um cluster no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-node-added.png)
    
    Clique em Continuar para descartar a mensagem.
3. O Controlador de cluster faz parte da topologia mínima e já está selecionado. Cada nó deve executar o Controlador de cluster.
    
    Se você quiser definir apenas a topologia mínima para o nó, vá para a Etapa 4 abaixo. Você pode fazer isso se estiver incluindo nós adicionais e não estiver pronto para configurar esse nó além do mínimo.
    
    Se quiser incluir processos adicionais na topologia mínima, especifique os processos que deverão ser executados no nó. Faça isso selecionando os processos desejados ou especificando o número de processos que devem ser executados no nó.
    
    Por exemplo, para adicionar um Gateway e duas instâncias do Processador em segundo plano no nó:
    
    1. Selecione Gateway.
    2. Defina a contagem do Processador em segundo plano como 2.
        
        Adicionar o processador em segundo plano a um nó também adicionará uma instância do processador de dados caso ainda não exista uma no nó.
    
    Os processos específicos e as contagens de processos definidos dependerão do ambiente e das necessidades organizacionais. Ao adicionar um outro processo, alguns processos são adicionados automaticamente. Para obter mais informações, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm) e [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).
    
    **Observação:** a interface de usuário na Web do TSM limita a um máximo de 8 instâncias de processos que permitem selecionar o número de instâncias. Para configurar mais instâncias, use a linha de comando e o comando `TSM topology set-process` . Para obter mais informações, consulte [tsm topology set-process](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess).
4. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
    
    Se você estiver configurando um cluster de três ou mais nós, um aviso de ensemble do Serviço de coordenação será exibido. Você pode continuar. Você implantará um ensemble do Serviço de coordenação em uma etapa separada.
5. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.
    
    Depois que o Tableau Server reiniciar, o nó é incluído com a topologia mínima necessária e qualquer processo adicional configurado por você.

**Observação:** esse método de instalação a partir da linha de comando requer que você defina as variáveis de ambiente do Windows em cada nó adicional para o nome de usuário e senha de um administrador no nó inicial. Para obter um método de automação alternativo da instalação do Tableau Server sem a inclusão de credenciais codificadas, consulte [Instalação automatizada do Tableau Server](https://help.tableau.com/current/server/pt-br/automated_install_windows.htm).

### Gerar o arquivo bootstrap do nó

Para instalar o Tableau Server em mais computadores, use o mesmo instalador usado no nó inicial e o arquivo "bootstrap" gerado no nó inicial.

**Importante**: o arquivo do bootstrap contém uma cópia do arquivo do repositório de chaves principal, usado para criptografar os segredos da configuração. O arquivo também pode ter credenciais inseridas válidas por um período predeterminado (consulte [tabadmincontroller.auth.expiration.minutes](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#tabadminctrlrauthexpire)) e servir como um cookie de sessão. Recomendamos fortemente que você tome medidas adicionais para proteger o arquivo bootstrap.

1. Após instalar o Tableau Server no nó inicial, gere o arquivo bootstrap do nó.
2. No nó inicial, abra um prompt de comando como um administrador.
3. Digite este comando para gerar o arquivo bootstrap:
    
    `tsm topology nodes get-bootstrap-file --file <path\file>.json`
    
    As credenciais inseridas são incluídas no arquivo bootstrap, por padrão. Se você não quiser que o arquivo bootstrap inclua credenciais, use a opção `-nec` ou `--no-embedded-credentials`:
    
    `tsm topology nodes get-bootstrap-file --file <path\file>.json --no-embedded-credentials`.
    
    Se você quiser desabilitar completamente a capacidade de incluir credenciais inseridas nos arquivos bootstrap de nó, defina uma opção de configuração para o servidor. Consulte [features.PasswordlessBootstrapInit](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#pwdlessbootstrap) para obter mais detalhes.

### Instalar e configurar um nó adicional

1. Copie o instalador original usado no primeiro computador, juntamente ao arquivo bootstrap gerado e coloque-os em um local acessível do novo computador no qual o Tableau Server está sendo adicionado. Isso pode ser um compartilhamento de rede montado, ou diretamente no computador.
2. Se estiver executando um firewall local, será necessário configurar as regras de firewall para todos os nós no cluster. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall).
3. No novo nó, execute o programa de instalação do Tableau Server. Esse deve ser o mesmo programa de instalação executado no nó inicial para instalar o Tableau Server.
    
    TableauServer-64bit-<version>.exe /silent ACCEPTEULA=1 EMBEDDEDCREDENTIAL=1 BOOTSTRAPFILE="path\\bootstrapfile"
    
    Para obter mais informações sobre os switches que você pode usar com o Programa de instalação, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm).

### Configurar o nó adicional

**Observação:** este exemplo básico ilustra como configurar a topologia em um nó. Para um exemplo mais detalhado sobre como trabalhar em vários nós, consulte [Exemplo: Instalar e configurar um cluster HA de três nós](https://help.tableau.com/current/server/pt-br/distrib_ha_install_3node.htm).

No nó inicial (original), defina a topologia para o nó rescem adicionado. A topologia determina quais processos devem ser executados no nó e quantas instâncias de cada processo devem ser executadas. A topologia para o nó dependerá do ambiente e das necessidades organizacionais. Veja abaixo exemplos de configuração da topologia.

1. No nó inicial (original), abra um prompt de comando.
2. Obtenha o node-id do novo nó:
    
    tsm topology list-nodes -v
    
    A opção `-v` lista os nós e processos em execução. Você pode identificar o nó recém adicionado porque ele não apresentará nenhum processo.
3. Especifique os processos individuais que devem ser executados neste nó:
    
    Execute essa ação com o segunte comando:
    
    `tsm topology set-process -n <nodeID> -pr <processname> -c <n>`
    
    É obrigatório adicionar uma instância do Controlador de cluster em cada nó.
    
    Por exemplo, para adicionar o Controlador de cluster, duas instâncias do Processador em segundo plano e um Gateway ao node2:
    
    tsm topology set-process -n node2 -pr clustercontroller -c 1
    tsm topology set-process -n node2 -pr backgrounder -c 2
    tsm topology set-process -n node2 -pr gateway -c 1
    
    Os processos específicos e as contagens de processos definidos dependerão do ambiente e das necessidades organizacionais. Ao adicionar um outro processo, alguns processos são adicionados automaticamente. Para obter mais informações, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm) e [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).
4. Aplique a configuração do nó. 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).
    
    `tsm pending-changes apply`
    
    Um aviso sobre a implantação de um ensemble do Serviço de coordenação será exibido se você tiver implantado um cluster de três ou cinco nós. Se esse for o único aviso, é possível substituí-lo com segurança usando a opção `--ignore-warnings` para aplicar as alterações de configuração apesar do aviso.
    
    ```
    tsm pending-changes apply --ignore-warnings
    ```

## Instalar drivers

É necessário instalar drivers para que o Tableau Server possa se conectar aos dados que executam as extrações. Instale os drivers em nós que estejam executando qualquer um dos seguintes processos:

- VizQL Server (vizqlserver)
- Servidor de aplicativos (vizportal)
- Servidor de dados (dataserver)
- Processador em segundo plano (backgrounder)

### Drivers e exibições administrativas

Se quiser usar as exibições administrativas integradas no Tableau Server, também é necessário instalar o driver do PostgreSQL em qualquer nó que estiver executando algum dos processo acima.

Para obter mais informações, consulte [Drivers de banco de dados](https://help.tableau.com/current/server/pt-br/dbdriver.htm).

## Instalar o agente Resource Monitoring Tool do Tableau

Se estiver usando o Resource Monitoring Tool para monitorar o Desempenho do Servidor Tableau, ao adicionar um novo nó, também deve instalar o Resource Monitoring Tool. Para obter mais informações, consulte [Alterações de topologia do Tableau Server](https://help.tableau.com/current/server/pt-br/rmt-tableau-server-topology-changes.htm).

<!-- document id=7a4a174b5f617e0a1eb1a9d354d861ac919c4b16dda99035b2ae92cb53c4f65e url=/tableau/current/pt-br/server/rmt-admin-agent-install-cli.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Agente usando a linha de comando

O Agente é um processo leve que consome recursos mínimos do servidor e envia dados ao Resource Monitoring Tool Server (RMT Server). Instale o Agente do Resource Monitoring Tool em cada um dos nós do Tableau Server. Para instalar e registrar um Agente, baixe o arquivo de configuração bootstrap do agente e salve-o em um local acessível a partir dos nós do agente Resource Monitoring Tool.

Este tópico descreve as etapas que você pode usar para instalar o Agente do Resource Monitoring Tool usando a linha de comando. A instalação da linha de comando é aceita em sistemas operacionais Windows e Linux.

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## Antes da instalação

- Faça download do arquivo de inicialização e salve-o em um local acessível aos nós nos quais você instalará o Agente RMT. **Os arquivos de bootstrap são válidos apenas por 24 horas após o download. Você precisará gerar novamente o arquivo de bootstrap se aquele que você está usando tiver mais de 24 horas.**
- O registro do Agente precisará se comunicar por meio de um ponto de extremidade https e RabbitMQ para concluir. Certifique-se de que ambas as portas 443 e 5672 estejam abertas para essas comunicações.

**Para instalar e configurar o Agente:**

1. Baixe o arquivo bootstrap e salve-o em um local que pode ser acessado no Tableau Server.
    
    `rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>`
2. Execute o programa de instalação do Agente:
    1. Baixe o instalador do Agente e salve-o em um local que você pode acessar nas máquinas do Tableau Server.
    2. Abra o prompt de comando como um administrador.
    3. Navegue até a localização do instalador do Agente e execute o arquivo **exe** usando o seguinte comando
        
        `Tabrmt-Agent-64bit-<version>.exe /silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password>`
        
        A partir de 2021.4, você deve especificar uma conta de usuário Run As para o agente. Essa conta é usada para acessar o Tableau Server para coletar informações de monitoramento.
        
        Para a conta de usuário Run As, especifique a mesma conta que você usa atualmente para a conta de usuário do Tableau Server. Se as informações da conta que você fornecer não forem iguais às do Tableau Server, o Agente não poderá coletar os dados de monitoramento nesse nó.
        
        - Use RUN\_AS\_NETWORK\_SERVICE=1 se o seu Tableau Server estiver configurado para usar a conta do serviço de rede como o usuário Run As.
        - Use RUN\_AS\_USER\_CUSTOM=1 se o Tableau Server estiver configurado para usar um usuário personalizado. Use as mesmas credenciais de conta especificadas para o Tableau Server.
        
        A pasta de instalação padrão é normalmente parecida com _C:\\Program Files\\Tableau\\Tableau Resource Monitoring Tool\\agent_. Para fornecer um local de instalação diferente, execute o seguinte comando:
        
        `Tabrmt-Agent-64bit-<version>.exe/silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password> InstallFolder="D:\Tableau Resource Monitoring Tool\agent"`
        
        > [!TIP]
        > 
        > **Observação:** use o switch /silent ou /quiet para executar a configuração sem vigilância e sem exibir qualquer interface do usuário ou prompts.
3. Registre o Agente:
    1. Execute o seguinte comando para registrar o Agente:
        
        `rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username <name of the RMT admin user> --password <password for the user account>`
        
        A tabela a seguir lista as opções de configuração usadas para registrar o Agente:
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th><p>Padrão</p></th><th>Descrição</th></tr></thead><tbody><tr><td>--bootstrap file</td><td>Sim</td><td>&lt;nenhum&gt;</td><td>A localização do arquivo bootstrap.</td></tr><tr><td>--username</td><td>Sim</td><td>&lt;nenhum&gt;</td><td>Normalmente, é o usuário administrador que você criou durante a instalação do RMT Server.</td></tr><tr><td>--password</td><td>Sim</td><td>&lt;nenhum&gt;</td><td>Esta é a senha da conta do usuário</td></tr><tr><td>--password-file</td><td><p>Não</p><p>A senha pode ser fornecida na linha de comando ou em um arquivo que contenha a senha. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>&lt;nenhum&gt;</td><td>Caminho incluindo o nome do arquivo onde a senha está armazenada.</td></tr><tr><td>--server-name</td><td>Não</td><td>Nome do host da máquina</td><td>Nome do computador que tem o Agente instalado. Se nenhuma opção for fornecida, este campo será padrão para o nome host da máquina.</td></tr><tr><td>--server-description</td><td>Não</td><td>&lt;nenhum&gt;</td><td>Descrição do computador que tem o Agente instalado. Se nenhuma opção for fornecida, este campo permanecerá em branco.</td></tr></tbody></table>
        
        ### O Windows instala propriedades e switches
        
        **Switches:**
        
        | Switch | Descrição | Comentários |
        | --- | --- | --- |
        | `/passive` | Execute a Instalação com interface do usuário mínima e sem prompts. |   |
        | `/quiet | /silent` | Executar a instalação em modo totalmente silencioso e não supervisionado. Nenhuma interface da Web ou prompts são exibidos. | Use /quiet ou /silent, não ambos. |
        
        Propriedades:
        
        <table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Propriedade</th><th>Descrição</th><th>Comentários</th></tr></thead><tbody><tr><td><code>InstallFolder=&lt;path\to\installation\directory&gt;</code></td><td>Instalar no local de instalação não padrão especificado.</td><td><p>Especifica a localização para instalar o RMT. Se não for usado, o RMT é instalado <i>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master</i>.</p><p>Exemplo: <code>&lt;Setup file&gt; /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"</code></p></td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>Aceita o Contrato de licença do usuário final (EULA). Exigido para instalação quieta, silenciosa e passiva nos nós inicial e adicional. 1 = true, aceita o EULA, 0 = false, não aceita o EULA.</td><td>Se não estiver incluído quando /passive, /silent ou /quiet forem utilizados, a configuração falhará de modo silencioso. Se incluído, mas definido como 0, a instalação falha.</td></tr></tbody></table>

**Para instalar e configurar o Agente:**

1. **Instalar:**
    1. Baixe o instalador do atente .rpm ou .deb e salve-o em um local que você pode acessar na máquina onde você planeja instalar o Agente.
    2. Execute o seguinte comando para instalar o Agente, onde <version> é formatado como manutenção major-minor-maintenance:
        
        Para distribuições semelhante a RHEL, incluindo CentOS:
        
        `sudo yum install Tabrmt-Agent-x86_64-<version>.rpm`
        
        Para o Ubuntu:
        
        `sudo apt install Tabrmt-Agent-amd64-<version>.deb`
2. **Inicializar RMT Agent:**
    
    Você deve aceitar explicitamente o Contrato de licença de usuário final (EULA) ao inicializar o RMT Agent. Você também tem a opção de especificar configurações não padrão. Para inicializar o RMT Agent com uma configuração padrão, execute este comando:
    
    sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula
    
    O EULA ser encontrado na pasta `/opt/tableau/tabrmt/agent/docs`.
    
    A partir da versão 2023.1, você pode especificar uma conta Run As personalizada a ser usada pelo RMT, bem como outras opções de configuração. Por padrão, o RMT cria e usa uma conta chamada `rmt-agent` para execução subjacente. Para especificar uma conta Run As personalizada a ser usada pelo RMT Agent, inclua a opção `--unprivileged-user` ao executar o script de inicialização. Para obter informações sobre todos os switches disponíveis para o script `initialize-rmt-agent`, veja [Opções de script de inicialização do RMT Agent](https://help.tableau.com/current/server/pt-br/rmt-install-init-agent-opts.htm#RMTServerInitOpts).
3. **Registrar:**
    1. Saia e entre como _tabrmt-agent_ para que você possa executar comandos rtmadmin que sempre exigem que você execute como _tabrmt-agent_. Além disso, ao entrar novamente, crie uma nova sessão na qual as alterações de associação ao grupo já foram efetivadas.
        
        `sudo su --login tabrmt-agent`
    2. Execute o seguinte comando e forneça o caminho onde o arquivo bootstrap está localizado. Forneça o nome amigável e uma descrição do nó onde o Agente está sendo instalado.
        
        `rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --agent-description=<server description> --username=<name of the RMT admin user>`
        
        Será solicitada a senha do usuário do administrador do RMT.
        
        **Observação:** o usuário não pode executar comandos `tabrmt-agent` do diretório de trabalho base: `/var/opt/tableau/tabrmt/agent`, portanto, você deve especificar o caminho completo do arquivo de acordo. Por exemplo, se você colocar o arquivo bootstrap na pasta `/var/opt/tableau/tabrmt/agent/bootstrap/` conforme recomendado, o caminho do arquivo seria `/var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.json`
        
        A tabela a seguir lista as opções de configuração usadas para registrar o Agente:
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th>Padrão</th><th>Descrição</th></tr></thead><tbody><tr><td>--bootstrap file</td><td>Sim</td><td>&lt;nenhum&gt;</td><td>A localização do arquivo bootstrap.</td></tr><tr><td>--username</td><td>Sim</td><td>&lt;nenhum&gt;</td><td>Normalmente, é o usuário administrador que você criou durante a instalação do RMT Server.</td></tr><tr><td>--password</td><td>Sim</td><td>&lt;nenhum&gt;</td><td>Esta é a senha da conta do usuário</td></tr><tr><td>&nbsp;</td><td><p>Não</p><p>A senha pode ser fornecida na linha de comando ou em um arquivo que contenha a senha. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>&lt;nenhum&gt;</td><td>Caminho incluindo o nome do arquivo onde a senha está armazenada.</td></tr><tr><td>--server-name</td><td>Não</td><td>Nome do host da máquina</td><td>Nome do computador que tem o Agente instalado. Se nenhuma opção for fornecida, este campo será padrão para o nome host da máquina.</td></tr><tr><td>--server-description</td><td>Não</td><td>&lt;nenhum&gt;</td><td>Descrição do computador que tem o Agente instalado. Se nenhuma opção for fornecida, este campo permanecerá em branco.</td></tr></tbody></table>

### Instalação do agente em vários nós do Tableau Server

Execute as etapas descritas acima em cada um dos nós do Tableau Server. Na interface da Web do RMT Server você deve ser capaz de ver todos os nós onde o Agente está instalado.

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

**Windows:**

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.

**Linux:**

- Acesso do sudo completo para a conta de usuário que é usada para instalar o Agente.

## Próxima etapa

[Configurar Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-config-index-config.htm)

<!-- document id=c1d7d25945247eb61667306a73e79daee4d4e6e1d1f5d76249d24ec91a2d58bc url=/tableau/current/pt-br/server/rmt-admin-agent-install.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Agente usando interface da Web

O Agente é um processo leve que consome recursos mínimos do servidor e envia dados ao Resource Monitoring Tool Server (RMT Server). Instale o Agente do Resource Monitoring Tool em cada um dos nós do Tableau Server. Para instalar e registrar um Agente, baixe o arquivo de configuração bootstrap do agente e salve-o em um local acessível a partir dos nós do agente Resource Monitoring Tool.

Atualmente, a instalação pela interface da Web é aceita apenas em instalações do Windows. Se você quiser instalar no Linux, consulte [Instalar o Agente usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install-cli.htm).

**Observação**: a partir da versão 2026.3.4, uma atualização para o instalador do Windows alterou um pouco o fluxo de trabalho de instalação.

## Antes da instalação

- Baixe o arquivo bootstrap. **Os arquivos de bootstrap são válidos apenas por 24 horas após o download. Você precisará gerar novamente o arquivo de bootstrap se aquele que você está usando tiver mais de 24 horas.**
- O registro do Agente precisará se comunicar por meio de um ponto de extremidade https e RabbitMQ para concluir. Certifique-se de que ambas as portas 443 e 5672 estejam abertas para essas comunicações.

## Etapas para baixar o arquivo bootstrap do agente

Use as etapas a seguir se ainda não tiver baixado o arquivo bootstrap do RMT Server.

1. Usando a interface na Web (_https://<hostname>_) no RMT Server, no menu Admin, selecione Environments.
2. O arquivo bootstrap pode ser baixado diretamente da guia Visão geral do ambiente na página inicial.
    
    **Observação:** se você não criou um ambiente como parte da configuração do RMT Server, siga as etapas de 12 a 15 descritas no tópico [Instalar o RMT Server usando interface da Web](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install.htm).
3. Salve o arquivo de configuração bootstrap em um local acessível a partir dos nós do Tableau Server onde você instalará o Agente Resource Monitoring Tool.

## Etapas para instalar o Agente

Atualmente, a instalação através da interface da Web é aceita apenas em instalações do Windows. Se você quiser instalar no Linux, consulte [Instalar o Agente usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install-cli.htm).

**Para instalar o Agente, em cada um dos nós do Tableau Server:**

1. Execute o programa de instalação do Agente.
2. Após ler o EULA, selecione I agree to the license terms and conditions e clique em Install.
    
    **Observação:** se quiser instalar em um local não padrão, use as diretrizes fornecidas na seção [Instalação em um local não padrão](#Installi). O local padrão é **C:\\Program Files\\Tableau\\Tableau Resource Monitoring Tool\\**.
3. Na próxima caixa de diálogo, você precisa confirmar a conta Usuário Run As para o Agente.
    
    Clique em Yes para confirmar a conta padrão ou em No para especificar uma conta de usuário personalizada.
    
    **Importante:** se as informações da conta que você fornecer não forem iguais às do Tableau Server, o Agente não poderá coletar os dados de monitoramento nesse nó.
4. Se a caixa de diálogo Controle de conta do usuário for aberta, clique em Yes para permitir que o instalador faça alterações.
5. Quando o instalador for concluído, uma página da Web Agent Registration será aberta.
    
    > [!TIP]
    > 
    > **Dica!** Pode demorar um pouco para a página da Web abrir. Se a página da Web não abrir por algum motivo, utilize a seguinte URL na máquina que você está instalando:
    
    http://localhost:9002/setup/register
6. Revise as informações nesta página sobre o tamanho do arquivo de registro do Tableau Server, dados históricos e implicações. Após prosseguir para a próxima etapa, você não visualizará mais estas informações.
    
    Depois que o Agente é instalado e registrado, o Resource Monitoring Tool processa dados históricos relevantes de registros do Tableau Server antes de os dados serem exibidos. Se houver um grande volume de dados históricos de registro, talvez demore para processar as informações que, por sua vez, podem resultar em um atraso no processamento de eventos mais recentes no Servidor.
    
    Se estiver preocupado com o atraso e não tiver as informações históricas, você poderá fazer o seguinte para limpar os arquivos de registro existentes do Tableau:
    
    [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm) e considere os [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm) antes de remover os arquivos de registro.
    
    **Observação:** os dados de desempenho, como uso de CPU e uso de memória não são reunidos usando dados de registro histórico, e são coletados depois que o Agente é instalado e configurado para que a limpeza de dados históricos não afete os dados de desempenho.
7. Navegue até o local do arquivo bootstrap que você baixou do RMT Server. Clique em Import Bootstrap File. **Os arquivos de bootstrap são válidos apenas por 24 horas após o download. Você precisará gerar novamente o arquivo de bootstrap se aquele que você está usando tiver mais de 24 horas.**
8. Quando a importação for concluída com êxito, uma página da Web será exibida para inserir as informações do servidor. No campo Tableau Server gateway URL, digite a URL usada para acessar o Tableau Server.
    
    A URL deve ser semelhante aos exemplos abaixo:
    
    - https://MarketingServer/ (se souber o nome do servidor)
    - https://10.0.0.2/ (se souber o endereço IP do servidor)
    - http://10.0.0.4/ (Se o Tableau Server não estiver habilitado para usar SSL)
9. Insira o nome de usuário e a senha. Você pode usar as credenciais do usuário administrador que criou quando instalou o RMT Server. Esse nome de usuário e senha são usados para comunicações entre o RMT Server e o Agente.
10. Clique em Test Tableau Server Connection para verificar se o Agente consegue acessar o Tableau Server.
    
    Uma mensagem Success será exibida para confirmar que o Agente pode se conectar ao Tableau.
11. O campo RMT Server URL já deve estar preenchido usando as informações no arquivo bootstrap. Esta é a URL da página da Web usada para realizar tarefas de administração, monitorar o desempenho e outras tarefas.
    
    A URL deve ser semelhante ao exemplo abaixo:
    
    - _https://<hostname>_)
12. Clique em Test RMT Server Connection para verificar se o Agente consegue acessar o RMT Server do Resource Monitoring Tool.
    
    Uma mensagem Success será exibida para confirmar a conexão com o RMT Server.
13. O campo **RMT Server certificate thumbprint** já deve estar preenchido usando as informações no arquivo bootstrap. O arquivo bootstrap salvo deve ter essas e as informações de URL do RMT Server. Insira o nome de usuário e a senha do RMT Server. Este usuário deve ter a função de **Gerenciamento de servidor/ambiente**.
    
    Clique em Get Registration Options.
    
    Isso direciona você à página **Agent Registration - Message Queue**.
14. Clique em Test Message Queue Connection para verificar se a conexão da fila de mensagens está funcionando.
    
    Uma mensagem Success será exibida se a conexão funcionar.
    
    **Observação:** a configuração **Habilitar TLS** na seção de fila de mensagens permite habilitar a criptografia quando os dados são transmitidos entre o RMT Server e os Agentes. Isso exige uma configuração adicional do RabbitMQ. Para obter mais informações, consulte [Coleta de dados criptografados](https://help.tableau.com/current/server/pt-br/rmt-admin-encrypted-data-collection.htm).
15. Na página final Registro do agente, a seção de ambiente já deve estar preenchida. Verifique as informações e adicione detalhes do nó do Tableau Server.
16. Clique em Connect to Message Queue.
17. Clique em Register Agent para concluir a instalação e a configuração do agente.
    
    Você verá uma opção para desabilitar a interface da Web. Após o registro, a interface da Web não é mais necessária para o agente e pode opcionalmente ser desabilitada. Se você precisar reativar a interface da Web, utilize o seguinte comando:
    
    `rmtadmin set server.web.run true`
    
    Para obter mais informações sobre os comandos do Resource Monitoring Tool, consulte o [Utilitário de linha de comando rmtadmin](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm).
18. Verifique se o Agente está conectado ao acessar a interface na Web do RMT Server. No menu Admin, selecione **Environments** e, em Detalhes do ambiente, você verá o número de Agentes que estão conectados no momento.

### Instalação do agente em uma instalação de vários nós do Tableau Server

1. Siga as etapas descritas acima para instalar o Agente no nó inicial do Tableau Server para se conectar ao Resource Monitoring Tool.
2. Na seção **Server** da página de registro final, marque a opção Primary Server.
3. Nos nós adicionais do Tableau Server, instale o agente usando o mesmo arquivo bootstrap usado para instalar o agente no nó inicial e siga as etapas descritas acima.
4. Na página de registro final, na seção **Ambiente**, selecione o ambiente que você criou ao instalar o Agente no nó inicial.
5. Na seção **Server**, selecione a opção **New Environment Server**. A opção Servidor primário deve permanecer desmarcada.
6. O processo de registro do agente adiciona automaticamente esse nó ao ambiente existente.

## Instalação em um local não padrão

O Tableau recomenda usar _\\Tableau\\Tableau Resource Monitoring Tool\\agent_ como local, a fim de atender aos pré-requisitos. Exemplo de local não padrão: **D:\\Tableau\\Tableau Resource Monitoring Tool\\agent**.

**Para escolher um local não padrão durante a instalação da versão 2025.3.4 ou posterior, siga estas etapas:**

1. Execute o instalador do Agente.
2. Na página de boas-vindas, escolha **Opções**.
3. Em **Opções de configuração**, no campo **Local de instalação**, insira o local.
4. Continue com a Etapa 2 da instalação, como descrito em [Instalar o Agente usando interface da Web](#InstallAgent).

**Para escolher um local não padrão durante a instalação das versões 2025.3.3 ou anteriores, siga estas etapas:**

1. Execute o instalador do Agente.
2. Na página do EULA, escolha **Personalizar**.
3. Em **Opções de configuração**, no campo **Local de instalação**, insira o local.
4. Continue com a Etapa 2 da instalação, como descrito em [Instalar o Agente usando interface da Web](#InstallAgent).

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.

## Próximas etapas

[Configuração do servidor do Resource Monitoring Tool](https://help.tableau.com/current/server/pt-br/rmt-config-configGui.htm#post-install-config)

<!-- document id=e78c9aefe6280bf08a01214fe804f9c55cf871bb7da7ae62342c18129f9c50a7 url=/tableau/current/pt-br/server/rmt-admin-master-install-cli.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o RMT Server usando a linha de comando

O Resource Monitoring Tool Server (RMT Server) hospeda o aplicativo Web com os quais os usuários interagem. Ele também faz grande parte do processamento em segundo plano para agrupar e monitorar os dados dos Agentes. O RMT Server deve ser instalado no hardware dedicado.

Este tópico descreve as etapas que você pode usar para instalar o RMT Server usando a linha de comando. A instalação da linha de comando é aceita em sistemas operacionais Windows e Linux.

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

**Para instalar o RMT Server:**

1. **Execute o programa de instalação do RMT Server:**
    
    1. Baixe o instalador do RMT Server e salve-o em um local que você pode acessar na máquina onde você planeja instalar o RMT Server.
    2. Abra o prompt de comando como um administrador.
    3. Navegue até a localização do instalador do RMT Server e execute o arquivo exe usando o seguinte comando
        
        `Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1`
        
        > [!TIP]
        > 
        > **Observação:** use o switch /silent ou /quiet para executar a configuração sem vigilância e sem exibir qualquer interface do usuário ou prompts.
        
        A pasta de instalação padrão é normalmente parecida com _C:\\Program Files\\Tableau\\Tableau Resource Monitoring Tool\\master_. Para fornecer um local de instalação diferente, execute o seguinte comando:
        
        `Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1 InstallFolder="D:\Tableau Resource Monitoring Tool\master"`
        
        A lista completa de todas as propriedades de comando de instalação e switches pode ser encontrada [nesta seção](#Windows-install-switches)abaixo.
    
    Isso instala o pacote e os pré-requisitos, incluindo RabbitMQ, Erlang e um banco de dados PostgreSQL. O banco de dados PostgreSQL é usado para armazenar dados de uso coletados do Tableau Server. Em seguida, ele vai instalar o RMT Server.
2. **Configuração do RMT Server:**
    1. Execute o seguinte comando e forneça as opções:
        
        `rmtadmin master-setup [options]`
        
        As opções de configuração podem ser fornecidas através do prompt de comando, um arquivo de configuração. Se você não fornecer as opções, os valores padrão serão aplicados, exceto pela senha do administrador. O nome de usuário do administrador será definido como administrador e você será solicitado a fornecer a senha.
        
        Comando de exemplo, incluindo o parâmetro de senha necessário:
        
        `rmtadmin master-setup --admin-username=<name the administrator user> --admin-password=<administrator user password>`
        
        A tabela a seguir lista as opções necessárias e algumas opções comumente usadas para configurar o RMT Server. Para obter uma lista completa das opções de configurações, consulte o [Utilitário de linha de comando rmtadmin](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm).
        
        **Observação:** exigir opção HTTPS garante comunicações seguras entre o RMT Server e os usuários. Quando você precisa de HTTPS para comunicações, você também deve selecionar um modo para o certificado que deve ser usado para essas comunicações. A tabela abaixo inclui as várias opções. Para saber mais sobre esses modos e certificados, consulte [Requisitos e modo de certificado SSL](https://help.tableau.com/current/server/pt-br/rmt-admin-installation.htm#SSL-Win)
        
        <table style="width: 100%;" class="simple-table"><colgroup><col style="width: 115px;"><col><col><col></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th>Padrão</th><th>Descrição</th></tr></thead><tbody><tr><td>admin-password</td><td><p>Sim</p><p>A senha pode ser fornecida na linha de comando ou fornecer um arquivo com a senha a ser usada. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>n/a</td><td>A senha do usuário administrador.</td></tr><tr><td>admin-password-file</td><td><p>Não</p><p>A senha pode ser fornecida na linha de comando ou fornecer um arquivo com a senha a ser usada. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>n/a</td><td>O arquivo onde a senha do usuário administrador é armazenada.</td></tr><tr><td>admin-username</td><td>Não</td><td>admin</td><td>O nome de usuário administrador.</td></tr><tr><td>http-port</td><td>Não</td><td>80</td><td>&nbsp;</td></tr><tr><td>require-https</td><td>Não</td><td>True</td><td>Se <code>True</code>, http não estará disponível. <br><br>Se <code>False</code>, http encaminhará para https.</td></tr><tr><td>https-certificate-mode</td><td>Não</td><td><p>'Padrão'</p><p>Opções disponíveis:</p><ul><li>Padrão</li><li>De identidade</li><li>Local</li></ul></td><td><p>O tipo de pesquisa de certificado para realizar o certificado HTTPS.</p><p><b>Padrão:</b> este modo usa o certificado de autoassinatura padrão fornecido pelo instalador.</p><p><b>Armazenamento:</b> permite que você digite a impressão digital de um certificado na loja de certificados do Windows.</p><p><b>Local:</b> permite especificar um certificado baseado em arquivo na pasta  <b>/config.</b></p></td></tr><tr><td>https-certificate-store-thumbprint</td><td>Não</td><td>Nulo</td><td>O certificado HTTPS hash/impressão digital para procurar no modo de certificado 'store'.</td></tr><tr><td>https-certificate-local-nome</td><td>Não</td><td><p>Nulo</p><p>Nota: se não especificado, o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> é instalado com um certificado autoassinado e usará esse certificado para comunicações HTTPS.</p></td><td>O nome do arquivo de certificado HTTPS sem a extensão do arquivo.</td></tr><tr><td>https-certificate-local-senha</td><td>Não</td><td>Nulo</td><td>A senha a ser usada para o certificado HTTPS.</td></tr><tr><td>https-certificate-local-password-file</td><td>Não</td><td>Nulo</td><td>O caminho para o arquivo contendo a senha a ser usada para o certificado HTTPS.</td></tr></tbody></table>
3. **Crie um ambiente:**
    
    1. Execute o seguinte comando para criar um ambiente:
        
        `rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>`
        
        Configure o ambiente usando as opções disponíveis para este comando. Aqui estão algumas opções de configuração principais a serem consideradas:
        
        - A REST API do Tableau Server e as configurações do Repositório do Tableau Server são usadas para se comunicar com o Tableau Server. A configuração do Repositório do Tableau Server é opcional, mas é um método de preferência para acessar o Tableau Server.
        - Você tem a opção de configurar a conexão criptografada segura quando o RMT se conectar ao Repositório do Tableau Server. Para usar as conexões SSL entre o banco de dados RMT e o Repositório do Tableau Server, o Tableau Server deve ser configurado para usar o SSL. Para obter mais informações, consulte [Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm).
        
        A tabela a seguir lista algumas das opções comuns. Para ver obter uma lista completa das opções, consulte o utilitário da linha de comando [Utilitário de linha de comando rmtadmin](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm).
        
        <table style="width: 100%;" class="simple-table"><colgroup><col style="width: 115px;"><col><col><col style="width: 234px;"></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th>Padrão</th><th>Descrição</th></tr></thead><tbody><tr><td>--name</td><td>Sim</td><td>n/a</td><td>O nome do ambiente.</td></tr><tr><td>--gateway-url</td><td><p>Sim</p><p>&nbsp;</p></td><td>n/a</td><td><p>URL usado para acessar o gateway do Tableau Server.</p></td></tr><tr><td>--version</td><td>Sim</td><td>n/a</td><td>Versão do Tableau Server que este ambiente monitorará.</td></tr><tr><td>--api-username</td><td>Não</td><td>Nulo</td><td>Nome de usuário da conta usada para se conectar às APIs do Tableau Server. A conta de usuário deve ser um administrador do Tableau Server com acesso a todos os sites do Tableau Server.</td></tr><tr><td>--api-password</td><td><p>Não</p><p>(Se você especificar o nome de usuário da API do Tableau, fornecerá a senha ou especificará o caminho do arquivo e o arquivo que contém a senha)</p></td><td><p>Nulo</p></td><td><p>Senha da conta de usuário da API do Tableau Server usada para se conectar às APIs do Tableau Server.</p></td></tr><tr><td>--api-password-file</td><td>Não</td><td>Nulo</td><td>O caminho para o arquivo e o nome do arquivo que contém a senha da conta de usuário da API do Tableau Server.</td></tr><tr><td>--repository-server</td><td>Sim</td><td><p>Nulo</p></td><td>É o nome do servidor para o banco de dados PostgreSQL que está instalado com Tableau Server</td></tr><tr><td>--repository-port</td><td>Sim</td><td>Nulo</td><td>O número da porta do aplicativo do banco de dados do Repositório do Tableau Server.</td></tr><tr><td>--repository-username</td><td>Sim</td><td>Nulo</td><td><p>Nome de usuário usado para se conectar ao banco de dados PostgreSQL instalado com o Repositório do Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password</td><td>Sim</td><td>Nulo</td><td><p>Senha para a conta de usuário usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password-file</td><td>Não</td><td>Nulo</td><td>O caminho incluindo o nome do arquivo onde a senha da conta do usuário é usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</td></tr><tr><td>--repository-ssl-mode</td><td><p>Não</p></td><td>Prefira</td><td><p>Modo SSL do repositório do Tableau Server:</p><p><b>Prefira</b> SSL ou <b>Exija</b> SSL para configurar conexões SSL para o repositório do Tableau.</p><p><b>Desative</b> para nunca usar SSL para fazer conexões de Repositório do Tableau Server.</p></td></tr><tr><td>--repository-ssl-thumbprint</td><td><p>Não</p></td><td>Nulo</td><td>Você pode optar por fornecer a impressão digital gerada pelo Tableau Server ou copiar o arquivo <b>server.crt</b> para a máquina da Resource Monitoring Tool Server (RMT Server). Se você optar por copiar o arquivo de certificado, não precisará fornecer a impressão digital. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm" class="xref">Configurar Postgres SSL para permitir conexões diretas de clientes</a>.</td></tr></tbody></table>
    2. Baixe o arquivo bootstrap e salve-o em um local que pode ser acessado no Tableau Server.
        
        `rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>`

### O Windows instala propriedades e switches

Switches:

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Switch</th><th>Descrição</th><th>Comentários</th></tr></thead><tbody><tr><td><code>/install | /uninstall</code></td><td>Execute a configuração para instalar ou desinstalar <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</td><td><p>O padrão é instalar, exibir a interface do usuário e todos os prompts. Se nenhum diretório for especificado usando a propriedade InstallFolder em uma nova instalação, C<i>:\Program Files\Tableau\Tableau\Tableau Resource Monitoring Tool\master</i> será adotado.  Se o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> já estiver instalado, a Instalação assumirá o mesmo local da instalação atual.</p><p>Para remover completamente o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> incluindo o diretório de dados, use <code>/uninstall DELTEDATADIR=1</code></p></td></tr><tr><td><code>/passive</code></td><td>Execute a Instalação com interface do usuário mínima e sem prompts.</td><td>&nbsp;</td></tr><tr><td><code>/quiet | /silent</code></td><td>Executar a instalação em modo totalmente silencioso e não supervisionado. Nenhuma interface da Web ou prompts são exibidos.</td><td>Use /quiet ou /silent, não ambos.</td></tr><tr><td><code>/norestart</code></td><td>Execute a Instalação sem reiniciar o Windows, mesmo que seja necessária uma reinicialização.</td><td>Em casos raros específicos, uma reinicialização não poderá ser cancelada, mesmo se essa opção for usada. Isso é mais provável quando uma reinicialização do sistema anterior foi ignorada. Por exemplo, se a reinicialização foi ignorada durante a instalação de outro software.</td></tr><tr><td><code>/log &lt;log-file&gt;</code></td><td>Registrar informações no arquivos e caminho especificados. Por padrão, os arquivos de registro são criados em  %TEMP%, com nome semelhante a Tableau_Resource_Monitoring_Tool_&lt;version_code&gt;.</td><td><p>Se nenhuma localização de arquivo for especificada, o arquivo de registro será gravado na pasta TEMP - <i>C:\Users\&lt;username&gt;\AppData\Local\Temp</i>. Verifique se há erros neste arquivo de registro, após a instalação.</p><p>Por exemplo: <code>&lt;Setup file&gt; /quiet /log="C:\Tableau\Logs\RmtInstall</code></p></td></tr></tbody></table>

Propriedades:

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Propriedade</th><th>Descrição</th><th>Comentários</th></tr></thead><tbody><tr><td><code>InstallFolder=&lt;path\to\installation\directory&gt;</code></td><td>Instalar no local de instalação não padrão especificado.</td><td><p>Especifica a localização para instalar o RMT. Se não for usado, o RMT é instalado <i>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master</i>.</p><p>Exemplo: <code>&lt;Setup file&gt; /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\master</code></p></td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>Aceita o Contrato de licença do usuário final (EULA). Exigido para instalação quieta, silenciosa e passiva nos nós inicial e adicional. 1 = true, aceita o EULA, 0 = false, não aceita o EULA.</td><td>Se não estiver incluído quando /passive, /silent ou /quiet forem utilizados, a configuração falhará de modo silencioso. Se incluído, mas definido como 0, a instalação falha.</td></tr></tbody></table>

**Para instalar o RMT Server:**

1. **Instale o RMT Server:**
    
    1. Baixe o instalador do RMT Server rpm ou .deb e salve-o em um local que você pode acessar na máquina onde você planeja instalar o RMT Server.
    2. Faça login na máquina onde você deseja que o RMT Server seja instalado como um usuário que tenha acesso do sudo.
    3. Execute o seguinte comando para instalar o RMT Server, onde <version> é formatado como manutenção major-minor-maintenance:
        
        Para distribuição semelhante a rhel, incluindo CentOS:
        
        sudo yum install <path/to/rmtserverinstaller>/Tabrmt-Master-x86\_64-<version>.rpm
        
        Para distribuições do Ubuntu:
        
        sudo apt install ./ <path/to/rmtserverinstaller>/Tabrmt-Master-amd64-<version>.deb
    
    Isso instala o pacote e os pré-requisitos, incluindo RabbitMQ, Erlang e um banco de dados PostgreSQL. O banco de dados PostgreSQL é usado para armazenar dados de uso coletados do Tableau Server. Em seguida, ele vai instalar o RMT Server.
2. **Inicializar RMT Server:**
    
    Você deve aceitar explicitamente o Contrato de licença de usuário final (EULA) ao inicializar o RMT Server. Você também tem a opção de especificar configurações não padrão. Para inicializar o RMT Server com uma configuração padrão, execute este comando:
    
    sudo /opt/tableau/tabrmt/master/install-scripts/initialize-rmt-master --accepteula
    
    O EULA ser encontrado na pasta `/opt/tableau/tabrmt/master/docs`.
    
    A partir da versão 2023.1, você pode especificar uma conta Run As personalizada a ser usada pelo RMT, bem como outras opções de configuração. Por padrão, o RMT cria e usa uma conta chamada `rmt-master` para execução subjacente. Para especificar uma conta Run As personalizada a ser usada pelo RMT Server, inclua a opção `--unprivileged-user` ao executar o script de inicialização. Para obter informações sobre todos os switches disponíveis para o script `initialize-rmt-master`, consulte [Opções de script de inicialização do RMT Server](https://help.tableau.com/current/server/pt-br/rmt-install-init-server-opts.htm#RMTServerInitOpts).
3. **Configuração do RMT Server:**
    1. Execute o seguinte comando como o usuário `tabrmt-master`:
        
        `sudo su --login tabrmt-master`
        
        `rmtadmin master-setup [options]`
        
        As opções de configuração podem ser fornecidas através do prompt de comando ou um arquivo de configuração. Se você não fornecer as opções, os valores padrão serão aplicados, exceto pela senha do administrador. O nome de usuário do administrador será definido como administrador e você será solicitado a fornecer a senha.
        
        Comando de exemplo, incluindo o parâmetro de senha necessário:
        
        `rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>`
        
        A tabela a seguir lista as opções necessárias e algumas opções comumente usadas para configurar o RMT Server. Para obter uma lista completa das opções de configurações, consulte o [Utilitário de linha de comando rmtadmin](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm).
        
        **Observação:** exigir opção HTTPS garante comunicações seguras entre o RMT Server e os usuários. Quando você precisa de HTTPS para comunicações, você também deve selecionar um modo para o certificado que deve ser usado para essas comunicações. A tabela abaixo inclui as várias opções. Para saber mais sobre essas modalidades e certificados, consulte [Instalar o Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-installation.htm#ssl-linux)
        
        <table style="width: 100%;" class="simple-table"><colgroup><col><col><col><col></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th><p>Padrão</p></th><th>Descrição</th></tr></thead><tbody><tr><td>admin-password</td><td><p>Sim</p><p>A senha pode ser fornecida na linha de comando ou fornecer um arquivo com a senha a ser usada. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>n/a</td><td>A senha do usuário administrador.</td></tr><tr><td>admin-password-file</td><td><p>Não</p><p>A senha pode ser fornecida na linha de comando ou fornecer um arquivo com a senha a ser usada. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>n/a</td><td><p>O arquivo onde a senha do usuário administrador é armazenada.</p><p class="note"><b>Observação:</b> <code>tabrmt-master</code>o usuário deve ter acesso a este arquivo. </p></td></tr><tr><td>admin-username</td><td>Não</td><td>admin</td><td>O nome de usuário administrador.</td></tr><tr><td>http-port</td><td>Não</td><td>80</td><td>&nbsp;</td></tr><tr><td>require-https</td><td>Não</td><td>True</td><td><p>Redirecione o tráfego http para HTTPS.</p></td></tr><tr><td>https-certificate-mode</td><td>Não</td><td><p>Opções disponíveis:</p><ul><li>Padrão</li><li>Local</li></ul></td><td><p>O tipo de pesquisa de certificado para realizar o certificado HTTPS.</p><p><b>Padrão:</b> este modo usa o certificado de autoassinatura padrão fornecido pelo instalador.</p><p><b>Local:</b> permite especificar um certificado baseado em arquivo na pasta <i>&lt;installation directory&gt;\config</i>. Como padrão, é <i>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config</i>.</p></td></tr><tr><td>https-certificate-local-nome</td><td><p>Não</p><p>Nota: se não especificado, o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> é instalado com um certificado autoassinado e usará esse certificado para comunicações HTTPS.</p></td><td>Nulo</td><td>O nome do arquivo de certificado HTTPS sem a extensão do arquivo.</td></tr><tr><td>https-certificate-local-senha</td><td>Não</td><td>Nulo</td><td>A senha a ser usada para o certificado HTTPS.</td></tr><tr><td>https-certificate-local-password-file</td><td>Não</td><td>Nulo</td><td>O caminho para o arquivo contendo a senha a ser usada para o certificado HTTPS.</td></tr></tbody></table>
4. **Crie um ambiente:**
    
    1. Execute o seguinte comando para criar um ambiente:
        
        `rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>`
        
        Configure o ambiente usando as opções disponíveis para este comando. Aqui estão algumas opções de configuração principais a serem consideradas:
        
        - A REST API do Tableau Server e as configurações do Repositório do Tableau Server são usadas para se comunicar com o Tableau Server. A configuração do Repositório do Tableau Server é opcional, mas é um método de preferência para acessar o Tableau Server.
        - Você tem a opção de configurar a conexão criptografada segura quando o RMT se conectar ao Repositório do Tableau Server. Para usar as conexões SSL entre o banco de dados RMT e o Repositório do Tableau Server, o Tableau Server deve ser configurado para usar o SSL. Para obter mais informações, consulte [Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm).
        
        A tabela a seguir lista algumas das opções comuns. Para ver obter uma lista completa das opções, consulte o utilitário da linha de comando [Utilitário de linha de comando rmtadmin](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm).
        
        <table style="width: 100%;" class="simple-table"><colgroup><col style="width: 115px;"><col><col><col style="width: 234px;"></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th>Padrão</th><th>Descrição</th></tr></thead><tbody><tr><td>--name</td><td>Sim</td><td>n/a</td><td>O nome do ambiente.</td></tr><tr><td>--gateway-url</td><td><p>Sim</p><p>&nbsp;</p></td><td>n/a</td><td><p>URL usado para acessar o gateway do Tableau Server.</p></td></tr><tr><td>--version</td><td>Sim</td><td>n/a</td><td>Versão do Tableau Server que este ambiente monitorará.</td></tr><tr><td>--api-username</td><td>Não</td><td>Nulo</td><td>Nome de usuário da conta usada para se conectar às APIs do Tableau Server. A conta de usuário deve ser um administrador do Tableau Server com acesso a todos os sites do Tableau Server.</td></tr><tr><td>--api-password</td><td><p>Não</p><p>(Se você especificar o nome de usuário da API do Tableau, fornecerá a senha ou especificará o caminho do arquivo e o arquivo que contém a senha)</p></td><td><p>Nulo</p></td><td><p>Senha da conta de usuário da API do Tableau Server usada para se conectar às APIs do Tableau Server.</p></td></tr><tr><td>--api-password-file</td><td>Não</td><td>Nulo</td><td>O caminho para o arquivo e o nome do arquivo que contém a senha da conta de usuário da API do Tableau Server.</td></tr><tr><td>--repository-server</td><td>Sim</td><td><p>Nulo</p></td><td>É o nome do servidor para o banco de dados PostgreSQL que está instalado com Tableau Server</td></tr><tr><td>--repository-port</td><td>Sim</td><td>Nulo</td><td>O número da porta do aplicativo do banco de dados do Repositório do Tableau Server.</td></tr><tr><td>--repository-username</td><td>Sim</td><td>Nulo</td><td><p>Nome de usuário usado para se conectar ao banco de dados PostgreSQL instalado com o Repositório do Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password</td><td>Sim</td><td>Nulo</td><td><p>Senha para a conta de usuário usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password-file</td><td>Não</td><td>Nulo</td><td>O caminho incluindo o nome do arquivo onde a senha da conta do usuário é usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</td></tr><tr><td>--repository-ssl-mode</td><td><p>Não</p></td><td>Prefira</td><td><p>Modo SSL do repositório do Tableau Server:</p><p><b>Prefira</b> SSL ou <b>Exija</b> SSL para configurar conexões SSL para o repositório do Tableau.</p><p><b>Desative</b> para nunca usar SSL para fazer conexões de Repositório do Tableau Server.</p></td></tr><tr><td>--repository-ssl-thumbprint</td><td><p>Não</p></td><td>Nulo</td><td>Você pode optar por fornecer a impressão digital gerada pelo Tableau Server ou copiar o arquivo <b>server.crt</b> para a máquina da Resource Monitoring Tool Server (RMT Server). Se você optar por copiar o arquivo de certificado, não precisará fornecer a impressão digital. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm" class="xref">Configurar Postgres SSL para permitir conexões diretas de clientes</a>.</td></tr></tbody></table>
    2. Baixe o arquivo bootstrap e salve-o em um local que pode ser acessado no Tableau Server.
        
        `rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>`
5. **Etapa opcional - somente se não usar SSD:** O Resource Monitoring Tool é otimizado para SSD por padrão. Se você não estiver usando hardware SSD, execute o comando:
    
    `sudo /opt/tableau/tabrmt/master/tabrmt-master optimize --no-ssd`

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

**Windows**

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.
- Resource Monitoring Tool Conta de administrador.

Linux

- Acesso do sudo completo para a conta de usuário que é usada para instalar o Agente.
- Portas de comunicação da Resource Monitoring Tool

## Próxima etapa

[Instalar o Agente usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install-cli.htm)

<!-- document id=c682e48a8550e7c01777d85d2695c3d5ea6f767eb21e608e56899e78547aba10 url=/tableau/current/pt-br/server/rmt-admin-master-install.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o RMT Server usando interface da Web

O Resource Monitoring Tool Server (RMT Server) hospeda o aplicativo Web com os quais os usuários interagem. Ele também faz grande parte do processamento em segundo plano para agrupar e monitorar os dados dos Agentes. O RMT Server deve ser instalado no hardware dedicado.

Atualmente, a instalação através da interface da Web é aceita apenas em instalações do Windows. Se você quiser instalar no Linux, consulte [Instalar o RMT Server usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install-cli.htm).

**Observação**: a partir da versão 2025.3.4, uma atualização para o instalador do Windows alterou um pouco o fluxo de trabalho de instalação.

**Para instalar o RMT Server:**

Existem três etapas principais para instalar o RMT Server:

- Instalação do software do servidor
- Configuração do RMT Server
- Criação de um novo ambiente.

O processo detalhado é descrito abaixo:

1. **Instalação do software do servidor:**
    1. Execute o programa de instalação do RMT Server.
    2. Após ler o EULA, selecione I agree to the license terms and conditions e clique em Install.
        
        **Observação:** se quiser instalar em um local não padrão, use as diretrizes fornecidas na seção [Instalação em um local não padrão](#Installi). O local padrão é **C:\\Program Files\\Tableau\\Tableau Resource Monitoring Tool\\**.
    3. Se a caixa de diálogo Controle da conta de usuário for aberta, clique em Yes para permitir que o instalador faça alterações.
    4. O instalador do RMT Server instalará alguns pré-requisitos como o primeiro passo. Os pré-requisitos incluem RabbitMQ, Erlang e um banco de dados PostgreSQL. O banco de dados PostgreSQL é usado para armazenar dados de uso coletados do Tableau Server. Em seguida, ele vai instalar o RMT Server.
    5. Ao final da instalação, uma página da Web **Server Configuration** será aberta.
2. **Configuração do RMT Server:**
    1. A página já deve estar preenchida. Faça atualizações nos valores, se necessário.
        
        **Observação:** anote o **nome do host**. A interface na Web usada para acessar o RMT Server usa este formato: _https://<hostname>_.
    2. Por padrão, o Resource Monitoring Toolusa um certificado autoassinado para realizar as comunicações HTTPS com o RMT Server. Para utilizar seu próprio certificado, substitua o valor da impressão digital pelo do certificado que deseja usar. Verifique a opção Require HTTPS se quiser exigir comunicações HTTPS seguras.
        
        Verificar a opção Require HTTPS também exigirá que você escolha um modo de certificado e forneça detalhes adicionais, se necessário. Principalmente, há três opções para escolher:
        
        1. **Padrão:** este modo usa o certificado de autoassinatura padrão fornecido pelo instalador.
        2. **Local:** este modo permite especificar um certificado baseado em arquivo na pasta Resource Monitoring Tool **/config.** Quando o modo **Local** é selecionado, o campo **Nome do certificado** fica disponível. As opções listadas corresponderão aos grupos de arquivos de certificado situados na pasta **/config.**
        3. **Armazenamento:** este modo permite que você digite a impressão digital de um certificado na loja de certificados do Windows.
            
            O campo **Senha** será usado somente se o certificado selecionado precisar de uma senha.
    3. Teste a Configuração do servidor ao clicar em **Test Server Configuration**.
        
        **Observação:** se você vir o seguinte erro, use as instruções fornecidas no tópico [Solucionar erros do certificado SSL](https://help.tableau.com/current/server/pt-br/rmt-troubleshoot-ssl-certificate.htm):  
        _O certificado não inclui a chave privada acessível_
    4. A seção **Senha** permite configurar os requisitos de senha que se aplicarão às contas de usuário e à conta de usuário Administrativo que você criará posteriormente.
    5. Na seção **Autenticação**, você pode configurar o período limite para as sessões. Se o usuário não acessar a sessão pelo período limite definido, a sessão expirará e será necessário fazer login novamente. Por padrão, ele é definido como 240 minutos. Você também pode ativar a opção **Expiração deslizante** para redefinir o período limite quando uma sessão é acessada nele.
    6. Clique em Save and Restart Server.
        
        **Observação:** se você vir o seguinte erro, use as instruções fornecidas no tópico [Solucionar erros do certificado SSL](https://help.tableau.com/current/server/pt-br/rmt-troubleshoot-ssl-certificate.htm):  
        _O certificado não inclui a chave privada acessível_
    7. Ao reiniciar o servidor, você será solicitado a criar um usuário administrativo e senha.
    8. Depois de fazer logon usando as credenciais administrativas criadas na etapa anterior, o Resource Monitoring Tool exibirá uma mensagem de que nenhum Ambiente foi criado. Clique em **Add an environment** para configurar um novo ambiente.
3. **Criar um novo ambiente:**
    1. Preencha os detalhes do ambiente, como o nome de um identificador. A API REST do Tableau Server e as configurações do Repositório do Tableau Server são usadas para se comunicar com o Tableau Server. A configuração do Repositório do Tableau Server é opcional, mas é um método de preferência para acessar o Tableau Server.
        
        Você tem a opção de configurar a conexão criptografada segura quando o RMT se conectar ao Repositório do Tableau Server. Para usar as conexões SSL entre o banco de dados RMT e o Repositório do Tableau Server, o Tableau Server deve ser configurado para usar o SSL. Para obter mais informações, consulte [Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm).
    2. Configuração do repositório do Tableau:
        
        Na seção Tableau Repository Configuration:
        
        1. Na caixa suspensa SSL Mode, selecione Prefer SSL ou Require SSL para configurar as conexões SSL no Repositório do Tableau. Escolher Disable significa que o SSL nunca será usado para fazer conexões do repositório do Tableau Server.
            
            No modo Prefer SSL, o Resource Monitoring Toolusará SSL na primeira tentativa, e se isso falhar, posteriormente tentará uma conexão não criptografada.
            
            No modo Require SSL, se a conexão SSL falhar, as conexões com o repositório do Tableau Server falharão completamente. Neste caso, as conexões de API REST do Tableau Server serão usadas para se comunicar com o Tableau Server.
        2. Você pode optar por fornecer a impressão digital gerada pelo Tableau Server ou copiar o arquivo **server.crt** para a máquina do Servidor Resource Monitoring Tool primário. Se você optar por copiar o arquivo de certificado, não precisará fornecer a impressão digital. Para obter mais informações, consulte [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm).
4. Clique em **Save**. Você verá uma nova seção adicionada à página - **Agent Configuration**. Esta seção permite baixar o arquivo bootstrap necessário para instalar e configurar Agentes.
    
    > [!IMPORTANT]
    > 
    > **Observação:** se você fizer atualizações nas configurações do Ambiente, clique em **Salvar** antes de baixar o arquivo Bootstrap.
    
    ![Um formulário com campos para inserir as configurações de servidor e de agente do Tableau.](/tableau/current/pt-br/server/pt-br/Img/rmt-new-envrionment-agent-bootstrap.png)

## Instalação em um local não padrão

### RMT Server

O Tableau recomenda usar _\\Tableau\\Tableau Resource Monitoring Tool_ como o local de instalação do RMT Server. Exemplo de local não padrão: **D:\\Tableau\\Tableau Resource Monitoring Tool**.

**Para escolher um local não padrão durante a instalação da versão 2025.3.4 ou posterior, siga estas etapas:**

1. Execute o instalador do RMT Server.
2. Na página de boas-vindas, escolha **Opções**.
3. Em **Opções de configuração**, no campo **Local de instalação**, insira o local.
4. Continue com a Etapa 2 da instalação, como descrito em [Instalar o RMT Server usando interface da Web](#InstallMaster).

**Para escolher um local não padrão durante a instalação das versões anteriores à 2025.3.4, siga estas etapas:**

1. Execute o instalador do RMT Server.
2. Na página do EULA, escolha **Personalizar**.
3. Em **Opções de configuração**, no campo **Local de instalação**, insira o local.
4. Continue com a Etapa 2 da instalação, como descrito em [Instalar o RMT Server usando interface da Web](#InstallMaster).

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.
- Resource Monitoring Tool Conta de administrador.

## Próxima etapa

[Instalar o Agente usando interface da Web](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install.htm)

<!-- document id=578986a4ff7fa9ec975850f16f4645603a50ef285129a1d929fbebb0166b3824 url=/tableau/current/pt-br/server/ts_gcp_welcome.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server no Google Cloud Platform

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao instalar o Tableau Server em uma máquina virtual (VM) do Google Compute Engine você ainda terá as capacidades avançadas do Tableau Server em um ambiente local. Executar o Tableau Server em uma VM do GCE é uma excelente escolha se desejar ter a flexibilidade de escalar horizontal ou verticalmente sem precisar comprar e manter uma frota de servidores cara. Por exemplo, é possível configurar o Tableau Server para ficar altamente disponível e integrá-lo a todos os aplicativos empresariais comuns (por exemplo, o Active Directory) dos quais muitas organizações dependem.

Procurando o Tableau Server no Linux? Consulte [Instalar o Tableau Server na Google Cloud Platform.](https://help.tableau.com/current/server-linux/pt-br/ts_gcp_welcome.htm "Abre o tópico em uma nova guia do navegador").

O Tableau Server pode aproveitar muitos serviços nativos da Google Cloud :

- [Disco persistente do Google](https://cloud.google.com/persistent-disk/): armazenamento de bloquei com base na nuvem para máquinas virtuais (VMs).
- [Armazenamento da Google Cloud](https://cloud.google.com/storage/): armazenamento de objeto unificado com base na nuvem para arquivamento de dados.
- [Fluxo de dados da Google Cloud](https://cloud.google.com/dataflow/): serviço com base na nuvem para stream e processamento de dados em lote.
- [Google Cloud Dataproc](https://cloud.google.com/dataproc/): serviço com base na nuvem para execução de clusters Spark e Hadoop.

Além disso, você pode armazenar os dados usados no Tableau Server por meio de qualquer um dos seguintes serviços da Google Cloud. O Tableau fornece [conectores](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#exampleconnections_overview.htm) de dados nativos que permitem a conexão com dados nas seguintes fontes de dados do Google:

- [Google Analytics](https://help.tableau.com/current/pro/desktop/pt-br/examples_googleanalytics.htm): análise na Web para monitoramento e relatórios do tráfego de sites.
- [Google BigQuery](https://help.tableau.com/current/pro/desktop/pt-br/examples_googlebigquery.htm): data warehouse empresarial gerenciado para análise.
- [Google Cloud SQL](https://help.tableau.com/current/pro/desktop/pt-br/examples_googlecloudsql.htm): serviço de banco de dados SQL gerenciado.
- [Google Sheets](https://help.tableau.com/current/pro/desktop/pt-br/examples_googlesheets.htm): planilhas incluídas no Google Docs.

## Outros artigos nesta seção

<!-- document id=2f86d9277c791af93088334d00e2c5d02bafbe405593778b4823a6c654ffa0a6 url=/tableau/current/pt-br/server/server_tsig_new_install.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server com Independent Gateway

Este tópico orienta você no processo de instalação do Tableau Server Independent Gateway.

Seguir esse processo resultará em uma configuração de Independent Gateway com uma conexão direta com a implantação de back-end do Tableau Server. Você pode saber mais sobre os modos de conexão _direta_ versus _de relé_ no tópico [Configurar o Tableau Server com Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_configure.htm).

## Pré-requisitos

- Você deve ter um servidor dedicado com pelo menos 2 núcleos (4 vCPUs), 8 GB de RAM e 100 GB de espaço livre em disco.
- Você deve usar o Tableau Server 2022.1 ou versões posteriores.
- Você deve usar um instalador para o Gateway Independente do Tableau Server com uma versão com uma versão principal (**2022.1**, por exemplo) que corresponda à versão do Tableau Server. Recomendamos à correspondência com as versões de manutenção (2022.1**.1** ou 2022.1**.5** por exemplo), mas não é um requisito. Se a alteração de "ativos estáticos" entre as versões e as versões não corresponderem, você poderá ver algum impacto inesperado na imagem. Por exemplo, os mapas podem não estar atualizados se o Independent Gateway for uma versão anterior ao Tableau Server.
- Você deve ter Advanced Management habilitado em Tableau Server. Para saber mais sobre o Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).
- Por padrão, o Independent Gateway deve poder se comunicar com a implantação do Tableau Server de back-end nas portas 80 e 21319 durante a instalação. Você pode alterar essas portas padrão durante a inicialização conforme descrito posteriormente neste tópico.
- Verifique se a implantação do Tableau Server está completa e íntegra antes de instalar e configurar o Independent Gateway.
- Verificar não está executando nenhum outro aplicativo com reconhecimento da Web no computador em que está instalando o Independent Gateway. Por exemplo, se o httpd do Apache estiver instalado no computador, desinstale-o ou configure `httpd` para que ele não esteja escutando ativamente na porta 80.

## Instalar o Tableau Server e o Independent Gateway

A instalação do Independent Gateway é feita usando um programa de de instalação autônomo que inclui "tsig" como parte do nome do arquivo para distingui-lo do instalador completo do Tableau Server. É altamente recomendável que você instale o Independent Gateway após instalar o Tableau Server e confirmar que está funcionando conforme o esperado. Para instalar, você deve ter direitos . Você pode instalar uma ou mais instâncias do Independent Gateway, mas cada uma deve ser instalada separadamente. Se você estiver instalando várias instâncias para alta disponibilidade ou para distribuir uma carga pesada de cliente, repita as etapas de instalação para cada instância.

Durante a instalação, um script chamado `initialize-tsig.bat` é executado. O script solicita as informações necessárias para configurar o Independent Gateway. Depois que o Independent Gateway estiver totalmente instalado, você precisará executar um comando do TSM no nó inicial do Tableau Server para configurar o servidor com detalhes sobre a instância do Independent Gateway.

A instalação do IG consiste nestas etapas:

- Execute o instalador específico da plataforma.
- Execute o script de pós-instalação. Isso é feito automaticamente pelo programa Setup.
- Habilite a instância do Independent Gateway usando o TSM.

### Etapa 1: baixar e instalar o Tableau Server

1. [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm): siga as instruções fornecidas neste tópico e conclua as etapas de 1 a 5, que executam o programa de instalação e instalam o TSM.
2. [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm): forneça a chave do Tableau Server e a chave do Advanced Management na etapa de ativação. Você precisará executar o seguinte comando duas vezes, primeiro com a chave do produto Tableau Server e, em seguida, a chave do produto do Advanced Management:
    
    `tsm licenses activate -k <product key>`
3. [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm): siga as instruções fornecidas no tópico para configurar as configurações iniciais do nó.

### Etapa 2: baixar e instalar o Independent Gateway

Após baixar o arquivo de instalação do Tableau Server Independent Gateway, siga as instruções abaixo para instalar o Independent Gateway.

1. No computador em que você está instalando o Independent Gateway, entre como usuário com acesso de administrador e clique duas vezes no arquivo de instalação baixado.
2. Na primeira tela você deve aceitar o contrato de licenciamento antes de continuar.
3. Depois de aceitar o contrato de licenciamento, você pode realizar uma das duas ações:
    
    - Instale o Independent Gateway clicando em Instalar  
        ou
    - Altere o local de instalação clicando em Personalizar e instale o Independent Gateway:
        
        Por padrão, o Independent Gateway é instalado em `C:\Program Files\Tableau\Tableau Server\independentgateway`. Escolha um local diferente, incluindo uma unidade não padrão, por meio de navegação ou digitação de um novo caminho.
        
        Depois de especificar o local de instalação, clique em Instalar para instalar o Independent Gateway neste local.
4. O programa de instalação instala o Independent Gateway e executa automaticamente o script `initialize-tsig.bat`.
    
    Em uma janela de comando aberta pelo instalador, são solicitados valores que são usados para configurar o Independent Gateway:
    
    - `TSIG_TS_CLUSTER`— Obrigatório. Não há valor padrão. Você deve inserir um valor quando solicitado.
        
        Este deve ser o endereço de internet ou endereços de cada nó no cluster do Tableau Server. Curingas podem ser usados e máscaras de sub-rede podem ser usadas para especificar vários nós. Para especificar vários endereços, separe os endereços por espaços. Os valores devem ser fornecidos em uma das formas aceitáveis pela diretiva Apache httpd mod\_authz\_host "Obrigatória". Para obter mais informações, consulte [https://httpd.apache.org/docs/2.4/mod/mod\_authz\_host.html](https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html).
    - `TSIG_HK_PORT`— O padrão é `21319`. Essa é a porta usada para solicitações de manutenção de entrada do Tableau Server.
    - `TSIG_HK_PROTOCOL`— O padrão é `http`. Os valores válidos são `http` e `https`. Este é o protocolo usado para solicitações de manutenção do Tableau Server.
    - `TSIG_PORT`— O padrão é `80`. A porta usada para solicitações externas.
    - `TSIG_PROTOCOL`— O padrão é `http`. Os valores válidos são `http` e `https`. Este é o protocolo usado para solicitações externas.
    - `TSIG_INSTANCE_ID`— O padrão é o nome da máquina. Um identificador exclusivo para a instância do Independent Gateway.
5. A instalação termina quando o script é executado e o Independent Gateway é inicializado.

### Etapa 3: habilitar o Independent Gateway no Tableau Server

A última etapa da instalação e configuração do Independent Gateway é habilitar o Independent Gateway no Tableau Server. Para fazer isso, use o comando TSM `tsm topology external-services gateway enable -c <file>` com um arquivo JSON que identifica a instância ou instâncias do Independent Gateway e fornece ao Tableau Server os detalhes necessários para a comunicação entre o servidor e o Independent Gateway.

O Tableau Server deve estar em um estado interrompido para habilitar o Independent Gateway.

#### O conteúdo do arquivo JSON do Independent Gateway

O arquivo JSON que você usa para habilitar as instâncias do Independent Gateway no Tableau Server precisa conter o seguinte:

- **id** — O valor do id deve corresponder ao TSIG\_INSTANCE\_ID para a instância específica. Se você não forneceu isso durante a inicialização, o padrão é o nome da máquina (%COMPUTERNAME%) do computador do Independent Gateway. O valor no arquivo json deve corresponder à saída do comando `hostname`.
- **host** — O host deve ser a um nome que possa ser resolvido por DNS do computador de gateway independente.
- **port** — A porta deve corresponder ao valor TSIG\_HK\_PORT especificado na instância do Independent Gateway. Se você não forneceu isso durante a inicialização, o padrão é "21319".
- **protocol** — O protocolo deve corresponder ao TSIG\_HK\_PROTOCOL especificado na instância do Independent Gateway. Se você não forneceu isso durante a inicialização, o padrão é "http".
- **authsecret** — O segredo de autenticação deve corresponder ao segredo criado pelo script de inicialização na instância do Independent Gateway.

#### O segredo de autenticação do Independent Gateway

O script de inicialização cria um segredo exclusivo e compartilhado em cada computador do Independent Gateway. Você precisa desse segredo para habilitar o Independent Gateway no Tableau Server. Copie o segredo e inclua-o em seu arquivo JSON como "authsecret".

O segredo compartilhado está localizado no arquivo `tsighk-auth.conf` aqui:

C:\\ProgramData\\Tableau\\Tableau Server\\independentgateway\\config\\tsighk-auth.conf

#### Exemplo de arquivo JSON de Independent Gateway

O arquivo JSON deve estar no formato abaixo. Este arquivo JSON de exemplo mostra valores padrão onde há padrões. Seu arquivo deve usar os valores reais que correspondem à sua instalação do Independent Gateway e à sua organização.

{  
 "independentGateways": \[
  {
    "id": "<IGCOMPUTER>",
    "host": "<DNS name of Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret01>"
  },
  {
    "id": "<IGCOMPUTER2>",
    "host": "<DNS name of second Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret02>"
  }
 \]
}

### Habilitando o Independent Gateway no Tableau Server

Para concluir a instalação do Independent Gateway, você precisa habilitá-lo usando o TSM.

1. Copie o arquivo de configuração JSON para o nó inicial do Tableau Server.
2. No nó inicial, abra um prompt de comando como um administrador.
3. Execute os seguintes comandos para interromper o Tableau Server, habilite o Independent Gateway usando o arquivo de configuração json e reinicie o servidor:
    
    tsm stop
    tsm topology external-services gateway enable -c tsig.json
    tsm start

### Etapa 4: verificar o Independent Gateway no Tableau Server

Você deve conseguir navegar até a página de entrada do Tableau Server inserindo o endereço do Independent Gateway em um navegador.

Se houver um firewall entre o Independent Gateway e a implantação do Tableau Server de back-end, você precisará abrir as portas dos processos do Tableau Server para conexão direta. Consulte [Conexão direta](https://help.tableau.com/current/server/pt-br/server_tsig_configure.htm#Direct) para obter mais informações.

Como alternativa, você pode optar por minimizar os requisitos de porta configurando o Independent Gateway para uma conexão de relé. Consulte [Conexão de relé](https://help.tableau.com/current/server/pt-br/server_tsig_configure.htm#Relay) para obter mais informações.

<!-- document id=acf8fb1f55d0e4df962f5277913bfae1af74e4bcfb21090aae87f515e9f08710 url=/tableau/current/pt-br/server/server_external_filestore_storage_new_install.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server com o armazenamento de arquivos externo

Este tópico o orienta pelo processo de configuração de compartilhamento de rede como o Armazenamento de arquivos de uma nova instalação do Tableau Server. Se estiver tentando fazer isso em uma instalação existente do Tableau Server que tem o Armazenamento de arquivos funcionando localmente, consulte [Reconfigurar Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_reconfigure.htm).

## Pré-requisitos

- Você deve usar o Tableau Server 2020.1 ou versões posteriores.
- Você deve ter solução de compartilhamento de rede para uso como sua opção de armazenamento. Para recomendações sobre a solução de armazenamento, consulte [Considerações de desempenho para armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_performance.htm).
    
    Usar **compartilhamentos SMB** para instalações do Windows.
    
    Estimativa do tamanho do armazenamento: você deve levar em consideração a quantidade de armazenamento necessária para publicar e atualizar as extrações. Além disso, você também deve levar em consideração o tamanho do backup do repositório, a menos que escolha especificamente a opção de fazer o backup do repositório separadamente, conforme descrito no tópico [Opção 2: repositório de backup separadamente](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm#backup-repository-separately)
    
    - Extrações:
        - Considere o número de extrações que será publicado no Tableau Server e o tamanho de cada extração. Teste as suas necessidades ao publicar várias extrações no Tableau Server e, em seguida, verifique o espaço em disco usado. Você pode usar essa quantidade de espaço em disco para ajudar a descobrir quantas extrações serão publicadas no Tableau Server no decorrer do tempo, além de como cada extração existente terá o tamanho aumentado.
        - Considere o espaço necessário pelo diretório temp durante uma atualização de extração. O diretório temp, que armazena uma extração durante a atualização, pode necessitar de um tamanho três vezes maior que o do arquivo final.
    - Backup do repositório:
        - Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório `<data directory>/pgsql/data/base`.
        - Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo `workgroup.pg_dump`.
- Você deve ter os recursos de Advanced Management ativados no servidor. Para saber mais sobre o Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

## Instalar o Tableau Server com o armazenamento de arquivos externo

Você pode instalar o Tableau Server com o Armazenamento de arquivos usando um compartilhamento de rede para armazenar dados do Tableau Server. Essa solução substitui a necessidade de executar o processo do Armazenamento de arquivos localmente. Para saber mais sobre essa solução e seus benefícios, consulte [Armazenamento de arquivos externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm).

Use as etapas a seguir para instalar o Tableau Server com o Armazenamento de arquivos externo durante a instalação:

### Etapa 1: configurar um compartilhamento de rede

No seu servidor de arquivos:

1. Crie e compartilhe um diretório para usar como o Armazenamento de arquivos externo do Tableau Server.
2. Certifique-se de que o compartilhamento de rede seja acessível como um diretório no mesmo local em todos os nós do Tableau Server.
3. Crie o diretório do Tableau no compartilhamento de rede e dê acesso total ao **Serviço de rede** e à conta de usuário de domínio que você planeja usar para o usuário **Run As**.
    
    Recomendamos chamar o diretor de '**tableau**'.
    
    `\\hostname\<network share>\tableau\`
    
    **Observação:**  
    \- A conta do Serviço de rede pode ser usada para acessar recursos em computadores remotos no mesmo domínio do Active Directory, mas recomendamos configurar uma conta de domínio o serviço **Run As** para usar nesse cenário. Para obter mais informações, consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm).  
    \- Serviços que funcionam como a conta do Serviço de rede acessam os recursos de rede usando as credenciais da conta do computador no formato _<domain\_name>\\<computer\_name>$_.  
    Se você estiver usando o Active Directory para gerenciar permissões e acesso dos usuários, aqui está uma maneira recomendada de gerenciar as permissões para o compartilhamento da rede:  
    \- Crie um grupo de segurança do Active Directory.  
    \- Adicione as contas do computador do cluster Tableau juntamente com o **usuário Run-As** a esse grupo.  
    \- Conceda acesso ao grupo de segurança no compartilhamento de rede. Desta forma, se você precisar adicionar ou remover um computador do cluster, basta fazer a alteração para o grupo de segurança.
4. **Valide se o compartilhamento de rede está configurado corretamente**: no Tableau Server, execute um comando para gravar em um compartilhamento de rede e confirme que você é capaz de gravar nele.

### Etapa 2: baixar e instalar o TSM

1. Baixe o do instalador do Tableau Server.
2. Abra um prompt de comando como um usuário com acesso de administrador no computador em que deseja instalar o Tableau Server.
3. Execute o programa de instalação a partir da linha de comando usando as opções /SILENT e /ACCEPTEULA:
    
    `tableau-setup-tsm-<branch>.<build>-x64.exe/SILENT/ACCEPTEULA`
    
    **Observação:** há várias opções de instalação diferentes que você pode especificar durante a instalação da CLI, por exemplo, para alterar os caminhos de instalação e logs ou especificar a porta do controlador do TSM. Para obter uma lista completa dos switches que você pode especificar durante a instalação da CLI, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm).

### Etapa 3: ativar e registrar o Tableau Server

Forneça a chave do Tableau Server e do Advanced Management na etapa de ativação. Você precisará executar o seguinte comando duas vezes, primeiro com a chave do produto Tableau Server e, em seguida, a chave do produto do Advanced Management:

`tsm licenses activate -k <product key>`

### Etapa 4. Permitir armazenamento de arquivo externo

A configuração do Tableau Server com repositório externo só pode ser feita usando a CLI do TSM.

1. Habilite o recurso de armazenamento de rede usando os seguintes comandos tsm:
    
    `tsm topology external-services storage enable --network-share \\hostname\<network share>\tableau\`
    
    O programa de configuração cria automaticamente a seguinte estrutura de diretório no compartilhamento:
    
    **Backups de dados PostgreSQL:**
    
    _tableau\_data\\tabsvc\\repository\_backup_
    
    **Observação:** esse diretório será criado na primeira vez que você criar um backup.
    
    **Extrações e revisões de livros:**
    
    _tableau\_data tabsvc\\dataengine\\extracts_
    
    tableau\_data\\tabsvc\\dataengine\\revisions

### Etapa 5: definir as configurações iniciais do nó

Siga as instruções fornecidas no tópico [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

### Etapa 6: concluir a instalação

Crie a conta administrativa inicial do Tableau Server.

- Se tiver configurado um armazenamento de identidades local, especifique um nome e senha que deseja usar.
- Caso tenha configurado um repositório de identidades do LDAP ou do Active Directory durante a instalação, será preciso especificar uma conta de usuário membro do diretório.

Para criar o usuário inicial, execute o comando tabcmd a seguir:

`tabcmd initialuser --server localhost:80 --username '<new-admin-username>'`

Depois de executar o comando, o shell solicitará uma senha administrativa.

### Etapa 7: tarefas de pós-instalação

Após criar a conta de administrador do Tableau Server, continue a instalação trabalhando por meio das etapas de configuração descritas nos tópicos [Tarefas pós-instalação](https://help.tableau.com/current/server/pt-br/config_post_install.htm).

## Quem pode fazer isso

Os administradores do Tableau Server podem instalar e configurar o Tableau Server e o Armazenamento de arquivos externo. Além disso, você deve ter permissões e acesso para configurar o compartilhamento de rede e usar com o Tableau Server.

## Próximo

[Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm)

<!-- document id=c9ef471ac876abc845acd15aaf0a3c28cbcf00dd6fdc1189464ba4b82a3886e5 url=/tableau/current/pt-br/server/server_external_repo_new_install.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server com o repositório PostgreSQL externo

Este tópico descreve como instalar e configurar o Tableau Server para usar um serviço externo para o repositório do Tableau Server.

## Antes da instalação

- Você deve ter Advanced Management ativados no seu Tableau Server. Para obter mais informações sobre o Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).
- Seu ambiente do Tableau Server deve ser um dos seguintes:
    
    - Serviços de nuvem pública:
        - Serviço de nuvem da AWS. Para obter mais informações sobre instalação do Tableau Server na AWS, consulte [Instalar o Tableau Server na Amazon Web Services](https://help.tableau.com/current/server/pt-br/ts_aws_welcome.htm).
        - Serviços de nuvem do Azure. Para obter mais informações sobre instalação do Tableau Server no Azure, consulte [Instalar o Tableau Server no Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_welcome.htm).
        - Serviços de nuvem do Google. Para obter mais informações sobre instalação do Tableau Server do Google Cloud, consulte [Instalar o Tableau Server para integridade no Google Cloud Platform](https://help.tableau.com/current/server/pt-br/ts_gcp_welcome.htm).
    - Local: é o Tableau Server em execução no hardware localizado em sua organização ou empresa e não em uma nuvem pública.
- Você deve ter uma instância de banco de dados PostgreSQL instalada e pronta. Você também precisará do endpoint da instância de banco de dados PostgreSQL.
    
    - Tableau Server na **AWS**
        - Para uma opção de servidor totalmente gerenciada, usando Amazon RDS, siga as orientações detalhadas em [Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_RDS.htm).
        - Para uma opção de servidor autogerenciado: use AWS EC2 e [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm)
    - Tableau Server no **Azure**:
        - Para obter uma opção de servidor totalmente gerenciado usando o banco de dados do Azure, consulte [Criar uma instância PostgreSQL do banco de dados do Azure no Azure](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_Azure.htm).
        - Para uma opção de servidor autogerenciado, use a VM do Azure e [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm).
    - Tableau Server no **Google Cloud**:
        - Para obter uma opção de servidor totalmente gerenciado usando a instância PostgreSQL do Google Cloud, siga as orientações em [Criar uma instância PostgreSQL no Google Cloud](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_gcp.htm)
        - Para uma opção de servidor autogerenciado, use a VM do Google Cloud e [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm).[Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm)
    - Se você estiver instalando no local, consulte [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm)
- Baixar o certificado SSL:
    
    Conexões seguras entre o Tableau Server e o Repositório Externo **não** são necessárias, mas recomendadas.
    
    Se você deseja configurar conexões SSL para comunicações entre o Tableau Server e o Repositório Externo, faça o seguinte:
    
    - Amazon RDS: consulte [Uso de SSL para criptografar a conexão a uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL).
    - Banco de dados do Azure para PostgreSQL: consulte [Configurar a conectividade TLS no banco de dados do Azure para PostgreSQL](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-ssl-connection-security).
    - Banco do Google Cloud: consulte [Como configurar certificados SSL/TLS.](https://cloud.google.com/sql/docs/postgres/configure-ssl-instance#enforcing-ssl)
    - Banco de dados PostgreSQL autônomo: o certificado CA que você usou para configurar SSL para o banco de dados deve ser copiado para o nó inicial do Tableau Server. Para obter mais informações sobre como configurar SSL para o banco de dados PostgreSQL, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm#configure-ssl).

## Instalação e configuração do Tableau Server

### Etapa 1: crie um arquivo de configuração

Crie um arquivo json com as seguintes definições de configuração:

{
 "flavor":"<flavor name>",
 "masterUsername":"<admin user name>",
 "masterPassword":"<password>", 
 "host":"<instance host name>",
 "port":5432
}

- **flavor:** é o tipo de serviço externo que você usará para o repositório do Tableau Server.
    
    - Amazon RDS: use "rds"
    - Banco de dados do Azure: use "azure"
    - Banco de dados do Google Cloud: use "gcp"
    - Banco de dados PostgreSQL autônomo: use "generic"
- **masterUsername:**
    
    - Amazon RDS: use "trilhas" para o nome de usuário. Este é o usuário que você especificou ao criar a instância de RDS.
        
        > [!IMPORTANT]
        > 
        > Você deve usar "rails" como o masterUsername. Isso é necessário para que o repositório externo funcione corretamente com o Tableau Server.
    - Banco de dados do Azure ou instância do Google Cloud PostgreSQL: escolha um nome de usuário que atenda aos seus requisitos. Recomendamos usar **postgres** como nome de usuário do Administrador. Se você optar por usar um nome de usuário diferente, certifique-se de que ele não comece com **pg**, ou **azure**. O nome de usuário também não pode ser **rails**, **tblwgadmin,** **tableau**, **readonly** ou **tbladminviews**.
- **masterPassword:** esta é a mesma senha que você especificou ao criar a instância do banco de dados PostgreSQL.
- **host:** este é o endpoint da instância de banco de dados PostgreSQL.
- **port:** a porta do banco de dados que você especificou ao criar a instância de banco de dados PostgreSQL.

### Etapa 2: instale o Tableau Server e configurar o repositório externo

**Uso da CLI do TSM:**

1. [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm): siga as instruções de “Usar a CLI do TSM” fornecidas neste tópico e conclua as etapas de 1 a 5, que executam o programa de instalação e instalam o TSM.
2. [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm): forneça a chave do Tableau Server e a chave do Advanced Management na etapa de ativação. Você precisará executar o seguinte comando duas vezes, primeiro com a chave do produto Tableau Server e, em seguida, a chave do produto do Advanced Management:
    
    `tsm licenses activate -k <product key>`
3. [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm): siga as instruções de “Usar a CLI do TSM” fornecidas no tópico para configurar as configurações iniciais do nó.
    
    > [!IMPORTANT]
    > 
    > Importante! Não execute a etapa **Inicialização do Tableau Server** ao configurar o nó inicial. Após concluir as outras etapas no tópico [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm), retorne a esta página e siga o restante das instruções.
4. Configure o Tableau Server para usar o repositório externo usando os seguintes comandos:

- Especifique as configurações de repositório externo usando o arquivo json criado na etapa anterior:
    
    `tsm topology external-services repository enable -f <filename>.json -c <ssl certificate file>`
    
    O arquivo json é o arquivo que você criou na primeira etapa com as definições de configuração.
    
    **Observação:** o certificado SSL é necessário apenas se você estiver usando conexões criptografadas entre o Tableau Server e o repositório externo. Se isso não for obrigatório para você, especifique a opção --no-ssl. Nesse caso, o comando tsm ficaria assim:  
    `tsm topology external-services repository enable -f <filename>.json --no-ssl`
- Aplique as alterações:
    
    `tsm pending-changes apply`

### Etapa 3: conclua o tsm initialize

Para inicializar o Tableau Server

`tsm initialize --start-server --request-timeout 1800`

### Etapa 4: conclua a instalação

[Adicionar uma conta de administrador](https://help.tableau.com/current/server/pt-br/startup.htm) e conclua a instalação.

## Quem pode fazer isso

Os administradores do Tableau Server podem instalar e configurar o Tableau Server.

<!-- document id=04580ae35fa2b0a95ec84c6ff24807951cc178e32a4915ea6449c4e8a4b45982 url=/tableau/current/pt-br/server/install_air_gapped.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server em um ambiente desconectado (fisicamente isolado)

Você pode instalar o Tableau Server em um ambiente desconectado sem acesso a qualquer tipo de rede externa. Esses ambientes desconectados, comumente chamados de fisicamente isolados, são usados quando o máximo de segurança é necessária para evitar violações de dados ou proteger contra invasões. Ambientes fisicamente isolados não têm acesso à Internet, acesso à rede externa, acesso à rede sem fio externa etc. O único meio de fazer com que o software e os dados entrem e saiam de um ambiente fisicamente isolado é usar mídias removíveis, como pendrives ou CDs ou DVDs ópticos de gravação.

Instalar o Tableau Server em um ambiente fisicamente isolado é uma tarefa avançada para administradores de TI familiarizados com as considerações de segurança, práticas recomendadas e problemas de instalação de software nesse tipo de ambiente.

Os seguintes recursos do Tableau Server estarão indisponíveis ou terão a funcionalidade reduzida em um ambiente fisicamente isolado:

- **Mapas** – O Tableau Server usa dados de mapa hospedados externamente, por padrão. Começando pela versão 2020.4.0, você pode configurar o Tableau Server para usar mapas offline. Com as versões mais antigas do Tableau, os mapas não estão disponíveis em um ambiente fisicamente isolado, a menos que você instale um servidor do mapa nele. Para obter mais detalhes, consulte [Exibição de mapas em um ambiente fisicamente isolado](#Maps).
- **Licenciamento** – O Tableau Server precisa se conectar à Internet para ativar as chave do produto. Entretanto, você pode [ativar manualmente](#Activati) as chave do produto.
- **Dados externos** – Qualquer dado localizado fora do seu ambiente fisicamente isolado não está disponível.

## Pré-requisitos

Para instalar o Tableau Server em um ambiente fisicamente isolado, você precisará do seguinte:

- Um computador confiável com acesso limitado à Internet para baixar os pacotes de instalação e recursos exigidos pelo Tableau Server. Para ser considerado confiável, o computador precisa ser analisado e ter todos os vírus e malwares removidos.
- Mídia removível confiável para transferir o software baixado para o seu ambiente fisicamente isolado. Para se considerada confiável a mídia removível deve ser nova e nunca usada, proveniente de uma fonte confiável e conhecida. Ela também precisa ser analisada e a ausência de vírus ou malware confirmada.
- Ambiente fisicamente isolado com computadores e armazenamento que atendem aos [requisitos](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm) para a instalação do Tableau Server.

## Instalação do Tableau Server em um computador fisicamente isolado com Windows

Para simplificar esse procedimento, instale o Tableau Server no computador, antes de colocá-lo em um ambiente fisicamente isolado. Se isso não for possível, você precisa baixar os pacotes necessários para um computador confiável fora do ambiente fisicamente isolado e transferi-los:

1. Em um computador confiável fora do ambiente fisicamente isolado com acesso à Internet, baixe o pacote de instalação do Tableau Server.
2. Transfira o pacote para a sua mídia removível.
3. No seu computador fisicamente isolado, insira a mídia removível contendo o pacote de instalação do Tableau Server e, em seguida, [execute o instalador](https://help.tableau.com/current/server/pt-br/setup.htm).
    
    **Observação:** o Server ATR é o método de ativação padrão para Tableau Server 2021.4 e posterior. A partir de Tableau Server 2023.1 e posterior, você pode usar o Server ATR para instalar em um ambiente sem ar.
4. Após a conclusão da instalação, você pode ativar as chaves do produto do Tableau Server. Para obter mais informações, consulte [Ativação do Tableau Server em um ambiente fisicamente isolado](#Activati).

## Ativação do Tableau Server em um ambiente fisicamente isolado

Como um computador isolado fisicamente não está conectado à Internet, você precisará realizar o processo de ativação do Tableau Server manualmente.

## Visão geral de ativação off-line

A ativação off-line do Tableau Server depende do seu método de ativação (com ou sem o serviço de autorização para execução, ATR).

**Observação**: ao usar ATR e ativar uma licença USL para Tableau Server, você pode usar o **Nome da chave** do Produto ou o **ID de ativação off-line**. Recomendamos usar o Nome da chave porque você não precisa determinar o ID de ativação off-line.

A ativação off-line _sem_ ATR envolve as seguintes etapas:

1. Gere um arquivo de solicitação de ativação off-line.
2. Copie o arquivo de solicitação de ativação offline para um computador com acesso à Internet.
3. Carregue o arquivo de solicitação de ativação off-line no [site de ativação do Tableau](https://www.tableau.com/pt-br/support/activation).
4. Baixe o arquivo de resposta de ativação offline resultante do site . Você usará este arquivo para ativar o Tableau Server

### Mudanças no nome do arquivo de ativação off-line

A partir do Tableau Server versão 2023.1, o sistema de licenciamento do Tableau oferece suporte a duas tecnologias de licenciamento subjacentes. Do ponto de vista administrativo, a única diferença de configuração entre os dois sistemas são os tipos de arquivo que são gerados e consumidos para ativação offline. A tecnologia de licenciamento é determinada durante a instalação inicial do Tableau Server e não pode ser alterada após a instalação.  
  
Estamos nos referindo à versão legada (e ainda suportada) da tecnologia de licenciamento como FlexNet. A versão mais recente da tecnologia é chamada ATR. Para obter mais informações, consulte [Ativar o Tableau Server usando o serviço ATR (Autorização para execução)](https://help.tableau.com/current/server/pt-br/atr_service.htm). A tabela a seguir descreve a nomenclatura de nomenclatura de arquivo para cada tecnologia. A tabela também inclui a referência genérica.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 33%;"><col style="width: 33%;"><col style="width: 33%;"></colgroup><tbody><tr><th>Nome de arquivo genérico</th><th>Nomes de arquivos do Server ATR</th><th>Nomes do arquivo FlexNet</th></tr><tr><td>OfflineAtivationRequest</td><td>OfflineActivationRequestFile_yyyyMMdd.hhmmss.json</td><td>TableauOfflineActivationRequest.tlq</td></tr><tr><td>OfflineAtivationResponse</td><td>OfflineAtivaçãoLicenciamentoAtrs.zip</td><td>activation.tlf</td></tr></tbody></table>

**Observação:** Como esta documentação oferece suporte a várias versões do Tableau Server, usaremos a referência de nome de arquivo genérico (OfflineActivationRequest e OfflineActivationResponse) para o restante deste tópico. Você pode identificar a tecnologia de licenciamento usada pela instalação do Tableau Server de acordo com o tipo de arquivo gerado nas etapas a seguir.

### Etapa 1. Fazer logon no Tableau Services Manager

- Para fazer logon no Tableau Services Manager (TSM), execute o comando a seguir:
    
    `[tsm login](https://help.tableau.com/current/server/pt-br/cli_login.htm) -u <username>`

**E se eu não conseguir fazer logon?**

Verifique se a conta que está usando é um membro do grupo de Administradores locais no computador Windows onde está instalando o Tableau Server.

### Etapa 2. Determinar o local de licenciamento do Tableau Server

A forma como você ativa o Tableau Server será diferente dependendo do tipo de licenciamento que você está executando. Execute o seguinte comando para determinar o tipo de licenciamento com o qual sua implantação do Tableau Server está configurada:

`tsm configuration get -k serverauthorizationtorun.enabled`

Se este comando retornar `true`, sua implantação será configurada com o tipo de licenciamento Server ATR.

Se este comando retornar `false`, sua implantação será configurada com o tipo de licenciamento herdado.

Vá para a etapa 3 que corresponda ao seu tipo de licenciamento.

### Etapa 3 (tipo de licenciamento ATR do servidor) Gere e copie o conteúdo json para a página Ativação.

Siga estas etapas se a implantação do Tableau Server estiver configurada com o tipo de licenciamento Server ATR. Se o seu servidor estiver configurado com o tipo de licenciamento herdado, pule para a seção a seguir.

1. No seu Tableau Server em ambiente fisicamente isolado, use TSM para obter o arquivo de ativação off-line. No prompt de comando:
    
    `tsm licenses get-offline-activation-file -k <product-key> -o <target-directory>`
    
    O `<target-directory>` deve existir. Você pode obter sua chave do produto no [Portal do cliente do Tableau](http://customer.tableau.com).
2. Copie o conteúdo do arquivo JSON.
3. No computador conectado à Internet, navegue até o site da Web [ativação offline do Tableau](https://www.tableau.com/pt-br/support/activation), selecione Opção B - Inserir informações manualmente do arquivo de ativação, copie o conteúdo JSON nos campos solicitados e clique em Enviar.
4. O site deve exibir `The activation was successful. Please click here to download your activation file.`
    
    Baixe o arquivo OfflineActivationResponse do Tableau e prossiga para a etapa 4.

### Etapa 3 (Tipo de licenciamento herdado) Transcrever os dados do seu sistema fisicamente isolado em um modelo de solicitação de ativação.

Siga estas etapas se sua implantação do Tableau Server estiver configurada com o tipo de licenciamento herdado. Se o seu servidor estiver configurado com o tipo de licenciamento Server ATR, execute o procedimento acima.

1. No seu Tableau Server em ambiente fisicamente isolado, use TSM para obter o arquivo de ativação off-line. No prompt de comando:
    
    `tsm licenses get-offline-activation-file -k <product-key> -o <target-directory>`
    
    O `<target-directory>` deve existir. Você pode obter sua chave do produto no [Portal do cliente do Tableau](http://customer.tableau.com).
2. Se você puder copiar o arquivo de solicitação offline (OfflineActivationRequest) do diretório de destino para um computador com acesso à Internet, pule para a etapa 5.
    
    Caso contrário, se você não puder copiar o arquivo para outro computador por motivos de segurança, continue com a etapa 3.
3. Baixe e abra o arquivo [`server_windows.tlq`](https://help.tableau.com/offline/en-us/server_windows.tlq) em um editor de texto XML, como o Notepad++, em um computador confiável com acesso à Internet.
    
    Você precisará anotar os valores listados na etapa 4 do computador air-gapped para copiá-los para o modelo offline (`server_windows.tlq`).
4. Atualize os elementos XML a seguir no arquivo `server_windows.tlq` adequado com os valores dos mesmos elementos listados abaixo no computador desconectado.
    
    Todos os valores de Máquina/Hash nos arquivos .tlq são valores hexadecimais. Os únicos caracteres válidos são 0 - 9 e A - F. As letras devem estar sempre em maiúsculas.
    
    Não adicione espaços ou controles de carro adicionais e modifique apenas os caracteres “X” encontrados no modelo. O formato do arquivo não deve ser alterado.
    
    Linha 2 - <EntitlementId>
    
    Linha 5 - <ClientVersion>
    
    Linha 5 - <RevisionType> (Este valor está presente no arquivo server\_windows.tlq.)
    
    Linha 5 - <MachineIdentifier> (Este valor está presente no arquivo server\_windows.tlq.)
    
    Linha 11 - <Value> (se o valor não for apresentado, remova o espaço reservado "X", deixando <Value></Value>.)
    
    Linha 12 - <Value> (se o valor não for apresentado, remova o espaço reservado "X", deixando <Value></Value>.)
    
    Linha 14 - <SequenceNumber>
    
    Linha 60 - <Hash>
5. Faça upload do arquivo offline solicitado (OfflineActivationRequest) para o site [Ativação do Tableau Offline](https://www.tableau.com/pt-br/support/activation).
6. O site deve exibir `The activation was successful. Please click here to download your activation file.`
    
    Baixe o arquivo OfflineActivationResponse do Tableau.

### Etapa 4. Inicializar ou ativar a sua licença

1. Mova o arquivo OfflineActivationResponse para o computador desconectado usando mídias removíveis confiáveis.
2. Execute o seguinte comando:
    
    `tsm licenses activate --license-file <path-and-activation-file>`
    
    Você deve ver a mensagem "`Activation successful.`", que indica que o Tableau Server está ativado.

## Exibição de mapas em um ambiente fisicamente isolado

Em um ambiente fisicamente isolado, os mapas no Tableau Server não estarão disponíveis por padrão devido à ausência de acesso à Internet. Em vez disso, você pode configurar o Tableau para usar mapas locais em um ambiente isolado seguindo as etapas abaixo.

### Configurar o Tableau Server para usar os dados do mapas offline:

1. Abra um prompt de comando como administrador.
2. Configure o Tableau para usar mapas offline disponíveis localmente:
    
    tsm configuration set -k [vizqlserver.force\_maps\_to\_offline](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#vizqlserver_offlinemaps) -v true
    
    tsm pending-changes apply

<!-- document id=710331920d6bddcd3014cc5d6b61c99bf6df0d82520d6fec14091c6e94e22eb5 url=/tableau/current/pt-br/server/config_2node.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server em um cluster de dois nós

Quando você instala o Tableau Server em um cluster de dois nós, pode instalar processos de servidor em um ou ambos os nós. Um cluster de dois nós pode melhorar o desempenho do Tableau Server, já que o trabalho fica espalhado entre várias máquinas.

Observe o seguinte sobre clusters de dois nós:

- Um cluster de dois nós não oferece failover ou tem suporte a alta disponibilidade.
- Não é possível instalar mais de uma instância do repositório em um cluster de dois nós, e o repositório deve estar no nó inicial.

Se precisar de failover ou alta disponibilidade, ou se desejar uma segunda instância do repositório, você deve instalar o Tableau Server em um cluster de pelo menos três computadores. Em um cluster que inclui pelo menos três nós, é possível configurar duas instâncias do repositório, que oferece recursos de failover de cluster.

<!-- document id=e9f4e456a79d1db09b713f13849a26bfb57077ca8390ad23ce89cb120ac80763 url=/tableau/current/pt-br/server/ts_alibaba_welcome.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server na Alibaba Cloud

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao instalar o Tableau Server em uma instância do Elastic Compute Service (ECS) da Alibaba Cloud, você ainda terá os recursos avançados do Tableau Server em um ambiente local. Executar o Tableau Server na instância do ECS é uma excelente escolha se desejar ter a flexibilidade de escalar horizontal ou verticalmente, sem precisar comprar e manter uma frota de servidores onerosa. Por exemplo, é possível configurar o Tableau Server para ficar altamente disponível e integrá-lo a todos os aplicativos empresariais comuns (por exemplo, o Active Directory) dos quais muitas organizações dependem.

Procurando o Tableau Server no Linux? Consulte [Instalar o Tableau Server na Alibaba Cloud](https://help.tableau.com/current/server-linux/pt-br/ts_alibaba_welcome.htm "Abre o tópico em uma nova guia do navegador").

Você pode armazenar os dados usados com o Tableau Server nos seguintes bancos de dados da Alibaba:

- [Apsara DB RDS para Microsoft SQL Server](https://www.alibabacloud.com/product/apsaradb-for-rds-sql-server): um serviço de hospedagem de banco de dados sob demanda para o Microsoft SQL Server.
- [Apsara DB RDS para MySQL](https://www.alibabacloud.com/product/apsaradb-for-rds-mysql): um serviço de hospedagem de banco de dados sob demanda para MySQL.
- [Apsara DB RDS para PostgreSQL](https://www.alibabacloud.com/product/apsaradb-for-rds-postgresql): um serviço de hospedagem de banco de dados sob demanda para PostgreSQL.

Você pode usar os seguintes [conectores](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#exampleconnections_overview.htm) de dados nativos para se conectar aos seus dados na Alibaba Cloud:

- [Microsoft SQL Server](https://help.tableau.com/current/pro/desktop/pt-br/examples_sqlserver.htm): conectar-se a um banco de dados Microsoft SQL Server.
- [MySQL](https://help.tableau.com/current/pro/desktop/pt-br/examples_mysql.htm): conectar-se a um banco de dados MySQL.
- [PostgreSQL](https://help.tableau.com/current/pro/desktop/pt-br/examples_postgresql.htm): conectar-se a um banco de dados PostgreSQL.
- [Outros bancos de dados (JDBC)](https://help.tableau.com/current/pro/desktop/pt-br/examples_otherdatabases_jdbc.htm): conecta-se a um banco de dados utilizando a padrão de Conectividade do Banco de Dados Java (JDBC).
- [Outros bancos de dados (ODBC)](https://help.tableau.com/current/pro/desktop/pt-br/examples_otherdatabases.htm): conecta-se a um banco de dados usando o padrão ODBC (Open Database Connectivity).

## Outros artigos nesta seção

<!-- document id=2e479ed7b607f4d7e93d9cb16926ac64c7e4d86bb1b9eef411ae5d0e0fc05e7c url=/tableau/current/pt-br/server/ts_aws_welcome.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server na Amazon Web Services

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao instalar o Tableau Server em uma máquina virtual (VM) da Amazon Web Services (AWS), você ainda terá os recursos avançados doTableau Server em um ambiente local. Executar o Tableau Server na VM da AWS é uma excelente escolha se desejar ter a flexibilidade de escalar horizontal ou verticalmente, sem precisar comprar e manter uma frota de servidores onerosa. Por exemplo, é possível configurar o Tableau Server para ficar altamente disponível e integrá-lo a todos os aplicativos empresariais comuns (por exemplo, o Active Directory) dos quais muitas organizações dependem.

Procurando o Tableau Server no Linux? Consulte [Instalar o Tableau Server na Amazon Web Services](https://help.tableau.com/current/server-linux/pt-br/ts_aws_welcome.htm "Abre o tópico em uma nova guia do navegador").

Tableau Server pode aproveitar muitos serviços nativos da AWS:

- [Amazon CloudWatch](https://aws.amazon.com/cloudwatch): monitora os componentes da sua solução baseada em AWS.
- [Amazon Route53](https://aws.amazon.com/route53): o serviço DNS da Web para conectar as solicitações do usuário à sua infraestrutura da AWS.
- [AWS Certificate Manager](https://aws.amazon.com/certificate-manager): ajuda a implantar os certificados SSL e TLS para usar com a AWS.
- [AWS CloudFormation](https://aws.amazon.com/cloudformation): ajuda a criar e gerenciar recursos relacionados da AWS de forma controlada usando modelos predefinidos.
- [Elastic Load Balancing](https://aws.amazon.com/elasticloadbalancing): você pode usar o Elastic Load Balancing para propagar as solicitações em vários gateways do Tableau.

Além disso, você pode armazenar os dados usados no Tableau Server por meio de qualquer um dos seguintes recursos da AWS. O Tableau fornece [conectores](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#exampleconnections_overview.htm) de dados nativos que permitem a conexão com dados nas seguintes fontes de dados da AWS:

- [Amazon Athena](https://help.tableau.com/current/pro/desktop/pt-br/examples_amazonathena.htm): serviço de consulta interativa que pode ser usado para analisar os dados no Amazon S3 usando SQL.
- [Amazon Aurora para MySQL](https://help.tableau.com/current/pro/desktop/pt-br/examples_amazonaurora.htm): banco de dados de alto desempenho compatível com MySQL.
- [Amazon EMR Hadoop Hive](https://help.tableau.com/current/pro/desktop/pt-br/examples_amazonemr.htm): estrutura Hadoop gerenciada para o processamento de grandes quantidades de dados.
- [Amazon Redshift](https://help.tableau.com/current/pro/desktop/pt-br/examples_amazonredshift.htm): solução de data warehousing para armazenar e extrair grandes quantidades de dados.
- Amazon RDS (Amazon Relational Database Service): a solução de banco de dados relacionais suporta [Amazon Aurora para MySQL](https://help.tableau.com/current/pro/desktop/pt-br/examples_amazonaurora.htm), [PostgreSQL](https://help.tableau.com/current/pro/desktop/pt-br/examples_postgresql.htm), [MySQL](https://help.tableau.com/current/pro/desktop/pt-br/examples_mysql.htm), [MariaDB](https://help.tableau.com/current/pro/desktop/pt-br/examples_mariadb.htm), [Oracle](https://help.tableau.com/current/pro/desktop/pt-br/examples_oracle.htm) e [Microsoft SQL Server](https://help.tableau.com/current/pro/desktop/pt-br/examples_sqlserver.htm).
- Amazon S3 (Amazon Simple Storage Service): solução de armazenamento baseado em nuvem.

## Outros artigos nesta seção

<!-- document id=a04c6a16556fb25cda8229b7934437931f107826d8a4aa1b921970316a4787f8 url=/tableau/current/pt-br/server/ts_azure_welcome.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o Tableau Server no Microsoft Azure

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao instalar o Tableau Server em uma máquina virtual (VM) do Microsoft Azure, você ainda terá os recursos avançados do Tableau Server em um ambiente local. Executar o Tableau Server em uma VM do Microsoft Azure será uma excelente escolha se você desejar ter a flexibilidade de escalar horizontal ou verticalmente sem precisar comprar e manter uma frota cara de servidores. Por exemplo, é possível configurar o Tableau Server para ficar altamente disponível e integrá-lo a todos os aplicativos empresariais comuns (por exemplo, o Active Directory) dos quais muitas organizações dependem.

Procurando o Tableau Server no Linux? Consulte [Instalar o Tableau Server no Microsoft Azure](https://help.tableau.com/current/server-linux/pt-br/ts_azure_welcome.htm "Abre o tópico em uma nova guia do navegador").

O Tableau Server pode aproveitar muitos recursos nativos do Azure:

- [Banco de Dados SQL do Azure](https://docs.microsoft.com/en-us/azure/sql-database/): banco de dados relacional como um serviço que usa o Microsoft SQL Server Engine.
- [Azure Synapse Analytics](https://docs.microsoft.com/en-us/azure/sql-data-warehouse/): (antigo Azure SQL Data Warehouse) sistema de banco de dados distribuído de processamento paralelo massivo (MPP) baseado na nuvem.
- [Apache Spark no Azure HDInsight](https://docs.microsoft.com/en-us/azure/hdinsight/hdinsight-apache-spark-overview): estrutura de processamento paralelo de código aberto para aplicativos de análise de big data.
- [Azure Active Directory](https://docs.microsoft.com/en-us/azure/active-directory/): serviço de gerenciamento de identidade e diretório baseado na nuvem.

Além disso, você pode armazenar os dados usados no Tableau Server por meio de qualquer um dos seguintes recursos da Microsoft. O Tableau fornece [conectores](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#exampleconnections_overview.htm) de dados nativos que permitem a conexão com dados nas seguintes fontes de dados da Microsoft:

- [Azure Synapse Analytics](https://help.tableau.com/current/pro/desktop/pt-br/examples_azure_sql_dw.htm): warehouse de dados na nuvem para empresas.
- [Microsoft Access](https://help.tableau.com/current/pro/desktop/pt-br/examples_access.htm): sistema de gerenciamento de banco de dados relacional incluído no Microsoft Office.
- [Microsoft Analysis Services](https://help.tableau.com/current/pro/desktop/pt-br/examples_msas.htm): ferramenta de mineração de dados e de processamento de transações e análises on-line (OLAP) do Microsoft SQL Server.
- [Microsoft Excel](https://help.tableau.com/current/pro/desktop/pt-br/examples_excel.htm): planilha incluída no Microsoft Office.
- [Microsoft PowerPivot](https://help.tableau.com/current/pro/desktop/pt-br/examples_powerpivot.htm): complemento do Microsoft Excel que permite importar dados de várias fontes para uma única pasta de trabalho, criar tabelas dinâmicas e gráficos dinâmicos e analisar os dados.
- [Microsoft SQL Server](https://help.tableau.com/current/pro/desktop/pt-br/examples_sqlserver.htm): sistema de gerenciamento de banco de dados relacional que usa SQL (Structured Query Language).

## Outros artigos nesta seção

<!-- document id=3fc1c56011d35813cb8cacb7f941ae36b0783abf9615e7e4260db9db89e9d571 url=/tableau/current/pt-br/server/setup.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar o TSM

Esse tópico é um guia pelo processo de instalação do Tableau Server do Tableau Services Manager (TSM).

**Importante:** não instale uma versão beta do Tableau Server no seu ambiente de produção. Nunca se deve restaurar uma instalação de produção do Tableau Server por meio de um backup de uma versão beta.

## Pré-requisitos

Antes de prosseguir, analise o tópico, [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm).

## Executar a configuração

Após baixar o arquivo de instalação do Tableau Server, siga as instruções abaixo para instalar o servidor.

**Importante:** não instale uma versão beta do Tableau Server no seu ambiente de produção. Nunca se deve restaurar uma instalação de produção do Tableau Server por meio de um backup de uma versão beta.

1. Faça logon como um usuário com acesso administrativo no computador em que deseja instalar o Tableau Server.
2. Siga as instruções na tela para concluir a instalação e instale o aplicativo.
    
    ![Imagem da configuração que permite alterar o caminho do arquivo](/tableau/current/pt-br/server/pt-br/Img/tsm-install-path.png)
    
    O caminho de instalação padrão é `C:\Program Files\Tableau\Tableau Server\<version>`. O programa de Configuração exibe o caminho de instalação sem a versão, assim: `C:\Program Files\Tableau\Tableau Server`. Escolha um local diferente, incluindo uma unidade diferente, por meio de navegação ou digitação de um novo caminho. Saiba que se navegar até um local, o programa de configuração anexa `\Tableau Server` ao final do caminho. Você pode remover isso se não for o local que quiser.
    
    Se estiver atualizando da versão 2018.1 ou anterior do Tableau Server e o Tableau tiver sido instalado em um local não padrão, é necessário especificar o local da versão existente. As etapas de atualização variam dependendo da versão de destino e local da instalação. Consulte [Visão geral da atualização do Tableau Server](https://help.tableau.com/current/server/pt-br/upgrade.htm) para obter informações sobre como escolher as etapas de atualização.
    
    **Observação:** Se o prompt do Windows Defender Firewall for exibido, clique em Permitir acesso. Pode ser necessário fazer isso várias vezes para que a instalação seja concluída.
3. Clique em Próximo.
    
    ![Imagem da configuração que permite alterar o tipo de instalação](/tableau/current/pt-br/server/pt-br/Img/tsm-install-type.png)
    
    Na página Tipo de instalação do Server, também é onde você especifica se instalará o primeiro nó de uma instalação do Server ou nós adicionais em uma instalação de vários nós. Não é necessário alterar isso do padrão (Criar nova instalação do Tableau Server.) a menos que você esteja instalando um Tableau Server de vários nós. Se estiver instalando um Tableau Server de vários nós, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).
4. Clique em Próximo.
    
    **Importante:** a partir da versão 2025.1.0, esta tela não será mais exibida. O serviço ATR é usado por padrão. Se você quiser usar o serviço de licenciamento legado, deverá instalar o Tableau Server a partir da linha de comando usando o `ACTIVATIONSERVICE` alterne para especificar a opção não padrão. Para obter mais informações, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm)
    
    ![Imagem da configuração que permite alterar o tipo de instalação](/tableau/current/pt-br/server/pt-br/Img/tsm-install-activation-type.png)
    
    Na página Tipo de ativação do produto, selecione se deseja usar o serviço ATR (Autorizado para execução) do Tableau para ativar o Tableau Server (o padrão) e, em seguida, clique em Instalar. Para obter mais informações sobre o serviço de ATR (autorização para execução) do Tableau, consulte [Ativar o Tableau Server usando o serviço ATR (Autorização para execução)](https://help.tableau.com/current/server/pt-br/atr_service.htm).
5. Após a conclusão da instalação, clique em Concluir. O processo de instalação abrirá a página da Web de configuração do TSM no computador no qual ocorreu a instalação do Tableau Server.
    
    Se você precisar oferecer suporte a caracteres que não sejam do conjunto Latin-1, instale os Pacotes de Idiomas do Windows por meio do Painel de controle > Opções regionais e de idioma. Os pacotes de idiomas precisarão ser instalados no servidor inicial, bem como em qualquer nó inicial.

### Instalar o Tableau Server

1. Abra um prompt de comando como um usuário com acesso de administrador no computador em que deseja instalar o Tableau Server.
2. Baixe o programa de instalação na página [Downloads do Tableau Server](https://www.tableau.com/pt-br/support/releases/server/).
3. Navegue até o diretório onde você copiou o programa de instalação.
4. Execute o programa de instalação na linha de comando usando as propriedades `/silent flag` (executar autônomo e silenciosamente sem prompts de interface do usuário), `ACCEPTEULA` (aceitar o Contrato de Licença de Usuário Final) e as pro`ACTIVATIONSERVICE` (use Server ATR para ativar Tableau Server):
    
    TableauServer-64bit-<version>.exe /silent ACCEPTEULA=1 ACTIVATIONSERVICE="1"
    
    **Observação:** há várias opções de instalação diferentes que você pode especificar durante a instalação da CLI, por exemplo, para alterar os caminhos de instalação e logs ou especificar a porta do controlador do TSM. Para obter uma lista completa dos switches que você pode especificar durante a instalação da CLI, consulte [Instalar switches e propriedades do Tableau Server](https://help.tableau.com/current/server/pt-br/silent_installer_flags.htm).
5. Feche a janela de comando e abra uma nova, em seguida confirme se o TSM está instalado e em execução:
    
    tsm status -v
    
    O status será `STOPPED` mas os processos do tsm-specific estarão em execução:
    
    node1: localhost
    Status: STOPPED
    'Tableau Server Coordination Service 0' is running.
    'Tableau Server Administration Agent 0' is running.
    'Tableau Server Administration Controller 0' is running.
    'Tableau Server License Manager 0' is running.
    'Tableau Server Client File Service 0' is running.

### Configurar o Tableau Server para um proxy de encaminhamento

Se a sua organização usar uma solução de proxy de encaminhamento para acessar a Internet, configure o Tableau Server para usar o servidor proxy. O Tableau Server deve acessar a Internet para obter dados de mapa e o recurso de licenciamento padrão.

Nesse momento do processo de instalação, recomenda-se a configuração do Tableau Server para uma solução de proxy de encaminhamento. Consulte [Configuração do Tableau Server no Windows para trabalhar com um proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/proxy.htm#Configure4-win-forward-proxy).

## Próxima etapa

- [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm)

<!-- document id=85904d2a9ef3c9663b6e7c346fbca0dea85396c1a6b4934bbd6c9f5ea1a3ed08 url=/tableau/current/pt-br/server/tabcmd_install_flags.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar switches e propriedades do tabcmd (Windows)

**Observação:** O utilitário de linha de comando tabcmd versão 2.0 está disponível em [Tabcmd do Tableau](https://tableau.github.io/tabcmd). Essa nova versão permite executar comandos tabcmd no MacOS e Linux e autenticar usando tokens de acesso pessoal (PATs). A versão 2.0 é baseada em endpoints públicos disponíveis no Tableau Server Client (TSC) baseado em Python. Essa versão mais recente tem suporte limitado ao Tableau Server.

Você pode usar os seguintes switches ao instalar o Utilitário de linha de comando do Tableau Server (tabcmd) versão 2019.4.0 ou posteriores usando a linha de comando no Windows.

**Observação:** não há switches equivalentes para a versão Linux do instalador tabcmd.

<table class="simple-table"><colgroup><col style="width: 25%;"><col><col></colgroup><tbody><tr><td>Switch</td><td>Descrição</td><td>Comentários</td></tr><tr><td><code>/install</code> | <code>/repair</code> | <code>/uninstall</code> | <code>/layout</code> "<code>&lt;directory&gt;</code>"</td><td><p>Execute a configuração para instalar, reparar ou desinstalar o tabcmd ou, com o <code>/layout</code>, crie uma cópia local completa do pacote de instalação no diretório especificado.</p></td><td>O padrão é instalar, exibir a interface do usuário e todos os prompts. Se nenhum diretório for especificado em uma nova instalação, <code>C:\Program Files\Tableau\Tableau Server\&lt;version&gt;\extras\Command Line Utility</code> será assumido.</td></tr><tr><td><code>/passive</code></td><td><p>Execute a Instalação com interface do usuário mínima e sem prompts.</p></td><td>&nbsp;</td></tr><tr><td><code>/quiet</code> | <code>/silent</code></td><td><p>Executar a instalação em modo totalmente silencioso e não supervisionado. Nenhuma interface do usuário ou prompts são exibidos.</p></td><td><p class="note"><b>Observação:</b> use <code>/silent</code> ou <code>/quiet</code>, mas não ambos.</p></td></tr><tr><td><code>/norestart</code></td><td><p>Execute a Instalação sem reiniciar o Windows, mesmo que seja necessária uma reinicialização.</p></td><td><p class="note"><strong>Observação: </strong>em casos raros específicos, uma reinicialização não pode ser cancelada, mesmo quando essa opção é usada. Isso é mais provável quando uma reinicialização do sistema anterior foi ignorada, por exemplo, durante a instalação de outro software.</p></td></tr><tr><td><code>/log "&lt;log-file&gt;"</code></td><td><p>Registrar informações no arquivos e caminho especificados.</p><p>Por padrão, os arquivos de registro são criados na pasta do usuário <code>%TEMP%</code>, com uma convenção de nomenclatura de <code>Tableau_Server_Command_Line_utility_&lt;version_code&gt;.log</code>.</p></td><td><p>Se nenhuma localização de arquivo for especificada, o arquivo de registro será gravado na pasta TEMP do usuário (<code>C:\Users\&lt;username&gt;\AppData\Local\Temp</code>). Verifique se há erros neste arquivo de registro, após a instalação.</p><p>Exemplo: <code>&lt;Setup file&gt; /silent /log "C:\Tableau\Logs\tabcmd-Install" ACCEPTEULA=1 </code></p></td></tr></tbody></table>

<table class="simple-table"><colgroup><col style="width: 25%;"><col><col></colgroup><tbody><tr><td>Propriedades</td><td>Descrição</td><td>Comentários</td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>Aceita o Contrato de licença do usuário final (EULA). Necessário para uma instalação tranquila, silenciosa e passiva. 1 = aceita o EULA, 0 = não aceita o EULA.</td><td><p>Se não estiver incluído ao usar o <code>/passive</code>, <code>/silent</code> ou <code>/quiet</code>, a configuração falhará silenciosamente.</p><p>Se incluído, mas definido como 0, a instalação falha.</p></td></tr><tr><td><code>INSTALLDIR="&lt;path\to\installation\directory&gt;"</code></td><td>Instalar o tabcmd no local de instalação não padrão especificado.</td><td><p>Especifica a localização para instalar o tabcmd. Se não for usado, o tabcmd será instalado em <code>C:\Program Files\Tableau\Tableau Server\&lt;version_code&gt;\extras\Command Line Utility</code></p><p>Exemplo: <code>&lt;Setup file&gt; /silent INSTALLDIR="C:\tabcmd"
					</code></p></td></tr></tbody></table>

<!-- document id=433096e92da1ab6deec863bec8d66c0b1a313d898a0059bdfcf5be5d46abdb8b url=/tableau/current/pt-br/server/silent_installer_flags.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar switches e propriedades do Tableau Server

Use os seguintes alternadores de instalador ao instalar o Tableau Server no Windows a partir de uma linha de comando.

<table class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td>Switch</td><td>Descrição</td><td>Comentários</td></tr><tr><td><code>/install</code> | <code>/repair</code> | <code>/uninstall</code> | <code>/layout</code> "<code>&lt;directory&gt;</code>"</td><td><p>Execute a Instalação para instalar, reparar ou desinstalar o Tableau Server, ou com o <code>/layout</code>, crie uma cópia local completa do pacote de instalação no diretório especificado.</p></td><td>O padrão é instalar, exibir a interface do usuário e todos os prompts. Se nenhum diretório for especificado em uma nova instalação, <code>C:\Program Files\Tableau\Tableau Server</code> será assumido. Se o Tableau Server já estiver instalado, a Instalação assumirá o mesmo local da instalação atual.</td></tr><tr><td><code>/passive</code></td><td><p>Execute a Instalação com interface do usuário mínima e sem prompts.</p></td><td>O Tableau Server não iniciará automaticamente quando for instalado no modo <code>/passive</code>. Para iniciar o Tableau Server, use <code>tsm start</code>.</td></tr><tr><td><code>/quiet</code> | <code>/silent</code></td><td><p>Executar a instalação em modo totalmente silencioso e não supervisionado. Nenhuma interface do usuário ou prompts são exibidos.</p></td><td>O Tableau Server não iniciará automaticamente quando for instalado no modo <code>/silent</code> ou <code>/quiet</code>. Para iniciar o Tableau Server, use <code>tsm start</code>.<p class="note"><b>Observação:</b> use <code>/silent</code> ou <code>/quiet</code>, mas não ambos.</p></td></tr><tr><td><code>/norestart</code></td><td><p>Execute a Instalação sem reiniciar o Windows, mesmo que seja necessária uma reinicialização.</p></td><td><p class="note"><strong>Observação: </strong>em casos raros específicos, uma reinicialização não pode ser cancelada, mesmo quando essa opção é usada. Isso é mais provável quando uma reinicialização do sistema anterior foi ignorada, por exemplo, durante a instalação de outro software.</p></td></tr><tr><td><code>/log "&lt;drive&gt;\&lt;path&gt;\&lt;log-file&gt;.&lt;ext&gt;"</code></td><td>Registrar informações no arquivos e caminho especificados.<p></p><p><strong>Observação:</strong> o comportamento ao usar o opção <code>/log</code> mudou a partir da versão 2021.2.0. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/whatsnew_server.htm" class="xref">Notas de versão do Tableau Server</a></p>.<p></p></td><td><p>Use esta opção com um caminho e nome de arquivo de registro para disponibilizar o registro após a conclusão da instalação.</p><p>Se essa opção for usada com um nome de arquivo de registro, mas sem caminho, o arquivo de registro será gravado em um local temporário e excluído no final da instalação.</p><p>Se esta opção for usada, mas nenhum nome de arquivo de registro for especificado, a opção será ignorada e o arquivo será gravado em <code>%TEMP%</code>.</p><p>Se esta opção não for usada, o arquivo de registro será gravado em <code>%TEMP%</code>.</p></td></tr></tbody></table>

<table class="simple-table"><colgroup><col style="width: 30%;"><col><col></colgroup><tbody><tr><td>Propriedades (diferenciam letras maiúsculas de minúsculas)</td><td>Descrição</td><td>Comentários</td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>Aceita o Contrato de licença do usuário final (EULA). Exigido para instalação quieta, silenciosa e passiva nos nós inicial e adicional. 1 = true, aceita o EULA, 0 = false, não aceita o EULA.</td><td><p>Se não estiver incluído ao usar o <code>/passive</code>, <code>/silent</code> ou <code>/quiet</code>, a configuração falhará silenciosamente.</p><p>Se incluído, mas definido como 0, a instalação falha.</p></td></tr><tr><td><code>ACTIVATIONSERVICE="1"|"0"</code></td><td>Ative <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> usando o serviço ATR (autorização para execução). "1" = usa o Server ATR. "0" = não usa o Server ATR.<p class="note"><strong>Importante:</strong> a partir da versão 2025.1.0, se você não quiser usar o serviço de licenciamento ATR, deverá instalar o Server na linha de comando, usando esta opção para especificar que deseja usar o serviço legado (não ATR). Por exemplo:</p><pre xml:space="preserve">TableauServer-64bit-&lt;version&gt;.exe /silent ACCEPTEULA=1 ACTIVATIONSERVICE="0"</pre></td><td><p>Essa opção é apenas para novas instalações, não upgrades. Selecione essa opção se:</p><ul><li>Você planeja ativar o Tableau Server online</li><li>Você planeja instalar o Tableau Server na nuvem</li><li>Você planeja instalar o Tableau Server em uma máquina virtual ou outro ambiente não persistente</li></ul><p>Não use essa opção se:</p><ul><li>Você planeja ativar o Tableau Server offline</li><li>Você planeja instalar o Tableau Server em um ambiente fisicamente isolado</li></ul><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/atr_service.htm" target="_blank" class="xref">Ativar o Tableau Server usando o serviço ATR (Autorização para execução)</a>.</p></td></tr><tr><td><code>BOOTSTRAPFILE="&lt;path\to\bootstrap\file&gt;"</code></td><td>Exigido ao adicionar um nó a um cluster. O arquivo bootstrap contém a configuração usada pelos nós adicionais.</td><td>Exemplo:&nbsp;<code>&lt;Setup file&gt; /silent ACCEPTEULA=1 BOOTSTRAPFILE="C:\Users\tableauadmin\Downloads\bootstrap.json" </code></td></tr><tr><td><code>CONTROLLERPORT=</code></td><td>Opcional. A porta na qual o controlador do Tableau Services Manager (TSM) deve ser executada.</td><td>Se não estiver incluído, o padrão é 8850.</td></tr><tr><td><code>COORDINATIONSERVICECLIENTPORT=</code></td><td>Opcional. A porta na qual o cliente do Serviço de coordenação do Tableau Services Manager (TSM) deve ser executado. </td><td>Se não estiver incluído, o padrão é uma porta mapeada dinamicamente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ports.htm" class="xref">Portas do Tableau Services Manager</a>.</td></tr><tr><td><code>COORDINATIONSERVICEPEERPORT=</code></td><td>Opcional. A porta na qual o par do Serviço de coordenação do Tableau Services Manager (TSM) deve ser executado. </td><td>Se não estiver incluído, o padrão é uma porta mapeada dinamicamente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ports.htm" class="xref">Portas do Tableau Services Manager</a>.</td></tr><tr><td><code>COORDINATIONSERVICELEADERPORT=</code></td><td>Opcional. A porta na qual o Líder do Serviço de coordenação do Tableau Services Manager (TSM) deve ser executado.</td><td>Se não estiver incluído, o padrão é uma porta mapeada dinamicamente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ports.htm" class="xref">Portas do Tableau Services Manager</a>.</td></tr><tr><td><code>DATADIR="&lt;path\to\data\directory&gt;"</code></td><td>Opcional. O local onde a configuração de software e os dados do Tableau Server estão armazenados. Se você não fornecer um caminho do diretório de dados e o Tableau Server estiver sendo instalado no local padrão (INSTALLDIR não está especificado), o diretório de dados padrão será usado: <code>C:\ProgramData\Tableau\Tableau Server</code>. Se você não fornecer um caminho do diretório de dados e o INSTALLDIR for especificado, o DATADIR também será definido como o local do INSTALLDIR.</td><td>Exemplo: <code>DATADIR="D:\TableauServerData"</code></td></tr><tr><td><code>EMBEDDEDCREDENTIAL=1|0</code></td><td><p>Obrigatório ao adicionar um nó a um cluster e o arquivo bootstrap contém as credenciais inseridas de um administrador no computador do TSM.</p><p>1=true, 0=false. O padrão é 0.</p></td><td>Deve ser usado com <code>/silent</code> ou <code>/quiet</code> e com <code>BOOTSTRAPFILE</code><p>Exemplo:&nbsp;<code>&lt;Setup file&gt; /silent ACCEPTEULA=1 BOOTSTRAPFILE="C:\Users\tableauadmin\Downloads\bootstrap.json" EMBEDDEDCREDENTIAL=1</code></p></td></tr><tr><td><code>INSTALLDIR="&lt;path\to\installation\directory&gt;"</code></td><td>Instalar no local de instalação não padrão especificado.</td><td><p>Especifica a localização para o servidor de instalação. Se não for usado, o Tableau Server será instalado em <code>C:\Program Files\Tableau\Tableau Server
</code></p><p>Exemplo: <code>&lt;Setup file&gt; /silent INSTALLDIR="D:\Tableau\Tableau Server"
					</code></p></td></tr><tr><td><code>LICENSESERVICEVENDORDAEMONPORT=</code></td><td>Opcional. A porta em que o fornecedor do Serviço de licença daemon deve funcionar. Isso é usado em instalações de vários nós para comunicações relacionadas ao licenciamento entre nós.</td><td>Se não estiver incluído, o padrão é uma porta mapeada dinamicamente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ports.htm" class="xref">Portas do Tableau Services Manager</a>.</td></tr><tr><td><code>SKIPPYTHONINSTALL=1|0</code><p>Adicionado na versão 2021.3.0</p></td><td>Opcional. Se definido como 0 (o padrão), o programa de instalação instala o pacote Python incluído. Se definido como 1, especifica que o programa de instalação não deve instalar o pacote Python como parte do Tableau Server.<p><strong>Observação:</strong> Python será usado em versões futuras do Tableau Server, para oferecer suporte a recursos analíticos avançados. Se você optar por ignorar a instalação do Python, os usuários do Tableau Server não terão acesso a esses recursos analíticos avançados quando esses recursos estiverem disponíveis.</p></td><td>Se não estiver incluído, o padrão será instalar o Python como parte do Tableau Server.</td></tr></tbody></table>

<!-- document id=1f6c52d140b458d174f4281fb69be55c3581af1a29e43b121b6d39324045eb93 url=/tableau/current/pt-br/server/server_tsig_install_switches.md -->

[Pular para o conteúdo principal](#main-content)

# Instalar switches e propriedades para o Tableau Server Independent Gateway

<table class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td>Switch</td><td>Descrição</td><td>Comentários</td></tr><tr><td><code>/install</code> | <code>/repair</code> | <code>/uninstall</code> | <code>/layout</code> "<code>&lt;directory&gt;</code>"</td><td><p>Execute a Instalação para instalar, reparar ou desinstalar o Tableau Server Independent Gateway, ou com o <code>/layout</code>, crie uma cópia local completa do pacote de instalação no diretório especificado.</p></td><td>O padrão é instalar, exibir a interface do usuário e todos os prompts. Se nenhum diretório for especificado em uma nova instalação, <code>C:\Program Files\Tableau\Tableau Server\ independentgateway</code> será assumido. Se o TSIG já estiver instalado, a Instalação assumirá o mesmo local da instalação atual.</td></tr><tr><td><code>/passive</code></td><td><p>Execute a Instalação com interface do usuário mínima e sem prompts.</p></td><td></td></tr><tr><td><code>/quiet</code> | <code>/silent</code></td><td><p>Executar a instalação em modo totalmente silencioso e não supervisionado. Nenhuma interface do usuário ou prompts são exibidos.</p></td><td><p class="note"><b>Observação:</b> use <code>/silent</code> ou <code>/quiet</code>, mas não ambos.</p></td></tr><tr><td><code>/norestart</code></td><td><p>Execute a Instalação sem reiniciar o Windows, mesmo que seja necessária uma reinicialização.</p></td><td><p class="note"><strong>Observação: </strong>em casos raros específicos, uma reinicialização não pode ser cancelada, mesmo quando essa opção é usada. Isso é mais provável quando uma reinicialização do sistema anterior foi ignorada, por exemplo, durante a instalação de outro software.</p></td></tr><tr><td><code>/log "&lt;drive&gt;\&lt;path&gt;\&lt;log-file&gt;.&lt;ext&gt;"</code></td><td>Registrar informações no arquivos e caminho especificados.</td><td><p>Use esta opção com um caminho e nome de arquivo de registro para disponibilizar o registro após a conclusão da instalação.</p><p>Se essa opção for usada com um nome de arquivo de registro, mas sem caminho, o arquivo de registro será gravado em um local temporário e excluído no final da instalação.</p><p>Se esta opção for usada, mas nenhum nome de arquivo de registro for especificado, a opção será ignorada e o arquivo será gravado em <code>%TEMP%</code>.</p><p>Se esta opção não for usada, o arquivo de registro será gravado em <code>%TEMP%</code>.</p></td></tr></tbody></table>

<table class="simple-table"><colgroup><col style="width: 30%;"><col><col></colgroup><tbody><tr><td>Propriedades</td><td>Descrição</td><td>Comentários</td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>Aceita o Contrato de licença do usuário final (EULA). Exigido para instalação quieta, silenciosa e passiva nos nós inicial e adicional. 1 = true, aceita o EULA, 0 = false, não aceita o EULA.</td><td><p>Se não estiver incluído ao usar o <code>/passive</code>, <code>/silent</code> ou <code>/quiet</code>, a configuração falhará silenciosamente.</p><p>Se incluído, mas definido como 0, a instalação falha.</p></td></tr><tr><td><code>DATADIR="&lt;path\to\data\directory&gt;"</code></td><td>Opcional. O local onde a configuração de software e os dados do TSIG estão armazenados. Se você não fornecer um caminho do diretório de dados e o TSIG estiver sendo instalado no local padrão (INSTALLDIR não está especificado), o diretório de dados padrão será usado: <code>C:\ProgramData\Tableau\Tableau Server</code>. Se você não fornecer um caminho do diretório de dados e o INSTALLDIR for especificado, o DATADIR também será definido como o local do INSTALLDIR.</td><td>Exemplo: <code>DATADIR="D:\TableauServerData"</code></td></tr><tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td><code>HKPORT="&lt;port&gt;"</code></td><td>Escuta de porta para solicitações de manutenção do cluster do Tableau Server.<p>O padrão é <code>21319</code>.</p></td><td>&nbsp;</td></tr><tr><td><code>HKPROTOCOL="&lt;protocol&gt;"</code></td><td>Protocolo para solicitações de limpeza.<p>As opções são <code>http</code> ou <code>https</code>. O padrão é <code>http</code>.</p></td><td>&nbsp;</td></tr><tr><td><code>INSTALLDIR="&lt;path\to\installation\directory&gt;"</code></td><td>Instalar no local de instalação não padrão especificado.</td><td>Especifica a localização para o servidor de instalação. Se não for usado, o Tableau Server Independent Gateway será instalado em <code>C:\Program Files\Tableau\Tableau Server\independentgateway
</code><p>Exemplo: <code>&lt;Setup file&gt; /silent INSTALLDIR="D:\Tableau\Tableau Server\independentgateway"
					</code></p></td></tr><tr><td><code>INSTANCEID="&lt;computer_identifier&gt;"</code></td><td>Um identificador exclusivo para esta instância TSIG.<p>O padrão é "%COMPUTERNAME%".</p></td><td>&nbsp;</td></tr><tr><td><p><code>PORT="&lt;port&gt;"</code></p></td><td>Porta escutando solicitações externas.<p>O padrão é "80".</p></td><td>&nbsp;</td></tr><tr><td><code>PROTOCOL="&lt;protocol&gt;"</code></td><td>Protocolo para solicitações externas. As escolhas são <code>http</code> ou <code>https</code>. O padrão é <code>http</code>.</td><td>&nbsp;</td></tr><tr><td><code>TSCLUSTER="&lt;nodes&gt;"</code></td><td>Local(is) de rede dos nós do Tableau Server dos quais as solicitações de manutenção do TSIG podem ser recebidas.<p>Esses são todos nós com Controlador de Cluster ou Agente de Administração, portanto, inclui todos os nós do cluster.</p><p>Isso é necessário. Não há padrão para esta opção.</p></td><td>Deve ser uma das formas aceitáveis para a diretiva Apache httpd mod_authz_host "Obrigatória" (<a href="https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html" target="_blank">https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html</a>).<p>Exemplos:<code> "ip 192.1.168.0/24"</code>, <code>"host ts.example.org"</code>.</p><p>Use aspas se houver espaços inseridos.</p></td></tr><tr><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody></table>

<!-- document id=1e678cacf40b32cd0d382a0898668c6e9ba32dbdccb804507e335c77060c23e4 url=/tableau/current/pt-br/server/logs_archive.md -->

[Pular para o conteúdo principal](#main-content)

# Instantâneos do arquivo de log (Arquivar logs)

O Tableau Server inclui a funcionalidade para gerar um instantâneo dos arquivos de log para fins de arquivamento. Se planeja limpar e excluir arquivos de log antigos como parte da manutenção do servidor regular, considere arquivar os arquivos de log em uma localização de armazenamento fora do servidor antes de excluí-los.

**Observação**: para obter instruções sobre coletar registros em versões antigas do Tableau Server para Windows, consulte a ajuda on-line arquivada na página [Ajuda do Tableau](https://www.tableau.com/pt-br/support/help).

Ou, se estiver trabalhando com o Suporte do Tableau em um caso, o engenheiro de suporte pode solicitar um instantâneo do arquivo de log do servidor.

Este tópico descreve:

- Como gerar um instantâneo do arquivo de log
- Como enviar o instantâneo diretamente para o Suporte do Tableau a partir das ferramentas de administrador do Tableau Server
- Como baixar o instantâneo
- Como excluir logs arquivados

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Manutenção.
3. Gere um instantâneo do arquivo de log.
    
    1. Na página Manutenção do servidor, em Arquivos de log, clique em Gerar instantâneo do arquivo de log.
        
        Uma caixa de diálogos de opções é exibida:
        
        ![Uma caixa de diálogo com campos de formulário para gerar um instantâneo dos arquivos de registro.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-log-snapshot-win.png)
    2. Na página Opções, insira ou selecione as opções desejadas, incluindo uma Descrição, o Intervalo de tempo dos arquivos de log a serem incluídos e os tipos opcionais de logs a serem incluídos (Incluir Netstat Info, Incluir MSInfo, Incluir dados de Postgres, Incluir arquivos de despejo recentes), em seguida clique em Gerar instantâneo do arquivo de log.
    
    O instantâneo é salvo no computador em um local fixo onde o TSM e o Tableau Server estão instalados. Se você tiver uma instalação com vários nós, o instantâneo será salvo no nó inicial do cluster. A localização é especificada pela variável `basefilepath_log_archives`.
    
    Por padrão, o instantâneo é salvo em:
    
    `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives`
    
    Encontre a localização atual ao consultar a configuração `basefilepath.log_archives` , e altera a localização ao especificar um novo valor para `basefilepath.log_archive`. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).
4. Depois de gerar o instantâneo, você pode selecioná-lo e carregá-lo para o Suporte técnico, baixá-lo para seu computador local ou excluí-lo
    
    ![Uma tabela com arquivos de registro gerados e opções para gerar, baixar, carregar ou excluir arquivos de registro.](/tableau/current/pt-br/server/pt-br/Img/tsm-maint-gen-snapshot-actions.png)
5. Para baixar uma cópia local do instantâneo ou para excluí-la, selecione o instantâneo em Arquivos de log, em seguida selecione a Ação adequada.

### Fazer upload dos instantâneos de log para o Suporte do Tableau

1. Clique na guia Manutenção.
2. Selecione o instantâneo que deseja enviar.
    
    ![Uma tabela com arquivos de registro gerados e opções para gerar, baixar, carregar ou excluir arquivos de registro.](/tableau/current/pt-br/server/pt-br/Img/tsm-maint-gen-snapshot-actions.png)
3. Clique em Fazer upload para o caso de suporte técnico.
4. Na caixa de diálogo exibida, insira o Número do caso de suporte e seu Endereço de e-mail para contato, em seguida clique em Fazer upload do instantâneo.
    
    ![Janela Fazer upload para o caso de suporte técnico com campos para fornecer detalhes sobre um instantâneo do arquivo de registro a ser enviado ao Suporte técnico do Tableau.](/tableau/current/pt-br/server/pt-br/Img/tsm-maint-snapshot-upload.png)

Para métodos adicionais de envio de arquivos de registro ao suporte do Tableau, consulte [Envio de arquivos grandes para o Tableau](https://help.salesforce.com/s/articleView?id=001537676&type=1) na Ajuda do Salesforce.

Crie um arquivo de instantâneo dos arquivos de log do Tableau Server usando o comando [`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs).

Por padrão, esse comando cria um arquivo zip contendo todos os arquivos de log. Se a sua instalação do Tableau Server é distribuída, execute essa etapa a partir do nó primário. Os logs de todos os nós serão incluídos no arquivo zip.

Para criar um instantâneo do arquivo de log:

1. No nó inicial, abra um prompt de comando como um administrador.
2. Digite o seguinte comando:
    
    `tsm maintenance ziplogs -l -f <filename>`
    
    em que `<filename>` é o nome do arquivo zipado que você deseja criar. Escolha um nome exclusivo sem espaços. Se já existir um ziplog com o mesmo nome de arquivo, a criação falhará, a não ser que você inclua a opção `-o` para forçar uma substituição, excluir o arquivo existente ou especificar um nome diferente no comando.
    
    É possível especificar um intervalo de tempo para o instantâneo e especificar quais tipos de log serão incluídos. Por exemplo, se você sabe quando ocorreu um erro, use as opções `--startdate` e `--enddate` para capturar logs de algumas horas antes e depois do erro:
    
    `tsm maintenance ziplogs -f <filename> --startdate "<mm/dd/yyyy H:mm>" --enddate "<mm/dd/yyyy H:mm>"`
    
    Para obter mais informações, consulte [tsm maintenance ziplogs](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs).
    
    O instantâneo é salvo no computador em um local fixo onde o TSM e o Tableau Server estão instalados. Se você tiver uma instalação com vários nós, o instantâneo será salvo no nó inicial do cluster. A localização é especificada pela variável `basefilepath_log_archives`.
    
    Por padrão, o instantâneo do arquivo de log é salvo em:
    
    `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives`
    
    É possível encontrar a localização atual consultando a configuração `basefilepath.log_archives` :
    
    tsm configuration get -k basefilepath.log\_archive
    
    e alterar a localização especificando um novo valor para `basefilepath.log_archive`:
    
    tsm configuration set -k basefilepath.log\_archive -v "<drive>:\\new\\directory\\path"
    
    Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

### Enviar arquivos de registro para o Suporte do Tableau

É possível enviar arquivos de log para o Suporte do Tableau como parte de um caso do suporte ao cliente (é necessário um número de caso de suporte). Antes de enviar um arquivo de log, use o comando `tsm maintenance ziplogs` para unir os arquivos de log a um único arquivo zip.

- no prompt de comando, digite o seguinte comando:
    
    `[tsm maintenance send-logs](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmSendLogs) -f <zip file name> -c <case number> -e <email address>`
    
    em que`<case number>` é o numero do caso de suporte, `<email address>` é o e-mail de contato para esse caso de suporte e `<zip file name>` é o nome do arquivo com a extensão .zip.

Para métodos adicionais de envio de arquivos de registro ao suporte do Tableau, consulte [Envio de arquivos grandes para o Tableau](https://help.salesforce.com/s/articleView?id=001537676&type=1) na Ajuda do Salesforce.

<!-- document id=720e541b1a6d982e30c2e9379f16398fe2c254b2edd16e6d2778415f128c4244 url=/tableau/current/pt-br/server/slack_admin.md -->

[Pular para o conteúdo principal](#main-content)

# Integrar o Tableau com a área de trabalho do Slack

A partir da versão 2021.3, o Tableau Server e o Tableau Cloud oferecem suporte à integração com o aplicativo Tableau para Slack, para que sua equipe possa colaborar - compartilhar instantâneos do Tableau, pesquisar conteúdo do Tableau e receber notificações sobre os dados do Tableau exatamente onde estão trabalhando em uma área de trabalho do Slack.

O aplicativo Tableau para Slack permite que você conecte seu site Tableau a um espaço de trabalho Slack. Depois de habilitado, os usuários do Tableau podem:

- Ver notificações no Slack quando colegas de equipe compartilham conteúdo com eles, quando são mencionados em um comentário ou quando os dados atingem um limite especificado em um alerta baseado em dados. Se um administrador de site no Tableau Cloud ou um administrador de servidor no Tableau Server habilitar notificações em um site, os usuários podem controlar quais notificações eles recebem no Slack definindo as [Configurações de conta](https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm) .
- Veja uma visualização de uma visualização quando um URL do Tableau é colado no Slack, permitindo que os usuários compartilhem conteúdo relacionado a dados com contexto diretamente no Slack.
- Pesquise exibições ou pastas de trabalho do Tableau em DMs e canais do Slack.
- Acesse Recentes e Favoritos no aplicativo Tableau para Slack.

Para obter mais informações, consulte [Receber notificações, pesquisar e compartilhar usando o aplicativo Tableau para Slack](https://help.tableau.com/current/pro/desktop/pt-br/slack_tableau.htm).

**Observação:** algumas preferências de notificação podem não estar disponíveis se os recursos estiverem desativados para seu site. Por exemplo, se a configuração Visibilidade do usuário estiver definida como Limitada, as notificações serão desativadas. Para obter mais informações, consulte [Referência de configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm) e [Gerenciar Visibilidade do usuário do site](https://help.tableau.com/current/server/pt-br/user_visibility.htm#user).

Para integrar o Slack ao site do Tableau, existem poucas etapas de configuração necessárias, incluindo algumas no site do Tableau, e algumas na área de trabalho do Slack ao qual você deseja se conectar. Esta visão geral descreve essas etapas para administradores de site do Tableau no Tableau Cloud ou um Administrador do Tableau Server no Tableau Server e administradores da área de trabalho do Slack.

**Requisitos**

Habilitar o Tableau no Slack requer um administrador de espaço de trabalho do Slack e um administrador de site do Tableau no Tableau Cloud ou um administrador do Tableau Server no Tableau Server.

## Conectar um site do Tableau Server à área de trabalho do Slack

Um administrador do Tableau Server pode conectar uma área de trabalho do Slack a um site do Tableau Server. Conectar seu site do Tableau a uma área de trabalho do Slack consiste em três tarefas:

- **Administrador da área de trabalho do Slack**: crie um aplicativo privado do Slack na plataforma de API do Slack
- **Administrador do servidor do Tableau**: use as informações do aplicativo para adicionar um cliente OAuth
- **Administrador do servidor do Tableau**: conecte seu site do Tableau ao Slack.

Cada site do Tableau pode se conectar a uma área de trabalho do Slack por site do Tableau. Para obter informações sobre como criar aplicativos Slack, consulte as [Práticas recomendadas e as diretrizes do Slack para a plataforma Slack](https://api.slack.com/start) .

**Observação**: se estiver usando um servidor proxy, certifique-se de seguir as orientações de configurações de proxy em [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm) antes de começar.

Além disso, para **Windows**:

- Certifique-se de que as variáveis de ambiente do Windows já tenham `http_proxy` e`https_proxy` especificados. Para obter mais informações e instruções sobre como especificar variáveis​de ambiente, consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).
- Adicione os domínios do Slack [nesta lista](https://slack.com/help/urls) à lista de permissões. Para obter mais informações, consulte [Como se comunicar com a Internet](https://help.tableau.com/current/server/pt-br/plan_network.htm).

### Etapa 1: criar um Aplicativo Tableau para Slack

**Administrador da área de trabalho do Slack:**

1. Acesse a [documentação da API](https://api.slack.com/apps) do Slack e selecione Criar novo aplicativo
2. Selecione **Do zero**, em seguida, adicione um nome de aplicativo e a área de trabalho para o aplicativo existir. Selecione Criar novo aplicativo.
3. Dê um nome ao seu aplicativo e selecione uma área de trabalho do Slack.
4. Você será levado às configurações de informações básicas do aplicativo. A partir daqui, você pode modificar os privilégios do aplicativo, a descrição e muito mais.
5. Selecione **Bots** na seção Adicionar recursos e funcionalidade e, em seguida, selecione **Revisar escopos para adicionar**.
6. Em Escopos de token de bot, adicione estes escopos:
    - `chat:write`
    - `files:read`
    - `files:write`
    - `users:read`
    - `users:read.email`
7. Selecione OAuth e permissões no menu de navegação.
    
    > [!IMPORTANT]
    > 
    > Importante: Ativar a rotação de token para seu aplicativo Tableau para Slack fará com que as notificações parem de funcionar no Slack. A rotação de token não pode ser removida após ser adicionada.
8. Selecione Adicionar nova URL de redirecionamento.
9. Adicione uma URL totalmente qualificada`https://<Tableau Server URL>/auth/add_oauth_token`
10. Selecione **Informações básicas** no menu de navegação.
11. Forneça a ID do cliente, o segredo do cliente e a URL de redirecionamento ao administrador do servidor do Tableau.
12. Adicione o aplicativo Tableau para Slack ao espaço de trabalho do Slack selecionando Informações básicas no menu Configurações e, em seguida, **Instalar**.

**Observação**: os administradores podem compartilhar seus aplicativos com outros espaços de trabalho do Slack ativando uma opção de distribuição. Para obter mais informações, consulte [Gerenciar distribuição](https://app.slack.com/app-settings/T7KUQ9FLZ/A028CVA4MK9/distribute) na documentação do Slack.

### Etapa 2: adicionar um cliente OAuth ao site do Tableau

**Administrador do Tableau Server:**

O administrador do servidor do Tableau adicionará o cliente OAuth do administrador do espaço de trabalho do Slack e, em seguida, conectará o site do Tableau ao Slack.

1. Faça login no site que deseja conectar ao Slack. Na página Configurações do seu site, selecione a guia **Integrações.**
    
    ![Guia Integrações nas configurações do site do Tableau](/tableau/current/pt-br/server/pt-br/Img/slack_settings.png)
2. Em Conectividade do Slack, selecione Adicionar cliente OAuth.
3. Adicione a ID do cliente, o segredo do cliente e a URL de redirecionamento do administrador da área de trabalho do Slack e selecione Adicionar cliente OAuth na caixa de diálogo.
4. O tipo de conexão e a ID do cliente serão exibidos na tabela.

### Etapa 3: finalizar a conexão

**Administrador do Tableau Server:**

Quando o cliente OAuth é adicionado à Conectividade Slack:

1. Selecione **Conectar ao Slack**.
2. Siga o prompt para entrar na sua área de trabalho do Slack.
3. Selecione **Permitir** para dar ao seu site do Tableau acesso à área de trabalho do Slack.

O site do Tableau e a área de trabalho do Slack agora estão conectados. Na área de trabalho do Slack, os usuários licenciados do Tableau podem receber notificações do Slack quando alguém compartilha o conteúdo do Tableau, quando um alerta baseado em dados é disparado ou quando alguém é @mencionado em um comentário em uma exibição ou pasta de trabalho.

## Desconectar um site do Tableau do Slack

Como administrador do site, você pode desconectar um site do Tableau de uma área de trabalho do Slack selecionando **Desconectar do Slack** na guia **Integrações** das configurações do site. Os usuários continuarão a receber notificações por algum tempo. As informações do cliente OAuth que você adicionou na Etapa 2 são retidas e podem ser usadas para se conectar a um novo espaço de trabalho, se necessário.

Como usuário do Slack, você pode se desconectar dele selecionando **Desconectar do Tableau** na **Página inicial** guia no aplicativo Tableau para Slack.

## Atualizar o aplicativo Tableau para Slack

Quando uma nova versão do aplicativo Tableau para Slack estiver disponível, a Tableau recomenda atualizar o aplicativo para manter o desempenho do aplicativo e usar novos recursos.

Para atualizar o aplicativo Tableau para Slack:

1. Na página **Configurações** do seu site, selecione a guia **Integrações**.  
    ![Guia Integrações nas configurações do site do Tableau](/tableau/current/pt-br/server/pt-br/Img/slack_settings.png)
2. Em **Conectividade do Slack**, selecione **Conectar ao Slack**.
3. Selecione **Atualizar**.

**Observação:** as atualizações de aplicativos aplicadas por qualquer administrador do Tableau afetam todos os sites do Tableau conectados ao mesmo espaço de trabalho.

## Solução de problemas o aplicativo Tableau para Slack

É uma prática recomendada [Gerenciar aprovações de aplicativos para seu espaço de trabalho do Slack](https://slack.com/help/articles/222386767-Manage-app-approval-for-your-workspace). No entanto, se seu espaço de trabalho do Slack permitir que usuários que não são administradores removam aplicativos, é possível que um usuário possa remover o aplicativo Tableau para Slack do site. Nesse cenário, outros usuários verão o aplicativo Tableau para Slack, mas seus recursos não funcionarão como esperado. Para resolver esse problema, peça ao administrador do Slack para desinstalar e reinstalar o aplicativo Tableau para Slack. Em seguida, peça ao seu administrador que siga as etapas para conectar o Slack ao seu site do Tableau.

Se a visualização do link do Tableau não aparecer no Slack, confirme se o token **files:read** permite **Bots** no aplicativo do Tableau em [Escopos de permissões do Slack](https://api.slack.com/scopes).

<!-- document id=e0a71d90f19893e5d7c9e9bac186a525b3ca737554a089647dd5a756e6864566 url=/tableau/current/pt-br/server/Viewer.md -->

[Pular para o conteúdo principal](#main-content)

# Interagir com dados no Tableau

Este tutorial orienta você em alguns dos princípios básicos de exibição e interação com visualizações de dados, ou exibições, no Tableau Server.

O Tableau é uma ferramenta que permite interagir com visualizações publicadas para explorar insights, fazer perguntas e ficar em dia com seus dados. Veja como iniciar.

## Vá em frente. É seguro clicar ao redor

O Tableau foi desenvolvido para interação. O que você faz com uma visualização muda a aparência dela para você, por enquanto.

Outros ainda verão a visualização como ela apareceu originalmente. E os dados usados para criá-la também permanecem os mesmos.

## 1: O que é um site do Tableau?

Um site do Tableau é um lugar para sua equipe compartilhar dados e visualizações de dados entre si. Você pode explorar o que eles publicaram e disponibilizaram.

Ao entrar no site do Tableau, você acessa a página inicial.

![Página de login do visualizador no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Viewer_sign_in.gif)

## 2: Procure uma visualização

O Tableau chama visualizações em um site de Exibições. Use a pesquisa para localizar exibições ou pastas de trabalho (um pacote de exibições em um único arquivo).

Os resultados da pesquisa mostrarão todos os diferentes tipos de conteúdo relevantes para a sua consulta.

![Um visualizador pode pesquisar exibições e pastas de trabalho no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Viewer_search.gif)

Você pode selecionar Ver tudo para todos os resultados da pesquisa se as exibições na pesquisa rápida não forem o que você estava procurando, ou usar a página Explorar para navegar. Lá você verá todos os diferentes tipos de conteúdo que um site do Tableau pode hospedar.

## 3: Interaja com o conteúdo

Uma exibição publicada é uma tela para você interagir e entender seus dados. Lembre-se de que você não vai prejudicar ou alterar os dados subjacentes, nem alterar o que os outros veem.

Aqui estão algumas das ferramentas em sua caixa de ferramentas para encontrar insights de dados.

### Ver detalhes e classificar dados

Agora que você sabe que pode clicar nos dados, vamos dar uma olhada.

Ao mover o mouse pela exibição, você pode ver dicas de ferramenta que revela os detalhes sobre cada ponto de dados ou marca. Também é possível selecionar várias marcas.

![Um visualizador passando o mouse sobre marcas em uma visualização publicada.](/tableau/current/pt-br/server/pt-br/Img/Viewer_details.gif)

Classifique as tabelas em ordem alfabética ou numérica passando o mouse sobre o cabeçalho de uma coluna e clicando no ícone de classificação.

![Um visualizador pode classificar dados no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/viewer_sort.gif)

### Filtrar dados

Corte ou limite os dados visíveis a uma área, data ou categoria específica.

![Um visualizador pode filtrar os dados no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Viewer_filter.gif)

### Desfazer/Reverter

Talvez você não quisesse excluir tudo, exceto uma área. Clique em Desfazer para remover a última alteração ou use Reverter para desfazer todas as suas seleções.

![Botão Desfazer no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Viewer_undo.gif)

## 4: Continue

Essa exibição pode ser atualizada automaticamente com novos dados, então você não precisa procurar novos gráficos para obter as informações mais recentes. Mantenha-a acessível clicando no ícone de estrela para adicioná-la aos seus favoritos.

![Marca como favorita uma exibição no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Viewer_favorites.gif)

Todos os favoritos são adicionados à página Favoritos no painel de navegação. E qualquer painel ou visualização recente que você explorou também aparece na página inicial, esperando por você na próxima vez.

![Acesse as pastas de trabalho favoritas na guia Início do Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Viewer_favoriteshome.gif)

Há muito que você pode fazer no Tableau Server, e foi explorado apenas alguns dos princípios básicos. Para obter mais informações, consulte O que posso fazer com uma exibição da Web do Tableau?

Boa exploração!

<!-- document id=fa05e5735a3bae41e0dfe9ddbfeb7fa2bbc30734d7c6019b6b0982ea58958572 url=/tableau/current/pt-br/server/rmt-config-configGui.md -->

[Pular para o conteúdo principal](#main-content)

# Configuração do servidor do Resource Monitoring Tool

Este tópico descreve as opções de configuração do Servidor do Resource Monitoring Tool (Servidor RMT) que você pode usar com a interface da Web.

## Configurações de pós-instalação

Você pode atualizar as configurações especificadas durante a instalação.

A seguir estão as duas maneiras recomendadas de fazer alterações de configuração:

- **Para fazer isso usando a interface da Web:** na máquina onde o Servidor RMT está instalado, acesse: _http://<hostname>/setup/server_.
- **Para fazer isso usando a linha de comando**, use o comando `rmtadmin master-setup` com a opção `--skip-admin-creation`para garantir que você não seja solicitado a criar o usuário administrativo após a instalação. Para obter mais informações, consulte [rmtadmin master-setup](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm#rmtadmin_master_setup).

**Observação:** os valores de configuração são salvos no [arquivo de configuração](https://help.tableau.com/current/server/pt-br/rmt-config-configFile.htm). As alterações podem ser feitas diretamente neste arquivo, mas é aconselhável aproveitar as opções de configuração na interface do usuário e através do utilitário de linha de comando `rmtadmin`. As alterações no arquivo config exigirão uma reinicialização para ser aplicada.

Aqui estão alguns exemplos do tipo de atualizações que você pode querer fazer após a configuração inicial.

- Alterando a configuração do SSL: a configuração padrão é definida como falsa. Você pode alterar esta configuração para exigir HTTPS. Use o comando [rmtadmin master-setup](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm#rmtadmin_master_setup) para atualizar esta configuração.
- Atualizações de certificado ssl: você pode ter concluído sua configuração inicial do Servidor RMT usando o modo de certificação padrão para comunicações seguras e deseja atualizar a certificação com seu próprio certificado.
- Alteração de portas: às vezes, você precisará usar números de porta diferentes do padrão com base nos requisitos de sua rede. Para saber mais sobre portas e comunicações entre os diversos componentes de Resource Monitoring Tool, consulte [Portas de comunicação do Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-ports-comms.htm).
- Expiração da sessão de atualização: se o usuário não acessar a sessão pelo período limite definido, a sessão expirará e será necessário fazer login novamente. Por padrão, ele é definido como 240 minutos. Você também pode ativar a opção **Expiração deslizante** para redefinir o período limite quando uma sessão é acessada nele.

**Observação:** adição ou remoção de um nó do Tableau Server: se você adicionar um novo nó ao cluster do Tableau Server que você está monitorando com Resource Monitoring Tool, precisará instalar e registrar este nó. Para obter mais informações, consulte [Alterações de topologia do Tableau Server](https://help.tableau.com/current/server/pt-br/rmt-tableau-server-topology-changes.htm).

Para fazer isso através da linha de comando, use o comando `rmtadmin-master-setup` . Para obter mais informações, consulte [Utilitário de linha de comando rmtadmin](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm).

Você pode configurar o Resource Monitoring Tool clicando em “Configuração” no menu Admin. As seções de configuração são divididas por guias. Para fazer isso usando um arquivo de configuração, consulte [Arquivo de configuração do RMT Server](https://help.tableau.com/current/server/pt-br/rmt-config-configFile.htm).

![O menu de configuração para exibições e consultas lentas.](/tableau/current/pt-br/server/pt-br/Img/rmt-threshold.png)

## Notificações

As notificações podem ser definidas em nível global e de ambiente.

Você pode escolher como deseja receber suas notificações - por e-mail ou Slack, ou por e-mail e Slack.

**O seguinte se aplica a notificações por e-mail e Slack:**

As notificações por e-mail e Slack podem ser definidas em nível global e em nível de ambiente. Para enviar qualquer notificação, as configurações globais devem ser habilitadas, não apenas no nível do ambiente. Você também pode configurar diferentes níveis mínimos de gravidade para enviar notificações – eles podem ser diferentes para e-mail e folga, também podem ser diferentes nos níveis global e de ambiente.

As configurações globais são aplicadas a ambientes existentes ou a quaisquer novos ambientes criados, a menos que estejam usando limites personalizados.

### Configurações de notificação do Slack

As notificações do Slack foram introduzidas no Resource Monitoring Tool versão 2022.1.

**Antes** de configurar as notificações do Slack no Resource Monitoring Tool, há algumas configurações iniciais que você precisa fazer no Slack. Os detalhes completos estão descritos [neste artigo do Slack](https://api.slack.com/messaging/webhooks), mas aqui estão o que você precisará fazer:

1. Crie um novo ou use um workspace ou aplicativo Slack existente e verifique se ele está habilitado para receber webhooks de entrada.
2. Autorize um canal onde as notificações devem ser publicadas.
3. Copie a URL do Webhook que é gerada para seu workspace.

Para configurar a notificação do Slack no Resource Monitoring Tool:

1. No menu Admin, selecione Configuração global.
2. Na guia Notificações, na seção Slack, use o botão de alternância na parte superior da seção para ativar as notificações do Slack.
3. Defina as seguintes configurações:
    
    1. Gravidade mínima: o nível mínimo de gravidade em que você deseja receber notificações do Slack.
    2. URL do webhook: URL dos webhooks de entrada para seu workspace Slack. Essa URL é gerada automaticamente quando você ativa webhooks de entrada para seu workspace Slack.
4. Teste-o usando o botão Enviar uma mensagem de teste para garantir que suas configurações sejam válidas e funcionem.

Para especificar as notificações para cada ambiente:

1. No menu Admin, selecione o ambiente que deseja modificar e escolha Editar ambiente.
2. Na guia Notificações, escolha Personalizar como o tipo de configuração para substituir as configurações globais.
3. Defina a gravidade mínima e a URL do Webhook.
4. Teste-o usando o botão Enviar uma mensagem de teste para garantir que suas configurações sejam válidas e funcionem.

### Notificações por e-mail

Para configurar a notificação por e-mail, comece configurando as configurações do servidor SMTP em nível global. As configurações do servidor SMTP configuradas em nível global são aplicadas automaticamente a todos os ambientes. Você pode personalizar determinadas configurações, como o nível mínimo de gravidade e os e-mails do remetente e do destinatário para cada ambiente.

Aqui estão alguns detalhes técnicos sobre como a configuração do TLS funciona:

- O RMT Server usa a opção SMTP STARTTLS, que atualiza a conexão SMTP para TLS depois que ela é iniciada, mas antes que o conteúdo do email seja enviado. O RMT não oferece suporte à opção SMTP REQUIRETLS.
- O RMT Server usa STARTTLS para criptografar emails em trânsito para o servidor SMTP. O fato de o servidor SMTP armazenar ou não o correio criptografado em repouso está sujeito à configuração do servidor SMTP.

Antes de configurar notificações por e-mail no Resource Monitoring Tool, você deve ter um servidor SMTP configurado e ter as seguintes informações:

- **Nome** do servidor SMTP.
- Se você planeja usar comunicações criptografadas, anote a **versão TLS** que o servidor SMTP aceita. Atualmente, **o TLS 1.2 é exigido** por **Resource Monitoring Tool e com suporta ao TLS 1.3**.
- A **impressão digital do certificado** (opcional).
- **Número da porta** para o servidor de SMTP.
- **Nome de usuário e senha** (opcional). Necessário apenas se o servidor SMTP estiver configurado para autenticar usando um nome de usuário e senha.
- Endereços de **e-mail do remetente e do destinatário** que serão usados para enviar e receber notificações.

**Para especificar as configurações do servidor SMTP no** Resource Monitoring Tool**:**

1. No menu Admin, selecione **Configuração global**.
2. Na guia **Notificações**, na seção **E-mail**, selecione o botão de alternância na parte superior das seções para ativar as notificações por e-mail.
    
    1. Defina as seguintes configurações do servidor SMTP:
        
        1. **Servidor:** forneça o nome DNS totalmente qualificado do servidor SMTP.
        2. **Criptografia:** especifique se deseja que as comunicações entre o Servidor RMT e o servidor SMTP sejam criptografadas. A opção escolhida dependerá da configuração do servidor SMTP para criptografia e de sua preferência de uso de comunicações criptografadas entre o servidor RTM e o servidor SMTP.
            
            1. **Obrigatório:** use isso quando seu servidor SMTP estiver habilitado para usar comunicações criptografadas e você quiser garantir que as comunicações sejam sempre criptografadas. Quando definido como obrigatório, a conexão sempre será tentada usando criptografia. Se o servidor SMTP não estiver habilitado para usar criptografia, o servidor RMT não poderá se comunicar com o servidor SMTP.
            2. **Preferencial:** use isso se você não tiver certeza sobre as configurações de criptografia do seu servidor SMTP, mas preferir que as comunicações criptografadas sejam usadas quando possível. Se o servidor SMTP não estiver habilitado para usar criptografia, nesse caso, a comunicação não criptografada será usada.
            3. **Desativado:** use se o SMTP não estiver habilitado para usar comunicações criptografadas. As comunicações entre o servidor RMT e o servidor SMTP não são criptografadas.
                
                **Observação:** se o servidor SMTP exigir criptografia, a conexão falhará. Se o servidor SMTP estiver habilitado para criptografia, mas não a exigir, a conexão será bem-sucedida.
            4. **Opções:** isso determina como o servidor SMTP será verificado. Você tem as seguintes opções:
                
                1. Verificar identidade do servidor: o RMT verificará se o nome do certificado usado corresponde ao nome do servidor SMTP. Se não houver correspondência, a conexão falhará.
                2. Confiar em todos os hosts: todos os erros de certificado são ignorados e substituem a identidade do servidor de verificação. Isso deve ser usado somente se você tiver certeza de que o certificado que o servidor RMT está usando é do seu servidor.
            5. **Versão do TLS:** a versão do TLS suportada pelo seu servidor SMTP. Já existe uma versão padrão selecionada, mas você pode selecionar outras versões. Se várias versões de TLS forem selecionadas, o servidor RMT usará a versão mais segura compatível com o RMT e o servidor SMTP. O TLS versão 1.3 requer Open SSL 1.1.1f. Se você planeja usar o TLS 1.3, certifique-se de que a máquina em que o RMT Server está instalado tenha Open SSL 1.1.1f.
            6. **Impressão digital do certificado**: isso é opcional. O certificado SHA1 é usado quando fornecido e deve ser válido e usado pelo servidor SMTP. Uma impressão digital válida substituirá outros erros de certificado, como datas de expiração e incompatibilidades de nomes de servidor.
            7. **Porta**: configurações de porta do servidor de e-mail.
            8. **Nome de usuário:** opcional. O nome da conta usada para autenticar no servidor de e-mail, se o servidor SMTP estiver configurado com um nome de usuário e senha para autenticação.
            9. **Senha:** opcional. A senha da conta usada para autenticação no servidor de e-mail, se o servidor SMTP estiver configurado com nome de usuário e senha para autenticação.
            10. **Gravidade mínima**: o nível mínimo de gravidade no qual você deseja receber notificações por e-mail. Isso será aplicado a todos os ambientes, a menos que modificado no nível do ambiente.
            11. **E-mail do remetente**: o endereço de e-mail usado para enviar as notificações. Isso será aplicado a todos os ambientes, a menos que modificado no nível do ambiente.
            12. **E-mail(s) do destinatário**: endereços de e-mail das pessoas que devem receber essas notificações. Isso será aplicado a todos os ambientes, a menos que modificado no nível do ambiente.
            13. **Teste** usando o botão Enviar uma mensagem de teste para garantir que suas configurações sejam válidas e possam ser usadas para enviar uma notificação por e-mail com êxito.

Para personalizar as configurações de um ambiente:

1. No menu **Admin**, selecione o ambiente que deseja modificar e escolha **Editar ambiente**.
2. Na guia **Notificações**, escolha **Personalizar** como o tipo de configuração para substituir as configurações globais.
3. Defina o nível de gravidade, o remetente e as informações de e-mail do destinatário.
4. Teste usando o botão Enviar uma mensagem de teste para garantir que suas configurações sejam válidas e você possa enviar uma notificação por e-mail.

#### Solucionar falhas de conexão

As **falhas de conexão** podem ocorrer devido a vários motivos, mas aqui estão algumas que podem ser causadas devido a problemas de configuração:

- **Erros de configuração de criptografia:** acontece se houver uma incompatibilidade de configurações de criptografia entre o servidor RMT e o servidor SMTP. Por exemplo, se o servidor RMT estiver configurado para exigir criptografia, mas o servidor SMTP não estiver configurado para usar criptografia. O contrário também é verdade. Se o servidor SMTP exigir comunicação criptografada e o Servidor RMT estiver definido para desabilitar a criptografia, a conexão falhará.
- **Erros de certificado:** ao usar comunicações criptografadas, certos recursos, como autoridade de certificação e correspondência entre o nome do certificado e o servidor SMTP são considerados, a menos que você escolha explicitamente **Confiar em todos os hosts** em **Opções**.
- **Erros de TLS:** o suporte à versão de TLS depende do sistema operacional (SO) no qual o servidor RMT está instalado. Verifique se a versão do TLS que você selecionou é compatível com o sistema operacional. O TLS 1.2 é necessário, mas o TSL 1.3 também é compatível. O TLS 1.3 requer Open SSL 1.1.1f ou superior. Certifique-se de ter Open SSL 1.1.1f na máquina onde o RMT Server está instalado.

## Limites de incidentes

Defina as configurações globais de notificação de incidente. Esses limites globais se aplicam a todos os ambientes por padrão, a menos que substituídos pelos ambientes individuais.

Consulte [Incidentes](https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm) para obter informações sobre quais opções incidentes estão disponíveis e como configurá-las.

## Segurança

Defina as configurações de segurança para as contas de usuário do Resource Monitoring Tool.

## Dados

Por padrão, o Resource Monitoring Tool armazena duas semanas de atividades detalhadas e dez anos de dados agregados de relatórios.

**Retenção de dados:** os dados detalhados da atividade do seu Tableau Server alimentam os painéis e incidentes para diagnóstico de incidentes de desempenho recentes. Devido aos requisitos associados de armazenamento e processamento, esses dados só são armazenados por duas semanas, como padrão.

**Dados de relatórios:** dados de atividade agregados do seu Tableau Server são armazenados para fins de relatório (por exemplo, o relatório [Chargeback](https://help.tableau.com/current/server/pt-br/rmt-admin-chargeback.htm) ). Esses dados são compactos e podem ser armazenados facilmente por muitos anos de relatórios históricos.

## Avançado

Permite a configuração dos níveis de registro do Resource Monitoring Tool de diagnóstico.

Consulte os [arquivos de registro](https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm) para obter mais informações sobre a geração de registros.

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=07a789c7df9526f65aa54516632fecab9f3437e9b634f683f82aae995083f43d url=/tableau/current/pt-br/server/perf_record_interpret_server.md -->

[Pular para o conteúdo principal](#main-content)

# Interpretar um registro de desempenho

Crie uma gravação para avaliar o desempenho da sua pasta de trabalho. Depois de concluir a gravação, você pode baixar a pasta de trabalho resultante e abri-la no Tableau Desktop para análise.

Uma pasta de trabalho de registro de desempenho contém dois painéis principais: Resumo de desempenho e Exibições detalhadas. O painel resumo de desempenho fornece uma visão geral de alto nível dos eventos mais demorados. O painel Exibições detalhadas fornece muito mais detalhes e é destinado a ser usado por usuários avançados na criação de pasta de trabalho. O painel **Exibições detalhadas** só é visível quando a pasta de trabalho de registro de desempenho é aberta usando o Tableau Desktop.

Para obter informações sobre como criar um registro de desempenho no Tableau Server, consulte [Criar um registro de desempenho](https://help.tableau.com/current/server/pt-br/perf_record_create_server.htm).

## Resumo de desempenho

O painel **Resumo de desempenho** contém três exibições: **Linha do tempo**, **Eventos** e **Consulta**.

### Linha do tempo

A exibição na parte superior de um painel de registro de resumo de desempenho mostra os eventos que ocorreram durante o registro, organizados cronologicamente da esquerda para a direita. O eixo inferior mostra o tempo decorrido desde que o Tableau foi iniciado, em segundos.

Na exibição Linha do tempo, as colunas **Pasta de trabalho**, **Painel** e **Planilha** identificam o contexto dos eventos. A coluna **Evento** identifica a natureza do evento, e a coluna final mostra a duração de cada evento e como ele se compara cronologicamente a outros eventos registrados:

![Cronograma de desempenho da pasta de trabalho, mostrando eventos durante a gravação do cronograma.](/tableau/current/pt-br/server/pt-br/Img/PerformanceTimeline.png)

### Eventos

A exibição intermediária em um painel de resumo de desempenho mostra os eventos, classificados por duração (da maior para a menor). Eventos com durações mais longas podem ajudar a identificar onde procurar primeiro, caso você queira acelerar sua pasta de trabalho.

![Um gráfico de barras horizontais exibindo a duração de vários eventos, organizados por tempo, com o evento mais longo posicionado no topo.](/tableau/current/pt-br/server/pt-br/Img/PerformanceEvents.png)

Cores diferentes indicam tipos de eventos diferentes. A variedade de eventos que podem ser registrados é:

- Cálculo de layouts
    
    Se os layouts estiverem muito demorados, considere simplificar sua pasta de trabalho.
- Conexão com uma fonte de dados
    
    As conexões lentas podem ser devido a problemas de rede ou do servidor de banco de dados.
- Compilação de consulta
    
    Este evento capta a quantidade de tempo gasto pela Tableau na geração das consultas. Longos tempos de consulta de compilação indicam que as consultas geradas são complexas. A complexidade pode ser devido a muitos filtros, cálculos complexos ou geralmente a uma complicada agenda de trabalho. Exemplos de cálculos complexos incluem, cálculos longos, cálculos LOD ou cálculos aninhados. Tente simplificar a pasta de trabalho, usando filtros de ação ou movendo cálculos para o banco de dados subjacente.
- Execução de consulta
    
    - Para conexões dinâmicas, se as consultas estiverem demorando muito, pode ser que a estrutura de dados subjacente não esteja otimizada para o Tableau. Consulte a documentação do servidor de banco de dados. Como alternativa, considere usar uma extração para acelerar o desempenho.
    - Para extrações, se as consultas estiverem demorando muito, reveja seu uso de filtros. Se você tiver muitos filtros, será que um filtro de contexto faria mais sentido? Se você tiver um painel que usa filtros, considere usar filtros de ação, o que pode ajudar com o desempenho.
- Geração da extração
    
    Para acelerar a geração de extração, considere importar apenas alguns dados da fonte de dados original. Por exemplo, você pode filtrar por campos de dados específicos, ou criar uma amostra baseada em um número específico de linhas ou uma porcentagem dos dados.
- Codificação geográfica
    
    Para acelerar o desempenho da codificação geográfica, experimente usar menos dados ou filtrar os dados.
- Combinação de dados
    
    Para acelerar a combinação de dados, experimente usar menos dados ou filtrar os dados.
- Renderização do servidor
    
    Você pode acelerar a renderização do servidor executando processos adicionais do VizQL Server em outros computadores.

### Consulta

**Observação**: a partir do Tableau Desktop versão 2024.2.x, as gravações de desempenho de uma pasta de trabalho conectada a uma fonte de dados publicada no Tableau Cloud não incluem o evento `Executing query`. Isso é substituído por `executeQueries` e é por design.

Se você clicar em um evento **Executando consulta** na seção **Linha do tempo** ou **Eventos** de um painel de resumo de desempenho, o texto dessa consulta será exibido na seção Consulta.

Se estiver conectado a uma fonte de dados publicada, o texto de consulta é exibido em XML. Se estiver conectado diretamente à fonte de dados, a consulta é exibida em SQL, como mostrado abaixo:

![Consulta SQL para selecionar dados de estado.](/tableau/current/pt-br/server/pt-br/Img/PerformanceQuery.png)

Caso faça sentido, é possível usar o texto da consulta para trabalhar com a equipe do seu banco de dados para otimizar no nível do banco de dados. Às vezes, a consulta será truncada e você precisará consultar o registro do Tableau para encontrar a consulta completa. A maioria dos servidores de banco de dados podem aconselhar você sobre como otimizar uma consulta adicionando índices ou outras técnicas. Consulte a documentação do servidor de banco de dados para obter detalhes.

Às vezes para obter eficiência, a Tableau combina múltiplas consultas em uma única consulta em relação aos dados. Neste caso, você pode ver um evento de Consulta executora para a planilha Null e zero consultas sendo executadas para suas planilhas nomeadas.

## Linha do tempo detalhada

Esta exibição é a versão detalhada da exibição de **linha do tempo** que mostra todos os eventos e separa itens individuais que foram agrupados na exibição **Linha do tempo**. Destina-se a ser usado por usuários avançados durante os projetos de pasta de trabalho.

## Exibições detalhadas

O painel **Exibições detalhadas** contém exibições de **Profundidade**, **CPU exclusiva**, **CPU inclusiva** e **Tempo decorrido**.

### Profundidade

A exibição **Profundidade** está localizada mais superiormente no painel **Exibições detalhadas** e fornece informações sobre o que acontece quando a solicitação é feita. Essa exibição é a mais útil quando filtrada para uma única solicitação do usuário. Exemplos de solicitações do usuário são: carregar uma exibição, selecionar uma marca ou alterar um filtro.

![Um gráfico exibindo atividades por profundidade e hora de início.](/tableau/current/pt-br/server/pt-br/Img/performance-depth.png)

Cada barra na exibição de profundidade representa uma única atividade. Uma atividade é uma unidade de trabalho que é feita como parte do processamento de uma solicitação do usuário. Uma única solicitação de usuário resulta em múltiplas atividades. O comprimento de cada barra na exibição de profundidade é proporcional ao tempo decorrido para a atividade que a barra representa.

Atividades de alto nível aparecem no topo da exibição. Atividades mais abaixo são atividades secundárias geradas por atividades de alto nível.

Pairar sobre cada barra fornece detalhes adicionais sobre a atividade e também destaca a linha correspondente na **CPU** e na exibição de **Tempo decorrido** descrita na próxima seção.

A fim de reduzir as partes do pedido que levaram mais tempo, investigue atividades de longa duração nos níveis mais altos.

### CPU e Tempo decorrido

As exibições de **CPU** e **Tempo decorrido** aparecem na parte mais inferior do painel **Exibições detalhadas**. Você pode alternar entre as exibições de **CPU exclusiva**, **CPU inclusiva** e **Tempo decorrido** clicando nos botões de rádio.

![Um menu com três opções: CPU exclusiva, CPU inclusiva e Tempo decorrido. Cada opção é acompanhada de uma descrição de seu uso.](/tableau/current/pt-br/server/pt-br/Img/performance-cpu-elaspsedTime.png)

Embora a exibição **Profundidade** possa ajudar na identificação visual rápida de atividades de longa duração, ela pode não necessariamente destacar atividades que acontecem várias vezes, com cada instância demorando um pouco. As exibições **CPU exclusiva**, **CPU inclusiva** e **Tempo decorrido** fornecem estatísticas agregadas para cad atividade. O número de vezes que uma atividade ocorreu é mostrado na coluna **Contagem** e o tempo total gasto por uma única atividade é mostrado usando o gráfico de barras.

Às vezes, para ter mais eficiência, o Tableau combina várias consultas em uma única consulta com os dados. Nesse caso, você pode ver um evento **Executando consulta** para a planilha Nula e zero consultas sendo executadas para as planilhas nomeadas.

<!-- document id=87ab3268f65990549afd482d792c62058003bd28961c38775d3bf78e8d9595ae url=/tableau/current/pt-br/server/maintenance_shutdown.md -->

[Pular para o conteúdo principal](#main-content)

# Interromper e reiniciar o computador do Tableau Server

Como prática recomendada, você deve _sempre_ interromper o Tableau Server antes de interromper ou reiniciar o computador. Isso é válido se estiver executando o Tableau em máquinas virtuais (VMs) ou em um hardware dedicado. Nunca desligue um computador sem interromper o Tableau Server primeiro. Desligar o computador enquanto o Tableau está em execução pode causar problemas ao reiniciar o Tableau Server e gerar em resultados inesperados.

Por segurança, siga estas etapas, se tiver um processo com script para desligar seus sistemas ou desligue manualmente os computadores:

1. Interrompa o Tableau Server.
    
    Você pode fazer isso na linha de comando, usando o comando `[tsm stop](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm)` ou na interface do usuário na Web do TSM, clicando em Tableau Server em execução e selecionando Interromper o Tableau Server.
    
    **Observação:** alguns processos do TSM continuarão a ser executados, mesmo após a interrupção do Tableau Server. Isso é normal; você pode continuar e interromper o computador. Os serviços em execução foram projetados para se desligarem quando o computador for interrompido.
2. Depois que o Tableau for interrompido, interrompa o computador.
3. Quando estiver pronto, reinicie o computador. Isso pode acontecer depois que você concluir a manutenção planejada ou deixar o computador desligado por um período prolongado de tempo de inatividade.
4. Inicie o Tableau Server.
    
    Você pode fazer isso na linha de comando, usando o comando `[tsm start](https://help.tableau.com/current/server/pt-br/cli_start_tsm.htm)` ou na interface do usuário na Web do TSM, clicando em Tableau Server interrompido e selecionando Iniciar o Tableau Server.
    
    O TSM iniciará automaticamente quando o computador for iniciado, então é possível executar comandos do tsm mesmo que o Tableau Server esteja interrompido.

<!-- document id=d3f3ddf60513974dd017229cfffffe9a22e920ce57753129bcf98b2961e7beaa url=/tableau/current/pt-br/server/explain_data_basics.md -->

[Pular para o conteúdo principal](#main-content)

# Introdução a Explique os dados

Use Explique os dados em seu fluxo de análise enquanto explora as marcas em uma visualização. O Explique os dados é executado automaticamente quando o painel Guia de dados é aberto e atualizado com base na seleção atual (painel, planilha ou marca).

<table style="margin-left: 0; margin-right: auto; width: 100%"><colgroup><col style="width: 350px;"><col style="width: 350px;"></colgroup><tbody><tr><td class="table--plain"><p style="font-weight: bold;">Usar Explique os dados</p><ul><li><a href="#RunExD" class="xref">Executar Explique os dados em um painel, planilha ou marca</a></li><li><a href="#Drill" class="xref">Detalhar as explicações</a></li><li><a href="#ViewFields" class="xref">Exibir campos analisados</a></li><li><a href="#TermsToKnow" class="xref">Termos e conceitos nas explicações</a></li><li><a href="https://help.tableau.com/current/server/pt-br/explain_data_explanation_types.htm">Tipos de explicação</a></li></ul></td><td class="table--plain"><p style="font-weight: bold;">Pastas de trabalho do criador e controle de acesso</p><ul><li><a href="https://help.tableau.com/current/server/pt-br/explain_data_requirements.htm" target="_blank">Requisitos e considerações para uso do Explique os dados</a></li><li><a href="https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm" target="_blank">Alterar configurações de Explique os dados (somente criadores)</a></li><li><a href="https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm" class="xref">Controle de acesso a Explique os dados</a></li><li><a href="https://help.tableau.com/current/server/pt-br/explain_data_enable.htm" class="xref">Desabilitar ou habilitar Explique os dados para um site</a></li><li><a href="https://help.tableau.com/current/server/pt-br/explain_data_explained.htm" class="xref">Como funciona o Explique os dados</a></li></ul></td></tr></tbody></table>

## Executar Explique os dados em um painel, planilha ou marca

Estas são as etapas básicas para executar o Explique os dados no Tableau Desktop, Tableau Cloud e Tableau Server:

1. Abra um painel ou planilha em uma pasta de trabalho.
2. Na barra de ferramentas da exibição, selecione Guia de dados ![Ícone Guia de dados](/tableau/current/pt-br/server/pt-br/Img/data_guide_icon.png) para abrir o painel Guia de Dados.
3. Se você abrir um painel, o Explique os dados o analisará em busca de valores discrepantes.  
      
    ![Os valores discrepantes detectados exibidos no Guia de dados para um painel](/tableau/current/pt-br/server/pt-br/Img/explaindata_dg_dashboard.png)  
      
    Se você selecionar uma planilha no painel, o Explique os dados analisa as marcas nessa planilha para valores discrepantes.  
      
    ![Explicação detalhada de Explique os dados para uma planilha selecionada.](/tableau/current/pt-br/server/pt-br/Img/explaindata_dg_sheet.png)  
      
    Se você selecionar uma marca no painel, o Explique os dados analisará especificamente essa marca para explicações.  
      
    ![Explicação detalhada de Explique os dados para uma marca selecionada.](/tableau/current/pt-br/server/pt-br/Img/explaindata_dg_mark.png)  
      
    As marcas que estão sendo explicadas são destacadas na visualização conforme você seleciona as explicações correspondentes.

Como opção, você pode selecionar uma marca em uma visualização e focalizar o cursor na marca. No menu de dica de ferramenta, selecione **Guia de dados** ![Ícone Guia de dados](/tableau/current/pt-br/server/pt-br/Img/data_guide_icon.png).  
  
![Imagem da dica de ferramenta da marca com o ícone Guia de dados selecionado](/tableau/current/pt-br/server/pt-br/Img/explaindata_tooltip_dg2.png)

No Tableau Public, selecione a lâmpada no menu de dica de ferramenta para executar o Explique os dados.  
  
![Clique no ícone da lâmpada em um menu de dica de ferramenta de marca para executar o Explique os dados.](/tableau/current/pt-br/server/pt-br/Img/explaindata_tooltip_button.png)  
  
As explicações possíveis para o valor da marca analisada são exibidas no painel Guia de dados. Selecione nomes de explicação diferentes para expandir os detalhes e começar a explorar.

### Permissões de Explique os dados necessárias para ver as explicações

Se você vir valores discrepantes detectados com uma observação para entrar em contato com o proprietário da visualização, é porque você precisa de permissão para ver esses tipos de explicações. Selecione o nome do proprietário para acessar a página de conteúdo do Tableau com o endereço de e-mail. Entre em contato com o proprietário para pedir que ele conceda a você permissões de Explique os dados para a pasta de trabalho ou exibição.

Se você for o proprietário da pasta de trabalho, para obter mais informações sobre como definir permissões, consulte [Controlar quem pode usar Explique os dados e o que eles podem ver](https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm#Control).

### Dicas para usar Explique os dados

- Várias marcas não podem ser selecionadas para comparação entre si.
- A exibição deve conter marcas agregadas usando SUM, AVG, COUNT, COUNTD ou AGG (um campo calculado).
- Quando o Explique os dados não puder analisar o tipo de marca selecionado, uma mensagem será exibida para indicar o motivo. Para obter mais informações, consulte [Situações em que o Explique os dados não está disponível](https://help.tableau.com/current/server/pt-br/explain_data_requirements.htm#NotAvailable).
- Os dados que você analisa devem ser extraídos de uma única fonte de dados principal. O Explique os dados não funciona com fontes de dados combinadas ou em cubo.
- Para obter informações sobre quais características tornam uma fonte de dados mais interessante para uso com Explique os dados, consulte [Requisitos e considerações para uso do Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_requirements.htm).

## Detalhar as explicações

1. No painel Guia de dados, selecione um nome de explicação para ver mais detalhes.
    
    Selecione uma explicação para expandir ou reduzir seus detalhes.
2. Role para ver mais detalhes da explicação.
3. Passe o mouse sobre os gráficos nas explicações para ver detalhes sobre diferentes pontos de dados. Selecione o ícone Abrir ![Ícone Abrir exibição.](/tableau/current/pt-br/server/pt-br/Img/explaindata_openviewicon.png) para ver uma versão ampliada da visualização.
    
    Criadores e exploradores que abrem a exibição para edição podem selecionar o ícone Abrir ![Ícone Abrir exibição.](/tableau/current/pt-br/server/pt-br/Img/explaindata_openviewicon.png) para abrir a visualização como uma nova planilha e explorar mais os dados.
    
    **Observação**: Creators e Explorers com permissões de edição também podem controlar as configurações de explicação de dados. Para obter mais informações, consulte [Controle de acesso a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm).
4. Passe o mouse sobre um ícone de Ajuda ![Ícone de ajuda do Explique os dados.](/tableau/current/pt-br/server/pt-br/Img/explaindata_helpicon.png) para ver a ajuda de dica de ferramenta para uma explicação. Selecione no ícone de Ajuda ![Ícone de ajuda do Explique os dados.](/tableau/current/pt-br/server/pt-br/Img/explaindata_helpicon.png) para manter a dica de ferramenta aberta. Selecione em um link **Saiba mais** para abrir o tópico de ajuda relacionado.

## Exibir campos analisados

1. [Executar Explique os dados em um painel, planilha ou marca](#RunExD).
2. No painel Guia de dados, em **Explorar valores subjacentes para**, selecione o nome de uma medida de destino.  
    ![Detalhes do Explique os dados sobre uma marca analisada, com texto destacado que descreve um valor de soma de distância de viagem maior que o esperado de 8.800.](/tableau/current/pt-br/server/pt-br/Img/explaindata_viewfields1.png)
3. Selecione o link _number-of-fields_ na parte inferior do painel.  
    ![Detalhes do Explique os dados sobre uma marca analisada, com o texto destacado dizendo “14 de 23 campos”.](/tableau/current/pt-br/server/pt-br/Img/explaindata_viewfields2.png)

Os criadores têm a opção de abrir as configurações de Explique os dados para controlar quais campos são incluídos na análise. Para obter mais informações, consulte [Alterar campos usados para análises estatísticas](https://help.tableau.com/current/server/pt-br/explain_data_lm_status.htm#IncludeExcludeFields).

## Termos e conceitos nas explicações

Os seguintes termos e conceitos aparecem frequentemente nas explicações. Você pode achar útil familiarizar-se com seu significado no contexto do uso de Explique os dados.

O que é uma marca?

Uma marca é um ponto de dados selecionável que resume alguns valores de registro subjacentes em seus dados. Uma marca pode ser feita em um único registro ou em vários registros agregados. As marcas no Tableau podem ser exibidas de muitas maneiras diferentes, como linhas, formas, barras e texto de célula.

O Tableau obtém os registros que constituem a marca com base na interseção dos campos na exibição.

A **marca analisada** refere-se a uma marca em um painel ou planilha que foi analisada pelo Explique os dados.

Para obter mais informações sobre marcas, consulte [Marcas](https://help.tableau.com/current/pro/desktop/pt-br/view_parts.htm#Marks).

O que significa esperado?

O valor esperado de uma marca é o valor mediano na faixa de valores esperada nos dados subjacentes em sua visualização. O intervalo esperado é o intervalo de valores entre o 15º e o 85º percentil que o modelo estatístico prevê para a marca analisada. O Tableau determina o intervalo esperado sempre que executa uma análise estatística em uma marca selecionada.

Se um resumo de valor esperado indicar que a marca é _menor do que o esperado_ ou _maior do que o esperado_, significa que o valor agregado da marca está fora do intervalo de valores previstos no modelo estatístico da marca. Se um resumo de valor esperado indicar que a marca é _um pouco menor_ ou _pouco maior_ que o esperado, _mas está dentro do intervalo de natural variação_, significa que o valor agregado da marca está dentro do intervalo de valores previstos da marca, mas é menor ou maior nesse intervalo de valores.

Para obter mais informações, consulte [O que é um intervalo esperado?](https://help.tableau.com/current/pro/desktop/pt-br/explain_data_explained.htm#ExpectedRangeLM)

O que são dimensões e medidas?

Cada nome de coluna em um banco de dados é um campo. Por exemplo, Nome do produto e Vendas são campos. No Tableau, campos como Nome do produto que categorizam os dados são chamados de dimensões; campos com dados quantificáveis como Vendas são chamados de medidas. O Tableau agrega medidas por padrão quando você as arrasta para uma exibição.

Algumas explicações descrevem como os valores de registro subjacentes, e as agregações desses valores podem estar contribuindo para o valor da marca analisada. Outras explicações podem mencionar a distribuição de valores em uma dimensão para a marca analisada.

Quando você executa o Explique os dados na marca, a análise considera as dimensões e medidas na fonte de dados que não estão representadas na exibição. Esses campos são chamados de dimensões não visualizadas e medidas não visualizadas.

Para obter mais informações sobre dimensões e medidas, consulte [Dimensões e medidas](https://help.tableau.com/current/pro/desktop/pt-br/datafields_typesandroles.htm).

O que é um agregado ou agregação?

Um agregado é um valor que é um resumo ou total. O Tableau aplica agregações automaticamente, como SUM ou AVG, sempre que você arrasta uma medida para Linhas, Colunas, uma opção de cartão Marcas ou exibição. Por exemplo, as medidas são exibidas como SUM(Vendas) ou AVG(Vendas) para indicar como a medida está sendo agregada.

Para usar o Explique os dados deve-se utilizar uma medida agregada com SUM, AVG, COUNT, COUNTD ou AGG.

Para obter mais informações sobre a agregação, consulte [Agregação de dados no Tableau](https://help.tableau.com/current/pro/desktop/pt-br/calculations_aggregation.htm).

O que é um valor recorde?

Um registro é uma linha em uma tabela de banco de dados. Uma linha contém valores que correspondem a cada campo. Neste exemplo, Categoria, Nome do produto e Vendas são campos (ou colunas). Móveis, Luminária de piso e US$ 96 são os valores.

<table class="table--plain" style="width: 360px"><colgroup><col style="width: 120px;"><col style="width: 120px;"><col style="width: 120px;"></colgroup><tbody><tr><td style="font-weight: bold;">Categoria</td><td style="font-weight: bold;">Nome do produto</td><td style="font-weight: bold;">Vendas</td></tr><tr><td>Móveis</td><td>Luminária de piso</td><td>US$ 96,00</td></tr></tbody></table>

O que é uma distribuição?

Uma distribuição é uma lista de todos os valores (ou intervalos) possíveis dos dados. Também indica a frequência com que cada valor ocorre (frequência de ocorrência).

<!-- document id=73fb38d0ad029b98dec2002b48ac0d44e9ad48276b0a6ab0c1921b53a0bbf689 url=/tableau/current/pt-br/server/rmt-getting-started.md -->

[Pular para o conteúdo principal](#main-content)

# Começar a usar o Resource Monitoring Tool do Tableau

Este artigo o ajudará a começar a usar o Resource Monitoring Tool do Tableau. Ele contém links para outros artigos sobre informações que você precisa preparar antes de instalar o Resource Monitoring Tool, links para upgrade e outros recursos úteis.

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## Pré-Instalação

### Compatibilidade do produto com o Tableau Server

O Resource Monitoring Tool pode ser instalado para monitorar as versões compatíveis do Tableau Server.

A tabela abaixo lista a compatibilidade da versão entre o Resource Monitoring Tool(RMT) e o Tableau Server:

<table style="width: 90%; margin-left: 0; margin-right: auto;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Versão do RMT</th><th>Suporte do sistema operacional</th><th><span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> Versão</th></tr></thead><tbody><tr><td>2026.2.x</td><td>Windows, Linux</td><td>2024.2.x, 2024.3.x, 2025.1.x, 2025.2.x, 2025.3.x, 2026.1.x, 2026.2.x</td></tr><tr><td>2026.1.x</td><td>Windows, Linux</td><td>2024.1.x, 2024.2.x, 2024.3.x, 2025.1.x, 2025.2.x, 2025.3.x, 2026.1.x</td></tr><tr><td>2025.3.x</td><td>Windows, Linux</td><td><p>2022.3.x, 2023.1.x, 2023.3.x, 2024.2.x, 2025.1.x, 2025.3.x</p></td></tr><tr><td>2025.1.x, 2025.2.x</td><td>Windows, Linux</td><td><p>2022.3.x, 2023.1.x, 2023.3.x, 2024.2.x, 2025.1.x</p></td></tr><tr><td>2024.2.x</td><td>Windows, Linux</td><td><p>2022.3.x, 2023.1.x, 2023.3.x, 2024.2.x</p></td></tr><tr><td>2023.3.x</td><td>Windows, Linux</td><td><p>2022.3.x, 2023.1.x, 2023.3.x</p></td></tr><tr><td>2023.1.x</td><td>Windows, Linux</td><td><p>2022.3.x, 2023.1.x</p></td></tr><tr><td>2022.3.x</td><td>Windows, Linux</td><td><p>2022.3.x</p></td></tr></tbody></table>

### Compatibilidade do Resource Monitoring Tool Server (Servidor RMT) e do Agente

Geralmente, recomendamos que você instale a mesma versão do Servidor RMT e do Agente para ter certeza de que são compatíveis. Se você tiver Agentes usando versões não compatíveis com a versão do Servidor RMT, um incidente crítico será registrado. Para obter mais informações, consulte [Incidentes do agente](https://help.tableau.com/current/server/pt-br/rmt-incidents-agents-unlicensed.htm).

### Conceitos e termos

Familiarize-se com os conceitos e termos utilizados nos tópicos do Resource Monitoring Tool. Para obter mais informações, consulte [Conceitos](https://help.tableau.com/current/server/pt-br/rmt-concepts.htm).

### Arquitetura de instalação

O Resource Monitoring Tool tem dois componentes principais: Resource Monitoring Tool Server (Servidor RMT) e Agente. O Servidor RMT deve ser instalado em sua própria máquina, e o Agente é instalado em cada nó do cluster do Tableau Server. Para obter mais detalhes sobre a arquitetura de configuração, consulte [Instalar o Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-installation.htm).

Uma exibição de alto nível da configuração do Resource Monitoring Tool. Este diagrama mostra um cluster do Tableau Server de três nós.

![Diagrama ilustrando as relações entre um servidor mestre e clusters do Tableau Server para produção e desenvolvimento/teste.](/tableau/current/pt-br/server/pt-br/Img/rmt-setup-architecture.png)

### Requisitos mínimos de hardware e recomendações para o Resource Monitoring Tool

O Resource Monitoring Tool realiza todo o processamento, agregação, armazenamento e interface da Web para os dados de monitoramento coletados na instalação do Tableau Server. Para uso em produção, a máquina na qual você instala o Resource Monitoring Tool deverá atender ou exceder as recomendações mínimas de hardware. Para obter mais informações, consulte [Requisitos mínimos de hardware e recomendações para o Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-min-hardware-req.htm).

### Lista de verificação de pré-instalação para Resource Monitoring Tool

Antes de instalar o Resource Monitoring Tool, examine estes itens de ação e conclua as etapas necessárias: lista de verificação de pré-instalação do [Lista de verificação de pré-instalação - Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-install-checklist.htm)

## Atualização do Resource Monitoring Tool

Para obter instruções sobre como atualizar o Resource Monitoring Tool, consulte [Atualização do Resource Monitoring Tool](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade.htm).

## Solução de problemas

Certifique-se de verificar nossa [Solucionar problemas do Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-faq.htm) para obter respostas a perguntas comuns antes de entrar em contato com o suporte.

## Outros artigos nesta seção

<!-- document id=4c7268e3946c40fea6576121ddaad76c606af5174beb8ba0103f65ce22c027c8 url=/tableau/current/pt-br/server/get_started_server.md -->

[Pular para o conteúdo principal](#main-content)

# Introdução ao Tableau Server No Windows

Procurando o Tableau Server no Linux? Consulte [Introdução ao Tableau Server](https://help.tableau.com/current/server-linux/pt-br/get_started_server.htm "Abre o tópico em uma nova guia do navegador").

Para obter uma breve visão geral, assista a [Introdução ao Tableau Cloud e o vídeo de treinamento do Tableau Server](https://www.tableau.com/pt-br/learn/tutorials/on-demand/getting-started-tableau-cloudserver?playlist=509087) (2 minutos).

  

## Planejar

![Adicionar descrição da imagem](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_GetStarted_big.png)

- [Blueprint do Tableau](https://help.tableau.com/current/blueprint/pt-br/bp_overview.htm)
- [Visão geral do administrador de servidor](https://help.tableau.com/current/server/pt-br/admin.htm)
- [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm)
- [Planejamento de infraestrutura](https://help.tableau.com/current/server/pt-br/server_infrastructure_planning.htm)
- [mais](https://help.tableau.com/current/server/pt-br/plan.htm)

## Implantar

![Implante o Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_InstallConfigure_big.png)

- [Começar a instalação](https://help.tableau.com/current/server/pt-br/jumpstart.htm)
- [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm)
- [Instalar drivers](https://www.tableau.com/pt-br/support/drivers)
- [Instalações distribuídas e de alta disponibilidade](https://help.tableau.com/current/server/pt-br/distrib_ha.htm)
- [mais](https://help.tableau.com/current/server/pt-br/install.htm)

## Migrar e atualizar

![Migração do Tableau Server e atualização para novas versões do Tableau Server](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_Migrate_big.png)

- [Considerações técnicas para migração do Tableau Server para o Tableau Cloud](https://help.tableau.com/current/server/pt-br/migrate_server_to_cloud_overview.htm)
- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Atualizar](https://help.tableau.com/current/server/pt-br/upgrade.htm)
- [mais](https://help.tableau.com/current/server/pt-br/migrate.htm)

## Implantar software do cliente

![Implantar o Tableau Mobile e Desktop](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_Deploy_big.png)

- [Tableau Desktop e Tableau Prep  
    guia de implantação](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_welcome.htm)
- [Implantação do Tableau Mobile](https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_intro.htm)
- [mais](https://help.tableau.com/current/server/pt-br/install.htm)

## Gerenciar servidor

![Gerenciamento de servidor.](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_ManageServer_big.png)

- [Referência da linha do comando tsm](https://help.tableau.com/current/server/pt-br/tsm.htm)
- [Agendas de atualização da extração](https://help.tableau.com/current/server/pt-br/publish.htm)
- [Adicionar ou atualizar sites](https://help.tableau.com/current/server/pt-br/sites_add.htm)
- [Adicionar usuários ao servidor](https://help.tableau.com/current/server/pt-br/users_add.htm)
- [mais](https://help.tableau.com/current/server/pt-br/manage_server.htm)

## Gerenciar sites

![Sites!](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_ManageSites_big.png)

- [O que é um site](https://help.tableau.com/current/server/pt-br/sites.htm)
- [Gerenciar usuários e grupos](https://help.tableau.com/current/server/pt-br/users.htm)
- [Gerenciar acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/permissions_section.htm)
- [Gerenciar dados](https://help.tableau.com/current/server/pt-br/manage_data_section.htm)
- [mais](https://help.tableau.com/current/server/pt-br/manage_site.htm)

## Automatizar e estender

![Rest API, WDC, desenvolvedor](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_Embed_big.png)

- [Ferramentas e amostras do Tableau no GitHub](https://tableau.github.io/)
- [API REST](https://help.tableau.com/current/api/rest_api/pt-br/help.htm)
- [Conector de dados da Web (WDC)](https://tableau.github.io/webdataconnector/docs/)
- [Extensões de painel](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm)
- [mais](https://www.tableau.com/pt-br/developer)

## Produtos relacionados

![Extras](/tableau/current/pt-br/server/pt-br/Img/Help_Spot_Addon_big.png)

- [Tableau Advanced Management](https://help.tableau.com/current/server/pt-br/itm_intro.htm)
- [Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm)

  
  

## Outros artigos nesta seção

<!-- document id=42e24c3e0dd692566a6f28184d0bf83ce3066cfc9ae8c6be7ef37561e6f27247 url=/tableau/current/pt-br/server/rmt-slow-view-load-requests.md -->

[Pular para o conteúdo principal](#main-content)

# Investigação de solicitações de carregamento de exibição lenta

O gráfico de **Solicitações de carregamento de exibição lenta** na página de desempenho é uma métrica útil para entender o desempenho das exibições e o impacto resultante nas interações do usuário no Tableau Server.

O gráfico de Solicitações de carregamento de exibição lenta mostra quando as exibições estão renderizando mais lentamente do que o normal no Tableau Server. Para fazer isso, o gráfico usa uma **linha de base** que é estabelecida para cada exibição e a usa para comparar o tempo que leva para renderizar aquela exibição e determinar se a exibição está demorando mais do que o esperado.

**Na versão 2021.4** a linha de base é estabelecida calculando o valor médio das primeiras 10 vezes que uma pasta de trabalho específica é renderizada.

**Na versão 2021.4.1** e posterior, a linha de base é estabelecida calculando o percentil 95 de 50 vezes que uma pasta de trabalho específica é renderizada com sucesso.

Quando uma linha de base é estabelecida, toda vez que a mesma pasta de trabalho é renderizada no futuro, o tempo gasto para carregá-la é então comparado à sua linha de base. Dependendo se o tempo gasto para renderizar a exibição está dentro do intervalo esperado ou em vários graus fora do intervalo esperado, eles são categorizados da seguinte forma:

- **Normal:** <= 2x a linha de base
- **Longo:** > = 2x a linha de base
- **Muito longo:** >= 4x a linha de base
- **Falha:** falha ao carregar ou resultou em erro

**Observação**: essa linha de base e as comparações se aplicam apenas à renderização inicial da exibição. Ela se aplica a ações subsequentes, como seleções de filtro. Além disso, quando você publica uma nova versão da pasta de trabalho, ela dispara um recálculo da linha de base.

O gráfico mostra a porcentagem de carregamentos de exibições que estão fora do intervalo normal para o intervalo de tempo selecionado. Portanto, se você vir picos amarelos (longos) ou vermelhos (muito longos) neste gráfico, é a primeira indicação de que provavelmente há um problema.

**Dica:** selecionar o intervalo de tempo “Últimas 48 horas” pode ser um bom ponto de início, pois dará a você algum contexto sobre a atividade no passado versus a atual.

![Um gráfico de barras que ilustra solicitações de carregamento de exibição lenta.](/tableau/current/pt-br/server/pt-br/Img/rmt-slow-view-loads-chart.png)

Os gráficos **Usuários simultâneos** e de **Solicitações de carregamento de exibição total** na mesma página podem ser usados para ver o escopo do impacto resultante de carregamentos de exibição lenta no mesmo intervalo de tempo. Você também pode usar o gráfico de **Processos** do Tableau para identificar quaisquer correlações entre o desempenho de carregamento de exibição lenta e o uso de recursos – como, por exemplo, você pode ver um alto uso de recursos do VizQL Server em nós específicos ao mesmo tempo em que vê picos no gráfico de **Solicitações de carregamento de exibição lenta**.

Se você vir um pico no gráfico de solicitação de carregamento de exibição lenta, poderá começar a fazer uma busca detalhada para identificar o que pode estar causando o problema – se o problema é devido a uma única exibição ou a um problema muito mais amplo. Para fazer isso, no gráfico **Solicitações de carregamento de exibição lenta**, selecione um intervalo para incluir uma grande parte das exibições lentas. Isso o levará para a página **Carregamentos de exibição**, mostrando as solicitações de carregamento para o mesmo período.

Filtre por **Categoria de severidade de tempo de carregamento** e selecione a categoria apropriada para os carregamentos de exibição que você deseja investigar.

![Um menu suspenso lista opções de filtragem: Duração, Tempo de carregamento, Categoria de gravidade, Site, Usuário e Exibição.](/tableau/current/pt-br/server/pt-br/Img/rmt-slow-view-loads-activity.png)

A lista deve indicar quais visualizações podem ter causado os resultados do gráfico e pode ser entendida das seguintes maneiras:

**Várias exibições:** se a lista mostrar várias exibições, provavelmente esse é um problema mais amplo com o Tableau Server. Volte para a página de desempenho e veja o gráfico **Desempenho** e **Processos do Tableau Server** para investigar o uso de recursos. A guia **Status** na página de desempenho mostrará o status dos processos, estejam eles ativos, ocupados ou inativos. Procure os processos VizQL Server, Data Server e Data Engine nesta lista.

**Mesma exibição:** se a lista for principalmente uma única exibição, isso pode significar que há um problema com essa exibição ou pasta de trabalho. Pode ser necessária uma investigação adicional para ver o que pode estar causando o problema. Clique no **nome** da exibição na lista para ver mais informações sobre tempos de carregamento, consultas de dados relacionadas e sessões VizQL.

![Um gráfico de linhas mostra os tempos de carregamento de 17 de novembro a 1º de dezembro.](/tableau/current/pt-br/server/pt-br/Img/rmt-slow-view-loads-view-load-time-chart.png)

> [!IMPORTANT]
> 
> **Importante!** No gráfico de **tempos de carregamento**, se o tempo médio de carregamento for consistente, mesmo ao ajustar o intervalo de datas para se estender um pouco antes e depois do início do pico, isso significa que o cálculo da linha de base foi provavelmente criado quando os carregamentos de exibição estavam fortemente armazenados em cache, fazendo com que os carregamentos de exibição subsequentes sejam considerados “lentos”. Esse cenário não reflete um problema com o Tableau Server ou com a exibição. Se for esse o caso, você pode disparar um recálculo da linha de base publicando uma nova versão da pasta de trabalho.

Aqui estão alguns recursos para ajudar na solução de problemas de desempenho para uma exibição específica:

- [Otimizar o desempenho da pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/performance_tips.htm)
- [Registrar e analisar o desempenho da pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/perf_record_create_desktop.htm)

## Quem pode fazer isso

Qualquer usuário da Resource Monitoring Tool pode visualizar os gráficos.

<!-- document id=e40ac5abeb69b48252b52633a073660af95733a9f36c71c03f1da6e23fee3d14 url=/tableau/current/pt-br/server/kerberos.md -->

[Pular para o conteúdo principal](#main-content)

# Kerberos

Kerberos é um protocolo de autenticação de três vias que baseia-se no uso de serviço de rede de terceiros confiáveis, denominados Key Distribution Center (KDC), para confirmar a identidade dos computadores e oferecer conexões seguras entre eles por meio da troca de _tickets_. Esses tickets fornecem autenticação mútua entre computadores ou serviços, verificando se um tem permissão de acessar o outro.

O Tableau Server é compatível com a autenticação do Kerberos em um ambiente Active Directory Kerberos, com autenticação para que o Tableau Server seja manipulado pelo Kerberos.

**Observações**: 

- O suporte do Kerberos no Tableau Server é para autenticação do usuário. Ele não trata de permissões e autorizações internas relacionadas ao conteúdo do Tableau Server, como pastas de trabalho.
- Os pools de identidades, que são uma ferramenta projetada para complementar e oferecer suporte a opções adicionais de provisionamento e autenticação de usuários que você pode precisar em sua organização, oferecem suporte apenas à autenticação OpenID Connect (OIDC). Para obter mais informações, veja [Provisionar e autenticar usuários usando grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Como o Kerberos funciona

Quando você configura o Tableau Server para Kerberos em um ambiente Active Directory (AD), o controlador de domínio AD também funciona como Key Distribution Center (KDC) do Kerberos e emite Ticket Granting Tickets (TGT) para outros nós no domínio. Os usuários autenticados pelo KDC não precisam ser autenticados novamente ao se conectarem ao Tableau Server.

O procedimento seguinte é um diagrama do fluxo de trabalho da autenticação.

![Um diagrama ilustrando o processo de autenticação para um usuário do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/kerb_client_server.png)

<table><tbody><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/1ball.png" alt="Um círculo azul com um número branco 1 no centro."></td><td>O usuário se registra no domínio Active Directory.</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/2ball_32x32.png" style="width: 32;height: 32;" alt="Um círculo azul com um número 2 branco no centro."></td><td>O KDC do Kerberos autentica o usuário e envia um Ticket Granting Ticket (TGT) ao seu computador.</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/3ball.png" alt="Um círculo azul com um número 3 branco no centro."></td><td>O usuário se conecta ao Tableau Server, <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou em um navegador da Web.</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/4ball.png" alt="Um círculo azul com um número 4 branco no centro."></td><td><p>O Tableau Server autentica o usuário.</p></td></tr></tbody></table>

## Outros artigos nesta seção

<!-- document id=3f1fc55e91761aac9082b52ad87a90d759e99fed0c65089c41760130556da730 url=/tableau/current/pt-br/server/dm_license.md -->

[Pular para o conteúdo principal](#main-content)

# Licença Data Management

**Importante:** a partir de 16 de setembro de 2024, o Dados Management não estará mais disponível como uma opção complementar independente. Os recursos do Data Management só estarão disponíveis se você o adquiriu anteriormente ou se você comprar determinadas edições de licença: Tableau Enterprise, Tableau Cloud+ ou Tableau+ Bundle (disponível para Tableau Cloud) ou Tableau Enterprise ou Tableau Server+ (disponível para Tableau Server).

O Data Management inclui Tableau Catalog, Tableau Prep Conductor, conexões virtuais e políticas de dados e está disponível quando você compra o Tableau Enterprise. Entre em contato com o gerente da conta (ou vá até a página de [preços](https://www.tableau.com/pt-br/pricing/teams-orgs) do Tableau) para obter mais informações.

A Data Management só pode ser ativada em uma implantação licenciada do Tableau Server. Uma implantação inclui uma instalação licenciada de produção e instalações licenciadas de não produção do Tableau Server, que oferecem suporte à instalação de produção. Para obter mais informações sobre a implantação, consulte a [Documentação do EULA](http://www.tableau.com/legal/Documentation).

## Tableau Prep Conductor

Ao adquirir o Tableau Enterprise, você deve ativar o Prep Conductor no Tableau Server. Para obter mais informações, consulte [Habilitar e configurar o Tableau Prep Conductor no Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_config_server_overview.htm).

- Quando Data Management está ativo e habilitado, é possível agendar fluxos no Tableau Server ou Tableau Cloud e monitorar fluxos.
- Quando Data Management for removido ou desativado, ou se a licença do Data Management expirar, a capacidade de agendar fluxos será desabilitada.
- Se a licença do Tableau Server ou do Tableau Cloud ainda estiver ativa e válida, você poderá baixar os fluxos usando a API REST do Tableau Server. Para obter mais informações, consulte [Métodos de fluxo](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_flow.htm).

## Tableau Catalog

Ao adquirir o Tableau Enterprise, você deve ativar o Catalog no Tableau Server. Para obter mais informações, consulte [Ativar o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm).

- Quando Data Management está ativo e habilitado, é possível usar o Tableau Catalog para descobrir dados, limpar ativos de dados, realizar análises de impacto e rastrear a linhagem dos dados usados no conteúdo do Tableau.
- Quando Data Management é removido, desativado ou licença o expira, as informações permanecem no servidor. As informações específicas do Tableau Catalog só podem ser acessadas usando a API de metadados do Tableau, ela deixa de ser exibida no produto. Para obter mais informações, consulte [API de metadados](https://help.tableau.com/current/api/metadata_api/pt-br/index.html).
- Quando Data Management é removida, desativada ou licença expira, as APIs de gravação de todas as novas informações do Tableau Catalog (por exemplo, descrições de tabela, avisos de qualidade de dados, descrições de coluna) são desabilitadas. Você ainda pode ler as informações usando a API de metadados, mas as permissões em tabelas e bancos de dados não podem ser gerenciadas explicitamente no produto.

## Conexões virtuais e políticas de dados

Ao adquirir o Tableau Enterprise e habilita Data Management para o Tableau, as conexões virtuais e as políticas de dados são automaticamente habilitadas no Tableau Server.

Depois de comprar e licenciar Data Management para Tableau, conexões virtuais e políticas de dados são habilitadas automaticamente.

- Quando Data Management estiver ativa e habilitada, você pode usar conexões virtuais para criar recursos compartilháveis que fornecem um ponto de acesso central aos dados. Você também pode criar políticas de dados que permitem filtrar dados para usuários usando segurança centralizada em nível de linha.
- Quando Data Management é removida, desativada ou a licença expira, as informações permanecem no servidor, mas não são acessíveis.
- Quando Data Management é reativada, as informações são restauradas no servidor e ficam acessíveis.

## Como funciona o licenciamento de Data Management

Uma implantação do Tableau Server pode ser baseada no usuário ou no núcleo, dependendo da licença adquirida.

### Baseada no usuário

Uma métrica de licença baseada no usuário permite implantar o Tableau Server em um único computador ou em vários computadores em um cluster. Cada usuário que acessa o Tableau Server deve estar licenciado. Os administradores adicionam e licenciam os usuários. A primeira chave do produto do Creator ou do Explorer adicionada ao Tableau Server vai ativá-lo e será usada pelo Administrador do servidor.

A chave do produto do Data Management habilita os recursos incluídos no nível de implantação , e esses recursos são licenciados para todos os usuários que já estão licenciados para Tableau Server.

### Baseada no núcleo

Uma métrica de licença baseada no núcleo não impõe restrições sobre o número de contas de usuário no Tableau Server. Em vez disso, a licença especifica o número máximo de núcleos do computador para que você possa executar o Tableau Server.

**Observação:** quando você compra e usa o licenciamento baseado no núcleo, aplique tanto a chave do produto Data Management quanto a chave do produto Resource Core para a implantação do Tableau. A primeira chave permite que os fluxos sejam executados no Tableau Server, embora o Tableau Prep Conductor e a segunda chave adicionem os núcleos adicionais para os nós do Tableau Prep Conductor. Todas as chaves do produto estão disponíveis no [Portal do cliente](http://customer.tableau.com/).

Normalmente, o número total de núcleos em todos os computadores não deve exceder o número total permitido pela licença do Tableau Server. Quando você ativa a chave do produto de Data Management na implantação do Tableau Server, ela inclui um número específico de núcleos do Tableau Prep Conductor. Nesse cenário, o número total de núcleos em todos os computadores não deve exceder o número total permitido pela licença do Tableau Server e pela licença do Data Management juntas.

Neste tópico, vamos consultar os núcleos licenciados por meio da licença do Tableau Server como núcleos do Tableau Server e os núcleos licenciados por meio do Data Management como núcleos do Tableau Prep Conductor.

Veja abaixo alguns conceitos aplicáveis à maneira como o licenciamento é adotado em uma métrica Baseada no núcleo:

- Um nó pode ser licenciado apenas por um dos tipos, núcleos do Tableau Server ou núcleos do Tableau Prep Conductor.
- Os núcleos do Tableau Prep Conductor são aplicados a qualquer nó dedicado a executar o Tableau Prep Conductor e quando o Processador em segundo plano desse nó é definido para executar somente trabalhos em segundo plano de fluxo. Nesse caso, o número total de núcleos nesse nó não pode exceder o número de núcleos permitido pela licença do Data Management. Se esse nó tiver algum outro processo licenciado habilitado, além do Tableau Prep Conductor, Processador em segundo plano e Processador de dados, será necessário utilizar uma licença de núcleo do Tableau Server.
- Como mencionado acima, a função de nó do Processador em segundo plano também afeta a licença usada por um nó. Por exemplo, se a função de nó do Processador em segundo plano estiver definida para executar trabalhos de todos os tipos (esse é o padrão), esse nó será licenciado por meio dos núcleos do Tableau Server. Para obter mais informações sobre as funções do nó, consulte [Funções do nó no Tableau Server](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).
    
    Veja a tabela e o fluxo de decisão a seguir para entender como um nó é licenciado:
    
    <table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td><b>Se um nó tiver...</b></td><td><b>o núcleo no nó é contado para...</b></td><td><b>o nó é licenciado utilizando o...</b></td></tr><tr><td><p>um dos seguintes processos habilitado:</p><ul><li>Servidor de aplicativos</li><li>Processador em segundo plano (a função de nó é definida para executar todos os trabalhos)</li><li>Armazenamento de arquivo</li><li>Servidor de dados</li><li>VizQL Server</li></ul></td><td>Contagem total de núcleos do Tableau Server.</td><td>Núcleos do Tableau Server.</td></tr><tr><td><p>somente os seguintes processos habilitados:</p><ul><li>Tableau Prep Conductor</li><li>Processador em segundo plano (a função de nó é definida para executar somente fluxos)</li><li>Processador de Dados</li></ul></td><td><p>Número total de Tableau Prep Cores adquiridos por meio do <span class="mc-variable Variables.DM_sku variable">Data Management</span>.</p><p class="note"><b>Observação:</b> se não houver núcleos do Tableau Prep Conductor disponíveis, mas os núcleos do Tableau Server estiverem disponíveis, os núcleos do Tableau Server serão utilizados.</p></td><td><p>Núcleos do Tableau Prep incluídos no <span class="mc-variable Variables.DM_sku variable">Data Management</span>.</p><p class="note"><b>Observação:</b> se não houver núcleos do Tableau Prep Conductor disponíveis, mas os núcleos do Tableau Server estiverem disponíveis, os núcleos do Tableau Server serão utilizados.</p></td></tr></tbody></table>

![fluxo de decisão de licenciamento](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_licensing_flow_chart.png)

Para obter mais informações sobre os processos licenciados, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

Para saber mais sobre o licenciamento do Tableau Server, consulte [Visão geral do licenciamento do Tableau Server](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

<!-- document id=e54a4f756c00d36513574d0280b26b12df268c911fd80533be10b744db81119c url=/tableau/current/pt-br/server/license_zero_downtime.md -->

[Pular para o conteúdo principal](#main-content)

# Licenciamento de tempo de inatividade zero

Com o licenciamento de tempo de inatividade zero, que foi introduzido na Tableau Server versão 2021.1, você pode aplicar a maioria das alterações de licenciamento Tableau Server sem precisar reiniciar quando as datas finais da licença, capacidade ou recursos instalados forem alterados.

## Quando você deve reiniciar o Tableau Server?

Quando você aplica uma atualização de licença que não requer uma reinicialização, o Tableau Server exibe a seguinte mensagem: Os detalhes de licenciamento atualizados estão sendo aplicados no Server. No entanto, existem algumas situações ao aplicar uma atualização de licença que exigem que você reinicie o Tableau Server. Por exemplo, se você estiver ativando ou desativando uma chave de produto que reduza os recursos ou mude as conexões de fonte de dados permitidas, precisará reiniciar o Tableau Serverdepois de fazer as alterações. Quando uma reinicialização for necessária, o Tableau Server exibirá a seguinte mensagem: Reiniciar o Server para aplicar detalhes atualizados de licenciamento. A tabela a seguir lista as vezes em que as alterações de licença exigem que você reinicie Tableau Server.

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Mudança de licença</th><th>Reinício necessário?</th></tr><tr><td>Prorrogação do prazo de licença</td><td>Não</td></tr><tr><td>Adição ou redução da capacidade de licença do usuário</td><td>Não</td></tr><tr><td>Adição da capacidade de licença do núcleo</td><td>Não</td></tr><tr><td>Redução da capacidade de licença do núcleo</td><td>Sim</td></tr><tr><td>Adicionando uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span> ou <span class="mc-variable Variables.ITM_name variable">Advanced Management</span></td><td>Não</td></tr><tr><td>Removendo uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span> ou <span class="mc-variable Variables.ITM_name variable">Advanced Management</span></td><td>Sim</td></tr><tr><td>Alteração de fontes de dados permitidas</td><td>Sim</td></tr><tr><td>Chave do produto expirada</td><td>Sim</td></tr></tbody></table>

<!-- document id=7fd74a6eb4d022f59f6a87e7db08d1da6067fc8383c45f308530fb545d06c8d7 url=/tableau/current/pt-br/server/license_usl.md -->

[Pular para o conteúdo principal](#main-content)

# Licenciamento por assinatura atualizável (USL)

O licenciamento por assinatura atualizável simplifica os requisitos de gerenciamento de licenças do Tableau Server, eliminando a necessidade de gerenciar várias chaves de produto separadas para vários tipos de produtos, capacidades ou períodos de assinatura.

## Compreensão dos princípios básicos da USL

Com a USL, todos os recursos e atributos licenciados da sua implantação do Tableau (seu “direito de licença”) são fornecidos como uma única chave de produto unificada.

Além disso, a USL consolida a entrega de renovações de licença, complementos e alterações de direitos subsequentes em atualizações feitas naquela chave de produto única e atualizável ao longo do tempo, de modo que reflita consistentemente o direito de licença completo para sua implantação designada.

Você pode pensar em cada atualização como adicionar uma camada de novos atributos à sua chave de produto existente; cada uma dessas atualizações em camadas tem uma ID de ativação correspondente exclusivo. Quando você sincroniza a instalação do servidor com o serviço de licenciamento do Tableau (ativando ou atualizando a chave do produto), a ID de ativação mais recente é transferido para a instalação do servidor local para refletir o direito de licença atualizado da sua implantação.

O processo necessário para obter a ID de ativação mais recente da chave do produto difere dependendo da conectividade com a Internet da sua implantação.

## Ativação de USL em ambientes on-line ou conectados

Em ambientes on-line ou conectados, a chave do produto USL usada para ativar e desbloquear o direito de licença para sua implantação permanece constante ao longo do tempo.

- Ao ativar ou atualizar a chave de produto USL original (refletida como o “nome da chave” no Portal do cliente do Tableau), um ambiente conectado obterá automaticamente a ID de ativação mais recente disponível para seu direito de licença, facilitado pela comunicação ao vivo com os serviços de licenciamento hospedados do Tableau.
- Para instalações de servidor configuradas para usar o serviço de licenciamento Autorização para execução (ATR) do Tableau, essas atualizações são baixadas silenciosamente em segundo plano durante check-ins periódicos do servidor com o serviço ATR.

## Ativação de USL em ambientes offline ou desconectados

Em ambientes off-line ou desconectados, não há comunicação direta entre o Server e os serviços de licenciamento hospedados do Tableau, portanto, a chave do produto USL não pode ser usada para recuperar automaticamente novas atualizações de ID de ativação.

- Em vez disso, os administradores devem ativar diretamente a ID de ativação mais recente por meio do processo de ativação off-line do Tableau para refletir as atualizações no direito de licença da implantação.
- Depois que uma nova ID de ativação for adicionada ao seu direito de licença, nenhuma ID de ativação anterior poderá ser usada para ativação; elas se tornam funcionalmente obsoletas.
- Para essa finalidade, a ID de ativação mais recente é sempre refletida no Portal do cliente do Tableau como a “ID de ativação off-line” visível na exibição de detalhes da licença da sua chave do produto USL.
- Como novas IDs de ativação são geradas para qualquer atualização do seu direito de licença, a ID de ativação off-line mudará repetidamente ao longo do tempo.

> [!IMPORTANT]
> 
> **Importante:** a ativação off-line do Tableau exige que os clientes usem a ID de ativação off-line mais atual para ativar qualquer nova instalação do software.

### Gerenciar atualizações de direitos de licença em ambientes off-line

Dado o requisito de aproveitar a ID de ativação off-line mais atual ao ativar sua chave de produto USL em um ambiente desconectado, é importante obter a ID de ativação off-line atual no Portal do cliente do Tableau antes de tentar ativar qualquer instalação nova ou existente do Tableau Server. Pode não corresponder à que você usou pela última vez.

Os sistemas de provisionamento do Salesforce são sincronizados periodicamente para garantir o atendimento completo e preciso, e isso pode gerar uma nova ID de ativação off-line para seu direito de licença, não relacionado a qualquer compra específica ou renovação de assinatura. Certifique-se de verificar o Portal do Cliente _antes_ de qualquer alteração no licenciamento ativo em sua implantação, inclusive antes de implantar qualquer nova instalação do software de servidor, para confirmar a ID de ativação off-line atual e garantir a ativação bem-sucedida.

A seguir, estão alguns pontos-chave relacionados ao ciclo de vida da ID de ativação off-line:

- Ativação bem-sucedida _sempre exigirá_
    
    1. Desativação da ID de ativação off-line anterior e
    2. Ativação da ID de ativação off-line atual.
    
    Para instalações de servidor configuradas para usar ATR (off-line), a desativação da ID de ativação off-line anterior é tratada automaticamente.
- A emissão de uma nova ID de ativação off-line _impedirá novas_ ativações usando qualquer ID de ativação off-line anterior.
    
    Por esse motivo, consulte o Portal do Cliente antes de qualquer atualização de licenciamento em sua implantação.
- Uma nova ID de ativação off-line _não afetará_ nenhum ambiente de servidor onde você tenha ativado anteriormente sua chave do produto USL.
    
    - Essas instalações não refletirão seu direito de licença atualizado até que a nova ID de ativação off-line seja aplicada diretamente.

### Instruções de ativação de USL off-line

**Observação**: ao usar ATR e ativar uma licença USL para Tableau Server, você pode usar o **Nome da chave** do Produto ou o **ID de ativação off-line**. Recomendamos usar o Nome da chave porque você não precisa determinar o ID de ativação off-line.

Para ativar o USL em um ambiente off-line ou desconectado:

1. Identifique a chave do produto atual ou a ID de ativação off-line para sua implantação do Tableau Server.
    
    Você pode encontrar a ID de ativação off-line no Portal do cliente do Tableau navegando até o painel Licenças e clicando em sua chave do produto USL para abrir a exibição Detalhes da licença. A sequência de 20 dígitos é denominada "ID de ativação off-line". Para obter mais detalhes, consulte o artigo da Base de dados de conhecimento [Encontrar a chave correta para ativação off-line no Tableau Server](https://kb.tableau.com/articles/HowTo/Find-the-Correct-Key-to-offline-Activate-on-Tableau-Server?lang=pt-br)
2. Ative a chave do produto ou a ID de ativação off-line no Tableau Server, dependendo do método de ativação.
    
    Siga as etapas para ativar o Tableau Server off-line (aplicável às chaves do produto USL e pré-USL) em [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

### Atualizações de direitos de licença off-line do USL

As etapas necessárias para alterações no direito de licença em um ambiente off-line dependem do método de ativação (ATR ou FNO herdado) e da versão do Tableau Server.

- ATR _e_ versão 2023.1.0 ou superior:
    
    A ativação off-line para alterações de licença com ATR não é aceita. As licenças devem ser removidas localmente da instalação do Tableau Server e o suporte deve desativar a licença de forma manual. Para obter mais informações, consulte o artigo do Knowledge [Tableau Server 2023.1+: desativação de licença off-line com ATR não disponível](https://help.salesforce.com/s/articleView?id=001534333&type=1).
- Ativação FNO legada _ou_ qualquer versão anterior a 2023.1.0:
    
    1. Obtenha a ID de ativação off-line atual no Portal do Cliente
    2. Interrompa o Tableau Server:
        
        tsm stop
    3. Inicie uma desativação offline da chave ativada existente no servidor. Essa ID de ativação off-line agora está obsoleta no seu ambiente. A desativação off-line cria um arquivo de solicitação de devolução. Salve esse arquivo. Você precisa disso para uma etapa futura.
    4. Inicie uma solicitação de ativação off-line para a nova ID de ativação off-line. Isso gera uma solicitação de ativação. Salve este arquivo para a próxima etapa.
    5. Transfira o arquivo de solicitação de devolução e os arquivos de solicitação de ativação para um computador com acesso à Internet.
    6. Navegue para [Página de ativação offline](https://www.tableau.com/pt-br/support/activation) e inicie duas solicitações nesta ordem:
        
        1. Faça upload do arquivo de solicitação de devolução e baixe o arquivo de resposta; salve e continue.
        2. Faça upload do arquivo de solicitação de ativação e baixe o arquivo de resposta; salve e continue.
    7. Transfira o arquivo de resposta de retorno e o arquivo de resposta de ativação para o computador do Tableau Server desconectado.
    8. Aplique o arquivo de resposta de retorno.
    9. Aplique o arquivo de resposta de ativação.
    10. Inicie o Tableau Server:
        
        tsm start

<!-- document id=8eb323bfa0262cd11b55bb859171773a5367aacf4d6ca5695df8aec149191239 url=/tableau/current/pt-br/server/cmt-migration_limitations.md -->

[Pular para o conteúdo principal](#main-content)

# Limitações de migração

Há certas limitações de migrações ao usar o Content Migration Tool do Tableau. Antes de criar seu plano de migração, revise as seções abaixo para saber mais sobre a compatibilidade de versão e o conteúdo que não será migrado.

## Compatibilidade com o conteúdo do Tableau

O Content Migration Tool é compatível com a migração de pastas de trabalho e fontes de dados publicadas salvas nas oito versões mais recentes do Tableau. Pastas de trabalho e fontes de dados publicadas salvas antes da versão 2018.1.x não são aceitas pelo CMT. Para obter mais informações, consulte [Introdução ao Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-getting-started.htm).

A migração de conteúdo para versões anteriores do Tableau poderá falhar se o conteúdo incluir recursos ou formatos não reconhecidos pela versão anterior. O Content Migration Tool informará se foram encontradas incompatibilidades e se a migração falhará.

## Configurações

As configurações a seguir não são migradas para o site de destino ao usar o Content Migration Tool.

- [Usuários](https://help.tableau.com/current/server/pt-br/users_add.htm)
- [Grupos](https://help.tableau.com/current/server/pt-br/users_add_group.htm)
- [Configurações do site (logotipos personalizados, recomendações de exibição etc.)](https://help.tableau.com/current/server/pt-br/sites_add.htm)

## Conexões de dados

Embora você possa migrar as fontes de dados existentes, apenas as fontes de dados que usam os tipos de conexão na tabela abaixo podem ser alteradas e modificadas durante a migração. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm) e [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm).

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Actian Matrix</p><p>Actian Vectorwise</p><p>Amazon Athena</p><p>Amazon Aurora</p><p>Amazon EMR</p><p>Amazon Redshift</p><p>Apache Drill</p><p>Aster Database</p><p>Box</p><p>Cloudera Hadoop</p><p>Arquivo de texto delimitado</p><p>EXASOL</p><p>Firebird</p><p>Google Analytics</p><p>Google BigQuery</p><p>Google Cloud SQL</p></td><td><p>Google Drive</p><p>HortonWorks Hadoop Hive</p><p>HP Vertica</p><p>IBM DB2</p><p>IBM Netezza</p><p>Map R Hadoop Hive</p><p>Microsoft Access</p><p>Microsoft Analysis Services</p><p>Microsoft Excel</p><p>Microsoft Excel Direct</p><p>Microsoft OneDrive</p><p>Microsoft SQL Server</p><p>MySQL</p><p>OData</p><p>Oracle</p><p>Oracle Essbase</p></td><td><p>Pivotal Greenplum Database</p><p>PostgreSQL</p><p>Progress OpenEdge</p><p>Salesforce</p><p>SAP HANA</p><p>SAP Sybase ASE</p><p>SAP Sybase IQ</p><p>Snowflake</p><p>Spark SQL</p><p>Arquivo de estatística</p><p>Extrações do Tableau</p><p>Fontes de dados do Tableau Server</p><p>Teradata</p><p>Arquivo de texto</p><p>Conector de dados da Web</p><p>Outros bancos de dados (ODBC)</p></td></tr></tbody></table>

## Conteúdo não compatível

O conteúdo a seguir não é migrado para o site de destino ao usar o Content Migration Tool e exigirá configuração adicional.

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>Conteúdo</b></td><td><b>Ação requerida</b></td></tr><tr><td>Ampliações de Pergunte aos dados</td><td>Os usuários devem recriar a ampliação de Pergunte aos dados no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ask_data_lenses.htm" class="xref">Criar ampliações que concentram Pergunte aos dados a públicos específicos</a>.</td></tr><tr><td>Coleções</td><td>Os usuários devem recriar as coleções no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/collections.htm" target="_blank">Coleções</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</td></tr><tr><td>Comentários</td><td>Os usuários devem adicionar comentários novamente às exibições no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/comment.htm" target="_blank">Comentários nas exibições</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</td></tr><tr><td>Exibições personalizadas</td><td>Os usuários devem recriar exibições personalizadas no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/customview.htm" target="_blank">Usar exibições personalizadas</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</td></tr><tr><td>Política de atualização de dados</td><td>Usa o padrão do site na publicação. Os usuários devem configurá-lo manualmente se uma política de atualização específica for necessária. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/data_freshness_policy.htm" target="_blank">Definir uma política de atualização de dados</a> em <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> ou <a href="https://help.tableau.com/current/server/pt-br/data_freshness_policy.htm" target="_blank">Definir uma política de atualização de dados</a> na ajuda de <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>.</td></tr><tr><td>Funções de dados</td><td>Os usuários devem recriar funções de dados no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/prep/pt-br/prep_validate_data.htm" target="_blank">Usar as funções de dados para validar seus dados</a> na ajuda do <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span>.</td></tr><tr><td>Certificações da fonte de dados</td><td>Se você tiver as seguintes funções e recursos de site, poderá certificar fontes de dados no site de destino.<ul><li><p>Creator (Administrador de site)</p></li><li><p>Creator ou Explorer (pode publicar) com capacidade de Líder de projeto no projeto que contém a fonte de dados</p></li></ul><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/datasource_certified.htm" class="xref">Usar certificação para ajudar usuários a encontrar dados confiáveis</a>.</p></td></tr><tr><td>Alertas orientados por dados</td><td>Os usuários devem recriar alertas controlados por dados para painéis e exibições no site de destino. Depois que os alertas controlados por dados são criados, qualquer pessoa com acesso à exibição pode se adicionar aos alertas existentes.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/data_alerts.htm" target="_blank">Enviar alertas acionados por dados <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> ou <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span></a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</p></td></tr><tr><td>Descrições para pastas de trabalho e fontes de dados</td><td>Se você for proprietário do item de conteúdo ou tiver permissões adequadas, poderá editar a descrição do item no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/qs_content_page.htm" target="_blank">Adicionar ou editar descrições</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</td></tr><tr><td>Credenciais inseridas</td><td><p>Para fins de segurança, o <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> remove as credenciais incorporadas de fontes de dados durante o processo de download.</p><ul><li><p>Para incluir credenciais inseridas ao migrar de <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> para <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>, use as opções de publicação Migrar credenciais inseridas para pastas de trabalho e Migrar credenciais inseridas para fonte de dados. Para obter mais informações, veja <a href="https://help.tableau.com/current/server/pt-br/cmt-migration_embedded_credentials.htm" class="xref">Migrar pastas de trabalho e fontes de dados com credenciais inseridas</a>.</p></li><li><p>Para incluir as credenciais incorporadas ao publicar nos sites do <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>, use a transformação de fonte de dados de Definir Informações de conexão. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm" class="xref">Planos de migração: fontes de dados publicadas</a>.</p></li></ul><p class="note"><b>Observação:</b> o CMT não oferece suporte à migração de credenciais inseridas para conexões OAuth. Para migrar as credenciais OAuth, use a transformação da fonte de dados de Definir informações de conexão.</p></td></tr><tr><td>Ativos externos</td><td>Atributos personalizados para ativos externos não são migrados para o site de destino. Por exemplo, marcas, certificações, avisos de qualidade de dados, descrições, permissões, contatos do usuário, tabelas e colunas devem ser recriados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/dm_perms_assets.htm" class="xref">Gerenciar permissões para ativos externos</a>.</td></tr><tr><td>Agendas de atualização da extração</td><td>Os agendamentos de atualização de extração não podem ser migrados para sites de destino do <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>. Para atualizar os dados em <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>, você pode executar atualizações de extração manualmente ou criar novos agendamentos de atualização de extração. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/schedule_add.htm" target="_blank">Agendar atualizações no <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span></a>.</td></tr><tr><td>Favoritos</td><td>Os usuários devem selecionar novamente seu conteúdo favorito no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/favorites.htm" target="_blank">Marcar favoritos</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</td></tr><tr><td>Fluxos</td><td>Para executar os fluxos em uma agenda, os usuários devem republicar os fluxos no site de destino com o Tableau Prep. Para obter mais informações, consulte <a href="https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm" target="_blank">Publicar um fluxo para <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> ou <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span></a> na ajuda do Tableau Prep.</td></tr><tr><td>Atualizações incrementais da extração</td><td>As atualizações de extração incrementais são alteradas para atualizações de extração completas no site de destino. Os usuários devem reconfigurar atualizações incrementais no <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> e publique extrações no site de destino após a migração. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/extracting_refresh.htm#configure-an-incremental-extract-refresh" target="_blank">Atualizar extrações</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</td></tr><tr><td>Métricas</td><td><p>Os valores históricos para métricas são removidos das exibições, e os usuários devem recriar métricas no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/metrics_create.htm" class="xref">Criar e solucionar problemas de métricas (descontinuado)</a>. O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/metrics_create.htm">Criar e solucionar problemas de métricas (descontinuado)</a>.</p></td></tr><tr><td>Histórico de revisão</td><td>Para migrar versões anteriores de pastas de trabalho para o site de destino, os usuários devem baixar as versões que desejam manter e republicar a pasta de trabalho no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/qs_revision_history.htm" target="_blank">Trabalhar com revisões de conteúdo</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</td></tr><tr><td>Assinaturas</td><td>Os usuários devem se inscrever novamente em exibições e pastas de trabalho no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/subscribe_user.htm" class="xref">Criar uma assinatura para uma exibição ou pasta de trabalho</a>.</td></tr><tr><td>Miniaturas de pastas de trabalho e exibições</td><td>Pastas de trabalho e exibições migradas usando o <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> manterão suas miniaturas originais, mesmo que o plano de migração inclua transformações que resultem nas exibições serem renderizadas de forma diferente (por exemplo, se as conexões de dados mudarem).<p>Para atualizar as miniaturas, edite a pasta de trabalho ou exibição no site de destino e salve-a novamente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/web_author_build_view.htm" target="_blank">Editar exibições do Tableau na Web</a> na ajuda do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>.</p></td></tr><tr><td><p>Conexões virtuais</p></td><td>Os usuários devem recriar conexões virtuais no site de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/dm_vconn_create_conn.htm" class="xref">Criar uma conexão virtual</a>.</td></tr></tbody></table>

<!-- document id=b0aadd31cbb1244dd0b4b138be8012c0dbc2050cd1fccbb05672249e683697b9 url=/tableau/current/pt-br/server/distrib_process.md -->

[Pular para o conteúdo principal](#main-content)

# Limites de processo do servidor

Quando você reconfigura os processos do Tableau Server, há um limite na quantidade que você pode aumentar o número de instâncias de processo. Por padrão, o limite é definido para oito. Se o seu computador tiver RAM e núcleos de CPU suficientes e você quiser ir além deste limite, é possível alterar o limite usando a opção de configuração `service.max_procs`. Para cada instância de processo, o Tableau recomenda que o computador executando o processo tenha pelo menos 1 GB de RAM e 1 núcleo de CPU lógico.

Para alterar o número máximo de processos permitidos:

1. Digite o seguinte comando, onde `number` é o número máximo de instâncias de processo que você deseja permitir:
    
    `tsm configuration set -k service.max_procs -v <number>`
    
    Por exemplo:
    
    `tsm configuration set -k service.max_procs -v 10`
2. Em seguida, digite:
    
    `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).

<!-- document id=51dfe0da06026eb399b2870677d8bbe15aa114ef9f0b3ec34d37e6540cce648a url=/tableau/current/pt-br/server/server-backgrounder-resource-limits.md -->

[Pular para o conteúdo principal](#main-content)

# Limites de recursos do Processador em segundo plano do Tableau Server

O recurso de limites de recursos do Processador em segundo plano do Tableau Server foi introduzido no Tableau Server 2022.1.

## Visão geral e conceitos

### O que é isso

O recurso de limites de recursos do Processador em segundo plano oferece a capacidade de gerenciar recursos dele mesmo e controlar como eles são usados. A partir de 2022.1, você pode definir limites no número de trabalhos em segundo plano que podem ser executados ao mesmo tempo em um site. Você também pode especificar o número de horas do Processador em segundo plano que um site pode usar para executar trabalhos por dia.

Os limites padrão podem ser aplicados a todos os locais, mas você também pode definir limites personalizados por site. Isso permite que você gerencie os recursos do Processador em segundo plano com base nos requisitos específicos de um site.

### Quando usá-lo

Use esse recurso quando quiser garantir que os recursos sejam usados onde são mais necessários. Mais importante, você pode evitar que um único site consuma muitos recursos do processador em segundo plano, afetando a conclusão do trabalho ou o tempo de fila de trabalho em outros locais.

Se você estiver enfrentando um uso desequilibrado de recursos do Processador em segundo plano ou atrasos na conclusão de trabalhos em segundo plano, use esse recurso para otimizar o uso de recursos adequado às suas necessidades organizacionais e prioridades de conteúdo.

### Requisitos e recomendações

1. Esse recurso requer que o Tableau Server seja habilitado com uma licença de [Advanced Management](https://help.tableau.com/current/server/pt-br/itm_intro.htm).
2. Um novo processo do Tableau Server chamado **Gerenciador de Limites de Recurso** é necessário para impor os limites de recursos definidos. Quando você instala ou atualiza para o Tableau Server 2022.1 ou posterior, esse processo é configurado automaticamente no nó inicial.
    
    - Recomendamos ter pelo menos cinco processos do Processador em segundo plano no total em execução no Tableau Server para que o recurso de limites de recursos do processador em segundo plano seja executado de maneira ideal. A configuração padrão e as recomendações de topologia são descritas em detalhes no [Gerenciador de limites de recursos do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process-resource-limits-manager.htm).
    
    - Não recomendamos adicionar mais processos do Gerenciador de Limites de Recurso ao Tableau Server. O processo instalado automaticamente no nó inicial é suficiente.

### Terminologia e conceitos

- **Limites de trabalho do site:** a simultaneidade de trabalhos em segundo plano e os limites de tempo de execução de um site.
- **Limites de site padrão:** a simultaneidade de trabalhos padrão e os limites de tempo de execução para um site.
- **Limites de site personalizados:** limites de site específicos para esse site.
- **Tipo de trabalho:** o mesmo que tipo de tarefa. Inclui atualizações de extração, assinaturas e fluxos.
- **Limites de trabalhos simultâneos:** o número máximo de trabalhos de um tipo específico que podem ser executados ao mesmo tempo. O número máximo é igual ao número total de processos do Processador em segundo plano implantados no Server.
- **Limite diário:** o limite diário inclui os limites de tempo de execução e o tempo de reinicialização.
- **Limite de tempo de execução:** é o número total de horas de trabalho do Processador em segundo plano alocadas para um site por dia. O número máximo é igual ao número total de processos do Processador em segundo plano implantados no Server multiplicado por 24, sendo 24 o número de horas em um dia inteiro.
- **Tempo de redefinição:** o horário em que os limites diários são redefinidos. Isso é definido automaticamente para meia-noite UTC e não pode ser alterado.
- **Sem limite:** é como se não houvesse limites de recursos configurados. Nesse caso, os trabalhos em um site que podem ser executados em paralelo podem usar todos os processos de segundo plano disponíveis no Tableau Server.

## O que você pode fazer

**Como um administrador do Tableau Server**,

1. Você pode especificar o limite de trabalhos simultâneos para cada tipo de tarefa – atualizações de extração, assinaturas e fluxos. Esse limite controla o número de trabalhos em segundo plano em um site que podem ser executados ao mesmo tempo, para um determinado tipo de tarefa. Os limites são exclusivos para cada tipo de tarefa, o que significa que você pode definir limites diferentes para atualizações de extração, assinaturas e fluxos.
2. Você pode especificar o número de horas do Processador em segundo plano que um site pode usar para executar trabalhos em um período de 24 horas – o limite diário de tempo de execução do trabalho. Ao contrário do limite de trabalhos simultâneos, o limite de tempo de execução do trabalho diário é cumulativo em todos os tipos de tarefas.
3. Você pode descobrir quantas horas do Processador em segundo plano foram usadas por um site nas últimas 24 horas.
4. Você pode ver quando um trabalho está atrasado devido aos limites de simultaneidade definidos.
5. Você pode identificar quando um trabalho é cancelado devido à falta de recursos disponíveis do Processador em segundo plano.

Você pode ver o status e os detalhes do trabalho na página [Gerenciar trabalhos do Processador em segundo plano no Tableau Server](https://help.tableau.com/current/server/pt-br/server_backgrounder_job_management.htm).

**Como proprietário da tarefa**, você receberá um e-mail quando seu trabalho em segundo plano for cancelado por limite de tempo de execução diário esgotado.

## Como definir limites de recursos do Processador em segundo plano

O Tableau Server não define automaticamente limites de recurso. Até que você configure os limites de recursos, não há limitação deles no uso de recursos do processador em segundo plano.

Para definir limites de recursos pela primeira vez ou fazer alterações posteriormente, navegue até a página Configurações e selecione a guia Limites de recursos .

**Você só pode configurar limites personalizados depois de configurar os limites padrão**.

![Com todos os locais selecionados, na página de configurações na guia de limites de recursos, há as definições das configurações.](/tableau/current/pt-br/server/pt-br/Img/server-backgrounder-resource_limits-settings-page.png)

### Limites de site padrão

Os limites de site padrão são definidos no nível do servidor para que possam ser aplicados a todos os locais. As alterações nos limites de locais padrão se aplicam a todos os novos locais e a todos os locais existentes definidos para usar os limites padrão. Locais com limites personalizados não serão afetados por essa alteração.

- Os Limites de trabalhos simultâneos e os Limites diários de tempo de execução devem ser especificados em números inteiros.
- As alterações nos limites de site padrão entram em vigor imediatamente e não exigem a reinicialização do servidor.

Para definir limites padrão pela primeira vez, na guia Limites de recursos, selecione Definir limites padrão . Se você estiver atualizando os limites padrão existentes, selecione Editar limites padrão.

![Uma caixa de diálogo do Tableau Server para editar limites padrão de recursos.](/tableau/current/pt-br/server/pt-br/Img/server-backgrounder-default-resource-limits.png)

### Limites de locais personalizados

Para determinados locais, você pode precisar de mais ou menos recursos do que os limites padrão. Isso depende da quantidade de conteúdo que você tem no site e da importância deles para as operações da sua empresa. Quando os valores padrão não são a capacidade correta para um site, você pode definir limites de recursos personalizados para ele. Os limites de locais personalizados podem exceder os limites padrão.

- Os Limites de trabalhos simultâneos e os Limites diários de tempo de execução devem ser especificados em números inteiros.
- As alterações nos limites de site personalizados entram em vigor imediatamente e não exigem a reinicialização do servidor.

Para configurar limites personalizados para um site, na guia Limites de recursos, em Ações, clique nas reticências e selecione Personalizar limites do site.

![A imagem mostra uma captura de tela da lista de locais na guia de limites de recursos da página de configuração onde você pode definir limites personalizados para um site.](/tableau/current/pt-br/server/pt-br/Img/server-backgrounder-custom-resource-limits.png)

## O que acontece depois que você configura os limites de recursos

Depois de definir os limites de recursos para seus locais, o Tableau Server monitora e acompanha o uso de recursos do processador em segundo plano e garante que os limites apropriados sejam aplicados.

Os trabalhos são colocados em uma fila quando o site está em seu limite máximo de simultaneidade e não serão executados até que um trabalho em execução nesse site seja concluído e a capacidade do Processador em segundo plano fique disponível.

Se após 12 horas ainda não houver recurso de simultaneidade disponível, os trabalhos ainda pendentes serão removidos da fila. No final do limite de tempo de execução diário, **todos os trabalhos pendentes serão cancelados para o dia**, e o proprietário da tarefa receberá uma notificação.

Esse recurso requer que o Tableau Server seja ativado com uma licença válida do Server Management, sem a qual os limites não são impostos. Se a licença for inválida ou desativada por qualquer motivo, os limites configurados anteriormente serão salvos e serão aplicados assim que o problema da licença for resolvido.

## Quando fazer ajustes nos limites de recursos

_Antes de fazer alterações na configuração, verifique se o Tableau Server está em execução e em bom estado._

Você pode usar a página de [trabalhos](https://help.tableau.com/current/server/pt-br/server_backgrounder_job_management.htm) para identificar trabalhos pendentes ou cancelados e, em seguida, determinar quais deles foram devidos a limites de recursos.

Aqui estão alguns padrões para monitorar e fazer ajustes nos limites de recursos:

- Se você perceber que um ou mais trabalhos em um site estão sendo cancelados de forma consistente, pode ser necessário aumentar os limites diários de tempo de execução.
- Se você estiver vendo que os trabalhos em um site estão sendo cancelados consistentemente no início do dia, isso provavelmente significa que o tempo de execução do trabalho diário não é suficiente para esse site.
- Se você estiver vendo consistentemente vários trabalhos de um tipo específico permanecerem pendentes por um período, convém considerar aumentar os limites de trabalhos simultâneos para esse tipo de tarefa. Como alternativa, considere agendar as tarefas em diferentes períodos para que tudo não esteja sendo executado ao mesmo tempo. Além disso, você pode querer considerar a criação de agendas que são distribuídas por um período mais longo, para que as tarefas não sejam todas agendadas para serem executadas muito próximas umas das outras.
- Se você não quiser alterar os limites de recursos nas situações descritas acima, poderá optar por ajustar a frequência de agendamento de trabalhos para execução. Por exemplo, se o trabalho estiver agendado para ser executado a cada hora, ajuste-o para ser executado em um agendamento menos frequente.

### Quem pode fazer isso

Os administradores do Tableau Server podem configurar limites de recursos.

Um usuário do Tableau Server com tarefas de atualização de extração, assinatura ou execução de fluxo receberá notificações por e-mail quando os trabalhos forem cancelados.

<!-- document id=2b45f981a7fcce6fe04aa057f2d76680998214d184cde1d6ab09be8f5008a896 url=/tableau/current/pt-br/server/maintenance_clearpw.md -->

[Pular para o conteúdo principal](#main-content)

# Limpar senhas de conexão de dados salvas

Como administradorde servidor, se você permitir que os usuários salvem senhas das fontes de dados, os usuários do servidor podem salvar senhas das fontes de dados em diversas visitas e navegadores, para que as credenciais não sejam solicitadas cada vez que se conectarem a uma delas.

Você pode redefinir as senhas de fontes de dados para todos os usuários do Tableau Server. Isso os obrigará a entrar nas fontes de dados na próxima vez em que visitarem uma exibição que exija autenticação do banco de dados. Os usuários do servidor também podem limpar suas senhas de conexão de dados salvas individualmente usando a página [Preferências do usuário](https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm).

### Para limpar senhas de conexões de dados salvas de todos os usuários do servidor:

1. Em um servidor de site único, clique em Configurações > Geral. Em um servidor de vários sites, clique em Gerenciar todos os sites e clique em Configurações > Geral.
    
    ![Guia Geral da página de configurações do site do Tableau.](/tableau/current/pt-br/server/pt-br/Img/maintenance1a.png)
2. Em Credenciais Salvas, clique em Limpar todas as credenciais salvas.
    
    ![Configurações de credenciais salvas com o botão para limpar todas as credenciais salvas destacado.](/tableau/current/pt-br/server/pt-br/Img/maintenance5.png)

<!-- document id=8692dca6926e9bab866c54f9fbe44703e9078a5f9cbcc6a972d536f2c00ff1af url=/tableau/current/pt-br/server/server-upgrade-baseline-post-ug-cleanup.md -->

[Pular para o conteúdo principal](#main-content)

# Limpeza pós-atualização

Como discutido no tópico [Como funciona a atualização do Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-how-upgrade-works.htm), o processo de atualização do Tableau Server instala uma nova versão lado a lado com a versão existente. Agora que a atualização está concluída e verificada, você pode remover a versão mais antiga do Tableau Server para liberar o espaço em disco. Essa é uma etapa opcional.

## Desinstalar a versão anterior

Para desinstalar uma versão do Tableau Server:

1. Abra o Painel de controle, clique em Desinstalar um programa e localize a versão que você deseja desinstalar.
    
    Certifique-se de selecionar a versão correta para desinstalar:
    
    - A desinstalação de versões anteriores do Tableau Server não afeta a versão em execução e simplesmente remove arquivos desnecessários dessas versões anteriores.
    - **Não** desinstale a versão atual e em execução. A desinstalação da versão atual em execução do Tableau Server para o servidor e remove pastas e arquivos específicos do servidor, mas pode deixar alguns elementos. A desinstalação não cria um backup dos dados do repositório.
2. Com a versão do Tableau Server selecionada, clique em Desinstalar.

## Excluir pastas do "Tableau Server" do diretório `\packages`

Após uma atualização, você verá várias versões de pastas do Tableau Server na pasta \\packages. Quando a atualização for concluída com êxito, você poderá excluir as pastas relacionadas à versão mais antiga da qual você atualizou. É possível identificá-las pelo código de versão no nome da pasta. Por exemplo , `scripts.<version_code>`. Para obter mais informações sobre os códigos de versão, consulte [Visualizar versão do servidor](https://help.tableau.com/current/server/pt-br/version_server_view.htm).

<!-- document id=3ad2caf7306dff3c8dc62e44c09f519c5a0dde27915a1fc263f17b51baeb3b24 url=/tableau/current/pt-br/server/rmt-install-checklist.md -->

[Pular para o conteúdo principal](#main-content)

# Lista de verificação de pré-instalação - Resource Monitoring Tool do Tableau

O tópico a seguir fornece pré-requisitos para instalação Resource Monitoring Tool do Tableau. Ele também descreve as permissões do sistema operacional necessárias para as contas de serviço usadas.

## Requisitos de máquina, rede e conta

**Observação:** o servidor e o agente da Resource Monitoring Tool (RMT) não são compatíveis com o Federal Information Processing Standard (FIPS) 140-2 e não funcionarão corretamente em sistemas operacionais executados com o modo FIPS ativado.  

Complete os seguintes pré-requisitos antes de instalar o Resource Monitoring Tool do Tableau.

1. Certifique-se de ter privilégios administrativos para todos os computadores que executarão o Resource Monitoring Tool. Isso inclui o computador que executa o Servidor RMT e todos os nós do Tableau Server na instalação que você estará monitorando com o Resource Monitoring Tool.
2. Abra a porta 5672 para o tráfego TCP de entrada no computador que executa o Servidor RMT
    
    O aplicativo Resource Monitoring Tool de agente envia os dados coletados pela porta 5672, portanto, a maquina em que o Servidor RMT está instalado precisará permitir o tráfego TCP de entrada nessa porta.
    
    O Firewall do Windows é um bloqueador comum desse tráfego.
3. Abra as seguintes portas:
    
    - Abra a porta 80 para o tráfego TCP de entrada no computador que executa o Servidor RMT
        
        Esta é a porta na qual o Servidor RMT hospedará a interface da Web. Observe que podemos alterar o número da porta durante a instalação, se já houver um serviço de terceiros. Para tornar a interface da Web acessível de fora do Servidor RMT, essa porta precisará ser aberta.
    - Abra a porta 443 para o tráfego TCP de entrada no computador que executa o Servidor RMT do Resource Monitoring Tool.
        
        Esta é a porta em que as conexões vêm do Agente ao testar a conexão com o servidor RMT.
    - Abrir a porta 5672 e 5671 (conexões TLS) para o tráfego TCP de saída em todos os nós de agente.
        
        O aplicativo do agente envia os dados que coleta para o Servidor RMT por esta porta.
    - Abra a porta 80 para o tráfego TCP de saída em todos os computadores do agente.
        
        Periodicamente, o agente fará solicitações para a interface da Web do Servidor RMT.
    - Abra a porta 443 para o tráfego TCP de saída em todos os computadores do agente.
        
        Esta é a porta em que o Agente testa a conexão com o Servidor RMT.
    
    Para obter mais informações sobre portas e comunicações, consulte [Portas de comunicação do Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-ports-comms.htm).
4. Verifique se todos os computadores do Agente podem contatar o Servidor RMT.
    
    A interface da Web hospedada pelo Servidor RMT está vinculada a um nome de host ou endereço IP específico durante o processo de instalação. Ela só responderá a solicitações enviadas a esse nome de host específico. Por exemplo, se o Servidor RMT estiver configurado para ser hospedado em http://RMTServer/, mas os Agentes só puderem entrar em contato com o servidor RMT por meio de http://myrmtserver.myserver.com/, as solicitações não passarão.
5. Reúna credenciais para uma conta do administrador do Tableau Server.
    
    O Resource Monitoring Tool usará a API da Web do Tableau Server para coletar informações sobre o conteúdo, portanto, precisará de credenciais para um usuário que seja um administrador do Tableau Server e possa acessar todos os sites, projetos etc. É recomendável criar um dedicado ao Resource Monitoring Tool, mas pode ser qualquer usuário que seja um administrador do Tableau Server.
    
    **Observação:** o RMT não oferece suporte a SAML mas pode funcionar com uma instalação do servidor que usa SAML SSO. Para fazer isso, você precisa de um repositório de identidades local configurado para o Tableau Server e deve definir uma senha localmente para a conta de administrador que será usada pelo RMT.
6. Habilitar o acesso ao banco de dados do repositório do Tableau Server. **Isso é necessário a partir da versão 2022.3**.
    
    O Resource Monitoring Tool acessa o banco de dados de repositório diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados "readonly” (somente leitura). Para obter detalhes, consulte [Habilitar o acesso ao repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get).
7. Se você quiser usar conexões SSL entre o Resource Monitoring Tool e o Repositório do Tableau Server, certifique-se de que o Tableau Server esteja configurado para usar SSL para conexões Postgres internas. Para obter mais informações, consulte [Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm).
    
    O Resource Monitoring Tool permite que você use o arquivo de certificado (`server.crt`) ou a impressão digital para as conexões SSL. O arquivo de certificado do banco de dados Postgres é instalado para:
    
    `C:/ProgramData/Tableau/Tableau Server/data/tabsvc/config/pgsql<version>/security`
    
    Se você planeja usar o arquivo de certificado (`server.crt`), copie o arquivo de certificado gerado pelo Tableau Server para conexões SSL Postgres internas para a máquina onde você planeja instalar o RMT Server. Copie isso para o armazenamento de certificados da máquina.
8. Confirme se a API REST está habilitada no Tableau Server (este é o padrão). Use o comando `tsm configuration get -k api.server.enabled` para isso. Um valor de retorno `true` significa que a API REST está habilitada. Para criar a API REST, use o comando `tsm configuration set`. Para obter mais informações, consulte [api.server.enabled](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#rest_api_enabled).
9. Examine o tamanho dos registros do Tableau Server. Após instalar e configurar o Servidor de agente, o Resource Monitoring Tool processa os dados históricos relevantes dos registros do Tableau Server, antes de exibir os dados. Se houver uma grande quantidade de dados de registro históricos, pode demorar um pouco para processar as informações. Isso pode resultar em um atraso no processamento de eventos mais recentes no Servidor.
    
    Se estiver preocupado com o atraso e não tiver as informações históricas, você poderá fazer o seguinte para limpar os arquivos existentes:
    
    - [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm) e considere os [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm) antes de remover os arquivos de registro.
    
    **Observação:** os dados de desempenho, como uso de CPU e uso de memória não são reunidos usando dados de registro histórico, e são coletados depois que o Agente é instalado e configurado para que a limpeza de dados históricos não afete os dados de desempenho.
10. (opcional) Reunir informações da conexão para um servidor SMTP que o Servidor RMT pode acessar.
    
    Se você quiser notificações por e-mail, precisará fornecer o Servidor RMT com o nome do servidor, o nome de usuário e a senha (se houver) e o número da porta de um Servidor SMTP, que ele possa usar para enviar o e-mail, e a versão de TLS. Atualmente, o TLS versão 1.2 é necessário, mas o TLS versão 1.3 também é compatível. Se você quiser usar o TLS versão 1.3, certifique-se de ter o Open SSL 1.1.1f ou maior na máquina onde o Servidor RMT será instalado. Para obter mais informações, consulte [Notificações por e-mail](https://help.tableau.com/current/server/pt-br/rmt-config-configGui.htm#smtp_config).[Notificações por e-mail](https://help.tableau.com/current/server/pt-br/rmt-config-configGui.htm#smtp_config)
11. (opcional) Verifique as permissões da conta de serviço do sistema operacional para contas não padrão.
    
    Talvez seja necessário fazer isso caso sua organização tenha requisitos de segurança específicos que exijam que você use contas de sistema ou usuários já definidos.
    
    Você pode encontrar detalhes sobre as permissões padrão aqui: [Permissões de instalação padrão – Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-install-perms.htm)

### Quem pode fazer isso

Para fazer todas as etapas descritas acima, você precisa ser um administrador na máquina que está instalando o Resource Monitoring Tool e ser um administrador do Tableau Server.

<!-- document id=7b440bdb8da5007e501314cd6ae7bfa7d98765dc2a6b883021fa60c0fbdabc90 url=/tableau/current/pt-br/server/security_harden.md -->

[Pular para o conteúdo principal](#main-content)

# Lista de verificação do reforço de segurança

A lista a seguir oferece recomendações para melhorar a segurança ("endurecimento") da instalação de seu Tableau Server.

Procurando o Tableau Server no Linux? Consulte [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server-linux/pt-br/security_harden.htm)

## Instalação de atualizações de segurança

As atualizações de segurança estão incluídas nas versões mais recentes e nas versões de manutenção (MR) do Tableau Server. Não é possível instalar atualizações de segurança como correções. Em vez disso, você deve atualizar para uma versão atual ou MR para atualizar o Tableau Server com as correções de segurança mais recentes.

Sempre consulte a versão mais atual deste tópico após a atualização. A versão atual inclui `/current/` na URL do tópico.

Por exemplo, a URL da versão dos EUA é: [https://help.tableau.com/current/server/pt-br/security\_harden.htm](https://help.tableau.com/current/server/pt-br/security_harden.htm).

## 1\. Atualizar para a versão atual

Recomendamos que você sempre execute a versão mais recente do Tableau Server. Além disso, o Tableau publica periodicamente versões de manutenção do Tableau Server que inclui correções para vulnerabilidades de segurança conhecidas. (Informações sobre vulnerabilidades de segurança conhecidas podem ser encontradas na página [Boletins de segurança](https://community.tableau.com/s/security-bulletins) do Tableau e na página [Consultorias de segurança do Salesforce](https://security.salesforce.com/security-advisories).) Recomendamos que seja feita uma análise das notificações de versão de manutenção para determinar se devem ser instaladas.

Para obter a versão mais recente ou a versão de manutenção do Tableau Server, visite a página [Portal do cliente](http://customer.tableau.com/).

## 2\. Configurar SSL/TLS com um certificado válido e confiável

**Importante:** a partir da versão 2025.2 (Tableau Desktop), 2025.3 (Tableau Server) e de junho de 2025 (Tableau Cloud), o Tableau usa OpenSSL 3.4.x e segurança de nível 2. A segurança de nível 2 requer chaves de 2048 bits ou mais. Todas as chaves de segurança de nível 1 existentes não funcionarão mais e você precisará gerar e implantar um novo par de chaves. Se você estiver gerando chaves com pelo menos 2048 bits, conforme recomendado, nenhuma ação será necessária. Para obter mais informações, consulte [Gerar uma chave](https://help.tableau.com/current/server/pt-br/ssl_cert_create.htm#generate-key).

Secure Sockets Layer (SSL/TLS) é essencial para ajudar a proteger a segurança das comunicações com o Tableau Server. Configure o Tableau Server com um certificado válido e confiável (não um certificado autoassinado) para que o Tableau Desktop, os dispositivos móveis e os clientes Web possam se conectar ao servidor por uma conexão segura. Para obter mais informações, consulte [SSL](https://help.tableau.com/current/server/pt-br/ssl.htm).

## 3\. Desabilitar versões anteriores do TLS

O Tableau Server usa o TLS para autenticar e criptografar diversas conexões entre componentes e com clientes externos. Os clientes externos, como navegadores, o Tableau Desktop e o Tableau Mobile se conectem ao Tableau usando TLS sobre HTTPS. Transport layer security (TLS) é uma versão melhorada de SSL. Na verdade, as versões anteriores de SSL (SSL v2 e SSL v3) não são mais consideradas padrões de comunicação segura adequados. Como resultado, o Tableau Server não permite que clientes externos usem protocolos SSL v2 ou SSL v3 para conexão.

Recomendamos que você permita que clientes externos se conectem ao Tableau Server com TLS v1.3 e v1.2.

O TLS v1.2 ainda é considerado um protocolo seguro e muitos clientes (incluindo o Tableau Desktop) ainda não oferecem suporte ao TLS v1.3.

Os clientes compatíveis com TLS v1.3 negociarão o TLS v1.3 mesmo se o TLS v1.2 for compatível com o servidor.

O seguinte comando tsm habilita TLS v1.2 e v1.3 (usando o parâmetro "all" ) e desabilita SSL v2, SSL v3, TLS v1 e TLS v1.1 (ao colocar o caractere de menos \[-\] antes de um determinado protocolo). O TLS v1.3 ainda não é compatível com todos os componentes do Tableau Server.

`tsm configuration set -k ssl.protocols -v "all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1"`

`tsm pending-changes apply`

Para modificar os protocolos que regem o SSL para o repositório PostgreSQL do Tableau Server, consulte [pgsql.ssl.ciphersuite](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#pgsql.ss).

Você também pode modificar a lista padrão de pacotes de criptografia que o Tableau Server usa para sessões SSL/TLS. Para obter mais informações, veja a seção _ssl.ciphersuite_ em [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#ssl.ciph).

## 4\. Configurar criptografia SSL para tráfego interno

Configure o Tableau Server para usar SSL para criptografar todo o tráfego entre o repositório Postgres e outros componentes de servidor. Por padrão, o SSL fica desabilitado para comunicações entre componentes de servidor e o repositório. Recomendamos habilitar o SSL interno para todas as instâncias do Tableau Server, mesmo nas instalações de um servidor. A habilitação de SSL interno é especialmente importante para implantações de vários nós. Consulte [Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm).

## 5\. Habilitar a proteção com firewall

O Tableau Server foi projetado para operar dentro de uma rede interna protegida.

**Importante**: não execute o Tableau Server ou nenhum de seus componentes na Internet ou em um DMZ. O Tableau Server deve ser executado dentro da rede corporativa protegida por um firewall de Internet. Recomendamos a configuração de uma solução de proxy reverso para clientes da Internet que precisam se conectar ao Tableau Server. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).

Um firewall local deve estar ativado no sistema operacional para proteger o Tableau Server em implantações de um ou vários nós. Em uma instalação distribuída (de vários nós) do Tableau Server, a comunicação entre os nós não usa comunicação segura. Portanto, os firewalls precisam estar habilitados nos computadores que hospedam o Tableau Server.

Para evitar que um invasor passivo observe a comunicação entre os nós, configure uma LAN virtual segregada ou outra solução de segurança de camada da rede.

Consulte [Portas do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/ports.htm) para entender quais portas e serviços são exigidos pelo Tableau Server.

## 6\. Restringir acesso ao computador servidor e a diretórios importantes

Os arquivos de configuração e os arquivos de registro do Tableau Server podem conter informações que sejam valiosas para um invasor. Portanto, restrinja o acesso físico à máquina com o Tableau Server em execução. Além disso, certifique-se de que apenas usuários confiáveis e autorizados tenham acesso aos arquivos do Tableau Server no diretório `C:\ProgramData\Tableau`.

## 7\. Atualizar a conta de Usuário Run As do Tableau Server

Por padrão, o Tableau Server é executado na conta Serviços de rede (NT Authority\\Network Service) do Windows. Usar a conta padrão é aceitável em cenários nos quais o Tableau Server não precisa se conectar a fontes de dados externas que requerem autenticação do Windows. No entanto, se os usuários requerem acesso a fontes de dados autenticadas pelo Active Directory, atualize o Usuário Run As para uma conta de domínio. É importante minimizar os direitos à conta utilizada para o Usuário Run As. Para obter mais informações, consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm).

## 8\. Gerar segredos e tokens atualizados

Qualquer serviço do Tableau Server que se comunique com o repositório ou o servidor de cache deve primeiro se autenticar com um token secreto. O token secreto é gerado durante a instalação do Tableau Server. A chave de criptografia usada pelo SSL interno para criptografar o tráfego para o repositório Postgres também é gerada durante a instalação.

Recomendamos que, depois de instalar o Tableau Server, novas chaves de criptografia sejam geradas para sua implantação.

Esses ativos de segurança podem ser recuperados com o comando `[tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#regenerate-tokens)`.

Execute os seguintes comandos:

`tsm security regenerate-internal-tokens`

`tsm pending-changes apply`

## 9\. Desabilitar os serviços que você não está usando

Para minimizar a superfície de ataque do Tableau Server, desabilite quaisquer pontos de conexão que não sejam necessários.

### Serviço JMX

O JMX fica desabilitado por padrão. Caso esteja ativado mas não esteja em uso, deverá ser desativado usando a sequência a seguir:

`tsm configuration set -k service.jmx_enabled -v false`

`tsm pending-changes apply`

## 10\. Verificar a configuração de tempo da sessão

Por padrão, o Tableau Server não precisa ter um tempo limite absoluto de sessão. Isso significa que as sessões de cliente baseadas em navegador (Criação na Web) podem permanecer abertas indefinidamente, caso o tempo limite de inatividade do Tableau Server não seja excedido. O tempo limite de inatividade padrão é de 240 minutos.

Caso sua política de segurança precise, é possível definir um tempo limite absoluto de sessão. Certifique-se de definir um tempo limite absoluto de sessão em um intervalo que permita carregamentos de extração de execução mais longa ou publicação de pasta de trabalho em sua empresa. Definir um tempo limite de sessão muito baixo pode resultar em falhas de extração e publicação em operações de execução longa.

Para definir o tempo limite de sessão, execute os comandos a seguir:

`tsm configuration set -k wgserver.session.apply_lifetime_limit -v true`

`tsm configuration set -k wgserver.session.lifetime_limit -v _value_`, onde _value_ é o número de minutos. O padrão é 1440, que são 24 horas.

`tsm configuration set -k wgserver.session.idle_limit -v _value_`, onde _value_ é o número de minutos. O padrão é 240.

`tsm pending-changes apply`

As sessões para clientes conectados (Tableau Desktop, Tableau Mobile, Tableau Prep Builder, Bridge e tokens de acesso pessoal) usam tokens OAuth para manter os usuários conectados por meio do restabelecimento de uma sessão. Você pode desativar esse comportamento se quiser que todas as sessões de clientes do Tableau sejam regidas exclusivamente pelos limites de sessão baseados no navegador e controlados pelos comandos acima. Consulte [Desabilitar a autenticação do cliente](https://help.tableau.com/current/server/pt-br/devices_connected_credentials.htm).

## 11\. Configurar uma lista de permissão de fontes de dados baseadas em arquivo

A partir das versões de outubro de 2023 do Tableau Server, o comportamento padrão do acesso baseado em arquivo mudou. Antes, o Tableau Server permitia que usuários autorizados do Tableau Server criassem pastas de trabalho que usassem arquivos no servidor como fontes de dados baseadas em arquivos (como planilhas). Nas versões de outubro de 2023, o acesso aos arquivos armazenados no Tableau ou em compartilhamentos remotos deve ser configurado especificamente no Tableau Server usando a configuração descrita aqui.

Essa configuração permite limitar o acesso pelo [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm) somente para os diretórios que você especificar.

Para configurar o acesso a arquivos compartilhados, você precisa configurar a funcionalidade da lista de permissões. Isso permite que a conta de serviço Run As seja limitada a apenas aos caminhos de diretório local nos quais os arquivos de dados são hospedados.

1. No computador com o Tableau Server em execução, identifique os diretórios nos quais os arquivos de fontes de dados serão hospedados.
    
    **Importante** Certifique-se de que os caminhos de arquivo especificados nesta configuração existam na conta de serviço.
2. Execute os seguintes comandos:
    
    `tsm configuration set -k native_api.allowed_paths -v "_path_"` , onde _path_ é o diretório a ser adicionado à lista de permissão. Todos os subdiretórios do caminho especificado serão adicionados à lista de permissão. Você deve adicionar uma barra invertida ao caminho especificado. Caso deseje especificar vários caminhos, separe-os com ponto e vírgula, como neste exemplo:
    
    `tsm configuration set -k native_api.allowed_paths -v "c:\datasources;\\HR\data\"`
    
    `tsm pending-changes apply`

## 12\. Habilitar o HTTP Strict Transport Security para clientes do navegador da Web

O HTTP Strict Transport Security (HSTS) é uma política configurada nos serviços de aplicativos da Web, como o Tableau Server. Quando um navegador compatível encontra um aplicativo da Web que executa o HSTS, todas as comunicações com o serviço devem estar em uma conexão (HTTPS) segura. O HSTS é compatível com a maioria dos navegadores.

Para obter mais informações sobre como o HSTS funciona e os navegadores compatíveis, consulte a página da Web [Planilha de consultas do HTTP Strict Transport Security](https://cheatsheetseries.owasp.org/cheatsheets/HTTP_Strict_Transport_Security_Cheat_Sheet.html), do Projeto de segurança de aplicativos da Web aberto.

Para habilitar o HSTS, execute os seguintes comandos no Tableau Server:

`tsm configuration set -k gateway.http.hsts -v true`

Por padrão, a política do HSTS está definida para um ano (31536000 segundos). Este período especifica o tempo em que o navegador acessará o servidor por meio do HTTPS. Você deve considerar a definição de um tempo máximo breve durante o lançamento inicial do HSTS. Para alterar esse período, execute `tsm configuration set -k gateway.http.hsts_options -v max-age=<seconds>`. Por exemplo, para definir o período da política de HSTS para 30 dias, insira `tsm configuration set -k gateway.http.hsts_options -v max-age=2592000`.

`tsm pending-changes apply`

## 13\. Desabilitar o acesso de Convidado

As licenças baseadas em núcleo do Tableau Server incluem a opção de usuário Convidado, que permite que qualquer usuário na organização visualize e interaja com as exibições do Tableau inseridas nas páginas da Web.

O acesso de usuário Convidado é habilitado por padrão no Tableau Servers, implantado com o licenciamento baseado em núcleo.

O acesso de Convidado permite que os usuários visualizem as exibições inseridas. O usuário convidado não pode navegar pela interface do Tableau Server e não verá comandos da interface do servidor na exibição, como nome do usuário, configurações da conta, comentários e assim por diante.

Se a sua organização implantou o Tableau Server com o licenciamento em núcleo e o acesso de Convidado não é exigido, então, desabilite-o.

Você pode desabilitar o acesso de Convidado a nível de servidor ou site.

Você deve ser um administrador de servidor para desabilitar a conta de Convidado a nível de servidor ou site.

**Para desabilitar o acesso de Convidado a nível de servidor:**

1. no menu do site, clique em **Gerenciar todos os sites** e, em seguida, em Configurações \> Geral.
2. Para Acesso de Convidado, desmarque a caixa de seleção **Habilitar conta de Convidado**.
3. Clique em **Salvar**.

**Para desabilitar o acesso de Convidado para um site:**

1. No menu do site, selecione um site.
2. Clique em Configurações e, na página Configurações, desmarque a caixa de seleção Habilitar conta de convidado.

Para obter mais informações, consulte [Usuário Convidado](https://help.tableau.com/current/server/pt-br/users_guest.htm).

## 14\. Defina o cabeçalho HTTP referrer-policy como “same-origin”

A partir da versão 2019.2, o Tableau Server inclui a capacidade de configurar o comportamento do cabeçalho HTTP Referrer-Policy. Essa política é habilitada com um comportamento padrão que incluirá a URL de origem de todas as conexões "seguras como" (`no-referrer-when-downgrade`), que envia informações de referenciador de origem somente como conexões (HTTP para HTTP) ou aquelas que são mais seguras (HTTP para HTTPS).

No entanto, recomendamos definir esse valor para `same-origin`, que só envia informações de referenciador para origens do mesmo site. As solicitações de fora do site não receberão informações de referenciador.

Para atualizar o referrer-policy para `same-origin`, execute os seguintes comandos:

`tsm configuration set -k gateway.http.referrer_policy -v same-origin`

`tsm pending-changes apply`

Para obter mais informações sobre como configurar cabeçalhos adicionais para melhorar a segurança, consulte [Cabeçalhos de resposta HTTP](https://help.tableau.com/current/server/pt-br/security_http_headers.htm).

## 15\. Configurar TLS para conexão SMTP

A partir da versão 2019.4, o Tableau Server inclui a capacidade de configurar o TLS para conexão SMTP. O Tableau Server só é compatível com STARTTLS (TLS oportunista ou explícito).

O Tableau Server pode ser configurado opcionalmente para se conectar a um servidor de e-mail. Após a configuração do SMTP, o Tableau Server pode ser configurado para enviar um e-mail aos administradores do servidor sobre falhas no sistema e aos usuários do servidor sobre exibições em que estão inscritos e alertas orientados por dados.

Para configurar o TLS para SMTP:

1. Carregue um certificado compatível para o Tableau Server. Consulte [tsm security custom-cert add](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#custom-cert-add).
2. Configure a conexão do TLS usando a CLI do TSM.
    
    Execute os seguintes comandos do TSM para habilitar e forçar conexões do TLS ao servidor SMTP e habilitar a verificação do certificado.
    
    `tsm configuration set -k svcmonitor.notification.smtp.ssl_enabled -v true`
    
    `tsm configuration set -k svcmonitor.notification.smtp.ssl_required -v true`
    
    `tsm configuration set -k svcmonitor.notification.smtp.ssl_check_server_identity -v true`
    
    Por padrão, o Tableau Server suportará as versões do TLS 1, 1.1 e 1.2, mas é recomendável especificar a versão do TLS mais recente suportada pelo servidor SMTP.
    
    Execute o seguinte comando para definir a versão. Os valores válidos são `SSLv2Hello`, `SSLv3`, `TLSv1`, `TLSv1.1` e `TLSv1.2`. O exemplo a seguir define a versão do TLS para a 1.2:
    
    `tsm configuration set -k svcmonitor.notification.smtp.ssl_versions -v "TLSv1.2"`
    
    Para obter mais informações sobre as opções de configuração do TLS, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).
3. Reinicie o Tableau Server para aplicar as alterações. Execute o seguinte comando:
    
    `tsm pending-changes apply`

## 16\. Configurar SSL para LDAP

Se a implantação do Tableau Server estiver configurada para usar um armazenamento de identidades externo LDAP genérico, é recomendável configurar o SSL para proteger a autenticação entre o Tableau Server e o servidor LDAP. Consulte [Configurar canal criptografado no armazenamento de identidade externo LDAP](https://help.tableau.com/current/server/pt-br/config_encrypt_ldap.htm).

Se a implantação do Tableau Server estiver configurada para usar o Active Directory, é recomendável habilitar o Kerberos para proteger o tráfego de autenticação. Consulte [Kerberos](https://help.tableau.com/current/server/pt-br/kerberos.htm).

## 17\. Permissões de escopo para locais de instalação não padrão

Se você instalar o Tableau Server no Windows em um local não padrão, recomendamos definir de forma manual o escopo das permissões no diretório de instalação personalizado, para reduzir o acesso.

Por padrão, o Tableau Server será instalado na unidade do sistema. A unidade na qual o Windows está instalado é a unidade do sistema. Na maioria dos casos, a unidade do sistema é a unidade C:\\. Neste caso padrão, o Tableau Server será instalado nos diretórios a seguir:

- `C:\Program Files\Tableau\Tableau Server\packages`
- `C:\ProgramData\Tableau\Tableau Server`

No entanto, muitos clientes instalam em uma unidade que não é do sistema ou em um diretório diferente. Se você selecionar uma unidade de instalação diferente ou uma localização do diretório diferente durante a instalação, o diretório de dados do Tableau Server será instalado no mesmo caminho.

Para escopo de permissões no diretório de instalação personalizado, apenas as seguintes contas devem ter as permissões correspondentes na pasta de instalação e em todas as subpastas:

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><th>Definir permissões para esta conta:</th><th>Permissões exigidas</th></tr><tr><td>A conta de usuário usada para instalar e atualizar o Tableau Server</td><td>Controle total</td></tr><tr><td>A conta de usuário usada para executar comandos TSM</td><td>Controle total</td></tr><tr><td>Conta do sistema</td><td>Controle total</td></tr><tr><td>Executar como conta de serviço, serviço de rede e serviço local</td><td>Ler e executar</td></tr></tbody></table>

Um procedimento para definir essas permissões pode ser encontrado em [Instalando em um local não padrão](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm#Installi).

## Lista de alterações

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 30%;"><col style="width: 70%;"></colgroup><tbody><tr><th>Date</th><th>Change</th></tr><tr><td>May 2018</td><td>Added clarification: Do not disable REST&nbsp;API in organizations that are running Tableau Prep.</td></tr><tr><td>May 2019</td><td>Added recommendation for referrer-policy HTTP&nbsp;header.</td></tr><tr><td>June 2019</td><td>Removed recommendation to disable Triple-DES. As of version 2019.3, Triple-DES is no longer a default supported cipher for SSL. See <a href="https://help.tableau.com/current/server/pt-br/upgrade_know_before.htm" class="xref">O que mudou - O que é preciso saber antes da atualização</a>.</td></tr><tr><td>January 2020</td><td>Added recommendation to configure TLS for SMTP.</td></tr><tr><td>February 2020</td><td>Added recommendation to configure SSL for LDAP server.</td></tr><tr><td>May 2020</td><td>Added TLS v1.3 to the disabled list of TLS ciphers. Added clarification to introduction about topic versioning.</td></tr><tr><td>August 2020</td><td>Added scoped permissions for non-default installations on Windows</td></tr><tr><td>October 2020</td><td>Added TLS v1.3 as a default supported cipher.</td></tr><tr><td>January 2021</td><td>Added clarification:&nbsp;All products enabled by the Data Management license require REST&nbsp;API.</td></tr><tr><td>February 2021</td><td>Removed recommendation to disable REST API. The API is now used internally by Tableau Server and disabling it may limit functionality.</td></tr></tbody></table>

<!-- document id=eedee85fdaea623b06b4c55db4a7e11f53c2af6f9fa81bfe67de920722ac69b5 url=/tableau/current/pt-br/server/recycle_bin.md -->

[Pular para o conteúdo principal](#main-content)

# Lixeira

A Lixeira permite que Administradores do site, Administradores do servidor e autores com as funções de site Explorer (pode publicar) ou Creator restaurem projetos, pastas de trabalho, fontes de dados e fluxos excluídos anteriormente.

Você pode acessar a Lixeira na página inicial do seu site do Tableau. Expanda o painel lateral e selecione Lixeira. Se você não vir a Lixeira, o recurso deve ser ativado pelo seu administrador.

## Que conteúdo é armazenado na Lixeira?

Quando a Lixeira estiver ativada, os seguintes tipos de conteúdo serão movidos temporariamente para a Lixeira após a exclusão:

- Pastas de trabalho (incluindo histórico de revisão, visualizações, credenciais incorporadas, fontes de dados incorporadas e extrações)
- Fontes de dados (incluindo extratos e credenciais incorporadas)
- Projetos (incluindo pastas de trabalho e fontes de dados)
- Fluxos do Tableau Prep (observação: rascunhos de fluxo do Tableau Prep ainda são excluídos permanentemente e não irão para a Lixeira)

No entanto, quando você exclui e restaura pastas de trabalho, fontes de dados e projetos, alguns elementos do conteúdo original serão perdidos, incluindo:

- Exibições personalizadas
- Assinaturas
- Alertas orientados por dados
- Permissões
- Estatísticas agregadas sobre o item excluído (contadores de visualização e uso)
- Marcas
- Informações favoritas (se o item foi favorito)
- Comentários
- Agendas de fluxo
- Agendas de atualização da extração

> [!TIP]
> 
> **Dica**: se você não vir algo que espera que esteja na Lixeira, verifique se o arquivo está correto. Tipo de conteúdo é selecionado.

### Conteúdo: notas e melhores práticas

- Quando excluídos, os tipos de conteúdo suportados mantêm seus nomes originais. A ação Restaurar falhará se o projeto restaurado já tiver um item com o mesmo nome. Para resolver esse problema, restaure em um projeto diferente, renomeie o conteúdo recém-restaurado e mova o conteúdo para o local desejado.
- Pastas de trabalho e fontes de dados armazenadas na Lixeira ainda ocupam espaço em um site. Se uma pasta de trabalho ou fonte de dados usar uma extração, esse tamanho de extração ainda será contabilizado na cota do site.
- Quando excluídos, os tipos de conteúdo suportados não alteram seu proprietário. Usuários que originalmente tinham conteúdo ainda são considerados proprietários.
- Na restauração, os itens restaurados assumirão as permissões padrão definidas para o contêiner restaurado. Ao restaurar conteúdo crítico, o usuário operacional deve verificar se as permissões estão definidas conforme necessário. A operação Restaurar não restaurará as permissões de conteúdo originais.
- Os usuários podem ver o conteúdo que excluíram na Lixeira, mesmo que não sejam administradores ou não sejam proprietários do conteúdo.

### Projetos: notas e melhores práticas

Os projetos podem conter uma variedade de conteúdo ou projetos aninhados. Observe o seguinte sobre projetos quando a Lixeira está ativada.

**Observação**: a Lixeira respeita a hierarquia para projetos aninhados na ação de exclusão original e ao restaurar o conteúdo. Por exemplo, você pode excluir uma ramificação inteira do projeto raiz para enviar a raiz e todos os projetos aninhados para a Lixeira, e pode restaurar uma ramificação inteira do projeto da Lixeira se restaurar o projeto raiz (e todos os projetos aninhados ainda estiverem na Lixeira). Entretanto, a hierarquia não é respeitada quando você exclui conteúdo da Lixeira. Para excluir todos os projetos de uma ramificação do projeto original da Lixeira, você precisará excluir cada projeto individualmente.

**Projeto de exemplo**: o Projeto A inclui 2 pastas de trabalho (A e B), uma fonte de dados e um fluxo.

- Quando um projeto é inicialmente excluído e enviado para a Lixeira, todo o conteúdo desse projeto que é compatível com a Lixeira é armazenado individualmente. Para o Projeto A, você verá um projeto, a Pasta de Trabalho A, a Pasta de Trabalho B e uma fonte de dados na Lixeira. Outros tipos de conteúdo, como fluxos, são excluídos imediatamente e não podem ser recuperados.
- Todo o conteúdo compatível de um projeto pode ser restaurado ou excluído individualmente. Por exemplo, você pode excluir permanentemente a Pasta de Trabalho A do Projeto A, deixando apenas um projeto, a Pasta de Trabalho B, e a fonte de dados na Lixeira.
- Se você restaurar um projeto, todo o conteúdo compatível que ainda estiver armazenado na Lixeira no momento também será restaurado. Para o Projeto A, se você já tiver excluído a Pasta de Trabalho A e depois restaurado o Projeto A, o projeto será restaurado apenas com a Pasta de Trabalho B e uma fonte de dados.
- Se você excluir um projeto da Lixeira, somente o projeto será excluído. Por exemplo, se você excluir o Projeto A da Lixeira, a Pasta de Trabalho B e a fonte de dados permanecerão na Lixeira até serem excluídas individualmente, restauradas ou até que o tempo de armazenamento expire.

**Projeto de exemplo**: o Projeto A inclui as Pastas de Trabalho A, a Pasta de Trabalho B, uma fonte de dados e um Projeto B aninhado que inclui a Pasta de Trabalho C.

- Se um projeto excluído contiver projetos aninhados, todos os projetos aninhados que ainda estiverem armazenados na Lixeira no momento serão restaurados se o projeto de nível superior for restaurado. Por exemplo, restaurar o Projeto raiz A restaura o Projeto A de nível superior, a Pasta de Trabalho B, uma fonte de dados, o Projeto B e a Pasta de Trabalho C para o local de restauração selecionado.
- Projetos aninhados na Lixeira podem ser restaurados independentemente do projeto de nível superior. Se um projeto aninhado for restaurado de forma independente e, posteriormente, o projeto de nível superior for restaurado, o projeto de nível superior será restaurado sem nenhum conteúdo do projeto aninhado. Por exemplo, se você restaurar o Projeto B de forma independente e depois restaurar o Projeto A, o Projeto A será restaurado com o projeto de nível superior, a Pasta de Trabalho B e a fonte de dados. O Projeto B restaurado não estará mais aninhado dentro do Projeto A.

**Projeto de exemplo**: o Projeto 1 (P1) é um ramo de projeto que inclui 4 projetos aninhados (P2-P3-P4-P5).

**Cenário**: inicialmente, você exclui P1 e envia o ramo inteiro (a raiz P1 e os aninhados P2-P3-P4-P5) para a Lixeira.

- Na Lixeira, você pode excluir qualquer projeto individual da hierarquia original (P1-P2-P3-P4-P5).
- Excluir projetos aninhados da Lixeira interromperá a hierarquia do projeto original.
    
    - Se você excluir P3, P1, P2, P4 e P5 permanecerão na Lixeira, porém P4 não estará mais conectado a P2. O ramo original do projeto único agora está dividido em dois ramos: P1-P2 e P4-P5.
    - Com P3 excluído, se você restaurar P1, a ação Restaurar também restaurará P2, mas deixará P4 e P5 na Lixeira.
    - Com P3 excluído, se você restaurar P4, a ação Restaurar também restaurará P5, pois P4 agora é considerado a raiz de P5.
    - Você pode restaurar qualquer um dos projetos originalmente aninhados individualmente.
- Você não pode remover uma hierarquia de projeto inteira da Lixeira. Você deve excluir cada projeto individualmente.

## Restaurar conteúdo da Lixeira

Você pode restaurar o conteúdo da Lixeira para um projeto dentro do período de armazenamento configurado pelo administrador.

1. Na página inicial, expanda o painel lateral e selecione Lixeira.
2. Para Tipo de conteúdo, selecione Pastas de trabalho, Projetos, Fontes de dados ou Fluxos.
3. Selecione o menu Mais ações para o conteúdo que você deseja restaurar e, em seguida, selecione Restaurar.
4. Selecione um projeto como local de restauração.
5. Selecione Restaurar.

## Excluir conteúdo da Lixeira

Você pode excluir permanentemente o conteúdo da Lixeira antes do final do período de armazenamento configurado pelo administrador. _Essa ação não pode ser desfeita._

1. Na página inicial, expanda o painel lateral e selecione Lixeira.
2. Para Tipo de conteúdo, selecione Pastas de trabalho, Projetos, Fontes de dados ou Fluxos.
3. Selecione o menu Mais ações para o conteúdo que você deseja excluir permanentemente e, em seguida, selecione Excluir.
4. Selecione Excluir.

## Habilitar a Lixeira

Os administradores do site ou do servidor podem habilitar a Lixeira para um site do Tableau nas configurações do site. Para obter detalhes, consulte a [Referência de configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm).

1. Em ambientes de vários sites, selecione o site e acesse Configurações.
2. Na guia Geral, role a página até a seção Lixeira.
3. Selecione a caixa de seleção para Permitir Lixeira para este site.
4. Selecione o número de dias que o conteúdo será armazenado na Lixeira. Você pode escolher 1, 7 ou 30 dias.
    
    > [!IMPORTANT]
    > 
    > **Importante**: o conteúdo é excluído permanentemente após o número de dias selecionado.
5. Selecione Salvar.

## Desativar a Lixeira

> [!WARNING]
> 
> **Aviso**: se um administrador desabilitar a Lixeira, qualquer conteúdo armazenado nela será excluído permanentemente.

Os administradores do site ou do servidor podem desabilitar a Lixeira para um site do Tableau nas configurações do site. Para obter detalhes, consulte a [Referência de configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm).

1. Em ambientes de vários sites, selecione o site e acesse Configurações.
2. Na guia Geral, role a página até a seção Lixeira.
3. Desmarque a caixa de seleção para Permitir Lixeira para este site.
4. Selecione Salvar.

## Entre em contato com seu administrador

A Lixeira só pode ser ativada e configurada por um administrador do site ou do servidor do Tableau. Para ver as informações de contato do seu administrador, na página inicial, selecione o ícone Mostrar menu de ajuda e, em seguida, selecione Entre em contato com o administrador do Tableau.

<!-- document id=6a37eb26bc895849de2f104c4320a2480a4e0b8deabe128db21495576e37da16 url=/tableau/current/pt-br/server/logs_loc.md -->

[Pular para o conteúdo principal](#main-content)

# Locais de arquivo de registro e registros do Tableau Server

O Tableau Server gere arquivos de registro como uma parte normal do funcionamento. Cada serviço executado como parte do Tableau Server gera seus próprios registros. Esses arquivos de registro incluem informações sobre o que está acontecendo no servidor, o que o serviço ou processo está fazendo e se quaisquer erros ou avisos foram gerados. A extensão das informações nos registros depende de qual serviço está gravando-os, quais os níveis de registro estão definidos e o que está acontecendo no servidor.

Procurando o Tableau Server no Linux? Consulte [Localizações dos arquivos de registro do servidor](http://onlinehelp.tableau.com/current/server-linux/pt-br/logs_loc.htm).

Os arquivos de registro podem ser úteis para ajudar a identificar e corrigir problemas no Tableau Server. Em alguns casos, os administradores do sistema podem ser capazes de analisar os registros e encontrar pistas para o que está acontecendo, mas na maioria das situações os registros do Tableau Server são mais úteis para o Suporte ao Tableau. Quando você abre um caso com suporte, pode ser solicitado a enviar arquivos de registro do seu servidor.

**Observação:** os diretórios e registros específicos gerados pelo Tableau Server dependem da versão do servidor que você está executando e quais processos você configurou. Novos serviços e processos são adicionados periodicamente para aceitarem novas funcionalidades. Para obter detalhes sobre processos ou serviços para os quais você pode encontrar registros, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

## Arquivos de registro do Tableau Server em um cluster ativo

Como uma prática recomendada, você não deve editar ou excluir arquivos de registro em uma instalação ativa do Tableau Server. Fazer isso pode causar comportamento inesperado ou tempo de inatividade do servidor. A maioria dos registros do Tableau Server são gravados em um local no diretório de dados. Alguns registros são gravados em outros locais.

A maneira mais fácil e segura de reunir e visualizar arquivos de registro do servidor é criar um arquivo de registro, que é uma coleção de registros compactados de todos os nós em um cluster. Se você acha que pode precisar de registros antigos por qualquer motivo, por exemplo, para comparar com novos registros depois de fazer uma atualização, ou para enviar ao Tableau Support ao solucionar problemas de servidor, crie um arquivo zip e mova-o para um local seguro que não faz parte da infraestrutura do Tableau Server. Para obter mais informações sobre arquivos de registro em um arquivo de registro, consulte [Arquivos de registro do Server compactados](#ServerLogsInArchve).

Os registros podem ocupar bastante espaço, especialmente em um servidor muito usado. Você pode usar o comando[tsm maintenance cleanup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cleanup) para remover os registros que não deseja ou precisa mais, mas se você acha que pode precisar dos registros existentes, considere arquivá-los antes da limpeza.

### Locais de registros primários em uma instalação do Tableau Server em execução

A maioria dos registros do Tableau Server são gravados no diretório de dados, por padrão `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\`. Subpastas são criadas para cada instância de um serviço, com um nome que inclui o nome do serviço e o código de versão. Por exemplo:

C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\logs\\backgrounder

### Configuração de locais de arquivo em uma instalação do Tableau Server em execução

Além de registros para cada serviço ou processo, `config` uma subpasta contém informações de configuração sobre o serviço.

C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\config\\backgrounder

O Tableau Support pode pedir que você reúna alguns desses itens se estiver trabalhando com eles em um problema de servidor. O conteúdo pode ser analisado pelo Suporte.

### Registros que não estão escritos no local principal

Alguns registros não fazem parte do conjunto principal de registros e são escritos para locais diferentes das pastas de registro normais:

- O log do TSM. O arquivo `tsm.log` está localizado em `C:\Users\<user>\.tableau\tsm`
- O log de instalação. Por padrão, o arquivo `app-install.log` está localizado em `C:\ProgramData\Tableau\Tableau Server\logs`.
- O log de atualização. Por padrão, o arquivo `app-upgrade.log` está localizado em `C:\ProgramData\Tableau\Tableau Server\logs`.
- Registros do script de shell. Os scripts do Tableau Serve estão localizados no diretório de scripts (Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`.) e em muitos desses registros gerados, sempre que um script é executado. Os registros de script são salvos em:
    
    <install\_drive>\\<install\\path>\\logs\\
    
    por padrão:
    
    C:\\ProgramData\\Tableau\\Tableau Server\\logs

## Arquivos de registro do Server compactados

Pode ser que você queira analisar os arquivos de registro do Tableau Server ou precisar enviá-los para o Suporte do Tableau, se tiver um problema com seu servidor. Use o comando `[tsm maintenance ziplogs](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)` para criar um arquivo compactado de arquivos de registro de todos os nós em sua instalação. Por padrão, os armazenamentos dos arquivos de registro do Tableau Server são reunidos em um arquivo compactado chamado `logs.zip`, mas é possível especificar um nome de arquivo diferente ao criar o armazenamento. É possível copiar o arquivo do servidor para um computador local e abri-lo aqui ou enviá-lo para o Suporte do Tableau.

Quando você abre o arquivo, um diretório é criado para cada nó no cluster, e nesse diretório estão subdiretórios para cada serviço ou processo usando esta convenção de nomeação:

<service\_name>\_<instance>.<version>.<build>

Se houver várias instâncias de um serviço em um nó, haverá vários diretórios para esse serviço, um para cada instância. Por exemplo, se você tiver dois Processadores em segundo plano em um nó, você verá diretórios como estes:

backgrounder\_0.<version>.<build>
backgrounder\_1.<version>.<build>

Os diretórios e registros específicos no arquivo zip dependem da versão do Tableau Server que você tem e de quais processos você configurou. Para obter detalhes sobre processos ou serviços para os quais você pode encontrar registros, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

## Arquivos temporários

Todos os arquivos que começam com exe\_ in na pasta abaixo é um arquivo do Tableau Server e pode ser excluído.

`C:\ProgramData\Tableau\Tableau Server\temp`

<!-- document id=2ec465e2ca7f315d46fb2915b41ebec7d05ec92e8c257fc13fc8f1150b1b3782 url=/tableau/current/pt-br/server/trouble_svc_unlicensed.md -->

[Pular para o conteúdo principal](#main-content)

# Manipular um processo do Server não licenciado

Há vários indicadores de status na página Status do Tableau Server que o ajudam a compreender o estado dos processos do Tableau Server. Uma caixa de status de cor laranja, "Não licenciado", indica que um dos processos do Server não pode recuperar informações de licença do Tableau Server.

Na imagem abaixo, um dos processos VizQL não tem licença:

![Uma tabela mostra o estado atual dos processos do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/server_status_orange.png)

Vários motivos podem levar um processo a não acessar essas informações de licenciamento. Por exemplo, podem existir problemas de rede impedindo que um processo em execução em um nó adicional se comunique com o serviço de licença no nó inicial. Também é possível que o processo sem licença esteja recebendo mais solicitações do que pode aceitar em um momento específico e, assim, não consiga lidar com a solicitação de licenciamento. O impacto para os usuários depende de qual processo é incapaz de confirmar sua licença, e se há outras instâncias do processo em um dos nós do servidor. No caso do processo VizQL não licenciado acima, alguns usuários podem ser capazes de acessar exibições enquanto outros não podem.

Para resolver o problema, [interrompa](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm#stop) e [inicie](https://help.tableau.com/current/server/pt-br/cli_start_tsm.htm#start) o Tableau Server.

<!-- document id=0c899eef4f95aeb2582018436777038948f64f98560b0910f0d5abfa27e84a3e url=/tableau/current/pt-br/server/data_fresh_section.md -->

[Pular para o conteúdo principal](#main-content)

# Manter dados atualizados

Os tópicos nesta seção descrevem como atualizar dados manualmente, bem como agendar atualizações de dados.

## Outros artigos nesta seção

<!-- document id=2b1934a50d7c1628598fccc4e2b91824d4c8f23558d7fba5fa1994cb4a9d2a2b url=/tableau/current/pt-br/server/customview_update.md -->

[Pular para o conteúdo principal](#main-content)

# Manter o conteúdo com exibições personalizadas

Como criador de conteúdo, é importante entender como as atualizações feitas em pastas de trabalho e fontes de dados podem afetar o usuário final. As exibições personalizadas são uma maneira popular de personalizar como as visualizações são consumidas, mas as exibições personalizadas podem ser interrompidas caso o conteúdo de origem seja alterado. Evite fazer alterações que afetem as exibições personalizadas, se possível. Quando for necessário fazer alterações, siga as etapas descritas posteriormente neste tópico.

Em geral, existem algumas práticas recomendadas ao trabalhar com conteúdo conhecidas por usar exibições personalizadas.

- Aconselhe os usuários finais a criar apenas exibições personalizadas em conteúdo estável.
    - Use projetos ou sistemas de nomenclatura para identificar as pastas de trabalho que estão sendo modificadas e recomende que os usuários não criem exibições personalizadas nelas.
- Teste as alterações em um ambiente de preparação ou desenvolvimento. Teste exibições personalizadas que representam os filtros esperados, as ações do usuário, as configurações de parâmetros e outras personalizações.
- Notifique os usuários de forma proativa antes de publicar alterações que possam interromper as exibições personalizadas. (Recupere uma lista de todas as exibições personalizadas aplicadas a uma pasta de trabalho [usando os métodos de exibições personalizadas na API REST do Tableau](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_workbooks_and_views.htm#list_custom_views).)

## Alterações conhecidas por impactar exibições personalizadas

Embora seja melhor testar as alterações para verificar seu impacto nas exibições personalizadas, algumas atualizações são conhecidas por afetar as exibições personalizadas.

Esta lista não é abrangente e destina-se apenas a orientação.

### Alterações na pasta de trabalho

- **Mudanças de nome**. A alteração do nome da pasta de trabalho (ou da planilha à qual a exibição personalizada está associada) interrompe as exibições personalizadas.
- **Parâmetros.** Adicionar ou remover um parâmetro pode fazer com que uma exibição personalizada seja interrompida ou não seja atualizada conforme o esperado.
    - Se um parâmetro for adicionado ao conteúdo original, a exibição personalizada poderá ser interrompida.
    - Se um controle de parâmetro for removido, os campos calculados que usaram sua entrada reterão seu último valor e não serão mais ajustáveis.
- **Filtros**. A remoção de um filtro remove o controle de filtro, mas deixa os dados em um estado filtrado.
    - Em geral, caso um filtro seja excluído do conteúdo original, uma exibição personalizada que usou esse filtro continua funcionando. No entanto, os dados permanecem filtrados sem nenhum controle de filtro presente. Isso significa que os usuários não podem alterar a seleção do filtro na exibição personalizada.
    - Alterar o controle de filtro no controle deslizante para a data relativa não ajusta o filtro para refletir com precisão a data relativa conforme o esperado.
    - Se as exibições personalizadas forem usadas para controlar seleções de filtro, insira parâmetros de filtro em uma URL compartilhada.
- **Ocultar planilhas.** Definir uma planilha como oculta, mesmo que ela seja reexibida mais tarde, interrompe as exibições personalizadas nessa planilha.
- **Republicar**. Excluir e republicar uma pasta de trabalho interrompe suas exibições personalizadas.
- **Valores padrão**. Se uma exibição personalizada for definida por um valor padrão (como para um parâmetro, conjunto ou filtro) e o valor padrão for alterado, a exibição personalizada será atualizada para refletir o novo valor. Se a exibição personalizada precisar ser vinculada a um valor específico, use-a em vez de depender de <default value>.

### Alterações na fonte de dados

- **Alterações na fonte de dados**. Substituir uma fonte de dados usando a funcionalidade Substituir fonte de dados ou substituir uma fonte de dados incorporada por uma cópia publicada da mesma fonte de dados interrompe as exibições personalizadas.
- **Tipo de dados**. Alterar o tipo de dados de um campo relevante para a exibição personalizada interrompe a exibição personalizada.
- **Remover campos**. A remoção de campos, cálculos, grupos ou conjuntos nos quais as exibições personalizadas são baseadas interrompe a exibição personalizada.

## Atualizar o conteúdo com segurança

Veja a seguir um conjunto de práticas recomendadas para minimizar o risco de interromper exibições personalizadas existentes.

- Edite as pastas de trabalho e as alterações nas fontes de dados separadamente.
- Não republique uma pasta de trabalho que tenha uma fonte de dados substituída.
- Edite uma versão local da pasta de trabalho ou fonte de dados e republique-a com o mesmo nome.

### Modificar uma pasta de trabalho

Essas etapas pressupõem que a pasta de trabalho usa uma conexão em tempo real com uma fonte de dados publicada separadamente e tem exibições personalizadas existentes.

#### Modificar uma pasta de trabalho com edição na Web

A edição na Web é o método preferido para modificar uma pasta de trabalho. Usar o Tableau Desktop somente se necessário.

1. Edite uma pasta de trabalho no navegador, evitando os itens abordados anteriormente que são conhecidos por interromper exibições personalizadas.
    - Se for necessário fazer alterações nos dados, não as faça agora. Consulte a seção sobre como modificar uma fonte de dados.
2. Publique a pasta de trabalho no mesmo local com o mesmo nome, salvando sobre a versão existente.

#### Modificar uma pasta de trabalho com o Tableau Desktop

Quando possível, modifique as pastas de trabalho no navegador. Usar o Tableau Desktop somente se necessário.

1. Abra uma versão local da pasta de trabalho (baixe a pasta de trabalho primeiro, se necessário).
2. Edite a pasta de trabalho, evitando os itens abordados anteriormente que são conhecidos por interromper exibições personalizadas.
    - Se for necessário fazer alterações nos dados, não as faça agora. Consulte a seção sobre como modificar uma fonte de dados.
3. Publique a pasta de trabalho no mesmo local com o mesmo nome, substituindo a versão existente.
    - _Não_ marque a opção "Atualizar a pasta de trabalho para usar a fonte de dados publicada".

### Modificar uma fonte de dados

1. Abra uma versão local da fonte de dados no Tableau Desktop baixando a pasta de trabalho e criando uma cópia local da fonte de dados:
    
    1. Baixe a pasta de trabalho e abra-a no Tableau Desktop.
    2. Clique com o botão direito do mouse na fonte de dados e selecione "Criar cópia local".
    3. Clique com o botão direito do mouse na nova fonte de dados e selecione "Substituir fonte de dados…"
    4. Troque a conexão existente com a fonte de dados publicada pela cópia local recém-criada.
    
    **Observação**: usar uma versão local em uma pasta de trabalho é o método preferido, porque permite que você verifique as alterações da fonte de dados diretamente na pasta de trabalho. Como alternativa, você pode baixar a fonte de dados ou usar uma cópia armazenada localmente.
2. Edite para a fonte de dados, evitando os itens abordados anteriormente que são conhecidos por interromper exibições personalizadas.
3. Publique a fonte de dados.
    1. Use o mesmo nome e salve na fonte de dados existente.
    2. Não marque a opção "Atualizar a pasta de trabalho para usar a fonte de dados publicada".
    3. Não publique a pasta de trabalho com a fonte de dados modificada. Se for necessário fazer alterações no conteúdo da pasta de trabalho, consulte a seção sobre como modificar pastas de trabalho.

## Investigar exibições personalizadas interrompidas

**Observação**: esta seção pressupõe familiaridade com XML e interações básicas de linha de comando.

Em um arquivo de pasta de trabalho .twb, o XML de uma pasta de trabalho contém marcas de identificação para elementos da pasta de trabalho. Quando uma exibição personalizada é criada, é obtido um instantâneo dos elementos interativos (como filtro ou valores definidos, parâmetros ou marcas selecionadas) e seus valores. Quando uma exibição personalizada é acessada, o Tableau aplica os valores de atributo armazenados com a exibição personalizada às IDs de elemento relevantes. Se as IDs de elemento forem alteradas ou os valores de atributo não puderem ser carregados, a exibição personalizada será interrompida.

Talvez seja possível identificar o que mudou para interromper uma exibição personalizada ao comparar um .twb antes e depois da alteração.

1. Você precisará de um .twb da pasta de trabalho quando a exibição personalizada estiver funcionando (salve uma cópia do conteúdo antes de fazer alterações).
2. Em outra cópia da pasta de trabalho, faça a alteração necessária para interromper a exibição personalizada e salve-a como um .twb diferente.
3. Na linha de comando, execute o comando a seguir (substituindo os arquivos da etapa um como file1.twb e da etapa dois como file2.twb).
    
    vimdiff file1.twb file2.twb
4. Os resultados destacam as alterações entre os arquivos.

Algumas IDs ou valores de atributo (entre **\[colchetes\]**) que são conhecidos por interromper exibições personalizadas caso haja alterações:

```
<datasources>
	<datasource name='[ID]'>

<worksheets>
	<worksheet name='[ID]'>
<table>
<view>
<datasource-dependencies datasource='[ID]'>
<column datatype='[Value]' name='[Value]'>

<dashboards>
	<dashboard name='[ID]'>
```

<!-- document id=1ffbd0cbe88aa0b8d90af06b152d642fde8a419b215a5d81c7000a774bfddbff url=/tableau/current/pt-br/server/distrib_maint.md -->

[Pular para o conteúdo principal](#main-content)

# Manter um ambiente distribuído

Após configurar um nó inicial e um ou mais nós adicionais para uma instalação distribuída, é possível executar todas as configurações e atualizações subsequentes a partir do nó inicial usando o TSM CLI, ou a partir de qualquer computador que usa um navegador e a interface do TSM Web.

Ao instalar nós adicionais, eles são incluído pelo nome do computador. Se o nome do computador de um nó for alterado, será necessário remover e reinstalar o nó. Para obter detalhes sobre a remoção de um nó, consulte [Remover um nó](https://help.tableau.com/current/server/pt-br/distrib_worker_remove.htm).

Você pode monitorar o status do cluster do Tableau Server na página de status do TSM. Consulte [Exibir o status de processos do servidor](https://help.tableau.com/current/server/pt-br/service_viewstatus.htm) para obter detalhes.

É interessante manter algumas ações adicionais no ambiente distribuído, entre elas:

## Outros artigos nesta seção

<!-- document id=ec2ff584bec5ca7a4af90df8d3b6730f6feffe8142039bdefa837c01d1abeb2c url=/tableau/current/pt-br/server/monitor_maintenance.md -->

[Pular para o conteúdo principal](#main-content)

# Manutenção

Você deve executar uma manutenção regular no Tableau Server, como criar backups, sincronizar grupos do Active Directory e remover arquivos desnecessários.

## Outros artigos nesta seção

<!-- document id=3b28bb1406f93de9bfb21635e9f81ac59fae32b98190fe8abe42d87f1548af74 url=/tableau/current/pt-br/server/maintenance.md -->

[Pular para o conteúdo principal](#main-content)

# Manutenção do servidor

Como administrador, você deverá conferir o status do servidor, analisar e monitorar a atividade no servidor, gerenciar as tarefas agendadas ou realizar determinadas atividades de manutenção, por exemplo, desmarcar as senhas de conexão de dados salvas. Além disso, existem várias configurações que talvez você queira especificar para personalizar a experiência do usuário para pessoas que usam o servidor. Você pode executar algumas dessas tarefas na página Geral da página Status e de outras páginas da página Configurações.

## Outros artigos nesta seção

<!-- document id=bd1f5f48ba72d1e7cd58ff7b5de4a90c45b0f37daf50e1a4534c0e9e3b00ff97 url=/tableau/current/pt-br/server/ssl_mutual_mapping_username.md -->

[Pular para o conteúdo principal](#main-content)

# Mapeamento de um certificado de cliente para um usuário durante a autenticação mútua

Quando você usa a autenticação de SSL mútuo (de mão dupla), o cliente apresenta seu certificado para o Tableau Server como parte do processo de autenticação. Tableau ServerEm seguida, mapeia as informações de usuário no certificado do cliente para uma identidade de usuário conhecida. A estratégia que o Tableau Server usa para realizar o mapeamento de clientes depende do conteúdo de certificados de cliente na sua empresa.

Este tópico aborda como as informações em um certificado de cliente podem mapear para uma identidade de usuário e como alterar a forma de mapeamento do Tableau Server. Para entender como o mapeamento ocorre e se você precisa alterá-lo, é necessário saber como os certificados de cliente são estruturados na empresa.

- [Opções de mapeamento de nome de usuário](#mapping-options)
- [Alterar o mapeamento de certificado](#changing-cert-mapping)
- [Analisar a ambiguidade de nome de usuário em empresas com vários domínios](#ambiguous-user-names)

## Opções de mapeamento de nome de usuário

O Tableau Server usa uma das seguintes abordagens para mapear um certificado de cliente para uma identidade de usuário:

- **Active Directory**. Se o Tableau Server estiver configurado para usar o Active Directory na autenticação de usuário, quando o Tableau Server receber um certificado de cliente, ele passará o certificado para o Active Directory, que mapeará o certificado para a identidade do Active Directory. Qualquer informação explícita do nome de usuário no certificado é ignorada.
    
    **Observação**: Esta abordagem exige que os certificados do cliente sejam publicados para as contas de usuário no Active Directory.
- **Nome de usuário principal (UPN)**. Um certificado de cliente pode ser configurado para armazenar o nome de usuário no campo de nome de usuário principal. O Tableau Server lê o valor de UPN e usa-o para mapear um usuário no Active Directory ou para um usuário local.
- **Nome comum (CN)**. Um certificado de cliente pode ser criado para armazenar o nome de usuário no campo de nome comum do certificado. O Tableau Server lê o valor de CN e mapeia-o para usuário no Active Directory ou para um usuário local.

Se você configurar o servidor para a autenticação do Active Directory e o mapeamento do nome de usuário UPN ou CN, coloque o nome do usuário em um dos seguintes formatos:

`username`, `domain/username` ou `username@domain`.

Por exemplo: `jsmith`, `example.org/jsmith` ou `jsmith@example.org`.

Se o servidor usar a autenticação local, o formato do nome nos campos UPN ou NC não é predeterminado, mas o nome no campo deve corresponder a um nome de usuário no servidor.

## Alterar o mapeamento de certificado

Use os comandos [tsm authentication mutual-ssl <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMMutualSSL) para mapear um certificado de cliente para uma identidade de usuário no Tableau Server: 

`tsm authentication mutual-ssl configure -m <value>`

Os valores possíveis são `ldap` para o mapeamento do Active Directory, `upn` para o mapeamento de UPN ou `cn` para o mapeamento de CN.

Ao instalar e configurar o Tableau Server pela primeira vez, o servidor define o mapeamento de nome de usuário padrão para corresponder com o tipo de autenticação do servidor:

- Se o servidor estiver configurado para usar o Active Directory, também usará o Active Directory para mapear o certificado para a identidade de usuário.
- Se o servidor estiver configurado para usar a autenticação local, ele obterá o valor de nome de usuário do campo UPN no certificado.

Se o comportamento padrão de como o Tableau Server mapeia um nome de usuário para uma identidade não estiver correto na configuração do servidor, execute o conjunto de comandos a seguir para alterar o mapeamento e usar o valor CN:

`tsm authentication mutual-ssl configure -m cn`

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

## Analisar a ambiguidade de mapeamento do nome de usuário em empresas com vários domínios

Em algumas circunstâncias, o nome de usuário em um campo UPN ou CN pode ser ambíguo. Essa ambiguidade pode levar a resultados inesperados quando o nome de usuário for mapeado para uma identidade de usuário no servidor.

Por exemplo, se o Tableau Server for apresentado com um nome de usuário que não inclui um domínio, o servidor mapeará o nome do usuário para uma identidade usando o domínio padrão. Isso pode causar um mapeamento incorreto do nome de usuário, potencialmente atribuindo a um usuário uma identidade e permissões de usuário diferentes.

Isso pode ocorrer particularmente em ambientes onde as seguintes condições são aplicáveis:

- Sua organização é compatível com vários domínios do Active Directory.
- O servidor está configurado para usar a autenticação do Active Directory.
- O servidor está configurado para usar mapeamento de UPN ou CN.
- Alguns usuários têm o mesmo nome de usuário, mas diferentes domínios. Por exemplo, `jsmith@example.org` e `jsmith@example.com`.
- O nome de usuário nos campos UPN ou CN do certificado não inclui o domínio como parte do nome de usuário, por exemplo, ele mostra `jsmith`.

Para evitar o mapeamento incorreto do nome de usuário, verifique se os certificados do cliente incluem nomes de usuário totalmente qualificados com o domínio, no formato`jsmith@example.org` ou `example.org/jsmith`.

<!-- document id=7f88d13813efaa63328685d1610cf495caa939d97b1f9b59ef216598fc854031 url=/tableau/current/pt-br/server/migrate_server_to_server.md -->

[Pular para o conteúdo principal](#main-content)

# Migrações de servidor para servidor

Os tópicos nesta seção fornecem informações sobre a migração entre hardware, sistema operacional e plataformas de nuvem pública para Tableau Server.

Para migrar um site de um Tableau Server para outro, consulte [Exportar ou importar um site](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm).

Para copiar ou migrar conteúdo entre projetos do Tableau Server usando o Content Migration Tool do Tableau, consulte [Sobre Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-intro.htm).

## Outros artigos nesta seção

<!-- document id=6c015e68ee2ea19e5b6ae5e8760ef1dd0004f48bc61ce44fe46c82189002efb5 url=/tableau/current/pt-br/server/migrate.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar

Os tópicos desta seção descrevem como migrar do Tableau Server para o Tableau Cloud. Os tópicos aqui também abrangem cenários de migração do Tableau Server para o Tableau Server.

Procurando o Tableau Server no Linux? Consulte [Migrar](https://help.tableau.com/current/server-linux/pt-br/migrate.htm "Abre o tópico em uma nova guia do navegador").

## Outros artigos nesta seção

<!-- document id=86e0c0cc9af5daf2073747da4fa60afa8a871c8095926971bea30d7982787fd8 url=/tableau/current/pt-br/server/licensing_migrate_from_core.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar do licenciamento baseado em núcleo para o licenciamento baseado em função

Você pode migrar o Tableau Server de uma métrica de licença baseada em núcleo (que conta os núcleos do processador no qual o Tableau Server está instalado) para uma métrica de licença baseada em função (que conta os usuários nomeados). Para obter mais informações sobre as métricas de licenciamento, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm#Licensing%20Overview).

## Preparar para migração para licenciamento baseado em função

As licenças baseadas em núcleo permitem um número de usuários ilimitado, incluindo contas de visitante de apenas exibição. Cada usuário possui uma função de site ao ser adicionado ao Tableau Server, e esses usuários e funções são mantidos quando a licença é alterada. Como as licenças baseadas em função limitam o número de usuários, é necessário garantir que as novas licenças baseadas em função acomode o número de usuários atualmente conectados ao Tableau Server, incluindo os que usam contas de visitante no momento.

> [!IMPORTANT]
> 
> caso as novas licenças baseadas em função não acomodem o número total de usuários, alguns deles serão movidos para a função no site de **Não licenciado**, que pode consumir muita CPU. Se você tiver um grande número de usuários, os processos do servidor de aplicativos podem ficar indisponíveis até que todos os usuários sejam processados. Esta operação pode levar horas para ser concluída, portanto, planeje adequadamente.

Antes de migrar, verifique se você tem licenças de usuário e chaves do produto correspondentes para permitir que todos os usuários acessem o Tableau Server após a conclusão da migração:

- Faça logon no [Portal do Cliente do Tableau](http://customer.tableausoftware.com/) para verificar licenças e copiar as chaves do produto correspondentes.
- Para saber mais sobre as funções que os usuários exercem no site, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).
- Para contar o número de usuários na instalação do Tableau Server, exporte uma lista de usuários para contá-los com uma ferramenta como o Microsoft Excel. Para saber mais sobre como exportar uma lista de usuários, consulte [Exportar uma lista de usuários](http://kb.tableau.com/articles/howto/exporting-user-list?lang=pt-br).
- Para reduzir a carga de CPU, remova os usuários que não existem ou que não precisam de acesso mais do seu ambiente antes de migrar.
- Se você estiver usando Active Directory e usuários não licenciados permanecerem no servidor, desativar a sincronização para a migração pode impedir que as licenças sejam concedidas automaticamente aos grupos sincronizados.

## Migrar para licenciamento baseado em função

Para migrar para o licenciamento baseado em função, é necessário interromper o Tableau Server, desativar a chave do produto baseada no núcleo, ativar as chaves do produto baseadas em função e, em seguida, iniciar o Tableau Server. Como esse processo resultará em uma reinicialização do Tableau Server e causará um tempo de inatividade para os usuários do Tableau Server, é necessário migrar o licenciamento durante um período de baixo uso.

1. Interrompa o Tableau Server:
    
    Use o comando [`tsm stop`](https://help.tableau.com/current/server-linux/pt-br/cli_stop_tsm.htm).
2. Desativar as chaves do produto baseadas em núcleo:
    
    Use o comando [`tsm licenses deactivate`](https://help.tableau.com/current/server-linux/pt-br/cli_licenses_tsm.htm#TSMDeactivate) com as chaves do produto baseadas em núcleo.
3. Ativar as chaves do produto baseadas em função:
    
    Use o comando [`tsm licenses activate`](https://help.tableau.com/current/server-linux/pt-br/cli_licenses_tsm.htm#TSMActivate) com as chaves do produto baseadas em função.
4. Inicie o Tableau Server:
    
    Use o comando [`tsm start`](https://help.tableau.com/current/server-linux/pt-br/cli_start_tsm.htm).

## Usar licenças baseadas em função em um servidor com licenciamento baseado em núcleo

A versão 2018.1 do Tableau Server permite adicionar licenças baseadas em função com a função de Creator às instalações do Tableau Server com licenciamento baseado em núcleo.

**Observação:** se você atualizar uma instalação do Tableau Server para 2018.1 sem ativar as licenças baseadas em função, o Tableau Server continuará funcionando da mesma forma que antes, sem alterações na interface do usuário ou nas permissões do Tableau Server, exceto que a função no site de **Viewer** será renomeada para **Somente leitura**. Na versão 2018.2, a função no site de **Somente leitura** ficou obsoleta e se tornou novamente a função no site de **Viewer**.

Quando as licenças de **Creator** são adicionadas ao Tableau Server, todos os usuários de Administrador do servidor são obrigados a ter funções de licença de **Creator**, o que pode exigir licenças adicionais. Os administradores podem ativar licenças adicionais de **Creator** usando o comando `tsm licenses activate` no Tableau Server para aumentar a capacidade do usuário licenciado. A ativação dessas licenças baseadas em função fornece uma combinação dos recursos concedidos pelas licenças baseadas em função de Creator e daqueles concedidos pela licença baseada em núcleo. Para saber mais sobre os diferentes tipos de licenças baseadas em função, consulte [Licenças baseadas em função](https://help.tableau.com/current/server/pt-br/license_server_overview.htm#user-based).

**Observação:** o número de usuários ilimitados com acesso total ao Tableau Server sob o licenciamento baseado em núcleo tem recursos equivalentes aos usuários com uma licença de **Explorer** com licenciamento baseado em função. A funcionalidade de **Creator** é limitada aos modelos de licença de usuário definidos.

Por exemplo, se uma instalação do Tableau Server tiver uma licença de 16 núcleos que inclua acesso de visitante e você adicionar chaves de licença Updatable Subscription License (USL) com 10 licenças de Creator, esse servidor terá os seguintes recursos:

- Um limite de 16 núcleos de processadores no hardware que executa o Tableau Server
- Acesso de visitantes
- As licenças de Explorer/Viewer ilimitadas (das licenças de usuário ilimitadas fornecidas com uma licença de núcleo)
- 10 licenças de Creator

### Exemplo de conclusão de uma migração do licenciamento baseado em núcleo

Para reforçar o exemplo acima: se a licença baseada em núcleo foi desativada, os seguintes recursos estarão disponíveis:

- Não há limites no hardware do servidor
- Sem acesso de visitantes
- 10 licenças de Creator

Se você adicionasse 50 licenças de Explorer e 200 de Viewer, após desativar a licença baseada em núcleo, os seguintes recursos estariam disponíveis:

- Não há limites no hardware do servidor
- Sem acesso de visitantes
- 10 licenças de Creator
- 50 licenças de Explorer
- 200 licenças de Viewer

<!-- document id=2a40a956e3245e17d97f913b3022db9ad2952f52d9b21ac7ab5eb041dda7d2c3 url=/tableau/current/pt-br/server/migrate_on-prem_to_cloud.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar o Tableau Server de um computador local para uma VM na nuvem

Você pode migrar o Tableau Server de um computador em seu data center para uma máquina virtual (VM) na nuvem. Como parte desta migração, você precisará mover vários dados e configurações do Tableau Server do computador local para uma VM na nuvem onde o Tableau Server está instalado.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

### Pré-requisitos

Antes de migrar o Tableau Server de um computador local para uma VM na nuvem, certifique-se de revisar os seguintes pré-requisitos:

- Ter uma conta e um ambiente configurados no seu provedor de nuvem. Para obter mais informações, consulte:
    - [Instalar o Tableau Server na Amazon Web Services](https://help.tableau.com/current/server/pt-br/ts_aws_welcome.htm)
    - [Instalar o Tableau Server no Google Cloud Platform](https://help.tableau.com/current/server/pt-br/ts_gcp_welcome.htm)
    - [Instalar o Tableau Server no Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_welcome.htm)
    - [Instalar o Tableau Server na Alibaba Cloud](https://help.tableau.com/current/server/pt-br/ts_alibaba_welcome.htm)
- Leia [Preparação para a atualização](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare.htm) e [Backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm) para se preparar para a migração.

### Para migrar o Tableau Server para uma VM na nuvem

1. Verifique se não há tarefas em segundo plano em execução, como as atualizações de extração, a publicação da pasta de trabalho etc. Quando o Tableau Server estiver ocioso, observe os tipos de conexão de fonte de dados em uso para que você possa instalar os drivers apropriados na nova VM do Tableau Server na nuvem.
2. Pare o Tableau Server. Em um prompt de comando, digite:
    
    [`tsm stop`](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm)
3. Depois que o Tableau Server for interrompido, faça um backup completo, seguindo as etapas em [Preparação para a atualização](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare.htm) e [Backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm). O backup é o que você usa para restaurar seus dados do Tableau Server. Você usará esse backup para restaurar os dados do Tableau Server na VM na nuvem.
4. Mova o backup do servidor e armazene o backup com segurança. Por exemplo, você pode armazenar seu backup no armazenamento em nuvem, como Amazon S3, Google Drive etc.
5. Se você estiver utilizando SSL no servidor local, faça uma cópia da pasta SSL. Lembre-se de anotar todas as regras de segurança, por exemplo, regras de firewall, portas etc. para evitar problemas de comunicação entre diferentes elementos da infraestrutura e do novo Tableau Server na VM na nuvem.
6. Remova quaisquer entradas DNS usando o endereço IP do Tableau Server local, para que você possa reatribuí-las ao Tableau Server na VM na nuvem.
7. Inicie uma VM na nuvem que atenda às recomendações do Tableau Server.
8. Instale o Tableau Server na VM na nuvem. Para obter mais informações, consulte:
    - [Instalar o Tableau Server na Amazon Web Services](https://help.tableau.com/current/server/pt-br/ts_aws_welcome.htm)
    - [Instalar o Tableau Server no Google Cloud Platform](https://help.tableau.com/current/server/pt-br/ts_gcp_welcome.htm)
    - [Instalar o Tableau Server no Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_welcome.htm)
    - [Instalar o Tableau Server na Alibaba Cloud](https://help.tableau.com/current/server/pt-br/ts_alibaba_welcome.htm)
9. Após a conclusão da instalação, copie todos os arquivos SSL para o Tableau Server na VM na nuvem e restaure o backup no novo servidor.
10. Configure o Tableau Server na VM na nuvem e instale tudo o que estiver relacionado ao SSH e à porta.
    
    **Observação:** se você alterar o endereço IP/porta do banco de dados, talvez seja necessário atualizar todas as informações de conexão.
11. Copie o arquivo de backup _.tsbak_ na localização de pasta especificada pela variável `basefilepath.backuprestore`. Por padrão, é: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\`
    
    **Observação:** é possível alterar a localização do arquivo de backup. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).
12. Em seguida, interrompa Tableau Server. Em um prompt de comando, digite:
    
    [`tsm stop`](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm)
13. Restaure seus dados em produção sem informações de configuração para sua nova instalação do Tableau Server. Em um prompt de comando, digite:
    
    `[tsm maintenance restore](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm3) -f <filename>`
    
    em que `<filename>` é o nome do arquivo _.tsbak_ copiado na etapa 11.
    
    Para obter mais informações sobre a restauração de dados do Tableau Server, consulte [Restaurar de um backup](https://help.tableau.com/current/server/pt-br/db_restore.htm).
14. Inicie o servidor. Em um prompt de comando, digite:
    
    [`tsm start`](https://help.tableau.com/current/server/pt-br/cli_start_tsm.htm)
15. **Apenas instalações distribuídas**: instale o Tableau Server nos novos computadores que deseja adicionar ao novo cluster do Tableau Server na nuvem. Para obter mais informações, consulte:
    - [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm)
    - [Autoimplantação do Tableau Server na AWS em um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_aws_multiple_server.htm)
    - [Autoimplantar o Tableau Server no Google Cloud Platform em um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_gcp_multiple_server.htm)
    - [Autoimplantação do Tableau Server no Microsoft Azure em um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_azure_multiple_server.htm)
    - [Autoimplantar o Tableau Server na Alibaba Cloud em um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_alibaba_multiple_server.htm)
16. Teste seu Tableau Server na VM na nuvem para garantir que ele funcione conforme esperado. Se o seu Tableau Server estiver funcionando bem na nuvem, você poderá desativar a chave do produto Tableau Server local e usar a mesma chave do produto para ativar o Tableau Server na VM na nuvem.
    
    **Observação**: caso não tenha uma conexão com a Internet, você deve criar um arquivo de ativação offline para concluir o processo de desativação. Para obter mais informações, consulte [Desativar o Tableau Server offline](https://help.tableau.com/current/server/pt-br/deactivate_off.htm).
17. A mesma chave do produto do Tableau Server pode ser ativada três vezes: uma vez para um ambiente de produção, uma vez para um ambiente de teste e uma vez para um ambiente de QA. Depois de testar a sua nova instalação do Tableau Server e confirmar que está pronto para produção, você deve desativar a sua versão de produção anterior do Tableau Server e, em seguida, desinstalá-la. Para desativar a versão anterior, consulte [tsm licenses deactivate](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMDeactivate).
    
    **Observação**: caso não tenha uma conexão com a Internet, você deve criar um arquivo de ativação off-line para concluir o processo de desativação. Consulte [Desativar o Tableau Server offline](https://help.tableau.com/current/server/pt-br/deactivate_off.htm) para ver as etapas.

<!-- document id=7e8b77cba561f59982aab7d611b8d6cbe2d33d672c80d219c32eb95f629d0885 url=/tableau/current/pt-br/server/restore_from_backup_linux.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar o Tableau Server do Windows para o Linux

Os clientes que executam o Tableau Server no Windows podem migrar para o Linux ao fazer um backup da instalação do Tableau existente e restaurá-lo em uma nova instalação no Linux. Este tópico descreve as etapas necessárias para fazer essa migração. Não é possível migrar ou atualizar de uma versão beta do Tableau Server para uma versão oficialmente lançada.  

As etapas básicas para migrar do Tableau Server no Windows para o Tableau Server no Linux incluem:

1. [Etapa 1: planejar a migração](#PlanMigration)—Planeje a migração, incluindo a coleta de todas as informações de que você precisará para obter sucesso. Durante esta etapa você deve se familiarizar com as diferenças potenciais entre o Tableau Server no Windows e o Tableau Server no Linux.
2. [Etapa 2: criar um backup](#CreateWinBackup)—Crie um backup do Tableau Server no Windows.
3. [Etapa 3: instalar o Tableau Server no Linux e restaurar o backup do Windows](#InstallandRestore)—Instale uma nova instância do Tableau Server no Linux em um ambiente de teste para que você possa testar a migração, depois restaure o backup do Windows. A restauração do backup do Windows restaura o conteúdo do Tableau (usuários, projetos, sites, pastas de trabalho e fontes de dados), mas não restaura personalizações. Assim, será necessário configurar o Tableau Server no Linux para que corresponda às expectativas da sua empresa. Além disso, em cado de uma instalação de vários nós, será necessário adicionar os nós e configurá-los separadamente.
4. [Etapa 4: testar o Tableau Server no Linux](#TestTSLinux)—Teste o Tableau Server no Linux para ter certeza de que o conteúdo está lá como esperado e de que os usuários são capazes de realizar todas as ações que realizavam no Windows. Verifique especialmente qualquer alteração identificada como diferença potencial entre o Tableau Server no Windows e o Tableau Server no Linux. Inclua as partes interessadas principais no teste para aproveitar seu conhecimento e para ajudar a comunicar as alterações futuras.
5. [Etapa 5: instalar o Tableau Server no Linux no seu ambiente de produção e restaurar o backup do Windows](#InstallProd)—Assim que tiver certeza de que o Tableau Server no Linux oferece a funcionalidade de que você precisa, instale o Tableau no seu ambiente de produção no Linux e restaure o backup do Windows.

## Etapa 1: planejar a migração

Uma migração com sucesso do Windows para o Linux exige alguma preparação prévia. É necessáio satisfazer os seguintes requisitos:

- **Repositório de identidades**: Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local. para alterar o Repositório de identidades de um repositório de identidades local para um repositório de identidades externo, consulte [Alterar o Repositório de identidades](https://help.tableau.com/current/server/pt-br/reconfig_change_auth.htm).
- **Administrador do servidor**: é necessário ter a senha de pelo menos uma das contas de usuário com privilégios de Administrador do servidor da implantação de origem do Tableau Server (Windows). O usuário deve ser o mesmo do Administrador do servidor na implantação migrada para o Linux.
- **Instalação nova do Tableau Server para Linux**: ao instalar o Tableau Server no Linux mais tarde neste tópico, assegure-se de usar o mesmo tipo de repositório de identidades que está usando no Windows e de não criar usuários ou conteúdo. Ao restaurar o arquivo de backup do Windows para a implantação do Tableau Server no Linux, todos os dados e o conteúdo do usuário serão substituídos pelo arquivo de backup do Windows.
- **Diferenças entre o Windows e o Linux**: analise as diferenças entre o Tableau Server no Windows e no Linux para que você esteja ciente delas e possa investigá-las no seu ambiente de teste.
    
    - É necessário instalar qualquer fonte personalizada que desejar usar no seu computador Linux, e elas podem renderizar de forma diferente do que no Windows.
    - As opções de conexão do Linux são um subconjunto daquelas disponíveis no Tableau Server no Windows. Analise os tipos de conexão que estão disponíveis e tenha certeza de que os que precisa possuem suporte.

## Etapa 2: criar um backup

Use o TSM para criar o backup.

Se você estiver migrando do Tableau Server no Windows:

1. Faça logon no computador executando o Tableau Server no Windows.
2. Abra um prompt de comando como administrador.
3. Execute o seguinte comando:
    
    tsm maintenance backup -f <filename> -d
    
    Adicione o sinalizador `-d` para incluir a data no nome do arquivo de backup.

Para obter mais informações, consulte [Backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm) na ajuda do Tableau Server no Windows.

## Etapa 3: instalar o Tableau Server no Linux e restaurar o backup do Windows

Em um ambiente de teste, instale o Tableau Server no Linux:

- Instale o Tableau Server para Linux de acordo com o procedimento, [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm). Use o mesmo repositório de identidades do que na sua implantação do Windows e não crie usuários ou conteúdo.

Restaure o backup do Tableau Server no Windows:

1. Copie o arquivo de backup do Windows para o computador executando o Tableau Server no Linux. Por padrão, o processo de restauração procurará o arquivo neste local:
    
    É possível alterar a localização. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).
2. Execute o seguinte comando para interromper o Tableau Server:
    
    `tsm stop`
3. Execute o seguinte comando para restaurar a partir do arquivo de backup:
    
    `tsm maintenance restore -f <filename.tsbak>`
    
    No qual `<filename.tsbak>` é o nome do arquivo de backup, por exemplo, `tabserver-2017-10-20.tsbak`.
    
    Para obter mais informações, consulte [restauração de manutenção tsm](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm3)
4. Execute o seguinte comando para iniciar o Tableau Server:
    
    `tsm start`

Após restaurar o conteúdo do Tableau, pode ser necessário configurar o Tableau Server. Por exemplo, se você estiver migrando de uma instalação de vários nós, será necessário adicionar e configurar os nós adicionais. Também será necessário configurar qualquer personalização que tiver feito no Windows, incluindo copiar arquivos de imagem ou logotipos se aplicável.

## Etapa 4: testar o Tableau Server no Linux

Quando o Tableau Server estiver instalado no Linux e o backup do Windows for restaurado, será possível testar a nova versão do Tableau Server. Já que o processo de restauração só restaura conteúdo no Tableau, é necessário atualizar a configuração, a topologia (ao adicionar nós adicionais, por exemplo) e qualquer personalização que você tenha na sua instalação do Windows.

Familiarize-se com as diferenças conhecidas entre o Windows e o Linux, assim como com qualquer área de problemas em potencial. Teste a funcionalidade básica, junto com qualquer aspecto especial do servidor do qual sua empresa dependa. Por exemplo, pode haver fontes de dados principais que a sua empresa usa com o Tableau. Teste-as para ter certeza de que está visualizando o esperado.

Estas são algumas áreas de teste a considerar:

- **Acesso de usuário**. Confirme se os usuários do Tableau Server, incluindo os administradores, podem fazer logon. Teste seu processo normal de logon de usuário. Peça que alguns de seus usuários participem do teste para ter certeza de que eles conseguem se conectar como esperado e que eles possam acessar o mesmo conteúdo ao qual têm acesso em seu ambiente de produção.
- **Exibição de exibições administrativas integradas**. Nesta versão do Tableau Server no Linux, é necessário instalar os drivers do PostgreSQL manualmente e as exibições administrativas dependem deles. Confirme ter instalado os drivers necessários ao acessar as exibições administrativas integradas. Para obter mais informações, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .
- **Disponibilidade da fonte de dados.** O Tableau Server no Linux oferece suporte a um subconjunto de fontes de dados do Tableau Server no Windows. É necessário confirmar se as fontes de dados usadas pela sua empresa possuem suporte no Linux e instalar qualquer driver necessário. Para obter detalhes de quais fontes de dados possuem suporte, consulte as [Especificações técnicas do Tableau Server](https://www.tableau.com/pt-br/products/techspecs#server). Para obter informações sobre a instalação de drivers, consulte [Drivers de banco de dados](https://help.tableau.com/current/server/pt-br/dbdriver.htm).
- **Acesso às fontes de dados baseadas em arquivos em drives compartilhados**. Fontes de dados como arquivos do Excel em drives de rede exigirão ações especiais para serem acessíveis no Linux. Você ou seu departamento de TI precisarão montar os drives e atualizar qualquer pasta de trabalho que use essas fontes de dados. Para obter mais informações sobre a conexão às unidades de rede, consulte a [Comunidade do Tableau](https://community.tableau.com/s/question/0D54T00000G54qOSAR/tableau-server-on-linux-connecting-to-a-windows-shared-directory).
- **Visualização de pastas de trabalho publicadas**. Peça que os usuários que tenham familiaridade com o conteúdo tentem visualizar as pastas de trabalho publicadas para ter certeza de que elas são exibidas como esperado. Teste as exibições incorporadas a páginas da Web (por exemplo, em páginas do SharePoint). Esteja especialmente ciente de como as fontes podem diferir no Windows e no Linux, e algumas fontes personalizadas podem precisar ser adicionadas ao seu computador Linux ou substituídas por outras fontes se não estiverem disponíveis no Linux. Layouts de painel podem parecer diferentes também devido às diferenças de fontes.
- **Processos de servidor**. Faça logon no Tableau Server como administrador de servidor e depois abra a página Status do servidor para confirmar se todos os serviços e processos estão funcionando como esperado. Esteja ciente das alterações propositais devido às alterações na versão 10.5. Para obter mais informações, consulte [Processador de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_engine2_intro.htm).
- **Publicação de pastas de trabalho e fontes de dados**. Peça que usuários publiquem pastas de trabalho e fontes de dados do Tableau Desktop para certificar-se de que isso aconteça como esperado. Pode ser necessário instalar drivers para oferecer suporte às conexões com as fontes de dados que você usa. Consulte [Drivers de banco de dados](https://help.tableau.com/current/server/pt-br/dbdriver.htm).
- **Inscrições e atualizações de extração**. Execute manualmente algumas atualizações de extração para confirmar que elas são concluídas com êxito. Execute algumas atualizações de extração importantes agendadas para confirmar se elas são concluídas como esperado.
- **Permissões**. Confirme se as permissões ainda estão definidas como esperado para usuários e conteúdo.
- **Utilitários da linha de comando e APIs**. Se aplicável, teste os utilitários de linha de comando (TSM e tabcmd) e o acesso programático por APIs.

## Etapa 5: instalar o Tableau Server no Linux no seu ambiente de produção e restaurar o backup do Windows

Ao concluir os testes e identificar as áreas que exigem alterações adicionais da sua parte ou comunicação com os usuários, você está pronto para instalar o Tableau Server no Linux no seu ambiente de produção e restaurar o backup do Windows. Para fazer isso, siga as mesmas etapas descritas acima.

<!-- document id=af777a17081b1db9d49804ad6a2f79105605d81f8effd04177749a09de131dab url=/tableau/current/pt-br/server/upgrade_migrate.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar para novo hardware

Use o procedimento a seguir para migrar o Tableau Server de um computador para outro. Você pode fazer isso se estiver atualizando o hardware do computador em que o Tableau está em execução.

Mais especificamente, essas etapas descrevem como mover dados do Tableau Server de seu computador em produção para um novo computador no qual a versão do Tableau Server está instalada. Antes de iniciar, verifique se você seguiu as etapas em [Preparação para a atualização](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare.htm), inclusive a criação de um backup e a coleta de todos os ativos que exigem ações manuais. Para obter detalhes, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm). Você precisará disso para restaurar os dados e a configuração do Tableau Server.

Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

1. Desative a chave do produto na instalação original do Tableau Server. Você precisa fazer isso para poder ativá-la no computador novo. Para obter mais informações, consulte "Ativação da chave do produto do Tableau Server" abaixo.
2. Instale o Tableau Server no novo computador, ative a licença, faça as configurações iniciais e crie o usuário administrador. Para obter detalhes, consulte [Instalação e configuração do Tableau Server](https://help.tableau.com/current/server/pt-br/install_config_top.htm).
3. Copie o arquivo de backup _.tsbak_ na localização de pasta especificada pela variável `basefilepath.backuprestore`. Por padrão, é: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\`.
    
    **Observação:** é possível alterar a localização do arquivo de backup. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).
4. Em seguida, interrompa o Tableau Server:
    
    `tsm stop`
5. Restaure seus dados em produção para sua nova instalação do Tableau Server usando o comando `[tsm maintenance restore](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm3)`:
    
    `tsm maintenance restore -f <filename>`
    
    em que `<filename>` é o nome do arquivo _.tsbak_ copiado na etapa 3.
    
    Para obter mais informações sobre a restauração de dados do Tableau Server, consulte [Restaurar de um backup](https://help.tableau.com/current/server/pt-br/db_restore.htm).
6. Inicie o servidor:
    
    `tsm start`
7. **Apenas instalações distribuídas**: instale o Tableau Server nos novos computadores que deseja adicionar ao novo cluster do Tableau Server. Consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm) para obter as etapas.
8. Se você não desativou a chave do produto no computador antigo, faça isso após testar a nova instalação do Tableau Server e confirme que está pronto para produção. Para obter detalhes, consulte "Ativação da chave do produto do Tableau Server" abaixo.
    
    **Observação**: caso não tenha uma conexão com a Internet, você deve criar um arquivo de ativação offline para concluir o processo de desativação. Consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm) para ver as etapas.

## Ativação da chave do produto do Tableau Server

Você pode ativar a mesma chave do produto do Tableau Server até três vezes. Isso permite testar o Tableau Server (por exemplo, em ambientes de área restrita ou de controle de qualidade), além de usar o Tableau na produção. Para maximizar suas ativações, desative a chave do produto ao remover o Tableau Server de um computador, a menos que esteja reinstalando o Tableau no mesmo computador. Isso faz com que você possa usar a ativação em um computador diferente. Por exemplo, se você mover o Tableau Server de um computador ou VM para outro, desative a chave do produto e remova o Tableau do computador original. Ao instalar o Tableau no novo computador, você pode ativar a chave nele sem conflitos. Caso use o licenciamento baseado em função, certifique-se de ativar uma chave de Creator ou Explorer ou você poderá perder o acesso de administrador ao Tableau. Se você estiver removendo o Tableau Server para reinstalá-lo no mesmo computador, não precisará desativar a chave. O Tableau usará a chave ao reinstalar. Por exemplo, se você estiver movendo o Tableau de uma unidade em um computador para uma unidade diferente no mesmo computador. Para obter mais informações sobre como desativar uma chave do produto, consulte [tsm licenses deactivate](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMDeactivate).

<!-- document id=38143fc78368309032d6c4639f5fb4422eb5dbd8f88da2c3d8be72a70fad3db4 url=/tableau/current/pt-br/server/cmt-migration_embedded_credentials.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar pastas de trabalho e fontes de dados com credenciais inseridas

A partir da versão 2023.1, os usuários autorizados podem migrar pastas de trabalho e fontes de dados publicadas com credenciais inseridas de Tableau Server para Tableau Cloud. A configuração adicional é necessária antes de migrar com Content Migration Tool.

**Observação:** Content Migration Tool não oferece suporte à migração de credenciais inseridas para conexões OAuth. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

## Visão geral

Migrando credenciais inseridas usando Content Migration Tool (CMT) está disponível ao conectar o Tableau Server como o local de origem e Tableau Cloud como o local de destino. Os dois locais devem ter uma licença de [Gerenciamento avançado](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

Agora que abordamos os requisitos, vamos discutir como a migração funciona. Você precisará trabalhar de perto com o administrador do site Tableau Cloud e administrador do TSM (às vezes a mesma pessoa) para permitir o recurso e autorizar um usuário do site. Depois que o recurso é ativado, o usuário autorizado do site cria um plano de migração e seleciona as opções de publicação _Migrar credenciais inseridas para pastas de trabalho_ e _Migrar credenciais inseridas para fontes de dados_.

Ao executar o plano de migração, todas as credenciais de conteúdo necessárias são transmitidas em um manifesto de conteúdo criptografado de Tableau Server para Tableau Cloud. À medida que o CMT publica conteúdo, o local do Tableau Cloud de destino insere credenciais correspondentes com segurança do manifesto no conteúdo (pastas de trabalho ou fontes de dados publicadas). Quaisquer problemas que ocorram durante a migração aparecerão na guia Erros e avisos no CMT. Para obter mais informações, consulte o [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm).

## Permitir migração de credenciais inseridas

Use as etapas a seguir para permitir a migração de credenciais inseridas de Tableau Server para Tableau Cloud.

### Tableau Cloud

1. Abra uma janela do navegador e entre no Tableau Cloud como administrador do site.
2. Selecione Configurações > Geral e role para baixo até Gerenciar migração de conteúdo.
    
    ![Gerencie a interface de chaves de criptografia de migração de conteúdo com opções para criar novas chaves.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-manage-content-migration.png)
3. Clique em Criar nova chave para gerar um par de chaves de criptografia.
    
    **Observação:** a chave pública é exibida apenas uma vez. Se você perder a chave antes de concluir a configuração, precisará gerar uma nova chave.
4. Na janela resultante, clique em Copiar para área de transferência e feche a janela.
5. Cole a chave pública em um arquivo e armazene-o em um local seguro. O administrador do TSM usará a chave pública para permitir a migração. Você pode visualizar a data de expiração da chave pública na página Configurações.

### Interface de linha de comando de TSM

1. Abra o prompt de comando do Windows com uma conta que seja membro do grupo de Administradores em um nó no cluster.
2. Use `tsm security authorize-credential-migration` para permitir a migração de credenciais inseridas para o site do Tableau Cloud. Para obter mais informações, consulte [tsm security](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm).
    
    `tsm security authorize-credential-migration --source-site-url-namespace <Tableau Server site ID> --destination-site-url-namespace <Tableau Cloud site ID> --destination-server-url <Tableau Cloud site url> --authorized-migration-runner <username> --destination-public-encryption-key <public key>`
    
    **Observação:** ao executar comandos do TSM em de um nó remoto, use `tsm login` para autenticar uma sessão com o serviço Tableau Server Administration Controller antes de executar `tsm security authorize-credential-migration`.
3. (Opcional) Use `tsm security cancel-credential-migrations` para cancelar as autorizações concedidas. Por padrão, a autorização de migração expira em 7 dias ou no número de dias especificado com a opção `--expiration-time-in-days`.

### Content Migration Tool

1. Abra Content Migration Tool e selecione Criar novo plano ou Procurar um plano.
2. Na página Sites, clique em Entrar no Tableau, e conecte-se a Tableau Server como origem e Tableau Cloud como o destino. A migração de credenciais inseridas só está disponível ao migrar de Tableau Server para Tableau Cloud.
3. Crie seu plano de migração e selecione as seguintes opções de publicação:
    
    - Na página Opções de publicação de pasta de trabalho, selecione Migrar credenciais inseridas para pastas de trabalho. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm).
    - Na página Opções de publicação da fonte de dados, selecione Migrar credenciais inseridas para fontes de dados. Para obter mais informações, consulte [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm).
4. Quando estiver pronto, clique em Verificar e executar para iniciar o a migração.

As pastas de trabalho e as fontes de dados publicadas que você selecionou são migradas para o seu site do Tableau Cloud e não deve solicitar autenticação. Se você tiver problemas ao migrar credenciais inseridas, consulte [Solução de problemas](#troubleshooting).

## Solução de problemas

Esta seção inclui alguns problemas comuns de migração que você pode encontrar e sugestões para resolvê-los.

### Não há opção para migrar credenciais inseridas

Você só pode migrar credenciais inseridas de um site Tableau Server para um Tableau Cloud. Tableau Server e Content Migration Tool devem estar executando as versões 2023.1 ou posterior. Para obter mais informações, consulte [Instalação do Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-install.htm).

### A migração das credenciais inseridas falhou

Na guia [Erros e avisos](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm) do CMT, você pode receber um erro indicando que a migração das credenciais inseridas falhou. Isso pode ocorrer quando a chave pública usada para autorizar a migração expirou.

Como um administrador do site do Tableau Cloud, vá para a página Configurações e verifique se a chave pública é válida. Você terá que criar um novo par de criptografia para autorizar a migração, se a chave pública expirar. Para obter mais informações, consulte [Permitir a migração de credenciais inseridas](#allow-migration).

## Quem pode fazer isso?

- O administrador do site do Tableau Cloud e o administrador do TSM são necessários para permitir a migração de credenciais inseridas.
- O usuário autorizado do site deve ter uma função Explorer ou superior. Ele também deve ter recursos de Visualizar e Baixar de trabalho/Salvar uma cópia no site de origem e direitos de Publicação no site de destino (recursos Visualizar e Publicar) para projetos de destino no local de destino.

Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=d2a620d564a2d21e3a39307f75416f6042613cd9d58f9615dce74c96e16061ae url=/tableau/current/pt-br/server/cmt-migration_extracts.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar pastas de trabalho e fontes de dados com extrações

Os usuários do Tableau Server podem publicar extrações que são cópias ou subconjuntos dos dados originais. Essas extrações podem ser incorporadas em uma pasta de trabalho ou em uma fonte de dados. Por padrão, quando você usa o Content Migration Tool do Tableau para migrar uma pasta de trabalho ou fonte de dados que contém uma extração, essa extração é migrada junto com a pasta de trabalho ou fonte de dados que a contém. O Content Migration Tool fornece algumas opções para controlar esse comportamento:

- **Alternar para uma conexão ao vivo**
    
    Adicione a transformação Remover extração ao plano de migração para remover a extração da pasta de trabalho ou fonte de dados durante a migração. Como sempre, a pasta de trabalho de origem ou a fonte de dados não será modificada. A cópia da pasta de trabalho ou fonte de dados migrada para o site de destino terá a extração removida dela. Isso alterna a conexão de dados de volta para uma conexão ao vivo.

- **Atualizar extrações após a migração**
    
    Habilite a opção Atualizar extrações após a migração em seu plano de migração para ter uma tarefa de atualização de extração imediata agendada após a pasta de trabalho ou a fonte de dados ser migrada.
    
    Não é recomendável usar a opção Atualizar extrações após a migração se o plano de migração também usar a transformação Definir informações de conexão para apontar para um conjunto de dados diferente (por exemplo, um servidor de banco de dados ou banco de dados diferente). Ao alterar as informações de conexão para apontar para diferentes dados e usar a opção Atualizar extrações após a migração, isso pode expor dados involuntariamente, de uma forma que haja um possível problema de segurança.
    
    Para obter mais informações, consulte [Opção 3: atualizar extrações após a migração](#refresh-after-migration).

#### Alterar conexões de dados que usam extrações

As conexões de dados do Tableau são conexões em tempo real que consultam diretamente uma fonte de dados ou são extrações de uma fonte de dados. As extrações são cópias ou subconjuntos dos dados originais e podem ser incorporadas em uma pasta de trabalho ou fonte de dados. Quando presente, os modos de exibição consultarão dados da extração em vez da fonte de dados subjacente.

Normalmente, você desejará modificar a conexão da fonte de dados durante a migração, para que ela aponte para um banco de dados diferente no servidor de destino do que apontava no servidor de origem.

Por exemplo, se estiver migrando uma pasta de trabalho do site de preparo para o site de produção, provavelmente desejará atualizar as conexões de dados dentro da pasta de trabalho para se conectar ao banco de dados de produção. Implemente isso usando a transformação Definir informações de conexão no plano de migração. Agora você tem um plano de migração que copia uma pasta de trabalho da preparação para a produção e atualiza as conexões de dados para apontar para o banco de dados de produção.

Se sua pasta de trabalho usar uma extração, será necessário trabalho adicional. Nesse cenário, a pasta de trabalho será migrada e a conexão de dados ao vivo atualizada. No entanto, as exibições ainda mostrarão dados do banco de dados de preparo, pois ele ainda contém a extração do banco de dados de preparo - copiado do site de origem (preparado). Há algumas maneiras de fazer isto.

#### Opção 1: usar fontes de dados publicadas

Altere as pastas de trabalho para que elas usem fontes de dados publicadas. Dessa forma, a extração será gerenciada como parte da fonte de dados publicada, e a migração de atualizações para as pastas de trabalho que usam essa fonte de dados poderá ser simplificada ao não ter que se preocupar com a conexão ao banco de dados dinâmico ou à extração de dados.

#### Opção 2: remover a extração durante a migração

Adicione uma transformação Remover extração ao plano de migração. Isso removerá a extração da pasta de trabalho, alternando a fonte de dados para uma conexão em tempo real.

#### Opção 3: atualizar a extração após a migração

Use a opção Atualizar extrações após a migração do seu plano de migração. Isso migrará a extração junto com a pasta de trabalho, mas agendará uma tarefa de atualização de extração imediata para essa pasta de trabalho após a concluir a migração.

Essa opção geralmente não é recomendada quando usada em combinação com uma transformação Definir informações de conexão devido a possíveis problemas de segurança que podem ser apresentados.

O problema é que a pasta de trabalho migrada no on your site de destino ainda mostrará os dados de extração (origem) antigos do período entre a conclusão da migração e a conclusão da tarefa de atualização da extração. Se a tarefa de atualização de extração falhar, os dados de extração/de origem antigos permanecerão até que a extração seja atualizada.

Em um cenário como descrito acima, migrar de um ambiente de preparação para de produção, isso pode ser aceitável, mas você deve estar ciente de que os usuários das pastas de trabalho talvez não estejam cientes de que a pasta de trabalho está mostrando dados antigos/de preparação porque ela já foi migrada e a extração ainda não foi atualizada.

Em outros cenários, em que você pode usar Definir informações de conexão para alterar conexões de dados e apontar para um conjunto diferente de clientes os dados de cliente, isso pode gerar sérios problemas de segurança, em que a extração da pasta de trabalho contém dados de um cliente diferente até que a extração tenha sido atualizada após a migração.

Uma maneira de solucionar esse problema é implementar uma migração de duas etapas. Essa abordagem exige que você crie dois planos de migração, uma para cada etapa descrita abaixo, e garanta que as pastas de trabalho e as fontes de dados tenham uma extração atualizada antes de serem disponibilizadas.

- **Etapa 1:** migre o conteúdo para um projeto no site de destino ao qual apenas os administradores tenha acesso. Essa migração permite usar a opção Atualizar a extração após a migração junto com a transformação Definir informações de conexão para atualizar a conexão de dados, pois nenhum usuário não autorizado terá uma oportunidade de visualizar os dados antigos, mesmo se a atualização de extração falhar.
- **Etapa 2:** ao concluir a etapa 1 e confirmar que há uma atualização de extração bem-sucedida, execute um segundo plano de migração para migrar o conteúdo do destino da etapa 1 para o destino final, no qual ele fica visível para os usuários finais.

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=d430401544d8550844a92c2a9b8907b13b7fd9333e20c58cd92b5895c7409d39 url=/tableau/current/pt-br/server/migrate_server_to_cloud.md -->

[Pular para o conteúdo principal](#main-content)

# Migrar Tableau Server para Tableau Cloud

Para obter informações sobre a migração do Tableau Server pequeno (menos de 100 usuários) para a nuvem, consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

Para obter informações sobre como planejar uma mudança para o Tableau Cloud, consulte [Blueprint do Tableau: migrar o Tableau para a nuvem](https://help.tableau.com/current/blueprint/pt-br/bp_move_to_cloud.htm).

## Outros artigos nesta seção

<!-- document id=fa213b12a223ff4b0fddb44cd0502e0de15e66da7a199914b9cc67de119663fe url=/tableau/current/pt-br/server/monitor_server.md -->

[Pular para o conteúdo principal](#main-content)

# Monitoramento do Tableau Server

Configure o SMTP e os alertas e assinaturas para auxiliar no monitoramento do Tableau Server.

## Outros artigos nesta seção

<!-- document id=c5e2e4b3128615b01a3958b651ed992e31be039237b59c145b279313802cb162 url=/tableau/current/pt-br/server/prep_conductor_monitor_flow.md -->

[Pular para o conteúdo principal](#main-content)

# Monitorar integridade e desempenho do fluxo

Depois de publicar fluxos do Tableau Prep e agendá-los para serem executados periodicamente, você quer saber que eles estão sendo executados conforme esperado e solucionar problemas. Além disso, você deseja monitorar, solucionar problemas e entender o desempenho dos seus fluxos.

Precisa de ajuda para solucionar problemas no fluxo? Consulte [Solucionar problemas no Tableau Prep Builder](https://help.tableau.com/current/prep/pt-br/prep_troubleshoot.htm).

Este tópico descreve os vários métodos que o Tableau Server fornece para ajudar você a monitorar e solucionar problemas dos fluxos do Tableau Prep.

## Detectar problemas conforme eles ocorrem e solucioná-los

Configure o Tableau Server para enviar notificações por e-mail quando os fluxos falharem ou localizar e analisar erros no Tableau Server usando o menu Alertas ou ao revisar as páginas de fluxo dos fluxos que você está interessado. Esse tipo de monitoramento permite detectar problemas à medida que ocorrem.

### Receber notificações quando um fluxo falhar:

Você pode configurar o Tableau Server para enviar notificações sobre falha de fluxo por e-mail, no site do Tableau ou no Slack. Para configurar notificações do Tableau Server e de sites, siga as instruções na [Etapa 2: Configurações de fluxo para o Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_server_site_settings.htm#Step_3:_Configure_Server_event_notification_for_flow_failures).

### Ver e solucionar erros

**Observação**: a partir da versão 2020.4.1, você pode criar e editar fluxos diretamente no Tableau Server e no Tableau Cloud. O conteúdo desta seção se aplica a todas as plataformas, a não ser se for indicado de outra forma. Para obter mais informações sobre os fluxos de criação na Web, consulte [Tableau Prep na Web](https://help.tableau.com/current/server/pt-br/prep_web_auth.htm).

Os erros a seguir podem ocorrer ao executar um fluxo:

- **Erros de conexão:** os erros de conexão geralmente acontecem quando o Tableau Server não consegue se conectar a uma ou mais entradas de dados ou não consegue fazer uma conexão em uma ou mais etapas de saída.
    
    - Para erros de conexão de entrada, use a opção Editar conexões, na guia Conexões para fazer alterações nos detalhes da conexão e, em seguida, execute o fluxo novamente.
    - Para erros de conexão de saída, verifique o local de saída das etapas de saída de fluxo. Se a saída do fluxo for um compartilhamento de rede, verifique se as etapas de saída estão apontando para um local seguro. Depois de fazer qualquer alteração, publique novamente o fluxo e tente executá-lo novamente.
        
        **Observação**: para corrigir erros de conexão de saída para fluxos que são de saída para um arquivo ou compartilhamento de rede, baixe o fluxo para Tableau Prep Builder, em seguida, republique-o para o seu servidor. Fluxos que são publicados em uma fonte de dados ou banco de dados publicados podem ser editados diretamente na Web.
- **Erros no fluxo:** se houver erros em uma ou mais etapas do fluxo, você verá uma mensagem de erro. Você pode editar o fluxo diretamente na Web e republicá-lo. Também é possível baixar o fluxo para o Tableau Prep Builder, solucionar os erros, republicar o fluxo no servidor e executá-lo novamente.
- **Tarefas de fluxo suspensas:** quando uma tarefa de fluxo agendada não é executada depois de um número determinado de tentativas, ela é suspensa. Por padrão, uma tarefa de fluxo é suspensa após 5 falhas consecutivas de tarefas de fluxo.
    
    Um fluxo pode ter várias tarefas agendadas atribuídas a ele, mas apenas as tarefas com falha são suspensas. Todas as outras tarefas de fluxo continuarão a ser executadas, a menos que tenham erros. Para solucionar uma tarefa suspensa, revise e resolva os erros, execute o fluxo sob demanda ou deixe que o fluxo seja executado automaticamente com base na agenda atribuída.
    
    **Observação:** os administradores do servidor podem configurar o número de tentativas antes que uma execução de fluxo seja suspensa usando a opção de conjunto de configuração tsm. Para obter mais detalhes, consulte [Etapa 5: Configurações opcionais do servidor](https://help.tableau.com/current/server/pt-br/prep_conductor_config_server_optional.htm#Step_7_AutoSuspension).

Você pode visualizar os erros nas seguintes páginas:

#### Página de Visão geral do fluxo

Nesta página você pode ver o status da execução e dos erros mais recentes. Passe o mouse sobre o texto de erro para consultar os detalhes do erro. Se uma tarefa agendada for suspensa, um ícone de aviso será exibido ao lado da agenda. Passe o cursor sobre o ícone para exibir o status.

Depois de solucionar o erro que causou a falha do fluxo ou a tarefa a ser suspensa, você pode executar o fluxo manualmente ou permitir que o fluxo seja executado com base no agendamento atribuído. Para tarefas de fluxo suspensas, clique no link Ir para a Tarefa agendada na dica de ferramenta da tarefa suspensa para navegar até a página Tarefas agendadas e clique no botão Continuar tarefas agendadas para retomar as tarefas suspensas.

![Um fluxo de processo para um conjunto de dados intitulado "Tableau Prep Crane" exibe uma mensagem de erro: "Falha na atualização incremental na etapa 'Saída'".](/tableau/current/pt-br/server/pt-br/Img/prep_server_overview_error.png)

#### Página Conexões

A página **Conexões** mostra o status mais recente e quaisquer erros de conectividade relacionados. Para corrigir erros de entrada, clique no menu Mais ações![A opção de menu Mais opções representada por 3 pontos.](/tableau/current/pt-br/server/pt-br/Img/prep_server_rmoremenu.png) para uma obter conexão de entrada para editar a conexão e alterar o nome do servidor, porta, nome de usuário e senha.

Para corrigir erros de conexão de saída, edite o fluxo diretamente ou baixe-o no Tableau Prep Builder, corrija o caminho do arquivo e republique o fluxo para continuar a executá-lo.

![Detalhes da conexão com uma mensagem de erro informando "Nome de usuário ou senha incorreta".](/tableau/current/pt-br/server/pt-br/Img/prep_server_connections_error.png)

#### Página Tarefas agendadas

**Observação**: é necessário ver esta guia Data Management.

Ver as tarefas agendadas atribuídas a um fluxo. Se uma tarefa agendada for suspensa, você verá o status dessas tarefas aqui e poderá retomá-las manualmente a partir desta página. Antes de retomar uma tarefa suspensa, solucione os erros no fluxo.

Detalhes dos erros não são mostrados nesta página, mas você pode consultá-los nas páginas Visão geral ou Histórico de execução. Você também pode clicar nos links na coluna Tipo de agenda para ver os detalhes do que foi programado e editar as tarefas.

Uma tarefa suspensa agendada será retomada automaticamente quando o fluxo for republicado, se você editar uma conexão para o fluxo ou se executar manualmente as tarefas de fluxo. Para retomar manualmente uma tarefa suspensa, na página Tarefas agendadas, clique em Retomar tarefas agendadas. Isso retoma todas as tarefas suspensas do fluxo.

Para retomar tarefas individuais, clique no menu Mais ações![A opção de menu Mais opções representada por 3 pontos.](/tableau/current/pt-br/server/pt-br/Img/prep_server_rmoremenu.png) de uma tarefa agendada e selecione Retomar. Além disso, clique em Executar Agora para executar todas as tarefas do fluxo imediatamente.

![Uma lista de tarefas agendadas para um fluxo de dados com seu status.](/tableau/current/pt-br/server/pt-br/Img/prep_linked_tasks_schedule_error.png)

#### Página Histórico de execução

**Observação**: é necessário ver esta guia Data Management.

A página Histórico de execução mostra os detalhes de todas as execuções concluídas ou em andamento para cada saída. Visualize os detalhes do erro ao focalizar com o mouse sobre os erros na coluna **Erros**. A coluna de duração mostra o tempo de execução do fluxo.

**Observação**: a partir da versão 2020.2.1, o campo Tipo de execução mostra o tipo de atualização da saída. Em versões anteriores, este campo mostrava se a saída foi executada em um cronograma ou sob demanda. Para obter mais informações sobre como configurar tipos de atualização de saída, consulte [Atualizar dados de fluxo usando atualização incremental](https://help.tableau.com/current/prep/pt-br/prep_incremental_refresh.htm) .

![Histórico de execução do Tableau Prep.](/tableau/current/pt-br/server/pt-br/Img/prep_server_runhistory.png)

#### Alertas

Quando um fluxo falha, o menu de alertas é preenchido com os detalhes de erro com a opção para executar novamente o fluxo ou baixá-lo para solucionar o problema.

**Observação**: proprietários de fluxo, servidores ou administradores de sites podem ver este menu.

![A caixa de diálogo Alertas mostra detalhes do erro e as opções do menu de alertas para executar novamente o fluxo ou baixar o fluxo para solucionar problemas.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_server_alerts.png)

### Status de processo do Tableau Prep Conductor

- A página de status do Tableau Services Manager (TSM) é acessível no TSM e pode ser visualizada por administradores do TSM. Você deve poder fazer logon no TSM para visualizá-la.
- A página de status do Tableau Server aparece na interface do usuário na Web do Tableau Server e é acessível para administradores do Tableau Server. Se passar o cursor pelo indicador de status de um processo, uma dica de ferramente mostra o nome do nó e a porta onde o processo está sendo executado. A página de status do Tableau Server não mostra os processos do TSM.
    
    ![A página Status do Tableau Server mostra o nome do nó e a porta em que o processo do Tableau Prep Conductor está sendo executado.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_process_status.png)
    
    Quando o Tableau Server estiver funcionando corretamente, o Tableau Prep Conductor será exibido como Ativo ou Ocupado:
    
    - **Ativo**—o processo está funcionando como planejado.
    - **Ocupado** — O processo está concluindo uma tarefa.
    - **Inativo** —o processo está inoperante. As implicações variam, dependendo do processo.
    - **Status indisponível** — O Tableau Server não conseguiu determinar o status do processo.

### Quem pode fazer isso

- **Administradores do Tableau Server**:
    - Configurar notificações por e-mail no nível do servidor
    - Configurar notificações por e-mail para um site
    - Ver erros
    - Retomar tarefas suspensas
    - Ver alertas
    - Ver status de processos
- **Administradores do site do Tableau**:
    - Configurar notificações por e-mail no nível do site
    - Ver erros
    - Retomar tarefas suspensas
    - Ver alertas
- **Proprietários de fluxo, líderes de projeto e qualquer usuário que tenha permissões para visualizar o fluxo**:
    - Ver erros
    - Retomar tarefas suspensas
    - Ver alertas (proprietários de fluxo)

## Outros artigos nesta seção

<!-- document id=0f6ffd1f5522abfef6022e0165a9c5bbdc9136bdb7314a5e536da48a9fdec6d4 url=/tableau/current/pt-br/server/rmt-monitor-tableau-server.md -->

[Pular para o conteúdo principal](#main-content)

# Monitorar o desempenho do Tableau Server

Resource Monitoring Tool do Tableau é usado para monitorar e analisar a integridade e o desempenho do Tableau Server. As métricas de desempenho, uso e hardware são coletadas por meio dos Agentes instalados nos nós do Tableau Server e enviados para o Servidor RMT. Os dados agregados e analisados são exibidos no formulário ou gráficos e as exibições na interface da Web do Servidor RMT.

A interface na Web do Servidor RMT tem gráficos e exibições incorporadas que você pode usar para identificar o que está causando tempos de carregamento lentos, falhas de extração e outros problemas críticos. Para obter mais informações, consulte [Monitore o desempenho do Tableau Server com a Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-charts.htm).

Você também pode baixar os dados usados para criar os gráficos pré-construídos e explorá-los ainda mais. Para obter mais informações, consulte [Explorar dados de monitoramento usando arquivos de fonte de dados do Tableau](https://help.tableau.com/current/server/pt-br/rmt-tds-files.htm).

## Outros artigos nesta seção

<!-- document id=2bfb4268fc7062cd209e9a542dfe2cadf61e1a0778622d30032aa3c34129271e url=/tableau/current/pt-br/server/rmt-charts.md -->

[Pular para o conteúdo principal](#main-content)

# Monitore o desempenho do Tableau Server com a Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau torna mais fácil detectar e resolver problemas de integridade e desempenho nos ambientes do Tableau Server. Uma instância da Resource Monitoring Tool pode fornecer uma única interface unificada para que os administradores monitorem vários Tableau Servers.

O Resource Monitoring Tool consiste em dois componentes:

- Agente, que coleta o uso de recursos e o registro de desempenho de interações no Tableau Server.
- Servidor RMT, que agrega e exibe esses dados de desempenho na forma de gráficos em uma interface da web.

O Resource Monitoring Tool pode não ser capaz de fornecer informações para processos do Tableau Server que são externos:

- Repositório externo: o status do processo não é monitorado e não está incluído nos gráficos
- Armazenamento de arquivo externo: o status do processo não é monitorado e as informações de tamanho do arquivo de extração não são rastreadas. A falha de extração e o tempo necessário para concluir ainda estão disponíveis.
- Gateway externo: o status do processo não é monitorado e não está incluído nos gráficos.

## Gráficos pré-criados

A interface da Web do RMT Server tem painéis e gráficos integrados que podem ser usados para identificar gargalos e problemas de desempenho. Esses gráficos e métricas integrados podem ser encontrados nas páginas **Desempenho**, **Atividade** e **Conteúdo**. Você também pode configurar alertas (chamados de **incidentes**) para relatar valores discrepantes ou comportamento incomum com base nos limites que você configurar.

Aqui está uma lista completa de recursos que o Resource Monitoring Tool oferece para ajudar a monitorar seu Tableau Server:

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Recurso</th><th>Componente</th><th>Onde encontrar no RMT Server</th></tr></thead><tbody><tr><td><a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm">Configurar incidentes/alertas</a></td><td><ul><li>Recursos de hardware no nível do nó e do processo do Tableau Server.</li><li>Tempos de carregamento da exibição.</li><li>Tempos de consulta.</li><li>Eventos de inatividade de nó do Tableau Server.</li></ul></td><td><p><b>Administrador</b> -&gt; <b>Ambientes</b> -&gt; <b>Editar ambiente</b> -&gt; guias <b>Incidentes</b> ou <b>Notificações</b>.</p><ul><li><p>Use a guia <b>Incidentes</b> para configurar os limites do incidente.</p></li><li>Use a guia <b>Notificações</b> para configurar quando e como deseja receber notificações.</li></ul></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/rmt-performance-charts.htm">Recursos de hardware</a></td><td><ul><li>CPU</li><li>Memória</li><li>Disco</li><li>Rede</li></ul></td><td><p>Para uma visualização de alto nível, vá para <b>Desempenho</b> -&gt; <b>Selecionar ambiente</b> -&gt; <b>Ambiente</b></p><p>Para uma visão mais detalhada, vá para <b>Desempenho</b> -&gt; <b>Selecionar ambiente</b> -&gt; <b>Servidores</b></p></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/rmt-performance-charts.htm">Uso do Tableau Server</a></td><td><ul><li>Usuários simultâneos</li><li>Tempos de carregamento de visualização agregada em todo o servidor</li><li>Tarefas em segundo plano<ul><li>Duração, estado e erros detalhados para tarefas com falha.</li><li>Trechos de registro para tarefas com falha.</li></ul></li><li>Detalhes de consulta<ul><li>Duração, estado e texto de consulta para consultas demoradas ou caras.</li></ul></li><li>Informações de registro para:<ul><li>Tempos de carregamento da exibição individual.</li><li>Informações da sessão Vizql.</li><li>Duração dos eventos durante o carregamento de visualizações.</li><li>Texto de consulta, tempo de carregamento e número de linhas retornadas</li><li>Tarefas em segundo plano e tempos de execução.</li></ul></li></ul></td><td><p>A maioria dessas informações está na guia <b>Ambiente</b> do painel de desempenho.</p><p><b>Desempenho</b> -&gt; <b>Selecionar ambiente</b> -&gt; <b>Ambiente</b></p><p>Para ver os detalhes da consulta, vá para <b>Atividade</b> -&gt; <b>Consultas de dados</b> e selecione uma consulta para obter mais detalhes.</p><p>Para ver as informações do log, vá para <b>Atividade</b> -&gt; e faça uma seleção na lista para ver mais detalhes.</p></td></tr></tbody></table>

## Gráficos personalizados

Você também pode baixar os dados usados para criar os gráficos pré-construídos e explorá-los ainda mais no Tableau. Para obter mais informações, consulte [Explorar dados de monitoramento usando arquivos de fonte de dados do Tableau](https://help.tableau.com/current/server/pt-br/rmt-tds-files.htm).

## Quem pode fazer isso

Qualquer usuário da Resource Monitoring Tool pode visualizar os gráficos.

## Outros artigos nesta seção

<!-- document id=f77d77b7767f60034e14f1fd4f7727c798f5d3e81311d6ce6b28e64a44e418c2 url=/tableau/current/pt-br/server/distrib_rep_move.md -->

[Pular para o conteúdo principal](#main-content)

# Mover o processo de repositório

O Tableau Server conta com o repositório do PostgreSQL para armazenar dados do servidor. Sempre deve haver pelo menos uma instância ativa do repositório em qualquer instalação do Tableau Server, e você pode ter no máximo duas instâncias (uma ativa, uma passiva) se tiver pelo menos três nós na instalação. Você não pode remover uma instância de repositório se ela for a única.

Isso significa que, se você quiser mover a única instância do repositório de um nó para outro, precisará adicionar uma segunda instância e sincronizar o novo repositório com o antigo antes de removê-lo. Sincronize as instâncias do repositório iniciando o servidor. Se você adicionou um novo repositório, ele será sincronizado automaticamente com a instância existente.

Se estiver excluindo um nó do cluster de servidores e o mesmo estiver hospedando a única instância do repositório, você deverá incluir uma segunda instância do repositório e sincronizar as instâncias antes de remover o nó.

Se você também estiver movendo o armazenamento de arquivos, poderá mover o repositório ao mesmo tempo. Consulte [Mover o processo do Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/distrib_de_move.htm).

Antes de fazer uma alteração no repositório, crie um backup completo do Tableau Server. Para obter mais informações, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm).

**Importante:** você não pode adicionar uma segunda instância de repositório e remover a primeira na mesma etapa. Você deve ter ambas em execução para que o conteúdo da primeira seja sincronizado com a segunda, antes de remover a instância original.

As etapas para mover o repositório são:

1. Adicione uma nova instância do repositório a outro nó, inicie o servidor e aguarde que ele seja sincronizado com o primeiro repositório.
2. Remova a instância do repositório do nó original.

Para mover um repositório, você precisa primeiro adicionar uma segunda instância em um segundo nó e, após sincronizar todos os dados no repositório original, remover a instância original. Essas etapas devem ser feitas separadamente para permitir a sincronização de conteúdo entre as duas instâncias.

### Como adicionar uma nova instância do repositório

1. Abra o TSM em um navegador:
    
    `https://<tsm-computer-name>:8850`
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração.
3. Para o nó no qual está adicionando o repositório:
    
    Selecione Repositório (pgsql).
4. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
    
    A lista Alterações pendentes é exibida.
    
    Um aviso será exibido, se estiver configurando um cluster de três ou cinco nós e não tiver implantado um ensemble do Serviço de coordenação. Você pode continuar e implantar um ensemble do Serviço de coordenação em uma etapa separada. Para obter mais detalhes sobre a implantação de um ensemble do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
5. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.
6. Após reiniciar o Tableau Server, na guia Status, verifique se todos os processos estão ativos.

### Como remover uma instância do repositório

1. No TSM, na guia Status, verifique se todos os processos estão ativos. Quando os dois repositórios são exibidos como Ativos, você pode remover o primeiro deles.
2. Clique na guia Configuração.
3. Para o nó no qual você está removendo o repositório, desmarque a caixa Repositório.
4. Clique em Alterações pendentes na parte superior da página.
    
    Um aviso será exibido, se estiver configurando um cluster de três ou cinco nós e não tiver implantado um ensemble do Serviço de coordenação. Você pode continuar e implantar um ensemble do Serviço de coordenação em uma etapa separada. Para obter mais detalhes sobre a implantação de um ensemble do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
5. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.

Para mover um repositório, você precisa primeiro adicionar uma segunda instância em um segundo nó e, após sincronizar todos os dados no repositório original, remover a instância original. Essas etapas devem ser feitas separadamente para permitir a sincronização de conteúdo entre as duas instâncias.

### Como adicionar uma nova instância do repositório

1. Adicione o repositório (pgsql) em outro nó:
    
    tsm topology set-process -n <nodeID> -pr pgsql -c 1
2. Aplique as alterações. 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).
    
    tsm pending-changes apply
3. Aguarde até que o novo repositório no segundo nó sincronize com o repositório no primeiro nó.
    
    tsm status -v
    
    Aguarde até que o status do novo repositório apareça como “passivo”.

### Como remover uma instância do repositório

Uma vez que a nova instância do repositório esteja completamente sincronizada e apareça como “passiva”, é possível remover a instância original.

1. Remova o repositório do primeiro nó ao definir a contagem do processo de servidor como 0 (zero):
    
    tsm topology set-process -n <nodeID> -pr pgsql -c 0
2. Aplique a alteração. 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).
    
    tsm pending-changes apply

<!-- document id=ded0accabcaaaee892bbd3a3c59290e196238cb71c41950932e913eb9825c6f3 url=/tableau/current/pt-br/server/distrib_msg_svc_move.md -->

[Pular para o conteúdo principal](#main-content)

# Mover o processo de serviço de mensagens

Este artigo presume que você tenha instalado o Tableau Server em um nó inicial e em pelo menos um nó adicional. Para obter mais informações sobre como adicionar nós ao Tableau Server, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

Não é possível remover uma instância do Serviço de mensagens, se a mesma for a única instância no servidor. Não é possível o executar Tableau Server sem uma instância do Serviço de mensagens. Isso significa que se precisar mover o armazenamento de arquivos ou se for excluir o nó do servidor que hospeda o Serviço de mensagens , é necessário mover o serviço para outro nó antes.

Mover o Serviço de mensagens é um processo simples de três etapas:

- Remova a instância original do Serviço de mensagens.
- Adicione uma nova instância do Serviço de mensagens.
- Aplique as alterações pendentes.

### Como mover do Serviço de mensagens

1. No TSM, na guia Status, verifique se todos os processos estão ativos.
2. Clique na guia Configuração.
3. Para o nó em que você está removendo o Serviço de mensagens, desmarque a caixa Serviço de mensagens.
    
    Isso ativará o botão Alterações Pendentes, mas em Alterações pendentes, um erro informará que o Serviço de mensagens (activemqserver) não está em um nó. Até que seja adicionado a outro nó, você não poderá aplicar as alterações pendentes.
4. Para o nó em que você está adicionando o Serviço de mensagens, selecione a caixa Serviço de mensagens.
5. Clique em Alterações pendentes na parte superior da página.
6. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.

### Como mover do Serviço de mensagens

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID dos nós que você está alterando:
    
    `tsm topology list-nodes -v`
3. Remover o Serviço de mensagens de um nó:
    
    tsm topology set-process -n <nodeID> -pr activemqserver -c 0
4. Adicione o Serviço de mensagens a outro nó:
    
    tsm topology set-process -n <nodeID> -pr activemqserver -c 1
5. Aplique as alterações na configuração:
    
    `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).

<!-- document id=45a88ad0d318300033aabc7ed7c746f47484d2164bdf5291da050f64d3dbb18e url=/tableau/current/pt-br/server/distrib_de_move.md -->

[Pular para o conteúdo principal](#main-content)

# Mover o processo do Armazenamento de arquivos

Este tópico descreve o processo de Armazenamento de arquivos quando configurado para ser executado localmente no Tableau Server. No entanto, o Armazenamento de arquivos pode ser executado localmente, bem como fora do Tableau Server. Para obter mais informações sobre o Armazenamento de arquivos externo do Tableau Server, consulte [Armazenamento de arquivos externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm).

Não é possível remover uma instância do Armazenamento de arquivos, se a mesma for a única instância no servidor. Não é possível executar o Tableau Server sem ao menos uma instância do Armazenamento de arquivos. Isso significa que se precisar mover o Armazenamento de arquivos ou se for excluir o nó do servidor que hospeda a única instância dele, é necessário movê-lo para outro nó antes.

A movimentação do Armazenamento de arquivos é um processo de duas etapas:

- Adição de uma segunda instância do Armazenamento de arquivos (se não houver uma existente).
- Desativação e remoção da instância original do Armazenamento de arquivos.

Este artigo presume que você tenha instalado o Tableau Server em um nó inicial e em pelo menos um nó adicional. Para obter mais informações sobre como adicionar nós ao Tableau Server, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

### Adição de uma segunda instância do Armazenamento de arquivos

Este procedimento presume que você tenha incluído um nó adicional. Para obter mais informações sobre como adicionar nós ao Tableau Server, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração.
3. Para o nó no qual você deseja incluir uma instância do Armazenamento de arquivos, selecione Armazenamento de arquivos.
    
    Adicionar o Armazenamento de arquivos a um nó também adicionará uma instância do Processador de dados, se ainda não houver um no nó.
4. Clique em Alterações pendentes na parte superior da página:
    
    ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server/pt-br/Img/tsm-ui-pending-changes-btn.png)
    
    A lista Alterações pendentes é exibida.
    
    Um aviso do ensemble do Serviço de coordenação é exibido porque você está configurando um cluster de três nós. Você pode continuar. Você implantará um ensemble do Serviço de coordenação em uma próxima etapa.
5. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.

### Desativação e remoção de uma instância do armazenamento de arquivos

1. No TSM, na guia Status, verifique se todos os processos estão ativos.
2. Clique na guia Configuração.
3. Para o nó no qual você está removendo o Armazenamento de arquivos, desmarque a caixa Armazenamento de arquivos.
    
    Isso vai gerar um aviso sobre a desativação do Armazenamento de arquivos antes de removê-lo. Não é possível remover uma instância do Armazenamento de arquivos, a menos que ele tenha sido desativado. Clique em OK para desativar e remover o armazenamento de arquivos. O Processador de dados também será removido, a menos que uma instância de um desses processos esteja instalada no nó: VizQL Server, servidor de aplicativos (Vizportal), servidor de dados ou processador em segundo plano.
4. Se você estiver removendo o Armazenamento de arquivos de um nó que também tenha o Controlador administrativo do TSM (geralmente o nó inicial), um aviso vai alertá-lo sobre o impacto no desempenho do backup do servidor.
    
    Clique em Continuar para desativar o Armazenamento de arquivos.
5. Clique na guia Status para ver o status da desativação. Quando a instância do Armazenamento de arquivos estiver marcada como "Pronto para remoção", você poderá continuar.
    
    ![Mensagem indicando que o armazenamento de arquivos está pronto para remoção.](/tableau/current/pt-br/server/pt-br/Img/tsm-file-store-ready-for-removal.png)
6. Clique em Alterações pendentes na parte superior da página.
    
    Observação: se estiver configurando um cluster de três ou cinco nós, um aviso de ensemble do Serviço de coordenação será exibido. Você pode continuar a aplicar alterações pendentes e implantar um ensemble do Serviço de coordenação em uma etapa separada. Para obter mais informações sobre a implantação de um ensemble do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
7. Clique em Aplicar alterações e reiniciar e Confirmar para confirmar uma reinicialização do Tableau Server.

### Adição de uma segunda instância do armazenamento de arquivos

1. Crie um backup completo do Tableau Server. Para obter mais informações, consulte [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm).
2. Adicione o Armazenamento de arquivos em um segundo nó.
    
    `tsm topology set-process -n <nodeID> -pr filestore -c 1`
    
    O Armazenamento de arquivos é adicionado automaticamente. O Processador de dados também é adicionado, se ainda não estiver no nó.
    
    Aplique as alterações na configuração:
    
    `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).
3. Verifique o status da nova instância do armazenamento de arquivos.
    
    `tsm status -v`
    
    Aguarde até que o novo Armazenamento de arquivos sincronize com o do primeiro nó. Ao concluir a sincronização, o novo Armazenamento de arquivos apresentará o status "executando", em vez de "sincronizando".

### Desativação e remoção de uma instância do Armazenamento de arquivos

Com a segunda instância do Armazenamento de arquivos instalada e sincronizada, você poderá desativar e remover a instância original. Para remover a instância original, desative-a. Isso garante que qualquer arquivo exclusivo no nó do Armazenamento de arquivos seja duplicado para outro nó do armazenamento de arquivos.

1. Desativar o armazenamento de arquivos original:
    
    `[tsm topology filestore decommission](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMDecommission) -n <nodeID> --override`
2. Quando o comando de desativação concluir, aplique as alterações de configuração pendentes para remover o Armazenamento de arquivos do nó. O Armazenamento de arquivo é removido automaticamente. O Processador de dados também é removido, a menos que uma instância de um desses processos esteja instalada no nó: VizQL Server, servidor de aplicativos (Vizportal), servidor de dados ou processador em segundo plano.
    
    `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).

<!-- document id=1966a95df0bc1d5c972dca2a761bf5405600da6a576357c553c24b893e7a1308 url=/tableau/current/pt-br/server/server_move_location.md -->

[Pular para o conteúdo principal](#main-content)

# Mover o Tableau Server para outra unidade

Como padrão, o Tableau Server no Windows é instalado na unidade do sistema (geralmente, C:\\). Isso significa que todos os arquivos de programa e dados estão instalados naquela unidade. Se precisar mover o Tableau Server para uma unidade diferente (se uma nova política exigir que você não tenha dados de aplicativo na unidade do sistema, por exemplo, ou fique sem espaço na unidade original), você poderá fazer isso seguindo o procedimento abaixo. As etapas são projetadas como um exemplo para transferir o Tableau Server de uma unidade para outra no mesmo computador e podem não refletir exatamente a sua instalação e configuração. Para obter instruções sobre como mover o Tableau Server para um novo computador, consulte [Migrar para novo hardware](https://help.tableau.com/current/server/pt-br/upgrade_migrate.htm).

## Antes de começar

Antes de começar, certifique-se de:

- Faça um backup atual dos seus dados e ativos a partir da instalação existente, bem como uma exportação de configurações. Você precisa dele para restaurar sua instalação do Tableau Server na nova unidade. Para obter detalhes sobre como criar um backup, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).
    
    Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.
- Tenha credenciais administrativas no computador do Tableau Server. Este é o local em que você trabalhará e precisará estar registrado no computador, como administrador.
- Ter uma cópia do programa de instalação para a versão do Tableau Server que está transferindo. Você precisa disso para instalar o Tableau Server em uma nova unidade.
- Saber quais métodos de autenticação a sua instalação atual está usando Por exemplo, se o Tableau Server estiver configurado para SSL, SAML ou Kerberos, você precisará fazer backup dos arquivos de certificado ou keytab separadamente e, em seguida, copiá-los para a nova unidade após reinstalar o Tableau Server.
- Conheça e compreenda quaisquer definições e configurações iniciais de nó em sua instalação atual.

Quando estiver pronto para mover o Tableau Server para outra unidade e tiver feito o backup total dos dados e de todos os ativos e salvá-los em um local seguro em um computador diferente:

1. Abra um prompt de comando como um administrador no computador inicial do Tableau Server.
2. Altere para o diretório de scripts (Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`) e execute o script obliterate para remover completamente o Tableau Server do computador:
    
    tableau-server-obliterate.cmd -a -y -y -y
3. Reinicie o computador.
4. Instale o Tableau Server no novo drive. Faça isso ao executar o programa de Instalação. Para obter detalhes, consulte [Instalar o TSM](https://help.tableau.com/current/server/pt-br/setup.htm).
5. Ativar e registrar o Tableau Server. Consulte [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm).
    
    No final do processo de instalação, uma janela de navegador será aberta, e você receberá um prompt para criar um usuário administrativo inicial. Feche-o sem criar o usuário.
6. Configurar as definições do nó inicial. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm)
7. Copie o arquivo de backup _.tsbak_ na localização de pasta especificada pela variável `basefilepath.backuprestore`. Por padrão, ele é: `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ``
    
    **Observação:** é possível alterar a localização do arquivo de backup. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).
8. Abra um prompt de comando como administrador.
9. Interrompa o Tableau Server:
    
    `tsm stop`
10. Restaure o backup de dados e ativos do Tableau Server salvos anteriormente. Isso inclui restaurar seu banco de dados e quaisquer ativos que precisem ser restaurados manualmente e importar as configurações exportadas da instalação original.
    
    Para obter detalhes, consulte [Restauração de uma funcionalidade do núcleo do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm#Restorin).
11. Inicie o Tableau Server:
    
    tsm start

## Ativação da chave do produto do Tableau Server

Você pode ativar a mesma chave do produto do Tableau Server até três vezes. Isso permite testar o Tableau Server (por exemplo, em ambientes de área restrita ou de controle de qualidade), além de usar o Tableau na produção. Para maximizar suas ativações, desative a chave do produto ao remover o Tableau Server de um computador, a menos que esteja reinstalando o Tableau no mesmo computador. Isso faz com que você possa usar a ativação em um computador diferente. Por exemplo, se você mover o Tableau Server de um computador ou VM para outro, desative a chave do produto e remova o Tableau do computador original. Ao instalar o Tableau no novo computador, você pode ativar a chave nele sem conflitos. Caso use o licenciamento baseado em função, certifique-se de ativar uma chave de Creator ou Explorer ou você poderá perder o acesso de administrador ao Tableau. Se você estiver removendo o Tableau Server para reinstalá-lo no mesmo computador, não precisará desativar a chave. O Tableau usará a chave ao reinstalar. Por exemplo, se você estiver movendo o Tableau de uma unidade em um computador para uma unidade diferente no mesmo computador. Para obter mais informações sobre como desativar uma chave do produto, consulte [tsm licenses deactivate](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMDeactivate).

Ao remover o Tableau Server usando o script obliterate, você tem a opção de desativar o script e excluir as informações da chave do produto do Tableau usando um alterandor "`-l`". Isso desativará e removerá todas as informações de licença do Tableau, incluindo o Tableau Desktop se você tiver o instalado. Se você souber que deseja desativar a chave, recomendamos desativar a chave _antes_ de executar o script. Para obter mais informações, consulte [Remover o Tableau Server do computador](https://help.tableau.com/current/server/pt-br/remove_tableau.htm).

<!-- document id=590c3721423a47e871d35ee7b03280b4787c3d73fb753acd6128c026b2e46bca url=/tableau/current/pt-br/server/navigate_admin_settings.md -->

[Pular para o conteúdo principal](#main-content)

# Navegar nas Áreas administrativas do ambiente da Web do Tableau

Como um administrador no Tableau Server ou no Tableau Cloud, você pode acessar configurações administrativas que não estão disponíveis para outros usuários para configurar sites, usuários, projetos e fazer outras tarefas relacionadas ao conteúdo.

As configurações neste artigo referem-se ao ambiente da Web do Tableau. Os administradores do Tableau Server com credenciais adequadas também podem alterar as configurações do servidor, como processador, cachê, autenticação, implantação distribuída e configurações relacionadas usando o ambiente da Web do TSM. Para obter informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).

Se estiver buscando por configurações para gerenciar conteúdo publicado, consulte [Navegar no Tableau na Web](https://help.tableau.com/current/pro/desktop/pt-br/navigating.htm) e [Gerenciar conteúdo da Web](https://help.tableau.com/current/pro/desktop/pt-br/qs_content_page.htm) na Ajuda do usuário do Tableau.

## Acesso baseado em função no site e quantidade de sites

Os menus que você obtém ao fazer logon no Tableau Server ou no Tableau Cloud dependem das seguintes condições:

- Se for um administrador de servidor ou de site.
    
    O acesso de administrador de site está disponível no Tableau Cloud e no Tableau Server. O acesso de administrador de servidor está disponível somente no Tableau Server.
- Caso tenha acesso a somente um site ou a vários sites.

### Administrador de servidor

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>Em um servidor de <strong>um único site</strong>, o seletor de site não é exibido e todos os outros menus são iguais.</p></td><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/gs_ms_serveradmin_default.png" alt=""></p></td></tr><tr><td><p>Em um ambiente de <strong>vários sites</strong>, os menus à esquerda permitem modificar um site específico ou todos os sites, além de configurar usuários, grupos, agendas, tarefas e configurações do servidor.</p><p>Para acessar as configurações do administrador de servidor que afetam todos os sites, abra o menu do site, clicando na seta perto do nome do site atual, e, em seguida, selecione <span class="uicontrol">Gerenciar todos os sites</span>.</p><p>As guias <span class="uicontrol">Conteúdo</span> e <span class="uicontrol">Grupo</span> são fechadas e o texto do menu do site muda para <span class="uicontrol">Todos os sites</span>, para alertar que o usuário está gerenciando as configurações de todo o servidor e opções como <span class="uicontrol">Status do servidor</span> refletem a exibição em todo o servidor.</p><p>Para retornar aos menus do administrador de site, selecione <span class="uicontrol">Todos os sites</span> e selecione o site que deseja gerenciar.</p></td><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/gs_ms_serveradmin_site.png" alt="Menu de servidor de site único sem seletor de site."> <img src="https://help.tableau.com/current/server/pt-br/Img/gs_ms_srvadmin_manage.png" alt="Menu do site mostrando a opção selecionada para Gerenciar todos os sites."> <img alt="" src="https://help.tableau.com/current/server/pt-br/Img/gs_ms_serveradmin_allsites.png"></p></td></tr></tbody></table>

### Administrador de site

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>Se você for um administrador de site do Tableau Cloud ou do Tableau Server, e tiver acesso a vários sites, você terá menus para selecionar qual site gerenciar, e para gerenciar o conteúdo desse site, usuários, grupos, agendas e tarefas, além de monitorar seu status.</p><p>O seletor do site exibe o nome do site atual. Para ir para um site diferente, selecione o menu do site e depois selecione o nome do site.</p><p>Se você tiver acessoa apenas um site, o seletor de site não será exibido, mas todos os outros menus são iguais.</p></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/gs_ms_siteadmin_contentpage.png" alt="Menu de vários sites com seletor de sites para sites acessíveis."></td></tr></tbody></table>

## Tarefas do administrador de servidor

Os administradores de servidor (disponível somente no Tableau Server Enterprise) podem fazer o seguinte:

- Monitorar o status e a atividade do servidor.
- Gerar arquivos de registro.
- Adicionar sites e editar as configurações do site. Somente os administradores de servidor podem adicionar sites ao servidor.
- Adicionar usuários ao servidor e atribuir usuários aos sites.
- Adicionar e gerenciar grupos.
- Adicionar usuários ou remover usuários de [pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

Para gerenciar configurações somente para um determinado site, é necessário navegar até o site antes. Em cada site, você pode fazer o seguinte:

- Conteúdo de administrador: crie projetos, mova conteúdo de um projeto para outro, atribua permissões, altere a propriedade de um recurso de conteúdo, entre outras coisas.
- Gerenciar agendamento para atualizações de extrações e inscrições.
- Monitorar a atividade do site e gravar as métricas de desempenho da pasta de trabalho.
- Gerenciar limites de espaço de armazenamento para conteúdo publicado por usuários.
- Permitir criação na Web.
- Habilitar o histórico de revisões.
- Permitir que os administradores do site adicionem e removam usuários.
- Defina a quantidade máxima de licenças que o site pode consumir para cada tipo de licença (Creator, Explorer, Viewer).
- Permitir que os usuários se inscrevam em pastas de trabalho e exibições, e permitir que os proprietários de conteúdo inscrevam outras pessoas em pastas de trabalho e exibições.
- Habilitar instantâneos off-line para favoritos (somente iOS).

## Tarefas do administrador de sites

Um administrador de site no Tableau Cloud ou no Tableau Server pode executar as seguintes tarefas:

- Conteúdo de administrador: crie projetos, mova conteúdo de um projeto para outro, atribua permissões, altere a propriedade de um recurso de conteúdo, entre outras coisas.
- Visualizar, gerenciar e executar manualmente agendamentos de atualizações de extrações e de assinaturas.
- Adicionar e gerenciar usuários do site (se permitido pelo administrador do servidor; consulte [Referência de configurações do site](https://help.tableau.com/current/server/pt-br/sites_add.htm)).
- Adicionar e gerenciar grupos.
- Monitorar a atividade do site.

<!-- document id=461f3e9fb1616645a6e23d6b286dd4be3fa967e6ba88e3c5adf6c4fc9ab69d70 url=/tableau/current/pt-br/server/whatsnew_server.md -->

[Pular para o conteúdo principal](#main-content)

# Notas de versão do Tableau Server

Este tópico descreve as novidades do Tableau Server na versão mais recente. Use a visualização abaixo para explorar novos recursos no Tableau Server. Clique em um recurso para exibir a dica de ferramenta com um link para a documentação detalhada desse recurso. Explore os filtros para refinar sua pesquisa. Baixe os dados para criar uma lista personalizada.

- Use o painel Pesquisar por Recurso para ver uma lista de novos recursos para um produto ou versão ou explorar quando um recurso foi lançado. Atualmente, o painel é padronizado para a versão mais recente do Server.
- Use o painel do Atualizar Server para ver uma lista de recursos específicos para seu upgrade. A exibição de upgrade inclui filtros que permitem filtrar recursos novos ou alterados. Os recursos listados no status alterado geralmente são recursos que podem afetar o upgrade. Os recursos de lista categorizados como alterados podem ser úteis para preparar e testar suas atualizações.

<!-- document id=50d8e2b06cfc3649c875b981701f28f16a4773e298fc19147752d9023c245b9c url=/tableau/current/pt-br/server/perf_alerts.md -->

[Pular para o conteúdo principal](#main-content)

# Notificações do Tableau Server

Configure notificações de e-mail para quando o servidor estiver sem espaço em disco e quando os processos do servidor forem interrompidos ou reiniciados. Essas condições frequentemente significam que há um problema imediato.

Para enviar notificações, o Tableau Server deve poder se conectar a um servidor de e-mail, também conhecido como um servidor de Protocolo de Transferência de Correio Simples (SMTP). Um servidor SMTP é um serviço para o qual podem ser enviadas mensagens de saída (ele não trata e-mail de chegada). Antes de configurar notificações, é necessário configurar o Tableau Server primeiro para se comunicar com o servidor de de e-mail SMTP. Para obter mais informações, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

Uma vez configurado o servidor de e-mail SMTP, configure as notificações para monitorar os eventos de integridade do servidor. Para obter mais informações, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).

<!-- document id=f189c78fda3f04977bca633346bc21ca2120cc9fb35a0e5d74e5bfaa24005b0a url=/tableau/current/pt-br/server/prep_conductor_subscribe_to_flow.md -->

[Pular para o conteúdo principal](#main-content)

# Notificar usuários sobre execuções de fluxo bem-sucedidas

_Compatível com o Tableau Prep Builder versão 2021.4.1 e posterior e o Tableau Server e Tableau Cloud versão 2021.4 e posterior. O Data Management é necessário para usar este recurso._

Os proprietários de fluxo podem se inscrever, usuários individuais e grupos para enviar notificações por email para obter informações sobre tarefas planejadas para execuções de fluxo bem-sucedidas. O e-mail inclui links para dados dentro do ambiente do Tableau. No Tableau Server, você pode incluir opcionalmente os detalhes do fluxo executado em arquivos Excel e CSV anexados.

As assinaturas de fluxo são adicionadas às tarefas agendadas para fluxos. Você pode adicionar assinaturas de fluxo ao criar uma nova tarefa de fluxo ou a uma tarefa de fluxo existente. Notificações por e-mail são enviadas quando a tarefa agendada é concluída com sucesso.

## Definir as configurações do site para assinaturas de fluxo

Por padrão, a configuração do site de Inscrições de fluxo para enviar e receber notificações por e-mail está habilitada.

![A configuração do site Inscrições de fluxo mostra a caixa de seleção marcada para enviar e receber notificações por e-mail.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_site.png)

- A opção Permitir que os usuários enviem ou recebam e-mails que incluem dados de saída de fluxo permite que o proprietário do fluxo receba e inscreva usuários e grupos para notificações de execução de fluxo bem-sucedidas. No e-mail de notificação, os usuários podem acessar a fonte de dados completa ou visualizar os detalhes do fluxo de dentro do Tableau.
- Somente no Tableau Server (não recomendado): a opção Anexar arquivos de saída de fluxo .csv e .xlsx permite que o proprietário do fluxo anexe arquivos a e-mails de notificação. Os destinatários do e-mail devem ser adicionados ao servidor do Tableau; no entanto, os arquivos contêm a fonte de dados e podem ser expostos fora do sistema do Tableau. Essa opção está disponível apenas para ambientes locais.

## Publicar o fluxo

Publique a saída do fluxo como um arquivo, tabela de banco de dados ou fonte de dados. Considere o seguinte ao salvar o fluxo:

- (Apenas no local) Ao publicar, você pode salvar a saída como um arquivo ou como uma tabela de banco de dados e optar por anexar um tipo de arquivo .csv ou .xlsx ao e-mail.
- Ao publicar e salvar a saída como uma fonte de dados publicada, a notificação por e-mail fornece um link para o fluxo no Tableau. Os arquivos não podem ser anexados ao e-mail.
- Ao escolher salvar como uma saída de arquivo, você deve usar um compartilhamento de rede, e a saída e o local de entrada devem ser incluídos em uma lista segura. Para obter mais informações, consulte [Etapa 4: locais de entrada e saída da lista de segurança](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm).
- As assinaturas de fluxo são compatíveis com o Windows e Linux. As seguintes restrições se aplicam a assinaturas de fluxo no Linux:
    
    - As saídas de arquivo devem ser enviadas para um servidor Windows.
    - Para fluxos que saem para um arquivo, use o formato UNC para o caminho: \\\\server\\path\\filename. Não use uma letra de unidade local.
    - O caminho montado deve ser listado com segurança.
- Ao anexar arquivos a um e-mail, o limite do arquivo é de aproximadamente 25 MB para o Tableau Cloud. Ao usar um Tableau Server local, você configura o tamanho dos arquivos de anexo.

## Adicionar uma assinatura de fluxo

1. Como proprietário do fluxo, selecione um fluxo publicado no Tableau Server ou Tableau Cloud ao qual deseja adicionar assinaturas para notificações por e-mail.
2. Você pode adicionar assinaturas a uma tarefa nova ou existente:
    - Se você estiver adicionando uma assinatura a uma nova tarefa:
        1. Clique em Tarefas agendadas > Nova tarefa.
        2. Na caixa de diálogo Nova tarefa, selecione uma agenda para executar o fluxo na lista suspensa Selecione uma agenda.
        3. Ative Enviar e-mail quando terminar

- Se você estiver adicionando uma assinatura a uma tarefa existente:
    1. Clique em Assinaturas > Assinar.
    2. Na caixa de diálogo Adicionar assinaturas de fluxo, selecione uma agenda na lista suspensa Frequência.

4. No campo Enviar para, comece a digitar o nome do usuário ou grupo para preencher o campo. Selecione os usuários e grupos para os quais deseja enviar uma notificação.
    
    Os usuários e grupos devem ser adicionados ao ambiente do Tableau pelo administrador.
5. (Opcional) Para ser incluído na notificação, marque a caixa Enviar para mim.
6. (Opcional) No campo Assunto, personalize a linha de assunto do e-mail padrão para a notificação de execução do fluxo.
7. (Opcional) Adicione informações sobre o fluxo executado na caixa de texto Mensagem de e-mail.
8. Clique em Incluir dados de saída e selecione o tipo de saída que deseja incluir no e-mail.

- No Tableau Server, se você publicou seu fluxo como um arquivo ou uma saída de tabela de banco de dados, pode optar por anexar arquivos .csv ou .xlsx contendo a fonte de dados ao e-mail. Isso não é recomendado porque os dados podem ser expostos fora do sistema Tableau.
![Caixa de seleção para incluir a fonte de dados como um anexo ao publicar a saída do fluxo como um arquivo ou em uma tabela de banco de dados.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_text_out.png)- Se você publicou seu fluxo como uma fonte de dados, pode optar por incluir o link para a fonte de dados. Não há compatibilidade para anexar arquivos ao e-mail.
![Caixa de seleção para incluir o link para a fonte de dados ao publicar a saída do fluxo como uma fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_pub_data.png)

10. Se você estiver adicionando uma assinatura a uma tarefa existente, clique em Assinar.

## Cancelar a assinatura de uma assinatura de fluxo

Para cancelar a assinatura de notificações por e-mail, siga estas etapas.

1. Clique em Cancelar assinatura na parte inferior de um e-mail de assinatura.
2. Como proprietário do fluxo, faça logon no Tableau Server ou Tableau Cloud. Na parte superior da página, clique no ícone Notificações:
3. Expanda o menu… e selecione Remover notificação.

Para cancelar a assinatura e remover a assinatura como proprietário do fluxo, siga estas etapas.

1. Clique em Assinaturas.
2. Abra o fluxo publicado no Tableau Server ou no Tableau Cloud.
3. Na lista de assinaturas de fluxo, clique na caixa de seleção do fluxo do qual deseja cancelar a assinatura.
4. Selecione Ações \> Cancelar assinatura.

![A guia Assinaturas do menu Ação mostra a opção Cancelar assinatura.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_unsbscribe.png)

## Ver assinaturas

Você pode exibir suas assinaturas de fluxo atuais no Tableau Server ou Tableau Cloud.

- Na guia Assinaturas da página Visão geral do fluxo, você pode ver a lista de assinaturas atuais.
- Na guia Assinaturas na página Tarefas, você pode ver a lista de assinaturas junto com as assinaturas de pastas de trabalho.

## Retomar assinaturas de fluxo suspensas

Às vezes, as assinaturas falham devido a um problema com o fluxo. Se uma assinatura falhar mais de cinco vezes, você receberá uma notificação por e-mail informando que a tarefa de fluxo agendada foi suspensa.

Na página Visão geral do fluxo, você pode ver quando uma tarefa de fluxo agendada falha.

![A página Visão geral do fluxo que mostra os detalhes de uma execução de fluxo, incluindo a etapa de saída, o nome da saída, o status, a programação e os erros.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_overview.png)

Existem algumas maneiras de retomar uma tarefa de fluxo suspenso. Se você for o proprietário do fluxo:

- Na área Meu conteúdo das páginas na Web do Tableau, aparece um ícone na coluna Última atualização para indicar que a assinatura está suspensa. Selecione ... > Retomar tarefas agendadas para retomar.
    
    ![As opções de menu para retomar uma tarefa de fluxo suspensa com a opção Retomar Tarefas Agendadas destacada.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscription_resume.png)
- Na guia Tarefas agendadas, aparece um ícone na coluna de última atualização para indicar que a assinatura está suspensa. Selecione o fluxo e clique em Ações > Retomar.![A guia Tarefas agendadas do menu Ação mostrando a opção Retomar.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_resume_task.png)

## Acesse os dados de fluxo de um e-mail de notificação

Dependendo de como a notificação de fluxo foi configurada, você pode acessar a fonte de dados e os anexos de arquivo do e-mail de notificação.

- Clique em Exibir fluxo para abrir o fluxo no Tableau Server ou Tableau Cloud.
- Clique no arquivo de anexo para visualizar os dados do fluxo.

![Uma notificação por e-mail que confirma a execução bem-sucedida de um fluxo. O e-mail fornece detalhes sobre o fluxo, sua fonte de dados e o remetente.](/tableau/current/pt-br/server/pt-br/Img/prep_conductor_subscribe_email.png)

### Quem pode fazer isso

- Os proprietários de fluxo podem criar assinaturas de notificação de fluxo para fluxos de sua propriedade.
- Para receber notificações, usuários e grupos devem ser adicionados ao ambiente do Tableau pelo administrador.

Para obter mais informações, consulte os seguintes artigos:

- Windows: [Definir funções de usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm) e [Permissões de conteúdo e propriedade](https://help.tableau.com/current/server/pt-br/permissions.htm)
- Linux: [Definir funções de usuários no site](https://help.tableau.com/current/server-linux/pt-br/users_site_roles.htm) e [Permissões de conteúdo e propriedade](https://help.tableau.com/current/server-linux/pt-br/permissions.htm)

<!-- document id=9641868d46d5b46ab5a36fe52161700fc0f3c9921356179f573d2c3a15d130ec url=/tableau/current/pt-br/server/datasource_datamodel.md -->

[Pular para o conteúdo principal](#main-content)

# O modelo de dados do Tableau

Todas as fontes de dados criadas no Tableau têm um modelo de dados. Você pode pensar em um modelo de dados como um diagrama que informa ao Tableau como ele deve consultar dados nas tabelas de banco de dados conectadas.

Na página Fontes de dados, as tabelas adicionadas à tela criam a estrutura do modelo de dados. Um modelo de dados pode ser simples, como uma única tabela. Ou pode ser mais complexo, com várias tabelas que usam diferentes combinações de relações, uniões de colunas e uniões de linhas.

O modelo de dados tem duas camadas:

- A exibição padrão que você visualiza na tela da página Fonte de dados é a _camada lógica_ da fonte de dados. Combine dados na camada lógica usando relações (ou noodles). Pense nessa camada como a tela Relações na página Fontes de dados. Para obter mais informações, consulte [Usar relações para análise de dados de várias tabelas](https://help.tableau.com/current/pro/desktop/pt-br/datasource_multitable_normalized.htm).
- A próxima camada é a camada física. Combine dados entre as tabelas na camada física usando [uniões de colunas](https://help.tableau.com/current/pro/desktop/pt-br/datasource_relationships_learnmorepage.htm#where-did-joins-go) e uniões de linhas. Cada tabela lógica contém pelo menos uma tabela física nessa camada. Pense na camada física como a tela União de colunas/União de linhas na página Fonte de dados. Clique duas vezes em uma tabela lógica para exibir ou adicionar uniões de colunas e de linhas.

<table style="width: 865px; margin-left: 0; margin-right: auto;"><colgroup><col style="width: 413px;"><col style="width: 15px;"><col style="width: 437px;"></colgroup><thead><tr><th>Camada lógica</th><th>&nbsp;</th><th>Camada física</th></tr></thead><tbody><tr><td style="text-align: center;">Noodles = Relações</td><td>&nbsp;</td><td style="text-align: center;">Diagrama de Venn = União de colunas</td></tr><tr><td style="text-align: left;"><img src="https://help.tableau.com/current/server/pt-br/Img/data_model_logicallayer_ex1_sm.png" alt="A exibição de nível superior de uma fonte de dados com várias tabelas relacionadas."></td><td style="text-align: center;">&nbsp;</td><td style="text-align: left;"><img src="https://help.tableau.com/current/server/pt-br/Img/data_model_physlayer_ex1_sm.png" alt="Diagrama das relações entre as tabelas Livro, Prêmio e Informações em um modelo de dados."></td></tr><tr><td class="caption">A exibição de nível superior de uma fonte de dados com várias tabelas relacionadas. Esta é a camada lógica. As tabelas lógicas podem ser combinadas usando relações (noodles). Elas não usam tipos de união. Elas atuam como contêineres de tabelas físicas.</td><td>&nbsp;</td><td class="caption">Clique duas vezes em uma tabela lógica para abri-la e ver as tabelas físicas. As tabelas físicas podem ser combinadas usando uniões de colunas e de linhas. Neste exemplo, a tabela lógica Livro consiste em três tabelas físicas com união de colunas (Livro, Prêmio, Informação).</td></tr></tbody></table>

| Camada lógica |   | Camada física |
| --- | --- | --- |
| Tela Relações na página Fonte de dados |   | Tela União de colunas/União de linhas na página Fonte de dados |
| As tabelas que você arrasta aqui são as tabelas lógicas |   | As tabelas que você arrasta aqui são as tabelas físicas |
| As tabelas lógicas podem estar relacionadas a outras tabelas lógicas |   | As tabelas físicas podem unir colunas ou linhas de outras tabelas físicas |
| As tabelas lógicas são semelhantes a contêineres de tabelas físicas |   | Clique duas vezes em uma tabela lógica para ver as tabelas físicas |
| O nível de detalhe está no nível de linha da tabela lógica |   | O nível de detalhe está no nível de linha das tabelas físicas mescladas |
| As tabelas lógicas permanecem distintas (normalizadas), não mescladas na fonte de dados |   | As tabelas físicas são mescladas em uma única tabela simples que define a tabela lógica |

## Camadas do modelo de dados

A exibição de nível superior que você vê de uma fonte de dados é a [camada lógica](#dm_log_phys) do modelo de dados. Você também pode pensar nisso como a tela Relações, pois as tabelas são combinadas usando relações, em vez de união de colunas.

Quando você combina dados de várias tabelas, cada tabela que você arrasta para a tela na camada lógica deve ter uma relação com outra tabela. Não é necessário especificar os tipos de união de colunas para relações. Durante a análise, o Tableau seleciona automaticamente os tipos de união de colunas apropriados, com base nos campos e no contexto da análise na planilha.

A [camada física](#dm_log_phys) do modelo de dados é o local onde você pode combinar dados usando uniões de colunas e de linhas. Você só pode usar tabelas dinâmicas nesta tela. Você pode pensar nisso como a tela União de colunas/União de linhas. Nas versões anteriores do Tableau, a camada física era a única camada no modelo de dados. Cada tabela lógica pode conter uma ou mais _tabelas físicas_.

> [!TIP]
> 
> **Importante**: você ainda pode criar fontes de dados de tabela única no Tableau que usam uniões de colunas e de linhas. O comportamento da análise de tabela única no Tableau não mudou. As pastas de trabalho atualizadas funcionarão da mesma forma que antes de 2020.2.

**Saiba mais**: para obter informações relacionadas sobre a combinação de dados usando relações, consulte também esses tópicos e publicações no blog:

- [Como as relações diferem das uniões de colunas](https://help.tableau.com/current/server/pt-br/datasource_relationships_learnmorepage.htm)
- [Usar relações para análise de dados de várias tabelas](https://help.tableau.com/current/server/pt-br/datasource_multitable_normalized.htm)
- [Relacionar os dados](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm)
- [Relações, parte 1: apresentação da nova modelagem de dados no Tableau](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)
- [Relações, parte 2: dicas e truques](https://www.tableau.com/about/blog/2020/5/relationships-part-2-tips-and-tricks)
- [Relações, parte 3: fazer perguntas em várias tabelas relacionadas](https://www.tableau.com/about/blog/2020/6/relationships-part-3-asking-questions-across-multiple-related-tables)

Veja também podcasts de vídeo sobre relacionamentos em [Análises de ação](https://action-analytics.com/library/), como [Por que o Tableau inventou os relacionamentos?](https://action-analytics.com/ep-1-why-did-tableau-invent-relationships/) Clique em "Podcast de vídeo" na [Biblioteca](https://action-analytics.com/library/) para ver mais.

## Noções básicas do modelo de dados

O modelo de dados tem uma camada lógica (semântica) e uma camada física. Isso oferece mais opções para combinar dados usando esquemas para se adequar à análise.

![Um diagrama de modelo de dados exibe uma camada lógica com duas tabelas vinculadas por uma relação, e uma camada física que ilustra como as tabelas lógicas são construídas a partir de tabelas físicas.](/tableau/current/pt-br/server/pt-br/Img/data_model_layers_sm.png)

Cada tabela lógica contém tabelas físicas em uma camada física.

Nas versões anteriores do Tableau (antes de 2020.2), o modelo de dados na fonte de dados consistia em uma única camada física, em que era possível especificar as uniões de colunas e de linhas. As tabelas adicionadas à camada física (com uniões de colunas ou de linhas) criam uma única tabela achatada (desnormalizada) para análise.

<table style="width: 850px; margin-left: 0; margin-right: auto;"><colgroup><col style="width: 350px;"><col style="width: 20px;"><col style="width: 465px;"></colgroup><thead><tr><th>Fonte de dados de camada física</th><th>&nbsp;</th><th>Fonte de dados de camada lógica</th></tr></thead><tbody><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/data_model_physical_layer.png" alt="Diagrama das conexões entre quatro tabelas físicas em um modelo de dados."></td><td>&nbsp;</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/data_model_logical_physical.png" alt="Um diagrama de modelo de dados com uma camada lógica e uma camada física."></td></tr></tbody></table>

As tabelas na camada lógica não são mescladas na fonte de dados, permanecem distintas (normalizadas) e mantêm o nível de detalhe nativo.

As tabelas lógicas atuam como contêineres para tabelas físicas mescladas. Uma tabela lógica pode conter uma única tabela física. Ou pode conter várias tabelas físicas mescladas por meio de uniões de colunas e de linhas.

### Adicionar descrições a tabelas lógicas

As tabelas lógicas podem ter descrições que aparecem em suas dicas de ferramentas. Essas dicas de ferramentas só aparecem na guia Fonte de dados.

Para adicionar uma descrição:

1. Selecione uma tabela na tela.
2. No painel inferior, clique no ícone de edição (lápis) próximo **Descrição**.
3. Insira sua descrição no editor de rich text.

**Observação**: somente na criação na Web, todos os links em uma descrição estão ativos e podem ser clicados para abrir diretamente.

![dica de ferramenta de uma tabela com uma descrição do campo e um destaque ao redor da seção de descrição do painel inferior](/tableau/current/pt-br/server/pt-br/Img/environ_workspace_datasource_tabledescriptions.png)

## Criar um novo modelo

Quando você adiciona uma ou mais tabelas à camada lógica, está criando essencialmente o modelo de dados para sua fonte de dados. É possível criar uma fonte de dados de uma única tabela lógica ou você pode arrastar várias tabelas para a tela para criar um modelo mais complexo.

- A primeira tabela que você arrasta para a tela torna-se a tabela raiz para o modelo de dados na fonte de dados.
- Depois de arrastar a tabela raiz, você pode arrastar tabelas adicionais em qualquer ordem. Você precisará considerar quais tabelas devem estar relacionadas entre si e os pares de campo correspondentes que você define para cada relação.
- Caso você esteja criando um esquema de estrela, pode ser útil arrastar a tabela de fatos primeiro e, em seguida, relacionar tabelas de dimensão com essa tabela.
- Excluir uma tabela na tela exclui também automaticamente seus descendentes relacionados. Se você excluir a tabela raiz, todas as outras tabelas do modelo também serão removidas.
- Cada relação deve conter pelo menos um par de campos correspondentes. Adicione vários pares de campo para criar uma relação composta. Os pares correspondentes devem ter o mesmo tipo de dados. Alterar o tipo de dados na página Fonte de dados não altera esse requisito. O Tableau ainda usará o tipo de dados no banco de dados subjacente para consultas.
- Elas não podem ser baseadas em campos calculados.
- Você pode especificar como os campos usados nas relações devem ser comparados usando operadores ao definir a relação.

Para obter mais informações sobre relações, consulte [Criar e definir relações](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm#create-and-define-relationships) em [Relacionar os dados](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm).

### Modelo de várias tabelas

- Para criar um modelo de várias tabelas, arraste tabelas para a camada lógica da tela da página Fonte de dados.  
      
    ![Para criar um modelo de várias tabelas, arraste tabelas para a camada lógica da tela da página Fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/data_model_multitableanalysis.gif)

As tabelas arrastadas para a camada lógica da tela da página Fonte de dados devem estar relacionadas entre si. Quando você arrasta tabelas adicionais para a tela de camada lógica, o Tableau tenta criar automaticamente a relação com base nas restrições de chave existentes e nos campos correspondentes para definir a relação. Se não puder determinar os campos correspondentes, selecione-os.

Se nenhuma restrição for detectada, uma relação **Muitos para muitos** será criada e a integridade referencial será definida como **Alguns registros correspondem**. Essas configurações padrão são uma escolha segura e fornecem o máximo de flexibilidade para sua fonte de dados. As configurações padrão aceitam uniões de colunas externas completas e otimizam as consultas agregando dados de tabela antes de formar as uniões de colunas durante a análise. Todos os dados de coluna e de linha em cada tabela se tornam disponíveis para análise.  

É possível adicionar mais dados à qualquer tabela lógica clicando duas vezes na tabela. Isso abre a camada física da tela da página Fonte de dados. Se você precisar usar uniões de colunas e de linhas, arraste as tabelas em que deseja fazer essas uniões para a tela de camada física. As tabelas físicas são mescladas na tabela lógica.

Siga as etapas em [Criar e definir relações](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm#create-and-define-relationships) para combinar várias tabelas.

### Modelo de tabela única

- Para criar um modelo de tabela única, arraste uma tabela para a tela de camada lógica da página Fonte de dados. Em seguida, use os campos dessa tabela no painel Dados para análise.  
      
    ![Modelo de dados com uma análise de tabela única.](/tableau/current/pt-br/server/pt-br/Img/data_model_singletableanalysis.gif)

#### Modelo de tabela única que contém outras tabelas

É possível adicionar mais dados em uma única tabela lógica clicando duas vezes na tabela. Isso abre a camada física da tela da página Fonte de dados. Se você precisar usar uniões de colunas e de linhas, arraste as tabelas em que deseja fazer essas uniões para a tela de camada física. As tabelas físicas são mescladas na tabela lógica.

![Modelo de dados com duas uniões.](/tableau/current/pt-br/server/pt-br/Img/data_model_singletable_joins.gif)

Este exemplo mostra a tabela Livro na tela Relações (camada lógica) da fonte de dados. Clicar duas vezes na tabela lógica Livro abre a tela União de colunas/União de linhas (camada física).

Neste exemplo, as uniões de colunas mesclam as tabelas Prêmio e Informação com a tabela Livro. Nesse caso, a união de colunas entre Livro e Prêmio será de um a muitos, no nível de detalhe de prêmios. Isso duplicaria os valores de medida de Livro e Informação. Para evitar a duplicação, relacione Prêmio e Informação a Livro em vez de unir colunas na tabela lógica Livro.

## Esquemas de modelo de dados compatíveis

Os recursos de modelagem de dados no Tableau (versão 2020.2 e posterior) foram criados para facilitar a análise dos cenários comuns de dados de várias tabelas, incluindo modelos de dados estrela e Snowflake. Os seguintes tipos de modelos são aceitos em fontes de dados do Tableau.

### Tabela única

A análise sobre uma única tabela lógica que contém uma mistura de dimensões e medidas funciona exatamente como no Tableau anterior à versão 2020.2. É possível criar uma tabela lógica usando uma combinação de uniões de colunas, uniões de linhas, SQL personalizado etc.

![Objeto rotulado como clientes com três barras azuis empilhadas em cima de duas barras verdes.](/tableau/current/pt-br/server/pt-br/Img/data_model_schema1.png)

### Estrela e floco de neve

Nos data warehouses corporativos, é comum ter dados estruturados em esquemas estrela ou floco de neve, onde as medidas estão em uma tabela de fatos central e as dimensões são armazenadas separadamente, em tabelas de dimensão independentes. Essa organização de dados é compatível com muitos fluxos de análise comuns, incluindo roll-up e drill-down.

![Objeto Clientes com linhas mostrando uma relação com os objetos da dimensão 1, dimensão 2 e dimensão 3.](/tableau/current/pt-br/server/pt-br/Img/data_model_schema2.png)

Esses modelos podem ser representados diretamente com relações nos recursos de modelagem de dados disponíveis no Tableau 2020.2 e posterior.

Arraste a tabela de fatos para o modelo e, depois, relacione as tabelas de dimensão à tabela de fatos (em um esquema estrela) ou a outras tabelas de dimensão (em um floco de neve).

Normalmente, em um esquema estrela ou floco de neve com modelagem adequada, as relações entre a tabela de fatos e as tabelas de dimensão são de muitos para um. Se essas informações forem codificadas no data warehouse, o Tableau usará isso automaticamente para definir as opções de desempenho da relação. Caso contrário, você mesmo pode definir essas informações. Para obter mais informações, consulte [Otimizar consultas de relações usando opções de desempenho](https://help.tableau.com/current/pro/desktop/pt-br/datasource_relationships_perfoptions.htm).

Em um esquema estrela ou floco de neve com modelagem adequada, cada linha na tabela de fatos terá uma entrada correspondente em cada uma das tabelas de dimensão. Se isso for verdadeiro e capturado nas restrições de integridade do data warehouse, o Tableau usará automaticamente essas informações para definir a configuração de integridade referencial em Opções de desempenho. Se algumas linhas da tabela de fatos não tiverem uma linha correspondente em uma tabela de dimensão (às vezes denominada “dimensões de chegada tardia” ou “fatos de chegada antecipada”), o Tableau assumirá o padrão de manter todas as linhas ao calcular medidas, mas poderá diminuir os valores ao mostrar cabeçalhos de dimensão. Para obter mais informações, consulte [Otimizar consultas de relações usando opções de desempenho](https://help.tableau.com/current/pro/desktop/pt-br/datasource_relationships_perfoptions.htm).

### Estrela e floco de neve com medidas em mais de uma tabela

Em alguns esquemas estrela ou floco de neve, todas as medidas para a análise estão na tabela de fatos. No entanto, muitas vezes é verdade que medidas adicionais de interesse podem estar relacionadas às tabelas de dimensão na análise. Mesmo que as tabelas de dimensão não contenham medidas, é comum na análise querer contar ou agregar valores de dimensão. Nesses casos, a distinção entre tabelas de fatos e tabelas de dimensão é menos óbvia. Para criar clareza ao visualizar seu modelo de dados, recomendamos adicionar a tabela mais refinada à tela de fonte de dados e, depois, relacionar todas as outras tabelas à primeira tabela.

![O modelo de dados ilustra como os clientes são segmentados em três dimensões.](/tableau/current/pt-br/server/pt-br/Img/data_model_schema3.png)

Se você juntar essas tabelas em uma única tabela lógica, as medidas nas tabelas de dimensão seriam replicadas, resultando em agregados distorcidos, a menos que você tomasse precauções para deduplicar os valores usando cálculos de LOD ou COUNT DISTINCT. No entanto, se você criar relações entre essas tabelas, o Tableau agregará medidas antes de realizar as uniões de colunas, evitando o problema da duplicação desnecessária. Isso dispensa a necessidade de acompanhar cuidadosamente o nível de detalhe das medidas.

### Análise de vários fatos

Na versão 2024.2 e posterior, os recursos de modelagem de dados do Tableau oferecem suporte à análise de vários fatos por meio do uso de relações multifatoriais. Para obter informações detalhadas sobre como criar modelos de dados de relações multifatoriais, consulte:

- [Sobre modelos de dados de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm)
- [Quando usar um modelo de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_when_to_use.htm)
- [Construir um modelo de dados de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_build.htm)

Um modelo de relação de vários fatores — um modelo de dados com diversas tabelas base — permite tabelas não relacionadas no modelo quando tabelas compartilhadas também existem no modelo. Durante a análise, os campos de uma tabela compartilhada “unem” tabelas de dados que de outra forma não seriam relacionadas com base nas dimensões compartilhadas que elas têm em comum (como acontecer no mesmo local ou ao mesmo tempo). Todos os benefícios das relações são mantidos, incluindo a retenção da granulação de cada tabela, ou nível nativo de detalhe.

Semelhante a um modelo de dados de tabela base única, o Tableau determina o melhor tipo de junção a ser usado nos bastidores com base na estrutura da visualização. Mas em um modelo de relação de vários fatos, as opções de união de colunas são expandidas para incluir uniões de coluna externas e cruzadas para lidar com diferentes níveis de relação. Para mais informações, veja [Sobre modelos de dados de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm).

**Observação**: nas versões 2020.2 a 2024.1, você poderá adicionar tabelas de fatos (contendo medidas) aos modelos estrela e floco de neve somente se eles estiverem relacionados a uma tabela de dimensão única.

Por exemplo, é possível reunir duas ou mais tabelas de fatos para analisar uma dimensão compartilhada, como em análises semelhantes ao Cliente 360. Essas tabelas de fatos podem estar em um nível de detalhe diferente da tabela de dimensão, ou uma da outra. Também podem ter uma relação de muitos para muitos com a tabela de dimensão. Nesses cenários, o Tableau vai garantir que os valores não sejam replicados antes da agregação.

![O modelo de dados ilustra como os clientes são segmentados em três dimensões e mostra as conexões entre vendas e campanhas.](/tableau/current/pt-br/server/pt-br/Img/data_model_schema5.png)

Se você não possui uma tabela de dimensão compartilhada que relacione as tabelas de fatos, às vezes, é possível criar uma dinamicamente, usando o SQL personalizado ou usando uniões de colunas ou de linhas de outras tabelas de dimensão.

Duas tabelas de fatos podem ser relacionadas diretamente uma à outra em uma dimensão comum. Esse tipo de análise funciona melhor quando uma das tabelas de fatos contém um superconjunto da dimensão comum.

![O modelo de dados mostra a relação entre vendas e campanhas.](/tableau/current/pt-br/server/pt-br/Img/data_model_schema6.png)

Existem vários cenários que podem indicar que você deve construir um modelo de relações multofatoriais com diversas tabelas base em vez de uma única fonte de dados de tabela base:

- **Relações circulares**. As relações circulares não são compatíveis atualmente. Se você estiver tentando criar uma fonte de dados com um ciclo, use relações multifatoriais e transforme a tabela downstream em outra tabela base.
- **Dimensões conformadas** e **Relações OR contextuais**. Se você tiver uma série de tabelas relacionadas nos mesmos conjuntos de cláusulas de relação (como data e local), essas dimensões deverão ser extraídas e transformadas em tabelas compartilhadas.
    - Isso é especialmente útil porque múltiplas cláusulas de relacionamento devem ser todas verdadeiras (logicamente, um AND) para que as tabelas sejam relacionadas para esses registros.
    - Se, em vez disso, você quiser analisar registros onde um pode ser verdadeiro por vez (um OR contextual), essa flexibilidade será fornecida pela configuração de um modelo de dados com tabelas de dimensões compartilhadas.
- **Combinações equivalentes**. Se você estiver usando uma combinação, mas quiser ter uma combinação equivalente sem fontes de dados primárias e secundárias, crie um modelo de dados que combine as fontes de dados da combinação com seus campos de vinculação em uma tabela ou tabelas compartilhadas.

## Requisitos para relações em um modelo de dados

- Ao relacionar tabelas, os campos que definem as relações devem ter o mesmo tipo de dados. Alterar o tipo de dados na página Fonte de dados não altera esse requisito. O Tableau ainda usará o tipo de dados no banco de dados subjacente para consultas.
- Não é possível definir relações com base em campos geográficos.
- Relações circulares não são aceitos no modelo de dados.

### Fatores que limitam os benefícios do uso de tabelas relacionadas

- Dados sujos em tabelas (ou seja, tabelas que não foram criadas com um modelo bem estruturado em mente e contêm uma mistura de medidas e dimensões em várias tabelas) podem tornar a análise de várias tabelas mais complexa.
- O uso de filtros da fonte de dados limitará a capacidade de o Tableau fazer a separação de união nos dados. A separação de união é um termo que se refere ao modo como o Tableau simplifica as consultas, removendo uniões de colunas desnecessárias.
- Tabelas com muitos valores sem correspondência entre relações.

<!-- document id=a4c7fa68317756f6d345048ef2bf54d41782eb6890682a807231dd950d8eae43 url=/tableau/current/pt-br/server/sites.md -->

[Pular para o conteúdo principal](#main-content)

# O que é um site

Você pode estar acostumado a usar o termo _site_ para significar "um conjunto de computadores conectados", ou talvez uma forma abreviada de "site da Web." Mas no contexto do Tableau, usamos site como referência a uma coleção de usuários, grupos e conteúdo (pastas de trabalho, fontes de dados) isolados de qualquer outro conteúdo ou grupo na mesma instância do Tableau Server. Ou seja, o Tableau Server é compatível com a locação múltipla, permitindo que os administradores de servidor criem sites no servidor para vários conjuntos de usuários e conteúdo.

Todo o conteúdo de servidor é publicado, acessado e gerenciado com base no site. Cada site tem sua própria URL e seu próprio conjunto de usuários (embora cada usuário do servidor possa ser adicionado a vários sites). O conteúdo de cada site (projetos, pastas de trabalho e fontes de dados) é completamente isolado do conteúdo de outros sites.

Se você for um administrador de servidor na implantação do seu Tableau Server, saiba mais sobre os sites, quando usá-los (versus projetos) e muito mais em [Visão geral dos sites](https://help.tableau.com/current/server/pt-br/sites_intro.htm "Abre o tópico em uma nova guia do navegador"), na seção **Gerenciar servidor**.

**Observação:** este artigo pertence aos sites de configuração nas implantações do Tableau Server. Para o Tableau Cloud, consulte [Função e tarefas do administrador de site](https://help.tableau.com/current/online/pt-br/to_site_startup.htm "Abra a ajuda do Tableau Cloud em uma nova guia do navegador.").

## Tarefas do administrador de sites

Onde a função no site do Administrador de servidor conceder ao usuário acesso irrestrito à implantação completa do Tableau Server, a função no site do Administrador de site concede ao usuário acesso irrestrito ou minimamente restrito ao nível do site. As diferenças entre Administrador de site criador e Administrador de site explorador estão no nível da conexão de dados e do acesso a publicação. As duas funções permitem a administração do próprio site e o gerenciamento de usuários do site. Para obter mais informações, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

Embora um administrador de servidor possa trabalhar nos níveis de servidor e de site, fazemos uma distinção entre os dois níveis de tarefas. O administrador de site é normalmente o responsável por criar e fazer a manutenção da estrutura que permite aos usuários do Tableau na sua empresa publicar, compartilhar, gerenciar e conectar-se a fontes de dados e pastas de trabalho. Nessa veia, as tarefas de administrador de site incluem qualquer uma das seguintes (e as duas funções permitem esse nível de acesso):

- Criação de hierarquias de projeto para organizar as fontes de dados e as pastas de trabalho do site.
    
    Isso pode incluir delegar o gerenciamento em nível de projeto para os líderes de projeto.
- Criação de grupos e atribuição de permissões que permitem aos usuários acessar somente o conteúdo necessário.
- Adição e remoção de usuários, atribuindo a eles às funções de site.
    
    Isso é permitido por padrão em um site; no entanto, um administrador de servidor pode restringir esse acesso somente no servidor.
- Gerenciamento de agendas de extração e assinatura do site.
- Monitoramento da atividade do site.

Para obter mais informações sobre a distinção entre o administrador de servidor e o administrador de site, consulte [Acesso de nível de administrador aos sites](https://help.tableau.com/current/server/pt-br/sites_intro.htm#admin-access-sites), na seção **Gerenciar servidor** .

## Etapas para configurar o seu site

A tabela abaixo mostra uma sequência solta de etapas para configurar um site, juntamente com links para tópicos em que é possível obter mais informações. Complete as etapas na ordem que for melhor para você.

No entanto, antes de executar as etapas para configurar o site, recomendamos que reserve alguns minutos com os artigos nesta seção, para aprender sobre as autenticações de site, funções de site, projetos e permissões. Idealmente, você documentaria um plano para seus projetos, grupos e sua estratégia geral de permissões. Em seguida, configure alguns projetos e adicione um conjunto preliminar de usuários, para testar o plano e solucionar problemas, antes de adicionar os usuários restantes. É possível alterar diversas configurações quando os usuários já estão usando o site, mas procure minimizar a necessidade por alterações pós-produção desde o início.

<table class="simple-table" style="width: 90%; margin-left: 0; margin-right: auto;"><colgroup><col style="width: 33%;"><col style="width: 67%;"></colgroup><tbody><tr><td><p><strong>Planejar</strong></p></td><td><p>Para complementar as recomendações acima desta tabela, obtenha uma visão geral de como os componentes do site funcionam em conjunto em <a href="https://help.tableau.com/current/server/pt-br/site_admin_planning.htm" class="xref">Planejamento de um site</a>.</p></td></tr><tr><td><strong>Configurar o acesso</strong></td><td><p>Trabalhe com o administrador de servidor para determinar como os usuários fazem logon no site e configure o site conforme apropriado.</p><p>Por exemplo, se o servidor estiver configurado para um logon único usando SAML, você também pode configurar a autenticação SAML no site.</p></td></tr><tr><td><strong>Criar projetos e a estrutura de permissões</strong></td><td><p>Os projetos ajudam a organizar o conteúdo, delegar o gerenciamento de conteúdo do projeto e gerenciar as permissões de modo eficaz. Para começar, consulte <a href="https://help.tableau.com/current/server/pt-br/projects.htm" class="xref">Usar projetos para gerenciar o acesso ao conteúdo</a>.</p></td></tr><tr><td><strong>Adicione usuários</strong><p>&nbsp;</p></td><td><p>Determine os usuários que podem fazer logon no site. Consulte <a href="https://help.tableau.com/current/server/pt-br/sites_addusers.htm" class="xref">Adicionar usuários a um site</a>.</p></td></tr><tr><td><strong>Transfira seus dados para o <span class="mc-variable Variables.ProductName variable">Tableau Server</span></strong></td><td><p>Após você criar sua estrutura de projetos e permissões, designe usuários aprovados para publicação e gerenciamento de fontes de dados aprovadas aos projetos apropriados no site.</p><p>Em algumas empresas, pessoas servem em várias funções do Tableau. O administradores de site comumente também são administradores de dados. Com isso, queremos dizer que eles criam, publicam e gerenciam as conexões de dados do Tableau. Se esse for o seu caso, certifique-se de que a você foi atribuída a função no site Administrador de site criador.</p><p>Após o conteúdo ser publicado no site, é possível manter as informações de conexão (credenciais, tokens de acesso) e atualizar as agendas. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/schedule_add.htm" class="xref">Atualizar dados em uma agenda</a>.</p></td></tr><tr><td><strong>Analise o uso e o desempenho do site</strong><p>&nbsp;</p></td><td><p>Monitore o uso, desempenho e outras métricas. Consulte <a href="https://help.tableau.com/current/server/pt-br/adminview.htm" class="xref">Exibições administrativas </a>.</p></td></tr></tbody></table>

<!-- document id=ca75631723dbec9d6b7fd4c3b1a6fe198c1f9249ac59ccea1e4a75120ea923a6 url=/tableau/current/pt-br/server/upgrade_know_before.md -->

[Pular para o conteúdo principal](#main-content)

# O que mudou - O que é preciso saber antes da atualização

A partir da versão 2020.2, este tópico foi mesclado com O que há de novo no Tableau Server, para fornecer um único local para recursos e comportamento novos e alterados no Tableau Server. Consulte [Notas de versão do Tableau Server](https://help.tableau.com/current/server/pt-br/whatsnew_server.htm) para novos recursos e mudanças introduzidas nesta e nas versões anteriores.

**Observação:** use o [Tableau Release Navigator](https://public.tableau.com/shared/JJGWR3P65?:display_count=n&:origin=viz_share_link) para pesquisar recursos no Tableau Desktop, Server e Prep ou para ver uma lista completa de recursos ao comparar sua versão atual do Tableau com uma posterior.

<!-- document id=3b7fd30fc0209ddbb866f1d151815015f0ac5dc6b9e8b9a465097643f6b60f1c url=/tableau/current/pt-br/server/snowflake_oauth_idp.md -->

[Pular para o conteúdo principal](#main-content)

# OAuth externo para Snowflake

A partir do Tableau 2024.3, você pode usar o OAuth 2.0/OIDC para federar a identidade de um provedor de identidade externo para o Snowflake.

Dependendo do fornecedor de identidade, existem diferentes passos necessários para configurar a integração. Essa é uma visão geral de alto nível destinada a orientar sua configuração sem fornecer os detalhes necessários que você encontrará na documentação do seu provedor de identidade. Presume-se que você esteja familiarizado com a configuração do OAuth e entenda os detalhes técnicos necessários para configurar a autenticação com um provedor de identidade externo.

## Configurar o IDP no Snowflake

Para obter informações sobre como configurar seu IDP, consulte [Visão geral do OAuth externo](https://docs.snowflake.com/en/user-guide/oauth-ext-overview) no sistema de ajuda do Snowflake.

## Configurar o IDP no Tableau

1. Crie clientes OAuth no IDP para Tableau Desktop e para Tableau Cloud ou Tableau Server. O cliente Desktop habilita [PKCE](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) e usa redirecionamentos `http://localhost`.
2. Crie o arquivo de configuração do Tableau OAuth. Para obter detalhes sobre como fazer isso, consulte [Configuração e uso do OAuth](https://tableau.github.io/connector-plugin-sdk/docs/oauth) em [github](https://tableau.github.io/connector-plugin-sdk/docs/oauth), e exemplos [aqui](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth). Aceitamos exemplos para outros IDPs.
    
    - Certifique-se de prefixar as IDs de configuração do Tableau OAuth com “custom\_”.
        
        **Observação:** as IDs de configuração do OAuth têm um limite máximo de 36 caracteres. IDs maiores que isso podem não gerar erros, mas não funcionarão.
    - Se o seu IDP aceitar porta localhost dinâmica, desative `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`. Se o seu IDP não for compatível, certifique-se de adicionar várias URLs de retorno de chamada de host local à lista de permissões no arquivo de configuração e no IDP.
3. Instale o novo arquivo de configuração do Tableau OAuth na pasta OAuthConfigs associada a cada aplicativo em hosts de desktop (Tableau Desktop, Tableau Prep Builder, Tableau Bridge) e em cada site do Tableau Server e do Tableau Cloud que usará o OAuth pela página de configurações do site. Para obter mais detalhes, veja [Configurações OAuth personalizadas no Desktop](https://tableau.github.io/connector-plugin-sdk/docs/oauth#custom-oauth-configs-on-desktop) e [Clientes OAuth em nível de site](https://tableau.github.io/connector-plugin-sdk/docs/oauth#site-level-oauth-clients).

## Conecte-se ao Snowflake

Ao conectar, você deve selecionar OAuth e escolher a configuração OAuth instalada anteriormente.

![](/tableau/current/pt-br/server/pt-br/Img/snowflake_connect_oauth.png)

## Okta

Caso use o Okta, é melhor usar um “servidor de autorização personalizado” em vez do “servidor de autorização organizacional”. Os servidores de autorização personalizados são mais flexíveis. Existe um servidor de autorização personalizado criado por padrão, chamado “default”. A URL de autorização deve ter esta aparência:

`https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize`

![painel okta](/tableau/current/pt-br/server/pt-br/Img/athena_okta.png)

<!-- document id=4a1d47da4502b27c400d0e1ed764d3a979fff1c3217f8b473c7fa1e1817ddac7 url=/tableau/current/pt-br/server/dm_tools_backfill.md -->

[Pular para o conteúdo principal](#main-content)

# Obter o status de ingestão inicial

Depois de habilitar a API de metadados do Tableau usando o comando `tsm maintenance metadata-services`, você pode usar a API de backfill para monitorar o progresso da ingestão inicial e obter informações de status para backfills de conteúdo e linhagem.

As etapas descritas abaixo devem ser executadas por um administrador de servidor e recomendadas para serem usadas em conjunto com [Etapa 7: monitorar o andamento da ingestão inicial e validar o status](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#step7) no tópico Ativar o Tableau Catalog.

## Etapa 1: autenticar usando a API REST

Para acessar a API de Backfill, você deve primeiro autenticar contra o Tableau Server e obter um token. Você pode fazer isso na API REST do Tableau. Para obter mais informações, consulte [Entrar e sair (autenticação)](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm)na Ajuda da API REST.

Como alternativa, você pode entrar no Tableau Server usando as credenciais de administrador.

## Etapa 2: faça uma solicitação GET

Faça a seguinte solicitação GET ou cole a URL no seu navegador:

http://my\_tableau\_server/api/metadata/v1/control/backfill/status

A solicitação inicialmente retorna informações sobre o backfill de conteúdo. Quando o backfill de conteúdo estiver completo, as informações de backfill de linhagem são devolvidas.

- Para backfill de conteúdo, a solicitação retorna um resumo de status e informações adicionais de status para cada tipo de conteúdo, dependendo do conteúdo disponível no Tableau Server. A indexação para cada tipo de conteúdo acontece simultaneamente.
- Para backfill de linhagem, a solicitação retorna um resumo de status.

### Valores de status da resposta

Os seguintes valores são devolvidos pela API de backfill.

- `contentBackfillTotalDurationSeconds` e `lineageBackfillTotalDurationSeconds` significa a quantidade de tempo, em segundos, no respectivo tipo de backfill. Quando `backfillComplete` é `true`, `contentBackfillTotalDurationSeconds` e `lineageBackfillTotalDurationSeconds` significa o tempo total gasto para concluir o tipo de backfill correspondente.

Para backfill de conteúdo: 

- `contentType` podem mostrar os seguintes tipos de conteúdo: `PublishedDatasource`, `Database`, `DatabaseTable`, `Metric`, `Workbook` e `Flow`.
- `contentId` é o identificador do último item indexado.
- `successfullyIngestedCount` é o número de itens indexados com sucesso.
- `failedIngestedCount` é o número de itens que não poderiam ser indexados.
- `durationSeconds` é o tempo gasto, em segundos, para indexar itens para o tipo de conteúdo.
- `totalCount` é o número total de itens para indexar.
- `checkpointCreatedTime` é o último tempo registrado, em UTC, um item foi indexado. A API de backfill verifica o último item indexado a cada cinco minutos.
- `backfillComplete` é `true` quando a indexação é concluída para todos os itens do tipo de conteúdo.

Para backfill de linhagem:

- `totalCount` é o número total de relações de linhagem para indexar.
- `processedCount` é o número de relações de linhagem indexadas.
- `lastLineageConnection` é a última relação de linhagem indexada.
- `backfillComplete` é `true` quando a indexação é concluída para todas as relações de linhagem.

### Resposta de exemplo

O pedido retorna o texto de JSON. Para visualizar o JSON em um formato mais legível, você pode usar um visualizador JSON ou complemento do navegador.

{        

  "contentBackfillTotalDurationSeconds": 362,

  "lineageBackfillTotalDurationSeconds": 14,

  "contentBackfillStatuses": \[

    {

	"contentType": "PublishedDatasource",

	"contentId": "sites/1/datasources/-631379806-1912815680",

	"successfullyIngestedCount": 20,

	"failedToIngestCount": 0,

	"durationSeconds": 312,

	"totalCount": 20,

	"checkpointCreatedTime": "2020-07-29T23:50:25.763Z",

	"backfillComplete": true

    },

    {

	"contentType": "Database",

	"contentId": "sites/1/databases/e1331f9d-4d73-ee04-9edf-96fd1c37cb8e",

	"successfullyIngestedCount": 35,

	"failedToIngestCount": 0,

	"durationSeconds": 26,

	"totalCount": 35,

	"checkpointCreatedTime": "2020-04-29T23:50:25.769Z",

	"backfillComplete": true

    },

    {

	"contentType": "DatabaseTable",

	"contentId": "sites/1/tables/d946d084-53a8-09b6-2ad2-93301e6b4b15",

	"successfullyIngestedCount": 64,

	"failedToIngestCount": 0,

	"durationSeconds": 49,

	"totalCount": 64,

	"checkpointCreatedTime": "2020-04-29T23:50:25.774Z",

	"backfillComplete": true

    },

    {

	"contentType": "Metric",

	"contentId": "sites/1/metrics/metric1",

	"successfullyIngestedCount": 2,

	"failedToIngestCount": 0,

	"durationSeconds": 254,

	"totalCount": 2,

	"checkpointCreatedTime": "2020-04-29T23:50:25.779Z",

	"backfillComplete": true

    },

    {

	"contentType": "Workbook",

	"contentId": "sites/1/workbooks/6749399-1501801290",

	"successfullyIngestedCount": 10,

	"failedToIngestCount": 0,

	"durationSeconds": 267,

	"totalCount": 10,

	"checkpointCreatedTime": "2020-04-29T23:50:25.784Z",

	"backfillComplete": true

    },

    {

	"contentType": "Flow",

	"contentId": "sites/1/flows/4",

	"successfullyIngestedCount": 4,

	"failedToIngestCount": 0,

	"durationSeconds": 195,

	"totalCount": 4,

	"checkpointCreatedTime": "2020-04-29T23:50:25.788Z",

	"backfillComplete": true

    }

   \],

  "lineageBackfillStatus": {

	"totalCount": 45,

	"processedCount": 18,

	"lastLineageConnection": "CloudFile downstreamWorkbooks Workbook",

	"backfillComplete": false

    }

}

<!-- document id=c99b3f1406f9eb809ba884518d1be3a72355c31c62c4d9df474681e707632f36 url=/tableau/current/pt-br/server/service_status_xml.md -->

[Pular para o conteúdo principal](#main-content)

# Obter o status do processo como XML

Para obter uma versão do status de processos do servidor que o computador possa ler, ou seja, uma versão do status em formato XML, use a URL a seguir:

http://my\_tableau\_server/admin/systeminfo.xml

É preciso fazer logon no Tableau Server para visualizar o status do processo por leitura computadorizada, ou ter [acesso remoto permitido](https://help.tableau.com/current/server/pt-br/service_remote.htm).

O servidor retornará um relatório de status semelhante ao seguinte:

<systeminfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <machines>
    <machine name="my\_tableau\_server">
    <repository worker="my\_tableau\_server:8060" status="Active" preferred="false"/>
    <dataengine worker="my\_tableau\_server:27042" status="Active"/>
    <applicationserver worker="my\_tableau\_server:8600" status="Active"/>
    <apiserver worker="my\_tableau\_server:8000" status="Active"/>
    <vizqlserver worker="my\_tableau\_server:9100" status="Active"/>
    <dataserver worker="my\_tableau\_server:9700" status="Active"/>
    <backgrounder worker="my\_tableau\_server:8250" status="Active"/>
    <gateway worker="my\_tableau\_server:80" status="Active"/>
    <searchandbrowse worker="my\_tableau\_server:11000" status="Active"/>
    <cacheserver worker="my\_tableau\_server:6379" status="Active"/>
    <filestore worker="my\_tableau\_server:9345" status="Active" pendingTransfers="0" failedTransfers="0" syncTimestamp="2015-02-27T20:30:48.564Z"/>
    <clustercontroller worker="my\_tableau\_server:12012" status="Active"/>
    <coordination worker="my\_tableau\_server:12000" status="Active"/>
    </machine>
  </machines>
  <service status="Active"/>
</systeminfo>

## Valores de status no XML

- <process> worker \- O nome do nó executando o processo e da porta que o processo está usando.
- status \- O status do processo no nó. Estes são os possíveis valores:`Active`, `Passive`, `Unlicensed`, `Busy`, `Down`, `ReadOnly`, `ActiveSyncing`, `StatusNotAvailable`, `StatusNotAvailableSyncing`, `NotAvailable`, `DecommisionedReadOnly`, `DecomisioningReadOnly`, and `DecommissionFailedReadOnly`
- pendingTransfers - A quantidade de extrações de pastas de trabalho ou fontes de dados que o nó precisa para sincronizar completamente. Estas representam itens que foram publicados a este nó de armazenamento de arquivo, e itens que foram publicados a outros nós de armazenamento de arquivo, e que precisam ser copiados para este nó.
- failedTransfers - A quantidade de pastas de trabalho ou fontes de dados que não foram transferidas a este nó de armazenamento de arquivo durante o último trabalho automático. O trabalho automático é executado a cada 15-30 minutos aproximadamente, porém pode levar mais tempo ao transferir um grande número de extrações ou grandes extrações.
    
    Transferências não sucedidas não necessariamente indicam um problema com o Tableau Server. O trabalho automático irá transferir arquivos que resultaram em falhas durante a sincronização anterior. As razões para a falha na transferência de arquivo são listadas nos registros.
- syncTimestamp - A hora, em UTC (Tempo Universal Coordenado), do último trabalho automático executado que sincronizou arquivos.

<!-- document id=602ffc391a6add4803d3df1ff93974a656272b78784dd396bb9a9d49a9176575 url=/tableau/current/pt-br/server/dm_tools_eventing.md -->

[Pular para o conteúdo principal](#main-content)

# Obter status de eventos

Depois de habilitar o Tableau Catalog (ou a API de metadados de Tableau) no ambiente do Tableau Server, você pode usar a API de eventos para medir o desempenho de indexação.

As etapas descritas abaixo devem ser executadas por um administrador do servidor.

## Etapa 1: autenticar usando a API REST

Para acessar a API de eventos, você deve primeiro autenticar contra o Tableau Server e obter um token. Você pode fazer isso na API REST do Tableau. Para obter mais informações, consulte [Entrar e sair (autenticação)](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm)na Ajuda da API REST.

Como alternativa, você pode entrar no Tableau Server usando as credenciais de administrador.

## Etapa 2: faça uma solicitação GET

Faça a seguinte solicitação GET ou cole a URL no seu navegador:

http://my\_tableau\_server/api/metadata/v1/control/eventing/status

### Valores de status da resposta

Os seguintes valores são devolvidos pela API de eventos.

- `contentType` é o tipo de conteúdo mais recentemente indexado.
- `queueSize` é o número de itens na fila de indexação. Quanto maior o tamanho da fila, mais tempo pode levar para os itens serem exibidos no Catalog ou na API de metadados. Se o tamanho da fila aumentar com o tempo, talvez seja necessário ajustar a capacidade do processador em segundo plano para suportar os contêineres não interativos e o processo de indexação. Para obter mais informações, consulte [Memória para contêineres de microsserviços não interativos](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#Memory).
- `checkpointCreatedTime`é o último tempo registrado, em UTC, um item foi indexado. A API de eventos verifica o último item indexado a cada cinco minutos.

### Resposta de exemplo

O pedido retorna o texto de JSON. Para visualizar o JSON em um formato mais legível, você pode usar um visualizador JSON ou complemento do navegador.

{        

   "contentType": "PublishedDatasource",

   "queueSize": 312,

   "checkpointCreatedTime": "2020-07-29T23:50:25.763Z"

}

<!-- document id=84d2f8bfa70b7630fe884edcd28e2e8a8671f1d7bd30ef43529fd67be2b2dac6 url=/tableau/current/pt-br/server/trusted_auth_webrequ.md -->

[Pular para o conteúdo principal](#main-content)

# Obter um ticket do Tableau Server

Depois de [adicionar endereços IP confiáveis](https://help.tableau.com/current/server/pt-br/trusted_auth_trustIP.htm) ao Tableau Server, você estará pronto para configurar seu servidor Web para obter tickets do Tableau Server via solicitações POST ([Etapa 2 do diagrama](https://help.tableau.com/current/server/pt-br/trusted_auth.htm)). A solicitação POST deve ser enviada a `http://<server_name>/trusted`. Por exemplo, a solicitação POST deve ser enviada a `http://tabserv/trusted`, e não a `http://tabserv`.

**Observação:** Se SSL estiver ativado, será necessário usar https em vez de http. Por exemplo:  `https://tabserv/trusted`.

Estes são os dados que você pode usar em uma solicitação POST ao Tableau Server:

- **`username=<username>`** (obrigatório): O nome de usuário para um usuário licenciado do Tableau Server. Se estiver usando a Autenticação local, o nome de usuário pode ser uma string simples (por exemplo, `username=jsmith`). Se estiver usando o Active Directory com vários domínios, você deverá incluir o nome de domínio com o nome de usuário (por exemplo, `username=MyCo\jsmith`).
- **`target_site=<site id>`** (obrigatório, se a exibição não estiver no site padrão): Especifica o site que contém a exibição se o Tableau Server estiver executando [vários sites](https://help.tableau.com/current/server/pt-br/sites.htm) e a exibição estiver em um site diferente do site padrão (por exemplo, `target_site=Sales`). O valor usado por você para `<site id>` deve ser a [ID do Site](https://help.tableau.com/current/server/pt-br/sites_add.htm) fornecido quando o site foi criado. Este valor diferencia maiúsculas de minúsculas. Caso Site ID seja `SAles`, `target_site=SAles`.
- **`client_ip=<IP address>`** (opcional): Usado para especificar o endereço IP do computador cujo navegador da Web está acessando a exibição (por exemplo, `client_ip=123.45.67.891`). Não é o endereço IP do servidor Web que está fazendo a solicitação POST do Tableau Server. Se você decidir usar esse parâmetro, consulte [Opcional: Configurar a correspondência de IP do cliente](https://help.tableau.com/current/server/pt-br/trusted_auth_optional.htm) para obter mais informações.

A resposta do Tableau Server à solicitação POST será uma cadeia de caracteres exclusiva (o ticket). Se o Tableau Server não puder processar a solicitação, a resposta será `-1`. Consulte [Valor de ticket -1 retornado pelo Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_trouble_1return.htm) para ver as dicas de como corrigir isso. Além disso, para que os usuários consigam se autenticar quando clicam em uma exibição inserida, seus navegadores devem estar configurados para [permitir cookies de terceiros](https://help.tableau.com/current/server/pt-br/trusted_auth_trouble_cookie.htm).

O formato do ticket foi alterado no Tableau Server 10.2. Agora, o formato do ticket é uma cadeia de caracteres composta de duas partes. Cada parte é uma cadeia de caracteres de 128 bits codificada antes de ser retornada ao cliente. A primeira parte é uma ID universalmente exclusiva (UUID v4), codificada com Base64. A segunda parte é uma cadeia de caracteres aleatória de 24 caracteres. A concatenação dessas partes pode ser expressa como Base64(UUIDv4):SecureRandomString. Veja o exemplo de um ticket: `9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5`.

Em seguida, adicione o código que permite que o servidor Web [crie uma URL](https://help.tableau.com/current/server/pt-br/trusted_auth_webURL.htm) para a exibição com o local da exibição e o tíquete.

<!-- document id=b8f7b946831098321d677a37fa41c7e0fdf59f0635082f5fc75658a9d4f24440 url=/tableau/current/pt-br/server/trusted_auth_optional.md -->

[Pular para o conteúdo principal](#main-content)

# Opcional: Configurar a correspondência de IP do cliente

Por padrão, o Tableau Server não considera o endereço IP do navegador da Web do cliente quando ele cria ou resgata tickets. Para mudar isso, é necessário fazer duas coisas: especificar um endereço IP usando o parâmetro `client_ip` na solicitação POST que obtém o ticket e seguir as etapas abaixo para configurar o Tableau Server para impor a correspondência de endereço IP do cliente.

1. Abra o TSM CLI e insira os seguintes comandos:
    
    tsm configuration set -k wgserver.extended\_trusted\_ip\_checking -v true
2. Em seguida, digite o seguinte comando:
    
    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).

<!-- document id=dbdddda312a0e46c097743a4b8ab92da587ada13db5166d5c01c0da24fb25abc url=/tableau/current/pt-br/server/ts_aws_deployment_options.md -->

[Pular para o conteúdo principal](#main-content)

# Opções de implantação do Tableau Server no AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

É possível autoimplantar o Tableau Server em uma instância do Amazon EC2 fornecida por você, implantar o Tableau Server no Início rápido do AWS com os modelos do CloudFormation encontrados no Tableau Server ou implantar o Tableau Server no AWS usando um modelo do CloudFormation no AWS Marketplace. A tabela a seguir mostra as diferenças entre cada opção.

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col><col><col><col></colgroup><tbody><tr><th>Tableau Server</th><th style="text-align: center;">Autoimplantação da AWS</th><th style="text-align: center;">Início rápido da AWS</th><th style="text-align: center;">AWS Marketplace</th></tr><tr><td>Pronto para produção</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td></tr><tr><td>Atualizável</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Instalar no Linux</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Instalar no Windows</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade vertical</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade horizontal (adicionar nós)</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td></tr><tr><td>Suporte do Active Directory</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td></tr><tr><td>Licença BYOL</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Suporta a versão mais recente do Tableau</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr></tbody></table>

Cada uma das opções de implantação é descrita em mais detalhes abaixo:

- **Autoimplantação para uma instância do Amazon EC2** – Fornece a maior flexibilidade e opções para personalizar o Tableau Server no seu ambiente. Se desejar iniciar um sistema rapidamente, use o Tableau Server no Início rápido do AWS ou, em vez disso, em uma oferta do Tableau Server (BYOL) no AWS Marketplace.
    
    A autoimplantação do Tableau Server para uma instância do Amazon EC2 é recomendada para ambientes de desenvolvimento, teste e produção que começam simples, mas talvez precisem mais tarde de escalabilidade vertical ou horizontal. É possível atualizar o Tableau Server sem precisar substituir a máquina virtual.
    
    Para obter mais informações sobre autoimplantação, consulte [Autoimplantar um Tableau Server único na AWS](https://help.tableau.com/current/server/pt-br/ts_aws_single_server.htm). Para obter mais informações sobre a implantação em um ambiente distribuído, consulte [Autoimplantar um Tableau Server na AWS em um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_aws_multiple_server.htm).
- **Início rápido do Tableau Server na AWS** – instala o Tableau Server em uma instância independente do Amazon EC2 ou em um cluster de instâncias independentes do Amazon EC2 que executam o servidor do Microsoft Windows ou Ubuntu Server usando um modelo da AWS CloudFormation. Esta estratégia de implantação permite ficar em tempo real rapidamente e limitar seus custos gerais.
    
    O Tableau Server no Início rápido da AWS é recomendado para ambientes de desenvolvimento, teste e produção que começam simples, mas talvez precisem mais tarde de escalabilidade vertical ou horizontal. Você pode usar sua própria licença (BYOL) ou [entre em contato com vendas](https://www.tableau.com/pt-br/about/contact#contact_sales) para obter uma chave do produto. É possível atualizar o Tableau Server sem precisar substituir a máquina virtual. Para obter mais informações sobre como instalar o Tableau Server usando o Início rápido, consulte o [Tableau Server no Início rápido da AWS](https://aws.amazon.com/quickstart/architecture/tableau-server/).
    
    Para outros Inícios rápidos da AWS especializados na implantação do Tableau Server, consulte:
    
    - [Modernização da análise na nuvem no início rápido da AWS: análise na nuvem completa com o Tableau Server](https://aws.amazon.com/quickstart/architecture/informatica-tableau-analytics/)
    - [Tableau Server no início rápido da AWS para serviços de saúde: Tableau Server na AWS para cargas de trabalho de HIPAA](https://aws.amazon.com/quickstart/architecture/tableau-server-healthcare/)
- **Tableau Server (BYOL) no AWS Marketplace**– Instala uma instância de nó único do Tableau Server (BYOL) no AWS em apenas alguns cliques. Essa solução usa scripts CloudFormation do AWS que implementam o Tableau Server na inicialização, a fim de alinhar melhor o funcionamento dos Inícios rápidos do AWS e garantir uma experiência uniforme do cliente.
    
    Você pode [entrar em contato com vendas](https://www.tableau.com/pt-br/about/contact#contact_sales) para obter uma chave do produto ou, depois que o Tableau Server estiver funcionando na instância do Amazon EC2, compre uma licença do Tableau Server e ative a chave do produto associada. Para obter mais informações sobre o AWS Marketplace, consulte [AWS Marketplace](https://aws.amazon.com/marketplace/seller-profile?id=0ef849c5-c2fa-4699-9f67-c47555e148a5). O AWS Marketplace para Tableau Server apresenta as seguintes limitações:
    
    - Máquina simples, escalonamento vertical somente.
    - Sem Active Directory. Apenas autenticação local. Se precisar da autenticação do Active Directory, consulte [Autoimplantação de um único Tableau Server na AWS](https://help.tableau.com/current/server/pt-br/ts_aws_single_server.htm).
    - Pode ser implantado em um conjunto específico de tipos e tamanhos de instâncias do Amazon EC2 ideais.
    - Compatível com Windows e Linux.
    - Compatível com as versões mais recentes do Tableau.
    - Atualize o Tableau Server sem precisar substituir a máquina virtual.

Para obter mais informações sobre as opções de licenciamento para o Tableau Server, consulte [Visão geral de licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

<!-- document id=190f0f045acaab5fc35653a4f515fca4d3f168e35b88e6fd43dfe55aa5b4c4bb url=/tableau/current/pt-br/server/ts_azure_deployment_options.md -->

[Pular para o conteúdo principal](#main-content)

# Opções de implantação do Tableau Server no Microsoft Azure

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode implantar o Tableau Server no Microsoft Azure, por meio da autoimplantação, usando o nício rápido do Azure para implatar em uma única VM com Linux ou por meio de uma implantação pré-configurada em uma VM do Azure Marketplace. A tabela a seguir mostra as diferenças entre cada opção.

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col><col><col></colgroup><tbody><tr><th>Tableau Server</th><th style="text-align: center;">Autoimplantação em VM do Azure</th><th style="text-align: center;">Início rápido do Azure</th><th style="text-align: center;">VM do Azure Marketplace</th></tr><tr><td>Pronto para produção</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td></tr><tr><td>Atualizar o Tableau sem substituir a VM</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td></tr><tr><td>Instalar no Linux</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td></tr><tr><td>Instalar no Windows</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade vertical</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade horizontal (adicionar nós)</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td></tr><tr><td>Suporte do Active Directory</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/redx.png" alt="Ícone X vermelho."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Licença BYOL</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr></tbody></table>

Cada uma das opções de implantação é descrita em mais detalhes abaixo:

- **Autoimplantação em VM do Azure**: proporciona a maior flexibilidade e oferece opções para personalizar o Tableau Server no seu ambiente. Se for iniciar um sistema que será executado apenas por um curto intervalo de tempo (ou seja, para fins de teste ou de avaliação), use o Tableau Server na VM do Azure Marketplace.
    
    A autoimplantação do Tableau Server em uma VM do Azure é recomendada para ambientes de desenvolvimento, teste e produção que começam simples, mas talvez precisem ser escalonados mais tarde.
    
    Para obter mais informações sobre autoimplantação, consulte [Autoimplantar um Tableau Server único no Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_single_server.htm). Para obter mais informações sobre a implantação em um ambiente distribuído, consulte [Autoimplantar um Tableau Server no Microsoft Azure em um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_azure_multiple_server.htm).
- **Tableau Server no início rápido do Azure** - instala o Tableau Server usando um modelo do Azure Resource Manager em uma VM do Azure independente com CentOS, Redhat Enterprise Linux (RHEL) ou Ubuntu Server, com todos os elementos de infraestrutura necessários. Esta estratégia de implantação permite ficar em tempo real rapidamente e limitar seus custos gerais.
    
    O Tableau Server no Início rápido do Azure é recomendado para ambientes de desenvolvimento, teste e produção que começam simples, mas talvez precisem mais tarde de escalabilidade vertical ou horizontal. Você pode usar sua própria licença (BYOL) ou [entre em contato com vendas](https://www.tableau.com/pt-br/about/contact#contact_sales) para obter uma chave do produto. É possível atualizar o Tableau Server sem precisar substituir a máquina virtual. Para obter mais informações sobre como instalar o Tableau Server usando o Início rápido, consulte o [Nó único Linux do Tableau Server](https://azure.microsoft.com/en-us/resources/templates/tableau-server-single-node/) no site da Microsoft.
- **VM do Azure Marketplace**: uma das maneiras mais rápidas de colocar o Tableau Server em funcionamento no Microsoft Azure, com base em uma imagem pré-configurada do servidor, é pelo Azure Marketplace. Essa opção instala o Tableau Server em uma VM do Azure com o Windows em execução. O Tableau Server no Azure Marketplace está disponível apenas por meio de um modelo BYOL (Bring Your Own License). Depois que o Tableau Server estiver funcionando normalmente na VM do Azure, você poderá adquirir uma licença do Tableau Server e ativar a chave do produto associada. As VMs do Azure Marketplace do Tableau Server são recomendadas apenas para testes rápidos e para ambientes de prova de conceito.
    
    Para instalar uma VM do Azure Marketplace
    
    1. Vá para o Azure Portal Marketplace e pesquise "Tableau Server".
    2. Selecione Tableau Server e crie a imagem.
    3. Insira as informações sobre a assinatura e escolha um grupo de recursos e um local de implantação.
    4. Selecione o tamanho da máquina virtual.
    5. Configure os recursos opcionais, como tipo de disco, conta de armazenamento, sub-rede, etc.
    6. Valide a configuração do servidor.
    7. Implante o Tableau Server.

Para obter mais informações sobre as opções de licenciamento do Tableau Server, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

<!-- document id=1b015898cda42d5a362e02047eb9f6ab775a02e087ee2325cc484f3fbe9f5277 url=/tableau/current/pt-br/server/rmt-install-init-agent-opts.md -->

[Pular para o conteúdo principal](#main-content)

# Opções de script de inicialização do RMT Agent

Depois de instalar o RMT Agent, você precisa inicializar o Agente. Por padrão, o único sinalizador obrigatório que você deve incluir ao executar o script de inicialização é `--accepteula`. Outras opções oferecem flexibilidade para personalizar a instalação com base em seu ambiente e nos requisitos de segurança de sua empresa.

## Opções de inicialização do RMT Agent

\--accepteula

Obrigatório.

Indica que você leu e aceitou os termos do Contrato de Licença de Usuário Final (EULA).

\-a <username>

Opcional.

Adicione o nome de usuário fornecido aos grupos apropriados, em vez do usuário executando o script de inicialização. Isso dá ao usuário acesso aos recursos pertencentes aos grupos. Isso não é o mesmo que a conta de usuário Run As.

Padrão: o usuário executando o script de inicialização

\-f

Opcional.

Ignorar mensagens de aviso ou verificação de versão de distribuição.

\-h | -?

Opcional.

Exibe o texto de ajuda do script.

\-q

Opcional.

Silencioso, suprime a saída, exceto para erros e avisos.

\--debug

Opcional.

Imprima cada comando conforme ele é executado para fins de depuração. Produz saída extensa.

\--default-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que permite autorização para acessar o Tableau RMT Agent. Se especificado então `--unprivileged-user` também deve ser especificado.

\---desabilitar-criação-de-conta

**Versão:** adicionado na versão 2023.1.0

Opcional.

Contas/grupos inexistentes não serão criados. Se especificado, você também deve especificar o parâmetro `--unprivileged-user` e uma combinação de `--default-group` e/ou outros parâmetros `--rmt-<...>-group`. A ID do usuário e os grupos aos quais esses parâmetros se referem já devem existir.

\--rmt-authorized-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório de instalação base de instalação e a pasta `install_dir/prerequisites`. Se especificado então `--unprivileged-user` também deve ser especificado.

Padrão: valor "`rmtagentapp`" ou `--default-group`

\--rmt-config-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/agent/config`. Se especificado então `--unprivileged-user` também deve ser especificado.

Padrão: valor "`rmtagentconfig`" ou `--default-group`

\--rmt-logs-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/agent/logs`. Se especificado então `--unprivileged-user` também deve ser especificado.

Padrão: valor "`rmtagentlogs`" ou `--default-group`

\--unprivileged-user=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome da conta de usuário sem privilégios usada para executar o Tableau RMT Agent. Você não pode alterar a conta após inicializar o RMT.

Padrão: "`tabrmt-agent`"

<!-- document id=fee41da6cfca96f896a2c6d7b5469782fc9f55e1659fbd9ae493bfd6589154de url=/tableau/current/pt-br/server/rmt-install-init-server-opts.md -->

[Pular para o conteúdo principal](#main-content)

# Opções de script de inicialização do RMT Server

Depois de instalar o RMT Server, você precisa inicializar o servidor. Por padrão, o único sinalizador obrigatório que você deve incluir ao executar o script de inicialização é `--accepteula`. Outras opções oferecem flexibilidade para personalizar a instalação com base em seu ambiente e nos requisitos de segurança de sua empresa.

\--accepteula

Obrigatório.

Indica que você leu e aceitou os termos do Contrato de Licença de Usuário Final (EULA).

\-a <username>

Opcional.

Adicione o nome de usuário fornecido aos grupos apropriados, em vez do usuário executando o script de inicialização. Isso dá ao usuário acesso aos recursos pertencentes aos grupos. Isso não é o mesmo que a conta de usuário Run As.

Padrão: o usuário executando o script de inicialização

\-f

Opcional.

Ignorar mensagens de aviso ou verificação de versão de distribuição.

\-h | -?

Opcional.

Exibe o texto de ajuda do script.

\-q

Opcional.

Silencioso, suprime a saída, exceto para erros e avisos.

\--debug

Opcional.

Imprima cada comando conforme ele é executado para fins de depuração. Produz saída extensa.

\--default-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que permite autorização para acessar o Tableau RMT Agent. Se especificado então `--unprivileged-user` também deve ser especificado.

\---desabilitar-criação-de-conta

**Versão:** adicionado na versão 2023.1.0

Opcional.

Contas/grupos inexistentes não serão criados. Se especificado, você também deve especificar o parâmetro `--unprivileged-user` e uma combinação de `--default-group` e/ou outros parâmetros `--rmt-<...>-group`. A ID do usuário e os grupos aos quais esses parâmetros se referem já devem existir.

\--enable-fips

**Versão:** adicionado na versão 2025.3.0 Somente RHEL 8 Linux. Para obter mais informações, consulte [Conformidade com FIPS no Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-fips-compliance.htm).

Opcional.

Ative o modo FIPS no RMT ao instalar em computadores com RHEL 8.

\--rmt-authorized-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório de instalação base de instalação e a pasta `install_dir/prerequisites`. Se especificado então `--unprivileged-user` também deve ser especificado.

Padrão: valor "`rmtmasterapp`" ou `--default-group`

\--rmt-config-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/master/config`. Se especificado então `--unprivileged-user` também deve ser especificado.

Padrão: valor "`rmtmasterconfig`" ou `--default-group`

\--rmt-logs-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/master/logs`. Se especificado então `--unprivileged-user` também deve ser especificado.

Padrão: valor "`rmtmasterlogs`" ou `--default-group`

\--rmt-openssl-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/prerequisites/openssl`.

Padrão: valor "`rmtopenssl`" ou `--default-group`

\--rmt-postgres-app-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/prerequisites/postgresql13`.

Padrão: valor "`rmtpostgresapp`" ou `--default-group`

\--rmt-postgres-data-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório install\_dir/master/logs. Se especificado então `--unprivileged-user` também deve ser especificado.

Padrão: valor "`rmtmasterlogs`" ou `--default-group`

\--rmt-rabbitmq-app-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/prerequisites/rabbitmq`.

Padrão: valor "`rmtrabbitmqapp`" ou `--default-group`

\--rmt-rabbitmq-data-group=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome do grupo que tem o diretório `install_dir/data/rabbitmq`.

Padrão: valor "`rmtrabbitmqdata`" ou `--default-group`

\--unprivileged-user=<value>

**Versão:** adicionado na versão 2023.1.0

Opcional.

Nome da conta de usuário sem privilégios para executar o Tableau RMT Master. Você não pode alterar a conta após inicializar o RMT.

Padrão: "`tabrmt-master`"

<!-- document id=4efac60a9c62f49e2ebd8e2929152832062fa676ac17bd2f7369f24530a9aa08 url=/tableau/current/pt-br/server/cli_configuration-set_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# Opções do tsm configuration set

Veja abaixo uma lista de opções ou chaves de configuração que você pode definir com o comando `[tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet)`. Em muitos casos, é possível descobrir o valor atual de uma chave de configuração com o comando `tsm configuration get`.

Esta lista não descreve todas as configurações do Tableau Server. Ela representa um subconjunto de teclas de configuração que podem ser definidas pelos administradores do servidor. Por fim, algumas teclas usadas internamente pelo Tableau Server não aparecem nessa lista.

**Observação:** as chaves de configuração diferenciam letras maiúsculas de minúsculas.

## Uso da CLI do tsm

Você pode executar comandos tsm no nó inicial (o nó onde o TSM está instalado) ou em qualquer nó adicional no cluster.

Para executar comandos tsm, é necessário abrir um prompt de comando do Windows. Não use o PowerShell para executar comandos tsm. O uso do PowerShell pode causar um comportamento inesperado.

1. Abra o prompt de comando do Windows com uma conta que seja membro do grupo de Administradores em um nó no cluster.
2. Execute o comando desejado. Se você estiver executando o comando de um nó diferente do nó inicial, inclua a opção `-s` para especificar a URL do nó inicial por nome (não por endereço IP) e inclua a porta do TSM, 8850.
    
    Para ver a versão do TSM e do Tableau Server no nó inicial:
    
    `tsm version`
    
    Para ver a versão do TSM e do Tableau Server de um nó adicional:
    
    `tsm version -s https://<inital_node_name>:8850`
    
    Por exemplo:
    
    `tsm version -s https://myTableauHost:8850`

## Uso básico das chaves do tsm configuration

### Definir uma chave de configuração

`tsm configuration set -k <config.key> -v <config_value>`

Em alguns casos, você deve incluir a opção `--force-keys` para definir um valor de configuração para uma chave que ainda não foi definida. Para obter mais informações, consulte as [Respostas "Chave desconhecida"](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#configGetNote).

Depois de definir um valor de chave de configuração, aplique as alterações de configuração pendentes usando o comando `[tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply)`. Até que faça isso, o novo valor não será usado pelo Tableau ou mostrado nos resultados de um comando `tsm configuration get`. Veja as alterações pendentes usando o `tsm pending-changes list`. Para obter mais informações, consulte [tsm pending-changes](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm).

### Redefinir uma chave de configuração para o padrão

Para redefinir uma chave de configuração novamente como o valor padrão, use a opção `-d`:

`tsm configuration set -k <config.key> -d`

### Exibir o valor atual de uma chave de configuração.

Para ver a que uma chave de configuração está atribuída no momento, use o comando `configuration get`:

`[tsm configuration get](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMGet) -k <config.key>`

Existem dois casos especiais que não retornarão um valor atual útil para uma chave:

- Em determinados casos, não é possível obter um valor de configuração para uma chave que ainda não foi definida explicitamente. Em vez disso, o comando `tsm configuration get` retornará uma resposta “Chave desconhecida”. Para obter mais informações, consulte as [Respostas "Chave desconhecida"](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#configGetNote).
- Para certas chaves com valores padrão predefinidos, o comando `tsm configuration get` retornará uma resposta "Null". Para obter mais informações, consulte as [Respostas com valor "Null"](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#configGetNullDefault).

## Chaves de configuração

### adminviews.disabled

Valor padrão: `false`

Desabilita o acesso às exibições administrativas do Tableau. Por padrão, o acesso a exibições fica habilitado (esta opção é definida como "false").

### api.server.enabled

**Versão:** obsoleto na versão 2023.1. Você não pode desativar a API REST na versão 2023.1 e posterior.

Valor padrão: `true`

Permite o acesso à [REST API do Tableau Server](https://help.tableau.com/current/api/rest_api/pt-br/help.htm#REST/rest_api.htm).

Por padrão, essa funcionalidade fica desabilitada. É altamente recomendável que você mantenha essa configuração. Desabilitar a API REST interromperá a funcionalidade de uma ampla variedade de recursos do Tableau. Não melhorará o desempenho nem aumentará a segurança. Se você optar por desabilitar a API REST em sua instalação do Tableau Server, teste a funcionalidade necessária com cuidado.

A funcionalidade afetada pela desativação da API REST inclui:

- Pesquisa
- Favoritos
- Coleções
- Ferramenta de gerenciamento de conteúdo (CMT)
- Resource Monitoring Tool (RMT):
- Espaços pessoais

### auditing.enabled

Valor padrão: `true`

Permite acesso às tabelas de auditoria de histórico PostgreSQL (banco de dados próprio do Tableau Server).

### backgrounder.default\_run\_now\_priority

Valor padrão (inteiro): 0

Esta configuração controla qual prioridade é atribuída para executar agora trabalhos, com 0 sendo a prioridade mais alta. Os valores que devem ser especificados devem estar no intervalo de 0 a 100.

### backgrounder.enable\_parallel\_adsync

**Versão:** adicionado na versão 2018.3.6

Valor padrão: `false`

Controla se o processamento paralelo de trabalhos de sincronização de grupos de diretório externo é permitido quando há vários processadores em segundo plano. Por padrão, uma sincronização programada de grupos de diretório externo é tratada serialmente, por um único processador em segundo plano. Defina isso como `true` para permitir o processamento paralelo em várias instâncias do processador em segundo plano.

### backgrounder.externalquerycachewarmup.enabled

**Versão:** obsoleto na versão 2023.1. Para melhorar os tempos de carregamento de exibição de pastas de trabalho de Tableau Server, permita a [Aceleração de exibição](https://help.tableau.com/current/server/pt-br/data_acceleration.htm) em seu site.

Valor padrão: `false`

Controla o armazenamento em cache dos resultados de consulta da pasta de trabalho após as tarefas agendadas de atualização da extração.

### backgrounder.externalquerycachewarmup.view\_threshold

**Versão:** obsoleto na versão 2023.1. Para melhorar os tempos de carregamento de exibição de pastas de trabalho de Tableau Server, permita a [Aceleração de exibição](https://help.tableau.com/current/server/pt-br/data_acceleration.htm) em seu site.

Valor padrão: `2.0`

O limite de armazenamento em cache dos resultados da consulta da pasta de trabalho após as tarefas agendadas de atualização da extração. O limite é igual ao número de visualizações que uma pasta de trabalho recebeu nos últimos sete dias, dividido pelo número de atualizações agendadas nos próximos sete dias.

As duas opções de comando do _processador em segundo plano_ a seguir determinam quanto tempo uma tarefa de fluxo pode ser executada antes que a tarefa em segundo plano do fluxo seja cancelada. Esses dois comandos determinam o valor total de tempo limite para as tarefas de fluxo.

### backgrounder.extra\_timeout\_in\_seconds

Valor padrão: `1800`

O número de segundos além da configuração em `backgrounder.querylimit` antes que um trabalho em segundo plano seja cancelado. Essa configuração garante que um trabalho interrompido não retenha os trabalhos subsequentes. A configuração aplica-se a processos listados em `backgrounder.timeout_tasks`. 1800 segundos são 30 minutos.

### backgrounder.default\_timeout.run\_flow

Valor padrão: `14400`

O número de segundos antes de uma tarefa de execução de fluxo ser cancelada. 14.400 segundos são 4 horas.

### backgrounder.failure\_threshold\_for\_run\_prevention

Valor padrão: `5`

O número de falhas consecutivas de uma inscrição ou de um trabalho de extração antes da suspensão do trabalho. A suspensão de trabalhos que falham continuamente ajuda a preservar os recursos do processador em segundo plano para outros trabalhos. Para desabilitar a suspensão de tarefas em segundo plano que falham, defina como `-1`.

### backgrounder.flow\_failure\_threshold\_for\_run\_prevention

Valor padrão: `5`

O número de falhas consecutivas de um trabalho de execução de fluxo antes da suspensão do trabalho. A suspensão de trabalhos que falham continuamente ajuda a preservar os recursos do processador em segundo plano para outros trabalhos. Para desabilitar a suspensão de tarefas em segundo plano que falham, defina como `-1`.

### backgrounder.log.level

**Versão:** adicionado na versão 2020.3.0

Valor padrão: `info`

O nível de registro para o método do processador em segundo plano. Pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### backgrounder.querylimit

Valor padrão: `7200`

Tempo mais longo permitido, em segundos, para a conclusão de um único trabalho de atualização de extração. 7200 segundos = 2 horas.

**Observação:** se um trabalho em segundo plano chegar ao tempo limite, ela poderá continuar em execução por mais alguns minutos enquanto é cancelada.

### backgrounder.restrict\_serial\_collections\_to\_site\_level

Valor padrão: `false`

No Tableau Server, você pode agendar atualizações de extração, assinaturas ou fluxos para serem executados periodicamente. Esses itens agendados são chamados de tarefas. O processo do Processador em segundo plano inicia instâncias exclusivas dessas tarefas para executá-las no horário agendado. As instâncias exclusivas das tarefas iniciadas como resultado são chamadas de trabalhos.

Essa configuração afeta os agendamentos configurados para serem executados em série. Por padrão, quando uma agenda é configurada para ser executada em série, todos os trabalhos que usam essa programação serão executados em série. Quando essa configuração é definida para`true`, os trabalhos executados em sites diferentes podem ser executados em paralelo. Os trabalhos para tarefas agendadas no mesmo site continuarão a ser executadas em série.

O exemplo abaixo ilustra este cenário:

O Tableau Server inclui uma programação chamada "Diariamente" para executar trabalhos todos os dias às 7h. A programação "Diária" está configurada para ser executada em série. Os sites "RH" e "Folha de pagamento" têm, cada um, várias tarefas agendadas que usam a agenda "Diariamente". Quando esta configuração é definida para`true`, os trabalhos para essas tarefas agendadas no site "RH" podem ser executados em paralelo com os trabalhos no site "Folha de pagamento", enquanto os trabalhos no mesmo site ainda serão executados apenas em série.

### backgrounder.notifications\_enabled

Valor padrão: `true`

Controla se os alertas de atualização de extração e execução de fluxo estão habilitados para todos os sites no servidor. Por padrão, os alertas estão habilitados. Para desabilitar os alertas para todos os sites em um servidor, defina-os como `false`.

Os alertas de extração podem ser habilitados ou desabilitados com por site pelos administradores de site nas configurações de site ou no nível do usuário nas configurações do usuário.

### backgrounder.sort\_jobs\_by\_type\_schedule\_boundary\_heuristics\_milliSeconds

Valor padrão: `60000`

Controla o intervalo de tempo que identifica os trabalhos do processador em segundo plano cujo horário de início agendado foi determinado como o mesmo.

O processo do processador em segundo plano classifica o trabalho que está agendado no mesmo horário para ser executado pelo tipo de trabalho, executando a categoria mais rápida de trabalhos primeiro:

Os trabalhos são divididos em lote para determinar quais trabalhos estão agendados “ao mesmo tempo”. Um valor de 60.000 milissegundos (o padrão) indica os trabalhos com agendamentos com início em um intervalo de 1 minuto devem ser classificados no mesmo lote e são classificados por tipo nesse lote.

### backgrounder.subscription\_failure\_threshold\_for\_run\_prevention

Valor padrão: `5`

Determina o número de falhas consecutivas na assinatura que devem ocorrer antes que o alerta de uma condição seja suspenso. Quando definido para o padrão `5`, o alerta é suspenso após 5 falhas de assinatura consecutivas. Um valor de `-1` permitirá que a notificação por e-mail continue indefinidamente. Esse limite é para todo o servidor, de forma que se aplica a todas as assinaturas definidas no servidor.

### backgrounder.subscription\_image\_caching

Valor padrão: `true`

Controla se o processador em segundo plano colocará em cache as imagens geradas para inscrições. As imagens em cache não precisam ser sempre regeneradas, sendo assim, o armazenamento em cache melhora o desempenho da inscrição. Por padrão, o cache de imagens está habilitado. Para desabilitar o cache de imagens em todos os sites em um servidor, defina como `false`.

### backgrounder.timeout\_tasks

Valor padrão: o valor padrão pode ser diferente, dependendo da sua versão do Tableau Server. Para ver a lista de valores padrão para sua versão do Tableau, execute o comando `tsm configuration get`:

tsm configuration get -k backgrounder.timeout\_tasks

A lista de tarefas poderá ser cancelada se elas forem executadas em um período mais longo que os valores combinados em `backgrounder.querylimit` e `backgrounder.extra_timeout_in_seconds`. Essa lista é delimitada por vírgulas. A lista padrão representa todos os valores possíveis para esta configuração.

### backgrounder.timeout.single\_subscription\_notify

**Versão:** adicionado na versão 2021.2.

Valor padrão: `1800` segundos (30 minutos)

Este é o tempo máximo permitido especificado em segundos para concluir um único trabalho de assinatura.

### backgrounder.timeout.sync\_ad\_group

**Versão:** adicionado na versão 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1.

Valor padrão: `14400` segundos (4 horas)

Este é o tempo máximo permitido, especificado em segundos, para concluir uma sincronização de grupo do Active Directory. Isso se aplica á sincronizações de grupo _agendadas_ feitas pelo serviço de processador em segundo plano e impede que sincronizações de execução longa sejam executadas indefinidamente. Isso não afeta as sincronizações de grupo feitas usando a interface do usuário do Tableau Server ou a API REST.

### backgrounder.vInstances\_max\_overflow\_queue\_size

**Versão:** adicionado na versão 2022.1.2.

Valor padrão: `1000`

O número máximo de trabalhos que podem estar na fila secundária. Ima fila secundária é criada quando o número de trabalhos em execução está no limite de simultaneidade definido. O máximo padrão é definido como 1.000 trabalhos - o que significa que, se houver mais de 1.000 trabalhos quando o limite de simultaneidade for atingido, mais de 1.000 trabalhos não serão enfileirados. Use o comando backgrounder.vInstance\_max\_overflow\_queue\_size tsm para fazer alterações no tamanho máximo da fila de estouro.

Os valores devem ser especificados em números inteiros.

### backup.zstd.thread\_count

**Versão:** adicionado na versão 2021.1.0 Essa chave é dinamicamente configurável. Para obter mais informações, consulte [Alterações de topologia dinâmica do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_hot_topo.htm).

Valor padrão: 2

O número de segmentos que devem ser usado ao criar um backup.

O aumento desse número pode melhorar o desempenho do backup, mas recomendamos que a contagem de segmentos não exceda o número de quatro processadores lógicos no computador Tableau Server.

### backuprestore.use\_custom\_staging\_dir.enabled

**Versão:** adicionado na versão 2026.2.0

Valor padrão: `false`

Determina se o processo backup deve usar o diretório de preparo personalizado para reunir o arquivo de backup (`.tsbak`).

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` e habilitar essa configuração, 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.

Para definir isso como `true` (e usar o diretório de preparo personalizado), execute estes comandos:

tsm configuration set -k backuprestore.use\_custom\_staging\_dir.enabled -v true  
tsm pending-changes apply

O diretório de preparo personalizado é definido pela configuração `basefilepath.backuprestore`.

Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

### basefilepath.backuprestore

Valor padrão: `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ``

O local em que o comando `tsm maintenance backup` cria o backup. Esse também é o local onde o arquivo de backup deve estar quando restaurado usando o comando `tsm maintenance restore`. Depois de definir isso, você deve 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 definidas corretamente para o local. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

### basefilepath.log\_archive

Valor padrão: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\`

O local em que o comando `tsm maintenance ziplogs` cria o arquivo compactado. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

### basefilepath.site\_export.exports

Valor padrão: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports\`

O local em que o comando `tsm sites export` cria o arquivo de exportação. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

### basefilepath.site\_import.exports

Valor padrão: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\`

O local em que o comando `tsm sites import` espera que o arquivo de importação esteja localizado. Para obter mais informações, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

### clustercontroller.log.level

**Versão:** adicionado na versão 2020.3.0

Valor padrão: `info`

O nível de registro para o Controlador de cluster. Pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### clustercontroller.zk\_session\_timeout\_ms

Valor padrão: `300000`

A duração do tempo, em milissegundos, que o Controlador do cluster aguardará o Serviço de coordenação (ZooKeeper), antes de determinar que o failover é necessário.

### dataAlerts.checkIntervalInMinutes

Valor padrão: `60`

A frequência, em minutos, em que o Tableau Server faz verificações para determinar se as condições de alerta de dados são verdadeiras.

(O servidor também verifica sempre que as extrações relacionadas aos alertas de dados são atualizadas.)

### dataAlerts.retryFailedAlertsAfterCheckInterval

Valor padrão: `true`

Determina com que frequência o Tableau Server verifica novamente os alertas de falha. Ao definir como `true`, o servidor verifica novamente os alertas de falha na frequência definida por `dataAlerts.checkIntervalInMinutes`. Ao definir como `false`, o servidor verifica novamente os alertas de falha a cada cinco minutos, recebendo alertas de notificação mais rápidos se as condições dos dados se alterarem, mas reduzindo o desempenho do servidor.

(O servidor também verifica sempre que as extrações relacionadas aos alertas de dados são atualizadas.)

### dataAlerts.SuspendFailureThreshold

Valor padrão: `350`

Determina o número de falhas consecutivas de alerta de dados que devem ocorrer antes que o alerta de uma condição seja suspenso. Quando definido para o padrão 350, o alerta é suspenso após cerca de duas semanas de alertas. Esse limite é para todo o servidor, portanto se aplica a qualquer alerta de dados definido no servidor.

### databaseservice.max\_database\_deletes\_per\_run

**Versão:** adicionado na versão 2021.2.

Valor padrão: null

Use esta opção para ajustar o número máximo de ativos externos inseridos (bancos de dados e tabelas) que podem ser excluídos a cada vez que é executado o processo em segundo plano, controlado por `features.DeleteOrphanedEmbeddedDatabaseAsset`. Se esta opção for deixada em branco, o número máximo padrão de ativos externos inseridos que podem ser excluídos é 100.

Para obter mais informações, consulte [features.DeleteOrphanedEmbeddedDatabaseAsset](#metadata_orphanembedded).

### dataserver.log.level

**Versão:** adicionado na versão 2020.3.0

Valor padrão: `info`

O nível de registro para o Servidor de dados. Pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### dataserver\_<n>.port

Porta em que a instância do servidor de dados (especificada por "<n>") é executada.

### elasticserver.vmopts

**Versão:** adicionado na versão 2019.1. Removido: 2022.1

**Essa opção de configuração não é válida para o Tableau Server versões 2022.1 e posteriores.** Para o Tableau Server versões 2022.1 e posteriores, use a opção de configuração [`indexandsearchserver.vmopts`](#indexsearchserver)

Valor padrão: `-Xmx<default_value> -Xms<default_value>`

O valor padrão varia de acordo com a quantidade de memória do sistema. O tamanho máximo da pilha JVM é dimensionado para 3,125% da RAM total do sistema.

Controla o tamanho da pilha do Elastic Server. Como o valor padrão é dimensionado automaticamente, use essa opção para substituir o valor padrão somente quando absolutamente necessário. Acrescente a letra "k" ao valor para indicar kilobytes, "m" para indicar megabytes e "g" para indicar gigabytes. Como regra geral, defina o tamanho da pilha inicial (`-Xms`) igual ao tamanho da pilha máxima (`-Xmx`) para minimizar as coletas de lixo.

### excel.shadow\_copy\_all\_remote.enabled

**Versão:** adicionado nas versões 2019.1.5, 2019.2.1.

Valor padrão: `false`

Controla se o Tableau Server cria uma "shadow copy" de uma planilha do Excel compartilhada (`.xlxs` ou `.xlxm`) que está sendo usada como fonte de dados dinâmica. Quando ativada, essa opção impede que os usuários do Excel vejam um "Erro de violação de compartilhamento" e uma mensagem que o arquivo está em uso. Essa opção pode ter um impacto no desempenho com arquivos grandes do Excel. Se os usuários do Excel não precisarem editar o arquivo compartilhado, não será necessário habilitar essa opção.

**Observação:** o Tableau Server sempre tenta criar uma “shadow copy” de um arquivo `.xls`. Essa opção não altera esse comportamento.

### extractservice.command.execution.timeout

**Versão:** adicionado na versão 2021.4.

Valor padrão: `7200` segundos

Define o valor de tempo limite para o tempo de execução de atualização da extração VConn.

Exemplo: `tsm configuration set -k extractservice.command.execution.timeout -v <timeout_in_seconds> --force-keys`

**Observação:** Você deve usar a opção `--force-keys` para alterar este valor.

### features.ActiveMQ

**Versão:** adicionado na versão 2021.4.

Valor padrão: `true`

Controla se o Tableau Server usa o serviço Apache ActiveMQ (Serviço de mensagens do Tableau Server) para o mecanismo interno de mensagens.

### features.DeleteOrphanedEmbeddedDatabaseAsset

**Versão:** adicionado na versão 2021.2.

Valor padrão: `true`

Controla um processo em segundo plano, para o Tableau Catalog (ou a API de metadados do Tableau), que exclui ativos externos inseridos (bancos de dados e tabelas) que não estão mais associados ao conteúdo downstream do Tableau. Esse processo é executado todos os dias às 22:00:00 UTC (horário universal coordenado) e pode excluir no máximo 100 ativos externos por dia até que não haja mais ativos externos sem conexões com o conteúdo downstream do Tableau. Você pode definir esta opção para `false` e interromper a execução desse processo. Como alternativa, você também pode ajustar o número máximo de ativos integrados externos que podem ser excluídos usando [databaseservice.max\_database\_deletes\_per\_run](#metadata_orphanembedded_maxnumber) .

Para obter mais informações, consulte [Solucionar problemas de conteúdo ausente](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#troubleshoot_orphanembedded).

### features.DesktopReporting

Valor padrão: `false`

Controla se o Relatório de licenciamento do Desktop está habilitado no servidor. Quando definido como `false` (o padrão), nenhuma Exibição administrativa relacionada às licenças do desktop fica disponível. Ajuste como `true`para habilitar o Relatório de licenciamento e tornar disponíveis as Exibições administrativas de utilização de licença e de expiração na página Status do servidor. **Observação:** o Relatório de licenciamento do Desktop deve ser ativado no cliente (Tableau Desktop) para que as informações sejam relatadas ao Tableau Server.

### features.IdentityMigrationBackgroundJob

**Versão** adicionado na versão 2022.1.

Valor padrão: `false`. O valor padrão foi alterado para `false` iníciando nas versões 2021.4.22, 2022.1.18, 2022.3.10, 2023.1.6 e 2023.3.

Controla o processo que executa a migração de identidade. Quando definido para `true`, a migração de identidade é executada em implantações existentes imediatamente após a atualização do Tableau Server para a versão 2022.1 (ou posterior) e a restauração de um backup do Tableau Server versão 2021.4 (ou anterior). Definido como `false` (padrão) para desabilitar a migração de identidade.

Por exemplo, para iniciar a migração de identidade, execute o seguinte:

`tsm configuration set -k features.IdentityMigrationBackgroundJob -v true`

Para obter mais informações, consulte [Sobre a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm).

**Observação:** se a migração de identidade estiver desabilitada, o Tableau Server não poderá usar o Serviço de identidade para armazenar e gerenciar informações de identidade do usuário. Usar o Serviço de identidade é um pré-requisito para determinados recursos como [pools de identidades](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

### features.IdentityPools

**Versão:** adicionado na versão 2023.1.

Valor padrão: `false`

Um componente do recurso de grupos de identidades que precisa ser habilitado se você executar uma nova instalação do Tableau Server. Requer `feature.NewIdentityMode` e `wgserver.authentication.legacy_identity_mode.enabled`. Defina como `true` para habilitar a geração de pools de identidade. Defina como `false` (padrão) para desabilitar pools de identidade.

Por exemplo, para habilitar os pools de identidades, execute o seguinte:

```
tsm configuration set -k features.IdentityPools -v true
tsm configuration set -k features.NewIdentityMode -v true
tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
tsm pending-changes apply
```

Para obter mais informações, consulte [Solucionar problemas de pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools_manage.htm#troubleshoot).

### features.JWTSupportForSCIM

**Versão:** adicionado na versão 2025.3

Valor padrão: `false`

Permite o uso de um JWT gerado externamente (por meio de um aplicativo conectado ao Tableau) para dar suporte a solicitações SCIM. O uso de um token externo ignora o token SCIM gerado pelo Tableau.

Defina como `true` para habilitar esse recurso.

```
tsm configuration set -k features.JWTSupportForSCIM -v true
tsm pending-changes apply
```

Para obter mais informações, consulte [SCIM](https://help.tableau.com/current/server/pt-br/scim_config_online.htm).

### features.MessageBusEnabled

**Versão:** adicionado na versão 2019.4.

Valor padrão: `true`

Controla se o Tableau Server usa o novo mecanismo interno de mensagens.

### features.NewIdentityMode

**Versão** adicionado na versão 2022.1.

Valor padrão: `false`. O valor padrão foi alterado para `false` iniciando nas versões 2021.4.22, 2022.1.18, 2022.3.10, 2023.1.6 e 2023.3.0.

Um pré-requisitos de capacidade de pools de identidades. Requer `wgserver.authentication.legacy_identity_mode.enabled` que seja definido como `false` para desabilitar pools de identidades. Definido como `true` para desabilitar pools de identidades.

```
tsm configuration set -k features.IdentityPools -v true
tsm configuration set -k features.NewIdentityMode -v true
tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
tsm pending-changes apply
```

Para obter mais informações, consulte [Solucionar problemas de pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools_manage.htm#troubleshoot).

### features.PasswordlessBootstrapInit

Valor padrão: `true`

Controla se o Tableau Server permite credenciais inseridas em arquivos boostrap. Quando habilitada (o padrão), as credenciais inseridas são incluídas no arquivo bootstrap, a menos que você especifique que elas não devem ser incluídas. Defina como `false` se as credenciais nunca devam ser incluídas em qualquer arquivo bootstrap que você gerar. Para obter mais informações sobre como gerar arquivos bootstrap, consulte [tsm topology nodes get-bootstrap-file](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMGetBootstrap).

Essa opção foi adicionada com a versão do Tableau Server 2019.3.

### features.PasswordReset

**Versão:** descontinuado na versão 2024.2. Para versões 2024.2 e posteriores, use `vizportal.password_reset`.

Valor padrão: `false`

Aplica-se apenas aos servidores que usam autenticação local. Defina como `true`para permitir que os usuários redefinam suas senhas com a opção "Esqueci a senha" na página de logon.

### Características. VizDataServiceClientEnable

**Versão:** adicionado na versão 2024.2.

Valor padrão: `false`

Permite suporte completo para funções de atributo do usuário descritas em [Personalizar e controlar o acesso a dados usando atributos do usuário](https://help.tableau.com/current/api/embedding_api/pt-br/docs/embedding_api_user_attributes.html) na Ajuda da Embedding API v3 do Tableau.

Quando definidas como `false`, as funções de atributos do usuário não oferecem suporte a fontes de dados publicadas. Quando definidas como `true`, o recurso de funções de atributo do usuário oferece suporte a fontes de dados na inserção de fluxos de trabalho e fontes de dados publicadas. Por exemplo, execute o seguinte: `tsm configuration set -k features.VizDataServiceClientEnable -v true`.

**Nota:** esse sinalizador não pode ser usado para habilitar atributos de usuário de OIDC e SAML. Para usar atributos do usuário em fluxos de trabalho de autenticação OIDC e SAML, use a interface do usuário do TMS.

### features.VizqlDataServiceDeployWithTsm

**Versão:** adicionado na versão 2025.1.

Valor padrão: `true`

Controla se o Vizql Data Service está habilitado. Quando habilitado (o padrão), o serviço expõe os endpoints HTTP do VizQL Data Service para que os usuários interajam programaticamente.

Se você não for usar o VizQL Data Service para acesso programático, poderá desabilitar o recurso. Isso ocultará o serviço na interface do usuário do TSM. Para fazer isso, você deve primeiro definir o número de instâncias do serviço como zero (0).

Por exemplo:

tsm topology set-process --count 0 --process vizqldataservice --node <nodeName>  
tsm configuration set -k features.VizqlDataServiceDeployWithTsm -v false  
tsm pending-changes apply

O VizQL Data Service foi projetado para ser acessado pela API. Você não pode tirar proveito disso na interface do usuário do Tableau Server. Para obter mais informações sobre o serviço, consulte [VizQL Data Service do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_vizql-data-service.htm#TSMGetBootstrap).

Para obter informações sobre a API do VizQL Data Service, consulte a [Referência da API do VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/pt-br/index.html "link para referência da API do VDS").

### features.VizqlDataServicePermission

**Versão:** adicionado na versão 2025.1.

Valor padrão: `true`

Habilita a verificação de permissão para a regra de permissões de fonte de dados "Acesso à API". A regra de permissão da fonte de dados de acesso à API é definida na caixa de diálogo de permissão para grupos ou usuários. Desativar o sinalizador de permissão desabilitará a verificação de permissão e todas as funções do site (exceto as não licenciadas) poderão acessar as APIs do VizQL Data Service. Consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

Para acesso total à resposta do VizQL Data Service, os usuários também devem receber permissões de visualização e conexão da fonte de dados para obter acesso total à fonte de dados subjacente.

Configuração recomendada para acesso à API do VizQL Data Service (consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm) para obter mais detalhes):

- Mantenha o sinalizador de permissão habilitado e defina regras de permissão de capacidade de acesso à API para grupos em vez de usuários na caixa de diálogo de permissão do Tableau Server.
- Gerencie as permissões de acesso à API no nível do projeto em vez de definir permissões para conteúdo de fonte de dados individual.
- Certifique-se de que a permissão de acesso à API do grupo Todos os usuários esteja definida como **Nenhum**.

O VizQL Data Service foi projetado para ser acessado pela API. Você não pode tirar proveito disso na interface do usuário do Tableau Server. Para obter mais informações sobre o serviço, consulte [VizQL Data Service do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_vizql-data-service.htm#TSMGetBootstrap).

Para obter informações sobre a API do VizQL Data Service, consulte a [Referência da API do VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/pt-br/index.html "link para referência da API do VDS").

### filestore.empty\_folders\_reaper.enabled

**Versão:** adicionado em 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2) e 2021.1.x. O valor padrão foi alterado para `true` em 2021.2.

Valor padrão: `true`

Habilita o trabalho que "colhe" (remove) pastas vazias do Filestore.

### filestore\_empty\_folders\_reap.frequency\_s

**Versão:** adicionado em 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2).

Valor padrão: `86400` (24 horas)

Especifica, em minutos, com que frequência executar o trabalho que remove as pastas vazias do Filestore.

### features.Hyper\_DisallowTDEPublishing

**Versão:** o padrão é `true` começando na versão 2023.1.0. Descontinuado em 2024.2. Desativado em 2025.1.

Valor padrão: `true`

Especifica se os usuários podem fazer upload de arquivos no formato .tde. Esse formato foi substituído pelo formato .hyper a partir da versão 10.5 do Tableau Server, mas não teve o carregamento bloqueado. A partir da Versão 2024.3, os arquivos no formato .tde não são mais utilizáveis. Os arquivos foram convertidos automaticamente para o formato .hyper se uma das várias ações fosse executada. Para obter mais informações, consulte [Atualização de extrações para o formato .hyper](https://help.tableau.com/current/server/pt-br/extracting_upgrade.htm).

### filestore.log.level

**Versão:** adicionado na versão 2020.3.0

Valor padrão: `info`

O nível de registro do Armazenamento de arquivos. Pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### filestore.reapemptyfoldersholdoffms

**Versão:** adicionado em 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2). Isso ainda não está disponível em 2021.1.

Valor padrão:`300000` (5 minutos)

Especifica, em milissegundos, a quantidade de tempo de espera antes de remover as pastas vazias do Filestore.

### floweditor.max\_datafile\_upload\_size\_in\_kb

**Versão:** adicionado na versão 2020.4

Valor padrão: `1048576`

Para criação de fluxo na Web do Tableau Prep, o tamanho máximo dos arquivos de texto delimitados (por exemplo, CSV ou TXT) que podem ser carregados no Tableau Server.

### gateway.external\_url

**Versão:** adicionado na versão 2023.1.

Valor padrão: Null

Obrigatório quando a autenticação OpenID Connect (OIDC) é configurada no TSM durante a configuração do Tableau Server ou com pools de identidades. Especifica a URL do Tableau Server usada pelo provedor de identidade (IdP) para redirecionar os usuários que se autenticam no Tableau. A URL externa do gateway é a mesma URL que você definiu como a URL de redirecionamento com seu IdP. Isso é usado para fins de correspondência.

Por exemplo, para redirecionar o IdP associado à configuração de autenticação OIDC para o Tableau Server, http://myco, execute o seguinte comando:

`tsm configuration set -k gateway.external_url -v http://myco`

**Observação:** a partir da versão 2025.3, a URL especificada é o endpoint usado para logout único (SLO), se habilitado.

### gateway.http.cachecontrol.updated

Valor padrão: `false`

O cabeçalho HTTP de Controle de cache especifica se o navegador do cliente deve armazenar em cache o conteúdo enviado do Tableau Server. Para desabilitar o armazenamento em cache dos dados do Tableau Server no cliente, defina esta opção para `true`.

### gateway.http.hsts

Valor padrão: `false`

O cabeçalho do HTTP Strict Transport Security (HSTS) força os navegadores a usarem o HTTPS no domínio onde ele está habilitado.

### gateway.http.hsts\_options

Valor padrão: `"max-age=31536000"`

Por padrão, a política do HSTS está definida para um ano (31536000 segundos). Este período especifica o tempo em que o navegador acessará o servidor por meio do HTTPS.

### gateway.httpd.loglevel

**Versão:** adicionado em 2021.3.0.

Valor padrão: `notice`

Especifica o nível de registro para o Gateway (servidor Apache HTTPD). Por padrão, ele é definido como `notice`. Outras opções incluem `debug`, `info`, `warning`, `error`. Se você alterar o nível de registro, esteja ciente do impacto potencial no uso e no desempenho do espaço em disco. Como prática recomendada, retorne o nível de registro ao padrão depois de reunir as informações necessárias. Para obter informações detalhadas sobre o registro do Apache, consulte a [documentação do HTTP do Apache](https://httpd.apache.org/docs/2.4/mod/core.html#loglevel).

### gateway.httpd.shmcb.size

**Versão:** adicionado em 2021.4

Valor padrão: `2048000`

Especifica a quantidade de memória em bytes para o buffer circular ao usar o tipo de armazenamento `shmcb`. Essa chave de configuração não se aplica ao usar o tipo de armazenamento `dbm`.

### gateway.httpd.socache

**Versão:** adicionado em 2021.4

Valor padrão: `shmcb`

Especifica o tipo de armazenamento do Cache de Sessão SSL global/entre processos. Por padrão, isso é definido como `shmcb`, com outra opção `dbm` configurável. Para obter mais informações sobre os tipos de armazenamento `shmcb` e `dbm`, consulte [Diretiva SSLSessionCache](https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslsessioncache) no site da Web Apache.

### gateway.http.request\_size\_limit

Valor padrão: `16380`

O tamanho máximo (bytes) do conteúdo do cabeçalho que é permitido passar pelo gateway Apache nas solicitações HTTP. Os cabeçalhos que excedem o valor definido nessa opção resultarão em erros do navegador, como HTTP Erro 413 (entidade solicitada muito grande) ou falhas de autenticação.

Um valor baixo em `gateway.http.request_size_limit` pode resultar em erros de autenticação. As soluções de logon único que se integram ao Active Directory (SAML e Kerberos) frequentemente precisam de grandes tokens de autenticação em cabeçalhos HTTP. Certifique-se de testar os cenários de autenticação HTTP antes de implantar na produção.

Recomendamos definir a opção `tomcat.http.maxrequestsize` para o mesmo valor desta opção.

### gateway.http.x\_content\_type\_nosniff

Valor padrão: `true`

O cabeçalho de resposta X-Content-Type-Options do HTTP especifica que o tipo de MIME no cabeçalho Content-Type não deve ser alterado pelo navegador. Em alguns casos, onde o tipo de MIME não está especificado, o navegador pode tentar determiná-lo, avaliando as características da carga útil. O navegador exibirá o conteúdo em conformidade. Este processo é denominado "detecção". A interpretação errada do tipo de MIME pode levar à vulnerabilidades na segurança. Com essa opção, o cabeçalho X-Content-Type-Options do HTTP é definido, por padrão, como "não detecção".

### gateway.http.x\_xss\_protection

Valor padrão: `true`

O cabeçalho de resposta HTTP X-XSS-Protection é enviado para o navegador para habilitar a proteção de scripts entre sites (XSS). O cabeçalho de resposta X-XSS-Protection substitui as configurações nos casos em que os usuários desabilitaram a proteção XSS no navegador. Com essa opção, o cabeçalho de resposta X-XSS-Protection está habilitado por padrão.

### gateway.log.level

**Versão:** adicionado na versão 2020.3.0

Valor padrão: `info`

O nível de registro do Gateway. Pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### gateway.public.host

Valor padrão: <hostname>

O nome (a URL) do servidor, usado para acesso externo ao Tableau Server. Se o Tableau Server estiver configurado para funcionar com um servidor proxy ou balanceador de carga externo, ele será o nome inserido na barra de endereço do navegador utilizado para acessar o Tableau Server. Por exemplo, se o Tableau Server for acessado ao digitar `tableau.example.com`, o nome do gateway.public.host será `tableau.example.com`.

### gateway.public.port

Valor padrão: `80` (`443` se SSL)

Aplicável apenas a ambientes de servidor proxy. A porta externa em que o servidor proxy escuta.

### gateway.slow\_post\_protection.enabled

Valor padrão: `true`

Quando habilitado, pode oferecer alguma ajuda na proteção contra ataques de POST lentos (Negação de serviço) ao sincronizar as solicitações de POST que transferem os dados a taxas extremamente lentos.

**Observação:** isso não eliminará as ameaças de tais ataques e poderia ter o impacto não intencional de encerrar conexões lentas.

### gateway.slow\_post\_protection.request\_read\_timeout

Valor padrão: `header=10-30,MinRate=500 body=30,MinRate=500`

Quando ativada pela opção anterior, `gateway.slow_post_protection.enabled`, essa opção define o Apache httpd ReadRequestTimeout. A diretiva httpd está documentada em [Apache Module mod\_reqtimeout](https://httpd.apache.org/docs/2.4/mod/mod_reqtimeout.html). O uso primário dessa opção é como uma defesa ao ataque Slowloris. Veja a entrada da Wikipédia, [Slowloris (segurança do computador)](https://help.tableau.com/current/server/pt-br/%3Chttps://pt.wikipedia.org/wiki/Slowloris_ \(computer_security\)>).

**Observação:** versões mais antigas usam um valor padrão: `header=15-20,MinRate=500 body=10,MinRate=500`

### gateway.timeout

Valor padrão: `7200`

O tempo mais longo, em segundo, que o gateway aguardará por certos eventos antes de reprovar uma solicitação (7200 segundos = 2 horas).

### gateway.trusted

Valor padrão: o endereço IP do computador do servidor proxy

Aplicável apenas a ambientes de servidor proxy. Os endereços IP ou os nomes de host do servidor proxy.

### gateway.trusted\_hosts

Valor padrão: nomes alternativos do servidor proxy

Aplicável apenas a ambientes de servidor proxy. Qualquer nome de host alternativo do servidor proxy.

### hyper.file\_partition\_size\_limit

Valor padrão: `0`

Quando definido como 0, o tamanho é definido como ilimitado e usará todo o espaço em disco disponível.

Essa opção é usada para definir o limite de espaço em disco para uma determinada consulta que é transferida para o disco. Se o uso do espaço em disco pelo arquivo spool.<id>.tmp for maior do que você precisa que seja para o seu ambiente, significa que as consultas estão sendo transferidas e ocupando espaço em disco. Use essa opção para limitar a quantidade de espaço em disco que as consultas podem usar. O arquivo spool.<id>.tmp pode ser encontrado na pasta temporária da conta de usuário que executa o Tableau Server. É possível especificar esse valor em unidades K(KB), M(MB), G(GB) ou T(TB). Por exemplo, é possível especificar o limite de tamanho como 100G quando quiser limitar o uso de espaço em disco para 100 GB.

Para obter mais informações sobre a transferência, consulte a seção Uso da memória e da CPU no [Processador de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_engine2_intro.htm).

### hyper.global\_file\_partition\_size\_limit

Valor padrão: `0`

Quando definido como 0, o tamanho é definido como ilimitado e usará todo o espaço em disco disponível.

Essa opção é usada para definir o limite de espaço em disco para todas as consultas que são transferidas para o disco. Se o uso do espaço em disco pelo arquivo spool.<id>.tmp for maior do que você precisa que seja para o seu ambiente, significa que as consultas estão sendo transferidas e ocupando espaço em disco. O arquivo spool.<id>.tmp pode ser encontrado na pasta temporária da conta de usuário que executa o Tableau Server. Use essa opção para limitar a quantidade de espaço em disco total que todas as consultas usam ao transferir para o disco. É possível especificar esse valor em unidades K(KB), M(MB), G(GB) ou T(TB). Por exemplo, é possível especificar o limite de tamanho como 100G quando quiser limitar o uso de espaço em disco para 100 GB. O Tableau recomenda iniciar com essa configuração ao ajustar os limites de transferência.

Para obter mais informações sobre a transferência, consulte a seção Uso da memória e da CPU no [Processador de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_engine2_intro.htm).

### hyper.enable\_accesspaths\_symbolic\_canonicalization

Valor padrão: `false`

Em sistemas Windows OS, para resolver links simbólicos, o Hyper precisa ter acesso ao diretório onde as extrações são armazenadas e todos os seus diretórios pai. Se esse não for o caso, você poderá ver uma mensagem de erro no log do Hyper que diz: **Não é possível obter o caminho canônico para**`//dirA/subdir/myextract.hyper ... Access is denied`.

Nesses casos, você pode definir isso para `true` portanto, o Data Engine (Hyper) não tentará resolver links simbólicos ao usar caminhos canônicos.

**Observação:** definir o valor para `true` também implica que o Hyper não pode mais garantir a proteção contra um invasor em potencial que consegue colocar um link simbólico para escapar do conjunto permitido de diretórios ao qual o Hyper está configurado para permitir o acesso.

### hyper.log\_queries

Valor padrão: `true`

Quando definido como true, as informações de consulta são registradas.

As informações de consulta são registradas por padrão. Se, contudo, você perceber que os arquivos de registro são muito grandes para a quantidade de espaço em disco disponível, é possível definir como `false` para desativar o registro das informações de consulta. O Tableau recomenda deixar essa configuração definida como `true`.

### hyper.log\_timing

Valor padrão: `false`

Essa configuração é útil para saber mais informações sobre as consultas, como tempos de compilação e de análise. Por padrão, essa configuração fica desabilitada. É possível acionar essa configuração ao definir o valor como `true` para coletar mais detalhes sobre as consultas. Observe, porém, que isso aumentará o tamanho dos arquivos de registro do processador de dados (\\logs\\hyper).

### hyper.log\_troublesome\_query\_plans

Valor padrão: `true`

Quando definido como `true`, registra planos de consulta identificados como problemáticos. Entram nessa categoria: consultas canceladas, com execução mais lenta que 10 segundos ou consultas que estão sendo transferidas para o disco. As informações nos registros podem ser úteis para solucionar consultas problemáticas. É possível alterar essa configuração para `false` se estiver preocupado quanto ao tamanho dos registros.

### hyper.memory\_limit

Valor padrão: `80%`

Controla a quantidade máxima memória de sistema disponível usada pelo Hyper. Especifique o limite de memória como uma porcentagem da memória geral do sistema disponível. Por exemplo, `hyper.memory_limit="90%"`.

Como alternativa, especifique a quantidade máxima de memória disponível a ser usada em bytes. Acrescente a letra "k" ao valor para indicar kilobytes, "m" para indicar megabytes e "g" para indicar gigabytes ou "m" para indicar terabytes. Por exemplo, `hyper.memory_limit="7g"`.

**Nota:** ao executar no Tableau Server, o valor se aplica ao teto de memória gerenciado pelo Server Resource Manager (SRM) e não à RAM física total. O teto do SRM é de aproximadamente 84% da RAM física. Como resultado, o valor padrão de 80% resulta em aproximadamente 67% da RAM física total disponível para Hyper.”

### hyper.memtracker\_hard\_reclaim\_threshold

Valor padrão: `80%`

Essa configuração só se aplica ao Windows. O Hyper mantém partes descompactadas e descriptografadas da extração na memória para futuros acessos mais rápido. Essa configuração controla quando os threads do trabalhador começarão a gravar esses dados em um cache de disco para reduzir a pressão da memória. Se dado como uma porcentagem, o valor é interpretado como uma porcentagem da configuração geral `hyper.memory_limit`. Por exemplo, `hyper.memtracker_hard_reclaim_threshold="60%"`. Valores absolutos podem ser especificados como 'k' (kilobytes), 'm' (megabytes), 'g' (gigabytes) ou 't' (terabytes). Por exemplo, `hyper.memtracker_hard_reclaim_threshold="10g"`. O valor deve ser maior do que o limite `hyper.memtracker_soft_reclaim`.

### hyper.memtracker\_soft\_reclaim\_threshold

Valor padrão: `50%`

Essa configuração só se aplica ao Windows. Ao interagir com um arquivo Hyper, o hyper gravará alguns dados para cache ou manter os dados. O Windows tem o comportamento especial que bloqueia dados recém-gravados na memória. Para evitar a troca, forçamos os dados quando o Hyper atinge o limite configurado para o limite de recuperação. Quando o limite de recuperação suave é atingido, o hyper tenta recuperar dados em cache em segundo plano para tentar ficar abaixo do limite de recuperação. Em situações em que a troca aconteceria de outra forma, acionar a recuperação no hyper pode levar a um melhor resultado. Portanto, se a instalação do Tableau Server apresentar muitas trocas, essa configuração pode ser usada para tentar reduzir a pressão da memória.

Especifique o número de bytes. Acrescente a letra "k" ao valor para indicar kilobytes, "m" para indicar megabytes e "g" para indicar gigabytes ou "m" para indicar terabytes. Como alternativa, especifique o valor como uma porcentagem da memória geral configurada para o Hyper. Por exemplo, `hyper.memtracker_soft_reclaim_threshold="20%"`.

### hyper.network\_threads

Valor padrão: `150%`

Controla o número de tópicos de rede usados pelo Hyper. Especifique o número de threads de rede (por exemplo, `hyper.network_threads=4`) ou especifique a porcentagem de threads em relação à contagem básica lógica (por exemplo, `hyper.network_threads="300%"`).

Os threads de rede são usados para aceitar novas conexões e enviar ou receber dados e consultas. O hyper usa a rede assíncrona, por isso muitas conexões podem ser originadas de um único segmento. Normalmente, a quantidade de trabalho feito em tópicos de rede é muito baixa. A única exceção é abrir bancos de dados em sistemas de arquivos lentos, o que pode levar muito tempo e bloquear o thread da rede. Se os tempos de conexão estiverem lentos ao tentar visualizar ou editar painéis que usam extrações e não têm sido usados há algum tempo, e você frequentemente vê mensagens “asio-continuation-slow” no log do hyper, além de longos tempos de “construct-protocol” no Hyper do log do Tableau, tente aumentar esse valor.

### hyper.objectstore\_validate\_checksums

Valor padrão: `false`

Uma configuração booliano que controla verificações de integridade de arquivo no Hyper. Quando definido como `true`, o Hyper verificará os dados em um arquivo de extração quando ele for acessado pela primeira vez. Isso permite que a corrupção silenciosa e corrupção que iria travar o Hyper seja detectada. Em geral, é aconselhável ativar essa configuração, exceto em instalações com discos muito lentos, onde pode causar regressões de desempenho.

### hyper.query\_total\_time\_limit

Valor padrão: `0`(o que significa ilimitado)

Define um limite superior no tempo total do thread que pode ser usado por consultas individuais no Hyper. Acrescente 's' ao valor para indicar segundos, 'min' para indicar minutos ou 'h' para indicar horas.

Por exemplo, para restringir todas as consultas a um uso total de tempo de 1500 segundos do tempo total do thread:

`tsm configuration set -k hyper.query_total_time_limit -v 1500s`

Se uma consulta for executada além do limite especificado, ela falhará, e um erro será retornado. Essa configuração permite controlar automaticamente consultas descontroladas que usariam muitos recursos.

O hyper executa consultas em paralelo. Por exemplo, se uma consulta for executada por 100 segundos e, durante esse tempo, estiver sendo executada em 30 threads, o tempo total do segmento seria de 3000 segundos. O tempo do thread de cada consulta é relatado no log do hyper nas entradas de log “query-end” no campo "tempo total".

### hyper.session\_memory\_limit

Valor padrão: `0`(o que significa ilimitado)

Controla o consumo máximo de memória que uma consulta individual pode ter. Especifique o número de bytes. Acrescente a letra "k" ao valor para indicar kilobytes, "m" para indicar megabytes e "g" para indicar gigabytes ou "m" para indicar terabytes.

Por exemplo, para definir o limite de memória para 900 megabytes, execute o seguinte comando:

`tsm configuration set -k hyper.session_memory_limit -v 900m`.

Como alternativa, para especificar o limite de memória da sessão como uma porcentagem da memória geral do sistema disponível, execute o seguinte comando:

`tsm configuration set -k hyper.session_memory_limit -v 90%`.

Reduzir esse valor pode ajudar quando uma consulta estiver usando quantidades excessivas de memória e fazendo com que outras consultas falhem por um longo período de tempo. Ao reduzir o limite, a única consulta grande falharia (ou recorreria à transferência se a transferência não estiver desativada) e não teria um impacto negativo em outras consultas.

### hyper.srm\_cpu\_limit\_percentage

Valor padrão (em percentual): `75`

Especifica o uso máximo de CPU por hora permitido pelo Hyper. Se excedido, o Mecanismo de dados reiniciará sozinho para minimizar o impacto em outros processos no computador.

Por padrão, o Mecanismo de dados será reiniciado se tiver uma média de uso superior a 75% da CPU em uma hora. Esse valor não deve ser alterado, exceto ao trabalhar com o Suporte do Tableau ou se você estiver executando o Processador de dados em um nó de servidor dedicado. Se o Mecanismo de dados estiver sendo executado em um nó dedicado, você poderá aumentar com segurança esse valor para 95% para aproveitar ao máximo o hardware de computador disponível. Para obter detalhes sobre como executar o Mecanismo de dados em um nó dedicado, consulte [Otimizar para ambientes - com muitas consultas de extração](https://help.tableau.com/current/server/pt-br/perf_tuning_long_queries_for_extracts.htm).

Para aumentar para 95%:

`tsm configuration set -k hyper.srm_cpu_limit_percentage -v 95 --force-keys`

`tsm pending-changes apply`

Para redefinir isso para o padrão de 75%:

`tsm configuration set -k hyper.srm_cpu_limit_percentage -v 75 --force-keys`

`tsm pending-changes apply`

### hyper\_standalone.consistent\_hashing.enabled

Valor padrão: `true`

Aumenta a chance de que a extração de uma consulta já esteja armazenada em cache. Se o nó com a extração armazenada em cache não puder suportar carga adicional, você será encaminhado para um novo nó e a extração será carregada em cache no novo nó. Isso resulta em uma melhor utilização do sistema porque as extrações só serão carregadas na memória se houver carga que justifique a necessidade.

### hyper\_standalone.health.enabled

Valor padrão: `true`

Altera a métrica de balanceamento de carga da seleção aleatória para a escolha do nó Processador de dados (Hyper) com base em uma pontuação de integridade composta de uma combinação da atividade hyper atual e do uso de recursos do sistema. Com base nesses valores, o balanceador de carga escolherá o nó mais capaz de lidar com uma consulta de extração.

### hyper.temp\_disk\_space\_limit

Valor padrão: `100%`

Define o limite superior do espaço em disco no qual o Hyper vai parar de alocar espaço para arquivos temporários. Essa configuração pode ajudar a impedir que o disco rígido se encha com arquivos temporários do Hyper e fique sem espaço em disco. Se o espaço em disco atingir esse limite, o Hyper tentará se recuperar automaticamente sem a intervenção do administrador.

Especifique-o como porcentagem do espaço em disco disponível total a ser usado. Por exemplo, `hyper.temp_disk_space_limit="96%"`. Quando definido como 100%, todo o espaço em disco disponível poderá ser usado.

Para que o Processador de Dados seja iniciado, a quantidade de espaço em disco configurada deve estar disponível. Se não houver espaço suficiente em disco disponível, você verá uma entrada de registro do Processador de Dados que diz: "O limite em disco para arquivos temporários foi atingido. Por favor, libere espaço em disco no dispositivo. Consulte o registro Hyper para obter mais informações: Não há espaço no dispositivo".

### hyper.hard\_concurrent\_query\_thread\_limit

Valor padrão: 150%

Use essa opção para definir o número máximo de processamentos que o Hyper deve usar para executar consultas. Use essa opção se quiser definir um limite rígido para o uso da CPU. Especifique o número de threads ou especifique a porcentagem de threads em relação à contagem básica lógica. O hyper provavelmente não usará mais recursos do que os definidos por essa configuração, mas os threads em segundo plano e de rede do Hyper não são afetados por essa configuração (embora eles tendam a não ocupar muita CPU).

É importante considerar que essa configuração controla o número de consultas simultâneas que podem ser executadas. Assim, se você diminuir esse ajuste, a probabilidade de obter consultas que precisam aguardar a conclusão das consultas em execução no momento aumentará, o que poderá afetar os tempos de carregamento da pasta de trabalho.

### hyper.soft\_concurrent\_query\_thread\_limit

Valor padrão: 100%

Use essa opção para especificar o número de threads que uma única consulta pode ser paralelizada se houver muitos threads disponíveis, dada a configuração `hard_concurrent_query_thread_limit`. Especifique o número de threads ou especifique a porcentagem de threads em relação à contagem básica lógica.

Veja o exemplo simplificado a seguir:

Digamos que você defina esse valor como 10 processamentos, isso significa que as consultas poderão ser realizadas em paralelo com até 10 processamentos. Se apenas duas consultas estiverem em execução, os oito processamentos restantes serão usados em paralelo com as duas consultas.

_hyper. hard\_concurrent\_query\_thread\_limit_ e _hyper.soft\_concurrent\_query\_thread\_limit_ funcionam em conjunto para fornecer algumas opções para gerenciar o uso da CPU, maximizando os recursos de CPU disponíveis para concluir as consultas com mais rapidez. Se não quiser que o Processador de dados use toda a CPU disponível na máquina, altere-o para menos de 100%, para uma porcentagem que seja ideal para o seu ambiente. O limite flexível é uma maneira de limitar o uso da CPU, mas habilite-a para ir até o limite rígido, se necessário.

**Observação:** as opções _hyper.hard\_concurrent\_query\_thread\_limit_ e _hyper.soft\_concurrent\_query\_thread\_limit_ substituem as opções hyper.num\_job\_worker\_threads e hyper.num\_task\_worker\_threads disponíveis no Tableau Server versão 2018.3 e anteriores, e estão descontinuadas e indisponíveis. Para obter informações sobre o hyper.num\_job\_worker\_threads e o hyper.num\_task\_worker\_threads, consulte [Opções do tsm configuration set.](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm)

### hyper.use\_spooling\_fallback

Valor padrão: `true`

Quando definido como `true`, permite a transferência ao disco quando a consulta de extração exceder o uso RAM definido (80% de RAM instalado). Em outras palavras, ele permite que o hyper execute uma consulta usando o disco se exceder o uso de RAM.

O Tableau recomenda usar a configuração padrão. É possível desativar ao definir o valor como `false` se estiver preocupado com o uso de disco. Ao desativar essa configuração, as consultas que usam mais que 80% de RAM instalado serão canceladas. Consultas de transferência geralmente levam substancialmente mais tempo para terminar.

Para obter mais informações sobre a transferência, consulte a seção Uso da memória e da CPU no [Processador de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_engine2_intro.htm).

### indexandsearchserver.vmopts

**Versão:** adicionado na versão 2022.1.

Valor padrão: `-Xmx<default_value> -Xms<default_value>`

O valor padrão é baseado na quantidade de memória do sistema e consiste em 3,125% da RAM total do sistema.

Controla o tamanho da pilha do Index and Search Server. Como o valor padrão é dimensionado automaticamente, use essa opção para substituir o valor padrão somente quando absolutamente necessário. Acrescente a letra "k" ao valor para indicar kilobytes, "m" para indicar megabytes e "g" para indicar gigabytes. Como regra geral, defina o tamanho da pilha inicial (`-Xms`) igual ao tamanho da pilha máxima (`-Xmx`) para minimizar as coletas de lixo.

### jmx.security.enabled

**Versão:** adicionado na versão 2022.1.

Valor padrão: `false`

O JMX está desativado por padrão, portanto, o JMX seguro também está desativado. Se você estiver ativando o JMX, recomendamos que você ative o JMX seguro.

Isso está definido para`true` e ativa o JMX seguro com SSL e autenticação básica de nome de usuário/senha para acesso somente leitura quando você executa o comando `tsm maintenance jmx enable` e responde `y` quando solicitado a ativar os recursos de segurança para JMX:

tsm maintenance jmx enable
We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX?
(y/n): y

### jmx.ssl.enabled

**Versão:** adicionado na versão 2022.1.

Valor padrão: `true`

Impõe SSL para JMX. Essa opção tem como padrão `true` mas não tem efeito a menos que `jmx.security.enabled` também esteja definido para `true`. Para habilitar a segurança de JMX, execute o comando `tsm maintenance jmx enable`. Responda `y` quando solicitado a deixar o SSL ativado ou `n` para desativar o SSL:

tsm maintenance jmx enable
...
Would you like to enable SSL?
(y/n): n

### jmx.ssl.require\_client\_auth

**Versão:** adicionado na versão 2022.1.

Valor padrão: `false`

Isso está definido para`true` quando você executar o comando `tsm maintenance jmx enable` e responde `y` quando solicitado a exigir autenticação de cliente (mTLS):

tsm maintenance jmx enable
...
Would you like to require client authentication (mTLS)?
(y/n): y

Para concluir a configuração, você deve ter um certificado de cliente e colocá-lo no local correto em seu computador cliente.

### jmx.ssl.user.name

**Versão:** adicionado na versão 2022.1.

Valor padrão: `tsmjmxuser`

Isso é definido quando você instala ou atualiza o Tableau Server.

### jmx.ssl.user.password

**Versão:** adicionado na versão 2022.1.

Valor padrão: `<generated>`

Isso é definido quando você instala ou atualiza o Tableau Server.

### jmx.user.access

**Versão:** adicionado na versão 2022.1.

Valor padrão: `readonly`

Você pode alterar isso para `readwrite` quando você executar o comando `tsm maintenance jmx enable` e responder `y` quando solicitado a adicionar o acesso `readwrite` :

tsm maintenance jmx enable
...
JMX access is readonly by default. Would you like to add readwrite access?
(y/n): y

### licensing.login\_based\_license\_management.default\_requested\_duration\_seconds

Valor padrão: `0`

Defina como a duração (em segundos) que a licença baseada em login de um usuário offline sem conexão ao Tableau Server antes de ser solicitado a ativar novamente. Esta duração será sempre atualizada quando o Tableau Desktop estiver em uso e puder se conectar ao Tableau Server.

### licensing.login\_based\_license\_management.enabled

Valor padrão: `true`

Defina como true para habilitar o gerenciamento de licenças baseadas em logon. Definido como false para desabilitar o gerenciamento de licenças baseadas em logon.

**Observação:** para usar gerenciamento de licenças baseadas em logon, você deve ativar uma chave do produto habilitada para gerenciamento de licenças baseadas em logon. Você pode usar [`tsm licenses list`](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList) para ver quais chaves do produto têm o gerenciamento de licenças baseadas em logonhabilitado.

### licensing.login\_based\_license\_management.max\_requested\_duration\_seconds

Valor padrão: `15552000`

Defina como a duração máxima (em segundos) que a licença baseada em login de um usuário pode estar offline sem conexão ao Tableau Server antes de ser solicitado a ativar o Tableau novamente. O valor máximo é 15552000 segundos (180 dias). Esta duração será sempre atualizada quando o Tableau Desktop estiver em uso e puder se conectar ao Tableau Server.

### maestro.app\_settings.sampling\_max\_row\_limit

Valor padrão: `1000000`

Define o número máximo de linhas para dados de amostragem de grandes conjuntos de dados com o Tableau Prep na Web.

### maestro.input.allowed\_paths

Valor padrão: "

Por padrão, o acesso a qualquer diretório será negado e será permitida apenas a publicação no Tableau Server com conteúdo incluído no arquivo .tflx.

Uma lista de diretórios de rede permitidos para conexões de entrada de fluxo. Você deve habilitar o Tableau Prep Conductor para agendar fluxos no Tableau Server. Para obter mais informações, consulte [Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm).

As regras a seguir se aplicam e devem ser consideradas ao definir esta configuração:

- Os caminhos devem ser acessíveis pelo Tableau Server. Esses caminhos são verificados durante a inicialização do servidor e na execução de fluxo.
- Os caminhos do diretório de rede devem ser absolutos e não podem conter caracteres curinga ou outros símbolos de passagem de caminho. Por exemplo, `\\myhost\myShare\*` ou `\\myhost\myShare*` são caminhos inválidos e não teriam permissão. A maneira correta de usar a lista de permissões para qualquer pasta no _myShare_ seria `\\myhost\myShare or \\myhost\\myShare\`.
    
    **Observação:** a configuração `\\myhost\myShare` não permitirá `\\myhost\myShare1`. Para permitir as duas pastas, use a lista de permissões para elas como \\\\myhost\\myShare; \\\\myhost\\myShare1.
- O valor pode ser , `*`, para permitir qualquer diretório de rede ou uma lista de caminhos de diretório de rede, delimitados por “;”.
- Nenhum caminho do diretório local é permitido, mesmo quando o valor for definido como `*`.

> [!IMPORTANT]
> 
> Importante:  
> Esse comando substitui as informações existentes pelas novas que foram fornecidas. Se você quiser adicionar um novo local em uma lista existente, forneça uma lista de todos os locais existentes e o novo que deseja adicionar. Use os comandos a seguir para visualizar a lista atual de locais de entrada e saída:  
>   
> `tsm configuration get -k maestro.input.allowed_paths   tsm configuration get -k maestro.output.allowed_paths`  

Para obter mais informações e detalhes sobre como configurar diretórios permitidos para as conexões de entrada e saída de fluxo, consulte [Etapa 4: Lista de permissões para locais de entrada e saída](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm).

### maestro.output.allowed\_paths

Valor padrão: "

Por padrão, o acesso a todos os diretórios será negado.

Uma lista de diretórios de rede permitidos para as conexões de saída de fluxo. Você deve habilitar o Tableau Prep Conductor para agendar fluxos no Tableau Server. Para obter mais informações, consulte [Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm).

As regras a seguir se aplicam e devem ser consideradas ao definir esta configuração:

- Os caminhos devem ser acessíveis pelo Tableau Server. Esses caminhos são verificados durante a inicialização do servidor e na execução de fluxo.
- Os caminhos do diretório de rede devem ser absolutos e não podem conter caracteres curinga ou outros símbolos de passagem de caminho. Por exemplo, `\\myhost\myShare\*` ou `\\myhost\myShare*` são caminhos inválidos e não teriam permissão. A maneira correta de usar a lista de permissões para qualquer pasta no _myShare_ seria `\\myhost\myShare or \\myhost\\myShare\`.
    
    **Observação:** a configuração `\\myhost\myShare` não permitirá `\\myhost\myShare1`. Para permitir as duas pastas, use a lista de permissões para elas como \\\\myhost\\myShare; \\\\myhost\\myShare1.
- O valor pode ser , `*`, para permitir qualquer diretório de rede ou uma lista de caminhos de diretório de rede, delimitados por “;”.
- Nenhum caminho do diretório local é permitido, mesmo quando o valor for definido como `*`.
- **Observação:** se um caminho estiver na lista permitida de fluxos e na lista internal\_disasslowed, a internal\_disallowed terá preferência.

Para obter mais informações e detalhes sobre como configurar diretórios permitidos para as conexões de entrada e saída de fluxo, consulte [Etapa 4: Lista de permissões para locais de entrada e saída](https://help.tableau.com/current/server/pt-br/prep_conductor_configure_network_shares.htm).

### maestro.output.write\_to\_mssql\_using\_runas

**Versão:** adicionado na versão 2022.3.1.

Valor padrão: `false`

Quando habilitadas, as saídas de fluxo publicadas no Tableau Server têm permissão de acesso de gravação a um banco de dados do Microsoft SQL Server usando credenciais Run As. As credenciais usadas pela conta de serviço Run As devem ter permissão de gravação no banco de dados. Avalie seus requisitos de segurança e implantação antes de habilitar o contexto do `maestro.output.write_to_mssql_using_runas`. Para obter mais informações, consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm).

**Observação**: este comando requer a opção `--force-keys`. Por exemplo: `tsm configuration set -k maestro.output.write_to_mssql_using_runas -v true --force-keys`.

### maestro.sessionmanagement.maxConcurrentSessionPerUser

Valor padrão: `4`

Define o número máximo de sessões de edição da Web de fluxo que um usuário pode abrir ao mesmo tempo.

### metadata.ingestor.blocklist

Valor padrão: null

Quando configurado, o Tableau Catalog bloqueia o conteúdo especificado de ser ingerido. Para especificar qual conteúdo bloquear, você deve identificar os valores de lista de bloqueio, que é uma combinação tanto da ID do site, do tipo de conteúdo quanto da ID de conteúdo do conteúdo que deseja bloquear, com base em arquivos de log "não interativos" do servidor. Os valores da lista de bloqueio devem ser separados por vírgula.

**Importante:** você só deve usar esta opção por indicação do Suporte do Tableau.

Por exemplo, você pode usar `tsm configuration set --force-keys -k metadata.ingestor.blocklist` para bloquear a ingestão de uma combinação de fontes de dados, pastas de trabalho e fluxos usando o seguinte comando:

`tsm configuration set --force-keys -k metadata.ingestor.blocklist -v "sites/1/datasources/289, sites/2/datasources/111, sites/1/workbooks/32, sites/3/workbooks/15, sites/1/flows/13, sites/1/flows/18"`

Para validar o conteúdo bloqueado, revise os arquivos de registro "não interativos" do servidor para os seguintes eventos:

- `Skipping ingestion for`
- `Successfully updated blocklist to`

Por exemplo:

`Skipping ingestion for contentType [Workbook], contentId [sites/1/datasources/289], siteDisabled [false], swallowEvent [false], contentBlocked [true]`

`Skipping ingestion for contentType [Workbook], contentId [sites/3/workbooks/15], siteDisabled [false], swallowEvent [false], contentBlocked [true]`

e

`Successfully updated blocklist to: [sites/1/datasources/289, sites/1/workbooks/32, sites/2/datasources/111]`

### metadata.ingestor.pipeline.throttleEventsEnable

Valor padrão: `false`

Controla se a indexação de conteúdo novo e atualizado, também chamada de eventos, é regulada em todos os sites do servidor. Por padrão, essa limitação fica desligada. Para ligar a limitação de eventos, altere esta configuração para `true` com o seguinte comando: 

`tsm configuration set -k metadata.ingestor.pipeline.throttleEventsEnable -v true --force-keys`

Para obter mais informações sobre a limitação do evento, consulte [Ativar o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#troubleshoot_eventing_delay).

### metadata.ingestor.pipeline.throttleLimit

Valor padrão: `20`

Quando a limitação do evento é ativada, ela é o número máximo de itens de conteúdo novos e atualizados que podem ser indexados durante um período de tempo especificado. Quando o limite especificado é atingido para um item específico, a indexação é adiada.

Por padrão, o limite é definido para `20` e não pode ser definido como inferior a `2`. Você pode usar o seguinte comando para alterar o limite: 

`tsm configuration set -k metadata.ingestor.pipeline.throttleLimit -v 25 --force-keys`

Eventos limitados podem ser identificados nos arquivos de registro "não interativos" do servidor como `ingestor event flagged for removal by throttle filter`.

### metadata.ingestor.pipeline.throttlePeriodLength

Valor padrão: `20`

Quando a limitação do evento é ativada, este é o período, em minutos, um número máximo especificado de indexação de itens de conteúdo novo e atualizado pode ser indexado. Uma vez alcançado o tempo especificado, a indexação de qualquer conteúdo novo e atualizado adicional é adiada.

Por padrão, o limite é definido para 30 minutos. Você pode usar o seguinte comando para alterar o horário:

`tsm configuration set -k metadata.ingestor.pipeline.throttlePeriodLength -v PT45M --force-keys`

### metadata.query.limits.time

Valor padrão: `20`

Este é o maior tempo permitido, em segundos, para que uma consulta do Catalog ou da API de metadados seja executada, antes que o tempo limite seja atingido e a consulta cancelada. O Tableau recomenda aumentar gradativamente o tempo limite para _no máximo_ 60 segundos, usando o seguinte comando:

`tsm configuration set -k metadata.query.limits.time –v PT30S --force-keys`

**Importante:** essa opção só deve ser alterada se você observar o erro descrito aqui, [Mensagens de tempo limite e limite de nós excedidos](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#timeoutnodelimit). O aumento do tempo limite pode utilizar mais CPU por mais tempo, o que pode afetar o desempenho das tarefas em todo o Tableau Server. O aumento do tempo limite também pode causar maior utilização de memória, o que pode causar problemas no contêiner de microsserviços interativo quando as consultas são executadas paralelamente.

### metadata.query.limits.count

Valor padrão: `20000`

Este é o número de objetos (que podem mapear vagamente o número de resultados de consulta) que o Catalog pode retornar, antes que o limite de nós seja ultrapassado e a consulta cancelada. O Tableau recomenda aumentar gradativamente o limite para _no máximo_ 100.000, usando o seguinte comando:

`tsm configuration set -k metadata.query.limits.count –v 3000 --force-keys`

**Importante:** essa opção só deve ser alterada se você observar o erro descrito aqui, [Mensagens de tempo limite e limite de nós excedidos](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#timeoutnodelimit). O aumento do limite de nós pode causar maior utilização de memória, o que pode causar problemas no contêiner de microsserviços interativo quando as consultas são executadas paralelamente.

### metadata.query.throttling.enabled

Versão: adicionado na versão 2023.3

Valor padrão: `true`

Controla se a limitação de consulta de [API de metadados](https://help.tableau.com/current/api/metadata_api/pt-br/index.html) está habilitada. A otimização de consultas da API de metadados é um recurso projetado para evitar que as respostas da API de um servidor prejudiquem o desempenho geral. Quando definido para `true` (o padrão), se uma solicitação à API de metadados exceder o limite definido, um erro `RATE_EXCEEDED` é retornado.

Se os usuários da API de metadados estiverem tendo erros frequentes de `RATE_EXCEEDED`, um administrador pode tentar ajustar a limitação usando as configurações `metadata.query.throttling.tokenRefilledPerSecond` e `metadata.query.throttling.queryCostCapacity`. Como alternativa, o administrador pode desabilitar totalmente a limitação definindo o valor `metadata.query.throttling.enabled` para `false`. No entanto, isso impediria os benefícios de proteção de desempenho do recurso.

### metadata.query.throttling.queryCostCapacity

Versão: adicionado na versão 2023.3

Valor padrão: `20000000`

Um número que representa a capacidade da [API de metadados](https://help.tableau.com/current/api/metadata_api/pt-br/index.html) para responder perguntas. Cada solicitação à API de metadados tem um custo calculado que é subtraído desse número quando é executado. (Usando um modelo de token bucket, esta é a quantidade máxima de tokens que podem estar no bucket.)

Se os usuários da API de metadados estiverem vendo erros `RATE_EXCEEDED`, um administrador poderá ajustar as configurações de limitação. Eles deveriam ajustar `metadata.query.throttling.tokenRefilledPerSecond` e testar os resultados antes de tentar ajustar `metadata.query.throttling.queryCostCapacity`. Como alternativa, o administrador pode desabilitar totalmente a limitação definindo `metadata.query.throttling.enabled` para `false`. No entanto, isso impediria os benefícios de proteção de desempenho do recurso.

### metadata.query.throttling.tokenRefilledPerSecond

Versão: adicionado na versão 2023.3

Valor padrão: `5555`

Um número que representa a quantidade de capacidade da consulta de [API de metadados](https://help.tableau.com/current/api/metadata_api/pt-br/index.html) regenerada a cada segundo. (Usando um modelo de token bucket, este é o número de tokens que são colocados no bucket a cada segundo.)

Se os usuários da API de metadados estiverem vendo erros `RATE_EXCEEDED`, um administrador poderá ajustar as configurações de limitação. Eles deveriam ajustar `metadata.query.throttling.tokenRefilledPerSecond` e testar os resultados antes de tentar ajustar `metadata.query.throttling.queryCostCapacity`. Como alternativa, o administrador pode desabilitar totalmente a limitação definindo `metadata.query.throttling.enabled` para `false`. No entanto, isso impediria os benefícios de proteção de desempenho do recurso.

### metricsservices.checkIntervalInMinutes

**Versão:** descontinuado na versão 2024.2.

Valor padrão: `60`

Controla o intervalo, em minutos, entre as atualizações de métricas que dependem das fontes de dados em tempo real. Uma métrica é atualizada quando o servidor verifica novos dados por meio da exibição conectada da métrica.

### metricsservices.enabled

**Versão:** adicionado na versão 2022.3. Descontinuado na versão 2024.2.

Valor padrão: `true`

Quando definido para `false`, o tipo de conteúdo de métricas é desabilitado para todos os sites em um servidor. Para obter mais informações, consulte [Desativar métricas para um site](https://help.tableau.com/current/server/pt-br/metrics_admin.htm#disable-server).

**Descontinuação do recurso de métricas herdado**

O recurso de métricas herdado do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3. Com o Tableau Pulse, desenvolvemos uma experiência aprimorada para monitorar métricas e fazer perguntas sobre seus dados. Para obter mais informações, veja [Criar métricas com o Tableau Pulse](https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm) para conhecer a nova experiência e [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm) para o recurso descontinuado.

### metricsservices.failureCountToWarnUser

**Versão:** descontinuado na versão 2024.2.

Valor padrão: `10`

Controla o número de falhas consecutivas na atualização que devem ocorrer antes que o proprietário da métrica seja avisado. Quando definido como padrão de 10, uma atualização de métrica deve apresentar falha 10 vezes seguidas, antes que o proprietário receba uma notificação sobre a falha.

### metricsservices.maxFailedRefreshAttempts

**Versão:** descontinuado na versão 2024.2.

Valor padrão: `175`

Controla o número de falhas consecutivas na atualização que devem ocorrer antes de suspender uma atualização da métrica.

### mobile.deep\_linking.on\_prem.enabled

Valor padrão: `true`

Controla se os links para o Tableau Server são tratados como links profundos pelo aplicativo Tableau Mobile. Quando definidos como `true`, os links para os tipos de conteúdo compatíveis abrem no aplicativo. Quando definidos como `false`, os links abrem no navegador móvel. Para obter mais informações, consulte [Controlar vinculação profunda para o Tableau Mobile](https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_links.htm).

### monitoring.dataengine.connection\_timeout

Valor padrão: `30000`

A duração do tempo, em milissegundos, que o Controlador do cluster aguardará pelo processador de dados antes de determinar que foi alcançado o tempo limite de conexão. O padrão é de 30.000 milissegundos (30 segundos).

### native\_api.allowed\_paths

Valor padrão: `"`

**Observação:** mas versões do Tableau Server (incluindo versões de manutenção) anteriores a outubro de 2023, essa configuração foi configurada para permitir o acesso a todos os caminhos por padrão.

Use esta configuração para especificar uma lista de permissões para acesso a arquivos armazenados no Tableau ou em compartilhamentos remotos. Esse cenário permite que usuários autorizados do Tableau Server criem pastas de trabalho e executem fluxos do Tableau Prep que usam arquivos no servidor como fontes de dados baseadas em arquivos (como planilhas).

Para fluxos do Tableau Prep, essa configuração também deve ser definida quando um fluxo lê ou grava em um arquivo .hyper em um compartilhamento de rede. O caminho para o diretório que contém o arquivo deve ser adicionado à lista de permissões para que o fluxo seja executado com êxito usando o Tableau Prep Conductor. Você deve habilitar o Tableau Prep Conductor para agendar fluxos no Tableau Server. Para obter mais informações, consulte [Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm).

Essa configuração permite limitar o acesso apenas aos diretórios especificados. O acesso [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm) é, portanto, limitado aos caminhos do diretório onde você hospeda os arquivos de dados.

`tsm configuration set -k native_api.allowed_paths -v "_path_"` , onde _path_ é o diretório a ser adicionado à lista de permissão.  Caso deseje especificar vários caminhos, separe-os com ponto e vírgula, como neste exemplo:

`tsm configuration set -k native_api.allowed_paths -v "c:\datasources;\\HR\data"`

**Importante** Certifique-se de que os caminhos de arquivo especificados nesta configuração existam e sejam acessíveis pela conta do sistema. A capitalização do caminho e do arquivo deve ser consistente com a capitalização usada no Windows. Determinados processos do Tableau diferenciam maiúsculas de minúsculas e, se um caminho e um nome de arquivo não corresponderem exatamente ao caminho e ao arquivo, conforme definido no Windows, eles não serão reconhecidos e poderá ocorrer um erro “O diretório do recurso de armazenamento especificado não está na lista de permissões”. Isso é verdade mesmo que o próprio Windows não diferencie maiúsculas de minúsculas. Para obter mais informações, consulte [Base de dados de conhecimento do Tableau](https://help.salesforce.com/s/issue?id=a028c00000y4xxeAAA "Artigo da base de dados de conhecimento").

### native\_api.close\_old\_sessions\_if\_memory\_pressure\_high

**Versão:** adicionado na 2026.2.0.

Valor padrão: `true`

Se definido como `true` (o padrão), o VizQL Server fechará proativamente as sessões ociosas quando o uso de memória estiver alto. Isso ajuda a reduzir a probabilidade de reinicializações sem memória, liberando memória antes que o limite seja atingido. Os limites de uso de memória são determinados por `[native_api.goal_memory_pressure_percentage](#memory_pressure_goal_percentage)`.

### native\_api.connection.limit.<connection class>

Define o limite de consulta paralela para a fonte de dados especificada (classe de conexão). Isso excede o limite global da fonte de dados.

### native\_api.connection.globallimit

Valor padrão: `16`

Limite global para consultas paralelas. O padrão é 16, exceto para o Amazon Redshift, que tem o padrão 8.

### native\_api.ExplainDataEnabled

Valor padrão: `true`

Esta opção controla se o Explique os dados está ativado ou desativado para o servidor. Para obter mais informações sobre o Explique os dados, consulte [Começar com Explique os dados](https://help.tableau.com/current/pro/desktop/pt-br/explain_data_basics.htm) na Ajuda do Tableau.

Essa opção foi adicionada a partir do Tableau Server versão: 2019.3.

### native\_api.force\_alternative\_federation\_engine

Valor padrão: `false`

Substitua as restrições de operação ao unir colunas de dados de uma única conexão de arquivo e uma única conexão de banco de dados SQL. Defina essa opção como `True` para forçar o Tableau a processar a união de colunas usando a conexão de banco de dados em tempo real.

### native\_api.goal\_memory\_pressure\_percentage

Valor padrão: `80`

A porcentagem de uso de memória de destino que a recuperação tenta alcançar. Deve ser menor que `native_api.max_memory_pressure_percentage`.

### native\_api.InitializeQueryCacheSizeBasedOnWeights

Valor padrão: `True`

Controla se o tamanho do cache de consulta é inicializado automaticamente com base na quantidade de memória do sistema disponível. O cache de consulta consiste no cache de consulta lógica, no cache de metadados e no cache de consulta nativo. Por padrão, essa funcionalidade fica desabilitada.

### native\_api.LogicalQueryCacheMaxAllowedWeight

Valor padrão: `70`

O peso do limite de tamanho de cache de consulta lógica no tamanho total do cache de consulta.

### native\_api.max\_memory\_pressure\_percentage

Valor padrão: `90`

A porcentagem de uso de memória na qual a recuperação proativa de sessão começa. (A base de comparação é o limite de memória do processo, que é controlado por `native_api.memory_limit_per_process_gb` ou `native_api.memory_limit_per_process_percentage`)

### native\_api.memory\_limit\_enabled

Valor padrão: `true`

Determina se o monitoramento de memória está realizado. Este valor deve ser `true` para que outras chaves de memória nativa\_api tenham impacto. Estas são algumas das outras chaves que interagem com essa: `native_api.close_old_sessions_if_memory_pressure_high`, `native_api.max_memory_pressure_percentage`, `native_api.memory_limit_per_process_gb` e `native_api.memory_limit_per_process_percentage`. Para obter mais informações, consulte [Monitoramento de memória do VizQL Server](https://help.tableau.com/current/server/pt-br/server_process_vizql-server.htm#VizQL_memory_monitoring).

### native\_api.memory\_limit\_per\_process\_gb

Valor padrão: `0`

Um limite absoluto de memória por processo em gigabytes.

### native\_api.memory\_limit\_per\_process\_percentage

Valor padrão: `70`

Uma porcentagem da memória física total para calcular o limite de memória do processo. Usado somente quando `native_api.memory_limit_per_process_gb` = `0`.

### native\_api.MetadataQueryCachMaxAllowedWeight

Valor padrão: `4`

O peso do limite de tamanho de cache de consulta de metadados no tamanho total do cache de consulta.

### native\_api.NativeQueryCacheMaxAllowedWeight

Valor padrão: `26`

O peso do limite de tamanho de cache de consulta nativa no tamanho total do cache de consulta.

### native\_api.ProtocolTransitionLegacyFormat

Valor padrão: `false`

Usa o formato de nome herdado para delegações restritas.

O formato de nome foi alterado na versão 10.1 para permitir a transição de protocolo entre domínios (S4U). Se isso causar problemas com configurações atuais e você não precisar de transições de protocolo entre domínios, configure o Tableau Server para usar o comportamento anterior, definindo isso como `true`.

### native\_api.QueryCacheEntryMaxAllowedInPercent

Valor padrão: `60`

Especifica o tamanho máximo dos resultados de consulta que podem ser colocados no cache de consulta. Ele é definido como a porcentagem do tamanho total do cache de consulta. Por exemplo, se o tamanho do cache de consulta lógica for de 100 MB e `native_api.QueryCacheEntryMaxAllowedInPercent` for definido para 60%, então apenas resultados de consulta que sejam menores que 60 MB podem ser colocados no cache de consulta lógica.

### native\_api.QueryCacheMaxAllowedMB

O tamanho máximo do cache de consulta em megabytes. Esse valor varia de acordo com a quantidade de memória do sistema. O cache de consulta consiste no cache de consulta lógica, no cache de metadados e no cache de consulta nativo. Use a tabela abaixo para determinar o valor padrão:

<table style="width: 90%; margin-left: 0; margin-right: auto;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>Memória do sistema</th><th>Valor padrão para o Tableau Server</th><th>Valor padrão para o Tableau Desktop</th></tr><tr><td>64 GB e mais</td><td><code>3200 MB</code></td><td><code>1600 MB</code></td></tr><tr><td>De 32 GB a 64 GB</td><td><code>2400 MB</code></td><td><code>1200 MB</code></td></tr><tr><td>De 16 GB a 32 GB</td><td><code>1600 MB</code></td><td><code>800 MB</code></td></tr><tr><td>16 GB e menos</td><td><code>800 MB</code></td><td><code>400 MB</code></td></tr></tbody></table>

### native\_api.ResourceLuidsInSnowflakeSessionQueryTagsEnabled

Valor padrão: `true`

Se `true`, as informações de [marcação de consulta](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_how_to_query_tagging.htm) serão enviadas ao banco de dados Snowflake. A marcação de consulta pode ajudar a identificar qual ativo Tableau está gerando consultas ao banco de dados. Se `false`, a marcação de consulta para Snowflake será desabilitada.

### native\_api.ResourceLuidsInTeradataSessionQueryBandsEnabled

Valor padrão: `true`

Se `true`, as informações de [marcação de consulta](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_how_to_query_tagging.htm) serão enviadas ao banco de dados Teradata. A marcação de consulta pode ajudar a identificar qual ativo Tableau está gerando consultas ao banco de dados. Se `false`, a marcação de consulta para Teradata será desabilitada.

### native\_api.UserInfoInGeneratedSQLEnabled

Valor padrão: `false`

Determina se [marcação de consulta](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_how_to_query_tagging.htm) está habilitada para todo o conteúdo em um Tableau Server. Quando `true`, as consultas enviadas do Tableau para bancos de dados incluem metadados sobre a origem da consulta. O conteúdo resultante nos logs do banco de dados do cliente pode ser usado para solucionar problemas de desempenho ou outros problemas.

### nlp.concepts\_shards\_count

Valor padrão: `1`

**Observação:** o valor da contagem de segmentos padrão é suficiente para a maioria das instalações do Tableau Server.

Controla o número de fragmentos de dados para o índice de conceitos do Pergunte aos dados, nomes de campo, sinônimos de campo e termos analíticos armazenados em fragmentos em:

- O Index and Search Server para 2022.1 e versões posteriores.
- Elastic Server para 2019.1 - 2021. 4

A contagem de segmentos divide o índice de pesquisa para reduzir o tamanho total do índice, o que pode melhorar o desempenho do analisador semântico do Pergunte aos dados (Ask Data). O ajuste da contagem de segmentos é outra medida de melhoria de desempenho que você pode tomar, juntamente com o aumento do tamanho da pilha por meio do `elasticserver.vmopts` ou `indexandsearchserver.vmopts`, dependendo da versão do Tableau Server que você está executando.

O Tableau recomenda aumentar a contagem de segmentos em 1 para cada 50 GB. Para reduzir o número de vezes que você precisa ajustar a contagem de segmentos, calcule o tamanho total do índice adicionando 50% ao índice atual. Por exemplo, se o tamanho total do índice for inferior a 50 GB, então 1 segmento será suficiente. O desempenho real varia de acordo com o servidor, a taxa de aumento do tamanho do índice e outros fatores.

- 0 a 50 GB: 1
- 50 GB a 100 GB: 2
- 100 GB a 150 GB: 3

É possível usar o comando a seguir para aumentar a contagem de segmentos do índice de Conceitos do padrão para 2:

`tsm configuration set -k nlp.concepts_shards_count -v 2`

### nlp.values\_shards\_count

Valor padrão: 1

Controla o número de fragmentos de dados para o índice de conceitos do Pergunte aos dados, nomes de campo, sinônimos de campo e termos analíticos armazenados em fragmentos em:

- O Index and Search Server para 2022.1 e versões posteriores.
- Elastic Server para 2019.1 - 2021. 4

A contagem de segmentos divide o índice de pesquisa para reduzir o tamanho total do índice, o que pode melhorar o desempenho do analisador semântico do Pergunte aos dados (Ask Data). O ajuste da contagem de segmentos é outra medida de melhoria de desempenho que você pode tomar, juntamente com o aumento do tamanho da pilha por meio do `elasticserver.vmopts` ou `indexandsearchserver.vmopts`, dependendo da versão do Tableau Server que você está executando.

O Tableau recomenda aumentar a contagem de segmentos em 1 para cada 50 GB. Para reduzir o número de vezes que você precisa ajustar a contagem de segmentos, calcule o tamanho total do índice adicionando 50% ao índice atual. Por exemplo, se o tamanho total do índice for inferior a 50 GB, então 1 segmento será suficiente. O desempenho real varia de acordo com o servidor, a taxa de aumento do tamanho do índice e outros fatores.

- 0 a 50 GB: 1
- 50 GB a 100 GB: 2
- 100 GB a 150 GB: 3

É possível usar o comando a seguir para aumentar a contagem de segmentos do índice de Valores, do padrão para 2:

`tsm configuration set -k nlp.values_shards_count -v 2`

### nlp.defaultNewSiteAskDataMode

Valor padrão: `disabled_by_default`

Use esta opção para definir o valor inicial do Modo Pergunte aos dados quando um site for criado. Para obter mais informações, consulte [Desabilitar ou habilitar Pergunte aos dados para um site](https://help.tableau.com/current/server/pt-br/ask_data_enable.htm#EnableDisableAskDataForSite).

As opções válidas são `disabled_by_default` e `disabled_always`.

Essa opção foi adicionada com as versões do Tableau Server: 2019.4.5, 2020.1.3.

### pgsql.port

Valor padrão: `8060`

Porta na qual o PostgreSQL escuta.

### pgsql.preferred\_host

Especifica o nome do computador do nó com o repositório preferencial instalado. Esse valor será usado se a opção `--preferred` ou `-r` for especificada com o comando [tsm topology failover-repository](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMFailoverRepository).

Exemplo:

`tsm configuration set -k pgsql.preferred_host -v "<host_name>"`

**Observação:** o `host_name` diferencia maiúsculas de minúsculas e deve corresponder ao nome do nó mostrado na saída do `tsm status -v`.

### pgsql.ssl.ciphersuite

Valor padrão: `HIGH:MEDIUM:!aNULL:!MD5:!RC4`

Especifica os algoritmos cifrais que são permitidos para SSL ao Repositório.

Para obter valores aceitáveis e requisitos de formatação, consulte [ssl\_ciphers](https://www.postgresql.org/docs/12/runtime-config-connection.html#GUC-SSL-CIPHERS) no site da Web do Postgres.

### pgsql.ssl.max\_protocol\_version

Valor padrão: `TLSv1.3`

Define a versão máxima do protocolo SSL/TLS a ser usada ao conectar-se ao repositório por SSL.

Valores válidos: `TLSv1`, `TLSv1.1`, `TLSv1.2`, `TLSv1.3`

### pgsql.ssl.min\_protocol\_version

Valor padrão: `TLSv1.2`

Define a versão mínima do protocolo SSL/TLS a ser usada ao conectar-se ao repositório por SSL.

Valores válidos: `TLSv1`, `TLSv1.1`, `TLSv1.2`, `TLSv1.3`

### pgsql.verify\_restore.port

Valor padrão: `8061`

Porta usada para verificar a integridade do banco de dados PostgreSQL. Consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm) para obter mais informações.

### ports.blocklist

**Versão:** adicionado na versão 2021.1

Valor padrão: sem portas bloqueadas no intervalo utilizado para a atribuição automática da porta.

Usado para especificar portas dentro do intervalo de atribuição da porta que não devem ser usadas pelo Tableau ao atribuir dinamicamente as portas. Isso é útil quando você sabe que outro aplicativo está usando uma porta dentro do mesmo intervalo. Separe várias portas por vírgulas, por exemplo:

```
tsm configuration set -k ports.blocklist -v 8000,8089, 8090
```

Para obter mais informações sobre o uso da chave `ports.blocklist`, consulte [Bloqueio de portas específicas dentro do intervalo](https://help.tableau.com/current/server/pt-br/ports.htm#PortsBlocked)

### recommendations.enabled

Valor padrão: `true`

Controla o recurso de recomendações que ativa as recomendações de fontes de dados e tabelas (para o Tableau Desktop) e recomendações de exibições (para o Tableau Server). As recomendações são baseadas na popularidade do conteúdo e no conteúdo usado por outros usuários determinados como similares ao usuário atual.

### recommendations.vizrecs.enabled

Valor padrão: `true`

Controla as recomendações de exibições dos usuários do Tableau Server. Esta é uma opção secundária de `recommendations.enabled` e não terá efeito se a opção primária for definida como false. Quando a opção primária for definida como true e essa opção for definida como false, as fontes de dados e tabelas ainda serão recomendadas para os usuários do Tableau Desktop, mas as recomendações de exibições no Tableau Server serão desativadas.

### redis.max\_memory\_in\_mb

Valor padrão: `1024`

Especifica o tamanho em megabytes do cache de consulta externo do servidor cache.

### refresh\_token.absolute\_expiry\_in\_seconds

Valor padrão: `31536000`

Especifica o número de segundos para expiração absoluta de tokens de atualização e tokens de acesso pessoal (PATs).

Os tokens de atualização são usados por clientes conectados (Tableau Desktop, Tableau Prep Builder, Tableau Mobile etc.) para autenticação no Tableau Server após o logon inicial.

Para remover os limites, defina o valor como `-1`. Para desabilitar os tokens de atualização e PATs, consulte [Desabilitar a autenticação do cliente](https://help.tableau.com/current/server/pt-br/devices_connected_credentials.htm).

### refresh\_token.idle\_expiry\_in\_seconds

Valor padrão: `1209600`

Especifica o número de segundos quando expiram os tokens de atualização ociosos.

Os tokens de atualização são usados por clientes conectados (Tableau Desktop, Tableau Prep Builder, Tableau Mobile etc.) e tokens de acesso pessoal (PATs) para autenticação no Tableau Server após o logon inicial.

Para remover os limites, defina o valor como `-1`. Para desabilitar os tokens de atualização e PATs, consulte [Desabilitar a autenticação do cliente](https://help.tableau.com/current/server/pt-br/devices_connected_credentials.htm).

### refresh\_token.max\_count\_per\_user

Valor padrão: `24`

Especifica o número máximo de tokens de atualização que podem ser emitidos para cada usuário. Se o número máximo de sessões de usuários não for suficiente, aumente esse valor ou defina-o como `-1` para remover totalmente esse limite de token de atualização.

### rsync.timeout

Valor padrão: `600`

O tempo mais longo permitido, em segundos, para concluir a sincronização de arquivos (600 segundos = 10 minutos). A sincronização de arquivos ocorre como parte da configuração da alta disponibilidade ou de processos para mover o processador de dados e o repositório.

### schedules.display\_schedule\_description\_as\_name

Valor padrão: `false`

Controla se um nome de agendamento é exibido durante a criação de uma inscrição ou atualização de extração (o padrão), ou o nome da "descrição de frequência de agendamento" descrevendo o tempo e a frequência das exibições do agendamento. Para configurar o Tableau Server a exibir nomes que considerem o fuso-horário dos agendamentos, defina esse valor como `true`.

Quando true, a "descrição de frequência de agendamento" também será exibida depois do nome do agendamento na página de lista do agendamento.

### schedules.display\_schedules\_in\_client\_timezone

Valor padrão: `true`

Mostra a "descrição de frequência de agendamento" no fuso horário do usuário quando true (usa o fuso horário do navegador do cliente para calcular a "descrição de frequência de agendamento").

### schedules.ignore\_extract\_task\_priority

Valor padrão (booliano): `False`.

Esta configuração controla se a prioridade da tarefa é ou não considerada para determinar a classificação do trabalho que determina quando retirar os trabalhos da fila. Definir isso para `true` desativa a edição da prioridade da tarefa nas tarefas, e apenas a prioridade do cronograma será considerada para determinar a classificação do trabalho.

### searchserver.connection\_timeout\_milliseconds

**Versão:** adicionado na versão 2019.1. Obsoleto na versão 2022.3. Descontinuado na versão 2023.3.

Valor padrão, em milissegundos: `100000`

Especifica, em milissegundos, o tempo que os clientes de Pesquisa e navegação aguardam para estabelecer uma conexão com o servidor de Pesquisa e navegação.

Em computadores sobrecarregados do Tableau Server ou se você observar erros de registro “Falha na verificação de integridade do Zookeeper. Recusa ao iniciar SOLR.”, aumente esse valor.

Para obter mais informações, consulte [Tempos limite da sessão do cliente](https://help.tableau.com/current/server/pt-br/server_process_search-n-browse.htm#searchserverClient_session_timeouts).

### searchserver.index.bulk\_query\_user\_groups

**Versão:** descontinuado na versão 2022.3.

Valor padrão: `true`

Especifica se a consulta de usuários do site é feita em massa ao importar ou excluir usuários com um arquivo CSV. Quando definido como `true`(o padrão), a indexação é feita em massa.

### searchserver.javamemopts

**Versão:** adicionado na versão 2019.1. Descontinuado em 2023.3

Valor padrão: `-Xmx512m -Xms512m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData`

Determina as opções JVM para SOLR.

Dentre todas as opções configuráveis, a memória máxima da pilha, configurada pelo parâmetro `-Xmx`, é a mais importante ao ajustar o searchserver. Na maioria dos casos, esse valor deve ser definido como o mais alto possível, até 24 GB, com base na memória física disponível no computador do Tableau Server. Para alterar apenas a memória máxima da pilha, especifique toda a cadeia de caracteres padrão, mas apenas altere o valor para `-Xmx`.

Valores válidos para `-Xmx` dependem da memória disponível no computador do Tableau Server, mas não podem ser maiores que 24 GB. Para obter mais informações, consulte [Memória máxima da pilha de Pesquisa e navegação](https://help.tableau.com/current/server/pt-br/server_process_search-n-browse.htm#searchserverMaxHeapMem).

### searchserver.startup.zookeeper\_healthcheck\_timeout\_ms

**Versão:** adicionado na versão 2020.1. Descontinuado na versão 2023.3.

Valor padrão, em milissegundos: `300000`

Especifica, em milissegundos, o tempo que o Tableau Server deve aguardar por uma verificação de integridade bem-sucedida do Zookeeper na inicialização.

Em computadores sobrecarregados do Tableau Server ou se você observar erros de registro “Falha na verificação de integridade do Zookeeper. Recusa ao iniciar SOLR.”, aumente esse valor.

Para obter mais informações, consulte [Tempo limite da verificação de integridade da conexão do Zookeeper na inicialização](https://help.tableau.com/current/server/pt-br/server_process_search-n-browse.htm#searchserverZKhealth_chk_timeout).

### searchserver.zookeeper\_session\_timeout\_milliseconds

**Versão:** descontinuado na versão 2022.3.

Valor padrão, em milissegundos: `100000`

Especifica, em milissegundos, o tempo que os clientes de Pesquisa e navegação aguardam para estabelecer uma conexão com o Serviço de coordenação (Zookeeper).

Para obter mais informações, consulte [Tempos limite da sessão do cliente](https://help.tableau.com/current/server/pt-br/server_process_search-n-browse.htm#searchserverClient_session_timeouts).

### ServerExportCSVMaxRowsByCols

**Versão:** adicionado na versão 2020.3.

Valor padrão: `0` (sem limite)

Especifica o número máximo de células de dados que podem ser baixadas de Exibir dados em um arquivo CSV. Por padrão, não há limite. Especifique o número de células. Por exemplo, para estabelecer um limite de 3 milhões: 

tsm configuration set -k ServerExportCSVMaxRowsByCols -v 3000000 

tsm pending-changes apply

### service.jmx\_enabled

Valor padrão: `false`

Configurar como `true` permite às portas JMX o monitoramento opcional e a solução de problemas.

### service.max\_procs

Valor padrão: <number>

Número máximo de processos do servidor.

### service.port\_remapping.enabled

Valor padrão: `true`

Determina se o Tableau Server tentará ou não remapear portas dinamicamente quando as portas padrão ou configuradas estiverem indisponíveis. Configurar como `false` desativa o remapeamento de porta dinâmico.

### sheet\_image.enabled

Valor padrão: `true`

Controla se você pode obter imagens de exibições com a REST API. Para obter mais informações, consulte [Referência da REST API](https://help.tableau.com/current/api/rest_api/pt-br/help.htm#REST/rest_api_ref.htm#query_view_image).

### ssl.ciphersuite

Valor padrão: `HIGH:MEDIUM:!EXP:!aNULL:!MD5:!RC4:!3DES:!CAMELLIA:!IDEA:!SEED`

Especifica os algoritmos cifrais que são permitidos para SSL ao Gateway.

Para obter valores aceitáveis e requisitos de formatação, consulte [SSLCipherSuite](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslciphersuite)no site Apache.

### ssl.client\_certificate\_login.blocklisted\_signature\_algorithms

Valor padrão:

- Versão 2020.4.0: 
    
    `sha1withrsaencryption,   sha1withrsa`
- Versão 2020.4.1 e posterior:
    
    `sha1withrsaencryption,   sha1withrsa,   sha1withrsaandmgf1,   sha1withdsa,   sha1withecdsa`

O valor padrão bloqueia certificados com o algoritmo de assinatura SHA-1. Especifica os algoritmos de assinatura do cliente que estão bloqueados para SSL. Para desativar o bloqueio de todos os algoritmos de assinatura, execute esta chave com um conjunto vazio de aspas.

Para obter mais informações sobre esta chave, consulte o artigo da Base de dados de conhecimento, [O SSL mútuo falha após a atualização se os certificados forem assinados com o SHA-1](https://kb.tableau.com/articles/Issue/mutual-ssl-fails-after-upgrading-if-certificates-signed-with-sha-1?lang=pt-br).

### ssl.client\_certificate\_login.min\_allowed.elliptic\_curve\_size

Valor padrão: `256`

Especifica o tamanho mínimo da curva elíptica necessária para os certificados de cliente ECDSA que estão autenticando com o Tableau Server por SSL mútuo. Se um cliente apresentar um certificado de cliente ECDSA que não satisfaça esse tamanho mínimo de curva, a solicitação de autenticação falhará.

Essa opção foi apresentada na versão 2021.1 do Tableau Server.

### ssl.client\_certificate\_login.min\_allowed.rsa\_key\_size

Valor padrão: `2048`

Especifica o tamanho mínimo da chave para os certificados de cliente RSA que estão autenticando com o Tableau Server por SSL mútuo. Se um cliente apresentar um certificado de cliente RSA que não satisfaça esse tamanho mínimo da chave, a solicitação de autenticação falhará.

Essa opção foi apresentada na versão 2021.1 do Tableau Server.

### ssl.protocols

Valor padrão: `all +TLSv1.2 -SSLv2 -SSLv3 -TLSv1.3`

Especifica os protocolos SSL aos quais o Tableau Server oferece suporte para conexões TLS do Gateway. Os valores aceitáveis derivam da [Diretiva Apache SSLProtocol](https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslprotocol). Recomendamos seguir a configuração do protocolo SSL conforme descrito na [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm).

### storage.monitoring.email\_enabled

Valor padrão: `false`

Controla se as notificações por e-mail estão habilitadas para o monitoramento de espaço em disco do servidor. Por padrão, as notificações por e-mail estão habilitadas. Para habilitar notificações para monitoramento de espaço em disco, defina isso para `true`.

O SMTP deve ser configurado para que as notificações sejam enviadas. Para obter mais detalhes, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

### storage.monitoring.warning\_percent

Valor padrão: `20`

Limite de aviso do espaço em disco restante, em porcentagem do espaço total em disco. Se o espaço em disco cair abaixo deste limite, uma notificação de aviso será enviada.

### storage.monitoring.critical\_percent

Valor padrão: `10`

Limite crítico de espaço em disco restante, em porcentagem do espaço total em disco. Se o espaço em disco cair abaixo desse limite, uma notificação crítica será enviada.

### storage.monitoring.email\_interval\_min

Valor padrão: `60`

Com que frequência, em minutos, as notificações por e-mail devem ser enviadas quando o monitoramento do espaço em disco é habilitado e um limite é ultrapassado.

### storage.monitoring.record\_history\_enabled

Valor padrão: `true`

Determina se o histórico de espaço livre em disco é salvo e disponível para exibição em Exibições Administrativas. Para desabilitar o armazenamento do histórico para monitoramento, defina `storage.monitoring.record_history_enabled` como `false`.

### subscriptions.enabled

Valor padrão: `false`

Controla se as assinaturas são configuráveis em todo o sistema. Consulte [Configurar um site para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm).

### subscriptions.timeout

Valor padrão: `1800`

Comprimento de tempo, em segundos, para uma exibição em uma tarefa de assinatura da pasta de trabalho a ser renderizada antes do tempo da tarefa acabar. Se esse limite de tempo for atingido enquanto uma exibição estiver sendo renderizada, a renderização continuará, _mas qualquer exibição subseqüente na pasta de trabalho não será renderizada_, e o trabalho resultará um erro. No caso de uma pasta de trabalho de exibição única, esse valor nunca resultará na interrupção da renderização devido a um tempo limite.

### svcmonitor.notification.smtp.enabled

Valor padrão: `false`

Controla se as notificações por e-mail estão habilitadas para os eventos de processo do servidor. Por padrão, as notificações são enviadas quando os processos ficam inativos, fazem failover ou reiniciam. Para habilitar notificações de processo de servidor, defina isto para `true`.

O SMTP deve ser configurado para que as notificações sejam enviadas. Para obter mais detalhes, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

### svcmonitor.notification.smtp.mime\_use\_multipart\_mixed

**Versão:** adicionado na versão: 2020.1.8, 2020.2.5, 2020.3.1

Default value: `false`

Controla se os anexos HTML MIME de assinatura são enviados como _multiparte/relacionado_ (o padrão) ou _multiparte/misturado_.

Em casos raros, os clientes de e-mail podem não analisar corretamente os e-mails enviados pelo Tableau Server. Muitas vezes, isso pode ser corrigido definindo essa propriedade como `true`. Clientes conhecidos incluem iOS Mail e Microsoft Outlook (quando emparelhados com a criptografia S/MIME do Exchange).

### tabadmincontroller.auth.expiration.minutes

Valor padrão: `120`

Controla quanto tempo os cookies da sessão são válidos. Por padrão, ele é definido como 120 minutos. Esse valor também determina quanto tempo as credenciais inseridas em um arquivo de inicialização de nó são válidas. Para obter mais informações, consulte [tsm topology nodes get-bootstrap-file](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMGetBootstrap).

### tdsservice.log.level

**Versão:** adicionado na versão 2020.3.0

Valor padrão: `info`

O nível de registro do serviço Propriedades da fonte de dados. Pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### tomcat.http.maxrequestsize

Valor padrão: `16380`

O tamanho máximo (bytes) do conteúdo do cabeçalho que é permitido passar pelo gateway Apache nas solicitações HTTP. Os cabeçalhos que excedem o valor definido nessa opção resultarão em erros do navegador, como HTTP Erro 413 (entidade solicitada muito grande) ou falhas de autenticação.

Um valor baixo em `tomcat.http.maxrequestsize` pode resultar em erros de autenticação. As soluções de logon único que se integram ao Active Directory (SAML e Kerberos) frequentemente precisam de grandes tokens de autenticação em cabeçalhos HTTP. Certifique-se de testar os cenários de autenticação HTTP antes de implantar na produção.

Recomendamos definir a opção `gateway.http.request_size_limit` para o mesmo valor desta opção.

### tomcat.http.proxyHost

Especifica o nome do host do proxy de encaminhamento para solicitações OpenID para o IdP. Consulte [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm) ou [Erro de logon “O OpenID Connect não está configurado corretamente no servidor”](https://help.tableau.com/current/server/pt-br/identity_pools_manage.htm#proxy).

### tomcat.http.ProxyPort

Especifica a porta proxy de encaminhamento para solicitações OpenID para o IdP. Consulte [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm)

### tomcat.https.proxyHost

Especifica o nome do host do proxy de encaminhamento para solicitações OpenID para o IdP. Consulte [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm).

### tomcat.https.ProxyPort

Especifica a porta proxy de encaminhamento para solicitações OpenID para o IdP. Consulte [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm).

### tomcat.https.port

Valor padrão: `8443`

Porta SSL para Tomcat (não utilizada).

### tomcat.server.port

Valor padrão: `8085`

Portal na qual o tomcat escuta mensagens de desligamento.

### tomcat.useSystemProxies

Valor padrão: `false`

Especifica se os componentes do tomcat (OpenID) requerem acesso à configuração do proxy de encaminhamento no sistema operacional Windows local. Consulte [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm).

### tomcatcontainer.log.level

Valor padrão: `info`

O nível de registro dos microsserviços no Contêiner de microsserviços interativo e no Contêiner de microsserviços não interativo. Pode ser configurado dinamicamente a partir da versão 2020.4. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### tsm.log.level

Valor padrão: `info`

Nível de registro de serviços do TSM. Esses registros incluem informações que podem ser úteis se você tiver problemas com os serviços do TSM: Agente de administração, Controlador de administração, Serviço de arquivo do cliente, Controlador de cluster, Gerente de serviço e Serviço de licença. Essa chave de configuração não altera o nível de registro do Serviço de coordenação ou dos processos de manutenção. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm#ChangeLoggingLevel) e [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

### tsm.controlapp.log.level

Valor padrão: `info`

Nível de registro de serviços`control_<app>`. Esses registros incluem informações que podem ser úteis se houver problemas para iniciar ou reconfigurar um processo do TSM ou do Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm#ChangeLoggingLevel).

### usernotifications.reap\_after\_days

Valor padrão: `30`

Número de dias após o qual uma notificação do usuário será excluída do servidor.

### vizportal.adsync.update\_system\_user

Valor padrão: `false`

Especifica se os endereços de e-mail e nomes de exibição de usuários serão alterados (mesmo quando alterados no Active Directory) quando um grupo do Active Directory for sincronizado no Tableau Server. Para garantir que os endereços de e-mail e nomes de exibição sejam atualizados durante a sincronização, defina `vizportal.adsync.update_system_user` como `true` e, em seguida, reinicie o servidor.

### vizportal.alwaysUseEmbeddedShareLinks

**Versão:** adicionado na versão 2021.3.0

Valor padrão: `false`

Especifica se a opção Copiar link deve incluir o parâmetro "embed=y". A partir da versão 2019.4, por padrão, não inclui este parâmetro. Definir essa chave de configuração como true altera o comportamento de forma que o parâmetro "embed=y" seja incluído. Para obter detalhes sobre como usar a opção Copiar link para compartilhar links para inserção em páginas da Web, consulte [Inserir exibições em páginas da Web](https://help.tableau.com/current/pro/desktop/pt-br/embed.htm) na Ajuda do Tableau Desktop e Criação na Web.

### vizportal.art\_skip\_list

**Versão:** adicionado na versão 2024.2.

Valor padrão: `null`

Use essa chave de configuração para especificar aspectos da funcionalidade do Tableau Server que não usam rastreamento de atividades e recursos (ART) e gerarão grandes quantidades de dados desnecessários enquanto o ART estiver ativado.

Esta chave é usada com `vizportal.log_art_java` e `vizportal.enable_art` para solucionar problemas com o Application Server (VizPortal). Quando definido como \[preciso de informações aqui sobre como foi definido.\] Para saber como usar essa definição de configuração, consulte [Resolução de problemas com o Servidor de aplicativos](https://help.tableau.com/current/server/pt-br/server_process_application-server.htm#VizPortalTroubleshooting).

### vizportal.commenting.delete\_enabled

Valor padrão: `true`

Quando definido como `true`, permite aos usuários excluir comentários sobre exibições. É possível excluir um comentário se você o criou, se for o proprietário do conteúdo, um líder de projeto com função de site adequada ou se for um administrador. Para saber quais funções de site são necessárias para acesso completo de líder de projeto, consulte [Administração no nível do projeto](https://help.tableau.com/current/server/pt-br/projects.htm#project-admin).

### vizportal.csv\_user\_mgmt.index\_site\_users

**Versão:** obsoleto na versão 2022.3. Descontinuado (totalmente removido) na versão 2023.3.

Valor padrão: `true`

Especifica se a indexação de usuários do site é feita de usuário em usuário, durante a importação ou exclusão de usuários com um arquivo CSV. Quando definido como `true`(o padrão), a indexação é feita à medida que cada usuário é adicionado ou excluído. Para atrasar a indexação de usuários do site até que todo o arquivo CSV seja processado, defina como `false`.

### vizportal.csv\_user\_mgmt.bulk\_index\_users

**Versão:** obsoleto na versão 2022.3. Descontinuado (totalmente removido) na versão 2023.3.

Valor padrão: `false`

Especifica se a indexação de usuários do site é feita em massa ao importar ou excluir usuários com um arquivo CSV. Quando definido para `false` (o padrão), a indexação é feita individualmente. Para que a indexação seja feita em massa após o processamento do arquivo CSV, defina como `true`.

### vizportal.enable\_art

**Versão:** adicionado na versão 2024.2.

Valor padrão: `false`

Esta chave de configuração é usada com `vizportal.log_art_java` e `vizportal.art_skip_list` para solucionar problemas com o Application Server (VizPortal). Quando definido como verdadeiro, isso ativa o rastreamento de atividades e recursos no servidor de aplicativos. Para saber como usar essa definição de configuração, consulte [Resolução de problemas com o Servidor de aplicativos](https://help.tableau.com/current/server/pt-br/server_process_application-server.htm#VizPortalTroubleshooting).

### vizportal.log\_art\_java

**Versão:** adicionado na versão 2024.2.

Valor padrão: `false`

Esta chave de configuração é usada com `vizportal.enable_art` e `vizportal.art_skip_list` para solucionar problemas com o Application Server (VizPortal). Quando definido como verdadeiro, isso ativa o rastreamento de atividades e recursos no servidor de aplicativos. Para saber como usar essa definição de configuração, consulte [Resolução de problemas com o Servidor de aplicativos](https://help.tableau.com/current/server/pt-br/server_process_application-server.htm#VizPortalTroubleshooting).

### vizportal.log.level

Valor padrão: `info`

O nível de registro para os componentes Java vizportal. Os logs são gravados no `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizportal\*.log`.

Defina como `debug` para obter mais informações. O uso do definir de depuração pode afetar significativamente o desempenho, portanto você só deve usá-lo quando orientado a fazer isso pelo Suporte do Tableau.

A partir da versão 2020.4.0, pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### vizportal.oauth.connected\_apps.max\_expiration\_period\_in\_minutes

**Versão:** adicionado na versão 2021.4.

Valor padrão: `10`

O período máximo, em minutos, que o token da Web JSON (JWT) é válido. No momento em que o JWT é verificado, o Tableau Server verifica se o período especificado no JWT não excede esse valor padrão. Essa configuração é usada quando um aplicativo conectado ao Tableau foi configurado no Tableau Server usando a [API REST](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_connected_app.htm) do Tableau.

Por exemplo, para alterar o período máximo para 5 minutos, execute o seguinte comando:

`tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5`

### vizportal.oauth.external\_authorization.enabled

**Versão:** adicionado na versão 2021.4.

Valor padrão: `false`

No Tableau Server 2024.2 e posterior, a opção Habilitar aplicativos conectados está habilitada para o Tableau Server. No Tableau Server 2023.2 e versões anteriores, especifica se a opção Habilitar acesso OAuth para inserção de conteúdo está habilitada para o Tableau Server.  

Use esta opção para registrar um servidor de autorização externo (EAS) com o Tableau Server para que você possa habilitar a integração do aplicativo. Para obter mais informações, consulte [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm) .

Para habilitar esta opção, execute os seguintes comandos:

`tsm configuration set -k vizportal.oauth.external_authorization.enabled -v true`

### vizportal.oauth.external\_authorization\_server.blocklisted\_jws\_algorithms

**Versão:** adicionado na versão 2021.4.

Valor padrão: `ES256K`

Quando um servidor de autorização externo (EAS) é registrado, ou um aplicativo conectado é configurado, você pode usar este comando para especificar o algoritmo de assinatura usado no cabeçalho do token da Web JSON (JWT). Para obter mais informações, consulte [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm) ou [Uso de aplicativos conectados do Tableau para integração de aplicativos](https://help.tableau.com/current/server/pt-br/connected_apps.htm).

Por exemplo, se necessário, você pode executar o seguinte comando para remover o algoritmo:

`tsm configuration set - k vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms -v`

**Importante:** o comando de exemplo acima permite algoritmos de assinatura inseguros e deve ser usado apenas para solucionar erros.

### vizportal.oauth.external\_authorization\_server.issuer

**Versão:** adicionado na versão 2021.4.

Valor padrão: `null`

Obrigatório. Use este comando para especificar a URL do emissor. A URL do emissor é necessária para registrar o servidor de autorização externo (EAS) com o Tableau Server. Para obter mais informações, consulte [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm).

Por exemplo, se seu EAS for Okta, você pode executar um comando semelhante ao seguinte:

`tsm configuration set -k vizportal.oauth.external_authorization_server.issuer -v "https://dev-12345678.okta.com/oauth2/abcdefg9abc8eFghi76j5"`

### vizportal.oauth.external\_authorization\_server.jwks

**Versão:** adicionado na versão 2021.4.

Valor padrão: `null`

Quando um servidor de autorização externo (EAS) é registrado, você pode usar este comando para especificar a URL do conjunto de chaves da Web JSON (JWKS). A URL do JWKS é necessária se o provedor de identidade (IdP) não expõe o terminal de metadados do servidor de autorização externo.

Por exemplo, se seu IdP for Amazon Cognito, você pode executar um comando semelhante ao seguinte:

`tsm configuration set -k vizportal.oauth.external_authorization_server.jwks -v "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_Ab129faBb/.well-known/jwks.json"`

### vizportal.oauth.external\_authorization\_server.max\_expiration\_period\_in\_minutes

**Versão:** adicionado na versão 2021.4.

Valor padrão: `10`

O período máximo, em minutos, que o token da Web JSON (JWT) é válido. No momento em que o JWT é verificado, o Tableau Server verifica se o período especificado no JWT não excede esse valor padrão. Esta configuração é usada quando um EAS foi registrado no Tableau Server. Para obter mais informações, consulte [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm).

Por exemplo, para alterar o período máximo para 5 minutos, execute o seguinte comando:

`tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5`

### vizportal.openid.client\_authentication

Especifica o método de autenticação de cliente personalizado para OpenID Connect.

Para configurar o Tableau Server para usar os IdPs que exigem o `client_secret_post`, defina esse valor como `client_secret_post`.

Um exemplo seria ao se conectar ao IDP do Salesforce IDP, que requer este valor.

### vizportal.openid.essential\_acr\_values

**Versão:** adicionado na versão 2020.4

Especifica uma lista de valores de referência de classe de contexto de autenticação (ACR) para fornecer o IdP OpenID Connect como uma solicitação de reivindicação essencial. O IdP é responsável por garantir que a autenticação atenda aos critérios esperados. Se a chave de configuração `vizportal.openid.essential_acr_values` estiver preenchida, o Tableau Server agirá como a parte que dependerá e inspecionará a reivindicação ACR na resposta do token. O Tableau Server só avisará se o pedido ACR não corresponder ao valor de configuração esperado.

Para definir essa opção, digite os valores de ACR na ordem de preferência, entre aspas duplas. Você deve separar vários valores por uma vírgula e espaço, como neste exemplo:

`tsm configuration set -k vizportal.openid.essential_acr_values -v "value1, value2"`

### vizportal.openid.full\_server\_request\_logging\_enabled

Valor padrão: `false`

Especifica se deve ser feito o registro completo da atividade do OpenID.

Defina isso para `true` ao solucionar problemas do OpenID Connect para coletar registros mais detalhados e permitir que você solucione melhor os problemas.

Assim como em todas as configurações relacionadas ao registro, recomendamos que, após concluir a solução de problemas e coletar os registros, você redefina essa chave para o padrão (`false` ). Isso limita a quantidade de informações registradas e mantém os tamanhos dos arquivos de registro no mínimo.

### vizportal.openid.voluntary\_acr\_values

**Versão:** adicionado na versão 2020.4

Especifica uma lista de valores de referência de classe de contexto de autenticação (ACR) para fornecer o IdP OpenID Connect como uma solicitação de reivindicação voluntária. O IdP é responsável por garantir que a autenticação atenda aos critérios esperados. Se a chave de configuração `vizportal.openid.voluntary_acr_values` estiver preenchida, o Tableau Server agirá como a parte que dependerá e inspecionará a reivindicação ACR na resposta do token. A solicitação de autenticação falhará se a reivindicação ACR estiver ausente ou o valor de reclamação fornecido não corresponder ao valor de configuração esperado.

Para definir essa opção, digite os valores de ACR na ordem de preferência, entre aspas duplas. Você deve separar vários valores por uma vírgula e espaço, como neste exemplo:

`tsm configuration set -k vizportal.openid.voluntary_acr_values -v "value1, value2"`

### vizportal.password\_reset

**Versão:** Substitui `features.PasswordReset` na versão 2024.2.

Valor padrão: `false`

Aplica-se apenas aos servidores que usam autenticação local. Defina como `true`para permitir que os usuários redefinam suas senhas com a opção "Esqueci a senha" na página de logon.

### vizportal.rest\_api.cors.allow\_origin

Especifica as origens (sites) que têm acesso aos endpoints da REST API no Tableau Server quando `vizportal.rest_api.cors.enabled` está definido para `true`. Você pode especificar mais de uma origem separando cada entrada com uma vírgula (,).

`tsm configuration set -k vizportal.rest_api.cors.allow_origin -v https://mysite, https://yoursite`

Se `vizportal.rest_api.cors.enabled` for `false`, as origens listadas por essa opção serão ignoradas. Para obter mais informações, consulte [Habilitação do CORS no Tableau Server](https://help.tableau.com/current/api/rest_api/pt-br/help.htm#REST/rest_api_concepts_fundamentals.htm#Enabling).

**Observação:** você pode usar um asterisco (**\***) como curinga para corresponder a todos os sites. Esta ação não é recomendável, pois permite acesso ao servidor de qualquer origem e pode apresentar um risco à segurança. Não use um asterisco (**\***) a menos que você entenda completamente as implicações e os riscos do site.

### vizportal.rest\_api.cors.enabled

Valor padrão: `false`

Controla se o Tableau Server permite o Cross Origin Resource Sharing (CORS). Quando definido como `true`, o servidor permite que os navegadores da Web acessem os endpoints da [REST API do Tableau](https://help.tableau.com/current/api/rest_api/pt-br/help.htm#REST/rest_api_ref.htm). É possível usar esta opção e a REST API para criar portais personalizados. Por padrão, essa funcionalidade não está habilitada. Para especificar quais origens (sites) têm acesso, use a opção `vizportal.rest_api.cors.allow_origin`. Somente as origens especificadas com essa opção podem fazer solicitações à REST API do Tableau Server. Para obter mais informações, consulte [Habilitação do CORS no Tableau Server](https://help.tableau.com/current/api/rest_api/pt-br/help.htm#REST/rest_api_concepts_fundamentals.htm#Enabling).

### vizportal.site\_user\_group\_count\_enabled

**Versão:** adicionado na versão 2022.3.5 e posterior, 2023.1.0 e posterior.

Valor padrão: `false`

Controla se a página Usuários do site incluirá uma coluna mostrando a contagem de grupos para cada usuário.

### vizqlserver.allow\_insecure\_scripts

Valor padrão: `false`

Permite que uma pasta de trabalho seja publicada no servidor pelo Tableau Desktop e aberta do servidor, mesmo que contenha expressões SQL ou R possivelmente não seguras (por exemplo, uma expressão SQL que poderia permitir injeção SQL). Quando definido para `false` (o padrão), publicar uma pasta de trabalho ou abri-la do servidor resultará em uma mensagem de erro, bloqueando a pasta de trabalho. Antes de definir esse valor como `true`, confira o artigo da Base de dados de conhecimento, [Bloqueio ou permissão de scripts inseguros no Tableau Server](https://kb.tableau.com/articles/issue/blocking-or-allowing-insecure-scripts-in-tableau-server?lang=pt-br).

### vizqldataservice.vmopts

**Versão:** adicionado na versão 2025.1.

Valor padrão: `-Xmx<default_value>m -XX:+CrashOnOutOfMemoryError -XX:-CreateCoredumpOnCrash`

O valor padrão baseia-se na quantidade de memória do sistema. O tamanho máximo da pilha JVM é dimensionado para 3,125% da RAM total do sistema.

Essa opção controla o tamanho máximo da pilha JVM para a ingestão do Tableau Catalog. Como o valor padrão é dimensionado automaticamente, use essa opção para substituir o valor padrão somente quando absolutamente necessário, modificando o argumento -Xmx<default\_value>g. Por exemplo, é possível usar o comando a seguir para aumentar o tamanho máximo da pilha para 6 GB:

tsm configuration set -k vizqldataservice.vmopts -v "-Xmx6g -XX:+CrashOnOutOfMemoryError -XX:-CreateCoredumpOnCrash"

O valor padrão é baseado na quantidade de memória do sistema e consiste em 3,125% da RAM total do sistema.

Controla o tamanho da pilha do Index and Search Server. Como o valor padrão é dimensionado automaticamente, use essa opção para substituir o valor padrão somente quando absolutamente necessário. Acrescente a letra "k" ao valor para indicar kilobytes, "m" para indicar megabytes e "g" para indicar gigabytes. Como regra geral, defina o tamanho da pilha inicial (`-Xms`) igual ao tamanho da pilha máxima (`-Xmx`) para minimizar as coletas de lixo.

### vizqlserver.browser.render

Valor padrão: `true`

As exibições abaixo do limite definido por `vizqlserver.browser.render_threshold` ou `vizqlserver.browser.render_threshold_mobile` são renderizadas pelo navegador da Web do cliente e não pelo servidor. Consulte [Configurar a renderização do lado do cliente](https://help.tableau.com/current/server/pt-br/browser_rendering.htm) para obter detalhes.

### vizqlserver.browser.render\_threshold

Valor padrão: `100`

O valor padrão representa um alto nível de complexidade para uma exibição mostrada em um computador. Os fatores de complexidade incluem número de marcas, cabeçalhos, linhas de referência e anotações. As exibições que excedem esse nível de complexidade são renderizadas pelo servidor e não no navegador da Web do computador.

### vizqlserver.browser.render\_threshold\_mobile

Valor padrão: `60`

O valor padrão representa um alto nível de complexidade para uma exibição mostrada em um tablet. Os fatores de complexidade incluem número de marcas, cabeçalhos, linhas de referência e anotações. As exibições que excedem esse nível de complexidade são renderizadas pelo servidor e não no navegador da Web do tablet.

### vizqlserver.clear\_session\_on\_unload

Valor padrão: `false`

Determina se as sessões VizQL são mantidas na memória quando um usuário sai de uma exibição ou fecha o navegador. O valor padrão (false) mantém as sessões na memória. Para fechar sessões do VizQL ao sair de uma exibição ou fechar um navegador, defina o valor como `true`.

### vizqlserver.force\_maps\_to\_offline

**Versão:** adicionado na versão 2020.4.0

Valor padrão: `false`

Determina se o Tableau Server é executado no modo offline para mapas. Isso é útil em ambientes desconectados onde o acesso à Internet e ao servidor de mapas é restrito. Para ativar o modo offline para mapas, defina esse valor para `true`. Para obter mais informações sobre a instalação e configuração do Tableau Server em um ambiente sem acesso à Internet, consulte [Instalar o Tableau Server em um ambiente desconectado (fisicamente isolado)](https://help.tableau.com/current/server/pt-br/install_air_gapped.htm).

### vizqlserver.geosearch\_cache\_size

Valor padrão: `5`

Define o número máximo de diferentes conjuntos de dados de localidade de pesquisa geográfica/idioma que podem ser carregados na memória do servidor ao mesmo tempo. Quando o servidor recebe uma solicitação de pesquisa geográfica de conjunto de dados de localidade/idioma que não esteja na memória, ele carregará esse conjunto na memória. Se o carregamento do conjunto de dados exceder o limite especificado, o conjunto de dados de localidade/idioma usado menos recentemente será limpo da memória para permitir o carregamento do conjunto solicitado. O valor mínimo é 1. Cada cache ocupa cerca de 60 MB da memória (portanto, se definir para 10, o uso da memória será 600 MB (60 \* 10).

### vizqlserver.initialsql.disabled

Valor padrão: `false`

Especificar se deve ignorar as instruções de SQL iniciais para todas as fontes de dados. Defina como true para ignorar o SQL inicial:

tsm configuration set -k vizqlserver.initialsql.disabled -v true

### vizqlserver.log.level

Valor padrão: `info`

O nível de registro para os componentes Java vizportal. Os logs são gravados no `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizqlserver\*.log`.

Defina como `debug` para obter mais informações. A configuração de depuração pode afetar significativamente o desempenho, portanto você só deve usá-la quando orientado a fazer isso pelo Suporte do Tableau.

A partir da versão 2020.3.0, pode ser configurado dinamicamente. Portanto, se você estiver apenas alterando, não será necessário reiniciar o Tableau Server. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### vizqlserver.NumberOfWorkbookChangesBetweenAutoSaves

Valor padrão: `5`

Configuração de recuperação automática para a criação na Web. Especifica o número de alterações que um usuário deve fazer para acionar o salvamento automático. Seja cauteloso ao alterar este valor. A funcionalidade de recuperação automática pode afetar o desempenho da criação na Web e outras operações relacionadas à visualização no Tableau Server. Recomendamos ajustar este valor fazendo ajustes incrementais no decorrer do tempo.

### vizqlserver\_<n>.port

A porta de uma instância de servidor VizQL (especificada por "<n>") está em execução.

### vizqlserver.protect\_sessions

**Versão:** desativado em 2024.2.0. A partir de 2024.2.0, o Tableau Server sempre impede que sessões VizQL sejam reutilizadas depois da saída do usuário original.

Valor padrão: `true`

Quando definido como `true`, impede que sessões VizQL sejam reutilizadas após a saída do usuário original.

### vizqlserver.querylimit

Valor padrão: `1800`

Tempo mais longo permitido, em segundos, para atualizar uma exibição. 1800 segundos = 30 minutos. Esta opção de configuração afeta o VizQL Server e o Data Server.

### vizqlserver.RecoveryAttemptLimitPerSession

Valor padrão: `3`

Configuração de recuperação automática para a criação na Web. O número máximo de tentativas para recuperar a mesma sessão. Seja cauteloso ao alterar este valor. A funcionalidade de recuperação automática pode afetar o desempenho da criação na Web e outras operações relacionadas à visualização no Tableau Server. Recomendamos ajustar este valor fazendo ajustes incrementais no decorrer do tempo.

### vizqlserver.session.expiry.minimum

Valor padrão: `5`

Número de minutos de tempo de inatividade após o qual uma sessão VizQL poderá ser descartada se o processo VizQL começar a ficar sem memória suficiente.

### vizqlserver.session.expiry.timeout

Valor padrão: `30`

Número de minutos do tempo ocioso após o qual uma sessão VizQL é descartada.

### vizqlserver.sheet\_image\_api.max\_age\_floor

Valor padrão: `1`

Tempo em minutos para armazenar em cache as imagens geradas pelo método Consultar imagem da exibição da REST API. Para obter mais informações, consulte a [Referência da REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_view_image) na ajuda da REST API.

### vizqlserver.showdownload

Valor padrão: `true`

Controla a exibição da opção Pasta de trabalho do Tableau no menu Download nas exibições. Quando estiver definido como `false`, a opção Pasta de trabalho do Tableau não estará disponível.

**Observação:** essa configuração não remove a opção para usuários no modo Edição na Web.

### vizqlserver.showshare

Valor padrão: `true`

Controla a exibição das opções de Compartilhamento nas exibições. Para ocultar essas opções, defina como false.

**Observação:** os usuários podem substituir o padrão do servidor configurando o parâmetro "showShareOptions" JavaScript ou URL.

### vizqlserver.url\_scheme\_whitelist

Especifica um ou mais esquemas de URL na lista de permissões (lista autorizada) quando usa as [Ações de URL](https://help.tableau.com/current/pro/desktop/pt-br/actions_url.htm) em exibições e painéis. Os esquemas `http`, `https`, `gopher`, `mailto`, `news`, `sms`, `tel`, `tsc` e `tsl` são permitidos (estão na lista autorizada) por padrão. Esse comando pode conter diversos valores separados por vírgula e espaço, como aparece no exemplo a seguir:

`tsm configuration set -k vizqlserver.url_scheme_whitelist -v _scheme1_, _scheme2_`

Os valores que você especificar sobrescrevem qualquer configuração anterior. Portanto, é necessário incluir a lista completa de esquemas no comando `set`. (Não é possível alterar a lista de esquemas ao executar repetidamente o comando `set`.)

### vizqlserver.web\_page\_objects\_enabled

Valor padrão: `true`

Controla se esses objetos da Página da Web podem exibir URLs de destino. Para evitar que as páginas da Web apareçam, defina como false.

### vizqlserver.WorkbookTooLargeToCheckpointSizeKiB

Valor padrão: `5120`

Configuração de recuperação automática para a criação na Web. Limite de tamanho (KB) de uma pasta de trabalho que será salva automaticamente. Pastas de trabalho maiores que esse valor não serão salvas automaticamente. Seja cauteloso ao alterar este valor. A funcionalidade de recuperação automática pode afetar o desempenho da criação na Web e outras operações relacionadas à visualização no Tableau Server. Recomendamos ajustar este valor fazendo ajustes incrementais no decorrer do tempo.

**Observação:** versões mais antigas do Server usam um valor padrão: `1024`

### vizqlserver.workflow\_objects\_enabled

Valor padrão: `true`

Determina se o objeto Fluxo de trabalho de ações externas do Tableau pode ser adicionado aos painéis.

### webdataconnector.refresh.enabled

Obsoleto. Em vez disso, use [`tsm data-access web-data-connectors allow`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-allow).

Determina se as atualizações de extração para os conectores de dados da Web (WDCs) estão habilitadas no Tableau Server. Para desabilitar a atualização de todos os WDCs, defina o valor desta chave para `false`, conforme mostrado abaixo:

`tsm configuration set --key webdataconnector.refresh.enabled --value false`

Para saber mais, consulte [Conectores de dados da Web no Tableau Server](https://help.tableau.com/current/server/pt-br/datasource_wdc.htm).

### webdataconnector.whitelist.fixed

Obsoleto. Em vez disso, use [`tsm data-access web-data-connectors add`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-add).

Especifica um ou mais conectores de dados da Web (WDCs) que podem ser usados para acessar as conexões de dados por HTTP ou HTTPS. Este comando é formatado como dados JSON em uma única linha, com aspas duplas (") escapadas usando uma barra invertida (\\).

Por exemplo, para adicionar San Francisco Film Locations WDC à lista de segurança:

`tsm configuration set --key webdataconnector.whitelist.fixed --value "'{\"https://tableau.data.world:443\": {\"properties\": { \"secondary_whitelist\": [\"(https://data.world/)(.*)\"] } } }'"`

Para saber mais, consulte [Conectores de dados da Web no Tableau Server](https://help.tableau.com/current/server/pt-br/datasource_wdc.htm).

### webdataconnector.enabled

Obsoleto. Em vez disso, use [`tsm data-access web-data-connectors allow`](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#web-data-connectors-allow).

Valor padrão: `true`

Quando definido como `true`, use os comandos `tsm` para gerenciar os conectores de dados da Web no servidor.

### webdataconnector.whitelist.mode

Valor padrão: `mixed`

Determina como o Tableau Server pode executar conectores de dados da Web. Os modos compatíveis são:

- `mixed`. Os usuários podem executar conectores que estão na lista de permissões (lista autorizada) de URLs. Originalmente, este modo também permitia que os usuários executassem WDCs que foram importados. A importação de WDCs não é mais aceita.
- `fixed`. Os usuários podem executar conectores que estão na lista de permissões (lista autorizada) de URLs.
- `insecure`. Os usuários podem executar qualquer conector.

**Importante:** use a opção `insecure` _apenas_ para desenvolvimento e teste. Como os conectores executam código personalizado, a execução de conectores que não foram aprovados pode representar uma ameaça à segurança.

### wgserver.audit\_history\_expiration\_days

Valor padrão: `183`

Especifica o número de dias depois do qual os registros de eventos históricos serão removidos do banco de dados do PostgreSQL (o bando de dados do Tableau Server).

### wgserver.authentication.legacy\_identity\_mode.enabled

**Versão:** adicionado na versão 2022.1

Valor padrão: `false` para Tableau Server 2022.1 e posterior. Para implantações anteriores à 2022.1 do Tableau Server atualizadas para 2022.1 ou posterior, o valor padrão é `true`.

Definido como `false` para usar pools de identidades.

Para obter mais informações, consulte [Solucionar problemas de pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools_manage.htm#troubleshoot).

### wgserver.authentication.identity\_pools.default\_pool\_description

**Versão:** adicionado na versão 2023.1.

Valor padrão: Null

Opcionalmente, você pode adicionar uma descrição para o pool inicial (configurado pelo TSM) à página inicial do Tableau Server e ficar visível para todos os usuários. Quando um ou mais pools de identidades são criados, essa descrição é adicionada abaixo da opção de entrada principal e pode ser usada para ajudar a orientar os usuários que pertencem ao grupo inicial (TSM configurado) para a opção de entrada correta.

Por exemplo, para adicionar uma descrição “Funcionários regulares entrem aqui”, você pode usar o seguinte comando:

`tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v "Regular employees sign in here"`

**Observação:** a descrição inicial do conjunto (configurado pelo TSM) é diferente da observação [Personalização de logon](https://help.tableau.com/current/server/pt-br/maintenance_set.htm#sign_in_custom). A observação de personalização de logon é exibida na página inicial do Tableau Server abaixo de todas as opções de logon e na página em que os usuários do pool inicial (TSM configurado) inserem o nome de usuário e a senha.

### wgserver.authentication.prep\_builder\_externalbrowser

**Versão:** adicionado na versão 2025.3

Valor padrão: `False`

Defina o método de autenticação preferencial para usuários ao fazer logon no Tableau Server a partir do Tableau Prep Builder. Ao definir como `True`, a janela de autenticação do Tableau Server é aberta no navegador externo do usuário, em vez do navegador incorporado.

A partir da versão 2026.1, essa opção também pode ser usada com o gerenciamento de licenças baseado em logon (LBLM).

Quando definida, essa opção se aplica quando a opção Usar configurações do servidor é selecionada no menu do Tableau Prep Builder Server. Os usuários também podem escolher a opção Autenticação do servidor no menu do Tableau Prep Builder Server, independentemente dessa configuração. Para obter mais informações, consulte [Publicar um fluxo para o Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm#before-you-publish).

Para definir o método de autenticação de servidor preferencial para o navegador externo para usuários do Tableau Prep Builder, use o seguinte comando:

`tsm configuration set -k wgserver.authentication.prep_builder_externalbrowser -v true`

### wgserver.change\_owner.enabled

Valor padrão: `true`

Controla se a propriedade de uma pasta de trabalho, fonte de dados ou projeto pode ser alterada. Outras opções incluem `false` e `adminonly`.

### wgserver.clickjack\_defense.enabled

Valor padrão: `true`

Quando definido como `true`, ajuda a evitar que uma pessoa mal-intencionada cometa "Roubo de cliques" a um usuário do Tableau Server. Em um ataque de roubo de cliques, a página de destino é exibida de maneira transparente sobre uma segunda página, e o atacador faz com que o usuário clique ou insira informações na página de destino enquanto acha que ele ou ela está interagindo com a segunda página.

Para obter mais informações, consulte [Proteção contra roubo de clique](https://help.tableau.com/current/server/pt-br/clickjack_protection.htm)

### wgserver.domain.accept\_list

**Version:** foi adicionado na versão 2020.4.0 e substitui `wgserver.domain.whitelist`.

Valor padrão: nulo

Viabiliza a conexão do Tableau Server com os domínios secundários do Active Directory. O Tableau Server é conectado a um domínio secundário para sincronização de usuários, porém o Tableau Server não está instalado nesse domínio. O Tableau Server tenta se conectar a domínios secundários para sincronização de usuários e grupos. Em alguns casos, não é possível conectar o Tableau Server ao domínio secundário, o que resulta no erro: “O domínio não está na lista de permissões (errorCode=101015)”.

A configuração da opção `wgserver.domain.accept_list` é exigida por uma correção da vulnerabilidade de segurança, [\[Importante\] ADV-2020-003: autenticação forçada do Tableau Server](https://community.tableau.com/s/news/a0A4T000001v3SaUAI). A partir de fevereiro de 2020, a correção dessa vulnerabilidade está incluída em todas as versões mais recentes e versões de manutenção do Tableau Server.

Para definir essa opção, digite o domínio secundário entre aspas duplas. Vários domínios devem ser separados por vírgula e espaço. Por exemplo, `tsm configuration set -k wgserver.domain.accept_list -v "example.org, domain.com"`.

A funcionalidade Curinga não é aceita. Por exemplo, se o Tableau for conectado a `sub1.example.org` e `sub2.example.org`, os dois domínios deverão ser adicionados.

A atualização da opção `wgserver.domain.accept_list` substitui o valor atual. Portanto, se você estiver adicionando um novo domínio a um conjunto de domínios existentes armazenados no valor, inclua todos os domínios existentes com o novo domínio ao definir a opção. É possível recuperar a lista completa de domínios existentes, executando `tsm configuration get –k wgserver.domain.accept_list`.

### wgserver.domain.allow\_insecure\_connection

Valor padrão: `False`

Essa configuração só se aplica ao Windows. Esta opção especifica se o Tableau Server se conectará ao Active Directory por meio de um canal não criptografado. O valor padrão, `False`, impõe um canal criptografado. Se o canal LDAP não estiver criptografado, o Tableau Server não se conectará ao Active Directory.

A infraestrutura do Active Directory deve gerenciar certificados e confiança em computadores associados ao domínio. Dessa forma, o canal de comunicação entre os recursos do Tableau Server e do Active Directory deve ser criptografado. Não recomendamos permitir comunicações não criptografadas com o Active Directory, pois essa configuração é vulnerável a ataques man-in-the-middle.

Se você estiver atualizando para o Tableau Server 2021.2 ou posterior e seu canal LDAP não estiver criptografado, a atualização falhará. Você pode executar este comando para permitir uma conexão insegura em versões mais antigas do Tableau Server, antes de atualizar. Se você estiver executando este comando em uma versão anterior a 2021.2, deverá incluir a opção com o comando `--force-keys`.

### wgserver.domain.fqdn

Valor padrão: valor de `%USERDOMAIN%`

O nome de domínio totalmente qualificado do servidor Active Directory a ser usado.

### wgserver.domain.password

Valor padrão: nulo

Especifica a senha da conta de usuário usada para conexão LDAP. Consulte a [Referência de configuração do armazenamento de identidades externo](https://help.tableau.com/current/server/pt-br/ldap_config.htm).

Exemplo: `tsm configuration set -k wgserver.domain.password -v "svcP@ssword"`

### wgserver.domain.username

Valor padrão: nulo

Especifica o nome da conta de usuário usada para conexão LDAP. Consulte a [Referência de configuração do armazenamento de identidades externo](https://help.tableau.com/current/server/pt-br/ldap_config.htm).

Exemplo: `tsm configuration set -k wgserver.domain.username -v "example\svc-tableau"`

### wgserver.domain.whitelist

**Importante:** essa chave está obsoleta desde a versão 2020.4.0. Em vez disso, use `[wgserver.domain.accept_list](#wgserver-domain-acceptlist)` .

Valor padrão: nulo

Viabiliza a conexão do Tableau Server com os domínios secundários do Active Directory. O Tableau Server é conectado a um domínio secundário para sincronização de usuários, porém o Tableau Server não está instalado nesse domínio. O Tableau Server tenta se conectar a domínios secundários para sincronização de usuários e grupos. Em alguns casos, não é possível conectar o Tableau Server ao domínio secundário, o que resulta no erro: “O domínio não está na lista de permissões (errorCode=101015)”.

### wgserver.extended\_trusted\_ip\_checking

Valor padrão: `false`

Executa a correspondência do cliente IP para solicitações de tíquetes confiáveis.

### wgserver.ignore\_domain\_in\_username\_for\_matching

**Versão:** adicionado nas versões 2021.4.21, 2022.1.17, 2022.3.9 e 2023.1.5

Valor padrão: `false`

Ao ativar o SAML, você pode configurar o Tableau Server para ignorar a parte do domínio do atributo de nome de usuário SAML ao combinar o nome de usuário do provedor de identidade (IdP) com uma conta de usuário no Tableau Server. Você pode ignorar a parte do domínio do atributo nome de usuário quando já tiver usuários definidos no Tableau Server que correspondam à parte do prefixo de um atributo de nome de usuário, mas não à parte do domínio do atributo de nome de usuário. Para obter mais informações, consulte a seção [Ignorar domínio ao corresponder ao atributo de nome de usuário SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm#ignore_domain) no tópico Requisitos SAML.

Por exemplo, para ignorar o nome de domínio no atributo de nome de usuário SAML, execute o seguinte comando:

`tsm configuration set -k wgserver.ignore_domain_in_username_for_matching -v true`

**Importante:**

- não recomendamos nome de domínio sem tomar precauções. Especificamente, verifique se os nomes de usuário são exclusivos em todos os domínios configurados que você criou no seu IdP.
- Este comando só funciona em implantações do Tableau Server que estão em `legacy-identity-mode` ou implantações que não foram atualizadas por meio do [migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm) para usar o Serviço de Identidade.

### wgserver.restrict\_options\_method

Valor padrão: `true`

Controla se o Tableau Server aceita solicitações HTTP OPTIONS. Se esta opção estiver definida como `true`, o servidor retornará HTTP 405 (Método não permitido) para solicitações HTTP OPTIONS.

### wgserver.saml.blocklisted\_digest\_algorithms

**Versão:** adicionado na versão 2021.1.

Valor padrão: `SHA1`

Especifica os algoritmos de hash que não são permitidos para qualquer assinatura de certificado SAML ou método de compilação de asserção SAML ou métodos de assinatura relevantes. Quando definidas, os certificados ou as asserções assinadas e com hash e um algoritmo bloqueado falharão.

Existem vários locais onde o SHA-1 pode ser usado no Tableau e no IdP. Por exemplo:

- Certificados carregados com TSM que são usados pelo Tableau Server para assinar a solicitação que é enviada ao IdP.
- Certificados nos metadados IdP usados para verificar o AuthnResponse (assinatura) recebido do IdP usando a chave pública no Certificado.
- Asserções de entrada assinadas e hash com SHA-1 (DigestMethod definido como SHA-1 e SignatureMethod definido como SHA-1).

O valor padrão foi alterado para (`SHA1` no Tableau Server 2021.2. Para obter mais informações sobre como atualizar para 2021.2 com SAML configurado, consulte o artigo da Base de dados de conhecimento, [Tableau Server usando a autenticação SAML falha ao iniciar ou rejeita o logon após a atualização para o Tableau Server 2021.2](https://help.salesforce.com/s/articleView?id=001472645&type=1).

### wgserver.saml.forceauthn

**Versão:** adicionado na versão 2019.3.

Valor padrão: `false`

Quando definido para `true`, se a sessão de usuário do Tableau expirar, o Tableau Server reautenticará o usuário com o IdP. Essa opção também pode ser usada para solicitar que o IdP solicite a reautenticação do usuário, mesmo se o usuário tiver uma sessão IdP ativa.

### wgserver.saml.idpattribute.username

Especifica nome do atributo no qual o SAML IdP armazena nomes de usuário. Por padrão, ele é definido como `username`. Se o nome de atributo que o seu IdP usa contém espaços, coloque-o entre aspas. Para obter mais informações, consulte [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm) ou [Configurar SAML para um site específico](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).

### wgserver.saml.iframed\_idp.enabled

Valor padrão: `false`

O padrão false significa que os usuários selecionam o botão de fazer logon em uma exibição inserida, o formulário de logon do IdP é aberto em uma janela pop-up.

Ao definir como true, e um usuário de servidor SAML que já tenha feito logon acessar uma página da Web com uma exibição inserida, não será necessário que ele faça logon para visualizar a exibição.

É possível definir isso como true apenas se o IdP oferece suporte a logon dentro de um iframe. A opção de iframe é menos segura do que o uso de um pop-up, por isso nem todos os IdPs oferecem suporte a ela. Se a página de logon do IdP implementar proteção contra clickjack, como a maioria faz, não será possível exibir a página de logon em um iframe e o usuário não conseguirá fazer logon.

Se o seu IdP oferece suporte a fazer logon por meio de um iframe, pode ser necessário habilitá-lo de maneira explícita. No entanto, mesmo que seja possível usar essa opção, ela desabilita a proteção contra clickjack do Tableau Server para SAML e por isso ela ainda apresenta um risco de segurança.

### wgserver.saml.maxassertiontime

Valor padrão: `3000`

Determina o número máximo de segundos, desde a criação, em que uma asserção de SAML pode ser usada.

### wgserver.saml.min\_allowed.elliptic\_curve\_size

Valor padrão: `256`

**Versão:** adicionado na versão 2021.1, mas não incluiu um valor padrão. Em 2021.2, o valor padrão foi definido como`256`.

Essa opção especifica o tamanho mínimo da curva ECDSA permitido para o certificado usado para autenticação SAML. Se você carregar um certificado com um tamanho de curva ECDSA menor que 256, o TSM registrará um erro quando você aplicar as alterações.

Se você estiver atualizando para o Tableau Server 2021.2 ou posterior e seu certificado SAML usar um tamanho de curva ECDSA inferior a 256, o Tableau Server não será iniciado após a atualização. Recomendamos fazer upload de um novo certificado com tamanho de curva ECDSA 256 (ou maior) antes da atualização. Como alternativa, você pode executar este comando para definir um tamanho de curva ECDSA inferior em versões mais antigas (pré-2021.1) do Tableau Server antes de atualizar. Se você estiver executando este comando em uma versão anterior a 2021.1, você deve incluir a opção `--force-keys` com o comando. Para obter mais informações sobre como atualizar para 2021.2 com SAML configurado, consulte o artigo da Base de dados de conhecimento, [Tableau Server usando a autenticação SAML falha ao iniciar ou rejeita o logon após a atualização para o Tableau Server 2021.2](https://kb.tableau.com/articles/issue/tableau-server-using-saml-authentication-fails-to-start-or-rejects-login-after-upgrade-to-tableau-server-2021-2?lang=pt-br).

### wgserver.saml.min\_allowed.rsa\_key\_size

Valor padrão: `2048`

**Versão:** adicionado na versão 2021.1, mas não incluiu um valor padrão. Em 2021.2, o valor padrão foi definido como`2048`.

Esta opção especifica o comprimento mínimo permitido da chave RSA para o certificado usado para autenticação SAML. Se você carregar um certificado com um comprimento de chave RSA inferior a 2048, o TSM registrará um erro quando você aplicar as alterações.

Para executar a autenticação SAML com um comprimento de chave 1024 RSA (não recomendado), defina este valor como `1024`.

Se você estiver atualizando para o Tableau Server 2021.2 ou posterior e seu certificado SAML usar um comprimento de chave inferior a 2048, o Tableau Server não será iniciado após a atualização. Recomendamos fazer upload de um novo certificado com 2048 (ou maior) de comprimento de chave antes de fazer o upgrade. Como alternativa, você pode executar este comando para definir uma intensidade de chave inferior em versões mais antigas (pré-2021.1) do Tableau Server antes de atualizar. Se você estiver executando este comando em uma versão anterior a 2021.1, você deve incluir a opção `--force-keys` com o comando. Para obter mais informações sobre como atualizar para 2021.2 com SAML configurado, consulte o artigo da Base de dados de conhecimento, [Tableau Server usando a autenticação SAML falha ao iniciar ou rejeita o logon após a atualização para o Tableau Server 2021.2](https://kb.tableau.com/articles/issue/tableau-server-using-saml-authentication-fails-to-start-or-rejects-login-after-upgrade-to-tableau-server-2021-2?lang=pt-br).

### wgserver.saml.responseskew

Valor padrão: `180`

Define a diferença máxima em segundos entre o horário do Tableau Server e o horário da criação da asserção (com base no horário do servidor IdP) que ainda permite que a mensagem seja processada.

### wgserver.saml.sha256

Valor padrão: `true`

Quando definido para `true`, o Tableau Server fará o hash de assinaturas de mensagens e digerirá com SHA-256 em afirmações SAML para o IdP. Defina esta opção `false` apenas se o seu IdP rejeitar afirmações contendo conteúdo hashed SHA-256.

### wgserver.session.apply\_lifetime\_limit

Valor padrão: `false`

Controla se há vida útil de sessão para sessões do servidor. Defina essa opção como `true`para configurar uma vida útil de sessão de servidor.

### wgserver.session.idle\_limit

Valor padrão: `240`

A quantidade em minutos de tempo ocioso até um logon no aplicativo Web atingir o tempo limite.

### wgserver.session.lifetime\_limit

Valor padrão: `1440`

A duração, em minutos, de uma sessão do servidor se a sessão tiver uma vida útil definida. O padrão é 1440 minutos (24 horas). Se `wgserver.session.apply_lifetime_limit` for `false` (o padrão), isso é ignorado.

### wgserver.unrestricted\_ticket

Valor padrão: `false`

Determina se o acesso aos recursos do servidor para usuários autenticados por tíquetes confiáveis será estendido. O comportamento padrão permite que os usuários acessem somente as exibições. Definir isso como `true` permite que os usuários com tíquetes confiáveis válidos acessem os recursos do servidor (projetos, pastas de trabalho etc) como se tivessem entrado com as credenciais.

### workerX.gateway.port

Valor padrão: `80` (`443` se SSL)

A porta externa em que o Apache escuta para workerX (onde um "computador de trabalho" é o termo usado para os nós de servidor subsequentes no cluster). worker0.gateway.port é a porta externa do Tableau Server. Em um ambiente distribuído, worker0 é o nó inicial do Tableau Server.

### workerX.vizqlserver.procs

Valor padrão: <number>

Número de servidores VizQL.

### zookeeper.config.snapCount

Especifica o número de transações necessárias para fazer com que o Serviço de coordenação crie um instantâneo dos registros. Por padrão, esse valor é 100.000 transações. Se o Serviço de coordenação não estiver gravando transações suficientes para resultar em instantâneos, a limpeza automática de instantâneos com mais de cinco dias não ocorrerá e você poderá perder espaço em disco para os registros de transação. Por padrão, os registros de transação e os instantâneos são criados no diretório de dados do Tableau.

<!-- document id=53d387459586c13e3bb8b5cf19c1a9ca0a362745e54d0e6d737dc47e5e377871 url=/tableau/current/pt-br/server/openid_auth.md -->

[Pular para o conteúdo principal](#main-content)

# OpenID Connect

É possível configurar o Tableau Server para oferecer suporte ao OpenID Connect (OIDC) para Single Sign-on (Logon único, SSO). O OIDC é um protocolo de autenticação padrão que permite aos usuários fazer logon em um provedor de identidade (IdP) como o Google ou Salesforce. Após fazerem logon com sucesso no IdP, eles entram automaticamente no Tableau Server .

A configuração do OIDC envolve várias etapas. Os tópicos nesta seção fornecem informações gerais sobre a utilização do Tableau Server com o OIDC e uma sequência para a configuração do IdP e do Tableau Server .

**Observação:** salvo indicação em contrário, as informações sobre a autenticação OIDC se aplicam à autenticação OIDC configurada no TSM durante a configuração do Tableau Server ou à autenticação OIDC configurada com [pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Visão geral da autenticação

Esta seção descreve o processo de autenticação do OpenID Connect (OIDC) com Tableau Server .

![Um diagrama que ilustra a interação entre o Tableau Server, os clientes e o OpenID Connect.](/tableau/current/pt-br/server/pt-br/Img/openid_auth_overview.png)

1\. Um usuário tenta entrar no Tableau Server em um computador cliente.

2\. Tableau Server redireciona a solicitação de autenticação ao gateway IdP.

3\. O usuário é solicitado a fornecer credenciais e faz a autenticação com o IdP com sucesso. O IdP responde com uma URL de redirecionamento de volta ao Tableau Server . A URL de redirecionamento inclui um código de autorização para o usuário.

4\. O cliente é redirecionado para o Tableau Server e apresenta o código de autorização.

5\. O Tableau Server apresenta o código de autorização do cliente ao IdP, juntamente com suas próprias credenciais de cliente. Tableau Server também é cliente do IdP. Esta etapa destina-se a evitar ataques de spoofing ou “man-in-the-middle”.

6\. O IdP retorna um token de acesso e um token de ID para o Tableau Server .

- Validação do JSON Web Token (JWT): por padrão, o Tableau executa uma validação do IdP JWT. Durante a descoberta, o Tableau recupera as chaves públicas especificadas pelo `jwks_uri` no documento de descoberta da configuração do IdP. O Tableau valida o token de ID da expiração e, em seguida, verifica o JWS (JSON Web Signature), o emissor (IdP) e a ID do cliente. Você pode saber mais sobre o processo do JWT na documentação do OpenID [10\. Assinaturas e criptografia](http://openid.net/specs/openid-connect-core-1_0.html#SigEnc) e o padrão proposto pela IETF, [o JSON Web Token](https://tools.ietf.org/html/rfc7519). Recomenda-se deixar a validação do JWT habilitada, a menos que o Idp não ofereça suporte.
- O token da ID é um conjunto de pares de chaves de atributo para o usuário. Os pares de chaves são chamados de _reivindicações_. Veja um exemplo de reivindicação de IdP para um usuário:
    
    "sub"                     : "7gYhRR3HiRRCaRcgvY50ubrtjGQBMJW4rXbpPFpg2cptHP62m2sqowM7G1LwjN5"
    "email"                   : "alice@example.com",
    "email\_verified"          : true,
    "name"                    : "Alice Adams",
    "given\_name"              : "Alice",
    "family\_name"             : "Adams",
    "phone\_number"            : "+359 (99) 100200305",
    "profile"                 : "https://tableau.com/users/alice"

7\. O Tableau Server identifica o usuário nas reivindicações de IdP e conclui a solicitação de autenticação da Etapa 1. O Tableau Server procura o registro de conta do usuário armazenado no repositório correspondente ao "sub" (identificador de assunto) para identificar a conta de usuário correta. Se nenhuma conta de usuário for armazenada com o valor de reivindicação “sub”, o Tableau Server procurará um nome de usuário no repositório que corresponda à reivindicação "email" do IdP. Quando uma correspondência de nome de usuário for bem-sucedida, o Tableau Server armazenará a sub-afirmação correspondente no registro do usuário no repositório.O Tableau Server pode ser configurado para usar declarações diferentes para esse processo. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm).

8\. Tableau Server autoriza o usuário.

## Como o Tableau funciona com o OpenID Connect

O OpenID Connect (OIDC) é um protocolo flexível, compatível com muitas opções de informações, que são trocadas entre um provedor de serviços (nesse caso, o Tableau Server) e um IdP. A lista a seguir fornece detalhes sobre a implementação do OpenID no Tableau Server . Estes detalhes podem ajudar a entender quais tipos de informação o Tableau Server envia e espera, e como configurar um IdP.

- Tableau Server O é compatível somente com o OpenID Authorization Code Flow como descrito na [Especificação final do OpenID Connect](http://openid.net/specs/openid-connect-core-1_0.html) na documentação do OpenID Connect.
- Tableau Server depende do uso de descoberta ou de uma URL de provedor para recuperar os metadados do provedor OpenID.Como alternativa, você pode hospedar um documento de descoberta estático no Tableau Server. Para obter mais informações, consulte [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm).
- Tableau Server tem suporte de autenticação do cliente `client_secret_basic` e `client_secret_post` .
- O Tableau Server espera um valor `kid` no Cabeçalho JOSE do atributo `id_token`. Este valor é combinado com uma das chaves encontradas no documento JWK Set, cujo URI é especificado pelo valor `jwks_uri`, no documento de descoberta do OpenID. Um valor `kid` deve estar presente, mesmo se houver apenas uma chave no documento JWK Set.
- O Tableau Server oferece suporte ao OpenID para o parâmetro `x5c` do JWK ou para o uso de certificados X.509.
- Por padrão, o Tableau Server ignora as configurações de proxy e envia todas as solicitações OpenID diretamente para o IdP.
    
    Se o Tableau Server estiver configurado para usar um proxy de encaminhamento para se conectar à Internet, você deve fazer alterações adicionais conforme descrito em [Configurar o Tableau Server para OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm).

## Atributos de usuário em declarações OIDC

A partir do Tableau Sever 2026.2, quando configurado e a configuração do recurso estiver habilitada, você poderá passar declarações de atributo de usuário no JSON Web Token (JWT) enviado pelo provedor de identidade (IdP) para o Tableau Cloud durante o logon. Esses atributos de usuário podem ser usados com as funções de atributo de usuário do Tableau (`(USERATTRIBUTE()`, `USERATTRIBUTEINCLUDES()`) para controlar e personalizar dinamicamente o conteúdo. O Tableau valida as declarações e, em seguida, permite o acesso ao conteúdo.

Para obter mais informações, consulte [Personalizar e controlar o acesso aos dados usando atributos de usuário](https://help.tableau.com/current/server/pt-br/openid_auth_server_config.htm#user_attributes).

**Exemplo de JWT**

"sub"                     : "7gYhRR3HiRRCaRcgvY50ubrtjGQBMJW4rXbpPFpg2cptHP62m2sqowM7G1LwjN5"
"email"                   : "alice@example.com",
"email\_verified"          : true,
"name"                    : "Alice Adams",
"given\_name"              : "Alice",
"family\_name"             : "Adams",
"phone\_number"            : "+359 (99) 100200305",
"profile"                 : "https://tableau.com/users/alice",		
"region"			 	  : \["South", "South West"\] 

## Outros artigos nesta seção

<!-- document id=f93cf7464965e0c2475ea8104e0312f8145eb8309bc1c6acbe75c693ba8f42e2 url=/tableau/current/pt-br/server/ts_aws_performance_optimization.md -->

[Pular para o conteúdo principal](#main-content)

# Otimização do desempenho do Tableau Server na AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Otimizar o desempenho do Tableau Server, quando ele está instalado na instância do Amazon EC2 na nuvem da AWS, adiciona outra dimensão ao ajuste da sua solução Tableau Server. Esta seção aborda o ajuste do Tableau Server para a nuvem. Para obter informações sobre o ajuste de desempenho, consulte [Visão geral do desempenho do Tableau Server](https://help.tableau.com/current/server/pt-br/perf.htm). Para obter informações sobre as ferramentas que podem ser usadas para ajudar a otimizar o desempenho, consulte [Recursos de desempenho](https://help.tableau.com/current/server/pt-br/perf_resources.htm).

É importante ter em mente que cada implementação do Tableau Server na AWS é diferente, porque a carga de trabalho de cada pessoa é única. Os funcionários da sua empresa são diferentes, utilizam dados diferentes, fazem perguntas diferentes e têm necessidades de negócios diferentes que os de outra empresa. Por este motivo, recomendamos testar as suas cargas de trabalho no Tableau Server em tipos de instância do Amazon EC2 diferentes, antes de colocá-las em produção. As demandas da sua carga de trabalho provavelmente serão influenciadas pelos seguintes fatores:

- Uso pesado, leve ou moderado da Extração de Dados do Tableau
- A proporção de pessoas que visualizam em relação àquelas que interagem com as exibições e painéis
- As atualizações de extração de dados do Tableau que ocorrem durante ou após o horário comercial
- O número de indivíduos simultâneos durante um determinado período
- A complexidade da exibição e do painel
- O tamanho da comunidade que utiliza a Criação na Web do Tableau

Há algumas diretrizes gerais que, se seguidas, aumentam suas chances de escolher o tipo correto de instância. Ao usar o TabJolt, uma ferramenta gratuita de teste de escalonabilidade criada pelo Tableau,é possível executar testes de carga nas instâncias do Amazon EC2. Os testes foram relacionados a desempenho e a escalonabilidade e usaram as seguintes métricas:

- Número de usuários virtuais em execução
- Média de transações por segundo
- Média de tempo de resposta bem-sucedido
- Média de taxa de erro (o teste considera qualquer visualização que leva mais de 60 segundos para gerar um erro)

## Práticas recomendadas de desempenho

As práticas recomendadas a seguir podem ser úteis para consulta durante a implementação do Tableau na AWS:

- Sempre execute, no mínimo, 8 núcleos por instância do Amazon EC2
    
    Mesmo com um número relativamente baixo de usuários, as instâncias do EC2 com menos de 16 vCPUs (o equivalente a 8 núcleos) não apresentam um desempenho bom e consistente. Por exemplo, uma instância r4.4xlarge, com 16 vCPUs, pode lidar com mais usuários em um tempo de resposta e taxa de erro menores, do que duas instâncias r4.2xlarge, que têm 8vCPUs cada. Esse padrão é consistente à medida que você faz o escalonamento, com quatro instâncias de 16vCPU e duas instâncias de 32vCPU superando bastante o desempenho de oito instâncias de 8vCPU.
- A carga de trabalho é um fator determinante dos resultados
    
    A robustez da sua carga de trabalho tem um papel fundamental na determinação do desempenho dela em diferentes tipos de instância do EC2. Por exemplo, ao usar um conjunto diferente de painéis, você perceberá diferenças óbvias no desempenho das mesmas instâncias de máquina virtual subjacentes. Não é muito útil tentar comparar o desempenho usando qualquer outra carga de trabalho que não seja a sua.
- Quando mais CPU, melhor
    
    A CPU é o obstáculo principal para o desempenho do Tableau Server. Em geral, quando há mais necessidade de trabalho com o Tableau, recomendamos que usar CPUs maiores e melhores.
- Certifique-se de que a sua instância do Amazon EC2 tenha RAM suficiente
    
    Quando executamos as mesmas cargas de trabalho em instâncias com menos CPU e mais RAM, temos mais transações por segundo (TPS), tempo de resposta mais curto e menor taxa de erro. As instâncias do EC2 com pouca RAM podem anular o benefício de uma CPU de ponta. Na produção, execute com, no mínimo, 30 GB de RAM, mas o ideal é 8 GB de RAM por núcleo. Embora seja importante escolher uma instância com muita CPU, a execução do Tableau Server em instâncias com pouca RAM levará a um desempenho baixo — independentemente de quanta CPU tiver.
- Você pode querer usar volumes baseados em SSD, mas pode não precisar de Provisioned IOPS
    
    O Tableau Server tem vários processos e componentes, incluindo um banco de dados de capacidade industrial (PostgreSQL) que armazena os metadados do sistema. O Tableau Server precisa de um nível razoável de rendimento de disco para um bom desempenho, por isso aconselhamos o uso somente dos volumes baseados em SSD do Elastic Block Store (EBS). Os discos magnéticos não têm o rendimento necessário para lidar de forma eficaz com as solicitações do banco de dados. No nosso teste, executamos os volumes General Purpose SSD (gp2) e os de Provisioned IOPS do EBS, com dois discos de EBS usados para a maioria dos testes. A maior parte dos volumes de EBS tem 1.500 Provisioned IOPS. Após executar os testes novamente com General Purpose SSDs, nossos resultados foram quase idênticos, com cargas de trabalho moderadamente exigentes. Embora haja casos em que certamente o Provisioned IOPS fará uma diferença óbvia no desempenho das cargas de trabalho do seu Tableau Server no AWS, você não deve pressupor que precisa de Provisioned IOPS como padrão. A melhor maneira de descobrir é testar você mesmo as cargas de trabalho do seu Tableau Server.
- Faça o seu próprio teste com o TabJolt
    
    A sua carga de trabalho e a configuração das suas instâncias Amazon EC2 podem fazer uma grande diferença no desempenho do Tableau Server. A flexibilidade do EC2 facilita a determinação da combinação de configurações e tipos de instância, de acordo com as suas necessidades. Por exemplo, isolar poucos processos que demandam muita RAM e CPU em várias máquinas, em vez de executá-los em todas as máquinas no seu cluster, faz uma grande diferença nas transações por segundo (TPS). Ignore a tentação de comparar as características de desempenho de diferentes cargas de trabalho. Embora isso seja realmente divertido, não é muito útil. Em vez disso, use a mesma carga de trabalho e reformule a sua configuração de hardware e software para obter o melhor efeito. A AWS torna isso muito simples.

<!-- document id=2d03faab3dc54743a2ebb1d6bd3c48bebb2502481ac3d138d9c3a7a815410ba8 url=/tableau/current/pt-br/server/datasource_relationships_perfoptions.md -->

[Pular para o conteúdo principal](#main-content)

# Otimizar consultas de relações usando opções de desempenho

Opções de desempenho são configurações opcionais que definem a cardinalidade (singularidade) e a integridade referencial (registros correspondentes) entre as duas tabelas em uma relação. Essas configurações ajudam o Tableau a otimizar as consultas durante a análise.

- **Se você não tiver certeza do que escolher**, use as configurações padrão recomendadas indicadas pelo Tableau. O uso dos padrões é seguro e gerará automaticamente agregações e uniões de colunas corretas durante a análise. Se você não conhece a cardinalidade ou a integridade referencial, não precisa alterar essas configurações.
- **Se você souber a forma dos dados**, poderá alterar opcionalmente essas configurações para representar a singularidade e a correspondência entre os registros nas duas tabelas.

Em muitos cenários analíticos, o uso das configurações padrão de uma relação oferecerá todos os dados necessários para análise. Em alguns cenários, talvez você queira ajustar as configurações das Opções de desempenho para descrever os dados com mais precisão. Para obter mais detalhes sobre o uso de relacionamentos para combinar e analisar dados, consulte [Relacionar os dados](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm) e esta publicação no blog do Tableau: [Relacionamentos, parte 1: apresentação da nova modelagem de dados no Tableau](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model).

## O que significam as configurações de Cardinalidade e Integridade referencial

![Configurações de opções de desempenho para editar um relacionamento, incluindo cardinalidade e integridade referencial.](/tableau/current/pt-br/server/pt-br/Img/data_model_perfoptions.png)

### Opções de cardinalidade

As configurações da cardinalidade determinam se o Tableau agrega dados de tabela antes ou depois da união de colunas automática dos dados durante a análise.

- Selecione **Muitos** se os valores de campo não forem exclusivos ou se você não souber. O Tableau agregará os dados relevantes antes da união de colunas durante a análise.
- Selecione **Um** se os valores de campo forem exclusivos. Durante a análise, os dados serão unidos antes da agregação. Configurar esta opção de forma correta otimiza as consultas na pasta de trabalho quando os valores de campo na relação são exclusivos. No entanto, selecionar **Um** quando os valores de campo não são exclusivos pode fazer com que valores agregados duplicados sejam mostrados na exibição.

> [!TIP]
> 
> **Observação**: selecionar **Um** trata os registros como se cada valor de chave fosse único e houvesse no máximo apenas uma linha com um valor nulo.

### Opções de integridade referencial

As configurações de Integridade referencial determinam o tipo de união usado para obter os valores de dimensão de uma medida durante a análise.

- Selecione **Alguns registros correspondem** se alguns valores no campo não tiverem uma correspondência na outra tabela ou se você não souber. Durante a análise, o Tableau usa uniões de colunas externas para obter os valores das dimensões de uma medida. Todos os valores de medida serão mostrados na visão, até mesmo medidas sem correspondência.
- Selecione **Todos os registros correspondem** se os valores no campo tiverem uma correspondência na outra tabela. Essa configuração gera uniões de colunas mais simples e em menor quantidade, e otimiza as consultas. Você pode ver resultados inconsistentes durante a análise (valores sem correspondência removidos ou ausentes na exibição), se houver valores sem correspondência nessa tabela.

**Observação**: selecionar **Todos os registros correspondem** trata os registros como se não existissem valores nulos nos campos usados para o relacionamento. Durante a análise, o Tableau usa uniões de colunas internas para obter os valores das dimensões de uma medida. Por padrão, o Tableau nunca une colunas de chaves nulas.

Para obter mais informações sobre Integridade de Cardinalidade e Referencial como conceitos, consulte [Integridade de Cardinalidade e Referencial](https://help.tableau.com/current/pro/desktop/pt-br/cardinality_and_ri.htm).

## Para onde foram as uniões de colunas?

Você ainda pode especificar as uniões de colunas entre tabelas na camada física de uma fonte de dados. Clique duas vezes em uma tabela lógica para acessar a tela de união de colunas.

Cada tabela lógica de nível superior contém pelo menos uma tabela física. Abra uma tabela lógica para exibir, editar ou criar uniões de colunas entre as tabelas físicas. Clique com o botão direito do mouse em uma tabela lógica e, em seguida, clique em Abrir. Ou basta clicar duas vezes na tabela para abri-la.

![Modelo de dados com duas uniões.](/tableau/current/pt-br/server/pt-br/Img/data_model_singletable_joins.gif)

Quando você cria uma fonte de dados, ela tem duas camadas. A camada de nível superior é a camada lógica da fonte de dados. Você combina os dados entre tabelas na camada lógica usando as relações.

A próxima camada é a camada física da fonte de dados. Você combina os dados entre tabelas na camada física usando as uniões de colunas. Para obter mais informações, consulte [Tabelas lógicas e físicas no modelo de dados](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel.htm#dm_log_phys).

![Um diagrama de modelo de dados exibe uma camada lógica com duas tabelas vinculadas por uma relação, e uma camada física que ilustra como as tabelas lógicas são construídas a partir de tabelas físicas.](/tableau/current/pt-br/server/pt-br/Img/data_model_layers_sm.png)

## Dicas sobre o uso das opções de desempenho

Se você conhece o formato dos dados, pode usar as configurações opcionais em Opções de desempenho para estabelecer a cardinalidade das tabelas entre si (um para um, um para muitos, muitos para muitos) e indicar a integridade referencial (os valores de uma tabela sempre terão correspondência na outra tabela).

Em vez de pensar nas configurações em Opções de desempenho como “sim” e “não”, pense nelas como “sim” e “não sei”. Se você tiver certeza de que os valores de uma tabela são únicos, selecione **Um**. Se você tiver certeza de que cada registro em uma tabela corresponde a um ou mais registros na outra tabela, selecione **Todos os registros correspondem**. Caso contrário, deixe as configurações padrão como estão.

Se você não tiver certeza sobre o formato dos dados, use as configurações padrão. Quando o Tableau não pode detectar essas configurações nos dados, as configurações padrão são:

- Cardinalidade: muitos para muitos
- Integridade referencial: alguns registros correspondem

Se o Tableau detectar relações de chave ou integridade referencial nos dados, essas configurações serão usadas e indicadas como “detectadas”.

Para reaplicar as configurações padrão, clique em Reverter para o padrão.

### Termos definidos

_A cardinalidade_ refere-se à singularidade dos dados contidos em um campo (coluna) ou combinação de campos. Quando as tabelas que você deseja analisar contêm muitas linhas de dados, as consultas podem ficar lentas (e o desempenho da fonte de dados global é afetado), portanto, recomendamos escolher um método de combinação de dados com base na cardinalidade das colunas relacionadas entre as tabelas.

- Baixa cardinalidade: quando as colunas relacionadas possuem muitos dados repetidos. Por exemplo, uma tabela chamada Produtos pode conter uma coluna categoria que contém três valores: Móveis, Suprimentos de escritório e Tecnologia.
- Alta cardinalidade: quando as colunas relacionadas possuem dados altamente exclusivos. Por exemplo, uma tabela chamada Pedidos pode conter uma coluna ID do pedido com um valor exclusivo para cada assinante.

_Integridade referencial_ significa que uma tabela sempre terá uma linha correspondente na outra tabela. Por exemplo, uma tabela Vendas sempre terá uma linha correspondente na tabela Catálogo de produtos.

<!-- document id=6f4defdeadc9abec7c410e5ca20bfc613c74f715941a2be39dd9861c677d108a url=/tableau/current/pt-br/server/ask_data_optimize.md -->

[Pular para o conteúdo principal](#main-content)

# Otimizar dados para o Pergunte aos dados (Ask Data)

**Mudanças importantes chegando para Pergunte aos dados e Métricas**

Os recursos Pergunte aos dados e Métricas do Tableau serão descontinuados no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau AI e o Tableau Pulse estão reinventando a experiência com dados.](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-gpt)

Caso você gerencie e publique fontes de dados, aqui estão algumas dicas para facilitar o êxito de usuários do Pergunte aos dados (Ask Data). Ao gastar um tempo extra nesse processo, você abrirá a análise de dados para uma gama mais ampla de pessoas em sua empresa, ajudando-os a responder perguntas independentemente e obter mais informações.

## Otimizar dados em Pergunte aos dados

No painel de dados à esquerda da interface Pergunte aos dados, os proprietários da fonte de dados podem adicionar sinônimos para campos e excluir valores irrelevantes.

### Alterar as configurações no nível de fonte de dados ou ampliação

Ao alterar as configurações no painel de dados para Pergunte aos dados, preste muita atenção se você está no nível de fonte de dados ou ampliação. (Para obter mais informações, consulte [Criar ampliações que concentram Pergunte aos dados a públicos específicos](https://help.tableau.com/current/pro/desktop/pt-br/ask_data_lenses.htm).)

- No nível da fonte de dados, você verá o ícone de fonte de dados cilíndrico no canto superior esquerdo. Aqui, as alterações feitas no painel Dados serão aplicadas por padrão a todas ampliações criadas posteriormente.
    
    **Observação:** para extrações, dois cilindros aparecerão.
    
    ![Painel da Superloja com o ícone da fonte de dados destacado.](/tableau/current/pt-br/server/pt-br/Img/ask_data_edit_data_source.png)
- Para uma ampliação individual, você verá o ícone de aspas no canto superior esquerdo. Aqui, as alterações feitas no painel de dados serão aplicadas apenas a esta ampliação.
    
    ![Painel da Superloja com o ícone de ampliação de dados destacado.](/tableau/current/pt-br/server/pt-br/Img/ask_data_edit_data_lens.png)

### Adicionar sinônimos para nomes de campo e valores

As pessoas podem não usar a mesma terminologia encontrada em suas fontes de dados, por isso os proprietários da fonte de dados e os administradores do Tableau podem [adicionar sinônimos para nomes e valores de campos de dados específicos](https://help.tableau.com/current/pro/desktop/pt-br/ask_data_synonyms.htm). Os sinônimos inseridos ficam disponíveis em toda a sua empresa, tornando a análise de dados mais rápida e fácil para todos.

### Excluir valores de campos específicos de resultados da pesquisa

Para melhorar os resultados da pesquisa no Pergunte aos dados, você pode excluir os valores de campos específicos da indexação. Embora o Pergunte aos dados não adicione valores não indexados aos resultados da pesquisa, os valores ainda aparecem nos resultados de visualização quando relevantes. Por exemplo, se você não indexar valores de um campo “Produto” porque eles adicionam detalhes desnecessários aos resultados da pesquisa, o Pergunte aos dados ainda pode exibir valores como "iPhone 12" em visualizações de dados resultantes. E os usuários podem adicionar manualmente valores não indexados às consultas colocando-os entre aspas (por exemplo, “Vendas para produtos contendo ‘iPhone 12’”).

**Observação:** esta configuração de nível de campo é ignorada se [a configuração de indexação de valor para a fonte de dados](https://help.tableau.com/current/pro/desktop/pt-br/ask_data_enable.htm#Indexing) for definida como Desativada. Nomes de campo e sinônimos relacionados são sempre indexados.

1. Vá para a guia Pergunte aos dados para obter uma fonte de dados ou ampliação individual.
2. Passe o cursor do mouse sobre um campo de fonte de dados à esquerda, e clique no ícone Editar detalhes de campo (o lápis).
    
    ![Uma lista de campos com o ícone de edição ao lado de um valor.](/tableau/current/pt-br/server/pt-br/Img/ask_data_synonyms.png)
3. Desmarque Indexar valores de campo.

Clique na caixa de texto que aparece para reindexar a fonte de dados agora ou deixe-a reindexar com base em seu cronograma regular de indexação.

## Otimizar fontes de dados

Para criar a melhor experiência para usuários de Pergunte aos dados, otimize a fonte de dados original.

**Observação:**o Pergunte aos dados não aceita fontes de dados multidimensionais do cubo ou fontes de dados não relacionais, como o Google Analytics ou fontes de dados com uma conexão virtual.

### Otimizar indexação para o Pergunte aos dados

Os proprietários da fonte de dados podem alterar a frequência de indexação dos valores de campo para Pergunte aos dados, otimizando o desempenho do sistema.

1. Na parte superior de uma página Fonte de dados, clique no ícone Detalhes:
    
    ![O nome da fonte de dados Indicadores mundiais é exibido com o ícone de informações destacado.](/tableau/current/pt-br/server/pt-br/Img/ask_data_datasource_details.png)
2. Na seção Pergunte aos dados (Ask Data), clique em Editar.
3. Escolha uma opção de indexação para valores de campo:
    
    - Automática verifica por alterações a cada 24 horas e analisa a fonte de dados se ela estiver ativa, tiver uma extração atualizada ou tiver sido republicada. Escolha essa opção para uma fonte de dados usada frequentemente com o Pergunte aos dados (Ask Data), para que ela esteja pronta antes que os usuários a consultem.
    - Manual analisa a fonte de dados apenas quando os criadores do Tableau acionam manualmente a indexação na página da fonte de dados. Escolha essa opção se a fonte de dados for alterada com frequência, mas os usuários a consultam com o Pergunte aos dados apenas ocasionalmente.
        
        Para acionar a indexação manual, vá para a página da fonte de dados, clique no “i” circulado no painel de dados à esquerda e clique em Reindexar fonte de dados.
        
        ![A seção Dados indexados mostra a data e a hora em que os dados foram indexados pela última vez e fornece um botão para reindexar a fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/ask_data_reindex.png)
    - Desabilitada analisa somente os nomes de campo, não os valores.
4. Clique em Salvar

### Use extrações de dados para ter um desempenho mais rápido

Para melhorar o desempenho e o suporte para grandes conjuntos de dados, use o Pergunte aos dados com extrações publicadas em vez de fontes de dados em tempo real. Para obter mais informações, consulte [Criar uma extração](https://help.tableau.com/current/pro/desktop/pt-br/extracting_data.htm).

### Garantir que usuários possam acessar a fonte de dados

Para usar o Pergunte aos dados, os usuários devem ter permissão para se conectar à fonte de dados individual. Se uma fonte de dados tiver permissões a nível de linha, essas permissões também se aplicam ao Pergunte aos dados (Ask Data), que não reconhecerá valores seguros ou fará recomendações estatísticas relacionadas.

### Esteja ciente dos recursos de origem de dados não compatíveis

O serviço Pergunte aos dados é compatível com todos os recursos da fonte de dados, exceto os a seguir. Se sua fonte de dados contiver isso, os usuários do Pergunte aos dados não poderão consultar campos relacionados.

- Conjuntos
- Campos combinados
- Parâmetros

### Antecipar perguntas de usuários

Antecipe os tipos de perguntas que seus usuários farão, em seguida otimize sua fonte de dados para essas perguntas usando estas técnicas:

- Limpe e formate dados no [Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_clean.htm) ou em ferramenta semelhante.
- [Una dados](https://help.tableau.com/current/pro/desktop/pt-br/joining_tables.htm) para incluir todos os campos que os usuários podem ter dúvidas em uma tabela, aprimorando o desempenho.
- Adicione [campos calculados](https://help.tableau.com/current/pro/desktop/pt-br/calculations_calculatedfields.htm) que respondem a perguntas usuais de usuários.
- Crie [compartimentos com tamanhos adequados](https://help.tableau.com/current/pro/desktop/pt-br/calculations_bins.htm) para variáveis quantitativas que os usuários podem querer ver como um histograma ou em outra forma de compartimento.

### Simplificar os dados

Para facilitar o entendimento dos dados tanto pelos usuários quanto pelo Pergunte aos dados (Ask Data), simplifique a fonte de dados o máximo possível durante o processo de preparação de dados.

1. Remova os campos desnecessários para melhorar o desempenho.
2. Dê a cada campo um nome exclusivo e significativo.
    - Por exemplo, se houver cinco nomes de campo que começam com “Vendas …”, é melhor diferenciá-los para que o Pergunte aos dados (Ask Data) interprete adequadamente o termo “vendas”.
    - Renomeie os “Número de registros” por algo mais significativo. Por exemplo, use “Número de terremotos” em uma fonte de dados em que cada registro for um terremoto.
    - Evite nomes de campo que sejam números, datas ou valores boolianos (“true” ou “false”).
    - Evite nomes que lembram expressões analíticas, como “Vendas em 2015” ou “Média de produtos vendidos”.
3. Crie [aliases significativos para valores de campo](https://help.tableau.com/current/pro/desktop/pt-br/datafields_fieldproperties_aliases_ex1editing.htm), refletindo termos que as pessoas usariam em um diálogo.

### Definir padrões de campo adequados

Para auxiliar o Pergunte aos dados (Ask Data) a analisar dados corretamente, certifique-se de que as configurações de campo padrão refletem o conteúdo de cada campo.

- [Defina tipos de dados](https://help.tableau.com/current/pro/desktop/pt-br/datafields_typesandroles_datatypes.htm) para valores de texto, hora, data, geográfico, entre outros.
- [Atribua a função de dados adequada](https://help.tableau.com/current/pro/desktop/pt-br/datafields_typesandroles.htm): dimensão ou medida, contínua ou discreta.
- Para cada medida, [atribua configurações padrão apropriadas](https://help.tableau.com/current/pro/desktop/pt-br/datafields_fieldproperties.htm) no Tableau Desktop, como cor, ordem de classificação, formato de número (porcentagem, moeda, etc.) e função de agregação. Por exemplo, SOMA pode ser apropriada para “Vendas”, mas MÉDIA pode ser um padrão melhor para “Pontuação de teste”.
    
    **Dica:** é particularmente útil definir um comentário padrão para cada campo, pois esses comentários são exibidos como descrições informativas quando os usuários passam o mouse sobre os campos no Pergunte aos dados (Ask Data).

### Criar hierarquias para campos geográficos e categorizados

Para dados de hora, o Tableau cria automaticamente hierarquias que permitem que os usuários detalhem as visualizações rapidamente (por exemplo, de dia para semana, de semana para mês). No entanto, para dados geográficos e categorizados, é recomendável [criar hierarquias personalizadas](https://help.tableau.com/current/pro/desktop/pt-br/qs_hierarchies.htm) para ajudar o Pergunte aos dados (Ask Data) a produzir visualizações que reflitam as relações entre os campos. Lembre-se de que o Pergunte aos dados (Ask Data) não mostrará as hierarquias no painel Dados.

O Pergunte aos dados (Ask Data) não indexa nomes de hierarquia, apenas nomes de campos dentro de hierarquias. Por exemplo, se uma hierarquia geográfica denominada "Local" contiver os campos “País” e “Cidade”, os usuários deverão inserir “País” e “Cidade” em suas perguntas para o Pergunte aos dados (Ask Data).

<!-- document id=d0346fefbd90d300064790a0cbeab404913a9d17fdc222edc9b2e8ca7e4efc1b url=/tableau/current/pt-br/server/perf_tuning_long_queries_for_extracts.md -->

[Pular para o conteúdo principal](#main-content)

# Otimizar para ambientes - com muitas consultas de extração

O tópico fornece orientações sobre como configurar uma topologia e configurações específicas do Tableau Server para ajudar a otimizar e melhorar o desempenho em um ambiente com muitas consultas de extração.

**O que é um ambiente com muitas consultas de extração?** Extrações e fontes de dados federadas são consultadas durante o carregamento de pastas de trabalho, exibições e painéis, criando muita carga de trabalho de consulta. Portanto, se você tiver muitas extrações e fontes de dados federadas, pode-se dizer que tem um “ambiente com muitas consultas de extração”.

Se o seu ambiente tiver muitas consultas de extração conforme definido acima, as próximas seções podem ajudar você a decidir se esta configuração é a certa para você.

## Quando usar esta configuração

**Raciocínio principal por trás dessa configuração:** Hyper é a tecnologia de Processador de dados otimizada para memória do Tableau, adequada para processamento analítico e ingestão rápida de dados, tornando-o a chave para otimizar cargas de trabalho com muitas consultas. Conforme o uso de extração aumenta, recomendamos **configurar o Processador de dados em nós dedicados do cluster do Tableau Server** . Essa configuração permite que o Tableau Server dimensione horizontalmente a infraestrutura para otimizar o desempenho ao consultar extrações.

Existem vários fatores que afetam o desempenho do Tableau Server ao exibir conteúdo usando extrações e fontes de dados federadas. O objetivo aqui é **obter um desempenho de consulta consistente e confiável** ao visualizar o conteúdo no servidor. Use esta configuração, se uma das seguintes condições se aplicar ao seu ambiente:

- Você está vendo uma grande variabilidade nos tempos de carregamento da pasta de trabalho, e a pasta de trabalho usa extrações ou fontes de dados federadas.
- A implantação do Tableau Server está crescendo em número de criadores, exploradores, visualizadores e conteúdo baseado em extração, então você deseja dimensionar com eficiência.
- Você está vendo disputa por recursos entre o Processador de Dados e o VizQL Server quando o Armazenamento de arquivo é apresentado na máquina.
- Você analisa grandes quantidades de dados. Essa configuração ajuda a otimizar o desempenho em cenários de big data, tanto na ingestão quanto na análise de dados. Para saber mais sobre o Tableau e big data, consulte [Análise de big data de carga Hyper usando o Tableau](https://www.tableau.com/learn/whitepapers/hyper-charge-big-data-analytics-using-tableau) .

**Observação:** use o registro de desempenho do Server para determinar os tempos de execução de consultas. Para determinar o uso de recurso do Tableau use o **Monitor de desempenho** para instalações do Windows ou as ferramentas _sysstat_ ou _vmstat_ para instalações do Linux.

### Benefícios de usar esta configuração

Estes são os principais benefícios para configurar nós dedicados para o Processador de dados:

- Os nós dedicados do Processador de dados reduzirão a contenção de recursos entre as consultas de extração e outras cargas de trabalho que consomem muitos recursos, como as processadas pelo VizQL Server.
- As consultas de extração têm carga balanceada dinamicamente nos nós dedicados, levando em consideração o estado atual do sistema para garantir que nenhum nó seja super ou subutilizado.
- Desempenho mais consistente na experiência do usuário ao carregar pastas de trabalho dependentes de extração. O foco aqui é estabelecer um desempenho consistente e confiável, em vez de melhorar as consultas individuais.
- Você tem mais controle sobre a expansão dos processos do Tableau Server que precisam de mais recursos. Se VizQL Server, Processador de dados e Processador em segundo plano estiverem todos em execução no mesmo nó e as consultas de extração lentas forem o problema, será difícil ver melhorias de desempenho adicionando um segundo nó com todos os três processos. Com essa configuração, você pode adicionar mais nós que irão melhorar especificamente as cargas de trabalho de consulta de extração.
- Ajuda a melhorar a disponibilidade e o tempo de atividade. No caso de uma falha e um dos nós dedicados do Processador de dados não estiver disponível, o VizQL Server tentará rotear as solicitações pendentes no nó do problema para outros nós dedicados do Processador de dados.
- O Processador de dados aproveita maior quantidade de núcleos disponíveis na máquina. Diante desse quadro, você tem flexibilidade para adicionais mais recursos aos nós dedicados do Processador de dados para reduzir o tempo de resposta da consulta e a variabilidade em consultas de extrações sobrecarregadas ou adicionar mais nós dedicados do Processador de dados para obter mais rendimento da consulta de extração em seu servidor.
- O Data Engine tem uma configuração padrão que o limita a uma média de 75% da CPU por hora. O objetivo é ajudar a evitar conflitos com outros processos do Tableau Server. Se você estiver executando o Data Engine em um nó dedicado, poderá aumentar essa média para 95%. Para obter informações sobre como gerenciar permissões, consulte [hyper.srm\_cpu\_limit\_percentage](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#hyper_cpu_limit_percent).

## Quando não usar esta configuração

- Se você não estiver tendo problemas com a carga de consulta baseada em extração, os recursos de hardware podem ser melhor alocados para outras partes do Tableau Server.
- Em nós onde o Armazenamento de arquivos, o Processador de dados e o VizQL Server coexistem, você não está vendo a contenção de recursos entre o Processador de dados e o VizQL Server.
- Antes de implementar esta configuração, é fortemente recomendado avaliar uso de CPU para o VizQL Server e o nó em que o Processador de dados está instalado com o Armazenamento de arquivo.

## Configuração

O objetivo principal desta configuração é ter o Processador de dados em um ou mais nós dedicados.

- Em implantações onde o Armazenamento de arquivos é instalado localmente, isso significa configurá-lo em um ou mais nós dedicados. O Processador de dados é instalado automaticamente no mesmo nó que o Armazenamento de Arquivos.
- Em implantações em que você está configurando o armazenamento de arquivo externo, ainda pode configurar o Processador de dados em nós dedicados no Tableau Server.

Ao separarmos os processos do VizQL Server e do Armazenamento de arquivo, a carga entre a consulta de extrações e a visualização ou a interação com exibições poderá ser balanceada e melhor gerenciada. Esta configuração tem como objetivo um desempenho consistente ao consultar extrações.

Abaixo está uma representação visual da configuração onde os processos do Processador de dados/Armazenamento de arquivo têm dois nós dedicados, nós 5 e 6. Este é um exemplo em que o armazenamento de arquivos é configurado localmente, por isso os processos do Processador de dados e do armazenamento de arquivos estão co-localizados.

A mesma configuração funciona para implantações com armazenamento de arquivo externo, mas os nós 5 e 6 terão apenas o mecanismo de dados configurado nesse caso.

Além disso, como o Nó 1 também tem os processos Repositório e Armazenamento de arquivo, todos os dados necessários para executar um backup existem no Nó 1, o que pode melhorar o desempenho do backup.

![Uma tabela que exibe os processos em execução em cada nó.](/tableau/current/pt-br/server/pt-br/Img/perf-hoss-arch-basic.png)

## Orientação de Hardware

Para obter o máximo dessa configuração, você precisará experimentar vários tamanhos e configurações de hardware para ver o que melhor se adapta aos seus objetivos de desempenho de carga de pico. Hyper é uma tecnologia de banco de dados de alto desempenho e os principais recursos que afetam o desempenho são memória, núcleos e E/S de armazenamento. Entender como o Hyper usa recursos para processar consultas o ajudará a fazer a seleção de hardware e entender o motivo entre as diferentes configurações.

- **Memória:** quando uma consulta baseada em extração é processada para um usuário ou processo em segundo plano, o Tableau Server seleciona um nó do Processador de dados dedicado para processar a consulta. Esse nó dedicado do Processador de dados irá então copiar a extração do armazenamento local, na maioria das vezes o disco rígido do servidor, para a memória. Ter mais memória de sistema disponível permite que o sistema operacional gerencie melhor o uso de memória para o Tableau. Nós dedicados do Processador de dados usam a memória do sistema para armazenar o conjunto de resultados das consultas executadas. Se o conjunto de resultados ainda for válido, e o sistema operacional não o tiver apagado da memória, o conjunto de resultados na memória pode ser reutilizado.
    
    A recomendação mínima de hardware do Tableau Server é 32 GB de memória, mas se você está esperando um alto volume de cargas de pasta de trabalho com base em extração, deve considerar 64 GB ou 128 GB. Se você estiver atingindo outros limites de recursos além da memória (como núcleos), em vez de expandir para 128 GB de memória, pode ser melhor dimensionar para um nó dedicado do Processador de dados adicional de 64 GB.
    
    O processo de copiar a extração do armazenamento local para a memória pode levar algum tempo e pode ser necessário otimizar o desempenho do disco. A otimização do desempenho do disco é abordada na seção **E/S de armazenamento.**
- **Cores:** ao processar uma consulta baseada em extração, o número de núcleos é um recurso de hardware importante que pode afetar o desempenho e a escalabilidade. Os núcleos da CPU são responsáveis por executar uma consulta e ter mais núcleos disponíveis resultará em um tempo de execução mais rápido. De modo geral, dobrar o número de núcleos reduzirá o tempo de execução da consulta pela metade. Por exemplo, uma consulta de 10 segundos utilizando atualmente 4 núcleos físicos ou 8 vCPUs levará 5 segundos se você atualizar para 8 núcleos físicos ou 16 vCPUs.
    
    A recomendação mínima atual de hardware do Tableau Server é de 8 núcleos, mas se sua implantação utiliza extrações, considere máquinas de 16 ou 32 núcleos. É importante observar que, se a memória e a E/S forem seus gargalos, aumentar os núcleos disponíveis não melhorará o desempenho da consulta.
- **E/S de armazenamento:** o Hyper foi projetado para aproveitar o desempenho disponível de seu dispositivo de armazenamento de extração para acelerar o processamento de consultas. Recomendamos escolher o armazenamento em disco rápido, como unidades de estado sólido (SSD) com altas velocidades de leitura/gravação. Atualmente, os SSDs que utilizam o protocolo de armazenamento NVMe oferecem as velocidades mais rápidas disponíveis.

**Nota:** o dimensionamento de recursos para nós dedicados do Processador de dados afeta apenas o desempenho da consulta de extração. Ao carregar uma pasta de trabalho, há muitos outros processos envolvidos que compõem o tempo total de solicitação de carregamento do VizQL. O processo do VizQL Server, por exemplo, é responsável por pegar os dados do Processador de dados e renderizar a visualização.

## Outros ajustes e otimizações de desempenho:

Existem recursos adicionais que você pode usar para otimizar o desempenho além da configuração básica descrita acima. As otimizações descritas abaixo são aplicáveis às implantações de armazenamento de arquivo local e armazenamento de arquivo externo.

- **Balanceamento de carga de consulta de extração:** para determinar para onde rotear a consulta de extração, o Processador de dados usa uma métrica de integridade do servidor - a quantidade de recursos que o Processador de dados está consumindo e a carga de outros processos do Tableau que podem estar em execução no mesmo nó. Além de avaliar os recursos do sistema, se uma extração já existe na memória do nó também é levado em consideração para garantir que uma consulta de extração seja enviada ao nó que tem mais recursos disponíveis para processar a consulta. Isso resulta em memória e utilização de disco mais eficientes, e as extrações não são duplicadas na memória entre os nós. Consulte o artigo de ajuda [Balanceamento de carga de consulta de extração](https://help.tableau.com/current/server/pt-br/load_balancing_eq.htm) para obter mais detalhes.
    
    _O recurso de balanceamento de carga de consulta de extração é habilitado por padrão no Tableau Server versão 2020.2 e posterior._
- **Otimizações de carga de trabalho usando funções de nó:** Com as funções de nó do Processador em segundo plano e Armazenamento de arquivos, os administradores de servidor têm mais flexibilidade e controle sobre quais nós devem ser dedicados para executar consultas de extração e atualizações de extração. Conforme mencionado no diagrama de topologia acima, determinados nós do Processador de dados são dedicados ao processamento de consultas de extração e executam apenas os processos de Armazenamento de arquivos e Processador de dados. As funções do nó estão disponíveis com Advanced Management. Para obter mais informações sobre as funções de dados, consulte [Gerenciamento de carga de trabalho por meio das funções de nó](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).

O diagrama abaixo usa a mesma topologia que a configuração básica descrita acima, mas com as funções do nó.

![Tabela do balanceador de carga externo com processos e nós.](/tableau/current/pt-br/server/pt-br/Img/perf-hoss-arch-node-roles.png)

- **Função de nó do processador em segundo plano de atualizações de extração:** ao configurar o Nó 3 para a função do nó de Processador em segundo plano de atualizações de extração, somente atualizações incrementais, atualizações completas e trabalhos de criptografia/descriptografia serão executados neste nó. Ao configurar o Nó 4 para a função de nó do processador em segundo plano sem atualizações de extração, todos os trabalhos em segundo plano, exceto atualizações de extração, serão executados neste nó. O Data Server e o Gateway ajudam as tarefas de atualização de extração ao usar extrações federadas e de sombra. Para obter mais informações sobre as funções de nó do Processador em segundo plano, consulte [Funções de nó de armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/server_node_roles.htm#file-store-node-roles).
    
    Além disso, como o Nó 1 também tem os processos Repositório e Armazenamento de arquivo, todos os dados necessários para executar um backup existem no Nó 1, o que pode melhorar o desempenho do backup.
    
    _A função de nó do Processador em segundo plano está disponível com Advanced Management no Tableau Server versão 2019.3 e posterior._
- **Função de nó de Armazenamento de arquivo de consultas de extração:** os nós 5 e 6, que são os nós **dedicados** do Processador de dados, têm a função de nó de Armazenamento de arquivo de consultas de extração para garantir que processem apenas consultas para carregamentos de visualização, assinaturas e alertas controlados por dados.
- **Função de nó de Armazenamento de arquivo interativo de Extrair Consultas**: para nós de Processador de dados dedicados que têm função de nó Armazenamento de arquivos de consultas de extração, os administradores de servidor podem isolar ainda mais as cargas de trabalho interativas e agendadas para execução em nós de Processador de dados **dedicados** específicos. Isso é útil quando há muitos usuários interagindo e carregando pastas de trabalho durante os períodos de assinatura de alto volume. Por exemplo, digamos que haja 1.000 assinaturas programadas para as manhãs de segunda-feira às 8h. Ao mesmo tempo, muitos usuários também carregam painéis no início do dia. O volume combinado de assinaturas e consultas de usuários pode resultar em tempos de carregamento de pasta de trabalho mais lentos e variáveis. Com a função de nó de Armazenamento de arquivo de Extrair consulta interativa, você pode designar nós de Processador de dados dedicados para aceitar apenas consultas para usuários interativos (aqueles que estão olhando para suas telas esperando). Esses nós dedicados do Processador de dados priorizados para cargas de trabalho interativas seriam protegidos do alto volume de trabalhos de assinatura concorrentes e forneceriam tempos de consulta mais consistentes. Além disso, os administradores de servidores podem usar essa função de nó para planejar melhor o crescimento, pois podem adicionar nós de mecanismo de dados dedicados para cargas de trabalho interativas e agendadas de forma independente. Para obter mais informações, consulte [Funções de nó de armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/server_node_roles.htm#file-store-node-roles).
    
    _A função de nó de Armazenamento de arquivo está disponível com Advanced Management no Tableau Server versão 2020.4 e posterior._
- **Otimizações usando armazenamento de arquivo externo**: este recurso permite que você use um compartilhamento de rede como armazenamento para armazenamento de arquivo em vez de usar o disco local em um nó do Tableau Server. Ao ter o armazenamento em um local centralizado, você pode reduzir significativamente a quantidade de tráfego de rede gasta na replicação de dados entre os nós de armazenamento de arquivos. Por exemplo, no caso em que o armazenamento de arquivos está usando um disco local, quando uma extração de 1 GB é atualizada usando o armazenamento de arquivos local, o 1 GB de dados é replicado pela rede para todos os nós que estão executando o processo de armazenamento de arquivos. Quando o Tableau Server está configurado com armazenamento de arquivo externo, a extração de 1 GB só precisa ser copiada para o compartilhamento de rede uma vez e todos os nós de armazenamento de arquivo podem acessar essa única cópia. A centralização do armazenamento também reduz a quantidade total de armazenamento local necessária nos nós de armazenamento de arquivos.
    
    Além disso, os backups do Tableau Server aproveitam a tecnologia de instantâneo para reduzir significativamente o tempo para concluir um backup.
    
    Embora você não precise de uma configuração de nó do Processador de dados dedicado para obter os benefícios do Armazenamento de arquivo externo, os recursos adicionais de gerenciamento de carga de trabalho com a função de nó Armazenamento de arquivo e a função de nó Extrair consulta interativa podem ser usados juntos. Consulte o tópico [Armazenamento de arquivos externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm) do Tableau Server para obter mais detalhes.
    
    _O Armazenamento de arquivo externo está disponível com Advanced Management no Tableau Server versão 2020.1 e posterior._

<!-- document id=9f08899cf8e6f6d6388a9ff6d8f4609a2fc6361a8269d6863c7e787cbc18be17 url=/tableau/current/pt-br/server/perf_optimize_extracts.md -->

[Pular para o conteúdo principal](#main-content)

# Otimizar para extrações

Tente otimizar para extrações se as agendas de extração corresponderem a utilização alta de recursos ou se as extrações demorarem para terminar.

**Observação:** esse tópico usa a pasta de trabalho de desempenho de exemplo da seção de monitoramento. Para obter mais informações, consulte [Analisar os dados com a Pasta de trabalho de desempenho de exemplo](https://help.tableau.com/current/server/pt-br/perf_analyze_sample_workbook.htm).

## Quando otimizar extrações

### O uso elevado da CPU corresponde a agendas de extração

Use o painel Trabalhos em Segundo Plano da pasta de trabalho de desempenho de exemplo para exibir o número de trabalhos em segundo plano executados pelo Tableau Server, incluindo os trabalhos de atualização de extração. O painel também exibe quanto tempo os trabalhos em segundo plano estão atrasados, ou seja, o tempo entre quando um trabalho em segundo plano foi programado e quando ele realmente foi executado. Caso observe grandes atrasos em determinados momentos do dia ou se muitos trabalhos estiverem em execução ao mesmo tempo, experimente distribuir as agendas de trabalho em diferentes momentos do dia para reduzir a carga no servidor.

![Gráfico do número de trabalhos em segundo plano concluídos a cada minuto e o atraso máximo do trabalho em minutos para cada hora.](/tableau/current/pt-br/server/pt-br/Img/perf_workbook_background_jobs.png)

Também compare os tempos em que existam muitos trabalhos em segundo plano ou longos atrasos com o uso da CPU do servidor. Use o painel Uso da CPU para exibir o percentual de uso da CPU total e para cada processo. Como o processo do processador em segundo plano executa trabalhos em segundo plano, o primeiro processo é mostrar a sobrecarga quando houver muitos trabalhos de atualização da extração ou quando esses estiverem lentos. Observe que o uso da CPU do processador em segundo plano processa periodicamente, mas atinge rapidamente 100 por cento. Isso indica que há trabalhos de atualização intensivos em uma agenda recorrente.

**Observação**: o percentual de uso da CPU para processos individuais pode adicionar até mais de 100 por cento, pois a utilização do processador para os processos individuais é medida para um determinado núcleo do processador. Por contraste, o uso total da CPU é medido para todos os núcleos do processador.

![Um gráfico de linhas e cinco gráficos de barras que exibem o uso da CPU por processo ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/perf_workbook_cpu_usage.png)

### Falha na extração ou execução lenta

Use a exibição administrativa [Tarefas em segundo plano para extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd.htm) para determinar quantas extrações falharam e quanto tempo levaram para serem concluídas. Falhas frequentes podem indicar um problema com uma fonte de dados específica.

![O gráfico de séries temporais exibe o número de extrações executadas no servidor nos últimos sete dias, enquanto o gráfico de barras ilustra a contagem diária de extrações bem-sucedidas e com falha.](/tableau/current/pt-br/server/pt-br/Img/adminview_extract.png)

## Formas de otimizar extrações

Quando o uso elevado da CPU corresponder a agendas de atualização de extração, como no exemplo mostrado anteriormente, é necessário otimizar para extrações.

### Ajustar a agenda de atualização da extração

Use o painel Trabalhos em Segundo Plano da pasta de trabalho de desempenho de exemplo para identificar horários ideais para a execução de extrações. Além de executar as extrações em horários fora do pico,distribua as atualizações de extração para minimizar o carregamento concomitante do servidor. Se as atualizações de extração continuarem a causar problemas, reduza a frequência delas o máximo possível, dessa forma:

- Agende as extrações para horários em que o servidor não está ocupado.
- Reduza a frequência das atualizações agendadas.

### Acelerar extrações específicas

Use a exibição administrativa [Tarefas em segundo plano para extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd.htm) para identificar extrações com falhas e com longo tempo de execução.

- Reduza o tamanho das extrações. Ajude a aumentar o desempenho do servidor mantendo o conjunto de dados da extração reduzido, por meio da filtragem ou agregação, e limitado, ocultando campos não utilizados. Para fazer essas alterações, use as opções do Tableau Desktop Ocultar todos os campos não utilizados e Agregar dados para dimensões visíveis. Para obter mais informações, consulte [Criação de uma extração](https://help.tableau.com/current/pro/online/pt-br/extracting_data.htm) na Ajuda do Tableau.
    
    Para obter dicas gerais sobre a criação de pastas de trabalho de bom desempenho, procure "desempenho" na Ajuda do Tableau. Para ver o desempenho das pastas de trabalho depois que elas são publicadas no Tableau Server, crie um registro de desempenho. Para obter mais informações, consulte [Criar um registro de desempenho](https://help.tableau.com/current/server/pt-br/perf_record_create_server.htm).
- Use trabalhos de atualização incremental. Os trabalhos de atualização incremental acrescentam novas linhas a uma extração existente, em vez de criar a extração do zero. Este tipo de atualização de extração é executado rapidamente, pois ele processa apenas os dados que foram adicionados desde a última execução do trabalho de atualização de extração. No entanto, ele não leva em conta os dados que foram atualizados, diferentemente dos anexados a uma fonte de dados. Assim, se executar trabalhos de atualização incremental, será necessário, ocasionalmente, executar uma atualização completa. Como sugestão, é possível executar um trabalho de atualização completa uma ou duas vezes por semana para uma fonte de dados, em vez de todos os dias.

### Configurar o modo de execução para atualizações de extração

Ao criar agendamentos para a atualização de extração, certifique-se de que elas sejam executadas em modo de execução paralela. Ao executar uma agenda em paralelo, ela é executada em todos os processos dos processadores em segundo plano, mesmo que a agenda contenha apenas uma tarefa de atualização. Quando você executa uma agenda de forma serial, ela é executada apenas em um processo de processadores de segundo plano. Por padrão, o modo de execução é definido como paralelo para que as tarefas de atualização sejam concluídas tão rápido quanto possível.

No entanto, em algumas circunstâncias, pode fazer sentido definir o modo de execução como serial. Como, por exemplo, quando um trabalho muito grande estiver impedindo outras agendas de serem executadas, porque ele está usando todos os processos disponíveis do processador em segundo plano.

### Aumentar o número de processos do processador em segundo plano

Um único processo em segundo plano pode consumir 100% de um único núcleo de CPU para determinadas tarefas. Como resultado, o número total de instâncias que devem ser executadas dependerá dos núcleos disponíveis no computador. Se o Tableau Server estiver instalado em um cluster e executar processos do processador em segundo plano em um nó separado, uma dica é definir o número de processos do processador em segundo plano entre a metade do número de núcleos e o número total de núcleos do computador que os executa.

Para obter mais informações sobre os processos de configuração, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm).

### Isole os processos

Se tiver o Tableau Server instalado em um cluster, é ainda maior o benefício que resulta de mover os processos do processador em segundo plano para um nó separado, a fim de evitar a disputa por recursos. Isso ocorre porque esses processos utilizam muito a CPU e executá-los no mesmo nó em que outros processos de uso intensivo da CPU estão sendo executados pode tornar o servidor mais lento. Por exemplo, o processo do VizQL Server e o do Processador de Dados pode fazer o uso intensivo da CPU. Leia a configuração de dois nós no tópico [Configurações de linha de base recomendadas](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#two-node) para obter mais detalhes.

<!-- document id=7ac06beada4ac5743e6634c16e911351946a756483e35333cd6ff23ffb5452a2 url=/tableau/current/pt-br/server/perf_optimize_user_traffic.md -->

[Pular para o conteúdo principal](#main-content)

# Otimizar para o tráfego de usuários

É possível otimizar para o tráfego se tiver muitos usuários do Tableau Server ativos e poucas fontes de dados publicadas que precisam de atualizações de extração.

**Observação:** esse tópico usa a pasta de trabalho de desempenho de exemplo da seção de monitoramento. Para obter mais informações, consulte [Analisar os dados com a Pasta de trabalho de desempenho de exemplo](https://help.tableau.com/current/server/pt-br/perf_analyze_sample_workbook.htm).

- [Quando otimizar o tráfego de usuários](#when-to-optimize-for-traffic)
- [Formas de otimizar o tráfego de usuários](#ways-to-optimize-for-traffic)

## Quando otimizar o tráfego de usuários

### Tempo de carregamento lento das exibições

Use o painel Solicitações e Sessões da pasta de trabalho de desempenho de exemplo para analisar o tempo que as exibições levam para carregar.

![Dois gráficos de dispersão ilustram o número de solicitações e sessões ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/perf_workbook_requests_sessions.png)

Se várias exibições demorarem mais do que 10 segundos para carregar e os tempos de carregamento lento corresponderem a um grande número de sessões, isso pode indicar que o tráfego de usuários está tornando o servidor mais devagar.

No entanto, se uma exibição específica levar muito tempo para carregar, independentemente de quando ela é exibida, isso é um sinal de que a pasta de trabalho da exibição precisa ser otimizada. Identifique quais pastas de trabalho precisam ser otimizadas com a exibição administrativa [Estatísticas para tempos de carregamento](https://help.tableau.com/current/server/pt-br/adminview_stats_load_time.htm). Algumas maneiras simples de otimizar as pastas de trabalho incluem mostrar menos informação em cada exibição ou dividir as exibições, reduzir o número de filtros e utilizar as extrações de dados.

### Uso elevado de recursos correspondente ao tráfego de usuários

Se o servidor exibir o uso elevado da CPU e de memória durante o horário de pico do tráfego, otimize o tráfego de usuários. Para determinar o horário de pico do tráfego e analisar quantos usuários simultâneos estão em seu servidor, use o painel Usuários e Ações. Além disso, é possível usar a exibição administrativa [Tráfego para exibições](https://help.tableau.com/current/server/pt-br/adminview_serveract.htm) para ver o tráfego de usuários envolvido no acesso às exibições (em comparação à execução de funções administrativas, publicações ou outras tarefas).

![Dois gráficos de dispersão exibem a atividade do usuário ao longo do tempo, refletindo diversas ações do usuário.](/tableau/current/pt-br/server/pt-br/Img/perf_workbook_users_actions.png)

Ao clicar em um ponto na exibição Número de usuários, o painel mostrará os usuários que estavam ativos no momento e o número de ações de usuário realizadas. Por padrão, as únicas ações de usuário mostradas são as exibições de usuário, mas pode usar o filtro Tipos de ação para mostrar ações de usuário adicionais.

Anote os momentos do dia em que há muitos usuários e exibições simultâneas para comparar tal informação ao uso dos recursos. Como regra geral, o número de usuários deve corresponder a um número elevado de ações de usuário. No entanto, a exibição neste exemplo mostra um número artificialmente elevado de ações para um único usuário, como parte de um teste de geração de carga. Como exemplo, compare o número elevado de exibições às 00:00h do dia 28 de junho com o uso do recurso no painel ilustrado a seguir.

Use o painel Uso da CPU para exibir o percentual de uso da CPU total e para cada processo. No exemplo a seguir, observe o grande aumento no uso total da CPU e no processo do VizQL Server às 00:00h do dia 28 de junho. Como o processo do VizQL Server carrega e renderiza exibições, ele é, muitas vezes, o primeiro processo a mostrar a sobrecarga no tráfego elevado de usuários.

**Observação**: o percentual de uso da CPU para processos individuais podem adicionar até mais de 100%. Isto porque a utilização do processador para os processos individuais é medida para um determinado núcleo do processador. Por contraste, o uso total da CPU é medido para todos os núcleos do processador.

![Um gráfico de linhas e cinco gráficos de barras que exibem o uso da CPU por processo ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/perf_workbook_cpu_usage.png)

Use o painel Uso da Memória para exibir o percentual de uso total da memória e o uso médio da memória em gigabytes. Como regra geral, o uso da memória aumenta constantemente com o tráfego de usuários. Novamente, o processo do VizQL Server é o primeiro a mostrar a sobrecarga no tráfego elevado.

![Dois gráficos que mostram o uso da memória ao longo do tempo. O gráfico superior mostra o uso total de memória, enquanto o gráfico inferior mostra o uso de memória dividido por processo.](/tableau/current/pt-br/server/pt-br/Img/perf_workbook_memory_usage.png)

## Formas de otimizar o tráfego de usuários

Quando o tráfego elevado de usuários corresponde ao uso elevado de recursos, como no exemplo mostrado anteriormente, é necessário otimizar para o tráfego de usuários.

### Ajustar o número de processos do VizQL Server

A maneira mais eficaz de otimizar para o tráfego de usuários é ajustar o número de processos do VizQL Server. Adicione um processo do VizQL Server por vez e meça o efeito com mais monitoramento de desempenho. Como os processos do VizQL Server podem consumir uma muita CPU e memória, a adição de muitos processos pode tornar o servidor mais lento. Se observar um constante uso elevado da memória, tente diminuir o número de processos do VizQL Server para reduzir a quantidade de memória reservada.

Para obter mais informações sobre os processos de configuração, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm).

### Ajustar o número de outros processos

Embora a maneira mais eficaz de melhorar o desempenho para o tráfego de usuários seja ajustar o número de processos do VizQL Server,o usuário tem a opção de ajustar outros processos que sejam compatíveis com o processo do VizQL Server ou que o impeçam de acessar os recursos. Por exemplo, o processo do VizQL Server faz solicitações frequentes para o processo do servidor de cache, então é interessante aumentar o número de processos do servidor de cache. Por outro lado, os processos do processador em segundo plano podem disputar por recursos da CPU com o processo do VizQL Server. Como resultado, caso não precise executar atualizações de extração frequentes, é possível reduzir o número de processos para o processador em segundo plano. Se precisar de instâncias adicionais desse processador em segundo plano e se estiver executando o Tableau Server em um cluster, você poderá mover o processo do processador em segundo plano para um nó dedicado.

### Ajustar o tempo limite da sessão VizQL

No exemplo mostrado anteriormente, a quantidade de memória usada pelo processo do VizQL Server aumenta com o tráfego de usuários e continua reservada pelo Tableau Server por um tempo após a conclusão do tráfego. Isso ocorre porque o processo do VizQL Server reserva a memória de cada sessão por um período específico. Se o processo do VizQL Server usar uma alta porcentagem de memória disponível, tente reduzir o tempo de espera de cada sessão para disponibilizar a memória mais rapidamente. 

Para fazer isso, use o comando `[tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet)` para reduzir a configuração de `vizqlserver.session.expiry.timeout`. O padrão é 30 minutos.

### Atualizar o cache com menos frequência

Se os seus usuários nem sempre precisam dos dados mais recentes, é possível otimizá-los para o tráfego de usuários ao configurar o Tableau Server para armazenar em cache e reutilizar os dados o máximo possível.

Para fazer isso, use o comando `[tsm data-access caching list](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#caching-list)` para confirmar a frequência de atualização. O padrão é `Low`. Use o comando `[tsm data-access caching set](https://help.tableau.com/current/server/pt-br/cli_data-access.htm#caching-set)` para alterar a frequência de atualização.

### Avaliação da capacidade de resposta da exibição

Quando um usuário abre uma exibição, os componentes da exibição são primeiro recuperados e interpretados e, em seguida, exibidos no navegador da web do usuário. Para a maioria das exibições, a fase de renderização ocorre no navegador da web do usuário e, na maior parte dos casos, isso gera os resultados mais rápidos e o mais alto nível de resposta interativa. Lidar com a maioria das interações no navegador da web do cliente reduz a largura de banda e elimina latências de solicitação de ida e volta. Se uma exibição for muito complexa, o Tableau Server manipulará a fase de renderização no servidor, em vez de no navegador da Web do cliente, pois isso geralmente resulta no melhor desempenho. Se você achar que as exibições não respondem conforme você gostaria, poderá testar e alterar o limite que faz com que as exibições sejam renderizadas pelo servidor, em vez de no navegador da web do cliente. Para obter mais informações, consulte [Configurar a renderização do lado do cliente](https://help.tableau.com/current/server/pt-br/browser_rendering.htm).

## Outros artigos nesta seção

<!-- document id=d0aee5c4c66dd3f043f28f74c36413bde5553c8da242485b15fe8a217c45d57c url=/tableau/current/pt-br/server/single_server_install_defaults.md -->

[Pular para o conteúdo principal](#main-content)

# Padrões de instalação do nó inicial

Por padrão, o instalador do Tableau Server configura o número de instâncias de processo que o Tableau Server executa com base no hardware detectado pelo instalador. A configuração padrão se aplica a instalações em servidor único e ao servidor inicial de uma instalação multinodal.

Você pode calcular a configuração padrão com base nas regras a seguir para cada processo, em que o "número de núcleos" refere-se ao número de processadores físicos:

| Nome do processo | Número de processos |
| --- | --- |
| VizQL Server | Igual ao número de núcleos dividido por quatro, até o máximo de quatro instâncias de processo. |
| Processador em segundo plano | Definido como dois, a não ser que o número de núcleos seja inferior a oito. |
| Servidor de cache | Definido como dois, a não ser que o número de núcleos seja inferior a oito. |
| Servidor de dados | Definido como dois, a não ser que o número de núcleos seja inferior a oito. |

Para todos os outros tipos de processos, o número de instâncias de processo é definido como um, independentemente do hardware.

Esta é uma configuração padrão de exemplo para um computador com 16 núcleos:

| Nome do processo | Número de processos |
| --- | --- |
| VizQL Server | 4 |
| Servidor de aplicativos | 1 |
| Processador em segundo plano | 2 |
| Servidor de cache | 2 |
| Servidor de dados | 2 |
| Armazenamento de arquivo | 1 |
| Processador de Dados | 1 |

<!-- document id=87e9515dc474f0d5f7b2eb2905489304b651fd6b553bcf73a63cc1b48d9e431d url=/tableau/current/pt-br/server/ipa_server_quick_help_home.md -->

[Pular para o conteúdo principal](#main-content)

- [Introdução](https://help.tableau.com/current/server/pt-br/admin.htm)

![Adicionar descrição da imagem](/tableau/current/pt-br/server/pt-br/Img/getstarted_36px_43x43.png) Saiba o que o Tableau Server pode fazer

- [Ajuda rápida](https://help.tableau.com/current/server/pt-br/ipa_vconn_start.htm)

![Adicionar descrição da imagem](/tableau/current/pt-br/server/pt-br/Img/producthelp_36px.png) Obtenha ajuda com o que você está fazendo agora

- [Destaques do lançamento](https://help.tableau.com/current/server/pt-br/ipa_server_whats_new.htm)

![Adicionar descrição da imagem](/tableau/current/pt-br/server/pt-br/Img/whatsnew_36px.png) Saiba o que há de novo no Tableau Server

- [Treinamento](https://trailhead.salesforce.com/en/search?keywords=tableau+server)

![Adicionar descrição da imagem](/tableau/current/pt-br/server/pt-br/Img/training_36px.png) Vídeo de treinamento e tutoriais

- [Solução de](https://help.tableau.com/current/server/pt-br/trouble.htm)

![Adicionar descrição da imagem](/tableau/current/pt-br/server/pt-br/Img/troubleshoot_36px.png) Artigos de solução de problemas e suporte

## Outros artigos nesta seção

<!-- document id=55c1640075c22fc2c1341a006835959defb8cf3178f57b822dc55d79aaa10ff0 url=/tableau/current/pt-br/server/rmt-activity-charts.md -->

[Pular para o conteúdo principal](#main-content)

# Páginas de atividade da Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau inclui painéis que ajudam a monitorar e analisar várias métricas de desempenho, como uso de recursos de hardware, atividade do usuário e status dos processos do Tableau Server. Eles podem ser úteis para identificar gargalos de desempenho e a integridade geral do Tableau Server.

Este tópico descreve as informações na página **Atividade**. A página de atividades fornece o próximo nível de detalhe para o que é visto nos gráficos da página **Desempenho.** As seleções de filtro em qualquer um desses painéis são transportadas para o outro, para que você possa ver as informações correspondentes enquanto tenta identificar quaisquer problemas de desempenho.

A página de atividades inclui informações detalhadas sobre o seguinte:

- Sessões VizQL
- Tarefas em segundo plano
- Consultas de dados
- Carregamentos de exibição
- Exibições mais lentas

![Guia de atividade da Resource Monitoring Tool do Tableau.](/tableau/current/pt-br/server/pt-br/Img/rmt-activity-tabs.png)

## Sessões VizQL

Mostra uma lista de todas as sessões VizQL no intervalo de tempo selecionado. Uma sessão VizQL é um conjunto de interações que um usuário tem com uma pasta de trabalho no Tableau Server.

Clique em uma ID de sessão para ver um gráfico de resumo e mais detalhes, como as solicitações feitas durante a sessão, a duração da solicitação e as sessões de pasta de trabalho relacionadas. Você também pode ver quaisquer consultas de dados relacionadas, incidentes que foram relatados e a atividade do ambiente filtrada para o mesmo período da sessão VizQL.

## Tarefas em segundo plano

Mostra uma lista de todas as tarefas de segundo plano no intervalo de tempo selecionado.

Clique na hora de início da tarefa para ver mais detalhes sobre a tarefa em segundo plano, incluindo um resumo que mostra uma comparação entre o tempo que levou para concluir a tarefa e a duração média de tempo para concluir tarefas semelhantes. Você também pode ver quaisquer incidentes relacionados que foram relatados e a atividade geral do ambiente durante o tempo em que esta tarefa foi executada.

Clique no nome do site para ver mais informações sobre ele, incluindo o número de pastas de trabalho, exibições e sessões VizQL para cada projeto nesse site.

## Consultas de dados

Mostra uma lista de todas as consultas de dados durante o intervalo de tempo selecionado.

Clique em uma consulta para ver os detalhes de desempenho da consulta, o texto completo da consulta e os detalhes da conexão.

## Carregamentos de exibição

Mostra a lista de visualizações renderizadas no intervalo de tempo selecionado.

O filtro **Categoria de gravidade de tempo de carregamento** permite filtrar as exibições que estão demorando muito mais para carregar do que o normalmente esperado. Isso usa o mesmo conceito de linha de base e comparações usadas no Gráfico de **Solicitação de carregamento de exibição lenta.** A linha de base é estabelecida calculando o valor médio das primeiras 10 vezes que uma pasta de trabalho específica é renderizada. Quando uma linha de base é estabelecida, toda vez que a mesma pasta de trabalho é renderizada no futuro, o tempo gasto para carregá-la é então comparado à própria linha de base.

As categorias para a gravidade do tempo de carregamento são as seguintes:

- **Normal:** <= 2x a linha de base
- **Longo:** > = 2x a linha de base
- **Muito longo:** >= 4x a linha de base
- **Falha:** falha ao carregar ou resultou em erro
- **Processando:** o cálculo da linha de base está em andamento e ainda não foi estabelecido.

## Exibições lentas

Mostra a lista de todas as exibições que demoraram mais tempo em ordem decrescente. Essa lista é baseada no tempo médio de duração do carregamento, em vez de uma comparação com uma linha de base. Você pode restringir essa lista filtrando por duração, editor, site ou uma exibição específica.

- Clique na exibição para ver mais detalhes sobre os tempos de carregamento. Você também pode ver quaisquer incidentes relacionados que foram relatados e a atividade geral do ambiente durante o tempo em que esta tarefa foi executada.
- Clique na pasta de trabalho para ver mais detalhes sobre uma pasta de trabalho específica.

## Quem pode fazer isso

Qualquer usuário da Resource Monitoring Tool pode visualizar os gráficos.

## Tópicos relacionados

- [Monitore o desempenho do Tableau Server com a Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-charts.htm)
- [Gráficos de desempenho da Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-performance-charts.htm)
- [Páginas de conteúdo da Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-content-pages.htm)

<!-- document id=1db6731bbdda963b49f3e821fb807445cd8e124348d2274f02d3948a249a4f17 url=/tableau/current/pt-br/server/rmt-content-pages.md -->

[Pular para o conteúdo principal](#main-content)

# Páginas de conteúdo da Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau inclui painéis que ajudam a monitorar e analisar várias métricas de desempenho, como uso de recursos de hardware, atividade do usuário e status dos processos do Tableau Server. Eles podem ser úteis para identificar gargalos de desempenho e a integridade geral do Tableau Server.

Este tópico descreve as informações nos gráficos da página **Conteúdo.** Esta página é a forma principal de ver os detalhes de um item de conteúdo específico. É um lugar útil para começar quando você precisa investigar o desempenho de uma pasta de trabalho ou exibição específica.

A página de conteúdo inclui informações detalhadas sobre o seguinte:

- Sites do Tableau
- Projetos em cada site do Tableau
- Pastas de trabalho
- Exibições

Você pode ver as métricas de desempenho para as sessões VizQL, consultas de dados relacionadas a um projeto, pasta de trabalho ou uma exibição. Também é possível ver quaisquer incidentes relacionados específicos a pastas de trabalho ou exibições.

![Menu de contexto da Resource Monitoring Tool do Tableau.](/tableau/current/pt-br/server/pt-br/Img/rmt-content-page-tabs.png)

## Sites

Mostra uma lista de sites em seu ambiente do Tableau Server, incluindo o número total de projetos, pastas de trabalho e sessões VizQL.

## Projetos

Mostra uma lista de todos os projetos em um site. Clique no projeto para ver uma lista de todas as pastas de trabalho, exibições e sessões VizQL relacionadas e consultas de dados.

## Pastas de trabalho

Mostra uma lista de todas as pastas de trabalho em um site. Clique em uma pasta de trabalho para ver os tempos de carregamento, informações da sessão VizQL, consultas de dados relacionadas e quaisquer incidentes relatados específicos a esta pasta de trabalho.

## Exibições

Mostra uma lista de todas as exibições em um site. Clique na exibição para ver os tempos de carregamento dela, informações da sessão VizQL, consultas de dados relacionadas e quaisquer incidentes relatados específicos para a exibição.

## Quem pode fazer isso

Qualquer usuário da Resource Monitoring Tool pode visualizar os gráficos.

## Tópicos relacionados

- [Monitore o desempenho do Tableau Server com a Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-charts.htm)
- [Gráficos de desempenho da Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-performance-charts.htm)
- [Páginas de atividade da Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-activity-charts.htm)

<!-- document id=d825762ed50aceafa07c62fe0637f563a15e029e1c738220ca06b6edb5a54b9c url=/tableau/current/pt-br/server/adminview-backgrounder-dashboard.md -->

[Pular para o conteúdo principal](#main-content)

# Painel do processador em segundo plano

A exibição **Painel do processador em segundo plano** é uma visão geral dos trabalhos em segundo plano. Usando essa exibição, você pode encontrar mais informações sobre:

- O tempo de execução dos trabalhos.
- Quando o processador em segundo plano está ocupado ou sobrecarregado.
- Trabalhos que foram concluídos com sucesso, que apresentaram falha ou que foram cancelados.

Observação: esta exibição não inclui trabalhos de execução de fluxo.

> [!IMPORTANT]
> 
> Nas versões anteriores do Tableau Server, as exibições administrativas eram exibidas na mesma pasta de trabalho, em guias separadas. No entanto, as duas novas exibições administrativas são exibidas como pastas de trabalho separadas e não fazem parte da pasta de trabalho da exibição administrativa existente. Navegue até as novas exibições administrativas da página Servidor ou Status do site:  
> ![Página de status do site no Tableau Cloud com uma lista de opções de status do site, incluindo painel de informações básicas, estatísticas de conteúdo não utilizado e uso de licença baseado em login.](/tableau/current/pt-br/server/pt-br/Img/new-admin-views-nav.png)

## Resumo e filtros

![Um painel inclui um gráfico de linhas de série temporal da duração de cada tarefa do processador de segundo plano nos últimos 31 dias, complementado por um segundo gráfico exibindo um histograma dos tempos totais de execução da tarefa.](/tableau/current/pt-br/server/pt-br/Img/admin-view-backgrounder-dashboard.png)

**A** - Na parte superior, há um gráfico de resumo que informa o número de trabalhos que foram realizados com sucesso, que apresentaram falha ou que foram cancelados. Você pode clicar nas seções do gráfico de barras para filtrar as informações por status de trabalho. Este filtro é aplicado a toda a exibição e as informações mostradas incluem apenas os trabalhos com o status de trabalho selecionado.

**B** - Você pode encontrar outras opções de filtro clicando no ícone de filtro. O painel Filtro será exibido e permitirá filtrar por **Tipo de tarefa**, **Trabalho executado em**, **Site**, **Projeto**, **Proprietário do conteúdo**, **Agenda** e **ID do processador em segundo plano**. A ID de processador em segundo plano é exclusiva para um processo do Processador em segundo plano. Você pode usá-la para ver as informações sobre o trabalho realizado por cada processo do Processador em segundo plano. Ao selecionar um ou mais desses filtros, eles são aplicados a toda a exibição.

![Uma caixa de diálogo Filtros do painel.](/tableau/current/pt-br/server/pt-br/Img/admin-view-backgrounder-dashboard-filters.png)

## Detalhes

O Painel do processador em segundo plano tem quatro seções e cada uma mostra informações diferentes sobre os trabalhos. Cada uma dessas seções tem mais filtros no menu suspenso que podem ser aplicados a essa seção específica.

1. **A seção na parte superior esquerda** fornece as informações sobre os trabalhos com o status de trabalho selecionado ou os filtros selecionados usando o painel Filtro. Se nenhuma opção for selecionada, todos os trabalhos serão incluídos.
    
    As informações exibidas também variam de acordo com a seleção por meio do menu suspenso:
    
    1. **Tempo total de execução**: mostra o tempo total de execução de todos os trabalhos com o status de trabalho selecionado e os outros filtros selecionados.
        
        Por exemplo, se você selecionou Status de trabalho: falha e Tipo de tarefa: assinaturas, o gráfico mostrará todos os trabalhos de assinatura que apresentaram falha.
    2. **Número de trabalhos**: mostra o número de trabalhos executados para o status de trabalho selecionado e outros filtros selecionados.
    3. **Atraso máximo**: mostra quanto tempo os trabalhos ficaram em fila antes da execução.
    
    ![Um gráfico de linhas que exibe o atraso máximo de trabalhos ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/admin-view-backgrounder-dashboard-top-left-section.png)
2. **A seção na parte superior direita** informa se o Processador em segundo plano está ocupado ou sobrecarregado em determinado dia e hora. No entanto, as informações exibidas dependem das seleções de filtro para o status de trabalho e outras opções no painel Filtro.
    
    ![Um mapa de variação que representa visualmente o tempo que cada tarefa leva para ser executada ao longo da semana.](/tableau/current/pt-br/server/pt-br/Img/admin-view-backgrounder-dashboard-top-right-section.png)
    
    Se você clicar no ícone de informações na parte superior direita dessa seção, uma legenda da cor será exibida.
    
    - As variações na cor azul estão correlacionadas ao número de trabalhos em execução nesse período. Quanto mais escuro o azul, mais trabalhos estão sendo executados.
    - As variações na cor laranja estão correlacionadas ao tempo em fila. Quanto mais escuro o laranja, maior o tempo em fila.
    - Usando ambas as métricas, é possível identificar quando o processador em segundo plano está ocupado (azul escuro) ou sobrecarregado (laranja escuro).
    
    ![Um mapa de cores de duas variáveis que ilustra a correlação entre tempos de fila e trabalhos em segundo plano em execução.](/tableau/current/pt-br/server/pt-br/Img/admin-view-backgrounder-dashboard-info-map.png)
3. **A seção na parte inferior esquerda** fornece as informações do tempo de execução sobre os trabalhos com o status de trabalho selecionado ou os filtros selecionados usando o painel Filtro. Se nenhuma opção for selecionada, todos os trabalhos serão incluídos. Selecione as marcas nas seções superiores para preencher esta seção com detalhes do conteúdo selecionado.
    
    ![Gráfico de barras com tempo total de execução para cada trabalho por título.](/tableau/current/pt-br/server/pt-br/Img/admin-view-backgrounder-dashboard-bottom-left-section.png)
    
    As seleções do menu suspenso fornecem mais opções e as informações exibidas mudam de acordo:
    
    - Quando **Título** é selecionado, são exibidas as informações do tempo de execução para cada trabalho.
    - Quando **Projeto** é selecionado, é exibido o tempo total de execução para cada projeto.
    - Quando **Criador do trabalho** é selecionado, é exibido o tempo total de execução para trabalhos criados por um usuário específico.
    - Quando **Site** é selecionado, é exibido o tempo total de execução para trabalhos nesse site específico.
    - Quando **Agenda** é selecionada, é exibido o tempo total de execução para trabalhos que usam essa agenda específica.
4. **A seção na parte inferior direita** informa o tempo de execução para cada trabalho.
    
    ![Um gráfico de caixa mostrando a distribuição da duração do trabalho por trabalho.](/tableau/current/pt-br/server/pt-br/Img/admin-view-backgrounder-dashboard-botton-right-section.png)

<!-- document id=e665991611d9c25a8bd4e126da9cc0aca2e26ccd7363d0a80c325f0c5b24113c url=/tableau/current/pt-br/server/openid_auth_parameters.md -->

[Pular para o conteúdo principal](#main-content)

# Parâmetros da solicitação de autenticação do OpenID Connect

A solicitação de autenticação do OpenID enviada pelo Tableau Server transmite as informações usando um conjunto limitado de parâmetros, conforme listado neste tópico. Se o seu OpenID IdP exigir parâmetros que não estão na lista a seguir, ele não será compatível para uso com o Tableau Server.

- `scope`. Este valor especifica um perfil que comunica ao IdP quais informações do usuário pretende retornar. Este valor pode ser configurado por um administrador do Tableau Server. O valor padrão é "openid email profile". Para obter mais informações, consulte [Configurar o valor de escopo](#configure-scope-value), posteriormente neste documento.
- `response_type`. OpenID Connect é compatível com vários fluxos. Este valor comunica ao IdP qual fluxo o Tableau Server espera. O Tableau é compatível apenas o fluxo do código de autorização, e o valor é sempre definido como "código".
- `client_id`. Este valor especifica a ID do servidor (ID do cliente do servidor na caixa de diálogo de Configuração do Tableau Server), permitindo que o IdP saiba de onde veio a solicitação. Ele é fornecido pelo IdP, quando o serviço está registrado. Este valor é configurável por um administrador do Tableau Server.
- `redirect_uri`. Este valor especifica a URL para a qual o IdP faz o redirecionamento, depois que o usuário for autenticado usando o OpenID Connect. A URL deve incluir o host e protocolo (por exemplo, `http://example.tableau.com`), mas o Tableau fornece o endpoint da URL.
- `nonce`. O Tableau Server gera um valor nonce para verificar se o cliente para o qual ele é redirecionado corresponde à entidade que retorna do IdP.

## Configurar o valor de escopo

O valor `scope` indica ao IdP as informações que o Tableau Server solicita sobre o usuário. Por padrão, o Tableau Server envia o valor "openid profile email". Isto indica que o Tableau usa o OpenID para autenticar (esta parte do valor do atributo `scope` deve ser sempre incluída), e que o Tableau Server está solicitando o perfil do usuário e as informações de e-mail durante a troca do código de autorização do usuário.

Se este escopo padrão não for adequado para a sua situação, você pode fazer com que o Tableau Server solicite informações personalizadas sobre o usuário. Para fazer isso, você deve configurar o IdP com um perfil personalizado (por exemplo, algo como "tableau-scope"). Em seguida, é possível configurar o Tableau Server para enviar a solicitação de escopo usando o nome do perfil personalizado.

Para alterar o valor do escopo que o Tableau Server solicita, use o comando da CLI do TSM a seguir:

`tsm authentication openid configure --custom-scope-name custom-scope-name`

**Observações:**

- O Tableau Server inclui sempre o "openid" como parte do valor do escopo (mesmo se você não incluí-lo na configuração `custom_scope`).
- Os comandos de configuração de autenticação do TSM se aplicam apenas à autenticação OIDC configurada no TSM durante a instalação do Tableau Server. Para fazer alterações de configuração de autenticação OIDC para grupos de identidade, você pode usar o endpoint [Atualizar configuração de autenticação](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#operation/AuthnService_UpdateAuthConfiguration) usando Tableau REST OpenAPI.

<!-- document id=e615459b09da9bfdda3f114437a1ee621afa04a5f3fe6458462b52d2718a4161 url=/tableau/current/pt-br/server/admin_profiles.md -->

[Pular para o conteúdo principal](#main-content)

# Perfis de administrador

As funções no site Administrador do servidor e Administrador de site concedem aos usuários permissões automáticas para várias configurações administrativas, mas também para todo o conteúdo. Isso significa que, se um usuário for transformado em administrador para poder adicionar usuários ao site ou gerenciar grupos, ele também poderá acessar todo o conteúdo do site. Em muitas configurações, esse tipo de acesso não é o ideal.

Os Perfis de administrador são uma maneira de fornecer a um usuário um conjunto específico de recursos administrativos sem conceder a ele acesso universal ao conteúdo. Cada perfil de administrador define um conjunto específico de recursos. Os usuários são então atribuídos a um perfil e ganham a capacidade de executar essas tarefas.

- Os recursos do perfil de administrador incluem gerenciamento de usuários e gerenciamento de grupos. Eles não incluem a capacidade de modificar as configurações do site.
- Os perfis de administrador são criados e gerenciados por um administrador do Tableau Server. Administradores do site podem receber autorização para atribuir usuários a perfis, mas não podem editar nem criar perfis de administrador.
- Os perfis de administrador não concedem acesso ao conteúdo.

## Criar um perfil de administrador

Criar um perfil de administrador consiste em configurar os recursos do perfil e adicioná-los aos sites. Somente um administrador do Tableau Server pode criar um perfil de administrador.

### Abra a página Perfis de administrador

1. Como administrador do Tableau Server, acesse Todos os sites para acessar as configurações de servidores.
    
    1. Abra no menu suspenso seletor de site e escolha Gerenciar todos os sites.
2. No painel à esquerda, selecione Perfis de administrador.

Todos os perfis existentes aparecem na lista de perfis de administrador. Um painel à direita mostra detalhes do perfil selecionado. Um perfil selecionado tem três guias: Recursos, Sites e Usuários.

- A guia **Recursos** mostra todos os recursos rapidamente.
- A guia **Sites** mostra em quais sites o perfil de administrador está presente e quantos usuários por site têm o perfil. Adicione o perfil a sites existentes nesta guia.
- A guia **Usuários** mostra quais usuários têm o perfil. Essa guia é útil para auditoria, mas os usuários não podem receber um perfil nessa guia. A atribuição de perfil acontece na página Usuários.

![a tela Perfis de administrador, com uma lista de quatro perfis de administrador e um selecionado para mostrar seus detalhes](/tableau/current/pt-br/server/pt-br/Img/admin_profiles.png)

### Criar um novo perfil de administrador

1. Clique no botão Novo Perfil de administrador.
2. Nomeie o perfil.
    
    1. Esse nome aparece em uma lista suspensa no momento de atribuir o perfil aos usuários, portanto, crie um nome descritivo, mas curto.
    2. Evite usar nomes potencialmente conflitantes (como uma função no site chamada “Criador de Administrador de site”)
3. Selecione quais [Recursos do perfil de administrador](#capabilities) o perfil deve conceder.
    
    1. Alguns recursos dependem de outros. Por exemplo, “Ver usuários” é necessário para o recurso “Adicionar novos usuários”. O texto de ajuda de cada recurso descreve as dependências existentes. A API REST não tem essas dependências.
    2. Os usuários podem ter, no máximo, um perfil por site.
4. (Opcional) Adicione uma descrição que descreva a finalidade do perfil de administrador.
5. Clique no botão Criar Perfil de administrador

![a caixa de diálogo Criar perfis de administrador, mostrando os recursos de gerenciamento de usuários e grupos](/tableau/current/pt-br/server/pt-br/Img/admin_profiles_capabilities.png)

O perfil agora existe no servidor, mas ainda não está disponível em nenhum site. A próxima etapa é adicionar o perfil a um site e adicionar usuários.

### Adicionar o perfil a um site

1. Selecione o perfil na lista de perfis de administrador.
2. Vá para a guia Sites.
3. Clique no botão Atribuir Perfil de administrador ao site.
4. Selecione os sites nos quais o perfil deve estar disponível.

A etapa final é atribuir o perfil aos usuários. Como apenas os administradores do servidor podem acessar a página Perfis de administrador, esta etapa não é concluída na página Perfis de administrador. Em vez disso, os usuários recebem um perfil de administrador da página Usuários.

## Atribuir um perfil de administrador aos usuários

Para receber um perfil de administrador, o usuário deve ter uma função Explorer ou Creator no site. Os usuários podem receber apenas um perfil de administrador por site.

_Administrador do servidor ou de site_. Os usuários podem receber perfis de administrador em sites:

1. Vá para a página Usuários do site.
2. Abra o menu de ações (...) do usuário
3. Selecione Função no site…
4. Use o menu suspenso Perfil de administrador para atribuir um perfil a eles.
    
    1. Para atribuir um perfil que não aparece na lista suspensa, peça a um administrador de servidor para verificar se o perfil foi adicionado ao site.

![A caixa de diálogo Função no site mostrando menus suspensos de função no site e o perfil de administrador](/tableau/current/pt-br/server/pt-br/Img/admin_profiles_siteroles.png)

_Apenas administradores do servidor._ Os usuários podem receber perfis de administrador em servidores:

1. Vá para a página Usuários do servidor.
2. Abra o menu de ações (...) do usuário.
3. Selecione Associação no site…
4. Para cada site no qual o usuário pertence, use o menu suspenso Perfil de administrador para atribuir a ele um perfil.
    
    1. O menu suspenso de cada site mostra perfis que foram adicionados a esse site. Para atribuir um perfil que não aparece na lista suspensa desse site, volte para a seção [Adicionar o perfil a um site](#addtosite) e verifique se o perfil foi adicionado a esse site.

## Gerenciar perfis de administrador

Para gerenciar um perfil de administrador, acesse a página Perfis de administrador. (Todos os sites > Perfis de administrador no painel esquerdo). A partir daí:

- Edite um perfil de administrador abrindo o menu de ação (...) do perfil e selecionando Editar perfil.
- Exclua um perfil de administrador abrindo o menu de ação (...) do perfil e selecionando Excluir perfil.
- Para remover um perfil de um site, selecione o perfil e acesse a guia Sites. Abra o menu de ação (...) de um site e escolha Remover do site.
    
    - Se houver usuários atribuídos a esse perfil nesse site, eles perderão seus recursos de administrador.

## Recursos do perfil de administrador

Ao contrário dos grupos, que são avaliados em combinação para determinar [permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm#evaluate-permission-rules), um único perfil de administrador define o que um usuário com esse perfil pode ou não fazer. Configure cada perfil de administrador para descrever exatamente quais recursos um usuário com esse perfil possui.

### Gerenciamento de usuários

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Recurso</td><td style="font-weight: bold;">Definição</td><td style="font-weight: bold;">Observações</td></tr><tr><td>Adicionar novos usuários</td><td>Criar e adicionar novo usuários ao site</td><td>Para poder adicionar usuários ao importar um upload de arquivo, o perfil de administrador deve incluir Gerenciar configurações do usuário, além de Adicionar novos usuários.</td></tr><tr><td>Gerenciar configurações de usuários</td><td>Atribuir funções no site e gerenciar as configurações do usuário</td><td>As configurações do usuário incluem localidade, endereço de e-mail, forçar atualização de senha e assim por diante. Pode precisar ser concedido em vários sites.*</td></tr><tr><td>Ver usuários</td><td>Ver quais usuários existem no site</td><td>Ver usuários é necessário para todos os outros recursos de gerenciamento de usuários na interface do usuário. Não é necessário para a API.</td></tr><tr><td>Excluir usuários</td><td>Remover permanentemente os usuários</td><td>&nbsp;</td></tr></tbody></table>

\*Quando um usuário final tem acesso a vários sites, algumas das configurações de usuário dele, como o endereço de e-mail, são compartilhadas entre sites. Para que um usuário com um perfil de administrador gerencie essas configurações, ele precisa receber o recurso _Gerenciar configurações do usuário_ em cada site no qual o usuário final estiver.

Por exemplo, imagine o usuário Leone, que é um visualizador no Site A e no Site B. Rialto é um usuário com um perfil de administrador que inclui _Gerenciar configurações de usuário_ no Site A. Rialto não poderá gerenciar o endereço de e-mail de Leone, mesmo no Site A, a menos que Rialto receba um perfil de administrador no Site B que inclua _Gerenciar configurações do usuário_.

### Gerenciamento de grupos

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Recurso</td><td style="font-weight: bold;">Definição</td><td style="font-weight: bold;">Observações</td></tr><tr><td>Criar novos grupos</td><td>Crie grupos com e sem atribuição de função no logon</td><td>&nbsp;</td></tr><tr><td>Ver grupos</td><td>Veja quais grupos existem no site</td><td>Ver grupos é necessário para todos os outros recursos de gerenciamento de grupos na interface do usuário. Não é necessário para a API.</td></tr><tr><td>Editar detalhes do grupo</td><td>Alterar nomes de grupos e conceder função no status de logon.</td><td>&nbsp;</td></tr><tr><td>Adicionar usuários aos grupos</td><td>Associação dinâmica a grupos</td><td>Somente usuários com uma função de administrador no site podem atribuir uma função de administrador no site a outro usuário.</td></tr><tr><td>Excluir grupos</td><td>Remova grupos permanentemente</td><td>&nbsp;</td></tr></tbody></table>

<!-- document id=5db8bf5c0eb3914b895a6776660c9a0f1dfb0c550f9646a5e74ace4c41938388 url=/tableau/current/pt-br/server/adminview_ask_data_usage.md -->

[Pular para o conteúdo principal](#main-content)

# Pergunte aos dados

**Mudanças importantes chegando para Pergunte aos dados e Métricas**

Os recursos Pergunte aos dados e Métricas do Tableau serão descontinuados no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau AI e o Tableau Pulse estão reinventando a experiência com dados.](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-gpt)

A exibição de uso de dados de perguntas é um painel pré-criado que permite aos administradores de site ou servidor visualizarem e entenderem os padrões de uso e o valor do Pergunte aos dados para um site. Os administradores podem ver o crescimento do engajamento com o Pergunte aos dados e monitorar os resultados de treinamentos internos ou implementações. O painel de instrumentos destaca os principais usuários de Pergunte aos dados, fontes de dados e proprietários de fontes de dados, juntamente com algumas métricas de valor de título.

![Um painel que ilustra o uso e a adoção do Pergunte aos dados, monitorando o número de usuários, consultas e fontes de dados ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/adminview_ask_data_usage.png)

Para habilitar o Pergunte aos dados, consulte [Desabilitar ou habilitar Pergunte aos dados para um site](https://help.tableau.com/current/server/pt-br/ask_data_enable.htm).

## Explorar o painel

A exibição de Uso de Pergunte aos dados fornece informações sobre Pergunte aos dados em todo o site. Você pode usar as seguintes métricas para entender o engajamento do usuário e ajudar a impulsionar a adoção de análises de autoatendimento em sua organização.

![O uso do Pergunte aos dados é evidenciado por 22 usuários, 177 consultas e 930 fontes de dados.](/tableau/current/pt-br/server/pt-br/Img/adminview_ask_data_usage_top.png)

Na parte superior do painel, três métricas de título fornecem uma visão geral do uso do Pergunte aos dados no site.

- Número de usuários em Pergunte aos dados - Mostra o número total de usuários de Pergunte aos dados no site.
- Número de consultas em Pergunte aos dados - Mostra o número total de consultas de Pergunte aos dados enviadas no site.
- Número de fontes de dados usadas com Pergunte aos dados - Mostra o número total de fontes de dados usadas com Pergunte aos dados.

![Dois gráficos de linhas mostram o crescimento de usuários distintos e proprietários de fontes de dados distintos ao longo do tempo.](/tableau/current/pt-br/server/pt-br/Img/adminview_ask_data_usage_middle.png)

No meio do painel, dois gráficos de linha mostram como o Pergunte aos dados é usado ao longo do tempo.

- Diferenciar usuários ao longo do tempo - Mostra o número distinto de usuários de Pergunte aos dados ao longo do tempo.
- Diferenciar proprietários de fontes de dados ao longo do tempo\- Isso mostra o número distinto de proprietários de fontes de dados ao longo do tempo.

![Três gráficos de barras exibem os principais usuários, fontes de dados e proprietários de fontes de dados.](/tableau/current/pt-br/server/pt-br/Img/adminview_ask_data_usage_bottom.png)

Na parte inferior do painel, três gráficos de barras listam os principais usuários, fontes de dados e proprietários de fontes de dados de Pergunte aos dados.

- Principais usuários de Pergunte aos dados - Lista os principais usuários de Pergunte aos dados e o número total de consultas enviadas por cada usuário.
- Principais Fontes de dados de Pergunte aos dados\- Lista as principais fontes de dados de Pergunte aos dados e o número total de consultas emitidas para cada fonte de dados.
- Principais proprietários de fonte de dados de Pergunte aos dados - Lista os principais proprietários de fontes de dados de Pergunte aos dados e o número total de fontes de dados de propriedade de cada usuário.

<!-- document id=674102cfe460d2513d080439f846b5b640b1ab32c5def92f088be57484eb66ac url=/tableau/current/pt-br/server/permissions.md -->

[Pular para o conteúdo principal](#main-content)

# Permissões

As permissões determinam como os usuários podem interagir com conteúdo, como pastas de trabalho e fontes de dados. Elas são definidas na caixa de diálogo Permissões ou pela [API REST](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_permissions.htm). Na parte superior da caixa de diálogo, as regras de permissão configuram recursos para grupos ou usuários. Abaixo, a grade de permissões exibe as permissões efetivas para os usuários.

![A caixa de diálogo de permissões do projeto mostra a guia da pasta de trabalho](/tableau/current/pt-br/server/pt-br/Img/perms_projectwrkbkperms.png "A caixa de diálogo de permissões do projeto mostra a guia da pasta de trabalho")

Existem vários tópicos interrelacionados que discutem como compreender, definir e gerenciar permissões. Os principais tópicos são:

- Este tópico, que abrange os fundamentos, sobre como definir regras de permissão para projetos e outros conteúdos, e considerações de permissão para cenários específicos.
- [Recursos e modelos de permissão](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm), que abrange detalhadamente os vários recursos que são usados para criar regras de permissão.
- [Gerenciar permissões com projetos](https://help.tableau.com/current/server/pt-br/permissions_projects.htm), que abrange o uso de projetos para gerenciar permissões e como projetos aninhados e bloqueados afetam as permissões.
- [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm), que abrangem como as regras de permissão são avaliadas e como as permissões finais são determinadas.
- [Permissões, funções de site e licenças](https://help.tableau.com/current/server/pt-br/permission_license_siterole.htm), que abrange como as permissões interagem com funções e licenças do site para determinar o que um usuário pode fazer em um site.

Além disso, se o Data Management estiver licenciado, as permissões de ativos externos têm considerações adicionais. Para obter mais informações, consulte [Gerenciar permissões para ativos externos](https://help.tableau.com/current/server/pt-br/dm_perms_assets.htm).

## Princípios básicos de permissões

**Projetos e grupos**

Os sites do Tableau usam _projetos_ para organizar conteúdo e _grupos_ para organizar usuários. Gerenciar permissões é mais fácil quando as regras de permissão são:

- Definidas no nível de projeto em vez de em partes individuais de conteúdo.
- Estabelecidas para grupos em vez de indivíduos.

As permissões só podem ser estabelecidas para usuários, grupos, projetos ou ativos que já existem. Para obter mais informações sobre a criação de usuários e grupos, criação de projetos e publicação de conteúdo, consulte [Gerenciar usuários e grupos](https://help.tableau.com/current/server/pt-br/users.htm), [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm) e [Publicar fontes de dados e pastas de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/publish_overview.htm).

**Capacidades e regras de permissão** 

As permissões são compostas por _recursos_, a capacidade de realizar ações como exibir conteúdo, editar na Web, baixar fontes de dados ou excluir conteúdo. As _regras de permissão_ estabelecem quais recursos são permitidos ou negados para um usuário ou grupo em uma parte de um ativo.

Para obter mais informações sobre recursos e modelos de regras de permissão, consulte [Recursos e modelos de permissão](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm) de permissão.

**Observação:** ao falar sobre permissões em geral, é comum ver uma frase como “o usuário deve ter a _permissão_ de exclusão.” É fácil de entender em um contexto amplo. No entanto, ao trabalhar com permissões em um nível técnico, como neste artigo, é mais preciso dizer “o _recurso_ de exclusão”. Neste tópico, usaremos o termo mais preciso _recurso_, mas você deve saber que pode ver _permissão_ em outros lugares.

![Caixa de diálogo de permissão mostrando várias regras de permissão com alguns recursos permitidos, negados ou não especificados](/tableau/current/pt-br/server/pt-br/Img/perms_permissionrules.png)

Para obter um detalhamento dos ícones de recursos e seus significados, consulte [Recursos e modelos de permissão](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm).

A interação entre nível de licença, função de site e potencialmente múltiplas regras de permissão afetam a determinação final do que um usuário pode ou não fazer. Para cada usuário, isso se torna suas _permissões efetivas_. Para obter mais informações, consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm). Algumas tarefas, como a criação de novas pastas de trabalho em um navegador (criação na Web) ou a movimentação de conteúdo, podem exigir configurações específicas de vários recursos, em vez de serem capturadas em um único recurso. Para obter mais informações, consulte [Configurações da permissão para cenários específicos](#Permissi).

## Definir permissões

As regras de permissão são definidas de forma diferente no nível do projeto, no nível de conteúdo ou ao publicar conteúdo do Tableau Desktop.

**Observação**: a frase "permissões de projeto" pode ter dois significados. Há recursos de permissão para um projeto em si (Exibir e Publicar) que controlam como um usuário pode interagir com um projeto. E há também o conceito de regras de permissão em nível de projeto para outros tipos de conteúdo. Neste artigo "permissões no nível de projeto" significa regras de permissão de pastas de trabalho, fontes de dados e outros ativos que estão configurados na caixa de diálogo Permissões de um projeto. Isso contrasta com as regras de permissão "nível de conteúdo" que podem ser definidas em uma pasta de trabalho específica, fonte de dados, etc.

_Para administradores, proprietários e líderes de projeto_

Para definir permissões no nível do projeto:

1. Navegue até o projeto
2. Abra o menu Ações (...) e clique em **Permissões**.
    
    ![Menu Ações](/tableau/current/pt-br/server/pt-br/Img/perms_actions_menu.png)
    
    A caixa de diálogo Permissões é aberta. Essa caixa de diálogo tem duas áreas principais: regras de permissão na parte superior e a grade de permissões efetivas embaixo. Cada tipo de conteúdo tem uma guia. A imagem abaixo mostra a guia Fontes de dados.
    
    ![Caixa de diálogo Permissões do projeto mostrando a guia Fontes de dados](/tableau/current/pt-br/server/pt-br/Img/perms_project_ds_perms.png "Caixa de diálogo Permissões do projeto mostrando a guia Fontes de dados")
    
    Com uma linha selecionada na parte superior, a grade de permissões efetivas é preenchida. Use isso para verificar as permissões. Passar o cursor fornece informações sobre por que o recurso é permitido ou negado para esse usuário específico.
3. Para modificar uma regra de permissão existente, selecione a guia apropriada para esse tipo de conteúdo e clique em um recurso.
4. Para criar nova regra, clique em \+ Adicionar Regra de Grupo/Usuário e digite para procurar um grupo ou usuário. Em cada guia, escolha um modelo existente na caixa suspensa ou crie uma regra personalizada clicando nos recursos.

Um clique define o recurso como **Permitido**, dois cliques o definem como **Negado** e um terceiro clique limpa a seleção (**Não especificado**).

6. Quando concluir, clique em **Salvar**.
    - Se o modelo "Nenhum" for selecionado, o botão dirá "Excluir regra".

### Definir permissões do projeto para todos os tipos de conteúdo.

Lembre-se de que a caixa de diálogo de permissões de um projeto contém guias para cada tipo de conteúdo. **Você deve definir permissões para cada tipo de conteúdo no nível do projeto ou os usuários terão acesso negado a esse tipo de conteúdo**. Um recurso só é concedido a um usuário se ele tiver uma permissão expressa. Deixar um recurso como Não especificado resultará na sua rejeição.

> [!TIP]
> 
> **Dica**: sempre que você criar uma regra de permissão no nível do projeto, verifique todas as guias de tipo de conteúdo.

### Definir a configuração de permissões de ativo

As regras de permissão definidas no nível de projeto atuam como um padrão para conteúdo salvo nesse projeto e nos projetos aninhados que ele contiver. Se essas regras padrão em nível de projeto são mantidas uniformes ou podem ser editadas depende da configuração de Permissão de ativo. Essa configuração pode ser realizada de duas maneiras, Bloqueada ou Personalizável. Para obter mais informações, consulte [Bloquear permissões de ativos](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#LockProject).

_Para administradores, líderes de projetos e proprietários de conteúdo_

Se as Permissões de ativos do projeto forem Personalizáveis, as permissões para ativos individuais podem ser modificadas. As informações abaixo não são relevantes para ativos em projetos bloqueados. Para obter mais informações, consulte [Bloquear permissões de ativos](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#LockProject).

> [!TIP]
> 
> **Dica**: embora seja possível definir permissões em ativos individuais de projetos Personalizáveis, recomendamos gerenciar permissões no nível do projeto.

### Definir permissões de ativos

1. Navegue até o ativo (como pasta de trabalho, fonte de dados, fluxo)
2. Abra o menu Ações (...) e clique em **Permissões**.
    
    ![Menu Ações](/tableau/current/pt-br/server/pt-br/Img/project_permissions_actionmenu.png)
    
    A caixa de diálogo Permissões é aberta. Essa caixa de diálogo tem duas áreas principais: regras de permissão na parte superior e a grade de permissões efetivas embaixo. (Observe a falta de guias em toda a parte superior — uma caixa de diálogo Permissões de nível de ativo não tem guias.)
    
    ![Caixa de diálogo de permissões no nível da pasta de trabalho mostrando regras de permissão e permissões efetivas](/tableau/current/pt-br/server/pt-br/Img/perms_workbookperms.png)
    
    Com uma linha selecionada na parte superior, a grade de permissões efetivas é preenchida. Use isso para verificar as permissões. Passar o cursor do mouse sobre um quadrado de recurso fornece informações sobre por que o recurso é permitido ou negado para esse usuário específico.
3. Para modificar uma regra de permissão existente, clique em um recurso.
4. Para criar nova regra, clique em \+ Adicionar Regra de Grupo/Usuário e digite para procurar um grupo ou usuário. Escolha um modelo existente na caixa suspensa ou crie uma regra personalizada clicando nos recursos.

Um clique define o recurso como **Permitido**, dois cliques o definem como **Negado** e um terceiro clique limpa a seleção (**Não especificado**).

6. Quando concluir, clique em **Salvar**.
    - Se o modelo "Nenhum" for selecionado, o botão dirá "Excluir regra".

### Definir permissões em uma exibição

> [!TIP]
> 
> **Dica**: embora seja possível definir permissões no nível de exibição em uma pasta de trabalho, é extremamente recomendável gerenciar permissões no nível de projeto (ou pasta de trabalho, se necessário).

Se uma pasta de trabalho for publicada com **Mostrar planilhas como guias** marcada, as exibições nessa pasta de trabalho herdarão todas as permissões definidas para a pasta de trabalho. A caixa de diálogo Permissões de uma exibição será de somente leitura.

Em algumas situações, pode ser útil especificar permissões em uma exibição, independentemente da pasta de trabalho que a contém. Se a pasta de trabalho for publicada com **Mostrar planilhas como guias** desmarcada (guias ocultas da planilha), as exibições começarão com as permissões da pasta de trabalho, mas serão independentes posteriormente e poderão ser definidas de forma separada. Observe que isso significa se as regras de permissão são modificadas para a pasta de trabalho, essas alterações não serão aplicadas às exibições, as permissões de cada exibição precisarão ser gerenciadas individualmente.

Consulte [Mostrar ou ocultar as guias de planilha](#sheettabs) para obter mais informações.

_Para publicadores de conteúdo_

Se as Permissões de ativos do projeto forem Personalizáveis, as permissões de ativos individual podem ser definidas ao publicar a partir do Tableau Desktop. As informações abaixo não são relevantes para conteúdo em projetos bloqueados. Para obter mais informações, consulte [Bloquear permissões de ativos](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#LockProject).

> [!TIP]
> 
> **Dica**: embora seja possível definir permissões em ativos individuais de projetos Personalizáveis, recomendamos gerenciar permissões no nível do projeto.

1. Na caixa de diálogo Publicação, clique no link Editar para **Permissões**.  
    Se o link Editar não estiver disponível, as permissões serão bloqueadas para o projeto e não poderão ser modificadas, exceto pelo proprietário de projeto, líder de projeto ou um administrador.
2. A caixa de diálogo Adicionar/Editar permissões mostra as regras de permissão existentes. Clique em Adicionar para incluir uma regra de permissão ou Editar para modificar uma regra de permissão existente
    
    1. Selecione o grupo ou usuário no painel esquerdo. É possível expandir um grupo para ver os usuários contidos nele.
    2. Use o seletor na parte superior do painel direito para escolher um modelo existente ou use os botões de opção para criar uma regra personalizada.
    
    Observe que as permissões efetivas não podem ser inspecionadas na caixa de diálogo Publicação.
3. Ao terminar, clique em **OK** e retome a publicação.

**Observação**: as permissões não podem ser definidas durante a publicação de fluxos no Tableau Prep Builder. Para definir permissões em um fluxo, consulte as etapas para Definir permissões no nível de projeto ou Definir permissões no nível de conteúdo.

### Limpar o grupo Todos os usuários

Por padrão, todos os usuários são adicionados a um grupo de “Todos os usuários” que tem permissões básicas de conteúdo. Para começar com uma tela limpa ao criar suas próprias regras de permissão, é recomendável excluir completamente a regra ou editá-la para Todos os usuários para remover as permissões (defina o modelo de função da permissão como Nenhum). Isso ajuda a evitar qualquer ambiguidade no caminho, reduzindo o número de regras que se aplicam a um usuário específico e, portanto, facilitando o entendimento das permissões efetivas.

## Configurações da permissão para cenários específicos

Certas ações exigem combinações de recursos da permissão e possivelmente funções no site. Veja a seguir alguns cenários comuns e as configurações da permissão pertinentes

### Salvar, publicar e substituir

No contexto das permissões, salvar é basicamente publicar. Como tal, os recursos Salvar e Salvar como uma cópia podem ser concedidos somente aos usuários com uma função de site do Administrator, Creator ou Explorer (pode publicar). As funções de site Explorer ou Viewer não podem salvar ou salvar como uma cópia.

- O recurso Publicar de um projeto permite que um usuário publique conteúdo nesse projeto.
- O recurso Substituir para conteúdo permite que um usuário salve sobre um conteúdo existente. Ao salvar sobre o conteúdo, o usuário se torna o proprietário desse conteúdo. O recurso Substituir também permite que os usuários editem aspectos secundários de partes existentes do conteúdo, como a descrição de uma métrica ou os sinônimos de uma função de dados. Editar o conteúdo existente desta forma não altera o proprietário do conteúdo.
- O Baixar / Salvar uma cópia ou Salvar uma cópia capacidade de conteúdo permite que um usuário use o Publicar como... opção de menu para salvar uma nova cópia do conteúdo. Isso geralmente é feito em conjunto com a criação na Web e significa que o usuário pode salvar as modificações.
    - Salvar uma cópia de uma pasta de trabalho é diferente de [salvamento automático](https://help.tableau.com/current/online/pt-br/autosave.htm), que mantém todas as alterações como rascunho.

#### Um lugar para publicar

É importante observar que os usuários não podem Publicar ou Publicar como uma parte do conteúdo, a menos que tenham o recurso Publicar em pelo menos um projeto, pois todo o conteúdo deve ser publicado em um projeto. Sem o recurso Publicar no nível de projeto, o conteúdo não pode ser publicado.

#### Sobrescrever e reivindicar propriedade

Em edição na Web, a opção **Publicar** no menu Arquivo aparece somente para o proprietário do conteúdo. Se um usuário que não seja proprietário tiver o recurso Substituir (permitindo salvar o conteúdo), ele precisará acessar **Arquivo > Publicar como** e nomear a pasta de trabalho exatamente com o mesmo nome. Essa ação emite um aviso de que ele está prestes a substituir o conteúdo existente, o que ele pode fazer. Por outro lado, um usuário que tem apenas o recurso Salvar como uma cópia e tenta usar o mesmo nome recebe um erro, informando que ele não tem permissão para substituir o conteúdo existente.

Se um usuário que não é o proprietário do conteúdo substituir o conteúdo, ele se tornará o proprietário, com todas as permissões envolvidas. O acesso do proprietário original ao conteúdo é então determinado pelas permissões como um usuário, em vez de proprietário.

**Observação**: Baixar/Salvar uma cópia é um recurso conjunto das pastas de trabalho. Os Explorers podem receber esse recurso, mas eles só podem baixar a pasta de trabalho e não salvar como uma cópia usando Publicar como. Conceder o recurso às funções de site Explorer (pode publicar), Creator ou Administrator fornece o recurso de baixar pastas de trabalho _e_ salvar como uma cópia usando as opções de publicação no menu Arquivo.

### Edição na Web e criação na Web

A edição na Web e a criação na Web permite que os usuários editem ou criem pastas de trabalho diretamente no navegador.

O recurso da permissão é chamado de _Edição da Web_ e a configuração do site é chamada de _criação na Web_. Esta seção se refere a qualquer ação de edição ou publicação baseada na Web como _criação na Web_.

Para habilitar essa funcionalidade, há vários requisitos.

- **Configuração do site**: a criação na Web deve ser ativada para todo o site do Tableau. Consulte [Definir acesso de criação na Web de um site](https://help.tableau.com/current/server/pt-br/web_author_enable.htm). Sem habilitar essa configuração, os usuários não podem criar pastas de trabalho ou editar pastas de trabalho existentes no navegador, _mesmo que tenham o recurso de edição na Web._
- **Função no site do usuário**: o usuário deve ter a função no site apropriada.
    - Viewers nunca podem ser editar na Web.
    - Explorers podem receber o recurso Edição na Web, mas não podem publicar. Basicamente, eles podem usar a edição na Web para responder mais perguntas com base no conteúdo existente, mas não pode salvar suas edições.
    - Explorers (pode publicar) ou Site Admininstrator Explorers podem publicar, mas eles só podem usar dados que já estão publicados no site.
    - Creators, Creators (Administradores de site) e Administradores do servidor podem publicar e criar fontes de dados.
- **Recursos da permissão**: o usuário deve ter os recursos da permissão necessários com base na funcionalidade desejada.

#### Configurações necessárias do recurso da permissão

<table class="table--plain" style="width: 100%;"><colgroup><col><col style="width: 15%;"><col style="width: 12%;"><col style="width: 12%;"><col style="width: 12%;"><col style="width: 12%;"><col style="width: 12%;"></colgroup><tbody><tr><td>Funcionalidade desejada</td><td>Função no site máxima</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_webedit_icon.png" alt="Ícone Edição na Web."> Edição na Web</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloadwkbksaveas_icon.png" alt="Ícone Baixar pasta de trabalho e salvar como."> Baixar/Salvar como cópia</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir <i>(pasta de trabalho</i>)</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Publicar <i>(projeto)</i></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_connect_icon.png" alt="Ícone Conectar."> Conectar-se (a fonte de dados)</td></tr><tr><td>Criação na Web sem poder salvar</td><td style="font-style: italic;">Explorer</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."> Negar</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."> Negar</td><td>Opcional</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td></tr><tr><td>Criação na Web e salvar como novo conteúdo</td><td style="font-style: italic;">Explorer (pode publicar)</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."> Negar</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td></tr><tr><td>Criação na Web e salvar (substituir) conteúdo</td><td style="font-style: italic;">Explorer (pode publicar)</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td></tr><tr><td>Criação na Web com novos dados e salvar novo conteúdo</td><td style="font-style: italic;">Creator</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td>Opcional</td><td>Opcional</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."> Permitir</td><td>Opcional</td></tr></tbody></table>

Opcional indica que esse recurso não está envolvido na funcionalidade desejada

### Acesso aos dados para fontes de dados publicadas do Tableau

As fontes de dados publicadas em um site do Tableau podem ter autenticação nativa, bem como permissões no ambiente do Tableau.

Quando a fonte de dados é publicada no site do Tableau, o publicador pode escolher como [Definir credenciais para o acesso aos dados publicados](https://help.tableau.com/current/pro/desktop/en-gb/publishing_sharing_authentication.htm#workbook-connections-to-tableau-data-sources) que contempla como as credenciais da fonte de dados são tratadas (como exigir que os usuários façam logon em um banco de dados ou insiram suas credenciais para Planilhas Google). Essa autenticação é controlada por qualquer tecnologia que detenha os dados. Isso pode ser inserido quando a fonte de dados é publicada ou o publicador da fonte de dados pode optar por solicitar ao usuário as credenciais da fonte de dados. Para obter mais informações, consulte [Publicar uma fonte de dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_datasources.htm#publishing-steps).

Também há recursos de fonte de dados que permitem ou negam aos usuários a capacidade de ver (Exibir) e se conectar à fonte de dados publicada (Conectar) no contexto do Tableau. Esses recursos são definidos como qualquer outra permissão no Tableau.

Ao publicar uma pasta de trabalho que usa uma fonte de dados publicada, o autor pode controlar como a autenticação do Tableau se comporta para alguém que está consumindo a pasta de trabalho. O autor define o acesso da pasta de trabalho para a fonte de dados publicada, como a Senha inserida (usando o acesso de Conexão do autor para a fonte de dados) ou Avisar usuário (usando o acesso de Conexão da pessoa que está exibindo a pasta de trabalho), o que também pode exigir autenticação da fonte de dados.

- Quando a pasta de trabalho estiver definida como **Senha inserida**, qualquer pessoa que visualizar a pasta de trabalho verá os dados com base no acesso do autor para a fonte de dados.
- Se a pasta de trabalho estiver definida como **Avisar usuário**, o acesso controlado pelo Tableau será verificado para a fonte de dados. A pessoa que está consumindo a pasta de trabalho deve ter o recurso Conectar da fonte de dados publicada para ver os dados. Se a fonte de dados publicada também for definida como Avisar usuário, o visualizador também deverá inserir suas credenciais para a própria fonte de dados.

<table class="table--plain"><colgroup><col><col><col></colgroup><tbody><tr><td>Autenticação da pasta de trabalho para a fonte de dados</td><td>Autenticação da fonte de dados para os dados</td><td>Como o acesso aos dados é avaliado para alguém que consome a pasta de trabalho</td></tr><tr><td>Senha inserida</td><td>Senha inserida</td><td>O usuário vê os dados como se fosse o autor da pasta de trabalho</td></tr><tr><td>Senha inserida</td><td>Avisar usuário</td><td>O usuário vê os dados como se fosse o autor da pasta de trabalho.&nbsp;(O autor é solicitado a fornecer autenticação da fonte de dados, não o usuário.)</td></tr><tr><td>Avisar usuário</td><td>Senha inserida</td><td>O usuário deve ter seu próprio recurso <b>Conectar</b> para a fonte de dados publicada</td></tr><tr><td>Avisar usuário</td><td>Avisar usuário</td><td>O usuário deve ter seu próprio recurso <b>Conectar</b> para a fonte de dados publicada e ser solicitado a fornecer as credenciais para os dados subjacentes</td></tr></tbody></table>

Observe que isso se aplica ao consumo de uma pasta de trabalho, não à edição na Web. Para edição na Web, o usuário deve ter seu próprio recurso Conectar.

Para obter informações sobre como inserir senhas ao publicar conteúdo do Tableau, como uma fonte de dados ou uma pasta de trabalho que usa uma conexão virtual, consulte [Conexões virtuais](https://help.tableau.com/current/server/pt-br/publishing_sharing_authentication.htm#virtual-connection-embedded-password) noTableau Server ajuda.

### Permitir que outros usuários atualizem extrações

Os usuários com a função no site Explorer (pode publicar) ou superior podem receber o recurso Atualização de extração em pastas de trabalho ou fontes de dados. Esse recurso fornece aos usuários a mesma interface que o proprietário do ativo para acionar uma atualização de extração. A extração deve ser uma fonte de dados publicada ou, se for local em uma pasta de trabalho, deve ter credenciais inseridas.

Como as atualizações de extração podem exigir muitos recursos e já podem estar agendadas, considere as seguintes práticas recomendadas ao atribuir o recurso Atualização de extração:

- **Extrações usadas com pouca frequência**: conceda aos usuários a capacidade de atualizar extrações sob demanda e considere desativar atualizações agendadas redundantes ou desnecessárias.
- **Extrações usadas regularmente**: considere agendar atualizações de extração e limitar o recurso Atualização de extração para atualizações sob demanda.
    - Atribua o recurso de atualização de extração como backup para evitar gargalos que dependem do proprietário ou dos administradores do ativo, em vez de conceder essas permissões amplamente.

### Mover conteúdo

Para mover um item, abra o menu Ação (...) e clique em Mover. Selecione um novo projeto para o item e, em seguida, clique em Mover ativos. Se Mover não estiver disponível ou se não houver projetos de destino disponíveis, verifique se as condições apropriadas foram atendidas:

- Os administradores sempre podem mover ativos e projetos para qualquer local.
- Os líderes e proprietários de projeto podem mover ativos e projetos aninhados entre seus projetos.
    - Observe que não é possível mover projetos para se tornarem projetos de nível superior
- Outros usuários podem mover os ativos somente se todos os três requisitos a seguir forem atendidos:
    - Função no site do Creator ou Explorer (pode publicar).
    - Direitos de publicação (recursos Exibir e Publicar) do projeto de destino
    - Proprietário do conteúdo ou, para pastas de trabalho e fluxos, com o recurso Mover.

Ao mover um banco de dados com suas tabelas, o usuário deve ter o recurso Mover para o banco de dados _e_ as tabelas.

Para obter informações sobre como as permissões são tratadas ao mover conteúdo e projetos, consulte [Mova projetos e conteúdo](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#moveproject).

### Métricas (descontinuadas em 2024.2)

> [!TIP]
> 
> **Dica:** as informações nesta seção são para o recurso de métricas herdado, que foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Para obter informações sobre as permissões das métricas do Tableau Pulse, consulte [Configurar o site para Tableau Pulse.](https://help.tableau.com/current/online/pt-br/pulse_set_up.htm#permissions)

**Descontinuação do recurso de métricas herdado**

O recurso de métricas herdado do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3. Com o Tableau Pulse, desenvolvemos uma experiência aprimorada para monitorar métricas e fazer perguntas sobre seus dados. Para obter mais informações, veja [Criar métricas com o Tableau Pulse](https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm) para conhecer a nova experiência e [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm) para o recurso descontinuado.

As métricas são criadas a partir de exibições em pastas de trabalho publicadas. Os usuários podem criar métricas se:

- Tiver uma função de site do Creator ou Explorer (pode publicar)
- Tiver o recurso **Publicar** em um projeto
- Tiver o recurso **Criar/atualizar métrica** na exibição ou pasta de trabalho relevante

Para obter mais informações, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/server/pt-br/metrics_create.htm) e [Configuração de métricas](https://help.tableau.com/current/server/pt-br/metrics_admin.htm).

Como as métricas são ativos independente, é importante observar que as permissões das métricas são gerenciadas independentemente da exibição da qual foram criadas. (Isso é diferente de alertas e assinaturas orientados por dados, onde o conteúdo do alerta ou da assinatura só pode ser visto se o usuário tiver as permissões corretas na própria exibição.)

Embora os recursos das métricas sejam simples, o recurso **Exibir** deve ser considerado cuidadosamente. É possível que uma pasta de trabalho com permissões restritas seja a base de uma métrica com permissões mais abertas. Para proteger dados confidenciais, negue a criação métrica de pastas de trabalho específicas.

#### As métricas exibem dados da perspectiva do proprietário

Ao criar uma métrica, você captura sua perspectiva dos dados dessa exibição. Isso significa que qualquer usuário que possa acessar sua métrica verá os dados como aparecem para você. Se os dados na exibição forem filtrados com base em suas credenciais, os dados que você vê podem ser diferentes do que outros usuários veem quando acessam a mesma exibição. Limite o recurso Exibição para sua métrica se estiver preocupado em expor sua perspectiva dos dados.

### Explique os dados

Quando Explique os dados está disponível, um usuário pode selecionar uma marca em uma exibição e clicar em Executar Explique os dados no menu da Dica da ferramenta da marca. Uma combinação de configurações deve ser habilitada para disponibilizar o Explique os dados no modo de edição e no modo de exibição.

Requisitos para que os autores executem Explique os dados ou editem as configurações de Explique os dados no modo de edição:

- Configuração do site: Disponibilidade de Explique os dados definida como Habilitar. Habilitado por padrão.
- Função de site: Creator ou Explorer (pode publicar) é necessária.
- Permissões: execute o recurso Explique os dados definido como Permitido. Não especificado por padrão. Se você abrir uma pasta de trabalho (Tableau versão 2022.1 ou anterior) que usou essa permissão no Tableau versão 2022.2 ou posterior, é necessário redefinir o recurso Executar Explique os dados para Permitido.

**Observação:** o recurso Baixar dados completos para um Creator ou Explorer (pode publicar) controla se eles veem a opção Exibir dados completos nas explicações de Valores extremos. Os Viewers sempre têm negado o recurso Baixar dados completos. No entanto, todos os usuários podem ver detalhes de nível de registro quando o tipo de explicação Valores extremos é habilitado nas configurações de Explique os dados.

Requisitos para que todos os usuários executem o Explique os dados no modo de visualização:

- Configuração do site: Disponibilidade de Explique os dados definida como Habilitar. Habilitado por padrão.
- Função de site: Creator, Explorer ou Viewer
- Permissões: execute o recurso Explique os dados definido como Permitido. Não especificado por padrão. Se você abrir uma pasta de trabalho (Tableau versão 2022.1 ou anterior) que usou essa permissão no Tableau versão 2022.2 ou posterior, será necessário redefinir o recurso Executar Explique os dados para Permitido.

### Mostrar ou ocultar as guias de planilha

No contexto do conteúdo publicado, as guias de planilhas (também conhecidas como exibições em guias) são um conceito distinto das guias de planilhas no Tableau Desktop. Mostrar e ocultar guias de planilhas no Tableau Desktop refere-se a ocultar as planilhas no ambiente de criação. Para obter mais informações, consulte [Gerenciar planilhas, painéis e histórias](https://help.tableau.com/current/pro/desktop/pt-br/environ_workbooksandsheets_sheets_hideshow.htm).

Mostrar e ocultar guias de planilhas (ligar ou desligar as exibições em guias) para o conteúdo publicado refere-se à navegação em uma pasta de trabalho publicada. Quando as guias de folhas são mostradas, o conteúdo publicado tem guias de folha de navegação ao longo da parte superior de cada visualização.

![comparação da navegação na exibição com exibições com guias ativada e desativada](/tableau/current/pt-br/server/pt-br/Img/tabbedviews.png)

Essa configuração também afeta a forma como as permissões funcionam e podem ter implicações de segurança (consulte a observação).

**Observação:** é possível ter o recurso Exibir para uma visualização sem o recurso Exibir da pasta de trabalho ou projeto que a contiver. Normalmente, se um usuário não tem o recurso Exibir para um projeto e pasta de trabalho, ele não sabe que esses ativos existem. No entanto, se ele tiver o recurso Exibir, é possível ver o nome do projeto e da pasta de trabalho ao ver a exibição, como no breadcrumb de navegação. Isso é um comportamento aceito e esperado.

#### Desligar as exibições em guias para permitir permissões de exibição independentes

Embora não seja recomendável como prática geral, há momentos em que pode ser útil definir permissões em modos de exibição, independentemente da pasta de trabalho que as contém. Para fazer isso, três condições devem ser atendidas.

1. A pasta de trabalho deve ser publicada — não há como definir permissões de exibição durante a publicação.
2. A pasta de trabalho deve estar em um projeto personalizável.
3. A pasta de trabalho não pode mostrar planilhas como guias (as exibições em guias devem estar ocultas).

Quando uma pasta de trabalho mostra planilhas como guias, todas as exibições herdam as permissões da pasta de trabalho e quaisquer alterações nas permissões da pasta de trabalho afetam todas as exibições. **Quando uma pasta de trabalho em um projeto personalizável não mostra exibições em guia, todas as exibições assumem as permissões da pasta de trabalho na publicação, mas qualquer alteração subsequente nas regras de permissão da pasta de trabalho** _não será herdada pelos modos de exibição_**.**

Alterar a configuração das planilhas como guias em uma pasta de trabalho publicada também afetará o modelo de permissão. Mostrar guias substituirão todas as permissões existentes no nível de exibição e reforçarão as permissões no nível de pasta de trabalho para todas as exibições. Ocultar guias interromperá a relação entre a pasta de trabalho e suas exibições.

- Para configurar planilhas como guias em uma pasta de trabalho publicada, abra o menu Ações (...) da pasta de trabalho e selecione **Exibições com guias**. Escolha **Mostrar guias** ou **Ocultar guias** como desejado.
- Para configurar planilhas como guias durante a publicação, consulte [Mostrar planilhas como guias](https://help.tableau.com/current/pro/desktop/pt-br/publish_workbooks_howto.htm#show-sheets-as-tabs).
- Para definir permissões no nível de exibição, consulte [Definir permissões de ativos](#contentpermissions).

> [!IMPORTANT]
> 
> **Importante**: em um projeto personalizável, qualquer modificação nas permissões no nível de pasta de trabalho não será aplicada, se as guias de planilha de navegação estiverem ocultas (isto é, exibições em guia desligadas). Alterações nas permissões devem ser feitas em exibições individuais.

### Coleções

Para obter informações sobre como gerenciar permissões em Coleções, consulte [Coleções](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#collections).

## Outros artigos nesta seção

<!-- document id=ce7da456f2dd7504479a77050c12f52e67e1648dfc398c7be4d3aacae3ea7a33 url=/tableau/current/pt-br/server/activity_log_audit_permissions.md -->

[Pular para o conteúdo principal](#main-content)

# Permissões de auditoria usando os registros de atividades

A auditoria de permissão permite que os administradores do sistema monitorem quais usuários modificaram os controles de acesso ao conteúdo do Tableau.Há duas maneiras de modificar o controle de acesso: alterações _explícito_ (alterando os recursos de permissão em um projeto ou item de conteúdo) e _eficazes_ (alterando as funções do site do usuário, associação ao grupo, movendo o conteúdo e assim por diante).Todas essas alterações são registradas, para que os administradores possam certificar que os controles de segurança e acesso sejam mantidos.

Para obter mais informações sobre como as regras de permissões são avaliadas, consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm).

## Formato de registro

Cada ação que modifica o acesso do usuário ou grupo ao conteúdo receberá uma entrada de registro.Cada entrada de registro é estruturada em um formato JSON, com chaves específicas representando diferentes informações.Uma entrada de registro contém duas partes:

- Metadados: contém informações sobre quando e onde ocorreu uma ação e qual usuário executou a ação.
- Ação: contém informações sobre qual parte do conteúdo teve suas permissões alteradas, quais recursos foram alterados e para quais valores os recursos foram alterados.

**Observação:** o registro de atividades registra as alterações feitas por meio da interface do usuário da caixa de diálogo de permissões e da API REST.Para obter mais informações sobre os métodos de API, consulte [Métodos de permissões](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_permissions.htm).

As entradas do registro de atividades não são formatadas, e as chaves não são classificadas em nenhuma ordem específica nos registros.Ao auditar permissões, você pode combinar dados do Log de atividades com outras fontes de dados para vincular IDs a nomes e facilitar a interpretação dos eventos.

### Exemplo

Veja a seguir um exemplo de entrada de registro mostrando que um grupo tinha permissão para se conectar a uma fonte de dados.

{  
"actorUserId": 39872,  
"actorUserLuid": "4e6b42bf-9040-4e60-b326-1c56a4fb96f8",  
"authorizableType": "DATASOURCE",  
"capabilityId": 32,  
"capabilityValue": "connect",  
"contentId": 2099835,  
"contentName": "Superstore ExtractNeal3",  
"eventTime": "2023-01-31T22:44:23.650058Z",  
"granteeId": 22,  
"granteeLuid": "dae0717a-d524-436d-b469-fadeaa22a5dd",  
"granteeType": "Group",  
"granteeValue": "GROUP\_ALLOW",  
"initiatingUserId": 39872,  
"initiatingUserLuid": "4e6b42bf-9040-4e60-b326-1c56a4fb96f8",  
"isError": false,  
"eventCategory": "security",  
"eventType": "set\_permissions",  
"eventVersion": "1.0",  
"permissionType": "explicit",  
"siteLuid": "b45e272d-10c7-49d5-9037-e53ce47dbf4e"  
}

A entrada de registro captura informações essenciais sobre o evento, incluindo:

- `eventType` mostra que ocorreu um evento de permissões definidas
- `permissionType` mostra uma alteração explícita nas permissões
- `contentId` mostra a ID do conteúdo que foi modificado
- `authorizableType` mostra o tipo de conteúdo, neste caso, uma fonte de dados
- `capabilityValue` mostra a capacidade que foi alterada
- `granteeId` mostra o beneficiado que foi afetado
- `actorUserId` mostra a ID do usuário que fez a alteração
- `eventTime` mostra a data e a hora da alteração

## Eventos

As entradas de registro contêm vários tipos de eventos para alterações de permissões, como `content_owner_change` quando o proprietário do conteúdo muda ou `set_permissions` quando uma permissão é criada ou atualizada.Diferentes ações produzem diferentes eventos.Para obter mais informações sobre tipos de evento, atributos e quando são registrados, consulte [Referência do tipo de evento de site do registro de atividades](https://help.tableau.com/current/server/pt-br/activity_log_schema.htm).

<!-- document id=0d2fb2c1924fe2b8cbe698ea4b257e206b61206125753aa34db8735ede1898d4 url=/tableau/current/pt-br/server/rmt-install-perms.md -->

[Pular para o conteúdo principal](#main-content)

# Permissões de instalação padrão – Resource Monitoring Tool do Tableau

O tópico a seguir fornece as permissões padrão definidas em várias contas ou grupos do sistema durante a instalação. Se o seu ambiente ou sua organização exigir que você use contas não padrão, isso ajudará a determinar quais permissões são necessárias para que a Resource Monitoring Tool (RMT) funcione corretamente.

**Observação:** o servidor e o agente da Resource Monitoring Tool (RMT) não são compatíveis com o Federal Information Processing Standard (FIPS) 140-2 e não funcionarão corretamente em sistemas operacionais executados com o modo FIPS ativado.  

## Instalações do Windows

Por padrão, o Tableau Resource Monitoring Tool cria estas contas quando instalado:

- NT SERVICE\\TableauResourceMonitoringTool
- NT SERVICE\\TableauResourceMonitoringToolPostgreSQL
- NT SERVICE\\TableauResourceMonitoringToolRabbitMQ

Se você quiser ou precisar usar outras contas no lugar das contas padrão, você pode especificá-las após a instalação usando o utilitário de linha de comando `rmt-admin`. Para obter mais detalhes, consulte [rmtadmin service-setup](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm#rmtadmin-service-setup).

As permissões usadas por essas contas de serviço padrão são mostradas abaixo, bem como as permissões mínimas necessárias. Suas contas de serviço devem corresponder às permissões mínimas ou às permissões padrão:

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 30%;" class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Conta de serviço</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Recurso</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Permissões padrão</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">Permissões mínimas obrigatórias</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool Master</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Arquivos do aplicativo<p><code>Tableau Resource Monitoring Tool\master</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Controle total: ler, escrever, executar, modificar</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controle total</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Diretórios e arquivos de log<p><code>Tableau Resource Monitoring Tool\master\logs</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Controle total: ler, escrever, executar, modificar</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Ler, escrever</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Diretório de configuração<p><code>Tableau Resource Monitoring Tool\master\config</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Controle total: ler, escrever, executar, modificar</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controle total</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool PostgreSQL</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Diretório de aplicativos<p><code>Tableau Resource Monitoring Tool\prerequisites\postgresql&lt;nn&gt;</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controle total</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de dados</p><p><code>Tableau Resource Monitoring Tool\data\postgresql&lt;nn&gt;</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controle total</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Diretório de logs<p><code>Tableau\Tableau Resource Monitoring Tool\master\logs\pgsql</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Ler, escrever.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool RabbitMQ</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de dados</p><p><code>Tableau Resource Monitoring Tool\data\rabbitmq</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controle total</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Arquivos do aplicativo</p><p><code>Tableau Resource Monitoring Tool\prerequisites\rabbitmq</code></p><p><code>Tableau Resource Monitoring Tool\prerequisites\erlang</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controle total</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Arquivos de registro</p><p><code>Tableau Resource Monitoring Tool\master\logs\rabbitmq</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Ler, escrever</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool Agent</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Arquivos do aplicativo</p><p><code>Tableau Resource Monitoring Tool\agent</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Controle total</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de log e arquivos</p><p><code>Tableau Resource Monitoring Tool\agent\logs</code></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Ler</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>Diretório de configuração</p><p><code>Tableau Resource Monitoring Tool\agent\config</code></p></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Controle total: ler, escrever, executar, modificar</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Controle total</td></tr></tbody></table>

## Instalações Linux

Por padrão, o Tableau Resource Monitoring Tool cria determinadas contas quando instalado. Se você quiser ou precisar usar grupos e usuários no lugar dos padrões, você pode especificá-los após a instalação usando o utilitário de linha de comando `rmt-admin`. Para obter mais detalhes, consulte [rmtadmin service-setup](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm#rmtadmin-service-setup).

As permissões padrão usadas por essas contas de serviço são mostradas abaixo. Suas permissões devem corresponder a estas permissões:

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 30%;" class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Conta de serviço</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Recurso</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">permissions</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool Master</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Arquivos do aplicativo<p><code>/var/opt/tableau/tabrmt/master</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever, executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Diretórios e arquivos de log<p><code>/var/opt/tableau/tabrmt/master/logs</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever, executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Diretório de configuração<p><code>/var/opt/tableau/tabrmt/master/config</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever, executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool PostgreSQL</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Diretório de aplicativos<p><code>/opt/tableau/tabrmt/prerequisites/postgresql13</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de serviços</p><p><code>/var/opt/tableau/tabrmt/data/postgresql13/pg_*</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - nenhum</p><p>Outros - nenhum</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de dados</p><p><code>/var/opt/tableau/tabrmt/data/postgresql13/</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever, executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de logs</p><p><code>/var/opt/tableau/tabrmt/master/logs/pgsql</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever, executar</p><p>Outros - executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Outros diretórios sob o diretório PostgreSQL não mencionados acima <p><code>/var/opt/tableau/tabrmt/data/postgresql13/&lt;not mentioned above&gt;</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - ler, escrever <p>Grupo - nenhum</p><p>Outros - nenhum</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>/var/opt/tableau/tabrmt/data/postgresql13/base</code><p><code>/var/opt/tableau/tabrmt/data/postgresql13/global</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - nenhum</p><p>Outros - nenhum</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>/var/opt/tableau/tabrmt/data/postgresql13/certificates</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - Permissões totais (ler, escrever, executar)</p><p>Outros - executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool RabbitMQ</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de dados</p><p><code>/var/opt/tableau/tabrmt/data/rabbitmq</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever e executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Arquivos do aplicativo</p><p><code>/var/opt/tableau/tabrmt/rabbitmq/prerequisites/rabbitmq</code></p><p><code>/var/opt/tableau/tabrmt/rabbitmq/prerequisites/erlang</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Arquivos de registro</p><p><code>/var/opt/tableau/tabrmt/master/logs/rabbitmq</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever e executar</p><p>Outros - executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Outros diretórios (no diretório <code>/rabbitmq</code>)</p><p><code>/var/opt/tableau/tabrmt/data/rabbitmq/certificates</code></p><p><code>/var/opt/tableau/tabrmt/data/rabbitmq/mnesia</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever e executar</p><p>Outros - executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>/var/opt/tableau/tabrmt/data/rabbitmq/&lt;other than mentioned&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - ler, executar <p>Grupo - ler, executar</p><p>Outros - nenhum</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Resource Monitoring Tool Agent</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Arquivos do aplicativo</p><p><code>/var/opt/tableau/tabrmt/agent</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever e executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Diretório de log e arquivos</p><p><code>/var/opt/tableau/tabrmt/agent/logs</code></p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever e executar</p><p>Outros - ler, executar</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>Diretório de configuração</p><p><code>/var/opt/tableau/tabrmt/agent/config</code></p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Proprietário - Permissões totais (ler, escrever, executar)<p>Grupo - ler, escrever e executar</p><p>Outros - ler, executar</p></td></tr></tbody></table>

### Quem pode fazer isso

Para fazer todas as etapas descritas acima, você precisa ser um administrador na máquina que está instalando o Resource Monitoring Tool e ser um administrador do Tableau Server.

<!-- document id=d6ae9cc6b7fced73679dab03aa295b7bf6b91fe02dd7a4954824ee8fcab21e10 url=/tableau/current/pt-br/server/permission_effective.md -->

[Pular para o conteúdo principal](#main-content)

# Permissões efetivas

Uma regra de permissão estabelece quem é afetado (um conjunto de grupos, grupo ou usuário) e a quais [Recursos](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm#Capabili) eles são **permitidos**, **negados** ou **não especificados**. Embora pareça simples apenas definir uma regra de permissão e essa deve ser a história toda, pode não estar claro se um usuário tem um recurso devido à associação a vários grupos e à interação das funções no site e da propriedade com as regras de permissão.

Diversos fatores são avaliados em uma ordem específica, produzindo _permissões efetivas_ em uma parte do conteúdo.

> [!TIP]
> 
> **Dica**: para ajudar a manter as coisas o mais objetivas possível, é recomendável (1) definir regras de permissão para grupos, em vez de usuários; (2) gerenciar permissões bloqueadas no nível de projeto, em vez de definir permissões no conteúdo individual; e (3) excluir a regra de permissão do grupo Todos os usuários ou definir todos os recursos como Nenhum.

É permitido um recurso para um usuário somente se as três condições a seguir forem atendidas:

- O recurso está dentro do escopo da função de site
- Ele tem esse recurso:
    - com base em um cenário de usuário específico (como ser o proprietário do conteúdo ou um líder de projeto ou ele tem uma função no site de administrador),  
        OU
    - porque o recurso foi permitido para ele como um usuário,  
        OU
    - porque ele está em um grupo que tem permissão para o recurso e nenhuma regra negou o recurso para ele como usuário ou membro de outro grupo
- Não há configurações das permissões em conflito em outro nível de conteúdo que tenha precedência.

Qualquer outra situação nega o recurso ao usuário.

Passar o cursor sobre um recurso mostra uma dica de ferramenta que explica a permissão efetiva. Estes são alguns exemplos comuns de por que as permissões efetivas (o que o usuário pode ou não fazer realmente) podem parecer diferentes do que determina a regra de permissão:

- Um usuário pode ter um recurso que foi negado a ele em uma regra de permissão, pois sua função no site o inclui (administradores).
- Um usuário pode ter um recurso que foi negado a ele em uma regra de permissão, pois seu cenário de usuário permite (porque ele possui o conteúdo ou é um proprietário ou líder de projeto).
- Um usuário pode não ter um recurso que foi permitido a ele em uma regra de permissão, porque sua função de site agora o permite.
- Um usuário pode não ter um recurso que foi permitido a ele em uma regra de permissão, porque uma regra de grupo ou usuário conflitante o negou.
- Um usuário pode não ter um recurso que foi permitido a ele em uma regra de permissão no nível de conteúdo (como uma pasta de trabalho), porque outro nível de conteúdo o negou (como uma exibição).

## Avaliar regras de permissão

As permissões no Tableau são restritas. A menos que um recurso seja concedido a um usuário, a permissão é negada. A lógica a seguir avalia se um recurso é permitido ou negado para um indivíduo:

![Fluxograma das regras sobre como as permissões são avaliadas](/tableau/current/pt-br/server/pt-br/Img/perms_evalflow_basic.png)

1. **Função de site**: se uma função de site não permitir um recurso, o usuário será negado. Se a função no site do usuário permitir o recurso, os cenários de usuário específicos serão avaliados.
    - Por exemplo, uma função de site Viewer não pode editar na Web. Consulte [Recursos gerais permitidos com cada função de site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm#site-role-capabilities-summary), para obter mais informações sobre o que cada função de site pode fazer.
2. **Cenários de usuário específicos:** 
    
    - Se o usuário for um administrador, ele terá todos os recursos em todo o conteúdo.
    - Se o usuário for um proprietário ou líder de projeto, ele terá todos os recursos em todo o conteúdo em seus projetos.
    - Se o usuário for o proprietário do conteúdo, ele terá todos os recursos\* em seu conteúdo.
    - Se esses cenários não se aplicarem ao usuário, as regras do usuário serão avaliadas.
    
    \*Exceção: os proprietários do conteúdo não terão o recurso **Permissões** nos projetos em que as permissões estão bloqueadas. Somente administradores, proprietários e líderes de projeto podem definir regras de permissão em projetos bloqueados.
3. **Regras de usuário:** se um recurso for negado o usuário, ele será negado. Se um recurso for permitido a ele, será permitido. Se um recurso não for especificado, as regras de grupo serão avaliadas.
4. **Regras de grupo:** se o usuário estiver em _qualquer_ grupo para o qual um recurso for negado, ele será negado. Se o usuário estiver em um grupo para o qual um recurso foi permitido (e não estiver em grupos para os quais esse recurso foi negado), ele será permitido.
    - Ou seja, se um usuário for membro de dois grupos e um recurso for permitido para um e o mesmo recurso for negado para outro, a negação terá precedência para esse usuário e ele será negado.
5. **Regras definidas pelo grupo:** se um usuário for membro de um grupo em um conjunto de grupos, qualquer grupo no conjunto de grupos cujo recurso tenha sido negado será negado.
6. Se nenhuma das condições acima se aplicar, o recurso será negado para esse usuário. De fato, isso significa que os recursos deixados como não especificados resultarão em negados.

Portanto, uma permissão efetiva final de **Permitido** ocorre em três circunstâncias:

- Permitido pela função no site (Administrador do servidor, Creator (Administrador de site), Explorer (Administrador de site)
- Permitido porque o usuário é o proprietário do conteúdo, proprietário de projeto ou líder de projeto
- Permitido por uma regra de grupos, conjunto de grupos ou usuário (e não negado por uma regra de precedência superior)

**Negado** ocorre em três circunstâncias:

- Negado pela função no site
- Negado por uma regra (e não permitido por uma regra de precedência superior)
- Não concedido por qualquer regra

## Avaliar as permissões definidas em vários níveis

Se Permissões de ativo são definidos como Personalizáveis, é possível configurar regras de permissão em vários lugares. Há regras específicas que determinam quais permissões são aplicadas no conteúdo.

- Se houver projetos aninhados, as permissões definidas no nível secundário terão precedência sobre as permissões definidas no nível primário.
- As alterações nas permissões no nível do projeto não são impostas para o conteúdo existente
- Se houver permissões definidas no conteúdo (pasta de trabalho, fonte de dados ou fluxo) durante ou após a publicação, elas prevalecerão sobre as regras definidas no nível do projeto.
- Se uma pasta de trabalho não mostrar guias de planilha de navegação, todas as alterações nas permissões no nível de pasta de trabalho _não_ serão herdadas pelos modos de exibição, e quaisquer alterações nas permissões deverão ser feitas no modo de exibição.
- A configuração da pasta de trabalho para mostrar as guias de planilha de navegação substituirá as permissões no nível de exibição existentes e sincronizará com as permissões no nível da pasta de trabalho. Consulte [Mostrar ou ocultar as guias de planilha](https://help.tableau.com/current/server/pt-br/permissions.htm#sheettabs).

![Fluxograma das regras sobre como as permissões são avaliadas com projetos aninhados](/tableau/current/pt-br/server/pt-br/Img/perms_evalflow_total.png)

Esta imagem mostra como os recursos são avaliados por meio de vários níveis de conteúdo.

## Permissões em exibições

Em uma pasta de trabalho que não está em um projeto bloqueado e não mostra planilhas como guias de navegação, as exibições (planilhas, painéis, histórias) herdam as permissões da pasta de trabalho na publicação, mas quaisquer alterações nas regras de permissão devem ser feitas em exibições individuais. Os recursos de exibição são iguais para as pastas de trabalho, exceto **Substituir**, **Baixar pasta de trabalho/Salvar como uma cópia** e **Mover**, que estão disponíveis apenas no nível de pasta de trabalho.

Recomendamos mostrar as guias de planilha de navegação sempre que possível, para que as exibições herdem suas permissões da pasta de trabalho. Para obter mais informações, consulte [Mostrar ou ocultar as guias de planilha](https://help.tableau.com/current/server/pt-br/permissions.htm#sheettabs).

<!-- document id=8e23a1211aa61868b817247c309561f5ea0d3395c04c322b698348d28921d3ea url=/tableau/current/pt-br/server/permission_license_siterole.md -->

[Pular para o conteúdo principal](#main-content)

# Permissões, funções de site e licenças

Adicionar um usuário ao Tableau Cloud requer uma licença disponível. (Os usuários também podem ser adicionados como não licenciados e configurados para que eles consumam uma licença somente quando entrarem pela primeira vez. Para obter mais informações, consulte [Atribuição de licença no logon](https://help.tableau.com/current/server/pt-br/grant_role.htm).) Para cada site a que o usuário pertence, ele tem exatamente uma função de site, restrita pela sua licença. Um usuário tem permissões para conteúdo no site, restritas ao que é permitido pela função de site.

As licenças e funções de site se aplicam aos usuários. Os recursos da permissão se aplicam ao conteúdo.

As **licenças** são atribuídas a um usuário quando são criadas (ou ao fazer logon pela primeira vez) no site do Tableau Server ou do Tableau Cloud. Os usuários são licenciados como um **Creator**, **Explorer** ou **Viewer**.

- Os níveis de licença são consumidos com base na _função de site_ máxima que um usuário pode ter nesse servidor.
    - As funções de site Administrator, Site Administrator Creator e Creator usam uma licença Creator.
    - As funções de site Site Administrator Explorer, Explorer (pode publicar) e Explorer usam pelo menos uma licença Explorer.
    - A função de site Viewer usa pelo menos uma licença Viewer.
    - Um usuário não licenciado pode existir no site, mas não pode entrar, a menos que seja adicionado com a função de site de concessão no login.
- No Tableau Server, um usuário consome apenas uma licença por servidor, mesmo que seja membro de vários sites. Se um usuário for membro de vários sites, o nível de licença necessário será determinado pela função de site mais alta. (Por exemplo, se um usuário tiver uma função de site Creator em um site e uma função de site Viewer em outros dois sites, ele usa uma licença Creator.)

**Funções de site** são atribuídas a um usuário de cada site que é membro.

- As funções de site determinam os recursos máximos que um usuário pode ter nesse site. (Por exemplo, um usuário com uma função no site de Viewer nunca poderá baixar uma fonte de dados, mesmo que esse recurso seja explicitamente concedido a ele em uma fonte de dados específica.)
- As funções de site não concedem recursos inerentemente por si só, com exceção das funções no site de administrador. Os administradores sempre têm todos os recursos aplicáveis ao nível de licença.

As **Permissões** consistem em _recursos_, como a capacidade de salvar em um projeto, editar uma pasta de trabalho na Web, conectar-se a uma fonte de dados etc. Elas se aplicam ao grupo ou usuário em uma parte específica do conteúdo (projeto, fonte de dados, pasta de trabalho, exibição ou fluxo). Para obter mais informações, consulte [Recursos e modelos de permissão](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm).

- Os recursos da permissão não são fornecidos a um grupo ou usuário no vácuo, mas no contexto do conteúdo. Um usuário pode ter diferentes recursos para diferentes ativos de conteúdo.
- As permissões são avaliadas com base na interação da função de site de um usuário e das regras de permissão para esse usuário ou qualquer grupo de que ele seja membro.
- Algumas ações, como a criação na Web, podem exigir combinações de recursos. Para obter mais informações, consulte [Configurações da permissão para cenários específicos](https://help.tableau.com/current/server/pt-br/permissions.htm#Permissi).

## Funções de site e seus recursos máximos

Estas tabelas indicam quais recursos estão disponíveis para uma função no site. Pode haver outras maneiras de um usuário com uma função de site executar uma ação similar. Por exemplo, embora os Viewers não possam receber o recurso Compartilhar personalizado para tornar suas exibições personalizadas visíveis para outras pessoas na pasta de trabalho, eles podem compartilhar exibições personalizadas copiando a URL delas. Consulte [Recursos gerais permitidos com cada função de site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm#site-role-capabilities-summary), para obter mais informações sobre o que cada função de site pode fazer.

Para obter mais informações sobre cada recurso, consulte [Recursos e modelos de permissão](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm).

### Projetos

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Publicar</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

### Pastas de trabalho

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_filter_icon.png" alt="Ícone Filtrar."> Filtrar</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_viewcomments_icon.png" alt="Ícone Exibir comentários."> Exibir comentários</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_addcomments_icon.png" alt="Ícone Adicionar comentários."> Adicionar comentários</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloadimage_icon.png" alt="Ícone Baixar dados completos."> Baixar imagem/PDF</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloadsumdata_icon.png" alt="Ícone Baixar dados de soma."> Baixar dados de resumo</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_explain_data_icon.png" alt="Ícone de Explique os dados"> Executar Explique os dados <a href="#dagger">†</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_sharecustomized_icon.png" alt="Ícone Compartilhar personalizado."> Compartilhamento personalizado</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloadfulldata_icon.png" alt="Ícone Baixar dados completos."> Baixar dados completos</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_webedit_icon.png" alt="Ícone Edição na Web."> Edição na Web</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_full_data_query.png" alt="Ícone de consulta de dados completos."> Consultar dados completos <a href="#ddagger">‡</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloadwkbksaveas_icon.png" alt="Ícone Baixar pasta de trabalho e salvar como."> Baixar pasta de trabalho/Salvar como cópia</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_ai_access.png" alt=""> Acesso à IA</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_api_access_icon.png" alt="Ícone Mover."> Acesso à API</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_metrics_icon.png" alt=""> Criar/atualizar métricas <a href="#section">§</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover."> Mover</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."> Excluir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_extract_refresh.jpg" alt="Ícone do recurso de permissão de atualização de extração"> Atualizar extrações</p></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

† Antes do Tableau 2021.3, a disponibilidade de Explique os dados era controlada no nível do servidor apenas usando a opção de conjunto de configuração tsm ExplainDataEnabled. Em 2021.3 e posteriores, a disponibilidade de dados explicativos pode ser controlada nas configurações do site e em uma pasta de trabalho usando o recurso Executar Explique os dados. A disponibilidade de Explique os dados no modo de exibição é controlada em uma pasta de trabalho na caixa de diálogo Configurações de Explique os dados.

‡ Consultar dados completa (FDQ) pode ser concedido a todas as funções no site. Ele funciona em conjunto com o acesso à API ou à IA para conceder a essas ferramentas a capacidade de consultar os dados completos. FDQ não é o mesmo que Baixar dados completos.

§ Antes do Tableau 2021.3, o recurso Criar/atualizar métricas era controlado pelo recurso Baixar dados completos.

### Fontes de dados

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_connect_icon.png" alt="Ícone Conectar."> Conectar</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloaddatasource_icon.png" alt="Ícone Baixar fonte de dados."> Baixar fonte de dados</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_pulse_metric_icon.png" alt="Ícone de Criação de definição de métrica"> Criar definições de métrica</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."> Excluir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_extract_refresh.jpg" alt="Ícone do recurso de permissão de atualização de extração"> Atualizar extrações</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

### Funções de dados

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover."> Mover</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."> Excluir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

### Fluxos

Para executar fluxos em uma agenda, você deve ter uma licença Data Management . Para obter informações sobre as configurações de fluxo, consulte [Criar e interagir com fluxos na Web](https://help.tableau.com/current/server/pt-br/web_author_flows.htm). Os usuários com licença Explorer (pode publicar) podem executar fluxos no Tableau Server e no Tableau Cloud. A partir da versão 2020.4, os usuários com licença Explorer não podem executar fluxos, mesmo que o administrador conceda a eles as permissões Executar fluxo.

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloaddatasource_icon.png" alt="Ícone Baixar fonte de dados."> Baixar fluxo</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_webedit_icon.png" alt="Ícone Edição na Web."> Edição na Web</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_connect_icon.png" alt="Ícone Conectar."> Executar fluxo</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover."> Mover</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."> Excluir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

### Ampliações de Pergunte aos dados

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover."> Mover</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."> Excluir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

### Métricas (descontinuadas em 2024.2)

> [!TIP]
> 
> **Dica:** as informações nesta seção são para o recurso de métricas herdado, que foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Para obter informações sobre as permissões das métricas do Tableau Pulse, consulte [Configurar o site para Tableau Pulse.](https://help.tableau.com/current/online/pt-br/pulse_set_up.htm#permissions)

**Descontinuação do recurso de métricas herdado**

O recurso de métricas herdado do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3. Com o Tableau Pulse, desenvolvemos uma experiência aprimorada para monitorar métricas e fazer perguntas sobre seus dados. Para obter mais informações, veja [Criar métricas com o Tableau Pulse](https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm) para conhecer a nova experiência e [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm) para o recurso descontinuado.

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover."> Mover</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."> Excluir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

### Coleções

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr></tbody></table>

### Conexões virtuais

As conexões virtuais requerem uma licença Data Management. Consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm) para obter detalhes.

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>Recurso</td><td>Creator</td><td>Explorer (pode publicar)</td><td>Explorer</td><td>Viewer</td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."> Exibição</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_connect_icon.png" alt="Ícone Conectar."> Conectar</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><a href="#dasterisk">**</a></td><td><a href="#dasterisk">**</a></td><td><a href="#dasterisk">**</a></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."> Substituir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover."> Mover</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."> Excluir</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."> Definir permissões</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_allow_icon.png" alt="Ícone de permissões autorizadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/permissions_deny_icon.png" alt="Ícone de permissões negadas."></td></tr></tbody></table>

\*Embora a função Explorer possa receber o recurso Mover, ela não pode ter o recurso Publicar em um projeto e, portanto, ela não tem para onde mover o conteúdo. Portanto, o recurso Mover não deve ser considerado possível para funções de site de Explorer.

\*\* Embora a função Explorer (pode publicar) possa receber o recurso **Conectar** para Conexões Virtuais, a capacidade de criar uma nova fonte de dados de qualquer tipo, incluindo Conexões Virtuais, está disponível apenas para usuários com uma função de site Creator. Da mesma forma, usuários com funções Explorer e Viewer não podem acessar a interface do usuário para se conectar a fontes de dados novas ou existentes. O recurso **Conectar** deve ser considerado impossível para qualquer função além de Creator.

<!-- document id=924bf543989b45cf27a79e7a15cd4a3f240db214d9e7fe15c75d1774eb9a8de9 url=/tableau/current/pt-br/server/revision_history_maintain.md -->

[Pular para o conteúdo principal](#main-content)

# Permitir que os usuários salvem o histórico de revisões

O histórico de revisões permite que os usuários vejam como as pastas de trabalho e as fontes de dados (recursos de conteúdo) foram alteradas ao longo do tempo. Todas as vezes que um usuário salvar (publicar) um recurso de conteúdo, o Tableau Server criará uma nova versão, que se tornará a versão atual. Ele torna a versão anterior na revisão mais recente da lista do histórico de revisões. O histórico de revisões dá confiança aos usuários para experimentar com o seu conteúdo, sabendo que suas versões mais antigas estarão disponíveis.

## Observações

- Essas informações se aplicam ao Tableau Server e são para administradores de servidor que desejam permitir que os publicadores trabalhem com as revisões.
- No Tableau Cloud, o histórico de revisões da pasta de trabalho e da fonte de dados está habilitado em todos os sites. Os usuários podem salvar até 10 revisões.
- Para obter informações sobre como trabalhar com as próprias revisões de conteúdo, incluindo possíveis problemas, consulte [Trabalhar com revisões de conteúdo](https://help.tableau.com/current/pro/desktop/pt-br/qs_revision_history.htm "Abre o tópico vinculado em uma nova guia do navegador.") na seção Usuário/Analista da ajuda do Tableau.

## Permissões que os usuários precisam para trabalhar com o histórico de revisões

Para acessar o histórico de revisões, o usuário deve ter uma função no site de Creator ou Explorer (pode publicar), além das seguintes permissões, dependendo do tipo de conteúdo:

- Projeto: Visualizar e Salvar
- Pastas de trabalho no projeto: Visualizar, Salvar e Baixar pasta de trabalho/Salvar como
- Fluxos no projeto: Visualizar, Salvar e Baixar Fluxo/Publicar como
- Fontes de dados no projeto: Visualizar, Salvar e Baixar fonte de dados

Para conexões virtuais no projeto, você deve ter uma função de site Creator e as permissões Exibir e Substituir. (As conexões virtuais requerem Data Management. Consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm) para obter detalhes.)

## Habilitar o histórico de revisões e definir o número de revisões permitidas

O histórico de revisões é definido a nível de site e habilitado por padrão com um limite de 25 revisões para cada recurso de conteúdo.

1. Entre em um site como um Administrador de servidor e clique em Configurações.
2. Em Histórico de revisões, selecione Salvar um histórico de revisões e insira um número máximo de revisões que deseja permitir para cada recurso de conteúdo.
3. Clique em Salvar.

Quando você diminui o número de revisões, as revisões mais recentes são salvas. Por exemplo, se o limite for definido como 15, as 15 versões mais recentes da pasta de trabalho ou da fonte de dados são salvas.

**Observação**: a lista do histórico de revisões do recurso de conteúdo pode não apresentar a alteração do limite até que um processo de limpeza em segundo plano seja executado.

## Limpar todas as revisões

Os administradores do servidor podem excluir todas as revisões anteriores das pastas de trabalho publicadas e das fontes de dados de um site. A versão mais recente de cada pasta de trabalho e fonte de dados publicada é sempre mantida.

1. Entre em um site como um Administrador de servidor e clique em Configurações.
2. Em Histórico de revisões, clique em Limpar histórico de revisões.
3. Clique em Salvar.

## Segurança para visualização e restauração de pastas de trabalho

Quando os usuários clicam em Restaurar ou Visualizar em revisões de pasta de trabalho, as senhas são trocadas entre o navegador do usuário e o servidor. O Tableau Server criptografa essas senhas usando a criptografia de chave pública/privada. Para garantir que essas chaves públicas são fornecidas pelo Tableau Server, você deve configurar o servidor para usar o SSL (HTTPS). Para obter mais informações, consulte [SSL](https://help.tableau.com/current/server/pt-br/ssl.htm) .

## Consulte também

[Possíveis problemas no histórico de revisões](https://help.tableau.com/current/pro/desktop/pt-br/qs_revision_history.htm#more-notes) na seção Usuário/Analista da ajuda do Tableau.

<!-- document id=909a056cf3838cfeff9a20dae24b83d0e6cc1ac5e942f8798973242370f231b5 url=/tableau/current/pt-br/server/Request_access.md -->

[Pular para o conteúdo principal](#main-content)

# Permitir que os usuários solicitem acesso ao conteúdo

As permissões determinam se um usuário tem acesso de visualização à pasta de trabalho, à fonte de dados ou a outro conteúdo dentro de um projeto. Se um usuário clicar em um conteúdo ou projeto ao qual não tem acesso, ele poderá enviar uma solicitação de acesso ao proprietário que controla as permissões desse conteúdo.

![Caixa de diálogo Solicitar acesso](/tableau/current/pt-br/server/pt-br/Img/request_access.png)

Quando alguém solicita o acesso, o proprietário que controla as permissões desse conteúdo (do projeto ou da pasta de trabalho) recebe um e-mail com o nome e e-mail do solicitante, o conteúdo ou projeto solicitado e um link para conceder acesso ao conteúdo. No Tableau Server versão 2022.3 e anteriores, o proprietário recebe um link para o conteúdo para gerenciar permissões em vez de um link para conceder acesso diretamente.

1. Na notificação por e-mail, selecione Garantir acesso.
2. Na caixa de diálogo que aparece, para conceder o modelo de permissões de exibição, selecione Garantir acesso. Para conceder permissões diferentes do modelo de exibição, selecione Gerenciar Permissões.
    
    ![Caixa de diálogo Conceder acesso](/tableau/current/pt-br/server/pt-br/Img/grant_access.png)

Se um usuário solicitar o acesso a uma pasta de trabalho e as permissões de conteúdo estiverem bloqueadas para o projeto, o proprietário do projeto receberá a solicitação. Da mesma forma, se um usuário solicitar o acesso a uma pasta de trabalho e as permissões do projeto forem gerenciadas pelo proprietário da pasta de trabalho, ele receberá a solicitação.

Após conceder a permissão, o proprietário pode enviar um e-mail para o solicitante, informando-o que ele pode visualizar o projeto ou a pasta de trabalho.

## Configurações padrão

Por padrão, a configuração Solicitar acesso está ativada em um novo site. Para ativar a configuração se ela estiver desativada:

1. Acesse a guia Geral da página Configurações do site.
    - Se você tiver um único site, na navegação lateral, clique em Configurações e Geral.
    - Se você tiver vários sites, selecione o site que deseja configurar e clique em Configurações e Geral.
2. Na guia Geral, role para baixo até Solicitar acesso e selecione Permitir que os usuários solicitem o acesso a projetos, pastas de trabalho e exibições.
3. Clique em Salvar.

## Configurar permissões do projeto

Você pode controlar quem recebe a solicitação de acesso, ajustando as permissões de conteúdo do projeto. Se as permissões de conteúdo estiverem:

- Bloqueadas para o projeto: o proprietário do projeto receberá a solicitação.
- Personalizável: o proprietário da pasta de trabalho recebe a solicitação.

Para gerenciar o acesso ao conteúdo usando os projetos, consulte [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm) e [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#lock-project-permissions).

Para obter mais informações sobre como as regras de permissão são avaliadas, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#evaluate-permission-rules): avaliar regras de permissão.

## Alterar as permissões do projeto

_Para administradores e líderes de projetos_

As permissões podem ser definidas no nível do projeto, para o próprio projeto e para qualquer conteúdo do projeto. Por exemplo, se as permissões da carteira de trabalho forem configuradas no nível do projeto, todas as carteiras de trabalho publicadas nesse projeto herdam essas permissões padrão. No entanto, o Creator pode optar por alterar as permissões durante a publicação, ou certos usuários podem alterar as permissões no conteúdo publicado. Para impor as permissões estabelecidas no nível do projeto, as **Permissões de conteúdo** podem ser bloqueadas para o projeto. Para obter mais informações, consulte [Bloquear permissões de ativos](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#LockProject).

Para definir permissões no nível do projeto:

1. Navegue até o projeto
2. Abra o menu Ações (...) e clique em **Permissões**. A caixa de diálogo de permissões é aberta.

Esta caixa de diálogo tem duas áreas principais: regras de permissão no topo e a grade de permissões efetivas abaixo. Use as guias para navegar entre os tipos de conteúdo.

![Janela Permissões do projeto com a linha Grupo destacada.](/tableau/current/pt-br/server/pt-br/Img/perms_projectwrkbkperms.png)

Com uma linha selecionada na parte superior, a grade de permissões efetivas é preenchida. Use isso para verificar as permissões. Passar o indicador de capacidade sobre um quadrado de recurso fornece informações sobre por que o recurso é permitido ou negado para esse usuário específico.

6. Para modificar uma regra de permissão existente, selecione a regra e clique nas caixas de capacidade para alternar entre permitido/negado/não especificado.
7. Para criar uma nova regra,
    1. Selecione \+ Adicionar Grupo/Regra de Usuário.
    2. Selecione um grupo ou usuário na caixa suspensa. Isso cria uma linha para configurar a regra de permissão.
8. Na linha da regra de permissão
    1. Escolha um modelo de função de permissão existente na caixa suspensa para cada guia de tipo de conteúdo.
    
    ![Janela Regras de permissão com a opção Explorar selecionada no menu de modelo Personalizado.](/tableau/current/pt-br/server/pt-br/Img/perms_projwkbk_templates.png)
    
    3. Ou crie uma regra personalizada navegando até uma guia de tipo de conteúdo e clicando nos recursos. Um clique define o recurso como **Permitido**, dois cliques o definem como **Negado** e um terceiro clique limpa a seleção (**Não especificado**).
9. Quando concluir, clique em **Salvar**.

## Alterar as permissões do conteúdo

_Para administradores, líderes de projetos e proprietários de conteúdo_

Se as permissões do projeto forem personalizáveis, as permissões de partes individuais do conteúdo poderão ser modificadas.

> [!WARNING]
> 
> **Aviso**: o Tableau recomenda permissões de bloqueio para o projeto. Estas etapas são relevantes apenas para conteúdo em projetos cujas permissões são personalizáveis.

### Definir permissões de conteúdo

1. Navegue até o conteúdo (pasta de trabalho, fonte de dados, fluxo, função de dados)
2. Abra o menu Ações (...) e clique em **Permissões**. A caixa de diálogo de permissões é aberta.

Esta caixa de diálogo tem duas áreas principais: regras de permissão no topo e a grade de permissões efetivas abaixo.

![Tabela de permissões de usuários e funções no site.](/tableau/current/pt-br/server/pt-br/Img/perms_workbook_siteroles.png)

Com uma linha selecionada na parte superior, a grade de permissões efetivas é preenchida. Use isso para verificar as permissões. Passar o cursor do mouse sobre um quadrado de recurso fornece informações sobre por que o recurso é permitido ou negado para esse usuário específico.

6. Para modificar uma regra de permissão existente, abra o menu Ações (...) para essa linha e clique em **Editar**.
7. Para criar uma nova regra,
    1. Selecione \+ Adicionar uma regra de usuário ou grupo.
    2. Se necessário, use a caixa suspensa à direita para alterar entre grupos e usuários.
    3. Selecione um grupo ou usuário na caixa suspensa. Isso cria uma linha para configurar a regra de permissão.
8. Na linha para a regra de permissão, escolha um modelo de função de permissões existentes na caixa suspensa ou crie uma regra personalizada clicando nos recursos.

Um clique define o recurso como **Permitido**, dois cliques o definem como **Negado** e um terceiro clique limpa a seleção (**Não especificado**).

10. Quando concluir, clique em **Salvar**.

### Definir permissões em uma exibição

Em algumas situações, pode ser útil especificar permissões em uma exibição, independentemente da pasta de trabalho que a contém. Para definir permissões em uma visão publicada, navegue até a exibição dentro de uma pasta de trabalho publicada e siga as etapas acima.

> [!WARNING]
> 
> **Advertência**: embora seja possível definir permissões no nível de exibição em uma pasta de trabalho, é altamente recomendável gerenciar permissões no nível do projeto (ou pasta de trabalho) o máximo possível. Para que as opiniões herdem as permissões, o projeto deve ser bloqueado ou a pasta de trabalho deve ser publicada com **Mostrar planilhas como guias.** Consulte [Permitir que os usuários solicitem acesso ao conteúdo](#sheettabs) para obter mais informações.

<!-- document id=f90547f069a1839366c6be0ccc82a1b7f54beab8d580c34289fffac613d47bb3 url=/tableau/current/pt-br/server/allow_saved_tokens.md -->

[Pular para o conteúdo principal](#main-content)

# Permitir tokens de acesso salvos

Depois de configurar Tableau Server para OAuth, você pode decidir se deseja permitir que os usuários gerenciem suas próprias credenciais OAuth ou se prefere gerenciá-las de maneira centralizada. Se quiser que os usuários as gerenciem por conta própria, precisará permitir configurações do perfil do usuário no servidor.

**Observação:** caso você ainda não tenha configurado o servidor para permitir conexões de dados OAuth, consulte os tópicos relacionados listados abaixo.

**Observação**: tokens de atualização de uso único não são aceitos para conexões OAuth com o Tableau no momento. Na maioria dos casos, você pode configurar seu provedor de identidade (como o Okta IDC Redshift) para usar tokens de atualização contínua. Para obter mais informações, consulte a documentação do OAuth do seu provedor.

1. Entre no Tableau Server como administrador de servidor.
2. **Único site**: clique em Configurações \> Geral.
    
    **Vários sites**: no menu do site, clique em **Gerenciar. Todos os sites** e, em seguida, clique em Configurações \> Geral.
3. Na seção Credenciais salvas para fontes de dados, selecione o seguinte:
    
    - Permitir que usuários salvem senhas de fontes de dados (permite que os usuários salvem suas credenciais individuais com fontes de dados).
    - Permitir que usuários salvem tokens de acesso OAuth para fontes de dados
    
    ![](/tableau/current/pt-br/server/pt-br/Img/allow_saved_tokens.png)
4. Clique em Salvar.

Uma vez marcadas essas caixas de seleção, os usuários verão em suas configurações de perfil uma seção Gerenciar credenciais, na qual poderão adicionar tokens de acesso para conexões de dados OAuth.

![](/tableau/current/pt-br/server/pt-br/Img/allow_saved_tokens3.png)

## Gerenciamento de credenciais de maneira centralizada

Os administradores de servidor têm a opção de gerenciar credenciais OAuth de maneira centralizada. Isso pode funcionar bem, por exemplo, quando vários usuários trabalham na mesma data e você tem uma conta de usuário dedicada para o provedor de dados.

Para gerenciar credenciais de maneira centralizada, faça o seguinte:

- Desmarque as caixas de seleção descritas no procedimento anterior.
- Edite as informações de conexão quando as fontes de dados forem publicadas.
    
    Ao editar a conexão, insira credenciais que usem um token de acesso OAuth em vez de nome de usuário e senha de um indivíduo.

Quando as configurações para salvar senhas e tokens de acesso não estiverem habilitadas, a seção Gerenciar credenciais será excluída das configurações de perfil dos usuários.

## Proxy de encaminhamento para autenticação OAuth

Para obter mais informações sobre como configurar um proxy de encaminhamento com autenticação OAuth para o Tableau Server (somente Windows), consulte [Configurar um proxy de encaminhamento para autenticação OAuth](https://help.tableau.com/current/pro/desktop/pt-br/config_proxy_oauth.htm#server) na Ajuda do Tableau.

## Consulte também

[Configurar OAuth para Google](https://help.tableau.com/current/server/pt-br/config_oauth_google.htm)

[Alterar o OAuth do Salesforce.com para credenciais salvas](https://help.tableau.com/current/server/pt-br/config_oauth_sfdc.htm)

[Configurar o OAuth para conexões do Snowflake no Tableau Server](https://help.tableau.com/current/server/pt-br/config_oauth_snowflake.htm)

[Configurar OAuth para QuickBooks Online do Intuit](https://help.tableau.com/current/server/pt-br/config_oauth_qbo.htm)

<!-- document id=1a4f658b2d62ff5dbe4468c677ec0cbf171582d57f1a5b4fea99dacddd9b1237 url=/tableau/current/pt-br/server/data_stories_customize_context_variables.md -->

[Pular para o conteúdo principal](#main-content)

# Personalizar a história com dados do Tableau: variáveis de contexto

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Variáveis de contexto são funções que podem ser referenciadas por outras funções. Em outras palavras, você pode usar variáveis de contexto para aninhar funções dentro de outras funções.

Depois de definir sua variável de contexto, ela aparece como uma função que você pode usar ao adicionar novas funções à sua História com dados do Tableau.

**Observação:** você pode ter várias variáveis de contexto definidas para cada frase personalizada, mas deve definir cada variável de contexto separadamente para cada parte do conteúdo personalizado.

## Definir uma variável de contexto

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Clique em Adicionar item personalizado.
3. Clique no menu no lado direito da caixa de conteúdo personalizado e selecione Definir contexto.  
      
    ![Caixa de diálogo Editar história em que uma frase da história é selecionada, para que o menu seja aberto. A opção “Definir contexto” é destacada.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_set.png)
4. Clique em Adicionar contexto.
5. Nomeie a variável de contexto e clique em Definir função.
6. Defina sua função personalizada e escolha uma dimensão.  
      
    ![Um campo aberto para nomear uma variável de contexto, um botão “Adicionar contexto” e campos para definir a função personalizada.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_add.png)
7. Clique em Adicionar à seção.
8. Clique de volta na frase onde você definiu sua variável de contexto.
9. Siga as etapas para [Adicionar funções](https://help.tableau.com/current/server/pt-br/data_stories_customize.htm#Add).  
      
    ![A caixa de diálogo da função está aberta e o campo para definir a função personalizada tem as opções de contexto personalizadas listadas.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_shows.png)

Agora, sua variável de contexto é listada como uma opção na lista suspensa Valor da dimensão ao adicionar sua função.  

## Quando usar uma variável de contexto: faça referência a duas ou mais medidas  

Digamos que você queira fazer referência a duas ou mais medidas em uma frase analítica em sua História com dados. Sem uma variável de contexto, podemos escrever uma frase para apenas uma medida de cada vez. Mas se usarmos uma variável de contexto, podemos fazer referência a mais de uma medida em uma frase.  

Para fazer referência a duas ou mais medidas com uma variável de contexto, sua História com dados deve ter:

> - 1 dimensão
> - 2 ou mais medidas

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Clique em Adicionar item personalizado.
3. Clique no menu no lado direito da caixa de conteúdo personalizado e selecione Definir contexto.
4. Clique em Adicionar contexto.
5. Nomeie a variável de contexto e clique em Definir função.
6. Defina sua função personalizada e escolha uma dimensão.
7. Clique em Adicionar à seção.  
      
    ![Imagem que mostra uma variável de contexto com uma função definida de rótulo descendente de classificação, medida de SUM(PIB), Classificação 1 e Dimensão de País/Região](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_setfuction.png)
8. Clique de volta na frase onde você definiu sua variável de contexto.
9. Adicione sua primeira função e preencha os campos obrigatórios. Neste exemplo, selecionamos DimensionValueLabel e, em seguida, escolhemos País/Região de Dimensão e, em seguida, país com o PIB mais alto (nossa variável de contexto) de Valor de dimensão.  
      
    ![A caixa de diálogo de função é aberta e as opções listadas na etapa 9 são selecionadas.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_context_func1.png)

1. Clique em Adicionar à seção.
2. Adicione sua segunda função e preencha os campos obrigatórios. Neste exemplo, selecionamos Valor e, em seguida, escolhemos País/Região de Dimensão, SUM(Juros para empréstimos) de Medida e país com o PIB mais alto (nossa variável de contexto) de Valor de dimensão.  
      
    ![A caixa de diálogo de função é aberta e as opções listadas na etapa 10 são selecionadas.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_context_func2.png)

1. Clique em Adicionar à seção.
2. Clique em Salvar.

Sua História com dados escreve uma frase que nos dá uma visão de uma medida secundária (Juros para empréstimos) para o país em que estamos interessados (o país com o maior PIB).  
  
![Imagem que mostra uma frase renderizada na história de dados informando que os Estados Unidos têm o AVG (PIB) mais alto e uma participação de empréstimo de US$ 0,7 bilhão nesse conjunto de dados.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_sentence.png)  

## Quando usar uma variável de contexto: análise período a período

Uma variável de contexto é útil quando você deseja analisar o desempenho em dois períodos diferentes em sua história com dados. Você pode criar uma frase personalizada que escreve sobre uma medida exibida em sua seção de pesquisa e compara a medida com diferentes períodos, como ano a ano ou mês a mês.  

Para configurar uma análise período a período, sua história de dados deve ter:

> - 2 dimensões: 1 dimensão de período (primária) e 1 dimensão de não período (secundária)
> - 1 a 3 medidas

1. Criar História com dados.
2. Na caixa de diálogo Campos, certifique-se de que a dimensão do período de tempo esteja ordenada primeiro e clique em Avançar.
3. Na caixa de diálogo História, selecione Contínuo e clique em Concluído.
4. Abra a caixa de diálogo Editar e selecione Adicionar item personalizado na primeira área de pesquisa.
5. Crie duas variáveis de contexto que representam seus períodos. Por exemplo, "Trimestre atual" e "Trimestre anterior".  
      
    ![Imagem que mostra duas variáveis de contexto definidas, uma para um trimestre atual e outra para um trimestre anterior](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_quarters.png)
6. Crie uma frase _aumentada_ adicionando linguagem e funções personalizadas. O conteúdo desta frase resulta em "\[CurrentDimensionValueLabel\] aumentou \[X%\] no trimestre."
7. Digite a função seguida da palavra "aumentou" na caixa de texto personalizada.
8. Adicione a função que retorna a alteração percentual de sua medição durante o período.  
      
    ![A caixa de diálogo de função é aberta e as opções listadas nas etapas 1 a 8 são escolhidas.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_increased.png)
9. Clique em Adicionar à seção.
10. [Conteúdo personalizado duplicado](https://help.tableau.com/current/server/pt-br/data_stories_customize.htm#Duplicat) e crie uma versão _reduzida_ substituindo a palavra "aumentado" por "diminuído". As funções permanecem as mesmas.  
      
    ![Caixa de diálogo Editar história em que uma frase da história é selecionada, para que o menu seja aberto. A opção “Duplicar” é destacada.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_duplicate.png)
11. [Adicionar condições](https://help.tableau.com/current/server/pt-br/data_stories_customize.htm#Add2) para cada frase para que apenas uma seja escrita, dependendo dos dados.  
      
    ![A caixa de diálogo de condição é aberta e o conteúdo personalizado é inserido para o aumento do trimestre anterior.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_addcondition.png)
12. Para a sentença _aumentada_ , defina as condições de acordo com o exemplo a seguir:

> Argumento esquerdo = Função valor
> 
> Dimensão = Trimestre(OrderDate). Selecione sua dimensão de período
> 
> Medida = SOMA(Total de Pedidos). Selecione a medida que você usou para o cálculo
> 
> Valor da dimensão = Trimestre atual. Uma das variáveis de contexto
> 
> Valor da dimensão do filtro = valor da região atual (dinâmico). Essa é a variável de contexto predefinida
> 
> Argumento do meio = > (maior que)
> 
> Argumento direito = Função valor
> 
> Dimensão = Trimestre(OrderDate). Selecione sua dimensão de período
> 
> Medida = Total(Total de Pedidos). Selecione a medida que você usou para o cálculo
> 
> Valor da dimensão = Trimestre anterior. Uma das variáveis de contexto
> 
> Valor da dimensão do filtro = valor da região atual (dinâmico). Essa é a variável de contexto predefinida  
>   
> ![A caixa de diálogo de condição é aberta, e o conteúdo personalizado é inserido conforme descrito na etapa 12.](/tableau/current/pt-br/server/pt-br/Img/data_stories_context_period_analysis.png)  

1. Para a sentença _diminuída_, defina as mesmas condições, mas substitua o sinal > (maior que) pelo sinal < (menor que). Os argumentos da direita e da esquerda permanecem os mesmos.
2. Clique em Salvar e sua História com dados escreve uma frase que inclui as informações da análise dos dois períodos.

<!-- document id=0bde17be53ffadcff7a5025fcb1a4e2d2d818181192cf354bddebd77de25673c url=/tableau/current/pt-br/server/customize.md -->

[Pular para o conteúdo principal](#main-content)

# Personalizar seu servidor

É possível personalizar as páginas da Web do Tableau Server para sua empresa ou grupo. As seguintes personalizações estão disponíveis:

- Altere o nome do servidor que aparece na guia, nas dicas de ferramenta e nas mensagens do navegador.
- Alterar os logotipos que aparecem no ambiente da Web.
    
    Para obter mais informações, consulte [tsm customize](https://help.tableau.com/current/server/pt-br/cli_customize.htm).
- Defina o idioma usado para o ambiente da Web e a localização usada para as exibições. Consulte [Idioma e localidade do Tableau Server](https://help.tableau.com/current/server/pt-br/lang_intro.htm).
- Instalar fontes personalizadas no Tableau Server e os computadores do cliente que se conectam ao Tableau Server. Consulte [Usar fontes personalizadas no Tableau Server](https://help.tableau.com/current/server/pt-br/customize_fonts.htm).
- Adicionar uma nota personalizada à página de logon do servidor. A configuração de logon permite adicionar texto. Você pode adicionar opcionalmente uma URL para tornar o texto um link. Essa nota também aparecerá se um usuário receber um sinal de erro.
    
    As notas personalizadas não são exibidas no Tableau Mobile. Se o Tableau Server estiver configurado com [grupos de identidade](https://help.tableau.com/current/server-linux/pt-br/identity_pools.htm), a observação Personalização de logon aparece na página inicial do Tableau Server abaixo de todas as opções de logon e na página em que os usuários do pool inicial (TSM configurado) inserem seu nome de usuário e senha.
    
    Para definir uma nota personalizada, entre em um site no Tableau Server. No painel de navegação à esquerda, selecione Gerenciar todos os sites na lista suspensa de sites. Selecione Configurações e adicione uma mensagem para Personalização de logon.
    
    Para obter mais informações, consulte [Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm#SignInCustom).
- Adicione uma mensagem personalizada ao banner de boas-vindas na página inicial para que todos os usuários do servidor a vejam. A mensagem personalizada pode conter até 240 caracteres de texto e hiperlinks, além de uma pausa parágrafo. Os administradores também podem desabilitar o banner de boas-vindas padrão do Tableau para o servidor.
    
    Para definir um banner de boas-vindas personalizado, faça logon em um site no Tableau Server. No painel de navegação esquerdo, selecione Gerenciar todos os sites na lista suspensa do site. Selecione Configurações, em seguida, navegue até a página Personalização.

Os administradores e os líderes de projeto também podem adicionar imagens para os projetos na exibição em miniatura. Para obter mais informações, consulte [Adicionar uma imagem de projeto](https://help.tableau.com/current/server/pt-br/custom_projectimage.htm).

## Outros artigos nesta seção

<!-- document id=fdee0b409d53f25fb2ff04dce66884645e1584a5a0e5341c3a2844f877722ac9 url=/tableau/current/pt-br/server/data_stories_customize.md -->

[Pular para o conteúdo principal](#main-content)

# Personalizar sua história com dados do Tableau

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Você pode usar uma linguagem personalizada, adaptada ao seu público, para complementar suas histórias com dados do Tableau com informações específicas para o seu negócio. Identifique as análises e os dados da história com dados que mais importam para seu público e use sua própria linguagem para criar a história mais impactante. Assim como na História com dados do Tableau geral, os dados e variáveis usados no conteúdo personalizado são dinâmicos, ajustando-se junto com o painel.  

## Adicionar suas próprias informações

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Encontre a seção sobre a qual deseja escrever e clique em Adicionar item personalizado.  
      
    ![Caixa de diálogo Editar história que permite aos usuários escolher quais frases aparecem em uma história](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_add.png)
3. Digite seu texto personalizado no campo que aparece.
4. Clique em Salvar.

## Adicionar cabeçalhos e rodapés

Você pode inserir texto personalizado na parte superior e inferior de sua História com dados. Com cabeçalhos e rodapés, você pode adicionar sua própria análise qualitativa às histórias, incluir explicações adicionais de tendências de dados ou anexar isenções de responsabilidade legais e de privacidade.  
  

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Clique no botão Mostrar nota.
3. Insira sua nota personalizada.  
      
    ![Caixa de diálogo Editar história com a opção Mostrar nota na posição Ligado. A nota personalizada diz "Esta é minha nota personalizada".](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_note.png)
4. Clique em Salvar.

Sua nota agora é exibida na parte superior ou inferior de sua História com dados.  

## Adicionar funções

Usar uma função em sua história com dados é uma ótima maneira de personalizar sua história e encontrar as informações mais importantes para você e sua empresa.

Por exemplo, se você quiser saber a soma média da receita do turismo em um período, selecione Average como sua função e, em seguida, designe a medida como SUM(Turismo nacional). Isso retorna a soma média do turismo nacional.  
  

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Clique no menu no lado direito da caixa e selecione Adicionar função.  
      
    ![Caixa de diálogo Editar história em que uma frase da história é selecionada, para que o menu seja aberto. A opção “Adicionar Função” é destacada.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_add_function.png)
3. Selecione uma Função de História com Dados e preencha os campos obrigatórios.  
      
    ![Um campo aberto para digitar a função e menus suspensos para definir uma função personalizada, dimensão, medida e valor de dimensão de filtro.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_add_function_complete.png)
4. Clique em Adicionar à seção.
5. Clique em Salvar.  
      
    ![Uma história de exemplo que tem uma nota personalizada no rodapé. A nota personalizada é destacada e o restante da história fica na sombra. A nota diz “Soma médio por ano 434,09 bilhões”.](/tableau/current/pt-br/server/pt-br/Img/data_stories_function_story.png)

O conteúdo personalizado agora é exibido em sua história com dados.  
  

## Adicionar condições

Para cada frase personalizada que você escreve, você pode adicionar uma condição que determina se a frase será renderizada em sua História com dados. Se a condição for atendida, a frase personalizada aparecerá em sua história. Se a condição não for atendida, a frase personalizada não aparecerá.  

Você pode aplicar várias condições a cada frase personalizada e as condições podem ser combinadas usando os botões Qualquer ou Todos na caixa de diálogo Adicionar uma condição.

As instruções condicionais são usadas com mais frequência com comparações numéricas, mas a função também oferece suporte à correspondência de strings usando os símbolos igual (=) ou diferente (!=).  
  

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Digite sua frase personalizada.
3. Clique no menu do lado direito da caixa e selecione Adicionar condição.
4. Defina a função personalizada a ser usada para informar a lógica condicional. Neste exemplo, a frase "Atingimos nossa cota" mostra se a Soma de Turismo nacional é maior que 5 trilhões.  
    ![Um campo de texto onde você pode inserir uma condição. Há um botão para “Adicionar condição” e dois campos de fórmula para definir quando a condição é atendida.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_add_condition.png)
5. Clique em Adicionar à seção.
6. Clique em Salvar.

A frase personalizada agora aparece em sua história com dados somente se as condições forem atendidas.  

## Conteúdo personalizado duplicado

Você pode duplicar facilmente o conteúdo personalizado adicionado à sua história com dados, facilitando a criação de diferentes variações de uma frase. Recomendamos copiar uma frase personalizada totalmente construída ao aplicar limites, criar variações de idioma e criar diferentes variações lógicas.  
  

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Crie uma frase personalizada, completa com funções e condições, se desejar.
3. Na caixa de frase concluída, clique no menu à direita da caixa e selecione Duplicar.  
    ![Caixa de diálogo Editar história em que uma frase da história é selecionada, para que o menu seja aberto. A opção “Duplicar” é destacada.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_duplicate.png)
4. Clique na frase duplicada, atualize conforme desejado e clique em Adicionar à seção.
5. Clique em Salvar.

Quando você copia uma frase, todas as funções e instruções condicionais também são copiadas. O marcador copiado aparece diretamente abaixo do marcador original na mesma seção.

**Nota**: os marcadores copiados só podem ser adicionados à seção em que está o marcador original.  

## Adicionar conteúdo personalizado em seções de detalhamento

Para histórias que têm duas dimensões, cada seção após a primeira seção é chamada de seção de pesquisa. as seções de detalhamento se concentram em uma entidade de dimensão primária individual (ou seja, as Américas no exemplo a seguir).  

Como as seções de detalhamento têm a mesma estrutura de conteúdo, o conteúdo personalizado adicionado na primeira seção (ou seja, Europa) é aplicado a cada seção adicional (ou seja, Américas). Você só pode criar ou editar conteúdo na primeira seção de detalhamento.  
  

1. Em sua História com dados, clique em Editar para abrir a caixa de diálogo Editar.
2. Na primeira seção de detalhamento, clique em Adicionar item personalizado a cada entidade.
3. Insira seu conteúdo personalizado.
4. Clique em Salvar.  
      
    ![Caixa de diálogo Editar história que tem um botão que diz "Adicionar item personalizado a cada entidade"](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_drilldown_after.png)

O conteúdo personalizado nas seções de pesquisa já possui uma variável de contexto chamada Valor da categoria atual (dinâmico). Isso cria uma opção de valor de dimensão chamada Valor de categoria atual (dinâmico) que sempre representa a seção sobre a qual a seção de pesquisa se refere.

> [!TIP]
> 
> **Dica:** para criar conteúdo que aparece apenas em uma única seção de detalhamento específica, você pode usar a lógica condicional para garantir que ele seja gravado apenas quando apropriado.

## Outros artigos nesta seção

<!-- document id=d3c701d4636674da3b38eb989a7d21b0fb0ee8887542f7b7bb75a1c2cb0a5081 url=/tableau/current/pt-br/server/data_stories_customize_functions.md -->

[Pular para o conteúdo principal](#main-content)

# Personalizar sua história com dados do Tableau: Funções

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Se você quiser personalizar sua História com dados do Tableau com uma função, é útil saber quais funções você pode usar, o que cada função faz e quais dimensões e medidas serão necessárias para cada função.

Saiba como [Adicionar funções](https://help.tableau.com/current/server/pt-br/data_stories_customize.htm#Add) à sua História com dados.  
  

Clique em uma letra para visualizar as funções que começam com ela. Se nenhuma função começar com essa letra, as funções que começarem com a próxima letra do alfabeto serão mostradas. Também é possível pressionar Ctrl+F (Command-F em um Mac) para abrir a caixa de pesquisa que pode ser usada para pesquisar uma função específica na página.

[A](#A) [B](#C) [C](#C) [D](#D) [E](#E) [F](#F) [G](#G) [H](#H) [I](#I) [J](#L) [K](#L) [L](#L) [M](#M) [N](#N) [O](#P) [P](#P) [Q](#R) [R](#R) [S](#S) [T](#T) [U](#U) [V](#V) [W](#W) [X](#X) [Y](#Y) [Z](#Z)

  

#### Average

Descrição: o valor médio da medida fornecida.

Sintaxe: Average(dimension, Measure, filterDimensionValue)  
  

#### Count

Descrição: o número de valores de dimensão em uma determinada dimensão.

Sintaxe: Count(dimension)  
  

#### Difference

Descrição: a diferença nos valores de medida entre os dois valores de dimensão fornecidos.

Sintaxe: Difference(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue)  
  

#### DifferenceFromMean

Descrição: a diferença entre a média e o valor da medida para o valor de dimensão fornecido.

Sintaxe: DifferenceFromMean(dimension, measure, firstDimensionValue, filterDimensionValue)  
  

#### Direction

Descrição: idioma que descreve a direção (por exemplo, aumentar ou diminuir) entre os valores de medida para os dois valores de dimensão fornecidos.

Sintaxe: Direction(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue, phrase)  
  

#### Ending Label

Descrição: o nome do último período da série.

Sintaxe: Label(measure)  
  

#### EndingValue

Descrição: o valor no último período da série para a medida fornecida.

Sintaxe: EndingValue(medida, filterDimensionValue)  
  

#### Label

Descrição: o rótulo para a medida fornecida.

Sintaxe: Label(measure)  
  

#### LargestNegativeChangeDifference

Descrição: o valor da maior diferença negativa período a período, em base absoluta, na série fornecida.

Sintaxe: LargestNegativeChangeDifference(measure, filterDimensionValue)  
  

#### LargestNegativeChangeEndingLabel

Descrição: o nome do período final para a maior diferença negativa de período a período, em base absoluta, na série fornecida.

Sintaxe: LargestNegativeChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestNegativeChangeEndingValue

Descrição: O valor final da maior diferença negativa entre períodos, em base absoluta, na série fornecida.

Sintaxe: LargestNegativeChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestNegativeChangePercentDifference

Descrição: a variação percentual da maior diferença negativa entre períodos, em base absoluta, na série fornecida.

Sintaxe: LargestNegativeChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestNegativeChangeStartingLabel

Descrição: o nome do período inicial para a maior diferença negativa de período a período, em base absoluta, na série fornecida.

Sintaxe: LargestNegativeChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestNegativeChangeStartingValue

Descrição: o valor inicial da maior diferença negativa período a período, em base absoluta, na série fornecida.

Sintaxe: LargestNegativeChangeStartingValue(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeDifference

Descrição: o valor da maior diferença negativa entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestNegativePercentChangeDifference(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeEndingLabel

Descrição: o nome do período final para a maior diferença negativa entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestNegativePercentChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeEndingValue

Descrição: o valor final da maior diferença negativa entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestNegativePercentChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangePercentDifference

Descrição: a variação percentual da maior diferença negativa entre períodos, em base percentual, na série fornecida.

Sintaxe: LargestNegativePercentChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeStartingLabel

Descrição: o nome do período inicial para a maior diferença negativa de período a período, em uma base percentual, na série fornecida.

Sintaxe: LargestNegativePercentChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeStartingValue

Descrição: o valor inicial da maior diferença negativa entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestNegativePercentChangeStartingValue(measure, filterDimensionValue)  
  

#### LargestPositiveChangeDifference

Descrição: o valor da maior diferença positiva período a período, em base absoluta, na série fornecida.

Sintaxe: LargestPositiveChangeDifference(measure, filterDimensionValue)  
  

#### LargestPositiveChangeEndingLabel

Descrição: o nome do período final para a maior diferença positiva de período a período, em base absoluta, na série fornecida.

Sintaxe: LargestPositiveChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestPositiveChangeEndingValue

Descrição: o valor final da maior diferença positiva período a período, em base absoluta, na série fornecida.

Sintaxe: LargestPositiveChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestPositiveChangePercentDifference

Descrição: a variação percentual da maior diferença positiva de período a período, em base absoluta, na série fornecida.

Sintaxe: LargestPositiveChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestPositiveChangeStartingLabel

Descrição: o nome do período inicial para a maior diferença positiva de período a período, em base absoluta, na série fornecida.

Sintaxe: LargestPositiveChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestPositiveChangeStartingValue

Descrição: o valor inicial da maior diferença positiva período a período, em base absoluta, na série fornecida.

Sintaxe: LargestPositiveChangeStartingValue(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeDifference

Descrição: o valor da maior diferença positiva entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestPositivePercentChangeDifference(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeEndingLabel

Descrição: o nome do período final para a maior diferença positiva de período a período, em uma base percentual, na série fornecida.

Sintaxe: LargestPositivePercentChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeEndingValue

Descrição: o valor final da maior diferença positiva entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestPositivePercentChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangePercentDifference

Descrição: a variação percentual da maior diferença positiva entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestPositivePercentChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeStartingLabel

Descrição: o nome do período inicial para a maior diferença positiva entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestPositivePercentChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeStartingValue

Descrição: o valor inicial da maior diferença positiva entre períodos, em uma base percentual, na série fornecida.

Sintaxe: LargestPositivePercentChangeStartingValue(measure, filterDimensionValue)  
  

#### LongestStreakDifference

Descrição: a diferença na sequência mais longa de aumentos ou diminuições consecutivos para uma determinada série.

Sintaxe: LongestStreakDifference(measure, filterDimensionValue)  
  

#### LongestStreakDirection

Descrição: a direção (positiva ou negativa) da sequência mais longa de aumentos ou diminuições consecutivos para uma determinada série.

Sintaxe: LongestStreakDirection(measure, filterDimensionValue)  
  

#### LongestStreakEndingLabel

Descrição: o nome do período final para a sequência mais longa de aumentos ou diminuições consecutivos para a série especificada.

Sintaxe: LongestStreakEndingLabel(measure, filterDimensionValue)  
  

#### LongestStreakEndingValue

Descrição: o valor final da sequência mais longa de aumentos ou diminuições consecutivos para uma determinada série.

Sintaxe: LongestStreakEndingValue(medida, filterDimensionValue)  
  

#### LongestStreakLength

Descrição: o maior número de períodos de aumento ou diminuição consecutivos para uma determinada série.

Sintaxe: LongestStreakLength(measure, filterDimensionValue)  
  

#### LongestStreakPercentDiference

Descrição: a diferença percentual na sequência mais longa de aumentos ou diminuições consecutivos para uma determinada série.

Sintaxe: LongestStreakPercentDifference(measure, filterDimensionValue)  
  

#### LongestStreakStartingLabel

Descrição: o nome do período inicial para a sequência mais longa de aumentos ou diminuições consecutivos para uma determinada série.

Sintaxe: LongestStreakStartingLabel(measure, filterDimensionValue)  
  

#### LongestStreakStartingValue

Descrição: o valor inicial da sequência mais longa de aumentos ou diminuições consecutivos para uma determinada série.

Sintaxe: LongestStreakStartingValue(measure, filterDimensionValue)  
  

#### MaxLabel

Descrição: o nome da entidade com o valor máximo para a medida fornecida.

Sintaxe: MaxLabel(dimension, measure, filterDimensionValue)  
  

#### MaxValue

Descrição: o valor máximo para a medida fornecida.

Sintaxe: MaxValue(measure)  
  

#### Median

Descrição: o valor mediano para a medida fornecida.

Sintaxe: Median(dimension, measure, filterDimensionValue)  
  

#### MinLabel

Descrição: o nome da entidade com o valor mínimo para a medida fornecida. Sintaxe: MinLabel(dimension, measure, filterDimensionValue)  
  

#### MinValue

Descrição: o valor mínimo para a medida fornecida.

Sintaxe: MinValue(dimension, measure, filterDimensionValue)  
  

#### PercentDifference

Descrição: a diferença percentual nos valores de medida entre os dois valores de dimensão fornecidos.

Sintaxe: PercentDifference(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue)  
  

#### PercentOfWhole

Descrição: a porcentagem em valores de medida para um determinado valor de dimensão sobre o total de valores de medida para essa dimensão.

Sintaxe: PercentOfWhole(dimension, measure, dimensionvalue, filterDimensionValue)  
  

#### PeriodLabel

Descrição: o nome do enésimo período da série, começando em 1.

Sintaxe: PeriodLabel(index)  
  

#### PeriodLabelNewest

Descrição: o nome do enésimo período da série, começando no mais novo e contando para trás.

Sintaxe: PeriodLabelNewest(index)  
  

#### PeriodValue

Descrição: o valor da medida fornecida no enésimo período da série, começando em 1.

Sintaxe: PeriodValue(measure, index, filterDimensionValue)  
  

#### PeriodValueNewest

Descrição: o valor da medida fornecida no enésimo período da série, começando no mais novo e contando para trás.

Sintaxe: PeriodValueNewest(measure, index)  
  

#### Range

Descrição: a diferença entre os valores máximo e mínimo para a medida fornecida.

Sintaxe: Range(dimension, measure, filterDimensionValue)  
  

#### SortAscendingLabel

Descrição: o nome da entidade da medida fornecida classificada em ordem decrescente na classificação fornecida (começando em 1).

Sintaxe: SortAscendingLabel(measure, rank, dimension, filterDimensionValue)  
  

#### SortAscendingValue

Descrição: o valor da medida fornecida classificada em ordem crescente na classificação fornecida (começando em 1).

Sintaxe: SortAscendingValue(medida, rank, dimension, filterDimensionValue)  
  

#### SortDescendingLabel

Descrição: o nome da entidade da medida fornecida classificada em ordem decrescente na classificação fornecida (começando em 1).

Sintaxe: SortDescendingLabel(measure, rank, dimension, filterDimensionValue)  
  

#### SortDescendingValue

Descrição: o valor da medida fornecida classificada em ordem decrescente na classificação fornecida (começando em 1).

Sintaxe: SortDescendingValue(medida, rank, dimension, filterDimensionValue)  
  

#### StartingLabel

Descrição: o nome do primeiro período da série.

Sintaxe: StartingLabel()  
  

#### Valor inicial

Descrição: o valor no primeiro período da série para a medida fornecida.

Sintaxe: StartingValue(measure, filterDimensionValue)  
  

#### StartToFinishDifference

Descrição: a diferença entre os valores do primeiro e do último período na série fornecida.

Sintaxe: StartToFinishDifference(measure, filterDimensionValue)  
  

#### StartToFinishPercentDifference

Descrição: a diferença percentual entre os valores do primeiro e do último período na série fornecida.

Sintaxe: StartToFinishPercentDifference(measure, filterDimensionValue)  
  

#### StdDev

Descrição: o valor do desvio padrão para a medida fornecida.

Sintaxe: StdDev(dimension, measure, filterDimensionValue)  
  

#### Sum

Descrição: a soma dos valores de medida para os dois valores de dimensão fornecidos.

Sintaxe: Sum(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue)  
  

#### Total

Descrição: o valor total da soma para a medida fornecida.

Sintaxe: Total(dimensão, medida, filterDimensionValue)  
  

#### Valor

Descrição: o valor da métrica para uma determinada dimensão, medida e valor de dimensão.

Sintaxe: Value(dimension, measure, dimension value, filterDimensionValue)  
  

#### Z-Score

Descrição: a pontuação z para a medida fornecida.

Sintaxe: Z-Score(dimension, measure, firstDimensionValue, filterDimensionValue)

<!-- document id=41d4c97206e0fd33c2694dd74b0fbfc11bcfc2a6e02b1d8f919c65805db58abb url=/tableau/current/pt-br/server/data_stories_customize_hide_reorder.md -->

[Pular para o conteúdo principal](#main-content)

# Personalizar sua história com dados do Tableau: ocultar e reordenar o conteúdo

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Personalize sua História com dados do Tableau com o conteúdo mais importante para você e seu público, ocultando ou reordenando o conteúdo em sua história.

## Ocultar conteúdo e seções

1. Crie sua História com dados e clique em Editar para abrir a caixa de diálogo Editar.
2. Defina seções para mostrar ou ocultar clicando no botão Mostrar seção para a posição ligado ou desligado.
3. Passe o mouse sobre a caixa azul à direita de cada frase individual e clique na caixa para mostrar ou ocultar da visualização.
4. Clique em Salvar.  
      
    ![Caixa de diálogo Editar história onde três frases estão ocultas.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_hideshow.png)

Agora, apenas as frases e seções definidas como Mostrar aparecem em sua história com dados.

## Reordenar o conteúdo em uma seção  

1. Crie sua História com dados e clique em Editar para abrir a caixa de diálogo Editar.
2. Passe o mouse sobre o menu do lado esquerdo do conteúdo que você deseja reordenar. Seu cursor se transforma em um ícone de mão.
3. Clique no item com o cursor e arraste-o para qualquer lugar dentro da mesma seção.
4. Clique em Salvar.  
      
    ![Caixa de diálogo Editar história com um ícone de cursor (mão) pairando sobre uma frase a ser clicada e arrastada.](/tableau/current/pt-br/server/pt-br/Img/data_stories_custom_reorder.png)

Agora, as frases aparecem em sua História com dados na ordem em que você as definiu.  

**Nota:** atualmente, o conteúdo só pode ser movido dentro da mesma seção. A movimentação de seções inteiras ainda não é aceita.

<!-- document id=151f83afe58f89ae222a2f00a742b269914999b4e7950f3cde7c54d50ce85c25 url=/tableau/current/pt-br/server/server_process_search-n-browse.md -->

[Pular para o conteúdo principal](#main-content)

# Pesquisa e navegação no Tableau Server

**Observação:** a partir da versão 2023.3, Pesquisar e navegar foi descontinuado (não está mais instalado). Ele foi substituído pelo [Index and Search Server](https://help.tableau.com/current/server/pt-br/server_process_index-and-search.htm).  
  
A partir da versão 2022.3, Pesquisar e navegar está obsoleto (instalado, mas não é mais usado pelo Tableau Server). Se estiver executando o Tableau Server versão 2022.3 ou 2023.1, você _não deve configurar mais de uma instância de Pesquisar e Navegar_ para qualquer instalação. Em casos raros, configurar mais de uma instância pode resultar em problemas de estabilidade.

O processo de Pesquisa e navegação, com base no Apache SOLR (no Tableau Server versão 2020.4 e em versões anteriores), e também conhecido como searchserver, controla a pesquisa rápida, o filtro, a recuperação e a exibição de metadados de conteúdo do site do Tableau Server. Para configurar alta disponibilidade para o processo de Pesquisa e Navegação, configure o processo em vários nós. A partir da versão 2021.1 do Tableau Server, a funcionalidade do processo de Pesquisa e Navegação é aprimorada pelo Serviço de exploração de conteúdo. Para obter mais informações, consulte [Serviço de exploração do conteúdo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_content-exploration.htm).

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Search &amp; Browse</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Search &amp; Browse é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Search &amp; Browse são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>searchserver</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha em um processo de Pesquisa e navegação? Os usuários ainda podem entrar no Tableau Server, mas o conteúdo da pasta de trabalho parecerá ausente. O conteúdo não está realmente ausente. Em vez disso, o conteúdo não está sendo retornado nos resultados da pesquisa; ele será exibido novamente após a reinicialização do processo de Pesquisa e navegação.

Se mais de um processo de Pesquisa e navegação for configurado e executado em vários nós quando a falha ocorrer, também ocorrerá falha nas solicitações feitas em um processo de Pesquisa e navegação com falha, mas as solicitações subsequentes serão encaminhadas para os processos de Pesquisa e navegação em funcionamento. Cada processo de Pesquisa e navegação é indexado em todos os nós do cluster, portanto, se todos os processos de Pesquisa e navegação falharem, os resultados ainda serão retornados em todos os nós.

## Ajuste do processo de Pesquisa e navegação

Existem várias maneiras de alterar o funcionamento do processo de Pesquisa e navegação no Tableau Server. Na maioria dos casos, você não precisa mudar nada, mas estas são algumas alterações de configuração que você pode fazer.

### Memória máxima da pilha de Pesquisa e navegação

É possível configurar as opções de Pesquisa e navegação usando a chave de configuração `searchserver.javamemopts`. A configuração mais importante que pode ser realizada é a que controla o tamanho da memória máxima da pilha e é especificada pela opção `-Xmx`. Por padrão, isso é definido pelo Tableau com base na memória física disponível para o nó do servidor que executa o serviço de Pesquisa e navegação. O valor deve ser definido o mais alto possível, com base na memória física disponível e no uso da memória, mas não deve ser superior a 24 GB.

Ao alterar o volume de memória máxima, você precisa levar em conta quaisquer outros serviços no sistema. Se você estiver com pouca memória no computador que executa o Tableau Server, deve considerar adicionar mais memória ou reduzir a topologia na máquina. Se você estiver executando a Pesquisa e navegação em um nó com poucos outros processos ou com grande volume de memória física, pode considerar aumentar o volume usado pelo serviço de pesquisa. Se você estiver executando a Pesquisa e navegação em um nó com um número de processos maior do que o padrão, deve considerar diminuir a alocação de memória máxima da pilha para evitar que o serviço tente usar mais memória do que está disponível.

#### Alocações de memória máxima da pilha padrão

A tabela abaixo mostra o volume _padrão_ de memória da pilha que o Tableau aloca para Pesquisa e navegação em um nó de servidor, com base na memória disponível:

| Memória do sistema | Memória da pilha SOLR |
| --- | --- |
| <= 16 GB | 1 GB |
| <= 32 GB | 2 GB |
| <= 64 GB | 4 GB |
| <= 128 GB | 8 GB |
| \> 128 GB | 16 GB |

Para alterar o valor de memória máxima da pilha, defina o valor `-Xmx` de `searchserver.javamemopts` usando o comando `tsm configuration set`.

Primeiro obtenha os valores atuais:

**C:\\WINDOWS\\system32>**tsm configuration get -k searchserver.javamemopts
-Xmx512m -Xms512m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData

Em seguida, altere o valor da opção `-Xmx`. Inclua, mas não altere todas as outras opções:

tsm configuration set -k searchserver.javamemopts -v "**\-Xmx8g** -Xms512m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData"

Para obter mais detalhes sobre a chave de configuração `searchserver.javamemopts`, consulte [searchserver.javamemopts](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#searchserver_javamemopts).

### Tempos limite da sessão do cliente

É possível configurar quanto tempo os clientes de Pesquisa e navegação aguardarão para estabelecer uma conexão com o servidor de Pesquisa e navegação e com o Serviço de coordenação (Zookeeper). Ambos os valores de tempo limite são definidos como valores relativamente altos, mas se você tiver problemas de navegação no conteúdo do servidor e em registros do Vizportal e do processador em segundo plano mostrarem tempos limite ao conectar-se ao SOLR, tente aumentar essas configurações. Se isso não causar impacto, você pode estar com recursos limitados no computador do Tableau Server.

searchserver.connection\_timeout\_milliseconds

searchserver.zookeeper\_session\_timeout\_milliseconds

Para alterar os valores, use o comando `tsm configuration set`:

tsm configuration set -k searchserver.connection\_timeout\_milliseconds -v 

Para obter mais detalhes sobre a chave de configuração `searchserver.connection_timeout_milliseconds`, consulte [searchserver.connection\_timeout\_milliseconds](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#searchserver_cx_timeout_ms).

### Tempo limite da verificação de integridade da conexão do Zookeeper na inicialização

Quando o Tableau Server está sendo ligado, muitos recursos são consumidos, especialmente relacionado à utilização da CPU. Se a Pesquisa e navegação não fizer uma conexão com o Serviço de coordenação (Zookeeper), ocorrerá uma falha na inicialização. Para funcionar nesse contexto, o Tableau Server realiza uma verificação de integridade no Serviço de coordenação, antes de iniciar a Pesquisa e navegação.

Se o computador do Tableau Server estiver especialmente ocupado ou se a Pesquisa e navegação não for iniciada, aumente esse valor de tempo limite.

Um erro é gravado nos arquivos control-searchserver.log quando ocorre uma falha nessa verificação de integridade: `Failed zookeeper health check. Refusing to start SOLR.`

Para aumentar o tempo que o Tableau Server aguarda por uma verificação de integridade bem-sucedida, defina o valor de `searchserver.startup.zookeeper_healthcheck_timeout_ms` usando o comando `tsm configuration set`.

tsm configuration set -k searchserver.startup.zookeeper\_healthcheck\_timeout\_ms -v <nnnnnn>

Para obter mais detalhes sobre a chave de configuração `searchserver.startup.zookeeper_healthcheck_timeout_ms`, consulte [searchserver.startup.zookeeper\_healthcheck\_timeout\_ms](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#searchserver_zk_healthchk).

<!-- document id=cc0c2aa516db691f7f167db75b86e01d3ab0cbdc22b165785bcb8c7a2df8be3c url=/tableau/current/pt-br/server/plan.md -->

[Pular para o conteúdo principal](#main-content)

# Planejamento da sua implantação

Os artigos desta seção fornecem informações sobre o planejamento de uma implantação do Tableau Server.

Além de consultar os artigos nesta seção, recomendamos consultar o [Tableau Blueprint](https://help.tableau.com/current/blueprint/pt-br/bp_overview.htm) como uma primeira etapa no fluxo de trabalho de planejamento. O Tableau Blueprint é um guia passo a passo para que sua organização se torne baseada em dados.

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Outros artigos nesta seção

<!-- document id=60cb3430f9d6ee88d17cc9d106b93328342a3baf585a0534fd5ab548274752e6 url=/tableau/current/pt-br/server/server_infrastructure_planning.md -->

[Pular para o conteúdo principal](#main-content)

# Planejamento de infraestrutura

Antes de instalar o Tableau Server, examine os requisitos de disco, as configurações recomendadas, as contas de usuário, a segurança e os requisitos de rede.

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Outros artigos nesta seção

<!-- document id=9b3ec5c70b840eba3e891b67e3371fd539446796a5ccb72d4970acc5d5602fad url=/tableau/current/pt-br/server/site_admin_planning.md -->

[Pular para o conteúdo principal](#main-content)

# Planejamento de um site

Antes de adicionar usuários e conteúdo em um site, recomendamos que os seguintes aspectos do site sejam planejados:

- [Projetos](#projects)
- [Usuários e grupos](#users-and-groups)
- [Funções e permissões de sites](#site-roles-and-permissions)
- [Agendas de atualização da extração](#extract-refresh-schedules)

As seções subsequentes descrevem esses componentes do site, pressupondo que você já esteja familiarizado com eles.

**Observação:** este artigo e seção se aplicam somente às implantações do Tableau Server que você mantém, locais ou na nuvem. Se for usuário do Tableau Cloud, consulte [Gerenciar acesso ao conteúdo](https://help.tableau.com/current/online/pt-br/permissions_section.htm "Vá para a ajuda do Tableau Cloud (abre uma nova guia no browser)").

## Projetos

É possível criar projetos em um site, que agem como contêineres nos quais é possível organizar ativos de conteúdos relacionados (como fontes de dados e pastas de trabalho). Por exemplo, você pode configurar um projeto para conter todas as fontes de dados e pastas de trabalho certificadas que a sua empresa usa em decisões de missão crítica. Ou pode criar projetos por departamentos.

Os projetos também são úteis para gerenciar permissões. Uma vez informado de como os seus usuários precisam acessar o conteúdo, torna-se mais fácil criar projetos baseados nesse tipo de conteúdo e manter as permissões no nível do projeto.

Cada site tem um projeto padrão denominado **Padrão**. Ao criar projetos, os novos projetos herdam as permissões iniciais do projeto padrão. Na prática, o projeto padrão é um modelo para novos projetos nesse site. Conforme explicamos nos artigos relacionados, para a maioria dos ambientes, recomendamos que o projeto Padrão seja utilizado apenas como um modelo de permissões e não como um contêiner para o conteúdo publicado.

Para obter mais informações, consulte [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm).

## Usuários e grupos

Qualquer usuário que publicará conteúdo ou acessará conteúdo publicado em um site deve ser capaz de fazer logon no mesmo. Se o usuário já tiver uma conta no servidor, você precisará adicioná-lo ao site apropriado. Você também pode adicionar um usuário a mais de um site. Se o usuário ainda não existe, será preciso criá-lo. De qualquer maneira, faça uma lista dos usuários que precisarão fazer logon em cada site.

**Observação:** a licença de servidor pode restringir quantos usuários você pode ter ou que nível de acesso eles podem ter. Verifique com o administrador de servidor para garantir que você poderá ter uma conta para todos os seus usuários.

No geral, recomendamos criar grupos no servidor e adicione usuários aos grupos. Isso ajuda a simplificar o gerenciamento das permissões. Você pode atribuir permissões aos grupos, para concedê-las a todos os usuários no grupo. (Veja a próxima seção).

Uma estratégia comum é criar grupos para usuários que usam o conteúdo de maneiras similares. Por exemplo, você pode criar um grupo chamado VendasPTPublicadores para todos os usuários no departamento de vendas que publicam pastas de trabalho, e um grupo separado chamado VendasFDPublicadores para os usuários de Vendas que publicam fontes de dados. Cada um desses conjuntos de usuários precisa do próprio conjunto de recursos, então faz sentido ter um grupo para cada para essas necessidades.

## Funções e permissões de sites

Cada usuário tem uma _função de site_ determina o máximo de permissões que um usuário pode ter. Como parte do planejamento do seu site, você precisa decidir a função de site de cada usuário. Um usuário com uma função de site muito restritiva pode não ser capaz de fazer o trabalho que precisa. Da mesma forma, uma prática recomendada de segurança é limitar os recursos dos usuários aos necessários para fazer o trabalho. Isso é conhecido como seguir o princípio do _menor privilégio_.

Você ou um administrador de site ao qual você delegou essa tarefa deve determinar as permissões que um usuário precisa para trabalhar com conteúdo. Cada ativo de conteúdo (pasta de trabalho, fonte de dados, projeto) oferece suporte a um conjunto de _recursos_. Por exemplo, você pode **Visualizar** ou **Adicionar comentários** a uma pasta de trabalho. Antes de um usuário realizar tarefas em uma pasta de trabalho, suas permissões devem permitir esses recursos. Uma prática recomendada é desenhar um mapeamento das permissões aos usuários fora do Tableau, antes de você tentar configurar isso no servidor.

As permissões determinam o que um usuário pode fazer _dentro do contexto de uma função de site_. Um usuário cuja função no site é **Viewer** nunca poderá publicar no site, independente das permissões concedidas a ele. Um usuário cuja função no site é **Creator** pode publicar uma pasta de trabalho no site, mas apenas se esse usuário tiver permissão para salvar e exibir pastas de trabalho.

## Agendas de atualização da extração

Se os usuários publicarem fontes de dados ou pastas de trabalho que incluem extrações, é recomendado verificar se as extrações estão atualizadas e contêm os dados mais recentes. Os usuários podem atualizar uma extração manualmente, mas isso não é recomendado no caso de uma grande extração, pois pode levar muito tempo. Em vez disso, configure as agendas para quando uma extração deve ser atualizada. Outra tarefa de planejamento do administrador de site é, portanto, pensar em quando as extrações devem ser atualizadas e configurar agendas.

<!-- document id=be0fc4e708969ac83dc08301b62c5d1dc58ff17e8fbdaac82b7084ba90d998b3 url=/tableau/current/pt-br/server/cmt-plan_datasources.md -->

[Pular para o conteúdo principal](#main-content)

# Planos de migração: fontes de dados publicadas

A próxima etapa da fase de criação de um plano de migração no Content Migration Tool do Tableau é selecionar, mapear e adicionar as transformações às fontes de dados publicadas. O processo é muito semelhante à etapa Pastas de trabalho da fase de planejamento, principalmente a etapa de mapeamento da fonte de dados.

**Observação:** se as pastas de trabalho ou fontes de dados incluírem extrações, leia e compreenda as informações em [Migrar pastas de trabalho e fontes de dados com extrações](https://help.tableau.com/current/server/pt-br/cmt-migration_extracts.htm).

## Etapa 1: seleção

Iniciando a fase Fontes de dados publicadas do plano de migração, você selecionará quaisquer fontes de dados que desejar incluir no plano de migração:

![Seleção de fonte de dados para mapeamento de dados.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-datasource-selection.png)

As fontes de dados serão selecionadas somente no momento da migração. Existem dois métodos de seleção. Usar Specific Data Sources para escolher uma ou mais fontes de dados publicadas. Clique em Refresh para recarregar a lista de fontes de dados publicadas.

A segunda opção é All Data Sources, que seleciona todas as fontes de dados no site de origem.

## Etapa 2: mapeamento

A próxima etapa é mapear suas fontes de dados de origem para o novo destino. É semelhante à funcionalidade do mapeamento das pastas de trabalho.

![Página de mapeamento de fonte de dados com menu suspenso para adicionar mapeamento.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-datasource-mapping.png)

Se você não fizer alterações aqui, as fontes de dados selecionadas simplesmente serão implantadas com o mesmo nome e projeto que a origem. Para adicionar o mapeamento da fonte de dados, clique em Add Mapping. As opções a seguir aparecerão na área de mapeamento.

![Um formulário com campos para nome, projeto, nome de destino e projeto de destino.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-datasource-mapping-options.png)

A entrada tem as seguintes opções:

### Excluir

Clicar no link Delete excluirá esta entrada de mapeamento.

### Nome

Utilize o menu Name para selecionar a fonte de dados que deseja mapear. É possível selecionar (All Selected Data Sources) para escolher todas as fontes de dados.

### Projeto

O Project é o projeto dos nomes da fonte de dados associados.

### Nome de destino

Por padrão, o Content Migration Tool usará o mesmo Destination Name(Same As Source), mantendo o nome original no arquivo de origem, mas você pode digitar um novo nome aqui para a pasta de destino.

### Projeto de destino

Se seus projetos de destino já foram criados em seu site, você pode escolher em qual projeto colocar suas pastas de trabalho migradas ou clicar em Add New para criar um novo projeto. Você pode criar diferentes destinos do projeto para fontes de dados individuais.

![Um formulário para adição ou modificação de fontes de dados, com campos para nome, projeto, nome de destino e processo de destino.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-datasource-mapping-dest-proj.png)

Na maioria das situações, se houver várias entradas de mapeamento para uma única fonte de dados, um erro de validação será exibido e deverá ser corrigido para continuar. Há uma exceção importante para isso: uma fonte de dados pode corresponder a uma seleção específica e a uma entrada de mapeamento de todo o projeto. Nesta instância, a entrada mais específica será usada.

Ao concluir todo o mapeamento necessário da fonte de dados, clique em Next para continuar.

![Um ícone Próximo.](/tableau/current/pt-br/server/pt-br/Img/cmt-icon-next.png)

## Etapa 3: transformações da fonte de dados

É possível modificar suas fontes de dados utilizando a opção de transformação. Clique em Add Transformation para ver a lista de transformações disponíveis.

![Um menu suspenso para adicionar uma transformação.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-transform-add-list.png)

Selecionar qualquer transformação da fonte de dados abre a janela Edit Transformation. Use isso para personalizar as fontes de dados selecionadas. As transformações são executadas na ordem em que são listadas, de cima para baixo.

Para a maioria das transformações de fonte de dados, há duas etapas básicas. A primeira etapa é inserir os Match Criteria para a fonte de dados desejada. Dependendo de qual tipo de conexão você selecionar, mais campos aparecerão na guia Match Criteria.

![Uma caixa de diálogo para editar uma transformação.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-transform-edit-match.png)

A segunda etapa depende do tipo de transformação que você está adicionando. Cada uma das transformações da fonte de dados tem valores diferentes a serem inseridos na segunda guia.

Você pode incluir notas na seção Comments à esquerda da janela Edit Transformation para cada uma das transformações que adicionar.

### Substituir Nome de tabela/esquema

Na guia Options, é possível substituir toda ou parte do nome de uma tabela ou de um esquema.

### Definir fórmula de cálculo

Na guia New Calculation Formula, você pode substituir o cálculo de uma coluna.

![Interface para definir uma fórmula em uma configuração de transformação de coluna.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-datasource-transform-set-calc.png)

### Definir informação de conexão

Na guia Novos valores de conexão, insira o método de autenticação e os detalhes da conexão para a nova fonte de dados. Dependendo de qual tipo de conexão você selecionar, mais campos aparecerão

![Um campo de texto denominado “Caminho do arquivo”.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-datasource-transform-set-cx.png)

### Definir SQL personalizado

Na guia Novo SQL personalizado, insira o nome da consulta SQL personalizada que você deseja modificar para Corresponder nome da consulta. O nome da consulta deve corresponder ao nome da consulta SQL personalizada da camada física da fonte de dados. Se esses nomes não corresponderem, a transformação falhará. Para obter mais informações sobre a modelagem de dados e a camada física, consulte [O modelo de dados do Tableau](https://help.tableau.com/current/server/pt-br/datasource_datamodel.htm).

Depois de inserir o nome da consulta, insira o SQL personalizado desejado no campo de texto. Esteja ciente de que o SQL personalizado pode afetar negativamente o desempenho de suas pastas de trabalho, se usado incorretamente.

![Uma caixa de texto chamada “Corresponder nome da consulta” e uma caixa de texto maior chamada “SQL personalizado”.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-transform-set-custom-sql.png)

### Remover extração

Não há a guia Options para essa transformação. Digite as informações de Match Criteria e a extração será removida durante a migração.

### Usar o Tableau Bridge

Não há a guia Options para essa transformação. Digite as informações e fontes de dados de Match Criteria que estejam dentro de uma rede privada (inacessível à Internet pública) e poderão ser atualizadas com o Tableau Bridge.

O site de destino do Tableau Cloud deve estar com o Tableau Bridge configurado, antes de migrar fontes de dados. Para obter informações sobre o Tableau Bridge, consulte [Usar o Tableau Bridge](https://help.tableau.com/current/online/pt-br/data_fresh_sync_section.htm) na Ajuda do Tableau Cloud. Após a migração, as fontes de dados precisarão receber uma agenda de atualização pelo Tableau Cloud.

### Aplicar credenciais salvas

Obsoleto na versão 2022.3. Em vez disso, use a transformação de fonte de dados Definir informações de conexão.

Na guia de opções, insira o Nome de usuário do Tableau e o Nome de usuário de credenciais salvas correspondente para a conexão de dados. Você só pode aplicar credenciais salvas para conexões de dados existentes na página Configurações de conta no site do Tableau. Para obter mais informações, consulte [Gerenciar credenciais salvas para as conexões de dados](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm).

![Duas caixas de texto solicitam um nome de usuário do Tableau e um nome de usuário com credenciais salvas.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-datasource-transform-saved-credentials.png)

## Etapa 4: opções de publicação

A etapa final da fase Fonte de dados publicadas é criar transformações para permissões e marcas e finalizar as opções de publicação específicas das fontes de dados.

![A caixa de diálogo Opções de publicação da fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-pub-options.png)

#### Substituir fontes de dados mais recentes

Se selecionada, uma fonte de dados será publicada mesmo que substitua uma fonte de dados que foi atualizada mais recentemente.

#### Copiar permissões de fonte de dados

Quando selecionada, a ferramenta de migração tentará corresponder as permissões da fonte de dados publicada de origem o mais próximo possível.

#### Copiar Agendas de atualização de extrações

Quando selecionada, a ferramenta de migração tentará definir a agenda de atualização de extração de fonte de dados de destino para agendamentos correspondentes ao nome da origem.

**Obsevação:** os agendamentos de atualização de extração não podem ser criados no Tableau Cloud. Esta opção não está disponível se o destino for um site do Tableau Cloud. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

#### Copiar credenciais inseridas para fontes de dados

Copie as credenciais inseridas para fontes de dados publicadas. Disponível apenas ao migrar do Tableau Server para sites do Tableau Cloud. Para obter mais informações, veja [Migrar pastas de trabalho e fontes de dados com credenciais inseridas](https://help.tableau.com/current/server/pt-br/cmt-migration_embedded_credentials.htm).

**Observação:** o CMT não oferece suporte à migração de credenciais inseridas para conexões OAuth. Para migrar o OAuth as credenciais inseridas no site de destino, use a transformação de fonte de dados [Definir informações de conexão](#plan_datasrc_trans).

#### Copiar proprietário de fonte de dados

Copie as configurações do proprietário da fonte de dados do local de origem para atribuir o proprietário da fonte de dados. Se não for selecionado, o usuário do Content Migration Tool recebe a propriedade da fonte de dados no local de destino.

#### Aplicar mapeamentos de usuários

Aplique mapeamentos de usuário para atribuir propriedade de conteúdo. Selecione esta opção se houver diferenças na sintaxe do nome de usuário no local de destino. Para obter mais informações, consulte [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm).

### Opções de adição

Clique no menu suspenso Add Option para os diferentes tipos de transformações que você pode adicionar:

![Um menu suspenso para adicionar ou remover marcas, aplicar agendamentos de atualização de extração ou definir permissões.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-pub-options-add.png)

Para todos os tipos diferentes de transformações, há duas etapas básicas. A primeira etapa é criar sua seleção para a transformação. Nesse caso, selecione a fonte de dados que você deseja transformar. Na parte superior da lista, você pode selecionar Apply to all published data sources, que é uma opção para selecionar automaticamente todas as fontes de dados para transformações futuras. Você também pode Refresh a janela de exibição da fonte de dados para refletir as alterações ou atualizações no site de origem.

![Uma caixa de diálogo para definir permissões no nível da fonte de dados publicada.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-pub-perms.png)

A segunda etapa é inserir as seleções específicas da transformação selecionada.

### Remover marcas

Após selecionar as fontes de dados das quais deseja remover marcas, digite as marcas que deseja remover no campo na parte inferior e clique em Add. Nesta tela, você também pode optar por remover das fontes de dados de origem ou de destino. Se desejar remover uma marca inserida anteriormente, clique nela e pressione a tecla Excluir.

![Uma caixa de diálogo para remover marcas de fontes de dados publicadas.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-pub-tags-remove.png)

### Adicionar marcas

Após selecionar as fontes de dados desejadas, insira as marcas que deseja atribuir no campo na parte inferior e clique em Add. Se desejar remover uma marca, clique nela e pressione a tecla Excluir.

![Um diálogo para adicionar marcas a fontes de dados publicadas.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-pub-tags-add.png)

Além disso, em cada uma das transformações, é possível inserir anotações na seção Comments no lado esquerdo da janela Editar transformação.

### Aplicar agendas de atualização de extração

Essa transformação aplica agendamentos de atualização de extração de destino a fontes de dados migradas. A lista de agendas geradas é do destino.

**Obsevação:** os agendamentos de atualização de extração não podem ser criados no Tableau Cloud. Esta opção não está disponível se o destino for um site do Tableau Cloud. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

![Uma caixa de diálogo para aplicar um agendamento de atualização de extração.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-pub-extract-sched.png)

### Definir permissões

O último tipo de transformação é editar as permissões das fontes de dados selecionadas. Insira um Grupo ou Usuário e clique em Add. Ajuste as permissões conforme desejado. As quatro opções diferentes são Allow a permissão, Deny a permissão, Inherit ou manter o Source Value.

![Uma caixa de diálogo para definir permissões no nível da fonte de dados publicada.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-pub-perms-new.png)

## Etapa 5: continuar para a próxima etapa

Quando estiver pronto, clique em Nextpara ir para a seção [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm) da fase de planejamento.

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=a20fea3d77a14ac6ae4795b5aa26f6096850c179ee1d438dd1dfd56baf650bee url=/tableau/current/pt-br/server/cmt-plan_options.md -->

[Pular para o conteúdo principal](#main-content)

# Planos de migração: opções de planejamento

A última etapa da criação de um plano de migração no Content Migration Tool do Tableau é a configuração das opções de plano.

## Etapa 1: Configurar opções

![Configurações para opções de plano, incluindo extratos de atualização, tratamento de erros e criação automática de agendamentos](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-options02.png)

O Plan Name é o nome do plano como ele aparecerá no Content Migration Tool. É recomendado utilizar um nome de usuário amigável para o seu plano.

Seguem as opções disponíveis:

- Refresh Extracts After MigrationSe selecionada, as extrações de dados serão atualizadas imediatamente após a migração se o Content Migration Tool detectar que teriam sido modificadas durante a migração. Clique no link Filter para excluir trechos específicos. Para obter mais informações, consulte [Excluir as atualizações da extração](#exclude-extract-refreshes) abaixo.
- Automatically create Extract Refresh Schedules that do not Exist: Cria automaticamente agendas de extração de destino inexistentes. Se a opção não estiver selecionada, as agendas de origem que não existem no servidor de destino não serão copiadas.
- Continue Migration if Workbook or Data Source Fails: se marcada, os erros de migração de uma pasta de trabalho ou fonte de dados não farão com que a migração pare. Os erros serão registrados e a migração continuará. Erros durante o controle da versão sempre interromperão a migração.
- Continuar a migração se o mapeamento de permissão ou propriedade falhar: se marcado, erros ao copiar permissões ou propriedade não farão com que a migração pare. Os erros serão registrados e a migração continuará.

### Excluir atualizações de extração

Clicando Filtro ao lado de Atualizar extrações após a migração, você pode escolher as pastas de trabalho ou fontes de dados publicadas que não serão atualizadas automaticamente. Use os botões de seta para selecionar os itens que deseja excluir e clique emOK.

![Controle de versão para arquivar pastas de trabalho e fontes de dados publicadas, juntamente com onde arquivá-las.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-options-exclude-extract-refresh.png)

## Etapa 2: controle de versão

Essas opções permitem evitar a perda das pastas de trabalho existentes no site de destino que podem ser substituídas pelas pastas de trabalho migradas.

![Controle de versão para arquivar pastas de trabalho e fontes de dados publicadas, juntamente com onde arquivá-las.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-options-version-control.png)

Selecione Enable para salvar versões anteriores do seu conteúdo. Você pode optar por arquivar pastas de trabalho e/ou fontes de dados publicadas. Quando o controle de versão é ativado, você precisa selecionar um projeto no menu Archive To que lista todos os projetos no seu site de destino. Recomendamos a criação de um projeto de arquivo separado para armazenar seu conteúdo com versão. Clique no botão atualizar para exibir todos os projetos que foram adicionados ou modificados no site.

## Etapa 3: salvar plano

Depois de selecionar as opções do plano, clique em Save Plan para salvar seu plano para uso futuro. O plano será salvo na pasta `Documents\Tableau Content Migration Tool Plans` na sua máquina local.

## Etapa 4: continuar para a próxima etapa

Quando estiver pronto, clique em Verify & Run para encerrar a fase de Planejamento e preparar-se para executar o plano.

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=f025335944d79e7becded2735f829c796df99f48db9625c6075f3517cd41a78e url=/tableau/current/pt-br/server/cmt-plan_workbooks.md -->

[Pular para o conteúdo principal](#main-content)

# Planos de migração: pastas de trabalho

Você fez login com êxito nos sites de origem e destino e nos projetos selecionados. A próxima etapa é preparar suas pastas de trabalho para migração.

**Observação:** se as pastas de trabalho ou fontes de dados incluírem extrações, leia e compreenda as informações em [Migrar pastas de trabalho e fontes de dados com extrações](https://help.tableau.com/current/server/pt-br/cmt-migration_extracts.htm).

## Etapa 1: seleção da pasta de trabalho

Todas as pastas de trabalho no site de origem e projetos selecionados aparecerão na tela Workbook Selection.

![Janela de seleção de pasta de trabalho com a opção de pasta de trabalho específica selecionada e seis visualizações das visualizações selecionadas exibidas.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-select.png)

Se você fizer alterações nas pastas de trabalho do site de origem enquanto nesta etapa, poderá clicar em Refresh para atualizar as listagens de pastas de trabalho. Há várias maneiras diferentes de selecionar essas pastas de trabalho.

### Seleção de pastas de trabalho específicas

Há três botões na seção Specific . Qualquer opção da seção Básica incluirá imediatamente a pasta de trabalho selecionada especificamente no plano de migração. Como alternativa, você pode selecionar individualmente pastas de trabalho específicas clicando em cada uma delas.

#### Selecionar tudo

O botão Selecionar tudo vai selecionar ou desmarcar a seleção de todas as pastas de trabalho no site. Se pastas de trabalho adicionais forem adicionadas ao site depois que o plano for salvo, elas não serão automaticamente adicionadas na próxima vez em que o plano for usado.

#### Exibir:

##### Miniaturas

A exibição padrão mostra suas pastas de trabalho em visualizações em miniatura para ajudá-lo a diferenciar cada uma delas. Nessa exibição, passar o mouse sobre a miniatura mostrará visualizações das outras planilhas e painéis dentro dessa pasta.

##### Lista

A exibição de lista é uma listagem mais sucinta que também fornece informações adicionais, incluindo Nome da pasta de trabalho, Projeto, Versão do Tableau e Última modificação.

Clicar em qualquer um dos cabeçalhos de coluna classificará as pastas de trabalho apropriadamente. Além disso, passar o mouse sobre qualquer uma das pastas de trabalho também fornecerá uma visualização flutuante das planilhas e painéis dentro dessa pasta de trabalho. A exibição de lista é especialmente útil se você tiver uma grande quantidade de pastas de trabalho em um site.

### Seleção baseada em regra

Use a seleção Rule Based para escolher pastas de trabalho com base em critérios específicos. As opções baseadas em regra criarão os critérios de seleção de pasta de trabalho a serem usados quando o plano de migração for executado. Esteja ciente de que selecionar "tudo" em qualquer uma das opções Rule Based é diferente de selecionar Specific Workbooks. Uma seleção "tudo" baseada em regras sempre incluirá todas as pastas de trabalho, portanto, qualquer pasta de trabalho recentemente adicionada será incluída nas migrações futuras.

![Interface para definir regras com base em marcas de projeto e editor para migração de pasta de trabalho.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-rulebased.png)

O botão de opção Rule Based permite selecionar Pastas de trabalho usando as seguintes opções:

#### Workbooks in projects

Esse menu permite selecionar pastas de trabalho de projetos específicos.

#### Workbooks tagged with

Esse menu permite que você selecione pastas de trabalho por marcas.

#### Workbooks published by

Esse menu permite selecionar pastas de trabalho por autor.

Com cada opção, você pode selecionar de modo individual ou múltiplos clicando na opção ao lado de cada entrada. Todas as pastas de trabalho selecionadas aparecerão na caixa Selection Description.

### Seleção de todas as pastas de trabalho

A última opção é selecionar o botão de opção All Workbooks, que seleciona todas as pastas de trabalho em todos os projetos do site.

Usar o botão de opção All Workbooks é diferente de selecionar todas as pastas de trabalho usando o método Specific Workbook pois ele usará todas as pastas de trabalho no site de origem sempre que o plano de migração for usado no futuro.

![Opções de seleção de pasta de trabalho com todas as pastas de trabalho em todos os projetos selecionadas.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-select-all.png)

Quando estiver satisfeito com as seleções de pasta de trabalho, clique em Next.

## Etapa 2: mapeamento da pasta de trabalho

Agora você pode mapear suas pastas de trabalho selecionadas no arquivo de origem para o arquivo de destino. O mapeamento permite renomear pastas de trabalho de origem, conforme elas são migradas e escolhem destinos diferentes. Também é possível adicionar o mapeamento para alterar o projeto, o prefixo ou o sufixo das pastas de trabalho. Os projetos podem ser adicionados ao Destino nesta seção.

Se você não fizer alterações aqui, as pastas de trabalho selecionadas simplesmente serão migradas com o mesmo nome e no mesmo projeto que a origem. Se você não tiver definido projetos no site de destino, eles serão migrados no projeto Padrão. Para adicionar o mapeamento de pasta de trabalho clique no botão Adicionar mapeamento. As opções a seguir aparecerão na área de mapeamento.

![Interface para adicionar novos mapeamentos de pastas de trabalho com opções para renomear e alterar projetos.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-mapping.png)

### Renomear pasta de trabalho

![Interface de mapeamento de pasta de trabalho com campos para projetos de origem e destino e nomes de pasta de trabalho.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-mapping-rename.png)

Essa transformação permite filtrar pelo Source projeto e selecione a(s) pasta(s) de trabalho desejada(s) para renomear. No campo Destination , selecione para qual projeto deseja que a pasta de trabalho seja direcionada e insira o nome desejado.

### Alterar projeto

![Interface para alterar o prefixo da pasta de trabalho com opções para remover ou substituir.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-mapping-chgproj.png)

Por padrão, as pastas de trabalho são migradas para o mesmo projeto no destino. Esse mapeamento permite alterar o projeto de destino de todas as pastas de trabalho de um projeto de origem.

### Adicionar projeto

Ao renomear a pasta de trabalho ou alterar o projeto, a opção Add New permite criar um projeto de destino sem precisar entrar no site de destino e criar o projeto manualmente. Crie projetos e projetos aninhados usando a caixa de diálogo Add New .

![Um formulário para criar um novo projeto com campos para localização, nome do projeto, projeto pai e descrição.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-mapping-chgproj-new.png)

### Alterar prefixo

![Interface para alterar o prefixo da pasta de trabalho com opções para remover ou substituir.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-mapping-chgprefix.png)

Isso permite remover ou substituir o prefixo de pastas de trabalho de um ou todos os projetos de origem.

### Alterar sufixo

Como o mapeamento de prefixo, você pode remover ou substituir o sufixo de pastas de trabalho de um ou todos os projetos de origem.

## Etapa 3: transformações da pasta de trabalho

Você pode alterar e modificar suas pastas de trabalho usando a etapa Transformação.

![Um botão chamado "Adicionar transformação" com uma seta suspensa.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-add-transform-button.png)

As transformações modificam suas pastas de trabalho de maneira especificada. As transformações adicionais podem ser incluídas por meio de plug-ins ou serão adicionadas em versões futuras do aplicativo. Clique no menu suspenso Adicionar transformação para visualizar a seleção de Transformações atualmente disponíveis.

![Um menu suspenso de opções de transformação de pasta de trabalho.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-add-transform-list.png)

Selecionar qualquer uma das transformações exibirá a janela Editar transformação, permitindo personalizá-la para as pastas de trabalho selecionadas. Todas as transformações serão concluídas na ordem em que são listadas, de cima para baixo.

Para todos os tipos diferentes de transformações, há duas etapas básicas. A primeira etapa é criar sua seleção para a transformação. Nesse caso, selecione a(s) pasta(s) de trabalho que deseja transformar. A área de seleção é semelhante à seção Seleção da pasta de trabalho da fase Planejamento com todos os recursos do botão de opção de seleção básica: Selecione/Remova a seleção de todos, Atualizar, Exibição de Miniatura e Exibição de Lista . Na parte superior da lista, você pode Select Allas pastas de trabalho, que é uma opção para selecionar automaticamente todas as pastas de trabalho para transformações futuras. Você também pode Atualizar a janela de exibição da pasta de trabalho para refletir as alterações ou atualizações no site de origem.

![Uma janela com opções para editar uma transformação.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-edit-transform-workbook.png)

A segunda etapa é usar a guia de opções para inserir as seleções específicas de qualquer transformação selecionada.

![Um formulário para editar um valor de parâmetro, completo com campos para o nome do parâmetro, tipo de dados e valor.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-edit-transform-options.png)

Cada uma das transformações de pasta de trabalho tem valores diferentes a serem inseridos na guia de opções, e a guia terá nomes diferentes, dependendo da transformação que você está editando:

### Substituir ação de URL

Substitua a parte ou todas as ações de URL dentro pasta de trabalho usando essa transformação. Na guia de opções, digite o texto para ser correspondido e seu valor de substituição. A funcionalidade de substituição destina-se a ações de URL e não verifica toda a pasta de trabalho XML.

![Duas caixas de texto com rótulos, "Correspondência" e "Substituição".](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-action-url.png)

#### Exemplo:

URL: `www.exampledev.com`

Corresponder: `dev`

Substituição: `Prod`

Resultado: `www.exampleProd.com`

### Definir valor de parâmetro

Defina um novo parâmetro. Na guia de opções, digite o nome do parâmetro, o tipo de dados do menu suspenso e o valor.

![Um formulário com campos para um nome de parâmetro, tipo de dado e valor.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-parameter.png)

### Remover imagens

Remova as imagens (como uma marca d'água) nas pastas de trabalho selecionadas digitando no nome do arquivo na guia de opções. Há uma caixa de seleção adicional para receber um aviso durante a migração, se nenhuma imagem for encontrada.

![Um campo de texto denominado “Nome do arquivo” e uma mensagem de aviso sobre nenhuma imagem correspondente encontrada na pasta de trabalho.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-image-remove.png)

### Remover comandos de dica de ferramenta

Remova todos os comandos da dica de ferramenta das pastas de trabalho selecionadas. Não há opções adicionais para definir a transformação.

### Substituir imagens

Substitua as imagens inseridas nas pastas de trabalho selecionadas. Na guia de opções, insira o nome do arquivo da imagem atual e a imagem de substituição. Você pode substituir imagens usando um caminho de arquivo local ou URL.

![Um campo de texto denominado “Nome do arquivo” e uma mensagem de aviso sobre nenhuma imagem correspondente encontrada na pasta de trabalho.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-image-replace.png)

#### Exemplo:

Nome de arquivo: `image.png`

URL da imagem de substituição: `https://www.exampledev.com/replacementImage.png`

### Visibilidade de controle de zoom

Configura o modo de visibilidade do menu suspenso: Automático, Mostrar ao focalizar ou Ocultar na guia de opções.

![Um menu suspenso de modo de visibilidade com “Automático” escolhido.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-zoom.png)

### Substituição de URL da página da Web

Substitua parte ou toda URL de página da Web usada em painéis usando essa transformação. Na guia de opções, digite o texto que deve ser correspondido e seu valor de substituição.

![Dois campos de texto vazios rotulados como “Correspondência” e “Substituição”](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-web-url-replace.png)

#### Exemplo:

URL: `www.exampledev.com`

Corresponder: `dev`

Substituição: `Prod`

Resultado: `www.exampleProd.com`

## Etapa 4: transformações da fonte de dados

A próxima etapa no planejamento de suas pastas de trabalho para a migração da empresa são suas transformações de fonte de dados. Ela é semelhante à etapa Transformações da pasta de trabalho. Elas são para fontes de dados em pacote dentro das pastas de trabalho. As fontes de dados publicadas são manipuladas em uma etapa diferente do processo.

![Um botão chamado "Adicionar transformação" com uma seta suspensa.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-transform-add-button.png)

Clique no menu suspenso Adicionar transformação e as seguintes opções aparecerão:

![Lista de transformações de fonte de dados, incluindo substituição de nome de tabela e ajustes de configuração SQL.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-transform-datasource-add-list.png)

Selecionar qualquer transformação de fonte de dados exibirá a janela Editar transformação, permitindo personalizá-la para as fontes de dados selecionadas. Todas as transformações serão concluídas na ordem em que são listadas, de cima para baixo.

Para todos os tipos diferentes de transformações de fonte de dados, há duas etapas básicas. A primeira etapa é inserir os critérios de correspondência da fonte de dados desejada. Dependendo de qual tipo de conexão você selecionar, mais campos aparecerão na guia Critérios de correspondência.

![Interface de transformação de fonte de dados com campos para definir novos valores de conexão e critérios de correspondência.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-transform-datasource-edit-criteria.png)

Clique em Visualizar conexões de Origem para localizar quaisquer conexões que correspondam aos critérios inseridos.

![Uma tabela que visualiza uma transformação de fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-transform-preview.png)

A segunda etapa é usar a guia de opções para inserir as seleções específicas de qualquer transformação selecionada.

![Interface de configuração SQL personalizada para transformações de fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-transform-datasources-edit-options.png)

Cada uma das transformações da fonte de dados tem valores diferentes a serem inseridos na guia de opções:

#### Definir fórmula de cálculo

Na guia de opções, você pode substituir o cálculo de uma coluna.

![Um formulário com campos para um nome de coluna e uma fórmula.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-transform-calc-set.png)

#### Definir informações de conexão

Na guia Novos valores de conexão, insira o método de autenticação e os detalhes da conexão para a nova fonte de dados. Dependendo de qual tipo de conexão você selecionar, mais campos aparecerão

**Alterar fontes de dados publicadas com CMT**

A partir da versão 2022.1, selecione o tipo de conexão do Tableau Server (Fonte de dados publicada) para alterar a fonte de dados publicada de uma pasta de trabalho. Isso pode reduzir as etapas manuais necessárias ao migrar pastas de trabalho entre ambientes do Tableau, por exemplo, promovendo conteúdo desde o desenvolvimento até a produção.

Para alterar a fonte de dados publicada, selecione uma fonte de dados no menu suspenso e insira o nome de usuário do Tableau para autenticação. O usuário deve existir no site de destino e ter o recurso Conectar para a fonte de dados publicada.

- Para fontes de dados baseadas em arquivo, os usuários acessarão a pasta de trabalho e verão os dados com base nas permissões do usuário do Tableau especificado.
- Para todas as outras fontes de dados, os usuários são solicitados a fornecer suas próprias credenciais de banco de dados quando a exibição ou a pasta de trabalho são carregadas.

Se o nome de usuário do Tableau não for especificado, somente os usuários com o recurso Conectar poderão ver os dados na pasta de trabalho.

![Um formulário com campos para a fonte de dados publicada e seu nome de usuário do Tableau.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-transform-set-cx.png)

#### Definir SQL personalizado

Na guia Novo SQL personalizado, insira o nome da consulta SQL personalizada que você deseja modificar para Corresponder nome da consulta. O nome da consulta deve corresponder ao nome da consulta SQL personalizada da camada física da fonte de dados. Se esses nomes não corresponderem, a transformação falhará. Para obter mais informações sobre a modelagem de dados e a camada física, consulte [O modelo de dados do Tableau](https://help.tableau.com/current/server/pt-br/datasource_datamodel.htm).

Depois de inserir o nome da consulta, insira o SQL personalizado desejado no campo de texto. Esteja ciente de que o SQL personalizado pode afetar negativamente o desempenho de suas pastas de trabalho, se usado incorretamente.

![Uma caixa de texto chamada “Corresponder nome da consulta” e uma caixa de texto maior chamada “SQL personalizado”.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-transform-set-custom-sql.png)

#### Remover extração

Não há guia de opções para essa transformação. Basta digitar as informações Match Criteria e a extração será removida durante a migração.

Além disso, em cada uma das transformações, é possível inserir anotações na seção Comments no lado esquerdo da janela Edit Transformation.

#### Aplicar credenciais salvas

Obsoleto na versão 2022.3. Em vez disso, use a transformação de fonte de dados Definir informações de conexão.

Na guia de opções, insira o Nome de usuário do Tableau e o Nome de usuário de credenciais salvas correspondente para a conexão de dados. Você só pode aplicar credenciais salvas para conexões de dados existentes na página Configurações de conta no site do Tableau. Para obter mais informações, consulte [Gerenciar credenciais salvas para as conexões de dados](https://help.tableau.com/current/server/pt-br/manage_stored_credentials.htm).

![Duas caixas de texto solicitam um nome de usuário do Tableau e um nome de usuário com credenciais salvas.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-datasource-transform-saved-credentials.png)

## Etapa 5: opções de publicação

A etapa final na fase de Pastas de Trabalho é selecionar opções de publicação e criar transformações para marcas, agendamentos de atualização de extração e permissões.

![Publique opções para pastas de trabalho, incluindo controles de substituição e configurações de permissão.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-publish-options.png)

#### Redefinir seleções de painel

Essa opção desmarca todos os objetos em painéis.

#### Substituir pastas de trabalho mais recentes

Se marcada, uma pasta de trabalho será migrada mesmo que ela substitua uma pasta de trabalho que tenha sido criada ao mesmo tempo ou mais recentemente que a pasta de trabalho movida

#### Copiar permissões de pasta de trabalho

Quando selecionada, a ferramenta de migração tentará corresponder as permissões da pasta de trabalho de origem o mais próximo possível.

#### Copiar agendas de atualização de extração

Quando selecionada, a ferramenta de migração tentará definir os agendamentos de atualização de extração de pasta de trabalho de destino para agendamentos correspondentes ao nome da origem.

**Obsevação:** os agendamentos de atualização de extração não podem ser criados no Tableau Cloud. Esta opção não está disponível se o destino for um site do Tableau Cloud. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

#### Copiar credenciais inseridas para pastas de trabalho

Copie as credenciais inseridas para fontes de dados inseridas em pastas de trabalho. Disponível apenas ao migrar do Tableau Server para sites do Tableau Cloud. Para obter mais informações, veja [Migrar pastas de trabalho e fontes de dados com credenciais inseridas](https://help.tableau.com/current/server/pt-br/cmt-migration_embedded_credentials.htm).

**Observação:** o CMT não oferece suporte à migração de credenciais inseridas para conexões OAuth. Para migrar o OAuth as credenciais inseridas no site de destino, use a transformação de fonte de dados [Definir informações de conexão](#plan_wkbk_data_trans).

#### Copiar proprietário da pasta de trabalho

Copie as configurações do proprietário da pasta de trabalho do local de origem para atribuir o proprietário da pasta de trabalho. Se não estiver selecionado, o usuário da Content Migration Tool receberá a propriedade da pasta de trabalho no local de destino.

#### Aplicar mapeamentos de usuários

Aplique mapeamentos de usuário para atribuir propriedade de conteúdo. Selecione esta opção se houver diferenças na sintaxe do nome de usuário no local de destino. Para obter mais informações, consulte [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm).

### Adicionar opção

Clique no menu suspenso Add Option para os diferentes tipos de transformações que você pode adicionar:

![Interface para adicionar opções de publicação de pasta de trabalho, incluindo gerenciamento de marcas e configurações de permissão.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-pub-option-add.png)

Para todos os tipos diferentes de transformações, há duas etapas básicas. A primeira etapa é criar sua seleção para a transformação. Nesse caso, selecione a(s) pasta(s) de trabalho que deseja transformar. A área de seleção é semelhante à seção Seleção da pasta de trabalho da fase Planejamento com todos os recursos do botão de opção de seleção básica: Select/Unselect All, Refresh, Thumbnail Display e List Display. Na parte superior da lista, você pode Select Allas pastas de trabalho, que é uma opção para selecionar automaticamente todas as pastas de trabalho para transformações futuras. Você também pode Atualizar a janela de exibição da pasta de trabalho para refletir as alterações ou atualizações no site de origem.

![Interface de adição de marcas para pastas de trabalho com campos para seleção e aplicação de marcas.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-workbook-pub-option-add-tags.png)

A segunda etapa é usar a guia de opções para inserir as seleções específicas de qualquer transformação selecionada. **Observação:** a guia de opções terá nomes diferentes, dependendo da transformação que você está editando.

#### Adicionar marcas

Isso permite adicionar uma ou mais marcas à pasta de trabalho. Se você focalizar o mouse sobre uma marca inserida anteriormente, um “X” azul aparecerá para permitir a exclusão.

![Uma caixa de diálogo Editar opção com opções para selecionar pastas de trabalho ou adicionar uma marca.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-tags-add.png)

#### Remover marcas

Isso permite adicionar uma ou mais marcas à pasta de trabalho. Se você focalizar o mouse sobre uma marca inserida anteriormente, um “X” azul aparecerá para permitir a exclusão. Você também pode optar por remover a marca das pastas de trabalho de origem ou de destino.

![Uma janela para remover marcas de pastas de trabalho.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-tags-remove.png)

#### Aplicar agendas de atualização de extração

Aqui você pode aplicar as agendas de atualização de extração de destino às pastas de trabalho migradas. A lista de agendas geradas é do destino.

**Obsevação:** os agendamentos de atualização de extração não podem ser criados no Tableau Cloud. Esta opção não está disponível se o destino for um site do Tableau Cloud. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

![Uma caixa de diálogo com opções para aplicar agendamentos de atualização de extração, incluindo fim do mês, sábado à noite e manhãs de dias úteis.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-sched-refresh.png)

#### Definir permissões

Essa transformação é editar as permissões das pastas de trabalho selecionadas. Insira um Grupo ou Usuário e, em seguida, clique em Add. Ajuste as permissões conforme desejado. As quatro opções diferentes são Allow a permissão, Deny a permissão, Inherit ou manter o Source Value.

![Uma janela que mostra permissões para uma pasta de trabalho.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-permissions-set.png)

#### Definir Gerar miniatura como

Isso permite que você defina o Usuário ou Grupo para ser usado para gerar dados específicos do usuário na miniatura da pasta de trabalho, após a implantação. Cada opção tem um menu suspenso para selecionar o usuário ou grupo desejado.

![Uma caixa de diálogo para gerar miniaturas como um usuário ou um grupo.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-workbook-thumbnail-gen.png)

## Etapa 6: continuar para a próxima etapa

Depois de selecionar as pastas de trabalho e preferências, clique em Next para continuar para a seção [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm) da fase de planejamento.

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=bf4eb74f0a26c610c8b3020466b88d203a018396fdcaf7cfaef643ee744dca5b url=/tableau/current/pt-br/server/cmt-plan_users.md -->

[Pular para o conteúdo principal](#main-content)

# Planos de migração: permissões e propriedade

O Content Migration Tool permite replicar as permissões de pastas de trabalho e fontes de dados para ambientes do Tableau em domínios de rede diferentes ou têm diferenças na sintaxe de nome de usuário ou grupo. Você poderá criar mapeamentos de permissões do usuário para personalizar e proteger o conteúdo depois de ter sido publicado no local de destino. Os mapeamentos são aplicados seCopy Project Permissions,Copy Workbook Permissions ouCopy Data Source Permissions foram selecionados anteriormente na fase de planejamento, juntamente com Aplicar mapeamentos de usuário.

Para obter mais informações, consulte [Planos de migração: projetos de origem](https://help.tableau.com/current/server/pt-br/cmt-plan_source_projects.htm), [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm) e [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm).

## Limitações de mapeamento

- O Content Migration Tool interromperá o processo de migração se não encontrar o usuário ou o grupo mapeado no local de destino. Os mapeamentos subsequentes de permissão do usuário ou do grupo não são verificados após a primeira falha, e o plano deve ser executado novamente.
- O Content Migration Tool não pode replicar permissões se o conteúdo de origem tiver permissões para vários usuários e grupos com nomes idênticos. Isso só ocorre quando há nomes duplicados de usuários ou grupos provenientes de domínios separados.

## Etapa 1: adicionar mapeamento

Para adicionar o mapeamento de permissões, clique em Add Mapping e selecione se quiser alterar o nome de um domínio, usuário ou grupo, ou importar os mapeamentos de um arquivo de valores separados por vírgula (CSV). Se o Content Migration Tool não puder corresponder a uma permissão no local de destino, o conteúdo de origem não será migrado.

![Interface adicional de mapeamento de usuário com opções para mapeamento de domínio, usuário e grupo.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-user-add.png)

### Mapeamento de domínio

O mapeamento de permissões do domínio aplica-se a todos os usuários e grupos no local de destino. Se você não tiver certeza sobre o domínio de origem ou destino, verifique as páginas do usuário e do grupo no site do Tableau. Se o provisionamento de usuários local foi selecionado, o domínio deverá ser especificado como `local`.

![Interface de mapeamento de domínio que mostra campos de domínio de origem e destino.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-user-domain-mapping.png)

### Mapeamento de usuário

O mapeamento de permissões de usuário preenche automaticamente uma lista de usuários dos locais de origem e destino usando a sintaxe `domain\user`. Você não pode inserir e salvar os nomes de usuários que não existem.

**Observação:** ao migrar entre projetos no mesmo site, o local de destino e a lista de usuários serão os mesmos. Você pode usar mapeamentos para atualizar a propriedade do conteúdo de `User_A` para `User_B` no site.

![Interface adicional de mapeamento de usuário com opções para mapeamento de domínio, usuário e grupo.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-user-mapping.png)

### Mapeamento de grupo

O mapeamento de permissões de grupo preenche automaticamente uma lista de usuários dos locais de origem e destino usando a sintaxe `domain\group`. Você não pode inserir e salvar os nomes de grupos que não existem.

![Edite a interface de mapeamento que mostra opções de mapeamento de grupos de origem e destino.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-group-mapping.png)

## Importar mapeamentos de um arquivo CSV

A partir da versão 2021.4, você pode importar um arquivo CSV contendo mapeamentos de domínio, usuário e grupo para preparar rapidamente seus dados para migração. A importação de mapeamentos pode reduzir as etapas manuais necessárias para executar um plano de migração, permitindo que você crie e edite seus mapeamentos em massa fora do Content Migration Tool. Para importar mapeamentos, selecione Importar do arquivo no menu Adicionar mapeamento.

### Requisitos de formato do arquivo CSV

Quando você criar um arquivo CSV para importação de mapeamentos, certifique-se de que o arquivo atenda aos requisitos de formatação:

- O arquivo não inclui os cabeçalhos da coluna. O Tableau presume que cada linha representa um mapeamento.
- O arquivo contém três valores separados por vírgula por linha: tipo de mapeamento, domínio/usuário/grupo de origem e domínio/usuário/grupo de destino.
- Inclua o domínio para nomes de usuário e grupos se o servidor usar autenticação do Active Directory ou "local" se um armazenamento de identidades local é usado.

Você deve especificar "domínio", "usuário" ou "grupo" para o tipo de mapeamento, conforme mostrado na tabela a seguir. As colunas de origem e destino fornecem sintaxe de exemplo para Active Directory e um armazenamento de identidade local. Os valores reais no arquivo CSV variam dependendo da sua organização.

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Tipo de mapeamento</td><td style="font-weight: bold;">Fonte</td><td style="font-weight: bold;">Destino</td></tr><tr><td>domain</td><td><code>&lt;domain&gt;</code></td><td><code>&lt;domain&gt;</code></td></tr><tr><td>user</td><td><code>&lt;domain&gt;</code>\<code>&lt;user name&gt;</code><br>local\<code>&lt;user name&gt;</code></td><td><code>&lt;domain&gt;</code>\<code>&lt;user name&gt;</code><br>local\<code>&lt;user name</code>&gt;</td></tr><tr><td>grupo</td><td><code>&lt;domain&gt;</code>\<code>&lt;group name&gt;</code><br>local\<code>&lt;group name&gt;</code></td><td><code>&lt;domain&gt;</code>\<code>&lt;group name&gt;</code><br>local\<code>&lt;group name&gt;</code></td></tr></tbody></table>

### Importar mapeamentos de permissões do usuário

Para importar mapeamentos de permissões do usuário no Content Migration Tool:

1. Clique Adicionar mapeamento e selecione Importar do arquivo.
2. Na janela de diálogo, clique em Exportar CSV para exportar um arquivo .csv contendo todos os usuários e grupos do site de origem. Edite o arquivo resultante em um editor de texto para adicionar mapeamentos para o site de destino.
    
    Se você já tiver um arquivo de mapeamento, pule para a etapa 3.
    
    **Observação:** o arquivo CSV exportado não inclui domínios do site de origem. Os domínios devem ser adicionados manualmente ao CSV para criar mapeamentos de domínio.
3. Clique em Importar mapeamentos e selecione o arquivo de mapeamento que deseja importar.

O Content Migration Tool irá validar os mapeamentos para erros ao importar o arquivo. Se forem detectados erros, você deverá corrigir cada erro no arquivo CSV e, em seguida, importá-lo novamente.

### Exemplo de importação de CSV

O exemplo a seguir mostra um arquivo CSV que contém os vários tipos de mapeamento.

user,local\\hwilson,companyx.lan\\henry.wilson
user,local\\jjohnson,companyx.lan\\janna.johnson
user,local\\mkim,companyx.lan\\michele.kim
user,local\\fsuzuki,companyx.lan\\fred.suzuki
user,local\\awang,companyx.lan\\alan.wang
user,local\\snguyen,companyx.lan\\susan.nguyen
user,local\\lrodriguez,companyx.lan\\laura.rodriguez
user,local\\agarcia,companyx.lan\\ashley.garcia
group,local\\All Users,companyx.lan\\All Users
group,local\\Finance Team,companyx.lan\\Finance Group
domain,dev.mycompany,prod.mycompany

Uma janela de visualização é exibida durante a importação do CSV que mostra os mapeamentos removidos, adicionados ou atualizados, inalterados e ignorados. Verifique se as alterações de mapeamento estão corretas e clique em Aceitar.

![Interface adicional de mapeamento de usuário com opções para mapeamento de domínio, usuário e grupo.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-user-import-preview.png)

Depois que os mapeamentos são importados com sucesso, você pode editar, excluir ou alterar a ordem do mapeamento conforme descrito na Etapa 2.

## Etapa 2: alterar a ordem de mapeamento

Depois que um mapeamento de permissões for criado, você pode alterar a ordem usando as opções Up ou Down para determinar quando ele será usado durante a migração. Quando um domínio, usuário ou grupo for usado em um mapeamento de permissões, quaisquer mapeamentos de permissões subsequentes para o domínio, usuário ou grupo de origem serão ignorados.

No exemplo abaixo, as permissões de `User_A` são mapeadas para `User_B`. O Content Migration Tool vai ignorar o segundo mapeamento de permissões, pois o `User_A` já foi usado.

![Interface de mapeamento de usuário com opções para editar, excluir e reordenar mapeamentos.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-user-order_example.png)

No exemplo abaixo, o primeiro mapeamento de permissões associa o domínio de todos os usuários a `prod`. O Content Migration Tool vai ignorar o segundo mapeamento de permissões, pois o `User_A` já foi usado.

![Interface de mapeamento de usuário e domínio com opções para edição e reordenação.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-user-override_example.png)

## Etapa 3: prosseguir para a próxima etapa

Quando estiver pronto, clique em Next para ir para a seção [Planos de migração: scripts de migração](https://help.tableau.com/current/server/pt-br/cmt-plan_scripts.htm) da fase de planejamento.

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=f8724415005803d94e29ec657630fdf6fd54462cbd556342d2b95da3ce13d8f4 url=/tableau/current/pt-br/server/cmt-plan_source_projects.md -->

[Pular para o conteúdo principal](#main-content)

# Planos de migração: projetos de origem

A próxima etapa na criação de um plano de migração no Content Migration Tool do Tableau é selecionar os projetos de origem. Projetos de origem são os projetos de onde as pastas de trabalho e as fontes de dados publicadas serão migradas. Os projetos que você escolher determinam quais pastas de trabalho estão disponíveis para migrar na próxima etapa do plano de migração.

## Etapa 1: selecionar seu projeto de origem

Há duas opções ao selecionar os projetos de origem, All Projectse Specific Projects:

![Interface para selecionar todos os projetos para migração com uma opção de atualização.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-source-proj-select-all.png)

A opção All Projects seleciona todos os projetos do site de origem que você especificou na etapa de Servidores. A opção Specific Projects permite selecionar projetos específicos do site de origem.

**Observação:** os projetos de origem devem conter pastas de trabalho ou fontes de dados. Content Migration Tool não migrará projetos vazios.

![Interface de seleção de projetos com opções para selecionar projetos específicos para migração.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-source-proj-select-specific.png)

Você pode selecionar cada projeto individualmente ou usar o botão Select All e depois desmarcar as seleções para os projetos que não deseja incluir. Se você fizer alterações no site da origem nesta etapa, poderá usar o botão Refresh para atualizar a lista de projetos.

![Um botão chamado "Atualizar".](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-source-proj-refresh.png)

## Etapa 2: selecionar opções do projeto

Assim que os projetos de origem forem selecionados, selecione quais opções de projeto aplicar para o local de destino. Existem opções para criar projetos que não existem, além de copiar as permissões do projeto e propriedade do local de origem. Para atribuir uma nova propriedade de conteúdo com base em mapeamentos de usuário, selecione Aplicar mapeamentos de usuário.

![Menu de opções para criação de projeto e aplicação de mapeamento de usuário em um projeto de migração.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-source-proj-options.png)

- Criar projetos de destino: crie automaticamente projetos que não existem no local de destino. Content Migration Tool não criará projetos de destino se o projeto de origem estiver vazio ou nenhuma pasta de trabalho ou origem de dados for selecionada. Por padrão, as tentativas de migração para um projeto inexistente resultarão em uma migração com falha.
- Copiar permissões do projeto: copie as permissões do projeto de origem o mais próximo possível.
- Copiar proprietário do projeto: copie as configurações de propriedade do projeto do local de origem para atribuir o proprietário do projeto.
- Aplicar mapeamentos de usuário: aplique mapeamentos de usuário para atribuir propriedade de conteúdo dos projetos no local de destino. A propriedade do conteúdo não será aplicada se o projeto de destino já existir. Para obter mais informações, consulte [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm).

## Etapa 3: prosseguir para a próxima etapa

Depois de selecionar os projetos de origem, clique em Next para continuar para a seção [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm) da fase de planejamento. Se estiver migrando pastas de trabalho entre dois projetos no mesmo site do Tableau, você escolherá seu projeto de destino na próxima seção.

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=ff2b3802a9631d259264cc8df1f2a72047e7eddbde121240dcd41eccf5be9ca9 url=/tableau/current/pt-br/server/cmt-plan_scripts.md -->

[Pular para o conteúdo principal](#main-content)

# Planos de migração: scripts de migração

A próxima etapa da criação de um plano de migração no Content Migration Tool do Tableau é criar os scripts que você deseja executar com o plano antes ou depois da migração.

## Etapa 1: pré-migração

Uma seção Run Pre Migration da tela é dedicada a scripts que serão executados antes da migração.

![Configurações para habilitar a execução da pré-migração.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-script-pre.png)

Cada campo tem um ícone de ajuda de onde você pode obter informações ao passar o cursor sobre ele. Para começar com seus scripts de pré-migração, selecione Enable, que então ativará os campos abaixo.

#### Working Directory

Este é o diretório de trabalho do script. O diretório padrão é a mesma pasta do plano de migração. Clique no botão Procurar para selecionar uma pasta diferente. O botão Reset restaura a pasta de plano de migração atual como sendo o diretório de trabalho.

#### Run

Esse menu suspenso permite que você escolha executar um script personalizado ou um executável com parâmetros.

#### Command Executable

Se você selecionou Executable with Parameters no menu Run , este campo aparecerá. Este é o caminho de arquivo para o comando executável para executar antes da migração. Digite diretamente ou utilize o botão Procurar para localizar o executável. Este é um campo obrigatório.

#### Command Parameters

Se você selecionou Executable with Parameters no menu suspenso Executar, este campo aparecerá. Insira os parâmetros da linha de comando aqui para utilizar com o comando executável.

#### Script

Se você selecionou Custom script no menu Executar , digite o script de pré-migração aqui. Ele será executado como um arquivo \*.cmd. Este é um campo obrigatório.

## Etapa 2: pós-migração

A metade da tela Run Post Migration é dedicada a scripts que serão executados após a migração.

![Interface para configurar scripts pós-migração com campos de executável e parâmetros.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-script-post.png)

Cada campo tem um ícone de ajuda de onde você pode obter informações ao passar o cursor sobre ele. Para começar com seus scripts de pós-migração, selecione Enable, que então ativará os campos abaixo.

#### Working Directory

Este é o diretório de trabalho do script. O diretório padrão é a mesma pasta do plano de migração. Clique no botão Procurar para selecionar uma pasta diferente. O botão Reset restaura a pasta de plano de migração atual como sendo o diretório de trabalho.

#### Run

Esse menu suspenso permite que você escolha executar um script personalizado ou um executável com parâmetros.

#### Command Executable

Se você selecionou Executable with Parameters no menu Run , este campo aparecerá. Este é o caminho de arquivo para o comando executável para executar antes da migração. Digite diretamente ou utilize o botão Procurar para localizar o executável. Este é um campo obrigatório.

#### Parâmetros de comando

Se você selecionou Executable with Parameters no menu Run , este campo será exibido. Insira os parâmetros da linha de comando aqui para utilizar com o comando executável.

#### Script

Se você selecionou Custom script no menu Run , insira o script de pós-migração aqui. Ele será executado como um arquivo \*.cmd. Este é um campo obrigatório.

## Etapa 3: prosseguir para a próxima etapa

Quando você estiver pronto, clique em Next.

![Um ícone Próximo.](/tableau/current/pt-br/server/pt-br/Img/cmt-icon-next.png)

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=4ffa5084b438de599bf0313e9e7421cea5e17cafd864382805ef64683624b171 url=/tableau/current/pt-br/server/cmt-plan_servers.md -->

[Pular para o conteúdo principal](#main-content)

# Planos de migração: sites

A primeira etapa ao criar um plano de migração no Content Migration Tool do Tableau é fazer logon nos sites de origem e de destino.

Na seção Sites da fase de Planejamento, você faz login nos sites de origem e destino. As permissões das credenciais de usuário que você usa controlam os sites e projetos que você vê ao criar um plano de migração. Você só pode migrar conteúdo ao qual o usuário tem acesso.

![Interface de painel duplo para selecionar conexões de origem e destino no Tableau.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-servers.png)

## Permissões e licenças necessárias

As contas de usuário usadas para fazer logon nos sites de origem e destino devem ter uma função de Explorer ou superior e as seguintes permissões para o conteúdo que você deseja migrar:

- Exibição
- Baixar pasta de trabalho/Salvar como cópia
- Opcional: administrador (para selecionar pastas de trabalho, para acessar uma lista de usuários)

Os sites de origem e destino devem ter recursos do Advanced Management. Para obter mais informações, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

## Etapa 1: fonte

Este é o ponto de partida da migração. Entre no Tableau Server , em seguida selecione o _site_ a ser usado como origem. Os sites são silos independentes de pastas de trabalho, dados e listas criados no Tableau para agrupar conteúdo relacionado aos usuários selecionados. Você só podem migrar conteúdo de um site de cada vez.

### Entrar no site de origem

Use as etapas abaixo para fazer logon no Tableau Cloud ou Tableau Server. Para obter mais informações sobre como fazer login no Tableau Cloud com logon único e Tableau com MFA, consulte [Entrar no Tableau Cloud](https://help.tableau.com/current/online/pt-br/to_signin.htm).

1. Clique em Fazer logon no Tableau.
2. Na janela de diálogo Selecionar uma conexão, selecione uma conexão salva e clique em Continuar.
    
    ![Interface de seleção de conexão para o Tableau Cloud com opções para editar conexões.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-select-server.png)
    
    Se não houver conexões disponíveis, clique em Adicionar ou editar conexões salvas para adicionar uma nova conexão. Para obter mais informações, consulte [Conexões salvas](#saved-connections).
3. Digite seu nome de usuário e senha e clique em Entrar.
    
    Se o seu servidor estiver configurado para SAML ou logon único, você será redirecionado para a página de logon do provedor de identidade para concluir o processo de autenticação.
4. Selecione o site que deseja usar.
    
    ![Interface de seleção de sites com um campo de pesquisa e uma lista de sites disponíveis.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-servers-source-sites.png)

Para alterar o servidor de origem ou atualizar sua seleção de sites, clique em Selecionar uma origem diferente.

## Etapa 2: destino

Repita o processo de entrada para o site de destino (o site para o qual você está migrando o conteúdo).

Se você estiver migrando suas pastas de trabalho entre dois projetos no mesmo site do Tableau, suas credenciais de entrada para os sites de origem e destino serão idênticas (incluindo a URL do servidor e o nome do site).

## Conexões salvas

O uso de conexões salvas permite que você entre rapidamente nos sites de origem e de destino, criando uma conexão de reutilizável. Ao adicionar uma conexão salva, você deve especificar o método de logon preferencial para o seu site.

A partir de 2021.2, o Content Migration Tool oferece suporte aos seguintes métodos de logon:

- **Tokens de acesso pessoal:** permite que os usuários criem tokens de autenticação de longa duração para melhorar a segurança, auditoria e automação dos planos de migração. Os tokens de acesso pessoais permitem que os usuários façam login, sem exigir login interativo no Content Migration Tool. Para obter mais informações, consulte [Tokens de acesso pessoal](https://help.tableau.com/current/server/pt-br/security_personal_access_tokens.htm).
- **Login baseado em navegador:** os usuários inserem suas credenciais e concluem a autenticação por meio de um navegador da Web inserido. Essa opção pode ser semelhante a como você normalmente se autentica no Tableau.
- **Login com nome de usuário e senha:** os usuários são autenticados por meio do Content Migration Tool em vez de uma janela de navegador inserida. Essa opção passa credenciais para o servidor usando APIs REST do Tableau. Você pode usar login com nome de usuário e senha para autenticar planos de migração criados antes da versão 2020.3 e ao solucionar problemas que impedem o uso de logon baseado em navegador.

### Adicionar ou editar conexões salvas

Um link para Add or edit saved connections é exibido na parte inferior do Content Migration Tool, e ao fazer logon nos sites de origem e destino. Clicar nesse link abrirá a janela Manage Tableau Connections.

![Uma janela de gerenciamento de conexão do Tableau com opções para tokens de acesso pessoal, logon baseado em navegador e logon com nome de usuário e senha.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-connections.png)

Use as etapas abaixo para adicionar uma conexão salva:

1. Na janela Gerenciar conexões do Tableau, clique em Nova conexão ou selecione uma conexão existente para fazer alterações.
2. Digite um Nome de conexão (nome para descrever seu servidor) e a URL do servidor.
    
    Se você não incluir um prefixo para a URL do servidor, o Content Migration Tool usará `http://` .
3. Selecione o método de logon para sua conexão.
    
    Se você estiver usando tokens de acesso pessoais, consulte [Adicionar conexões salvas com tokens de acesso pessoais](#add-saved-connections-with-personal-access-tokens).
4. Clique em Salvar.

Depois de criar uma conexão salva, ela será listada na janela Selecionar uma conexão, na próxima vez que você entrar nos sites de origem e de destino.

### Adicionar conexões salvas com tokens de acesso pessoais

Adicionar uma conexão salva com um token de acesso pessoal requer mais informações do que outros métodos de logon. Você precisará criar um novo token de acesso pessoal nos sites de origem e destino para começar. Os tokens de acesso pessoal não devem ser compartilhados entre aplicativos. Para obter mais informações, consulte [Tokens de acesso pessoal](https://help.tableau.com/current/server/pt-br/security_personal_access_tokens.htm).

Criar token de acesso pessoal

1. Em um navegador da Web, entre no site do Tableau.
2. Na parte superior da página, clique na imagem do perfil ou nas iniciais e selecione Minhas configurações de conta.
3. Em Tokens de acesso pessoal, digite um nome descritivo para o token no campo Nome do token e clique em Criar novo token.
4. Na janela resultante, clique em Copiar para área de transferência e feche a janela.
5. Cole o segredo do token em um arquivo. Armazene o arquivo em um local seguro.

Adicionar tokens de acesso pessoal

1. Na Content Migration Tool, clique em Adicionar ou editar conexões salvas.
2. Na janela Gerenciar conexões do Tableau , insira um Nome de conexão e a URL do servidor.
    
    Se você estiver se conectando ao Tableau Cloud, deverá inserir a URL completa do pod do seu site. Por exemplo, `https://10ay.online.tableau.com`. Seu pod é mostrado na primeira parte da URL do site após entrar no Tableau Cloud.
3. Insira o Nome do token de acesso pessoal e o Segredo do token de acesso pessoal, obtidos ao criar um token de acesso pessoal na seção anterior.
4. No campo Nome do site, insira o nome do site conforme aparece na URL, sem espaços. Isso é diferente do nome do site amigável. Por exemplo, “Site A” seria “sitea” na URL de um navegador.
5. Clique em Salvar.

## Etapa 3: prosseguir para a próxima etapa

Depois de fazer logon com sucesso nos sites de origem e destino, clique em Next para continuar para a seção [Planos de migração: projetos de origem](https://help.tableau.com/current/server/pt-br/cmt-plan_source_projects.htm) da fase de planejamento.

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

<!-- document id=831e5dabeafa84c91e5a0c07ace9bb6285d68432564c42205c176a56e4cbc068 url=/tableau/current/pt-br/server/security_csp.md -->

[Pular para o conteúdo principal](#main-content)

# Política de segurança de conteúdo

O Tableau Server oferece suporte ao padrão da Política de segurança de conteúdo (CSP). A CSP tem como objetivo ser uma camada adicional de segurança contra script entre sites e outros ataques de Web mal intencionados. A CSP foi implementada como um cabeçalho de resposta HTTP que permite especificas de onde recursos externos, como scripts e imagens, podem ser carregados com segurança.

Consulte o [site do Mozilla](https://developer.mozilla.org/pt-BR/docs/Web/HTTP/CSP) para obter mais informações sobre a CSP.

## Configurar e habilitar a CSP

A CSP foi configurada e habilitada usando o comando [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm). Se estiver executando o Tableau Server em uma implantação distribuída, execute estes comandos no nó inicial no cluster. A configuração será aplicada no cluster após executar o [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply).

### Etapa 1: definir diretivas padrão

O Tableau Server inclui o conjunto de diretivas padrão na tabela abaixo.

Para definir uma diretiva, use a seguintes sintaxe do tsm:

`tsm configuration set -k content_security_policy.directive.<directive_name> -v "<value>"`

Por exemplo, para definir a diretiva `connect_src`, execute o comando a seguir:

`tsm configuration set -k content_security_policy.directive.connect_src -v "* unsafe-inline"`

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 45%;"><col style="width: 20%;"><col style="width: 25%;"></colgroup><tbody><tr><th>Opção</th><th>Valor padrão</th><th><p>Descrição</p></th></tr><tr><td>content_security_policy.directive.default_src</td><td>‘none’</td><td><p>Serve como um fallback para as diretivas de recuperação.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/default-src" target="_blank">Valores válidos para <code>default_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.connect_src</td><td>*</td><td><p>Restringe as URLs que podem ser carregadas usando interfaces de script.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/connect-src" target="_blank">Valores válidos para <code>connect_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.script_src</td><td>*</td><td><p>Especifica fontes válidas para o JavaScrip.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/script-src" target="_blank">Valores válidos para <code>script_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.style_src</td><td>* ‘unsafe-inline’</td><td><p>Especifica fontes válidas para planilhas de estilo.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/style-src" target="_blank">Valores válidos para <code>style_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.img_src</td><td>* data:</td><td><p>Especifica fontes válidas de imagens e favicons.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/img-src" target="_blank">Valores válidos para <code>img_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.font_src</td><td>* data:</td><td><p>Especifica fontes válidas para fontes carregadas usando @font-face.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/font-src" target="_blank">Valores válidos para <code>font_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.frame_src</td><td>* data:</td><td><p>Especifica fontes válidas para contextos de navegação aninhados em carregamento usando elementos como &lt;frame&gt; e &lt;iframe&gt;.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/frame-src" target="_blank">Valores válidos para <code>frame_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.object_src</td><td>data:</td><td><p>Especifica fontes válidas para os elementos &lt;object&gt;, &lt;embed&gt; e &lt;applet&gt;.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/object-src" target="_blank">Valores válidos para <code>object_src</code></a>.</p></td></tr><tr><td>content_security_policy.directive.report_uri</td><td>/vizql/csp-report</td><td><p>Instrui o agente de usuário a relatar tentativas de violação à CSP. Esses relatórios de violação consistem de documentos JSON enviados por meio de uma solicitação do HTTP POST ao URI especificado.</p><p><a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/report-uri" target="_blank">Valores válidos para <code>report_uri</code></a>.</p></td></tr></tbody></table>

### Etapa 2: acrescentar diretivas adicionais (opcional)

As diretivas padrão incluídas com o Tableau Server são um subconjunto de diretivas sustentadas pela CSP.

Para obter uma lista completa de diretivas CSP suportadas, vá até [https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy](https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy).

Você pode adicionar diretivas ao conjunto padrão existente ao adicionar a nova diretiva no namespace content\_security\_policy.directive. Note que é necessário incluir o parâmetro `--force-keys` ao adicionar novas diretivas. A sintaxe é a seguinte:

`tsm configuration set -k content_security_policy.directive.<new_directive_name> -v "<value>" --force-keys`

Por exemplo, para adicionar a diretiva [`worker-src`](https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Security-Policy/worker-src), execute o comando a seguir:

`tsm configuration set -k content_security_policy.directive.worker-src -v "none" --force-keys`

### Etapa 3: especificar diretivas apenas de relatórios (opcional)

É possível configurar a CPS para relatar algumas diretivas e impor outras. Ao definir content\_security\_policy.enforce\_enabled como true, todas as diretivas são impostas (mesmo se content\_security\_policy.report\_only\_enable também estiver definido como true).

Para especificar diretivas como "apenas relatório" e não impostas, adicione-as ao namespace report\_only\_directive. Note que é necessário incluir o parâmetro `--force-keys` ao adicionar novas diretivas. A sintaxe é a seguinte:

`tsm configuration set -k content_security_policy.report_only_directive.<directive_name> -v "<value>" --force-keys`

Por exemplo, para relatar somente a diretiva `script_src` , execute o comando a seguir:

`tsm configuration set -k content_security_policy.report_only_directive.script_src -v " http://*.example.com" --force-keys`

### Etapa 44: habilitar a CSP no Tableau Server

Depois de configurar as diretivas, habilite a CSP no Tableau Server.

As opções a seguir são usadas para habilitar o modo imposição ou somente relatar nas diretivas definidas

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 45%;"><col style="width: 20%;"><col style="width: 25%;"></colgroup><tbody><tr><th>Opção</th><th>Valor padrão</th><th><p>Descrição</p></th></tr><tr><td>content_security_policy.enforce_enabled</td><td>false</td><td><p>Adiciona um cabeçalho CSP em todas as solicitações, para que a violação seja imposta pelo navegador.</p></td></tr><tr><td>content_security_policy.report_only_enabled</td><td>true</td><td>Adiciona um cabeçalho CSP em todas as solicitações, para que as violações sejam gravadas nos logs vizql-client, mas não sejam impostas pelo navegador.</td></tr></tbody></table>

Para habilitar a imposição das diretivas CSP especificadas, execute o seguinte comando

`tsm configuration set -k content_security_policy.enforce_enabled -v true`

### Etapa 5: executar o comando tsm pending-changes apply

Ao concluir a configuração da CSP, execute [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#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).

## Exibir relatório CSP

Para exibir as violações de CSP de uma determinada visualização em um navegador que inclui ferramentas de desenvolvedor. Este exemplo usa o navegador Chrome.

1. Carregue uma visualização teste com as violações que estão hospedadas na implantação do Tableau Server onde você configurou a CSP.
2. Insira `CTRL+Shift+I` para abrir as ferramentas do desenvolvedor no Chrome.
3. Clique na guia **Rede**.
4. No campo **Filtro**, insira `csp-report`, e clique em **Localizar todos**.
    
    - Se não houver violações, a pesquisa não retornará relatórios da CSP.
    - Se houver violações, clique na guia Cabeçalhos no painel de resultados e role até a parte inferior para exibir a **Carga de solicitação**.

<!-- document id=952baec08cc453471b53a89b8325553de62c79d9d0e8bbcafc325b9534b393e9 url=/tableau/current/pt-br/server/portal_dashboard.md -->

[Pular para o conteúdo principal](#main-content)

# Portais personalizados baseados em painel

**Observação:** esta visão geral foi inspirada pelo trabalho do Tableau Visionary, Mark Jackson. Para obter mais detalhes sobre o processo, [acesse o blog do Mark](http://ugamarkj.blogspot.sg/2013/12/customizing-tableau-server-experience.html).

A [interface padrão do Tableau Cloud ou Tableau Server](https://help.tableau.com/current/pro/desktop/pt-br/navigating.htm) é ideal para muitas empresas, mas se você deseja criar uma experiência de empresa com marca e não tem habilidade de desenvolvedor de API, considere criar um portal personalizado baseado em um painel do Tableau. Um portal personalizado permite que você organize o conteúdo em departamentos específicos ou funções de trabalho, podendo até mesmo incorporar treinamentos para ajudar em uma interação de dados mais completa com as pessoas. À medida que o volume do conteúdo do Tableau cresce, um portal personalizado guia seus usuários diretamente para os dados que precisam, ao mesmo tempo que fornecem acesso imediato às exibições relacionadas e à pesquisa do Tableau Server de modo que eles possam explorar mais com facilidade.

## Esboço de um design de portal

Comece fora do Tableau, em um papel ou em um aplicativo de maquete. Considere a estrutura da sua empresa e o número de exibições do Tableau que se aplicam a cada grupo de usuários. Você apenas precisa de um nível de navegação que aponta imediatamente para o conteúdo? Ou você precisa começar com uma página principal que fornece links navegacionais para grupos separados de usuários ou tipos de relatório, seguida por um segundo nível com painéis e exibições relacionadas?

![Um diagrama que ilustra a interconexão da equipe médica, das instalações e dos dados associados.](/tableau/current/pt-br/server/pt-br/Img/portal_sketch.png)

Após obter a confiança dos seus acionistas e consumidores de dados principais, você está pronto para a próxima fase.

## Coleta de imagens para logotipos e elementos de navegação

Comece a pensar sobre imagens enquanto refina seus esboços iniciais e, em seguida, obtenha-as de bibliotecas de ilustrações ou gráficos de marca aprovados, ou crie-as do zero em um aplicativo como o Photoshop ou SnagIt. O PowerPoint também pode ser uma boa fonte se planeja criar miniaturas de navegação de tipos de gráfico comuns.

![Logotipo do portal Health Group.](/tableau/current/pt-br/server/pt-br/Img/portal_logo.png)

## Disposição em um painel do texto, das imagens e das planilhas selecionadas

Crie uma pasta de trabalho com um painel para o portal, usando um [layout lado a lado](https://help.tableau.com/current/pro/desktop/pt-br/dashboards_organize_floatingandtiled.htm#Tiled_vs._Floating_Layouts) para obter um posicionamento e escalonamento de elementos mais previsíveis dos elementos em diferentes dispositivos. Em seguida, comece a adicionar objetos de Texto e Imagem, bem como qualquer planilha de exibições de dados que deseja destacar logo na frente do seu portal. Para refinar o espaçamento entre esses elementos de painel, insira objetos Em branco e ajuste o tamanho deles. Para obter mais informações, consulte [Criar painel](https://help.tableau.com/current/pro/desktop/pt-br/dashboards_create.htm#Add_objects).

**Dica:** para elementos dinâmicos que mostram conteúdo popular ou recém-criado, inclua planilhas baseadas nas [exibições administrativas personalizadas](https://help.tableau.com/current/server/pt-br/adminview_postgres.htm).

## Vinculação de elementos do painel ao conteúdo

Se você tiver um segundo nível de navegação, use [ações Filtrar](https://help.tableau.com/current/pro/desktop/pt-br/actions_filter.htm) para apontar para um painel secundário em relação ao principal. Para criar links que abrem diretamente as exibições de dados, clique com o botão direito nos objetos Imagem e escolha Definir URL. (No nosso exemplo a seguir, cada seta colorida e texto associado é uma imagem vinculada à URL.) Você pode até mesmo apontar para exibições vazias com fontes de dados pré-carregadas, incentivando os usuários a criar novo conteúdo do Tableau na área de trabalho de criação na Web.

**Dica:** para adicionar hiperlinks a objetos de texto, inclua a URL completa (por exemplo, `http://www.tableau.com`).

![Uma página da Web que exibe um portal de dados para um grupo de saúde, oferecendo a capacidade de explorar dados geográficos e criar exibições personalizadas.](/tableau/current/pt-br/server/pt-br/Img/portal_final.png)

## Publicação, teste e refinamento do seu portal

Publique a pasta de trabalho no seu servidor e distribua a URL do painel aos seus usuários. O design do portal, como a própria análise de dados, é um processo cíclico. Agora que o seu portal está pronto, comece a coletar o feedback do usuário, para que você continue a aprimorar a experiência

**Dica:** como toque final, oculte a barra de ferramentas do Tableau para proporcionar uma sensação de personalização do seu portal. Após o ponto de interrogação no final da URL do painel, adicione `:embed=y&amp;:toolbar=n`

<!-- document id=49c402b7465b9327588acb584e40dc7221c0dd4c06d021f23c7818f48f73efd4 url=/tableau/current/pt-br/server/rmt-ports-comms.md -->

[Pular para o conteúdo principal](#main-content)

# Portas de comunicação do Resource Monitoring Tool do Tableau

Este artigo lista as portas de comunicação que o Resource Monitoring Tool do Tableau usa, a configuração da porta padrão e como alterar essas portas quando seus requisitos de rede precisam que elas sejam diferentes do que é definido por padrão.

## Servidor RMT

Você pode alterar ou atualizar as informações da porta usando:

- o comando [rmtadmin master-setup](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm#rmtadmin_master_setup)
- Interface da Web: na máquina onde o Servidor RMT está instalado, vá para: `http://localhost/setup/server`

### Comunicações do Servidor RMT

Portas utilizadas: 9001, 443 e 80

- A configuração inicialmente é padrão para a porta 9001, mas altera o padrão para 80 após a configuração inicial.
- O certificado autoassinado SSL na instalação inicial é para a porta 443. O Servidor RMT ouve na porta 80 por padrão e tentará encaminhar o tráfego até 443 para SSL. Qualquer certificado especificado pelo usuário também será para a porta 443.
    - Os certificados são usados durante o tráfego do usuário para o Servidor RMT e quando o Agente é registrado usando a interface da Web.
    - Geralmente, não recomendamos a mudança da porta 443. No entanto, você precisa alterar isso devido às restrições do ambiente, listando explicitamente o número da porta ao se conectar ao Servidor RMT. Se você estiver registrando o Agente usando a interface da Web, deverá especificar explicitamente o número da porta para se conectar ao Servidor RMT.
- A porta 80 é usada para tráfego não SSL e pode ser alterada durante a configuração inicial ou após a instalação.
- O Servidor RMT entrará em contato diretamente com o gateway do Tableau Server para chamadas de API REST.
- O Servidor RMT entrará em contato diretamente com o repositório do Tableau Server para consultar informações se as informações do PostgreSQL forem fornecidas (opcional). Para obter informações sobre como configurar o SSL entre o servidor RMT e o repositório do Tableau Server, consulte [Lista de verificação de pré-instalação - Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-install-checklist.htm).

### RabbitMQ

RabbitMQ é o componente (fila de mensagens) usado para intermediar informações entre os Agentes e o Servidor RMT.

Portas utilizadas: 5671, 5672

- O RabbitMQ está instalado e ouve a porta 5671 (TLS), 5672 (não TLS).
- A comunicação TLS para RabbitMQ está ativada por padrão.

### Banco de dados PostgreSQL

Portas utilizadas: 5555

- O banco de dados PostgreSQL está instalado e ouve a porta 5555. Isso não pode ser mudado.
- O PostgreSQL tem um usuário `admin` usado pelo Resource Monitoring Tool. O usuário `readonly` é usado para se conectar ao Banco de dados PostgreSQL do Resource Monitoring Tool em arquivos .tds baixados da interface Web do Resource Monitoring Tool. Para obter mais informações sobre o download de arquivos.tds, consulte [Explorar dados de monitoramento usando arquivos de fonte de dados do Tableau](https://help.tableau.com/current/server/pt-br/rmt-tds-files.htm).
- O PostgreSQL requer autenticação SCRAM-SHA-256. Para obter mais informações, consulte [Explorar dados de monitoramento usando arquivos de fonte de dados do Tableau](https://help.tableau.com/current/server/pt-br/rmt-tds-files.htm).

## Agente

Portas utilizadas: 9002, 443, 5672

- Durante a instalação, o instalador do Agente abre um navegador da Web usado apenas para o registro que ouve na porta 9002.
- Se o registro do Agente for feito usando a interface da Web, o processo de registro usa a porta 443. Se o registro for feito utilizando a linha de comando, o processo de registro passa pelo RabbitMQ e utiliza a porta 5672.
- O agente envia arquivos de registro e informações de WMI através do RabbitMQ pela porta 5672.

<!-- document id=9b820b08532b13024107045ec17b24017d9d4d37c426503f0267be3cec85f342 url=/tableau/current/pt-br/server/ports.md -->

[Pular para o conteúdo principal](#main-content)

# Portas do Tableau Services Manager

Os processos e serviços que compõem o Tableau Services Manager (TSM) e o Tableau Server no Windows usam várias portas para se comunicar. Por padrão, a maioria dessas portas é atribuída (mapeada) dinamicamente de um intervalo de portas predefinido. As atribuições de portas são feitas para cada serviço ou processo na instalação. Você pode controlar as portas usadas de diferentes maneiras.

Um pequeno subconjunto de processos não usa o mapeamento dinâmico de portas e se comporta de maneira exclusiva. Para obter mais informações, consulte [Portas que não estão mapeadas dinamicamente](#PortsNotDynamic) abaixo.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

## Uso de porta efêmera

Se o seu sistema operacional estiver configurado para usar portas temporárias, o tráfego do Tableau poderá ser roteado por meio delas, mesmo quando configurado conforme descrito abaixo. Isso acontece no nível do sistema operacional e não é algo que você possa configurar no Tableau. Se você quiser controlar o uso da porta, consulte a documentação do sistema operacional sobre como limitar o uso da porta efêmera.

## Requisitos do firewall

Se você estiver executando um firewall no computador onde o Tableau Server será instalado, você precisará abrir as seguintes portas padrão para o tráfego do Tableau Server. Todos os números de porta, exceto 443, podem ser alterados.

<table class="simple-table" style=""><colgroup><col style="width: 10%;"><col style="width: 10%;"><col style="width: 50%;"><col><col></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th rowspan="2" style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Porta</th><th rowspan="2" style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">TCP/UDP</th><th rowspan="2" style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Usada por&nbsp;...</th><th colspan="2" class="TableStyle-Basic-Border-HeadD-Column1-Header1">TIPO DE INSTALAÇÃO</th></tr><tr class="TableStyle-Basic-Border-Head-Header1"><th style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Todos</th><th style="vertical-align:bottom;" class="TableStyle-Basic-Border-HeadD-Column1-Header1"><p>Distribuída / Alta disponibilidade</p></th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">80</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Gateway</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">443</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SSL. Quando o Tableau Server estiver configurado para SSL, o servidor de aplicativos redirecionará as solicitações para essa porta. Não altere essa porta.</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8850</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Services Manager.</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8060</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Banco de dados do PostgreSQL.</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8061</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Porta de verificação de backup do PostgreSQL</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><strong>X</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">8000-9000</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Intervalo de portas reservado por padrão para mapeamento dinâmico de processos do Tableau</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><b>X</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">27000-27009</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">TCP</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Intervalo de portas usado pelo Tableau Server para serviço de Licenciamento. Esse intervalo deve estar aberto no nó que executa o serviço de Licenciamento e acessível por meio de outros nós. Por padrão, o nó inicial executa o serviço de Licenciamento.</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="text-align: center;"><b>X</b></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="text-align: center;">&nbsp;</td></tr></tbody></table>

## Atribuição de porta

Há duas abordagens que você pode usar para a atribuição ou o mapeamento de portas no TSM:

- **Atribuição dinâmica de portas**. Esse é o padrão e exige uma intervenção mínima do administrador.
- **Atribuição manual de porta**. Esta opção exige que um administrador atribua individualmente cada porta.

Se você alterar as atribuições de porta e estiver executando um firewall local, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall) .

## Atribuição dinâmica de portas

Você pode controlar quais portas são usadas, alterando o intervalo de portas disponíveis para o processo de atribuição dinâmica. Fazer isso mantém a atribuição dinâmica de porta, mas restringe as portas que podem ser selecionadas. Com a atribuição dinâmica de portas ativa, ainda é possível atribuir portas para determinados processos manualmente. Esta abordagem permite atribuir portas específicas a processos específicos, deixando as outras para o mapeamento dinâmico. Usar o mapeamento dinâmico, com ou sem a atribuição individual de algumas portas, é a abordagem mais fácil e deve atender grande parte das necessidades da maioria dos clientes. As portas atribuídas dinamicamente são mantidas se a configuração do Tableau Server for exportada.

Por padrão, as portas são atribuídas para cada serviço ou processo de portas disponíveis entre 8000 e 9000. Essa atribuição é realizada quando os serviços são instalados pela primeira vez em um nó. Depois que o Tableau Server for inicializado, você poderá ver quais portas estão sendo usadas por quais serviços ou processos, executando este comando:

`tsm topology list-ports`

Se tiver um cluster com vários nós, as portas em todos os nós serão listadas.

### Alteração do intervalo de portas

Para organizações com requisitos específicos para as portas em uso, a maneira mais fácil de controlar a atribuição é alterar o intervalo no qual as portas são dinamicamente selecionadas. É necessário fazer isso na instalação, especificando uma porta mínima e máxima para o intervalo no arquivo de configuração.

**Observação:** o tamanho mínimo permitido para o intervalo de portas dependerá da instalação do seu servidor e da quantidade de serviços ou processos em execução. Como uma prática recomendada geral, você não deve restringir muito o intervalo, pois a atribuição de porta é realizada com a seleção de portas aleatórias dentro do intervalo e, caso não permita um intervalo grande o suficiente, a seleção poderá não encontrar uma porta disponível.

Para limitar o intervalo no qual as portas disponíveis são selecionadas para portas entre 8300 e 8600, seu arquivo de configuração deve incluir uma entrada semelhante a esta:

"configKeys": {  
    "ports.range.min": "8300",
    "ports.range.max": "8600"  
}

### Bloqueio de portas específicas dentro do intervalo

Começando pela versão 2021.1.0, você pode especificar certas portas que estão dentro do intervalo atribuído dinamicamente, mas que não devem ser usadas pelo Tableau. Isso é útil se você tiver outro software em seus computadores com Tableau Server que dependem de portas dentro do intervalo que o Tableau está usando.

Para especificar portas dentro do intervalo que não devem ser usadas pelo TSM e pelo Tableau Server, use a chave de configuração `ports.blocklist`:

tsm configuration set -k ports.blocklist -v <port>\[,<port>,<port>\]

Por exemplo:

tsm configuration set -k ports.blocklist -v 8000,8088, 8090

### Desativação da atribuição dinâmica de portas

Se precisar de um controle de atribuição de portas maior do que o que pode ser obtido com uma combinação de restrição ao intervalo de portas e atribuição individual de portas, é possível desativar o mapeamento dinâmico de portas na configuração inicial do servidor. Desativar o mapeamento dinâmico de portas exige que você atribua manualmente cada porta para cada processo. Por isso, não recomendamos essa abordagem, a menos que você precise controlar todas as atribuições de porta.

Se você desabilitar o mapeamento de portas dinâmicas, deverá configurar a porta para cada processo em cada nó da instalação.

Para desativar o mapeamento dinâmico, o arquivo de configuração deve incluir uma entrada semelhante a esta:

"configKeys": {  
    "service.port\_remapping.enabled": false  
}

**Importante:** ao desativar as atribuições de porta dinâmica, o intervalo de portas do serviço de Licença não é incluído. Esse intervalo (27000-27009) deve estar aberto no nó que executa o serviço de Licença e deve ser acessível de outros nós. Por padrão, o nó inicial executa o serviço de Licenciamento.

## Atribuição manual de porta

Você pode desativar completamente a atribuição automática de portas e atribuir uma porta para cada processo individualmente. Se fizer isso, você deverá atribuir uma porta para cada processo em todos os nós. É possível atribuir portas em um arquivo de configuração ao instalar os processos pela primeira vez ou após a instalação, usando um comando do TSM. Somente as portas atribuídas na instalação do processo são mantidas ao exportar a configuração do Tableau Server.

Você pode especificar portas individuais para processos específicos, com o mapeamento dinâmico ativado ou não. Você pode fazer isso se quiser que um processo utilize uma determinada porta ou se tiver desativado o mapeamento dinâmico. Há duas maneiras de especificar portas para os processos: durante ou após a instalação.

### Configuração de portas durante a instalação

Recomendamos configurar a atribuição de porta durante o processo de instalação, conforme descrito aqui. Alterar portar depois da instalação é um processo mais complexo

Para configurar portas durante a instalação, crie um arquivo json que especifique sua configuração de porta. Esse processo é semelhante à definição de um intervalo de portas não padrão, mas em vez disso, você especifica uma determinada porta para um serviço ou processo específico. Se for atribuir portas específicas, esta abordagem será a forma mais robusta de fazer isso, pois o mapeamento de portas será mantido ao exportar a configuração e a topologia do servidor usando o comando `tsm settings export`.

Para definir as portas na instalação, adicione as informações ao arquivo de configuração para especificar o nó (`workerN`), o processo (`servicename`) e a ID da instância (`instanceid`), o tipo de porta (`porttype`) e a porta a ser usada. O formato é semelhante a este:

`workerN.{servicename}_{instanceid}.{porttype}.port:X`

Onde:

- `workerN` é um parâmetro opcional e identifica o nó ao qual o remapeamento se aplica. Os números de nó começam com zero (0).  
    Recomendamos não incluir este parâmetro, a menos que precise mapear diferentes portas para um mesmo serviço em nós diferentes. Se deixar esse parâmetro desativado, poderá mapear uma porta de serviço no nó inicial ou mapear a mesma porta de serviço em vários nós.
- `servicename` é o nome do processo ou serviço que usará a porta.
- `instanceid` é a instância do processo. Se for configurar várias instâncias de um processo em um nó, precisará incrementar esse valor para cada instância. Comece a instanceid em zero (0) e incremente-a em um (1) para cada instância do processo. Para serviços que instalam somente uma única instância em um determinado nó, isso deve ser desativado.
- `porttype` Caso esteja configurando a porta principal, não inclua essa opção.
- `port` é a porta que o processo ou serviço deverá usar.

Por exemplo, para definir a porta da primeira instância do processo de armazenamento de arquivos no nó inicial para 8500, você deve incluir uma entrada do arquivo de configuração semelhante a esta:

"configKeys": {  
    "filestore\_0.port: "8500"  
}

O exemplo acima não inclui o parâmetro workerN opcional, por isso define a porta em todos os nós no cluster. Também não inclui a opção porttype, porque define a porta principal do armazenamento de arquivos.

**Importante**: ao especificar as alterações de porta com um arquivo de configuração, você deve incluir o parâmetro `--force-keys` com o comando `[tsm settings import](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm#TSMSet)`.

### Configuração de portas depois da instalação

Se precisar alterar portas depois da instalação do Tableau Server, use o comando `tsm topology set-ports`. Essa abordagem permite especificar uma porta para um processo específico após a instalação do processo. Você está restringido pelos seguintes limites:

- Você deve definir as portas individualmente em cada nó.
- Após definir uma porta individual, e´necessário executar o `tsm restart`.
- The port assignments are not preserved if you need to import a Tableau Server configuration using `tsm settings import`.
- Os nomes de porta usam uma sintaxe diferente para comandos do tsm do que a sintaxe para configKeys. A tabela ao final deste tópico fornece uma referência de sintaxe.

Por exemplo, para definir uma segunda instância do armazenamento de arquivos no nó inicial para usar a porta 8500:

`tsm topology set-ports --node-name node1 --port-name filestore --port-value 8500 --instance 2`

O exemplo a seguir mostra como usar comandos abreviados para definir as portas JMX:

`tsm topology set-ports -n node1 --port-name vizqlserver:jmx.rmi -pv 9403 -i 1`

`tsm topology set-ports -n node1 --port-name vizqlserver:jmx -pv 9404 -i 2`

**Observação**: as entradas de porta não são validadas ao inserí-las. Dessa forma, se usar uma porta já atribuída ou se digitar a sintaxe de um comando de forma errada, o Tableau não apresentará o erro até que reinicie. Após reinicializar, poderá ocorrer o erro genérico: Falha na tarefa async ed reconfiguração.  
  
Se você adicionar um `portname:type` incorreto com uma porta válida, não será possível excluir a entrada incorreta. Para atualizar a porta, é necessário reatribuir uma porta não usada a esse valor para liberá-la novamente.

### Portas que não estão mapeadas dinamicamente

O repositório do Tableau Server usa duas portas que não estão mapeadas dinamicamente. Cada uma tem uma porta padrão que pode ser substituída usando o comando `tsm configuration set` e um parâmetro específico do processo.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 20%;"><col style="width: 30%;"><col style="width: 50%;"></colgroup><thead><tr><th>Nomes de porta</th><th>Porta (padrão)</th><th>Descrição</th></tr></thead><tbody><tr><td>pgsql.port</td><td>8060</td><td>Porta para o repositório do Tableau (banco de dados PostgreSQL).<p>Para substituir esta porta:</p><p><code>tsm configuration set -k pgsql.port -v &lt;port&gt;</code></p></td></tr><tr><td>pgsql.verify_restore.port</td><td>8061</td><td>Porta para verificar a integridade de um backup de repositório.<p>para substituir esta porta:</p><p><code>tsm configuration set -k pgsql.verify_restore.port -v &lt;port&gt;</code></p></td></tr></tbody></table>

Como essas portas não usam o sistema de mapeamento dinâmico de portas, elas não são mostradas na saída do comando `tsm topology list-ports`. Para ver o valor delas, é necessário usar o comando `tsm configuration get -k <config.value>`. Por exemplo:

`tsm configuration get -k pgsql.port`

## Portas mapeadas dinamicamente

Esta tabela lista os processos ou serviços que usam portas mapeadas dinamicamente.

| Nomes de porta: sintaxe para arquivo json (configKeys) | Nomes de porta: sintaxe para tsm CLI  | Descrição |
| --- | --- | --- |
| activemqserver.port | activemqserver:primary | Porta de serviço do ActiveMQ Service. |
| activemqserver.openwire.port | activemqserver:openwire | Porta openwire do ActiveMQ Service. |
| appzookeeper\_0.client.port | appzookeeper:client | Porta de cliente do Serviço de coordenação. |
| appzookeeper\_0.peer.port | appzookeeper:peer | Porta com par do Serviço de coordenação. |
| appzookeeper\_0.leader.port | appzookeeper:leader | Porta líder do Serviço de coordenação. |
| backgrounder\_0.port | processador em segundo plano | Porta principal do processador em segundo plano. |
| backgrounder\_0.debug.port | backgrounder:debug | Porta de depuração do processador em segundo plano. |
| backgrounder\_0.jmx.port | backgrounder:jmx | Porta jmx do processador em segundo plano.  |
| backgrounder\_0.jmx.rmi.port | backgrounder:jmx.rmi | Porta jmx rmi do processador em segundo plano. |
| backgrounder\_0.recommendations.trainer.port | backgrounder:recommendations.trainer | Porta de recomendações do processador em segundo plano. |
| backuprestore.port | backuprestore | Porta do serviço de backup/restauração. |
| cacheserver\_0.port | cacheserver | Porta do servidor de cache. |
| clustercontroller.status.port | clustercontroller:status | Porta de status do controlador do cluster. |
| clustercontroller.storage.port | clustercontroller:storage | Porta de armazenamento do controlador do cluster. |
| databasemaintenance.port | databasemaintenance | Porta de manutenção do banco de dados. |
| dataserver\_0.port | dataserver | Porta principal do servidor de dados. |
| dataserver\_0.debug.port | dataserver:debug | Porta de depuração do servidor de dados. |
| dataserver\_0.jmx.port | dataserver:jmx | Porta jmx do servidor de dados. |
| dataserver\_0.jmx.rmi.port | dataserver:jmx.rmi | Porta jmx rmi do servidor de dados. |
| filestore.port | filestore | Porta principal do Armazenamento de arquivo. |
| filestore.status.port | filestore:status | Porta de status do Armazenamento de arquivo. |
| gateway.port | gateway | Porta de gateway. Isso retorna ao padrão 80 e, se não estiver disponível, assume 8080. Se não estiver disponível, tentará 8000. Essa sequência é seguida com a atribuição dinâmica de porta habilitada ou não. Se nenhuma dessas portas estiver disponível e o mapeamento dinâmico estiver habilitado, ele assume uma porta disponível dentro do intervalo definido. A porta de gateway deve ser idêntica em todos os nós de um cluster com vários nós, portanto, se a porta 80 for selecionada no nó inicial, esta será a porta usada em todos os nós e, se ela estiver indisponível em um dos outros nós, ocorrerá uma falha na seleção da porta de gateway |
| hyper.port | hyper | Porta principal do processador de dados. |
| hyper.connection.port | hyper:connection | Porta de conexão do processador de dados. |
| indexandsearchserver.port | indexandsearchserver | Index and Search principal do servidor de pesquisa. |
| indexandsearchserver.transport.port | indexandsearchserver:transport | Porta de transporte do servidor de indexação e pesquisa. |
| licenseservice.vendor\_daemon.port | licenseservice:vendor\_daemon | Porta daemon do fornecedor de serviços de licenciamento. Usada para comunicações relacionadas ao licenciamento entre nós, em uma instalação de vários nós. |
| samlservice.port | samlservice | Porta do serviço SAML. |
| siteimportexport.port | siteimportexport | Porta de importação/exportação do site. |
| tabadmincontroller.port | tabadmincontroller | Porta do Controlador TSM. |
| tabadminagent.columbo.port | tabadminagent:columbo | Porta de descoberta de serviço do Agente de administração |
| tabadminagent.filetransfer.port | tabadminagent:filetransfer | Porta de transferência de arquivo do Agente TSM. |
| vizportal\_0.authentication.port | vizportal:authentication | Porta de autenticação do servidor de aplicativos. |
| vizportal\_0.authorization.port | vizportal:authorization | Porta de autorização do servidor de aplicativos. |
| vizportal\_0.maintenance.port | vizportal:.maintenance | Porta de manutenção do servidor de aplicativos. |
| vizportal\_0.microservice.extensions.port | vizportal:.microservice:extensions | Porta de extensões do servidor de aplicativos. |
| vizportal\_0.monolith\_grpc.port | vizportal:monolith\_grpc | Porta GRPC do servidor de aplicativos. |
| vizportal\_0.publishing.port | vizportal:publishing | Porta de publicação do servidor de aplicativos. |
| vizportal\_0.recommendations.port | vizportal:recommendations | Porta de recomendações do servidor de aplicativos. |
| vizportal\_0.port | vizportal | Porta principal do servidor de aplicativos. |
| vizportal\_0.debug.port | vizportal:debug | Porta de depuração do servidor de aplicativos. |
| vizportal\_0.jmx.port | vizportal:jmx | Porta jmx do servidor de aplicativos. |
| vizportal\_0.jmx.rmi.port | vizportal:jmx.rmi | Porta jmx rmi do servidor de aplicativos. |
| vizqlserver\_0.port | vizqlserver | Porta principal do servidor VizQL. |
| vizqlserver\_0.debug.port | vizqlserver:debug | Porta de depuração do servidor VizQL. |
| vizqlserver\_0.jmx.port | vizqlserver:jmx | Porta jmx do servidor VizQL. |
| vizqlserver\_0.jmx.rmi.port | vizqlserver:jmx.rmi | Porta jmx rmi do servidor VizQL. |

## Outros artigos nesta seção

<!-- document id=01c0ff55f8f598227f3ff3f4faa969a218c9c7109df263fea28394e40074ae31 url=/tableau/current/pt-br/server/rls_bestpractices.md -->

[Pular para o conteúdo principal](#main-content)

# Práticas recomendadas de RLS para fontes de dados e pastas de trabalho

A segurança em nível de linha (RLS) no Tableau restringe as linhas de dados que determinado usuário pode ver em uma pasta de trabalho. É diferente das permissões do Tableau, que controlam o acesso ao conteúdo e à funcionalidade dos recursos. Por exemplo, as permissões controlam se um usuário pode comentar ou editar uma pasta de trabalho, enquanto a segurança em nível de linha permite que dois usuários visualizem o mesmo painel para ver apenas os dados que cada usuário tem permissão.

Há várias maneiras de implementar a RLS no Tableau. Por exemplo, você pode definir a RLS no nível da fonte de dados ou da pasta de trabalho ou pode definir a RLS no nível da conexão usando uma conexão virtual com uma política de dados (requer Data Management). Consulte a [Visão geral das opções de segurança em nível de linha no Tableau](https://help.tableau.com/current/server/pt-br/rls_options_overview.htm) para obter detalhes sobre alternativas.

**Observação**: este tópico se concentra nas práticas recomendadas de RLS para fontes de dados e pastas de trabalho. Para obter exemplos mais detalhados dos conceitos descritos neste tópico, consulte o whitepaper [Práticas recomendadas para segurança em nível de linha](https://www.tableau.com/learn/whitepapers/row-level-security-entitlements-tables) ou [Como configurar o banco de dados para segurança em nível de linha no Tableau](https://tableauandbehold.com/2016/03/07/how-to-set-up-your-database-for-row-level-security-in-tableau/) no blog _Tableau and Behold_.

## Fluxo de trabalho de RLS

Para conexões em tempo real e extrações de várias tabelas, o fluxo de trabalho básico de RLS é o seguinte:

1. O usuário é identificado ao fazer logon no Tableau Server ou no Tableau Cloud
    - Isso requer um nome de usuário diferente por usuário e um logon único (SSO) seguro
    - A REST API do Active Directory, LDAP ou Tableau Server pode ser usada para sincronizar os nomes de usuário e estabelecer as permissões
2. O conjunto de direitos de dados do usuário é recuperado em todos os direitos de dados possíveis
    - Isso requer uma estrutura de dados que possa vincular os direitos ao nome de usuário do Tableau
3. Os dados são filtrados pelos direitos desse usuário
    - Geralmente, isso exige o uso das funções de usuário em um campo calculado
4. Os dados publicados e filtrados são usados para criar conteúdo
    - O uso de uma fonte de dados publicada (em vez de inserida) com um filtro de fonte de dados garante que o RLS não possa ser modificado ao baixar ou editar a pasta de trabalho

A forma como as uniões de colunas, campos calculados e filtros são configurados depende da estrutura dos dados e da forma como os usuários são gerenciados.

## Tabelas de direitos

Qualquer combinação única de atributos em que os dados possam ser filtrados constitui um direito. Mais comumente, existem tabelas separadas para especificar os direitos em si e mapear esses direitos para os usuários ou funções de usuário. A desnormalização é recomendada do ponto de vista do desempenho, pois as uniões de colunas são operações caras.

A exibição de direitos, que consiste nos direitos mapeados para os usuários ou as funções, é unida com os dados. Um filtro de fonte de dados baseado no usuário é aplicado, atuando como uma cláusula WHERE que traz apenas os direitos e - portanto, as linhas de dados apropriadas - para o usuário relevante. (A otimização de consultas deve garantir que a filtragem ocorra antes da união de colunas quando a consulta é processada para minimizar a duplicação de dados. Para obter mais informações, consulte a [Ordem de operações de desempenho e processamento](#Performa).)

### Modelos de tabela de direitos

Geralmente, existem dois modelos para representar direitos:

**Mapeamento completo até o nível de granularidade mais profunda**

- Os direitos são definidos integralmente para cada coluna.
- Há uma linha na tabela de mapeamento para todos os direitos possíveis que o usuário tem.
- Esse modelo requer menos cláusulas de união.

**Direitos esparsos**

- Os direitos são definidos para todos os níveis de hierarquia e NULL é usado para representar um estado de “todos”.
- Há uma única linha na tabela de mapeamento para determinado nível na hierarquia de direitos, o que reduz consideravelmente o número de linhas de direitos para usuários em níveis elevados em uma hierarquia.
- Esse modelo requer uniões de colunas e filtros mais complexos.

### Usuários e funções

As combinações de direitos são comumente representadas como _funções_, que são vinculadas aos usuários em uma tabela de mapeamento de muitos para muitos. Isso permite alterar ou remover facilmente um usuário da função e, ao mesmo tempo, manter um registro da função e seus direitos.

Como alternativa, uma tabela de mapeamento de muitos para muitos pode ser criada que, em vez disso, atribui os usuários diretamente aos direitos e não passa pela união de colunas em uma tabela de funções. Isso requer o gerenciamento de valores mais direto na tabela, mas elimina uma união de colunas.

**Observação**: os valores do usuário associados a uma função ou direito precisam corresponder ao nome de usuário ou nome completo no site do Tableau para aproveitar as funções de usuário no Tableau Desktop.

### Uniões de colunas

Independentemente do modelo usado para representar os direitos, é aconselhável unir colunas em todos os direitos e tabelas de mapeamento para uma única exibição de direitos desnormalizados. Embora a princípio isso cause uma versão “explosiva” (altamente duplicativa) dos direitos, o filtro de fonte de dados no usuário o reduzirá novamente. Você também vai querer essa exibição se planejar usar uma extração.

O método de granularidade mais profunda pode ter um benefício de desempenho quando tudo é hierárquico - basta fazer uma única união de colunas no nível mais profundo da hierarquia. Isso só funciona se todos os atributos no nível mais baixo forem distintos. Se houver uma chance de duplicação (por exemplo, uma sub-região Central em mais de uma região), você precisará unir todas as colunas para alcançar o efeito de um valor-chave distinto.

Os detalhes reais e suas características de desempenho dependem do sistema de dados e exigem testes. Por exemplo, usar uma única chave pode melhorar potencialmente o desempenho, pois a união de colunas está sendo executada apenas em uma coluna, mas a indexação correta de todas as colunas pode resultar no mesmo desempenho quando outros fatores são levados em consideração.

## Implementar a segurança em nível de linha

### Granularidade mais profunda

Após criada a exibição desnormalizada dos direitos mapeados, uma união de colunas interna é configurada entre a exibição e os dados na caixa de diálogo de conexão de dados do Tableau. Os dados podem permanecer em um esquema de estrela tradicional. Como alternativa, as tabelas de dimensões e fatos podem ser materializadas juntas em duas exibições. As extrações de várias tabelas criarão tabelas de extração para corresponder às uniões de colunas, portanto, a criação de duas exibições simplificará a extração resultante. O SQL seguirá este padrão básico:

SELECT \* 
FROM data d INNER JOIN entitlements e ON
d.attribute\_a = e.attribute\_a AND 
d.attribute\_b = e.attribute\_b AND ... 
WHERE e.username = USERNAME()

### Direitos esparsos

Se os direitos são mais semelhantes ao modelo de direitos esparsos, o SQL personalizado para unir colunas de dados aos direitos seria um pouco mais complexo devido aos valores NULL. Conceitualmente, seria parecido com o seguinte: 

SELECT \*
FROM data d 
INNER JOIN entitlements e ON
(e.region\_id = d.region\_id OR ISNULL(e.region\_id) AND
(e.sub\_region\_id = d.sub\_region\_id OR ISNULL(e.sub\_region\_id) AND
(e.country\_id = d.country\_id OR ISNULL(e.country\_id)

Sem o uso de SQL personalizado, isso pode ser realizado com uma união de colunas cruzada e filtros adicionais no Tableau Desktop. Crie um cálculo de união de colunas nos dois lados da caixa de diálogo da união de colunas, que consiste simplesmente no número inteiro 1, e defina-os como iguais. Essa ação une colunas de todas as linhas da tabela de dados a todas as linhas da tabela de direitos.

Então é necessário um cálculo (ou cálculos individuais) para explicar os níveis na hierarquia. Por exemplo, você pode ter vários cálculos que seguem este formato: `[region_id] = [region_id (Entitlements View)] OR ISNULL([region_id (Entitlements View)]`

Ou você pode ter um cálculo combinado para todos os níveis em um:

(\[region\_id\] = \[region\_id (Entitlements View)\] OR ISNULL(\[region\_id (Entitlements View)\])
AND
(\[sub\_region\_id\] = \[sub\_region\_id (Entitlements View)\] OR ISNULL(\[sub\_region\_id (Entitlements View)\])
AND
(\[country\_id\] = \[country\_id (Entitlements View)\] OR ISNULL(\[country\_id (Entitlements View)\])

A função ISNULL corresponde a qualquer coluna de direitos para todos os itens da outra coluna. Como sempre ocorre com a RLS, esses cálculos devem ser adicionados como filtros de fonte de dados.

### Filtros de fonte de dados

Para ambas as abordagens, depois que as colunas de direitos e dados foram unidas corretamente, um filtro precisa ser configurado para limitar os dados para um usuário específico. Um campo calculado deve ser criado com uma função de usuário. Por exemplo, uma comparação booliana simples para ver se o usuário listado no campo Nome de usuário é o mesmo Nome de usuário da pessoa conectada no site do Tableau: `[Username] = USERNAME()`

Esse cálculo deve ser usado como filtro de fonte de dados (onde TRUE é selecionado).

Se a fonte de dados for inserida e um usuário tiver permissões para editar na Web ou baixar a pasta de trabalho, a RLS não existe pois os filtros que a impõem podem ser facilmente removidos. A fonte de dados do Tableau deve ser publicada separadamente, em vez de ser inserida na pasta de trabalho.

### Acesso integral com granularidade mais profunda

Há também um cenário comum em que existem dois níveis de acesso dentro da organização: pessoas que podem ver tudo (“acesso integral”) ou pessoas com algum subconjunto de direitos consideravelmente definível. Isso é observado mais comumente para aplicativos inseridos - a organização que hospeda os dados pode ver tudo, mas cada cliente só pode ver seus próprios dados. Nesse caso, você precisa de uma maneira de devolver os dados completos para os usuários com “acesso integral”, mantendo as uniões de colunas de granularidade mais profunda para todos os outros usuários.

Para essa técnica, você usará os grupos do Tableau para criar uma substituição, usando um cálculo na condição de união.

1. Crie um grupo para usuários que devem ver todos os dados (aqui chamado de Acesso integral)
2. Na exibição de fatos, crie uma união esquerda com duas condições de união
    - A primeira condição de união deve estar na coluna que representa o nível de granularidade mais profunda
    - A segunda condição de união deve ter dois cálculos:
        - No lado esquerdo (a exibição de fatos), para o cálculo, digite `True`
        - No lado direito (a exibição de direitos), o cálculo deve ser: `IF ISMEMBEROF('All Access') THEN False ELSE True END`
3. Em uma planilha, crie um cálculo estruturado como: `[Username] = USERNAME() OR ISMEMBEROF(['All Access'] ([Entitlements View)])`
4. Crie um filtro de fonte de dados no cálculo do nome de usuário

Se um usuário for membro do grupo de Acesso integral, a união de colunas se torna uma união esquerda em `True = False`. Isso significa que não há correspondências na exibição de direitos, portanto, toda a exibição de fatos é devolvida com NULLs para as colunas da exibição de direitos (duplicação zero). No caso em que o usuário não faz parte do grupo de Acesso integral, a condição de união `True = True` não muda nada e a união de colunas funcionará como esperado.

O cálculo do usuário usado como filtro de fonte de dados é true para todas as linhas, quando a substituição de grupo está funcionando, ou filtrará apenas a granularidade mais profunda do usuário na hierarquia.

### Ordem de operações de desempenho e processamento

Quando uma visualização é feita no Tableau Desktop, Tableau Server ou Tableau Cloud, o Tableau envia uma consulta otimizada para o RDBMS, que processa a consulta e devolve os resultados ao Tableau, para renderizar a visualização com os dados resultantes. A ordem de operações de quando as uniões de colunas, cálculos e filtros são realizados depende do otimizador de consultas e de como a consulta é executada.

#### Conexões em tempo real

Ao usar uma conexão em tempo real com uma fonte de dados no Tableau, o desempenho da execução de consultas depende do otimizador de consultas que traduz o SQL de entrada em um plano eficiente para recuperar os dados.

Há duas maneiras de processar a consulta:

1. Filtrar as linhas de direitos para o usuário e depois unir colunas para a tabela de fatos
2. Unir colunas de direitos para a tabela de fatos e depois filtrar para as linhas do usuário

Em uma situação ideal, o otimizador de consultas garantirá que o banco de dados processe a consulta _filtrando e depois unindo colunas._ Se um usuário tiver direito a tudo, isso significa que o número máximo de linhas processadas será o número de linhas na tabela de dados.

Se o banco de dados processar a consulta _unindo colunas e depois filtrando,_ pode haver duplicação de dados. O número máximo de linhas processadas será o número de usuários autorizados a ver essa linha específica vezes cada linha na tabela de dados.

Ficará claro se esse segundo cenário acontecer: as consultas levam muito tempo para terminar, você recebe erros ou há uma indicação de problemas de desempenho no banco de dados. O volume total de dados aumentará exponencialmente, o que pode causar uma sobrecarga excessiva no sistema no back-end.

#### Extrações

Quando a fonte de dados no Tableau é uma conexão em tempo real, o Tableau envia todas as consultas necessárias para renderizar uma visualização ou painel específico para o RDBMS. Quando a fonte de dados é uma extração, o processo de consulta de dados da fonte de dados subjacente só acontece na criação e atualização de extração. Todas as consultas individuais para visualizações são respondidas pelo mecanismo de extração do arquivo de extração.

O mesmo problema da ordem de operações está presente na criação de extrações de tabela única. No entanto, a “explosão” acontecerá na fonte de dados subjacente e dentro da própria extração resultante.

## Considerações sobre extrações

A partir da versão 2018.3, o processador de dados pode criar uma extração de várias tabelas e a RLS pode ser implementada conforme descrito acima. O uso de extrações de várias tabela reduz o tempo necessário para gerar uma extração com relações de muitos para muitos, não materializando a união de colunas.

A extração deve ser criada com um _objeto de dados_ e um _objeto de direitos_. Este é o armazenamento mais simples na extração e resulta no melhor desempenho.

- O _objeto de dados_ é a tabela, exibição ou consulta de SQL personalizado que representa a combinação desnormalizada das tabelas de fatos e dimensões necessárias
- O _objeto de direitos_ é uma tabela, exibição ou consulta de SQL personalizado desnormalizada de quaisquer direitos necessários para filtrar os dados no nível mais granular, o que requer:
    - Uma coluna para o nome de usuário que corresponda aos nomes de usuário exatos no Tableau Server ou no Tableau Cloud
    - Uma linha para cada um dos direitos mais granulares para o objeto de dados

Esse formato é apresentado no método de granularidade mais profunda acima. As extrações de várias tabelas usam o mesmo método, com a ressalva de que as colunas de apenas dois objetos de dados estão sendo unidas e qualquer filtragem específica de campo já é aplicada no objeto.

Como os filtros das extrações de várias tabelas são desativados, você pode filtrar as extrações ou tabelas conectadas na fonte de dados ou definir os filtros nos objetos de SQL personalizado na caixa de diálogo de conexão de dados do Tableau.

**Observação**: como ocorre com as conexões em tempo real, se a fonte de dados for inserida e um usuário tiver permissões para editar na Web ou baixar a pasta de trabalho, a RLS não existe pois os filtros que a impõem podem ser facilmente removidos. A extração deve ser publicada separadamente, em vez de ser inserida na pasta de trabalho.

### Extrações de tabela única

O seguinte método é recomendado somente ao usar uma versão do Tableau anterior a 2018.3 - as extrações de várias tabelas são preferenciais, se disponíveis.

As extrações de tabela única materializam as uniões de colunas criadas ao construir a fonte de dados do Tableau e armazena tudo como uma tabela única por meio de uma consulta e os resultados são transformados em uma tabela única no arquivo de extração. Essa desnormalização acarreta o risco de causar uma enorme duplicação de dados, já que cada linha que foi alocada para mais de um direito ou usuário seria duplicada como resultado da relação de muitos para muitos.

Para evitar essa duplicação:

1. Crie um Campo de usuários de segurança que contenha os nomes de usuário para esse direito
    - por exemplo, um valor pode ser “bhowell|mosterheld|rdugger”
2. Use a função CONTAINS() no Tableau para identificar usuários individuais corretamente
    - Por exemplo, `CONTAINS([Security Users Field], USERNAME())`

Obviamente, esse método tem algumas ressalvas. Ele exige que você acesse seus direitos nas linhas para uma única coluna separada corretamente usando SQL e essa coluna só pode conter tantos caracteres. Correspondências parciais podem se tornar problemas e você precisa usar separadores que nunca serão válidos nas IDs em si. Embora tenha um bom desempenho no Processador de dados do Tableau, como cálculo de cadeia de caracteres, será muito lento para a maioria dos bancos de dados. Isso limita a capacidade de voltar a uma conexão em tempo real.

Como alternativa, você pode usar diferentes extrações por “função” ou nível de direito, para que apenas os dados apropriados para essa pessoa ou nível estejam incluídos na extração, mas isso exigirá processos de permissão adequados e aproveitará a publicação de modelos no Tableau Server, geralmente por meio de APIs.

## Usar segurança em nível de linha integrada em um banco de dados

Muitos bancos de dados têm mecanismos para RLS integrada. Se sua organização já criou a segurança em nível de linha em uma fonte de dados, você poderá tirar proveito da RLS existente. Não é necessariamente mais fácil ou melhor implementar um modelo de RLS integrada, em comparação a criá-la tendo em mente o Tableau. Geralmente, essas técnicas são utilizadas quando uma organização já investiu nessas tecnologias e querem aproveitar o investimento. O principal benefício de usar a RLS integrada é que os administradores podem implementar e controlar a respectiva política de segurança de dados em um local: nos respectivos bancos de dados. Para obter mais informações, consulte [Segurança em nível de linha no banco de dados](https://help.tableau.com/current/server/pt-br/rls_datasource.htm).

<!-- document id=8cda51795c8dc8a8ba8d2441d0bf9fc950783a2991bd2f47865a9e772aa15fca url=/tableau/current/pt-br/server/ts_alibaba_best_practices.md -->

[Pular para o conteúdo principal](#main-content)

# Práticas recomendadas para a instalação do Tableau Server em Alibaba Cloud

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

As práticas recomendadas a seguir tornam a instalação do Tableau Server na nuvem uma experiência melhor.

- Leia a seção [Planejamento da sua implantação](https://help.tableau.com/current/server/pt-br/plan.htm) do Tableau Server.
- Leia o Tableau Server nos [Pré-requisitos da Alibaba Cloud](https://help.tableau.com/current/server/pt-br/ts_alibaba_prerequisites.htm).
- Leia a [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm) para o Tableau Server.
- Se essa é a sua primeira vez na nuvem, use a [Versão gratuita da Alibaba Cloud](https://www.alibabacloud.com/campaign/free-trial) para se familiarizar com o funcionamento da nuvem antes de implantar o Tableau Server na Alibaba Cloud.
- Leia sobre e entenda a [topologia de rede](https://www.alibabacloud.com/help/doc-detail/34217.htm) na Alibaba Cloud e como arquitetá-la.

## Como manter os custos baixos

A Alibaba Cloud oferece serviços com base na nuvem na base do pague o quanto usar. Os custos são determinados pelos serviços executados e por quanto tempo são usados. Diferentes combinações de tipos e tamanhos de instâncias têm custos diferentes. Para obter mais informações sobre preço de serviços, consulte [Preços da Alibaba Cloud](https://www.alibabacloud.com/pricing). É possível estimar os custos mensais totais por meio da [Calculadora de preços da Alibaba Cloud](https://www.alibabacloud.com/pricing-calculator#/).

Para ajudar no monitoramento e controlar os custos de uso de modo contínuo, é possível definir um alerta de cobrança na Alibaba Cloud, para enviar um e-mail quando os custos mensais da Alibaba Cloud atingirem seu limite de despesas predefinido:

1. No console da Alibaba Cloud, clique em Gerenciamento de cobrança.
2. Na página Visão geral da conta, ao lado de Alerta de despesas mensais, clique em Configuração.
3. Na caixa de diálogo Alerta de despesas mensais, ative os alertas de despesas mensais, insira o limite de despesas e defina o destinatário de e-mail que deve ser notificado quando as despesas atingirem o limite definido.
4. Clique em Salvar.

Para obter mais informações sobre como rastrear as despesas, consulte [Como ver as despesas da instância](https://www.alibabacloud.com/help/doc-detail/106929.htm) no site da Alibaba.

<!-- document id=97c01867bd3e863927b4393d1b8ec0fe55818d1d40f1e72c8387f13f110e8b78 url=/tableau/current/pt-br/server/ts_aws_best_practices.md -->

[Pular para o conteúdo principal](#main-content)

# Práticas recomendadas para a instalação do Tableau Server na Amazon Web Services

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

As práticas recomendadas a seguir tornam a instalação do Tableau Server na nuvem uma experiência melhor.

- Leia a seção [Planejamento da sua implantação](https://help.tableau.com/current/server/pt-br/plan.htm) do Tableau Server.
- Leia [O que você precisa antes de começar](https://help.tableau.com/current/server/pt-br/ts_aws_prerequisites.htm).
- Leia a [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm) para o Tableau Server.
- Se essa é a sua primeira vez usando a nuvem, use a [Versão gratuita da AWS](https://aws.amazon.com/free/) para se familiarizar com o funcionamento da nuvem antes de implantar o Tableau Server na AWS.
- Leia sobre e entenda a [topologia de rede da AWS](http://docs.aws.amazon.com/gettingstarted/latest/awsgsg-intro/gsg-aws-compute-network.html) e como arquitetá-la.
- Utilize uma [interface de rede elástica da Amazon](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_ElasticNetworkInterfaces.html) para fornecer um endereço MAC estático para a instância Amazon EC2.

## Como manter os custos baixos

A AWS oferece serviços com base na nuvem na base do pague o quanto usar. Os custos são determinados pelos serviços executados e por quanto tempo são usados. Diferentes combinações de tipos e tamanhos de instâncias têm custos diferentes. Para obter mais informações sobre o preço dos serviços, consulte [Preços da AWS](https://aws.amazon.com/pricing/) no site da AWS. É possível estimar os custos mensais totais por meio da [Calculadora mensal simples da AWS](http://calculator.s3.amazonaws.com/index.html) no site da AWS. Também é possível comparar o custo do uso local versus o da nuvem por meio das [Calculadoras de custo total (Total Cost of Ownership, TCO) da AWS](https://aws.amazon.com/tco-calculator/) no site da AWS.

Para ajudar no monitoramento e controlar os custos de uso de modo contínuo, é possível usar a Amazon CloudWatch para alertá-lo quando os custos mensais da AWS atingirem um limite de despesas predefinido. Para obter mais informações, consulte [Como monitorar seus custos estimados por meio da CloudWatch](http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/gs_monitor_estimated_charges_with_cloudwatch.html) no Guia do usuário da Amazon CloudWatch no site da AWS.

<!-- document id=2d531628eb38fcc29b52e856f65594a24c47df4c5c6cf7d420c64761dace9a3a url=/tableau/current/pt-br/server/ts_gcp_best_practices.md -->

[Pular para o conteúdo principal](#main-content)

# Práticas recomendadas para a instalação do Tableau Server no Google Cloud Platform

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

As práticas recomendadas a seguir tornam a instalação do Tableau Server na nuvem uma experiência melhor.

- Leia a seção [Planejamento da sua implantação](https://help.tableau.com/current/server/pt-br/plan.htm) do Tableau Server.
- Leia o Tableau Server nos [Pré-requisitos do Tableau Server no Google Cloud Platform](https://help.tableau.com/current/server/pt-br/ts_gcp_prerequisites.htm).
- Leia a [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm) para o Tableau Server.
- Se essa é a sua primeira vez na nuvem, use a [Versão gratuita do Google Cloud Platform](https://cloud.google.com/free/) para se familiarizar com o funcionamento da nuvem antes de implantar o Tableau Server no Google Cloud Platform.
- Leia as práticas recomendadas da Plataforma Google Cloud [para organizações corporativas](https://cloud.google.com/docs/enterprise/best-practices-for-enterprise-organizations).
- Leia sobre e entenda a [topologia de rede](https://cloud.google.com/vpc/docs/vpc) no Google Cloud Platform e como arquitetá-la.

## Como manter os custos baixos

O Google Cloud Platform oferece serviços com base na nuvem na base do pague o quanto usar. Os custos são determinados pelos serviços executados e por quanto tempo são usados. Diferentes combinações de tipos e tamanhos de instâncias têm custos diferentes. Para obter mais informações sobre preço de serviços, consulte [Preços do Google Cloud Platform](https://cloud.google.com/pricing/). É possível estimar os custos mensais totais por meio da [Calculadora de preços do Google Cloud Platform](https://cloud.google.com/products/calculator/). Também é possível comparar o custo do uso local ao da nuvem por meio das [Calculadoras de TCO (Custo total de propriedade) do Google Cloud Platform](https://cloud.google.com/pricing?authuser=0&hl=fi#calculators).

Para ajudar no monitoramento e controlar os custos de uso de modo contínuo, é possível definir alertas de cobrança para o Google Cloud Platform alertá-lo quando os custos mensais do Google Cloud Platform atingirem seu limite de despesas predefinido. Para obter mais informações, consulte [Definir orçamentos e alertas](https://support.google.com/cloud/answer/6293540?visit_id=0-636416330629139015-862362861&rd=1) no site do Google.

<!-- document id=522d7086d410664c39a846f22b2a5acbdd3a9adc81e99fda19472f2cda27f0d5 url=/tableau/current/pt-br/server/ts_azure_best_practices.md -->

[Pular para o conteúdo principal](#main-content)

# Práticas recomendadas para a instalação do Tableau Server no Microsoft Azure

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

As práticas recomendadas a seguir tornam a instalação do Tableau Server na nuvem uma experiência melhor.

- Leia a seção [Planejamento da sua implantação](https://help.tableau.com/current/server/pt-br/plan.htm) do Tableau Server.
- Leia [O que você precisa antes de começar](https://help.tableau.com/current/server/pt-br/ts_azure_prerequisites.htm).
- Leia a [Lista de verificação do reforço de segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm) para o Tableau Server.
- Se essa for a sua primeira vez na nuvem, use a [Versão gratuita do Azure](https://azure.microsoft.com/pt-br/free/) para se familiarizar com o funcionamento da nuvem antes de implantar o Tableau Server no Microsoft Azure.
- Leia sobre e entenda a [topologia de rede](https://docs.microsoft.com/pt-br/azure/architecture/reference-architectures/hybrid-networking/) no Microsoft Azure e como arquitetá-la.

## Como manter os custos baixos

O Microsoft Azure oferece serviços na nuvem com pagamento conforme o uso. Os custos são determinados pelos serviços executados e por quanto tempo são usados. Diferentes combinações de tipos e tamanhos de instâncias têm custos diferentes. Para obter mais informações sobre preço de serviços, consulte [Preços do Azure](https://azure.microsoft.com/pt-br/pricing/calculator/). É possível estimar os custos mensais totais por meio da [Calculadora de preços do Microsoft Azure](https://azure.microsoft.com/pt-br/pricing/calculator/). Também é possível comparar o custo do uso local versus o da nuvem por meio da [Calculadora do TCO (Custo Total de Propriedade) do Microsoft Azure](http://tco.microsoft.com/br).

Para ajudar no monitoramento e controlar os custos de uso de modo contínuo, é possível definir alertas de cobrança para o Microsoft Azure alertá-lo quando os custos mensais do Microsoft Azure atingirem seu limite de despesas predefinido. Para obter mais informações, consulte [Configurar alertas de cobrança ou de crédito para assinaturas do Microsoft Azure](https://docs.microsoft.com/pt-br/azure/billing/billing-set-up-alerts) no site do Microsoft Azure.

<!-- document id=c1f015225e9b31d6bdc35480ecb72fe01a90a2f4ee84dbfac8fd2d793d041bae url=/tableau/current/pt-br/server/upgrade_best_practices_server.md -->

[Pular para o conteúdo principal](#main-content)

# Práticas recomendadas para atualizar o Computador com Tableau Server

Este tópico fornece as etapas para fazer pequenas atualizações de versão ou patches em um computador executando o Tableau Server.

**Importante:** qualquer versão principal do sistema operacional ou atualização do kernel do sistema Linux. (por exemplo: Windows 2019 para Windows 2022) deve ser feito usando as diretrizes Azul/Verde. **Não faça uma atualização de versão principal diretamente em uma máquina que já esteja executando o Tableau Server.** Mesmo se você seguir as etapas abaixo, o Tableau Server ficará em um estado instável se for iniciado.  
  
**Fazer uma atualização de versão principal do sistema operacional diretamente em uma máquina que esteja executando o Tableau Server tornará a instalação do Tableau Server incompatível.**  
  
Para obter mais detalhes sobre as atualizações azul/verde, consulte [Utilização de uma abordagem azul/verde para atualizar o Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-blue-green.htm).

Para fazer uma atualização de versão secundária ou um patch do sistema operacional ou do kernel Linux de um computador executando o Tableau Server:

1. Use o TSM para interromper o Tableau Server:
    
    Em um prompt de comando, digite: `tsm stop` e aguarde até que todos os serviços sejam completamente interrompidos.
2. Pare os serviços administrativos do TSM executando o script `stop-administrative-services`, por padrão:
    
    `C:\Program Files\Tableau\Tableau Server\packages\scripts.<Build number>\stop-administrative-services.cmd`
3. Aplique o patch no sistema operacional conforme as instruções da sua equipe de TI ou do fornecedor do sistema operacional para todos os nós do cluster.
4. Se o patch exigir uma reinicialização do sistema operacional, certifique-se de que todos os hosts no cluster do Tableau Server concluam a reinicialização antes de reiniciar o Tableau Server.
5. Inicie o Tableau Server com o TSM:
    
    Em um prompt de comando, digite: `tsm start` e aguarde até que todos os serviços sejam completamente iniciados.

<!-- document id=0e5dd167cb1b39594c331a54f8726b9df95410ce629903c5bb16314bb6bf170f url=/tableau/current/pt-br/server/ts_alibaba_prerequisites.md -->

[Pular para o conteúdo principal](#main-content)

# Pré-requisitos

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Para trabalhar com o Tableau Server na Alibaba Cloud, será necessário:

- Uma conta de nuvem Alibaba. Se ainda não tiver um, [crie uma nova conta](https://account.alibabacloud.com/register/intl_register.htm) .
- Uma licença do Tableau Server.
    
    - Para uma implantação autônoma do Tableau Server, você deve [entrar em contato com vendas](https://www.tableau.com/pt-br/about/contact#contact_sales) para obter uma chave do produto.
    - Para uma implantação baseada em cluster, é necessário ter uma licença baseada no usuário (que cobre todos os usuários autorizados do Tableau Server), uma licença baseada em núcleo (com um mínimo de 16 núcleos) ou uma licença por assinatura do Tableau Server. Para obter uma chave do produto, [entre em contato com o departamento de vendas](https://www.tableau.com/pt-br/about/contact#contact_sales).
    
    Para obter mais informações sobre as opções de licenciamento do Tableau Server, consulte [Visão geral de licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

<!-- document id=890eb71eb14289094e9717c7a0415dc9c584df9491eb9086e9261967e906183a url=/tableau/current/pt-br/server/ts_aws_prerequisites.md -->

[Pular para o conteúdo principal](#main-content)

# Pré-requisitos

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Antes de implantar o Tableau Server na AWS, você deve ter o seguinte:

- Uma conta da AWS.
- Um par de chaves do Amazon EC2.
    
    Para obter mais informações, consulte [Pares de chaves do Amazon EC2 e instâncias do Windows](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html) no Guia de usuário do Amazon EC2 para instâncias do Windows no site da AWS.
- Uma licença do Tableau Server.
    
    - Para uma implantação autônoma do Tableau Server, você deve [entrar em contato com vendas](https://www.tableau.com/pt-br/about/contact#contact_sales) para obter uma chave do produto.
    - Para uma implantação baseada em cluster, é necessário ter uma licença baseada no usuário (que cobre todos os usuários autorizados do Tableau Server), uma licença baseada em núcleo (com um mínimo de 16 núcleos) ou uma licença por assinatura do Tableau Server. Para obter uma chave do produto, [entre em contato com o departamento de vendas](https://www.tableau.com/pt-br/about/contact#contact_sales).
    
    Para obter mais informações sobre as opções de licenciamento do Tableau Server, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).
- (Opcional) Um domínio gerenciado pelo Amazon Route 53.
- (Opcional) Um certificado SSL gerenciado pelo AWS Certificate Manager na região onde o Tableau Server é implantado.
- Armazenamento da instância da Amazon EC2 (um SSD de uso geral (gp2) é recomendado).
- (Opcional) Um endereço IP elástico se não estiver usando ELB ou Amazon Route53.

<!-- document id=d3fbbcea1d52520a47b33f3801bc030bcbc4a4475610d4bd2207385748d243c3 url=/tableau/current/pt-br/server/ts_azure_prerequisites.md -->

[Pular para o conteúdo principal](#main-content)

# Pré-requisitos

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Antes de implantar o Tableau Server no Microsoft Azure, você deve ter o seguinte:

- Uma assinatura do Microsoft Azure. Se ainda não tiver uma assinatura, você poderá se registrar para uma avaliação gratuita no site [Avaliação gratuita do Microsoft Azure](https://azure.microsoft.com/en-us/pricing/free-trial/).
- Uma licença do Tableau Server.
    
    - Para uma implantação autônoma do Tableau Server, você deve [entrar em contato com vendas](https://www.tableau.com/pt-br/about/contact#contact_sales) para obter uma chave do produto.
    - Para uma implantação baseada em cluster, é necessário ter uma licença baseada no usuário (que cobre todos os usuários autorizados do Tableau Server), uma licença baseada em núcleo (com um mínimo de 16 núcleos) ou uma licença por assinatura do Tableau Server. Para obter uma chave do produto, [entre em contato com o departamento de vendas](https://www.tableau.com/pt-br/about/contact#contact_sales).
    
    Para obter mais informações sobre as opções de licenciamento do Tableau Server, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).
- Microsoft Remote Desktop instalado no computador. Você usa o Remote Desktop para fazer logon na VM que hospeda o Tableau Server. O Remote Desktop está pré-instalado nos sistemas operacionais baseados no Windows. Se usar um Mac, você poderá instalar o Remote Desktop como um cliente no [Centro de Download da Microsoft](https://www.microsoft.com/en-us/p/microsoft-remote-desktop/9wzdncrfj3ps?activetab=pivot:overviewtab). Caso esteja se conectando de um computador com o Linux, você poderá usar [rdesktop](http://www.rdesktop.org/) para se conectar à VM do Azure com o Microsoft Windows em execução. Para obter mais informações, consulte [Como se conectar e fazer logon em uma máquina virtual do Azure executando o Windows](https://docs.microsoft.com/pt-br/azure/virtual-machines/windows/connect-logon) no site do Microsoft Azure.
- Instalador do Tableau Server. Você pode baixar o instalador na página [Download da versão de avaliação do Tableau Server](http://www.tableau.com/pt-br/products/server/download).

<!-- document id=76596d1841724c3383c1b755572c4d4d9c2783cda609a31cd77724cfe25b8213 url=/tableau/current/pt-br/server/ts_gcp_prerequisites.md -->

[Pular para o conteúdo principal](#main-content)

# Pré-requisitos

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Para trabalhar com o Tableau Server na Google Cloud Platform, será necessário:

- Uma conta da Google Cloud Platform. Se ainda não tiver um, [crie uma nova conta](https://cloud.google.com/contact/) .
- Uma licença do Tableau Server.
    
    - Para uma implantação autônoma do Tableau Server, você deve [entrar em contato com vendas](https://www.tableau.com/pt-br/about/contact#contact_sales) para obter uma chave do produto.
    - Para uma implantação baseada em cluster, é necessário ter uma licença baseada no usuário (que cobre todos os usuários autorizados do Tableau Server), uma licença baseada em núcleo (com um mínimo de 16 núcleos) ou uma licença por assinatura do Tableau Server. Para obter uma chave do produto, [entre em contato com o departamento de vendas](https://www.tableau.com/pt-br/about/contact#contact_sales).
    
    Para obter mais informações sobre as opções de licenciamento do Tableau Server, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

<!-- document id=0cbd5d064ff47febb1df21fc4c7220d8e2b4c0314ad5e2761f61e48a2d660310 url=/tableau/current/pt-br/server/server-helm-prerequisites.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server Helm Chart - Pré-requisitos

**Importante**: esta documentação pressupõe um conhecimento do Helm e de Helm Charts e não tenta fornecer exemplos prescritivos detalhados. Ele foi criado para clientes que estão familiarizados com o Tableau Server e com o Helm e Helm Charts.

Este tópico explica os pré-requisitos necessários para usar um Helm Chart para implantar o Tableau Server.

## Download e distribuição do Helm Chart

Os Helm Charts serão enviados como parte da ferramenta de configuração Tableau Server em um contêiner (`tableau-server-container-setup-tool-<version>.tar.gz`) e pode ser baixado na página [Download do Tableau Server](http://tableau.com/pt-br/support/releases/server/latest).

Após a extração, os arquivos dos Helm Charts necessários ficam em `helm/tableau` .

## Ferramentas necessárias

- CLI `kubectl` configurado para acessar seu cluster Kubernetes
- CLI `helm` versão 3.x e posterior
- Acesso a um cluster Kubernetes (1.19+)

## Requisitos do cluster

- Pelo menos um nó com 16 GB de RAM e 4 núcleos de CPU (8 núcleos é o recomendado).
- StorageClass configurado para provisionamento dinâmico de PersistantVolume.
- Capacidade de criar serviços de Load Balancer ou recursos Ingress.

## Informações necessárias

Certifique-se de que você tenha o seguinte antes de começar:

- Sua **chave de ativação de licença** do Tableau Server
- O **Administrador do TSM `username` e** `**password**` para a conta inicial
- O **hostname** do Tableau Server para acesso

## Pré-requisitos do Amazon Elastic Kubernetes Service (EKS)

### StorageClass `efs-bootstrap`

Por padrão, `efs-bootstrap` não é criado no EKS. Para compartilhamento de bootstrap com múltiplos nós, crie-o antes da instalação do Helm.

Para uma implantação com múltiplos nós, o armazenamento de bootstrap deve ser provisionado antes que os pods possam ser agendados. Se o seu StorageClass `efs-bootstrap` não provisiona dinamicamente volumes de EFS, você deve:

- Criar um PV de bootstrap estático com antecedência e vinculá-lo a `tableau-server-bootstrap`
    
    ou
- Defina `persistence.bootstrap.createPV: true` e forneça `valid persistence.bootstrap.pv.csi.volumeHandle` (ID do EFS real, fs...).

Se isso não for feito, os pods permanecerão em um estado Pending com os PVCs não associados.

1. Verifique se o driver CSI do EFS está instalado no seu cluster.
    
    kubectl get csidriver efs.csi.aws.com
    
    Um objeto `CSIDriver` pode existir mesmo quando o complemento gerenciado pelo EKS não estiver instalado. Confirme o complemento explicitamente.
    
    Se você receber um erro `ResourceNotFoundException` (sem complemento) ou se os pods falharem posteriormente com erros de montagem, como `driver name efs.csi.aws.com not found in the list of registered CSI drivers`, instale o complemento EKS e aguarde até que o status seja ACTIVE e, em seguida, verifique os pods de plugin do nó.
    
    Isso é necessário porque o bootstrap com múltiplos nós usa um volume com EFS (readWrateMany). Sem o plugin de nó do CSI do EFS em nós adicionais, os PVCs de bootstrap podem ser associados, mas as montagens falham e os pods permanecem com estado `Init/Pending`.
    
    Se as montagens EFS falharem com:
    
    is not authorized to perform: elasticfilesystem:DescribeMountTargets
    
    ou
    
    Failed to resolve "fs-....efs.<region>.amazonaws.com"
    
    Use uma destas remediações:
    
    - **Correção IAM na função de nó EKS** (Preferencial): conceda permissões de leitura de EFS e EC2 para montar o trabalho de descoberta de destino e AZ. Resolva o nome da função da instância do nó no grupo de nós:
        
        aws eks list-nodegroups --cluster-name <cluster-name>  
        aws eks describe-nodegroup \\  
        \--cluster-name <cluster-name> \\  
        \--nodegroup-name <nodegroup-name> \\  
        \--query "nodegroup.nodeRole" \\  
        \--output text
    - **Use o \*\*nome da função\*\* IAM** (último segmento do ARN) em `attach-role-policy`:
        
        aws iam attach-role-policy \\  
        \--role-name <your-node-instance-role> \\  
        \--policy-arn arn:aws:iam::aws:policy/AmazonElasticFileSystemClientReadWriteAccess
        
        aws iam attach-role-policy \\  
        \--role-name <your-node-instance-role> \\  
        \--policy-arn arn:aws:iam::aws:policy/AmazonEC2ReadOnlyAccess
        
        - Permissões comuns envolvidas:
            
            - elasticfilesystem:DescribeMountTargets, 
                elasticfilesystem:DescribeFileSystems
            - `ec2:DescribeAvailabilityZones` (muitas vezes necessário quando `DescribeAvailabilityZones` aparece em erros de montagem)
    - **montar explicitamente o IP de destino**: defina `mounttargetip` nos atributos de volume PV CSI de bootstrap quando DNS/descoberta é restrito no seu ambiente.
        
        - Valores do Helm (caminho `createPV: true`):
            
            persistence:  
              bootstrap:  
                pv:  
                  csi:  
                    volumeAttributes:  
            mounttargetip: "10.x.x.x"
        - Caminho manual de PV
            
            spec:  
              csi:  
                driver: efs.csi.aws.com  
                volumeHandle: fs-xxxxxxxx  
                volumeAttributes:  
                  mounttargetip: 10.x.x.x
2. Criar StorageClass `efs-bootstrap` (exemplo):
    
    apiVersion: storage.k8s.io/v1  
    kind: StorageClass
    metadata:  
      name: efs-bootstrap  
    provisioner: efs.csi.aws.com  
    reclaimPolicy: Retain  
    volumeBindingMode: Immediate  
    allowVolumeExpansion: true
3. Escolha um caminho de provisionamento de bootstrap (obrigatório):

- **Caminho de provisionamento do EFS dinâmico**:
    
    use um StorageClass dinâmico do EFS CSI configurado para pontos de acesso (por exemplo, `provisioningMode: efs-ap, fileSystemId`, e permissões/parâmetros basePath de acordo com o padrão da sua plataforma).
- **Caminho de PV estático**:
    
    crie `tableau-bootstrap-pv` manualmente usando `csi.driver: efs.csi.aws.com` e `csi.volumeHandle: fs-...`
    
    em seguida, defina:
    
    - `persistence.bootstrap.createPV: false`
    - `persistence.bootstrap.volumeName: tableau-bootstrap-pv`
- **Caminho de PV estático criado via Helm**:
    
    defina:
    
    - `persistence.bootstrap.createPV: true`
    - `persistence.bootstrap.pv.csi.volumeHandle: fs-...`

## Pré-requisitos não relacionados a EKS

### StorageClass `ReadWriteMany`

Para clusters não hospedados no EKS (ou se não estiverem usando EFS), o requisito essencial para o compartilhamento de bootstrap com múltiplos nós é fornecer um StorageClass que suporte o modo de acesso `ReadWriteMany (RWX)` para o volume de bootstrap. Isso é necessário porque o armazenamento de bootstrap deve ser provisionado antes que os pods possam ser agendados.

Alguns dos back-ends de armazenamento RWX auto-hospedado comuns para Kubernetes:

- NFS (mais comum, mais fácil de testar)
- CephFS
- Longhorn (se instalado)
- GlusterFS
- NetApp/outro armazenamento corporativo

Você deve garantir que o driver CSI correspondente ao back-end escolhido esteja instalado.

Para configurar o Tableau Server para usar seu StorageClass RWX personalizado, atualize seus valores do Helm (por exemplo, `values-multinode.yaml`) para definir `persistence.bootstrap.storageClass` como o nome do seu StorageClass:

persistence:
  # ... other persistence settings ...

  # Bootstrap volume (required for multi-node)
  bootstrap:
    enabled: true
    storageClass: "my-rwx-storage" # <--- Replace with your StorageClass name
    accessMode: ReadWriteMany
    size: 1Gi
    createPV: false

## Recursos adicionais

- [Tableau Server Helm Chart - Visão geral](https://help.tableau.com/current/server/pt-br/server-in-container_helm-chart.htm)
- [Tableau Server Helm Chart - Implantação](https://help.tableau.com/current/server/pt-br/server-helm-deploy.htm)
- [Tableau Server Helm Chart - Solução de problemas](https://help.tableau.com/current/server/pt-br/server-helm-troubleshooting.htm)
- [Documentação do Helm](https://helm.sh/docs/)
- [Documentação do Tableau Server](https://help.tableau.com/current/server-linux/en-us/)

<!-- document id=881e978d9111d93d8662c6fca3107713b0b133d163004cd2e0486a0ce2809cd8 url=/tableau/current/pt-br/server/server-upgrade-prepare.md -->

[Pular para o conteúdo principal](#main-content)

# Preparação para a atualização

Siga o gráfico de fluxo e os tópicos vinculados para preparar seu ambiente para a atualização do Tableau Server.

![Um fluxograma que descreve as etapas para concluir uma atualização do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/upgrade_prepare.png)

## Versão do Navegador

**Observação:** use o [Tableau Release Navigator](https://public.tableau.com/shared/JJGWR3P65?:display_count=n&:origin=viz_share_link) para pesquisar recursos no Tableau Desktop, Server e Prep ou para ver uma lista completa de recursos ao comparar sua versão atual do Tableau com uma posterior.

## Outros artigos nesta seção

<!-- document id=c65a7cd63f30bfdc9914d2d7ad6f17b16b06abeb27040e73d1f85219c553ef96 url=/tableau/current/pt-br/server/cmt-getting-started.md -->

[Pular para o conteúdo principal](#main-content)

# Introdução ao Content Migration Tool do Tableau

Este artigo o ajudará a começar a usar o Content Migration Tool do Tableau. Ele contém links para outros artigos sobre as informações que devem ser preparadas antes de instalar o Content Migration Tool, além das etapas de elaboração de um plano de migração e atualização das instalações atuais.

## Pré-Instalação

### Requisitos de instalação

A Content Migration Tool só pode ser instalada nos sistemas operacionais Windows. Antes da instalação, conecte-se ao site de origem do Tableau (o site do qual você está migrando) e o site de destino (o site para o qual você está migrando) do computador em que o Content Migration Tool está instalado. Os sites de origem e destino devem ter uma licença válida do [Advanced Management](https://help.tableau.com/current/server/pt-br/itm_intro.htm). Para obter mais informações sobre a instalação e atualização Content Migration Tool, consulte [Instalação do Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-install.htm).

### Compatibilidade com Tableau Server

O Content Migration Tool aceita a migração de conteúdo para as versões do Tableau Server 2019.3 e posteriores.

A tabela lista versões compatíveis do Tableau Server com base na versão instalada do Content Migration Tool.

| Versão do CMT | Tableau Server Versão |
| --- | --- |
| 2025.2x | 2023.3x - 2025.1.x |
| 2025.1x | 2023.3x - 2025.1.x |
| 2024.3x | 2022.3x - 2024.2.x |
| 2024.2x | 2022.3x - 2024.2.x |
| 2024.1x | 2022.1x - 2024.1.x |
| 2023.3.x | 2021.4.x - 2023.3.x |
| 2023.2.x | 2021.3.x - 2023.2.x |
| 2023.1.x | 2021.2.x - 2023.1.x |
| 2022.4.x | 2021.1.x - 2022.4.x |
| 2022.3.x | 2020.4.x - 2022.3.x |
| 2022.2.x | 2020.3.x - 2022.2.x |
| 2022.1.x | 2020.2.x - 2022.1.x |
| 2021.4.x | 2020.1.x - 2021.4.x |
| 2021.3.x | 2019.4.x - 2021.3.x |
| 2021.2.x | 2019.3.x - 2021.2.x |
| 2021.1.x | 2019.3.x - 2021.1.x |
| 2020.4.x | 2019.3.x - 2020.4.x |
| 2020.3.x | 2019.3.x - 2020.3.x |

### Compatibilidade com Tableau Cloud

A versão do Content Migration Tool 2022.2.1 e posteriores oferecem suporte à migração de conteúdo para todas as implantações do Tableau Cloud. É recomendável instalar a versão mais recente na página de downloads do [Tableau Advanced Management](https://www.tableau.com/pt-br/support/releases/advanced-management) para aproveitar os recursos e as correções mais recentes.

### Compatibilidade com o conteúdo do Tableau

O Content Migration Tool é compatível com a migração de pastas de trabalho e fontes de dados publicadas salvas nas oito versões mais recentes do Tableau. Embora você possa migrar as fontes de dados existentes, apenas as fontes de dados que usam os tipos de conexão na tabela abaixo podem ser alteradas e modificadas durante a migração. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm) e [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm).

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Actian Matrix</p><p>Actian Vectorwise</p><p>Amazon Athena</p><p>Amazon Aurora</p><p>Amazon EMR</p><p>Amazon Redshift</p><p>Apache Drill</p><p>Aster Database</p><p>Box</p><p>Cloudera Hadoop</p><p>Arquivo de texto delimitado</p><p>EXASOL</p><p>Firebird</p><p>Google Analytics</p><p>Google BigQuery</p><p>Google Cloud SQL</p></td><td><p>Google Drive</p><p>HortonWorks Hadoop Hive</p><p>HP Vertica</p><p>IBM DB2</p><p>IBM Netezza</p><p>Map R Hadoop Hive</p><p>Microsoft Access</p><p>Microsoft Analysis Services</p><p>Microsoft Excel</p><p>Microsoft Excel Direct</p><p>Microsoft OneDrive</p><p>Microsoft SQL Server</p><p>MySQL</p><p>OData</p><p>Oracle</p><p>Oracle Essbase</p></td><td><p>Pivotal Greenplum Database</p><p>PostgreSQL</p><p>Progress OpenEdge</p><p>Salesforce</p><p>SAP HANA</p><p>SAP Sybase ASE</p><p>SAP Sybase IQ</p><p>Snowflake</p><p>Spark SQL</p><p>Arquivo de estatística</p><p>Extração do Tableau</p><p>Fonte de dados publicada do Tableau</p><p>Teradata</p><p>Arquivo de texto</p><p>Conector de dados da Web</p><p>Outros bancos de dados (ODBC)</p></td></tr></tbody></table>

## Pós-instalação

### Limitações ao migrar conteúdo

Antes de começar, verifique se compreendeu as limitações ao migrar conteúdo usando o Content Migration Tool. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

### Criar um plano de migração

A Content Migration Tool apresenta o conteúdo de migração em todos os projetos em um único site, para um novo site na mesma instância do Tableau Server e para sites existentes em diferentes instâncias do Tableau Server. É possível salvar e usar novamente o plano criado para futuras migrações. Para obter mais informações, consulte o [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm).

<!-- document id=7d0bf3d763cb4e559be93dd35731345ccd2cd26de4c39203ce4ebebb9a0efeb9 url=/tableau/current/pt-br/server/data_engine2_intro.md -->

[Pular para o conteúdo principal](#main-content)

# Processador de dados do Tableau Server

O Hyper é a tecnologia de Processador de dados na memória do Tableau, otimizada para a inserção rápida de dados e o processamento de consultas analíticas em conjuntos de dados grandes ou complexos. O Hyper capacita o processador de dados do Tableau Server, do Tableau Desktop, do Tableau Cloud e do Tableau Public. O Processador de dados é usado ao criar, atualizar ou consultar extrações. Também é usado para uniões entre bancos de dados para suportar fontes de dados federadas com vária conexões.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Data Engine</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Data Engine é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Data Engine são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>hyper</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Utilização de memória e CPU

O Processador de dados foi projetado para potencializar a CPU e memória disponíveis na máquina para fornecer tempos de resposta mais rápidos.

#### Utilização da CPU

A tecnologia Hyper potencializa os novos conjuntos de instruções na CPU e é capaz de paralelizar e escalar para todos os núcleos disponíveis. A tecnologia Hyper é projetada para escalar a vários núcleos de forma eficiente, bem como maximizar o uso de cada núcleo único o máximo possível. Isso significa que você pode esperar ver até uma média de 75% de uso da CPU total por hora durante o processamento da consulta. Adicionar mais CPU deve resultar em melhoria no desempenho.

**Observação:** o uso médio por hora de 75% é o padrão e deve permanecer inalterado, a menos que você esteja executando o Mecanismo de dados em um nó de servidor dedicado. Para obter mais informações sobre como executar o Mecanismo de dados em um nó dedicado, consulte [Otimizar para ambientes - com muitas consultas de extração](https://help.tableau.com/current/server/pt-br/perf_tuning_long_queries_for_extracts.htm).

Os sistemas operacionais modernos, como o Microsoft Windows, o Apple macOS e o Linux, têm mecanismos para garantir que, mesmo que a CPU seja completamente usada, os processos de entrada e outros processos ativos possam ser executados simultaneamente. Além disso, para gerenciar o consumo geral de recursos e evitar sobrecarga e o completo descaso com outros processos em execução na máquina, o Processador de dados monitora a si mesmo para permanecer dentro dos limites estabelecidos pelo Gerenciador de recursos do Tableau Server (SRM). O Gerenciador de recursos do Tableau Server monitora o consumo de recursos e notifica o Processador de dados para reduzir o uso quando ele excede o limite predefinido.

Como o Processador de dados foi projetado para utilizar a CPU disponível, é normal ver picos de utilização da CPU ocasionalmente. Porém, se você vir uma alta utilização da CPU (por exemplo, 95%) por períodos prolongados (uma hora ou mais), isso pode significar o seguinte:

- Há uma grande carga de consultas. Isso pode acontecer quando um servidor estiver sob estresse, devido a uma sobrecarga de solicitações do cliente e enfileiramento de consultas. Se isso ocorrer com frequência, é uma indicação de que é necessário mais hardware para atender os clientes. Neste caso, adicionar mais CPU deve ajudar a melhorar o desempenho.
- Há uma consulta de longa execução. Neste caso, o Gerenciador de recursos do Tableau Server interromperá as consultas de longa execução com base nas configurações de tempo limite. Isso também é verdadeiro para as versões do Tableau Server anteriores à 10.5.

Para obter mais informações Gerenciador de recursos do Tableau, consulte [Diretrizes gerais de desempenho](https://help.tableau.com/current/server/pt-br/perf_guidelines.htm##SRM).

#### Uso de memória

A utilização de memória do Processador de dados depende da quantidade de dados necessários para responder à consulta. O Processador de dados tentará executar primeiro na memória. Uma memória em funcionamento é alocada para armazenar uma estrutura de dados intermediária durante o processamento de consultas. Na maioria dos casos, os sistemas têm memória suficiente para fazer esses tipos de processamento, mas se não houver, ou se mais de 80% de RAM estiver sendo utilizada, o processador de dados alterna para o modo de transferência, gravando temporariamente no disco. O arquivo temporário é excluído depois que a consulta é respondida. A transferência, portanto, é uma indicação de que mais memória pode ser necessária. A utilização de memória deve ser monitorada e atualizada de acordo para evitar problemas de desempenho causados por transferências.

Para gerenciar os recursos de memória na máquina, o limite máximo de memória do Processador de dados é definido pelo Gerenciador de recursos do Tableau Server (SRM).

## Configuração do servidor, Escalabilidade e Desempenho

- Uma única instância do Processador de dados é instalada automaticamente de acordo com o nó em que uma instância do Armazenamento de arquivos, do Servidor de aplicativos (VizPortal), do VizQLServer, do Servidor de dados ou do Processador em segundo plano está instalada no Tableau Server. O Processador de dados pode dimensionar por conta própria e usa a quantidade necessária de CPU e de memória, removendo a necessidade de várias instâncias do Processador de dados. Para obter mais informações sobre os processos de servidor, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).
- A instância do Processador de dados instalada no nó, onde o armazenamento de arquivos está instalado, é usada para consultas de dados das solicitações de exibição. A instância do Processador de dados instalada no nó, onde o processador em segundo plano está instalado, é usada para a criação e atualizações de extrações. Esta é uma consideração importante ao realizar o ajuste de desempenho. Para obter mais informações, consulte [Ajuste de desempenho](https://help.tableau.com/current/server/pt-br/perf_tuning.htm).
- O servidor de dados, o VizQL Server e o servidor de aplicativos (VizPortal) usam a instância local do processador de dados para realizar uniões entre bancos de dados e criar extrações de sombra. Os arquivos de extração de sombra são criados apenas ao trabalhar com pastas de trabalho baseadas em arquivos não herdados do Excel ou de texto, ou arquivos de estatística. O Tableau cria um arquivo de extração de sombra para carregar os dados mais rapidamente.
- No Tableau Server 10.5, uma instância do Processador de dados é instalada automaticamente ao instalar o processador em segundo plano. O processo do processador em segundo plano usa a instância única do Processador de dados (hyperd.exe) instalada no mesmo nó.

> [!IMPORTANT]
> 
> **Importante!** Há exceções para quando o Processador de dados é instalado no mesmo nó que o Armazenamento de arquivos. Quando o Armazenamento de arquivos é configurado fora do Tableau Server, o Processador de dados deixa de ser instalado com o Armazenamento de arquivos. Nesta configuração em que o Tableau Server é configurado com um Armazenamento de arquivos externo, o Processador de dados continuará a ser instalado com o outro processo, como observado acima. Além disso, você também pode configurar o Processador de dados em um nó sem outros processos, mas somente quando o Armazenamento de arquivos é configurado externamente. Para obter mais informações sobre o Armazenamento de arquivos externo, consulte [Armazenamento de arquivos externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm).

### Escalabilidade:

É possível escalar verticalmente com o novo processador de dados: como os núcleos são totalmente utilizados, adicionar mais núcleos faz com que as consultas individuais executem mais rápido, o que permite a execução de mais consultas em menos tempo.

A utilização de memória deve ser monitorada e atualizada de acordo para evitar problemas de desempenho causados por transferências.

Para obter mais informações sobre escalabilidade, consulte [Escalabilidade do Tableau Server](https://www.tableau.com/pt-br/learn/whitepapers/tableau-server-scalability-10-5).

### Desempenho:

#### Benefícios de desempenho

A partir da versão 10.5, a tecnologia Hyper foi integrada ao Processador de dados do Tableau para oferecer os seguintes benefícios principais:

- **Criação de extrações mais rápida**: com a tecnologia Hyper, as extrações são geradas quase tão rápido quanto o sistema fonte é capaz de fornecer dados, sem a necessidade de classificação.
- **Suporte para extrações maiores**: antes dessa versão, não era possível reunir todos os seus dados em uma única extração. Com a tecnologia Hyper, quantidades muito maiores de dados podem ser incluídas em uma única extração.
- **Análise mais rápida das extrações:** em muitos casos, pode-se perceber uma consulta mais rápida dos dados para extrações maiores ou pastas de trabalho com cálculos complexos.

Estes são alguns motivos pelos quais o Processador de dados fornecido pelo Hyper apresenta um desempenho melhor com extrações maiores ou complexas e é otimizado para consultas mais rápidas:

- **A tecnologia Hyper é projetada para consumir dados de forma mais rápida**. Ao contrário das versões anteriores, o Processador de dados não realiza nenhum pós-processamento, como classificação. Com o Hyper, as etapas de pós-processamento, como classificação, não são necessárias, pois o Processador de dados tem um desempenho melhor com extrações maiores.
- **A tecnologia Hyper é otimizada para a memória**. Isso significa que, quando necessário, todos os dados ficam na memória. Isso resulta em tempos mais rápidos de acesso aos dados.
- **A tecnologia Hyper é otimizada para a CPU**. Isso significa que o Processador de dados agora paraleliza completamente a execução da consulta e utiliza a CPU disponível para que o tempo de execução da consulta seja escalado de forma quase linear ao número de núcleos da máquina.
- **O Hyper é um mecanismo de consulta de compilação**. As consultas são interpretadas ou compiladas em código da máquina para obter o máximo desempenho e para permitir que o processador de dados obtenha o maior desempenho do hardware moderno (CPU, grandes capacidades de memória principal).
- **A tecnologia Hyper usa otimizações de consulta avançada para tornar as consultas mais rápidas.** O novo Processador de dados oferece muitas melhorias em relação ao anterior do Tableau, em termos de desempenho e escalabilidade, juntamente com várias técnicas avançadas adicionais, como a materialização de valores mínimos e máximos para cada coluna, os mini índices para otimizar os intervalos de pesquisa, os dicionários de dados mais granulares a nível de bloco, a lógica avançada para uniões e otimizações de desempenho para subconsulta.

Para obter mais informações sobre o desempenho, consulte [Diretrizes gerais de desempenho](https://help.tableau.com/current/server/pt-br/perf_guidelines.htm) e [Ajuste de desempenho](https://help.tableau.com/current/server/pt-br/perf_tuning.htm)

<!-- document id=8d1dd3a9359d8181bd7c037ee57f02296b68071cdf8e0eef45da060348cb287b url=/tableau/current/pt-br/server/ts_hyper_query_processing.md -->

[Pular para o conteúdo principal](#main-content)

# Processamento de hiperconsulta (beta)

**Observação:** como o processamento de hiperconsulta é uma versão beta, o nome pode mudar antes da versão geral.

O conector Plataforma de dados do cliente (CDP) agora é alimentado com o Mecanimo de processamento de hiperconsulta. Ele oferece suporte a análises interativas com processamento rápido de consultas de dados e simplifica a experiência de conexão aos dados para uma exploração de dados mais rápida. O mecanismo de processamento de hiperconsulta acelera o tempo de consulta ao consultar dados da plataforma de dados do cliente do Tableau com conexões em tempo real e extrações de dados do Tableau.

> [!IMPORTANT]
> 
> **Recurso beta:** o recurso beta de processamento de hiperconsulta oferece funcionalidade extra sem nenhum custo. Você pode optar por experimentar este serviço a seu exclusivo critério. Qualquer uso do Serviço Beta está sujeito aos Termos aplicáveis dos Serviços Beta fornecidos em [Acordos e Termos](https://www.salesforce.com/company/legal/agreements/).

## Habilitar processamento de hiperconsulta no Tableau Server

Conclua as etapas a seguir para habilitar o processamento de hiperconsulta.

1\. Conecte-se ao Salesforce CDP.

2\. Siga as instruções na tela para instalar o driver hyper jdbc.

`-Salesforce-cdp-hyper-beta-1.15.0.jar` ou baixe o arquivo .jar [aqui](https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases).

3\. Mova o arquivo baixado para qualquer um dos seguintes caminhos de diretório, dependendo do seu sistema.

Windows - `C:\Program Files\Tableau\Drivers`

macOS - `/Users/[user]/Library/Tableau/Drivers`

4\. Depois de mover o driver para o caminho correto, conecte-se novamente. O conector da plataforma de dados do cliente está pronto para uso no Tableau Server.

**Observação:** o suporte ao processamento de hiperconsulta é uma versão beta. Está disponível para o Tableau Server. O Tableau Desktop e o Tableau Online terão suporte a partir de dezembro de 2022. Estas datas estão sujeitas a alterações.

### Consulte também

- Ajuda do Tableau: [Conecte o Tableau Server à plataforma de dados do cliente](https://help.tableau.com/current/server-linux/pt-br/config_oauth_sfdc_cdp.htm)
- Ajuda do Salesforce: [Configurar o Tableau no Customer Data Platform](https://help.salesforce.com/s/articleView?id=sf.c360_a_set_up_tableau_connected_app.htm&type=5&language=en_US)
- Ajuda do Salesforce: [Habilitar o Customer Data Platform no Tableau](https://help.salesforce.com/s/articleView?id=sf.c360_a_enable_tableau_connector.htm&type=5&language=en_US)
- Ajuda do Salesforce: [Como usar dados do Customer Data Platform no Tableau](https://help.salesforce.com/s/articleView?id=sf.c360_a_using_customer_360_aud_data_in_tableau.htm&type=5&language=en_US)

<!-- document id=87b682d5bb1c811637e9b6b2b8472e8815326b83a44ab7ec8328278922ecf53d url=/tableau/current/pt-br/server/server_process_gateway.md -->

[Pular para o conteúdo principal](#main-content)

# Processos de Gateway do Tableau Server

O processo de gatewat do Tableau Server é um componente do servidor Web Apache (`httpd.exe`). A sua função é lidar com solicitações de todos os clientes para o servidor — Tableau Desktop, dispositivos móveis, proxy, balanceador de carga etc.

O servidor executa uma única instância do processo de gateway; não é possível executar mais de um por máquina. O processo do gateway é exigido em qualquer nó com uma instância de VizQL Server ou Vizportal.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Gateway</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de Gateway é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do gateway são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>httpd</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Atribuição de porta

Como padrão, o processo de gateway escuta solicitações na porta 80 (para solicitações HTTP) e 443 (para solicitações SSL). Ao instalar o Tableau Server em um computador, parte da configuração de servidor garante que essa porta esteja aberta no firewall do computador. Se o computador estiver executando um processo diferente que precise da porta 80 para HTTP, será possível alterar a atribuição de porta para o processo de gateway durante a instalação. (Não é possível alterar a porta SSL/HTTPS).

![O número da porta do gateway padrão é 80.](/tableau/current/pt-br/server/pt-br/Img/config_setup_gw.png)

Se precisar definir a porta HTTP após a instalação, execute o seguinte comando TSM, onde _nó_ é o número do nó (por exemplo, `node1`) e _nn_ é o novo número da porta:

tsm topology set-ports --node-name _node_ --port-name gateway:primary --port-value _nn_

Se você estiver executando o Tableau Server com um servidor proxy reverso, será necessário definir outras configurações relacionadas à porta e ao host no Tableau Server. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).

## Arquivos de registro para o processo de gateway

O processo do gateway cria dois conjuntos de arquivos de log:

- Registros de atividade. O nome desses arquivos de registro tem o formato `access._yy_mm_dd_hh_mm_ss_.log.`.
- Regitro de erros. Todos os erros são registrados em um único arquivo chamado `error.log`.

Para obter mais informações, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).

## Processos de gateway em um cluster

Se o seu ambiente do servidor for distribuído em vários computadores, pode executar um único processo de gateway em cada nó do cluster. O cenário mais comum para executar um processo de gateway em vários computadores no cluster é ter um balanceador de carga em frente do cluster. Neste cenário, o balanceador de carga distribui as solicitações para qualquer gateway no cluster. Se precisa colocar um node offline (por exemplo, para realizar a manutenção), pode desabilitar o roteamento do balanceador de carga para aquele computador. Quando a manutenção estiver concluída, você poderá reativar o nó do balanceador de carga.

Você deve ter um processo de gateway em execução pelo menos em um computador no cluster. Se você remover o processo de gateway do servidor primário, deve garantir que outro computador no cluster esteja executando o processo de gateway. Você também deve certificar-se de que o computador esteja acessível para os clientes.

Uma instância do processo de gateway é necessária em qualquer nó configurado para um destes processos ou serviços: VizQL Server, Vizportal ou Criação de fluxo do Tableau Prep.

Se o Tableau Server estiver configurado para usar o SSL, você deve garantir que o certificado de suporte do SSL esteja no mesmo local em cada computador com processo de gateway em execução. Para obter mais informações sobre o uso do SSL, consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm).

Da mesma forma, se a instalação do servidor usa um logotipo personalizado, ele deve estar no mesmo local em todos os computadores que executam o processo do gateway.

Se você precisa alterar o número da porta de escuta do processo de gateway, conforme explicado anteriormente, pode usar a caixa de diálogo de configuração ou executar o comando a seguir para cada computador de trabalho no processo de gateway:

tsm topology set-ports --node-name _node_ --port-name gateway:primary --port-value _nn_

## Informações adicionais

[Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm)

[Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm)

<!-- document id=dff43f5f53c6f6ea70c441b5cca37e540fa6ae27763095da0b4d447d6fd41b3a url=/tableau/current/pt-br/server/server_process_backgrounder.md -->

[Pular para o conteúdo principal](#main-content)

# Processos do Processador em segundo plano do Tableau Server

O processo do Processador em segundo plano executa trabalhos de servidor, incluindo atualizações de extração, assinaturas, execuções de fluxo e alertas orientados por dados. Os trabalhos são iniciados tanto a partir de tarefas programadas quanto ao iniciarem manualmente usando o comando 'Executar agora', a API REST ou o tabcmd.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Backgrounder</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Backgrounder  é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Backgrounder  são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>backgrounder</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece se ocorrer uma falha em um Processador em segundo plano? As tarefas no processo com falha do Processador em segundo plano são repetidas assim que o processo for recuperado. A maioria das tarefas em segundo plano é agendada para ser executada periodicamente, e a mesma tarefa em segundo plano será escolhida e executada normalmente no próximo horário agendado por um Processador em segundo plano em funcionamento.

Os processos do Processador em segundo plano são reiniciados automaticamente, desde que o computador não tenha problemas, e as tarefas com falha serão repetidas.

Para tornar o Processador em segundo plano altamente disponível, configure uma ou mais instâncias para executar em vários nós do cluster.

## Gestão de recursos do Processador em segundo plano

Os Processadores em segundo plano, como mencionado anteriormente neste tópico, executam tarefas do servidor, e podem usar muitos recursos. Há várias maneiras de gerenciar os recursos que o Processador em segundo plano precisa para executar as tarefas do servidor:

- Aumentar a quantidade de instâncias em um nó específico: o Processador em segundo plano é de encadeamento único. Ele só pode lançar um único trabalho de cada vez. Adicionar mais instâncias do processador em segundo plano a um nó pode aumentar o número de trabalhos que podem ser executados em paralelo nesse nó, mas tenha em mente que cada trabalho iniciado pode usar vários segmentos. Você pode adicionar instâncias de Processadores em segundo plano até metade do número de núcleos. Ao decidir onde e quantos Processadores em segundo plano executar, considere que cada processo do Processador em segundo plano iniciado para um trabalho pode usar vários segmentos, então adicionar instâncias do Processador em segundo plano pode limitar a eficácia de cada processo. Também tenha em mente como outros processos de servidor afetarão a capacidade disponível de cada máquina.
- Isolar o processo do processador em segundo plano: se estiver executando o Tableau Server em um cluster de vários nós, poderá dedicar um ou mais nós para a execução do Processador em segundo plano. Para obter mais informações, consulte [Configurações de linha de base recomendadas](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm).
- Funções do nó: também é possível separar o tipo de trabalho ou carga de trabalho que o Processador em segundo plano em um nó faz. Por exemplo, você pode ter um nó dedicado apenas à execução de atualizações de extrações. Para obter mais informações, consulte [Gerenciamento de carga de trabalho por meio das funções de nó](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).
- Restringir os usuários de executar trabalhos manualmente: atualmente, os usuários podem executar atualizações de extração, execução de fluxo e assinaturas usando a interface na Web, a API REST e comandos tabcmd, e podem executá-los a qualquer hora do dia. Isso pode usar recursos do servidor durante os períodos em que o servidor está ocupado fazendo outras atividades. A partir do Tableau Server 2020.1, uma nova configuração Executar agora permite que o administrador do servidor escolha se permite ou não que os usuários executem trabalhos manualmente. Ao desativar a opção Executar agora, você tem um melhor controle sobre como os processadores em segundo plano são utilizados, além de ser capaz de prever melhor a carga. Isso não se aplica ou afeta trabalhos gerados para tarefas agendadas. Para obter mais informações sobre como configurar esta configuração, consulte [Configurações do servidor (geral e personalização)](https://help.tableau.com/current/server/pt-br/maintenance_set.htm).

## Conteúdo relacionado

- [Melhora do desempenho da sincronização de grupos](https://help.tableau.com/current/server/pt-br/groups_globalsync.htm#Improvin)

<!-- document id=3e32a02e190c13537fcfea21404d7909347d7a5da2ce28f7161fbfa75d559d6c url=/tableau/current/pt-br/server/processes.md -->

[Pular para o conteúdo principal](#main-content)

# Processos do Tableau Server

Este tópico descreve as opções para definir a configuração do processo. Para configurar os processos do Tableau Server é necessário especificar quais processos e quantas instâncias devem ser executados em cada nó. Para isso, use o comando [tsm topology set-process](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess). Para obter mais informações, consulte [Alteração do número de processos em um nó](https://help.tableau.com/current/server/pt-br/config_nodes.htm#ChangeProcessCount).

Procurando o Tableau Server no Linux? Consulte [Referência de processo](https://help.tableau.com/current/server-linux/pt-br/processes.htm "Abre o tópico em uma nova guia do navegador").

Exceto quando explicitamente indicado na tabela abaixo, aplicar as alterações nos processos cessarão o Tableau Server, se o mesmo estiver em execução ao aplicar essas alterações. Depois que as alterações são aplicadas, o Tableau Server retorna ao estado anterior à configuração do processo, dessa forma, se o servidor estava em execução, ele será restaurado.

**Importante**: a topologia do seu processo dependerá das suas necessidades organizacionais.

## Processos licenciados

Alguns dos processos que são instalados como parte do Tableau Server são processos "licenciados". Os processos licenciados precisam de uma licença válida do Tableau Server para serem executados. Outros processos que são instalados como parte do Tableau Server não estão vinculados a uma licença válida. Isso têm o seguinte impacto:

- Cada processo licenciado precisa entrar em contato regularmente com o Tableau Server serviço de Gerenciador de licença executado no Tableau Server computador inicial para verificar se está licenciado. Se não for possível confirmar a presença de uma licença válida, por exemplo, se o nó inicial não estiver disponível, o processo não será executado e o Tableau Server pode não funcionar de modo correto ou confiável.
- Se você tiver uma licença do Tableau Server baseada em núcleo, os núcleos em qualquer nó que contenha um processo licenciado não estarão na contagem total de núcleos licenciados.
    
    **Observação:** se você tiver o Data Management e uma licença baseada em núcleo, será necessário entender como os processos licenciados serão somados à contagem total de núcleos licenciados que acompanham cada licença. Para obter mais informações, consulte [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).

A coluna "Licenciados" na tabela abaixo identifica os processos que exigem uma licença válida e que impactam a contagem de núcleos em licenças baseadas em núcleos.

<table class="simple-table"><colgroup><col style="width: 14.5%;"><col style="width: 15%;"><col style="width: 25%;"><col style="width: 35.5%;"><col style="width: 10%;"></colgroup><tbody><tr><td colspan="5"><strong>Processos do Tableau Server</strong> - Esses processos têm um status de <code>running</code> ao executar o Tableau Server e de <code>stopped </code> ao interrompê-lo.</td></tr><tr><td>Nome mostrado em <code>tsm status -v</code></td><td>Nome usado com <code>tsm topology set-process</code></td><td><strong>Finalidade</strong></td><td><strong>Observações</strong></td><td><strong>Licenciado</strong></td></tr><tr><td>Microsserviços de extensões de análise</td><td><code>analyticsextensions</code></td><td>O microsserviço de extensões de análise oferece suporte a um conjunto de funções para passar expressões para extensões de análise para integração com R, Python e Einstein Discovery.</td><td>Instalado automaticamente em qualquer nó onde o Application Server (VizPortal) está instalado.</td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_application-server.htm">Servidor de aplicativos</a></td><td><code>vizportal</code></td><td>O servidor de aplicativos (VizPortal) opera o aplicativo Web e as chamadas à REST API, e oferece suporte a navegação e pesquisa.</td><td>Ao instalar o Servidor de aplicativos, a menos que o nó já tenha uma instância do Processador de dados, ele também será instalado.<p>Quando a primeira instância do Servidor de aplicativo é instalada em um nó, o Serviço interativo de contêineres também é instalado.</p></td><td>Sim</td></tr><tr><td>Pergunte aos dados (Ask Data)</td><td>Não pode ser configurado manualmente.</td><td>O serviço Pergunte aos dados (Ask Data) é usado pelo recurso Pergunte aos dados (Ask Data).</td><td>Ele é executado automaticamente em todos os nós que executam o Servidor de dados.</td><td>Não</td></tr><tr><td>Autenticação<p>Adicionado: 2022.1</p></td><td>Não pode ser configurado manualmente.</td><td>O serviço de autenticação trata do processo de migração de identidade.<p>Após a conclusão do processo de migração de identidade e como parte do gerenciamento de pools de identidade, o serviço de Autenticação é responsável pelo seguinte:</p><ul><li>Pesquisando por uma identidade de usuário na tabela de Serviço de Identidade apropriada, usando o identificador exclusivo universal (UUID) retornado para consultar a tabela system_user herdada e localizar o usuário do sistema apropriado e, em seguida, conceder a ele uma sessão de usuário, o que conclui o fluxo de trabalho de autenticação.</li><li>Importando identificadores de usuário imutáveis e atributos de usuário adicionais quando o armazenamento de identidade configurado for externo (AD ou LDAP).</li></ul></td><td>O status desse processo está disponível apenas por meio da CLI do tsm.<p>A migração de identidade deve ser concluída e o serviço de identidade ativado para configurar e agrupar identidades de usuários. Para obter mais informações, veja <a href="https://help.tableau.com/current/server/pt-br/identity_migration.htm" class="xref">Sobre a migração de identidade</a> e <a href="https://help.tableau.com/current/server/pt-br/identity_pools.htm" class="xref">Provisionar e autenticar usuários usando grupos de identidade</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_backgrounder.htm">Processador em segundo plano</a></td><td><code>backgrounder</code></td><td>O Processador em segundo plano executa tarefas de servidor, incluindo atualizações de extrações, inscrições, tarefas "Executar agora" e tarefas iniciadas por tabcmd.</td><td>Ao instalar o Processador em segundo plano, a menos que o nó já tenha uma instância do processador de dados, ele também será instalado.<p>O processador em segundo plano é um processo de encadeamento único. É possível adicionar mais instâncias de processador em segundo plano a um nó para expandir a capacidade do nó, a fim de executar trabalhos paralelamente.</p><p>Na maioria das situações, é possível aumentar ou diminuir o número de instâncias de processadores em segundo plano em um nó de um servidor que está em execução, sem cessar ou reiniciar o servidor. A exceção é quando você tem o Data Management licenciado e adiciona a primeira instância do processador em segundo plano a um nó ou remove a última instância do processador em segundo plano do nó. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_hot_topo.htm" class="xref">Alterações de topologia dinâmica do Tableau Server</a>.</p></td><td>Sim</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_cache-server.htm">Servidor de cache</a></td><td><code>cacheserver</code></td><td>O Servidor de cache é um cache de consulta distribuído e compartilhado no cluster do servidor. Esse cache na memória acelera a experiência do usuário em vários cenários. O servidor VizQL, o processador em segundo plano e o servidor de dados (e servidor de aplicativos em menor grau) fazem solicitações ao servidor de cache em nome de usuários ou trabalhos.</td><td>O cache é de único encadeamento, então se você precisa de um desempenho melhor, deve executar instâncias adicionais do servidor do cache.<p>Recomendamos que você instale no máximo seis instâncias de servidor de cache, com, no máximo, duas instâncias a cada nó. Nossos testes indicam que a instalação de mais de seis instâncias de servidor de cache em uma instalação do Tableau Server não oferece melhorias e pode ter um impacto negativo no desempenho.</p></td><td>Não</td></tr><tr><td>Controlador do cluster</td><td><code>clustercontroller</code></td><td>O Controlador do cluster é responsável por monitorar vários componentes, detectando falhas e executando failover quando necessário.</td><td>Instalado automaticamente em cada nó.</td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_collections-service.htm">Coleções</a><p>Adicionado: 2021.2.0</p></td><td><code>collections</code></td><td>O serviço de Coleções fornece metadados para as coleções e recursos favoritos.</td><td>O serviço de Coleções é instalado no primeiro nó em que o Aplicativo (vizportal) está instalado.<p>Para alta disponibilidade, recomendamos que você instale um instância do Serviço de coleções em cada nó que tenha uma instância do Servidor de aplicativos instalada. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_collections-service.htm" class="xref">Serviço de Coleções do Tableau Server</a>.</p></td><td>Não</td></tr><tr><td>Pool de conexões<p>Adicionado: 2023.1.0</p></td><td>&nbsp;</td><td>O serviço Pool de conexões tem como objetivo oferecer uma opção para agrupar conexões de banco de dados com o repositório.</td><td>O serviço Pool de conexões é instalado em cada nó em estado desabilitado. Não pode ser habilitado exceto no TSM.<p><strong>Não </strong> deveria ser habilitado, exceto por instruções do Suporte do Tableau.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_content-exploration.htm">Exploração de conteúdo</a><p>Adicionado: 2021.1.0</p></td><td><code>contentexploration</code></td><td>O serviço de exploração de conteúdo amplia os recursos de pesquisa e navegação do Tableau Server. Também depende do Index and Search Server para fazer as operações.</td><td>O serviço de Exploração do conteúdo é instalado no nó inicial. <br><p>Para alta disponibilidade, recomendamos que você instale um instância do serviço de Exploração de conteúdo em cada nó que tenha o Servidor de aplicativos instalado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_content-exploration.htm" class="xref">Serviço de exploração do conteúdo do Tableau Server</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/data_engine2_intro.htm">Processador de Dados</a></td><td>Não pode ser configurado manualmente.</td><td>O processador de dados cria extrações de dados e consultas de processos.</td><td>É instalado automaticamente com o armazenamento de arquivos, o Vizportal, o VizQL Server, o servidor de dados (VizPortal), o servidor de dados, criação de fluxo no Prep ou o processador em segundo plano.<p>Observação: quando o Armazenamento de arquivos é configurado externamente, o Processador de dados deixa de ser instalado com o Armazenamento de arquivos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm" class="xref">Armazenamento de arquivos externo do Tableau Server</a>.</p></td><td>Sim</td></tr><tr><td>Perfil de dados<p>Adicionado: 2021.4.0</p></td><td><code>dataprofiling</code></td><td>O serviço de Criação de perfil de dados lida com solicitações de criação de perfil de coluna para o editor de Conexão virtual.</td><td>Instalado apenas quando você tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Em seguida, é instalado automaticamente em qualquer nó onde o Processador em segundo plano está instalado.</td><td>Sim - Requer uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_data-server.htm">Servidor de dados</a></td><td><code>dataserver</code></td><td>O servidor de dados gerencia conexões com as fontes de dados do Tableau Server.</td><td>Ao instalar o Servidor de dados, a menos que o nó em questão já tenha uma instância do processador de dados, este é instalado.</td><td>Sim</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_data-source_service.htm">Propriedades da fonte de dados</a><p>Adicionado: 2020.1.0</p></td><td><code>tdsservice</code></td><td>O serviço Propriedades da fonte de dados fornece metadados de fontes de dados publicadas para serviços de clientes como Pergunte aos dados.</td><td>As Propriedades da fonte de dados são adicionadas por padrão no nó inicial. Uma instalação do Tableau Server deve incluir pelo menos uma instância. Por razões de desempenho, recomendamos instalar o serviço Propriedades da fonte de dados em qualquer nó que tenha o Servidor de aplicativos (VizPortal) instalado.</td><td>Não</td></tr><tr><td>Histórias de dados <p>Adicionado: 2023.1.0</p><p>Descontinuado: 2025.1.0. Nesta versão e em posteriores, o serviço não é instalado.</p></td><td>&nbsp;</td><td>O serviço Histórias com dados lida com o mecanismo analítico que alimenta a extensão do painel Histórias com dados.</td><td>O serviço Histórias de dados é adicionado automaticamente a cada nó da instalação do Tableau Server. Não pode ser configurado manualmente.</td><td>Não</td></tr><tr><td>Elastic Server<p>Adicionado: 2019.1</p><p>Removido: 2022.1</p><p>A partir da versão 2022.1, o Index and Search Server é usado.</p></td><td><code>elasticserver</code></td><td>O Elastic Server é usado por Pergunte aos dados, para indexar dados, e pelo serviço de exploração de conteúdo para indexar conteúdo pesquisável.</td><td>Os processos do Elastic Server podem ser executados em mais de um nó em um agrupamento. Como alternativa, eles podem ser movidos para qualquer nó. É recomendado ter um número ímpar de processos do Elastic Server em execução.<p> O tamanho da pilha do Elastic Server pode ser configurado usando a opção de configuração do TSM <code>elasticserver.vmopts</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm" class="xref">Opções do tsm&nbsp;configuration set</a>.</p></td><td>Não</td></tr><tr><td>Serviço de extração<p>Adicionado: 2021.4.0</p><p>Descontinuado: 2023.3.0. Nesta e em versões posteriores, as conexões virtuais são gerenciadas pelo Processador em segundo plano.</p></td><td><code>extractservice</code></td><td>O serviço Extração gerencia extrações de conexões virtuais.</td><td>Instalado apenas quando você tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Em seguida, é instalado automaticamente em qualquer nó onde o Processador em segundo plano está instalado.</td><td>Sim - Requer uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_filestore.htm">Armazenamento de arquivo</a></td><td><code>filestore</code></td><td>O Armazenamento de arquivos pode ser configurado para ser executado localmente no Tableau Server ou externamente usando o armazenamento SAN ou NAS.<p>Quando configurado localmente: o Armazenamento de arquivos replica automaticamente as extrações pelos nós do Processador de dados.</p></td><td>Ao instalar o Armazenamento de arquivos, o Processador de dados também é instalado, a menos que o nó já tenha uma instância do Processador de dados ou se o Armazenamento de arquivos estiver configurado externamente.</td><td><p>Armazenamento de arquivos local: não</p><p>Armazenamento de arquivos externo: requer a licença do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span>.</p></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_gateway.htm">Gateway</a></td><td><code>gateway</code></td><td>O gateway é um servidor Web que controla todas as solicitações dos navegadores para o Tableau Server, o <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> e outros clientes.</td><td>Exigido em qualquer nó com uma instância de VizQL Server, Vizportal ou Criação de fluxo no Tableau Prep.</td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_index-and-search.htm" class="xref">Index and Search Server</a><p>Adicionado: 2022.1</p></td><td><code>indexandsearchserver</code></td><td>O Index and Search Server é baseado no AWS OpenSearch. O Tableau usa o recurso de pesquisa do Open Search para indexar dados do Pergunte aos dados e do serviço de Exploração de conteúdo.<p>Este processo do servidor é a substituição do Elastic Server que não é mais usado na versão 2022.1 e posterior.</p><p>A partir da versão 2023.3.0, esse processo substitui Pesquisa e Navegação.</p></td><td>Os processos do Index and Search Server podem ser configurados em mais de um nó em um agrupamento.<p>Recomendamos ter um número ímpar de processos do Index and Search Server em execução. Em clusters do Tableau Server com 3 ou mais nós, recomendamos configurar o Index e o Search Server em pelo menos três nós diferentes. <br>O tamanho da pilha do Index and Search Server pode ser configurado usando o comando <code>tsm set configuration</code> com a opção <code>indexandsearchserver.vmopts</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm" class="xref">Opções do tsm&nbsp;configuration set</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_internal-data-source_service.htm">Propriedades internas da fonte de dados</a><p>Adicionado: 2020.1.0</p></td><td><code>tdsnativeservice</code><p>Não pode ser configurado manualmente.</p></td><td>O serviço Propriedades internas da fonte de dados é um serviço interno que só se comunica com o serviço Propriedades da fonte de dados.</td><td>Uma instância do Propriedades internas da fonte de dados é configurada automaticamente em cada nó que tenha uma instância do Propriedades da fonte de dados nele.<br><br></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_messaging_service.htm">Serviço de mensagens</a><p>Adicionado: 2019.4.0</p></td><td><code>activemqserver</code></td><td>O Serviço de mensagens é usado para oferecer suporte à comunicação entre microsserviços no Tableau Server.</td><td>Instalado automaticamente no nó inicial quando você instala o Tableau Server. Requer uma instância do serviço. <p>Em instalações distribuídas do Tableau Server, é possível mover o Serviço de mensagens para um nó diferente. Na versão 2020.1 você pode adicionar uma segunda instância do Serviço de mensagens em um nó adicional para fornecer alguma redundância (em 2019.4 não é possível configurar mais de uma instância em um cluster). Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_messaging_service.htm" class="xref">Serviço de mensagens do Tableau Server</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_metrics.htm">Serviço Métricas</a><p>Adicionado: 2020.2.0</p><p>Descontinuado: 2.024,2</p></td><td><code>metrics</code></td><td>O serviço Métricas é responsável pela leitura e gravação de dados métricos no Tableau Server.</td><td>Instalado automaticamente no nó inicial com uma instância exclusiva quando você instala o Tableau Server. Requer uma instância do serviço.<p>Você pode adicionar instâncias complementais conforme necessário .</p><p>Recomendamos pelo menos uma instância do serviço Métricas em cada nó de uma instalação de vários nós do Tableau Server. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_metrics.htm" class="xref">Serviço Métricas do Tableau Server</a>. </p><p>(O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/metrics_create.htm">Criar e solucionar problemas de métricas (descontinuado)</a>.)</p></td><td>Não</td></tr><tr><td>Serviço Minerva<p>Adicionado: 2021.4.0</p></td><td><code>minerva</code></td><td>O serviço Minerva executa consultas para conexões virtuais.</td><td>Instalado apenas quando você tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Em seguida, é instalado automaticamente em qualquer nó onde o Processador em segundo plano está instalado.</td><td>Sim - Requer uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr><td>Serviço de armazenamento não relacional<p>Adicionado:&nbsp;2023.1.0</p><p>Descontinuado: 2024.1.0</p><p><strong>Observação:</strong> o serviço aparece na CLI nas versões 2023.x, mas não funciona.</p></td><td><code>nrs</code></td><td>O serviço Armazenamento não relacional é um microsserviço gerenciado e usado internamente por outros serviços do Tableau.</td><td>Instalado automaticamente no nó inicial do Tableau Server. Esse serviço não pode ser gerenciado por administradores de sistema.</td><td>Não</td></tr><tr><td>Serviço de conexões virtuais<p>Adicionado: 2021.4.0</p></td><td><code>publishedconnections</code></td><td>O serviço de conexões virtuais lida com consultas para conexões virtuais.</td><td>Instalado apenas quando você tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Em seguida, é instalado automaticamente em qualquer nó onde o Processador em segundo plano está instalado.</td><td>Sim - Requer uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr><td>Microsserviço de gateway de consulta<p>Adicionado: 2021.4.0</p></td><td><code>querygateway</code></td><td>O microsserviço de gateway de consulta roteia as consultas para o microsserviço apropriado, dependendo do tipo e da origem da consulta.</td><td>Instalado apenas quando você tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Em seguida, é instalado automaticamente em qualquer nó onde o Processador em segundo plano está instalado.</td><td>Sim - Requer uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr><td>Serviço de política de consulta<p>Adicionado: 2021.4.0</p><p>Descontinuado: 2023.3.0</p></td><td><code>querypolicy</code></td><td>O serviço de Política de consulta fornece informações sobre políticas de dados ao processar consultas.</td><td>Instalado apenas quando você tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Em seguida, é instalado automaticamente em qualquer nó onde o Processador em segundo plano está instalado.</td><td>Sim - Requer uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_repository.htm">Repositório</a></td><td><code>pgsql</code></td><td>O repositório PostgreSQL é o banco de dados principal do Tableau Server. Ele armazena metadados da pasta de trabalho e do usuário. Quando o Tableau Catalog (ou API de metadados do Tableau) estiver ativado, o repositório armazena conteúdo do Tableau e metadados de ativos externos.</td><td>Você está limitado a um máximo de duas instâncias do repositório em um cluster e deve ter pelo menos três nós no cluster para adicionar uma segunda instância do repositório.<p>&nbsp;</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process-resource-limits-manager.htm">Gerenciador de limites de recursos</a><p>Adicionado em: 2022.1</p></td><td><code>"Resource&nbsp;Limits Manager"</code></td><td>O Gerenciador de Limites de Recursos do Tableau Server rastreia o uso de recursos de segundo plano em relação aos limites de recursos definidos para garantir que os limites de recursos sejam aplicados corretamente.</td><td>O Gerenciador de Limites de Recurso é instalado automaticamente e por padrão no nó inicial do Tableau Server. Não recomendamos adicionar mais processos ou configurá-los em nós adicionais do Tableau Server.</td><td><p>Não</p><p>Requer <span class="mc-variable Variables.ITM_name variable">Advanced Management</span></p></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_saml-service.htm">Serviço SAML</a></td><td>Não pode ser configurado manualmente.</td><td>O Serviço SAML age como um proxy entre o Tableau Server e os Provedores de identidade (IdPs) SAML.</td><td>Instalado automaticamente em cada nó em que você instala o Tableau Server.<p>Mostra um status de <code>stopped </code>na saída do <code>tsm status -v</code>, a não ser que o SAML do site esteja habilitado.</p><p>Não é possível configurar o Serviço SAML manualmente.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_search-n-browse.htm">Procurar e navegar</a><p>Descontinuado: 2023.3.0</p></td><td><code>searchserver</code></td><td>O serviço Pesquisar e Navegar lida com pesquisa rápida, filtro, recuperação e exibição de metadados de conteúdo no servidor</td><td>A partir da versão 2022.3.0, Pesquisar e Navegar não é mais usado. O Index and Search Server substitui isso completamente. A partir da versão 2023.3.0, ele não está mais instalado.<p><strong>Observação:</strong> se estiver executando o Tableau Server versão 2022.3 ou 2023.1, você <em>não deve configurar mais de uma instância de Pesquisar e Navegar</em> para qualquer instalação. Em casos raros, configurar mais de uma instância pode resultar em problemas de estabilidade.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_prep_conductor.htm">Tableau Prep Conductor</a></td><td><code>flowprocessor</code></td><td>O Tableau Prep Conductor executa fluxos e processos de fluxos para ingestão pelo Catálogo de Dados. Ele usa a funcionalidade de agendamento e monitoramento do Tableau Server para que você possa automatizar os fluxos em execução para atualizar a saída de fluxo.</td><td>Por padrão, ele é habilitado automaticamente em um nó que tenha o processador em segundo plano habilitado. Se a função de nó estiver definida para excluir fluxos, o Tableau Prep Conductor não será instalado nesse nó. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_node_roles.htm" class="xref">Gerenciamento de carga de trabalho por meio das funções de nó</a>. A partir de 2020.4, o <span class="mc-variable Variables.DM_sku variable">Data Management</span> não é necessário para habilitar esse processo no Tableau Server.</td><td>Sim</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_prep_flow_authoring.htm">Criação de fluxos do Tableau Prep</a><p>Adicionado na versão 2020.4.</p></td><td><code>floweditor</code></td><td>Fornece a experiência interativa de fluxo do Prep no navegador.</td><td>Quando a Criação de fluxo do Tableau Prep (<code>floweditor</code>) é instalado, o Processador de dados, o Serviço de fluxo do Tableau Prep (<code>flowqueryservice</code>) e Gateway também são instalados, a menos que o nó já tenha uma instância de cada um deles.</td><td>Sim</td></tr><tr><td>Serviço do Tableau Prep Minerva<p>Adicionado como o serviço de fluxos do Tableau Prep na versão 2020.4 e renomeado na versão 2021.2.</p></td><td><code>flowminerva</code><p>Observação: anteriormente <code>flowqueryservice</code></p></td><td>Usado pela Criação de fluxo do Tableau Prep (<code>floweditor</code>) para consulta de fontes de dados.</td><td>Por padrão, ele é habilitado automaticamente em um nó que tenha a Criação de fluxo do Tableau Prep (<code>floweditor</code>) habilitada.</td><td>Sim</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_statistical_service.htm">Tableau Statistical Service</a><p>Adicionado: 2022.1</p><p>Descontinuado: 2023.3</p></td><td><code>statsservice</code></td><td>O Tableau Statistical Service gerencia o mecanismo estatístico para Explique os dados e funções de modelagem preditiva.</td><td>É instalado automaticamente em qualquer nó onde o VizQL em segundo plano está instalado.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_statistical_service.htm" class="xref">Tableau Statistical Service</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_vizdata-service.htm" class="xref">Serviço VizData do Tableau Server</a><p>Adicionado: 2024.2</p></td><td><code>vizdataservice</code></td><td>O Serviço VizData gerencia conexões com fontes de dados publicadas no Tableau Server.</td><td>Uma ou mais instâncias do Serviço VizData são instaladas no nó inicial em uma nova instalação. O número de instâncias é determinado pelos recursos disponíveis.<p>Ao atualizar para 2024.2.3, uma instância do Serviço VizData é instalada para cada instância do Servidor de dados.</p><p><strong>Observação:</strong> a partir de 2024.2.3, pelo menos uma instância do Serviço VizData é necessária para uma instalação do Tableau Server.</p></td><td>Sim</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_vizdata-native-service.htm" class="xref">Serviço nativo VizData do Tableau Server</a><p>Adicionado: 2024.2</p></td><td><code>vizdatanativeservice</code></td><td>O serviço nativo VizData se comunica com o serviço VizData no Tableau Server.</td><td>Uma instância do Serviço nativo VizData é adicionada automaticamente para cada instância do Serviço VizData.</td><td>Sim</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_vizql-data-service.htm" class="xref">VizQL Data Service do Tableau Server</a><p>Adicionado: 2025.1</p></td><td><code>vizqldataservice</code></td><td>O VizQL Data Service é um serviço HTTP padrão que fornece APIs para acessar fontes de dados publicadas no Tableau por meio de consultas programáticas.</td><td>É instalado automaticamente em qualquer nó onde o VizData Service em segundo plano está instalado.<p><strong>Observação:</strong> o VizQL Data Service só está disponível por meio de acesso programático usando a API. Para obter informações sobre a API do VizQL Data Service, consulte a <a href="https://help.tableau.com/current/api/vizql-data-service/pt-br/index.html" target="_blank" title="link para referência da API do VDS">Referência da API do VizQL Data Service</a>.</p><p>O serviço será exibido na interface do usuário do TSM, a menos que tenha sido desativado. Para desativá-lo, você deve definir as instâncias como 0 e, em seguida, definir o sinalizador de recurso como “falso”. Para obter mais informações, consulte: <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#vizqldataservice_feature" class="xref">features.VizqlDataServiceDeployWithTsm</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_vizql-server.htm">VizQL Server</a></td><td><code>vizqlserver</code></td><td>O servidor VizQL carrega e renderiza exibições e calcula e executa consultas.</td><td>Ao instalar o VizQL Server, Gateway e Processador de dados também são instalados, a menos que o nó em questão já tenha uma instância deles.<p>Na maioria das situações, é possível alterar o número de instâncias de VizQL em um nó de um servidor que está em execução, sem cessar ou reiniciar o servidor. Há uma exceção ao adicionar um VizQL a um nó existente que não tenha esse recurso ou não tenha passado por nenhum outro processo que também instale o Gateway e o Processador de dados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_hot_topo.htm" class="xref">Alterações de topologia dinâmica do Tableau Server</a>.</p></td><td>Sim</td></tr><tr><td colspan="5"><p colspan="5"><strong>Processos do Contêiner de microsserviço do Tableau</strong> esses processos são adicionados automaticamente quando  a primeira instância do Processador em segundo plano ou Servidor de aplicativo é adicionado a um nó. Se todas as instâncias do Processador em segundo plano ou do Servidor de aplicativos forem removidas de um nó, o processo de contêiner de microsserviço também será removido.</p><p colspan="5">O status do contêiner depende o status dos microsserviços dentro dele. Se todos os microsserviços estiverem em execução, o processo de contêiner apresentam um status <code>running</code>. Se todos os microsserviços estiverem interrompidos, o status do processo de contêiner é <code>error</code>. Se um ou mais microsserviços estiver em execução enquanto outros não estão, o serviço do contêiner apresenta um status <code>degraded</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_container.htm" class="xref">Contêiners de microsserviço do Tableau Server</a>.</p></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_container.htm">Contêiner de microserviço interativo</a></td><td>&nbsp;</td><td>Processo de contêiner para microsserviços internos do Tableau Server que são agrupados para facilitar a implantação e a escalabilidade.</td><td>Esses contêineres e o microsserviços que eles contêm não podem ser configurados manualmente. Os microsserviços podem mudar com o tempo.</td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_container.htm">Contêiner de microserviço não interativo</a></td><td><code>noninteractive</code></td><td>Processo de contêiner para microsserviços internos do Tableau Server que são agrupados para facilitar a implantação e a escalabilidade.</td><td>Esses contêineres e o microsserviços que eles contêm não podem ser configurados manualmente. Os microsserviços podem mudar com o tempo.</td><td>Não</td></tr><tr><td colspan="5"><strong>Processos do Tableau Services Manager (TSM)</strong> - Esses processos terão um status de <code>running</code> depois da inicialização do TSM e permanecem em execução mesmo se o Tableau Server for interrompido.</td></tr><tr><td>Serviço de ativação<p>Adicionado na versão 2021.1</p></td><td>Não pode ser configurado manualmente.</td><td>O Serviço de Ativação, também conhecido como serviço de autorização para execução (ATR), permite que você ative o Tableau Server e permanecer com as licenças. Fornece contratos de curto prazo de duração configurável até que a chave do produto expire.</td><td>Instalado automaticamente no nó inicial a partir das versões 2023.1.3, 2022.3.7, 2022.1.15 e posteriores.<p>Nas versões anteriores, isso é instalado automaticamente no nó inicial quando o ATR está habilitado.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_admin-agent.htm">Agente de administração </a></td><td>Não pode ser configurado manualmente.</td><td>O agente TSM monitora o Serviço de coordenação para alterações na configuração ou topologia e fornece novas configurações a cada serviço (configuração)&nbsp;ou implanta novos serviços e remove os antigos (topologia)</td><td>Instalado automaticamente em cada nó em que você instala o Tableau Server.<p>Não é possível configurar o Agente de administração manualmente.</p><p>Para obter mais detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_admin-agent.htm" class="xref">Agente de administração do Tableau Server</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_tsm-admin-controller.htm">Controlador de administração</a></td><td>Não pode ser configurado manualmente, a não ser para movê-lo para outro nó. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/distrib_ha_init_node_fail.htm" class="xref">Recuperação de falha no nó inicial</a>.</td><td>O controlador TSM lida com as solicitações do TSM e orquestra as alterações de configuração e topologia, assim como o fluxo de trabalho pelos processo de servidor. O controlador também serve como o endpoint da REST API&nbsp;(HTTPS).</td><td>Instalado automaticamente ao instalar o TSM&nbsp;no nó inicial.<p>Não é possível configurar o Controlador de administração manualmente, a não ser movê-lo para outro nó. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/distrib_ha_init_node_fail.htm" class="xref">Recuperação de falha no nó inicial</a>.</p><p>Para obter mais detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/server_process_tsm-admin-controller.htm" class="xref">Controlador de administração do Tableau Server</a>.<a href="https://help.tableau.com/current/server/pt-br/server_process_tsm-admin-controller.htm" class="xref">Controlador de administração do Tableau Server</a></p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_cfs.htm">Serviço de arquivo do cliente (Client File Service)</a></td><td><code>clientfileservice</code></td><td>O serviço de arquivos do cliente (CFS) gerencia a maioria dos arquivos compartilhados em um cluster com vários nós. Por exemplo, certificados, chaves e arquivos relacionados à autenticação (OpenID, SSL mútuo, SAML e Kerberos) e arquivos de personalização são gerenciados pelo CFS.</td><td>Instalado automaticamente no nó inicial. Nenhuma outra instância está instalada, a menos que você as configure explicitamente. Consulte <a href="https://help.tableau.com/current/server/pt-br/distrib_cfs.htm" class="xref">Configurar Serviço de arquivo do cliente</a>.<p>Em implantações com vários nós, recomenda-se a configuração de uma instância do CFS (Serviço de arquivo do cliente) em cada um dos nós em que o Serviço de coordenação está implantado. A reimplantação do Serviço de coordenação não tem impacto no CFS.</p><p>O CFS não é exibido na página de Status ou de Configuração, mas fica visível na saída do comando <code>tsm status -v</code>.</p><p>Para exibir ou configurar as instâncias do CFS, use o comando <a href="https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm" class="xref">tsm topology</a>.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_coordination.htm">Serviço de coordenação</a></td><td>Não é possível ser definido com o <code>tsm topology set-process</code>.</td><td>O Serviço de coordenação serve como a fonte única de confiança.</td><td>Instalado automaticamente no nó inicial. Nenhuma outra instância é instalada a não ser que você implante explicitamente um novo ensemble de Serviço de coordenação. Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm" class="xref">Implantar um ensemble do Serviço de coordenação</a>.</td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_service-manager.htm">Gerenciador de serviço</a></td><td>Não pode ser configurado manualmente.</td><td>O Gerenciador de serviço</td><td>Instalado automaticamente em todos os nós.<p>Não é possível configurar o Gerenciador de serviço manualmente.</p></td><td>Não</td></tr><tr><td>Gerenciador de licença</td><td>Não pode ser configurado manualmente.</td><td>O Gerenciador de licença opera o licenciamento.</td><td>Instalado automaticamente no nó inicial ao instalar o TSM.<p>Uma licença única do mesmo é instalada em um cluster do <span class="mc-variable Variables.ProductName variable">Tableau Server</span>. O processo do Gerenciador de licença só deve ser configurado manualmente se o nó inicial falhar. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/distrib_ha_init_node_fail.htm" class="xref">Recuperação de falha no nó inicial</a>.</p></td><td>Não</td></tr><tr><td colspan="5"><strong>Processos de manutenção do Tableau Server</strong> - Esses processos têm um status de <code>stopped </code>, a menos que estejam ativamente em execução para concluir uma tarefa.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_tsm-maintenance.htm">Manutenção do banco de dados</a></td><td>Não pode ser configurado manualmente.</td><td>O serviço de Manutenção do banco de dados é responsável por executar a manutenção de operações no repositório do Tableau Server.</td><td>Instalado automaticamente em cada nó em que você instala o Tableau Server.<p>Mostra um status de <code>stopped </code>na saída do <code>tsm status -v</code>, a não ser que esteja executando ativamente uma manutenção do banco de dados. A manutenção pode incluir atualizações relacionadas a ativar o acesso remoto do repositório e a alterar senhas usadas para acessar o repositório.</p><p>Não é possível configurar o serviço de Manutenção do banco de dados manualmente.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_tsm-maintenance.htm">Back-up/Restaurar</a></td><td>Não pode ser configurado manualmente.</td><td>O serviço de Backup e restauração é responsável por executar operações de backup e restauração nos dados armazenados no repositório do Tableau Server, assim como o repositório de arquivos.</td><td>Instalado automaticamente em cada nó em que você instala o Tableau Server.<p>Mostra um status de <code>stopped </code>na saída do <code>tsm status -v</code>, a não ser que esteja executando um backup ou uma restauração.</p><p>Não é possível configurar o serviço de Backup e restauração manualmente.</p></td><td>Não</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_process_tsm-maintenance.htm">Importação/exportação do site</a></td><td>Não pode ser configurado manualmente.</td><td>O serviço de Importação e exportação é responsável por migrar sites do Tableau Server entres os clusters do servidor.</td><td>Instalado automaticamente em cada nó em que você instala o Tableau Server.<p>Mostra um status de <code>stopped </code>na saída do <code>tsm status -v</code>, a não ser que esteja executando uma importação ou exportação.</p><p>Não é possível configurar o serviço de Importação e restauração manualmente.</p></td><td>Não</td></tr></tbody></table>

## Fluxo de trabalho do processo

Os processos do Tableau Server e como eles interagem dependem de qual ação ou atividade está em execução. Por exemplo, os processos usados e como eles interagem são diferentes ao publicar uma pasta de trabalho e ao fazer logon usando SAML. Para algumas exibições interativas sobre o fluxo de trabalho do processo, consulte a pasta de trabalho abaixo. Isso permite que você selecione um fluxo de trabalho específico e siga suas etapas do início ao fim.

**Aviso de isenção**: esta pasta de trabalho é publicada no Tableau Public e não é assegurada pela documentação do Tableau. Não podemos garantir que ela esteja atualizada com a versão mais recente do Tableau Server.

## Outros artigos nesta seção

<!-- document id=3ece3b5a8a6b0a838bea56fe411e1af750679393b9ed9c24cf04b2e66fbda0bc url=/tableau/current/pt-br/server/clickjack_protection.md -->

[Pular para o conteúdo principal](#main-content)

# Proteção contra roubo de clique

A proteção contra ataques de roubos de clique é incluída no Tableau Server. _Roubo de clique_ é um tipo de ataque contra as páginas da Web, nos quais o invasor tenta fazer com que os usuários cliquem ou entrem em um conteúdo, ao exibirem a página de ataque em uma camada transparente sobre uma página não relacionada. No contexto do Tableau Server, um invasor pode tentar usar um ataque de roubo de clique para capturar as credenciais do usuário ou fazer com que o usuário altere as configurações no seu servidor. Para obter mais informações sobre os ataques de roubo de clique, consulte [Clickjacking](https://owasp.org/www-community/attacks/Clickjacking) no site Open Web Application Security Project.

**Observação**: a proteção contra roubo de clique foi disponibilizada nas versões anteriores do Tableau Server, porém estava desativada como padrão. Novas instalações do Tableau Server 9.1 e versões posteriores sempre terão a proteção contra roubo de clique, a menos que você a desative.

## Efeito da proteção contra roubo de clique

Quando a proteção contra roubo de clique estiver habilitada no Tableau Server, o comportamento das páginas carregadas do Tableau Server se altera da seguinte maneira:

- O Tableau Server adiciona o cabeçalho `X-Frame-Options: SAMEORIGIN` a determinadas respostas do servidor. Nas versões atuais da maioria dos navegadores, esse cabeçalho evita que o conteúdo seja carregado para um elemento **<iframe>**, ajudando a evitar ataques de proteção contra roubo de cliques.
- A página de nível superior do Tableau Server não pode ser carregada nos elementos **<iframe>**. Isso inclui a página de entrada. Uma consequência é que você não pode hospedar as páginas do Tableau Server em um aplicativo que você criou.
- Somente as visualizações podem ser inseridas.
- Se uma exibição inserida exigir as credenciais de fonte de dados, uma mensagem é exibida no elemento **<iframe>** com um link para abrir a exibição em uma janela segura, onde o usuário pode inserir com segurança as credenciais. Os usuários devem verificar sempre o endereço da janela aberta antes de inserir as credenciais.
- As exibições podem ser carregadas somente se incluírem o parâmetro `:embed=y` na cadeia de caracteres de consulta, como nesse exemplo:
    
    `http://<server>/views/Sales/CommissionModel?:embed=y`
    
    **Observação**: quando a proteção contra roubo de cliques está habilitada, as exibições inseridas que usam a URL copiada da barra de endereços do navegador talvez não sejam carregadas. Normalmente, essas URLs de exibição contêm o símbolo de hash (`#`) após o nome do servidor (por exemplo, `http://myserver/#/views/Sales/CommissionModel?:embed=y`) e são bloqueadas quando a proteção contra roubo de cliques está habilitada no Tableau Server.

## Desabilitar a proteção contra roubo de clique

Você deve manter a proteção contra roubo de clique habilitada, a menos que esteja afetando como os seus usuários trabalham com o Tableau Server. Se deseja desativar a proteção contra roubo de clique, use os seguintes comandos `tsm`:

1. tsm configuration set -k wgserver.clickjack\_defense.enabled -v false
2. 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).

<!-- document id=527eef2e4c0c90c2e3a7007f0e605a81c5ec73caf9041ba6c2cf6799b3067913 url=/tableau/current/pt-br/server/ts_aws_securing.md -->

[Pular para o conteúdo principal](#main-content)

# Proteger o Tableau Server na AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

A implantação do Tableau Server pode ser local ou na nuvem, mas sempre é importante tomar providências para torná-la segura. Para obter mais informações sobre como tornar o Tableau Server mais seguro, consulte [Segurança](https://help.tableau.com/current/server/pt-br/security.htm).

Além dos recursos de segurança inseridos no Tableau Server, a AWS fornece outros recursos que podem ser usados para auxiliar na proteção do seu ambiente do Tableau Server, como:

- **Amazon VPC** - acrescenta outra camada de segurança de rede ao seu ambiente, criando sub-redes privadas.
- **Grupos de segurança** - determina qual tráfego de entrada e saída pode se conectar à sua rede. Limite a entrada aos seus endereços IP no seu bloco [Classless Inter-Domain Routing (CIDR)](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing). Não use 0000\\0, que é inseguro, pois permite que todo o tráfego acesse o seu servidor.
- **AWS Identity and Access Management (IAM)** - permite controle específico sobre o acesso do usuário a recursos dentro da AWS.
- **AWS Direct Connect** - permite uma conexão de rede dedicada de uma rede corporativa à AWS usando VLANs 802.1Q padrão no setor, por meio de um parceiro do AWS Direct Connect. Para obter mais informações, consulte [Como solicitar conexões cruzadas em locais do AWS Direct Connect](http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html) no Guia do Usuário do AWS Direct Connect do site da AWS.
- **Criptografia Amazon EBS** - oferece uma maneira simples e eficaz de criptografar os dados inativos dentro dos volumes de disco e dos dados em trânsito entre as instâncias EC2 e o armazenamento EBS.

Implemente a segurança de aplicativo corporativa na AWS e no Tableau Server para permitir que um único relatório ou painel atenda com segurança às necessidades de uma base de usuário ampla e diversa, incluindo os usuários internos e externos. A segurança de aplicativos corporativos tem três componentes:

- [Rede](#Network)
- [Acesso do cliente](#Access)
- [Dados](#Data)

## Rede

A segurança de rede do Tableau Server na AWS depende do uso dos grupos de segurança da Amazon VPC com SSL para proteção de comunicações internas e externas. Para obter mais informações, consulte [Security groups para sua VPC](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html) no Guia do Usuário da Amazon Virtual Private Cloud no site da AWS.

### Amazon VPC

Uma Amazon VPC é uma rede distinta e isolada dentro da nuvem; o tráfego de rede dentro de cada Amazon VPC é isolado de outras Amazon VPCs. Usar uma Amazon VPC permite que você crie suas próprias sub-redes de rede e divide as camadas de aplicativo em sub-redes de rede para um maior nível de controle. Recomendamos instalar e executar o Tableau Server em uma sub-rede separada dentro da sua Amazon VPC de modo que consiga configurar a rede para acesso ao Tableau Server e a outros conjuntos de dados. A figura a seguir mostra uma instalação típica de um Tableau Server de nó único na Amazon VPC.

![Um diagrama de rede ilustra o posicionamento de um Tableau Server em uma sub-rede privada.](/tableau/current/pt-br/server/pt-br/Img/ts_aws_securing_vpc.png)

### Security Groups (Grupos de segurança)

Os Security groups permitem que você defina quais tipos de tráfego de rede podem acessar o Tableau Server. Os security groups do Amazon EC2 agem como um firewall que rege o tráfego de rede de entrada e saída das instâncias do Amazon EC2. Você pode definir e atribuir security groups adequados para as suas instâncias do Amazon EC2. Como padrão, as instâncias do Amazon EC2 são inicializadas com security groups que não permitem tráfego de entrada. Antes de acessar sua instância do EC2, é necessário fazer alterações para permitir o tráfego de entrada apropriado.

Aqui estão os requisitos mínimos para conexões ao Tableau Server em uma instância EC2:

- Conexão via RDP (porta 3389) usando um cliente de Desktop Remoto para acessar e gerenciar instâncias e serviços.
- Tráfego da Web padrão via HTTP (porta 80) e HTTPS (porta 443), para visualizar o conteúdo hospedado e para publicar no Tableau Server.
- A comunicação entre os componentes do Tableau Server em diferentes instâncias (se houver) deve ser permitida. Consulte [portas](https://help.tableau.com/current/server/pt-br/ports.htm) listada nas categorias **Todos** e **Disponibilidade atribuída/alta**.

Com base nesses requisitos, habilite somente três portas padrão para tráfego de entrada à sua instância EC2: HTTP 80, HTTPS 443 e RDP 3389. Também é necessário limitar o acesso remoto (porta 3389) de alguns hosts, além de limitar o tráfego de HTTP e HTTPS aos hosts dentro da sua rede corporativa ou para um conjunto confiável de clientes.

## Acesso do cliente

Por padrão, o Tableau Server usa solicitações e respostas de HTTP. O Tableau Server pode ser configurado para HTTPS (SSL) com os certificados de segurança fornecido pelo cliente. Quando o Tableau Server estiver configurado para SSL, todo o conteúdo e comunicações entre os clientes serão criptografados e usarão o protocolo HTTPS. Quando você configura o Tableau Server para SSL, o navegador e a biblioteca de SSL no servidor negociam um nível de criptografia comum. O Tableau Server usa o OpenSSL como a biblioteca SSL do servidor e está pré-configurado para usar os padrões aceitos atualmente. Cada navegador da Web que acessa o Tableau Server via SSL usa a implementação SSL padrão fornecida por esse navegador. Para obter mais informações sobre como o Tableau Server usa o SSL, consulte [SSL](https://help.tableau.com/current/server/pt-br/ssl.htm). O Tableau Server escutará o tráfego do SSL somente na porta 443. Você não pode configurar as portas personalizadas para SSL/TLS.

Se você estiver usando o Elastic Load Balancing (ELB), ele também pode executar a terminação do SSL em seu lugar. Permitir que o ELB lide com a criptografia/descriptografia do tráfego da Web é uma maneira fácil de proteger a conexão do cliente com o Tableau Server sem precisar configurar manualmente o SSL no próprio Tableau Server. Para obter mais informações, consulte [AWS Elastic Load Balancing: Support for SSL Termination](https://aws.amazon.com/blogs/aws/elastic-load-balancer-support-for-ssl-termination/) no site da AWS.

### AWS Directory Service

Opcional. O AWS Directory Service é um serviço gerenciado que permite a você conectar seus recursos da AWS a um diretório local existente, como Microsoft Active Directory (com AD Connector), ou configurar um diretório novo e autônomo na nuvem da AWS (com AD simples). A conexão com um diretório local é fácil e, após ter sido estabelecida, todos os usuários podem acessar os recursos e aplicativos da AWS com suas credenciais corporativas existentes.

Ao utilizar o AWS Directory Service, é possível optar por usar a autenticação baseada em Active Directory em vez da autenticação local, criando usuários e atribuindo senhas com o sistema de gerenciamento de usuário inserido do Tableau Server. Para configurar a autenticação baseada do Active Directory, na etapa de configuração após instalar o Tableau Server, escolha o Active Directory. Posteriormente. não será possível alternar entre o Active Directory e a autenticação local .

O modelo de autenticação do Active Directory usa o Microsoft Security Support Provider Interface (SSPI) para fazer logon dos seus usuários automaticamente, com base no nome de usuário e senha do Windows. Isso cria uma experiência semelhante à de logon único (SSO).

## Dados

O Tableau Server usa drivers nativos (e depende de um adaptador ODBC genérico quando os drivers nativos não estão disponíveis) para se conectar a bancos de dados sempre que possível, para processamento de conjuntos de resultados, para atualizações de extrações e para todas as outras comunicações com o banco de dados. Você pode configurar o driver para se comunicar em portas não padrão ou usar criptografias de transporte, mas esse tipo de configuração é transparente para o Tableau Server. No entanto, como a comunicação do Tableau Server com o banco de dados acontece normalmente por trás de um firewall, é possível optar por não criptografar esta comunicação.

### Conexão a armazenamento de dados na AWS

Você pode inicializar recursos da AWS, como o Amazon Relational Database Service (Amazon RDS), Amazon Elastic MapReduce (Amazon EMR) Hadoop Hive ou Amazon Redshift, em uma Amazon VPC. Ao colocar o Tableau Server na mesma Amazon VPC que os seus armazenamentos de dados, você garante que o seu tráfego nunca sairá da Amazon VPC.

Você pode usar sub-redes com security groups para inicializar seus recursos em diferentes camadas, mas permitir que elas se comuniquem dentro da Amazon VPC, conforme ilustrado no diagrama a seguir.

![Um diagrama ilustra a arquitetura de uma rede em nuvem.](/tableau/current/pt-br/server/pt-br/Img/ts_aws_securing_data.png)

### Conexão a armazenamento de dados fora da AWS

Como alternativa, é possível conectar a sua Amazon VPC aos seus próprios datacenters corporativos usando uma conexão VPN de hardware IPsec, portanto, tornando a nuvem AWS uma extensão dos datacenters. Uma conexão VPN consiste em um gateway privado virtual acoplado à sua Amazon VPC e um gateway do cliente localizado no seu datacenter. É possível optar por usar o AWS Direct Connect, que é um serviço de rede que oferece uma alternativa ao uso da Internet em relação à utilização de serviços da AWS. AWS Direct Connect permite que você estabeleça uma conexão da rede dedicada usando VLANs 802.1Q padrão no setor, por meio de um parceiro do AWS Direct Connect. Para obter mais informações, consulte [Como solicitar conexões cruzadas em locais do AWS Direct Connect](http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html) no Guia do Usuário do AWS Direct Connect do site da AWS.

É possível usar a mesma conexão para acessar recursos públicos (como objetos armazenados no Amazon Simple Storage Service \[Amazon S3\] usando espaço de endereço IP público) e recursos privados (como instâncias do Amazon EC2 executando em uma Amazon VPC usando espaço de IP privados), enquanto mantém a separação de rede entre os ambientes públicos e privados.

### Criptografia de dados inativos

A criptografia do Amazon EBS oferece um modo transparente e simples de criptografar volumes que podem conter informações pessoalmente identificáveis (PII). A criptografia EBS protege ambos dados inativos dentro do volume e os dados em trânsito entre o volume e a instância, usando AES-256. Esse recurso praticamente não afeta o desempenho do Tableau Server. Portanto, recomendamos que você utilize esse serviço, mesmo que o seu sistema não armazene PII.

<!-- document id=64fc6a082b263ae504f135a9755edc277feaf78725a8395b713d6d6eca34847a url=/tableau/current/pt-br/server/identity_pools.md -->

[Pular para o conteúdo principal](#main-content)

# Provisionar e autenticar usuários usando grupos de identidade

introduzidos no Tableau Server versão 2023.1, os pools de identidade são uma ferramenta de gerenciamento de identidade que usa informações de provisionamento e autenticação para permitir o acesso do usuário ao Tableau Server. Os pools de identidade permitem um fluxo de trabalho de gerenciamento de identidade mais centralizado e flexível, criado no [Serviço de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm) para repositório e gerenciamento de identidades de usuário no Tableau Server.

Os pools de identidade não substituem o provisionamento de usuário e as configurações de autenticação feitas usando o Tableau Services Manager (TSM) durante a instalação do Tableau Server. Em vez disso, eles são projetados para complementar e oferecer suporte a opções adicionais de provisionamento e autenticação de usuário que você pode precisar em sua organização, especialmente para organizações em que o TSM é configurado com Active Directory (AD) ou Lightweight Directory Access Protocol (LDAP). Os pools de identidade adicionam um método alternativo, após a configuração do Tableau Server, que dá suporte aos administradores do Tableau Server para adicionar usuários, que geralmente são usuários externos, parceiros ou contratados, à sua implantação do Tableau Server.

Os pools de identidades são otimizados para os seguintes casos de uso:

- **Usuários externos:** uma grande organização corporativa que não deseja adicionar usuários externos ao seu AD interno.
    
    Por exemplo, suponha que sua organização tenha dois tipos de funcionários: funcionários regulares e contratados. Seus funcionários regulares são provisionados por meio do Active Directory (AD) com autenticação SAML gerenciada por IdP, Okta. Seus funcionários contratados consistem em usuários que normalmente são associados a um grupo temporário ou fazem parte de outra organização que fornece usuários fora do AD e autentica separadamente. Os pools de identidade podem permitir que você adicione usuários do Tableau Server externos ao seu AD.
- **Vários repositórios de identidade:** uma organização que hospeda aplicativos SaaS que fornece usuários de vários repositórios de identidade.  
    
    Por exemplo, suponha que sua organização compartilhe o conteúdo do Tableau com várias organizações externas de um único site. Você pode separar esses usuários usando diferentes pools de identidade configurados com repositórios de identidade local para identificar e gerenciar mais facilmente os usuários de cada organização.
- **Limites de segurança entre organizações internas:** uma organização com várias organizações filhas adquiridas com limites de segurança distintos.  
    
    Por exemplo, você pode adicionar usuários da organização recém-adicionada a um pool de identidades configurado com um repositório de identidade local para solucionar as complexidades associadas à combinação de repositórios de identidade.

## O que são pools de identidade?

Um pool de identidades tem três componentes principais: um repositórios de identidades para provisionar usuários, autenticação OpenID Connect (OIDC) e usuários atribuídos.

- **Armazenamento de identidades:** o [armazenamento de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm) que você fornece ou provisiona para seus usuários pode ser um armazenamento de identidade local ou externo.
    
    - Se for um armazenamento de identidades local, um pool de identidades pode ser configurado para usar um armazenamento de identidades local novo ou existente. **Observação:** a autenticação local não é compatível.
    - Se for um armazenamento de identidades externo, um pool de identidades só poderá usar o mesmo armazenamento de identidades externo (AD ou LDAP) que você configurou no TSM durante a instalação do Tableau Server. Você não pode configurar um pool de identidades para usar um repositório de identidade externo diferente.
    
    As configurações de provisionamento e autenticação feitas no TSM durante a configuração do Tableau Server são chamadas de padrão ou “pool inicial (TSM configurado)”.
- **Autenticação:** o único método de autenticação com suporte para um pool de identidade é [OIDC](https://help.tableau.com/current/server/pt-br/security_auth.htm#oidc).
- **Usuários:** para que os usuários entrem no Tableau Server, eles devem ser provenientes do pool inicial (TSM configurado) ou ser membros de pelo menos um pool de identidades.

## Quando usar pools de identidades

Como administrador do Tableau Server, você pode usar um pool de identidades para segmentar seus usuários em coortes de identidade com base no local de provisionamento dos usuários e como esses usuários são autenticados no Tableau Server. Embora as configurações de autenticação e repositório de identidade feitas no TSM durante a configuração do Tableau Server, também chamadas de pool inicial (configurado pelo TSM), permaneçam inalteradas, os pools de identidade são configuráveis no Tableau Server.

**Observação:** no momento, os pools de identidades estão disponíveis apenas para configuração no nível do servidor. Os pools de identidades não podem ter como escopo um site.

## Mais sobre pools de identidade

### Pool inicial (TSM configurado) versus pools de identidade

Conforme observado acima, a combinação de configurações de provisionamento e autenticação que você faz no TSM durante a configuração do Tableau Server é chamada de “pool inicial (TSM configurado)”. O pool inicial (TSM configurado) é um componente necessário do processo de configuração do Tableau Server e não pode ser modificado.

Um pool de identidades, no entanto, é opcional e você pode criar quantos pools de identidades forem necessários diretamente no Tableau Server.

### Os pools de identidades afetam a experiência de login dos usuários

Por padrão, quando nenhum pool de identidades é criado para o Tableau Server, não há alteração na forma como os usuários navegam até a página inicial do Tableau Server e entram no Tableau Server.

Quando um ou mais grupos de identidades são criados, a página inicial do Tableau Server exibe várias opções de login. A opção de login principal é exibida na parte superior da página e é a maneira como os usuários que pertencem ao pool inicial (TSM configurado) podem entrar.

Abaixo da opção de entrada principal estão as opções de entrada secundárias. Cada opção representa um grupo de identidades, exibido na ordem em que foram criados. Os usuários atribuídos a esses grupos devem entrar usando a opção do grupo de identidades ao qual pertencem. Para ajudar a orientar seus usuários para a opção de login correta, considere adicionar uma descrição ao grupo de identidades ao criar um.

**Observação:** todos os usuários verão todos os pools configurados para o Tableau Server, independentemente de sua associação ao pool.

### Nomes de usuário e identificadores no Tableau

Um nome de usuário é a informação que representa o usuário do sistema. Um identificador é usado para complementar as informações de nome de usuário e pode ser usado por armazenamentos de identidade externos como alternativas aos nomes de usuário.

No Tableau, um nome de usuário é um valor imutável usado para entrar no Tableau e os identificadores são valores mutáveis usados na estrutura de identidade do Tableau como uma forma de corresponder os usuários aos seus nomes de usuário. Os identificadores permitem que o Tableau seja mais flexível porque podem se desviar do nome de usuário. Se houver alterações no nome de usuário no armazenamento de identidade externo, os administradores do Tableau Server podem atualizar o identificador para garantir que os usuários correspondam aos nomes de usuário corretos.

Ao adicionar um usuário existente a um grupo de identidades, você pode esperar a capacidade de definir um identificador. Por exemplo, se um usuário existente pertence a um pool de identidade configurado com um armazenamento de identidade local e você deseja adicioná-lo a um pool de identidade configurado com um armazenamento de identidade do AD, solicitamos que você forneça o nome de usuário para pesquisar identificadores associados a esse usuário . Por outro lado, se um usuário existente pertencer a um pool de identidade configurado com um armazenamento de identidade do AD e você quiser adicioná-lo a um pool de identidade configurado com um armazenamento de identidade local, pedimos que você forneça um identificador opcional. Uma exceção a isso é se você deseja adicionar um usuário ao pool inicial (configurado por TSM) que está configurado com um armazenamento de identidade local e autenticação local. Você não poderá definir um identificador para esse usuário.

## Outros artigos nesta seção

<!-- document id=e769dce251d80d845be865477778d3fec70f268bcbfd9b811db1ca864bb3fb12 url=/tableau/current/pt-br/server/publish_to_salesforce.md -->

[Pular para o conteúdo principal](#main-content)

# Publicar exibições no Salesforce

Traga suas exibições do Tableau Cloud ou Tableau Server diretamente ao seu ecossistema do Salesforce publicando visualizações em um aplicativo CRM Analytics ou página do Salesforce Lightning.

Para obter mais informações, consulte [Publicar conteúdo do Tableau no CRM Analytics](https://help.salesforce.com/s/articleView?id=sf.bi_publish_tableau_online.htm&language=en_US&type=5) na Ajuda do Salesforce.

## Pré-requisitos

Veja uma lista completa de [pré-requisitos](https://help.salesforce.com/s/articleView?id=sf.bi_tableauviews_setup_prereq.htm&type=5) na Ajuda do Salesforce, incluindo licenças necessárias, configuração de conta e permissões.

## Publicar uma exibição no Salesforce

Selecione uma ou mais exibições, incluindo painéis, planilhas e histórias. Em seguida, escolha um destino em uma lista de aplicativos do CRM Analytics que você tem acesso para editar ou gerenciar.

1. Selecione a exibição que deseja publicar no Salesforce.

**Observação**: você pode selecionar no máximo 25 exibições por vez para publicar no Salesforce.

3. Para Ações, selecione Publicar no Salesforce.
4. Selecione as credenciais do Salesforce que você deseja usar para publicação.
5. Selecione o aplicativo de destino que deseja publicar. Você só pode ver os aplicativos que pode editar ou gerenciar com o usuário do Salesforce conectado.
  
![Caixa de diálogo Publicar no Salesforce mostrando a lista de aplicativos que você pode escolher.](/tableau/current/pt-br/server/pt-br/Img/publish-to-salesforce-dialog.png)  
9. Clique em Publicar.

## Quem pode ver a exibição publicada no Salesforce?

Quando você publica uma exibição no Salesforce, qualquer pessoa com acesso ao aplicativo CRM Analytics ou à página do Lightning selecionado pode ver que o conteúdo existe. No entanto, somente aqueles conectados com permissões existentes do Tableau podem ver a exibição.

<!-- document id=f4fed2b25f03a247a1bc5cbedcd4e7214c6ff33974348074459f4c38fc9f62ab url=/tableau/current/pt-br/server/dm_vconn_publish_save.md -->

[Pular para o conteúdo principal](#main-content)

# Publicar uma conexão virtual e definir permissões

Quando você trabalha no editor de conexão virtual, suas alterações são salvas automaticamente como um rascunho enquanto você trabalha. Para compartilhar uma nova conexão virtual com outros usuários, você precisa publicá-la.

## Salvar um rascunho

Você pode salvar manualmente um rascunho da conexão clicando no ícone Salvar ![Salvar ícone](/tableau/current/pt-br/server/pt-br/Img/ipa_Save_16px_medium.png) na barra de ferramentas ao selecionar Arquivo \> Salvar rascunho no menu.

Ao editar uma conexão virtual publicada, ela permanece disponível para os usuários em seu estado publicado atual. Você pode salvar as atualizações como um rascunho enquanto trabalha na conexão no editor. Para compartilhar as atualizações da nova conexão virtual com outros usuários, você precisa publicá-la.

### Rascunho em andamento

Se você fechar o editor enquanto atualiza uma conexão virtual publicada, da próxima vez que abrir a conexão no editor dentro de sete dias, terá a opção de continuar a fazer edições no rascunho existente, iniciar um novo rascunho ou abrir a conexão em seu estado atual publicado clicando em Cancelar.

![Mensagem de rascunho já existente](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_draft_exists.png)

Para retornar a uma versão de rascunho de uma conexão virtual não publicada, você precisa salvar manualmente a URL do rascunho **antes** de fechar o editor. Você pode usar a URL para abrir o rascunho no editor na próxima vez que quiser trabalhar na conexão em sete dias. Por exemplo:

`https://yourserver.test.com/published-connection-editor/?draft=d1789edc-5d9f-40ae-988d-9fc879f37a98`

## Publicar a conexão

Para publicar uma nova conexão:

1. Clique no botão Publicar no canto superior direito do editor ou selecione Arquivo > Publicar no menu.
2. Na caixa de diálogo Publicar:
    1. Digite um nome no campo Nome.
    2. Selecione um projeto para salvar a conexão.
3. Clique em Publicar.

Para publicar uma conexão atualizada, clique no botão Publicar no canto superior direito do editor ou selecione Arquivo > Publicar no menu.

## Definir permissões em uma conexão virtual

Depois de publicar uma conexão virtual, você precisa definir as permissões para que outras pessoas possam usá-la. Por padrão, todos os usuários podem Exibir a conexão, em outras palavras, vê-la listada em Conexões virtuais no Tableau, mas a menos que você defina o recurso Conectar como Permitido, apenas você e os administradores podem usar a conexão virtual. Para obter mais informações sobre o recurso Conectar, consulte [Permissões](https://help.tableau.com/current/server/pt-br/dm_vconn_overview.htm#VConnOverviewPermissions).

Para definir permissões:

1. Navegue até a conexão virtual.
2. Abra o menu Ações (...) e clique em Permissões.
3. Selecione a caixa sob o ícone Conectar para que a conexão seja permitida para todos os usuários.
    
    ![Caixa de seleção de permissão de Conexão permitida](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_connect_allowed.png)
    
    > [!TIP]
    > 
    > **Dica:** você pode adicionar regras adicionais se desejar conceder permissão apenas a determinados usuários ou grupos.
4. Clique em Salvar.

Para obter mais informações sobre permissões no conteúdo do Tableau, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#contentlevel-permissions). Para obter informações sobre como inserir senhas ao publicar conteúdo do Tableau, como uma fonte de dados ou uma pasta de trabalho que usa uma conexão virtual, consulte [Conexões virtuais](https://help.tableau.com/current/server/pt-br/publishing_sharing_authentication.htm#virtual-connection-embedded-password) noTableau Server ajuda.

## Quem pode fazer isso

Para publicar uma conexão virtual ou definir permissões, você deve

- ter credenciais para o banco de dados ao qual a conexão virtual se conecta e
- ser um servidor ou administrador de site ou um Creator.

## Próxima etapa

Depois de publicar uma conexão virtual e definir suas permissões, você pode [Use uma conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_use.htm) .

<!-- document id=b1e9e2772149c6674348b1e9f5d28a459f912cb2ab6def8d3dd7d65a45f48332 url=/tableau/current/pt-br/server/distrib_when.md -->

[Pular para o conteúdo principal](#main-content)

# Quando adicionar nós e reconfigurar

O Tableau Server pode ser dimensionado horizontal e verticalmente, conforme o aumento dos seus requisitos e necessidades. Veja algumas diretrizes que ajudam a perceber se está na hora de adicionar nós ao sistema, reconfigurar o servidor, ou ambos:

- **Mais de 100 usuários simultâneos**: se sua implantação tiver um grande número de usuários (mais de 100 visualizadores simultâneos), é importante ter processos VizQL suficientes, mas nem tantos a ponto de exceder a capacidade do hardware para lidar com eles. Além disso, habilitar a opção [Conta de usuário convidado](https://help.tableau.com/current/server/pt-br/maintenance_set.htm) do Tableau Server aumenta o número de possíveis visualizadores simultâneos para além da lista de usuários que você acha que tem. A exibição administrativa pode ajudar a fazer essa medição. Para obter mais informações, consulte [Ações por usuário específico](https://help.tableau.com/current/server/pt-br/adminview_user.htm).
- **Uso intenso de extrações e atualizações de extração frequentes**: as extrações podem consumir muitos recursos da memória e da CPU. Não há uma medida que qualifique um site como grande consumidor de extrações. Ter apenas algumas extrações extremamente grandes pode colocar seu site nessa categoria, como se você tivesse muitas extrações pequenas. Os sites em que extrações são frequentemente atualizadas (por exemplo, várias vezes ao dia) são geralmente ajudados pela maior ênfase no processo em segundo plano, que lida com tarefas de atualização. Use a exibição administrativa [Tarefas em segundo plano para extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd.htm) para ver sua taxa atual de atualizações. Os sites com uso intenso de extrações aproveitam o isolamento do processo do Processador em segundo plano em sua própria máquina. Para obter mais informações, consulte a configuração de dois nós no tópico [Configurações de linha de base recomendadas](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#two-node).
- **Ambientes com uso intenso de consultas**: caso esteja experienciando baixo desempenho de consulta em pastas de trabalho que usam extrações, isolar os nós que lidam com consultas em extrações dos processos VizQL pode aprimorar o desempenho. Para obter mais informações, consulte [Otimizar para ambientes - com muitas consultas de extração](https://help.tableau.com/current/server/pt-br/perf_tuning_long_queries_for_extracts.htm).
- **Tempo de inatividade potencial**: se seu sistema de servidores for considerado essencial e exigir um alto nível de disponibilidade, você poderá configurá-lo de forma que haja redundância para os processos do servidor que identificam extrações, o repositório e o gateway.

<!-- document id=a7d412972059f3169b9e5fce17243874791dd1c15260a453a2f8730ad9cf3ace url=/tableau/current/pt-br/server/datasource_mfr_when_to_use.md -->

[Pular para o conteúdo principal](#main-content)

# Quando usar um modelo de relação de vários fatos

Um modelo de relação de vários fatos é um modelo de dados que permite adicionar tabelas não relacionadas em uma única fonte de dados e, em seguida, usar campos relacionados durante a análise visual para essencialmente unir as tabelas com base no contexto. Ao contrário da combinação, os dados existem em uma única fonte de dados — os conceitos de fontes de dados primárias e secundárias não se aplicam e nenhum dado é eliminado das uniões de coluna à esquerda. Ao contrário de um modelo de dados de tabela única, várias tabelas base mantêm seu próprio contexto em relação às tabelas compartilhadas entre eles. Um modelo de dados de relação de vários fatos oferece mais opções para realizar análises de vários fatos no Tableau.

Imagine que você deseja analisar a tendência do clima e das vendas de sorvetes juntos. As vendas de sorvete e clima acontecem em horários e locais específicos, mas não há conexão direta entre as vendas de sorvete e o clima. Esses são dados não relacionados que se relacionam aos conceitos compartilhados de data e local.

Esta questão se presta à criação de um modelo de relação de vários fatos. Vendas de sorvete e clima podem ser adicionados como uma tabela base e relacionados em data e local, que são tabelas compartilhadas.

![um modelo de dados de tabela base múltipla com duas tabelas base e duas tabelas compartilhadas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_icw_.png)

Um modelo de dados de tabela base múltipla, com duas tabelas não relacionadas (Vendas de sorvete e Clima) e duas tabelas compartilhadas (Data e Local). Existe uma tabela intermediária, Informações do Salão, entre Vendas de Sorvetes e Localização.

### Por que construímos a capacidade de modelar tabelas não relacionadas?

A análise geralmente envolve reunir tabelas de dados que nem sequer têm uma relação direta entre si, mas que se relacionam com as mesmas informações comuns (como data ou local). Um modelo de relação de vários fatos oferece suporte ao acoplamento semântico flexível, introduzindo o conceito de graus de relação e a capacidade de construir um modelo de dados com múltiplas tabelas base não relacionadas.

- Acoplamento semântico é um termo usado para descrever o quão estreitamente combinados os dados são. Uma _união de coluna_ ou _união de lonha_ é um acoplamento semântico rígido; eles reúnem várias tabelas em uma nova tabela física que atua como uma única tabela. A _relação_ é um acoplamento mais frouxo entre tabelas que une as tabelas logicamente, mantendo seu status distinto como tabelas separadas. Ainda mais adiante no espectro do acoplamento semântico está _combinação de dados_, onde os resultados de fontes de dados separadas são combinados visualmente com base em elementos compartilhados entre ambos. Um _modelo de relação de vários fatos_ está mais próximo da extremidade combinada do espectro, mas dentro de uma única fonte de dados, em vez de entre fontes de dados.

Um modelo de relação de vários fatos — um modelo de dados com diversas tabelas base — permite tabelas não relacionadas no modelo, desde que também existam tabelas compartilhadas no modelo. Durante a análise, os campos de uma tabela compartilhada “unem” tabelas de dados que de outra forma não seriam relacionadas com base nas dimensões compartilhadas que elas têm em comum (como acontecer no mesmo local ou ao mesmo tempo). Todos os benefícios das relações são mantidos, incluindo a retenção da granulação de cada tabela, ou nível nativo de detalhe.

Semelhante a um modelo de dados de tabela base única, o Tableau determina o melhor tipo de junção a ser usado nos bastidores com base na estrutura da visualização. Mas em um modelo de relação de vários fatos, as opções de união de colunas são expandidas para incluir uniões de coluna externas e cruzadas para lidar com diferentes níveis de relação. Para mais informações, veja [Sobre modelos de dados de relação de vários fatos](https://help.tableau.com/current/server/pt-br/datasource_mfr_multiple_base_tables.htm).

### Qual é a origem do nome?

As relações multifatoriais recebem esse nome devido à análise de vários fatos. Em um modelo de data warehouse, os dados são armazenados em uma tabela de fatos central cercada por tabelas de dimensões. Nesse contexto, _fato_ refere-se a medidas ou métricas, que são campos numéricos de dados que capturam fatos sobre os dados – as medidas do Tableau. As tabelas de dimensões contêm atributos sobre esses fatos.

Os esquemas baseados em tabelas de fatos são frequentemente estruturados como uma estrela ou um floco de neve, dependendo de como as tabelas de dimensões são organizadas. Quando a análise precisa ser realizada em tabelas de fatos, isso é chamado de análise de vários fatos. A análise é feita no contexto das tabelas de dimensões comuns, conhecidas como dimensões compartilhadas ou dimensões conformadas. No Tableau, você cria esses modelos de dados usando relacionamentos, por isso chamamos esse conjunto de recursos de relacionamentos multifatores.

## Quando usar modelos de dados de relações multifatoriais

Se seus dados consistirem em tabelas relacionadas entre si, você poderá usar fontes de dados de tabela base única criadas com relações. Um modelo de relação de vários fatos é necessário quando seus dados abrangem conceitos diferentes, seja na forma de múltiplas tabelas de fatos ou em diferentes contextos não relacionados.

Sempre que possível, construa suas fontes de dados com uma única tabela base. Em um modelo de dados de tabela base única, todas as tabelas estão relacionadas e não há necessidade de considerar graus de relação. Use relações multifatoriais apenas quando essa estrutura de modelo de dados for necessária.

### Análise de vários fatos

A análise de vários fatos é um caso de uso central para relacionamentos multifatoriais no Tableau. Neste exemplo, o Fato A e o Fato B compartilham uma data da tabela.

![um modelo de dados multifatorial](/tableau/current/pt-br/server/pt-br/Img/mfr_use_mfa_model.png)

Para modelar isso no Tableau, as tabelas de fatos tornam-se tabelas base e várias relações de entrada são estabelecidos para suas tabelas de dimensões compartilhadas.

![um modelo de dados de relação de vários fatos](/tableau/current/pt-br/server/pt-br/Img/mfr_use_mfr_model.png)

### Outros cenários

No entanto, os modelos de dados de relação de vários fatos não servem apenas para análise de vários fatos. O Tableau não exige uma definição estrita de tabelas de fatos ou dimensões. Qualquer tabela pode ser uma tabela base (embora deva se adequar ao [características das tabelas base](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_when_to_use.htm#characteristics)). Alguns cenários que indicam uma fonte de dados de múltiplas tabelas base podem ser úteis incluem: 

- **Passando pelas etapas**, como tabelas base para inscrições, históricos escolares e eventos de ex-alunos para uma tabela compartilhada de alunos.
- **Contextos diferentes para os mesmos eventos**, como tabelas base para eventos de consultas médicas e faturas de cobrança, com tabelas compartilhadas para contextualizar médicos ou pacientes.
- **Diferentes domínios que podem se correlacionar,** como cenários que anteriormente seriam melhor tratados com combinação de dados, como vendas de sorvete e clima correlacionados por meio de tabelas compartilhadas de data e local.

Saiba mais sobre quando relacionamentos multifatores são úteis nesta postagem do blog do Tableau: [Quando e como usar relacionamentos multifatores no Tableau](https://www.tableau.com/pt-br/blog/when-how-use-multi-fact-relationships-tableau).

## Identificar as tabelas base

Em um modelo de relações multifatoriais, a direcionalidade é importante. Ou seja, quais tabelas são as tabelas base no lado esquerdo do modelo e quais tabelas são compartilhadas posteriormente impactam o modo como as relações são avaliadas para retornar os resultados analíticos.

Considere uma gravata-borboleta conceitual de faturas, consultas, médicos e pacientes:

![um modelo de dados de gravata borboleta com faturas e consultas do lado de fora e médicos e pacientes no meio](/tableau/current/pt-br/server/pt-br/Img/mfr_bowtie1.png)

A maneira correta de construir o modelo de dados no Tableau é com Faturas e Compromissos como tabelas base e com Médicos e Pacientes como tabelas compartilhadas (não com Médicos e Pacientes como tabelas base).

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col></colgroup><tbody><tr><td><p><b>Correto</b>: Faturas e Compromissos como tabelas base</p></td><td><p><b>Incorreta</b>: Médicos e Pacientes como tabelas base</p></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_bowtie2.png" alt="um modelo de dados de tabela de base múltipla com faturas e compromissos como bases e médicos e pacientes como tabelas compartilhadas downstream"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_bowtie3_wrong.png" alt="um modelo de dados de múltiplas tabelas base com médicos e pacientes como tabelas base e faturas e compromissos como tabelas compartilhadas downstream"></td></tr></tbody></table>

Conceitualmente, paciente (ou médico) é a entidade que une o evento da consulta e o evento da fatura.

Se o seu modelo de dados for inverso (como com Médicos e Pacientes como tabelas base em vez de Consultas e Faturas), o [comportamento de junção de união de colunas externa](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#Stitched) não será tão útil. Sua análise pode mostrar muitas medidas e ambiguidades no escopo da tabela. Se você se deparar com campos relacionados de forma ambígua que não esperava, reavalie as tabelas que está usando como tabelas base e veja se seu modelo de dados precisa ser revertido.

### Características das tabelas base e tabelas compartilhadas

Se você estiver realizando uma análise de vários fatos, as tabelas de fatos se tornarão as tabelas base e quaisquer tabelas de dimensão compartilhada serão tabelas compartilhadas. O Tableau não exige uma adesão estrita às características da tabela de fatos e dimensões. No entanto, existem determinados atributos que podem ajudá-lo a identificar quais tabelas devem ser tabelas base e quais devem ser tabelas compartilhadas.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col></colgroup><tbody><tr><td><p style="font-weight: bold;">Tabela base</p></td><td><p><b>Tabela compartilhada</b></p></td></tr><tr><td><p>Tabelas de fatos em um esquema de data warehouse</p></td><td><p>Tabelas de dimensões compartilhadas ou conformadas em um esquema de data warehouse</p></td></tr><tr><td><p>Específico para o contexto ou análise</p><p>(informações de voo, uso de energia)</p></td><td><p>Conceito consistente em vários contextos</p><p>(data, local)</p></td></tr><tr><td><p>Medir pesado</p></td><td><p>Principalmente dimensões</p></td></tr><tr><td><p>Atualizado/transacional com mais frequência</p><p>(consultas médicas, prescrições, sinais vitais)</p></td><td><p>Mais estável/durável</p><p>(médico, paciente)</p></td></tr><tr><td><p>Tem campos de chave estrangeira</p></td><td><p>Tem campos de chave primária</p></td></tr><tr><td><p>Baseado em eventos</p><p>(horário de aula, nota em uma tarefa)</p></td><td><p>Baseado em entidade</p><p>(aluno, sala de aula)</p></td></tr></tbody></table>

Observe que se houver tabelas intermediárias entre uma tabela base e uma tabela compartilhada, você poderá [trocar a tabela base](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_build.htm#swap) sem alterar fundamentalmente o modelo de dados. (Como Informações do salão e Vendas de sorvete no primeiro exemplo.) O que importa é quais tabelas estão acima das tabelas compartilhadas e quais são compartilhadas.

### Experimentar uma tabela base adicional

Existem vários cenários que podem indicar que você deve construir um modelo de relações multofatoriais com diversas tabelas base em vez de uma única fonte de dados de tabela base:

- Se você estiver tentando criar uma fonte de dados com um ciclo, a tabela downstream deverá ser outra tabela base.
- Se você tiver uma série de tabelas relacionadas nos mesmos conjuntos de cláusulas de relação (como data e local), essas dimensões deverão ser extraídas e transformadas em tabelas compartilhadas.
    - Isso é especialmente útil porque múltiplas cláusulas de relacionamento devem ser todas verdadeiras (logicamente, um AND) para que as tabelas sejam relacionadas para esses registros.
    - Se, em vez disso, você quiser analisar registros onde um pode ser verdadeiro por vez (um OR contextual), essa flexibilidade será fornecida pela configuração de um modelo de dados com tabelas de dimensões compartilhadas.
- Se você estiver usando uma combinação, mas quiser ter uma combinação equivalente sem fontes de dados primárias e secundárias, crie um modelo de dados que combine as fontes de dados da combinação com seus campos de vinculação em uma tabela ou tabelas compartilhadas.

<!-- document id=d7a1e1f0943568d93f92b67b89741e6388a528b97c5a7898df8526a3ca4ff7bd url=/tableau/current/pt-br/server/distributed_install_recommendations.md -->

[Pular para o conteúdo principal](#main-content)

# Recomendações de instalações distribuídas

Ao adicionar nós a uma instalação do Tableau Server, é preciso decidir quantos processos serão executados em cada computador. Esta página oferece algumas recomendações gerais a serem encaradas apenas como ponto de partida.

Além disso, recomenda-se também que:

- Compreenda como a sua organização usa o Tableau Server e ajuste a sua configuração para seu caso de uso — por exemplo, se deseja otimizar para a resposta do usuário ou as atualizações da extração.
- Realize o teste de desempenho completo para identificar os melhores locais para ajustar a configuração do processo.

Para obter informações sobre como adaptar a instalação de um Tableau Server para as necessidades da sua empresa, consulte [Ajuste de desempenho](https://help.tableau.com/current/server/pt-br/perf_tuning.htm).

Para obter mais informações sobre os requisitos de uma instalação distribuída e sobre a configuração de nós adicionais, consulte [Instalações distribuída e de alta disponibilidade do Tableau Server](https://help.tableau.com/current/server/pt-br/distrib_ha.htm).

## Recomendações para todas as instalações

Embora os computadores que formam um cluster do Tableau Server não precisem ter hardware idêntico, todos devem atender aos mesmos requisitos mínimos do sistema. As recomendações nesta página pressupõem que os computadores com o Tableau Server instalado têm oito núcleos ou mais.

As recomendações a seguir se aplicam a todas as configurações do servidor:

- Se planejar atualizar com frequência as extrações, execute os processos do Processador em segundo plano em um computador dedicado. Os processos do processador em segundo plano são geralmente os que mais usam a CPU e podem tornar lentos outros processos no mesmo computador.
- Caso pretenda atualizar com frequência as extrações ou atualizar grandes extrações, aumente o número de processos do Processador em segundo plano.
- Execute os processos do VizQL em um computador que não seja o dos processos do Processador em segundo plano. Tê-los na mesma máquina significa que as atualizações da extração podem afetar as exibições do usuário.
- A instância do Processador de dados instalada no nó, onde o armazenamento de arquivos está instalado, é usada para consultas de dados das solicitações de exibição. Considere separar o processo de Armazenamento de arquivos dos processos do processador em segundo plano para ajudar a minimizar o efeito das tarefas do processador em segundo nas exibições do usuário.
- **Otimização com configurações de topologia:**
    
    - Colocalizar o Armazenamento de arquivos no mesmo nó que o Controlador de administração pode reduzir o tempo necessário para fazer backup do Tableau Server, reduzindo ou eliminando a necessidade de transferir dados entre nós durante o processo de backup. Isso é especialmente verdade se sua organização usa muitos extratos.
    - A colocalização do repositório (pgsql) com o nó Controlador de administração também pode ajudar a reduzir o tempo de backup, mas a economia de tempo é menos significativa do que a do Armazenamento de arquivos.
    
    O Controlador de administração geralmente está no nó inicial, a menos que você tenha tido uma falha no nó inicial e movido o controlador para outro nó.

**Observação:** em uma instalação distribuída, com três nós ou mais, você poderá ter no máximo duas instâncias de repositório (ativa e passiva). Você também pode executar o Tableau Server com um repositório, mas fazer isso significa que não há failover disponível para o repositório. Para obter mais informações, consulte [Repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_repository.htm).

<!-- document id=bb6b8e9ad1a2e740052ad2afa679defdc260e6c6828c60878035b33802c1a465 url=/tableau/current/pt-br/server/server_external_filestore_storage_reconfigure.md -->

[Pular para o conteúdo principal](#main-content)

# Reconfigurar Armazenamento de arquivos

O Tableau Server pode ser configurado com um Armazenamento de arquivos em execução localmente ou com um Armazenamento de arquivos externo. Este tópico descreve as etapas necessárias para reconfigurar o Tableau Server existente:

- [Configure o Tableau Server para usar o Armazenamento de arquivos externo](#reconfigure-external). Isso mudará seu Armazenamento de arquivos para um compartilhamento de rede.
- [Reconfigure o Tableau Server para executar o Armazenamento de arquivos localmente.](#reconfigure-local). Isso moverá o Armazenamento de arquivos do armazenamento externo para o Tableau Server.
- [Configure o Tableau Server para usar um armazenamento diferente](#configure-new-storage). Um exemplo disso pode ser quando o compartilhamento de rede atual está no fim da vida útil, e você precisa usar um novo compartilhamento de rede com novo hardware.

## Reconfigurar o Tableau Server com Armazenamento de arquivos externo

### Pré-requisitos

- O Tableau Server deve ser a versão 2020.1 ou posterior.
- Você deve ter um compartilhamento de rede para usar como armazenamento externo.
    
    Usar compartilhamentos SMB para instalações do Windows.
    
    Considerações de armazenamento e rede: consulte [Considerações de desempenho para armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_performance.htm).
    
    Estimativa do tamanho do armazenamento: você deve levar em consideração a quantidade de armazenamento necessária para publicar e atualizar as extrações. Além disso, você também deve levar em consideração o tamanho do backup do repositório, a menos que escolha especificamente a opção de fazer o backup do repositório separadamente, conforme descrito no tópico [Opção 2: repositório de backup separadamente](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm#backup-repository-separately)
    
    - Extrações:
        - Considere o número de extrações que será publicado no Tableau Server e o tamanho de cada extração. Teste as suas necessidades ao publicar várias extrações no Tableau Server e, em seguida, verifique o espaço em disco usado. Você pode usar essa quantidade de espaço em disco para ajudar a descobrir quantas extrações serão publicadas no Tableau Server no decorrer do tempo, além de como cada extração existente terá o tamanho aumentado.
        - Considere o espaço necessário pelo diretório temp durante uma atualização de extração. O diretório temp, que armazena uma extração durante a atualização, pode necessitar de um tamanho três vezes maior que o do arquivo final.
    - Backup do repositório:
        - Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório `<data directory>/pgsql/data/base`.
        - Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo `workgroup.pg_dump`.
- O Tableau Server deve ter uma licença do Advanced Management válida e ativa.

### Etapa 1: atualizar o Tableau Server

Atualize o Tableau Server para 2020.1 ou posterior: [Atualização do Tableau Server (Windows)](https://help.tableau.com/current/server/pt-br/sug_plan.htm). Se o Tableau Server já estiver na versão 2020.1 ou posterior, poderá ignorar esta etapa.

### Etapa 2: ativar a licença do Advanced Management

1. [Visualizar licenças do servidor](https://help.tableau.com/current/server/pt-br/view_licenses.htm) para garantir que você tenha uma licença do Advanced Managementativada no Tableau Server.
2. Se você não tiver um Advanced Managementno Tableau Server, use o seguinte comando tsm para ativar a licença. Forneça a chave Advanced Management como a chave do produto:
    
    `tsm licenses activate -k <product key>`

### Etapa 3: configurar o armazenamento de arquivos para usar um armazenamento externo

Depois de concluir a atualização e verificar as licenças, configure o Tableau Server com o Armazenamento de arquivos externo. Isso moverá todos os dados existentes do Armazenamento de arquivos local para o armazenamento externo de sua escolha.

1. Configure um compartilhamento de rede. No servidor de arquivos:
    - Crie e compartilhe um diretório para hospedar os arquivos
    - Em todos os nós do Tableau Server, mapeie o compartilhamento de rede ou use um caminho UNC.
2. Crie um diretório do tableau no compartilhamento de rede e dê acesso total à conta **Serviço de rede**. Recomendamos chamar diretório de **tableau**.
    
    **Observação:**  
    \- A conta do Serviço de rede pode ser usada para acessar recursos em computadores remotos no mesmo domínio do Active Directory, mas recomendamos configurar uma conta de domínio o serviço **Run As** para usar nesse cenário. Para obter mais informações, consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm).  
    \- Serviços que funcionam como a conta do Serviço de rede acessam os recursos de rede usando as credenciais da conta do computador no formato _<domain\_name>\\<computer\_name>$_.  
    Se você estiver usando o Active Directory para gerenciar permissões e acesso dos usuários, aqui está uma maneira recomendada de gerenciar as permissões para o compartilhamento da rede:  
    \- Crie um grupo de segurança do Active Directory.  
    \- Adicione as contas do computador do cluster Tableau juntamente com o **usuário Run-As** a esse grupo.  
    \- Conceda acesso ao grupo de segurança no compartilhamento de rede. Desta forma, se você precisar adicionar ou remover um computador do cluster, basta fazer a alteração para o grupo de segurança.
3. Habilite o recurso de compartilhamento de rede usando os seguintes comandos tsm:
    
    tsm topology external-services storage enable --network-share \\\\hostname\\<network share>\\tableau\\
    
    O programa de instalação cria automaticamente a seguinte estrutura de diretório e moverá os dados do Armazenamento de arquivos local para o armazenamento externo. Os Armazenamentos de arquivos locais serão desativados automaticamente durante este processo.
    
    **Extrações e revisões de livros:**
    
    _tableau\_data tabsvc/dataengine/extracts_
    
    _tableau\_data/tabsvc/dataengine/revisions_
    
    **Backups de dados PostgreSQL:**
    
    _tableau\_data/tabsvc/repository\_backup_
    
    **Observação:** esse diretório será criado na primeira vez que você criar um backup.

## Reconfigurar o Tableau Server para usar o Armazenamento de arquivos local

1. Interrompa o Tableau Server executando o seguinte comando:
    
    `tsm stop`
2. Execute o comando a seguir para mover os dados do Armazenamento de arquivos externo para o Tableau Server:
    
    `tsm topology external-services storage disable –fsn <node1, node2>`
3. Inicie o Tableau Server executando o seguinte comando:
    
    `tsm start`

Em um cluster do Tableau Server, especifique os nós onde o Armazenamento de arquivos deve ser instalado. Os dados são copiados para o primeiro nó especificado no comando e, em seguida, replicados para os outros nós.

**Observação:** ao mover o Armazenamento de arquivos de externo para local, certifique-se de que o processo do Processador de dados não está instalado sozinho em um nó separado, ele deve estar instalado juntamente com um dos principais serviços que incluem File Store, Application Server (VizPortal), VizQL Server, Data Server Processador em segundo plano.  
  
Normalmente, quando você instala o Processador de dados do Tableau Server, a instalação acontece automaticamente nos nós com um ou mais serviços principais. No entanto, quando você configurar o Tableau Server para usar o armazenamento externo, terá a capacidade de instalar manualmente o Processador de arquivos em um nó por conta própria sem colocalizar com os processos principais.  
  
Se você tiver atualmente um processo de Processador de dados instalado em um nó separado, você pode optar por instalar o Armazenamento de arquivos nesse nó ou remover o Processador de dados desse nó, antes de executar o comando disable. Se você instalar o Armazenamento de arquivos em um nó que atualmente não tem o Processador de dados instalado, o Processador de dados será adicionado automaticamente.  
  
Se você tiver um nó de Processador de dados somente, quando executar o comando disable, ocorrerá um erro.

## Configurar o Tableau Server para usar um armazenamento externo diferente

1. Configure o novo compartilhamento de rede. No servidor de arquivos:
    
    1. Crie e compartilhe um diretório para hospedar os arquivos.
    2. Em todos os nós do Tableau Server, mapeie o compartilhamento de rede ou use um caminho UNC.
2. Crie um diretório do tableau no compartilhamento de rede e dê acesso total à conta **Serviço de rede**. Recomendamos chamar diretório de **tableau**.
3. Interrompa o Tableau Server executando o seguinte comando:
    
    `tsm stop`
4. Execute o seguinte comando para configurar o Tableau Server para usar o novo compartilhamento de rede:
    
    tsm topology external-services storage switch-share --network-share \\\\<newshare>\\tableau
5. Inicie o Tableau Server executando o seguinte comando:
    
    `tsm start`

## Quem pode fazer isso

Os administradores do Tableau Server podem mover os locais do Armazenamento de arquivos. Além disso, você precisará acessar o armazenamento externo usado para Armazenamento de arquivos externo.

<!-- document id=b9718112cbdb65213ae3f7815fb078c5c040b9e6076f7cffd10b797bd9e3cb91 url=/tableau/current/pt-br/server/server_external_repo_reconfigure.md -->

[Pular para o conteúdo principal](#main-content)

# Reconfigurar o repositório do Tableau Server

O Tableau Server pode ser configurado para usar um repositório local ou externo. Este tópico descreve as etapas necessárias para reconfigurar o Tableau Server existente com uma das seguintes opções:

- Mova um repositório do Tableau Server local para um repositório externo e configure o Tableau Server para usar um repositório externo.
- Mova o Repositório do Tableau Server externo para a instalação do Tableau Server local e configure o Tableau Server para usar o repositório local. Isso significa que o repositório do Tableau Server será instalado na mesma máquina ou nas mesmas máquinas que o Tableau Server.

**Nota:** o Tableau Server deve ser interrompido para que seja possível mover o repositório com segurança.

Para saber mais sobre essas opções e repositórios externos, consulte [Repositório externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo.htm).

## Mover um repositório local para um externo

O Tableau Server deve ser interrompido para migrar de um repositório local para um repositório externo.

Use as etapas a seguir para mover o repositório do Tableau Server de local para externo:

1. Ative a chave do produto Advanced Management no Tableau Server se ainda não estiver ativada. A licença do Advanced Management é necessária para configurar o Tableau Server com um repositório externo.
2. Configure a instância do banco de dados PostgreSQL da Amazon para usar como o repositório externo.
    1. Amazon: [Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_RDS.htm)
    2. Banco de dados do Azure: [Criar uma instância PostgreSQL do banco de dados do Azure no Azure](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_Azure.htm).
    3. Banco de dados do Google Cloud: [Criar uma instância PostgreSQL no Google Cloud](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_gcp.htm)
    4. Instância autônoma do PostgreSQL: [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm) .
3. Crie um arquivo json com as seguintes definições de configuração:
    
    {
     "flavor":"<flavor name>",
     "masterUsername":"<admin user name>",
     "masterPassword":"<password>", 
     "host":"<instance host name>",
     "port":5432
    }
    
    - **flavor:** é o tipo de serviço externo que você usará para o repositório do Tableau Server.
        
        - Amazon RDS: use "rds"
        - Banco de dados do Azure: use "azure"
        - Banco de dados do Google Cloud: use "gcp"
        - Banco de dados PostgreSQL autônomo: use "generic"
    - **masterUsername:**
        
        - Amazon RDS: use "trilhas" para o nome de usuário. Esse é o usuário que você especificou ao criar a instância de RDS.
            
            > [!IMPORTANT]
            > 
            > Você deve usar “trilhas” como o masterUsername. Isso é necessário para que o repositório externo funcione corretamente com o Tableau Server.
        - **Instância de banco de dados do Azure, Google Cloud e PosgreSQL autônoma:** escolha um nome de usuário que atenda aos seus requisitos. Recomendamos usar **postgres** como nome de usuário do Administrador. Se você optar por usar um nome de usuário diferente, certifique-se de que ele não comece com **pg** ou **azure**. O nome de usuário também não pode ser **rails**, **tblwgadmin,** **tableau**, **readonly** ou **tbladminviews**. Ao escolher um nome de usuário diferente de "postgres", após cada restauração de backup, o sufixo "\_bak" será adicionado ao usuário inicial do sistema "postgres" no repositório, como "postgres\_bak".
    - **masterPassword:** esta é a mesma senha que você especificou ao criar a instância do banco de dados PostgreSQL.
    - **host:** este é o endpoint da instância de banco de dados PostgreSQL.
    - **port:** a porta do banco de dados que você especificou ao criar a instância de banco de dados PostgreSQL.
4. Execute o seguinte comando CLI do TSM para configurar o Tableau Server para usar o repositório externo:
    
    `tsm topology external-services repository enable -f file.json -c <ssl certificate file>.pem`
    
    **Observação:** o certificado SSL é necessário apenas se você estiver usando conexões criptografadas entre o Tableau Server e o repositório externo. Se isso não for obrigatório para você, especifique a opção `--no-ssl`. Nesse caso, o comando tsm ficaria assim:  
    `tsm topology external-services repository enable -f <filename>.json --no-ssl`  
    
    O arquivo json é o arquivo que você criou na primeira etapa com as definições de configuração. O arquivo de certificado SSL pode ser baixado conforme descrito [neste tópico](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL).
    
    A execução do comando acima migrará o repositório local para a nova instância de banco de dados PostgreSQL externa.

## Mover repositório externo para local

O Tableau Server deve ser interrompido para migrar de um repositório externo para um repositório local.

Use as etapas a seguir para mover o repositório do Tableau Server do local externo para a instalação local:

1. Execute o seguinte comando CLI do TSM para mover o repositório para um nó específico:
    
    `tsm topology external-services repository disable -n nodeN`
2. Se você estiver configurando HA para o repositório, instale o repositório em um segundo nó. Para obter mais informações, consulte [Exemplo: Instalar e configurar um cluster HA de três nós](https://help.tableau.com/current/server/pt-br/distrib_ha_install_3node.htm).
    
    **Observação:** para instalar o repositório em um segundo nó, você deve executar o comando descrito na etapa anterior primeiro. A primeira etapa migra o repositório externo para o repositório local. Em seguida, você pode instalar o repositório em um segundo nó no Tableau Server.

## Quem pode fazer isso

Os administradores do Tableau Server podem reconfigurar o repositório externo. Você também precisará ter acesso para criar a instância do banco de dados PostgreSQL na Amazon ou no Azure.

<!-- document id=3e94c9c76f091f9386f646282332728da43a4175197ec9e11ddf164aca1d9a8a url=/tableau/current/pt-br/server/distrib_ha_init_node_fail.md -->

[Pular para o conteúdo principal](#main-content)

# Recuperação de falha no nó inicial

O primeiro computador no qual você instalou o Tableau, o "nó inicial”, tem algumas características únicas. Três processos executam apenas no nó inicial e não podem ser movidos para qualquer outro nó exceto em uma situação de falha, o Serviço de Licença (Gerenciador de licenças), o Serviço de Ativação e o Controlador do TSM (Controlador de administração). O Tableau Server inclui um script que automatiza a movimentação desses processos para um dos outros nós existentes, para que obtenha acesso completo de volta ao TSM e mantenha o Tableau Server em execução.

Dois outros processos são inicialmente incluídos no nó inicial, mas podem ser adicionados ou movidos para nós adicionais, o CFS (Serviço de arquivos do cliente) e o Serviço de coordenação. Dependendo de como sua instalação foi configurada com o CFS e o serviço de coordenação, você também pode precisar tomar medidas para reimplantá-los.

## Se um nó inicial falhar

Se houver um problema com o nó inicial e você tiver processos redundantes em seus outros nós, não há garantia de que o Tableau Server continuará em execução.

- O Tableau Server pode continuar em execução por até 72 horas após uma falha inicial do nó, antes que a falta do serviço de licenciamento afete outros processos. Se afetar, seus usuários ainda poderão fazer logon, ver e usar seus conteúdos depois da falha no nó inicial, mas você não poderá reconfigurar o Tableau Server, pois não tem acesso ao Controlador de administração.
- Se você estiver executando uma versão do Tableau Server 2021.4.2 (ou anterior) configurada para ATR, os problemas com o nó inicial tornarão todas as funcionalidades do servidor indisponíveis. Isso é verdade se o nó tiver um problema ou se você o interromper intencionalmente (por exemplo, para fazer um patch no nível do sistema).

Mesmo quando configurado com processos redundantes, _é possível que o Tableau Server não continue a funcionar após a falha do nó inicial_. Isso acontece mesmo quando uma instalação é configurada para alta disponibilidade. Isso significa que é necessário mover os dois processos exclusivos para outro nó em execução o mais rápido possível. Se o seu nó inicial falhar por motivos que sejam recuperáveis em uma quantidade de tempo relativamente pequena (por exemplo, uma falha no hardware que você pode corrigir), em primeiro lugar, tente ativar o nó novamente sem usar o procedimento abaixo.

**Observação:** as etapas neste artigo exigem tempo de inatividade do servidor e podem atrapalhar, então devem ser usar somente no caso uma falha catastrófica do nó inicial. Se não for possível executar o nó inicial novamente, use as seguintes etapas para mover processos principais do TSM para outro nó no cluster.

## Requisitos gerais

A versão 2021.1 do Tableau Server foi atualizada com melhor funcionalidade de recuperação. O procedimento neste tópico foi escrito para o Tableau Server 2021.1.

Se você está tentando recuperar um nó falho de uma versão anterior do Tableau Server, siga o procedimento para essa versão. Para ver versões arquivadas da ajuda do Tableau, consulte [Ajuda do Tableau](https://www.tableau.com/pt-br/support/help).

- Como parte do processo de configuração de uma instalação de vários nós do Tableau Server, é necessário ter implantado um ensemble do Serviço de coordenação. O processo abaixo presume a existência de um ensemble do Serviço de coordenação implantado antes do problema com o nó inicial. Para obter mais informações sobre a implantação de um ensemble do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
- Esse processo pressupõe que você configurou instâncias do CFS (Serviço de arquivo do cliente) em cada nó que está executando o Serviço de coordenação. Se você não adicionou instâncias adicionais de CFS, sua única instância estava no nó inicial, e será preciso adicionar pelo menos uma instância de CFS a outro nó. Além disso, será necessário preencher novamente o CFS. O Tableau Server exige pelo menos uma instância do CFS. Para obter mais informações, consulte [Configurar Serviço de arquivo do cliente](https://help.tableau.com/current/server/pt-br/distrib_cfs.htm) e [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm) .

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

## Mover o Controlador TSM, Serviço de licença e Serviço de ativação para outro nó

Se houver um problema com o nó inicial, o Controlador TSM, Serviço de licença e Serviço de ativação precisam ser iniciados em outro nó. Siga as etapas a seguir para usar o script fornecido `move-tsm-controller` e fazer com que o Controlador TSM, Serviço de licença e Serviço de ativação funcionem em outro nó.

1. Em um nó ainda em funcionamento, execute o script de recuperação do Controlador. Para isso, abra um prompt de comando, navegue até o diretório de script do Tableau Server (Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\` ) e digite o seguinte comando:
    
    `move-tsm-controller -n <nodeID>`
    
    onde "nodeID" ié a ID do nó no qual deseja que o Controlador TSM seja executado. Por exemplo:
    
    `move-tsm-controller -n node2`
2. Feche e abra novamente a janela de comando e verifique se o Controlador de administração está em execução no nó ao digitar o seguinte comando:
    
    `tsm status -v`
3. Pare o Tableau Server.
    
    O restante deste procedimento inclui alguns comandos com a opção `--ignore-node-status`. Quando um comando é executado com a opção `--ignore-node-status`, o comando será executado sem considerar o status do nó especificado. Para usar `--ignore-node-status`, especifique o nó com falha:
    
    `tsm stop --ignore-node-status <nodeID>`
    
    Por exemplo, se node1 falhou, execute o seguinte comando:
    
    `tsm stop --ignore-node-status node1`
4. Adicione o Serviço de licença ao nó:
    
    `tsm topology set-process -pr licenseservice -n <nodeID> -c 1`
5. Remova o Serviço de licença antigo do nó original, onde "nodeID" é o nó inicial que falhou:
    
    `tsm topology set-process -pr licenseservice -n <nodeID> -c 0`
6. Se você estiver executando uma das seguintes versões
    
    - 2023.3.0 ou posterior
    - 2023.1.3 ou posterior
    - 2022.3.7 ou posterior
    - 2022.1.15 ou posterior
    
    _ou_ se estiver executando uma versão anterior e usando ATR, adicione o serviço de ativação ao novo nó:
    
    `tsm topology set-process -pr activationservice -n <nodeID> -c 1`
7. Se você estiver executando uma dessas versões ou posterior
    
    - 2023.3.0 ou posterior
    - 2023.1.3 ou posterior
    - 2022.3.7 ou posterior
    - 2022.1.15 ou posterior
    
    _ou_ estiver executando uma versão anterior e usando ATR, remova o Serviço de ativação antigo do nó original, em que "nodeID" é o nó inicial que falhou:
    
    `tsm topology set-process -pr activationservice -n <nodeID> -c 0`
    
    **Importante:**Em um cluster, se um nó que está executando sua única instância do CFS falhar, todos os arquivos gerenciados pelo CFS serão perdidos e você precisará preencher novamente esses arquivos do CFS, reimportando certificados e imagens personalizadas e fazendo quaisquer alterações de configuração relacionadas. para obter uma lista de arquivos gerenciados pelo CFS, consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).
8. Se o nó inicial estiver executando o Serviço de mensagens , adicione o Serviço de mensagens a esse nó:
    
    `tsm topology set-process -pr activemqserver -n node2 -c 1`
9. (Opcional) Além disso, é possível adicionar outros processos que eram executados no nó inicial, mas não estão funcionando neste nó. Por exemplo, para adicionar um servidor cache:
    
    `tsm topology set-process -pr cacheserver -n node2 -c 1`
10. Aplique as alterações:
    
    `tsm pending-changes apply --ignore-node-status <nodeID>`
    
    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).
11. Reinicie o Controlador de administração do TSM:
    
    `net stop tabadmincontroller_0`
    
    `net start tabadmincontroller_0`
    
    **Observação:** você deve executar esses comandos como administrador em um prompt de comando. Dependendo da configuração do computador, talvez seja necessário executá-los na pasta `C:\Windows\System32`.
    
    **Observação:** pode demorar alguns minutos para tabadmincontroller reiniciar. Se você tentar aplicar alterações pendentes na próxima etapa, antes que o controlador tenha reiniciado completamente, o TSM não conseguirá se conectar ao controlador. Use o comando `tsm status -v` para garantir que o controlador esteja funcionando. O Controlador de administração do Tableau Server deve ser listado como "em execução".
12. Aplique as alterações pendentes (pode parecer não ter nenhuma alteração, mas esta etapa é obrigatória):
    
    `tsm pending-changes apply --ignore-node-status <nodeID>`
13. Ative a licença Tableau Server no novo nó do Controlador:
    
    `tsm licenses activate -k <product-key>`
14. Certifique-se de que a licença esteja ativada adequadamente:
    
    `tsm licenses list`
15. Se o nó inicial estava executando o Serviço de coordenação, implante um novo ensemble do Serviço de coordenação que não inclua esse nó. Se você tiver um cluster de três nós e o nó inicial estiver executando o Serviço de coordenação, implante um novo ensemble do Serviço de coordenação de uma única instância em um nó diferente e limpe o antigo. Neste exemplo, uma única instância do Serviço de coordenação está sendo implantada no segundo nó:
    
    `tsm topology deploy-coordination-service -n node2 --ignore-node-status node1`
16. Se o nó inicial estiver executando uma instância do Armazenamento de arquivos, será necessário removê-la:
    
    `tsm topology filestore decommission -n <nodeID> --delete-filestore`
    
    Onde `nodeID` é o nó inicial que falhou.
17. Aplique as alterações pendentes, usando o sinalizador `--ignore-warnings`, se o novo ensemble do Serviço de coordenação implantado acima for um ensemble de nó único:
    
    `tsm pending-changes apply --ignore-node-status node1 --ignore-warnings`
18. Remova o nó inicial, onde `nodeID` é o nó inicial que falhou:
    
    `tsm topology remove-nodes -n <nodeID>`
19. Aplique as alterações pendentes, usando o sinalizador `--ignore-warnings`, se o novo ensemble do Serviço de coordenação implantado acima for um ensemble de nó único:
    
    `tsm pending-changes apply --ignore-warnings`
20. Inicie o Tableau Server:
    
    `tsm start`
    
    Nesse momento, o servidor deverá iniciar e você poderá usar o TSM para configurá-lo. A etapa a seguir é a substituição do nó inicial, para que o cluster tenha a quantidade original de nós. A forma como isso é feito depende de você querer ou não usar novamente o nó que apresentou falha. Recomendamos usar novamente o nó somente se puder identificar a razão da falha e seguir as etapas para impedir que ocorra novamente.
21. Caso planeje usar o nó original novamente, antes é necessário remover completamente o Tableau dele. Faça isso ao executar o script `tableau-server-obliterate`. Para obter detalhes, consulte [Remover o Tableau Server do computador](https://help.tableau.com/current/server/pt-br/remove_tableau.htm).
22. Em outro computador, ou no computador original após remover completamente o Tableau, instale o Tableau usando o Programa de instalação original e um arquivo bootstrap gerado a partir do nó que executa o Controlador de administração e o Serviço de licenciamento. Isso cria um nó adicional que você pode configurar como parte do cluster. Para obter detalhes sobre como adicionar o nó, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).
    
    Uma prática recomendada é configurar os processos perdidos durante a falha do nó original, para garantir que o cluster esteja completamente redundante. Você pode querer mover os processos do nó inicial para o novo nó adicional de forma a duplicar a configuração original. Por exemplo, se o nó inicial estava executando somente gateway e Armazenamento de arquivo, você pode querer configurar o nó inicial da mesma forma.
23. Além disso, é necessário reimplantar um novo ensemble do Serviço de coordenação, uma vez que todos os nós estão funcionando conforme o esperado. Para obter detalhes, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
24. Por fim, se você ainda não fez isso, adicione uma instância de CFS a cada nó que está executando o Serviço de coordenação. Para obter mais informações, consulte [Configurar Serviço de arquivo do cliente](https://help.tableau.com/current/server/pt-br/distrib_cfs.htm)
    
    Em um cluster, se um nó que está executando sua única instância do CFS falhar, todos os arquivos gerenciados pelo CFS serão perdidos e você precisará preencher novamente esses arquivos do CFS, reimportando certificados e imagens personalizadas e fazendo quaisquer alterações de configuração relacionadas.Para obter uma lista de arquivos gerenciados pelo CFS, consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

<!-- document id=191c5a2e214c135d937b07a597679f24898a8fb8a323ff7543396b02ebdca7cd url=/tableau/current/pt-br/server/distrib_node_fail.md -->

[Pular para o conteúdo principal](#main-content)

# Recuperar-se de uma falha no nó

Se houver um problema com um dos nós do servidor e você tiver processos redundantes em outros nós, o Tableau Server poderá continuar a ser executado. Os usuários poderão fazer logon, além de ver e usar o conteúdo depois da falha no nó, mas poderá ocorrer uma degradação no desempenho como resultado dessa falha. Além disso, o servidor estará com maior risco de falha catastrófica se o nó defeituoso estiver executando processos que não são mais redundantes. Isso significa que você deve remover o nó defeituoso e substituí-lo assim que possível. Se o seu nó falhar por motivos que sejam recuperáveis em uma quantidade de tempo relativamente pequena (por exemplo, uma falha no hardware que você pode corrigir), em primeiro lugar, tente ativar o nó novamente sem usar o procedimento abaixo.

**Observação:** se o nó com falha for o nó _inicial_, haverá implicações maiores para as instalações do Tableau Server. Por exemplo, para que a Criação na Web do Prep funcione, o servidor de cache deve estar em execução no nó de menor numeração onde está configurado. Se o servidor de cache estiver configurado nos nós 2, 3 e 4, mas estiver inativo no nó 2, a Criação na Web do Prep não funcionará. Para obter detalhes sobre como se recuperar da falha em um nó inicial, consulte [Recuperação de falha no nó inicial](https://help.tableau.com/current/server/pt-br/distrib_ha_init_node_fail.htm). Para obter detalhes sobre a Criação na Web do Prep que não funciona quando o servidor de cache está inativo, consulte [O servidor de cache não está em execução no nó de menor numeração](https://help.salesforce.com/s/articleView?id=003962421&type=1) na Base de Conhecimento.

## Requisitos gerais

A versão 2020.1 do Tableau Server foi atualizada com melhor funcionalidade de recuperação. O procedimento neste tópico foi escrito para o Tableau Server 2020.1.

Se você está tentando recuperar um nó falho de uma versão anterior do Tableau Server, siga o procedimento para essa versão. Para ver versões arquivadas da ajuda do Tableau, consulte [Ajuda do Tableau](https://www.tableau.com/pt-br/support/help).

- Existe pelo menos um nó funcionando com uma instância do Armazenamento de arquivos.
- Existe pelo menos um nó funcionando com um Repositório.
- Existe pelo menos um nó funcionando com o Serviço de arquivo do cliente (CSF) nele.

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

## Remoção de um nó com falha

Para remover um nó com falha de um cluster do Tableau Server:

1. Identifique o nó com falha:
    
    tsm status -v
    
    O nó com falha terá um status de "ERRO" e os processos serão exibidos como indisponíveis. A ID do nó é listada como "node<n>", seguida do nome da máquina. Por exemplo, `node3`:
    
    node3: WIN-OO915SFASVH
    						Status: ERROR
    					'Tableau Server Gateway 0' status is unavailable.
2. Interrompa o Tableau Server.
    
    O restante deste procedimento inclui alguns comandos com a opção `--ignore-node-status`. Quando um comando é executado com a opção `--ignore-node-status`, o comando será executado sem considerar o status do nó especificado. Para usar `--ignore-node-status`, especifique o nó com falha:
    
    `tsm stop --ignore-node-status <nodeID>`
    
    Por exemplo, se node3 falhou, execute o seguinte comando:
    
    tsm stop --ignore-node-status node3
3. Determine os principais processos que estavam em execução no nó:
    
    - Se o nó com falha estava executando o Serviço de mensagens, é necessário remover o serviço do nó com falha e adicioná-lo a um nó de trabalho.
        
        Remova-o do nó com falha:
        
        tsm topology set-process -pr activemqserver -n <nodeID> -c 0
        
        Adicione-o a um nó de trabalho:
        
        tsm topology set-process -pr activemqserver -n <nodeID> -c 1
    - Se o nó com falha estava executando o Serviço de coordenação, será necessário implantar um novo ensemble antes de remover o nó.
        
        tsm topology deploy-coordination-service -n <good\_nodeID> --ignore-node-status <failed\_nodeID>
    - Se o nó com falha estava executando a única instância do Client File Service (Serviço de arquivo do cliente, CFS), será preciso configurar uma nova instância de CFS em um nó em funcionamento. Recomendamos que você configure o CFS em cada nó que esteja executando o Serviço de coordenação. Para obter as etapas de detalhes, consulte [Configurar Serviço de arquivo do cliente](https://help.tableau.com/current/server/pt-br/distrib_cfs.htm).
    - Se o nó com falha estava executando o Armazenamento de arquivos, será necessário forçar a desativação do Armazenamento de arquivos e removê-lo antes de remover o nó.
        
        tsm topology filestore decommission -n <nodeID> --delete-filestore
        
        Aplique as alterações pendentes (use a opção `--ignore-warnings` se você tiver um cluster de três nós e uma única instância do Serviço de coordenação):
        
        tsm pending-changes apply --ignore-warnings --ignore-node-status <nodeID>
4. Se o cluster for de três nós e houver repositórios nos nós de trabalho restantes, será necessário remover um repositório ou adicionar um novo nó. Isso ocorre porque você está limitado a uma única instância do repositório se tiver menos de três nós.
    
    Para remover um repositório:
    
    tsm topology set-process -n <nodeID> -pr pgsql -c 0
5. Execute o comando para remover o nó com falha. Isso adiciona a alteração à lista de alterações pendentes:
    
    tsm topology remove-nodes -n <nodeID>
6. Verifique se a remoção do nó está pendente:
    
    tsm pending-changes list
7. Aplicar as alterações pendentes para remover o nó:
    
    tsm pending-changes apply
8. Inicie o Tableau Server:
    
    tsm start
9. Instale o Tableau Server em um novo nó e configure-o com os processos em execução no nó antigo com falha.
10. Em outro computador, ou no computador original após remover completamente o Tableau, instale o Tableau usando o Programa de instalação original e um arquivo bootstrap gerado no nó inicial. Para obter detalhes sobre como fazer isso, consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).
    
    Uma prática recomendada é configurar os processos perdidos durante a falha do nó original, para garantir que o cluster esteja completamente redundante.
11. Além disso, é necessário reimplantar um novo ensemble do Serviço de coordenação, uma vez que todos os nós estão funcionando conforme o esperado. Para obter detalhes, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
12. Por fim, se você ainda não fez isso, adicione uma instância de CFS a cada nó que está executando o Serviço de coordenação. Para obter mais informações, consulte [Configurar Serviço de arquivo do cliente](https://help.tableau.com/current/server/pt-br/distrib_cfs.htm)

<!-- document id=789f5591f03be575041c678876d63aa3d72583b26629bd48a2288504de335bc2 url=/tableau/current/pt-br/server/prep_conductor_developer_resources.md -->

[Pular para o conteúdo principal](#main-content)

# Recursos do Desenvolvedor - APIs REST

Use as APIs REST do Tableau Server para automatizar e integrar perfeitamente o Tableau ao seus fluxos de trabalho existentes. A API REST do Tableau Server oferece acesso programático para trabalhar com seu conteúdo, usuários, sites e agora fluxos. Gerencie o provisionamento, as permissões e a publicação no Tableau Server ou no Tableau Cloud por meio do HTTP. A API REST oferece acesso à funcionalidade por trás das fontes de dados, projetos, pastas de trabalho, usuários de sites, sites e fluxos. É possível usar esse acesso para criar aplicativos personalizados ou para criar scripts de interações com os recursos do servidor.

A API REST do Tableau dá suporte à seguinte funcionalidade de fluxo:

Novos endpoints de fluxo foram adicionados para oferecer suporte a fluxos de publicação, fluxos de agendamento, fluxos em execução sob demanda, gerenciamento de permissões, download de fluxos, entre outros. Para obter uma lista completa de todos os endpoints da API REST para fluxos, consulte [Métodos de fluxo](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_flow.htm).

Além disso, os [endpoints existentes](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm) foram atualizados para oferecer suporte à funcionalidade de fluxo, como Criação de novas agendas para fluxos, Criação de novos sites, atualização de sites existentes e gerenciamento de permissões padrão.

**Observação**: a licença de Data Management é necessária ao usar a API REST para executar fluxos.

<!-- document id=a60f57f61cd0be9369e093201b2de8f95c8566217ce9050a53b22d70bfdac727 url=/tableau/current/pt-br/server/permissions_capabilities.md -->

[Pular para o conteúdo principal](#main-content)

# Recursos e modelos de permissão

As permissões consistem em recursos ou na capacidade de realizar determinada ação em uma parte do conteúdo, como exibir, filtrar, baixar ou excluir. Cada linha na área Regras de permissão da caixa de diálogo é uma _regra de permissão_. As Regras de permissão são a configuração de cada recurso (permitido, negado ou não especificado) do grupo ou usuário nessa linha. As regras de permissão têm _modelos_disponíveis que facilitam a atribuição de recursos rapidamente. As Regras de permissão também podem ser copiadas e coladas.

**Observação**: na caixa de diálogo de permissão para projetos, há guias para cada tipo de conteúdo: Projetos, Pastas de trabalho, Fontes de dados etc. Quando uma regra de permissão é adicionada, o padrão para todos os recursos em todos os tipos de conteúdo é Não especificado. Para permitir ou negar recursos para cada tipo de conteúdo, acesse cada guia da caixa de diálogo de permissão de cada vez. Isso define o padrão para todo o conteúdo desse tipo no projeto (como todas as pastas de trabalho). Na caixa de diálogo Permissões de uma determinada parte do conteúdo, não há guias e as regras de permissão só se aplicam a essa parte.

## Modelos

Os Modelos agrupam conjuntos de recursos que muitas vezes são atribuídos juntos com base em cenários comuns de usuários, Exibir, Explorar, Publicar e Administrar. Quando você atribui um modelo, estão incluídas as capacidades definidas como Permitido, com o resto deixado como Não especificado. Os modelos são cumulativos, então o modelo Explorar inclui tudo, desde o modelo Exibir até recursos adicionais. Todo o conteúdo também tem um modelo para **Nenhum** (que define todos os recursos para não especificados) e **Negado**(que define todos os recursos para negados).

Os modelos devem ser um ponto de partida e podem ser ajustados após serem aplicados. Os recursos também podem ser concedidos ou negados sem usar um modelo. Em ambos os casos, a coluna de modelos mostra Personalizados.

## Copiar e colar permissions

Se houver uma regra de permissão que precisa ser atribuída a vários grupos ou usuários, você pode copiar e colar de uma regra para outra. Você não pode copiar ou colar em uma regra que envolve o status de Líder de projeto.

1. Abra o menu Ação (...) da regra existente que deseja copiar e selecionar Permissões de cópia. Isso está disponível somente quando a regra não estiver no modo de edição.
2. Selecione uma regra existente na qual deseja colar. Além disso, é possível criar uma nova regra clicando e \+ Adicionar Regra de grupo/usuário e selecionar um grupo ou usuário.
3. Abra o menu Ações (...) e selecione Permissões.

## Permissões efetivas

Lembre-se, só porque um usuário recebeu um recurso em uma determinada regra, não significa que ele terá a capacidade de executar essa ação. Há limites de função no site sobre o que um usuário pode fazer (consulte [Permissões, funções de site e licenças](https://help.tableau.com/current/server/pt-br/permission_license_siterole.htm)), e várias regras de permissões podem precisar ser comparadas para avaliar os recursos finais para um determinado usuário (consulte [Permissões efetivas](https://help.tableau.com/current/server/pt-br/permission_effective.htm)).

## Recursos

Cada tipo de conteúdo tem recursos específicos:

### Projetos

Os projetos têm apenas dois recursos e dois modelos. Para obter mais informações sobre os líderes de projeto e como atribuí-los, consulte [Administração de projetos](https://help.tableau.com/current/server/pt-br/permissions_projects.htm#projectpermissions).

#### Exibir o modelo

![Ícone Exibir.](/tableau/current/pt-br/server/pt-br/Img/perms_view_icon.png)**Exibir** permite que um usuário veja o projeto. Se um usuário não tiver recebido o recurso Exibir, o projeto não estará visível para ele. A concessão da capacidade de exibição de um projeto não significa que o usuário possa ver qualquer conteúdo no projeto, apenas a existência do projeto em si.

#### Publicar modelo

![Ícone Salvar.](/tableau/current/pt-br/server/pt-br/Img/perms_save_icon.png)**Publicar** permite que um usuário publique conteúdo no projeto do Tableau Desktop ou do Tableau Prep Builder. O recurso Publicar é necessário para mover o conteúdo para o projeto ou salvar conteúdo no projeto da criação na Web.

### Pastas de trabalho

#### Exibir o modelo

![Ícone Exibir.](/tableau/current/pt-br/server/pt-br/Img/perms_view_icon.png)**Exibir** permite que um usuário veja a pasta de trabalho ou exibição. Se um usuário não tiver recebido o recurso Exibir, a pasta de trabalho não estará visível para ele.

![Ícone Filtrar.](/tableau/current/pt-br/server/pt-br/Img/perms_filter_icon.png)**Filtrar** permite que um usuário interaja com filtros na exibição, incluindo manter apenas e excluir filtros. Os usuários que não possuem esse recurso não verão os controles de filtro na exibição.

![Ícone Exibir comentários.](/tableau/current/pt-br/server/pt-br/Img/perms_viewcomments_icon.png)**Exibir comentários** permite que um usuário visualize os comentários associados às exibições em uma pasta de trabalho.

![Ícone Adicionar comentários.](/tableau/current/pt-br/server/pt-br/Img/perms_addcomments_icon.png)**Adicionar comentários** permite que um usuário inclua comentários nas exibições em uma pasta de trabalho.

![Ícone Baixar dados completos.](/tableau/current/pt-br/server/pt-br/Img/perms_downloadimage_icon.png)**Baixar Imagem/PDF** permite que o usuário baixe cada exibição como PNG, PDF ou PowerPoint.

![Ícone Baixar dados de soma.](/tableau/current/pt-br/server/pt-br/Img/perms_downloadsumdata_icon.png)**Baixar dados de resumo** permite que um usuário visualize os dados agregados em uma exibição ou nas marcas selecionadas e baixe esses dados (como um CSV).

#### Explorar modelo

![Ícone Compartilhar personalizado.](/tableau/current/pt-br/server/pt-br/Img/perms_sharecustomized_icon.png)**Compartilhar personalizado** permite que os usuários adicionem as exibições personalizadas à lista de “Outras exibições” visível em uma pasta de trabalho.

- Quando esse recurso é negado, os usuários não verão a opção “Tornar visível para os outros” ao criar uma exibição personalizada. Para obter mais informações, consulte [Usar exibições personalizadas](https://help.tableau.com/current/pro/desktop/pt-br/customview.htm). Esse recurso não afeta a capacidade de compartilhar uma visualização personalizada com a caixa de diálogo de compartilhamento ou ao copiar o link.

![Ícone Baixar dados completos.](/tableau/current/pt-br/server/pt-br/Img/perms_downloadfulldata_icon.png)**Baixar dados completos** permite que um usuário visualize os dados subjacentes em uma exibição ou nas marcas selecionadas e baixe esses dados (como um CSV).

- Baixar dados completos não é a mesma coisa que Consultar dados completos, que é usada por APIs em nome do usuário.

![Ícone Edição na Web.](/tableau/current/pt-br/server/pt-br/Img/perms_webedit_icon.png)**Edição na Web** permite que um usuário edite a exibição em um ambiente de criação baseado em navegador.

- Criar novo conteúdo no navegador ou salvar exibições na interface de edição na Web requer uma combinação específica de recursos. Para obter mais informações, consulte [Edição na Web e criação na Web](https://help.tableau.com/current/server/pt-br/permissions.htm#webauthor).
- O recurso Edição na Web também deve estar habilitado para todo o site ou até mesmo os usuários com esse recurso permitido não poderão editar na Web. Para obter mais informações, consulte [Definir o acesso à criação na Web de um site](https://help.tableau.com/current/server/pt-br/web_author_enable.htm).

![](/tableau/current/pt-br/server/pt-br/Img/perms_explain_data_icon.png)**Executar Explique os dados** permite que um usuário execute Explique os dados nas marcas no modo de edição e visualização.

- Para que Explique os dados seja exibido como uma opção quando um usuário seleciona uma marca em uma pasta de trabalho, o recurso também deve ser habilitado como uma configuração do site. Para disponibilizar Explique os dados no modo de visualização, o recurso também deve ser permitido pelo autor em uma pasta de trabalho nas configurações de Explique os dados. Para obter mais informações, consulte [Controlar acesso ao Explique os dados](https://help.tableau.com/current/pro/desktop/pt-br/explain_data_control_access.htm).

![Consultar dados completos](/tableau/current/pt-br/server/pt-br/Img/perms_full_data_query.png) **Consultar dados completos** permite que uma API ou agente acesse os dados subjacentes em uma fonte de dados da pasta de trabalho.

- Consultar dados completos (FDQ) não é o mesmo que Baixar dados completos. FDQ é um recurso de permissão de passagem que funciona em conjunto com o Acesso à API ou o Acesso à IA para permitir que uma API ou um agente consulte os dados da pasta de trabalho em nome do usuário.
- O FDQ garante que os filtros de usuário sejam aplicados apenas quando são filtros de fonte de dados, não filtros no nível da pasta de trabalho ou da planilha. A segurança em nível de linha com filtros de usuário deve ser definida como filtros de fonte de dados.
- A interação do VizQL com os dados da pasta de trabalho requer recursos de permissão de acesso ao FDQ e à API.
- Se o FDQ for permitido, o Tableau Agent em painéis terá acesso apenas a dados de resumo e, portanto, capacidade limitada de descobrir informações e análises mais detalhadas. O FDQ é necessário para a funcionalidade completa do Tableau Agent.

#### Publicar modelo

![Ícone Baixar pasta de trabalho e salvar como.](/tableau/current/pt-br/server/pt-br/Img/perms_downloadwkbksaveas_icon.png)**Baixar pasta de trabalho/Salvar como uma cópia** permite que um usuário baixe uma pasta de trabalho compactada (como um TWBX). Permite que um usuário salve (publique) uma cópia da interface de edição na Web como uma nova pasta de trabalho.

![Ícone Salvar.](/tableau/current/pt-br/server/pt-br/Img/perms_save_icon.png)**Substituir** permite que um usuário substitua o conteúdo ou ativo no servidor.

- Quando permitido, o usuário pode publicar novamente uma pasta de trabalho, uma fonte de dados ou um fluxo, ou salvar uma pasta de trabalho ou fluxo na criação na Web, tornando-se assim o proprietário e adquirindo acesso a todas as permissões. Após essa alteração na propriedade, o acesso do proprietário original à pasta de trabalho é determinado por suas permissões como qualquer outro usuário.

![Ícone do acesso à API.](/tableau/current/pt-br/server/pt-br/Img/perms_api_access_icon.png)**Acesso à API** permite que um usuário consulte a fonte de dados da pasta de trabalho com o VizQL Data Service. Para obter mais informações, consulte [Serviço de Dados do VizQL](https://help.tableau.com/current/api/vizql-data-service/pt-br/index.html).

![](/tableau/current/pt-br/server/pt-br/Img/perms_ai_access.png)**Acesso à IA** permite que um usuário utilize o Tableau Agent em painéis, incluindo Visão geral do painel, Dashboard Insights e Perguntas e respostas sobre painéis.

- Conceda também a permissão Consultar dados completos para que a ferramenta de IA possa acessar mais do que apenas os dados resumidos nas visualizações.

![](/tableau/current/pt-br/server/pt-br/Img/perms_metrics_icon.png)**Criar/atualizar métricas** permite que um usuário crie métricas nas exibições em uma pasta de trabalho e permite que qualquer métrica que um usuário crie com essas exibições seja atualizada. O recurso Métricas herdado foi descontinuado em fevereiro de 2024 para o Tableau Cloud e na versão 2024.2 do Tableau Server. Para obter mais informações, consulte [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm).

#### Modelo de administração

![Ícone Mover.](/tableau/current/pt-br/server/pt-br/Img/perms_move_icon.png)**Mover** permite que um usuário mova as pastas de trabalho entre projetos. Para obter mais informações, consulte [Mover conteúdo](https://help.tableau.com/current/server/pt-br/permissions.htm#MoveContent).

![Ícone Excluir.](/tableau/current/pt-br/server/pt-br/Img/perms_delete_icon.png)**Excluir** permite que um usuário exclua a pasta de trabalho.

![Ícone Definir permissões.](/tableau/current/pt-br/server/pt-br/Img/perms_setperms_icon.png)**Definir permissões** permite que um usuário crie regras de permissão para a pasta de trabalho.

![Ícone do recurso de permissão de atualização de extração](/tableau/current/pt-br/server/pt-br/Img/perms_extract_refresh.jpg)**Atualizar extrações** permite que um usuário acione uma atualização de extração para essa pasta de trabalho.

### Exibições

Em uma pasta de trabalho que não está em um projeto bloqueado e não mostra planilhas como guias de navegação, as exibições (planilhas, painéis, histórias) herdam as permissões da pasta de trabalho na publicação, mas quaisquer alterações nas regras de permissão devem ser feitas em exibições individuais. Os recursos de exibição são iguais para as pastas de trabalho, exceto **Substituir**, **Baixar pasta de trabalho/Salvar como uma cópia** e **Mover**, que estão disponíveis apenas no nível de pasta de trabalho.

Recomendamos mostrar as guias de planilha de navegação sempre que possível, para que as exibições herdem suas permissões da pasta de trabalho.

### Fontes de dados

#### Exibir o modelo

![Ícone Exibir.](/tableau/current/pt-br/server/pt-br/Img/perms_view_icon.png)**Exibir** permite que um usuário veja a fonte de dados no servidor.

![Ícone Conectar.](/tableau/current/pt-br/server/pt-br/Img/perms_connect_icon.png)**Conectar** permite que um usuário se conecte a uma fonte de dados no Tableau Desktop, no Tableau Prep Builder, no Pergunte aos dados ou na edição na Web.

- Se um autor de pasta de trabalho inserir suas credenciais em uma fonte de dados publicada de uma pasta de trabalho publicada, ele estará basicamente inserindo seu recurso **Conectar**. Portanto, os usuários podem ver os dados na pasta de trabalho, independentemente de seu próprio recurso **Conectar** para essa fonte de dados. Se o autor da pasta de trabalho não inserir suas credenciais na fonte de dados publicada, o usuário precisará de seu próprio recurso **Conectar** da fonte de dados para consumir a pasta de trabalho. Para obter mais informações, consulte [Acesso aos dados para fontes de dados publicadas do Tableau](https://help.tableau.com/current/server/pt-br/permissions.htm#PublishedData).
- Um usuário deve ter o recurso **Conectar** de uma fonte de dados para usar o dados e criar ampliações de Pergunte aos dados. Para obter mais informações, consulte [Ativar o Pergunte aos dados para sites e fontes de dados.](https://help.tableau.com/current/pro/desktop/pt-br/ask_data_enable.htm#ensure-that-users-can-access-a-data-source).

#### Explorar modelo

![Ícone Baixar fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/perms_downloaddatasource_icon.png)**Baixar fonte de dados** permite que o usuário baixe a fonte de dados no servidor (como um TDSX).

- As fontes de dados multidimensionais, como as de conexões com Microsoft Analysis Services ou Oracle Essbase, devem ser usadas localmente. Para baixar a fonte de dados publicada no Tableau Desktop, o usuário deve ter o recurso Baixar. Para obter mais informações, consulte [Fontes de dados de cubo](https://help.tableau.com/current/server/pt-br/datasource_cube.htm).

#### Publicar modelo

![Ícone Salvar.](/tableau/current/pt-br/server/pt-br/Img/perms_save_icon.png)**Substituir** permite que um usuário publique a fonte de dados no servidor e substitua-a no servidor.

![](/tableau/current/pt-br/server/pt-br/Img/perms_api_access_icon.png)**Acesso API** permite que um usuário consulte a fonte de dados com o Serviço de Dados do VizQL. Para obter mais informações, consulte [Serviço de Dados do VizQL](https://help.tableau.com/current/api/vizql-data-service/pt-br/index.html).

![Ícone de Criar definições de métricas](/tableau/current/pt-br/server/pt-br/Img/perms_pulse_metric_icon.png) **Criar definições de métricas** permite que um usuário se conecte a uma fonte de dados para criar definições de métricas do Tableau Pulse. Para obter mais informações, consulte [Criar Métricas com o Tableau Pulse](https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm).

#### Modelo de administração

![Ícone Excluir.](/tableau/current/pt-br/server/pt-br/Img/perms_delete_icon.png)**Excluir** permite que um usuário exclua a fonte de dados.

![Ícone Definir permissões.](/tableau/current/pt-br/server/pt-br/Img/perms_setperms_icon.png)**Definir permissões** possibilita que um usuário crie e edite regras de permissão para a fonte de dados.

![Ícone do recurso de permissão de atualização de extração](/tableau/current/pt-br/server/pt-br/Img/perms_extract_refresh.jpg)**Atualizar extrações** permite que um usuário acione uma atualização de extração para a fonte de dados.

### Outros tipos de ativos

<table class="table--plain" style="width: 100%;"><colgroup><col><col style="width: 22%;"><col style="width: 22%;"><col style="width: 22%;"><col style="width: 22%;"></colgroup><tbody><tr><td>&nbsp;</td><td>Exibir o modelo</td><td>Explorar modelo</td><td>Publicar modelo</td><td>Modelo de administração</td></tr><tr><td>Fluxos</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário visualize o fluxo.</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_downloaddatasource_icon.png" alt="Ícone Baixar fonte de dados."><b>Baixar fluxo</b> permite que um usuário baixe o fluxo (como um TFLX).</td><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_connect_icon.png" alt="Ícone Conectar."><b>Executar</b> permite que um usuário execute o fluxo.</p><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."><b>Substituir</b> permite que um usuário publique um fluxo e substitua o fluxo publicado.</p></td><td rowspan="7"><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_move_icon.png" alt="Ícone Mover."><b>Mover</b> permite que um usuário mova os ativos entre projetos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/permissions.htm#MoveContent" class="xref">Mover conteúdo</a>.</p><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_delete_icon.png" alt="Ícone Excluir."><b>Excluir</b> permite que um usuário exclua o ativo.</p><p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_setperms_icon.png" alt="Ícone Definir permissões."><b>Definir permissões</b> permite que um usuário crie regras de permissão para o ativo.</p><p>&nbsp;</p></td></tr><tr><td>Funções de dados</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário visualize as funções de dados.</td><td>n/a</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."><b>Substituir</b> permite que um usuário publique funções de dados, substitua funções de dados publicadas e edite os sinônimos de funções de dados publicadas.</td></tr><tr><td>Métricas (descontinuadas)</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário visualize as métricas.</td><td>n/a</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."><b>Substituir</b> permite que um usuário <span>substitua uma métrica e edite os detalhes de uma métrica. </span></td></tr><tr><td>Ampliações de Pergunte aos dados</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário veja a ampliação.</td><td>n/a</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."><b>Substituir</b> permite que um usuário edite as ampliações.</td></tr><tr><td>Conexões virtuais</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário veja a conexão virtual. <p><img src="https://help.tableau.com/current/server/pt-br/Img/perms_connect_icon.png" alt="Ícone Conectar."><b>Conectar</b>* permite que um usuário se conecte aos dados usando uma conexão virtual.</p></td><td>n/a</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."><b>Substituir</b> permite que um usuário edite a conexão virtual.</td></tr><tr><td>Bancos de dados</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário veja o banco de dados.</td><td>n/a</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."><b>Substituir</b> permite que um usuário edite os metadados do banco de dados.</td></tr><tr><td>Tabelas</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário veja a tabela.</td><td>n/a</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_save_icon.png" alt="Ícone Salvar."><b>Substituir</b> permite que um usuário edite os metadados da tabela.</td></tr><tr><td>Coleções</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/perms_view_icon.png" alt="Ícone Exibir."><b>Exibir</b> permite que um usuário visualize as coleções.</td><td>n/a</td><td>n/a</td><td>n/a</td></tr></tbody></table>

Por padrão, as conexões virtuais têm um modelo Personalizado que define o recurso Exibir como Permitido, mas não o recurso Conectar. Certifique-se de definir o recurso Conectar como Permitido para que os usuários possam se conectar usando a conexão virtual.

<!-- document id=39967eaf8c174f6718838c2c56cd0f0b111d960d7cd982b69b0050ce9fe9d245 url=/tableau/current/pt-br/server/atrdiag.md -->

[Pular para o conteúdo principal](#main-content)

# Referência da linha de comando ATRDiag.exe

Você pode usar o utilitário da linha de comando ATRDiag para gerenciar problemas de licenciamento relacionados ao gerenciamento de licenças baseadas em logon e aos recursos de ART (Autorização para execução).

## Sinopse

`ATRDiag -dumpATR -showAll -showVerbose -product ["Tableau Desktop"]["Tableau Prep"]["Tableau Server"]`

`-subProduct {subProduct} -version {version} -setVersion {version}`

`-log [Trace][Debug][Info][Warn][Error][Fatal][Off] -status -deleteAllATRs`

`-deleteInvalidATRs -deleteATR {atrIdToDelete}`

`-enableATRFeature -disableATRFeature -enableLBLMFeature -disableLBLMFeature`

`-requireLBLMFeature -setDuration {seconds`}

**Observação:** todas as opções de ATRDiag não diferenciam maiúsculas e minúsculas.

## Opções

`-dumpATR`

Exibe uma ATR (autorização para execução) válida no prompt de comando (se estiver presente). Usa `-version/-product/-subProduct/-version` para controlar qual ATR é despejada se mais de uma for válida.

`-showAll`

Enumera o conteúdo do registro para ver ATRs disponíveis (algumas das quais podem não ser válidas).

`-showVerbose`

Enumera o conteúdo do registro e usa `-version/-product/-subProduct/-version` para fornecer por produto.

`-product ["Tableau Desktop"]["Tableau Prep"]["Tableau Server"]`

O padrão é "Tableau Desktop". Deve especificar "Tableau Server" para exibir o Servidor ATR.

Por exemplo: `atrdiag -product "Tableau Server"`

![Janela de prompt de comando com detalhes de atributos.](/tableau/current/pt-br/server/pt-br/Img/atrdiag_product_tableau_server.png)

`-subProduct {subProduct}`

O padrão é "Profissional".

`-version {version}`

Sem padrão; um valor válido para este campo é "Tableau 2021.1".

`-setVersion {version}`

Persiste um valor padrão para -version.

`-log [Trace][Debug][Info][Warn][Error][Fatal][Off]`

Exibe informações de registro de ATR.

`-status`

Fornece status de recurso de ATR (ativado ou desativado), o servidor de licença e despeja a ATR.

`-deleteAllATRs`

Remove todas as ATRs presentes na máquina.

`-deleteInvalidATRs`

Remove todas as ATRs inválidas.

`-deleteATR {atrIdToDelete}`

Remove uma ATR por ID.

`-enableATRFeature`

Liga o recurso de ATR. Deve executar como administrador. Para uso em Tableau Desktop somente.

`-disableATRFeature`

Desliga o recurso de ATR. Deve executar como administrador. Para uso em Tableau Desktop somente.

`-enableLBLMFeature`

Liga gerenciamento de licenças baseadas em logon(LBLM). Deve executar como administrador.

`-disableLBLMFeature`

Desliga gerenciamento de licenças baseadas em logon (LBLM). Deve executar como administrador.

`-requireLBLMFeature`

Define o recurso gerenciamento de licenças baseadas em logon (LBLM) conforme necessário. Deve executar como administrador.

`-setDuration {seconds}`

Define `ATRRequestedDurationSeconds` para segundos. Deve executar como administrador.

## Opções globais

`-h, --help`

Opcional.

Exibir a ajuda do comando.

<!-- document id=0660eef704deadfdf055045a8da12053235809f400820c6d30dc4de4d5591d36 url=/tableau/current/pt-br/server/tsm.md -->

[Pular para o conteúdo principal](#main-content)

# Referência da linha de comando tsm

Os tópicos desta seção incluem o conteúdo de referência da interface de linha de comandos (CLI) do Tableau Services Manager (TSM) para suportar o Tableau Server .

O TSM é usado para gerenciar a instalação e a configuração do Tableau Server. Para saber mais sobre o TSM, consulte [Visão geral do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/tsm_overview.htm).

É possível automatizar as tarefas de instalação e configuração suportadas pelo TSM CLI usando a API do TSM. Para saber mais sobre a API do TSM de pré-versão (Alpha), consulte [API do Tableau Services Manager](https://help.tableau.com/v0.0/api/tsm_api/pt-br/index.htm).

## Uso da CLI do tsm

Você pode executar comandos tsm no nó inicial (o nó onde o TSM está instalado) ou em qualquer nó adicional no cluster.

Para executar comandos tsm, é necessário abrir um prompt de comando do Windows. Não use o PowerShell para executar comandos tsm. O uso do PowerShell pode causar um comportamento inesperado.

1. Abra o prompt de comando do Windows com uma conta que seja membro do grupo de Administradores em um nó no cluster.
2. Execute o comando desejado. Se você estiver executando o comando de um nó diferente do nó inicial, inclua a opção `-s` para especificar a URL do nó inicial por nome (não por endereço IP) e inclua a porta do TSM, 8850.
    
    Para ver a versão do TSM e do Tableau Server no nó inicial:
    
    `tsm version`
    
    Para ver a versão do TSM e do Tableau Server de um nó adicional:
    
    `tsm version -s https://<inital_node_name>:8850`
    
    Por exemplo:
    
    `tsm version -s https://myTableauHost:8850`

## Autenticação com a CLI tsm

A partir da versão 2019.2 do Tableau Server, a execução de comandos tsm não exigirá que você insira uma senha se a seguinte for verdadeiro:

- A conta com a qual você está executando comandos é membro do grupo autorizado pelo TSM, que é o grupo de administradores locais no computador Windows.
- Você está executando comandos localmente no Tableau Server que está executando o serviço do controlador de administração do Tableau Server. Por padrão, o serviço do controlador de administração do Tableau Server é instalado e configurado no nó inicial em uma implantação distribuída.

### Fazer logon na CLI tsm localmente

Se estiver executando comandos tsm no computador local com a conta de usuário que é membro de um grupo autorizado pelo TSM, você não precisará especificar uma senha. Neste caso, apenas execute o comando, por exemplo:

`tsm version`

### Fazer logon na CLI tsm remotamente

Se estiver executando comandos do TSM em um nó em um cluster em que o serviço do controlador de administração do Tableau Server não estiver em execução, você deverá autenticar uma sessão com o serviço do controlador de administração do Tableau Server no computador remoto antes de executar comandos. Por exemplo, execute o comando a seguir:

`tsm login -s <server_name> -u <account_name>`

Em que `<server_name>` é o nome do nó em que o serviço do controlador de administração do Tableau Server está sendo executado e `<account_name>` é uma conta membro de um grupo autorizado pelo TSM.

Após executar este comando, você será solicitado a fornecer uma senha. Depois que a conta for autenticada, você poderá executar os comandos do TSM.

Como prática recomendada de segurança, não exponha a porta TSM (por padrão, `8850`) para a internet.

## Script e automação com a CLI tsm

O TSM é um arquivo de lote. Para executar comandos TSM em outro arquivo de lote, use o comando `call`. Por exemplo, "`call tsm maintenance ziplogs`”. Executar essa ação retornará o controle para o arquivo de lote.

Para executar a automação em um Tableau Server sem uma senha no arquivo de script, execute o script no nó inicial e com uma conta no grupo autorizado pelo TSM. Consulte a seção "Autenticação" acima.

## Exibição do conteúdo de ajuda no shell

Para visualizar o conteúdo de ajuda mínimo de uma linha de comando, use a categoria `tsm help`.

### Sinopse

`tsm help [category] [command]`

### Comandos

`tsm help`

Ajuda de todos os comandos tsm

`tsm help <category>`

Mostra a ajuda de uma categoria de comandos específica. Por exemplo, `tsm help authentication`.

`tsm help <category> <command>`

Mostra a ajuda de um comando específico. Por exemplo, `tsm help authentication open-id`.

`tsm help commands`

Lista todos os comandos ou as categorias de nível superior.

## Categorias

## Outros artigos nesta seção

<!-- document id=7f665de8b52c35f857e6cc659245a8a876b44fb8a47197c6834b89bcad3dcb76 url=/tableau/current/pt-br/server/ldap_config.md -->

[Pular para o conteúdo principal](#main-content)

# Referência de configuração do armazenamento de identidades externo

O Tableau Server é compatível com a conexão a um diretório externo usando LDAP. Nesse cenário, o Tableau Server importa os usuários do diretório LDAP externo para o repositório do Tableau Server como usuários do sistema.

Este tópico fornece uma descrição de todas as opções de configuração relacionadas ao LDAP compatíveis com o Tableau Server. Se você estiver se conectando ao Active Directory, recomendamos fortemente que configure automaticamente a conexão LDAP com o Tableau Server como parte da instalação, em vez de configurar a conexão manualmente. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

As opções listadas nesta referência podem ser usadas para qualquer diretório compatível com LDAP. Se você não tiver experiência configurando LDAP, fale com o administrador do diretório ou com um especialista em LDAP.

Este é um tópico de referência. Para obter mais informações sobre como o Tableau Server armazena e gerencia os usuários, comece com [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm).

## Métodos de configuração

Os parâmetros de configuração que permitem que o Tableau Server se conecte ao diretório LDAP são armazenados em arquivos .yml. Esses arquivos são gerenciados e sincronizados por vários serviços no Tableau Server. A atualização dos arquivos .yml deve ser feita usando uma interface TSM (Tableau Services Manager).

Não tente atualizar arquivos .yml diretamente com um editor de texto. O TSM deve gerenciar todas as atualizações para uma operação adequada.

Os arquivos de configuração .yml são compostos por pares de chave-valor. Por exemplo, a chave `wgserver.domain.username` tem um nome de usuário como um valor. Esta chave define o nome de usuário que será usado para autenticação ao diretório LDAP durante a operação de vinculação.

Existem quatro métodos TSM diferentes que podem definir valores de chave yml. Os quatro métodos são descritos aqui, usando a chave `wgserver.domain.username` como exemplo para ilustrar os diferentes métodos:

- pares de valor de chave configKey — você pode atualizar uma chave de arquivo de configuração .yml atualizando a chave `wgserver.domain.username` executando [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm) ou incluindo a chave em um arquivo de configuração JSON sob uma entidade configKey. Consulte [Exemplo de arquivo de configuração](https://help.tableau.com/current/server/pt-br/config_file_example.htm).
    
    Os pares de valor de chave configKey em um arquivo de configuração JSON são os mesmos usados para `tsm configuration set`, mas são definidos de forma diferente. Este tópico refere-se a ambos os métodos como _configKey_.
    
    Ao contrário do uso de configEntities e comandos tsm nativos descritos abaixo, a entrada configKey não é validada. Ao definir uma opção com uma configKey, o valor inserido é copiado como uma cadeia de caracteres literal para os arquivos de configuração .yml subjacentes. Por exemplo, para uma chave onde `true` ou `false` são as entradas válidas, quando você configura a chave usando um par de valor de chave configKey, pode inserir um valor de sequência arbitrária e ele será salvo para a chave. Nesses casos, os valores inválidos, sem dúvida, levarão a erros de configuração do LDAP.
    
    Recomendamos o uso de configKeys apenas quando não houver opção para definir a configuração com as outras três opções listadas abaixo (configEntities, um comando tsm nativo ou a interface de usuário Web TSM). Ao usar o configKeys, verifique novamente seus valores e lembre-se de diferenciar maiúsculas de minúsculas.
- configEntities JSON — Você pode atualizar um arquivo de configuração .yml passando a opção `username` em um JSON _ConfigEntities_.
    
    Quando você configura um valor usando opções de configEntities em um arquivo JSON, os valores são validados antes de serem salvos. Os valores diferenciam letras maiúsculas de minúsculas. Para obter detalhes sobre como configurar um valor usando configEntities, consulte o exemplo [Entidade identityStore](https://help.tableau.com/current/server/pt-br/entity_identity_store.htm). O arquivo JSON é importado com o comando [tsm settings import](https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm#TSMSet). As opções disponíveis para configEntities são um subconjunto de todos os pares de chave-valor .yml.
    
    A validação significa que o comando de importação só terá sucesso se todos os valores do arquivo JSON forem tipos de dados válidos. Por exemplo, se você inserir `no` para um valor que só aceita `true` ou `false`, você receberá um erro e a configuração não será importada.
    
    Você pode importar os arquivos de configuração JSON apenas como parte da configuração inicial. Se precisar fazer alterações LDAP depois de importar o arquivo de configuração JSON e o Tableau Server inicializado, não tente importar novamente o arquivo JSON. Em vez disso, faça mudanças individuais de chaves com comandos nativos tsm, se disponíveis, ou com configKeys e `tsm configuration set`.
- Comandos tsm nativos — você pode atualizar um arquivo de configuração .yml passando a opção com `ldapuser` com o _comando tsm nativo_ `[tsm user-identity-store](https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm)`. Assim como em configEntities, os valores inseridos com o comando tsm nativo são validados antes de serem salvos.
    
    Nem todos os pares de valor-chave em um arquivo .yml podem ser definidos usando comandos tsm nativos.
- TSM GUI — Você pode definir valores de configuração durante a configuração, usando TSM GUI. Se você estiver se conectando ao Active Directory e configurar o armazenamento de identidades do Tableau durante a configuração, com a interface de usuário, então você será solicitado a fornecer uma conta com acesso de leitura do AD. A chave `wgserver.domain.username` é definida quando você digita credenciais.
    
    Esse cenário só funciona se você estiver se conectando ao Active Directory. O Tableau Server não é compatível com a configuração de LDAP arbitrária como parte do processo de configuração de interface gráfica de usuário.

Considere usar a [Ferramenta Configuração do repositório de identidades do Tableau](https://tagyoureit.github.io/tableau-identitystore-config-tool/) para gerar o arquivo de configuração LDAP json. A Ferramenta de configuração do repositório de identidades do Tableau também vai gerar uma lista de pares chave/valor que você pode definir ao executar o [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm). A ferramenta em si não é compatível com o Tableau. Contudo, usar um arquivo JSON criado pela ferramenta em vez de criar um arquivo manualmente não altera o status compatível do seu servidor.

## Configuração do Active Directory

Se estiver configurando o Tableau Server para usar o Active Directory, recomenda-se o uso da interface do usuário na Web do TSM durante a instalação. A interface do usuário na Web do TSM é otimizada para configurar o Tableau Server para Active Directory com a entrada mínima necessária. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

## Tabela de referência de configuração

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 15%;"><col style="width: 15%;"><col style="width: 20%;"><col style="width: 10%;"><col style="width: 161px;"></colgroup><tbody><tr><th><p>Opção configEntities</p><p>(As opções diferenciam maiúsculas de minúsculas)</p></th><th>Comandos do tsm nativos</th><th><p>configKey</p><p>(Usado com o comando de configuração tsm ou na seção configKeys de um arquivo JSON)</p></th><th>Cenário</th><th><p>Observações</p></th></tr><tr><td>type</td><td>N/A</td><td>wgserver.authenticate</td><td>AD, LDAP, Local</td><td>Onde deseja armazenar as informações da identidade do usuário. Valores: <code>local</code> ou <code>activedirectory</code>.<p>Caso deseje se conectar a qualquer servidor do LDAP, insira <code>activedirectory</code>.</p></td></tr><tr><td>sslPort</td><td>N/A</td><td>wgserver.domain.ssl_port</td><td>AD, LDAP</td><td>Use esta opção para especificar a porta segura do servidor LDAP. Recomendamos o LDAP seguro para associação simples. A porta do LDAPS normalmente é a 636.</td></tr><tr><td>port</td><td>N/A</td><td>wgserver.domain.port</td><td>AD, LDAP</td><td>Use esta opção para especificar a porta não segura do servidor LDAP. O plaintext normalmente é 389.</td></tr><tr><td>domain</td><td>domain</td><td>wgserver.domain.default</td><td>AD</td><td>Em ambientes do Active Directory, especifique o domínio em que o Tableau Server está instalado, por exemplo, "example.lan".<p>Para LDAP sem AD: a cadeia de caracteres desse valor é exibida na coluna "Domínio" das ferramentas de gerenciamento de usuários. Você pode inserir uma cadeia de caracteres arbitrária, mas a chave não pode ficar em branco.</p><p>Esta chave é redundante com wgserver.domain.fqdn. Os valores para ambas as chaves devem ser os mesmos.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td></tr><tr><td>username</td><td>ldapusername</td><td>wgserver.domain.username</td><td>AD, LDAP</td><td>O nome de usuário que deseja usar para se conectar ao serviço do diretório.<p>A conta especificada deve ter permissão para consultar o serviço do diretório.</p><p>Para o Active Directory, insira o nome de usuário, por exemplo, <code>jsmith</code>.</p><p>Para servidores LDAP, insira o nome diferenciado (DN) do usuário que deseja usar para se conectar. Por exemplo, <code>"cn=jsmith,dc=example,dc=lan"</code>.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td></tr><tr><td>password</td><td>ldappassword</td><td>wgserver.domain.password</td><td>AD, LDAP</td><td>A senha da conta de usuário que será usada para conectar-se ao servidor LDAP.<p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td></tr><tr><td>directoryServiceType</td><td>N/A</td><td>wgserver.domain.directoryservice.type</td><td>AD, LDAP</td><td>O tipo de serviço de diretório de LDAP ao qual você deseja se conectar. Valores: <code>activedirectory</code> ou <code>openldap</code>.</td></tr><tr><td>kerberosPrincipal</td><td>kerbprincipal</td><td>wgserver.domain.ldap.principal</td><td>AD, LDAP</td><td>O nome principal do servidor do Tableau Server na máquina do host. O keytab deve ter permissões para este principal.  Não utilize um keytab existente do sistema. Em vez disso, recomendamos que você registre um novo nome principal do servidor. Para ver os principais em um determinado keytab, execute o comando <code>klist -k</code>. Consulte <a href="https://help.tableau.com/current/server/pt-br/kerberos_keytab.htm" class="xref">Saiba mais sobre os requisitos do Keytab.</a>.<p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td></tr><tr><td>hostname</td><td>hostname</td><td>wgserver.domain.ldap.hostname</td><td>AD, LDAP</td><td>O nome de host do servidor LDAP. Você pode inserir um nome de host ou endereço IP para este valor. O host especificado aqui será usado para consultas de usuário/grupo no domínio primário. No caso em que as consultas de usuário/grupo estejam em outros domínios, o Tableau Server consultará o DNS para identificar o controlador de domínio apropriado.<p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td></tr><tr><td>membersRetrievalPageSize</td><td>N/A</td><td>wgserver.domain.ldap.members.retrieval.page.size</td><td>AD, LDAP</td><td><p>Esta opção determina o número máximo de resultados retornados por uma consulta LDAP.</p><p>Por exemplo, considere um cenário em que o Tableau Server está importando um grupo LDAP que contém 50.000 usuários. Tentar importar um número de usuários tão grande em uma única operação não é uma prática recomendada Quando essa opção estiver definida como 1500, o Tableau Server importará os primeiros 1500 usuários na primeira resposta. Depois que esses usuários forem processados, o Tableau Server solicitará os próximos 1500 usuários do servidor LDAP e assim por diante.</p><p>Recomendamos modificar essa opção apenas para acomodar os requisitos do servidor LDAP</p></td></tr><tr><td>N/A</td><td>N/A</td><td>wgserver.domain.ldap.connectionpool.enabled</td><td>AD, LDAP</td><td>Quando estas opções estiverem definidas como <code>true</code>, o Tableau Server tentará reutilizar a mesma conexão ao enviar consultas para o servidor LDAP. Esse comportamento diminui a sobrecarga de uma nova autenticação com o servidor LDAP em cada nova solicitação. Os conjuntos de conexões funcionam apenas com conexões de associação simples e TLS/SSL. Os conjuntos de conexões não são compatíveis em conexões de associação GSSAPI.</td></tr><tr><td>N/A</td><td>N/A</td><td>wgserver.domain.accept_list</td><td>AD</td><td>Viabiliza a conexão do Tableau Server com os domínios secundários do Active Directory. O Tableau Server é conectado a um domínio secundário para sincronização de usuários, porém o Tableau Server não está instalado nesse domínio. Para garantir que o Tableau Server possa se conectar a outros domínios do Active Directory, você deve especificar os domínios confiáveis definindo a opção <code>wgserver.domain.accept_list</code> com o TSM. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain-acceptlist" class="xref">wgserver.domain.accept_list</a>.</td></tr><tr><td>N/A</td><td>N/A</td><td><p>wgserver.domain.whitelist</p></td><td>AD</td><td><p><strong>Importante:</strong>obsoleto a partir da versão 2020.4.0. No lugar dele, use wgserver.domain.accept_list.</p><p>Viabiliza a conexão do Tableau Server com os domínios secundários do Active Directory. O Tableau Server é conectado a um domínio secundário para sincronização de usuários, porém o Tableau Server não está instalado nesse domínio. Para garantir que o Tableau Server possa se conectar a outros domínios do Active Directory, você deve especificar os domínios confiáveis definindo a opção <code>wgserver.domain.whitelist</code> com o TSM. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain" class="xref">wgserver.domain.whitelist</a>.</p></td></tr><tr><td>kerberosConfig</td><td><p>kerbconfig</p></td><td>Nenhum mapeamento direto</td><td>AD, LDAP</td><td><p>O caminho para o arquivo de configuração do Kerberos no computador local. Se você estiver instalando o Active Directory, não recomendamos usar o arquivo de configuração do Kerberos ou o arquivo keytab existente que já possa estar no PC unido pelo domínio. Consulte <a href="https://help.tableau.com/current/server/pt-br/plan_identity_store.htm" class="xref">Repositório de identidades</a>.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td></tr><tr><td>kerberosKeytab</td><td>kerbkeytab</td><td>Nenhum mapeamento direto</td><td>AD, LDAP</td><td><p>O caminho para o arquivo keytab do Kerberos no computador local. É recomendado criar um arquivo keytab com chaves especificas ao serviço do Tableau Server e que você não compartilhe o arquivo keytab com outros aplicativos do computador. </p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td></tr><tr><td>nickname</td><td>N/A</td><td>wgserver.domain.nickname</td><td>AD, LDAP</td><td><p>O apelido do domínio. Isso também é chamado de nome NetBIOS nos ambientes do Windows/Active Directory. A opção <code>nickname</code> é necessária para todas as entidades LDAP. O valor não pode ser nulo. Se sua organização não exigir um apelido /NetBIOS, envie uma chave em branco, por exemplo:&nbsp;<code>""</code>.</p></td></tr><tr><td>root</td><td>N/A</td><td>wgserver.domain.ldap.root</td><td>LDAP</td><td>Se você não usar um componente dc na raiz do LDAP ou se quiser especificar uma raiz mais complexa, será necessário definir a raiz do LDAP. Use o formato "o=my,u=root". Por exemplo, para o domínio, <code>example.lan</code>, a raiz seria <code>"o=example,u=lan"</code>.</td></tr><tr><td>serverSideSorting</td><td>N/A</td><td>wgserver.domain.ldap.server_side_sorting</td><td>LDAP</td><td>Se o servidor LDAP está configurado para classificação do lado do cliente dos resultados de consultas. Se o servidor LDAP&nbsp;for compatível com a classificação do lado do servidor, defina essa opção como <code>true</code>. Caso não tenha certeza de que seu servidor LDAP&nbsp;suporta essa classificação, insira <code>false</code>, pois uma configuração incorreta pode causar erros.</td></tr><tr><td>rangeRetrieval</td><td>N/A</td><td>wgserver.domain.ldap.range_retrieval</td><td>LDAP</td><td>Se o servidor LDAP está configurado para retornar um intervalo de resultados de consulta de uma solicitação. Isso significa que os grupos com muitos usuários serão solicitados em conjuntos pequenos, em vez de todos de uma vez. Os servidores LDAP que suportam uma recuperação abrangente terão melhor desempenho para consultas grandes. Se o servidor LDAP&nbsp;for compatível com a recuperação de intervalo, defina essa opção como <code>true</code>. Caso não tenha certeza de que seu servidor LDAP&nbsp;suporta essa classificação, insira <code>false</code>, pois uma configuração incorreta pode causar erros.</td></tr><tr><td>bind</td><td>N/A</td><td>wgserver.domain.ldap.bind</td><td>LDAP</td><td>A forma como deseja proteger a comunicação com o serviço de diretório. Insira <code class="highlighter-rouge">simple</code> para o LDAP, a não ser que esteja se conectando a um servidor LDAP com o Kerberos. Para o Kerberos, insira <code class="highlighter-rouge">gssapi</code>.</td></tr><tr><td>N/A</td><td>N/A</td><td>wgserver.domain.ldap.domain_custom_ports</td><td>LDAP</td><td><p class="note"><strong>Observação</strong>: essa chave é compatível apenas para o Tableau Server no Linux.</p><p>Permite mapear domínios secundários e suas portas LDAP. O domínio e a porta são separados por dois-pontos (:) e cada domínio:par de portas é separado por uma vírgula (,) usando este formato: <code>FQDN1:port,FQDN2:port</code></p><p>Exemplo: <code>tsm configuration set -k wgserver.domain.ldap.domain_custom_ports -v childdomain1.lan:3269,childdomain2.lan:3269,childdomain3.lan:389</code></p></td></tr><tr><td>distinguishedNameAttribute</td><td>N/A</td><td>wgserver.domain.ldap.dnAttribute</td><td>LDAP</td><td><p>O atributo que armazena os nomes diferenciados de usuários. Este atributo é opcional, mas aprimora o desempenho das consultas do LDAP.</p><p class="note"><b>Importante</b>: não defina esta opção como parte da configuração inicial. Só defina isso depois de validar a funcionalidade total do LDAP. Você deve ter um dnAttribute definido em sua organização antes de definir esta chave.</p></td></tr><tr><td>groupBaseDn</td><td>N/A</td><td>wgserver.domain.ldap.group.baseDn</td><td>LDAP</td><td><p>Use essa opção para especificar uma raiz alternativa para os grupos. Por exemplo, se todo o seu grupo estiver armazenado na organização base chamada "grupos", insira <code>"o=groups"</code>.</p></td></tr><tr><td>N/A</td><td>classnames</td><td>wgserver.domain.ldap.group.classnames</td><td>LDAP</td><td><p>Por padrão, o Tableau Server procurará por "group", "groupOfNames" ou "groupOfURLs". Se os objetos do grupo LDAP não correspondem com o nome de classe padrão, substitua o padrão configurando este valor. É possível fornecer vários nomes de classe separados por vírgulas.</p><p>Se os nomes dos grupos incluírem vírgulas, evite-as usando uma barra invertida (\). Por exemplo, se você tiver um nome de grupo, <code>groupOfNames, top</code>, insira <code>"groupOfNames\, top"</code>.</p><p>A implementação do Tableau LDAP interpreta os objetos LDAP como usuário ou grupo.&nbsp;Portanto, certifique-se de que você esteja digitando o nome de classe mais específico. A sobreposição de nomes de classe entre usuários e grupos pode causar conflitos.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetGroupMap" class="xref">tsm user-identity-store set-group-mappings [options]</a>.</p></td></tr><tr><td>groupBaseFilter</td><td>basefilter</td><td>wgserver.domain.ldap.group.baseFilter</td><td>LDAP</td><td><p>O filtro que deseja usar para os grupos de usuários do Tableau Server. É possível especificar um atributo de classe do objeto e um atributo de unidade organizacional. Por exemplo:</p><p><code>"(&amp;(objectClass=groupofNames)(ou=Group))"</code></p><p>Se <code>"(&amp;(objectClass=inetOrgPerson)(ou=People))"</code>não funcionar na implementação do LDAP, especifique o filtro base que funciona para a sua base de usuários do Tableau.</p><p>Esta é uma chave obrigatória. Não pode ficar em branco.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetGroupMap" class="xref">tsm user-identity-store set-group-mappings [options]</a>.</p></td></tr><tr><td>groupName</td><td>groupname</td><td>wgserver.domain.ldap.group.name</td><td>LDAP</td><td><p>O atributo que corresponde aos nomes de grupo no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetGroupMap" class="xref">tsm user-identity-store set-group-mappings [options]</a>.</p></td></tr><tr><td>groupEmail</td><td>groupemail</td><td>wgserver.domain.ldap.group.email</td><td>LDAP</td><td><p>O atributo que corresponde aos endereços de e-mail do grupo no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetGroupMap" class="xref">tsm user-identity-store set-group-mappings [options]</a>.</p></td></tr><tr><td>groupDescription</td><td>description</td><td>wgserver.domain.ldap.group.description</td><td>LDAP</td><td><p>O atributo que corresponde às descrições de grupo no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetGroupMap" class="xref">tsm user-identity-store set-group-mappings [options]</a>.</p></td></tr><tr><td>member</td><td>member</td><td>wgserver.domain.ldap.group.member</td><td>LDAP</td><td><p>Especifique o atributo LDAP que contém uma lista de nomes distintos de usuários que fazem parte desse grupo.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetGroupMap" class="xref">tsm user-identity-store set-group-mappings [options]</a>.</p></td></tr><tr><td>N/A</td><td>N/A</td><td>wgserver.domain.ldap.group.memberURL</td><td>LDAP</td><td>Especifique o nome do atributo LDAP que armazena a consulta de LDAP para grupos dinâmicos.</td></tr><tr><td>userBaseDn</td><td>N/A</td><td>wgserver.domain.ldap.user.baseDn</td><td>LDAP</td><td>Use essa opção para especificar uma raiz alternativa para os usuários. Por exemplo, se todos os usuários estiverem armazenados na organização base chamada "usuários", insira <code>"o=users"</code>.</td></tr><tr><td>N/A</td><td>classnames</td><td>wgserver.domain.ldap.user.classnames</td><td>LDAP</td><td><p>Por padrão, o Tableau Server pesquisa por classes de objeto do usuário LDAP que contenham a cadeia de caracteres “user” e “inetOrgPerson”. Se os objetos do usuário LDAP não usarem estes nomes de classe padrão, substitua o padrão configurando este valor. É possível fornecer vários nomes de classe separados por vírgulas. Por exemplo:&nbsp;<code>"userclass1, userclass2"</code>.</p><p>Se os nomes incluírem vírgulas, evite-as usando uma barra invertida (\). Por exemplo, se você tiver um nome, <code>Names, top</code>, insira <code>"Names\, top"</code>.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>userBaseFilter</td><td>basefilter</td><td>wgserver.domain.ldap.user.baseFilter</td><td>LDAP</td><td><p>O filtro que deseja usar para os usuários do Tableau Server. É possível especificar um atributo de classe do objeto e um atributo de unidade organizacional.</p><p>Por exemplo:</p><p><code>"(&amp;(objectClass=inetOrgPerson)(ou=People))"</code></p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>userUsername</td><td>ldapusername</td><td>wgserver.domain.ldap.user.username</td><td>LDAP</td><td><p>O atributo que corresponde aos nomes de usuário no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>userDisplayName</td><td>displayname</td><td>wgserver.domain.ldap.user.displayname</td><td>LDAP</td><td><p>O atributo que corresponde aos nomes de exibição do usuário no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>userEmail</td><td>email</td><td>wgserver.domain.ldap.user.email</td><td>LDAP</td><td><p>O atributo que corresponde aos endereços de e-mail do usuário no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>userCertificate</td><td>certificado</td><td>wgserver.domain.ldap.user.usercertificate</td><td>LDAP</td><td><p>O atributo que corresponde aos certificados de usuário no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>N/A</td><td>miniatura</td><td>wgserver.domain.ldap.user.thumbnail</td><td>LDAP</td><td><p>O atributo que corresponde às imagens em miniatura do usuário no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>userJpegPhoto</td><td>jpegphoto</td><td>wgserver.domain.ldap.user.jpegphoto</td><td>LDAP</td><td><p>O atributo que corresponde às imagens de perfil do usuário no servidor LDAP.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>memberOf</td><td>memberof</td><td>wgserver.domain.ldap.user.memberof</td><td>LDAP</td><td><p>Grupo do qual o usuário é um membro.</p><p>Comando tsm nativo: usa o comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetUserMap" class="xref">tsm user-identity-store set-user-mappings [options]</a>.</p></td></tr><tr><td>groupClassNames</td><td>N/A</td><td>wgserver.domain.ldap.group.classnames</td><td>LDAP</td><td><p>Por padrão, o Tableau Server procurará por "group", "groupOfNames" ou "groupOfURLs". Se os objetos do grupo LDAP não correspondem com o nome de classe padrão, substitua o padrão configurando este valor.</p><p>Para configEntity: essa opção tem uma lista de cadeias de caracteres, o que requer passar cada classe entre aspas, separados por uma vírgula (sem espaço) e entre colchetes. Por exemplo: <code>["basegroup","othergroup"]</code>.</p><p>Para configKey: digite cada classe, separada por vírgula (sem espaço) e entre aspas duplas. Por exemplo: <code>"basegroup,othergroup”</code>.</p></td></tr><tr><td>userClassNames</td><td>N/A</td><td>wgserver.domain.ldap.user.classnames</td><td>LDAP</td><td><p>Por padrão, o Tableau Server pesquisa por classes de objeto do usuário LDAP que contenham a cadeia de caracteres “user” e “inetOrgPerson”. Se os objetos do usuário LDAP não usarem estes nomes de classe padrão, substitua o padrão configurando este valor.</p><p>Para configEntity: essa opção tem uma lista de cadeias de caracteres, o que requer passar cada classe entre aspas, separados por uma vírgula (sem espaço) e entre colchetes. Por exemplo: <code>["userclass1",userclass2”]</code>.</p><p>Para configKey: digite cada classe, separada por vírgula (sem espaço) e entre aspas duplas. Por exemplo: <code>"userclass1,userclass2”</code>.</p></td></tr></tbody></table>

### configKeys calculadas

As seguintes configKeys relacionadas ao Kerberos são calculadas e definidas de acordo com várias entradas do ambiente. Por exemplo, elas devem ser definidas pelo comando tsm nativo ou configEntities. Não tente configurar essas configKeys manualmente.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col style="width: 33%;"></colgroup><tbody><tr><th>configKey calculadas</th><th>Para usar o comando TSM nativo:</th><th>Para usar configEntity json:</th></tr><tr><td><p>wgserver.domain.ldap.kerberos.conf,</p><p>cfs.ldap.kerberos.conf</p></td><td><p>Defina o local do arquivo de configuração Kerberos com a opção <code>kerbconfig</code> do comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</p></td><td style="color: #000000;">Defina o local do arquivo de configuração do Kerberos com a opção configEntity <code>kerberosConfig</code>.</td></tr><tr><td><p>wgserver.domain.ldap.kerberos.keytab,</p><p>cfs.ldap.kerberos.keytab</p></td><td>Defina o local do arquivo keytab do Kerberos com a opção <code>kerbkeytab</code> do comando <a href="https://help.tableau.com/current/server/pt-br/cli_user-identity_tsm.htm#TSMSetConnection" class="xref">tsm user-identity-store set-connection [options]</a>.</td><td style="color: #000000;">Defina o local do arquivo keytab do Kerberos com a opção configEntity <code>kerberosKeytab</code>.</td></tr></tbody></table>

### configKeys incompatíveis

Algumas configKeys incompatíveis estão presentes nos arquivos de configuração .yml subjacentes. As chaves a seguir não são destinadas a implantações padrão. Não configure estas chaves:

- wgserver.domain.ldap.kerberos.login
- wgserver.domain.ldap.guid
- wgserver.domain.fqdn: esta chave é redundante com wgserver.domain.default. Os valores para ambas as chaves devem ser os mesmos. Apenas atualize wgserver.domain.fqdn se o valor não corresponder a wgserver.domain.default.

<!-- document id=6fabbc0972a59d6c8d6a89344c2eb728ec5e67bb41e55dbb3b41c15abdf929bd url=/tableau/current/pt-br/server/sites_add.md -->

[Pular para o conteúdo principal](#main-content)

# Referência de configurações do site

Personalize um site para sua organização usando as configurações abaixo. Para exibir e editar as configurações do site, você deve ser Administrador do site no Tableau Cloud ou Administrador do servidor no Tableau Server.

As configurações do site são exibidas de forma diferente no Tableau Cloud e no Tableau Server. As configurações disponíveis para você dependem da configuração do seu site e se você usa o Tableau Cloud ou o Tableau Server. Para encontrar uma configuração específica abaixo, pressione Ctrl+F (Windows) ou Command+F (macOS).

## Acesso às configurações do site

- (Tableau Cloud) Na página inicial, expanda o painel lateral e clique em Configurações na parte inferior.
    
    ![Menu de navegação do Tableau Cloud com a opção Configurações.](/tableau/current/pt-br/server/pt-br/Img/site_settings_sidebar.png)
- (Tableau Server) Se estiver editando um site existente, selecione-o na página de Sites e, em seguida, selecione **Editar configurações**. Ou, em uma implantação de site único, clique em Configurações e na parte inferior do painel lateral.
    
    ![Editar configurações em um site do Tableau.](/tableau/current/pt-br/server/pt-br/Img/sites_ms_edit.png)

## Guia Geral

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td>Nome do site e ID (somente Administradores do Tableau Server)</td><td>Especifica o nome do site visto na interface do usuário e a ID vista na URL do site. (Se você estiver editando o site Padrão, não poderá alterar a ID.)<p>Você não pode alterar a parte "#/site" da URL (por exemplo, http://localhost/#/site/sales). Em ambientes de servidor de vários sites, estes segmentos aparecem na URL de sites diferentes do site Padrão.</p></td></tr><tr><td>Armazenamento (somente Administradores do Tableau Server)</td><td>Selecione <span class="uicontrol">Limite do servidor</span> ou <span class="uicontrol">GB</span> e, para a segunda opção, insira o número de gigabytes que deseja como limite para o espaço de armazenamento para pastas de trabalho, extrações e outras fontes de dados publicadas.<p>Se você definir um limite de servidor e o site excedê-lo, os publicadores serão impedidos de carregar conteúdo novo até que o site esteja dentro do limite novamente. Os administradores de servidor podem rastrear em que ponto o site se encontra em relação ao seu limite usando as colunas Armazenamento máximo e Armazenamento usado na página Sites.</p></td></tr><tr><td>Histórico de revisão (somente Administradores do Tableau Server)</td><td>Especifica o número de versões anteriores de pastas de trabalho, fluxos e fontes de dados armazenadas no servidor.</td></tr><tr><td>Tableau Prep Conductor</td><td>Controla se os usuários com permissões apropriadas podem agendar e monitorar fluxos. O Tableau Prep Conductor faz parte do <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm" target="_blank">Tableau Prep Conductor</a>.</td></tr><tr><td>Criação na Web</td><td>Controla se a criação baseada em navegador está habilitada para o site. Quando a criação na Web para pastas de trabalho é desativada, os usuários não podem criar ou editar pastas de trabalho publicadas no ambiente da Web do servidor, no entanto, devem usar o <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> para republicar a pasta de trabalho. Quando a criação na Web para fluxos é desativada, os usuários não podem criar ou editar fluxos publicados do ambiente da Web do servidor, mas devem usar o <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span> para republicar o fluxo.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/web_author_enable.htm" target="_blank">Definir acesso e funções de criação na Web de um site</a> na Ajuda do Tableau Cloud.</p></td></tr><tr><td><a name="ManageUsers"></a>Gerenciamento de usuários (somente Administradores do Tableau Server)</td><td>Determina se apenas os administradores de servidor podem adicionar e remover usuários e alterar as funções de site, ou se os administradores de site também podem fazer isso.<p>Se você permitir que os administradores de site gerenciem usuários, especifique quantos usuários eles podem adicionar ao site, selecionando uma destas opções:</p><ul><li>O Limite do servidor adiciona o número de licenças de assentos disponíveis do servidor. Para um servidor com licenciamento baseado em núcleo, não há limite.</li><li>O limite de site permite que os administradores de site adicionem usuários até um limite especificado por você.</li><li>O limite de função de site permite que um administrador de site adicione usuários de cada função de site até o limite de licença especificado para o site.</li></ul><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/view_licenses.htm" target="_blank">Exibir licenças do servidor</a>.</p></td></tr><tr><td>Acesso de visitante (somente Administradores do Tableau Server)</td><td>Permite que pessoas sem uma conta do Tableau Server vejam exibições com permissões de acesso ao visitante.<p class="note"><b>Observação:</b> se você usar o Tableau Server, o administrador poderá desativar o Acesso ao visitante.</p></td></tr><tr><td>Tableau Catalog</td><td>Desativa os recursos do Catalog quando o site do Tableau Server ou Tableau Cloud é licenciado com <span class="mc-variable Variables.DM_sku variable">Data Management</span>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm#disable-catalog" target="_blank">Desabilitar o Catalog</a>.</td></tr><tr><td>Desempenho da pasta de trabalho após uma atualização programada (somente Administradores do Tableau Server)</td><td>Pré-calcula pastas de trabalho visualizadas recentemente com atualizações programadas para abri-las mais rapidamente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_workbook_scheduled_refresh.htm" target="_blank">Configurar desempenho da pasta de trabalho após uma atualização agendada</a>.</td></tr><tr><td>Métricas de desempenho da pasta de trabalho (somente Administradores do Tableau Server)</td><td>Permite que os usuários do site coletem métricas sobre o desempenho das pastas de trabalho, como a rapidez com que carregam. Para iniciar o registro, os usuários devem adicionar um parâmetro à URL da pasta de trabalho. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_record_create_server.htm" target="_blank">Criar um registro de desempenho</a>.</td></tr><tr><td>Limpeza de chaves gerenciadas (somente administradores do Tableau Server)</td><td>Permite que os administradores do site gerenciem keychain de credenciais salvas para conexões OAuth no site. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/protected_auth.htm#removing-unused-keychain-records" target="_blank">Conexões OAuth</a>.</td></tr><tr><td>Suspender automaticamente tarefas de atualização da extração</td><td>Para economizar recursos, o Tableau pode suspender automaticamente as tarefas de atualização de extração para pastas de trabalho inativas. Esse recurso se aplica apenas a agendas de atualização executadas semanalmente ou com mais frequência. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/extract_auto_suspend.htm" target="_blank">Suspender automaticamente as atualizações de extração para pastas de trabalho inativas</a> na Ajuda do Tableau Cloud.</td></tr><tr><td><p>Tarefas vinculadas</p><p>(Tableau Server e administradores de site apenas)</p></td><td><p>Permite que os administradores do Server capacitem os usuários a agendarem tarefas de fluxo para serem executadas em sequência. Eles também podem permitir que os usuários acionem as tarefas de fluxo agendadas para execução usando <span class="uicontrol">Executar agora</span>.</p><p>Essa configuração pode ser aplicada no nível do servidor para incluir todos os sites no Tableau Server. A configuração pode ser desabilitada no nível do site para incluir apenas sites específicos.</p><p>Se a configuração for desabilitada depois que as tarefas vinculadas forem agendadas, todas as tarefas em execução serão concluídas, e as tarefas vinculadas agendadas serão ocultadas e não serão mais exibidas na guia <span class="uicontrol">Tarefas agendadas.</span></p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/prep_conductor_schedule_flow_task.htm#schedule-linked-tasks" target="_blank">Agendar tarefas vinculadas</a>.</p></td></tr><tr><td>Configurações de e-mail (somente Administradores do Tableau Server)</td><td>Especifica o endereço e o rodapé de mensagens vistos em e-mails automáticos para alertas e assinaturas.</td></tr><tr><td>Notificação de convites do site (somente Tableau Cloud)</td><td>Para sites com autenticação de login único, envia um e-mail de convite quando novos usuários são adicionados ao site.</td></tr><tr><td>Logotipo do site (somente Tableau Cloud)</td><td>Especifica a imagem que aparece com o nome do site.</td></tr><tr><td>Página inicial</td><td>Controla qual página do site aparece quando os usuários entram. Por padrão, a página inicial é exibida, mas você pode abrir Todos os projetos, Todas as pastas de trabalho ou outras páginas. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/maintenance_startpg.htm" target="_blank">Definir a página inicial padrão</a> na Ajuda do Tableau Cloud.<p class="note"><b>Observação:</b> se você usar o Tableau Server, o administrador poderá substituir a configuração deste site.</p></td></tr><tr><td>Tableau Pulse - Implantação (Tableau Cloud somente)</td><td>Controla se o Tableau Pulse está disponível para todos os usuários, para um grupo de usuários ou para nenhum usuário. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/pulse_set_up.htm#site-setting">Configurar o site para Tableau Pulse</a>.</td></tr><tr><td><a name="pulse-digest"></a>Tableau Pulse - Resumo - Permitir que os usuários recebam e-mails e resumos e alertas do Slack (somente Tableau Cloud)</td><td>Controla se os usuários podem receber resumos e alertas do Tableau Pulse por meio de diferentes canais. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/pulse_set_up.htm#digest-time">Configurar o site para Tableau Pulse</a>.</td></tr><tr><td>Tableau Pulse - Resumo - Horário de início do resumo (somente Tableau Cloud)</td><td>Determina o horário em que o Tableau Pulse começa a gerar resumos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/pulse_set_up.htm#digest-time">Configurar o site para Tableau Pulse</a>.</td></tr><tr><td>Tableau Pulse - Resumo - Agenda semanal e mensal (somente Tableau Cloud)</td><td>Determina o dia da semana e o dia do mês em que os resumos semanais e mensais são gerados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/pulse_set_up.htm#digest-time">Configurar o site para Tableau Pulse</a>.</td></tr><tr><td>IA no Tableau (Tableau Cloud)</td><td><p>Esta seção inclui várias configurações que controlam se a IA generativa está habilitada para recursos do Tableau.</p><p>Alguns recursos de IA generativa exigem o Tableau e uma conexão com uma organização do Salesforce com a IA generativa do Einstein configurada. Para obter mais informações sobre como ativar os recursos da IA no Tableau, consulte <a href="https://help.tableau.com/current/online/pt-br/setup_tabAI_site_setting.htm" target="_blank">Ativar a IA no Tableau para seu site</a>.</p><p>Para saber mais sobre a IA no Tableau, consulte <a href="https://help.tableau.com/current/tableau/pt-br/about_tableau_gai.htm" target="_blank">IA no Tableau</a>.</p></td></tr><tr><td>IA no Tableau (Tableau Server)</td><td><p>Esta seção inclui várias configurações que controlam se a IA generativa está habilitada para recursos do Tableau.</p><p>Esse recurso, disponível a partir da versão 2025.3, permite que você se conecte ao seu próprio provedor de modelo de linguagem grande (LLM) para ativar o Tableau Agent no Tableau Server para a criação na Web do Tableau e o Tableau Prep. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/sites_gai_server.htm" target="_blank">Ativar a IA no seu site do Tableau Server</a>.</p></td></tr><tr><td>Classificação de informações personalizadas (somente Tableau Cloud)</td><td><p>Controla se os usuários podem fornecer feedback positivo ou negativo sobre informações individuais. Quando essa configuração está ativada e os usuários fornecem feedback, esse feedback é usado pela plataforma de informações do Tableau Pulse para personalizar e classificar ainda mais os tipos de informações que ela mostra ao usuário.</p><p>Essa configuração é independente da configuração para implantar o Tableau Pulse. Quando a Classificação de informações personalizadas estiver desativada, os usuários não poderão enviar feedback positivo ou negativo sobre informações individuais. Para obter mais informações, consulte “Desativar classificaçã de informação personalizada” <a href="https://help.tableau.com/current/online/pt-br/pulse_set_up.htm" target="_blank">Configurar o site para Tableau Pulse</a>.</p></td></tr><tr><td>Visibilidade do usuário</td><td>Controla quais nomes de usuários e grupos são visíveis para outros usuários. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/user_visibility.htm" target="_blank">Gerenciar visibilidade do usuário</a> na ajuda do Tableau Cloud.</td></tr><tr><td>Disponibilidade de Pergunte aos dados</td><td>Controla se a ampliação de Pergunte aos dados está ativada ou desativada por padrão para fontes de dados. Pergunte aos dados permite que os usuários consultem dados usando linguagem coloquial e veja automaticamente visualizações. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/ask_data.htm" target="_blank">Criar exibições automaticamente com o Pergunte aos dados (Ask Data)</a> na Ajuda do usuário do Tableau.</td></tr><tr><td>Disponibilidade de Explique os dados</td><td>Controla se os usuários do site com as permissões apropriadas podem executar o Explique os dados e os autores podem acessar as configurações do Explique os dados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm" class="xref">Controle de acesso a Explique os dados</a>. Para saber mais sobre Explique os dados, consulte <a href="https://help.tableau.com/current/server/pt-br/explain_data.htm" class="xref">Descobrir insights mais rápido com Explique os dados</a> .</td></tr><tr><td>Acesso automático a metadados sobre bancos de dados e tabelas</td><td>Concede automaticamente aos usuários certos recursos para ativos externos usando permissões derivadas. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/dm_perms_assets.htm#derived_checkbox" target="_blank">Desativar permissões derivadas</a> na ajuda do Tableau Cloud.</td></tr><tr><td>Dados de linhagem confidenciais</td><td>Especifica se os dados de linhagem confidenciais devem ser ofuscados ou filtrados quando os usuários não tiverem as permissões apropriadas aos metadados relacionados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/dm_perms_assets.htm#lineage_checkbox" target="_blank">Dados de linhagem de confidenciais</a>.</td></tr><tr><td>Uniões cruzadas de banco de dados</td><td>Determina onde o processo de união acontece ao combinar dados de várias fontes. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/joining_tables.htm#integration" target="_blank">Combinar tabelas de diferentes bancos de dados</a> na Ajuda do usuário do Tableau.</td></tr><tr><td>Criptografia de extrações em repouso (somente Administradores do Tableau Server)</td><td>Permite criptografar extrações .hyper enquanto elas são armazenadas no Tableau Server. Os administradores do Server podem impor a criptografia de todas as extrações no site ou permitir que os usuários criptografem todas as extrações associadas a determinadas pastas de trabalho publicadas ou fontes de dados. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/security_ear.htm" target="_blank">Criptografia de extrações em repouso</a>.</td></tr><tr><td>Acesso ao suporte do Tableau (somente Tableau Cloud)</td><td>Permite que os técnicos de suporte do Tableau acessem o site para ajudar a solucionar casos de suporte. Por padrão, esse recurso fica desabilitado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/enable_support_access.htm" target="_blank">Habilitar o acesso ao suporte</a>.</td></tr><tr><td>Compartilhar</td><td>Permite que os usuários compartilhem itens diretamente com outros usuários. Quando um item é compartilhado, os destinatários recebem uma notificação e o item é adicionado à sua página Compartilhado comigo. Se isso não estiver ativado, os usuários só poderão copiar um link para compartilhar. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/shareworkbooks.htm" target="_blank">Compartilhar conteúdo da Web</a> na Ajuda do usuário do Tableau.</td></tr><tr><td>Comentários</td><td>Controla se os usuários podem adicionar observações em um painel lateral de Comentários para cada exibição e exibe um @mention a outros usuários do Tableau para notificá-los por e-mail. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/comment.htm" target="_blank">Comentários nas exibições</a> na Ajuda do usuário do Tableau.</td></tr><tr><td>Alertas orientados por dados</td><td>Permite que os usuários recebam e-mails automaticamente quando os dados atingem os limites-chave. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/data_alerts.htm" target="_blank">Enviar alertas direcionados por dados</a> na Ajuda do usuário do Tableau.</td></tr><tr><td>Assinaturas</td><td>Permite que os usuários do site assinem exibições e recebam e-mails regulares deles. No Tableau Server, essas opções só estarão visíveis se você tiver <a href="https://help.tableau.com/current/server/pt-br/subscribe.htm" target="_blank">definido as configurações da inscrições</a>.</td></tr><tr><td><p><a name="data-quality-warnings-in-subscriptions"></a>Rótulos de dados de alta visibilidade em assinaturas de exibição e de pasta de trabalho</p></td><td><p>Controla se as assinaturas incluem avisos relevantes de qualidade de dados de alta visibilidade e rótulos de confidencialidade no e-mail. No Tableau Server, essas opções só estarão disponíveis se você tiver <a href="https://help.tableau.com/current/server/pt-br/subscribe.htm" target="_blank">ativado e configurado as assinaturas</a>. Para obter mais informações sobre os avisos de qualidade de dados, consulte <a href="https://help.tableau.com/current/server/pt-br/dm_dqw.htm" class="xref">Definir um aviso de qualidade de dados</a>. Para obter mais informações sobre rótulos de confidencialidade, consulte <a href="https://help.tableau.com/current/server/pt-br/dm_labels_sensitivity.htm" class="xref">Rótulos de sensibilidade</a>.</p><p>Anteriormente denominado <span class="uicontrol">Avisos de qualidade de dados em assinaturas</span>.</p><p class="note"><strong>Observação: </strong> os avisos de qualidade de dados e rótulos de confidencialidade são um recurso do Tableau Catalog, que faz parte do <span class="mc-variable Variables.DM_sku variable">Data Management</span>.</p></td></tr><tr><td>Marcação</td><td>Especifica o número de marcas que os usuários podem adicionar aos itens. O limite padrão é 50 marcas e o máximo é 200. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/tags.htm" target="_blank">Usar marcas</a>.</td></tr><tr><td>Recomendações para exibições</td><td>Controla se as recomendações aparecem no site e se os nomes dos usuários que olharam os itens recomendados mostram nas dicas de ferramentas de recomendação.<p class="note"><strong>Observação:</strong> se você usar o Tableau Server, o administrador poderá desativar as Recomendações.</p></td></tr><tr><td>Solicitar acesso</td><td>Permite que os usuários enviem solicitações de acesso aos proprietários de conteúdo ou projetos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/Request_access.htm" target="_blank">Permitir que os usuários do site solicitem acesso ao conteúdo</a> na Ajuda do Tableau Cloud.</td></tr><tr><td>Tipo de conteúdo de métricas</td><td>Controla se as métricas estão disponíveis no site. Quando as métricas são ativadas, os usuários podem criar métricas com base em visualizações e elas aparecem como um tipo de conteúdo. Quando desativadas, as métricas não aparecerão no site nem continuarão a ser sincronizadas. Se você ativar as métricas novamente, as métricas preexistentes reaparecerão e retomarão a atualização. Para obter mais informações, consulte "Configurar para Métricas" na <a href="https://help.tableau.com/current/online/pt-br/metrics_admin.htm" target="_blank">Ajuda do Tableau Cloud</a> ou <a href="https://help.tableau.com/current/server/pt-br/metrics_admin.htm" target="_blank">Ajuda do Tableau Server</a>. <div class="note--warning"><p><strong>Descontinuação do recurso de métricas herdado</strong></p><p>O recurso de métricas herdado do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3. Com o Tableau Pulse, desenvolvemos uma experiência aprimorada para monitorar métricas e fazer perguntas sobre seus dados. Para obter mais informações, veja <a href="https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm">Criar métricas com o Tableau Pulse</a> para conhecer a nova experiência e <a href="https://help.tableau.com/current/online/pt-br/metrics_create.htm">Criar e solucionar problemas de métricas (descontinuado)</a> para o recurso descontinuado.</p></div></td></tr><tr><td>Objetos de página da Web e imagens da Web</td><td>Controla se esses objetos de imagem e página da Web podem exibir URLs de destino. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/dashboards_create.htm#Be_security-savvy" target="_blank">Segurança para objetos da página da Web</a> na Ajuda do usuário do Tableau.</td></tr><tr><td>Espaço pessoal</td><td>Permite que os usuários do site Creator e Explorer criem e salvem conteúdo em um Espaço pessoal privado. Quando o Espaço pessoal está ativado, você pode definir os limites de armazenamento do usuário. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/personal_space.htm" class="xref">Criar e editar conteúdo privado no espaço pessoal</a> .</td></tr><tr><td>Coleções</td><td>Controla se as coleções estão disponíveis no site. Quando você ativa as coleções, os usuários podem criar coleções para organizar o conteúdo e navegar pelas coleções disponibilizadas por outros usuários. Para obter mais informações, consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/collections.htm">Organizar itens em uma coleção</a>.</td></tr><tr><td>Fuso horário do site para extrações</td><td>O fuso horário padrão para as fontes de dados baseadas em extrações em um site é o Tempo Universal Coordenado (UTC). Os administradores de site podem definir um fuso horário diferente. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/tz_for_extracts.htm" target="_blank">Definir o fuso horário do site para extrações</a> na Ajuda do Tableau Server ou <a href="https://help.tableau.com/current/online/pt-br/tz_for_extracts.htm#tz" target="_blank">Definir o fuso horário do site para extrações</a> na Ajuda do Tableau Cloud.</td></tr><tr><td>Extrair notificações do limite de cotas</td><td>Envia alertas de e-mail para todos os administradores do site quando os trabalhos de atualização de extrações são cancelados devido a problemas de capacidade.</td></tr><tr><td><p>Parâmetros de fluxo</p><p>(Tableau Server e administradores de site apenas)</p></td><td><p>Permite que os usuários planejem e executem fluxos que incluem parâmetros.<br></p><p>Os administradores também podem ativar os parâmetros de fluxo para aceitar qualquer valor. Se esta opção for ativada, qualquer usuário de fluxo pode inserir qualquer valor em um parâmetro, potencialmente expondo dados aos quais o usuário não deve ter acesso.</p><p>Os parâmetros podem ser inseridos em uma etapa de entrada para nome de arquivo e caminho, nome de tabela ou ao usar consultas SQL personalizado, em uma etapa de saída para nome de arquivo e caminho e nome de tabela, e em qualquer tipo de etapa para filtros ou valores calculados.</p><p>As configurações de parâmetro de fluxo podem ser aplicadas no nível do servidor para incluir todos os sites no Tableau Server. As configurações podem ser desabilitadas no nível do site para incluir apenas sites específicos.</p><p>Para obter mais informações sobre como usar parâmetros, consulte <a href="https://help.tableau.com/current/prep/pt-br/prep_parameters.htm" target="_blank">Criar e usar parâmetros em fluxos</a> na ajuda do Tableau Prep.</p></td></tr><tr><td>Executar agora</td><td>Controles que podem executar trabalhos manualmente usando a opção Executar agora da Web, API Rest e Tabcmd. Por padrão, essa opção é selecionada para permitir que os usuários executem os trabalhos manualmente. Desmarque a caixa de seleção, apenas se os administradores são autorizados a executar trabalhos manualmente.<p class="note"><b>Observação:</b> se você usar o Tableau Server, o administrador poderá desabilitar a configuração deste site.</p></td></tr><tr><td>Gerenciar notificações</td><td>Controla como os usuários do site podem receber notificações para eventos como extrações de trabalhos, execuções de fluxo, quando outro usuário compartilha conteúdo com eles ou os menciona em um comentário. As notificações podem ser vistas em seu site do Tableau através do centro de notificação, enviadas por e-mail ou para a área de trabalho do Slack. Quando uma notificação é ativada, os usuários podem configurar as preferências de notificação na página Configurações de conta.<p class="note"><b>Observação:</b> se você usar o Tableau Server, o administrador de servidor poderá desabilitar a configuração deste site.</p></td></tr><tr><td>Personalizar notificações de e-mail (somente o Tableau Nuvem)</td><td><p>Controla se notificações por e-mail para alertas baseados em dados e assinaturas de pastas de trabalho e exibições são enviadas usando o servidor de e-mail do Tableau ou seu próprio servidor SMTP. Você pode conectar seu servidor de e-mail personalizado usando a autenticação básica padrão ou o OAuth 2.0 moderno para Microsoft 365. Ao usar seu próprio servidor SMTP, você pode personalizar o nome do remetente do e-mail, o endereço de e-mail e o domínio para links nos e-mails de notificação. Adicionado para o Tableau Cloud em fevereiro 2024. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/custom_smtp.htm">Usar um servidor SMTP personalizado para notificações por e-mail</a> na ajuda do Tableau Cloud.</p><p>Separadamente das configurações de SMTP, você pode controlar se as notificações por e-mail enviadas aos usuários para alertas e assinaturas baseadas em dados incluem links. Esses links direcionam os usuários ao site do Tableau para ver o conteúdo e gerenciar o alerta ou a assinatura. Um link para cancelar a assinatura é sempre incluído nos e-mails de notificação, independentemente de essa configuração estar ativada. Adicionado para o Tableau Cloud em junho de 2023.</p></td></tr><tr><td>Inscrições de fluxo</td><td>Controla se os proprietários de fluxo podem agendar e enviar e-mails com dados de saída de fluxo para si mesmos e para outras pessoas. Ao permitir assinaturas de fluxo, você pode controlar se os dados de saída de fluxo são incluídos no e-mail de assinatura e se os arquivos de saída de fluxo são anexados ao e-mail. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/prep_conductor_subscribe_to_flow.htm" class="xref">Notificar usuários sobre execuções de fluxo bem-sucedidas</a></td></tr><tr><td>Registro de clientes OAuth</td><td> Para um subconjunto de conectores, você pode registrar um cliente OAuth personalizado para o site e substituir um cliente OAuth que foi configurado para o servidor. Ao registrar um cliente OAuth personalizado, você habilita conexões novas e existentes para usar o cliente OAuth no nível do site, em vez do cliente OAuth em todo o servidor. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/protected_auth.htm#custom_oauth_server" target="_blank">Configurar OAuth personalizado</a>.</td></tr><tr><td>Aceleração da exibição</td><td>Controla se os usuários do site Creator e Explorer podem acelerar as exibições em suas pastas de trabalho do <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> para tempos de carregamento mais rápidos. Ao permitir a aceleração de exibição, você pode definir um número máximo de exibições a serem aceleradas e pode optar por suspender automaticamente a aceleração para exibições que falham repetidamente na tarefa de aceleração. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/data_acceleration.htm">Aceleração de exibição</a>.</td></tr><tr><td><a name="assertions"></a>Asserções para associações em grupo</td><td><p>Permite que a associação ao grupo local seja controlada e gerenciada pelo SSO do IdP ou por meio de um aplicativo conectado ao Tableau, afirmando dinamicamente a associação ao grupo quando um usuário se autentica no <span class="mc-variable Variables.ProductName variable">Tableau Server</span>. Requer configuração adicional na asserção SAML, na asserção OIDC ou no token web JSON (JWT).  Para mais informações, veja <a href="https://help.tableau.com/current/server/pt-br/groups_create_local.htm#assertions" class="xref">Associação dinâmica a grupos usando asserções</a>.</p><p><b>Importante</b>: essa configuração em nível de site só poderá ser habilitada quando a configuração em todo o servidor tiver sido habilitada primeiro.</p></td></tr><tr><td><a name="group_sets"></a>Conjuntos de grupos</td><td>Habilita a página<span class="uicontrol"> Conjuntos de grupos</span> e a capacidade de criar conjuntos de grupos. Conjuntos de grupos podem ser usados por determinados usuários (administradores de servidor,administradores de sites, proprietários de projetos e proprietários de conteúdo) para aplicar regras de permissão que exigem que os usuários sejam membros de todos os grupos no conjunto de grupos para acessar conteúdo cujas permissões dependem do conjunto de grupos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/group_sets.htm" class="xref">Trabalhar com conjuntos de grupos</a>.</td></tr><tr><td>Lixeira</td><td>Controla se a Lixeira está ativada para um site, permitindo que administradores e autores com licenças Explorer (pode publicar) ou Creator restaurem projetos, pastas de trabalho e fontes de dados excluídas anteriormente por um período de tempo selecionado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/recycle_bin.htm">Lixeira</a>.</td></tr><tr><td><a name="scim"></a>Sistema de gerenciamento de usuários entre domínios (SCIM) (Tableau Server)</td><td>Permite que os administradores do servidor habilitem o SCIM no nível de site para automatizar o provisionamento e a sincronização de usuários e grupos. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/scim_config_online.htm" target="_blank">SCIM</a>.</td></tr></tbody></table>

## Guia Autenticação (Tableau Cloud)

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td>Tipos de autenticação</td><td>Especifica como os usuário podem usar no site e como eles o acessam após o primeiro logon. A autenticação verifica a identidade de um usuário. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/security_auth.htm" target="_blank">Autenticação</a>.</td></tr><tr><td>Tipo de autenticação padrão para exibições inseridas</td><td>Especifica como os usuários podem fazer logon em visualizações incorporadas. Por padrão, a autenticação do Tableau é selecionada.</td></tr><tr><td><a name="user-attributes"></a>Controle o acesso do usuário em fluxos de trabalho de autenticação</td><td>Habilita as funções de atributo do usuário usadas no conteúdo para aceitar a passagem de atributos do usuário de um token da Web JSON (JWT) por aplicativos conectados, por declarações OIDC ou pela resposta&nbsp;SAML XML. Os atributos do usuário são passados para o Tableau para personalizar e controlar os dados que podem ser mostrados a um usuário em tempo de execução. Para obter mais informações, consulte a Ajuda de <a href="https://help.tableau.com/current/api/embedding_api/pt-br/docs/embedding_api_user_attributes.html" target="_blank">Embedding API v3</a>, <a href="https://help.tableau.com/current/online/pt-br/openid_auth_server_config.htm#user_attributes" target="_blank">OIDC</a> ou tópicos <a href="https://help.tableau.com/current/online/pt-br/saml_config_site.htm#user_attributes" target="_blank">SAML</a>.</td></tr><tr><td>Sistema de gerenciamento de identidades entre domínios (SCIM)</td><td>Permite gerenciar usuários no site através de um provedor de identidade de terceiros (IdP). Quando habilidato, preenche as caixas URL base e Segredo com os valores que serão usados na configuração SCIM do IdP. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/scim_config_online.htm" target="_blank">Automatizar o provisionamento de usuários e sincronização de grupos por meio de um provedor de identidade externo</a>.</td></tr><tr><td>Clientes conectados</td><td>Permite que clientes do Tableau, como Tableau Mobile, Tableau Bridge e outros, permaneçam autenticados no servidor, depois que um usuário fornece credenciais de logon pela primeira vez. Quando a opção estpa desativada, os usuários são obrigados a fazer login explicitamente cada vez que acessam o Tableau Cloud. Para obter informações, consulte <a href="https://help.tableau.com/current/online/pt-br/to_connected_clients.htm" target="_blank">Acessar sites de Clientes conectados</a>.</td></tr></tbody></table>

## Guia Bridge (Tableau Cloud)

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td>Cliente que não executa notificações</td><td>Envia alertas de e-mail para proprietários de fontes de dados, quando um cliente parece estar desconectado do site.</td></tr><tr><td>Pooling</td><td>Distribui consultas ao vivo e atualização de trabalhos em todos os clientes em pools do Bridge. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/to_enable_bridge_live_connections.htm" target="_blank">Configurar e gerenciar o pool do cliente do Bridge</a> na ajuda do Tableau Cloud.</td></tr><tr><td>Lista de permissões de rede privada</td><td><p>Adicione e gerencie domínios que permitem o acesso dedicado do pool de ponte aos dados da rede privada em nome do Tableau Cloud.</p></td></tr></tbody></table>

## Guia Extensões

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td>Extensões de painel e visualização</td><td>Gerenciar e controlar as extensões de painel e visualização. As extensões de painel são aplicativos da Web executados em áreas do painel personalizadas e podem interagir com o restante do painel. As extensões de visualização são aplicativos da Web compatíveis com novos tipos de visualização. Para obter mais informações, consulte "Gerenciar extensões de visualizações e painel" na <a href="https://help.tableau.com/current/online/pt-br/dashboard_extensions_server.htm" target="_blank">Ajuda do Tableau Cloud</a> ou <a href="https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm" target="_blank">Ajuda do Tableau Server</a>.</td></tr><tr><td>Extensões do Analytics</td><td>Ativa um conjunto de funções que os usuários podem usar para transmitir expressões a extensões do Analytics para integração com R e Python. Para obter mais informações, consulte "Configurar conexão com extensões do Analytics" na <a href="https://help.tableau.com/v0.0/online/pt-br/config_r_tabpy_tol.htm" target="_blank">Ajuda do Tableau Cloud</a> ou <a href="https://help.tableau.com/current/server/pt-br/config_r_tabpy.htm" target="_blank">Ajuda do Tableau Server</a>.</td></tr><tr><td>Extensão do Tableau Prep</td><td><p>Ao criar fluxos na Web, permite que os usuários apliquem modelos do Einstein Discovery a seus fluxos para fazer previsões de pontuação em massa para seus dados.</p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/config_einstein_extensions.htm#einstein-discovery-tableau-prep-extensions" target="_blank">Configurar integração do Einstein Discovery</a> na ajuda do Tableau Server.</p></td></tr></tbody></table>

## Guia Integrações

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col style="width: 196px;"><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td>Conectividade do Slack</td><td><p>Exibe conexões entre um espaço de trabalho do Slack e o site do Tableau. Quando conectados, os usuários do site do Tableau podem ver as notificações do Tableau na área de trabalho conectada do Slack.</p><p class="note"><b>Observação</b>: no Tableau Server, um administrador do Slack deve criar um aplicativo Slack privado e instalá-lo em um espaço de trabalho do Slack antes que o administrador do Tableau Server possa adicionar um cliente OAuth e se conectar ao Slack.</p><p>No Tableau Server, você pode adicionar informações do cliente OAuth para um aplicativo Slack privado e selecionar Conectar ao Slack para finalizar a conexão. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/slack_admin.htm" class="xref">Integrar o Tableau com a área de trabalho do Slack</a>.</p></td></tr><tr><td>Extensões do Analytics</td><td>Ativa um conjunto de funções que os usuários podem usar para transmitir expressões a extensões do Analytics para integração com R e Python. Para obter mais informações, consulte "Configurar conexão com extensões do Analytics" na <a href="https://help.tableau.com/v0.0/online/pt-br/config_r_tabpy_tol.htm" target="_blank">Ajuda do Tableau Cloud</a> ou <a href="https://help.tableau.com/current/server/pt-br/config_r_tabpy.htm" target="_blank">Ajuda do Tableau Server</a>.</td></tr><tr><td><p>Publicar no Salesforce</p><p>(Beta no <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> e <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>)</p></td><td>Permite que os usuários do site publiquem exibições em um aplicativo Salesforce.<p>Quando uma exibição é publicada no Salesforce, qualquer pessoa com acesso ao aplicativo selecionado pode ver que o conteúdo existe. No entanto, somente aqueles conectados com permissões existentes do Tableau podem ver a exibição. Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/publish_to_salesforce.htm">Publicar exibições no Salesforce (Beta)</a>.</p></td></tr></tbody></table>

## Guia Aplicativos conectados

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col style="width: 196px;"><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td>Aplicativos conectados</td><td><p>Criar e gerenciar aplicativos conectados do Tableau ou relações de confiança direta explícita ou OAuth 2.0 entre o Tableau Server (em todo o servidor e no nível do site) e aplicativos personalizados e autorizar programaticamente o acesso à API REST do Tableau em nome dos usuários usando tokens JSON da Web (JWTs). ). Para obter mais informações, consulte <a href="https://help.tableau.com/current/server-linux/pt-br/connected_apps.htm" target="_blank">Usar os aplicativos conectados do Tableau para integração de aplicativos</a> na ajuda do Tableau Cloud.<br></p></td></tr></tbody></table>

## Guia Móvel

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col style="width: 196px;"><col></colgroup><tbody><tr><td><b>Configuração</b></td><td><b>Descrição</b></td></tr><tr><td>Bloqueio do aplicativo</td><td>Requer um método biométrico ou senha do dispositivo para que os usuários abram o site no Tableau Mobile. Para obter mais informações, consulte <a href="https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_sso.htm#enable-app-lock-for-added-security" target="_blank">Habilitar bloqueio de aplicativos para adicionar segurança</a> no guia de implantação do Tableau Mobile.</td></tr><tr><td>Visualizações off-line</td><td>Controla se as visualizações offline são geradas para exibição, quando os usuários acessam o site no Tableau Mobile. Para obter mais informações, consulte <a href="https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_snapshots.htm" target="_blank">Dados móveis do Tableau Desktop nos dispositivos</a> no Guia de implantação do Tableau Mobile.</td></tr><tr><td><strong>Política de segurança do Mobile</strong></td><td>Algumas políticas de segurança são ativadas automaticamente e não podem ser desativadas. As políticas de segurança móveis não estão disponíveis para versões MAM do Tableau Mobile.</td></tr><tr><td>Detecção de jailbreak</td><td>Controla se um usuário do aplicativo Tableau Mobile com um dispositivo com "jailbroken" ou "root" tem permissão para acessar o conteúdo no Tableau e qual nível de resposta ocorre quando um dispositivo com jailbreak ou rooting é detectado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.</td></tr><tr><td>Detecção de malware (somente Android)</td><td>Controla se a detecção de malware está habilitada para dispositivos móveis e qual nível de resposta ocorre quando o malware é detectado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<blockquote><p>[!IMPORTANT]</p><p>Em setembro de 2025, o Tableau Mobile descontinuou o suporte para a configuração de detecção de malware. A configuração de detecção de malware foi removida da página de configurações do Tableau Cloud em setembro de 2025 e da página de configurações do Tableau Server no Tableau Server versão 2025.2.3. Qualquer configuração da definição de detecção de malware em versões anteriores do Tableau Server não tem efeito no aplicativo Tableau Mobile.</p></blockquote></td></tr><tr><td>Máximo de dias offline sem atualização da política</td><td>Controla se há um número máximo de dias que um dispositivo móvel pode ficar offline e ainda usar o aplicativo. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<br></td></tr><tr><td>Impedir a depuração</td><td>Controla se os depuradores são impedidos em dispositivos móveis. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<br></td></tr><tr><td>Compartilhamento de tela e capturas de tela (somente Android)</td><td>Controla se um usuário do Tableau Mobile pode fazer capturas de tela ou usar o compartilhamento de tela enquanto estiver no aplicativo. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/mobile_security_settings-admin.htm" class="xref">Configurações de segurança do aplicativo Tableau Mobile</a>.<br></td></tr></tbody></table>

<!-- document id=4b43f1f44c17e25fd0fffe6eaa0d9a64755ebb341efced66c4ba46ad51273763 url=/tableau/current/pt-br/server/server_admin_reference.md -->

[Pular para o conteúdo principal](#main-content)

# Referência do Administrador de servidor

Você pode saber mais sobre os processos, portas, contas e permissões do Tableau Server.

## Outros artigos nesta seção

<!-- document id=6ef85b53da446a0cc18bb8ad5555457e3d5a7d3cb389948b95ce6d072714d7bb url=/tableau/current/pt-br/server/server-helm-ref.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server Helm Chart - Referência

**Importante**: esta documentação pressupõe um conhecimento do Helm e de Helm Charts e não tenta fornecer exemplos prescritivos detalhados. Ele foi criado para clientes que estão familiarizados com o Tableau Server e com o Helm e Helm Charts.

## Introdução

Este tópico fornece informações de referência para implantação do Tableau Server no Kubernetes usando um Helm Chart.

### Matriz de propriedades de valores

A tabela abaixo lista todas as propriedades folha de `values.yaml`.

- **Valor**: caminho de chave pontilhado
- **Opcional**: se a propriedade pode ser omitida para a renderização do Chart
- **Valor(es) esperado(s)**: tipo válido ou valores permitidos
- Intervalo: intervalo numérico ou semântico, quando aplicável

| Valor | Padrão | Descrição | Opcional | Valor(s) esperado(s) | Range |
| --- | --- | --- | --- | --- | --- |
| deploymentMode | single | Seletor de padrão de implantação | true | `single` ou `multinode` | N/A |
| image.repository | "" | Repositório de imagens do Tableau | false | cadeia de caracteres de repositório da imagem do contêiner | cadeia de caracteres não vazia |
| image.tag | "" | Marca de imagem do Tableau | false | cadeia de caracteres de marca de imagem | cadeia de caracteres não vazia |
| image.pullPolicy | IfNotPresent | Política de extração de imagens | true | `Always,IfNotPresent,Never` | N/A |
| image.pullSecrets | \[\] | Referências de segredos de extração de imagem | true | matriz de cadeia de caracteres de nomes de segredos | N/A |
| serviceAccount.create | true | Criar ServiceAccount dedicada | true | booliano | N/A |
| serviceAccount.name | "" | Substituição do nome da ServiceAccount | true | cadeia de caracteres | Rótulo DNS |
| serviceAccount.annotations | {} | Anotações da ServiceAccount | true | map\[string\]string | N/A |
| securityContext.runAsUser | 999 | UID do contêiner | true | inteiro | \>=0 |
| securityContext.runAsGroup | 998 | GID do contêiner | true | inteiro | \>=0 |
| podSecurityContext.runAsUser | 999 | UID no nível do pod | true | inteiro | \>=0 |
| podSecurityContext.runAsGroup | 998 | GID no nível do pod | true | inteiro | \>=0 |
| podSecurityContext.fsGroup | 998 | Grupo FS de volume compartilhado | true | inteiro | \>=0 |
| podSecurityContext.fsGroupChangePolicy | OnRootMismatch | Política de propriedade de grupo FS | true | `OnRootMismatch` ou `Always` | N/A |
| primary.replicaCount | 1 | Réplicas de StatefulSet principais | true | inteiro | \>=1 |
| primary.hostname | primary | Dica de nome de host principal | true | cadeia de caracteres | não vazio |
| primary.resources.limits.cpu | "16" | Limite de CPU principal | true | Quantidade de CPUs do Kubernetes | \>0 |
| primary.resources.limits.memory | "64Gi" | Limite de memória principal | true | Quantidade de memória do Kubernetes | \>0 |
| primary.resources.requests.cpu | "8" | Solicitação de CPU principal | true | Quantidade de CPUs do Kubernetes | \>0 |
| primary.resources.requests.memory | "32Gi" | Solicitação de memória principal | true | Quantidade de memória do Kubernetes | \>0 |
| primary.nodeSelector | {} | Seletor de nó principal | true | map\[string\]string | N/A |
| primary.tolerations | \[\] | Tolerâncias principais | true | matriz de objetos de tolerância | N/A |
| primary.affinity | {} | Regras de afinidade principais | true | objeto de afinidade | N/A |
| worker.replicaCount | 1 | Réplicas de StatefulSet de trabalhador | true | inteiro | \>=0 |
| worker.hostname | worker | Dica de nome de host do trabalhador | true | cadeia de caracteres | não vazio |
| worker.resources.limits.cpu | "16" | Limite de CPU do trabalhador | true | Quantidade de CPUs do Kubernetes | \>0 |
| worker.resources.limits.memory | "64Gi" | Limite de memória do trabalhador | true | Quantidade de memória do Kubernetes | \>0 |
| worker.resources.requests.cpu | "8" | Solicitação de CPU do trabalhador | true | Quantidade de CPUs do Kubernetes | \>0 |
| worker.resources.requests.memory | "32Gi" | Solicitação de memória do trabalhor | true | Quantidade de memória do Kubernetes | \>0 |
| worker.nodeSelector | {} | Seletor de nó do trabalhador | true | map\[string\]string | N/A |
| worker.tolerations | \[\] | Tolerâncias do trabalhador | true | matriz de objetos de tolerância | N/A |
| worker.affinity | {} | Regras de afinidade do trabalhador | true | objeto de afinidade | N/A |
| worker.healthChecks.enabled | false | Habilitar investigações do trabalhador | true | booliano | N/A |
| env.ACCEPTEULA | "1" | Aceitar o EULA do Tableau | true | "`1`" ou "`0`" | N/A |
| env.LICENSE\_KEY | "" | Chave de licença via env | true | cadeia de caracteres | não vazio se usado |
| env.TABLEAU\_HOSTNAME | "" | Nome de host explícito do Tableau | true | cadeia de caracteres | Nome de DNS/FQDN |
| env.TSM\_ONLY | "0" | Executar o modo somente TSM | true | "`1`" ou "`0`" | N/A |
| env.TSM\_REMOTE\_UID | "" | UID remoto do TSM | true | cadeia de caracteres numéricos | \>=0 |
| env.TSM\_REMOTE\_USERNAME | "" | Nome de usuário remoto do TSM | true | cadeia de caracteres | N/A |
| env.TSM\_REMOTE\_PASSWORD | "" | Senha remota do TSM via env | true | cadeia de caracteres | não vazio se usado |
| env.TABLEAU\_USERNAME | "" | Nome de usuário do administrador do Tableau via env | true | cadeia de caracteres | não vazio se usado |
| env.TABLEAU\_PASSWORD | "" | Senha do administrador do Tableau via env | true | cadeia de caracteres | não vazio se usado |
| env.ALWAYS\_WRITE\_BOOTSTRAP\_FILE | "0" | Gravar o arquivo bootstrap do principal | true | "`1`" ou "`0`" | N/A |
| env.BOOTSTRAP\_INSTALL | "0" | Modo de instalação de bootstrap do trabalhador | true | "`1`" ou "`0`" | N/A |
| env.WAIT\_FOR\_BOOTSTRAP\_FILE | "0" | Modo de instalação de bootstrap do trabalhador | true | "`1`" ou "`0`" | N/A |
| env.HTTP\_PROXY | "" | Aguarde o arquivo de bootstrap | true | Cadeia de caracteres do URL | N/A |
| env.HTTPS\_PROXY | "" | URL do proxy HTTPS | true | Cadeia de caracteres do URL | N/A |
| env.NO\_PROXY | "" | URL do proxy HTTPS | true | hosts/CIDRs separados por vírgulas | N/A |
| env.PORT\_RANGE\_MIN | 8600 | Lista minNo-proxy do intervalo de portas dinâmico | true | cadeia de caracteres numéricos | 1-65535 |
| env.PORT\_RANGE\_MAX | 9000 | Máximo intervalo de portas dinâmicas | true | cadeia de caracteres numéricos | 1-65535; >= min |
| env.COORDINATION\_SERVICE\_CLIENT\_PORT | "" | Substituição da porta do cliente ZK | true | cadeia de caracteres numéricos | 1-65535 |
| env.COORDINATION\_SERVICE\_PEER\_PORT | "" | Substituição de porta do peer ZK | true | cadeia de caracteres numéricos | 1-65535 |
| env.LICENSE\_SERVICE\_VENDOR\_DAEMON\_PORT | "" | Substituição da porta líder ZK | true | cadeia de caracteres numéricos | 1-65535 |
| env.COORDINATION\_SERVICE\_LEADER\_PORT | "" | Substituição de porta daemon da licença | true | cadeia de caracteres numéricos | 1-65535 |
| env.AGENT\_FILE\_TRANSFER\_PORT | "" | Substituição da porta de transferência de arquivo do Agent | true | cadeia de caracteres numéricos | 1-65535 |
| env.CONTROLLER\_PORT | "" | Substituição da porta do controlador | true | cadeia de caracteres numéricos | 1-65535 |
| persistence.enabled | true | Habilitar PVCs de dados | true | booliano | N/A |
| persistence.storageClass | "" | Classe de armazenamento do PVC de dados | true | cadeia de caracteres | existing StorageClass |
| persistence.accessMode | ReadWriteOnce | Modo de acesso do PVC de dados | true | `ReadWriteOnce,ReadOnlyMany,ReadWriteMany` | N/A |
| persistence.size | 100Gi | Tamanho do PVC de dados | true | Quantidade de Kubernetes | \>0 |
| persistence.bootstrap.enabled | true | Habilitar PVC de bootstrap (múltiplos nós) | true | booliano | N/A |
| persistence.bootstrap.storageClass | "" | Classe de armazenamento de PVC de bootstrap | true | cadeia de caracteres | existing StorageClass |
| persistence.bootstrap.accessMode | ReadWriteMany | Modo de acesso do PVC do bootstrap | true | geralmente `ReadWriteMany` | N/A |
| persistence.bootstrap.size | 1Gi | Tamanho do PVC de bootstrap | true | Quantidade de Kubernetes | \>0 |
| persistence.bootstrap.createPV | false | Permitir que o Chart crie o PV estático | true | booliano | N/A |
| persistence.bootstrap.volumeName | "" | Vínculo explícito do nome do PV de bootstrap | true | cadeia de caracteres | nome de PV existente |
| persistence.bootstrap.pv.name | "" | Nome do PV quando `createPV=true` | true | cadeia de caracteres | DNS-1123 |
| persistence.bootstrap.pv.capacity | 1Gi | Capacidade do PV | true | Quantidade de Kubernetes | \>0 |
| persistence.bootstrap.pv.reclaimPolicy | Retain | Política de recuperação de PV | true | `Retain,Delete,Recycle` | N/A |
| persistence.bootstrap.pv.volumeMode | Filesystem | Modo do volume PV | true | `Filesystem` ou `Block` | N/A |
| persistence.bootstrap.pv.csi.driver | efs.csi.aws.com | Driver CSI para o PV e bootstrap | true | Nome do driver CSI | N/A |
| persistence.bootstrap.pv.csi.volumeHandle | "" | identificador EFS/FileSystem | true | ID específico do provedor | não fica vazio se `createPV=true` |
| persistence.bootstrap.pv.csi.volumeAttributes | {} | Mapa de atributos de volume do CSI | true | map\[string\]string | N/A |
| persistence.bootstrap.permissionsFix.enabled | false | Habilitar o init de permissão de bootstrap | true | booliano | N/A |
| persistence.bootstrap.permissionsFix.image | busybox:1.36 | Imagem Permission-fix | true | referência de imagem válida | N/A |
| persistence.bootstrap.permissionsFix.runAsUser | 0 | UID para permission-fix init | true | inteiro | \>=0 |
| persistence.bootstrap.permissionsFix.fsOwner | 999 | chown UID para bootstrap dir | true | inteiro | \>=0 |
| persistence.bootstrap.permissionsFix.fsGroup | 998 | chown GID para bootstrap dir | true | inteiro | \>=0 |
| persistence.bootstrap.permissionsFix.dirMode | "2775" | modo chmod para bootstrap dir | true | modo octal de cadeia de caracteres | 0000-7777 |
| config.configJson | Bloco JSON | Conteúdo `config.json` do Tableau | true | cadeia de caracteres JSON válida | N/A |
| config.regInfoJson | Bloco JSON | Registro JSON do Tableau | true | cadeia de caracteres JSON válida | N/A |
| config.tabsvcYml | Bloco YAML | Conteúdo `tabsvc.yml` do Tableau | true | cadeia de caracteres YAML válida | N/A |
|   |   | Chave da licença por meio do segredo do Chart | true | cadeia de caracteres | não vazio se usado |
| secrets.tsmRemotePassword | "" | Senha remota do TSM via segredo | true | cadeia de caracteres | não vazio se usado |
| secrets.tableauUsername | "" | Nome de usuário do administrador do Tableau via segredo | true | cadeia de caracteres | não vazio se usado |
| secrets.tableauPassword | "" | Senha do administrador do Tableau via segredo | true | cadeia de caracteres | não vazio se usado |
| service.primary.type | ClusterIP | Tipo de serviço principal | true | `ClusterIP,NodePort,LoadBalancer` | N/A |
| service.primary.ports.http | 80 | Porta HTTP principal | true | inteiro | 1-65535 |
| service.primary.ports.gateway | 8080 | Porta de gateway primário | true | inteiro | 1-65535 |
| service.primary.ports.ssl | 8443 | Porta SSL principal | true | inteiro | 1-65535 |
| service.primary.ports.tsm | 8850 | Porta TSM principal | true | inteiro | 1-65535 |
| service.primary.ports.dynamic.start | 8600 | Início dinâmico da porta | true | inteiro | 1-65535 |
| service.primary.ports.dynamic.end | 9000 | Fim dinâmico da porta | true | inteiro | 1-65535; >= star |
| service.primary.annotations | {} | Anotações do serviço principal | true | map\[string\]string | N/A |
| service.worker.ports.http | ClusterIP | Tipo de serviço do trabalhador | true | `ClusterIP,NodePort,LoadBalancer` | N/A |
| service.worker.ports.http | 80 | Porta HTTP do trabalhador | true | inteiro | 1-65535 |
| service.worker.ports.gateway | 8080 | Porta de gateway do trabalhador | true | inteiro | 1-65535 |
| service.worker.ports.ssl | 8443 | Porta SSL do trabalhador | true | inteiro | 1-65535 |
| service.worker.ports.tsm | 8850 | Porta TSM do trabalhador | true | inteiro | 1-65535 |
| service.worker.ports.dynamic.start | 8600 | Início dinâmico do trabalhador | true | inteiro | 1-65535 |
| service.worker.ports.dynamic.end | 9000 | Fim dinâmico do trabalhador | true | inteiro | 1-65535; >= start |
| service.worker.annotations | {} | Anotações do serviço do trabalhador | true | map\[string\]string | N/A |
| ingress.enabled | false | Habilitar Ingress | true | booliano | N/A |
| ingress.className | "" | Nome da classe do Ingress | true | cadeia de caracteres | classe existente |
| ingress.annotations | {} | Anotações do Ingress | true | map\[string\]string | N/A |
| ingress.hosts | \[{host: tableau.example.com, paths:\[...\]}\] | Configuração de host/caminho do Ingress | true | matriz de objetos de host/caminho | N/A |
| ingress.tls | \[\] | Entradas TLS do Ingress | true | matriz de objetos TLS | N/A |
| healthChecks.startup.enabled | true | Habilitar investigação de inicialização | true | booliano | N/A |
| healthChecks.startup.initialDelaySeconds | 300 | Atraso da investigação de inicialização | true | inteiro | \>=0 |
| healthChecks.startup.periodSeconds | 15 | Período de investigação da inicialização | true | inteiro | \>=1 |
| healthChecks.startup.timeoutSeconds | 30 | Tempo limite da investigação da inicialização | true | inteiro | \>=1 |
| healthChecks.startup.failureThreshold | 200 | Limite de falhas de inicialização | true | inteiro | \>=1 |
| healthChecks.liveness.enabled | true | Habilitar investigação de atividade | true | booliano | N/A |
| healthChecks.liveness.initialDelaySeconds | 300 | Atraso na investigação de atividade | true | inteiro | \>=0 |
| healthChecks.liveness.periodSeconds | 30 | Período da investigação de atividade | true | inteiro | \>=1 |
| healthChecks.liveness.timeoutSeconds | 10 | Tempo limite da investigação de atividade | true | inteiro | \>=1 |
| healthChecks.liveness.successThreshold | 1 | Limite de sucessos da atividade | true | inteiro | \>=1 |
| healthChecks.liveness.failureThreshold | 3 | Limite de falhas da atividade | true | inteiro | \>=1 |
| healthChecks.readiness.enabled | true | Habilitar investigação de prontidão | true | booliano | N/A |
| healthChecks.readiness.initialDelaySeconds | 300 | Atraso na investigação de prontidão | true | inteiro | \>=0 |
| healthChecks.readiness.periodSeconds | 10 | Período da investigação de prontidão | true | inteiro | \>=1 |
| healthChecks.readiness.timeoutSeconds | 5 | Tempo limite da investigação de prontidão | true | inteiro | \>=1 |
| healthChecks.readiness.successThreshold | 1 | Limite de sucessos de prontidão | true | inteiro | \>=1 |
| healthChecks.readiness.failureThreshold | 3 | Limite de falhas de prontidão | true | inteiro | \>=1 |
| podDisruptionBudget.enabled | false | Habilitar PodDisruptionBudget | true | booliano | N/A |
| podDisruptionBudget.minAvailable | 1 | Pods mínimos disponíveis | true | cadeia de caracteres com valor inteiro ou percentual | \>=0 |
| rótulos | {} | Rótulos muito comuns | true | map\[string\]string | N/A |
| anotações | {} | Anotações muito comuns | true | map\[string\]string | N/A |
| podLabels | {} | Rótulos de pods extras | true | map\[string\]string | N/A |
| podAnnotations | {} | Anotações de pod extras | true | map\[string\]string | N/A |
| hooks.autoApplyWorkerTopology.enabled | false | Habilitar hook de topologia pós-instalação/atualização | true | booliano | N/A |
| hooks.autoApplyWorkerTopology.kubectlImage | bitnami/kubectl:latest | Imagem de kubectl da tarefa de gancho | true | referência de imagem válida | N/A |
| hooks.autoApplyWorkerTopology.timeoutSeconds | 3600 | Tempo limite do hook enquanto aguarda por trabalhadores | true integer >=60 | integer >=60 | \>=60 |

## Recursos adicionais

- [Tableau Server Helm Chart - Visão geral](https://help.tableau.com/current/server/pt-br/server-in-container_helm-chart.htm)
- [Tableau Server Helm Chart - Pré-requisitos](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm)
- [Tableau Server Helm Chart - Implantação](https://help.tableau.com/current/server/pt-br/server-helm-deploy.htm)
- [Tableau Server Helm Chart - Exemplos](https://help.tableau.com/current/server/pt-br/server-helm-examples.htm)
- [Tableau Server Helm Chart - Solução de problemas](https://help.tableau.com/current/server/pt-br/server-helm-troubleshooting.htm)
- [Documentação do Tableau Server](https://help.tableau.com/current/server-linux/en-us/)

<!-- document id=828950c4ccaa9c9ba46cbaff791625d527b7f3bec10a0afde627b710b24c65a0 url=/tableau/current/pt-br/server/activity_log_schema.md -->

[Pular para o conteúdo principal](#main-content)

# Referência do tipo de evento de site do registro de atividades

Este tópico descreve os tipos e atributos de evento de site do Registro de atividades.

## Detalhes do tipo de evento

O conteúdo a seguir descreve os tipos de eventos e atributos do site no Registro de atividades.Use a lista de tipos de eventos em ordem alfabética à direita ou **ctrl/cmd-f** para ir diretamente às palavras-chave que você tem em mente.

**Observação:** os registros de data e hora dos eventos são registrados no padrão ISO 8601 UTC.

## Atributos comuns

A tabela contém atributos comuns para todos os eventos de site do Registro de atividades.Para atributos específicos de eventos, revise as tabelas de eventos individuais neste tópico.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>actorUserId</td><td>inteiro</td><td>A ID do usuário que executou a ação que iniciou o evento</td></tr><tr><td>actorUserLuid</td><td>cadeia de caracteres</td><td>A LUID do usuário que executou a ação que iniciou o evento</td></tr><tr><td>eventOutcome</td><td>cadeia de caracteres</td><td>Representa o resultado final da operação.Os possíveis valores são:<ul><li><b>sucesso:</b> a tentativa de operação foi concluída com sucesso.</li><li><b>não autorizado:</b> o usuário iniciador não estava autorizado a executar a operação.</li><li><b>client_error:</b> a operação falhou devido a uma causa atribuível ao cliente/chamador.Por exemplo, parâmetros de solicitação de API inválidos, tempo limite de conexão do cliente ou limitação.</li><li><b>internal_error:</b> a operação falhou devido a um erro interno inesperado.</li></ul></td></tr><tr><td>eventOutcomeReason</td><td>cadeia de caracteres</td><td>Fornece detalhes adicionais sobre o resultado do evento</td></tr><tr><td>eventProcessedTime</td><td>cadeia de caracteres</td><td>Carimbo de data/hora de quando o evento ficou disponível no Registro de atividade.Esse atributo se aplica a eventos gravados após a migração do Hyperforce em janeiro e fevereiro de 2026.Para ver o carimbo de data/hora de quando o evento ocorreu, use o atributo <code>eventTime</code>.</td></tr><tr><td>eventTime</td><td>cadeia de caracteres</td><td>Carimbo de data/hora de quando o evento ocorreu</td></tr><tr><td>initiatingUserId</td><td>inteiro</td><td>ID do usuário que iniciou.Este valor geralmente é o mesmo que <code>actorUserId</code> e difere apenas para autenticação delegada, como tíquetes confiáveis ou representação.Durante a representação, é a ID do usuário administrativo que iniciou a sessão.Quando a sessão não tem usuário iniciador ou não existe sessão, <code>initiatingUserId</code> usa o valor de <code>actorUserId</code>.</td></tr><tr><td>initiatingUserLuid</td><td>cadeia de caracteres</td><td>LUID do usuário que iniciou.Para representação, é a LUID do usuário administrativo que iniciou a representação.Para login padrão, o valor é o mesmo que <code>actorUserLuid</code>.</td></tr><tr><td>licensingRoleName</td><td>cadeia de caracteres</td><td>Nome da função de licenciamento do usuário quando o evento ocorreu</td></tr><tr><td>serviceName</td><td>cadeia de caracteres</td><td>Nome do serviço que iniciou o evento, como vizportal, vizqlserver ou sitesaml.</td></tr><tr><td>siteLuid</td><td>cadeia de caracteres</td><td>LUID do site do Tableau em que ocorreu o evento</td></tr><tr><td>siteRoleId</td><td>inteiro</td><td>A ID de função de site do usuário.O valor 0 = SiteAdministratorExplorer, 1 = SupportUser, 2 = ExplorerCanPublish, 3 = Explorer, 7 = Guest, 8 = Não licenciado, 9 = Visualizador, 10 = Criador e 11 = SiteAdministratorCreator.</td></tr><tr><td>systemAdminLevel</td><td>inteiro</td><td>Indica se o usuário é um administrador de sistema.O valor 10 = Administrador de sistema e 0 = Não é um administrador de sistema.</td></tr></tbody></table>

## add\_delete\_user\_to\_group

O evento `add_delete_user_to_group` é registrado quando um usuário é adicionado ou removido de um grupo.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>groupId</td><td>inteiro</td><td>A ID do grupo</td></tr><tr><td>groupLuid</td><td>cadeia de caracteres</td><td>A LUID do grupo</td></tr><tr><td>groupOperation</td><td>cadeia de caracteres</td><td>Operação de grupo, adicione ou exclua o usuário a um grupo</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>userId</td><td>inteiro</td><td>A ID do usuário</td></tr><tr><td>userLuid</td><td>cadeia de caracteres</td><td>A LUID do usuário</td></tr></tbody></table>

## content\_owner\_change

O evento `content_owner_change` é registrado quando o proprietário do conteúdo é alterado.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que o proprietário alterou</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>LUID do conteúdo que o proprietário alterou</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>Nome do conteúdo que o proprietário alterou</td></tr><tr><td>contentType</td><td>cadeia de caracteres</td><td>O tipo de conteúdo, como fonte de dados de dados, pasta de trabalho ou exibição</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>newOwnerId</td><td>inteiro</td><td>A ID do novo proprietário do conteúdo</td></tr><tr><td>newOwnerLuid</td><td>cadeia de caracteres</td><td>A LUID do novo proprietário do conteúdo</td></tr><tr><td>oldOwnerId</td><td>inteiro</td><td>A ID do antigo proprietário do conteúdo</td></tr><tr><td>oldOwnerLuid</td><td>cadeia de caracteres</td><td>A LUID do antigo proprietário do conteúdo</td></tr></tbody></table>

## create\_delete\_group

O evento `create_delete_group` é registrado quando um grupo é criado ou excluído.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>groupDomain</td><td>cadeia de caracteres</td><td>O domínio do grupo, como local</td></tr><tr><td>groupId</td><td>inteiro</td><td>A ID do grupo</td></tr><tr><td>groupLuid</td><td>cadeia de caracteres</td><td>A LUID da cadeia de caracteres do grupo</td></tr><tr><td>groupName</td><td>cadeia de caracteres</td><td>O nome do grupo que teve as permissões alteradas</td></tr><tr><td>groupOperation</td><td>cadeia de caracteres</td><td>Operação de grupo, crie ou exclua</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr></tbody></table>

## create\_permissions

O evento `create_permissions` é registrado quando uma nova regra de permissão explícita é criada.

**Observação:** obsoleto em outubro de 2024.Use o evento [definir\_permissões](#set-permissions) em vez disso.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>authorizableType</td><td>cadeia de caracteres</td><td>O tipo de conteúdo que teve suas permissões alteradas, como projeto ou pasta de trabalho</td></tr><tr><td>capabilityId</td><td>inteiro</td><td>A ID do recurso.Um recurso é a capacidade de executar ações no conteúdo, como visualizar, filtrar, baixar ou excluir</td></tr><tr><td>capabilityValue</td><td>cadeia de caracteres</td><td>Descrição do recurso</td></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>A LUID do item de conteúdo</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>granteeId</td><td>inteiro</td><td>A ID do beneficiário</td></tr><tr><td>granteeLuid</td><td>cadeia de caracteres</td><td>A LUID do beneficiário</td></tr><tr><td>granteeType</td><td>cadeia de caracteres</td><td>O tipo de beneficiário, usuário ou grupo</td></tr><tr><td>granteeValue</td><td>cadeia de caracteres</td><td>O valor de permissões atualizado, como 'permissão de usuário' ou 'permissão de grupo'</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr></tbody></table>

## delete\_all\_permissions

O evento `delete_all_permissions` é registrado quando todas as regras de permissão explícitas para conteúdo são excluídas, geralmente quando o conteúdo é excluído.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>authorizableType</td><td>cadeia de caracteres</td><td>O tipo de conteúdo que teve suas permissões alteradas, como projeto ou pasta de trabalho</td></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>A LUID do conteúdo</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr></tbody></table>

## delete\_permissions

O evento `delete_permissions` é registrado quando uma regra de permissão explícita é removida de um item de conteúdo por meio da API REST.Para obter mais informações, consulte [Métodos de permissões](https://help.tableau.com/current/api/rest_api/pt-br/REST/rest_api_ref_permissions.htm) na Ajuda da API REST do Tableau.

Outras maneiras de remover permissões são registradas como eventos diferentes:

- A remoção de um recurso na caixa de diálogo Permissões é registrada como um evento `set_permissions` com um `permissionType` de `unspecified`, porque todo o conjunto de permissões do beneficiário é substituído.
- A exclusão de conteúdo é registrada como `delete_all_permissions`.
- A exclusão de um usuário ou grupo é registrada como `delete_permissions_grantee`.

Para capturar todas as remoções de permissão, monitore `set_permissions`, `delete_all_permissions` e `delete_permissions_grantee`.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>authorizableType</td><td>cadeia de caracteres</td><td>O tipo de conteúdo que teve suas permissões alteradas, como projeto ou pasta de trabalho</td></tr><tr><td>capabilityId</td><td>inteiro</td><td>A ID do recurso.Um recurso é a capacidade de executar ações no conteúdo, como visualizar, filtrar, baixar ou excluir</td></tr><tr><td>capabilityValue</td><td>cadeia de caracteres</td><td>Descrição do recurso</td></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>A LUID do conteúdo</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>granteeId</td><td>inteiro</td><td>A ID do beneficiário</td></tr><tr><td>granteeLuid</td><td>cadeia de caracteres</td><td>O LUID do beneficiário.Este valor pode ser nulo se o beneficiário foi excluído recentemente ou se o serviço de pesquisa LUID está indisponível.O atributo <code>granteeId</code> está sempre presente.</td></tr><tr><td>granteeType</td><td>cadeia de caracteres</td><td>O tipo de beneficiário, usuário ou grupo</td></tr><tr><td>granteeValue</td><td>cadeia de caracteres</td><td>O valor de permissões atualizado, como 'permissão de usuário' ou 'permissão de grupo'</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr></tbody></table>

## delete\_permissions\_grantee

O evento `delete_permissions_grantee` é registrado quando todas as regras de permissão explícitas para um usuário ou grupo são excluídas, geralmente quando o usuário ou grupo é excluído.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>granteeId</td><td>inteiro</td><td>A ID do beneficiário</td></tr><tr><td>granteeLuid</td><td>cadeia de caracteres</td><td>O LUID do beneficiário.Este valor pode ser nulo se o beneficiário foi excluído recentemente ou se o serviço de pesquisa LUID está indisponível.O atributo <code>granteeId</code> está sempre presente.</td></tr><tr><td>granteeType</td><td>cadeia de caracteres</td><td>O tipo de beneficiário, usuário ou grupo</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr></tbody></table>

## display\_sheet\_tabs

O evento `display_sheet_tabs` é registrado quando o valor "Exibições em guias" é atualizado em uma pasta de trabalho.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>displayTabs</td><td>booliano</td><td>Indica se as planilhas da pasta de trabalho são exibidas como guias ou não</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>workbookId</td><td>inteiro</td><td>A ID da pasta de trabalho</td></tr></tbody></table>

## move\_content

O evento `move_content` é registrado quando o conteúdo é movido, por exemplo, mover uma pasta de trabalho entre projetos.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que o proprietário alterou</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>LUID do conteúdo que o proprietário alterou</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>Nome do conteúdo que o proprietário alterou</td></tr><tr><td>contentType</td><td>cadeia de caracteres</td><td>O tipo de conteúdo, como fonte de dados de dados, pasta de trabalho ou exibição</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>newContainerLuid</td><td>cadeia de caracteres</td><td>LUID do novo contêiner</td></tr><tr><td>newContainerType</td><td>cadeia de caracteres</td><td>O novo tipo de contêiner, como um projeto</td></tr><tr><td>oldContainerLuid</td><td>cadeia de caracteres</td><td>LUID do contêiner anterior</td></tr><tr><td>oldContainerType</td><td>cadeia de caracteres</td><td>O tipo de contêiner anterior, como um projeto</td></tr></tbody></table>

## project\_lock\_unlock

O evento `project_lock_unlock` é registrado quando as permissões do projeto são bloqueadas ou desbloqueadas.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>controllingProjectLuid</td><td>cadeia de caracteres</td><td>LUID do projeto que controla as permissões projeto</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>projectLuid</td><td>cadeia de caracteres</td><td>LUID do projeto</td></tr><tr><td>projectOperation</td><td>cadeia de caracteres</td><td>Operação do projeto, bloquear ou desbloquear</td></tr></tbody></table>

## set\_permissions

O evento `set_permissions` é registrado quando uma regra de permissão é criada ou atualizada para um item de conteúdo, normalmente quando você salva alterações na caixa de diálogo Permissões.A remoção de uma regra de permissão também é registrada como este evento, com um `permissionType` de `unspecified`.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>authorizableType</td><td>cadeia de caracteres</td><td><p>O tipo de conteúdo que teve suas permissões alteradas, como projeto ou pasta de trabalho</p></td></tr><tr><td>capabilityId</td><td>inteiro</td><td>A ID do recurso.Um recurso é a capacidade de realizar determinada ação em uma parte específica do conteúdo, como exibir, filtrar, baixar ou excluir.</td></tr><tr><td>capabilityValue</td><td>cadeia de caracteres</td><td>Descrição do recurso</td></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que teve as permissões definidas</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>A LUID do item de conteúdo</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>O nome do conteúdo que teve as permissões definidas</td></tr><tr><td>granteeId</td><td>inteiro</td><td>A ID do beneficiário</td></tr><tr><td>granteeLuid</td><td>cadeia de caracteres</td><td>O LUID do beneficiário.Este valor pode ser nulo se o beneficiário foi excluído recentemente ou se o serviço de pesquisa LUID está indisponível.O atributo <code>granteeId</code> está sempre presente.</td></tr><tr><td>granteeType</td><td>cadeia de caracteres</td><td>O tipo de beneficiário, usuário ou grupo</td></tr><tr><td>granteeValue</td><td>cadeia de caracteres</td><td>O valor das permissões definidas, como ‘permissão de usuário’ ou ‘permissão de grupo’</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>permissionType</td><td>cadeia de caracteres</td><td>O tipo de permissão.Um valor de <code>explicit</code> significa que uma regra Permitir ou Negar foi definida.Um valor de <code>unspecified</code> significa que uma regra foi removida ou definida como herdada.</td></tr></tbody></table>

## update\_permissions

O evento `update_permissions` é registrado quando uma regra de permissão explícita é atualizada para um item de conteúdo.

**Observação:** obsoleto em outubro de 2024.Use o evento [definir\_permissões](#set-permissions) em vez disso.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>authorizableType</td><td>cadeia de caracteres</td><td>O tipo de conteúdo que teve suas permissões alteradas, como projeto ou pasta de trabalho</td></tr><tr><td>capabilityId</td><td>inteiro</td><td>A ID do recurso.Um recurso é a capacidade de executar ações no conteúdo, como visualizar, filtrar, baixar ou excluir</td></tr><tr><td>capabilityValue</td><td>cadeia de caracteres</td><td>Descrição do recurso</td></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>A LUID do conteúdo</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>granteeId</td><td>inteiro</td><td>A ID do beneficiário</td></tr><tr><td>granteeLuid</td><td>cadeia de caracteres</td><td>A LUID do beneficiário</td></tr><tr><td>granteeType</td><td>cadeia de caracteres</td><td>O tipo de beneficiário, usuário ou grupo</td></tr><tr><td>granteeValue</td><td>cadeia de caracteres</td><td>O valor de permissões atualizado, como 'permissão de usuário' ou 'permissão de grupo'</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>permissionType</td><td>cadeia de caracteres</td><td>O tipo de permissão, explícita ou não especificada</td></tr></tbody></table>

## update\_permissions\_template

O evento `update_permissions_template` é registrado quando um modelo de permissão para um projeto é atualizado.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>authorizableType</td><td>cadeia de caracteres</td><td>O tipo de conteúdo que teve suas permissões alteradas, como projeto ou pasta de trabalho</td></tr><tr><td>capabilityId</td><td>inteiro</td><td>A ID do recurso.Um recurso é a capacidade de executar ações no conteúdo, como visualizar, filtrar, baixar ou excluir</td></tr><tr><td>capabilityValue</td><td>cadeia de caracteres</td><td>Descrição do recurso</td></tr><tr><td>contentId</td><td>inteiro</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>contentLuid</td><td>cadeia de caracteres</td><td>A LUID do conteúdo</td></tr><tr><td>contentName</td><td>cadeia de caracteres</td><td>A ID do conteúdo que teve as permissões atualizadas</td></tr><tr><td>granteeId</td><td>inteiro</td><td>A ID do beneficiário</td></tr><tr><td>granteeLuid</td><td>cadeia de caracteres</td><td>O LUID do beneficiário.Este valor pode ser nulo se o beneficiário foi excluído recentemente ou se o serviço de pesquisa LUID está indisponível.O atributo <code>granteeId</code> está sempre presente.</td></tr><tr><td>granteeType</td><td>cadeia de caracteres</td><td>O tipo de beneficiário, usuário ou grupo</td></tr><tr><td>granteeValue</td><td>cadeia de caracteres</td><td>O valor de permissões atualizado, como 'permissão de usuário' ou 'permissão de grupo'</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>permissionType</td><td>cadeia de caracteres</td><td>O tipo de permissão.Um valor de <code>explicit</code> significa que uma regra Permitir ou Negar foi definida.Um valor de <code>unspecified</code> significa que uma regra foi removida ou definida como herdada.</td></tr><tr><td>templateType</td><td>cadeia de caracteres</td><td>O tipo de modelo de permissão usado para alterar permissões, como pasta de trabalho ou fontes de dados</td></tr></tbody></table>

## user\_create\_delete

O evento `user_create_delete` é registrado quando um usuário é criado ou excluído.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>Nome do Atributo</th><th>Tipo</th><th>Descrição</th></tr><tr><td>forUserName</td><td>cadeia de caracteres</td><td>O nome do usuário cuja conta foi criada, atualizada ou excluída</td></tr><tr><td>isError</td><td>booliano</td><td>Indica se o cenário de auditoria foi concluído com sucesso ou falhou com um erro</td></tr><tr><td>siteRole</td><td>cadeia de caracteres</td><td>Função do site do usuário.Determina o nível máximo de acesso que um usuário pode ter no site</td></tr><tr><td>targetUserId</td><td>inteiro</td><td>A ID do usuário cuja conta foi criada, atualizada ou excluída</td></tr><tr><td>targetUserLuid</td><td>cadeia de caracteres</td><td>A LUID do usuário cuja conta foi criada, atualizada ou excluída</td></tr><tr><td>userOperation</td><td>cadeia de caracteres</td><td>A ação executada em um usuário, seja ela criar, excluir ou alterar a função do site</td></tr></tbody></table>

<!-- document id=49d404140fe6fe8d758e827121acb99e0bd247806571f5860ebb6d8825d54885 url=/tableau/current/pt-br/server/activity_log_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Registro de atividade

Se você tem Tableau Server com o Advanced Management, os arquivos de registro de atividades são registrados automaticamente para análise e auditoria detalhadas.

Use esses registros para:

- **Visualizar e analisar dados de eventos:** acesse dados detalhados do evento para Tableau Server, capturando informações de conformidade e rastreando atividades em seus sites. Todos os eventos incluem um carimbo de data/hora e o ID da pessoa e, se relevante, do conteúdo afetado.
- **Alterações nas permissões de auditoria:** rastreie e audite alterações de permissões, como adicionar ou remover usuários de um grupo, mover conteúdo entre projetos e alterar explicitamente as permissões de conteúdo. Isso é essencial para implementar controles robustos para fins de conformidade.
- **Complementar Admin Views:** aprimore as informações fornecidas pelo Admin Views para rastrear a atividade do site e as métricas de uso. Você pode integrar dados do Registro de Atividades com ferramentas de monitoramento, como Splunk ou Amazon EventBridge, para consultar campos de registro e responder perguntas como as últimas 10 ações realizadas por um usuário, quem realizou um evento no conteúdo pela última vez e qual foi a última ação no conteúdo.

## Acesso a eventos do Registro de Atividades

Os eventos do Registro de atividade são armazenados nas pastas `vizportal` e `vizqlserver` no disco rígido local. Por padrão, as pastas estão localizadas em `%PROGRAMDATA%\Tableau\Tableau Server\data\tabsvc\logs\`. Dentro de cada diretório, você encontrará arquivos chamados `<process name>-cepp-canonical-events_*.log` que registram eventos e operações.

Para obter uma lista completa de eventos do Registro de atividades, consulte [Referência do tipo de evento de site do registro de atividades](https://help.tableau.com/current/server/pt-br/activity_log_schema.htm).

## Outros artigos nesta seção

<!-- document id=89fb65b55823145e77bfe12e95faca15e346c1b3ae10c8eee6bff76c3f763e71 url=/tableau/current/pt-br/server/perf_troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Registro de desempenho

Esta seção descreve como criar gravações de desempenho e usar os resultados para melhorar o desempenho da pasta de trabalho. Com as gravações de desempenho, é possível visualizar quanto tempo os eventos da pasta de trabalho demoram. Por exemplo, você pode ver quanto tempo demora para se conectar a uma fonte de dados, executar uma consulta, renderizar os dados e muito mais.

## Outros artigos nesta seção

<!-- document id=009a77d982da6f86df2eab875acfa5537ec1bb8c096a3219d3ed8a26a104b4b5 url=/tableau/current/pt-br/server/distrib_server_restart.md -->

[Pular para o conteúdo principal](#main-content)

# Reiniciar o Tableau Server de vários nós

Reiniciar os computadores que executam uma instalação de vários nós do Tableau Server requer que você siga algumas etapas específicas.

Para reiniciar computadores executando uma instalação de vários nós do Tableau Server:

1. Interrompa o Tableau Server. Para fazer isso:
    
    1. No nó inicial, abra um prompt de comando como um administrador.
    2. Execute este comando tsm:
        
        tsm stop
    3. Aguarde até que Tableau Server seja interrompido.
2. Reinicie os computadores de nós adicionais. Esses são todos os outros computadores, _exceto_ o que está executando o Controlador do TSM.
3. Aguarde até que cada um dos computadores de nó adicional seja completamente reiniciado, incluindo os processos do Tableau Services Manager (TSM) instalados aqui.
4. Reinicie o computador de nó inicial (o computador executando o Controlador do TSM). Quando ele for completamente reiniciado e o Tableau Server estiver em execução, as conexões para cada nó adicional devem ser restauradas.

<!-- document id=c58b76402edc52ceebe9964858df69dfb4ac797adb4226d6eb839a46be0e26fe url=/tableau/current/pt-br/server/rmt-admin-chargeback.md -->

[Pular para o conteúdo principal](#main-content)

# Relatórios de chargeback

Os relatórios de chargeback mostram o uso de por projeto ou site e estão disponíveis para usuários permitidos pelo menu _Admin_. O relatório é gerado como uma pasta de trabalho do Tableau usando uma extração gerada, o que permite modificar o relatório ou reutilizar a extração conforme necessário.

A planilha de _Visão geral de chargeback_ mostra uma análise de várias métricas baseadas no site e/ou projeto:

![Visão geral](/tableau/current/pt-br/server/pt-br/Img/rmt-rpts-chgback_overview.png)

Visão geral

Os valores de dólar podem ser personalizados usando o campo de custo total e ajustando os pesos de custo de cada métrica.

Clicar em um projeto ou site navega até um relatório de detalhes personalizado estilo fatura para esse projeto/site:

![Detalhe](/tableau/current/pt-br/server/pt-br/Img/rmt-rpts-chgback_detail.png)

Detalhe

## Segurança

O acesso ao usuário é controlado por meio da função _Gerar relatórios de chargeback_.

## Geração de dados

Os dados do relatório de chargeback são agregados no nível diário, com as seguintes métricas incluídas no conjunto de dados:

| Métrica | Descrição |
| --- | --- |
| Utilização de arquivo extra | O tamanho, em Kilobytes, dos arquivos de extração é coletado uma vez por dia. Para o relatório padrão, isso é simplesmente totalizado no período de tempo para fins de taxa/comparação entre projetos/locais. |
| Duração da consulta de extração | O tempo, em milissegundos, que consulta em relação a arquivos de extração executados, totalizado por dia. |
| Duração da tarefa de atualização de extração | O tempo, em milissegundos, que as tarefas em segundo plano da atualização de extração foram executadas, totalizado por dia. |
| Duração da consulta | O tempo, em milissegundos, de execução das consultas, totalizado por dia. Isso inclui consultas de extração e não extração. |
| Visualizar duração da solicitação | O tempo, em milissegundos, que solicita a renderização de exibições executadas, totalizado por dia. Isso inclui a duração de quaisquer consultas de dados que bloquearam a renderização da exibição. |

### Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=5c63f33f9d19ed69d6075b9986d8799fcf8876f634f522081246febb7f389eaf url=/tableau/current/pt-br/server/maintenance_cleanup.md -->

[Pular para o conteúdo principal](#main-content)

# Remover arquivos desnecessários

Como prática recomendada, você deve monitorar regularmente o uso do espaço em disco do servidor. Se o computador do Tableau Server tiver pouco espaço em disco, o impacto pode ser significativo, inclusive causando uma falha. Se você perceber que o espaço está acabando, pode arquivar o que quiser salvar e limpar arquivos desnecessários, liberando espaço para o Tableau.

## Monitorar uso do espaço em disco

Há várias coisas que você pode fazer para monitorar o uso do espaço em disco:

- Notificações: configure o Tableau Server para enviar notificações quando o espaço em disco atingir níveis predeterminados. Para obter mais informações, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).
- Exibições administrativas: use uma exibição administrativa pré-construída para ajudar a monitorar o uso do espaço em disco. Para obter mais informações, consulte [Espaço em disco do servidor](https://help.tableau.com/current/server/pt-br/adminview_space_all_nodes.htm).

## Reduzir o uso do espaço em disco

Para disponibilizar mais espaço em disco, execute as seguintes etapas:

- Armazene arquivos de registro: o Tableau Server gera arquivos de registro ao ser executado. Eles podem ser úteis ao solucionar problemas, e quando você está trabalhando com o Suporte do Tableau, mas não precisa deixá-los no lugar indefinidamente. Para economizar espaço em disco sem perder os registros, você pode arquivá-los com o comando `tsm maintenance ziplogs` e, em seguida, copiar o arquivo ziplogs em um computador que não faz parte da instalação do Tableau para manter em segurança. Para obter mais informações, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).
- Limpe arquivos indesejados: depois de arquivar os registros que deseja salvar, use o comando `tsm maintenance cleanup` para remover arquivos de registro com mais de sete dias, arquivos temporários e, opcionalmente, linhas da tabela `http_requests` no repositório do Tableau Server. Execute o comando cleanup regularmente. Para obter mais informações sobre quais arquivos são removidos, consulte [tsm maintenance cleanup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cleanup).
- Remova outros arquivos: com o tempo o Tableau Server pode gerar arquivos que não precisam ser mantidos. Além dos arquivos mencionados acima, fique atento a arquivos como backups antigos de versões anteriores. Os arquivos de backup do Tableau Server têm uma extensão `.tsbak`. Recomendamos fazer backup regular do Tableau e salvar os arquivos de backup em um computador que não faz parte da instalação do Tableau Server para uma manutenção segura, mas uma vez que você salvar o arquivo em outro local, poderá excluí-lo do computador do Tableau. Para obter mais informações sobre arquivos de backup, incluindo como criá-los e onde eles são salvos, consulte [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm).

<!-- document id=3e5f2f50d4d3680bf570917eaeeb9e53e4be44e99fb797ce046d919445272821 url=/tableau/current/pt-br/server/remove_tableau.md -->

[Pular para o conteúdo principal](#main-content)

# Remover o Tableau Server do computador

**Aviso:** as etapas abaixo _removem completamente_ o Tableau Server do Windows e excluem todos os dados relacionados, usuários e informações de configuração. Isso inclui qualquer arquivo em `\temp`. As licenças do Tableau Server também são desativadas, se você incluir a opção `-l` ao executar o comando mostrado abaixo e o computador estiver conectado à Internet.  
  
Como prática recomendada, copie os arquivos de backup que você deseja salvar em um local que não esteja relacionado ao Tableau. Isso preservará os arquivos quando remover o Tableau. Por segurança, copie os arquivos de backup em outro computador, incluindo os arquivos de backup criados ao desinstalar o Tableau. Por padrão, eles são criados em `C:\ProgramData\Tableau\Tableau Server`, com nome semelhante a `uninstall-2018.1.tsbak`. Salvar arquivos de backup em outro computador permitirá que você reinstale a versão do Tableau Server que criou o backup e tenha os dados contidos no backup, mesmo após executar o script `tableau-server-obliterate.cmd`.

Se desejar desinstalar um pacote específico do Tableau Server para liberar espaço em disco (após a atualização, por exemplo), consulte [Desinstalar o Tableau Server](https://help.tableau.com/current/server/pt-br/uninstall_server.htm).

Como parte da instalação padrão do Tableau Server, é instalado um script que oferece uma forma de remover completamente o Tableau e todos os arquivos associados a ele do computador. Isso é algo para ser feito somente quando os dados, a configuração ou os arquivos de registro do Tableau não têm importância para você ou se estiver trabalhando com o Suporte técnico do Tableau e precisar reinstalar o Tableau Server após uma falha de instalação ou atualização. O script de apagamento não removerá qualquer driver instalado separadamente, mesmo aqueles instalados para serem usados com o Tableau Server.

O script `tableau-server-obliterate``.cmd` deve ser usado quando você quiser remover completamente o Tableau Server do computador. É possível fazer isso por algumas razões diferentes:

- Você não quer mais o Tableau Server instalado no computador. Use o script `tableau-server-obliterate``.cmd` para remover completamente o Tableau Server. Se for o caso, e o computador estiver conectado à internet, você pode incluir uma opção `-l` para desativar a licença do Tableau Server.
- Solução de problemas na instalação do Tableau Server - Se você tiver problemas ao instalar o Tableau, talvez seja necessário usar o script `tableau-server-obliterate``.cmd` para remover completamente o Tableau Server do computador antes de reinstalá-lo. Fazer isso limpará qualquer configuração ou estados e permitirá reinstalar em um computador "limpo". Se estiver fazendo isso, é possível deixar desativada a opção `-l` para preservar as informações de licenciamento no computador. Se você omitir a opção `-l`, não será necessário ativar a licença ao reinstalar o Tableau Server.

> [!IMPORTANT]
> 
> **Importante:** você deve executar o script `tableau-server-obliterate.cmd` a partir de um prompt de comando de 64 bits. Por exemplo, execute `cmd.exe` na pasta `C:\Windows\System32`. Se você executar o script a partir de um prompt de comando de 32 bits, o script não removerá completamente o Tableau e poderá ocorrer falha nas instalações subsequentes. Para determinar se você está executando um prompt de comando de 64 bits, digite `echo %processor_architecture%` na janela de comando. Se o resultado inclui "64" (`AMD64`, por exemplo), o prompt de comando é um prompt de 64 bits. Se o resultado inclui "x86", você está executando um prompt de 32 bits. Para obter mais informações, consulte a documentação apropriada da Microsoft para as suas versões do Windows.

## O que tableau-server-obliterate faz

A identação do script `tableau-server-obliterate``.cmd` deve remover completamente o Tableau Server do computador. Isso inclui arquivos, configurações do sistema e configurações e, se especificado, informações de licenciamento.

Ao executar o `tableau-server-obliterate``.cmd`, as seguintes etapas serão executadas:

- A Desinstalação é executada em todas as versões instaladas do Tableau Server (desinstalação do Painel de Controle).
- A maioria do conteúdo do diretório de dados é removida (por padrão, `C:\ProgramData\Tableau\Tableau Server`). Os arquivos de backup e registro são preservados por padrão. Veja a seção abaixo, "Manter os arquivos de backup e de registro do Tableau Server".
- Todas as entradas de registro relacionadas ao Tableau Server são removidas.
- Todas as licenças de servidor são desativadas se você usar a opção `-l` e o computador está conectado à internet. Essa opção não funciona em situações offline.

### Preservação dos arquivos de backup e de registro do Tableau Server

Antes da versão 2020.1 do Tableau Server, a execução do script `tableau-server-obliterate` excluiu todo o conteúdo do diretório de dados. A partir da versão 2020.1, o comportamento padrão do script `tableau-server-obliterate` foi alterado: o script copia e salva os arquivos de backup e de registro do Tableau Server no diretório `logs-temp`. A localização padrão do diretório logs-temp está em `\ProgramData\Tableau\logs-temp`. Você pode definir opções no script para desativar essa nova funcionalidade.

Para alterar o comportamento padrão e remover arquivos de backup ou de registro, inclua as seguintes opções ao executar o script `tableau-server-obliterate``.cmd`

- `-k` Não copie backups no diretório logs-temp.
- `-g` Não copie logs no diretório logs-temp.
- `-a` Não copie nada no diretório logs-temp.

## Executar o script tableau-server-obliterate

É possível remover completamente o Tableau Server de um computador, mantendo as informações de licenciamento ou as removendo junto com todos os outros aspectos do Tableau Server. Você pode querer manter o licenciamento se for reinstalar o Tableau Server no mesmo computador.

Uma versão mais antiga do `tableau-server-obliterate``.cmd` pode ignorar arquivos de novas versões do Tableau Server. Sempre execute o script obliterate para a versão do Tableau Server que está instalada no computador.

### Para remover completamente o Tableau Server sem remover o licenciamento do servidor

O script de exemplo neste procedimento também inclui a opção `-a` para remover arquivos de backup e de registro do Tableau Server.

**Observação:** se você planeja reinstalar o Tableau Server e [Ativar o Tableau Server usando o serviço ATR (Autorização para execução)](https://help.tableau.com/current/server/pt-br/atr_service.htm) , recomendamos remover as informações de licenciamento antes de reinstalar e ativar o Tableau Server usando o Server ATR.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Execute o script `tableau-server-obliterate``.cmd`:
    
    Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\``tableau-server-obliterate.cmd -a -y -y -y`
    
    **Observação:** se você já tiver desinstalado o Tableau Server por meio do Painel de Controle e agora quiser removê-lo completamente, execute a cópia do script `tableau-server-obliterate.cmd` localizada na pasta `\Tableau Server\temp` (por padrão: `C:\Program Files\Tableau\Tableau Server\temp`) . Caso o script não esteja nesse diretório, reinstale o pacote do Tableau Server e, em seguida, execute o script `tableau-server-obliterate.cmd` da pasta de scripts (Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`).  
      
    Você também pode obter uma cópia do script deste artigo da Base de dados de conhecimento: [Script obliterate indisponível](https://kb.tableau.com/articles/issue/windows-server-obliterate-script-is-not-available-after-running-uninstall?lang=pt-br).
    
    Se a sua instalação do Tableau Server for de vários nós (distribuída), execute o script `tableau-server-obliterate``.cmd` em cada nó do cluster.
3. Reinicie cada computador no qual você executou o script `tableau-server-obliterate``.cmd`.

### Para remover completamente o Tableau e o licenciamento

O script de exemplo neste procedimento também inclui a opção `-a` para remover arquivos de backup e de registro do Tableau Server.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Desative qualquer chave do produto ativa.
    
    `[tsm licenses deactivate](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMDeactivate) -k <product_key>`
3. Execute o script `tableau-server-obliterate``.cmd`:
    
    Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\``tableau-server-obliterate.cmd -a -y -y -y -l`
    
    A opção `-l` para o script obliterate remove todos os arquivos de licenciamento do computador se o computador estiver conectado à internet. O script primeiro tenta desativar qualquer licença ativa, mas removerá todas as informações de licenciamento independentemente do sucesso ou falha dessa desativação. Por isso recomendamos executar o comando `tsm licenses deactivate` antes de executar o script obliterate.
    
    **Observação:** se você já tiver desinstalado o Tableau Server por meio do Painel de Controle e agora quiser removê-lo completamente, execute a cópia do script `tableau-server-obliterate.cmd` localizada na pasta `\Tableau Server\temp` (por padrão: `C:\Program Files\Tableau\Tableau Server\temp`) . Caso o script não esteja nesse diretório, reinstale o pacote do Tableau Server e, em seguida, execute o script `tableau-server-obliterate.cmd` da pasta de scripts (Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`).
    
    Se a sua instalação do Tableau Server for de vários nós (distribuída), execute o script `` tableau-server-obliterate`.cmd` `` em cada nó do cluster. Não é necessário desativar as licenças em qualquer nó adicional.
4. Reinicie cada computador no qual você executou o script `tableau-server-obliterate``.cmd`.

<!-- document id=d033399c17129c3cb45cb5e6efb243c46d1c11acb87b5bb3b0232e8635ccf1cd url=/tableau/current/pt-br/server/distrib_worker_remove.md -->

[Pular para o conteúdo principal](#main-content)

# Remover um nó

Se a instalação do Tableau Server incluir um nó que se tornou desnecessário, remova-o para simplificar a instalação e libere os recursos de hardware nesse nó.

**Observação:** se tiver o agente Resource Monitoring Tool do Tableau instalado nesse nó, deverá removê-lo do Ambiente do servidor mestre Resource Monitoring Tool. Para obter mais informações, consulte [Alterações de topologia do Tableau Server](https://help.tableau.com/current/server/pt-br/rmt-tableau-server-topology-changes.htm).

## Pré-requisitos para a remoção de um nó

Há pré-requisitos que você deve satisfazer antes de remover um nó do seu cluster do Tableau Server. Se o nó tiver alguma limitação, você precisará solucioná-la antes que possa remover o nó. As limitações incluem confirmar que o nó foi adicionado com pelo menos um processo, e que o nó não inclui processos que também não estão instalados em outro nó.

Se uma das seguintes limitações de configuração se aplicar, tome medidas antes que possa remover o nó:

- Se o nó tiver sido adicionado apenas usando a ID da Web, será necessário aplicar alterações pendentes antes que possa removê-lo. Se você o tiver adicionado usando a linha de comando, precisará configurá-lo com pelo menos um processo antes que você possa removê-lo.
- Se o nó incluir a única instância Repositório, você precisará mover o Repositório para outro nó. Consulte [Mover o processo de repositório](https://help.tableau.com/current/server/pt-br/distrib_rep_move.htm).
- Se o nó estiver executando a única instância do Armazenamento de arquivos, você precisará mudar o Armazenamento de arquivos para outro nó. Consulte [Mover o processo do Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/distrib_de_move.htm).
- Se o nó estiver executando uma instância do Serviço de coordenação, você deverá implantar um novo ensemble do Serviço de coordenação que não inclua o nó. Consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).
- Se o nó estiver executando Serviço de mensagens, você precisará mover o Serviço de mensagens para outro nó. Consulte [Mover o processo de serviço de mensagens](https://help.tableau.com/current/server/pt-br/distrib_msg_svc_move.htm).

> [!IMPORTANT]
> 
> **Importante:** não use o script `tableau-server-obliterate``.cmd` para remover o nó. Primeiro, remova o nó usando a interface do usuário do TSM UI ou o comando remove-nodes da topologia do tsm. Isso deixa o restante do cluster em um bom estado. Posteriormente, se quiser adicionar novamente o nó ao cluster, execute o script `tableau-server-obliterate``.cmd` no nó para remover completamente o Tableau. Após remover o Tableau do nó, reinicie o computador e adicione novamente o nó usando as etapas usuais para adicionar e configurar um nó. Para obter detalhes sobre a execução do script, consulte [Remover o Tableau Server do computador](https://help.tableau.com/current/server/pt-br/remove_tableau.htm).

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
    
    Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
2. Clique na guia Configuração e, no nó que deseja remover, clique em Remover nó:
    
    ![Botão Remover nó.](/tableau/current/pt-br/server/pt-br/Img/tsm-remove-node-btn.png)
    
    Se uma limitação de configuração não permitir a remoção do nó (se, por exemplo, ele incluir um Armazenamento de arquivos que deve ser desativado primeiro), será exibida uma mensagem com essa informação. Consulte **Pré-requisitos** acima para obter mais informações.
    
    **Observação:** se tiver acabado de adicionar o nó e o mesmo não tiver sido configurado, você deverá aplicar as alterações pendentes antes removê-lo.
3. Clique em Alterações pendentes no canto superior direito e em Aplicar alterações e reiniciar.

Use o comando `[tsm topology remove-nodes](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMRemoveNodes)` para remover um nó de um cluster.

Para remover um nó de um cluster, é necessário que ele tenha sido configurado com um processo em algum momento anterior. Se você adicionou um nó usando a CLI e deseja removê-lo, mas não configurou nenhum processo, deverá incluir um processo nele, executar o comando `[tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply)` e, em seguida, remover o nó. Por exemplo, você pode adicionar uma instância do Controlador de cluster ao nó: `tsm topology set-process -n <nodeID> -pr clustercontroller -c 1`.

Se estiver removendo um nó adicionado usando a interface do usuário da Web, o processo do Controlador de cluster será adicionado automaticamente para que você não precise adicioná-lo antes de remover o nó.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Encontre a ID do nó que você está alterando:
    
    `tsm topology list-nodes -v`
3. Remova um nó usando o comando remove-nodes.
    
    Por exemplo, para remover `node2` de um cluster existente:
    
    `tsm topology remove-nodes --node-names "node2"`
    
    Se uma limitação de configuração não permitir a remoção do nó (se, por exemplo, ele incluir um Armazenamento de arquivos que deve ser desativado primeiro), será exibida uma mensagem com essa informação. Consulte **Pré-requisitos** acima para obter mais informações.
4. Aplique as alterações:
    
    `tsm pending-changes apply`

<!-- document id=8b154bde7b33a4be76c6ba65f7727cc46c56157fd1a65298eade80b7c8861b25 url=/tableau/current/pt-br/server/plan_identity_store.md -->

[Pular para o conteúdo principal](#main-content)

# Repositório de identidades

O Tableau Server exige um repositório de identidades para gerenciar informações de usuário e de grupo. Há dois tipos de repositório de identidades: local e externo. Ao instalar o Tableau Server é necessário configurar um armazenamento de identidades local ou externo.

Para obter mais informações sobre as opções de configuração do repositório de identidades, consulte [Entidade identityStore](https://help.tableau.com/current/server/pt-br/entity_identity_store.htm) e [Referência de configuração do armazenamento de identidades externo](https://help.tableau.com/current/server/pt-br/ldap_config.htm). Para obter mais informações sobre como adicionar mais flexibilidade ao modelo de armazenamento de identidade única, consulte [Provisionar e autenticar usuários usando grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Armazenamento de identidades local

Ao configurar o Tableau Server com um armazenamento de identidades local, todas as informações de usuário e de grupo são armazenadas e gerenciadas no repositório do Tableau Server. No cenário de armazenamento de identidades local, não há fonte externa para usuários e grupos.

## Repositório de identidades externo

Ao se configurar o Tableau Server com um repositório externo, todas as informações de usuário e de grupo são armazenadas e gerenciadas por um serviço de diretório externo. O Tableau Server deve sincronizar com o repositório de identidades externo para que cópias locais dos usuários e dos grupos existam no repositório do Tableau Server, mas o repositório de identidades externo é a fonte dominante de todos os dados de usuário e de grupo.

Se você tiver configurado o repositório de identidades do Tableau Server para se comunicar com um diretório LDAP externo, todos os usuários (inclusive a conta de administrador inicial) adicionados ao Tableau Server deverão ter uma conta no diretório.

Quando o Tableau Server estiver configurado para usar um diretório LDAP externo, primeiro você deverá importar as identidades do usuário do diretório externo para o repositório do Tableau Server como usuários do sistema. Quando os usuários fazem logon no Tableau Server, as credenciais são passadas para o diretório externo, que é responsável pela autenticação do usuário; o Tableau Server não faz a autenticação. No entanto, os nomes de usuário do Tableau armazenados no repositório são associados a direitos e permissões do Tableau Server. Portanto, depois que a autenticação for verificada, o Tableau Server gerenciará o acesso do usuário (autorização) aos recursos do Tableau.

O Active Directory é um exemplo de um repositório externo de usuário. O Tableau Server é otimizado para fazer interface com o Active Directory. Por exemplo, ao instalar o Tableau Server em um computador vinculado a um domínio do Active Directory usando a [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm#tsm-ui-steps), a Instalação detectará e definirá a maioria das configurações do Active Directory. Se, por outro lado, você estiver usando a CLI do TSM para instalar o Tableau Server, especifique todas as configurações do Active Directory. Nesse caso, certifique-se de utilizar o modelo [LDAP - Active Directory](https://help.tableau.com/current/server/pt-br/entity_identity_store.htm#LDAP) para configurar o armazenamento de identidades.

Se você estiver instalando no Active Directory, instale o Tableau Server em um computador que esteja vinculado ao domínio do Active Directory. Além disso, recomenda-se rever o [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm) antes da implantação.

Para todos os outros armazenamentos externos, o Tableau Server suporta LDAP como forma de comunicação com o repositório de identidades. Por exemplo, OpenLDAP é uma da muitas implementações do servidor LDAP com um esquema flexível. O Tableau Server pode ser configurado para consultar o servidor OpenLDAP. Para isso, o administrador do diretório deve fornecer informações sobre o esquema. Durante a configuração, você deve usar a [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm#tsm-cli-steps) para configurar uma conexão com outros diretórios LDAP.

## Associação ao LDAP

Os clientes que desejem consultar um repositório de usuário com LDAP devem se autenticar e estabelecer uma sessão. Isso é feito por meio da associação. Há diversas formas de associação. A associação simples autentica com um nome de usuário e uma senha. Para empresas que se conectam ao Tableau Server com associação simples, recomendamos configurar uma conexão de SSL criptografada, caso contrário as credenciais são enviadas pela conexão em formato de texto simples. Outro tipo de associação compatível pelo Tableau Server é a associação GSSAPI. O GSSAPI usa o Kerberos para autenticação. No caso do Tableau Server, o mesmo é o cliente e o servidor LDAP é o repositório externo de usuário.

### Associação do LDAP com GSSAPI (Kerberos)

Recomendamos a vinculação ao diretório LDAP com o GSSAPI usando um arquivo keytab para autenticar ao servidor LDAP. Você precisará de um arquivo keytab especificamente para o serviço do Tableau Server. Também recomendamos criptografar o canal com o servidor LDAP usando SSL/TLS. Consulte [Configurar canal criptografado no armazenamento de identidade externo LDAP](https://help.tableau.com/current/server/pt-br/config_encrypt_ldap.htm).

Se a instalação for no Active Directory, e o computador onde estiver instalando o Tableau Server já estiver unido ao domínio, é possível que já tenha um arquivo de configuração e um arquivo keytab. Nesse caso, os arquivos do Kerberos são para funcionalidade e autenticação do sistema operacional. A rigor, você pode usar esses arquivos para associação GSSAPI, mas não recomendamos. Em vez disso, entre em contato com o administrador do Active Directory e solicite um keytab especificamente para o serviço do Tableau Server. Consulte [Saiba mais sobre os requisitos do Keytab.](https://help.tableau.com/current/server/pt-br/kerberos_keytab.htm).

Supondo que o sistema operacional tenha um keytab corretamente configurado para autenticação no domínio, o arquivo de chave do Kerberos para associação GSSAPI é tudo o que você precisa para a instalação básica do Tableau Server. Se você planeja usar a autenticação Kerberos para usuários, basta [configurar o Kerberos para autenticação do usuário](https://help.tableau.com/current/server/pt-br/config_kerberos.htm) e a [delegação do Kerberos para fonte de dados](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm) depois que a instalação estiver concluída.

### LDAP com SSL

Por padrão, o LDAP com associação simples aos servidores arbitrários do LDAP não é criptografado. As credenciais do usuário que são usadas para estabelecer a sessão de vinculação com o servidor LDAP são comunicadas em texto simples entre o Tableau Server e o servidor LDAP. Recomendamos fortemente que você criptografe o canal entre o Tableau Server e o servidor LDAP.

Se sua organização usar um diretório LDAP diferente do Active Directory, consulte [Configurar canal criptografado no armazenamento de identidade externo LDAP](https://help.tableau.com/current/server/pt-br/config_encrypt_ldap.htm).

## Autenticação de clientes

A autenticação básica de usuário no Tableau Server é feita por logon com nome de usuário e senha para os armazenamentos de usuário local e externo. No caso do repositório local, as senhas de usuário são armazenadas no repositório como uma senha com hash. No caso do repositório externo, o Tableau Server passa as credenciais para o repositório externo de usuário e aguarda a resposta para saber se elas são válidas. Os repositórios esternos de usuário também podem gerenciar outros tipos de autenticação, como o Kerberos ou SSPI (apenas no Active Directory), mas o conceito ainda é o mesmo: o Tableau Server delega as credenciais ou o usuário para o repositório externo e aguarda uma resposta.

É possível configurar o Tableau Server de forma que o nome de usuário e senha de logon sejam desabilitados. Nesses cenários, outros métodos de autenticação, como a autenticação confiável, OpenID ou SAML podem ser usados. Consulte [Autenticação](https://help.tableau.com/current/server/pt-br/security_auth.htm).

Em alguns casos, pode ser necessário atualizar os diretórios externos LDAP para permitir operações de associação com o formato nome de usuário + DN do Tableau Server. Consulte [Comportamento de associação do usuário ao fazer login](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm#User).

<!-- document id=88e7afd2b99efa7234d1454cd30a6b84c961eb83dee3841e1f2003e556ad7ddf url=/tableau/current/pt-br/server/server_process_repository.md -->

[Pular para o conteúdo principal](#main-content)

# Repositório do Tableau Server

O repositório do Tableau Server é um banco de dados que armazena dados do servidor. Estes dados incluem informações sobre usuários, grupos e atribuições de grupo, permissões, projetos, fontes de dados, pastas de trabalho e informações de metadados e atualização de extração do Tableau Server.

O repositório também é denominado repositório ou banco de dados _PostgreSQL_.

**Importante:** não modifique diretamente o repositório. Isso pode interromper o Tableau Server. Qualquer modificação do repositório feita pelo cliente tornará sua instalação incompatível com o Tableau.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Repositório</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do Repositório é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Registros gerados pelo repositório são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>pgsql</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Repositório ativo de preferência

Ao configurar o Tableau Server você tem a opção de especificar um nó como o repositório ativo de preferência. Quando o Tableau Server estiver configurado para failover de repositório, o nó do repositório ativo de preferência é aquele usado para o repositório ativo. Esta etapa é opcional, e caso um nó do repositório ativo de preferência não seja especificado, o Tableau Server irá selecionar o nó do repositório ativo ao iniciar.

Para configurar o repositório ativo de preferência, use o comando `tsm configuration set` para definir a opção `pgsql.preferred_host`:

`tsm configuration set -k pgsql.preferred_host -v "<host_name>"`

**Observação:** o `host_name` diferencia maiúsculas de minúsculas e deve corresponder ao nome do nó mostrado na saída do `tsm status -v`.

Configure um nó de repositório ativo de preferência se quiser que o Tableau Server selecione um nó específico ao iniciar. Você pode desejar fazer isso se tiver um servidor em particular que queira usar para seu repositório ativo (um computador com mais espaço no disco ou na memória, por exemplo), ou se estiver usando exibições administrativas personalizadas. Exibições administrativas personalizadas possuem informações de conexão inseridas que referem-se ao repositório para o qual as exibições foram criadas. Para obter mais informações sobre como se conectar ao repositório do Tableau Server, consulte [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm)

## O comando failoverrepository

Na ocorrência de failover, e se seu repositório passivo tornar-se seu repositório ativo, ele continuará sendo o repositório ativo até o Tableau Server reiniciar ou até você usar o comando `tsm topology failover-repository` para alternar de volta. Especifique o repositório que deseja que seja o ativo, ou especifique que o repositório ativo de preferência (se configurado) deve tornar-se ativo novamente. Para obter mais informações, consulte [tsm topology failover-repository](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMFailoverRepository).

<!-- document id=97f49e6005c50ba276ab2d4e31b35fd0e0d7bf5d268a3f20bd4a2947352ad14d url=/tableau/current/pt-br/server/server_external_repo.md -->

[Pular para o conteúdo principal](#main-content)

# Repositório externo do Tableau Server

O repositório do Tableau Server é um banco de dados do PostgreSQL que armazena os dados sobre todas as interações do usuário, atualizações de extração e muito mais.

O repositório pode ser instalado localmente nos mesmos nós do Tableau Server ou instalado externamente:

- **Repositório local:** o Banco de dados PostgreSQL é instalado e implantado localmente, o que significa que é instalado juntamente com o Tableau Server.
- **Repositório externo:** o Banco de dados PostgreSQL é implantado externamente. O repositório externo pode ser instalado no Amazon RDS, Banco de dados do Azure, Google Cloud ou como uma instalação autônoma.

Para obter mais informações sobre o Repositório do Tableau Server em geral, consulte:

- [Sobre o dicionário de dados do Tableau Server](https://help.tableau.com/current/server/pt-br/data_dictionary.htm)
- [Coletar dados com o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm)

Os hosts aceitos para o repositório externo são:

- Amazon RDS - A partir da versão 2019.3
- Banco de dados do Azure - A partir da versão 2020.4
- Instância PostgreSQL autônoma - A partir da versão 2021.2
- Instância do Google Cloud SQL para PostgreSQL - A partir da versão 2021.4

Este tópico é uma visão geral do repositório externo do Tableau Server.

## Considerações sobre repositório externo

O Amazon RDS e o Banco de dados do Azure oferecem melhor escalabilidade, confiabilidade, alta disponibilidade e segurança integrada para PostgreSQL. Ao se integrar mais com essas ofertas em nuvem, você poderá aproveitar esses benefícios adicionais.

Se você estiver configurando uma instância autônoma do PostgreSQL, deverá configurar e gerenciar a alta disponibilidade e escalonamento conforme necessário.

**Importante:** não modifique diretamente o repositório. Isso pode interromper o Tableau Server. Qualquer modificação do repositório feita pelo cliente tornará sua instalação incompatível com o Tableau.

### Cloud Platform

Ao usar uma plataforma de nuvem para hospedar seu repositório externo, você tem a opção de executar instâncias do PostgreSQL na infraestrutura hospedada e gerenciá-las ou escolher a opção de serviço totalmente gerenciado.

- **Autogerenciado:** configuração e gerenciamento de instâncias do PostgreSQL na infraestrutura hospedada por conta própria. Por exemplo, se você estiver usando AWS como sua plataforma de nuvem, poderá usar instâncias EC2 para executar, gerenciar e manter instâncias PostgreSQL.
- **Totalmente gerenciado:** selecione um serviço totalmente gerenciado. Por exemplo, se você estiver usando AWS como sua plataforma de nuvem, poderá usar a opção RDS para hospedar seu repositório externo.

Uma das principais considerações ao fazer uma escolha entre autogerenciado e totalmente gerenciado é que em uma opção autogerenciada você tem mais controle, mas com isso vem a responsabilidade de manter as VMs e muitas tarefas administrativas de banco de dados. Uma opção totalmente gerenciada oferece facilidade de instalação, gerenciamento de configuração e manutenção.

Aqui está uma lista mais abrangente de itens a serem considerados ao escolher entre os dois:

- Requisitos de configuração e manutenção.
- Alta disponibilidade e opções de recuperação de desastres
- Recursos de desempenho, escalabilidade e monitoramento
- Manutenção de segurança
- Custos operacionais, custos de serviço, custos de pessoal.

Aqui está um exemplo de como as duas opções podem ser comparadas para o Azure no site da Microsoft: [Escolha a opção de servidor PostgreSQL certa no Azure](https://docs.microsoft.com/en-us/azure/postgresql/overview-postgres-choose-server-options),

## Requisitos

- Seu Tableau Server deve utilizar as seguintes versões:
    
    - 2019.3 ou posterior, para usar com AWS
    - 2020.4 ou posterior, para usar com o Azure.
        
        Para obter a versão correta do PostgreSQL a ser usada, consulte [Banco de dados do Azure para servidor flexível PostgreSQL.](https://azure.microsoft.com/en-us/updates/azure-database-for-postgresql-flexible-server-now-in-preview/)
    - 2021.2 ou posterior para uso com a instância PostgreSQL autônoma. (Pode ser usado para instalações locais, VM do Azure ou AWS EC2).
    - 2021.4 ou posterior para usar com o Google Cloud para a instância PostgreSQL ou um PostgreSQL autônomo no Google Cloud VM.
- O Tableau Server deve ter as chaves Advanced Management ativadas.
- Dependendo de onde você está planejando hospedar o Repositório Externo, precisará se familiarizar com um dos seguintes:
    
    - Configuração e gerenciamento do banco de dados Amazon RDS.
    - Configuração e gerenciamento do Banco de Dados do Azure.
    - Configuração e gerenciamento do banco de dados PostgreSQL como uma instalação autônoma.
    - Configuração e gerenciamento de instância do Google Cloud PostgreSQL

## Versão

Você deve estar executando a versão correta do PostgreSQL para o Repositório do Tableau Server autônomo. A tabela a seguir mostra a compatibilidade da versão do Tableau Server.

**Observação:** a versão de compatibilidade máxima para qualquer versão do Tableau Server é a versão principal mínima ou qualquer atualização secundária dela. Por exemplo, se a versão mínima compatível do PostgreSQL for 13.4, a versão máxima compatível será 13.x, onde <x> é igual ou superior a 4.

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Versões do Tableau Server</th><th>Versões mínimas compatíveis com PostgreSQL</th></tr><tr><td><p>2022.3.0 - 2022.3.7</p><p>2023.1.0 - 2023.1.4</p></td><td>13.7</td></tr><tr><td>2022.1.17 - 2022.1.19<p>2022.3.8 - 2022.3.19</p><p>2023.1.5 - 2023.1.15</p><p>2023.3.0 - 2023.3.8</p></td><td>13.11</td></tr><tr><td>2022.3.20 - 2022.3.x<p>2023.1.16 - 2023.1.x</p><p>2023.3.9 - 2023.3.x</p></td><td>13.14</td></tr><tr><td>2024.0 - 2024.2.8</td><td>15.6</td></tr><tr><td>2024.2.9 - 2024.2.13<p>2025.1.0 - 2025.1.6</p></td><td>15,10</td></tr><tr><td>2024.2.14 - 2024.2.16 <p>2025.1.7 - 2025.1.9</p></td><td>15,13</td></tr><tr><td><p>2024.2.17</p><p>2025.1.10</p><p>2025.3 - 2025.3.5</p></td><td>15,14</td></tr><tr><td>2025.3.6</td><td>15,16</td></tr><tr><td><p>2026.2.x</p></td><td>17,7</td></tr></tbody></table>

## Topologia

**O diagrama abaixo é uma versão resumida da topologia do Tableau Server com Repositório externo.**

![Um diagrama que mostra a arquitetura de uma implantação do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tableau-server-external-repository-topology-summary.png)

**O diagrama abaixo é uma versão detalhada da topologia do Tableau Server com Repositório externo e mostra todos os processos instalados em cada nó.**

![Um diagrama que mostra a arquitetura de uma implantação do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/tableau-server-external-repository-topology-detailed.png)

## Gerenciamento do repositório externo

### Gerenciamento de licenças

Para habilitar esse recurso, você deve primeiro ativar Advanced Management no Tableau Server. Para obter mais informações, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm). Se você não tiver Advanced Management ativado ou se a licença expirou, você verá o seguinte comportamento:

- Se tentar configurar o Tableau Server para usar o repositório externo durante a instalação, você verá uma mensagem de erro, mas poderá continuar a instalação e o repositório do Tableau Server será instalado localmente. Para instalações de servidor único, o repositório é instalado na mesma máquina do Tableau Server. Para instalações de vários nós, o repositório é instalado em um dos nós do cluster do Tableau Server.
- Se você já estiver usando um Repositório do Tableau Server externo na instalação do Tableau Server e a licença do Advanced Management expirar, o servidor falhará ao reiniciar. Se você não tiver mais recursos do Advanced Management, mas tiver uma licença válida do Tableau Server, ainda poderá criar um backup. Você também pode migrar o repositório externo para repositório local, o que não requer Advanced Management para que o servidor funcione novamente. Para obter mais informações sobre como migrar do repositório externo para o repositório local, consulte [Reconfigurar o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo_reconfigure.htm).

### Cenários de migração compatíveis

- Transferência do repositório do local para externo.
- Transferência do repositório de externo para o local

### Backup e restauração

Se você tiver apenas o Repositório externo configurado:

O processo de backup e restauração continua o mesmo para repositório local e externo e conforme descrito no tópico de dados [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm).

- Os comandos de backup e restauração funcionam da mesma maneira para repositório local e externo. O backup no caso em que o Tableau Server usa o repositório externo exige mais espaço em disco para backup, portanto, você deve se lembrar disso ao configurar o espaço em disco.
- O padrão e outros locais compatíveis para armazenar o arquivo de backup são os mesmos, se o repositório for local ou externo.

As exceções a seguir se aplicam aos Tableau Servers que utilizam repositório externo:

- Todas as contas de usuário personalizadas criadas no Repositório do Tableau Server externo serão incluídas na restauração, mas as senhas das contas de usuário personalizadas não. As senhas deverão ser reconfiguradas após a conclusão da restauração. As contas de usuário personalizadas são contas de usuário do banco de dados PostgreSQL, utilizadas pelo SQL ou outro software cliente do banco de dados, para conectar-se ao banco de dados PostgreSQL.
    
    **Nota:** estas contas personalizadas serão desativadas como medida de segurança, mas isso pode ser reconfigurado.
- A configuração e a topologia não devem ser incluídas no backup. Para obter mais informações sobre como exportar a configuração e as definições de topologia, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).

**Se você tiver o Repositório externo e o Armazenamento de arquivos externos configurados:**

Você tem algumas opções se tiver o Repositório externo e o Armazenamento de arquivos externos configurados para o Tableau Server. Essas opções permitem que você aproveite os recursos de backup instantâneo das plataformas de nuvem utilizadas para hospedar o Repositório externo e o Armazenamento de arquivos. Para obter mais informações e instruções em etapas detalhadas, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm).

### Conexões SSL

Você tem a opção de exigir ou não conexões TLS/SSL do Tableau Server para o Repositório externo.

Se você não precisar usar conexões criptografadas, deverá configurar o Repositório Externo para permitir conexões não criptografadas e usar a opção -`-no-ssl` ao configurar o Repositório Externo para o Tableau Server. Para obter mais informações, consulte [tsm topology external-services repository enable](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMExternalRepoEnable).

Se desejar ativar ou desativar o SSL posteriormente, após a instalação, use [tsm security repository-ssl enable](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#postres-ssl-enable) ou [tsm security repository-ssl disable](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#sm%20security%20repository-ssl%20disable) . Esta opção está disponível a partir de 2021.4.

#### Atualizar o Certificado SSL

Se, como parte de um vencimento planejado do certificado SSL da instância RDS, Banco de dados do Azure, a instância Google Cloud PostgreSQL ou instância autônoma do PostgeSQL, você precisa atualizar sua instância RDS com o novo arquivo de certificado, também precisa atualizar as configurações do Tableau Server para usar o novo arquivo de certificado. Você pode fazer isso ao baixar o arquivo mais recente e executar o comando _tsm topology external-services repository replace-host_ e fornecer o novo arquivo de certificado.

## Considerações de alta disponibilidade

O Tableau Server não gerencia ou configura a alta disponibilidade para o repositório externo.

- **AWS:** o Amazon RDS oferece recursos que podem ser usados para fornecer alta disponibilidade e gerenciar o failover. Para obter mais informações, consulte [Alta disponibilidade do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.MultiAZ.html).
- **Azure:** o Azure oferece recursos que podem ser usados para fornecer alta disponibilidade gerenciar failover. Para obter mais informações, consulte [Alta disponibilidade do Banco de dados do Azure](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-hyperscale-high-availability).
- **Google Cloud:** o Google Cloud oferece recursos que podem ser usados para fornecer alta disponibilidade e gerenciar o failover. Para obter mais informações, consulte [Alta disponibilidade do Google Cloud](https://cloud.google.com/sql/docs/postgres/high-availability).
- **Instância autônoma do PostgreSQL:** o PostgreSQL oferece vários recursos que podem ser usados para fornecer alta disponibilidade e gerenciar o failover. Para obter mais informações, consulte [Alta disponibilidade do PostgreSQL](https://www.postgresql.org/docs/current/high-availability.html).

## Considerações de atualização

Isso só se aplica se você estiver usando a configuração do Repositório externo com o Tableau Server.

Se você estiver usando um Repositório externo, pode ser necessário executar etapas adicionais ao atualizar:

- **Nenhuma alteração de versão** — Se não houver alteração de versão no PostgreSQL, não serão necessárias ações especiais.
- **Alteração de versão secundária** — Se houver uma alteração de versão secundária no PostgreSQL, você precisará atualizar seu repositório externo antes de atualizar o Tableau Server. Na maioria dos casos, existem métodos no local para fazer isso. O método que você usa depende da localização do seu repositório e está além do escopo desta documentação.
- **Alteração de versão principal** — Se houver uma alteração de versão principal no PostgreSQL, você precisará seguir as etapas descritas em [Atualizar o Tableau Server com Repositório Externo para uma nova versão principal do PostgreSQL.](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm).
    
    As etapas incluem:
    
    1. Crie uma nova instância do banco de dados PostgreSQL. Para obter mais informações, consulte:
        - [Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_RDS.htm)
        - [Criar uma instância PostgreSQL do banco de dados do Azure no Azure](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_Azure.htm)
        - [Criar uma instância Cloud SQL para PostgreSQL no Google Cloud](https://cloud.google.com/sql/docs/postgres/create-instance)
        - [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm)
    2. Crie um arquivo de configuração e baixe o arquivo de certificado SSl para a nova instância que você criou na Etapa 1.
    
    Durante a atualização, você precisará apontar o Tableau Server para a nova instância usando o arquivo de configuração. O processo de atualização migrará o conteúdo do repositório externo atual para a nova instância. Para obter mais detalhes, consulte [Atualizar o Tableau Server com Repositório Externo para uma nova versão principal do PostgreSQL.](https://help.tableau.com/current/server/pt-br/server_external_repo_upgrade_postgres.htm).

## Monitoramento do status do repositório

A página de status do TSM mostrará o serviço externo do Tableau Server como um nó adicional para a instalação do Tableau Server.

![Processos do Tableau Server e seus status.](/tableau/current/pt-br/server/pt-br/Img/server_external_repo_tsm_status.png)

A guia de topologia indica se há serviços externos do Tableau Server configurados:

![Uma página de configuração no Tableau Server com uma lista de serviços externos.](/tableau/current/pt-br/server/pt-br/Img/server_external_repo_topology.png)

## Obtenção de registros

Os registros do Tableau Server não incluirão os do repositório externo. Use as seguintes maneiras para obter os registros específicos para sua instância:

- **AWS:** para obter informações sobre como configurar registros para sua instância do PostgreSQL do Amazon RDS, consulte [Arquivos de registro do banco de dados PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.Concepts.PostgreSQL.html).
- **Azure:** para obter informações sobre a configuração do registro para o seu banco de dados Azure para instâncias PostgreSQL, consulte [Regisros no banco de dados do Azure para PostgreSQL.](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-server-logs)
- **Google Cloud:** para obter informações sobre como visualizar e consultar os registros da sua instância PostgreSQL, consulte o [registro do Cloud SQL](https://cloud.google.com/sql/docs/postgres/logging).
- **Instância autônoma do PostgreSQL:** paraobter informações sobre como configurar o registro para sua instância autônoma do PostgreSQL, consulte [Relatório de erros e registro](https://www.postgresql.org/docs/12/runtime-config-logging.html).

## Próximas etapas

- Você pode realizar uma das seguintes ações para criar uma instância de banco de dados PostgreSQL:
    
    - [Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_RDS.htm)
    - [Criar uma instância PostgreSQL do banco de dados do Azure no Azure](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_Azure.htm)
    - [Criar uma instância PostgreSQL no Google Cloud](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_gcp.htm)
    - [Criar um banco de dados PostgreSQL como uma instalação autônoma](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm)
- [Instalar o Tableau Server com o repositório PostgreSQL externo](https://help.tableau.com/current/server/pt-br/server_external_repo_new_install.htm)
- [Reconfigurar o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo_reconfigure.htm)
    
    - Migrar de local para externo
    - Migrar de externo para local

## Outros artigos nesta seção

<!-- document id=71dced2536e08f73538e63095b01028c99353795bdf3d3fb35aaca2e47aef8e1 url=/tableau/current/pt-br/server/rmt-external-repo.md -->

[Pular para o conteúdo principal](#main-content)

# Repositório externo para Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau usa um banco de dados PostgreSQL como seu repositório para coletar e armazenar dados de monitoramento do Tableau Server usados para fornecer informações de desempenho e uso. Este banco de dados é separado do banco de dados do Tableau Server.

Antes da versão 2022.3, esse repositório PostgreSQL era instalado automaticamente com o RMT Server, na mesma máquina do RMT Server e essa era a única opção disponível. A partir da versão 2022.3, você pode reconfigurar o RMT Server para usar um banco de dados PostgreSQL hospedado externamente em vez do banco de dados instalado localmente. Quando o RMT Server é configurado para usar um banco de dados PostgreSQL hospedado externamente, nos referimos a ele como repositório externo.

A plataforma compatível para hospedar o repositório externo é uma instância da AWS RDS. Hospedar o banco de dados do repositório externamente permite que você gerencie a disponibilidade, os backups e a recuperação de desastres do componente do repositório do RMT Server.

Com a adição desta opção para configurar um repositório externo, o RMT Server pode ser configurado das seguintes formas:

- **Continue a usar o repositório instalado localmente:** isso significa que o banco de dados PostgreSQL instalado automaticamente com o RMT Server na mesma máquina será usado como repositório para o RMT Server, e nenhuma outra alteração será feita nesta configuração.
- **Configure o RMT Server para usar um repositório externo:** isso significa que o banco de dados PostgreSQL que o RMT usa está hospedado fora do RMT Server. Isso requer fazer algumas alterações de configuração após a instalação. Atualmente, apenas instâncias do AWS RDS têm suporte como plataforma de hospedagem para o banco de dados PostgreSQL.

Para configurar e gerenciar o repositório externo, você deve ter um bom conhecimento da plataforma AWS RDS e do banco de dados PostgreSQL. Recomendamos que você use a [documentação no site da AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html) para obter instruções relacionadas à plataforma.

Você também precisará saber como configurar e gerenciar a configuração do repositório externo paraResource Monitoring Tool . Este tópico fornecerá essas informações nas seções abaixo.

## Nova instalação do Resource Monitoring Tool

As instruções detalhadas nesta seção se aplicam a uma nova instalação do Resource Monitoring Tool. Se você tiver uma implantação existente do RMT e quiser migrar para uma configuração de repositório externo, consulte a seção de instalação [Instalação existente do Resource Monitoring Tool](#Migratin) deste tópico.

Quando você instala o RMT Server, ele instala automaticamente o banco de dados do repositório na mesma máquina que o RMT Server. O processo para configurar o repositório externo é uma configuração pós-instalação onde você reconfigurará o RMT Server para usar um banco de dados PostgreSQL hospedado externamente.

Use as etapas a seguir para instalar o Resource Monitoring Tool e reconfigure o RMT Server para usar um repositório externo:

1. **Crie o repositório externo:** crie uma instância do RDS para hospedar o repositório externo com as seguintes recomendações.
    
    - **Especificações mínimas recomendadas da instância do PostgreSQL:**
        
        - db.m6g.2xlarge (8 vcpu, 32 GiB RAM)
        - Armazenamento SSD com 500 GB de espaço em disco
    - **Valores de configuração da instância:**
        - Máximo de processos de trabalho: Total de processadores lógicos
        - Máximo de trabalhadores por reunião: Mín.(Total de processadores lógicos / 2, 4)
        - Máximo de trabalhadores paralelos: Total de processadores lógicos
        - Máx. de trabalhadores de manutenção paralela: Mín.(Total de processadores lógicos / 2, 4)
        - Buffers compartilhados: memória total / 4
        - Tamanho efetivo do cache: 75% da memória total
        - Memória de trabalho de manutenção: Memória total / 16 Linux, Máx. 2GB - 1MB no Windows
        - Wal Buffers: derivados de buffers compartilhados, provavelmente em torno de 16 MB
        - Memória de trabalho: derivada de buffers compartilhados e máximo de trabalhadores por reunião
    
    Para saber como criar e conectar-se a uma instância de banco de dados PostgreSQL na AWS, consulte [esta página no site de documentação da AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html) .
2. **Instale o RMT:** siga as instruções [Instalar o RMT Server usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install-cli.htm) para instalar o RMT Server, mas **ignore as etapas para criar um ambiente. Você fará isso depois de configurar o RMT Server para usar o repositório externo** . **Observe que isso instalará inicialmente um banco de dados PostgreSQL local.**
3. **Teste a conexão com o repositório externo:** teste a conexão com o novo banco de dados usando o psql, uma ferramenta administrativa do PostgreSQL que é instalada com o RMT Server;
    
    - Navegue até a pasta 'bin' do diretório de instalação do PostgreSQL instalado localmente.
        
        `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin`
    - Execute o seguinte comando para testar a conexão: Substitua seu próprio valor abaixo por **aws\_rds\_servername** e forneça a senha do PostgreSQL que você criou na AWS quando solicitado.
        
        .`\psql.exe -h <aws_rds_servername> -p 5432 -d postgres -U postgres`
        
        Se você receber um erro neste momento e não conseguir se conectar, revise os valores de parâmetro no comando em relação aos valores do console do AWS RDS.
    - Quando a conexão tiver sido estabelecida com sucesso, você pode fechar a sessão do psql com o seguinte comando:
        
        `\q`
4. Execute `rmtadmin master-setup` **para configurar o RMT Server para usar o repositório externo**. Use os exemplos de comando a seguir e edite o comando para refletir seu caminho de instalação do Resource Monitoring Tool, nome da instância do AWS RDS, número da porta e a senha do usuário administrador do RDS PostgreSQL:
    
    - Navegue até o diretório de instalação do RMT Server do Resource Monitoring Tool:
        
        `cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'`
    - Execute o comando para configurar o repositório externo:
        
        `./rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>`
5. Agora **crie um ambiente** e baixe o arquivo bootstrap:
    
    - Execute o seguinte comando para criar um ambiente:
        
        `rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>`
    - Faça download do arquivo de bootstrap para registrar os Agentes:
        
        `rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>`
        
        As etapas são descritas em detalhes aqui: [Instalar o RMT Server usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install-cli.htm).
6. Siga as instruções em [Instalar o Agente usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install-cli.htm) para instalar e registrar agentes nos nós do Tableau Server.

## Instalação existente do Resource Monitoring Tool

Há dois caminhos para migrar instalações RMT existentes que estão atualmente usando um repositório local para um repositório externo: o caminho escolhido depende do tamanho e da complexidade do seu ambiente.

1. **Migração com recriação de ambiente:** isso é adequado para instalações RMT que possuem um ambiente de pequeno porte com pouca configuração e alertas, pois esse caminho envolve recriar o ambiente e iniciar novamente e perderá os dados coletados até o momento.
    
    Também é necessário reconfigurar o RMT Server para usar um repositório externo, recriar os ambientes e refazer todas as configurações personalizadas, como limites de incidentes, e registrar novamente os Agentes. Isso é muito semelhante a fazer uma nova instalação do RMT descrita [na seção acima,](#New) exceto que você não instalará o RMT neste caso.
2. **Migração manual com perda mínima de dados:** é especificamente para clientes que têm ambientes grandes e complexos e não desejam começar do zero novamente. Essa migração é manual e não é um recurso de migração integrado para RMT. As instruções para fazer isso estão descritas abaixo:
    
    ### Migrando manualmente o repositório do Resource Monitoring Tool local para uma instância de banco de dados AWS PostgreSQL externo
    
    #### **Etapa 1: crie uma instância do RDS para hospedar o repositório externo**
    
    Use as seguintes recomendações ao criar a nova instância do RDS:
    
    - **Especificações mínimas recomendadas da instância do PostgreSQL:**
        
        - db.m6g.2xlarge (8 vcpu, 32 GiB RAM)
        - Armazenamento SSD com 500 GB de espaço em disco
    - **Valores de configuração da instância:**
        - Máximo de processos de trabalho: Total de processadores lógicos
        - Máximo de trabalhadores por reunião: Mín.(Total de processadores lógicos / 2, 4)
        - Máximo de trabalhadores paralelos: Total de processadores lógicos
        - Máx. de trabalhadores de manutenção paralela: Mín.(Total de processadores lógicos / 2, 4)
        - Buffers compartilhados: memória total / 4
        - Tamanho efetivo do cache: 75% da memória total
        - Memória de trabalho de manutenção: Memória total / 16 Linux, Máx. 2GB - 1MB no Windows
        - Wal Buffers: derivados de buffers compartilhados, provavelmente em torno de 16 MB
        - Memória de trabalho: derivada de buffers compartilhados e máximo de trabalhadores por reunião
    
    Para saber como criar e conectar-se a uma instância de banco de dados PostgreSQL na AWS, consulte [esta página no site de documentação da AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html) .
    
    #### Etapa 2: teste para garantir que você possa se conectar ao novo banco de
    
    Teste a conexão com o novo banco de dados usando psql, uma ferramenta administrativa do PostgreSQL que acompanha o RMT Server. Substitua seu próprio valor abaixo por **aws\_rds\_servername** e forneça a senha do PostgreSQL que você criou na AWS quando solicitado.
    
    - Navegue até a pasta 'bin' do diretório de instalação do PostgreSQL instalado localmente.
        
        `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin`
    - Execute o seguinte comando para testar a conexão: Substitua seu próprio valor abaixo por **aws\_rds\_servername** e forneça a senha do PostgreSQL que você criou na AWS quando solicitado.
        
        .`\psql.exe -h <aws_rds_servername> -p 5432 -d postgres -U postgres`
        
        Se você receber um erro neste momento e não conseguir se conectar, revise os valores de parâmetro no comando em relação aos valores do console do AWS RDS.
    - Quando a conexão tiver sido estabelecida com sucesso, você pode fechar a sessão do psql com o seguinte comando:
        
        `\q`
    
    #### Etapa 3: obtenha a senha de administrador do banco de dados PostgreSQL local atualmente usado pelo RMT
    
    Execute os comandos a seguir para obter a senha de administrador do repositório local. Isso é necessário para fazer um backup dos dados em seu repositório local antes de fazer a migração.
    
    - Navegue até a pasta de instalação do RMT Server:
        
        `cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'`
    - Obtenha a senha do administrador:  
        
        `rmtadmin get db.adminPassword`
    
    ####   
    Etapa 4: faça um backup do banco de dados PostgreSQL existente
    
    - Primeiro, pare o RMT em preparação para fazer o backup do banco de dados:
        
        `rmtadmin stop`
    - Agora reinicie apenas o serviço de banco de dados para que você possa fazer o backup:
        
        `rmtadmin start -db`
    - Use os scripts de exemplo a seguir e substitua seus próprios valores pelo caminho do arquivo. Se você personalizou a porta, atualize-a também. Forneça a senha da etapa anterior quando solicitado:
        - Navegue até a pasta bin do repositório local:
            
            `cd 'C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin'`
    - Faça um backup:
        
        `pg_dump -f your_file_name.dump -F d -j 10 -Z 5 -d tabrmt -h localhost -p 5555 -U postgres`
        
        - `-F d`: gera um arquivo em formato de diretório adequado para entrada no pg\_restore
        - `-j 10`: executa o backup em paralelo fazendo backup de 10 tabelas simultaneamente
        - `-Z 5`: especifica o nível de compactação a ser usado
    
    **Observação:** os dados recolhidos pelo Resource Monitoring Tool no momento entre esta etapa e a última não serão retidos após a conclusão da migração.
    
    #### Etapa 5: configure o RMT Server para apontar para o repositório externo
    
    - Reinicie todos os serviços RMT:
        
        `rmtadmin restart --all`
    - Use o seguinte comando como exemplo. Edite o comando para refletir o nome do RDS Server, o nome do banco de dados, a porta e a senha do usuário postgres do RDS.
        
        Navegue até a pasta de instalação do RMT Server:
        
        `cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'`
        
        Configure o repositório externo:
        
        `rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>`
    
    #### Etapa 6: restaure o backup para o repositório externo
    
    - Primeiro, pare o RMT Server:
        
        `rmtadmin stop`
    - Restaure o backup que você criou na etapa 4 para a nova instância da AWS RDS PostgreSQL. Edite o script de exemplo fornecido abaixo para refletir o nome e a porta do servidor AWS RDS e verifique se o caminho e o nome do arquivo de despejo estão corretos. Quando solicitado, forneça a senha para o usuário "postgres" no RDS.
        
        `pg_restore -j 5 -c -h <aws_rds_servername> -p 5432 -U postgres -d tabrmt <your_file_name>.dump`
        
        - `-j 5`: executa a restauração em paralelo restaurando 5 tabelas simultaneamente
        - `-c`: limpa (elimina) objetos de banco de dados antes de recriá-los
    
    #### Etapa 7: inicie o RMT Server.
    
    `rmtadmin start`
    
    #### Etapa 8: registre novamente os agentes
    
    Depois que as alterações de serviço forem executadas com sucesso, reinicie cada Agente e registre-o novamente usando a interface da Web, seguindo as etapas abaixo.
    
    1. Baixe um novo arquivo de bootstrap do RMT Server.
    2. Acesse a interface da Web do Agente navegando até http://localhost:9002/setup/register, importe o bootstrap.
    3. Clique em Testar fila de mensagens. Revise as entradas anteriores se você receber um erro.
    4. Clique em Conectar-se à fila de mensagens.
    5. Na seção Servidor, clique no menu suspenso com “Novo servidor de ambiente” pré-selecionado e, em vez de aceitar o padrão, escolha o servidor que você está tentando registrar na lista. Role a página até a parte inferior e clique no botão "Registrar agente".
    
    Para obter mais detalhes ou registrar agentes, consulte [Instalar o Agente usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install-cli.htm).
    
    #### Etapa 9: verifique se o RMT Server está em execução e se você está vendo os dados históricos
    
    Faça login no RMT Server e verifique se os dados de períodos mais antigos estão presentes e se os novos dados estão sendo processados. Revise também quaisquer valores de configuração personalizados para garantir que tudo seja migrado corretamente.

## Práticas recomendadas de atualização

Aqui estão as etapas gerais que você precisa seguir se quiser atualizar a Resource Monitoring Tool do Tableau e migrar para um repositório externo ao mesmo tempo:

**Migração com recriação do ambiente:**

1. [Atualize o RMT Server e todos os agentes](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade.htm) para 2022.3 ou posterior.
2. As etapas de 2 a 4 são muito semelhantes às etapas que você faria para fazer uma nova instalação - consulte [Nova instalação do Resource Monitoring Tool](#New) acima. Isso envolve principalmente:
    - Criar uma instância de banco de dados AWS PostgreSQL.
    - Configurar o RMT Server para usar um repositório externo.
    - Recriar ambientes e registre novamente todos os Agentes.
3. Reconfigurar quaisquer configurações personalizadas.

**Observação:** você perderá dados históricos e também precisará reconfigurar qualquer configuração personalizada.

Migração manual com perda mínima de dados:

1. [Atualize o RMT Server e todos os agentes](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade.htm) para a versão 2022.3 ou posterior.
2. Siga as etapas detalhadas na [seção de migração](#Manually). Isso envolve principalmente:
    - Criar uma instância de banco de dados AWS PostgreSQL.
    - Fazer um backup do banco de dados PostgreSQL.
    - Configurar o RMT Server para usar o repositório externo (instância de banco de dados PostgreSQL).
    - Restaurar o backup para o repositório externo.
    - Registrar novamente os agentes.

### Atualizando quando a nova versão do RMT requer uma atualização do PostgreSQL da versão principal

Quando há uma mudança no requisito de versão principal do PostgreSQL para Resource Monitoring Tool, é uma prática recomendada atualizar a versão do PostgreSQL do repositório externo antes de atualizar o Resource Monitoring Tool. Mais detalhes são fornecidos abaixo. Para ver se você deve atualizar a versão do PostgreSQL do seu repositório externo, consulte a [tabela de compatibilidade do produto](#product-compat).

Use as etapas a seguir para atualizar o RMT e a instância RDS quando uma atualização de versão principal do PostgreSQL for necessária

1. Faça um backup da sua instância do RDS. Você precisará disso caso precise reverter a atualização. Para obter mais informações, consulte o tópico [Backup e restauração de uma instância de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_CommonTasks.BackupRestore.htm) no site da AWS.
2. Faça uma cópia do arquivo de configuração no diretório do Resource Monitoring Tool. O arquivo de configuração está localizado em:
    
    `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json`
3. Atualize a instância do RDS para a nova versão do PostgreSQL Para obter mais informações, consulte o tópico [Atualizando o mecanismo de banco de dados PostgreSQL para Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.PostgreSQL.html) no site da AWS.
4. Atualização do RMT Server. Se a atualização, incluindo a migração do banco de dados, for concluída com êxito, vá para a próxima etapa. Se a atualização falhar, consulte as instruções nesta seção sobre como recuperar e reverter a atualização.
5. Atualize todos os agentes nos nós do Tableau Server para a nova versão RMT. Para obter mais informações, consulte [Atualização do Resource Monitoring Tool](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade.htm).

#### Recuperando-se de uma atualização com falha

1. Desinstale o RMT Server atualizado.
2. Restaure a instância do AWS RDS para a versão anterior à atualização. Para obter mais informações, consulte o tópico [Backup e restauração de uma instância de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_CommonTasks.BackupRestore.htm) no site da AWS.
3. Substitua o arquivo de configuração do qual você fez backup antes da atualização no local a seguir. Talvez seja necessário criar esta pasta, pois ela pode ter sido excluída durante a desinstalação:
    
    `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json`
4. Instale o RMT Server que instala um repositório local.
5. Configure o RMT Server para usar um repositório externo:
    
    `rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>`

### Compatibilidade de versão RMT e PostgreSQL

Esta tabela lista apenas a versão RMT 2022.3 e posterior, pois o repositório externo só está disponível a partir da versão 2022.3 e posterior.

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td>Versão do RMT</td><td>Versão do PostgreSQL enviada com RMT</td><td>Versão do PostgreSQL com suporte para repositório externo</td></tr><tr><td>2022.3 - 2024.2</td><td>13.7</td><td>13.7</td></tr><tr><td>2025.0 - 2025.3.2</td><td>15,6</td><td>15.6</td></tr><tr><td>2025.3.3 - 2026.x</td><td>15,14</td><td>15,14</td></tr></tbody></table>

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.
- Resource Monitoring Tool Conta de administrador.

<!-- document id=90f7c17810d332099fef8908b0adfef2b14b69cfecc39d0d5b95e0e559ca3d20 url=/tableau/current/pt-br/server/impers_SQL.md -->

[Pular para o conteúdo principal](#main-content)

# Representação com credenciais SQL inseridas

Também é possível executar a representação tendo a pessoa que publica uma exibição inserindo suas respectivas credenciais de conta do SQL Server na exibição. O Tableau Server pode ser executado sob qualquer tipo de conta, mas ele usará essas credenciais, fornecidas pelo editor, para se conectar ao banco de dados.

Essa pode ser a escolha certa para seu site se a conta que manipula a representação não puder ser uma conta do Active Directory (AD) e se você se sentir à vontade fornecendo aos editores da pasta de trabalho uma conta com um nível de permissão potencialmente alto no SQL Server.

**Observação:**

Para usar essa abordagem, as [Credenciais inseridas](https://help.tableau.com/current/server/pt-br/maintenance_set.htm) devem ser habilitadas na página Configurações do servidor no Tableau Server:

![Uma caixa de seleção para habilitar credenciais inseridas.](/tableau/current/pt-br/server/pt-br/Img/embedded.png)

Para representar com a conta do SQL do publicador da pasta de trabalho:

1. No Tableau Desktop, crie uma pasta de trabalho. Ao criar a conexão de dados, selecione Use um nome de usuário e uma senha específicos para a conexão ativa da pasta de trabalho com um banco de dados do SQL Server:
    
    ![Janela de configuração de conexão do SQL Server com a opção de fazer logon no servidor usando um nome de usuário e senha específicos selecionados.](/tableau/current/pt-br/server/pt-br/Img/impers_SQL_sql.png)
2. Publique a pasta de trabalho no Tableau Server (Servidor > Publicar pasta de trabalho).
3. Na caixa de diálogo Publicar, clique em Autenticação e, na caixa de diálogo Autenticação, selecione Representar por meio da senha inserida na lista suspensa:
    
    ![Caixa de diálogo de autenticação com a opção “Representar por meio de senha inserida” circulada.](/tableau/current/pt-br/server/pt-br/Img/impers_sql_publish.png)
4. Clique em OK.
5. Teste a conexão entrando no Tableau Server como um usuário. Ao clicar em uma exibição, você não deve ser solicitado a fornecer credenciais de banco de dados e deve ver apenas os dados que o usuário está autorizado a ver.

<!-- document id=399d1c9f3621171eb3d5d552efaa8d60f1c49b6baf6d3a1f850eb82844bceaa1 url=/tableau/current/pt-br/server/impers_runas.md -->

[Pular para o conteúdo principal](#main-content)

# Representação com uma conta de serviço Run As

A representação por meio de uma conta de serviço Run As é a maneira recomendada de executar a representação. A conta de serviço Run As é uma conta de usuário do Active Directory que o serviço do Tableau Server pode executar na máquina que o hospeda (consulte [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm)). Essa mesma conta deve ter a permissão IMPERSONATE para as contas de usuário do banco de dados no SQL Server. Do ponto de vista de segurança de dados, usar a conta de serviço Run As do Tableau Server para representação fornece ao administrador mais controle.

Para configurar a representação com uma conta de usuário Run As:

1. Ao configurar o Tableau Server durante a instalação, selecione Active Directory como o armazenamento de identidade e especifique a conta de usuário com a permissão IMPERSONATE (REPRESENTAÇÃO) como a conta de serviço Run As. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).
    
    Se você instalou o Tableau Server com o repositório de identidades configurado para usar o Active Directory, poderá definir a conta de serviço Run As após a instalação. Consulte [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm).
2. Crie uma pasta de trabalho no Tableau Desktop. Ao criar a conexão de dados, selecione Use a segurança integrada do Windows NT para a conexão ativa da pasta de trabalho com um banco de dados do SQL Server.
    
    ![Janela de configuração de conexão do SQL Server com a opção de fazer logon no servidor usando a segurança integrada do Windows NT selecionada.](/tableau/current/pt-br/server/pt-br/Img/impers_runas_nt.png)
3. No Tableau Desktop, publique a pasta de trabalho no Tableau Server (Servidor > Publicar pasta de trabalho).
4. Na caixa de diálogo Publicar, clique em Autenticação e, na caixa de diálogo Autenticação, selecione Representar por meio da conta Run As do servidor na lista suspensa:
    
    ![Caixa de diálogo de autenticação com a opção “Representar via conta Executar como do servidor” circulada.](/tableau/current/pt-br/server/pt-br/Img/impers_runas_publish.png)
5. Clique em OK.
6. Teste a conexão entrando no Tableau Server como um usuário. Ao clicar em uma exibição, você não deve ser solicitado a fornecer credenciais de banco de dados e deve ver apenas os dados que o usuário está autorizado a ver.

<!-- document id=91658bbcfa45d86af394905845d70cbef975dd0f7cb3dd2c5f271f6e796eb1c4 url=/tableau/current/pt-br/server/impers.md -->

[Pular para o conteúdo principal](#main-content)

# Representação do SQL Server

A representação no contexto do Tableau Server significa permitir que uma conta de usuário atue em nome de outra conta de usuário. Você pode configurar o Tableau e o Microsoft SQL Server para executarem a representação de usuários de banco de dados, de modo que a conta de banco de dados do SQL Server usada pelo Tableau Server faz consultas em nome dos usuários do banco de dados do SQL Server, que também são usuários do Tableau.

O principal benefício desse recurso é que ele permite aos administradores implementar e controlar a respectiva política de segurança de dados em um local: nos respectivos bancos de dados. Quando os usuários do Tableau acessam uma exibição com uma conexão ativa com um banco de dados do SQL Server, a exibição mostra apenas o que as permissões de banco de dados dos usuários permitem que eles vejam. Um benefício adicional é que os usuários não precisam responder a uma solicitação de logon do banco de dados quando abrirem a exibição. Além disso, os editores da pasta de trabalho não precisam depender de filtros específicos de usuário para restringir o que é visto nas exibições.

## Outros artigos nesta seção

<!-- document id=53cb018b8e5a4826d4e0596df31985ea36766bb48a1e93949b65d8e3b15d90eb url=/tableau/current/pt-br/server/runas_domain.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos de confiança de domínio para implantações do Active Directory

Quando você executa o Tableau Server em um ambiente do Active Directory em vários domínios (na mesma floresta do Active Directory ou em florestas diferentes), alguns recursos do Tableau dependem da relação de confiança entre os domínios. Por exemplo, alguns administradores gerenciam usuários em domínios separados de onde implementam aplicativos de servidor, como o Tableau Server. Em outras empresas, uma implementação do Tableau Server pode ser compartilhada com parceiros externos ou parceiros diferentes na organização. Por fim, as fontes de dados autenticadas por Windows como as do SQL Server, MSAS ou Oracle, que conectam-se ao Tableau Server, também podem estar em outros domínios.

Se for possível, recomendamos a configuração de uma confiança bidirecional entre todos os domínios que interagem com o Tableau Server. Se não for possível, o Tableau Server pode ser configurado para suportar a autenticação de usuário onde uma confiança unidirecional foi configurada. Nesse caso, uma confiança unidirecional entre domínios é possível quando o domínio no qual o Tableau Server está instalado é configurado para confiar no domínio onde as contas estão.

A figura a seguir mostra a confiança unidirecional entre o domínio no qual o Tableau Server está instalado e o domínio que contém as contas:

![Dois triângulos, um rotulado "users.lan" e o outro "dev.local", com uma seta indicando "trust" direcionada para o primeiro.](/tableau/current/pt-br/server/pt-br/Img/runas_oneway_trust.png)

Neste cenário, o Tableau Server está no domínio dev.local, e os usuários do domínio users.lan do Active Directory são importados para o Tableau Server. Uma relação de confiança unidirecional é um requisito deste cenário; especificamente, o dompinio dev.local está configurado para confiar no domínio users.lan. Os usuários no domínio users.lan podem acessar o Tableau Server no domínio dev.local com suas credenciais normais do Active Directory. Entretanto, pode ser preciso atualizar o nome do domínio no Tableau Server antes que os usuários façam logon com tal nome. Consulte a [Base de dados de conhecimento do Tableau](http://kb.tableau.com/articles/Issue/users-from-new-domain-unable-to-log-in-and-do-not-appear-in-user-list?lang=pt-br) para obter mais informações.

Ao configurar o Tableau Server para este cenário, especifique o domínio de usuário primário durante a instalação. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm). Para garantir que o Tableau Server possa se conectar a outros domínios do Active Directory, você também deve especificar outros domínios aos quais o Tableau Server se conecta definindo a opção `wgserver.domain.accept_list` com o TSM. Para obter mais informações, consulte [wgserver.domain.accept\_list](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain-acceptlist).

A conta de serviço Run As também deve ter acesso de consulta (Leitura) para cada domínio do qual os usuários serão importados.

**Observação:** em alguns cenários em que a conta de serviço Executar como não tem permissão para consultar um domínio secundário onde os usuários estão, pode ser necessário configurar a associação LDAP usando uma conta que tenha permissões para todos os domínios de usuários. Ao fazer isso, recomendamos usar a vinculação gssapi em vez da vinculação simples. Para obter mais informações, consulte [Associação do LDAP com GSSAPI (Kerberos)](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm#gssapi).

O logon único do Kerberos é compatível com este cenário de confiança unidirecional.

Analise o [Gerenciamento de usuários em implantações com armazenamentos de identidades externos](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm) para entender como vários domínios, a nomeação de domínio, o NetBIOS e o formato do nome de usuário do Active Directory influenciam o gerenciamento de usuário do Tableau.

### Conectar-se a dados em tempo real em cenários de confiança unidirecional

No cenário de confiança unidirecional, os usuários que conectam-se ao Tableau Server podem conectar a dados em tempo real hospedados na nuvem ou em qualquer outra fonte de dados local que não depende da autenticação do Windows.

Fontes de dados que exigem a autenticação do Windows podem apresentar requisitos de autenticação adicionais que complicam o cenário, ou que podem evitar que os usuários do Tableau Server conectem-se. Isso é devido ao Tableau Server usar a conta de serviço Run As para autenticação de tais fontes de dados. Se estiver executando o Tableau Server em um domínio diferente do que as fontes de dados que usam a autenticação do Windows, verifique se a conta de serviço Run As em uso no Tableau Server possa acessar a fonte de dados.

<!-- document id=e3cbf1d1dfcabf7aebaba5bb30c9a4fdf041b6cf4d9ca2625b4dc2d772066e59 url=/tableau/current/pt-br/server/requ_diskspace.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos de espaço em disco

Em geral, ao estimar a quantidade de espaço adicional em disco a ser alocado para a utilização diária do Tableau Server, você deve considerar se as extrações serão ou não publicadas no Tableau Server, além de considerar o número de pastas de trabalho que você espera publicar no Tableau Server . Se você prevê o uso de extrações, o Tableau recomenda que você comece com algumas centenas de gigabytes (GB). Se você não prever o uso de extrações, pode precisar de cerca de 50 GB para atender às suas necessidades de uso. Para configurar alertas de espaço em disco, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm#drive-space).

Procurando o Tableau Server no Linux? Consulte [Requisitos de espaço em disco](https://help.tableau.com/current/server-linux/pt-br/requ_diskspace.htm).

É fundamental que o Tableau Server tenha espaço em disco suficiente. Se você ficar sem espaço em disco em qualquer nó em uma instalação do Tableau Server, poderá ter um desempenho errático, incluindo não poder acessar o Tableau Server ou a Interface Web TSM. Para obter as etapas de solução de problemas, consulte [Solucionar problemas de uso do espaço em disco nos nós do Tableau Server](https://help.tableau.com/current/server/pt-br/trouble_disk_space.htm)base de dados de conhecimento de nós do Tableau Server.

Aqui estão os fatores que afetam os requisitos de espaço em disco e onde você pode optar por instalar o Tableau Server:

## Tamanho da unidade e tipo de partição

O tipo de partição usada na unidade do Tableau Server pode afetar a quantidade de espaço disponível para a instalação do Tableau Server.

- As partições Master Moot Record (MBR) são compatíveis com partições e discos rígidos de até 2 terabytes (2T) e podem ser usadas em drives de inicialização.
- O particionamento da tabela de partição GUID (GPT) é compatível com a partições e discos rígidos de até 18 exabytes de tamanho, mas não pode ser usado em unidades de inicialização. Essas são uma boa escolha ao instalar o Tableau Server em uma unidade adicional, pois fornecem muito espaço em disco, permitindo que as empresas aumentem ao longo do tempo.

## Publicar extrações no Tableau Server

Considere o número de extrações que será publicado no Tableau Server e o tamanho de cada extração. Teste as suas necessidades ao publicar várias extrações no Tableau Server e, em seguida, verifique o espaço em disco usado. Você pode usar essa quantidade de espaço em disco para ajudar a descobrir quantas extrações serão publicadas no Tableau Server no decorrer do tempo, além de como cada extração existente terá o tamanho aumentado.

## Atualização de extrações

Considere o espaço necessário pelo diretório temp durante uma atualização de extração. O diretório temp, que armazena uma extração durante a atualização, pode necessitar de um tamanho três vezes maior que o do arquivo final.

## Criação de muitas pasta de trabalho

Se estiver usando as pastas de trabalho, considere o número de pastas de trabalho que serão publicadas no Tableau Server. As pastas de trabalho individuais costuma ocupar uma pequena quantidade de espaço em disco. Entretanto, se você pretende publicar milhares de pastas de trabalho, pode desejar alocar espaço em disco adicional para acomodá-las.

## Registros

Para ajudar com o gerenciamento diários e a solução de problemas, o Tableau Server cria arquivos de registro como parte das operações normais. Dependendo do nível em que o registro está configurado, ele pode afetar bastante a quantidade de espaço em disco necessário no PC do Tableau Server.

## Processos de backup e restauração

O espaço em disco livre necessário para criar um backup varia dependendo da quantidade de dados nos serviços de armazenamento de arquivos e Repositório do Tableau Server, além de sua localização com o serviço tabadmincontroller. Durante os backups, as tarefas em segundo plano para limpeza de extrações antigas são temporariamente pausadas. Isso significa que, durante o backup, as atualizações de extração deixarão os arquivos extras no lugar, adicionando ao uso de espaço em disco. Se o backup demorar muito ou se a organização usar muitas extrações regularmente atualizadas, isso poderá resultar em uma quantidade significativa de uso de espaço em disco temporário. Esses arquivos temporários serão removidos depois que o backup for concluído.

A tabela a seguir lista os requisitos de espaço em disco para backup com base em se o nó hospeda o repositório, no armazenamento de arquivos, no controlador ou alguma combinação deles. Em ambientes do Tableau Server com vários nós, você precisa estimar o espaço em disco necessário em cada nó.

<table style="max-width: 100%;" class="simple-table"><colgroup><col style="width: 110px;"><col style="width: 110px;"><col style="width: 107px;"><col></colgroup><tbody><tr><th>Repositório</th><th>Armazenamento de arquivo</th><th>Controlador</th><th>Espaço em disco necessário</th></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td>&nbsp;</td><td><p>Dados de repositório 3x + 250 MB</p><p>Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório <code>&lt;data directory&gt;/pgsql/data/base</code>.</p><p>Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo workgroup.pg_dump.</p></td></tr><tr><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td><p>Dados do armazenamento de arquivos 1.5x</p><p>Para obter uma estimativa dos dados do armazenamento de arquivos (extrações, fluxos etc.), verifique o tamanho do diretório <code>&lt;data directory&gt;/dataengine</code>.</p></td></tr><tr><td>&nbsp;</td><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>&nbsp;</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td><td>Dados de repositórios 3x + 250 MB + dados do armazenamento de arquivos 1,5x</td></tr></tbody></table>

#### Requisitos de recuperação do espaço em disco

Você deve ter o espaço em disco adequado para que o processo de restauração do banco de dados seja executado com êxito.

Para restaurar o Tableau Server:

- Em nós de controlador, você precisa de espaço livre igual ao tamanho do arquivamento de backup.
- Em nós de repositório, você precisa de espaço livre igual ao triplo do tamanho dos dados do repositório no arquivamento de backup, além de 250 MB e do tamanho do diretório de dados pgsql.
- Em nós de armazenamento de arquivos, você precisa de espaço livre igual ao dobro do tamanho da pasta do mecanismo de dados no arquivamento de backup.

## Exportar e importar o site.

As exportações e importações de sites exigem espaço em disco adequado, assim como os processos de backup e restauração. No mínimo, você deve ter espaço suficiente para o arquivo exportado. Você pode usar os requisitos de backup e restauração como orientação para a quantidade de espaço em disco necessária ao fazer exportações e importações de sites.

A exportação de arquivo é gerada para o diretório definido na variável `basefilepath.site_export.exports` do TSM. Para obter detalhes adicionais, consulte [tsm sites export](https://help.tableau.com/current/server/pt-br/cli_sites_tsm.htm#TSMExport).

Para obter mais informações sobre os caminhos do arquivo e como alterá-los, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

<!-- document id=f227dbd08f59320c30682f82441cc0ce197a0eb02f9c11acd7e6b5d1e2a82737 url=/tableau/current/pt-br/server/impers_requ.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos de representação

Veja o que você precisa para usar o recurso:

- **Conexões ativas somente com o SQL Server:** A representação pode ser usada somente para exibições que têm conexão ativa com um banco de dados SQL Server versão 2005 ou mais recente.
- **Contas de banco de dados individuais:** Cada pessoa que acessará a exibição deverá ter uma conta individual explícita no banco de dados do SQL Server ao qual a exibição se conectará. Membros de um grupo do Active Directory (AD) não podem ser representados. Por exemplo, se Jane Smith for um membro do grupo Vendas do AD e seu administrador de banco de dados adicionar o grupo ao banco de dados do SQL Server, Jane não poderá ser representada.
- **Credenciais correspondentes e tipo de autenticação:** As credenciais de cada conta de usuário do Tableau e o respectivo tipo de autenticação de usuário do Tableau devem corresponder às credenciais e ao tipo de autenticação no banco de dados do SQL Server. Por exemplo, se a conta de usuário do Tableau Server de Jane Smith for `MyCo\jsmith`, o nome de usuário no banco de dados SQL Server também deverá ser `MyCo\jsmith`. O SQL Server deve usar a Autenticação integrada do Windows.
- **Pré-requisitos do SQL Server:** No SQL Server, você deve ter uma tabela de segurança de dados, uma exibição que imponha a segurança de dados, e você deve exigir que os usuários de seu banco de dados usem a exibição.
- **Conta SQL IMPERSONATE:** Você precisa de uma conta de banco de dados do SQL Server que tenha a permissão IMPERSONATE para os usuários do banco de dados acima. Essa é uma conta com a função sysadmin ou uma que tenha recebido a permissão IMPERSONATE para cada conta de usuário individual (consulte o [artigo do MSDN em EXECUTE AS](http://msdn.microsoft.com/pt-br/library/ms181362.aspx)). A conta do SQL Server deve ser uma das seguintes:
    
    - A conta do serviço Run As do Tableau Server. Consulte [Representação com uma conta de serviço Run As](https://help.tableau.com/current/server/pt-br/impers_runas.htm).
    - A conta do publicador da pasta de trabalho. Consulte [Representação com credenciais SQL inseridas](https://help.tableau.com/current/server/pt-br/impers_SQL.htm).

<!-- document id=f15aeb71ae97429709b7a0675e630b6be86febd3fbf2051c4c3b8d4f65da18e3 url=/tableau/current/pt-br/server/distrib_requ.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos distribuídos

Antes de começar a configurar o cluster do Tableau Server, verifique se você atende aos requisitos a seguir.

## Hardware

Embora devam atender aos requisitos descritos em [Antes da instalação...](https://help.tableau.com/current/server/pt-br/requ.htm), os computadores usados por você no cluster não precisam ser idênticos.

## Diretrizes de hardware para alta disponibilidade

Aqui estão algumas diretrizes para os sistemas que você usa em [failover e alta disponibilidade](https://help.tableau.com/current/server/pt-br/distrib_ha.htm):

- **Failover — três computadores**: para configurar um cluster que dê suporte a failover para os processos de armazenamento de arquivos e repositório, é preciso ter pelo menos três computadores ou VMs: um para o nó inicial do Tableau Server e dois para os nós adicionais.
- **Vários gateways—três computadores e um balanceador de carga**: adicionar vários processos de gateway à instalação do Tableau Server e usar um balanceador de carga para distribuir automaticamente solicitações aos gateways aumentará ainda mais a confiabilidade do Tableau. Para configurar um cluster que dê o suporte a failover e vários gateways, adicione um balanceador de carga diante do cluster de três nós.
- **Suporte a failover e vários gateways — três computadores e um balanceador de carga**: para configurar um cluster que dê o suporte acima e além para vários gateways, você precisa de no mínimo três computadores ou VMs e um balanceador de carga diante do cluster.
- **Alta disponibilidade — três computadores e um balanceador de carga**: para configurar para alta disponibilidade, os recursos descritos acima são necessários.
- **Computadores iniciais**: caso configure para alta disponibilidade, o nó inicial do Tableau Server pode estar executando poucos ou nenhum processo do Tableau Server. Portanto, o computador que serve como o nó inicial não requer tantos núcleos quanto os que executam os nós adicionais. No entanto, você precisará do espaço em disco adequado para backups porque o computador inicial é usado durante os processos de backup e restauração. Além da quantidade de espaço necessária para o arquivo de backup, você precisa de espaço temporário em disco. Para obter detalhes sobre os requisitos sobre espaço em disco, consulte [Uso do espaço em disco para backup e restauração](https://help.tableau.com/current/server/pt-br/db.htm#backupDiskSpace).

## Requisitos de software para servidor de vários nós

- Todos os nós de uma instalação de vários nós precisam executar a mesma versão do Tableau Server.
- Todos os nós em um cluster de vários nós devem ter o mesmo tipo de sistema operacional e a mesma versão principal desse sistema operacional. Por exemplo, todos os nós do Windows Server 2022 .
    
    Você não pode instalar uma instância de vários nós do Tableau Server em uma combinação de nós do Linux e do Windows.

## Local da instalação

A localização da instalação do Tableau Server deve ser a mesma em todos os nós de um cluster. Isso é válido para instalações na localização padrão ou em localização não padrão.

## Rede e portas

- **Portas**: assim como ocorre com qualquer sistema distribuído, os computadores ou VMs que você usa precisam ser capazes de se comunicar. Para obter informações sobre como o Tableau Services Manager aborda o mapeamento de portas, consulte [Portas do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/ports.htm).
- **Mesmo domínio**: se o Tableau Server estiver instalado em um ambiente do Active Directory do Windows, então todos os computadores em um cluster devem ser membros do mesmo domínio.
- **Latência**: a latência da rede entre os nós do servidor pode impactar o desempenho do Tableau Server. Esteja ciente de possíveis problemas de latência, especialmente se tiver problemas de desempenho. Para reduzir a latência da rede, você pode tomar medidas como localizar os gateways e fontes de dados nas proximidades do Tableau Server.
- **Conta de serviço**: a conta de usuário [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm) do servidor, especificada no Tableau Server inicial, deve ser a mesma em cada computador no cluster.
    
    Se estiver executando em um ambiente do Active Directory, recomendamos executar uma conta de usuário de domínio, como a conta de serviço Run As. Como uma melhor prática de segurança, embora exista a possibilidade de deixar a conta NetworkServices padrão em cada nó no cluster, não recomendamos isso.
    
    Caso esteja executando uma implantação distribuída em um grupo de trabalho do Windows, deverá usar a mesma conta de usuário e senha em cada nó do cluster. Nesse cenário, especifique a conta de serviço Run As usando um ponto final (.) em vez de um nome de computador no TSM. Por exemplo, se a conta de serviço Run As do grupo de trabalho for `tableau-sa`, especifique `.\tableau-sa` no TSM. O Windows interpreta a sintaxe `.\` como equivalente a "nome do computador do host local."
- **Endereços IP estáticos**: qualquer computador que estiver executando o Tableau Server, seja uma instalação de servidor único ou parte de um cluster, deverá ter um endereço IP estático .
- **Pode ser descoberto**: cada nó no cluster pode ser descoberto em outros computadores do nó usando um arquivo DNS ou host local.
- **Fuso horário e hora**: cada nó no cluster deve estar no mesmo fuso horário, com os horários do sistema sincronizados. Isso pode acontecer automaticamente. Por exemplo, se seus nós estão todos no domínio Active Directory, o controlador de domínio geralmente resolve isso. Se não tiver certeza se o seu cluster atende a essa exigência, consulte seus especialistas internos de TI.

## Práticas recomendadas

Veja aqui algumas considerações que você deve ter em mente antes de começar a instalar e configurar:

- **Endereços IP ou nomes do computador**: como mencionado acima, cada computador no cluster deve usar um endereço IP estático.
- **Registro CNAME**: se estiver usando um balanceador de carga, será o nome do balanceador de carga que os usuários utilizarão como a URL do Tableau Server, independentemente do gateway que está efetivamente lidando com a solicitação.
- **Credenciais da conta de usuário**: para cada computador, você precisa de credenciais de uma conta de usuário com permissões de admin locais.
- **Backup**: é uma prática recomendada criar um backup antes de fazer alterações significativas no sistema. Consulte [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm) para obter as etapas.
- **Implantação de distribuição em todos os data centers**: não recomendamos a instalação de nós do Tableau Server em data centers distribuídos. Os exemplos a seguir descrevem alguns problemas que ocorrem quando os nós são distribuídos em vários data centers:
    
    - Problemas na conexão entre nós pode causar a falha de diversas tarefas ou fazer com que os componentes do Tableau Server percam a licença.
    - Proxies e firewalls entre data centers podem prejudicar a habilidade dos nós do Tableau Server de se comunicarem entre si.
    - O direcionamento de tráfego entre dados geograficamente dispersos pode causar latência ou afunilar a transmissão de dados, o que resulta em baixo desempenho e conexões expiradas.

## SSL

Caso você pretenda configurar SSL para um cluster do Tableau Server altamente disponível com vários gateways e um balanceador de carga ([saiba mais](https://help.tableau.com/current/server/pt-br/distrib_ha.htm)), verifique se o certificado SSL usado foi emitido para o nome de host do balanceador de carga. Consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm) para obter outros detalhes.

<!-- document id=f44dd7e2f2c3ed7e6baac146bb8500534c6b22d83b9c09af86a956e58f6eafec url=/tableau/current/pt-br/server/kerberos_requ.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos do Kerberos

É possível configurar a autenticação do Kerberos para o Tableau Server em execução nos ambientes do Active Directory.

## Requisitos gerais

- Balanceador de carga externa/servidor proxy: se você for usar o Tableau Server com o Kerberos em um ambiente que tenha balanceadores de carga externos (ELBs) ou servidor proxy, será necessário instalá-los antes de configurar o Kerberos no utilitário de configuração do Tableau Server. Consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).
- Suporte no navegador do iOS: um usuário do iOS poderá usar a autenticação do Kerberos com o Safari móvel se um perfil de configuração especificando a identidade do Kerberos do usuário estiver instalado. Consulte [Configuração de um dispositivo iOS para o suporte Kerberos](https://help.tableau.com/current/mobile/mobile-admin/Pt-br/admin_mobile_sso.htm) na Ajuda do Tableau Mobile. Para obter mais informações sobre a compatibilidade com o SSO do Kerberos, consulte [Suporte do cliente Tableau para o SSO do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_browser.htm).
- O Tableau Server é compatível com a delegação restrita para autenticações em fontes de dados de dados. Neste cenário, o acesso a dados do Tableau recebe direitos especificamente sobre os SPNs do banco de dados de destino. A delegação não restrita não é aceita.
- As fontes de dados suportadas (SQL Server, MSAS, PostgreSQL, Hive/Impala e Teradata) devem estar configuradas para a autenticação do Kerberos.
- Um arquivo keytab configurado com um nome do provedor de serviços para o Tableau Server para autenticação de usuário. Para obter mais informações, consulte [Saiba mais sobre os requisitos do Keytab.](https://help.tableau.com/current/server/pt-br/kerberos_keytab.htm#kerb).
- A partir do Tableau Server 2021.2.25, 2021.3.24, 2021.4.19, 2022.1.15, 2022.3.7 e 2023.1.3 (ou posterior), certifique-se de que os arquivos keytab sejam criados com cifras AES-128 ou AES-256. As cifras RC4 e 3DES não são mais aceitas. Para obter mais informações, consulte ["O Tableau Server não conseguiu autenticá-lo automaticamente"](https://help.tableau.com/current/server/pt-br/%3Chttps://kb.tableau.com/articles/Issue/tableau-server-could-not-authenticate-you-automatically-error-occurs-when-attempting-to-automatically-login-using-kerberos-sso-after- atualização do tableau-server?lang=es-es>) na base de conhecimento do Tableau.

## Requisitos do Active Directory

É necessário cumprir os requisitos a seguir para executar o Tableau Server com o Kerberos em um ambiente do Active Directory:

- O Tableau Server deve usar um Active Directory (AD) para autenticação.
- O domínio deve ser um AD 2003 ou posterior para conexões do Kerberos para o Tableau Server.
- Suporte ao Smartcard: os smartcards são aceitos quando os usuários efetuam logon nas estações de trabalho com um smartcard, e isso faz com que um TGT do Kerberos seja concedido ao usuário no Active Directory.
- Logon único (SSO): os usuários devem receber uma concessão de TGT (Ticket Granting Ticket) do Kerberos no Active Directory, ao fazer o logon nos computadores. Este é um comportamento padrão para PCs com Windows unidos por domínios e para Macs que usam o AD como o servidor de conta da rede. Para obter mais informações sobre como usar computadores com Mac e Active Directory, consulte [Associe seu Mac a um servidor de conta da rede](https://support.apple.com/guide/mac-help/join-your-mac-to-a-network-account-server-mh27627/mac) na base de dados de conhecimento de dados da Apple.

### Delegação do Kerberos

Para cenários de delegação do Kerberos, é exigido o seguinte:

- Se o domínio for AD 2003 ou posterior, a delegação de domínio único do Kerberos será suportada. Os usuários, o Tableau Server e o banco de dados de backend devem estar no mesmo domínio.
- Se o domínio for AD 2008, o suporte entre domínios será limitado. Usuários de outros domínios podem ser delegados se as seguintes condições forem atendidas: O Tableau Server e o banco de dados de backend devem estar no mesmo domínio e uma confiança bidirecional é necessária entre o domínio em que o Tableau Server reside e o domínio do usuário.
- Se o domínio for 2012 ou posterior, a delegação completa entre domínios será suportada. O AD 2012 R2 é preferido por ter uma caixa de diálogo para configurar a delegação restrita, enquanto o 2012 sem R2 exige configuração manual.

<!-- document id=aec82198c3164c5afd11762ea3f2fdbf2f0912782ad5e3d671c9320bf2fc7beb url=/tableau/current/pt-br/server/saml_requ.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos do SAML

Antes de configurar o SAML no Tableau Server, tenha certeza de que o ambiente atende aos requisitos.

**Importante:** as configurações de SAML, com o IdP e no Tableau Server, diferenciam maiúsculas de minúsculas. Por exemplo, as URLs configurados com o IdP e no Tableau Server devem corresponder exatamente.

## Requisitos de certificado e de provedor de identidades (IdP)

Para configurar o Tableau Server para SAML, você precisa do seguinte:

- ******Arquivo de certificado**.**** Um arquivo de certificado x509 codificado por PEM com a extensão .crt. Esse arquivo é usado pelo Tableau Server, não pelo IdP. Se você tiver um certificado SSL, é possível, em alguns casos, usar o mesmo certificado com o SAML. Para obter mais informações, consulte [Uso do certificado SSL e arquivos-chave para SAML](#Cert_Name) adiante neste artigo.
    
    O Tableau Server requer um par de chave e certificado para assinar a solicitação enviada ao IdP. Isso reduz a ameaça de um ataque man-in-the-middle, dada a dificuldade de falsificar um pedido assinado. Além disso, o Tableau Server verifica que o AuthNResponse recebe do IdP confiável. O Tableau Server verifica o AuthNResponse usando a assinatura produzida pelo IdP. Os metadados de certificado IdP são fornecidos ao Tableau Server como parte do processo inicial de configuração SAML.
    
    Os pedidos assinados nem sempre são necessários para todos os IDPs. Por padrão, o Tableau Server requer solicitações assinadas. Recomendamos essa configuração para garantir uma transmissão de comunicação mais segura com o IdP. Trabalhe com sua equipe de IdP para entender se a desativação de solicitações assinadas é necessária. Para desativar as solicitações assinadas consulte [Entidade samlSettings](https://help.tableau.com/current/server/pt-br/entity_saml.htm).
- **Algoritmo de assinatura.** O certificado deve usar um algoritmo de assinatura seguro, por exemplo SHA-256. Se você tentar configurar o Tableau Server para SAML com um certificado que usa hash de assinatura SHA-1, o Tableau Server o rejeitará. Você pode configurar o Tableau Server para aceitar o hash SHA-1 menos seguro definindo a chave de configuração do tsm[wgserver.saml.blocklisted\_digest\_algorithms](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver5).
- **Chave RSA e tamanhos de curva ECDSA.** O certificado do Tableau Server deve ter uma força de chave RSA de 2048, e o certificado IdP deve ter uma força de chave RSA de 2048 ou um tamanho de curva ECDSA de 256.
    
    Você pode configurar o Tableau Server para aceitar os tamanhos menos seguros definindo as respectivas chaves de configuração, [wgserver.saml.min\_allowed.rsa\_key\_size](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver4) e [wgserver.saml.min\_allowed.elliptic\_curve\_size](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver2) .
- ****Arquivo de chave do certificado**.** Um arquivo de chave privada RSA ou DSA com a extensão .key. As chaves RSA devem estar no formato PKCS#1ou PKCS#8.
    
    Os requisitos de proteção de senha são os seguintes:
    
    - O arquivo-chave RSA PKCS#1 não pode ser protegido por senha.
    - Para usar um arquivo de chave protegido por senha, configure o SAML com um arquivo RSA PKCS#8. **Observação:** um arquivo PKCS#8 com uma senha nula não é compatível.
    - Os arquivos-chave protegidos por senha não são aceitos em implantações SAML específicas do site.
    
    **Resumo de suporte**
    
    | Formato de arquivo-chave | Suporte SAML em todo servidor | Suporte SAML no nível do site |
    | --- | --- | --- |
    | PKCS#8 RSA | Sim | Não |
    | PKCS#8 (sem senha/senha nula) | Não | Não |
    | PKCS#1 RSA | Sim | Sim |
    | PKCS#1 RSA (senha) | Não | Não |
    | PKCS#1 DSA (senha) | Não | Não |
- **O IdP deve assinar asserções SAML com um algoritmo de assinatura seguro.** Por padrão, o Tableau Server rejeitará asserções SAML assinadas com o algoritmo SHA-1. Você pode configurar o Tableau Server para aceitar asserções assinadas com o hash SHA-1 menos seguro definindo o a chave de configuração tsm [wgserver.saml.blocklisted\_digest\_algorithms](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver5).
- ****Conta de IdP que aceita SAML 2.0 ou posterior**:** Você precisa de uma conta com um provedor de identidades externo. Alguns exemplos são PingFederate, SiteMinder e Open AM.
- ****Provedor IdP compatível com a importação e exportação de metadados XML**.** Embora um arquivo de metadados criado manualmente possa funcionar, o suporte técnico do Tableau não pode ajudar com a solução de problemas ou a geração do arquivo.

- **Nome de usuário:** obrigatório. A configuração do IdP deve incluir o atributo ou declaração "username" e o atributo de configuração SAML correspondente no Tableau Server também deve ser definido como "username".

### Descarregamento de SSL

Se a sua empresa encerrar conexões SSL do IdP em um servidor proxy, antes de enviar a solicitação de autenticação para o Tableau Server, você precisa fazer a configuração proxy. Nesse cenário, o SSL é "descarregado" no servidor proxy, o que significa que a solicitação https é encerrada no servidor proxy e depois encaminhada ao Tableau Server em http.

O Tableau Server valida a mensagem de resposta SAML retornada do IdP. Como o SSL é descarregado no proxy, o Tableau Server valida com o protocolo recebido (http), mas a resposta do IdP é formatada com https, então a validação falhará a menos que o servidor proxy inclua o cabeçalho X-Forwarded-Proto definido como `https`. Consulte [Configurar o Tableau Server para funcionar com um servidor proxy reverso e/ou balanceador de carga](https://help.tableau.com/current/server/pt-br/proxy.htm#Configur).

### Uso do certificado SSL e arquivos-chave para SAML

Se estiver usando um arquivo de certificado x509 codificado por PEM, é possível usar o mesmo arquivo para SAML. Para SSL, o arquivo de certificado é usado para criptografar tráfego. Para SAML, o certificado é usado para autenticação.

Além dos requisitos listados em [Requisitos de certificado e de provedor de identidades (IdP)](#Certific) acima, para usar o mesmo certificado para SSL e SAML, o certificado também deve atender à seguinte condição para trabalhar com o SAML:

- Confirme se o certificado inclui apenas o que se aplica ao Tableau Server e não nenhum outro certificado ou chave.
    
    Para fazer isso, é possível criar uma cópia de backup do arquivo de certificado e, em seguida, abri-la em um editor de texto para revisar o conteúdo.

## Requisitos de gerenciamento de usuário

Ao habilitar o SAML, a autenticação de usuário é realizada fora do Tableau, pelo IdP. No entanto, o gerenciamento do usuário é realizado por um repositório de identidades: um repositório de identidades externo (Active Directory ou LDAP) ou pelo Tableau Server em um repositório de identidades local. Para obter mais informações sobre o planejamento do gerenciamento do usuário com o Tableau Server, consulte [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm).

Ao configurar o repositório de identidades durante a instalação, selecione a opção que reflete como você deseja usar o SAML. Observe que se você quiser usar SAML específico ao site, é obrigatória a configuração do SAML em todo o servidor antes da configuração dos sites individuais.

- **Para SAML específico ao site**: caso tenha vários sites no Tableau Server e queira configurar cada um deles em um IdP específico ou aplicativo de IdP (ou configurar alguns sites para não usarem SAML), configure o Tableau Server para gerenciar usuários com um armazenamento de identidades local. Quando o SAML específico ao site é usado, o Tableau Server depende do IdP para a autenticação e não usa senhas.
- **Para SAML de servidor**: se você configurar o SAML de servidor com um único IdP, poderá configurar o Tableau Server para usar o armazenamento de identidades local ou um armazenamento de identidades externo. Se você estiver usando o Active Directory (AD), precisa desabilitar a opção Habilitar logon automático (Microsoft SSPI).
- **Para autenticação SAML de servidor e autenticação SAML específica ao site:**
    
    - **Ao usar um armazenamento de identidade local**, é importante que você use um nome de usuário que tenha formatação de endereço de e-mail. O uso de um endereço de e-mail completo ajudará a garantir a exclusividade do nome de usuário no Tableau Server, mesmo se dois usuários tiverem o mesmo prefixo de e-mail, mas em domínios de e-mail diferentes. Para garantir a exclusividade nas identidades, aproveite a formatação completa do endereço de e-mail em ambos os sistemas ou atualize o Tableau Server para a versão 2022.1.x ou posterior e execute o trabalho [migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm) em segundo plano.
    - **Em um ambiente de vários sites**, todos os usuários autenticam por meio do SAML IdP configurado no nível do site. Nesse cenário, você especifica um IdP SAML padrão em todo o servidor para usuários que pertencem a vários sites. Para configurar esse cenário, o Tableau Server deve ser configurado com um repositório de identidades local.
    - **Ignorar domínio ao corresponder o atributo de nome de usuário SAML**. A partir das versões 2021.4.21, 2022.1.17, 2022.3.9 e 2023.1.5 do Tableau Server, você pode configurar o Tableau Server para ignorar a parte do domínio do atributo nome de usuário ao combinar o nome de usuário do provedor de identidade (IdP) com uma conta de usuário no Tableau Server. Por exemplo, o atributo de nome de usuário no IdP pode ser `alice@example.com` para corresponder a um usuário chamado `alice` no Tableau Server. Ignorar a parte do domínio do atributo nome de usuário poderá ser útil se você já tiver usuários definidos no Tableau Server que correspondam à parte do prefixo do atributo nome de usuário, mas não à parte do domínio do atributo nome de usuário.
        
        **Importante**: não recomendamos nome de domínio sem tomar precauções. Especificamente, verifique se os nomes de usuário são exclusivos em todos os domínios configurados que você criou no seu IdP. Configurar o Tableau Server para ignorar o nome de domínio pode resultar em login não intencional do usuário. Considere o caso em que seu IdP foi configurado para vários domínios (por exemplo, `example.com` e `tableau.com`). Se dois usuários com o mesmo nome, mas contas de usuário diferentes (por exemplo, `alice@tableau.com` e `alice@example.com`) estiverem na sua organização, poderá haver uma incompatibilidade de mapeamento.
        
        Para configurar o Tableau Server para ignorar os nomes de domínio no atributo de nome de usuário do IdP, defina `wgserver.ignore_domain_in_username_for_matching` como `true`. Para obter mais informações, consulte [wgserver.ignore\_domain\_in\_username\_for\_matching](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#ignore_domain).
        
        **Observações:**
        
        - Este comando só funciona em implantações do Tableau Server que estão em `legacy-identity-mode` ou implantações que não foram atualizadas por meio do [migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm) para usar o Serviço de Identidade.
        - Ao alterar o comando tsm para ignorar o nome de domínio no atributo nome de usuário, todos os nomes de usuário no Tableau Server deverão ter um nome de domínio.

**Observação**: a [REST API](https://onlinehelp.tableau.com/current/api/rest_api/en-us/help.htm) e o [tabcmd](http://onlinehelp.tableau.com/current/server/pt-br/tabcmd.htm) não oferecem suporte ao logon único (SSO) do SAML. Para fazer logon, especifique o nome e a senha de um usuário criados no servidor. O usuário pode ser gerenciado pelo repositório de identidades local ou por um repositório de identidades externo, dependendo de como configurou o Tableau Server. As chamadas de REST API ou tabcmd terão as permissões do usuário pelo qual você faz logon.

## Notas e requisitos de compatibilidade do SAML

- **Nomes de usuário correspondentes**: o nome de usuário armazenado no Tableau Server deve corresponder ao atributo de nome de usuário configurado enviado pelo IdP na asserção SAML. Por padrão, o Tableau Server espera que a declaração de entrada contenha um atributo denominado "nome de usuário" com as informações desse usuário. Por exemplo, se o nome de usuário de Jane Smith estiver armazenado no PingFederate como jsmith, também deverá ser armazenado no Tableau Server como jsmith.
    
    **Ao configurar SAML durante a autenticação**
    
    Se estiver configurando o SAML como parte da instalação inicial do Tableau Server, verifique se a conta que você planeja usar existe no IdP antes de executar a instalação. Durante a instalação do Tableau Server, crie a conta de administrador do servidor.
    
    **Ao executar vários domínios**
    
    Se você usar um Active Directory ou repositório de identidades externo LDAP e estiver em execução em vários domínios (isto é, os usuários pertencem a vários domínios ou a instalação do Tableau Server inclui vários domínios), o IdP deve enviar os atributos do nome _e_ domínio do usuário para um usuário na asserção SAML. Esses atributos de nome de usuário e domínio devem corresponder exatamente ao nome de usuário e domínio armazenados no Tableau Server. Execute _um_ destes procedimentos:
    
    - Definir `domain\username` no campo de nome de usuário
    - Defina o domínio no campo de domínio e defina o nome de usuário no campo de nome de usuário
    
    Ao definir o atributo de domínio, você pode usar o nome de domínio totalmente qualificado (FQDN) ou o nome abreviado.
    
    Onde o domínio não for especificado, ele será considerado o domínio padrão.
    
    Para obter mais informações, consulte [Suporte a vários domínios](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm#multiple_domains) e a seção "Asserções de correspondência" na guia **Usar TSM CLI** de [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).
- **Algoritmo de assinatura**: o Tableau Server usa o algoritmo de assinatura SHA256.
- **Logout único (SLO)**: o Tableau Server é compatível com SLO iniciado por provedor de serviços (SP) e SLO iniciado por provedor de identidade (IdP) para SAML em todo o servidor e SAML específico do site.
    
    Para garantir que o SLO funcione conforme o esperado, a associação HTTP POST-SAML é necessária. Para obter mais informações, consulte a seção [Associação HTTP-POST](#binding) abaixo. Para obter suporte na solução de problemas de SLO, consulte o artigo [Logout único iniciado por IDP não se comporta como esperado](https://help.salesforce.com/s/issue?id=a02Ka00000mmzqj) da base de conhecimento.
- **Tipos de autenticação externa**: o Tableau Server oferece suporte ao uso de um tipo de autenticação externa ao mesmo tempo.
- **SSL mútua**: o Tableau Server não suporta SSL mútuo (SSL bidirecional) e SAML juntos. Caso queira usar o SSL mútuo, configure esta opção no IdP.
- **Codificação de asserções**: as asserções devem ser codificadas por UTF-8.
- **Asserções de criptografia e SAML**:
    
    - **SAML em todo servidor**: quando Tableau Server é configurado para SAML em todo o servidor, o Tableau Server aceita asserções criptografadas do IdP. As asserções de criptografia são habilitadas pelo certificado que você carrega como parte da configuração inicial para SAML em todo o servidor. Solicitações e respostas SAML podem ser enviadas por HTTP ou HTTPS.
    - **SAML em todo site**: quando o Tableau Server é configurado para SAML em todo o site, o Tableau Server não aceita asserções criptografadas do IdP. No entanto, todas as solicitações e respostas da SAML são enviadas pelo HTTPS para proteger a comunicação com o IdP. Solicitações e respostas HTTP não são suportadas.
- **Identidade do usuário no Tableau Server para usuários do tabcmd**: conforme descrito na seção [Requisitos de gerenciamento de usuário](#saml_user_mgmt) acima, para usar o tabcmd, faça logon com um usuário definido no servidor. Não é possível usar contas SAML com o **tabcmd**.
- **Uso do SAML SSO com Tableau Desktop**: por padrão, o Tableau Desktop permite a autenticação SAML iniciada em SP.
    
    Caso seu IdP não suporte esta funcionalidade, é possível desabilitar o logon com SAML para Tableau Desktop usando o comando a seguir:
    
    `tsm authentication saml configure --desktop-access disable`
    
    Para obter mais informações, consulte [tsm authentication saml <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMsaml).
- **Instalações distribuídas**: versões TSM do Tableau Server (2018.2 e mais recente) usam o Serviço de arquivos do cliente para compartilhar arquivos em um cluster de vários nós. Depois de configurar o SAML no nó inicial do cluster, o Serviço de arquivo do cliente distribuirá arquivos de certificado principais para os outros nós.
- **URL de logon**: para que os usuários possam fazer logon, o seu IdP deve ser configurado com o endpoint de Login do SAML que envia uma solicitação POST para a seguinte URL:
    
    `https://<tableauserver>/wg/saml/SSO/index.html`.
- **URL de logout**: para que os usuários possam fazer logout após o logon com o SAML (logout único ou SLO), seu IdP deve ser configurado com um endpoint de Logout do SAML que envia uma solicitação POST para a URL a seguir:
    
    `https://<tableauserver>/wg/saml/SingleLogout/index.html`.
    
    **Observação:** o Tableau Server é compatível com SLO iniciado por provedor de serviços (SP) e SLO iniciado por provedor de identidade (IdP) para SAML em todo o servidor e SAML específico do site.
- **URL de redirecionamento pós-logout**: por padrão, quando um usuário faz logout do Tableau Server, a página de logon é exibida. 
    
    Para exibir uma página diferente após o logout, use o comando `tsm authentication saml configure` com a opção `-su` ou `--signout-url`.
    
    - Para especificar uma URL absoluta, use uma URL totalmente qualificada que comece com `http://` ou `https://`, como neste exemplo:
        
        `tsm authentication saml configure -su https://example.com`
    - Para especificar uma URL relativa Tableau Server, use uma página que inicie com um / (slash):
        
        `tsm authentication saml configure -su /ourlogoutpage.html`
- **Active Directory Federation Service (AD FS)**: é necessário configurar o AD FS para retornar atributos adicionais para a autenticação do Tableau com SAML. Os atributos ID do nome e nome de usuário podem ser mapeados no mesmo atributo AD: SAM-Account-Name
    
    Para obter informações sobre configuração, consulte [Configurar SAML com AD FS no Tableau Server](https://help.tableau.com/current/server/pt-br/saml_config_adfs_server.htm).
- **AuthNContextClassRef** : AuthNContextClassRef é um atributo SAML opcional que impõe a validação de certos "contextos" de autenticação em fluxos iniciados pelo IdP. Você pode definir valores separados por vírgulas para este atributo com TSM. Quando esse atributo é definido, o Tableau Server valida que a resposta SAML contém pelo menos um dos valores listados. Se a resposta SAML não contiver um dos valores configurados, a autenticação será rejeitada, mesmo que o usuário tenha autenticado com sucesso com o IdP.
    
    Deixar esse atributo opcional em branco resultará em comportamento padrão: qualquer resposta SAML autenticada com sucesso resultará em um usuário sendo concedido a uma sessão dentro do Tableau Server.
    
    Este valor é compatível somente com SAML em todo o servidor. Se o SAML do site estiver configurado, o atributo `AuthNContextClassRef` será ignorado.
    
    - Para definir esse valor com a interface da Web TSM, consulte [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).
    - Para definir esse valor com [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet), use a chave `wgserver.saml.authcontexts`, para definir uma lista de valores separada por vírgula.
    - Para definir esse valor com um arquivo de configuração JSON, consulte [Entidade samlSettings](https://help.tableau.com/current/server/pt-br/entity_saml.htm).

## Usar logon único SAML em aplicativos de clientes do Tableau

Os usuários do Tableau Server com credenciais do SAML podem fazer logon no servidor do aplicativo do Tableau Desktop ou do Tableau Mobile. Para obter total compatibilidade, é recomendável que a versão do aplicativo do cliente Tableau corresponda à do servidor. Para se conectarem por meio do SAML específico ao site, os usuários devem executar a versão 10.0 ou posterior do aplicativo do cliente do Tableau.

A conexão com o Tableau Server a partir do Tableau Desktop ou do Tableau Mobile usa uma conexão iniciada pelo provedor de serviços (SP).

### Redirecionamento de usuários autenticados de volta aos clientes do Tableau

Quando um usuário faz logon no Tableau Server (usando um fluxo de trabalho iniciado por SP), Tableau Server envia uma solicitação SAML (`AuthnRequest`) para o IdP, que inclui o valor **RelayState** do aplicativo do Tableau. Se o usuário fez logon no Tableau Server a partir de um cliente do Tableau, como Tableau Desktop ou Tableau Mobile, é importante que o valor RelayState seja retornado na resposta SAML do IdP ao Tableau para direcionar os usuários para um recurso específico do Tableau.

Quando o usuário inicia o processo de logon para o Tableau Server diretamente do IdP (usando um fluxo de trabalho iniciado pelo IdP), o IdP pode incluir um valor **RelayState** na resposta SAML para direcionar os usuários para um recurso específico do Tableau. Por exemplo, o valor RelayState pode ser definido como `/#/site/[site-url]/views/[view-name]/[workbook-tab-name]`.

Quando o valor RelayState não é retornado corretamente nestes cenários, o usuário é direcionado para a página inicial do Tableau Server no navegador da Web, em vez de ser redirecionado para o aplicativo no qual fez logon.

Trabalhe com o provedor de identidades e a equipe de TI interna para confirmar se esse valor será incluído como parte da resposta SAML do IdP e mantido por qualquer dispositivo de rede (como um proxy ou balanceador de carga) que reside entre o IdP e Tableau Server.

## Requisitos de dados em XML

Como parte da configuração de SAML, há troca de metadados XML entre o Tableau Server e o IdP. Esses metadados XML são usados para verificar as informações de autenticação de um usuário, quando ele inicia o processo de logon no Tableau Server.

O Tableau Server e o IdP geram seus próprios metadados. Cada conjunto de metadados deve conter as informações descritas na seguinte lista. Se um dos conjuntos estiver com informações ausentes, poderão ocorrer erros ao configurar o SAML ou quando os usuários tentarem fazer logon.

### HTTP-POST

Para SAML em todo o servidor, o Tableau Server oferece suporte somente a solicitações HTTP POST para comunicações SAML. No documento XML de metadados do SAML que é exportado pelo IdP, o atributo `Binding` precisa ser configurado como HTTP-POST

**Observações:**

- O Tableau Server não oferece suporte à associação HTTP-REDIRECT para logout único (SLO). Mais especificamente, a associação HTTP-REDIRECT não é compatível com SLO iniciados por SP (quando um usuário clica em Sair do diretório do Tableau Server) ou SLO iniciados por IdP (quando um usuário faz logout do provedor de identidade). Alguns provedores de identidade podem usar a associação HTTP-REDIRECT para solicitações de SLO. O uso de HTTP-REDIRECT para SLO fará com que o logout falhe porque o Tableau Server não processará corretamente as solicitações de logout enviadas via HTTP-REDIRECT. Verifique se o IdP está configurado para usar a associação HTTP-POST em todas as comunicações SAML.
- O SAML específico do site oferece suporte à associação HTTP-Redirect. Para obter mais informações, consulte [Configurar SAML para um site específico](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).

- Com o atributo `Binding` definido como `HTTP-POST`, os metadados do SAML exportados pelo Tableau Server e pelo IdP devem conter os elementos a seguir.
    
    - O elemento que especifica a URL para a qual o IdP vai redirecionar após a autenticação ser efetuada com êxito. Isso é necessário nos metadados do Provedor de serviços, não nos metadados do Provedor de identidade.
        
        `<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://<tableau-server>/wg/saml/SSO/index.html index="0" isDefault="true"/>`
        
        Para o SAML do site, o endpoint `Location` é `/samlservice/public/sp/metadata?alias=<site alias>`.
    - O elemento de endpoint de logoff aparece nos metadados do Tableau Server e especifica a URL que o IdP usará para o endpoint de logout do Tableau Server: Se esse elemento não estiver nos metadados IdP, o Tableau Server não poderá negociar um endpoint de logoff com o IdP e o recurso Logoff do SAML não estará disponível no Tableau Server:
        
        `<md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://SERVER-NAME:9031/idp/slo"`
    - Verifique se o XML de IdP inclui um elemento SingleSignOnService, no qual a associação é definida para `HTTP-POST`, conforme o exemplo a seguir:
        
        `<md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://SERVER-NAME:9031/idp/SSO.saml2"/>`
    - Esse elemento deve aparecer nos metadados IdP e especifica a URL que o Tableau Server usará para o endpoint de logout do IdP.
        
        `<md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://SERVER-NAME:9031/idp/slo"/>`

### Atributo com nome _username_

Configure o IdP para retornar uma asserção que inclua o atributo `username` no elemento `saml:AttributeStatement`. O tipo de atributo da asserção deve ser `xs:string` (_não_ deve ser digitado como `xs:any`).

Veja o exemplo a seguir.

<saml:Assertion _assertion-element-attributes_\>
  <saml:Issuer>_issuer-information_</saml:Issuer>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
  <saml:Subject>
    ...
  </saml:Subject>
  <saml:Conditions _condition-attributes_ >
    ...
  </saml:Conditions>
  <saml:AuthnStatement _authn-statement-attributes_ >
    ...
  </saml:AuthnStatement>

  <saml:AttributeStatement>
    <saml:Attribute Name="username" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic">
    <saml:AttributeValue xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">
          **_user-name_**
    </saml:AttributeValue>
    </saml:Attribute>
  </saml:AttributeStatement>
</saml:Assertion>

Por padrão, o Tableau Server lerá o atributo `username` no AuthNResponse que retornou do Idp. No entanto, alguns IdPs podem retornar um atributo diferente que é indicado para identificar o usuário.

Para alterar o atributo SAML que passa o valor `username`, execute o comando TSM a seguir:

`tsm authentication saml map-assertions --user-name <USER-NAME>`.

Consulte [tsm authentication](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#tsm).

### Associação dinâmica a grupos usando asserções SAML

A partir de Tableau Server 2024.2, se SAML (ou site SAML) está configurado e a configuração do recurso habilitada (em todo o servidor ou em nível de site), você poderá controlar dinamicamente a associação ao grupo por meio de declarações personalizadas incluídas na resposta XML SAML enviada pelo provedor de identidade (IdP).

Quando configurado, durante a autenticação do usuário, o IdP envia a asserção SAML que contém duas declarações personalizadas de associação de grupo: grupo (`https://tableau.com/groups`) e nomes de grupos (por exemplo, "Grupo1" e "Grupo2") para inserir o usuário. O Tableau valida a declaração e, em seguida, permite o acesso aos grupos e ao conteúdo cujas permissões dependem desses grupos.

Para mais informações, veja [Associação dinâmica a grupos usando asserções](https://help.tableau.com/current/server/pt-br/groups_create_local.htm#assertions).

**Exemplo de resposta SAML XML**

<saml2p:Response
  xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
    .....
    .....
  <saml2:Assertion
    .....
    .....
    xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion"
    <saml2:AttributeStatement
  		xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml2:Attribute
    		Name="https://tableau.com/groups"
			NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">Group1
			</saml2:AttributeValue>
			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">Group2
			</saml2:AttributeValue>
    	<saml2:Attribute>
    </saml2:AttributeStatement>
  </saml2:Assertion>
</saml2p:Response>

### Atributos do usuário em asserções SAML

A partir do Tableau Sever 2026.2, quando configurado e a configuração do recurso estiver habilitada, você poderá passar asserções de atributos de usuários na resposta SAML XML enviada pelo provedor de identidade (IdP) para o Tableau Server durante o logon. Esses atributos de usuário podem ser usados com as funções de atributo de usuário do Tableau (`USERATTRIBUTE()`, `USERATTRIBUTEINCLUDES()`) para controlar e personalizar dinamicamente o conteúdo. O Tableau valida a asserção e, em seguida, permite o acesso ao conteúdo.

Para obter mais informações, consulte [Personalizar e controlar o acesso aos dados usando atributos de usuário](https://help.tableau.com/current/server/pt-br/config_saml.htm#user_attributes)..

**Exemplo de resposta SAML XML**

<saml2p:Response
  xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
    .....
    .....
  <saml2:Assertion
    .....
    .....
    xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion"
    <saml2:AttributeStatement
  		xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml2:Attribute
    		Name="Region"
			NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">South
			</saml2:AttributeValue>
			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">South West
			</saml2:AttributeValue>
    	<saml2:Attribute>
    </saml2:AttributeStatement>
  </saml2:Assertion>
</saml2p:Response>

<!-- document id=eff24b69888415dabf5fce83e92fb3ed0588511e4bd4a5c476a356d4a56cc3fc url=/tableau/current/pt-br/server/explain_data_requirements.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos e considerações para uso do Explique os dados

Explique os dados está sempre disponível para os autores no Tableau Desktop.

Para Tableau Cloud e Tableau Server: quando Explique os dados está habilitado para um site, Creators e Explores com as permissões apropriadas podem executar Explique os dados ao editar uma pasta de trabalho. Todos os usuários com as permissões apropriadas podem executar Explique os dados no modo de exibição em pastas de trabalho publicadas. Para obter mais informações, consulte [Controle de acesso a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm).

## O que torna uma visualização boa candidata para Explique os dados

Explique os dados funciona melhor em visualizações que requerem exploração e análise mais profundas, em vez de visualizações descritivas em estilo infográfico que comunicam dados resumidos.

- Os dados em nível de linha são necessários para Explique os dados criar modelos de seus dados e gerar explicações. Visualizações com dados subjacentes em nível de linha, onde podem existir relacionamentos em campos não visualizados, são bons candidatos para executar o Explique os dados.
- Visualizações baseadas em dados pré-agregados sem acesso a dados em nível de linha não são ideais para a análise estatística realizada por Explique os dados.

## Quais dados funcionam melhor para Explique os dados

Quando estiver usando o Explique os dados em uma planilha, lembre-se que o Explique os dados funciona com:

- **Somente para uma única marca** \- Explique os dados analisa as marcas únicas. Não há suporte para a análise de várias marcas.
- **Dados agregados** - A exibição deve conter uma ou mais medidas agregadas usando SUM, AVG, COUNT ou COUNTD. Pelo menos uma dimensão também deve estar presente na exibição.
- **Somente com fontes de dados únicas**—Os dados devem ser coletados de uma única fonte de dados principal. O Explique os dados não funciona com fontes de dados combinadas ou em cubo.

Ao preparar uma fonte de dados para uma pasta de trabalho, tenha em mente as seguintes considerações se planejar usar o Explique os dados durante a análise.

- Use uma fonte de dados com dados subjacentes que sejam suficientemente amplos. Um conjunto de dados ideal tem pelo menos 10-20 colunas, além de uma (ou mais) medidas agregadas para serem explicadas.
- Dê nomes às colunas (campos) que sejam fáceis de entender.
- Elimine colunas redundantes e artefatos de preparação de dados. Para obter mais informações, consulte [Alterar campos usados para análise estatística](https://help.tableau.com/current/server/pt-br/explain_data_lm_status.htm#IncludeExcludeFields).
- Não descarte colunas não visualizadas na fonte de dados. O Explique os dados considera campos nos dados subjacentes quando analisa uma marca.
- As dimensões de cardealidade baixa funcionam melhor. A explicação de uma dimensão categorizada é mais fácil de interpretar se sua cardinalidade não for muito alta (< 20 categorias). Dimensões com mais de 500 valores únicos não serão consideradas para análise.
- Como regra geral, não agregue previamente os dados. Mas se a fonte de dados for muito grande, considere pré-agregar os dados a um nível de detalhe apropriado.
- Use extrações em fontes de dados em tempo real. As extrações de dados são executadas mais rapidamente do que as fontes de dados em tempo real. Com as fontes de dados em tempo real, o processo de criação de explicações pode gerar muitas consultas (aproximadamente uma consulta para cada explicação candidata), o que pode resultar em mais demora ao gerar explicações.

## Situações em que Explique os dados não está disponível

Às vezes, o Explique os dados não estará disponível para uma marca selecionada, dependendo das características da fonte de dados ou da exibição. Se o Explique os dados não puder analisar o tipo de marca selecionado, o comando Explique os dados e o comando Menu de contexto não estarão disponíveis.

<table class="table--stripes"><colgroup><col style="width: 40%;"><col style="width: 60%;"></colgroup><tbody><tr><td>O Explique os dados não pode ser executado em exibições que usam:</td><td><ul><li>Filtros de coordenadas de mapa</li><li>Fontes de dados combinadas</li><li>Fontes de dados com parâmetros</li><li>Fontes de dados não compatíveis com a sintaxe COUNTD ou COUNT(DISTINCT ...), como o Access.</li><li>Filtros em medidas agregadas</li><li>Medidas desagregadas<br></li></ul></td></tr><tr><td><p>O Explique os dados não pode ser executado se você selecionar:</p></td><td><ul><li>Várias marcas</li><li>Eixo</li><li>Legenda</li><li>Total geral</li><li>Linha de tendência ou linha de referência</li><li>Uma marca em uma exibição que contém um número muito baixo de marcas</li></ul></td></tr><tr><td>O Explique os dados não pode ser executado quando a medida a ser usada para uma explicação:</td><td><ul><li>Não é agregada usando SUM, AVG, COUNT, COUNTD</li><li>É um cálculo de tabela</li><li>É utilizada em valores de medida</li></ul></td></tr><tr><td><p>O Explique os dados não pode oferecer explicações de uma dimensão quando é:</p></td><td><ul><li>Um campo calculado</li><li>Um parâmetro</li><li>Utilizado em Nomes de medida e Valores de medida</li><li>Um campo com mais de 500 valores únicos. Dimensões com mais de 500 valores únicos não serão consideradas para análise.</li></ul></td></tr></tbody></table>

<!-- document id=7258c7e891b735a9a2987740901a857694d5f85c3ff704a29d93e32e84cf0586 url=/tableau/current/pt-br/server/rmt-min-hardware-req.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos mínimos de hardware e recomendações para o Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau realiza todo o processamento, agregação, armazenamento e interface da Web para os dados de monitoramento coletados na instalação do Tableau Server.

## Recomendações mínimas de hardware do servidor RMT

Para uso em produção, a máquina em que você instala o Resource Monitoring Tool deve atender ou exceder as recomendações de hardware abaixo.

- 8 núcleos de CPU físicos (16 vCPUs)
- As CPUs devem suportar conjuntos de instruções SSE4.2 e POPCNT
- RAM de 64GB
- 500 GB de espaço em disco para servidor RMT
- Unidade SSD ou similar para desempenho

Para instalações do servidor RMT que correspondem ao hardware mínimo especificado acima, o Resource Monitoring Tool pode fornecer relatórios de desempenho para implantações do Tableau Server que atendem a até 10.000 exibições por hora.

Para implantações com mais carregamentos de exibições por hora ou números muito altos de trabalhos em segundo plano, podem ocorrer atrasos de dados. Nesses casos, pode ser necessário atualizar seu hardware.  

## Resource Monitoring ToolAgente - Utilização de recursos

O agente do Resource Monitoring Tool monitora o sistema operacional e os processos e arquivos de registro do Windows e do Tableau Server e envia as métricas de desempenho e os dados de registro do Tableau para o Resource Monitoring Tool, para processamento quase em tempo real. O Agente precisa ser instalado em cada máquina que esteja executando o Tableau Server.

Nas instalações do Tableau Server que [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm#minimum-hardware-requirements-for-installation), veja o que esperar:

- Normalmente, vemos o agente usando 0-5% da CPU em média com picos infrequentes acima disso. Nosso alvo de desempenho é uma média de 10% de utilização da CPU ou menos.
- O agente geralmente usa 200 MB de RAM ou menos com picos raros durante os períodos de atividade mais intensa do Tableau Server.
- Recomenda-se no mínimo 10 GB de espaço em disco livre para a máquina em que o Agente é instalado.

## Instalação em um ambiente de nuvem

O Resource Monitoring Tool pode ser instalado em uma máquina virtual em qualquer ambiente de nuvem que possa ser usado para Tableau Servers. A máquina virtual em que o servidor RMT está instalado precisará atender aos mesmos requisitos mínimos de hardware [descritos acima](#RMT).

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ser o seguinte:

- Administrador na máquina que você está instalando o Resource Monitoring Tool.
- Administrador do Tableau Server.
- Administrador do Resource Monitoring Tool.

<!-- document id=4c14fd8b774e8c2d16079f89acb8bc995db44c56512e1a492c5ff089ecca2fd2 url=/tableau/current/pt-br/server/server_hardware_min.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos mínimos de hardware e recomendações para o Tableau Server

Os requisitos mínimos de hardware e as recomendações a seguir aplicam-se a todos os computadores que estão executando o Tableau Server, incluindo hardware físico e máquinas virtuais (VMs):

- Os **requisitos mínimos** são o hardware mínimo que seu computador deverá ter para que a instalação do Tableau Server ocorra. Não recomendamos que você tente executar o Tableau Server em servidores com esses valores, mesmo se estiver apenas testando. Dependendo dos recursos que você licenciou e está usando, pode ter um desempenho ruim e uma experiência irreal. Em certos casos, o Tableau Server não pode ser iniciado sem pelo menos 20 GB de memória.
    
    Para prototipagem e teste de prova de conceito (PoC), recomendamos o uso do Tableau Cloud. Isso lhe dará a oportunidade de experimentar o Tableau Server em um hardware de tamanho adequado.
- As **recomendações mínimas para produção** excedem os requisitos mínimos de instalação e representam a configuração mínima de hardware que você deve usar para a instalação na maioria dos nós de produção. Se seu computador pessoal atender aos requisitos mínimos de instalação, mas não atender a essas recomendações, o programa de instalação o avisará, mas você poderá continuar a instalação. Para determinados nós dedicados a tarefas e processos específicos, como o processador em segundo plano, ou Prep, você pode usar servidores que não atendem a esta recomendação mínima.
    
    As recomendações mínimas listadas aqui são indicadas como orientação geral. No entanto, as recomendações para seu ambiente podem variar. Para obter mais informações, consulte a [Seção de recomendações de hardware](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#hardware-recommendations) do tópico [Configurações de linha de base recomendadas](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm).

Além disso, o Tableau Server não deverá ser instalado em um computador físico ou uma instância de VM que também esteja executando aplicativos que consomem muitos recursos, por exemplo, bancos de dados, servidores de aplicativos ou uma instância de VM que usa recursos compartilhados.

**Observação**: Se você instalar o Tableau Server em um computador que atende aos requisitos mínimos de hardware, mas não tiver pelo menos 8 núcleos e 16 GB de memória do sistema, os padrões serão reduzidos para uma instância de cada processo por padrão. Para obter mais informações sobre processos, consulte [Limites de processo do servidor](https://help.tableau.com/current/server/pt-br/distrib_process.htm)

Procurando o Tableau Server no Linux? Consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server-linux/pt-br/server_hardware_min.htm "Abre o tópico em uma nova guia do navegador")

## Requisitos de mínimos de hardware para instalação

Recomendamos enfaticamente que qualquer teste de prova de conceito (PoC) ou prototipagem seja feito usando o Tableau Cloud. Isso garante que você estará executando em sistemas com recursos adequados.

O computador no qual você está instalando ou atualizando o Tableau Server deve atender aos requisitos mínimos de hardware para instalação. Se o programa de instalação determinar que seu computador pessoal não atende aos requisitos a seguir, você não será capaz de instalar o Tableau Server. Atender a esses requisitos não garante uma boa experiência no teste do Tableau Server

Para obter mais informações sobre como o programa de Instalação determina o hardware, consulte [Determinação do hardware do computador](#Determin).

**Requisitos mínimos de hardware**

Esses requisitos mínimos são para instalar o Tableau Server. Eles não garantem testes ou uso bem-sucedidos. Para obter as recomendações mínimas de produção, consulte [Recomendações mínimas de hardware para produção](#MinRecs).

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 8%;"><col style="width: 10%;"><col style="width: 6%;"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><em>Processador</em></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>CPU</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>RAM</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Espaço livre em disco</i></p></th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td><ul><li>64-bit (chipsets de x64)</li><li>Deve aceitar conjuntos de instruções SSE4.2 e POPCNT</li><li>Os processadores baseados em ARM não são suportados</li></ul></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>4 núcleos (8 vCPUs)</p></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>Versão 2022.3 e posteriores:</p><ul><li>64 GB - nó inicial</li><li>16 GB - nós adicionais</li></ul><p>Versão 2022.1 e anteriores:</p><ul><li>16 GB - todos os nós</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>15 GB</p></td></tr></tbody></table>

- O espaço livre em disco será calculado após a extração do programa de Instalação do Tableau Server. O programa de instalação usa cerca de 1 GB de espaço. Pode ser necessário alocar espaço em disco adicional dependendo de vários fatores, como estar usando extrações.
- A contagem de núcleos baseia-se nos núcleos "físicos". Núcleos físicos podem representar hardware de servidor reais ou em uma máquina virtual (VM). O hyper-threading é ignorado para a finalidades de contar núcleos.

## Recomendações mínimas de hardware para produção

Para uso em produção, os computadores no quais você instala ou atualiza o Tableau Server deverão atender ou exceder as recomendações mínimas de hardware. Estas recomendações são gerais. As necessidades reais do sistema para as instalações do Tableau Server podem variar com base em muitos fatores, incluindo o número de usuários e o número e tamanho das extrações, bem como os recursos que você licenciou. Se o programa de instalação determinar que o seu computador não atende às recomendações a seguir, você receberá um aviso, mas poderá continuar com o processo de instalação. Para obter mais informações, consulte [Recomendações de hardware para instalações de produção](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#Hardware).

<table class="table--plain"><colgroup><col><col style="width: 214px;"><col><col><col></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Tipo de instalação</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Processador</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>CPU</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>RAM</i></p></th><th style="text-align: left;" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><p><i>Espaço livre em disco</i></p></th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3"><p>Nó único</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>64 bits (chipsets de x86_64)</li><li>Deve aceitar conjuntos de instruções SSE4.2 e POPCNT</li><li>Os processadores baseados em ARM não são suportados</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>8 núcleos (16 vCPUs), 2.0 GHz ou superior</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Versão 2022.3 e posteriores:</p><ul><li>128 GB</li></ul><p>Versão 2021.4.0 para versão 2022.1.x:</p><ul><li>64 GB</li></ul><p>Versão 2021.3.x e anteriores:</p><ul><li>32 GB</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>50 GB</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Se estiver adicionando o Tableau Prep Conductor à sua instalação do Tableau Server, recomendamos adicionar um segundo nó e dedicá-lo para a execução do Prep Conductor no Tableau Server. Esse nó deve ter um mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="4">Memória de troca recomendada: configuração padrão do arquivo de paginação do Windows. </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>Implantações empresariais e de vários nós</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" colspan="4"><p colspan="4">Entre em contato com o Tableau para obter orientação técnica.</p><p>Os nós devem atender às recomendações mínimas de hardware ou excedê-las, exceto:</p><ul><li><p>Nós dedicados do Processador em segundo plano executando até duas instâncias nele, onde 4 núcleos podem ser aceitáveis.</p></li><li><p>Nó dedicado para o Tableau Prep Conductor: mínimo de quatro núcleos (8 vCPUs) e 16 GB de RAM.</p></li><li><p>Nó dedicado para Independent Gateway: mínimo de 2 núcleos (4 vCPUs), 8 GB de RAM e 100 GB de espaço livre em disco.</p></li></ul></td></tr></tbody></table>

**Importante:** o requisito de espaço em disco não pode ser verificado até que você inicialize o TSM.

- O espaço livre em disco será calculado após a extração do programa de Instalação do Tableau Server. O programa de instalação usa cerca de 1 GB de espaço. Pode ser necessário alocar espaço em disco adicional dependendo de vários fatores, como estar usando extrações.
- **Requisitos de espaço de armazenamento conectado à rede para armazenamento de arquivo externo:** se você estiver planejando configurar o [Tableau Server com armazenamento de arquivo externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm), precisará estimar a quantidade de espaço de armazenamento para dedicar em seu armazenamento conectado à rede.
    
    Estimativa do tamanho do armazenamento: você deve levar em consideração a quantidade de armazenamento necessária para publicar e atualizar as extrações. Além disso, você também deve levar em consideração o tamanho do backup do repositório, a menos que escolha especificamente a opção de fazer o backup do repositório separadamente, conforme descrito no tópico [Opção 2: repositório de backup separadamente](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm#backup-repository-separately)
    
    - Extrações:
        - Considere o número de extrações que será publicado no Tableau Server e o tamanho de cada extração. Teste as suas necessidades ao publicar várias extrações no Tableau Server e, em seguida, verifique o espaço em disco usado. Você pode usar essa quantidade de espaço em disco para ajudar a descobrir quantas extrações serão publicadas no Tableau Server no decorrer do tempo, além de como cada extração existente terá o tamanho aumentado.
        - Considere o espaço necessário pelo diretório temp durante uma atualização de extração. O diretório temp, que armazena uma extração durante a atualização, pode necessitar de um tamanho três vezes maior que o do arquivo final.
    - Backup do repositório:
        - Para obter uma estimativa dos dados do repositório, verifique o tamanho do diretório `<data directory>/pgsql/data/base`.
        - Para obter o tamanho exato dos dados de repositório, abra o arquivo de backup e use o tamanho do arquivo `workgroup.pg_dump`.
- A contagem de núcleos baseia-se nos núcleos "físicos". Núcleos físicos podem representar hardware de servidor reais ou em uma máquina virtual (VM). O hyper-threading é ignorado para a finalidades de contar núcleos.
- A RAM mostrada é o mínimo recomendado para uma instalação de um nó único. A instalação pode funcionar melhor com mais RAM, dependendo da atividade, do número de usuários e dos trabalhos em segundo plano.

Para ver a lista completa de recomendações e os requisitos mínimos, consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](#). Para as especificações de hardware, o Tableau testa a escalabilidade internamente, consulte [Recomendações de hardware para instalações de produção](https://help.tableau.com/current/server/pt-br/server_baseline_config.htm#Hardware).

Para obter as recomendações do hardware para o Tableau Server na nuvem, consulte o seguinte:

- [Selecionar um tipo e um tamanho de instância AWS](https://help.tableau.com/current/server/pt-br/ts_aws_virtual_machine_selection.htm)
- [Selecionar um tipo e tamanho da máquina virtual do Google Compute Engine](https://help.tableau.com/current/server/pt-br/ts_gcp_virtual_machine_selection.htm)
- [Seleção de um tipo e um tamanho de máquina virtual do Microsoft Azure](https://help.tableau.com/current/server/pt-br/ts_azure_virtual_machine_selection.htm)

## Determinação do hardware do computador

O programa de instalação do Tableau Server consulta o sistema operacional para determinar quantos núcleos físicos um computador tem. Para exibir as informações de hardware que o programa de instalação detectou no seu computador, abra o arquivo `app-install.log` na pasta a seguir do computador no qual o Tableau Server está sendo instalado:

<install directory>\\ProgramData\\Tableau\\Tableau Server\\logs\\app-install.log

No arquivo `app-install.log`, procure linhas similares às seguintes. Essas linhas fornecem informações sobre os núcleos físicos detectados pelo programa de instalação e usados para determinar a contagem de núcleos utilizada para o licenciamento, bem como a quantidade de memória do sistema detectada.

2020-11-24 17:40:43.842 +0000 main : DEBUG com.tableausoftware.tabadmin.configuration.builder.BootstrapConfigurationBuilder - System processor count = 8

2020-11-24 17:40:43.842 +0000 main : DEBUG com.tableausoftware.tabadmin.configuration.builder.BootstrapConfigurationBuilder - System memory = 64383MB

### Determinando manualmente o número de núcleos em seu computador

**Observação:** esse procedimento substitui um processo antigo para determinar o número de núcleos usando o WMIC, que foi preterido pela Microsoft.

Para determinar manualmente quantos núcleos físicos há no servidor, você pode usar o Powershell. Isso é útil se você não souber se seu computador irá ou não atender aos requisitos mínimos de hardware para a instalação do Tableau Server.

1. Abra o Powershell.
2. Digite o seguinte comando, que lista os processadores lógicos, bem como os núcleos físicos:
    
    Get-CimInstance -ClassName Win32\_Processor | Select-Object DeviceID, NumberOfCores, NumberOfLogicalProcessors
    
    ![Uma janela de prompt de comando exibe a ID do dispositivo e o número de núcleos da CPU de um computador.](/tableau/current/pt-br/server/pt-br/Img/server_hardware_cores-powershell.jpg)
    
    Neste exemplo acima, o servidor tem um total de dezoito núcleos físicos, resultando em 36 núcleos lógicos.

<!-- document id=66ed5ca2a87892ab6c6aa649198ada282b2b29f4f76ce5ef5bdf95e4e0c87ec2 url=/tableau/current/pt-br/server/openid_auth_requirements.md -->

[Pular para o conteúdo principal](#main-content)

# Requisitos para usar o OpenID Connect

Este tópico descreve os requisitos para usar o OpenID Connect com Tableau Server.

**Observação:** Os comandos de configuração de autenticação do TSM se aplicam apenas à autenticação OIDC configurada no TSM durante a instalação do Tableau Server. Para fazer alterações de configuração de autenticação OIDC para grupos de identidade, você pode usar o endpoint [Atualizar configuração de autenticação](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#operation/AuthnService_UpdateAuthConfiguration) usando Tableau REST OpenAPI.

**Resumo dos requisitos**

- Conta do IdP
- Armazenamento de identidades local
- Reivindicações de IdP – mapeamento de usuários
- Contexto de autenticação

## Conta do IdP

Você deve ter acesso a um provedor de identidade (IdP) que suporte o protocolo OpenID Connect (OIDC). Também deve ter uma conta com o IdP. O OpenID Connect é suportado por muitos provedores de identidade. O protocolo OIDC é um padrão aberto e flexível. Por isso, nem todas as implementações do padrão são idênticas. Enquanto você configura o Tableau Server para OIDC, trabalhe com seu IdP.

A implementação do IdP do Google foi amplamente testada com o Tableau Server e é o modelo IdP para a configuração documentada nestes tópicos.

## Armazenamento de identidades local

Para usar o OpenID Connect no Tableau Server, uma das seguintes opções deve ser verdadeira:

- **Se configurar o OIDC no TSM durante a instalação do Tableau Server**, o Tableau Server deve ser configurado para usar um armazenamento de identidade local. O servidor deve ser configurado para que você crie explicitamente usuários no Tableau Server, em vez de importá-los de um diretório externo, como o Active Directory. Gerenciar usuários com um armazenamento de identidade externa não é suportado com OpenID.
- **Se configurar o OIDC usando** [pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm), OIDC pode ser configurado com 1) um armazenamento de identidade local ou 2) AD ou LDAP é o armazenamento de identidade configurado no TSM durante a instalação do Tableau Server.

## Reivindicações de IdP – mapeamento de usuários

Para entrar com sucesso no Tableau Server, um determinado usuário deve ser provisionado no IdP do OpenID e mapeado para uma conta de usuário no Tableau Server. O OpenID usa um método que depende que as _reivindicações_ compartilhem os atributos da conta de usuário com outros aplicativos. As reivindicações incluem atributos de conta de usuário, como e-mail, número de telefone, nome etc. Para compreender como o Tableau Server mapeia as reivindicações de IdP nas contas de usuário, consulte [OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth.htm#Authenti).

O Tableau Server depende que a reivindicação de IdP mapeie as contas de usuário do IdP para as hospedadas no Tableau Server. Por padrão, o Tableau Server espera que o IdP passe a reivindicação de e-mail. Dependendo do IdP, talvez seja necessário configurar o Tableau Server para usar uma reivindicação de IdP diferente.

Se estiver usando o Google como uma reivindicação de IdP, então use o padrão `email` para mapear as identidades do IdP para as contas de usuário do Tableau Server. Se não estiver usando o Google como um IdP, então trabalhe com o seu IdP para determinar a reivindicação na qual o Tableau Server deve ser configurado.

### Padrão: uso de reivindicação de e-mail para mapear usuários

Por padrão, o nome de usuário no Tableau Server deve coincidir com a reivindicação de `email` no token de ID do IdP. Portanto, na configuração padrão, use endereços de e-mail (também conhecidos como UPN) como o nome de usuário no Tableau Server. Se usar oGoogle como IdP, o nome de usuário no Tableau Server deve ser o Gmailendereço (`alice@gmail.com`). O uso de um endereço de e-mail completo ajudará a garantir a exclusividade do nome de usuário no Tableau Server, mesmo se dois usuários tiverem o mesmo e-mail, mas em hosts de e-mail diferentes.

**Observação**: quando você cria uma identidade de usuário no Tableau Server, deve especificar um nome de usuário, senha e, como opção, um endereço de e-mail. Para usar o OpenID Connect na configuração padrão, o nome de usuário (expressado como um endereço de e-mail) é o valor que deve corresponder ao nome de usuário no IdP. O endereço de e-mail opcional na identidade de usuário do Tableau Server não é usado para autenticação do OpenID.

#### Como ignorar o nome de domínio

Você pode configurar o Tableau para ignorar a parte de domínio de um endereço de e-mail, ao corresponder a reivindicação de IdP `email` à conta de usuário no Tableau Server. Neste cenário, a reivindicação `email` no IdP pode ser `alice@example.com`, mas isso vai corresponder a um usuário chamado `alice` no Tableau Server. Ignorar o nome de domínio pode ser útil se você já tiver usuários definidos no Tableau Server que correspondam à parte dos nomes de usuário da reivindicação `email`, mas não às partes de domínio.

**Importante**: não recomendamos ignorar o nome de domínio do usuário sem tomar precauções. Especificamente, verifique se os nomes de usuário são exclusivos em todos os domínios configurados que você criou no seu IdP.  
  
Definir o Tableau Server para ignorar o nome de domínio pode resultar em logon não intencional do usuário. Considere o caso em que seu IdP tenha sido configurado para vários domínios (`example.com` e `tableau.com`). Se dois usuários com o mesmo nome, mas diferentes contas de usuário (`alice@tableau.com` e `alice@example.com`) estiverem na sua empresa, então o primeiro a concluir a sequência de provisionamento de OpenID será responsável pelo `sub` do IdP. Se o usuário errado for mapeado, então o outro usuário não poderá efetuar logon até que o `sub` associado seja redefinido.

Para configurar o Tableau Server para ignorar os nomes de domínio nos nomes de usuário do IdP, defina `tsm authentication openid configure --ignore-domain` como `true`. Para obter mais informações, consulte [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC).

Ao alterar a opção tsm authentication openid configure `--ignore-domain` para ignorar o domínio nos nomes de usuário, todos os nomes de usuário do Tableau Server devem ter um nome de domínio.

### Uso de reivindicações personalizadas para mapear usuários

Conforme mencionado na [OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth.htm#Authenti), a reivindicação `sub` é frequentemente incluída nas reivindicações de IdP. Normalmente, a reivindicação `sub` é uma cadeia de caracteres exclusiva que identifica uma determinada conta de usuário. A vantagem de usar uma reivindicação `sub` é que ela não será alterada, mesmo se você ou outro administrador atualizar outros atributos de usuário ou reivindicações de IdP (e-mail, número de telefone, etc.) associados a essa conta. Por padrão, o Tableau Server identifica e verifica usuários do OpenID de acordo com a reivindicação `sub` no token de ID do IdP.

O valor da reivindicação `sub` do OpenID deve ser mapeado para o usuário correspondente no Tableau Server. Como a reivindicação `sub` é uma cadeia de caracteres arbitrária, uma reivindicação diferente é usada para associar as contas durante a primeira sessão de logon. A primeira vez que um usuário entrar no Tableau Server com o OpenID, o Tableau vai corresponder a conta de usuário do OpenID à uma conta de usuário correspondente no Tableau Server. Por padrão, o Tableau usará a reivindicação de IdP, `email`, para identificar o usuário do Tableau. O Tableau atualizará o registro deste usuário com a reivindicação `sub` do OpenID. Como o token de ID sempre inclui a reivindicação `sub` com outras reivindicações, nas sessões subsequentes, o Tableau identificará este usuário apenas com a reivindicação `sub`.

Para algumas organizações, mapear nomes de usuário com o endereço de e-mail não é confiável ou não é suportado pelo IdP. A partir do Tableau Server 10.2, é possível mapear as contas de usuário de qualquer reivindicação de IdP arbitrária para o nome de usuário do Tableau Server.

A reivindicação de IdP usada deve mapear exatamente para um nome de usuário do Tableau Server correspondente. No exemplo abaixo, o nome de usuário é `kwilliams`.

![Um formulário para adicionar um novo usuário no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/users_add_srvruser.png)

Para alterar a reivindicação do IdP usado para mapear a identidade no Tableau Server, use o comando `tsm authentication openid map-claims --user-name`. Para obter mais informações, consulte [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC).

### Alteração da reivindicação `sub`

Como descrito acima, a reivindicação `sub` é o identificador que o Tableau Server usa para identificar usuários após a sessão de mapeamento inicial. A reivindicação `sub` é gravada na conta de usuário correspondente no Tableau Server. Se o IdP não fornecer uma reivindicação `sub`, é possível especificar uma reivindicação arbitrária para ser usada. Como `sub`, o valor da reivindicação especificado deve ser exclusivo e não deve ser alterado quando outras reivindicações do usuário forem atualizadas.

Para especificar uma reivindicação de IdP diferente como padrão de reivindicação sub, use o comando `tsm authentication openid map-claims --id`. Para obter mais informações, consulte [tsm authentication openid <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMOIDC).

Onde `arbitraryClaim` é o nome da reivindicação de IdP que você deseja usar como o substituto para a reivindicação `sub`.

## Contexto de autenticação

Se o IdP do OpenID Connect exigir um contexto específico de autenticação, você pode especificar uma lista de valores ACR essenciais e voluntários usando as teclas de configuração `vizportal.openid.essential_acr_values` e `vizportal.openid.voluntary_acr_values`. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

<!-- document id=c163b51b3386364db5a7e7d1cfe6feacc4c491152e514516fd4b0511ad634134 url=/tableau/current/pt-br/server/identity_migration_conflicts.md -->

[Pular para o conteúdo principal](#main-content)

# Resolver conflitos de migração de identidade

Durante a migração de identidade, o Tableau Server pode encontrar determinadas identidades de usuário que não podem ser migradas para usar o Serviço de Identidade. Quando as identidades de usuário não podem ser migradas, elas se tornam conflitos de identidade que exigem que você, como administrador, resolva manualmente.

Para garantir que as identidades de usuário sejam migradas corretamente, você deve resolver todos os conflitos de identidade antes que a migração de identidade possa ser concluída usando a página dedicada de Migração de Identidade.

## Etapa 1: resolver conflitos de identidade

Você pode resolver conflitos de identidade de algumas maneiras, dependendo do tipo de conflito. Independentemente do tipo de conflito, todas as identidades de usuário devem ser resolvidas ou endereçadas antes que você possa prosseguir para a [Etapa 2](#step2) abaixo e antes que o processo de migração de identidade possa ser concluído.

Quando ocorrerem conflitos de identidade, a migração de identidade agrupará os conflitos em tipos. Esses tipos ajudam a restringir o motivo pelo qual a migração não consegue migrar a identidade do usuário automaticamente.

Existem algumas razões pelas quais os conflitos de identidade podem ocorrer. Por exemplo, você pode ver um conflito de identidade quando a migração identificou um usuário do Tableau Server que corresponde a mais de uma identidade de usuário no armazenamento de identidades externo.

Quando os conflitos de identidade são identificados, você pode resolvê-los usando uma das seguintes opções:

- **Repetir a migração** - Essa opção move as identidades de usuário selecionadas de volta para a fila para serem migradas novamente. Depois que os trabalhos de migração forem executados novamente, é possível que os conflitos de identidade sejam resolvidos por conta própria, os conflitos de identidade originais ocorram novamente ou novos conflitos de identidade ocorram.
- **Reconhecer** - Essa opção move as identidades de usuário selecionadas para a guia Reconhecido. Ao reconhecer as identidades dos usuários, você entende que 1) esses usuários não têm identidades de usuário correspondentes em um armazenamento de identidades e, portanto, não serão migrados e 2) esses usuários não poderão entrar no Tableau Server depois que você habilitar a identidade Serviço na [Etapa 3](#step3) abaixo.
- **Reavaliar** - Quando os conflitos já foram reconhecidos, na guia Reconhecido, esta opção move as identidades de usuário selecionadas de volta ao seu estado de conflito. Essa opção lhe dá a chance de ver o conflito original, resolver o conflito ou reconhecer o conflito de identidade novamente.

### Referência rápida: conflitos de identidade

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;font-weight: bold;">Tipo de conflito</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;font-weight: bold;">Aplica-se à configuração</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;font-weight: bold;">Motivo do conflito</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;font-weight: bold;">Action</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Todas as falhas</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Todos</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Essa guia captura todos os conflitos de identidade categorizados nas guias Sem correspondência, Ambíguo, Duplicado, Não local e Desconhecido.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Repetir a migração ou confirmar</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Sem combinações</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AD, LDAP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">As identidades dos usuários não têm usuários correspondentes no armazenamento de identidades externo.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Repetir a migração ou confirmar</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ambíguo</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AD, LDAP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Para as identidades de usuário especificadas, há mais de uma correspondência possível no armazenamento de identidades externo.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Repetir a migração, Reconhecer ou selecione uma das identidades de usuário sugeridas</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Duplicado</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AD</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Duas identidades de usuário foram criadas usando uma conta do AD. Este é um artefato de funcionalidade herdada que não tem suporte no Serviço de Identidade.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Repetir a migração ou confirmar</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não local</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Local</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Identidades de usuário associadas a um armazenamento de identidades que não é local. Esse conflito ocorre porque foram feitas alterações manuais que não são suportadas.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Repetir a migração ou confirmar</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Desconhecido</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Todos</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Esse conflito pode indicar um erro interno do Tableau Server ou um conflito de identidade causado por um motivo não listado nesta tabela.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Repetir a migração ou confirmar</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Reconhecido</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Todos</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Essa guia captura todas as identidades de usuários que não serão migradas. Esses usuários não poderão entrar no Tableau Server depois que o Tableau Server for configurado para usar o Serviço de identidade.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Repetir a migração ou confirmar</td></tr></tbody></table>

Para solucionar um conflito, siga as etapas descritas abaixo.

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade.

1. Selecione uma ou mais identidades de usuário na guia Todas as falhas ou em uma das guias específicas de conflito.
2. No menu suspenso Ações, clique em Repetir migração ou Reconhecer .
    
    Se você selecionar “Repetir a migração”, as identidades do usuário podem gerar diferentes tipos de conflito. Nesse caso, resolva os conflitos, conforme necessário, até que a guia Todas as falhas exiba "0" como na imagem abaixo.
    
    ![Resumo da migração de identidade mostrando zero falhas.](/tableau/current/pt-br/server/pt-br/Img/id_mig_failures_acknowledge.png)
    
    **Observação:** as identidades de usuário reconhecidas serão ignoradas nas sincronizações de grupos do Active Directory (AD) e LDAP no futuro. Se os usuários associados a essas identidades de usuários precisarem de acesso ao Tableau Server posteriormente, consulte [Solucionar problemas com a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm#acknowledged) para obter mais informações.

## Etapa 2: concluir a migração de identidade

Para concluir a migração de identidade, além de todos os conflitos de identidade serem resolvidos ou endereçados, todos os trabalhos de migração precisam ser executados antes que você possa habilitar o Serviço de identidade para Tableau Server.

1. Execute _um_ destes procedimentos:
    
    - Para executar os trabalhos de migração de identidade agora, ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento e selecione Executar agora.
        
        ![Menu suspenso para editar o agendamento de migração com opções para desativar ou executar agora.](/tableau/current/pt-br/server/pt-br/Img/id_mig_overview_runnow.png)
    - Como alternativa, você pode aguardar a execução da migração durante o próximo horário agendado.
2. Na página Migração de identidade, confirme se a Visão geral da migração mostra 100% concluída.
    
    ![Barra de progresso da migração de identidade indicando 100% de conclusão.](/tableau/current/pt-br/server/pt-br/Img/id_mig_complete.png)

## Etapa 3: configurar o Tableau Server para usar o Serviço de identidade

Após a conclusão da migração de identidade, configure o Tableau Server para usar o Serviço de identidade para garantir uma estrutura de identidade mais segura e imutável para o processo de autenticação e provisionamento de usuários.

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute os seguintes comandos dependendo da versão do Tableau Server que você está executando:
    
    - Para as versões 2022.1.8 (e posteriores), 2022.3.10 (e posteriores), 2023.1.6 (e posteriores) e posteriores do Tableau Server:
        
        ```
        tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
        ```
    - Para as versões 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server:
        
        ```
        tsm authentication legacy-identity-mode disable
        ```
    
    **Observação:** depois de executar um dos comandos acima, a página dedicada de Migração de identidade é removida e não está mais acessível. A página só é acessível quando `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled` is `true` ou `tsm authentication legacy-identity-mode` está ativado.

Depois que o Tableau Server é configurado para usar o Serviço de Identidade, quando os usuários entram no Tableau Server, o Tableau Server pesquisa suas identidades de usuário usando seus identificadores no repositório de identidades configurado. A partir dos identificadores, os identificadores exclusivos universais (UUID) são retornados e usados para corresponder às identidades de usuário existentes do Tableau Server. Esse processo gera sessões para os usuários e conclui o fluxo de trabalho de autenticação.

## Etapa 4: certifique-se de que os pools de identidade estejam habilitados

1. Execute os seguintes comandos:
    
    ```
    tsm configuration set -k features.IdentityPools -v true
    tsm pending-changes apply
    ```

**Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado.

<!-- document id=80d01eb17dcad209218585910b284ae4003984a19f03eb8f13a04c3bf227d324 url=/tableau/current/pt-br/server/rmt-incidents-index-incidents.md -->

[Pular para o conteúdo principal](#main-content)

# Resource Monitoring Tool do Tableau - Incidentes

Os incidentes são relatados para eventos que são incomuns e podem exigir atenção humana. Eles podem ser configurados para uma variedade de eventos em nível global ou podem ser personalizados para cada ambiente.

Para ver os incidentes atuais relatados para um ambiente, depois de selecionar um ambiente, no menu Incidentes, selecione Todos os incidentes para ver uma lista de todos os incidentes registrados e relatados.

Você também pode receber uma notificação por e-mail ou Slack, dependendo de suas configurações de notificações. Para saber mais sobre como funcionam as notificações, veja [Notificações](https://help.tableau.com/current/server/pt-br/rmt-config-configGui.htm#notifications).

Geralmente, você pode categorizar os incidentes em dois tipos:

1. Incidentes que são definidos por padrão e não podem ser alterados. Vamos nos referir a eles como “ **incidentes definidos pelo sistema**”.
2. Incidentes que podem ser configurados por você. Vamos nos referir a eles como “**incidentes configuráveis**”.

Todos os incidentes têm um nível de gravidade de incidente. O nível de gravidade é algo que é especificamente definido. Para incidentes definidos pelo sistema, Resource Monitoring Tool define os níveis de gravidade e, para incidentes configuráveis, você define o nível de gravidade dependendo do que é certo para seu ambiente.

Aqui está a lista de níveis de gravidade:

| Nível de severidade | Chave | Descrição |
| --- | --- | --- |
| Informações | `information` | Quando você deseja ser informado de um incidente que não cause interrupção do serviço. |
| Aviso | `warning` | Incidentes que causam possíveis interrupções de serviço. |
| Crítico | `critical` | Incidentes que causam grande interrupção do serviço ou o serviço está totalmente fora do ar. |

## Incidentes definidos pelo sistema

Veja a seguir uma lista de incidentes do sistema que são definidos por padrão e não podem ser alterados.

<table class="simple-table"><thead><tr class="header"><th style="text-align: left;">Incidente</th><th style="text-align: left;">Nível do incidente</th><th style="text-align: left;">Descrição</th></tr></thead><tbody><tr class="odd"><td style="text-align: left;">Agente inativo</td><td style="text-align: left;"><p><code>warning</code></p></td><td style="text-align: left;">Um incidente é registrado e relatado quando um ou mais Agentes estão inativos, e o Servidor RMT não consegue se comunicar com o Agente.</td></tr><tr class="odd"><td style="text-align: left;">Agente não licenciado</td><td style="text-align: left;"><code>critical</code></td><td style="text-align: left;"><p>Isso pode acontecer se o Tableau Server não estiver devidamente licenciado para usar a Resource Monitoring Tool do Tableau, ou devido a problemas de conexão. Para obter mais informações sobre as possíveis causas, consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-incidents-agents-unlicensed.htm" class="xref">Incidentes de agente</a></p></td></tr><tr class="even"><td style="text-align: left;">Ambiente inativo</td><td style="text-align: left;"><code>critical</code></td><td style="text-align: left;">Um incidente é registrado e relatado quando o Tableau Server está off-line.</td></tr></tbody></table>

## Incidentes configuráveis

Esses incidentes podem ser configurados com base nas características do seu ambiente e nas prioridades organizacionais. A seguir estão os eventos que você pode configurar níveis de gravidade e/ou limites. Os links fornecem mais detalhes sobre o que você pode configurar para cada um dos eventos.

- [Incidentes de falha de extração](https://help.tableau.com/current/server/pt-br/rmt-incidents-extract-failure.htm)
- [Incidentes de hardware](https://help.tableau.com/current/server/pt-br/rmt-incidents-hardware.htm): inclui uso de CPU e memória, disponibilidade de memória, espaço em disco e comprimento da fila de disco.
- [Incidentes de Hyper Spooling](https://help.tableau.com/current/server/pt-br/rmt-incidents-hyper-spooling.htm)
- [Incidentes de consulta lenta](https://help.tableau.com/current/server/pt-br/rmt-incidents-slow-query.htm)
- [Incidentes de exibições lentas](https://help.tableau.com/current/server/pt-br/rmt-incidents-slow-view.htm)

Para configurar incidentes em nível global:

1. No menu Admin, selecione Configuração global.
2. Na guia Incidentes, configure o limite e os níveis de gravidade dos incidentes.

As configurações globais são aplicadas a ambientes existentes ou a quaisquer novos ambientes criados, a menos que estejam usando limites personalizados.

## Outros artigos nesta seção

<!-- document id=4eaf232f800eda50d90d0ef693dcea037214c84bbbd9c75e32847e7d6f7ae7e2 url=/tableau/current/pt-br/server/rmt-admin-logs-security.md -->

[Pular para o conteúdo principal](#main-content)

# Resource Monitoring Tool do Tableau Arquivos de registro de segurança

A partir da versão 2025.3.4, Resource Monitoring Tool do Tableau (RMT) no Linux registra uma variedade de eventos que os clientes podem precisar rastrear para conformidade de segurança. Esses eventos incluem logons, gerenciamento de usuários (criar/atualizar/excluir usuários) e alterações no arquivo de configuração. Esse registro é habilitado automaticamente e não pode ser desabilitado ou desativado.

**Observação:** em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## Sistemas operacionais compatíveis

O registro de segurança no RMT está nos seguintes sistemas operacionais:

- Linux
- Windows

## Locais de registro de segurança

Os registros de segurança são gravados em subpastas nestes locais:

Linux:

/var/opt/tableau/tabrmt/master/logs/Activity/Security/<folder>

/var/opt/tableau/tabrmt/agent/logs/Activity/Security/<folder>

Windows:

C:\\Program Files\\Tableau\\Tableau Resource Monitoring Tool\\master\\logs\\Activity\\Security\\<folder>

C:\\Program Files\\Tableau\\Tableau Resource Monitoring Tool\\agent\\logs\\Activity\\Security\\<folder>

### Componentes

<table class="simple-table"><colgroup><col style="width: 13%;"><col style="width: 26%;"></colgroup><thead><tr class="header"><th><p>Segurança</p></th><th>Descrição</th></tr></thead><tbody><tr class="odd"><td>Logons</td><td>Registros gerados pelo logon e logoff do usuário.</td></tr><tr class="even"><td>Gerenciamento de usuários (criar/atualizar/excluir)</td><td>Registros gerados quando um usuário é criado, atualizado ou excluído.</td></tr><tr class="odd"><td>Comandos rmtadmin</td><td><p>Registros gerados por qualquer comando rmtadmin. Os registros estão em pastas com nomes baseados no comando emitido. Por exemplo, para <code>rmtadmin cleanup</code>, seriam gerados registros em uma pasta <code>rmtadmin_cleanup</code>.</p></td></tr></tbody></table>

## Como funciona o registro de segurança

Quando ocorre qualquer um dos eventos de acionamento, uma entrada é adicionada a um dos registros de segurança. Os eventos de acionamento que resultam em uma entrada de registro incluem:

- Logons e logoffs de usuários
    
    Sempre que um usuário, incluindo os usuários administradores, entrar ou sair.
- Gerenciamento de usuários
    
    Sempre que um usuário for criado, atualizado ou excluído.
- Alterações de configuração
    
    Sempre que uma ação atualiza o arquivo de configuração.

## Quem pode fazer isso

O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função **Gerente de servidor/ambiente**.

<!-- document id=e2ea7983bf376f896bb3e1e9ca30719eb546226dbaf29ddb6a0d278f5d57d03b url=/tableau/current/pt-br/server/rmt-prereqs-license-terms.md -->

[Pular para o conteúdo principal](#main-content)

# Resource Monitoring Tool do Tableau Pré-requisitos - Licenças

O Resource Monitoring Tool do Tableau contém os seguintes aplicativos de código aberto:

| VERSÃO RMT | VERSÃO OPENSSL | VERSÃO ERLANG | VERSÃO RABBITMQ | VERSÃO POSTGRESQL |
| --- | --- | --- | --- | --- |
| 2022.1 | Misto/Em pacote | 24.1 | 3.9.7 | 13.3 |
| 2022.2 | Misto/Em pacote | 24.3 | 3.9.13 | 13.3 |
| 2022.3 - 2023.1 | 1.1.1q | 24.3.4.2 | 3.10.5 | 13.7 |
| 2023.2 - 2024.3 | 1.1.1t | 24.3.4.10 | 3.10.20 | 13.7 |
| 2025.1 | 3.1.5.20240229235146 | 24.0 | 3.8.16 | 12.6 |

- **Erlang:** Copyright 2016 Industrial Erlang User Group, Apache 2.0. Para obter mais informações, consulte os sites da [Erlang](https://www.erlang.org/) e [Apache 2.0.](https://www.apache.org/licenses/LICENSE-2.0)
- **RabbitMQ:** Copyright, MPL 2.0, Copyright (c) 2007-2021 VMware, Inc. ou suas afiliadas. Para obter mais informações, consulte o site [Licenciamento do Mozilla Público](https://www.rabbitmq.com/mpl.html).
    
    O Resource Monitoring Tool contém um único arquivo de origem RabbitMQ modificado, que está disponível mediante solicitação.
- **PostgreSQL:** Copyright, Partes de Copyright © 1996-2021, The PostgreSQL Global Development Group, Partes de Copyright © 1994, The Regents of the University of California, licença PostgreSQL. Para obter mais informações, consulte o site [PostgreSQL](https://www.postgresql.org/about/licence).
- **OpenSSL:** Copyright (c) 1998-2019 The OpenSSL Project, Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson, licença OpenSSL, licença dupla sob a Licença OpenSSL e a licença SSLeay original. Para obter mais informações, consulte [Licença do OpenSSL](https://www.openssl.org/source/license-openssl-ssleay.txt).[](https://www.openssl.org/source/license-openssl-ssleay.txt)

<!-- document id=b6bd8753bfa59cb9c0d205f2583f3c334427de8e15338fcbfe1d9c273427ac16 url=/tableau/current/pt-br/server/rmt-admin-upgrade-faqs.md -->

[Pular para o conteúdo principal](#main-content)

# Resource Monitoring Tool Perguntas frequentes sobre a atualização

Encontre respostas para perguntas frequentes durante a atualização.

## Posso executar os scripts sem privilégios de root/administrador?

Quando os scripts são executados automaticamente por meio do instalador, o instalador tem os privilégios necessários. Para fazer uma execução manual, você precisa de root (Linux) ou administrador (Windows) porque os scripts inspecionam o status do serviço, as permissões de arquivo e executam comandos como a conta de serviço RMT.

## E se eu não souber a senha do banco de dados?

Todas as verificações dependentes de PostgreSQL são ignoradas com **WARN.** O script ainda executa todas as outras verificações. Entre em contato com o suporte do Tableau para obter a senha.

## Como recuperar a senha para o usuário do banco de dados tabrmtdb?

Você pode recuperar as credenciais navegando até o diretório do RMT Server e executando o comando apropriado para seu sistema operacional:

**No Windows**:

`.\rmtadmin get db:username db:password`

**No Linux:**

`rmtadmin get db:username db:password`

## Posso executar a verificação de pré-atualização enquanto o RMT estiver em uso?

Sim. O script é somente leitura e seguro para ser executado em um sistema de produção a qualquer momento.

## O que acontece se a verificação pós-atualização encontrar falhas?

A verificação pós-atualização nunca bloqueia o instalador. As falhas são apontadas no relatório. Alguns (como “Corretor inacessível”) são temporários e se resolvem por conta própria.

## Os scripts são compatíveis com PostgreSQL/RabbitMQ externos?

Sim. O script de pós-atualização detecta automaticamente a configuração externa e ignora as verificações locais apropriadamente. As verificações de banco de dados do script de pré-atualização exigem `--db-password` independentemente de ele se conectar ao banco de dados RMT interno.

## Posso executar os scripts nas máquinas do RMT Server e do Agent?

Sim. Use `--component master` no RMT Server e `--component agent` nos Agents. Se não especificado, o script detecta automaticamente.

## O que significa InstallerContext no relatório?

Quando a verificação de pré-atualização é executada automaticamente durante uma atualização MSI Windows, a opção `-InstallerContext` é definida. Isso relaxa as verificações de serviço e porta, que podem relatar interrompido/desativado porque o instalador já interrompeu os serviços, para **WARN** e ignora o gate de processo perdido (#38a) para que o instalador possa gerenciar o próprio ciclo de vida do processo. Quando você executa o script manualmente, essas verificações usam sua gravidade normal.

<!-- document id=7922727dd5a5febec86e410560979462f959b9d8376ebf083e44025f986f5e59 url=/tableau/current/pt-br/server/db_restore.md -->

[Pular para o conteúdo principal](#main-content)

# Restaurar de um backup

Use o comando `tsm maintenance restore` para restaurar seus dados do Tableau Server. Isso pode ser útil caso haja uma falha de sistema e seja necessário restaurar seus dados, caso precise voltar para uma versão anterior do Tableau Server (por exemplo, se houver problemas com um atualização) ou caso esteja movendo o Tableau Server para um novo hardware. É possível usar o comando `tsm maintenance restore` para restaurar backups do Tableau Server criados usando o `tabadmin backup` e o `tsm maintenance backup`.

## Limitações ao restaurar o Tableau Server

- Se você fizer atualizações Azuis/Verdes ou atualizar manualmente o Tableau Server 2021.4 (ou anterior) usando o método de [manutenção tsm (backup e restauração)](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm) , você deverá habilitar`legacy-identity-mode` antes de poder restaurar para o Tableau Server 2022.1 (ou posterior). Para obter mais informações, consulte [Solucionar problemas com migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm).
- Backups de bancos de dados feitos de outras maneiras e instantâneos da máquina virtual não são fontes válidas para restaurar o Tableau Server.
- Ao usar o `tsm maintenance restore` para restaurar os dados do Tableau, os arquivos de dados de extração e os conteúdos do banco de dados PostgreSQL são substituídos pelo conteúdo do arquivo de backup (`.tsbak`). Se você estiver executando uma instalação distribuída do Tableau Server, execute a restauração no nó que executa o Controlador TSM (geralmente é o nó inicial).
- Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.
- Você só pode restaurar um arquivo de backup para uma versão do Tableau Server que seja a mesma ou mais recente que a versão em que o backup foi criado. Você não pode restaurar para uma versão mais antiga do Tableau.
- A partir da versão 2022.3, não há suporte para backups criados usando tabadmin ("backups pré-TSM"). Você não pode restaurar um backup pré-TSM para Tableau Server versão 2022.3 ou posterior.
- Durante a restauração, o processo de restauração iniciará uma reindexação completa do conteúdo e dos ativos externos gerenciados pelo Tableau Server. Esse processo consome recursos de CPU que podem ser perceptíveis durante o backup e restauração.

## Restaurar o Tableau Server de um arquivo de backup

**Observação:** essa operação inclui etapas que talvez precisem ser executadas com a linha de comando do TSM. Para usar a CLI do TSM, é necessário ter acesso de administrador à linha de comando em um dos nós em sua instalação e credenciais de administrador do TSM para executar comandos do TSM.

1. (Opcional) Copie o arquivo `.tsbak` no local do arquivo padrão.
    
    O comando `restore` exige um arquivo de backup no diretório definido na variável `basefilepath.backuprestore` do TSM. Como padrão:
    
    `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ``
    
    Para obter mais informações sobre os caminhos do arquivo e como alterá-los, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).
    
    **Observação:** se estiver restaurando um backup copiado na pasta de backups, certifique-se de que a conta de serviço Run As, que pode ser encontrada na interface do usuário na Web do TSM em **Segurança**, tenha pelo menos acesso de leitura ao arquivo de backup. Caso contrário, o processo de restauração pode não ser capaz de descompactar o arquivo de backup e a restauração falhará.
2. Interrompa o servidor. Em um prompt de comando, digite:
    
    `tsm stop`
3. Restaure a partir de um arquivo de backup: Em um prompt de comando, digite:
    
    `tsm maintenance restore --file <file_name>`
    
    Na linha acima, substitua `<file_name>` pelo nome do arquivo de backup que deseja usar para fazer a restauração.
4. Reinicie o servidor:
    
    `tsm start`

<!-- document id=424395b28ea4cb50b22b64971aeb92bd5a85fe0304a333d2d983044f93e1b41f url=/tableau/current/pt-br/server/tableau-server-obliterate-h.md -->

[Pular para o conteúdo principal](#main-content)

# Resultado da ajuda para script tableau-server-obliterate

O conteúdo de ajuda a seguir é a saída da execução do comando a seguir:

`tableau-server-obliterate -h`

O script ./tableau-server-obliterate está instalado no Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`.

## Saída

Remove Tableau Server from this computer.

This script will stop and remove all Tableau Services from this
computer. It also removes data and configuration files. It leaves
licensing in place. It also preserves logs and backup files, which
are moved to a temp directory under the Tableau data folder. You can
force removal of these files, and licensing, using optional parameters.

This script is destructive and not reversible. It should only
be used to clean Tableau Server from a computer. For multi-node
installations, you must run the script separately on each node.

This script must be run as the Administrator.


-y          	Required. Yes, remove Tableau Server from this computer.
		Must be specified three times to confirm.
-q		Optional. Quiet mode. Windows only. Do not display
		progress UI when removing Tableau Server.
-l          	Optional. Delete licensing files and data. This command
		will attempt to deactivate licenses before deleting
		licensing data. Internet access is required for license
		deactivation. Offline deactivation is not supported.
		To deactivate license before removing Tableau Server,
		run 'tsm licenses deactivate' before running this script.
-k          	Optional. Do not copy backups to logs\_temp directory.
-g          	Optional. Do not copy logs to logs\_temp directory.
-a          	Optional. Do not copy anything to logs\_temp directory.

<!-- document id=5c6d5a2496c630480ce918f762ec339169db0eca8d1e14289271c4a392afd45d url=/tableau/current/pt-br/server/runas_change.md -->

[Pular para o conteúdo principal](#main-content)

# Revogar permissões da conta de serviço Run As

Alterar a conta de serviço Run As no utilitário de configuração do Tableau Server não remove as permissões da conta anterior. Portanto, após alterar a conta de serviço Run As, recomendamos a revogação manual das permissões da conta anterior, como uma prática recomendada segura. Siga o procedimento abaixo para revogar as permissões da conta de serviço Run As anterior.

Se você tiver alterado sua conta de serviço Run As e sua organização usar uma solução de proxy de encaminhamento, talvez seja necessário redefinir as configurações da LAN local com a nova conta de serviço Run As. Consulte [Configurar um servidor proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/proxy.htm#Configur2) para obter mais informações.

Você deve estar conectado ao computador do Tableau Server com uma conta de administrador para realizar os procedimentos a seguir.

## Remover permissões de pastas

O Tableau Server define as permissões nas pastas do Windows de acordo com o local de instalação do Tableau Server. Antes de remover as permissões de pastas, consulte [Verificar permissões de pasta](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm) para identificar os recursos necessários para remover permissões. Execute o seguinte procedimento para cada um dos recursos identificados:

1. Para cada recurso (unidade, pasta, executável), clique sobre ele com o botão direito do mouse e clique em **Propriedades**.
2. Na página de propriedade do recurso, clique na guia **Segurança** e, em seguida, em **Editar** para alterar as permissões.
3. Na página Permissões, selecione a conta de serviço Run As anterior e clique em **Remover**.
4. Clique em **OK**.

## Remover as permissões de registro

Remova a conta de serviço Run As anterior dos seguintes locais de registro:

- HKEY\_CURRENT\_USER\\Software\\Tableau
- HKEY\_LOCAL\_MACHINE\\Software\\Tableau

**Aviso**: a edição incorreta do registro do Windows pode danificar o computador.

1. Abra o Editor de Registro inserindo `regedit` no Executar do Windows e clicando em **OK**.
2. Para cada diretório de registro, clique com o botão direito do mouse na pasta **Tableau** e, em seguida, clique em **Permissões**.
3. Na página **Permissões para o Tableau**, selecione a conta de serviço Run As anterior e clique em **Remover**.
4. Clique em **OK**.

## Remover políticas de segurança

Remova a conta de serviço Run As anterior das seguintes políticas de segurança:

- Política de "logon como serviço"
- Política “Fazer logon localmente”

1. Selecione **Iniciar** > **Painel de controle** > **Ferramentas administrativas** > **Política de segurança local**.
2. Na **Política de segurança local**, abra **Políticas locais**, selecione **Atribuições de direitos do usuário**.
3. Para cada política:
    1. Clique com o botão direito do mouse na política e selecione **Propriedades**.
    2. Na página de propriedade da política, selecione a conta de serviço Run As anterior e clique em **Remover**.
    3. Clique em **OK**.

<!-- document id=a5ad3966dad213f2a92c6a998e900f340f8d4c07f6ace96462df3fdc724a1250 url=/tableau/current/pt-br/server/dm_labels_custom_categories.md -->

[Pular para o conteúdo principal](#main-content)

# Rótulos com categorias personalizadas

> [!WARNING]
> 
> A partir de 14 de outubro de 2025, o Data Cloud foi renomeado como Data 360. Durante essa transição, você pode ver referências a Data Cloud em nosso aplicativo e documentação. Embora o nome seja novo, a funcionalidade e o conteúdo permanecem inalterados.

O Tableau oferece vários rótulos de dados (certificação, avisos de qualidade e rótulos de sensibilidade) que abrangem uma ampla variedade de maneiras de classificar dados. Ainda assim, pode haver momentos em que os usuários precisem de outros rótulos e categorias que correspondam a outros casos de uso. A partir do Tableau Cloud de outubro de 2023 e do Tableau Server 2023.3, os usuários podem classificar ativos usando rótulos com categorias personalizadas definidas por um administrador. Por exemplo, um administrador poderia criar uma categoria chamada "Departamento" com rótulos para os departamentos de vendas, serviços e operações prontos para serem aplicados aos ativos.

Rótulos com categorias personalizadas exigem um licença Data Management com o Tableau Catalog habilitado e pode ser anexada aos mesmos tipos de ativos que outros rótulos de dados podem. No entanto, os rótulos com categorias personalizadas não aparecem nos ativos downstream da mesma forma que os avisos de qualidade de dados e os rótulos de sensibilidade.

Observação: se você for um administrador e quiser criar categorias e rótulos personalizados, consulte [Gerenciar rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm).

## Anexe rótulos com categorias personalizadas a um ativo

Observação: a partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar e remover rótulos com categorias personalizadas usando a caixa de diálogo consolidada Rótulos de dados em vez de caixas de diálogo separadas para cada tipo de rótulo. Para obter informações sobre a caixa de diálogo Rótulos de dados, consulte [A caixa de diálogo Rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#data-labels-dialog).

Para anexar um rótulo com uma categoria personalizada a um ativo:

### No Tableau Cloud e Tableau Server 2024.2 e posterior

1. Pesquise ou navegue até o ativo. As etapas de navegação dependem do tipo de ativo ao qual você deseja adicionar o rótulo:
    - Fonte de dados ou conexão virtual - na página Explorar, selecione Todas as fontes de dados ou Todas as conexões virtuais.
    - Tabela de conexão virtual - na página Explorar, selecione Todas as conexões virtuais e selecione a conexão virtual que contém a tabela de conexão virtual que você deseja certificar. Em seguida, selecione a tabela de conexão virtual.
    - Banco de dados ou tabela - na página Explorar, navegue até o banco de dados ou tabela. Na página Ativos externos, selecione Bancos de dados e arquivos ou Tabelas e objetos.
    - Coluna – na página Explorar, navegue até a tabela. Na página Ativos externos, selecione Tabelas e objetos de dados e navegue até a tabela. Em seguida, encontre a coluna na lista.
2. Selecione o menu de ações (...) ao lado do ativo e selecione Rótulos de dados > Todos os rótulos de dados.
3. Selecione a guia vertical no lado esquerdo da caixa de diálogo que corresponde à categoria do rótulo personalizado. Opcionalmente, se você souber o nome de um rótulo, poderá procurá-lo na parte superior da caixa de diálogo.
4. Marque a caixa de seleção ao lado dos rótulos que você deseja anexar ao ativo.
5. Se desejar, insira uma mensagem para exibir aos usuários. Você pode formatar o texto em uma mensagem com negrito, sublinhado e itálico e incluir um link ou uma imagem. Para ver dicas de formatação de texto, focalize no ícone de informações (i) acima do botão Salvar.
6. Repita as etapas 3 para cada rótulo que deseja adicionar.
7. Selecione Salvar.  
    ![Caixa de diálogo Rótulos de dados na guia de categoria personalizada](/tableau/current/pt-br/server/pt-br/Img/dm_label_data_labels_dialog_custom_category.png)

### No Tableau Server 2023.3

1. Selecione o menu de ações (...) ao lado do ativo e em seguida selecione Rótulos de dados > Mais rótulos de dados.
2. Selecione o menu suspenso Rótulos. Os nomes dos rótulos são organizados por categoria de rótulo, e você pode percorrê-las.  
    ![Seleção de um rótulo na caixa de diálogo Mais rótulos de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_custom_category_add_1_246.png)
3. Selecione a etiqueta a ser anexada e selecione Adicionar ao lado do menu suspenso Rótulos. O rótulo aparece na lista Rótulos aplicados lista no lado direito da caixa de diálogo.
4. Para adicionar uma mensagem de rótulo opcional neste ativo específico, selecione o lápis na coluna Mensagens (opcional) e selecione Salvar.  
    ![Adição de uma mensagem na caixa de diálogo Mais rótulos de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_custom_category_add_2_246.png)
5. Repita as etapas 2 a 5 para cada rótulo que deseja adicionar.
6. Quando terminar de adicionar rótulos, feche a caixa de diálogo. (Selecione o X no canto superior direito da caixa de diálogo ou selecione algo fora da caixa de diálogo para fechá-la.)

## Remover rótulos com categorias personalizadas de um ativo

Observação: a partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar e remover rótulos com categorias personalizadas usando a caixa de diálogo consolidada Rótulos de dados em vez de caixas de diálogo separadas para cada tipo de rótulo. Para obter informações sobre a caixa de diálogo Rótulos de dados, consulte [A caixa de diálogo Rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#data-labels-dialog).

Para remover um rótulo com uma categoria personalizada de um ativo:

### No Tableau Cloud e Tableau Server 2024.2 e posterior.

1. Pesquise ou navegue até o ativo. As etapas de navegação dependem do tipo de ativo ao qual você deseja adicionar o rótulo:
    - Fonte de dados ou conexão virtual - na página Explorar, selecione Todas as fontes de dados ou Todas as conexões virtuais.
    - Tabela de conexão virtual - na página Explorar, selecione Todas as conexões virtuais e selecione a conexão virtual que contém a tabela de conexão virtual que você deseja certificar. Em seguida, selecione a tabela de conexão virtual.
    - Banco de dados ou tabela - na página Explorar, navegue até o banco de dados ou tabela. Na página Ativos externos, selecione Bancos de dados e arquivos ou Tabelas e objetos.
    - Coluna – na página Explorar, navegue até a tabela. Na página Ativos externos, selecione Tabelas e objetos de dados e navegue até a tabela. Em seguida, encontre a coluna na lista.
2. Selecione o menu de ações (...) ao lado do ativo e selecione Rótulos de dados > Todos os rótulos de dados.
3. Selecione a guia vertical no lado esquerdo da caixa de diálogo que corresponde à categoria do rótulo personalizado. Como opção, use a guia vertical Etiquetas selecionadas para ver todos os rótulos anexados ao ativo. Ou, se você souber o nome de um rótulo, poderá procurá-lo na parte superior da caixa de diálogo.
4. Desmarque a caixa de seleção ao lado dos rótulos que você deseja remover do recurso.
5. Repita a etapas 3 e 4 para cada rótulo que deseja remover.
6. Selecione Salvar.

### No Tableau Server 2023.3

1. Selecione o menu de ações (...) ao lado do ativo e em seguida selecione Rótulos de dados > Mais rótulos de dados.
2. Na seção Rótulos aplicados da caixa de diálogo, selecione o ícone da lixeira na linha do rótulo para remover.  
    ![Remoção de um rótulo na caixa de diálogo Mais rótulos de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_custom_category_remove_246.png)
3. Repita a etapas 2 para cada rótulo que deseja remover.
4. Quando terminar de remover os rótulos, feche a caixa de diálogo. (Selecione o X no canto superior direito da caixa de diálogo ou selecione algo fora da caixa de diálogo para fechá-la.)

## Onde aparecem os rótulos com categorias personalizadas

Rótulos personalizados aparecem em ativos ao navegar no Tableau Cloud e no Tableau Server.

![Rótulo com categoria personalizada aparecendo na página da tabela](/tableau/current/pt-br/server/pt-br/Img/dm_label_custom_category_masthead.png)

Na criação na Web, você pode selecionar uma fonte de dados ou uma coluna e, em seguida, selecionar Detalhes do catálogo para ver todos os seus rótulos.

Ao contrário dos avisos de qualidade e dos rótulos de sensibilidade, os rótulos com categorias personalizadas não aparecem downstream dos ativos aos quais estão anexados. Por exemplo, suponha que sua organização tenha uma categoria de rótulo personalizado chamada "Departamento", à qual pertence um rótulo personalizado chamado "Vendas". Se você anexar o rótulo "Vendas" a uma tabela chamada "Pedidos", o rótulo aparecerá apenas na tabela "Pedidos" e não nas pastas de trabalho posteriores a ela.

## Quem pode adicionar rótulos de categoria personalizados

Para adicionar um rótulo com uma categoria personalizada a um recurso (ou remover um de um recurso), você deve

- ser um servidor ou administrador de site ou
- ter o recurso Sobrescrever para o ativo.

## Personalize um rótulo com uma categoria personalizada

Para obter informações sobre como os administradores podem criar ou editar categorias e rótulos personalizados que aparecem na caixa de diálogo Mais rótulos de dados, veja [Gerenciar rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm).

<!-- document id=0d85a9c607bb920f6a95fdfd74669df502ac8887e4b3221ce7152c439b98f2e7 url=/tableau/current/pt-br/server/dm_labels.md -->

[Pular para o conteúdo principal](#main-content)

# Rótulos de dados

Os rótulos de dados são metadados que você pode anexar a ativos de dados. Os rótulos de dados ajudam a classificar os dados e transmitir informações aos usuários. Por exemplo:

- Uma fonte de dados publicada é mais confiável do que outras com nomes semelhantes. O rótulo de dados de certificação pode ajudá-lo a informar aos usuários qual fonte de dados é recomendada.
- Uma coluna em um banco de dados contém informações desatualizadas. Um rótulo de dados de aviso pode ajudar você a informar aos criadores e visualizadores da pasta de trabalho que os dados podem não estar atualizados.
- Uma tabela de rendimentos de funcionários contém informações confidenciais que não devem ser compartilhadas. Um rótulo de dados de sensibilidade pode informar aos usuários que eles precisam tomar cuidado ao usar dados da tabela.
- Algumas fontes de dados publicadas podem ser agrupadas com base no departamento que as publicou. Uma categoria de rótulo personalizado com rótulos personalizados pode identificar os departamentos responsáveis pelas fontes de dados.

Observação: os rótulos de dados são uma forma mais recente e extensível de pensar maneiras de classificar os metadados. Certificações e avisos de qualidade de dados, que faziam parte do Data Management muito antes de o termo "rótulos de dados" existir, agora são consideradas categorias no conceito mais amplo de rótulo de dados, junto com os rótulos de sensibilidade lançados no Tableau Cloud em junho de 2023 e no Tableau Server 2023.3.

A licença Data Management é necessária para todas as operações de rótulo de dados, exceto as relacionadas à certificação de fontes de dados publicadas.

## Ativos que você pode rotular

Você pode adicionar rótulos ao seguinte conteúdo e ativos externos do Tableau:

- Bancos de dados
- Tabelas
- Colunas (exceto para certificação) _(rótulos de coluna introduzidos no Tableau Cloud em outubro de 2022/Server 2022.3)_
- Fontes de dados
- Fluxos
- Conexões virtuais
- Tabelas de conexão virtual

## Nomes e categorias de rótulos

Cada rótulo tem um nome e uma categoria. Os nomes e categorias integrados ao Tableau são:

<table class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><strong>Nome</strong></td><td><strong>Categoria</strong></td></tr><tr><td>Certificado</td><td>Certificação</td></tr><tr><td>Obsoleto</td><td>Aviso de qualidade de dados</td></tr><tr><td>Dados obsoletos</td><td>Aviso de qualidade de dados</td></tr><tr><td>Sob manutenção</td><td>Aviso de qualidade de dados</td></tr><tr><td>Aviso</td><td>Aviso de qualidade de dados</td></tr><tr><td>Falha de atualização de extração</td><td>Aviso de qualidade de dados</td></tr><tr><td>Falha de execução de fluxo</td><td>Aviso de qualidade de dados</td></tr><tr><td>Dados confidenciais<sup>1</sup></td><td>Sensibilidade</td></tr></tbody></table>

1_No Tableau Cloud March 2023/Server 2023.1 e versões anteriores, o rótulo de dados confidenciais usa a categoria Aviso de qualidade de dados._

A partir do Tableau Cloud October 2023 e do Tableau Server 2023.3, usando o gerenciador de rótulos na página Rótulos de dados ou a API REST, um administrador pode personalizar os rótulos integrados ou criar nomes e categorias de rótulos totalmente novos. (Usando a API REST, os administradores do Tableau Cloud conseguem modificar alguns rótulos integrados e adicionar outros em determinadas categorias desde junho de 2023.) Para obter mais informações, consulte [Gerenciar rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm).

## Categorias de rótulos

A categoria de um rótulo afeta onde e como o rótulo aparece, se ele aparece em ativos downstream e quais partes são personalizáveis, entre outras coisas.

### Certificação

Em um ambiente de autoatendimento com vários publicadores e muitos ativos, pode ser difícil encontrar o conteúdo recomendado. Usando a certificação, você pode marcar os ativos como confiáveis, e os ativos exibem selos em vários locais do Tableau. Para obter informações completas, consulte [Usar certificação para ajudar usuários a encontrar dados confiáveis](https://help.tableau.com/current/server/pt-br/datasource_certified.htm).

### Avisos de qualidade de dados

A identificação de dados problemáticos é importante para criar confiança com os usuários. Os avisos de qualidade de dados permitem marcar ativos de dados com problemas conhecidos. Quando você anexa um aviso de qualidade de dados a um ativo, um aviso é exibido nele e em quaisquer ativos downstream que o utilizam, alertando os consumidores de dados sobre os problemas com os dados de origem. Por exemplo, se você marcar uma tabela de banco de dados como obsoleta, os usuários que visualizam pastas de trabalho com base nessa tabela poderão ver um aviso.

Além disso, os avisos de qualidade de dados podem ser definidos automaticamente quando uma atualização de extração ou execução de fluxo falha e removidos novamente quando for bem-sucedido. E usar a página de Rótulos de dados ou a API REST, os administradores podem criar rótulos novos e personalizados de aviso de qualidade de dados, adicionando nuances e especificidades aos avisos que os usuários podem escolher. Para obter informações completas, consulte [Definir um aviso de qualidade de dados](https://help.tableau.com/current/server/pt-br/dm_dqw.htm)

### Rótulos de sensibilidade

Alguns dados precisam ser tratados de maneira diferente. Usando rótulos de sensibilidade, você pode retransmitir informações de sensibilidade de dados aos consumidores desses dados. Quando você marca um ativo como confidencial, os usuários que navegam no Tableau Cloud veem selos nele e em quaisquer ativos downstream que o utilizam. Por exemplo, se você marcar uma coluna de tabela como confidencial, um usuário que criar uma nova pasta de trabalho com base nessa tabela poderá ver um aviso. Além disso, usando a página Rótulos de dados ou a API REST, os administradores podem criar rótulos adicionando nuances e especificidades ao intervalo de classificações que os usuários podem escolher ao usar rótulos de sensibilidade.

Observação: os rótulos de sensibilidade foram introduzidos no Tableau Cloud em junho de 2023 e Tableau Server 2023.3. Versões anteriores do Tableau Cloud e Tableau Server retransmitem a sensibilidade dos dados por meio do aviso de qualidade de dados "Dados confidenciais" em vez de usar uma categoria de sensibilidade dedicada.

Para obter informações completas, consulte [Rótulos de sensibilidade](https://help.tableau.com/current/server/pt-br/dm_labels_sensitivity.htm).

### Categorias de rótulos personalizados

Às vezes, é necessário classificar os dados de uma forma que não seja coberta pela certificação, pelos avisos de qualidade dos dados ou pelos rótulos de sensibilidade. Usando categorias personalizadas definidas pelos administradores, você pode usar rótulos para categorizar ativos da maneira que sua organização achar adequada. Por exemplo, um administrador da sua organização pode criar uma categoria chamada "Departamento" com rótulos para vendas, marketing e outros departamentos, prontos para serem aplicados aos ativos do seu site. Para obter informações completas, consulte [Rótulos com categorias personalizadas](https://help.tableau.com/current/server/pt-br/dm_labels_custom_categories.htm).

Observação: a capacidade dos administradores criarem nomes de rótulos e categorias por meio do gerenciador de rótulos foi lançada com o Tableau Cloud em outubro de 2023 e o Tableau Server 2023.3. Os administradores do Tableau Cloud poderiam usar a API REST de uma forma mais limitada para criar nomes de rótulos personalizados com categorias integradas em junho de 2023.

## Onde os rótulos de dados aparecem

Os rótulos de dados aparecem em vários lugares, como

- o topo das páginas de ativos (pasta de trabalho, fonte de dados, tabelas, etc.)  
    ![Rótulos na página de recursos](/tableau/current/pt-br/server/pt-br/Img/dm_label_labels_masthead.png)
- lista de ativos (páginar Explore, página Ativos externos, etc)  
    ![Rótulos na página de recursos](/tableau/current/pt-br/server/pt-br/Img/dm_label_labels_list_view.png)
- O painel Dados do Desktop  
    ![Rótulo no painel de dados do Desktop](/tableau/current/pt-br/server/pt-br/Img/dm_label_labels_desktop_data_pane.png)
- a janela Detalhes do Catálogo de criação na Web  
    ![Rótulos nos detalhes do catálogo de Criação na Web](/tableau/current/pt-br/server/pt-br/Img/dm_label_labels_web_authoring_catalog_details.png)
- o painel Detalhes de dados  
    ![Rótulos no painel Detalhes de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_labels_data_details_pane.png)

A cor indica a categoria e o nível de visibilidade de um rótulo:

- **Verde** indica que o ativo está certificado
- **Azul** indica um aviso de qualidade de visibilidade padrão
- **Amarelo** indica um aviso de qualidade de alta visibilidade
- **Cinza** indica um rótulo de sensibilidade de visibilidade padrão ou um rótulo com uma categoria personalizada
- **Roxo** indica um rótulo de sensibilidade de alta visibilidade

Selecione um selo de rótulo para ver os detalhes dos rótulos dessa categoria no recurso. No caso de rótulos de advertência de qualidade e rótulos de sensibilidade, os detalhes incluirão rótulos herdados de ativos upstream. Se você estiver examinando rótulos de aviso de qualidade ou rótulos de confidencialidade em uma tabela, os detalhes incluirão rótulos nas colunas downstream. Para ir para a página do ativo relacionado, selecione-o. Rótulos de certificação e rótulos de categoria personalizados não são herdados de ativos upstream.

Existe um único indicador para cada categoria de rótulo, não importa quantos rótulos dessa categoria estejam no ativo ou sejam herdados por ele. O indicador será colorido para alta visibilidade, se um ou mais dos rótulos que ele representa forem de alta visibilidade. Por exemplo, suponha que uma tabela tenha um aviso de qualidade de visibilidade padrão e que o banco de dados upstream da tabela tenha um aviso de qualidade de alta visibilidade. Você verá um indicador amarelo de Aviso de qualidade (2), porque o indicador representa dois avisos de qualidade, um deles sendo de alta visibilidade.

![Ativo com rótulos nele e herdados por ele](/tableau/current/pt-br/server/pt-br/Img/dm_label_labels_on_asset_and_inherited.png)

Avisos de qualidade de alta visibilidade e rótulos de sensibilidade de alta visibilidade que afetam visualizações e sessões de criação na Web fazem com que alertas sejam mostrados.

![Um alerta de rótulo de sensibilidade de alta visibilidade](/tableau/current/pt-br/server/pt-br/Img/dm_label_sensitivity_hv_alert.png)

Esses alertas informam aos usuários que os dados que eles veem precisam ser tratados com cuidado. Selecionar o link Open Data Details mostra mais informações sobre os rótulos que afetam os dados.

## A caixa de diálogo Rótulos de dados

A partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar, remover e modificar rótulos de dados em ativos usando a caixa de diálogo consolidada Rótulos de dados. (O monitoramento de atualização de extração e o monitoramento de atualização de fluxo ainda são controlados por caixas de diálogo separadas.)

Para abrir a caixa de diáogo Rótulos de dados para um ativo, selecione o menu de ações (...) ao lado do ativo e selecione Rótulos de dados. Escolher Certificação, Aviso de qualidade de dados, Etiqueta de sensibilidade ou Todos os rótulos para abrir a caixa de diálogo Rótulos de dados com a guia apropriada exibida.

![A caixa de diálogo Rótulos de dados](/tableau/current/pt-br/server/pt-br/Img/dm_label_data_labels_dialog.png)

As guias verticais no lado esquerdo da caixa de diálogo correspondem às categorias de rótulos de dados, com exceção para guias Todos os rótulos e Rótulos selecionados no topo da lista.

- A guia Todos os rótulos lista todos os rótulos de dados do site em todas categorias. Cada rótulo selecionado para o ativo é verificado. Isso inclui rótulos de dados que foram selecionados para o ativo quando a caixa de diálogo foi aberta, bem como quaisquer rótulos que tenham sido selecionados desde então.
- A guia Rótulos selecionados lista todos os rótulos de dados que foram selecionados para o ativo. Isso inclui rótulos de dados que foram selecionados para o ativo quando a caixa de diálogo foi aberta, bem como quaisquer rótulos que tenham sido selecionados desde então.
- As outras guias correspondem às categorias de rótulos de dados. Essas guias listam todos os rótulos de dados associados à categoria. Cada rótulo selecionado para o ativo é verificado. Isso inclui rótulos de dados que foram selecionados para o ativo quando a caixa de diálogo foi aberta, bem como quaisquer rótulos que tenham sido selecionados desde então.

A barra de pesquisa na parte superior da caixa de diálogo retorna rótulos de dados que correspondem ao termo de pesquisa fornecido. Você pode selecionar ou desmarcar quaisquer rótulos desejados nos resultados.

Para alterar os rótulos de dados em um ativo:

1. Navegue até o rótulo usando a barra de pesquisa ou as guias verticais para encontrá-lo.
2. Para adicionar um rótulo de dados ao ativo, marque a caixa ao lado dele.
3. Selecione um nível de visibilidade (se aplicável) e uma mensagem, se desejar.
4. Para remover um rótulo de dados de um ativo, desmarque a caixa ao lado dele.
5. Adicione, remova ou modifique mais rótulos do recurso repetindo estas etapas
6. Para confirmar suas alterações nos rótulos de dados do ativo e fechar a caixa de diálogo, clique em Salvar. Ou, se quiser abandonar todas as alterações desde a abertura da caixa de diálogo, clique em Cancelar e confirme que deseja abandonar as alterações.

Observação: selecionar o rótulo de dados em vez da caixa de seleção próxima a ele mostrará detalhes sobre o rótulo, sem alterar o status da caixa de seleção. Essa ação é útil para ver a descrição do rótulo ou fazer alterações na mensagem sem alterar o status do rótulo no ativo.

A caixa de diálogo Rótulos de dados consolidados não está disponível no Tableau Server.

Para obter informações detalhadas sobre os rótulos em categorias específicas, consulte o tópico apropriado:

- [Usar certificação para ajudar usuários a encontrar dados confiáveis](https://help.tableau.com/current/server/pt-br/datasource_certified.htm)
- [Definir um aviso de qualidade de dados](https://help.tableau.com/current/server/pt-br/dm_dqw.htm#dm_dqw)
- [Rótulos de sensibilidade](https://help.tableau.com/current/server/pt-br/dm_labels_sensitivity.htm)
- [Rótulos com categorias personalizadas](https://help.tableau.com/current/server/pt-br/dm_labels_custom_categories.htm)

## Permissões necessárias para interagir com rótulos de dados em ativos

As permissões necessárias para visualizar, adicionar, atualizar e excluir rótulos em ativos estão seguinte forma:

- Para visualizar um rótulo de dados, você deve ler permissões no ativo associado.
- Para adicionar, atualizar ou excluir um rótulo de dados que não seja um rótulo de certificação, você deve gravar a permissão no ativo associado.
- Para adicionar, atualizar ou excluir um rótulo de certificação, você deve ser um administrador ou um líder de projeto ou proprietário do produto para o projeto no qual o ativo está.
- Para adicionar, atualizar ou excluir um rótulo de certificação para um ativo externo que _não_ está em um projeto, você deve ter a permissão de alterar permissões no ativo associado.

## Comparação entre tags e rótulos de dados

O Tableau Cloud e o Tableau Server também apresentam outra solução para classificação de ativos: tags. Tags e rótulos de dados diferem de maneiras significativas:

<table class="table--plain"><colgroup><col><col><col></colgroup><tbody><tr><td><strong>Área</strong></td><td><strong>Rótulos de dados</strong></td><td><strong>Marcas</strong></td></tr><tr><td>Estrutura e controle</td><td>Os administradores controlam o intervalo de rótulos de dados</td><td>Nenhum controle administrativo sobre o intervalo de tags que os usuários adicionam</td></tr><tr><td>Permissões</td><td>A capacidade de adicionar/atualizar/remover rótulos de dados é controlada por meio de permissões de ativos</td><td>Exploradores e criadores podem marcar todos os recursos que podem visualizar</td></tr><tr><td>Aparência</td><td>A iconografia do rótulo de dados é facilmente vista e codificada por cores por categoria e nível de visibilidade</td><td>As marcas aparecem em menos locais que os rótulos de dados e não têm iconografia</td></tr><tr><td>Herança</td><td>Alguns rótulos de dados (como avisos e rótulos de sensibilidade) são exibidos em ativos downstream</td><td>Sem herança</td></tr><tr><td>Pesquisando/Filtrando</td><td>Avisos de certificação e qualidade podem ser usados como filtros em algumas listas de ativos</td><td>Os resultados da pesquisa retornam recursos com marcas correspondentes, e as marcas podem ser usadas como filtros em algumas listas de recursos</td></tr><tr><td>API acessível</td><td>Acesso via API REST e API de metadados possível</td><td>Acesso via API REST e API de metadados possível</td></tr><tr><td>Requisitos da licença</td><td>Requer uma licença <span class="mc-variable Variables.DM_sku variable">Data Management</span> (exceto para a certificação de fontes de dados publicadas)</td><td>Sem requisitos da licença</td></tr><tr><td>Usar</td><td>Categorização estruturada focada em fornecer informações importantes que podem influenciar o uso de dados pelos usuários</td><td>Método aberto para categorizar ativos</td></tr></tbody></table>

Para obter mais informações sobre tags, consulte [Usar tags](https://help.tableau.com/current/pro/desktop/pt-br/tags.htm) na Ajuda do Tableau Desktop e da Criação na Web.

## Outros artigos nesta seção

<!-- document id=8f36c4d4aa58ea563fbd3e745fd591207faa9c86cf26bdb3f5b59bc32ea5bb71 url=/tableau/current/pt-br/server/dm_labels_sensitivity.md -->

[Pular para o conteúdo principal](#main-content)

# Rótulos de sensibilidade

Alguns dados precisam ser tratados com mais cuidado. Para garantir confiança e segurança, é importante que os usuários saibam quais são esses dados. A partir do Tableau Cloud de junho de 2023 e Tableau Server 2023.3, se você tem uma licença Data Management, o Tableau oferece uma nova categoria de rótulo de dados: _Rótulos de sensibilidade_. Os usuários podem usar rótulos de sensibilidade para indicar o nível de cuidado que deve ser tomado ao criar exibições ou compartilhar informações. Além disso, os rótulos de sensibilidade podem coexistir no mesmo ativo com outros rótulos, como certificação e avisos de qualidade de dados. E, usando o gerenciador de rótulos na página Rótulos de dados ou a API REST, um administrador pode criar rótulos de sensibilidade para atender às necessidades de sua organização.

Observação: no Tableau Cloud de março de 2023 e Tableau Server 2023.1 e anteriores, a sensibilidade dos dados foi expressa usando o aviso de qualidade de dados "dados confidenciais". Com a atualização para o Tableau Cloud de junho de 2023 e Tableau Server 2023.3, os avisos de qualidade de dados de "dados confidenciais" foram migrados para rótulos de sensibilidade.

Os rótulos de sensibilidade podem ser anexados aos mesmos tipos de ativos que outros [rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#assets) podem.

## Anexar um rótulo de sensibilidade a um ativo

Para anexar um rótulo de sensibilidade a um ativo:

Observação: a partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar e remover rótulos de sensibilidade usando a caixa de diálogo consolidada de Rótulos de dados em vez de caixas de diálogo separadas para cada tipo de rótulo. Para obter informações sobre a caixa de diálogo Rótulos de dados, consulte [A caixa de diálogo Rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#data-labels-dialog).

1. Pesquise ou navegue até o ativo. As etapas de navegação dependem do tipo de ativo ao qual você deseja adicionar o rótulo de sensibilidade:
    - Fonte de dados ou conexão virtual - na página Explorar, selecione Todas as fontes de dados ou Todas as conexões virtuais.
    - Tabela de conexão virtual - na página Explorar, selecione Todas as conexões virtuais e selecione a conexão virtual que contém a tabela de conexão virtual que você deseja certificar. Em seguida, selecione a tabela de conexão virtual.
    - Banco de dados ou tabela - na página Explorar, navegue até o banco de dados ou tabela. Na página Ativos externos, selecione Bancos de dados e arquivos ou Tabelas e objetos.
    - Coluna – na página Explorar, navegue até a tabela. Na página Ativos externos, selecione Tabelas e objetos de dados e navegue até a tabela. Em seguida, encontre a coluna na lista.
2. Selecione o menu de ações (. . .) ao lado do ativo e em seguida selecione Rótulos de dados > Rótulos de sensibilidade.
3. Marque a caixa de seleção ao lado dos rótulos de sensibilidade que você deseja anexar ao ativo. Como opção, se você souber o nome de um rótulo de sensibilidade, poderá pesquisá-lo na parte superior da caixa de diálogo e marcar a caixa de seleção ao lado dele. (No Tableau Server 2023.3 e versões anteriores, você só pode anexar um rótulo de sensibilidade a cada ativo. Use o botão de alternância Mostrar rótulo para ativar um rótulo de sensibilidade para esse ativo e selecione o rótulo de sensibilidade desejado na lista suspensa.)
4. Se desejar, insira uma mensagem para exibir aos usuários. Você pode formatar o texto em uma mensagem com negrito, sublinhado e itálico e incluir um link ou uma imagem. Para ver dicas de formatação de texto, focalize no ícone de informações (i) acima do botão Salvar.
5. Selecione Salvar.  
    ![A caixa de diálogo Rótulo de sensibilidade](/tableau/current/pt-br/server/pt-br/Img/dm_label_sensitivity_dialog.png)

## Remover um rótulo de sensibilidade de um ativo

Para remover um rótulo de sensibilidade de um ativo:

Observação: a partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar e remover rótulos de sensibilidade usando a caixa de diálogo consolidada de Rótulos de dados em vez de caixas de diálogo separadas para cada tipo de rótulo. Para obter informações sobre a caixa de diálogo Rótulos de dados, consulte [A caixa de diálogo Rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#data-labels-dialog)

1. Selecione o menu de ações (. . .) ao lado do ativo e em seguida selecione Rótulos de dados > Rótulos de sensibilidade.
2. Desmarque as caixas ao lado dos rótulos de sensibilidade que você deseja remover do ativo. (No Tableau Server 2023.3 e versões anteriores, desative o botão de alternância Mostrar rótulo.)
3. Selecione Salvar.

## Onde os rótulos de sensibilidade aparecem

Os rótulos de sensibilidade aparecem nos ativos ao navegar no Tableau Server. Assim como os avisos de qualidade de dados, os rótulos de sensibilidade aparecem como downstream dos ativos aos quais estão anexados. Por exemplo, um rótulo de sensibilidade em uma coluna aparece na linha de colunas da página da tabela, novamente na parte superior da página da tabela e na página do banco de dados.

![Um rótulo de sensibilidade em uma página de tabela](/tableau/current/pt-br/server/pt-br/Img/dm_label_sensitivity_table_page.png)

![Um rótulo de sensibilidade em um campo da página da pasta de trabalho](/tableau/current/pt-br/server/pt-br/Img/dm_label_sensitivity_workbook_lineage_page.png)

Na criação na Web, os usuários veem um ícone próximo à fonte de dados no painel Dados quando

- há um rótulo de sensibilidade uma fonte de dados usada na pasta de trabalho ou
- há um aviso upstream na fonte de dados usada na pasta de trabalho

Para ver os detalhes, focalize o ícone com o cursor. Ou, na Criação na Web do Tableau Cloud, você pode selecionar uma fonte de dados ou uma coluna e, em seguida, selecionar Detalhes do catálogo para ver todos os seus rótulos.

### Visibilidade

Os rótulos de sensibilidade de alta visibilidade parecem mais urgentes e aparecem em mais lugares. Por exemplo, um rótulo de sensibilidade de alta visibilidade em uma tabela gerará uma notificação quando alguém criar uma exibição ou abrir uma exibição publicada que dependa dele.

![Alerta de rótulo de sensibilidade de alta visibilidade na criação na Web](/tableau/current/pt-br/server/pt-br/Img/dm_label_sensitivity_hv_alert.png)

O ícone e o emblema dos rótulos de sensibilidade de alta visibilidade são roxos, enquanto os de visibilidade padrão são cinza. Por padrão, o rótulo de sensibilidade integrado denominado “Dados confidenciais” tem alta visibilidade.

Se mais de um rótulo de sensibilidade se aplicar a um ativo (porque o ativo tem mais de um rótulo de sensibilidade ou herda avisos upstream), o crachá inclui um número e a cor é determinada pelo rótulo de maior visibilidade. Por exemplo, se dois rótulos de sensibilidade se aplicarem a um ativo, um dos quais com visibilidade padrão e outro com alta visibilidade, o selo será roxo.

![Selo de sensibilidade no cabeçalho com dois rótulos ](/tableau/current/pt-br/server/pt-br/Img/dm_label_sensitivity_badge_2_labels.png)

### Rótulos de sensibilidade em assinaturas de e-mail

Os administradores podem ativar os rótulos de sensibilidade em assinaturas de e-mail para que, quando os usuários se inscreverem em uma exibição, o e-mail recebido por eles inclua rótulos de sensibilidade de alta visibilidade associados a essa exibição. E-mails com rótulos de sensibilidade de alta visibilidade contêm:

- Links para exibições ou pastas de trabalho relevantes com o painel Detalhes de dados aberto.
- Links para ativos upstream relevantes, como fontes de dados, tabelas ou bancos de dados.

Os administradores podem ativar os rótulos de sensibilidade em assinaturas de email selecionando a opção Rótulos de dados de alta visibilidade nas assinaturas de exibição e pasta de trabalho (anteriormente, a opção Avisos de qualidade de dados em assinaturas) na página de configurações do site Tableau Server ou Tableau Cloud. Para obter mais informações, consulte [Rótulos de dados de alta visibilidade em assinaturas de exibição e de pasta de trabalho](https://help.tableau.com/current/server/pt-br/sites_add.htm#data-quality-warnings-in-subscriptions) na Referência de configurações do site.

## Quem pode definir rótulos de sensibilidade

Para definir um rótulo de sensibilidade, você deve

- ser um servidor ou administrador de site ou
- ter o recurso Sobrescrever para o ativo.

## Personalizar rótulos de sensibilidade

Há apenas um rótulo de sensibilidade integrado: _Dados confidenciais_. A partir do Tableau Cloud de junho de 2023 e do Tableau Server 2023, usando o gerenciador de rótulos na página Rótulos de dados ou a API REST, um administrador pode criar de rótulo de sensibilidade ou alterar o nome e a descrição de um existente. As adições típicas (nome e descrição) podem ser:

- **Público**: disponível ao público para visualização.
- **Interno**: restrito a funcionários da empresa e contratados. Esses dados não devem ser compartilhados publicamente, mas podem ser compartilhados com clientes, parceiros e outros sob um contrato de não-divulgação (NDA).
- **Confidencial**: disponível para um grupo aprovado de funcionários e contratados. Esses dados não são restritos por lei, regulamentação ou contrato de serviço principal (MSA) da empresa. Eles podem ser compartilhados com clientes, parceiros e outros sob um NDA.
- **Restrito**: disponível apenas para um grupo aprovado de funcionários e contratados. Esses dados provavelmente são restritos por lei, regulamentação, NDA ou MSA da empresa.
- **Missão crítica**: disponível apenas para um pequeno grupo de funcionários e contratados aprovados. Terceiros que recebem acesso podem estar sujeitos a requisitos contratuais elevados. Esses dados são quase sempre restritos por lei, regulamentação, NDA ou MSA da empresa.

Para obter mais informações, consulte [Gerenciar rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm).

<!-- document id=61eda894f49ef574342b12d8233efdb382a74f6a460f7095fb25b0b5dae4d733 url=/tableau/current/pt-br/server/kerberos_keytab.md -->

[Pular para o conteúdo principal](#main-content)

# Saiba mais sobre os requisitos do Keytab.

A autenticação Kerberos depende das credenciais armazenadas em arquivos especialmente formatados chamados arquivos keytab. Pode ser necessário gerar arquivos keytab para sua implantação do Tableau Server. Este tópico descreve os arquivos keytab usados pelo Tableau Server para acessar vários serviços em uma empresa típica. Talvez seja necessário gerar keytabs para integrar o Tableau aos seguintes serviços:

- Autenticação de usuário (SSO) no Windows Active Directory
- Delegação da fonte de dados
- Sistema operacional
- Serviço do diretório

**Importante:** A partir do Tableau Server 2021.2.25, 2021.3.24, 2021.4.19, 2022.1.15, 2022.3.7 e 2023.1.3 (ou posterior), certifique-se de que os arquivos keytab sejam criados com cifras AES-128 ou AES-256. As cifras RC4 e 3DES não são mais aceitas. Para obter mais informações, consulte ["O Tableau Server não conseguiu autenticá-lo automaticamente"](https://help.tableau.com/current/server/pt-br/%3Chttps://kb.tableau.com/articles/Issue/tableau-server-could-not-authenticate-you-automatically-error-occurs-when-attempting-to-automatically-login-using-kerberos-sso-after- atualização do tableau-server?lang=es-es>) na base de conhecimento do Tableau.

Se sua empresa incluir profissionais de TI que tratam de identidade, autenticação e/ou segurança, você deve trabalhar com eles para criar um plano para gerar keytabs adequados para a implantação do Tableau Server.

## Autenticação de usuário (SSO) no Windows Active Directory

Caso você use o Active Directory como o repositório de identidades do Tableau Server, e queira que os usuários autentiquem com o Kerberos SSO, será necessário gerar um arquivo keytab para o Tableau Server.

<table class="simple-table" style=""><colgroup><col><col></colgroup><tbody><tr><th>O Tableau esta executando no...</th><th>Precisa gerar o keytab manualmente?</th></tr><tr><td>Windows no domínio do Active Directory</td><td>Sim</td></tr><tr><td>Linux no domínio do Active Directory</td><td>Sim</td></tr><tr><td>Windows ou Linux em ambiente que não seja o Active Directory</td><td>O SSO do Kerberos não é um cenário compatível.</td></tr></tbody></table>

Siga as recomendações a seguir (para versões do Windows e Linux do Tableau Server):

- Crie uma conta de serviço em seu diretório para o Tableau Server.
- Crie um arquivo keytab especialmente para a conta de serviço do Tableau Server. Na reutilize o arquivo keytab que a conta/sistema operacional do computador usa para autenticação. Você pode usar o mesmo keytab para Kerberos SSO usado para a autenticação do diretório no cenário acima.
- É necessário criar nomes principais do servidor (SPN) no Active Directory para o serviço do Tableau Server.
- Use o arquivo de lote na próxima seção para criar os SPNs e o arquivo keytab.
- Depois de criar os SPNs, faça o upload do arquivo keytab conforme descrito em [Configurar o Kerberos](https://help.tableau.com/current/server/pt-br/config_kerberos.htm).

### Arquivo de lote: definir o SPN e criar keytab no Active Directory

Você pode usar um arquivo de lote para definir os nomes principais do servidor (SPN) e criar um arquivo keytab. Essas operações são parte do processo para habilitar o SSO do Kerberos para o Tableau Server (no Windows e no Linux) em execução no Active Directory.

Nas versões anteriores do Tableau Server (antes de 2018.2), o script de configuração foi gerado a partir do utilitário de configuração do Tableau Server.

Para gerar um script de configuração, copie e cole os conteúdos a seguir do arquivo de lote em um arquivo de texto. O arquivo de lote cria nomes principais do servidor (SPN) para o Tableau Server e criará um arquivo keytab para o usuário especificado no arquivo.

Siga as instruções nos conteúdos do arquivo. Depois de concluir a personalização do arquivo, salve como um arquivo .bat.

Este arquivo deve ser executado em um domínio Active Directory por um administrador de domínio, que deverá fornecer a senha da conta de serviço especificada no arquivo.

O arquivo de lote usa os comandos [set](https://docs.microsoft.com/pt-br/windows-server/administration/windows-commands/set_1), [setspn](http://technet.microsoft.com/pt-br/library/cc731241\(WS.10\).aspx) e [ktpass](https://docs.microsoft.com/pt-br/windows-server/administration/windows-commands/ktpass) do Windows.

**Observação**: o arquivo de lote abaixo é autodocumentado. No entanto, se você não tiver experiência com o Kerberos e a geração de arquivos keytab, recomenda-se a leitura da publicação do blog da Microsoft, [Tudo o que você precisa saber sobre arquivos keytab](https://blogs.technet.microsoft.com/pie/2018/01/03/all-you-need-to-know-about-keytab-files/), antes de continuar. Os detalhes do ambiente na sua organização podem exigir configuração adicional do comando ktpass. Por exemplo, você deve determinar o que definir para o parâmetro `/crypto`. Recomenda-se especificar um único valor `/crypto`, que é exigido pelo KDC. Consulte o artigo da Microsoft, [ktpass](https://docs.microsoft.com/pt-br/windows-server/administration/windows-commands/ktpass) para obter a lista completa de valores suportados para o parâmetro `/crypto`.

### Conteúdos do SPN e arquivo de lote keytab

**A partir do Tableau Server 2022.3, 2022.1.8, 2021.4.12, 2021.3.17, 2021.2.18, 2021.1.20 e 2020.4.23**

```
@echo off
setlocal EnableDelayedExpansion

REM ******* 

REM This script generates the Service Principal Names (SPNs) and keytab files required for 
REM Kerberos SSO with Apache.
REM This script executes set, setspn, and ktpass commands included in any Windows Server 
REM Operating System from 2003 on.
REM Before running this script you must enter configuration information for the setspn and 
REM ktpass commands. 
REM Elements that require your configuration information are enclosed in as such:
REM  ! -- and --!. 
REM After you customize this file, save it as a .bat file, and run on a domain-joined 
REM computer. 
REM This script must be run by a Domain admin.

REM **********

REM The following set command will prompt the domain admin for credentials of the 
REM Tableau Server service account. 
REM This account must be a valid domain user account.
REM If the password contains a literal \" (blackslash - double quote), all backslashes 
REM immediately before the double quote must be
REM duplicated when typed for the password to work, e.g. if password contains 
REM  \" replace with \\", if passwords contains \\" replace with \\\\"

set /p adpass= "Enter password for the Tableau Server service account."
set adpass=!adpass:"=\"!

REM **********

REM The following setspn commands create the SPN in the domain.
REM More information on setspn can be found here: 
REM http://technet.microsoft.com/en-us/library/cc731241(WS.10).aspx  
REM Enter the canonical FQDN and the host names for Tableau Server followed by the  
REM Tableau Server service account name.
REM Use this syntax: HTTP/hostname domain\service_account_name.
REM The example below shows syntax for a computer named "tableau01" in the "example.lan"  
REM domain, with service account, "tab-serv-account":
REM setspn -s HTTP/tableau01 example\tab-serv-account
REM setspn -s HTTP/tableau01.example.lan example\tab-serv-account  
REM DNS and AD are not case sensitive, but the keytab files are.  Verify that host names  
REM match letter case as stored in DNS. 
REM Use Windows Server's DNS Manager utility to verify host name case.

REM **********

echo Creating SPNs...
setspn -s HTTP/!--replace with canonical host name and service account --!
setspn -s HTTP/!--replace with canonical FQDN and service account --!

REM **********

REM The following commands create the keytab file in the same directory where the 
REM bat file is run. More information on ktpass can be found here: 
REM https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/ktpass 
REM Note: keytab files are case-sensitive.
REM The realm following the FQDN should be all uppercase.
REM Syntax is:
REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass!
REM /pttype KRB5_NTPRINCIPAL /crypto !--cipher--! /out keytabs\kerberos.keytab
REM Best practice: specify the /crypto value that is required by your KDC. 
REM Options for /crypto = {DES-CBC-CRC|DES-CBC-MD5|AES256-SHA1|AES128-SHA1|All}
REM Do not specify /crypto All because it will result in a keytab that contains ciphers that are not supported
REM and cause errors.
REM When using AES256-SHA1 OR AES128-SHA1, the /mapuser option must be included 
REM in the ktpass command to ensure the keytab file is mapped properly to the user. For example:
REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /mapuser <domain\username> /crypto AES256-SHA1 /out keytabs\kerberos.keytab
REM The following example shows the ktpass syntax with the example.lan configuration from above:
REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab
					
REM **********

echo Creating Keytab files in %CD%\keytabs
mkdir keytabs
ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab
```

**Para versões anteriores do Tableau Server**

```
@echo off
setlocal EnableDelayedExpansion

REM ******* 

REM This script generates the Service Principal Names (SPNs) and keytab files required for 
REM Kerberos SSO with Apache.
REM This script executes set, setspn, and ktpass commands included in any Windows Server 
REM Operating System from 2003 on.
REM Before running this script you must enter configuration information for the setspn and 
REM ktpass commands. 
REM Elements that require your configuration information are enclosed in as such:
REM  ! -- and --!. 
REM After you customize this file, save it as a .bat file, and run on a domain-joined 
REM computer. 
REM This script must be run by a Domain admin.

REM **********

REM The following set command will prompt the domain admin for credentials of the 
REM Tableau Server service account. 
REM This account must be a valid domain user account.
REM If the password contains a literal \" (blackslash - double quote), all backslashes 
REM immediately before the double quote must be
REM duplicated when typed for the password to work, e.g. if password contains 
REM  \" replace with \\", if passwords contains \\" replace with \\\\"

set /p adpass= "Enter password for the Tableau Server service account."
set adpass=!adpass:"=\"!

REM **********

REM The following setspn commands create the SPN in the domain.
REM More information on setspn can be found here: 
REM http://technet.microsoft.com/en-us/library/cc731241(WS.10).aspx  
REM Enter the canonical FQDN and the host names for Tableau Server followed by the  
REM Tableau Server service account name.
REM Use this syntax: HTTP/hostname domain\service_account_name.
REM The example below shows syntax for a computer named "tableau01" in the "example.lan"  
REM domain, with service account, "tab-serv-account":
REM setspn -s HTTP/tableau01 example\tab-serv-account
REM setspn -s HTTP/tableau01.example.lan example\tab-serv-account  
REM DNS and AD are not case sensitive, but the keytab files are.  Verify that host names  
REM match letter case as stored in DNS. 
REM Use Windows Server's DNS Manager utility to verify host name case.

REM **********

echo Creating SPNs...
setspn -s HTTP/!--replace with canonical host name and service account --!
setspn -s HTTP/!--replace with canonical FQDN and service account --!

REM **********

REM The following commands create the keytab file in the same directory where the 
REM bat file is run. More information on ktpass can be found here: 
REM https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/ktpass 
REM Note: keytab files are case-sensitive.
REM The realm following the FQDN should be all uppercase.
REM Syntax is:
REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass!
REM /pttype KRB5_NTPRINCIPAL /crypto !--cipher--! /out keytabs\kerberos.keytab
REM Best practice: specify the /crypto value that is required by your KDC. 
REM Options for /crypto = {DES-CBC-CRC|DES-CBC-MD5|RC4-HMAC-NT|AES256-SHA1|AES128-SHA1|All}
REM Specifying /crypto All will result in passwords stored with RC4 cipher, which is
REM no longer considered secure.
REM When using AES256-SHA1 OR AES128-SHA1, the /mapuser option must be included 
REM in the ktpass command to ensure the keytab file is mapped properly to the user. For example:
REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /mapuser <domain\username> /crypto AES256-SHA1 /out keytabs\kerberos.keytab
REM The following example shows the ktpass syntax with the example.lan configuration from above:
REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab
					
REM **********

echo Creating Keytab files in %CD%\keytabs
mkdir keytabs
ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab
```

## Sistema operacional

Se sua empresa usa o Kerberos para autenticação, o computador onde o Tableau Server está sendo executado deve ser autenticado com o escopo do Kerberos no qual está sendo executado.

<table class="simple-table" style=""><colgroup><col><col></colgroup><tbody><tr><th>O Tableau esta executando no...</th><th>Precisa gerar o keytab manualmente?</th></tr><tr><td>Windows no domínio do Active Directory</td><td>Não</td></tr><tr><td>Linux no domínio do Active Directory</td><td>Sim</td></tr><tr><td>Windows ou Linux em ambiente que não seja o Active Directory</td><td>Sim</td></tr></tbody></table>

Se você estiver executando o Tableau Server no Windows e o computador estiver vinculado ao Active Directory, não será necessário gerenciar ou gerar um arquivo keytab para o sistema operacional.

Se estiver executando o Tableau Server no Linux em um escopo do Kerberos(MIT KDC ou Active Directory), será necessário gerar um arquivo keytab especificamente para o sistema operacional do computador. O keytab criado para o computador deve ser especificamente para a autenticação do sistema operacional. Não use o mesmo arquivo keytab para autenticação do sistema operacional que será usado para os outros serviços descritos posteriormente neste tópico.

## Serviço do diretório

Se sua empresa usar um serviço de diretório, como LDAP ou Active Directory, para gerenciar a identidade de usuário, o Tableau Server solicitará acesso de apenas leitura para o diretório.

Como alternativa, é possível configurar o Tableau Server para gerenciar todas as contas instalando com um armazenamento de identidades local. Nesse caso, não será necessário um keytab.

A tabela a seguir resume as solicitações do keytab:

<table class="simple-table" style=""><colgroup><col><col><col></colgroup><tbody><tr><th>O Tableau esta executando no...</th><th>Serviço do diretório</th><th>Precisa gerar o keytab manualmente?</th></tr><tr><td>Windows no domínio do AD</td><td>Active Directory</td><td>Não</td></tr><tr><td>Windows</td><td>LDAP (GSSAPI bind)</td><td>Sim</td></tr><tr><td>Linux</td><td>Active Directory ou LDAP (associação GSSAPI)</td><td>Sim</td></tr><tr><td>Windows ou Linux</td><td>Active Directory ou LDAP (associação simples)</td><td>Não</td></tr><tr><td>Windows ou Linux</td><td>Armazenamento de identidades local</td><td>Nenhum keytab exigido.</td></tr></tbody></table>

Se precisar gerar um keytab manualmente para este cenário, você vai usá-lo para associação GSSAPI ao diretório. Siga as recomendações a seguir:

- Crie uma conta de serviço em seu diretório para o Tableau Server.
- Crie um arquivo keytab especialmente para a conta de serviço do Tableau Server. Na reutilize o arquivo keytab que a conta/sistema operacional do computador usa para autenticação.
- Faça upload do arquivo keytab como parte da configuração json do repositório de identidades do Tableau Server. Consulte [Entidade identityStore](https://help.tableau.com/current/server/pt-br/entity_identity_store.htm).

Como parte do seu plano de recuperação de desastres, recomendamos manter um backup dos arquivos keytab e conf em um local seguro fora do Tableau Server. Os arquivos keytab e conf que você adicionar ao Tableau Server serão armazenados e distribuídos para outros nós pelo Serviço de arquivos do cliente. No entanto, os arquivos não são armazenados em um formato recuperável. Consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

## Delegação de fonte de dados

Também é possível usar a delegação do Kerberos para acessar fontes de dados em um Active Directory. Neste cenário, os usuários podem ser autenticados para o Tableau Server com qualquer mecanismo de autenticação compatível (SAML, autenticação local, Kerberos etc.) e acessar fontes de dados habilitadas pelo Kerberos.

Siga as recomendações a seguir:

- A conta do computador do Tableau Server (Windows ou Linux) deve estar no domínio do Active Directory.
- O arquivo keytab usado para a delegação do Kerberos pode ser o mesmo usado para a autenticação de usuário (SSO ) do Kerberos.
- O keytab deve ser mapeado para o principal do servidor para a delegação do Kerberos no Active Directory.
- Você pode usar o mesmo keytab para várias fontes de dados.

Para obter mais informações, consulte os tópicos de configuração a seguir:

- Tableau Server no Linux: [Habilitar a delegação do Kerberos](https://help.tableau.com/current/server-linux/pt-br/kerberos_delegation.htm)
- Tableau Server no Windows: [Habilitar a delegação do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm)

<!-- document id=51bce27450974f2ead4fc0a4d7d0cf4ed868ec92776f8bb304a1b460d07ef548 url=/tableau/current/pt-br/server/upgrade_tsm-h.md -->

[Pular para o conteúdo principal](#main-content)

# Saída de ajuda para script upgrade-tsm

O conteúdo de ajuda a seguir é a saída da execução do comando a seguir:

`upgrade-tsm.cmd -h`

O script upgrade-tsm está instalado no `Tableau\Tableau Server\Packages\scripts.<version_code>`.

## Saída

Usage:
upgrade-tsm \[optional parameters\]
					Perform upgrade using the specified parameters.

Global Parameters
-u, --username <USER>
					TSM administrator user name. Current user will be assumed if not provided.

-p, --password <PASSWORD>
					TSM administrator password. You will be prompted for a password if upgrading
					from a version prior to 2019.2 and the password is not provided.

-sp,--service-runas-password <PASSWORD>
					Service runas user password. You will be prompted for password if not set
					and non-default runas user is configured.

Optional Parameters
--trust-admin-controller-cert
					Do not validate the server certificate.

--no-prompt
					Suppress script prompts. You will only be prompted for missing required
					parameters, for example, if you specify a user name but not a password. If the
					script needs to stop or restart Tableau Server it will do so without warning
					or prompting. Use this if you automate the upgrade, for example, with a script.

--skip-preflight-check
					Skip the preflight check. This option should only be used if you are sure
					the preflight check is failing in error.

--external-repository-config-file=<filename>
					Required if upgrading from a Tableau Server to a version of Tableau Server
					that uses a later major version of PostgreSQL and is configured to use an
					external repository. The filename is a configuration file describing a new
					instance of the external repository. The new repository should use the same
					type of external service as the current external repository, but with the
					supported version of PostgreSQL.
			
--external-repository-cert-file=<filename>
					Required if upgrading from a Tableau Server to a version of Tableau Server
					that uses a later major version of PostgreSQL and is configured to use an
					external repository. The filename is a SSL certificate file for the new
					external repository. The new repository should use the same type
					of external service as the current external repository, but with the
					supported version of PostgreSQL.

<!-- document id=eec488ba8028b64083deb01e808cb2c8bfc8d1b7782e55da81e68eae763bb889 url=/tableau/current/pt-br/server/saml.md -->

[Pular para o conteúdo principal](#main-content)

# SAML

SAML (Security Assertion Markup Language) é um padrão XML que permite que domínios seguros da Web troquem dados de autenticação e autorização de usuários. É possível configurar o Tableau Server o para usar um provedor de identidade externo (IdP) para autenticar usuários por SAML 2.0. Nenhuma credencial do usuário é armazenada no Tableau e usar o SAML habilita a adição do Tableau ao ambiente de logon único da sua empresa.

É possível usar o SAML em todo o servidor ou configurar os sites individualmente. Confira uma visão geral dessas opções:

- **Autenticação SAML em todo o servidor**. Um único aplicativo SAML IdP lida com a autenticação de todos os usuários do Tableau Server. Use esta opção se o servidor tiver apenas o site Padrão, pois é desnecessário configurar o SAML específico do site neste caso. Você também pode usar SAML em todo o servidor em ambientes de vários sites, mas os usuários estão limitados a um único IdP para todos os sites.
- **Autenticação local em todo o servidor e autenticação SAML específica de site**. Em um ambiente com vários sites, os usuários que não estão habilitados para autenticação SAML no nível do site podem fazer logon ao usar autenticação local.
- **Autenticação SAML em todo o servidor e autenticação SAML específica de site.**. Em um ambiente com vários sites, todos os usuários são autenticados por meio do SAML IdP configurado no nível do site e você especifica um padrão SAML IdP em todo o servidor para os usuários que pertencem a vários sites.

Se quiser usar SAML específico ao site, é obrigatória a configuração do SAML em todo o servidor antes da configuração dos sites individuais. O SAML do lado do servidor não precisa ser ativado para que o SAML específico do site funcione, mas deve ser configurado.

A autenticação do usuário por meio do SAML não se aplica a permissões e autorização para o conteúdo do Tableau Server, como fontes de dados e pastas de trabalho. Ela também não controla o acesso aos dados subjacentes aos quais as pastas de trabalho e as fontes de dados se conectam.

**Observações:**

- O Tableau Server oferece suporte ao SAML iniciado pelo provedor de serviços e iniciado por IdP em navegadores e no aplicativo Tableau Mobile. As conexões SAML do Tableau Desktop devem ser iniciadas pelo provedor de serviços.
- Os pools de identidades, que são uma ferramenta projetada para complementar e oferecer suporte a opções adicionais de provisionamento e autenticação de usuários que você pode precisar em sua organização, oferecem suporte apenas à autenticação OpenID Connect (OIDC). Para obter mais informações, veja [Provisionar e autenticar usuários usando grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

## Visão geral da autenticação

A imagem a seguir mostra as etapas para autenticar um usuário com logon único em um típico fluxo iniciado pelo provedor de serviços:

![Logon único usando SAML](/tableau/current/pt-br/server/pt-br/Img/saml_about.png)

1. O usuário navega até a página de logon do Tableau Server, ou clica na URL de uma pasta de trabalho publicada.
2. O Tableau inicia o processo de autenticação ao redirecionar a solicitação para o IdP configurado.
3. O IdP solicita o nome de usuário e a senha do usuário. Depois que o usuário envia credenciais válidas, o IdP autentica o usuário.
4. O IdP retorna a autenticação bem-sucedida na forma de uma Resposta do SAML ao cliente. O cliente transmite a Resposta do SAML para o Tableau Server.
5. Tableau Server O verifica se o nome de usuário na Resposta do SAML corresponde a um usuário licenciado armazenado no Repositório do Tableau Server. Se uma correspondência for verificada, o Tableau Server responderá ao cliente com o conteúdo solicitado.

## Outros artigos nesta seção

<!-- document id=3a06f878b72bc50fdd19c620bab499953ba55bdd049096e6654213f9da171b75 url=/tableau/current/pt-br/server/scim_config_online.md -->

[Pular para o conteúdo principal](#main-content)

# SCIM

O sistema de gerenciamento de usuários entre domínios (SCIM) é um protocolo que padroniza a automação do provisionamento de usuários e grupos para integração com provedores de identidade (IdPs) baseados em nuvem, como Microsoft Entra ID e Okta.

A partir da versão 2025.3, o Tableau Server oferece suporte ao SCIM, que permite que os provedores de identidade (IdPs) gerenciem centralmente as identidades dos usuários, simplificando o processo de gerenciamento de usuários e associações de grupos no Tableau Server. O IdP usa o SCIM para gerenciar o ciclo de vida de um usuário no Tableau, e o Tableau Server é mantido em sincronia com as atribuições de provisionamento no IdP. Esse tipo de integração melhora a segurança e reduz o trabalho manual dos administradores de servidor no Tableau Server.

O recurso SCIM no Tableau Server foi projetado para funcionar no nível do site e oferece suporte à seguinte autenticação:

- Autenticação de SAML específica do site (a partir do Tableau Server 2025.3.0)
- Autenticação configurada no TSM durante a configuração do Tableau Server (TSM configurado) e autenticação configurada por meio de pools de identidade (a partir do Tableau Server 2025.3.1)

## Configurar a integração do SCIM com o Tableau Server

### Etapa 1: executar os pré-requisitos

Antes de habilitar a integração do SCIM com o Tableau Server, é necessário atender aos seguintes requisitos:

- Ter acesso de administrador do servidor ao Tableau Server.
- Ser capaz de modificar as configurações SCIM do IdP para o Tableau Server.
- Opcionalmente, se estiver usando geração e gerenciamento de token externo, você terá o seguinte:
    1. Criou e habilitou um aplicativo conectado do Tableau. Se você não tiver feito isso, consulte [Uso de aplicativos conectados do Tableau para integração de aplicativos](https://help.tableau.com/current/server/pt-br/connected_apps.htm).
    2. Um JWT válido que contém os seguintes escopos: `tableau:users:*` e `tableau:groups:*`

**Observação:** devido ao firewall do Tableau Server, talvez seja necessário configurar um conector local no IdP para que o recurso SCIM funcione. Por exemplo, no Okta, você precisará configurar o [provisionamento local (OPP](https://help.okta.com/pt-br/content/topics/provisioning/opp/opp-architecture.htm)). No Microsoft Entra ID, você precisará configurar um [agente de provisionamento](https://learn.microsoft.com/pt-br/entra/identity/hybrid/cloud-sync/what-is-provisioning-agent).

### Etapa 2: configurar o SCIM no nível de site

O procedimento descrito nesta seção é executado no site.

Você pode usar um token SCIM gerado pelo Tableau. Como alternativa, você pode ignorar o token SCIM que o Tableau gera e, em vez disso, usar um JWT gerado externamente (usando um aplicativo conectado do Tableau) para dar suporte a solicitações SCIM.

#### Habilitar SCIM - usando um token gerado pelo Tableau

1. Entre no Tableau Server como administrador de servidor.
2. Acesse o site e clique em Configurações.
3. No título Sistema de gerenciamento de usuários entre domínios (SCIM), marque a caixa de seleção Habilitar SCIM. Isso preenche a URL base, o botão Novo segredo e o menu suspenso Autenticação.
4. Faça o seguinte:
    
    1. Copie a URL base para usar nas configurações de SCIM do seu IdP.
    2. Clique no botão Novo segredo.
    3. Copie o segredo e armazene-o em um local seguro para que você possa adicioná-lo às configurações de SCIM do seu IdP.
        
        **Importante:** o segredo é exibido apenas assim que é gerado. Caso o perca antes de aplicá-lo ao IdP, você pode clicar em Novo segredo novamente.
    4. No menu suspenso Autenticação, selecione o tipo de autenticação para associar ao SCIM.
    5. Clique no botão Salvar na parte superior ou inferior da página Configurações.
        
        ![](/tableau/current/pt-br/server/pt-br/Img/scim_server.png)

#### Habilitar SCIM - usando um token externo

Para usar um token externo, 1) habilite o recurso de token externo para SCIM e 2) habilite o SCIM.

**Etapa 1: ativar token externo**

Antes de habilitar o SCIM, habilite o recurso de token externo usando o TSM.

1. Abra um prompt de comando como administrador do servidor no nó inicial (onde o TSM está instalado) no cluster.
2. Execute os seguintes comandos:
    
    1. `tsm configuration set -k features.JWTSupportForSCIM -v true`
    2. `tsm pending-changes apply`
        
        Para obter mais informações, consulte [features.JWTSupportForSCIM](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#scim).

**Etapa 2: habilitar o SCIM**

Ao habilitar o SCIM, associe um tipo de autenticação que os usuários provisionados usarão para entrar no Tableau Server. Os tipos de autenticação disponíveis dependem da autenticação configurada no Tableau Server ou no site.

1. Entre no Tableau Server como administrador de servidor.
2. Navegue até o site e clique em Configurações..
3. No título Sistema de gerenciamento de usuários entre domínios (SCIM), marque a caixa de seleção Habilitar SCIM. Isso preenche a URL base, o botão Novo segredo e o menu suspenso Autenticação.
4. Faça o seguinte:
    
    1. Copie a URL base para usar nas configurações de SCIM do seu IdP.
    2. Ignore o botão Novo segredo.
    3. No menu suspenso **Autenticação**, selecione o tipo de autenticação para associar ao SCIM.
    4. Clique no botão Salvar na parte superior ou inferior da página Configurações.

### Etapa 3: habilitar o SCIM com o IdP

Após habilitar o SCIM no Tableau Server, use as etapas na documentação do seu IdP para habilitar o suporte ao SCIM com o seu provedor de identidade (IdP).

### Etapa 4: provisionar usuários e grupos

Siga a documentação do seu IdP para provisionar usuários e grupos após habilitar o suporte SCIM no site.

Depois que os usuários e grupos são provisionados por meio do SCIM, você não deve atualizar diretamente os detalhes de um usuário, como autenticação ou função no site, por meio do Tableau Server (ou API REST do Tableau), com as exceções indicadas na etapa 5, abaixo.

### Etapa 5: atualizar usuários para SSL local ou mútuo

Se você associou o SCIM à autenticação configurada no TSM durante a configuração do Tableau Server, também conhecida como "Padrão do servidor (TSM configurado)" no menu suspenso de autenticação da configuração do SCIM, siga as etapas adicionais descritas abaixo para garantir que os usuários possam entrar com sucesso no Tableau Server.

- **Para autenticação local:** atualize os usuários provisionados com suas senhas no Tableau Server para que eles possam fazer logon com sucesso. Para atualizar um usuário, consulte [Alterar as senhas de usuários de um único site](https://help.tableau.com/current/server/pt-br/users_view.htm#ChangePasswords).

- **Para SSL mútuo:** certifique-se de que o Tableau Server mapeie corretamente o certificado do cliente para os usuários. Para obter mais informações, consulte [Mapeamento de um certificado de cliente para um usuário durante a autenticação mútua](https://help.tableau.com/current/server/pt-br/ssl_mutual_mapping_username.htm).

## Sobre a alteração da autenticação associada ao SCIM

Se o tipo de autenticação associado ao SCIM for alterado, o Tableau Server imediatamente revogará e excluirá o segredo. Como resultado, o provisionamento falha e os usuários e grupos no Tableau Server podem ficar fora de sincronia com o provedor de identidade (IdP).

Para evitar problemas de sincronização, certifique-se de que as seguintes etapas sejam executadas na ordem exata: 1) selecione o novo tipo de autenticação, 2) gere um novo segredo e 3) adicione o novo segredo às configurações de SCIM do IdP.

**Importante:** quando o tipo de autenticação do SCIM é alterado, somente novos usuários provisionados após a alteração usarão o tipo de autenticação atualizado. Os usuários existentes ainda serão capazes de autenticar com o método de autenticação anterior. Os usuários que não existem mais no IdP após a alteração de autenticação no SCIM não poderão mais fazer logon.

## Considerações adicionais

Há certas implicações a serem observadas após habilitar o SCIM dependendo do tipo de autenticação ao qual SCIM está associado.

### Autenticação do SAML específico do site

O SAML específico do site não poderá ser habilitado se uma configuração de SCIM estiver associada a ele. Se você precisar desabilitar o SAML específico do site, deverá associar um tipo de autenticação diferente ao SCIM ou desabilitar o SCIM.

### Autenticação configurada por meio de pools de identidade

Sem considerações adicionais.

**Observação:** se um pool de identidades for desabilitado ou excluído, um tipo de autenticação diferente deverá ser associado ao SCIM. O segredo gerado anteriormente não será mais válido e fará com que o provisionamento de usuários e grupos falhe.

### Autenticação configurada no TSM

Se o SCIM estiver configurado para usar a autenticação configurada no TSM durante a instalação do Tableau Server, alterar a autenticação do TSM configurado poderá causar problemas de sincronização e falhas de entrada para os usuários.

Por exemplo, se você alterar a autenticação do TSM de local para SAML, os usuários existentes precisarão ser adicionados ao IdP e habilitados para logon único (SSO) do Tableau Server. Se você alterar a autenticação do TSM de SAML para local, os usuários precisarão ser atualizados para incluir suas senhas.

<!-- document id=2e1ed64d5ebe1f2256fcb115176d335346909aac22e6dddfae4f0741d69f00da url=/tableau/current/pt-br/server/rmt-admin-upgrade-health-scripts.md -->

[Pular para o conteúdo principal](#main-content)

# Scripts de verificação de integridade de atualização do RMT

A partir da versão 2025.3.6, o instalador do RMT inclui um script de verificação de integridade pré-atualização e pós-atualização para validar seu ambiente de Resource Monitoring Tool (RMT) do Tableau antes e depois da atualização. Esses scripts identificam problemas pré-existentes em seu ambiente, como configuração incorreta, desvio de permissão, escassez de espaço em disco, certificados expirados ou falhas de serviço que estavam presentes antes e podem causar qualquer falha de atualização.

Os scripts de verificação de integridade pré e pós-atualização podem identificar os seguintes problemas:

- **Preparação de banco de dados e disco**: detecta se um banco de dados grande ou arquivos WAL excessivos farão com que a migração trave ou esgote o espaço em disco.
- **Integridade de permissão e segurança**: identifica a propriedade de arquivo alterada ou certificados de SSL expirados que, de outra forma, impediriam a reinicialização dos serviços ou a reconexão dos agentes.
- **Validação de dependência**: garante que os componentes Windows necessários, como o Visual C++ 2022 Redistribuível e o OpenSSL 3.x, estejam presentes antes da instalação do PostgreSQL 15.
- **Segurança de lógica de versão**: evita erros de “falso downgrade” causados por regressões de metadados de versão.

## Script pré-atualização

O script pré-atualização é executado automaticamente ao iniciar uma atualização. Ele inspeciona seu host RMT Server ou Agent enquanto a instalação existente ainda está intacta e gera um relatório PASS/FAIL/WARN.

No **Linux**, a verificação pré-atualização é executada automaticamente como parte de:

sudo bash upgrade-rmt-master ...

sudo bash upgrade-rmt-agent ...

Para ignorar a verificação automática (não recomendado):

sudo bash upgrade-rmt-master --skip-pre-upgrade-check ...

No **Windows**, o instalador executa a verificação de pré-atualização automaticamente. Durante a instalação, também será solicitado se você deve ou não ignorar a atualização. No entanto, isso não é recomendado.

### Verificação manual pré-atualização

Você pode executar o script manualmente para visualizar quaisquer problemas em potencial. Para executá-lo manualmente, use as seguintes etapas com base no seu sistema operacional:

**No Linux:**

Execute os comandos como usuário root. Para incluir verificações de banco de dados, use o comando export para passar sua senha com segurança.

sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh

Para executar com as verificações de PostgreSQL habilitadas, use o seguinte comando:

export RMT\_DB\_PASSWORD="<tabrmtdb-password>"

sudo -E bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh

Para executar com um componente específico e caminho de saída, use o seguinte comando:

sudo bash rmt-pre-upgrade-check.sh --component master --output /tmp/rmt-report.txt

**No Windows:**

Os arquivos de pré-atualização do RMT Server são instalados por padrão no seguinte local:

`C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1`

Os arquivos pré-atualização do Agent são instalados por padrão no seguinte local:

`C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1`

Para executar o script manualmente, inicie o PowerShell como administrador e execute:

`cd "C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade"`

.`\rmt-pre-upgrade-check.ps1`

Para executar com as verificações de PostgreSQL habilitadas, use o seguinte comando:

$env:RMT\_DB\_PASSWORD = "<tabrmtdb-password>"

.\\rmt-pre-upgrade-check.ps1

Para executar com um componente específico e caminho de saída, use o seguinte comando:

.\\rmt-pre-upgrade-check.ps1 -Component master -OutputPath C:\\temp\\rmt-report.txt

### Opções adicionais

Use as seguintes opções para personalizar a verificação pré-atualização:

`-Component`

Especifique RMT Server ou Agent. O script detecta isso automaticamente a escolha for omitida

`--db-password / -DbPassword`

A senha de administrador do banco de dados RMT interno. Obrigatório para verificações de PostgreSQL.

`--output / -OutputPath`

Especifique onde salvar o relatório. Por padrão, fica salvo em `/tmp/ (Linux) or C:\temp\ (Windows).`

`--target-version / -TargetVersion`

A versão do RMT que você planeja instalar; habilita verificações específicas da versão.

`--quiet / -Quiet`

Filtra a saída para mostrar apenas os resultados FAIL e WARN.

`--verbose / -Verbose`

A saída exibe dados técnicos detalhados para cada verificação realizada.

### Resultados do script e ações necessárias

A tabela a seguir explica o resultado do script e a ação necessária:

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 138px;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>Resultado</b></td><td style="text-align: center;"><strong>Status</strong></td><td style="text-align: center;"><b>Ação</b></td></tr><tr><td style="font-weight: bold;">PASS</td><td style="text-align: center;">CÓDIGO DE SAÍDA 0</td><td style="text-align: center;">Nnhum problema encontrado. A atualização continua.</td></tr><tr><td style="font-weight: bold;">WARN</td><td style="text-align: center;">CÓDIGO DE SAÍDA 1</td><td style="text-align: center;">A atualização continua, mas você deve revisar o relatório em busca de riscos não críticos.</td></tr><tr><td style="font-weight: bold;">FAIL</td><td style="text-align: center;">CÓDIGO DE SAÍDA 2</td><td style="text-align: center;">Atualização cancelada. Você deve resolver esses problemas antes de executar novamente a atualização.</td></tr></tbody></table>

## Script pós-atualização

Os scripts de verificação de integridade pós-atualização são executados automaticamente no final de cada instalação e atualização do RMT. Ele verifica se todos os serviços foram iniciados corretamente, se a infraestrutura está íntegra e se a configuração está intacta. A verificação pós-atualização não bloqueia o instalador. Todas as falhas identificadas são registradas no relatório final.

### Verificação manual pós-atualização

Para executá-lo manualmente, use as seguintes etapas com base no seu sistema operacional:

**No Linux:**

Execute os seguintes comandos como usuário root ou com privilégios `sudo`:

- No RMT Server:

sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade

- No Agent:

sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade

**No Windows:**

Os arquivos pós-atualização do RMT Server são instalados por padrão no seguinte local:

`C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1`

Os arquivos pós-atualização do Agent são instalados por padrão no seguinte local:

`C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\post-upgrade\rmt-post-upgrade-check.ps1`

Para executar os scripts manualmente, abra o PowerShell como administrador e navegue até o diretório de instalação do RMT antes de executar os comandos:

- No RMT Server:

.\\rmt-post-upgrade-check.ps1 -Component master -Mode upgrade

- No Agent:

.\\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade

### Opções adicionais

Você pode usar as seguintes opções para personalizar o script:

`--component / -Component`

Especifique RMT Server ou Agent. O script tentará detectar isso automaticamente, se omitido.

`--db-password / -DbPassword`

A senha do administrador interno do banco de dados RMT. Isso é necessário para habilitar as verificações de PostgreSQL.

`--output / -OutputPath`

O caminho onde o arquivo de relatório será salvo. O padrão é `/tmp/ (Linux)` ou `C:\temp\ (Windows)`.

`--target-version / -TargetVersion`

A versão do RMT específica para a qual você está atualizando, usada para verificações específicas da versão.

`--quiet / -Quiet`

Reduz a saída para mostrar apenas os resultados **FAIL** e **WARN**.

`--verbose / -VerboseOutput`

Fornece resultados técnicos detalhados para cada verificação realizada.

Observação: recomendamos definir RMT\_DB\_PASSWORD como uma variável de ambiente em vez de passá-la na linha de comando, pois os argumentos da linha de comando são visíveis na lista de processos.

### Resultados do script e ações necessárias

A tabela a seguir explica o resultado do script e a ação necessária:

<table style="width: 100%;margin-left: 0;margin-right: auto;" class="simple-table"><colgroup><col style="width: 211px;"><col style="width: 23%;"><col style="width: 21%;"></colgroup><tbody><tr><td><b>Resultado</b></td><td style="text-align: center;"><strong>Status</strong></td><td style="text-align: center;"><b>Ação</b></td></tr><tr><td style="font-weight: bold;">PASS</td><td style="text-align: center;">CÓDIGO DE SAÍDA 0</td><td style="text-align: center;">O sistema está íntegro. Não é preciso realizar ações.</td></tr><tr><td style="font-weight: bold;">WARN</td><td style="text-align: center;">CÓDIGO DE SAÍDA 1</td><td style="text-align: center;">Revise os avisos; a maioria se resolve por conta própria (por exemplo, atraso temporário de inicialização do RabbitMQ).</td></tr><tr><td style="font-weight: bold;">FAIL</td><td style="text-align: center;">CÓDIGO DE SAÍDA 2</td><td style="text-align: center;">Uma ou mais verificações críticas falharam; investigue e corrija.</td></tr></tbody></table>

## Relatórios

Você pode encontrar os relatórios pré-atualização aqui:

- Linux: `/tmp/rmt-precheck-<timestamp>.txt`
- Windows (Manual): `C:\temp\rmt-precheck-<component>-<timestamp>.txt`

Você pode encontrar os relatórios pós-atualização aqui:

- Linux: `<log-dir>/rmt-postcheck-report.txt`
- Windows (Manual): `C:\temp\rmt-postcheck-<component>-<timestamp>.txt`
- Windows (via instalador): quando o instalador executa a verificação, ele usa nomes de arquivo fixos:
    
    - `C:\temp\rmt-postcheck-master-report.txt`
    - `C:\temp\rmt-postcheck-agent-report.txt`
    
    Para obter informações sobre verificações pré e pós-atualização no relatório, consulte a seção [Referência de atualização](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade-reference.htm).

### Exemplo de relatório

Veja a seguir um exemplo de relatório de verificação de integridade pré-atualização:

\==================================================================  
RMT Pre-Upgrade Health Check Report  
Script Version : 1.0.0  
Generated      : 2026-04-08 14:30:00  
Component      : master  
Hostname       : rmt-master-01.example.com  
RMT Version    : 2025.1.9  
\==================================================================  
OVERALL STATUS : UPGRADE WITH CAUTION (2 warning(s) -- review before proceeding)  
PASS: 44  FAIL: 0  WARN: 2  INFO: 10  SKIP: 3  
\==================================================================  
WARNINGS -- Review Before Upgrading  
\==================================================================  
\[WARN\] #21d     Hangfire schema is 1.2 GB  
Check 21g for delete\_hash() volatility bug  
\[WARN\] #24      1 queue(s) with >10000 messages (max: 15234)  
Resolve backlogs before upgrading

<!-- document id=891366e9cada3e7ce72b5f3b09e22898ff7b93e83d373b04e931ca7dd57b9f44 url=/tableau/current/pt-br/server/security.md -->

[Pular para o conteúdo principal](#main-content)

# Segurança

Como parte do gerenciamento do Tableau Server, você pode configurar a autenticação, a segurança de dados e a segurança da rede.

## Outros artigos nesta seção

<!-- document id=e49587af891e56eff6608faf6c68b045e719bfc085e4aedb9869595008d26dc8 url=/tableau/current/pt-br/server/security_data.md -->

[Pular para o conteúdo principal](#main-content)

# Segurança de dados

O Tableau fornece várias maneiras de controlar quais usuários podem ver quais dados. Para fontes de dados que se conectam a bancos de dados ativos, também é possível controlar se os usuários serão solicitados a fornecer credenciais de banco de dados quando clicarem em uma exibição publicada. As três opções a seguir trabalham juntas para atingir resultados diferentes:

- **Conta de logon do banco de dados:** Ao criar uma fonte de dados que se conecta a um banco de dados dinâmico, você escolhe entre a autenticação no banco de dados por meio do Windows NT ou por meio do mecanismo interno de segurança do banco de dados.
- **Modo de autenticação:** Ao publicar uma fonte de dados ou uma pasta de trabalho com uma conexão de banco de dados ativa, você pode escolher um **Modo de autenticação**. Os modos que serão disponibilizados dependem das escolhas feitas acima.
- **Filtros de usuário:** É possível definir filtros em uma pasta de trabalho ou fonte de dados que controlam quais dados uma pessoa vê em uma exibição, com base na respectiva conta de logon do Tableau Server.

A tabela abaixo descreve algumas dependências com as opções acima:

<table class="TableStyle-Basic-Border" style="border-top-style: solid;border-top-width: thin;border-top-color: gray;border-bottom-style: solid;border-bottom-width: thin;border-bottom-color: gray;border-left-style: solid;border-left-width: thin;border-left-color: gray;border-right-style: solid;border-right-width: thin;border-right-color: gray;border-collapse: collapse;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" cellspacing="0"><colgroup><col title="1" style="width: 18;" class="TableStyle-Basic-Border-Column-Column1"><col title="2" style="width: 21;" class="TableStyle-Basic-Border-Column-Column1"><col title="3" style="width: 21;" class="TableStyle-Basic-Border-Column-Column1"><col title="4" style="width: 21;" class="TableStyle-Basic-Border-Column-Column1"><col title="5" style="width: 21;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th style="text-align: center; border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" colspan="2" class="TableStyle-Basic-Border-HeadE-Column1-Header1"><i>Opções de conexão de banco de dados</i></th><th style="text-align: center; border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" colspan="3" class="TableStyle-Basic-Border-HeadD-Column1-Header1"><i>Perguntas sobre a segurança de dados</i></th></tr><tr class="TableStyle-Basic-Border-Head-Header1"><th style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">A conta de logon do banco de dados usa...</th><th style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Modo de autenticação</th><th style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">E possível usar a segurança do banco de dados por usuário do Tableau Server?</th><th style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-HeadE-Column1-Header1">Os filtros de usuário são a única maneira de restringir quais dados cada usuário vê?</th><th style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-HeadD-Column1-Header1">Os caches da Web são compartilhados entre usuários?</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="3" style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Credenciais do Active Directory (Autenticação do Windows)</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Conta de serviço Run As</p></td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Sim</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Sim</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>Representar por meio da conta de serviço Run As do servidor</p></td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Sim</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não*</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Não</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Viewer (Visualizador) insere suas credenciais</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Sim</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não*</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Não</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="3" style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>Nome de usuário e senha</p></td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><i>Avisar usuário</i>: Os visualizadores são solicitados a fornecer as credenciais do banco de dados quando clicam em uma exibição. As credenciais podem ser salvas.</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Sim</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Não</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><i>Credenciais inseridas</i>: O publicador da pasta de trabalho ou fonte de dados pode inserir as respectivas credenciais de banco de dados.</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Sim</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Sim</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyB-Column1-Body1"><i>Representar por meio da senha inserida</i>: As credenciais de banco de dados com permissão de representação são inseridas.</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">Sim</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">Não*</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;" class="TableStyle-Basic-Border-BodyA-Column1-Body1">Não</td></tr></tbody></table>

\* Como podem ser criados resultados inesperados, o Tableau recomenda não usar esse modo de autenticação com filtros de usuário.

Os filtros de usuário, a opção de credenciais inseridas e os modos de representação têm efeitos semelhantes. Quando um usuário clica em uma exibição, não é solicitado que ele forneça credenciais e ele vê apenas os dados que pertencem a ele. No entanto, os filtros de usuário são aplicados na pasta de trabalho por editores, e os modos de autenticação de representação dependem das políticas de segurança definidas pelos administradores no próprio banco de dados.

## Outros artigos nesta seção

<!-- document id=7f97d56b3e7d36ae63d9322126b00c893863b9553112bfa55732084398e78c20 url=/tableau/current/pt-br/server/security_extensions.md -->

[Pular para o conteúdo principal](#main-content)

# Segurança de extensão - Práticas recomendadas para implantação

Essas práticas recomendadas são destinadas a diretores de TI e administradores, administradores de servidor e de site do Tableau e qualquer pessoa interessada em adotar o uso de extensões de painel e visualização com o Tableau. As extensões oferecem grandes oportunidades para estender e personalizar o uso do Tableau para atender às necessidades analíticas de cada cliente. Essa extensibilidade deve sempre incluir as considerações apropriadas em relação à segurança de seus dados e negócios. As práticas recomendadas destinam-se a implementações que têm uma combinação de usuários que utilizam o Tableau Desktop e o Tableau Server ou o Tableau Cloud.

## Segurança para extensões no Tableau

As extensões são aplicativos Web que estendem a funcionalidade do painel ou adicionam novas visualizações ao Tableau. Essas soluções podem ser gerenciadas diretamente pelo Tableau ou fornecidas na totalidade como serviços personalizados de terceiros. Esses serviços podem ser hospedados dentro de sua própria rede ou fornecidos por um provedor externo fora de sua rede. As extensões interagem com outros componentes na pasta de trabalho e criam uma experiência integrada para o usuário final usando o conteúdo de análise do Tableau. Para proporcionar essa experiência integrada, as extensões acessam os dados de resumo visíveis usados na pasta de trabalho. Na configuração específica, também podem acessar os dados subjacentes na pasta de trabalho, se necessário. Esse nível de acesso e interação é habilitado pela API de extensões do Tableau, projetada e compatível como parte da plataforma Tableau.

O Tableau aceita dois tipos padrões de extensões:

- [Extensões confiáveis do Tableau](#Tableau)
- [Extensões habilitadas para rede](#Network-)

### Extensões confiáveis do Tableau

Para oferecer suporte ao amplo uso de extensões em toda a comunidade, o Tableau gerencia serviços para ajudar a fornecer extensões para uso em escala. Essas extensões podem ser criadas e mantidas diretamente pelo Tableau como recursos da plataforma ou por desenvolvedores parceiros do Salesforce ou do Tableau, que trabalham em estreita colaboração com as equipes de produtos do Tableau para implantar em conjunto soluções para uso amplo da comunidade por meio do Tableau Exchange. As extensões confiáveis do Tableau são sempre hospedadas na infraestrutura do Tableau, gerenciadas e controladas pela equipe de produtos e de desenvolvimento do Tableau. O Tableau testa e analisa cada extensão antes de ser implantada ou atualizada. O Tableau tem requisitos rígidos para permitir apenas a comunicação entre clientes de usuários e os hosts de extensão do Tableau de acesso controlado. Com esse design, o Tableau pode fornecer padrões sobre necessidades comuns de extensões que podem ser úteis para sua comunidade. Para atender a esse padrão, o Tableau emprega diferentes soluções:

- [Extensões de área restrita](#Sandboxe)
- [Extensões criadas pelo Tableau](#Tableau-)
- [Extensões confiáveis criadas por parceiros do Tableau (opcionais)](#Trusted)

![Um diagrama listando os tipos de extensões confiáveis do Tableau.](/tableau/current/pt-br/server/pt-br/Img/tableau_trusted_extensions.png)

#### Extensões de área restrita

O Tableau hospeda extensões de área restrita, que são executadas em um ambiente protegido configurado especificamente para eliminar o risco de exfiltração de dados.  
O host de extensões de área restrita do Tableau é bloqueado para qualquer outro recurso ou serviço na Web. Uma extensão em sandbox pode consultar dados na pasta de trabalho usando a API de extensões, mas não pode enviar esses dados para nenhum lugar fora do sandbox. Os resultados da consulta estão no computador cliente (no navegador) e não podem ser enviados para qualquer lugar. O acesso restrito garante que apenas os funcionários do Tableau gerenciem todas as atualizações das extensões de área restrita e sejam os únicos a acessar esse host de extensão. As extensões de área restrita são habilitadas para uso por padrão e habilitadas para uso do Tableau Public.  

#### Extensões criadas pelo Tableau

As extensões criadas pelo Tableau são hospedadas pelo Tableau. Especificamente, essas extensões são criadas e mantidas pela equipe de desenvolvimento do Tableau como recursos de plataforma. Como outros recursos criados pelo Tableau, as extensões criadas pelo Tableau passam pelos padrões SDLC do Salesforce. Essas extensões são projetadas para passar JavaScript para o computador cliente. Isso permite que a extensão seja renderizada e processada pelo cliente. Esses recursos são aceitos diretamente pela equipe do Tableau e implantados por meio da mesma infraestrutura de host confiável do Tableau. As extensões criadas pelo Tableau são habilitadas para uso por padrão e habilitadas para uso do Tableau Public.

#### Extensões confiáveis criadas por parceiros do Tableau (opcionais)

As extensões confiáveis criadas por parceiros do Tableau são elaboradas por desenvolvedores parceiros de terceiros, mas revisadas e hospedadas pelo Tableau. Ao gerenciar a implantação para desenvolvedores parceiros (muitos dos quais também são líderes comunitários de longa data), essas novas soluções podem ser entregues em conjunto entre o Tableau e o parceiro do Tableau Exchange terceirizado. O Tableau testa cada solução de terceiros (e cada atualização) antes de ser implantada para uso em produção. Isso inclui testes funcionais e de comunicação de rede, bem como verificações de código automatizadas para encontrar vulnerabilidades a serem solucionadas. Como as outras extensões confiáveis do Tableau, essas extensões só permitem a comunicação entre o cliente do usuário e o host do Tableau. O acesso direto ao host é controlado e limitado apenas a funcionários do Tableau. Embora o Tableau não possa fazer alterações diretamente ou aplicar correções a essas soluções de terceiros, o tempo de atividade e a disponibilidade do serviço são regidos pelo Tableau. As extensões confiáveis criadas por parceiros do Tableau exigem que os administradores as habilitem para uso, mas geralmente são recomendadas e foram habilitadas para uso do Tableau Public.

### Extensões habilitadas para rede

As extensões habilitadas para rede são extensões não gerenciadas pelo Tableau. Estão hospedadas nos servidores Web localizados dentro ou fora da rede local e têm acesso total à Web. Isso permite que as extensões habilitadas para rede atendam a necessidades de integração mais específicas ou metas de implantação personalizadas fora dos padrões do Tableau. As extensões habilitadas para rede podem se conectar a outros aplicativos e serviços para oferecer novos recursos integrados ao Tableau. Isso inclui a geração de linguagem natural fora do Tableau ou o suporte para cenários de write-back. As extensões habilitadas para rede têm acesso total à Web, o que significa que podem oferecer recursos e experiências avançadas ao se conectarem a recursos externos. No entanto, como elas podem se comunicar com serviços adicionais e não são gerenciadas pelo Tableau, recomendamos que você avalie as extensões habilitadas para rede antes de implantar ou adotar em escala.

#### Extensões habilitadas para rede implantadas localmente

As extensões podem oferecer suporte à flexibilidade de implantação, como executar extensões localmente em uma rede local. Isso é útil sobretudo para implantações com requisitos de rede fisicamente isolados ou para organizações que preferem gerenciar suas próprias extensões. Por exemplo, os desenvolvedores internos podem criar extensões personalizadas que atendam a necessidades específicas de implantação. As extensões habilitadas para rede oferecem suporte ao objetivo de autoimplantação. Como essas extensões locais são executadas em hosts fora do Tableau e passam por suas próprias definições de versão personalizadas, recomendamos que você trabalhe com seus desenvolvedores para planejar adequadamente como esse recurso de extensão interna e o processo relevante são gerenciados para os usuários em sua implantação. Por design, a arquitetura de extensão habilitada para rede permite acesso total à Web; portanto, cabe aos clientes desenvolver seu próprio processo de revisão para garantir que as extensões se comuniquem especificamente apenas com recursos da Web permitidos e tenham proteções de segurança cibernética apropriadas para se proteger contra riscos. As extensões habilitadas para rede local devem ser adicionadas à lista de permissões de extensão de implantação pelos administradores do Tableau antes de serem autorizadas para uso. Essas soluções locais não são usadas no Tableau Public.

#### Extensões habilitadas para rede gerenciadas pelo provedor de terceiros

A arquitetura de extensão habilitada para rede também permite que as extensões sejam atendidas por um provedor terceirizado confiável, como diretamente por um parceiro do Tableau com o qual você estabeleceu um relacionamento formal de fornecedor. Nessas situações, uma extensão habilitada para rede, não gerenciada pelo Tableau, permite que os provedores ofereçam suporte direto à produção ou serviços personalizados. Quando tratada de maneira confiável, isso pode simplificar e expandir a personalização do Tableau com suporte de um provedor respeitável. Recomendamos que os clientes trabalhem diretamente com provedores terceirizados para uma compreensão mais completa de como as práticas de desenvolvimento, o design do código de extensão e a segurança de um provedor atendem às suas diretrizes internas. Essas extensões habilitadas para rede devem ser adicionadas à lista de permissões de extensão de implantação pelos administradores do Tableau antes de serem autorizadas para uso. Em raras ocasiões, essas soluções podem ser usadas no Tableau Public como exceções exclusivas para objetivos da comunidade.

### Considerações de risco com extensões habilitadas para rede

Como as extensões são aplicativos Web, há a possibilidade de que uma extensão habilitada para rede possa estar vulnerável a certos tipos de ataques mal-intencionados, que, por sua vez, poderiam apresentar um risco para o computador ou dados. O [Projeto Aberto de Segurança em Aplicações Web](https://www.owasp.org/) (OWASP) identifica anualmente os riscos de segurança de aplicações da Web mais críticos. Tais riscos são:

- Injeção de SQL
- Script entre sites (XSS)
- Exposição de dados confidenciais

Esses riscos podem comprometer a extensão se os desenvolvedores não validarem e manipularem corretamente as entradas do usuário ou se gerarem consultas dinâmicas para acessar bancos de dados confidenciais. À medida que você avalia as extensões que deseja permitir no Tableau, considere como elas gerenciam a autenticação, o acesso a dados ou a entrada do usuário e como eles reduzem os riscos de segurança.

### Redução de ameaças à segurança com extensões habilitadas para rede

Entender o que uma extensão faz é a primeira etapa para identificar os riscos à sua empresa. Muitas vezes, um painel ou uma extensão de visualização não acessa os dados subjacentes na pasta de trabalho e todo o código JavaScript é executado no contexto do navegador em execução no computador do usuário. Nesses casos, nenhum dado deixa o computador, mesmo que a extensão possa ser hospedada em um site de terceiros fora do seu domínio. Algumas extensões permitem que você conecte o Tableau a outros aplicativos já implantados em seu domínio.

O Tableau fornece medidas e requisitos de segurança para extensões. Esses requisitos estão habilitados para o Tableau Desktop, Tableau Server e Tableau Cloud.

- Todas as extensões devem usar o protocolo HTTP Secure (HTTPS).
- Por padrão, qualquer pessoa que usar um painel com uma extensão habilitada para rede será avisada e solicitada permissão de extensão para execução. A extensão deverá solicitar permissão se acessar dados subjacentes.
- Para executar no Tableau Server ou Tableau Cloud, a URL da extensão habilitada para rede deve ser adicionada a uma lista de permissões. O administrador do servidor gerencia essa lista para o Tableau Server. O administrador de site gerencia essa lista para o Tableau Cloud.
- No Tableau Server e no Tableau Cloud, o administrador do servidor ou de site (respectivamente) pode controlar se o prompt é exibido para cada extensão habilitada para rede.

Para obter mais informações, consulte [Gerenciar extensões de painel e visualização no Tableau Server](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm).

## Gerenciar extensões usando o Tableau

As extensões fornecem uma maneira de adicionar recursos exclusivos a painéis e novas visualizações à planilhas. É possível usar extensões para integrar diretamente o painel a aplicativos fora do Tableau. Apesar de as extensões abrirem um mundo de possibilidades, há instâncias em que você precisa ou deseja manter o controle de como extensões são implantadas na sua empresa. Com isso em consideração, as extensões não são diferentes de qualquer outro software que você pretende utilizar. Antes de implantar aplicativos de software na sua empresa, você deve testar e verificar se o software funciona conforme esperado e é seguro. O mesmo ocorre nas extensões.

Primeiro, determine qual nível de acesso seus usuários devem ter e identifique as extensões que deseja usar (ou, inversamente, as extensões que não deseja usar). Em seguida, use os controles e recursos do Tableau para restringir e selecionar o painel e as extensões de visualização aos quais os usuários têm acesso.

- É necessário restringir quem pode adicionar ou usar extensões no Tableau Desktop? Consulte [Recomendações para o Tableau Desktop](#Recommen)
- É necessário restringir ou controlar as extensões as quais seus usuários têm acesso? Consulte [Recomendações para o Tableau Server e Tableau Cloud](#Recommen2).

## Recomendações para o Tableau Desktop

Há uma variedade de opções para implantar o Tableau Desktop na sua empresa. Você pode permitir acesso irrestrito a extensões ou impor limites e restrições de quem tem acesso a extensões e em que circunstâncias.

Por padrão, os usuários do Tableau Desktop têm acesso irrestrito a extensões confiáveis do Tableau e habilitadas para rede. O Tableau fornece cinco opções que podem ser usadas em qualquer permutação durante a instalação para alterar as configurações padrão.

- Desative todas as extensões (`DISABLEEXTENSIONS`)
- Desative as extensões habilitadas para rede`DISABLENETWORKEXTENSIONS`().
- Desative as extensões de área restrita (`DISABLESANDBOXEXTENSIONS`).
- Desative as extensões criadas pelo Tableau `DISABLETABTRUSTEDEXTENSIONS`().
- Desative as extensões confiáveis criadas por parceiros do Tableau (`DISABLE3PTRUSTEDEXTENSIONS`).

**Observação:** é possível alterar essas configurações após a instalação do Tableau Desktop ao editar o Registro (Windows) ou executar um script (Mac) em cada Área de trabalho. Consulte [Desativar extensões do painel](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_setting_changes.htm#dashboard_extensions).

### Exemplo de cenários de implantação

Usando as configurações de instalação, é possível implantar o Tableau Desktop de várias maneiras.

- **Permitir todas as extensões** - neste cenário de implantação, você opta por confiar nos autores do Tableau para selecionar as extensões confiáveis do Tableau e habilitadas para rede que eles querem usar. Se você quiser capacitar os usuários do Tableau Desktop com a maior flexibilidade, use as configurações de instalação padrão. Usando as configurações padrão, os usuários do Tableau Desktop têm acesso irrestrito a extensões confiáveis do Tableau e habilitadas para rede. As configurações padrão são: `DISABLEEXTENSIONS=0` e `DISABLENETWORKEXTENSIONS=0`. Consulte [Instalar o Tableau Desktop a partir da linha de comando](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm).
    
    **Permitir apenas extensões confiáveis do Tableau** - neste cenário, você confia nos serviços de extensão do Tableau para revisar, implantar e selecionar adequadamente as extensões que são para uso geral da comunidade, mas não tem certeza sobre as extensões habilitadas para rede e deseja impedir seu uso no momento. Para desativar o suporte das extensões habilitadas para rede, defina a propriedade `DISABLENETWORKEXTENSIONS` (`DISABLENETWORKEXTENSIONS=1`). Mantenha a configuração padrão para permitir extensões (`DISABLEEXTENSIONS=0`). Consulte [Instalar o Tableau Desktop a partir da linha de comando](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm).
- **Permitir apenas extensões de área restrita** - neste cenário, você já pode ter usado extensões de área restrita antes e sentir que elas são seguras para uso,  
    mas você não está pronto para atualizar sua política para permitir um uso mais amplo de extensões criadas pelo Tableau e confiáveis criadas por parceiros do Tableau; nem deseja alterar a política para permitir extensões habilitadas para rede. Você deseja apenas permitir que as extensões do sandbox sejam usadas da mesma forma que têm sido e impedir o uso de todas as outras formas de extensões confiáveis do Tableau e habilitadas para rede. Para desativar o suporte de extensões habilitadas para rede, extensões criadas pelo Tableau e extensões confiáveis criadas por parceiros do Tableau: defina as propriedades (`DISABLENETWORKEXTENSIONS=1`), `DISABLETABTRUSTEDEXTENSIONS` (`DISABLETABTRUSTEDEXTENSIONS=1`), `DISABLE3PTRUSTEDEXTENSIONS` `DISABLENETWORKEXTENSIONS` (`DISABLE3PTRUSTEDEXTENSIONS=1`). Mantenha a configuração padrão para permitir extensões (`DISABLEEXTENSIONS=0`). Consulte [Instalar o Tableau Desktop a partir da linha de comando](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm).
- **Não são permitidas extensões** - neste cenário, você não deseja permitir que os usuários utilizem extensões de qualquer tipo. Nesse caso, desative o suporte para todas as extensões usando a propriedade `DISABLEEXTENSIONS` (`DISABLEEXTENSIONS=1`). Consulte [Instalar o Tableau Desktop a partir da linha de comando](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_automate.htm)

**Usar uma combinação de configurações** - você pode ter alguns usuários que precisam e devem ter acesso irrestrito a todas as extensões, e outros para os quais o acesso a extensões de área restrita é suficiente e, por fim, um conjunto de usuários que não precisam de acesso a extensões de jeito nenhum. Como as opções de extensão são definidas de acordo com a área de trabalho, você pode configurar a implantação para usuários específicos e seus casos de uso.

**Criação na Web** \- se o Tableau Server ou o Tableau Cloud estiver disponível para os usuários, eles podem usar a Web para acessar as extensões. Na criação na Web, aplicam-se as configurações do servidor ou site para extensões. Nesse cenário, os administradores de servidor e de site podem determinar quais extensões os usuários podem acessar. Isso é gerenciado com base nas configurações de extensão do servidor e do site, que incluem opções de extensão confiável do Tableau e a lista de permissões de extensão para extensões explícitas habilitadas para rede.  

![Um diagrama que ilustra a distinção entre o acesso irrestrito e restrito às extensões do Tableau.](/tableau/current/pt-br/server/pt-br/Img/ext_desktop_deploy3.png)

## Recomendações para o Tableau Server e Tableau Cloud

Se os usuários tiverem acesso ao Tableau Server ou ao Tableau Cloud, você poderá usar os controles de segurança internos para determinar limites e restrições nas extensões que podem ser usadas e em quais circunstâncias. Se você desativou as extensões no Tableau Desktop, ainda poderá permitir que os usuários adicionem extensões na criação na Web, mas poderá limitar o número de extensões que podem ser usadas apenas àquelas que você aprovar para execução.

![Um diagrama ilustra como as configurações do Tableau Server e do Tableau Cloud gerenciam o acesso à extensão.](/tableau/current/pt-br/server/pt-br/Img/ext_server_deploy3.png)

### Permitir extensões confiáveis do Tableau e extensões habilitadas para rede na lista de permissões

A partir do Tableau 2025.3, o Tableau permite que algumas extensões confiáveis do Tableau sejam executadas por padrão. Isso significa que as extensões de área restrita e as extensões criadas pelo Tableau são elevadas para uso, enquanto as extensões confiáveis criadas por parceiros do Tableau podem ser habilitadas pelos administradores. Embora encorajemos o uso de todas as extensões confiáveis do Tableau, como fazemos com nossos ambientes como o Tableau Public, achamos fundamental que os administradores definam a política relevante para suas implantações.

As extensões habilitadas para rede não são permitidas, a menos que tenham sido adicionadas à lista de permissões. Os administradores podem editar as configurações e adicionar extensões habilitadas para rede à lista de permissões do site (Configurações \> Extensões \> Habilitar extensões específicas).

**Observação** : para tornar a lista de permissões o comportamento padrão das extensões no Tableau 2018.2 e no Tableau 2018.3, altere as configurações do site. Na página Configurações de extensões, em Comportamento padrão de extensões, desmarque a opção Habilitar extensões desconhecidas... No Tableau Server 2019.1, no Tableau 2019.2 e no Tableau 2019.3, por padrão, nenhuma extensão pode ser executada a menos que tenha sido adicionada à lista de permissões.

#### Verificação para a lista segura:

- A extensão vem de uma fonte que você conhece e confia?
- Verifique a URL da extensão. A URL parece suspeita ou contém nomes de domínio duvidosos?
- A extensão requer acesso a dados completos (dados subjacentes) ou de resumo? Consulte [Entenda o acesso aos dados](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm#Understa).
- Teste as extensões antes de permitir amplo uso. Consulte Testar extensões para segurança. Consulte [Testar a segurança das extensões habilitadas para rede](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm#Test).

#### Adicione extensões à lista segura:

- Consulte [Adicionar extensões à lista de permissões e configurar a extensão](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm#Add)

### Bloquear extensões específicas de serem executadas no Tableau Server

No Tableau Server, você pode bloquear extensões específicas adicionando a URL à lista de bloqueios. Isso é útil se você tiver vários sites configurados de maneiras diferentes para extensões. Por exemplo, se você tiver um site de teste onde deseja testar extensões internas ou de terceiros, talvez tenha habilitado o comportamento padrão para extensões, onde extensões não listadas têm permissão para serem executadas se elas não acessarem os dados subjacentes na pasta de trabalho. Adicionar uma extensão à lista de bloqueios impedirá que ela seja usada inadvertidamente no site de teste.

- Adicione a URL das extensões que não deseja permitir à lista bloqueada. Essa opção está disponível apenas no Tableau Prep. Consulte [Bloquear extensões específicas](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm#Block).

### Desativar extensões em um site

Por padrão, as extensões estão habilitadas no Tableau Server e no Tableau Cloud. No Tableau Server, o administrador do servidor pode desativar as extensões de um site. No Tableau Cloud, o administrador de site pode desativar as extensões do site. No Tableau Server, o administrador do servidor pode desativar completamente as extensões, o que substitui as configurações do site. Não é necessário alterar essa configuração no servidor ou no site, pois você pode controlar as extensões habilitadas para rede que deseja permitir na lista de permissões. Você também pode controlar as configurações de extensões confiáveis do Tableau, onde extensões de área restrita e extensões criadas pelo Tableau são permitidas por padrão.

- Para desabilitar as extensões em um site (Tableau Server, Tableau Cloud), altere as configurações do site que permitem aos usuários executar extensões no site. Consulte [Controlar o uso de extensões](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm#Control).

### Mostrar ou ocultar prompts de usuário para executar extensões habilitadas para rede

Ao adicionar uma extensão habilitada para rede à lista de permissões, é possível configurar se os usuários veem os prompts por padrão ao adicionar a extensão a um painel ou ao interagir com uma exibição que possui a extensão. O prompt apresenta detalhes da extensão habilitada para rede aos usuários, além de se ela possui acesso aos dados completos. O prompt dá aos usuários a capacidade de permitir ou negar que a extensão seja executada. Você pode ocultar esse prompt de usuários, permitindo que a extensão seja executada imediatamente. Quando ativadas para um site, as extensões de área restrita são permitidas por padrão e não avisam os usuários.

### Desativar todas ou algumas extensões confiáveis do Tableau

A partir do Tableau 2025.3, o Tableau permite que algumas extensões confiáveis do Tableau sejam executadas no Tableau Server e no Tableau Cloud por padrão. As extensões de área restrita e as extensões criadas pelo Tableau são elevadas para uso, enquanto as extensões confiáveis criadas por parceiros do Tableau podem ser habilitadas pelos administradores. As extensões de área restrita são executadas em um ambiente protegido e são hospedadas pelo Tableau. As extensões criadas pelo Tableau são desenvolvidas, mantidas e hospedadas pelo Tableau. As extensões confiáveis criadas por parceiros do Tableau são elaboradas e mantidas por desenvolvedores parceiros terceirizados, mas têm suas soluções e atualizações revisadas e hospedadas pelo Tableau para disponibilidade e escala.

Os administradores podem controlar se os usuários podem executar todas, algumas ou nenhuma das extensões confiáveis do Tableau em um site. As extensões confiáveis não precisam ser adicionadas à lista de permissões. Quando as extensões confiáveis do Tableau são permitidas, os usuários podem adicionar livremente extensões confiáveis do Tableau às pastas de trabalho e podem abrir e usar pastas de trabalho que contenham extensões confiáveis do Tableau. Se precisar bloquear uma extensão confiável do Tableau, entre em contato com o Tableau para saber sobre a URL de extensão específica a ser adicionada à lista de bloqueio do servidor.  
Os administradores de servidor podem adicionar qualquer extensão à sua lista de bloqueio global de implantação. Se você precisar desativar completamente as extensões confiáveis do Tableau, poderá alterar a configuração padrão do site. Se você alterar a configuração padrão das extensões confiáveis do Tableau, somente as extensões que estiverem na lista de permissões poderão ser executadas.

<!-- document id=baac154584430476e1341b5234eee54affbb8c1a8c46360d643ee25ddfc63779 url=/tableau/current/pt-br/server/security_net.md -->

[Pular para o conteúdo principal](#main-content)

# Segurança de rede

Existem três interfaces de rede principais no Tableau Server:

- **Cliente para o Tableau Server**:O cliente pode ser um navegador da Web, o Tableau Mobile, o Tableau Desktop ou o utilitário [tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm).
- **Tableau Server para seu(s) banco(s) de dados**Para atualizar extrações de dados ou manipular conexões de banco de dados ativas, o Tableau Server precisa se comunicar com seus bancos de dados.
- **Comunicação de componente do servidor**: Isso se aplica somente a implantações distribuídas.

Na maioria das organizações, o Tableau Server também é configurado para se comunicar com a Internet e com um servidor SMTP.

## Cliente para o Tableau Server

Um cliente do Tableau Server pode ser um navegador da Web, um dispositivo com o Tableau Mobile, o Tableau Desktop ou comandos tabcmd. As comunicações entre o Tableau Server e seus clientes usam solicitações e respostas HTTP padrão. Recomendamos configurar o Tableau Server para HTTPS em todas as comunicações. Quando o Tableau Server é configurado para SSL, todo o conteúdo e as comunicações entre clientes são criptografados usando SSL e o protocolo HTTPS é usado para solicitações e respostas.

Por padrão, as senhas são comunicadas dos navegadores e do tabcmd para o Tableau Server usando criptografia de chave pública/privada de 1024 bits. Esse nível de criptografia não é considerado forte o suficiente para comunicações seguras. Além disso, esse método, no qual uma chave pública é enviada para o destinatário claramente e sem autenticação de camada de rede, é suscetível a ataques no meio do caminho.

Para proteger o tráfego de rede de clientes para o Tableau Server de forma adequada, é necessário configurar SSL com um certificado de uma autoridade de certificação confiável.

Consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm).

### Acesso do cliente pela Internet

Recomendamos um servidor de proxy gateway para habilitar o acesso de cliente seguro pela Internet ao seu Tableau Server. Não recomendamos executar o Tableau Server em um DMZ ou fora de sua rede interna protegida.

Configure um servidor de proxy reverso, com SSL habilitado, para lidar com todo o tráfego de entrada da internet. Neste cenário, o proxy reverso é o único endereço IP externo (ou intervalo de endereços se vários proxies reversos estiverem balanceando a carga de solicitações de entrada) com o qual o Tableau Server se comunicará. Proxies reversos são transparentes para a solicitação de clientes, dessa forma ofuscando as informações de rede do Tableau Server e simplificando a configuração do cliente.

Para obter informações sobre configuração, consulte [Configurar proxies e balanceadores de carga para o Tableau Server](https://help.tableau.com/current/server/pt-br/proxy.htm).

### Proteção contra roubo de clique

Como padrão, o Tableau Server tem a _proteção contra roubo de clique_ habilitada. Isso ajuda a evitar determinados tipos de ataques em que o invasor sobrepõe uma versão transparente da página no topo de uma página de aparência inofensiva, para fazer com que o usuário clique nos links e insira as informações. Com a proteção contra roubo de clique habilitada, o Tableau Server impõe determinadas restrições em exibições inseridas. Para obter mais informações, consulte [Proteção contra roubo de clique](https://help.tableau.com/current/server/pt-br/clickjack_protection.htm)

## Tableau Server para seu banco de dados

O Tableau Server faz conexões dinâmicas com bancos de dados para processar conjuntos de resultados e atualizar extrações. Ele usa drivers nativos para se conectar a bancos de dados sempre que possível e depende de um adaptador ODBC genérico quando drivers nativos estiverem indisponíveis. Todas as comunicações com o banco de dados são roteadas por meio desses drivers. Assim, configurar o driver para se comunicar em portas não padrão ou fornecer criptografia de transporte faz parte da instalação do driver nativo. Esse tipo de configuração é transparente para o Tableau.

Quando um usuário armazena credenciais para fontes de dados externas no Tableau Server, elas são armazenados criptografadas no banco de dados interno do Tableau Server. Quando um processo usa essas credenciais para consultar a fonte de dados externa, o processo recupera as credenciais criptografadas do banco de dados interno e descriptografa-as no processo.

## Tableau Server com a Internet

Em alguns casos, nos quais os usuários se conectam a fontes de dados externas, como os servidores de mapa do Tableau, o Tableau Server precisará se conectar à internet. Recomendamos que você execute todos os componentes do Tableau dentro de sua rede protegida. Portanto, as conexões com a internet podem precisar que você configure o Tableau Server para usar um proxy de encaminhamento.

## Tableau Server com um servidor SMTP

Você pode configurar o Tableau Server para enviar notificações evento para administradores e usuários. A partir da versão 2019.4, o Tableau Server é compatível com TLS para a conexão SMTP. Consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

## Comunicação com o repositório

É possível configurar o Tableau Server para usar Secure Sockets Layer (SSL) para comunicações criptografadas em todo o tráfego que é trocado com o repositório Postgres para e de outros componentes do servidor. Por padrão, o SSL fica desabilitado para comunicações entre componentes de servidor e o repositório.

Para obter mais informações, consulte [Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm).

Para obter mais informações, consulte [tsm security repository-ssl enable](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#postres-ssl-enable)

## Comunicação de componente do servidor em um cluster

Existem dois aspectos para a comunicação entre os componentes do Tableau Server em uma instalação de servidor distribuído: confiança e transmissão. Cada servidor em um cluster do Tableau usa um modelo confiável rígido para garantir que ele receba solicitações válidas de outros servidores no cluster. Computadores no cluster em que um processo de gateway está em execução aceitam solicitações de terceiros (clientes), a menos que sejam antecedidos por um balanceador de carga, que recebe as solicitações. Os servidores que não estejam executando um processo de gateway só aceitam solicitações de outros membros confiáveis do cluster. A confiança é estabelecida por uma lista autorizada de endereço IP, porta e protocolo. Se algum deles for inválido, a solicitação será ignorada. Todos os membros do cluster podem se comunicar entre si.

Quando um usuário armazena credenciais para fontes de dados externas no Tableau Server, elas são armazenados criptografadas no banco de dados interno do Tableau Server. Quando um processo usa essas credenciais para consultar a fonte de dados externa, o processo recupera as credenciais criptografadas do banco de dados interno e descriptografa-as no processo.

## Outros artigos nesta seção

<!-- document id=ed167fb7269821cc146615381cca082ace7f3c9f3b63c889b9e809d09538fb6e url=/tableau/current/pt-br/server/rls_datasource.md -->

[Pular para o conteúdo principal](#main-content)

# Segurança em nível de linha no banco de dados

Se sua organização já criou a segurança em nível de linha (RLS) em um banco de dados, você poderá usar uma das seguintes técnicas para tirar proveito da RLS existente. Para utilizar os modelos de segurança do banco de dados, são necessárias conexões em tempo real. Além disso, essas técnicas provavelmente não estão disponíveis no Tableau Cloud; o nome de usuário do Tableau para Tableau Cloud é um endereço de e-mail exclusivo, que normalmente não é a identidade do usuário no lado do banco de dados.

Não é necessariamente mais fácil ou melhor implementar um modelo de RLS integrada, em comparação a criá-la tendo em mente o Tableau. Geralmente, essas técnicas são utilizadas quando uma organização já investiu nessas tecnologias e querem aproveitar o investimento.

**Observação:** para obter informações sobre as alternativas que você pode usar para implementar a segurança em nível de linha no Tableau, consulte [Visão geral das opções de segurança em nível de linha no Tableau](https://help.tableau.com/current/server/pt-br/rls_options_overview.htm).

## Representação (Microsoft SQL Server)

O Microsoft SQL Server (e alguns sistemas relacionados) pode ser configurado de modo que os usuários do banco de dados tenham acesso apenas a exibições com filtros de RLS incorporados, utilizando Tabelas de junção de segurança ou exibições criadas pelo DBA. O Tableau pode tirar proveito disso usando um conceito chamado “representação”.

Ao publicar uma fonte de dados do Tableau que contém uma conexão MS SQL Server para o Tableau Server, há duas opções de autenticação disponíveis para tirar proveito da representação. O menu visualizado dependerá do logon no SQL Server, se você usou a autenticação de rede ou digitou as credenciais de nome de usuário/senha.

Para ativar a filtragem de RLS para qualquer usuário que possa acessar a fonte de dados publicada no Tableau Server, a conta do AD Run-As ou as credenciais inseridas do SQL Server devem ter permissão para EXECUTE AS para todos os usuários do Tableau no banco de dados que acessará o painel ou a fonte de dados. Todos os usuários do Tableau devem existir no servidor do banco de dados como usuários, com direitos SELECT para as exibições às quais você está tentando se conectar (e aplicar a RLS). Consulte [Requisitos de representação](https://help.tableau.com/current/server/pt-br/impers_requ.htm) para obter a lista abrangente de requisitos.

## Kerberos e delegação restrita

A delegação restrita no Tableau Server que usa o Kerberos opera de forma semelhante à representação na medida em que permite que o Tableau Server use as credenciais do Kerberos da exibição de uma pasta de trabalho ou da exibição para executar uma consulta em nome do visualizador, portanto, se a RLS for configurada no banco de dados, o visualizador da pasta de trabalho verá somente os dados dele.

Para ver a lista abrangente de bancos de dados em que a delegação do Kerberos é suportada, consulte [Habilitar a Delegação do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm). É necessário o Active Directory; o computador em que o Tableau Server está instalado deve ser associado ao domínio do Active Directory. O [método de autenticação](https://help.tableau.com/current/pro/desktop/pt-br/publishing_sharing_authentication.htm#kerberos-environments) especificado ao publicar a fonte de dados deve ser as credenciais de visualizador.

Observe que o kerberos pode ser utilizado para a RLS ao usar o Microsoft Analysis Services.

### Fonte de dados multidimensional OLAP

As conexões da Fonte de dados multidimensional OLAP no Tableau não têm o equivalente a um filtro de fonte de dados, que é necessário para o método de RLS baseado na tabela de direitos no Tableau ou acesso à função USERNAME(). Por essas razões, o Kerberos e a delegação restrita consistem em uma abordagem recomendada para a RLS com os bancos de dados OLAP, o que permite que o Tableau utilize a filtragem de usuário que já foi implementada no lado do Servidor OLAP.

Se os usuários que visualizam o painel não fizerem parte do domínio, será possível a abordagem manual para criar filtros de usuário. No entanto, como o Conjunto de filtros de usuário gerado não pode ser adicionado como um filtro de fonte de dados e, em vez disso, existirá na divisória Filtros, é importante que a funcionalidade de edição na Web e pasta de trabalho de download não seja permitida para as exibições publicadas que utilizam esse método.

## Delegação SAML e SAP HANA

Se o Tableau Server for configurado para usar [Configurar SSO para SAP HANA](https://help.tableau.com/current/server/pt-br/config_sap_hana_sso.htm) para proporcionar uma experiência de logon único, as credenciais de visualizador serão usadas para executar a consulta como esse usuário, o que ocorrerá de acordo com a segurança aplicada no nível de usuário. O [método de autenticação](https://help.tableau.com/current/pro/desktop/pt-br/publishing_sharing_authentication.htm#kerberos-environments) especificado ao publicar a fonte de dados deve ser as credenciais de visualizador.

## SQL inicial para impor uma sessão específica do usuário (Oracle VPD)

O SQL inicial permite especificar um comando SQL que é executado quando há uma conexão com o banco de dados com a finalidade de configurar tabelas temporárias para uso durante a sessão ou de configurar um ambiente de dados personalizado.

Para o Oracle VPD, você pode configurar uma sessão específica para um usuário, executando um procedimento armazenado ou uma função específica para definir o contexto da conexão com o banco de dados para corresponder ao nome de usuário do Tableau:

begin
DBMS\_SESSION.SET\_IDENTIFIER(\[TableauServerUser\]);
end;

Os mesmos requisitos de alto nível são válidos para usá-lo no RLS e na representação; o DBA deve configurar o VPD e todos os usuários associados para existir no banco de dados.

No MS SQL Server, é possível impor um comando EXECUTE AS (no entanto, é semelhante ao que o Tableau já faz com a representação):

EXECUTE AS USER = \[TableauServerUser\] WITH NO REVERT;

**Observação**: se a fonte de dados for inserida e um usuário tiver permissões para editar na Web ou baixar a pasta de trabalho, a RLS não existe pois o SQL inicial que a impõe pode ser facilmente removido. A fonte de dados deve ser publicada separadamente, em vez de ser inserida na pasta de trabalho.

## Matriz de comparação para métodos de segurança em nível de linha

<table class="table--plain"><colgroup><col><col style="width: 28%;"><col style="width: 28%;"><col style="width: 28%;"></colgroup><tbody><tr><td>Método</td><td>Útil quando</td><td>Prós</td><td>Contras</td></tr><tr><td>Tabela de direitos (recomendado)</td><td><ul><li>Existe um conceito de direitos no banco de dados</li><li>A organização está configurando a Segurança em nível de linha pela primeira vez</li></ul></td><td><ul><li>Fácil de testar, atualizar, manter e dimensionar</li><li>Funciona para conexões em tempo real e extrações na versão 2018.3+</li></ul></td><td><ul><li>Requer a criação e a manutenção da tabela de direitos</li><li>Pode exigir a seleção e a criação de chaves apropriadas para otimizar o desempenho</li></ul></td></tr><tr><td>CONTAINS() com extrações</td><td><ul><li>Implementação de RLS em extrações antes da versão 2018.3</li></ul></td><td><ul><li>Permite que você aproveite a eficiência da extração</li></ul></td><td><ul><li>Requer o mapeamento de todos os usuários em uma única coluna</li><li>Difícil de voltar para conexões em tempo real devido ao cálculo da cadeia de caracteres</li></ul></td></tr><tr><td>Representação</td><td><ul><li>Cada usuário que acessar os dados existirá como um usuário no SQL&nbsp;Server (geralmente implantações internas)</li></ul></td><td><ul><li>A segurança é tratada e mantida em um só lugar - o banco de dados</li></ul></td><td><ul><li>Exige que cada pessoa que acessar a exibição exista como um usuário no SQL Server</li><li>Só funciona para o Microsoft SQL Server</li></ul></td></tr><tr><td>Kerberos</td><td><ul><li>Todos os bancos de dados necessárias são configuradas para a delegação do Kerberos e a RLS é configurada no banco de dados (geralmente implantações internas)</li></ul></td><td><ul><li>O nome do visualizador é exibido nos registros de acesso para o banco de dados</li><li>A segurança é tratada e mantida no banco de dados</li></ul></td><td><ul><li>O Tableau deve ser configurado para usar LDAP - Active Directory</li><li>O Tableau Server deve estar associado ao domínio do AD</li><li>Cada usuário deve existir no domínio do AD</li></ul></td></tr><tr><td>SQL inicial</td><td><ul><li>O banco de dados oferece suporte ao SQL inicial e a RLS é configurada no lado do banco de dados</li></ul></td><td><ul><li>Permite a transmissão dos parâmetros do Tableau no tempo de carregamento</li><li>A conexão dedicada que não pode ser compartilhada com outros usuários</li><li>Os usuários devem existir no banco de dados para executar a consulta como usuário</li></ul></td><td><ul><li>Nem todos os bancos de dados oferecem suporte ao SQL inicial</li><li>Possíveis implicações de desempenho devido ao compartilhamento restrito em cache</li></ul></td></tr></tbody></table>

<!-- document id=c58433af8e4f76f8901fcaec33c88de9a57cacc5d04e010baad072f1d858caed url=/tableau/current/pt-br/server/ts_azure_virtual_machine_selection.md -->

[Pular para o conteúdo principal](#main-content)

# Seleção de um tipo e um tamanho de máquina virtual do Microsoft Azure

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

O Microsoft Azure oferece muitos tipos de imagens de VM de vários tamanhos. Escolher a imagem de VM certa para sua carga de trabalho é um fator importante para uma implantação bem-sucedida do Tableau Server. Você pode escolher entre uma ampla variedade de imagens de VM do Microsoft Azure. Para obter uma lista completa de todos os tipos e tamanhos de imagens de VM, consulte [Série de máquina virtual](https://azure.microsoft.com/pt-br/pricing/details/virtual-machines/series/) no site do Microsoft Azure.

É importante selecionar uma imagem que possa executar o Tableau Server. A imagem da VM deve atendar às [diretrizes de hardware](http://www.tableau.com/pt-br/products/techspecs#server) do Tableau Server (um mínimo de 8 núcleos e 128 GB de RAM). Recomendamos escolher uma instância que suporte o [armazenamento Premium](https://docs.microsoft.com/en-us/azure/storage/common/storage-premium-storage) do Azure.

Um Tableau Server de 64 bits exige, no mínimo, uma CPU de 4 núcleos (o equivalente a 8 vCPUs do Azure) e 64 GB de RAM. No entanto, um total de 8 núcleos de CPU (16 vCPUs do Azure) e 128 GB de RAM são altamente recomendados para uma única VM de produção do Microsoft Azure.

## Tipos e tamanhos típicos de VM para ambientes de desenvolvimento, teste e produção

- D Series – D13, D14, D16
- DS Series – DS13, DS14

**Observação:** recomendamos que você use as VMs série DS com Armazenamento Premium, o que é mais adequado para o banco de dados e outros aplicativos de alto desempenho. Normalmente, as instâncias D16s\_v3 ou DS13\_V2 são boas opções. Para fins de teste e de prova de conceito, uma máquina virtual com apenas quatro núcleos pode ser aceitável (como a DS13\_V2).

Use dois ou três discos em configuração RAID 0 para obter uma quantidade suficiente de operações de entrada/saída por segundo (IOPS) em um único volume para proporcionar alto rendimento de disco. Dois discos distribuídos como um único volume oferecem desempenho suficiente para um nó adicional que não hospede um repositório. Se estiver executando o Tableau Server em um único computador, use três drives distribuídos como um único volume (RAID 0) para proporcionar um melhor desempenho do disco, uma vez que mais operações de disco ocorrerão nesse computador.

## Especificações recomendadas para uma única instância de produção

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col><col class="TableStyle-Basic-Border-Column-Column1" style="width: 20%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 65%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"></colgroup><tbody><tr><th>Componente/recurso</th><th colspan="10">Microsoft Azure</th></tr><tr><td><p>CPU</p></td><td colspan="10"><p>16 núcleos vCPU</p></td></tr><tr><td><p>Sistema operacional</p></td><td colspan="10"> <div><table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">&nbsp;</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">2021.3.0 - 2023.3.0</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">2023.3.1 - 2026.2.x</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2016</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2019 (x64)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Windows Server 2022</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="text-align: center;"><strong>Observação:</strong>&nbsp;o Windows Server 2022 <em>não </em>é aceito em versões anteriores a 2023.3.1. A partir de abril de 2023, os instaladores de todas as versões do Tableau Server no Windows anteriores a 2023.3.1 bloquearão a instalação no Windows 2022.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr></tbody></table></div></td></tr><tr><td><p>Memória</p></td><td colspan="10"><p>Mais de 128 GB de RAM (4 GB de RAM por vCPU)</p></td></tr><tr><td><p>Armazenamento</p></td><td colspan="10"><p>Dois volumes:</p><p>Volume de 30 a 50 GiB para o sistema operacional</p><p>Volume de 100 GiB ou maior para o Tableau Server</p></td></tr><tr><td><p>Tipo de armazenamento</p></td><td colspan="10"><p>Armazenamento Premium P20 (512 GB)++</p><p>Para obter mais informações, consulte <a href="https://docs.microsoft.com/en-us/azure/storage/common/storage-premium-storage" target="_blank">Armazenamento Premium de alto desempenho e discos gerenciados para VMs</a> no site do Microsoft Azure.</p></td></tr><tr><td><p>Latência do disco</p></td><td colspan="10"><p>Menor ou igual a 20ms, conforme medido pela <b>Média</b>.<b> </b>Contador de desempenho do <b>disco de transferência/s</b> no Windows.</p></td></tr></tbody></table>

<!-- document id=8ca3614639400cbfdbcc21552c90e23000a8e63d60f08bfa870037588e65659d url=/tableau/current/pt-br/server/maps_mapsources.md -->

[Pular para o conteúdo principal](#main-content)

# Selecionar mapas em segundo plano

O Tableau vem instalado com um conjunto de mapas de segundo plano que você pode acessar para criar exibições de mapas.

Por padrão, os mapas do Tableau aparecem com Luz em segundo plano fornecida pelos mapas Mapbox.

Os oito mapas em segundo plano instalados com o Tableau estão descritos nesta tabela.

| Mapa em segundo plano | Descrição |
| --- | --- |
| Claro | Um mapa sutil que enfatiza as marcas ao mesmo tempo em que fornece contexto geográfico. Todas as áreas sem dados aparecem em branco ou cinza claro. |
| Normal | Um mapa de uso geral semelhante ao de Luz. Áreas terrestres sem dados aparecem em branco ou cinza claro, e corpos d'água aparecem em azul claro. |
| Escuro | Um mapa sutil que enfatiza as marcas ao mesmo tempo em que fornece contexto geográfico. O inverso do mapa de luz; áreas sem dados aparecem em preto ou cinza escuro. |
| Rua | Um mapa de uso geral que inclui as principais redes rodoviárias e de trânsito. |
| Áreas externas | Um mapa de uso geral que inclui terrenos e características naturais, como corpos d'água e parques. |
| Satélite | Um mapa estilizado com imagens de satélite globais. |
| Off-line | Um mapa que você pode usar mesmo sem estar conectado à internet. Este mapa de segundo plano armazena as imagens que formam o mapa em um cache na máquina para melhor desempenho e acesso off-line. Para obter mais informações, consulte a seção de mapas off-line. |
| Nenhum | Uma visualização que exibe dados entre latitude e longitude em um tipo de visualização diferente de um mapa. |

## Altere o mapa em segundo plano:

No Tableau Selecione Mapa \> Mapas em segundo plano e em seguida, selecione o mapa em segundo plano que deseja usar.

## Alterar seu mapa em segundo plano padrão no Tableau Desktop (recurso obsoleto)

> [!WARNING]
> 
> **Observação:** alterar seu mapa em segundo plano é um recurso legado que funciona apenas com mapas WMS no Tableau Desktop. Não recomendamos usar esse recurso.

Você pode escolher definir seu mapa em segundo plano padrão como um Web Map Service (WMS) ou um mapa offline. Para saber mais sobre como usar um mapa WMS, consulte [Use servidores de Web Map Service (WMS)](https://help.tableau.com/current/pro/desktop/pt-br/maps_mapsources_wms.htm).

Para especificar um mapa em segundo plano padrão:

1. No Tableau Desktop, selecione Mapas > Mapas em segundo plano > Adicionar Mapa WMP... ou Offline.
2. Selecione Mapa > Mapa em segundo plano > Definir como padrão para definir o mapa em segundo plano selecionado como padrão.

O mapa em segundo plano é automaticamente salvo como uma Fonte de mapa do Tableau (.tms) Arquivo e colocado na pasta Mapsources do Meu

Repositório do Tableau. Ele, agora, é o mapa em segundo plano padrão para todas as novas planilhas.

## Usar o mapa em segundo plano offline

Você pode criar e inspecionar dados em uma visualização de mapa off-line usando o mapa em segundo plano off-line fornecido com o Tableau Desktop.

**Para usar o mapa em segundo plano offline:**

- No Tableau, selecione Mapa \> Mapas em segundo plano > Off-line

**Observação**: o mapa de fundo off-line usa imagens de mapas armazenadas na máquina. É possível encontrar as imagens nestes locais:

- No Windows: `C:\Program Files\Tableau\<Tableau Version>\Local\Maps`
- No Mac: `//Applications/<Tableau Version>.app/Contents/install/local/maps`

No entanto, há várias ações que exigem que o Tableau recupere uma imagem de mapa que não está armazenada. Se a nova imagem de mapa não será armazenada na máquina, não será possível carregar o mapa até que o mapa on-line fornecido com o Tableau seja reconectado.

Pode ser necessário se reconectar ao mapa on-line, caso deseje fazer um ou mais dos seguintes procedimentos:

- Ativar ou desativar camadas – se você decidir ativar uma camada que não está armazenada em cache, o Tableau precisará conectar-se para recuperar as informações necessárias.
- Ampliar/reduzir – ampliar ou reduzir um mapa exige imagens de mapa diferentes. Se as imagens no nível de zoom especificado não constarem no cache, o Tableau precisará recuperar os mapas atualizados.
- Fazer uma panorâmica – fazer uma panorâmica exige, por vezes, novas imagens de mapa. Se você estiver trabalhando offline e não tiver as imagens de mapa necessárias e as legendas armazenadas em cache, as novas imagens e legendas atualizada, não serão carregadas.

**Para reconectar-se ao mapa do Tableau:**

- No Tableau Desktop, selecione Mapa > Mapas em segundo plano > Tableau

Observação: se definir um mapa para off-line e, em seguida, publicar a pasta de trabalho, a pasta de trabalho publicada ainda usará os mapas off-line e armazenados, com todas as funcionalidades e limitações dos mapas off-line mencionadas anteriormente.

<!-- document id=f5b290efabc064ee0dafedc93b2df4a9363c3fef37564acf6e79a374ab12c073 url=/tableau/current/pt-br/server/ts_gcp_virtual_machine_selection.md -->

[Pular para o conteúdo principal](#main-content)

# Selecionar um tipo e tamanho da máquina virtual do Google Compute Engine

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

O Google Cloud Platform oferece muitos tipos de máquinas virtuais (VMs) do Google Compute Engine (GCE), em diversos tamanhos. Escolher a VM certa para sua carga de trabalho é um fator importante para uma implantação bem sucedida do Tableau Server. Você pode escolher de uma ampla variedade de VMs. Para obter uma lista completa de todos os tipos e tamanhos de VM disponíveis, consulte a página [Tipos de máquina](https://cloud.google.com/compute/docs/machine-types) no site do Google.

É importante selecionar uma VM que possa executar o Tableau Server. A VM deve atender às diretrizes de hardware (o mínimo de 8 núcleos e 128 GB de memória RAM).

No mínimo, um Tableau Server de 64 bits exige uma CPU de 4 núcleos (o equivalente a 8 vCPUs do Google Compute Engine) e 64 GB de memória RAM. No entanto, um total de 8 núcleos de CPU (16 vCPU do Google Compute Engine) e 128 GB de RAM é altamente recomendado para uma VM de produção única do Google Compute Engine.

O sistema operacional Windows reconhecerá esses 16 vCPU como 8 núcleos, portanto, não há impacto de licenciamento negativo.

## Tipos e tamanhos típicos de VM para ambientes de desenvolvimento, teste e produção

- n2-standard-16

## Especificações recomendadas para uma única instância de produção

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col><col class="TableStyle-Basic-Border-Column-Column1" style="width: 20%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 65%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"></colgroup><tbody><tr><th>Componente/recurso</th><th colspan="10">Google Cloud&nbsp;Platform</th></tr><tr><td><p>CPU</p></td><td colspan="10"><p>16+ vCPU</p></td></tr><tr><td><p>Sistema operacional</p></td><td colspan="10"> <div><table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">&nbsp;</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">2021.3.0 - 2023.3.0</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">2023.3.1 - 2026.2.x</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2016</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2019 (x64)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Windows Server 2022</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="text-align: center;"><strong>Observação:</strong>&nbsp;o Windows Server 2022 <em>não </em>é aceito em versões anteriores a 2023.3.1. A partir de abril de 2023, os instaladores de todas as versões do Tableau Server no Windows anteriores a 2023.3.1 bloquearão a instalação no Windows 2022.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr></tbody></table></div></td></tr><tr><td><p>Memória</p></td><td colspan="10"><p>Mais de 128 GB de RAM (4 GB de RAM por vCPU)</p></td></tr><tr><td><p>Armazenamento</p></td><td colspan="10"><p>Dois volumes:</p><p>Volume de 30 a 50 GiB para o sistema operacional</p><p>Volume de 100 GiB ou maior para o Tableau Server</p></td></tr><tr><td><p>Tipo de armazenamento</p></td><td colspan="10"><p>Disco SSD persistente, 200GB++</p><p>Para obter mais informações sobre discos SSD persistentes, consulte <a href="https://cloud.google.com/compute/docs/disks/">Opções de armazenamento</a> no site do Google Cloud Platform.</p></td></tr><tr><td><p>Latência do disco</p></td><td colspan="10"><p>Menor ou igual a 20ms, conforme medido pela <b>Média</b>.<b> </b>Contador de desempenho do <b>disco de transferência/s</b> no Windows.</p></td></tr></tbody></table>

<!-- document id=48cbff202577d97c946b6c8a4c015631c5374a0501b5baa0affb718fc735d0a5 url=/tableau/current/pt-br/server/ts_aws_virtual_machine_selection.md -->

[Pular para o conteúdo principal](#main-content)

# Selecionar um tipo e um tamanho de instância AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Escolher a instância certa para sua carga de trabalho é um fator importante para uma implantação bem sucedida do Tableau Server. Você pode escolher entre uma ampla variedade de tipos de instâncias do Amazon EC2. Para obter uma lista completa de todos os tipos e tamanhos de instâncias disponíveis, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/) no site da AWS.

No mínimo, um Tableau Server de 64 bits exige uma CPU de 4 núcleos (o equivalente a 8 vCPUs da AWS) e 64 GB de memória RAM. No entanto, um total de 8 núcleos de CPU (16 vCPU da AWS) e 128 GB de RAM é altamente recomendado para uma instância de produção única do Amazon EC2.

Uma vCPU da AWS é um hiper processamento único de um núcleo Intel Xeon de dois encadeamentos para instâncias M5, M4, C5, C4, R4 e R4. Uma forma simples de pensar sobre isso é que uma VCPU da AWS é igual à metade de um núcleo físico. Portanto, ao escolher um tamanho de instância do Amazon EC2, você deve duplicar o número de núcleos comprados ou que deseja implantar. Exemplo: você comprou uma licença de 8 núcleos para o Tableau Server (ou precisa oferecer suporte suficiente para usuários ativos, onde são necessários 8 núcleos). Você deve escolher um tipo de instância do Amazon EC2 com 16 vCPUs. Para mais informações sobre quantas vCPUs são iguais a um núcleo físico, consulte [Núcleos físicos por Amazon EC2 e Tipo de instância do BD RDS](https://aws.amazon.com/ec2/physicalcores/) no site do AWS.

O sistema operacional Windows reconhecerá esses 16 vCPU como 8 núcleos, portanto, não há impacto de licenciamento negativo.

## Tipos e tamanhos típicos de instâncias para ambientes de desenvolvimento, teste e produção

- C5.4xlarge (adequado apenas para ambientes de desenvolvimento)
- m5.4xlarge (adequado apenas para ambientes de desenvolvimento ou teste)
- r5.4xlarge (adequado para ambientes de desenvolvimento, teste ou produção)

**Observação:** a instalação do Tableau Server em instâncias Amazon EC2 T2 não é suportada.

Para obter uma comparação de desempenho de vários tipos de instância do Amazon EC2 que foram testados com o Tableau Server, consulte [Tableau na velocidade de EC2](https://www.tableau.com/pt-br/learn/whitepapers/tableau-speed-of-aws-ec2).

### Especificações recomendadas para uma única instância de produção

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col><col class="TableStyle-Basic-Border-Column-Column1" style="width: 20%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 65%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"></colgroup><tbody><tr><th>Componente/recurso</th><th colspan="10">Amazon Web Services</th></tr><tr><td><p>CPU</p></td><td colspan="10"><p>16+ vCPU</p></td></tr><tr><td><p>Sistema operacional</p></td><td colspan="10"> <div><table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">&nbsp;</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">2021.3.0 - 2023.3.0</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">2023.3.1 - 2026.2.x</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2016</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2019 (x64)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Windows Server 2022</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="text-align: center;"><strong>Observação:</strong>&nbsp;o Windows Server 2022 <em>não </em>é aceito em versões anteriores a 2023.3.1. A partir de abril de 2023, os instaladores de todas as versões do Tableau Server no Windows anteriores a 2023.3.1 bloquearão a instalação no Windows 2022.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr></tbody></table></div></td></tr><tr><td><p>Memória</p></td><td colspan="10"><p>Mais de 128 GB de RAM (4 GB de RAM por vCPU)</p></td></tr><tr><td><p>Armazenamento</p></td><td colspan="10"><p>Dois volumes:</p><p>Volume de 30 a 50 GiB para o sistema operacional</p><p>Volume de 100 GiB ou maior para o Tableau Server</p></td></tr><tr><td><p>Tipo de armazenamento</p></td><td colspan="10"><p>EBS recomendado (SSD (gp2) ou IOPS provisionado)</p></td></tr><tr><td><p>Latência do disco</p></td><td colspan="10"><p>Menor ou igual a 20ms, conforme medido pela <b>Média</b>.<b> </b>Contador de desempenho do <b>disco de transferência/s</b> no Windows.</p></td></tr></tbody></table>

<!-- document id=588ffde4a21ebb119f47a052fc9fd164a0901723a37d0324dce0dd0d2b0b4d2b url=/tableau/current/pt-br/server/ts_alibaba_virtual_machine_selection.md -->

[Pular para o conteúdo principal](#main-content)

# Selecionar um tipo e um tamanho de instância do ECS da Alibaba

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

A nuvem Alibaba oferece muitos tipos de instâncias em vários tamanhos. Escolher a instância certa para sua carga de trabalho é um fator importante para uma implantação bem sucedida do Tableau Server. Você pode escolher de uma ampla variedade de instâncias. Para obter uma lista completa de todos os tipos e tamanhos de instâncias disponíveis, consulte [famílias de tipos de instância](https://www.alibabacloud.com/help/doc-detail/25378.htm) no site da Alibaba.

É importante selecionar uma instância que possa executar o Tableau Server. A instância deve atender às diretrizes de hardware (o mínimo de 8 núcleos e 128 GB de memória RAM).

No mínimo, um Tableau Server de 64 bits exige uma CPU de 2 núcleos (o equivalente a 4 vCPUs em uma instância de Elastic Compute Service (ECS) da Alibaba Cloud) e 64 GB de memória RAM. No entanto, um total de 8 núcleos de CPU (16 vCPUs da instância de ECS) e 128 GB de RAM são extremamente recomendados para uma única instância de ECS de produção.

O sistema operacional Windows reconhecerá esses 16 vCPUs como 8 núcleos, portanto, não há impacto negativo no licenciamento.

## Tipos e tamanhos típicos de instâncias para ambientes de desenvolvimento, teste e produção

- ecs.c5.4xlarge
- ecs.g5.4xlarge
- ecs.r5.4xlarge

**Observação:** alguns tipos de instância podem não estar disponíveis em todas as regiões.

## Especificações recomendadas para uma única instância de produção

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col><col class="TableStyle-Basic-Border-Column-Column1" style="width: 20%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 65%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"></colgroup><tbody><tr><th>Componente/recurso</th><th colspan="10">Alibaba Cloud</th></tr><tr><td><p>CPU</p></td><td colspan="10"><p>16+ vCPU</p></td></tr><tr><td><p>Sistema operacional</p></td><td colspan="10"> <div><table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">&nbsp;</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">2021.3.0 - 2023.3.0</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">2023.3.1 - 2026.2.x</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2016</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Windows Server 2019 (x64)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Windows Server 2022</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="text-align: center;"><strong>Observação:</strong>&nbsp;o Windows Server 2022 <em>não </em>é aceito em versões anteriores a 2023.3.1. A partir de abril de 2023, os instaladores de todas as versões do Tableau Server no Windows anteriores a 2023.3.1 bloquearão a instalação no Windows 2022.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt=""></td></tr></tbody></table></div></td></tr><tr><td><p>Memória</p></td><td colspan="10"><p>Mais de 128 GB de RAM (4 GB de RAM por vCPU)</p></td></tr><tr><td><p>Armazenamento</p></td><td colspan="10"><p>Dois volumes:</p><p>Volume de 30 a 50 GiB para o sistema operacional</p><p>Volume de 100 GiB ou maior para o Tableau Server</p></td></tr><tr><td><p>Tipo de armazenamento</p></td><td colspan="10"><p>Disco em nuvem SSD</p><p>Para obter mais informações sobre discos em nuvem SSD, consulte <a href="https://www.alibabacloud.com/help/doc-detail/25383.htm" target="_blank">Discos em nuvem e armazenamento em bloco compartilhado</a> no site da Alibaba.</p></td></tr><tr><td><p>Latência do disco</p></td><td colspan="10"><p>Menor ou igual a 20ms, conforme medido pela <b>Média</b>.<b> </b>Contador de desempenho do <b>disco de transferência/s</b> no Windows.</p><p>Para obter mais informações sobre latência de disco na Alibaba Cloud e seu relacionamento com IOPS, consulte <a href="https://www.alibabacloud.com/help/doc-detail/25382.htm" target="_blank">Parâmetros de armazenamento e teste de desempenho</a> no site da Alibaba.</p></td></tr></tbody></table>

<!-- document id=506045edb289bf4cf0d591d141baaa3f368d42d69c0f3c8abfa7a862e71f7e25 url=/tableau/current/pt-br/server/server_process_cfs.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço de arquivo do cliente do Tableau Server

O Serviço de arquivo do cliente (CFS) armazena e distribui os arquivos necessários para o TSM (por exemplo, certificados, arquivos de personalização etc.). Os arquivos gerenciados pelo Serviço de arquivos do cliente são renomeados e ofuscados antes de serem distribuídos pela implantação. Esse processo também parametriza os atributos de arquivo exigidos pelos serviços do Tableau. Como resultado, os arquivos não são mapeados para um único local de arquivo no sistema de arquivos. Certifique-se de ter um backup off-box de todos os arquivos gerenciados pelo

Os seguintes arquivos são gerenciados por CFS:

- Arquivo de certificado SAML
- Arquivo-chave SAML
- Arquivo de metadados IdP SAML
- OpenID.static.file
- Arquivo Kerberos.keytab
- Arquivo keytab do Kerberos LDAP
- Arquivo de conf. Kerberos LDAP
- Arquivo de certificado SSL mútuo
- Arquivo de revogação SSL mútuo
- Arquivo de logotipo do cabeçalho de personalização
- Arquivo de logotipo de logon de personalização
- Arquivo de logotipo compacto de personalização

Os seguintes arquivos não são gerenciados ou distribuídos por CFS:

- Arquivos SSL externo. Os arquivos de certificado e chave para SSL externo são armazenados e gerenciados pelo Serviço de coordenação. Você não precisa distribuir manualmente esses arquivos.
- Arquivos SSL para armazenamento de identidade externo. Você deve distribuir manualmente o arquivo de certificado SSL para cada nó no cluster. Consulte [Configurar canal criptografado no armazenamento de identidade externo LDAP](https://help.tableau.com/current/server/pt-br/config_encrypt_ldap.htm).

O Serviço de arquivo do cliente funciona de maneira muito semelhante ao Armazenamento de arquivos para os arquivos necessários aos serviços de negócios. Por padrão, o CFS é instalado somente no nó inicial da instalação do Tableau Server. Para configurar o CFS para alta disponibilidade, recomendamos a configuração de uma instância do CFS em cada um dos nós em que o Serviço de coordenação for implantado.

Em um cluster, se um nó que está executando sua única instância do CFS falhar, todos os arquivos gerenciados pelo CFS serão perdidos e você precisará preencher novamente esses arquivos do CFS, reimportando certificados e imagens personalizadas e fazendo quaisquer alterações de configuração relacionadas.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Client File Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Client File Service não está visível na página Status. Use a CLI do TSM para exibir o status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Client File Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>clientfileservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha em um processo do CFS? Nada, desde que ainda haja pelo menos um processo do CFS funcionando no cluster. O controlador redirecionará as solicitações de transferência de arquivos para o outro processo do CFS em funcionamento.

Os processos do Serviço de arquivo do cliente com falha são reiniciados automaticamente, desde que o computador não tenha problemas.

<!-- document id=412593dc230cc8336e9c4cb70fbd41bc40d5dde66d6a7996b59cb4a2c3e1845e url=/tableau/current/pt-br/server/server_process_collections-service.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço de Coleções do Tableau Server

O serviço de Coleções do Tableau Server foi adicionado ao Tableau Server versão 2021.2. O serviço de Coleções capacita o recurso de coleções. Ele fornece informações sobre coleções e se conecta ao serviço de Exploração de conteúdo para obter metadados sobre coleções e itens dentro de coleções. O serviço de Coleções também oferece suporte ao recurso Favoritos.

## Configuração do servidor

O serviço de Coleções é automaticamente instalado no primeiro nó onde o Servidor de Aplicativos (vizportal) está instalado.

### Configuração em vários nós

Para alta disponibilidade e melhor desempenho, recomendamos que você instale uma instância do Serviço de exploração de Coleções em cada nó que está executando o Servidor de Aplicativos (vizportal).

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Collections Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do  Collections Service fica visível na Página de status e na linha de comando, usando o comando <code> tsm status -v</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Collections Service  são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>collections</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Impacto se o Serviço de Coleções não estiver funcionando corretamente

Se o Serviço de Coleções parar, ele deve reiniciar automaticamente, desde que o computador não tenha problemas.

### Uma instância do Serviço de Coleções

Se você tiver uma única instância do Serviço de Coleções configurada e ela falhar, as coleções e os favoritos não estarão disponíveis.

### Várias instâncias do serviço de Coleções

Se você tiver uma instalação de vários nós do Tableau Server, com instâncias de configuração do serviço de Coleções em vários nós, quando uma instância falhar, as coleções e favoritos podem não estar disponíveis para alguns usuários.

## Arquivos de registro

O Serviço de Coleções cria dois conjuntos de arquivos de registro:

- `control_collections*.log`: esses registros conterão informações sobre a inicialização e ativação do serviço.
- `collections_*.log`: os erros ou problemas são registrados aqui.

Para obter mais informações, consulte [Locais de arquivo de registro e registros do Tableau Server](https://help.tableau.com/current/server/pt-br/logs_loc.htm).

<!-- document id=884c9a8c5c9700852e7306110515d1879a75e673fcf248dc84852a96eedfe131 url=/tableau/current/pt-br/server/server_process_coordination.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço de coordenação do Tableau Server

O Serviço de coordenação é criado no [Apache ZooKeeper](https://cwiki.apache.org/confluence/display/ZOOKEEPER/Index), um projeto de código-fonte aberto, e coordena atividades no servidor, garantindo quorum no caso de falha e servindo como a fonte do "truth" relacionada à topologia, a configuração e o estado do servidor. O serviço é instalado automaticamente no nó inicial do Tableau Server, mas nenhuma instância adicional é instalada ao adicionar outros nós. Como o funcionamento bem-sucedido do Tableau Server depende que o Serviço de coordenação funcione adequadamente, recomendamos que, para instalações de servidor de três ou mais nós, você adicione instâncias adicionais do Serviço de coordenação ao implantar um novo ensemble do Serviço de coordenação. Isso oferece redundância e disponibilidade aprimorada caso essa instância apresente problemas.

O hardware do seu cluster pode afetar o modo de execução do Serviço de coordenação. Em particular:

- Memória. O Serviço de coordenação mantém as informações de estado na memória. Originalmente, o consumo da memória é pequeno, não sendo um fator no desempenho geral do servidor.
- Velocidade do disco. Devido ao armazenamento de informações de estado no disco, o serviço aproveita a velocidade rápida do disco nos computadores de nó individual.
- Velocidade de conexão entre os nós. O serviço comunica-se continuamente entre nós de cluster; uma velocidade rápida de conexão entre os nós fornece uma sincronização mais eficiente.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Coordination Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Coordination Service não está visível na página Status. Use a CLI do TSM para exibir o status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Coordination Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>appzookeeper</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Configuração do Serviço de coordenação

O Serviço de coordenação é instalado automaticamente no nó inicial do Tableau Server. Se estiver em execução em uma instalação de um nó, não é necessário fazer nada para implantar ou configurar o Serviço de coordenação. Caso sua instalação inclua três ou mais nós, será solicitado que configure um ensemble do Serviço de coordenação ao adicionar o terceiro nó. Isso não é obrigatório, mas é altamente recomendado, pois o Serviço de coordenação representa uma função principal para alta disponibilidade, agindo como uma fonte de “verdade’ sobre a topologia, a configuração e o estado do servidor.

Para configurar um ensemble do Serviço de coordenação, use o TSM CLI e adicione o Serviço de coordenação em todos os nós em que deseja executá-lo. Para obter mais detalhes sobre como implantar um ensemble do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

## O quórum do Serviço de coordenação

Para garantir que o Serviço de coordenação funcione adequadamente, o serviço requer um _quorum_, um número mínimo de instâncias do serviço. Isso significa que o número de nós em sua instalação afeta a quantidade de instâncias do Serviço de coordenação que precisarão ser configuradas em seu ensemble.

#### Número de instâncias do Serviço de coordenação a serem usadas

O número máximo de instâncias do Serviço de coordenação permitidas em um ensemble no Tableau Server depende de quantos nós do Tableau Server existem em sua implantação. Configurar um ensemble do Serviço de coordenação com base nestas diretrizes:

| Número total de nós do servidor | Número recomendado de nós do Serviço de Coordenação no ensemble (deve ser 1, 3 ou 5) | Observações |
| --- | --- | --- |
| 1 a 2 nós | 1 nó | Esse é o padrão e não requer alterações, a não ser que deseje mover o Serviço de coordenação do nó inicial para um nó adicional. |
| 3 a 4 nós | 3 nós | Um conjunto de Serviço de coordenação de 3 nós permite que um dos nós do conjunto falhe sem causar a falha do Tableau Server. |
| 5 ou mais nós | 3 nós  
ou 5 nós | O número máximo de instâncias do Serviço de coordenação que você pode instalar é cinco. Um conjunto de Serviço de coordenação de 3 nós permite que um dos nós do conjunto falhe sem causar a falha do Tableau Server. Um conjunto de 5 nós permite que dois nós do conjunto falhe sem causar a falha do Tableau Server.  
  
Para a maioria das instalações, três nós do Serviço de Coordenação são adequados, e devido à natureza de E/S intensa do Serviço de coordenação, essa é a configuração mais performática.  
  
Se a alta disponibilidade for sua prioridade absoluta, você pode querer considerar a implantação de um conjunto de Serviço de coordenação de 5 nós. Isso fornece a maior redundância no caso de um ou mais nós falharem, mas exigirá mais recursos do sistema. Um máximo de dois nós do conjunto pode falhar sem afetar o Tableau Server (desde que outros serviços no nó também existam em nós ainda em funcionamento).  
  
Para reduzir o impacto no desempenho, localize o Serviço de Coordenação em nós que estão executando menos os outros serviços ou considere usar nós somente de Serviço de Coordenação. Para obter detalhes, consulte [Configurar o Tableau Server para alta disponibilidade com nós exclusivos do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_external_zk.htm). |

### Se você reduzir a quantidade de nós

Se você reduzir os nós do seu cluster de três (ou mais) para dois, um aviso lhe informará que o Tableau Server não pode mais suportar alta disponibilidade:

A minimum of three Tableau Server nodes are required for high availability. You can add a third node now, 
or continue with only two nodes. Continuing with only two nodes means Tableau Server will not be highly available. 
You can always add a third node later. Click OK to continue with 2 nodes, or Cancel to go back and add a node.

Se você continuar, o Tableau Server será executado, mas não haverá failover automático do repositório.

## Visualização do status do Serviço de coordenação

O Serviço de coordenação não é incluído na listagem ao [Exibir o status de processos do servidor](https://help.tableau.com/current/server/pt-br/service_viewstatus.htm). Para ver o estado do serviço, use o comando [tsm status](https://help.tableau.com/current/server/pt-br/cli_status_tsm.htm):

`tsm status -v`

O resultado do comando mostra-lhe se o serviço está ou não sendo executado:

node1: TABLEAUSVR01
Status: RUNNING
'Tableau Server Gateway 0' is running.
'Tableau Server Application Server 0' is running.
'Tableau Server VizQL Server 0' is running.
'Tableau Server VizQL Server 1' is running.
'Tableau Server VizQL Server 2' is running.
'Tableau Server VizQL Server 3' is running.
'Tableau Server Cache Server 0' is running.
'Tableau Server Cache Server 1' is running.
'Tableau Server Coordination Service 0' is running.
'Tableau Server Cluster Controller 0' is running.
'Tableau Server Search And Browse 0' is running.
'Tableau Server Backgrounder 0' is running.
'Tableau Server Backgrounder 1' is running.
'Tableau Server Data Server 0' is running.
'Tableau Server Data Server 1' is running.
'Tableau Server Data Engine 0' is running.
'Tableau Server File Store 0' is running.
'Tableau Server Repository 0' is running (Active Repository).
'Tableau Server Administration Agent 0' is running.
'Tableau Server Administration Controller 0' is running.
'Tableau Server Service Manager 0' is running.
'Tableau Server License Manager 0' is running.
'Tableau Server Client File Service 0' is running.
'Tableau Server Database Maintenance 0' is stopped.
'Tableau Server Backup/Restore 0' is stopped.
'Tableau Server Site Import/Export 0' is stopped.
'Tableau Server SAML Service 0' is stopped.

<!-- document id=1a193800b6b14619ea51d826285654041d9c0098b7208b870e3a102f48be5998 url=/tableau/current/pt-br/server/server_process_content-exploration.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço de exploração do conteúdo do Tableau Server

O Serviço de Exploração de Conteúdo do Tableau Server amplia os recursos do processo de Pesquisa e Procura e é responsável pela indexação de todo o conteúdo no Tableau Server. Esse serviço está disponível no Tableau Server 2021.1, e versões posteriores, e necessário para pesquisar e navegar em ativos externos, como bancos de dados e tabelas. Bancos de dados e tabelas só estão disponíveis se você tiver o [Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm)ativado.

O serviço de exploração de conteúdo é aplicável à pesquisa rápida e filtrada. Ele não é baseado em SOLR, mas depende de Elastic Search para executar suas funções.

## Configuração do servidor

O Serviço de exploração do conteúdo é instalado automaticamente no nó inicial.

### Configuração em vários nós

Para alta disponibilidade e melhor desempenho, recomendamos que você instale pelo menos uma instância do Serviço de exploração de conteúdo em cada nó que está executando o Servidor de Aplicativos.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Content Exploration Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do  Content Exploration Service é visível na Página de status e pode ser acessado usando a CLI TSM para visualizar. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Registros gerados por  Content Exploration Service  são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>contentexploration</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

**O que acontece quando o Serviço de exploração de conteúdo falha?**

Se o Serviço de exploração de conteúdo parar de funcionar, qualquer solicitação de pesquisa para o tipo de conteúdo que ele fornece não apareceria nos resultados da pesquisa. Se várias instâncias do serviço forem instaladas, as solicitações subsequentes serão roteadas para uma instância íntegra.

Um serviço de Exploração de conteúdo é reiniciado automaticamente; desde que o computador não tenha problemas, o processo do Servidor cache será reiniciado.

## Ajuste de desempenho

O Serviço de exploração de conteúdo tem a capacidade de escalar conforme necessário, mas com base na memória disponível no nó. No entanto, há uma alocação de memória definida por padrão, que determina a quantidade máxima de memória que pode ser usada pelo serviço. Embora não seja normalmente recomendado que você altere essa configuração se estiver vendo problemas de desempenho devido à alocação de memória insuficiente, poderá executar os seguintes comandos para alterar a configuração máxima de alocação de memória.

Primeiro, recupere a alocação máxima de memória atual executando o seguinte comando:

`tsm configuration get -k contentexploration.vmopts`

Execute o seguinte comando set para alterar a alocação máxima de memória atualizando o valor -Xmx e aplicando as alterações pendentes. Não altere outra opção:

tsm configuration set -k contentexploration.vmopts -v "-Xmx**<new value>**m -XX:+ExitOnOutOfMemoryError -Dspring.profiles.active=monolith"

Por exemplo:

tsm configuration set -k contentexploration.vmopts -v "-Xmx**1024**m -XX:+ExitOnOutOfMemoryError -Dspring.profiles.active=monolith"

`tsm pending-changes apply`

## Arquivos de registro

O Serviço de exploração de conteúdo cria dois conjuntos de arquivos de registro:

- `control_contentexploration*.log`: esses registros conterão informações sobre a inicialização e ativação do serviço.
- `contentexploration_*.log`: os erros ou problemas são registrados aqui.

Para obter mais informações, consulte [Locais de arquivo de registro e registros do Tableau Server](https://help.tableau.com/current/server/pt-br/logs_loc.htm).

## Precisão da pesquisa

Existem algumas maneiras de o Serviço de exploração de conteúdo ser usado para garantir que o conteúdo pesquisável fique atualizado:

- Sempre que o conteúdo gerenciado pelo Tableau Server ou pelo Tableau Cloud é modificado, incluindo permissões, o serviço de exploração de conteúdo reindexa os documentos relevantes para manter os índices de pesquisa atualizados.
- Uma tarefa de processador em segundo plano gerada pelo sistema que valida periodicamente se todo o conteúdo está sincronizado corretamente e reindexa quaisquer discrepâncias encontradas.

## Reindexação

Durante a restauração, o processo de restauração iniciará uma reindexação completa do conteúdo e dos ativos externos gerenciados pelo Tableau Server. O processo de reindexação consome recursos de CPU que podem ser perceptíveis durante o backup e restauração.

<!-- document id=adfa7996e70b65f6cabf09e47cc79b20928dddc25329c8efa27aeb4aa6ba44ef url=/tableau/current/pt-br/server/rmt-external-messagequeue.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço de fila de mensagens externo (RabbitMQ) para Resource Monitoring Tool do Tableau

O Resource Monitoring Tool do Tableau usa RabbitMQ como serviço de fila de mensagens para coletar dados de Agentes e trazê-los para o Servidor RMT. Essas informações na fila são processadas e eventualmente armazenadas no repositório RMT (banco de dados PostgreSQL).

Antes da versão 2022.3, o serviço de fila de mensagens RabbitMQ era instalado automaticamente com o servidor RMT e esta era a única configuração disponível. A partir do RMT versão 2022.3, você pode reconfigurar o RMT Server para usar um serviço RabbitMQ hospedado externamente. Quando o Servidor RMT é configurado para usar um serviço de fila de mensagens hospedado externamente, nos referimos a ele como o serviço de fila de mensagens externo.

Com esta nova opção adicionada na versão 2022.3, o RMT Server pode ser configurado das seguintes formas:

- **Continue a usar o serviço de fila de mensagens instalado localmente:** Isso significa que o RabbitMQ que é instalado automaticamente com o RMT Server na mesma máquina será usado como oo serviço de mensagens para o RMT Server, e nenhuma alteração adicional será feita nesta configuração.
- **Configure o RMT Server para usar um serviço de fila de mensagens externo:** isso significa que o RAbbitMQ que o RMT usa está hospedado fora do RMT Server. Atualmente, apenas o AWS AMQ é compatível como plataforma de hospedagem para RabbitMQ. Como todas as mensagens dos Agentes passam pelo RabbitMQ, hospedar isso externamente libera recursos da máquina onde o RMT Server está instalado.

Para configurar e gerenciar o serviço de fila de mensagens externo, você deve ter um bom conhecimento da plataforma AWS AMQ. Recomendamos revisar a [documentação no site da AWS](https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/welcome.html). Você também precisará saber como configurar e gerenciar o serviço de fila de mensagens externas para RMT. Este tópico fornecerá essas informações nas seções abaixo.

## Nova instalação do Resource Monitoring Tool

As instruções fornecidas nesta seção se aplicam a uma nova instalação do Resource Monitoring Tool. Se você tem uma instalação existente e deseja mover seu RabbitMQ local para uma configuração hospedada externamente, consulte a seção [Instalações existentes do Resource Monitoring Tool do Tableau](#Existing) deste tópico.

Use as etapas a seguir para instalar a Tableau Resource Monitoring Tool e reconfigurar o RMT Server para usar um serviço de fila de mensagens externo:

1. **Crie o Amazon AMQ para Rabbit MQ** para hospedar o serviço de fila de mensagens externo com as seguintes recomendações:
    
    - Para o tipo de mecanismo, use o mecanismo RabbitMQ. Para a versão do Rabbit MQ, consulte a seção de compatibilidade do produto.
    - Use a mesma versão padrão usada quando o RabbitMQ for instalado localmente. Para obter mais informações, consulte a tabela de compatibilidade do produto.
    - Use um agente de instância única.
    - Especificação da instância: mq.m5.large, 2 vCPU/8 GiB de RAM.
    - Crie um nome de usuário/senha do RabbitMQ.
    
    Para saber mais, consulte [Trabalhar com o Amazon MQ para Rabbit MQ](https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/working-with-rabbitmq.html) no site de documentação da AWS.
2. **Teste a conexão do RMT Server** com o agente de mensagens copiando o URL do console da Web do RabbitMQ da página do AWS MQ e cole-o em um navegador da Web no RMT Server. Faça login com o nome de usuário e a senha que você criou ao configurar o corretor.
3. Siga as instruções neste tópico para **instalar o RMT Server**, mas **ignore as etapas para criar um ambiente. Você fará isso depois de configurar o RMT Server para usar o repositório externo** .
4. Execute a configuração do rmtadmin da seguinte forma para configurar o serviço de fila de mensagens externo do Rabbit MQ:
    
    `rmtadmin master-setup --mq-config=external --mq-server=aws_amq_servername --mq-vhost='/' --mq-port=5671 --mq-username=aws_amq_username --mq-password='aws_amq_password' --mq-tls-certificate-host=aws_amq_servername`
5. Agora crie um ambiente e baixe o arquivo bootstrap.
    
    - Execute o seguinte comando para criar um ambiente: `rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>`
    - Faça download do arquivo de bootstrap para registrar os Agentes: `rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>`
        
        As etapas são descritas detalhadamente no tópico [Instalar o RMT Server usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-master-install-cli.htm).
6. Registre novamente os agentes nos nós do Tableau Server usando as instruções no tópico [Instalar o Agente usando a linha de comando](https://help.tableau.com/current/server/pt-br/rmt-admin-agent-install-cli.htm) .

## Instalações existentes do Resource Monitoring Tool do Tableau

Há dois caminhos para migrar instalações RMT existentes que estão usando atualmente um serviço de fila de mensagens local para um serviço de fila de mensagens externo:

- **Migração com recriação de ambiente:** isso envolve a criação do serviço Rabbit MQ externo, a configuração do RMT Server para usar o serviço de fila de mensagens externo, a recriação dos ambientes e a refazer todas as configurações personalizadas, como limites de incidentes, e o registro dos Agentes novamente.
    
    Ao usar esse método, qualquer coisa proveniente do Agente, métricas de hardware, registros de TS, carregamentos de visualização, hiperconsultas na fila, mas ainda não processadas, serão perdidas durante a migração. Isso é muito semelhante a fazer uma nova instalação do RMT descrita [na seção acima,](#New) exceto que você não instalará o RMT neste caso.
- **Migração manual com perda mínima de dados:** isso é especificamente para clientes que podem implementar as instruções de forma independente e não desejam lidar com a recriação de ambientes e de limites de incidentes. Esse método evitará que os dados do evento sejam perdidos durante a transição, mas as informações do contador de processo capturadas do hardware do nó do Tableau Server durante a transição não serão preservadas. Esta migração é manual e não um recurso de migração integrado para Resource Monitoring Tool.
    
    As instruções para fazer isso estão descritas abaixo:

### Migração para AWS AMQ externo

#### Etapa 1: crie o Amazon AMQ para Rabbit MQ para hospedar o serviço de fila de mensagens externo com as seguintes recomendações.

- Use o tipo de mecanismo RabbitMQ.
- A versão padrão (3.9.13) é igual à versão em pacote RMT 22.2.
- Use o agente de instância única.
- Use o tamanho de instância padrão (mq.m5.large, 2 vCPU/8 GiB RAM).
- Defina o nome de usuário/senha do RabbitMQ.

Para saber mais, consulte [Trabalhar com o Amazon MQ para Rabbit MQ](https://docs.aws.amazon.com/amazon-mq/latest/developer-guide/working-with-rabbitmq.html) no site de documentação da AWS.

#### Etapa 2: teste a conexão do servidor RMT

Copie a URL do console da Web do RabbitMQ da página do AWS MQ e cole-o em um navegador da Web no RMT Server. Faça login com o nome de usuário e a senha que você criou ao configurar o corretor.

Etapa 3: interrompa os serviços do Agente RMT e cancele o registro dos Agentes

Execute os seguintes comandos em cada nó em que o Agente está em execução: Não pare o RMT Server, ele deve ser mantido em execução:

`rmtadmin stop`

`rmtadmin deregister`

#### Etapa 4: verifique a fila

No servidor RMT, execute o `rmtadmin status` e revise a saída. Quando todos os valores na coluna Total para cada uma das filas atingirem 0 (ou quase 0) e permanecerem nesse valor, prossiga para a próxima etapa.

#### Etapa 5: configure o RMT Server para usar o novo serviço Amazon MQ

O valor aws\_amq\_servername será o mesmo que o endpoint listado na página do Amazon MQ, exceto que o prefixo do protocolo e a porta no final devem ser removidos. Veja o exemplo a seguir:

**Substitua:** “`amqps://b-9512e888-a4a3-4b79-a9c0-07418c101941.mq.us-west-2.amazonaws.com:5671` " com: "`B-9512e888-a4a3-4b79-a9c0-07418c101941.mq.us-west-2.amazonaws.com` ”

Agora, execute `rmtadmin master-setup` , substituindo o nome de usuário e a senha que você criou para o Amazon MQ.

`rmtadmin master-setup --mq-config=external --mq-server=aws_amq_servername --mq-vhost='/' --mq-port=5671 --mq-username=aws_amq_username --mq-password=<aws_amq_password> --mq-tls-certificate-host=<aws_amq_servername>`

Observe o seguinte:

- Substitua o nome no argumento --mq-vhost abaixo apenas se você criou seu próprio host virtual (isso é opcional), .
- Da mesma forma, altere a porta se o serviço estiver configurado para ser executado em uma porta não padrão.
- O valor para --mq-tls-certificate-host deve ser o nome do servidor para sua instância do AWS MQ, conforme usado anteriormente no argumento --mq-server, embora possa ser um curinga para flexibilidade adicional.

#### Etapa 6: inicie o RMT Server.

Navegue até a pasta de instalação do RMT Server: `cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'`

Navegue até a pasta de instalação do RMT Server: `sudo /var/opt/tableau/tabrmt/master`

Inicie o Tableau Server: `rmtadmin start`

#### Etapa 7: registre novamente os agentes

- Baixe um novo arquivo de bootstrap do RMT Server.
- Acessando a interface da Web do Agente ao navegar até http://localhost:9002/setup/register, importe o arquivo bootstrap.
- Clique em Testar fila de mensagens. Revise as entradas anteriores se você receber um erro.
- Clique em Conectar-se à fila de mensagens
- Na seção Servidor, clique no menu suspenso com “Novo servidor de ambiente” pré-selecionado e, em vez de aceitar o padrão, escolha o servidor que você está tentando registrar na lista. Role a página até a parte inferior e clique no botão "Registrar agente"

#### Etapa 8: verifique se o RMT Server está em execução

Faça login na ferramenta de interface da Web do RMT Server e verifique se os novos dados estão sendo processados.

## Práticas recomendadas de atualização

Aqui estão as etapas gerais que você precisa seguir se quiser atualizar para uma versão 2022.3 ou posterior e migrar para usar um serviço de fila de mensagens externo ao mesmo tempo.

**Migração com recriação do ambiente:**

1. Atualize o RMT Server e todos os agentes para 2022.3 ou posterior
2. Crie um serviço de agente do Amazon AMQ.
3. Configure o RMT Server para usar o serviço de fila de mensagens externo
4. Recriar ambientes e registre novamente todos os Agentes
5. Recrie quaisquer configurações personalizadas.

**Observação:** você perderá alguns dados de processamento de eventos e hardware e também precisará reconfigurar os limites de incidentes

**Migração manual com perda mínima de dados:**

- Atualize o RMT Server e todos os agentes para a versão 2022.3 ou posterior
- Siga as etapas detalhadas na [](#Migratin2)[seção de migração](#Migratin) deste tópico. Isso envolve principalmente a criação de um serviço de agente do Amazon AMQ, um RMT Server que aponta para o serviço de fila de mensagens externo.
- Registrar novamente os agentes.

### Etapas de atualização com a ativação de TLS para RabbitMQ

Como os agentes em versões anteriores a 2022.3 têm se comunicado usando conexão não criptografada com o serviço de fila de mensagens RabbitMQ, ao atualizar para a versão 2022.3 ou posterior, esses agentes precisam ser atualizados para usar os novos detalhes de conexão segura. As etapas para fazer isso são as seguintes:

1. Depois de concluir as etapas de atualização descritas na seção acima, interrompa todos os agentes executando o seguinte comando:
    
    `rmtadmin stop --agent`
2. Baixe o arquivo bootstrap para o ambiente executando o seguinte comando:
    
    `rmtadmin bootstrap-file --env<myenvironment> --filename <The absolute or relative path including the file name>`
3. Execute o seguinte comando em cada uma das máquinas onde o Agent está instalado:
    
    `rmtadmin rotate-mq-certificate <BOOTSTRAP_FILE> --username=<RMT Server Username> --password-file=<RMT Server Password file name>`
4. Reinicie cada máquina do Agent após executar com sucesso o comando `rmtadmin rotate-mq-certificate`.

## Compatibilidade entre produtos

Esta tabela lista apenas a versão RMT 2022.3 e posterior, pois a fila de mensagens externa só está disponível a partir da versão 2022.3 e posterior.

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td>Versão do RMT</td><td>Versão RabbitMQ enviada com RMT</td><td>Versão de suporte de RabbitMQ para serviço de fila de mensagens externa</td></tr><tr><td>22.3</td><td>3.10.5</td><td>3.10.5</td></tr></tbody></table>

## Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

- Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
- Função de site Administrador no Tableau Server.
- Resource Monitoring Tool Conta de administrador.

<!-- document id=9067f4213f3dc27a270e0769c6b2ddf96cbf69d5557b46063af25872e8f94660 url=/tableau/current/pt-br/server/server_process_messaging_service.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço de mensagens do Tableau Server

A partir da versão 2019.4, o serviço de mensagens do Tableau Server usa o Apache ActiveMQ. Ele é uma plataforma de publicação/assinatura que permite uma comunicação orientada para mensagens segura, escalável, de bom desempenho e altamente disponível para microsserviços. O Serviço de mensagens é usado para oferecer suporte à comunicação entre microsserviços no Tableau Server.

O servidor executa uma única instância do Serviço de mensagens por padrão. Na versão 2020.1 e posterior, se você tiver uma instância de vários nós do Tableau Server, poderá configurar uma segunda instância do serviço de mensagens.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Serviço de mensagens</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do Serviço de mensagens fica visível na Página de status e na linha de comando, usando o comando <code>tsm status -v</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do gateway são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>activemqserver</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Impacto se o Serviço de mensagens não estiver funcionando corretamente

Se o Serviço de mensagens parar ou falhar ao iniciar dependerá se você tem uma ou duas instâncias do Serviço de mensagens configuradas.

### Várias instâncias do Serviço de mensagens (vários nós, versão 2020.1 e posterior)

Você pode configurar duas instâncias do Serviço de mensagens configuradas se tiver a versão 2020.1 ou posterior _e,_ se tiver uma instalação de vários nós do Tableau Server. Nesse caso, se uma instância falhar, a outra instância tratará de todo o tráfego e você poderá remover e reinstalar a instância com falha.

### Um exemplo do Serviço de mensagens

Se você tiver uma instalação de nó único do Tableau Server, estará limitado a uma única instância do Serviço de mensagens. Nesse caso, se a instância configurada falhar, o Tableau Server continuará funcionando, mas o status será exibido como “Degradado” e qualquer mensagem de evento enviada ao serviço de mensagens enquanto ele estava inativo poderá ser perdida, mesmo que o serviço reinicia. As mensagens de eventos incluem alterações de permissão em projetos.

Se o Serviço de mensagem parar, ele deve reiniciar automaticamente, desde que o computador não tenha problemas.

## Serviço de mensagens em um cluster de vários nós

A configuração do Serviço de mensagens em um cluster de vários nós dependerá da versão do Tableau Server que estiver em execução. Em todos os casos, você deverá executar uma instância do Serviço de mensagens.

A partir da versão 2020.1, você pode executar duas instâncias do serviço em um ambiente de vários nós. É recomendável executar duas instâncias, pois isso oferece redundância. Você pode adicionar uma segunda instância a qualquer nó que ainda não tenha o Serviço de mensagens configurado. Você não pode adicionar mais do que um total combinado de duas instâncias no cluster de vários nós.

<!-- document id=d68ea33d247540205e49d2a0855c5ffdd0e8de7dc7692420f6597dd526afad7b url=/tableau/current/pt-br/server/server_process_metrics.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço Métricas do Tableau Server

**Descontinuação do recurso de métricas herdado**

O recurso de métricas herdado do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2. Em outubro de 2023, o Tableau descontinuou a habilidade de inserir métricas herdadas no Tableau Cloud e no Tableau Server versão 2023.3. Com o Tableau Pulse, desenvolvemos uma experiência aprimorada para monitorar métricas e fazer perguntas sobre seus dados. Para obter mais informações, veja [Criar métricas com o Tableau Pulse](https://help.tableau.com/current/online/pt-br/pulse_create_metrics.htm) para conhecer a nova experiência e [Criar e solucionar problemas de métricas (descontinuado)](https://help.tableau.com/current/online/pt-br/metrics_create.htm) para o recurso descontinuado.

O serviço Métricas é responsável pela leitura e gravação de dados métricos no Tableau Server. Ele é necessário para que Métricas funcionem corretamente. Para tornar o Serviço Métricas altamente disponível, configure uma ou mais instâncias do serviço em vários nós do cluster. Recomendamos configurar pelo menos uma instância em cada nó em execução no Servidor de aplicativos (VizPortal).

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Metrics Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do Metrics Service fica visível na Página de status e na linha de comando do TSM, usando o comando <code>tsm status -v</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Metrics Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>metrics</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Impacto se o Serviço Métricas falhar

O Serviço Métricas é necessário para que as métricas funcionem corretamente no Tableau Server. Para minimizar problemas, instale várias instâncias do serviço na instalação do servidor. Se tiver uma instância de nó único do Tableau Server, configure pelo menos duas instâncias do serviço no nó. Se o Serviço Métricas parar de funcionar, todas as solicitações de métricas em andamento falharão. As solicitações subsequentes são encaminhadas para uma instância íntegra do serviço.

## Serviço Métricas em um cluster de vários nós

O Serviço Métricas é necessário para que as métricas funcionem corretamente no Tableau Server. Para minimizar problemas, instale várias instâncias do serviço na instalação do servidor. Em instalações de vários nós, recomendamos configurar pelo menos uma instância do Serviço Métricas em cada nó em execução no Servidor de aplicativos (VizPortal). Isso fornece redundância e desempenho máximo.

## Arquivos de registro do Serviço Métricas

O Serviço Métricas cria dois conjuntos de arquivos de registro:

- `control-metrics*.log`. Esses registros conterão informações sobre a inicialização e ativação do serviço.
- `metrics_*.log`. Os erros ou problemas são registrados aqui.

Para obter mais informações, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).

<!-- document id=21442eaac0c923dde290f679ef6e92acca1383f03e1fb494bc443146a4a5780f url=/tableau/current/pt-br/server/server_process_vizdata-native-service.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço nativo VizData do Tableau Server

O Serviço nativo VizData é o serviço principal que se comunica com o VizData Service e gerencia a conexão e a sessão da fonte de dados publicada no Tableau Server. O serviço é gerenciado internamente pelo Tableau Server e não pode ser configurado por um administrador. As instâncias do Serviço nativo VizData são configuradas automaticamente em qualquer nó que tenha instâncias do Serviço VizData, com um mapeamento um para um.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> VizData Native Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  VizData Native Service é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  VizData Native Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>vizdatanativeservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

Se o Serviço nativo VizData falhar, o processo será reiniciado automaticamente pelo Tableau Server em segundos. Os erros ou problemas são registrados em `nativeapi_vizdatanativeservice_*.txt`.

O `control_vizdatanativeservice_node*.log` contém informações sobre os serviços sendo iniciados e habilitados.

As instâncias do Serviço nativo VizData são automaticamente ampliadas ou reduzidas em cada nó para corresponder ao número de instâncias do Serviço VizData e gerenciadas internamente pelo Tableau. Não há nada que um administrador possa configurar relacionado ao serviço.

Para garantir uma conexão de fonte de dados de publicação saudável, tanto o Serviço VizData quanto o Serviço Nativo VizData devem ser executados em status saudáveis para atender às solicitações. Por padrão, ambos os serviços são adicionados aos nós que têm o Data Server instalado após a atualização ou instalação limpa.

<!-- document id=b6ae9506dcb24ffad9bc46ac3c4460699fb880cba365be1e055ffa7023cc0e7d url=/tableau/current/pt-br/server/server_process_data-source_service.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço Propriedades da fonte de dados do Tableau

Introduzido na versão 2020.1.0, o serviço Propriedades da fonte de dados do Tableau fornece metadados para fonte de dados publicada do Servidor de aplicativos (VizPortal) para serviços de clientes como Pergunte aos dados.

> [!WARNING]
> 
> **Observação**: o recurso Pergunte aos dados do Tableau foi descontinuado no Tableau Cloud em fevereiro de 2024 e no Tableau Server versão 2024.2.

Uma instância do serviço Propriedades da fonte de dados é configurada no nó inicial do Tableau Server. Você pode adicionar instâncias complementares ao nó inicial ou a outros nós em uma instalação de vários nós. Configure pelo menos uma instância do serviço Propriedades da fonte de dados em qualquer nó que tenha uma instância do Servidor de aplicativos.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Serviço Propriedades da fonte de dados</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do Serviço Propriedades da fonte de dados fica visível na Página de status e na linha de comando, usando o comando <code>tsm status -v</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os registros gerados pelo Serviço Propriedades da fonte de dados são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>tdsservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Arquivos de registro do Serviço Propriedades da fonte de dados

O serviço Propriedades da fonte de dados cria dois conjuntos de arquivos de registro:

- `control-tdsservice*.log`. Esses registros conterão informações sobre a inicialização e ativação do serviço.
- `tdsservice_*.log`. Os erros ou problemas são registrados aqui.

Para obter mais informações, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).

## Serviço Propriedades da fonte de dados em um cluster de vários nós

A forma como você configura o serviço Propriedades da fonte de dados em um cluster de vários nós em um cluster de vários nós depende de como você configura os nomes. Você deve ter pelo menos uma instância do serviço em qualquer instalação do Tableau Server. Além disso, configure pelo menos uma instância do Propriedades da fonte de dados em qualquer nó configurado com o Servidor de aplicativos (VizPortal).

<!-- document id=0217a09445e6b7bda70b4847a1cc42adf5ced282798f978cb0d0a8899f33fa16 url=/tableau/current/pt-br/server/server_process_internal-data-source_service.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço Propriedades internas da fonte de dados do Tableau Server

O serviço Propriedades internas da fonte de dados do Tableau Server foi introduzido na versão 2020.1.0 e se comunica com o serviço Propriedades da fonte de dados. Ele é gerenciado internamente pelo Tableau Server e não pode ser configurado por um administrador.

Uma instância do serviço Propriedades internas da fonte de dados é configurada automaticamente em qualquer nó que tenha uma instância do serviço Propriedades da fonte de dados.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 15%;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Serviço Propriedades internas da fonte de dados</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do Serviço Propriedades da fontes de dados fica visível na Página de status e na linha de comando, usando o comando <code>tsm status -v</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os registros gerados pelo Serviço Propriedades internas da fonte de dados são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>tdsnativeservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Registrar arquivos do serviço Propriedades internas da fonte de dados

O serviço Propriedades internas da fonte de dados cria dois conjuntos de arquivos de registro:

- `control-tdsnativeservice_*.log`. Esses registros conterão informações sobre a inicialização e ativação do serviço.
- `nativeapi_tdsnativeservice_*.log`. Os erros ou problemas são registrados aqui.

Para obter mais informações, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).

## Serviço Propriedades internas da fonte de dados em um cluster de vários nós

Uma instância dos serviços Propriedades internas da fonte de dados é adicionada a qualquer nó que tenha uma instância do Propriedades da fonte de dados configurada. Como o serviço Propriedades internas da fonte de dados é gerenciado internamente pelo Tableau, não há nada que um administrador possa configurar relacionado ao serviço.

<!-- document id=b4921e67a9e1a3b1523d5eea036ccb7a8cf372ebe3e92eb936e83a821b6296e3 url=/tableau/current/pt-br/server/server_process_saml-service.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço SAML do Tableau Server

Para instalações do Tableau Server com SAML específico do site habilitado, também haverá uma instância do serviço SAML em execução em cada nó configurado com o Servidor de aplicativos. Este serviço será configurado automaticamente quando o SAML específico do site tiver sido habilitado no servidor.

- Na versão 2023.1.x e posterior, o serviço SAML no Tableau Server não é exibido até que o SAML do site seja habilitado.
- Na versão 2022.3.x e anterior, o serviço SAML no Tableau Server é mostrado como interrompido, a menos que o SAML do site seja habilitado.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> SAML Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  SAML Service não está visível na página Status. Use a CLI do TSM para exibir o status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  SAML Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>samlservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

Se este processo entrar em um estado com falha, os usuários não poderão entrar no Tableau Server se a solicitação de usuário for encaminhada para um Servidor de aplicativos nesse nó. Como outros processos, quando ocorre uma falha em um nó que contém o Serviço SAML, o processo com falha deve ser reiniciado automaticamente em segundos.

<!-- document id=a64ad9ef861e8c9bd6ac4770196c87ce4b9c6294591f91fd0f5a8e9d45998717 url=/tableau/current/pt-br/server/server_process_vizdata-service.md -->

[Pular para o conteúdo principal](#main-content)

# Serviço VizData do Tableau Server

O Serviço VizData (vizdataservice) é o novo serviço que manipula as conexões com fontes de dados publicadas no Tableau Server. As consultas da pasta de trabalho às fontes de dados publicadas no Tableau Server são processadas pelo VizData Service. As consultas do Prep Flow e Data Catalog são tratadas pelo Data Server.

Para garantir alta disponibilidade do VizData Service, configure um ou mais processos do VizData Service em vários nós no cluster do Tableau Server.

**Observação:** a partir de 2024.2.3, pelo menos uma instância do Serviço VizData é necessária para uma instalação do Tableau Server.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> VizData Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  VizData Service é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  VizData Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>vizdataservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha do Serviço VizData? As solicitações para as fontes de dados publicadas que estão sendo manipuladas por essa instância falharão (não será possível renderizar a exibição da pasta de trabalho), mas as solicitações subsequentes serão roteadas para outras instâncias do VizData Service em execução. Supondo que o nó que contém o serviço VizData com falha ainda esteja em execução, os processos com falha deverão ser reiniciados automaticamente pelo Tableau Server.

O `control_vizdataservice_node*.log` contém informações sobre os serviços sendo iniciados e habilitados.

O `vizdataservice_node*.log` contém os erros ou problemas encontrados.

O Serviço VizData substituirá uma parte do tráfego do cliente do Servidor de Dados para o Serviço VizData quando os clientes consultarem e se conectarem às fontes de dados publicadas no Tableau Server. Se o processo do serviço VizData falhar, as consultas executadas por meio do serviço VizData falharão. As pastas de trabalho perderão a capacidade de consultar ou se conectar às fontes de dados publicadas.

### Recomendações

Recomendamos que você configure uma instância do VizData Service em um nó com as mesmas instâncias do Data Server e tenha ambos os serviços habilitados em um nó para fornecer e gerenciar conexões para publicar fontes de dados no Tableau Server para vários clientes.

Recomendamos que você configure uma instância do VizData Service em cada um dos nós onde você implanta o Data Server. Juntos, os serviços fornecerão e gerenciarão conexões com fontes de dados publicadas no Tableau Server. Adicionar instâncias adicionais do VizData Service a outros nós fornece duplicação de processos e reduz a possibilidade de tempo de inatividade da pasta de trabalho com nós do VizData Service.

Eventualmente, o Serviço VizData substituirá o Servidor de Dados em termos de conexão com a fonte de dados publicada no Tableau Server. Enquanto isso, ele ainda coexistirá com o serviço Data Server para compatibilidade com versões anteriores.

<!-- document id=0a3985101a9e5bf449accd6e5c4ef0f43473f5d8bea25518d8adbb74adeab92c url=/tableau/current/pt-br/server/rmt-services.md -->

[Pular para o conteúdo principal](#main-content)

# Serviços da Resource Monitoring Tool (RMT)

A Resource Monitoring Tool tem dois componentes principais: Resource Monitoring Tool Master (RMT Server) e RMT Agent.

- O RMT Master é onde os dados do Tableau Server são agrupados e fornecidos por meio de uma interface da Web. Aqui também é onde você pode configurar a RMT, e monitorar e analisar a integridade e o desempenho do Tableau Server.
- Um agente é executado em cada um dos nós no cluster do Tableau Server do Tableau para monitorar o desempenho e a atividade.

Este tópico descreve os serviços instalados com a RMT. As tabelas abaixo listam os serviços instalados na máquina do RMT Server e aqueles instalados nas máquinas do RMT Agent.

<table class="simple-table"><colgroup><col style="width: 14.5%;"><col style="width: 15%;"><col style="width: 25%;"><col style="width: 35.5%;"></colgroup><tbody><tr><td colspan="4"><strong>Serviços do RMT Server </strong></td></tr><tr><td><strong>Nome</strong></td><td><strong>Finalidade</strong></td><td><strong>Locais do arquivo de registro</strong><p>Windows: <code>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\</code></p><p>Linux: <code>/var/opt/tableau/tabrmt/master/logs</code></p><p><strong>Observação:</strong> para obter informações adicionais sobre arquivos de log, consulte:<a href="https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm" class="xref">Arquivos de registro do Resource Monitoring Tool do Tableau</a>.</p></td><td><strong>Observações</strong></td></tr><tr><td>Host</td><td>Usado durante a instalação e também para garantir que os outros processos estejam em execução.</td><td>Windows: <code>
host\YYYYMMDD.log	</code><p>Linux: <code>host/YYYMMDD.log</code></p></td><td>Responsabilidades:<ul><li><p>Observador de processos: garante que outros processos estejam em execução.</p></li><li><p>Observador de arquivos de configuração: detecta e responde a alterações em arquivos de configuração.</p></li></ul></td></tr><tr><td>Processador em segundo plano</td><td>Processa as informações enviadas pelos agentes e mantém os dados do postgres coletados pela RMT. Também fornece utilitário de linha de comando de administrador. Gera incidentes e notificações com base nas informações processadas.</td><td>Windows: <code>background\YYYYMMDD-pts.log
</code><p>Linux: <code>background/YYYYMMDD-pts.log</code></p></td><td>Responsabilidades:<ul><li><p>rmtadmin: utilitário de linha de comando que expõe a funcionalidade de linha de comando para o administrador.</p></li><li><p>Processamento de dados do agente: lida com a coleta e o processamento de dados de vários agentes</p></li><li><p>Sondagem de status do TS: sonda periodicamente o status do Tableau Server (TS), garantindo que o sistema esteja ativo e íntegro.</p></li><li><p>Análise de incidentes: analisa incidentes, como erros, falhas, atingindo limites para diferentes medidas.</p></li><li><p>Limpeza de dados: responsável por limpar dados antigos.</p></li><li><p>Coleta de informações de gráfico ad hoc: coleta dados sob demanda para monitoramento.</p></li><li><p>Notificações: gerencia o envio de notificações de alertas e incidentes.</p></li><li><p>Arquivamento de dados (desativado): envolve o arquivamento de dados antigos para liberar recursos ou para conformidade. Isso está desativado no momento.</p></li></ul></td></tr><tr><td>Diretor</td><td>É um tipo de processo de coordenação, e uma de suas principais responsabilidades é consultar o Tableau Server sobre o status das licenças e definir o status de todo o sistema.</td><td>Windows: <code>director\YYYYMMDD-pts.log</code><p>Linux: <code>director/YYYYMMDD-pts.log</code></p></td><td>Responsabilidades:<ul><li><p>Status do cluster: monitora a integridade e o status do cluster do servidor e define o status de todo o sistema.</p></li><li><p>Licenciamento: consulte o Tableau Server para saber o status das licenças.</p></li><li><p>Extração de gráficos: extrai dados para monitoramento e relatórios. Provavelmente tem acesso ao banco de dados do servidor.</p></li><li><p>Atualização do banco de dados: manipula atualizações no esquema ou versão do banco de dados</p></li><li><p>Processamento agregado diário: executa tarefas de processamento diárias, como agregação de dados para relatórios ou análises.</p></li></ul></td></tr><tr><td>Web</td><td>Executa o servidor Web. Fornece a interface do usuário. Registrar agentes para coleta de informações</td><td>Windows: <code>web\YYYYMMDD-pts.log</code><p>Linux: <code>web/YYYYMMDD-pts.log</code></p></td><td>Responsabilidades:<ul><li><p>Registro de agentes: gerencia o registro de agentes que monitoram ou coletam dados no servidor Tableau.</p></li><li><p>Interface de configuração: fornece uma interface de usuário para configurar várias configurações e parâmetros do sistema.</p></li><li><p>Interface de usuário de desempenho/atividade/conteúdo: oferece uma interface de usuário para os usuários visualizarem métricas de desempenho, registros de atividades e dados relacionados ao conteúdo no sistema.</p></li></ul></td></tr><tr><td>PostgreSQL</td><td>Repositório de dados local</td><td>Windows: <code>pgsql\*.log and *.csv</code><p>Linux: <code>pgsql/*.log and *.csv</code></p></td><td>&nbsp;</td></tr><tr><td>RabbitMQ</td><td>Corretor de mensagens</td><td>Windows: <code>\master\logs\rabbitmq\*.log</code><p>Linux: <code>master/logs/*.log</code></p></td><td>&nbsp;</td></tr></tbody></table>

<table class="simple-table"><colgroup><col style="width: 14.5%;"><col style="width: 15%;"><col style="width: 25%;"><col style="width: 35.5%;"></colgroup><tbody><tr><td colspan="4"><strong>Serviços do RMT Agent </strong></td></tr><tr><td><strong>Nome</strong></td><td><strong>Finalidade</strong></td><td><strong>Locais do arquivo de registro</strong><p>Windows: <code>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\</code></p><p>Linux: <code>/var/opt/tableau/tabrmt/master/logs</code></p><p><strong>Observação:</strong> para obter informações adicionais sobre arquivos de log, consulte:<a href="https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm" class="xref">Arquivos de registro do Resource Monitoring Tool do Tableau</a>.</p></td><td><strong>Observações</strong></td></tr><tr><td>Host</td><td>Usado durante a instalação e também para garantir que os outros processos estejam em execução.</td><td>Windows:<code>
host\YYYYMMDD.log	</code><p>Linux: <code>host/YYYYMMDD.log</code></p></td><td>Responsabilidades:<ul><li><p>Observador de processos: garante que outros processos estejam em execução.</p></li></ul><ul><li><p>Observador de arquivos de configuração: detecta e responde a alterações em arquivos de configuração.</p></li></ul></td></tr><tr><td>Processador em segundo plano</td><td>Processa as informações enviadas pelos agentes e mantém os dados do postgres coletados pela RMT. Também fornece utilitário de linha de comando de administração. Gera incidentes e notificações com base nas informações processadas.</td><td>Windows: <code>background\YYYYMMDD-pts.log
</code><p>Linux: <code>background/YYYMMDD-pts.log</code></p></td><td>Responsabilidades:<ul><li><p>rmtadmin: utilitário de linha de comando que expõe a funcionalidade de linha de comando para o administrador.</p></li><li><p>Observador de log: processa as informações enviadas pelo servidor Tableau a partir dos logs.</p></li></ul></td></tr><tr><td>Web</td><td>Executa o servidor Web.<p>Executa o registro do agente no primário para publicação de dados.</p></td><td>Windows: <code>web\YYYYMMDD-pts.log</code><p>Linux: <code>web/YYYMMDD-pts.log</code></p></td><td><p>&nbsp;</p></td></tr></tbody></table>

<!-- document id=235a41eb82eb7cb2936ddc3211b74f1f380fa4e9ca5030c7609de1714c74890b url=/tableau/current/pt-br/server/server_process_tsm-maintenance.md -->

[Pular para o conteúdo principal](#main-content)

# Serviços de manutenção do TSM do Tableau Server

Há três Serviços de manutenção do TSM instalados em cada nó do cluster: manutenção do banco de dados, backup/restauração e importação/exportação do site.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processos</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Database Maintenance, Backup/Restore e Site Import/Export.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status dos serviços de manutenção do TSM não está visível na página Status. Use a CLI do TSM para exibir o status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados por esses processos estão localizados no <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code></code>, nos diretórios <code>databasemaintenance</code>, <code>backuprestore</code> e <code>siteimportexport </code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

Esses serviços permanecem parados, a menos que uma tarefa de manutenção específica exija que eles sejam iniciados pelo administrador. Não é necessária a configuração de alta disponibilidade adicional para esses serviços. Esses serviços são usados somente para tarefas de manutenção, como backup e restauração, e não devem afetar o funcionamento do Tableau Server para os usuários finais.

<!-- document id=5f616e419c1fdd65cba3d0a4c6f74901bcac69fee251425b60abfa3a886b7eaf url=/tableau/current/pt-br/server/server_process_cache-server.md -->

[Pular para o conteúdo principal](#main-content)

# Servidor cache do Tableau Server

O Servidor cache fornece um cache de consulta externo compartilhado. É um cache de pares de chaves/valores que contêm informações de consultas anteriores para acelerar as solicitações futuras. Para tornar o Servidor cache altamente disponível, configure um ou mais processos do Servidor cache em vários nós do cluster.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Cache Server</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Cache Server  é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Cache Server  são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>cacheserver</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece se ocorrer uma falha no Servidor cache? As consequências são relativamente moderadas. O Tableau Server ainda funcionará, mas as ações poderão demorar mais, pois não têm resultados armazenados em cache disponíveis. Conforme as consultas são executadas novamente, o Servidor cache reiniciado é preenchido novamente, acelerando eventualmente os processos para os usuários finais. Na verdade, o Servidor cache não tem impacto de disponibilidade; no entanto, ele tem impacto em vários cenários de desempenho do usuário final.

Para reduzir o impacto no desempenho do usuário, execute vários processos desse tipo em todo o cluster. Recomendamos que você instale no máximo seis instâncias de servidor de cache, com, no máximo, duas instâncias a cada nó. Nossos testes indicam que a instalação de mais de seis instâncias de servidor de cache em uma instalação do Tableau Server não oferece melhorias e pode ter um impacto negativo no desempenho.

Um processo do Servidor cache com falha é reiniciado automaticamente; desde que o computador não tenha problemas, o processo do Servidor cache será reiniciado.

<!-- document id=85dec3ae637359e07933d07f9fe06d016dfbbfeccb9c78903948545fb5b7464f url=/tableau/current/pt-br/server/server_process_application-server.md -->

[Pular para o conteúdo principal](#main-content)

# Servidor de aplicativos do Tableau Server

O Servidor de aplicativos (VizPortal) controla o aplicativo Web e as chamadas REST API. O Servidor de aplicativos também é compatível com navegação e pesquisa. Para garantir a alta disponibilidade do Servidor de aplicativos, configure instâncias em cada nó no cluster do Tableau Server.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Application Server</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Application Server é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Application Server são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>vizportal</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha em um processo do Servidor de aplicativos? Ocorrerá falha nas solicitações controladas por essa instância, mas as solicitações subsequentes serão encaminhadas para outros processos do Servidor de aplicativos em execução. Supondo que o nó que contém o Servidor de aplicativos com falha ainda esteja em execução, o processo com falha deverá reiniciar automaticamente em segundos.

## Resolução de problemas com o Servidor de aplicativos

A partir da versão 2024.2.0, os administradores podem ativar dados de rastreamento de atividades e recursos (ART) para solucionar problemas com o Servidor de aplicativos. Os dados ART capturados fornecem informações detalhadas sobre o uso de memória e CPU. Isso pode ser útil se o seu servidor estiver enfrentando [Gerenciador de recursos do servidor (SRM)](https://help.tableau.com/current/server/pt-br/perf_guidelines.htm#SRM) reinicia devido à saturação da memória nativa com o Servidor de aplicativos (VizPortal).

**Importante:** ao ativar o ART, entradas adicionais são gravadas nos registros vizportal java e cpp. Você não deve deixar o ART ativado após terminar a investigação. Certifique-se de desabilitar o ART para evitar uso extra de espaço em disco.

### Habilitar os dados ART no Tableau Server

Para ativar dados ART:

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute os comandos do tsm a seguir:
    
    1. tsm configuration set -k [vizportal.enable\_art](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#vizportal_enable_art) -v true
    2. tsm configuration set -k [vizportal.log\_art\_java](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#vizportal_lot_art_java) -v true
    3. tsm configuration set -k [vizportal.art\_skip\_list](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#vizportal_art_skip_list) -v "/v1/reportEventUnauthenticated,/v1/getSessionInfo,/v1/hasUnseenNotifications,/v1/refreshSession,/v1/getViews,/v1/getUsers,/v1/getWorkbooks,/v1/getView,/v1/getServerSettingsUnauthenticated,/v1/getProjectAncestors,/v1/getWorkbook"
    4. tsm restart

Os registros do Servidor de aplicativos são encontrados aqui por padrão:

C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\logs\\vizportal

### Desativar ART

Desative os dados ART após concluir sua investigação. Para desabilitar o ART, execute os seguintes comandos em um prompt de comando:

1. tsm configuration set -k vizportal.enable\_art -v false
2. tsm configuration set -k vizportal.log\_art\_java -v false
3. tsm configuration set -k vizportal.art\_skip\_list -v ""
4. tsm restart

<!-- document id=0cbf83afbf8c1f5161f3425a46fe6ea917eeb979a9be63aeeb64a9cc4a950fab url=/tableau/current/pt-br/server/server_process_data-server.md -->

[Pular para o conteúdo principal](#main-content)

# Servidor de dados do Tableau Server

O Servidor de dados gerencia conexões com fontes de dados publicadas no Tableau Server. Para tornar o Servidor de dados altamente disponível, configure um ou mais processos do Servidor de dados para executar em vários nós do cluster.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Data Server</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de  Data Server é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Data Server são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>dataserver</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha em um processo do Servidor de dados? Ocorrerá falha nas consultas executadas pelo processo do Servidor de dados, resultando em falha de renderização da exibição, atualização de extração ou alerta. As solicitações subsequentes, incluindo uma nova tentativa da operação com falha, devem ser bem-sucedidas desde que um Servidor de dados funcionando esteja disponível para aceitar as solicitações reencaminhadas.

O Tableau Server não depende do Servidor de dados para funcionar, no entanto, sem um em execução, as pastas de trabalho no servidor perdem a capacidade de consultar ou se conectar a fontes de dados publicadas. Qualquer exibição que não use o Servidor de dados para nenhuma de suas fontes de dados ainda funcionará corretamente.

<!-- document id=08beaebf7b75a592085d7c6fbddd84b288766331fb5bd94a12c06a02f717d61d url=/tableau/current/pt-br/server/groups_create_adsync.md -->

[Pular para o conteúdo principal](#main-content)

# Sincronização dos grupos de diretório externo em um site

A qualquer momento, é possível sincronizar um grupo de diretório externo (como o Active Directory) com o Tableau Server para garantir que todos os novos usuários no Active Directory também sejam adicionados ao Tableau Server. Você pode sincronizar grupos individuais ou vários grupos de uma vez.

**Observação:** no contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas.

1. Em um site, clique em Grupos.
    
    Na página Grupos, selecione um ou mais grupos.
2. Clique em Ações > Sincronizar.
    
    ![Menu Ações com a opção para sincronizar grupos.](/tableau/current/pt-br/server/pt-br/Img/synchronize.png)

## Definir uma função de site mínima para usuários em um grupo de diretório externo

Na página Grupos - Detalhes, os administradores podem definir a função mínima de site para os usuários do grupo, a ser aplicada durante a sincronização.

Essa configuração não executa a sincronização; ela define a função mínima de site para ser aplicada ao grupo toda vez que uma sincronização for executada. Quando você sincroniza grupos de diretório externo, os novos usuários são adicionados com a função mínima de site. Se um usuário já existir, a função mínima de site será aplicada, caso proporcione ao usuário mais acesso em um site. Se você não definir uma função de site mínima, novos usuários são adicionados como Não licenciados como padrão.

**Observação:** Uma função de site do usuário pode ser promovida, mas nunca rebaixada, com base na configuração de função de site mínima. Se um usuário já tem a capacidade de publicar, essa capacidade será sempre mantida. Para obter mais informações sobre a função de site mínima, consulte [Funções de site, importação e sincronização do Active Directory](https://help.tableau.com/current/server/pt-br/users_site_roles.htm#MinSiteRoleImport).

1. Em um site, clique em Grupos.
2. Na página Grupos, selecione um grupo e, em seguida, selecione Ações > Função mínima no site.
3. Selecione uma função de site mínima e clique em **Alterar função de site**.
    
    ![Um menu suspenso com opções para alterar uma função de site para um grupo.](/tableau/current/pt-br/server/pt-br/Img/qs_adsync_1.png)

## O que acontece quando os usuários são removidos do diretório externo de origem? 

Os usuários não podem ser automaticamente removidos do Tableau Server por meio de uma operação de sincronização do diretório externo. Os usuários desabilitados, excluídos ou removidos de grupos no diretório externo permanecem no Tableau Server, para que os administradores possam fazer a auditoria e reatribuir o conteúdo do usuário, antes da remoção completa da conta de usuário. Para obter mais informações, consulte [Comportamento de sincronização ao remover usuários do Active Directory](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm#Sync).

## O que acontece quando um nome de usuário é alterado no diretório externo de origem?

Por padrão, o Tableau Server não sincronizará as alterações de nome de exibição ou endereço de e-mail do usuário após a sincronização inicial, quando a conta correspondente é criada no Tableau Server. Por exemplo, se o nome de usuário jsmith for usado para o nome de exibição John Smith, alterar o nome de exibição no diretório externo para Joe Smith não fará a sincronização para o usuário jsmith correspondente no Tableau Server. Da mesma forma, se o e-mail do usuário for alterado no diretório externo, o Tableau Server não sincronizará as alterações.

É possível configurar o Tableau Server para atualizar as propriedades de nome e e-mail quando mudam no diretório externo da fonte ao definir `vizportal.adsync.update_system_user` como `true`.

Para mudar esse comportamento, execute os comandos tms a seguir:

tsm configuration set -k vizportal.adsync.update\_system\_user -v true

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

## O que acontece quando um grupo do diretório externo é removido do Tableau Server?

Muitos administradores do Tableau usam os grupos do diretório externo para importar e criar usuários. Após a importação dos usuários para o Tableau Server, os administradores irão excluir o grupo no Tableau Server. Excluir um grupo não exclui os usuários contidos nele.

<!-- document id=3d980061c1c4afef1e23b7ceddb94ddc8a726e23a45e17f3a3e1bd8130d90bdf url=/tableau/current/pt-br/server/groups_globalsync.md -->

[Pular para o conteúdo principal](#main-content)

# Sincronizar os grupos do Active Directory no servidor

O usuário na função de administrador de servidor pode sincronizar todos os grupos (que foram configurados no Tableau Server) de diretório externo (como o Active Directory) em uma agenda regular ou sob demanda na guia Geral da página Configurações do servidor.

![Tela Sincronização do Active Directory.](/tableau/current/pt-br/server/pt-br/Img/groups_adsync_globalsettings.png)

**Observação:** no contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas.

## Antes de começar

Antes de sincronizar grupos como descrito neste tópico, você deve primeiro importar o grupo de diretório externo para o Tableau Server. Consulte [Criar grupos pelo Active Directory](https://help.tableau.com/current/server/pt-br/groups_create_ad.htm).

## Sincronização dos grupos de diretório externo em uma agenda

1. **Site único**: clique em Configurações > Geral.
    
    **Vários sites**: no menu do site, clique em **Gerenciar todos os sites** e, em seguida, em Configurações > Geral.
2. Use a barra de rolagem da página até Sincronização do Active Directory, selecione Sincronizar grupos do Active Directory em uma agenda regular.
    
    ![Tela Sincronização do Active Directory com opções para frequência de agendamento.](/tableau/current/pt-br/server/pt-br/Img/groups_adsync_globalsettings_schedule.png)
3. Selecione a frequência e o horário da sincronização.
4. Clique em Salvar.

**Observação:** a partir das versões 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1, um limite de tempo padrão de 4 horas limita quanto tempo uma sincronização de grupo agendada pode levar antes de ser cancelada. Um administrador do servidor pode alterar esse limite de tempo se sua sincronização agendada for de grupos muito grandes ou demorar mais do que o padrão. Para obter mais informações, consulte [Sincronizar todos os grupos do Active Directory em uma agenda](https://help.tableau.com/current/server/pt-br/qs_ad_group_sync.htm) e [backgrounder.timeout.sync\_ad\_group](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#backgrounder_timeout_ad_group_sync).

## Sincronização de todos os grupos de diretório externo sob demanda

A qualquer momento, é possível sincronizar os grupos do diretório externo (como o Active Directory) com o Tableau Server para garantir que os novos usuários e as alterações no diretório externo sejam refletidos em todos os grupos do diretório externo no Tableau Server.

1. **Site único**: clique em Configurações > Geral.
    
    **Vários sites**: no menu do site, clique em **Gerenciar todos os sites** e, em seguida, clique em Configurações > Geral.
    
    ![Tela Sincronização do Active Directory com uma caixa marcada para sincronizar os grupos do Active Directory regularmente.](/tableau/current/pt-br/server/pt-br/Img/groups_adsync_globalsettings_manual.png)
2. Em Sincronização do Active Directory, clique em Sincronizar todos os grupos.

## Exibição da atividade de sincronização

Você pode visualizar os resultados dos trabalhos de sincronização na exibição administrativa **Tarefas em segundo plano para não extrações**. A **Fila de sincronização dos grupos do Active Directory** coloca em filas e indica o número de tarefas de **Sincronização do grupo do Active Directory** que devem ser executadas.

1. **Único site**: Clique em Status.
    
    **Vários sites**: No menu do site, clique em **Gerenciar todos os sites** e, em seguida, clique em Status.
2. Clique no link Tarefas em segundo plano para não extrações.
3. Defina o filtro Tarefa para incluir a **Fila de sincronização dos grupos do Active Directory** e a **Sincronização do grupo do Active Directory**.

Navegue rapidamente para essa exibição administrativa clicando no link Exibir atividade de sincronização na página Configurações do servidor.

## Definir uma função de site mínima para usuários em um grupo de diretório externo

Na página Grupos - Detalhes, é possível definir a função mínima de site para os usuários do grupo, para ser aplicada durante a sincronização do Active Directory.

Essa configuração não executa a sincronização; em vez disso, ela define a função mínima de site para ser aplicada ao grupo toda vez que uma sincronização for executada. O resultado é que, quando você sincroniza grupos do diretório externo, os novos usuários são adicionados ao site com a função mínima. Se um usuário já existir, a função mínima de site é aplicada, caso proporcione ao usuário mais acesso em um site. Se você não definir uma função de site mínima, novos usuários são adicionados como Não licenciados como padrão.

**Observação:** Uma função de site do usuário pode ser promovida, mas nunca rebaixada, com base na configuração de função de site mínima. Se um usuário já tem a capacidade de publicar, essa capacidade será sempre mantida. Para obter mais informações sobre a função de site mínima, consulte [Funções de site, importação e sincronização do Active Directory](https://help.tableau.com/current/server/pt-br/users_site_roles.htm#MinSiteRoleImport).

1. Em um site, clique em Grupos.
2. Na página Grupos, selecione um grupo.
    
    Clique em Ações > Função de site mínima.
3. Selecione uma função de site mínima e clique em **Alterar função de site**.
    
    ![Um menu suspenso com opções para alterar uma função de site para um grupo.](/tableau/current/pt-br/server/pt-br/Img/qs_adsync_1.png)

## O que acontece quando os usuários são removidos do diretório externo de origem? 

Os usuários não podem ser automaticamente removidos do Tableau Server por meio de uma operação de sincronização do diretório externo. Os usuários desabilitados, excluídos ou removidos de grupos no diretório externo permanecem no Tableau Server, para que os administradores possam fazer a auditoria e reatribuir o conteúdo do usuário, antes da remoção completa da conta de usuário. Para obter mais informações, consulte [Comportamento de sincronização ao remover usuários do Active Directory](https://help.tableau.com/current/server/pt-br/users_manage_ad.htm#Sync).

## Melhora do desempenho da sincronização de grupos

A sincronização do diretório externo é realizada pelo processo do processador em segundo plano. O processo do processador em segundo plano é o mesmo usado para gerenciar e criar extrações e também para gerar conteúdo de assinatura. Em grandes empresas com associação dinâmica de grupo e uso intenso de extração, o processo de sincronização de grupos do diretório externo pode provocar interrupções indesejadas. Recomendamos executar a sincronização de grupo durante o horário não comercial.

Por padrão, o processo do processador em segundo plano realiza a sincronização em uma operação serial. Isso significa que cada grupo é sincronizado, um após o outro, em um único processo do processador em segundo plano. Se você estiver executando várias instâncias de processos do processador em segundo plano em um único Tableau Server ou em uma implantação distribuída, considere habilitar o processamento paralelo para sincronização do diretório externo. Quando o processamento paralelo do processador em segundo plano é habilitado, a sincronização de grupo é distribuída por meio de vários processos do processador em segundo plano para obter o melhor desempenho.

Para habilitar o processamento do processador em segundo plano paralelo para sincronização de grupo, abra a CLI do TSM e digite os seguintes comandos:

`tsm configuration set -k backgrounder.enable_parallel_adsync -v true`

`tsm pending-changes apply`

<!-- document id=7d3943b2ce62e18c131b6ea2f736ccc2a9e25d8dcaa0bb5dd11ef72bdf97a658 url=/tableau/current/pt-br/server/qs_ad_group_sync.md -->

[Pular para o conteúdo principal](#main-content)

# Sincronizar todos os grupos do Active Directory em uma agenda

Após importar grupos do Active Directory no Tableau Server, você pode certificar-se de que permaneçam sincronizados no Tableau Server ao configurar uma agenda. Você também pode sincronizar todos os grupos do Active Directory no servidor sob demanda, em qualquer momento. A configuração de função de site mínima para o grupo é aplicada quando os usuários são sincronizados.

**Observação:** no contexto da sincronização de usuário e de grupo, o Tableau Server configurado com o armazenamento de identidades LDAP é equivalente ao Active Directory. Os recursos de sincronização do Active Directory no Tableau Server funcionam perfeitamente com soluções de diretório LDAP devidamente configuradas.

A partir das versões 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1, você pode definir um limite máximo de tempo para uma sincronização de grupo agendada antes de ser cancelada. O limite de tempo padrão é de 4 horas. Para obter mais informações, consulte [backgrounder.timeout.sync\_ad\_group](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#backgrounder_timeout_ad_group_sync).

## 1 Defina uma função de site mínima para a sincronização

Em um site, clique em Grupos. Selecione um grupo e, em seguida, clique em Ações > Função mínima de site. Selecione uma função mínima de site e clique em Alterar função de site. Os administradores de servidor e site podem ser definidos na função de site mínima para que o grupo de usuários seja aplicado durante a sincronização do Active Directory. Se você não definir uma função de site mínima, novos usuários são adicionados como Não licenciados.

![Um menu suspenso com opções para alterar uma função de site para um grupo.](/tableau/current/pt-br/server/pt-br/Img/qs_adsync_1.png)

A sincronização pode promover uma função de site de usuário, mas nunca rebaixará uma função desse tipo.

## 2 Defina a agenda

Os administradores de servidor podem habilitar a sincronização de todos os grupos do Active Directory na guia Geral, da página Configurações do servidor. Habilite a sincronização, selecione as configurações de frequência e, em seguida, clique em Salvar.

![Um formulário com opções para configurar a sincronização do Active Directory em uma programação regular.](/tableau/current/pt-br/server/pt-br/Img/qs_adsync_2.png)

Todos os grupos do Active Directory no servidor são sincronizados de acordo com a mesma agenda.

## 3 Execute a sincronização sob demanda (opcional)

Na guia Geral, da página Configurações, clique em Sincronizar todos os grupos para sincronizar imediatamente todos os grupos do Active Directory no Tableau Server. Clique neste botão em qualquer momento para garantir que novos usuários e alterações estejam refletidos em todos os grupos do Active Directory no servidor.

![Um formulário com opções de configuração para sincronização do Active Directory, incluindo a opção para sincronizar todos os grupos.](/tableau/current/pt-br/server/pt-br/Img/qs_adsync_3.png)

Clique em Sincronizar todos os grupos para sincronizar todos os grupos do Active Directory em um servidor fora de uma agenda.

## 4 Exiba o status das tarefas de sincronização

Os administradores de servidor e site podem exibir os resultados dos trabalhos de sincronização do Active Directory na exibição administrativa **Tarefas de segundo plano para não extrações**. No servidor ou em um site, clique em Status. Em Análise, clique em Tarefas em segundo plano para não extrações e filtre as tarefas Sincronização de grupos do Active Directory da fila e Grupo do Active Directory de sincronização.

![Janela de status do servidor mostrando tarefas em segundo plano em execução no servidor.](/tableau/current/pt-br/server/pt-br/Img/groups_adsync_viewtasks.png)

As filas de **Sincronização dos grupos do Active Directory da fila** e **Grupo do Active Directory de sincronização** a serem executadas.

<!-- document id=3d7de2ee697478588e7ce60963d579d6a3f29a328499c954123952a513c001e5 url=/tableau/current/pt-br/server/security_kms_aws.md -->

[Pular para o conteúdo principal](#main-content)

# Sistema de gerenciamento de chaves da AWS

O Tableau Server tem três opções de Sistema de gerenciamento de chaves (KMS) que permitem ativar a criptografia em repouso. Duas delas exigem os recursos de Advanced Management, enquanto um local está disponível com todas as instalações do Tableau Server.

**Importante:** a partir de 16 de setembro de 2024, o Advanced Management não estará mais disponível como uma opção complementar independente. Os recursos do Advanced Management só estarão disponíveis se você o adquiriu anteriormente ou se você comprar determinadas edições de licença: Tableau Enterprise, Tableau Cloud+ ou Tableau+ Bundle (disponível para Tableau Cloud) ou Tableau Enterprise ou Tableau Server+ (disponível para Tableau Server).

A partir da versão 2019.3, o Tableau Server adicionou essas opções KMS: 

- Um KMS local que está disponível com todas as instalações. Para obter detalhes, consulte [Sistema de gerenciamento de chaves do Tableau Server](https://help.tableau.com/current/server/pt-br/security_kms.htm).
- Um KMS baseado em AWS, que vem como parte do Advanced Management. Isso está descrito abaixo.

A partir da versão 2021.1, o Tableau Server adicionou outra opção de KMS: 

- Um KMS baseado em Azure, que vem como parte do Advanced Management. Para obter detalhes, consulte [Azure Key Vault](https://help.tableau.com/current/server/pt-br/security_kms_azure.htm).

Com o lançamento da versão 2019.3, o Tableau Server é compatível com o sistema de gerenciamento de chaves AWS (KMS) como parte do Advanced Management.

## AWS KMS para criptografia em repouso

O AWS KMS está disponível como parte do Advanced Management no Tableau Server. Para obter mais informações, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

Se sua organização estiver implantando a Criptografia de extração de dados em repouso, você tem a opção de configurar o Tableau Server para usar a AWS como o KMS para extrair a criptografia. Para habilitar o AWS KMS, implante o Tableau Server no AWS EC2. No cenário do AWS, o Tableau Server usa a chave principal do cliente (CMK) do AWS KMS para gerar uma [chave de dados AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys). O Tableau Server usa a chave de dados da AWS como chave raiz principal para todas as extrações criptografadas. No entanto, mesmo se configurado para o AWS KMS, o repositório de chaves Java nativo e o KMS local ainda são usados para o armazenamento seguro de segredos no Tableau Server. O AWS KMS só é usado para criptografar a chave principal raiz para extrações criptografadas.

O uso do AWS para criptografar a chave principal raiz oferece as melhores propriedades de segurança, pois não armazena a chave principal nas mesmas permissões que as extrações.

![Um diagrama ilustra várias chaves para criptografia de dados.](/tableau/current/pt-br/server/pt-br/Img/security_kms_AWS_key_hierarchy.png)

A hierarquia de chaves do Tableau Server é configurada com o AWS KMS

## Configurar o AWS KMS para extrações criptografadas do Tableau Server

Para usar a chave principal do cliente (CMK) AWS para criptografar a chave raiz na hierarquia do KMS do Tableau Server, configure o Tableau Server conforme descrito nesta seção.

Antes de começar, verifique se os seguintes requisitos foram atendidos:

- O Tableau Server deve ser implantado no AWS EC2.
- O Tableau Server deve ser configurado com Advanced Management. Consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).
- Você deve ter o controle administrativo de uma chave principal do cliente (CMK) criada no serviço de gerenciamento de chaves AWS.
- O ID do usuário (geralmente o endereço de e-mail) da pessoa que configura o AWS KMS não pode ter mais de 26 caracteres.

### Etapa 1: Criar a CMK e definir política de chave para o Tableau Server no AWS

Os seguintes procedimentos são realizados no serviço do AWS KMS. As referências são incluídas na documentação do AWS.

1. Crie a CMK que você usará para o Tableau Server. Consulte o tópico AWS, [Criação de chaves](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys).
2. Atualize a função IAM da instância do servidor.
    
    O Tableau Server deve autenticar com o AWS KMS usando a função IAM da instância. A função precisa ter uma política anexada a ela. A política deve fornecer as permissões da instância para chamar as ações "GenerateDataKey" e "Descriptografar" na CMK. Consulte [Funções IAM para Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html)..
    
    Em uma implantação de vários nós do Tableau Server, todos os nós do servidor devem estar em execução nas funções que têm essa política (ou equivalente) anexada. É possível atribuir a mesma função a todos os nós do cluster.
3. No mínimo, a CMK deve ter uma política de chave em que o `Effect` está definido como `Allow` o `Prinicpal` (a função IAM que está anexada às instâncias do servidor) o `Action`: `GenerateDataKey` e o `Decrypt`. Consulte [Uso das políticas de chave no AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html).

### Etapa 2: coletar parâmetros de configuração AWS

Você precisará da cadeia de caracteres ARN completa do AWS KMS. Essa cadeia de caracteres está na seção "Configuração geral" das páginas de gerenciamento do AWS KMS. O ARN é apresentado neste formato: arn:aws:kms:<region>:<account>:key/<CMK\_ID>, por exemplo, `arn:aws:kms:us-west-2:867530990073:key/1abc23de-fg45-6hij-7k89-1l0mn1234567`.

Além disso, será necessário especificar a região AWS, que também está incluída na cadeia de caracteres ARN. No exemplo acima, a região é `us-west-2`. A região é onde reside a instância KMS. Na próxima etapa, será necessário especificar uma região como mostrado na coluna Região na [tabela Amazon API Gateway](https://docs.aws.amazon.com/general/latest/gr/rande.html).

### Etapa 3: configurar o Tableau Server para AWS KMS

Execute o seguinte comando no Tableau Server. Este comando reiniciará o servidor:

- `tsm security kms set-mode aws --aws-region "<region>" --key-arn "arn:aws:kms:<region>:<account_number>:key/<CMK_ID>"`
    
    A opção `--key-arn` usa uma cópia direta da cadeia de caracteres ARN na seção "Configuração geral" das páginas de gerenciamento do AWS KMS.
    
    Por exemplo, se a instância do AWS KMS estiver em execução na região us-west-2, o número da conta será 867530990073 e a chave CMK será 1abc23de-fg45-6hij-7k89-1l0mn1234567, então o comando seria o seguinte:
    
    `tsm security kms set-mode aws --aws-region "us-west-2" --key-arn "arn:aws:kms:us-west-2:867530990073:key/1abc23de-fg45-6hij-7k89-1l0mn1234567"`

### Etapa 4: habilitar criptografia em repouso

Consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

### Etapa 5: validar a instalação

1. Execute o seguinte comando:
    
    `tsm security kms status`
    
    As seguintes informações podem ser retornadas:
    
    - O ARN (ID) da chave principal do cliente (CMK)
    - A região em que está a CMK
    - A ID da chave principal raiz (RMK) em uso. A RMK é uma chave criptografada pela CMK. O Tableau Server descriptografa a CMK fazendo chamadas para o AWS KMS. A RMK é usada para criptografar/descriptografar a chave principal de extração (MEK). A RMK pode mudar, mas haverá somente uma de cada vez.
    - O KMS armazena uma coleção de chaves principais de extração (MEKs). Cada MEK tem:
        - Uma ID, por exemplo, 8ddd70df-be67-4dbf-9c35-1f0aa2421521
        - Um status “criptografar ou descriptografar chave” ou “somente descriptografar chave”. Se a chave for "criptografar ou descriptografar", o Tableau Server criptografará os novos dados com ela. Caso contrário, a chave será usada somente para descriptografia
        - Um carimbo de data/hora de criação, por exemplo, “Criado em: 2019-05-29T23:46:54Z”.
        - Primeira transição para criptografar e descriptografar: um carimbo de data/hora indicando quando a chave se tornou uma chave de criptografia ou descriptografia.
        - Transição somente para descriptografia: um carimbo de data/hora indicando quando ocorreu a transição da chave somente para descriptografia.
2. Exibir registros após criptografar e descriptografar extrações:
    
    - Publicar extrações no site e criptografá-las. Consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).
    - Acesse as extrações com o Tableau Desktop ou com a criação na Web em um navegador (isso descriptografa as extrações para uso).
    - Pesquise os arquivos de registro vizqlserver\_node para as cadeias de caracteres `AwsKmsEncryptionEnvelopeAccessor` e `AwsKmsEncryptionEnvelope`. O local padrão dos registros se encontra em `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs`
        
        Os exemplos de entrada de registro que indicam uma configuração bem-sucedida incluem:
        
        - Descriptografia de RMK com ID 1abc23de-fg45-6hij-7k89-1l0mn1234567 usando a CMK com ARN arn:aws:kms:us-west-2:867530990073:key/1234567d-a6ba-451b-adf6-3179911b760f
        - Uso de RMK com ID 1abc23de-fg45-6hij-7k89-1l0mn1234567 para descriptografar o repositório KMS
        
        Para atualizações de publicação e extração relacionadas ao KMS, pesquise os registros do processador em segundo plano. Para obter mais informações sobre os registros, consulte [Locais de arquivo de registro e registros do Tableau Server](https://help.tableau.com/current/server/pt-br/logs_loc.htm).

## Solucionar problemas de configuração

### Configuração incorreta em vários nós

Em uma configuração de vários nós para o AWS KMS, o comando `tsm security kms status` pode relatar status íntegro (OK), mesmo que outro nó no cluster esteja configurado incorretamente. A verificação de status KMS relata apenas sobre o nó em que o processo do Controlador de administração do Tableau Server está sendo executado e não relata os outros nós do cluster. Por padrão, o processo do Controlador de administração do Tableau Server é executado no nó inicial do cluster.

Portanto, se outro nó estiver configurado incorretamente, de modo que o Tableau Server não possa acessar a AWS CMK, esses nós podem relatar estados de erro para vários serviços, que não seriam iniciados.

Se alguns serviços não iniciarem após definir o KMS como modo AWS, execute o comando a seguir para reverter para o modo local: `tsm security kms set-mode local`.

## Atualizar a AWS CMK

A atualização da AWS CMK é uma tarefa realizada com AWS. Por padrão, a AWS CMK será atualizada uma vez ao ano. Consulte o tópico AWS, [Como funciona a rotação automática de chave](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html#rotate-keys-how-it-works). Como o ARN e a região não mudam, não é necessário atualizar a configuração KMS no Tableau Server para cenários normais de atualização da CMK.

Após as atualizações da CMK do AWS, você deve gerar novamente a RMK interna e as MEKs no Tableau Server. Além disso, você deve criptografar novamente todas as extrações com a nova CMK:

1. Execute o comando `[tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#regenerate-tokens)` para gerar novamente todas as chaves internas no Tableau Server, incluindo a RMK e as MEKs usadas para criptografia de extração.
2. Execute o `tabcmd reencryptextracts <site-name>` para criptografar novamente as extrações em determinado site. Execute esse comando em cada site que armazena extrações criptografadas. Dependendo do número de extrações criptografadas no site, essa operação pode consumir uma carga significativa de processamento de servidor. Considere executar essa operação fora do horário comercial. Consulte [Criptografia de extrações em repouso](https://help.tableau.com/current/server/pt-br/security_ear.htm).

## Gerar novamente a RMK e a MEK no Tableau Server

Para gerar novamente a chave principal raiz e as chaves principais de criptografia no Tableau Server, execute o comando `[tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#regenerate-tokens)`.

## Fazer backup e restaurar com o AWS KMS

Um backup do servidor pode ser obtido no modo AWS sem configurações ou procedimentos adicionais. O backup contém cópias criptografadas da RMK e das MEKs. A descriptografia das chaves requer acesso e controle da AWS CMK.

Para o cenário de restauração, o servidor que está sendo restaurado pode estar no modo KMS, incluindo Local. O único requisito é que o servidor em que o backup está sendo restaurado tenha acesso de descriptografia para o próprio backup usado.

Na restauração, as MEKs do backup são importadas como chaves somente para descriptografia. A RMK não é migrada. Uma nova RMK é gerada como parte do processo de instalação/restauração.

<!-- document id=176945986aabf071ecd5c8526b8df37a44476a288b4a5ddff96242ba3b38f8ac url=/tableau/current/pt-br/server/security_kms.md -->

[Pular para o conteúdo principal](#main-content)

# Sistema de gerenciamento de chaves do Tableau Server

O Tableau Server tem três opções de Sistema de gerenciamento de chaves (KMS) que permitem ativar a criptografia em repouso. Uma é a opção local que está disponível com todas as instalações do Tableau Server. Duas opções adicionais exigem recursos de gerenciamento avançado, mas permitem usar um KMS diferente.

**Importante:** a partir de 16 de setembro de 2024, o Advanced Management não estará mais disponível como uma opção complementar independente. Os recursos do Advanced Management só estarão disponíveis se você o adquiriu anteriormente ou se você comprar determinadas edições de licença: Tableau Enterprise, Tableau Cloud+ ou Tableau+ Bundle (disponível para Tableau Cloud) ou Tableau Enterprise ou Tableau Server+ (disponível para Tableau Server).

A partir da versão 2019.3, o Tableau Server adicionou essas opções KMS: 

- Um KMS local que está disponível com todas as instalações. Isso está descrito abaixo.
- Um KMS baseado em AWS, que vem como parte do Advanced Management. Para obter detalhes, consulte [Sistema de gerenciamento de chaves da AWS](https://help.tableau.com/current/server/pt-br/security_kms_aws.htm).

A partir da versão 2021.1, o Tableau Server adicionou outra opção de KMS: 

- Um KMS baseado em Azure, que vem como parte do Advanced Management. Para obter detalhes, consulte [Azure Key Vault](https://help.tableau.com/current/server/pt-br/security_kms_azure.htm).

## KMS local do Tableau Server

O KMS local do Tableau Server usa o recurso de armazenamento de segredos descrito em [Gerenciar segredos do servidor](https://help.tableau.com/current/server/pt-br/security_secret_storage.htm) para criptografar e armazenar a chave principal de extração. Nesse cenário, o repositório de chaves Java atua como a raiz da hierarquia de chaves. O repositório de chaves Java é instalado com o Tableau Server. O acesso à chave principal é gerenciado por mecanismos de autorização do sistema de arquivos nativos pelo sistema operacional. Na configuração padrão, o KMS local do Tableau Server é usado para extrações criptografadas. A hierarquia de chaves do KMS local e as extrações criptografadas são ilustradas aqui:

![Um diagrama ilustra o processo de criptografia de dados com múltiplas chaves de criptografia.](/tableau/current/pt-br/server/pt-br/Img/security_kms_local_key_hierarchy.png)

## Solucionar problemas de configuração

### Configuração incorreta em vários nós

Em uma configuração de vários nós para o AWS KMS, o comando `tsm security kms status` pode relatar status íntegro (OK), mesmo que outro nó no cluster esteja configurado incorretamente. A verificação de status KMS relata apenas sobre o nó em que o processo do Controlador de administração do Tableau Server está sendo executado e não relata os outros nós do cluster. Por padrão, o processo do Controlador de administração do Tableau Server é executado no nó inicial do cluster.

Portanto, se outro nó estiver configurado incorretamente, de modo que o Tableau Server não possa acessar a AWS CMK, esses nós podem relatar estados de erro para vários serviços, que não seriam iniciados.

Se alguns serviços não iniciarem após definir o KMS como modo AWS, execute o comando a seguir para reverter para o modo local: `tsm security kms set-mode local`.

## Gerar novamente a RMK e a MEK no Tableau Server

Para gerar novamente a chave principal raiz e as chaves principais de criptografia no Tableau Server, execute o comando `[tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/pt-br/cli_security_tsm.htm#regenerate-tokens)`.

## Outros artigos nesta seção

<!-- document id=4f7e5c26e26072b3de76b723a20cddf965e005f885b9dd98baffc9290da42049 url=/tableau/current/pt-br/server/identity_migration.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre a migração de identidade

A partir da versão 2022.1, o Tableau Server armazena e gerencia informações de identidade usando o Identity Service. A migração de identidade é um pré-requisito para configurar e usar [pools de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm).

> [!WARNING]
> 
> **Importante:** se você não planeja usar o recurso de pools de identidades, recomendamos não executar a migração de identidade. Executar a migração de identidade sem planos de usar pools de identidades não trará benefícios à implantação do Tableau Server.

Para implantações existentes, se atualizar o Tableau Server para a versão 2022.1 (ou posterior) e restaurar um backup do Tableau 2021.4 (ou anterior), você pode iniciar a migração de identidade após a conclusão da atualização do Tableau Server para preencher o novo Serviço de identidade. A migração de identidade preenche tabelas complementares do Serviço de Identidade para todos os usuários do Tableau Server, que são usadas para autenticar usuários por meio do Serviço de Identidade. A migração é executada em segundo plano e não interromperá nem interferirá no uso do Tableau Server por seus usuários.

Como administrador, você pode monitorar e gerenciar a migração, incluindo alterar quando a migração é executada ou resolver possíveis conflitos de migração, por meio de uma página dedicada de **Migração de Identidade** disponível na página Usuários do Tableau Server. Essa página está disponível durante o processo de migração.

## Resumo das etapas para implantações existentes

Para implantações novas e existentes, você deve configurar o Tableau Server para usar o Serviço de identidade após a conclusão da migração para aproveitar as melhorias na estrutura de identidade e configurar pools de identidade.

> [Etapa 1: antes de começar](#step1)
> 
> [Etapa 2: habilitar novo esquema e capacidade de login](#step2)
> 
> [Etapa 3: iniciar a migração de identidade](#step3)
> 
> [Etapa 4: concluir a migração de identidade](#step4)
> 
> [Etapa 5: configurar o Tableau Server para usar o Serviço de identidade](#step5)
> 
> [Etapa 6: habilitar pools de identidade](#step6)

### Termos-chave

- **Serviço de identidade** - um serviço no Tableau Server 2022.1 (e posterior) responsável pela administração de identidades de usuários, incluindo autenticação e provisionamento. O serviço usa um esquema de identidade em que as identidades do usuário são representadas pelas tabelas do Serviço de Identidade e a tabela herdada "system\_users".
- **Pools de identidade** - uma ferramenta de gerenciamento de identidade que usa informações de provisionamento e autenticação para permitir o acesso do usuário ao Tableau Server. Os pools de identidade permitem um fluxo de trabalho de gerenciamento de identidade mais centralizado e flexível, criado no Serviço de identidade para repositório e gerenciamento de identidades de usuário no Tableau Server.
- **Modo de armazenamento de identidade herdado** - um esquema de identidade limitado usado pelo Tableau Server 2021.4 (e anterior), em que as identidades de usuário são representadas apenas pela tabela "system\_users" herdada.
- **Migração de identidade** - o processo de auditoria que avalia as identidades de usuários existentes do sistema Tableau Server, consulta os armazenamentos de identidade externos upstream para obter informações de identidade adicionais (conforme apropriado) e importa essas informações de identidade adicionais para o Serviço de identidade.
- **Armazenamento de identidade externo** - um tipo de armazenamento de identidade externo e upstream para o Tableau Server, em que todas as informações de identidade são armazenadas e gerenciadas por um serviço de diretório externo (Active Directory \[AD\] ou LDAP). Se configurado, o Tableau Server sincroniza com o diretório externo para que exista uma cópia das informações de identidade no Tableau Server.
- **Armazenamento de identidade site** - um tipo de armazenamento de identidade fornecido pelo Tableau Server. Se configurado, o Tableau Server armazena e gerencia informações de identidade no repositório do Tableau Server sem nenhum diretório externo configurado para essas informações.
- **Usuário do sistema** - um usuário do Tableau Server. Um usuário corresponde a um registro de entrada ("system\_users") no Serviço de Identidade (por meio da tabela "system\_users\_identities") e no modo de armazenamento de identidade herdado. Um registro "system\_users" pode ter várias identidades de usuário associadas a ele e habilitado para entrar em vários sites. O vínculo entre um registro "system\_users" e sites é definido na tabela "users".

### Objetivo da migração de identidade

Quando você cria um backup do Tableau Server, as informações de identidade são salvas no esquema de identidade usado pela versão do Tableau Server para a qual o backup foi criado. A migração é necessária para preencher as informações de identidade do esquema de identidade usado no backup para o esquema de identidade usado pelo Serviço de Identidade.

**Esquema de identidade do Tableau Server 2021.4 e anteriores**

![Um diagrama de um serviço de aplicativo com duas caixas rotuladas como "system\_users" e "domains".](/tableau/current/pt-br/server/pt-br/Img/id_mig_tables_legacy.png)

O esquema de identidade usado pelo modo de armazenamento de identidade herdado consiste em duas tabelas, "system\_users" e "domains".

**Esquema de identidade do Tableau Server 2022.1 e posteriores**

![Um diagrama que ilustra as tabelas do banco de dados para o serviço de identidade.](/tableau/current/pt-br/server/pt-br/Img/id_mig_tables.png)

O esquema de identidade usado pelo Serviço de Identidade inclui as tabelas legadas "system\_users" e tabelas complementares do Serviço de Identidade (\*\_identity\_stores e \*identities) que capturam mais informações de identidade. As tabelas adicionais ajudam a reduzir problemas que podem ser causados por alterações upstream nos armazenamentos de identidade externos.

### O que acontece durante a migração de identidade

Quando as informações sobre identidades de usuários são migradas, as informações de identidade armazenadas na tabela legada "system\_users" são complementadas com as tabelas do Serviço de Identidade.

O tipo de tabelas de serviço de identidade com as quais as informações de identidade são complementadas depende do tipo de armazenamento de identidades configurado no Tableau Server: site, Active Directory (AD) ou Lightweight Directory Access Protocol (LDAP).

- Para tipos de armazenamento de identidade do **AD**, as tabelas do Serviço de Identidade herdam apenas atributos não ambíguos ou atributos que não são armazenados no mesmo registro de banco de dados.
    
    Por exemplo, sAMAccountNAME e userPrincipalName (UPN) podem ser armazenados no mesmo registro de nome de uma tabela legada "systems\_users", que pode ocorrer como resultado de uma série complexa de regras. Na maioria dos casos, a migração é capaz de interpretar corretamente e migrar com êxito a identidade do usuário. No entanto, se a migração produzir resultados ambíguos, você deverá confirmar manualmente a ambiguidade ou resolver manualmente o conflito usando a página dedicada de migração de identidade. Para obter mais informações, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) .
- Para tipos de armazenamento de identidade **LDAP**, como tipos de armazenamento de identidade AD, as tabelas do Serviço de Identidade herdam apenas atributos não ambíguos. Na maioria dos casos, a migração é capaz de interpretar corretamente e migrar com êxito a identidade do usuário. No entanto, se a migração produzir resultados ambíguos, você deverá confirmar manualmente a ambiguidade ou resolver manualmente o conflito usando a página dedicada de migração de identidade. Para obter mais informações, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) .
- Para tipos de armazenamento de identidade **local**, as tabelas do Serviço de Identidade herdam os campos de usuário e domínio diretamente. Isso significa que nenhuma informação adicional ou resolução manual é exigida de você. Quando o Tableau Server é configurado para esse tipo de armazenamento de identidade, a migração de identidades de usuários ocorre após o processo de restauração de backup do Tableau Server.

## Desempenho da migração de identidade

### Etapa 1: antes de começar

Antes de começar, identifique abaixo o método de versão e upgrade do Tableau Server (se aplicável) para determinar as próximas etapas da migração de identidade.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">Fazer upgrade de</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">Upgrade para</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">Método de upgrade</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">Próximas etapas</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">n/a</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Versões do Tableau Server: 2022.1.0 (e posterior), 2022.3.0 (e posterior), 2023.1 (e posterior) e posterior</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Nova instalação</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Vá para a <a href="#step2">Etapa 2</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Versões do Tableau Server: 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Versões do Tableau Server: 2022.1.8 (e posterior), 2022.3.10 (e posterior), 2023.1.6 (e posterior) e posterior</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">n/a</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Você habilitou o novo esquema para login (ou seja, <code>wgserver.authentication.legacy_identity_mode.enabled -v false</code>)?</p><ul><li><p>Se não, vá para a <a href="#step2">Etapa 2</a>.</p></li><li><p>Se sim, vá para a <a href="#step6">Etapa 6</a>.</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Server versões: 2021.4.x ou anteriores</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Versões do Tableau Server: 2022.1.8 (e posterior), 2022.3.10 (e posterior), 2023.1.6 (e posterior) e posterior</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">n/a</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Vá para a <a href="#step2">Etapa 2</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3">Tableau Server versões: 2021.4.x ou anteriores</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3">Versões do Tableau Server: 2022.1.0-2022.1.7, 2022.3.0-2022.3.9 ou 2023.1.0-2023.1.5</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Se você estiver executando uma <b>atualização Azul/Verde ou atualizando</b> <b>manualmente</b> o Tableau Server 1) instalando o Tableau Server em uma nova máquina e 2) <b>fazendo backup e restaurando o Tableau Server usando os comandos <a href="https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm">tsm Maintenance (backup and restore)</a></b>, será necessário que você siga algumas etapas adicionais para iniciar a migração.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Vá para <a href="https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm" class="xref">Solucionar problemas com migração de identidade</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Se você estiver fazendo uma <b>atualização “in-loco” de servidor único ou de vários nós</b> do Tableau Server usando o método descrito aqui, não há etapas adicionais necessárias para iniciar a migração. A migração é iniciada após a conclusão da atualização do Tableau Server para a versão 2022.1 (ou posterior).</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Vá para a <a href="#step2">Etapa 2</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Se você estiver <b>atualizando manualmente</b> o Tableau Server 1) instalando o Tableau Server em uma nova máquina e 2) <b>exportando e importando informações de configuração e topologia usando os comandos <a href="https://help.tableau.com/current/server/pt-br/cli_settings_tsm.htm">tsm settings (exportar e importar)</a></b>, também não há etapas adicionais necessárias para iniciar a migração. A migração é iniciada após a conclusão do processo de importação na nova máquina do Tableau Server.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Vá para a <a href="#step2">Etapa 2</a>.</td></tr></tbody></table>

### Etapa 2: habilitar novo esquema e capacidade de login

Antes de iniciar a migração de identidade, o novo esquema de identidade deve ser habilitado pelo comando tsm [features.NewIdentityMode](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#identity_mode_new); e continuar permitindo o logon no Tableau Server enquanto o processo de migração de identidade ocorre pelos comandos tsm [wgserver.authentication.legacy\_identity\_mode.enabled](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#legacy_identity_mode) ou [tsm authentication legacy-identity-mode <commands>](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#tsm_identity_mig_legacy).

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute o seguinte comando:
    
    ```
    tsm configuration set -k features.NewIdentityMode -v true
    ```
3. Execute os seguintes comandos dependendo da versão do Tableau Server que você está executando:
    
    - Para as versões 2022.1.8 (e posteriores), 2022.3.10 (e posteriores), 2023.1.6 (e posteriores) e posteriores do Tableau Server:
        
        ```
        tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v true
        tsm pending-changes apply
        ```
    - Para as versões 2022.1.0-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server:
        
        ```
        tsm authentication legacy-identity-mode enable
        tsm pending-changes apply
        ```
    
    **Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado.

### Etapa 3: iniciar a migração de identidade

**Observação:** se você atualizou para as versões 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server, a migração de identidade será iniciada por padrão e você poderá pular para a [Etapa 4: concluir a migração de identidade](#step4).

Para iniciar a migração de identidade, deve-se ativar o recurso de migração de identidade usando o comando tsm [features.IdentityMigrationBackgroundJob](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#identity_migration).

1. Execute o seguinte comando:
    
    ```
    tsm configuration set -k features.IdentityMigrationBackgroundJob -v true
    ```

Após o início da migração de identidade, você verá uma notificação no Tableau Server que o vincula à página Migração de identidade. A página Migração de identidade é onde você pode monitorar o status da migração de identidade e dos conflitos de identidade que precisam ser resolvidos.

### Etapa 4: concluir a migração de identidade

**Observação**: pule esta etapa para novas instalações.

Para concluir a migração de identidade, todos os conflitos de identidade devem ser resolvidos ou reconhecidos antes que você possa habilitar o Serviço de identidade para Tableau Server.

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade para verificar se a migração foi iniciada.
    
    Você pode monitorar e gerenciar seu progresso usando a página dedicada de migração de identidade disponível na página Usuários do Tableau Server. Para obter mais informações, consulte [Gerenciar a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_manage.htm) .
3. Resolva ou reconheça todos os conflitos de identidade conforme descrito em [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) para que a guia Todas as falhas exiba "0" como na imagem abaixo.
    
    ![Resumo da migração de identidade mostrando zero falhas.](/tableau/current/pt-br/server/pt-br/Img/id_mig_failures_acknowledge.png)
4. Execute _um_ destes procedimentos:
    
    - Para executar o trabalho de migração de identidade agora, ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento e selecione Executar agora.
        
        ![Menu suspenso para editar o agendamento de migração com opções para desativar ou executar agora.](/tableau/current/pt-br/server/pt-br/Img/id_mig_overview_runnow.png)
    - Como alternativa, você pode aguardar a execução do trabalho de migração durante o próximo horário agendado.
5. Após a conclusão da migração, na página Migração de identidade, valide se a Visão geral da migração mostra 100% concluída.
    
    ![Barra de progresso da migração de identidade indicando 100% de conclusão.](/tableau/current/pt-br/server/pt-br/Img/id_mig_complete.png)

### Etapa 5: configurar o Tableau Server para usar o Serviço de identidade

Após a conclusão da migração de identidade, configure o Tableau Server para usar o Serviço de identidade .

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute os seguintes comandos dependendo da versão do Tableau Server que você está executando:
    
    - Para as versões 2022.1.8 (e posteriores), 2022.3.10 (e posteriores), 2023.1.6 (e posteriores) e posteriores do Tableau Server:
        
        ```
        tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
        ```
    - Para as versões 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server:
        
        ```
        tsm authentication legacy-identity-mode disable
        ```
    
    **Observação:** depois de executar um dos comandos acima, a página dedicada de Migração de identidade é removida e não está mais acessível. A página só é acessível quando `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled` is `true` ou `tsm authentication legacy-identity-mode` está ativado.

Depois que o Tableau Server é configurado para usar o Serviço de Identidade, quando os usuários entram no Tableau Server, o Tableau Server pesquisa suas identidades de usuário usando seus identificadores no repositório de identidades configurado. A partir dos identificadores, os identificadores exclusivos universais (UUID) são retornados e usados para corresponder às identidades de usuário existentes do Tableau Server. Esse processo gera sessões para os usuários e conclui o fluxo de trabalho de autenticação.

### Etapa 6: habilitar pools de identidade

Quando você tiver concluído a migração de identidade e habilitado o Serviço de Identidade, habilite o recurso de pools de identidade em preparação para a configuração de [pools de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_manage.htm).

1. Execute os seguintes comandos:
    
    ```
    tsm configuration set -k features.IdentityPools -v true
    tsm pending-changes apply
    ```

**Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado.

## Outros artigos nesta seção

<!-- document id=d54722fe8aaa0530c4354d83afed1a23efbf201c1e43bd771793776cb3b809ea url=/tableau/current/pt-br/server/itm_intro.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre o Tableau Advanced Management no Tableau Server

**Importante:** a partir de 16 de setembro de 2024, o Advanced Management não estará mais disponível como uma opção complementar independente. Os recursos do Advanced Management só estarão disponíveis se você o adquiriu anteriormente ou se você comprar determinadas edições de licença: Tableau Enterprise, Tableau Cloud+ ou Tableau+ Bundle (disponível para Tableau Cloud) ou Tableau Enterprise ou Tableau Server+ (disponível para Tableau Server).

O Tableau Advanced Management é uma coleção de recursos do Tableau Server, que fornece capacidades aprimoradas de segurança, gerenciamento e escalabilidade. Os recursos de Advanced Management estarão disponíveis se você tiver o Tableau Enterprise.

Observação: o Tableau Advanced Management inclui vários recursos do Tableau Server e duas ferramentas instaladas separadamente: Content Migration Tool do Tableau e Resource Monitoring Tool do Tableau. Para obter mais informações, consulte a [tabela de recursos](#feature_table) posteriormente neste tópico.

## Requisitos da licença Advanced Management

O Advanced Management é licenciado por implantação no Tableau Server, que pode ser com base no número de usuários ou de núcleos. Uma implantação inclui uma instalação de produção licenciada do Tableau Server e duas instalações licenciadas de não produção do Tableau Server, que oferecem suporte à instalação de produção. Para obter mais informações sobre a implantação, consulte a [Documentação do EULA](https://mkt.tableau.com/files/Documentation.pdf?_ga=2.77356117.133433043.1563398594-1734029830.1510592172).

- O Advanced Management só pode ser ativado em uma implantação licenciada do Tableau Server. Isso significa que o Tableau Server deve ser ativado pela primeira vez com uma chave válida baseada em usuário ou em núcleo, antes de aplicar a chave do produto Advanced Management. Para obter mais informações sobre como adquirir os recursos do Advanced Management e obter a chave do produto, entre em contato com o gerente de conta.
- Quando a chave do produto estiver ativa e habilitada, você poderá usar todos os recursos incluídos no Advanced Management.
- Quando a chave do produto do Advanced Management for removida ou desativada, você não poderá mais usar os recursos que exigem uma licença válida do Advanced Management. Qualquer dado associado não será excluído. Cada recurso pode ter pequenas diferenças quanto a o que acontece quando a licença expira. Para obter mais informações sobre os recursos individuais, use os links da tabela abaixo.

A tabela a seguir lista os recursos incluídos e exigem uma licença válida do Advanced Management:

<table style="width: 100%;" class="table--plain"><colgroup><col><col></colgroup><thead><tr><th>Recurso</th><th>Descrição</th><th>Requisitos para utilizar o recurso</th><th>Versão</th></tr></thead><tbody><tr><td><a href="https://help.tableau.com/current/server/pt-br/rmt-intro.htm" class="xref">Sobre Resource Monitoring Tool do Tableau</a></td><td>Fornece uma aparência mais abrangente da integridade do <span class="mc-variable Variables.ProductName variable">Tableau Server</span>. Com o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>, você pode identificar problemas que causam tempos de carregamento lentos, falhas de extração e outros problemas críticos, além de poder ajudá-lo a resolver proativamente os problemas que afetam a experiência do usuário final.</td><td>A instalação do <span class="mc-variable Variables.ProductName variable">Tableau Server</span> que você está monitorando deve ter uma licença do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span>.</td><td><p>Disponível em 2019.3 e posteriores.</p><p>O suporte ao Linux foi introduzido na versão 2020.4.</p></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/cmt-intro.htm" class="xref">Sobre Content Migration Tool do Tableau</a></td><td>O <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> fornece uma maneira fácil de copiar ou migrar o conteúdo entre projetos, sites e implantações do Tableau Server. Você pode fazer isso entre projetos, em instalações separadas do Tableau Server (por exemplo, entre uma instância de desenvolvimento e uma instância de produção do Tableau Server) ou entre projetos em uma única instalação do Tableau Server.</td><td><ul><li>A origem do Tableau Server (servidor de onde você está movendo o conteúdo) e o Tableau Server (servidor para onde você está movendo o conteúdo) deve ter uma licença válida do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span>.</li><li>A Content Migration Tool deve ser instalada em uma versão do Microsoft Windows que ofereça suporte para .NET 4.6.1 (Windows 7 ou posterior, Windows Server 2008R2 ou posterior).</li></ul></td><td>Disponível na versão 2019.3 e posterior.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/activity_log_overview.htm" class="xref">Registro de atividade</a></td><td>O Registro de atividades grava eventos de registro na pasta de registros do vizportal no disco rígido local para análise e auditoria adicionais.</td><td><p>O Tableau Server deve ter uma licença válida do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span> .</p></td><td>Disponível na versão 2022.3 e posterior.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_external_repo.htm" class="xref">Repositório externo do Tableau Server</a></td><td>Permite que você implante o Repositório do Tableau Server externo ao Tableau Server. O repositório do Tableau Server é um banco de dados do PostgreSQL que armazena os dados sobre todas as interações do usuário, atualizações de extração e muito mais.</td><td>O Tableau Server que está usando um repositório externo deve ter uma licença do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span>.</td><td><p>Disponível na versão 2019.3 e posterior.</p><p>- AWS compatível com a versão Tableau Server 2019.3 e posterior.</p><p>- Azure compatível com o Tableau Server versão 2020.4 e posterior.</p></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_node_roles.htm" class="xref">Gerenciamento de carga de trabalho por meio das funções de nó</a></td><td>Usando as funções de nó, é possível configurar onde certos tipos de cargas de trabalho são processados na instalação do Tableau Server. Os recursos das funções de nó permitem dedicar e dimensionar recursos para cargas de trabalho específicas (ex: atualizações de extração, assinaturas).</td><td>O Tableau Server deve ter uma licença válida do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span> .</td><td>Disponível na versão 2019.3 e posterior.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/security_kms.htm" class="xref">Sistema de gerenciamento de chaves do Tableau Server</a></td><td>Fornece a você funcionalidade adicional para configurar o Tableau Server para usar o AWS como KMS para criptografia de extração.</td><td>O Tableau Server deve ter uma licença válida do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span> .</td><td><p>Disponível na versão 2019.3 e posterior.</p><p>- AWS compatível com a versão Tableau Server 2019.3 e posterior.</p><p>- Azure compatível com o Tableau Server versão 2021.1 e posterior.</p></td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_external_filestore_storage.htm" class="xref">Armazenamento de arquivos externo do Tableau Server</a></td><td>Permite que você use armazenamento anexado à rede (NAS) como o Armazenamento de arquivos. Elimina a necessidade de executar o Armazenamento de arquivos localmente no Tableau Server</td><td>O Tableau Server deve ter uma licença válida do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span> .</td><td>Disponível na versão 2020.1 e posterior.</td></tr><tr><td>Limites de recursos do Processador em segundo plano do Tableau</td><td>O Gerenciador de Limites de Recursos do Tableau Server rastreia o uso de recursos de segundo plano em relação aos limites de recursos definidos para garantir que os limites de recursos sejam aplicados corretamente.</td><td>O Tableau Server deve ter uma licença válida do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span> .</td><td>Disponível na versão 2022.1 e posterior.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/server_tsig_overview.htm" class="xref">Tableau Server Independent Gateway</a></td><td>O Tableau Server Independent Gateway permite que você instale um proxy reverso gerenciado pelo Tableau Server em um computador separado. Instale o Independent Gateway em sua DMZ para fornecer segurança para a instalação do seu Servidor e todos os seus dados. O Independent Gateway pode ser usado em uma variedade de configurações e pode ser dimensionado para atender às demandas de conexão do cliente.</td><td>O Tableau Server deve ter uma licença válida do <span class="mc-variable Variables.ITM_name variable">Advanced Management</span> .</td><td>Disponível na versão 2022.1 e posterior.</td></tr></tbody></table>

## Ativação da chave do produto do Advanced Management

A licença do Advanced Management é aplicada a uma instalação do Tableau Server e pode ser usada para instalações baseada em usuário ou em núcleo.

Aqui está uma visão geral rápida sobre como ativar o Advanced Management na instalação do Tableau Server.

Usar a interface da Web do TSM

1. Abra o TSM em um navegador:
    
    https://<tsm-computer-name>:8850
2. Clique em **Licenciamento** na guia **Configuração**. Clique em **Ativar licença**.
3. Insira ou cole a chave do produto do Advanced Management e clique em **Ativar**.
4. Na página **Registrar**, insira suas informações de registro e clique em **Registrar**.
5. Siga os prompts e reinicie o Tableau Server após a conclusão do registro.
    
    **Observação:** se for uma nova instalação do Tableau Server e você aplicar a chave do Advanced Management antes de aplicar a chave do produto do Tableau Server, você verá um erro. No entanto, você pode continuar a instalação e aplicar a chave do produto do Tableau Server usando as mesmas etapas descritas acima.

Usar a CLI do TSM

1. Abra um prompt de comando como administrador em um nó no cluster do Tableau Server.
2. Execute o seguinte comando com a chave do produto do Advanced Management para ativar a licença:
    
    `tsm licenses activate -k <server-management-add-on-product key>`
    
    **Observação:** se for uma nova instalação do Tableau Server, execute o comando duas vezes, primeiro com a chave do produto do Tableau Server e, em seguida, com a chave do produto do Advanced Management.
3. Aplique as alterações e reinicie o servidor:
    
    `tsm pending-changes apply`

### Quem pode fazer isso

Somente os administradores do servidor podem ativaras chaves de licença do Advanced Management.

## Outros artigos nesta seção

<!-- document id=80017cb8bf3d77c13ec778eff51ee9123f7931797421cde9488a3c4ea26de000 url=/tableau/current/pt-br/server/dm_vconn_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre conexões virtuais e políticas de dados

As conexões virtuais são um tipo de conteúdo do Tableau, juntamente com fontes de dados, pastas de trabalho e fluxos, para ajudar você a ver e compreender seus dados. As conexões virtuais fornecem um ponto de acesso central aos dados. Outro recurso importante introduzido com as conexões virtuais são as políticas de dados, que oferecem suporte à segurança de linha no nível de conexão, em vez de na pasta de trabalho ou no de fonte de dados. As políticas de segurança de dados em nível de linha são aplicadas a qualquer pasta de trabalho, fonte de dados ou fluxo que usa a conexão virtual.

Uma conexão virtual pode acessar várias tabelas em vários bancos de dados. As conexões virtuais permitem que você gerenciem a extração de dados e a segurança em um só lugar, no nível da conexão.

![O diagrama mostra como as conexões virtuais gerenciam centralmente a conexão e a segurança](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_diagram_centralized.png)

Para obter informações sobre opções de segurança em nível de linha, consulte [Visão geral das opções de segurança em nível de linha no Tableau](https://help.tableau.com/current/server/pt-br/rls_options_overview.htm) na ajuda do Tableau Server.

Nem toda conexão virtual tem uma política de dados associada. Você também pode usar uma conexão virtual simplesmente como um local central para gerenciar credenciais de conexão.

## Termos-chave

- Conexão virtual. Um recurso compartilhável que fornece um ponto de acesso central aos dados.
- Conexão. O nome do servidor, banco de dados e credenciais que você usa para acessar os dados. Uma conexão virtual tem uma ou mais conexões. Cada conexão acessa um banco de dados ou arquivo.
- Tabela de conexão virtual. Uma tabela em uma conexão virtual.
- Política de dados. Uma política aplicada a uma ou mais tabelas em uma conexão virtual para filtrar dados para usuários. Por exemplo, use uma política de dados para aplicar segurança em nível de linha a tabelas em uma conexão virtual.
- Tabela de políticas. Uma tabela de fatos ou dados em uma política de dados que é filtrada.
- Coluna de política. Uma coluna usada para filtrar os dados nas tabelas de política. Uma coluna de política pode estar em uma tabela de política ou em uma tabela de direitos.
- Tabelas de direitos. Uma tabela que inclui uma coluna de política que você pode usar para filtrar tabelas de política e outra coluna que você pode relacionar (mapear) a uma coluna em uma tabela de política.
- Condição de política. Uma expressão ou cálculo que é avaliado para cada linha no momento da consulta. Se a condição da política for TRUE, a linha será mostrada na consulta.

## Licenciar conexões virtuais e políticas de dados

As conexões virtuais e as políticas de dados são licenciadas por meio do Data Management. Para obter informações sobre como o licenciamento do Data Management funciona, veja [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).

## Habilite conexões virtuais e políticas de dados

Conexões virtuais e políticas de dados são habilitadas automaticamente no Tableau Server e Tableau Cloud com Data Management.

## Permissões

As permissões para conexões virtuais funcionam de forma muito semelhante às permissões para outro conteúdo do Tableau. Depois de publicar uma conexão virtual, qualquer pessoa pode ver a conexão. No entanto, apenas o criador da conexão e os administradores podem acessar os dados usando a conexão, até que o criador da conexão conceda explicitamente mais permissões.

Ao criar uma conexão virtual, você deve definir as permissões para o recurso Conectar para permitir que outros usuários se conectem aos dados usando a conexão virtual. O recurso Conectar permite compartilhar uma conexão virtual e permite que os usuários a consultem. Com permissões de conexão, um usuário pode visualizar as tabelas em uma conexão virtual e criar conteúdo usando as tabelas. Para obter mais informações, consulte [Definir permissões em uma conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_publish_save.htm#set-perms).

### Permissões x políticas de dados

As permissões definem o que uma pessoa pode ou não fazer com um conteúdo no Tableau. As permissões são compostas por recursos, a capacidade de realizar ações como exibir conteúdo, editar na Web, baixar fontes de dados ou excluir conteúdo. As regras de permissão definem quais recursos são permitidos ou negados para um usuário ou grupo em uma parte do conteúdo. A interação entre nível de licença, função de site e potencialmente múltiplas regras de permissão afetam a determinação final do que uma pessoa pode ou não fazer – as permissões efetivas. Consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm) para obter detalhes.

As políticas de dados filtram os dados na conexão virtual, garantindo que as pessoas vejam apenas os dados que deveriam ver. Uma política de dados é aplicada e filtra os dados quando são exibidos no conteúdo do Tableau (por exemplo, uma pasta de trabalho ou fluxo). A condição de política em uma política de dados é um cálculo ou expressão que define o acesso aos dados. As funções de usuário costumam ser usadas para limitar o acesso a usuários ou grupos por meio de funções de usuário. O acesso pode ser baseado no nome de usuário, no grupo ao qual um usuário pertence ou em um valor de região. Consulte [Criar uma política de dados para segurança em nível de linha](https://help.tableau.com/current/server/pt-br/dm_vconn_create_rlspolicy.htm) para obter detalhes.

Ambas as permissões e as políticas de dados regem o acesso. Simplificando, as permissões determinam qual _conteúdo_ você pode ver, acessar, usar ou criar; as políticas de dados determinam quais _dados_ você pode ver.

#### Como as permissões e as políticas de dados funcionam juntas

As permissões do Tableau são aplicadas primeiro ao conteúdo do Tableau. As pessoas só podem fazer o que têm capacidade para fazer com o conteúdo do Tableau — as políticas de dados não substituem as permissões do Tableau. Depois que as permissões são avaliadas, a política de dados é aplicada para determinar quais dados na conexão virtual a pessoa pode ver com base na condição da política.

O exemplo a seguir descreve os efeitos de permissões e políticas de dados em uma conexão virtual que contém dados de salário:

- A conexão virtual está no projeto de RH, que é restrito aos usuários do Tableau no grupo de RH. Qualquer pessoa fora do grupo de RH não pode ver o conteúdo no projeto de RH, o que significa que não pode navegar, conectar ou visualizar a conexão virtual.
- A conexão virtual tem permissões de conexão concedidas apenas aos membros do grupo HR Business Partners. Todos os outros no grupo de RH podem ver que a conexão virtual existe, mas não podem ver os dados que ela contém. Quando eles exibem uma pasta de trabalho que usa essa conexão virtual, eles não podem ver nenhum dado.
- A conexão virtual também contém uma política de dados que filtra os dados salariais com base no usuário individual, para que os Parceiros de negócios de RH possam ver apenas as linhas que pertencem aos funcionários em sua unidade de negócios. Quando eles exibem uma pasta de trabalho que usa essa conexão virtual, eles veem os dados apenas para sua unidade de negócios.

## Recursos e funcionalidades

Para o gerenciador de dados, as conexões virtuais fornecem:

- **Contas de serviço gerenciadas com segurança.** Se você usar um modelo de “conta de serviço”, agora, em vez de ter que compartilhar as informações da conta de serviço com qualquer usuário que deseja acessar esses dados, pode fornecer as credenciais da conta de serviço aos poucos analistas com poderes para criar conexões virtuais.
- **Gerenciamento ágil de banco de dados físico.** Você precisa fazer alterações no banco de dados (por exemplo, um campo é adicionado ou o nome da tabela é alterado) apenas uma vez na conexão virtual, em vez de em cada parte do conteúdo onde os dados são usados.
- **Proliferação de dados reduzida.** Gerenciando centralmente os agendamentos de atualização de extração, as atualizações são agendadas uma vez, garantindo que qualquer pessoa que acessar os dados dessa conexão virtual veja os dados atualizados.
- **Segurança em nível de linha centralizada.** Você pode criar políticas de dados que aplicam segurança em nível de linha para extrações do Tableau e consultas em tempo real no nível de conexão. As políticas de dados são aplicadas a qualquer pasta de trabalho, fonte de dados ou fluxo que usa a conexão virtual.

**Observação:** as políticas de dados são válidas para dados de entrada de fluxo, mas não para dados de saída de fluxo. Os usuários com acesso aos dados de saída de fluxo verão todos os dados, e não apenas um subconjunto deles que pertence apenas aos usuários.

Como usuário de dados, você se beneficia de conexões virtuais sabendo que tem:

- **Acesso apropriado** apenas aos dados que você deve ver, porque a segurança em nível de linha já está aplicada a eles.
- **Flexibilidade** para usar dados que foram selecionados e protegidos. A conexão virtual armazena e compartilha as informações de conexão. Tudo que você precisa fazer é criar uma fonte de dados com um modelo de dados específico para o que for necessário.
- **Confie** que os dados são novos porque a agenda de atualização de extração já foi definida.
- A capacidade de **compartilhar** conteúdo livremente, garantido que você não colocará a segurança em risco, porque as políticas de dados são sempre aplicadas.

## Fluxo de trabalho do editor de conexão virtual

O editor de conexão virtual permite que você crie:

- Conexões virtuais, que são um tipo de conteúdo do Tableau que fornece um ponto de acesso central compartilhável para dados.
- Políticas de dados que oferecem suporte à segurança em nível de linha no nível de conexão.

Depois de criar uma conexão virtual e as políticas de dados associadas, você pode publicá-la e definir as permissões para compartilhar com outros usuários. Você também pode agendar atualizações de extração para que todo o conteúdo que usa a conexão virtual acesse dados novos.

O diagrama a seguir mostra o fluxo de trabalho para criar uma conexão virtual. A qualquer momento durante o processo, você pode publicar ou salvar um rascunho de sua conexão, mas a conexão deve ser publicada antes de agendar atualizações de extração ou usar (ou editar) uma conexão virtual. Você também deve definir permissões antes que outras pessoas possam usar a conexão.

![Diagrama de fluxo de trabalho para criar uma conexão virtual](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_workflow_diagram.png)

Clique em uma etapa do processo para ir para esse tópico de ajuda.

## Próxima etapa

A primeira etapa é [Criar uma conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_create_conn.htm).

## Outros artigos nesta seção

<!-- document id=b940100e97125a236fd036117d9c1e6589e3c0c640279ea4f5afd32b65e28340 url=/tableau/current/pt-br/server/cmt-intro.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre Content Migration Tool do Tableau

Este conjunto de artigos fornece orientações sobre a configuração, o uso e a manutenção do Content Migration Tool do Tableau.

**Observação**: o Content Migration Tool do Tableau não é recomendado para migrações ao mover do Tableau Server para o Tableau Cloud. Para migrar do Tableau Server para o Tableau Cloud, use o [SDK de migração do Tableau](https://help.tableau.com/current/api/migration_sdk/pt-br/index.html). Para casos de uso recomendados do Content Migration Tool do Tableau, veja [Casos de uso do Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-use-cases.htm#cmt-use-cases)

## O que é Content Migration Tool?

O Content Migration Tool fornece uma maneira fácil de copiar ou migrar o conteúdo entre locais do Tableau Server. Você pode fazer isso entre locais em uma única instalação do Tableau Server, ou se você tiver um licenciamento baseado em usuário, entre locais em instalações separadas (por exemplo, entre uma instalação de desenvolvimento do Tableau Server e uma instalação de produção). A interface de usuário do Content Migration Tool explica as etapas necessárias para criar um “plano de migração”, que pode ser usado uma vez ou como modelo para várias migrações.

Antes de migrar conteúdo, recomendamos revisar a seção [Governança de conteúdo](https://help.tableau.com/current/blueprint/pt-br/bp_governance_in_tableau.htm#content-governance-in-tableau) no blueprint do Tableau.

## Ajuda e suporte

Se você tiver problemas que não podem ser resolvidos com esta documentação, contate o [Suporte Técnico do Tableau](http://www.tableau.com/pt-br/support/request).

## Outros artigos nesta seção

<!-- document id=0f65344c4303112de68cf2d0b0326bf3ee3cf5f939c368ca57e57e81f07e7b77 url=/tableau/current/pt-br/server/dm_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre Data Management

**Importante:** a partir de 16 de setembro de 2024, o Dados Management não estará mais disponível como uma opção complementar independente. Os recursos do Data Management só estarão disponíveis se você o adquiriu anteriormente ou se você comprar determinadas edições de licença: Tableau Enterprise, Tableau Cloud+ ou Tableau+ Bundle (disponível para Tableau Cloud) ou Tableau Enterprise ou Tableau Server+ (disponível para Tableau Server).

Data Management é uma coleção de recursos e funcionalidades que ajudam os clientes a gerenciar conteúdo do Tableau e ativos de dados em seu ambiente Tableau Server ou Tableau Cloud.

A partir de 2019.1 do Tableau Server, o Tableau Prep Conductor está disponível para implantações do Tableau Server no local e na versão 2019.3, o Tableau Prep Conductor está disponível para as implantações do Tableau Cloud. Você pode usar o Tableau Prep Conductor para agendar e monitorar fluxos.

A partir do Tableau 2019.3, o Tableau Catalog está incluído no Data Management, disponibilizando uma variedade de recursos adicionais no espaço de gerenciamento de dados. Você pode usar Tableau Catalog para descobrir dados, selecionar ativos de dados, comunicar a qualidade dos dados, executar análises de impacto e rastrear a linhagem dos dados usados no conteúdo do Tableau.

A partir do Tableau 2021.4, mais recursos de governança e segurança foram adicionados ao Data Management: conexões virtuais e políticas de dados. Usando o editor de conexão virtual, você pode criar:

- Conexões virtuais que fornecem um ponto de acesso central compartilhável para dados.
- Políticas de dados para aplicar segurança em nível de linha no nível de conexão.

## Recursos do Data Management

A tabela a seguir lista os recursos para Data Management, incluindo:

- Tableau Catalog
- Tableau Prep Conductor
- Conexões virtuais
- Políticas de dados

### Tableau Catalog

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th><strong>Recurso</strong></th><th colspan="2">Descrição</th></tr></thead><tbody><tr><td><a href="https://help.tableau.com/current/server/pt-br/dm_perms_assets.htm#perms" class="xref">Permissões para metadados</a></td><td colspan="2">O <span class="mc-variable Variables.DM_catalog variable">Tableau Catalog</span> permite controlar quem pode ver e gerenciar ativos externos e quais metadados são mostrados por meio da linhagem, definindo permissões.</td></tr><tr><td>Experiência de conexão expandida - descoberta de dados</td><td colspan="2">Se você cria na Web ou no <a href="https://help.tableau.com/current/pro/desktop/pt-br/examples_tableauserver.htm" target="_blank">Tableau Desktop</a>, agora você pode procurar e conectar-se aos bancos de dados e tabelas específicos usados pelas fontes de dados publicadas e pastas de trabalho no site do <a href="https://help.tableau.com/current/server/pt-br/creator_connect.htm" target="_blank">Tableau Server</a> ou do <a href="https://help.tableau.com/current/online/pt-br/creator_connect.htm" target="_blank">Tableau Cloud</a>.</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/search.htm">Pesquisa expandida</a></td><td colspan="2">O <span class="mc-variable Variables.DM_catalog variable">Tableau Catalog</span> expande a pesquisa para incluir resultados com base em colunas, bancos de dados e tabelas.</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/tags.htm" target="_blank">Marcar ativos externos</a></td><td colspan="2">Você pode categorizar itens no Tableau Server e no Tableau Cloud com marcas, ajudando os usuários a filtrar ativos externos (bancos de dados, arquivos, tabelas e colunas).</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/datasource_certified.htm" target="_blank">Certificar bancos de dados e tabelas</a></td><td colspan="2">Ajude os usuários a encontrar dados confiáveis que atendam aos padrões definidos, certificando bancos de dados e tabelas.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/dm_dqw.htm">Definir avisos de qualidade de dados</a></td><td colspan="2">Você pode definir os avisos de qualidade de dados para alertar os usuários sobre problemas de qualidade de dados, como dados obsoletos ou preteridos.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/dm_lineage.htm" target="_blank">Análise de linhagem e impacto</a></td><td colspan="2">A ferramenta Linhagem rastreia a fonte de dados. Você pode usá-la para analisar o impacto das alterações nos dados, identificar quais usuários podem ser impactados e <a href="https://help.tableau.com/current/server/pt-br/dm_lineage.htm#email" target="_blank">enviar e-mail para os proprietários</a> de uma pasta de trabalho, fonte de dados, fluxo ou contatos de um banco de dados ou tabela sobre as atualizações relacionadas aos dados.  </td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/data_explore_analyze_interact.htm#use-data-details-to-see-visualization-information">Detalhes de dados</a></td><td colspan="2">Permita que os usuários entendam melhor uma visualização publicada ao consultar informações sobre os dados utilizados.</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/qs_content_page.htm#add-or-edit-descriptions">Adicionar descrições aos ativos</a></td><td colspan="2">Ajude os usuários a encontrar os dados que estão procurando ao adicionar descrições a bancos de dados, tabelas e colunas.</td></tr><tr><td rowspan="3">Recursos do desenvolvedor</td><td>REST API do Tableau - <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_metadata.htm" target="_blank">métodos de metadados</a></td><td>Adicionar, atualizar e remover ativos externos programaticamente; e adicionar metadados ao conteúdo do Tableau e ativos externos como descrições.</td></tr><tr><td><a href="https://help.tableau.com/current/api/metadata_api/pt-br/index.html" target="_blank">API de metadados do Tableau</a></td><td>Consulte programaticamente os metadados do conteúdo publicado no Tableau Server ou no Tableau Cloud. Atualize programaticamente determinados metadados usando os <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_metadata.htm" target="_blank">métodos de metadados</a> na API REST do Tableau Server. <br><b>Observação:</b> a API de metadados não requer <span class="mc-variable Variables.DM_sku variable">Data Management</span>.</td></tr><tr><td><a href="https://help.tableau.com/current/api/metadata_api/en-us/docs/meta_api_start.html#explore-the-metadata-api-schema-using-graphiql" target="_blank">GraphiQL</a></td><td>Explorar e testar consultas em relação ao esquema de API de Metadados usando uma ferramenta interativa no navegador chamada GraphiQL. <br><b>Observação:</b> GraphiQL não requer <span class="mc-variable Variables.DM_sku variable">Data Management</span>.</td></tr></tbody></table>

### Tableau Prep Conductor

| Recurso | Descrição |
| --- | --- |
| Agendar tarefas de fluxo na ajuda do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_online_schedule_flow_task.htm) ou [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm). | É possível criar tarefas de fluxo agendadas para executar um fluxo em um momento específico ou regularmente. |
| [Monitorar integridade e desempenho do fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_monitor_flow.htm) | Configure as notificações por e-mail no site ou no servidor quando ocorrerem falhas de fluxo, visualize e retome as tarefas de fluxo suspensas e visualize os erros e alertas. |
| [Exibições administrativas para fluxos](https://help.tableau.com/current/server/pt-br/prep_conductor_admin_views.htm) | Use as Exibições administrativas para monitorar as atividades relacionadas aos fluxos, ao histórico de desempenho e ao espaço em disco usado no servidor ou no site. |
| REST API do Tableau - [métodos de fluxo](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_flow.htm) | Agenda fluxos de forma programática. |

### Conexões virtuais e políticas de dados

| Recurso | Descrição |
| --- | --- |
| [Criar uma conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_create_conn.htm) | Um tipo de conteúdo do Tableau que permite criar uma conexão reutilizável compartilhável com dados selecionados. |
| [Criar uma política de dados para segurança em nível de linha](https://help.tableau.com/current/server/pt-br/dm_vconn_create_rlspolicy.htm) | Use o editor de conexão virtual para criar políticas de dados com condições de política que aplicam segurança em nível de linha aos dados no nível da conexão. |
| [Testar a segurança em nível de linha com visualização como usuário](https://help.tableau.com/current/server/pt-br/dm_vconn_test_preview.htm) | Teste a política de dados com Visualização como usuário para garantir que os usuários possam ver apenas os próprios dados. |
| [Agendar atualizações de extração para uma conexão virtual](https://help.tableau.com/current/server/pt-br/dm_vconn_extract.htm) | Crie uma agenda de atualização de extração para as tabelas em sua conexão, garantindo que os dados sejam atualizados para qualquer conteúdo que use essa conexão virtual. |

## Outros artigos nesta seção

<!-- document id=8b5609b7fd521641972b98c228b1e44d6a7023947ff900198c5bbee3e18af9e7 url=/tableau/current/pt-br/server/datasource_mfr_multiple_base_tables.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre modelos de dados de relação de vários fatos

Relações multifatoriais permitem criar fontes de dados com mais de uma _tabela base_. O uso de várias tabelas base em seu modelo de dados permite realizar análise de vários fatos no Tableau.

Ao estabelecer _árvores_ de tabelas, enraizadas em uma tabela base, você pode modelar estruturas de dados com diferentes domínios conceituais e usar suas características compartilhadas para conectá-las. Esse tipo de análise costuma ser chamada de análise de vários fatos, dimensões conformadas ou dimensões compartilhadas. No Tableau, chamamos isso de modelo de dados de relações multifatoriais porque você usa relações para construí-lo. Um modelo de dados de relações multifatoriais sempre contém diversas tabelas base. As tabelas base são as tabelas mais à esquerda no modelo de dados. Para obter orientação sobre como determinar quais tabelas usar como tabelas base, consulte [Quando usar um modelo de relação de vários fatos](https://help.tableau.com/current/server/pt-br/datasource_mfr_when_to_use.htm).

![um modelo de tabela base múltipla com uma árvore destacada](/tableau/current/pt-br/server/pt-br/Img/mfr_build_highlightedtree.png)

Um modelo de dados de múltiplas tabelas base com a árvore de uma tabela base destacada.

## Níveis de relações

Os modelos de dados com múltiplas tabelas base têm muita flexibilidade em relação à maneira como os dados podem se relacionar – ou não – entre si.

**Observação**: a relação em qualquer nível só é relevante em modelos de dados com múltiplas tabelas base. Antes dos modelos de dados de relações multifatoriais, ou tudo estava relacionado (uma única fonte de dados) ou nada estava (combinação de várias fontes de dados).

**Relações no modelo de dados**

As tabelas são relacionadas, não relacionadas ou compartilhadas com base na estrutura do modelo de dados. Em uma fonte de dados, a relação das tabelas é uma constante. Como uma breve visão geral: 

- _Tabelas relacionadas_ estão na mesma árvore.
    - Antes de 2024.2, todas as fontes de dados eram fontes de dados de tabela base única que consistiam em uma única árvore e, em uma única fonte de dados de tabela base, todas as tabelas estavam relacionadas.
- _Tabelas não relacionadas_ estão em árvores diferentes. As tabelas base sempre não estão relacionadas entre si. As tabelas que estão abaixo de exatamente uma tabela base também não estão relacionadas às tabelas em outras árvores.
- _Tabelas compartilhadas_ têm várias relações de entrada e pertencem a mais de uma árvore.
    - As tabelas downstream de uma tabela com várias relações de entrada também são consideradas compartilhadas.

**Relações durante a análise**

Os campos podem ser relacionados, não relacionados, ainda não relacionados, relacionados de forma ambígua ou podem atuar como campos de junção. A relação entre um grupo de campos é determinada a cada planilha com base na estrutura do modelo de dados, quais campos estão ativamente em uso (ou seja, nas divisórias como pílulas) e se esses campos são dimensões ou medidas.

![uma visualização simples com dois campos não relacionados, um em linhas e outro em colunas, e uma dica de ferramenta não relacionada mostrando](/tableau/current/pt-br/server/pt-br/Img/mfr_unrelatedtooltip_example.png)

Para fazer uma visualização com campos de várias tabelas, o Tableau precisa fazer uniões de colunas nos bastidores para calcular os valores. O tipo de união de coluna usada depende da [relação entre os campos](#fieldlevel). Como uma breve visão geral: 

- Quando _Campos relacionados_ são usados em uma visualização, as dimensões são unidas internamente e os valores de medida são divididos pelas dimensões.
    - É um pouco mais complicado do que isso, podem ser necessárias uniões de colunas adicionais nos bastidores para garantir que [nenhum valor de medida seja descartado](https://www.tableau.com/pt-br/blog/relationships-tableau-data-model). Mas em uma visualização apenas de dimensão, as dimensões relacionadas são unidas internamente, e esse é o conceito principal aqui.
    - Este é o mesmo comportamento dos modelos de tabela de base única.
- Quando _campos não relacionados_ ![](/tableau/current/pt-br/server/pt-br/Img/mfr_icon_unrelated.png "ícone não relacionado") são usados em uma visualização, as dimensões são unidas de forma cruzada. Os valores de medida têm escopo na tabela (ou seja, são agregados localmente em um único valor para toda a tabela) e repetidos.
    - Também é possível que os campos sejam _ainda não relacionados_ ou _ambiguamente_ relacionados, o que significa que para a combinação dos campos ativos existe mais de uma forma de resolver as relações entre suas tabelas. Se o Tableau encontrar incerteza, ele tratará os campos como não relacionados.
- Quando os campos são _unidos_ ![](/tableau/current/pt-br/server/pt-br/Img/MFR_icon_related.png "ícone de união") com base em um campo compartilhado, as uniões de colunas das dimensões são externas. Os valores de medida são agregados no nível de quaisquer dimensões pelas quais possam ser divididos e possam ser repetidos.
    - _Dimensões de união_ são semelhantes a [vinculando campos na combinação de dados](https://help.tableau.com/current/pro/desktop/pt-br/multiple_connections.htm#define-blend-relationships-for-blending). Os resultados são calculados para cada par de campos relacionados e, em seguida, os valores não relacionados são unidos aos valores compartilhados da dimensão compartilhada entre eles.

Todos esses conceitos e definições são discutidos com mais detalhes posteriormente neste tópico.

Um observação sobre dimensões e medidas

No quadro, _medidas_ são _agregações_ – elas são agregadas até a _granularidade_ definida pelas _dimensões_ na exibição. O valor de uma medida depende, portanto, do contexto das dimensões. Por exemplo, “número de caixas de cereais” depende se nos referimos ao estoque total ou ao número de caixas por marca.

_Dimensões_ geralmente são campos categóricos, como país ou marca. No Tableau, as dimensões definem a granularidade ou o _nível de detalhe_, da exibição. Normalmente, queremos agrupar nossos dados em marcas por alguma combinação de categorias. As dimensões que usamos para criar a exibição determinam quantas marcas temos.

Quando uma medida é usada sem dimensões, diz-se que é _escopo da tabela_. Isso significa que seu valor é o valor totalmente agregado de toda a tabela. Assim que usamos uma dimensão como marca na visualização, a medida é detalhada de forma mais granular. O número total de caixas de cereais passou a ser por marca.

_Agregação_ refere-se a como os dados estão combinados. A agregação padrão do Tableau é SUM. Você pode alterar a agregação para outras opções, incluindo: média, mediana, contagem distinta, mínimo e assim por diante. _Granularidade_ refere-se ao quão detalhada ou detalhada é a medida – o que é controlado pelas dimensões. A menos que a granularidade da medida esteja no nível da linha (também conhecida como desagregada), seu valor deverá ser agregado.

#### Exemplo

![uma tabela de valores para o número de caixas de cereais, em cinco marcas e três tamanhos de caixas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_cereal_rawdata.png)

Qual é o valor de “número de caixas de cereal?”

Bem, isso depende do tipo de agregação e da granularidade definida pelas dimensões.

- Agregações:
    - Soma (ou total)
    - Média
- Granularidade:
    - Escopo da tabela/totalmente agregada (as barras azuis no exemplo)
    - Dividido pela dimensão **Marca** (as barras coloridas no exemplo)

![Um painel com quatro visualizações, uma para o número de caixas no escopo da tabela resumida (54), uma com o número médio de caixas no escopo da tabela (6) e, em seguida, versões dessas duas divididas pelas cinco marcas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_cereal.png)

## Indicadores de relação em nível de campo

Existem diversas dicas visuais que podem ajudá-lo a entender o grau de parentesco dos campos que você está usando em uma análise.

### Indicadores de relações em uma planilha

- **Ícone não relacionado**: o Tableau usa um ícone não relacionado ![ícone não relacionado](/tableau/current/pt-br/server/pt-br/Img/mfr_icon_unrelated.png) para indicar que nem tudo na visualização está relacionado. Se você vir um ícone não relacionado em uma pílula na exibição ou no painel Dados, passe o mouse sobre o ícone [para obter mais informações](https://help.tableau.com/current/pro/desktop/pt-br/mfr_relatedness_messages.htm).
    - O ícone relacionado ![](/tableau/current/pt-br/server/pt-br/Img/MFR_icon_related.png "ícone de união") indica que o campo está unindo campos não relacionados.
- **Nomes de campos em cinza claro**: os nomes dos campos são exibidos em texto cinza claro no painel Dados quando não estão relacionados a _qualquer_ campos em uso nas divisórias. Você ainda pode usar esses campos para análise nessa visualização, mas os campos não relacionados são [avaliado de forma diferente](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#joinsbyrelatedness) na análise do que campos relacionados. Ao passar o mouse, esses campos também exibem um ícone não relacionado.

![o painel de dados, com uma tabela inteira esmaecida e dois campos com o ícone de olho cortado para campos ocultos](/tableau/current/pt-br/server/pt-br/Img/mfr_gray_datapane.png)

**Observação**: nas versões anteriores do Tableau, os nomes dos campos em cinza claro indicavam que os campos estavam ocultos e Mostrar campos ocultos foi selecionado. Os campos ocultos, quando exibidos, agora são indicados com um ícone de olho clicável ![ícone de campo oculto](/tableau/current/pt-br/server/pt-br/Img/mfr_icon_hidden.png).

### Caixa de diálogo de aviso de relação

Quando campos não relacionados são usados com uma visualização, o Tableau mostra uma caixa de diálogo de aviso para informar que os campos não estão relacionados. Este aviso aparece sempre que você adiciona um campo não relacionado para evitar junções cruzadas acidentais que podem afetar o desempenho.

- Se você quiser usar campos não relacionados sem costura, clique em Adicionar para continuar adicionando o campo à visualização.
- Se você quiser unir campos não relacionados, uma prática recomendada é destacar o campo de união antes de um campo não relacionado. A caixa de diálogo não será exibida se o campo de união já estiver em uso. Consulte [Como as uniões de colunas são usadas para cada nível de relacionamento](#joinsbyrelatedness) para obter mais informações sobre como a união evita uniões de coluna cruzadas.

![a caixa de diálogo de aviso de relação mostrando um aviso para dimensões não relacionadas](/tableau/current/pt-br/server/pt-br/Img/mfr_unrelated_dialog_simple_v2.png)

Se vários campos estiverem sendo adicionados ou já estiverem presentes na visualização, a área Detalhes aparece na caixa de diálogo. Expanda-a para ver mais informações sobre a relação de todos os campos em uso e identifique de onde vem o problema de não relação.

![a caixa de diálogo de aviso de relação com uma mensagem para dimensões e medidas não relacionadas e com a área Detalhes expandida](/tableau/current/pt-br/server/pt-br/Img/mfr_unrelated_dialog_details_v2.png)

Para impedir que a mensagem de aviso apareça, selecione a opção Não mostrar isso novamente. Você sempre pode reativar essas mensagens de aviso ativando-as novamente:

- Em Tableau Desktop, abra o menu Ajuda > Configurações e desempenho > Redefinir mensagens ignoradas.
- Em um navegador, limpe seus dados em cache. Por exemplo, no Chrome, abra o **menu de 3 pontos** > **Excluir dados de navegação...** > Escolha “**Imagens e arquivos armazenados em cache**” > **Apagar dados**.

## Relação em nível de tabela no modelo de dados

Em um modelo de dados com múltiplas tabelas base, cada tabela base define um conjunto de tabelas que estão relacionadas e formam uma _árvore_ conceitual. Essas árvores devem estar conectadas por pelo menos uma tabela compartilhada para garantir que a fonte de dados geral seja uma entidade única.

O que anteriormente poderiam ter sido duas fontes de dados combinadas usando campos de vinculação, agora pode ser uma única fonte de dados com duas árvores, conectadas pelas tabelas compartilhadas que contêm esses campos comuns.

![dois modelos de dados, um composto por duas fontes de dados distintas, uma das duas fontes de dados sobrepostas às tabelas que têm em comum para formar uma única fonte de dados](/tableau/current/pt-br/server/pt-br/Img/mfr_blending_comparison.png)

> [!TIP]
> 
> **Dica**: o modo como as tabelas são relacionadas no modelo de dados impacta o modo como seus campos podem ser relacionados na análise. Pode ser útil usar a caixa de diálogo [Exibir modelo de dados](https://help.tableau.com/current/pro/desktop/pt-br/viewdatamodel.htm) durante a análise para ver como uma tabela se ajusta ao modelo de dados geral.

Vamos conferir quais tabelas estão relacionadas, não relacionadas ou compartilhadas usando este exemplo de fonte de dados. Existem duas árvores, uma estabelecida pela Tabela base A e outra pela Tabela base B.

### Tabelas não relacionadas

As tabelas base não estão fundamentalmente relacionadas. Da mesma forma, quaisquer tabelas que existam somente em uma única árvore não estão relacionadas às tabelas de outras árvores.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>Tabela A e Tabela X não estão relacionadas</p></td><td><p>Tabela B e Tabela X não estão relacionadas</p></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_tables_unrelatedbase.png" alt="Um modelo de dados onde as tabelas base A e X têm seus próprios contornos. As relações são mostradas em cinza claro."></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_tables_unrelateddownstream.png" alt="Um modelo de dados onde as tabelas base A e sua tabela downstream B compartilham um contorno. A tabela base X tem seu próprio contorno. As relações são mostradas em cinza claro."></td></tr></tbody></table>

### Tabelas relacionadas

As tabelas na mesma árvore são consideradas relacionadas.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>Tabela A e Tabela S estão relacionadas</p></td><td><p>A Tabela B e a Tabela S estão relacionadas (por meio da Tabela A)</p></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_tables_related1.png" alt="Um modelo de dados onde a relação da Tabela base A com uma tabela downstream é enfatizada"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_tables_related2.png" alt="Um modelo de dados em que a relação da Tabela B com outra tabela é enfatizado pelas relações com a mesma tabela base, A"></td></tr></tbody></table>

### Tabelas compartilhadas

As tabelas compartilhadas têm várias relações de entrada. Essas tabelas pertencem a diversas árvores e são compartilhadas entre elas.

A Tabela S e a Tabela T são compartilhadas.

![Um modelo de dados em que as tabelas S e T têm vários relacionamentos de entrada. Ambos pertencem à árvore da tabela base A e à árvore da tabela base X. ](/tableau/current/pt-br/server/pt-br/Img/mfr_relatedness_tables_shared.png)

## Relação em nível de campo na análise

A relação entre os campos é determinada a cada planilha com base na [estrutura do modelo de dados,](https://help.tableau.com/current/pro/desktop/pt-br/viewdatamodel.htm) quais campos estão ativamente em uso (ou seja, quais campos estão na visualização como comprimidos nas divisórias) e se esses campos são dimensões ou medidas. O modo como a relação de campo afeta os resultados de uma visualização é abordado [na próxima seção](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm#joinsbyrelatedness).

Vamos examinar alguns cenários usando a mesma fonte de dados de exemplo. O nome de cada campo indica de qual tabela ele pertence, como CampoB da Tabela B. Os campos podem ser dimensões ou medidas, salvo indicação em contrário.

### Campos relacionados

Em um nível mais alto, os campos são relacionados quando o Tableau consegue determinar claramente como avaliá-los juntos, com base em um caminho de relação em uma única árvore.

Por exemplo, FieldB (da Tabela B) e FieldS (da Tabela S) estão relacionados.

![FieldB e FieldS estão relacionados](/tableau/current/pt-br/server/pt-br/Img/mfr_relatedness_tables_related2.png)

### Campos não relacionados

Em um nível superior, os campos não estão relacionados em qualquer caso, quando não estão relacionados. Isso pode ocorrer porque os campos são de tabelas não relacionadas, como o uso de campos de duas tabelas base. Nesse caso, os campos de diferentes tabelas base não estão fundamentalmente relacionados.

Por exemplo, FieldA e FieldX não estão relacionados.

![FieldA e FieldX não estão relacionados](/tableau/current/pt-br/server/pt-br/Img/mfr_relatedness_tables_unrelatedbase.png)

Ou os campos podem ser tratados como não relacionados por um determinado momento, como em casos relacionados de forma ambígua ou ainda não relacionados. Na maior parte, você pode confiar em [indicadores de relação](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_relatedness_messages.htm) para alertar você quando os campos não estiverem relacionados no contexto de uma visualização.

### Dimensão da união

A união é como o Tableau avalia campos de tabelas não relacionadas em um modelo de dados de vários fatos durante a análise. Em uma visualização, o uso de uma dimensão de uma tabela compartilhada costure campos que de outra forma não seriam relacionados e permite que eles sejam avaliados simultaneamente na mesma visualização. Pense nisso como uma justaposição de resultados de duas árvores com base em uma dimensão que elas compartilham.

Por exemplo, se uma visualização for criada com FieldA e FieldX, esses dois campos não estarão relacionados. Adicionar DimensionS introduz um campo de união.

- FieldA e DimensionS são avaliados em conjunto.
- FieldX e DimensionS são avaliados em conjunto.
- Esses resultados intermediários são reunidos com base nos valores de DimensionS.
- FieldA e FieldX agora estão unidos.

![tabelas base não relacionadas A e X unidas por sua tabela compartilhada S](/tableau/current/pt-br/server/pt-br/Img/mfr_relatedness_fields_stitching.png)

**Dica**: uma prática recomendada é usar um campo de união na visualização antes de exibir um campo não relacionado. Por exemplo, arraste DimensionS primeiro, ou FieldA, depois DimensionS e depois FieldX, em vez de FieldA, FieldX e depois DimensionS. Adicionar o campo de união primeiro garante que o Tableau esteja sempre ciente de como avaliar as relações e evita possíveis problemas de desempenho ao avaliar dimensões não relacionadas em conjunto com uniões de colunas cruzadas.

A junção requer que uma dimensão de uma tabela compartilhada esteja ativa na visualização. Os campos colocados na divisória Filtros ou na propriedade Dica de ferramenta do cartão Marcas não são considerados ativos para fins de união.

### Campos ainda não relacionados

Os campos também podem ter diversas maneiras de se relacionar, mas ainda não estão. Isso acontece quando há mais de um relacionamento possível entre duas tabelas compartilhadas (ou tabelas compartilhadas downstream).

Considere FieldS e FieldT. Suas tabelas estão relacionadas entre si tanto por meio da árvore definida pela Tabela base A quanto por meio da árvore definida pela Tabela base X.

Em uma visualização apenas com FieldS e FieldT, há informações sobre qual árvore deve ser usada para relacioná-los. Sem informações adicionais, o Tableau não pode avaliar se esses campos devem ser relacionados por meio da árvore da Tabela base A ou da árvore da Tabela base B.

FieldS e FieldT são tratados como não relacionados, embora existam vários relacionamentos _potenciais_.

![Campos ambíguos sub-relacionados S e T](/tableau/current/pt-br/server/pt-br/Img/mfr_relatedness_fields_not-yet_hyporelated.png)

Esses campos que poderiam ser, mas ainda não estão relacionados, são avaliados como não relacionados porque o Tableau não consegue determinar claramente o caminho do relacionamento. Ao contrário dos campos verdadeiramente não relacionados, que só podem ser agrupados, os campos ainda não relacionados podem ser resolvidos e os campos podem ser diretamente relacionados.

### Campos ambiguamente relacionados

Os campos também podem estar relacionados de forma ambígua. Isso acontece quando há mais de um relacionamento possível ativo entre tabelas compartilhadas (ou tabelas compartilhadas downstream). Diferentemente de campos ainda não relacionados, que podem ser considerados hipo-relacionados ou sub-relacionados, campos ambiguamente relacionados são hiper-relacionados ou super-relacionados.

Considere FieldS e FieldT. Suas tabelas estão relacionadas entre si tanto por meio da árvore definida pela Tabela base A quanto por meio da árvore definida pela Tabela base X.

Em uma visualização com FieldA, FieldX, FieldS e FieldT, há muitas informações para decidir qual árvore deve ser usada para relacioná-los. Sem cortar as informações, o Tableau não consegue avaliar se relaciona esses campos por meio da árvore da Tabela base A ou da árvore da Tabela base B.

FieldS e FieldT são tratados como não relacionados, embora existam vários relacionamentos _ativos_.

![](/tableau/current/pt-br/server/pt-br/Img/mfr_relatedness_fields_ambiguous_hyperrelated.png "super-relacionado")

Esses campos de relação ambígua são avaliados como não relacionados porque o Tableau não consegue determinar claramente o caminho do relacionamento. Ao contrário dos campos verdadeiramente não relacionados, que só podem ser agrupados, os campos relacionados de forma ambígua podem ser resolvidos e os campos podem ser diretamente relacionados.

### Medida ambígua de uma tabela compartilhada

Quando uma dimensão é usada em uma tabela compartilhada, ela une campos de suas tabelas upstream não relacionadas. No entanto, a medida não pode ser unida, e o valor de uma medida depende de suas dimensões relacionadas.

Em uma visualização com DimensionA e DimensionX, essas duas dimensões não estão relacionadas. Se MeasureS for extraída da Tabela S, ela não estará relacionada à combinação DimensionA e DimensionX juntas. Embora possa estar relacionada a qualquer um deles independentemente, não pode estar relacionada a ambas simultaneamente na mesma situação.

![tabelas base não relacionadas A e X unidas por sua tabela compartilhada S](/tableau/current/pt-br/server/pt-br/Img/mfr_relatedness_fields_stitching.png)

Uma medida compartilhada pode ser considerada um tipo de ambiguidade ou excesso de relação e é resolvida da mesma maneira.

### Resolver relações não claras entre campos

Sempre que houver incerteza sobre como relacionar campos, o Tableau não tomará uma decisão arbitrária e, em vez disso, os tratará como não relacionados. Muitas vezes é melhor relacionar esses campos esclarecendo a incerteza sobre qual árvore usar.

A resolução de campos ainda não relacionados é feita adicionando um campo para estabelecer qual árvore utilizar. A resolução de campos relacionados de forma ambígua é feita removendo campos para estabelecer qual árvore usar.

_Exemplo:_

**Resolução de ainda não relacionado**: adicionar um campo

- Em uma visualização de FieldS e FieldT, adicionar um campo da Tabela A, B ou C à visualização ativa a árvore da Tabela Base A e resolve o caminho desejado entre FieldS e FieldT.
- Alternativamente, usar um campo da Tabela X resolve o caminho desejado entre FieldS e FieldT para a árvore da Tabela Base X.

**Resolução de relacionamento de forma ambígua**: remover um campo ou campos

- Em uma visualização de FieldA, FieldX, FieldS e FieldT, a remoção de FieldX torna ativa apenas a árvore da Tabela Base A e resolve o caminho desejado entre FieldS e FieldT.
- Alternativamente, remover FieldA resolve o caminho desejado entre FieldS e FieldT através da árvore da Tabela Base X.

**Resolução de uma medida compartilhada**: remover um ou mais campos

- Em uma visualização de DimensionA, DimensionX e MeasureS, a remoção de DimensionX torna ativa apenas a árvore da Tabela Base A e resolve o caminho desejado entre DimensionA e MeasureS.
- Alternativamente, remover DimensionA resolve o caminho desejado entre DimensionX e MeasureS através da árvore da Tabela Base X.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"></colgroup><tbody><tr><td style="text-align: center;" rowspan="2"><b>Ainda não relacionado</b></td><td style="text-align: center;" rowspan="2"><b>Relacionado ambiguamente</b></td><td colspan="2" style="text-align: center;"><b>A relação resolvida para uma única árvore</b></td></tr><tr><td style="text-align: center;">Relacionado através da Tabela base A</td><td style="text-align: center;">Relacionado através da Tabela base X</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_fields_not-yet_hyporelated.png" alt="sub-relacionado"></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_fields_ambiguous_hyperrelated.png" title="super-relacionado" alt=""></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_fields_context_a.png" alt="relacionado através de A"></td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_fields_context_x.png" alt="relacionado através de X"></td></tr></tbody></table>

Resolver incerteza é semelhante a usar uma expressão de nível de detalhe FIXED (LOD). Em uma expressão FIXED LOD, você informa ao Tableau qual nível de detalhe agregar definindo a declaração de dimensão. A incerteza é resolvida alterando a estrutura da visualização para tornar ativa apenas uma árvore, informando assim ao Tableau quais caminhos de relacionamento ele pode considerar para realizar a análise.

### Unir versus resolver incerteza

Tanto unir quanto resolver incerteza são formas de lidar com a falta de relacionamento, mas têm resultados diferentes:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col></colgroup><tbody><tr><td><p>União</p></td><td><p>Resolvendo a incerteza</p></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_fields_stitching.png" alt="Unindo A e X com S"><p><span class="caption">FieldA e FieldX não relacionados unidos por DimensionS</span></p></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_relatedness_fields_context_a.png" alt="Resolvendo S e T com A"><p class="caption">FieldS e FieldT avaliados através da árvore definida pela Tabela base A</p></td></tr><tr><td>Justapõe campos não relacionados com base em atributos compartilhados</td><td>Restringe qual caminho de relacionamento usar quando há várias opções (ambiguidade ou uma medida compartilhada) ou estabelece um caminho de relacionamento quando não há nenhum (ainda não relacionado).</td></tr><tr><td><p>Usa lógica de tabela base múltipla para calcular resultados</p></td><td><p>Usa lógica de tabela base única para calcular resultados</p></td></tr><tr><td>A análise envolve tabelas não relacionadas</td><td>A análise envolve tabelas compartilhadas</td></tr></tbody></table>

## Como as uniões de colunas são usadas para cada nível de relacionamento

Após a determinação da relação em nível de campo, o Tableau precisa avaliar os resultados para criar a visualização real. As consultas usadas para calcular os valores mostrados em uma visualização dependem de junções. O fato de os campos serem relacionados, não relacionados ou agrupados tem um impacto diferente nas junções executadas. Lembre-se de que campos relacionados de forma ambígua e ainda não relacionados são tratados como não relacionados neste contexto.

Para explicar o relacionamento e as junções, esta seção aborda tabelas e seus campos, além dos valores nesses campos. Considere o seguinte modelo de dados com duas tabelas base, Classes e Clubes, e uma tabela compartilhada, Alunos.

![Um modelo de dados com duas tabelas base, classes e clubes, e uma tabela compartilhada, alunos](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_model.png)

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col></colgroup><tbody><tr><td><p>Classes</p></td><td><p>Clubes</p></td><td><p>Alunos</p></td></tr><tr><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_ex_birds_table_classes.png" alt="visualizar dados da tabela de classes, mostrando os valores de três campos"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_ex_birds_table_clubs.png" alt="visualizar dados da tabela de clubes, mostrando os valores de três campos"></td><td><img src="https://help.tableau.com/current/server/pt-br/Img/mfr_ex_birds_table_students.png" alt="visualizar dados da tabela de alunos, mostrando os valores de três campos"></td></tr><tr><td><p>Campos:</p><ul><li><b>Classes</b>, uma dimensão com valores de Noções básicas de aninhamento, músicas avançadas, voo para iniciantes e chamadas de alarme 101</li><li><b>Comprimento</b>, uma medida</li><li><b>Aluno</b>, uma dimensão usada para se relacionar com a tabela Aluno</li></ul></td><td><p>Campos:</p><ul><li><b>Clube</b>, uma dimensão com valores de Fotografia, Viagem, Malabarismo, Arte e Primeiros Socorros</li><li><b>Taxas</b>, uma medida</li><li><b>Aluno</b>, uma dimensão usada para se relacionar com a tabela Aluno</li></ul></td><td><p>Campos:</p><ul><li><b>Piloto de ônibus</b>, uma dimensão com valores de sim ou não</li><li><b>Aluno</b>, uma dimensão com valores de Finch, Cardinal, Sparrow, Robin e Jay. Usado para se relacionar com as outras duas tabelas</li><li><b>Idade</b>, uma medida</li></ul></td></tr></tbody></table>

Este modelo muito simples ilustra como a lógica de união de colunas de alto nível é calculada para modelos de dados de relacionamento multifatos. Para obter mais informações sobre os conceitos básicos de uniões de colunas usadas em modelos de dados de tabela base única criados em relacionamentos, consulte [Como funciona a análise para fontes de dados de múltiplas tabelas que usam relações](https://help.tableau.com/current/pro/desktop/pt-br/datasource_multitable_analysis_overview.htm).

Este exemplo deveria ser um modelo de dados com múltiplas tabelas base?

Para este modelo de dados de três tabelas, pode ser tentador configurá-lo como um modelo de tabela base único, como Classes-Alunos-Clubes ou Clubes-Alunos-Classes, ou com Alunos como tabela base. Como regra, os modelos de dados de relação de vários fatos destinam-se a tipos específicos de esquemas de dados ou cenários de análise. Se o seu modelo de dados [tem características que são mais adequadas para um modelo de dados de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_when_to_use.htm), configure-o dessa forma para manter suas tabelas base conceitualmente não relacionadas. No entanto, se seus dados não exigirem esse tipo de estrutura, um modelo de tabela base única poderá ser mais simples de usar.

![estruturas de modelo de dados alternativas para o modelo de exemplo de classes-clubes-alunos](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_model_versions.png)

Modelos que poderiam ser construídos para estas três tabelas: (1) Classes e Clubes como tabelas base com Alunos como uma tabela compartilhada, (2) linearmente, começando com Classes ou Clubes, e (3) Alunos como uma única tabela base com Classes e clubes como tabelas downstream.

Neste caso específico, não há nada nessas tabelas, nos dados ou no modelo que realmente exija múltiplas tabelas base. Estamos usando este modelo como exemplo para mantê-lo simples, para que o foco possa estar na lógica de união de colunas. Ou você pode imaginar que há outra tabela relacionada, Salas, que estamos simplesmente ignorando para evitar complicar demais a discussão.

![uma versão do modelo aulas-clubes-alunos com mesa compartilhada adicional, salas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_model_withroom.png)

No entanto, como prática recomendada, use apenas um modelo de relação de vários fatos quando seus dados exigirem.

### Dimensões relacionadas usam uniões de colunas internas

As dimensões relacionadas têm uniões de coluna internamente. As uniões de coluna internas eliminam quaisquer valores de dimensão que não sejam compartilhados nas duas tabelas.

- O Tableau usa lógica adicional para garantir que os valores das medidas não sejam perdidos. Esta seção usa apenas dimensões para demonstrar os princípios básicos de como o Tableau aplica uniões de coluna internas a dimensões relacionadas.

O exemplo a seguir mostra como as dimensões relacionadas retornam apenas linhas que estão presentes nos dados. Nenhum aluno está na turma Chamadas de Alarme 101, portanto não está presente nos resultados. Cardinal e Jay não estão em nenhuma classe, portanto não estão presentes nos resultados.

![Uma visualização mostrando uma união de coluna interna de Turma e Aluno, com duas linhas para Finch (músicas avançadas, noções básicas de aninhamento), duas linhas para Robin (voo para iniciantes, noções básicas de aninhamento) e duas linhas para Sparrow (músicas avançadas, noções básicas de aninhamento)](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_relateddims_innerjoin.png)

### Dimensões não relacionadas usam uniões de colunas cruzadas

Dimensões não relacionadas — por si só, sem uma dimensão de união — são unidas de forma cruzada.

Em uma união de colunas cruzada, cada valor de uma dimensão é combinado com cada valor da outra dimensão, mesmo que a combinação resultante não exista realmente nos dados. Neste exemplo, a união de colunas cruzada adiciona uma linha para cada combinação possível de Classe e Clube.

![Uma visualização mostrando uma união de colunas cruzada de Classe e Clube com linhas para cada combinação de Músicas Avançadas/Chamadas de Alarme 101/Voo para iniciantes/Noções Básicas de Aninhamento com Arte/Primeiros Socorros/Malabarismo/Fotografia. Há um ícone não relacionado mostrado em ambos os comprimidos de dimensão na divisória Linhas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_unrelateddims_crossjoin.png)

É importante reconhecer quando uma união de colunas cruzada está ocorrendo na sua análise. Embora haja uma linha para Canções Avançadas + Primeiros Socorros na tabela de resultados para a união de colunas cruzada, nenhum aluno está realmente nesta combinação de atividades (veremos a prova disso no exemplo de união na próxima seção).

Por que é importante reconhecer que nem todos os resultados de união de colunas cruzada são baseados em dados? Imagine que você esteja tentando montar um cronograma de aulas e clubes para que não houvesse conflitos para os alunos. Não há alunos em Músicas Avançadas e Primeiros Socorros, então você pode ignorar esse resultado e agendar aquela classe e clube simultaneamente. A união de colunas cruzada não representa combinações de valores que realmente existem nos dados.

Além disso, uniões de coluna cruzadas quando há alta cardinalidade (um grande número de valores exclusivos) podem afetar o desempenho. Imagine unir cada número de telefone com cada endereço de e-mail em seus contatos. Isso seria uma enorme explosão de combinações e uma operação potencialmente custosa.

### Dimensões unidas usam uniões de colunas externas

Dimensões não relacionadas — na presença de uma dimensão de união — são unidas externamente.

Neste exemplo, tanto a tabela Classes quanto a tabela Clubes estão relacionadas à tabela compartilhada Alunos, mas não entre si, portanto os campos Classe e Clube não estão relacionados. Adicionar a dimensão Aluno permite que o Tableau saiba quais valores da Classe e quais valores do Clube devem ser justapostos na análise. Chamamos esse comportamento de união de colunas externa de _união_.

![Uma visualização que mostra os resultados de uma união de colunas externa da união de colunas interna Aluno-Classe e da união de colunas interna Aluno-Clube. Há um ícone não relacionado nos campos Classe e Clube na divisória Linhas. Uma pílula para Aluno está na propriedade Cor do cartão Marcas e não possui um ícone não relacionado. Nem todas as combinações de classes e clubes estão representadas e há filas para alunos e clubes sem](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_stitched_outerjoin.png)

A união é semelhante à combinação de dados, pois há resultados intermediários que são reunidos para formar os resultados gerais. Ao contrário da combinação, entretanto, a união é uma união de colunas externa, não uma união de colunas à esquerda, e não descarta valores de nenhum dos lados. Não há conceito de fontes de dados primárias ou secundárias quando se trata de uma única fonte de dados, portanto, ambos os campos não relacionados recebem precedência igual.

#### Os resultados intermediários são unidos externamente

O que entra na união de colunas externa dos campos unidos? Uma união interna intermediária é calculada para o campo de união e para cada um dos campos não relacionados, e então esses resultados intermediários são unidos externamente com base nos valores da dimensão de união.

**Exemplo**

Uma união de coluna interna para Aluno e Classe...

![Uma tabela de resultados para três valores de alunos e três valores de turmas](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_stitched_inner1.png)

...e uma união de colunas interna para Aluno e Clube...

![Uma tabela de resultados para quatro valores de alunos e cinco valores de clubes](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_stitched_inner2.png)

...são então unidos externamente no Aluno.

![Uma tabela de resultados para quatro valores de alunos, três valores de turmas e cinco valores de clubes](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_stitched_outerjoin.png)

### Uniões de colunas adicionais para reter medidas

Além da lógica de união de colunas para dimensões, as medidas podem introduzir uniões de colunas adicionais. Quando as relações foram introduzidos pela primeira vez no Tableau, um dos [princípios básicos era que os valores de medida não são perdidos](https://www.tableau.com/pt-br/blog/relationships-tableau-data-model). Isso também é mantido em modelos de dados de relações multifatoriais.

Os detalhes essenciais são:

- Os valores de medida são divididos apenas por dimensões relacionadas.
- Os valores de medida são repetidos para dimensões não relacionadas.
- Os valores de dimensão que seriam descartados em visualizações somente de dimensão poderão ser retornados se houver valores de medida relevantes associados a eles.

**Observação**: lembre-se de que as medidas são agregações: elas são calculadas no nível de detalhe (a granularidade) definido pela combinação de dimensões na visualização. Trata-se de uma medida que está sendo _dividida_ por uma dimensão. Quando uma medida é usada sem dimensões, diz-se que é _escopo da tabela_. Isso significa que o valor da medida é o valor totalmente agregado. Assim que usamos uma dimensão na visualização, a medida é dividida de forma mais granular com base nos valores da dimensão. O valor de uma medida em uma análise depende, portanto, do contexto das dimensões.

#### Medidas relacionadas

Considere o subconjunto de valores de dimensão retornados para uma união de colunas interna nas dimensões relacionadas **Aluno** e **Classe.** Existem _três_ valores estudantis, Finch, Robin e Sparrow; e _três_ valores de classe, Advanced Songs, Nesting Basics e Flying for Fledgelings.

![uma tabela de resultados para uma união de colunas interna entre aluno e turma](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_inner_student_class.png)

Se adicionarmos a medida **Duração** da tabela Classe, vamos ver que todas as _quatro_ classes são mostradas e há um valor nulo para Aluno. Cada **Duração** de classe é exibido, no nível de **Classe**.

![Um valor nulo aparece para o aluno mesmo que as dimensões sejam unidas internamente](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_related_measurefrombase.png)

Em vez disso, se adicionarmos a medida **Idade** da tabela Aluno, vamos ver que todos os _cinco_ alunos são mostrados e há dois nulos para Classe. Os resultados preservam todos os alunos, mesmo que eles não estejam na turma. Toda **Idade** do aluno é exibida, no nível de **Aluno**.

![Um valor nulo aparece para classes mesmo que as dimensões sejam unidas internamente](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_related_measurefromshared.png)

#### Medidas não relacionadas

Os valores de medida são repetidos para valores de dimensão não relacionados.

Se olharmos para a medida **Comprimento** da tabela Classes e a medida não relacionada **Clube** dimensão, a medida tem escopo de tabela e é repetida em todos os valores de dimensão de **Clube**.

![uma medida com escopo de tabela repetida em valores de dimensão não relacionados](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_unrelateddim-measure.png)

Na presença de uma dimensão de união, as medidas podem ser divididas e repetidas.

Aqui, a medida **Idade** vem da tabela Alunos e é dividido por nível de aluno. Cada vez que um aluno é repetido com base nas dimensões para **Classe** e **Clube**, o valor **Idade** é repetido.

![](/tableau/current/pt-br/server/pt-br/Img/mfr_ex_birds_unrelateddims_sharedmeasure.png)

## Solução de problemas

### Considerações ao trabalhar com modelos de dados de relações multifatoriais

**Filtros de extração por tabela**

Todos os filtros de extração para um modelo de dados de relacionamento multifatorial são por tabela (não generalizados). Por esse motivo, os resultados da filtragem podem ser diferentes entre a conexão ativa e a de extração.

**Cálculos em nível de linha**

Os cálculos em nível de linha só podem se referir a campos que compartilham a mesma tabela base upstream. Ou seja, os cálculos em nível de linha não podem ser realizados em árvores.

**Campos combinados**

Todos os campos em um campo combinado devem compartilhar uma tabela upstream. Ou seja, não é possível criar um campo combinado usando campos que estejam em árvores diferentes.

**Conjuntos**

Os conjuntos só podem ser criados com uma definição que envolva campos que compartilhem a mesma tabela base upstream. No entanto, em uma visualização, a opção Adicionar ao conjunto pode estar disponível em uma marca quando essa marca é definida por campos não relacionados aos campos usados para definir o conjunto. Se você escolher Adicionar ao conjunto, o Tableau adicionará apenas os campos relacionados à definição do conjunto. Isso é diferente do comportamento de Adicionar ao conjunto em fontes de dados de tabela base única, quando Adicionar ao conjunto adiciona tudo o que define a marca.

**Validar expressões de nível de detalhe INCLUDE**

As expressões de nível de detalhe INCLUDE não podem ser avaliadas em campos não relacionados. Como a relação entre os campos é avaliada folha por folha, é possível ter uma expressão LOD válida no painel Dados ou no editor de cálculo que se torna inválida no contexto de uma visualização específica (na presença de uma dimensão não relacionada). Quando isso acontecer, a pílula LOD ficará vermelha. Você pode atualizar a expressão LOD para remover conflitos de campos não relacionados, alterar a estrutura da visualização ou remover a expressão LOD da visualização.

**Atualização da fonte de dados publicada**

Como prática recomendada, crie uma cópia de uma fonte de dados publicada existente se você planeja modificá-la para se tornar um modelo de dados de relação de vários fatos quando nem todas as suas pastas de trabalho conectadas precisarem do novo modelo de dados. Não atualize a versão existente da fonte de dados, a menos que todas as suas pastas de trabalho precisem das novas tabelas. Publique a fonte de dados modificada como uma nova fonte de dados e crie novas pastas de trabalho a partir dela. Isso impedirá que as pastas de trabalho existentes sejam convertidas para usar o VDS em vez do servidor de dados quando não precisarem da funcionalidade, evitando a possibilidade de afetar o desempenho.

### Problemas resolvidos

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 60%;"><col></colgroup><tbody><tr><td><b>Problema resolvido</b></td><td><b>Corrigido a partir de</b></td></tr><tr><td><p><b>Extrações</b></p><p><i>Fonte de dados local (em uma pasta de trabalho):</i>&nbsp;A tentativa de extrair uma fonte de dados de relações multifatoriais gerará um erro “Essa tabela não existe”.</p><p><i>Fonte de dados publicada:</i>&nbsp;a extração de uma fonte de dados de relação de vários fatos publicada parece ter êxito, mas os valores dos campos podem ser trocados.</p></td><td rowspan="3"><ul><li><a href="https://www.tableau.com/pt-br/support/releases/online">Tableau Cloud</a>: resolvido nas atualizações de meados de julho. Isto também se aplica a <a href="https://public.tableau.com/app/discover">public.tableau.com</a>.</li><li><a href="https://www.tableau.com/pt-br/support/releases"><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span></a>: resolvido desde a versão de manutenção 2024.2.1 lançada em 24 de julho de 2024</li><li><a href="https://www.tableau.com/pt-br/support/releases/server">Tableau Server</a>: resolvido a partir da versão de manutenção 2024.2.1 lançada em 24 de julho de 2024</li></ul><p>Se você ainda encontrar esses problemas no <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou no Tableau Server, atualize para uma versão de 24 de julho de 2024 ou posterior.</p></td></tr><tr><td><p><b>Expressões de nível de detalhe EXCLUDE</b></p><p>Somente LODs INCLUDE devem ser validados na presença de campos não relacionados. No entanto, os LODs EXCLUDE também podem ser marcados incorretamente como inválidos nas mesmas condições.</p></td></tr><tr><td><p><b>Cálculos de usuário aninhados</b></p><p>Os cálculos de usuário aninhados não estão disponíveis em fontes de dados publicadas com um modelo de dados de relações multifatoriais.</p></td></tr></tbody></table>

### Problemas conhecidos

**Indicadores de relações com vários cartões de Marcas**

Quando uma visualização é criada com diversas medidas na divisória Linhas ou na divisória Colunas, cada medida recebe seu próprio cartão Marcas. A lógica usada para determinar os indicadores de relação (o ícone não relacionado, o texto nas dicas de ferramentas e a caixa de diálogo de aviso de relação) pode não fornecer os resultados esperados dependendo de qual cartão Marcas está aberto. A visualização em si, entretanto, é calculada corretamente com base na relação de cada par de campos. Há uma correção planejada para esse comportamento.

**Processador BatchQuery**

BatchQueryProcessor deve ser habilitado para aceitar modelos de dados de relação de vários fatos. Este é o comportamento esperado sem nenhuma correção planejada atualmente.

**Tableau Pulse**

O Tableau Pulse talvez não funcione com modelos de dados de relações multifatoriais. Você pode ser impedido de criar uma definição de métrica ou qualquer métrica criada pode ficar em branco. Esse não é um comportamento esperado, mas ainda não há nenhuma correção planejada.

**Alterar dimensões com um parâmetro**

O Tableau permite que você possa [trocar campos usando um parâmetro](https://help.tableau.com/current/pro/desktop/pt-br/parameters_swap.htm). No entanto, com relações multifatoriais, a troca de dimensões com um parâmetro falhará silenciosamente. O parâmetro e seu cálculo podem ser criados, e o controle de parâmetro pode ser mostrado, mas o campo não será alterado quando o parâmetro for alterado. Isso ocorre devido a quando as dimensões são avaliadas para relação e quando os parâmetros são avaliados na ordem de operações.

## Outros artigos nesta seção

<!-- document id=6fe972bdf348a34bc0bf52048a04a3dc046297c05de66f1a8bd45e8d62833253 url=/tableau/current/pt-br/server/data_dictionary.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre o dicionário de dados do Tableau Server

O Dicionário de dados do Tableau Server inclui informações sobre as tabelas e exibições no banco de dados do “grupo de trabalho” PostgreSQL do repositório do Tableau Server. Esta base de dados fornece o armazenamento persistente para o Tableau Server e destina-se principalmente em suportar este aplicativo. O Dicionário de dados não é uma descrição completa de todas as tabelas e campos no banco de dados e é fornecido para clientes que desejam consultar o banco de dados para obter informações sobre o uso do Tableau Server. Como o banco de dados e seu conteúdo devem oferecer suporte ao Tableau Server, a estrutura e o conteúdo podem sofrer alterações sem aviso prévio. Isso significa que qualquer exibição personalizada criada a partir da consulta direta ao banco de dados pode ser interrompida.

> [!IMPORTANT]
> 
> **Importante**: o Dicionário de dados é fornecido com um nível de suporte **Como está**. Para obter assistência na criação de relatórios com base no dicionário, incluindo a gravação de consultas no banco de dados ou a atualização de pastas de trabalho quebradas, entre em contato com os fóruns da comunidade do Tableau.

[Abra o Dicionário de dados](https://tableau.github.io/tableau-data-dictionary/2026.2/data_dictionary.htm "Dicionário de dados").

<!-- document id=82c39f438747bfe1451fb080d5ccdb5469633b20af8f1b629992873500aa9271 url=/tableau/current/pt-br/server/ipa_vconn_about_editor.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre o Editor de conexão virtual

Centralize e gerencie o acesso aos dados para sua organização usando estes recursos:

- **Conexões virtuais** - Pontos de acesso a dados gerenciados e reutilizáveis.
- **Políticas de dados** - Use para definir a segurança em nível de linha.
- **Extrações centralizadas** - Reutilize a mesma extração várias vezes.

Use o editor de conexão virtual para criar conexões virtuais e políticas de dados. O diagrama a seguir mostra o processo:

![O diagrama descreve o processo de criação de uma conexão virtual e política de dados](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_workflow_diagram.png)

Para começar, selecione um banco de dados, se necessário. Em seguida, selecione e arraste uma tabela para a guia Tabelas.

[Leia o tópico completo](https://help.tableau.com/current/server/pt-br/dm_vconn_overview.htm)

## Tarefas relacionadas

[Adicionar tabelas à conexão](https://help.tableau.com/current/server/pt-br/ipa_vconn_add_tables.htm)

[Sobre políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_data_policy.htm)

[Criar e testar políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_create_data_policy.htm)

Não encontrou o que você precisa?

Fique online para ver [toda a ajuda do Tableau](https://www.tableau.com/pt-br/support/help)

<!-- document id=edbf37f240f43673c9d7e152643ff0ab7dcb2bd43a7d4ae3271dee72b5b75fe5 url=/tableau/current/pt-br/server/prep_conductor_workspace.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre o espaço de trabalho de fluxo

Depois de publicar o fluxo, você pode agendar tarefas ou tarefas vinculadas (versão 2021.3 e posteriores) no Tableau Server para executar os fluxos automática e regularmente e manter os dados de saída atualizados. Você também pode executar seus fluxos manualmente a qualquer momento (sem exigência de Data Management).

O Tableau Prep Conductor aproveita muito da mesma funcionalidade de gerenciamento de fluxos que você pode ver ao gerenciar pastas de trabalho ou fontes de dados do Tableau Desktop em Tableau Server . Por exemplo, assim como as atualizações de extração, as tarefas de fluxo agendadas e as execuções de fluxo sob demanda são enfileiradas como tarefas em segundo plano. Mas quando se trata de trabalhar com fluxos, existem algumas diferenças.

## Página de Visão geral do fluxo

A página de Visão geral de fluxo é a página de destino principal onde você pode visualizar dados sobre seu fluxo e cronograma, monitorar e manter o fluxo. Se você não tem o Data Management, você terá opções diferentes.

Abra a página Visão geral do fluxo clicando em um fluxo em sua lista. Você pode navegar até lá em Conteúdo > Explorar > Todos os fluxos ou abrindo o projeto que contém os fluxos.

![A página Visão geral do fluxo do Tableau Prep.](/tableau/current/pt-br/server/pt-br/Img/prep_parameters_flow_overview.png)

1. O cabeçalho lista o nome do fluxo, o proprietário do fluxo e a data em que o fluxo foi modificado pela última vez. A partir da versão 2020.4, clique em Editar para editar os fluxos existentes.
    
    Adicione um fluxo aos seus favoritos ou, no menu Mais ações![A opção de menu Mais opções representada por 3 pontos.](/tableau/current/pt-br/server/pt-br/Img/prep_server_rmoremenu.png), você também pode editar, executar, baixar o fluxo, definir permissões, alterar o proprietário do fluxo, restaurar versões anteriores do fluxo e muito mais.
2. Visualize e edite a descrição do fluxo e defina marcas para ajudar outras pessoas a encontrar os fluxos que procuram.
3. Visualize as etapas de saída para um fluxo juntamente com quaisquer parâmetros aplicados ao fluxo (versão 2021.4 e posterior), o status da última atualização, qualquer agenda à qual a saída foi atribuída e quaisquer erros da última execução do fluxo. Você também pode clicar no botão Executar![O botão Executar fluxo aparece como uma seta voltada para a direita em um círculo.](/tableau/current/pt-br/server/pt-br/Img/prep_server_run_button.png) para executar todas as etapas de saída ou etapas de saída individuais sob demanda.
    
    <table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td><span class="uicontrol">Parâmetros</span></td><td><p>Caso o fluxo inclua parâmetros de usuário, o valor do parâmetro executado pela última vez no fluxo aparece e você pode ver todas as saídas geradas na coluna <span class="uicontrol">Saída</span>. Quando o fluxo for executado, você será solicitado a inserir os valores dos parâmetros.</p><p>Os parâmetros do sistema (versão 2023.2 e posterior) são gerados automaticamente no tempo de execução do fluxo e o tipo de parâmetro do sistema aparece na coluna <span class="uicontrol">Parâmetros</span>. Para ver o último valor de parâmetro do sistema aplicado ao fluxo, edite o fluxo.</p><p>Para obter mais informações sobre como usar parâmetros nos fluxos, consulte <a href="https://help.tableau.com/current/prep/pt-br/prep_parameters.htm" target="_blank">Criar e usar parâmetros em fluxos</a> na ajuda do Tableau Prep.</p></td></tr><tr><td><span class="uicontrol">Status</span></td><td>Depois que um fluxo é executado com sucesso, as saídas que são fontes de dados tornam-se links, nos quais você pode clicar para abrir a página <span class="uicontrol">Fonte de dados</span> para visualizar mais informações sobre a fonte de dados ou editar a conexão de entrada do fluxo.</td></tr><tr><td><span class="uicontrol">Agenda</span></td><td><p>No campo <span class="uicontrol">Agenda</span>, visualize as tarefas agendadas às quais a etapa de saída está atribuída. Uma saída de fluxo pode ser atribuída a uma ou mais tarefas.</p><p>Se nenhuma agenda foi atribuída ainda, clique em <span class="uicontrol">Criar nova tarefa</span> para adicionar a etapa de saída a uma agenda. Para executar imediatamente o fluxo para atualizar uma etapa de saída específica, clique no botão <span class="uicontrol">Executar</span><img src="https://help.tableau.com/current/server/pt-br/Img/prep_server_run_button.png" alt="O botão Executar fluxo aparece como uma seta voltada para a direita em um círculo."> no lado esquerdo da linha.</p></td></tr><tr><td><span class="uicontrol">Erros</span></td><td><p>Se o fluxo tiver erros, a execução do fluxo falhará. Os erros de conectividade podem ser resolvidos diretamente navegando até a guia<span class="uicontrol"> Conexões</span> do fluxo e editando as conexões de entrada.</p><p>Para resolver quaisquer outros erros de fluxo, edite o fluxo, publique-o novamente e tente executá-lo novamente. Se você estiver usando uma versão anterior do Tableau Prep Builder, no menu <span class="uicontrol">Mais ações</span><img src="https://help.tableau.com/current/server/pt-br/Img/prep_server_rmoremenu.png" alt="A opção de menu Mais opções representada por 3 pontos.">, você também pode baixar e abrir o fluxo no Tableau Prep Builder, publicá-lo novamente e tentar executar o fluxo novamente.</p></td></tr></tbody></table>
4. Visualize uma imagem da exibição

### Página de visão geral do fluxo sem o Data Management

Se você não tem o Data Management instalado em seu servidor, ainda pode publicar fluxos para Tableau Server, mas verá menos opções para gerenciar seu fluxo.

![Conexões do Tableau Prep.](/tableau/current/pt-br/server/pt-br/Img/prep_webauth_no_dm_addon.png)

## Página de Conexões de fluxo

Visualize os locais de entrada e saída de um fluxo, tipos de conexão, configurações de autenticação, etapas de entrada e saída e quaisquer erros de conectividade. Você pode definir as configurações de autenticação ao publicar um fluxo. Para obter mais informações, consulte [Publicar um fluxo](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm).

Para tipos de entrada de banco de dados, clique no menu Mais ações![A opção de menu Mais opções representada por 3 pontos.](/tableau/current/pt-br/server/pt-br/Img/prep_server_rmoremenu.png) para obter uma conexão de entrada, editar a conexão e alterar o nome do servidor, porta, nome de usuário e senha.

![Uma tabela de tipos de conexão e suas fontes no Tableau Prep.](/tableau/current/pt-br/server/pt-br/Img/prep_serverconnections.png)

## Página de Tarefas agendadas de fluxo (Data Management obrigatório)

Visualize todas as agendas às quais o fluxo está atribuído, as saídas incluídas nessas agendas e quaisquer parâmetros aplicados ao fluxo (versão 2021.4 e posterior). Como administrador, você pode clicar no link da agenda para abrir a página Agendas e ver uma lista de fluxos atribuídos a essa agenda. Para obter mais informações sobre como atribuir fluxos em uma agenda, consulte Agendar tarefa de fluxo na ajuda do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_online_schedule_flow_task.htm) ou [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_schedule_flow_task.htm).

Para visualizar as saídas em uma agenda ou as tarefas atribuídas a uma tarefa vinculada (versão 2021.3 e posterior), clique nos links na coluna Tipo de agenda.

Você também pode adicionar novas tarefas ou gerenciar as existentes nesta página. Para executar uma ação em uma tarefa existente, marque a caixa de seleção em um cartão de tarefa e clique no menu suspenso Ações para executar, editar ou excluir a tarefa.

Se a execução do fluxo falhar após um número configurado de tentativas consecutivas, o fluxo será automaticamente suspenso.

Você pode ver esse status na guia Visão geral e também nesta guia. Você pode retomar as tarefas suspensas neste menu.

Para obter informações sobre como definir o limite para tarefas de fluxo suspensas, consulte [Etapa 5: configurações opcionais do servidor](https://help.tableau.com/current/server/pt-br/prep_conductor_config_server_optional.htm). Para obter mais informações sobre as tarefas de fluxo suspensas, consulte [Ver e solucionar erros](https://help.tableau.com/current/server/pt-br/prep_conductor_monitor_flow.htm#View_Errors).

**Observação**: a página Tarefas agendadas para fluxos foi reprojetada na versão 2021.3. A exibição pode parece diferente dependendo da versão do Server.

![A página Fluxo com a guia Tarefas agendadas selecionada](/tableau/current/pt-br/server/pt-br/Img/prep_parameters_scheduled_tasks.png)

## Página de agendas

Na página Agendas, você pode visualizar os fluxos atribuídos a uma agenda e os detalhes sobre as execuções do fluxo. Se a agenda incluir tarefas vinculadas (versão 2021.3 e posterior), o número de fluxos incluídos nelas é mostrado.

Você pode executar a agenda sob demanda e executar todos os fluxos atribuídos a ela. Você também pode selecionar um ou mais fluxos e, em seguida, usar o menu Ações para alterar a agenda ou prioridade do fluxo, excluir fluxos selecionados da agenda ou retomar fluxos suspensos.

Para obter informações sobre como configurar uma agenda, consulte a [Etapa 3: criar agendas para tarefas de fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_create_schedule_definitions.htm).

![Uma tabela que mostra detalhes do fluxo, incluindo prioridade, status, última execução, próxima execução agendada e erros.](/tableau/current/pt-br/server/pt-br/Img/prep_server_schedules_page.png)

## Histórico de execução de fluxo (Data Management obrigatório)

Visualize, pesquise e classifique uma lista de corridas históricas para um fluxo. Esta página também inclui detalhes sobre a execução do fluxo, como tipo de execução, os valores de parâmetro aplicados aos fluxos incluídos em cada execução do fluxo (versão 2021.4 e posterior), duração e número de linhas que foram geradas.

Se a saída do fluxo tiver um erro, passe o mouse sobre o erro para visualizar as mensagens. Se aplicável, clique no link Ir para conexões na mensagem de erro para navegar até a página Conexões para corrigir os erros de conectividade. Você também pode editar o fluxo diretamente para corrigir quaisquer erros ou clicar em Baixar o fluxo para baixar e corrigir erros de fluxo no Tableau Prep Builder e, em seguida, republicar o fluxo para continuar a gerenciá-lo usando o Tableau Prep Conductor.

**Observação**: o histórico de execução de um fluxo persistirá, a menos que o fluxo seja excluído.

![A guia Histórico de execução é selecionada, e a coluna Erros exibe uma mensagem sobre os erros.](/tableau/current/pt-br/server/pt-br/Img/prep_parameters_run_history.png)

## Histórico de revisão de fluxo

Se você precisar reverter um fluxo para uma versão anterior, no menu Mais ações![A opção de menu Mais opções representada por 3 pontos.](/tableau/current/pt-br/server/pt-br/Img/prep_server_rmoremenu.png) para o fluxo, selecione Histórico de revisão. Na caixa de diálogo Histórico de revisão, selecione a versão do fluxo na lista para a qual deseja reverter.

![Uma tabela de Histórico de revisão com a opção para restaurar uma revisão.](/tableau/current/pt-br/server/pt-br/Img/prep_server_revisionhistory.png)

## Quem pode fazer isso

Os Administradores do servidor podem ativar as chaves de licença do Data Management.

Os administradores de servidor podem habilitar o Tableau Prep Conductor.

Os criadores podem criar, editar e executar fluxos manualmente. Se o Data Management estiver instalado, os criadores podem executar fluxos em uma agenda.

<!-- document id=10930b748c981c962e2a6d65d6404a8fef0a06314f0752facb607b0a373b8a5a url=/tableau/current/pt-br/server/dm_catalog_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre o Tableau Catalog

> [!WARNING]
> 
> A partir de 14 de outubro de 2025, o Data Cloud foi renomeado como Data 360. Durante essa transição, você pode ver referências a Data Cloud em nosso aplicativo e documentação. Embora o nome seja novo, a funcionalidade e o conteúdo permanecem inalterados.

Os dados estão aumentando em volume, formatos e importância, levando a ambientes mais complexos. Com o ritmo rápido da mudança dos dados, pode ser difícil acompanhar esses dados e como eles estão sendo usados em ambientes complexos. Ao mesmo tempo, mais usuários precisam acessar mais esses dados em mais lugares, e é difícil para os usuários encontrarem os dados certos. Em última análise, isso provoca uma falta de confiança nos dados porque as pessoas questionam se estão usando a fonte certa, ou se a fonte está atualizada.

O Tableau Catalog integra recursos como linhagem, análise de impacto, dicionário de dados, avisos de qualidade de dados e pesquisa aos seus aplicativos do Tableau, ajudando a solucionar esses problemas de forma diferente de um catálogo independente. Ele se concentra na TI e no usuário final para que todos que usam o Tableau Server ou o Tableau Cloud tenham mais confiança em e visibilidade nos dados, além de permitir mais capacidade de descoberta. O Tableau Catalog cria um catálogo fora do conteúdo do Tableau usado pela sua organização, permitindo uma funcionalidade abrangente, como o seguinte:

- **Análise de impacto e linhagem**.
    - Você pode ver as pastas de trabalho e outros conteúdos do Tableau que dependem de colunas ou campos específicos de tabelas ou fontes de dados que você gerencia. Quando precisar fazer alterações nos seus dados, você poderá notificar os autores do Tableau afetados por meio do e-mail.
    - Como autor de pasta de trabalho, você pode usar a linhagem para rastrear os campos dos quais a pasta de trabalho depende.
    - Como usuário, quando você usa uma visualização do Tableau, é possível ver de onde vieram os dados que foram usados para criar a exibição.
- **Curadoria e confiança**. Como um administrador de dados, é possível adicionar metadados úteis, como descrições e certificações, para que os usuários localizem os dados certos. Você pode definir os avisos de qualidade de dados, exibir detalhes de dados no painel Detalhes dos dados, certificar ativos e remover ativos do catálogo.
- **Descoberta de dados**. Na criação na Web do Tableau Desktop ou do Tableau, você pode usar o Tableau Catalog para pesquisar por bancos de dados, tabelas, fontes de dados e conexões virtuais para analisar no Tableau e se conectar a ele a partir dos resultados da pesquisa.

A partir de 2019.3, o Tableau Catalog está disponível como parte de Data Management para Tableau Server e Tableau Cloud. Quando a chave do produto está ativa e habilitada, os recursos de catálogo descritos acima são integrados ao produto que você está usando, para que possa trabalhar com os dados onde os encontrar.

## Como funciona o Tableau Catalog

O Tableau Catalog descobre e indexa todo o conteúdo em seu site (pastas de trabalho, fontes de dados, planilhas, conexões virtuais e fluxos) para coletar metadados sobre o conteúdo. Nos metadados, são identificados ativos externos (bancos de dados, tabelas e outros objetos). Conhecer as relações entre o conteúdo e os ativos externos permite que o Tableau exiba a linhagem do conteúdo e dos ativos externos. Além disso, o Tableau Catalog permite que os usuários se conectem a ativos externos usando o Tableau Server ou o Tableau Cloud.

Os usuários em seu site podem publicar ou excluir conteúdo, anexar avisos ou certificações de qualidade de dados ou fazer qualquer outra coisa que altere o conteúdo ou seus metadados no site, e o Tableau Catalog atualizará suas informações da forma apropriada.

Para obter informações sobre como você pode usar o Tableau Catalog para oferecer suporte à governança de dados em sua empresa, consulte [Governança no Tableau](https://help.tableau.com/current/blueprint/pt-br/bp_governance_in_tableau.htm) na Ajuda do Tableau Blueprint.

## Principais termos do Tableau Catalog

- Metadados - Informações sobre os dados.
- Conteúdo do Tableau - Conteúdo criado no Tableau, como pastas de trabalho, fontes de dados, conexões virtuais e fluxos.
- Ativos externos - Bancos de dados (incluindo arquivos de dados) e tabelas (incluindo objetos semelhantes a tabelas) usadas pelo conteúdo do Tableau, publicado no Tableau Server ou no Tableau Cloud.

## Licença do Tableau Catalog

O Tableau Catalog é licenciado por Data Management. Para obter informações sobre como o licenciamento do Data Management funciona, veja [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm).

## Habilitar o Tableau Catalog

Depois que o Tableau Server ou o Tableau Cloud for licenciado com os recursos de Data Management, você poderá habilitar o Tableau Catalog executando uma das seguintes tarefas:

- **Para o Tableau Cloud:** nenhuma ação é necessária. O Tableau Catalog é ativado por padrão, configurado para usar permissões derivadas e pronto para uso. Para obter mais informações sobre permissões derivadas, consulte o tópico [Permissões para metadados](https://help.tableau.com/current/server/pt-br/dm_perms_assets.htm#perms).
- **No Tableau Server**, o administrador do servidor deve primeiro habilitar a API de metadados do Tableau usando o comando `tsm maintenance metadata-services`. Para obter mais informações, consulte [Ativar o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm).
    
    Depois que a API de metadados estiver habilitada, o Tableau Catalog é ativado por padrão, configurado para usar permissões derivadas e pronto para uso. Para obter mais informações sobre permissões derivadas, consulte o tópico [Permissões para metadados](https://help.tableau.com/current/server/pt-br/dm_perms_assets.htm#perms).

## Recursos e funcionalidades

Para saber mais sobre os recursos que podem ser utilizados com o Tableau Catalog, consulte os seguintes artigos da Ajuda:

### Descoberta de dados

- No painel Conectar no Tableau Desktop, em Pesquisar por dados, selecione Tableau Server para se [conectar aos dados usando o Tableau Server ou Tableau Cloud](https://help.tableau.com/current/pro/desktop/pt-br/examples_tableauserver.htm). Quando o Tableau Catalog está habilitado, além de pesquisar fontes de dados publicadas para se conectar, agora você pode pesquisar e conectar-se a bancos de dados, tabelas e objetos específicos usados​por fontes de dados e pastas de trabalho publicadas no Tableau Server ou no site do Tableau Cloud .
- A [Pesquisa](https://help.tableau.com/current/pro/desktop/pt-br/search.htm) é expandida para incluir resultados com base em colunas, bancos de dados, tabelas e outros objetos, quando o Tableau Catalog está habilitado.
- Se você cria na Web, além de fontes de dados publicadas, também pode se [conectar a bancos de dados e tabelas](https://help.tableau.com/current/pro/desktop/pt-br/getstarted_web_authoring.htm#tableau-catalog-users-create-workbooks-from-external-assets).
- Se você usar o Tableau Prep na Web, poderá [criar novos fluxos com base em ativos externos](https://help.tableau.com/current/prep/pt-br/prep_startflow.htm#start-a-new-flow), como bancos de dados e tabelas.
- Se você [conectar-se ao Salesforce Data Cloud](https://help.tableau.com/current/pro/desktop/pt-br/examples_data_cloud.htm), você verá suporte para objetos nativos do Data Cloud integrados ao Tableau Catalog. Objetos de Data Lake (DLOs), objetos de modelo de dados (DMOs) e informações calculadas aparecem distintos nas páginas de pesquisa, conexão e linhagem, o que torna mais simples descobri-los, conectá-los e reutilizá-los.

### Curadoria e confiança

- [Certifique seus ativos de dados](https://help.tableau.com/current/server/pt-br/datasource_certified.htm) para ajudar os usuários a encontrar dados confiáveis e recomendados.
- Defina os [avisos de qualidade de dados](https://help.tableau.com/current/server/pt-br/dm_dqw.htm) para alertar os usuários sobre problemas de qualidade de dados, como dados obsoletos ou preteridos.
- Adicionar [rótulos de sensibilidade](https://help.tableau.com/current/server/pt-br/dm_labels_sensitivity.htm) para alertar os usuários sobre dados que precisam ser tratados com cuidado.
- Adicionar [rótulos personalizados](https://help.tableau.com/current/server/pt-br/dm_labels_custom_categories.htm) para classificar os dados de maneira que atendam às necessidades da sua organização
- [Gerenciar rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm) para estender os nomes e categorias dos rótulos disponíveis aos usuários.
- Categorize itens no Tableau Server e no Tableau Cloud usando [marcas](https://help.tableau.com/current/pro/desktop/pt-br/tags.htm) para ajudar os usuários a filtrar ativos externos.
- Entenda melhor as visualizações publicadas usando a guia [Detalhes de dados](https://help.tableau.com/current/pro/desktop/pt-br/data_explore_analyze_interact.htm#use-data-details-to-see-visualization-information) para ver informações sobre os dados usados.
- [Adicione descrições](https://help.tableau.com/current/pro/desktop/pt-br/qs_content_page.htm#add-or-edit-descriptions) a bancos de dados, tabelas e colunas para ajudar os usuários a localizarem os dados que estão procurando.

### Linhagem e análise de impacto

- Use a [linhagem](https://help.tableau.com/current/server/pt-br/dm_lineage.htm) para rastrear a origem dos seus dados e analisar o impacto das alterações nos dados e identificar quais usuários podem ser afetados.
- [Envie e-mail para proprietários](https://help.tableau.com/current/server/pt-br/dm_lineage.htm#email) de uma pasta de trabalho, uma fonte de dados ou um fluxo sobre atualizações relacionadas aos dados. Faça o mesmo com contatos de banco de dados, tabelas ou objetos.

### Recursos do desenvolvedor

Você pode usar métodos de metadados na REST API do Tableau para atualizar de forma programática determinados metadados. Para obter mais informações sobre métodos de metadados, consulte [Métodos de metadados](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_metadata.htm) na REST API do Tableau Server.

Além da REST API, é possível usar a [API de metadados do Tableau](https://help.tableau.com/current/api/metadata_api/pt-br/index.html) para consultar de forma programática os metadados do conteúdo publicado no Tableau Cloud ou no Tableau Server. A API de metadados é rápida e flexível, além de ser a melhor quando você está procurando informações específicas sobre a relação entre os metadados e suas estruturas. Explorar e testar consultas em relação à API de Metadados usando uma ferramenta interativa no navegador chamada [GraphiQL](https://help.tableau.com/current/api/metadata_api/en-us/docs/meta_api_start.html#explore-the-metadata-api-schema-using-graphiql).

**Observação:** o Data Management não é necessário para usar a API de Metadados ou GraphiQL.

<!-- document id=7a493cdbdeac1b1b5e8425601c8b5f2390865c1c3127d556958d05b57de30ff2 url=/tableau/current/pt-br/server/to_tab_enterprise_features.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre o Tableau Enterprise

O Tableau Enterprise é nosso pacote de software avançado para ajudar você a explorar e gerenciar dados com mais rapidez com Tableau Server. Ele também facilita a aquisição dos recursos necessários às organizações que exigem dados avançados e opções de gerenciamento de implantação.

## Licenciamento do Tableau Enterprise

A partir de março de 2026, o Tableau Enterprise será vendido nos seguintes modelos:

- **Tableau Server ou Tableau Cloud Role-Based Edition**
    
    O Role-Based Edition é vendido em um modelo de licenciamento baseado em função por usuário, incluindo Creators, Explorers e Viewers. Esse modelo está estruturado em torno de funções específicas dentro de uma organização, cada uma exigindo diferentes níveis de funcionalidade. Com o Tableau Enterprise, cada licença baseada em função inclui gerenciamento de dados, gerenciamento avançado e eLearning para criadores e exploradores. Disponível para Tableau Server ou Tableau Cloud.
- **Tableau Server Core Edition**
    
    O Core Edition baseia-se na capacidade, é vendido em incrementos de 8 núcleos e inclui o Advanced Management e o Data Management na licença. Disponível apenas para o Tableau Server.

## Tabela de recursos do Tableau Enterprise

A tabela a seguir lista os recursos incluídos e exigem uma licença válida da edição de licença do Tableau Empresarial. A disponibilidade de recursos abaixo é indicada para o Creator. Existem diferenças nas funcionalidades disponíveis entre Creator, Explorer e Viewer.

<table style="width: 100%;" class="table--plain"><colgroup><col style="width: 286px;"><col></colgroup><tbody><tr><td>Recurso</td><td>Descrição</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/default.htm" target="_blank" title="Ajuda para criação na Web e Tableau Desktop">Criação do Tableau</a></td><td>Use a criação na Web do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou do Tableau no Tableau Server para criar, colaborar e compartilhar informações sobre seus dados. O Tableau oferece uma maneira de identificar e resolver problemas ou destacar as principais descobertas de uma forma visual e de fácil compreensão.</td></tr><tr><td><a href="https://help.tableau.com/current/prep/pt-br/prep_welcome.htm" target="_blank" title="Ajuda do Tableau Prep">Tableau Prep</a></td><td>O Tableau Prep é uma ferramenta de preparação de dados para limpar, modelar e combinar dados para análise.</td></tr><tr><td><a href="https://www.tableau.com/pt-br/learn/training/elearning-courses" target="_blank" title="Tableau eLearning">eLearning</a></td><td>Treinamento baseado em funções Os caminhos de aprendizagem do Tableau fornecem um caminho claro para a proficiência com o conteúdo de treinamento mais atualizado do Tableau. As avaliações ajudam você a avaliar onde você está em seu caminho de aprendizagem e lhe dão confiança em suas novas habilidades. Acelere o processo de integração de novos funcionários e ajude usuários mais experientes a aproveitar ao máximo os recursos do Tableau.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/dm_overview.htm" target="_blank" class="xref">Sobre Data Management</a></td><td>Data Management é uma coleção de recursos e funcionalidades que ajudam os clientes a gerenciar conteúdo do Tableau e ativos de dados em seu ambiente Tableau Server .</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/itm_intro.htm" class="xref">Sobre o Tableau Advanced Management no Tableau Server</a></td><td>O Advanced Management é uma coleção de recursos e funcionalidades projetados para fornecer segurança, gerenciamento e escalabilidade aprimorados do Tableau Server.</td></tr></tbody></table>

<!-- document id=e82f8c11b8cc36401f47ea0edd4db0862a131d2e5e427fc12e035ed7530ef955 url=/tableau/current/pt-br/server/tab_server_plus_features.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre o Tableau Server+

O Tableau Server+ é o nosso pacote de software avançado para ajudar você a explorar e gerenciar dados rapidamente com o Tableau Server. O Tableau Server+ inclui o Tableau Agent na criação, no Premium Success e em implantações expandidas (um ambiente de produção e até seis ambientes de não produção adicionais para teste). Ele também facilita a aquisição dos recursos necessários às organizações que exigem dados avançados e opções de gerenciamento de implantação.

## Licenciamento do Tableau Server+

A partir de julho de 2026, o Tableau Server+ será vendido em dois modelos:

- Tableau Server Role-Based Edition
    
    O Role-Based Edition é vendido em um modelo de licenciamento baseado em função por usuário, incluindo Creators, Explorers e Viewers. Esse modelo está estruturado em torno de funções específicas dentro de uma organização, cada uma exigindo diferentes níveis de funcionalidade. Com o Tableau Server+, cada licenciamento baseado em função inclui o Data Management, Advanced Management e eLearning para Creators e Explorers.
- Tableau Server Core Edition
    
    O Core Edition baseia-se na capacidade, é vendido em incrementos de 8 núcleos e inclui o Advanced Management e o Data Management na licença.

## Tabela de recursos do Tableau Server+

A tabela a seguir lista os recursos incluídos na edição da licença do Tableau Server+. A disponibilidade de recursos abaixo é indicada para o Creator. Existem diferenças nas funcionalidades disponíveis entre Creator, Explorer e Viewer.

<table style="width: 100%;" class="table--plain"><colgroup><col style="width: 286px;"><col></colgroup><tbody><tr><td>Recurso</td><td>Descrição</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/pt-br/default.htm" target="_blank" title="Ajuda para criação na Web e Tableau Desktop">Criação do Tableau</a></td><td>Use a criação na Web do <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> ou do Tableau no Tableau Server para criar, colaborar e compartilhar informações sobre seus dados. O Tableau oferece uma maneira de identificar e resolver problemas ou destacar as principais descobertas de uma forma visual e de fácil compreensão.</td></tr><tr><td><a href="https://help.tableau.com/current/prep/pt-br/prep_welcome.htm" target="_blank" title="Ajuda do Tableau Prep">Tableau Prep</a></td><td>O Tableau Prep é uma ferramenta de preparação de dados para limpar, modelar e combinar dados para análise.</td></tr><tr><td><a href="https://www.tableau.com/pt-br/learn/training/elearning-courses" target="_blank" title="Tableau eLearning">eLearning</a></td><td>Treinamento baseado em funções Os caminhos de aprendizagem do Tableau fornecem um caminho claro para a proficiência com o conteúdo de treinamento mais atualizado do Tableau. As avaliações ajudam você a avaliar onde você está em seu caminho de aprendizagem e lhe dão confiança em suas novas habilidades. Acelere o processo de integração de novos funcionários e ajude usuários mais experientes a aproveitar ao máximo os recursos do Tableau.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/dm_overview.htm" target="_blank" class="xref">Sobre Data Management</a></td><td>O Data Management é uma coleção de recursos e funcionalidades que ajudam os clientes a gerenciar o conteúdo do Tableau e ativos de dados em seu ambiente do Tableau Server.</td></tr><tr><td><a href="https://help.tableau.com/current/server/pt-br/itm_intro.htm" class="xref">Sobre o Tableau Advanced Management no Tableau Server</a></td><td>O Advanced Management é uma coleção de recursos e funcionalidades projetados para fornecer segurança, gerenciamento e escalabilidade aprimorados do Tableau Server.</td></tr><tr><td><a href="https://www.salesforce.com/services/success-plans/overview/premier-success-plans/" target="_blank" alt="Link to Salesforce  Premier Success Plans web page">Premier Success</a></td><td>O Plano Premier Success ajuda você a começar bem, expandir seus negócios e obter mais valor do Salesforce com orientação especializada e suporte rápido.</td></tr></tbody></table>

<!-- document id=9354e4028208ad45d36b578856e62db251a69b5336e9c6c0ee25df01eba5cd18 url=/tableau/current/pt-br/server/ipa_vconn_about_data_policy.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre políticas de dados

Use uma política de dados quando você quiser aplicar segurança em nível de linha a uma ou mais tabelas na conexão. As políticas de dados se aplicam a conexões em tempo real e de extração.

Uma política de dados tem três componentes:

![Um exemplo dos três componentes de uma política de dados](/tableau/current/pt-br/server/pt-br/Img/ipa_vconns_policy_components.png)

1. As tabelas às quais se aplica, chamadas de tabelas de políticas. Essas são as tabelas filtradas.
2. As colunas mapeadas que definem os relacionamentos entre tabelas (por exemplo, entre tabelas de direitos e de fatos) e entre colunas de tabela e de política. Uma coluna de política é a usada para filtrar dados.
3. A condição da política, que é uma expressão avaliada para cada linha no momento da consulta. Quando TRUE, a linha é mostrada na consulta.

Para começar, clique em ![botão Criar Nova Política](/tableau/current/pt-br/server/pt-br/Img/ipa_Create_New_Policy_btn.png).

[Leia o tópico completo](https://help.tableau.com/current/server/pt-br/dm_vconn_create_rlspolicy.htm)

## Tarefas relacionadas

[Sobre o Editor de conexão virtual](https://help.tableau.com/current/server/pt-br/ipa_vconn_about_editor.htm)

[Adicionar tabelas à conexão](https://help.tableau.com/current/server/pt-br/ipa_vconn_add_tables.htm)

[Criar e testar políticas de dados](https://help.tableau.com/current/server/pt-br/ipa_vconn_create_data_policy.htm)

Não encontrou o que você precisa?

Fique online para ver [toda a ajuda do Tableau](https://www.tableau.com/pt-br/support/help)

<!-- document id=f03e26a07996db90e04ff8419d23bf3fefc1e563ae9baf711aef5c26964b8c13 url=/tableau/current/pt-br/server/rmt-intro.md -->

[Pular para o conteúdo principal](#main-content)

# Sobre Resource Monitoring Tool do Tableau

Este documento fornece uma visão geral do Resource Monitoring Tool do Tableau.

## O que é Resource Monitoring Tool?

A Resource Monitoring Tool é uma ferramenta que pode ser usada para monitorar a integridade e o desempenho do Tableau Server. Ela coleta dados do Tableau Server e fornece uma análise abrangente da integridade do Tableau Server. Usando essa ferramenta, é possível identificar a causa da lentidão nos tempos de carregamento, falhas de extração e outros problemas críticos. Para usar o Resource Monitoring Tool, você deve ter o Advanced Management ativado em seu servidor. Para obter mais informações sobre o Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

O Resource Monitoring Tool tem dois componentes principais: Resource Monitoring Tool Server (Servidor RMT) e Agente.

- O Servidor RMT é onde os dados do Tableau Server são agrupados e fornecidos por meio de uma interface da Web. Aqui também é onde você pode configurar, monitorar e analisar a integridade e o desempenho do Tableau Server.
- Um agente é executado em cada um dos nós no cluster do Tableau para monitorar o desempenho e a atividade. O diagrama a seguir ilustra a interação entre um nó do Tableau Server e o Servidor RMT do nó.

![Um diagrama que ilustra o fluxo de dados de um servidor mestre para um nó.](/tableau/current/pt-br/server/pt-br/Img/rmt-data-flow.png)

## Outros artigos nesta seção

<!-- document id=975e1a2c75690c27a5a5a3eeb5f091f2c314dafeb22a61fc4eab9cb2313836d5 url=/tableau/current/pt-br/server/trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas

Você pode usar os seguintes tópicos para solucionar problemas no Tableau Server.

## Outros artigos nesta seção

<!-- document id=6a8c9d96db32010fd3b7e57a186daf562c378b84347415c4f85032e1d86107e3 url=/tableau/current/pt-br/server/ssl_mutual_troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas da autenticação mútua do SSL

Este tópico descreve possíveis problemas de autenticação de SSL mútuo (de mão dupla) e suas causas, as mensagens que os usuários poderão ver e as possíveis soluções para os problemas.

Para obter mais informações sobre autenticação de SSL mútuo e mapeamento de usuário LDAP, UPN e CN, consulte os seguintes tópicos:

- [Configurar autenticação do SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm)
- [Mapeamento de um certificado de cliente para um usuário durante a autenticação mútua](https://help.tableau.com/current/server/pt-br/ssl_mutual_mapping_username.htm)

## Não foi possível localizar um certificado de cliente válido. Entre em contato com o administrador do Tableau Server.

Falta um certificado para o cliente.

Se o cliente não tiver certificado do cliente, o usuário verá esta mensagem durante a autenticação:

`We couldn't find a valid client certificate. Contact your Tableau Server administrator.`

Para resolver o problema, o usuário deverá contactar o administrador do sistema para gerar um certificado para o computador do cliente.

## Nome de usuário ou senha inválido

O cliente não dá suporte à autenticação de SSL mútuo.

As versões do Tableau Desktop mais antigas que a versão 9.1 não dão suporte à autenticação de SSL mútuo. Se uma versão antiga do Tableau Desktop for usada para se conectar ao Tableau Server que está configurado para autenticação de SSL mútuo, o seguinte poderá ocorrer:

- Se o Tableau Server estiver configurado para usar autenticação de fallback, o cliente exibirá uma caixa de diálogo de entrada e o usuário poderá inserir um nome de usuário e a senha.
- Se o servidor não estiver configurado para usar autenticação de fallback, o usuário verá a seguinte mensagem e não poderá se conectar ao servidor:
    
    `Invalid user name or password`.

Para obter mais informações sobre a autenticação de fallback, consulte [Configurar autenticação do SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm).

## Não foi possível localizar seu nome de usuário no certificado do cliente. Contact your Tableau Server administrator or sign in using your Tableau Server account.

Os certificados de cliente não são publicados no Active Directory.

Se o Tableau Server estiver configurado para usar o Active Directory para autenticação e se o mapeamento de usuário estiver definido para LDAP, o Tableau Server enviará o certificado do cliente para o Active Directory para autenticação. No entanto, se os certificados do cliente não tiverem sido publicados no Active Directory, haverá falha na autenticação e o usuário verá a seguinte mensagem:

`We couldn't find your user name in the client certificate. Contact your Tableau Server administrator or sign in using your Tableau Server account.`.

Para resolver este problema, o administrador do sistema deverá garantir que os certificados do cliente estejam publicados no Active Directory. Como alternativa, o servidor deve ser configurado para usar um mapeamento de usuário diferente (UPN ou CN) e o administrador de sistema deve ter certeza de que os certificados de cliente contêm nomes de usuário nos campos UPN ou CN.

## Os usuários inesperadamente veem uma caixa de diálogo de entrada que exibe uma mensagem de erro

Se o Tableau Server estiver configurado para usar a autenticação mútua de SSL e os certificados estiverem disponíveis para uso com os computadores dos usuários, um usuário não deverá ver uma caixa de diálogo de entrada, porque o Tableau Server usará o certificado para autenticar o usuário. No entanto, se o servidor não reconhecer o nome de usuário no certificado, o usuário verá uma caixa de diálogo de entrada com uma mensagem de erro que indica por que o certificado não foi usado. Isto poderá ocorrer quando todas as condições a seguir forem verdadeiras:

- A autenticação de fallback está habilitada.
- Se o servidor estiver usando o mapeamento do UPN ou CN, o nome de usuário no campo UPN ou CN do certificado não será reconhecido. Se o servidor estiver usando o mapeamento de LDAP, o certificado não estará mapeado para o usuário no Active Directory.

Para resolver este problema, o administrador do sistema deverá fazer o seguinte, dependendo de como o mapeamento de usuário está configurado no Tableau Server:

- Mapeamento de LDAP: verifique se o certificado está vinculado ao usuário, se o certificado está disponível para uso com o computador do usuário e se o usuário está configurado como usuário do Tableau Server.
- Mapeamento de UPN ou CN: verifique se o certificado está disponível para o computador do usuário, se o nome de usuário está no campo UPN ou CN do certificado e se o nome de usuário corresponde ao nome de usuário no Tableau Server (incluindo domínio).

## Não foi possível localizar seu nome de usuário no certificado do cliente. Entre em contato com o administrador do Tableau Server  
O certificado não contém um nome de usuário válido do Tableau Server.

O nome de usuário nos campos UPN ou CN estão faltando ou são inválidos

Quando o Tableau Server estiver configurado para usar o mapeamento de UPN ou CN, o servidor lerá o nome do usuário do campo UPN ou CN do certificado e, em seguida, procurará o nome do usuário no Active Directory ou no repositório local no Tableau Server. (O campo específico que o servidor lê depende de qual mapeamento — UPN ou CN — o servidor está configurado para usar.) Se o campo que deveria conter o nome de usuário estiver vazio, o usuário verá a seguinte mensagem:

`We couldn't find your user name in the client certificate. Contact your Tableau Server administrator.`.

Se o certificado do cliente contiver um nome de usuário, mas o Active Directory e o Tableau Server não o reconhecerem, o usuário verá a seguinte mensagem de erro:

`Certificate does not contain a valid Tableau Server user name.`.

Isto poderá ocorrer quando todas as condições a seguir forem verdadeiras:

- O Tableau Server está configurado para usar o mapeamento de UPN ou CN.
- A autenticação de fallback não está habilitada.
- O certificado do cliente não tem nome de usuário no campo UPN ou CN ou o nome de usuário no campo UPN ou CN não corresponde ao nome de usuário no Active Directory ou Tableau Server.

Para resolver este problema, o administrador do sistema deverá garantir que o certificado do cliente tenha o nome de usuário correto nos campos UPN ou CN do certificado.

## O usuário entrou usando um nome de usuário inesperado (mapeamento de LDAP)

Quando o servidor estiver configurado para usar a autenticação do Active Directory e o mapeamento do LDAP, o certificado estará vinculado a um usuário no Active Directory. Se o certificado contiver um nome de usuário no campo UPN ou CN, este nome de usuário será ignorado.

Se a intenção é que o usuário deverá estar conectado com o nome de usuário nos campos UPN ou CN, o servidor deverá estar configurado para usar o mapeamento de UPN ou CN.

## O usuário entrou como o usuário incorreto (mapeamento de UPN ou CN)

Em algumas circunstâncias, o nome do usuário em um campo UPN ou CN no certificado do cliente pode ser ambíguo. O resultado é que um usuário entrou com a identidade incorreta.

Para obter mais informações sobre as condições sob as quais este problema pode ocorrer, consulte a seção “Como lidar com nomes de usuário ambíguos em organizações com vários domínios” em [Mapeamento de um certificado de cliente para um usuário durante a autenticação mútua](https://help.tableau.com/current/server/pt-br/ssl_mutual_mapping_username.htm).

<!-- document id=66b55fb82fc05fbb0334e3291c9160103d8d14b20c235b4933eba680276b8524 url=/tableau/current/pt-br/server/connected_apps_troubleshoot.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas de aplicativos conectados- Confiança direta

Quando o conteúdo inserido não consegue ser exibido em seu aplicativo personalizado ou a autorização da API REST do Tableau falha, você pode usar as ferramentas de desenvolvedor de um navegador, para inspecionar e identificar códigos de erro que podem estar associados ao aplicativo conectado ao Tableau usado para exibir o conteúdo inserido.

**Observação:** Para que o token de sessão seja válido, os relógios do aplicativo externo e do servidor que hospeda o aplicativo externo devem ser definidos como Tempo Universal Coordenado (UTC). Se um dos relógios usar um padrão diferente, o aplicativo conectado não será confiável.

Consulte a tabela abaixo para revisar a descrição do código de erro e a resolução potencial.

<table style="width: 90%;margin-left: 0;margin-right: auto;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Código de erro</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Resumo</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Descrição</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Resolução ou explicação potencial</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">5</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SYSTEM_USER_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não foi possível encontrar o usuário do Tableau</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"> Para resolver esse problema, verifique se o valor da declaração '<code>sub</code>’ (Assunto) no JWT é "nome de usuário" para o Tableau Server. Este valor diferencia maiúsculas de minúsculas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">16</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">LOGIN_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Falha no logon</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esse erro normalmente é causado por um dos seguintes problemas de reivindicação no JWT:<ul><li>O '<code>exp</code>' (Tempo de expiração) excede o período de validade máximo padrão. Para resolver esse problema, analise <a href="https://help.tableau.com/current/server/pt-br/connected_apps.htm#jwt" target="_blank">as reivindicações registradas</a> necessárias para um JWT válido e certifique-se de que o valor correto seja usado. Para alterar o período máximo de validade, você pode usar o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#connectedapps_max_expiration_period" class="xref">vizportal.oauth.connected_apps.max_expiration_period_in_minutes</a></li><li>O '<code>sub</code>' (Assunto) está chamando um usuário desconhecido. Para resolver esse problema, verifique se a declaração 'sub' é "username". Este valor diferencia maiúsculas de minúsculas.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">67</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">FEATURE_NOT_ENABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O acesso sob demanda não é compatível</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O acesso sob demanda está disponível somente por meio de sites licenciados do Tableau Cloud.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">126</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O aplicativo conectado não foi encontrado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se o aplicativo conectado está habilitado, e se o ID do cliente correto (também conhecido como o ID do aplicativo de conexão) é mencionado no JWT.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">127</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_SECRET_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O segredo do aplicativo conectado não foi encontrado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se o ID secreto do aplicativo conectado correto e o valor secreto estão mencionados no JWT.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">128</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_SECRET_LIMIT_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O limite máximo de segredos foi atingido</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um máximo de dois segredos são permitidos para um aplicativo conectado. Este erro pode ocorrer quando há uma tentativa de criar um terceiro segredo.<p>Para resolver esse problema, exclua um segredo do aplicativo conectado antes de criar um novo.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">133</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">INVALID_CONNECTED_APP_DOMAIN_SAFELIST</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A lista de permissões de domínio contém um ou mais caracteres inválidos</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esse erro pode ocorrer quando a lista de permissões do domínio contém um ou mais caracteres inválidos.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10083</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BAD_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O cabeçalho JWT contém problemas</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">As declarações de '<code>kid</code>’ (ID secreta) ou '<code>clientId</code>' (Emissor) estão faltando no cabeçalho JWT. Para resolver esse problema, certifique-se de que essas informações estejam incluídas.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10084</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_PARSE_ERROR</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT contém problemas</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver o problema, verifique o seguinte:<ul><li>O valor '<code>aud</code>' (Público) referenciado no JWT usa o valor "tableau". Este valor diferencia maiúsculas de minúsculas.</li><li>O '<code>aud</code>' (Público) e '<code>sub</code>' (Assunto) estão incluídos no JWT.</li><li>Revise o IssueTime ou certifique-se de que não haja incompatibilidade de relógio entre a máquina que hospeda o aplicativo conectado e o Tableau Cloud.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10085</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_FETCH_JWT_KEYS</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O JWT não conseguiu encontrar as chaves</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Não foi possível encontrar o segredo.<p>Para resolver esse problema, verifique se 'kid’ (a ID secreta) correto é usado no cabeçalho JWT. </p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10087</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGN</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problema com o algoritmo de assinatura JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver o problema, você pode remover o algoritmo de assinatura. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_algorithms" class="xref">vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10089</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não foi possível encontrar o aplicativo conectado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se o emissor está chamando o ID do aplicativo conectado correto (também conhecido como ID do cliente). </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10090</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_DISABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O aplicativo conectado está desativado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O aplicativo conectado usado para verificar a confiança está desabilitado. Para resolver esse problema, habilite o aplicativo conectado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10091</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_ALREADY_USED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT exclusivo necessário</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O JWT já foi usado no processo de autenticação. Para resolver esse problema, um novo JWT deve ser gerado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10092</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">NOT_IN_DOMAIN_ALLOW_LIST</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">O domínio do conteúdo inserido não foi especificado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se a configuração <code>unrestrictedEmbedding</code> está definida como <code>true</code> ou se o parâmetro <code>domainAllowlist</code> inclui os domínios nos quais o conteúdo do Tableau está inserido usando o método <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#embedding_settings_for_site" target="_blank">Atualizar as configurações de inserção para site</a> na API REST do Tableau.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10094</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MISSING_REQUIRED_JTI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ID do JWT ausente</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Para resolver esse problema, verifique se o '<code>jti</code>' (ID do JWT) está incluído no JWT.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10096</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problema com tempo de expiração</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"> O '<code>exp</code>' (Tempo de expiração) excede o período de validade máximo padrão. Para resolver esse problema, analise <a href="https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm#jwt" target="_blank">as reivindicações registradas</a> necessárias para um JWT válido e certifique-se de que o valor correto seja usado. Para alterar o período máximo de validade, você pode usar o comando <a href="https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#eas_max_expiration_period" class="xref">vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10097</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MALFORMED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Problemas com a reivindicação de escopos</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esse erro pode ocorrer quando o '<code>scp</code>' (Escopo) está faltando no JWT ou não foi passado como um tipo de lista. Para resolver esse problema, verifique '<code>scp</code>' é incluído no JWT e passado como um tipo de lista. Para obter ajuda na solução de problemas com um JWT, consulte <a href="https://jwt.io/" target="_blank">Depurador</a> no site auth0.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10098</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_UNSIGNED_OR_ENCRYPTED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT não está assinado ou criptografado</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O Tableau não oferece suporte a JWT não assinado ou criptografado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10099</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MISSING_IN_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Declaração de escopos ausente</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O JWT não tem a declaração '<code>scp</code> ' (escopo) necessária. Para resolver esse problema, verifique se o '<code>scp</code>' está incluído no JWT. Para obter ajuda na solução de problemas com um JWT, consulte <a href="https://jwt.io/" target="_blank">Depurador</a> no site auth0.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10100</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_PERSISTENCE_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Erro inesperado de ID JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Ocorreu um erro inesperado de '<code>jti</code> ' (ID JWT). Para resolver esse problema, um novo JWT com um novo '<code>jti</code>’ deve ser gerado.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10103</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_MAX_SIZE_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT excede o tamanho máximo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Esse erro pode ocorrer quando o tamanho do JWT excede 8.000 bytes. Para resolver esse problema, certifique-se de que apenas as declarações necessárias estejam sendo passadas para <span class="mc-variable Variables.ProductName variable">Tableau Server</span>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10105</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ORIGIN_HEADER_NOT_A_VALID_URI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Cabeçalho de origem inválido</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Este erro pode ocorrer porque 1) uma URL é especificado na lista de permissões do domínio e 2) o cabeçalho Origin não contém uma URL válida.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">10106</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">ORIGIN_HEADER_NOT_SET</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Cabeçalho de origem ausentes</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Este erro pode ocorrer porque 1) uma URL é especificada na lista de permissões do domínio e 2) o cabeçalho de origem não está definido. </td></tr></tbody></table>

<!-- document id=d5f28709f64464fad2c09400f66e7222f21883d8ad125e205c31d0ef27d53631 url=/tableau/current/pt-br/server/trouble_backup_timeout.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas do backup do Tableau Services Manager (TSM)

## O backup não é iniciado porque os serviços não começam

Ao fazer um backup do Tableau Server, uma das primeiras etapas tomadas é confirmar que os principais serviços estão em execução e, se não estiverem, iniciá-los. Se esses serviços não puderem ser iniciados:

- Repositório ativo
- Armazenamento de arquivo
- Controlador do cluster

ocorrerá falha em qualquer tentativa de fazer backup do Tableau Server com um dos seguintes erros:

An error occurred starting one or more of the following services: Active Repository, File Store, Cluster Controller.

One or more of the following services did not start in a timely fashion: Active Repository, File Store, Cluster Controller.

Para fazer o backup do Tableau Server com sucesso, verifique se esses processos podem ser iniciados.

## O backup falha com um erro de violação de compartilhamento.

O backup do TSM pode falhar com um erro enganoso quando há falta de espaço em disco.

Se o backup falhar com uma "violação de compartilhamento" verifique esses registros para obter erros semelhantes a estes:

### tabadmincontroller\*.log

2019-02-27 13:42:16.011 -0600  pool-37-thread-2 : INFO  
com.tableausoftware.tabadmin.webapp.backup.AbstractBackupSingleInstanceAction - Starting 'backup' call on node1:8315 for service pgsql\_0.20183.18.1214.0808 with params 
{"node":"node1","skipVerification":false,"singleNode":true,"origin":"COMMAND\_LINE","writePath":"testbackup.tsbak","postgresOnly":false,"overrideDiskSpaceCheck":false,"skipCompression":false}

### tabadminagent\*.log

2019-02-27 13:44:01.796 -0600  pool-14-thread-5 : ERROR org.apache.thrift.server.TThreadPoolServer - Error occurred during processing of message.
				java.lang.RuntimeException: org.apache.thrift.TException: java.nio.file.FileSystemException: C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\tabadminagent\\0\\filetransfer\\df699acb-731a-41dd-af6b-baa39e2d6cc3: The process cannot access the file because it is being used by another process.

				at com.google.common.base.Throwables.propagate(Throwables.java:241)
				at com.tableausoftware.tabadmin.agent.services.TRestoreFileTransferHandler.processFile(TRestoreFileTransferHandler.java:110)
				at com.tableausoftware.file.transfer.endpoint.FileTransferHandler$Processor$processFile.getResult(FileTransferHandler.java:262)
				at com.tableausoftware.file.transfer.endpoint.FileTransferHandler$Processor$processFile.getResult(FileTransferHandler.java:246)
				at org.apache.thrift.ProcessFunction.process(ProcessFunction.java:39)
				at org.apache.thrift.TBaseProcessor.process(TBaseProcessor.java:39)
				at org.apache.thrift.TMultiplexedProcessor.process(TMultiplexedProcessor.java:123)
				at org.apache.thrift.server.TThreadPoolServer$WorkerProcess.run(TThreadPoolServer.java:286)
				at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
				at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
				at java.lang.Thread.run(Thread.java:748)
				Caused by: org.apache.thrift.TException: java.nio.file.FileSystemException: C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\tabadminagent\\0\\filetransfer\\df699acb-731a-41dd-af6b-baa39e2d6cc3: The process cannot access the file because it is being used by another process.

				at com.tableausoftware.file.transfer.filetransferservice.server.FileTransferServiceHandler.deleteTransfer(FileTransferServiceHandler.java:217)
				at com.tableausoftware.tabadmin.agent.services.TRestoreFileTransferHandler.processFile(TRestoreFileTransferHandler.java:106)
				... 9 more
				Caused by: java.nio.file.FileSystemException: C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\tabadminagent\\0\\filetransfer\\df699acb-731a-41dd-af6b-baa39e2d6cc3: The process cannot access the file because it is being used by another process.

				at sun.nio.fs.WindowsException.translateToIOException(WindowsException.java:86)
				at sun.nio.fs.WindowsException.rethrowAsIOException(WindowsException.java:97)
				at sun.nio.fs.WindowsException.rethrowAsIOException(WindowsException.java:102)
				at sun.nio.fs.WindowsFileSystemProvider.implDelete(WindowsFileSystemProvider.java:269)
				at sun.nio.fs.AbstractFileSystemProvider.deleteIfExists(AbstractFileSystemProvider.java:108)
				at java.nio.file.Files.deleteIfExists(Files.java:1165)
				at com.tableausoftware.file.transfer.filetransferservice.server.FileTransferServiceHandler.deleteTransfer(FileTransferServiceHandler.java:215)
			... 10 more

Isso pode ser uma indicação de que o backup falhou porque não havia espaço suficiente em disco.

<!-- document id=b61b8f747b45c0dc604249dd29d25b9744b1d0e3342ebe1654aa7818dc71b879 url=/tableau/current/pt-br/server/server-helm-troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server Helm Chart - Solução de problemas

**Importante**: esta documentação pressupõe um conhecimento do Helm e de Helm Charts e não tenta fornecer exemplos prescritivos detalhados. Ele foi criado para clientes que estão familiarizados com o Tableau Server e com o Helm e Helm Charts.

## Introdução

Este tópico fornece ajuda para você diagnosticar e resolver problemas comuns ao implantar o Tableau Server no Kubernetes usando um Helm Chart. Ele aborda problemas de instalação, problemas de tempo de execução e técnicas de depuração.

## Etapas de solução de problemas gerais

Ao encontrar problemas com o Tableau Server no Kubernetes:

1. Verificar status e eventos do pod
2. Consultar registros de contêiner
3. Verificar a disponibilidade de recursos
4. Verificar reivindicações de volume persistentes
5. Rever o status de versão do Helm
6. Examinar conectividade de serviço e rede

## Pods que não iniciam

1. Verifique o status do pod:
    
    kubectl get pods -l app.kubernetes.io/instance=tableau-server  
    kubectl describe pod <pod-name>
2. Verifique os logs:
    
    kubectl logs <pod-name>
3. Verifique os eventos:
    
    kubectl get events --sort-by='.lastTimestamp'

## Problemas com volumes persistentes

1. Verifique o status do PVC:
    
    kubectl get pvc  
    kubectl describe pvc <pvc-name>
2. Verifique a classe de armazenamento:
    
    kubectl get storageclass

## Problemas com a chave de ativação de licença

1. Verifique se a chave de ativação de licença está definida:
    
    kubectl get secret tableau-server-secrets -o 
    jsonpath='{.data.LICENSE\_KEY}' | base64 -d
2. Atualize a chave de ativação de licença:
    
    \# Edit values.yaml and upgrade  
    helm upgrade tableau-server ./helm/tableau-server -f ./helm/tableau-server/values.yaml

## Falhas na verificação de integridade

1. Verifique o script de verificação de integridade:
    
    kubectl exec <pod-name> -- /docker/alive-check  
    kubectl exec <pod-name> -- /docker/server-ready-check
2. Ajuste o tempo da verificação de integridade:
    
    healthChecks:  
      liveness:  
        initialDelaySeconds: 600  # Increase if server takes longer to start

## Problemas no bootstrap com múltiplos nós

1. Verifique o volume do bootstrap:
    
    kubectl get pvc | grep bootstrap
2. Verificação de arquivo de bootstrap:
    
    kubectl exec <primary-pod> -- ls -la /docker/config/bootstrap
3. Verifique o modo de acesso ReadWrateMany:
    
    persistence:  
      bootstrap:  
        accessMode: ReadWriteMany  # Required for multi-node
4. Verifique o vínculo PV/PVC de bootstrap para provisionamento de EFS estático:
    
    kubectl get pv tableau-bootstrap-pv  
    kubectl get pvc -n default tableau-server-bootstrap  
    kubectl describe pv tableau-bootstrap-pv  
    kubectl describe pvc -n default tableau-server-bootstrap
5. Se a montagem falhar após o vínculo do VPN, verifique os erros do CSI/IAM do EFS:
    
    kubectl describe pod -n default tableau-server-primary-0  
    kubectl get events -n default --sort-by='.lastTimestamp'
6. Erros `driver name efs.csi.aws.com not found`:
    
    Instale e verifique o complemento EKS conforme descrito em [Pré-requisitos do Amazon Elastic Kubernetes Service (EKS)](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm#EKS-Prereq-storageclass).
7. Corrigir falhas de autorização de `DescribeMountTargets`
    
    - Método preferido:
        
        aws iam attach-role-policy \\  
          --role-name <your-node-instance-role> \\  
          --policy-arn   
        arn:aws:iam::aws:policy/AmazonElasticFileSystemClientReadWriteAccess
        
        Em seguida, reinicie os pods afetados (o nó principal e todos os nós trabalhadores. Os trabalhadores são selecionados por rótulo, para que qualquer contagem de réplicas seja incluída.
    - Método alternativo
        
        Forçar a montagem do IP de destino na configuração de PV de bootstrap:
        
        Defina `persistence.bootstrap.pv.csi.volumeAttributes.mounttargetip` (ou o PV manual `volumeAttributes.mounttargetip`) e reaplique/atualize.

## Recursos adicionais

- [Documentação do Tableau Server](https://help.tableau.com/current/server-linux/en-us/)
- [Referência sobre Logs do Tableau Server](https://help.tableau.com/current/server-linux/en-us/logs.htm)
- [Solução de problemas do Kubernetes](https://kubernetes.io/docs/tasks/debug/)
- [Solução de problemas do Helm](https://helm.sh/docs/faq/troubleshooting/)
- [Documentação do Helm](https://helm.sh/docs/)

<!-- document id=979931435d4f90a19b4e8a5631297380cbc533fb5c8b7ed412058a2906f22163 url=/tableau/current/pt-br/server/ts_aws_troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas do Tableau Server na AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Siga as sugestões neste tópico para resolver problemas comuns do Tableau Server quando instalado em uma instância da Amazon EC2 na nuvem da AWS.

- **O TSM CLI não funciona por meio de nós adicionais**
    
    O TSM cli foi projetado para que você executasse comandos tsm por meio de qualquer nó em um cluster do servidor ao incluir a opção `-s` para especificar o nome do endereço IP do nó inicial. O sintoma a seguir pode ocorrer ao executar comandos TSM de diversos nós no AWS:
    
    - Ao executar um comando tsm com a opção `-s`, uma mensagem pode ser exibida:
        
        `Unable to verify the server's HTTPS certificate.`
        
        Para executar o TSM na linha de comando por meio de qualquer nó além do nó inicial, é necessário usar o alternador `-s` e o endereço IP privado do nó inicial.
- **O Tableau Server não usa todos os núcleos da CPU**
    
    Um ou mais dos sintomas a seguir podem ocorrer ao trabalhar com a licença com base em núcleos do Tableau Server:
    
    - Ao instalar o Tableau Server, o instalador pode mostrar menos núcleos do que o esperado para o computador que o executa.
    - Na página Licenças do Tableau Server, o número de núcleos listados em Licenças em uso é menor do que o esperado.
    - Ao executar `tsm licenses list`, o Tableau Server pode informar um número menor de núcleos em uso do que o esperado.
    
    Para obter mais informações, consulte [Alguns núcleos não são reconhecidos pelo Tableau Server](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=pt-br).
- **Existe uma alta latência de E/S**
    
    Ao alterar a configuração de desempenho do driver do disco para **Melhor desempenho** talvez seja possível melhorar os resultados.

<!-- document id=7f73ce97932b4451e2ad515183a7ab639c4775cba8ef04be40f84be84bb0789e url=/tableau/current/pt-br/server/ts_gcp_troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas do Tableau Server na Google Cloud Platform

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Caso tenha problemas com o Tableau Server em sua máquina virtual (VM) do Google Compute Engine (GCE) ou ao acessar o Tableau Server após a instalação, consulte estas dicas de solução de problemas.

- **Não é possível se conectar à VM usando o RDP**
    
    Um ou mais dos seguintes problemas podem impedir que você se conecte à VM usando o RDP:
    
    - Verifique se está usando as credenciais corretas.
    - Selecione a opção **Outro usuário** e insira suas credenciais.
    - Certifique-se de que está usando um nome de usuário válido na instância da GCP. Por exemplo, se você criou a instância com uma conta de administrador de **myuser**, insira **.\\myuser** como o nome de usuário na caixa de diálogo RDP.
- **Não é possível acessar o servidor em um navegador remoto**
    
    Um ou mais dos seguintes problemas podem impedir que você acesse o servidor em um navegador remoto:
    
    - Faça logon na instância e verifique se o servidor está em execução.
    - Na instância, abra um navegador e acesse o servidor localmente (por exemplo, usando http://localhost ou http://localhost:port, em que a porta é o número de porta o qual o servidor foi configurado a escutar).
    - No console Compute Engine da GCP, certifique-se de que configurou um endpoint para permitir tráfego HTTP para a instância.
        
        **Observação:** não é possível usar o utilitário de ping do Windows para testar a conectividade com a instância. O utilitário de ping sempre relatará um tempo limite quando usado na internet pública.
- **Você recebe a seguinte mensagem de erro: o Tableau Server não está licenciado**
    
    Esse erro poderá ocorrer se você tiver desligado instâncias sem primeiro desativar a licença. Entre em contato com o [Suporte do Tableau](http://www.tableau.com/pt-br/support/request).
- **O Tableau Server não usa todos os núcleos da CPU**
    
    Um ou mais dos sintomas a seguir podem ocorrer ao trabalhar com a licença com base em núcleos do Tableau Server:
    
    - Ao instalar o Tableau Server, o instalador pode mostrar menos núcleos do que o esperado para o computador que o executa.
    - Na página Licenças do Tableau Server, o número de núcleos listados em Licenças em uso é menor do que o esperado.
    - Ao executar `tsm licenses list`, o Tableau Server pode informar um número menor de núcleos em uso do que o esperado.
    
    Para obter mais informações, consulte [Alguns núcleos não são reconhecidos pelo Tableau Server](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=pt-br).

<!-- document id=49b54c6adb43795d2d6fad87021878765b1f1c89b5feaa765dc86aeaad2edd03 url=/tableau/current/pt-br/server/ts_azure_troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas do Tableau Server no Microsoft Azure

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Se você estiver tendo problemas com o Tableau Server na Virtual Machine (Máquina virtual, VM) do Microsoft Azure ou para acessar o Tableau Server depois da instalação, leia essas dicas de solução de problemas.

- **Não é possível se conectar à VM usando o RDP**
    
    Um ou mais dos seguintes problemas podem impedir que você se conecte à VM usando o RDP:
    
    - Verifique se está usando as credenciais corretas.
    - Selecione a opção **Outro usuário** e insira suas credenciais.
    - Verifique se você está usando um nome de usuário válido na VM do Microsoft Azure. Por exemplo, se você criou a instância com uma conta de administrador de **myuser**, insira **.\\myuser** como o nome de usuário na caixa de diálogo RDP.
- **Não é possível acessar o servidor em um navegador remoto**
    
    Um ou mais dos seguintes problemas podem impedir que você acesse o servidor em um navegador remoto:
    
    - Faça logon na instância e verifique se o servidor está em execução.
    - Na instância, abra um navegador e acesse o servidor localmente (por exemplo, usando http://localhost ou http://localhost:port, em que a porta é o número de porta o qual o servidor foi configurado a escutar).
    - No painel do Microsoft Azure, verifique se você configurou um endpoint para permitir tráfego HTTP para a instância.
        
        **Observação:** não é possível usar o utilitário de ping do Windows para testar a conectividade com a instância. O utilitário de ping sempre relatará um tempo limite quando usado na internet pública.
- **Você recebe a seguinte mensagem de erro: o Tableau Server não está licenciado**
    
    Esse erro poderá ocorrer se você tiver desligado instâncias sem primeiro desativar a licença. Para obter mais informações, consulte [Erro “O Tableau Server não tem licença” após a reinicialização de uma máquina virtual que hospeda o Tableau Server](https://kb.tableau.com/articles/issue/error-tableau-server-is-unlicensed-after-rebooting-virtual-aws-machine-hosting-tableau-server?lang=pt-br).

- **O Tableau Server não usa todos os núcleos da CPU**
    
    Um ou mais dos sintomas a seguir podem ocorrer ao trabalhar com a licença com base em núcleos do Tableau Server:
    
    - Ao instalar o Tableau Server, o instalador pode mostrar menos núcleos do que o esperado para o computador que o executa.
    - Na página Licenças do Tableau Server, o número de núcleos listados em Licenças em uso é menor do que o esperado.
    - Ao executar `tsm licenses list`, o Tableau Server pode informar um número menor de núcleos em uso do que o esperado.
    
    Para obter mais informações, consulte [Alguns núcleos não são reconhecidos pelo Tableau Server](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=pt-br).
- **Baixo desempenho no Tableau Server instalado em uma VM do Microsoft Azure com Windows**
    
    Depois da instalação do Tableau Server em uma máquina virtual do Windows Azure, poderão ocorrer problemas de baixo desempenho ou instabilidade do sistema.
    
    - Verifique se a máquina virtual que executa o Azure atende aos requisitos mínimos de sistema para o Tableau Server.
    - Para um desempenho ideal, o Tableau Server deve ser instalado em discos de baixa latência. Para obter mais informações sobre como configurar a máquina virtual do Azure com discos de baixa latência, consulte [Armazenamento Premium de alto desempenho e discos gerenciados para VMs](https://docs.microsoft.com/en-us/azure/storage/common/storage-premium-storage) no site do Microsoft Azure.

<!-- document id=3879b5e2a1ba48d300496bd5cf295427a6ab8aff147207189b038027069143f8 url=/tableau/current/pt-br/server/sign_in_server_trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solução de problemas no logon no servidor

Há diversas opções de logon entre o Tableau Services Manager (TSM) e o Tableau Server.

- **TSM** — Se não for possível entrar no TSM, certifique-se de que está usando as credenciais de um usuário com direitos de administrador no computador onde o TSM está instalado. Esse usuário também pode ou não ser um administrador do Tableau Server. Isso é verdadeiro caso esteja fazendo logon na interface do usuário na Web ou no CLI. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
- **Tableau Server**: —
    
    - Administradores: se você estiver fazendo logon no Tableau Server como um administrador, será necessário usar as credenciais de um usuário com função de administrador no Tableau Server. Você cria o administrador inicial ao instalar o Tableau pela primeira vez, mas pode adicionar outros usuários com administradores depois que o Tableau estiver instalado e em execução. Para obter mais informações, consulte [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).
    - Usuários não administrativos: se você estiver fazendo logon no Tableau Server como um usuário, será necessário usar as credenciais de um usuário que tenha sido adicionado no Tableau Server. Para obter mais informações, consulte [Fazer logon no Tableau Server ou Tableau Cloud](https://help.tableau.com/current/pro/desktop/pt-br/sign_in_server.htm).
        
        **Observação:** se os usuários com credenciais válidas não puderem fazer logon no Tableau Server, certifique-se de que não adicionou um nó sem aplicar as alterações pendentes. Caso tenha um novo nó pendente, não será possível fazer logon no Tableau Server.

## Cenários de solução de problemas

### A tela de inicialização do TSM não é exibida

Ao instalar ou atualizar o Tableau Server, se o navegador for aberto mas não exibir nada, pode ser necessário adicionar o nome de host à lista de sites confiáveis. Como alternativa, limpe o cache do navegador ou utilize um navegador diferente. Para obter mais informações, consulte [Base de dados de conhecimento do Tableau.](https://kb.tableau.com/articles/issue/tsm-initialization-window-does-not-render-in-server-side-web-browser-window?lang=pt-br).

<!-- document id=ba2699ab6ed1831b19e9e24ebb687943325a670815ad27befc034cdb4fda9eae url=/tableau/current/pt-br/server/rmt-troubleshoot-upgrade.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar erros após a atualização

As seções a seguir detalham problemas frequentemente identificados por verificações pós-atualização ou observados imediatamente após uma atualização.

Para obter informações sobre as verificações pré e pós-atualização, consulte a seção [Referência da atualização](https://help.tableau.com/current/server/pt-br/rmt-admin-upgrade-reference.htm).

## Serviços que não estão em execução

A interface de usuário da Web do RMT está inacessível e o comando rmtadmin status indica que os serviços necessários foram interrompidos.

Ele é detectado pelas verificações pós-atualização Nº 1, Nº 2, Nº 16

Para corrigir isso, use as seguintes etapas:

No Linux, use o comando a seguir:

sudo -u tabrmt-master XDG\_RUNTIME\_DIR=/run/user/$(id -u tabrmt-master) systemctl --user start tabrmt-master

No Windows, use o comando a seguir:

Start-Service TableauResourceMonitoringTool

Verifique os logs de serviço no diretório de logs para verificar se há erros de inicialização.

## O PostgreSQL não aceita conexões

Quando a interface do usuário da Web mostra erros de banco de dados e os dados não estão sendo armazenados.

Ele é detectado pelas verificações pós-atualização Nº 5c e Nº 6

Para corrigir isso, verifique o seguinte:

- Verifique se o serviço do PostgreSQL está em execução
- Verifique os logs do PostgreSQL no diretório de dados para ver se há erros de inicialização
- Verifique se a porta do banco de dados (padrão 5555) não está bloqueada por outro processo

## O RabbitMQ não responde

Quando os agentes aparecem como desconectados e nenhum novo dado de monitoramento é exibido.

Ele é detectado pelas verificações pós-atualização Nº 5b, Nº 7 e Nº 9

Para corrigir isso, verifique o seguinte:

- O RabbitMQ pode levar de 30 a 60 segundos para inicializar totalmente após a atualização, aguarde e verifique novamente
- Verifique se o processo Erlang/beam está em execução
- Verifique se há alertas de recursos do RabbitMQ (espaço em disco < 10 GB bloqueia todas as publicações de mensagens)
- Verifique se o arquivo do cookie do Erlang existe e tem as permissões corretas

## Lista de pendências da fila de mensagens

Os dados aparecem atrasados na interface do usuário da Web do RMT e os painéis mostram métricas obsoletas.

Ele é detectado pela verificação pós-atualização Nº 8.

Ter um backlog imediatamente após a atualização é normal, pois os agentes se reconectam e reenviam dados em buffer. Para corrigir isso, faça o seguinte:

- Monitore com “rmtadmin status”; o backlog deve ser zerado dentro de 15 a 30 minutos
- Se o backlog persistir, verifique se todos os serviços agentes estão em execução e conectados

## Os serviços RMT Server não consomem (dados não processados após a atualização)

Com todos os relatórios de serviços do RMT em execução, a verificação pós-atualização passa serviços/portas/conectividade, mas a interface do usuário na Web não mostra novos dados e os agentes aparecem como “Problema de conexão”. “`rmtadmin status`” mostra uma ou mais filas com mensagens acumuladas, mas um número de consumidores igual a \*\*0\*\*.

Isso ocorre quando os trabalhadores em segundo plano do RMT Server são iniciados, mas não conseguem revincular seus canais de consumidor do RabbitMQ após uma atualização in-loco. Os agentes publicam com sucesso, as mensagens se acumulam no RabbitMQ e nada entra no banco de dados.

Isso é detectado pela verificação pós-atualização Nº 8a

Para corrigir isso, faça o seguinte:

- Reinicie o master: `` `rmtadmin restart ``”
- Aguarde mais ou menos 60 segundos, depois execute novamente “`rmtadmin status`” — as filas encalhadas agora devem mostrar “Consumidores = 1” e a lista de pendências deve se esgotar em poucos minutos
- Se as filas ainda mostrarem “Consumers = 0” após a reinicialização, inspecione o registro em segundo plano em busca de exceções de vinculação ao consumidor:
- Windows: “`C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\background\*.log`”
- Linux: “`/var/opt/tableau/tabrmt/master/logs/background/*.log`”
- Pesquise no registro por “`exception`”, “`channel`”ou “`binding failed`”

## Incompatibilidade do modo FIPS

Quando os serviços não são iniciados com erros criptográficos ou TLS.

Ele é detectado pela verificação pós-atualização Nº 11

Para corrigir isso, faça o seguinte:

- Verifique se a configuração do FIPS no sistema operacional corresponde à configuração do RMT (“isFIPSEnabled” em setup.json)
- Linux: verifique “`` `/proc/sys/crypto/fips_enabled ``”
- Windows: verifique “`HKLM:\SYSTEM\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy\Enabled`”

## Corrupção do arquivo de configuração

Os serviços não iniciam por causa de erros de análise de JSON.

Ele é detectado pela verificação pós-atualização Nº 3

Para corrigir isso, faça o seguinte:

- Valide o arquivo de configuração: “`` python3 -c "import json; json.load(open('config.json'))"` ``”
- Restaure a partir do backup pré-atualização (recomendado antes de cada atualização)

## Certificado SSL expirou ou vai expirar

Quando o navegador da Web mostra avisos de certificado e os agentes não conseguem se conectar com erros de TLS.

Ele é detectado pelas verificações pós-atualização Nº 10 e Nº 13

Para corrigir isso, faça o seguinte:

- Renove o certificado HTTPS e atualize-o usando `` `rmtadmin set-ssl-certificate` ``
- Para certificados RabbitMQ, substitua os arquivos PEM no diretório de certificados e reinicie o serviço

## Exaustão do espaço em disco

Quando os serviços falham ou geram erros ao gravar dados e erros de banco de dados em logs.

Ele é detectado pelas verificações pós-atualização Nº 14 e pré-atualização Nº 2 e Nº 2b

Para corrigir o erro, faça o seguinte:

- Libere espaço em disco ou expanda o volume
- Execute a limpeza do banco de dados: certifique-se de que “`db:cleanup:type`” esteja definido como “Limpar” (não “Nenhum”) no config.json
- Arquivar ou excluir arquivos de log antigos

## Erros FATAL ou CRITICAL nos logs

Comportamento inesperado ou instabilidade do serviço após a atualização.

Ele é detectado pela verificação pós-atualização Nº 15

Para corrigir isso, faça o seguinte:

- Os erros de “broker inalcançável” imediatamente após a atualização são geralmente transitórios. Verifique se o RabbitMQ está em execução agora
- Para outros erros FATAL, revise a entrada de registro completa e entre em contato com Tableau Suporte com o arquivo de log

## Desconexões de agente após a atualização do RMT Server

Os agentes aparecem como desconectados na interface do usuário da Web do RMT; nenhum dado de monitoramento de nós específicos do Tableau Server.

É detectado por verificações de pré-atualização Nº 36b, Nº 36c e Nº 36d

Os agentes se reconectam automaticamente após a conclusão da atualização do RMT Server. Aguarde de 5 a 10 minutos para que isso seja corrigido. Caso contrário, verifique o seguinte:

- Verifique se o serviço do Agent está em execução em cada host do Agent
- Se os agentes estiverem executando uma versão muito mais antiga, atualize-os para corresponder à versão do RMT Server
- Verifique a conectividade de rede (AMQP porta 5672) entre os hosts Agent e RMT Server

## Regressão de versão conhecida e inválida

Quando recursos específicos são quebrados devido a um defeito conhecido na versão instalada.

Ele é detectado pela verificação pré-atualização Nº 36a

Para corrigir isso, faça o seguinte:

- Atualize para a próxima versão do patch (por exemplo, de 2025.3.0 a 2025.3.1+)
- Entre em contato com o suporte do Tableau caso precise patches específicos de versão

## Limpeza de Hangfire quebrada (W-19380780)

O banco de dados cresce continuamente e o esquema `hangfire` é anormalmente grande ( > 1 GB).

Ele é detectado por verificações pré-atualização Nº 21d, Nº 21g

Para corrigir isso, faça o seguinte:

- A atualização para uma versão fixa corrige a volatilidade da função `delete_hash()`
- Linhas órfãs no esquema hangfire podem exigir limpeza manual. Entre em contato com o Suporte do Tableau.

## Limpeza do banco de dados desabilitada

O tamanho do banco de dados sem limite cresce com o tempo e a atualização se torna lenta.

Ele é detectado pelo Nº 21c de verificação pré-atualização

Para corrigir isso, faça o seguinte:

- Defina `db:cleanup:type` como `Purge` em `config.json`
- Reduza `db:cleanup:afterDays` para 30 a 90 dias (padrão: 14)
- Reinicie o serviço RMT Director para que a alteração entre em vigor.

## Problemas de permissões de arquivo

Os serviços falham ao iniciar ou não é possível ler os logs de configuração/gravação.

Ele é detectado pelas verificações pós-atualização Nº 4 e pré-atualização Nº 11 e Nº 16

Para corrigir isso, verifique o seguinte:

- Linux: verifique a propriedade e a associação do grupo de diretórios de configuração, log e dados
- Windows: verifique se a conta de serviço tem acesso de leitura/gravação aos diretórios de instalação
- Entre em contato com o suporte do Tableau se os problemas de permissão persistirem após uma nova instalação

## Processos do RMT encalhados após a parada do rmtadmin

Após a execução do `rmtadmin stop` de acordo com o procedimento de atualização documentado, um ou mais processos `tabrmt-master`, `tabrmt-master-background` `tabrmt-agent` ou `tabrmt-agent-background` ainda estão em execução. Se a atualização continuar nesse estado, o instalador poderá falhar no meio da execução com erros de arquivo em uso.

Ele é detectado pela verificação pré-atualização Nº 38a

Para corrigir isso, faça o seguinte:

- Aguarde mais ou menos 30 segundos para um desligamento normal e execute novamente a verificação pré-atualização
- Se os processos persistirem:
- Linux: “`pkill -u tabrmt-master -f tabrmt-master ; pkill -u tabrmt-agent -f tabrmt-agent`” (ignore as que não se aplicam a este nó)
- Windows: “`Stop-Process -Name tabrmt-master,tabrmt-master-background,tabrmt-agent,tabrmt-agent-background -Force`”
- Execute novamente a verificação pré-atualização para confirmar um estado limpo antes de iniciar a atualização

## Falhas falsas durante atualizações colocalizadas

Se o Master e o Agent do RMT estiverem colocalizados na mesma máquina, a verificação de pré-atualização do Agent (especificamente a verificação Nº 38a) poderá detectar incorretamente os processos Master. Como o script verifica todos os processos tabrmt-\*, em vez de filtrar estritamente tabrmt-agent-\*, ele pode disparar um falso status **FAIL**.

A maioria dos ambientes usa máquinas separadas e não encontrará esse problema. No entanto, se você estiver usando uma instalação colocalizada e receber essa falha específica, poderá ignorar com segurança a verificação e prosseguir com a instalação usando o seguinte comando:

`--skip-upgrade-checks`

Detalhes técnicos:

Causa raiz: verifique se Nº 38a corresponde a nomes de processo muito amplos (tabrmt-\*).

Escopo: afeta apenas atualizações in-loco em que o Master e Agent compartilham a mesma instância de sistema operacional.

Nível de risco: baixo. Os processos mestre estão fora do escopo da atualização do Agent, portanto, a falha não indica um conflito real do sistema.

<!-- document id=c0c1c3ae92e5cee85e51515dd9f27b7a34cc152ac0a79c5fcf76f6b54960bcb5 url=/tableau/current/pt-br/server/rmt-troubleshoot-uninstall.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar erros de desinstalação do RMT

Ao tentar desinstalar o RMT, se você receber este erro:

_Um ou mais problemas causaram falha na instalação. Corrija os problemas e tente novamente a instalação._

Você precisará diagnosticar o problema e resolvê-lo antes de tentar desinstalar novamente. Para obter detalhes sobre como fazer isso, consulte o artigo da base de dados de conhecimento do Tableau: [Erro ao desinstalar o RMT](https://kb.tableau.com/articles/Issue/error-one-or-more-issues-caused-the-setup-to-fail-please-fix-the-issues-and-then-retry-setup-with-rmt-uninstall?lang=pt-br)

## Quem pode fazer isso

Você precisa ser um administrador na máquina e um administrador do Resource Monitoring Tool para solucionar problemas de desinstalação.

<!-- document id=1bdf6912d323a46f503e4996b2dcaef784649cb16fbdc7816724cf500682a92f url=/tableau/current/pt-br/server/rmt-troubleshoot-ssl-certificate.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar erros do certificado SSL

Ao tentar adicionar uma impressão digital personalizada do certificado SSL à configuração do Servidor RMT e selecionar **Testar configuração do servidor**, você verá o seguinte erro:

_O certificado não inclui a chave privada acessível._

Isso ocorre porque o Resource Monitoring Tool não consegue acessar a chave privada, pois a chave não é exportável em texto sem formatação. Para resolver o problema, faça o seguinte:

1. Verifique se você possui a chave privada usando o **Gerenciador de certificados do Windows**.
2. Após receber o certificado usando certreq.exe, execute o seguinte comando na pasta em que o certificado está salvo:
    
    `certreq -accept <name of certificate file>`

Isso deve resolver o problema e permitir que você adicione uma impressão digital personalizada do certificado SSL para usar com o Resource Monitoring Tool.

## Quem pode fazer isso

Você precisa ser um administrador na máquina e um administrador do Resource Monitoring Tool para solucionar problemas de consulta WMI.

<!-- document id=5c28dd355bdcfa501016e87373265b83b5193cd8f5656bd96fedc11a3bf1575e url=/tableau/current/pt-br/server/trouble_job_failures.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar falhas de trabalho devido a falhas de serviço

A partir do Tableau Server versão 2021.1, um novo conjunto de mensagens de erro ajuda você a entender quando os trabalhos falham devido a um problema com um serviço. Este tópico explica as mensagens e o que elas podem significar.

Uma mensagem de erro será exibida neste formato:

<nodeId>
<service>\_<instanceId>.<version>: <error>

Existem quatro categorias de erro:

- **Status ausente** - Se um serviço não puder informar o status, por exemplo, se um nó estiver inativo, se o tabadminagent não puder informar o status, ou se um serviço falhou de modo que resulte na não execução de serviços dependentes, isso aparecerá como um erro de "status ausente".
- **Falha ao atualizar a configuração** - Se um serviço não conseguir atualizar seu arquivo de configuração, isso aparecerá como um erro de "falha ao atualizar a configuração". Isso pode ocorrer durante atualizações, ao tentar aplicar alterações pendentes a novos serviços. Veja o log do aplicativo de controle do serviço,`<dataDir>/tabsvc/logs/<service>/control-<service>_<nodeId>-<instanceId>` para obter mais detalhes sobre o erro.
- **Falha ao alcançar o estado solicitado. Estado atual:<currentState>** - Se um serviço não puder ser instalado/removido/iniciado/parado, isso resultará em um erro "falha ao atingir o estado solicitado". Isso pode acontecer durante as atualizações quando novos serviços estão sendo instalados e os antigos removidos. Possíveis opções de <currentState> são: DEPLOY\_FAILED, INSTALL\_FAILED, DISABLE\_FAILED, ENABLE\_FAILED, CONFIGURE\_FAILED, UNINSTALL\_FAILED, REMOVE\_FAILED. Os mais comuns são: INSTALL\_FAILED, UNINSTALL\_FAILED e REMOVE\_FAILED. Veja o log do aplicativo de controle do serviço,`<dataDir>/tabsvc/logs/<service>/control-<service>_<nodeId>-<instanceId>` para obter mais detalhes sobre o erro.
- **Falha ao iniciar/parar. Status atual:<currentStatus>** - Isso ocorre se um serviço que deveria estar em execução for interrompido ou se um serviço que deveria estar parado continuar em execução. Valores possíveis em <currentStatus> são: ATIVO, OCUPADO, PASSIVO, NÃO LICENCIADO, INATIVADO, STATUS\_UNAVAILABLE e DEGRADED. Os três primeiros (ACTIVE, BUSY, PASSIVE) são considerados status "em execução". Os quatro últimos são um status "parado". Veja o log de serviço principal,`<dataDir>/tabsvc/logs/<service>/<service>_<nodeId>-<instanceId>.log`, para obter mais detalhes sobre o erro.

Um exemplo de mensagem de erro é:

This job failed due to unexpected error: 'ServiceOperationTimeoutException'
One or more services failed to reach their expected state.
node1:
     vizportal\_0.2021.4.0.0: Failed to reach requested state. Current state: INSTALL\_FAILED

A partir da versão 2021.3, uma mensagem de erro adicional foi adicionada para o segundo e terceiro tipos de erro que corresponderão aos erros encontrados nos logs do aplicativo de controle.

<!-- document id=7413ccba443421639d18369674c6e58d82be88e6bdbfdd0bf59c9cd238f2d543 url=/tableau/current/pt-br/server/identity_migration_troubleshoot.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas com migração de identidade

## Não foi possível restaurar o backup

Após atualizar para uma versão do Tableau Server que usa o Serviço de identidade como esquema padrão (versões 2022.1-2022.1.7, 2022.3-2022.3.9 e 2023.1-2023.15), restaurar um backup do Tableau Server pode causar o seguinte erro:

_“O backup não pode ser restaurado porque o Tableau Server usa as novas tabelas de serviço de identidade por padrão.”_

Esse problema pode ocorrer quando o Tableau Server precisa executar a migração de identidade, que é um processo necessário para preencher o serviço de identidade. O Serviço de Identidade é um esquema de identidade que foi introduzido em várias versões do Tableau Server a partir da versão 2022.1 e é usado para provisionar e autenticar usuários. Para evitar possíveis problemas, o processo de restauração não pode prosseguir quando o Tableau Server detecta que o backup do Tableau Server usa um esquema de identidade diferente da versão para a qual está sendo restaurado.

Para solucionar este problema, siga as etapas descritas abaixo.

**Importante:** o procedimento descrito abaixo se aplica somente se você estiver executando as versões 2022.1.0-2022.1.7, 2022.3.0-2022.3.9 e 2023.1.0-2023.15 do Tableau Server.

### Etapa 1: habilitar `legacy-identity-mode` e restaurar o backup

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Defina o Tableau Server 2022.1 (ou posterior) para usar o modo de armazenamento de identidade herdado executando os seguintes comandos:
    
    ```
    tsm authentication legacy-identity-mode enable
    tsm pending-changes apply
    ```
    
    O Tableau Server deve usar o modo de armazenamento de identidade herdado para preencher o Serviço de identidade. Para mais informações sobre o comando tsm, consulte [`tsm authentication legacy-identity-mode`](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#tsm_identity_mig_legacy).
3. Restaure o backup novamente para permitir que a migração seja iniciada executando os seguintes comandos:
    
    ```
    tsm maintenance restore --file <file_name>
    tsm start
    ```
    
    **Importante:** depois que o backup é restaurado, a migração preenche o Serviço de Identidade com informações de identidade. Para obter mais informações sobre restauração do backup, consulte, [Restaurar de um backup](https://help.tableau.com/current/server/pt-br/db_restore.htm).

### Etapa 2: validar e concluir a migração de identidade

1. Entre no Tableau Server como um administrador.
2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade para verificar se a migração foi iniciada.
    
    Você pode monitorar e gerenciar seu progresso usando a página dedicada de migração de identidade disponível na página Usuários do Tableau Server. Para obter mais informações, consulte [Gerenciar a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_manage.htm) .
3. Resolva ou reconheça todos os conflitos de identidade conforme descrito em [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) para que a guia Todas as falhas exiba "0" como na imagem abaixo.
    
    ![Resumo da migração de identidade mostrando zero falhas.](/tableau/current/pt-br/server/pt-br/Img/id_mig_failures_acknowledge.png)
4. Execute _um_ destes procedimentos:
    
    - Para executar o trabalho de migração de identidade agora, ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento e selecione Executar agora.
        
        ![Menu suspenso para editar o agendamento de migração com opções para desativar ou executar agora.](/tableau/current/pt-br/server/pt-br/Img/id_mig_overview_runnow.png)
    - Como alternativa, você pode aguardar a execução do trabalho de migração durante o próximo horário agendado.
5. Após a conclusão da migração, na página Migração de identidade, valide se a Visão geral da migração mostra 100% concluída.
    
    ![Barra de progresso da migração de identidade indicando 100% de conclusão.](/tableau/current/pt-br/server/pt-br/Img/id_mig_complete.png)

### Etapa 3: configurar o Tableau Server para usar o Serviço de identidade

1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.
2. Execute os seguintes comandos:
    
    ```
    tsm authentication legacy-identity-mode disable
    tsm pending-changes apply
    ```
    
    **Observação:** depois de executar os comandos acima, a página dedicada de migração de identidade é removida e não está mais acessível. A página só é acessível quando`tsm authentication legacy-identity-mode` está ativado.

Depois que o Tableau Server é configurado para usar o Serviço de Identidade, quando os usuários entram no Tableau Server, o Tableau Server pesquisa suas identidades de usuário usando seus identificadores no repositório de identidades configurado. A partir dos identificadores, os identificadores exclusivos universais (UUID) são retornados e usados para corresponder às identidades de usuário existentes do Tableau Server. Esse processo gera sessões para os usuários e conclui o fluxo de trabalho de autenticação.

### Etapa 4: certifique-se de que os pools de identidade estejam habilitados

1. Execute os seguintes comandos:
    
    ```
    tsm configuration set -k features.IdentityPools -v true
    tsm pending-changes apply
    ```

**Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado.

## “Erro inesperado” na página de migração de identidade

Após resolver ou reconhecer todas as identidades de usuário na página de migração de identidade, você verá uma mensagem de “erro inesperado”. Essa mensagem pode ser exibida quando você tenta resolver ou reconhecer mais de 1.000 identidades de usuário ao mesmo tempo.

Para resolver esse problema, selecione e resolva ou reconheça 1.000 identidades de usuário ou menos e tente novamente.

Para obter mais informações sobre como gerenciar conflitos de identidade, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) .

## O progresso da migração parece não responder ou travado

Se o status da migração ou a barra de progresso da migração não responder ou travar, confirme se você resolveu e reconheceu todos os conflitos de usuário em Falhas de migração.

![A barra de progresso da migração de identidade travou em 37% de conclusão.](/tableau/current/pt-br/server/pt-br/Img/id_mig_overview_stuck.png)

Para resolver esse problema, certifique-se de que todos os conflitos sejam resolvidos e reconhecidos selecionando uma ou mais identidades de usuários na guia Todas as falhas e clicando em Reconhecer no menu suspenso Ações. Execute esta tarefa até que a guia Todas as falhas exiba "0". Para obter mais informações sobre como gerenciar conflitos de identidade, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) .

![Comparação de dois resumos de falhas de migração.](/tableau/current/pt-br/server/pt-br/Img/id_mig_complete_compare.png)

**Observação:** depois que todos os conflitos de identidade forem resolvidos ou resolvidos, todos os trabalhos de migração devem ser executados antes que você possa habilitar o Serviço de identidade para Tableau Server. Você pode executar os trabalhos de migração agora clicando na seta suspensa Editar agendamento ao lado do título Visão geral da migração e selecionando Executar agora. Quando a Visão geral da migração mostrar 100% concluída, você poderá configurar o Tableau Server para usar o Serviço de identidade. Para obter mais informações, consulte [Etapa 3: iniciar a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm#step3).

## O pop-up "A migração de identidade está em andamento" persiste

A notificação "a migração de identidade está em andamento" persiste apesar da conclusão da migração de identidade porque o Serviço de Identidade ainda não foi habilitado. Para concluir a migração de identidade, o Serviço de Identidade precisa estar ativado em [Etapa 4: concluir a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm#step4) para que o Tableau Server possa usar a estrutura de identidade que habilita o recurso de pools de identidades.

## A página de migração de identidade desaparece

Quando a migração de identidade estiver concluída ,e o Tableau Server estiver configurado para usar o Serviço de identidade, a página Migração de identidade dedicada será removida e não poderá mais ser acessada. A página Migração de identidade é necessária apenas para a migração de identidade ou quando `tsm authentication legacy-identity-mode` está ativado.

## Usuários não conseguem fazer logon

Após a conclusão da migração de identidade e a ativação do Serviço de identidade, alguns usuários não conseguem fazer logon no Tableau Server. Na maioria dos casos, esse problema ocorre com usuários cujas identidades tiveram conflitos e foram posteriormente **Reconhecidas** durante a migração de identidade. As identidades dos usuários que foram reconhecidas não são migradas para o Serviço de Identidade e subsequentemente serão ignoradas durante as sincronizações do Active Directory (AD) ou do grupo LDAP daqui para frente.

Se os usuários associados a essas identidades de usuário reconhecidas precisarem de acesso ao Tableau Server novamente, adicione manualmente os usuários ao Tableau Server. Depois que os usuários são adicionados manualmente, as sincronizações subsequentes do grupo AD ou LDAP reconhecem as identidades dos usuários e sincronizam conforme esperado.

## Reverter migração de identidade

Se houver problemas, como certos usuários que não conseguem entrar no Tableau Server, que você acredita serem causados pelo Serviço de identidade, você pode usar o comando [`tsm authentication legacy-identity-mode`](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#tsm_identity_mig_legacy) para voltar a usar o modo de armazenamento de identidade herdado. Após a reversão, os novos usuários que foram adicionados após a migração de identidade, e os usuários que só puderam entrar no Tableau Server antes da migração, poderão entrar no Tableau Server sem problemas.

Depois de reverter do Serviço de Identidade para o modo de armazenamento de identidade herdado, você pode usar a página Migração de Identidade para executar a migração para as identidades de usuário problemáticas. Para obter mais informações sobre como gerenciar conflitos de identidade, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_conflicts.htm) .

<!-- document id=577dff5552722ecbd8072691350afeb0044f1a470a8717b8f7f3d8563a914b93 url=/tableau/current/pt-br/server/subscribe_trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de assinaturas

## "O instantâneo da exibição neste e-mail não pôde ser renderizado adequadamente."

Se você receber uma assinatura com essa mensagem de erro, poderá ser por vários motivos:

- **Credenciais ausentes**: Algumas exibições estão publicadas com credenciais inseridas. Você pode receber o erro acima se as credeciais inseridas estiverem desatualizadas ou se a exibição tiver sido republicada sem as credenciais inseridas.
- **Banco de dados temporariamente inativo**: Se a exibição tiver uma conexão de banco de dados ativa, e o banco de dados estava temporariamente inativo quando a assinatura era gerada, você poderá receber o erro acima.
- **Limite de tempo do processo em segundo plano**: por padrão, o processo em segundo plano que lida com assinaturas tem um valor de tempo total de 30 minutos por exibição para a renderização de uma exibição. Se a renderização da visualização ultrapassar esse limite de tempo, a próxima exibição na pasta de trabalho resultará em um trabalho com falha devido ao tempo limite. Na maioria dos casos, o padrão é tempo suficiente. Entretanto, se o processo em segundo plano estiver manipulando um painel extremamente grande e complexo, esse tempo talvez não seja suficiente. Você poderá verificar a exibição do administrador [Tarefas em segundo plano para não extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm) para ver se é esse o caso. Para aumentar o tempo limite, use o comando `tsm configuration set` `[subscriptions.timeout](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#subscriptions_timeout)`.

## Não é possível ver imagens no e-mail

Para exibir as imagens do conteúdo em um e-mail de assinatura, os usuários inscritos nas exibições devem ter as permissões para Exibir e para Baixar imagem/PDF. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#permissioncapabilities).

## Não é possível ver extensões ou objetos do Pulse

A partir do Tableau Cloud 2026.1, as assinaturas oferecem suporte a muitas extensões. No entanto, elas poderão aparecer em branco em seu e-mail de assinatura ou anexo se não atenderem a determinados critérios:

- **Tipo de extensão:** apenas extensões confiáveis do Tableau (disponíveis no Tableau Exchange) e objetos de painel do Pulse são compatíveis. Se o painel usar uma extensão habilitada por rede, essa zona aparecerá em branco na imagem da assinatura.
- **Estado da exibição:** as assinaturas são renderizadas com base na versão publicada da exibição ou em uma exibição personalizada salva. Se você fez alterações ou seleções não salvas, elas não aparecem no e-mail de assinatura.
- **Formato:** as assinaturas só oferecem suporte a esses objetos quando a mensagem inclui uma imagem. No momento, esses objetos não são renderizados em anexos PDF.
- **Salvamento de pasta de trabalho:** se você adicionou recentemente uma extensão de visualização via Criação na Web, certifique-se de que a pasta de trabalho seja salva; caso contrário, o mecanismo de assinatura não poderá acessar o novo conteúdo.

## Não é possível assinar

Se você puder ver uma exibição ou pasta de trabalho no Tableau Server e ela tiver um ícone de assinatura (![Ícone Inscrição.](/tableau/current/pt-br/server/pt-br/Img/subscribe_icon.png)) no canto superior direito, você poderá assiná-la.

Para assinar uma exibição, o Tableau Server precisa estar configurado corretamente (descrito em [Gerenciar assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm)) e a exibição que você está assinando deve ter credenciais inseridas para sua fonte de dados ou não usar credenciais. Exemplos do último item são uma pasta de trabalho que se conecta a uma extração que não está sendo atualizada, ou uma pasta de trabalho cujos dados estão em um arquivo fornecido com a pasta de trabalho no momento da publicação. As credenciais inseridas são uma etapa realizada no Tableau Desktop (consulte a [Ajuda do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/publishing_sharing_authentication.htm) para obter detalhes).

## Sem ícone de assinatura

É possível ver uma exibição, mas não é possível assiná-la. Isso pode acontecer diversos motivos:

- **Nenhuma assinatura foi agendada**: se não existem assinaturas agendadas ou todas as agendas de assinaturas estão desabilitadas, o ícone de assinaturas não aparece. Para definir um agendamento para as assinaturas, consulte [Criar ou modificar uma agenda](https://help.tableau.com/current/server/pt-br/schedule_manage_create.htm).
- **A exibição usa uma conexão com um banco de dados em tempo real**: exibições com conexões com bancos de dados em tempo real, onde há uma solicitação pelas credenciais do banco de dados ao clicar pela primeira vez na exibição, não estão disponíveis para assinatura. Uma assinatura inclui uma exibição (ou pasta de trabalho), dados ou uma agenda. Para fornecer os dados exigidos pela exibição, o Tableau Server precisa das credenciais do banco de dados inseridas ou de dados que não exijam credenciais. Em relação às conexões de bancos de dados ativas, o Tableau Server não tem as credenciais, somente os usuários individuais têm. É por isso que você só pode assinar exibições que não exigem credenciais ou as têm inseridas.

- **O Tableau Server está configurado para autenticação confiável**: também é possível ver uma exibição, mas não ser capaz de assiná-la (nenhum ícone de assinatura) se o Tableau Server estiver configurado para a autenticação confiável. Consulte [Garantir acesso às inscrições](https://help.tableau.com/current/server/pt-br/subscribe_alert_access.htm) para obter mais informações.

- **Uma conexão de banco de dados em tempo real usa a autenticação OAuth**: um usuário talvez não consiga se inscrever na exibição se a credencial OAuth não estiver inserida com a fonte de dados em tempo real ou salva com a keychain de usuário ou se o token de atualização do OAuth tiver expirado.

## Recepção inválida ou "quebrada"

Se você configurou assinaturas nas instâncias de teste ou desenvolvimento do Tableau Server além de sua instância de produção, desabilite as assinaturas nas instâncias que não são de produção. Manter as assinaturas habilitadas em todas as instâncias pode resultar em seus usuários recebendo assinaturas que parecem ser válidas, mas não funcionam, ou recebendo assinaturas mesmo que eles as tenham cancelado na exibição ou pasta de trabalho.

## Anexos ausentes

Você pode adicionar um anexo PDF à sua assinatura se o administrador tiver habilitado. Se o anexo PDF estiver ausente da assinatura, pode ser porque o tamanho do PDF excede o limite de tamanho do servidor de e-mail ou o limite máximo de tamanho definido pelos administradores do servidor. No Tableau Server, o limite máximo de tamanho para anexos PDF de assinaturas pode ser ajustado na opção de configuração do tsm `subscriptions.max_attachment_size_megabytes`. Para obter mais informações, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm) e [Configurar um site para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm).

A partir do Tableau 2024.1, você pode enviar e-mails com seu próprio servidor de envio, o que permite enviar anexos com tamanho máximo de e-mail de 10 MB.

Para ativar esse recurso, navegue até as configurações do site, encontre a seção Personalizar notificações por e-mail e marque a caixa ao lado de Usar seu servidor SMTP.

Observação: se você usar seu próprio servidor de envio, o Tableau tentará enviar um e-mail de assinatura com um subconjunto do anexo que esteja abaixo do limite de 10 MB, mas isso não é garantido. Se o Tableau não conseguir enviar o anexo, você verá uma mensagem informando que o anexo é muito grande para ser enviado.

## Assinaturas suspensas

Por padrão, uma assinatura é suspensa depois de 5 falhas consecutivas. Para alterar o número limite de falhas de assinatura que podem ocorrer antes de serem suspensas, use a opção do tsm configuration set, `backgrounder.subscription_failure_threshold_for_run_prevention`. Isso define o limite do número de falhas de assinatura consecutivas necessárias antes de suspender a assinatura. Esta é uma configuração em todo o servidor.

Somente administradores de servidor podem configurar o número limite de falhas na assinatura antes que uma assinatura seja suspensa. Para obter mais informações sobre como definir esse limite, consulte [Configurar um servidor para assinaturas](https://help.tableau.com/current/server/pt-br/subscribe.htm#suspended-subscriptions).

Por padrão, os administradores não recebem um e-mail quando uma assinatura é suspensa, mas podem optar por e-mails de suspensão por site por meio de **Configurações da minha conta**.

### Retomar assinaturas suspensas

Administradores e proprietários de assinaturas podem retomar as assinaturas de diversas formas:

- na guia Minha assinatura, nas Configurações de conteúdo
- na guia Assinaturas por pasta de trabalho
- na guia Assinaturas, em Tarefas (somente administradores de servidor)

Quando uma assinatura é retomada, a contagem de falha de alerta retorna a zero. A próxima avaliação da assinatura ocorrerá no próximo horário de avaliação agendado.

### Não é possível definir a frequência de assinatura para "Quando os dados se atualizam"

Você poderá definir assinaturas para serem executadas quando uma extração for atualizada, se a pasta de trabalho usar uma conexão a uma extração pública. Ao criar ou modificar uma assinatura, você pode não ver uma opção Frequênciase a pasta de trabalho usar:

- Mais de uma atualização de extração
- Uma conexão de dados em tempo real

## As assinaturas não chegam ("Erro no envio do e-mail. Não é possível enviar o comando para o host SMTP.")

O erro acima pode aparecer no Visualizador de Eventos do Windows se as assinaturas não estiverem chegando e o servidor SMTP estiver usando sessões criptografadas (TLS). Para enviar assinaturas para um servidor SMTP configurado com TLS, você deve configurar SMTP seguro no Tableau Server. Consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm#conf). (Se você receber esse erro, observe que Tableau Server ainda indicará que as assinaturas estão sendo enviadas na exibição de administrador [Tarefas em segundo plano para não extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm).)

## Avisos de qualidade de dados ou rótulos de confidencialidade ausentes

Os avisos de qualidade de dados e os rótulos de sensibilidade são incluídos nos e-mails de assinatura quando:

- O Tableau Server ou Tableau Cloud é licenciado com Data Management. Para obter mais informações, consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm).
- O Tableau Catalog é habilitado. Para obter mais informações, consulte [Ativar o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_enable.htm).
- Nas configurações do site, a caixa de seleção em Rótulos de dados de alta visibilidade em assinaturas de exibição e de pasta de trabalho é selecionada. (Em versões anteriores, a caixa de seleção está abaixo de Avisos de qualidade de dados em assinaturas.)

<!-- document id=e7010ee4a3f4a78c211cf6729b101c9aeb7888b38b8d2e8c9224c25ff702c576 url=/tableau/current/pt-br/server/trusted_auth_trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de autenticação confiável

Esta seção inclui alguns problemas e erros comuns que você pode encontrar quando estiver configurando a autenticação confiável.

Uma fonte comum de erros de autenticação confiável é a configuração incorreta de um servidor proxy ou balanceador de carga. Se o Tableau Server opera atrás de um servidor proxy reverso ou um balanceador de carga, consulte [Configurar o Tableau Server para funcionar com um servidor proxy reverso e/ou balanceador de carga](https://help.tableau.com/current/server/pt-br/proxy.htm#Configur) e [Adicionar um balanceador de carga](https://help.tableau.com/current/server/pt-br/distrib_lb.htm).

As informações de autenticação confiável são gravadas em `ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizqlserver\vizql-*.log`.

Para aumentar o nível de registro de `info` para `debug`, execute os comandos a seguir:

tsm configuration set -k vizqlserver.trustedticket.log\_level -v debug
tsm pending-changes apply

Para testar a implementação da autenticação confiável, consulte [Autenticação confiável de teste](https://help.tableau.com/current/server/pt-br/trusted_auth_testing.htm).

### Consulte também

Para obter mais informações sobre a solução de problemas de erros específicos, consulte os tópicos a seguir, acessíveis em **Outros artigos nesta seção** a seguir:

Solicitação de tíquete por servidor Web

- Valor de ticket -1 retornado pelo Tableau Server
- HTTP 401 - Não autorizado
- HTTP 404 – Arquivo não encontrado
- Usuário inválido (SharePoint ou C#)

**Tíquete de resgate de visualizador**

- Tentativa de resgatar o ticket do endereço IP incorreto
- Erro de restrição de cookie

Navegando entre várias visualizações inseridas

- Erro na comunicação com o servidor (403)

## Outros artigos nesta seção

<!-- document id=97964c84624226564d9695d7bb3d9c21aade4f42140b2e811ad90903fd25d299 url=/tableau/current/pt-br/server/rmt-troubleshoot-user-signin.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de autenticação de usuário

Quando um usuário do Resource Management Tool não consegue entrar no RMT, há alguns motivos diferentes pelos quais isso pode acontecer. As etapas de solução de problemas dependem da versão do RMT que você está usando e do tipo de autenticação para a qual o usuário está configurado.

## Solucionar problemas de autenticação do usuário RMT

Quando um usuário não conseguir entrar no Resource Management Tool, solucione o problema verificando o seguinte:

- O nome de usuário que eles estão inserindo é adicionado como um usuário no RMT?
- Qual tipo de autenticação o usuário possui no RMT?
    - **Local:** se o usuário tiver autenticação local, redefina a senha e forneça a nova.
    - **Delegada** (Versão 2023.1.0 e posterior)**:**
        - se o usuário tiver autorização delegada, verifique se o nome de usuário foi inserido corretamente no RMT. Não deve incluir o domínio antes ou depois do nome do usuário:
            - Correto: `<username>`
            - Incorreto: `<subnet.network>\<username>` ou `<username@<subnet>.<network>`
        - Faça com que o usuário confirme suas credenciais entrando em outro sistema que usa suas credenciais de domínio.
        - Certifique-se de que o usuário não está bloqueado devido a falhas excessivas nas tentativas de login (isso não é algo que o RMT lide; eles precisarão trabalhar com o suporte técnico de TI sobre isso).

**Observação:** a partir da versão 2025.1.1, adicionamos a configuração de bloqueio antidomínio, que permite definir um limite de tentativas consecutivas de logon com falhas antes que o RMT interrompa a tentativa de entrada. Isso foi projetado para lhe dar flexibilidade para configurar o RMT para interromper as tentativas de entrada e evitar bloqueios de domínio devido a muitas tentativas com falha. Para obter mais informações, consulte: [Chaves de configuração suportadas](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm#SupportedConfigKeys_rmt)

## Usando registros para solucionar problemas de autenticação

Registros para problemas de autenticação podem ser encontrados em: `\[Install Directory]\master\logs\web\tabrmt_YYYMMDD.log`.

Cadeias de caracteres de erro a serem procuradas:

- "Senha inválida para o usuário" - Um usuário digitou o nome de usuário válido, mapeado para um usuário RMT atribuído autenticação local, mas forneceu uma senha inválida.
- "O usuário falhou ao fornecer a senha correta" - Um usuário inseriu o nome de usuário correto, mapeado para um usuário RMT atribuído à autenticação delegada, mas forneceu uma senha inválida.
- "Executing action method \\"Tableau.PowerTools.Server.Master.Web.Controllers.AuthenticationController.Login" - Uma tentativa de login está sendo feita.

## Quem pode fazer isso

Você precisa ser um administrador na máquina e um administrador do Resource Monitoring Tool para solucionar problemas de autenticação do usuário.

<!-- document id=4883a843d12a7357138f697bc7b2c9223cd541f8a9ca6d65c36dd673d53263da url=/tableau/current/pt-br/server/rmt-troubleshoot-messaging-table-disk-usage-warning.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de avisos de uso de disco de tabelas de mensagens

Em raras situações, você poderá ver um aviso de uso de espaço em disco na linha de comando após executar o `rmtadmin status` comando:

Internal RMT messaging tables total disk usage is now: <nn.nn> KB.

Uma mensagem é exibida quando o espaço em disco atinge ou excede o limite de aviso de 4 GB.

O banco de dados geralmente limpa tabelas desnecessárias automaticamente, mas se esse aviso for exibido, execute as seguintes etapas para limpar as tabelas manualmente:

1. Parar RMT Server:
    
    rmtadmin stop
2. Inicie o serviço de banco de dados:
    
    rmtadmin start --db
3. Limpe as tabelas desnecessárias:
    
    rmtadmin query "DROP SCHEMA hangfire CASCADE;" --outfile=drop\_hangfire\_schema\_output.zip --commit
4. Inicie o RMT Server:
    
    rmtadmin start

## Quem pode fazer isso

Você precisa ser a Resource Monitoring Tool Administrador para executar os comandos necessários.

<!-- document id=8c7631b437700d156d8daf4a77e5008c6d563d21f64e5502390ee8b25c37386b url=/tableau/current/pt-br/server/oauth_trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de conexão do OAuth

Este tópico oferece informações sobre solucionar problemas que podem ocorrer ao configurar as conexões de dados OAuth.

## Erro de conflito

Em alguns casos, os usuários podem receber um erro ao tentar se conectar com o OAuth. A primeira frase da mensagem de erro é:

O servidor encontrou um erro interno ou má configuração e não conseguiu concluir sua solicitação.

Esse erro indica que o nome de domínio totalmente qualificado (FQDN) do Tableau Server precisa ser adicionado à chave de redirecionamento da lista segura no Tableau Server.

Quando os usuários acessam um Tableau Server pelo nome de host local (https://tableau) e o provedor de dados OAuth responde ao nome DNS público (https://data.example.com), o Tableau Server deve associar o FQDN externo ao nome do servidor local. O nome de host local é o nome do servidor na URL que os usuários digitam ao acessar o Tableau Server a partir da rede interna.

Para corrigir esse erro, execute [tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration_tsm.htm#TSMSet) com a opção principal `oauth.whitelisted.redirect_to_origin_host`. Esta chave leva um par de valor, `"internal_host,FQDN1,FQDN2"`. Por exemplo, os seguintes comandos definem o nome de host local como _tableau e o_ FQDN como_tableau.example.com_:

`tsm configuration set -k oauth.whitelisted.redirect_to_origin_host -v "tableau,tableau.example.com"`

`tsm pending-changes apply`

Caso várias URLs públicas sejam usadas para acessar o Tableau Server interno, adicione FQDNs extras ao comando, separados por vírgulas, por exemplo:

`tsm configuration set -k oauth.whitelisted.redirect_to_origin_host -v "tableau,tableau.example.com,tableau2.example.com"`

Se precisar editar uma configuração de redirecionamento de lista autorizada existente, digite o conjunto de mapeamento completo. Você não pode truncar ou anexar as chaves de configuração existentes.

<!-- document id=e6aff01ee23287fe32a9d5827655043dfdb5c87ce595dd423530103769519b63 url=/tableau/current/pt-br/server/rmt-troubleshoot-wmi-query-issues.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de consulta WMI

Se os contadores de desempenho forem corrompidos, você verá problemas no agente do Resource Monitoring Tool. O problema será relatado no arquivo de registro do processador em segundo plano e será semelhante ao seguinte exemplo:

```
{  ...  
"Level":  "Error",  ...  
"RenderedMessage":  "Error getting network adapters",  
"Exception":  "System.Management.ManagementException: * Invalid query  *  
       at System.Management.ManagementException.ThrowWithExtendedInfo(ManagementStatus errorCode) ..."  
...  }
```

Isso pode ocorrer devido à ausência de alguns contadores de desempenho no servidor. Para verificar isso, execute `perfmon.exe` e verifique se há mensagens de aviso.

Se `perfmon.exe` confirmar a ausência dos contadores de desempenho, você poderá tentar corrigir o problema recriando todos os contadores. Veja abaixo.

**Recriação de todos os contadores de desempenho:**

Para recriar todos os contadores de desempenho, digite os comandos a seguir em um prompt de comando administrativo. Pressione ENTER depois de cada comando.

```
cd c:\windows\system32
lodctr /R
cd c:\windows\sysWOW64
lodctr /R
```

Em seguida, sincronize os contadores novamente com a Windows Management Instrumentation (WMI):

```
WINMGMT.EXE /RESYNCPERF
```

Por fim, interrompa e reinicie o serviço de Registros e alertas de desempenho.

## Quem pode fazer isso

Você precisa ser um administrador na máquina e um administrador do Resource Monitoring Tool para solucionar problemas de consulta WMI.

<!-- document id=22f826f0619c15668aee49ba0e7188cb1b196b2ae63636f2a159ce9544cc7824 url=/tableau/current/pt-br/server/rmt-troubleshoot-missing-hardware-perf-data.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de dados ausentes de desempenho de hardware

As estatísticas de uso do processador (CPU), uso de memória, fila de disco e desempenho de rede são consideradas dados de desempenho de hardware na Resource Monitoring Tool do Tableau. Os locais mais comuns para visualizar esses dados são:

- No painel de controle **Environment Overview**, nos gráficos Desempenho e Processamento do Tableau
- No painel **Servers**

Esses dados são relatados em tempo quase real pelo agente da Resource Monitoring Tool em execução em cada uma das máquinas do Tableau Server.

Se esses gráficos não mostrarem dados por um longo período, isso pode ser devido aos seguintes motivos:

1. O Tableau Server não está licenciado corretamente. Isso pode ser devido à falta de recursos de Advanced Management. Certifique-se de que o Tableau Server tenha a licença necessária. Para obter mais informações sobre Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).
2. Problemas de conectividade entre o Agente e o Tableau Server. Use as etapas abaixo para solucionar e isolar esses problemas.

## Etapa 1: verificar o status de conexão do agente

Primeiro, verifique se os Agentes estão conectados à Resource Monitoring Tool. Os Agentes enviam uma mensagem de heartbeat regular para o Servidor RMT para indicar o status da conexão.

1. Faça login na Resource Monitoring Tool como administrador.
2. Navegue até a página **Admin** > **Environments**.
3. Clique no link Editar do ambiente que está sem dados de desempenho.
4. Localize a lista **Servers** e verifique se cada servidor mostra o Serviço de Agente como **Connected**. Você pode passar o mouse sobre o status**Connected** para obter um carimbo de data/hora de quando a última mensagem de heartbeat foi recebida.

## Etapa 2: verificar se o Agente está em execução

Se o Agente for mostrado como **Disconnected** na Resource Monitoring Tool, o serviço do Windows do Agente talvez não esteja em execução.

1. Conecte-se à máquina em que o agente está em execução.
2. Verifique se o serviço do Windows do Agente do Resource Monitoring Tool do Tableau está funcionando.

## Etapa 3: verificar se o Agente está configurado corretamente

Se o agente for mostrado como **Disconnected** na Resource Monitoring Tool, mas o serviço estiver sendo executado, o agente poderá não conseguir acessar a fila de mensagens da Resource Monitoring Tool.

1. Conecte-se à máquina em que o agente está em execução.
2. Navegue até a pasta de instalação do agente. Por exemplo: %Program Files\\Tableau\\Tableau Resource Monitoring Tool\\agent
3. Execute o comando _rmtadmin status_ .

O comando _rmtadmin status_ testará a conectividade do agente com a fila de mensagens e o Servidor RMT da Resource Monitoring Tool.

## Etapa 4: reiniciar o Agente

Em alguns casos, o Agente pode estar sendo executado e todos os indicadores de status mostram sucesso, mas ele continua a não enviar dados de desempenho de hardware. Esse é um problema conhecido que pode ser causado por erros de conectividade temporários entre o Agente e a fila de mensagens. Por exemplo, ao reiniciar o servidor de fila de mensagens ou durante interrupções breves de rede.

Para garantir que isso não seja o caso, reinicie o Agente e aguarde alguns minutos para confirmar se os dados de desempenho estão funcionando novamente.

1. Conecte-se à máquina em que o Agente está em execução.
2. Reinicie o serviço do Windows do Agente da Resource Monitoring Tool do Tableau.
3. Verifique se o serviço foi iniciado com êxito.
4. Aguarde pelo menos 10 minutos, faça login na Resource Monitoring Tool e verifique o painel Servidores para ver se os dados de desempenho de hardware foram recebidos.

## Etapa 5: verificar a configuração da conta Run As

Verifique se as contas run-as dos agentes estão configuradas para usar a mesma conta run-as que o Tableau Server usa para se conectar ao Tableau Server e obter o desempenho e os dados da CPU. Deve ser a mesma conta com a qual o Tableau Server está configurado. Certifique-se de que esta conta tenha permissões para acessar os logs do Tableau Server.

## Etapa 6: entrar em contato com o suporte

Se, após seguir as etapas acima, o problema ainda não for resolvido, contate o suporte.

A equipe de suporte precisará de uma cópia dos arquivos de registro da Resource Monitoring Tool do Servidor RMT e de cada um dos agentes que estão com problemas de conexão. Para obter mais informações sobre como coletar arquivos de registro e enviá-los ao suporte ao cliente do Tableau, consulte [Enviar arquivos de registro para o Suporte ao cliente do Tableau](https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm#SendingLogs).

## Quem pode fazer isso

Administradores do Resource Monitoring Tool.

<!-- document id=33b7d123eaaf43a081f6f4c5eee6f2337b09fe3c6af60cccf1e2886f713e6a95 url=/tableau/current/pt-br/server/datasource_trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de fontes de dados

Para que os usuários trabalhem com as fontes de dados do Tableau Server, até três itens precisa ser definidos:

- **Permissões para a fonte de dados:** qualquer pessoa que se conectar a uma fonte de dados deve ter os recursos das permissões **Conectar** e Exibir para essa fonte. Isso também se aplica a usuários que acessam exibições que se conectam a fontes de dados. Qualquer pessoa que esteja publicando e modificando fontes de dados deve ter a função de site do usuário e também ter as permissões **Salvar** e **Baixar/Salvar como**. Consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm#permissioncapabilities) para obter mais informações.
    
    As fontes de dados multidimensionais (cubo) devem ser baixadas e usadas no Tableau Desktop e, portanto, exigem a permissão **Baixar/salvar na Web como**. Para obter mais informações sobre cubos no Tableau, consulte [Fontes de dados de cubo](https://help.tableau.com/current/server/pt-br/datasource_cube.htm).
- **Capacidade de autenticação no banco de dados:** Há várias maneiras de se conectar aos dados no Tableau e controlar quem tem acesso a quê. Basicamente, qualquer entidade que esteja se conectando ao banco de dados deve ser capaz de se autenticar. A entidade pode ser o Tableau Server executando uma atualização de extração. Pode ser um usuário do Tableau Desktop se conectando a uma fonte de dados que então se conecta a um banco de dados dinâmico. Também pode ser um usuário do Tableau Server que está acessando uma exibição que se conecta a um banco dedados ativo. Consulte [Segurança de dados](https://help.tableau.com/current/server/pt-br/security_data.htm) para saber mais sobre suas opções.
- **Drivers de banco de dados:** Se a pessoa que criou e publicou a fonte de dados no Tableau Desktop precisou instalar drivers de bancos de dados adicionais, talvez você precise instalá-los também no Tableau Server. Se estiver executando uma instalação distribuída do Tableau Server onde, por exemplo, o processo do servidor de dados está sendo executado em um nó adicional, todos os drivers de banco de dados necessários devem ser instalados no nó de servidor inicial. Outros processos também requerem drivers. Consulte [Drivers de banco de dados](https://help.tableau.com/current/server/pt-br/dbdriver.htm) para obter mais informações.

## Mensagens de erro da fonte de dados

Veja aqui alguns erros que os autores da pasta de trabalho e outros usuários podem encontrar enquanto trabalham com fontes de dados e exibições:

**A permissão para acessar esta fonte de dados do Tableau Server foi negada:** A conexão com uma fonte de dados exige a permissão Conectar. Consulte [Acesso aos dados para fontes de dados publicadas do Tableau](https://help.tableau.com/current/server/pt-br/permissions.htm#PublishedData) para obter mais informações.

**Fonte de dados não encontrada:** Alguém que estiver trabalhando com uma exibição poderá ver esse erro se uma fonte de dados for removida do Tableau Server ou se a página Conectar a dados precisar ser atualizada. Para atualizar a página Conectar a dados no Tableau Desktop, clique no ícone Atualizar:

![Um ícone Atualizar à direita de um campo de pesquisa.](/tableau/current/pt-br/server/pt-br/Img/connecttodata_refresh.png)

**Não é possível conectar a esta fonte de dados do Tableau Server:** Esse erro pode aparecer se as informações de conexão para a fonte de dados forem alteradas, por exemplo, em resultado da alteração do nome do servidor de banco de dados. Observe as informações de Conexão de dados da fonte de dados e verifique se as configurações estão corretas.

**Não é possível listar fontes de dados do Tableau Server:** Esse erro poderá ocorrer se um usuário estiver tentando acessar as fontes de dados do Tableau Server e houver problemas de conectividade entre o Tableau Server e o Tableau Desktop.

**Não é possível conectar a uma fonte de dados de cubo:** Para usar uma fonte de dados multidimensional (cubo) publicada, você deve baixar a fonte de dados e usá-la no Tableau Desktop. Verifique se você tem a permissão Baixar/salvar na Web como para a fonte de dados. Se tentar adicionar uma fonte de dados de cubo publicada em uma pasta de trabalho no modo Edição na Web do Tableau Server, ocorrerá o erro Não é possível conectar-se à fonte de dados. / DataServiceFailure Não é possível conectar-se ao servidor "<Tableau\_Server\_name>". Para obter mais informações sobre cubos no Tableau, consulte [Fontes de dados de cubo](https://help.tableau.com/current/server/pt-br/datasource_cube.htm).

<!-- document id=411fced5c093ae3a67af7b202edd9c37a73b5fcfcc61a4421291c7b28e75fac0 url=/tableau/current/pt-br/server/trouble_install_upgrade.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de instalação e atualização do Tableau Server

Siga as sugestões neste tópico para solucionar os problemas comuns com o Tableau Server. Para obter as etapas de solução de problemas adicionais baseadas em status do processo exibido na página Status, consulte [Solucionar problemas dos processos do servidor](https://help.tableau.com/current/server/pt-br/service_status_troubleshoot.htm).

## Etapas de solução de problemas gerais

Muitos problemas do Tableau Server podem ser abordados com as mesmas etapas básicas:

1. Certifique-se de que haja espaço em disco suficiente em cada computador executando o Tableau Server. O espaço em disco limitado pode causar uma falha na instalação, uma falha na atualização ou em problemas na execução do Tableau Server.
2. Reinicie o Tableau Server. Os problemas relacionados aos processos não completamente iniciados podem ser resolvidos ao reiniciar o Tableau Server de maneira controlada. Para reiniciar o Tableau Server, use o comando [`tsm restart`](https://help.tableau.com/current/server/pt-br/cli_restart_tsm.htm#restart). Isso irá parar todos os processos associados com o Tableau Server e, em seguida, reiniciá-los.
3. Reindexe o Tableau Server. Os problemas relacionados à indexação podem ser resolvidos pela reindexação do Tableau Server. Para reindexar o Tableau Server, use o comando [`tsm maintenance reindex-search`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmmaintenancereindex). Para obter mais informações, consulte [Reindexação do Tableau Index and Search Server (2023.3 e posterior)](#Reindexing) abaixo.
4. Reinicie o computador no qual o Tableau Server está sendo executado. Alguns problemas, como aqueles relacionados à conectividade da fonte de dados, podem ser resolvidos reiniciando o computador do servidor.

## Problemas comuns de instalação do Tableau Server

### Local dos registros de instalação

Os registros de instalação são gravados no diretório `\Temp` da conta de usuário que executa a Configuração. Na maioria dos casos, está localizado em `C:\Users\<user>\AppData\Local\Temp`.

Para determinar onde o diretório `\Temp` encontra-se para o usuário conectado, execute o comando a seguir no Prompt de comando do Windows: `ECHO %Temp%`.

### O programa de instalação não solicita o local onde instalar

Ao instalar o Tableau Server pela primeira vez, será solicitada a localização na qual deseja instalá-lo. _Caso não veja esse prompt, pode haver arquivos ou diretórios restantes de uma instalação anterior, mesmo se tiver desinstalado o Tableau._ Para remover completamente todos os vestígios do Tableau, execute o script `tableau-server-obliterate.cmd`, reinicie o computador e tente instalar novamente.

**Importante:** caso tenha criado um backup do Tableau (`<file>.tsbak`) que deseja manter (por exemplo, para restaurar para a nova instalação), copie esse arquivo em um local seguro em outro computador para garantir que não seja removido ao limpar o computador com o Tableau.

### O programa de instalação não reinicia o Windows

Ao instalar o Tableau Server, o programa de Instalação pode solicitar que reinicie o Windows ao final da instalação. Em certos casos, clicar em Reiniciar não reinicia o computador. Isso pode acontecer quando um instalador de componentes de terceiros está solicitando uma reinicialização do Windows.

Se clicar em Reiniciar não reiniciar o Windows, conclua a instalação reiniciando o Windows manualmente.

### Falha na instalação do TSM com o erro "initialization failed"

Se tentar instalar o Tableau Server e houver falha na instalação com este erro:

Tableau server initialization failed  
See install log at C:\\ProgramData\\Tableau\\Tableau Server\\logs

Isso pode estar relacionado a um problema de permissões em seu computador. O usuário será logado no Windows e a instalação do Tableau deverá ter permissões de administrador no drive C, nas pastas C:\\Windows e C:\\Windows\\System32 e no arquivo cmd.exe. Isso é válido mesmo se não estiver instalando o Tableau no drive C.

Para obter mais informações, consulte [Base de dados de conhecimento do Tableau](https://kb.tableau.com/articles/issue/errors-tableau-server-initialization-failed-and-initdb-could-not-execute-command?lang=pt-br).

### A tela de inicialização do TSM não é exibida

Ao instalar ou atualizar o Tableau Server, se o navegador for aberto mas não exibir nada, pode ser necessário adicionar o nome de host à lista de sites confiáveis. Como alternativa, limpe o cache do navegador ou utilize um navegador diferente. Para obter mais informações, consulte [Base de dados de conhecimento do Tableau.](https://kb.tableau.com/articles/issue/tsm-initialization-window-does-not-render-in-server-side-web-browser-window?lang=pt-br).

### Falha em várias tentativas de instalação

Se tentar instalar o Tableau Server e houver falha, todas as tentativas de instalação subsequentes também poderão falhar, a menos que execute o script `tableau-server-obliterate``.cmd` para limpar o Tableau do computador.

> [!IMPORTANT]
> 
> **Importante:** você deve executar o script `tableau-server-obliterate.cmd` a partir de um prompt de comando de 64 bits. Por exemplo, execute `cmd.exe` na pasta `C:\Windows\System32`. Se você executar o script a partir de um prompt de comando de 32 bits, o script não removerá completamente o Tableau e poderá ocorrer falha nas instalações subsequentes. Para determinar se você está executando um prompt de comando de 64 bits, digite `echo %processor_architecture%` na janela de comando. Se o resultado inclui "64" (`AMD64`, por exemplo), o prompt de comando é um prompt de 64 bits. Se o resultado inclui "x86", você está executando um prompt de 32 bits. Para obter mais informações, consulte a documentação apropriada da Microsoft para as suas versões do Windows.

Uma tentativa de instalação falha pode deixar o computador em um estado que fará com que todas as tentativas subsequentes também falhem com erros que não parecem diretamente relacionados a uma tentativa de instalação anterior.

Para corrigir esse problema, execute o script `tableau-server-obliterate``.cmd` para limpar quaisquer vestígios restantes da tentativa de instalação anterior e reinicie o computador. Para obter mais informações, consulte [Executar o script tableau-server-obliterate](https://help.tableau.com/current/server/pt-br/remove_tableau.htm#RunObliterate).

**Importante:** caso tenha criado um backup do Tableau (`<file>.tsbak`) que deseja manter (por exemplo, para restaurar para a nova instalação), copie esse arquivo em um local seguro em outro computador para garantir que não seja removido ao limpar o computador com o Tableau.

### O script obliterate gera o erro: "refresh-environment-variables.cmd' is not recognized as an internal or external command

Se você usar o Painel de controle para desinstalar o Tableau Server e, em seguida, executar o script `tableau-server-obliterate.cmd` para remover completamente o Tableau Server do computador, o script pode gerar um erro sobre o refresh-environment-variables. Isso ocorre porque um segundo script chamado pelo script obliterate não foi movido para o diretório temp. Você pode ignorar esse erro.

### Falha na instalação devido a requisitos de hardware

Não será possível instalar o Tableau Server se o computador no qual estiver instalando não atender aos requisitos mínimos de hardware. Os requisitos se aplicam a todos os computadores nos quais o Tableau Server está sendo instalado. Para obter detalhes sobre os requisitos mínimos de hardware, consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm).

### Falha na instalação ou atualização devido a requisitos de CPU

O Tableau Server exige CPUs compatíveis com conjuntos de instruções SSE4.2 e POPCNT. Você não pode instalar ou atualizar o Tableau Server em computadores com CPUs não compatíveis com esses conjuntos de instruções.

Você pode ver esta mensagem de erro ao fazer uma nova instalação ou em preparação para atualizar uma instalação existente: 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

Os conjuntos de instruções SSE4.2 e POPCNT são comuns há mais de 10 anos, e a maioria das CPUs mais novas os aceita, mas se você tiver um erro relacionado aos requisitos mínimos do processador ao tentar instalar ou atualizar o Tableau Server em uma máquina virtual (VM), o modo de compatibilidade do processador pode ser ativado na VM. Para instalar ou atualizar com sucesso o Tableau em uma VM, certifique-se de que o modo de compatibilidade do processador esteja desligado.

## Problemas comuns de atualização do Tableau Server

### Local dos registros de atualização

Por padrão, o registro de atualização `app-upgrade.log` é gravado no `C:\ProgramData\Tableau\Tableau Server\logs`.

### Erro: falha ao estabelecer uma conexão com o Active Directory

O Tableau Server requer conexões seguras com o Active Directory. Se a instância atual do Tableau Server estiver se comunicando com o Active Directory por meio de um canal não criptografado, uma atualização falhará.

Para resolver este problema, siga as etapas abaixo:

- Investigue e resolva a conexão segura com falha. Consulte o tópico da Microsoft, [Problemas de conexão LDAP por SSL](https://docs.microsoft.com/pt-br/troubleshoot/windows-server/identity/ldap-over-ssl-connection-issues) .
- Execute os seguintes comandos para permitir uma conexão insegura em sua versão atual do Tableau Server antes de atualizar:
    
    `tsm configuration set -k wgserver.domain.allow_insecure_connection -v true --force-keys`
    
    `tsm pending-changes apply`
    
    Após a conclusão da atualização, recomendamos proteger o canal e, em seguida, definir esta opção para`false` .
    
    **Observação**: por padrão (quando `wgserver.domain.allow_insecure_connection` está definido como `false` ), a sincronização do grupo do Active Directory falhará se o canal de comunicação com o Active Directory não estiver criptografado.

### Os mapas não são exibidos ou são exibidos de forma incompleta após a atualização

Confirme se seu ambiente está configurado para permitir o acesso na porta 443 para `mapsconfig.tableau.com` e `api.mapbox.com`.

Para obter mais detalhes sobre os requisitos de acesso à Internet, consulte [Como se comunicar com a Internet](https://help.tableau.com/current/server/pt-br/plan_network.htm).

### Erro de script de atualização: "Falha na validação de alterações da versão do Tableau Server."

Ao atualizar, se você executar o `upgrade-tsm` script do diretório `scripts.<version_code>` para a versão anterior, ocorrerá uma falha de atualização com um erro:

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

Se você tiver esse erro, mude para o diretório para a versão que `scripts.<version_code>` acabou de instalar e execute o script a partir daí.

### Atualizar vários nós, falha na inicialização do nó adicional com o erro "Insira suas credenciais novamente"

Se tentar inicializar um nó adicional ao atualizar o Tableau Server e encontrar este erro:

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

pode ser uma indicação de que o nó não consegue se conectar a ou se comunicar com o nó inicial. Isso pode acontecer por diversos motivos:

- As credenciais inseridas não são válidas ou foram digitadas incorretamente. As credenciais devem ser de um usuário com permissões de administração no computador onde o Tableau Server foi instalado pela primeira vez. Não é necessário usar as credenciais do usuário que criou o arquivo bootstrap, mas fazendo isso você garante que está usando credenciais válidas.
- O firewall local do computador onde que está tentando adicionar não está permitindo a comunicação com o nó inicial. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall).

### A atualização falhou devido à falta de espaço em disco

Se não houver espaço em disco suficiente disponível para que o programa de Configuração do Tableau Server seja executado e faça a atualização, a instalação irá falhar. A quantidade necessária de espaço em disco dependerá do tamanho do banco de dados do seu repositório e do número e do tamanho das suas extrações.

Para liberar espaço em disco:

1. Crie um instantâneo do arquivo de registro usando o comando [`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs).
    
    Após criar o arquivo de ziplogs, salve-o em um local seguro que não seja parte da sua instalação do Tableau Server.
2. Limpe os arquivos desnecessários usando o comando [`tsm maintenance cleanup`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cleanup). Para obter mais informações, consulte [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm).

### Upgrade falha no trabalho RebuildSearchIndex

A etapa final em uma atualização é reconstruir o índice de pesquisa. Neste ponto, todos os serviços foram atualizados, portanto, se esta tarefa falhar, você pode redefinir manualmente o servidor de pesquisa. Você não precisa executar obliterate e começar de novo.

O erro será:

An error occurred while rebuilding search index.

Para redefinir o servidor de pesquisa:

1. No nó inicial, abra um prompt de comando como um administrador.
    
    Esta deve ser um novo prompt de comando porque o script de upgrade atualiza o ambiente do sistema para a nova versão.
2. Reconstrua o índice de pesquisa usando o comando [tsm maintenance reindex-search](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmmaintenancereindex) (2023.3 e posterior) ou [tsm maintenance reset-searchserver](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm_maint_reset_searchsvr) (2023.1 e anterior).

### Falhas de atualização

Após atualizar o Tableau Server, restaurar um backup do Tableau Server como parte do processo de atualização pode causar o seguinte erro:

_“O backup não pode ser restaurado porque o Tableau Server usa as novas tabelas de serviço de identidade por padrão.”_

Esse problema ocorre porque o Tableau Server 2022.1 (e posterior) usa um esquema de identidade diferente do esquema de identidade usado pelo backup. Para resolver esse problema, consulte [Solucionar problemas com migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm).

### Falhas de atualização

O recurso Upgrade do Checkpoint permite que você tente novamente uma atualização com falha. Em geral, isso é mais útil para administradores de servidores experientes e profissionais de TI que estão confortáveis com arquivos de registro do Tableau Server e estão dispostos a pesquisá-los. Mas o recurso pode ajudar em todos os upgrades com falha, porque permite que você execute de novo o script upgrade-tsm a partir da última etapa de sucesso, economizando tempo. Para os experientes, pode ser possível identificar problemas como problemas de espaço em disco ou problemas de permissões, corrigi-los e refazer o upgrade.

Se você está atualizando e o upgrade falha, as seguintes etapas podem ajudá-lo na conclusão:

- Reexecute o script `upgrade-tsm`. As falhas de upgrade às vezes são resultado de intervalos durante o processo de upgrade, e a nova executação do script pode permitir que o upgrade supere os problemas de tempo intermitentes ou ocasionais. Também é uma etapa segura e fácil de realizar. Uma nova execução do script não fará mal, e na pior das hipóteses, o upgrade falhará novamente no mesmo ponto, mas sem precisar passar por quaisquer etapas anteriores.
    
    O script está instalado no diretório `\scripts`.
    
    Por padrão,
    
    `C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\upgrade-tsm.cmd`
    
    Se o upgrade do Tableau Server não for bem-sucedido quando você executar novamente o script upgrade-tsm e estiver confortável com os registros do Tableau Server, pode realizar essas etapas adicionais de solução de problemas:
- Veja a saída do script na janela de comando (execute novamente o script se você não tiver mais a janela de comando aberta). Você precisa executar o script em uma janela de comando com acesso de administrador. Mensagens de erro úteis podem ajudá-lo a identificar a causa da falha de upgrade e dar-lhe algumas ideias de como corrigir o problema.
- Olhe no arquivo `app-upgrade.log`. Quaisquer erros são exibidos na linha de comando também aparecerão no arquivo `app-upgrade.log`, muitas vezes com mais detalhes.
- Olhe no arquivo `tabadmincontroller.log`. Problemas de upgrade que não são facilmente identificáveis nas duas instâncias acima são provavelmente o resultado de um problema em um trabalho. O arquivo `tabadmincontroller.log`pode ter mais informações que ajudam você a diagnosticar o problema.
    
    **Observação:** para obter informações sobre locais de registro, consulte [Locais de arquivo de registro e registros do Tableau Server](https://help.tableau.com/current/server/pt-br/logs_loc.htm).

### A atualização falha devido a problemas de permissão com o local do arquivo de backup/restauração

O script de atualização confirma as permissões do local do arquivo para o arquivo de backup/restauração antes de iniciar a atualização para que o arquivo possa ser gravado e lido do local durante a atualização para a nova versão do Tableau Server.

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

Os erros serão semelhantes a estes:

The runas user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

O local usado pelo TSM para backup e restauração é definido pela chave de configuração `basefilepath.backuprestore` e tem um padrão que o programa de instalação configura com as permissões corretas, mas isso pode ser afetado pelas regras de TI da organização ou se você alterar o local para um que você mesmo criou. Um novo comando disponível a partir de 2022.1 permite verificar as permissões no local do arquivo de backup/restauração imediatamente após criá-lo, para evitar problemas relacionados a permissões. Para obter detalhes sobre esse comando, consulte [tsm maintenance validate-backup-basefilepath](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmValidateBackupBasefilepath).

Para obter detalhes sobre o caminho do arquivo de backup/restauração, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

### A atualização foi bem-sucedida, mas as fontes de dados publicadas não podem ser acessadas

Em cenários específicos e limitados, após atualizar o Tableau Server da versão 2021.3 para versões anteriores de 2023.1 ou 2023.3, as tentativas de conexão ou atualização de fontes de dados publicadas existentes falham com este erro:

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

Isso pode acontecer se:

1. Você atualiza uma instalação do Tableau Server que era da versão 2021.3.x a qualquer momento (você pode estar executando a versão 2021.3 ou ter atualizado da versão 2021.3 para uma versão 2022.x)  
      
    _e_
2. Você atualiza essa instalação _para_ as primeiras versões de 2023.1 ou 2023.3

#### Nenhum impacto

Não há problemas nas seguintes situações:

- Em todos os outros caminhos de atualização _de_ 2021.3
- Em todos os outros caminhos de atualização _para_ 2023.1 ou 2023.3
- Em todas as novas instalações de 2023.1 e 2023.3

#### Mais informações

Em 16 de setembro de 2024, todas as versões problemáticas foram removidas do site de download. Se você precisar atualizar para a versão 2023.1.x ou 2023.3.x, atualize para as versões de manutenção 2023.1.16 ou superior, ou 2023.3.9 ou superior.

Para obter mais informações sobre o este problema, consulte [Problema conhecido](https://issues.salesforce.com/issue/a028c00000zJkyhAAC/tableau-server--following-upgrade-from-2022311-to-202334-published-data-sources-not-embedded-cannot-be-accessed).

## Problemas de importação de configurações comuns

### A importação de configurações do arquivo causa erro de validação "não presente em qualquer nó" devido a serviços ausentes

Se você estiver atualizando ao instalar uma nova versão do Tableau Server e importar um arquivo de configurações de uma versão anterior, poderá encontrar erros de validação de topologia ao executar o comando `tsm settings import`.

Isso pode acontecer quando você exporta um arquivo de configurações de uma versão mais antiga do Tableau Server e o importa para uma nova versão, e novos serviços foram adicionados ao Tableau entre as duas versões.

Os erros serão semelhantes a este (o serviço específico pode ser diferente):

c:\\Users\\mytableau\\Desktop>tsm settings import -f 20183-export.json  
  
Pending topology set.  
There are 1 topology validation errors/warnings.  
  
Service 'elasticserver' is not present on any node in the cluster.  
Service: Elastic Server

Para resolver esse problema, adicione quaisquer serviços ausentes ao Tableau Server:

1. Para qualquer serviço que gerou um erro de validação, adicione o serviço com uma contagem de instâncias de 1.
    
    Por exemplo, se o Elastic Server não estiver presente no cluster, defina a contagem da instância do processo como 1 usando o nome do serviço que aparece na primeira linha da mensagem de erro de validação:
    
    tsm topology set-process -n node1 -pr elasticserver -c 1
    
    Repita esta etapa para cada serviço que resulte em um erro.
2. Quando você não tiver mais avisos ou erros, aplique as alterações pendentes:
    
    tsm pending-changes apply

Suas configurações devem ser importadas com sucesso.

### A importação de configurações do arquivo causa erro "valor de configuração especificado não corresponde"

Se você estiver instalando uma nova versão do Tableau Server e importar um arquivo de configurações de uma versão anterior, poderá encontrar erros de validação de configuração ao executar o comando `tsm settings import`. Isso pode ocorrer quando um arquivo de configurações inclui um valor de configuração que foi removido do Tableau.

O erro será semelhante a este (a chave de configuração pode ser diferente):

c:\\Users\\mytableau\\Desktop>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '\[features.TsmConfigFileService\]'
Use this parameter to override unknown key error: --force-keys

Para resolver esse problema, edite o arquivo de configurações que você está importando para remover a referência à chave de configuração ou às chaves no erro:

1. Copie o arquivo de configurações JSON e salve a cópia para backup.
2. Abra o arquivo de configurações JSON em um editor de texto.
3. Localize e exclua toda a linha que inclui a chave. Neste exemplo, `features.TsmConfigFileService`:
    
    "configKeys" : {
      "config.version" : 19,
      "tabadmincontroller.port" : "8850",
      "endpoints.enabled" : false,
      "endpoints.health.enabled" : true,
      "features.TsmConfigFileService" : true,
      "tableau\_projects.language" : "en",
    
    O acima é um exemplo de uma pequena seção de um arquivo de configurações exportados e não se destina a representar todo o conteúdo do arquivo.
4. Salve o arquivo de configurações e importe-o novamente.

Você pode encontrar erros adicionais relacionados à validação da topologia. Para obter informações sobre a resolução desses erros, consulte [A importação de configurações do arquivo causa erro de validação "não presente em qualquer nó" devido a serviços ausentes](#ImportValidationError) acima.

### Erro "Você não pode modificar diretamente as instâncias do Serviço de Coordenação"

Esse erro pode ocorrer em duas situações:

- Quando você importa um arquivo de configurações do Tableau Server em uma instalação que tem uma topologia de Serviço de Coordenação diferente do que a do arquivo de configurações
- Quando você tenta configurar o Serviço de Coordenação usando o comando `tsm topology set-process`

#### Se você vir esse erro depois de importar um arquivo de configurações:

O arquivo de configurações do Tableau Server tem uma topologia de Serviço de Coordenação diferente da do servidor de destino. Isso pode acontecer se você estiver atualizando o Tableau Server pela instalação de uma nova versão e a importação de um arquivo de configurações de uma versão anterior. Se você não implantou explicitamente um conjunto de Serviço de Coordenação no servidor de destino, ele terá uma única instância do Serviço de Coordenação, no nó inicial.

Para corrigir esse erro, você pode corrigir a incompatibilidade da linha de comando ou editar o arquivo de importação de configurações. Você também pode descartar todas as alterações pendentes, implantar o Serviço de Coordenação no computador de destino para corresponder às configurações no arquivo de importação e reimportar o arquivo de configurações.

Para corrigir a incompatibilidade da linha de comando, em cada nó que gera um erro, use o comando tsm topology set-process para reverter a contagem de instâncias do Serviço de Coordenação.

1. Execute o comando `tsm pending-changes list`. A saída mostra quais nós têm alterações.
2. Encontre um ou mais nó onde a contagem do Serviço de Coordenação é alterada.
    
    Por exemplo, se o arquivo de configurações tivesse uma instância do Serviço de Coordenação no nó 2, mas o sistema de destino não tivesse qualquer instância de Serviço de Coordenação nesse nó, a contagem para o nó 2 seria alterada de 0 para 1 pela importação do arquivo de configurações:
    
    C:\\Windows\\system32>tsm pending-changes list
    Configuration
    There are no pending configuration changes.
    Topology
    node2:
                Coordination Service
                                    New Instance Count:1 
                                    Old Instance Count:0
3. Use o comando `tsm topology set-process` para definir a contagem de volta ao valor "Old Instance".
    
    Para o exemplo acima:
    
    tsm topology set-process -n node2 -c 0 -pr "Coordination Service"
4. Assim que você redefinir qualquer contagem de instâncias do Serviço de Coordenação que foi alterada, aplique alterações pendentes:
    
    tsm pending-changes apply

#### Se você ver o erro ao definir a contagem de processos para o Serviço de Coordenação manualmente:

Esse erro também pode ocorrer se você tentar atualizar diretamente o Serviço de Coordenação, usando o comando `tsm topology set-process` em vez dos comandos `tsm topology` para gerenciar o Serviço de Coordenação. Se você tentasse isso:

1. Use o comando `tsm pending-changes discard` para descartar as alterações pendentes.
2. Use os comandos corretos para configurar o Serviço de Coordenação. Para obter mais informações, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

## Solução de problemas de conexão com o TSM

### Não é possível se conectar ao TSM

Caso consiga conectar-se ao TSM a partir do computador em que o Tableau foi instalado (usando `https://localhost:8850`, por exemplo), mas não conseguir conectar-se de outro computador (usando `https://<server-name>:8850`), pode ser necessário configurar o firewall local no computador do Tableau Server.

É necessário configurar o firewall manualmente. Para obter mais informações, consulte [Configuração do firewall local](https://help.tableau.com/current/server/pt-br/requ.htm#firewall).

## Inicialização do Tableau Server

### O Tableau Server não pode determinar se iniciou completamente

Em alguns casos, o Tableau Server pode relatar que não seria possível determinar se todos os componentes foram iniciados corretamente. Uma mensagem exibe: "Não foi possível determinar se todos os componentes do serviço iniciaram de maneira correta."

Se você visualizar essa mensagem após a inicialização, verifique se o Tableau Server está sendo executado conforme esperado usando um comando [`tsm status -v`](https://help.tableau.com/current/server/pt-br/cli_status_tsm.htm#status)

Se o status mostra como em execução ("Status: RUNNING"), em seguida, o servidor é inicializado com êxito e você pode ignorar a mensagem. Se o status for DEGRADED or STOPPED, consulte "O Tableau Server não inicia" na próxima seção.

### O Tableau Server não inicia

Se o Tableau Server não iniciar ou estiver sendo executado em um estado degradado, execute o comando [`tsm restart`](https://help.tableau.com/current/server/pt-br/cli_restart_tsm.htm#restart) de um prompt de comando. Isso irá interromper qualquer processo em execução e iniciar novamente o Tableau Server.

## Reindexação do Tableau Index and Search Server (2023.3 e posterior)

### Problemas que podem ser resolvidos ao criar o Tableau Index and Search Server

Os sintomas de um índice que precisa ser recriado incluem:

- Uma lista em branco de sites quando um usuário tenta efetuar logon
- Uma lista em branco de projetos quando um usuário tenta selecionar um projeto
- Conteúdo ausente (pastas de trabalho, exibições, painéis)
- Alertas inesperados ou imprecisos (por exemplo, um alerta "atualização falhou" em uma pasta de trabalho que não inclua uma extração)

Se você observar qualquer um destes comportamentos, reinicie e recrie o índice do Index and Search Server usando o comando [`tsm maintenance reindex-search`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmmaintenancereindex).

## Reindexação do Tableau Index and Search Server (2023.1 e anteriores)

### Problemas que podem ser resolvidos ao criar o índice de pesquisa e navegador

Os sintomas de um índice que precisa ser recriado incluem:

- Uma lista em branco de sites quando um usuário tenta efetuar logon
- Uma lista em branco de projetos quando um usuário tenta selecionar um projeto
- Conteúdo ausente (pastas de trabalho, exibições, painéis)
- Alertas inesperados ou imprecisos (por exemplo, um alerta "atualização falhou" em uma pasta de trabalho que não inclua uma extração)

Se você observar qualquer um destes comportamentos, reinicie e recrie o índice de pesquisa e navegador, usando o comando [`tsm maintenance reset-searchserver`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm_maint_reset_searchsvr).

## Ativação do Tableau Server

### Falha na ativação da licença do Tableau Server

A ativação da licença pode falhar em algumas instâncias do Tableau Server. As mensagem de erro podem originar de uma bem genérica:

- An error has occurred

Para mensagens mais detalhadas:

- Function flxActCommonLicSpcPopulateFromTS returned error 50030, 71521,
- No license found for 'Tableau Server'

Para resolver esse problema, experimente estas soluções na ordem listada:

#### Confirme que pode acessar o servidor de licenciamento

Para testar o acesso, digite a URL e a porta do servidor de licenciamento em um navegador:

https://licensing.tableau.com:443

e:

https://atr.licensing.tableau.com/\_status/healthz

Se puder acessar o servidor, a mensagem “Teste realizado com sucesso” será exibida para o primeiro servidor, e a mensagem “OK” será exibida para o segundo.

O Tableau Server precisa fazer uma conexão com os seguintes locais na Internet para fins de licenciamento:

- atr.licensing.tableau.com:443
- licensing.tableau.com:443
- register.tableau.com:443
- o.ss2.us
- s.ss2.us
- crt.rootca1.amazontrust.com
- crt.sca1b.amazontrust.com
- crt.sca0a.amazontrust.com
- crt.sca1a.amazontrust.com
- crt.sca2a.amazontrust.com
- crt.sca3a.amazontrust.com
- crt.sca4a.amazontrust.com
- \*.digicert.com
- ocsp.\*.amazontrust.com
- crl.\*.amazontrust.com
- crt.rootg2.amazontrust.com

As solicitações para os domínios acima podem ser feitas na porta 80 ou 443. A porta 80 é utilizada para validação de certificados (revogação, cadeia de certificados etc). A porta 443 é usada para conexões SSL.

Solicitações aos domínios `ocsp.*.amazontrust.com` e `crl.*.amazontrust.com` são gerenciados pela Amazon para obter informações de revogação de certificados. Consulte [Características de certificados ACM](https://docs.aws.amazon.com/acm/latest/userguide/acm-certificate.html) para obter maiores informações. Recomendamos que você instale os certificados raiz da Amazon no armazenamento confiável de certificados no computador que executa o Tableau. Para baixar e instalar os certificados raiz da Amazon, consulte [Autoridades Certificadoras](https://www.amazontrust.com/repository/#cas) no site da Amazon Trust Services.

#### Verificar data e hora

Verifique se a data e a hora no computador do Tableau Server inicial estão corretas. Se o relógio estiver definido com a hora e a data anteriores à data atual, o Tableau Server não poderá ser ativado.

#### Verificar se o serviço de licenciamento FlexNet foi iniciado

Se a data e a hora no computador do Tableau Server estiverem corretas, verifique se o serviço de licenciamento FlexNet está em execução no computador inicial do Tableau Server.

1. No computador inicial, no menu Iniciar do Windows, abra services.msc.
2. Na caixa de diálogo Serviços, verifique se o status do _Serviço de licenciamento FlexNet 64_ (64 bits) ou _Serviço de licenciamento FlexNet_ (32 bits) está Iniciado.
    
    Se o FLEXnet não estiver listado como Iniciado, clique com o botão direito do mouse no Serviço de licenciamento FlexNet e selecione Iniciar.
    
    Se a opção Iniciar estiver esmaecida, talvez o serviço esteja definido como Desabilitado. Para habilitar o serviço:
    
    1. Clique com o botão direito do mouse em Serviço de licenciamento FlexNet e selecione Propriedades.
    2. Na lista suspensa Tipo de inicialização, selecione Automática.
    3. Clique no botão Iniciar e clique em OK.

#### Forçar uma nova leitura da chave do produto

1. No computador inicial do Tableau Server, faça logon como administrador e abra um prompt de comando.
2. Altere para o diretório bin do Tableau Server. Por padrão, ele é:
    
    `C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>`
3. Digite os seguintes comandos:
    
    tsm stop  
    lmreread
      
    tsm start

#### Enviar o conteúdo do armazenamento confiável para o suporte do Tableau

Se os serviços de licenciamento FlexNet estiver instalado e em execução, mas você ainda estiver vendo um erro, poderá haver um problema com as informações de chave de produto do Tableau. Para solucionar isso, conclua as etapas a seguir para criar um arquivo das informações importantes no armazenamento confiável.

1. No computador inicial do Tableau Server, faça logon como administrador e abra um prompt de comando.
2. Digite o seguinte comando:
    
    serveractutil -view > <machine\_name>-LicResults.txt
    
    Isso cria o arquivo `<machine_name>-LicResults.txt` no diretório atual. Se não tiver permissões de gravação para esse local e visualizar um erro, altere para um local onde tenha permissão para criar um arquivo e execute o comando novamente.
3. Entre em contato com o Suporte do Tableau ([http://www.tableau.com/pt-br/support/request](http://www.tableau.com/pt-br/support/request)) e inclua o arquivo `<machine_name>-LicResults.txt` criado.

## Problemas de instalação de tabcmd

### Instalação de tabcmd separadamente

O tabcmd é instalado automaticamente nos nós do Tableau Server quando você instala o Tableau Server, mas se quiser executá-lo em outro computador, precisa baixar e instalar tabcmd separadamente. Para obter detalhes, consulte [Instalar tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm#tabcmd-install).

### Problemas na instalação do tabcmd no Linux

O tabcmd requer que o Java 11 seja executado corretamente. Em sistemas semelhantes ao RHEL, ele será instalado como uma dependência ao instalar o tabcmd. Em sistemas semelhantes ao Debian, você precisa instalar o Java 11 separadamente, se ele ainda não estiver instalado.

A partir de julho de 2022, as distribuições Debian não são mais aceitas. Para obter mais informações, consulte a [postagem da Comunidade do Tableau](https://community.tableau.com/s/news/a0A4T0000011xDOUAY/debian-end-of-life).

#### O Java não está instalado

Se você receber erros semelhantes a este ao instalar tabcmd, confirme se o Java 11 está instalado no seu computador Linux:

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

#### Versão incorreta do Java instalada

Se você receber erros semelhantes a estes, confirme se o Java 11 está instalado:

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

ou.

\*\*\* Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
\*\*\* See the logs for the stacktrace.

<!-- document id=8e6c8f3b5076adeb7896c0cb513af63fb8b8be2d3486da9fb404eb683ca6befb url=/tableau/current/pt-br/server/rmt-troubleshoot-rmt-service-interruptions.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de interrupções de serviço do RMT Server

Você pode estar enfrentando interrupções de serviço devido à parada regular do RMT Server. Isso é mais provável porque Resource Monitoring Tool foi configurado com contas de serviço que não estão em conformidade com suas políticas internas de TI. Muitos departamentos de TI empregam ferramentas de automação que revogam privilégios em contas consideradas não compatíveis com seus padrões e são a causa das interrupções do serviço.

**Solução temporária:** Reinicie o RMT Server executando `rmtadmin start -master`.

**Solução a longo prazo:** Você pode configurar o Resource Monitoring Tool para executar em uma conta compatível com suas políticas internas de governança (recomendado) ou, como alternativa, trabalhar com seu departamento de TI para obter uma exceção da política.

## Quem pode fazer isso

Você precisa ser um Administrador na máquina e um Administrador do Resource Monitoring Tool para fazer alterações de configuração e banco de dados.

<!-- document id=53ac1c44e1abd3cf1d049469632776c09b9da9a17f5626b41aae2d9016baf4b3 url=/tableau/current/pt-br/server/unlicensed.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de licenciamento

Este tópico inclui instruções para solução de problemas relacionadas ao licenciamento do Tableau Server.

## Falha na chave do produto com servidores proxy de encaminhamento

Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de tentar ativar, atualizar ou desativar chaves do produto.

## Como lidar com um servidor não licenciado

O Tableau oferece dois modelos de licenciamento: baseado em função e baseado em núcleo. Para saber mais sobre o licenciamento baseado em função e em núcleo, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

O licenciamento baseado em função exige que cada conta de usuário ativa seja coberta por uma licença. As licenças baseadas em função têm uma capacidade definida ou um número de usuários permitidos. Cada usuário tem um nome de usuário exclusivo atribuído a ele no servidor e é exigido para a identificação dele ao se conectar ao servidor.

O licenciamento baseado em núcleo não tem restrições quanto ao número de contas de usuário no sistema, mas ele não restringe o número máximo de núcleos de processador que o Tableau Server pode usar. Você pode instalar o Tableau Server em um ou mais computadores para criar um cluster, com a restrição de que o número total de núcleos em todos os computadores não exceda o número de núcleos que você licenciou e que todos os núcleos em um computador específico sejam cobertos pela licença.

### Servidor baseado em função não licenciado

O motivo mais comum para que um servidor que tenha licenciamento baseado em função tenha sua licença cancelada é uma chave de produto expirada ou um contrato de manutenção expirado.

### Servidor baseado em núcleo não licenciado

Um servidor baseado em núcleo pode se tornar não licenciado para uma variedade de motivos, por exemplo, uma chave do produto vencida ou quando os nós do Tableau Server estão executando processos licenciados não conseguem entrar em contato com o nó do Tableau Server sendo executado no serviço de Gerenciador de Licença. Para saber mais sobre os processos licenciados, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

Quando o servidor for não licenciado, você não poderá iniciar nem administrar o servidor. No entanto, é possível gerenciar licenças com o comando [tsm licenses](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm).

### Administrador do servidor não licenciado

Todos os administradores do Tableau Server exigem uma licença de usuário. Os administradores do Tableau Server sempre terão a função mais alta disponível. Se uma chave de produto Creator for ativada, os administradores do Tableau Server assumirão essa função. Se a função mais alta disponível no Tableau Server for Explorer, o administrador do servidor assumirá essa função. Se as licenças Creator forem adicionadas ao servidor, as contas de administrador do servidor existentes que usam licenças Explorer serão automaticamente convertidas para usar licenças Creator.

As contas de administrador do TSM não exigem licenças.

Se a licença que o administrador do servidor está usando expirar, então a conta ficará sem licença e não poderá fazer logon.

Verifique a data de validade de suas licenças para os administradores do servidor:

- Execute [tsm licenses list](https://help.tableau.com/current/server/pt-br/cli_licenses_tsm.htm#TSMLicenseList).
- Compare a data com a data exibida no [Portal do cliente Tableau](http://customer.tableausoftware.com/).
- Caso o portal não exiba a data que você espera, entre em contato com o [Sucesso do cliente](https://www.tableau.com/pt-br/support/customer-success).
- Para renovar a licença, visite a página na Web [Renovação do Tableau.](https://www.tableau.com/pt-br/support/renew)
- Execute o comando [tsm licenses activate](http://onlinehelp.tableau.com/current/server-linux/pt-br/cli_licenses_tsm.htm#TSMActivate) para ativar uma nova licença para as contas do administrador.

Se a data do TSM corresponder à data do portal e a seguinte operação de atualização falhar, entre em contato com o [Suporte do Tableau](https://www.tableau.com/pt-br/support).

Se a licença para sua conta de administrador expirou ou expirará em breve, você precisará ativar uma nova licença para a conta. Como alternativa, você pode remover a licença de um usuário não administrador para liberar uma licença para a conta de administrador do servidor.

Se um administrador do Tableau Server estiver usando uma licença Creator (Criador), Explorer (Explorador) ou Viewer (Visualizador) e essa licença expirar, ele usará outra do mesmo tipo, se disponível. Se não houver estações de licença disponíveis, o usuário ficará "sem licença".

**Importante**: não reinicie o Tableau Server até que você tenha ativado uma nova licença ou transferido uma função do site para a conta do administrador do servidor.

## Solucionar problemas de licenciamento baseado em função

Essa seção fornece informações sobre a solução de problemas que ocorrem ao adicionar licenças baseadas em função do Viewer, Explorer e Creator para o Tableau Server ou Tableau Cloud, ou quando elas expiram. O mais alto tipo de licença disponível é Creator, seguida por Explorer e finalmente Viewer. Para saber mais sobre o licenciamento baseado em função, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

### Um usuário ou administrador não está licenciado devido ao vencimento da licença

Para evitar que os usuários fiquem sem licença de modo inesperado ou sejam transferidos para outra função no site, você sempre deve fazer uma das ações a seguir antes da licença, que estiver usando, expirar:

- Renove e ative uma licença substituta. Se um usuário ocupar uma licença Creator (Criador), Explorer (Explorador) ou visualizador e essa licença expirar, ele usará outra do mesmo tipo, se disponível.
- Altere a função no site desses usuários, para permitir o uso de uma licença que não expira.

Para saber como as funções no site podem ser alteradas, para que necessitem de uma licença diferente, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

A reatribuição dos usuários a novas licenças é regida pela seguinte lógica:

- Quando um usuário Administrador do servidor ocupa uma licença do Creator e a licença dele expira (sem licenças disponíveis para substituição), ele é reatribuído a uma licença do Explorer se qualquer licença do Explorer estiver disponível. Essa reatribuição de licença ocorre na ordem do logon mais recente. Os Administrador do servidor removem outros usuários que possam estar atualmente usando uma licença do Explorer. Se nenhuma licença do Creator ou Explorer estiver disponível, um Administrador do servidor se torna não licenciado.
- Quando um usuário não Administrador do servidor ocupa uma licença do Creator e a licença expira (sem licenças disponíveis para substituição), ele se torna não licenciado. Para evitar que esses usuários se tornem não licenciados, altere a função no site antes da licença expirar. Isso é especialmente importante para usuários na função no site Criador do administrador de site, que devem se mover para a função de site de Explorador de administrador de site, antes da licença do Creator expirar para evitar perder os recursos de Administrador de site.
- Quando um usuário Administrador do servidor ocupa uma licença do Explorer ou do Viewer e a licença dele expira (sem licenças disponíveis para substituição), ele é atualizado para um tipo de licença mais alta, se as licenças desse tipo estiverem disponíveis. Especificamente, o seguinte ocorre quando uma licença expira:
    - Os usuários que ocupam uma licença do Explorer serão movidos para uma licença do Creator, se disponível (sem alterar a função no site).
    - Os usuários que ocupam uma licença do Viewer serão movidos para uma licença do Explorer, se disponível. Se nenhuma licença do Explorer estiver disponível, esses usuários serão transferidos para uma licença do Creator, se disponível (sem alterar a função no site).
    - Se nenhuma licença estiver disponível em tipos de licença mais altos, esses usuários são transferidos para Não licenciados.

Os usuários são reatribuídos para uma nova licença, conforme descrito acima, na ordem do logon mais recente, com tipos de licença mais baixas reatribuídas primeiro (primeiro Viewer, em seguida Explorer e, em seguida, Creator).

Por exemplo: dois usuários com uma licença Visualizador, um usuário com a licença de Creator (Criador) e dois Administradores de servidor com uma licença de Creator (Criador), todos com suas licenças expiradas. Quatro licenças Explorer (Explorador) não expiradas estão disponíveis para eles. Nessa situação, ocorre o seguinte, na ordem mostrada abaixo:

1. O usuário com uma licença Visualizador que fez o logon mais recente será reatribuído a uma licença Explorer (Explorador).
2. O usuário com uma licença Visualizador será reatribuído a uma licença Explorer (Explorador).
3. O usuário Administrador de servidor com uma licença Creator (Criador) que fez o logon mais recente será reatribuído a uma licença Explorer (Explorador). Em seguida, o segundo Administrador de servidor com uma licença de Creator (Criador) será reatribuído à licença Explorer (Explorador) restante.
4. O usuário com a licença de Creator (Criador) se torna não licenciado.

### A função no site do Administrador do servidor é inalterada ao usar uma licença do Creator

Os Administradores do servidor ganham recursos do Creator, se as licenças do Creator estiverem disponíveis no Tableau Server, sem alterar o nome da função no site. Todos os outros usuários do Tableau Server e Tableau Cloud ganham licenças do Creator, somente se estiverem atribuídos com uma função no site que inclui o Creator no nome.

### As licenças não estão imediatamente disponíveis

Quando você adiciona uma licença baseada em função ao Tableau Server, ela é disponibilizada a todos os usuários quando você reinicia o Tableau Server.

### Um usuário com uma licença do Viewer não pode abrir as pastas de trabalho do Tableau Server ou Tableau Cloud no Tableau Desktop

Um usuário com uma licença do Viewer que também tem uma licença do Tableau Desktop separada não poderá abrir pastas de trabalho no Tableau Server ou Tableau Cloud usando o Tableau Desktop. Para abrir pastas de trabalho usando o Tableau Desktop, o usuário precisará de uma licença do Explorer ou Creator no Tableau Server ou Tableau Cloud.

<!-- document id=3b60e192a8b479dff4691cdbd3f5675edaf5a4e544fabf43be9c74aedd521237 url=/tableau/current/pt-br/server/trouble_inconsistent_process_status.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de status de processos inconsistente

**Isenção de responsabilidade.** Este tópico contém informações sobre um produto de terceiros. A inclusão desta informação não significa endosso do produto, contudo, é disponibilizada para a conveniência de nossos clientes. Observe que, ainda que façamos todos os esforços para manter as referências a conteúdo de terceiros precisas e atualizadas, as informações fornecidas aqui podem mudar sem aviso prévio conforme o produto de terceiros muda.

Siga as sugestões para solucionar problemas comuns dos status de processos do Tableau Server. Para obter as etapas de solução de problemas adicionais baseadas em status do processo exibido na página Status, consulte [Solucionar problemas dos processos do servidor](https://help.tableau.com/current/server/pt-br/service_status_troubleshoot.htm).

## Problemas

Quando o Tableau Server estiver configurado com diversos cartões de rede , a página Status pode relatar status de processos inconsistentes ou incorretos. Tais inconsistências e incorreções em potencial podem interferir em outras funcionalidades, como, por exemplo, alertas e notificações operando de maneira instável.

## Ambiente

- Tableau Server 2021.2 e superiores
- Tableau Server em computadores com vários cartões de rede (NICs)

## Resolução

Para resolver esse problema, desabilite o segundo NIC ou use o procedimento a seguir para designar métricas para cada NIC no computador.

**Observação:** este problema não será resolvido com a atualização do DNS ou com a utilização de roteamento local no arquivo etc\\hosts para se referir ao endereço de IP preferencial sem realizar as seguintes etapas. Para obter mais informações relacionadas, consulte [Os erros “Nenhum usuário do Tableau Server encontrado” e “DataServiceFailure” ocorrem intermitentemente em ambientes de múltiplas interfaces de rede (NICs)](https://kb.tableau.com/articles/issue/error-no-tableau-server-user-found-and-dataservicefailure-occur-intermittently-in-multiple-network-interfaces-nics-environment?lang=pt-br).

### Designar métricas para cada interface de rede

Uma métrica é uma forma de indicar o "custo" de usar uma interface de rede. Quanto maior a métrica, mais caro é o uso. No Windows, por padrão, a Métrica automática está ativada, mas você pode designar métricas manualmente para cada interface de rede para indicar qual delas é a preferencial. Quanto mais baixa a métrica, mais preferência terá a interface.

Para configurar métricas de uma interface de rede manualmente:

1. No Painel de controle, clique em Rede e Internet.
2. Clique em Central de rede e compartilhamento.
3. Clique em Alterar as configurações do adaptador.
4. Clique com o botão direito do mouse em uma interface de rede e clique em Propriedades.
5. Selecione Protocolo IP versão 4(TCP/IPv4) e clique em Propriedades.
6. Na guia Geral, clique em Avançado.
7. Na guia Configurações de IP, desmarque Métrica automática e insira a métrica que deseja na caixa da Métrica da interface.
    
    As métricas indicam o custo do uso da interface.

Repita o processo para qualquer outra interface, atribuindo a elas métricas baseadas nas preferências delas. A interface usada pelo Tableau Server deve ser a interface preferencial e apresentar a métrica de menor valor. Por exemplo, dê à interface de rede uma métrica de valor 5 e à interface secundária, o valor 10.

**Isenção de responsabilidade:** embora façamos todos os esforços para garantir que os links para sites externos sejam precisos, atualizados e relevantes, o Tableau não pode assumir a responsabilidade pela precisão ou atualização de páginas mantidas por fornecedores externos. Entre em contato com o site externo para obter respostas para perguntas relacionadas ao conteúdo dele.

Para obter mais informações sobre o Windows e como usar métricas para roteamento de IP, consulte a seguinte documentação da Microsoft:

- [https://support.microsoft.com/pt-br/kb/299540](https://support.microsoft.com/pt-br/kb/299540)
- [https://technet.microsoft.com/pt-br/library/cc771274.aspx](https://technet.microsoft.com/pt-br/library/cc771274.aspx)

<!-- document id=f69626a9fed88d6fc7dafbe03a0101959e4b8cbff18ae58b4e972907f818fd95 url=/tableau/current/pt-br/server/rmt-troubleshoot-tableau-server-processes.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de status desconhecido dos processos do Tableau Server

Em determinadas condições, você pode ver que o status de um processo do Tableau Server relatado como **Unknown**. Isso geralmente ocorre devido a uma alteração na configuração do processo no Tableau Server que ainda não foi atualizada no Resource Monitoring Tool do Tableau.

**Observação:** após atualizar qualquer configuração, pode demorar alguns minutos para atualizar o status relatado pelo Resource Monitoring Tool. Por padrão, o Resource Monitoring Tool verifica o status do Tableau Server a cada 15 segundos, mas pode ser mais longo se você o configurou para verificar com menos frequência.

Utilize as seguintes etapas de solução de problemas para resolver isso:

## Etapa 1: verificar as configurações do ambiente do Tableau Server

O Resource Monitoring Tool conecta-se ao Tableau Server para monitoramento e coleta de dados. Se o Tableau Server for atualizado, ou as credenciais do Tableau Server expirarem, Resource Monitoring Tool não conseguirá monitorar como esperado.

Para confirmar se o Resource Monitoring Tool é capaz de se conectar ao Tableau Server:

1. Go to **Admin** > **Environments list** page.
2. Edite o ambiente que ocorre o problema.
3. Confirme se a versão selecionada do Tableau Server está correta. Ao atualizar o Tableau Server, talvez seja necessário atualizar a versão no Resource Monitoring Tool.
4. Teste a conexão da API REST do Tableau Server usando o botão “Testar conexão”.
    
    Como opção, teste a conexão do repositório do Tableau usando o botão “Testar conexão”.

## Etapa 2: atualizar as máquinas e os processos do Tableau Server

Para monitorar corretamente um Tableau Server, o Resource Monitoring Tool precisa ser configurado com um registro completo dos nomes de máquina e das portas de processo do Tableau Server. Essas informações são automaticamente coletadas ao criar um novo ambiente, mas podem ser atualizadas manualmente se a configuração do Tableau Server for alterada.

1. Vá para a página **Administrador** > **Ambientes**.
2. Edite o ambiente que ocorre o problema.
3. Confirme se a lista de **Servidores** contém o nó/gateway inicial do Tableau Server, bem como todas as máquinas de nó adicionais.
4. Siga as etapas abaixo para confirmar se cada servidor está configurado corretamente.

## Etapa 3: atualizar o nome da máquina

1. Abra esta URL do Tableau Server: _http://<sua URL do TableauServer>/admin/systeminfo.xml_.
2. Compare e atualize a configuração do Resource Monitoring Tool com esta página para garantir que ela esteja atualizada:
    - Atualize o nome de host do servidor para corresponder exatamente ao valor de atributo <machine name="{HOST NAME}" />.

## Etapa 4: entrar em contato com o suporte

Se, após seguir as etapas acima, o problema ainda não for resolvido, contate o [suporte ao cliente do Tableau](https://www.tableau.com/pt-br/support).

## A página de detalhes da sessão VizQL diz que o processo VizQL é desconhecido

As solicitações HTTP de uma exibição do Tableau são vinculadas ao processo VizQL (o VizQL PID real) que bloqueou pela última vez a ID da sessão VizQL da solicitação.

Em alguns casos, podemos não encontrar um processo VizQL correspondente (PID). Nesses casos, você verá uma mensagem na página de detalhes da sessão de exibição dizendo que o processo VizQL é desconhecido.

Isso pode acontecer em alguns casos raros:

- O cluster do Tableau foi modificado com a adição de uma nova instância de trabalho do VizQL.
- O Tableau ajusta o número da porta do processo VizQL para evitar um conflito com outro processo.

Se isso acontecer, entre no Resource Monitoring Tool e navegue até a tela do administrador do ambiente. Você desejará verificar as definições de processo dos servidores. Verifique se os processos VizQL foram definidos nos servidores esperados e com os números de porta corretos.

## Quem pode fazer isso

Para solucionar problemas nos processos do Tableau Server, você precisa ser um administrador do Tableau Server e do Resource Monitoring Tool.

<!-- document id=9c43211751f34164479e512c44b30a11c2333d57384d404cc7f963a502b6002b url=/tableau/current/pt-br/server/trouble_disk_space.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de uso do espaço em disco nos nós do Tableau Server

Quando um espaço em disco disponível em um nó do Tableau Server for pequeno, o desempenho pode se prejudicado. Se o espaço livre estiver muito baixo, o Tableau Server pode começar a funcionar de maneira instável.

Para monitorar o espaço livre em disco, configure o Tableau Server para salvar as informações de utilização do disco (este recurso está ativado por padrão) e, se desejado, habilite as notificações por e-mail sobre o pouco espaço em disco. Para obter mais informações, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).

**Observação:** o monitoramento do espaço em disco mede o espaço livre em disco de cada nó do servidor. O espaço disponível pode ser prejudicado por programas ou processos que não são parte do Tableau Server.

Se acreditar que a instalação do Tableau Server está sendo executada com limitações de espaço em disco disponível, adote medidas para liberar mais espaço. Este tópico sugere algumas maneiras de você fazer isso. Você também pode encontrar informações úteis na Base de conhecimento do Tableau: [Após ficar sem espaço no disco rígido, alguns processos não podem ser iniciados](https://help.salesforce.com/s/articleView?id=001471670&type=1 "Artigo da base de conhecimento sobre a falta de espaço em disco impedindo que os processos iniciem").

## Visualização do uso de disco nos nós do Tableau Server

Quando o monitoramento de utilização de espaço em disco está ativado (esse é o padrão), os administradores do servidor podem usar a exibição administrativa [Espaço em disco do servidor](https://help.tableau.com/current/server/pt-br/adminview_space_all_nodes.htm) para ver a utilização atual do espaço em disco e um mês de utilização de dados nos nós do Tableau Server. Use essa exibição para ajudá-lo a determinar se um de seus nós de servidor estiver passando por variações de utilização de espaço ou se a utilização de espaço tiver aumentado ao longo do tempo.

## Limpeza de arquivos relacionados ao Tableau Server

Para minimizar o espaço em disco usado pelo Tableau Server, apague arquivos desnecessários.

Use o comando [`tsm maintenance cleanup`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#cleanup) para remover arquivos de log, arquivos temporários e entradas desnecessárias no banco de dados PostgreSQL. Se desejar salvar os logs antes de limpá-los, é possível criar um arquivo. Para obter mais informações, consulte [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm).

Depois que você tiver limpado os arquivos de registro e os arquivos temporários, poderá ser necessário usar exibições administrativas para determinar quais pastas de trabalho e fontes de dados estão ocupando mais espaço em seu servidor e se alguma delas não está sendo usada. Para obter mais informações, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

## Redução dos registros do serviço de coordenação

O Serviço de coordenação pode gerar um grande número de registros de transação durante o funcionamento normal. Por padrão, o Serviço de coordenação reunirá essas informações, criando um instantâneo para cada 100.000 registros de transação e excluindo instantâneos com mais de cinco dias. Se houver menos de 100.000 registros de transação, nenhum instantâneo será criado e os registros permanecerão no local até que o limite de registro de transação seja atingido. Como resultado, o espaço em disco poderá ser reduzido à medida que os registros forem acumulados. Por padrão, os registros e instantâneos são salvos no diretório de dados do Tableau Server: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\appzookeeper\<n>\version-2`.

Se houver falta de espaço em disco devido a registros de transação antigos, a instalação do Tableau Server poderá gerar menos de 100.000 registros diariamente. Você pode ajustar o número de registros necessários para acionar a criação de um instantâneo usando a opção `zookeeper.config.snapCount` :

`tsm configuration set -k zookeeper.config.snapCount -v <transaction_log_count>`

`tsm pending-changes apply`

Para obter mais informações, consulte [zookeeper.config.snapCount](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#zookeeper_snapCount).

#### Não é possível acessar o Tableau Server ou a interface do usuário da Web do TSM depois de ficar sem espaço em disco

Para evitar a falta de espaço em disco, considere configurar as notificações de pouco espaço em disco para informar quando o espaço atingir um tamanho predeterminado. Para obter mais informações, consulte [Configurar notificação de evento do servidor](https://help.tableau.com/current/server/pt-br/email.htm).

Se você ficar sem espaço em disco, poderá ter problemas para acessar o Tableau Server ou o TSM usando a interface do usuário na Web. Para corrigir esse problema, exclua os arquivos estranhos para liberar espaço em disco e force a reconfiguração do servidor definindo uma chave inexistente.

1. No nó inicial, abra um prompt de comando como um administrador.
2. Definir uma chave de configuração inexistente:
    
    `tsm configuration set -k foo -v bar --force-keys`
3. Aplique as alterações para forçar a reconfiguração:
    
    `tsm pending-changes apply`

Definir uma chave inexistente não terá impacto no Tableau.

<!-- document id=367c4ea6eac5fb5239c1dd6ffc075af4254b2edf9576a25d5c3c2da2358ed49f url=/tableau/current/pt-br/server/trouble_WDC_server.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas de WDC

Os conectores de dados da Web (WDCs) são páginas da Web para conectar-se a dados acessíveis por HTTP para fontes de dados que ainda não têm um conector no Tableau. Este tópico cobre problemas potenciais que você pode encontrar com os WDCs.

## A atualização da extração WDC falhou com o erro 'Processo de renderização encerrado - processo de renderização falhou (código de saída = -2147483645)'

Recomendamos que você use uma conta de serviço Run As que não esteja em nenhum grupo de administradores para o computador em que o Tableau Server está sendo executado. Essa é uma prática recomendada por motivos de segurança, mas também pode afetar os problemas de conexão com fontes de dados e WDCs. O problema específico com as falhas de atualização de extração de WDC é um tipo de problema de conexão que pode ocorrer se sua conta de serviço Run As for membro de um grupo Administradores no computador do Tableau Server. Para resolver esse problema, atualize a conta do serviço Run As para que ela não tenha privilégios de administrador no computador.

Para obter mais detalhes sobre este problema, consulte a [Base de dados de conhecimento do Tableau](https://kb.tableau.com/articles/Issue/wdc-extract-refresh-failed-with-error-render-process-terminated-render-process-crashed-exit-code-2147483645?lang=pt-br).

Para obter informações sobre as práticas recomendadas ao criar ou atualizar uma conta de serviço Run As, consulte [Criação da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm#best) .

<!-- document id=6a702492d76604fa76f070842b1bc8fae3c5d2dec2f80abb4738b522ed00dda2 url=/tableau/current/pt-br/server/kerberos_trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas do Kerberos

As sugestões de solução de problemas neste tópico são divididas em questões relacionadas ao SSO (Single sign-on) no servidor e às fontes de dados delegadas.

## Logon único no Tableau Server

Em um ambiente do Kerberos SSO, um usuário que faz logon no Tableau Server a partir de um navegador da Web ou do Tableau Desktop poderá ver uma mensagem indicando que o Tableau Server não pode conectá-lo automaticamente (usando o logon único). Em vez disso, ele sugere fornecer um nome e senha de usuário do Tableau Server.

![](/tableau/current/pt-br/server/pt-br/Img/kerb_auth_failed.png)

### Solução de problemas de logon no computador do cliente

- **Insira o nome de usuário e a senha**—para verificar o acesso geral do usuário ao Tableau Server, faça logon ao inserir o nome e senha de usuário.
    
    Se as credenciais falharem, o usuário pode não ser um usuário no Tableau Server. Para que o Kerberos SSO funcione, o usuário deverá ser capaz de acessar o Tableau Server, além de receber um Ticket Granting Ticket (TGT) do Active Directory (conforme descrito no item **TGT** nesta lista).
- **Verifique outras credenciais SSO de usuários**—Tente conectar ao SSO para Tableau Server usando outras contas de usuário. Se todos os usuários tiverem sido afetados, o problema pode estar na configuração do Kerberos.
- **Use um computador diferente do servidor**— o Kerberos SSO não funciona ao fazer logon no Tableau Server do host local. Os clientes devem se conectar de um computador que não seja o computador do Tableau Server.
- **Use um nome do servidor, não o endereço IP**—o Kerberos SSO não funciona se você inserir um endereço IP como o nome do Tableau Server. Além disso, o nome do servidor usado para acessar o Tableau Server deve corresponder ao nome usado na configuração do Kerberos (consulte **[Entrada da tabela principal](#keytable)**, abaixo).
- **Confirme que o cliente possui o TGT**—o computador do cliente deve ter um TGT (Ticket Granting Ticket) do domínio do Active Directory. A delegação limitada, com um proxy que conceda um tíquete, não é suportada.
    
    Para confirmar se o computador do cliente é do tipo TGT, faça o seguinte:
    
    - No Windows, abra um prompt de comando e digite o seguinte: `klist tgt`
    - No Mac, abra uma janela terminal e digite o seguinte: `klist`
    
    O resultado exibirá um TGT para o usuário/domínio que estiver tentando autenticar ao Tableau Server.
    
    O computador cliente pode não ter um TGT nas seguintes circunstâncias:
    
    - O computador do cliente está usando uma conexão VPN.
    - O computador do cliente não está unido ao domínio (por exemplo, se for um computador pessoal usado no ambiente de trabalho).
    - O usuário entrou no computador com uma conta local (não-domínio).
    - O computador é um Mac que não está usando o Active Directory como servidor de conta de rede.
- **Confirme a versão e as configurações do navegador**—para o logon no navegador da Web, certifique-se de que o navegador é compatível com o Kerberos e, se necessário, se está configurado corretamente.
    
    - O Internet Explorer (IE) e o Chrome funcionam "sem precisar de uma configuração adicional" no Windows.
    - O Safari funciona "sem precisar de uma configuração adicional" no Mac.
    - É necessária uma configuração adicional para o uso do Firefox.
    
    Para obter mais informações, consulte [Suporte do cliente Tableau para o SSO do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_browser.htm).

### Solução de problemas de erros de logon no servidor

Se você não puder resolver o problema do computador cliente, suas próximas etapas serão solucionar o problema no computador que está executando o Tableau Server. O administrador pode usar a ID de solicitação para localizar a tentativa de logon nos logs do Apache no Tableau Server.

- **Arquivos de log**—Verifique se o error.log do Apache apresenta um erro com a data e hora exatos da falha na tentativa de login.
    
    - Em um arquivo ziplog, estes logs estarão na pasta \\httpd.
    - No Tableau Server, esses logs estarão na pasta \\data\\tabsvc\\logs\\httpd\\.
- **Entrada da tabela principal** – Se a entrada error.log exibir a mensagem "Não há entrada de tabela principal correspondente a HTTP/<servername>.<domain>.<org>@”, por exemplo:
    
    `[Fri Oct 24 10:58:46.087683 2014] [:error] [pid 2104:tid 4776] [client 10.10.1.62:56789] gss_acquire_cred() failed: Unspecified GSS failure. Minor code may provide more information (, No key table entry found matching HTTP/servername.domain.com@)`
    
    Esse erro é o resultado de uma incompatibilidade entre quaisquer dos seguintes:
    
    - **URL do Tableau Server** - A URL usada pelo computador cliente para acessar o servidor.
        
        Este é o nome a ser inserido no Tableau Desktop ou na barra de endereço do navegador. Pode ser um shortname (`http://servername`) ou um nome de domínio totalmente qualificado (`http://servername.domain.com`)
        
        ![Exemplo de um nome de servidor do Tableau conforme exibido na barra de endereços de um navegador da Internet.](/tableau/current/pt-br/server/pt-br/Img/kerb_servername_1.png) ![Exemplo de um nome de servidor do Tableau conforme exibido na caixa de diálogo de logon do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/kerb_servername_2.png)
    - **Pesquisa de DNS reverso** para o endereço IP servidor.
        
        Esta função procura por um nome DNS usando um endereço IP.
        
        No prompt de comando, digite:
        
        `ping servername`
        
        com o endereço IP que foi retornado ao fazer o ping no servidor, faça um tipo de pesquisa de DNS reverso:
        
        `nslookup <ip address>`
        
        O comando nslookup retornará informações de rede do endereço IP. Na porção _Resposta não autoritativa_ da resposta, verifique se o nome de domínio totalmente qualificado (FQDN) corresponde aos valores configurados a seguir: 
        
        - O arquivo .keytab do Kerberos
        - Service Principal Name (SPN) para o servidor
        
        Para obter mais informações sobre a configuração desses valores, consulte [Saiba mais sobre os requisitos do Keytab.](https://help.tableau.com/current/server/pt-br/kerberos_keytab.htm).

### Verificar script de configuração do Kerberos

Talvez seja necessário modificar o comando ktpass usado para gerar o arquivo keytab para variáveis de ambiente. Revise as etapas de solução de problemas no artigo da Base de dados de conhecimento, [Não é possível gerar o script de configuração do Kerberos para o Tableau Server](https://kb.tableau.com/articles/issue/unable-to-generate-kerberos-script-configuration-for-tableau-server?lang=pt-br).

## Logon único da fonte de dados:

### Falhas de acesso à fonte de dados delegada

Verifique os arquivos de registro vizqlserver para "workgroup-auth-mode":

- Em um arquivo ziplog, estes logs estarão na pasta \\vizqlserver\\Logs
- No Tableau Server, esses logs estarão na pasta \\data\\tabsvc\\vizqlserver\\Logs

Procure "workgroup-auth-mode" nos arquivos log. Será exibida a mensagem "o kerberos-impersonate" não está "como tal".

### Configuração de vários domínios da delegação do Kerberos

O Tableau Server tem a capacidade de delegar usuários de outros domínios do Active Directory. Se o seu banco de dados usa o MIT Kerberos, é necessário ajustar o seu principal do Kerberos para o mapeamento de usuário de banco de dados. Especificamente, será necessário atualizar krb5.conf com regras para cada escopo do Kerberos dos quais os usuários irão se conectar. Use a marca `auth_to_local` na seção `[realms]` para mapear os nomes principais aos nomes de usuário local.

Por exemplo, considere um usuário, `EXAMPLE\jsmith`, cujo Principal do Kerberos é `jsmith@EXAMPLE.LAN`. Neste caso, o Tableau Server especificará um usuário delegado, `jsmith@EXAMPLE`. O Tableau Server usará o alias de domínio herdado do Active Directory como Escopo do Kerberos.

O banco de dados de destino podem já ter uma regra, como a seguinte, para mapear o usuário, `jsmith@EXAMPLE.LAN`, ao usuário do banco de dados, `jsmith`.

`EXAMPLE.LAN = {      RULE:[1:$1@$0](https://help.tableau.com/current/server/pt-br/.*@EXAMPLE.LAN)s/@.*//      DEFAULT   }`

Para suportar a delegação, é necessário adicionar outra regra para mapear o jsmith@EXAMPLE para uma fonte de dados do usuário:

`EXAMPLE.LAN = {      RULE:[1:$1@$0](https://help.tableau.com/current/server/pt-br/.*@EXAMPLE.LAN)s/@.*//      RULE:[1:$1@$0](https://help.tableau.com/current/server/pt-br/.*@EXAMPLE)s/@.*//      DEFAULT   }`

Consulte o tópico de Documentação do MIT Kerberos, [krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html), para obter mais informações.

### Delegação restrita em domínios cruzados

Em alguns cenários com domínios cruzados, onde o KDC executa em um servidor Windows anterior ao Windows 2012, a delegação pode falhar. Erros que podem ocorrer:

- Interfaces de rede do SQL Server: o sistema não consegue entrar em contato com um controlador de domínio para enviar a solicitação de autenticação. Tente novamente mais tarde.
- Cliente nativo do SQL Server: não foi possível gerar o contexto SSPI.
- O controlador de domínio retorna: `KRB-ERR-POLICY error with a status STATUS_CROSSREALM_DELEGATION_FAILURE (0xc000040b)`.

Domínios cruzados refere-se a um cenário em que o Tableau Server é executado em um domínio diferente da fonte de dados com contas de serviço diferentes. Por exemplo:

- O Tableau Server executa no DomínioA na conta de serviço do DomínioA.
- O SQL Server executa no DomínioB na conta de serviço do DomínioB.

A delegação limitada tradicional só funciona se os dois servidores estão no mesmo domínio. O usuário pode vir de outros domínios.

Se os erros apontados acima ocorrem, então, para habilitar esse cenário, o administrador do Active Directory deve remover qualquer delegação limitada tradicional que esteja configurada na conta de delegação. É possível remover delegações com as ferramentas de gerenciamento do Active Directory ou ao remover os valores associados à propriedade do Active Directory, `msDS-AllowedToDelegateTo.`

Se desejar preservar uma delegação existente em domínio simples com a delegação em domínios cruzados, configure as duas pelo uso de uma delegação limitada com base em recursos.

Para obter mais informações sobre o Kerberos e a delegação restrita, consulte o tópico da Microsoft [Visão geral da delegação restrita do Kerberos](https://docs.microsoft.com/pt-br/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/jj553400\(v=ws.11\)).

### Criação na Web

Há dois cenários de criação na Web que não são compatíveis com a delegação do Kerberos: "Conectar a dados na Web" e "Criar fontes de dados na Web". O recurso ainda não é compatível com a delegação. Especificamente, se você criar uma fonte de dados que usa Kerberos na criação na Web, a fonte de dados usará a autenticação da conta de serviço Run As. Se quiser usar a delegação do Kerberos para criar uma fonte de dados, você deve publicar com o Tableau Desktop. Para obter mais informações sobre a conta de serviço Run As, consulte [Acesso aos dados com a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_access.htm).

<!-- document id=e4c421da18e322ac0c9be4d10653883fa461dfb83df626fafe4a46f67a452b2f url=/tableau/current/pt-br/server/openid_auth_troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas do OpenID Connect

Use os tópicos a seguir para solucionar problemas do OpenID Connect (OIDC) no Tableau Server.

O protocolo OIDC é aceito por muitos provedores de identidade. O protocolo OIDC é um padrão aberto e flexível. Por isso, nem todas as implementações do padrão são idênticas. A maioria dos problemas que os administradores encontram durante a configuração do Tableau Server para OIDC está relacionada à implementação do OIDC por diferentes provedores de identidade. Se você encontrar erros enquanto configurar o OIDC com o Tableau Server, é recomendável que trabalhe junto ao seu IdP para solucioná-los.

## Ativação do registro de OpenID aprimorado

Para solucionar problemas do OpenID Connect com eficiência no Tableau Server, habilite o registro aprimorado definindo o nível de registro para depuração e o registro completo para OpenID usando a chave de configuração `vizportal.openid.full_server_request_logging_enabled` para `true` usando estes comandos do TSM:

`tsm configuration set -k vizportal.log.level -v debug`

`tsm configuration set -k vizportal.openid.full_server_request_logging_enabled -v true`

`tsm pending-changes apply`

Após concluir a solução de problemas, recomendamos definir os valores de ambas as chaves de configuração de volta aos padrões para limitar as informações coletadas nos registros e reduzir os tamanhos dos arquivos de registro. Para obter detalhes sobre como redefinir as chaves de configuração para os padrões, consulte [Redefinir uma chave de configuração para o padrão](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#Reset2Default).

**Observação:** registro aprimorado para [grupos de identidade](https://help.tableau.com/current/server/pt-br/identity_pools.htm) não são aceito. No entanto, o registro `vizportal.log.level debug` é aceito.

## Entrar por meio da linha de comando

Mesmo que o Tableau Server esteja configurado para usar o OIDC, ele não será usado caso o Tableau Server seja acessado por meio do [tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm), da [API REST](https://help.tableau.com/current/api/rest_api/pt-br/help.htm) ou do [Utilitário de linha de comando da extração de dados do Tableau](https://help.tableau.com/current/pro/online/pt-br/help.htm) (fornecido com o Tableau Desktop).

## Falha no logon

O logon pode falhar mostrando a seguinte mensagem:

`Login failure: Identity Provider authentication unsuccessful for user <username from IdP>. Failed to find the user in Tableau Cloud.`

Esse erro normalmente significa que há falta de correspondência entre os nomes de usuário armazenados no Tableau Server e os fornecidos pelo IdP. Para consertar isso, garanta que haja correspondência. Por exemplo, se o nome de usuário de Jane Silva estiver armazenado no IdP como `js` ele também deverá ser armazenado no Tableau Server como `js`.

## Erro 69: "Incapaz de fazer logon"

Um erro 69 pode ser retornado quando você tenta fazer logon no Tableau Server com um navegador da Web e recebe um erro, “Incapaz de fazer logon. Falha no logon. Entre em contato com o administrador do Tableau Server”. A URL que retorna essa mensagem é `https://example.com/#/error/signin/69?redirectPath=%2`.

Se ocorrer esse erro, verifique o provedor de IDP para verificar se o IdP está esperando`client_secret_post` em vez de `client_secret_basic` (o padrão do Tableau).

Se o IdP estiver esperando `client_secret_post`, será necessário definir o parâmetro `vizportal.openid.client_authentication` para `client_secret_post`.

Por exemplo, se você receber esse erro e tiver configurado o OIDC para o IdP do Salesforce, defina o parâmetro `vizportal.openid.client_authentication`.

Consulte as [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm) para obter mais informações.

## Log de erro do OpenID

A autenticação OpenID ocorre fora do Tableau Server, assim, resolver os problemas de autenticação pode ser difícil. Entretanto, as tentativas de logon são registradas pelo Tableau Server. É possível criar um instantâneo dos arquivos de registro e usá-los para resolver problemas. Para obter mais informações, consulte [Locais de arquivo de registro e registros do Tableau Server](https://help.tableau.com/current/server/pt-br/logs_loc.htm).

**Observação**: para registrar os eventos relacionados ao OpenID, o `vizportal.log.level` deve ser definido como `debug` por meio das [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

Verifique se há erros do OpenID nos seguintes arquivos contidos no instantâneo do arquivo de registro descompactado:

`\vizportal\vizportal-<n>.log`

## Usuário não encontrado

Um erro “usuário não encontrado” poderá ser retornado se as declarações “sub” tiverem sido alteradas após o login inicial dos usuários. Você pode verificar esse problema se vir o seguinte nos logs do vizportal: `Possible conflicting or stale account: <username> A different user already owns this account`.

Se esse problema continuar, redefina as declarações “sub” desse usuário ou de todos os usuários no Tableau Server. Para obter mais informações, consulte [Redefinir identificadores de usuário](https://help.tableau.com/current/server/pt-br/openid_auth_changing_idp.htm#reset_sub).

<!-- document id=262c30a9d2d7d961650d55409c7b18fb3ab3b31ebe1756ae22b9440118cbbf0a url=/tableau/current/pt-br/server/trouble_desk_license_rpts.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas do relatório de licença do Desktop

Quando instâncias do Tableau Server e do Tableau Desktop estão configuradas corretamente, as informações de utilização de licença do Tableau Desktop ficam disponíveis em duas exibições administrativas, [Uso da licença do Desktop](https://help.tableau.com/current/server/pt-br/adminview_desktop_license_usage.htm) e [Vencimento da licença do Desktop](https://help.tableau.com/current/server/pt-br/adminview_desktop_license_expiration.htm). Se você não consegue ver essas exibições, verifique os requisitos a seguir. Se você consegue ver as exibições, mas não há dados nelas, poderá solucionar o problema usando o tópico de Solução de problemas no Guia de implementação do Desktop: [solução de problemas do relatório de licenciamento](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_troubleshoot.htm#trouble). Para obter detalhes sobre como configurar o Tableau Desktop, consulte [Configurar o Tableau Desktop para relatórios de licenciamento](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_reporting_admin.htm) no guia de implantação do Tableau Desktop.

## As exibições administrativas não estão disponíveis

As exibições administrativas Relatório de licenciamento do Desktop estão disponíveis apenas para administradores do Tableau Server. Caso não veja links para as exibições Utilização de licença do Desktop e Expiração de licença do Desktop na página Status do servidor (selecione Gerenciar todos os sites no menu sites), verifique o seguinte:

- Você está conectado como um administrador do Tableau Server.
- Se estiver executando uma versão do Tableau Server 10.0 ou posterior e os usuários estiverem executando o Tableau Desktop versão 10.0 ou posterior. O Relatório de licenciamento do Desktop está disponível a partir da versão 10.0 do Tableau Server e do Tableau Desktop.
- O Relatório de licença do Desktop do Tableau Server está habilitado. (O recurso está desabilitado por padrão.) Para obter mais informações, consulte [Habilitar e configurar relatórios de licenciamento do Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_reporting_admin.htm#enable).

<!-- document id=506799ee2588800c9c4ce1629bfb3cfc491c6cef3bbaef96e6c5ae414196768f url=/tableau/current/pt-br/server/rmt-faq.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas do Resource Monitoring Tool do Tableau

Esta seção inclui artigos que descrevem etapas e dicas de solução de problemas. Se você tiver alguma dúvida ou encontrar outros problemas não descritos aqui, entre em contato com o [Suporte ao cliente do Tableau](https://www.tableau.com/pt-br/support).

## Outros artigos nesta seção

<!-- document id=6308f0402cfb2bb93fde50f503b4222d7bc6f4c5fcd4c95cd3d2200870b7f5e9 url=/tableau/current/pt-br/server/saml_trouble.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas do SAML

Este tópico oferece informações sobre solucionar problemas que podem ocorrer quando você configura a autenticação SAML.

## SAML e habilitar logon automático

Caso você esteja usando SAML e o Tableau Server também esteja configurado para usar o Active Directory, não selecione também Habilitar logon automático. Habilitar logon automático e SAML não podem ser usados na mesma instalação do servidor.

## Erro HTTP Status 500 ao configurar o SAML

Em alguns casos, pode ocorrer um erro HTTP de status 500, bem como o seguinte erro após habilitar SAML e navegar para a URL do Tableau Server em um navegador:

`org.opensaml.saml2.metadata.provider.MetadataProviderException: User specified binding is not supported by the Identity Provider using profile urn:oasis:names:tc:SAML:2.0:profiles:SSO:browser`

Para ajudar a solucionar este erro, certifique-se de:

- A URL do IdP para o perfil SSO especificado na guia SAML está correta.
- A URL do IdP para o perfil do SSO fornecido durante a criação do provedor de serviços no IdP está correta.
- O IdP é configurado para usar as solicitações `HTTP-POST`\]. (Redirecionamento e SOAP não compatíveis.)

Se qualquer uma dessas configurações não estiver correta, faça as atualizações apropriadas e execute as etapas de configuração do SAML novamente, iniciando com a geração e exportação do documento de metadados de XML do Tableau Server.

Se essas configurações estiverem corretas, mas você ainda precisa ver o erro, examine o XML de metadados produzido pelo Tableau Server e pelo IdP, conforme descrito em [Requisitos do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm).

## Entrar por meio da linha de comando

O SAML não é usado para autenticação quando você entra no Tableau Server usando [tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm) ou o [utilitário de linha de comando da Extração de dados do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/extracting_TDE.htm) (fornecido com o Tableau Desktop), mesmo se o Tableau Server estiver configurado para usar o SAML. Essas ferramentas exigem a autenticação configurada quando o Tableau Server foi originalmente instalado (autenticação local ou AD).

## Falha no logon: falha ao localizar o usuário

O logon falha mostrando a seguinte mensagem:

`>Login failure: Identity Provider authentication successful for user <username from IdP>. Failed to find the user in Tableau Server.`

Esse erro normalmente significa que há falta de correspondência entre os nomes de usuário listados no Tableau Server e os fornecidos pelo IdP. Para consertar isso, garanta que haja correspondência. Por exemplo, se o nome de usuário de Jane Silva estiver armazenado no IdP como `js`, ele deverá ser armazenado no Tableau Server como `js`.

## Falha de logon: descarregamento de SSL

O logon falha mostrando a seguinte mensagem:

`Unable to Sign In - Invalid username or password.`

Além disso, os registros vizportal (definidos como modo `debug`) contêm a seguinte mensagem:

`DEBUG com.tableau.core.util.RemoteIP - Found header null in X-FORWARDED-PROTO`

**Observação:** no SAML e posterior, para registrar eventos relacionados a , ambos `vizportal.log.level` e .vizportal.log.level devem estar definidos para `debug`. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

Essa combinação de mensagens indica uma configuração incorreta de um servidor proxy externo que é SSL de descarregamento para a conexão com o Tableau Server. Para resolver esse problema, consulte [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm)

## Log de erros do SAML

A autenticação SAML ocorre fora do Tableau Server, assim, resolver os problemas de autenticação pode ser difícil. Entretanto, tentativas de logon são registradas pelo Tableau Server. É possível criar um instantâneo dos arquivos de registro e usá-los para resolver problemas. Para obter mais informações, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).

**Observação:** no SAML e posterior, para registrar eventos relacionados a , ambos `vizportal.log.level` e .vizportal.log.level devem estar definidos para `debug`. Para obter mais informações, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

Verificar se há erros de SAML nos seguintes arquivos no instantâneo do arquivo de registro descompactado:

`\vizportal\vizportal-<n>.log`

O processo do aplicativo (vizportal.exe) é responsável pela autenticação; portanto, as respostas do SAML são registradas por esse processo.

## Barra

Na guia SAML, confirme se a URL de retorno do Tableau Server não termina com uma barra

Correto: **http://tableau\_server**

Incorreto: http://tableau\_server/

## Confirmar conectividade

Confirme se o Tableau Server configurado tem um endereço de IP roteável ou um NAT no firewall que permite tráfego bidirecional diretamente ao servidor.

Você pode testar sua conectividade executando telnet no Tableau Server e tentando conectar com o IdP de SAML. Por exemplo: `C:\telnet 12.360.325.10 80`

O teste acima deve conectá-lo à porta HTTP (80) no IdP e você deve receber um cabeçalho HTTP.

## Múltiplos domínios

Na guia SAML, confirme se o atributo Domínio do Tableau Server detectará o domínio no`domain\username` format na declaração SAML deixando-a em branco.

Correto:<empty>

Incorreto: seudominio.com

<!-- document id=6e0f477963d5d6d8f9cc726710832b59407c3d39c2acbcd4013c5d9244a0acc8 url=/tableau/current/pt-br/server/ts_alibaba_troubleshooting.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas do Tableau Server na Alibaba Cloud

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Se você estiver tendo problemas com o Tableau Server na sua instância do Elastic Compute Service (ECS) da Alibaba Cloud do Microsoft Azure ou para acessar o Tableau Server depois da instalação, leia essas dicas de solução de problemas.

- **Não é possível se conectar à instância usando o RDP**
    
    Um ou mais dos seguintes problemas podem impedir que você se conecte à instância usando o RDP:
    
    - Verifique se está usando as credenciais corretas.
    - Selecione a opção **Outro usuário** e insira suas credenciais.
    - Certifique-se de que está usando um nome de usuário válido na instância da instância. Por exemplo, se você criou a instância com uma conta de administrador de **myuser**, insira **.\\myuser** como o nome de usuário na caixa de diálogo RDP.
- **Não é possível acessar o servidor em um navegador remoto**
    
    Um ou mais dos seguintes problemas podem impedir que você acesse o servidor em um navegador remoto:
    
    - Faça logon na instância e verifique se o servidor está em execução.
    - Na instância, abra um navegador e acesse o servidor localmente (por exemplo, usando http://localhost ou http://localhost:port, em que a porta é o número de porta o qual o servidor foi configurado a escutar).
    - No console do Elastic Compute Service (ECS) da Alibaba Cloud, certifique-se de que configurou um endpoint para permitir tráfego HTTP para a instância.
        
        **Observação:** não é possível usar o utilitário de ping do Windows para testar a conectividade com a instância. O utilitário de ping sempre relatará um tempo limite quando usado na internet pública.
- **Você recebe a seguinte mensagem de erro: o Tableau Server não está licenciado**
    
    Esse erro poderá ocorrer se você tiver desligado instâncias sem primeiro desativar a licença. Entre em contato com o [Suporte do Tableau](http://www.tableau.com/pt-br/support/request).
- **O Tableau Server não usa todos os núcleos da CPU**
    
    Um ou mais dos sintomas a seguir podem ocorrer ao trabalhar com a licença com base em núcleos do Tableau Server:
    
    - Ao instalar o Tableau Server, o instalador pode mostrar menos núcleos do que o esperado para o computador que o executa.
    - Na página Licenças do Tableau Server, o número de núcleos listados em Licenças em uso é menor do que o esperado.
    - Ao executar `tsm licenses list`, o Tableau Server pode informar um número menor de núcleos em uso do que o esperado.
    
    Para obter mais informações, consulte [Alguns núcleos não são reconhecidos pelo Tableau Server](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=pt-br).

<!-- document id=2564b2cbd147331259a53ea6feed7f9d8575779cf8a7c17436aeef32c2c653b1 url=/tableau/current/pt-br/server/runas_troubleshoot.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas do Usuário Run As

Conforme discutido no tópico [Conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas.htm), o Tableau Server precisa de acesso administrativo ao computador no qual ele está instalado. Portanto, quando você atualiza a conta de serviço Run, um processo em segundo plano configurará as permissões no computador do Tableau para a conta. No entanto, em alguns cenários de implantação completa, pode ser necessário verificar ou configurar manualmente as permissões de conta de serviço Run As no computador local do Tableau Server. Use essa seção para verificar como as permissões são configuradas nas máquinas que executam o Tableau Server em sua implantação. Esta seção também inclui procedimentos que descrevem como definir permissões e configurar políticas de segurança para a conta de serviço Run As.

## Outros artigos nesta seção

<!-- document id=d93505ecd4526ea76253392ed572e8574434d551f6578f383332c8797fe4d5ba url=/tableau/current/pt-br/server/service_status_troubleshoot.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas dos processos do servidor

**Observação**: as informações neste artigo se referem ao status da página do Tableau Server. Para obter informações sobre o status da página do Tableau Server e do TSM, consulte [Exibir o status de processos do servidor](https://help.tableau.com/current/server/pt-br/service_viewstatus.htm).

Quando o Tableau Server esiver funcionando corretamente, os processos serão mostrados como Ativo, Ocupado ou Passivo (Repositório). Se houver informações adicionais, uma mensagem irá aparecer sob o ícone de status:

![O arquivo está pronto para remoção.](/tableau/current/pt-br/server/pt-br/Img/status_filestore_ready.png)

Possíveis indicadores de status são:

![Seis marcadores de status diferentes: ativo, ocupado, passivo, sem licença, inativo e status indisponível.](/tableau/current/pt-br/server/pt-br/Img/status2.png)

Se você estiver vendo várias mensagens ![Ícone Status inativo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_down.png)**Status: desativado**, verifique se a senha da conta de serviço Run As não expirou. Se a senha tiver expirado, você deve atualizá-la no Tableau Server, consulte [Atualização da senha da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm#Updating). Alterações de permissão relacionadas à conta de serviço Run As também podem causar várias falhas de serviço, consulte [Verificar permissões de pasta](https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm).

**Observação:** o Tableau Server foi projetado para ser autocorretivo. Se um serviço ou processo parar de responder ou falhar, o Tableau Server tentará reiniciá-lo. Isso pode levar de 15 a 30 minutos para ser concluído. Por isso, reagir imediatamente a alertas de serviço ou processo pode ser contraproducente, especialmente em uma instalação com serviços redundantes que podem lidar com solicitações durante a reinicialização.

As seções a seguir fornecem recomendações sobre a solução de problemas para mensagens de status que podem ser visualizadas.

## Controlador do cluster

Esta mensagem só será exibida se você tiver mais de dois nós.

![Ícone Status inativo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_down.png) **Status: inativo**; **Mensagem: "Nó danificado"**

Um ou mais dos seguintes é verdadeiro:

- O repositório do nó foi interrompido.
- O nó não pode responder a failover em outro lugar do cluster.
- Se o Tableau Server estiver configurado para alta disponibilidade e este for o repositório ativo, o failover ao repositório secundário é feito.
- Não há status disponível para o repositório ou armazenamento de arquivo neste nó.

Não é necessária nenhuma ação, a menos que o controlador de cluster esteja frequentemente fora do ar, ou esteja fora do ar por um longo período de tempo.

Caso ocorra, realize as seguintes ações, em ordem, até que o problema seja resolvido:

1. Verifique o espaço em disco. Se houver pouco espaço em disco, salve os arquivos de registro (use [`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)) caso precise deles para o Suporte, e então remova os arquivos desnecessários.
2. Reinicie o Tableau Server.
3. Se o controle de cluster continuar fora do ar, salve os arquivos de registro ([`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)) e entre em contato com o Suporte.

## Armazenamento de arquivo

O status de Armazenamento de arquivo reflete somente o estado do armazenamento de arquivo quando a página foi carregada.

Um status ativo (![Ícone Sucesso ativo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_active.png)) sem mensagens indica que nenhuma extração estava sendo sincronizada quando a página foi carregada. É possível que o trabalho atual "catch-all" esteja em execução, sincronizando as extrações.

![Ícone Status ocupado.](/tableau/current/pt-br/server/pt-br/Img/icon_status_busy.png) **Status: ocupado**; **Mensagem: "Sincronizando"**

"Sincronizando" normalmente indica que as extrações estavam sendo sincronizadas entre nós de Armazenamento de arquivo quando a página foi carregada.

No entanto, a mensagem "sincronizando" também é retornada após a instalação (em um nó único nó e em vários nós). Depois da inicialização do Tableau , o status deve desaparecer dentro de 15 ou 20 minutos.

![Ícone Status inativo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_down.png) **Status: inativo**; **"Extrações de dados não disponíveis"**

Em uma instalação de nó único: "Extrações de dados não disponíveis" indica que extrações existentes podem estar disponíveis, mas haverá uma falha ao publicar/atualizar. Em instalações de vários nós, esta mensagem indica que a sincronização de extração não será bem sucedida neste nó.

Não é necessária nenhuma ação, a menos que o Armazenamento de arquivo esteja frequentemente fora do ar, ou esteja fora do ar por um longo período de tempo.

Caso ocorra, realize as seguintes ações, em ordem, até que o problema seja resolvido:

1. Verifique o espaço em disco. Se houver pouco espaço em disco, salve os arquivos de registro (use [`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)) caso precise deles para o Suporte, e então remova os arquivos desnecessários.
2. Reinicie o Tableau Server.
3. Se o Armazenamento de arquivo continuar inativo, salve os arquivos de registro ([`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)) e entre em contato com o Suporte.

![Ícone Status ocupado.](/tableau/current/pt-br/server/pt-br/Img/icon_status_busy.png) **Status: ocupado**; **"Descomissionando"**

Esta mensagem indica que este armazenamento de arquivo está no modo somente leitura e que quaisquer arquivos únicos neste nó serão replicados em outros nós de Armazenamento de arquivo.

Para remover este nó, espere até que a mensagem mude para "Pronto para remoção".

![Ícone Sucesso ativo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_active.png) **Status: ativo**; **"Pronto para remoção"**

Essa mensagem indica que o Armazenamento de arquivo está no modo somente leitura.

É possível interromper com segurança o cluster ([`tsm stop`](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm#stop)) e remover os processos de armazenamento de arquivos, ou remover o nó inteiro.

![Ícone Sucesso ativo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_active.png) **Status: ativo**; **"Falha no descomissionamento"**

Essa mensagem indica que o Armazenamento de arquivo está no modo somente leitura, e que ocorreu pelo menos uma falha de arquivo único ao replicar para outro nó de Armazenamento de arquivo.

Para resolver uma falha no descomissionamento:

1. Execute o comando [`tsm topology filestore decommission`](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMDecommission) novamente.
2. Verifique o espaço no disco em outros nós de Armazenamento de arquivo. Haverá uma falha no descomissionamento se outro nó de Armazenamento de arquivo não tiver espaço suficiente para armazenar todas as extrações.
3. Verifique o arquivo `tsm.log` no nó inicial e nos adicionais para encontrar possíveis erros.
4. Interrompa o Tableau Server ([`tsm stop`](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm#stop)) e tente executar o comando [`tsm topology filestore decommission`](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMDecommission) novamente.
5. Coloque o nó de Armazenamento de arquivo de volta no modo de leitura/gravação ([`tsm topology filestore recommission`](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#topology-recommission)), salve os registros e entre em contato com o Suporte.
6. Com o Suporte: copie e mescle o diretório `extracts` deste nó de Armazenamento de arquivo com o mesmo diretório em outro nó de Armazenamento de arquivo.

## Index and Search Server

![Ícone Status passivo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_passive.png)**Status: passivo**; **Mensagem: n/a**

Em ambientes com vários nós, um status passivo indica que o nó está funcionando conforme o esperado, mas não pode ingressar no cluster e receber tráfego.

Para obter o processo do Index and Search Server para o status ativo:

1. Use o comando [tsm topology set-process](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess) para remover os processos passivos do Index e do Search Server dos nós.
    
    tsm topology set-process -n <Node> -pr indexandsearchserver -c 0
2. Aplique as alterações ([tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply)).
3. Reinicie o Tableau Server ([tsm restart](https://help.tableau.com/current/server/pt-br/cli_restart_tsm.htm#restart)).
4. Use o comando [tsm topology set-process](https://help.tableau.com/current/server/pt-br/cli_topology_tsm.htm#TSMSetProcess) para incluir o processo Index and Search Server em nós um por vez.
    
    tsm topology set-process -n <Node> -pr indexandsearchserver -c 1
5. Aplique as alterações ([tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply) --ignore-warnings).
6. Reinicie o Tableau Server ([tsm restart](https://help.tableau.com/current/server/pt-br/cli_restart_tsm.htm#restart)).
7. Use o comando [tsm status](https://help.tableau.com/current/server/pt-br/cli_status_tsm.htm) para verificar o status de `indexandsearchserver` nos nós afetados.

## Repositório

![Ícone Status ocupado.](/tableau/current/pt-br/server/pt-br/Img/icon_status_busy.png)**Status: ocupado**; **Mensagem: "Configurando"**

O usuário "Configurando" indica um ou mais dos seguintes estados:

- O repositório passivo está sendo sincronizado com o repositório ativo.
- O repositório não está pronto para failover.
- O repositório pode ter levado mais de dois minutos a mais que o repositório ativo e está sendo instalado novamente (o que é mais rápido do que esperar por uma sincronização).
- Ocorreu failover e este repositório ativo anterior está reunindo-se ao cluster.

Espere até que a mensagem de status do repositório mude para "Passivo".

Se essa mensagem não aparecer, ou se demorar para aparecer:

1. Verifique o espaço no disco e o espaço livre, se possível.
2. Verifique os registros do controle de cluster por erros.
3. Reinicie o nó.

![Ícone Status ocupado.](/tableau/current/pt-br/server/pt-br/Img/icon_status_busy.png)**Status: ocupado**; **Mensagem: "Sincronizando"**

O repositório está sincronizando, por exemplo, depois de um failover.

![Ícone Status inativo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_down.png)**Status: inativo**; **Mensagem: n/a**

Quando o repositório mostra um status de inativo e não há nenhuma mensagem, então, ele estará em um dos seguintes estados:

- Se a instalação estiver configurada para alta disponibilidade, ocorreu failover do repositório.
- Processos estão reiniciando com configurações de conexão de base de dados atualizadas após o failover.
- Se outro repositório ativo não estiver disponível, o Tableau Server está fora do ar.

Realize estas ações nesta ordem até que uma etapa resolva o problema:

1. Espere alguns minutos até que o controle de cluster reinicie.
2. Reinicie o Tableau Server.([`tsm restart`](https://help.tableau.com/current/server/pt-br/cli_restart_tsm.htm#restart)).
3. Verifique o espaço em disco. Se houver pouco espaço em disco, salve os arquivos de registro (use [`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)) caso precise deles para o Suporte, e então remova os arquivos desnecessários.
4. Reinicie o Tableau Server.
5. Se o repositório continuar inacessível, salve os arquivos de registro ([`tsm maintenance ziplogs`](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)) e entre em contato com o Suporte.

![Ícone Status passivo.](/tableau/current/pt-br/server/pt-br/Img/icon_status_passive.png)**Status: passivo**; **Mensagem: n/a**

Um status passivo sem mensagem indica que o nó está funcionando como planejado e que está pronto para failover, se necessário.

## VizQL Server

![Ícone Status sem licença.](/tableau/current/pt-br/server/pt-br/Img/icon_status_unlicensed.png)**Status: sem licença**; **Mensagem: n/a**

Para obter informações sobre o status não licenciado de um processo do VizQL Server, consulte [Manipular um processo do Server não licenciado](https://help.tableau.com/current/server/pt-br/trouble_svc_unlicensed.htm).

<!-- document id=40fee6f4ac29c361a71359ed298d8c9fb14845f6cbaecb285a9377d33f0ad2eb url=/tableau/current/pt-br/server/rmt-troubleshoot-web-interface-timeout.md -->

[Pular para o conteúdo principal](#main-content)

# Solucionar problemas nos tempos limites da interface na Web

Quando você tenta navegar na interface na Web do Resource Monitoring Tool do Tableau, você vê o seguinte erro:

![Mensagem de erro mostrando que algo deu errado.](/tableau/current/pt-br/server/pt-br/Img/rmt-web-interface-timeout.png)

Isso pode acontecer quando o tempo de carregamento demora mais do que o limite padrão de 30 segundos. O tempo de carregamento pode ser afetado pelo seguinte:

- O tamanho do banco de dados PostgreSQL subjacente.
- Se a RMT estiver conectada a ambientes do Tableau Server que pressionam a escala atual que a RMT aceita, isso também poderá ter um efeito nos tempos de carregamento.
- Conflito de portas. Certifique-se de que a porta que o Resource Monitoring Tool está usando não esteja em conflito com as portas que o Tableau Server está usando.

Para solucionar esse problema, altere o período de retenção de dados ou o limite para mais de 30 segundos.

**Para alterar o período de retenção de dados, siga as etapas a seguir:**

1. Navegue até a interface do usuário de configuração, conforme descrito [neste tópico](https://help.tableau.com/current/server/pt-br/rmt-config-configGui.htm).
2. Navegue até a guia Dados.
    
    Há dois tipos de Configurações de dados:
    
    - Retenção de dados definida como 2 semanas por padrão. Inclui dados de atividade detalhados e os dados exibidos nos gráficos.
    - Relatório de dados definidos para o período de 10 anos, por padrão. Inclui dados históricos agregados e dados usados em relatórios de chargeback.
3. O Tableau recomenda alterar o período de retenção de dados para 1 semana.

Para alterar o limite de tempo, sigas as etapas a seguir:

1. Faça logon na máquina onde o Servidor RMT do está instalado.
2. Encontre o arquivo de configuração “mestre”. O arquivo, quando instalado no local padrão, pode ser encontrado em:
    
    `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config\config.json`
3. Adicione ou altere a chave: **db:timeoutSeconds**

Se precisar reduzir imediatamente o tamanho do banco de dados PostgreSQL, use o utilitário da linha de comando rmtadmin para excluir os dados. Para obter mais informações, consulte [Utilitário de linha de comando rmtadmin](https://help.tableau.com/current/server/pt-br/rmt-admin-cmdline.htm##heading--delete-env-data).

## Quem pode fazer isso

Você precisa ser um Administrador na máquina e um Administrador do Resource Monitoring Tool para fazer alterações de configuração e banco de dados.

<!-- document id=c9d736a94448b4123bde420ce8f5312891dc358003cb9e02816eed489f0756ef url=/tableau/current/pt-br/server/ssl.md -->

[Pular para o conteúdo principal](#main-content)

# SSL

A SSL (Secure Sockets Layer) é uma tecnologia de segurança padrão que estabelece um link criptografado entre um servidor Web e os clientes. Para usar a SSL, você precisará instalar um certificado SSL no Tableau Server.

**Importante:** a partir da versão 2025.2 (Tableau Desktop), 2025.3 (Tableau Server) e de junho de 2025 (Tableau Cloud), o Tableau usa OpenSSL 3.4.x e segurança de nível 2. A segurança de nível 2 requer chaves de 2048 bits ou mais. Todas as chaves de segurança de nível 1 existentes não funcionarão mais e você precisará gerar e implantar um novo par de chaves. Se você estiver gerando chaves com pelo menos 2048 bits, conforme recomendado, nenhuma ação será necessária. Para obter mais informações, consulte [Gerar uma chave](https://help.tableau.com/current/server/pt-br/ssl_cert_create.htm#generate-key).

Você pode configurar o Tableau Server para usar SSL das seguintes maneiras:

- Use SSL para tráfego HTTP externo.
- Use SSL mútuo (de mão dupla) entre clientes (Tableau Desktop, navegadores da Web e tabcmd.exe) e o Tableau Server.
- Use SSL para todo o tráfego de HTTP entre componentes de servidor internos e o repositório.

Se você estiver usando o SSL mútuo, cada cliente também precisará de um certificado.

**Observação:** o Tableau Server usa o SSL para autenticação de usuário. O SSL não é usado para identificar permissões e autorização para conteúdo (fontes de dados e pastas de trabalho) hospedado no Tableau Server.

## Outros artigos nesta seção

<!-- document id=30add58d860246cd9cda167c586d9830a528e6f0e4521fd56c0de698c0d5fea9 url=/tableau/current/pt-br/server/kerberos_browser.md -->

[Pular para o conteúdo principal](#main-content)

# Suporte do cliente Tableau para o SSO do Kerberos

Este artigo descreve alguns requisitos e nuances ao usar o logon único (SSO) do Kerberos no Tableau Server, dependendo do cliente do Tableau e do sistema operacional. Os clientes do Tableau tratados neste artigo incluem navegadores de Web usuais, o Tableau Desktop e o aplicativo do Tableau Mobile.

## Suporte geral para cliente do navegador

Para usar o logon único (SSO) do Kerberos baseado em navegador, o seguinte deve ser verdadeiro:

- O Kerberos deve estar habilitado no Tableau Server.
- O usuário deve ter um nome de usuário e senha para entrar no Tableau Server.
    
    **Observação:** quando o SSO do Kerberos falha, os usuários podem recorrer às credenciais de nome de usuário e senha, se um substituto for configurado.
- O usuário deve ser autenticado no Active Directory com o Kerberos no computador ou dispositivo móvel do cliente. Especificamente, isso significa que ele tem um Ticket Granting Ticket (TGT) do Kerberos.

## Tableau Desktop e clientes de navegadores

No Windows ou no Mac, você pode usar o Kerberos SSO para entrar no Tableau Server a partir das versões a seguir do Tableau Desktop ou do navegador. Onde indicado, a configuração adicional é necessária.

Windows

- Tableau Desktop 10.3 ou versões posteriores compatíveis.
- Internet Explorer - compatível, pode necessitar de configuração, veja a [Observação 1](#note1).
- Chrome - compatível, pode necessitar de configuração, veja a [Observação 1](#note1).
- Firefox - requer configuração - veja a [Observação 2](#note2).
- Safari - não aceito

Mac OS X

- Tableau Desktop 10.3 ou versões posteriores
- Safari - suportado
- Chrome - veja a [Observação 3](#note3)
- Firefox - veja a [Observação 2](#note2)
- Internet Explorer - não aceito

## Cliente do aplicativo Tableau Mobile

Em um dispositivo iOS ou Andoid, utilize as seguintes versões do Tableau Mobile ou do navegador móvel para usar a autenticação Kerberos no Tableau Server:

iOS

- Aplicativo Tableau Mobile - veja a [Observação 4](#note4)
- Safari - veja a [Observação 4](#note4)
- Chrome - não aceito

Android - veja a [Observação 5](#note5)

- Aplicativo Tableau Mobile
- Chrome

## Sistema operacional e observações específicas do navegador

As observações a seguir descrevem os requisitos de configuração ou problemas com determinadas combinações de sistema operacional e cliente.

### Observação 1: Internet Explorer ou Chrome na área de trabalho do Windows

O SSO do Kerberos é compatível com Internet Explorer e Chrome mas requer a configuração nas Opções de Internet do Windows:

1. Habilite a Autenticação integrada do Windows.
2. Verifique se a URL do Tableau Server está na zona de intranet local.
    
    Certas vezes, o Internet Explorer poderá detectar zonas de intranet e configurar esta definição. Se a URL do Tableau Server não tiver sido detectada e configurada, então você precisará adicionar manualmente a URL na zona da intranet local.

Para habilitar a autenticação integrada do Windows:

1. No Painel de Controle do Windows, abra **Opções da Internet**.
2. Na guia **Avançado** role a página para baixo até a seção **Segurança**.
3. Selecione **Habilitar a autenticação integrada do Windows**.
4. Clique em **Aplicar**.

Para verificar ou adicionar a URL do Tableau Server à zona de intranet local:

1. No Painel de Controle do Windows, abra **Opções da Internet**.
2. Na guia **Segurança**, selecione **Intranet local** e, em seguida, clique em **Sites**.
3. Na caixa de diálogo **Intranet local**, clique em **Avançado**.
    
    No campo **Sites da Web**, procure pela URL local do Tableau Server.
    
    Em algumas empresas, os administradores de TI usarão um curinga (\*) para especificar as URLs internas. Por exemplo, a URL a seguir inclui todos os servidores no namespace `example.lan` interno na zona de intranet local:
    
    `https://*.example.lan`
    
    A imagem a seguir mostra uma URL específica do `https://tableau.example.lan`.
    
    ![Caixa de diálogo Intranet local para adicionar ou remover sites de uma zona.](/tableau/current/pt-br/server/pt-br/Img/kerberos_intranet_zone.png)
4. Se a URL do Tableau Server ou uma URL curinga não for especificada no campo **Sites da Web**, insira a URL do Tableau Server no campo **Adicionar este site da Web à zona**, clique em **Adicionar** e, em seguida, em **OK**.
    
    Se a URL do Tableau Server já estiver listada em Sites da Web, basta fechar a caixa de diálogo.

### Observação 2: Firefox na área de trabalho do Windows ou do Mac OS X

Use o Firefox com Kerberos SSO no Windows ou no Mac para entrar no Tableau Server. Para isso, é necessário concluir as seguintes etapas para configurar o suporte do Firefox para Kerberos:

1. No Firefox, insira `about:config` na barra de endereços.
2. Clique em **Serei cuidadoso, prometo** quando avisado sobre a alteração das configurações avançadas.
3. Insira `negotiate` na caixa Pesquisar.
    
    ![Exemplo de página de configuração do Tableau Server no Firefox.](/tableau/current/pt-br/server/pt-br/Img/kerberos_firefox.png)
4. Clique duas vezes em **network.negotiate-auth.allow-non-fqdn** para alterar isso para **true**.
5. Clique duas vezes em **network.negotiate-auth.trusted-urls** e insira o nome de domínio totalmente qualificado (FQDN) do Tableau Server. Por exemplo, `tableau.example.com`.

### Observação 3: Chrome na área de trabalho do Mac OS X

De acordo com a documentação do Chrome, o SSO do Kerberos funciona em um Mac quando você inicializa o Chrome de uma janela terminal com o comando a seguir:

`open -a "Google Chrome.app" --args --auth-server-whitelist="tableauserver.example.com"`

em que `tableauserver.example.com` é a URL para o Tableau Server no seu ambiente.

Contudo, encontramos resultados inconsistentes nos testes. Sendo assim, se quiser usar o Kerberos SSO em um Mac, recomendamos usar o Safari ou o Firefox. Para obter mais informações, consulte a seção _Autenticação integrada_ na [autenticação de HTTP](http://www.chromium.org/developers/design-documents/http-authentication) no site The Chromium Projects.

**Observação**: os usuários ainda podem usar o Chrome no Mac OS X para fazer logon no Tableau Server, mas poderão ser solicitados a inserir o nome de usuário e senha (o logon único pode não funcionar).

### Observação 4: Mobile Safari ou Tableau Mobile no iOS

O SSO do Kerberos é compatível se o iOS estiver configurado para Kerberos. O dispositivo iOS deve ter um perfil de configuração de autenticação do Kerberos instalado. Isto é geralmente feito por um grupo de TI corporativo. O suporte do Tableau não pode auxiliar com a configuração dos dispositivos iOS para Kerberos. Veja o [tópico de autenticação](https://help.tableau.com/current/mobile/mobile-admin/pt-br/admin_mobile_sso.htm#kerberos-ios-and-tableau-server-only) no _Guia de Implantação do Tableau Online_.

### Observação 5: plataforma Android

O SSO do Kerberos não é aceito no aplicativo Tableau Mobile do sistema operacional Android. Você ainda poderá usar o seu dispositivo Android e o aplicativo do Tableau Mobile ou um navegador compatível para se conectar ao Tableau Server, se o Kerberos tiver uma configuração alternativa para quando o SSO não aceitar a autenticação de nome de usuário e senha. Neste cenário, em vez de autenticar com o Kerberos, os usuários serão solicitados a inserir as credenciais ao acessar o Tableau Server.

### Mais informações

- _Guia de implantação do Tableau Mobile_: [Controle autenticação e acesso para o Tableau Mobile](https://help.tableau.com/current/mobile/mobile-admin/Pt-br/admin_mobile_sso.htm)
- Consulte _Navegadores da Web_ em [Especificações técnicas do Tableau Server](https://www.tableau.com/pt-br/products/techspecs#paragraph-id--211678)

<!-- document id=2d42daa3a4dd441e1c3c918fdc1f87cd12b7b560c9c6e0cec82cc93fd45cf786 url=/tableau/current/pt-br/server/extract_auto_suspend.md -->

[Pular para o conteúdo principal](#main-content)

# Suspender automaticamente as atualizações de extração para pastas de trabalho inativas e fontes de dados

Para economizar recursos, o Tableau pode suspender automaticamente as tarefas de atualização de extração para pastas de trabalho inativas e fontes de dados publicadas. Este recurso se aplica apenas a atualizações de extração completas e só se aplica a tarefas de atualização que são executadas com mais frequência do que semanalmente.

Não se aplica a:

- Atualizações incrementais de extração
- tarefas de atualização semanais ou menos frequentes do que semanais
- fontes de dados publicadas sendo atualizadas pelo Bridge.

Os administradores do servidor podem configurar o período em que uma pasta de trabalho ficará inativa antes que as tarefas de atualização de extração sejam suspensas. Para obter mais informações, consulte [Configurar o recurso de suspensão de atualização de extração](#Config_auto-suspend) abaixo.

**Observação:** o suporte para suspensão automática de atualizações de extração para fontes de dados está disponível a partir do Tableau Server versão 2023.3.

Para uma pasta de trabalho, se algum dos eventos a seguir ocorrer, o temporizador de contagem regressiva de inatividade da pasta de trabalho será reiniciado.

- Exibição das planilhas da pasta de trabalho
- Ter qualquer alerta ou assinatura orientada por dados na pasta de trabalho
- Download da pasta de trabalho
- Mover a localização da pasta de trabalho ou o proprietário

Para uma fonte de dados publicada, qualquer evento que busque os dados da fonte de dados fará com que seu cronômetro de contagem regressiva de inatividade seja redefinido. Esses incluem:

- Carregamento de uma exibição de pasta de trabalho conectada à fonte de dados
- Visita à página Ask Data da fonte de dados
- No Tableau Desktop, conecte-se à fonte de dados
- Na criação na Web, abrir uma pasta de trabalho que usa uma fonte de dados publicada, mesmo sem publicar a pasta de trabalho
- Execuções de fluxo do Tableau Prep (incluindo execuções agendadas do Prep Conductor) que usam uma fonte de dados como entrada de fluxo
- Um resumo de métrica do Tableau Pulse ou exibição de usuário que está usando uma fonte de dados publicada
- Atualizações “Executar agora” acionadas pelo usuário de uma fonte de dados

## Configurar o recurso de suspensão de atualização de extração

1. Entre no Tableau Server como administrador de servidor.
2. Acesse a guia Geral da página Configurações do site:
    
    - Se você tiver um único site, na parte superior da janela do navegador, clique em Configurações e Geral.
    - Se você tiver vários sites, selecione o site que deseja configurar e clique em Configurações e Geral.
3. Na página Geral, faça o seguinte:
    
    - Em Suspender automaticamente tarefas de atualização da extração,selecione a caixa de Suspender automaticamente as tarefas de atualização de extração para pastas de trabalho e fontes de dados inativas.
    - Especifique o número de dias, de 7 a 100, em que uma pasta de trabalho deve estar inativa antes que as tarefas de atualização do extração sejam suspensas. O padrão é 32 dias.
    - Clique em **Salvar**.

## Notificações

Notificações por e-mail são enviadas para o proprietário da pasta de trabalho ou fonte de dados nos seguintes momentos:

- Três dias antes da agenda de atualização da extração ser suspensa
- Quando a agenda de atualização da extração estiver suspensa

## Retomar atualizações de extração suspensas

As atualizações de extração suspensas não serão retomadas automaticamente se alguém usar a pasta de trabalho. Isso deve ser feito manualmente por um servidor ou administrador do site.

Para visualizar e retomar as atualizações de extração que foram suspensas:

1. Entre em um site como administrador e clique em **Tarefas**.
2. Clique na guia **Atualizações de extração**.
3. Selecione um ou mais itens.
4. No menu **Ações**, selecione **Retomar**.

<!-- document id=d791c22383630dc0cf32f0ea82d75124e755e35b5f1b6acd1a1130b13a13c2c0 url=/tableau/current/pt-br/server/tabcmd.md -->

[Pular para o conteúdo principal](#main-content)

# tabcmd

**Observação:** O utilitário de linha de comando tabcmd versão 2.0 está disponível em [Tabcmd do Tableau](https://tableau.github.io/tabcmd). Essa nova versão permite executar comandos tabcmd no MacOS e Linux e autenticar usando tokens de acesso pessoal (PATs). A versão 2.0 é baseada em endpoints públicos disponíveis no Tableau Server Client (TSC) baseado em Python. Essa versão mais recente tem suporte limitado ao Tableau Server.

O Tableau fornece o utilitário de linha de comando tabcmd que pode ser usado para automatizar tarefas de administração do site no seu site do Tableau Server. Por exemplo, criar ou excluir usuários, projetos e grupos.

**Observação:** nas versões do Tableau anteriores a 2024.1, o tabcmd versão 1 não funciona para exportar visualizações.

**Observação:** o utilitário tabcmd está incluído no Tableau Server e é instalado automaticamente nos nós do servidor. No entanto, seu instalador não está incluído, portanto, se você deseja executar o tabcmd em computadores que não fazem parte da instalação do Tableau Server, você precisa baixar o instalador do site do Tableau. Para obter mais informações, consulte [Instalar tabcmd](#tabcmd-install) abaixo.

## Instalar tabcmd

**Observação:** estas instruções são para instalar o utilitário de linha de comando tabcmd 1.0. Para instalar o utilitário de linha de comando tabcmd 2.0, vá para [Tableau tabcmd](https://tableau.github.io/tabcmd) (nova janela).

Ao atualizar o Tableau Server ou o Tableau Cloud para uma nova versão, se uma versão atualizada do tabcmd for exigida, é possível baixá-la da página de Versões do Tableau _Server_, no site do Tableau.

Para o Tableau Server , recomendamos que você baixe a versão que corresponde à versão do seu servidor. Para o Tableau Cloud, recomendamos que você sempre baixe a versão mais recente para evitar problemas causados por incompatibilidades de versão. Em ambos os casos, usar uma versão desatualizada do tabcmd pode causar erros e resultados imprevisíveis.

1. Abra um navegador da Web e vá para a página [Versões do Tableau Server.](https://www.tableau.com/pt-br/support/releases/server) Acesse esta página mesmo que você use o Tableau Online.
2. Se você estiver usando:
    
    - **Tableau Cloud**, use o [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd) (nova janela).
    - **O Tableau Server (Windows ou Linux):** selecione a versão que corresponde à versão do seu servidor.
    
    Em ambos os casos, se as informações expandidas mostrarem as versões de manutenção, selecione a mais recente ou a que corresponde à versão de seu servidor.
    
    ![Selecione a versão do servidor que você usa (versão mais recente do Tableau Cloud)](/tableau/current/pt-br/server/pt-br/Img/tabcmd_download1.png)
    
    Você será redirecionado à página de notas de versão, chamada Problemas resolvidos, onde poderá ler sobre as melhorias de segurança e os problemas resolvidos.
3. Nos problemas resolvidos, navegue até a seção **Baixar arquivos** e selecione o link de download do tabcmd compatível com o computador no qual você executará os comandos. 
    
    ![Selecione o instalador tabcmd para o computador em que você o usará (32 ou 64 bits)](/tableau/current/pt-br/server/pt-br/Img/tabcmd_download.png)
    
    As etapas restantes se referem a este computador como "o computador do tabcmd”.
4. Salve o instalador no computador do tabcmd ou em uma localização acessível a partir daquele computador .
5. Conclua as etapas de instalação como adequado para o sistema operacional do computador do tabcmd.
    
    - Windows
        
        Por padrão, tabcmd é instalado em `C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility`. É possível alterar isso durante a instalação e recomendar a instalação do tabcmd em uma pasta chamada `tabcmd` na raiz da unidade C:\\ (`C:\tabcmd`). Isso pode facilitar a localização e a execução e acomodará algumas limitações com o sistema operacional Windows, se você adicionar o diretório tabcmd ao Windows PATH.
        
        **Observação:** o programa de instalação do tabcmd não adiciona o diretório tabcmd à variável PATH do Windows. Você pode adicionar manualmente, ou incluir o caminho completo para tabcmd sempre que chamá-lo.
        
        É possível instalar o tabcmd de duas maneiras no Windows:
        
        - Clique duas vezes no instalador para seguir as etapas na interface do usuário:
            
            1. Aceite o contrato de licença.
            2. Se você quiser instalar em um local não padrão, clique em Personalizar e digite ou navegue até o local em que deseja instalar o tabcmd.
            3. Clique em Instalar.
                
                Se o prompt do Windows Defender Firewall ou Controle de conta do usuário for exibido, clique em **Permitir acesso**.
        - Execute o instalador no prompt de comando:
            
            1. Abra um prompt de comando como um administrador no computador do tabcmd.
            2. Navegue até o diretório onde você copiou o instalador do tabcmd.
            3. Instale o tabcmd:
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1
                
                Para instalar em um local não padrão:
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\\to\\install\\directory>"
                
                Por exemplo:
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\\tabcmd"
                
                Para obter uma lista completa das opções da linha de comando que você pode usar com o instalador do tabcmd, execute o instalador com um /?. Para obter mais informações sobre as opções da linha de comando do instalador do tabcmd, consulte [Instalar switches e propriedades do tabcmd (Windows)](https://help.tableau.com/current/server/pt-br/tabcmd_install_flags.htm).
        
        O programa de Configuração do tabcmd cria registros em `C:\Users\<user>\AppData\Local\Temp` que você pode usar, se tiver problemas para instalar o tabcmd. Os registros usam a convenção de nomenclatura `Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log`.
    - Linux
        
        **Observação:** para executar o tabcmd em um computador Linux, você deve instalar o Java 11. Em sistemas semelhantes ao RHEL, ele será instalado como uma dependência ao instalar o tabcmd. Em sistemas Ubuntu, você precisa instalar o Java 11 separadamente, se ele ainda não estiver instalado.  
          
        A partir de julho de 2022, as distribuições Debian não são mais aceitas. Para obter mais informações, consulte a [postagem da Comunidade do Tableau](https://community.tableau.com/s/news/a0A4T0000011xDOUAY/debian-end-of-life).
        
        1. Faça logon como um usuário com acesso sudo ao computador do tabcmd.
        2. Navegue até o diretório onde você copiou o pacote de `.rpm` ou `.deb` baixado.
            
            - Em distribuições em RHEL, incluindo o CentOS, execute o comando a seguir:
                
                `sudo yum install tableau-tabcmd-<version>.noarch.rpm`
            - Em Ubuntu, execute o seguinte comando:
                
                `sudo apt-get install ./tableau-tabcmd-<version>_all.deb`
    
    Para desinstalar o tabcmd de um computador Linux, consulte a documentação da variedade Linux que você está executando.
6. (Opcional) Adicione o local totalmente qualificado onde o tabcmd está instalado no caminho do sistema para permitir que você execute comandos tabcmd sem alterar para esse local ou especificar o local com cada comando. As etapas para fazer isso dependem do tipo e da versão do sistema operacional. Para obter mais informações, consulte [PATH\_(variável)](https://pt.wikipedia.org/wiki/PATH_\(variável\)).

## Como usar o tabcmd

As etapas básicas para usar o tabcmd são as seguintes:

1. Abra o prompt de comando como um administrador.
    
    **Observação:** não use o PowerShell para executar comandos tabcmd no Windows. O uso do PowerShell pode causar um comportamento inesperado.
2. Em um computador com Windows, se o tabcmd foi instalado em um computador que não seja o nó inicial, altere para o diretório em que o tabcmd foi instalado.
    
    Em um computador com Linux, não é necessário mudar para o diretório de instalação.
3. Execute o comando tabcmd.

Ao usar o tabcmd, você deve estabelecer uma sessão de servidor autenticado. A sessão identifica o site do servidor ou do Tableau Cloud e o usuário que a executa. Você pode iniciar uma sessão primeiro e especificar seu comando em seguida, ou você pode iniciar uma sessão e executar o comando de uma vez.

**Importante:** caso esteja usando o tabcmd para executar mais de uma tarefa, você deve executar uma tarefa após a outra (em série), em vez de ao mesmo tempo (em paralelo).

Os comandos (como `login`) e as opções (como `-s`, `-u`, etc.) não diferenciam maiúsculas de minúsculas, mas os valores fornecidos por você (como `User@Example.com`) diferenciam maiúsculas de minúsculas.

## Exemplos

O comando a seguir demonstra como iniciar uma sessão com o Tableau Server chamada _tabserver.mycompany.com_:

tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword

O próximo exemplo mostra um comando que exclui uma pasta de trabalho chamada _Sales\_Workbook_:

tabcmd delete "Sales\_Workbook" 

Confira aqui como fazer tudo o que foi descrito acima com um comando; observe que não é preciso usar `login` aqui:

tabcmd delete "Sales\_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword 

Um Tableau Server pode executar vários sites. Quando uma pasta de trabalho está no site Padrão de um servidor de vários sites, não é preciso especificar Padrão, o comando acima é suficiente. No entanto, se o comando se aplicar somente a algo em um site diferente do Padrão, você deverá especificar a ID desse site (consulte [logon](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#login)). Este é o mesmo comando para uma pasta de trabalho que está no site West Coast Sales (ID de site `wsales`):

tabcmd delete "Sales\_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword 

As opções `-s`, `-t`, `-u`, e `-p` estão entre as variáveis globais do tabcmd, que podem ser usadas com qualquer comando.

Para obter mais informações, consulte [Comandos tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm).

## Mensagens e registros de status

Quando um comando for bem-sucedido, o tabcmd retornará um código de status de zero. Uma mensagem de erro completa para códigos de status diferentes de zero é impressa para **stderr**. Além disso, as mensagens de progresso ou informativas podem ser impressas para **stdout**.

Um registro completo chamado **tabcmd.log** que inclui depuração, progresso e mensagens de erro é gravado em `C:\Users\<username>\AppData\Local\Tableau\`.

**Importante:** o suporte do Tableau não consegue solucionar problemas que só são reproduzíveis em scripts personalizados. Para obter ajuda com seus scripts personalizados, visite os fóruns da comunidade do Tableau.

## Outros artigos nesta seção

<!-- document id=f23961abe3a90e89b2712ed9ba3acc777c354c5b8fc4c165c6daa6de680339f9 url=/tableau/current/pt-br/server/help.md -->



<!-- document id=93437f284fde05df63425487170ddbc95f6d457ad26a688114a3885101254342 url=/tableau/current/pt-br/server/prep_publishserver_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Prep Conductor

O Tableau Prep Conductor permite que você aproveite a funcionalidade de agendamento e rastreamento disponível no Tableau Server para executar seus fluxos automaticamente para atualizar a saída do fluxo. O Tableau Prep Conductor faz parte do Data Management do Tableau apresentado no Tableau Server versão 2019.1 e deve ser ativado para agendar seus fluxos para execução.

Para obter mais informações sobre o processo do Tableau Prep Conductor no Tableau Server, consulte [Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/server_process_prep_conductor.htm)

**Observação**: a partir da versão 2020.4, a licença Data Management é necessária para executar fluxos em uma agenda e ao usar a API REST para executar fluxos.  
Data Management não é mais necessário para publicar fluxos e executá-los manualmente na Web e, como Criador, criar e editar fluxos diretamente no seu servidor.  

Os fluxos criados no Tableau Prep Builder devem ser publicados no Tableau Server antes que eles possam ser programados para serem executados.

Publicar fluxos é semelhante a publicar fontes de dados e pastas de trabalho com o Tableau Desktop. Você pode colocar arquivos em pacotes com o fluxo ou especificar uma conexão direta com as fontes de dados para atualizar a entrada do fluxo à medida que os dados são alterados. Se seu fluxo se conectar a bancos de dados, especifique o tipo de autenticação e defina credenciais para acessar os dados.

Você também pode publicar um fluxo para compartilhá-lo com outras pessoas ou continuar editando-o na Web. Por exemplo, publique um fluxo incompleto para o Tableau Server e abra o fluxo na Web no modo Editar para continuar trabalhando nele. Você também pode criar um fluxo apenas com etapas de entrada (que estão configuradas corretamente) e compartilhá-lo com colegas de trabalho, que podem fazer o download do fluxo para seus computadores e criar e publicar os próprios fluxos.

Para que os fluxos sejam executados, eles devem incluir etapas de saída e não ter erros ou recursos incompatíveis. Para obter mais informações sobre como publicar um fluxo, consulte [Publicar um fluxo para o Tableau Server ou Tableau Cloud](https://help.tableau.com/current/prep/pt-br/prep_conductor_publish_flow.htm). Para obter mais informações sobre incompatibilidade, consulte [Compatibilidade de versão com Tableau Prep](https://help.tableau.com/current/prep/pt-br/prep_conductor_compatibility.htm) .

Manter o controle da integridade de seus fluxos é fácil. Se um fluxo não funcionar devido a erros, como um cálculo inválido ou uma falha de conexão, você pode corrigir o erro imediatamente em Tableau Server. Você pode editar a conexão ou editar o fluxo para corrigir o erro e, em seguida, republicá-lo para continuar de onde parou.

A tabela a seguir mostra os recursos de gerenciamento de fluxo que estão disponíveis com e sem o Data Management e Tableau Prep Conductor habilitado.

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th><span class="mc-variable Variables.DM_sku variable">Data Management</span> com Tableau Prep Conductor habilitado</th><th>Sem <span class="mc-variable Variables.DM_sku variable">Data Management</span></th></tr><tr><td><ul><li><p>Visualize e monitore os detalhes sobre seu fluxo, incluindo atividades recentes nas páginas de <span class="uicontrol">Conteúdo.</span></p></li><li><p>Edite seu fluxo (começando na versão 2020.4).</p></li><li><p>Visualize os resultados das execuções do fluxo e quaisquer erros na guia <span class="uicontrol">Histórico de execuções</span>.</p></li><li><p>Use <span class="uicontrol">Exibições administrativas</span> para monitorar a atividade do servidor e do site, incluindo uma nova visualização que rastreia o histórico de desempenho do fluxo.</p></li><li><p>Execute fluxos usando a API REST.</p></li><li><p>Visualize alertas detalhados para execuções de fluxo com falha.</p></li><li><p>Configure alertas de notificação por e-mail para enviar e-mails aos proprietários de fluxo notificando-os quando o fluxo falhou ao executar e por quê.</p><p>Para obter mais informações sobre como configurar alertas, <a href="https://help.tableau.com/current/server/pt-br/prep_conductor_monitor_flow.htm">Monitorar a integridade e o desempenho do fluxo</a>.</p></li></ul></td><td><ul><li><p>Visualize os detalhes sobre seu fluxo, incluindo atividades recentes nas páginas de <span class="uicontrol">Conteúdo.</span></p></li><li><p>Edite seu fluxo (começando na versão 2020.4).</p></li><li><p>Visualize e edite suas conexões na guia <span class="uicontrol">Conexões</span>.</p></li></ul></td></tr></tbody></table>

## Habilitação do Tableau Prep Conductor no Tableau Server

Antes de começar a publicar fluxos no Tableau Server, há configurações no nível do servidor e do site que você deve definir ou verificar para preparar o Tableau Server para permitir a publicação, agendamento e monitoramento de fluxos.

Consulte os tópicos a seguir para compreender o licenciamento do Tableau Prep Conductor e saiba como habilitá-lo:

- [Habilitar e configurar o Tableau Prep Conductor no Tableau Server](https://help.tableau.com/current/server/pt-br/prep_conductor_config_server_overview.htm): este tópico fornece instruções detalhadas sobre como habilitar e configurar o Tableau Prep Conductor, além de como preparar o Tableau Server para permitir a publicação, o agendamento, o gerenciamento e a preservação de fluxos.
- [Licença Data Management](https://help.tableau.com/current/server/pt-br/dm_license.htm)

## Outros artigos nesta seção

<!-- document id=ddb4bb837791c9bcfd5eaa5a4c74253bedc11d52d919257781586dbdf9542f60 url=/tableau/current/pt-br/server/server_process_prep_conductor.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Prep Conductor

O processo Tableau Prep Conductor executa fluxos e processos de fluxos para ingestão pelo Catálogo de Dados. Ele usa a funcionalidade de agendamento e monitoramento do Tableau Server para que você possa automatizar os fluxos em execução para atualizar a saída de fluxo. A partir de 2020.4, o Data Management só é necessário para agendar fluxos para execução no Tableau Server. Para obter mais informações, consulte [Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm).

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Tableau Prep Conductor</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de Tableau Prep Conductor é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do Tableau Prep Conductor são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>flowprocessor</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O Tableau Prep Conductor usa os seguintes componentes para executar fluxos:

- **Processador em segundo plano:** o Tableau Prep Conductor usa o processo do Processador em segundo plano para executar fluxos. O Processador em segundo plano é um processamento único, por isso cada instância do processo em um nó pode executar um fluxo por vez. Ao adicionar mais Processadores em segundo plano a um nó, você pode aumentar o número de fluxos que podem ser executados em paralelo nesse nó. Os processos do Processador em segundo plano podem ter até metade do número de núcleos físicos desse nó.
- **Conectores:** o Prep Conductor usa os conectores de dados do Tableau compatíveis para se conectar aos dados. Para obter uma lista dos conectores compatíveis, consulte [Conectores compatíveis](https://www.tableau.com/pt-br/products/techspecs).
- **Processador de dados:** qualquer alteração nas etapas de dados ou transformação no seu fluxo que não pode ser enviada para a fonte de dados subjacente é processada usando o Processador de dados. Por exemplo, o SQL Server não oferece suporte nativo a expressões regulares. Ao se conectar ao SQL Server, o Tableau Prep permite gravar cálculos de expressões regulares. O Tableau Prep Conductor usa o Processador de dados para carregar temporariamente os dados e executar a expressão regular.

## Recomendações de desempenho e escala

- **Isolar fluxos para um nó separado:** a execução do Tableau Prep Conductor em um nó separado vai isolar os fluxos de trabalho do fluxo de outras cargas de trabalho do Tableau. Isso é altamente recomendável, pois os fluxos do Prep usam muito a CPU e a RAM.
- **Gerenciar as agendas de fluxo:** você pode controlar a execução de fluxos criando agendas de fluxo. Essas agendas permitem determinar quando os fluxos serão executados e com que frequência, a prioridade dessa agenda e se os itens nessa agenda serão executados em série ou em paralelo.
- **Adicionar recursos:** ao dimensionar o ambiente do Tableau Prep Conductor, é recomendável escalonar até oito núcleos físicos por nó em execução e até quatro processadores em segundo plano em cada um deles. À medida que você precisar de mais recursos, é recomendável adicionar mais nós ao ambiente de servidor.

Você pode monitorar a atividade do usuário e o desempenho dos fluxos usando exibições administrativas. Para obter mais informações, consulte [Monitorar integridade e desempenho do fluxo](https://help.tableau.com/current/server/pt-br/prep_conductor_monitor_flow.htm).

## Topologia e configuração

Por padrão, o Tableau Prep Conductor ele é habilitado automaticamente em um nó que tenha o processador em segundo plano habilitado. Se a função de nó estiver definida para excluir fluxos, o Tableau Prep Conductor não será instalado nesse nó. Para obter mais informações, consulte [Gerenciamento de carga de trabalho por meio das funções de nó](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).

É recomendável habilitar o Tableau Prep Conductor em um nó dedicado para executar fluxos. Para obter mais informações, consulte os tópicos a seguir:

- Para novas instalações do Tableau Server, consulte [Etapa 1 (nova instalação): instalar o Tableau Server com o Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_conductor_new_install.htm)
- Para habilitar o Tableau Prep Conductor em uma instalação existente do Tableau Server, consulte o tópico [Etapa 1 (instalação existente): habilitar o Tableau Prep Conductor](https://help.tableau.com/current/server/pt-br/prep_conductor_add_to_existing_install.htm).

<!-- document id=80d1a70dfd3284a0ac04041c9de0ee44f2b90020d31815514ca460f7b266b2ce url=/tableau/current/pt-br/server/prep_web_auth.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Prep na Web

_O Internet Explorer 11 no Windows e o modo de compatibilidade para o Internet Explorer não são aceitos._

A partir da versão 2020.4, o Tableau Prep oferece suporte à criação na Web para fluxos. Agora você pode criar fluxos para limpar e preparar seus dados usando Tableau Prep Builder, Tableau Server, ou Tableau Cloud. Você também pode executar fluxos manualmente na Web e o Data Management não é necessário.

Embora a maior parte da mesma funcionalidade do Tableau Prep Builder também seja compatível com a Web, existem algumas diferenças ao criar e trabalhar com os fluxos.

> [!IMPORTANT]
> 
> **Importante**: para criar e editar fluxos na Web, você deve ter uma licença de Creator. O Data Management só será necessário se você quiser executar os fluxos de acordo com a agenda, usando o Tableau Prep Conductor ou via API. Para obter informações sobre como configurar e usar o Tableau Prep Conductor, consulte o Tableau Prep Conductor na ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/prep_publishserver_overview.htm) e [Tableau Cloud](https://help.tableau.com/current/online/pt-br/prep_conductor_online_intro.htm).

## Instalação e implantação

Para permitir que os usuários criem e editem fluxos na Web, você precisará fazer várias configurações no servidor. Para obter mais informações sobre cada uma dessas configurações, consulte [Criar e interagir com fluxos na Web](https://help.tableau.com/current/server/pt-br/web_author_flows.htm).

- **Criação na Web**: ativada por padrão, esta opção controla se os usuários podem criar e editar fluxos em Tableau Server ou Tableau Cloud
- **Executar agora**: controla se os usuários ou apenas os administradores podem executar fluxos manualmente, usando a opção Executar agora. O Data Management não é necessário para executar fluxos manualmente na Web.
- **Tableau Prep Conductor**: se Data Management tiver licença, ative essa opção para permitir que os usuários agendem e rastreiem os fluxos.
- **Tableau Prep Extensions** (versão 2021.2.0 e posterior): controla se os usuários podem se conectar ao Einstein Discovery para aplicar e executar modelos preditivos em relação aos dados em seu fluxo.
- **Salvamento automático**: ativado por padrão, esse recurso salva automaticamente o fluxo de trabalho de um usuário em um intervalo de poucos segundos.

No Tableau Server, os administradores podem ajustar a configuração dos processos de criação de fluxos do Tableau Prep. Para obter mais informações, consulte [Criação de fluxos do Tableau Prep](https://help.tableau.com/current/server/pt-br/server_process_prep_flow_authoring.htm).

### Dados de amostra e limites de processamento

Para manter o desempenho enquanto trabalha com fluxos na Web, os limites são aplicados ao volume de dados que você pode incluir em um fluxo.

Aplicam-se os seguintes limites:

- O tamanho máximo do arquivo é de 1GB ao se conectar aos arquivos.
- A opção de amostragem de dados para incluir todos os dados não está disponível. O limite padrão de dados da amostra é de 1 milhão de linhas. O administrador do Tableau Server pode definir o limite de amostra de dados usando TSM. Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#maestroappsettingssamplingmaxrowlimit). No Tableau Cloud, esse limite é fixo e não pode ser definido pelo administrador.

Para obter mais informações sobre como definir a amostra de dados, consulte [Definir o tamanho da amostra de dados](https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#set-your-data-sample-size) na ajuda do Tableau Prep.

Precisa de ajuda para depurar um fluxo lento? Tente ativar Habilitar log de consulta no menu Ajuda\>Configurações e desempenho. Para obter mais informações, consulte [Habilitar log de consulta](https://help.tableau.com/current/prep/pt-br/prep_troubleshoot.htm#enable-query-logging).

## Recursos disponíveis na Web

Quando você cria e edita fluxos na Web, pode perceber algumas diferenças na navegação e na disponibilidade de determinados recursos. Embora a maioria dos recursos esteja disponível em todas as plataformas, alguns recursos são limitados ou ainda não são compatíveis com o Tableau Server ou o Tableau Cloud. A tabela a seguir identifica os recursos em que as diferenças podem ser aplicadas.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 208px;"><col style="width: 59px;" class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">Área de recursos</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">Exceções</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span></th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span></th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span></th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_connect.htm" target="_blank">Conectar a dados</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Alguns conectores podem não ser compatíveis com a Web. Abra o painel <span class="uicontrol">Conectar </span>no servidor para ver os conectores compatíveis.</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_einstein.htm" target="_blank">Criar fluxos do Tableau Prep com o Tableau Agent</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>A partir da versão 2025.2, com suporte no Tableau Cloud (requer Tableau+) e no Tableau Prep Builder quando conectado ao Tableau Cloud com o Tableau Agent ativado.</p><p>A partir da versão 2025.3, com suporte no Tableau Server e Tableau Prep Builder quando conectado ao Tableau Server com o Tableau Agent ativado.</p><p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/online/pt-br/setup_tabAI_site_setting.htm" target="_blank">Ativar IA no seu site do Tableau Cloud</a> e <a href="https://help.tableau.com/current/server/pt-br/sites_gai_server.htm" target="_blank">Ativar IA no seu site do Tableau Server</a>.</p></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_build_flow.htm" target="_blank">Criar e organizar o fluxo</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_configure_dastaset.htm#set-your-data-sample-size" target="_blank">Definir o tamanho da amostra de dados</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">No Tableau Server, o tamanho dos dados de amostra está sujeito aos limites definidos pelo administrador usando um comando do TSM. No Tableau Cloud, esse limite é fixado em 1.048.576 linhas e não pode ser alterado pelo administrador.</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_add_input_data.htm#union-files-and-database-tables-in-the-input-step" target="_blank">Unir linhas de arquivos e tabelas de banco de dada na etapa de entrada</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">As uniões de linhas de entrada não podem ser editadas ou criadas no Tableau Server ou no Tableau Cloud. Somente no Tableau Prep Builder.</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_clean.htm" target="_blank">Limpar e formatar dados</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_explore.htm#copy-field-values-in-the-data-grid" target="_blank">Copiar valores da grade de dados</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Disponível no Tableau Prep Builder e no Tableau Server a partir da versão 2022.3 e no Tableau Cloud a partir de 2022.2 (agosto)</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_combine.htm" target="_blank">Agregar, unir colunas ou linhas de dados</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_scripts.htm" target="_blank">Usar scripts R e Python no fluxo</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">As etapas de script não podem ser adicionadas ao criar ou editar um fluxo no Tableau Cloud. No momento, esse recurso é compatível somente com o Tableau Prep Builder e com o Tableau Server.</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_copy_reuse_steps.htm#create-reusable-flow-steps-version-201932-and-later" target="_blank">Criar etapas de fluxos reutilizáveis</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#automatically-save-your-flows-on-the-web" target="_blank">Salvar os fluxos automaticamente na Web</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não aplicável</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#automatic-file-recovery" target="_blank">Recuperação automática de arquivos</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Não aplicável</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">Não aplicável</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_troubleshoot.htm#enable-query-logging" target="_blank">Habilitar o log de consultas</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#view-flow-output-in-tableau-desktop" target="_blank">Exibir saída de fluxo no Tableau Desktop</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#create-an-extract-to-a-file" target="_blank">Criar uma extração para um arquivo</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#create-an-extract-to-a-microsoft-excel-worksheet" target="_blank">Criar uma extração para uma planilha do Microsoft Excel</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_unavailable.png" alt="Um círculo vermelho com uma linha diagonal atravessando-o."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/pro/desktop/pt-br/customsql.htm" target="_blank">Conectar a uma consulta de SQL personalizado</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#create-a-published-data-source" target="_blank">Criar uma fonte de dados publicada</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#save-flow-output-data--to-external-databases" target="_blank">Salvar saída de fluxo em bancos de dados externos</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a href="https://help.tableau.com/current/prep/pt-br/prep_predictions.htm" target="_blank">Adicionar previsões do Einstein Discovery ao seu fluxo</a></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyB-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyB-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyA-Column1-Body1"><img src="https://help.tableau.com/current/server/pt-br/Img/prep_pwa_available.png" alt="Um círculo verde com uma marca de seleção branca."></td></tr></tbody></table>

### Salvamento automático e como trabalhar com rascunhos

Quando você cria ou edita fluxos no servidor, o trabalho é salvo automaticamente como rascunho em um intervalo de poucos segundos para que você não perca o trabalho, em caso de acidente ou se uma guia for fechada por acidente.

Os rascunhos são salvos no servidor e no projeto em que você está conectado. Você não pode salvar ou publicar um rascunho em outro servidor, mas pode salvar o fluxo em outro projeto desse servidor, usando a opção do menu Arquivo > Publicar como.

![Um fluxo de preparação de dados com dados de amostra, nomes de campos e valores de campos.](/tableau/current/pt-br/server/pt-br/Img/prep_save_draft1.png)

Só você pode ver o conteúdo do rascunho até a publicação. Se você publicar alterações e precisar revertê-las, pode usar a caixa de diálogo Histórico de revisões para exibir e reverter para uma versão publicada anteriormente. Para obter mais informações sobre como salvar fluxos na Web, consulte [Salvar os fluxos automaticamente na Web](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#automatically-save-your-flows-on-the-web).

## Fluxos de publicação na Web

Se você criar um fluxo do zero na Web ou editar um fluxo existente, antes de executar o fluxo, é necessário publicá-lo.

- Você só pode publicar fluxos de rascunho no mesmo servidor em que está conectado.
- Você pode publicar um rascunho em um projeto diferente usando o menu Arquivo e selecionando Publicar como.
- Você pode inserir credenciais para as conexões de banco de dados do fluxo, a fim de permitir que o fluxo seja executado sem inserir manualmente as credenciais quando o fluxo for executado. Se você abrir o fluxo para editá-lo, precisará inserir novamente suas credenciais.

### Inserir credenciais

As credenciais inseridas só se aplicam à execução de fluxos no servidor. A partir do Tableau Cloud versão 2025.2, os proprietários de fluxo podem editar seu fluxo na criação na Web sem precisar autenticar novamente em todas as conexões de banco de dados, se essas conexões forem inseridas no fluxo ou salvas no perfil do usuário. Se estiver usando o Tableau Server, é necessário inserir as credenciais manualmente ao editar um fluxo conectado a um banco de dados. As credenciais inseridas só podem ser definidas no nível de fluxo e não no nível do servidor ou do site.

Execute um destes procedimentos:

- No menu superior, selecione Arquivo > Credenciais de conexão > Inserir no fluxo publicado.
    
    ![O menu Arquivo mostra o submenu de Credenciais de conexão, Incorporar no fluxo publicado, para incorporar suas credenciais de conexão de dados em um fluxo quando ele é publicado.](/tableau/current/pt-br/server/pt-br/Img/prep_embed_credentials.png)
- Ao publicar um fluxo, selecione a caixa de seleção Inserir credenciais. Essa opção é mostrada quando você seleciona Publicar como para publicar o fluxo em um novo projeto pela primeira vez ou quando você está editando um fluxo que foi publicado pela última vez por outra pessoa.
    
    ![A caixa de diálogo Publicar fluxo como com campos para nomear e publicar um fluxo, com opções para projeto e credenciais de incorporação.](/tableau/current/pt-br/server/pt-br/Img/prep_embed_credentials_prompt.png)

### Publicar um fluxo

Quando você publica o fluxo, ele se torna a versão atual do fluxo e pode ser executado e visto por outros usuários com acesso ao projeto. Só você pode ver os fluxos que nunca foram publicados ou as alterações de fluxo que você faz em um rascunho, até que você publique o fluxo. Para obter mais informações sobre os status de fluxos na Web, consulte [Salvar os fluxos automaticamente na Web](https://help.tableau.com/current/prep/pt-br/prep_save_share.htm#automatically-save-your-flows-on-the-web).

Para publicar o fluxo, siga um destes procedimentos:

- No menu superior, selecione Arquivo > Publicar ou Arquivar > Publicar como
    
    ![O menu Arquivo na Web destacando a opção Publicar para publicar um fluxo.](/tableau/current/pt-br/server/pt-br/Img/prep_pwa_publish_menu.png)
- Na barra superior, clique no botão Publicar ou clique na seta suspensa para selecionar Publicar como.
    
    ![A barra superior de um fluxo do Tableau Prep na Web mostrando os botões Publicar e Publicar como.](/tableau/current/pt-br/server/pt-br/Img/prep_pwa_publish.png)

### Quem pode fazer isso

- Administrador do servidor, Creator (administrador de site) e Creator (Criador) têm acesso total de conexão e publicação.
- O Creator pode realizar as tarefas de criação na Web.

<!-- document id=67f104aca182dc8764e510c14c1cc67378c322f52209afd2714c7b8bf108649e url=/tableau/current/pt-br/server/server-in-container_helm-chart.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server Helm Chart - Visão geral

**Importante**: esta documentação pressupõe um conhecimento do Helm e de Helm Charts e não tenta fornecer exemplos prescritivos detalhados. Ele foi criado para clientes que estão familiarizados com o Tableau Server e com o Helm e Helm Charts.

## Introdução

O Tableau Server Helm Chart permite implantar e gerenciar o Tableau Server em clusters do Kubernetes usando o Helm, o gerenciador de pacotes do Kubernetes. Um Helm Chart contém todos os recursos do Kubernetes necessários para executar o Tableau Server em um ambiente de contêineres, fornecendo um processo de implantação declarativo e repetível.

## O que é o Helm?

O Helm é um gerenciador de pacotes para Kubernetes que simplifica a implantação e o gerenciamento de aplicações. O Helm utiliza Charts, que são pacotes de recursos do Kubernetes pré-configurados. Um Helm Chart para Tableau Server agrupa todos os componentes necessários, incluindo:

- Implantações e StatefulSets
- Configurações do Services e do Ingress
- ConfigMaps and segredos
- PersistantVolumeClaims para armazenamento de dados
- Políticas RBAC e ServiceAccounts

## Arquitetura

### Componentes

O Tableau Server Helm Chart implanta os seguintes componentes principais:

#### Contêiner do Tableau Server

- Executa uma instância completa do Tableau Server dentro de um contêiner do Linux
- Com base na imagem UBI 8 com `supervisord` gerenciando processos
- Inicializa e inicia automaticamente o Tableau Server na inicialização do contêiner

#### Recursos do Kubernetes

- **StatefulSet**: gerencia pods do Tableau Server com identidades de rede estáveis
- **PersistantVolumeClaim**: fornece armazenamento persistente para dados do Tableau em `/var/opt/tableau`
- **Service**: expõe o Tableau Server dentro do cluster
- **Ingress** (opcional): fornece acesso externo ao Tableau Server
- **ConfigMap**: armazena configurações não confidenciais
- **Secret:** armazena dados confidenciais, como licenças e senhas

### Topologia da implantação

#### Implantação com um único nó

- Um pod do Tableau Server com todos os processos em um único nó
- Adaptado para desenvolvimento, teste e cargas de trabalho de produção de pequeno porte
- A configuração mais simples com requisitos mínimos de recursos

#### Implantação com múltiplos nós

- Múltiplos pods do Tableau Server distribuídos pelos nós
- Armazenamento de rede compartilhado para coordenação de bootstrap
- Disponibilidade e escalabilidade maiores para cargas de trabalho de produção
- Requer configuração adicional para coordenação de nó

### Considerações de segurança

- **Gerenciamento de segredos**: sempre use segredos do Kubernetes para dados confidenciais na produção
- **Políticas de rede**: considere implementar políticas de rede para restringir a comunicação do pod
- **RBAC**: o gráfico cria uma conta de serviço; configurar o RBAC conforme necessário
- **Segurança de imagens**: usa imagens de contêiner confiáveis e verifica vulnerabilidades
- **TLS/SSL**: habilitar TLS para Ingress em ambientes de produção

## Benefícios do uso do Helm

### Implantação simplificada

- Instalar o Tableau Server com um único comando `helm install`
- Configuração declarativa por meio de arquivos de valores
- Infraestrutura controlada por versão na forma de código

### Atualizações e rollbacks fáceis

- Atualização das versões do Tableau Server com `helm upgrade`
- Faça rollback para versões anteriores se ocorrerem problemas
- Acompanhar histórico da implantação

### Ambientes consistentes

- O mesmo gráfico é implantado em desenvolvimento, preparação e produção
- Personalização específica para o ambiente por meio de arquivos de valores
- Desvio de configuração reduzido

### Práticas recomendadas integradas

- Solicitações e limites de recursos pré-configurados
- Verificações de integridade e investigações de prontidão
- Contextos de segurança e políticas RBAC

## Plataformas suportadas

### Distribuições do Kubernetes

- Clusters do Kubernetes autogerenciados (1.19+)
- Amazon EKS (Elastic Kubernetes Service)
- Azure AKS (Azure Kubernetes Service)
- Google GKE (Google Kubernetes Engine)
- Red Hat OpenShift

### Requisitos para produção

- Kubernetes 1.19 ou posterior
- Helm 3.x
- Provedor de armazenamento persistente (para PersistantVolumes)
- Controlador Load Balancer ou Ingress (para acesso externo)
- Mínimo de 16 GB de RAM e 4 núcleos de CPU por nó (8 núcleos de CPU são recomendados - consulte [Requisitos mínimos de hardware e recomendações para o Tableau Server](https://help.tableau.com/current/server/pt-br/server_hardware_min.htm#OS_requirements))

## Limitações

Embora o Helm Chart ofereça muitos benefícios, saiba o seguinte:

- Cada pod executa uma instância completa do Tableau Server, não microsserviços individuais.
- A reinicialização do contêiner exige a reinicialização dos processos (mas não dos dados).
- O escalonamento automático de pod horizontal não é suportado devido à arquitetura do Tableau Server.
- As implantações com múltiplos nós exigem armazenamento de rede compartilhado para coordenação.
- Algumas configurações avançadas do Tableau Server podem exigir scripts de inicialização personalizados.

## Introdução

Para começar a usar o Tableau Server Helm Chart, consulte [Tableau Server Helm Chart - Pré-requisitos](https://help.tableau.com/current/server/pt-br/server-helm-prerequisites.htm).

Para obter exemplos de implantação, consulte [Tableau Server Helm Chart - Implantação](https://help.tableau.com/current/server/pt-br/server-helm-deploy.htm).

Para obter orientação na solução de problemas, consulte [Tableau Server Helm Chart - Solução de problemas](https://help.tableau.com/current/server/pt-br/server-helm-troubleshooting.htm).

## Recursos adicionais

- [Requisitos de sistema do Tableau Server](https://help.tableau.com/current/server-linux/en-us/requ.htm)
- [Tableau Server no Repositório GitHub do Kubernetes](https://github.com/tableau/tableau-server-in-kubernetes)
- [Documentação do Helm](https://helm.sh/docs/)
- [Documentação do Kubernetes](https://kubernetes.io/docs/)

## Outros artigos nesta seção

<!-- document id=9cbc592bbf3c3a6afdb00d7679a3bc23c316daedbf9624b8c59f31ee1e158b34 url=/tableau/current/pt-br/server/server_tsig_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server Independent Gateway

Este tópico fornece uma visão geral do Armazenamento do Tableau Server Independent Gateway.

O Independent Gateway é um servidor proxy reverso e balanceador de carga baseado no httpd do Apache. Ele usa a mesma versão httpd do Apache que o processo do Gateway do Tableau Server interno ao cluster do Tableau Server, mas é adequado para implantação em uma DMZ de rede. Como o Independent Gateway faz parte do Tableau Server, ele é gerenciado pelo TSM e não precisa de configuração separada.

Sua configuração tem total conhecimento da topologia dos componentes do Tableau Server acessíveis externamente e é atualizada quando a topologia do cluster é alterada. Após um processo simples de instalação do Independent Gateway, as opções de configuração são feitas centralmente usando os itens de configuração do Tableau Services Manager (TSM).

Com esse recurso, agora o Tableau Server pode ser configurado de duas maneiras:

- Instalar o Tableau Server em uma instalação autônoma. Qualquer proxy reverso precisa ser instalado e gerenciado separadamente.
- Instalar o Tableau Server e o Independent Gateway como um proxy reverso que é gerenciado por Tableau Server (versão 2022.1 e posterior).

## Por que usar o Independent Gateway?

O uso do Independent Gateway tem os seguintes benefícios em relação à instalação de um proxy reverso separado:

- **Totalmente compatível:** o Independent Gateway faz parte de uma instalação do Tableau Server e é totalmente compatível com o Tableau.
- **Reconhecimento do Tableau Server:** quando você usa um proxy reverso separado, ele precisa ser atualizado quando a topologia do Tableau Server for alterada. O Independent Gateway está totalmente ciente de todos os componentes de chamadas externas do Tableau Server e é atualizado conforme eles mudam.

## Gerenciando o Independent Gateway

### Gerenciamento de licenças

Para usar o Independent Gateway você deve ter recursos do Advanced Management em Tableau Server. Não há licenciamento feito no nó do Independent Gateway. Para obter mais informações, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm). Se você não tiver uma chave do Advanced Management ativada ou se a licença expirou, você verá o seguinte comportamento:

- Se você tentar configurar o Tableau Server com Independent Gateway, ele falhará.
- Se você já estiver usando o Independent Gateway, e a licença do Advanced Management expirar, você observará o seguinte comportamento:

### Backup e restauração

Não há impacto no backup ou restauração com o Independent Gateway. Um backup ou restauração do Tableau Server não incluirá nenhuma informação ou configuração para o Independent Gateway. Se você usar o backup para criar uma nova instalação do Tableau, precisará instalar, configurar e habilitar o Independent Gateway para a nova instalação do Tableau Server separadamente.

### Considerações de alta disponibilidade

Você pode instalar várias instâncias do Independent Gateway para fornecer alta disponibilidade robusta em seu proxy reverso. Você também pode aumentar o número de nós de Independent Gateway se tiver um grande número de sessões de cliente acessando o Tableau.

Todos os nós devem executar o mesmo sistema operacional. Para obter mais informações, consulte [Requisitos de software para servidor de vários nós](https://help.tableau.com/current/server/pt-br/distrib_requ.htm#DistribPrereqOS).

## Topologia

Ao configurar o Tableau Server com Independent Gateway, você não precisa mais configurar e configurar um proxy reverso separado. O Independent Gateway aparecerá na página de status do TSM como um serviço externo.

**Observação:** a página de status e a saída de status na CLI mostrarão apenas uma única instância do Independent Gateway, mesmo se você tiver instalado vários nós dele.

## Próximo

[Instalar o Tableau Server com Independent Gateway](https://help.tableau.com/current/server/pt-br/server_tsig_new_install.htm)

## Outros artigos nesta seção

<!-- document id=a2de41f5cab38cff50cfecef589956a3394f636e0c2c5d6b41ce5332aca70a52 url=/tableau/current/pt-br/server/ts_gcp_topology.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server na topologia da Google Cloud Platform

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao implantar o Tableau Server na Google Cloud Platform, é possível escolher o nível e a profundidade da integração entre o Tableau Desktop e o Tableau Server nas máquinas virtuais (VMs) do Google Compute Engine (GCE). É possível usar o Tableau Desktop e sua habilidade de extrair dados das fontes de dados para agir como uma ponte entre os dados e o Tableau Server. Como alternativa, com base nas suas necessidades, ou se você já tiver muitos dados no na Google Cloud Platform, é possível escolher potencializar toda a gama de serviços da Google Cloud Platform em conjunto com o Tableau Server. O seguinte diagrama mostra a integração da fonte de dados com o Tableau Desktop e o Tableau Server.

![Um diagrama do processo de transformação de dados brutos para acesso do usuário por meio do Tableau Desktop e uma máquina virtual baseada na nuvem.](/tableau/current/pt-br/server/pt-br/Img/tableau_cloud_topology.png)

No seguinte diagrama, todos os dados estão hospedados na Google Cloud Platform. É possível analisar dados estruturados e não estruturados gerenciados de maneira segura e escalável. É possível usar os dados existentes apenas na Google Cloud Platform, os dados não gerenciados existentes fora da Google Cloud Platform ou uma combinação de ambos. Essa flexibilidade aumenta em muito a habilidade da sua empresa de oferecer suporte a migrações para a nuvem a partir de dados locais, já que os dois tipos de dados possuem igual suporte.

![Um diagrama ilustrando o processo de coleta, armazenamento, análise e visualização de dados com dados do Google](/tableau/current/pt-br/server/pt-br/Img/tableau_google_data_sources.png)

<!-- document id=c0e591c4c6b04aca3d6d8810f1922fd0520611cbbcdc694808c629dd824629f9 url=/tableau/current/pt-br/server/ts_azure_topology.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server na topologia do Microsoft Azure

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao implantar o Tableau Server no Microsoft Azure, é possível escolher o nível e a profundidade da integração entre o Tableau Desktop e o Tableau Server nas máquinas virtuais (VMs) do Microsoft Azure. É possível usar o Tableau Desktop e sua habilidade de extrair dados das fontes de dados para agir como uma ponte entre os dados e o Tableau Server. Como alternativa, com base nas suas necessidades, ou se você já tiver muitos dados no Microsoft Azure, é possível escolher potencializar toda a gama de serviços do Microsoft Azure em conjunto com o Tableau Server. O seguinte diagrama mostra a integração da fonte de dados com o Tableau Desktop e o Tableau Server.

![Um diagrama do processo de transformação de dados brutos para acesso do usuário por meio do Tableau Desktop e uma máquina virtual baseada na nuvem.](/tableau/current/pt-br/server/pt-br/Img/tableau_cloud_topology.png)

No seguinte diagrama, todos os dados estão hospedados no Microsoft Azure. É possível analisar dados estruturados e não estruturados gerenciados de maneira segura e escalável. É possível usar os dados existentes apenas no Microsoft Azure, os dados não gerenciados existentes fora do Microsoft Azure ou uma combinação de ambos. Essa flexibilidade aumenta em muito a habilidade da sua empresa de oferecer suporte a migrações para a nuvem a partir de dados locais, já que os dois tipos de dados possuem igual suporte.

![Um diagrama que ilustra o processo de coleta, armazenamento, análise e visualização de dados com dados do Azure.](/tableau/current/pt-br/server/pt-br/Img/tableau_azure_data_sources.png)

<!-- document id=4b6e07fc17784e14812e15fbccc88cd9b342a4c34773910c62323f4fe38601b8 url=/tableau/current/pt-br/server/ts_alibaba_deployment_options.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server nas opções de implantação da Alibaba Cloud

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode implantar o Tableau Server em uma instância do Elastic Compute Service (ECS) da Alibaba Cloud. Uma implantação do Tableau Server na Alibaba Cloud suporta o seguinte:

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Tableau Server</th><th style="text-align: center;">Autoimplantação do ECS da Alibaba Cloud</th></tr><tr><td>Pronto para produção</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Atualizar o Tableau sem substituir a instância</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Instalar no Linux</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Instalar no Windows</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade vertical</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade horizontal (adicionar nós)</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Suporte do Active Directory</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Licença BYOL</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr></tbody></table>

A opção de autoimplantação é descrita em mais detalhes abaixo:

- **Autoimplantação de uma instância do Elastic Compute Service (ECS) da Alibaba Cloud** – Fornece a maior flexibilidade e opções para personalizar o Tableau Server no ambiente.
    
    A autoimplantação do Tableau Server em uma instância ECS é recomendada para ambientes de desenvolvimento, teste e produção que começam simples, mas talvez precisem ser escalonados mais tarde.
    
    Para obter mais informações sobre autoimplantação, consulte [Autoimplantar um Tableau Server único na Alibaba Cloud](https://help.tableau.com/current/server/pt-br/ts_alibaba_single_server.htm). Para obter mais informações sobre a implantação em um ambiente distribuído, consulte [Autoimplantar um Tableau Server na Alibaba Cloud de um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_alibaba_multiple_server.htm).

Para obter mais informações sobre as opções de licenciamento do Tableau Server, consulte [Visão geral de licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

<!-- document id=b24ad7afadd4d8abce1716648e6aed34a273132e179be9b4b19581b0a00a1ec4 url=/tableau/current/pt-br/server/ts_gcp_deployment_options.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server nas opções de implantação da Google Cloud Platform

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Você pode implantar o Tableau Server em uma máquina virtual (VM) do Google Compute Engine (GCE). Uma implantação do Tableau Server no GCE suporta o seguinte:

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Tableau Server</th><th style="text-align: center;">Autoimplantação da VM do Google Compute Engine</th></tr><tr><td>Pronto para produção</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Atualizar o Tableau sem substituir a VM</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Instalar no Linux</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Instalar no Windows</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade vertical</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Escalabilidade horizontal (adicionar nós)</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Suporte do Active Directory</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr><tr><td>Licença BYOL</td><td style="text-align: center;"><img src="https://help.tableau.com/current/server/pt-br/Img/greencheckmark.png" alt="Ícone de marca de seleção indicando sucesso."></td></tr></tbody></table>

A opção de autoimplantação é descrita em mais detalhes abaixo:

- **Autoimplantação para uma VM do Google Compute Engine** – Fornece a maior flexibilidade e opções para personalizar o Tableau Server no ambiente.
    
    A autoimplantação do Tableau Server em uma VM do Google Compute Engine é recomendada para ambientes de desenvolvimento, teste e produção que começam simples, mas talvez precisem aumentar mais tarde.
    
    Para obter mais informações sobre autoimplantação, consulte [Autoimplantar um Tableau Server único na Google Cloud Platform](https://help.tableau.com/current/server/pt-br/ts_gcp_single_server.htm). Para obter mais informações sobre a implantação em um ambiente distribuído, consulte [Autoimplantar um Tableau Server na Google Cloud Platform de um ambiente distribuído](https://help.tableau.com/current/server/pt-br/ts_gcp_multiple_server.htm).

Para obter mais informações sobre as opções de licenciamento do Tableau Server, consulte [Visão geral do licenciamento](https://help.tableau.com/current/server/pt-br/license_server_overview.htm).

<!-- document id=12751c759d83937de3faafe6ec5a8304f2ff1d9bc01e5157c94b03ae5ddded6b url=/tableau/current/pt-br/server/ts_alibaba_topology.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Server nas topologia da Alibaba Cloud

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao implantar o Tableau Server na Alibaba Cloud, é possível escolher o nível e a profundidade da integração entre o Tableau Desktop e o Tableau Server na suas instâncias do Elastic Compute Service (ECS) da Alibaba Cloud. É possível usar o Tableau Desktop e sua habilidade de extrair dados das fontes de dados para agir como uma ponte entre os dados e o Tableau Server. Baseado nas suas necessidades, ou se você já tiver muitos dados na nuvem da Alibaba Cloud, em vez disso é possível escolher potencializar toda a gama de serviços da Alibaba Cloud em conjunto com o Tableau Server. O seguinte diagrama mostra a integração da fonte de dados com o Tableau Desktop e o Tableau Server.

![Um diagrama do processo de transformação de dados brutos para acesso do usuário por meio do Tableau Desktop e uma máquina virtual baseada na nuvem.](/tableau/current/pt-br/server/pt-br/Img/tableau_cloud_topology.png)

No seguinte diagrama, todos os dados estão hospedados na Alibaba Cloud. É possível analisar dados estruturados e não estruturados gerenciados de maneira segura e escalável. É possível usar os dados existentes apenas na Alibaba Cloud, os dados não gerenciados existentes fora da Alibaba Cloud ou uma combinação de ambos. Essa flexibilidade aumenta em muito a habilidade da sua empresa de oferecer suporte a migrações para a nuvem a partir de dados locais, já que os dois tipos de dados possuem igual suporte.

![Um diagrama ilustrando o processo de coleta, armazenamento, análise e visualização de dados com dados do Alibaba Cloud.](/tableau/current/pt-br/server/pt-br/Img/tableau_alibaba_data_sources.png)

<!-- document id=49d2cab17c98763adc0c3d5e208b1a1c2b0fab4aa919031705a31cd26e8f6c04 url=/tableau/current/pt-br/server/server_process_statistical_service.md -->

[Pular para o conteúdo principal](#main-content)

# Tableau Statistical Service

O Tableau Statistical Service gerencia o mecanismo estatístico por trás do Explique os dados e das funções de modelagem preditiva emTableau Server . Este serviço está disponível no Tableau Server 2022.1 até 2023.1.x.

**Observação:** o Serviço Estatístico foi descontinuado na versão 2023.3.0 e não aparece mais na página de status ou na saída do comando tsm status.

## Configuração do servidor

O Tableau Statistical Service é instalado automaticamente em qualquer nó em que o VizQL esteja instalado.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p> Tableau Statistical Service</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo  Tableau Statistical Service é visível na Página de status e pode ser acessado usando a CLI TSM para visualizar. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do  Tableau Statistical Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>statsservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

## Impacto se o Tableau Statistical Service falhar

Se o Tableau Statistical Service parar de funcionar, os dados de explicação ficarão indisponíveis e as exibições que contêm cálculos com funções preditivas MODEL\_PERCENTILE e MODEL\_QUANTILE não serão renderizadas.

## Desempenho

Se houver maior uso de dados de explicação ou funções de modelagem preditiva no Tableau Server, você poderá se beneficiar da instalação de instâncias adicionais do Tableau Statistical Service em nós que executam o VizQL. Para obter mais informações sobre como configurar a topologia de um nó do Tableau Server, consulte [Configurar nós](https://help.tableau.com/current/server/pt-br/config_nodes.htm).

## Arquivos de registro

O Statistical Service cria dois conjuntos de arquivos de registro:

- `control_statsservice*.log`: esses registros conterão informações sobre a inicialização e ativação do serviço.
- `stdout_statsservice_*.log`: esses registros conterão informações sobre status e erros.

Para obter mais informações, consulte [Locais de arquivo de registro e registros do Tableau Server](https://help.tableau.com/current/server/pt-br/logs_loc.htm).

<!-- document id=a39c1d06b684e8d67b642c0f6e3fec868c83d0660bc96d828b7f7b44fc39c1a5 url=/tableau/current/pt-br/server/adminview_backgrounder_upgrade_thumbnails.md -->

[Pular para o conteúdo principal](#main-content)

# Tarefa Atualizar miniaturas

No Tableau Server versão 2019.1 e posteriores, as pastas de trabalho e exibições usam miniaturas em alta resolução. Ao atualizar para o Tableau Server versão 2019.1 ou posteriores, o Processador em segundo plano executa as tarefas Colocar atualização de miniaturas em fila e Atualizar miniaturas, que atualizam miniaturas de todas as exibições que não foram editadas ou publicadas desde a versão 2018.2 do Tableau e as converte de imagens de miniatura de baixa resolução (192 x 192 pixels) para alta resolução (300 x 300 pixels), conforme mostrado na figura abaixo.

**Observação:** a partir da versão 2020.2 do Tableau Server e posteriormente, o trabalho Atualizar miniaturas é desligado por padrão. Os administradores do servidor podem usar tabcmd para executar o trabalho Atualizar miniaturas. Para obter mais informações, consulte [upgradethumbnails](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#upgradethumbnails).

![Um mapa de variações de vários indicadores de saúde por país.](/tableau/current/pt-br/server/pt-br/Img/adminview_backgrounder_upgrade_thumnails.png)

Quando a tarefa de Atualizar miniaturas atualiza as imagens em miniatura, a data de modificação da exibição é alterada para corresponder à data de atualização da miniatura. A tarefa Atualizar miniaturas não altera a data de modificação das pastas de trabalho ao atualizar as miniaturas da exibição.

Dependendo do número de pastas de trabalho que você tiver, a tarefa Atualizar miniaturas pode ser executada de alguns minutos a algumas horas. Você observará que o uso de CPU os nós do Processador em segundo plano fica maior que o normal durante o período em que a tarefa Atualizar miniaturas está em execução. Além disso, verá que as imagens de miniatura da podem aparecer em baixa resolução por até uma semana após atualizar para o Tableau Server 2019.1 ou posteriores, enquanto a tarefa Atualizar miniaturas processa todas as imagens de miniatura em suas pastas de trabalho. Recomendamos esperar que a tarefa Atualizar miniaturas seja concluída antes de fazer backup do Tableau Server.

Após a primeira execução da tarefa Atualizar miniaturas, ela é executada em uma agenda semanal predefinida. A tarefa Atualizar miniaturas é executada como baixa prioridade e cria uma tarefa por pasta de trabalho na tabela background\_jobs para atualizar qualquer miniatura de baixa resolução. As miniaturas de baixa resolução publicadas no Tableau Server pelo Tableau Desktop versão 2018.3 e anteriores são limpas automaticamente a cada semana, sempre que a tarefa Atualizar miniaturas é executada.

## Solução de problemas

Verifique o status da tarefa Atualizar miniaturas usando a exibição administrativa [Tarefas em segundo plano para exibições administrativas de não-extrações](https://help.tableau.com/current/server/pt-br/adminview_backgrnd_nonextract.htm). A tarefa Atualizar miniaturas pode apresentar status de êxito ou de erro.

A tarefa Atualizar miniaturas falhou, ou foi concluída mas algumas miniaturas ainda estão em baixa resolução.

A tarefa Atualizar miniaturas pode apresentar status de erro se as credenciais forem incorretas. Nesse caso, as miniaturas da pasta de trabalho ainda aparecerão embaçadas e em baixa resolução (192x192 pixels). Atualize suas credenciais e a tarefa Atualizar miniaturas atualizará as miniaturas da pasta de trabalho na próxima vez que for executada.

<!-- document id=f08d9dac08de99faa924404552a9f8917cf61edaaa7e7926597010431a5cf59b url=/tableau/current/pt-br/server/adminview_backgrnd.md -->

[Pular para o conteúdo principal](#main-content)

# Tarefas em segundo plano para extrações

A exibição Tarefas em segundo plano para extrações mostra as tarefas específicas à extração que são executadas no servidor.

![O gráfico de séries temporais exibe o número de extrações executadas no servidor nos últimos sete dias, enquanto o gráfico de barras ilustra a contagem diária de extrações bem-sucedidas e com falha.](/tableau/current/pt-br/server/pt-br/Img/adminview_extract.png)

## Compreensão da exibição

Para entender melhor essa exibição administrativa pré-criada, observe o seguinte:

- A tabela “Quais extrações são executadas neste servidor” lista as extrações executadas no intervalo de tempo especificado na Linha do tempo.
- É possível clicar em Êxito ou Erro para filtrar a tabela com base no status.
- É possível clicar em uma tarefa específica para atualizar o gráfico “Quanto tempo as extrações demoraram” para a tarefa selecionada.
- A tabela “Quantas extrações foram bem-sucedidas ou falharam” é atualizada para o status (sucesso ou falha) da tarefa, mas a contagem de extrações que foram bem-sucedidas ou falharam não é alterada.

### Status

As tarefas podem ter um status de conclusão bem-sucedida ou de erro.

<table class="table--plain"><thead><tr class="Head-Header1"><th>Ícone</th><th>Descrição</th></tr></thead><tbody><tr class="Body-Body1"><td><img src="https://help.tableau.com/current/server/pt-br/Img/icon_adminview_error.png" alt="Ícone de erro de exibição do administrador."></td><td><b>Erro</b>: o servidor não pôde concluir a tarefa.</td></tr><tr class="Body-Body1"><td><img src="https://help.tableau.com/current/server/pt-br/Img/icon_adminview_success.png" alt="Ícone de sucesso de exibição do administrador."></td><td><b>Êxito</b>: o servidor concluiu a tarefa.</td></tr></tbody></table>

### Consultar detalhes de uma tarefa

Para obter detalhes sobre a tarefa, use o mouse para passar o cursor sobre o ícone de êxito ou de erro.

![Informações sobre o status da extração de dados.](/tableau/current/pt-br/server/pt-br/Img/adminview_extract_details.png)

<!-- document id=596295edf2c34e24f9ebca850ba345ba822c18f0c6f9f9af960d108ae54c3dbd url=/tableau/current/pt-br/server/adminview_backgrnd_nonextract.md -->

[Pular para o conteúdo principal](#main-content)

# Tarefas em segundo plano para não extrações

A exibição Tarefas de segundo plano para não extrações exibe tarefas executadas pelo servidor que não estão relacionadas à atualização de extrações. Por exemplo, conexões de OAuth editadas, notificações de assinatura etc.

![Um gráfico de séries temporais exibe a contagem de tarefas em segundo plano concluídas e abortadas nas últimas 24 horas, enquanto uma tabela abrangente detalha cada tarefa e sua frequência de execução.](/tableau/current/pt-br/server/pt-br/Img/adminview_nonextract.png)

Uma tabela lista as tarefas executadas no intervalo de tempo especificado. Clique em Êxito ou Erro para filtrar a tabela com base no status. Selecione uma tarefa específica na tabela Quantas tarefas foram bem-sucedidas ou falharam neste site para atualizar o gráfico Quais tarefas de segundo plano foram executadas neste site para a tarefa selecionada.

As tarefas podem ter um status de conclusão bem-sucedida ou de erro. Para obter detalhes sobre a tarefa, use o mouse para passar o cursor sobre o ícone de êxito ou de erro.

<table class="table--plain"><thead><tr class="Head-Header1"><th>Ícone</th><th>Descrição</th></tr></thead><tbody><tr class="Body-Body1"><td><img src="https://help.tableau.com/current/server/pt-br/Img/icon_adminview_error.png" alt="Ícone de erro de exibição do administrador."></td><td><b>Erro</b>: o servidor não pôde concluir a tarefa.</td></tr><tr class="Body-Body1"><td><img src="https://help.tableau.com/current/server/pt-br/Img/icon_adminview_success.png" alt="Ícone de sucesso de exibição do administrador."></td><td><b>Êxito</b>: o servidor concluiu a tarefa.</td></tr></tbody></table>

Os detalhes que você pode ver sobre a tarefa são a ID, o status, a prioridade, e quando foi criada, iniciada e concluída. Além disso, você pode ver o tempo de execução: o tempo total de execução do trabalho em segundo plano, que inclui o tempo de execução do trabalho e a sobrecarga do trabalho em segundo plano, como inicialização e limpeza. Veja também em qual processador em segundo plano o trabalho está sendo executado.

## Outros artigos nesta seção

<!-- document id=9c89b7dfe1ef1fd010e5b84df734e0d3d03c6d0ee8a4d4822325c609a8ec52fa url=/tableau/current/pt-br/server/config_post_install.md -->

[Pular para o conteúdo principal](#main-content)

# Tarefas pós-instalação

Depois de instalar o Tableau Server, você pode executar outras tarefas de configuração, como revisar a lista de verificação de proteção de segurança, configuração de notificações de eventos do servidor, configuração do cache de dados para modos de exibição e configuração do relatório de falha do servidor.

## Outros artigos nesta seção

<!-- document id=5ec63b6923e8027fd75259e753adc71d842c598f325b0dfa8731d682f09d7d47 url=/tableau/current/pt-br/server/trouble_command_timeout.md -->

[Pular para o conteúdo principal](#main-content)

# Tempo limite do comando do Tableau Services Manager (TSM)

Quando o Tableau Server for configurado com duas instâncias do repositório e ocorrer o failover para o repositório de backup, o TSM tentará reiniciar o repositório original para que ele fique disponível como um backup. Se isso não puder ser feito por algum motivo, os comandos do TSM subsequentes poderão falhar devido a tempos limite e aguardarão a recuperação do repositório original.

Dentre os comandos que podem ser afetados, estão:

- tsm maintenance restore
- tsm maintenance reindex-search
- tsm reset
- tsm security regenerate-internal-tokens
- tsm sites export
- tsm sites import

Se algum desses comandos falhar e você tiver um repositório que não está em recuperação, remova o repositório da topologia do servidor, aplique as alterações pendentes e inclua-o novamente.

<!-- document id=0c2fa10ff71445cf2581fc88c6f9db37f11cb3aa6e30ca79296b1fcafd052e24 url=/tableau/current/pt-br/server/trusted_auth_trouble_wrongIP.md -->

[Pular para o conteúdo principal](#main-content)

# Tentativa de resgatar o ticket do endereço IP incorreto

Ao configurar o Tableau Server para autenticação confiável, você pode encontrar problemas para resgatar o tíquete.

Esse problema pode ocorrer quando o Tableau Server é configurado para impor a correspondência de endereço IP do cliente. Como o endereço IP do navegador da Web do cliente não é considerado por padrão ao resgatar o tíquete, certifique-se de que o endereço IP do navegador da Web do cliente enviado na solicitação POST ao Tableau Server é o mesmo, quando o navegador tenta recuperar a exibição incorporada.

Por exemplo, no diagrama Autenticação confiável, se a [solicitação POST na etapa 3](https://help.tableau.com/current/server/pt-br/trusted_auth.htm) enviar o parâmetro `client_ip=74.125.19.147`, a [solicitação GET na etapa 5](https://help.tableau.com/current/server/pt-br/trusted_auth.htm) deverá vir do mesmo endereço IP.

Para obter mais informações, consulte [Opcional: Configurar a correspondência de IP do cliente](https://help.tableau.com/current/server/pt-br/trusted_auth_optional.htm) para saber como configurar o Tableau Server de modo que ele adote a correspondência do endereço IP do cliente.

<!-- document id=40f366380aaf01221b815ee39c8440180de20ae2cb6251f8bd6ce1845f9b856c url=/tableau/current/pt-br/server/sug_test.md -->

[Pular para o conteúdo principal](#main-content)

# Testar a atualização

A melhor forma de saber qual efeito uma atualização do Tableau Server terá em seu ambiente atual, é testá-la. Saber como uma atualização afetará seus usuários e seu servidor o ajuda a planejar e comunicar antes da atualização propriamente dita, assegurando que seus usuários não serão pegos de surpresa.

Se tiver um ambiente de teste do Tableau Server, esse é um ótimo lugar para testar a atualização.

Recomendamos a seguinte sequência para testar uma atualização do Tableau Server:

1. [Preparar um ambiente de teste](#create-test-environment)
2. [Atualizar o ambiente de teste](#upgrade-test-environment)
3. [Confirme que a funcionalidade existente funciona](#confirm-existing-functionality)
4. [Teste de desempenho e aceitação do usuário](#Performance-and-user-acceptance-testing)
5. [Testar os novos recursos](#test-new-features)
6. [Comunicar sobre a atualização](#communicate)

## Preparar um ambiente de teste

Para começar, crie um ambiente de teste que reproduza seu ambiente de produção da forma mais próxima possível. Quanto mais próximo seu ambiente de teste for do ambiente real a ser atualizado, mais precisa será a representação de como a atualização o afetará. Isso inclui hardware e sistemas operacionais semelhantes ou idênticos, assim como as mesmas opções de autenticação e acesso de rede.

Quando você tem um computador de teste ou uma máquina virtual pronta, siga estas etapas para criar um ambiente de teste.

1. No ambiente de produção existente, crie um backup do Tableau Server usando o comando `[tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm)`.
    
    Para obter mais informações, consulte [Criar um backup de pré-atualização](https://help.tableau.com/current/server/pt-br/db_backup.htm#Creating2).
2. Em seu ambiente de teste, instale uma cópia da mesma versão do Tableau Server que existe em seu ambiente de produção.
    
    **Observação:** é possível baixar o programa de instalação da versão atual no [Site de downloads alternativos](http://www.tableau.com/pt-br/support/esdalt).
3. Restaure os dados existentes do banco de dados usando o comando `[tsm maintenance restore](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm3)`.
    
    Para obter mais informações, consulte [Restaurar de um backup](https://help.tableau.com/current/server/pt-br/db_restore.htm).
4. Replique manualmente sua configuração existente do Tableau Server.
    
    Você precisará configurar manualmente determinados aspectos de seu ambiente, pois ao restaurar o banco de dados do Tableau ele não inclui os detalhes e as personalizações da configuração.

## Atualizar o ambiente de teste

Siga as etapas apropriadas para atualizar o ambiente de teste:

- [Atualização do Tableau Server (Windows)](https://help.tableau.com/current/server/pt-br/sug_plan.htm)

## Confirmar que tudo está funcionando como esperado

Depois que a nova versão do Tableau Server for instalada e configurada em seu ambiente de teste, tudo estará pronto para o teste. É necessário testar a funcionalidade básica, juntamente com quaisquer aspectos especiais do servidor nos quais sua organização confia. Por exemplo, se houver inscrições importantes em que sua organização confia, elas deverão ser testadas.

Estas são algumas áreas de teste a considerar:

- **Processos de servidor**. Faça logon no Tableau Server como administrador de servidor e abra a página Status do servidor para confirmar que todos os serviços e todos os processos estejam executando como esperado (incluindo em todos os nós adicionais caso essa seja uma instalação distribuída).
- **Acesso de usuário**. Confirme se os usuários do Tableau Server podem se conectar. Teste seu processo normal de logon de usuário. Peça que alguns de seus usuários participem do teste para ter certeza de que eles conseguem se conectar como esperado e que eles possam acessar o mesmo conteúdo ao qual têm acesso em seu ambiente de produção.
- **Publicação de pastas de trabalho e fontes de dados**. Peça que usuários publiquem pastas de trabalho e fontes de dados do Tableau Desktop para certificar-se de que isso aconteça como esperado.
- **Visualizar pastas de trabalho publicadas**. Peça a usuários com familiaridade com o conteúdo, que tentem visualizar pastas de trabalho publicadas para ter certeza de que elas são exibidas como esperado. Teste as exibições incorporadas a páginas da Web (por exemplo, em páginas do SharePoint).
- **Inscrições e atualizações de extração**. Execute manualmente algumas atualizações de extração para confirmar que elas são concluídas com êxito. Execute algumas atualizações de extração importantes agendadas para confirmar se elas são concluídas como esperado.
- **Permissões**. Confirme se as permissões ainda estão definidas como esperado para usuários e conteúdo.
- **Utilitários da linha de comando e APIs**. Se aplicável, teste os utilitários de linha de comando (TSM e tabcmd) e o acesso programático por APIs.

## Teste de desempenho e aceitação do usuário

Use ferramentas como Tabjolt, Replayer e Scout para fazer o teste de desempenho e aceitação de usuário no seu ambiente de teste. Para obter mais informações sobre essas e outras ferramentas de teste de desempenho, consulte [Ferramentas de monitoramento de desempenho](https://help.tableau.com/current/server/pt-br/perf_resources.htm).

## Testar os novos recursos

Observe os novos recursos que acompanham a versão para a qual você está atualizando e os recursos que foram adicionados entre a versão atual e a nova versão. Considere como ajudar seus usuários a entender os benefícios dos recursos que se aplicam a seu ambiente.

Para obter mais informações sobre novos recursos, consulte [Notas de versão do Tableau Server](https://help.tableau.com/current/server/pt-br/whatsnew_server.htm)..

## Comunicar sobre a atualização

A melhor forma de fazer com que uma atualização corra sem problemas, é avisar à sua empresa antecipadamente sobre a atualização e como isso poderá afetá-los. Caso usuários já tenham ajudado a testar, aproveita a experiência deles fazendo com que eles ajudem a comunicar as alterações que presenciaram durante o teste. Você também pode oferecer acesso de usuário ao ambiente de teste se houver pessoas importantes que devam ver a versão atualizada antes da atualização propriamente dita.

<!-- document id=fba374e2870dd74d2eddc9639dda0a0ec39a3f97197887335c956ce5805caa0c url=/tableau/current/pt-br/server/dm_vconn_test_preview.md -->

[Pular para o conteúdo principal](#main-content)

# Testar a segurança em nível de linha com visualização como usuário

Use o Visualizar como usuário para testar sua política de dados. Você pode ver os dados como o usuário e garantir que a segurança em nível de linha esteja funcionando conforme o esperado. Isso ajuda quando a política de dados impede que você veja as linhas da tabela (por exemplo, se apenas os vendedores podem ver as linhas e você não é um vendedor).

Para visualizar os dados quando a política de dados for aplicada:

1. Selecione a tabelas.
2. Na seção Detalhes da tabela, marque a caixa de seleção Com política aplicada.
3. Clique em Visualizar como usuário, selecione um Grupo (opcional) e um Usuário.
4. Verifique se a política mostra os dados corretos para esse usuário nos detalhes da tabela.
5. Repita para outros usuários conforme necessário.

> [!TIP]
> 
> **Dica:** em Detalhes da tabela, clique em ![Ícone Painel que mostra o intervalo de valores em uma coluna para uma política de dados.](/tableau/current/pt-br/server/pt-br/Img/ipa_Panes_show_16px_medium.png) para mostrar o intervalo de valores de uma coluna, incluindo quais valores são exibidos e quais são filtrados pela política de dados. Selecione uma ou duas colunas que sejam bons indicadores de que a política está filtrando os dados corretamente.

## Quem pode fazer isso

Para testar uma conexão virtual, você deve

- ter credenciais para o banco de dados ao qual a conexão virtual se conecta e
- ser um servidor ou administrador de site ou um Creator.

## Próxima etapa

Depois de testar a política de dados, quando estiver pronto para compartilhar a conexão virtual com outras pessoas, consulte [Publicar uma conexão virtual e definir permissões](https://help.tableau.com/current/server/pt-br/dm_vconn_publish_save.htm).

<!-- document id=da96e3f2bba5076f69b87567a526352f22d747e9d74bd0d5040cc445444e9252 url=/tableau/current/pt-br/server/explain_data_explanation_types.md -->

[Pular para o conteúdo principal](#main-content)

# Tipos de explicação em Explique os dados

Cada vez que você seleciona uma nova marca em uma visualização ou painel e executa Explique os dados, o Tableau executa uma nova análise estatística considerando essa marca e os dados subjacentes na pasta de trabalho. As possíveis explicações são exibidas em seções expansíveis no painel Guia de dados. Para obter informações sobre como Explque os dados analisa e avalia as explicações, consulte [Como funciona o Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_explained.htm).

## Explorar os valores subjacentes

A seção lista as explicações para cada medida que pode ser explicada (chamadas de _medidas de destino_). Cada explicação listada aqui descreve uma relação com os valores da medida-alvo que são testados na marca analisada. Use a compreensão prática e do mundo real dos dados para determinar se os relacionamentos encontrados por Explique os dados são significativos e se vale a pena explorá-los.

![Detalhes do Explique os dados sobre uma marca analisada, com texto destacado que descreve um valor de soma de distância de viagem maior que o esperado de 8.800.](/tableau/current/pt-br/server/pt-br/Img/explaindata_targetmeasure.png)

Neste exemplo, a distância da viagem é a medida alvo

### Características subjacentes

Essas explicações descrevem como os registros subjacentes das marcas na exibição podem estar contribuindo para o valor agregado da medida que está sendo explicada. Os atributos de marca podem incluir [Valores extremos](#MA-Extreme), [Valores nulos](#MA-Null), [Número de registros](#MA-NR) ou o [Valor médio](#MA-AVG) da marca.

**Observação**: para obter as definições de termos comuns usados nas explicações, consulte [Termos e conceitos nas explicações](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm#TermsToKnow "Link para as definições dos termos e conceitos do Tableau usados nas explicações.").

#### Valores extremos

Este tipo de explicação indica se um ou mais registros têm valores que são significativamente maiores ou menores do que a maioria dos registros. Se a explicação for fundamentada em um modelo, isso indicará que o valor extremo está afetando a medida alvo da marca analisada.

Quando uma marca tem valores extremos, não significa que sejam valores atípicos ou que você deve excluir esses registros da exibição. Esta escolha é sua, dependendo da sua análise. A explicação simplesmente aponta um valor extremo na marca. Por exemplo, pode revelar um valor com digitação incorreta em um registro em que um custo da banana seja de 10 dólares em vez de 10 centavos. Ou pode revelar que um determinado vendedor tenha tido um bom trimestre.

**Observação**: essa explicação deve ser ativada pelo autor para ficar visível no modo de visualização de uma pasta de trabalho publicada. Para obter mais informações, consulte [Controle de acesso a Explique os dados](https://help.tableau.com/current/server/pt-br/explain_data_control_access.htm).

<table style="border-left-style: none;border-left-width: 6px;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>Esta explicação mostra:</b></p><ul><li>O número de registros subjacentes na marca analisada.</li><li>O valor ou valores extremos que contribuem para o valor da medida de destino.</li><li>A distribuição de valores na marca.</li><li>Os detalhes do registro que correspondem a cada valor de distribuição.</li></ul><p><b>Opções de exploração:</b></p><ul><li>Passe o mouse sobre um círculo no gráfico para ver seu valor correspondente.</li><li>Selecione a seta para a esquerda ou direita abaixo da lista de detalhes para rolar pelos detalhes do registro.</li><li>Se disponível, selecione <b>Exibir dados completos</b> e a guia <b>Dados completos</b> para ver todos os registros em uma tabela.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p style="font-weight: bold;">Próximas etapas para análise:</p><ul><li style="font-weight: normal;">Se o número de registros for baixo, examine esses valores em comparação com o valor extremo.</li><li style="font-weight: normal;">Se o valor extremo for significativamente maior ou menor do que os outros valores de registro, exclua-o e considere como ele altera o valor da marca analisada.</li><li style="font-weight: normal;">Ao considerar os dados com e sem o valor extremo, use isso como uma oportunidade para aplicar seu conhecimento prático sobre os dados.<br><br></li></ul></td><td>&nbsp;</td><td><p style="text-align: left;"><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_ev_dist.gif" alt="Neste exemplo, um único valor extremo de 463 horas alugadas está contribuindo para a soma maior do que o esperado do Tempo total alugado de 613 horas."></p><p>Neste exemplo, um único valor extremo de 463 horas alugadas está contribuindo para a soma maior do que o esperado do Tempo total alugado de 613 horas.</p><p>Um provável motivo para esse alto valor pode ser que alguém tenha esquecido de encaixar a bicicleta ao devolvê-la. Nesse caso, o autor pode querer excluir esse valor para análises futuras.</p><p>&nbsp;</p></td></tr><tr><td><h5>Visualizar a diferença</h5><p><b>Esta seção mostra:</b></p><ul><li>Como o valor da marca analisada muda quando o valor extremo é excluído.</li></ul><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p><b>Opções de exploração:</b></p><ul><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li><li>Explore a diferença com e sem o valor extremo (ou valores extremos).</li><li>Os autores podem abrir a exibição como uma nova folha e aplicar um filtro para excluir o valor extremo.</li></ul><p style="font-weight: bold;">Próximas etapas para análise:</p><ul><li>Se o valor extremo for significativamente maior ou menor do que os outros valores de registro, exclua-o e veja como ele altera o valor da marca analisada.</li><li>Ao considerar os dados com e sem o valor extremo, use isso como uma oportunidade para aplicar seu conhecimento prático sobre os dados.</li></ul></td><td>&nbsp;</td><td style="text-align: left;"><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_ev_vizthediff.png" alt="O cabeçalho Visualizar a diferença é exibido com um instantâneo de um mapa e um texto explicativo indicando que, quando o valor extremo é excluído, o valor muda de 619.3 para 155.5."><p><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_ev_vizthediff.gif" alt="Neste exemplo, quando o valor extremo de 483 é excluído, a marca analisada não é mais alta em comparação com outras marcas na exibição."></p><p>Neste exemplo, quando o valor extremo de 483 é excluído, a marca analisada não é mais alta em comparação com outras marcas na exibição. Outras marcas agora se destacam. O autor pode querer explorar as outras marcas para considerar por que esses outros locais têm mais horas de aluguel de bicicletas.</p></td></tr></tbody></table>

#### Valores nulos

O tipo de explicação Valores nulos chama a atenção para situações em que há uma quantidade maior do que o esperado de dados ausentes em uma marca. Ele indica a fração dos valores da medida de destino que são nulos, e como os valores nulos podem estar contribuindo para o valor agregado dessa medida.

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>Esta explicação mostra:</b></p><ul><li>A porcentagem de valores que são nulos na medida de destino para a marca analisada (círculo azul).</li></ul><p><b>Opções de exploração:</b></p><ul><li>Focalize cada círculo no gráfico de dispersão para ver os detalhes.</li><li>Role para ver mais do gráfico.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p style="font-weight: bold;">Próximas etapas para análise:</p><ul><li>Como opção, exclua os valores nulos da marca para análise posterior.</li></ul></td><td>&nbsp;</td><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/explain_data_nullvalues.png" alt="Um gráfico de dispersão com texto de Explique os dados explicando que a porcentagem de valores nulos pode estar contribuindo para o valor médio."></p><p>Neste exemplo, a porcentagem de valores nulos na medida de destino é mostrada como um círculo azul.</p></td></tr></tbody></table>

#### Número de registros

Este tipo de explicação descreve quando a contagem dos registros subjacentes está correlacionada à soma. A análise encontrou uma relação entre o número de registros que estão sendo agregados em uma marca e o valor real da marca.

Embora isso possa parecer óbvio, esse tipo de explicação ajuda a explorar se o valor da marca está sendo afetado pela magnitude dos valores em seus registros ou simplesmente por causa do número de registros na marca analisada.

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>Esta explicação mostra:</b></p><ul><li>O número de registros na medida de destino para a marca analisada (barra azul escura).</li><li>O número de registros na medida de destino para outras marcas na visualização de origem (barra azul claro).</li></ul><p><b>Opções de exploração:</b></p><ul><li>Focalize cada barra para ver os detalhes.</li><li>Role para ver mais do gráfico.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p style="font-weight: bold;">Próximas etapas para análise:</p><ul><li>Compare se os valores individuais dos registros são baixos ou altos, ou se o número de registros na marca analisada é baixo ou alto.</li><li>Autores, se você se surpreender com um grande número de registros, talvez seja necessário normalizar os dados.</li></ul></td><td>&nbsp;</td><td><p><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_nr.png" alt="Um gráfico de dispersão que mostra a relação entre a contagem e a soma das distâncias da viagem, com o texto de Explique os dados explicando que a soma das distâncias da viagem pode ser alta devido ao alto número de registros em agosto."></p><p>Neste exemplo, o número de registros para Distância de viagem é listado para cada valor de Mês de viagem, que é uma dimensão na visualização original. Agosto tem o maior valor de distância total da viagem.</p><p>Você pode explorar se agosto tem o valor mais alto para a distância da viagem, porque mais viagens ocorreram em agosto ou se tem a distância mais alta porque algumas viagens foram mais longas.</p></td></tr></tbody></table>

#### Valor médio da marca

Este tipo de explicação descreve quando a média de uma medida está correlacionada à soma. Compare se o valor médio é baixo ou alto, ou se o número de registros é baixo ou alto.

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>Esta explicação mostra:</b></p><ul><li>A média da medida de destino para cada valor de uma dimensão usada na visualização de origem.</li></ul><p><b>Opções de exploração:</b></p><ul><li>Focalize cada barra para ver os detalhes.</li><li>Role para ver mais do gráfico.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p><b>Próximas etapas para análise:</b></p><ul><li>Compare se o valor médio é baixo ou alto, ou se o número de registros é baixo ou alto. Por exemplo, os lucros são altos porque você vendeu muitos itens ou porque vendeu itens caros?</li><li>Tente descobrir por que a marca analisada tem um valor médio significativamente maior ou menor.</li></ul><p>&nbsp;</p></td><td>&nbsp;</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_ar_ctr.png" alt="Dimensão Distância média da viagem selecionada com uma explicação de que a distância média da viagem está aumentando a soma esperada da distância da viagem para a marca explicada."><p>Neste exemplo, a distância média da viagem em agosto não é significativamente maior ou menor do que a maioria dos meses. Isso sugere que a distância da viagem é maior em agosto porque houve mais viagens em agosto, em vez de pessoas fazendo viagens mais longas.</p></td></tr></tbody></table>

### Valor único contribuinte

Use esta explicação para entender a composição dos valores de registro que constituem a marca analisada.

Este tipo de explicação identifica quando um único valor em uma dimensão não visualizada pode estar contribuindo para o valor agregado da marca analisada. Uma dimensão oculta é uma dimensão que existe na fonte de dados, mas não está sendo usada na exibição.

Esta explicação indica quando cada registro subjacente de uma dimensão tem o mesmo valor, ou quando um valor de dimensão se destaca porque muitos ou poucos dos registros têm o mesmo valor único para a marca analisada.

**Observação**: para obter as definições de termos comuns usados nas explicações, consulte [Termos e conceitos nas explicações](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm#TermsToKnow "Link para as definições dos termos e conceitos do Tableau usados nas explicações.").

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>Esta explicação mostra:</b><ul><li>A porcentagem do número de registros para um único valor de uma dimensão para a marca analisada (barra azul) versus todas as marcas (barra cinza) na visualização de origem.</li><li>A porcentagem do número de registros para todos os outros valores de uma dimensão para a marca analisada (barra azul) versus todas as marcas (barra cinza) na visualização de origem.</li><li>A média da medida de destino para o valor único de uma dimensão na marca analisada (barra azul) versus todas as marcas (barra cinza).</li><li>A média da medida de destino para todos os outros valores de uma dimensão para a marca analisada (barra azul) versus todas as marcas (barra cinza) na visualização de origem.</li></ul><p><b>Opções de exploração:</b></p><ul><li>Focalize cada barra para ver os detalhes.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p><b>Próximas etapas para análise:</b></p><ul><li>Use esta explicação para entender a composição dos valores de registro que constituem a marca analisada.</li><li>Os autores podem querer criar uma nova visualização para explorar qualquer dimensão não visualizada apresentada nesta explicação.</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_rsv_ctr.png" alt="Detalhes do Explique os dados para uma marca selecionada com gráficos de barras mostrando registros que afetam o valor."><p>Neste exemplo, a análise estatística revelou que muitas das viagens vêm das adjacências da estação de Back Bay. Observe que as adjacências da estação é uma dimensão não visualizada que tem alguma relação com a distância da viagem nos dados subjacentes para a visualização de origem.</p></td></tr></tbody></table>

### Colaboradores principais

Use esta explicação para ver os valores que compõem a maior fração da marca analisada.

Para uma agregação COUNT, os colaboradores principais mostram valores de dimensão com mais registros. Para SUM, esta explicação mostra valores de dimensão com a maior soma parcial.

### Dimensões contribuintes

Use esta explicação para entender a composição dos valores de registro que constituem a marca analisada.

Este tipo de explicação mostra que a distribuição de uma dimensão não visualizada pode estar contribuindo para o valor agregado da marca analisada. Esse tipo de explicação é usado para somas, contagens e médias da medida de destino. Uma dimensão oculta é uma dimensão que existe na fonte de dados, mas não está sendo usada na exibição.

**Observação**: para obter as definições de termos comuns usados nas explicações, consulte [Termos e conceitos nas explicações](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm#TermsToKnow "Link para as definições dos termos e conceitos do Tableau usados nas explicações.").

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>Esta explicação mostra:</b><ul><li>A porcentagem do número de registros para todos os valores de uma dimensão da marca analisada (barra azul) versus todos os valores de uma dimensão de todas as marcas (barra cinza) na visualização de origem.</li><li>A média da medida de destino para todos os valores de uma dimensão da marca analisada (barra azul) de uma dimensão de todas as marcas (barra cinza).</li></ul><p><b>Opções de exploração:</b></p><ul><li>Focalize cada barra para ver os detalhes.</li><li>Role para ver mais do gráfico.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p><b>Próximas etapas para análise:</b></p><ul><li>Use esta explicação para entender a composição dos valores de registro que constituem a marca analisada.</li><li>Os autores podem querer criar uma nova visualização para explorar quaisquer dimensões não visualizadas apresentadas nesta explicação.</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_rd_ctr.png" alt="Detalhes do Explique os dados para uma marca selecionada e sua distribuição."><p>Neste exemplo, a análise estatística expôs que mais viagens foram feitas nas estações de South Station and MIT e menos viagens foram obtidas de Charles Circle, em comparação com as viagens feitas para as marcas em geral.</p><p>Observe que Nome da estação é uma dimensão não visualizada que tem alguma relação com a Distância da viagem nos dados subjacentes para a visualização de origem.</p></td></tr></tbody></table>

### Medidas contribuintes

Este tipo de explicação mostra que a média de uma medida não visualizada pode estar contribuindo para o valor agregado da marca analisada. Uma medição não visualizada é uma medida que existe na fonte de dados, mas não está sendo usada na exibição.

Essa explicação pode revelar uma relação linear ou quadrática entre a medida não visualizada e a medida de destino.

**Observação**: para obter as definições de termos comuns usados nas explicações, consulte [Termos e conceitos nas explicações](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm#TermsToKnow "Link para as definições dos termos e conceitos do Tableau usados nas explicações.").

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>Esta explicação mostra:</b><ul><li>A relação entre a soma da medida de destino e a média de uma medida não visualizada da marca analisada (círculo azul) e todas as marcas (círculos cinza) na visualização.</li><li>Se a soma da medida de destino for alta ou baixa, porque o valor médio da medida não visualizada é alto ou baixo.</li></ul><p><b>Opções de exploração:</b></p><ul><li>Focalize cada círculo para ver os detalhes.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p><b>Próximas etapas para análise:</b></p><ul><li>Os autores podem querer criar uma nova visualização para explorar quaisquer medidas não visualizadas apresentadas nesta explicação.</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_rm_ctr.png" alt="Detalhes de Explique os dados para uma medida selecionada."><p>Neste exemplo, uma possível razão pela qual a distância da viagem é alta é porque o tempo total médio alugado também é alto.</p></td></tr></tbody></table>

## Outros recursos a explorar

Esta seção fornece os possíveis motivos pelos quais a marca analisada é única ou incomum. Essas explicações:

- Não justifique o valor desta marca.
- Não estão relacionadas com o valor das medidas na visualização de origem.
- Não leve em consideração nenhuma medida de destino.

### Outras dimensões de interesse

Use esta explicação para entender a composição dos valores de registro que constituem a marca analisada.

A distribuição de uma dimensão não visualizada na marca analisada é incomum em comparação com a distribuição de valores para todas as outras marcas na exibição. Uma dimensão oculta é uma dimensão que existe na fonte de dados, mas não está sendo usada na exibição.

**Observação**: para obter as definições de termos comuns usados nas explicações, consulte [Termos e conceitos nas explicações](https://help.tableau.com/current/server/pt-br/explain_data_basics.htm#TermsToKnow "Link para as definições dos termos e conceitos do Tableau usados nas explicações.").

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>Esta explicação mostra:</b><ul><li>A porcentagem do número de registros para todos os valores de uma dimensão da marca analisada (barra azul) versus todos os valores de uma dimensão de todas as marcas (barra cinza) na visualização de origem.</li></ul><p><b>Opções de exploração:</b></p><ul><li>Focalize cada barra para ver os detalhes.</li><li>Role para ver mais do gráfico.</li><li>Selecione o ícone <span class="uicontrol">Abrir</span>&nbsp;<img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_openviewicon.png" alt="Ícone Abrir exibição.">&nbsp;para ver uma versão ampliada da visualização.</li></ul><p><b>Próximas etapas para análise:</b></p><ul><li>Use esta explicação para entender a composição dos valores de registro que constituem a marca analisada.</li><li>Os autores podem querer criar uma nova visualização para explorar quaisquer dimensões não visualizadas apresentadas nesta explicação.</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/current/server/pt-br/Img/explaindata_exp_rd_tvd.png" alt="Detalhes de Explique os dados para outras dimensões de interesse."><p>Neste exemplo, uma alta porcentagem de registros está associada ao tempo nublado. Como os dados se referem ao aluguel de bicicletas em Boston, e a marca analisada é a Distância da viagem para agosto, podemos presumir que o clima é geralmente quente e úmido. As pessoas podem ter alugado bicicletas com mais frequência em dias nublados para evitar o calor. Também é possível que tenha havido mais dias nublados em agosto.</p></td></tr></tbody></table>

<!-- document id=28139198b435d01c419a5c20d3d01b2e055b2808a0b0e427fcf98d0f74748ef6 url=/tableau/current/pt-br/server/security_personal_access_tokens.md -->

[Pular para o conteúdo principal](#main-content)

# Tokens de acesso pessoal

Os tokens de acesso pessoal (PATs) fornecem a você e aos seus usuários do Tableau Server a capacidade de criar tokens de autenticação de longa duração. Os PATs permitem que você e seus usuários façam logon na API REST do Tableau sem exigir credenciais codificadas (nome de usuário e senha) ou logon interativo. Para obter mais informações sobre como usar PATs com a API REST do Tableau, consulte [Entrar e sair (autenticação)](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm) na Ajuda da API REST do Tableau.

É recomendável criar PATs para tarefas e scripts automatizados criados com a API REST do Tableau:

- **Melhorando a segurança**: os tokens de acesso pessoal reduzem os riscos caso as credenciais sejam comprometidas. No caso em que o Tableau Server usa o Active Directory ou o LDAP como um armazenamento de identidades, você pode reduzir o impacto de comprometimento das credenciais usando um token de acesso pessoal para tarefas automatizadas. Se um token for comprometido ou usado na automação com falha ou causar risco, você poderá revogar o token. Não é necessário girar ou revogar as credenciais do usuário.
- **Auditoria e rastreamento**: como administrador, você pode consultar os registros do Tableau Server para rastrear quando um token é usado, quais sessões são criadas desse token e as ações executadas nessas sessões. Além disso, você pode determinar se uma sessão e as tarefas relacionadas foram executadas a partir de uma sessão gerada com um token ou de um logon interativo.
- **Gerenciar automação**: um token pode ser criado para cada script ou tarefa executada. Isso permite que você crie silos e analise tarefas de automação em toda a organização. Além disso, usar tokens e as alterações de senha ou alterações de metadados (nome de usuário, e-mail etc.) em contas de usuário não prejudicará a automação como faria quando as credenciais são inseridas em código nos scripts.

**Observações:** 

- Para usar PATs com tabcmd, instale a versão compatível do tabcmd em [https://tableau.github.io/tabcmd/](https://tableau.github.io/tabcmd/).
- Os PATs não são usados para acesso de cliente genérico à IU na Web do Tableau Server ou ao TSM.
- A configuração da expiração de PATs e a desabilitação ou limitação do acesso dos usuários à criação de PATs a partir da IU estão disponíveis apenas no Tableau Cloud.
- Os PATs são automaticamente revogados quando um [método de autenticação do usuário](https://help.tableau.com/current/server/pt-br/users_set_auth_type.htm) foi alterado.

## Noções básicas sobre tokens de acesso pessoal

Quando um token de acesso pessoal (PAT) é criado, ele é ocultado e armazenado no repositório. Depois que o PAT é ocultado e armazenado, o segredo do PAT é mostrado uma vez para o usuário e não pode mais ser acessado depois que os usuários fecham a caixa de diálogo. Portanto, os usuários são instruídos a copiar o PAT em um local seguro e lidar com ele como lidam com uma senha. Quando o PAT é usado no tempo de execução, o Tableau Server compara o PAT apresentado pelo usuário com o valor ocultado armazenado no repositório. Se houver uma correspondência, uma sessão autenticada será iniciada.

No contexto da autorização, a sessão do Tableau Server que é autenticada com um PAT tem o mesmo acesso e privilégios que o proprietário do PAT.

**Observação:** os usuários não podem solicitar sessões simultâneas do Tableau Server com um PAT. Entrar novamente com o mesmo PAT, seja no mesmo site ou em um site diferente, encerrará a sessão anterior e resultará em um erro de autenticação.

## Representação do administrador de servidor

A partir da versão 2021.1, você pode ativar a representação de PAT do Tableau Server. Neste cenário, os PATs criados pelos administradores do servidor podem ser usados para a [representação do usuário](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#impersonating_a_user) ao usar a API REST do Tableau. A representação é útil em cenários onde você está inserindo conteúdo do Tableau específico para o usuário final dentro de seu aplicativo. Especificamente, os PATs de representação permitem que você crie aplicativos que consultam como um determinado usuário e recuperam o conteúdo para o qual o usuário está autorizado no Tableau Server, sem codificar nenhuma credencial.

Para obter mais informações, consulte [Representar um usuário](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#impersonating_a_user) na Ajuda da API REST do Tableau.

### Habilite o Tableau Server a aceitar tokens de acesso pessoal durante solicitações de logon de representação

Por padrão, o Tableau Server não permite a representação de PATs do administrador do servidor. Você deve ativar a configuração em todo o servidor executando os seguintes comandos.

`tsm authentication pat-impersonation enable [global options]`

`tsm pending-changes apply`

**Importante**: depois de executar os comandos, todos os PATs criados pelos administradores de servidor (incluindo PATs preexistentes) podem ser usados para representação. Para revogar em massa todos os PATs do administrador de servidor existentes, você pode publicar o URI `DELETE /api/{api-version}/auth/serverAdminAccessTokens`. Para obter mais informações, consulte [Representar um usuário](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#impersonating_a_user) na Ajuda da API REST do Tableau.

## Criar tokens de acesso pessoal

Os usuários devem criar seus próprios PATs. Os administradores não podem criar PATs para usuários.

Os usuários com contas no Tableau Server podem criar, gerenciar e revogar tokens de acesso pessoal (PATs) na página Minhas configurações de conta. Consulte [Gerenciar configurações de conta](https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm) na Ajuda do usuário do Tableau para obter mais informações.

**Observação:** um usuário pode ter até 10 PATs.

## Alterar a expiração dos tokens de acesso pessoal

Os tokens de acesso pessoal (PATs) vão expirar se não forem usados após 15 dias consecutivos. Se eles forem usados com mais frequência do que a cada 15 dias, os PATs vão expirar após um ano. Após um ano, novos PATs devem ser criados. Os PATs expirados não serão exibidos na página Minhas configurações de conta.

Você pode alterar o período de expiração dos PATs usando a opção [refresh\_token.absolute\_expiry\_in\_seconds](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#refresh) com o comando `tsm configuration set`.

## Revogar um token de acesso pessoal

Como administrador, você também pode revogar o PAT de um usuário. Um usuário também pode revogar seus tokens de acesso pessoal (PATs) na página Minhas configurações de conta usando o procedimento descrito no tópico [Gerenciar sua conta](https://help.tableau.com/current/pro/desktop/pt-br/useracct.htm#pat) na Ajuda do usuário do Tableau.

1. Entre no Tableau Server como um administrador de servidor ou de site.
2. Localize o usuário cujo PAT você deseja revogar. Para obter mais informações sobre como navegar nas páginas de administração do servidor e localizar usuários, consulte [Exibir, gerenciar ou remover usuários](https://help.tableau.com/current/server/pt-br/users_view.htm).
3. Clique no nome do usuário para abrir sua página de perfil.
4. Na página de perfil do usuário, clique na guia Configurações.
5. Na seção Tokens de acesso pessoal, identifique o PAT que deseja revogar e clique em Revogar.
6. Na caixa de diálogo, clique em Excluir.

## Rastrear e monitorar o uso do token de acesso pessoal

Todas as ações relacionadas ao token de acesso pessoal (PAT) são registradas no serviço do [Servidor de aplicativos do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_application-server.htm) (vizportal). Para localizar atividades relacionadas ao PAT, filtre as entradas de registro que contêm a cadeia de caracteres, `RefreshTokenService`.

Um PAT é armazenado neste formato:`Token Guid: <TokenID(Guid)>`, onde TokenID é uma cadeia de caracteres codificada base64. O valor do segredo não está incluído nos registros.

Por exemplo:

`Token Guid: 49P+CxmARY6A2GHxyvHHAA== (e3d3fe0b-1980-458e-80d8-61f1caf1c700)`.

Veja a seguir um trecho de exemplo de duas entradas de registro. A primeira entrada mostra como um usuário é mapeado para um PAT. A segunda entrada mostra um evento de atualização para o mesmo PAT:

RefreshTokenService - Issued refresh token to the following user: jsmith. Token Guid: 49P+CxmARY6A2GHxyvHHAA== (e3d3fe0b-1980-458e-80d8-61f1caf1c700)
RefreshTokenService - Redeemed refresh token. Token Guid: 49P+CxmARY6A2GHxyvHHAA== (e3d3fe0b-1980-458e-80d8-61f1caf1c700)

Para localizar as operações principais, filtre as entradas de registro que contêm a cadeia de caracteres, `OAuthController`.

<!-- document id=8f9047eb2ffd83f0d5c9add0435eff282c1ff09e7ba19a24a8d2d97bec376b72 url=/tableau/current/pt-br/server/ts_aws_topology.md -->

[Pular para o conteúdo principal](#main-content)

# Topologia do Tableau Server na AWS

## Este é um conteúdo arquivado

As implantações em nuvens públicas continuam a ter suporte, mas o conteúdo para implantações de nuvens públicas de terceiros não é mais atualizado.

Para obter o conteúdo de implantação mais recente do Tableau Server, consulte a seção [Implantar](https://help.tableau.com/current/server/pt-br/install.htm) da ajuda do Tableau Server.

Para os clientes que têm acesso, recomendamos Tableau Cloud. Para obter mais detalhes, consulte:

- [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm)
- [Avaliação do Tableau Cloud para administrador](https://help.tableau.com/current/server-linux/pt-br/install.htm)
- [Tableau Cloud: Introdução ao administrador](https://www.tableau.com/pt-br/learn/get-started/online-admin)

## Introdução

Ao implantar o Tableau Server na AWS, é possível escolher o nível e a profundidade da integração entre o Tableau Desktop e o Tableau Server nas suas instâncias EC2 da Amazon. É possível usar o Tableau Desktop e sua habilidade de extrair dados das fontes de dados para agir como uma ponte entre os dados e o Tableau Server. Baseado nas suas necessidades, ou se você já tiver muitos dados na nuvem do AWS, em vez disso é possível escolher potencializar toda a gama de serviços do AWS em conjunto com o Tableau Server. O seguinte diagrama mostra a integração da fonte de dados com o Tableau Desktop e o Tableau Server.

![Um diagrama do processo de transformação de dados brutos para acesso do usuário por meio do Tableau Desktop e uma máquina virtual baseada na nuvem.](/tableau/current/pt-br/server/pt-br/Img/tableau_cloud_topology.png)

No seguinte diagrama, todos os dados estão hospedados na AWS. É possível analisar dados estruturados e não estruturados gerenciados de maneira segura e escalável. É possível potencializar apenas os dados que residem na AWS, os dados não gerenciados que vivem fora da AWS ou uma combinação de ambos. Essa flexibilidade aumenta em muito a habilidade da sua empresa de oferecer suporte a migrações para a nuvem a partir de dados locais, já que os dois tipos de dados possuem igual suporte.

![Um diagrama ilustrando o processo de coleta, armazenamento, análise e visualização de dados com dados da AWS.](/tableau/current/pt-br/server/pt-br/Img/tableau_aws_data_sources.png)

<!-- document id=12ed74fb677dd5369913c969fb243ff049fb4bc2bba555b845d64949c95ca871 url=/tableau/current/pt-br/server/logs_working_with.md -->

[Pular para o conteúdo principal](#main-content)

# Trabalhar com arquivos de log

Criar arquivos de registro é uma parte regular das atividades do Tableau Server. Os arquivos de registro do servidor podem ser necessários ao solucionar problemas com o Tableau Server ou se o Suporte do Tableau solicitar os registros para ajudar a resolver um problema.

É possível criar um arquivo de registro compactado por meio do comando `[tsm maintenance ziplogs](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm4ziplogs)`. O arquivo compactado contém cópias dos registros que podem ser descompactadas e examinadas ou enviadas para o Suporte do Tableau. Depois de criar uma cópia do arquivo, você pode excluir o arquivo do servidor. Para obter mais informações sobre arquivos de registro, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).

Este conjunto de tópicos fornece informações sobre como criar arquivo de logs, o conteúdo de arquivos de registro específicos e detalhes sobre quando e como verificar um log.

## Conteúdo de registros do Tableau Server

Todos os processo do Tableau Server grava informações sobre o que está fazendo com seu próprio arquivo de registro. Cada um fornece informações detalhadas sobre as ações de cada processo. Juntos, esses arquivos de registro contêm informações detalhadas sobre a comunicação interna entre componentes do Tableau Server enquanto processam as solicitações dos usuários ou executam tarefas automatizadas. Os registros do Tableau Server contêm apenas informações técnicas úteis para a solução de problemas; o status de diferentes componentes, as ações tomadas por diferentes processos, as tentativas de comunicação, as consultas ao banco de dados (sem incluir resultados) e os tempos de solicitações, por exemplo.

Os arquivos de registro podem conter alguns dados específicos, como nomes de servidores de banco de dados, bem como seus endereços e portas IP, nomes ou endereços IP dos computadores do Tableau Server e URLs e nomes das pastas de trabalho e exibições acessadas pelos usuários.

Os arquivos de registro não contêm dados confidenciais do cliente, como senhas, resultados das consultas ou dados mostrados nas exibições.

**Observação:** ao fazer login no`DEBUG` nível, as informações completas do ambiente são coletadas quando o Tableau é iniciado. Isso significa que, se você tiver informações confidenciais em uma variável de ambiente, elas poderão ser incluídas em um registro. Registrar no nível `INFO` padrão apenas reúne informações de ambiente seguro.

O comando `tsm maintenance ziplogs` permite que os usuários não apenas gerem um arquivo compactado com arquivos de registro, mas também incluam dados do repositório do Tableau Server se a opção `-d` for especificada. O repositório contém metadados do Tableau Server (por exemplo, nomes de usuário, grupos, projetos, permissões no Tableau Server, agendas de atualização de extração). O repositório também inclui informações de layout e conexão para as pastas de trabalho, mas não tem dados como senhas, dados reais do banco de dados ou dados mostrados na exibição.

Os dados mostrados em exibições vêm de arquivos de extração ou bancos de dados, e são armazenados em cache na memória. Eles não são salvos em registros ou, no caso de conexões em tempo real, em arquivos separados em computadores do Tableau Server. Os arquivos de extração são armazenados nos computadores do Tableau Server como arquivos `.hyper` na pasta `dataengine`, mas nunca são incluídos no arquivo de registro compactados

## Investigação de problemas do Tableau Server

A variedade e a complexidade de problemas possíveis no Tableau Server indicam que não existe um processo simples a ser usado na investigação de todos os problemas, e sim uma abordagem geral que inclui estas etapas:

1. **Apague** os arquivos de registro existentes para reduzir seu tamanho. Para obter mais informações, consulte [Remover arquivos desnecessários](https://help.tableau.com/current/server/pt-br/maintenance_cleanup.htm).
    
    **Importante:** se houver uma chance de obter ajuda do Suporte do Tableau para solucionar problemas, certifique-se de criar um arquivo compactado dos seus registros antes de limpá-los. A limpeza pode excluir informações importantes para o Suporte. Para obter detalhes sobre a criação de arquivos de registro, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).
2. **Defina o nível de registro apropriado**. Isso é algo que o Suporte do Tableau o instruirá a fazer. Para obter mais informações, incluindo o impacto de diferentes níveis de registro, consulte [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).
3. **Reproduza o problema** que você está solucionando para que os logs capturem os eventos relacionados ao problema.
4. **Crie um arquivo** dos registros. Para obter mais informações, consulte [Instantâneos do arquivo de log (Arquivar logs)](https://help.tableau.com/current/server/pt-br/logs_archive.htm).
    
    **Importante**: use esse arquivo ao examinar os arquivos de registro. É aconselhável não editar, mover ou excluir nenhum arquivo diretamente no servidor.
5. **Examine o log do controlador de administração do TSM** `\tabadmincontroller\tabadmincontroller_node<n>-<n>.log` para entender qualquer configuração ou implantação feita pelo TSM na linha de comando, UI da Web ou API, inclusive tarefas iniciadas pelo TSM. Comece com o log do controlador. É onde você obterá informações mais úteis.
    
    **Observação:** O `tsm.log` é menos prolixo que `tabadmincontroller_*.log`o, mas pode fornecer informações úteis e complementares de solução de problemas.
6. **Analise os registros do Apache** (`\httpd\access.####_##_##_##_##_##.log` e `\httpd\error.log`) por solicitações que possam estar relacionadas ao problema sendo investigado.
    
    Os logs do Apache conterão muito "ruído" que não se aplica a problemas que você está enfrentando.
    
    - Se você encontrar uma solicitação que pareça estar relacionada ao problema, procure no diretório `vizqlserver` por entradas que incluam a ID de solicitação exclusiva dos registros do Apache.
    - Procure o código de resposta e a mensagem associados à ID de solicitação.
    - Pesquise pelo nome da pasta de trabalho, exibição, painel ou fonte de dados que está relacionada ao seu problema. Procure um carimbo de data/hora pertinente.
    - Se encontrar uma solicitação que pareça estar relacionada ao seu problema, examine o código de resposta associado à solicitação. (200s são bons, 500s indicam problemas).
    - Localize a ID de solicitação exclusiva associada com a solicitação identificada (a ID de solicitação exclusiva é uma cadeia de 24 caracteres alfanuméricos no final da solicitação).
7. **Revise o arquivo de registro** mais detalhadamente para procurar por outras mensagens e possíveis erros.
    
    - Use a ID de solicitação dos logs do Apache para procurar a pasta `vizqlserver` do arquivo de log por arquivos que contêm entradas de registro relacionadas. Procure indicações de um problema (por exemplo, mensagens de erro ou consultas em execução há muito tempo)
    - A ferramenta gratuita de código aberto, Logshark, pode ser uma opção útil para revisar arquivos de registro. Para obter mais informações, consulte [Solucionar problemas do Tableau Server](https://help.tableau.com/current/blueprint/pt-br/bp_troubleshooting.htm#tableau-server) no Blueprint do Tableau.
8. **Analise o registro do script**.
    
    O Tableau Server inclui registros da maioria dos scripts incluídos no diretório de scripts. Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\` Esses registros são salvos em:
    
    - `<install_drive>\<install\path>\logs\`  
        por padrão:
    - `C:\ProgramData\Tableau\Tableau Server\logs\`
9. **Entre em contato com o suporte**
    
    Se você não conseguir resolver o problema por conta própria, ou se o Suporte do Tableau pedir, envie o arquivo compactado para o Tableau.

## Outros artigos nesta seção

<!-- document id=e89df921ce4ee727efac82b4d79eb323bb41644ad33ffaf6b274ea3aee367760 url=/tableau/current/pt-br/server/group_sets.md -->

[Pular para o conteúdo principal](#main-content)

# Trabalhar com conjuntos de grupos

A partir do Tableau Server 2024.2, você pode criar um contêiner para seus grupos usando conjuntos de grupos. Um conjunto de grupos pode conter um ou mais grupos e ser usado para aplicar regras mais granulares para permissões de conteúdo que dependem do conjunto de grupos. Ao ativar recursos com base em um conjunto de grupos, os usuários nos grupos que pertencem ao conjunto de grupos devem ser membros de todos os grupos para que o recurso seja avaliado. Dessa forma, os conjuntos de grupos impõem a lógica AND.

**Benefícios dos conjuntos de grupo:**

- Você pode misturar e combinar grupos sincronizados com grupos locais em regras de permissão para permitir cenários de controle de acesso mais dinâmicos.
- Use a lógica AND para grupos em regras de permissão, o que pode simplificar o controle de acesso em alguns cenários

**Observações:**

- As regras de permissão definidas por grupo são avaliadas após as regras de usuário e grupo. Para obter mais informações sobre essas regras, consulte [Avaliar regras de permissão](https://help.tableau.com/current/server/pt-br/permission_effective.htm#EvaluatePermRules).
- Conjuntos de grupos só podem ser criados por administradores de servidor.
- Os conjuntos de grupos não devem ser usados como um grupo de grupos.

## Ativar conjuntos de grupos

Antes que os conjuntos de grupos possam ser usados para permissões, as configurações dos conjuntos de grupos devem ser habilitadas.

1. Entre no Tableau Server como administrador de servidor.
2. Navegue até a página Configurações.
3. Na seção Conjuntos de grupos, marque a caixa de seleção Permitir conjuntos de grupos.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/abac_groupset_setting.png)

Depois de ativar os Conjuntos de grupos, uma página dedicada de Conjuntos de grupos é exibida no painel de navegação.

## Criar conjuntos de grupos

Para criar um conjunto de grupos, navegue até a página Conjuntos de grupos e crie um conjunto de grupos como faria com um grupo.

1. Entre no Tableau Server como administrador de servidor.
2. Navegue até a página Conjuntos de grupos e clique no botão Novos conjuntos de grupos.
3. Insisra um nome para o conjunto de grupos e clique em Criar.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/abac_groupset_create.png)
4. Na tabela Conjuntos de grupos, clique no nome do conjunto de grupos que você acabou de criar e clique no botão Adicionar grupos.
5. Na lista de grupos disponíveis, selecione os grupos que deseja adicionar ao conjunto de grupos e clique no botão Adicionar.
    
    ![](/tableau/current/pt-br/server/pt-br/Img/abac_groupset_add_groups.png)

## Definir permissões em conjuntos de grupos

Para usar conjuntos de grupos, como administrador do site, líder de projeto ou proprietário do conteúdo, adicione ou edite as permissões do conteúdo para usar o conjunto de grupos.

Por exemplo, suponha que você seja o proprietário da pasta de trabalho “Batedores”. Para aplicar permissões com base no conjunto de grupos, faça o seguinte:

1. Vá para a pasta de trabalho e selecione Permissões no menu de ações.
2. Na caixa de diálogo Permissões, clique no botão Adicionar regra de grupo/usuário e faça o seguinte:
    1. Na caixa de texto, insira o nome do conjunto de grupo, por exemplo “Todos os empreiteiros”.
    2. Selecione os recursos desejados no modelo.
    3. Clique em Salvar.
        
        ![](/tableau/current/pt-br/server/pt-br/Img/abac_groupset_permissions.png)

Quando as permissões são aplicadas usando o modelo de conjunto de grupos, você cria permissões que afetam os usuários que têm associação em _todos_ grupos no conjunto de grupos.

Por exemplo você pode restringir o acesso a diferentes exibições da pasta de trabalho com base na afiliação do grupo regional de um usuário. Suponha que você tenha usuários que são contratados, gerentes de contratados, funcionários em tempo integral e gerentes em tempo integral acessando essas visualizações de pasta de trabalho.

Grupos que têm permissões padrão para visualizar a pasta de trabalho: Todos, Norte, Sul, Leste, Oeste, Tempo Integral e Gerentes.

- Para a exibição detalhada da Região Norte:
    
    - As permissões são baseadas no conjunto de grupos: Região Norte
    - Grupos no conjunto de grupos: Tempo integral, Norte
    
    Resultado: somente funcionários em tempo integral e gerentes em tempo integral no norte podem ver os dados na exibição detalhada da região norte.
- Para a visualização detalhada de todas as regiões:
    
    - O conjunto de grupos é denominado Gerentes
    - Grupos no conjunto de grupos: Todos, Gerentes
    
    Resultado: somente gerentes de contratados e gerentes de tempo integral podem ver os dados na exibição detalhada de todas as regiões.

Para obter informações sobre permissões, consulte [Configurar projetos, grupos, conjuntos de grupos e permissões para o serviço de autoatendimento gerenciado](https://help.tableau.com/current/server/pt-br/projects_data_gov.htm)

<!-- document id=7af2e3cc39ff69951b6b4fa30f909e4e222d48beb3f03beae8f05042e795f6e3 url=/tableau/current/pt-br/server/tsm-jobs.md -->

[Pular para o conteúdo principal](#main-content)

# Trabalhos do Tableau Services Manager

Os trabalhos do TSM são tarefas administrativas que ajudam a configurar e manter o Tableau Server. Eles são executados pelo Tableau Services Manager.

Aqui estão alguns dos principais trabalhos do TSM:

- **Limpeza**: este trabalho é criado quando um comando cleanup é emitido para o Tableau Server. O comando cleanup exclui os arquivos de registro e os temporários. Para mais informações sobre o comando cleanup da CLI do TSM, consulte [tsm maintenance](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm-maintenance-cleanup).
- **Implantações**: este trabalho é criado para aplicar as atualizações de configuração que você fizer no Tableau Server. Isso pode ser iniciado pela interface na Web do TSM ou da CLI do TSM. Para obter mais informações sobre o comando CLI do TSM, consulte [tsm pending-changes](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm). Aqui estão alguns exemplos de atualizações de configuração: ativar o SSL, ativar o usuário Run As e as alterações de topologia do servidor.
    
    Dependendo de quantas mudanças de topologia estão sendo feitas, e da complexidade, esse trabalho pode levar mais tempo do que o tempo anterior que ele foi executado com sucesso. Por exemplo, se a mudança anterior foi uma mudança de topologia importante, e a atual não é, o trabalho atual pode levar mais tempo para ser concluído do que o anterior.
- **Gerar backup**: este trabalho é criado quando um comando backup é emitido para o Tableau Server. O comando backup cria um arquivo de backup de dados do Tableau (dados no Armazenamento de arquivos e no repositório). Para obter mais informações sobre o comando de backup da CLI do TSM, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm).
    
    O tempo necessário para que o trabalho de backup seja concluído depende da quantidade de dados que precisam ser incluídos no backup. Se a quantidade de dados a ser incluída no backup aumentou desde a última vez que este trabalho foi executado, levará mais tempo para ele ser concluído em comparação com o tempo anterior.
- **Inicializar o Tableau Server**: este trabalho é iniciado para inicializar o Tableau Server durante o processo de instalação. Para obter mais informações sobre o comando da CLI do TSM, consulte [tsm initialize](https://help.tableau.com/current/server/pt-br/cli_initialize_tsm.htm)
- **Restauração**: este trabalho é criado quando um comando restore é emitido para o Tableau Server. O comando restore restaura um arquivo de backup de dados do Tableau Server. Para mais informações sobre o comando restore da CLI do TSM, consulte [tsm maintenance](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm-maintenance-restore). O tempo necessário para que o trabalho de restauração seja concluído depende do tamanho do arquivo de backup. Se o arquivo de backup for maior do que os tempos anteriores, o trabalho de restauração levará mais tempo para ser concluído.
- **Iniciar servidor**: o trabalho é criado para iniciar todos os processos interrompidos do Tableau Server. Isso pode ser iniciado pela interface na Web do TSM ou da CLI do TSM. Para obter mais informações sobre o comando da CLI do TSM, consulte, [tsm start](https://help.tableau.com/current/server/pt-br/cli_start_tsm.htm).
- **Interromper o servidor**: este trabalho é criado para interromper todos os processos do Tableau Server em execução. Isso pode ser iniciado pela interface na Web do TSM ou da CLI do TSM. Para mais informações sobre o comando da CLI do TSM, consulte [tsm stop](https://help.tableau.com/current/server/pt-br/cli_stop_tsm.htm).

## Cancelar trabalhos do tsm

Você pode cancelar trabalhos pela interface na Web do TSM ou usando a CLI do TSM. Para obter mais informações, consulte [Cancelar trabalhos do TSM](https://help.tableau.com/current/server/pt-br/tsm-jobs-cancel.htm).

## Outros artigos nesta seção

<!-- document id=75d6effebc745430647888fcb95a705a261e3a920bff9ddce13ded073189b252 url=/tableau/current/pt-br/server/adminview_serveract.md -->

[Pular para o conteúdo principal](#main-content)

# Tráfego para exibições

O Tráfego para exibições fornece a capacidade de ver quanto do tráfego do usuário vai para as exibições.

É possível filtrar quais informações são exibidas e o período em que foram originadas ao selecionar a exibição, pasta de trabalho e intervalo de tempo. Os administradores de servidor podem especificar o site.

![Dois gráficos de linhas exibem contagens totais de visualizações por dia e hora para dois usuários distintos.](/tableau/current/pt-br/server/pt-br/Img/adminview_user_traffic_views.png)

Duas linhas de tempo na parte superior da exibição mostram como as exibições são usadas em um intervalo de tempo que você especifica (o padrão é os últimos 7 dias):

- Qual a contagem total de exibições por dia—Mostra a contagem de exibições por dia, baseada nos filtros que você define. Focalize o ponteiro do mouse sobre um ponto na linha para ver a contagem de exibições. Selecione o ponto para atualizar as outras seções da exibição com base na sua seleção.
- Qual a contagem de exibições total por hora—Mostra a contagem de exibição por hora do dia. Os filtros e qualquer seleção afetam esse gráfico.

Dois gráficos de barra na parte inferior da exibição mostram os resultados que passam pelo filtro Contagem de exibição mínima na parte superior da exibição. Mostram as exibições mais frequentemente acessadas e os usuários que acessam mais as exibições. Somente as exibições e usuários com contagens maiores ou iguais ao valor mínimo de contagem de exibição:

- Quais exibições são mais visualizadas—É uma lista das exibições mais acessadas. Como nas outras seções da exibição, a informação é limitada por filtros e por qualquer seleção que você fizer.
- Quem acessa as exibições com mais frequência—Mostra os usuários que acessam as exibições com mais frequência e tem a limitação de filtros e de qualquer seleção que você fizer.

<!-- document id=02bc76296fef80f2cfe60c44269ab6d7bad9eba09cf382e49a983b280fcd1d45 url=/tableau/current/pt-br/server/adminview_datasources.md -->

[Pular para o conteúdo principal](#main-content)

# Tráfego para fontes de dados

O Tráfego para fonte de dados fornece a capacidade de ver a utilização das fontes de dados na sua instalação do Tableau Server . Isso pode ajudá-lo a determinar quais fontes de dados são mais usadas e quais são menos usadas. É possível filtrar as informações que visualiza ao selecionar a fonte de dados, a ação adotada nessa fonte de dados e o intervalo de tempo. Os administradores de servidor podem especificar o site.

![Um gráfico de linhas exibe o uso total diário da fonte de dados nos últimos sete dias, com pico de 35 em 30 de janeiro.](/tableau/current/pt-br/server/pt-br/Img/adminview_datasource.png)

Uma linha de tempo na parte superior da exibição mostra como as fontes de dados são usadas em um intervalo de tempo que você especifica (o padrão é os últimos 7 dias):

- Qual a utilização total de fonte de dados por dia — Mostra a contagem total de utilização de fonte de dados por dia, baseada nos filtros que você define. Focalize o ponteiro do mouse sobre um ponto na linha para ver a contagem. Selecione o ponto para atualizar as outras seções da exibição com base na sua seleção.

Dois gráficos de barra na parte inferior da exibição mostram os resultados que passam pelo filtro Interações mínimas na parte superior da exibição. Mostram quais fontes de dados são mais usadas, e quem usa com mais frequência as fontes de dados. Somente as fontes de dados e usuários com contagens de interação maiores ou iguais ao valor de interações mínimas são exibidas:

- Quais fontes de dados são mais usadas — É uma lista das fontes de dados mais usadas. Como nas outras seções da exibição, a informação é limitada por filtros e por qualquer seleção que você fizer.
- Quem usa as fontes de dados com mais frequência — Mostra os usuários que usam com mais frequência as fontes de dados. Isso é afetado por filtros e qualquer seleção feita.

<!-- document id=cdba88ee9898abecf2dc635abf08af35c1f9a7863ad43ee4e4d4d990ec7886d7 url=/tableau/current/pt-br/server/cli_authentication_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm authentication

Use os comandos `tsm authentication` para habilitar, desabilitar e configurar as opções de autenticação de usuário do Tableau Server.

- [identity-migration](#tsm_identity_mig_config)
- [kerberos](#TSMKerb)
    - configure
    - disable
    - enable
- [legacy-identity-mode](#tsm_identity_mig_legacy)
    - enable
    - disable
- [list](#TSMAuthList)
- [mutual-ssl](#TSMMutualSSL)
    - configure
    - disable
    - enable
- [openid](#TSMOIDC)
    - configure
    - disable
    - enable
    - get-redirect-url
    - map-claims
- [pat-impersonation](#TSMpat)
    - disable
    - enable
- [saml](#TSMsaml)
    - configure
    - disable
    - enable
    - export-metadata
    - map-assertions
- [sitesaml](#TSMsitesaml)
    - disable
    - enable
- [sspi](#TSMSspi)
    - disable
    - enable
- [trusted](#TSMTrusted)

## tsm authentication identity-migration configure

Altere as configurações de trabalho padrão para a migração de identidade. Para obter mais informações, consulte [Gerenciar a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration_manage.htm) .

### Sinopse

`tsm authentication identity-migration configure –job-run-time`

`tsm authentication identity-migration configure –rate`

### Opções

\-j,--job-run-time <number>

Opcional.

Determina o tempo mais longo permitido, em minutos, que o trabalho de migração agendado pode ser executado. O valor padrão é 120 minutos.

\-r,--rate <number>

Opcional.

Determina o número de solicitações durante um trabalho de migração que podem ser executadas por segundo. O valor padrão é 5 solicitações por segundo.

## tsm authentication kerberos <commands>

Habilita, desabilita e configura a autenticação de usuário do Kerberos no Tableau Server. Consulte [Configurar o Kerberos](https://help.tableau.com/current/server/pt-br/config_kerberos.htm).

### Sinopse

`tsm authentication kerberos configure --keytab-file <keytab_file.keytab> [global options]`

`tsm authentication kerberos enable [global options]`

`tsm authentication kerberos disable [global options]`

### Opções de configuração do Kerberos

\-kt, --keytab-file <keytab\_file.keytab>

Obrigatório.

Especifica o arquivo de serviço .keytab usado para solicitações ao KDC.

## tsm authentication legacy-identity-mode <commands>

Habilite ou desabilite o modo de armazenamento de identidade herdado que pode ser necessário durante a migração de identidade. Reveja a seção [Não foi possível restaurar o backup](https://help.tableau.com/current/server/pt-br/identity_migration_troubleshoot.htm#restore) para determinar quando usar este comando.

Para obter mais informações, consulte [Sobre a migração de identidade](https://help.tableau.com/current/server/pt-br/identity_migration.htm).

### Sinopse

`tsm authentication legacy-identity-mode enable`

`tsm authentication legacy-identity-mode disable`

## tsm authentication list

Lista as definições de configuração relacionadas à autenticação existente do servidor.

### Sinopse

`tsm authentication list [--verbose][global options]`

### Opções

v, --verbose

Opcional.

Apresenta parâmetros configurados.

## tsm authentication mutual-ssl <commands>

Habilita, desabilita e configura o SSL mútuo para autenticação de usuário no Tableau Server. Para saber mais sobre SSL mútuo, consulte [Configurar autenticação do SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm).

Antes de habilitar o SSL mútuo, é necessário configurar o SSL para comunicação externa. Para obter informações, consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm).

### Sinopse

`tsm authentication mutual-ssl configure [options] [global options]`

`tsm authentication mutual-ssl disable [global options]`

`tsm authentication mutual-ssl enable [global options]`

### Opções

\-cf, --ca-cert <certificate-file.crt>

Opcional.

Especifica a localização e o nome do arquivo do arquivo de certificado. O arquivo deve ser um certificado confiável e válido de uma Autoridade de certificação (Verisign, por exemplo).

\-fb, --fallback-to-basic <true | false\>

Opcional.

Especifica se o Tableau Server deve aceitar o nome e senha de usuário para a autenticação se a autenticação do SSL falhar.

O valor padrão é falso para indicar que, quando configurado para SSL mútuo, o Tableau Server não permite uma conexão se houver falha na autenticação de SSL. No entanto, o Tableau Server aceita autenticação com nome de usuário e senha de clientes REST API, mesmo que a opção acima esteja definida como `false`.

\-m, --user-name-mapping <upn | ldap | cn>

Opcional.

Especifica a sintaxe do nome de usuário (UPN, LDAP or CN) para recuperar do armazenamento de identidades ou diretório. A sintaxe deve corresponder ao formato de Subject (Assunto) ou de Subject Alternative Name (SAN, Nome alternativo) no certificado do usuário.

\-rf, --revocation-file <revoke-file.pem\>

Opcional.

Especifica a localização e o nome do arquivo do arquivo de certificado da lista de revogação. Este arquivo pode ser um arquivo .pem ou .der.

## tsm authentication openid <commands>

Habilite, desabilite e configure a autenticação de usuário do OpenID Connect (OIDC) no Tableau Server.

### Sinopse

`tsm authentication openid configure [options] [global options]`

`tsm authentication openid disable [global options]`

`tsm authentication openid enable [global options]`

`tsm authentication openid get-redirect-url [global options]`

`tsm authentication openid map-claims [options] [global options]`

`tsm authentication openid enable-slo [options][global options]`

`tsm authentication openid disable-slo [options][global options]`

`tsm authentication openid get-slo-redirect-url [options][global options]`

### Observações

- Os comandos `tsm authentication openid enable-slo`, `tsm authentication openid disable-slo` e `tsm authentication get-slo-redirect-url` foram adicionados no Tableau Server 2025.3

### Opções de configuração do OpenID

**Observação:** as opções devem ser definidas durante a configuração inicial ou durante a reconfiguração. As opções individuais não podem ser definidas separadamente.

\-a, --client-authentication <string\>

Obrigatório.

Especifica o método de autenticação de cliente personalizado para OpenID Connect.

Para configurar o Tableau Server para usar o Salesforce IdP, defina esse valor como `client_secret_post`.

\-cs, --client-secret <string>

Obrigatório.

Especifica o segredo do cliente do provedor. Este é um token usado pelo Tableau para verificar a autenticidade da resposta do IdP. Este valor é um segredo e deve ser mantido em segurança.

\-cu, --config-url <url>

Obrigatório.

Especifica a localização do documento de descoberta de configuração do provedor que contém os metadados do provedor OpenID. Se o provedor hospedar um arquivo JSON público, use --config-url. Caso contrário, especifique um caminho no computador local e o nome do arquivo usando --metadata-file.

\-mf, --metadata-file <file-path>, --config-file <config-file.json>

Opcional.

Especifica o caminho local para o documento JSON de descoberta OIDC estático.

\-i, --client-id <client-id>

Obrigatório.

Especifica a ID do cliente do provedor que o IdP designou para o aplicativo.

\-id, --ignore-domain <true | false>

Opcional. Padrão: `false`

Defina isso como `true`, se o seguinte for verdadeiro:

- Você está usando endereços de e-mail como nomes de usuário no Tableau Server
- Você forneceu aos usuários no IdP vários nomes de domínio
- Você quer ignorar a parte de nome de domínio da recuperação `email` no IdP

Antes de prosseguir, revise os nomes de usuário que serão usados como um resultado da configuração desta opção como `true`. Podem ocorrer conflitos do nome de usuário. Em caso de conflito de nome de usuário, o risco de divulgação de informações é alto. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm).

\-if, --iframed-idp-enabled <true | false>

Opcional. Padrão: `false`

Especifica se o IdP é permitido em um iFrame. O IdP deve desabilitar a proteção contra roubo de cliques para permitir a apresentação do iFrame.

\-ij, --ignore-jwk <true | false>

Opcional. Padrão: `false`

Defina como `true` se o seu IdP não oferecer suporte à validação JWK. Neste caso, recomendamos autenticar a comunicação com o seu IdP usando TLS mútuo ou outro protocolo de segurança da camada de rede.

\-r, --return-url <return-url>

A URL do servidor. Ela é normalmente o nome público do seu servidor, como `"http://example.tableau.com"`.

\-sn, --custom-scope-name <string>

Opcional.

Especifica um valor de escopo personalizado relacionado ao usuário que pode ser usado para consultar o IdP. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm).

### Opções para openid map-claims

Use essas opções para alterar as solicitações padrão do OIDC que o Tableau Server usará ao se comunicar com o IdP. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/current/server/pt-br/openid_auth_requirements.htm).

\-i, --id <string>

Opcional. Padrão: `sub`

Altere este valor se o seu IdP não usar a recuperação `sub` para identificar exclusivamente os usuários do token ID. A recuperação IdP especificada deve conter uma única e exclusiva cadeia de caracteres.

\-un, --user-name <string>

Opcional. Padrão: `email`

Altere este valor para a recuperação IdP que a sua empresa usará para corresponder nomes de usuários, conforme armazenado no Tableau Server.

### Observações

- Os comandos `tsm authentication openid enable-slo`, `tsm authentication openid disable-slo` e `tsm authentication get-slo-redirect-url` foram adicionados no Tableau Server 2025.3.

## tsm authentication pat-impersonation <commands>

Ative e desative a representação do token de acesso pessoal para administradores em Tableau Server.

Para obter mais informações sobre tokens de acesso pessoal, consulte [Tokens de acesso pessoal](https://help.tableau.com/current/server/pt-br/security_personal_access_tokens.htm).

### Sinopse

`tsm authentication pat-impersonation disable [global options]`

`tsm authentication pat-impersonation enable [global options]`

Para ver se a representação do token de acesso pessoal está ativada, execute o seguinte comando:

`tsm authentication list`

## tsm authentication saml <commands>

Configura o Tableau Server para suportar logon único ao usar o padrão do SAML 2.0, habilita ou desabilita o SAML para um site, mapeia nomes de atributo de afirmação entre o Tableau Server e o provedor de identidade (IdP).

### Comandos disponíveis

`tsm authentication saml configure [options] [global options]`

`tsm authentication saml disable [options] [global options]`

`tsm authentication saml enable [options] [global options]`

`tsm authentication saml export-metadata [options] [global options]`

`tsm authentication saml map-assertions [options]`

## tsm authentication saml configure

Defina as configurações de SAML para o servidor. Especifique o certificado SAML e os arquivos de metadados, forneça informações adicionais necessárias e defina as opções adicionais.

Se estiver configurando o SAML pela primeira vez ou se o tiver desativado anteriormente, você deverá executar este comando com `tsm authentication saml enable`. Para obter mais informações, consulte [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).

### Sinopse

`tsm authentication saml configure [options] [global options]`

### Opções

\-e, --idp-entity-id <id>

Obrigatório para a configuração SAML inicial; opcional em outros casos. Valor de ID da entidade do IdP

Normalmente, é igual a URL de retorno do Tableau Server (especificada no parâmetro `--idp-return-url`). A ID de entidade que você insere é usada como uma base para a geração de IDs de entidade de sites específicos. Por exemplo, se você inserir:

http://tableau-server

Um site configurado para SAML pode exibir a seguinte ID de entidade:

http://tableau-server/samlservice/public/sp/metadata?alias=48957410-9396-430a-967c-75bdb6e002a0

Para localizar a ID da entidade do site, vá para a página de Configurações do site e selecione a guia Autenticação. Quando o SAML está habilitado, a ID da entidade é mostrada na primeira etapa para configurar o SAML específico do site, exportando os metadados.

\-r, --idp-return-url <idp-return-url>

Obrigatório para a configuração SAML inicial; opcional em outros casos. A URL de retorno do SAML configurada no IdP. Normalmente, é a URL externa do Tableau Server; por exemplo, https://tableau-server.

**Observações**

- http://localhost não funciona em um servidor externo.
- Adicionar uma barra à direita da URL (http://tableau-server/) não é suportado.

\-i, --idp-metadata <idp-metadata.xml>

Obrigatório para a configuração SAML inicial; opcional em outros casos. Forneça o local e o nome do arquivo de metadados XML exportado das configurações do IdP.

Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\<metadata-file.xml>`

\-cf, --cert-file <certificate.crt>

Obrigatório para a configuração SAML inicial; opcional em outros casos. O local e o nome do arquivo de certificado. Para requisitos do arquivo de certificado, consulte [Requisitos do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm).

Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\<file.crt>`

\-kf, --key-file <certificate.key>

Obrigatório para a configuração SAML inicial; opcional em outros casos. Local e nome do arquivo-chave que acompanha o certificado.

Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\<file.key>`

Obrigatório para a configuração SAML inicial ao usar FIPS; opcional em outros casos. A localização e o nome do arquivo de certificado de criptografia. Para requisitos do arquivo de certificado, consulte [Requisitos do SAML](https://help.tableau.com/current/server/pt-br/saml_requ.htm).

Por exemplo, `/var/opt/tableau/tableau_server/data/saml/<file.crt>`

Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\<file.crt>`

\-ekf, --encryption-key-file <FILE-PATH>

Obrigatório para a configuração SAML inicial ao usar FIPS; opcional em outros casos. Local e nome do arquivo da chave de criptografia que corresponde ao certificado de criptografia.

Por exemplo, `/var/opt/tableau/tableau_server/data/saml/<file.key>`

Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\<file.key>`

\-a, --max-auth-age <max-auth-age>

Opcional. O valor padrão é -1 (começando no Tableau Server versão 2020.4.15, 2021.1.12, 2021.2.9,2021.3.8, 20214.4, 2022 e posteriores). O valor padrão anterior é 7200 (2 horas).

O número máximo de segundos permitidos entre a autenticação do usuário e o processamento da mensagem AuthNResponse.

Recomendamos que você mantenha esse valor padrão, que desativa a verificação da idade máxima de autenticação. Se esse valor for diferente do seu IdP, os usuários que fizerem login no Tableau Server poderão ver um erro de login. Para obter mais informações sobre esse erro, consulte o artigo [Erro intermitente “Não é possível fazer login” com SAML SSO no Tableau Server](https://kb.tableau.com/articles/issue/intermittent-error-unable-to-sign-in-with-saml-sso-on-tableau-server?lang=pt-br) na Base de dados de conhecimento do Tableau.

\-d, --desktop-access <enable | disable>

Opcional. O valor padrão é enable.

Esta opção aplica-se somente ao SAML em todo o servidor Usa o SAML para fazer logon no servidor pelo Tableau Desktop. Se o logon único por meio dos aplicativos cliente do Tableau não funcionar com seu IdP, é possível definir isso como `disable`.

\-m, --mobile-access <enable | disable>

Opcional. O valor padrão é enable.

Permita o uso de SAML para fazer logon de versões mais antigas do aplicativo Tableau Mobile. Os dispositivos que executam a versão 19.225.1731 do aplicativo Tableau Mobile e ignoram essa opção. Para desabilitar os dispositivos que executam a versão 19.225.1731 e posteriores do Tableau Mobile, desabilite o SAML como uma opção de logon do cliente no Tableau Server.

\-so, --signout <enable | disable>

Opcional. Habilitado por padrão.

Habilita ou desabilita a opção SAML de "sair da sessão" para Tableau Server.

\-su, --signout-url <url>

Opcional. Insere a URL de redirecionamento usada depois que os usuários saem do servidor. Por padrão, esta é a página de logon do Tableau Server. Você pode especificar uma URL absoluta ou relativa.

### Exemplo

`tsm authentication saml configure --idp-entity-id https://tableau-server --idp-metadata "C:\ProgramData\Tableau\Tableau Server\data\saml\<metadata.xml>" --idp-return-url https://tableau-server --cert-file "C:\ProgramData\Tableau\Tableau Server\data\saml\<file.crt>" --key-file "C:\ProgramData\Tableau\Tableau Server\data\saml\<file.key>"`

## tsm authentication saml enable and saml disable

Habilita ou desabilita a autenticação SAML por todo o servidor. Neste contexto, todos os sites e usuários habilitados para SAML passam por um único provedor de identidade.

### Sinopse

`tsm authentication saml enable [global options]`

`tsm authentication saml disable [global options]`

## tsm authentication saml export-metadata

Exportar o arquivo de metadados.xml do Tableau Server que será usado para configurar o SAML IdP.

### Sinopse

`tsm authentication saml export-metadata [options] [global options]`

### Opções

\-f, --file \[/path/to/file.xml\]

Opcional.

Especifica a localização e nome de arquivo em que os metadados serão gravados. Se não incluir essa opção, o comando `export-metadata` salva o arquivo no diretório atual e o nomeia `samlmetadata.xml`.

\-o, --overwrite

Opcional.

Substitui um arquivo existente com o mesmo nome especificado em `-f`, ou do nome padrão se o `-f` não estiver incluído. Caso um arquivo especificado em `-f` existir e `-o` não estiver incluído, o comando não substitui o arquivo existente.

## tsm authentication saml map-assertions

Mapeia atributos entre o IdP e o Tableau Server. Fornece o nome que o IdP usa para o atributo especificado em cada argumento.

### Sinopse

`tsm authentication saml map-assertions --user-name <user-name> [global options]`

### Opções

\-r, --user-name <user-name-attribute>

Opcional. O atributo no qual o IdP armazena o nome de usuário. No Tableau Server é igual ao nome de exibição.

\-e, --email <email-name-attribute>

Não use. Esta opção não é compatível com o Tableau.

\-o, --domain <domain-name-attribute>

Opcional. O atributo no qual o IdP armazena o nome de domínio. Use essa opção se você adicionar usuários de um domínio diferente do domínio do computador do Tableau Server. Para obter mais informações, consulte [Ao executar vários domínios](https://help.tableau.com/current/server/pt-br/saml_requ.htm#multiple_domains).

\-d --display-name <display-name-attribute>

Não use. Esta opção não é compatível com o Tableau.

### Example for saml map-assertions

`tsm authentication saml map-assertions --user-name=<sAMAccountName> --domain=<FQDM>` ou `tsm authentication saml map-assertions --user-name=jnguyen --domain=example.myco.com`

## tsm authentication sitesaml enable and sitesaml disable

Configura o servidor para permitir ou negar a autenticação SAML no nível de site. Habilitar o SAML específico ao site fornece acesso à guia Configurações > Autenticação na interface do usuário na Web do Tableau Server. A guia Autenticação contém as definições de configuração para o SAML específico ao site.

Use o comando `sitesaml enable` com o `saml configure` se o servidor ainda não foi configurado para permitir o SAML específico ao site. Para obter mais informações, consulte [Configurar SAML específico do site](https://help.tableau.com/current/server/pt-br/saml_site_specific.htm).

### Sinopse

`tsm authentication sitesaml enable [global options]`

`tsm authentication sitesaml disable [global options]`

## tsm authentication sspi <commands>

Este comando só funcionará no Tableau Server no Windows. Ao tentar habilitar o SSPI no Tableau Server no Linux, um erro será retornado.

Habilita ou desabilita o logon automático usando o Microsoft SSPI.

Se usar o Active Directory, também é possível habilitar o logon automático, que usa o Microsoft SSPI para conectar automaticamente seus usuários com base em seus nomes de usuário e suas senhas do Windows. Isso cria uma experiência semelhante à de logon único (SSO).

Não habilite o SSPI se planeja configurar o Tableau Server para SAML, autenticação confiável, uma balanceador de carga ou servidor proxy. O SSPI não é compatível com esses cenários.

### Sinopse

`tsm authentication sspi disable [global options]`

`tsm authentication sspi enable [global options]`

Como em todos os comandos de autenticação, você deve executar `tsm pending-changes apply` depois de executar este comando.

## tsm authentication trusted <commands>

Configura autenticação confiável (tickets confiáveis) para autenticação de usuário no Tableau Server.

### Sinopse

`tsm authentication trusted configure [options] [global options]`

### Opções

\-th, --hosts <string>

Opcional.

Especifica os nomes de host confiável (ou endereços do IPv4) dos servidores da Web que hospedarão páginas com o conteúdo do Tableau.

Para vários valores, insira os nomes em uma lista separada por vírgulas onde cada valor é encapsulado em aspas duplas.

Por exemplo:

tsm authentication trusted configure -th "192.168.1.101", "192.168.1.102", "192.168.1.103" 

ou

tsm authentication trusted configure -th "webserv1", "webserv2", "webserv3" 

\-t, --token-length <integer>

Opcional.

Determina o número de caracteres em cada ticket confiável. A configuração padrão de 24 caracteres fornece 144 bits de aleatório. O valor pode ser definido como qualquer inteiro entre 9 e 255, inclusive.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=d833040cfef578615f7b93e89f31764d9e3ccbaae0d53aca2ea911be5a671824 url=/tableau/current/pt-br/server/cli_configuration_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm configuration

É possível usar os comandos de `tsm configuration` para obter, definir e atualizar os valores de chave de configuração.

## Respostas "Chave desconhecida"

Determinadas chaves de configuração retornarão a resposta “Chave desconhecida” quando você tentar obter o valor atual ou definir um novo valor. Se isso acontecer, verifique se você escreveu a chave corretamente, incluindo a capitalização adequada. Para alterar o valor, use a opção `--force-keys` no comando `tsm configuration set`. Para obter uma lista das chaves de configuração que podem ser alteradas, consulte [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm).

## Respostas com valor "Null"

Certas chaves de configuração têm um valor padrão específico, mas retornarão uma resposta "Null" quando você tentar obter seu valor atual. Essas chaves usam um padrão derivado do código do Tableau Server. Se uma chave estiver listada como tendo um padrão específico nas [Opções do tsm configuration set](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm) e o comando `tsm configuration get` retorna "Null" para o valor atual, o valor padrão é determinado pelo código que executa o Tableau Server. Você pode definir o valor-chave usando`tsm configuration set`, mas isso não é necessário, a menos que você queira alterar o valor.

- [tsm configuration get](#TSMGet)
- [tsm configuration list-dynamic-keys](#TSMListDynamicKeys)
- [tsm configuration set](#TSMSet)

## tsm configuration get

Visualize a configuração e a topologia do servidor atual.

### Sinopse

`tsm configuration get --key <config.key> [global options]`

### Opção

\-k, --key

Obrigatório.

Obtém o valor atual da chave de configuração especificada.

## tsm configuration list-dynamic-keys

Visualize todas as chaves de configuração que podem ser definidas dinamicamente (sem reiniciar o Tableau Server).

### Sinopse

`tsm configuration list-dynamic-keys [global options]`

## tsm configuration set

Define ou importa a configuração ou topologia do servidor.

É opcional colocar `<config.key>` e `<config_value>` entre aspas; se houver espaços, coloque a chave ou o valor entre aspas.

**Observação:** Depois de definir um valor de chave de configuração, aplique as alterações de configuração pendentes usando o comando `[tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply)`. Até que faça isso, o novo valor não será usado pelo Tableau ou mostrado nos resultados de um comando `tsm configuration get`. Veja as alterações pendentes usando o `tsm pending-changes list`. Para obter mais informações, consulte [tsm pending-changes](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm).

### Sinopse

`tsm configuration set --key <config.key> --value <config_value> [global options]`

### Opções

\-k,--key <config.key>

Obrigatório.

Chave de configuração.

\-v,--value <config\_value>

Obrigatório. A partir das versões de manutenção de março (versões 2021.2.10, 2021.3.9, 2021.4.5 ), se você não incluir essa opção, receberá uma solicitação do valor.

Valor de configuração

\-d

Opcional.

Redefina o valor da configuração como o padrão.

\-frc, --force-keys

Opcional.

Faça com que uma chave seja adicionada à configuração, mesmo que não tenha existido anteriormente.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=e1ded165cfeac16429dc7e2eadd041efe2315865a6573a44d843608cb267e91d url=/tableau/current/pt-br/server/cli_customize.md -->

[Pular para o conteúdo principal](#main-content)

# tsm customize

É possível usar o comando `tsm customize` para personalizar o visual e a sensação da experiência de navegação do cliente do Tableau Server.

![Página Explorar do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/custom_namelogo.png)

| Logotipo | Sinalizador de opção | Tamanho mínimo/Tamanho máximo, em pixels | Tamanho recomendado, em pixels |
| --- | --- | --- | --- |
| **A** - Logotipo da guia Janela | não pode ser alterado | não pode ser alterado | não pode ser alterado |
| **B** - Nome do servidor | `--server-name` | não se aplica | não se aplica |
| **C** - Logotipo do cabeçalho | `--header-logo` | 32 por 32 mín., 160 por 160 máx. | 48 por 48 |
| **Não mostrado** - Logotipo de logon | `--signin-logo` | 3000 x 3000 máx. |   |
| Logotipo do cabeçalho/Logotipo de logon | `--logo` | 32 por 32 mín., 160 por 160 máx. | 48 por 48 |
| **Não mostrado** - Logotipo mostrado quando o painel de navegação é minimizado | `--compact-logo` | 32 por 32 máx | 32 por 32 |

Os arquivos de imagem usados devem estar no formato GIF, JPEG ou PNG.

As cores de fundo no cabeçalho e na página de logon não são iguais. Se você usar a mesma imagem para ambos os locais (se usar a opção `--logo`, por exemplo), o logotipo pode ter uma aparência diferente dependendo do local onde aparece na interface do servidor.

Como parte do seu plano de recuperação de desastres, recomendamos manter um backup dos arquivos de imagem de personalização em um local seguro fora do Tableau Server. Os arquivos de imagem adicionados ao Tableau Server serão armazenados e distribuídos a outros nós pelo Serviço de Arquivos do Cliente. No entanto, os arquivos não são armazenados em um formato recuperável. Consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

### Sinopse

`tsm customize [options] [global options]`

Após executar o comando `customize`, você deve executar o comando a seguir para aplicar as alterações:

`tsm pending-changes apply`

### Opções

**Observação:** use o caminho e o nome do arquivo de imagem não pode incluir espaços.

\--compact-logo "<path-to-logo>"

Opcional.

Especifique um caminho para o arquivo de imagem que será exibido quando o tamanho do painel de navegação é minimizado. O tamanho máximo (e ideal) é 32 por 32 pixels.

\--header-logo "<path-to-logo>"

Opcional.

Especifique um caminho para o arquivo de imagem que será exibido apenas no cabeçalho.

\--logo "<path-to-logo>"

Opcional.

Caminho para um único arquivo de imagem que será exibido para o cabeçalho e a janela de logon.

\--restore-defaults

Opcional.

Redefine todas as opções de personalização para o estado de instalação padrão.

\--server-name <server\_name>

Opcional.

O nome do servidor que aparece na guia, nas dicas de ferramenta e nas mensagens do navegador.

\--signin-logo "<path-to-logo>"

Opcional.

Especifica um caminho para o arquivo de imagem que será exibido apenas na janela de logon.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=ee5addeddf1c123843f820af4927fe6df0d082a8813a8351e42a8af409f6eeb9 url=/tableau/current/pt-br/server/cli_data-access.md -->

[Pular para o conteúdo principal](#main-content)

# tsm data-access

É possível usar os comandos `tsm data-access` para configurar o cache de dados, habilitar ou desabilitar o acesso ao repositório de dados, habilitar SAML para logon único e definir as configurações dos Conectores de dados da Web (WDCs).

- caching
    - [data-access caching list](#caching-list)
    - [data-access caching set](#caching-set)
- repository
    - [repository-access disable](#repository-access-disable)
    - [repository-access enable](#repository-access-enable)
    - [repository-access list](#repository-access-list)
- set-saml-delegation
    - [set-saml-delegation configure](#set-saml-config)
    - [set-saml-delegation disable](#set-saml-disable)
    - [set-saml-delegation enable](#set-saml-enable)
- web-data-connectors
    - [web-data-connectors add](#web-data-connectors-add)
    - [web-data-connectors allow](#web-data-connectors-allow)
    - [web-data-connectors delete](#web-data-connectors-delete)
    - [web-data-connectors list](#web-data-connectors-list)

## tsm data-access caching list

Exibe as configurações de cache da conexão de dados. Para saber mais sobre as configurações de cache, consulte [Configurar cache de dados](https://help.tableau.com/current/server/pt-br/config_cache.htm).

### Sinopse

`tsm data-access caching list [global options]`

## tsm data-access caching set

Define as configurações de cache da conexão de dados. Para saber mais sobre as configurações de cache, consulte [Configurar cache de dados](https://help.tableau.com/current/server/pt-br/config_cache.htm).

### Sinopse

`tsm data-access caching set [options] [global options]`

### Opções

\-r, --refresh-frequency

Opcional.

Define a frequência de atualização dos dados em cache com uma nova consulta para a fonte de dados subjacente. É possível especificar um número para definir a quantidade máxima de minutos em que a fonte de dados deve ser armazenada em cache. Além disso, é possível especificar **baixa** para armazenamento em cache e reutilizar dados pelo máximo de tempo possível ou **sempre** (equivalente a **0**) para atualizar dados a cada vez que a página for atualizada. Se esta opção não for especificada, o padrão é **baixa**.

## tsm data-access repository-access disable

Desativa o acesso externo ao banco de dados PostgreSQL do Tableau para o usuário remoto padrão. Isso não desabilitará o acesso do host local.

### Sinopse

`tsm data-access repository-access disable [options] [global options]`

### Opções

\--repository-username <username>

Obrigatório.

O nome de usuário, **tableau** ou **readonly**, com acesso ao repositório de dados.

\--request-timeout <tempo limite em segundos>

Opcional.

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

\--ignore-prompt

Opcional.

Suprime o prompt de reinicialização e reinicializa o Tableau Server.

## tsm data-access repository-access enable

Ativa o acesso ao banco de dados PostgreSQL do Tableau.

Por padrão, o tráfego do PostgreSQL usa a porta 8060 (TCP). Se estiver executando um firewall local, não esqueça de permitir o tráfego para essa porta. Para alterar a porta PostgreSQL, consulte [Portas que não estão mapeadas dinamicamente](https://help.tableau.com/current/server/pt-br/ports.htm#PortsNotDynamic).

### Sinopse

`tsm data-access repository-access enable [options] [global options]`

### Opções

\--repository-password <password>

Obrigatório.

Define (ou altera) a senha para acessar o repositório de dados do nome de usuário especificado.

\--repository-username <username>

Obrigatório.

O nome de usuário, **tableau** ou **readonly**, com acesso ao repositório de dados.

\--request-timeout <tempo limite em segundos>

Opcional.

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

\--ignore-prompt

Opcional.

Suprime o prompt de reinicialização e reinicializa o Tableau Server.

## tsm data-access repository-access list

Lista os usuários que possuem acesso ao banco de dados PostgreSQL do Tableau.

### Sinopse

`tsm data-access repository-access list [global options]`

## tsm data-access set-saml-delegation configure

Define o logon único para o SAML SAP HANA de forma que o Tableau Server funcione como um Provedor de identidade (IdP) que fornece logon único para usuários que fazem conexões de dados SAP HANA.

### Sinopse

`tsm data-access set-saml-delegation configure [options] [global options]`

### Opções

\-kf, --cert-key <cert-key>

Opcional.

O arquivo da chave de certificado SAML.

\-cf, --cert-file <file-path>

Opcional.

A localização do arquivo de certificado SAML.

\-uf, --username-format <username-format>

Opcional.

Formato do nome de usuário. Chaves de formato válidas são: 'username', 'domain\_and\_username' e 'email'.

\-uc,--username-case <username-case>

Opcional.

Nome de usuário em maiúscula ou minúscula. Chaves de maiúscula/minúscula válidas são: 'lower', 'upper’ e 'preserve'.

.

## tsm data-access set-saml-delegation disable

Desabilitar logon único do SAML para SAP HANA.

### Sinopse

`tsm data-access set-saml-delegation disable [global options]`

## tsm data-access set-saml-delegation enable

Habilitar logon único do SAML para SAP HANA.

### Sinopse

`tsm data-access set-saml-delegation enable [global options]`

## tsm data-access web-data-connectors add

Adicionar um conector de dados da Web (WDC) à lista segura de WDC.

### Sinopse

`tsm data-access web-data-connectors add [options] [global options]`

### Opções

\-n, --name <name>

Obrigatório.

O nome do WDC que será exibido na lista de fontes de dados do Tableau Server. Este nome deve ser colocado entre aspas simples (') ou aspas duplas ("). Use aspas duplas (") se o nome incluir um espaço.

\-sec, --secondary <secondary-URL-1>, <secondary-URL-2>

Obrigatório se o WDC usa domínios secundários.

Uma lista de URLs delimitada por vírgula que indica de quais domínios o conector pode fazer solicitações ou receber dados, por exemplo, bibliotecas do JavaScript externas, REST APIs ou arquivos locais. Não inclua as URLs entre aspas. Para adicionar um domínio inteiro a esta lista de segurança secundária, você pode usar uma expressão curinga `.*` no final da URL, como mostrado no exemplo a seguir: `https://www.example.com/.*`

Observe que no Windows, você pode incluir parênteses `(.*)` ao redor do curinga, mas não é necessário. No Linux, os parênteses causarão um erro. Use `.*` como curinga.

Se você não sabe se o WDC usa domínios secundários ou quais são os domínios secundários, talvez seja necessário entrar em contato com o desenvolvedor do WDC. Você também pode optar por usar URLs curinga `http://.*` e `https://.*` para permitir todos os domínios. No entanto, para aumentar a segurança, é altamente recomendável que você use URLs mais específicas.

\--url <URL>

Obrigatório.

A URL para o WDC (formatada como `<scheme>://<host>:<port>/<path>`, por exemplo `https://www.tableau.com:443/example/`). Para muitos WDCs, o valor <port> é 443, que é a porta padrão usada para HTTPS, mas é possível verificar o valor para o seu conector ao analisar os detalhes da fonte de dados no Tableau Server ou no Tableau Cloud. Observe que você não pode usar um curinga(`.*`) como parte da URL para o WDC.

## tsm data-access web-data-connectors allow

Habilita ou desabilite as atualizações de WDC. Além disso, habilita ou desabilita o uso de WDCs no Tableau Server.

### Sinopse

`tsm data-access web-data-connectors allow [options] [global options]`

### Opções

Use uma ou ambas as opções. Pelo menos um de `--refreshes` ou `--type` é necessário.

\-r, --refreshes <refreshes-allowed>

Opcional se `--type` for especificado.

Defina `false` para proibir atualizações WDC ou `true` para permitir atualizações WDC.

\-t, --type <WDC-allowed>

Opcional se `--refreshes` especificado.

Defina como `none` para proibir o uso de WDCs no Tableau Server (e omitir os WDCs de backups) ou `all` para permitir o uso de WDCs.

## tsm data-access web-data-connectors delete

Exclui um WDC especificado ou todos os WDCs da lista autorizada do Tableau Server.

### Sinopse

`tsm data-access web-data-connectors delete [options] [global options]`

### Opções

\--all

Opcional.

Esta opção excluirá todos os WDCs.

\--url <URL>

Opcional.

A URL a ser excluída do WDC.

## tsm data-access web-data-connectors list

Lista todos os WDCs atualmente na lista autorizada.

### Sinopse

`tsm data-access web-data-connectors list [options] [global options]`

### Opções

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=9953ba05ea58eaf7ffc9bd2df04d764af25ecd44095796fea06edb19a0ad8972 url=/tableau/current/pt-br/server/cli_email.md -->

[Pular para o conteúdo principal](#main-content)

# tsm email

Use o comando `tsm email` para exibir e testar a configuração SMTP.

Para obter mais informações sobre a configuração do SMTP, consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/config_smtp.htm).

## tsm email test-smtp-connection

Execute este comando para testar a conexão STMP. Ao ser executado, o TSM tentará estabelecer uma conexão com o servidor SMTP configurado para o Tableau Server. O TSM também retornará um status de conexão e os detalhes da configuração do SMTP.

Em alguns casos, o comando retornará um status falso-positivo. Por exemplo, se o servidor Postfix SMTP estiver definido para exigir TLS, mas o Tableau Server não estiver configurado para TLS, a conexão será estabelecida e o TSM relatará uma conexão bem-sucedida. No entanto, nesse cenário, na verdade, o Postfix rejeita a mensagem de e-mail após a conexão do TSM.

### Sinopse

`tsm email test-smtp-connection [global options]`

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=f8f411326143a77571ba6f6c01f4ba7923b78bf727fb74780504b7c5097a8874 url=/tableau/current/pt-br/server/cli_default_filepaths_tsm.md -->

[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:
        
        `<install drive>:<install\path>\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" (\\\\<nome do computador>\\<pasta>\\<nome do arquivo>), como o caminho para o local onde os arquivos de backup estão gravados. Em vez disso, use caminhos de sistema do arquivo local (<drive letter>:\\<folder name\\<file name>).
        
        - **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:
        
        `<install drive>:<install\path>\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:
        
        `<install drive>:<install\path>\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:
        
        `<install drive>:<install\path>\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:
        
        `<install drive>:<install\path>\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 "<drive>:\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 "<drive>:\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 "<drive>:\new\directory\path"`
    - Para alterar o diretório de importação de sites:
        
        `tsm configuration set -k basefilepath.site_import.exports -v "<drive>:\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`

<!-- document id=26a30317326a808b71130695f8922883475c066556539ce0278f0665a9d5b900 url=/tableau/current/pt-br/server/cli_initialize_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm initialize

É possível usar o comando `tsm initialize` para inicializar o Tableau Server.

**Observação:** é obrigatória a aplicação ou o descarte das alterações pendentes antes de executar o `tsm initialize` ou a inicialização falhará. Aplique as alterações pendentes por meio do comando `[tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply)`. Descarte quaisquer alterações pendentes que não queira aplicar por meio do `[tsm pending-changes discard](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-discard)`.

### Sinopse

`tsm initialize [options] [global options]`

### Opções

\-r,--start-server

Opcional. Deixa o servidor em execução após a conclusão da inicialização.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=c264f59058f386bb4d3ce707806f3fd32fa9b989e96263e00e26e655c33e11c6 url=/tableau/current/pt-br/server/cli_jobs_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm jobs

É possível usar os comandos `tsm jobs` para listar, se reconectar a e cancelar trabalhos.

- [cancel](#tsm)
- [list](#tsm2)
- [reconnect](#tsm3)

## tsm jobs cancel

Cancela um trabalho no servidor. Qualquer trabalho pode ser cancelado antes de começar a ser executado (quando enfileirado). Apenas determinados trabalhos podem ser cancelados enquanto já estão em execução: Limpeza, Descomissionamento de Armazenamento de Arquivo, Gerar Backup, Reiniciar Servidor, Iniciar Servidor. Para obter mais informações sobre cancelar trabalhos, consulte [Cancelar trabalhos do TSM](https://help.tableau.com/current/server/pt-br/tsm-jobs-cancel.htm).

### Sinopse

`tsm jobs cancel --id <jobID> [global options]`

### Opções

\-i,--id <jobID>

Obrigatório.

Id do trabalho a ser cancelado.

## tsm jobs list

Lista trabalhos assíncronos no servidor.

### Sinopse

`tsm jobs list [--status <status>] [global options]`

### Opções

\-t,--status <status>

Opcional.

Filtra trabalhos que correspondem ao status fornecido.

## tsm jobs reconnect

Reconecta a um trabalho assíncrono para exibir seu progresso. Se nenhuma Id de trabalho for especificada, ele se reconecta ao trabalho mais recente.

### Sinopse

`tsm jobs reconnect[--id <jobID>] [global options]`

### Opções

\-i,--id <jobID>

Opcional.

Especifica a id do trabalho que deve ser reconectado.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=64c0e58f858eb5621cb5ed968c82accd19dbcfc863823fae2d49d716fb76faaa url=/tableau/current/pt-br/server/cli_licenses_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm licenses

É possível usar os comandos `tsm licenses` para gerenciar tarefas da licença do servidor, como ativar ou desativar uma chave do produto do Tableau Server on-line ou off-line e obter arquivos relacionados para ativação ou desativação off-line.

- [tsm licenses activate](#TSMActivate)
- [tsm licenses atr-configuration get](#TSMAtr-configuration-get)
- [tsm licenses atr-configuration set](#TSMAtr-configuration-set)
- [tsm licenses deactivate](#TSMDeactivate)
- [tsm licenses get-offline-activation-file](#TSMActivateFile)
- [tsm licenses get-offline-deactivation-file](#TSMDeactivateFile)
- [tsm licenses list](#TSMLicenseList)
- [tsm licenses refresh](#TSMLicenseRefresh)

## tsm licenses activate

Ativa uma chave do produto do Tableau Server.

Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de command.

### Sinopse

`tsm licenses activate --license-key <product-key> [global options]`

### Opções

\-f, --license-file <file.tlf>

Obrigatório ao fazer ativação off-line.

Especifica o arquivo de licença (<file>.tlf) usado para a ativação off-line.

\-k, --license-key <product-key>

Obrigatório ao ativar uma chave do produto válida.

Especifica a chave do produto a ser usada para a ativação on-line.

\-t, --trial

**Observação**: essa opção está disponível apenas nas versões anteriores a 2023.3.0. Para licenciamento de avaliação com versões posteriores, entre em contato com o representante da sua conta.

Obrigatório ao ativar uma licença de avaliação.

Ativa uma licença de avaliação gratuita.

## tsm licenses atr-configuration get

Exibir a duração da ATR (Server) de autenticação a execução. A duração da ATR é o tempo que o Tableau Server está autorizado a executar antes que a licença seja renovada.

### Sinopse

`tsm licenses atr-configuration get --duration [global options]`

### Opções

\--duration

Exibe a ATR (autenticação para execução atual) em segundos. Por exemplo, 432000 (5 dias).

## tsm licenses atr-configuration set

Define a duração da ATR (Server) de autenticação a execução. A duração da ATR é o tempo que o Tableau Server está autorizado a executar antes que a licença seja renovada.

### Sinopse

`tsm licenses atr-configuration set --duration <duration_in_seconds> [global options]`

### Opções

\--duration <duration\_in\_seconds>

Define a duração da autorização para execução (ATR) (em segundos). Por exemplo, 432000 (5 dias).

## tsm licenses deactivate

Desativa uma chave do produto do Tableau Server, on-line ou off-line.

Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de command.

### Sinopse

`tsm licenses deactivate --license-key <product-key> [global options]`

### Opções

\-f, --license-file <return\_file.tlr>

Obrigatório ao fazer a desativação off-line.

Especifica o arquivo de licença (<file>.tlf) usado para a desativação off-line.

\-k, --license-key <product-key>

Obrigatório ao desativar uma chave do produto.

Especifica a chave do produto a ser usada para a desativação on-line.

## tsm licenses get-offline-activation-file

Gera um arquivo de ativação off-line para usar em uma ativação off-line do Tableau Server. Para saber mais, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).

**Observação:** você só pode ativar uma chave de produto por vez, a menos que esteja usando o Server ATR. Com o Server ATR, você pode fornecer uma lista delimitada por vírgulas de chaves de produto no arquivo de ativação offline para ativar simultaneamente várias chaves de produto.

### Sinopse

`tsm licenses get-offline-activation-file --license-key <product-key> --output-dir <path> [global options]`

### Opções

\-k, --license-key <product-key>

Obrigatório.

Especifica a chave do produto a ser usada para a ativação off-line.

\-o, --output-dir <path>

Obrigatório.

A localização em que o arquivo de ativação off-line deve ser salvo. Este local deve existir.

## tsm licenses get-offline-deactivation-file

Gera um arquivo de desativação off-line para usar em uma desativação off-line do Tableau Server. Para saber mais, consulte [Desativar o Tableau Server offline](https://help.tableau.com/current/server/pt-br/deactivate_off.htm).

### Sinopse

`tsm licenses get-offline-deactivation-file --license-key <product-key> --output-dir <path> [global options]`

### Opções

\-k, --license-key <product-key>

Obrigatório.

Especifica a chave do produto a ser usada para a desativação off-line.

\-o, --output-dir <path>

Obrigatório.

A localização existente em que o arquivo de desativação off-line deve ser salvo.

## tsm licenses list

Lista licenças ativadas na implantação do Tableau Server.

Por exemplo, um servidor com cinco licenças Creator (Criador), cinco licenças Explorer (Explorador), 100 licenças Viewer (Visualizador) e Data Management forneceria uma saída de comando semelhante a seguinte:

![Lista de quatro licenças do Tableau e detalhes sobre suas datas de expiração.](/tableau/current/pt-br/server/pt-br/Img/license_list.png)

Os seguintes campos retornam:

- **CHAVE:** uma cadeia de 16 caracteres globalmente exclusiva que identifica a licença.
- **TIPO:** descreve o tipo de licença
    - Prazo: as licenças com prazo mapeiam para um cronograma de assinatura e devem ser renovadas. A data de validade está listada no campo LIC EXP.
    - Perpétua: as licenças perpétuas são compradas uma vez e não precisam ser renovadas, mas devem ser atualizadas para atualizar o MAINT EXP ou a data de expiração da manutenção.
    - Principais: as licenças principais são licenças que mapeiam a quantidade de núcleos nos computadores que executam serviços específicos do Tableau Server. O licenciamento principal permite o acesso de um usuário convidado a exibições no servidor ou inseridas a outros servidores da Web. As licenças principais também permitem usuários ilimitados Explorer (Explorador) e Viewer (Visualizador).
- **CREATOR:** a quantidade de licenças Creator (Criador) emitidas para a implantação do Tableau Server.
- **EXPLORER:** a quantidade de licenças Explorer (Explorador) emitidas para a implantação do Tableau Server.
- **VIEWER:** a quantidade de licenças Viewer (Visualizador) emitidas para a implantação do Tableau Server.
- **GERENCIAMENTO DE DADOS**: o Tableau Server é licenciado com Data Management (`True` /`False`). Consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm).
- **ACESSO DE CONVIDADO**: o Tableau Server é licenciado para um usuário convidado. Consulte [Usuário Convidado](https://help.tableau.com/current/server/pt-br/users_guest.htm). A capacidade de aproveitar um usuário convidado requer licenciamento principal. Veja o campo TYPE.
- **LIC EXP**: a data de expiração da licença e que o Tableau Server deixará de funcionar. As licenças com prazo expiram. Veja o campo TYPE. Visite o [Portal do Cliente](https://customer.tableausoftware.com/) do Tableau para atualizar as licenças.
- **MAINT EXP**: aplica-se apenas a licenças perpétuas antigas (TYPE = Perpétua). Para licenças com prazo, este campo exibirá `N/A`. MAINT EXP exibe a data em que expira o contrato de manutenção da implantação Tableau Server. Para atualizar a chave de manutenção da licença, consulte [Atualizar data de expiração e atributos da chave do produto](https://help.tableau.com/current/server/pt-br/license_refresh.htm). Visite o [Portal do Cliente](https://customer.tableausoftware.com/) do Tableau para ver o histórico de compras de manutenção e comprar uma manutenção adicional.
- **UPDATABLE**: especifica se a licença é uma licença de assinatura updatable (`True`/`False`.
- **LBLM**: especifica se o gerenciamento de licenças baseado em login (LBLM) está ativado para a implantação do Tableau Server (`True`/ /`False`). Quando habilitado, o LBLM permite que os usuários façam logon no Tableau Server para licenciar sua instância do Tableau Desktop ou Prep, em vez de inserir uma chave de produto. Para obter mais informações sobre LBLM, consulte [Gerenciamento de licenças baseadas em logon](https://help.tableau.com/current/server/pt-br/license_lblm.htm).
- **SERVER MANAGEMENT**: o Tableau Server é licenciado para Advanced Management (Server Management Add-on) (`True`/`False`). Para obter mais informações sobre o Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

### Sinopse

`tsm licenses list [global options]`

## tsm licenses refresh

Atualiza a data de vencimento da manutenção de todas as chaves de produto no Tableau Server.

Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, [Configurar operações da chave do produto com proxy de encaminhamento](https://help.tableau.com/current/server/pt-br/activate_proxy.htm), antes de command.

### Sinopse

`tsm licenses refresh [global options]`

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=071e6889d802b5f57ff3a997d387a29246df297d9ecb159fa46e1ed8259c07f3 url=/tableau/current/pt-br/server/cli_login.md -->

[Pular para o conteúdo principal](#main-content)

# tsm login

Use o comando `tsm login` para conectar o Tableau Services Manager de um nó remoto.

Se a conta que está conectado for um membro do grupo TSM autorizado, não será necessário fornecer credenciais para executar comandos ao executar o CLI do tsm localmente. Para obter mais informações, consulte [Autenticação com a CLI tsm](https://help.tableau.com/current/server/pt-br/tsm.htm#Authenti).

### Sinopse

`tsm login [global options]`

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=8c322f472d099f4d9bf3f32ade3b7479f1432d32f63b3968c320cf4e4b4e05d4 url=/tableau/current/pt-br/server/cli_logout.md -->

[Pular para o conteúdo principal](#main-content)

# tsm logout

É possível usar o comando `tsm logout` para sair do Tableau Services Manager (TSM).

### Sinopse

`tsm logout [global options]`

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=dc799f9401366901883b8caff7cd1d1babd42118dcd56e4d39b6c3b8e20cbea2 url=/tableau/current/pt-br/server/cli_maintenance_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm maintenance

Use os comandos `tsm maintenance` para gerenciar tarefas de manutenção do servidor, como criar backups ou restaurar o Tableau Server de um backup criado anteriormente.

- [tsm maintenance backup](#tsm)
- [tsm maintenance cleanup](#cleanup)
- tsm maintenance jmx
    - [tsm maintenance jmx disable](#jmx_disable)
    - [tsm maintenance jmx enable](#jmx_enable)
- tsm maintenance log-levels
    - [tsm maintenance log-levels list](#log-levels_list)
    - [tsm maintenance log-levels reset](#log-levels_reset)
- tsm maintenance metadata-services
    - [tsm maintenance metadata-services disable](#cat_disable)
    - [tsm maintenance metadata-services enable](#cat_enable)
    - [tsm maintenance metadata-services get-status](#cat_status)
- tsm maintenance preflight-check
    - [tsm maintenance preflight-check permissions](#tsmmaintenance_preflight_perms)
    - [tsm maintenance preflight-check ports](#tsmmaintenance_preflight_ports)
- [tsm maintenance reindex-search](#tsmmaintenancereindex)
- [tsm maintenance reset-searchserver](#tsm_maint_reset_searchsvr)
- [tsm maintenance restore](#tsm3)
- [tsm maintenance send-logs](#tsmSendLogs)
- tsm maintenance snapshot-backup (armazenamento de arquivo externo)
    - [tsm maintenance snapshot-backup complete](#tsm_snapshot_backup_complete)
    - [tsm maintenance snapshot-backup prepare](#tsm_snapshot_backup_prepare)
    - [tsm maintenance snapshot-backup restore](#tsm_snapshot_restore)
- [tsm maintenance validate-backup-basefilepath](#tsmValidateBackupBasefilepath)
- [tsm maintenance validate-resources](#tsmValidateResources)
- [tsm maintenance ziplogs](#tsm4ziplogs)

## tsm maintenance backup

Cria um backup dos dados gerenciados pelo Tableau Server. Esses dados incluem o banco de dados PostgreSQL do Tableau (o repositório), que contém pasta de trabalho e metadados do usuário, além de arquivos de extração (arquivos .hyper e arquivos .tde para versões 2024.2 e anteriores). Estes dados não incluem os dados de configuração. Consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).

**Observação:** não use esse comando nas instalações do Tableau Server com Armazenamento de arquivos externo. Consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm).

**Otimização com configurações de topologia:**

- Colocalizar o Armazenamento de arquivos no mesmo nó que o Controlador de administração pode reduzir o tempo necessário para fazer backup do Tableau Server, reduzindo ou eliminando a necessidade de transferir dados entre nós durante o processo de backup. Isso é especialmente verdade se sua organização usa muitos extratos.
- A colocalização do repositório (pgsql) com o nó Controlador de administração também pode ajudar a reduzir o tempo de backup, mas a economia de tempo é menos significativa do que a do Armazenamento de arquivos.

O Controlador de administração geralmente está no nó inicial, a menos que você tenha tido uma falha no nó inicial e movido o controlador para outro nó.

O arquivo de backup é reunido em um local temporário no diretório de dados e, em seguida, gravado no diretório definido na variável `basefilepath.backuprestore` do TSM. Como padrão:

`` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ```<filename>.tsbak`

Para obter mais informações sobre os arquivos de backup e como alterar o local, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm). **Observação:** mesmo ao alterar o local do backup, o processo de backup usa um local temporário no diretório de dados para reunir o arquivo de backup.

### Sinopse

`tsm maintenance backup --file <backup_file> [options] [global options]`

### Opções

\-f, --file <backup\_file>

Obrigatório.

Para obter mais informações sobre como fazer backup dos dados do repositório, consulte [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm).

\-d, --append-date

Opcional.

Anexa a data atual ao fim do nome do arquivo de backup.

**Observação:** backups criados usando uma agenda incluem automaticamente uma data/hora no início do nome do arquivo de backup. Se você também usa a opção `-d`, seu nome de arquivo incluirá a data duas vezes. Para obter mais informações sobre o agendamento de backups, consulte [Agendamento e gerenciamento de backups](https://help.tableau.com/current/server/pt-br/db_backup.htm#ScheduleBackups).

\-i, --description <string>

Opcional.

Inclui a descrição detalhada do arquivo de backup.

\--ignore-prompt

Opcional. Adicionado na versão 2020.2.

Faça backup sem perguntar, mesmo se o Armazenamento de arquivos não estiver no mesmo nó que o Controlador de administração (geralmente, o nó inicial). Use este prompt se estiver automatizando backups (por exemplo, com scripts).

\-k, --skip-verification

Opcional.

Não verifica a integridade do backup de banco de dados.

\--multithreaded

Opcional. Adicionado na versão 2021.1

Por padrão, um único segmento é usado ao criar um backup do Tableau Server. Quando essa opção é especificada, um backup é criado usando vários segmentos. Dois segmentos são usados por padrão, quando essa opção é especificada. Você pode alterar o número de segmentos usados definindo a chave de configuração `[backup.zstd.thread_count](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#backup_threads)`.

\--override-disk-space-check

Opcional.

Tentará criar um backup mesmo se houver um aviso de pouco espaço no disco.

\-po, --pg-only

Opcional.

Gera somente o backup de repositório.

**Importante:** não use a opção `pg-only` ao gerar um backup, a menos que seja instruído pelo Suporte do Tableau. Essa opção fará backup apenas do repositório e _não pode_ ser usada para restaurar seu servidor. Seu uso principal é para solução de problemas, e o Suporte do Tableau solicitará que você crie um backup de `--pg-only` se for necessário.

\--request-timeout <tempo limite em segundos>

Opcional.

Número de segundos para esperar o comando terminar. O valor padrão é 86.400 (1.440 minutos).

\-sd, --schedule-days <day\[,day\]>

Opcional. Adicionado na versão 2020.4.

Dias para executar a agenda. Use 1-7 para agendamento semanal (1 para segunda-feira, 7 para domingo), 1-31 para horários mensais (se um mês não incluir o dia especificado, o último dia do mês é utilizado). Separe vários valores por vírgulas.

\-si, --schedule-id <ID>

Opcional. Adicionado na versão 2020.4.

Especifique a ID de um cronograma existente que deseja atualizar.

\--skip-compression

Opcional.

Crie um backup sem usar a compactação. Isso resulta em um arquivo de backup maior, mas pode reduzir a quantidade de tempo que leva para concluir o backup. Caso use em uma instalação em vários nós, recomendamos fortemente que tenha uma instância Armazenamento de arquivos configurada no nó inicial.

\-sn, --schedule-name <name>

Opcional. Adicionado na versão 2020.4.

Especifique o nome de uma agenda que você está criando ou atualizando.

\-sr, --schedule-recurrence <frequency>

Opcional. Adicionado na versão 2020.4.

Frequência de recorrência de agenda. As opções válidas são "diárias", "semanais" ou "mensais".

\-st, --schedule-time <HH:MM>

Opcional. Adicionado na versão 2020.4.

O horário em que a agenda deve ser executada, em formato de 24 horas: HH:MM.

### Exemplos

Este exemplo cria um backup chamado `ts_backup-<yyyy-mm-dd>.tsbak` na pasta `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\`:

`tsm maintenance backup -f ts_backup -d`

Este exemplo cria uma agenda de backup semanal recorrente chamada "weekly-saturday-backup" que é executado todos os sábados ao meio-dia e cria um backup chamado `<yyyy.mm.dd.hh.mm>-ts_saturday_backup.tsbak`:

tsm maintenance backup -f ts\_saturday\_backup -sr weekly -st 12:00 -sd 6 -sn weekly-saturday-backup

Para obter mais detalhes sobre como gerenciar backups programados, consulte [Agendamento e gerenciamento de backups](https://help.tableau.com/current/server/pt-br/db_backup.htm#ScheduleBackups).

## tsm maintenance cleanup

Por padrão, o comando `tsm maintenance cleanup` exclui arquivos temporários e arquivos de log com mais de um dias. As opções de comando podem modificar a duração e quais são excluídos. **Observação:** esse comando não exclui arquivos de despejo de falha.

O Impacto desse comando depende de o Tableau Server estar em execução.

- Se o servidor estiver em execução, a maioria dos arquivos antigos e as entradas de tabela `http_requests` poderão ser excluídas, mas os arquivos no diretório temporário de qualquer processo do Tableau Server não serão excluídos se o processo estiver em execução. Para garantir a limpeza completa de todos os arquivos temporários, você deve parar o servidor antes de executar este comando. Para excluir as entradas da tabela `http_requests`, use a opção `-q`.
- Se o servidor estiver parado as entradas `http_requests` não podem ser excluídas.

Se estiver executando o Tableau Server em uma implantação distribuída, execute esse comando no nó com o processo do Controlador de administração em execução (também chamado _Controlador do TSM_). Por padrão e na maioria dos casos, o controlador encontra-se no nó inicial do cluster.

### Sinopse

`tsm maintenance cleanup [options] [global options]`

### Opções

\-a, --all

Opcional.

Executar todas as operações de limpeza com valores de retenção padrão. Equivalente a executar o comando `cleanup` com as seguintes opções: `-l -t -r -q -ic`.

\--http-requests-table-retention <nº de dias>

Opcional.

Padrão: 7 dias

Especifique o número de dias das entradas da tabela `http_requests` que devem ser mantidos. Utilize esta opção com a opção `-q` para especificar o número de dias de entradas da tabela a serem retidas, substituindo o padrão de 7 dias. Essa opção especifica o tempo de retenção de entrada da tabela, mas não aciona a exclusão real de entradas da tabela. Use isso junto com a opção `-q`, que aciona a exclusão de entradas.

\-ic, --sheet-image-cache

Opcional. Adicionado na versão 2019.4.

Limpar o cache de imagens. Esse cache pode conter imagens de visualizações offline, instantâneos das mensagens de e-mail de assinatura e PDFs de assinatura, bem como qualquer imagem solicitada no endpoint da API Rest de publicação (consulte [rest\_api\_ref. htm](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_view_image) para mais informações).

\-l, --log-files

Opcional.

Exclua arquivos de log mais antigos que 1 dia. Arquivos nos subdiretórios em `data\tabsvc\logs` serão excluídos.

\--log-files-retention <# of days>

Opcional.

Padrão: 1 (24 horas)

Exclui registros mais antigos do que este número de dias. Use isto para substituir o período de retenção padrão de 1 dia. Este comando não se aplica aos arquivos temporários.

\-q, --http-requests-table

Opcional.

Excluir entradas de tabela `http_requests` antigas. O Tableau Server deve ser executado para que as entradas da tabela sejam excluídas. Essa opção é ignorada se o Tableau Server for interrompido. Essa opção pode ser usada sozinha para especificar a exclusão de entradas mais antigas do que o período de retenção padrão (7 dias) ou junto com `--http-requests-table-retention` para especificar um período de retenção não padrão.

**Observação:** excluir as entradas de tabela `http_requests` remove permanentemente os dados disponíveis para exibições administrativas personalizadas. Certifique-se de que a remoção desses dados não afetará as exibições personalizadas que você precise.

\-r, --redis-cache

Opcional.

Limpar o cache Redis.

\--request-timeout <tempo limite em segundos>

Opcional.

Padrão: 3600

Aguarde o tempo predefinido para que o comando seja concluído.

\-t, --temp-files

Opcional.

Exclui todos os arquivos e subdiretórios dentro dos seguintes diretórios:

- `<install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\temp`: para excluir arquivos em cada diretório de processo do Tableau Server, você deve parar o Tableau Server antes de executar o comando.
- `<install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\httpd\temp`
- `<install dir>\ProgramData\Tableau\Tableau Server\temp`

### Exemplos

Este exemplo limpa todos os arquivos de registro mais antigos do que 2 dias atrás:

`tsm maintenance cleanup -l --log-files-retention 2`

## tsm maintenance jmx disable

**Versão:** comando adicionado na versão 2022.1.

Use o comando `tsm maintenance jmx disable` para desativar o JMX no Tableau Server.

A execução deste comando requer uma reinicialização do Tableau Server, incluindo serviços TSM.

### Sinopse

tsm maintenance jmx disable \[options\] \[global options\]

### Opções

\--ignore-prompt

Opcional.

Desative o JMX sem avisar.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance jmx enable

**Versão:** comando adicionado na versão 2022.1.

Use o comando `tsm maintenance jmx enable` para ativar o JMX no Tableau Server.

Esse comando é interativo, solicitando opções aplicáveis se você não as fornecer como parâmetros de linha de comando.

Este comando requer uma reinicialização do Tableau Server, incluindo serviços TSM.

### Sinopse

```
tsm maintenance jmx enable
```

### Opções

\--access <readonly | readwrite>

Opcional.

Ative o JMX com acesso somente leitura ou leitura e gravação. O padrão é `readonly`.

\--ignore-prompt

Opcional.

Ative o JMX sem solicitar opções de segurança adicionais. Isso habilita o JMX com SSL e reinicia o Tableau Server se você não incluir nenhuma outra opção de comando. Por exemplo:

tsm maintenance jmx enable --ignore-prompt

\--no-ssl

Opcional.

Ative o JMX sem SSL.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

\--ssl-client-auth

Opcional.

Ative o JMX que requer autenticação de cliente para SSL.

\--unsecured

Opcional.

Ative o JMX sem recursos de segurança ativados (isso não é recomendado). Isso é o equivalente a definir a chave de configuração `[service.jmx_enabled](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#service_jmx_enabled)` para `true` nas versões anteriores a 2022.1.

## tsm maintenance log-levels list

**Versão:** comando adicionado na versão 2026.2.

Use o comando `tsm maintenance log-levels list` para exibir uma lista em ordem alfabética de todas as configurações de registro e seus valores.

### Sinopse

```
tsm maintenance log-levels list [global options]
```

### Opções

Este comando usa apenas opções globais.

## tsm maintenance log-levels reset

**Versão:** comando adicionado na versão 2026.2.

Use o comando `tsm maintenance log-levels reset` para definir todas as configurações de log como seus valores padrão. Executar este comando faz alterações em `tsm pending-changes list`. A lista mostra apenas os registro alterados e indica se uma reinicialização do Tableau Server é necessária.

Aplique as alterações com `tsm pending-changes apply` ou descarte-as com `tsm pending-changes discard`.

Para obter mais informações, consulte [tsm pending-changes](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm) e [Alterar níveis de registro](https://help.tableau.com/current/server/pt-br/logs_debug_level.htm).

### Sinopse

```
tsm maintenance log-levels reset [global options]
```

### Opções

Este comando usa apenas opções globais.

## tsm maintenance metadata-services disable

**Versão:** comando adicionado na versão 2019.3.

Use o comando `tsm maintenance metadata-services disable` para habilitar a API de metadados do Tableau para o seu servidor.

Desabilitar a API de metadados interrompe a inserção e a indexação contínuas de informações sobre o conteúdo no Tableau Server, exclui o índice de informações sobre o conteúdo publicado no Tableau Server e ativos associados a esse conteúdo e desabilita a capacidade de consultar a API de metadados e acessar o Tableau Catalog.

A execução desse comando interrompe e inicia alguns serviços usados pelo Tableau Server, que faz com que determinadas funcionalidades, como o Recomendações, fiquem temporariamente indisponíveis para os usuários.

### Sinopse

```
tsm maintenance metadata-services disable
```

### Opção

\--ignore-prompt

Opcional.

Ignore o prompt de confirmação ao desabilitar a API de metadados.

## tsm maintenance metadata-services enable

**Versão:** comando adicionado na versão 2019.3.

Use o comando `tsm maintenance metadata-services enable` para habilitar a API de metadados do Tableau para o Tableau Server.

Se o Tableau Server estiver licenciado com o Data Management, a ativação da API de metadados habilitará o Tableau Catalog.

Ao habilitar a API de metadados, as informações sobre o conteúdo no Tableau Server são aceitas e, em seguida, indexadas para o Armazenamento de API de metadados. A API de metadados pode ser usada para consultar esquema, linhagem e metadados gerenciados pelo usuário sobre o conteúdo publicado no Tableau Server. Após habilitar a API de metadados, os metadados são continuamente inseridos e indexados até que a API de metadados seja desabilitada.

Ao executar este comando, lembre-se do seguinte:

- Este comando interrompe e inicia alguns serviços usados pelo Tableau Server, que faz com que determinadas funcionalidades, como o Recomendações, fiquem temporariamente indisponíveis para os usuários.
- Um novo índice de metadados é criado e substitui o índice anterior sempre que esse comando é usado.

Para obter mais informações sobre o Tableau Catalog, consulte [Sobre o Tableau Catalog](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm).

### Sinopse

```
tsm maintenance metadata-services enable
```

### Opção

\--ignore-prompt

Opcional.

Ignore o prompt de confirmação ao habilitar a API de metadados.

## tsm maintenance metadata-services get-status

**Versão:** comando adicionado na versão 2019.3.

Use o comando `tsm maintenance metadata-services get-status` para obter informações de status sobre os Serviços de Metadados.

Status nos Serviços de Metadados indica se o Repositório de API de Metadados foi inicializado ou se a API de Metadados do Tableau está em execução ou não.

### Sinopse

```
tsm maintenance metadata-services get-status
```

## tsm maintenance preflight-check permissions

**Versão:** comando adicionado do Tableau Server no Windows na versão 2020.3.

Use o comando `tsm maintenance preflight-check permissions` para verificar as permissões de diretório.

### Sinopse

`tsm maintenance preflight-check permissions [options] [global options]`

### Opção

\-d, --data-dir <data directory>

Opcional.

Especifica o diretório de dados em que as permissões devem ser verificadas. Se não for incluído, o diretório de dados é determinado com base na configuração atual do Tableau Server.

\-i, --install-dir <install directory>

Opcional.

Especifica o diretório de instalação em que as permissões devem ser verificadas. Se não for incluído, o diretório de instalação é determinado com base na configuração atual do Tableau Server.

\-n --nodes <nodeID,nodeID,...>

Opcional.

IDs dos nós para incluir especificamente na verificação de permissões. Se não for especificado, a verificação é realizada em todos os nós do cluster.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

\-ru --runas-user <timeout in seconds>

Opcional.

O nome Usuário Run As para verificar permissões. Se não for fornecido, o usuário Run As é determinado na configuração atual.

## tsm maintenance preflight-check ports

**Versão:** comando adicionado do Tableau Server no Windows na versão 2020.3.

Use o comando `tsm maintenance preflight-check ports` para verificar se as portas estão disponíveis para todos os serviços instalados no momento. Especifique um serviço e uma porta para verificar se a porta está disponível para esse serviço, mesmo que o serviço não esteja instalado no momento.

### Sinopse

`tsm maintenance preflight-check ports [options] [global options]`

### Opção

\-a, --tabadminagent-addresses <hostname:port>

Opcional.

Especifica o host e a porta em que o acesso ao Agente de administração deve ser verificado. Os endereços são formatados como `hostname:port`. Separe vários endereços por vírgulas, se mais de um estiver sendo verificado. Use essa opção para verificar se uma porta está disponível, antes de instalar ou alterar as portas.

\-g, --gateway-addresses <hostname:port>

Opcional.

Especifica o host e a porta em que o serviço Gateway deve ser verificado. Os endereços são formatados como `hostname:port`. Separe vários endereços por vírgulas, se mais de um estiver sendo verificado. Use essa opção para verificar se uma porta está disponível, antes de instalar ou alterar as portas.

\-n --nodes <nodeID,nodeID,...>

Opcional.

IDs dos nós para executar a verificação de preflight. Se não for especificado, as verificações são realizadas em todos os nós do cluster.

\-r, --repository-addresses <hostname:port>

Opcional.

Especifica o host e a porta em que o serviço de Repositório deve ser verificado. Os endereços são formatados como `hostname:port`. Separe vários endereços por vírgulas, se mais de um estiver sendo verificado. Use essa opção para verificar se uma porta está disponível, antes de instalar ou alterar as portas.

\-re --remote

Opcional.

Verifica o acesso remoto ao Agente de administração de todos os nós. Não é realizado por padrão.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

\-t, --tabadmincontroller-addresses <hostname:port>

Opcional.

Especifica o host e a porta em que o Controlador de administração deve ser verificado. Os endereços são formatados como `hostname:port`. Separe vários endereços por vírgulas, se mais de um estiver sendo verificado. Use essa opção para verificar se uma porta está disponível, antes de instalar ou alterar as portas.

## tsm maintenance reindex-search

Use o comando `tsm maintenance reindex-search` para recriar o índice de pesquisa.

### Sinopse

`tsm maintenance reindex-search [options] [global options]`

### Opção

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance reset-searchserver

**Versão:** esse comando foi descontinuado (removido) em 2023.3.0 quando o Search and Browse (também chamado de Search Server) foi descontinuado. Search and Browse foi substituído por Index and Search Server.

**Observação:** executar este comando na versão 2023.3.0 ou posterior não fará nada.

Redefine o servidor de pesquisa para um estado limpo, excluindo informações de pesquisa e recriando o índice de pesquisa.

### Sinopse

`tsm maintenance reset-searchserver [options] [global options]`

### Opção

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance restore

Restaura o Tableau Server usando o arquivo de backup indicado. A restauração de um arquivo de backup não restaura os dados de configuração. Consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm).

Só é possível restaurar a partir de um backup que tenha o mesmo tipo de armazenamento de identidades que o servidor que está rodando. Por exemplo, um backup de um servidor que usa autenticação local pode ser restaurado para um Tableau Server inicializado por autenticação local, mas um backup de um servidor que usa autenticação por Diretório ativo não pode ser restaurado para um servidor inicializado por autenticação local.

A partir da versão 2022.3, não há suporte para backups criados usando tabadmin ("backups pré-TSM"). Você não pode restaurar um backup pré-TSM para Tableau Server versão 2022.3 ou posterior.

### Sinopse

`tsm maintenance restore --file <file_name> [--restart-server] [global options]`

### Opções

\-f, --file <file\_name>

Obrigatório.

Especifica o arquivo de backup do qual deve ser restaurado.

O comando `restore` exige um arquivo de backup no diretório definido na variável `basefilepath.backuprestore` do TSM. Como padrão:

`` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ``

Para obter mais informações sobre os caminhos do arquivo e como alterá-los, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

\-ak, --asset-key-file <file\_name>

Opcional. Obsoleto na versão 2021.4.0.

Especifique esta opção somente se estiver restaurando dos ativos criados pelo tabadmin no Tableau Server (versões 2018.1 e anteriores).

O nome do arquivo da chave de recurso a ser restaurado. O arquivo da chave de recurso é criado pelo comando `tabadmin assetkeys`. O arquivo deve estar no local predefinido de backup/restauração do servidor.

\-k, --skip-identity-store-verification

Opcional. Especifique esta opção somente se estiver restaurando de um arquivo de backup criado pelo tabadmin no Tableau Server (versões 2018.1 e anteriores).

Não use essa chave na tentativa de alterar o tipo de repositório de identidades do Tableau Server que criou arquivo de backup original. Para mudar o repositório de identidades, consulte [Alterar o Repositório de identidades](https://help.tableau.com/current/server/pt-br/reconfig_change_auth.htm).

\-po, --pg-only

Opcional.

Restaure somente o repositório.

\-r, --restart-server

Opcional.

Reinicia o servidor após a restauração.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance send-logs

Faz o upload do arquivo especificado no Tableau e o associa a um caso de suporte. Para fazer upload de arquivos com sucesso para o Tableau, o Servidor Tableau deve se comunicar com o servidor de send-logs. Para obter mais obter detalhes completos, consulte [Como se comunicar com a Internet](https://help.tableau.com/current/server/pt-br/plan_network.htm).

### Sinopse

`tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]`

### Opções

\-c,--case <case\_number>

Obrigatório.

Número do caso de suporte.

\-e,--email <contact\_email>

Obrigatório.

E-mail de contato.

\-f, --file <path/to/file>

Obrigatório.

Especifica a localização e o nome do arquivo de registro arquivado para envio.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance snapshot-backup complete

**Versão:**o comando é adicionado na versão 2020.1 e só disponível quando o Tableau Server estiver configurado para Armazenamento de arquivos externo.

Conclua o processo de backup de instantâneos no Tableau Server. Execute isso depois de ter feito um backup de instantâneo do armazenamento externo.

Os comandos _tsm maintenance snapshot-backup prepare_ e _tsm maintenace snapshot-backup complete_ são usados para criar um backup de dados do Tableau Server para instalações do Tableau Server configuradas com Armazenamento de arquivos externo. Para obter mais informações, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm)

### Sinopse

`tsm maintenance snapshot-backup complete [options] [global options]`

### Opções

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance snapshot-backup prepare

**Versão:**o comando é adicionado na versão 2020.1 e só disponível quando o Tableau Server estiver configurado para Armazenamento de arquivos externo.

Preparar para backup de instantâneos. Após concluir a etapa de preparação, você pode fazer um backup de instantâneos do armazenamento da rede.

Os comandos `tsm maintenance snapshot-backup prepare` e `tsm maintenace snapshot-backup complete` são usados para criar um backup dos dados do Tableau Server para instalações do Tableau Server configuradas com armazenamento de arquivo externo. Para obter mais informações, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm)

### Sinopse

`tsm maintenance snapshot-backup prepare [options] [global options]`

### Opções

\--include-pg-backup

Opcional. Adicionado na versão 2021.1. Versões anteriores sempre incluíam um backup do Repositório externo.

Opcional.

Um backup do Repositório é feito e copiado para o compartilhamento de rede. Isso só é aplicável às implantações em que tanto o Repositório externo quanto o Armazenamento de arquivos externos são configurados. Para obter mais informações, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm).

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance snapshot-backup restore

**Versão:**o comando é adicionado na versão 2020.1 e só disponível quando o Tableau Server estiver configurado para Armazenamento de arquivos externo.

Restaura o backup do repositório do instantâneo de armazenamento para o Tableau Server.

Para obter mais informações, consulte [Backup e restauração com o Armazenamento de arquivos externo](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_backup_restore.htm).

### Sinopse

`tsm maintenance snapshot-backup restore [options] [global options]`

### Opções

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance validate-backup-basefilepath

**Versão:** comando adicionado na versão 2022.1.

Valide se o local do caminho de arquivo base de backup/restauração tem as permissões corretas para permitir que as funções de backup e restauração funcionem corretamente. Execute isso depois de definir o caminho do arquivo base para backup e restauração. Para obter mais informações, consulte [Alterar locais atuais de caminho de arquivo base](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm#ChangeBasepath).

### Sinopse

`tsm maintenance validate-backup-basefilepath [options][global options]`

### Opções

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance validate-resources

Valida as pastas de trabalho e fontes de dados para um site. Use esse comando antes da migração de um site, para detectar problemas com os recursos do site, como pastas de trabalho e fontes de dados, que causarão falha na importação do site. Alguns problemas de recursos podem ser corrigidos republicando nas fontes locais. Outros problemas podem exigir assistência do Suporte do Tableau.

### Sinopse

`tsm maintenance validate-resources --site-id <site ID> [global options]`

### Opções

\-id,--site-id <site ID>

Obrigatório.

ID do site cujos recursos você está validando.

\-r,--repair

Opcional.

Tente reparar os recursos inválidos. Os que não podem ser reparados são anotados na saída.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído.

## tsm maintenance ziplogs

Usa o comando `ziplogs` para criar um armazenamento dos arquivos de log do Tableau Server.

### Sinopse

`tsm maintenance ziplogs [options] [global options]`

### Opções

\-a, --all

Opcional.

Inclui msinfo, netstat e dump mais recente. Equivalente a executar o comando com estas opções:`-mi -t -l`. Não inclui dados PostgreSQL.

\-d, --with-postgresql-data

Opcional.

Inclui a pasta de dados do PostgreSQL se o Tableau Server for interrompido, ou os arquivos de despejo do PostgreSQL, se o Tableau Server estiver sendo executado. Esse sinalizador é ignorado para implantações em execução com um [Repositório externo do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo.htm).

\--enddate "<mm/dd/yyyy H:mm>"

Opcional. Opção de tempo (`H:mm`) adicionado na versão 2021.4.0.

A data mais recente dos arquivos de registro a serem incluídos. Essa opção deve ser usada com `--startdate` e não pode ser usada com `--minimumdate`. Se essa opção não for especificada, até dois dias de registros serão incluídos, a partir de 00:00 GMT.

Se você incluir a opção de hora, deverá usar aspas em torno de data e hora. A opção de hora usa GMT, no entanto, os arquivos de registro resultantes serão gravados usando o fuso horário local da máquina do Tableau Server.

Exemplo: se o fuso horário local da máquina do Tableau Server for PDT e você quiser que os arquivos de registro comecem às 7h PDT e terminem às 19h PDT de 28/07/2022, use o seguinte:

```
tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"
```

\-f, --file <name>

Opcional.

Define um nome para o arquivo de armazenamento zipado. Se nenhum nome for fornecido, o armazenamento é criado como logs.zip. O arquivo está gravado no diretório definido na variável `basefilepath.log_archive` do TSM . Como padrão:

`C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\`

Para obter mais informações sobre os caminhos do arquivo e como alterá-los, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

\-i, --description <string>

Opcional.

Inclui a descrição detalhada do arquivo de armazenamento.

\-l, --with-latest-dump

Opcional.

Quando qualquer serviço falhar, o Tableau Server gerará um arquivo de despejo. Defina essa opção para incluir o arquivo de dump de falha de serviço mais recente. Se você não definir essa opção, então, nenhum arquivo de despejo será incluído no ziplog resultante.

\-m, --minimumdate <mm/dd/yyyy>

Opcional.

A data mais recente dos arquivos de log a serem incluídos. Se não for especificado, no máximo dois dias de arquivo de log são incluídos. O formato da data deve ser "`mm/dd/yyyy`". Essa opção não pode ser usada com `--startdate` e `--enddate` ou `--all`.

\-mi, --with-msinfo

Opcional.

Inclua o relatório msinfo32, com informações do sistema sobre o sistema operacional, o hardware e o software em execução.

\--nodes

Opcional. Adicionado na versão 2020.3.

Especifique os nós para os quais criar um arquivo ziplog. Se não especificados, os arquivos ziplogs são criados para todos os nós e salvos no nó inicial. Nós separados por vírgula. Por exemplo, para coletar logs para os nós 2 e 4:

tsm maintenance ziplogs --nodes node2,node4

\-o, --overwrite

Opcional.

Para a substituição de um arquivo ziplog existente. Se já existir um arquivo com o mesmo nome e essa opção não for usada, ocorrera uma falha no comando ziplogs.

Por padrão, o arquivo é gravado em:

`C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\`

Para obter mais informações sobre os caminhos do arquivo e como alterá-los, consulte [tsm File Paths](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

\--request-timeout <seconds>

Opcional.

Número de segundos para esperar o comando terminar. O valor padrão é 7.200 (120 minutos).

\--startdate "<mm/dd/yyyy H:mm>"

Opcional. Opção de tempo (`H:mm`) adicionado na versão 2021.4.0.

A data mais recente dos arquivos de registro a serem incluídos. Essa opção deve ser usada com `--enddate` e não pode ser usada com `--minimumdate`. Se essa opção não for especificada, até dois dias de registros serão incluídos, a partir de 00:00 GMT.

Se você incluir a opção de hora, deverá usar aspas em torno de data e hora. A opção de hora usa GMT, no entanto, os arquivos de registro resultantes serão gravados usando o fuso horário local da máquina do Tableau Server.

Exemplo: se o fuso horário local da máquina do Tableau Server for PDT e você quiser que os arquivos de registro comecem às 7h PDT e terminem às 19h PDT de 28/07/2022, use o seguinte:

```
tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"
```

\-t, --with-netstat-info

Opcional.

Incluir as informações de netstat.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=a908b5d1200bd45407049324006bab8ca4a7cf500dd00cfb78b2684b89df0207 url=/tableau/current/pt-br/server/cli_pending-changes.md -->

[Pular para o conteúdo principal](#main-content)

# tsm pending-changes

Use os comandos `tsm pending-changes` para aplicar, descartar ou visualizar alterações de configuração e de topologia pendentes no Tableau Server.

As senhas e os segredos inseridos durante a configuração do TSM são criptografados após salvá-los. Os segredos permanecem criptografados até, durante e depois de você aplicar as alterações pendentes. Para obter mais informações sobre o armazenamento de segredos, consulte [Gerenciar segredos do servidor](https://help.tableau.com/current/server/pt-br/security_secret_storage.htm#Understa).

- [tsm pending-changes apply](#pending-changes-apply)
- [tsm pending-changes discard](#pending-changes-discard)
- [tsm pending-changes list](#pending-changes-view)

## tsm pending-changes apply

Use o comando `tsm pending-changes apply` para aplicar alterações de configuração ou topologia pendentes do Tableau Server.

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.

### Sinopse

`tsm pending-changes apply [global options]`

### Opções

\-iw, --ignore-warnings

Opcional.

Ignore restrições em nível de alerta.

\--ignore-prompt

Opcional.

Cancela o prompt de reinicialização. Isso cancela apenas o prompt. O comportamento de reinicialização fica inalterado.

\--request-timeout <tempo limite em segundos>

Opcional.

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

## tsm pending-changes discard

Usa o comando `tsm pending-changes discard` para descartar alterações de configuração ou topologia pendentes do Tableau Server.

### Sinopse

`tsm pending-changes discard [options] [global options]`

### Opções

\--config-only

Opcional.

Descarta apenas as alterações de configuração pendentes.

\--topology-only

Opcional.

Descarta apenas as alterações de topologia pendentes.

## tsm pending-changes list

Lista as alterações de configuração e topologia pendentes para o Tableau Server. As alterações que não exijam uma reinicialização do servidor serão listadas como não exigindo uma reinicialização. Se nenhuma das alterações pendentes exigir uma reinicialização, uma mensagem será exibida dizendo que as alterações não requerem uma reinicialização do servidor. Se alguma alteração na lista exigir uma reinicialização, toda a lista de alterações pendentes resultará em uma reinicialização. Para obter mais informações sobre configuração dinâmica ou alterações de topologia, consulte [Alterações de topologia dinâmica do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_hot_topo.htm).

### Sinopse

`tsm pending-changes list [options] [global options]`

### Opções

\--config-only

Opcional.

Lista apenas as alterações de configuração pendentes.

\--topology-only

Opcional.

Lista apenas as alterações de topologia pendentes.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=d3a4e691f7d76c88974744071dd47ba8493f0afa4021ce16aaf775723730fb8c url=/tableau/current/pt-br/server/cli_register_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm register

É possível usar o comando `tsm register` para registrar o Tableau Server. Esse comando permite exibir o modelo do arquivo de registro (por meio da opção `--template`) ou fornecer o caminho para um arquivo de registro completo (por meio da opção `--file`). É obrigatório o uso de uma dessas duas opções ao chamar o comando `tsm register`.

### Sinopse

`tsm register --template | --file <registration-filename> [global options]`

### Opções

\--file <registration-filename>

Obrigatório.

Caminho para o arquivo que contém os dados de registro.

\--template

Obrigatório.

Exibe o modelo do arquivo de registro.

### Campos de registro

O arquivo de registro contém estes campos.

`first_name`

O nome da pessoa que está registrando Tableau Server.

`last_name`

O sobrenome da pessoa que está registrando Tableau Server.

`phone`

O número de telefone da pessoa de contato referente a este registro.

`email`

O endereço de e-mail da pessoa de contato referente a este registro.

`company`

O nome da organização que está registrando Tableau Server.

`industry`

O setor da organização.

`company_employees`

O número de funcionários na organização.

`department`

O departamento da pessoa que está registrando Tableau Server dentro da organização.

`title`

O cargo da pessoa que está registrando Tableau Server.

`city`

A cidade em que a organização ou o indivíduo está localizado.

`state`

O estado ou província onde a organização ou o indivíduo está localizado.

`zip`

O código postal ou CEP onde a empresa ou o registro individual está localizado.

`country`

O país em que a organização ou o indivíduo está localizado.

`opt_in`

Indica sua preferência para receber comunicações de marketing do Tableau. O valor padrão é `false` para muitos países. Leis específicas de cada país podem afetar o padrão para esse campo. Para obter mais informações, consulte [Informações de privacidade](https://www.salesforce.com/ap/company/privacy/) no site do Salesforce.

`eula`

Confirma que você aceita o Contrato de licença do usuário final (EULA). O valor padrão é `accept`. Você deve aceitar o EULA para usar o Tableau Server. Se você não aceitar, não poderá executar o Tableau Server.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=3ff309d8f753fe65b13d5d326b81b4499346586901c6040366746deaaf055eb1 url=/tableau/current/pt-br/server/cli_reset_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm reset

Use o comando `tsm reset` para limpar o usuário administrador inicial para que possa inserir um novo. Depois de executar o `tsm reset`, é necessário executar novamente o comando `tabcmd [initialuser](https://help.tableau.com/current/server/pt-br/tabcmd_cmd.htm#initialu)` para criar um novo administrador inicial. O novo nome não pode ser o mesmo nome de usuário do antigo usuário administrador.

Para usar o usuário administrador inicial existente:

1. Execute `tsm reset` para redefinir o usuário inicial existente.
2. Execute `tabcmd initialuser` para criar um novo administrador inicial.
3. Execute `tsm reset` para redefinir o novo usuário administrador.
4. Execute `tabcmd initialuser` para recriar o administrador inicial original.

Se a sua organização estiver usando o Active Directory ou o LDAP para o repositório de identidades do Tableau, a conta e a senha especificadas deverão corresponder a uma conta no diretório.

### Sinopse

`tsm reset[option] [global options]`

### Opção

\-d,--delete-all-sessions

Opcional.

Excluir todas as sessões de usuário ativo quando o servidor for redefinido.

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 1800 (30 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=0fa2384f69b7dc726f937121789825475d46d8dae5cabb1b5ffff68a281ba3c7 url=/tableau/current/pt-br/server/cli_restart_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm restart

Use o comando `tsm restart` para reiniciar o Tableau Server. O comando interrompe o servidor, se necessário, e então o inicia.

### Sinopse

`tsm restart [global options]`

### Opção

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 1800 (30 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=e5771e8072512ffbcebc44a0007a93760daaacf5849a526af8f3b608626ae98d url=/tableau/current/pt-br/server/cli_schedules_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm schedules

**Observação:** esses comandos se aplicam apenas a tarefas de backup agendadas usando o comando tsm maintenance backup. Eles não se aplicam a trabalhos executados pelo processador em segundo plano (exemplo: atualizações de extração, fluxos, assinaturas).

É possível usar o comando `tsm schedules` para gerenciar trabalhos de backup agendados. Para criar o trabalho de backup agendado, use o comando `tsm maintenance backup`: Para obter detalhes, consulte [tsm maintenance backup](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsm). Para obter mais detalhes sobre como gerenciar backups programados, consulte [Agendamento e gerenciamento de backups](https://help.tableau.com/current/server/pt-br/db_backup.htm#ScheduleBackups).

- [tsm schedules delete](#sched_delete)
- [tsm schedules list](#sched_list)
- [tsm schedules resume](#sched_resume)
- [tsm schedules suspend](#sched_suspend)
- [tsm schedules update](#sched_update)

## tsm schedules delete

Exclui a agenda especificada.

### Sinopse

`tsm schedules delete [-si <scheduleID> | -sn <scheduleName>] [global options]`

### Opções

\-si,--schedule-id <scheduleID>

Exigido se --schedule-name não é usado.

Id da agenda a ser excluída.

\-sn,--schedule-name <scheduleName>

Exigido se --schedule-id não é usado.

Nome da agenda a ser excluída.

## tsm schedules list

Lista as agendas no servidor.

### Sinopse

`tsm schedules list [--next-run | --schedule-id <scheduleID> | --schedule-name <scheduleName>] [global options]`

### Opções

\-nr,--next-run

Opcional.

Classifica as agendas pela hora da "próxima execução", da mais antiga à mais recente.

\-si,--schedule-id <scheduleID>

Opcional.

Id da agenda para listar os detalhes.

\-sn,--schedule-name <scheduleName>

Opcional.

Classifica as agendas por seus nomes, em ordem alfabética.

## tsm schedules resume

Retoma o cronograma suspenso especificado.

### Sinopse

`tsm schedules resume [-si <scheduleID> | -sn <scheduleName>] [global options]`

### Opções

\-si,--schedule-id <scheduleID>

Exigido se --schedule-name não é usado.

Id da agenda a ser retomada.

\-sn,--schedule-name <scheduleName>

Exigido se --schedule-id não é usado.

Nome da agenda a ser retomada.

## tsm schedules suspend

Suspende a agenda especificada.

### Sinopse

`tsm schedules suspend [-si <scheduleID> | -sn <scheduleName>] [global options]`

### Opções

\-si,--schedule-id <scheduleID>

Exigido se --schedule-name não é usado.

Id da agenda a ser suspensa.

\-sn,--schedule-name <scheduleName>

Exigido se --schedule-id não é usado.

Nome da agenda a ser suspensa.

## tsm schedules update

Atualiza a agenda especificada.

### Sinopse

`tsm schedules update[-si <scheduleID> -st <time_to_run> -sr <recurrence_frequency> -sd <day-or-days>] [global options]`

### Opções

\-si,--schedule-id <scheduleID>

Obrigatório.

Id da agenda a ser atualizada.

\-sr,--schedule-recurrence <frequency>

Obrigatório.

Frequência de recorrência da agenda. As opções válidas são "diária", "semanal" ou "mensal".

\-st,--schedule-time <HH:MM>

Obrigatório.

O horário em que a agenda deve ser executada, em formato de 24 horas: HH:MM.

\-sd,--schedule-days <day\[,day\]>

Opcional.

Dias para executar a agenda. Para agendas semanais, use 1-7 em que 1 é segunda-feira, e 7 é domingo. Para agendas mensais, use de 1 a 31. Se um dia não existir em um mês específico (30 de fevereiro, por exemplo) é utilizado o último dia válido do mês. Separe vários valores por vírgulas.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=a5dd09ad957c7429c31e91783ae510fb602587d502f5ac6faa4abdcc3bc2f985 url=/tableau/current/pt-br/server/cli_security_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm security

Use os comandos `tsm security` para configurar o suporte do Tableau Server a SSL externo (gateway) ou SSL de repositório (Postgres). A configuração do Repositório SSL inclui a opção para habilitar o SSL por meio de conexões diretas dos clientes do Tableau — incluindo o Tableau Desktop, Tableau Mobile e navegadores da Web — com o repositório.

- [tsm security authorize-credential-migration](#authorize-credential-migration)
- [tsm security cancel-credential-migrations](#cancel-credential-migrations)

- tsm security custom-cert
    - [tsm security custom-cert add](#custom-cert-add)
    - [tsm security custom-cert delete](#custom-cert-delete)
    - [tsm security custom-cert list](#custom-cert-list)

- tsm security custom-indexandsearch-ssl
    - [tsm security custom-indexandsearch-ssl add](#custom-indexsearch-add)
    - [tsm security custom-indexandsearch-ssl list](#custom-indexsearch-list)

- tsm security custom-tsm-ssl
    - [tsm security custom-tsm-ssl disable](#custom-tsm-ssl-disable)
    - [tsm security custom-tsm-ssl enable](#custom-tsm-ssl-enable)
    - [tsm security custom-tsm-ssl list](#custom-tsm-ssl-list)

- tsm security external-ssl
    - [tsm security external-ssl disable](#external-ssl-disable)
    - [tsm security external-ssl enable](#external-ssl-enable)
    - [tsm security external-ssl list](#external-ssl-list)
- tsm security kms
    - [tsm security kms set-mode aws](#kms-set-aws)
    - [tsm security kms set-mode azure](#kms-set-azure)
    - [tsm security kms set-mode local](#kms-set-local)
    - [tsm security kms status](#kms-status)
- tsm security maestro-rserve-ssl
    - [tsm security maestro-rserve-ssl disable](#maestro-rserve-ssl-disable)
    - [tsm security maestro-rserve-ssl enable](#maestro-rserve-ssl-enable)
- tsm security maestro-tabpy-ssl
    - [tsm security maestro-tabpy-ssl disable](#maestro-tabpy-ssl-disable)
    - [tsm security maestro-tabpy-ssl enable](#maestro-tabpy-ssl-enable)
- [tsm security regenerate-internal-tokens](#regenerate-tokens)
- tsm security repository-ssl
    - [tsm security repository-ssl disable](#postgres-ssl-disable)
    - [tsm security repository-ssl enable](#postres-ssl-enable)
    - [tsm security repository-ssl get-certificate-file](#postgres-ssl-cert)
    - [tsm security repository-ssl list](#postgres-ssl-list)
- [tsm security rotate-coordination-service-secrets](#tsm_security_rotate-coordination-service-secrets)
- A partir da versão 2020.2, para configurar as extensões de análise Rserve e TabPy, use as páginas administrativas do Tableau Server. Consulte [Configurar conexões com extensões do Analytics](https://help.tableau.com/current/server/pt-br/config_r_tabpy.htm).

## Pré-requisitos

Antes de configurar o SSL, você precisa adquirir certificados e copiá-los para o computador que executa o processo de gateway do Tableau Server. É necessária uma preparação adicional para habilitar as conexões diretas dos clientes. Para obter mais informações, consulte os artigos a seguir:

[Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/current/server/pt-br/ssl_config.htm)

[Como configurar o SSL para comunicação interna com o Postgres](https://help.tableau.com/current/server/pt-br/ssl_config_postgres.htm)

 Para obter informações sobre o SSL mútuo (duas vias), consulte [Configurar autenticação do SSL mútuo](https://help.tableau.com/current/server/pt-br/ssl_config_mutual.htm) e [comandos tsm authentication mutual-ssl](https://help.tableau.com/current/server/pt-br/cli_authentication_tsm.htm#TSMMutualSSL).

## tsm security authorize-credential-migration

Autoriza um usuário do Tableau a migrar credenciais inseridas de uma instalação do Tableau Server para um site do Tableau Cloud usando Content Migration Tool. Os dois sites Tableau Server e Tableau Cloud devem ter licença de Advanced Management para migração do conteúdo. Para obter mais informações, veja [Migrar pastas de trabalho e fontes de dados com credenciais inseridas](https://help.tableau.com/current/server/pt-br/cmt-migration_embedded_credentials.htm).

Você pode cancelar a autorização usando o comando [`tsm security cancel-credential-migrations`](#cancel-credential-migrations).

### Sinopse

`tsm security authorize-credential-migration --source-site-url-namespace <Tableau Server site ID> --destination-site-url-namespace <Tableau Cloud site ID> --destination-server-url <Tableau Cloud site url> --authorized-migration-runner <username> --destination-public-encryption-key <public key>`

### Opções

\--source-site-url-namespace

Obrigatório. ID do site do Tableau Server. A ID do site é usada na URL para identificá-lo com exclusividade.

Por exemplo, um site chamado West Coast Sales pode ter uma ID west-coast-sales.

\--destination-site-url-namespace

Obrigatório. ID do site do Tableau Cloud. A ID do site é usada na URL para identificá-lo com exclusividade.

\--destination-server-url

Obrigatório. URL do pod que seu site do Tableau Cloud é implantado. A URL especificada deve incluir uma barra final (`/`).

Seu pod é mostrado na primeira parte da URL do site após entrar no Tableau Cloud. Por exemplo, `https://10az.online.tableau.com/` é o pod Estados Unidos - Oeste (10AZ). Para obter mais informações sobre pods, consulte a página [Salesforce Trust](https://status.salesforce.com/products/tableau).

\--authorized-migration-runner

Obrigatório. Nome de usuário do Tableau Server autorizado a migrar credenciais inseridas.

\--destination-public-encryption-key

Obrigatório. Especifique a chave pública gerada no site Tableau Cloud.

\--expiration-time-in-days

Opcional. O número de dias antes de uma senha expirar. O valor padrão é 7 dias.

**Versão:** descontinuado na versão 2023.1. A partir de 2023.1.0 esta opção não será mais válida e gerará um erro se usada. O valor de expiração é codificado como 7 dias.

### Exemplo

O exemplo a seguir autoriza o usuário “admin” a migrar pastas de trabalho e fontes de dados publicadas com credenciais inseridas do site “ExampleA” do Tableau Server para o site “ExampleB” do Tableau Cloud. A autorização expira em 9 dias.

`tsm security authorize-credential-migration --source-site-url-namespace ExampleA --destination-site-url-namespace ExampleB --destinationServerUrl https://10ay.online.tableau.com/ --authorized-migration-runner admin --destination-public-encryption-key <public key> --expiration-time-in-days 9`

## tsm security cancel-credential-migrations

Cancela autorizações concedidas para migrar credenciais inseridas usando Content Migration Tool. Para obter mais informações, veja Migração de pastas de trabalho e fontes de dados com credenciais inseridas.

### Sinopse

`tsm security cancel-credential-migrations --source-site-url-namespace <Tableau Server site ID>`

### Opções

\--source-site-url-namespace

Obrigatório. ID do site do Tableau Server. A ID do site é usada na URL para identificá-lo com exclusividade.

Por exemplo, um site chamado West Coast Sales pode ter uma ID west-coast-sales.

## tsm security custom-cert add

Adiciona um certificado CA personalizado ao Tableau Server. Esse certificado é usado opcionalmente para estabelecer confiança na comunicação TLS entre um servidor SMTP e o Tableau Server.

Se já existir um certificado personalizado, esse comando falhará. Você pode remover o certificado personalizado existente usando o comando `tsm security custom-cert delete` .

**Nota**: o certificado adicionado com esse comando pode ser usado por outros serviços do Tableau Server para conexões TLS.

Como parte do seu plano de recuperação de desastres, recomendamos manter um backup do arquivo de certificado em um local seguro fora do Tableau Server. O arquivo de certificado adicionado ao Tableau Server será armazenado e distribuído a outros nós pelo Serviço de arquivos do cliente. No entanto, o arquivo não é armazenado em um formato recuperável. Consulte [Serviço de arquivo do cliente do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_cfs.htm).

### Sinopse

`tsm security custom-cert add --cert-file <file.crt> [global options]`

### Opções

\-c, --cert-file <file.crt>

Obrigatório. Especifica o nome de um arquivo de certificado no formato PEM ou DER válido.

## tsm security custom-cert delete

Remove o certificado personalizado existente do servidor. Isso permite adicionar um novo certificado personalizado.

### Sinopse

`tsm security custom-cert delete[global options]`

## tsm security custom-cert list

Listar detalhes do certificado personalizado.

### Sinopse

`tsm security custom-cert list[global options]`

## tsm security custom-indexandsearch-ssl add

Adicione certificados personalizados para Index and Search Server para Tableau Server 2023.1 e mais recente. A implementação de SSL é baseada na implementação de TLS do Opensearch.org. Consulte [Configuração de certificados TLS](https://opensearch.org/docs/latest/security/configuration/tls/) para obter maiores informações.

\--admin <file.crt>

Obrigatório.

Arquivo de certificado do Administrador. Especifique o caminho para um certificado x509 codificado por PEM válido com a extensão .crt.

\--admin-key <file.key>

Obrigatório.

Especifique o caminho para um arquivo de chave privada RSA ou DSA válido (PKCS#8), com a extensão .key por convenção.

\-- ca <file.crt>

Obrigatório.

Arquivo CA confiável. Especifique o caminho para um certificado x509 codificado por PEM válido com a extensão .crt.

\--node <file.crt>

Obrigatório.

Arquivo de certificado do Nó. Especifique o caminho para um certificado x509 codificado por PEM válido com a extensão .crt. Este comando distribuirá este certificado para cada nó no cluster. Use um certificado curinga para permitir a matriz completa de nomes distintos (DNs) do nó em um único certificado.

\-- node-key <file.key>

Obrigatório.

Especifique o caminho para um arquivo de chave privada RSA ou DSA válido (PKCS#8), com a extensão .key por convenção.

### Sinopse

`tsm security custom-indexandsearch-ssl add --node <file.crt> --admin <file.crt> --node-key <file.key> --admin-key <file.key> --ca <file.crt> [parameters] [global options]`

## tsm security custom-indexandsearch-ssl list

Liste os detalhes da configuração do certificado personalizado SSL do Index and Search Server.

### Sinopse

`tsm security custom-indexandsearch-ssl list[global options]`

## tsm security custom-tsm-ssl disable

Desative o certificado SSL personalizado para conexões com o TSM Controller. Reverta para um certificado autoassinado gerenciado automaticamente.

### Sinopse

`tsm security custom-tsm-ssl disable [global options]`

## tsm security custom-tsm-ssl enable

Habilite o certificado SSL personalizado para conexões com o TSM Controller para Tableau Server 2023.1 e mais recente. Se você já ativou o SSL e precisa atualizar um certificado expirado, use este comando.

\-cf,--cert-file <file.crt>

Obrigatório.

Especifique o caminho para um certificado x509 codificado por PEM válido com a extensão .crt. O nome da entidade no certificado deve corresponder ao nome do host ou endereço IP do computador do Tableau no qual o Controlador de administração está sendo executado. Por padrão, o Controlador de administração é executado no nó inicial de uma implantação do Tableau Server.

\-kf,--key-file <file.key>

Obrigatório.

Especifique o caminho para o arquivo de chave privada RSA ou DSA válido (PKCS#8), com a extensão .key por convenção. Essa chave não pode ser protegida por senha.

\--chain-file <file.crt>

Opcional.

Especifique o caminho para um arquivo de cadeia de certificado (.crt)

O arquivo de cadeia é uma concatenação de todos os certificados que formam a cadeia de certificados para o certificado do servidor.

Todos os certificados no arquivo devem ser x509 codificados por PEM e o arquivo deve ter a extensão .crt (não .pem).

\--skip-validation

Opcional

Pase por esta opção para ignorar a verificação raiz da autoridade de certificação.

### Sinopse

`tsm security custom-tsm-ssl enable --key-file <file.key> --cert-file <file.crt> [global options]`

## tsm security custom-tsm-ssl list

Liste detalhes da configuração do certificado personalizado.

### Sinopse

`tsm security custom-tsm-ssl list[global options]`

## tsm security external-ssl disable

Remove os ajustes de configuração de SSL atuais do servidor e interrompe o tráfico de criptografia entre clientes externos e o servidor.

### Sinopse

`tsm security external-ssl disable [global options]`

## tsm security external-ssl enable

Habilita e especifica certificado e arquivos chave do SSL por comunicação HTTP externa.

### Sinopse

`tsm security external-ssl enable --cert-file <file.crt> --key-file <file.key> [options] [global options]`

### Opções

\--cert-file <arquivo .crt>

Obrigatório. Especificar o nome de um certificado PEM-encoded x509 válido com a extensão .crt.

\--key-file <file.key>

Obrigatório. Especificar um arquivo-chave privado RSA ou DSA válido, com a extensão .key por convenção.

\--chain-file <chainfile.crt>

Especificar o arquivo de cadeia de certificado (.crt)

Um arquivo de cadeia de certificado é necessário para o Tableau Desktop no Mac. Em alguns casos, um arquivo de cadeia de certificado pode ser necessário para o Tableau Mobile.

Alguns fornecedores de certificado emitem dois certificados para o Apache. O segundo certificado é um arquivo de cadeia, que é uma concatenação de todos aqueles que formam a cadeia de certificados para o certificado do servidor.

Todos os certificados no arquivo devem ser x509 codificados por PEM e o arquivo deve ter a extensão .crt (não .pem).

\--passphrase

Opcional. Frase de segurança do arquivo de certificado. A frase de segurança inserida será criptografada em períodos de inatividade.

**Observação:** se você criar um arquivo de chave de certificado com uma frase de segurança, não será possível reutilizar a chave de certificado SSL para SAML.

\--protocols <list protocols>

Opcional. Liste as versões do protocolo de Segurança de camada de transporte (TLS) que deseja permitir ou cancelar a permissão.

O TLS é uma versão aprimorada do SSL. O Tableau Server usa o TLS para autenticar e criptografar conexões. Os valores aceitos incluem versões de protocolo compatíveis com o Apache. Para desaprovar um protocolo, proceda a versão do protocolo com um caractere de subtração (-).

Ajuste padrão: `"all, -SSLv2, -SSLv3"`

Esse padrão não permite de maneira explícita que clientes usem os protocolos do SSL v2 ou do SSL v3 para se conectarem ao Tableau Server. Entretanto, recomendamos cancelar também as permissões do TLS v1 e do TLS v1.1.

Antes de negar uma versão específica do TLS, verifique se os navegadores que os usuários usam para conectarem-se ao Tableau Server suportam o TLS v1.2. Pode ser necessário preservar o suporte para TLSv1.1 até que os navegadores sejam atualizados.

Caso o suporte a TLS v1 ou v1.1 não seja necessário, use o comando a seguir para permitir o TLS v1.2 (usando o valor de `all`) e negar explicitamente o SSL v2, SSL v3, TLS v1 e o TLS v1.1.

`tsm security external-ssl enable --cert-file file.crt --key-file file.key --protocols "all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1"`

## tsm security external-ssl list

Mostra uma lista de ajustes relacionados à configuração de SSL externo de gateway. Na lista, encontram-se nomes de arquivos de certificado em uso, mas não seus nomes.

### Sinopse

`tsm security external-ssl list [global options]`

## tsm security kms set-mode aws  

Defina o modo do KMS para AWS.

Você precisará da cadeia de caracteres ARN completa do AWS KMS. Essa cadeia de caracteres está na seção "Configuração geral" das páginas de gerenciamento do AWS KMS. O ARN é apresentado neste formato: arn:aws:kms:<region>:<account>:key/<CMK\_ID>, por exemplo, `arn:aws:kms:us-west-2:867530990073:key/1abc23de-fg45-6hij-7k89-1l0mn1234567`.

Para obter mais informações, consulte [Sistema de gerenciamento de chaves da AWS](https://help.tableau.com/current/server/pt-br/security_kms_aws.htm).

### Sinopse

`tsm security kms set-mode aws --key-arn "<arn>" --aws-region "<region>" [global options]`

### Opções

\--key-arn

Obrigatório. A opção `--key-arn` usa uma cópia direta da cadeia de caracteres ARN na seção "Configuração geral" das páginas de gerenciamento do AWS KMS.

\--aws-region

Obrigatório. Especifique uma região, conforme mostrado na coluna Região da [tabela Amazon API Gateway](https://docs.aws.amazon.com/general/latest/gr/rande.html).

### Exemplo

Por exemplo, se a instância de AWS KMS estiver em execução na região `us-west-2` o número da conta será `867530990073` e sua chave CMK será `1abc23de-fg45-6hij-7k89-1l0mn1234567`, então o comando seria:

`tsm security kms set-mode aws --aws-region "us-west-2" --key-arn "arn:aws:kms:us-west-2:867530990073:key/1abc23de-fg45-6hij-7k89-1l0mn1234567"`

## tsm security kms set-mode azure  

Defina o modo KMS para o Azure Key Vault.

**Observação:** o modo KMS será exibido como "Azure Key Vault" quando executar o `tsm security kms status`, mas você define-o como "azure".

Você precisará do nome do Azure Key Vault e do nome da chave no Azure.

Para obter mais informações, consulte [Azure Key Vault](https://help.tableau.com/current/server/pt-br/security_kms_azure.htm).

### Sinopse

`tsm security kms set-mode azure --key-name "<key_name>" --vault-name "<vault_name>" [global options]`

### Opções

\--key-name

Obrigatório. O nome da chave assimétrica armazenada no Azure Key Vault.

\--vault-name

Obrigatório. O nome do Azure Key Vault.

### Exemplo

Por exemplo, se o Azure Key Vault for chamado `tabsrv-keyvault` e a chave for `tabsrv-sandbox-key01` então o comando será:

`tsm security kms set-mode azure --key-name "tabsrv-sandbox-key01" --vault-name "tabsrv-keyvault"`

## tsm security kms set-mode local  

Defina ou redefina o modo do KMS para local. Local é o modo do KMS padrão. Para obter mais informações, consulte [Sistema de gerenciamento de chaves do Tableau Server](https://help.tableau.com/current/server/pt-br/security_kms.htm).

### Sinopse

`tsm security kms set-mode local [global options]`

## tsm security kms status  

Exiba o status da configuração do KMS. O status retornado inclui:

- Status: OK indica que o KMS será acessível pelo Tableau ou pelo nó do controlador, se for uma instalação de vários nós.
- Modo: Local, AWS ou Azure Key Vault. Indica qual modo KMS está sendo usado.
- Criptografe e descriptografe a chave de criptografia principal:
    
    O KMS armazena uma coleção de chaves principais de extração (MEKs). Cada MEK tem:
    
    - Uma ID, por exemplo, 8ddd70df-be67-4dbf-9c35-1f0aa2421521
    - Um status “criptografar ou descriptografar chave” ou “somente descriptografar chave”. Se a chave for "criptografar ou descriptografar", o Tableau Server criptografará os novos dados com ela. Caso contrário, a chave será usada somente para descriptografia
    - Um carimbo de data/hora de criação, por exemplo, “Criado em: 2019-05-29T23:46:54Z”.
    - Primeira transição para criptografar e descriptografar: um carimbo de data/hora indicando quando a chave se tornou uma chave de criptografia ou descriptografia.
    - Transição somente para descriptografia: um carimbo de data/hora indicando quando ocorreu a transição da chave somente para descriptografia.

Outros valores devolvidos dependem do modo KMS.

Quando o modo KMS é AWS, o seguinte é devolvido:

- O ARN (ID) da chave principal do cliente (CMK).
- A região em que a CMK está localizada.
- A ID da chave principal raiz (RMK) em uso. A RMK é uma chave criptografada pela CMK. O Tableau Server descriptografa a CMK fazendo chamadas para o AWS KMS. A RMK é usada para criptografar/descriptografar a chave principal de extração (MEK). A RMK pode mudar, mas haverá somente uma de cada vez.

Quando o modo KMS é o Azure Key Vault, o seguinte é devolvido:

- Nome do cofre: o nome do Azure Key Vault.
- Nome da chave do Azure Key Vault: o nome da chave no cofre.

### Sinopse

`tsm security kms status [global options]`

## tsm security maestro-rserve-ssl disable  

Desative a conexão Rserve.

Para obter mais informações, consulte [Usar scripts R (Rserve) no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts._R.htm#configure-rserve-server-for-tableau-server).

## tsm security maestro-rserve-ssl enable  

Configure uma conexão entre um servidor Rserve e o Tableau Server versão 2019.3 ou posterior.

Para obter mais informações, consulte [Usar scripts R (Rserve) no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts._R.htm#configure-rserve-server-for-tableau-server).

### Sinopse

`tsm security maestro-rserve-ssl enable --connection-type <maestro-rserve-secure | maestro-rserve> --rserve-host <Rserve IP address or host name> --rserve-port <Rserve port> --rserve-username <Rserve username> --rserve-password <Rserve password> --rserve-connect-timeout-ms <RServe connect timeout>`

### Opções

\--connection-type

Selecione `maestro-rserve-secure` para habilitar uma conexão segura ou `maestro-rserve` para habilitar uma conexão não segura. Se você selecionar `maestro-rserve-secure`, especifique o caminho do arquivo de certificado na linha de comando.

\--rserve-host

Host

\--rserve-port

Porta

\--rserve-username

Username

\--rserve-password

Senha

\--rserve-connect-timeout-ms

O tempo limite de conexão em milissegundos. Por exemplo, `--rserve-connect-timeout-ms 900000`.

## tsm security maestro-tabpy-ssl disable  

Desative a conexão TabPy.

Para obter mais informações, consulte [Usar scripts Python no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts_TabPy.htm).

## tsm security maestro-tabpy-ssl enable  

Configure uma conexão entre um servidor TabPy e o Tableau Server versão 2019.3 ou posterior.

Para obter mais informações, consulte [Usar scripts Python no fluxo](https://help.tableau.com/current/prep/pt-br/prep_scripts_TabPy.htm).

### Sinopse

`tsm security maestro-tabpy-ssl enable --connection-type <maestro-tabpy-secure | maestro-tabpy> --tabpy-host <TabPy IP address or host name> --tabpy-port <TabPy port> --tabpy-username <TabPy username> --tabpy-password <TabPy password> --tabpy-connect-timeout-ms <TabPy connect timeout>`

### Opções

\--connection-type

Selecione `maestro-tabpy-secure` para habilitar uma conexão segura ou `maestro-tabpy` para habilitar uma conexão não segura. Se você selecionar `maestro-tabpy-secure`, especifique o -cf<certificate file path> do arquivo de certificado na linha de comando.

\--tabpy-host

Host

\--tabpy-port

Porta

\--tabpy-username

Username

\--tabpy-password

Senha

\--tabpy-connect-timeout-ms

O tempo limite de conexão em milissegundos. Por exemplo, `--tabpy-connect-timeout-ms 900000`.

## tsm security regenerate-internal-tokens  

Esse comando executa as seguintes operações:

1. Interrompa o Tableau Server se ele estiver em execução.
2. Gera novos certificados SSL internos para o repositório Postgres no servidor de pesquisa.
3. Gera novas senhas para todas as senhas gerenciadas internamente.
4. Atualiza todas as senhas do repositório Postgres.
5. Gera uma nova chave de criptografia para o gerenciamento de chaves do ativo e criptografa os dados de chave do ativo com a nova chave.
6. Gera uma nova chave de criptografia para os segredos de configuração (chave principal) e criptografa a configuração com ela.
7. Reconfigura e atualiza o Tableau Server com todos esses segredos. Em uma implantação distribuída, esse comando também distribui a reconfiguração e atualiza todos os nós no cluster.
8. Regenera uma nova chave principal, adiciona-a ao arquivo principal do repositório de chaves e cria novos tokens de segurança para uso interno.
9. Inicia o Tableau Server.

Se você planeja adicionar um nó ao cluster depois de executar esse comando, será necessário gerar um novo arquivo de configuração do nó para atualizar os tokens, chaves e segredos gerados por esse comando. Consulte [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

Para obter mais informações sobre as senhas internas, consulte [Gerenciar segredos do servidor](https://help.tableau.com/current/server/pt-br/security_secret_storage.htm).

### Sinopse

`tsm security regenerate-internal-tokens [options] [global options]`

### Opções

\--ignore-prompt

Opcional.

Execute uma reinicialização (se necessário) sem avisar. Essa opção cancela apenas o prompt. O comportamento de reinicialização fica inalterado.

\--request-timeout <tempo limite em segundos>

Opcional.

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

## tsm security repository-ssl disable

Interrompe o tráfego de criptografia entre o repositório e outros componentes do servidor, além de interromper o suporte de conexões diretas dos clientes do Tableau.

Isso exclui o certificado e o arquivo-chave em uso. Se você estivesse usando um certificado personalizado (uma opção a partir da versão 2026.2.0)

A partir da versão 2026.2.0, se você estiver usando um certificado SSL personalizado e uma chave para comunicação de repositório criptografada, esse comando removerá o certificado personalizado e o arquivo de chave. Se quiser reativar o SSL do repositório, você precisará fornecer os arquivos novamente.

### Sinopse

`tsm security repository-ssl disable [global-options]`

## tsm security repository-ssl enable

Esse comando habilita a criptografia SSL para comunicações com o repositório PostgreSQL. O uso e o comportamento do comando dependem de qual versão do Tableau Server você tem.

### Versões até (e incluindo) a 2025.3.x

- Repositório local
    
    Quando o repositório for local, utilize este comando para habilitar a criptografia SSL e gerar automaticamente os arquivos `.crt` e `.key` do servidor, utilizados para o tráfego criptografado entre o repositório Postgres e outros componentes do servidor.
- Repositório externo
    
    Ao utilizar um repositório externo, o comando importa os arquivos `.crt` e `.key` do servidor, utilizados para criptografar o tráfego entre o repositório PostgreSQL externo e os componentes do Tableau Server.

Ao habilitá-lo, você tem a opção de habilitar o SSL por conexões diretas dos clientes do Tableau com o servidor.

### Versão 2026.2.0 ou posterior

Além da funcionalidade de comando descrita acima, a partir da versão 2026.2.0, você também tem a opção de especificar um certificado personalizado incluindo o caminho para um arquivo de certificado x509 codificado por PEM válido e um arquivo-chave. Se você usar um certificado personalizado, as opções do Repositório SSL não poderão ser alteradas na interface do usuário na Web do TSM. Consulte [Opções](#RepoEnable-Options) abaixo para obter detalhes sobre como configurar o Tableau para usar um certificado personalizado para SSL de repositório.

### Sinopse

`tsm security repository-ssl enable [options] [global options]`

### Opções

\-i, --internal-only

Opcional. Esta opção aplica-se apenas quando o repositório é local do Tableau Server. Essa opção não deve ser usada para Tableau Server configurado com Repositório Externo.

Ao definido como `--internal-only`, o Tableau Server usa o SSL entre o repositório e outros componentes do servidor. E é compatível com, mas não exige o SSL para conexões diretas por meio de usuários do **tableau** ou **readonly**.

Se essa opção não estiver definida, o Tableau Server exige o SSL para o tráfego entre o repositório e outros componentes do servidor, bem como para as conexões diretas dos clientes do Tableau (para conexões por meio de usuários do **tableau** ou **readonly**).

Ao especificar esta opção, também será necessário concluir as etapas descritas em [Configurar Postgres SSL para permitir conexões diretas de clientes](https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm).

\-c, --certificate

Opcional. O comportamento desta opção muda dependendo da versão do Tableau Server que você tem:

- Versões 2021.4.0 a 2025.3.x - Essa opção é aplicável apenas ao Tableau Server configurado com Repositório externo e pode ser usada para habilitar ou desabilitar conexões SSL após a instalação. Essa opção permite habilitar o uso de conexões SSL/TSL entre o Tableau Server e o repositório externo. Ao usar essa opção, forneça o caminho completo para o arquivo de certificado SSL, incluindo o nome do arquivo para o Repositório externo. Esse arquivo é igual ao usado ao habilitar o repositório externo.
- Versões 2026.2.x e posteriores - Esta opção se aplica às instalações do Repositório Interno e Repositório Externo e pode ser usada após a instalação para habilitar ou desabilitar conexões SSL. Essa opção também pode ser usada para especificar um certificado personalizado quando você também inclui o caminho completo do arquivo de certificado SSL, incluindo o nome do arquivo, e usa a opção `--key-file` para especificar o arquivo de chave privada RSA ou DSA associado ao certificado.

\--key-file

Adicionado na versão 2026.2.0

Opcional. Especificar um arquivo-chave privado RSA ou DSA válido, com a extensão `.key`. Use isso junto com a opção `--certificate` para especificar um certificado SSL personalizado.

\--passphrase

Adicionado na versão 2026.2.0

Opcional. Os arquivos-chave podem ser protegidos por senha, se desejado. Certifique-se de que o algoritmo criptográfico em questão seja compatível com a versão do Tableau Server que você está executando. O Tableau Server usa OpenSSL para abrir arquivos de chave protegidos por senha.

\--chain-file

Adicionado na versão 2026.2.0

Opcional. Se aplicável, especifique o caminho apontando para um arquivo de cadeia de certificado válido que inclua o certificado do servidor seguido por seus certificados CA intermediários.

## tsm security repository-ssl get-certificate-file

Obtenha o arquivo de certificado público usado na comunicação SSL com o repositório do Tableau. O arquivo de certificado é distribuído automaticamente aos clientes internos do repositório no cluster do Tableau Server. Para habilitar a conexão de clientes remotos por SSL com o repositório, é necessário copiar o arquivo de certificado público de cada cliente.

A partir da versão 2026.2.0, esse comando também obtém o certificado público quando os certificados personalizados do repositório são habilitados.

Este comando funciona apenas para Tableau Server que usa um Repositório local e resultará em um erro quando o Tableau Server for configurado com um Repositório externo.

### Sinopse

`tsm security repository-ssl get-certificate-file [global-options]`

### Opções

\-f, --file

Obrigatório.

Caminho e nome de arquivo completos (com a extensão `.cert`) do local onde o arquivo de configuração deverá ser salvo. Se existir um arquivo duplicado, ele será substituído.

## tsm security repository-ssl list

Retorna a configuração do SSL do repositório existente (Postgres).

### Sinopse

`tsm security repository-ssl list [global-options]`

## tsm security rotate-coordination-service-secrets

**Versão:** adicionado na versão 2022.1.

Gera novos certificados, chaves e armazenamentos confiáveis usados pelo Serviço de Coordenação para conexões seguras.

### Sinopse

`tsm security rotate-coordination-service-secrets [options][global options]`

### Opções

\--coord-svc-restart-timeout <seconds>

Opcional.

Aguarde o número especificado de segundos para que o Serviço de Coordenação seja reiniciado. Padrão: 1200 (20 minutos).

\--ignore-prompt

Opcional.

Execute uma reinicialização (se necessário) sem avisar.

\--request-timeout <seconds>

Opcional.

Aguarde o número especificado de segundos para que o comando seja concluído. Padrão: 1800 (30 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=257575a0fe626f7736653701f352226c555804f0b95c696e5f893597d015cc3c url=/tableau/current/pt-br/server/cli_settings_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm settings

È possível usar os comandos `tsm settings` para exportar (obter) e importar (definir) valores de configuração.

- [tsm settings clone](#TSMSettingsClone)
- [tsm settings export](#TSMExport)
- [tsm settings import](#TSMSet)

**Importante**: o arquivo de configuração do servidor mencionado neste tópico inclui uma cópia do arquivo principal do repositório de chaves usado para criptografar segredos de configuração. Recomendamos que tome medidas adicionais para a segurança do arquivo de configuração do nó por meio dos mecanismos como descrito em [Proteção de segredos para operações de importação e exportação](https://help.tableau.com/current/server/pt-br/security_secret_storage.htm#Securing).

## tsm settings clone

Crie uma "carga útil de clonagem" que consiste na configuração e topologia da instalação do Tableau Server (incluindo portas e serviços externos). Essa carga útil pode ser usada para recriar uma cópia exata da instalação do servidor. Esse comando foi projetado para funcionar melhor com uma instalação do Servidor que inclui um repositório externo e um armazenamento de arquivos externo. Para obter detalhes sobre como usar a carga útil do clone para criar uma cópia de uma instalação, consulte [Clone do Tableau Server](https://help.tableau.com/current/server/pt-br/server_clone.htm).

### Sinopse

`tsm settings clone --output-directory <output-directory> [global options]`

### Opções

\-d, --output-directory <output-directory>

Obrigatório.

Especifica o local no qual a carga útil do clone será gravada.

## tsm settings export

Exporta a configuração e a topologia do servidor atual para um arquivo.

Os seguintes arquivos não são exportados ou importados com os comandos `tsm settings import` ou `tsm settings export`. Você deve gerenciar esses arquivos manualmente:

- Arquivo de certificado SAML
- Arquivo-chave SAML
- Arquivo de metadados IdP SAML
- OpenID.static.file
- Arquivo Kerberos.keytab
- Arquivo keytab do Kerberos LDAP
- Arquivo de conf. Kerberos LDAP
- Arquivo de certificado SSL mútuo
- Arquivo de revogação SSL mútuo
- Arquivo de logotipo do cabeçalho de personalização
- Arquivo de logotipo de logon de personalização
- Arquivo de logotipo compacto de personalização

### Sinopse

`tsm settings export --output-config-file <path/to/output_file.json> [global options]`

### Opções

\-f, --output-config-file <file>

Obrigatório.

Especifica a localização e o nome do arquivo criado por essa operação.

## tsm settings import

Importa a configuração ou topologia do servidor.

Os seguintes arquivos não são exportados ou importados com os comandos `tsm settings export` ou `tsm settings import`. Você deve gerenciar esses arquivos manualmente:

- Arquivo de certificado SAML
- Arquivo-chave SAML
- Arquivo de metadados IdP SAML
- OpenID.static.file
- Arquivo Kerberos.keytab
- Arquivo keytab do Kerberos LDAP
- Arquivo de conf. Kerberos LDAP
- Arquivo de certificado SSL mútuo
- Arquivo de revogação SSL mútuo
- Arquivo de logotipo do cabeçalho de personalização
- Arquivo de logotipo de logon de personalização
- Arquivo de logotipo compacto de personalização

### Sinopse

`tsm settings import --import-config-file <path/to/import_file.json> [global options]`

### Opções

\-f,--import-config-file <FILE>

Obrigatório.

Caminho para o arquivo de entrada.

\--config-only

Opcional.

\--topology-only

Opcional.

\-frc, --force-keys

Opcional.

Faça com que uma chave seja adicionada à configuração, mesmo que não tenha existido anteriormente.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=83c3ae14a18fdaa8628595ff0dd43a1c9c5d4321486292aed9ef32c40f7d7f29 url=/tableau/current/pt-br/server/cli_sites_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm sites

É 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](https://help.tableau.com/current/server/pt-br/processes.htm).

**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](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm).

- [tsm sites export](#TSMExport)
- [tsm sites import](#TSMImport)
- [tsm sites import-verified](#TSMImportVerified)
- [tsm sites unlock](#TSMUnlock)

## 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](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

\-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](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm#before-you-export).

\-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](https://help.tableau.com/current/server/pt-br/cli_default_filepaths_tsm.htm).

**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](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm#before-you-export).

\-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](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm#before-you-export).

\-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](https://help.tableau.com/current/server/pt-br/sites_exportimport.htm#before-you-export).

\-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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=f2de926cbb28668e80963b5cf13f75c38a2274d6a573b03555997bf662afb513 url=/tableau/current/pt-br/server/cli_start_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm start

É possível usar o comando `tsm start` para iniciar o Tableau Server. Se o servidor já estiver em execução, esse comando não faz nada.

### Sinopse

`tsm start [option][global options]`

### Opção

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 1800 (30 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=8f38ebbb4b020b2e1d701b2f81d80d3cd837cc302454774349da48ebdaa66dfa url=/tableau/current/pt-br/server/cli_status_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm status

Você pode usar o comando `tsm status`para exibir o status do Tableau Server e serviços individuais (processos) executados como parte do Tableau Server.

### Sinopse

`tsm status [global options]`

### Opções

\-v, --verbose

Opcional.

Exibe o status para cada nó no cluster do Tableau Server.

`tsm status` retornará um destes possíveis status para um nó do Tableau Server:

- `RUNNING`: o nó está em execução sem status de erro para todos os serviços ou processos.
- `DEGRADED`: o nó está sendo executado com um ou mais serviços primários, como o repositório, em um estado de erro. Se você tiver uma única instância do serviço de mensagens e ela falhar, o Tableau Server continuará funcionando, mas o status será exibido como degradado e as mensagens de eventos poderão ser perdidas. Para obter mais informações, consulte [Serviço de mensagens do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_messaging_service.htm).
- `ERROR`: todos os serviços ou processos primários estão em estado de erro no nó.
- `STOPPED`: o nó é interrompido, sem status de erro.

Ao executar `tsm status` com a opção `--verbose`, o TSM retornará um status para cada serviço individual (processo). As possíveis mensagens de status incluem:

- `is running`: o serviço está em execução.
- `status is unavailable`: o status não pode ser determinado, assim como ocorre quando os serviços estão em inicialização.
- `is in a degraded state`: o serviço está em execução, mas retorna erros. Este status indica que o serviço não foi instalado corretamente, não foi configurado ou falhou de alguma forma.
- `is in an error state`: o serviço está em execução, mas retorna erros. Este status indica que o serviço não foi instalado corretamente ou não foi configurado.
- `is synchronizing`: o processo de armazenamento de arquivos está sincronizando com outra instância do Armazenamento de arquivos.
- `is decommissioning`: o processo de armazenamento de arquivos está sendo desativado.
- `is running (Active Repository)`: o repositório ativo está em execução. Este é o status esperado.
- `is running (Passive Repository)`: o repositório passivo está em execução. Este é o status esperado quando há dois repositórios configurados.
- `is stopped`: o serviço é interrompido. Isso não significa que um serviço esteja em um estado de erro ou problema. Alguns serviços só são executados quando necessário (o serviço de manutenção de banco de dados, por exemplo).

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=aa2aeb75180e6daf179a48664e107460d5387eea4be1059f4f2c9a1e09e8ddc5 url=/tableau/current/pt-br/server/cli_stop_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm stop

É possível usar o comando `tsm stop` para interromper o Tableau Server. Se o Tableau Server já estiver interrompido, esse comando não faz nada.

### Sinopse

`tsm stop [option] [global options]`

### Opções

\--ignore-node-status <nodeID>

Opcional.

Ignore o status do nó ou dos nós especificados ao determinar se houve uma interrupção do servidor. Essa opção é útil para a remoção de um nó danificado. Separe vários nós por vírgulas.

Por exemplo, se os nós 2, 3 e 5 não estiverem respondendo corretamente: `tsm stop --ignore-node-status node2,node3,node5`

**Observação:** opção adicionada na versão 2020.1

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 1800 (30 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=c7711397574dec7b54def19679e5e4bb7821821c7fb9a7f675d77f54de2b7295 url=/tableau/current/pt-br/server/cli_topology_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm topology

Use os comandos de `tsm topology` para preparar os nós do Repositório de arquivos para a remoção segura ou para colocá-los de volta em modo leitura/gravação. Também é possível iniciar um failover de repositório, obter uma lista de nós ou portas, obter o arquivo de configuração bootstrap exigido para incluir nós adicionais ao seu cluster, remover nós, configurar o repositório externo e o Armazenamento de arquivos externo.

**Importante:** ao fazer alterações na topologia, você precisa aplicar as alterações pendentes para que as alterações entrem em vigor. Para obter mais informações, consulte [tsm pending-changes](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm).

- [cleanup-coordination-service](#TSMCleanupCoordination)
- [deploy-coordination-service](#TSMDeployCoordination)
- external-services
    - gateway
        - [gateway disable](#TSMIndependentGatewayDisable)
        - [gateway enable](#TSMIndependentGatewayEnable)
        - [gateway update](#TSMIndependentGatewayUpdate)
    - [list](#tsmExteranalServicesList)
    - repository
        - [disable](#TSMExternalRepoDisable)
        - [enable](#TSMExternalRepoEnable)
        - [replace-host](#tsmExternalRepoReplaceHost)
    - storage (filestore)
        - [storage disable](#TSMExternalStorageDisable)
        - [storage enable](#TSMExternalStorageEnable)
        - [storage switch-share](#TSMExternalStorageSwitchShare)
- [failover-repository](#TSMFailoverRepository)
- filestore
    - [decommission](#TSMDecommission)
    - [recomissionamento](#topology-recommission)
- [list-nodes](#TSMListNodes)
- [list-ports](#TSMListPorts)
- node-nickname
    - [list](#TSMNodeNicknameList)
    - [remove](#TSMNodeNicknameRemove)
    - [set](#TSMNodeNicknameSet)
- nós
    - [get-bootstrap-file](#TSMGetBootstrap)
- [remove-nodes](#TSMRemoveNodes)
- [set-node-role](#TSMSetNodeRole)
- [set-ports](#TSMSetPorts)
- [set-process](#TSMSetProcess)
- [toggle-coordination-service](#TSMToggleCoordination)

## tsm topology cleanup-coordination-service

**Observação:** começando com a versão 2020.1.0, todos os comandos do ensemble de serviço de coordenação requerem entrada para um prompt "y/n", confirmando que haverá reinicialização do servidor. Para executar esses comandos sem entrada, inclua a opção `--ignore-prompt`.

Use o comando `tsm topology cleanup-coordination-service` para remover o ensemble do Serviço de coordenação de não produção doTableau Server depois de implantar um novo ensemble. Esse comando remove as instâncias antigas do Serviço de coordenação em todos os nós no ensemble do Serviço de coordenação de não produção e é necessário após implantar um novo ensemble desse serviço. Para saber mais sobre os ensembles do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

Na versão 2020.1.0 e posterior, o comando `tsm topology deploy-coordination-service` também remove o ensemble antigo. Não há necessidade de executar este comando separadamente, a menos que a implantação falhe.

### Sinopse

`tsm topology cleanup-coordination-service [option] [global options]`

### Opção

\--request-timeout <tempo limite em segundos>

Opcional.

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

## tsm topology deploy-coordination-service

**Observação:** começando com a versão 2020.1.0, todos os comandos do ensemble de serviço de coordenação requerem entrada para um prompt "y/n", confirmando que haverá reinicialização do servidor. Para executar esses comandos sem entrada, inclua a opção `--ignore-prompt`.

É possível usar o comando `tsm topology deploy-coordination-service` para implantar o Serviço de coordenação do Tableau Server. Este comando implanta um ensemble do Serviço de coordenação, que é um conjunto de instâncias do Serviço de coordenação, executadas em nós especificados no cluster do servidor. Para saber mais sobre os ensembles do Serviço de coordenação, inclusive quantos nós no cluster devem ter uma instância do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

Na versão 2020.1.0 e posterior, o comando `tsm topology deploy-coordination-service` também remove o ensemble antigo. Não há necessidade de executar o comando `cleanup-coordination-service` separadamente.

### Sinopse

`tsm topology deploy-coordination-service --nodes <nodeID,nodeID,...> [option] [global-options]`

### Opções

\-n, --nodes <nodeID,nodeID,...>

Obrigatório.

As IDs dos nós para a incluir no novo ensemble do Serviço de coordenação, separadas por vírgulas. Especifique 1, 3 ou 5 nós do Serviço de coordenação, dependendo do número total de nós no cluster. Para obter mais informações, consulte [O quórum do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm#ZKquorum).

\--request-timeout <tempo limite em segundos>

Opcional.

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

## tsm topology external-services gateway disable

Desabilite todas as instâncias do Gateway Independente no Tableau Server.

### Sinopse

tsm topology external-services gateway disable \[options\] \[global options\]

### Opções

\--request-timeout <tempo limite em segundos>

Opcional.

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

## tsm topology external-services gateway enable

Habilite instâncias do Independent Gateway no Tableau Server.

### Sinopse

tsm topology external-services gateway enable \[options\] \[global options\]

### Opções

\-c, --config <configuration-file>

Obrigatório

Especifica o nome do arquivo JSON que contém detalhes de configuração para todas as instâncias do Independent Gateway.

## tsm topology external-services gateway update

Use este comando para atualizar a configuração do Tableau Independent Gateway Server. Você precisa fazer isso se adicionar ou remover instâncias adicionais do Independent Gateway ou se atualizar o Independent Gateway. Reúna quaisquer alterações nos computadores do Independent Gateway e atualize o arquivo de configuração antes de executar este comando.

### Sinopse

tsm topology external-services gateway update \[option\] \[global options\]

### Opção

\-c, --config <configuration-file>

Obrigatório

Especifica o nome do arquivo JSON que contém detalhes de configuração para todas as instâncias do Independent Gateway.

## tsm topology external-services list

Use o comando tsm topology external-service-list para obter um serviço usado para o Repositório externo do Tableau Server. Por exemplo, se você configurou o Tableau Server para usar o Amazon RDS, você verá a seguinte mensagem:

Esses serviços configurados externamente estão sendo usados pelo Tableau Server:

\- pgsql

### Sinopse

tsm topology external-service list \[global options\]

### Opção

Não há opções para este comando.

## tsm topology external-services repository disable -n nodeN

Use o comando tsm topology external-services repository disable para interromper o uso do repositório externo e reconfigurar a instalação para usar um repositório local. Isso migrará os dados para um repositório local e configurará o Tableau Server para usar o repositório local.

### Sinopse

tsm topology external-services repository disable -n nodeN

### Opção

\-n, --node-name <nodeID>

Obrigatório.

Especifica a ID do nó para onde o repositório deve ser movido.

> [!IMPORTANT]
> 
> **Importante:** isso não interrompe ou exclui a instância de RDS. Para obter mais informações sobre como excluir uma instância de RDS, consulte [Exclusão de uma instância de DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html#USER_DeleteInstance.NoSnapshot) no site do AWS.

## tsm topology external-services repository enable

Use o comando tsm topology external-services repository enable para configurar o Tableau Server para usar um repositório externo. Esse comando pode ser usado durante a instalação de um novo Tableau Server para configurar o repositório externo. Se executado em um Tableau Server já existente e em execução, esse comando migrará os dados do nó local para o repositório externo e configurará o Tableau Server para usar o repositório externo após a conclusão da migração.

### Sinopse

tsm topology external-services repository enable -f <filename>.json -c <ssl certificate file>.pem

### Opções

\--f <file name>

Obrigatório.

Caminho e nome de arquivo completos do local onde o arquivo de configuração foi salvo. Para obter mais informações, consulte [Reconfigurar o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo_reconfigure.htm).

\--c <ssl certificate file>

Obrigatório para as versões 2021.2 e 2021.2.1. Opcional para versões 2021.2.2 e posteriores.

Para configurações SSL, baixe o arquivo de certificado e especifique o arquivo para uso com essa opção.

1. **Amazon RDS:** consulte [Uso de SSL para criptografar a conexão a uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL).
2. **Banco de dados do Azure:** consulte [Configurar a conectividade TLS no banco de dados do Azure para PostgreSQL](https://docs.microsoft.com/pt-br/azure/postgresql/concepts-ssl-connection-security).
3. **Instância PostgreSQL autônoma:** consulte [Configurar o SMTP](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_standalone.htm#configure-ssl) .

\--no-ssl

Opcional. Esta opção está disponível nas versões 2021.2.2 e posteriores.

Isso significa que o SSL não é necessário ao se conectar ao Repositório externo. Se você não precisa usar conexões criptografadas, também deve configurar o Repositório externo para permitir conexões não criptografadas. Ao usar esta opção, as conexões serão criptografadas se o repositório externo estiver configurado para oferecer suporte a conexões TLS/SSL. Caso contrário, o Tableau Server usará conexões não criptografadas.

Ignora a verificação para ver se o repositório externo já está configurado para uso com o Tableau Server. Essa opção normalmente não é recomendada, pois pode fazer com que o mesmo repositório seja usado por várias instalações do Tableau Server, o que pode causar erros. Esta opção pode ser útil para fins de teste ou recuperação de desastres.

\--skip-state-check

Opcional. Esta opção está disponível nas versões 2022.3.0 e posteriores.

Ignora a verificação para ver se o repositório externo já está configurado para uso com o Tableau Server. Essa opção pode ser útil para fins de teste ou recuperação de desastres, mas não é recomendada para uso normal, pois pode fazer com que o mesmo repositório seja usado por várias instalações do Tableau Server.

## tsm topology external-services repository replace-host

Este comando atualiza as configurações do Tableau Server para usar o repositório externo especificado. Use o comando tsm topology external-services repository replace-host para reconfigurar o Tableau Server para usar o novo repositório externo imediatamente, sem mover dados do repositório externo atual para ele. Pode ser necessário migrar manualmente os dados. Só faça isso depois de ter avaliado completamente e entendido o impacto da potencial perda de dados.

Esse comando pode ser usado nos seguintes cenários:

- Expiração planejada dos certificados SSL usados pelas instâncias RDS: as instâncias RDS precisam ser atualizadas com os novos certificados, e o Tableau Server precisa ser configurado para usar o novo arquivo de certificado para se conectar à instância RDS.
- Recuperação de desastres: use isso para se conectar a uma nova instância RDS em cenários de recuperação de desastres. Para obter mais informações, consulte [Criar uma instância de banco de dados PostgreSQL no Serviço de banco de dados relacional (RDS) da AWS](https://help.tableau.com/current/server/pt-br/server_external_repo_configure_RDS.htm#disaster-recovery-postgreSQL_DB)

### Sinopse

tsm topology external-services repository replace-host -f <filename>.json -c <ssl certificate file>.pem

### Opções

\-f <file name>

Obrigatório.

Caminho e nome de arquivo completos do local onde o arquivo de configuração foi salvo. Para obter mais informações, consulte [Reconfigurar o repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_external_repo_reconfigure.htm).

\-c <ssl certificate file>

Opcional.

O arquivo de certificado é o certificado a ser importado para permitir conexões com a instância. Para RDS, esse é o certificado CA usado para assinar o certificado da instância. Ele é geralmente o arquivo de certificado raiz **rds-ca-XXXX-root.pem mais recente.** Use esse parâmetro para atualizar o Tableau Server se o certificado tiver sido alterado na instância RDS.

Para obter mais informações, consulte [Uso de SSL/TLS para criptografar a conexão com a uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html "Uso de SSL/TLS para criptografar uma conexão a uma instância de banco de dados").

Para obter mais informações sobre como obter o arquivo .pem, consulte [Uso de SSL para criptografar uma conexão com uma instância de DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL).

\--ignore-prompt

Opcional.

Execute esse comando sem instruções.

## tsm topology external-services storage disable

Configure o Tableau Server para executar o Armazenamento de arquivos localmente. Use este comando para desativar o Armazenamento de arquivos externo e mover os dados do Armazenamento de arquivos para o Tableau Server.

### Sinopse

tsm topology external-services storage disable \[options\] \[global options\]

### Opções

\-fsn <nodeID, nodeID,...>

Obrigatório

Especifique os nós que você deseja para configurar o Armazenamento de arquivos. É possível especificar mais de um nó. Os dados serão migrados para o primeiro nó da lista e depois replicados para outros nós.

Para obter mais informações, consulte [Reconfigurar Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_reconfigure.htm).

## tsm topology external-services storage enable

Configure o Tableau Server com Armazenamento de arquivos externo. O Armazenamento de arquivos externo usa SAN ou NAS para armazenar os dados do Armazenamento de arquivos.

### Sinopse

tsm topology external-services storage enable \[options\] \[global options\]

### Opções

\--network-share <network share path>

Obrigatório

Especifique o nome e o caminho do compartilhamento de rede que você deseja usar para o Armazenamento de arquivos externo.

Para obter mais informações, consulte [Reconfigurar Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_reconfigure.htm).

## tsm topology external-services storage switch-share

Use este comando para transferir seus serviços externos para um compartilhamento de rede diferente. Um exemplo disso pode ser quando o armazenamento conectado à sua rede atual está no fim da vida útil, e você precisa usar um novo armazenamento conectado à rede com novo hardware. Para obter mais informações, consulte [Reconfigurar Armazenamento de arquivos](https://help.tableau.com/current/server/pt-br/server_external_filestore_storage_reconfigure.htm).

### Sinopse

tsm topology external-services storage switch-share \[option\] \[global options\]

### Opção

\--network-share <network share path>

Obrigatório

Especifique o caminho para o novo compartilhamento de rede para o qual você deseja mudar.

## tsm topology failover-repository

É possível usar `tsm topology failover-repository` para iniciar manualmente um failover do repositório atualmente ativo para o segundo repositório passivo.

O comando `tsm topology failover-repository` é persistente. O failover de repositório permanece como o repositório ativo até que emita o comando novamente, ou, se o Tableau Server estiver configurado para isso, até que ocorra o failover automático. Se você tiver um repositório ativo de preferência configurado, use a opção `--preferred` para retornar para esse repositório. Para obter mais informações sobre a configuração de um repositório ativo de preferência, consulte [Repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_repository.htm).Se o Tableau Server estiver configurado para alta disponibilidade, o failover do repositório é automático, quando necessário. Use o comando do failover de repositório para fazer o failover manual do repositório.

### Sinopse

`tsm topology failover-repository --preferred | --target <node_id> [global options]`

### Opções

\-r, --preferred

Exigido se -t ou --target não for usado.

Use o nó de preferência como o destino para o failover de repositório.

\--request-timeout <tempo limite em segundos>

Opcional.

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

\-t, --target <node\_id>

Exigido se -r ou --preferred não for usado.

A ID do nó de destino na qual ocorrerá o failover. Localize a ID do nó usando o comando `tsm topology list-nodes`.

## tsm topology filestore decommission

Você deve usar o comando `tsm topology filestore decommission` para preparar um nó ou nós do armazenamento de arquivos para a remoção segura. Este comando coloca os nós especificados em modo somente leitura e garante que não há conteúdo exclusivo nos nós especificados.

Se a desativação resultar em um nó único do armazenamento de arquivos, use a opção `--override`, ou ocorrerá uma falha na desativação.

### Sinopse

`tsm topology filestore decommission --nodes <nodeID,nodeID,...> [options] [global options]`

### Opções

\-n, --nodes <nodeID,nodeID,...>

Obrigatório.

Liste um ou mais nós para desativar, especificados pela ID do nó e separados por vírgulas.

\--delete-filestore

Opcional.

Força a remoção do armazenamento de arquivos, mesmo se ele não tiver sido desativado. Você só deve usar esta opção se o nó no qual o armazenamento de arquivos se encontra estiver em estado de erro e não seja possível desativá-lo. Qualquer arquivo único no nó será permanentemente excluído.

\-o, --override

Opcional.

Substitui avisos ou falhas que normalmente ocorreriam se a remoção do nó de destino do Repositório de arquivos reduzisse o número de nós do repositório de arquivos restantes para um. Essa opção não pode ser usada com a opção `--delete-filestore`.

\--request-timeout <tempo limite em segundos>

Opcional.

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

## tsm topology filestore recommission

Use o comando `tsm topology filestore recommission` para reverter todos os nós desativados de volta para o modo de leitura/gravação.

### Sinopse

`tsm topology filestore recommission --nodes <nodeID,nodeID,...> [global options]`

### Opções

\-n, --nodes <nodeID,nodeID,...>

Obrigatório.

Liste um ou mais nós para reativar, especificados pela ID do nó e separados por vírgulas.

## tsm topology list-nodes

Exibe os nós no cluster e (opcionalmente) nos serviços em cada nó.

### Sinopse

tsm topology list-nodes \[options\] \[global options\]

### Opções

\-v, --verbose

Opcional.

Mostra cada ID do nó, a função do nó (para obter mais informações, consulte `set-node-role` abaixo), o endereço do nó e os processos em cada nó.

## tsm topology list-ports

Exibe as portas no cluster.

### Sinopse

tsm topology list-ports \[options\] \[global options\]

### Opções

\--node-name <nodeID>

Opcional.

Determina o nó para o qual as portas serão listadas.

\--service-name

Opcional.

Especifica o serviço para o qual as portas serão listadas.

## tsm topology node-nickname list

Obtenha os pseudônimos dos nós no cluster.

### Sinopse

tsm topology node-nickname list \[options\] \[global options\]

### Opções

\--nodes <nodeID,nodeID,...>

Opcional.

Especifique as IDs dos nós a serem listadas com pseudônimos.

## tsm topology node-nickname remove

Remova o pseudônimo do nó ou nós especificados.

### Sinopse

tsm topology node-nickname remove \[options\] \[global options\]

### Opções

\--all

Obrigatório se --nodes não está especificado.

Obtenha os pseudônimos de todos os nós no cluster.

\--nodes <nodeID,nodeID,...>

Obrigatório se --all não for especificado.

Especifique a ID do nó ou nós cujos pseudônimos devem ser removidos.

## tsm topology node-nickname set

Configure o pseudômino para o nó especificado.

### Sinopse

tsm topology node-nickname set \[options\] \[global options\]

### Opções

\-id, --node <nodeID>

Obrigatório.

Especifique o nó para o qual configurar o apelido.

\-nn, --nickname <name>

Obrigatório.

O pseudônimo do nó especificado.

## tsm topology nodes get-bootstrap-file

É possível usar o comando `tsm topology nodes get-bootstrap-file` para obter o arquivo bootstrap necessário para adicionar um novo nó ao cluster.

**Importante**: o arquivo do bootstrap contém uma cópia do arquivo do repositório de chaves principal, usado para criptografar os segredos da configuração. O arquivo também pode ter credenciais inseridas válidas por um período predeterminado (consulte [tabadmincontroller.auth.expiration.minutes](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#tabadminctrlrauthexpire)) e servir como um cookie de sessão. Recomendamos fortemente que você tome medidas adicionais para proteger o arquivo bootstrap.

### Sinopse

tsm topology nodes get-bootstrap-file --file <path\\file>.json \[global options\]

### Opções

\-f,--file <file>

Obrigatório.

Caminho e nome de arquivo completos do local onde o arquivo de configuração será salvo. Se existir um arquivo duplicado, ele será substituído.

\-nec,--no-embedded-credential

Opcional.

Adicionado na versão 2019.3.

Por padrão, as credenciais inseridas são incluídas no arquivo bootstrap. Use essa opção caso as credenciais não devam ser incluídas no arquivo bootstrap. As credenciais inseridas são temporárias e expiram de acordo com o valor da chave de configuração `[tabadmincontroller.auth.expiration.minutes](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#tabadminctrlrauthexpire)`, por padrão, 120 minutos.

Observação: é possível desabilitar a capacidade de incluir credenciais inseridas no nível do servidor, usando uma opção de configuração. Para obter mais informações, consulte [features.PasswordlessBootstrapInit](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#pwdlessbootstrap).

## tsm topology remove-nodes

Remove os nós do cluster.

Para concluir a remoção de um nó, você também deve executar o comando `tsm pending-changes apply`. Alguns cenários exigem que os processos sejam movidos ou reimplantados antes da remoção dos nós. Consulte [Remover um nó](https://help.tableau.com/current/server/pt-br/distrib_worker_remove.htm#top).

Se você remover um nó e quiser adicioná-lo novamente ao cluster, primeiro será necessário executar o script obliterate para limpar o Tableau e depois reinstalar o nó usando o processo normal de adição de um novo nó. Para obter mais informações, consulte [Remover o Tableau Server do computador](https://help.tableau.com/current/server/pt-br/remove_tableau.htm) e [Instalar e configurar nós adicionais](https://help.tableau.com/current/server/pt-br/install_additional_nodes.htm).

**Observação**: para remover um nó de um cluster, é possível que tenha sido configurado com um processo em algum ponto. Se estiver removendo um nó no qual nunca configurou processos, é necessário adicionar um processo a ele, executar `[tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply)` e remover o nó.

### Sinopse

tsm topology remove-nodes --nodes <nodeID,nodeID,...> \[global options\]

### Opções

\-n, --nodes <nodeID,nodeID,...>

Obrigatório.

Especifica o nó ou nós a serem removidos. Se estiver especificando vários nós, separe as IDs do nó por vírgula.

## tsm topology set-node-role

Defina as funções do nó do Processador em segundo plano e Extrair consultas. Isso determina o tipo de tarefas que será executado nos nós. As seguintes funções de nó podem ser úteis se você tiver um cluster de vários nós. Diferentes funções de nó podem exigir licenças para Advanced Management ou Data Management, ou para ambos. Para obter mais informações sobre os requisitos da licença, consulte [Gerenciamento de carga de trabalho por meio das funções de nó](https://help.tableau.com/current/server/pt-br/server_node_roles.htm).

**Observação:** fazer configurações para funções de nó requer uma reinicialização do servidor e exigirá algum tempo de inatividade. Para obter mais informações, consulte [tsm pending-changes](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm).

### Sinopse

tsm topology set-node-role \[options\] \[global options\]

### Opções

\-n, --nodes <nodeID,nodeID,...>

Obrigatório.

Liste um ou mais nós para definir funções de nó, especificados pela ID do nó e separados por vírgulas e sem espaços entre os nós.

\-r --role <all-jobs,flows,no-flows,extract-refreshes,subscriptions,extract-refreshes-and-subscriptions,no-extract-refreshes,no-subscriptions,no-extract-refreshes-and-subscriptions,extract-queries,extract-queries-interactive>

Obrigatório

Define a função para os nós especificados. Os valores válidos para esta opção são:

- todos os trabalhos: o processador em segundo plano executará todos os tipos de trabalho.
- fluxos: o processador em segundo plano executará somente os trabalhos de execução de fluxo.
- nenhum fluxo: o processador em segundo plano não executará os trabalhos de execução de fluxo.
- atualizações de extração: o processador em segundo plano executará somente os trabalhos de atualização de extração. Isso inclui atualizações incrementais, atualizações completas, criptografia e descriptografia de todas as extrações, incluindo as extrações geradas pelas saídas de fluxo.
- assinaturas: o processador em segundo plano executará somente os trabalhos de assinatura.
- atualizações de extração e assinaturas: o processador em segundo plano executará os trabalhos de atualizações de extração, criptografia e descriptografia de todas as extrações, incluindo as extrações criadas pelas saídas de fluxo e assinatura.
- nenhuma atualização de extração: o processador em segundo plano executará todos os trabalhos, exceto as atualizações de extração, criptografia e descriptografia de extração, incluindo as extrações criadas pelas saídas de fluxo.
- nenhuma assinatura: o processador em segundo plano executará todos os trabalhos, exceto as assinaturas.
- nenhuma atualização de extração e assinatura: o processador em segundo plano executará todos os trabalhos, exceto as atualizações de extração, criptografia e descriptografia de todas as extrações, incluindo as extrações criadas pelas saídas de fluxo e assinaturas.
- extract-queries: os nós selecionados serão executados como all-jobs e priorizarão o processamento das consultas de extração.
- extract-queries-interactive: os nós selecionados serão executados como todos os trabalhos e priorizarão o processamento de consultas de extração interativas, como aquelas que são executadas quando um usuário está olhando para sua tela e aguardando o carregamento de um painel baseado em extração. Esta é uma configuração avançada e só deve ser usada se o cluster tiver uma carga de trabalho pesada de assinatura e alertas, que faz com que os usuários tenham um desempenho diminuído em tempos de carregamentos de visualização que são executados na mesma hora que carregamentos agendados.
- system: o processador em segundo plano executará apenas trabalhos de manutenção do sistema que interagem com outros processos do Tableau Server, como limpeza de trabalhos travados, coleta de eventos de banco de dados e sincronização do Active Directory.
- no-system: o processador em segundo plano executará todos os trabalhos, exceto as assinaturas.

## tsm topology set-ports

Define as portas para uma instância de serviço.

### Sinopse

tsm topology set-ports --node-name <nodeID> --port-name <port\_name> --port-value <port\_value> \[options\] \[global options\]

### Opções

\-i, --instance <instance\_id>

Opcional.

Especifica a id de instância do serviço. Coloca 0 (zero) como padrão, se não especificado.

\-n, --node-name <nodeID>

Obrigatório.

Especifica a ID do nó.

\-pn, --port-name <port\_name>

Obrigatório.

O nome da porta a ser definida, neste formato: `service_name:port_type`. Se nenhum tipo de porta for especificado, a porta primária é considerada. Para obter sintaxe de nome de porta, consulte [Portas mapeadas dinamicamente](https://help.tableau.com/current/server/pt-br/ports.htm#Dynamica).

\-pv, --port-value <port\_value>

Obrigatório.

A porta a ser definida.

\-r, --restart

Opcional.

Suprime o prompt de reinicialização e reinicializa o Tableau Server quando necessário.

## tsm topology set-process

Definir o número de instâncias de processo em um nó. Se o nó já tiver o processo especificado, o número é atualizado para corresponder à contagem especificada.

- É possível definir apenas um processo por vez. Se você especificar mais que um processo, qualquer processo depois dele será ignorado silenciosamente.
- Você deve definir um nó de processo de cada vez. Se você especificar mais de um nó, o comando exibirá um erro de "nome de nó inválido".

Ao atualizar o número de processos nos números, também é preciso aplicar as alterações pendentes. Na maioria dos casos, isso também requer uma reinicialização do servidor (você será solicitado), mas há casos especiais em que você pode fazer alterações dinâmicas de topologia sem precisar reiniciar o servidor. Para obter mais informações, consulte [Alterações de topologia dinâmica do Tableau Server](https://help.tableau.com/current/server/pt-br/server_process_hot_topo.htm).

**Observação:** para obter uma lista completa dos nomes de processo, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

### Sinopse

tsm topology set-process --count <process\_count> --node <nodeID> --process <process\_name> \[global options\]

### Opções

\-c, --count <process\_count>

Obrigatório.

A contagem de processo (número de instâncias) a ser definida.

\-n, --node <nodeID>

Obrigatório.

Especifica a ID do nó no qual será definido o processo. O `<nodeID>` diferencia maiúsculas de minúsculas. Usar o caso incorreto pode fazer com que o comando falhe ou resultar em erros do sistema.

\-pr, --process <process\_name>

Obrigatório.

O nome do processo a ser definido.

## tsm topology toggle-coordination-service

**Observação:** começando com a versão 2020.1.0, todos os comandos do ensemble de serviço de coordenação requerem entrada para um prompt "y/n", confirmando que haverá reinicialização do servidor. Para executar esses comandos sem entrada, inclua a opção `--ignore-prompt`.

É possível usar o comando `tsm topology toggle-coordination-service` para alternar entre ensembles do Serviço de coordenação. Para saber mais sobre os ensembles do Serviço de coordenação, consulte [Implantar um ensemble do Serviço de coordenação](https://help.tableau.com/current/server/pt-br/distrib_ha_zk.htm).

Na versão 2020.1.0 e posterior, o comando `tsm topology deploy-coordination-service` também muda para o novo ensemble. Não há necessidade de executar este comando separadamente.

### Sinopse

tsm topology toggle-coordination-service \[option\] \[global options\]

### Opção

\--request-timeout <tempo limite em segundos>

Opcional.

Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 1800 (30 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=f06febe3adb10127510508a103ccf0588a241116b34e60c55968b8b5cf2e6342 url=/tableau/current/pt-br/server/cli_user-identity_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm user-identity-store

É necessário usar os comandos `tsm user-identity-store` para modificar as configurações do armazenamento de identidades do Tableau Server após a configuração inicial.

A configuração inicial do armazenamento de identidades é parte do processo de instalação. Consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

Para uma introdução aos conceitos do armazenamento de identidades, consulte [Repositório de identidades](https://help.tableau.com/current/server/pt-br/plan_identity_store.htm).

Para a tabela de referência de configuração do LDAP/Active Directory, consulte [Referência de configuração do armazenamento de identidades externo](https://help.tableau.com/current/server/pt-br/ldap_config.htm).

- [get-group-mappings](#TSMGroupMap)
- [get-user-mappings](#TSMUserMap)
- [list](#TSMUIList)
- [set-connection](#TSMSetConnection)
- [set-group-mappings](#TSMSetGroupMap)
- [set-user-mappings](#TSMSetUserMap)
- [verify-group-mappings](#TSMverify-group-mappings)
- [verify-user-mappings](#TSMIDverify-user-mappings__[options])

## tsm user-identity-store get-group-mappings \[options\]

Exibe os mapeamentos do grupo do repositório de identidades .

### Sinopse

tsm user-identity-store get-group-mappings \[global options\]

## tsm user-identity-store get-user-mappings \[options\]

Exibe os mapeamentos do usuário do repositório de identidades.

### Sinopse

tsm user-identity-store get-user-mappings \[global options\]

## tsm user-identity-store list \[options\]

Lista a configuração de identidade de usuário.

### Sinopse

tsm user-identity-store list \[options\] \[global options\]

### Opções

\-v, --verbose

Opcional.

Lista todos os parâmetros de configuração.

## tsm user-identity-store set-connection \[options\]

Define parâmetros de conexão do repositório de identidades.

### Sinopse

tsm user-identity-store set-connection --kerbkeytab <kerbkeytab> \[options\] \[global options\]

### Opções

\-b,--bind <username and password | Kerberos>

Opcional.

Define o tipo de associação LDAP.

\-d,--domain <domain>

Opcional.

Nome de domínio.

\-hn,--hostname <hostname>

Opcional.

O nome de host do servidor LDAP. Você pode inserir um nome de host ou endereço IP para este valor. O host especificado aqui será usado para consultas de usuário/grupo no domínio primário. No caso em que as consultas de usuário/grupo estejam em outros domínios, o Tableau Server consultará o DNS para identificar o controlador de domínio apropriado.

\-kc,--kerbconfig <kerbconfig>

Opcional.

Caminho do arquivo de configuração do Kerberos.

\-kp,--kerbprincipal <kerbprincipal>

Opcional.

Kerberos Principal.

\-kt,--kerbkeytab <kerbkeytab>

Obrigatório.

Caminho do arquivo keytab do Kerberos.

\-l,--port <port>

Opcional.

Define o valor da porta LDAP.

\-lp,--ldappassword <ldappassword>

Opcional.

Senha LDAP.

\-lu,--ldapusername <ldapusername>

Opcional.

Define o valor de nome de usuário LDAP.

\-n,--nickname <nickname>

Opcional.

Nome NetBIOS (apelido).

## tsm user-identity-store set-group-mappings \[options\]

Define os mapeamentos do grupo de repositório de identidades e configura os diretórios LDAP que implementam um esquema arbitrário ou personalizado.

### Sinopse

tsm user-identity-store set-group-mappings \[options\] \[global options\]

### Opções

\-b,--basefilter <groupbasefilter>

Opcional.

Define o valor BaseFilter do grupo.

\-cn,--classnames <group\_classnames>

Opcional.

Substitui os valores padrão de nome da classe do usuário (contém a cadeia de caracteres "groupo”) pelos valores definidos aqui. É possível fornecer vários nomes de classe separados por vírgulas.

\-d,--description <description>

Opcional.

Descrição do grupo.

\-e,--groupemail <groupemail>

Opcional.

Valor de e-mail do grupo.

\-m,--member <member>

Opcional.

Define os membros do grupo.

\-n,--groupname <groupname>

Opcional.

Nome do grupo.

## tsm user-identity-store set-user-mappings \[options\]

Define os mapeamentos do usuário de repositório de identidades e configura os diretórios LDAP que implementam um esquema arbitrário ou personalizado.

### Sinopse

tsm user-identity-store set-user-mappings --certificate <certificate> \[options\] \[global options\]

### Opções

\-c,--certificate <certificate>

Opcional.

Localização do arquivo de certificado dos usuários.

\-cn,--classnames <user\_classnames>

Opcional.

Substitui os valores padrão de nome da classe do usuário ("user” e "inetOrgPerson”) pelos valores definidos aqui. É possível fornecer vários nomes de classe separados por vírgulas.

\-dn,--displayname <displayname>

Opcional.

Nome de exibição do usuário.

\-e,--email <email>

Opcional.

Endereço de e-mail do usuário.

\-jp,--jpegphoto <jpegfile>

Opcional.

Localização da imagem jpeg do usuário.

\-m,--memberof <groupname>

Opcional.

Grupo do qual o usuário é um membro.

\-t,--thumbnail <thumbnail>

Opcional.

Localização da miniatura do usuário.

\-ub,--basefilter <userbasefilter>

Opcional.

BaseFilter do usuário.

\-uu,--ldapusername <ldapusername>

Opcional.

Nome de usuário.

## tsm user-identity-store verify-group-mappings \[options\]

Valida a configuração para o mapeamento de grupos LDAP.

**Nota:** este comando usa as credenciais armazenadas em `[wgserver.domain.username](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain-username)` e `[wgserver.domain.password](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain-password)`. Se essas chaves não estiverem configuradas, o comando falhará mesmo se Tableau Server for conectado com êxito ao Active Directory.

### Sinopse

tsm user-identity-store verify-group-mappings --verify <group\_name> \[global options\]

### Opções

\-v,--verify <group\_name>

Opcional.

Nome do grupo a ser pesquisado.

## tsm user-identity-store verify-user-mappings \[options\]

Valida a configuração para o mapeamento de usuários LDAP.

**Nota:** este comando usa as credenciais armazenadas em `[wgserver.domain.username](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain-username)` e `[wgserver.domain.password](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#wgserver-domain-password)`. Se essas chaves não estiverem configuradas, o comando falhará mesmo se Tableau Server for conectado com êxito ao Active Directory.

### Sinopse

tsm user-identity-store verify-user-mappings --verify <user\_name> \[global options\]

### Opções

\-v,--verify <user\_name>

Opcional.

Nome do usuário a ser pesquisado.

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=90b8184f8863b80a0d9aad70aa258539fc340026358f4228cb87afe3753d4c6d url=/tableau/current/pt-br/server/cli_version_tsm.md -->

[Pular para o conteúdo principal](#main-content)

# tsm version

É possível usar o comando `tsm version` para obter as versões do TSM e do Tableau Server.

### Sinopse

`tsm version [global options]`

## 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](https://help.tableau.com/current/server/pt-br/tsm_overview.htm#Connecti).

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

<!-- document id=2f31d6789b33b270347da9dbff0ee019fbb719485c315df88049f489a7b430df url=/tableau/current/pt-br/server/cmt-using.md -->

[Pular para o conteúdo principal](#main-content)

# Usando Content Migration Tool do Tableau

As etapas a seguir foram projetadas para orientá-lo usando o Content Migration Tool do Tableau:

- [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm)
    - [Planos de migração: sites](https://help.tableau.com/current/server/pt-br/cmt-plan_servers.htm)
    - [Planos de migração: projetos de origem](https://help.tableau.com/current/server/pt-br/cmt-plan_source_projects.htm)
    - [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm)
    - [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm)
    - [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm)
    - [Planos de migração: scripts de migração](https://help.tableau.com/current/server/pt-br/cmt-plan_scripts.htm)
    - [Planos de migração: opções de planejamento](https://help.tableau.com/current/server/pt-br/cmt-plan_options.htm)
- [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm)

<!-- document id=97c447a790ea1f734e2963182a95eca53315cb12b643e5e2c564a18e4636ee70 url=/tableau/current/pt-br/server/datasource_certified.md -->

[Pular para o conteúdo principal](#main-content)

# Usar certificação para ajudar usuários a encontrar dados confiáveis

Em um ambiente de autoatendimento com vários publicadores, é comum que um projeto no Tableau Server inclua uma variedade de conteúdo nomeado de forma semelhante ou que seja baseado nos mesmos dados ou em dados subjacentes semelhantes, ou que seja publicado sem qualquer informação descritiva sobre ele. Quando este é o caso, os analistas podem não ter confiança sobre os dados que devem usar.

Para ajudar os usuários a encontrar os dados confiáveis e recomendados para o tipo de análise que desejam realizar, você pode _certificar_ os dados que atendem aos padrões de dados da sua empresa.

A certificação complementa o recurso [Cronograma de treinamento de recomendações](https://help.tableau.com/current/server/pt-br/maintenance_set.htm#Recommendations_admin), oferecendo uma maneira de promover os dados por meio da curadoria.

Além de certificar fontes de dados publicadas, se você tiver licença do Data Management para Tableau Server ou Tableau Cloud:

- Se Tableau Catalog estiver habilitado, você poderá certificar bancos de dados e tabelas associados ao conteúdo do Tableau. (Para obter mais informações sobre Tableau Catalog, consulte "Sobre o Tableau Catalog”, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm).)
- A partir do Tableau 2022.1, você pode certificar conexões virtuais e tabelas de conexões virtuais.

## Como a certificação ajuda os usuários a encontrar dados confiáveis

Quando você certifica um ativo, os usuários veem um emblema ou marca de seleção verde, dependendo de onde o ativo está sendo visualizado.

![Crachá certificado no banco de dados](/tableau/current/pt-br/server/pt-br/Img/datasource_cert_badge_1.png)

![Emblema certificado na fonte de dados conforme aparece na Criação da Web ou no Desktop](/tableau/current/pt-br/server/pt-br/Img/datasource_cert_badge_2.png)

![Crachá certificado na fonte de dados conforme aparece na exibição de lista de servidores](/tableau/current/pt-br/server/pt-br/Img/datasource_cert_badge_3.png)

As fontes de dados certificadas têm uma classificação superior nos resultados de pesquisa e são adicionadas às fontes de dados recomendadas.

Além disso, você pode fornecer observações sobre o status da certificação, exibido quando os usuários clicam no crachá, ou em uma dica de ferramenta ao passarem o mouse sobre o ícone da fonte de dados na criação na Web ou no Tableau Desktop. As informações também mostram quem certificou a fonte de dados.

![](/tableau/current/pt-br/server/pt-br/Img/datasource_cert_badge_tooltip.png)

## Criar diretrizes para selecionar os dados para certificação

Como a maioria dos recursos do Tableau, a certificação é flexível. Você pode definir para a sua empresa os critérios usados para determinar quando certificar um ativo. Ao fazer isso, documente e compartilhe suas diretrizes. As diretrizes podem ajudar você, outros administradores e líderes de projetos a serem consistentes com suas escolhas de certificação. Elas também podem ajudar os usuários a entender o que a certificação significa.

Mesmo que use os mesmos critérios de certificação em todos os projetos ou opte por definir critérios únicos para cada projeto, o importante é ser claro sobre o que a certificação significa no seu ambiente.

## Quem pode certificar os dados

Para certificar uma fonte de dados, você deve:

- ser um servidor ou administrador de site _ou_
- ter uma função de site do Explorer (pode publicar) ou Creator _e_ ser o proprietário do projeto ou ter o recurso Líder de Projeto no projeto que contém os dados que deseja certificar.

Para certificar conexões virtuais e tabelas de conexões virtuais, você deve ter uma licença do Data Management em seu ambiente e você deve

- ser um servidor ou administrador de site _ou_
- ter uma função de site do Explorer (pode publicar) ou Creator _e_ ser o proprietário do projeto ou ter o recurso Líder de Projeto no projeto que contém os dados que deseja certificar.

Para certificar os bancos de dados ou tabelas, você deve habilitar o Tableau Catalog no ambiente e você deve

- ser um servidor ou administrador de site _ou_
- ter o recurso Definir permissões no banco de dados para certificar esse banco de dados ou quaisquer tabelas nesse banco de dados.

## Como certificar dados

Os dados que você pode certificar dependem das permissões que você possui e se você tem uma licença do Data Management e o Tableau Catalog habilitado em seu ambiente.

- Todos os usuários com permissões podem certificar fontes de dados.
- Se você tiver a licença do Data Management, os usuários com as permissões corretas também poderão certificar conexões virtuais e tabelas de conexões virtuais.
- Se você tem uma licença do Data Management, e o Tableau Catalog estiver habilitado, os usuários com permissões também poderão certificar bancos de dados, tabelas e arquivos.

Para certificar um ativo:

Observação: a partir de fevereiro de 2024 no Tableau Cloud e no Tableau Server 2024.2, você pode adicionar e remover certificações usando a caixa de diálogo consolidada de Rótulos de dados em vez de caixas de diálogo separadas para cada tipo de rótulo. Para obter informações sobre a caixa de diálogo Rótulos de dados, consulte [A caixa de diálogo Rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels.htm#data-labels-dialog).

1. Pesquise ou navegue até o ativo. As etapas para navegar dependem do tipo de ativo que você deseja certificar:
    - Fonte de dados ou conexão virtual - na página Explorar, selecione Todas as fontes de dados ou Todas as conexões virtuais.
    - Tabela de conexão virtual - na página Explorar, selecione Todas as conexões virtuais e selecione a conexão virtual que contém a tabela de conexão virtual que você deseja certificar. Em seguida, selecione a tabela de conexão virtual.
    - Banco de dados ou tabela - na página Explorar, navegue até o banco de dados ou tabela. Na página Ativos externos, selecione Bancos de dados e arquivos ou Tabelas e objetos.
2. Na página, selecione o menu Mais ações (...) ao lado do nome do ativo que deseja certificar.
3. Selecione Rótulos de dados > Certificação (ou Editar certificação no Tableau Server 2023.1 e versões anteriores)
4. Marque a caixa de seleção Certificado. (Em versões anteriores do Tableau Server, use o botão de alternância.)
5. Adicione uma mensagem, se desejar. A mensagem fornece aos usuários o contexto do status da certificação, o uso desejado para os dados ou outras informações úteis. As informações adicionadas à seção Mensagem são exibidas na dica de ferramenta ou crachá de certificação mencionada anteriormente em [Como a certificação ajuda os usuários a encontrar dados confiáveis](#certify-how-it-helps). Você pode formatar o texto em uma mensagem com negrito, sublinhado e itálico e incluir um link ou uma imagem. Para ver dicas de formatação de texto, clique no ícone de informações (i) acima do botão Salvar. (A partir de fevereiro de 2024 no Tableau Cloud, a mensagem é opcional. Versões anteriores do Tableau Cloud e do Tableau Server exigiam isso.)
    
    ![](/tableau/current/pt-br/server/pt-br/Img/datasource_cert_certify_checkbox.png)
6. Selecione Salvar.

## Personalizar certificação

A partir do Tableau Cloud de junho de 2023 e do Tableau Server 2023.3, usando o gerenciador de rótulos na página Rótulos de dados ou a API REST, um administrador pode alterar a descrição da certificação que os usuários veem na caixa de diálogo de certificação. Para obter mais informações, consulte [Gerenciar rótulos de dados](https://help.tableau.com/current/server/pt-br/dm_labels_manage.htm).

<!-- document id=d75aae184ed7133e57c32e1d97836cf0c24be9c2495617e5ac0f94769d4caf31 url=/tableau/current/pt-br/server/customview.md -->

[Pular para o conteúdo principal](#main-content)

# Usar exibições personalizadas

Uma exibição personalizada é um atalho para um estado específico de interação, como seleções de filtro e classificação, para uma visualização publicada. As exibições personalizadas não afetam o conteúdo subjacente. São uma boa opção se você está ajustando os mesmos filtros ou ampliando os mesmos dados toda vez que olhar para uma visualização.

As exibições personalizadas não são iguais à edição da Web, que altera o próprio conteúdo publicado subjacente. Consulte [Editar exibições do Tableau na Web](https://help.tableau.com/current/pro/desktop/pt-br/web_author_build_view.htm).

Se as exibições personalizadas forem especificamente para configurações de filtro, considere o uso de parâmetros de filtro inseridos em uma URL compartilhada. Consulte [Filtrar um painel publicado editando a URL](https://www.thedataschool.co.uk/paul-hunt/filter-a-published-dashboard-by-editing-the-url) em [The Data School](https://www.thedataschool.co.uk/).

## Observações sobre exibições personalizadas

- Uma exibição personalizada não modifica o conteúdo em que foi criada.
- A exclusão do conteúdo original exclui suas exibições personalizadas.
- Se o conteúdo original for atualizado ou republicado, a exibição personalizada também será atualizada.
    
    > [!TIP]
    > 
    > **Dica**: algumas alterações no conteúdo original podem interromper a exibição personalizada. Consulte [Manter o conteúdo com exibições personalizadas](https://help.tableau.com/current/pro/desktop/pt-br/customview_update.htm) para obter as práticas recomendadas sobre como modificar o conteúdo com exibições personalizadas.
- Se um usuário for removido do site, todas as exibições personalizadas compartilhadas que ele tinha também serão perdidas.
- Assinaturas e alertas baseados em dados baseados em exibições personalizadas podem ser mais frágeis do que aqueles baseados no conteúdo original.

**Observação**: a partir da versão 2022.3, o Tableau substituiu os nomes de usuário na URL de exibição personalizada por IDs. URLs marcadas ainda funcionam, mas são redirecionadas para o novo esquema de URL. Essa mudança é para adicionar mais proteção de dados da empresa e do usuário.

## Criar uma exibição personalizada

Comece acessando a exibição individual. Faça as alterações que deseja capturar na exibição personalizada, como selecionar marcas, filtrar dados ou alterar classificações.

1. Quando estiver pronto para salvar as alterações feitas como uma exibição personalizada, selecione Salvar exibição personalizada na barra de ferramentas.
    
    **Observação**: salvar exibição personalizada aparece na barra de ferramentas após quaisquer alterações serem feitas na exibição atual.
2. Na caixa de diálogo Salvar exibição personalizada, digite um nome para a exibição personalizada.
3. (Opcional) Selecione Tornar meu padrão.
4. (Opcional) Selecione Tornar visível para outras pessoas. Isso torna a exibição personalizada disponível para todos que podem ver o conteúdo original. No entanto, há vários casos em que essa opção não está disponível:
    - O usuário tem uma função de site Viewer.
    - Os sites [Configuração de visibilidade do usuário](https://help.tableau.com/current/server/pt-br/user_visibility.htm#limit-user-visibility) está definido como Limitado.
    - A capacidade de permissão [Compartilhar personalizado](https://help.tableau.com/current/server/pt-br/permissions_capabilities.htm#workbooks) é negada na pasta de trabalho.
5. Salve as alterações.

## Localizar uma exibição personalizada

### De uma exibição

Quan você estiver procurando uma visualização, poderá alterar para uma exibição personalizada diferente selecionando o ícone Visualizar na barra de ferramentas. Se houver espaço na barra de ferramentas, o nome da exibição personalizada que você está visualizando será exibido.

Todas as exibições personalizadas que você criou e todas as exibições personalizadas visíveis feitas por outros usuários aparecem na lista.

### Da pasta de trabalho

Ao examinar o conteúdo no nível da pasta de trabalho, use a guia Exibições personalizadas para ver todas as exibições personalizadas disponíveis para essa pasta de trabalho.

![Tabela de visualizações personalizadas com nomes, ações, visualização original e informações do proprietário. O menu de contexto é expandido para uma das visualizações na lista, revelando as opções para alterar o proprietário ou excluir.](/tableau/current/pt-br/server/pt-br/Img/customviews_tab.png)

## Definir uma exibição personalizada padrão

Depois de encontrar ou criar uma exibição personalizada, você a torna padrão quando abre essa visualização.

1. Selecione o ícone Visualizar na barra de ferramentas.
2. Marque a opção Definir esta exibição como seu padrão.
3. Feche a caixa de diálogo para salvar.

Na próxima vez que abrir essa visualização, você chegará a essa exibição personalizada.

## Compartilhar uma exibição personalizada

Por padrão, as exibições personalizadas são privadas e aparecem apenas para o usuário que as criou.

**Observação**: os usuários com uma função no site Viewer não podem tornar exibições personalizadas visíveis para outras pessoas. No entanto, eles podem compartilhar uma exibição personalizada copiando e compartilhando a URL.

Os usuários com uma função no site Explorer ou superior podem definir uma exibição personalizada como visível para outras pessoas. Essa configuração permite que qualquer pessoa com acesso ao conteúdo original veja a exibição personalizada.

Para alterar uma exibição personalizada, privada e existente para que fique visível para outras pessoas (ou para tornar uma exibição visível privada):

1. Selecione o ícone Visualizar na barra de ferramentas.
2. Alterne o ícone do olho para a exibição que deseja compartilhar no estado desejado.
3. Feche a caixa de diálogo para salvar.

O olho com uma barra ![O ícone Ocultar visualizações personalizadas, que é um olho com uma linha diagonal atravessando-o.](/tableau/current/pt-br/server/pt-br/Img/customviews_hide.png) indica que a exibição é privada para você. O olho ![Mostrar ícone Exibições personalizadas, que é um símbolo de olho aberto.](/tableau/current/pt-br/server/pt-br/Img/customviews_show.png) indica que a exibição está visível para outras pessoas.

## Excluir uma exibição personalizada

Para excluir uma exibição personalizada:

1. Selecione o ícone Visualizar na barra de ferramentas.
2. Selecione o ícone da lixeira da exibição que você deseja excluir.
3. Confirme se deseja excluir a exibição.

### Cuidado ao excluir

Se você for o proprietário de uma exibição personalizada visível para outras pessoas, lembre-se de que ela será excluída para todos se você excluí-la.

A exclusão de uma exibição personalizada também exclui quaisquer assinaturas ou alertas baseados em dados com base nessa exibição personalizada.

## Gerenciar exibições personalizadas

Os administradores podem alterar a propriedade de exibições personalizadas e excluir exibições personalizadas criadas por outros usuários, a menos que a [visibilidade do usuário](https://help.tableau.com/current/server/pt-br/user_visibility.htm) esteja definida como limitada para o site.

Exibições personalizadas podem ser gerenciadas para um conteúdo ou para um usuário específico.

1. Vá para a guia Exibições personalizadas da pasta de trabalho ou do usuário.
2. Use o menu de ação para alterar o proprietário ou excluir a exibição personalizada.

![Tabela de visualizações personalizadas com nomes, ações, visualização original e informações do proprietário. O menu de contexto é expandido para uma das visualizações na lista, revelando as opções para alterar o proprietário ou excluir.](/tableau/current/pt-br/server/pt-br/Img/customviews_tab.png)

> [!TIP]
> 
> **Dica**: é uma prática recomendada alterar a propriedade de exibições personalizadas que pertencem a um usuário antes de removê-las do site. Excluir um usuário também exclui suas exibições personalizadas, inclusive exibições públicas que outras pessoas podem estar usando.

### Alterar o conteúdo com segurança usando exibições personalizadas

Se você modificar uma exibição que tenha exibições personalizadas (ou a fonte de dados na qual a exibição foi criada), saiba que certas alterações podem interromper as exibições personalizadas. Para obter mais informações, consulte [Manter o conteúdo com exibições personalizadas](https://help.tableau.com/current/pro/desktop/pt-br/customview_update.htm).

<!-- document id=b3963d28496ecbd36d400c1d187558c5157520ab6bb99e64b0bc5d418526c030 url=/tableau/current/pt-br/server/dashboard_extensions.md -->

[Pular para o conteúdo principal](#main-content)

# Usar extensões de painel

As extensões permitem adicionar recursos exclusivos a painéis ou integrá-los diretamente a aplicativos fora do Tableau. É fácil adicionar extensões; você as incorpora aos layouts de painel como qualquer outro objeto de painel.

As extensões expandem a funcionalidade do painel com a ajuda de aplicativos Web criados por desenvolvedores de terceiros. Se você for um desenvolvedor e quiser criar suas próprias extensões, consulte a [Documentação de API de extensões do Tableau](https://tableau.github.io/extensions-api/) no GitHub.

**Observação**: os administradores do Tableau podem desativar as extensões de painel para o [Tableau Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_setting_changes.htm#dashboard_extensions), o [Tableau Server](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm) e o [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dashboard_extensions_server.htm).

## Adicionar uma extensão a um painel

1. Em uma pasta de trabalho do Tableau, abra uma planilha de painel.
2. Na seção Objetos, arraste Extensão para o painel.
    
    ![Seta que mostra como adicionar uma extensão a um painel.](/tableau/current/pt-br/server/pt-br/Img/dashboard_extension_add.png)
3. Na caixa de diálogo "Adicionar uma extensão", realize uma destas ações:
    
    - Procure e selecione uma extensão.
    - Clique em Acesse extensões locais e navegue até um arquivo .trex baixado anteriormente.
4. Se solicitado, permita ou negue o acesso da extensão de painel aos dados da pasta de trabalho. Para obter mais informações, consulte [Extensões de segurança de dados, confiáveis do Tableau e habilitadas para rede](#Data).
    
    Se você permitir o acesso, siga todas as instruções na tela para configurar a extensão.
    
    **Observação:** se você estiver usando o Tableau Server ou Tableau Cloud, os objetos de extensão aparecerão em branco em impressões, PDFs e imagens de painéis (incluindo imagens em e-mails de assinatura).

### Configurar uma extensão de painel

Algumas extensões de painel oferecem opções de configuração que permitem personalizar recursos.

1. Selecione a extensão no painel e, no menu suspenso no canto superior direito, escolha Configurar.
2. Siga as instruções na tela para configurar a extensão.
    
    ![Menu de contexto para configurar uma extensão em um painel.](/tableau/current/pt-br/server/pt-br/Img/dashboard_extension_configure.png)

### Recarregar uma extensão de painel

Se uma extensão de painel deixar de responder, talvez seja necessário recarregá-la, o que é semelhante a atualizar uma página da Web em um navegador.

1. Selecione a extensão no painel e, no menu suspenso no canto superior direito, escolha Recarregar.
    
    A extensão de painel é atualizada e definida para seu estado original.
2. Se o recarregamento da extensão não recolocá-la em um estado utilizável, tente removê-la do painel e adicioná-la novamente.

## Extensões de segurança de dados, confiáveis do Tableau e habilitadas para rede

As extensões são aplicativos Web fornecidos em dois padrões:

- _Extensões confiáveis do Tableau_ foram especificamente analisadas e implantadas em hosts gerenciados pelo Tableau. Incluem extensões desenvolvidas e gerenciadas pelo Tableau, extensões criadas por parceiros do Tableau Exchange e implantadas com o serviço de extensão de revisão e host do Tableau, além de extensões em nosso host herdado de extensão de área restrita.
- _Extensões habilitadas para rede_ são hospedadas por um host de terceiros. Essas extensões permitem que os desenvolvedores gerenciem a entrega de suas extensões sem a mediação do Tableau. Incluem extensões gerenciadas diretamente pelos parceiros para fornecer melhor suporte à produção, extensões hospedadas e implantadas na rede local e extensões que exigem comunicação com serviços de terceiros fora do Tableau.

Antes de permitir uma extensão habilitada para rede, certifique-se de que você confia no desenvolvedor e no site que a hospeda.

Por padrão, as extensões usam o protocolo HTTPS, o que garante um canal criptografado para enviar e receber dados, além de garantir alguma privacidade e segurança. Para obter mais informações sobre segurança de dados ao usar extensões de painel, consulte [Segurança de extensão - Práticas recomendadas para implantação](https://help.tableau.com/current/server/pt-br/security_extensions.htm).

### Permitir ou negar uma extensão habilitada para rede

Por padrão, as extensões habilitadas para rede devem solicitar permissão para serem executadas. Essa caixa de diálogo de permissão fornecerá informações sobre o servidor de terceiros no qual ela está hospedada e o nível de acesso aos dados exigido pela extensão. Recomendamos que você revise essas informações antes de permitir a execução de uma extensão.

As extensões normalmente acessam dados visíveis em uma exibição. Uma extensão pode solicitar um acesso mais profundo a dados na pasta de trabalho quando solicita “Acesso total a dados”. Isso pode incluir acesso a dados subjacentes completos, nomes de tabelas e de campos de fontes de dados e informações sobre conexões de fontes de dados. Antes de permitir que a extensão seja executada na pasta de trabalho, examine as informações declaradas na caixa de diálogo de permissão de extensão e decida se deseja permitir ou negar a execução da extensão e o acesso a esses dados.

Se estiver exibindo um painel com uma extensão que exija acesso aos dados completos, e esse acesso tiver sido negado, uma mensagem será exibida no lugar da extensão. Se confiar na extensão e quiser usá-la, você poderá redefinir as permissões e permitir que a extensão seja executada.

![Menu de contexto para redefinir permissões de uma extensão em um painel.](/tableau/current/pt-br/server/pt-br/Img/dashboard_extension_reset_perms.png)

1. Selecione a extensão no painel e, no menu suspenso no canto superior direito, escolha Redefinir permissões.
2. Clique em Permitir para permitir que a extensão seja executada e acesse os dados ou em Negar para impedir que a extensão seja executada.

### Verifique se o JavaScript está ativado no Tableau Desktop

As extensões de painel interagem com os dados usando a biblioteca de API de extensões do Tableau, que é uma biblioteca JavaScript. Se você quiser usar extensões, verifique se o JavaScript está ativado nas configurações de segurança do painel:

Selecione Ajuda > Configurações e desempenho > Definir segurança de exibição do painel na Web > Habilitar JavaScript.

## Verificar se as extensões são executadas no Tableau Cloud ou no Tableau Server

Você pode adicionar extensões às pastas de trabalho publicadas no Tableau Desktop ou diretamente no modo de criação na Web do Tableau Cloud e do Tableau Server. Um administrador do Tableau deve permitir que as extensões sejam executadas em um site e adicionar extensões habilitadas para Rede a uma lista autorizada. Os administradores só devem permitir extensões testadas e confiáveis.

Se você quiser usar uma extensão de painel no Tableau Cloud ou no Tableau Server, direcione seu administrador para [Gerenciar extensões de painel no Tableau Cloud](https://help.tableau.com/current/online/pt-br/dashboard_extensions_server.htm) ou [Gerenciar extensões de painel no Tableau Server](https://help.tableau.com/current/server/pt-br/dashboard_extensions_server.htm).

### Verifique se a extensão tem permissões para acessar a pasta de trabalho ou exibição

Se você publicar uma pasta de trabalho que contenha uma extensão, certifique-se de que a extensão tenha acesso aos dados visíveis na exibição. Os dados visíveis também são conhecidos como dados de resumo. Para conceder esse acesso no Tableau Server ou no Tableau Cloud, certifique-se de que a pasta de trabalho ou exibição tenha permissão para Baixar dados de resumo. A extensão não baixa seus dados. A extensão requer apenas permissão para que possa interagir com os dados na exibição.

Dependendo da opção de mostrar planilhas como guias ao publicar a pasta de trabalho, defina a permissão para Baixar dados de resumo no nível da pasta de trabalho ou da exibição. Se as planilhas não aparecerem como guias, você vai configurar a permissão no nível da exibição.

Se você publicar a pasta de trabalho ou exibição no Tableau Public, a extensão também exigirá acesso aos dados visíveis. Para conceder permissão, abra Configurações e selecione Permitir acesso.

### Navegadores da Web compatíveis com extensões de área restrita

Extensões de área restrita executadas em todos os navegadores compatíveis com o [Tableau Server](https://www.tableau.com/pt-br/products/techspecs#server) e com o [Tableau Cloud](https://www.tableau.com/pt-br/products/techspecs), exceto o Internet Explorer 11.

### Versões do Tableau Server compatíveis com extensões de área restrita

É possível usar extensões de área restrita no Tableau Server 2019.4 e posteriores.

## Obter suporte para extensões de painel criadas por parceiros do Tableau e terceiros

As extensões criadas por parceiros do Tableau e terceiros não são compatíveis diretamente com o Tableau. No entanto, se precisar de ajuda, existem alguns lugares onde você pode procurar mais informações.

- Algumas páginas de parceiros no Tableau Exchange fornecem um link de **Suporte** direto para ajuda.
- Entre em contato com os criadores da extensão por meio do **link Site do desenvolvedor** no Tableau Exchange.

Em caso de dúvidas sobre a API de extensões, incentivamos os desenvolvedores a compartilhar perguntas e procurar ajuda por meio do [DataDev Slack Channel](https://tableau-datadev.slack.com/archives/CHJ9BHKG9) ou [enviar um problema no GitHub](https://github.com/tableau/extensions-api/issues) para a API de extensão.

<!-- document id=5e9c87778e6229a2407dfe1408232cfffba8891809b1b1616f3ed6ef65e1dff1 url=/tableau/current/pt-br/server/customize_fonts.md -->

[Pular para o conteúdo principal](#main-content)

# Usar fontes personalizadas no Tableau Server

É possível usar fontes personalizadas com o Tableau Server. Quando você faz isso, a maneira mais segura de garantir que os usuários tenham a experiência pretendida é mantendo o seguinte em mente:

\-- As fontes precisam ser instaladas no computador onde o Tableau Server é executado. Nos servidores Windows, instale as fontes para todos os usuários (selecione Instalar para todos os usuários). Depois de instalar as fontes, reinicie o Tableau Server para usar as novas fontes.
- As fontes precisam ser instaladas em qualquer computador cliente que será conectado ao Tableau Server. Você precisa ter as fontes instaladas localmente para que o navegador as exiba corretamente.
- Como prática recomendada, use "fontes seguras para a Web" que são instaladas por padrão em todos os principais navegadores. Isso aumenta a probabilidade delas serem exibidas corretamente nas máquinas dos clientes.
- Navegadores diferentes renderizam as mesmas fontes de maneiras diferentes, de modo que até quando o navegador do cliente tem a fonte personalizada instalada, ela pode ficar diferente quando visualizada em navegadores distintos. Isso pode ser especialmente perceptível com comentários ou títulos em que o espaçamento específico é usado para um efeito não intencional.

**Observação:** para obter mais informações sobre a instalação de fontes no Windows, consulte a [Base de dados de conhecimento da Microsoft](https://support.microsoft.com/pt-br/kb/314960).

<!-- document id=696f39fdcb76ea7643b54cb927cde858416f06014c369e8ec5024c39e280b6e6 url=/tableau/current/pt-br/server/dynamic_axis_ranges.md -->

[Pular para o conteúdo principal](#main-content)

# Usar Intervalos de eixos dinâmicos

É fundamental que seus usuários entendam o intervalo representado em uma visualização para que possam analisar os dados corretamente. Especialmente ao analisar diversas visualizações em um painel ou em diversas planilhas ao mesmo tempo, pode ser fácil para os usuários interpretar mal os dados quando o intervalo dos eixos é diferente entre as visualizações. Por exemplo, quando dois gráficos de barras aparecem um ao lado do outro, as barras em ambos os gráficos podem parecer ter tamanhos equivalentes. No entanto, os eixos podem ter intervalos muito diferentes, tornando os gráficos enganosos.

Para ajudar os usuários a entender o intervalo do eixo, em 2023.3 e posterior, os autores podem usar Intervalos de eixos dinâmicos para definir os valores mínimo e máximo de um intervalo de eixo usando parâmetros numéricos ou parâmetros de data. Então, à medida que os usuários navegam pelas visualizações, os eixos são atualizados de forma síncrona. Isso torna mais fácil para seus usuários analisar dados em visualizações com facilidade e precisão. E ao limitar o intervalo dos dados, você pode visualizar um subconjunto de dados sem filtrar os dados subjacentes ou impactar a média móvel dos seus dados.

Os Intervalos de Eixos Dinâmicos também podem ser usados para estender ou encurtar o intervalo de um eixo sem filtrar os dados subjacentes. Isso é ideal para mostrar o progresso em relação a uma meta ou uma média móvel.

## Tipos de campos compatíveis

Os Intervalos de eixos dinâmicos aceitam qualquer parâmetro que seja compatível com o eixo contínuo selecionado, por exemplo:

- Parâmetros numéricos
- Parâmetros temporais (data ou data e hora)

## Configurar um intervalo de eixos dinâmico com base na seleção

A partir do Tableau 25.3, você pode atualizar automaticamente o intervalo de eixos com base na seleção de área, eliminando a necessidade de fluxos de trabalho separados de parâmetros e ações de parâmetros.

1. Em uma planilha, clique com o botão direito do mouse no eixo e escolha Editar eixo…
2. Para o intervalo, escolha Personalizado.
3. Expanda os menus suspensos, escolha Atualizar na interação para os pontos de intervalo inicial e final.
4. Feche a caixa de diálogo.
5. Retorne à visualização e selecione uma área na visualização para definir o valor correspondente para o ponto de intervalo escolhido.  
      
    ![Caixa de diálogo Editar eixo com opção para definir intervalo personalizado como início e fim com base na interação.](/tableau/current/pt-br/server/pt-br/Img/dynamic_axis_selection.png)

## Configurar um intervalo de eixos dinâmico com um parâmetro existente

Você também pode configurar seu intervalo de eixos dinâmico vinculando-o a um parâmetro existente.

1. Em uma planilha, [crie um parâmetro](https://help.tableau.com/current/pro/desktop/pt-br/parameters_create.htm) para o eixo.
2. Clique com o botão direito do mouse no eixo e selecione Editar eixo.
3. Para o intervalo, escolha Personalizado. Em seguida, selecione o parâmetro que você criou para a extensão do eixo inicial ou final.
4. Feche a caixa de diálogo.
5. Se você estiver usando várias planilhas em um painel, repita essas etapas para os eixos nas diferentes planilhas.

![Uma animação que mostra um parâmetro usado para criar um intervalo de eixos dinâmico e, em seguida, a animação mostra como a filtragem é afetada pelos intervalos dinâmicos.](/tableau/current/pt-br/server/pt-br/Img/dynamic_axis_ranges.gif)

## Entender as limitações e os casos extremos

Os intervalos de eixos dinâmicos não são atualizados dentro [Histórias](https://help.tableau.com/current/pro/desktop/pt-br/stories.htm). Se o parâmetro usado para o eixo for excluído, o valor do parâmetro mais recente permanecerá como a extensão do eixo. Na próxima vez que você editar o eixo, uma mensagem de erro solicitará que você escolha um novo parâmetro a ser usado.

<!-- document id=cec01238f9956ab02475e37ed6d51f7d09cb26bc62e4e82289a6261327e27d57 url=/tableau/current/pt-br/server/dm_lineage.md -->

[Pular para o conteúdo principal](#main-content)

# Usar linhagem para análise de impacto

Saber a origem dos seus dados é fundamental para confiar nos dados, e saber quem mais usa isso significa que você pode analisar o impacto das alterações nos dados em seu ambiente. O recurso de linhagem no Tableau Catalog ajuda nisso.

Quando você tem uma licença de Gerenciamento de dados e o Tableau Catalog habilitado, tem acesso às informações de linhagem do seu conteúdo. Para obter mais informações sobre Tableau Catalog, consulte "Sobre o Tableau Catalog”, na Ajuda do [Tableau Server](https://help.tableau.com/current/server/pt-br/dm_catalog_overview.htm) ou do [Tableau Cloud](https://help.tableau.com/current/online/pt-br/dm_catalog_overview.htm).

## Navegar a linhagem

Para ver a linhagem de um ativo, primeiro navegue até a página do ativo. Suas opções para esta etapa incluem:

- Pesquise o ativo e selecione-o.
- Navegue até ele em Explorar.
- Se for um ativo externo (como banco de dados ou tabela) que não está em um projeto, navegue até ele por meio de Ativos externos. (Esta opção também funciona para recursos externos que _estão_ em projetos.)

Em seguida, selecione a guia Linhagem.

**Observação**: os dados de linhagem para fluxos não serão exibidos se o fluxo incluir valores de parâmetro. Para obter mais informações sobre como usar parâmetros nos fluxos, consulte [Criar e usar parâmetros em fluxos](https://help.tableau.com/current/prep/pt-br/prep_parameters.htm) na ajuda do Tableau Prep.

![A linhagem aparece na guia Linhagem da página de conteúdo](/tableau/current/pt-br/server/pt-br/Img/dm_lineage_content.png)

A linhagem mostra dependências em relação à âncora da linhagem, que nesse caso é o ativo que você selecionou. Uma âncora de linhagem pode ser um banco de dados, tabela, pasta de trabalho, fonte de dados publicada, conexão virtual, tabela de conexão virtual ou fluxo. (Na imagem acima, a âncora é a fonte de dados "Pedidos (superloja)" e, na imagem abaixo, a âncora é a tabela "Batters".) Todos os ativos abaixo da âncora dependem dela, direta ou indiretamente, e são chamados de saídas ou ativos de downstream. Os ativos acima da âncora são dos quais a âncora é direta ou indiretamente dependente e são chamados de entradas ou ativos de upstream.

![O painel de linhagem aparece no lado direito de uma página de tabela ou banco de dados](/tableau/current/pt-br/server/pt-br/Img/dm_lineage_example.png)

A partir do Tableau Cloud de junho de 2023 e Tableau Server 2023.3, as páginas de linhagem para fontes de dados incluem pesquisa e filtragem (no canto superior direito da lista de campos) que permitem localizar rapidamente campos de interesse ou relevância.

Quando você seleciona um campo em uma fonte de dados ou uma coluna em uma tabela, a linhagem é filtrada para mostrar apenas ativos de downstream que dependem do campo (ou coluna) ou entradas de upstream para o campo (ou coluna) como nesta exemplo de tabela “Batters” que mostra a linhagem filtrada para a coluna “Jogos”:

![A linhagem é filtrada para mostrar a contagem de ativos que incluem o campo ou coluna selecionada](/tableau/current/pt-br/server/pt-br/Img/dm_lineage_filter.png)

Você pode selecionar um ativo upstream ou downstream no painel Linhagem para visualizar seus detalhes. Por exemplo, quando você seleciona Fontes de Dados, a lista de fontes de dados que dependem desta tabela aparece à esquerda do painel Linhagem.

No painel Linhagem, você pode navegar até qualquer ativo relacionado à sua escolha inicial, neste caso a tabela, seguindo os links de seu interesse.

### Ativo incorporado aparece em Ativos externos

O Catálogo de Tableau tratará um ativo externo como “inserido” se a caixa de seleção Incluir arquivos externos for selecionada quando uma fonte de dados ou pasta de trabalho for publicada. Quando um ativo externo (banco de dados, tabela ou arquivo) é incorporado ao conteúdo publicado do Tableau (pastas de trabalho, fontes de dados e fluxos), o ativo externo é usado pelo conteúdo, mas não é compartilhável com outros usuários. Esse ativo externo incorporado aparece no upstream da linhagem do conteúdo do Tableau e está listado nos Ativos externos.

Para ver se um ativo externo está incorporado, acesse a página de detalhes do ativo e veja se "Ativo inserido" está listado na Categoria.

![‘Ativo inserido' aparece sob o rótulo de categoria](/tableau/current/pt-br/server/pt-br/Img/dm_embedded_asset.png)

Para obter informações sobre dados incorporados, consulte [Publicar dados separadamente ou incorporados nas pastas de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/publish_datasources_about.htm#publishing-data-separately-or-embedded-in-workbooks) na Ajuda do Tableau Desktop da Criação na Web.

### Conexões de linhagem e SQL personalizado

Quando você visualiza a linhagem de uma conexão que usa SQL personalizado, lembre-se do seguinte.

- A linhagem pode não estar completa.
- O catálogo não é compatível com a exibição de informações de coluna para tabelas que ele só conhece por meio de SQL personalizado.
- Os cartões de detalhes de campo podem não conter links para colunas conectadas ou podem não mostrar nenhuma coluna conectada.
- Os cartões de detalhes da coluna podem não conter links para campos que usam a coluna ou podem não mostrar nenhum campo.

Para obter mais informações, consulte [Suporte ao Tableau Catalog para SQL personalizado](https://help.tableau.com/current/pro/desktop/pt-br/customsql.htm#tableau-catalog-support-for-custom-sql) no Tableau Desktop e na Web Authoring Help.

### Catálogo não compatível com cubos

Fontes de dados de cubo (também conhecidas como fontes de dados multidimensionais ou OLAP) não são compatíveis com o Tableau Catalog. O conteúdo do Tableau (como uma fonte de dados, exibição ou pasta de trabalho) que depende de dados de cubo não exibe nenhum metadado de cubo ou linhagem de cubo no Catalog.

## Incompatibilidade entre contagem de linhagens e guias

Você pode notar uma incompatibilidade na contagem de ativos entre a ferramenta Linhagem do Tableau Catalog e as guias no Tableau Server ou Tableau Cloud.

A incompatibilidade de contagem é explicada pelo fato de cada uma (contagem de linhagem x contagem de guias) conta os ativos de uma maneira diferente. Por exemplo, em um determinado momento, o Catalog pode contar apenas os ativos que são indexados, enquanto o Tableau Server ou o Tableau Cloud conta todos os ativos publicados. Outras razões para as diferenças de contagem incluem se:

- Você tem permissões de "Exibir" para o ativo.
- Um ativo está oculto.
- Todos os campos são usados em uma pasta de trabalho.
- Um ativo está direta ou indiretamente conectado.
- Um ativo está em um Espaço pessoal.

### Exemplo de incompatibilidade de contagem de pastas de trabalho

Por exemplo, veja como a contagem de guias x a contagem de linhagem é determinada para pastas de trabalho.

![A contagem de guias das Pastas de trabalho conectadas é 239, a contagem das Pastas de trabalho na Linhagem é 230](/tableau/current/pt-br/server/pt-br/Img/dm_count_mismatch.png)

A guia Pastas de trabalho conectadas conta as pastas de trabalho que atendem aos dois critérios:

- Conecta-se à fonte de dados (independentemente de os campos serem ou não realmente usados na pasta de trabalho).
- O usuário tem permissões para exibir (seja uma planilha, um painel ou uma história).

A Linhagem do Tableau Catalog conta as pastas de trabalho que atendem a todos estes critérios:

- Foi indexado pelo Tableau Catalog.
- Conecta à fonte de dados e utiliza pelo menos um campo na fonte de dados.
- Contém planilhas, incluindo painéis ou histórias que contêm uma planilha, que usa pelo menos um campo na fonte de dados.

Quando os metadados são bloqueados devido a permissões limitadas, ou quando o ativo está em um Espaço pessoal, o Catalog ainda faz a contagem da pasta de trabalho. Mas, em vez de ver alguns dos metadados confidenciais, você verá Permissões necessárias. Para obter mais informações, consulte [Informações de linhagem de acesso](https://help.tableau.com/current/server/pt-br/dm_perms_assets.htm#lineage).

## Usar e-mail para entrar em contato com proprietários

No final da linhagem, há Proprietários. A lista de proprietários inclui qualquer pessoa designada como proprietária ou contato para qualquer conteúdo downstream da âncora de linhagem.

Você pode enviar e-mail aos proprietários para informá-los sobre alterações nos dados. (Para os proprietários de e-mail, você deve ter o recurso 'Sobrescrever' \[Salvar\] no conteúdo da âncora de linhagem.)

1. Selecione Proprietários para visualizar a lista de pessoas afetadas pelos dados nesta linhagem.
2. Selecione os proprietários aos quais deseja enviar mensagem.
3. Clique em Enviar e-mail para abrir a caixa de mensagem de e-mail.
4. Insira o Assunto e sua mensagem na caixa de texto e clique em Enviar.

<!-- document id=c32e221fcd06a927d5498f095f5481799753d4e6ef6524c537eb79884545e884 url=/tableau/current/pt-br/server/saml_with_kerberos.md -->

[Pular para o conteúdo principal](#main-content)

# Usar o SSO do SAML com a delegação do banco de dados do Kerberos

Em um ambiente do Active Directory (AD) do Windows, é possível habilitar o logon único (SSO) do SAML para o Tableau Server, junto com a delegação de banco de dados do Kerberos. Isso fornece acesso direto dos usuários autorizados ao Tableau Server e aos dados subjacentes definidos nas pastas de trabalho e fontes de dados publicadas.

## Visão geral do processo

![Imagem conceitual de autenticação para Tableau Server via SAML e acesso a dados subjacentes via Kerberos](/tableau/current/pt-br/server/pt-br/Img/saml-auth-kerb-db-delegation.png "Imagem conceitual do SAML trabalhando com o Kerberos")

Em um cenário típico:

1. Um de seus analistas do Tableau publica um painel no Tableau Server. O painel contém uma conexão a um cluster Hadoop, por exemplo, que está configurado a aceitar as credenciais do Kerberos.
    
    Em seguida, o publicador da pasta de trabalho envia um link para que colegas revisem.
2. Quando um colega clica no link, o Tableau Server autentica o usuário por meio do processo SAML SSO. Depois olha para o esquema de autorização do usuário e, se permitido, usa o keytab do Tableau Server para acessar o banco de dados subjacente em nome do usuário. Isso preenche o painel com os dados do Hadoop que o usuário está autorizado a ver.

## Configurar o Tableau Server para SAML com Kerberos

Usar o SAML com Kerberos funciona inerentemente ao concluir os processos para habilitar cada um separadamente:

1. Configure o Tableau Server para SAML, conforme descrito em [Configurar SAML em todo o servidor](https://help.tableau.com/current/server/pt-br/config_saml.htm).
2. Configure o Tableau Server e seus bancos de dados subjacentes para aceitarem as credenciais do Kerberos, conforme descrito em [Habilitar a Delegação do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm) e artigos relacionados.

<!-- document id=7479e5726bb4b4faf1ad5903bb82aec8797b4bc2eb8a3bf7b6f60c40147c0e5f url=/tableau/current/pt-br/server/projects.md -->

[Pular para o conteúdo principal](#main-content)

# Usar projetos para gerenciar o acesso ao conteúdo

Quando os usuários do Tableau Desktop publicam um conteúdo em um site no Tableau Server, eles podem selecionar um _projeto_ para publicá-lo.

Os projetos podem ser usados para navegação, organização e gerenciamento de acesso a ativos como pastas de trabalho, fontes de dados, ampliação e projetos aninhados. A partir do Tableau Cloud de outubro de 2022/Server 2022.3, se o Data Management estiver licenciado e o Catálogo estiver habilitado, um projeto também poderá conter ativos externos, como bancos de dados.

A imagem a seguir mostra o conteúdo no projeto de nível superior Operações, no ambiente de criação na Web. O projeto Operações contem alguns projetos aninhados (realçados) e pastas de trabalho publicadas. Um projeto também pode conter outros tipos de ativos.

![](/tableau/current/pt-br/server/pt-br/Img/project_and_content.png)

## Por que usar projetos

Os projetos auxiliam na criação de um processo escalonável para gerenciar o acesso ao conteúdo publicado em Tableau Server. As vantagens incluem:

- Eles permitem que os administradores deleguem gerenciamento de conteúdo para líderes de projeto que trabalham com o conteúdo, sem que precisar conceder acesso de administrador às configurações do site ou servidor.
    - Os líderes de projeto podem criar projetos aninhados no projeto de alto nível e manter o conteúdo de sua equipe em uma hierarquia simples.
    - **Observação:** os proprietários de projeto podem excluir os projetos de nível superior que possuem. Os líderes de projeto não podem excluir projetos de nível superior.
- Também podem facilitar a navegação do site para usuários de autoatendimento.
    - Os projetos segmentam o site do Tableau Server em áreas que oferecem aos usuários acesso com base na forma como usam os dados publicados para essas áreas ou no grupo de usuários do Tableau com o qual trabalham.
    - É possível ocultar projetos dos grupos que não precisam usá-los, criar um esquema de nomeação de projeto identificável e aproveitar as descrições dos projetos para esclarecer como usá-lo.
- Eles permitem o controle das permissões de modo eficaz.
    - Crie grupos baseado no nível de acesso de conteúdo que os usuários no grupo precisam e defina permissões padrão nos projetos. Isso permite saber exatamente quais capacidades os novos usuários obtêm por padrão, assim como quais capacidades todos os usuários obtêm quando um novo projeto é criado.

### Quando criar hierarquias de projeto (exemplo)

Muitas empresas têm diversos grupos distintos de usuários do Tableau, cada um com suas prioridades e líderes. Esses grupos podem compartilhar conteúdo da empresa inteira (ou até mesmo usar um pool de fontes de dados da empresa), mas eles usam os dados e relatórios primariamente da equipe específica. Neste caso ou em semelhantes, um exemplo de uso das hierarquias do projeto pode ser o seguinte:

1. Você, como administrador do site ou servidor, pode criar projetos de nível superior para cada equipe distinta do Tableau.
2. Em cada projeto de nível superior, você atribui o status de Líder do projeto aos responsáveis na equipe e altera o proprietário do projeto. Os líderes de projeto são os administradores de conteúdo, portanto, é importante que entendam como as permissões funcionam no Tableau, assim como as práticas recomendadas de gerenciamento de conteúdo do Tableau.
3. Cada líder de projeto pode gerenciar seu projeto, criando a estrutura nele que funciona para a equipe. Isto é, eles podem criar projetos secundários necessários com base na forma como os membros da equipe colaboram e compartilham dados e relatórios.

Como administrador de site, o benefício é se concentrar na integridade do sistema. O benefício para os usuários do Tableau é que as pessoas que conhecem as práticas recomendadas de trabalho com o Tableau e os dados podem gerenciar isso para suas equipes sem precisar enviar solicitações ao setor de TI para alterar permissões ou adicionar projetos.

### Use a árvore de projetos para navegar pelos projetos

Por padrão, o painel Explorar exibe uma árvore de projetos para ajudar você a navegar facilmente pelos seus projetos. Você pode usar a árvore de projetos para encontrar subprojetos dentro de uma pasta de projeto. Você também pode usar a árvore de projetos para procurar projetos.  

![A árvore do projeto no painel Explorar no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Cloud_ProjectTree.png)  

Você pode ocultar e exibir a árvore do projeto clicando no ícone dela localizado no painel Explorar.  
  
![O ícone da árvore do projeto no painel Explorar no Tableau Cloud.](/tableau/current/pt-br/server/pt-br/Img/Cloud_ProjectTreeIcon.png)  

> [!TIP]
> 
> **Observação**: para garantir que a árvore do projeto esteja visível, mantenha uma largura de janela do navegador de pelo menos 1441px na página Explorar. Uma janela mais estreita (1440px ou menos) ou uma tela de resolução mais baixa ocultará a árvore do projeto.  

### Por que não usar sites?

Os sites funcionam adequadamente quando o conteúdo pode ficar completamente separado durante todas as fases, e há pouca ou nenhuma sobreposição de usuários. Um exemplo bom (e comum) do uso de vários sites é criar um site para cada um de vários clientes externos, cujo conteúdo publicado você gerencia como consultor ou fornecedor.

Os projetos permitem a flexibilidade necessária para administrar dados e relatórios compartilhados, assim como usuários que possam pertencer a vários grupos. Os projetos funcionam melhor do que sites para a evolução do conteúdo, desde o desenvolvimento, montagem até a produção.

## Administração no nível do projeto

Para obter mais informações sobre como administrar projetos, consulte [Gerenciar permissões com projetos](https://help.tableau.com/current/server/pt-br/permissions_projects.htm).

## Outros artigos nesta seção

<!-- document id=556587c1e02feb33634863b7b8af031ad0969212645aadcceb6c56a64ef63b0b url=/tableau/current/pt-br/server/datasource_multitable_normalized.md -->

[Pular para o conteúdo principal](#main-content)

# Usar relações para análise de dados de várias tabelas

As tabelas que você arrasta para a tela da guia da fonte de dados usam relacionamentos. Os relacionamentos são uma maneira flexível de combinar dados para análise no Tableau.

Pense em uma relação como um contrato entre duas tabelas. Quando você está criando uma visualização com campos dessas tabelas, o Tableau traz dados usando esse contrato para criar uma consulta com as uniões de colunas apropriadas.

Recomenda-se o uso de relacionamentos como uma primeira abordagem para combinar os dados, pois isso torna a preparação e a análise de dados mais fáceis e intuitivas. [Usar as uniões somente quando você realmente precisar](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel_faq.htm#can-i-use-joins-between-logical-tables). Saiba mais sobre as noções básicas da criação de relacionamentos neste vídeo de 5 minutos.

**Observação**: a interface para edição de relacionamentos mostrada neste vídeo difere um pouco da versão atual, mas tem a mesma funcionalidade.

Saiba mais sobre como as relações funcionam nessas publicações no blog do Tableau:

- [Relacionamentos, parte 1: apresentação da nova modelagem de dados no Tableau](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)
- [Relacionamentos, parte 2: dicas e truques](https://www.tableau.com/about/blog/2020/5/relationships-part-2-tips-and-tricks)
- [Relacionamentos, parte 3: fazer perguntas em várias tabelas relacionadas](https://www.tableau.com/about/blog/2020/6/relationships-part-3-asking-questions-across-multiple-related-tables)

Veja também podcasts de vídeo sobre relacionamentos em [Análises de ação](https://action-analytics.com/library/), como [Por que o Tableau inventou os relacionamentos?](https://action-analytics.com/ep-1-why-did-tableau-invent-relationships/) Clique em "Podcast de vídeo" na [Biblioteca](https://action-analytics.com/library/) para ver mais.

No Tableau versão 2024.2 e posterior, o modelo de dados do Tableau oferece suporte à análise de vários fatos e às dimensões compartilhadas por meio de relações multifatoriais. Para obter mais informações, veja [Sobre modelos de dados de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_multiple_base_tables.htm), [Quando usar um modelo de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_when_to_use.htm), e [Construa um modelo de dados de relação de vários fatos](https://help.tableau.com/current/pro/desktop/pt-br/datasource_mfr_build.htm).

Você está criando uma nova fonte de dados e uma pasta de trabalho?

Arraste uma tabela para a tela da página Fonte de dados para começar a criar a fonte de dados.

Uma fonte de dados pode ser criada a partir de uma única tabela que contenha todos campos de dimensão e medida necessários para análise...

![Modelo de dados com uma análise de tabela única.](/tableau/current/pt-br/server/pt-br/Img/data_model_singletableanalysis.gif)

Ou crie uma fonte de dados de várias tabelas arrastando mais tabelas e definindo os relacionamentos...

![Crie um relacionamento de dados no painel de fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/data_model_createrelationship.gif)

Assista a este vídeo de 1 minuto sobre como começar a usar relacionamentos.

**Observação**: a interface para edição de relacionamentos mostrada neste vídeo difere um pouco da versão atual, mas tem a mesma funcionalidade.

Para obter mais informações sobre o uso de relacionamentos, consulte [Relacionar os dados](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm), [Como as relações diferem das uniões de colunas](https://help.tableau.com/current/server/pt-br/datasource_relationships_learnmorepage.htm), [O modelo de dados do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel.htm) e [Criar e definir relacionamentos](https://help.tableau.com/current/pro/desktop/pt-br/relate_tables.htm#create-and-define-relationships).

Para obter mais informações, consulte [O que mudou nas fontes de dados e análises na versão](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel_whatschanged.htm) e [Perguntas sobre relacionamentos, o modelo de dados e fontes de dados](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel_faq.htm).

Você está abrindo uma pasta de trabalho ou fonte de dados antiga?

Ao abrir uma pasta de trabalho ou fonte de dados anterior à versão 2020.2 na versão 2020.2, a fonte de dados aparecerá como uma única tabela lógica na tela, com o nome "Dados migrados" ou o nome da tabela original. Os dados são mantidos e você pode continuar a usar a pasta de trabalho como anteriormente.

![Caso a fonte de dados tivesse várias tabelas unidas por colunas ou linhas, a tabela lógica única seria exibida com o nome "Dados migrados".](/tableau/current/pt-br/server/pt-br/Img/data_model_migrated_data.gif)

Para ver as tabelas físicas que compõem a tabela lógica única, clique duas vezes na tabela lógica para abri-la na camada física. Você verá suas tabelas físicas subjacentes, incluindo uniões de colunas e de linhas.

Para obter mais informações, consulte [O que mudou nas fontes de dados e análises na versão](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel_whatschanged.htm) e [Perguntas sobre relacionamentos, o modelo de dados e fontes de dados](https://help.tableau.com/current/pro/desktop/pt-br/datasource_datamodel_faq.htm).

## Outros artigos nesta seção

<!-- document id=9977a65756d9871df06550b47827cf2669b1be8e9c8e11584c920d63e5f68837 url=/tableau/current/pt-br/server/data_stories_table_calculation.md -->

[Pular para o conteúdo principal](#main-content)

# Usar um cálculo de tabela em uma história com dados do Tableau

**Mudanças importantes para Histórias de dados do Tableau**

As Histórias de dados do Tableau serão descontinuadas em Tableau Desktop, Tableau Cloud e Tableau Server em janeiro de 2025 (2025.1). Com os avanços nas tecnologias de linguagem natural, estamos desenvolvendo uma interface aprimorada que tornará mais fácil fazer perguntas sobre seus dados e ficar por dentro das mudanças. Para obter mais informações, veja [Como o Tableau Pulse com tecnologia Tableau AI está reimaginando a experiência de dados](https://www.tableau.com/pt-br/blog/tableau-pulse-and-tableau-ai)

Você pode usar um Cálculo de tabela como uma medida em uma História com dados do Tableau, além da medida usada para criar o cálculo de tabela.

1. No cartão Marcas, clique no lado direito do seu campo para abrir um menu e clique em Cálculo rápido de tabela.  
      
    ![O menu que é aberto quando você clica com o botão direito do mouse em um campo no cartão Marcas. Cálculo de tabela rápido é selecionado.](/tableau/current/pt-br/server/pt-br/Img/data_stories_quick_tablecalc.png)

1. Depois de criar seu cálculo de tabela, arraste-o para Medidas no painel Dados e renomeie-o.  
      
    ![Uma animação de arrastar o cálculo da divisória para o painel Dados.](/tableau/current/pt-br/server/pt-br/Img/data_stories_tablecalc_1.gif)

1. Arraste sua medida original (por exemplo, Vendas) de volta para a divisória Linhas e arraste seu novo cálculo (por exemplo, Soma de vendas) para a Dica de ferramenta. Sua visualização pode permanecer a mesma, mas agora você tem acesso à nova medida.  
      
    ![Uma animação de arrastar a medida para a divisória.](/tableau/current/pt-br/server/pt-br/Img/data_stories_tablecalc_2.gif)

1. Vá para o seu painel e arraste o objeto História com dados para o painel. Ambas as medidas aparecem ao criar sua história.

<!-- document id=504f845dcff58ebfef3944fe0442ec572794188bad6068484734fbd87f51cd14 url=/tableau/current/pt-br/server/dynamic_zone_visibility.md -->

[Pular para o conteúdo principal](#main-content)

# Usar visibilidade de zona dinâmica

O espaço do painel é valioso, especialmente quando você deseja revelar progressivamente insights sobre dados. Com a visibilidade de zona dinâmica, você pode ocultar ou revelar zonas (elementos de painel lado a lado ou flutuantes) com base no valor de um campo ou parâmetro. Conforme você interage, as zonas em seu painel aparecem ou desaparecem. O resultado é um painel dinâmico que não compromete o layout desejado.

Embora você possa [mostrar ou ocultar objetos clicando em um botão em um painel](https://help.tableau.com/current/pro/desktop/pt-br/dashboards_create.htm#Show), a visibilidade da zona dinâmica permite mostrar e ocultar objetos automaticamente. Isso é ideal para painéis usados​por diferentes grupos de usuários. Por exemplo, você pode querer mostrar diferentes zonas de grupos de usuários diferentes quando eles visitam seu painel.

E você pode usar a visibilidade de zona dinâmica com [Ações de parâmetros](https://help.tableau.com/current/pro/desktop/pt-br/actions_parameters.htm). Por exemplo, quando um usuário clica em uma marca em uma visualização, uma zona anteriormente oculta é exibida. Isso é ideal para painéis complexos porque permite que você escolha quando níveis mais profundos de dados são revelados.

## Tipos de campos compatíveis

Para ser usado para visibilidade de zona dinâmica, um campo ou parâmetro deve ser:

- Booleano.
- Valor único.
- Independente da visualização, o que significa que o campo retorna um valor constante independente da estrutura da visualização, como um cálculo de nível de detalhe fixo (LOD).

## Configurar uma zona de painel dinâmico

O exemplo a seguir tem duas planilhas que usam [dados Superstore](https://help.tableau.com/current/guides/get-started-tutorial/pt-br/get-started-tutorial-connect.htm): a primeira planilha tem um gráfico de barras com Vendas por categoria e a segunda planilha tem um gráfico de barras com Vendas por subcategoria. Ao usar a visibilidade da zona dinâmica, a segunda planilha fica visível somente depois que uma marca é clicada na zona Vendas por categoria. Este exemplo se baseia em um campo calculado booleano, que é usado como campo de origem para uma ação de parâmetro. Para que o cálculo seja utilizado como campo de origem para a ação do parâmetro, o cálculo deve ser adicionado ao cartão de marcas.

1. Na planilha Vendas por categoria, [criar um parâmetro](https://help.tableau.com/current/pro/desktop/pt-br/parameters_create.htm). Neste exemplo, o parâmetro Tipo de dados deve ser definido como Booleano.
2. Na planilha Vendas por categoria, [crie um campo calculado](https://help.tableau.com/current/pro/desktop/pt-br/calculations_calculatedfields_formulas.htm). Este exemplo usa o seguinte cálculo: `True`
3. Na planilha Vendas por categoria, arraste o cálculo que você criou para Detalhes no cartão de marcas.
4. Crie um painel.
5. Arraste a planilha que você sempre deseja que fique visível em seu painel. Em nosso exemplo, queremos que Vendas por categoria seja visível.
6. No painel, clique na zona Vendas por categoria (objeto do painel). Em seguida, no menu Planilha em seu painel, [crie uma ação de parâmetro](https://help.tableau.com/current/pro/desktop/pt-br/actions_parameters.htm). Este exemplo usa a seguinte ação Alterar parâmetro:  
    A planilha de origem é definida para usar o painel que você criou e a planilha Vendas de categoria.  
    O Parâmetro de destino é o parâmetro que você criou.  
    O Campo de origem é o cálculo que você criou.  
    ![Uma ação de parâmetro configurada conforme descrito no texto que precede esta imagem](/tableau/current/pt-br/server/pt-br/Img/dynamic_zone_action.png)
7. Arraste a planilha Vendas por subcategoria para o seu painel.
8. Clique na zona Vendas por categoria. No canto superior direito, clique na seta suspensa e selecione Usar como filtro.
9. Clique na zona Vendas por subcategoria e, em seguida, clique na guia Layout.
10. Marque a caixa Controlar visibilidade usando valor.
11. Na lista suspensa, escolha o parâmetro que você criou para controlar a visibilidade da zona.

**Observação:** se a opção Controlar visibilidade usando valor não contiver o campo que você deseja usar, certifique-se de que o campo seja um tipo compatível.

![A caixa "Controlar visibilidade usando valor" é marcada e um parâmetro chamado "Ocultar zona com parâmetro" é selecionado](/tableau/current/pt-br/server/pt-br/Img/dynamic_zone_visibility.png)

Agora, quando você clica em uma marca de categoria na zona Vendas por categoria, a zona Vendas por subcategoria aparece no painel.

![Uma animação de clicar em uma marca em um painel que faz com que outro gráfico apareça usando a visibilidade da zona dinâmica](/tableau/current/pt-br/server/pt-br/Img/dynamic_zone_demo.gif)

## Entender as limitações e os casos extremos

A visibilidade de zona dinâmica não funciona ao usar a planilha em [Histórias](https://help.tableau.com/current/pro/desktop/pt-br/stories.htm) (uma sequência de visualizações que funcionam juntas para transmitir informações).

<!-- document id=b7601c7c86332984f233aa1553a46ea540bd2c802ca27b84b8be5ed21fa518c5 url=/tableau/current/pt-br/server/dynamic_axis_titles.md -->

[Pular para o conteúdo principal](#main-content)

# Use títulos de eixo dinâmico

A flexibilidade do Tableau permite que os autores analisem rapidamente diferentes conjuntos de dados e visualizem os dados de maneira diferente para uma análise mais profunda. Porém, com essa flexibilidade, vem a responsabilidade de comunicar com precisão os dados usados em uma visualização. Por exemplo, é fundamental comunicar as unidades de medida que mudam com base em um valor de parâmetro. Imagine que você está olhando para uma visualização do tempo que mostra uma previsão de 25 graus. Em Fahrenheit, essa previsão pode ser uma ótima viagem de esqui. Mas em Celsius, essa previsão pode ser uma viagem à praia.

Como autor, você pode usar Títulos de eixo dinâmico para atualizar o título do eixo com base no valor de um parâmetro ou um campo de valor único (por exemplo, um cálculo LOD). Se você usar [parâmetros de troca](https://help.tableau.com/current/pro/desktop/pt-br/parameters_swap.htm), os títulos dos eixos são atualizados para corresponder aos dados que estão sendo usados.

## Tipos de campos compatíveis

Para ser usado como um Título de Eixo Dinâmico, os campos devem ser:

- Um valor único e um [cálculo LOD fixo](https://help.tableau.com/current/pro/desktop/pt-br/calculations_calculatedfields_lod_fixed.htm)
- Um parâmetro
- Um campo constante calculado
- Um conjunto superior 1

## Configurar um título de eixo dinâmico

1. Em uma planilha do Tableau, arraste um campo contínuo para uma divisória.
2. Clicar duas vezes no eixo para abrir a de diálogo Editar eixo.
3. Debaixo da seção Títulos do eixo, escolha o campo que deseja usar para o título do eixo na lista.
4. Feche a caixa de diálogo Editar eixo.

Para um caso de uso mais complexo, primeiro siga as etapas em [Exemplo: trocar medidas usando parâmetros](https://help.tableau.com/current/pro/desktop/pt-br/parameters_swap.htm). Em seguira, siga estas etapas:

1. Clique duas vezes eixo X para abrir a caixa de diálogo Editar eixo.
2. Sob a seção Títulos do eixo, selecione Parâmetro e, em seguida, escolha o seletor de espaço o reservado 2.
3. Feche a caixa de diálogo Editar eixo.
4. Repita essas etapas para o eixo Y usando o espaço reservado 1.

Agora, quando os parâmetros são alterados, os títulos dos eixos são atualizados para refletir os dados exibidos.

## Entender as limitações e os casos extremos

Os títulos do eixo dinâmico são apagados quando o tipo de visualização é alterado usando Mostre-me. Além disso, se você usar legendas, elas aparecerão após o Título do eixo dinâmico, assim como acontece com os títulos personalizados. As legendas automáticas são preenchidas apenas quando você tem um eixo de valor de data contínuo que é filtrado para um único ano com pelo menos dois períodos de tempo. A funcionalidade do título do eixo dinâmico não funciona ao usar a planilha em [Histórias](https://help.tableau.com/current/pro/desktop/pt-br/stories.htm) (uma sequência de visualizações que funcionam juntas para transmitir informações).

<!-- document id=2f8355e2cafc569f0c17b6449668115e26d00a9b1660e4bab6ded113b8335174 url=/tableau/current/pt-br/server/dm_vconn_use.md -->

[Pular para o conteúdo principal](#main-content)

# Use uma conexão virtual

Depois que uma conexão virtual é publicada e as permissões são definidas, ela fica disponível para os usuários se conectarem aos dados da mesma forma que os usuários acessam todos os dados no Tableau. Quando você tiver que editar uma conexão virtual ou a política de dados na conexão – por exemplo, quando o esquema subjacente muda – simplesmente abra a conexão no editor de conexão virtual, faça suas alterações e salve ou publique as atualizações. Você também pode substituir uma fonte de dados existente em uma pasta de trabalho por uma conexão virtual.

## Conecte-se a uma conexão virtual

Para criação na Web no Tableau Cloud ou Tableau Server:

1. Na página Início ou Explorar, clique em Novo.
2. Selecione o tipo de conteúdo que deseja criar: pasta de trabalho, fluxo ou fonte de dados publicada.
3. No menu suspenso Conectar-se aos dados> Neste site > Tipo de conteúdo, selecione Conexões virtuais.
4. Selecione o nome da conexão e clique em Conectar.

Para o Tableau Desktop e o Tableau Prep:

1. No painel Conectar, em Pesquisar dados, clique em Tableau Server.
2. Insira o nome do servidor e clique em Conectar ou em Tableau Cloud.
3. Insira as informações solicitadas.
4. Na caixa de diálogo Pesquisar dados, na lista suspensa Tipo de conteúdo, selecione Conexões virtuais.
5. Selecione o nome da conexão e clique em Conectar.

**Observação:** não há necessidade de inserir credenciais ao se conectar usando uma conexão virtual. As credenciais para acessar os dados são inseridas à conexão.

## Editar uma conexão virtual ou política de dados

Ao editar uma conexão virtual publicada, ela permanece disponível para os usuários em seu estado publicado atual. Para obter mais informações, consulte [Publicar uma conexão virtual e definir permissões](https://help.tableau.com/current/server/pt-br/dm_vconn_publish_save.htm) .

Para editar uma conexão, navegue até ela na página Explorar. Observe que, embora as credenciais do banco de dados estejam inseridas à conexão, apenas aqueles com as credenciais do banco de dados podem fazer alterações em uma conexão virtual.

1. No menu suspenso, selecione Todas as conexões virtuais e, a seguir, selecione a conexão que deseja editar.
2. Clique em Editar conexão virtual.
3. Insira as informações solicitadas para se conectar. Para editar uma conexão, você deve inserir as credenciais necessárias para acessar os dados.
4. Clique em Fazer logon.
5. No editor de conexão virtual, faça suas alterações e salve um rascunho ou publique a conexão.

### Responda a alterações de esquema subjacentes

Quando o esquema subjacente em uma conexão virtual é alterado — por exemplo, uma tabela é adicionada ou excluída, ou uma coluna é adicionada ou renomeada — você tem que editar a conexão virtual para refletir as alterações do esquema e, em seguida, republicar a conexão. (Se a conexão tiver extrações, lembre-se de atualizar as extrações.) Dessa forma, você pode adicionar ou editar as tabelas, colunas e políticas na conexão antes que novos dados sejam expostos a todos.

## Trabalhar com histórico de revisão de conexão virtual

Quando você publica uma conexão virtual, uma versão é salva no histórico de revisões do Tableau Cloud ou Tableau Server. É possível reverter para uma versão anterior a qualquer momento.

Para acessar o histórico de revisões, você deve ter uma função no site Creator e as permissões Exibir e Sobrescrever.

Para ver o histórico de revisão da conexão virtual, clique no menu de ações (. . .) para a conexão virtual e clique em Histórico de revisões.

![O menu de ações com Histórico de revisões realçado](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_rev_hist_menu.png)

### Restaurar ou excluir uma revisão de conexão virtual

Para restaurar uma revisão de conexão virtual, selecione uma revisão e clique em Abrir. Você será solicitado a descartar a versão existente da conexão. Quando você clica em Descartar e continuar, a revisão selecionada se torna a versão atual da conexão.

![A caixa de diálogo “Abrir revisão” com “Descartar e continuar” destacado.](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_rev_hist_replace.png)

Para excluir uma revisão, no menu de ações da revisão (. . .), clique em Excluir.

![O menu de ações de uma revisão com "Excluir…" realçado.](/tableau/current/pt-br/server/pt-br/Img/dm_vconn_rev_hist_del.png)

## Substituir uma fonte de dados existente em uma pasta de trabalho por uma conexão virtual

Para criação na Web no Tableau Cloud ou Tableau Server:

1. Download da pasta de trabalho. Para obter mais informações, consulte [Baixar exibições e pastas de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/export.htm) na Ajuda do Tableau Desktop.
2. No Tableau Desktop, abra a pasta de trabalho e substitua sua fonte de dados existente por uma conexão virtual. Para obter mais informações consulte [Substituir fontes de dados](https://help.tableau.com/current/pro/desktop/pt-br/connect_basic_replace.htm) na Ajuda do Tableau Desktop.
3. No Tableau Desktop, carregue a pasta de trabalho em seu Tableau Cloud ou site do Tableau Server. Para obter mais informações, consulte [Carregar pastas de trabalho em um site do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/upload.htm) na Ajuda do Tableau Desktop.
4. No Tableau Cloud ou Tableau Server, clique em Publicar para salvar suas alterações no servidor.

Para o Tableau Desktop:

1. Abra a pasta de trabalho e substitua sua fonte de dados existente por uma conexão virtual. Para obter mais informações consulte [Substituir fontes de dados](https://help.tableau.com/current/pro/desktop/pt-br/connect_basic_replace.htm) na Ajuda do Tableau Desktop.
2. Republique a pasta de trabalho. Para obter mais informações, consulte [Etapas simples para publicar uma pasta de trabalho](https://help.tableau.com/current/pro/desktop/pt-br/publish_workbooks_share.htm) na Ajuda do Tableau Desktop.

## Quem pode fazer isso

Para usar uma conexão virtual, você deve ser um Administrador de Servidor, Creator (Administrador de site), ou Creator.

Para editar uma conexão virtual ou política de dados, você deve

- ter credenciais para o banco de dados ao qual a conexão virtual se conecta e
- ser um servidor ou administrador de site ou um Creator.

Para migrar o conteúdo existente para usar uma conexão virtual, você deve

- ser um servidor ou administrador de site ou
- ser um Creator que também é o proprietário da fonte de dados.

<!-- document id=59e96a0bb89b2fa973f04c966ef25c14821d1f97326409f61ce74d477886a7ae url=/tableau/current/pt-br/server/adminview_desktop_license_usage.md -->

[Pular para o conteúdo principal](#main-content)

# Uso da licença do Desktop

**Observação:** esta exibição só está disponível para administradores de servidor. Para acessar exibições de servidor em implantações de vários sites, clique no menu do site e selecione **Gerenciar todos os sites**. Para obter informações sobre como navegar em exibições administrativas, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

A exibição Uso da licença do Desktop permite que administradores do servidor visualizem os dados de uso das licenças do Tableau Desktop na sua organização. Isso pode ajudá-lo a gerenciar licenças com eficiência e determinar se há necessidade de mais ou menos licenças. Essa exibição pode ajudá-lo a responder às seguintes perguntas:

- Quem está usando uma licença do Tableau Desktop na minha empresa?
- Alguma licença foi compartilhada ou transferida?
- Alguma licença está sendo usada em um computador em que não deveria?
- Um usuário específico utiliza a licença dele?
- Quais tipos de licenças são usados na minha empresa?

**Observação:** para obter dados sobre licenças, cada cópia do Tableau Desktop precisa ser configurada para enviar dados para Tableau Server. Essa configuração pode ser feita no momento da instalação, usando scripts ou software de terceiros para instalar e configurar o Tableau ou depois da instalação, com a modificação do arquivo de registro ou de lista de propriedades. Para obter mais informações, consulte [Configurar relatórios de licenciamento do Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_reporting_admin.htm).  
  
Para exibir os dados de licença de exibição, a opção Relatórios de licenciamento do Desktop deve estar habilitada no Tableau Server. Consulte [Habilitar e configurar relatórios de licenciamento do Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_reporting_admin.htm#enable).

Filtros

- **Chaves do produto**. Digite uma cadeia de caracteres para filtrar o painel de modo que apresente apenas as licenças que incluam a cadeia de caracteres em qualquer local da chave do produto. Por exemplo, para ver apenas as licenças que começam com TDTD, digite TDTD e pressione Retornar para filtrar a exibição. Clique no X depois da string para redefinir o filtro.
- **Ação**. Use este filtro para controlar o que o painel exibe, com base na ação realizada. As ações são **Ativar**, Usar, e Retornar (desativar). Se a ação Usar não estiver selecionada, nenhum item será exibido no gráfico de barras superior.
- **Departamento**. Use este filtro para controlar que de que departamentos o painel exibe as licenças. O filtro é preenchido com base nos valores de Departamento especificados quando o Tableau Desktop é registrado.
- **Selecionar duração em dias**. Use este controle deslizante para especificar o tempo, em dias, durante o qual o painel exibe informações. O valor padrão é 183 dias.

Quando você focaliza o cartão filtro nos primeiros três filtros, aparece um ícone suspenso. Clique no ícone para especificar se a exibição deve incluir dados que correspondam ao filtro (o padrão) ou excluir dados que correspondam ao filtro:

![Um menu suspenso com duas opções: Incluir valores e Excluir valores.](/tableau/current/pt-br/server/pt-br/Img/filter_include_exclude.png)

## **Quem usou o Tableau nos últimos <nn> dias?**

Esta área do painel mostra um gráfico de barras de tipos de licenças do Tableau Desktop (Perpétua e Com chave) e o número de usuários que utilizaram cada tipo de licença durante o tempo especificado. Passe o mouse sobre um segmento de tipo de licença para ver uma explicação sobre esse tipo de licença. Clique em um segmento para filtrar o restante do painel para esse tipo de licença. Essa ação filtra ambas as tabelas que mostram as licenças que foram usadas e as que não foram. Por exemplo, para ver uma lista de licenças de prazo que foram usadas durante o período, clique na barra Prazo. O usuário "usadas" e "não usadas" são filtradas para mostrar apenas licenças de prazo.

Uma tabela com informações detalhadas é mostrada sob o gráfico de barras. Em cada linha na tabela, os ícones de ação são exibidos à direita, acima de uma linha do tempo que mostra quando a ação aconteceu pela última vez.

Para ver uma lista dos dados subjacentes em um formato que permita a você selecionar e copiar valores, como e-mail ou chave do produto, clique em uma linha na lista de licenças e clique no ícone Exibir dados:

![O ícone Exibir dados.](/tableau/current/pt-br/server/pt-br/Img/view_data.png)

Os dados são exibidos no formato resumido. Clique em Dados completos para ver todos os dados. Nesta exibição, você pode selecionar e copiar valores individuais ou baixar os dados como um arquivo de texto.

## **Quais licenças não foram usadas nos últimos <nn> dias?**

Essa área do painel mostra uma lista de licenças que não foram usadas durante o período especificado. Uma linha do tempo mostra a última data de utilização. Passar o mouse sobre uma marca de último uso fornece informações a você, incluindo o usuário registrado da cópia do Tableau.

<!-- document id=f4f19d74caa2b8a5fc6561c132093595285212662bb3876535fe8c75cecb419d url=/tableau/current/pt-br/server/connected_apps.md -->

[Pular para o conteúdo principal](#main-content)

# Uso de aplicativos conectados do Tableau para integração de aplicativos

A partir do com o Tableau Server 2022.1, os aplicativos conectados ao Tableau permitem uma experiência de autenticação perfeita e segura, facilitando uma relação de confiança explícita entre seu site do Tableau Server e aplicativos externos nos quais o conteúdo do Tableau é inserido. , os aplicativos conectados ao Tableau estenderam seus recursos para dar suporte à autorização da API REST. E a partir de outubro de 2023, a autorização da API REST por usando de aplicativos conectados será respeitada pela API de metadados do Tableau. A partir de fevereiro de 2025, a autorização da API REST com aplicativos conectados será respeitada pelo VizQL Data Service do Tableau.

**Observação:** os aplicativos conectados ao Tableau e ao Salesforce são diferentes e oferecem funcionalidades diferentes. Atualmente, os aplicativos conectados ao Tableau são otimizados para incorporar exibições e métricas do Tableau em aplicativos externos e usados para autorizar o acesso à API REST do Tableau. (Em outubro de 2023, o Tableau descontinuou a capacidade de inserir métricas em Tableau Cloud e Tableau Server versão 2023.3.).

Há dois tipos de aplicativos conectados que você pode configurar: confiança direta ou confiança OAuth 2.0.

### Confiança direta

Usando _confiança direta_, você pode:

- Restringir o acesso a qual conteúdo pode ser inserido e onde esse conteúdo pode ser inserido
- Fornecer aos usuários a capacidade de acessar conteúdo inserido usando logon único (SSO) sem a necessidade de integração com um provedor de identidade (IdP)
- Fornecer aos usuários a capacidade de autenticar diretamente de seu aplicativo externo
- Autorizar programaticamente o acesso à API REST do Tableau e à API de metadados Tableau (a partir de Tableau Server outubro de 2023) em nome dos usuários usando JSON Web Token (JWT)
- Autorizar programaticamente o acesso à API REST do Tableau e ao VizQL Data Service do Tableau (a partir de Tableau Server fevereiro de 2025) em nome dos usuários usando JSON Web Token (JWT)
- Escopo de recursos da API REST do Tableau que os usuários ou aplicativos podem executar
- Habilite recursos adicionais como:
    - Associação de grupo dinâmico usando asserções (começando no Tableau Server 2024.2)
    - Funções de atributo do usuário (começando no Tableau Server 2025.1)
    - Tokens externos para SCIM (começando no Tableau Server 2025.3)

Para obter mais informações sobre esse tipo de aplicativo conectado, consulte [Configurar aplicativos conectados com confiança direta](https://help.tableau.com/current/server/pt-br/connected_apps_direct.htm).

### Confiança de OAuth 2.0

Ao usar o _OAuth 2.0 confiável_, você pode:

- Restringir o acesso a qual conteúdo pode ser inserido e onde esse conteúdo pode ser inserido
- Fornecer aos usuários a capacidade de acessar conteúdo inserido usando logon único (SSO) por meio do provedor de identidade (IdP)
- Forneça acesso usando o protocolo padrão OAuth 2.0
- Autorize programaticamente o acesso à API REST do Tableau e à API de metadados a (partir de Tableau Server de outubro 2023) em nome dos usuários
- Autorize programaticamente o acesso à API REST do Tableau e ao VizQL Data Service (partir de Tableau Server fevereiro de 2025) em nome dos usuários
- Escopo de recursos da API REST do Tableau que os usuários ou aplicativos podem executar
- Habilite recursos adicionais como:
    - Associação de grupo dinâmico usando asserções (começando no Tableau Server 2024.2)
    - Funções de atributo do usuário (começando no Tableau Server 2025.1)
    - Tokens externos para SCIM (começando no Tableau Server 2025.3)

Para obter mais informações sobre este aplicativo conectado, consulte [Configurar aplicativos conectados com confiança OAuth 2.0](https://help.tableau.com/current/server/pt-br/connected_apps_eas.htm).

## Outros artigos nesta seção

<!-- document id=aeebc0366c5a0e0766a25a030f2f0d43e164e4e22360651a3a776abf9fb494f5 url=/tableau/current/pt-br/server/adminview_login_based_license_usage.md -->

[Pular para o conteúdo principal](#main-content)

# Uso de licenças baseadas em logon

**Observação:** esta exibição está disponível apenas para administradores de site e do servidor quando gerenciamento de licenças baseadas em logon estiver ativado no Tableau Server. Para obter informações sobre como navegar em exibições administrativas, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

A exibição Uso de licenças baseadas em logon permite que os administradores do servidor visualizem o uso de ativação da licença baseada em logon para o Tableau Cloud ou o Tableau Server. A exibição Uso de licenças baseadas em logon pode ajudá-lo a gerenciar as licenças com eficiência e determinar se há necessidade de mais ou menos licenças. Essa exibição pode ajudá-lo a responder às seguintes perguntas:

- Quem está usando uma licença do Tableau Desktop ou do Tableau Prep Builder na minha empresa?
- Uma função Creator foi compartilhada ou transferida?
- Alguma atividade de ativação ocorreu em um computador em que não deveria?
- A ativação está em uso em qual host?
- Qual a função atribuída ao usuário?
- A licença está em uso em qual produto do Tableau?
- A licença está em uso em qual versão do Tableau?
- A função Creator foi ativada através de Tableau Desktop ou Tableau Prep Builder?
- A licença de Creator foi ativada?
- Quantas licenças de Creator estão em uso?
- Quantas licenças de Creator não estão em uso?
- Quando uma licença de Creator foi usada pela última vez?

![Exemplo de um relatório de uso de gerenciamento de licenças baseado em logon.](/tableau/current/pt-br/server/pt-br/Img/lblm_usage_report.png)

Além de usar a exibição administrativa Uso de licenças baseadas em logon, também é possível acessar esses dados ([`identity_ based_activation_reporting`](https://tableau.github.io/tableau-data-dictionary/2020.1/data_dictionary.htm#identity_based_activation_reporting_anchor), [`identity_based_activation_user_role_change`](https://tableau.github.io/tableau-data-dictionary/2020.1/data_dictionary.htm#identity_based_activation_user_role_change_anchor) e [`identity_based_activation_admin_view`](https://tableau.github.io/tableau-data-dictionary/2020.1/data_dictionary.htm#identity_based_activation_admin_view_anchor)) no banco de dados do “grupo de trabalho” PostgreSQL no repositório do Tableau Server. Antes de acessá-los, você deve [ativar o acesso ao Repositório do Tableau Server](https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#enable-access-to-the-tableau-server-repository).

### Filtros

Na tela do relatório, é possível alterar a janela de tempo para mostrar quando as licenças foram usadas pela última vez, filtrar por ações, filtrar por nome de usuário e classificar por colunas.

- **Janela de tempo em dias**. Insira o número de dias para ver o gerenciamento de licenças baseadas em logon ativada nos dados de uso do cliente. Você pode exibir os dados dos últimos 30 dias até no máximo 183 dias.
- **(Todas)**. Aplique todos os filtros à exibição
- **Ativada**. Mostrar usuários Creator que ativaram usando gerenciamento de licenças baseadas em logon.
- **Em uso**. Mostrar usuários Creator que ativaram usando gerenciamento de licenças baseadas em logon cujas licenças estão em uso.
- **usado pela última vez**. Mostre quando o gerenciamento de licenças baseadas em logon cliente foi usado pela última vez.
- **Não atribuída.** Mostrar quais licenças de Creator do gerenciamento de licenças baseadas em logon ativadas estão atualmente como não atribuídas.
- **Nome de usuário**. Mostre as ativações do gerenciamento de licenças baseadas em logon em uso de acordo com o usuário especificado.

Quando você focaliza o cartão Filtro, um ícone suspenso é exibido. Clique no ícone para especificar se a exibição deve incluir dados que correspondam ao filtro (o padrão) ou excluir dados que correspondam ao filtro:

![Um menu suspenso com duas opções: Incluir valores e Excluir valores.](/tableau/current/pt-br/server/pt-br/Img/filter_include_exclude.png)

## **Quais licenças de Creator estão em uso nos últimos <nn> dias?**

Esta área do painel mostra uma lista de três tipos de licenças (ativadas, em uso e não atribuídas). Focalizar em uma marca ativada, em uso ou não atribuída fornece informações, incluindo o usuário registrado da cópia do Tableau. Clique em um cabeçalho de coluna para classificar a lista.

## **Quais licenças de Creator não foram usadas nos últimos <nn> dias?**

Essa área do painel mostra uma lista de licenças que não foram usadas durante o período especificado. Uma linha do tempo mostra a última data de utilização. Passar o mouse sobre uma marca de último uso fornece informações a você, incluindo o usuário registrado da cópia do Tableau.

<!-- document id=fa965d6af618001728e478148dfb1412fc776d5736ac6539fc34f5b349a65be8 url=/tableau/current/pt-br/server/users_guest.md -->

[Pular para o conteúdo principal](#main-content)

# Usuário Convidado

As licenças baseadas em núcleo do Tableau Server incluem uma opção de usuário Convidado. Esta opção pode ser usada para permitir que pessoas acessem as exibições do Tableau sem uma conta no servidor.

O acesso de usuário Convidado é habilitado por padrão quando o Tableau Server é instalado com uma licença baseada em núcleo. Não está disponível com licenciamento baseado no usuário. Se você não pretende usar o acesso de usuário Convidado, é recomendado que o desabilite.

O acesso de convidado permite que os usuários visualizem e interajam com apenas as exibições inseridas. O usuário convidado não pode navegar pela interface do Tableau Server e não verá comandos da interface do servidor na exibição, como nome do usuário, configurações da conta, comentários e assim por diante. Para obter mais informações sobre licenças, consulte [Gerenciar licenças](https://help.tableau.com/current/server/pt-br/license_manage.htm).

**Dica:** para compartilhar exibições com usuários Convidado, forneça links de URL ou insira exibições nas páginas da Web. Para obter mais informações, [consulte Ajuda do usuário do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/shareworkbooks.htm).

## Permissões do usuário convidado

Um usuário convidado pode ter os seguintes recursos:

- **Pastas de trabalho e exibições**: Visualizar, Exportar imagem, Dados de resumo, Visualizar comentários, Filtrar, Dados completos, Edição na Web, Baixar (para salvar uma cópia local)
- **Fontes de dados**: Visualizar e Baixar

Se adicionar o usuário convidado a um grupo com nível de acesso mais alto a um recurso de conteúdo, o acesso do usuário convidado não excede os recursos listados acima. Contudo, a conta de usuário convidado estará em conformidade com configurações de permissões mais restritivas.

O usuário convidado só pode acessar dados com credenciais inseridas ou onde as credenciais não são necessárias. Uma fonte de dados que solicita credenciais ao usuário não pode ser acessada pelo usuário convidado. Consulte [Acesso aos dados para fontes de dados publicadas do Tableau](https://help.tableau.com/current/server/pt-br/permissions.htm#data-access-for-published-tableau-data-sources).

## Habilitar ou desabilitar acesso de Convidado

É preciso ser um administrador de servidor para alterar as configurações da conta de Convidado no nível de servidor ou de site.

**Observação:** habilitar o usuário Convidado para um site aumenta o número de possíveis observadores simultâneos para além da lista de usuários esperada. A exibição administrativa Status > Tráfego para exibições pode ajudá-lo a medir a atividade.

1. no menu do site, clique em **Gerenciar todos os sites** e, em seguida, em Configurações \> Geral.
2. Para Acesso de convidado, selecione ou desmarque **Habilitar acesso de convidado**.
3. Clique em **Salvar**.

Isto habilita o usuário convidado em todos os sites. Em seguida, você pode acessar a mesma configuração para um site específico. Para remover o acesso de convidado para um site:

1. No menu do site, selecione um site.
2. Clique em Configurações e, na guia Geral, desmarque a caixa de seleção Habilitar acesso de convidado para este site.

Se a conta de convidado estiver habilitada em alguns ou em todos os sites e você desativá-la no nível de servidor, ela também será desativada para todos os sites.

Observação: é possível desativar o acesso do usuário convidado no nível do servidor ou do site; contudo, não é possível remover o usuário. Dessa forma, embora ninguém possa acessar dados ou exibições sem estar conectado ao servidor, o usuário convidado ainda aparece na lista de usuários de site e listas dos grupos aos quais você adicionou o usuário convidado.

## Características adicionais da conta de convidado

O usuário convidado é exclusivo das seguintes maneiras adicionais:

- Como uma única conta de usuário, ele representa todos os usuários não autenticados que acessam as exibições do Tableau.
- Quando habilitado, é membro do grupo Todos os usuários.
- É possível adicioná-la como um membro de grupos em um site.
- Não é possível editá-lo o selecioná-lo como o proprietário de um recurso de conteúdo.
- A conta não pode salvar exibições personalizadas.
- O convidado não pode ser usado em um filtro de usuário.
- Não é possível excluir a conta; no entanto, você pode desativar o acesso a ela desmarcando a caixa de seleção descrita nas etapas acima.

<!-- document id=067742e5c68cdc7ee89c0fec70ae44b925499cfb740c0ba8568793e31a575406 url=/tableau/current/pt-br/server/trusted_auth_trouble_invaliduser.md -->

[Pular para o conteúdo principal](#main-content)

# Usuário inválido (SharePoint ou C#)

Você poderá encontrar esse erro se tiver configurado o Tableau Server para autenticação confiável.

O código de exemplo para a .dll do SharePoint faz referência à seguinte solicitação GET:

SPContext.Current.Web.CurrentUser.Name

A solicitação acima retornará o nome para exibição do usuário atual do Windows Active Directory. Se desejar usar a ID de logon, você precisará alterar o código para:

SPContext.Current.Web.CurrentUser.LoginName

Após fazer a alteração, recompile a .dll do SharePoint.

<!-- document id=ac1176c357fffdf90661c05c1ec87b9a444049d59b033a92b0f0e17f2c20d50c url=/tableau/current/pt-br/server/rmt-admin-cmdline.md -->

[Pular para o conteúdo principal](#main-content)

# Utilitário de linha de comando rmtadmin

O Resource Monitoring Tool inclui uma interface de linha de comando, `rmtadmin.cmd`, localizada na pasta de instalação. O diretório de instalação padrão é:

- RMT Server `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\Master`
- Agente: `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\agent`

**Observação:** você deve executar o prompt de comando como Administrador para que esses comandos sejam executados com sucesso.

> O `rmtadmin` está incluído nas instalações de **RMT Server** e **Agente**. Alguns comandos podem variar se você estiver usando o utilitário de linha de comando RMT Server ou Agente `rmtadmin`. Por exemplo, o comando `users` só funciona no _RMT Server_. O comando `ziplogs` está disponível em todos os lugares, mas inclui apenas os arquivos de registro do aplicativo em que o comando é executado.

Aqui estão os comandos que podem ser usados com a linha de comando `rmtadmin`:

**Observação:** os comandos `rmtadmin` usam parâmetros posicionais e opções.  
Os parâmetros posicionais devem ser especificados usando apenas os valores. Você não precisa especificar a palavra-chave real. A palavra-chave da opção e o valor devem ser especificados usando um sinal de igual.  
Exemplo:  
`rmtadmin <command> <positional parameter value> --<option keyword>**=**<value>`

- [rmtadmin add-user](#rmtadmin_add-user)
- [rmtadmin agents](#rmtadmin_agents)
- [rmtadmin bootstrap-file](#rmtadmin_bootstrap_file)
- [rmtadmin cleanup](#rmtadmin-cleanup)
- [rmtadmin create-admin-user](#rmtadmin-create-admin-user)
- [rmtadmin create-env](#rmtadmin-create-env)
- [rmtadmin delete-env](#rmtadmin-delete-env)
- [](#rmtadmin-data-access)[rmtadmin data-access](#rmtadmin-data-access)
- [rmtadmin delete-env-data](#rmtadmin_delete_env_data)
- [rmtadmin delete-server](#rmtadmin-delete-server)
- [rmtadmin delete-server-data](#rmtadmin-delete-server-data)
- [rmtadmin delete-user](#rmtadmin_delete-user)
- [rmtadmin deregister-agent](#rmtadmin-deregister-agent)
- [rmtadmin environments](#rmtadmin-environments)
- [rmtadmin get](#rmtadmin_get)
- [rmtadmin get-user](#rmtadmin_get-user)
- [rmtadmin help](#rmtadmin_help)
- [](#rmtadmin_master_setup)[rmtadmin master-setup](#rmtadmin_master_setup)
- [rmtadmin passwd](#rmtadmin_passwd)
- [rmtadmin query](#rmtadmin_query)
- [rmtadmin register](#rmtadmin_register)
- [rmtadmin restart](#rmt_restart)
- [rmtadmin rotate-mq-certificate](#rmtadmin_rotate_mq_cert-agent)
- [rmtadmin rotate-mq-certificates](#rmtadmin_rotate_mq_certs)
- [rmtadmin servers](#rmtadmin-servers)
- [rmtadmin service-setup](#rmtadmin-service-setup)
- [rmtadmin set](#rmtadmin_set)
- [rmtadmin start](#rmtadmin_start)
- [rmtadmin stop](#rmtadmin_stop)
- [rmtadmin status](#rmtadmin_status)
- [rmtadmin test-env](#rmtadmin_test_env)
- [rmtadmin update-baseline](#rmtadmin-update-baseline)
- [rmtadmin update-env](#rmtadmin-update-env)
- [rmtadmin users](#rmtadmin_users)
- [rmtadmin version](#rmtadmin_version)
- [rmtadmin ziplogs](#rmtadmin_ziplogs)

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte [Sobre o Tableau help](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm).

## rmtadmin add-user

**Observação:** adicionado na versão 2024.2.

Cria uma conta de usuário com o nome de usuário fornecido, caso não exista uma.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin add-user [options][global option]`

### Opções

\--username

O nome de usuário para a nova conta de usuário a ser adicionada.

\--auth-mode

O modo de autenticação para a nova conta de usuário. O valor pode ser `Local` ou `Delegated`.

\--password

A senha para a conta de usuário. Necessária somente se auth-mode for `Local`.

\--password-file

O caminho para o arquivo que contém a senha da conta de usuário. Você pode usar isso se não quiser digitar a senha diretamente e ter a senha armazenada em um arquivo que pode ser acessado. Necessária somente se o modo de autenticação for Local.

Funções

\--download-log-bundles

Opcional. Concede ao usuário o privilégio de baixar pacotes de registro.

\--download-tds-files

Opcional. Concede ao usuário o privilégio de baixar arquivos TDS.

\--generate-chargeback-report

Opcional. Concede ao usuário o privilégio de gerar um relatório de chargeback.

\--environment-management

Opcional. Concede ao usuário o privilégio de gerenciar o ambiente.

\--user-management

Opcional. Concede ao usuário o privilégio de gerenciar usuários.

\--webhook-management

Opcional. Concede ao usuário o privilégio de gerenciar o webhook.

**Exemplo:**

rmtadmin add-user --username=<username> --password=<password> --auth-mode=<Local|Delegated> --download-log-bundles=\[T|F\] --download-tds-files=\[T|F\] --generate-chargeback-report=\[T|F\] --environment-management=\[T|F\] --user-management=\[T|F\] --webhook-management=\[T|F\]

**Observação**: o modo de autenticação local é desabilitado se a chave de configuração `DisableLocalAuthentication` está definida como verdadeira.

## rmtadmin agents

**Observação:** adicionado na versão 2021.2

Lista todos os Agentes registrados nos nós do Tableau Server para todos os ambientes.

Isso é útil para ver onde o Agente do Resource Monitoring Tool está instalado no Tableau Server.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin agents [options][global option]`

### Opções

\--env

Opcional: use esta opção para ver a lista de Agentes para o ambiente específico. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

\--keys

Opcional: inclui a chave do agente na saída.

**Exemplo:**`rmtadmin agents --env=<myenvironmentidentifier> --keys`

## rmtadmin bootstrap-file

**Observação:** adicionado na versão 2021.2

Cria e salva o arquivo de bootstrap usado para registrar agentes nos nós do Tableau Server.

O arquivo de bootstrap será criado e salvo no caminho absoluto ou relativo especificado. Os caminhos relativos são resolvidos para o diretório de trabalho atual.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin bootstrap-file [options][global option]`

### Opções

\--env

Obrigatório. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.  
O agente em um nó do Tableau Server só pode ser registrado em um ambiente por vez.

\--filename

Opcional. O caminho absoluto ou relativo, incluindo o nome do arquivo. Os caminhos relativos são resolvidos para o diretório de trabalho atual. Se não for especificado, o nome do arquivo de saída padrão será usado.

\--force

Opcional. Substitui o arquivo existente com o mesmo nome.

**Exemplo:**`rmtadmin bootstrap-file --env=<myenvironmentidentifier>`

## rmtadmin cleanup

**Observação:** adicionado na versão 2021.2

Exclui os arquivos de registro mais antigos do que um determinado número de dias. Por padrão, ele exclui arquivos de registro com mais de 31 dias.

**Esse comando funciona no RMT Server e no Agente.**

**Observação:** se os processos do Resource Monitoring Tool estiverem em execução, os arquivos de registro ativos não serão limpos pelo comando. Se você quiser ter certeza de que todos os arquivos foram excluídos, você precisará interromper o RMT usando o [comando rmtadmin\_stop](#rmtadmin_stop) e, em seguida, executar a limpeza usando o seguinte comando ,`rmtadmin cleanup --log-files-retention=0` e, em seguida, reiniciar os processos usando o comando [rmtadmin\_start.](#rmtadmin_start)

### Sinopse

`rmtadmin cleanup [option][global option]`

### Opção

\--log-files-retention

Opcional. Exclui os arquivos de registro mais antigos que o número de dias especificado.

**Exemplo:**`rmtadmin cleanup --log-files-retention=<number of days>`

## rmtadmin create-admin-user

**Versão:** adicionado na versão 2022.1.

Cria um usuário administrador inicial se não houver outros usuários.

**Observação:** a partir da versão 2023.1, você pode criar vários usuários administradores.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin create-admin-user [options][global option]`

### Opções

\--username

Opcional. O nome de usuário para a conta de usuário administrador. Coloca “admin” como padrão, se não especificado.

\--password

Obrigatório. A senha para a conta de usuário administrador.

\--password-file

Opcional. O caminho para o arquivo que contém a senha da conta de usuário administrador. Você pode usar isso se não quiser digitar a senha diretamente e ter a senha armazenada em um arquivo que pode ser acessado.

**Exemplo:**`rmtadmin create-admin-user --username<admin user name> --password <password for the admin user account>`

## rmtadmin create-env

**Observação:** adicionado na versão 2021.2

Criar um novo ambiente.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin create-env [options][global option]`

### Opções

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 115px;"><col><col><col style="width: 234px;"></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th>Padrão</th><th>Descrição</th></tr></thead><tbody><tr><td>--name</td><td>Sim</td><td>n/a</td><td>O nome do ambiente.</td></tr><tr><td>--gateway-url</td><td><p>Sim</p><p>&nbsp;</p></td><td>n/a</td><td><p>URL usado para acessar o gateway do Tableau Server.</p></td></tr><tr><td>--version</td><td>Sim</td><td>n/a</td><td>Versão do Tableau Server que este ambiente monitorará.</td></tr><tr><td>--non-interactive</td><td><p>Não</p><p></p></td><td>Os prompts interativos são ativados por padrão.</td><td>Desativa todos os prompts interativos.</td></tr><tr><td>--no-test</td><td><p>Não</p><p></p></td><td>O teste de conexão da API e do repositório é ativado por padrão.</td><td>Desativa o teste de conexões de API e repositório.</td></tr><tr><td>--api-username</td><td>Não</td><td>Nulo</td><td>Nome de usuário da conta usada para se conectar às APIs do Tableau Server. A conta de usuário deve ser um administrador do Tableau Server com acesso a todos os sites do Tableau Server.</td></tr><tr><td>--api-password</td><td><p>Não</p><p>(Se você especificar o nome de usuário da API do Tableau, fornecerá a senha ou especificará o caminho do arquivo e o arquivo que contém a senha)</p></td><td><p>Nulo</p></td><td><p>Senha da conta de usuário da API do Tableau Server usada para se conectar às APIs do Tableau Server.</p></td></tr><tr><td>--api-password-file</td><td>Não</td><td>Nulo</td><td>O caminho para o arquivo e o nome do arquivo que contém a senha da conta de usuário da API do Tableau Server.</td></tr><tr><td>--repository-server</td><td>Sim</td><td><p>Nulo</p></td><td>É o nome do servidor para o banco de dados PostgreSQL que está instalado com Tableau Server.</td></tr><tr><td>--repository-database</td><td>Sim</td><td>Nulo</td><td>É o nome do banco de dados PostgreSQL que está instalado com Tableau Server.</td></tr><tr><td>--repository-port</td><td>Sim</td><td>Nulo</td><td>O número da porta do aplicativo do banco de dados do Repositório do Tableau Server.</td></tr><tr><td>--repository-username</td><td>Sim</td><td>Nulo</td><td><p>Nome de usuário usado para se conectar ao banco de dados PostgreSQL instalado com o Repositório do Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password</td><td>Sim</td><td>Nulo</td><td><p>Senha para a conta de usuário usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password-file</td><td>Não, mas obrigatório se você não fornecer a senha no prompt de comando ou diretamente em um script.</td><td>Nulo</td><td>O caminho incluindo o nome do arquivo onde a senha da conta do usuário é usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</td></tr><tr><td>--repository-ssl-mode</td><td><p>Não</p></td><td>Prefira</td><td><p>Modo SSL do repositório do Tableau Server:</p><p><b>Prefira</b> SSL ou <b>Exija</b> SSL para configurar conexões SSL para o repositório do Tableau.</p><p><b>Desative</b> para nunca usar SSL para fazer conexões de Repositório do Tableau Server.</p></td></tr><tr><td>--repository-ssl-thumbprint</td><td><p>Não</p></td><td>Nulo</td><td>Ao configurar o Tableau Server PostgreSQL para permitir conexões diretas, o Tableau Server cria um certificado e chaves. Você pode optar por fornecer a impressão digital para o certificado gerada pelo Tableau Server ou copiar o arquivo <b>server.crt</b> para a máquina do RMT Server da Resource Monitoring Tool. Se você optar por copiar o arquivo de certificado, não precisará fornecer a impressão digital. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm" class="xref">Configurar Postgres SSL para permitir conexões diretas de clientes</a>.</td></tr></tbody></table>

**Exemplo:**`rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account> --gateway-url <Tableau Server Gateway URL> --version <Tableau Server version>`

## rmtadmin data-access

**Observação:** adicionado na versão 2022.3

Habilita ou desabilita o acesso ao banco de dados PostgreSQL. Observação: o acesso ao banco de dados PostgreSQL é necessário a partir da versão 2022.3 para que o Resource Monitoring Tool colete com êxito todos os dados de monitoramento do Tableau Server.

**Esse comando só funciona no RMT Server**

**Observação:** o banco de dados PostgreSQL deve ser reiniciado para que esta configuração tenha efeito.

### Sinopse

`rmtadmin data-access [positional parameter][options] [global option]`

### Parâmetro de posição

modo

Obrigatório. O modo que deve ser usado para acesso remoto de dados ao banco de dados PostgreSQL. Os valores devem ser: _None_, _ReadOnly_, _Admin_. Quando definido como _None_, o acesso aos dados é desabilitado. ReadOnly e Admin especificam qual conta de usuário usar para acessar o banco de dados.

### Opções

\--

**Exemplo:**

`rmtadmin data-access ReadOnly`

`rmtadmin restart --db`

## rmtadmin delete-env

**Observação:** adicionado na versão 2021.2

Exclui um ambiente específico e todos os dados coletados para esse ambiente. Ele também remove as informações de conexão e topologia sobre o Tableau Server que o ambiente está monitorando e cancela o registro de todos os Agentes do Resource Monitoring Tool.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin delete-env [positional parameter][options] [global option]`

### Parâmetro de posição

env

Obrigatório. Este é o identificador gerado pelo sistema. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

### Opções

\--confirm

Opcional. Confirme se deseja excluir o ambiente. Se você não fornecer esta opção, será solicitado a confirmar.

\--skip-agent-disconnect

Opcional. Pula a desconexão do agente e continua com o cancelamento do registro do agente. Use esta opção se achar que o agente está inacessível - Por exemplo, se o nó do Tableau Server foi removido ou se o agente foi desinstalado nesse nó.

**Exemplo:**`rmtadmin delete-env <myenvironmentidentifier>`

## rmtadmin delete-env-data

Exclui permanentemente todos os dados relacionados do Tableau Server coletados para um ambiente específico. A configuração do ambiente, as informações do Tableau Server e o registro do agente não serão removidos.

Isso é útil para limpar todos os dados existentes em um ambiente sem remover o próprio ambiente. Depois de excluir os dados existentes, novos dados enviados pelos agentes continuarão a ser processados.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin delete-env-data [positional parameter][option][global option]`

### Parâmetro de posição

env

O identificador do ambiente para o qual os dados devem ser excluídos. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

### Opção

\--confirm

Opcional. Confirme se deseja excluir os dados do ambiente. Se você não fornecer esta opção, será solicitado a confirmar.

**Exemplo:**`rmtadmin delete-env-data <myenvironmentidentifier>`

## rmtadmin delete-server

**Observação:** adicionado na versão 2021.2

Exclui as informações de configuração do nó do Tableau Server do ambiente, cancela o registro do Agente nesse nó e exclui todos os dados de monitoramento coletados específicos para esse nó.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin delete-server [options][global option]`

### Opções

\--env

Obrigatório. O identificador do ambiente ao qual o nó do Tableau Server está conectado. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

\--hostname

Necessário para excluir informações sobre um ou mais conectados ao ambiente e se **\--all** não for especificado.

É o nome da máquina do nó do Tableau Server. Use vírgulas para separar vários valores se especificar mais de um nome de host.

\--all

Opcional, mas obrigatório se **\--hostname** não for especificado.

Exclui as informações de todos os nós do Tableau Server conectados ao ambiente.

\--skip-agent-disconnect

Opcional. Pula a desconexão do agente e continua com o cancelamento do registro do agente. Use esta opção se o agente estiver inacessível - por exemplo, se o nó foi removido do Tableau Server ou se o Agente foi desinstalado naquele nó.

\--confirm

Confirme se deseja excluir todas as informações sobre o nó do Tableau Server. Se você não fornecer esta opção, será solicitado a confirmar.

**Exemplo:**`rmtadmin delete-server --hostname=<machine name of the Tableau Server node>`

## rmtadmin delete-server-data

**Observação:** adicionado na versão 2021.2

Exclui os dados coletados de um ou mais nós do Tableau Server. Os dados removidos pertencem apenas aos nós especificados. Se você especificar _all_, todos os dados coletados de todos os nós serão excluídos. A configuração do ambiente, as informações do Tableau Server e os registros do agente não serão excluídos.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin delete-server-data [options][global option]`

### Opções

\--env

Obrigatório. O identificador do ambiente ao qual o nó do Tableau Server está conectado. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

\--hostname

Necessário para excluir informações sobre um ou mais conectados ao ambiente e se **\--all** não for especificado.

É o nome da máquina do nó do Tableau Server. Use vírgulas para separar vários valores se especificar mais de um nome de host.

\--all

Opcional, mas obrigatório se **\--hostname** não for especificado.

Exclui os dados de monitoramento de todos os nós do Tableau Server conectados ao ambiente.

\--confirm

Confirme se deseja excluir todos os dados de monitoramento dos nós do Tableau Server. Se você não fornecer esta opção, será solicitado a confirmar.

**Exemplo:**`rmtadmin delete-server-data --env=<myenvironmentidentifier> --all`

## rmtadmin delete-user

**Observação:** adicionado na versão 2024.2.

Exclui a conta de usuário com o nome de usuário fornecido, se houver.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin delete-user [options][global option]`

### Opções

\--username

O nome de usuário da conta de usuário a ser excluída

**Exemplo:**

rmtadmin delete-user --username=<username> 

## rmtadmin deregister

**Observação:** adicionado na versão 2021.2

Cancele o registro do Agente do ambiente. Os dados de monitoramento deste nó não serão mais coletados. Os dados existentes permanecerão e não serão excluídos.

**Este comando só funciona quando executado no Agente RMT. Execute isso no agente cujo registro você deseja cancelar.**

### Sinopse

`rmtadmin deregister [options]`

### Opções

\--confirm

Opcional. Confirme se deseja cancelar o registro do Agente. Isso ignora o prompt de confirmação.

\--ignore-master-errors

Opcional. Ignora quaisquer erros que ocorram durante a comunicação com o RMT Server durante este processo.

**Exemplo:**`rmtadmin deregister --confirm`

## rmtadmin deregister-agent

**Observação:** adicionado na versão 2021.2

Cancele o registro do Agente especificado do ambiente. Os dados de monitoramento deste nó não serão mais coletados. Os dados existentes permanecerão e não serão excluídos.

**Este comando só funciona quando executado no RMT Server.**

### Sinopse

`rmtadmin deregister-agent [options][global option]`

### Opções

\--env

Obrigatório se **\--key** não for especificado.

Este é o identificador do ambiente onde o Agente está registrado atualmente. Este é o identificador gerado pelo sistema. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

\--key

Opcional se **\--env** for especificado.

Esta é a chave do Agente. Use vírgulas para separar vários valores. Você pode obter os valores-chave executando o comando [rmtadmin agents.](#rmtadmin_agents)

\--hostname

Opcional. Nome da máquina do nó do Tableau Server em que o Agente está instalado. Use vírgulas para separar vários valores.

\--all

Opcional. Use esta opção para cancelar o registro de Agentes em todos os nós.

\--ignore-agent-errors

Opcional. Ignora todos os erros que ocorrem se não for possível conectar-se com os Agentes durante este processo.

\--skip-agent-disconnect

Opcional. Pula a desconexão do agente e continua com o cancelamento do registro do agente. Use esta opção se você achar que o Agente está inacessível - por exemplo, se o nó foi removido do Tableau Server ou se o Agente foi desinstalado naquele nó.

\--confirm

Opcional. Confirme se deseja cancelar o registro o Agente. Se você não fornecer esta opção, será solicitado a confirmar.

**Exemplo:**`rmtadmin deregister-agent --env=<myenvironmentidentifier> --all`

## rmtadmin environments

**Observação:** adicionado na versão 2021.2

Lista todos os ambientes no Server do Resource Monitoring Tool.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin environments [global option]`

## rmtadmin get

Obtém o valor da chave de configuração especificada.

Esse comando pode ser usado no RMT Server e no Agente.

### Sinopse

`rmtadmin get <config.key> [global option]`

### Parâmetro de posição

key

Nome da chave de configuração.

**Exemplo:** `rmtadmin get db:database`

### Chaves de configuração suportadas

<table><colgroup><col><col><col><col><col></colgroup><thead><tr class="header"><th>Chave</th><th>Tipo de dados</th><th>Aplica-se a</th><th>PADRÃO</th><th>Descrição</th></tr></thead><tbody><tr class="even"><td><code>auth:disableLocalAuthentication</code></td><td>Booleano</td><td>RMT Server</td><td>FALSE</td><td>Se TRUE, criar usuário com modo de autenticação como local não é permitido. Adicionado na versão 2024.2</td></tr><tr class="even"><td><code>auth:disableUserManagementUI</code></td><td>Booleano</td><td>RMT Server</td><td>FALSE</td><td>Se definido como TRUE, o gerenciamento de usuários pela interface do usuário não será permitido. Adicionado na versão 2024.2</td></tr><tr class="even"><td><code>db:cleanup:batchSize</code><p>&nbsp;</p></td><td>Inteiro</td><td>RMT Server</td><td>100000</td><td>O número máximo de linhas excluídas por lote durante as operações de limpeza do PostgreSQL. Adicionado na versão 2025.3.4</td></tr><tr class="even"><td><code>db:database</code></td><td>Cadeia de caracteres</td><td>RMT Server</td><td>tabrmtdb</td><td>Nome do banco de dados PostgreSQL usado pela RMT.</td></tr><tr class="even"><td><code>db:readOnlyUsername</code></td><td>Cadeia de caracteres</td><td>RMT Server</td><td>readonly</td><td>Nome de usuário de uma conta de usuário PostgreSQL que só tem acesso somente leitura para os dados da RMT.</td></tr><tr class="even"><td><code>db:readOnlyPassword</code></td><td>Cadeia de caracteres</td><td>RMT Server</td><td>Gerado pelo programa instalador.</td><td>Senha do usuário somente leitura do PostgreSQL.</td></tr><tr class="even"><td><code>monitoring:antiDomainLockoutEnabled</code></td><td>Booleano</td><td>RMT Server</td><td>TRUE</td><td>Quando definido como TRUE (o padrão), o recurso de bloqueio antidomínio é habilitado. Adicionado na versão 2025.1.1. Esse recurso permite configurar o RMT para parar de tentar entrar antes que o domínio seja bloqueado.</td></tr><tr class="even"><td><code>monitoring:antiDomainLockoutTimeSeconds</code></td><td>Inteiro</td><td>RMT Server</td><td>600</td><td>A duração de tempo pela qual todas as tentativas do Tableau Server serão limitadas antes de tentar a conexão novamente. Adicionado na versão 2025.1.1.</td></tr><tr class="even"><td><code>monitoring:antiDomainMaxFailedLoginAttempts</code></td><td>Inteiro</td><td>RMT Server</td><td>3</td><td>O limite de tentativas consecutivas de logon malsucedidas para ativar o Tableau Server para que o bloqueio antidomínio seja ativado. Adicionado na versão 2025.1.1.</td></tr><tr class="even"><td><code>mq:tls:certificateHostName</code></td><td>Cadeia de caracteres</td><td>RMT Server e Agente</td><td>n/a</td><td>Nome do host no certificado que deve ser usado ao se conectar ao RabbitMQ via TLS.</td></tr><tr class="even"><td><code>mq:tls:enabled</code></td><td>Booleano</td><td>RMT Server e Agente</td><td>FALSE</td><td>Ativar/desativar conexão TLS ao RabbitMQ.</td></tr><tr class="even"><td><code>mq:port</code></td><td>Inteiro</td><td>RMT Server e Agente</td><td>5672</td><td>Número da porta de host RabbitMQ.</td></tr><tr class="even"><td><code>mq:virtualHost</code></td><td>Cadeia de caracteres</td><td>RMT Server e Agente</td><td>tabrmt</td><td>Conexão com o RMT Server ou Agente. Para Agente, você pode modificar esta configuração registrando o Agente com um arquivo bootstrap. Para o RMT Server, o valor é gerenciado pelo instalador.</td></tr><tr class="even"><td><code>server:web:responseheader</code></td><td>Cadeia de caracteres</td><td>RMT Server</td><td>&nbsp;</td><td>Exiba um cabeçalho de resposta personalizado específico.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-response-headers.htm" class="xref">Cabeçalhos de resposta do Resource Monitoring Tool do Tableau (RMT)</a></p></td></tr><tr class="even"><td><code>server:web:responseheaders</code></td><td>Cadeia de caracteres</td><td>RMT Server</td><td>&nbsp;</td><td>Exiba todos os cabeçalhos de resposta personalizado.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-response-headers.htm" class="xref">Cabeçalhos de resposta do Resource Monitoring Tool do Tableau (RMT)</a></p></td></tr><tr class="even"><td><code>server.web.run</code></td><td>Booleano</td><td>Agente</td><td>TRUE</td><td>Ativar ou desativar a interface na Web do Agente.</td></tr></tbody></table>

Use o comando [set](#heading--set) para alterar o valor da configuração atual.

## rmtadmin get-user

**Observação:** adicionado na versão 2024.2.

Lista os detalhes da conta de usuário para o nome de usuário fornecido, se a conta de usuário existir. Os detalhes incluem nome de usuário, modo de autenticação e privilégios de função.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin get-user [options][global option]`

### Opções

\--username

O nome de usuário da conta do usuário.

**Exemplo:**

rmtadmin get-user --username=<username> 

## rmtadmin help

Mostra a ajuda geral sobre a interface da linha de comando e os comandos disponíveis.

**Esse comando pode ser usado no RMT Server e no Agente.**

### Sinopse

`rmtadmin help`

Mostra a ajuda e a utlização de um comando específico:

**Esse comando pode ser usado no RMT Server e no Agente.**

`rmtadmin help [command]`

## rmtadmin master-setup

Configura o RMT Server com opções especificadas. Usado durante as configurações de instalação e pós-instalação.

### Sinopse

`rmtadmin master-setup [options][global option]`

As opções de configuração estão listadas abaixo:

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 115px;"><col><col><col style="width: 234px;"></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th>Padrão</th><th>Descrição</th></tr></thead><tbody><tr><td>--admin-password</td><td><p>Sim (Necessário apenas para instalação inicial)</p><p>A senha pode ser fornecida na linha de comando ou fornecer um arquivo com a senha a ser usada. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>n/a</td><td>A senha do usuário administrador.</td></tr><tr><td>--admin-password-file</td><td><p>Sim (Necessário apenas para instalação inicial)</p><p>A senha pode ser fornecida na linha de comando ou fornecer um arquivo com a senha a ser usada. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.</p></td><td>n/a</td><td>A senha do usuário administrador.</td></tr><tr><td>--admin-username</td><td>Não</td><td>admin</td><td>O nome de usuário administrador.</td></tr><tr><td>--skip-admin-creation<p><strong>Adicionado:</strong> versão 2020.4.0</p><p><strong>Descontinuado:</strong>&nbsp;versão 2022.3.0</p></td><td><p>Não</p><p>Essa opção só deve ser usada quando você fizer atualizações de configuração pós-instalação.</p><p>Nas versões onde esta opção é válida (2020.4.0 - 2022.2.x), se não for usada durante as atualizações de configuração pós-instalação, o comando falhará e nenhuma atualização será feita.</p><p>Nas versões 2022.3.0 e posteriores, o comando criará o administrador quando necessário.</p></td><td>False</td><td><p>Pule a criação do usuário e senha do administrador.</p></td></tr><tr><td>--http-port</td><td>Não</td><td>80</td><td>&nbsp;</td></tr><tr><td>--require-https</td><td>Não</td><td>False</td><td>Redirecione o tráfego http para HTTPS.</td></tr><tr><td>--https-certificate-mode</td><td>Não</td><td><p>'Padrão'</p><p>Opções disponíveis:</p><ul><li>Padrão</li><li>Armazenamento (somente windows)</li><li>Local</li></ul></td><td><p>O tipo de pesquisa de certificado para realizar o certificado HTTPS.</p><p><b>Padrão:</b> este modo usa o certificado de autoassinatura padrão fornecido pelo instalador.</p><p><b>Armazenamento:</b> permite que você digite a impressão digital de um certificado na loja de certificados do Windows.</p><p><b>Local:</b> permite especificar um certificado baseado em arquivo na pasta  <b>/config.</b></p></td></tr><tr><td>--https-certificate-store-thumbprint</td><td>Não</td><td>Nulo</td><td>O certificado HTTPS hash/impressão digital para procurar no modo de certificado 'store'.</td></tr><tr><td>--https-certificate-local-name</td><td>Não</td><td><p>Nulo</p><p>Nota: se não especificado, o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> é instalado com um certificado autoassinado e usará esse certificado para comunicações HTTPS.</p></td><td>O nome do arquivo de certificado HTTPS.</td></tr><tr><td>--https-certificate-local-password</td><td>Não</td><td>Nulo</td><td>A senha a ser usada para o certificado HTTPS.</td></tr><tr><td>--https-certificate-local-password-file</td><td>Não</td><td>Nulo</td><td>O caminho para o arquivo contendo a senha a ser usada para o certificado HTTPS.</td></tr><tr><td>--confirm</td><td>Não</td><td>Solicitação de confirmação.</td><td>Confirma a reinicialização do Serviço RMT.</td></tr><tr><td>--host</td><td><p>Não</p><p class="note"><b>Observação</b>: não recomendamos alterar este valor.</p></td><td>Valor de configuração atual ou nome da máquina.</td><td>A URL preferida para acessar o servidor da Resource Monitoring Tool. O servidor ouvirá todos os IPs independentemente do nome do host.</td></tr><tr><td>--db-config=external</td><td>Não</td><td>Nenhuma.<br>Isso só é usado quando o repositório é configurado externamente ao RMT Server.</td><td>Use isso para configurar o RMT Server para usar um repositório externo. Você não precisa especificar isso se quiser que o banco de dados PostgreSQL seja instalado localmente.</td></tr><tr><td>--db-server</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td><p>É o nome do servidor para o banco de dados PostgreSQL que está instalado com o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p><p>Se você estiver usando um repositório externo hospedado no AWS RDS, esse deve ser o nome da instância do RDS.</p></td></tr><tr><td><p>--db-ssl-mode</p><p>Versão:&nbsp;adicionado na versão 2023.1.0.</p></td><td>Não</td><td><code>Prefer</code></td><td><p>Isso determina a criptografia SSL/TLS para a conexão com o banco de dados PostgreSQL instalado com o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p><p>As opções são <code>Prefer </code> (o padrão), <code>VerifyCA</code> e <code>VerifyFull</code>. Para obter detalhes, consulte a <a href="https://www.npgsql.org/doc/security.html?tabs=tabid-1#encryption-ssltls" target="_blank">documentação Npgsql</a>.</p></td></tr><tr><td>--db-port</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td>Número da porta para o servidor de banco de dados.</td></tr><tr><td>--db-username</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td><p>Nome de usuário usado para se conectar ao banco de dados PostgreSQL instalado com o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p><p>Se você estiver usando um repositório externo hospedado no AWS RDS, deve ser "postgres".</p></td></tr><tr><td>--db-password</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td><p>Senha para a conta de usuário usada para se conectar ao banco de dados PostgreSQL instalado com o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p><p>Se você estiver usando um repositório externo hospedado no AWS RDS, esta é a senha do usuário que você criou ao criar a instância do RDS.</p></td></tr><tr><td>--mq-config=external</td><td>Não</td><td>Nenhum <br>Esta opção é especificada apenas quando o serviço de mensagens é hospedado externamente ao RMT Server.</td><td>Esta opção configura o RMT Server para usar um serviço de mensagens Rabbit MQ externo.</td></tr><tr><td>--mq-server</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td>O nome do servidor da fila de mensagens.</td></tr><tr><td>--mq-port</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td>A porta da fila de mensagens.</td></tr><tr><td>--mq-vhost</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td>O host virtual da fila de mensagens.</td></tr><tr><td>--mq-username</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td>O nome de usuário usado para se conectar à fila de mensagens.</td></tr><tr><td>--mq-password</td><td>Não</td><td>Valor de configuração atual ou padrão do instalador.</td><td>A senha da conta de usuário usada se conecta à fila de mensagens.</td></tr><tr><td>--mq-enable-tls</td><td>Não</td><td>Valor de configuração atual ou <b>false</b>. </td><td>Requer conexão TLS para se conectar à fila de mensagens.</td></tr><tr><td>--mq-tls-certificate-host</td><td>Não</td><td>Valor de configuração atual ou <b>null</b>. </td><td>O nome canônico do servidor da fila de mensagens. Isso deve coincidir com o nome no certificado.</td></tr><tr><td>--password-salt</td><td>Não</td><td>Aleatório</td><td><p>O salt global usado para gerar o hash da senha.</p><p>Isso se aplica às contas de usuário locais criadas no <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p></td></tr><tr><td>--password-min-length</td><td>Não</td><td>Valor de configuração atual ou <b>10</b>. </td><td><p>O comprimento mínimo para a senha.</p><p>Isso se aplica às contas de usuário locais criadas no <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p></td></tr><tr><td>--password-min-numeric</td><td>Não</td><td>Valor de configuração atual ou <b>1</b>. </td><td><p>O mínimo necessário de caracteres numéricos na senha.</p><p>Isso se aplica às contas de usuário locais criadas no <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p></td></tr><tr><td>--password-min-special</td><td>Não</td><td>Valor de configuração atual ou <b>1</b>. </td><td><p>O mínimo necessário de caracteres especiais na senha.</p><p>Isso se aplica às contas de usuário locais criadas no <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p></td></tr><tr><td>--password-min-latin</td><td>Não</td><td>Valor de configuração atual ou <b>5</b>. </td><td><p>O mínimo necessário de caracteres latinos na senha.</p><p>Isso se aplica às contas de usuário locais criadas no <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p></td></tr><tr><td>--password-require-mixed-case</td><td>Não</td><td>Valor de configuração atual ou <b>true</b>. </td><td><p>Requer caracteres de letras minúsculas e maiúsculas em senhas.</p><p>Isso se aplica às contas de usuário locais criadas no <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</p></td></tr><tr><td>--auth-timeout-minutes</td><td>Não</td><td>Valor de configuração atual ou <b>240</b>.</td><td>O número de minutos antes que a autenticação do usuário expire para a sessão.</td></tr><tr><td>--auth-slip-expiration</td><td>Não</td><td>Configuração atual ou <b>true</b>.</td><td>Se deve ou não redefinir o período limite de autenticação com a atividade do usuário.</td></tr></tbody></table>

**Exemplos:**

**Para especificar a senha do administrador:** `rmtadmin master-setup --admin-password=<password> --skip-admin-creation`

**Para atualizar a porta após a instalação:** `rmtadmin master-setup --http-port=8000 --skip-admin-creation`

## rmtadmin passwd

Redefine a senha para uma conta de usuário específica do Resource Monitoring Tool.

Esse comando só funciona no RMT Server.

### Sinopse

`rmtadmin passwd [positional parameter][global option]`

### Parâmetro de posição

username

Nome do usuário para o qual você deseja alterar a senha.

**Exemplo:** `rmtadmin passwd <username>`

## rmtadmin query

Executa uma consulta SQL bruta no banco de dados do Resource Monitoring Tool e salva os resultados em um arquivo de saída.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin query [positional parameter][options] [global option]`

### Parâmetro de posição

sql

Texto de comando SQL a ser executado. Você pode fornecer vários comandos SQL. Para usar um arquivo com os comandos SQL, use **@** como prefixo para o nome do arquivo.

### Opções

\--outfile=VALUE

Nome do arquivo zip para o qual deseja gerar os resultados de consulta. O padrão é _queryresults.zip_

\--force

Substitui o arquivo existente.

\--timeout=VALUE

tempo limite da consulta. Especifique isso em segundos

\--commit

Confirma as alterações feitas pelo comando SQL no banco de dados. Por padrão, o comando SQL é executado como transação, mas é revertido na conclusão.

**Exemplo:** `rmtadmin query <SQLCommand> --outfile=<path and the output file name>`

## rmtadmin register

**Observação:** adicionado na versão 2020.2

Registra o Agente que usa um arquivo bootstrap. O arquivo de bootstrap pode ser baixado usando o comando [rmtadmin bootstrap-file.](#rmtadmin_bootstrap_file)

Esse comando só pode ser usado no Agente e deve ser executado na máquina em que deseja instalar o Agente.

### Sinopse

`rmtadmin register [options][positional parameter] [global option]`

### Parâmetro de posição

bootstrap

O caminho do arquivo, incluindo o nome do arquivo bootstrap.

### Opções

\--username

Obrigatório. Nome do usuário admin criado durante a instalação do RMT Server.

\--password

Obrigatório. Senha para a conta do usuário.

\--password-file

Caminho incluindo o nome do arquivo que contém as informações da senha. A senha pode ser fornecida na linha de comando ou em um arquivo que contenha a senha. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.

\--server-name

Nome do nó em que o Agente está sendo instalado. É padrão para o nome da máquina, se nenhum nome for especificado.

\--server-description

Descrição personalizada para o Servidor.

**Exemplo:** `rmtadmin register <bootstrap file name and path> --server-name=<server name>`

## rmtadmin restart

Reinicia os aplicativos do Resource Monitoring Tool. Quando executado na máquina em que o RMT Server está instalado, ele reinicia o aplicativo RMT Server. Quando executado em um nó em que o Agente está instalado, ele reinicia apenas o aplicativo do Agente naquele nó específico.

Esse comando pode ser executado no RMT Server e no Agente.

**Observação:** o RMT Server não é compatível com reinicializações de agente remoto. A opção `--agent` só funciona localmente em um nó de agente. Se você tiver vários agentes, deverá executar `rmtadmin restart --agent` (ou `rmtadmin restart`) diretamente em cada máquina host do agente.

### Sinopse

`rmtadmin restart [options] [global option]`

### Opções

Se nenhuma opção for especificada, o comando agirá como se `-all` fosse usada:

**RMT Server:**

\--all

Reinicia todos os serviços.

Reinicia o RMT Server.

\--mq

Reinicia o serviço de fila de mensagens.

\--db

Reinicia o serviço de banco de dados.

**Agente:**

\--agent

Reinicia o serviço do Agente em execução na máquina.

**Exemplo:** `rmtadmin restart --db`

## rmtadmin rotate-mq-certificate

Rotaciona o certificado do cliente da fila de mensagens do Agente na máquina do agente. Execute este comando depois de executar `rmtadmin rotate-mq-certificate` na máquina do Server.

Esse comando precisa ser executado no Agente do RMT.

### Sinopse

`rmtadmin rotate-mq-certificate [options] [positional parameter]`

### Parâmetro de posição

bootstrap

O caminho do arquivo, incluindo o nome do arquivo bootstrap.

### Opções

\--username

Obrigatório. O nome de usuário do servidor primário.

\--password

Obrigatório. Senha da conta de usuário do servidor primário.

\--password-file

Caminho incluindo o nome do arquivo que contém as informações da senha do servidor primário. A senha pode ser fornecida na linha de comando ou em um arquivo que contenha a senha. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.

\--confirm-restart

Confirma a reinicialização do serviço e ignora o prompt de confirmação.

## rmtadmin rotate-mq-certificates

Alterna o servidor da fila de mensagens e os certificados do cliente na máquina do Server.

Esse comando precisa ser executado no RMT Server.

### Sinopse

`rmtadmin rotate-mq-certificates [options]`

### Opções

\--confirm-restart

Confirma a reinicialização do serviço e ignora o prompt de confirmação.

## rmtadmin servers

**Observação:** adicionado na versão 2021.2

Lista todos os nós do Tableau Server em todos os ambientes ou em um ambiente específico.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin servers [positional parameter][global option]`

### Parâmetro de posição

env

Opcional. Especifique o identificador do ambiente para obter uma lista de nós do Tableau Server registrados nesse ambiente. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

## rmtadmin service-setup

**Observação:** adicionado na versão 2021.4. Usado para instalar ou atualizar a credencial do usuário para serviços da Resource Monitoring Tool, incluindo RMT Server, Agente, Rabbit MQ e banco de dados PostgreSQL. Isso é útil para atualizar as informações de serviço pós-instalação.

**Esse comando funciona no RMT Server e no Agente instalado no Windows.**

### Sinopse

`rmtadmin service-setup [positional parameter][options][global option]`

### Parâmetro de posição

Pelo menos um dos valores a seguir deve ser especificado:

Todos

Atualiza todos os serviços disponíveis. Pode ser executado no RMT e no Agente. Quando executado em um nó do Tableau Server, atualiza o Agente nesse nó.

master

Atualiza o RMT Server.

agent

Atualiza o agente. Só pode ser executado no Agente (nó do Tableau Server).

db

Atualiza o serviço de banco de dados. Só pode ser executado no RMT Server.

mq

Atualiza o serviço de fila de mensagens. Só pode ser executado no RMT Server.

### Opções

\--confirm

Opcional. Confirme se deseja fazer atualizações. Pode ser executado no RMT e no Agente. Quando executado em um nó do Tableau Server, atualiza o Agente nesse nó.

\--user-type

Necessário para Servidor e Agente RMT. O tipo de conta usada para executar o Servidor ou Agente RMT. Os valores permitidos são:

- Conta virtual (apenas RMT Server)
- network-service
- local-system
- local-service
- nome de usuário (nome de usuário da conta de usuário local ou de domínio)

\--username

Especifica o nome de usuário da conta. Obrigatório se estiver usando uma conta de usuário local ou de domínio.

\--password

Especifica a senha da conta. Obrigatório se estiver usando uma conta de usuário local ou de domínio.

\--password-file

Opcional. O caminho para a localização do arquivo, incluindo o nome do arquivo em que as informações de senha estão armazenadas.

\--append-permissions

Opcional. Acrescenta novas permissões. Use se não quiser sobrescrever as permissões existentes.

## rmtadmin set

Define o valor da chave de configuração especificada.

**Esse comando funciona no RMT Server e no Agente.**

### Sinopse

`rmtadmin set [positional parameter] [global option]`

### Parâmetro de posição

key

A chave de configuração para a que você deseja alterar o valor.

value

\--master

O novo valor que você deseja usar.

**Exemplo:** `rmtadmin set mq:port <port number>`em que mq:port é a chave, e o <port number> é o valor.

### Chaves de configuração suportadas

<table><colgroup><col><col><col><col><col></colgroup><thead><tr class="header"><th>Chave</th><th>Tipo de dados</th><th>Aplica-se a</th><th>PADRÃO</th><th>Descrição</th></tr></thead><tbody><tr class="even"><td><code>auth:disableLocalAuthentication</code></td><td>Booleano</td><td>RMT Server</td><td>FALSE</td><td>Ao definir isso como true, não é permitido criar um usuário com modo de autenticação local. Adicionado na versão 2024.2</td></tr><tr class="even"><td><code>auth:disableUserManagementUI</code></td><td>Booleano</td><td>RMT Server</td><td>FALSE</td><td>Ao definir isso como true, o gerenciamento de usuários pela interface do usuário não é permitido. Adicionado na versão 2024.2</td></tr><tr class="even"><td><code>db:cleanup:batchSize</code><p>&nbsp;</p></td><td>Inteiro</td><td>RMT Server</td><td>100000</td><td>O número máximo de linhas excluídas por lote durante operações de limpeza de exclusão do PostgreSQL. Aumente esse valor para acelerar a limpeza do banco de dados se você tiver uma instalação muito grande com centenas de milhares ou milhões de linhas obsoletas em seu banco de dados. Adicionado na versão 2025.3.4.</td></tr><tr class="even"><td><code>monitoring:antiDomainLockoutEnabled</code></td><td>Booleano</td><td>RMT Server</td><td>TRUE</td><td>Quando definido como TRUE (o padrão), o recurso de bloqueio antidomínio é habilitado. Adicionado na versão 2025.1.1.</td></tr><tr class="even"><td><code>monitoring:antiDomainLockoutTimeSeconds</code></td><td>Inteiro</td><td>RMT Server</td><td>600</td><td>A duração de tempo pela qual todas as tentativas do Tableau Server serão limitadas antes de tentar a conexão novamente. Adicionado na versão 2025.1.1.</td></tr><tr class="even"><td><code>monitoring:antiDomainMaxFailedLoginAttempts</code></td><td>Inteiro</td><td>RMT Server</td><td>3</td><td>O limite de tentativas consecutivas de logon malsucedidas para ativar o Tableau Server para que o bloqueio antidomínio seja ativado. Adicionado na versão 2025.1.1.</td></tr><tr class="even"><td><code>mq:tls:certificateHostName</code></td><td>Cadeia de caracteres</td><td>RMT Server e Agente</td><td>n/a</td><td>Nome do host no certificado que deve ser usado ao se conectar ao RabbitMQ via TLS</td></tr><tr class="even"><td><code>mq:tls:enabled</code></td><td>Booleano</td><td>RMT Server e Agente</td><td>FALSE</td><td>Ativar/desativar conexão TLS ao RabbitMQ</td></tr><tr class="even"><td><code>mq:port</code></td><td>Inteiro</td><td>RMT Server e Agente</td><td>5672</td><td>Número da porta de host RabbitMQ.</td></tr><tr class="even"><td><code>server:web:responseheader</code></td><td>Cadeia de caracteres</td><td>RMT Server</td><td>&nbsp;</td><td>Defina o valor de um cabeçalho de resposta personalizado específico.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-response-headers.htm" class="xref">Cabeçalhos de resposta do Resource Monitoring Tool do Tableau (RMT)</a></p></td></tr><tr class="even"><td><code>server:web:responseheaders</code></td><td>Cadeia de caracteres</td><td>RMT Server</td><td>&nbsp;</td><td>Defina os valores de múltiplos cabeçalhos de resposta personalizados.<p>Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/rmt-response-headers.htm" class="xref">Cabeçalhos de resposta do Resource Monitoring Tool do Tableau (RMT)</a></p></td></tr><tr class="even"><td><code>server.web.run</code></td><td>Booleano</td><td>Agente</td><td>TRUE</td><td>Ativar ou desativar a interface na Web do Agente.</td></tr></tbody></table>

### Opções

\--backup

Cria um backup do arquivo de configuração, antes de fazer alterações.

Use o comando [get](#heading--get) para exibir o valor da configuração atual.

## rmtadmin start

Inicia os serviços do Resource Monitoring Tool. Quando é executado no RMT Server, inicia o RMT Server somente. Quando executado em um Agente, inicia o Agente na máquina em que você está executando o comando.

Esse comando funciona no RMT Server e no Agente

### Sinopse

`rmtadmin start [options] [global option]`

### Opções

Pelo menos uma opção deve ser especificada:

**RMT Server:**

\--all

Inicia todos os serviços.

\--master

Inicia o RMT Server.

\--mq

Inicia o serviço de fila de mensagens.

\--db

Inicia o serviço de banco de dados.

**Agente:**

\--agent

Inicia o serviço do Agente em execução na máquina.

**Exemplo:** `rmtadmin start --all`

## rmtadmin status

Verifica o status do aplicativo e dos serviços em execução na máquina em que você está executando esse comando. Para o RMT Server, o relatório de status confirma que o RMT Server está conectado ao banco de dados e à fila de mensagens. Para Agentes, o relatório de status confirma que o agente está conectado ao RMT Server.

**Esse comando pode ser executado no RMT Server e no Agente.**

Esse comando retorna o seguinte:

- Status do aplicativo (em execução ou não)
- Status da licença
- Conexão MQ
- Detalhes da fila
- Memória utilizada
- Espaço em disco utilizado
- Versão do Tableau Server na máquina
- Topologia de processo do Tableau Server armazenado no arquivo de configuração do Agente.

A partir da versão 2024.2.0, quando executado no servidor Server, o comando retorna:

- Aviso de uso de espaço em disco se as tabelas de mensagens no banco de dados local estiverem usando mais espaço do que o limite de aviso (4 GB). Para obter mais informações, veja [Solucionar problemas de avisos de uso de disco de tabelas de mensagens](https://help.tableau.com/current/server/pt-br/rmt-troubleshoot-messaging-table-disk-usage-warning.htm)

### Sinopse

`rmtadmin status [global option]`

## rmtadmin stop

Interrompe os serviços do Resource Monitoring Tool. Quando esse comando é executado no RMT Server, ele para somente o RMT Server. Quando executado em uma máquina onde o Agente foi instalado, ele para somente A agente dessa máquina.

**Esse comando pode ser executado no RMT Server e no Agente.**

### Sinopse

`rmtadmin stop [options] [global option]`

### Opções

Pelo menos uma opção deve ser especificada:

**RMT Server:**

\--all

Interrompe todos os serviços.

\--master

Para o RMT Server.

\--mq

Interrompe o serviço de fila de mensagens.

\--db

Interrompe o serviço de banco de dados.

**Agente:**

\--agent

Impede que o serviço do Agente seja executado na máquina.

**Exemplo:** `rmtadmin stop --db`

## rmtadmin test-env

**Observação:** adicionado na versão 2021.2

Testa os vários pontos de conexão entre o Resource Monitoring Tool e o Tableau Server. Isso inclui testar a conexão do Repositório do Tableau Server, as conexões da API do Tableau Server e os recursos de Advanced Management.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin test-env [positional parameter][global option]`

### Parâmetro de posição

\--env

Opcional. O identificador do ambiente que oResource Monitoring Tool está monitorando. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

\--force

Opcional. Use esta opção para atualizar a linha de base imediatamente, mesmo que não haja dados suficientes disponíveis. Por padrão, o comando aguardará 50 carregamentos bem-sucedidos para calcular a linha de base

## rmtadmin update-baseline

**Observação:** adicionado na versão 2021.4.

Atualiza a linha de base para todas as cargas de vista. A linha de base é o 95º percentil de 50 tempos de carregamento inicial bem-sucedidos para uma visualização.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin update-baseline [options][global option]`

### Opções

env

Obrigatório. Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando**Admin** >**Environments** **\>****Edit Environment** . Nesta página, na seção**Environment Details**, você verá o identificador para o ambiente.

## rmtadmin update-env

**Observação:** adicionado na versão 2021.2

Atualiza as configurações do ambiente.

**Esse comando só funciona no RMT Server.**

### Sinopse

`rmtadmin update-env [options][global option]`

### Opções

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 115px;"><col><col style="width: 234px;"></colgroup><thead><tr><th>Opção</th><th>Obrigatório?</th><th>Descrição</th></tr></thead><tbody><tr><td>--non-interactive</td><td><p>Não</p><p></p></td><td>Desativa todos os prompts interativos.</td></tr><tr><td>--no-test</td><td><p>Não</p><p></p></td><td>Desativa o teste de conexões de API e repositório.</td></tr><tr><td>--name</td><td>Sim</td><td>O nome do ambiente.</td></tr><tr><td>--id</td><td>Não</td><td>Identificador do ambiente usado em URLs de interface da Web. <p>Este é o identificador gerado pelo sistema. Você pode encontrar isso acessando<b>Admin</b> &gt;<b>Environments</b> <b>&gt;</b><b>Edit Environment</b> . Nesta página, na seção<b>Environment Details</b>, você verá o identificador para o ambiente.</p></td></tr><tr><td>--gateway-url</td><td><p>Não</p><p>&nbsp;</p></td><td><p>URL usado para acessar o gateway do Tableau Server.</p></td></tr><tr><td>--version</td><td>Não</td><td>Versão do Tableau Server que este ambiente monitorará.</td></tr><tr><td>--api-username</td><td>Não</td><td>Nome de usuário da conta usada para se conectar às APIs do Tableau Server. A conta de usuário deve ser um administrador do Tableau Server com acesso a todos os sites do Tableau Server.</td></tr><tr><td>--api-password</td><td>Não</td><td><p>Senha da conta de usuário da API do Tableau Server usada para se conectar às APIs do Tableau Server.</p></td></tr><tr><td>--api-password-file</td><td>Não</td><td>O caminho para o arquivo que contém a senha da conta de usuário da API do Tableau Server.</td></tr><tr><td>--repository-server</td><td>Não</td><td>É o nome do servidor para o banco de dados PostgreSQL que está instalado com o <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span>.</td></tr><tr><td>--repository-port</td><td>Não</td><td>O número da porta do aplicativo do banco de dados do Repositório do Tableau Server.</td></tr><tr><td>--repository-username</td><td>Não</td><td><p>Nome de usuário usado para se conectar ao banco de dados PostgreSQL instalado com o Repositório do Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password</td><td>Não</td><td><p>Senha para a conta de usuário usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</p><p>O <span class="mc-variable Variables.PT_server variable">Resource Monitoring Tool</span> acessa o banco de dados do Repositório do Tableau Server diretamente, por motivos de desempenho. Para que isso funcione, o acesso ao repositório deve ser habilitado, com uma senha definida para o usuário do banco de dados <b>readonly</b> (somente leitura). Para obter detalhes, consulte <a href="https://help.tableau.com/current/server/pt-br/perf_collect_server_repo.htm#Get" class="xref">Habilitar o acesso ao repositório do Tableau Server</a>.</p></td></tr><tr><td>--repository-password</td><td>Não</td><td>O caminho incluindo o nome do arquivo onde a senha da conta do usuário é usada para se conectar ao banco de dados PostgreSQL instalado com o Tableau Server.</td></tr><tr><td>--repository-ssl-mode</td><td><p>Não</p></td><td><p>Modo SSL do repositório do Tableau Server:</p><p><b>Prefira</b> SSL ou <b>Exija</b> SSL para configurar conexões SSL para o repositório do Tableau.</p><p><b>Desative</b> para nunca usar SSL para fazer conexões de Repositório do Tableau Server.</p></td></tr><tr><td>--repository-ssl-thumbprint</td><td><p>Não</p></td><td>Ao configurar o Tableau Server PostgreSQL para permitir conexões diretas, o Tableau Server cria um certificado e chaves. Você pode optar por fornecer a impressão digital para o certificado gerada pelo Tableau Server ou copiar o arquivo <b>server.crt</b> para a máquina do RMT Server da Resource Monitoring Tool. Se você optar por copiar o arquivo de certificado, não precisará fornecer a impressão digital. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/ssl_config_direct_cx.htm" class="xref">Configurar Postgres SSL para permitir conexões diretas de clientes</a>.</td></tr></tbody></table>

**Exemplo:**`rmtadmin update-env --name=<new name>`

## rmtadmin users

Mostra uma lista das contas de usuário do Resource Monitoring Tool.

Esse comando só funciona no RMT Server.

### Sinopse

`rmtadmin users`

## rmtadmin version

Mostra as informações atuais da versão do RMT Server quando executado na máquina do RMT Server. Mostra as informações atuais da versão do Agente instalado na máquina em que você está executando o comando.

**Esse comando pode ser executado no RMT Server e no Agente.**

### Sinopse

`rmtadmin version`

## rmtadmin ziplogs

Cria um arquivo de ZIP contendo os arquivo de registro do Resource Monitoring Tool.

**Esse comando funciona no RMT Server e no Agente, mas inclui apenas os arquivos de registro do aplicativo em que o comando é executado.**

### Sinopse

`rmtadmin ziplogs [positional parameter] [option] [global option]`

### Parâmetro de posição

filename

Nome do arquivo zip de saída. Padrão para log.zip, se nenhum nome for fornecido.

### Opção

\--force

Substitui o arquivo existente.

**Exemplo:** `rmtadmin ziplogs <zip file name> --force`

## Opção global

\--help

Mostra a ajuda do comando.

<!-- document id=5b9a93ce0c405c10a1786bf6e64b1e478d4d854a8cdbf2d1cf2eede6addb6621 url=/tableau/current/pt-br/server/cmt-command_line.md -->

[Pular para o conteúdo principal](#main-content)

# Utilização da interface de linha de comando do Content Migration Tool do Tableau

O Content Migration Tool do Tableau inclui uma interface de linha de comando, `tabcmt.cmd`, localizada na pasta de instalação. A pasta de instalação padrão é `%PROGRAMFILES%\Tableau\Tableau Content Migration Tool` (Windows de 32 bits) ou `%PROGRAMFILES(x86)%\Tableau\Tableau Content Migration Tool`(Windows de 64 bits).

**Observação:** o utilitário `tabcmt.cmd` não é o mesmo do executor do console do Content Migration Tool, `tabcmt-runner.exe`. O executor do console é um utilitário de linha de comando separado, usado para executar migrações da linha de comando. Para obter informações sobre como usar o executor do console do Content Migration Tool, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).

Aqui estão os comandos que podem ser usados com a linha de comando `tabcmt`:

- [migrar](#migrate)
- [help](#help)
- [update](#update)
- [version](#version)

## migrar

Abre um arquivo de plano de migração na etapa de migração na GUI:

tabcmt migrate <plan file>

## help

Mostra a ajuda geral sobre a interface da linha de comando e os comandos disponíveis.

### Exemplos

Mostra todos os comandos disponíveis:

tabcmt help

Mostra a ajuda e a utilização de um comando específico:

tabcmt help <command>

## license

Obsoleto em julho de 2022.

Este comando é aplicável somente para licenças herdadas. Gerencia a licença do aplicativo do usuário atual.

### Exemplos

Mostra as informações da licença atual:

tabcmt license

Remove/desativa a licença atual:

edt license remove

Define/ativa uma chave de série ou uma chave de licença off-line:

tabcmt license <key>

Define/ativa usando um arquivo de licença:

tabcmt license <file path> \[--passphrase=<password>\]

## update

Gerencia as opções de atualizações de aplicativos.

### Exemplos

Mostra as configurações de atualização atuais:

tabcmt update

Habilita ou desabilita as notificações automáticas de atualização:

tabcmt update --disabled=<true|false>

Configura a URL para detectar/baixar atualizações de:

tabcmt update --url=<url>

Habilita ou desabilita a exibição de atualizações beta. Define como falso para mostrar somente atualizações de versão estáveis.

tabcmt update --beta=<true|false>

## version

Mostra as informações de versão da versão atual do aplicativo.

tabcmt version

## Quem pode fazer isso

Para usar a interface de linha de comando, você deve ter o seguinte:

- Permissões de administrador na máquina Content Migration Tool.
- Uma conta de usuário do site do Tableau com uma função Explorer (Explorador) ou superior.
- Permissões Exibir e baixar pasta de trabalho/Salvar uma cópia no site de origem.
- Direitos de publicação no site de destino.

<!-- document id=d63a17cebd7c5e3fb27e54d7f3b28226cf2f934003718fe7137eea63056d4634 url=/tableau/current/pt-br/server/server-upgrade-blue-green.md -->

[Pular para o conteúdo principal](#main-content)

# Utilização de uma abordagem azul/verde para atualizar o Tableau Server

Embora muitas organizações sejam bem atendidas pela realização de uma atualização local do Tableau Server, outras organizações com uso de missão crítica do Tableau podem querer uma abordagem de atualização de nível empresarial mais eficiente que use investimentos de esforço e recursos adicionais para reduzir o risco e impacto. Nesses casos, a Tableau recomenda uma abordagem de atualização “Azul/Verde” para atingir esse resultado, caracterizada por:

- Implantação confiável de aplicativos em um ambiente de não produção host recém-configurado (versus uma atualização local)
- Realização de testes de pré-produção da nova versão em seu ambiente de não produção para validar funcionalidades críticas para os negócios, incluindo testes de casos de uso comuns para detectar mudanças de comportamento que podem afetar a organização
- Teste em ambientes de produção idênticos para validar integrações e requisitos de recursos
- A capacidade de reverter para a versão anterior rapidamente

Esta orientação de alto nível descreve uma abordagem Azul/Verde para atualizações que foram usadas com sucesso por muitos de nossos maiores clientes para atualizar o Tableau Server (e outros aplicativos de missão crítica) com confiança. As atualizações Azul/Verde são uma [prática do setor](https://martinfowler.com/bliki/BlueGreenDeployment.html "\"BlueGreenDeployment\" de Martin Fowler") há muito estabelecida; existem muitas variações e as etapas específicas abaixo são um caminho possível. Se você está procurando orientação específica sobre como personalizar essa abordagem para a próxima atualização da organização, converse com seu gerente de conta técnico de suporte Premium ou discuta um contrato de serviços com seu executivo de conta ou parceiro de entrega.

A abordagem Azul/Verde envolve a instalação de uma nova versão do Tableau Server em um ambiente de não produção (sua instalação “Verde”) que espelha a configuração do seu ambiente de produção existente (sua instalação “Azul”). Para fins de sua licença do Tableau, observe que o Tableau concede um direito padrão a dois (2) ambientes de não produção para dar suporte ao único ambiente de produção em sua implantação, conforme descrito no contrato de licença aplicável. Esses ambientes de não produção devem poder ser retirados e usados para este método consistente com o uso pretendido de um ambiente de teste, conforme descrito neste artigo da Base de conhecimento do Tableau: [Licenciamento de um ambiente de teste do Tableau Server](https://kb.tableau.com/articles/howto/test-environment-license?lang=pt-br).

Ao copiar seu conteúdo do ambiente de produção para a instalação Verde em seu ambiente de não produção (por exemplo, seu ambiente de teste), você pode criar uma instância atualizada do Tableau Server com tempo de inatividade mínimo e a rede de segurança de ter a instalação de produção original para retornar, se necessário. Depois de determinar que todo o seu conteúdo crítico no ambiente Verde é funcional, mude seus usuários para o novo ambiente (Verde). Seu ambiente Verde se torna seu ambiente de produção e sua instalação original (ambiente Azul) pode ser mantida como um ambiente de não produção para dar suporte à sua próxima atualização.

O que se segue é um esboço de alto nível das etapas necessárias para usar Azul/Verde como uma abordagem para atualizar o Tableau Server. Isso pressupõe que você tenha um balanceador de carga ou DNS que permite redirecionar o tráfego do usuário de uma instalação para outra e que baixou a nova versão do Tableau para a qual deseja atualizar.

**Importante:** suas instalações Azul/Verde devem ser tratadas como ambientes de produção. Elas não devem servir como ambientes de recuperação de desastres ou testes gerais. Para obter mais detalhes sobre a recuperação de desastres, consulte [Recuperação de desastres](https://help.tableau.com/current/blueprint/pt-br/bp_hardware_platform.htm#disaster-recovery) no Tableau Blueprint.

1. Crie uma segunda instalação de servidores que espelhe sua instalação de produção do Tableau Server o mais próximo possível. Esse segundo ambiente é a sua instalação Verde, um ambiente de não produção. Ele deve ter capacidade, recursos e configuração semelhantes aos do ambiente de produção (“Azul”), pois a instância Verde se tornará a instância de produção após a atualização.
2. Crie um backup inicial e exporte as configurações da instalação do Tableau Server Azul. Você usará isso para o teste de aceitação inicial do usuário (UAT) em verde. Posteriormente, você criará um backup e uma exportação finais e atualizados para usar ao mudar de azul para verde.
    
    1. Backup: para obter detalhes sobre a criação de backup, consulte [Fazer backup dos dados do Tableau Server](https://help.tableau.com/current/server/pt-br/db_backup.htm).
    2. Exportação de configurações: juntamente com um backup, você também precisará exportar as configurações da instalação do Azul. Algumas configurações precisarão ser recriadas manualmente no ambiente Verde. Para obter mais informações, consulte [Ativos de backup que necessitam de processo manual](https://help.tableau.com/current/server/pt-br/backup_restore.htm#Backup2)
3. Instale a nova versão do Tableau Server em Verde. Você deve especificar o mesmo tipo de armazenamento de identidade e conta de serviço Run As que usa no Azul.
4. Use o backup inicial do Azul e a exportação de configurações para atualizar a instalação do Verde.
    
    1. Restaure o backup do ambiente Azul na instalação Verde.
    2. Importe as configurações que você exportou da instalação do Azul. O arquivo .json que você exportou nem sempre pode ser importado diretamente. Você provavelmente precisará editar ou remover a seção. Espere fazer mais alterações manuais entre as atualizações de versão principais. Por exemplo, as informações de topologia podem estar incompletas e resultar em uma configuração não funcional do Tableau Server. Consulte [Restauração de uma funcionalidade do núcleo do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm#Restorin).
5. Desative todas as tarefas agendadas em Verde para evitar o envio de mensagens duplicadas durante o teste e não sobrecarregar os recursos do banco de dados. Para obter detalhes, consulte [Atualização do servidor - Desabilitar as tarefas agendadas](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-disable-tasks.htm) .
6. Teste a instalação do Verde para confirmar se está funcionando conforme o esperado. Execute o Teste de Aceitação do Usuário (UAT) e simule qualquer teste de carga, se desejado. Se você tiver scripts ou integração de API com o Tableau, também deve testá-los. Quanto mais completo for o teste, melhor preparado você estará para lidar com quaisquer discrepâncias entre a instalação original Azul e a nova instalação Verde.
7. Prepare a instalação Azul para que você possa criar um backup e exportar as configurações que usará para produção Verde. Isso pode significar restringir o acesso ao Tableau ou enviar uma mensagem instruindo os usuários a não fazerem alterações em seu conteúdo e avisando-os de que todas as alterações feitas após a criação do backup serão perdidas.
8. Crie um backup final da Azul. Este é o backup que você usará para trazer a Verde ao conteúdo de produção mais recente. Se você faz backups regulares, pode usar o backup de produção mais recente, tendo em mente que quaisquer alterações ou atualizações feitas na Azul após a criação do backup serão perdidas. Recomendamos um “congelamento de alterações” em seu ambiente de produção após a realização desse backup, para que nenhuma nova pasta de trabalho ou fonte de dados seja adicionada e não haja alterações no conteúdo existente.
9. Exporte as configurações no ambiente Azul, prestando atenção aos ativos que você pode precisar manipular manualmente. Para obter Mais informações, consulte [Restauração de uma funcionalidade do núcleo do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm#Restorin).
10. Restaure o backup final do Azul e importe o arquivo de configurações do Azul para o Verde. Faça todas as alterações manuais de configuração necessárias.
11. Execute UAT/verificações de integridade de conteúdo Verde.
12. Reative agendamentos para quaisquer trabalhos, assinaturas e notificações que você desabilitou na Etapa 5 acima.
13. Mude seus usuários para Verde usando um balanceador de carga ou DNS e bloqueie o acesso para Azul.
14. Verifique se o servidor Azul está funcionando conforme desejado e monitore os problemas de carga de produção. Se você tiver Advanced Management, poderá usar a Resource Monitoring Tool para monitorar o desempenho.
15. (Opcional) Se você não estiver mantendo seu ambiente Azul para atualizações futuras, desative as chaves de produto do ambiente Azul:
    
    - Para o Tableau Server 2021.4 e posterior ativado com ATR, consulte [Desativar a chave do produto](https://help.tableau.com/current/server/pt-br/license_deactivate.htm).
    - Para qualquer versão do Tableau Server não ativada com ATR, consulte [Desativar a chave do produto](https://help.tableau.com/current/server/pt-br/license_deactivate.htm).
    - Para o Tableau Server 2021.3 e anteriores ativados com ATR, consulte [Mover uma licença ATR de servidor para outro Tableau Server](https://help.tableau.com/v2021.3/server/pt-br/atr_service.htm#move-a-server-atr-license-to-another-tableau-server).
16. (Opcional) Se você não estiver mantendo seu ambiente Azul para atualizações futuras,pare-o e prepare-o para descomissionamento. Para obter detalhes sobre a desativação, consulte [Remover o Tableau Server do computador](https://help.tableau.com/current/server/pt-br/remove_tableau.htm).

<!-- document id=76515edce4db0454cc109fccc0e2cd8d39609e4388d48590713c82038433d537 url=/tableau/current/pt-br/server/cmt-deployment_console_runner.md -->

[Pular para o conteúdo principal](#main-content)

# Utilização do Runner de console Content Migration Tool do Tableau

O Content Migration Tool do Tableau inclui um utilitário de linha de comando para a execução de migrações, `tabcmt-runner.exe`, localizado na pasta de instalação. A pasta de instalação padrão é: `%PROGRAMFILES%\Tableau\Tableau Content Migration Tool`.

**Observação:** o utilitário `tabcmt-runner.exe` não é o mesmo da linha de comando `tabcmt.cmd` utilizado para configurar o aplicativo gráfico do Content Migration Tool. Para obter mais informações sobre o `tabcmt.cmd`, consulte [Utilização da interface de linha de comando do Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-command_line.htm).

Uso:

- tabcmt-runner \[options\] <plan\_file.tcmx>
- tabcmt-runner license --remove
- tabcmt-runner license <new license key>
- tabcmt-runner license <license file path> \[--passphrase=<license file passphrase>\]
- tabcmt-runner encryption --reset
- tabcmt-runner encryption <new\_key>
- tabcmt-runner improvement \[on|off\]
- tabcmt-runner --help
- tabcmt-runner --version
- tabcmt-runner script-warning \[on|off\]

Opções:

- \--version
- \--help
- \--quiet
- \--info
- \--logfile=VALUE
- \--src-user=VALUE
- \--src-password=VALUE
- \--dest-user=VALUE
- \--dest-password=VALUE
- \--https=VALUE
- \--allow-scripts

## Run Plan

Executa um plano de migração imediatamente.

tabcmt-runner \[options\] <plan file>

### Opções disponíveis:

- `--logfile=<file name>` define o nome do arquivo como saída de log para
- `--https=<secure|legacy>` define o modo HTTPS
- `--quiet` desabilita o registro em log para stdout
- `--src-user=<username>` define o nome de usuário da conexão de origem
- `--src-password=<password>` define a senha da conexão de origem
- `--dest-user=<username>` define o nome de usuário da conexão de destino
- `--dest-password=<password>` define a senha da conexão de destino

### Códigos de saída:

- 0 indica que a migração foi bem-sucedida.
- 1 indica que a migração foi bem-sucedida, mas as mensagens de aviso foram registradas.
- 2 indica que a migração falhou. Erros específicos serão incluídos na saída do log.

## Show Plan Summary

Mostra um resumo do plano de migração e depois sai.

tabcmt-runner --info <plan file>

### help

Mostra as informações de uso do utilitário da linha de comando.

tabcmt-runner --help

### version

Mostra as informações de versão da versão atual do aplicativo.

tabcmt-runner --version

### encryption

Redefine a chave de criptografia ou especifica uma nova. Especifique a chave de criptografia antes de usar o utilitário `tabcmt-runner`, mesmo que já tenha feito isso a partir da interface do usuário da Content Migration Tool.

tabcmt-runner encryption <new\_key> | --reset

### improvement

Valor padrão: `on`

Habilita ou desabilita a coleta de informações de uso anônimas pelo aplicativo. Essas informações são completamente anônimas e são enviadas periodicamente para o Tableau para nos ajudar a melhorar o Content Migration Tool.

#### Exemplos

Mostra se o programa de melhoria está habilitado ou desabilitado:

tabcmt-runner improvement

Habilita ou desabilita o programa de melhoria:

tabcmt-runner improvement <on|off>

### license

Obsoleto em julho de 2022.

Este comando é aplicável somente para licenças herdadas. Gerencia uma licença antiga do aplicativo do usuário atual. Ao usar uma chave herdada, para usar o utilitário `tabcmt-runner`, você deve ativar a licença usando esse comando, mesmo que o tenha ativado a partir da interface do usuário da Content Migration Tool.

#### Exemplos

Mostra as informações da licença atual:

tabcmt-runner license

Define/ativa uma chave de série ou uma chave de licença off-line:

tabcmt-runner license <key>

Remove/desativa a licença atual:

tabcmt-runner license --remove

Define/ativa usando um arquivo de licença:

tabcmt-runner license <file path> \[--passphrase=<password>\]

### script-warning

Valor padrão: `on`

Mostra uma mensagem de aviso ao executar um plano de migração que inclui scripts de migração.

**Observação:** este comando atualiza sua seleção na página Configurações. Para obter mais informações, consulte [Configurações do Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-settings.htm).

#### Exemplos

Mostra se o aviso de script está ativado ou desativado.

tabcmd-runner script-warning

Ativar ou desativar o aviso de script

tabcmd-runner script-warning <on|off>

Se ativado, você deve incluir a opção`--allow-scripts` para executar planos de migração.

tabcmd-runner --allow-scripts <plan file>

## Quem pode fazer isso

Para usar o executor de console, você deve ter o seguinte:

- Permissões de administrador na máquina Content Migration Tool.
- Uma conta de usuário do site do Tableau com uma função Explorer (Explorador) ou superior.
- Permissões Exibir e baixar pasta de trabalho/Salvar uma cópia no site de origem.
- Direitos de publicação no site de destino.

## Outros artigos nesta seção

<!-- document id=62fc616311e58d23794296da487744cd824e677396caf73853d31a47eb980918 url=/tableau/current/pt-br/server/trusted_auth_trouble_1return.md -->

[Pular para o conteúdo principal](#main-content)

# Valor de ticket -1 retornado pelo Tableau Server

O Tableau Server retornará -1 para o valor do ticket se ele não puder emitir o ticket como parte do processo de autenticação confiável. Antes de solucionar problemas neste cenário, certifique-se de configurar o nível de log de autenticação confiável para `debug`, conforme especificado em [Solucionar problemas de autenticação confiável](https://help.tableau.com/current/server/pt-br/trusted_auth_trouble.htm).

O motivo exato dessa mensagem está gravado nos arquivos `vizqlserver_node*-*.log.*` na seguinte pasta:

`ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizqlserver`

Estes são alguns fatores a serem confirmados:

- **Todos os nomes de host do servidor Web ou endereços IP são adicionados a hosts confiáveis**
    
    O erro de log, "`Invalid request host: <ip_address>`" pode indicar que o endereço IP ou nome de host do computador que envia a solicitação POST não está na lista de hosts confiáveis no Tableau Server. Consulte [Adicionar endereços IP confiáveis ou nomes de host ao Tableau Server](https://help.tableau.com/current/server/pt-br/trusted_auth_trustIP.htm) para saber como adicionar endereços IP ou nomes de host a essa lista.
- **Endereços IP são IPv4**
    
    Caso você esteja usando endereços IP para especificar hosts confiáveis, eles devem estar no formato do protocolo IP versão 4 (IPv4). Um endereço IPv4 será semelhante a isto: 123.456.7.890. Os endereços IPv6 (por exemplo, fe12::3c4a:5eab:6789:01c%34) não são compatíveis como forma de inserir hosts confiáveis.
- **O nome de usuário na solicitação POST é um usuário válido do Tableau Server**
    
    O nome de usuário enviado na solicitação POST deve ser um usuário licenciado do Tableau Server. Veja uma lista de usuários que fazem logon no Tableau Server como administrador.
    
    Os seguintes erros de log indicam um problema POST do usuário:
    
    - "`Missing username and/or client_ip` "
    - "`Invalid user: <username>` "
    - "`Unlicensed user is not allowed: <username>` "
    
    **O nome de usuário na solicitação POST inclui o domínio**
    
    Se o Tableau Server for configurado para usar a Autenticação local, o nome de usuário enviado na solicitação POST pode ser uma cadeia de caracteres simples. No entanto, se o servidor for configurado para o Active Directory, é obrigatório incluir o nome de domínio com o nome de usuário (domínio\\nome de usuário). Por exemplo, o parâmetro de nome de usuário pode ser: `username=dev\jsmith`. Um erro de log usual para este cenário é "`Invalid user: <username>`".
- **Content-Type é especificado**
    
    Ao projetar um aplicativo ASP.NET ou C#, é necessário declarar o tipo de conteúdo na solicitação HTTP. Por exemplo:
    
    `http.setRequestHeader("Content-Type","application/x-www-form-urlencoded;charset=UTF-8")`
    
    Se você não especificar o tipo de conteúdo e o Tableau Server retornar um -1, os arquivos de log conterão o erro: "`missing username and/or client_ip`".

<!-- document id=968d0470a0ad8711550b20d33e53319564beda1a453e5dfefdcd9f7aeb37b113 url=/tableau/current/pt-br/server/adminview_desktop_license_expiration.md -->

[Pular para o conteúdo principal](#main-content)

# Vencimento da licença do Desktop

**Observação:** esta exibição só está disponível para administradores de servidor. Para acessar exibições de servidor em implantações de vários sites, clique no menu do site e selecione **Gerenciar todos os sites**. Para obter informações sobre como navegar em exibições administrativas, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

A exibição Vencimento da licença do Desktop apresenta informações sobre quais licenças do Tableau Desktop na sua organização venceram ou precisam de renovação de manutenção. Isso pode ajudar você a gerenciar as licenças de modo eficiente. Essa exibição pode ajudá-lo a responder às seguintes perguntas:

- Quais chaves de licença expiraram?
- Quais licenças infinitas estão com manutenção expirada?
- Quais licenças infinitas estão com renovação de manutenção próxima?

Para renovar uma licença ou obter informações adicionais de renovação, consulte [Como renovar suas licenças do Tableau](https://www.tableau.com/pt-br/support/renew).

**Observação:** para obter dados sobre licenças, cada cópia do Tableau Desktop precisa ser configurada para enviar dados para Tableau Server. Essa configuração pode ser feita no momento da instalação, usando scripts ou software de terceiros para instalar e configurar o Tableau. Para obter mais informações, consulte [Configurar relatórios de licenciamento do Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_reporting_admin.htm).  
  
Para exibir os dados de licença de exibição, a opção Relatórios de licenciamento do Desktop deve estar habilitada no Tableau Server. Consulte [Habilitar e configurar relatórios de licenciamento do Desktop](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_reporting_admin.htm#enable).

Filtros:

- **Chaves de produto**—Digite uma string para filtrar o painel para apenas as licenças que incluam a string. Por exemplo, para ver apenas as licenças que começam com TDTD, digite TDTD e pressione enter para filtrar a exibição. Clique no "x" depois da string para redefinir o filtro.
- **Departamento**—Use esse filtro para controlar de quais departamentos o painel exibe as licenças. O filtro é preenchido com base nos valores de Departamento usados durante o registro de cópias do Tableau Desktop.
- **Duração de tempo**—Use esse filtro para controlar a duração pela qual o painel exibe as informações.

A exibição inclui as seguintes tabelas, que são afetadas pelos filtros definidos por você na parte superior da exibição:

- Quais chaves estão com a manutenção vencida — Esta tabela mostra as chaves de produto para as quais a manutenção venceu, com uma linha vertical que indica o ponto no qual a janela de seis meses para renovação de manutenção se fecha. Se a manutenção de uma chave estiver vencida há mais de seis meses, você precisará comprar uma nova chave para se qualificar para suporte ou upgrades.
- **Quais chaves de licença expiraram** — Mostra as chaves do produto que expiraram.
- Qual é o cronograma de manutenção das minhas chaves — Mostra as chaves e seu status de manutenção.

<!-- document id=9723ac4f0af06cf785324a0c3099fbf94643966f9a0f96a808770a5f049c4f04 url=/tableau/current/pt-br/server/trusted_auth_webURL.md -->

[Pular para o conteúdo principal](#main-content)

# Ver a exibição com o ticket

Depois de [criar a solicitação POST](https://help.tableau.com/current/server/pt-br/trusted_auth_webrequ.htm), você deverá gravar o código que fornece ao servidor Web o local da exibição e o ticket do Tableau Server. Ele usará essas informações para mostrar a exibição. A maneira como você especifica isso depende se a exibição é inserida e se o Tableau Server está executando vários sites.

**Observação:** os tíquetes confiáveis devem ser resgatados para exibições. Depois que uma sessão é criada, os usuários autenticados com tíquetes confiáveis têm acesso às exibições somente por padrão. Eles não podem acessar pastas de trabalho, páginas de projeto ou outro conteúdo hospedado no servidor. Esse padrão pode ser alterado usando a opção tsm `wgserver.unrestricted_ticket`.

## Exemplos de exibição do Tableau Server

Este é um exemplo de como especificar uma exibição que os usuários acessam somente via Tableau Server (a exibição não é inserida):

http://<server\_name>/trusted/<unique\_ticket>/views/<workbook\_name>/<view\_name> 

Se o Tableau Server estiver executando [vários sites](https://help.tableau.com/current/server/pt-br/sites.htm) e a exibição estiver em um site diferente do site Padrão, você precisará adicionar `t/<site_id>` ao caminho. Por exemplo:

http://<server\_name/trusted/<unique\_ticket>/t/Sales/views/<workbook\_name>/<view\_name> 

Use a mesma capitalização vista por você na URL do Tableau Server.

## Exemplos de exibição inserida

Estes são alguns exemplos de como especificar exibições inseridas. Como há duas abordagens que você pode adotar para o código inserido, as duas maneiras são descritas abaixo. Independentemente do que for usado, haverá algumas informações exclusivas da autenticação confiável que você deverá fornecer. Para obter mais informações, consulte [Escrever código inserido](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#embed_code.htm).

**Observação:** os exemplos a seguir usam parâmetros de código inserido. Para obter mais informações, consulte [Parâmetros de código inserido](https://help.tableau.com/current/pro/desktop/pt-br/help.htm#embed_list.htm) na Ajuda do Tableau.

### Exemplos de marca de script

**Parâmetro de tíquete**

Este exemplo usa o parâmetro do objeto `ticket`:

<script type="text/javascript" src="http://myserver/javascripts/api/viz\_v1.js"></script> 
<object class="tableauViz" width="800" height="600" style="display:none;"> 
    <param name="name" value="MyCoSales/SalesScoreCard" /> 
    <param name="ticket" value="9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5" /> 
</object> 

Aqui está como o exemplo acima ficaria em um Tableau Server com vários sites, onde a exibição está publicada no site `Sales`:

<script type="text/javascript" src="http://myserver/javascripts/api/viz\_v1.js"></script> 
<object class="tableauViz" width="800" height="600" style="display:none;"> 
    <param name="site\_root" value="/t/Sales" /> 
    <param name="name" value="MyCoSales/SalesScoreCard" /> 
    <param name="ticket" value="9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5" /> 
</object> 

**Parâmetro de caminho**

Em vez de usar `ticket`, você pode usar o parâmetro `path` para indicar explicitamente o caminho completo da exibição. Quando `path` é usado, você também não precisa do parâmetro `name`, que é geralmente um parâmetro obrigatório no código inserido do Tableau JavaScript:

<script type="text/javascript" src="http://myserver/javascripts/api/viz\_v1.js"></script> 
<object class="tableauViz" width="900" height="700" style="display:none;"> 
    <param name="path" value="trusted/9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5/views/MyCoSales/SalesScoreCard" /> 
</object> 

Este é o mesmo exemplo, só que para um servidor com vários sites. Observe que `/t/<site_id>` é usado aqui:

<script type="text/javascript" src="http://myserver/javascripts/api/viz\_v1.js"></script> 
<object class="tableauViz" width="900" height="700" style="display:none;"> 
     <param name="path" value="trusted/9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5/t/Sales/views/MyCoSales/SalesScoreCard" /> 
</object> 

### Exemplo de marca iFrame

<iframe src="http://tabserver/trusted/9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5/views/workbookQ4/SalesQ4?:embed=yes" width="800" height="600"></iframe>

<!-- document id=fe688dbc816c4cb5a99452c92b221310813a54434c07b71175f06c17efa59611 url=/tableau/current/pt-br/server/server_preflight_check.md -->

[Pular para o conteúdo principal](#main-content)

# Verificação de simulação do Tableau

Introduzida na versão 2020.3.0 do Tableau Server no Windows, a verificação de simulação (PFC) faz verificações básicas das configurações do sistema principal para ajudar a evitar problemas comuns de instalação e atualização.

- Instalação — Durante a instalação do Tableau Server no Windows, uma verificação das permissões no diretório de instalação e no diretório de dados é feita. Se essa verificação determinar que as permissões não são adequadas para que o Tableau Server seja executado com sucesso, a instalação não falhará, mas quaisquer erros serão registrados no registro do Controlador de Administração.
- Atualização — Durante a atualização do Tableau Server no Windows, quando você executa o script `upgrade-tsm.cmd`, são feitas verificações de permissões na instalação e nos diretórios de dados, juntamente com a verificação de disponibilidade das portas necessárias para serviços específicos. Quaisquer problemas de permissões são registrados no `app-upgrade.log`, mas não bloqueiam a atualização. Os conflitos de porta interrompem o processo de atualização antes do início da inicialização, permitindo que você corrija o problema. Como isso acontece _antes_ da inicialização da nova versão, você pode continuar a usar sua versão existente enquanto investiga o problema e, em seguida, reexecutar o script `upgrade-tsm`.

## comandos tsm de verificação de simulação

Dois comandos tsm lhe dão a capacidade de verificar permissões e portas antes de executar uma atualização e corrigir quaisquer problemas:

`[tsm maintenance preflight-check permissions](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmmaintenance_preflight_perms)`

`[tsm maintenance preflight-check ports](https://help.tableau.com/current/server/pt-br/cli_maintenance_tsm.htm#tsmmaintenance_preflight_ports)`

<!-- document id=ebcb7f8cab852fd18990e7e79c2aba4c726effba25d8f5d879024d2b5d5222ef url=/tableau/current/pt-br/server/datasource_wdc_vetting.md -->

[Pular para o conteúdo principal](#main-content)

# Teste e verificação dos conectores de dados da Web

Os conectores de dados da Web (WDCs) contêm JavaScript, que normalmente se conecta aos dados em outro site. Por isso, os conectores de dados da Web precisam ser testados e verificados antes de serem usados no Tableau Server e pelos usuários como fontes de dados de uma pasta de trabalho.

Este tópico inclui algumas sugestões para o teste e verificação dos conectores de dados da Web.

## Examine a origem

O código em um conector de dados da Web está em JavaScript, assim é possível abrir o arquivo (e qualquer arquivo externo usado pelo conector) e examinar o código-fonte.

Muitos conectores fazem referência a bibliotecas JavaScript externas, como a biblioteca jQuery ou as bibliotecas de API para terceiros. Valide que a URL das bibliotecas externas aponta para um local confiável da biblioteca. Por exemplo, se o conector fizer referência à biblioteca jQuery, certifique-se de que ela esteja em um site que é considerado padrão e seguro. Se for prático alterar o código-fonte do conector, utilize o protocolo HTTPS ( (`https://`) para fazer referência às bibliotecas externas (se o site de origem suportar HTTPS) para ajudar a verificar a autenticidade do site.

Na medida do possível, tente entender o que o código está fazendo. Em particular, tente entender como o código está criando solicitações para os sites externos e quais informações são enviadas na solicitação.

**Observação**: os programadores de JavaScript experientes, muitas vezes, comprimem (diminuem) o código para reduzir o tamanho do download. Blocos densos de códigos que usam nomes crípiticos de função e variáveis não são incomuns. Embora isto possa dificultar a verificação do código, isso não significa que ele foi escrito para ser deliberadamente difícil de entender.

## Teste o conector de dados da Web em um ambiente isolado

Se for possível, teste o conector de dados da Web em um ambiente que seja isolado do seu ambiente de produção e de computadores de usuário. Por exemplo, adicione um conector de dados da Web a uma lista segura em um computador de teste ou máquina virtual que esteja executando uma versão do Tableau Server que não é usada para a produção.

## Monitore do tráfego criado pelo conector

Ao testar um conector de dados da Web, use uma ferramenta como [Fiddler](http://www.telerik.com/fiddler), [Charles HTTP proxy](http://www.charlesproxy.com/) ou [Wireshark](https://www.wireshark.org/) para examinar as solicitações e respostas feitas pelo conector. Tente entender para quais sites o conector faz as solicitações e qual é o conteúdo solicitado. Da mesma forma, analise as respostas e seu conteúdo para garantir que o conector não esteja lendo os dados ou o código que não são diretamente relacionados à finalidade do conector.

## Teste o desempenho e o uso do recurso do conector de dados da Web

Ao testar um conector de dados da Web, use as ferramentas para monitorar o uso de memória e de CPU. Lembre-se de que o conector de dados da Web será executado no Tableau Server, que é um ambiente no qual muitos processos já estão sendo executados. Você quer ter certeza de que, quando o conector buscar os dados, ele não causará nenhum impacto no desempenho do servidor.

Verifique se o conector grava no disco. Se gravar, verifique quanto espaço em disco ele ocupa e examine a saída para ter certeza de que você compreende o que está gravando e por quê.

<!-- document id=10ddf73286e2fb325d5f4dcdfe6013e5f4492b05a5d96037b2cf0a31ee66ad2e url=/tableau/current/pt-br/server/server-upgrade-baseline-verify-ug.md -->

[Pular para o conteúdo principal](#main-content)

# Verificar a atualização do Tableau Server

Siga as seções deste tópico para verificar se a atualização do servidor foi bem sucedida.

## Verificar os processos do Tableau Service

Inicie o processo de verificação entrando no TSM com a linha de comando e verificando o status dos processos do Tableau Server.

1. Abra um novo prompt de comando como usuário com acesso de administrador.
    
    Para obter informações sobre o uso da linha de comando tsm, consulte [Uso da CLI do tsm](https://help.tableau.com/current/server/pt-br/tsm.htm#Using).
2. Execute o seguinte comando para ver o status de todos os processos do Tableau Server: `tsm status -v.`

**E se eu receber um erro de acesso negado ao tentar executar comandos do TSM?**

Verifique se a conta que está usando é um membro do grupo de Administradores locais no computador Windows onde está instalando o Tableau Server.

## Verificar as configurações globais do TSM

Como parte da preparação para atualização, você deve ter tirado capturas de tela das configurações da interface na Web do TSM. [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm) e compare as configurações com as capturas de tela.

## Habilitar assinaturas e agendamento

1. [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm) como o administrador do Tableau Server.
2. Acesse a página Agendas em todo o servidor:
    
    - Em um Tableau Server onde há um único site (Padrão), clique em Agendas no painel à esquerda.
    - Em um Tableau Server com mais de um site, clique em Gerenciar todos os sites no menu suspenso na parte superior do painel à esquerda e, em seguida, clique em Agendas.
3. Na página Agendas, clique em Selecionar tudo.
4. No menu Ações, selecione Ativar e, em seguida, clique em Ativar no prompt resultante.

## Verificar acesso de usuário

Com uma conta de usuário, faça logon no Tableau Server com o Tableau Desktop e um navegador.

Se o Tableau Server estiver disponível fora da sua organização, verifique a conectividade da Internet.

Se sua organização oferecer suporte à conectividade móvel ao Tableau Server, faça logon no servidor com um dispositivo móvel.

Se estiver usando OAuth e não puder se conectar do Tableau Desktop, confirme se o arquivo `net.properties` não precisa ser atualizado. Para obter mais informações, consulte [Personalização de proxy](https://help.tableau.com/current/server/pt-br/server-upgrade-prepare-gather-config.htm#JREProxy)

## Exibir pastas de trabalho publicadas

Com uma conta de usuário, entre no Tableau Server e procure por pastas de trabalho publicadas. Abra as pastas de trabalho para visualizá-las em um navegador

## Verificar a publicação de pastas de trabalho e fontes de dados

Usando uma conta com uma licença Creator (Criador), verifique a funcionalidade de criação na Web para se conectar aos dados e para criar e publicar pastas de trabalho e fontes de dados:

- [Conectar a dados na Web](https://help.tableau.com/current/pro/desktop/pt-br/creator_connect.htm)
- [Publicar uma fonte de dados na Web](https://help.tableau.com/current/pro/desktop/pt-br/publish_datasource_on_web.htm)
- [Carregar pastas de trabalho para um site do Tableau](https://help.tableau.com/current/pro/desktop/pt-br/upload.htm)

## Verificar o Tableau Prep Builder

Se sua organização estiver executando o Tableau Prep Builder, verifique se você pode se conectar aos dados, abrir um fluxo e outras tarefas do Prep. Veja [Tableau Prep: Conectar aos dados](https://help.tableau.com/current/prep/pt-br/prep_connect.htm).

## Verificar a contagem de objetos do Tableau

Como parte da preparação para atualização, você deve ter observado quantos projetos, pastas de trabalho, exibições, fontes de dados, usuários e grupos estão em sua implantação. Verifique se todos os objetos ainda aparecem.

[Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm) como o administrador do Tableau Server.

- Verifique a contagem de projetos, pastas de trabalho, exibições, fontes de dados
- Verificar a contagem de usuários e grupos

## Verificar a funcionalidade da API

Se sua organização implantou ou desenvolveu conteúdo com APIs do Tableau, verifique se elas funcionam.

### API REST

Verifique o acesso e a autenticação da API REST executando a cURL de amostra no [Tutorial de introdução: Introdução e configuração](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_get_started_tutorial_intro.htm):

`curl "https://MY-SERVER/api/3.8/auth/signin" -X POST -d @signin.xml`

Conteúdo do signin.xml:

<tsRequest>
  <personalAccessTokenName="MY\_PAT\_NAME" 
	<credentials name="username" password="password" >
	 <site contentUrl="MarketingSite" />
  </credentials>
</tsRequest>

Resposta de exemplo:

<tsResponse version-and-namespace-settings>
  <credentials token="12ab34cd56ef78ab90cd12ef34ab56cd">
	<site id="9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d"
	contentUrl="MarketingSite"/>
  </credentials>
</tsResponse>

### Teste de compatibilidade

Para outros recursos desenvolvidos, realize testes de compatibilidade para verificar se a versão atualizada do Tableau Server opera como esperado com as soluções existentes:

- Extensões de painel
- API JavaScript para Tableau incorporado
- Conectores (Conector de dados da Web, Tacos)

Acesse [Limpeza pós-atualização](https://help.tableau.com/current/server/pt-br/server-upgrade-baseline-post-ug-cleanup.htm).

<!-- document id=c8e73a66328feb862c9caac9e6b259323cfeee27092984217d9581f64297c772 url=/tableau/current/pt-br/server/runas_security.md -->

[Pular para o conteúdo principal](#main-content)

# Verificar a política de segurança local

Depois de especificar uma conta de serviço Run As no Tableau Services Manager (conforme descrito no tópico [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm)), o TSM atualizará a política de segurança local no computador com o Tableau Server. O TSM atualizará a política de segurança local para conceder permissões de “logon como serviço” e “logon local” para a conta de serviço Run As. Essa política elevada é um requisito porque a conta de serviço Run As é usada como o contexto de segurança para o serviço do Gerenciador de aplicativo do Tableau Server (tabsvc).

**Observação:** se a conta de serviço Run As especificada no TSM for um membro dos administradores locais ou um administrador de domínio, o TSM poderá não atualizar a política de segurança local. Atualizar a conta de serviço Run As com uma conta que é membro dos administradores locais ou um administrador de domínio não é uma boa prática de segurança. Recomendamos usar uma conta de usuário de domínio para a conta de serviço Run As.

Em alguns casos, poderá ser necessário definir as políticas de segurança manualmente para a conta de serviço Run As. Por exemplo, algumas empresas executam a Política de Grupo do Windows que remove os direitos de “logon como serviço" e “permitir logon local” que foram definidos nas contas de usuário. Ou uma organização pode executar uma política que cria um conflito de permissão ao especificar "Negar logon como um serviço". Se a sua empresa faz isso, então será necessário desativar ou editar as Políticas de grupo para que sua conta de serviço Run As não seja afetada. Para obter detalhes sobre as práticas recomendadas ao criar uma conta de serviço Run As, consulte [Criação da conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm#best) .

O seguinte procedimento descreve como configurar as políticas de segurança, **Logon como serviço e **Allow log on locally****, manualmente. Também é possível usar o procedimento abaixo para verificar se a conta de serviço Run As está configurada corretamente com direitos de política de segurança local. Por exemplo, é necessário verificar se a conta de serviço Run As não está especificada na política **Negar logon como serviço**.

Se estiver executando uma instalação distribuída, a configuração deverá ser a mesma no servidor nos nós iniciais e adicionais.

Para verificar ou atualizar a política de segurança local:

1. Selecione Iniciar > Painel de controle > Ferramentas administrativas > Política de segurança local.
2. Na Política de segurança local, abra **Políticas locais**, selecione **Atribuições de direitos do usuário**.
    
    **Para verificar ou definir o Logon como uma política de serviço:**
    
    1. Clique com o botão direito do mouse na política Logon como um serviço e, em seguida, clique em Propriedades.
        
        ![A janela Política de segurança local com a política "Logon como serviço" destacada.](/tableau/current/pt-br/server/pt-br/Img/runas_security.png)
    2. Em **Propriedades de Fazer logon como um serviço**, clique em Adicionar usuário ou grupo.
    3. Digite o `<domain>\<username>` para a conta de serviço do Run As do Tableau Server (por exemplo: `MYCO\tableau_server`), e clique em Verificar nomes.
    4. Quando a conta for resolvida corretamente, ela será sublinhada. Clique em OK.
    
    **Para verificar ou definir Permitir logon na política local:**
    
    1. Clique com o botão direito do mouse na política Permitir logon local e, em seguida clique em Propriedades.
    2. Verifique se a conta de serviço Run As foi especificada. Se não, siga o procedimento acima para adicionar a conta de serviço Run As
    
    **Para verificar se a conta de serviço Run As não está especificada na política Negar logon como serviço:**
    
    1. Clique com o botão direito do mouse na política Logon como um serviço e, em seguida, clique em Propriedades.
    2. Em **Propriedades de Negar logon como um serviço**, verifique se a conta de serviço Run As não está listada. Se estiver, remova-a. Ao concluir, clique em OK.
3. Clique em OK para fechar as janelas Configurações locais de segurança.

<!-- document id=93f05412c5fc4b291565759d5b15bb2dd7a91aafe1d72f5ac07fae3690e24639 url=/tableau/current/pt-br/server/runas_svc.md -->

[Pular para o conteúdo principal](#main-content)

# Verificar as configurações do Tableau Service

Confirme se os serviços do Tableau receberam os valores corretos de Logon e Inicialização. Se você estiver executando uma [instalação distribuída](https://help.tableau.com/current/server/pt-br/distrib_ha.htm) do Tableau Server, execute estas etapas em todos os nós do cluster.

1. Faça logon como administrador no computador que está executando o Tableau Server.
2. No computador do Tableau Server, selecione Iniciar > Painel de controle > Ferramentas administrativas > Gerenciamento de computador > Serviços e aplicativos > Serviços.
3. Abra Serviços e aplicativos e clique em Serviços. Confirme se os serviços a seguir têm as configurações corretas:
    
    <table style="border-top-style: solid;border-top-width: thin;border-top-color: gray;border-bottom-style: solid;border-bottom-width: thin;border-bottom-color: gray;border-left-style: solid;border-left-width: thin;border-left-color: gray;border-right-style: solid;border-right-width: thin;border-right-color: gray;border-collapse: collapse;" class="simple-table"><colgroup><col title="1" style="width: 25%;"><col title="2" style="width: 50%;"><col title="3" style="width: 25%;"></colgroup><thead><tr><th style="text-align: left; border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Nome do serviço</th><th style="text-align: left; border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Valor do logon</th><th style="text-align: left; border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Valor de inicialização</th></tr></thead><tbody><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;"><p>Serviço de licenciamento FLEXnet 64</p></td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Sistema local</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Logon secundário</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Sistema local</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Manual</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Serviço de ativação do Tableau Server</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Sistema local</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Agente de administração do Tableau Server</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Sistema local</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático (início atrasado)</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Controlador de administração do Tableau Server</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Serviço de rede</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático (início atrasado)</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Serviço de arquivo do cliente do Tableau Server</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Serviço de rede</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático (início atrasado)</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Serviço de coordenação do Tableau Server</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Serviço de rede</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático (início atrasado)</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Gerenciador de licença do Tableau Server<p>(Executa apenas no nó inicial)</p></td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Serviço local<p>O Gerenciador de licenças depende de permissões de pasta do Windows que são aplicadas ao Serviço local. Em ambientes mais seguros, você deve modificar as permissões no diretório de instalação do Tableau. Caso contrário, você poderá encontrar erros de licenciamento.</p><p>Consulte <a href="https://help.tableau.com/current/server/pt-br/runas_confirm_read_ex.htm" class="xref">Verificar permissões de pasta</a> para obter mais informações.</p></td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático (início atrasado)</td></tr><tr><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Gerenciador de serviço do Tableau Server</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">&lt;domain&gt;\&lt;username&gt; Esta é a conta de serviço Run As. Veja abaixo. Se você não tiver especificado uma conta de serviço Run As, a conta de sistema do Serviço de rede será usada.</td><td style="border-top-style: solid; border-top-width: thin; border-top-color: gray; border-bottom-style: solid; border-bottom-width: thin; border-bottom-color: gray; border-left-style: solid; border-left-width: thin; border-left-color: gray; border-right-style: solid; border-right-width: thin; border-right-color: gray;">Automático (início atrasado)</td></tr></tbody></table>

**Observação**: não modifique as configurações padrão na guia Recuperação da caixa de diálogo Propriedades do gerenciador de serviço do Tableau Server; deixe as configurações para recuperação de falhas definidas como Reiniciar o serviço.

## Alteração do valor de logon

Para alterar o valor de Logon do Tableau Server (tabsvc) para a conta de serviço Run As, consulte [Alterar a conta de serviço Run As](https://help.tableau.com/current/server/pt-br/runas_acct.htm).

<!-- document id=a71cea36cf3bb726036c51e6c4eab62b23e3b6582dd3204323bc5bdc1b4b1805 url=/tableau/current/pt-br/server/runas_confirm_read_ex.md -->

[Pular para o conteúdo principal](#main-content)

# Verificar permissões de pasta

A conta executada pelo serviço do Tableau Server é chamada de conta de serviço Run As. A conta de serviço Run As requer permissões para recursos específicos de pastas no computador Windows.

Este tópico fornece:

- Uma listagem das permissões exigidas pela conta de serviço Run As.
- Informações sobre a instalação do Tableau Server em locais de instalação não padrão
- Como reaplicar permissões em uma conta de serviço Run As existente com o TSM.

Este tópico refere-se à unidade na qual o Windows como a _unidade do sistema_. A unidade do sistema é equivalente à variável do ambiente do Windows, `%WINDIR%`. A unidade na qual o Tableau Server está instalado é chamada de _unidade de instalação_.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 40%;"><col style="width: 20%;"></colgroup><tbody><tr><th>Recurso</th><th>Unidade do sistema ou de instalação</th><th>Caminho do arquivo</th><th>Permissões exigidas</th></tr><tr><td>pasta</td><td>system</td><td><code>SYSTEMROOT:\windows\system32</code></td><td>Leitura, Listar conteúdo da pasta</td></tr><tr><td>executável</td><td>system</td><td><code>SYSTEMROOT:\windows\system32\cmd.exe</code></td><td>Ler e executar</td></tr><tr><td>Raiz da unidade</td><td>instalação</td><td>raiz, por exemplo, <code>Local Disk (C:)</code></td><td>Leitura, Listar conteúdo da pasta</td></tr><tr><td>pasta</td><td>instalação</td><td><code>PROGRAMFILES\Tableau\Tableau Server</code></td><td>Modificar</td></tr><tr><td>pasta</td><td>instalação (na unidade do sistema)</td><td><code>\ProgramData\Tableau\Tableau Server\</code></td><td>Modificar</td></tr><tr><td>pasta</td><td>instalação (em uma unidade externa ao sistema)</td><td><code>\Tableau\Tableau Server\data\</code></td><td>Modificar</td></tr></tbody></table>

Quando a conta de serviço Run As no TSM é atualizada, um processo em segundo plano configura as permissões de pasta no computador Tableau da conta de serviço Run As especificada.

Nesse caso, onde você está instalando na unidade do sistema na pasta padrão (C:\\Program Files\\Tableau), a configuração das permissões de pasta serão tratadas pelo TSM. Não é necessário verificar ou alterar permissões de pasta nesse caso. Se você instalar o Tableau Server em uma unidade diferente, será necessário configurar algumas permissões manualmente.

## Instalando em um local não padrão

Se você estiver instalando o Tableau Server em um local não padrão em uma unidade diferente, será necessário configurar permissões na pasta de instalação para a conta de serviço Run As, bem como as contas locais predefinidas: Serviço local do serviço de rede e Sistema.

A tabela a seguir descreve as permissões aplicadas caso instale o Tableau Server em um local não padrão. Todas essas permissões são definidas na pasta de instalação e são herdadas pelas subpastas e arquivos na pasta de instalação. Essas permissões são configuradas pelo programa de instalação do Tableau e também são reconfiguradas sempre que você atualiza o Tableau Server para uma nova versão. Alterar as permissões nessas pastas pode prejudicar a funcionalidade.

Para obter mais informações sobre as diferentes contas usadas pelo Tableau Server, consulte [Contas e permissões do Windows](https://help.tableau.com/current/server/pt-br/security_windows_accounts_perms.htm).

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><th>Definir permissões para esta conta:</th><th>Permissões exigidas</th></tr><tr><td>A conta de usuário usada para instalar e atualizar o Tableau Server</td><td>Controle total</td></tr><tr><td>A conta de usuário usada para executar comandos TSM</td><td>Controle total</td></tr><tr><td>Conta do sistema</td><td>Controle total</td></tr><tr><td>Executar como conta de serviço, serviço de rede e serviço local</td><td>Ler e executar</td></tr></tbody></table>

## Reaplicar permissões de pastas

Em algumas empresas, Políticas de grupo ou outras soluções de gerenciamento de sistema são usadas para padronizar permissões e contas nos servidores de aplicações. Se sua empresa executar tal solução, configure o sistema para acomodar as permissões de pasta exigidas pela conta de serviço Run As. Se as permissões de pasta para a conta de serviço Run As tiverem sido alteradas, você poderá usar o TSM para reaplicar as permissões. Consulte [Alteração de uma conta de serviço Run As de domínio existente para uma conta diferente](https://help.tableau.com/current/server/pt-br/runas_acct.htm#Reapplyi).

<!-- document id=a308c1ee5d3d4ff21703220adacbd5fc68e246e605ce123146bcf8eefc1ade26 url=/tableau/current/pt-br/server/runas_confirm_modify.md -->

[Pular para o conteúdo principal](#main-content)

# Verificar permissões do Registro

A conta na qual o serviço Tableau Server é executado precisa de permissões para modificar o Registro no computador local.

Em um cluster de vários nós, as permissões de registro são concedidas apenas no nó tsm de um cluster.

Quando você atualiza a conta de serviço Run As, o TSM configurará as permissões de registro no computador do Tableau para a conta especificada. É improvável que você precise aplicar essas permissões manualmente.

Verifique se a conta de serviço Run As tem permissões para as seguintes ramificações do registro `HKEY_LOCAL_MACHINE\Software\Tableau`. Se a conta especificada como a conta de serviço Run As for um membro do grupo administrativo local ou um membro do grupo de segurança de Administradores de domínio, a conta não será exibida na página Permissões.

## Permissões

O TSM concederá permissão de Leitura e as seguintes permissões Especiais para essas ramificações:

- Valor da consulta
- Definir valor
- Criar subchave
- Enumerar subchaves
- Notificar
- Gravar DAC
- Proprietário de gravação
- Controle de leitura

Para visualizar ou editar permissões em diretórios do Registro:

1. Abra o Editor de Registro inserindo `regedit` no Executar do Windows e clicando em **OK**.
2. No Editor de Registro, vá até o diretório cujas permissões deseja exibir ou editar. Clique com o botão direito do mouse no diretório e clique em **Permissões...**.
3. Em Permissões, na guia Segurança, selecione a conta de serviço Run As e clique em **Avançado**.  
    Se estiver adicionando a conta de serviço Run As, clique em **Adicionar** e siga o processo do Windows para adicionar uma conta de usuário na guia Segurança. Depois de adicionar a conta, selecione a conta de serviço Run As e clique em **Avançado**.
4. Em Configurações avançadas de segurança, na guia Permissões, selecione a conta de serviço Run As e clique em **Editar**.
5. Em Entrada de permissão, em permissões Básicas, verifique se **Ler** e **Permissões especiais** estão selecionadas. Verifique se **Aplicar essas permissões apenas a objetos e/ou contêineres neste contêiner** está desmarcado.
6. Para visualizar ou editar as permissões Especiais, clique em **Mostrar permissões avançadas**.
7. Em permissões Avançadas, verifique se as permissões enumeradas no início deste tópico estão selecionadas. Verifique se **Aplicar essas permissões apenas a objetos e/ou contêineres neste contêiner** está desmarcado.
8. Se tiver definido novas permissões, clique em **OK** em todas as janelas para terminar. Se tiver exibido as permissões e não tiver editado nada, clique em **Cancelar** para fechar todas as janelas.

<!-- document id=99bfb4c7677687b677604e6b570a3b2268cf411e88de22c984025f3ba8590128 url=/tableau/current/pt-br/server/upgrade.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral da atualização do Tableau Server

Os tópicos nesta seção ajudam a atualizar uma instalação existente do Tableau Serverno Windows. Eles descrevem as etapas recomendadas de planejamento e teste _antes de_ executar a atualização. Oferecem informações sobre as práticas recomendadas e, quando estiver pronto para executar a atualização, as etapas para atualizar um servidor de nó único em uma instalação de vários nós. Onde possível, prevemos os possíveis problemas e os ajudamos a evitá-los.

**Observação:** use o [Tableau Release Navigator](https://public.tableau.com/shared/JJGWR3P65?:display_count=n&:origin=viz_share_link) para pesquisar recursos no Tableau Desktop, Server e Prep ou para ver uma lista completa de recursos ao comparar sua versão atual do Tableau com uma posterior.

Procurando o Tableau Server no Linux? Consulte [Atualizar o Tableau Server no Linux.](https://help.tableau.com/current/server-linux/pt-br/upgrade.htm "Abre o tópico em uma nova guia do navegador")

### Atualização de sistemas operacionais de computador

**Importante:** qualquer versão principal do sistema operacional ou atualização do kernel do sistema Linux. (por exemplo: Windows 2019 para Windows 2022) deve ser feito usando as diretrizes Azul/Verde. **Não faça uma atualização de versão principal diretamente em uma máquina que já esteja executando o Tableau Server.** Mesmo se você seguir as etapas abaixo, o Tableau Server ficará em um estado instável se for iniciado.  
  
**Fazer uma atualização de versão principal do sistema operacional diretamente em uma máquina que esteja executando o Tableau Server tornará a instalação do Tableau Server incompatível.**  
  
Para obter mais detalhes sobre as atualizações azul/verde, consulte [Utilização de uma abordagem azul/verde para atualizar o Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-blue-green.htm).

Se você estiver atualizando o sistema operacional do computador do Tableau Server ou os nós em um cluster, certifique-se de revisar e seguir as práticas recomendadas para atualizações. **Grandes atualizações (por exemplo:** **Windows 2019 para Windows 2022****) deve ser feito usando as diretrizes Azul/Verde.** Para obter mais detalhes, consulte [Práticas recomendadas para atualizar o Computador com Tableau Server](https://help.tableau.com/current/server/pt-br/upgrade_best_practices_server.htm) e [Utilização de uma abordagem azul/verde para atualizar o Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-blue-green.htm).

## Como escolher seu caminho de atualização

### Atualizações azul/verde

As atualizações azul/verde são um tipo especial de abordagem de atualização que fornece tempo de inatividade mínimo, mas requer uma equipe de TI experiente e recursos para implementação. Elas não são apropriadas para todas as organizações, mas podem ser a solução de atualização certa para aquelas com o conhecimento técnico e a equipe adequados. Para obter mais informações, consulte [Utilização de uma abordagem azul/verde para atualizar o Tableau Server](https://help.tableau.com/current/server/pt-br/server-upgrade-blue-green.htm).

### Atualização no local

Para obter Instruções sobre atualização do Tableau Server no Windows, consulte [Atualização do Tableau Server (Windows)](https://help.tableau.com/current/server/pt-br/sug_plan.htm)).

## Outros artigos nesta seção

<!-- document id=4a8dabd5e55306eed180bc896cce11c2d810108cca106139afd170ba85ca01fa url=/tableau/current/pt-br/server/rls_options_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral das opções de segurança em nível de linha no Tableau

Às vezes, você quer filtrar os dados com base no usuário que os está solicitando. Por exemplo:

- Você quer que os vendedores regionais vejam os números de vendas apenas para sua região.
- Você quer que os gerentes de vendas vejam estatísticas apenas para vendedores que se reportam a eles.
- Você quer que os alunos vejam exibições com base apenas em suas próprias pontuações de teste.

Uma abordagem para filtrar dados dessa maneira é chamada de segurança em nível de linha (RLS). Existem vários métodos para alcançar a segurança em nível de linha dentro e fora do Tableau, cada um com seus prós e contras.

## Criar um filtro de usuário e mapear usuários para valores manualmente

A maneira mais simples de obter segurança em nível de linha no Tableau é por meio de um filtro de usuário, em que você mapeia manualmente os usuários para valores. Por exemplo, você pode mapear manualmente um usuário chamado “Alice” para o valor “Leste” para que ele veja apenas as linhas na fonte de dados onde a coluna “Região” é “Leste”.

Esse método é conveniente mas de manutenção difícil, e deve-se prestar atenção na segurança. Ele deve ser feito por pasta de trabalho e você deve atualizar o filtro e republicar a fonte de dados de acordo com as alterações da sua base de usuários. Ao publicar um ativo com este tipo de filtro de usuário, você precisa definir permissões, para que os usuários não possam salvá-lo ou baixá-lo, e remover o filtro, obtendo acesso a todos os dados.

Para obter mais informações, consulte [Criar um filtro de usuário e mapear manualmemnte os usuários aos valores](https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters_create.htm#create-user-filter) na ajuda do Tableau Desktop e Criação na Web.

## Criar um filtro de usuário dinâmico usando um campo de segurança nos dados

Com este método, você cria um campo calculado que automatiza o processo de mapeamentos de usuários aos valores de dados. Este método exige que os dados subjacentes incluam as informações de segurança que deseja usar para a filtragem. Por exemplo, usando um campo calculado, a função USERNAME() e uma coluna “Gerente” na fonte de dados, você pode determinar se o usuário que está solicitando a exibição é um gerente e ajustar os dados na exibição de acordo.

Como a filtragem é definida no nível de dados e automatizada pelo campo calculado, esse método é menos propenso a erros que o mapeamento manual de usuários aos valores de dados. Ao publicar um ativo com este tipo de filtro de usuário, você precisa definir permissões, para que os usuários não possam salvá-lo ou baixá-lo, e remover o filtro, obtendo acesso a todos os dados.

Para obter mais informações, consulte [Criar um filtro dinâmico usando um campo de segurança nos dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters_create.htm#dynamic) na ajuda do Tableau Desktop e Criação na Web.

## Usar uma política de dados

A partir do Tableau 2021.4, quando Data Management está habilitado no Tableau Server ou Tableau Cloud, os usuários com uma licença de Criador podem implementar segurança em nível de linha por meio de políticas de dados em conexões virtuais. Como as conexões virtuais são centralizadas e reutilizáveis, você pode gerenciar a segurança em nível de linha para cada conexão em um só lugar, com segurança e proteção, em todo o conteúdo que usa essa conexão.

Ao contrário das soluções acima para segurança em nível de linha no Tableau, esse método não apresenta o mesmo risco de expor informações se um autor negligenciar a proteção adequada de permissões na pasta de trabalho ou fonte de dados, porque a política é aplicada no servidor para cada consulta .

A segurança em nível de linha por meio de políticas de dados de conexão virtual foi desenvolvida para lidar com as deficiências de outras soluções de segurança em nível de linha. Recomendamos essa solução na maioria das situações, quando é uma opção.

Para obter mais informações sobre segurança em nível de linha usando políticas de dados em conexões virtuais, consulte [Sobre conexões virtuais e políticas de dados](https://help.tableau.com/current/server/pt-br/dm_vconn_overview.htm).

## Usar RLS existente no banco de dados

Muitas fontes de dados têm mecanismos para RLS integrada. Se sua organização já criou a segurança em nível de linha em uma fonte de dados, você poderá tirar proveito da RLS existente.

Não é necessariamente mais fácil ou melhor implementar um modelo de RLS integrada, em comparação a criá-la tendo em mente o Tableau. Geralmente, essas técnicas são utilizadas quando uma organização já investiu nessas tecnologias e querem aproveitar esse investimento ou quando precisar aplicar as mesmas políticas de segurança a outros clientes de banco de dados além do Tableau.

O principal benefício de usar a RLS integrada é que os administradores podem implementar e controlar a respectiva política de segurança de dados em um local: nos respectivos bancos de dados.

Para obter mais informações, consulte [Segurança em nível de linha no banco de dados](https://help.tableau.com/current/server/pt-br/rls_datasource.htm).

## Comparação de opção de segurança no nível de linha

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 16%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 28%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 28%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 28%;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">Opção RLS</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">Útil quando</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">Prós</th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1">Contras</th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Filtro de usuário manual</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Você faz uma prova de conceito ou testando a funcionalidade de filtragem do usuário</li><li>Você cria uma pasta de trabalho estática para usar com um grupo imutável de usuários</li><li>Você entende o risco de segurança de dados de ter as permissões definidas incorretamente</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Simples em pequena escala</li><li>Mapeamento fácil de entender</li><li>Bom para teste</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li>Manutenção difícil</li><li>Precisa atualizar o filtro e republicar conforme as alterações da base de usuários</li><li>As permissões devem ser protegidas para evitar que os usuários vejam dados não filtrados</li><li>Deve ser replicado em cada pasta de trabalho</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Filtro de usuário dinâmico</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Você não tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></li><li>Os dados contêm informações que você pode usar para filtrá-los</li><li>Você entende o risco de segurança de dados de ter as permissões definidas incorretamente</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Relativamente fácil de configurar</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li>As permissões devem ser protegidas para evitar que os usuários vejam dados não filtrados</li><li>Deve ser replicado em cada pasta de trabalho ou fonte de dados</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Política de dados</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Você não tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span></li><li>Os dados contêm informações que você pode usar para filtrá-los</li><li>A facilidade de segurança dos dados é uma preocupação significativa</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>Centralizada</li><li>Segura</li><li>Manutenção fácil</li><li>As responsabilidades pela segurança e análise podem ser separadas</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li>Licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span> necessária</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">RLS no banco de dados</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>Seu banco de dados tem uma segurança RLS existente embutida no banco de dados</li><li>Você não está usando extrações</li></ul></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>Pode já estar integrado no banco de dados da sua organização</li><li>As políticas podem ser aplicadas a clientes de banco de dados diferentes do Tableau</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><ul><li>Deve usar consultas ao vivo</li><li>Pode ter limitações ou requisitos. A equipe de TI pode identificá-los</li></ul></td></tr></tbody></table>

## Qual opção de segurança em nível de linha devo usar?

<table style="width: 100%;"><colgroup><col style="width: 45%;"><col style="width: 10%;"><col style="width: 45%;"></colgroup><tbody><tr><td style="padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;background-color: #f5f5f5;">Sua organização tem uma solução RLS preferencial no banco de dados que funciona para este projeto?</td><td style="text-align: center;">→ Sim →</td><td style="padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;background-color: #f5f5f5;">Consulte <a href="https://help.tableau.com/current/server/pt-br/rls_datasource.htm" class="xref">Segurança em nível de linha no banco de dados</a></td></tr><tr><td><p style="text-align: center;">↓ Não ↓<br></p></td><td style="text-align: center;">&nbsp;</td><td>&nbsp;</td></tr><tr><td style="padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;background-color: #f5f5f5;"><p>Você tem uma licença do <span class="mc-variable Variables.DM_sku variable">Data Management</span>?</p></td><td style="text-align: center;">→ Sim →</td><td style="padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;background-color: #f5f5f5;">Consulte <a href="https://help.tableau.com/current/server/pt-br/dm_vconn_overview.htm" class="xref">Sobre conexões virtuais e políticas de dados</a></td></tr><tr><td><p style="text-align: center;">↓ Não ↓</p></td><td style="text-align: center;">&nbsp;</td><td>&nbsp;</td></tr><tr><td style="background-color: #f5f5f5;">É uma prova de conceito, um teste básico de filtro de usuário ou uma pasta de trabalho estática com usuários imutáveis?</td><td style="text-align: center;">→ Sim →</td><td style="background-color: #f5f5f5;">Consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters_create.htm#create-user-filter" target="_blank">Usar um filtro de usuário manual</a></td></tr><tr><td><p style="text-align: center;">↓ Não ↓</p></td><td>&nbsp;</td><td>&nbsp;</td></tr><tr><td style="background-color: #f5f5f5;"><p>Consulte <a href="https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters_create.htm#dynamic" target="_blank">Usar um filtro de usuário dinâmico</a></p></td><td>&nbsp;</td><td>&nbsp;</td></tr></tbody></table>

<!-- document id=f9d92a28cb615b0512f608f092d3115214e812bf3b0756644ce55d9bebf1ce21 url=/tableau/current/pt-br/server/perf.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral de desempenho do Tableau Server

Ao dedicar um tempo para entender o desempenho do Tableau Server, é possível aprimorar o atendimento a seus usuários melhorando a eficiência do Tableau Server. Embora cada ambiente de servidor seja único e existam muitas variáveis que podem impactar o desempenho, as etapas básicas que o usuário pode realizar para entender e agir de acordo com os dados de desempenho no Tableau Server são iguais.

- **Notificações**. Configure as notificações de e-mail para eventos de servidor importantes. Por exemplo, é possível receber notificações quando os processos do servidor se tornarem indisponíveis e quando o servidor estiver ficando sem espaço em disco.
- **Monitoramento**. Colete e analise os dados sobre o Tableau Server para saber a forma como o servidor está sendo executado.
- **Ajuste**. Faça ajustes em tarefas, configurações de processo e muito mais, para melhorar o desempenho do Tableau Server.
- **Solução de problemas**. Identifique congestionamentos em recursos, pastas de trabalho e muito mais, para melhorar o desempenho do Tableau Server.

<!-- document id=cb92c585857f8a40c8992be139b8e3f275b1be46b077b2a1422861636f629f7b url=/tableau/current/pt-br/server/admin.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral do administrador de servidor

O Tableau Server no Windows integra-se a vários componentes que fazem parte da sua infraestrutura de TI para oferecer uma cultura de autoatendimento de análise de dados a seus usuários. É importante que você, como administrador, compreenda como o Tableau Server se adapta à sua infraestrutura de TI.

Os tópicos nesta seção fornecem informações sobre planejamento, implementação, ajuste e gerenciamento do Tableau Server.

Se você estiver implantando o Tableau Server como parte de um esforço mais amplo para transformar sua empresa em uma cultura orientada por dados, consulte o [Tableau Blueprint](https://help.tableau.com/current/blueprint/pt-br/bp_overview.htm). O Tableau Blueprint é um guia detalhado para ajudar sua organização a ser baseada em dados. Esse guia serve tanto para empresas que ainda não conhecem análises modernas de autoatendimento quanto para empresas que já fizeram alguma implantação e precisam expandir, aprofundar e escalonar o uso dos dados.

Este tópico fornece uma visão geral breve de como refletir sobre o Tableau Server e como interagir com a sua infraestrutura de TI existente.

Procurando o Tableau Server no Linux? Consulte [Visão geral do administrador de servidor](https://help.tableau.com/current/server-linux/pt-br/admin.htm "Abre o tópico em uma nova guia do navegador")

## Validando seu plano de implantação do Server

Antes de se comprometer a instalar uma nova implantação do Tableau Server em sua organização, certifique-se de avaliar atentamente suas opções. Para a maioria das organizações, o Tableau Cloud fornecerá uma solução de análise mais confiável, eficiente e econômica em comparação com o Tableau Server auto-hospedado. Para obter informações sobre a viabilidade do Tableau Cloud para sua organização, revise essa postagem no blog, [Should I move my analytics to the cloud? (Devo mover minha análise para a nuvem?)](https://www.tableau.com/pt-br/blog/should-i-move-my-analytics-cloud)

Já está executando o Tableau Server e deseja migrar para o Tableau Cloud? Consulte [Guia de migração manual do Tableau Cloud](https://help.tableau.com/current/guides/migration/pt-br/emg_intro.htm).

## Visão geral da arquitetura

O Tableau Server é uma coleção de processos que funcionam juntos para oferecer uma plataforma de análise de autosserviço para os seus usuários. O diagrama a seguir mostra uma exibição arquitetural de alto nível do Tableau Server.

![Um diagrama das opções de implantação do Tableau Server, ilustrando componentes como dados e serviços de análise.](/tableau/current/pt-br/server/pt-br/Img/server_admin_intro_arch.png)

Os processos de vários servidores (apresentados em azul acima) trabalham juntos para oferecer serviços em várias camadas. O processo de Gateway é o componente que redireciona o tráfego de todos os clientes do Tableau aos nós do servidor disponíveis em um cluster.

O Serviços de dados é um agrupamento lógico dos serviços que fornecem dados atualizados, gerenciamento de metadados compartilhado, fontes de dados administradas e dados na memória. Os processos subjacentes que fornecem os Serviços de dados são os processos do Processador em segundo plano, do Servidor de dados e do Mecanismo de dados.

Os serviços de análise, compostos de processos do VizQL e do Servidor de cache, fornecem os serviços de visualização e análise voltados para o usuário e os serviços de cache.

O compartilhamento e a colaboração e o serviço de gerenciamento de conteúdo são fornecidos pelo processo do Servidor de aplicativos. A funcionalidade principal do Tableau Server como o logon de usuário, gerenciamento de conteúdo (projetos, sites, permissões etc.) e as atividades de administração é fornecida pelo processo do Servidor de aplicativos.

Todos os serviços acima usam e dependem do processo Repositório, que contém dados relacionais estruturados como metadados, permissões, pastas de trabalho, extrações de dados, informações do usuário e outros dados. O processo Armazenamento de arquivo permite a redundância de arquivo de extração no cluster e garante que as extrações estejam localmente disponíveis em todos os nós do cluster. Com carregamentos maiores, os arquivos de extração estão disponíveis localmente no cluster para processamento e renderização mais rápidos.

A arquitetura do Tableau é flexível, permitindo executar a plataforma praticamente em qualquer lugar. É possível instalar o Tableau Server no local, na sua nuvem privada ou datacenter, no Amazon EC2, na Google Cloud Platform ou no MS Azure. A plataforma de análise do Tableau também pode ser executada sobre as plataformas de virtualização. Recomendamos que você siga as práticas recomendadas para cada plataforma de virtualização, com o objetivo de garantir o melhor desempenho do Tableau Server.

## Tableau e seus dados

Ao instalar o Tableau Server na sua empresa, ele se torna um componente central do pipeline de análises para os dados que os seus usuários precisam. É importante compreender como o Tableau Server interage com os seus dados de negócios. Especificamente, o Tableau Server pode armazenar extrações de dados na sua organização. Ele também pode se conectar a fontes de dados em tempo real. Como você escolhe fornecer os dados aos seus usuários do Tableau é informado por algumas variáveis: tipo de fonte de dado, cenário do usuário, exigências de desempenho e acesso, além de condições de infraestrutura.

O Tableau Server não foi estruturado como um servidor de data warehouse onde os arquivos de dados estáticos e nativos são abrigados. Na realidade, o uso do Tableau Server como data warehouse tradicional é um uso inapropriado do seu investimento. Em vez disso, em relação do armazenamento de dados, recomendamos hospedar as extrações de dados otimizadas no Tableau Server. Como uma extração de dados é sempre um subconjunto de uma fonte de dados maior na empresa, você também pode criar extrações das fontes de dados que estão sobretaxadas durante o horário de trabalho ao [agendar a atualização de extrações](https://help.tableau.com/current/server/pt-br/publish.htm) fora dele.

As extrações também são úteis para a modelagem de dados ou habilitar a criação de visualização de alto desempenho. Por exemplo, para melhorar a criação da visualização e o desempenho da interação, você pode otimizar as extrações ao filtrar os dados da fonte para os campos essenciais, em um determinado departamento ou projeto. As extrações podem ter muitos recursos. Se a sua empresa planeja usar muito as extrações, revise o tópico [Otimizar para extrações](https://help.tableau.com/current/server/pt-br/perf_optimize_extracts.htm).

O Tableau Server também oferece acesso direto e autorizado às fontes de dados em tempo real, permitindo que os usuários criem e executem consultas complexas e filtradas em várias fontes de dados conectadas. Para esse cenário, o Tableau requer um acesso à rede com alto desempenho às fontes de dados na sua empresa e às que estão na nuvem. O Tableau Server e as fontes de dados de destino também precisam ser corretamente dimensionados para lidar com a carga de processamento exigida por operações de dados de alto volume e complexas. É possível otimizar o desempenho das conexões de dados em tempo real com configurações de cache e especificação dos comandos SQL iniciais.

## Acesso de usuário

O Tableau Server também é uma plataforma de colaboração baseada na Web, onde os usuários se conectam para compartilhar, visualizar e interagir com as visualizações de dados e fontes de dados por meio de uma variedade de dispositivos. Isso significa que o Tableau Server deve ser acessível aos usuários do Tableau dentro da sua rede local protegida. Além disso, é possível ampliar o acesso às visualizações de dados aos usuários de aplicativos para desktop, dispositivos móveis e usuários autenticados da Web fora da sua empresa.

O Tableau Server integra-se às seguintes soluções de [autenticação](https://help.tableau.com/current/server/pt-br/security_auth.htm) do usuário: Active Directory, SAML, OpenId e Kerberos.

## Onde devo instalar o Tableau Server na minha rede?

Devido ao aspecto altamente confidencial da maioria dos dados gerenciados pelas empresas com o Tableau Server e como o Tableau Server requer acesso aos armazenamentos de dados internos, o Tableau Server deve ser executado dentro de uma rede protegida. O acesso autenticado da Internet está configurado para se conectar ao Tableau Server por meio de um [proxy reverso](https://help.tableau.com/current/server/pt-br/proxy.htm) ou uma solução VPN.

![Um diagrama que ilustra como os dados são movidos da Internet para o Tableau Desktop por meio de uma rede.](/tableau/current/pt-br/server/pt-br/Img/server_admin_intro_network.png)

Algumas empresas inserem exibições do Tableau em páginas públicas da Web ou, para usuários internos, em servidores da Web genéricos na rede interna.

O Tableau Server pode ser configurado para dar suporte aos cenários com acesso autenticado ou anônimo. Para acesso autorizado, em que os usuários podem visualizar apenas os dados subjacentes aos quais têm permissão, é possível configurar os tíquetes confiáveis com um servidor da Web genérico. Neste cenário, o Tableau Server autoriza o acesso aos dados subjacentes em uma exibição inserida. Este esquema permite que você hospede as visualizações de dados interativos em um servidor Web de um DMZ ou fora da rede protegida.

O acesso anônimo a exibições inseridas do Tableau exige que "[usuário convidado](https://help.tableau.com/current/server/pt-br/users_guest.htm)" esteja habilitado para o Tableau Server. O usuário convidado também exige que você licencie o Tableau Server de acordo com o número de núcleos sendo executado, em vez de um modelo (interagente) de usuário nomeado.

## Dimensionamento e escalabilidade

Dependendo do tamanho e do uso dos dados na sua empresa, você pode escalonar verticalmente ou horizontalmente o Tableau Server. Ao escalonar o seu servidor, você também pode alocar seletivamente os recursos para atenderem às necessidades de dados e do usuário.

Quando você escalona verticalmente o Tableau Server, adiciona recursos de hardware a um único servidor. Por exemplo, você pode aumentar a memória e a potência de processamento do computador que executa o Tableau Server.

Quando você escalona horizontalmente o Tableau Server, adiciona computadores (ou nós). Para criar uma implantação altamente disponível com failover, você precisa de, no mínimo, três nós. Por exemplo, você pode executar a maioria dos processos do servidor que ocupam muita CPU em dois nós e usar o terceiro nó para o gateway e serviços do controlador de coordenação.

Seja o escalonamento vertical ou horizontal, você pode alocar seletivamente os recursos ao configurar o número e tipo de processos do servidor executados. Se a sua empresa tem muitos dados e cria muitas extrações de dados, é possível aumentar o número de processos dedicados à atualização e ao armazenamento de extrações. Como alternativa, se a sua empresa deseja otimizar os carregamentos de usuários muito densos, é possível aumentar o número de processos dedicados a respostas de solicitações de usuário. Além disso, é possível integrar o Tableau Server aos balanceadores de carga da rede para aprimorar ainda mais seu servidor em relação às solicitações de usuário.

## Modelo de gerenciamento do Tableau Server

O Tableau Server foi projetado para dar suporte ao esquema de gerenciamento com dois administradores de alto nível: administrador de servidor e administrador de site. Em pequenas empresas, essas funções podem ser assumidas pela mesma pessoa ou equipe, porém em empresas maiores as funções frequentemente são diferentes.

Neste modelo, os administradores são profissionais de TI que fazem a manutenção e implementam soluções de servidor heterogêneas. As áreas essenciais para os administradores de servidor podem incluir rede, ajuste e manutenção de hardware, segurança e acesso e gerenciamento de usuários e serviços de diretório. As ferramentas e a documentação que fornecemos com o Tableau Server para o administrador de servidor dão suporte a essas áreas de TI de servidor principais.

Por outro lado, o administrador de site é uma função administrativa específica para implementações do Tableau Server ou do Tableau Cloud. O administrador de site do Tableau preocupa-se basicamente com o conteúdo de dados. O administrador de site gerencia usuários e os acessos deles a projetos, pastas de trabalho e fontes de dados. Para saber mais sobre sites e como planejar a sua implementação, consulte [O que é um site](https://help.tableau.com/current/server/pt-br/sites.htm)

## Funções administrativas

Em algumas pequenas empresas, um único administrador pode gerenciar a totalidade do Tableau Server. Mas em empresas maiores, o Tableau Server geralmente requer pelo menos três funções administrativas para gerenciamento em escala.

### Administrador do Tableau Server

O administrador do Tableau Server tem acesso a páginas administrativas para criar e editar sites, adicionar usuários e definir funções e muitas tarefas relacionadas ao conteúdo após a instalação do Tableau Server ser concluída. O administrador do Tableau Server também cria e gerencia outros administradores de servidores e de sites, que, por sua vez, podem gerenciar sites, grupos de usuários e projetos.

Para obter informações sobre o logon no Tableau Server como um administrador, consulte [Fazer logon na área de administração do Tableau Server](https://help.tableau.com/current/server/pt-br/sign_in_server_admin.htm).

### Administrador do TSM

O Tableau Services Manager (TSM) é uma ferramenta que oferece aos administradores de servidores opções baseadas em linha de comando e na Web para instalar, atualizar, configurar e manter o Tableau Server. O administrador do TSM instala o servidor e executa tarefas administrativas relacionadas ao servidor, como backup de dados do servidor, restauração de backups, criação de arquivos de log e gerenciamento de clusters de vários nós.

O administrador do TSM deve ser um administrador no computador local. Consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).

As tarefas comuns executadas pelo administrador do TSM incluem:

- Configuração inicial do Tableau Server após a instalação
- Gerenciamento de configuração contínuo, inclusive edição de configurações e alteração da topologia do servidor
- Realização de tarefas administrativas, como backup, restauração e ziplogs

Para saber mais sobre o TSM, consulte [Visão geral do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/tsm_overview.htm).

### Administrador do portal do Tableau

Uma importante função administrativa em uma implantação do Tableau Server é o administrador do Portal do cliente do Tableau. O administrador do portal gerencia o licenciamento e as chaves associadas para a implantação do Tableau. Como administrador do portal, o primeiro passo é comprar licenças no [Portal do cliente do Tableau](http://customer.tableausoftware.com/). Quando comprar as licenças, o portal retornará as chaves do produto correspondentes. Para renovar a licença, visite a página na Web [Renovação do Tableau.](https://www.tableau.com/pt-br/support/renew)

O Tableau tem uma série de produtos (Tableau Desktop, Server, Prep Builder, e muito mais). Cada um dos produtos do Tableau exige a ativação das licenças ao atualizar o software do Tableau com as chaves do produto que são compradas e armazenadas no Portal do cliente do Tableau. Como o administrador que tem a tarefa de ativar licenças do Tableau, é importante entender a relação entre licenças e chaves. Consulte [Conhecer os modelos de licença e as chaves do produto](https://help.tableau.com/current/server/pt-br/license_product_keys.htm).

## Ferramentas de gerenciamento

O Tableau Server inclui vários conjuntos de ferramentas para o gerenciamento do sistema:

- **Página de administrador do Tableau Server**: este é o site administrativo na Web instalado em cada instância do Tableau Server. As tarefas executadas na página do administrador são tarefas diárias para os administradores de servidor e de site. As tarefas relacionadas ao servidor incluem a criação de sites e contas de administrador de site e, opcionalmente, a importação de usuários, a configuração da sincronização com serviços de diretório, a configuração de agendas de atualização de extrações, o monitoramento de desempenho e uso do servidor e outras configurações globais.
    
    As tarefas relacionadas ao site incluem o gerenciamento de conteúdo e a atribuição de permissões, a execução de atualizações de extração, a criação de grupos e projetos, o monitoramento de atividades do site e, opcionalmente, a adição de usuários e outras tarefas relacionadas ao conteúdo.
    
    Consulte [Navegar nas Áreas administrativas do ambiente da Web do Tableau](https://help.tableau.com/current/server/pt-br/navigate_admin_settings.htm).
    
    As permissões exigidas pela página de administrador do Tableau Server são baseadas em funções no site. As funções no site são geradas e gerenciadas pelo Tableau Server.
- [Referência da linha de comando tsm](https://help.tableau.com/current/server/pt-br/tsm.htm) - esta é a interface primária para configurações em todo o servidor. Muitas configurações feitas com a CLI do TSM raramente são revisadas após a configuração inicial. Por exemplo: SSL, inscrições, dados em cache, conta de serviço, alerta SMTP, autenticação do usuário e configuração de logon único são executados com o TSM CLI.
- Também é possível [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm).
- **[tabcmd](https://help.tableau.com/current/server/pt-br/tabcmd.htm)**: a fim de automatizar tarefas administrativas no seu site do Tableau Server, use o utilitário de linha de comando tabcmd em um computador com Windows ou Linux para criar scripts. Por exemplo, use tabcmd para criar ou excluir usuários, projetos e grupos.
- **[REST API](https://community.tableau.com/s/topic/0TO4T000000QFAxWAO/rest-api)**: com a REST API do Tableau Server, é possível gerenciar e alterar os recursos do Tableau Server de maneira programática, através de HTTP. A API fornece acesso simples aos recursos por trás das fontes de dados, projetos, pastas de trabalho, usuários de site e sites em um servidor Tableau. É possível usar esse acesso para criar seus próprios aplicativos, ou para criar scripts de interações com os recursos do Tableau Server.

## Segurança

Como um servidor de aplicativos que se conecta a dados que podem ser altamente sensíveis, o Tableau Server oferece suporte e implementa uma série de padrões de segurança do setor. Nossa documentação para o administrador do servidor inclui as práticas recomendadas e a implementação de autenticação do usuário, autorização, segurança de dados e segurança da rede. Embora nossa instalação padrão tenha um design seguro, também recomendamos seguir a [lista de verificação para o fortalecimento da segurança](https://help.tableau.com/current/server/pt-br/security_harden.htm), a fim de bloquear ainda mais a implantação.

Para obter mais informações sobre conformidade da auditoria de segurança, relatórios de vulnerabilidades e outros recursos de segurança, visite [http://www.tableau.com/pt-br/security](http://www.tableau.com/pt-br/security).

<!-- document id=ed53a3c07d3ac893118facecabf8b3f595b41ec891c08afb05521844dd24ff69 url=/tableau/current/pt-br/server/license_server_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral do licenciamento

Uma importante função administrativa em uma implantação do Tableau Server é o administrador do portal do Tableau. O administrador do portal gerencia o licenciamento e as chaves associadas para a implantação do Tableau. Como administrador do portal, o primeiro passo é comprar licenças no [Portal do cliente do Tableau](http://customer.tableausoftware.com/). Quando comprar as licenças, o portal retornará as chaves do produto correspondentes. Para renovar a licença, visite a página na Web [Renovação do Tableau.](https://www.tableau.com/pt-br/support/renew)

O Tableau tem uma série de produtos (Desktop, Server, Prep Builder, e muito mais). Cada um dos produtos do Tableau exige a ativação das licenças ao atualizar o software do Tableau com as chaves do produto que são compradas e armazenadas no Portal do cliente do Tableau. Como o administrador que tem a tarefa de ativar licenças do Tableau, é importante entender a relação entre licenças e chaves. Consulte [Conhecer os modelos de licença e as chaves do produto](https://help.tableau.com/current/server/pt-br/license_product_keys.htm).

## Ativação

Ativação é o processo de fazer upload e salvar as chaves do produto do Tableau no Tableau Server. Esta operação é feita com o Tableau Services Manager (TSM). O TSM é uma ferramenta que faz alterações no sistema operacional local e no sistema de arquivos e, portanto, requer acesso administrativo ao computador local. Um administrador do TSM requer permissões e acesso diferentes do administrador do Tableau Server, que é a função administrativa para a operação diária de tarefas do Tableau Server, como adicionar usuários, sites, gerenciar projetos e permissões etc. Consulte[Funções administrativas](https://help.tableau.com/current/server/pt-br/admin.htm#Admin) para obter mais informações sobre as várias funções administrativas do Tableau Server.

Os tópicos a seguir descrevem como se conectar ao TSM:

- [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server/pt-br/sign_in_tsm.htm)
- [Referência da linha de comando tsm](https://help.tableau.com/current/server/pt-br/tsm.htm)

### Ativação on-line

Se a instalação do Tableau Server for capaz de se comunicar com a internet, recomendamos usar o método de ativação on-line padrão.

- Para saber como ativar durante o processo de instalação, consulte [Ativar e registrar o Tableau Server](https://help.tableau.com/current/server/pt-br/activate.htm).
- Para saber como ativar as chaves do produto depois de atualizar a assinatura, consulte [Atualizar data de expiração e atributos da chave do produto](https://help.tableau.com/current/server/pt-br/license_refresh.htm).
- Para saber como ativar as chaves do produto depois de adicionar novos recursos ou licenças de usuário comprados, consulte [Adicionar capacidade ao Tableau Server](https://help.tableau.com/current/server/pt-br/capacity_add.htm).

### Ativação off-line

Se o Tableau Server estiver em execução em um ambiente off-line, onde não é possível acessar os servidores de licença do Tableau na Internet, ative as licenças de acordo com o processo de ativação off-line do Tableau:

- Para entender como ativar off-line, consulte [Ativar o Tableau Server off-line](https://help.tableau.com/current/server/pt-br/activate_off.htm).
- Para entender como desativar uma chave do produto que você ativou usando a ativação offline, consulte [Desativar o Tableau Server offline](https://help.tableau.com/current/server/pt-br/deactivate_off.htm) .

### Ativação perdida

Em alguns casos, as ativações de licença podem falhar após a ativação da licença. Essas falhas podem ocorrer devido a falhas de conexão com processos locais ou quando ocorre uma alteração na configuração de VM ou hardware. Por exemplo, alterações de proxy, bloqueio de porta, alterações de rede ou alteração do hardware de uma máquina podem fazer com que a ativação do licenciamento falhe. Se o Tableau Server não puder verificar a licença, a operação poderá ser interrompida e o servidor estará em um estado "não licenciado".

Para visualizar as chaves do produto e o estado de licença do Tableau Server, execute `tsm licenses list` e `tsm status -v`.

Dependendo da chave do produto não verificada, o Tableau Server pode operar em um estado degradado até que a chave do produto esteja em um estado válido. Consulte [Solucionar problemas de licenciamento](https://help.tableau.com/current/server/pt-br/unlicensed.htm).

### Desativar

Você pode ativar a mesma chave do produto do Tableau Server em até três ambientes. Isso permite testar o Tableau Server (por exemplo, em ambientes de área restrita ou de controle de qualidade), além de usar o Tableau na produção. Para maximizar as ativações, desative a chave do produto ao remover o Tableau Server de um computador ou feche uma VM, a menos que esteja reinstalando o Tableau no mesmo computador. Isso faz com que você possa usar a ativação em um computador diferente. Por exemplo, se você mover o Tableau Server de um computador para outro, desative a chave do produto e remova o Tableau do computador original. Ao instalar o Tableau no novo computador, você pode ativar a chave nele sem conflitos. Se você estiver removendo o Tableau Server para reinstalá-lo no mesmo computador, não precisará desativar a chave. O Tableau usará a chave quando reinstalado, a menos que um comando obliterate tenha sido executado com a opção "-l"

Consulte [Desativar a chave do produto](https://help.tableau.com/current/server/pt-br/license_deactivate.htm).

### Licenciamento e máquinas virtuais (VMs) do Tableau Server

Se você executar o Tableau Server em VMs, localmente ou na nuvem, esteja ciente do potencial de complicações relacionadas ao licenciamento. Se você estiver simplesmente atualizando o Tableau Server na VM, não precisará fazer nenhuma ação extra relacionada ao licenciamento. Se você planeja clonar a VM para criar um novo ambiente de produção ou teste para atualizar, precisa desativar todas as licenças do Tableau Server antes da clonagem. Se não fizer isso, o novo ambiente de VM acabará tendo licenças não confiáveis e qualquer tentativa de atualização ou inicialização do Tableau Server falhará. Além disso, você pode acabar atingindo a quantidade máxima de ativações das licenças ao tentar ativar as chaves do produto na nova VM.

Para evitar problemas com o licenciamento em VMs, desative todas as licenças do Tableau antes de clonar uma VM ou permitir que ela seja permanentemente fechada.

## Gerenciamento de licenças baseadas em logon

O gerenciamento de licenças baseadas em logon ajuda a gerenciar o licenciamento de usuários com funções Creator (Criador) no Tableau Server e no Tableau Cloud. Usuários com funções Explorer ou Viewer não podem usar este recurso. Se estiver usando assinaturas baseadas em função com o Tableau Server ou o Tableau Cloud, poderá simplificar o gerenciamento de licenças usando o gerenciamento de licenças baseadas em logon para eliminar as chaves do produto do Tableau Desktop e do Tableau Prep Builder. Basta gerenciar uma ou mais chaves do produto do Tableau Server local ou, no caso do Tableau Cloud, não precisa gerenciar nenhuma chave do produto.

Consulte [Gerenciamento de licenças baseadas em logon](https://help.tableau.com/current/server/pt-br/license_lblm.htm).

## Adicionar usuários

Cada usuário que acessa o recursos do Tableau Server deve estar licenciado.

- Para conhecer as funções e o licenciamento do usuário, consulte [Conhecer os modelos de licença e as chaves do produto](https://help.tableau.com/current/server/pt-br/license_product_keys.htm).
- Para saber como adicionar usuários, consulte [Adicionar usuários ao Tableau Server](https://help.tableau.com/current/server/pt-br/users_add.htm).
- Para saber como ativar as chaves do produto depois de adicionar novas licenças de usuário compradas, consulte [Adicionar capacidade ao Tableau Server](https://help.tableau.com/current/server/pt-br/capacity_add.htm).

<!-- document id=66f5f5749aa55bcb468c4185269ab8010c2e03f7456fed0efdc7b21b439a49c8 url=/tableau/current/pt-br/server/perf_monitor.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral do monitoramento de desempenho

Ao monitorar um servidor, você coleta e analisa os dados que sinalizam se o servidor está com problemas de desempenho ou execução. Por exemplo, se você observar que o seu servidor está usando 100% de sua capacidade de processamento por longos períodos, saberá que há um problema.

Os dados que você precisa coletar e analisar podem ser divididos nas seguintes categorias gerais:

- Dados de uso do recurso—como o Tableau Server usa os recursos de hardware, como o espaço em disco, s memória e os processadores.
- Dados de sessão e tempo de carregamento-como os usuários interagem com o Tableau Server, incluindo quanto tempo leva para as exibições serem carregadas e quantos usuários concorrentes existem.
- Dados da tarefa em segundo plano — como o Tableau Server executa tarefas que não estão vinculadas diretamente a uma ação do usuário. Por exemplo, as tarefas em segundo plano incluem tarefas de atualização de extração, tarefas de assinatura e muito mais.

Alguns destes dados, incluindo os dados do tempo de carregamento e da atualização de extração, já estão acessíveis nas exibições administrativas integradas no Tableau Server. No entanto, para coletar os dados de uso do recurso, você precisa usar uma ferramenta de monitoramento de desempenho externa. (Para esta seção, vamos usar o Monitor de Desempenho do Windows como exemplo, pois ele está incluído no Windows Server.) Para coletar dados adicionais do tempo de carregamento e da tarefa em segundo plano, é possível se conectar ao repositório do Tableau Server.

Após coletar os dados de desempenho que deseja analisar, é possível usar uma pasta de trabalho de exemplo incluída nesta seção como um ponto inicial para analisá-los. Para facilitar a análise dos dados de desempenho em um só lugar, publique as exibições criadas como exibições administrativas personalizadas no Tableau Server.

Para obter mais informações sobre as exibições administrativas incorporadas, consulte [Exibições administrativas](https://help.tableau.com/current/server/pt-br/adminview.htm) .

Para obter mais informações sobre exibições administrativas personalizadas, consulte [Criar exibições administrativas personalizadas](https://help.tableau.com/current/server/pt-br/adminview_postgres.htm).

Para obter mais informações sobre ferramentas avançadas de monitoramento, consulte [Sobre Resource Monitoring Tool do Tableau](https://help.tableau.com/current/server/pt-br/rmt-intro.htm).

**Observação:** para usar a pasta de trabalho de exemplo e publicar exibições no Tableau Server, você deve ter o Tableau Desktop.

## Outros artigos nesta seção

<!-- document id=df5794805dfd85daa374d9a9a340870a511b63e722d907a03f6022b995057806 url=/tableau/current/pt-br/server/cmt-depl_plan_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral do plano de migração

O Content Migration Tool do Tableau cria um processo simplificado para migrações do conteúdo do Tableau entre projetos e sites. O plano fácil de seguir pode ser auditado, reproduzido e funciona por meio de um processo em lote para que qualquer número de pastas de trabalho e fontes de dados possa ser migrado em um processo simples e eficiente.

O Content Migration Tool exibirá dicas contextuais para orientar você na criação ou edição de um plano de migração . Depois de selecionar os sites de origem e destino, um resumo da sua migração será exibido na parte superior da tela da seguinte forma:

![Migrando de um site para outro.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-summary.png)

## Limitações ao migrar conteúdo

Antes de começar, verifique se compreendeu as limitações ao migrar conteúdo usando o Content Migration Tool. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm).

## Chaves de criptografia

Cada arquivo de plano de migração é gerado com uma chave de criptografia exclusiva para o aplicativo que criou o plano. As chaves de criptografia podem ser compartilhadas se o plano de migração precisar ser executado por meio de um aplicativo que não gerou o arquivo originalmente. Ao compartilhar chaves de criptografia, você precisará substituir a chave existente no aplicativo para executar o plano de migração. Para ver sua chave de criptografia, selecione Help > Settings

![Menu de configurações com opções para chave de licença legada, diagnóstico e chave de criptografia de segurança.](/tableau/current/pt-br/server/pt-br/Img/cmt-plan-encryption.png)

Se você estiver usando a Content Migration Tool do Runner do console para planos de migração, você deve especificar a chave de criptografia usando o comando `tabcmt-runner encryption` antes de executar o plano. Para obter mais informações, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).

## Processo de migração

### Etapa 1: início

O cerne do processo de migração é criar um plano, que você pode salvar e reutilizar para migrações futuras ou modificar e atualizar conforme necessário. A primeira etapa é escolher se deseja criar um novo plano ou selecionar um plano salvo anteriormente.

Para criar um novo plano, clique em Create New Plan. Se você já tiver criado um plano de migração e deseja usá-lo, clique em Browse for a Plan.

![Botões chamados “Criar novo plano” ou “Procurar um plano”.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-start.jpg)

Por padrão, todos os planos de migração salvos serão armazenados na pasta `Tableau Content Migration Tool Plans` no diretório Meus documentos. Todos os planos de migração são salvos com uma extensão `.tcmx`, com planos recentemente acessados listados separadamente para facilitar a seleção:

![Caminho para criar um novo plano, procurar um plano e visualizar planos recentes.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-recent.png)

Você pode selecionar um plano acessado recentemente e duplicá-lo para modificar o plano e salvá-lo como um novo plano. Selecione o plano que deseja copiar e clique em Duplicate.

![Um ícone duplicado.](/tableau/current/pt-br/server/pt-br/Img/cmt-icon-duplicate.png)

### Etapa 2: planejamento

O Content Migration Tool o guia pela criação ou edição do plano de migração em seis etapas.

Clique em cada etapa para obter instruções detalhadas:

- [Planos de migração: sites](https://help.tableau.com/current/server/pt-br/cmt-plan_servers.htm)
- [Planos de migração: projetos de origem](https://help.tableau.com/current/server/pt-br/cmt-plan_source_projects.htm)
- [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm)
- [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm)
- [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm)
- [Planos de migração: scripts de migração](https://help.tableau.com/current/server/pt-br/cmt-plan_scripts.htm)
- [Planos de migração: opções de planejamento](https://help.tableau.com/current/server/pt-br/cmt-plan_options.htm)

### Etapa 3: migração

Depois de concluir o plano, agora você está pronto para executar o processo em lote para migração. Quando você atingir a etapa final da migração, um resumo do plano será exibido para sua verificação:

![Resumo do plano de revisão com uma lista de fontes de dados detalhando a origem da revisão, o destino, os projetos, as pastas de trabalho, as fontes de dados publicadas e o arquivamento automático.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-summary-verification.png)

Se quiser alterar qualquer aspecto do plano, clique em uma seção na barra lateral à esquerda para ir diretamente para essa fase. Quando estiver pronto, clique em Run para começar a migração.

Ao clicar em Run, a ferramenta de migração o avisará sobre os elementos não salvos do plano. Por padrão, os elementos não salvos serão salvos ao clicar em Yes. Lembre-se de que você sempre pode manter o plano anterior sem fazer alterações, duplicando-o durante a fase inicial do processo de migração.

![Opção para confirmar o salvamento do plano.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-save-confirm.png)

O plano de migração será executado e uma barra de status será exibida para mostrar o progresso geral do plano e cada pasta de trabalho sendo enviado para o servidor de destino.

![Uma barra de progresso indicando o download das pastas de trabalho de origem e dados de teste para 2019.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-status.png)

Quando o plano termina de ser executado, você pode clicar nas guias na parte inferior da tela para obter mais informações sobre a migração.

#### Pastas de trabalho publicadas

Published Workbooks detalha as pastas de trabalho recém-publicadas e os projetos para os quais elas foram migradas.

![Uma tabela exibindo pastas de trabalho publicadas, projetos e um link para visualizar os dados no Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-pub-workbooks.png)

#### Fontes de dados publicadas

Published Data Sources detalha as fontes de dados recém-publicadas e os projetos para os quais elas foram migradas.

#### Saída

A guia Output detalha o registro de migração do plano.

![Informações sobre uma execução da Ferramenta de Migração de Conteúdo do Tableau.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-output.png)

Para salvar esse log, clique em Save Log.

![Um ícone de Save Log.](/tableau/current/pt-br/server/pt-br/Img/cmt-icon-save-log.png)

#### Erros e avisos

A guia Errors and Warnings destaca todos os problemas ocorridos durante a migração.

![Uma tabela de erros e avisos, completa com mensagens, pastas de trabalho ou fontes de dados e projetos.](/tableau/current/pt-br/server/pt-br/Img/ptd-plan-errors.png)

Você pode corrigir esses problemas e executar o plano novamente. Ao completar a implantação e salvar o plano, clique em Done para finalizar.

![Um ícone de Done.](/tableau/current/pt-br/server/pt-br/Img/cmt-icon-done.png)

## Quem pode fazer isso

Um usuário do site do Tableau com uma função Explorer ou superior. Para migrar o conteúdo, você deve ter recursos de **Visualizar** e **Baixar de trabalho/Salvar uma cópia** no site de origem e direitos de Publicação no site de destino (recursos **Visualizar** e **Publicar**) para projetos de destino no local de destino. Para obter mais informações, consulte [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm).

## Outros artigos nesta seção

<!-- document id=e8ca076ec847fd22274586d45a33e11fbe461542cdc56c6327d7741d4b4a6b0c url=/tableau/current/pt-br/server/tsm_overview.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral do Tableau Services Manager

Este artigo fornece uma visão geral do Tableau Services Manager (TSM), que pode ser usado para configurar e administrar o Tableau Server.

## Funcionalidade

O TSM oferece aos administradores de servidor opções de linha de comando e com base na Web para a configuração e manutenção do Tableau Server, incluindo a execução de tarefas administrativas como fazer o backup de dados do servidor, restaurar backups, criar arquivos log e gerenciar clusters com vários nós. Por exemplo, use o TSM para realizar as tarefas a seguir:

- Configuração inicial do Tableau Server após a instalação
- Gerenciamento de configuração contínuo, inclusive edição de configurações e alteração da topologia do servidor
- Realização de tarefas administrativas, como backup, restauração e ziplogs

Para administradores familiarizados com versões anteriores do Tableau Server, o TSM substitui as ferramentas a seguir das versões anteriores do Tableau Server:

- Utilitário de configuração do Tableau Server
- Utilitário de linha de comando tabadmin
- Tableau Server Monitor

## Componentes

O TSM consiste-se em _serviços_ (chamados _processos_ nesta documentação) e _clientes_. Os processos do TSM são serviços administrativos que gerenciam os processos do Tableau Server. Os processos do TSM são executados continuamente após a inicialização do TSM, mesmo quando o resto do Tableau Server estiver off-line.

Os processos do TSM que executam mesmo quando o Tableau Server está interrompido incluem:

- Agente de administração
- Controlador de administração
- Serviço de arquivo do cliente (Client File Service)
- Serviço de coordenação (com base no Apache Zookeeper™)
- Gerenciador de serviço
- Serviço de licenciamento

Para obter mais informações sobre os processos do TSM e do Tableau Server, consulte [Processos do Tableau Server](https://help.tableau.com/current/server/pt-br/processes.htm).

## Autenticação TSM

Se a interface do usuário da Web do TSM, a interface da linha de comando ou a API do TSM for usada, será necessária a autenticação no Tableau Server antes de realizar as tarefas administrativas. Essa conta de usuário é diferente das contas de usuário do Tableau Server, incluindo os administradores do Tableau Server e os administradores de site.

Faça a autenticação no TSM com um usuário existente no computador do Tableau Server. Esta conta de usuário TSM deve usar autenticação com senha. Por padrão, a conta de usuário TSM deve ser um membro do grupo Administradores no computador onde o Tableau Server está sendo executado. Como alternativa, você pode especificar um grupo Windows para administração TSM depois de ter instalado o Tableau Server. Consulte [Configurar um grupo de administração do TSM personalizado](https://help.tableau.com/current/server/pt-br/security_tsm_admin_group.htm).

## Conexão de clientes do TSM

Como uma medida de segurança, só é possível se conectar ao TSM com clientes (CLI, interface do usuário na Web, Rest API) pelo HTTPS. Isso ocorre porque o TSM permite realizar tarefas administrativas e estabelecer conexão com o TSM a partir de outros computadores.

Ao se conectar a um cliente do TSM, é necessário se conectar à instância do Tableau Server que executa o serviço do Controlador de administração do TSM.

Como prática recomendada de segurança, não exponha a porta TSM (por padrão, `8850`) para a internet.

**Observação**: a ferramenta CLI do TSM não requer credenciais de administrador em alguns cenários. Especificamente, se a conta que está conectado for um membro do grupo TSM autorizado, não será necessário fornecer credenciais para executar comandos ao executar o CLI do tsm localmente. Para obter mais informações, consulte [Autenticação com a CLI tsm](https://help.tableau.com/current/server/pt-br/tsm.htm#Authenti).

As conexões HTTPS do TSM dependem de um certificado autoassinado gerado pelo instalador do Tableau Server. Este certificado é o certificado CA de instalação do Tableau que assina os certificados SSL que o Tableau cria para codificar o tráfego pelo HTTP. O certificado CA de instalação do Tableau deve ser confiado pelos sistemas que se conectam ao Controlador de administração do TSM.

O cliente TSM CLI valida a confiança do certificado de um armazenamento diferente do usado pela interface do usuário na Web do TSM. O cliente TSM CLI faz referência ao armazenamento confiável no repositório de chaves local do Java para validar a confiança de certificados CA. Como a interface do usuário na Web do TSM deve estabelecer conexão com um navegador da Web, a confiança é validada com o repositório de chaves confiável do sistema operacional. A diferença em como os certificados CA são armazenados determina cenários de configuração de confiança diferentes, como demonstrado a seguir:

- Para a interface do usuário na Web do TSM e comunicações do CLI no Tableau Server, a confiança do certificado é configurada por padrão como parte da instalação, bootstrap do nó e processos de atualização. O certificado CA de instalação do Tableau é adicionado ao armazenamento confiável no repositório de chaves do Java e no repositório de chaves de raiz confiável do Windows. Isso permite acessar o TSM de qualquer computador no cluster sem uma configuração adicional.
- Para conexões TSM CLI de computadores remotos, você será solicitado a confiar no certificado CA de instalação do Tableau na primeira vez que se conectar ao Tableau Server que executa o Controlador de administração do TSM. Você pode optar por confiar no certificado CA e, nesse caso, não será solicitado novamente neste computador até que o certificado expire (o padrão é de 4 anos). Ou poderá se conectar com uma confiança única ao executar o comando do TSM com o sinalizador `--trust-admin-controller-cert` .
- Para conexões da interface do usuário na Webd o TSM de computadores remotos, o navegador pedirá que confie no host que executa o serviço do Controlador de administração do TSM.

<!-- document id=8ab46cd9c0ffefad93b5bd4ffcf55c171a6918c54827b8bc2597594af56ef701 url=/tableau/current/pt-br/server/sites_intro.md -->

[Pular para o conteúdo principal](#main-content)

# Visão geral dos sites

Os tópicos nesta seção descrevem o conceito do Tableau Server de um site e os aspectos de trabalhar com vários sites. Os tópicos incluem o tipo de autenticação que cada site usa, e o que saber sobre as licença de usuário e o acesso de nível de administrador aos sites.

## O que é um site

Você pode estar acostumado a usar o termo _site_ para significar "um conjunto de computadores conectados", ou talvez uma forma abreviada de "site da Web." Mas no contexto do Tableau, usamos site como referência a uma coleção de usuários, grupos e conteúdo (pastas de trabalho, fontes de dados) isolados de qualquer outro conteúdo ou grupo na mesma instância do Tableau Server. Ou seja, o Tableau Server é compatível com a locação múltipla, permitindo que os administradores de servidor criem sites no servidor para vários conjuntos de usuários e conteúdo.

Todo o conteúdo de servidor é publicado, acessado e gerenciado com base no site. Cada site tem sua própria URL e seu próprio conjunto de usuários (embora cada usuário do servidor possa ser adicionado a vários sites). O conteúdo de cada site (projetos, pastas de trabalho e fontes de dados) é completamente isolado do conteúdo de outros sites.

Para obter as recomendações de administrador de site sobre como configurar os usuários em um site, como estruturar um site para publicadores e outros usuários de conteúdo, como conceder permissões a usuários para compartilhar e gerenciar o conteúdo e assim em diante, consulte a seção [Gerenciar sites individuais](https://help.tableau.com/current/server/pt-br/manage_site.htm).

Para obter informações sobre como os usuários podem obter conteúdo para o Tableau Server, consulte [Publicação de fontes de dados e pastas de trabalho](https://help.tableau.com/current/pro/online/windows/pt-br/publish_overview.htm) na ajuda do usuário do Tableau.

## Credenciais de autenticação e entrada

Todos os sites em um servidor usam a mesma conta de usuário Run As. Como padrão, eles usam o mesmo tipo de autenticação do usuário. Você configura ambas as configurações quando instala o Tableau Server. Para obter informações, consulte [Configurar as definições do nó inicial](https://help.tableau.com/current/server/pt-br/config_general.htm).

Os usuários com acesso a mais de um site na mesma instância do Tableau Server usam as mesmas credenciais para cada site. Por exemplo, se Jane Smith tiver um nome de usuário _jsmith_ e uma senha _MyPassword_ no Site A, ela usará essas mesmas credenciais no Site B. Quando entrar no Tableau Server, ela poderá escolher qual site deseja acessar.

## O site Padrão

O Tableau Server instala com um site denominado Padrão. Se você mantém um ambiente de site único no Tableau Server, isso torna-se o site no qual você trabalha, e no qual os usuários compartilham a análise do Tableau. Caso você adicione sites, o Padrão se torna um dos sites nos quais pode selecionar quando faz logon no Tableau Server. O Padrão é diferente dos sites que você adiciona ao sistema nos seguintes aspectos:

- Ele nunca pode ser excluído, mas, assim como os sites adicionados, ele pode ser renomeado.
- Ele armazena os exemplos e conexões de dados que são enviados com o Tableau Server.
- A URL usada em Padrão não especifica um site. Por exemplo, a URL de uma exibição denominada Profits em um site chamado Sales é `http://localhost/#/site/sales/views/profits`. A URL para essa mesma exibição no site Padrão seria `http://localhost/#/views/profits`.

## Por que adicionar ou não sites

No Tableau Server, usuários, projetos, grupos, fontes de dados e pastas de trabalho são gerenciados por site. Você pode adicionar usuários a vários sites.

Cada ambiente e suas necessidades são únicos. No entanto, como referência, os Tableau Visionaries e os Gerentes de produtos tendem a recomendar o uso de sites para necessidades reais de multilocatários. Em outras palavras, crie um novo site somente quando for preciso gerenciar um conjunto exclusivo de usuários e seu conteúdo completamente separado de outros usuários e conteúdo do Tableau.

Para obter as recomendações de administrador de site sobre como configurar os usuários em um site, como estruturar um site para publicadores e outros usuários de conteúdo, como conceder permissões a usuários para compartilhar e gerenciar o conteúdo e assim em diante, consulte a seção [Gerenciar sites individuais](https://help.tableau.com/current/server/pt-br/manage_site.htm).

**Exemplos em que faz sentido usar sites**

- Você é um consultor que gerencia a análise do Tableau para vários clientes e deseja criar um site para cada cliente, para garantir que os dados de um cliente não sejam expostos para os outros.
- Você deseja permitir o acesso de usuário Convidado a uma área pequena e restrita do servidor.

**Exemplos de quais projetos podem ter mais eficiência que os sites**

- Um processo de desenvolvimento de conteúdo no qual as fontes de dados e os relatórios evoluem da área de teste para fases de produção.
    
    Migrar usuários e conteúdo de um site para outro é um processo trabalhoso. Embora você possa ter boas razões para usar sites para este processo e similares, ao criar sites, você, como administrador do site, cria sua carga de manutenção contínua. Para cada atualização de configuração feita para um site (por exemplo, criando novos projetos e definindo permissões), você geralmente precisaria duplicar o mesmo trabalho em cada site adicional.
- Você quer separar áreas do servidor por área funcional.
    
    Dentre um grupo de usuários do Tableau, é comum alguns usuários precisarem acessar o conteúdo em várias áreas. O uso de sites encorajaria a publicação das mesmas fontes de dados e relatórios em vários sites. Isso leva à proliferação da fonte de dados e pode prejudicar o desempenho do servidor. O uso de projetos é uma maneira mais simples de trabalhar com este cenário.

Para obter ideias adicionais, consulte os recursos a seguir:

- [Por que usar projetos](https://help.tableau.com/current/server/pt-br/projects.htm#why-projects) no tópico Projetos de usuário para gerenciar o acesso de conteúdo.
- Discussões sobre os sites nos fóruns da Comunidade do Tableau. [Aqui está o link](https://community.tableau.com/thread/139824 "Abra a discussão no fórum do Tableau em uma nova guia do navegador.") para você iniciar.

## Acesso de nível de administrador aos sites

O Tableau Server inclui três funções de administrador: administrador do servidor, criador do administrador do servidor e explorador do administrador de site.

A função no site Administrador do servidor sempre obtém a disponibilidade de licença mais alta e permite acesso total ao Tableau Server, incluindo acesso a todo o conteúdo. Você pode encontrar mais informações sobre esta função na [Visão geral do administrador de servidor](https://help.tableau.com/current/server/pt-br/admin.htm). Os administradores de servidor também criam sites, conforme necessário. (Os administradores de site não têm permissões para fazer isso).

Um administrador do servidor pode atribuir uma das funções do site de Administrador de site a usuários, para delegar a criação e a manutenção de um usuário de site específico e da estrutura da rede. A estrutura do conteúdo habilita aos usuários do Tableau compartilhar, gerenciar e conectar as fontes de dados e as pastas de trabalho.

- Atribua o Criador do administrador de site aos administradores que também conectam-se aos dados e crie e publique as fontes de dados ou pastas de trabalho. Esta função no site assume uma licença de Creator.
- Atribua o Explorador do administrador de site se o usuário gerenciar a estrutura de conteúdo, mas não precisar editar o conteúdo propriamente dito. Esta função no site assume uma licença Explorer e permite o acesso para visualização e interação.

Como padrão, as funções de administrador de site permitem a criação e o gerenciamento de usuários e grupos, a criação de projetos para organizar o conteúdo do site, a atribuição de permissões para permitir o acesso de usuários (grupos) ao conteúdo necessário, o agendamento de atualizações de extração etc.

Um administrador do servidor pode negar as tarefas de gerenciamento de usuários dos administradores. Por exemplo, você pode fazer isso se usar a função de Criador de administrador de site para os especialistas de dados. Em outras palavras, você deseja permitir que esses usuários gerenciem conexões aos dados completos, criem e publiquem fontes de dados de “uma única fonte de verdade”, criarem projetos de alto nível e organizarem o conteúdo entre projetos sem restrições; mas não necessariamente adicionarem ou removerem usuários do site.

Para cada site, o administrador do servidor pode limitar também o acesso ao administrador, de modo que os administradores do site possam gerenciar grupos e conteúdos, mas não adicionar ou remover usuários ou definir funções de site dos usuários.

Em algumas empresas, a mesma pessoa pode ser tanto o administrador de servidor como o administrador de site de um ou mais sites. Mesmo assim, as tarefas realizadas por um administrador de site e um administrador de servidor são distintas.

## Licenciamento e limites do usuário

Você pode adicionar usuários do servidor a vários sites e definir suas funções no site e permissões definidas em cada site. Um usuário que pertence a vários sites não precisa de uma licença para cada site. Cada usuário do servidor precisa de somente uma licença. A licença que o usuário usará corresponde à maior função de site no servidor. Para saber mais sobre como as licenças e funções de site se unem, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm).

Os administradores de servidor podem usar a configuração Limitar quantidade de usuários (selecione <_nome_\> do site > > Configurações) para especificar um limite de usuários para o site ou definir um limite de função de site, que limita a quantidade de Creators, Explorers e Viewers alocados no nível do site. Para saber mais, consulte [Gerenciar os limites das funções de site](https://help.tableau.com/current/server/pt-br/site_role_limit.htm).

Somente usuários licenciados são contados. Por exemplo, se um site tiver 90 usuários licenciados (incluindo administradores), 20 usuários não licenciados, a contagem de usuários será 90. Para obter informações sobre como visualizar a quantidade de licenças e funções de site em todo o servidor, consulte [Visualizar licenças do servidor](https://help.tableau.com/current/server/pt-br/view_licenses.htm).

<!-- document id=4400c83e9b5ad33078ade57a19883cf178ae4b0fcc840606f9adac071cec6ab1 url=/tableau/current/pt-br/server/view_licenses.md -->

[Pular para o conteúdo principal](#main-content)

# Visualizar licenças do servidor

Administradores de servidor podem exibir informações de licença e chave de produto para o Tableau Server.

## Como visualizar as licenças a partir da interface do usuário na Web do Tableau Server

Como navegar até a página de Licenças no Tableau Server depende do número de sites existentes, se um único ou vários.

- Em um servidor com um único site, clique em Configurações e Licenças:
- Em um servidor de vários sites, clique em Gerenciar todos os sites no menu do site, Configurações e Licenças:
    
    **Observação:** a opção Gerenciar todos os sites é exibida apenas quando você estiver conectado como administrador de servidor.

Esta página exibe informações de todas as licenças ativadas em seu servidor, incluindo licenças com base em usuário (term) ou com base no núcleo.

1. Abra o TSM em um navegador:
    
    http://<tsm-computer-name>:8850
2. Clique em **Configuração** e, em seguida, OK.
    
    A tabela exibe a chave do produto, data de expiração e expiração da manutenção.
    
    **Observação**: a interface na Web do TSM fornece uma quantidade limitada de informações sobre o licenciamento. Use o TSM CLI ou a interface na Web do Tableau Server para ver informações adicionais sobre o licenciamento, incluindo o número de cada tipo de licença baseadas em usuário (Creator (Criador), Explorer (Explorador) e Visualizador).

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute o seguinte comando:
    
    `tsm licenses list`

O comando lista licenças ativadas na implantação do Tableau Server.

Por exemplo, um servidor com cinco licenças Creator (Criador), cinco licenças Explorer (Explorador), 100 licenças Viewer (Visualizador) e Data Management forneceria uma saída de comando semelhante a seguinte:

![Lista de quatro licenças do Tableau e detalhes sobre suas datas de expiração.](/tableau/current/pt-br/server/pt-br/Img/license_list.png)

Os seguintes campos retornam:

- **CHAVE:** uma cadeia de 16 caracteres globalmente exclusiva que identifica a licença.
- **TIPO:** descreve o tipo de licença
    - Prazo: as licenças com prazo mapeiam para um cronograma de assinatura e devem ser renovadas. A data de validade está listada no campo LIC EXP.
    - Perpétua: as licenças perpétuas são compradas uma vez e não precisam ser renovadas, mas devem ser atualizadas para atualizar o MAINT EXP ou a data de expiração da manutenção.
    - Principais: as licenças principais são licenças que mapeiam a quantidade de núcleos nos computadores que executam serviços específicos do Tableau Server. O licenciamento principal permite o acesso de um usuário convidado a exibições no servidor ou inseridas a outros servidores da Web. As licenças principais também permitem usuários ilimitados Explorer (Explorador) e Viewer (Visualizador).
- **CREATOR:** a quantidade de licenças Creator (Criador) emitidas para a implantação do Tableau Server.
- **EXPLORER:** a quantidade de licenças Explorer (Explorador) emitidas para a implantação do Tableau Server.
- **VIEWER:** a quantidade de licenças Viewer (Visualizador) emitidas para a implantação do Tableau Server.
- **GERENCIAMENTO DE DADOS**: o Tableau Server é licenciado com Data Management (`True` /`False`). Consulte [Sobre Data Management](https://help.tableau.com/current/server/pt-br/dm_overview.htm).
- **ACESSO DE CONVIDADO**: o Tableau Server é licenciado para um usuário convidado. Consulte [Usuário Convidado](https://help.tableau.com/current/server/pt-br/users_guest.htm). A capacidade de aproveitar um usuário convidado requer licenciamento principal. Veja o campo TYPE.
- **LIC EXP**: a data de expiração da licença e que o Tableau Server deixará de funcionar. As licenças com prazo expiram. Veja o campo TYPE. Visite o [Portal do Cliente](https://customer.tableausoftware.com/) do Tableau para atualizar as licenças.
- **MAINT EXP**: aplica-se apenas a licenças perpétuas antigas (TYPE = Perpétua). Para licenças com prazo, este campo exibirá `N/A`. MAINT EXP exibe a data em que expira o contrato de manutenção da implantação Tableau Server. Para atualizar a chave de manutenção da licença, consulte [Atualizar data de expiração e atributos da chave do produto](https://help.tableau.com/current/server/pt-br/license_refresh.htm). Visite o [Portal do Cliente](https://customer.tableausoftware.com/) do Tableau para ver o histórico de compras de manutenção e comprar uma manutenção adicional.
- **UPDATABLE**: especifica se a licença é uma licença de assinatura updatable (`True`/`False`.
- **LBLM**: especifica se o gerenciamento de licenças baseado em login (LBLM) está ativado para a implantação do Tableau Server (`True`/ /`False`). Quando habilitado, o LBLM permite que os usuários façam logon no Tableau Server para licenciar sua instância do Tableau Desktop ou Prep, em vez de inserir uma chave de produto. Para obter mais informações sobre LBLM, consulte [Gerenciamento de licenças baseadas em logon](https://help.tableau.com/current/server/pt-br/license_lblm.htm).
- **SERVER MANAGEMENT**: o Tableau Server é licenciado para Advanced Management (Server Management Add-on) (`True`/`False`). Para obter mais informações sobre o Advanced Management, consulte [Sobre o Tableau Advanced Management no Tableau Server](https://help.tableau.com/current/server/pt-br/itm_intro.htm).

**Observação**: os termos de licença de usuários Creator (Criador), Explorer (Explorador) e Visualizador são definidos de acordo com os termos da licença com baseadas em usuário (term license), se presente. Sendo assim, um servidor com apenas uma licença com base em núcleo terá usuários e acesso de convidado Explorer (Explorador) e Visualizador ilimitados, mas não usuários Creator (Criador). Para saber mais, consulte [Usar licenças baseadas em função em um servidor com licenciamento baseado em núcleo](https://help.tableau.com/current/server/pt-br/licensing_migrate_from_core.htm#user-based-with-core).

<!-- document id=03053ab2da4e1d2645cc508fdcbaf70c7e48a0c86da4659b6c1ee0e4f94f9e27 url=/tableau/current/pt-br/server/version_server_view.md -->

[Pular para o conteúdo principal](#main-content)

# Visualizar versão do servidor

A versão do Tableau Server que você está executando é importante: Ela determina a funcionalidade e os recursos aos quais você tem acesso. A versão também é importante ao atualizar, pois, em alguns casos, a forma como você atualizada depende de qual versão você está atualizando e para qual versão atualizará. Saber a versão é fácil, uma vez que aprende a localizá-la.

- Visualizar a versão no Tableau Server—Todos os usuários do servidor podem ver a versão do Tableau Server no menu de Ajuda, na interface do usuário na Web do servidor.
- Visualizar a versão no Tableau Services Manager (TSM)—Os administradores do TSM podem visualizar as versões do TSM e do Tableau Server na linha de comando (CLI) do TSM.

## Visualizar a versão do servidor a partir da interface do usuário na Web do Tableau Server

- Enquanto conectado ao Tableau Server, clique no ícone de informações (![Ícone Informações.](/tableau/current/pt-br/server/pt-br/Img/icon_info.png)) e Sobre o Tableau Server.
    
    ![Um menu suspenso com opções para Ajuda de pesquisa, Ajuda do servidor, Suporte e Sobre o Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/help_menu.png)
    
    A versão do Tableau Server está listada na caixa de diálogo Sobre o Tableau Server:
    
    ![Uma caixa de diálogo com informações sobre a versão e direitos autorais do Tableau Server.](/tableau/current/pt-br/server/pt-br/Img/about_server_windows.png)

## Visualizar a versão do servidor e a versão do TSM a partir da linha de comando do TSM

1. Abra um prompt de comando como administrador no nó inicial (o nó onde o TSM está instalado).
2. Execute o seguinte comando:
    
    `tsm version`

A saída exibe as versões do Tableau Services Manager (TSM) e do Tableau Server.

Por exemplo:

C:\\>tsm version  
Tableau Services Manager command line version 20182.18.1214.0751.  
Tableau Server version 20182.18.1214.0751.

## Versão curta, versão completa e version\_code

Na maioria dos casos, quando precisar saber o número de versão, é preciso saber a versão “curta”. Esse número de versão é apresentado na caixa de diálogo Sobre o Tableau Server e é formado por três partes: versões principal, reduzida e de manutenção. A versão curta tem este formato: `nnnn.n.n`. Por exemplo: `2018.2.5`.

Uma versão completa inclui os números da versão principal e reduzida, assim como outras informações específicas da criação, e tem o seguinte formato: `nnnnn.nn.nnnn.nnnn`, por exemplo: 20182.18.1214.0751. Ao ver uma referência ao `<version_code>` nesta documentação, significa a versão completa. A referência mais comum a este `version_code`, ou versão completa na documentação, é quando estamos discutindo os locais ou caminhos de instalação para os scripts ou diretórios bin.

O Tableau Server é instalado em uma pasta `\packages`, em locais que incluem a versão completa no nome do caminho. Isso significa que está acessando um local dentro do diretório `\packages`, é necessário incluir a versão completa. Por exemplo, a pasta `\scripts` : Como padrão:`C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`.

Por exemplo: `C:\Program Files\Tableau\Tableau Server\packages\scripts.20182.18.1214.0751`

### Localizar o número da versão completa

Esta versão completa também é apresentada na caixa de diálogo Sobre o Tableau Server, entre parênteses:

![Uma caixa de diálogo com o número da versão do Tableau Server, 2018.2.5 (20182.18.1214.0751) e Windows de 64 bits.](/tableau/current/pt-br/server/pt-br/Img/about_server_windows-long.png)

<!-- document id=6c3863b70d199eea3da1c78f0c787856863d49641c9ea36980a63ee715155947 url=/tableau/current/pt-br/server/server_process_vizql-data-service.md -->

[Pular para o conteúdo principal](#main-content)

# VizQL Data Service do Tableau Server

O VizQL Data Service (VDS) é uma API que permite acessar fontes de dados publicadas no Tableau por meio de consultas programáticas em vez de visualizações.

Para tornar o VizQL Data Service altamente disponível, configure um ou mais processos do VizQL Data Service para serem executados em vários nós do cluster.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">VizQL Data Service</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo de VizQL Data Service é visível na Página de status, a menos que o serviço tenha sido desabilitado. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do VizQL Data Service são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>vizqldataservice</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha em um processo do VizQL Data Service? Consultas executadas por meio do processo do VizQL Data Service falharão, resultando na perda de acesso direto de todas as consultas programáticas às fontes de dados publicadas em aplicativos do cliente, fluxos de trabalho automatizados, etc. A interface do usuário do Tableau Server e a criação de visualizações não dependem do VizQL Data Service para funcionar.

O processo padrão do VizQL Data Service em execução em um nó é um. Alta disponibilidade requer a configuração de instâncias redundantes do VizQL Data Service e do VizData Service. Se vários processos do VizQL Data Service estiverem em execução, a falha de um processo único resultará na falha de quaisquer consultas e na perda de dados da consulta no momento da falha. Quaisquer solicitações futuras serão reencaminhadas para os outros processos do VizQL Data Service em funcionamento no cluster do Tableau Server.

<!-- document id=f93890edf7aef6de27e2b32cd73d363d924e18b9f1228136290682b5d9fc7855 url=/tableau/current/pt-br/server/server_process_vizql-server.md -->

[Pular para o conteúdo principal](#main-content)

# VizQL Server do Tableau Server

O VizQL Server carrega e renderiza exibições e calcula e executa consultas. Para obter alta disponibilidade para o processo do VizQL Server, configure uma ou mais instâncias para execução em vários nós.

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Processo</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>VizQL Server</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><strong>Status</strong></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">O status do processo do VizQL Server é visível na página Status. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/service_viewstatus.htm" class="xref">Exibir o status de processos do servidor</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><strong>Registros</strong></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Os logs gerados pelo processo do VizQL Server são encontrados em <code><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\</code>vizqlserver</code>. Para obter mais informações, consulte <a href="https://help.tableau.com/current/server/pt-br/logs_loc.htm" class="xref">Locais de arquivo de registro e registros do Tableau Server</a>.</td></tr></tbody></table>

O que acontece quando ocorre uma falha em um processo do VizQL Server? Se houver apenas um processo do VizQL Server e ele falhar, o Tableau Server não poderá mais renderizar nenhuma exibição. A alta disponibilidade requer a configuração de processos do VizQL redundantes. Uma configuração razoavelmente típica é composta de dois a quatro processos do VizQL Server em cada nó.

Isso atende simultaneamente a necessidade de alta disponibilidade e escalabilidade. Se vários processos do VizQL Server estiverem em execução, a falha de um processo único resultará na falha de quaisquer solicitações e na perda de dados da sessão no momento da falha. Quaisquer solicitações futuras serão reencaminhadas para os outros processos do VizQL Server em funcionamento no cluster do Tableau Server.

## Monitoramento de memória do VizQL Server

**Importante:** como prática recomendada, recomendamos que você deixe as configurações com os valores padrão, a menos que seja instruído pelo Suporte técnico do Tableau.

A partir da versão 2026.2.0, o VizQL Server monitora seu uso de memória e interrompe sessões ociosas, se necessário.

### Como o VizQL Server monitora o uso de memória

No Tableau Server versão 2026.2.0 e posterior, a chave `[native_api.close_old_sessions_if_memory_pressure_high](https://help.tableau.com/current/server/pt-br/cli_configuration-set_tsm.htm#close_old_sessions_if_memory_pressure_high)` está definida como `true`. Com essa configuração habilitada, o VizQL Server monitora o uso de memória cada vez que uma nova sessão é criada, e se o uso de memória excede o limite definido por `native_api.max_memory_pressure_percentage`, as sessões ociosas mais antigas são fechadas para reduzir o uso de memória. Quanto maior o uso de memória, mais sessões ociosas antigas serão fechadas. As sessões que estão ativamente em uso, com o usuário interagindo com uma exibição, nunca são fechadas. A recuperação de memória é feita em segundo plano e não torna mais lenta ou trava a criação de uma nova sessão.

O monitoramento do uso de memória VizQL depende de várias chaves de configuração que interagem:

| Chave de configuração | Tipo | Padrão | Descrição |
| --- | --- | --- | --- |
| `native_api.memory_limit_enabled` | Cadeia de caracteres | `true` | Controla se o monitoramento de memória ocorre. Se estiver definido como `false`, nenhum monitoramento de memória ocorre. |
| `native_api.close_old_sessions_if_memory_pressure_high` | Cadeia de caracteres | `true` | Determina se sessões antigas e ociosas serão fechadas quando a memória for curta. |
| `native_api.max_memory_pressure_percentage` | Inteiro | `90` | A porcentagem de uso de memória na qual a recuperação proativa de sessão começa. (A base de comparação é o limite de memória do processo, que é controlado por `native_api.memory_limit_per_process_gb` ou `native_api.memory_limit_per_process_percentage`). |
| `native_api.goal_memory_pressure_percentage` | Inteiro | `80` | A porcentagem de uso de memória de destino que a recuperação tenta alcançar. Deve ser menor que `max_memory_pressure_percentage`. |
| `native_api.memory_limit_per_process_gb` | Inteiro | `0` | Um limite absoluto de memória por processo em gigabytes. |
| `native_api.memory_limit_per_process_percentage` | Inteiro | `70` | Uma porcentagem da memória física total para calcular o limite de memória do processo. Usado somente quando `native_api.memory_limit_per_process_gb` == 0. |
|   |   |   |   |