Управление версиями записной книжки и развертывание
В этой статье объясняется, как работают конвейеры интеграции и развертывания Git для записных книжек в Microsoft Fabric. Узнайте, как настроить подключение к репозиторию, управлять записными книжками и развертывать их в разных средах.
Интеграция с Записной книжкой Git
Записные книжки Fabric предлагают интеграцию Git для управления версиями с Azure DevOps. Благодаря интеграции с Git вы можете создать резервную копию и версию записной книжки, вернуться к предыдущим этапам при необходимости, работать в одиночку с помощью ветвей Git и полностью управлять жизненным циклом содержимого записной книжки в Fabric.
Примечание.
Начиная с октября 2024 г. интеграция Git Notebook поддерживает сохранение связи сопоставления присоединенной среды при синхронизации с новой рабочей областью, что означает, что при фиксации записной книжки и подключенной среды вместе с репозиторием Git и синхронизации ее с другой рабочей областью создается записная книжка и среда будут привязаны друг к другу. Это обновление будет влиять на существующие записные книжки и зависимые среды, версии которых используются в Git, физический идентификатор подключенной среды в содержимом метаданных записной книжки будет заменен логическим идентификатором, изменение будет отражено в представлении диффа.
Настройка подключения
В параметрах рабочей области можно легко настроить подключение к репозиторию для фиксации и синхронизации изменений. Сведения о настройке подключения см. в статье "Начало работы с интеграцией Git". После подключения элементы, включая записные книжки, отображаются на панели управления версиями .
После успешной фиксации экземпляров записной книжки в репозитории Git вы увидите структуру папок записной книжки в репозитории.
Теперь можно выполнять будущие операции, такие как создание запроса на вытягивание.
Представление записной книжки в Git
На следующем рисунке показан пример структуры файлов каждого элемента записной книжки в репозитории:
При фиксации элемента записной книжки в репозиторий Git код записной книжки преобразуется в формат исходного кода вместо стандартного IPYNB-файла. Например, записная книжка PySpark преобразуется в файл notebook-content.py. Этот подход позволяет упростить проверки кода с помощью встроенных функций диффа.
В исходном файле содержимого элемента метаданные (включая среду озера по умолчанию и присоединенную среду), ячейки markdown и ячейки кода сохраняются и различаются. Этот подход поддерживает точное восстановление при синхронизации с рабочей областью Fabric.
Выходные данные ячейки записной книжки не включаются при синхронизации с Git.
Примечание.
- В настоящее время файлы в ресурсах Notebook не фиксируется в репозитории. Фиксация этих файлов поддерживается в предстоящем выпуске.
- Мы рекомендуем управлять записными книжками и их зависимой средой в одной рабочей области и использовать Git для управления версиями записных книжек и элементов среды , система Fabric Git будет обрабатывать связь сопоставления при синхронизации записной книжки и подключенной среды к новым рабочим областям.
- Идентификатор lakehouse по умолчанию сохраняется в записной книжке при синхронизации репозитория с рабочей областью Fabric. При фиксации записной книжки с помощью lakehouse по умолчанию необходимо ссылаться на только что созданный элемент Lakehouse вручную. Дополнительные сведения см. в статье об интеграции с Lakehouse Git.
Записная книжка в конвейерах развертывания
Конвейер развертывания также можно использовать для развертывания кода записной книжки в разных средах, таких как разработка, тестирование и рабочая среда. Эта функция позволяет упростить процесс разработки, обеспечить качество и согласованность и уменьшить количество ошибок вручную с помощью упрощенных операций с низким кодом. Вы также можете использовать правила развертывания для настройки поведения записных книжек при их развертывании, таких как изменение хранилища записных книжек по умолчанию.
Примечание.
- Теперь вы используете новый дизайн конвейера развертывания, старый пользовательский интерфейс можно получить, отключив "Новый конвейер развертывания".
- Начиная с октября записная книжка Fabric поддерживает функцию автоматической привязки, которая привязывает среду lakehouse по умолчанию и присоединенную среду в той же рабочей области при развертывании на следующем этапе. Это изменение влияет на существующие записные книжки в конвейере развертывания.
- Среда lakehouse по умолчанию и присоединенная среда (когда все зависимые элементы находятся в одной рабочей области) будут заменены новыми созданными элементами в целевой рабочей области, изменение метаданных записной книжки будет выделено в представлении диффа в следующем раунде развертывания.
- Вы можете задать правила развертывания для lakehouse по умолчанию, чтобы переопределить автоматически привязанный lakehouse.
- Известная проблема: состояние замороженной ячейки в записной книжке будет потеряно во время развертывания. Сейчас мы работаем над связанными задачами.
Выполните следующие действия, чтобы завершить развертывание записной книжки с помощью конвейера развертывания.
Создайте новый конвейер развертывания или откройте существующий конвейер развертывания. (Дополнительные сведения см. в разделе Начало работы с конвейерами развертывания.)
Назначьте рабочие области различным этапам в соответствии с целями развертывания.
Выбор, просмотр и сравнение элементов, включая записные книжки между различными этапами, как показано в следующем примере. Выделенный значок, указывающий количество измененных элементов между предыдущим этапом и текущим этапом.
Выберите "Развернуть" , чтобы развернуть записные книжки на этапах разработки, тестирования и рабочей среды.
(Необязательно.) Вы можете выбрать правила развертывания, чтобы создать правила развертывания для процесса развертывания. Запись правил развертывания находится на целевом этапе процесса развертывания.
Fabric поддерживает параметризацию lakehouse по умолчанию для каждого экземпляра записной книжки при развертывании с помощью правил развертывания. Три варианта доступны для указания целевого озера по умолчанию: то же самое с исходным лейкхаусом, N/A(нет по умолчанию lakehouse) и другими озерами.
Вы можете добиться защищенной изоляции данных, настроив это правило. Хранилище озера по умолчанию записной книжки заменяется тем, который вы указали в качестве целевого объекта во время развертывания.
Примечание.
При установке по умолчанию lakehouse в правилах развертывания идентификатор Lakehouse должен иметься. Идентификатор lakehouse можно получить по ссылке URL-адреса элемента. Правила развертывания имеют более высокий приоритет, чем автоматическая привязка, автоматически привязанный lakehouse будет перезаписан при настройке правила развертывания.
Отслеживайте состояние развертывания из журнала развертывания.
