Поделиться через


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

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

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

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

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

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

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

Примечание.

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

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

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

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

Чтобы отобразить сведения о переменной, определенной в записной книжке 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.

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

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

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

Отображение соответствующей скобки

Параллельный дифф в журнале версий

При отображении предыдущих версий записной книжки редактор отображает параллельные диффы с выделением цвета.

отображение диффов кода

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

При подключении записной книжки к кластеру синтаксические ошибки подчеркиваются красным цветом. Для Python кластер должен работать под управлением Databricks Runtime 12.2 LTS или более поздней версии.

Наведите указатель мыши на предупреждение синтаксиса и выберите "Быстрое исправление " для возможных действий.

Пример действий кода при выделении синтаксической ошибки

Рабочие области с включенным помощником Databricks также могут выбрать "Исправление" с помощью помощника по использованию ИИ.

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

  1. Щелкните имя пользователя в правом верхнем углу рабочей области, а затем щелкните "Параметры " в раскрывающемся списке.
  2. На боковой панели "Параметры" выберите "Разработчик".
  3. В разделе редактора кода переключите параметр выделения синтаксической ошибки SQL или ошибки синтаксиса Python.

Выделение форматирования Python

Ошибки форматирования кода Python и предупреждения подчеркнуты желтым цветом. Наведите указатель мыши на предупреждения синтаксиса, чтобы просмотреть дополнительные сведения. Кластер должен работать под управлением Databricks Runtime 12.1 LTS или более поздней версии.

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

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