开始使用Git集成

本文将指导你完成Microsoft Fabric Git 集成工具中的以下基本任务：

• 连接到 Git 存储库
• 提交更改
• 从 Git 更新
• 断开与 Git 的连接

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

先决条件

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

Fabric 先决条件

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

此外，必须从管理门户启用以下 租户切换 ：

• 用户可创建 Fabric 项目 - 在使用 Fabric artifacts 时需要
• 用户可以将工作区项与其 Git 存储库同步
• 创建工作区 （仅当想要分支到新工作区时）。
• 用户只能将工作区项与GitHub存储库同步：仅适用于GitHub用户

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

Git 先决条件

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

Azure DevOps

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

GitHub

• 活跃的GitHub账号。 创建GitHub帐户。

• 一个个人访问令牌：

  • 一个细化令牌（建议），在存储库权限中的Contents下具备读写权限：

    

    若要将此令牌用于 GitHub Enterprise，请遵循说明。

  • 为存储库范围启用GitHub经典令牌：

    

将工作区连接到 Git 存储库

连接到 Git 存储库

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

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

2. 转到“工作区设置”

   

3. 选择“git 集成”。

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

Azure DevOps Connect

如果选择 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 与服务主体的集成

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

GitHub Connect

如果选择GitHub，则需要登录到GitHub帐户。 如果已登录到 GitHub，请从列表中选择帐户，然后选择 Connect。

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

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

• 显示名称 - 对于每个GitHub用户必须是唯一的
• 个人访问令牌 - 您的经典或细粒度个人访问令牌
• Repository URL（github.com 可选，ghe.com 必需）- 如果未输入 URL，可以连接到您有权限访问的任何 github.com 存储库。 如果输入 URL，则只能连接到此存储库。

登录后，选择 Connect 以允许 Fabric access GitHub 帐户。

连接到工作区

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

Azure DevOps 分支连接

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

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

GitHub 分支连接

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

   • Repository URL。 如果使用作用域令牌连接到 GitHub，则 URL 会自动填充，并且您只能连接到该存储库。
   • 分支（使用下拉菜单选择现有分支，或选择“+新建分支”以创建新分支。一次只能连接到一个分支。）
   • 文件夹（键入现有文件夹的名称或输入名称以创建新文件夹。如果将文件夹名称留空，则会在根文件夹中创建内容。一次只能连接到一个文件夹。

选择“连接并同步”。

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

连接后，工作区将显示有关源代码管理的信息，该信息允许用户查看连接的分支、分支中每个项的状态以及上次同步的时间。

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

将更改提交到 git

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

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

提交到 Git

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

1. 转到工作区。

2. 选择“源代码管理”图标。 此图标显示未提交的更改数。

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

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

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

6. 选择 “提交”。

   

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

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

提交到独立分支

提交到独立分支是一项 Git 集成功能，可让您在一个步骤中创建一个新的分支并提交当前更改。 换句话说，无需提交到连接的分支，即可即时创建分支：系统将启动一个新的 Git 分支，并将您的工作保存在那里，而不需要离开或切换出您原本的分支。

1. 转到工作区。
2. 选择“源代码管理”图标。 此图标显示未提交的更改数。
3. 在“源代码管理”面板中选择“更改”。 此时会显示一个列表，其中包含您更改的所有项，以及一个图标，指示该项是否为新项、已修改项、冲突、相同更改或删除项。
4. 选择想要删除的项目。 若要选择所有项目，检查顶部框。
5. 在框中添加注释。 如果不添加注释，则会自动添加默认消息。
6. 选择 提交到新分支。

重要

请注意以下事项：

• 新创建的分支不会连接到现有工作区。
• 新创建的分支将基于当前工作区的最后同步的状态。
• 当有传入的更新时，即使默认提交已禁用，此功能也是可能的。
• 由于此提交，当前工作区状态不会更改，并且保持不变。

撤消保存的更改

将更改保存到工作区后，如果你决定不想将这些更改提交到 git，则可以撤消更改并将这些项目还原到其以前的状态。 若要撤消更改，请执行以下步骤：

1. 转到工作区。

2. 选择“源代码管理”按钮。 此按钮还显示未提交的更改数。

3. 从源代码管理面板中选择更改。 此时会显示一个列表，其中包含已更改的所有项，以及一个图标，指示更改项是新项、已修改项、冲突项 还是已删除项。

4. 选择要撤消的更改。

5. 将选中标记放置在 “我了解工作区项可能被删除且无法还原” 的框内，并选择 “撤消”。

   

6. 再次选择“撤消”以确认。 你看到的对话框可能会有所不同，具体取决于是否检测到要删除的项目。 第一个截图显示没有删除操作。 第二种情况是，如果检测到删除操作。

   

   

您的工作区中选中的项目将恢复到上次同步工作区时的状态。

重要

如果删除某个项，然后撤消更改，则会创建一个新的项，并且某些元数据可能会丢失。 例如，敏感度标签不会被保留，需要重置，并且项目的所有者将设为当前用户。

撤消添加的项将永久删除该项。

从 Git 更新工作区

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

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

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

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

成功更新后，项目列表将被删除，工作区将指向新的同步工作区。

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

断开工作区与 Git 的连接

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

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

权限

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

相关内容

• 了解 Git 集成过程
• 管理 Git 分支
• Git 集成最佳做法