使用 Databricks 交互式调试器

本页介绍了如何在 Databricks 笔记本中使用内置的交互式调试器。 该调试器仅适用于 Python。

交互式调试器提供断点、分步执行、变量检查等工具，可帮助更高效地在笔记本中开发代码。

要求

笔记本必须附加到满足以下要求的群集：

• Databricks Runtime 版本 13.3 LTS 或更高版本。
• 访问模式必须为单个用户（已分配）或无隔离共享。

启用或禁用调试器

要启用或禁用调试器，请执行以下操作：

1. 点击工作区右上角的用户名，然后从下拉列表中选择“用户设置”。
2. 在“设置”边栏中，选择“开发人员”。
3. 在实验性功能部分中，切换Python Notebook 交互式调试器。

启动调试器

要启动调试器，请执行以下步骤：

1. 点击单元格的装订线以添加一个或多个断点。 要删除断点，请再次点击。

   

2. 执行下列操作之一：

   • 点击“运行>”“调试单元格”。
   • 使用键盘快捷方式Ctrl + Shift + D。
   • 在单元格运行菜单中，选择“调试单元格”。

   

调试会话会自动启动并运行所选单元格。

如果单元格触发错误，还可以启动调试器。 在单元格输出的底部，点击。

当调试会话处于活动状态时，调试工具栏显示在单元格顶部。

使用调试器

在调试会话中，可以执行以下操作：

• 设置或删除断点。
• 查看断点处变量的值。
• 逐步执行代码。
• 单步执行或退出函数。

当代码到达断点时，它会在运行行之前停止，而不是运行行之后。

使用调试器工具栏中的按钮逐步执行代码。 单步执行代码时，当前行在单元格中突出显示。 可以在右侧栏的变量资源管理器窗格中查看变量值。

单步执行函数时，局部函数变量显示在变量窗格中，标记为[local]。

终止调试器会话

要结束调试会话，请点击单元格左上角的，或点击笔记本顶部的。

限制

• 调试器仅适用于 Python。 它不支持 Scala 或 R。
• 调试器不适用于已共享访问模式群集。
• 调试器不支持单步执行外部文件或模块。
• 当调试会话处于活动状态时，无法在笔记本中运行其他命令。