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


Что такое интеграция Microsoft Fabric Git?

В этой статье описывается, как интегрировать управление версиями Git с средством управления жизненным циклом приложений Microsoft Fabric (ALM).

Примечание.

Некоторые элементы для интеграции с Git доступны в предварительной версии. Дополнительные сведения см. в списке поддерживаемых элементов.

Интеграция Git в Microsoft Fabric позволяет разработчикам интегрировать свои процессы разработки, инструменты и рекомендации прямо на платформу Fabric. Это позволяет разработчикам, которые разрабатываются в Fabric:

  • Резервное копирование и версия их работы
  • Вернуться к предыдущим этапам по мере необходимости
  • Совместная работа с другими пользователями или работайте в одиночку с помощью ветвей Git
  • Применение возможностей знакомых средств управления версиями для управления элементами Fabric

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

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

  • Дополнительные сведения о процессе интеграции Git.

  • Ознакомьтесь с лучшим способом управления ветвями Git.

Сведения о конфиденциальности

Прежде чем включить интеграцию Git, ознакомьтесь со следующими заявлениями о конфиденциальности:

Поддерживаемые поставщики Git

Поддерживаются следующие поставщики Git:

Поддерживаемые элементы

В настоящее время поддерживаются следующие элементы:

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

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

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

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

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

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

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

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

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

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

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

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

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

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