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

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

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

Сочетания клавиш

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

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

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

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

Чтобы найти и заменить текст в записной книжке, выберите Изменить > Найти и заменить. Текущее совпадение выделено оранжевым цветом, а все остальные совпадения выделены желтым цветом.

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

Чтобы перейти между совпадениями, нажмите кнопки Пред. и След.. Можно также нажать клавиши shift+ВВОД и ввести, чтобы перейти к предыдущим и следующим матчам соответственно.

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

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

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

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

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

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

Удерживайте клавишу CMD в macOS или клавише CTRL в Windows и наведите указатель мыши на имя переменной или функции. Если определение найдено, имя превращается в гиперссылку.

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

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

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

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

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

Поддержка multicursor

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

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

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

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

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

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

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

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

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

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

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

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

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

Обзор данных

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

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

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

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

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

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

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

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

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

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

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

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

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

Требования

• Записная книжка должна быть подключена к кластеру в выделенном (ранее в режиме одного пользователя) или режиме общего доступа без изоляции.
• CLI недоступен в рабочих областях, обеспеченных для Private Link.

Установленный интерфейс командной строки всегда является последней версией. Проверка подлинности основана на текущем пользователе.

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

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

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

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

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

Существует два параметра пользователя, которые следует учитывать:

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

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

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

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

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

Записные книжки 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 или выше, или Client 3.0 или выше, можно настроить поведение подсветки синтаксиса, создавая 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 \
"""