Что такое интеграция Microsoft Fabric Git?
В этой статье описывается, как интегрировать управление версиями Git с средством управления жизненным циклом приложений Microsoft Fabric (ALM).
Примечание.
Некоторые элементы для интеграции с Git доступны в предварительной версии. Дополнительные сведения см. в списке поддерживаемых элементов.
Интеграция Git в Microsoft Fabric позволяет разработчикам интегрировать свои процессы разработки, инструменты и рекомендации прямо на платформу Fabric. Это позволяет разработчикам, которые разрабатываются в Fabric:
- Резервное копирование и версия их работы
- Вернуться к предыдущим этапам по мере необходимости
- Совместная работа с другими пользователями или работайте в одиночку с помощью ветвей Git
- Применение возможностей знакомых средств управления версиями для управления элементами Fabric
Интеграция с системой управления версиями находится на уровне рабочей области. Разработчики могут разрабатывать элементы версии в рабочей области в одном процессе с полной видимостью для всех своих элементов. В настоящее время поддерживается только несколько элементов, но список поддерживаемых элементов растет.
Ознакомьтесь с управлением версиями и Git, чтобы убедиться, что вы знакомы с основными понятиями Git.
Дополнительные сведения о процессе интеграции Git.
Сведения о конфиденциальности
Прежде чем включить интеграцию Git, ознакомьтесь со следующими заявлениями о конфиденциальности:
- Заявление о конфиденциальности Майкрософт
- Обзор защиты данных Azure DevOps Services
- Соглашение по защите данных GitHub
Поддерживаемые поставщики Git
Поддерживаются следующие поставщики Git:
- Git в Azure Repos с тем же клиентом , что и клиент Fabric
- GitHub
- GitHub Enterprise
Поддерживаемые элементы
В настоящее время поддерживаются следующие элементы:
- Конвейеры данных (предварительная версия)
- Lakehouse (предварительная версия)
- Записные книжки
- Отчеты с разбивкой на страницы (предварительная версия)
- Отчеты (за исключением отчетов, подключенных к семантическим моделям, размещенным в Службах Azure Analysis Services, SQL Server Analysis Services или отчетах, экспортированных Power BI Desktop, которые зависят от семантических моделей, размещенных в MyWorkspace) (предварительная версия)
- Семантические модели (за исключением push-наборов данных, динамические подключения к службам Analysis Services, модель версии 1) (предварительная версия)
- Определения заданий Spark (предварительная версия)
- Среда Spark (предварительная версия)
- Склады (предварительная версия)
Если в рабочей области или каталоге Git нет неподдерживаемых элементов, он по-прежнему может быть подключен, но неподдерживаемые элементы игнорируются. Они не сохраняются или синхронизируются, но они не удаляются. Они отображаются на панели управления версиями, но их нельзя зафиксировать или обновить.
Рекомендации и ограничения
Общие ограничения интеграции Git
- Метод проверки подлинности в Fabric должен быть не менее строгим, чем метод проверки подлинности для Git. Например, если Git требует многофакторной проверки подлинности, Структура должна также требовать многофакторную проверку подлинности.
- В настоящее время наборы данных Power BI, подключенные к службам Analysis Services, не поддерживаются.
- Рабочие области с установленными приложениями-шаблонами не могут быть подключены к Git.
- Независимые облака не поддерживаются.
- Учетная запись Azure DevOps должна быть зарегистрирована для того же пользователя, который использует рабочую область Fabric.
- Администратор клиента должен включить перекрестный экспорт , если рабочая область и репозиторий Git находятся в двух разных географических регионах.
- Размер фиксации ограничен 125 МБ.
Ограничения GitHub Enterprise
Некоторые параметры GitHub Enterprise не поддерживаются. Например:
- Список разрешенных IP-адресов
- Частная сеть
- Личные домены
Ограничения рабочей области
- Только администратор рабочей области может управлять подключениями к репозиторию 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.
- Изменение файла определения элемента вручную. Эти изменения допустимы, но могут отличаться от того, что сделано через редакторы. Например, если вы переименовываете столбец семантической модели в Git и импортируете это изменение в рабочую область, при следующем фиксации изменений в семантической модели файл bim будет регистрироваться как измененный и измененный столбец, отложенный к задней части массива
- Обновление семантической модели с помощью API расширенного обновления вызывает дифф Git после каждого обновления.