Skip to main content

Tableau

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

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

Designer 中的新连接器版本

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

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

开始之前

从 Alteryx Marketplace 下载并安装 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 输入和输出工具用于从 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 连接器发行说明

Connector 发行版本 2.1.0

版本

描述

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 独立连接器 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 帮助文档。

本节内容如下: