databricks-config

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

1. •

   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)
2. •

   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
3. •

   Check if the profile exists in ~/.databrickscfg

4. •

   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)
5. •

   Update the profile in ~/.databrickscfg with the selected configuration

6. •

   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