# Databricks for AWS Guide

Satori streamlines and simplifies the process of controlling access to data in Databricks. Satori reduces the risk of data leakage caused by misconfiguring users or permissions.

Databricks Unity Catalog is designed for centralized data governance. Satori integrates with several of its features such as user management, access controls and audit logs.

It only takes a few minutes to get started with Satori. Ensure that you have the prepared following in advance:

- Access to the **Satori Management Console**.
- The hostname of your **Databricks Workspace**.

## Configuring your Databricks Account

To grant Satori access to Databricks on AWS, go to your Databricks account and get the following configuration details:

### Extract the Account Information from Databricks

To extract the relevant Account information from Databricks, perform the following steps:

1. **Get your Databricks Instance** - Login to your Databricks account and follow the instructions to obtain your databricks-instance from the [Databricks instructions](https://docs.databricks.com/workspace/workspace-details.html#:~:text=If%20you%20log%20into%20https,have%20a%20unique%20workspace%20ID). For example: `dbc-12345678-abcd.cloud.databricks.com`.
2. **Get your Account ID** - Go to the **Databricks Admin Console**, click on your username located in the right hand corner of the interface and copy the **Account ID**. For example: `12345678-abcd-cdef-hijk-a2bdf1723485`.
3. **Get your SQL Warehouse ID** - In the Workspace console select the **SQL Warehouse** tab and copy the ID value. For example: `92748d3f4d1346af`.

> Note: Satori recommends provisioning a dedicated SQL warehouse for the Satori workload, a minimal `SQL Classic` instance is sufficient.

### Creating a New Satori Service Principal in Databricks

1. Create a new **Satori Service Principal** to manage your Databricks instance. Go to the **User Management view**, select the **Service Principals** tab, add a **new Satori Service Principal**.
2. Generate an **OAuth secret** for service principal. Select the newly created service principal and click the generate secret button. (Copy the secret and Application (client) ID for your Satori configuration)
3. Identify which group manages the metastore. This configuration is located in the **Metastore configuration** section in the **Catalog view**.
4. In the **Databricks User Management** view, select the **Groups tab** and add the **Satori Service Principal** to the group identified in the previous step.
5. Go to the **Workspace** view and select your **Workspace**, click the **Permissions Tab** and click the **Add Permissions** button. Now add the **Admin** permission to the **Satori Service Principal**.
6. Go to the **Databricks Workspace** and click on the **SQL Warehouses** view. Now locate the **Satori Warehouse** and grant the **Satori Service Principle** permission by selecting the **Can Use** option. (Copy the warehouse ID for your Satori configuration).

### Databricks Information Configuration Checklist

Ensure that you have obtained the following details:

- Databricks Instance
- Account ID
- SQL Warehouse ID
- Application (client) ID (Satori service principal).
- Client Secret Value (Satori service principal).

### Enabling the Audit Log on your Account

To take advantage of the system tables and the associated resources on AWS, refer to the Databricks documentation [Monitor usage with system tables](https://docs.databricks.com/en/administration-guide/system-tables/index.html) and enable the Audit logs module on your account using the **Enable a system schema** API.

## Configuring your Satori Data Store

01. Login to the **Satori Management Console** [https://app.satoricyber.com](https://app.satoricyber.com/)
02. In the **Data Stores view**, click the plus button to **Add a New Data Store**.
03. Select the **Databricks** option.
04. Now, provide an **informative name** for the data store, for example: **Sales Data Warehouse**.
05. Enter the **Databricks Workspace URL** into the Databrick Instance input field.
06. Enter your databricks **Account ID**.
07. Enter your databricks **SQL Warehouse ID**.
08. Select the **AWS Service Principal Authentication type** from the drop menu.
09. Enter the **Application (client) ID** and **Secret value** of the Satori service principal.
10. Choose a **Data Access Controller** to use for this data store by selecting the **Cloud provider** and **Region**.
11. Click the **Add New Data Store** button.
12. You will be redirected to the **Data Stores list view**.

### Testing your Databricks Integration

1. Go to your newly created Databricks instance and select the **Integration Tab**
2. Click the **Test Connection** button.

## Limitations

To learn more about Databricks limitations and how they may impact your data, [click here.](/content/docs/datastores/databricks-limitations/index.html)