通过

Git 集成简介（预览版）

  • 项目

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

重要

此功能目前为预览版。

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

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

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

隐私信息

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

支持的 Git 提供程序

支持以下 Git 提供程序：

支持的项

当前支持以下项：

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

注意事项和限制

常规 Git 集成限制

  • Fabric 中的身份验证方法必须至少与 Git 的身份验证方法一样强大。 例如，如果 Git 需要多重身份验证，则 Fabric 也需要多重身份验证。
  • 目前不支持连接到 Analysis Services 的 Power BI 数据集。
  • 目前不支持主权云。
  • Azure DevOps 帐户必须注册到使用 Fabric 工作区的同一用户。
  • 如果工作区和 Git 存储库位于两个不同的地理区域，则租户管理员必须启用跨地区导出。
  • 提交的大小限制为 125 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 差异。

相关内容