> ## Documentation Index
> Fetch the complete documentation index at: https://zenskar.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Databricks Lakehouse

## 🐕‍🦺 Setup guide

Zenskar's Databricks data-source connector syncs data with [Delta Lake](https://delta.io/) on Databricks Lakehouse. Each stream is written to its own Delta table.

> 🚧 Note
>
> You **must** use [Unity Catalog](https://www.databricks.com/product/unity-catalog) to use this connector.

### ⚙️ Step 1: set up data source and type

1. Log into your Zenskar account.
2. In the left navigation bar, click **Metering** > **Data Sources**.
3. In the top-right corner, click **+ ADD DATA SOURCE**.
4. In the **Set Up Source** section of the **Add New Data Source** page, enter a name for the Databricks data source connection.
5. Select **Databricks** from the **Source Type** drop-down menu.

![](https://assets.zenskar.com/20240301/data-sources-databricks-lakehouse-set-up-data-source-type.png)

### ⚙️ Step 2: configure data source

In the **Source Config** section of the **Add New Data Source** page, fill in the following details:

* **Databricks Access Token**: refer the [Databricks authentication](/docs/20240301/third-party-integrations/data-sources/databricks-lakehouse#databricks-authentication) section.
* **Workspace Hostname**: the hostname of the [Databricks workspace](https://docs.databricks.com/en/admin/workspace/index.html). Refer the Section [Retrieve Databricks workspace details](/docs/20240301/third-party-integrations/data-sources/databricks-lakehouse#retrieve-databricks-workspace-details) section.

> A workspace is a Databricks deployment in a cloud service account. It provides a unified environment for working with Databricks assets for a specified set of users.

* **Port Number**: refer the [Retrieve Databricks workspace details](/docs/20240301/third-party-integrations/data-sources/databricks-lakehouse#retrieve-databricks-workspace-details) section.
* **HTTP Path**: refer the [Retrieve Databricks workspace details](/docs/20240301/third-party-integrations/data-sources/databricks-lakehouse#retrieve-databricks-workspace-details) section.

![](https://assets.zenskar.com/20240301/data-sources-databricks-lakehouse-configure-data-source.png)

## Retrieve Databricks workspace details

1. Open the workspace console.
2. Open your SQL warehouse:

![](https://assets.zenskar.com/20240301/data-sources-databricks-lakehouse-retrieve-databricks-workspace-details.png)

3. Open the **Connection Details** tab:

![](https://assets.zenskar.com/20240301/data-sources-databricks-lakehouse-retrieve-databricks-workspace-details-02.png)

### Databricks authentication

#### Generate access token

1. Open your workspace console.
2. Click on the named drop-down menu at the top-right corner, and click on **Settings** option.
3. Navigate to **User Settings** > **Developer**, and click on **Generate new token**, as shown below.

![](https://assets.zenskar.com/20240301/data-sources-databricks-lakehouse-generate-access-token.png)

4. Enter a description for the token and its lifetime. You can leave blank **Lifetime (days)** blank for a permanent token:

![](https://assets.zenskar.com/20240301/data-sources-databricks-lakehouse-generate-access-token-02.png)

<br />
