使用 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 中使用它:

  1. 下载连接器文件,即[连接器名称].taco。
  2. 将 .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

注意:安装连接器后,它将显示在 Tableau 中的连接器列表中。

如果您发现 WDC 库、模拟器或任何开发人员示例有问题,请在 Github 上提交问题(链接在新窗口中打开)

将 Tableau 连接到数据

  1. 启动 Tableau,并在“连接”下选择刚刚安装的连接器的名称。有关数据连接器的完整列表,请在“至服务器”下选择“更多”
  2. 输入系统提示您输入的信息,然后选择“登录”
  3. 当连接器将您的数据检索到 Tableau 中时,请稍候。
  4. 选择工作表标签以开始分析。

连接器的加载顺序

如果连接器与已注册的连接器具有相同的类别,则新连接器将被拒绝。当两个连接器具有相同的类名称时,首先加载的连接器具有优先权。

Tableau 按目录采用下列顺序加载连接器:

  1. 内置 Tableau 连接器
  2. 位于 C:\Program Files\Tableau\Connectors (Windows) 或 /opt/tableau/connectors (Linux) 的连接器
  3. 位于 My Tableau Repository/Connectors 的连接器
  4. (可选)-DConnectPluginsPath 指定的 dev 路径中的连接器

已知问题(仅限 Tableau Server)

尝试连接到 Tableau Server 上基于 WDC 3.0 的连接器时,用户可能会看到“Tableau Server(版本<版本号>)在使用此工作表时遇到错误”错误消息。

出现此错误的原因是,创建工作簿时所用的基于 Web Data Connector 3.0 的连接器与多节点 Tableau Server 不兼容。目前尚无解决方法或解决方案。有关详细信息,请参见使用基于 WDC 3.0 的连接器进行 Web 制作时,收到 HTTP 503 以及错误“遇到错误”(链接在新窗口中打开)知识文章。

另请参见

感谢您的反馈!您的反馈已成功提交。谢谢!