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

Внимание

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

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

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

Требования

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

• Бессерверные вычисления
• Кластер с режимом доступа с одним пользователем в Databricks Runtime 13.3 LTS и выше
• Кластер с режимом доступа, равным No Isolation Shared in Databricks Runtime 13.3 LTS и более поздней версии
• Кластер с режимом доступа, установленным для общего доступа в Databricks Runtime 14.3 LTS и выше

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

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

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

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

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

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

   

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

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

   

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

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

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

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

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

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

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

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

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

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

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

Примечание.

• Консоль отладки предназначена для быстрой оценки и времени ожидания, если выполнение кода превышает 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".