В этой статье описывается, как интегрировать управление версиями Git с средством управления жизненным циклом приложений Microsoft Fabric (ALM).
Ескерім
Некоторые элементы для интеграции с Git доступны в предварительной версии. Дополнительные сведения см. в списке поддерживаемых элементов.
Интеграция Git в Microsoft Fabric позволяет разработчикам интегрировать свои процессы разработки, инструменты и рекомендации прямо на платформу Fabric. Это позволяет разработчикам, которые работают с Fabric:
Резервное копирование и версия их работы
Вернуться к предыдущим этапам по мере необходимости
Совместная работа с другими пользователями или работайте в одиночку с помощью ветвей Git
Применяйте возможности знакомых средств управления версиями для управления элементами Fabric.
Интеграция с системой управления версиями осуществляется на уровне рабочей области. Разработчики могут версионировать элементы, которые они разрабатывают в рабочей области, единым процессом с полной видимостью всех их элементов. Структура рабочей области, включая вложенных папок, сохраняется в репозитории Git.
Отчеты (за исключением отчетов, подключенных к семантическим моделям, размещенным в службах Azure Analysis Services, SQL Server Analysis Services, или отчетов, экспортированных из Power BI Desktop, которые зависят от семантических моделей, размещенных в MyWorkspace) (предварительная версия)
Семантические модели (за исключением push-наборов данных, динамические подключения к службам Analysis Services, модель версии 1) (предварительная версия)
Если в рабочей области или каталоге Git нет неподдерживаемых элементов, он по-прежнему может быть подключен, но неподдерживаемые элементы игнорируются. Они не сохраняются или синхронизируются, но они не удаляются. Они отображаются на панели управления версиями, но их нельзя зафиксировать или обновить.
Администратор клиента должен включить перекрестный экспорт , если рабочая область и репозиторий Git находятся в двух разных географических регионах.
Если ваша организация настроила условный доступ, убедитесь в том, что для службы Power BI установлены те же условия, чтобы проверка подлинности работала как положено.
Размер фиксации ограничен 125 МБ.
Поддерживаются только облачные версии GitHub. Локальные серверы не поддерживаются.
Совокупный размер файлов для коммита ограничен 50 МБ. Таким образом, если у вас есть несколько элементов для фиксации, иногда может потребоваться разделить их на несколько отдельных фиксаций. Для получения дополнительных сведений о фиксации файлов см. наше руководство по устранению неполадок.
Ограничения GitHub Enterprise
Некоторые параметры GitHub Enterprise не поддерживаются. Например:
Только администратор рабочей области может управлять подключениями к репозиторию Git, таким как подключение, отключение или добавление ветви.
После подключения любой пользователь с разрешением может работать в рабочей области.
Ограничения ветвей и папок
Максимальная длина имени ветви составляет 244 символа.
Максимальная длина полного пути для имен файлов составляет 250 символов. Длинные имена не работают.
Максимальный размер файла составляет 25 МБ.
Структура папок поддерживается до 10 уровней.
Вы не можете скачать отчет или набор данных как PBIX из службы после их развертывания с интеграцией Git.
Если отображаемое имя элемента обладает любыми из этих характеристик, папка Git переименовывается в логический идентификатор (GUID) и тип:
Имеет более 256 символов
Заканчивается на , или пробел.
Содержит любые запрещенные символы, как описано в ограничениях имени каталога
При подключении рабочей области с папками к Git необходимо зафиксировать изменения в репозитории Git, если это структура папок отличается.
Ограничения имени каталога
Имя каталога, подключающегося к репозиторию Git, имеет следующие ограничения именования:
Имя каталога не может начинаться или заканчиваться пробелом или вкладкой.
Имя каталога не может содержать ни одного из следующих символов: "/:<>\*?|
Папка элемента (папка, содержащая файлы элементов), не может содержать ни одного из следующих символов: ":<>\*?|. Если вы переименовываете папку в одну из этих символов, Git не может подключиться или синхронизироваться с рабочей областью и возникает ошибка.
При выходе из ветвления создается новая ветвь, а параметры исходной ветви не копируются. Настройте все параметры или определения, чтобы обеспечить соответствие новым политикам вашей организации.
При переходе в существующее рабочее пространство:
Целевая рабочая область должна поддерживать подключение Git.
Пользователь должен быть администратором целевой рабочей области.
Целевая рабочая область должна иметь достаточную вместимость.
Рабочая область не может иметь приложения-шаблоны.
Обратите внимание, что при выходе из рабочей области все элементы, которые не сохраняются в Git, могут быть потеряны. Мы рекомендуем зафиксировать элементы, которые вы хотите сохранить, перед созданием новой ветки.
Ограничения синхронизации и коммита
Одновременно можно синхронизировать только в одном направлении. Вы не можете зафиксировать и обновить одновременно.
Метки конфиденциальности не поддерживаются, и экспорт элементов с метками конфиденциальности может быть отключен. Чтобы зафиксировать элементы с метками конфиденциальности без метки конфиденциальности, обратитесь к администратору за помощью.
Во время процесса фиксации в Git служба Fabric удаляет файлы в папке элемента, которые не являются частью определения элемента. Не связанные файлы, не входящие в папку элемента, не удаляются.
После фиксации изменений вы можете заметить некоторые непредвиденные изменения элемента, которые вы не вносили. Эти изменения семантически незначительны и могут произойти по нескольким причинам. Например:
Изменение файла определения элемента вручную. Эти изменения допустимы, но могут отличаться от того, что сделано через редакторы. Например, если вы переименовываете столбец семантической модели в Git и импортируете это изменение в рабочую область, при следующей фиксации изменений в семантической модели файл bim будет регистрироваться как измененный и измененный столбец будет перемещен в конец массива columns. Это связано с тем, что подсистема AS, создающая файлы bim , отправляет переименованные столбцы в конец массива. Это изменение не влияет на способ работы элемента.
Коммит файла, использующего разрывы строк CRLF. Служба использует LF (разрыв строки). Если у вас есть файлы элементов в репозитории Git с разрывами строк CRLF, при фиксации из службы эти файлы изменяются на LF. Например, если открыть отчет на рабочем столе, сохраните файл проекта (PBIP) и отправьте его в Git с помощью CRLF.
Обновление семантической модели с помощью API расширенного обновления вызывает разницу в Git после каждого обновления.