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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поддержка multicursor

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

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

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

В macOS можно создать несколько вертикально выровненных курсоров с помощью сочетания клавиш + клавиши ВВЕРХ Option+Commandили СТРЕЛКА ВНИЗ.

выбор Column (поле)

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

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

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

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

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

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

1. Щелкните ваше имя пользователя в правом верхнем углу рабочей области, а затем щелкните Параметры в раскрывающемся списке list.
2. На боковой панели параметров selectразработчика.
3. В разделе редактора кода измените модификатор клавиши для нескольких курсоров на cmd для macOS или CTRL для Windows.

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

Обзор данных

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

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

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

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

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

• Автоматически создайте и запустите ячейку для отображения предварительного просмотра данных в table. Select Просмотр в новой ячейке из меню «Кебаб» для table.
• Просмотрите catalog, schemaили table в обозревателе Catalog. Select Открыть в Catalog Explorer из меню кебаб. Откроется новая вкладка с выбранным объектом.
• Get путь к catalog, schemaили table. Select Копировать ... путь из меню kebab для объекта.
• Добавьте table в избранное. Select Добавить в избранное из меню кебаб для table.

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

Чтобы ввести имя insert, table или column непосредственно в ячейку:

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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