Навигация по записной книжке Databricks и редактору файлов

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

Вы можете выбрать один из выбранных тем редактора. Выберите Вид > Тема редактора и сделайте выбор в меню.

палитра команд

Вы можете быстро выполнять действия в записной книжке с помощью палитры команд. Чтобы открыть панель действий записной книжки, щелкните В правом нижнем углу рабочей области или используйте сочетание клавиш CMD + SHIFT+ P в MacOS или CTRL+SHIFT+P в Windows.

Мини-карта процесса выполнения ячеек

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

Индикаторы состояния указывают следующие состояния выполнения:

• Светлый серый: ячейка является статической.
• Темно-серый: ячейка пропускается или помещается в очередь для выполнения.
• Светло-серый с перемещенной полосой: в настоящее время выполняется ячейка.
• Зеленый: ячейка успешно выполнялась без ошибок.
• Красный: сбой ячейки с ошибкой.

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

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

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

Поиск и замена текста

Чтобы найти и заменить текст в записной книжке, используйте сочетание клавиш Cmd + F (Mac) или Ctrl + F (Windows) или нажмите на "Изменить > Найти...", чтобы открыть диалоговое окно "Найти". Введите нужный текст. Текущее совпадение выделено оранжевым цветом, а все остальные совпадения выделены желтым цветом. Чтобы получить доступ к собственному поиску в браузере, снова нажмите клавишу Cmd + F (Mac) или Ctrl + F(Windows).

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

Чтобы перемещаться между совпадениями, щелкните предыдущее совпадение) или (следующее совпадение). Вы также можете нажать Shift + Enter и Enter перейти к предыдущим и следующим матчам соответственно.

Чтобы закрыть средство поиска и замены, нажмите или нажмите клавишу ESC.

Проверка переменных

Чтобы отобразить сведения о переменной, определенной в записной книжке SQL или Python, наведите указатель мыши на имя переменной. Для проверки переменных Python требуется Databricks Runtime 12.2 LTS или более поздней версии.

См. обозревателя переменных.

Перейти к определению

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

Для этого удерживайте клавишу CMD в macOS или клавиши CTRL в Windows и наведите указатель мыши на переменную, имя функции или системный модуль. Если определение найдено, имя превращается в гиперссылку. Щелкните ссылку, чтобы перейти к определению, которая может открыться на новой вкладке. Вы также можете щелкнуть правой кнопкой мыши и выбрать команду "Перейти к определению " или "Показать определение".

Функция "перейти к определению" доступна в Databricks Runtime 12.2 LTS и выше и бессерверной среде 1 и выше.

Свертывание кода

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

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

Дополнительные сведения, включая сочетания клавиш, см. в документации по VS Code.

Поддержка multicursor

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

Чтобы создать несколько курсоров в ячейке:

• На macOS удерживайте клавишу Option и щелкайте в каждом месте, чтобы добавить курсор.
• В Windows удерживайте Alt клавишу и щелкните в каждом месте, чтобы добавить курсор.
• У вас также есть возможность изменить сочетание клавиш. См. изменение сочетания клавиш для выбора нескольких курсоров и столбцов.

На macOS можно создать несколько вертикально выровненных курсоров с помощью сочетания клавиш Option+Command + стрелка вверх или стрелка вниз.

Выбор столбца (поле)

Чтобы выбрать несколько элементов в столбце, щелкните в левом верхнем углу области, которую вы хотите записать. Then:

• В macOS нажмите Shift + Option и перетащите вправо внизу, чтобы записать один или несколько столбцов.
• В Windows нажмите Shift + Alt и перетащите его вправо, чтобы записать один или несколько столбцов.
• У вас также есть возможность изменить сочетание клавиш. См. изменение сочетания клавиш для выбора нескольких курсоров и столбцов.

изменить сочетание клавиш для мультикурсора и выбора столбца

Альтернативное сочетание клавиш доступно для мультикурсора и выбора столбца (бокса). При альтернативном выборе сочетания клавиш изменяются следующим образом:

• Чтобы создать несколько курсоров в ячейке:
  • На macOS удерживайте клавишу Cmd и щелкайте в каждом месте, чтобы добавить курсор.
  • В Windows удерживайте Ctrl клавишу и щелкните в каждом месте, чтобы добавить курсор.
• Чтобы выбрать несколько элементов в столбце, щелкните в левом верхнем углу области, которую вы хотите записать. Then:
  • В macOS нажмите Option и перетащите вправо внизу, чтобы записать один или несколько столбцов.
  • В Windows нажмите Alt и перетащите его вправо, чтобы записать один или несколько столбцов.

Чтобы включить альтернативные сочетания клавиш, сделайте следующее:

1. Нажмите на ваше имя пользователя в правом верхнем углу окна, а затем нажмите Настройки в раскрывающемся списке.
2. На боковой панели настроек выберите Разработчик.
3. В разделе «Редактор кода» измените настройку Ключевой модификатор для многокурсорного щелчка на Cmd для macOS или Ctrl для Windows.

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

Обзор данных

Используйте обозреватель схем для изучения объектов Unity Catalog, доступных в этой записной книжке. Щелкните слева в записной книжке, чтобы открыть браузер схемы.

Кнопка "Для вас " отображает только те объекты, которые вы использовали в текущем сеансе или ранее помеченные как избранное.

Когда вы вводите текст в поле фильтра , отображаются только те объекты, которые содержат введённый текст. Отображаются только открытые или открытые в текущем сеансе объекты. Поле фильтра не выполняет полный поиск каталогов, схем, таблиц и томов, доступных для записной книжки.

Чтобы открыть , наведите курсор на имя объекта, как показано.

Если объект является таблицей, можно выполнить следующее:

• Автоматически создайте и запустите ячейку для отображения предварительного просмотра данных в таблице. Выберите предварительной версии в новой ячейке в меню кебаб таблицы.
• Просмотр каталога, схемы или таблицы в обозревателе каталогов. Выберите Открыть в обозревателе каталогов в меню кебаб. Откроется новая вкладка с выбранным объектом.
• Получите путь к каталогу, схеме или таблице. Выберите Копировать ... путь из меню kebab для объекта.
• Добавьте таблицу в избранное. Выберите Добавить в избранное в меню кебаб для таблицы.

Если объект является каталогом, схемой или томом, можно скопировать путь объекта или открыть его в обозревателе каталогов.

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

1. Щелкните курсор в ячейке, куда нужно ввести имя.
2. Наведите курсор на название таблицы или столбца в браузере схемы.
3. Щелкните Она отображается справа от имени объекта.

Использование веб-терминала и интерфейса командной строки Databricks

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

В Databricks Runtime 15.0 и более поздних версиях вы можете использовать интерфейс командной строки Databricks из веб-терминала в записной книжке. Сведения о выполнении команд оболочки, требованиях и использовании см. в веб-терминале Azure Databricks.

Вы не можете использовать CLI в ячейке ноутбука. В записной книжке такие команды, как %sh databricks ... не работают с Databricks Runtime 15.0 или более поздней версии.

Персонализированное автозавершение

Автозавершение автоматически завершает сегменты кода по мере их ввода. К объектам, которые можно завершить, относятся типы, классы и объекты, а также база данных SQL, имена таблиц, структуры, словари, массивы и фрагменты запросов. При ссылке на общие табличные выражения (CTEs), которые используют SELECT *, автозавершение предоставляет рекомендации по столбцам на основе базовой структуры таблицы. Databricks использует метаданные и данные об использовании каталога Unity для персонализации предложений.

• Для ячеек Python записная книжка должна быть присоединена к вычислительному ресурсу для автоматической компиляции, и необходимо запустить все ячейки , определяющие завершенные объекты.
• Для ячеек SQL автозавершение предлагает ключевые слова и базовый синтаксис, даже если записная книжка не подключена к вычислительному ресурсу.
  • Если рабочая область включена для каталога Unity, автозавершение также предлагает каталог, схему, таблицы и имена столбцов для таблиц в каталоге Unity.
  • Если рабочая область не поддерживает Unity Catalog, записная книжка должна быть присоединена к универсальному вычислительному ресурсу или хранилищу SQL, чтобы предложить имена таблиц или столбцов.

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

Note

Серверное автозавершение в записных книжках R блокируется во время выполнения команды.

Автозавершение включено по умолчанию, но его можно отключить в параметрах пользователя:

• Чтобы отключить предложения автозавершения, переключите автозавершение по мере ввода. При отключении автозавершения можно отобразить предложения автозаполнения, нажав клавиши CTRL+ПРОБЕЛ.
• Чтобы отключить вставку предложений автозавершения при нажатии Enter, переключите настройку клавиша Enter принимает предложения автозаполнения.

Сопоставление скобок

При щелчке рядом с круглой, квадратной или фигурной скобкой редактор выделяет этот символ и соответствующую скобку.

Выделение ошибок Python

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

Записные книжки Databricks поддерживают следующее выделение ошибок:

• Выделение синтаксической ошибки Python: все синтаксические ошибки в ячейках кода Python выделены красным цветом. Если это возможно, помощник предложит вам быстрое исправление. Это поддерживается для вычислений, работающих под управлением Databricks Runtime 12.1 и выше или бессерверных вычислений. Вы можете настроить подсветку синтаксических ошибок с помощью файлов pyproject.toml. См. раздел "Настройка выделения синтаксиса Python".
• Выделение ошибок формата Python: ошибки форматирования кода Python и предупреждения подчеркнуты желтым или красным в зависимости от серьезности. Это может помочь определить проблемы форматирования, такие как неожиданные отступы, длина строки и многое другое. Наведите указатель мыши на предупреждения синтаксиса, чтобы просмотреть дополнительные сведения. Это поддерживается для вычислений, работающих под управлением Databricks Runtime 12.1 и выше или бессерверных вычислений.
• Выделение ошибок типа Python: проверка типов может улучшить качество кода, удобочитаемость и удобство обслуживания в проектах Python и PySpark. Средства проверки типов могут пометить ошибки, связанные с несуществующими атрибутами, отсутствующими аргументами и несовпадающими аргументами в вызовах функций перед выполнением кода. Наведите указатель мыши на выделенные предупреждения, чтобы просмотреть дополнительные сведения. Это поддерживается для вычислений, работающих под управлением Databricks Runtime 16.0 и более поздней или бессерверной среды 2.

Включение выделения ошибок Python

Чтобы включить или отключить выделение ошибок, сделайте следующее:

1. Нажмите на ваше имя пользователя в правом верхнем углу окна, а затем нажмите Настройки в раскрывающемся списке.
2. На боковой панели настроек выберите Разработчик.
3. Переключите параметр выделения синтаксической ошибки Python (в редакторе кода), выделение ошибок формата Python (в экспериментальных функциях) и (или) выделение ошибок типа Python (в разделе "Экспериментальные функции").

Настройка выделения синтаксиса Python

Если ноутбук подключен к вычислительным ресурсам, работающим под управлением Databricks Runtime 16.4 или более поздней версии, или к бессерверной среде версии 3 или более поздней, можно настроить подсветку синтаксиса, создав pyproject.toml файл. Для данной записной книжки будет использоваться ближайший pyproject.toml файл в иерархии предков в файловой системе рабочей области. Если он не будет найден в пути предка, файл pyproject.toml в домашней папке текущего пользователя будет использоваться.

Например, если у вас есть записная книжка с путем a/b/c/d/notebook.py и в pyproject.toml и a/b/pyproject.toml находятся файлы a/b/c/pyproject.toml, то будет использован второй, так как он ближе. pyproject.toml Файл /a/b/c/e/pyproject.toml не будет рассматриваться, так как он не находится в древе прямых предков.

Azure Databricks использует стандартный синтаксис для pyproject.toml файлов. Например, можно обратиться к документации по Ruff, чтобы узнать, как настроить линтер Ruff с файла pyproject.toml.

В настоящее время Azure Databricks поддерживает только настройку ruff, pylint, pyright и flake8 для linting'а через pyproject.toml.

Чтобы включить линтер, этот pyproject.toml файл должен иметь [tool.<name-of-linter>] блок.

Чтобы отключить линтер явно, добавьте следующий блок:

[tool.<name-of-linter>]
disabled=true

Вы также можете отключить правила подсветки синтаксиса, предоставляемые Azure Databricks, с помощью блока, например:

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Так как Flake8 ожидает конфигурацию в другом формате, необходимо передать конфигурацию для Flake8 в виде строки:

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

Настройка форматирования SQL

Параметры форматирования SQL можно настроить в новом редакторе SQL и редакторе записных книжек. Нажмите кнопку "Просмотреть > параметры разработчика". Прокрутите вниз до формата SQL и укажите параметры.

Использование сочетаний клавиш

Чтобы отобразить сочетания клавиш, выберите Справка > Сочетания клавиш. Доступные сочетания клавиш зависят от того, находится ли курсор в ячейке кода (режим редактирования) или нет (режим команды).

В приведенных ниже таблицах показаны доступные сочетания клавиш.

Сочетания клавиш режима правки

Функция	Сочетание клавиш MacOS	Ярлык Windows
Переключение в режим команд	Esc	Esc
Выполните команду и вставьте новую ячейку ниже	Option + Enter	Alt + Enter
Вставка ячейки выше	Ctrl + Option + P	Ctrl + Alt + P
Вставка ячейки ниже	Ctrl + Option + N	Ctrl + Alt + N
Переход к предыдущей или следующей ячейке	Option + Up/Down	Alt + Up/Down
Разделение ячейки на курсоре	Ctrl + Option + -	Ctrl + Alt + -
Удаление текущей строки	⌘ + Shift + K	Ctrl + Shift + K
Удаление текущей ячейки	Ctrl + Option + D	Ctrl + Alt + D
Перемещение вверх или к предыдущей ячейке	Up	Up
Перемещение вниз или на следующую ячейку	Down	Down
Автозаполнение	Ctrl + Space	Ctrl + Space
Автоматическое автозавершение помощника	Ctrl + Shift + Space	Ctrl + Shift + Space
Встроенный помощник	⌘ + I	Ctrl + I
Подсказки параметров	⌘ + Shift + Space	Ctrl + Shift + Space
Документация	⌘ + (K, I)	Ctrl + (K, I)
Несколько курсоров	Option + Click	Alt + Click
Выберите столбец (поле)	Option + Shift + Drag	Alt + Shift + Drag
Выбор отступа/Юниндента	⌘ + ]/[	Ctrl + ]/[
Отмена ввода	⌘ + Z	Ctrl + Z
Повторная ввод	⌘ + Shift + Z	Ctrl + Shift + Z
Переключение примечания строки	⌘ + /	Ctrl + /
Добавление комментария строки	⌘ + (K, C)	Ctrl + (K, C)
Удаление комментариев строки	⌘ + (K, U)	Ctrl + (K, U)
Изменение нескольких курсоров	⌘ + Option + Up/Down	Ctrl + Option + Up/Down
Увеличение размера шрифта	Option + +	Alt + +
Уменьшение размера шрифта	Option + -	Alt + -

Сочетания клавиш для режима команд

Функция	Сочетание клавиш Mac OS	Ярлык Windows
Переключение на режим редактирования	Enter	Enter
Отмена выполнения для выбранных ячеек	I, I	I, I
Отмена выполнения (запрос пропустить)	Shift + (I, I)	Shift + (I, I)
Удаление текущей ячейки	D, D	D, D
Удаление текущей ячейки (запрос пропустить)	Shift + (D, D)	Shift + (D, D)
Перейти к первой ячейке	G, G	G, G
Перейти к последней ячейке	Shift + G	Shift + G
Отмена вырезанных и удаленных ячеек	⌘ + Z/Z	Ctrl + Z/Z
Копирование текущей ячейки	⌘ + C	Ctrl + C
Вырезать текущую ячейку	⌘ + X	Ctrl + X
Вставка ячейки	⌘ + V	Ctrl + V
Вставка ячейки выше	A	A
Вставка ячейки ниже	B	B
Переключение выходных данных ячейки	O	O
Переключение заголовка ячейки	T	T
Прокрутка вниз	Space	Space
Прокрутка вверх	Shift + Space	Shift + Space
Меню сочетаний клавиш	H	H
Слияние с ячейкой ниже	Shift + M	Shift + M
Переход к предыдущей ячейке	Up/P/K	Up/P/K
Переход к следующей ячейке	Down/N/J	Down/N/J
Добавление соседней ячейки к выбору	Shift + Up/Down	Shift + Up/Down
Выбор всех ячеек	⌘ + A	Ctrl + A
Выбор нескольких ячеек	⌘ + Click	Ctrl + Click
Переключение номеров строк	L	L
Заголовки ячеек "Развернуть и свернуть"	Right/Left	Right/Left

Общие сочетания клавиш

Функция	Сочетание клавиш MacOS	Ярлык Windows
Переключение палитры команд	⌘ + Shift + P	Ctrl + Shift + P
Поиск	⌘ + F	Ctrl + F
Заменить	Ctrl + Option + F	Ctrl + Alt + F
Форматирование кода	⌘ + Shift + F	Ctrl + Shift + F
Выполните команду и перейдите к следующей ячейке	Shift + Enter	Shift + Enter
Выполнение выбранных команд	⌘ + Enter	Ctrl + Enter
Отладочная ячейка	Option + Shift + D	Alt + Shift + D
Отладчик: продолжить	F7	F7
Отладчик: следующая строка	F8	F8
Отладчик: шаг в	F9	F9
Отладчик: выход	Shift + F9	Shift + F9
Выполнение всех команд	Option + Shift + Enter	Alt + Shift + Enter
Выполните все приведенные выше команды (эксклюзивные)	Option + Shift + Up	Alt + Shift + Up
Выполните все приведенные ниже команды (включительно)	Option + Shift + Down	Alt + Shift + Down
Очистка состояния и выходных данных	0, 0	0, 0
Выполнение выделенного текста или активного оператора	Ctrl + Shift + Enter	Ctrl + Shift + Enter
Запуск активной инструкции SQL	⌘ + Shift + Enter	Ctrl + Shift + Enter
Перемещение ячейки вверх	Ctrl + Option + Up	Ctrl + Alt + Up
Перемещение ячейки вниз	Ctrl + Option + Down	Ctrl + Alt + Down
Переключение панели комментариев и добавление комментариев	Ctrl + Option + M	Ctrl + Alt + M
Переключение панели рабочей области	Ctrl + Option + E	Ctrl + Alt + E
Переключение панели каталога	Ctrl + Option + C	Ctrl + Alt + C
Переключатель панели помощника	Ctrl + Option + A	Ctrl + Alt + A
Переключение в режим фокусировки	Ctrl + Option + O	Ctrl + Alt + O
Закрыть текущую вкладку	Ctrl + Option + W	Ctrl + Alt + W
Создание вкладки	Ctrl + Option + T	Ctrl + Alt + T
Переключение на левую вкладку	Ctrl + Option + Left	Ctrl + Alt + Left
Переключение на правую вкладку	Ctrl + Option + Right	Ctrl + Alt + Right
Закройте все вкладки	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A