Tableau
Utilisez le connecteur Tableau pour vous connecter à Tableau dans Designer.
Tableau est disponible en tant que source de données dans les outils Entrée de données et Sortie de données, ainsi qu'en tant qu'outils Entrée Tableau et Sortie Tableau autonomes.
Nouvelle version du connecteur dans Designer
Le connecteur Tableau fait désormais partie de l'expérience de connecteurs Alteryx One. Lisez attentivement les informations figurant sur cette page afin de vous assurer que vous utilisez correctement les outils appropriés.
Si vous souhaitez mettre à jour le connecteur Tableau dans vos workflows Designer, vous pouvez utiliser l'utilitaire de migration des workflows.
Détails du connecteur Tableau
Tableau est disponible dans Designer 2025.1 correctif 5 ou ultérieur et 2025.2 correctif 3 ou ultérieur en tant que source de données pour les outils Entrée de données et Sortie de données. Pour en savoir plus sur les options de type de fichier, accédez à [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 |
Note
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 |
|
Type de connexion | Outils d'Alteryx. La version la plus récente est disponible dans Alteryx Marketplace. |
Type de prise en charge | Lecture/écriture/publication |
Validé le | Tableau SDK 10.3 (prise en charge des données géographiques) |
Version | Description |
v1.5.4 |
Problèmes connus
|
v1.5.3 |
Problèmes connus
|
v1.5.2 |
|
V1.5.1 |
|
v1.5.0 |
|
v1.4.3 |
|
v1.4.2 |
|
v1.4.1 |
|
v1.4.0 |
|
v1.3.1 |
Problèmes connus
|
v1.3.0 |
Problèmes connus
|
v1.2.0 |
Problèmes connus
|
v1.1.1 |
|
v1.1.0 |
|
v1.0.1 |
Limitations connues :
|
Outils Alteryx utilisés pour la connexion
Important
L'outil Entrée de données lit les données sous forme de fichier d'extrait de données Tableau Hyper (HYPER). Cet outil prend uniquement en charge les fichiers locaux.
L'outil Sortie de données enregistre les données sous forme de fichier d'extrait de données Tableau Hyper (HYPER). Cet outil prend uniquement en charge les fichiers locaux.
L'outil Sortie Tableau crée un jeu de données Tableau Hyper et le charge sur Tableau Server ou l'enregistre localement en tant que fichier d'extrait de données Tableau Hyper (HYPER).
L'outil Publier sur Tableau Server est obsolète. La fonctionnalité a été remplacée par l'outil Sortie Tableau
Gestionnaire de connexions aux données
Les outils Tableau version 1.2.0 et ultérieure prennent en charge le Gestionnaire de connexion aux données pour un stockage plus simple et plus sûr de vos informations d'identification. Créez une connexion à Tableau et réutilisez facilement les informations d'identification stockées dans les workflows incluant les outils Tableau. Alteryx Server nécessite des informations d'identification stockées pour exécuter correctement les workflows publiés.
Activation d'AMP Engine
Assurez-vous que AMP Engine est activé pour les workflows contenant les outils Tableau version 1.2.0 et ultérieure.
Accès à l'API
Les outils Table nécessitent un accès API à votre instance Tableau. Pour que les outils Tableau fonctionnent correctement, vérifiez auprès de votre administrateur Tableau que CORS est activé sur votre instance et que la valeur file:// est ajoutée aux hôtes autorisés.
Limites
Tableau ne prend pas en charge l'authentification unique ou multifactorielle. Seule la connexion à l'aide d'un nom d'utilisateur et d'un mot de passe ou de jetons d'accès personnels est prise en charge. Les jetons d'accès personnels sont des jetons d'authentification longue durée vous permettant d'exécuter l'automatisation avec les API REST Tableau sans nécessiter d'informations d'identification codées en dur ou de connexion interactive.
Vous ne pouvez effectuer une recherche que par nom complet. Vous devez donc fournir un « nom de source de données » et non uniquement un « nom ».
Depuis Designer version 2021.2, les champs de texte sont lus dans les fichiers .hyper comme V_WString avec la taille maximale pour éviter la perte de données. Pour contourner ce problème, vous pouvez utiliser le champ automatique ou l'outil Sélectionner avant d'écrire les données dans n'importe quel autre format.
Il n'est pas possible d'exécuter simultanément plusieurs outils Tableau à l'aide du même jeton d'accès personnel en raison d'une limitation de l'outil Tableau, qui précise que les utilisateurs ne peuvent pas demander de sessions Tableau Server simultanées avec un seul jeton d'accès personnel. Les tentatives de connexion à des sessions simultanées à l'aide du même jeton d'accès personnel entraîneront l'arrêt de la session précédente et de potentielles erreurs d'authentification. Pour en savoir plus, consultez la documentation d'aide de l'outil Tableau sur les jetons d'accès personnel.



