Skip to main content

Tableau

The Tableau connector lets you connect to Tableau in Designer.

Tableau is available as a data source in the Input Data and Output Data tool, and as the standalone Tableau Input and Tableau Output tools.

New Connector Version in Designer

The Tableau connector is now part of the Alteryx One connectors experience. Review the information on this page carefully to ensure you're using the appropriate tools correctly.

If you want to update the Tableau connector in your Designer workflows, you can use the workflow migration utility.

Tableau Connector Setup

Tableau is available in Designer 2025.1 Patch 5 or later and 2025.2 Patch 3 or later as a data source for the Input Data and Output Data tool. To learn more about the tools, see Input and Output Tools.

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

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

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

Tableau Connector Release Notes

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.

Tableau Standalone Connectors Version 1.5.4 and Earlier

Connection Type

Alteryx Tools. The latest version is available from the Alteryx Marketplace.

Type of Support

Read/Write/Publish

Validated On

Tableau SDK 10.3 (Spatial support)

Release Notes

Version

Description

v1.5.4

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • The Tableau connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow.

  • Fixed issues where the DCM connection returned these errors:

    • 'NoneType' object has no attribute 'get' (TPM-4831)

    • Failed to process selected datasource <DATASOURCE> (TPM-4824)

    • Failed to sign in to Tableau (TPM-4732)

    • serverUrl (TPM-4732)

  • Fixed issue where uploading a HYPER file fails with <class 'KeyError'>: '#1' and list out of index range. (TPM-4708)

  • Fixed issue where the Tableau tools returned the temp_table error. (TPM-4609)

Known Issues

  • Special characters in proxy password cause errors in manual proxy server setup.

  • Using getIpAddress() in a PAC file returns the local IP Address in PyPAC. (TPM-4515)

v1.5.3

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Added the connection ID to the results window when using DCM.

  • Fixed issue where the Tableau tools published data to the wrong project ID when filtering by favorite. (TPM-4600)

  • Fixed issue where the DCM connection handling rule wasn’t applied to the Tableau tools. (TPM-4550)

  • Fixed issue where the parent project name wasn’t displayed in the Select Project configuration. (TPM-4451)

  • Fixed issue where Tableau Output didn’t write SpatialObj data correctly. (TPM-4378)

  • Fixed issue where the Tableau tools ignored the NO_PROXY variable if the HTTP_PROXY or HTTPS_PROXY variables were used. (TPM-4347)

  • Fixed issue where Tableau Output didn’t adhere to proxy exceptions in LAN settings. (TPM-4345)

Known Issues

  • Tableau Output fails to write data to Tableau Cloud. Designer returns this error message: "unknown table 'temp_table' Context: 0xfa6b0e2f." (TPM-4609)

v1.5.2

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Fixed issue where the Tableau tools returned the “list index out of range” error. (TPM-4356)

  • Fixed issue where Tableau Input returned the “out of bounds” error. (TPM-4325)

  • Fixed issue where Tableau Output returned an error when the Byte, Date, Time or DateTimes columns were empty. (TPM-4317)

  • Fixed issue where the Tableau tools returned the “Mismatched column definitions” error. (TPM-4315, TPM-4299, TPM-4047)

  • Fixed issue where Tableau Output didn’t display data in the results window. (TPM-4297)

  • Fixed issue where Tableau Output didn’t display data sources correctly. (TPM-4260)

  • Fixed issue where Tableau Input didn’t read any data and didn’t display any error. (TPM-4247)

  • Fixed issue where Tableau Output prevented writing data to data sources with the same name in different projects. (TPM-4225)

  • Fixed issue where Tableau Output didn’t write data to a file defined by a relative path. (TPM-3712)

  • Fixed issue where Tableau Output in a macro didn’t work as expected. (TPM-3502)

V1.5.1

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Fixed issue where Tableau Output returned an error when the settings filtered away all the rows. (TPM-4146)

  • Fixed issue where Tableau Output returned an error when the data didn’t match the columns' data type. (TPM-4084)

  • Fixed issue where the Tableau tools couldn’t filter by owner. (TPM-4076)

  • Fixed issue where Tableau Output returned an error when compulsory field weren’t selected. (TPM-3555)

v1.5.0

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Added an option to upload a HYPER file.

  • Added a capability to read data from sources created by different means than the Tableau Output tool.

v1.4.3

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Fixed issue where Tableau Output duplicated records when appending data to a table. (TPM-3890)

  • Fixed issue where Tableau Output returned an error when columns were empty and their data type was set to DateTime. (TPM-3862)

  • Fixed issue where Tableau Output wrote incomplete records when the workflow included multiple Tableau Input tools. (TDCE-533)

  • Fixed issue where the Tableau tools returned an error when site name was empty. (TDCE-464)

v1.4.2

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Fixed issue where Tableau Output didn’t properly update or upsert data if workflow included more than 1 Tableau tool. (TPM-3725)

  • Fixed issue where Tableau Output couldn’t properly write DateTime values. (TPM-3715)

  • Fixed issue where Tableau Input duplicated data and overwrote columns. (TPM-3524)

  • Improved the performance of Tableau Output. (TPM-3455)

  • Fixed issue where the Tableau tools ignored proxy settings. (TPM-3353)

  • Fixed issue where the Tableau tools couldn’t properly read or write Blob data. (TPM-2649)

v1.4.1

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Removed usage of .shiv folder.

  • Fixed issue where Tableau Output returned "'NoneType' object has no attribute 'dtypes'" error when writing date fields with a future year. (TPM-3246)

  • Fixed issue where Tableau Output didn’t properly update the Project Name field when mapped to an interface tool in a macro or analytic app. (TPM-3245)

  • Fixed issue where Tableau Output returned "Got an invalid value" error for a mix of data types. (TPM-2968)

  • Fixed issue where Tableau Output failed to upsert data when it contained no new rows to insert. (TPM-2531)

  • Fixed issue where Tableau Output showed blank configuration panel when the user’s Tableau instance didn’t contain any data sources. (TFLN-1881)

  • Fixed the "Must pass at least one table" error on Tableau Output. (TDCE-302)

  • Fixed issue where Tableau Input returned "'NoneType' object has no attribute ‘year’" error when reading Date or DateTime data types. (TDCE-293)

  • Fixed issue where Tableau Output failed to create TDSX file when it was over certain size. (TDCE-186)

v1.4.0

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Improved write performance of Tableau Output.

  • Fixed issue where the refresh button in Project and Data Source browsers didn’t work. (TFLN-1436)

  • Fixed issue where Tableau Output became unstable when uploading dataset larger than 3GB. (TPM-2121)

v1.3.1

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Fixed issue where Tableau Output wrote Null values as “nan” for float data types. (TPM-2210)

Known Issues

  • The tool becomes unstable when uploading dataset larger than 3GB. (TPM-2121)

  • The refresh button isn’t working for either the Tableau Output or Tableau Input tool. (TFLN-1436)

v1.3.0

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later.

  • Added new Tableau Input tool to read data from HYPER data sources.

    • Live data sources aren’t supported.

    • Only data sources created with the Tableau Output tool are supported for reading.

  • Requires AMP engine.

  • Alteryx Server requires stored credentials in DCM to run workflows.

  • Fixed issue where NULL numeric values were converted to 0. (TPM-1546)

    • Tableau shows NULL numeric values as 0 by default on dashboards.

  • Fixed issue where NULL string values were converted to empty string. (TPM-1528)

  • Fixed issue where DATE was converted into STRING. (TPM-2138)

  • Fixed issue where Designer ran indefinitely or crashed when DCM was used. (TPM-1986)

  • Fixed issue with error “The system could not find the path specified” when multiple Tableau Output tools were used on canvas. (TPM-1915)

Known Issues

  • Tool becomes unstable when uploading dataset larger than 3GB. (TPM-2121)

  • Refresh button is not working for either the Tableau Output or Tableau Input tool. (TFLN-1436)

v1.2.0

  • Compatible with Alteryx Designer and Server 2021.4.2 Patch 4, 2022.1 Patch 2 and later.

  • Requires AMP engine.

  • Added support for DCM.

    • DCM is required for running this connector on Alteryx Server.

  • Added support for SpatialObj.

  • SSL/TLS validation is now performed against Windows Certificate Store.

  • FIPS capable.

Known Issues

  • Alteryx Server requires the AllowAll value of the SDK Access Mode settings.

  • NULL values are converted to 0.

v1.1.1

  • Fixed issue with conversion of boolean and DateTime fields.

v1.1.0

  • Added support for Tableau Server On-Premise (Tableau Server 2019.2 or later required).

v1.0.1

  • Compatible with Alteryx Designer version 2021.3 and later.

  • Initial release.

  • Username and Password and Personal Access Token are supported authentication methods.

  • Create, Overwrite, Append, Update, or Upsert multiple tables in a dataset.

  • Post SQL support.

  • Proxy support.

  • Conversion from WKT to Spatial object support.

Known limitation:

  • v1.0.1 does not support Tableau Server On-Premise.

  • When working with multiple tables, a .tds file has to be provided (can be obtained from Tableau Desktop)

Alteryx Tools Used to Connect

Input Data Tool Icon Input Data Tool

Output Data Tool Icon Output Data ToolOutput Data Tool Icon Output Data Tool

Tableau Output Tool Tableau Input Tool

Tableau Output Tool Tableau Output Tool

Publish to Tableau Server Tool Icon Publish to Tableau Server Tool

Important

Data Connection Manager

The Tableau tools version 1.2.0 and later support Data Connection Manager for easier and safer storage of your credentials. Create a connection to Tableau and easily reuse the stored credentials in workflows that include the Tableau tools. Alteryx Server requires stored credentials to successfully run the published workflows.

Enable AMP Engine

Make sure you have the AMP engine enabled for the workflows which contain the Tableau tools version 1.2.0 and later.

API Access

The Tableau tools require API access to your Tableau instance. For the Tableau tools to work properly, check with your Tableau admin to ensure that CORS is enabled on your instance and the file:// value is added to the allowed hosts.

Limitations

Login Options

Tableau doesn’t support single sign-on or multi-factor authentication. Only sign in using a username and password or personal access tokens is supported. Personal access tokens are long-lived authentication tokens that allow you to run automation with Tableau REST APIs without requiring hard-coded credentials or interactive login.

Tableau Output Tool Search

You can only search in full names, so you need to provide a 'datasource name' instead of just a 'name'.

Text Fields Read in as V_WString with the Maximum Size

Since Designer version 2021.2, text fields read in .hyper files as V_WString with the max size to avoid data loss. To work around, you can use the Auto Field or Select tool before writing the data to any other format.

Limited Usage of Tableau Tools with a Personal Access Token

It's not possible to run multiple Tableau tools concurrently using the same Personal Access Token because of a Tableau limitation where users can't request concurrent Tableau Server sessions with a single Personal Access Token. Attempts to sign in to concurrent sessions using the same Personal Access Token will cause the previous session to be terminated and may result in authentication errors. For more information, see Tableau's Help documentation on Personal Access Tokens.

In this section: