Начало работы с интеграцией Git

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

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

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

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

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

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

Чтобы получить доступ к интеграции Git, вам потребуется емкость Fabric . Емкость Fabric необходима для использования всех поддерживаемых элементов Fabric. Если у вас еще нет пробной версии, зарегистрируйтесь на бесплатную пробную версию. Клиенты, у которых уже есть ресурс Power BI Premium, могут использовать этот ресурс, но помните, что некоторые SKU Power BI поддерживают только элементы Power BI.

Кроме того, на портале администрирования необходимо включить следующие коммутаторы клиента:

• Пользователи могут создавать элементы Fabric
• Пользователи могут синхронизировать элементы рабочей области с репозиториями Git
• Только для пользователей GitHub: пользователи могут синхронизировать элементы рабочей области с репозиториями GitHub

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

Предварительные требования Git

Интеграция Git в настоящее время поддерживается для Azure DevOps и GitHub. Чтобы использовать интеграцию Git с рабочей областью Fabric, вам потребуется следующее в Azure DevOps или GitHub:

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

Подключение к репозиторию Git

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

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

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

   

3. Выберите Git интеграцию.

4. Выберите поставщика Git. В настоящее время поддерживаются Azure DevOps и GitHub.

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

Если рабочая область уже подключена к GitHub, следуйте инструкциям по подключению к общей рабочей области.

Выберите "Подключиться и синхронизировать".

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

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

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

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

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

Узнайте больше о коммитах.

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

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

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

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

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

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

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

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

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

Разрешения

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

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

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

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

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

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

• Список разрешенных IP-адресов
• Частная сеть
• Личные домены

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

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

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

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

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

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

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

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

Ограничения на расширение

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

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

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

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

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