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

  • Статья

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

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

Автозавершение

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

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

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

Примечание.

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

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

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

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

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

Проверка переменной

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

В Databricks Runtime 12.2 LTS и более поздних версиях при присоединении записной книжки Python к кластеру можно автоматически перейти к определению переменной или функции, определенной в этой записной книжке. Для этого удерживайте клавишу CMD в macOS или клавише CTRL в Windows и наведите курсор на имя переменной или функции. Имя превращается в гиперссылку и изменяется на подчеркнутый синий текст, если определение найдено. Щелкнув ссылку, курсор перемещается в код, определяющий переменную или функцию.

Вы также можете использовать сочетания клавиш cmd+F12 в macOS или CTRL+F12 в Windows.

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

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

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

Как сложить код

Дополнительные сведения, включая сочетания клавиш, см. в документации по 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 кластер должен работать под управлением Databricks Runtime 12.2 LTS или более поздней версии.

Пример синтаксической ошибки higlighting

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

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

Возможные действия по ошибкам синтаксиса и предупреждениям

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

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

Примечание.

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