Tableau
Mit dem Tableau-Konnektor können Sie eine Verbindung zu Tableau in Designer herstellen.
Tableau ist als Datenquelle im Dateneingabe- und im Datenausgabe-Tool sowie in den eigenständigen Tableau-Eingabe- und Tableau-Ausgabe-Tools verfügbar.
Neue Konnektorversion in Designer
Der Tableau-Konnektor ist jetzt Teil der Alteryx One-Konnektoren. Lesen Sie sich die Informationen auf dieser Seite sorgfältig durch, um sicherzustellen, dass Sie die entsprechenden Tools richtig verwenden.
Wenn Sie den Tableau-Konnektor in Ihren Designer-Workflows aktualisieren möchten, können Sie das Hilfsprogramm für Workflow-Migration verwenden.
Details zum Tableau-Konnektor
Tableau ist in Designer 2025.1. Patch 5 oder höher und 2025.2 Patch 3 oder höher als Datenquelle für das Dateneingabe- und das Datenausgabe-Tool verfügbar. Erfahren Sie mehr über die Dateityp-Optionen unter [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 |
Anmerkung
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 |
|
Verbindungstyp | Alteryx-Tools. Die aktuellste Version ist im Alteryx Marketplace verfügbar. |
Typ der Unterstützung | Lesen/Schreiben/Veröffentlichen |
Validiert am | Tableau SDK 10.3 (Geo-Unterstützung) |
Version | Beschreibung |
v1.5.4 |
Bekannte Probleme
|
v1.5.3 |
Bekannte Probleme
|
v1.5.2 |
|
V1.5.1 |
|
v1.5.0 |
|
v1.4.3 |
|
v1.4.2 |
|
v1.4.1 |
|
v1.4.0 |
|
v1.3.1 |
Bekannte Probleme
|
v1.3.0 |
Bekannte Probleme
|
v1.2.0 |
Bekannte Probleme
|
v1.1.1 |
|
v1.1.0 |
|
v1.0.1 |
Bekannte Einschränkungen:
|
Alteryx-Tools für die Verbindung
Wichtig
Das Eingabedaten-Tool liest Daten im Dateityp Tableau Hyper Data Extract (HYPER). Dieses Tool unterstützt nur lokale Dateien.
Das Datenausgabe-Tool speichert Daten im Dateityp Tableau Hyper Data Extract (HYPER). Dieses Tool unterstützt nur lokale Dateien.
Das Tableau-Ausgabe-Tool erstellt ein Tableau-Hyper-Dataset und lädt es auf dem Tableau-Server hoch oder speichert es lokal im Dateityp Tableau Hyper Data Extract (HYPER).
Das Veröffentlichen auf Tableau Server-Tool ist veraltet. Die Funktionalität wurde durch das Tableau-Ausgabe-Tool ersetzt
Data Connection Manager
Die Tableau-Tools ab Version 1.2.0 unterstützen Data Connection Manager für eine einfachere und sicherere Speicherung Ihrer Anmeldedaten. Stellen Sie eine Verbindung zu Tableau her, um die gespeicherten Anmeldedaten einfach in Workflows wiederverwenden zu können, die Tableau-Tools enthalten. Alteryx Server benötigt gespeicherte Anmeldedaten, um die veröffentlichten Workflows erfolgreich ausführen zu können.
AMP Engine aktivieren
Die AMP Engine muss für Workflows aktiviert sein, die Tableau-Tools ab Version 1.2.0 enthalten.
API-Zugriff
Die Tableau-Tools erfordern API-Zugriff auf Ihre Tableau-Instanz. Damit die Tableau-Tools ordnungsgemäß funktionieren, wenden Sie sich an Ihren Tableau-Admin, um sicherzustellen, dass auf Ihrer Instanz CORS aktiviert ist und der Wert file:// den zulässigen Hosts hinzugefügt wird.
Beschränkungen
Tableau unterstützt keine Single Sign-on- oder Multi-Faktor-Authentifizierungen. Es wird nur die Anmeldung mit Benutzernamen und Kennwörtern oder persönlichen Zugriffstoken unterstützt. Persönliche Zugriffstoken sind langlebige Authentifizierungstoken, mit denen Sie die Automatisierung mit Tableau-REST-APIs ausführen können, ohne dass hartcodierte Anmeldedaten oder interaktive Anmeldungen erforderlich sind.
Sie können nur in vollständigen Namen suchen. Sie müssen also einen „Datenquellennamen“ anstelle eines „Namens“ angeben.
Seit Designer Version 2021.2 werden Textfelder in .hyper-Dateien als V_WString mit der maximalen Größe eingelesen, um Datenverlust zu vermeiden. Als Umgehungslösung können Sie das Feldtypbestimmung-Tool oder das Datenfelder-auswählen-Tool verwenden, bevor Sie die Daten in ein anderes Format schreiben.
Es ist nicht möglich, mehrere Tableau-Tools gleichzeitig mit demselben persönlichen Zugriffstoken auszuführen, da Benutzer aufgrund einer Tableau-Einschränkung keine gleichzeitigen Tableau-Serversitzungen mit einem einzelnen persönlichen Zugriffstoken anfordern können. Versuche, sich bei gleichzeitigen Sitzungen mit demselben persönlichen Zugriffstoken anzumelden, führen dazu, dass die vorherige Sitzung beendet wird. Dies kann eventuell zu Authentifizierungsfehlern führen. Weitere Informationen finden Sie in der Hilfedokumentation von Tableau zu persönlichen Zugriffstoken.



