Manage Databricks Data Sources

ALTR must be connected to a Databricks Metastore to enforce tag-based masking and classification on it. ALTR connects to Databricks cloud-to-cloud, through a service principal and Unity Catalog APIs — there is no proxy or other component to install in your environment.

Prerequisites

Before connecting, complete the account setup described in Preparing Your Databricks Account: the altr-service-group group, a service principal with an OAuth secret, the service principal’s membership in the Metastore admins group, and a workspace cluster. That page also lists the requirements and limitations for the Databricks environment ALTR connects to.

Connect a Databricks Data Source

To connect a Databricks Metastore, gather the workspace hostname, service principal ID, cluster ID, and OAuth secret — see Locate Your Databricks Connection Details for where to find each value.

To connect a Databricks Metastore:

1. Select Data Configuration > Data Sources in the navigation menu.
2. Click Add Data Source.
3. On the Databricks card, click Select.
4. Enter a Display Name for the connection.
5. Enter the Workspace Hostname.
6. Enter the Service Principal ID.
7. Enter the Cluster ID.
8. Enter the OAuth Secret.
9. Click Connect Data Source. ALTR validates connectivity and permissions before completing the connection.

Caution

You cannot edit the Cluster ID after connecting. To change it, disconnect and reconnect the Metastore.

Check a Databricks Connection

Check a data source’s connection if you suspect an issue — for example, if you’re seeing errors or the data source has changed.

To check a Databricks connection:

1. Select Data Configuration > Data Sources in the navigation menu.
2. Select the data source you want to test.
3. Open the Connection Details tab.
4. Click Check Connection.

Remove a Databricks Data Source

Remove a Databricks data source if its service principal is having problems or another issue has occurred with the connection.

To remove a data source:

1. Select Data Configuration > Data Sources in the navigation menu.
2. Select the data source you want to disconnect.
3. Click Remove Data Source. Removal can take up to several minutes to complete.