什么是 Microsoft Fabric Git 集成？

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

注意

Git 集成的某些项以预览版提供。 有关详细信息，请参阅支持的项的列表。

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

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

与源代码管理的集成在工作区级别上。 开发人员可以在单个进程中对在工作区中开发的项进行版本控制，并完全了解他们所有的项。 目前仅支持少数项，但支持的项的列表正在扩大。

• 阅读版本控制和 Git 以确保熟悉基本的 Git 概念。

• 详细了解 Git 集成过程。

• 阅读管理 Git 分支的最佳方式。

隐私信息

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

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

支持的 Git 提供程序

支持以下 Git 提供程序：

• 与 Fabric 租户同一租户的 Azure Repos 中的 Git
• GitHub
• GitHub Enterprise

支持的项

当前支持以下项：

• 数据管道（预览版）
• Dataflows gen2（预览版）
• EventHouse（预览版）
• EventStream（预览版）
• 湖屋（预览版）
• Eventhouse 和 KQL 数据库（预览）
• Notebook
• 分页报表（预览版）
• Reflex（预览版）
• 报告（不包括与托管在 Azure Analysis Services、SQL Server Analysis Services 中的语义模型相关的报告或由依赖于托管在 MyWorkspace（预览版）中的语义模型的 Power BI Desktop 导出的报告）
• 语义模型（推送数据集、实时连接到 Analysis Services 和模型 v1（预览版）除外）
• Spark 作业定义（预览版）
• Spark 环境（预览版）
• SQL 数据库（预览）
• 仓库（预览版）

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

注意事项和限制

常规 Git 集成限制

• Fabric 中的身份验证方法必须至少与 Git 的身份验证方法一样强大。 例如，如果 Git 需要多重身份验证，则 Fabric 也需要多重身份验证。
• 目前不支持连接到 Analysis Services 的 Power BI 数据集。
• 安装了模板应用的工作区无法连接到 Git。
• 目前不支持主权云。

Azure DevOps 限制

• Azure DevOps 帐户必须注册到使用 Fabric 工作区的同一用户。
• 如果工作区和 Git 存储库位于两个不同的地理区域，则租户管理员必须启用跨地区导出。
• 如果组织设置了条件访问，请确保 Power BI 服务设置了相同的条件，以便身份验证按预期运行。
• 提交的大小限制为 125 MB。

GitHub 限制

• GitHub 无法强制实施跨地区验证。
• 一次性提交的文件的总大小限制为 50 MB。 因此，如果有多个项要提交，有时可能需要将其拆分，进行单独提交。 有关提交文件的详细信息，请参阅故障排除指南。

GitHub Enterprise 限制

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

• IP 允许列表
• 专用网络
• 自定义域

工作区限制

• 只有工作区管理员可以管理与 Git 存储库的连接，例如连接、断开连接或添加分支。
  连接后，具有权限的任何人都可以在工作区中工作。
• 工作区文件夹结构不会反映在 Git 存储库中。 文件夹中的工作区项将导出到根目录。

分支和文件夹限制

• 分支名称的最大长度为 244 个字符。
• 文件名的完整路径的最大长度为 250 个字符。 过长的名称会失败。
• 文件大小上限为 25 MB。
• 使用 Git 集成部署报表/数据集后，无法从服务下载 .pbix 格式的报表/数据集。
• 如果项目的显示名称如下，Git 文件夹在类型之前使用逻辑 ID (Guid) 作为前缀：
  • 超过 256 个字符
  • 以 . 或空格结尾
  • 包含以下任意字符：" / : < > \ * ? |

扩展延伸限制

• 扩展延伸需要权限表中列出的权限。
• 必须有可用容量可供此操作使用。
• 所有工作区和分支命名限制在扩展延伸到新工作区时适用。
• 扩展延伸时，会创建新工作区，并且不会复制原始工作区中的设置。 调整任何设置或定义，以确保新工作区符合组织策略。
• 新工作区中仅提供 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 集成过程