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

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

Разрешения

• Администратор вашей организации должен включить интеграцию Git.
• Администратор клиента должен включить кросс-гео экспорт, если рабочая область и репозиторий Azure находятся в двух разных регионах. Это ограничение не применяется к GitHub.
• Разрешения, которые у вас есть как в рабочей области, так и в Git, как указано в следующих разделах, определяют действия, которые можно предпринять.

Необходимые разрешения Git для популярных действий

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

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

Необходимые разрешения Fabric для основных действий

Роли рабочего пространства

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

Операция	Роль рабочей области
Подключение рабочей области к репозиторию Git	Админ
Синхронизация рабочей области с репозиторием Git	Админ
Отключение рабочей области от репозитория Git	Админ
Переключите ветвь в рабочей области (или измените настройки подключения)	Админ
Просмотр сведений о подключении Git	Администратор, член, участник
Просмотр состояния рабочей области Git	Администратор, член, участник
Обновление из Git	Все следующие роли: Участник рабочей области (разрешение WRITE для всех элементов) Владелец объекта (если переключатель арендатора блокирует обновления для невладельцев) Сборка на внешних зависимостях (где применимо)
Фиксация изменений рабочей области в Git	Все следующие роли: Участник рабочей области (разрешение WRITE для всех элементов) Владелец объекта (если переключатель арендатора блокирует обновления для невладельцев) Сборка на внешних зависимостях (где применимо)
Создание новой ветви Git из Fabric	Админ
Перейти в другое рабочее пространство	Администратор, член, участник

Роли Git

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

Azure Repos

Операция	Разрешения Git
Подключение рабочей области к репозиторию Git	Чтение=Разрешить
Синхронизация рабочей области с репозиторием Git	Чтение=Разрешить
Отключение рабочей области от репозитория Git	Разрешения не требуются
Переключите ветвь в рабочей области (или измените настройки подключения)	Чтение=Разрешено (в целевом репозитории/каталоге/ветке)
Просмотр сведений о подключении Git	Читать или совсем не читать
Просмотр состояния рабочей области Git	Чтение=Разрешить
Обновление из Git	Чтение=Разрешить
Фиксация изменений рабочей области в Git	Чтение=Разрешить Внести вклад=Разрешить Политика ветви должна разрешать прямой коммит
Создание новой ветви Git из Fabric	Роль=Запись Создать ветку=Разрешить
Перейти в другое рабочее пространство	Чтение=Разрешить Создать ветку=Разрешить

Репозиторий GitHub

• Если вы используете детализированный токен доступа, для типичных операций требуются следующие разрешения:

  Операция	Разрешения Git
  Подключение рабочей области к репозиторию Git	Содержимое= Доступ: Чтение
  Синхронизация рабочей области с репозиторием Git	Содержимое= Доступ: Чтение
  Отключение рабочей области от репозитория Git	Разрешения не требуются
  Переключите ветвь в рабочей области (или измените настройки подключения)	Содержимое: доступ на чтение (в целевом репозитории/каталоге/ветке)
  Просмотр сведений о подключении Git	Содержимое = Доступ: Чтение или Нет
  Просмотр состояния рабочей области Git	Содержимое= Доступ: Чтение
  Обновление из Git	Содержимое= Доступ: Чтение
  Фиксация изменений рабочей области в Git	Содержимое= доступ: чтение и запись Политика ветви должна разрешать прямой коммит
  Создание новой ветви Git из Fabric	Содержимое= доступ: чтение и запись
  Перейти в другое рабочее пространство	Читать и писать

• Если вы используете классический токен доступа, права для репозитория должны быть активированы.

  

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

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

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

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

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

Папки

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

Примечание.

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

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

Безопасная обработка изменений в папках

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

Если вы не можете вносить изменения в подключенную ветвь напрямую из-за политики ветви или разрешений, рекомендуется использовать параметр Checkout Branch:

1. Создайте новую ветвь: используйте функцию создания ветви, чтобы создать ветвь с обновленным состоянием рабочей области Fabric.
2. Фиксация изменений папок: любые изменения в папке рабочей области можно зафиксировать в этой новой ветви.
3. Слияние изменений: используйте ваши стандартные запросы на слияние (PR) и процедуры слияния, чтобы интегрировать эти обновления обратно в исходную ветку.

Подключение к общей рабочей области

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

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

Состояние Git

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

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

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

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

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

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

Область управления исходным кодом

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

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

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

• Коммиты и обновления
• Филиалы
• Сведения об учетной записи

Коммиты и обновления

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

Панель коммита и обновления содержит два раздела.

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

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

• новый
• модифицировано
• удалено
• конфликт
• те же изменения

Кнопка "Обновить" в верхней части панели обновляет список изменений и обновлений.

фиксировать изменения

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

Обновить

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

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

Ветви

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

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

  • Разветвление в другую рабочую область (участник и выше): создает новую рабочую область или переключается на существующую рабочую область в зависимости от последнего коммита в текущей рабочей области. Затем он подключается к целевой рабочей области и ветке.
  • Проверка новой ветки (требуется быть администратором рабочей области): создает новую ветку на основе последнего синхронизированного коммита в рабочей области и изменяет подключение Git в текущей рабочей области. Он не изменяет содержимое рабочей области.
  • Смена ветки (необходимы права администратора): синхронизирует рабочую область с другой новой или существующей веткой и заменяет все элементы в рабочей области содержимым выбранной ветки.

  

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

  

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

Сведения об учетной записи

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

Сведения об учетной записи GitHub:

• Сведения о учетной записи Git

  • Поставщик
  • Имя учетной записи

• Репозиторий Git

• Отрасль

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

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

• Метод проверки подлинности в Fabric должен быть не менее строгим, чем метод проверки подлинности для Git. Например, если Git требует многофакторной проверки подлинности, Структура должна также требовать многофакторную проверку подлинности.
• В настоящее время наборы данных Power BI, подключенные к службам Analysis Services, не поддерживаются.
• Если вы используете идентификатор рабочей области в одном артефакте и фиксируете его в Git, его можно обновить обратно в рабочую область fabric только в той рабочей области, которая подключена к тому же идентификатору. Будьте осторожны, так как это также влияет на такие функции, как разветвление.
• Подмодулы не поддерживаются.
• Независимые облака не поддерживаются.
• Если рабочая область содержит сотни элементов, попробуйте разделить ее на небольшие наборы артефактов. Каждый набор должен быть помещен в отдельную рабочую область и связан с другой ветвью Git или подключен к одной ветви, упорядоченной в разные папки.

Ограничения Azure DevOps

• Azure DevOps не поддерживается, если включена проверка политики условного доступа IP.
• Если рабочая область и репозиторий Git находятся в двух разных географических регионах, администратор клиента должен включить межрегиографный экспорт.
• Если ваша организация настроила условный доступ, убедитесь в том, что для службы Power BI установлены те же условия, чтобы проверка подлинности работала как положено.
• Применяется следующее ограничение размера коммита:
  • 25 МБ с помощью соединителя Azure DevOps с субъектом-службой.
  • 125 МБ с использованием учетной записи по умолчанию для единого входа (SSO) Microsoft Entra ID и соединителя Azure DevOps с главным пользователем.

Ограничения GitHub

• Поддерживаются только облачные версии GitHub. Локально установленные системы не поддерживаются.
• GitHub не может применять межрегиональные проверки.
• Общий совокупный размер файлов для коммита одновременно ограничен 50 МБ. Таким образом, если у вас есть несколько элементов для фиксации, иногда может потребоваться разделить их на несколько отдельных фиксаций. Дополнительные сведения о коммите файлов см. в нашем руководстве по устранению неполадок.

Ограничения GitHub Enterprise

Некоторые версии и параметры GitHub Enterprise не поддерживаются. Например:

• GitHub Enterprise Cloud с локализацией данных (ghe.com)
• GitHub Enterprise Server с пользовательским доменом не поддерживается, даже если экземпляр доступен публично.
• Github Enterprise Server, размещенный в частной сети
• Список разрешенных IP-адресов

Рекомендации по миграции Azure DevOps в GitHub Enterprise

Если ваша команда использует интеграцию Git с Fabric и оценивает миграцию из Azure DevOps в GitHub Enterprise, рекомендуется выполнить проверочные тесты, чтобы убедиться, что функциональность интеграции Git остаётся неизменной. Интеграция Git Fabric использует базовые API поставщика Git, которые отличаются возможностями и ограничениями между Azure DevOps и GitHub Enterprise, как описано выше.

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

• Только администратор рабочей области может управлять подключениями к репозиторию Git, таким как подключение, отключение или добавление ветви.
  После подключения любой пользователь с разрешением может работать в рабочей области.
• Рабочие области с установленными приложениями-шаблонами не могут быть подключены к Git.
• MyWorkspace не удается подключиться к поставщику Git.

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

• Максимальная длина имени ветви составляет 244 символа.
• Максимальная длина полного пути для имен файлов составляет 250 символов. Длинные имена не работают.
• Максимальный размер файла составляет 25 МБ.
• Структура папок поддерживается до 10 уровней.
• Скачивание отчета или набора данных в виде PBIX из службы после их развертывания с интеграцией Git не рекомендуется, так как результаты ненадежны. Мы рекомендуем использовать PowerBI Desktop для скачивания отчетов и наборов данных в виде PBIX.
• Если отображаемое имя элемента имеет какие-либо из этих характеристик, папка Git переименовывается в логический идентификатор (GUID) и тип.
  • Имеет более 256 символов
  • Заканчивается на , или пробел.
  • Содержит любые запрещенные символы, как описано в ограничениях имени каталога
• При подключении рабочей области с папками к Git необходимо зафиксировать изменения в репозитории Git, если это структура папок отличается.

Ограничения имени каталога

• Имя каталога, подключающегося к репозиторию Git, имеет следующие ограничения именования:

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

• Папка элемента (папка, содержащая файлы элементов), не может содержать ни одного из следующих символов: ":<>\*?|. Если вы переименовываете папку в одну из этих символов, Git не может подключиться или синхронизироваться с рабочей областью и возникает ошибка.

Ограничения процесса разветвления

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

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

• Одновременно можно синхронизировать только в одном направлении. Вы не можете одновременно зафиксировать и обновить.
• Метки конфиденциальности не поддерживаются, и экспорт элементов с метками конфиденциальности может быть отключен. Чтобы зафиксировать элементы с метками конфиденциальности без метки конфиденциальности, обратитесь к администратору за помощью.
• Работает с ограниченными элементами. Неподдерживаемые элементы в папке игнорируются.
• Дублирование имен не допускается. Даже если Power BI позволяет дублирование имен, обновление, фиксация или отмена операции не удается.
• B2B не поддерживается.
• Разрешение конфликтов частично выполняется в Git.
• Во время процесса фиксации в Git сервис Fabric удаляет файлы внутри папки элемента, которые не входят в определение элемента. Не связанные файлы, не входящие в папку элемента, не удаляются.
• После применения изменений вы можете заметить некоторые непредвиденные изменения в элементе, которые вы не вносили. Эти изменения семантически незначительны и могут произойти по нескольким причинам. Например:
  • Изменение файла определения элемента вручную. Эти изменения допустимы, но могут отличаться от того, что сделано через редакторы. Например, если вы переименовываете столбец семантической модели в Git и импортируете это изменение в рабочую область, при следующей фиксации изменений в семантической модели файл bim будет регистрироваться как измененный, и измененный столбец будет перемещен в конец массива columns. Это связано с тем, что подсистема AS, создающая файлы bim , отправляет переименованные столбцы в конец массива. Это изменение не влияет на способ работы элемента.
  • Коммит файла, использующего разрывы строк CRLF . Служба использует LF (подача строки) для разрыва строк. Если у вас в репозитории Git находятся файлы элементов с разрывами строк CRLF, при фиксации изменений из службы эти файлы изменяются на LF. Например, если открыть отчет на рабочем столе, сохраните файл проекта (PBIP) и отправьте его в Git с помощью CRLF.
• Обновление семантической модели с помощью API расширенного обновления вызывает различие в Git после каждого обновления.

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

• Управление ветвями
• Устранение ошибок и конфликтов