排查 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 支持人员:

  1. 通过选中“日志: 已启用”设置或将 databricks.logs.enabled 设置为 true 来启用日志记录,如 Visual Studio Code 的 Databricks 扩展设置中所述。 在启用日志记录后请务必重启 Visual Studio Code。
  2. 尝试重现问题。
  3. 在“命令面板”(在主菜单中选择“查看”>“命令面板”)中,运行“Databricks: 打开完整日志”命令。
  4. 将显示的 databricks-cli-logs.jsonsdk-and-extension-logs.json 文件发送给 Databricks 支持人员。
  5. 另外,请复制问题上下文中的“终端”(“查看”>“终端”)的内容,并将此内容发送给 Databricks 支持人员。

若要将与代码同步问题无关的错误日志发送给 Databricks 支持人员,请执行以下操作:

  1. 在“命令面板”(“查看”>“命令面板”)中,运行“Databricks: 打开完整日志”命令。
  2. 仅将显示的 sdk-and-extension-logs.json 文件发送给 Databricks 支持人员。