平行執行
上次更新:2026/10/14QV2QS 使用可設定的處理程序集區同時轉換多個專案。
Worker 設定
依預設,QV2QS 會根據機器上的邏輯 CPU 核心數量自動偵測最佳 worker 數量。預設設定 (--batchWorkers 0) 使用的 worker 數量比核心數少一個,保留一個核心供協調器處理程序與作業系統使用。
若要以明確的計數覆寫,請傳入 --batchWorkers N:
QV2QS.exe --batchDir "C:\Projects" --outputDir C:\Output --batchWorkers 4 --unbuildOnly
如果指定的 worker 數量超過可用 CPU 核心數,QV2QS 會顯示警告。超過核心數量的每個額外 worker 都會增加大約 80 MB 的記憶體負擔,但對實際執行時間的改善微乎其微。
本地轉換階段使用處理程序集區。每個 worker 都在獨立的處理程序中執行,為構成轉換作業的 XML 解析、物件圖走訪與 JSON 產生實現真正的 CPU 平行處理。若其中一個專案失敗,其餘專案仍會繼續。每個工作處理程序都會將個別的記錄檔寫入專案的 logs/ 子資料夾。
雲端部署使用具有相同工作者數量的執行緒集區。在所有本機轉換完成後,QV2QS 會以平行方式將轉換後的應用程式部署至 Qlik Cloud。在平行雲端部署期間,主控台輸出會進行簡化——將動畫旋轉指示器替換為靜態進度行,以避免輸出內容錯亂。
處理時發生錯誤
批次模式在發生失敗時仍會繼續執行。若在轉換過程中某個專案失敗,QV2QS 會記錄該錯誤並繼續處理其餘專案。失敗的專案會出現在批次摘要中,並附有錯誤說明。當所有專案皆成功時,批次結束代碼為 0;當有任何專案失敗時則為 1。
錯誤隔離也適用於報表產生。如果專案轉換成功,但 Excel 報表產生失敗,該專案仍會視為成功。報表錯誤會分開記錄。
雲端部署失敗也是以相同方式隔離。如果其中一個專案部署失敗,其餘專案仍會繼續部署。