Share via


筆記本原始檔控制和部署

本文說明 Git 整合和部署管線如何適用于 Microsoft Fabric 中的筆記本。 瞭解如何設定存放庫的連線、管理筆記本,以及跨不同環境進行部署。

Notebook Git 整合

網狀架構筆記本提供 Git 整合,以使用 Azure DevOps 進行原始檔控制。 透過 Git 整合,您可以備份並建立筆記本版本、視需要還原到先前的階段、使用 Git 分支單獨共同作業或單獨工作,以及完全在 Fabric 中管理筆記本內容生命週期。

重要

這項功能處於預覽狀態

設定連線

從工作區設定中,您可以輕鬆地設定存放庫的連線,以認可和同步變更。 若要設定連線,請參閱 開始使用 Git 整合 。 連線之後,您的專案,包括筆記本,會出現在 [原始檔] 控制台 中。

Screenshot of workspace source control panel.

成功將筆記本實例認可至 Git 存放庫之後,您會在存放庫中看到 Notebook 資料夾結構。

您現在可以執行未來的作業,例如 建立提取要求

Git 中的筆記本標記法

下圖是存放庫中每個筆記本專案的檔案結構範例:

Screenshot of notebook Git repo file structure.

當您將筆記本專案認可至 Git 存放庫時,筆記本程式碼會轉換成原始程式碼格式,而不是標準 .ipynb 檔案。 例如,PySpark 筆記本會轉換成 notebook-content.py 檔案。 此方法可讓您更輕鬆地使用內建差異功能的程式碼檢閱。

在專案內容原始程式檔中,中繼資料(包括預設 Lakehouse 和附加環境)、Markdown 儲存格和程式碼資料格會保留及辨別。 當您同步回到 Fabric 工作區時,此方法支援精確的復原。

同步處理至 Git 時,不包含筆記本資料格輸出。

Screenshot of notebook Git repo content format.

注意

  • 目前,Notebook 資源 中的 檔案不會認可至存放庫。 即將發行的版本支援認可這些檔案。
  • 當您從存放庫同步至 Fabric 工作區時,附加的環境會保存在筆記本中。 目前不支援跨工作區參考環境。 您必須手動附加至 中的新環境或工作區預設設定,才能執行筆記本。
  • 當您從存放庫同步處理至 Fabric 工作區時,預設的 Lakehouse 識別碼會保存在筆記本中。 如果您認可具有預設 Lakehouse 的筆記本,則必須手動參考新建立的 Lakehouse 專案。 如需詳細資訊,請參閱 Lakehouse Git 整合

部署管線中的筆記本

您也可以使用部署管線,在不同的環境中部署筆記本程式碼,例如開發、測試和生產環境。 這項功能可讓您簡化開發程式、確保品質和一致性,以及減少輕量型低程式碼作業的手動錯誤。 您也可以使用部署規則來自訂筆記本部署時的行為,例如變更筆記本的預設 Lakehouse。

重要

這項功能處於預覽狀態

使用下列步驟,使用部署管線完成筆記本部署。

  1. 建立新的部署管線,或開啟現有的部署管線。 (如需詳細資訊,請參閱 開始使用部署管線 。)

  2. 根據您的部署目標,將工作區指派給不同的階段。

  3. 選取、檢視和比較專案,包括不同階段之間的筆記本,如下列範例所示。

    Screenshot of notebook in deployment pipeline.

  4. 選取 [部署 ] 以跨開發、測試和生產階段部署筆記本。

  5. (選擇性。)您可以選取 [部署規則 ] 來建立部署程式的部署規則。 部署規則專案位於部署程式的目標階段。

    Screenshot of deployment rules entry.

    使用部署規則部署時,Fabric 支援將每個 筆記本實例的預設 Lakehouse 參數化。 有三個選項可用來指定目標預設 Lakehouse:與來源 Lakehouse、 N/A 和其他 Lakehouse 相同。

    Screenshot of set default lakehouse.

    您可以藉由設定此規則來達成安全的資料隔離。 筆記本的預設 Lakehouse 會取代為您在部署期間指定為目標的 Lakehouse。

    注意

    當您選擇在目標環境中採用其他 Lakehouse 時, Lakehouse 識別碼 必須是 。 您可以從 Lakehouse URL 連結找到 Lakehouse 的識別碼。

  6. 部署歷程記錄 監視部署狀態。