Поделиться через

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

  • Статья

В этой статье описываются основные понятия Git и процесс интеграции Git с рабочей областью 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
Участие=Разрешить
Политика ветви должна разрешить прямую фиксацию
Создание новой ветви Git из Структуры Администрирование Role=Write
Create branch=Allow
Ветвь в новую рабочую область Администратор, член, участник Read=Allow
Create branch=Allow

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

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

При подключении рабочей области к Git Структура синхронизируется между двумя расположениями, чтобы они имели одинаковое содержимое. При первоначальной синхронизации, если рабочая область или ветвь Git пуста, а другая содержит содержимое, содержимое копируется из расположения nonempty в пустой. Если в рабочей области и ветви 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 всегда обновляет всю ветвь и синхронизируется с последней фиксацией. Не удается выбрать определенные элементы для обновления.
  • Если изменения были внесены в рабочую область и в ветви Git на том же элементе, обновления отключаются до устранения конфликта.

Дополнительные сведения о фиксации и обновлении. Узнайте больше о процессе обновления и о том, как устранить конфликты.

Ветви

Вкладка "Ветви" панели управления версиями позволяет управлять ветвями и выполнять связанные с филиалами действия. В нем есть два основных раздела:

  • Действия, которые можно выполнить в текущей ветви:

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

    Снимок экрана: вкладка

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

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

Дополнительные сведения см. в разделе об ограничениях для ветвления.

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

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

  • Учетная запись Azure DevOps должна быть зарегистрирована для того же пользователя, который использует рабочую область Fabric.
  • Метод проверки подлинности в Power BI должен быть не менее строгим, чем метод проверки подлинности для Azure DevOps. Например, если Azure DevOps требует многофакторной проверки подлинности, Power BI также требует многофакторной проверки подлинности.
  • В настоящее время наборы данных Power BI, подключенные к службам Analysis Services, не поддерживаются.
  • Обновление семантической модели с помощью API расширенного обновления вызывает дифф Git после каждого обновления.
  • Структура папок рабочей области не отражается в репозитории Git. Элементы рабочей области в папках экспортируются в корневой каталог.

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

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

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

  • Максимальная длина имени ветви составляет 244 символа.

  • Максимальная длина полного пути для имен файлов составляет 250 символов. Сбой длинных имен.

  • Максимальный размер файла составляет 25 МБ.

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

  • Если отображаемое имя элемента:

    • Имеет более 256 символов
    • Заканчивается " .или пробел
    • Содержит любой из следующих символов: , /, , , , ?*\\><:"|

    Логический идентификатор (GUID) добавляется в качестве префикса перед типом при именовании папки в Git.

Ограничения ветвления

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

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

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

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