設定 Qlik Cloud 遷移工具
Qlik Cloud 遷移工具可協助您規劃並執行遷移至 Qlik Cloud。
下載並安裝 Qlik Cloud 遷移工具。
工具集中包括：
-
Qlik Sense 至 SaaS 遷移應用程式—Qlik Sense 用於管理遷移順序和監控的應用程式。
-
QlikView 至 SaaS 遷移應用程式— QlikView 用於管理遷移順序和監控的應用程式。運用 QlikView 控管儀表板。
-
遷移工作表—此 Microsoft Excel 試算表用來蒐集使用者、角色、安全性規則、授權、空間等的清單。
-
遷移指令碼—用於遷移至 Qlik Cloud 的流程。
這些工具對於組織遷移至 Qlik Sense Enterprise SaaS 的可能情況提供一般指南。這些工具提供的資訊是一般準則，為求審慎，需要另外就組織的需求對 Qlik Sense Enterprise SaaS 遷移路徑進行任何評估。
這些工具提供的建議僅供資訊參考，不代表 Qlik 對實際 Qlik Sense Enterprise SaaS 部署可能最適合您業務需求和偏好的保證或陳述。建議是基於客戶提供的資訊，若客戶提供的資訊有任何不精確或變更，可能會產生極為不同的評估和結果。若使用 ESR 工具的結果和 Qlik 標準文件之間有任何衝突，應以 Qlik 標準文件的條款為主。
修訂歷史記錄
下表概述 Qlik Cloud 遷移工具的變更。
| 日期 | 備註 |
|---|---|
| 2022 年 5 月 10 日 |
初始發行 |
| 2022 年 7 月 12 日 |
更新遷移應用程式 新的遷移指令碼 |
| 2022 年 10 月 20 日 | 錯誤修正 |
| 2023 年 3 月 7 日 | 遷移工作表已更新，以支援使用者角色的變更 |
| 2023 年 6 月 29 日 |
為 QlikView 遷移新增工具。 更新遷移應用程式 新的遷移指令碼 |
| 2023 年 10 月 31 日 |
已修訂 7_migrateapps.ps1。指令碼現在可以為工作表、書籤和故事匯入具有公用、社群和個人內容的應用程式，並自動向擁有者指派。 對指令碼做出一些小修訂，以搭配新的 qlik-cli 命令。 |
| 2023 年 11 月 28 日 | 用於容量模型分析的其他工作表。 |
下圖顯示如何執行遷移，以及遷移工具如何協助您將使用者和資產移至雲端。來自 Qlik Sense 用戶端管理 的資料和來自 Qlik Cloud 的中繼資料會提取到遷移應用程式中。遷移資料表格會儲存到 CSV 檔案並使用 qlik-cli 指令碼匯入到 Qlik Cloud。然後會載入遷移應用程式以反映遷移狀態。此流程對於要遷移的所有項目基本上都相同。
遷移指令碼
使用遷移應用程式下載 .csv 中繼資料檔案後。指令碼用來將用戶端管理的資產匯入到雲端中。若要進一步瞭解，請參閱使用遷移指令碼。
遷移準備
下列項目將有利於遷移並提供建議的工作程序。
-
主題：規劃遷移至 Qlik Cloud。評估和準備對於成功的遷移不可或缺。
-
Qlik Cloud 遷移工具 — 包含以下內容的 Zip 檔案：
- Qlik Cloud 遷移應用程式，用於管理遷移順序和監控。
- 遷移工作表：Excel 檔案。使用此試算表蒐集使用者、角色、安全性規則、授權、空間等的清單。
- 用於將項目從 Qlik Sense 用戶端管理 遷移至 Qlik Cloud 的遷移指令碼。
-
qlik-cli：命令列介面 (CLI)，可用於 Qlik Cloud 開發人員：qlik-cli
評估和規劃後，進行下列事項：
-
設定遷移應用程式：將應用程式 SaaS Migration 1.x.qvf 匯入到 Qlik 管理主控台 (QMC) 中、設定 REST 連接器、修改載入指令碼，並載入應用程式。
-
查詢租用戶的 ID。您將在關於之下的使用者設定檔功能表的 Qlik Cloud 中找到。
-
設定遷移指令碼。
-
建立標記並套用至應用程式和資料連線。
設定遷移應用程式
此區段描述如何匯出遷移應用程式、建立 API 金鑰並設定 REST 連線，並修改應用程式中的載入指令碼。若要進一步瞭解，請參閱設定遷移應用程式。
匯入遷移應用程式
請執行下列動作：
-
在 QMC 中，開啟應用程式。
-
按一下匯入。
-
前往您已下載的應用程式 SaaSMigration 1.x.qvf。
-
按一下匯入。
現在，可以在中心獲得應用程式。
設定 REST 連線
開始方式是在雲端租用戶中建立 API 金鑰。
請執行下列動作：
-
在雲端租用戶的 管理主控台 中，開啟 API 金鑰。
-
按一下產生新內容。
-
按一下產生新的金鑰。
-
輸入金鑰描述並設定金鑰到期時間。
-
按一下產生。
-
複製 API 金鑰並安全儲存。
下一步是在 Qlik Sense Enterprise on Windows 中設定 REST 連接器。
請執行下列動作：
-
在 Qlik Sense Enterprise on Windows 中，建立新的資料連線並選取 REST 作為資料來源。
資訊備註若沒有陳述其他內容，請保留預設值。 -
以下列格式輸入 URL：https://<tenant>.<region>.qlikcloud.com/api/v1/items。
-
在區段其他請求參數 > 查詢標頭，在名稱和值欄位中輸入授權，在「Bearer」後輸入您之前產生的 API 金鑰。請注意「Bearer」和 API 金鑰之間的空格。
-
在區段分頁 > 分頁類型中，選取下一個 URL，並對於「下一個 URL」路徑，輸入 root/links/next/href。
-
輸入連線名稱，例如 REST for Qlik Cloud。
-
按一下建立。
修改載入指令碼
請執行下列動作：
-
在 Qlik Sense 中心內，開啟應用程式 SaaSMigration 1.x.qvf。
就會顯示應用程式概述。
-
開啟資料載入編輯器。
-
開啟 **設定** 區段。
-
在列 Set vu_tenant_fqdn，輸入完全合格的租用戶網域名稱。
範例：Set vu_tenant_fqdn = 'my_tenant.eu.qlikcloud.com';
-
在列 Set vu_rest_connection_SaaS，輸入前往 Qlik Cloud 租用戶的 REST 連線名稱。
範例：Set vu_rest_connection_SaaS = 'MyRESTConnection for SaaS';
-
在列 SET vu_central_node_host_name，輸入中央節點主機名稱或機器名稱。
範例 1：SET vu_central_node_host_name = 'sense-central-node'
範例 2：SET vu_central_node_host_name = 'my-central-node.domain.com'
-
若虛擬 Proxy 有前置詞，您需要在列 SET vu_virtual_proxy_prefix = ''; 輸入
範例：SET vu_virtual_proxy_prefix = 'my-virtual-proxy-prefix';
設定 qlik-cli 並設定遷移指令碼
請執行下列動作：
-
安裝 Windows 版 Qlik-CLI，這是用於 Qlik Sense SaaS 的命令列介面。這透過命令列提供所有公用 API 的存取權限，以便更輕鬆地撰寫指令碼並自動化新的和舊的工作流程。
-
確認 qlik.exe 位於 Windows 執行路徑中。根據您安裝 qlik-cli 的方式，qlik.exe 依照預設可能不會位於 Windows 路徑。
-
設定連線至 Qlik Cloud，請參閱開始使用。
-
設定連線至 Qlik Sense 用戶端管理，請參閱 Qlik Sense：如何設定 JWT 驗證。
-
編輯 0_globals.ps1 並為以下項目設定內容名稱：
-
$QlikSaaSContext
-
$tenantid
租用戶 ID 可見於您的使用者設定檔 > 關於之下。
-
$MIGRATIONFROM = “Qlik Sense”
0_globals.ps1 的內容名稱設定
-
建立並套用標記
向可以存取並標記應用程式和資料連線者提供內容管理員權限是個好主意。
請執行下列動作：
-
為 Qlik Sense 用戶端管理 在 QMC (即標記區段) 中建立下列標記：
-
Con 狀態 - 05 已選取
-
Con 狀態 - 10 已設定
-
Con 狀態 - 20 已測試
-
Con 狀態 - 30 已完成
-
Con 狀態 - 99 不需要
-
Con 類型資料檔案
-
Con 類型資料閘道 - 資料存取
-
Con 類型原生連接器
-
應用程式 - 05 已透過多雲端遷移
-
應用程式 - 05 前往 Qlik Sense Windows 的 URL 連結
-
應用程式 - 10 已選取進行遷移檢閱
-
應用程式 - 20 需要遷移補救
-
應用程式 - 30 準備好遷移
-
應用程式 - 40 遷移完成
-
應用程式 - 99 將不會遷移
-
-
評估應用程式和資料連線並據此套用標記。
-
在 QMC 應用程式區段中，選取將會有相同標記的應用程式。
-
按一下編輯並選取適當標記。
以互動方式一次使用幾種不同的應用程式類型，並在 SaaS 遷移應用程式的工作表應用程式 SaaS 遷移狀態中檢閱遷移進度，請參閱 遷移應用程式。