tabcmd 命令

附註:在大多數情況下,您必須對 Tableau Cloud 使用 tabcmd 命令列公用程式 2.0 (tabcmd 2.0)。Tabcmd 2.0 可從 Tableau tabcmd(連結在新視窗開啟) 取得。此新版本可讓您在 MacOS 和 Linux 上執行 tabcmd 命令、使用個人存取權杖 (PAT) 進行驗證,並讓您符合多重要素驗證 (MFA) 要求。版本 2.0 依據基於 Python 的 Tableau Server 用戶端 (TSC) 中可用的公用端點建置。

您可以在 Tableau Cloud 中透過 tabcmd 命令列工具使用以下命令:

addusers group-name

將使用者新增到指定的群組。

範例

tabcmd addusers "Development" --users "users.csv"

選項

--users

將給定 .csv 檔中的使用者新增到指定組中。該檔案應是每行一個使用者名的簡單清單。使用者名稱不區分大小寫。使用者應已在 Tableau Cloud 上建立。

有關詳情,請參閱 CSV 匯入檔案指導方針

--[no-]complete

當設定為 complete 時,此選項要求所有列都必須有效,變更才能成功。如果未指定,則使用 --complete

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createextracts

為已發佈的工作簿或資料來源建立擷取。

選項

-d, --datasource

用於擷取建立的目標資料來源名稱。

--embedded-datasources

目標工作簿中的嵌入資料來源清單(以空格分隔)。若資料來源名稱包含空格,則以雙引號括起來。只有在針對工作簿建立擷取時可用。

--encrypt

建立加密的擷取。

--include-all

在目標工作簿中包括所有嵌入資料來源。只有在針對工作簿建立擷取時可用。

--parent-project-path

包含目標資源之專案的父專案路徑。必須使用 --project 指定專案名稱。

--project

包含目標資源的專案的名稱。唯有在指定 --workbook 或 --datasource 時才有需要。如果未指定,則使用預設專案 'Default'。

-u, -url

顯示在 URL 中的資源的正式名稱。

-w, -workbook

用於擷取建立的目標工作簿名稱。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

creategroup group-name

建立一個群組。 使用 addusers 在建立群組後新增使用者。

範例

tabcmd creategroup "Development"

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createproject project-name

建立一個專案。

範例

tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."

選項

-n, --name

指定要建立的專案的名稱。

--parent-project-path

使用 -n 選項指定時,指定巢狀專案的父專案名稱。例如,若要指定存在於「Main」專案中名稱為「Nested」的專案,請使用以下語法:--parent-project-path "Main" -n "Nested"

-d, --description

為專案指定說明。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createsiteusers filename.csv

根據逗號分隔值 (CSV) 檔中提供的資訊將使用者新增到網站。如果尚未在伺服器中建立該使用者,則該命令會在將使用者新增至該站台前建立該使用者。

CSV 檔案必須包含一個或多個使用者名,還可(為每個使用者)包括一個密碼、全名、授權類型、管理員層級、發佈者(是/否),以及電子郵件地址。有關 CSV 檔案的格式的資訊,請參閱 CSV 匯入檔案指導方針

作為在 CSV 檔案中包括管理員層級和發佈者權限的替代方法,您可以透過包括 --role 選項並指定要為 CSV 檔案中列出的使用者分配的網站角色來傳遞存取層級資訊。

預設情況下,使用者將新增到您登入的站台。若要將使用者新增到其他網站,請包括全域 --site 選項並指定該網站。(您必須具有在指定的網站上建立使用者的使用權限。)

範例

tabcmd createsiteusers "users.csv" --role "Explorer"

選項

--admin-type

已棄用。請改用 --role 選項。

--auth-type

.csv 檔中的所有使用者設定驗證類型(TableauIDSAML)。如果未指定,則預設值為 TableauID

附註:若要使用 SAML 驗證,網站本身也必須啟用 SAML。有關資訊,請參閱在網站上啟用 SAML 驗證

--[no-]complete

已棄用。預設錯誤行為:如果在十行範圍內有 3 個或更多錯誤,則命令將失敗。

--no-publisher

已棄用。請改用 --role 選項。

--nowait

不等待非同步作業完成。

--publisher

已棄用。請改用 --role 選項。

--role

.csv 中的所有使用者指定站台角色。如果要使用 --role 選項指派站台角色,請為每個站台角色建立單獨的 CSV 檔案。

有效的值為:ServerAdministrator, SiteAdministratorCreator, SiteAdministratorExplorer, SiteAdministrator, Creator, ExplorerCanPublish, Publisher, Explorer, Interactor, Viewer, and Unlicensed.

對於新使用者,預設值為 Unlicensed,對於現有使用者,預設值不變。如果有基於使用者的伺服器安裝,並且在 createsiteusers 命令建立新使用者的情況下您已達到使用授權數的限制,則會以未授權使用者的形式新增該使用者。

附註:在多網站 Tableau Server 上,如果要使用 --role 選項指派 ServerAdministrator 站台角色,請使用 createusers 命令,而不是 createsiteusers

--silent-progress

不顯示命令的進度訊息。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

delete workbook-namedatasource-name

從伺服器中刪除指定工作簿或資料來源。

此命令按原樣使用伺服器上的工作簿或資料來源的名稱,而不是發佈時的檔案名。

範例

tabcmd delete "Sales_Analysis"

選項

-r, --project

包含您要刪除的工作簿或資料來源的專案的名稱。如果未指定,則使用「Default」專案。

--parent-project-path

使用 -r 選項指定時,指定巢狀專案的父專案名稱。例如,若要指定存在於「Main」專案中名稱為「Nested」的專案,請使用以下語法:--parent-project-path "Main" -r "Nested"

--workbook

要刪除的工作簿的名稱。

--datasource

要刪除的資料來源的名稱。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deleteextracts

刪除已發佈的工作簿或資料來源的擷取。

選項

-d, --datasource

用於擷取刪除的目標資料來源名稱。

--embedded-datasources

目標工作簿中的嵌入資料來源清單(以空格分隔)。若資料來源名稱包含空格,則以雙引號括起來。只有在針對工作簿刪除擷取時可用。

--encrypt

建立加密的擷取。

--include-all

在目標工作簿中包括所有嵌入資料來源。

--parent-project-path

包含目標資源之專案的父專案路徑。必須使用 --project 指定專案名稱。

--project

包含目標資源的專案的名稱。唯有在指定 --workbook 或 --datasource 時才有需要。如果未指定,則使用預設專案 'Default'。

-u, -url

顯示在 URL 中的資源的正式名稱。

-w, -workbook

用於擷取刪除的目標工作簿名稱。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deletegroup group-name

從伺服器中刪除指定的組。

範例

tabcmd deletegroup "Development"

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deleteproject project-name

從伺服器中刪除指定的專案。

使用 tabcmd,您可以僅指定專案階層中的頂層專案。若要自動執行想要對父專案內的專案執行的工作,請使用等效的 Tableau REST API(連結在新視窗開啟) 調用。

範例

tabcmd deleteproject "Designs"

選項

--parent-project-path

使用命令指定時,指定巢狀專案的父專案名稱。例如,若要指定存在於「Main」專案中名稱為「Designs」的專案,請使用以下語法:--parent-project-path "Main" "Designs"

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deletesiteusers filename.csv

從您登入的站台中移除該使用者。要移除的使用者在一個檔中指定,該檔包含每行一個使用者名的簡單清單。(除使用者名之外不需要其他資訊。)

預設情況下,如果伺服器只有一個網站,或者使用者只屬於一個網站,則還會從伺服器中移除使用者。在 Tableau Server Enterprise 安裝中,如果伺服器包含多個站台,則會從站台中移除指派了「伺服器管理員」站台角色的使用者,但不會將其從伺服器中移除。

如果使用者擁有內容,則使用者的角色將變為「未授權」,但不會從伺服器或站台中將其移除。內容仍然由該使用者擁有。若要完全移除使用者,您必須變更內容的所有者,然後再次嘗試移除使用者。

範例

tabcmd deletesiteusers "users.csv"

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

export

Tableau Cloud 匯出檢視或工作簿,並將其儲存到文件。此命令還可匯出恰好適用於檢視的資料。檢視資料會在摘要層級匯出。要匯出詳細資訊層級的資料,必須使用 Tableau Server UI。有關詳細資訊,請參閱下載檢視和工作簿(連結在新視窗開啟)

使用此命令時,請注意以下問題:

  • 使用權限:若要匯出,您必須擁有匯出影像使用權限。雖然可針對每個工作簿或檢視設定使用權限,但預設情況下,所有角色均會獲得或繼承此使用權限。

  • 匯出資料:若要匯出恰好適用於檢視的資料,請使用 --csv 選項。這會將檢視中使用的摘要資料匯出為 .csv 文件。

  • 指定要匯出的檢視、工作簿或資料:

    • 使用 URL 的一部分標識要匯出的內容,特別是工作簿或檢視的 URL 中顯示的 "workbook/view" 字串。不要使用「友好名稱」,並且不要包括 URL 末尾的 :iid=<n> 工作階段 ID。

      例如,「Superstore」工作簿中的 Tableau 範例檢視「訂單明細」具有類似於如下的 URL: <server_name>/#/views/Superstore/OrderDetails?:iid=2

      若要匯出「訂單明細」檢視,請使用字串 Superstore/OrderDetails

      不要使用 Superstore/Order DetailsSuperstore/OrderDetails?:iid=2

    • 如果伺服器執行多個網站,並且檢視或工作簿不在「預設」網站上,請使用 -t <site_id>

    • 若要匯出工作簿,請透過在工作簿中開啟檢視來獲取 URL 字串,並在使用的字串中包括檢視。

      在上面的範例中,若要匯出「Regional」(區域)工作簿,請使用字串 Superstore/OrderDetails

    • 若要匯出工作簿,必須已在「Tableau Desktop 發佈」對話方塊中選中「將試算表顯示為標籤」的情況下發佈該工作簿。

      附註:包含管理檢視(連結在新視窗開啟)的 Tableau 工作簿無法予以匯出。

    • 若要篩選下載的資料,請使用以下格式新增參數篩選器:

      ?<filter_name>=value

      或者,若對參數進行篩選,並且該參數的顯示名稱與度量或維度的名稱相符:

      ?Parameters.<filter_name>=value

  • 已儲存的格式:格式選項取決於所匯出的內容。只能使用 --fullpdf 參數將工作簿匯出為 PDF。可將檢視匯出為 PDF (--pdf) 或 PNG (--png)。

  • 已儲存的名稱和位置(可選):如果您不提供名稱,則將從檢視或工作簿名稱得到名稱。如果您不提供位置,則會將該檔案儲存到當前工作目錄。否則,您可以指定完整路徑或目前工作目錄的相對路徑。

    附註:您必須包括檔案副檔名,例如 .csv.pdf。該命令不會自動為您提供的檔案名新增副檔名。

  • PDF 匯出中不包含儀表板窗格網頁物件:儀表板窗格可以包含網頁物件。如果要將包含網頁物件的儀表板窗格匯出到 PDF,則 PDF 中將不包括該網頁物件。

  • 非 ASCII 字元、非標準 ASCII 字元與 PDF 匯出:如果您匯出的檢視或工作簿名稱所包含的字元不在 ASCII 字元集或非標準 ASCII 字元集內,則需要對字元進行 URL 編碼(或百分號編碼)。

    舉例來說,如果您的命令包括城市 Zürich,則需要將其 URL 編碼為 Z%C3%BCrich

    tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf

清除快取以使用即時資料

您可以選取新增 URL 參數 ?:refresh=yes 強制重新整理資料查詢而不是從快取中獲取結果。如果要將 tabcmd 與您自己的指令碼結合使用,並且大量使用 refresh URL 參數,則可能會對效能造成負面影響。建議您僅當需要即時資料時才使用 refresh,例如,在單個儀表板窗格上而不是整個工作簿上。

範例

檢視

tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"

tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

tabcmd export "Finance/InvestmentGrowth" --png

tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png

工作簿

tabcmd export "Q1Sales/Sales_Report" --fullpdf

tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

選項

-f, --filename

使用給定檔案名和副檔名儲存。

--csv

僅檢視。以 .csv 格式匯出檢視的資料(摘要資料)。

--pdf

僅檢視。匯出為 PDF。

--png

僅檢視。匯出為 .png 格式的影像。

--fullpdf

僅工作簿。匯出為 PDF。必須已在「將試算表顯示為索引標籤」已啟用的情況下發佈該工作簿。

--pagelayout

設定所匯出的 PDF 的頁面方向(landscapeportrait)。如果不指定,則將使用其 Tableau Desktop 設定。

--pagesize

將匯出的 PDF 的頁面大小設定為以下各項之一:unspecifiedletterlegalnote foliotabloidledgerstatementexecutivea3a4a5b4b5quarto。預設值為 letter

--width

以圖元為單位設定寬度。預設值為 800 圖元。

--height

以圖元為單位設定高度。預設值為 600 圖元。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

get url

從指定(部分)URL 表示的 Tableau Cloud 中獲取資源。結果以檔案形式返回。

使用此命令時,請注意以下問題:

  • 使用權限:若要獲取檔案,您必須擁有「下載/另存到 Web」使用權限。雖然可針對每個工作簿或檢視設定使用權限,但預設情況下,所有角色均會獲得或繼承此使用權限。

  • 指定要獲取的檢視或工作簿:使用 "/views/<workbookname>/<viewname>.<extension>" 字串指定要獲取的檢視,並使用 "/workbooks/<workbookname>.<extension>" 字串指定要獲取的工作簿。將 <workbookname> <viewname> 替換為當您在瀏覽器開啟檢視時工作簿和檢視在 URL 中的顯示名稱,並將 <extension> 替換為想要儲存的檔案類型。不要在 URL 的末尾使用工作階段 ID (?:iid=<n>),也不要使用工作簿或檢視的「友好」名稱。

    例如,當您在名為 Metrics Summary 的工作簿中開啟檢視 Regional Totals 時,URL 將類似於如下:

    /views/MetricsSummary_1/RegionalTotals?:iid=1

    使用字串 /views/MetricsSummary_1/RegionalTotals.<extension> 來獲取檢視。

    使用字串 /workbooks/MetricsSummary_1.<extension> 來獲取工作簿。

    Tableau Cloud 下載工作簿和檢視時,.twb 或 .twbx 檔案的內容以純文字形式儲存。所有資料,包括可能為資料提供語義線索的篩選器值,都可以被開啟檔案的任何人讀取。

  • 檔案副檔名:URL 必須包括檔案副檔名。副檔名確定返回的內容。可採用 PDF、PNG 或 CSV(僅限匯總資料)格式返回檢視。Tableau 工作簿作為 TWB 返回(如果它連線到發行資料來源或使用即時連線)或者作為 TWBX 返回(如果它連線到擷取)。

    附註:如果要將檢視下載為 PDF 或 PNG 檔,並且包含包括 .pdf 或 .png 副檔名的 --filename 參數,則不必在 URL 中包含 .pdf 或 .png 副檔名。

  • 已儲存的名稱和位置(可選):用於 --filename 的名稱應包含該檔副檔名。如果您不提供名稱和檔副檔名,則這兩個名稱都將從 URL 字串得到。如果您不提供位置,則會將該檔案儲存到當前工作目錄。否則,您可以指定完整路徑或目前工作目錄的相對路徑。

  • PNG 大小(可選):如果儲存的檔案是 PNG,您可以在 URL 中指定該大小(以圖元為單位)。

清除快取以使用即時資料

您可以選取新增 URL 參數 ?:refresh=yes 強制重新整理資料查詢而不是從快取中獲取結果。如果將 tabcmd 與您自己的指令碼結合使用,則大量使用 refresh 參數可能會對效能造成負面影響。建議您僅當需要即時資料時才使用 refresh,例如,在單個儀表板窗格上而不是整個工作簿上。

範例

檢視

tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"

tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth.csv"

tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png

tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png

工作簿

tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

login

重要提示:tabcmd 1.0 不支援多重要素驗證 (MFA)。要將 tabcmd 用於 Tableau Cloud,請使用 Tableau tabcmd 2.0(連結在新視窗開啟)(新視窗)。有關 Tableau Cloud 和 MFA 的詳細資訊,請參閱多重要素驗證和 Tableau Cloud

使 Tableau Cloud 使用者登入。

可使用 --server--site--username--password 全域選項來建立會話。

附註:若使用 tabcmd login 命令,則即使伺服器設為使用 SAML,也無法使用 SAML 單一登入 (SSO)。若要登入,您必須傳遞在網站上建立的使用者的名稱和密碼。您將具有作為 Tableau Cloud 使用者身分登入的相關權限。

如果要使用建立會話時使用的相同資訊進行登入,只需指定 --password 選項。將使用存儲在 Cookie 中的伺服器和使用者名。

如果伺服器使用 80(預設值)之外的埠,您需要指定該埠。

僅當該伺服器執行多個站台,並且您登入的站台不是預設站台時,才需要使用 --site (-t) 選項。如果未提供密碼,則會提示您輸入密碼。如果指定 --no-prompt 選項但未提供密碼,則該命令將失敗。

登入後,該會話將繼續進行,直到其在伺服器上過期或 logout 命令執行。

範例

登入到具有指定的網站 ID 的 Tableau Cloud 網站:

tabcmd login -s https://prod-useast-b.online.tableau.com -t siteID -u user@email.com -p password

選項

-s, --server

如果在網路上的 Tableau Server 電腦中執行該命令,可以使用 http://localhost。否則,指定電腦的 URL,例如 http://bigbox.myco.comhttp://bigbox

如果伺服0器使用 SSL,則需要在電腦的URL中指定https://

對於 Tableau Cloud,請指定完整的 URL,包括部署站台的 Pod。例如:https://prod-useast-b.online.tableau.com

-t, --site

如果伺服器具有多個站台,且您登入的站台不是預設站台時,請使用此選項。

在 URL 中使用站台 ID 以唯一地標識站台。例如,名為 West Coast Sales 的站台的 ID 可能為 west-coast-sales。

-u, --username

登入使用者的使用者名。對於 Tableau Cloud,使用者名是使用者的電子郵件地址。

-p, --password

--username 所指定的使用者的密碼。如果未提供密碼,則會提示您輸入密碼。

--password-file

允許將密碼存儲在給定 filename.txt 檔中而不是命令列中以增加安全性。

-x, --proxy

用於指定 tabcmd 請求的 HTTP Proxy 伺服器與連接埠(主機:連接埠)。

--no-prompt

不提示輸入密碼。如果未指定密碼,則 login 命令將失敗。

--cookie

登入時儲存會話 ID。後續命令將不需要登入。此值是命令的預設值。

--no-cookie

成功登入後不儲存工作階段 ID 資訊。後續命令將需要登入名。

--timeout SECONDS

處理 login 命令前伺服器應等待的秒數。預設值:30 秒。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

logout

登出伺服器。

範例

tabcmd logout

publish filename.twb(x)filename.tds(x)filename.hyper

將指定的工作簿 (.twb(x))、資料來源 (.tds(x)) 或擷取 (.hyper) 發佈到 Tableau Cloud

如果要發佈工作簿,則預設情況下無需資料庫使用者名或密碼即可發佈工作簿中的所有工作表。

將從在其中發佈檔案的專案中複製最初指派給工作簿或資料來源的使用權限。可在發佈了檔後變更已發佈資源的使用權限。 

如果工作簿中包含使用者篩選條件,則必須指定一個縮圖選項。

範例

tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"
--oauth-username "user-name" --save-oauth

如果該檔案與 tabcmd 並不位於同一目錄,請包含檔案的完整路徑。

範例

tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth

選項

-n, --name

伺服器上工作簿或資料來源的名稱如果省略,則工作簿、資料來源或擷取將以檔案名來命名。

-o, --overwrite

如果伺服器上已存在該工作簿、資料來源或擷取,則將其覆蓋。

-r, --project

將工作簿、資料來源或擷取發佈到指定專案。如果未指定,則發佈到「Default」專案。

--parent-project-path

使用 -r 選項指定時,指定巢狀專案的父專案名稱。例如,若要指定存在於「Main」專案中名稱為「Nested」的專案,請使用以下語法:--parent-project-path "Main" -r "Nested"

--db-username

使用此選項可將資料庫使用者名與工作簿、資料來源或擷取一起發佈。

如果透過受保護 OAuth 連線和存取權杖連線到資料來源,則應改用 --oauth-username 選項。

--db-password

使用此選項可將資料庫密碼與工作簿、資料來源或擷取一起發佈。

--save-db-password

將提供的資料庫密碼存儲在伺服器上。

--oauth-username

使用者帳戶的電子郵件地址。如果使用者對 --name 中指定的雲端資料來源已經有儲存的存取權杖,則透過預先設定的 OAuth 連線來連線該使用者。存取權杖在使用者首選項中管理。

對於資料來源的現有 OAuth 連線,應使用該選項而不是 --db-username--db-password

--save-oauth

--oauth-username 指定的認證儲存為已發佈工作簿或資料來源的嵌入式認證。

隨後,當發行者或伺服器管理員登入伺服器並編輯該工作簿或資料來源的連線時,連線設定將顯示此 OAuth 認證已嵌入到內容中。

如果要安排在發佈後重新整理擷取,則必須對 --oauth-username 使用該選項。這與對傳統的資料庫連線使用 --save-db-password 類似。

--thumbnail-username

如果工作簿中包含使用者篩選條件,則將基於指定使用者可看到的內容產生縮圖。設定 --thumbnail-group 選項後,無法指定此選項。

--thumbnail-group

如果工作簿中包含使用者篩選條件,則將基於指定群組可看到的內容產生縮圖。設定 --thumbnail-username 選項後,無法指定此選項。

--tabbed

發佈帶有索引標籤式檢視的工作簿時,每個工作表都成為一個索引標籤,Viewer(檢視器)可以使用這些索引標籤在工作簿中巡覽。請注意,此設定將替代任何工作表級安全設定。

--append

將擷取檔案附加到現有的資料來源中。

--replace

使用擷取檔案替換現有的資料來源。

--disable-uploader

停用增量檔案上傳器。

--restart

重新啟動檔上傳過程。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

refreshextracts workbook-namedatasource-name

對屬於指定工作簿或資料來源的擷取執行完全或累加式重新整理。

此命令使用伺服器上顯示的工作簿或資料來源的名稱,而不使用發佈時的檔案名。僅允許管理員或者工作簿或資料來源的所有者執行此操作。

附註: 

範例

tabcmd refreshextracts --datasource sales_ds

tabcmd refreshextracts --project "Sales External" --datasource sales_ds

tabcmd refreshextracts --project "Sales External" --parent-project-path "Main" --project "Sales External" --datasource sales_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales_ds --removecalculations

選項

--incremental

執行累加式重新整理操作。

--synchronous

將完全重新整理操作新增至背景程式處理序所使用的佇列,以在背景程式處理序可用時立即執行。如果背景程式處理序可用,則立即執行此操作。重新整理操作會出現在「背景工作」報告中。

在同步重新整理期間,tabcmd 在重新整理操作進行時保持即時連線到伺服器,並且每秒鐘進行一次輪詢,直到背景作業完成為止。

附註:--synchronous 選項對使用 Tableau Bridge 進行重新整理的資料來源不可用。

--workbook

包含要重新整理的擷取的工作簿的名稱。如果工作簿名稱中含有空格,請將名稱放入引號內。

--datasource

包含要重新整理的擷取的資料來源的名稱。

--project

--workbook--datasource 結合使用可確定 Default 以外的專案中的工作簿或資料來源。如果未指定,則使用「Default」專案。

--parent-project-path

使用 --project 選項指定時,指定巢狀專案的父專案名稱。

例如:

  • 若要指定存在於「Main」專案中名稱為「Nested」的專案,請使用以下語法:
  • --parent-project-path "Main" --project "Nested"
  • 若要指定巢嵌在「Nested」專案中的名稱為「Nested2」的專案: 
  • --parent-project-path "Main/Nested" --project "Nested2"

--url

顯示在 URL 中的工作簿的名稱。發佈為「Sales Analysis」工作簿的 URL 名稱為「SalesAnalysis」。

--addcalculations

--workbook 結合使用以在工作簿的嵌入式擷取中實現計算,或與 --datasource 結合使用以在擷取資料來源中實現計算。將操作新增到背景程式處理序使用的查詢中。如果背景程式處理序可用,操作將立即執行。此操作出現在擷取背景工作 管理檢視中。

--removecalculations

--workbook --datasource 結合使用可移除以前實現的計算。將操作新增到背景程式處理序使用的查詢中。如果背景程式處理序可用,操作將立即執行。此操作出現在擷取背景工作 管理檢視中。

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

removeusers group-name

從指定的組中移除使用者。

範例

tabcmd removeusers "Development" --users "users.csv"

選項

--users

從指定的組刪除給定 .csv 檔案中的使用者。該檔案應是每行一個使用者名的簡單清單。

--[no-]complete

要求所有列都必須有效,變更才能成功。如果未指定,則使用 --complete

全域選項

所有 tabcmd 命令都使用以下選項。若要開始一個會話,至少需要使用一次 --server--user--password 選項。將存儲一個驗證權杖,以便可以不用包括這些選項就能執行後續命令。此權杖在使用它的最後一個命令之後五分鐘內保持有效。

-h, --help

顯示命令說明。

附註:在 Tableau Cloud 中使用 tabcmd 時,列出的某些命令可能不適用。

-s, --server

Tableau Cloud URL,至少需要使用一次才能開始會話。

-u, --user

Tableau Cloud 使用者名,至少需要使用一次才能開始會話。

-p, --password

Tableau Cloud 密碼,至少需要使用一次才能開始會話。

--password-file

允許將密碼存儲在給定 .txt 檔案中而不是命令列中以增加安全性。

-t, --site

指示命令將套用於由 Tableau Cloud 站點 ID 指定的站點(以單引號或雙引號括住)。如果指定的使用者與多個網站關聯,請使用此選項。網站 ID 使用擷取驗證權杖時會區分大小寫。如果您的權杖大小寫不符合,即使其仍有效,系統可能會提示您輸入密碼。

--no-prompt

指定後,該命令將不提示輸入密碼。如果未提供有效密碼,則該命令將失敗。

--[no-]cookie

指定後,登入時將儲存會話 ID,這樣後續命令就無需登入。若要不儲存會話 ID,請使用 no- 首碼。預設情況下,將儲存會話。

--timeout

等待指定秒數以使伺服器完成命令處理。預設情況下,處理程序將等待伺服器回應。

--

指定命令列上的選項結尾。您可以使用 --tabcmd 指明不應將 -- 後面的內容解釋為選項設定,而是解釋為命令的值。如果需要在包括連字號的命令中指定值,這將非常有用。下面的範例顯示如何能在 tabcmd 命令中使用 --,在該命令中,-430105/Sheet1export 命令的必需值。

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

提示:有關可用於 Tableau Server 的 Tabcmd 1.0 命令,請參閱 tabcmd 命令(連結在新視窗開啟)
感謝您的意見反應!已成功提交您的意見回饋。謝謝!