Основные понятия в интеграции Git

  • Статья

В этой статье описываются основные понятия Git и процесс интеграции Git с рабочей областью Microsoft Fabric.

Важно!

Microsoft Fabric в настоящее время находится на этапе предварительной версии. Эта информация относится к предварительной версии продукта, который может быть существенно изменен перед выпуском. Корпорация Майкрософт не дает никаких гарантий, явных или подразумеваемых, в отношении информации, представленной здесь.

Разрешения

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

Действия, которые можно выполнить в рабочей области, зависят от разрешений, имеющихся как в рабочей области, так и в Azure DevOps.

Разрешения Azure DevOps

В следующем списке показано, что могут делать различные роли рабочей области в зависимости от их разрешений Azure DevOps.

  • Администратор. Может выполнять любую операцию с рабочей областью, ограниченную только ролью Azure DevOps.
  • Участник или участник. После подключения к рабочей области член или участник может фиксировать и обновлять изменения в зависимости от роли Azure DevOps. Для действий, связанных с подключением к рабочей области (например, подключение, отключение или переключение ветвей), обратитесь за помощью к Администратор.
  • Средство просмотра: не удается выполнить какие-либо действия. Средство просмотра не может видеть сведения, связанные с Git, в рабочей области.

Разрешения, необходимые для распространенных операций

В следующей таблице описаны разрешения, необходимые для выполнения различных распространенных операций.

Операция Роль рабочей области Разрешения Git
Подключение рабочей области к репозиторию Git Административный Read=Allow
Синхронизация рабочей области с репозиторием Git Административный Read=Allow
Отключение рабочей области от репозитория Git Административный Разрешения не требуются
Переключение ветви в рабочей области (или изменение параметров подключения) Административный Read=Allow (в целевом репозитории,каталоге/ветви)
Просмотр сведений о подключении Git Администратор, участник, участник Чтение или нет
См. раздел "Состояние Git" рабочей области Администратор, участник, участник Read=Allow
Обновление из Git Все следующее:

Участник в рабочей области (разрешение WRITE для всех элементов)

Владелец элемента (если переключатель клиента блокирует обновления для пользователей, не являющихся владельцами)

BUILD на внешних зависимостях (если применимо)		 Read=Allow
Фиксация изменений рабочей области в Git Все следующее:

Участник в рабочей области (разрешение WRITE для всех элементов)

Владелец элемента (если переключатель клиента блокирует обновления для пользователей, не являющихся владельцами)

BUILD на внешних зависимостях (если применимо)		 Read=Allow
Contribute=Allow
Политика ветви должна разрешать прямую фиксацию
Создание новой ветви Git из Структуры Административный Role=Write
Create branch=Allow

Подключение и синхронизация

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

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

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

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

Если вы не выберете, какое содержимое нужно синхронизировать, вы не сможете продолжить работу, пока не сделаете следующее:

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

Состояние в GIT

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

Снимок экрана: элементы в рабочей области с выделенным состоянием Git.

Каждый элемент имеет одно из следующих состояний:

  • Синхронизировано (элемент совпадает в рабочей области и ветви Git)
  • Конфликт (элемент был изменен как в рабочей области, так и в ветви Git)
  • Неподдерживаемый элемент
  • Незафиксированные изменения в рабочей области
  • Требуется обновление из Git
  • Элемент синхронизирован, но метаданные отличаются

Сведения о синхронизации

Пока вы подключены, в нижней части экрана отображаются следующие сведения:

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

Снимок экрана: сведения о синхронизации, отображаемые в нижней части экрана при подключении к Git.

Фиксации и обновления

Панель управления версиями

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

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

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

На панели Управление версиями на вкладке Изменения отображается количество элементов, которые были изменены в рабочей области и должны быть зафиксированы в Git, а на вкладке Обновления отображается количество элементов, которые были изменены в ветви Git и которые необходимо обновить в рабочей области.

На каждой вкладке измененные элементы отображаются со значком, указывающим состояние:

  • Новые функции
  • Изменения
  • Удалены
  • Конфликта

Снимок экрана: панель управления версиями с состоянием измененных элементов.

Commit

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

Update

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

Узнайте больше о фиксации иобновлении. Узнайте больше о процессе обновления и способах устранения конфликтов.

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

Общие ограничения

  • Учетная запись Azure DevOps должна быть зарегистрирована для того же пользователя, который использует рабочую область Fabric.
  • В настоящее время модели прямого запроса и прокси-сервера не поддерживаются.
  • Частные пользовательские визуальные элементы не поддерживаются.

Ограничения рабочей области

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

Ограничения ветвей и папок

  • Максимальная длина имени ветви составляет 244 символа.
  • Максимальная длина полного пути для имен файлов составляет 250 символов. Длинные имена завершатся ошибкой.
  • Максимальный размер файла — 25 МБ.
  • Невозможно скачать отчет или набор данных как PBIX-файл из службы после их развертывания с помощью интеграции Git.

Ограничения синхронизации и фиксации

  • Максимальный размер фиксации составляет 25 МБ.
  • Синхронизация может выполняться только в одном направлении одновременно. Вы не можете зафиксировать и обновить одновременно.
  • Метки конфиденциальности не поддерживаются, и экспорт элементов с метками конфиденциальности может быть отключен. Чтобы зафиксировать элементы с метками конфиденциальности без метки конфиденциальности, обратитесь за помощью к администратору .
  • Работает с ограниченными элементами. Если неподдерживаемые элементы находятся в папке, они игнорируются.
  • Дублирование имен запрещено— даже если Power BI разрешает это, действие обновления, фиксации или отмены завершается ошибкой.
  • B2B не поддерживается.
  • Разрешение конфликтов частично выполняется в Git.

Дальнейшие действия