Прочитать на английском

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

Отладка ноутбуков

  • Статья
  • 28.03.2025

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

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

Требования

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

  • Бессерверные вычисления
  • Вычисление с режимом доступа, установленным на Стандартный (ранее называвшийся Общий) в Databricks Runtime 14.3 LTS и более поздних версиях
  • Вычисления с режимом доступа, установленным в Выделенный (ранее один пользователь) в Databricks Runtime 13.3 LTS и более поздних версиях.
  • Вычисление с режимом доступа , установленного на "общий доступ без изоляции" в Databricks Runtime 13.3 LTS и последующих версиях.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

debug_console

Примечание

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

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

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

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

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

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

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

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

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

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

Ограничения

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