本文說明 Git 整合和部署管線如何適用於 Microsoft Fabric 中的使用者資料函式。 Fabric 使用者資料函式提供 Git 整合,以便與 Azure DevOps 存放庫進行原始檔控制。 透過 Git 整合,您可以版本控制使用者資料函式項目、使用 Git 分支共同作業,以及完全在 Fabric 內管理使用者資料函式內容生命週期。
在 Git 整合的基本概念中,了解 Git 與 Microsoft Fabric 工作區整合的流程。
設定連線
從工作區設定中,您可以輕鬆地設定與版本庫的連線,以提交和同步變更。 若要設定連線,請參閱 開始使用 Git 整合。 連線之後,您的項目 (包括使用者資料函式) 便會出現在 [原始檔控制] 窗格中。
成功將使用者資料函式項目認可至 Git 存放庫之後,您會在存放庫中看到使用者資料函式資料夾。 您現在可以執行未來的作業,例如 建立提取要求。
Git 中的使用者資料函式表示法
下圖顯示存放庫中每個使用者資料函式項目的檔案結構範例:
資料夾結構包含下列元素:
.platform:
.platform檔案包含下列屬性:- version:系統檔案的版本號碼。 此號碼用來啟用回溯相容性。 項目的版本號碼可能不同。
- logicalId:自動產生的跨工作區識別碼,表示項目及其原始檔控制表示法。
-
type:
UserDataFunction是定義使用者資料函式項目的類型。 - displayName:代表項目的名稱。 重新命名使用者資料功能項目時,會更新此顯示名稱。
definitions.json:此檔案會共用所有使用者資料函式項目定義,例如連線、程式庫等,作為使用者資料函式項目屬性的表示法。
function-app.py:此檔案是函式程式碼。 您對使用者資料函式項目所做的任何程式碼變更都會透過這個檔案同步至存放庫。 您可以執行各種 Git 作業,來管理程式碼開發週期。
resources:資料夾包含具有此項目內所有中繼資料的 functions.json 檔案,例如連線、程式庫和函式。 請勿手動更新此檔案。
functions.json可讓 Fabric 在工作區中建立或重新建立使用者資料函式項目。
部署管線中的使用者資料函式
您也可以使用部署管線,在不同的環境 (例如開發、測試和生產環境) 中部署使用者資料函式程式碼。 這項功能可讓您簡化開發流程、確保品質和一致性,以及減少輕量型低程式碼作業的手動錯誤。
備註
所有連線和程式庫都會新增至在其他環境中建立的新使用者數據函數項目。
使用下列步驟,以部署流程來完成筆記本的部署。
建立新的部署管線,或開啟現有的部署管線。 如需詳細資訊,請參閱開始使用部署管線。
根據您的部署目標,將工作區指派給不同的階段。
選取、檢視和比較項目,包括不同階段之間的使用者資料函式項目。
選取 [部署],將使用者資料函式項目部署至測試環境。 您可以新增備註,以提供此部署變更的詳細資料。 同樣地,您可以跨開發、測試和生產階段推送變更。
從 部署歷程記錄監視部署狀態。