驗證
上次更新:2026/10/14QV2QS 透過 qlik-cli 上下文向 Qlik Cloud 進行驗證。內容是一種具名驗證組態,儲存著一個 Qlik Cloud 租用戶 URL 和一個 API 金鑰。QV2QS 隨附將 qlik-cli 捆綁到可執行檔中。QV2QS 將內容儲存在其獨立的 位置 (%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml),與預設的 qlik-cli 配置分開。現有的 qlik-cli 安裝不受影響。
驗證方法
身份驗證有三種設定方式:
- 互動式設定 — 執行
QV2QS.exe --setupQlikAuth。QV2QS 會列出任何現有的內容,提示輸入內容名稱 (或選取),然後提示輸入租用戶 URL 和 API 金鑰。API 金鑰輸入已隱藏,基於安全性考量。QV2QS 建立或更新內容並驗證連線。 - CLI 引數 — 透過命令列傳遞
--qlikTenantUrl和--qlikApiKey。QV2QS 內嵌進行驗證,而不會建立或修改環境定義檔。憑證會直接注入到每個 API 呼叫中,且不會寫入磁碟。這是 CI/CD 管線和一次性轉換最簡單的方法。或者,單獨傳遞--qlikApiKey以更新作用中 qlik-cli 內容中的金鑰。 - 使用者介面 — 在 Qlik Cloud 驗證 步驟中輸入租用戶 URL 和 API 金鑰。精靈會在繼續之前驗證連線。
驗證引數包括--qlikContext、--qlikTenantUrl、--qlikApiKey,以及--setupQlikAuth。如需完整清單,請參閱引數參考。
更新已過期的 API 金鑰
Qlik Cloud API 金鑰會在租用戶管理員設定的期間後到期。若要取代已過期的金鑰,請執行下列其中一項操作:
- 重新執行
QV2QS.exe --setupQlikAuth並在系統提示時輸入新的 API 金鑰。 - 傳遞
--qlikApiKey <NEW_KEY>於任何轉換指令上(不含--qlikTenantUrl)。QV2QS 會自動更新儲存的上下文。如果同時提供--qlikTenantUrl和--qlikApiKey,則使用內嵌驗證,且不會更新任何內容。 - 將
QV2QS_QLIK_API_KEY環境變數設定為新金鑰。