Skip to main content

Tableau

Tableau 连接器助您在 Designer 中连接至 Tableau。

Tableau 在输入数据和输出数据工具中作为数据源提供，也可作为独立的 Tableau 输入和 Tableau 输出工具。

Designer 中的新连接器版本

Tableau 连接器现在是 Alteryx One 连接器体验的一部分。请仔细阅读此页面上的信息，以确保您正确使用相应的工具。

如需更新 Designer 工作流中的 Tableau 连接器，可使用工作流迁移实用程序。

Tableau 连接器详细信息

Tableau 在 Designer 2025.1 补丁 5 或更高版本以及 2025.2 补丁 3 或更高版本中可用作输入数据和输出数据工具的数据源。如需详细了解文件类型选项，请转至 [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...

  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

注意

  • 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 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 独立连接器 1.5.4 及更早版本

连接类型

Alteryx 工具。最新版本可从 Alteryx Marketplace 获得。

支持类型

读取/写入/发布

验证日期

Tableau SDK 10.3（空间支持）

发行说明

版本

描述

v1.5.4

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • Tableau 连接器将时间和日期时间精度默认设为毫秒，以避免末尾出现多余的零，但若工作流有需求，仍支持纳秒级分辨率。

  • 修复了 DCM 连接返回这些错误的问题：

    • “NoneType”对象没有属性“get”(TPM-4831)

    • 未能处理所选数据源 <DATASOURCE> (TPM-4824)

    • 未能登录 Tableau (TPM-4732)

    • serverUrl (TPM-4732)

  • 修复了上传 HYPER 文件未能成功并报错 <class 'KeyError'>: '#1' 及列表超出索引范围的问题。 (TPM-4708)

  • 修复了 Tableau 工具返回 temp_table 错误的问题。(TPM-4609)

已知问题

  • 代理密码中的特殊字符会导致手动设置代理服务器时发生错误。

  • 在 PAC 文件中使用 getIpAddress() 时，PyPAC 会返回本地 IP 地址。(TPM-4515)

v1.5.3

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 使用 DCM 时，结果窗口中已添加连接 ID。

  • 修复了 Tableau 工具在按收藏夹进行筛选时将数据发布到错误的项目 ID 的问题。(TPM-4600)

  • 修复了 DCM 连接处理规则未能应用于 Tableau 工具的问题。(TPM-4550)

  • 修复了在“选择项目”配置中未显示父项目名称的问题。(TPM-4451)

  • 修复了 Tableau 输出未能正确写入 SpatialObj 数据的问题。(TPM-4378)

  • 修复了在使用 HTTP_PROXY 或 HTTPS_PROXY 变量时 Tableau 工具未能应用 NO_PROXY 变量的问题。(TPM-4347)

  • 修复了 Tableau 输出在局域网设置中未正确应用代理例外的问题。(TPM-4345)

已知问题

  • “Tableau 输出”未能将数据写入 Tableau Cloud。Designer 返回此错误消息：“未知表 'temp_table'，上下文：0xfa6b0e2f。”(TPM-4609)

v1.5.2

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 修复了 Tableau 工具返回“列表索引超出范围”错误的问题。(TPM-4356)

  • 修复了 Tableau 输入返回“超出范围”错误的问题。(TPM-4325)

  • 修复了当“字节”、“日期”、“时间”或“日期时间”列为空时，Tableau 输出返回错误的问题。(TPM-4317)

  • 修复了 Tableau 工具返回“列定义不匹配”错误的问题。（TPM-4315、TPM-4299、TPM-4047）

  • 修复了 Tableau 输出无法在结果窗口中显示数据的问题。(TPM-4297)

  • 修复了 Tableau 输出无法正确显示数据源的问题。(TPM-4260)

  • 修复了 Tableau 输入既未读取任何数据，也未显示任何错误的问题。(TPM-4247)

  • 修复了 Tableau 输出阻止在不同项目中使用相同名称将数据写入数据源的问题。(TPM-4225)

  • 修复了 Tableau 输出无法将数据写入由相对路径定义的文件的问题。(TPM-3712)

  • 修复了宏指令的 Tableau 输出无法按预期工作的问题。(TPM-3502)

V1.5.1

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 修复了当设置筛选掉所有行时 Tableau 输出返回错误的问题。(TPM-4146)

  • 修复了在数据与列的数据类型不匹配时 Tableau 输出返回错误的问题。(TPM-4084)

  • 修复了 Tableau 工具无法按所有者进行筛选的问题。(TPM-4076)

  • 修复了未选择必填字段时 Tableau 输出返回错误的问题。(TPM-3555)

v1.5.0

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 添加了上传 HYPER 文件的选项。

  • 新增了从通过非 Tableau 输出工具方式创建的数据源读取数据的功能。

v1.4.3

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 修复了在将数据追加到表中时，Tableau 输出重复记录的问题。(TPM-3890)

  • 修复了在列为空且数据类型设置为日期时间时 Tableau 输出返回错误的问题。(TPM-3862)

  • 修复了当工作流包含多个 Tableau 输入工具时，Tableau 输出写入的记录不完整的问题。(TDCE-533)

  • 修复了当站点名称为空时，Tableau 工具返回错误的问题。(TDCE-464)

v1.4.2

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 修复了如果工作流中包含多个 Tableau 工具，Tableau 输出无法正确更新或插入数据的问题。(TPM-3725)

  • 修复了 Tableau 输出无法正确写入日期时间值的问题。(TPM-3715)

  • 修复了 Tableau 输入处理重复数据和覆盖列的问题。(TPM-3524)

  • 改进了 Tableau 输出的性能。(TPM-3455)

  • 修复了 Tableau 工具忽略代理设置的问题。(TPM-3353)

  • 修复了 Tableau 工具无法正确读取或写入 Blob 数据的问题。(TPM-2649)

v1.4.1

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 移除了对 .shiv 文件夹的使用。

  • 修复了在日期字段中填写未来年份时 Tableau 输出返回"'NoneType' 对象没有属性'dtypes'"错误的问题。(TPM-3246)

  • 修复了在宏指令或分析应用程序中映射到界面工具时，Tableau 输出未正确更新“项目名称”字段的问题。(TPM-3245)

  • 修复了 Tableau 输出针对混合数据类型返回“获得无效值”错误的问题。(TPM-2968)

  • 修复了当 Tableau Output 不包含要插入的新行时未能更新插入数据的问题。(TPM-2531)

  • 修复了当用户的 Tableau 实例不包含任何数据源时，Tableau 输出显示空白配置面板的问题。(TFLN-1881)

  • 修复了 Tableau 输出“必须至少传递一个表”的错误。(TDCE-302)

  • 修复了读取日期或日期时间数据类型时 Tableau 输入返回"'NoneType'对象没有属性‘year’”错误的问题。(TDCE-293)

  • 修复了 Tableau 输出在超过特定大小时未能创建 TDSX 文件的问题。(TDCE-186)

v1.4.0

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 改进了 Tableau 输出的写入性能。

  • 修复了“项目”和“数据源”浏览器中的刷新按钮不起作用的问题。(TFLN-1436)

  • 修复了上传大于 3GB 的数据集时 Tableau 输出变得不稳定的问题。(TPM-2121)

v1.3.1

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 修复了 Tableau 输出将浮点数据类型的 Null 值写入为“nan”的问题。(TPM-2210)

已知问题

  • 上传大于 3GB 的数据集时，该工具会变得不稳定。(TPM-2121)

  • 刷新按钮对 Tableau 输出或 Tableau 输入工具不起作用。(TFLN-1436)

v1.3.0

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 6、2022.1 补丁 4 及更高版本兼容。

  • 添加了新的 Tableau 输入工具以从 HYPER 数据源读取数据。

    • 不支持实时数据源。

    • 仅支持读取使用 Tableau 输出工具创建的数据源。

  • 需要 AMP Engine。

  • Alteryx Server 需要 DCM 中存储的凭证才能运行工作流。

  • 修复了将 NULL 数值转换为 0 的问题。(TPM-1546)

    • Tableau 在仪表板上默认将 NULL 数值显示为 0。

  • 修复了将 NULL 字符串值转换为空字符串的问题。(TPM-1528)

  • 修复了将 DATE 转换为 STRING 的问题。(TPM-2138)

  • 修复了使用 DCM 时 Designer 无限期运行或崩溃的问题。(TPM-1986)

  • 修复了在画布上使用多个 Tableau 输出工具时出现“系统找不到指定的路径”错误的问题。(TPM-1915)

已知问题

  • 上传大于 3GB 的数据集时，该工具会变得不稳定。(TPM-2121)

  • 刷新按钮对 Tableau 输出或 Tableau 输入工具不起作用。(TFLN-1436)

v1.2.0

  • 与 Alteryx Designer 和 Server 2021.4.2 补丁 4、2022.1 补丁 2 及更高版本兼容。

  • 需要 AMP Engine。

  • 增加了对 DCM 的支持。

    • 在 Alteryx Server 中运行此连接器需要 DCM。

  • 添加了对 SpatialObj 的支持。

  • 现在会针对 Windows 证书存储执行 SSL/TLS 验证。

  • 支持 FIPS。

已知问题

  • Alteryx Server 需要“SDK 访问模式”设置中的 AllowAll 值。

  • NULL 值被转换为 0。

v1.1.1

  • 修复了布尔值和日期时间字段转换的问题。

v1.1.0

  • 添加了对本地部署 Tableau Server 的支持（需要 Tableau Server 2019.2 或更高版本）。

v1.0.1

  • 与 Alteryx Designer 2021.3 及更高版本兼容。

  • 初始版本。

  • “用户名和密码”以及“个人访问令牌”是受支持的身份验证方法。

  • 在数据集中创建、覆盖、附加、更新或更新插入多个表。

  • Post SQL 支持。

  • 支持代理。

  • 支持从 WKT 转换到空间对象。

已知局限：

  • v1.0.1 不支持本地部署 Tableau Server。

  • 使用多个表格时，必须提供 .tds 文件（可以从 Tableau Desktop 获得）

用于连接的 Alteryx 工具

Input Data Tool Icon 输入数据工具

Output Data Tool Icon 输出数据工具Output Data Tool Icon 输出数据工具

Tableau Output Tool Tableau 输入工具

Tableau Output Tool “Tableau 输出”工具

Publish to Tableau Server Tool Icon 发布至 Tableau Server 工具

重要

数据连接管理器

Tableau 工具 1.2.0 版及更高版本支持支持数据连接管理器，以便更轻松、更安全地存储凭证。创建到 Tableau 的连接，并在包含 Tableau 工具的工作流中轻松重复使用存储的凭证。Alteryx Server 需要存储的凭证才能成功运行已发布的工作流。

启用 AMP Engine

确保您为包含 Tableau 工具 1.2.0 版及更高版本的工作流启用了 AMP Engine。

API 访问

Tableau 工具需要对 Tableau 实例进行 API 访问。要使 Tableau 工具正常工作，请与 Tableau 管理员联系，确保您的实例启用了 CORS，并将 file:// 值添加到允许的主机。

限制

登录选项

Tableau 不支持单点登录或多因素身份验证。仅支持使用用户名和密码或个人访问令牌登录。个人访问令牌是长期存在的身份验证令牌，允许您使用 Tableau REST API 运行自动化，而无需硬编码凭证或交互式登录。

Tableau 输出工具搜索

您只能搜索全名，因此需要提供“数据源名称”，而不仅仅是“名称”。

以具有最大大小的 V_WString 读入文本字段

从 Designer 版本 2021.2 开始，以具有最大大小的 V_WString 读入 .hyper 文件中的文本字段，以避免数据损失。要解决此问题，您可以在将数据写入任何其他格式之前使用自动字段工具或选择工具。

使用个人访问令牌限制对 Tableau 工具的使用

由于 Tableau 的限制，用户无法使用单个个人访问令牌请求并发 Tableau Server 会话，因此无法使用同一个个人访问令牌同时运行多个 Tableau 工具。尝试使用相同的个人访问令牌登录并发会话将导致上一个会话终止，并可能导致身份验证错误。如需了解详情，请参阅有关个人访问令牌的 Tableau 帮助文档。

本节内容如下: