Settings for the Databricks extension for Visual Studio Code

This article lists extension settings for the Databricks extension for Visual Studio Code. See What is the Databricks extension for Visual Studio Code?

Settings reference

The Databricks extension for Visual Studio Code adds the following settings to Visual Studio Code. Open the Settings editor using the Visual Studio Code Command Palette command Preferences: Open Settings. The settings.json file can also be modified directly.

Settings editor (Extensions > Databricks) settings.json Description
Bundles: Remove State Refresh Interval databricks.bundle.remoteStateRefreshInterval The interval in minutes at which the remote state of the bundle is refreshed.
Clusters: Only Show Accessible Clusters databricks.clusters.onlyShowAccessibleClusters Checked or set to true to enable filtering for only those clusters that you can run code on.

The default is unchecked or false (do not enable filtering for those clusters).
Experiments: Opt Into databricks.experiments.optInto Enables or disables experimental features for the extension. Available features include:

* views.cluster: Shows or hides the Clusters view. See Select a cluster for running code and jobs.
Logs: Enabled databricks.logs.enabled Checked or set to true (default) to enable logging. Reload your window for any change to take effect.
Logs: Max Array Length databricks.logs.maxArrayLength The maximum number of items to show for array fields. The default is 2.
Logs: Max Field Length databricks.logs.maxFieldLength The maximum length of each field displayed in the logs output panel. The default is 40.
Logs: Truncation Depth databricks.logs.truncationDepth The maximum depth of logs to show without truncation. The default is 2.
Override Databricks Config File databricks.overrideDatabricksConfigFile An alternate location for the .databrickscfg file that the extension uses for authentication.
Python: Env File databricks.python.envFile The absolute path to your custom Python environment variable definitions (.env) file. See Environment variable definitions files.
Wsfs: Rearrange Cells databricks.wsfs.rearrangeCells Enable or disable rearranging cells in wrapper files created when using workspace as the sync destination. Databricks recommends keeping this setting enabled. If it is disabled, you will need to manually handle the sys.path for local imports in your notebooks.

Environment variable definitions files

Visual Studio Code supports environment variable definitions files for Python projects. You create a file with the extension .env somewhere on your development machine, and Visual Studio Code applies the environment variables within this .env file at run time. For more information, see Environment variable definitions file in the Visual Studio Code documentation.

To have the Databricks extension for Visual Studio Code use your .env file, set databricks.python.envFile within your settings.json file or Extensions > Databricks > Python: Env File within the Settings editor to the absolute path of your .env file.

Important

If you set settings.json, do not set python.envFile to the absolute path of your .env file as described in the Visual Studio Code documentation, as the Databricks extension for Visual Studio Code must override python.envFile for its internal use. Be sure to only set databricks.python.envFile instead.