使用 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 Data Connector 3.0 文件

使用 Web Data Connector 3.0 SDK 建立的連接器

使用 Web Data Connector 3.0SDK 建立連接器之後,請按以下步驟與 Tableau 搭配使用:

  1. 下載連接器檔案,[連接器名稱].taco。
  2. 將 .taco 檔案放在以下目錄中(預設位置):
    • 對於 2021.2 及更高版本:
      對於 Tableau Desktop對於 Tableau Prep Builder適用於 Tableau Server
      • Windows - C:\Users\[Windows 使用者]\Documents\我的 Tableau 存放庫\Connectors
      • macOS - /Users/[使用者]/Documents/我的 Tableau 存放庫/Connectors
      • Windows:C:\使用者\[Windows 使用者]\文件\我的 Tableau Prep 存放庫\連接器
      • MacOS: /Users//Documents/我的 Tableau Prep 存放庫/Connectors
      • Windows:C:\Program Files\Tableau\Connectors

      • Linux:/opt/tableau/connectors

    • 對於 2021.1 及更早版本:
      對於 Tableau Desktop對於 Tableau Prep Builder對於 Tableau Server、Tableau Prep Conductor、Tableau Prep 流程製作
      • Windows - C:\Users\[Windows 使用者]\Documents\我的 Tableau 存放庫\Connectors
      • macOS - /Users/[使用者]/Documents/我的 Tableau 存放庫/Connectors
      • Windows:C:\使用者\[Windows 使用者]\文件\我的 Tableau Prep 存放庫\連接器
      • MacOS: /Users//Documents/我的 Tableau Prep 存放庫/Connectors
      • Tableau Server:[Tableau_Server_Installation_Directory]/data/tabsvc/vizqlserver/Connectors

      要為 Prep 啟用連接器,還需在以下位置新增您的 taco:

      • Tableau Prep Conductor:[Tableau_Server_Installation_Directory]/data/tabsvc/flowprocessor/Connectors
      • Tableau Prep Flow Authoring:[Tableau_Server_Installation_Directory]/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 資料連接器 3.0 的連接器與多節點 Tableau Server 不相容。目前沒有因應措施或解決方案。有關詳細資訊,請參閱使用基於 WDC 3.0 的連接器進行 Web 製作時,收到 HTTP 503 以及錯誤「遇到錯誤」(連結在新視窗開啟)知識文章。

另請參閱

感謝您的意見反應!已成功提交您的意見回饋。謝謝!