原始檔控制 （預覽版）

適用於：Microsoft Fabric 中的✅ 資料庫

本文說明 Git 整合和部署管線如何用於 Microsoft Fabric 中的倉儲。 瞭解如何設定存放庫的連線、管理倉儲，以及跨不同環境部署倉儲。 Fabric 倉儲的原始檔控制目前是一項預覽版功能。

您可以針對不同的案例使用 Git 整合和部署管線：

• 使用 Git 和 SQL 資料庫專案來管理個別資料庫物件中的累加變更、小組共同作業、提交歷程記錄。
• 使用部署管線將程式碼變更升級至不同的生產前和生產環境。

Git 整合

Microsoft Fabric 中的 Git 整合可讓開發人員將其開發程序、工具和最佳做法直接整合到 Fabric 平台中。 它可讓在 Fabric 中開發的開發人員：

• 備份其工作和設定工作版本
• 視需要還原至先前的階段
• 與其他人共同作業，或使用 Git 分支單獨工作
• 套用熟悉的原始檔控制工具的功能來管理 Fabric 項目

如需有關 Git 整合程序的詳細資訊，請參閱：

• 什麼是 Microsoft Fabric Git 整合？
• Git 整合中的基本概念
• 開始使用 Git 整合

設定與原始檔控制的連線

從 [工作區設定] 頁面，您可以輕鬆地設定與存放庫的連線，以提交和同步變更。

1. 若要設定連線，請參閱開始使用 Git 整合。 依照指示，將 Git 存放庫連線至 Azure DevOps 或 GitHub 作為 Git 提供者。
2. 連線之後，您的項目，包括倉儲，會出現在 [原始檔控制] 面板中。
3. 成功將倉儲執行個體連線到 Git 存放庫之後，您會在存放庫中看到倉儲資料夾結構。 您現在可以執行未來的作業，例如建立提取要求。

Git 中倉儲的資料庫專案

下圖是存放庫中每個倉儲項目的檔案結構範例：

當您將倉儲項目提交至 Git 存放庫時，倉儲會轉換為原始程式碼格式，做為 SQL 資料庫專案。 SQL 專案在本機代表組成單一資料庫結構描述的 SQL 物件，例如資料表、預存程序或函數。 資料庫物件的資料夾結構會依結構描述/物件類型來組織。 倉儲中的每個物件都會以 .sql 檔案表示，其中包含物件的資料定義語言 (Data Definition Language) (DDL) 定義。 SQL 資料庫專案中不包含倉儲資料表資料和 SQL 安全性功能。

共用查詢也會提交至存放庫，並繼承其另存新檔的名稱。

部署管線

您也可以使用部署管線，在不同的環境（例如開發、測試和生產環境）中部署您的倉儲程式碼。 部署管線不會公開資料庫專案。

使用下列步驟，利用部署管線完成倉儲部署。

1. 建立新的部署管線，或開啟現有的部署管線。 如需詳細資訊，請參閱開始使用部署管線。
2. 根據您的部署目標，將工作區指派到不同的階段。
3. 選取、檢視和比較項目，包括不同階段之間的倉儲，如下列範例所示。
4. 選取 [部署]，跨開發、測試和生產階段部署您的倉儲。

如需 Fabric 部署管線程式的詳細資訊，請參閱 部署管線簡介。

原始檔控制的限制

• SQL 安全性功能必須使用指令碼型方法匯出/移轉。 請考慮在 SQL Database 專案中使用部署後腳本，您可以使用 Visual Studio Code 中提供的 SQL Database 專案延伸模組來開啟項目來進行設定。

Git 整合的限制

• 目前，如果您使用 ALTER TABLE 在資料庫專案中新增條件約束或資料行，則會在部署時卸除並重新建立資料表，導致資料遺失。 考慮下列因應措施來保留資料表定義和資料：
  • 使用 CREATE TABLE 和 INSERT、CREATE TABLE AS SELECT 或 [複製資料表]，在倉儲中建立資料表的新複本。
  • 視需要，使用 ALTER TABLE 修改具有新條件約束或資料行的新資料表定義。
  • 刪除舊資料表。
  • 使用 sp_rename，將新資料表重新命名為舊資料表的名稱。
  • 以完全相同的方式修改 SQL 資料庫專案中舊資料表的定義。 原始檔控制中的倉儲和即時倉儲的 SQL 資料庫專案現在應該相符。
• 目前，請勿建立以倉儲作為輸出目的地的資料流程 Gen2。 從 Git 提交和更新將會遭到存放庫中出現的名為 DataflowsStagingWarehouse 的新項目封鎖。
• Fabric Git 整合不支援 SQL 分析端點項目。
• SQL 分析端點與倉儲之間的跨專案相依性、專案排序和同步處理差距會影響「分支到新的/現有工作區」，以及在開發和持續整合期間「切換至不同的分支」工作流程。

部署管線的限制

• 目前，如果您使用 ALTER TABLE 在資料庫專案中新增條件約束或資料行，則會在部署時卸除並重新建立資料表，導致資料遺失。
• 目前，請勿建立以倉儲作為輸出目的地的資料流程 Gen2。 部署將會遭到部署管線中出現的名為 DataflowsStagingWarehouse 的新項目封鎖。
• Fabric 部署流程不支援 SQL 分析端點項目。
• SQL 分析端點與倉儲之間的跨專案相依性、專案排序和同步處理差距會影響網狀架構部署管線工作流程。

相關內容

• 開發與部署
• 開始使用 Git 整合