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.
Detalhes 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 opções de tipo de arquivo, acesse [links].
Prerequisites
Ensure you have completed the following prerequisites before proceeding:
Requirement | Detail |
|---|---|
Designer version | Designer 2026.1+ (required for unified connector and also required specifically for Output options like Hyper file version and database schema selection) |
Tableau Server version | Tableau Server 2023.3+, using Tableau REST API 3.21 |
AMP | Must be enabled |
DCM | You must enable DCM in Designer. Go to Options > Advanced Settings > DCM to enable it |
Tableau deployment type | Tableau Server (self-hosted, on-prem or private cloud) using your server URL |
Install the Connector
You can easily install the latest version of the Tableau connector from Designer via the Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.
To install the connector...
In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.
Select Tableau Tools and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.
After installation and setup are complete, the Tableau connector is available from the Input Data and Output Data tools.
Set Up a Connection
To connect to Tableau using DCM...
Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.
In the Connector Setup, select Create or Browse a Data Connection.
If you've created a Tableau connection before, you can select the connection from the Recents tab.
Select + New. From the list of technologies, select Tableau.
Select Setup Connection. The Connections window opens.
Select +New.
Specify the connection name, data source name, and the server URL.
In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.
Select Save.
Select Connect. Tableau may request authentication.
Select the file to read from or write to in the file browser window.
Select the read or write configuration in the Options window.
Select Confirm to create a connection to the file. You can continue building your workflow.
Input and Output Tools
The Tableau Input and Output tools are used to read from and write to Tableau.
Tableau Input
Tableau Input reads data from a published Tableau data source.
Authenticate through a DCM Tableau connection.
Browse sites and projects in a tree, with pagination and fuzzy search, or enter a path.
Select a single-table datasource to read.
Columns are returned as typed data (for example, Date and DateTime are read as date and datetime types).
Tableau Output
Tableau Output writes data to Tableau and publishes it as a datasource (a Hyper extract). This tool supersedes the older Publish to Tableau Server tool.
Authenticate through a DCM Tableau connection.
Choose or define the destination: browse to a project and datasource, or enter the project path and datasource name (including dynamic paths driven by fields or parameters).
Write to a single table with a name of your choice.
Choose the action when the datasource already exists: create a new datasource, rename and create, overwrite the existing datasource (preserves the datasource ID and creates a new version), or append rows to the existing datasource. Append and Overwrite are performed through the Tableau API.
Select the Hyper file version (V1 through V4) and the database schema (for example,
publicorExtract). These options require Designer 2026.1+.
Object Model
Understanding the Tableau hierarchy helps you configure the tools correctly:
Site: Organizations often use separate sites per business unit or environment. Each site has its own users, projects, workbooks, and datasources.
Project: Used to organize content. Projects can be nested.
Workbook: Contains one or more sheets (visualizations, dashboards, stories) and uses datasources for its underlying data.
Datasource: The connection to data that workbooks use. It can be a live connection or an extract. A datasource exposes one or more tables.
Table: A structured dataset inside a datasource. When Alteryx publishes to Tableau, it writes into a table within a datasource, stored as a
.hyperextract.
Authentication Methods
The unified connector authenticates through DCM. Tableau supports three authentication methods. Use the table below to choose the right one for your use case.
Method | Desktop | Cloud (Alteryx One) |
|---|---|---|
Personal Access Token (PAT) | Yes | No |
Tableau Server username and password | Yes | No |
Tableau Connection Manager (TCM) | No | No |
Nota
Tableau Server (self-hosted, on-premises, or private cloud) connects using your server URL, and supports either a Personal Access Token (PAT) or a Tableau Server username and password as credentials.
Tableau Cloud (SaaS, hosted by Tableau) uses a site-specific URL of the form
https://<site>.online.tableau.com. Tableau Cloud support for the unified connector is in progress and not yet available.
Migration to Unified Tableau
If you already use the Tableau connector in Alteryx, read the section below. It walks through what has been changed in the unified version.
Parameter | Legacy Connector (Python SDK) | Unified Connector |
|---|---|---|
Platforms and Tools | Desktop (Input and Output) | Desktop (Input and Output) at GA Cloud in progress |
Framework | Python SDK | Unified connector framework |
Communication / API | Legacy Tableau REST API | Tableau REST API 3.21 (requires Tableau Server 2023.3+) |
Authentication | Legacy authentication | Personal Access Token (PAT) or Tableau Server username and password |
Connection model | Tool-level / non-DCM | DCM |
Existing workflows can be migrated using the Alteryx Workflow Migration Utility in Designer 2025.1 Patch 5 or later. However, it is only available on desktop. For more information, see workflow migration utility.
Limitations
DateandDateTimevalues now show trailing zeros on read (extra microsecond digits). To restore the previous formatting, add a Select or Sample tool downstream to trim the extra zeros.Tableau Output cannot publish a datasource from a fixed-decimal field that was read from a local
.hyperfile. Convert the field to a Double (for example with a Select tool) before the Tableau Output tool. This also helps avoid conflicts during later Append or Overwrite operations on the same datasource.Update, Upsert, and Upload Hyper File operations are no longer supported. If your workflow relies on Update or Upsert, redesign it to use Overwrite (to replace a datasource) or Append (to add rows).
The connector now supports only single-table datasources. You write to a single table with a name of your choice, and
.tdsfile support has been removed as a result. If your workflow uses multi-table datasources, redesign it to publish to a single-table datasource instead.You can't create new or nested projects directly from the connector. Create the project in Tableau first, then browse to it or enter its path in the tool.
The tool does not list the tables inside a datasource for you to pick from. Enter the table name manually instead.
Non-DCM connection methods have been removed, so all connections must be created through DCM, authenticated with a PAT or a Tableau Server username and password.
Tableau Connection Manager (TCM) is not supported on either Input or Output. Use a PAT or a Tableau Server username and password instead.
The Attach Metadata and Enable Dry Run options aren't available for Tableau Input on the unified-connector framework, on Desktop.
The connector requires Designer 2026.1+ and Tableau Server 2023.3+ (Tableau REST API 3.21) for both Input and Output. Advanced options like Hyper file version and database schema selection also require Designer 2026.1+.
Currently, the connector is available on Desktop (Flagship) only, for both Input and Output. Cloud support is in progress with no confirmed date. Once Cloud ships, expect the migration utility to remain unavailable there, local download to stay Desktop-only, the connection-creation flow to differ (built-in connection creation will not be available), and supported formats and produced datatypes to potentially differ from Desktop.
Connector Release Version 2.1.0 | |
|---|---|
Version | Description |
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.



