Общие сведения об интеграции Git (предварительная версия)
В этой статье описывается, как интегрировать управление версиями Git с средством управления жизненным циклом приложений Fabric (ALM).
Внимание
Эта функция доступна в предварительной версии.
Интеграция 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, model версии 1).
- Определения заданий Spark
- Среда Spark
- Склады
Если в рабочей области или каталоге Git нет неподдерживаемых элементов, он по-прежнему может быть подключен, но неподдерживаемые элементы игнорируются. Они не сохраняются или синхронизируются, но они не удаляются. Они отображаются на панели управления версиями, но их нельзя зафиксировать или обновить.
Рекомендации и ограничения
Общие ограничения интеграции Git
- Метод проверки подлинности в Fabric должен быть не менее строгим, чем метод проверки подлинности для Git. Например, если Git требует многофакторной проверки подлинности, Структура должна также требовать многофакторную проверку подлинности.
- В настоящее время наборы данных Power BI, подключенные к службам Analysis Services, не поддерживаются.
- Независимые облака не поддерживаются.
- Учетная запись 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 после каждого обновления.
Связанный контент
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по