Microsoft Fabric 部署計畫是一個工作區項目，能為部署操作添加明確的項目順序與自動化動作。 使用計畫以特定順序部署物品。 你也可以使用它，在某個項目部署之前或之後執行筆記本、資料管線或其他支援的項目。
部署計畫可搭配以下部署工具運作：
- Git 整合功能
- 部署管線
- 支援的 REST API
本文中， 部署工具 指的是這些支援的工具中的任何一項。 你不會單獨執行一個計畫。 你在使用部署工具啟動作業時附加它。
Important
這項功能目前處於預覽階段。
何時使用部署計畫
在以下情況下使用部署計畫：
| Scenario | 計畫如何幫助你 |
|---|---|
| 這些項目必須依照 Fabric 譜系無法呈現的順序進行部署。 | 該計畫明確定義了部署群組間的相依關係。 |
| 工作必須在物品部署前或部署後執行。 | 計畫將支援項目分為部署前或部署後的動作。 |
| 操作需要明確的順序與 Fabric 項目依賴關係。 | Fabric 在決定商品順序時會結合計畫與血統。 |
當部署工具的標準順序足夠且不需要任何行動時，你就不需要部署計畫。
部署計畫組成部分
部署計畫包含以下組成部分：
| 組件 | Purpose |
|---|---|
| 部署組 | 一個部署項目及其部署前或部署後的操作。 |
| Step | 將該項目部署到部署群組中。 |
| Action | 支援的項目會在群組項目部署之前或之後執行。 |
關於支援的動作類型與行動行為，請參見 部署計畫動作。
部署計畫的運作方式
每個部署操作結合三個輸入：
- 精選項目：用於操作的項目。
- 部署計畫：明確的順序與相關行動。
- Fabric 血統：Fabric 偵測到的項目間相依關係。
確定部署範圍
部署工具會判定來源、目標及作業中的項目。 附上計畫並不能取代這個選擇。 未在部署群組中的選取項目仍會依照工具的標準行為部署。
附加計畫不會自動選取其參照的項目。 在選擇性部署頁面上，選擇你想部署的項目，並確保計畫動作所需的項目在執行時已在目標工作區中可用。
部署計畫控制項目部署與動作。 它不會部署工作區層級的設定，例如工作區身份、連線、閘道綁定或 Spark 設定。 在動作依賴這些設定之前，先設定目標工作區。
解決部署順序
Fabric 結合了部署群組間的明確相依性，並從血統中偵測到的相依性。 計畫可以新增 lineage 不代表的順序，但不會移除 Fabric 偵測到的相依關係。
若想了解所選項目、計畫相依、血緣及執行時動作如何協同運作的詳細情境，請參閱 部署計畫範例。
執行部署群組與動作
對於每個部署群組，Fabric 執行部署前的動作，部署該群組的項目，然後執行部署後的動作。 群組與行動之間的依賴關係決定了它們的順序。 項目在計畫檔案中的位置並不定義其順序。
附上計畫是可選的。 沒有計畫時，所選部署工具會使用其標準行為。
附上部署計畫
你可以在使用支援的 Git 整合操作時附加計畫，透過部署管線部署內容，或呼叫支援的 REST API。 附件僅適用於該操作。 如需了解支援的介面和方案選取行為，請參閱 附加部署方案。
建立並發布部署計畫
在部署計畫畫布上建立計畫，新增部署群組、定義順序並設定動作。 有關說明，請參閱 「建立部署計畫」。
部署計畫是一個工作空間項目。 當工作區連接到 Git 時，將計畫與它參考的項目一起提交，讓計畫能在你的 CI/CD 流程中順利進行。
如果操作失敗
當項目或動作失敗時，操作就會停止，且不會回滾已完成的工作。 如需了解失敗行為和解決步驟，請參閱 「疑難排解部署計畫」。
考慮事項與限制條件
一般部署計畫的限制
- 你不能用一個計畫在一次執行中部署到多個工作區。
- 你只能將一個部署計畫附加到一個部署作業。
附加方案的限制
- 計畫附件僅適用於目前的營運。 你無法將計畫設定為未來部署的預設，也無法排程該計畫本身。 如果部署工具排定某項作業，則該作業每次執行時都必須附加該計畫。
- 你無法將計畫附加至單一項目匯入作業。
- 函
fabric-cicd式庫不支援部署計畫。
部署期間的限制
- 你無法同時部署獨立的部署群組。
- 失敗的部署不會被回滾。 已部署的項目會留在目標工作區，後續的項目則不會部署。
計畫行動的限制
- 只有支援的項目與工作類型組合，才能作為部署前或部署後的動作執行。 請參考 「你可以作為動作執行的物品類型」。
- 你不能在同一個計畫中的一個以上動作中使用同一個 Dataflow Gen2 項目。 它的刷新工作一次只能執行一次，所以當你新增第二次事件時，畫布會警告你，而第二次事件會在部署過程中被阻擋。
- 使用者資料函式動作不能回傳超過 512 KB 的資料。 較大的輸出會被截斷。 行動仍然成功。
- 你無法讓某個動作等待其輸出提供給的服務趕上。 動作在動作結束時完成，因此下一個動作可以在產生的資料可查詢前開始。
- 當部署計畫指定 變數函式庫的主動值集時，該值集會在使用該計畫時套用到目標工作區。 在部署期間，您不能覆寫此選取項目。 若要使用不同的值集，請編輯部署計畫。
計畫撰寫的限制
- 你不能在部署群組中新增超過一項物品。
- 畫布僅支援自動版面配置。
部署計畫大小限制
任何超過上述任一限制的方案在儲存時都會遭到拒絕。 這些限制會在儲存計畫時強制執行，因此會應用於畫布、REST API、從 Git 拉取資料，以及外部工具。
| Element | Limit |
|---|---|
| 方案大小 | 1 MB |
| 群組名稱或階級名稱的長度 | 60 個字元 |
| 計畫中的群體 | 1,000 |
| 群組相依性 | 1,000 |
| 群組中的預部署動作 | 20 |
| 群組中的部署後動作 | 20 |
| 對動作的依賴 | 20 |
| 動作參數 | 20 |