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

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

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

Режим редактирования и режим команд

Записные книжки Databricks имеют два режима взаимодействия:

• Режим редактирования активен, когда курсор находится внутри ячейки. В этом режиме можно ввести и изменить код или текст в ячейке. В ячейке отображается мигающий курсор, указывающий режим редактирования. Дважды щелкните ячейку или нажмите клавишу Enter , чтобы переключиться из режима команды в режим редактирования. Нажмите, Esc чтобы выйти из режима редактирования.
• Режим команд активен, если ячейка не редактируется. В этом режиме вы работаете с ячейками как с единицами. Вы можете выбрать, вырезать, копировать, вставлять, удалять, перемещать и изменять ячейки. Нажмите, Esc чтобы переключиться из режима редактирования в режим команд. Нажмите, Enter чтобы выйти из командного режима.

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

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

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

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

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

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

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

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

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

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

Чтобы найти и заменить текст в записной книжке, используйте сочетание клавиш, Cmd + F (Mac) или Ctrl + F(Windows) или щелкните Edit > Find... , чтобы открыть диалоговое окно Find. Введите нужный текст. Текущее совпадение выделено оранжевым цветом, а все остальные совпадения выделены желтым цветом. Чтобы получить доступ к встроенному поиску в браузере, снова нажмите клавиши 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 из веб-терминала в записной книжке. См. Запуск shell-команд в веб-терминале Azure Databricks для получения информации о требованиях и использовании.

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

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

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

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

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

Note

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

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

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

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

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

подсветка ошибок в Python

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

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

• Выделение синтаксических ошибок в Python: Синтаксические ошибки в ячейках кода Python выделяются красным цветом. Если это возможно, Genie Code предлагает быстрое исправление для вас. Это поддерживается для вычислений, работающих под управлением 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, то второй используется, так как он ближе. pyproject.toml Файл /a/b/c/e/pyproject.toml не будет рассматриваться, так как он не находится в древе прямых предков.

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

В настоящее время Azure Databricks поддерживает только настройку ruff, pylint, pyright и flake8 для линтинга через 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