Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье описывается, как интегрировать управление версиями Git с средством управления жизненным циклом приложений Microsoft Fabric (ALM).
Примечание.
Некоторые элементы для интеграции с Git доступны в предварительной версии. Дополнительные сведения см. в списке поддерживаемых элементов.
Интеграция Git в Microsoft Fabric позволяет разработчикам интегрировать свои процессы разработки, инструменты и рекомендации прямо на платформу Fabric. Это позволяет разработчикам, которые работают с Fabric:
- Создание резервных копий и учет версий их работы
- Вернуться к предыдущим этапам по мере необходимости
- Совместная работа с другими пользователями или работайте в одиночку с помощью ветвей Git
- Применяйте возможности знакомых средств управления версиями для управления элементами Fabric.
Интеграция с системой управления версиями осуществляется на уровне рабочей области. Разработчики могут версионировать элементы, которые они разрабатывают в рабочей области, единым процессом с полной видимостью всех их элементов. Структура рабочей области, включая вложенных папок, сохраняется в репозитории Git.
См. список поддерживаемых элементов.
Ознакомьтесь с основными понятиями Git и управления версиями .
Дополнительные сведения о процессе интеграции Git.
Ознакомьтесь с лучшим способом управления ветвями Git.
Сведения о конфиденциальности
Прежде чем включить интеграцию Git, ознакомьтесь со следующими заявлениями о конфиденциальности:
- Заявление о конфиденциальности Майкрософт
- Обзор защиты данных Azure DevOps Services
- Соглашение по защите данных GitHub
Поддерживаемые поставщики Git
Поддерживаются следующие поставщики Git:
- Azure DevOps с тем же арендатором, что и арендатор Fabric
- GitHub (только облачные версии)
- GitHub Enterprise (только облачные версии)
Поддерживаемые элементы
Следующие элементы в настоящее время поддерживают интеграцию Git:
Элементы инженерии данных
- Окружающая среда
- GraphQL(предварительная версия)
- Lakehouse(предварительная версия)
- Ноутбуки
- Определения заданий Spark(предварительная версия)
- Функции пользовательских данных (предварительная версия)
Элементы фабрики данных:
- Копировальная задача(предварительный просмотр)
- Поток данных 2-го поколения
- Конвейер данных
- Зеркальная база данных
- Установка ADF (предварительная версия)
- Библиотека переменных(предварительная версия)
Элементы аналитики в режиме реального времени:
- Активатор(предварительная версия)
- Eventhouse
- EventStream
- База данных KQL
- Набор запросов KQL
- Панель мониторинга в режиме реального времени
Элементы хранилища данных:
- Warehouse(preview)
Элементы Power BI:
- Набор метрик (предварительная версия)
- Приложение организации(предварительная версия)
- Отчет с разбивкой на страницы(предварительная версия)
- Отчет (за исключением отчетов, подключенных к семантическим моделям, размещенным в Службах Azure Analysis Services, службах SQL Server Analysis Services или отчетах, экспортированных Power BI Desktop, которые зависят от семантических моделей, размещенных в MyWorkspace) (предварительная версия)
- Семантическая модель (за исключением push-наборов данных, динамических подключений к службам Analysis Services, model v1) (предварительная версия)
Элементы базы данных:
- База данных SQL(предварительная версия)
Отраслевые решения:
- Здравоохранение(предварительная версия)
- Cohort HealthCare (предварительная версия)
Если в рабочей области или каталоге Git нет неподдерживаемых элементов, он по-прежнему может быть подключен, но неподдерживаемые элементы игнорируются. Они не сохраняются или синхронизируются, но они не удаляются. Они отображаются на панели контроля версий, но их нельзя зафиксировать или обновить.
Рекомендации и ограничения
Общие ограничения интеграции Git
- Метод проверки подлинности в Fabric должен быть не менее строгим, чем метод проверки подлинности для Git. Например, если Git требует многофакторной проверки подлинности, Структура должна также требовать многофакторную проверку подлинности.
- В настоящее время наборы данных Power BI, подключенные к службам Analysis Services, не поддерживаются.
- Если вы используете идентификатор рабочей области в одном артефакте и фиксируете его в Git, его можно обновить обратно в рабочую область fabric только в той рабочей области, которая подключена к тому же идентификатору. Будьте осторожны, так как это также влияет на такие функции, как разветвление.
- Подмодулы не поддерживаются.
- Независимые облака не поддерживаются.
- Учетная запись Azure DevOps должна быть зарегистрирована для того же пользователя, который использует рабочую область Fabric.
- Azure DevOps не поддерживается, если включена проверка политики условного доступа IP .
- Администратор клиента должен включить перекрестный экспорт , если рабочая область и репозиторий Git находятся в двух разных географических регионах.
- Если ваша организация настроила условный доступ, убедитесь, что служба Power BI имеет те же условия, необходимые для корректной аутентификации.
- Размер коммита ограничен 125 МБ.
Ограничения GitHub Enterprise
Некоторые версии и параметры GitHub Enterprise не поддерживаются. Например:
- GitHub Enterprise Cloud с локализацией данных (ghe.com)
- GitHub Enterprise Server с пользовательским доменом не поддерживается, даже если экземпляр доступен публично.
- Github Enterprise Server, размещенный в частной сети
- Список разрешенных IP-адресов
Ограничения рабочей области
- Только администратор рабочей области может управлять подключениями к репозиторию Git , таким как подключение, отключение или добавление ветви.
После подключения любой пользователь с разрешением может работать в рабочей области. - Рабочие области с установленными приложениями-шаблонами не могут быть подключены к Git.
- MyWorkspace не может подключиться к поставщику Git.
Ограничения ветвей и папок
- Максимальная длина имени ветви составляет 244 символа.
- Максимальная длина полного пути для имен файлов составляет 250 символов. Длинные имена не работают.
- Максимальный размер файла составляет 25 МБ.
- Структура папок поддерживается до 10 уровней.
- Скачивание отчета или набора данных в виде PBIX из службы после их развертывания с интеграцией Git не рекомендуется, так как результаты ненадежны. Мы рекомендуем использовать PowerBI Desktop для скачивания отчетов и наборов данных в виде PBIX.
- Если отображаемое имя элемента обладает любыми из этих характеристик, папка Git переименовывается в логический идентификатор (GUID) и тип:
- При подключении рабочей области с папками к Git необходимо зафиксировать изменения в репозитории Git, если эта структура папок отличается.
Ограничения имени каталога
Имя каталога, подключающегося к репозиторию Git, имеет следующие ограничения именования:
- Имя каталога не может начинаться или заканчиваться пробелом или вкладкой.
- Имя каталога не может содержать следующие символы: "/:<>\*|
Папка элемента (папка, содержащая файлы элементов), не может содержать ни одного из следующих символов: ":<>\*?|". Если вы переименовываете папку в одну из этих символов, Git не может подключиться или синхронизироваться с рабочей областью и возникает ошибка.
Ограничения роста и ветвления
- Для ветвления требуются разрешения, перечисленные в таблице разрешений.
- Для этой операции должна быть доступна возможность.
- Все ограничения именования рабочих областей и ветвей применяются при разветвлении в новую рабочую область.
- В новой рабочей области доступны только элементы, поддерживаемые Git.
- В списке связанных ветвей отображаются только ветви и рабочие области, которые у вас есть разрешение на просмотр.
- Интеграция Git должна быть включена.
- При выходе из ветвления создается новая ветвь, а параметры исходной ветви не копируются. Настройте все параметры или определения, чтобы обеспечить соответствие новым политикам вашей организации.
- При переходе в существующее рабочее пространство:
- Целевая рабочая область должна поддерживать подключение 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 после каждого обновления.