tabcmd
附註:
Tableau 提供了 tabcmd 命令列公用程式,您可以使用它在 Tableau Server 網站上自動完成網站管理工作。舉例來說,建立或刪除使用者、專案和群組。
附註:在 2024.1 之前的 Tableau 版本中,tabcmd 版本 1 不適用於匯出視覺效果。
附註:tabcmd 公用程式隨 Tableau Server 一起提供,會在初始伺服器節點中自動安裝。但是不隨附其安裝程式,因此,要在初始伺服器節點 Tableau Server 以外的電腦上執行 tabcmd,則需要從 Tableau 網站下載安裝程式。有關詳情,請參閱以下的安裝 tabcmd。
附註:這些說明用於安裝 tabcmd 1.0 命令列公用程式。要安裝 tabcmd 2.0 命令列公用程式,請前往 Tableau tabcmd(連結在新視窗開啟) (新視窗)。
將 Tableau Server 或 Tableau Cloud 升級到新版本時,若需要 tabcmd 的更新版本,可以從 Tableau 網站上「Tableau Server 版本」頁面下載該版本。
對於 Tableau Server,我們建議下載與伺服器版本相符的版本。對於 Tableau Cloud,我們建議始終下載最新版本,以避免版本不相容引起的問題。無論任一種情況,使用 tabcmd 的過時版本可能會導致錯誤和不可預知的結果。
開啟網頁瀏覽器,然後前往「Tableau Server 版本」(連結在新視窗開啟)頁面。即使使用的是 Tableau Online,也請前往此頁面。
若使用的是;
- Tableau Cloud,使用 Tableau tabcmd 2.0(連結在新視窗開啟)(新視窗)。
- Tableau Server(Windows 或 Linux):選取與伺服器版本相符的版本。
無論任一種情況,若展開的資訊顯示維護版本,請選取最新維護版本,或選取與伺服器版本相符的維護版本。
這會帶您進入版本說明頁面(稱為「已解決的問題」),您可以在其中閱讀有關安全性改進和已解決問題的資訊。
滾動到已解決問題下的「下載檔案」部分,選取與您將從中執行 tabcmd 命令的電腦相容的 tabcmd 下載連結。
其餘步驟將此電腦稱為「tabcmd 電腦」。
將安裝程式儲存到 tabcmd 電腦,或儲存到可從該電腦存取的位置。
完成適合於 tabcmd 電腦作業系統的安裝步驟:
- Windows
- Linux
如要從 Linux 電腦解除安裝 tabcmd,請參閱您所執行的 Linux 版本所屬文件。
(可選)將安裝 tabcmd 的完全限定位置新增到系統路徑中,以允許執行 tabcmd 命令,而無需更改該位置,或使用各個命令指定位置。執行此操作的步驟取決於作業系統的類型和版本。有關詳情,請參閱 PATH(變數)。
使用 tabcmd 的基本步驟如下:
以管理員身分開啟命令提示字元。
附註:請勿使用 PowerShell 在 Windows 上執行 tabcmd 命令。使用 PowerShell 可能會出現非預期的行為。
在 Windows 電腦上,如果在不是初始節點的電腦上安裝了 tabcmd,請切換到安裝了 tabcmd 的目錄。
在 Linux 電腦上,您無需切換到安裝目錄。
執行 tabcmd 命令。
在使用 tabcmd 時,您必須建立經過身分驗證的伺服器會話。會話會識別伺服器或 Tableau Cloud 網站以及執行該會話的使用者。您可以先啟動會話,然後指定命令,或者在啟動會話的同時執行命令。
重要資訊:如果您要使用 tabcmd 執行多項工作,則必須依次(連續)執行工作,而非同時(並行)執行。
命令(例如 login
)和選項(例如 -s
、-u
等)不區分大小寫,但您提供的值(例如 User@Example.com
)區分大小寫。
下面的命令示範了如何對名為 tabserver.mycompany.com 的 Tableau Server 啟動會話:
tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword
下一個範例示範用於刪除名為 Sales_Workbook 的工作簿的命令:
tabcmd delete "Sales_Workbook"
下面介紹了如何用一條命令完成上述所有操作,請附註:此處不需要 login
:
tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword
一個 Tableau Server 可以執行多個網站。當工作簿執行在多網站伺服器的 Default 網站上時,不需要指定 Default,上述命令已足夠。但是,如果命令應用於 Default 之外的網站,則需要指定該網站的網站 ID(請參閱login)。下面是用於 West Coast Sales 網站上的一個工作簿的命令(網站 ID wsales
):
tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword
選項 -s
、-t
、-u
和 -p
是 tabcmd 的全域變數,可與任何命令一起使用。
有關詳情,請參閱 tabcmd 命令。