筆記本原始檔控制和部署
本文說明 Git 整合和部署管線如何適用于 Microsoft Fabric 中的筆記本。 瞭解如何設定存放庫的連線、管理筆記本,以及跨不同環境進行部署。
Notebook Git 整合
網狀架構筆記本提供 Git 整合,以使用 Azure DevOps 進行原始檔控制。 透過 Git 整合,您可以備份並建立筆記本版本、視需要還原到先前的階段、使用 Git 分支單獨共同作業或單獨工作,以及完全在 Fabric 中管理筆記本內容生命週期。
設定連線
從工作區設定中,您可以輕鬆地設定存放庫的連線,以認可和同步變更。 若要設定連線,請參閱 開始使用 Git 整合 。 連線之後,您的專案,包括筆記本,會出現在 [原始檔] 控制台 中。
成功將筆記本實例認可至 Git 存放庫之後,您會在存放庫中看到 Notebook 資料夾結構。
您現在可以執行未來的作業,例如 建立提取要求 。
Git 中的筆記本標記法
下圖是存放庫中每個筆記本專案的檔案結構範例:
當您將筆記本專案認可至 Git 存放庫時,筆記本程式碼會轉換成原始程式碼格式,而不是標準 .ipynb 檔案。 例如,PySpark 筆記本會轉換成 notebook-content.py 檔案。 此方法可讓您更輕鬆地使用內建差異功能的程式碼檢閱。
在專案內容原始程式檔中,中繼資料(包括預設 Lakehouse 和附加環境)、Markdown 儲存格和程式碼資料格會保留及辨別。 當您同步回到 Fabric 工作區時,此方法支援精確的復原。
同步處理至 Git 時,不包含筆記本資料格輸出。
注意
- 目前,Notebook 資源 中的 檔案不會認可至存放庫。 即將發行的版本支援認可這些檔案。
- 當您從存放庫同步至 Fabric 工作區時,附加的環境會保存在筆記本中。 目前不支援跨工作區參考環境。 您必須手動附加至 中的新環境或工作區預設設定,才能執行筆記本。
- 當您從存放庫同步處理至 Fabric 工作區時,預設的 Lakehouse 識別碼會保存在筆記本中。 如果您認可具有預設 Lakehouse 的筆記本,則必須手動參考新建立的 Lakehouse 專案。 如需詳細資訊,請參閱 Lakehouse Git 整合 。
部署管線中的筆記本
您也可以使用部署管線,在不同的環境中部署筆記本程式碼,例如開發、測試和生產環境。 這項功能可讓您簡化開發程式、確保品質和一致性,以及減少輕量型低程式碼作業的手動錯誤。 您也可以使用部署規則來自訂筆記本部署時的行為,例如變更筆記本的預設 Lakehouse。
使用下列步驟,使用部署管線完成筆記本部署。
建立新的部署管線,或開啟現有的部署管線。 (如需詳細資訊,請參閱 開始使用部署管線 。)
根據您的部署目標,將工作區指派給不同的階段。
選取、檢視和比較專案,包括不同階段之間的筆記本,如下列範例所示。
選取 [部署 ] 以跨開發、測試和生產階段部署筆記本。
(選擇性。)您可以選取 [部署規則 ] 來建立部署程式的部署規則。 部署規則專案位於部署程式的目標階段。
使用部署規則部署時,Fabric 支援將每個 筆記本實例的預設 Lakehouse 參數化。 有三個選項可用來指定目標預設 Lakehouse:與來源 Lakehouse、 N/A 和其他 Lakehouse 相同。
您可以藉由設定此規則來達成安全的資料隔離。 筆記本的預設 Lakehouse 會取代為您在部署期間指定為目標的 Lakehouse。
注意
當您選擇在目標環境中採用其他 Lakehouse 時, Lakehouse 識別碼 必須是 。 您可以從 Lakehouse URL 連結找到 Lakehouse 的識別碼。
從 部署歷程記錄 監視部署狀態。
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應