Базовое редактирование записных книжек Databricks

Записная книжка Databricks — это веб-редактор кода, который позволяет писать код и просматривать результаты интерактивного анализа данных. На этой странице рассматриваются основы использования записных книжек в Databricks, в том числе работа с панелью инструментов и выполнение различных действий с ячейками.

Создание записной книжки

Чтобы создать новый блокнот, нажмите кнопку "Создать" на боковой панели рабочей области или выберите "Создать блокнот" в любой папке.

Открытие записной книжки

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

Ячейки записной книжки

Записные книжки содержат коллекцию двух типов ячеек: ячейки кода и ячейки Markdown. Ячейки кода содержат исполняемый код. Ячейки Markdown содержат код Markdown, который отображается как текст и графика. Используйте Markdown для документа или проиллюстрируйте код. Вы можете добавить или remove ячейки любого типа в записную книжку, чтобы структурировать работу.

Можно запустить одну ячейку, группу ячеек или всю записную книжку. Ячейка записной книжки может содержать не более 10 МБ, а его выходные данные ограничены 20 МБ.

Значки и кнопки панели инструментов блокнота

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

Рядом с именем записной книжки есть кнопки, чтобы изменить язык записной книжки по умолчанию и, если записная книжка включена в папку Databricks Git, открыть диалоговое окно Git.

Чтобы просмотреть предыдущие версии ноутбука, нажмите "Последнее изменение..." сообщение справа от меню.

Значки и кнопки справа от панели инструментов описаны в следующих table:

Икона	Описание
	запустить все ячейки или остановить выполнение. Имя этой кнопки изменяется в зависимости от состояния записной книжки.
	Откройте селектор вычислений . При подключении записной книжки к кластеру или хранилищу SQL эта кнопка отображает имя вычислительного ресурса.
	Откройте планировщик заданий .
селектор DLT заголовка ноутбука	Откройте Delta Live Tables. Эта кнопка отображается только если записная книжка является частью потока данных Delta Live Tables.
кнопка	Откройте диалоговое окно разрешений.

действия правой боковой панели

На правой боковой панели записной книжки доступно несколько действий, как описано в следующих table:

Икона	Описание
	Откройте примечания записной книжки .
значок эксперимента заголовка записной книжки	Откройте в MLflow эксперимент записной книжки .
	Откройте историю версий записной книжки.
	Откройте обозреватель переменных . (Доступно для переменных Python с Databricks Runtime 12.2 LTS и выше.)
	Откройте панель среды Python. На этой панели показаны все библиотеки Python, доступные для записной книжки, включая библиотеки с областью действия записной книжки, библиотеки кластера и библиотеки, включенные в среду выполнения Databricks. Доступно только в том случае, если записная книжка подключена к кластеру.

Создание ячеек

Записные книжки имеют два типа ячеек: код и Markdown. Содержимое ячеек Markdown преобразуется в HTML. Например, этот отрывок содержит разметку для заголовка первого уровня.

%md ### Libraries
Import the necessary libraries.

Отрисовки, как показано ниже.

Чтобы создать новую ячейку, наведите указатель мыши на ячейку сверху или внизу. Щелкните код или текст, чтобы создать ячейку кода или ячейку Markdown соответственно.

кнопки

Действия ячейки

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

Запуск ячейки

Чтобы запустить ячейки кода, щелкните стрелку вниз в левом верхнем углу ячейки кода.

После запуска ячейки появится уведомление справа от меню запуска ячейки, показывающее время последнего запуска ячейки и ее длительность. Наведите указатель мыши на уведомление для получения дополнительных сведений.

Чтобы отобразить подробные сведения о выполнении по умолчанию, щелкните изображение профиля в правом верхнем углу. Затем нажмите Настройки>Разработчик>Показать подробные сведения о выполнении команды.

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

Запуск выбранных ячеек

Можно запустить одну ячейку или коллекцию ячеек. Чтобы select одну ячейку, щелкните в любом месте в ячейке. Чтобы select несколько ячеек, удерживайте клавишу Command на MacOS или клавишу Ctrl на Windows, и щёлкните по ячейке за пределами текстовой области, как показано на снимке экрана.

Чтобы запустить выбранные ячейки, щелкните Запуск>Запуск и отладка>Запуск выбранных ячеек или используйте сочетание клавиш Command + Enter в MacOS или Crtl + Enter в Windows. Поведение этой команды зависит от вычислительного ресурса, к которому подключена записная книжка.

• В вычислительном ресурсе под управлением Databricks Runtime 13.3 LTS или ниже выбранные ячейки выполняются по отдельности. Если ошибка возникает в ячейке, выполнение продолжается с последующими ячейками.
• В вычислительном ресурсе под управлением Databricks Runtime 14.0 или более поздней версии или в хранилище SQL выбранные ячейки выполняются как пакет. Любая ошибка останавливает выполнение, и вы не можете отменить выполнение отдельных ячеек. Кнопку прерывания можно использовать для остановки выполнения всех ячеек.

Запуск выделенного текста

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

1. Выделите строки, которые нужно запустить.

2. Select Выполнить > выполнить выделенный текст или использовать сочетания клавиш Ctrl+Shift+Enter. Если текст не выделен, команда Выполнить выделенный текст исполняет текущую строку.

   

Если вы используете смешанные языки в ячейке, необходимо включить строку %<language> в выделение.

Запуск выделенного текста также выполняет свернутый код, если в выделенном фрагменте есть какой-либо код.

Поддерживаются специальные команды ячеек, такие как %run, %pipи %sh.

Нельзя использовать запустить выделенный текст на ячейках с несколькими выходными вкладками (т. е. ячейками, where вы определили профиль данных или визуализацию).

Значки ячеек

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

значки ячейки в правом верхнем углу

селектор языка:Select язык ячейки.

Помощник Databricks: Активация или деактивация Помощника Databricks для подсказок кода в ячейке.

Фокус на ячейке : Растянуть ячейку, чтобы упростить редактирование.

Меню действий ячейки: Открыть меню действий ячейки. Параметры в этом меню немного отличаются для ячеек кода и Markdown.

меню действий ячейки

Удаление ячейки

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

значок корзины ячейки

Перемещение ячейки

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

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

Вырезать, копировать и вставлять ячейки

Существует несколько вариантов для вырезания и копирования ячеек. Однако если вы используете браузер Safari, доступны только сочетания клавиш.

• В меню действий ячейки selectвыберите«Вырезать ячейку» или «Копировать ячейку».
• Используйте сочетания клавиш: Command-X или Ctrl-X для вырезания и Command-C или Ctrl-C для копирования.
• Используйте меню "Редактирование" в верхней части блокнота. Select вырезать или копировать.

После вырезания или копирования ячеек вы можете вставить их в другие места блокнота, в другой блокнот или блокнот на другой вкладке браузера или window. Чтобы вставить ячейки, используйте сочетания клавиш Command-V или Ctrl-V. Ячейки вставляются под текущей ячейкой.

Чтобы отменить действия выреза или вставки, можно использовать сочетания клавиш Command-Z или Ctrl-Z или параметры меню "Изменить > отменить вырезанные ячейки" или "Изменить > отменить вставку ячеек".

Чтобы select смежных ячеек, щелкните ячейку Markdown, а затем используйте SHIFT + вверх или вниз, чтобы select ячейки выше или ниже. Используйте меню редактирования, чтобы скопировать, вырезать, вставить или удалить выбранные ячейки в качестве группы. Чтобы select всех ячеек, selectизменить >Select всех ячеек или использовать ярлык режима команд Cmd+A.

Добавление комментариев к коду

Чтобы добавить комментарий к коду в ячейке, выделите код. Справа от ячейки появится значок комментария. Щелкните значок, чтобы открыть поле комментариев.

Добавьте ячейку на панель мониторинга

Чтобы добавить ячейку Markdown или ячейку с табличными результатами на панель мониторинга, selectДобавить на панель мониторинга из меню действий ячейки. Дополнительные сведения см. в панелях мониторинга в записных книжках.

Ссылка на ячейку

Чтобы get ссылку URL-адреса на определенную команду в записной книжке, щелкните значок фокуса , чтобы открыть режим фокуса и скопировать URL-адрес из адресной строки браузера. Чтобы выйти из режима фокусировки, щелкните значок выхода из фокуса ячейки .

Помощник по Open Databricks

Чтобы открыть текстовое поле Помощника Databricks в ячейке, щелкните значок в правом верхнем углу ячейки.

Его можно использовать в ячейке кода, чтобы get справку или предложения для кода. Помощник по Databricks должен быть активирован в рабочей области.