> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/data-connections/databricks.md).

# Databricks

Connect Telmai to Databricks.

Telmai reads tables from Databricks through a cluster's JDBC endpoint and signs in with a personal access token.

## Before you connect

1. Get the cluster's connection details. In your Databricks workspace, click **Compute** in the sidebar and open the cluster. On the **Configuration** tab, expand **Advanced options** and click the **JDBC/ODBC** tab. Copy the **Server Hostname**, **Port** and **HTTP Path**. See [Get connection details for a Databricks compute resource](https://docs.databricks.com/aws/en/integrations/compute-details).
2. Create a personal access token. Click your username in the top bar and select **Settings**, then **Developer**. Next to **Access tokens**, click **Manage**, then **Generate new token**. Copy the token. See [Databricks personal access tokens](https://docs.databricks.com/aws/en/dev-tools/auth/pat).

The token's user must be able to read the tables you want to monitor.

## Connection fields

On the **Connections** page, click **Add connection** and choose **Databricks**. See [Add a connection](https://docs.telm.ai/telmai/connect-to-data.md#add-a-connection) for the full flow.

| Field                       | Description                                                                                                                                                                                            |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Host**                    | The cluster's **Server Hostname**, for example `dbc-a1b2c3d4-e5f6.cloud.databricks.com`.                                                                                                               |
| **Port**                    | The cluster's **Port**, usually `443`.                                                                                                                                                                 |
| **HTTP Path**               | The cluster's **HTTP Path**, for example `sql/protocolv1/o/1234567890123456/0123-456789-abcdefgh`.                                                                                                     |
| **Read from Unity Catalog** | Optional. Makes the scan read tables directly from Unity Catalog. Check it only when Telmai's scan jobs run in Databricks and the service account they run as can read the data; otherwise scans fail. |
| **Token**                   | The personal access token, under **Credentials**.                                                                                                                                                      |

## Asset fields

Click **Add assets** on the connection. See [Add assets](https://docs.telm.ai/telmai/connect-to-data.md#list-of-connectors-enabled-by-default).

| Field       | Description                                                                                                           |
| ----------- | --------------------------------------------------------------------------------------------------------------------- |
| **Schema**  | The schema that holds the tables, for example `sales`.                                                                |
| **Catalog** | Optional. The Unity Catalog catalog that holds the schema, for example `main`. If empty, the default catalog is used. |
