Share via

Управление версиями записной книжки и развертывание

  • Статья

В этой статье объясняется, как работают конвейеры интеграции и развертывания Git для записных книжек в Microsoft Fabric. Узнайте, как настроить подключение к репозиторию, управлять записными книжками и развертывать их в разных средах.

Интеграция с Записной книжкой Git

Записные книжки Fabric предлагают интеграцию Git для управления версиями с Azure DevOps. Благодаря интеграции с Git вы можете создать резервную копию и версию записной книжки, отменить изменения на предыдущие этапы при необходимости, совместно работать или работать в одиночку с помощью ветвей Git и полностью управлять жизненным циклом содержимого записной книжки в Fabric.

Важно!

Эта функция доступна в предварительной версии.

Настройка подключения

В параметрах рабочей области можно легко настроить подключение к репозиторию для фиксации и синхронизации изменений. Сведения о настройке подключения см. в статье "Начало работы с интеграцией Git". После подключения элементы, включая записные книжки, отображаются на панели управления версиями .

Screenshot of workspace source control panel.

После успешной фиксации экземпляров записной книжки в репозитории Git вы увидите структуру папок записной книжки в репозитории.

Теперь можно выполнять будущие операции, такие как создание запроса на вытягивание.

Представление записной книжки в Git

На следующем рисунке показан пример структуры файлов каждого элемента записной книжки в репозитории:

Screenshot of notebook Git repo file structure.

При фиксации элемента записной книжки в репозиторий Git код записной книжки преобразуется в формат исходного кода вместо стандартного IPYNB-файла. Например, записная книжка PySpark преобразуется в файл notebook-content.py. Этот подход позволяет упростить проверки кода с помощью встроенных функций диффа.

В исходном файле содержимого элемента метаданные (включая среду озера по умолчанию и присоединенную среду), ячейки markdown и ячейки кода сохраняются и различаются. Этот подход поддерживает точное восстановление при синхронизации с рабочей областью Fabric.

Выходные данные ячейки записной книжки не включаются при синхронизации с Git.

Screenshot of notebook Git repo content format.

Примечание.

  • В настоящее время файлы в ресурсах Notebook не фиксируется в репозитории. Фиксация этих файлов поддерживается в предстоящем выпуске.
  • Присоединенная среда сохраняется в записной книжке при синхронизации из репозитория с рабочей областью Fabric. В настоящее время справочные среды между рабочими областями не поддерживаются. Чтобы запустить записную книжку, необходимо вручную подключиться к новой среде или параметрам рабочей области по умолчанию.
  • Идентификатор lakehouse по умолчанию сохраняется в записной книжке при синхронизации репозитория с рабочей областью Fabric. При фиксации записной книжки с помощью lakehouse по умолчанию необходимо ссылаться на только что созданный элемент Lakehouse вручную. Дополнительные сведения см. в статье об интеграции с Lakehouse Git.

Записная книжка в конвейерах развертывания

Конвейер развертывания также можно использовать для развертывания кода записной книжки в разных средах, таких как разработка, тестирование и рабочая среда. Эта функция позволяет упростить процесс разработки, обеспечить качество и согласованность и уменьшить количество ошибок вручную с помощью упрощенных операций с низким кодом. Вы также можете использовать правила развертывания для настройки поведения записных книжек при их развертывании, таких как изменение хранилища записных книжек по умолчанию.

Важно!

Эта функция доступна в предварительной версии.

Выполните следующие действия, чтобы завершить развертывание записной книжки с помощью конвейера развертывания.

  1. Создайте новый конвейер развертывания или откройте существующий конвейер развертывания. (Дополнительные сведения см. в разделе Начало работы с конвейерами развертывания.)

  2. Назначьте рабочие области различным этапам в соответствии с целями развертывания.

  3. Выбор, просмотр и сравнение элементов, включая записные книжки между различными этапами, как показано в следующем примере.

    Screenshot of notebook in deployment pipeline.

  4. Выберите "Развернуть" , чтобы развернуть записные книжки на этапах разработки, тестирования и рабочей среды.

  5. (Необязательно.) Вы можете выбрать правила развертывания, чтобы создать правила развертывания для процесса развертывания. Запись правил развертывания находится на целевом этапе процесса развертывания.

    Screenshot of deployment rules entry.

    Fabric поддерживает параметризацию lakehouse по умолчанию для каждого экземпляра записной книжки при развертывании с помощью правил развертывания. Три варианта доступны для указания целевого озера по умолчанию: то же самое с исходным лейкхаусом, N/A и другими озерами.

    Screenshot of set default lakehouse.

    Вы можете добиться защищенной изоляции данных, настроив это правило. Хранилище озера по умолчанию записной книжки заменяется тем, который вы указали в качестве целевого объекта во время развертывания.

    Примечание.

    При выборе внедрения других озерных домов в целевой среде идентификатор Lakehouse является обязательным. Идентификатор lakehouse можно найти по ссылке URL-адреса lakehouse.

  6. Отслеживайте состояние развертывания из журнала развертывания.

Связанный контент