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

По умолчанию записные книжки в Databricks создаются в формате .ipynb (IPython или Jupyter). Вместо этого можно использовать исходный формат.

Вы по-прежнему можете импортировать и экспортировать записные книжки в различных форматах. См. статью "Импорт и экспорт записных книжек Databricks".

Форматы записных книжек

Databricks поддерживает создание и редактирование записных книжек в двух форматах: IPYNB (по умолчанию) и источник.

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

Формат источника блокнота	Описание
источник	Базовый формат, который записывает только исходный код с суффиксом, который сигнализирует языку кода, например .py, .scala, .r и .sql.
IPYNB (Jupyter)	Богатый формат, который включает исходный код, среду записной книжки, определения визуализаций, виджеты для записной книжки и опциональные выходные данные. Ноутбук IPYNB может содержать код на любом языке, который поддерживается в ноутбуках Databricks (вопреки части pyиз .ipynb). Используя формат IPYNB, вы можете при необходимости версионировать результаты работы записной книжки наряду с самой записной книжкой.

Формат IPYNB также поддерживает более эффективное просмотр записных книжек Databricks в удаленных репозиториях Git. Если вы используете GitHub или GitLab, вы можете включить функции, которые предоставляют расширенные диффы записных книжек в запросах на вытягивание, что упрощает просмотр и просмотр изменений кода в записной книжке.

Дополнительные сведения о поддержке GitHub расширенных диффов записных книжек IPYNB см. в статье Feature Preview: Rich Jupyter Notebook Diffs. Дополнительные сведения о поддержке GitLab для диффов файлов IPYNB см. в разделе файлы Jupyter Notebook.

Чтобы отличить записные книжки исходного формата от обычных Python, Scala и SQL-файлов, Azure Databricks добавляет комментарий "Databricks notebook source" в начало Python, Scala и записных книжек SQL. Этот комментарий гарантирует, что Azure Databricks правильно анализирует файл как записную книжку, а не файл скрипта.

Изменение параметра формата записной книжки по умолчанию

Записные книжки IPYNB — это формат по умолчанию при создании записной книжки на Azure Databricks.

Чтобы изменить формат источника Azure Databricks по умолчанию, войдите в рабочую область Azure Databricks, щелкните профиль в правом верхнем углу страницы, а затем щелкните Settings и перейдите к Developer. В разделе «Editor settings»>Общие установите для параметра Формат файла по умолчанию для блокнотов значение Source (.py, .sql, .scala, .r).

Преобразование формата записной книжки

Вы можете преобразовать существующую записную книжку в другой формат с помощью пользовательского интерфейса Azure Databricks.

Чтобы преобразовать существующую записную книжку в другой формат:

1. Откройте записную книжку в рабочей области.

2. Выберите "Файл" в меню рабочей области, выберите формат записной книжки и выберите нужный формат. Вы можете выбрать либо Jupyter (.ipynb) (рекомендуется), либо исходный код (.scala, .py, .sql, .r). Текущий формат записной книжки отображается серым цветом и имеет галочку рядом с ним.

   

Дополнительные сведения о типах записных книжек, поддерживаемых в Azure Databricks, см. статью Импорт и экспорт записных книжек Databricks.

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

Выходные данные — это результаты выполнения блокнота на платформе Databricks, включая отображение таблиц и визуализации. Для записных книжек IPYNB в папках, управляемых источником, можно управлять фиксацией выходных данных записной книжки в удаленном репозитории.

Разрешить сохранение выходных данных записной книжки .ipynb

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

1. Кликните на своё имя пользователя в верхней панели рабочей области Azure Databricks и выберите параметры.

2. В разделе «Администрирование рабочего пространства» нажмите «Разработка».

3. В разделе Repos установите Allow repos to export IPYNB output в Allow: выводы IPYNB можно включать и выключать.

   

Важный

Если результаты включены, то конфигурации визуализации и панели мониторинга включаются в создаваемые вами записные книжки .ipynb.

Контроль фиксирования выходных артефактов записной книжки IPYNB

Конфигурационный файл .databricks/commit_outputs в вашем репозитории управляет, какие .ipynb выводы из ноутбука фиксируются. После того как администратор рабочего пространства разрешит коммиты вывода, вы можете создать этот файл из диалога Git:

1. Откройте диалог Git для папки Git, в которой есть .ipynb ноутбук, но нет .databricks/commit_outputs файла.

2. В информационном оповещении вверху диалога нажмите Создать конфигурационный файл commit_outputs.

   

Вы также можете использовать меню «Файл» для включения или исключения выводов для конкретного блокнота IPYNB. Если конфигурационного файла нет, Azure Databricks создаёт его, когда вы сделаете выбор. Используйте эту опцию, если вы отклонили оповещение в диалоге Git.

1. В меню «Файл» выберите «Закоммитить вывод notebook». Пункт меню доступен только для IPYNB-ноутбуков в папке Git после того, как администратор workspace разрешит коммиты выходных данных.

   

2. В диалоговом окне настройки Commit outputs выберите Включить выходы или Исключить выходы, затем нажмите Change.