什么是 Microsoft Fabric Git 集成？

本文介绍了开发人员如何将 Git 版本控制与 Microsoft Fabric 应用程序生命周期管理 (ALM) 工具集成。

Microsoft Fabric 中的 Git 集成使开发人员能够将其开发流程、工具和最佳做法直接集成到 Fabric 平台中。 它允许在 Fabric 中进行开发的开发人员：

• 备份工作并对其进行版本控制
• 根据需要还原到以前的阶段
• 与其他人协作或使用 Git 分支单独工作
• 使用熟悉的源代码管理工具功能来管理 Fabric 项目。

与源代码管理的集成在工作区级别上。 开发人员可以在单个进程中对在工作区中开发的项进行版本控制，并完全了解他们所有的项。 工作区结构（包括 子文件夹）将保留在 Git 存储库中。

请参阅 支持项的列表。

• 了解基本 Git 和 版本控制 概念。

• 详细了解 Git 集成过程。

• 了解管理 Git 分支的最佳方法。

隐私信息

在启用 Git 集成之前，请务必查看以下隐私声明：

• Microsoft隐私声明
• Azure DevOps Services 数据保护概述
• GitHub 数据保护协议

支持的 Git 提供程序

支持以下 Git 提供程序：

• Azure DevOps 与 Fabric 租户具有相同的租户
• GitHub （仅限云版本）
• GitHub Enterprise （仅限云版本）

支持的项目

以下项当前支持 Git 集成：

• 数据工程项：

  • 环境
  • GraphQL（预览版）
  • Lakehouse（预览版）
  • 笔记本
  • Spark 作业定义（预览版）
  • 用户数据函数（预览版）

• 数据工厂项：

  • 复制作业（预览版）
  • 数据流第 2 代
  • 数据管道
  • 镜像数据库
  • 装载 ADF（预览版）
  • 变量库（预览版）

• 实时智能项：

  • 激活器（预览版）
  • Eventhouse
  • EventStream
  • KQL 数据库
  • KQL 查询集
  • 实时仪表板

• 数据仓库项：

  • 仓库（预览版）

• Power BI 项目

  • 指标集（预览版）
  • 组织应用（预览版）
  • 分页报表（预览版）
  • 报表 （除了连接到 Azure Analysis Services 中托管的语义模型、 SQL Server Analysis Services 或 Power BI Desktop 导出的依赖于 MyWorkspace 中托管语义模型的报表） （预览版）
  • 语义模型 （推送数据集除外，与 Analysis Services 实时连接，模型 v1） （预览版）

• 数据库项：

  • SQL 数据库（预览版）

• 行业解决方案：

  • 医疗保健（预览版）
  • HealthCare Cohort（预览版）

如果工作区或 Git 目录包含不受支持的项，则仍可以连接，但将忽略不受支持的项。 系统不会保存或同步这些内容，但也不会删除。 它们会显示在源代码管理面板中，但你无法提交或更新它们。

注意事项和限制

常规 Git 集成限制

• Fabric 中的 身份验证方法 必须至少与 Git 的身份验证方法一样强。 例如，如果 Git 需要多重身份验证，则 Fabric 也需要多重身份验证。
• 目前不支持连接到 Analysis Services 的 Power BI 数据集。
• 如果在一个项目中使用工作区标识并将其提交到 Git，则只能在连接到同一标识的工作区中更新它（返回到构造工作区）。 请小心，因为这也会影响分支操作等功能。
• 不支持子模块。
• 目前不支持主权云功能。

GitHub Enterprise 限制

不支持某些 GitHub Enterprise 版本和设置。 例如：

• 具有数据驻留的 GitHub Enterprise Cloud （ghe.com）
• 不支持具有自定义域的 GitHub Enterprise Server，即使该实例可公开访问
• 托管在专用网络上的 Github Enterprise Server
• IP 允许列表

工作区限制

• 只有工作区管理员可以管理与 Git 存储库 的连接，例如连接、断开连接或添加分支。
  连接后，具有 权限 的任何人都可以在工作区中工作。
• 安装了模板应用的工作区无法连接到 Git。
• MyWorkspace 无法连接到 Git 提供程序。

分支和文件夹限制

• 分支名称的最大长度为 244 个字符。
• 文件名的完整路径的最大长度为 250 个字符。 过长的名称会失败。
• 文件大小上限为 25 MB。
• 文件夹结构保留的深度最多为 10 个级别。
• 不建议在使用 Git 集成后，将已部署的报表/数据集从服务中下载为 .pbix 文件，因为结果可能不可靠。 建议使用 PowerBI Desktop 将报表/数据集下载为 .pbix。
• 如果项的显示名称具有以下任一特征，则 Git 文件夹将重命名为逻辑 ID (Guid) 和类型：
  • 超过 256 个字符
  • 以 . 或空格结尾
  • 包含目录名称限制中所述的任何禁止字符
• 将包含文件夹的工作区连接到 Git 时，如果 文件夹结构 不同，则需要将更改提交到 Git 存储库。

目录名称限制

• 连接到 Git 存储库的目录的名称具有以下命名限制：

  • 目录名称不能以空格或选项卡开头或结尾。
  • 目录名称不能包含以下任何字符：“/：<>\*|

• 项目文件夹（包含项目文件的文件夹）不能包含以下任何字符：“：<>\*？|。 如果将文件夹重命名为包含这些字符之一的内容，Git 无法连接或与工作区同步，并发生错误。

分支限制

• 扩展分支需要权限表中列出的权限。
• 必须有可用容量可供此操作使用。
• 所有 工作区 和 分支命名限制 在分支到新工作区时适用。
• 新工作区中仅提供 Git 支持的项 。
• 相关分支列表仅显示你有权查看的分支和工作区。
• 必须启用 Git 集成。
• 分出分支时，会创建一个新分支，并且不会复制原始分支中的设置。 调整任何设置或定义，以确保新策略符合组织的策略。
• 当切换到现有工作区时：
  • 目标工作区必须支持 Git 连接。
  • 用户必须是目标工作区的管理员。
  • 目标工作区必须具有容量。
  • 工作区不能有模板应用。
• 请注意，当你分支到工作区时，未保存到 Git 的任何项都可能会丢失。 建议在扩展分支之前提交要保留的任何项。

同步和提交限制

• 一次只能向一个方向同步。 无法同时提交和更新。
• 不支持敏感度标签，可能会禁用导出具有敏感度标签的项。 若要提交没有敏感度标签的项目，请向管理员 请求帮助。
• 适用于受限项。 将忽略文件夹中不受支持的项。
• 不允许出现重复名称。 即使 Power BI 允许出现重复名称，更新、提交或撤消操作也会失败。
• 不支持 B2B。
• 冲突解决 在 Git 中部分完成。
• 在提交到 Git 的过程中，Fabric 服务将删除项文件夹中不属于项定义的文件。 不会删除不在项目文件夹中的不相关文件。
• 提交更改后，你可能会注意到项目中一些不是由你进行的意外更改。 这些更改在语义上是微不足道的，可能出于多种原因而发生。 例如：
  • 手动更改项定义文件。 这些更改是有效的，但可能与通过编辑器完成的更改不同。 例如，如果在 Git 中重命名语义模型列并将此更改导入工作区，则下次向语义模型提交更改时，bim 文件将注册为已更改，修改后的列将推送到 columns 数组的后面。 这是因为生成 bim 文件的 AS 引擎会将重命名的列推送到数组的末尾。 此更改不会影响项的操作方式。
  • 提交使用 CRLF 换行符的文件。 该服务使用 LF（行摘要）换行符。 如果在 Git 仓库中有使用 CRLF 换行符的项目文件，当您从服务提交时，这些文件会被更改为 LF。 例如，如果在桌面中打开报表，请保存项目文件（.pbip），并使用 CRLF 将其上传到 Git。
• 使用 增强刷新 API 刷新语义模型会导致每次刷新后出现 Git 差异。

相关内容

• Git 集成入门
• 了解 Git 集成过程