Интерфейс и элементы управления записной книжки Databricks
Панель инструментов записной книжки содержит меню и значки, которые можно использовать для управления и редактирования записной книжки.
Рядом с именем записной книжки находятся кнопки, позволяющие изменить язык записной книжки по умолчанию и, если записная книжка включена в папку Databricks Git, откройте диалоговое окно Git.
Чтобы просмотреть предыдущие версии записной книжки , нажмите кнопку "Последняя правка..." сообщение справа от меню.
Обновленная конструкция ячеек
Внимание
Эта функция предоставляется в режиме общедоступной предварительной версии.
Доступна обновленная конструкция ячеек. На этой странице содержатся сведения об использовании обеих версий структуры ячеек. Ориентация на новый пользовательский интерфейс и ответы на распространенные вопросы см. в статье "Ориентация на новый пользовательский интерфейс ячейки".
Чтобы включить или отключить новую структуру ячеек, откройте страницу параметров редактора в рабочей области. На боковой панели щелкните "Разработчик". В разделе "Экспериментальные функции" переключите пользовательский интерфейс новой ячейки.
Ячейки записной книжки
Записные книжки содержат коллекцию двух типов ячеек: ячейки кода и ячейки Markdown. Ячейки кода содержат исполняемый код. Ячейки Markdown содержат код Markdown, который отображается в тексте и графике при выполнении ячейки и может использоваться для документирования или иллюстрации кода. Вы можете добавить или удалить ячейки в записную книжку, чтобы структурировать свою работу.
Вы можете одновременно запустить одну ячейку, группу ячеек или запустить всю записную книжку. Ячейка записной книжки может содержать не более 10 МБ. Выходные данные ячейки записной книжки ограничены 20 МБ.
Значки и кнопки панели инструментов записной книжки
Значки и кнопки справа от панели инструментов описаны в следующей таблице:
| Icon | Description |
|---|---|
  |
Выполните все ячейки или остановите выполнение. Имя этой кнопки изменяется в зависимости от состояния записной книжки. |
 |
Откройте селектор вычислений. При подключении записной книжки к кластеру или хранилищу SQL эта кнопка отображает имя вычислительного ресурса. |
 |
Откройте планировщик заданий. |
 |
Откройте разностные динамические таблицы. Эта кнопка отображается только в том случае, если записная книжка является частью конвейера разностных динамических таблиц. |
 |
Диалоговое окно открытия разрешений. |
Действия правой боковой панели
Несколько действий доступны на правой боковой панели записной книжки, как описано в следующей таблице:
| Icon | Description |
|---|---|
 |
Откройте примечания записной книжки. |
 |
Откройте эксперимент с записной книжкой MLflow. |
 |
Откройте журнал версий записной книжки. |
 |
Откройте обозреватель переменных. (Доступно для переменных Python с Databricks Runtime 12.2 LTS и выше.) |
 |
Откройте панель среды Python. На этой панели показаны все библиотеки Python, доступные для записной книжки, включая библиотеки, область записные книжки, библиотеки кластера и библиотеки, включенные в среду выполнения Databricks. Доступно только в том случае, если записная книжка подключена к кластеру. |
Обзор данных
Внимание
Эта функция предоставляется в режиме общедоступной предварительной версии.
Чтобы просмотреть таблицы и тома, доступные для использования в записной книжке, щелкните 
в левой части записной книжки, чтобы открыть браузер схемы. Дополнительные сведения см. в разделе "Обзор данных ".
Меню действий ячейки
Меню действий ячейки позволяет вырезать и копировать ячейки, перемещать ячейки в записной книжке и скрывать код или результаты. Меню имеет другой внешний вид в исходном пользовательском интерфейсе и новом пользовательском интерфейсе. В этом разделе содержатся инструкции для обеих версий.
Если Помощник databricks включен в рабочей области, его можно использовать в ячейке кода, чтобы получить справку или предложения для кода. Чтобы открыть текстовое поле Помощника Databricks в ячейке, щелкните значок 
Помощника Databricks в правом верхнем углу ячейки.
Можно легко изменить ячейку между кодом и markdown или изменить язык ячейки кода с помощью кнопки языка ячейки в правом верхнем углу ячейки.
Меню действий ячейки (исходный пользовательский интерфейс)
В этом меню можно также запустить ячейки кода:
Меню действий ячейки также включает кнопки, позволяющие скрыть ячейку 
или удалить ячейку 
.
Для ячеек Markdown также можно добавить ячейку на панель мониторинга. Дополнительные сведения см. в разделе "Панели мониторинга" в записных книжках.
Работа с ячейками в новом пользовательском интерфейсе
На следующем снимках экрана описаны значки, которые отображаются в правом верхнем углу ячейки записной книжки:
Селектор языка: выберите язык для ячейки.
Помощник по Databricks: включение или отключение помощника Databricks для предложений кода в ячейке.
Фокус ячейки: увеличьте ячейку, чтобы упростить редактирование.
Отображение меню действий ячейки: откройте меню действий ячейки. Параметры в этом меню немного отличаются для ячеек кода и Markdown.
Чтобы запустить ячейки кода в новом пользовательском интерфейсе, щелкните стрелку вниз в верхнем левом углу ячейки кода.
После запуска ячейки появится уведомление справа от меню запуска ячейки, показывающее время последнего запуска ячейки и длительность выполнения. Наведите указатель мыши на уведомление для получения дополнительных сведений.
Чтобы добавить ячейку Markdown или ячейку с табличными результатами на панель мониторинга, выберите " Добавить на панель мониторинга " в меню действий ячейки. Дополнительные сведения см. в разделе "Панели мониторинга" в записных книжках.
Чтобы удалить ячейку, щелкните значок корзины справа от ячейки. Этот значок отображается только при наведении курсора на ячейку.
Чтобы добавить комментарий к коду в ячейке, выделите код. Справа от ячейки появится значок комментария. Щелкните значок, чтобы открыть поле комментариев.
Чтобы переместить ячейку вверх или вниз, щелкните и удерживайте 
ее за пределами левого верхнего угла ячейки и перетащите ее в новое расположение. Вы также можете выбрать "Переместить вверх " или "Переместить вниз " в меню действий ячейки.
Создание ячеек
Записные книжки имеют два типа ячеек: код и Markdown. Содержимое ячеек Markdown отрисовывается в HTML. Например, этот фрагмент кода содержит разметку для заголовка первого уровня:
%md ### Libraries
Import the necessary libraries.
отрисовывается, как показано ниже.
Создание ячейки (исходный пользовательский интерфейс)
Чтобы создать новую ячейку в исходном пользовательском интерфейсе, наведите указатель мыши на ячейку в верхней или нижней части и щелкните 
значок. Вы также можете использовать меню ячейки записной книжки: нажмите кнопку 
"Добавить ячейку выше" или "Добавить ячейку ниже".
Для ячейки кода просто введите код в ячейку. Чтобы создать ячейку Markdown, выберите Markdown из кнопки языка ячейки или введите %md в верхней части ячейки.
Создание ячейки (новый пользовательский интерфейс)
Чтобы создать ячейку в новом пользовательском интерфейсе, наведите указатель мыши на ячейку сверху или внизу. Щелкните "Код" или "Текст", чтобы создать код или ячейку Markdown соответственно.
Вырезка, копирование и вставка ячеек
Существует несколько вариантов для выреза и копирования ячеек. Если вы используете браузер Safari, доступны только сочетания клавиш.
- В меню действий ячейки в исходном пользовательском интерфейсе или новом пользовательском интерфейсе выберите "Вырезать ячейку" или "Копировать ячейку".
- С помощью сочетаний клавиш:
Command-XилиCtrl-Xдля вырезки иCommand-CилиCtrl-Cдля копирования. - С помощью меню Правка в верхней части записной книжки. Выберите "Вырезать" или "Копировать".
После вырезки или копирования ячеек их можно вставить в другое место записной книжки, в другую записную книжку или в записную книжку на другой вкладке браузера или в другом окне. Чтобы вставить ячейки, используйте клавиши Command-V или Ctrl-V. Ячейки вставляются под текущей ячейкой.
Для отмены действий выреза или вставки можно использовать сочетания клавиш Command-Z или параметры меню "Изменить > вырезанные ячейки" или Ctrl-Z"Изменить > ячейки отмены".
Чтобы выбрать смежные ячейки, щелкните ячейку Markdown и нажмите клавиши SHIFT + ВВЕРХ или ВНИЗ, чтобы выбрать ячейки выше или ниже. Используйте меню редактирования, чтобы скопировать, вырезать, вставить или удалить выбранные ячейки в качестве группы. Чтобы выбрать все ячейки, нажмите кнопку "Изменить > все ячейки " или используйте сочетание клавиш cmd+A.
Оглавление записной книжки
Чтобы отобразить автоматически сформированное оглавление, щелкните значок в верхнем левом углу записной книжки (между левой боковой панелью и самой верхней ячейкой). Оглавление создается на основе заголовков Markdown, используемых в записной книжке. Если вы используете новый пользовательский интерфейс, ячейки с заголовками также отображаются в оглавлении.
Параметры отображения ячеек
Существует три варианта отображения записных книжек. Используйте меню "Вид", чтобы изменить параметр отображения.
- Стандартное представление: результаты отображаются сразу после ячеек кода.
- Только результаты: отображаются только результаты.
- Параллельно: ячейки кода и результатов отображаются параллельно.
В новом пользовательском интерфейсе действия доступны из значков в области ячейки (область справа и слева от ячейки). Например, чтобы переместить ячейку вверх или вниз, используйте точки захвата в левой области. Чтобы удалить ячейку, используйте значок корзины в правой области.
Чтобы упростить редактирование, щелкните значок 
режима фокусировки, чтобы отобразить ячейку в полной ширине. Чтобы выйти из режима фокусировки, нажмите кнопку 
. Вы также можете увеличить отображаемую ширину ячейки, отключив макет в центре представления>.
Чтобы автоматически отформатировать все ячейки записной книжки в соответствии со стандартными длинами строк и интервалами, выберите пункт "Изменить > формат записной книжки".
Номера строк и команд
Чтобы отобразить или скрыть номера строк или команд, выберите номера строк или номера команд в меню "Вид ". Для номеров строк можно также использовать сочетание клавиш Control+L.
При включении номеров строк или команд Databricks сохраняет ваши предпочтения и показывает их во всех остальных записных книжках для этого браузера.
Номера строк и команд (исходный пользовательский интерфейс)
Номера команд над ячейками связаны с соответствующей командой. Если нажать на номер команды для ячейки, будет обновлен URL-адрес, привязанный к этой команде. Чтобы получить ссылку URL-адреса на определенную команду в записной книжке, щелкните правой кнопкой мыши номер команды и выберите "Копировать адрес ссылки".
Номера строк и команд (новый пользовательский интерфейс)
Номера строк отключены по умолчанию в новом пользовательском интерфейсе. Чтобы включить их, выберите "Просмотреть > номера строк". Если ячейка находится в состоянии ошибки, номера строк отображаются независимо от выделения.
Чтобы переключить номера команд, выберите "Просмотреть > номера команд".
Новый пользовательский интерфейс не содержит ссылки на номер команды ячейки. Чтобы получить ссылку URL-адреса на определенную команду в записной книжке, щелкните , чтобы открыть режим фокусировки, и скопируйте URL-адрес из адресной строки браузера. Чтобы выйти из режима фокусировки, нажмите кнопку .
Добавление заголовка ячейки
Чтобы добавить заголовок в ячейку с помощью исходного пользовательского интерфейса, выберите "Показать заголовок" в меню действий ячейки.
Чтобы добавить заголовок в ячейку с помощью нового пользовательского интерфейса, выполните одно из следующих действий:
- Щелкните номер ячейки, показанный в центре верхней части ячейки, и введите заголовок.
- Выберите "Добавить название" в меню действий ячейки.
В новом пользовательском интерфейсе ячейки с заголовками отображаются в оглавлении записной книжки.
Просмотр записных книжек в темном режиме
Вы можете выбрать отображение записных книжек в темном режиме. Чтобы включить или отключить темный режим, выберите "Вид > темы" и выберите "Светлая тема" или "Темная тема".
Скрытие и отображение содержимого ячейки
Содержимое ячейки состоит из кода ячейки и результатов, созданных путем запуска ячейки. Вы можете скрыть и отобразить код ячейки и результат с помощью меню действий ячейки в правом верхнем углу ячейки.
Сведения о связанных функциях см. в разделе "Сворачивание заголовков".
Скрытие и отображение содержимого ячейки (исходный пользовательский интерфейс)
Чтобы скрыть код ячейки или результаты, нажмите кнопку "Скрыть код" или "Скрыть результат". Вы также можете выбрать , чтобы отобразить только первую строку ячейки.
Чтобы отобразить скрытый код или результаты ячейки, щелкните ссылку Show (Показать):
Скрытие и отображение содержимого ячейки (новый пользовательский интерфейс)
Чтобы скрыть код ячейки или результаты, щелкните меню 
кебаб в правом верхнем углу ячейки и выберите "Скрыть код " или "Скрыть результат". Вы также можете выбрать свернутую ячейку , чтобы отобразить только первую строку ячейки. Чтобы развернуть свернутую ячейку, выберите "Развернуть ячейку".
Чтобы отобразить скрытый код ячейки или результаты, щелкните значок отображения: 
Свертываемые заголовки
Ячейки, которые появляются после ячеек, содержащих заголовки Markdown, можно свернуть в ячейку заголовка. Чтобы развернуть или свернуть ячейки после ячеек, содержащих заголовки Markdown в записной книжке, выберите "Свернуть все заголовки " в меню "Вид ". В остальной части этого раздела описывается, как развернуть или свернуть подмножество ячеек.
Сведения о связанных функциях см. в разделе "Скрытие и отображение содержимого ячейки".
Развертывание и свертывание заголовков (исходный пользовательский интерфейс)
На изображении показана настройка MLflow уровня двух уровней со следующими двумя ячейками, свернутыми в него.
Чтобы развернуть и свернуть заголовок, нажмите + и - соответственно.
Развертывание и свертывание заголовков (новый пользовательский интерфейс)
На изображении показана настройка MLflow уровня двух уровней со следующими двумя ячейками, свернутыми в него.
Чтобы развернуть и свернуть заголовки, наведите указатель мыши на ячейку Markdown. Щелкните стрелку, которая отображается слева от ячейки.
Вычислительные ресурсы для записных книжек
В этом разделе рассматриваются параметры вычислительных ресурсов записной книжки. Вы можете запустить записную книжку в кластере Databricks или для команд SQL также можно использовать хранилище SQL, тип вычислительных ресурсов, оптимизированных для аналитики SQL.
Подключение записной книжки к кластеру
Чтобы подключить записную книжку к кластеру, требуется разрешение CAN ATTACH TO cluster-level.
Внимание
Если записная книжка подключена к кластеру, любой пользователь с разрешением CAN RUN в записной книжке имеет неявное разрешение на доступ к кластеру.
Чтобы подключить записную книжку к кластеру, щелкните селектор вычислений на панели инструментов записной книжки и выберите кластер из раскрывающегося меню.
В меню отображается выбор кластеров, которые вы использовали недавно или которые в настоящее время запущены.
Чтобы выбрать из всех доступных кластеров, нажмите кнопку "Дополнительно...". Щелкните имя кластера, чтобы отобразить раскрывающееся меню и выберите существующий кластер.
Вы также можете создать новый кластер , выбрав "Создать новый ресурс" в раскрывающемся меню.
Внимание
В подключенной записной книжке определены следующие переменные Apache Spark.
| Класс | Имя переменной |
|---|---|
SparkContext |
sc |
SQLContext/HiveContext |
sqlContext |
SparkSession (Spark 2.x) |
spark |
Не создавайте SparkSession, SparkContext или SQLContext. Это приведет к несоответствующему поведению.
Использование записной книжки с хранилищем SQL
При присоединении записной книжки к хранилищу SQL можно запускать ячейки SQL и Markdown. При выполнении ячейки на любом другом языке (например, Python или R) возникает ошибка. Ячейки SQL, выполняемые в хранилище SQL, отображаются в журнале запросов хранилища SQL. Пользователь, который выполнил запрос, может просмотреть профиль запроса из записной книжки, щелкнув время в нижней части выходных данных.
Для запуска записной книжки требуется хранилище Pro или Бессерверное хранилище SQL. У вас должен быть доступ к рабочей области и хранилищу SQL.
Мини-приложения работают по-разному при присоединении записной книжки к хранилищу SQL. Дополнительные сведения см. в разделе "Использование мини-приложений Databricks" в хранилище SQL.
Чтобы подключить записную книжку к хранилищу SQL, сделайте следующее:
Щелкните селектор вычислений на панели инструментов записной книжки. В раскрывающемся меню отображаются вычислительные ресурсы, которые в настоящее время запущены или которые недавно использовались. Хранилища SQL помечаются с
помощью .В меню выберите хранилище SQL.
Чтобы просмотреть все доступные хранилища SQL, выберите "Дополнительно" в раскрывающемся меню. Откроется диалоговое окно с доступными вычислительными ресурсами для записной книжки. Выберите хранилище SQL, выберите хранилище, которое вы хотите использовать, и нажмите кнопку "Подключить".
Вы также можете выбрать хранилище SQL в качестве вычислительного ресурса для записной книжки SQL при создании рабочего процесса или запланированного задания.
К ограничениям хранилищ SQL относятся:
- При подключении к хранилищу SQL контексты выполнения используют тайм-аут простоя в 8 часов.
- Максимальный размер возвращаемых результатов составляет 10 000 строк или 2 МБ в зависимости от того, что меньше.
Отключение записной книжки
Чтобы отключить записную книжку от вычислительного ресурса, щелкните селектор вычислений на панели инструментов записной книжки и наведите указатель мыши на подключенный кластер или хранилище SQL в списке, чтобы отобразить боковое меню. В боковом меню выберите "Отсоединить".
Кроме того, можно отключить записные книжки от кластера на вкладке записные книжки на странице сведений о кластере.
При отключении записной книжки контекст выполнения удаляется, а все вычисляемые значения переменных удаляются из записной книжки.
Совет
Azure Databricks рекомендует отсоединить неиспользуемые записные книжки из кластеров. Это освобождает память драйвера.
Использование веб-терминала и интерфейса командной строки Databricks
Чтобы открыть веб-терминал в записной книжке, щелкните 
внизу правой боковой панели.
Использование Интерфейса командной строки Databricks в веб-терминале
Начиная с Databricks Runtime 15.0, вы можете использовать интерфейс командной строки Databricks из веб-терминала в записной книжке.
Требования
- Записная книжка должна быть подключена к кластеру в режиме общего доступа с одним пользователем или без изоляции.
- Интерфейс командной строки недоступен в рабочих областях, включенных для Приватный канал.
Установленный интерфейс командной строки всегда является последней версией. Проверка подлинности основана на текущем пользователе.
Вы не можете использовать ИНТЕРФЕЙС командной строки из ячейки записной книжки. Команды, такие как %sh databricks ... в записной книжке, не работают с Databricks Runtime 15.0 или более поздней версии.