匯出或匯入網站

附註:有關將 Tableau Server 站台遷移到 Tableau Cloud 的詳細資訊,請參閱 Tableau Cloud 手動移轉指南(連結在新視窗開啟)

您可以透過從另一個網站匯入(移轉)資訊來設定一個新 Tableau Server 網站。可透過將現有網站(網站)的資訊匯出到一個檔案來完成此操作。然後,您可完成相關步驟來驗證將該資訊匯入到目標網站。

站點移轉選項

您可以採用以下任何方式移轉網站:

  • 移轉到同一 Tableau Server 執行個體上的另一個網站。

  • 移轉到單獨 Tableau Server 執行個體上的網站。

  • Tableau Server Windows 版到 Tableau Server Linux 版,反之亦然。

附註:Tableau Server 執行個體之間移轉站台時,目標站台的 Tableau Server 版本必須等於或高於來源站台的 Tableau Server 版本。來源站台和目標站台都必須來自支援的 Tableau Server 版本。

站點移轉限制

站點匯出過程中保留的資訊

  • 您建立的匯出檔案會保留工作簿、專案、資料來源和使用者。其中包括為內容設定的權限、使用者我的最愛清單及網站配額。

  • 將保留使用者的自訂檢視;但是,根據網站移轉的類型,自訂檢視的 URL 可能會變更,導致使用者的檢視書籤損壞。

  • 當您匯出 Tableau Server 上的網站以匯入到另一個 Tableau Server 網站時,訂閱和擷取重新整理排程將保留。

站點匯出過程中不保留的資訊

  • 不會保留出現在網站管理檢視中的使用情況資料。例如,檢視和資料來源計數、使用者動作以及效能資料。

  • 匯出網站時,進行中的背景程式工作不會匯出,也不會在匯入作業完成後顯示在新網站上。

  • 內嵌在資料連線中的 OAuth 存取權杖會重設。對於這些資料來源,您將需要編輯連線並對基礎資料重新進行驗證。

  • 不包括 Prep 流程與流程排程。這些需要手動移轉。

  • 不包括儲存到使用者個人空間的內容。

準備來源站點和目標站點

在匯出網站之前,請完成以下檢查表,將兩個環境準備好。其中一些說明取決於這兩個網站是位於同一伺服器執行個體上還是位於單獨的執行個體上。

刪除過時內容

確保源網站只包含您想匯入到新網站的內容。最佳做法是從來源站台中移除您不想包含在新站台中的所有內容,無論這些內容是否包含在某個匯出/匯入中,還是需要手動移轉。刪除未使用的工作簿、資料來源或專案。如果有不再使用的 Prep 流程或流程排程,也請將其刪除。

移除廢棄的使用者

確認所有伺服器使用者均已獲得授權,並移除不再使用的帳戶。您無法在匯入過程中移除使用者,因此,如果兩個網站位於同一伺服器執行個體上,則從源網站匯出的所有使用者都將匯入目標網站。

建立或識別目標站點

您必須將網站檔案匯入到目標 Tableau Server 執行個體上已存在的網站。由於匯入過程會從目標網站中移除匯入檔案中未包括的任何內容,因此我們建議您匯入到一個空網站。有關詳情,請參閱新增或編輯網站

如果您的源網站具有使用已發佈資料來源的工作簿,則這些工作簿中的資料連線將繼續引用源網站名稱。若要保留這些連線而不必重新發佈工作簿,請確保目標網站和源網站名稱相符。

尋找站點 ID

用於匯出或匯入網站的 tsm 命令需要一個採用網站 ID 的參數。您可以在從 Web 瀏覽器登入到網站時,從 URL 中獲取該站點 ID。

如果伺服器上只有一個網站,則該網站名為「預設」。登入「預設」站點時,瀏覽器 URL 看起來如下所示:

https://server-name/#/projects

URL 中,缺少 /site 參數表示這是「預設」網站。預設網站的網站 ID 是 "Default" (沒有雙引號)。

在多站點 Tableau Server 部署中,瀏覽器 URL 包括 #/site/,後面接著站點 ID。如果巡覽到網站 ID 為 finance 的網站上的「檢視」頁面,則會出現以下 URL:

https://localhost/#/site/finance/views

檢查識別身份存放區

您可以從使用不同識別身份存放區類型的網站匯出及匯入,但必須修改用於匯入的對應檔案。此步驟內置於匯入過程中,詳見步驟 3:驗證站點設定是否正確對應

在目標伺服器上建立使用者(如有必要)

網站匯入過程會將使用者指派到一個目標網站。如果來源站點位於 Tableau Server 上的 ,而非位於目標站點,您必須先在目標伺服器上建立使用者,然後才能執行匯入。如果兩個網站位於同一 Tableau Server 執行個體上,則目標網站可以存取現有使用者,因此可以跳過此步驟。

設定目標伺服器以交付訂閱

將會匯入訂閱,但您必須設定伺服器才能交付它們。有關詳情,請參閱設定訂閱站點

檢查排程

「排程」頁面列出擷取重新整理和訂閱的現有排程。

對於從一個 Tableau Server 網站到另一個網站的移轉,指派給源網站上的預設排程的重新整理和訂閱將對應到目標網站上的相同排程。如果源網站的排程在目標網站上不存在,並且目標網站位於另一個 Tableau Server 執行個體上,則您必須在要將源排程對應到的目標網站上建立排程。您可以編輯對應檔案以確保此操作按預期方式完成。

匯入使用者或排程數較少之目標的提示

如果目標網站的使用者或排程數比源網站少,則不支援多對一匯入。如何解決這個問題取決於源網站和目標網站是否位於同一 Tableau Server 執行個體上。

您可以採用以下適用於您的網站移轉使用案例的任一方法:

  • 在匯出之前從來源網站中移除額外的使用者或排程。如果兩個網站位於同一伺服器執行個體上,則這是首選選項。

  • 在開始匯入之前向目標網站中新增缺少的使用者或排程。如果目標網站位於另一個伺服器執行個體上,則必須執行此步驟。

  • 在匯入過程中向目標網站中新增缺少的使用者或排程,並手動更新對應檔案。只有當網站網站位於同一伺服器執行個體上才需要執行此選項。

  • 在匯入過程中將使用者或排程手動對應到目標網站中的不同使用者和排程。如果使用者名在伺服器之間不同(例如,名為 adavis@company.com 的已匯出使用者在目標網站上定義為 davisa),則此選項為必需。

移轉站點

您必須使用 tsm sites 命令來完成網站移轉程序。下列步驟將引導您完成從來源網站匯出資訊、對應網站設定,以及將對應檔案匯入目標網站。

步驟 1:匯出站點

在來源 Tableau Server 電腦上,鍵入以下命令:

tsm sites export --site-id <source-siteID> --file <filename>

使用 export 命令時,Tableau Server 必須正在執行。在匯出過程中,Tableau Server 會鎖定正在匯出的站點。

例如,若要將網站 ID 為 weather-data 的網站匯出到檔案 export-file.zip,請鍵入以下命令:

tsm sites export --site-id weather-data --file export-file

預設情況下,Tableau Server 會將 <export-file>.zip 儲存到 /var/opt/tableau/tableau_server/data/tabsvc/files/siteexports。有關詳情,請參閱tsm File Paths

步驟 2:產生匯入對應檔案

若要為目標網站組建匯入檔案,您需要在完成步驟 1:匯出站點中的步驟時建立的 .zip 檔案。

附註:匯出的檔案預設不授予「他人」讀取權限。可能需要調整檔案的權限,以允許非擁有者對其進行讀取,具體取決於匯入檔案的使用者。

  1. 在目標 Tableau Server 電腦上,將匯出的 .zip 檔案複製到 Tableau Server 預期會在其中尋找匯入檔案的目錄。例如:

    /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports

  2. 驗證目標站點是否存在於 Tableau Server 上,因為匯入過程不會建立新站點。有關詳情,請參閱準備來源站點和目標站點

  3. 在目標 Tableau Server 電腦上執行以下命令(Tableau Server 必須正在執行):

    tsm sites import --site-id <target-siteID> --file <export-file.zip>

    此命令將組建一組 .csv 檔案,這些檔案顯示源網站設定將如何對應到目標網站。在本文下一部分所述的步驟中,您將確認這些對應並在需要時進行調整。

    預設情況下,這些 .csv 檔案會產生到 siteimports 下建立的 mappings 目錄中。例如:

    /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_<id>_<date-time>/mappings

    有關詳情,請參閱tsm File Paths

步驟 3:驗證站點設定是否正確對應

上一部分中組建的 .csv 檔案描述匯入完成時如何將源網站的資源設定到目標網站。檔案中 Tableau Server 無法對應的項以及您需要編輯的項由一連串問號 (???) 指明。您必須將問號替換為目標網站上的有效指派,然後才能完成匯入過程。

重要資訊:某些要求適用於對應使用者、排程和已發佈的內容資源,特別是在源網站和目標網站位於單獨 Tableau Server 執行個體上的情況下。有關詳情,請參閱本文前面的準備來源站點和目標站點

驗證對應檔案

  1. 巡覽到包含 tsm sites import 命令所組建的 .csv 對應檔案的目錄。預設情況下:

    /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_<id>_<date-time>/mappings

  2. 使用您的首選文字編輯器開啟 mappings 目錄中的其中一個 .csv 檔案,並執行以下操作。

    1. 確認對應正確無誤。

    2. 如果某個條目顯示一連串問號 (???),請將這些問號替換為有效的值。

      有關其中每個檔案中的設定的說明,請使用本文後面的對應檔案內容參考中的各個表。

    3. 儲存所做變更並保留 CSV 檔案的格式設定。

    為其餘 .csv 檔案重複此過程。

步驟 4:將正確對應的檔案匯入目標站點

驗證 .csv 檔案中的網站對應後,您可以將設定匯入新網站以完成移轉過程。

  1. 在目標 Tableau Server 電腦上執行以下命令:

    tsm sites import-verified --import-job-dir <import-id-directory> --site-id <target-siteID>

    例如:

    tsm sites import-verified --import-job-dir /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_ff00_20180102022014457
    --site-id new-site

  2. 出現成功訊息時,登入到新網站並確認所有內容均已按預期方式匯入。

附註:如果發生錯誤,tsm sites importtsm sites export 命令可以使網站保持鎖定狀態。若要解鎖網站,請使用 tsm sites unlock 命令。

對應檔案內容參考

以下各表列出了執行 tsm site import 命令時建立的每個對應檔案中的列。

CSV 檔案名:mappingsDomainMapperForGroups

資料行標題

是否可編輯?

說明

source_name

源網站上的使用者群組名稱。

source_domain_name

來源網站的識別身份存放區類型:本機(適用於本機識別身份存放區)或網域名稱(適用於 Active Directory 或 LDAP 外部識別身份存放區)。

target_domain_name

是*

目標網站的識別身份存放區類型:本機(適用於本機識別身份存放區)或網域名稱(如 example.com 或 example.lan)(適用於 Active Directory 或 LDAP 外部識別身份存放區)。

*即使目標伺服器設為使用 Active Directory 識別身份存放區,對於「所有使用者」群組,仍請將 target_domain_name 值保持設定為 local「所有使用者」群組是每個 Tableau Server 上都必須存在的特殊的預設使用者群組。

CSV 檔案名:mappingsScheduleMapper

資料行標題

是否可編輯?

說明

source_name

源網站上的自訂和預設擷取或訂閱排程的名稱。

source_scheduled_action_type

排程的類型,要麼是「重新整理擷取」(對於擷取重新整理),要麼是「訂閱」(對於源網站上的訂閱交付)。

target_name

目標網站上的自訂排程的名稱。您可以編輯該值。例如,如果排程在源網站上的名稱是「星期五更新」,您可以在目標網站上將其重新命名為「星期五重新整理」

target_scheduled_action_type

否*

排程的類型,要麼是「重新整理擷取」(對於擷取重新整理),要麼是「訂閱」(對於目標網站上的訂閱交付)。

*在極少數情況下,您會在此列中看到問號 (???),請將這些問號替換為「Refresh Extract」「Subscriptions」,以與您在「source_scheduled_action_type」下看到的條目相符。

CSV 檔案名:mappingsSiteMapper

資料行標題

是否可編輯?

說明

source_url_namespace

源網站的網站 ID。

target_url_namespace

目標網站的網站 ID。

CSV 檔案名:mappingsSystemUserNameMapper

資料行標題

是否可編輯?

說明

source_name

使用者在源網站上的使用者名屬性。

source_domain_name

來源站點的識別身份存放區類型:本機(適用於本機識別身份存放區)或網域名稱(適用於 Active Directory 或 LDAP 外部識別身份存放區),或外部

target_name

在匯入時將指派給目標網站的使用者的使用者名屬性。

確認清單中的所有使用者名在目標伺服器上都存在,請將問號 (???) 替換為目標伺服器上存在的使用者名。

不能透過向 CSV 檔案中新增列來建立使用者名。同樣,您無法透過刪除列來移除使用者名。

您可以編輯 target_name 列中的使用者名,使其不同於源使用者名,只要使用者已經使用該不同名稱存在於目標伺服器系統上即可。

例如,使用者的 source_name 值可以為 agarcia@company.com,而 target_name 值可以為 ashleygarcia@company.com

只能將源網站上的一個使用者對應到目標網站上的一個使用者名。

target_domain_name

目標網站的識別身份存放區類型:本機(適用於本機識別身份存放區)或網域名稱(適用於 Active Directory 或 LDAP 外部識別身份存放區)。

CSV 檔案名: MappingsScheduleRecurrenceMapperWithAutoCreation

此檔案不需要更新。

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