Databricks
Find the credentials you need to connect your Databricks workspace.
Connecting Databricks takes four pieces of information from your workspace: the host, a SQL warehouse ID, credentials, and (optionally) a default catalog and schema. Here's where to find each one.
Find your workspace host URL
Log in to your Databricks workspace and look at the URL in your browser's address bar. It will look like:
https://dbc-abc123-def4.cloud.databricks.comCopy the host portion without https:// — for example dbc-abc123-def4.cloud.databricks.com.
If your workspace uses Azure Databricks, the host will look like adb-1234567890123456.7.azuredatabricks.net.
Find your SQL warehouse ID
- In the Databricks sidebar, click SQL Warehouses (under the "SQL" section).
- Click the warehouse you want to use. If you don't have one, create a new SQL warehouse first.
- Go to the Connection details tab and find the HTTP Path field. It will look like:
/sql/1.0/warehouses/a1b2c3d4e5f67890The warehouse ID is the last segment after /warehouses/ — here, a1b2c3d4e5f67890.
Set up authentication
Choose one of the two methods:
- Click your profile icon (top-right corner) and select Settings.
- In the left sidebar, go to Developer → Access tokens.
- Click Generate new token.
- Give it a descriptive name (e.g., "Hyperagent"), set an expiration, and click Generate.
- Copy the token immediately — it will only be shown once. The token starts with
dapi.
- In your Databricks Account Console, go to Settings → App connections.
- Click Add service principal or use an existing one.
- Under the service principal, go to Secrets and click Generate secret.
- Copy the Client ID (UUID format) and the Client Secret (starts with
dose). - Make sure the service principal has access to the SQL warehouse you want to use.
Optional: catalog and schema
If you use Unity Catalog, you can specify a default catalog and schema to scope queries. To find your catalogs, go to Data in the Databricks sidebar and browse the catalog tree.
These fields are optional — if left blank, queries use the warehouse's default catalog and schema.
Once you have your credentials, return to the Databricks settings page in Hyperagent and enter them in the connection form.