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

Записные книжки Databricks включают встроенный интерактивный отладчик, доступный только для Python кода.

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Перейдите в файлы рабочей области

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

пример этапа в процессе

Примечание.

  • Отладчик может входить только в функции, определенные в файлах рабочей области. Переход в библиотеки Python или другие блокноты пока не поддерживается.
  • При изменении внешних файлов после их импорта сеанс записной книжки может по-прежнему использовать старую версию модуля. Чтобы изменения импортированных модулей вступают в силу во время отладки, используйте autoreload для модулей Python в Databricks Runtime 18.0 или бессерверной вычислительной среды версии 4+.

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

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

Отладка с помощью кода Genie

Genie Code может диагностировать ошибки и предлагать исправления в коде записной книжки. Для получения дополнительной информации обратитесь к сочетаниям команд Genie Code для записных книжек.

Ограничения

Для получения дополнительной информации см. известные ограничения блокнотов Databricks.

  • Last updated on