Skip to content
ALTR ALTR ALTR Documentation

Locate Your Databricks Connection Details

Connecting a Databricks data source to ALTR requires four values from your Databricks workspace: the workspace hostname, the service principal ID, the cluster ID, and an OAuth secret. For the connect procedure itself, see Manage Databricks Data Sources.

Workspace Hostname

Section titled “Workspace Hostname”

The workspace hostname is the URL shown in your browser’s address bar while working in your Databricks workspace.

The Databricks workspace with its hostname visible in the browser address bar.

Service Principal ID

Section titled “Service Principal ID”

The service principal ID is the UUID Databricks assigns to the service principal you created for ALTR.

The Databricks service principal detail page showing its application ID.

Cluster ID

Section titled “Cluster ID”

The cluster ID is listed under the configuration tab for the compute cluster ALTR uses.

To locate the cluster ID:

  1. From your workspace, select Compute.
  2. Select the cluster configured for your service principal.
  3. Open the Configuration tab.
  4. Scroll to Tags and expand Automatically added tags. The cluster ID is listed there.

The Databricks cluster configuration tab with its cluster ID tag expanded.

OAuth Secret

Section titled “OAuth Secret”

The OAuth secret is generated once, at creation time, from the service principal’s credentials page.

To generate an OAuth secret:

  1. From the service principal’s detail page, select Generate Secret.
  2. Set an expiration date for the secret. Databricks displays the secret value once. Record it immediately — you cannot retrieve it again after leaving this screen.

The Databricks service principal's generated OAuth secret, with the secret value blurred.

© 2026 ALTR Solutions, Inc.