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...
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.
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úblicoouextraçã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
dataedata/horaagora 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
.hyperlocal. 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
.tdsfoi 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.
Versão de lançamento do Connector 2.1.0 | |
|---|---|
Versão | Descrição |
v2.1.0 |
|
v2.0.1 |
|
Tipo de conexão | Ferramentas do Alteryx. A versão mais recente está disponível no Alteryx Marketplace. |
Tipo de suporte | Leitura/Gravação/Publicação |
Validado em | Tableau SDK 10.3 (compatível com Geografia) |
Versão | Descrição |
v1.5.4 |
Problemas conhecidos
|
v1.5.3 |
Problemas conhecidos
|
v1.5.2 |
|
V1.5.1 |
|
v1.5.0 |
|
v1.4.3 |
|
v1.4.2 |
|
v1.4.1 |
|
v1.4.0 |
|
v1.3.1 |
Problemas conhecidos
|
v1.3.0 |
Problemas conhecidos
|
v1.2.0 |
Problemas conhecidos
|
v1.1.1 |
|
v1.1.0 |
|
v1.0.1 |
Limitação conhecida:
|
Ferramentas do Alteryx usadas para conexão
Importante
A ferramenta Dados de Entrada lê os dados como um arquivo do Tableau Hyper Data Extract (HYPER). Esta ferramenta suporta apenas arquivos locais.
A ferramenta Dados de Saída salva os dados como um arquivo do Tableau Hyper Data Extract (HYPER). Esta ferramenta suporta apenas 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
Gerenciador de Conexões de Dados
As ferramentas do Tableau 1.2.0 e versões posteriores são compatíveis com o Gerenciador de Conexões de Dados para um armazenamento mais fácil e seguro de suas credenciais. Crie uma conexão com o Tableau e reutilize facilmente as credenciais armazenadas em fluxos de trabalho que incluem as ferramentas do Tableau. O Alteryx Server exige credenciais armazenadas para executar com êxito os fluxos de trabalho publicados.
Habilitar o AMP Engine
Certifique-se de ter o AMP Engine habilitado para os fluxos de trabalho que contêm a ferramenta Tableau 1.2.0 e versões posteriores.
Acesso à API
As ferramentas do Tableau exigem acesso de API à sua instância do Tableau. Para que as ferramentas do Tableau funcionem corretamente, verifique com o administrador do Tableau para garantir que o CORS está habilitado na sua instância e que o valor file:// seja adicionado aos hosts permitidos.
Limitações
O Tableau não é compatível com autenticação de logon único ou de vários fatores. Só é possível fazer login usando um nome de usuário e senha ou tokens de acesso pessoal. Os tokens de acesso pessoal são tokens de autenticação de longa duração que permitem executar a automação com APIs REST da Tableau sem exigir credenciais codificadas ou login interativo.
Como só é possível pesquisar por nomes completos, é preciso informar uma fonte de dados e o nome, e não apenas um nome.
A partir da versão 2021.2 do Designer, os campos de texto são lidos em arquivos .hyper como V_WString com o tamanho máximo para evitar a perda de dados. Para contornar isso, você pode utilizar a ferramenta Campo Automático ou a ferramenta Selecionar antes de gravar os dados em qualquer outro formato.
Não é possível executar múltiplas ferramentas do Tableau simultaneamente com o mesmo token de acesso pessoal devido a uma limitação do Tableau em que os usuários não podem solicitar sessões simultâneas do Tableau Server com um único token de acesso pessoal. As tentativas de login em sessões simultâneas com o mesmo token de acesso pessoal encerrarão a sessão anterior e podem resultar em erros de autenticação. Para obter mais informações, consulte a documentação de ajuda do Tableau sobre tokens de acesso pessoal.



