如何使用 Git 整合進行倉庫開發與部署

適用於: ✅ Microsoft Fabric 中的倉庫

本文說明如何操作 Fabric Git 整合與Fabric Data Warehouse。

Important

這項功能目前處於預覽階段。

它涵蓋常見的開發工作流程,包括建立分支、更新 Git 倉庫、將變更同步回 Fabric 工作區,以及將倉庫變更提交到 Git。 這些工作流程有助於實現版本控制、協作,以及倉庫結構變更的受控部署。

Git 工作流程適合Fabric Data Warehouse

從 Workspace 設定 頁面,你可以輕鬆設定連接到你的 git 提供者。 若要設定連線,請參閱 開始使用 Git 整合。 請依照指示連接至 Git 倉庫,選擇 Azure DevOps 或 GitHub 作為 Git 提供者。

建立或結帳/切換分行

你可以管理 Git 分支,適用於你的 Fabric Data Warehouse 工作空間。 你可以建立新分支、切換分支,或分支到獨立的工作區。

從 Fabric 入口網站截圖,顯示目前分支視窗和下拉選單。

  • 查看新分行: 為這項工作建立一個新的分支。 一定要在新的運作分行工作,而不是 main。 若要將目前的工作區連線到新的分支,同時保留現有的工作區狀態,請選取 [ 簽出新的分支]。

  • 拓展到其他工作空間: 欲了解更多關於建立或附加工作區到分支的資訊,請參閱 「使用其他工作區開發」。

  • 在現有分支間切換: 當你切換分支時,工作區會同步到新分支,工作區中的所有項目都會被覆寫。 欲了解更多資訊,請參閱 「切換分支」。

當你分支工作流程時,每個倉庫會分析其與其他倉庫的相依關係,以判斷項目同步的順序,以確保分支工作流程能如預期運作。

若要深入瞭解如何查看新的分支,請參閱 解決 Git 中的衝突。

透過資料庫專案在本地開發

你可以透過使用 Git 倉庫中的倉庫資料庫專案來進行 本地開發 。 你甚至可以離線對倉庫的資料庫專案進行開發。

  1. 複製包含倉庫資料庫專案的 Git 儲存庫。
  2. 例如,在 Visual Studio Code 中以 SQL 資料庫專案擴充功能在本地開啟資料庫專案。
  3. 直接在資料庫專案中進行結構更新或腳本變更。
  4. 透過建立資料庫專案來本地驗證變更,以找出任何錯誤。
  5. 開發完成後,提交並將變更推送到遠端的 Git 分支。 推送後,更新的專案定義可透過 Git 整合工作流程同步回 Fabric 工作區。

將 Git 的變更同步回工作區

在功能或工作分支(非 main中)完成開發後,你可以將更新後的資料庫專案定義從 Git 同步回 Fabric 工作區,使倉庫反映最新核准的變更。

  1. 如果你之前建立了功能分支(例如在建立分支或結出時),先建立一個 拉取請求 來檢視並將你的變更合併到目標分支。 拉取請求簡單來說就是將一個分支的變更合併到另一個分支的請求。

  2. 在 Git 合併 pull request 後,請到 Fabric 工作區的 Source Control。

  3. 從 Git 倉庫更新或同步工作區,將最新的變更套用到倉庫。

    Fabric 入口網站截圖,顯示在原始碼控制視窗中「全部更新」按鈕,還有一個待處理的變更正在倉庫上。

  4. 如果在 Git 與 Fabric 工作空間間同步變更時發生衝突,請依照衝突解決指引解決衝突。

做修改並提交倉庫更新到 Git

如果你需要直接對 live warehouse 做變更,仍然可以用 live warehouse 定義更新原始碼控制。

Tip

若要以結構化、版本控制格式管理結構變更,請在資料庫專案中使用倉庫結構檔案。 你可以像 Develop 中描述的那樣,透過 資料庫專案來本地規劃倉庫的結構變更,而不是像本節所述的那樣,直接對現場倉庫狀態進行增量式變更。

要檢視並將你的變更提交到 Git 倉庫:

  1. 要建立或修改倉庫物件,請在 Fabric 入口網站的 SQL 查詢編輯器、SQL Server Management Studio(SSMS)、Visual Studio Code 的 MSSQL 擴充功能或其他查詢工具中執行 T-SQL 語句。 這些變更會更新 即時倉庫架構。

  2. 請進入 Fabric 工作區的來源控制。

  3. 修改後的倉庫會以待 處理變更項目 的形式出現在變更清單中。

  4. 在分支外或工作空間到Git同步的工作流程中,系統會透過 基於DacFx的增量擷取來執行結構擷取。 結構擷取僅捕捉相關的結構變更。 檢視偵測到的變更:

    • 比較倉庫項目定義與目前分支版本。
    • 驗證單一項目或多個項目的結構差異。
  5. 選擇你想投入的倉庫商品。

  6. 新增一個提交訊息,並將 變更提交到 Git 倉庫。

    Fabric 入口網站中原始碼控制選單的截圖,顯示提交對話框及可選提交訊息。

  7. 承諾後:

    • 前往 Git 倉庫。
    • 透過提交歷史和更新後的資料庫專案項目來驗證變更。

    例如,一個提交移除Address了欄位 :dbo.Customers

    這是 Fabric 入口網站截圖,顯示兩個提交的差異。