使用 Web Data Connector 3.0 SDK 构建的连接器
Web 数据连接器 3.0 是 Web 数据连接器的最新版本,是 Tableau 的解决方案,用于连接通过 API 而不是 ODBC/JDBC 驱动程序公开的 Web 应用程序和服务中的数据。
Web 数据连接器 3.0 SDK 提供了为 Web 数据构建自定义连接器所需的工具。此外,可以使用 Tableau Exchange 中合作伙伴构建的连接器。
注意:Web 数据连接器 3.0 是 2022.3 Tableau 版本的一部分。
关于 Web 数据连接器 3.0
与 Web 数据连接器的早期版本不同,类似于 Tableau 连接器 SDK,Web 数据连接器 3.0允许您构建 Web 数据的自定义连接器,并将连接器打包为 .taco 文件。WDC 3.0 连接器可以像使用 Tableau 连接器 SDK 构建的任何基于驱动程序的连接器一样使用,并且不需要您在自己的 Web 服务器上托管连接器。
与其他 .taco 连接器一样,WDC 3.0 连接器也是打包并签名的 .jar 文件,其中包含一组 XML 和 Javascript/TypeScript 文件。这些文件定义了连接器的外观和行为,其中包括:
- 基于 Web 的连接器 UI
- 从应用程序或服务端点检索数据的 API 调用
- 用于将检索到的数据映射到 Tableau 数据提取中的说明
注意:Web 数据连接器 3.0 仍然只支持数据提取,但允许您可视化您的数据并发布您的分析,就像任何其他数据源一样。
重要信息:Tableau Server 上基于 WDC 3.0 的连接器存在一个已知问题。请参见下面的已知问题(仅限 Tableau Server)。
构建您自己的连接器
若要开始构建自己的自定义连接器,请参考正式的 Web 数据连接器 3.0 文档。
使用通过 Web Data Connector 3.0 SDK 构建的连接器
使用 Web 数据连接器 3.0 SDK 构建连接器后,请按照以下步骤在 Tableau 中使用它:
- 下载连接器文件,即[连接器名称].taco。
- 将 .taco 文件放在以下目录中(默认位置):
- 对于 2021.2 及更高版本:
适用于 Tableau Desktop 对于 Tableau Prep Builder 对于 Tableau Server - Windows - C:\用户\[Windows 用户]\文档\我的 Tableau 存储库\Connectors
- macOS - /用户/[用户]/文档/我的 Tableau 存储库/Connectors
- Windows:C:\用户\[Windows 用户]\文档\我的 Tableau Prep 存储库\Connectors
- MacOS:/用户//文档/我的 Tableau Prep 存储库/Connectors
Windows:C:\Program Files\Tableau\onnectors
Linux:/opt/tableau/connectors
- 对于 2021.1 及更低版本:
适用于 Tableau Desktop 对于 Tableau Prep Builder 对于 Tableau Server、Tableau Prep Conductor、Tableau Prep Flow Authoring - Windows - C:\用户\[Windows 用户]\文档\我的 Tableau 存储库\Connectors
- macOS - /用户/[用户]/文档/我的 Tableau 存储库/Connectors
- Windows:C:\用户\[Windows 用户]\文档\我的 Tableau Prep 存储库\Connectors
- MacOS:/用户//文档/我的 Tableau Prep 存储库/Connectors
- Tableau Server:[Tableau Server 安装目录]/data/tabsvc/vizqlserver/Connectors
若要为 Prep 启用连接器,您还需要将 taco 添加到以下位置:
- Tableau Prep Conductor:[Tableau Server 安装目录]/data/tabsvc/flowprocessor/Connectors
- Tableau Prep Flow Authoring:[Tableau Server 安装目录]/data/tabsvc/flowqueryservice/Connectors
- 对于 2021.2 及更高版本:
注意:安装连接器后,它将显示在 Tableau 中的连接器列表中。
如果您发现 WDC 库、模拟器或任何开发人员示例有问题,请在 Github 上提交问题(链接在新窗口中打开)。
将 Tableau 连接到数据
- 启动 Tableau,并在“连接”下选择刚刚安装的连接器的名称。有关数据连接器的完整列表,请在“至服务器”下选择“更多”。
- 输入系统提示您输入的信息,然后选择“登录”。
- 当连接器将您的数据检索到 Tableau 中时,请稍候。
- 选择工作表标签以开始分析。
连接器的加载顺序
如果连接器与已注册的连接器具有相同的类别,则新连接器将被拒绝。当两个连接器具有相同的类名称时,首先加载的连接器具有优先权。
Tableau 按目录采用下列顺序加载连接器:
- 内置 Tableau 连接器
- 位于
C:\Program Files\Tableau\Connectors
(Windows) 或/opt/tableau/connectors
(Linux) 的连接器 - 位于
My Tableau Repository/Connectors
的连接器 - (可选)
-DConnectPluginsPath
指定的 dev 路径中的连接器
已知问题(仅限 Tableau Server)
尝试连接到 Tableau Server 上基于 WDC 3.0 的连接器时,用户可能会看到“Tableau Server(版本<版本号>)在使用此工作表时遇到错误”错误消息。
出现此错误的原因是,创建工作簿时所用的基于 Web Data Connector 3.0 的连接器与多节点 Tableau Server 不兼容。目前尚无解决方法或解决方案。有关详细信息,请参见使用基于 WDC 3.0 的连接器进行 Web 制作时,收到 HTTP 503 以及错误“遇到错误”(链接在新窗口中打开)知识文章。
另请参见
- Tableau 连接器 SDK(链接在新窗口中打开)- 查找信息和工具以构建和测试您自己的自定义连接器。
- 使用 Tableau Exchange 中合作伙伴构建的连接器 - 查找和安装 Tableau Exchange 的连接器。