Skip to main content

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...

  1. In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.

  2. Select Tableau Tools and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.

  3. 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...DCM - Designer

  1. Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.

  2. 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.

  3. Select + New. From the list of technologies, select Tableau.

  4. Select Setup Connection. The Connections window opens.

  5. Select +New.

  6. Specify the connection name, data source name, and the server URL.

  7. In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.

  8. Select Save.

  9. Select Connect. Tableau may request authentication.

  10. Select the file to read from or write to in the file browser window.

  11. Select the read or write configuration in the Options window.

  12. 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, public or Extract). 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 .hyper extract.

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

  • Date and DateTime values 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 .hyper file. 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 .tds file 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

  • Available in Designer 2026.1+, Tableau Server 2023.3+ (Tableau REST API 3.21). Requires AMP and DCM.

  • Input reads a single-table datasource with typed columns.

  • Output supports Hyper file versions V1 through V4, multiple database schemas, Write to a single table with a name of your choice. Append and Overwrite are API-based.

  • Fixed an issue where migration did not perform an incorrect credential refresh when no OAuth token was present (Tableau uses PAT or username and password).

v2.0.1

  • Input and Output (single table).

  • Output added API-based Append, manual and dynamic project paths, Hyper V2, fuzzy search for projects and datasources, and automatic chunking of large writes.

  • Fixed an issue where large writes failed with an error.

  • Fixed an issue where ew datasources were not created with a timestamp appended to the name.

  • Fixed project and datasource browsing pagination, search, and navigation issues.

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

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Il connettore Tableau imposta la precisione di Ora e Data e ora su millisecondi per evitare zeri decimali aggiuntivi, continuando a supportare la risoluzione in nanosecondi quando richiesto dal flusso di lavoro.

  • Risolti problemi a causa dei quali la connessione DCM restituiva questi errori:

    • L'oggetto "NoneType" non ha alcun attributo "get" (TPM-4831)

    • Impossibile elaborare l'origine dati selezionata <DATASOURCE> (TPM-4824).

    • Impossibile accedere a Tableau (TPM-4732)

    • serverUrl (TPM-4732)

  • Risolto il problema a causa del quale il caricamento di un file HYPER non riesce con la <classe "KeyError">: "#1" ed elenco fuori dall'intervallo di indice. (TPM-4708)

  • Risolto il problema a causa del quale gli strumenti Tableau restituivano l'errore temp_table. (TPM-4609)

Problemi noti

  • I caratteri speciali nella password del proxy causano errori nella configurazione manuale del server proxy.

  • L'uso di getIpAddress() in un file PAC restituisce l'indirizzo IP locale in PyPAC. (TPM-4515)

v1.5.3

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Aggiunto l'ID connessione alla finestra Risultati quando si utilizza DCM.

  • Risolto il problema a causa del quale gli strumenti Tableau pubblicavano i dati sull'ID progetto errato quando si applicava il filtro Preferiti. (TPM-4600)

  • Risolto il problema che impediva l'applicazione della regola di gestione della connessione DCM agli strumenti Tableau. (TPM-4550)

  • Risolto il problema che impediva la visualizzazione del nome del progetto padre nella configurazione Seleziona progetto. (TPM-4451)

  • Risolto il problema che impediva ad Output Tableau di scrivere correttamente i dati SpatialObj. (TPM-4378)

  • Risolto il problema a causa del quale gli strumenti Tableau ignoravano la variabile NO_PROXY se si utilizzavano le variabili HTTP_PROXY o HTTPS_PROXY. (TPM-4347)

  • Risolto il problema a causa del quale Output Tableau non rispettava le eccezioni proxy nelle impostazioni LAN. (TPM-4345)

Problemi noti

  • Output Tableau non riesce a scrivere i dati su Tableau Cloud. Designer restituisce il messaggio di errore: "tabella 'temp_table' sconosciuta Contesto: 0xfa6b0e2f." (TPM-4609)

v1.5.2

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Risolto il problema a causa del quale gli strumenti Tableau restituivano l'errore "Indice elenco fuori intervallo". (TPM-4356)

  • Risolto il problema a causa del quale Input Tableau restituiva l'errore "Fuori dai limiti". (TPM-4325)

  • Risolto il problema a causa del quale Output Tableau restituiva un errore quando le colonne Byte, Data, Ora o Data e ora erano vuote. (TPM-4317)

  • Risolto il problema a causa del quale gli strumenti Tableau restituivano l'errore "Definizioni colonna non corrispondenti". (TPM-4315, TPM-4299, TPM-4047)

  • Risolto il problema a causa del quale Output Tableau non mostrava i dati nella finestra dei risultati. (TPM-4297)

  • Risolto il problema a causa del quale Output Tableau non mostrava correttamente le origini dati. (TPM-4260)

  • Risolto il problema a causa del quale Input Tableau non leggeva i dati e non visualizzava errori. (TPM-4247)

  • Risolto il problema a causa del quale Output Tableau impediva la scrittura dei dati su origini dati con lo stesso nome in progetti diversi. (TPM-4225)

  • Risolto il problema a causa del quale Output Tableau non scriveva i dati in un file definito da un percorso relativo. (TPM-3712)

  • Risolto il problema a causa del quale Output Tableau non funzionava come previsto in una macro. (TPM-3502)

V1.5.1

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Risolto il problema a causa del quale Output di Tableau restituiva un errore quando le impostazioni escludevano tutte le righe. (TPM-4146)

  • Risolto il problema a causa del quale Output di Tableau restituiva un errore quando i dati non corrispondono al tipo di dati delle colonne. (TPM-4084)

  • Risolto il problema a causa del quale gli strumenti di Tableau non riuscivano a filtrare per proprietario. (TPM-4076)

  • Risolto il problema a causa del quale Output di Tableau restituiva un errore quando i campi obbligatori non erano selezionati. (TPM-3555)

v1.5.0

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Aggiunta un'opzione per caricare un file HYPER.

  • Aggiunta una funzionalità per leggere i dati da fonti create con mezzi diversi rispetto allo strumento Output di Tableau.

v1.4.3

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Risolto il problema a causa del quale Output Tableau duplicava i record all'aggiunta di dati a una tabella. (TPM-3890)

  • Risolto il problema a causa del quale Output Tableau restituiva un errore in presenza di colonne vuote e dell'impostazione del tipo di dati su Data e ora. (TPM-3862)

  • Risolto il problema a causa del quale Output Tableau scriveva record incompleti in presenza di più strumenti di Input Tableau nel flusso di lavoro. (TDCE-533)

  • Risolto il problema a causa del quale gli strumenti Tableau restituivano un errore in presenza del nome del sito vuoto. (TDCE-464)

v1.4.2

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Risolto il problema a causa del quale Output Tableau non aggiornava o eseguiva l'upsert dei dati in modo corretto se il flusso di lavoro includeva più di 1 strumento Tableau. (TPM-3725)

  • Risolto il problema a causa del quale Output Tableau non scriveva correttamente i valori Data e ora. (TPM-3715)

  • Risolto il problema a causa del quale Input Tableau duplicava i dati e sovrascriveva le colonne. (TPM-3524)

  • Migliorate le prestazioni di Output Tableau. (TPM-3455)

  • Risolto il problema a causa del quale gli strumenti Tableau ignoravano le impostazioni del proxy. (TPM-3353)

  • Risolto il problema a causa del quale gli strumenti Tableau non riuscivano a leggere o scrivere correttamente i dati Blob. (TPM-2649)

v1.4.1

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Rimosso l'utilizzo della cartella .shiv.

  • Risolto il problema a causa del quale Output Tabelau restituiva l'errore "'L'oggetto NoneType non ha un attributo "dtypes'" durante la scrittura dei campi della data con un anno futuro. (TPM-3246)

  • Risolto il problema a causa del quale Output Tabelau non aggiornava correttamente il campo Nome progetto quando era mappato a uno strumento di interfaccia in una macro o in un'app analitica. (TPM-3245)

  • Risolto il problema a causa del quale Output Tabelau restituiva l'errore "Ottenuto un valore non valido" per una combinazione di tipi di dati. (TPM-2968)

  • Risolto il problema a causa del quale Output Tabelau non riusciva a eseguire l'upsert dei dati quando non conteneva nuove righe da inserire. (TPM-2531)

  • Risolto il problema a causa del quale Output Tabelau mostrava un pannello di configurazione vuoto quando l'istanza Tableau dell'utente non conteneva alcuna origine dati. (TFLN-1881)

  • Risolto l'errore "Deve passare almeno una tabella" su Output Tabelau. (TDCE-302)

  • Risolto il problema a causa del quale Input Tableau restituiva l'errore "'L'oggetto NoneType non presenta l'attributo year'' durante la lettura dei tipi di dati Data o Data e ora. (TDCE-293)

  • Risolto il problema a causa del quale Output Tableau non riusciva a creare il file TDSX quando era superiore a una determinata dimensione. (TDCE-186)

v1.4.0

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Migliorate le prestazioni di scrittura in Output di Tableau.

  • Risolto il problema a causa del quale il pulsante di aggiornamento nei browser Progetto e Origine dati non funzionava (TFLN-1436)

  • Risolto il problema a causa del quale Output di Tableau diventava instabile durante il caricamento di set di dati di dimensioni superiori a 3 GB (TPM-2121)

v1.3.1

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Risolto il problema a causa del quale Output di Tableau scriveva valori Null come "nan" per i tipi di dati float (TPM-2210)

Problemi noti

  • Lo strumento diventa instabile durante il caricamento di set di dati di dimensioni superiori a 3 GB (TPM-2121)

  • Il pulsante di aggiornamento non funziona per gli strumenti Output di Tableau e Input Tableau (TFLN-1436)

v1.3.0

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive.

  • Aggiunto nuovo strumento Input Tableau per leggere i dati dalle origini dati HYPER.

    • Le origini dati in tempo reale non sono supportate.

    • Sono supportate per la lettura solo le origini dati create con lo strumento Output di Tableau.

  • Richiede AMP Engine.

  • Alteryx Server richiede credenziali memorizzate in DCM per eseguire i flussi di lavoro.

  • Risolto il problema a causa del quale i valori numerici NULL venivano convertiti in 0 (TPM-1546)

    • Tableau mostra i valori numerici NULL come 0 per impostazione predefinita sui dashboard.

  • Risolto il problema a causa del quale i valori di stringa NULL venivano convertiti in una stringa vuota (TPM-1528)

  • Risolto il problema a causa del quale un valore DATE veniva convertito in stringa (TPM-2138)

  • Risolto il problema a causa del quale Designer veniva eseguito all'infinito o si arrestava in modo anomalo quando si utilizzava DCM (TPM-1986)

  • Risolto il problema a causa del quale veniva restituito l'errore "Impossibile trovare il percorso specificato" quando si utilizzavano più strumenti Output di Tableau nell'area di disegno (TPM-1915)

Problemi noti

  • Lo strumento diventa instabile durante il caricamento di set di dati di dimensioni superiori a 3 GB (TPM-2121)

  • Il pulsante di aggiornamento non funziona per gli strumenti Output di Tableau e Input Tableau (TFLN-1436)

v1.2.0

  • Compatibile con Alteryx Designer e Server 2021.4.2 Patch 4, 2022.1 Patch 2 e versioni successive.

  • Richiede AMP Engine.

  • Aggiunto il supporto per DCM.

    • DCM necessario per l'esecuzione di questo connettore su Alteryx Server.

  • Aggiunto il supporto per SpatialObj.

  • La convalida SSL/TLS viene ora eseguita a fronte dell'archivio certificati Windows.

  • Compatibile con FIPS.

Problemi noti

  • Alteryx Server richiede il valore Consenti tutti delle impostazioni Modalità di accesso SDK.

  • I valori NULL vengono convertiti in 0.

v1.1.1

  • Risolto il problema con la conversione dei campi di tipo booleano e Data e ora.

v1.1.0

  • Aggiunto il supporto per Tableau Server in locale (è richiesto Tableau Server 2019.2 o versione successiva).

v1.0.1

  • Compatibile con Alteryx Designer a partire dalla versione 2021.3.

  • Release iniziale.

  • Nome utente e password e Token di accesso personale sono metodi di autenticazione supportati.

  • Creazione, sovrascrittura, aggiunta, aggiornamento o upsert di più tabelle in un set di dati.

  • Supporto Post SQL.

  • Supporto proxy.

  • Supporto della conversione da WKT a oggetto spaziale.

Limitazioni note:

  • La versione 1.0.1 non supporta Tableau Server in locale.

  • Quando si lavora con più tabelle, è necessario fornire un file .tds (ottenibile da Tableau Desktop)

Strumenti Alteryx utilizzati per Connect

Importante

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.