Tableau

O conector do Tableau permite que você se conecte ao Tableau no Designer.

O Tableau está disponível como uma fonte de dados na ferramenta Dados de Entrada e Dados de Saída, e como as ferramentas autônomas Entrada do Tableau e Saída do Tableau.

Nova versão do conector no Designer

O conector do Tableau agora faz parte da experiência de conectores do Alteryx One. Revise com atenção as informações nesta página para garantir o uso apropriado e correto das ferramentas.

Para atualizar o conector do Tableau nos fluxos de trabalho do Designer, você pode usar o utilitário de migração de fluxo de trabalho.

Configuração do conector do Tableau

O Tableau está disponível no Designer versões 2025.1 Patch 5 e 2025.2 Patch 3 ou versões posteriores como uma fonte de dados para a ferramenta Dados de Entrada e Dados de Saída. Para saber mais sobre as ferramentas, consulte Ferramentas Entrada e Saída.

Pré-requisitos

Antes de prosseguir, certifique-se de ter concluído os seguintes pré-requisitos:

Requisito	Detalhe
Versão do Designer	Designer 2026.1 ou posterior (necessário para conector unificado e também necessário especificamente para opções de saída, como versão de arquivo Hyper e seleção de esquema de banco de dados)
Versão do Tableau Server	Tableau Server 2023.3 ou posterior, usando a API REST do Tableau 3.21
AMP	Deve estar habilitado
DCM	Você deve habilitar o DCM no Designer. Acesse Opções > Configurações avançadas > DCM para habilitá-lo
Tipo de implantação do Tableau	Tableau Server (auto-hospedado, no local ou Cloud privado) usando o URL do seu servidor

Instalar o conector

Você pode instalar facilmente a versão mais recente do conector do Tableau do Designer por meio dos Add-Ons. Esse é o método de instalação recomendado que permite navegar, instalar e atualizar conectores sem sair do Designer ou visitar o Alteryx Marketplace.

Para instalar o conector...

No Designer, vá para Add-Ons > Gerenciar add-ons do Marketplace. Você verá uma lista de conectores disponíveis.
Clique em Ferramentas do Tableau e em Instalar. O Designer baixa e instala o pacote. O Designer pode precisar ser reiniciado para concluir a instalação.
Após a conclusão da instalação e da configuração, o conector do Tableau estará disponível nas ferramentas Dados de Entrada e Dados de Saída.

Configurar uma conexão

Para se conectar ao Tableau usando o DCM...DCM - Designer

Arraste a ferramenta Dados de Entrada ou Dados de Saída para a tela e selecione Conectar aos dados.
Em Configuração do conector , selecione Criar ou procurar uma conexão de dados.
Se você já criou uma conexão do Tableau antes, pode selecionar a conexão na guia Recentes.
Clique em + Novo. Na lista de tecnologias, selecione Tableau.
Selecione Configurar conexão. A janela Conexões é aberta.
Clique em + Novo.
Especifique o nome da conexão, o Nome da fonte de dados e o URL do servidor.
Na seção Credenciais, selecione seu método de autenticação e insira o nome da credencial. Para obter mais informações, consulte Métodos de autenticação.
Clique em Salvar.
Clique em Conectar. O Tableau pode solicitar autenticação.
Na janela do navegador de arquivos, selecione o arquivo a ser lido ou gravado.
Selecione a configuração de leitura ou gravação na janela Opções.
Clique em Confirmar para criar uma conexão com o arquivo. Você pode continuar criando seu fluxo de trabalho.

Notas de versão do conector do Tableau

Versão de lançamento do Connector 2.1.0
Versão	Descrição
v2.2.0	Added support for testing Tableau connections in DCM. Added Tableau Cloud support for Input and Output tools, with Site required for Tableau Cloud connections.
v2.1.0	Disponível no Designer 2026.1 ou posterior, Tableau Server 2023.3 ou posterior (API REST do Tableau 3.21). Requer AMP e DCM. A entrada lê uma fonte de dados de tabela única com colunas digitadas. A saída é compatível com as versões de arquivo Hyper V1 a V4, múltiplos esquemas de banco de dados, Gravar em uma única tabela com um nome de sua escolha. Acrescentar e Substituir são baseadas em API. Corrigido um problema em que a migração tentava incorretamente uma atualização de credenciais para conexões sem um token OAuth (o Tableau usa PAT ou nome de usuário e senha).
v2.0.1	Entrada e Saída (tabela única). Adição de Acrescentar baseada em API, caminhos de projeto manuais e dinâmicos, Hyper V2, pesquisa parcial para projetos e fontes de dados e agrupamento automático de gravações grandes. Corrigido um problema em que gravações grandes falhavam com um erro. Corrigido um problema em que fontes de dados ew não eram criadas com um carimbo de data/hora anexado ao nome. Corrigidos problemas de paginação, pesquisa e navegação de projeto e fonte de dados.

Ferramentas Entrada e Saída

As ferramentas Entrada e Saída do Tableau são usadas para ler e gravar no Tableau.

Entrada do Tableau

A ferramenta Entrada do Tableau lê dados de uma fonte de dados publicada do Tableau.

Autenticar por meio de uma conexão do Tableau do DCM.
Navegue por sites e projetos em uma árvore, com paginação e pesquisa parcial, ou insira um caminho.
Selecione uma fonte de dados de tabela única para ler.
As colunas são retornadas como dados digitados (por exemplo, Data e Data e Hora são lidas como tipos de data e data/hora).

Saída do Tableau

A ferramenta Saída do Tableau grava dados no Tableau e os publica como uma fonte de dados (uma extração Hyper). Esta ferramenta substitui a ferramenta Publicar no Tableau Server mais antiga.

Autenticar por meio de uma conexão do Tableau do DCM.
Escolha ou defina o destino: navegue até um projeto e uma fonte de dados ou insira o caminho do projeto e o nome da fonte de dados (incluindo caminhos dinâmicos orientados por campos ou parâmetros).
Gravar em uma única tabela com um nome de sua escolha.
Escolha a ação quando a fonte de dados já existir: crie uma nova fonte de dados, renomeie e crie, substitua a fonte de dados existente (preserva o ID da fonte de dados e cria uma nova versão) ou acrescente linhas à fonte de dados existente. A ferramenta Acrescentar e Substituir é executada por meio da API do Tableau.
Selecione a versão do arquivo Hyper (V1 a V4) e o esquema do banco de dados (por exemplo, público ou extração). Essas opções exigem o Designer 2026.1 ou posterior.

Modelo de objeto

Entender a hierarquia do Tableau ajuda você a configurar as ferramentas corretamente:

Site: as organizações geralmente usam sites separados por unidade de negócios ou ambiente. Cada site tem seus próprios usuários, projetos, pastas de trabalho e fontes de dados.
Projeto: usado para organizar o conteúdo. Os projetos podem ser aninhados.
Pasta de trabalho: contém uma ou mais planilhas (visualizações, painéis, histórias) e usa fontes de dados para seus dados subjacentes.
Fonte de dados: a conexão com os dados que as pastas de trabalho usam. Pode ser uma conexão em tempo real ou uma extração. Uma fonte de dados expõe uma ou mais tabelas.
Tabela: um conjunto de dados estruturado dentro de uma fonte de dados. Quando o Alteryx publica no Tableau, ele grava em uma tabela dentro de uma fonte de dados, armazenada como uma extração .hyper.

Métodos de autenticação

O conector unificado é autenticado por meio do DCM. O Tableau é compatível com três métodos de autenticação. Use a tabela abaixo para escolher a melhor opção para o seu caso de uso.

Método	Desktop	Cloud (Alteryx One)
Token de acesso pessoal (PAT)	Sim	Não
Nome de usuário e senha do Tableau Server	Sim	Não
Gerenciador de conexões do Tableau (TCM)	Não	Não

Nota

O Tableau Server (Cloud auto-hospedado, no local ou privado) se conecta usando o URL do seu servidor e oferece suporte a um token de acesso pessoal (PAT) ou a um nome de usuário e senha do Tableau Server como credenciais.
O Tableau Cloud (SaaS, hospedado pelo Tableau) usa um URL específico do site na forma https://<site>.online.tableau.com. O suporte do Tableau Cloud para o conector unificado está em andamento e ainda não está disponível.

Migração para o Unified Tableau

Se você já usa o conector do Tableau no Alteryx, leia a seção abaixo. Ele mostra o que foi alterado na versão unificada.

Parâmetro	Conector herdado (SDK do Python)	Conector unificado
Plataformas e ferramentas	Desktop (Entrada e Saída)	Desktop (Entrada e Saída) no GA Cloud em andamento
Estrutura	SDK do Python	Estrutura do conector unificado
Comunicação/API	API REST herdada do Tableau	API REST do Tableau 3.21 (requer o Tableau Server 2023.3 ou superior)
Autenticação	Autenticação herdada	Token de acesso pessoal (PAT) ou nome de usuário e senha do Tableau Server
Modelo de conexão	Nível da ferramenta/não DCM	DCM

Os fluxos de trabalho existentes podem ser migrados usando o utilitário de migração do fluxo de trabalho do Alteryx no Designer 2025.1 Patch 5 ou posterior. No entanto, ele só está disponível no desktop. Para obter mais informações, consulte Utilitário de migração de fluxo de trabalho.

Limitações

Os valores de data e data/hora agora mostram zeros à direita na leitura (dígitos extras de microssegundo). Para restaurar a formatação anterior, adicione uma ferramenta Selecionar ou Amostra em etapas posteriores para cortar os zeros extras.
A ferramenta Saída do Tableau não pode publicar uma fonte de dados a partir de um campo decimal fixo que foi lido a partir de um arquivo .hyper local. Converta o campo em Duplo (por exemplo, com uma ferramenta Selecionar) antes da ferramenta Saída do Tableau. Isso também ajuda a evitar conflitos durante operações posteriores de Acrescentar ou Substituir na mesma fonte de dados.
As operações Atualizar, Upsert e Carregar o arquivo hyper não são mais compatíveis. Se o seu fluxo de trabalho depender de Atualizar ou Upsert, reformule-o para usar Substituir (para substituir uma fonte de dados) ou Acrescentar (para adicionar linhas).
O conector agora oferece suporte apenas a fontes de dados de tabela única. Você grava em uma única tabela com um nome de sua escolha e, como resultado, o suporte a arquivos .tds foi removido. Se o fluxo de trabalho usa fontes de dados de múltiplas tabelas, reformule-o para publicar em uma fonte de dados de tabela única.
Não é possível criar projetos novos ou aninhados diretamente a partir do conector. Primeiro, crie o projeto no Tableau e, em seguida, navegue até ele ou insira seu caminho na ferramenta.
A ferramenta não lista as tabelas dentro de uma fonte de dados para você escolher. Em vez disso, insira o nome da tabela manualmente.
Os métodos de conexão que não são do DCM foram removidos, portanto, todas as conexões devem ser criadas por meio do DCM, autenticadas com um PAT ou um nome de usuário e senha do Tableau Server.
O Gerenciador de Conexões do Tableau (TCM) não é compatível com Entrada ou Saída. Em vez disso, use um PAT ou um nome de usuário e senha do Tableau Server.
As opções Anexar metadados e Habilitar simulação (dry-run) não estão disponíveis para a ferramenta Entrada do Tableau na estrutura de conector unificado, no Desktop.
O conector requer o Designer 2026.1 ou posterior e o Tableau Server 2023.3 ou posterior (API REST do Tableau 3.21) para Entrada e Saída. As opções avançadas, como versão de arquivo Hyper e seleção de esquema de banco de dados, também exigem o Designer 2026.1 ou posterior.
Atualmente, o conector está disponível apenas no Desktop (principal), tanto para Entrada quanto para Saída. O suporte do Cloud está em andamento sem data confirmada. Assim que a versão Cloud for lançada, espere que o utilitário de migração continue indisponível nela, que o download local permaneça restrito à versão Desktop, que o fluxo de criação de conexões seja diferente (a criação de conexões nativas não estará disponível) e que os formatos compatíveis e os tipos de dados gerados possam diferir daqueles da versão Desktop.

Conectores autônomos do Tableau versão 1.5.7 e anteriores (descontinuado)

As ferramentas autônomas do Tableau foram descontinuadas. Instale o conector do Tableau mais recente para aproveitar os novos recursos.

July 18, 2026

Compatibilidade com o Designer (a ser discutida)

Versão de lançamento do Conector xxxx.x.x.xxxxx
ID	Description
v1.5.7	Fixed issue where Tableau Output failed to append on Overwrite/Append when using `.tds` for Data Source Metainfo. Known Issues Tableau Connector v1.5.5 Gallery authentication failures.
v1.5.6	Fixed DCM connection handling issue. Fixed an issue where Tableau Output tool failed to connect to Tableau Server with `Invalid CORS request` / `Credentials Denied` post upgrade to 2025.2 from 2024.2. Fixed issue where workflow with multiple Tableau output tools and multiple DCM connections published to wrong Tableau server. Known Issues Tableau Output fails to append on Overwrite/Append when using `.tds` for Data Source Metainfo.
v1.5.5	The Tableau tools now support reading multiple tables. The Tableau connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow. We disabled the right-click context menu in Designer for the Tableau tools to prevent unintended actions. Fixed an issue where the Tableau Output tool did not escape backslashes for UNC paths when uploading HYPER files. Fixed an issue where Tableau Output tool did not reset the table name to the default when it starts with “table”. Fixed an issue where the Tableau Output tool returened this `error: Could not init plugin AttributeError("'NoneType' object has no attribute 'split'")`. Fixed an issue where the Tableau Output tool returned an error when numeric values are 0 during update or upsert operations. Fixed an issue where resetting the table name when the project or data source changes caused an error if the name is duplicated in the Tableau Output tool. Fixed an issue where special characters in the proxy password caused an error when setting up a manual proxy server for the Tableau tools. Fixed an issue where the Tableau tools added proxy credentials to the manual proxy settings even when the proxy does not require them. Fixed an issue where the Tableau Output tool returned a `Datatype conversion failed` error when spatial fields contain null values.
v1.5.4	É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores. Exige o AMP Engine. O Alteryx Server exige credenciais armazenadas no DCM para executar fluxos de trabalho. O conector do Tableau padroniza a precisão de hora e data/hora para milissegundos para evitar zeros extras à direita, enquanto ainda oferece suporte à resolução de nanossegundo quando exigido pelo fluxo de trabalho. Corrigidos os problemas em que a conexão do DCM retornava estes erros: O objeto "NoneType" não tem atributo "get" (TPM-4831) Falha ao processar a fonte de dados <DATASOURCE> selecionada (TPM-4824) Falha ao fazer login no Tableau (TPM-4732) serverUrl (TPM-4732) Corrigido o problema em que o carregamento de um arquivo HYPER falhava com <class "KeyError">: "#1" e a lista estava fora do intervalo de índice. (TPM-4708) Corrigido o problema em que as ferramentas do Tableau retornavam o erro "temp_table". (TPM-4609) Known Issues Os caracteres especiais na senha do proxy causam erros na configuração manual do servidor proxy. Usar getIpAddress() em um arquivo PAC retorna o endereço IP local no PyPAC. (TPM-4515)
v1.5.3	É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores. Exige o AMP Engine. O Alteryx Server exige credenciais armazenadas no DCM para executar fluxos de trabalho. Adicionado o ID de conexão à janela de resultados ao usar o DCM. Corrigido o problema em que as ferramentas do Tableau publicavam dados com o ID de projeto errado ao filtrar por favorito. (TPM-4600) Corrigido o problema em que a regra de tratamento de conexão do DCM não era aplicada às ferramentas do Tableau. (TPM-4550) Corrigido o problema em que o nome do projeto principal não era exibido na configuração "Selecionar projeto". (TPM-4451) Corrigido o problema em que a ferramenta Saída do Tableau não gravava de dados SpatialObj (objeto geográfico) corretamente. (TPM-4378) Corrigido o problema em que as ferramentas do Tableau ignoravam a variável NO_PROXY se as variáveis HTTP_PROXY ou HTTPS_PROXY fossem usadas. (TPM-4347) Corrigido o problema em que a ferramenta Saída do Tableau não aderia a exceções de proxy nas configurações de LAN. (TPM-4345) Known Issues Tableau Output fails to write data to Tableau Cloud. Designer returns this error message: `unknown table 'temp_table' Context: 0xfa6b0e2f.`
v1.5.2	É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores. Exige o AMP Engine. O Alteryx Server exige credenciais armazenadas no DCM para executar fluxos de trabalho. Corrigido o problema em que as ferramentas do Tableau retornavam o erro "Índice da lista fora do intervalo". (TPM-4356) Corrigido o problema em que a ferramenta Entrada do Tableau retornava o erro "Fora dos limites". (TPM-4325) Corrigido o problema em que a ferramenta Saída do Tableau retornava um erro quando as colunas "Byte", "Data", "Hora" ou "Data/hora" estavam vazias. (TPM-4317) Corrigido o problema em que as ferramentas do Tableau retornavam o erro "Definições de coluna inconsistentes". (TPM-4315, TPM-4299, TPM-4047) Corrigido o problema em que a ferramenta Saída do Tableau não exibia dados na janela de resultados. (TPM-4297) Corrigido o problema em que a ferramenta Saída do Tableau não exibia fontes de dados corretamente. (TPM-4260) Corrigido o problema em que a ferramenta Entrada do Tableau não lia nenhum dado e não exibia nenhum erro. (TPM-4247) Corrigido o problema em que a ferramenta Saída do Tableau impedia a gravação de dados em fontes de dados com o mesmo nome em projetos diferentes. (TPM-4225) Corrigido o problema em que a ferramenta Saída do Tableau não gravava dados em um arquivo definido por um caminho relativo. (TPM-3712) Corrigido o problema em que a ferramenta Saída do Tableau em uma macro não funcionava como o esperado. (TPM-3502)

Ferramentas do Alteryx usadas para conexão

Ferramenta Dados de Entrada	Ferramenta Dados de Saída Ferramenta Dados de Saída
Ferramenta Entrada do Tableau	Ferramenta Saída do Tableau
Ferramenta Publicar no Tableau Server

Importante

A ferramenta Dados de Entrada lê os dados como um arquivo do Tableau Hyper Data Extract (HYPER). Esta ferramenta tem suporte apenas para arquivos locais.
A ferramenta Dados de Saída salva os dados como um arquivo do Tableau Hyper Data Extract (HYPER). Esta ferramenta tem suporte apenas para arquivos locais.
A ferramenta Saída do Tableau cria um conjunto de dados do Tableau Hyper e o carrega no Tableau Server ou salva localmente como um arquivo do Tableau Hyper Data Extract (HYPER).
A ferramenta Publicar no Tableau Server foi descontinuada. A funcionalidade foi substituída pela ferramenta Saída do Tableau

Nesta secção: