tsm sites
您可以使用 tsm sites
命令匯出現有網站以便匯入到新網站(也稱為網站遷移),以及匯入新網站。萬一錯誤將網站鎖定,則可以使用 unlock
命令。
tsm sites
命令將使用您的本機檔案存放區來儲存匯出和匯入資料。如果您執行的是多節點 Tableau 叢集,則必須在執行資料引擎處理序的 Tableau Server 上執行 tsm sites
命令。有關資料引擎處理序和需要它的處理序的資訊,請參閱Tableau Server 處理序。
附註:在 Tableau Server 執行個體之間移轉站台時,目標站台的 Tableau Server 版本必須等於或高於來源站台的 Tableau Server 版本。來源站台和目標站台都必須來自支援的 Tableau Server 版本。
有關遷移網站的全面步驟,請參閱匯出或匯入網站。
tsm sites export
將指定的 Tableau Server 網站匯出為 .zip 檔案。您可以匯出網站以在特定時間點封存其設定,或者完成網站移轉程序的第一步。
附註:如果發生錯誤,tsm sites import
和 tsm sites export
命令可以使網站保持鎖定狀態。若要解鎖網站,請使用 tsm sites unlock
命令。
概要
tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options]
選項
-f,--file <export-file>
必要。
指定 Tableau Server 將所有網站資訊儲存到的檔案的名稱。
該檔案會產生到 TSM
basefilepath.site_export.exports
變數中定義的目錄。預設情況下:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
有關檔案路徑及其修改方式的詳情,請參閱tsm File Paths。
-id,--site-id <source-siteID>
必要。
您要匯出的網站的網站 ID。您可以在從 Web 瀏覽器登入到網站時從 URL 中獲取該網站 ID。有關查找網站 ID 的資訊,請參閱 準備來源站點和目標站點。
-ow,--overwrite
可選。
覆寫已存在的同名匯出檔案。
--request-timeout <timeout in seconds>
可選。
等待指定的時間以完成命令。預設值為 43200(720 分鐘)。
tsm sites import
此命令使用您使用 tsm sites export
建立的 .zip 檔案產生一組 .csv 檔案,這些 .csv 檔案顯示匯出的源網站設定將如何對應到新的目標網站。
預設情況下,將產生 .zip 檔案並將其儲存到位於以下位置的 siteexports
目錄:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
在使用此命令之前,必須將此 .zip 檔案複製到 Tableau 期望檔案所在的目錄中。TSM basefilepath.site_import.exports
變數中定義了該位置。預設情況下,匯入目錄為:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
有關檔案路徑及其修改方式的詳情,請參閱tsm File Paths。
附註:如果發生錯誤,tsm sites import
和 tsm sites export
命令可以使網站保持鎖定狀態。若要解鎖網站,請使用 tsm sites unlock
命令。
概要
tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options]
選項
-f,--file <export-file.zip>
必要。
由
tsm sites export
處理序建立並且必須複製到匯入目錄的 .zip 檔案的名稱。預設情況下:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
-id,--site-id <target-siteID>
必要。
要匯入到的新網站(目標網站)的網站 ID。有關查找網站 ID 的資訊,請參閱 準備來源站點和目標站點。
-c,--continue-on-ignorable-errors
可選。
如果發生可忽略的錯誤,則繼續進行網站匯入。這些錯誤可能是指特定工作簿或資料來源的匯入問題。
-k,--no-verify
可選。
跳過對應檔案的驗證。
-m, --override-schedule-mapper <mapping-file.csv>
可選。
排程對應檔案以按名稱覆寫正常對應。
--request-timeout <timeout in seconds>
可選。
等待指定的時間以完成命令。預設值為 7200(120 分鐘)。
tsm sites import-verified
指定包含已匯出網站的 .csv 對應檔案的目錄,以匯入到新網站。這是網站移轉程序的最後一步。
概要
tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options]
選項
-id,--site-id <target-siteID>
必要。
要匯入到的新網站(目標網站)的網站 ID。有關查找網站 ID 的資訊,請參閱 準備來源站點和目標站點。
-w, --import-job-dir <importjob-directory>
必要。
包含來自匯出(源)網站的 .csv 檔案的
mappings
目錄的父目錄。此父目錄的名稱包括匯入 ID 以及日期和時間。例如:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457
--request-timeout <timeout in seconds>
可選。
等待指定的時間以完成命令。預設值為 7200(120 分鐘)。
tsm sites unlock
使用此命令來解除鎖定網站。
選項
-id,--site-id <target-siteID>
必要。
您要解除鎖定的網站的網站 ID。有關查找網站 ID 的資訊,請參閱 準備來源站點和目標站點。
-d, --desired-state <使已解除鎖定網站保持的狀態>
可選。
網站解除鎖定後應保持的狀態。選項為 [active] 和 [suspended] 。如果未指定,則預設值為 [active] 。
例如:
tsm sites unlock -id mysite -d suspended
--request-timeout <timeout in seconds>
可選。
等待指定的時間以完成命令。預設值為 300(5 分鐘)。
全域選項
-h, --help
可選。
顯示命令說明。
-p, --password <password>
在會話不是活動狀態的情況下為必需,
-u
或--username
也為必需。為在
-u
或--username
中指定的使用者指定密碼。如果密碼包括窗格或特殊字元,請將其括在引號中:
--password "my password"
-s, --server https://<hostname>:8850
可選。
對 Tableau 服務管理器使用指定的位址。URL 必須以
https
開頭(包括連接埠 8850),並使用伺服器名稱而不是 IP 位址。例如https://<tsm_hostname>:8850
。如果沒有指定伺服器,則假定為https://<localhost | dnsname>:8850
。--trust-admin-controller-cert
可選。
使用此旗標來信任 TSM 控制器上的自我簽署憑證。如需有關憑證信任和 CLI 連線的詳細資訊,請參閱連接 TSM 用戶端。
-u, --username <user>
在會話不是活動狀態的情況下為必需,
-p
或--password
也為必需。請指定使用者名稱。如果未包括此選項,則使用您登入所使用的認證執行該命令。