适用于:✅ Microsoft Fabric 中的“仓库”模块
本文解释了利用Fabric内置Git集成开发和部署Fabric Data Warehouse的优势。
Important
此功能目前为预览版。
通过在 Fabric 中使用 Git 集成,团队可以将现代源代码管理实践应用于仓库开发。 开发者可以在分支中隔离更改,通过提交跟踪模式演进,通过拉取请求进行协作,并在 Git 仓库与 Fabric 工作区之间同步更新内容。
典型方案包括:
- 在分支和工作区中安全地进行架构更改开发
- Git 中的仓库对象版本管理
- 跨多个分支和工作空间的协作
- 促进分支间的验证变更
- 使工作区项(仓库等)与 Git 的事实来源保持一致
为了在仓库开发生命周期中保持一致性、可追溯性和可靠性,你需要了解这些工作流程。
当你把Fabric Data Warehouse工作区连接到Git时,你会把仓库定义提交为数据库项目。 该项目成为源代码控制中仓库模式的权威表示,并作为持续开发活动的基础。 在源码控制资源管理器中,模式以独立 .sql 文件的形式出现。
通过使用 Fabric Git 集成和Fabric Data Warehouse,你可以:
- 用Git集成开发Fabric Data Warehouse。
- 使用部署管道部署Fabric Data Warehouse。
- 通过使用 Fabric 门户、Git、您自己的 IDE 或本地开发环境、Fabric 部署流水线,或外部持续集成/持续部署(CI/CD)系统(包括 Azure DevOps Services 或 GitHub 中的流水线)进行部署并持续部署。
Comparison
在此同步过程中,Fabric 采用基于 DacFx 的增量模式部署来应用变更。 这种方法仅将相关的模式差异应用于仓库,而非更新整个仓库定义。
增量提取有助于减少源代码控制中的不必要流失,保持分支间结构差异的清晰,并支持高效的分支和合并工作流程。 由于提取过程具备模式感知,它也实现了工作区状态与 Git 跟踪定义之间的可靠比较和验证。
标准化仓库模式的提取和存储方式,有助于提升开发环境间的一致性。 模式定义在各分支间保持稳定,差异更准确反映开发的有意变更,源码控制成为部署、协作和生命周期管理的可靠基线。
在 Git 集成工作流程中,文件 XMLA.json 本身被排除在外。 Fabric 将该文件排除在提交和更新之外,这样默认的语义model元数据就不会无意中存储在 Git 里。 从 Git 同步工作区时,会忽略 XMLA.json,这有助于避免在切换分支或从 Git 更新时出现冲突、意外覆盖和干扰。
源代码管理限制
SQL 安全功能如权限要求基于脚本的方式进行导出和迁移。 请考虑在 SQL 数据库项目中使用部署后脚本。 您可以使用 Visual Studio Code 中的 SQL 数据库项目扩展,在项目中配置部署后脚本。
目前开发工作流不支持仓库与SQL分析端点之间的跨项依赖。 因此,依赖这些项目协调变化的场景可能无法可靠地运作。
通过 Git 直接添加到数据库项目中的预部署或部署后脚本和额外的发布配置不会作为开发工作流的一部分被保留。 你可能需要在 Fabric 工作区之外单独管理这些配置。
目前不支持仓库层级的选择性提交。 更改是在仓库物品层面提交的,而不是在更细粒度的对象层面。
目前还没有对SQL分析端点的版本控制支持。 当解决方案跨越仓库和SQL分析端点时,这一限制可能会限制端到端的生命周期管理。
Git 集成限制
- 当两个或多个仓库物品相互引用时,它们形成循环依赖关系。 系统在分支或 Git 到工作空间同步操作时检测到这种循环引用,导致这些操作失败。 避免项目之间的循环依赖。
- 目前,不要创建具有仓库输出目标的数据流 Gen2。 名为
DataflowsStagingWarehouse的新项显示在存储库中,并阻止从 Git 提交和更新。 - SQL 分析终结点和仓库之间的跨项依赖关系、项排序和同步差距会影响“分支到新的或现有的工作区”,并在开发和持续集成期间“切换到其他分支”工作流。
- 如果一个对象通过使用三部分命名 (
database.schema.object) 引用同一仓库中的另一个对象,则从 Git 提交或更新可能会失败。 欲了解更多信息及变通方法,请参见 “使用三部分名称引用仓库自身对象”。 - 如果你更改了定义了
IDENTITY的列,提交更改或从 Git 更新可能会失败,直到为该表启用IDENTITY_INSERT。 - 如果仓库中包含一个将
Microsoft.Build.SqlSDK 版本固定为较旧版本的.sqlproj文件,则提交更改或从 Git 更新时可能会失败,因为旧版 SDK 无法识别较新的仓库语法,例如IDENTITY列和CLUSTER BY。 欲了解更多信息及解决方法,请参见 Git仓库中的过时.sqlproj。 - 如果某个对象引用了另一个仓库中的两个或多个表,但没有为每一列都加上别名限定,则从 Git 提交或更新时可能会失败。 更多信息和变通方法,请参见 指向另一个仓库中两个或多个表的对象中的未限定列。
- 如果你的脚本引用了另一个仓库同一模式中的两个或多个不同对象,并且模式名称大写不一致,提交或更新Git可能会失败。 更多信息和变通方法,请参见 模式名称的不一致大写。
- 在提交或从 Git 更新时,即使没有真正的歧义,也可能出现候选列表中包含
::分隔符的歧义列错误。 欲了解更多信息和解决方法,请参见 带有重复候选对象的歧义列错误。
不支持的方案
当不同工作区中的仓库具有不同的排序规则时,以下 CI/CD 工作流未正式支持。 即使这些操作可能会成功且没有错误,但它们可能会导致元数据错误。
在所有这些情况下,如果发生排序规则不匹配,请使用Fabric工具箱中的 Python 脚本 scripts/dw-collation-error-update-tmsl/pbi_interactive.py GitHub 存储库更新数据集(TMSL)排序规则以匹配仓库排序规则。
| 情景 | 说明 | 风险 |
|---|---|---|
| 部署管道 | 不支持通过管道阶段(例如,开发→测试→ Prod)提升仓库内容,其中目标仓库的排序规则与源不同。 | 部署可能会成功,但数据集排序规则不会更新,以匹配目标仓库排序规则。 |
| 扩展到新的或现有的工作区 | 不支持使用 Git 集成从现有工作区分支到仓库具有不同排序规则的新工作区或现有工作区。 | 仓库内容已同步,但整理顺序元数据尚未协调。 |
| 在工作区上切换分支 | 不支持切换到与具有不同排序规则的仓库相关联的分支,该仓库处于与 Git 连接的工作区中。 | 同步的内容可能会延续与当前仓库不匹配的排序规则的假设。 |
| 通过分支合并工作区之间的更改 | 不支持在仓库排序规则不同的情况下跨工作区合并 Git 分支。 | 合并可能在 Git 级别成功,但生成的数据集排序规则并不反映目标仓库的排序规则。 |