Configuration

LazyDatabricks uses the same configuration as the Databricks SDK, supporting environment variables, config files, and CLI flags.

Configuration Priority

LazyDatabricks resolves auth in this order:

1. CLI flags (highest priority)
2. Environment variables
3. ~/.databrickscfg profile

Environment Variables

export DATABRICKS_HOST=https://adb-xxx.azuredatabricks.net
export DATABRICKS_TOKEN=dapi...
export DATABRICKS_CLUSTER_ID=0123-456789-abcdef  # optional

Config File

Create ~/.databrickscfg with one or more profiles:

[DEFAULT]
host = https://adb-xxx.azuredatabricks.net
token = dapi...
cluster_id = 0123-456789-abcdef

[staging]
host = https://adb-yyy.azuredatabricks.net
token = dapi...

LazyDatabricks will use the DEFAULT profile by default, or the first available profile if no default exists.

CLI Flags

Override any setting via command line:

lazydatabricks --host https://... --token dapi... --cluster-id 0123...
lazydatabricks --profile staging

Supported Auth Methods

• Personal Access Token (PAT) — Standard token-based auth
• OAuth M2M — Service Principal / Machine-to-Machine OAuth
• Azure CLI — Use az login credentials

The auth method is auto-detected from your configuration.

Verify Connection

Test your configuration:

lazydatabricks test