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 或更高版本中可用作输入数据和输出数据工具的数据源。若要了解有关这些工具的更多信息，请参阅输入和输出工具。

先决条件

继续之前，请确保您已满足以下前提条件：

要求

详情

Designer 版本

Designer 2026.1+（统一连接器必需，也是特定的输出选项所必需的，例如 Hyper 文件版本和数据库架构选择）

Tableau Server 版本

Tableau Server 2023.3+，使用 Tableau REST API 3.21

AMP

必须启用

DCM

请务必在 Designer 中启用 DCM。请转至选项 > 高级设置 > DCM 以启用此功能

Tableau 部署类型

使用您的 Server URL 的 Tableau Server（自托管、本地部署或私有云）

安装连接器

您可以轻松地从 Designer 通过附加组件安装最新版本的 Tableau 连接器。这是推荐的安装方法，助您在无需离开 Designer 或访问 Alteryx Marketplace 的情况下浏览、安装和更新连接器。

如需安装连接器...

  1. 在 Designer 中，转至附加组件 > 管理 Marketplace 附加组件。您将看到可用连接器列表。

  2. 选择 Tableau 工具，然后选择安装。Designer 将下载并安装该软件包。Designer 可能需要重新启动以完成安装。

  3. 在安装和设置完成后，Tableau 连接器即可在“输入数据”和“输出数据”工具中使用。

请设置连接

如需使用 DCM 连接到 Tableau...DCM - Designer

  1. 将输入数据或输出数据工具拖到画布上，然后选择连接到数据。

  2. 在连接器设置中，选择创建或浏览数据连接。

    如果您之前已创建过 Tableau 连接，可以从最近选项卡中选择该连接。

  3. 选择 + 新建。从技术列表中，选择 Tableau。

  4. 选择设置连接。此时将打开连接窗口。

  5. 选择 + 新建。

  6. 指定连接名称、数据源名称以及 Server URL。

  7. 在凭证部分中，选择您的身份验证方法，并输入凭证名称。如需了解详情，请参阅身份验证方法。

  8. 选择保存。

  9. 选择连接。Tableau 可能会请求身份验证。

  10. 在文件浏览器窗口中选择要读取或写入的文件。

  11. 在选项窗口中选择读取或写入配置。

  12. 选择确认以创建与该文件的连接。您可以继续构建您的工作流。

Tableau 连接器发行说明

Connector 发行版本 2.1.0

版本

描述

v2.2.0

  • Added support for testing Tableau connections in DCM.

  • Added Tableau Cloud support for Input and Output tools, with Site required for Tableau Cloud connections.

v2.1.0

  • 适用于 Designer 2026.1 及更高版本、Tableau Server 2023.3 及更高版本 (Tableau REST API 3.21)。需要启用 AMP 和 DCM。

  • 输入工具支持读取具有明确数据类型的单表数据源。

  • 输出工具支持 Hyper 文件版本 V1 至 V4、多个数据库架构，并可将数据写入自定义名称的单表中。追加和覆盖均基于 API 实现。

  • 修复了以下问题：对于不含 OAuth 令牌的连接，迁移程序曾错误地尝试刷新其凭证（Tableau 使用 PAT 或用户名和密码）。

v2.0.1

  • 输入与输出（单表操作）。

  • 输出工具新增了基于 API 的追加功能、手动及动态项目路径支持、Hyper V2 格式、项目与数据源的模糊搜索，以及针对大数据量写入的自动分块处理。

  • 修复了大数据量写入操作失败并报错的问题。

  • 修复了新建数据源时未能自动在名称后追加时间戳的问题。

  • 修复了项目和数据源浏览中的分页、搜索及导航问题。

输入和输出工具

Tableau 输入和输出工具用于从 Tableau 读取数据并向其写入数据。

Tableau 输入

Tableau 输入工具从已发布的 Tableau 数据源中读取数据。

  • 通过 DCM Tableau 连接进行身份验证。

  • 使用分页和模糊搜索浏览树状结构中的站点和项目，或者手动输入路径。

  • 选择要读取的单表数据源。

  • 列将作为带类型的数据返回（例如，Date 和 DateTime 被读取为 date 和 datetime 类型）。

Tableau 输出

Tableau 输出工具将数据写入 Tableau，并将其作为数据源（Hyper 数据提取）进行发布。此工具取代了旧版的发布到 Tableau Server 工具。

  • 通过 DCM Tableau 连接进行身份验证。

  • 选择或定义目标位置：浏览并选择项目和数据源，或者输入项目路径和数据源名称（包括由字段或参数驱动的动态路径）。

  • 写入您自定义名称的单表。

  • 选择数据源已存在时的操作：创建新数据源、重命名并创建、覆盖现有数据源（保留数据源 ID 并创建新版本）或向现有数据源追加行。通过 Tableau API 执行追加和覆盖操作。

  • 选择 Hyper 文件版本（V1 至 V4）和数据库架构（例如 public 或 Extract）。这些选项需要 Designer 2026.1+。

对象模型

了解 Tableau 的层级结构有助于您正确配置工具：

  • 站点：组织通常会为每个业务部门或环境使用独立的站点。每个站点都拥有自己独立的用户、项目、工作簿和数据源。

  • 项目：用于组织内容。项目可以嵌套。

  • 工作簿：包含一个或多个工作表（可视化、仪表板、故事），并使用数据源作为其底层数据。

  • 数据源：工作簿所使用的数据连接。它可以是实时连接，也可以是数据提取。数据源会提供一个或多个表。

  • 表：数据源内部的结构化数据集。当 Alteryx 发布到 Tableau 时，它会写入数据源中的一个表，并存储为 .hyper 数据提取。

身份验证方法

统一连接器通过 DCM 进行身份验证。Tableau 支持三种身份验证方法。请参考下表，为您的使用案例选择合适的身份验证方法。

方法

Desktop

Cloud (Alteryx One)

个人访问令牌 (PAT)

是

否

Tableau Server 用户名和密码

是

否

Tableau 连接管理器 (TCM)

否

否

注意

  • Tableau Server（自托管、本地部署或私有云）使用您的 Server URL 进行连接，并支持个人访问令牌 (PAT) 或 Tableau Server 用户名和密码作为凭证。

  • Tableau Cloud（SaaS，由 Tableau 托管）使用特定于站点的 URL，格式为 https://<site>.online.tableau.com。统一连接器对 Tableau Cloud 的支持尚在开发中，目前还不可用。

迁移至统一 Tableau

如果您已在 Alteryx 中使用 Tableau 连接器，请阅读以下部分。其中将详细介绍统一版本中的变更内容。

参数

传统连接器 (Python SDK)

统一连接器

平台和工具

Desktop（输入和输出）

正式发布 (GA) 阶段的 Desktop（输入和输出）

Cloud（正在开发中）

框架

Python SDK

统一连接器框架

通信 / API

传统 Tableau REST API

Tableau REST API 3.21（需要 Tableau Server 2023.3+）

身份验证

传统身份验证

个人访问令牌 (PAT) 或 Tableau Server 用户名和密码

连接模型

工具级别 / 非 DCM

DCM

您可以使用 Designer 2025.1 补丁 5 或更高版本中的 Alteryx 工作流迁移实用程序来迁移现有工作流。不过，该工具仅在 Desktop 上可用。如需了解更多信息，请参阅工作流迁移实用程序。

限制

  • Date 和 DateTime 值在读取时现在会显示尾随零（额外的微秒位数）。若要恢复以前的格式，请在下游添加选择工具或采样工具，以修剪多余的零。

  • Tableau 输出工具无法发布包含从本地 .hyper 文件中读取的固定小数字段的数据源。请在 Tableau 输出工具前，将该字段转换为 Double 类型（例如，使用选择工具）。这也有助于避免后续在同一数据源上执行追加或覆盖操作时发生冲突。

  • 更新、更新/插入以及上传 Hyper 文件操作已不再受支持。如果您的工作流依赖于更新或更新/插入，请重新设计工作流，以使用覆盖（替换数据源）或追加（添加行）。

  • 该连接器目前仅支持单表数据源。您需要写入您自定义名称的单表中，因此，已不再支持 .tds 文件。如果您的工作流使用了多表数据源，请重新设计工作流，使其改为发布到单表数据源。

  • 您无法直接通过连接器创建新的或嵌套的项目。请先在 Tableau 中创建项目，然后在工具中浏览到该项目或输入其路径。

  • 该工具不会列出数据源内的表供您选择。请改为手动输入表名称。

  • 已移除非 DCM 连接方法，因此所有连接都必须通过 DCM 进行创建，并使用 PAT 或 Tableau Server 用户名和密码进行身份验证。

  • 输入和输出工具均不支持 Tableau 连接管理器 (TCM)。请改用 PAT 或 Tableau Server 用户名和密码。

  • “附加元数据”和“启用试运行”选项在 Desktop 上的统一连接器框架中不适用于 Tableau 输入工具。

  • 该连接器的输入和输出功能均需要 Designer 2026.1+ 以及 Tableau Server 2023.3+ (Tableau REST API 3.21)。高级选项（如 Hyper 文件版本和数据库架构选择）也需要 Designer 2026.1+。

  • 目前，该连接器的输入和输出功能仅在 Desktop（旗舰版）上提供。Cloud 支持尚在开发中，目前还没有确定的发布日期。一旦 Cloud 发布，工作流迁移实用程序在 Cloud 上预计仍不可用，本地下载依然仅限 Desktop，连接创建流程也将有所不同（不支持内置连接创建），且支持的格式和生成的数据类型可能与 Desktop 有所差异。

Tableau 独立连接器版本 1.5.7 及更早版本（已弃用）

独立的 Tableau 工具已弃用。安装最新的 Tableau 连接器以利用最新功能。

July 18, 2026

与 Designer 的兼容性（待讨论）

连接器发行版本 xxxx.x.x.xxxxx

ID

Description

v1.5.7

  • Fixed issue where Tableau Output failed to append on Overwrite/Append when using .tds for Data Source Metainfo.

Known Issues

  • Tableau Connector v1.5.5 Gallery authentication failures.

v1.5.6

  • Fixed DCM connection handling issue.

  • Fixed an issue where Tableau Output tool failed to connect to Tableau Server with Invalid CORS request / Credentials Denied post upgrade to 2025.2 from 2024.2.

  • Fixed issue where workflow with multiple Tableau output tools and multiple DCM connections published to wrong Tableau server.

Known Issues

  • Tableau Output fails to append on Overwrite/Append when using .tds for Data Source Metainfo.

v1.5.5

  • The Tableau tools now support reading multiple tables.

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

  • We disabled the right-click context menu in Designer for the Tableau tools to prevent unintended actions.

  • Fixed an issue where the Tableau Output tool did not escape backslashes for UNC paths when uploading HYPER files.

  • Fixed an issue where Tableau Output tool did not reset the table name to the default when it starts with “table”.

  • Fixed an issue where the Tableau Output tool returened this error: Could not init plugin AttributeError("'NoneType' object has no attribute 'split'").

  • Fixed an issue where the Tableau Output tool returned an error when numeric values are 0 during update or upsert operations.

  • Fixed an issue where resetting the table name when the project or data source changes caused an error if the name is duplicated in the Tableau Output tool.

  • Fixed an issue where special characters in the proxy password caused an error when setting up a manual proxy server for the Tableau tools.

  • Fixed an issue where the Tableau tools added proxy credentials to the manual proxy settings even when the proxy does not require them.

  • Fixed an issue where the Tableau Output tool returned a Datatype conversion failed error when spatial fields contain null values.

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)

Known Issues

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

  • 在 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)

Known Issues

  • Tableau Output fails to write data to Tableau Cloud. Designer returns this error message: unknown table 'temp_table' Context: 0xfa6b0e2f.

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)

用于连接的 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 工具

重要

本节内容如下: