宣告式管線
宣告式管道讓您能夠完全透過程式碼，使用 YAML 檔案來定義、設定及部署 Qlik Talend Data Integration 管道專案。您可以在任何整合式開發環境或版本控制系統中編輯檔案，然後部署它們以建立或更新專案。
何時使用宣告式管線
使用宣告式管線以提升：
-
共同作業
-
持續整合／持續交付
-
可重複部署到不同環境
-
API 驅動的自動化
以下是一些典型使用案例：
-
在程式碼中定義管線，用於持續整合與開發自動化。
-
部署相同的管道組態跨多個環境 (開發、驗證、生產)。
-
重複使用及共用管道定義，跨專案或團隊。
-
Automate 大規模專案建立，無需手動操作。
運作方式
管道專案以一組 YAML 檔案表示，這些檔案組織在反映專案任務和資料集的資料夾結構中。YAML 檔案更容易閱讀、查看差異、審查、重複使用，並建立自動化。
您可以匯出現有專案為 YAML，編輯檔案，並將其匯入以套用您的變更。如果專案已連接到版本控制，YAML 檔案會直接在您的 GitHub 存放庫中提供。
如需更多關於 YAML 檔案結構的資訊，請參閱 擷取和編輯管道設定。
典型工作流程
在您開始之前，您必須設定您的開發環境和版本控制。如需詳細資訊，請參閱入門宣告式管線。
一個典型的宣告式管道工作流程看起來像這樣：
-
取得管道設定
您可以將現有專案匯出為 YAML、從版本控制中擷取，或從範本開始。
-
編輯管道組態
修改您的開發環境中的 YAML 檔案。您可以新增任務、變更來源選取項目並更新設定。
-
驗證管道設定
在部署管道之前，請檢查檔案是否存在語法和語義錯誤。
-
部署管道設定
將檔案匯入以在 Qlik Talend Data Integration 中建立或更新專案。
您也可以將檔案提交至版本控制，並從版本控制在專案中執行套用 Qlik Talend Data Integration。
與版本控制的關係
當專案連接到版本控制時，YAML 檔案會直接儲存在您的 GitHub 存放庫。您可以編輯 GitHub 或任何 IDE 中的 YAML 檔案，然後將變更套用回專案。
如需將專案連線至版本控制的資訊，請參閱 使用版本控制管理您的管道專案。
使用 AI 助理來設定管道
使用 AI 助理 (例如 GitHub Copilot 或 Anthropic Claude) 簡化 YAML 設定檔的建立與編輯。為確保準確度並符合專案標準，請追蹤下列最佳做法：
-
選擇高效能模型 — 使用高階、大上下文模型 (例如，Anthropic Claude Sonnet 4.6 或更高版本)，而非標準或「自動」模型，以進行複雜的 YAML 生成和架構遵循。進階模型能正確解讀複雜的管道結構描述，並產生更精確的組態。
-
設定專案專屬的 AI 指令 — 透過向模型提供專案背景資訊，提升 AI 生成組態的品質。在您的 VS Code 工作區根目錄中建立一個說明檔案。選擇下列項目之一：
-
CLAUDE.md (適用於 Anthropic Claude Code 延伸)
-
.github/copilot-instructions.md (適用於 GitHub Copilot)
您的指令檔案內容應如下所示：
This is a Qlik Talend Cloud Pipeline (QTCP) project. Before any project advice or YAML edits, I MUST read the source of truth first: https://raw.githubusercontent.com/qlik-oss/schemas/refs/heads/main/qtcp/ai-instructions.md -