# 驗證管道組態

您可以驗證管道組態，有兩個階段：在您的 IDE (整合開發環境) 中，以及在套用變更之前，於伺服器上進行。及早驗證有助於您在錯誤影響執行中的專案之前發現錯誤。

## 正在 IDE 中驗證

Qlik Talend Data Integration 提供所有 YAML 設定檔的 JSON 結構描述定義。當您在 IDE 中參考這些結構描述時，它可以標記錯誤並在您輸入時提供建議。

若要在 VS Code 中啟用結構描述驗證，請安裝適用於 VS Code 的 YAML 延伸 (由 Red Hat 發佈)。如果您想使用其他 IDE，您可以從 [Qlik - 開放原始碼軟體](https://github.com/qlik-oss) 中下載結構描述。

當結構描述驗證作用中時，VS Code 會即時標記語法錯誤、未知屬性，以及遺漏的必要欄位。

提示備註在上傳之前，務必在 IDE 中驗證您的 YAML 檔案。在本地捕獲錯誤比等待伺服器端驗證更快。

## 正在伺服器上驗證

伺服器端驗證除了語法之外，還會檢查設定的邏輯一致性。此驗證會在您匯入或套用變更時自動執行。您也可以在部署之前，手動使用驗證 API 執行它。

### 使用驗證專案定義 API

Validate-project-definitions API 會執行預演匯入：它會處理您的組態檔，並傳回任何驗證錯誤，而不會將變更套用至專案。在 CI/CD 管線中使用此功能來驗證組態，再觸發部署。

API 接受格式與匯入時相同的 ZIP 檔案 (JSON 或 YAML)，並傳回錯誤清單。如果沒有錯誤，設定即可部署。

資訊備註Validate-project-definitions API 每次呼叫最多傳回 50 個錯誤。如果您的組態有許多錯誤，請修正已回報的錯誤並再次執行驗證。

## 了解驗證錯誤

驗證錯誤包含錯誤類型以及找到錯誤的檔案或屬性路徑。如需詳細資訊，請參閱 [Qlik.dev](http://qlik.dev/)。

## 相關主題

* [擷取和編輯管道設定](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Retrieving-editing-pipeline-configuration.htm)

* [部署管道組態](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Deploying-pipeline-configuration.htm)

* [開始使用宣告式管線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Getting-started-declarative-pipelines.htm)