开始使用Git集成

本文将带你了解 Fabric Git 集成工具中的以下基本任务：

建议在开始之前阅读 Git 集成 概述。

先决条件

若要将 Git 与Microsoft Fabric工作区集成，需要为 Fabric 和 Git 设置以下先决条件。

Fabric 先决条件

要访问 Git 集成功能，您需要一个 Fabric 容量。 需要使用结构容量才能使用所有受支持的 Fabric 项。 如果还没有试用版， 请注册免费试用版。 已有 Power BI Premium 容量的客户可以使用该容量，但请记住，某些 Power BI SKU 仅支持 Power BI 项目。

此外，以下租户开关必须在 OneLake 目录>治理>配置>租户设置中启用：

租户管理员、容量管理员或工作区管理员可以根据组织的设置启用这些开关。

Git 先决条件

Azure DevOps 和 GitHub 目前支持 Git 集成。 若要将 Git 与 Fabric 工作区集成，需要在 Azure DevOps 或 GitHub中满足以下条件：

  • Active Azure DevOps 帐户注册到同一 Fabric 用户（即使 Azure DevOps 组织驻留在与 Fabric 租户不同的租户中也受支持）。 创建免费帐户。
  • 访问现有存储库。

将工作区连接到 Git 存储库

连接到 Git 存储库

只有工作区管理员可以将工作区连接到存储库，但连接后，具有权限的任何人都可以在工作区中工作。 如果你不是管理员，请向管理员请求有关连接的帮助。 若要将工作区连接到Azure或GitHub存储库，请执行以下步骤：

  1. 登录到 Fabric 并导航到要连接的工作区。

  2. 转到“工作区设置”

    工作区的屏幕截图，顶部显示了工作区设置图标。

  3. 选择“git 集成”。

  4. 选择你的 Git 供应商。 目前，支持 Azure DevOps 和 GitHub。

如果选择 Azure DevOps，请选择 Connect 以自动登录到 Microsoft Entra 用户注册的 Azure Repos 帐户，这些用户已登录到 Fabric。

如果已使用其他帐户从 Fabric 登录到 Azure，请从列表中选择帐户，然后选择 Connect。

如果是第一次从 Fabric 登录，或者想要添加新帐户，请选择 “添加帐户”。

如果是第一次连接，则需要授权用户。 提供以下信息：

  • 显示名称 - 对于每个用户必须是唯一的
  • Azure DevOps URL - Azure DevOps 存储库的 URL。 URL 的格式必须为 https://dev.azure.com/{organization}/{project}/_git/{repository} 或 https://{organization}.visualstudio.com/{project}/_git/{repo}。
  • 身份验证 - 可以使用 OAuth2 或服务 主体进行身份验证。 有关详细信息，请参阅 Azure DevOps - Git 与服务主体的集成

GitHub 集成用户界面截图以添加账户。

登录后，选择 Connect 以允许 Fabric 访问您的帐户

连接到工作区

如果工作区已连接到 Azure DevOps/GitHub，请按照 连接到共享工作区 的说明进行操作。

  1. 在下拉菜单中，指定要连接到的分支的以下详细信息：

    • Organization
    • Project
    • Git 存储库。
    • 分支（使用下拉菜单选择现有分支，或选择“+新建分支”以创建新分支。一次只能连接到一个分支。）
    • 文件夹（键入现有文件夹的名称或输入名称以创建新文件夹。如果将文件夹名称留空，则会在根文件夹中创建内容。一次只能连接到一个文件夹。

截图到 Azure 连接。

选择“连接并同步”。

在初始同步期间，如果工作区或 Git 分支为空，则内容将从非空位置复制到空位置。 如果工作区和 Git 分支都有内容，系统会询问同步应采用哪个方向。 有关此初始同步的详细信息，请参阅连接和同步。

连接后，工作区会显示有关源代码控制的信息，你可以用来查看已连接的分支、分支中每个项目的状态以及最后一次同步的时间。

源代码管理图标和其他 Git 信息的屏幕截图。

若要使工作区与 Git 分支保持同步，请将在工作区中所做的任何更改提交到 Git 分支，并在任何人创建新的 Git 分支提交时更新工作区。

允许参与者和成员切换分支

默认情况下，诸如 切换分支 和 检出到新分支 之类的分支操作需要具有工作区管理员角色。 但是，工作区管理员可以启用工作区级别设置 ，允许至少具有参与者角色的用户更改 Git 分支。 启用此设置后，对工作区中所有项目具有写入访问权限的参与者或成员还可以在其自己的标识下切换分支并创建新分支。

允许用户更改 Git 分支的屏幕截图。

此设置：

  • 按工作区单独配置（没有租户级开关可将其禁用）。
  • 需要在工作区上建立有效的 Git 连接。
  • 不会更改连接或断开工作区的权限 - 这些操作仍为仅限管理员。

有关包括 Git 角色要求在内的详细权限表，请参阅 “权限”。

将更改提交到 git

成功连接到 Git 文件夹后，像往常一样编辑工作区。 保存的任何更改仅保存在工作区中。 准备就绪后，可以将更改提交到 Git 分支，也可以撤消更改并还原到以前的状态。

阅读关于提交的详细信息。

若要将更改提交到 Git 分支，请执行以下步骤：

  1. 转到工作区。

  2. 选择“源代码管理”图标。 此图标显示未提交的更改数。 “源代码管理”图标的屏幕截图，数字 2 表示要提交两个更改。

  3. 在“源代码管理”面板中选择“更改”。 此时会显示一个列表，其中包含您更改的所有项，以及一个图标，指示该项是否为新项、已修改项、冲突、相同更改或删除项。

  4. 选择想要删除的项目。 若要选择所有项目，检查顶部框。

  5. 在框中添加注释。 如果不添加注释，则会自动添加默认消息。

  6. 选择 “提交”。

    选中要提交的两个更改的“源代码管理”窗口屏幕截图。

提交更改后，已提交的项将从列表中删除，工作区将指向同步到的新提交。

“源代码管理”窗口的屏幕截图，表示没有要提交的更改。

成功完成提交后，所选项的状态将从“未提交”更改为“已同步”。

Note

你也可以把比较体验中的更改提交到 Git。 对于支持的项目，预览文件级提交功能允许你在项目内提交特定文件。 更多信息请参见 “比较并提交更改”。

从 Git 更新工作区

每当有人向连接的 Git 分支提交新更改时，相关工作区中都会显示一条通知。 使用“源代码管理”面板可拉取最新更改、合并或还原到工作区并更新实时项。 对文件夹的更改也会更新。 阅读有关更新的详细信息。

若要更新工作区，请执行以下步骤：

  1. 转到工作区。
  2. 选择“源代码管理”图标。
  3. 从源控制面板中选择更新。 此时会显示一个列表，其中包含自上次更新以来分支中已更改的所有项。
  4. 选择“全部更新”。

源控制面板截图，其中打开了“更新”选项卡，并且“更新所有”按钮已被选中。

  1. 在确认对话框中，选择“ 更新”。

确认对话框的屏幕截图。

成功更新后，项目列表被移除，工作区与连接的 Git 分支完全同步。

“源代码管理”屏幕截图，表示已成功更新工作区。

成功完成更新后，项的状态将更改为“已同步”。

断开工作区与 Git 的连接

只有工作区管理员可以断开工作区与 Git 存储库的连接。 如果你不是管理员，请向你的管理员寻求断开连接方面的帮助。 如果你是管理员并想要断开存储库的连接，请执行以下步骤：

  1. 转到“工作区设置”
  2. 选择“Git 集成”
  3. 选择“断开工作区连接”
  4. 再次选择“断开连接”进行确认。

Permissions

可以对工作区执行的操作取决于在工作区和 Git 存储库中拥有的权限。 有关权限的更详细讨论，请参阅权限。

相关内容

  • 上次更新时间为