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

Отладка записных книжек

  • Статья

Внимание

Эта функция предоставляется в режиме общедоступной предварительной версии.

На этой странице описывается использование встроенного интерактивного отладчика в записной книжке Databricks. Отладчик доступен только для Python.

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

Требования

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

  • Databricks Runtime версии 13.3 LTS или более поздней.
  • Режим доступа должен быть одним пользователем (назначенным) или без общей изоляции.

Включение отладчика

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

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

Запуск отладки

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

  1. Добавьте одну или несколько точек останова, щелкнув в гамме ячейки. Чтобы удалить точку останова, снова щелкните ее.

    Создание и удаление видео точек останова

  2. Запустите сеанс отладки с помощью одного из следующих параметров:

    • Нажмите кнопку "Запустить > отладочную ячейку".
    • Используйте параметр сочетания клавиш + SHIFT+D.
    • В меню выполнения ячейки выберите "Отладка ячейки".

    Элемент отладки ячейки в меню запуска ячейки

Сеанс отладки запускается автоматически и запускает выбранную ячейку.

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

Когда сеанс отладки активен, панель инструментов Панель инструментов отладки отладки отображается в верхней части ячейки.

Действия отладки

Панель инструментов отладчика с заметками

В сеансе отладки можно выполнить следующее:

  • Установка или удаление точек останова.
  • Просмотр значений переменных в точке останова.
  • Пошаговая отладка кода.
  • Шаг в функцию или выход из нее.

Когда код достигает точки останова, он останавливается до запуска строки, а не после.

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

При шаге через функцию локальные переменные функции отображаются на панели переменных, помеченные [local].

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

При запуске сеанса отладки консоль отладки автоматически появится на нижней панели. Эта консоль позволяет выполнять код Python для проверки или управления переменными при приостановке в точке останова. Код, выполняемый в основной записной книжке, не выполняется во время сеанса отладки. Чтобы запустить код в консоли, нажмите клавишу ВВОД. Для многостроковых выражений используйте SHIFT+ВВОД , чтобы перейти к новой строке.

debug_console

Примечание.

  • Консоль отладки предназначена для быстрой оценки и времени ожидания, если выполнение кода превышает 15 секунд.
  • Команда display не поддерживается в консоли отладки. Чтобы просмотреть примеры данных из кадра данных, используйте df.show() кадры данных PySpark или df.head() для кадров данных Pandas.

Обозреватель переменных

Панель обозревателя Значок обозревателя переменных переменных можно использовать справа, чтобы просмотреть значения переменных. Нажатие кнопки "Проверка " автоматически выполняет код в консоли отладки, чтобы вывести значение переменной.

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

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

Для Python в Databricks Runtime 12.2 LTS и более поздних версиях переменные обновляются в виде ячейки. Для Scala, R и Python в Databricks Runtime 11.3 LTS и ниже переменные обновляются после завершения работы ячейки.

Завершение сеанса отладчика

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

Отладка с помощью помощника Databricks

Помощник Databricks — это помощник по искусственному интеллекту с учетом контекста, который поможет выполнить отладку кода. Дополнительные сведения см . в разделе "Использование Помощника по Databricks" в ячейке записной книжки.

Ограничения

Дополнительные сведения см. в разделе "Известные ограничения Databricks notebook".