資料與重新載入
上次更新:2026/10/14QV2QS 會轉換 QlikView UI,並可使用 Auto-binary 選項將資料自動載入已轉換的應用程式。在精靈或命令列中啟用 重新載入 和 自動二進位,QV2QS 即可自動處理資料傳輸。若未使用 Auto-binary,則必須另外重新載入轉換後的應用程式以填入資料。
QV2QS 會將 QlikView UI 中繼資料 (PRJ XML) 轉換為 Qlik Sense JSON,並直接在 Qlik Cloud 租用戶上建置應用程式。轉換程序會處理工作表版面配置、視覺化物件、運算式與樣式。若未重新載入,建置步驟完成後產生的 Qlik Sense 應用程式將不包含任何資料。
若要將資料填入轉換後的應用程式,必須重新載入應用程式。有三種方法:
- 自動二進位載入 — QV2QS 會將原始 QVW 檔案上傳至 Qlik Cloud,並在建置期間使用
Binary陳述式載入資料。此方法是在轉換後立即看到含有資料且可正常運作的應用程式的最快方式。如需詳細資訊,請參閱下方的 自動二進位載入。 - 手動重新載入 — 若已在 Qlik Cloud 中建立資料連線,且可存取 QVD 檔案或資料來源,則可在調整載入指令碼後重新載入應用程式。QV2QS 會套用基本的載入指令碼路徑正規化,但連線名稱和資料來源路徑可能需要手動更新。
- 觸發重新載入 — 使用
--reload旗標來觸發重新載入,作為部署的一部分。重新載入會依原樣執行載入指令碼。只有在載入指令碼中參照的資料連線和資料來源已可在 Qlik Cloud 環境中使用時,重新載入才會成功。
兩個旗標在不同階段控制資料。--noData 旗標會在建置步驟中略過資料,因此無需等待重新載入即可測試應用程式結構。--exportQvfNoData 旗標會在建置完成後匯出不含資料的 QVF,產生較小的檔案以方便共用。這些旗標可獨立使用或搭配使用。
自動二進位載入
自動二進位載入會將原始 QVW 檔案上傳至 Qlik Cloud,使用 Binary 陳述式將資料載入轉換後的應用程式,然後移除已上傳的檔案。轉換後的應用程式會接收與 QlikView 原始版本相同的資料,無需手動設定資料連線。
若要啟用自動二進位載入,請在命令列使用 --autoBinary,或在使用者介面中啟用 Auto-binary。
啟用自動二進位載入時,QV2QS 會執行下列步驟:
- 將 QVW 檔案上傳至 Qlik Cloud 作為暫時應用程式。
- 在已轉換的應用程式載入指令碼開頭加上
Binary [<appId>];陳述式和Exit Script;陳述式。 - 建置應用程式 (若指定
--reload則重新載入),這會從上傳的 QVW 載入資料。 - 從 Qlik Cloud 刪除暫時上傳的應用程式。
- 在 Qlik Cloud 應用程式中還原原始載入指令碼,並移除 Binary 和 Exit Script 陳述式。
清除後,Qlik Cloud 應用程式包含已載入的資料,但載入指令碼不再參照暫存應用程式。
上傳步驟受限於 Qlik Cloud 檔案大小限制。大型 QVW 檔案可能會超過租用戶訂閱層級的上傳限制。如果上傳失敗,請將應用程式部署至已啟用大型應用程式支援的空間,或使用 --binaryAppId 引數參照已在 Qlik Cloud 中的現有應用程式。如需租用戶資源限制的詳細資訊,請參閱 Qlik Cloud 資源限制。
失敗時清理
如果在上傳 QVW 檔案後建置或重新載入步驟失敗,QV2QS 會在結束前自動嘗試進行清理。清理工作包括從 Qlik Cloud 刪除暫時上傳的應用程式,並在本機與雲端應用程式中還原原始載入指令碼。
如果清理本身失敗 (例如因網路中斷),暫時應用程式可能會保留在 Qlik Cloud 租用戶中。孤立的暫存應用程式命名為 QV2QS_Binary_YYYYMMDD_HHMMSS (例如 QV2QS_Binary_20260219_143025)。檢查目標空間中符合此模式的應用程式,並手動將其刪除。建置目錄中的本機 script.qvs 檔案也可能包含暫時的 Binary 陳述式。重新執行轉換以重新產生。
自動二進位載入需要 --reload 旗標和 --qvw 路徑。若缺少任一要求,QV2QS 會拒絕該指令並以代碼 1 結束。
本機電腦上的原始 QVW 檔案絕不會遭到修改或刪除。在資料載入完成後,僅會移除 Qlik Cloud 中的暫存複本。
使用區段存取的應用程式不支援自動二進位載入。Qlik Cloud 重新載入引擎無法針對來源 QVW 檔案中的區段存取資料表進行驗證。當 QV2QS 在來源應用程式中偵測到區段存取時,會略過二進位上傳與重新載入步驟,並記錄警告。應用程式在沒有資料的情況下部署。若要載入資料,請建立 Qlik Cloud 資料連線並手動更新載入指令碼,或從來源 QVW 的複本中移除區段存取,並使用 --autoBinary 重新執行。
當 --preserveTargetAppScript 與 --reload 結合時,重新載入會執行目標應用程式中的現有載入指令碼,而非轉換後的指令碼。當目標應用程式已具有正常運作的 Qlik Cloud 資料連線,且僅需更新 UI 圖層時,這非常實用。如需詳細資訊,請參閱 重複使用現有應用程式。