Tableau
El conector de Tableau te permite conectarte a Tableau en Designer.
Tableau está disponible como una fuente de datos en las herramientas Datos de entrada y Datos de salida, y como las herramientas independientes Entrada de Tableau y Salida de Tableau.
Nueva versión del conector en Designer
El conector de Tableau ahora es parte de la experiencia de conectores de Alteryx One. Revisa cuidadosamente la información de esta página para asegurarte de que estás utilizando las herramientas adecuadas de forma correcta.
Si deseas actualizar el conector de Tableau en tus flujos de trabajo de Designer, puedes utilizar la utilidad Migración de flujos de trabajo.
Detalles del conector de Tableau
Tableau está disponible en Designer 2025.1, parche 5, o versiones posteriores, y 2025.2, parche 3, o versiones posteriores, como una fuente de datos para las herramientas Datos de entrada y Datos de salida. Para obtener más información sobre las opciones de tipo de archivo, ve a [enlaces].
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 conexión | Herramientas de Alteryx. La versión más reciente está disponible en Alteryx Marketplace. |
Tipo de soporte | Leer/Escribir/Publicar |
Se validó en | Tableau SDK 10.3 (admite Spatial) |
Versión | Descripción |
v1.5.4 |
Problemas conocidos
|
v1.5.3 |
Problemas conocidos
|
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 conocidos
|
v1.3.0 |
Problemas conocidos
|
v1.2.0 |
Problemas conocidos
|
v1.1.1 |
|
v1.1.0 |
|
v1.0.1 |
Limitación conocida:
|
Herramientas de Alteryx utilizadas para establecer conexiones
Importante
La herramienta Datos de entrada lee los datos como un archivo de extracción de datos de Tableau Hyper (HYPER). Esta herramienta solo admite archivos locales.
La herramienta Datos de Salida guarda los datos como un archivo de extracción de datos de Tableau Hyper (HYPER). Esta herramienta solo admite archivos locales.
La herramienta Salida de Tableau crea un conjunto de datos de Tableau Hyper y lo carga en el servidor de Tableau o lo guarda localmente como un archivo de extracción de datos de Tableau Hyper (HYPER).
La herramienta Publicar en Tableau Server está obsoleta. La herramienta Salida de Tableau reemplazó esta funcionalidad.
Administrador de conexiones de datos (DCM)
Las herramientas Tableau 1.2.0 y versiones posteriores son compatibles con el Administrador de conexiones de datos para almacenar tus credenciales con más facilidad y seguridad. Crea una conexión a Tableau y reutiliza con facilidad las credenciales almacenadas en los flujos de trabajo en los que se incluyen las herramientas Tableau. Alteryx Server requiere credenciales almacenadas para ejecutar los flujos de trabajo publicados correctamente.
Habilitar AMP Engine
Asegúrate de tener AMP Engine habilitado para los flujos de trabajo que contienen las herramientas Tableau 1.2.0 y versiones posteriores.
Acceso a API
Las herramientas de Tableau requieren acceso de API a tu instancia de Tableau. Para que las herramientas de Tableau funcionen correctamente, consulta con tu administrador de Tableau para asegurarte de que CORS está habilitado en tu instancia y que el valor file:// se agrega a los hosts permitidos.
Limitaciones
Tableau no admite el inicio de sesión único ni la autenticación multifactor. Solo se admite el inicio de sesión mediante el nombre de usuario y la contraseña o los tokens de acceso personales. Los tokens de acceso personal son tokens de autenticación de larga duración que te permiten ejecutar automatizaciones con las API de REST de Tableau sin necesidad de codificar las credenciales ni iniciar una sesión interactiva
Solo puedes buscar nombres completos. Proporciona el nombre de la fuente de datos, en lugar de solo un nombre.
A partir de Designer versión 2021.2, se leen los campos de texto en archivos .hyper como V_WString con el tamaño máximo para evitar la pérdida de datos. Para solucionar el problema, puedes utilizar la herramienta Campo automático o Seleccionar antes de escribir los datos en cualquier otro formato.
No es posible ejecutar varias herramientas de Tableau simultáneamente con el mismo token de acceso personal debido a una limitación de Tableau, en la que los usuarios no pueden solicitar sesiones simultáneas de Tableau Server con un único token de acceso personal. Los intentos para iniciar sesión en sesiones simultáneas mediante el mismo token de acceso personal provocarán que se cierre la sesión anterior y pueden dar lugar a errores de autenticación. Para obtener más información, consulta la documentación de ayuda de Tableau acerca de los tokens de acceso personal.



