Tableau Server 中的 Web 資料連接器

Web 資料連接器 (WDC) 是一些網頁,用於對在 Tableau 中還沒有連接器的資料來源提供可透過 HTTP 存取的資料連線。WDC 允許使用者連線到幾乎任何可透過 Web 存取的資料,並且允許為其工作簿建立擷取。WDC 的資料來源可能包括內部 Web 服務、JSON 資料、REST API 以及可透過 HTTP 或 HTTPS 提供的其他來源。使用者可以建立其自己的 WDC 或使用其他人建立的連接器。

有關如何在 Tableau Desktop 中使用 WDC 的資訊,請參閱 Tableau Desktop 文件集中的 Web 資料連接器(連結在新視窗開啟)

有關如何建立 WDC 的資訊,請參閱 Github 上的 Web 資料連接器文件集

在 Tableau Server 上執行連接器之前

作為一項安全措施,除非您批准連接器,否則 Tableau Server 將不會執行 WDC,如本主題中所述。

附註:您必須是伺服器管理員才能批准 WDC 以在 Tableau Server 上使用。

WDC 之所以需要您的批准,原因是它們包含可執行代碼,並通常會向協力廠商網站發出請求。在使用者能夠將 WDC 用於 Tableau Server 之前,您必須將連接器使用的網域和連接埠新增到安全清單,並在輔助安全清單中加入可讓連接器向其傳送請求和從中接收請求的網域。在執行此操作之前,我們建議您審查和測試連接器,以便瞭解連接器所執行的操作以及它連線至哪些網站。有關詳情,請參閱測試和審查 Web 資料連接器

將連接器新增到安全清單時,請將 Tableau Server 設定為允許連線至託管該連接器的特定 URL 以及該連接器可以執行查詢動作的 URL。這是允許 Tableau Server 執行 WDC 的唯一方式。連接器隨後可託管在組織防火牆內部的伺服器上,或託管在外部網域中。對於 Tableau Server,不支援匯入 WDC。

管理安全清單中的連接器

若要將 WDC 新增到安全清單,請使用 tsm data-access web-data-connectors add 命令。此命令和下面介紹的相關命令使您能執行以下工作:

  • 將 WDC 新增到安全清單和輔助安全清單。

  • 允許或不允許所有 WDC 或 WDC 重新整理。

  • 從安全清單中移除一個或多個連接器。

  • 列出安全清單和輔助安全清單上的所有 WDC。

更新 WDC 安全清單要求重新啟動伺服器

執行對 WDC 進行變更的任何命令之後,您需要使用 tsm pending-changes apply 命令應用待定變更。

如果擱置組態需要重新啟動伺服器,pending-changes apply 命令將顯示提示,讓您知道即將重新啟動。即使伺服器已停止,也會顯示提示,但在這種情況下不會重新啟動。您可以使用 --ignore-prompt 選項隱藏提示,但這樣做不會改變重新啟動行為。如果變更不需要重新啟動,則不會出現提示即可套用變更。有關詳情,請參閱 tsm pending-changes apply

將連接器新增到安全清單和輔助安全清單

若要將連接器新增到安全清單和輔助安全清單,請使用 tsm data-access web-data-connectors add 命令,同時提供名稱、安全清單 URL 和輔助安全清單 URL。您也可以使用Web-data-connector-settings 實體來管理 WDC。執行此命令之後,您需要使用 tsm pending-changes apply 命令應用待定變更。將出現一條提示,警告您命令將重新啟動 Tableau Server。如果 Tableau Server 當前正在執行,它將重新啟動,如果已經停止,則會保持在停止狀態,不會重新啟動。

tsm data-access web-data-connectors add --name "USGS Earthquakes" --url https://tableau.github.io:443/webdataconnector/Examples/html/earthquakeUSGS.html --secondary https://tableau.github.io/.*,https://earthquake.usgs.gov/.*,https://maxcdn.bootstrapcdn.com/.*,https://ajax.googleapis.com/.*,https://connectors.tableau.com/.*

 

有關設定格式的注意事項:

  • 確保在 WDC 名稱兩邊使用直引號(" 和 '),而非彎引號或「智能」引號。若名稱包含空格,請使用雙引號 (") 。
  • 對於多個 WDC,為 --url 選項指定的埠為 443 或 80,但您可以透過在 Tableau Server 上檢閱資料來源詳細資料來檢查適用於您的連接器的值。如果 WDC 使用 SSL (HTTPS),您必須在 URL 中指定連接埠號碼。例如,若要使用 HTTPS 的預設連接埠,URL 可能需如下所示:https://example.com:443/WDC/
  • 必須為 --secondary 選項指定網址或以逗號分隔的網址清單,以指示提供 WDC 需要存取的程式庫和來源的網域。除非 WDC 不使用任何從屬網域,否則不能省略此選項或留空。若不知道 WDC 是否使用從屬網域,或者何謂從屬網域,可能需要聯絡 WDC 開發人員。還可以選擇使用 http://.*https://.* 萬用字元 URL 來允許所有網域。但是,我們強烈建議您使用更具體的網址以提高安全性。
  • 若要將整個網域新增到次要安全清單,應以萬用字元運算式作為網域 URL 的結尾。請使用 .* 作為萬用字元,以表示整個網域,如以下範例中所示:https://example.com/.*

允許或不允許 WDC 或 WDC 擷取重新整理

若要允許或不允許 WDC 或 WDC 擷取重新整理,請使用有 -t-r 選項的 tsm data-access web-data-connectors allow 命令。預設情況下,允許 WDC 和 WDC 擷取重新整理。如果您變更此設定,則需要執行 tsm pending-changes apply 命令。有關命令及命令選項,請參閱 tsm data-access web-data-connectors allow

從安全清單中移除一個或多個 WDC

若要從安全清單中移除一個或多個 WDC,請使用 tsm data-access web-data-connectors delete 命令。如果您變更此設定,則需要執行 tsm pending-changes apply 命令。有關詳情,請參閱 tsm data-access web-data-connectors delete

列出安全清單上的所有 WDC

若要列出安全清單上的所有 WDC,請使用 tsm data-access web-data-connectors list 命令:有關詳情,請參閱:tsm data-access web-data-connectors list

為連接器重新整理擷取

當使用者建立使用 WDC 的工作簿時,Tableau Server 將依據連接器返回的資料建立擷取。如果使用者以後發佈此工作簿,則在發佈過程中會將此工作簿和擷取傳送給該伺服器。

Tableau 可重新整理 WDC 建立的擷取,就像它能重新整理任何擷取一樣。如果連接器需要認證來登入到基於 Web 的資料來源,您需要確保認證與資料來源一起嵌入,並且 WDC 位於伺服器的安全清單中。如果連接器需要認證,並且它們沒有與資料來源一起內嵌,則 Tableau Server 無法重新整理擷取。這是因為重新整理可能會按排程進行或在一些其他背景環境中進行,並且伺服器無法提示輸入認證。

目前,無法直接從 Tableau Server 重新驗證資料來源。如果資料來源具有過期的認證,或者沒有內嵌認證就發佈了資料來源,則需要使用新的內嵌認證重新發佈工作簿和擷取。

如果執行重新整理操作的背景處理序失敗,它將會建立一個通知和指出此問題的記錄條目。使用者將能夠發現擷取上的時間戳記未發生變更。

若要為所有 WDC 停用重新整理,請使用 tsm data-access web-data-connectors allow -r false 命令。

疑難排解

如果伺服器遇到將連接器新增到安全清單的問題,您可以檢查記錄檔案。確保同時在初始伺服器和執行閘道處理序的其他節點上檢查記錄檔案。有關記錄檔案的詳細資料,請參閱Tableau Server 記錄檔和記錄檔位置

如果問題是 Tableau Server 將不重新整理 WDC 建立的擷取,請確保 webdataconnector.refresh.enabled 設定設定已設定為 true。如果它設定為 false,請執行以下命令為伺服器上的所有 WDC 允許擷取重新整理:

tsm data-access web-data-connectors allow -r true

附註:安全清單是允許 Tableau Server 執行 Web 資料連接器的唯一方式。從版本 10.5 開始,已棄用匯入 Web 資料連接器的功能。

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