databricks-config

Original：🇺🇸 English

Translated

Configure Databricks profile and authenticate for Databricks Connect, Databricks CLI, and Databricks SDK.

1installs

Sourcedatabricks-solutions/ai-dev-kit

Added on2026-02-10

NPX Install

npx skill4agent add databricks-solutions/ai-dev-kit databricks-config

SKILL.md Content

View Translation Comparison →

Configure the Databricks profile in ~/.databrickscfg for use with Databricks Connect.

Usage:

/databricks-config [profile_name|workspace_host]

Examples:

```
/databricks-config
```
- Configure DEFAULT profile (interactive)
```
/databricks-config DEFAULT
```
- Configure DEFAULT profile
```
/databricks-config my-workspace
```
- Configure profile named "my-workspace"

/databricks-config https://adb-1234567890123456.7.azuredatabricks.net/

- Configure using workspace host URL

Task

Determine the profile and host:
- If a parameter is provided and it starts with
```
https://
```
  , treat it as a workspace host:
  - Extract profile name from the host (e.g.,
    adb-1234567890123456.7.azuredatabricks.net
    →
    adb-1234567890123456
    ,
    my-company-dev.cloud.databricks.com
    →
    my-company-dev
    )
  - Use this as the profile name and configure it with the provided host
- If a parameter is provided and it doesn't start with
```
https://
```
  , treat it as a profile name
- If no parameter is provided, ask the user which profile they want to configure (default: DEFAULT)
Run
```
databricks auth login -p <profile>
```
with the determined profile name
- If a workspace host was provided, add
```
--host <workspace_host>
```
  to the command
- This ensures authentication is completed and the profile works
Check if the profile exists in ~/.databrickscfg
Ask the user to choose ONE of the following compute options:
- Cluster ID: Provide a specific cluster ID for an interactive/all-purpose cluster
- Serverless: Use serverless compute (sets
```
serverless_compute_id = auto
```
  )
Update the profile in ~/.databrickscfg with the selected configuration
Verify the configuration by displaying the updated profile section

Important Notes

Use the AskUserQuestion tool to present the compute options as a choice
Only add ONE of:
```
cluster_id
```
OR
```
serverless_compute_id
```
(never both)

For serverless, set

serverless_compute_id = auto

(not just

serverless = true

)

Preserve all existing settings in the profile (host, auth_type, etc.)
Format the configuration file consistently with proper spacing
The
```
databricks auth login
```
command will open a browser for OAuth authentication
SECURITY: NEVER print token values in plain text
- When displaying configuration, redact any
```
token
```
  field values (e.g.,
```
token = [REDACTED]
```
  )
- Inform the user they can view the full configuration at
```
~/.databrickscfg
```
- This applies to any output showing the profile configuration

Example Configurations

With Cluster ID:

[DEFAULT]
host       = https://adb-123456789.11.azuredatabricks.net/
cluster_id = 1217-064531-c9c3ngyn
auth_type  = databricks-cli

With Serverless:

[DEFAULT]
host                  = https://adb-123456789.11.azuredatabricks.net/
serverless_compute_id = auto
auth_type             = databricks-cli

With Token (display as redacted):

[DEFAULT]
host       = https://adb-123456789.11.azuredatabricks.net/
token      = [REDACTED]
cluster_id = 1217-064531-c9c3ngyn

View full configuration at: ~/.databrickscfg