驗證管道組態
您可以驗證管道組態,有兩個階段:在您的 IDE (整合開發環境) 中,以及在套用變更之前,於伺服器上進行。及早驗證有助於您在錯誤影響執行中的專案之前發現錯誤。
正在 IDE 中驗證
Qlik Talend Data Integration 提供所有 YAML 設定檔的 JSON 結構描述定義。當您在 IDE 中參考這些結構描述時,它可以標記錯誤並在您輸入時提供建議。
若要在 VS Code 中啟用結構描述驗證,請安裝適用於 VS Code 的 YAML 延伸 (由 Red Hat 發佈)。如果您想使用其他 IDE,您可以從 Qlik - 開放原始碼軟體 中下載結構描述。
當結構描述驗證作用中時,VS Code 會即時標記語法錯誤、未知屬性,以及遺漏的必要欄位。
提示備註在上傳之前,務必在 IDE 中驗證您的 YAML 檔案。在本地捕獲錯誤比等待伺服器端驗證更快。
正在伺服器上驗證
伺服器端驗證除了語法之外,還會檢查設定的邏輯一致性。此驗證會在您匯入或套用變更時自動執行。您也可以在部署之前,手動使用驗證 API 執行它。
使用驗證專案定義 API
Validate-project-definitions API 會執行預演匯入:它會處理您的組態檔,並傳回任何驗證錯誤,而不會將變更套用至專案。在 CI/CD 管線中使用此功能來驗證組態,再觸發部署。
API 接受格式與匯入時相同的 ZIP 檔案 (JSON 或 YAML),並傳回錯誤清單。如果沒有錯誤,設定即可部署。
資訊備註Validate-project-definitions API 每次呼叫最多傳回 50 個錯誤。如果您的組態有許多錯誤,請修正已回報的錯誤並再次執行驗證。
了解驗證錯誤
驗證錯誤包含錯誤類型以及找到錯誤的檔案或屬性路徑。如需詳細資訊,請參閱 Qlik.dev。