Troubleshoot the Databricks extension for Visual Studio Code
This article provides information about common errors that occur when using the Databricks extension for Visual Studio Code, as well as troubleshooting information. See What is the Databricks extension for Visual Studio Code?.
View Databricks log output
The Databricks extension provides detailed log output in the Visual Studio Code View > Output panel when executing any type of command. You can use these logs to confirm success and to see any issues that might have occurred. Depending on the command, these logs are found in the following output channels:
- Databricks Bundle Logs
- Databricks Connect
- Databricks Logs
- Databricks Notebook
To switch output channels, select the dropdown in the top right corner of the Visual Studio Code Output view.
The Output view shows truncated information if Logs: Enabled is checked or databricks.logs.enabled
is set to true
. To show more information, change the following settings, as described in Settings for the Databricks extension for Visual Studio Code:
- Logs: Max Array Length or
databricks.logs.maxArrayLength
- Logs: Max Field Length or
databricks.logs.maxFieldLength
- Logs: Truncation Depth or
databricks.logs.truncationDepth
Error when synchronizing through a proxy
Issue: When you try to run the Databricks extension for Visual Studio Code to synchronize your local project through a proxy, an error message similar to the following appears, and the synchronization operation is unsuccessful: Get "https://<workspace-instance>/api/2.0/preview/scim/v2/Me": EOF
.
Possible cause: Visual Studio Code does not know how to find the proxy.
Recommended solution: Restart Visual Studio Code from your terminal by running the following command, and then try synchronizing again:
env HTTPS_PROXY=<proxy-url>:<port> code
In the preceding command:
- Replace
<proxy-url>
with the full URL to your proxy. - Replace
<port>
with the correct port on your proxy.
Error: “spawn unknown system error -86” when you try to synchronize local code
Issue: When you try to synchronize local code in a project to a remote Azure Databricks workspace, the Terminal shows that synchronization has started but displays only the error message spawn unknown system error -86
. Also, the Sync Destination section of the Configuration pane remains in a pending state.
Possible cause: The wrong version of the Databricks extension for Visual Studio Code is installed for your development machine’s operating system.
Recommend solution: Uninstall the extension, and then Install and open the extension for your development machine’s operating system from the beginning.
Send usage logs to Databricks
If you have issues synchronizing local code to a remote Azure Databricks workspace, you can send usage logs and related information to Databricks Support by doing the following:
- Turn on logging by checking the Logs: Enabled setting, or setting
databricks.logs.enabled
totrue
, as described in Settings for the Databricks extension for Visual Studio Code. Be sure to restart Visual Studio Code after you turn on logging. - Attempt to reproduce your issue.
- From the Command Palette (View > Command Palette from the main menu), run the Databricks: Open full logs command.
- Send the
databricks-cli-logs.json
andsdk-and-extension-logs.json
files that appear to Databricks Support. - Also copy the contents of the Terminal (View > Terminal) in the context of the issue, and send this content to Databricks Support.
To send error logs that are not about code synchronization issues to Databricks Support:
- From the Command Palette (View > Command Palette), run the Databricks: Open full logs command.
- Send only the
sdk-and-extension-logs.json
file that appears to Databricks Support.