Databricks - SQLBuild

Databricks requires the optional databricks-sql-connector dependency:

pip install 'sqlbuild[databricks]'
# or
uv pip install 'sqlbuild[databricks]'

Connection config

adapter = "databricks"

[connection]
server_hostname = "my-workspace.cloud.databricks.com"
http_path = "/sql/1.0/warehouses/abc123"
token = "dapi_my_access_token"
catalog = "my_catalog"
schema = "my_schema"

Field	Description
`server_hostname`	Databricks workspace hostname (required)
`http_path`	SQL warehouse or cluster HTTP path (required)
`token`	Personal access token (required)
`catalog`	Unity Catalog name (required)
`schema`	Default schema (optional)

Session initialization

On connect, SQLBuild runs USE CATALOG and USE SCHEMA statements to set the session context.