Tableau
Il connettore di Tableau permette di connettersi a Tableau in Designer.
Tableau è disponibile come origine dati, sia negli strumenti Dati di input e Dati di output, sia tramite gli strumenti autonomi di Input di Tableau e Output di Tableau.
Nuova versione del connettore in Designer
Ora il connettore di Tableau fa parte dell'esperienza dei connettori di Alteryx One. Rivedi attentamente le informazioni contenute in questa pagina per assicurarti di utilizzare correttamente gli strumenti appropriati.
Se vuoi aggiornare il connettore di Tableau nei tuoi flussi di lavoro Designer, puoi usare l'utilità Migrazione del flusso di lavoro.
Dettagli del connettore di Tableau
Tableau è disponibile in Designer 2025.1, Patch 5 e versioni successive, come origine dati per gli strumenti Dati di input e Dati di output. Per ulteriori dettagli sulle opzioni relative al tipo di file, vai a [collegamento].
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 di connessione | Strumenti Alteryx. La versione più recente è disponibile in Alteryx Marketplace. |
Tipo di supporto | Lettura/scrittura/pubblicazione |
Convalidato su | Tableau SDK 10.3 (supporto spaziale) |
Versione | Descrizione |
v1.5.4 |
Problemi noti
|
v1.5.3 |
Problemi noti
|
v1.5.2 |
|
V1.5.1 |
|
v1.5.0 |
|
v1.4.3 |
|
v1.4.2 |
|
v1.4.1 |
|
v1.4.0 |
|
v1.3.1 |
Problemi noti
|
v1.3.0 |
Problemi noti
|
v1.2.0 |
Problemi noti
|
v1.1.1 |
|
v1.1.0 |
|
v1.0.1 |
Limitazioni note:
|
Strumenti Alteryx utilizzati per Connect
Importante
Lo strumento Dati di input legge i dati come file Tableau Hyper Data Extract (HYPER). Questo strumento supporta solo i file locali.
Lo strumento Dati di output salva i dati come file Tableau Hyper Data Extract (HYPER). Questo strumento supporta solo i file locali.
Lo strumento Output di Tableau crea un set di dati Tableau Hyper e lo carica sul server Tableau o lo salva localmente come file Tableau Hyper Data Extract (HYPER).
Lo strumento Pubblica nel server di Tableau è deprecato. Questa funzionalità è stata sostituita dallo strumento Output di Tableau.
Data Connection Manager
Gli strumenti Tableau versione 1.2.0 e successive supportano Data Connection Manager (DCM) per una memorizzazione più semplice e sicura delle tue credenziali. Crea una connessione a Tableau e riutilizza con facilità le credenziali memorizzate nei flussi di lavoro che includono gli strumenti Tableau. Alteryx Server richiede credenziali memorizzate per eseguire correttamente i flussi di lavoro pubblicati.
Abilitazione di AMP Engine
Assicurati che AMP Engine sia abilitato per i flussi di lavoro che contengono lo strumento Tableau versione 1.2.0 e successive.
Accesso API
Gli strumenti di Tableau richiedono l'accesso API all'istanza Tableau. Affinché gli strumenti di Tableau funzionino correttamente, verifica con l'amministratore di Tableau che CORS sia attivato sull'istanza e che il valore file:// sia aggiunto agli host consentiti.
Limitazioni
Tableau non supporta l'autenticazione Single Sign-On o a più fattori. È supportato solo l'accesso tramite nome utente e password o token di accesso personali. I token di accesso personali sono token di autenticazione di lunga durata che consentono di eseguire l'automazione con le API REST di Tableau senza richiedere credenziali hard-coded o un accesso interattivo.
Puoi cercare solo i nomi completi, quindi devi fornire un "nome origine dati" e non solo un "nome".
A partire da Designer versione 2021.2, i campi di testo vengono letti nei file HYPER come V_WString con la dimensione massima per evitare la perdita di dati. Per risolvere il problema, è possibile utilizzare lo strumento Campo automatico o Seleziona prima di scrivere i dati in qualsiasi altro formato.
Non è possibile eseguire più strumenti Tableau contemporaneamente utilizzando lo stesso token di accesso personale a causa di una limitazione di Tableau che impedisce agli utenti di richiedere sessioni del server di Tableau simultanee con un singolo token di accesso personale. I tentativi di accedere a sessioni simultanee con lo stesso token di accesso personale causeranno la chiusura della sessione precedente e potrebbero generare errori di autenticazione. Per ulteriori informazioni, consulta la documentazione della guida di Tableau sui token di accesso personale.



