Управление рабочей областью с помощью Git (предварительная версия)

В этой статье описаны следующие основные задачи в средстве интеграции Git Microsoft Fabric:

• Подключение репозиторию Git
• Фиксация изменений
• Обновление из Git
• Отключение от Git

Перед началом работы рекомендуется ознакомиться с обзором интеграции Git.

Внимание

Эта функция доступна в предварительной версии.

Необходимые компоненты

Чтобы интегрировать Git с рабочей областью Microsoft Fabric, необходимо настроить следующие предварительные требования как в Azure DevOps, так и в Fabric.

Предварительные требования Для Azure DevOps

• Активная учетная запись Azure, зарегистрированная для того же пользователя, который использует рабочую область Fabric. Создайте бесплатную учетную запись.
• Доступ к существующему репозиторию.

Предварительные требования структуры

Чтобы получить доступ к функции интеграции Git, необходимо выполнить одно из следующих действий.

• Лицензия Power BI Premium. Лицензия Power BI premium поддерживает только все элементы Power BI.
• Емкость структуры. Емкость Fabric необходима для использования всех поддерживаемых элементов Fabric.

Кроме того, администратор вашей организации должен включить, чтобы пользователи могли создавать клиент элементов Fabric на портале Администратор.

Подключение рабочей области в репозиторий Azure

Только администратор рабочей области может подключить рабочую область к репозиторию Azure, но после подключения любой пользователь с разрешением может работать в рабочей области. Если вы не являетесь администратором, обратитесь к администратору за помощью к подключению. Чтобы подключить рабочую область к репозиторию Azure, выполните следующие действия.

1. Войдите в Power BI и перейдите в рабочую область, с которой вы хотите подключиться.

2. Перейти к параметрам рабочей области

   

   Примечание.

   Если значок параметров рабочей области не отображается, выберите многоточие (три точки), а затем параметры рабочей области.

3. Выберите интеграцию Git. Вы автоматически вошли в учетную запись Azure Repos, зарегистрированную для пользователя Microsoft Entra, вошедшего в Fabric.

   

4. В раскрывающемся меню укажите следующие сведения о ветви, к которой вы хотите подключиться:

   Примечание.

   Вы можете подключить рабочую область только к одной ветви и одной папке одновременно.

   • Предприятие
   • Проект
   • Репозиторий Git
   • Ветвь (выберите существующую ветвь с помощью раскрывающегося меню или нажмите кнопку +Создать ветвь, чтобы создать новую ветвь . Вы можете подключиться только к одной ветви одновременно.)
   • Папка (выберите существующую папку в ветви или введите имя для создания новой папки. Если вы не выберете папку, содержимое будет создано в корневой папке. Вы можете подключиться только к одной папке одновременно.)

5. Выберите Подключение и синхронизацию.

При первоначальной синхронизации, если рабочая область или ветвь Git пуста, содержимое копируется из расположения nonempty в пустое. Если рабочая область и ветвь Git содержат содержимое, вам будет предложено выбрать направление синхронизации. Дополнительные сведения об этой начальной синхронизации см. в Подключение и синхронизации.

После подключения рабочая область отображает сведения о системе управления версиями, которая позволяет пользователю просматривать подключенную ветвь, состояние каждого элемента в ветви и время последней синхронизации.

Чтобы рабочая область синхронизировалась с ветвью Git, зафиксируйте все изменения, внесенные в рабочую область в ветвь Git, и обновите рабочую область всякий раз, когда кто-либо создает новые фиксации в ветви Git.

Фиксация изменений в Git

После успешного подключения к папке Git измените рабочую область как обычно. Все сохраненные изменения сохраняются только в рабочей области. Когда вы будете готовы, вы можете зафиксировать изменения в ветви Git или отменить изменения и отменить изменения в предыдущее состояние. Дополнительные сведения о фиксациях.

Фиксация в Git

Чтобы зафиксировать изменения в ветви Git, выполните следующие действия.

1. Перейти в рабочую область.

2. Щелкните значок элемента управления версиями. На этом значке показано количество незафиксированных изменений.

3. Перейдите на вкладку "Изменения" области управления версиями. Список отображается со всеми измененными элементами и значком, указывающим, является ли элемент новым, измененным, конфликтом или удаленным.

4. Выберите элементы, которые нужно зафиксировать. Чтобы выбрать все элементы, проверка верхнем поле.

5. Добавьте комментарий в поле. Если вы не добавляете комментарий, сообщение по умолчанию добавляется автоматически.

6. Щелкните здесь Зафиксировать.

   

После фиксации изменений элементы, которые были зафиксированы, удаляются из списка, а рабочая область будет указывать на новую фиксацию, с которым она синхронизируется.

После успешного завершения фиксации состояние выбранных элементов изменяется с uncommitted на Synced.

Отмена сохраненного изменения

После сохранения изменений в рабочей области, если вы решите, что вы не хотите зафиксировать эти изменения в Git, можно отменить изменения и отменить изменения эти элементы в предыдущее состояние. Чтобы отменить изменения, выполните следующие действия.

1. Перейти в рабочую область.

2. Нажмите кнопку управления версиями . Эта кнопка также показывает количество незафиксированных изменений.

3. Перейдите на вкладку "Изменения" области управления версиями. Список отображается со всеми измененными элементами и значком, указывающим, является ли измененный элемент новым, измененным, конфликтом или удаленным.

4. Выберите изменения, которые нужно отменить.

5. Выберите "Отменить".

   

6. Нажмите кнопку "Отменить" , чтобы подтвердить.

   

Выбранные элементы в рабочей области отменить изменения тому, как они были в последний раз синхронизированы.

Внимание

Если удалить элемент, а затем отменить изменения, элемент создается заново, а некоторые из метаданных могут быть потеряны. Например, метки конфиденциальности не сохраняются и должны быть сброшены, и владелец элемента задается текущему пользователю.

Обновление рабочей области из Git

Всякий раз, когда кто-либо фиксирует новое изменение в подключенной ветви Git, уведомление появляется в соответствующей рабочей области. Используйте панель управления версиями для извлечения последних изменений, слияний или отменить изменения в рабочую область и обновления динамических элементов. Дополнительные сведения об обновлении.

Чтобы обновить рабочую область, выполните следующие действия.

1. Перейти в рабочую область.
2. Щелкните значок элемента управления версиями.
3. Перейдите на вкладку Обновления области управления версиями. Список отображается со всеми элементами, которые были изменены в ветви с момента последнего обновления.
4. Выберите "Обновить все".

После успешного обновления список элементов удаляется, а рабочая область будет указывать на новую фиксацию, с которым она синхронизирована.

После успешного завершения обновления состояние элементов изменяется на Synced.

Отключение рабочей области от Git

Только администратор рабочей области может отключить рабочую область от репозитория Azure. Если вы не являетесь администратором, обратитесь к администратору за помощью в отключении. Если вы являетесь администратором и хотите отключить репозиторий, выполните следующие действия.

1. Перейти к параметрам рабочей области

2. Выбор интеграции Git

3. Выбор рабочей области "Отключить"

   

4. Нажмите кнопку "Отключиться ", чтобы подтвердить.

   

Разрешения

Действия, которые можно выполнить в рабочей области, зависят от разрешений, которые у вас есть как в рабочей области, так и в Azure DevOps. Более подробное обсуждение разрешений см. в разделе "Разрешения".

Рекомендации и ограничения

• Во время процесса фиксации в Git служба Fabric удаляет все файлы в папке элементов, которые не являются частью определения элемента. Не связанные файлы, не входящие в папку элементов, не удаляются.

• После фиксации изменений вы можете заметить некоторые непредвиденные изменения элемента, который вы не сделали. Эти изменения семантически незначительны и могут произойти по нескольким причинам. Например:

  • Изменение файла определения элемента вручную. Эти изменения допустимы, но могут отличаться от того, что сделано через редакторы. Например, если вы переименовываете столбец семантической модели в Git и импортируете это изменение в рабочую область, при следующем фиксации изменений в семантической модели файл bim будет регистрироваться как измененный и измененный столбец, отложенный к задней части массива columns . Это связано с тем, что подсистема AS, создающая файлы bim , отправляет переименованные столбцы в конец массива. Это изменение не влияет на способ работы элемента.

  • Фиксация файла, использующего разрывы строк CRLF . Служба использует разрывы строк LF (веб-канала строк). Если у вас есть файлы элементов в репозитории Git с разрывами строк CRLF, при фиксации из службы эти файлы изменяются на LF. Например, если открыть отчет на рабочем столе, сохраните проект PBIP и отправьте его в Git с помощью CRLF.

• Если у вас возникли проблемы с этими действиями, убедитесь, что вы понимаете ограничения функции интеграции Git.

Связанный контент

• Общие сведения о процессе интеграции Git
• Управление ветвями Git
• Рекомендации по интеграции с Git