排查 Visual Studio Code 的 Databricks 扩展问题
本文提供有关使用适用于 Visual Studio Code 的 Databricks 扩展时发生的常见错误的信息,以及故障排除信息。 请参阅什么是 Visual Studio Code 的 Databricks 扩展?。
查看 Databricks 日志输出
Databricks 扩展在执行任何类型的命令时,会在 Visual Studio Code“视图”>“输出”面板中提供详细的日志输出。 可以使用这些日志来确认成功并查看可能发生的任何问题。 根据命令,这些日志可以在以下输出通道中找到:
- Databricks 捆绑包日志
- Databricks Connect
- Databricks 日志
- Databricks Notebook
若要切换输出通道,请选择 Visual Studio Code“输出”视图右上角的下拉列表。
如果已选中“日志: 已启用”或者 databricks.logs.enabled
设置为 true
,则“输出”视图将显示截断的信息。 若要显示详细信息,请更改以下设置,如 Visual Studio Code 的 Databricks 扩展设置中所述:
- “日志: 最大数组长度”或
databricks.logs.maxArrayLength
- “日志: 最大字段长度”或
databricks.logs.maxFieldLength
- “日志: 截断深度”或
databricks.logs.truncationDepth
通过代理同步时出错
问题:当你尝试运行 Visual Studio Code 的 Databricks 扩展以通过代理同步本地项目时,出现如下所示的错误消息,并且同步操作失败:Get "https://<workspace-instance>/api/2.0/preview/scim/v2/Me": EOF
。
可能的原因:Visual Studio Code 不知道如何查找代理。
建议的解决方法:从终端运行以下命令重启 Visual Studio Code,然后再次尝试同步:
env HTTPS_PROXY=<proxy-url>:<port> code
在上述命令中:
- 将
<proxy-url>
替换为代理的完整 URL。 - 将
<port>
替换为代理上的正确端口。
错误:尝试同步本地代码时出现“未知的生成系统错误 -86”
问题:当你尝试将项目中的本地代码同步到远程 Azure Databricks 工作区时,终端显示同步已开始但仅显示错误消息 spawn unknown system error -86
。 此外,“配置”窗格的“同步目标”部分保持挂起状态。
可能的原因:为开发计算机的操作系统安装了错误的 Visual Studio Code Databricks 扩展版本。
建议的解决方法:卸载该扩展,然后从头开始为开发计算机的操作系统安装并打开该扩展。
将使用情况日志发送到 Databricks
如果在将本地代码同步到远程 Azure Databricks 工作区时出现问题,可以通过执行以下操作将使用情况日志和相关信息发送给 Databricks 支持人员:
- 通过选中“日志: 已启用”设置或将
databricks.logs.enabled
设置为true
来启用日志记录,如 Visual Studio Code 的 Databricks 扩展设置中所述。 在启用日志记录后请务必重启 Visual Studio Code。 - 尝试重现问题。
- 在“命令面板”(在主菜单中选择“查看”>“命令面板”)中,运行“Databricks: 打开完整日志”命令。
- 将显示的
databricks-cli-logs.json
和sdk-and-extension-logs.json
文件发送给 Databricks 支持人员。 - 另外,请复制问题上下文中的“终端”(“查看”>“终端”)的内容,并将此内容发送给 Databricks 支持人员。
若要将与代码同步问题无关的错误日志发送给 Databricks 支持人员,请执行以下操作:
- 在“命令面板”(“查看”>“命令面板”)中,运行“Databricks: 打开完整日志”命令。
- 仅将显示的
sdk-and-extension-logs.json
文件发送给 Databricks 支持人员。