Skip to content

Commit d2a9f01

Browse files
committed
cleanup
1 parent 3d22701 commit d2a9f01

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

src/unify/data-graph/setup-guides/databricks-setup.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
---
22
title: Databricks Setup
3-
beta: true
43
plan: unify
5-
hidden: true
64
redirect_from:
75
- '/unify/linked-profiles/setup-guides/databricks-setup'
86
---
@@ -18,7 +16,7 @@ Segment recommends setting up a new Service Principal user and only giving this
1816

1917
If you already have a Service Principal user you'd like to use, grant it "Can use" permissions for your data warehouse and proceed to [Step 2](#step-2-create-a-catalog-for-segment-to-store-checkpoint-tables).
2018

21-
### a) Create a new Service Principal user
19+
### 1a) Create a new Service Principal user
2220
1. Log in to the Databricks UI as an Admin.
2321
2. Click **User Management**.
2422
3. Select the **Service principals** tab.
@@ -30,14 +28,15 @@ If you already have a Service Principal user you'd like to use, grant it "Can us
3028
9. Select the “Permissions” tab and click **Add Permissions**.
3129
10. Add the newly created Service Principal user and click **Save**.
3230

33-
### b) Add your Service Principal user to Warehouse User Lists
31+
### 1b) Add your Service Principal user to Warehouse User Lists
3432
1. Log in to the Databricks UI as an Admin.
3533
2. Navigate to SQL Warehouses.
3634
3. Select your warehouse and click **Permissions**.
3735
4. Add the Service Principal user and grant them “Can use” access.
3836
5. Click **Add**.
3937

4038
## Step 2: Create a catalog for Segment to store checkpoint tables
39+
4140
**Segment requires write access to this catalog for internal bookkeeping and to store checkpoint tables for the queries that are executed. Therefore, Segment recommends creating a new catalog for this purpose.** This is also the catalog you'll be required to specify when connecting Databricks with the Segment app.
4241

4342
> info ""
@@ -69,6 +68,7 @@ GRANT USAGE, SELECT, USE SCHEMA ON CATALOG `${catalog}` TO `${client_id}`;
6968
```
7069

7170
## (Optional) Step 5: Restrict read-only access
71+
7272
### Restrict read-only access to schemas
7373

7474
Restrict access to specific schemas by running the following SQL:
@@ -97,7 +97,7 @@ GRANT SELECT ON TABLE `${table_2}` TO `${client_id}`;
9797

9898
## Step 6: Validate the permissions of your Service Principal user
9999

100-
Sign in to the [Databricks CLI with your Client ID secret](https://docs.databricks.com/en/dev-tools/cli/authentication.html#oauth-machine-to-machine-m2m-authentication) and run the following SQL to verify the Service Principal user has the correct permissions for a given table.
100+
Sign in to the [Databricks CLI with your Client ID secret](https://docs.databricks.com/en/dev-tools/cli/authentication.html#oauth-machine-to-machine-m2m-authentication){:target="_blank"} and run the following SQL to verify the Service Principal user has the correct permissions for a given table.
101101

102102
> success ""
103103
> If this command succeeds, you can view the table.
@@ -109,6 +109,7 @@ SELECT * FROM ${schema}.${table} LIMIT 10;
109109
```
110110

111111
## Step 7: Connect your warehouse to Segment
112+
112113
To connect your warehouse to the Data Graph:
113114

114115
1. Navigate to **Unify > Data Graph**. This should be a Unify space with Profiles Sync already set up.

0 commit comments

Comments
 (0)