You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/storage/databricks-delta-lake/databricks-delta-lake-aws.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,25 +27,25 @@ Segment supports both OAuth and personal access token (PAT) for authentication.
27
27
28
28
As you set up Databricks, keep the following key terms in mind.
29
29
-**Databricks Workspace URL**: The base URL for your Databricks workspace.
30
-
-**Service principal Application ID**: The ID tied to the service principal you'll create for Segment.
30
+
-**Service Principal Application ID**: The ID tied to the service principal you'll create for Segment.
31
31
-**Service Principal Secret/Token**: The client secret or PAT you'll create for the service principal.
32
32
-**Target Unity Catalog**: The catalog where Segment lands your data.
33
33
-**Workspace Admin Token** (*PAT only*): The access token you'll generate for your Databricks workspace admin.
34
34
35
35
## Setup
36
36
37
-
Use the following nine steps to set up your Databricks destination with AWS.
37
+
Use the following nine steps to set up your Databricks Delta Lake destination with AWS.
38
38
39
39
### Step 1: Find your Databricks Workspace URL
40
40
41
-
The workspace URL is used by you and Segment to access your workspace API.
41
+
You'll use the Databricks workspace URL, along with Segment, to access your workspace API.
42
42
- Check your browser's address bar when inside the workspace. The workspace URL will look something like: `https://<workspace-deployment-name>.cloud.databricks.com`. Remove any characters after this portion and note the URL for later use.
43
43
44
44
### Step 2: Create a service principal
45
45
46
-
The service principal is used by Segment to access your Databricks workspace and associated APIs.
47
-
1. Follow the Databricks [guide](https://docs.databricks.com/en/administration-guide/users-groups/service-principals.html#manage-service-principals-in-your-account){:target="_blank"} for adding a service principal to your account and assigning to the workspace. This name can be anything, but Segment recommends something that identifies the purpose (for example, `Segment Storage Destinations`). Note the Application ID that Databricks generates for later use. Segment doesn't require Account admin or Marketplace admin roles.
48
-
2. (*OAuth only*) Follow the Databricks instructions to [generate an OAuth secret](https://docs.databricks.com/en/dev-tools/authentication-oauth.html#step-2-create-an-oauth-secret-for-a-service-principal){:target="_blank"}. Note the secret generated by Databricks for later use. Once you navigate away from this page the secret is no longer visible. If you lose or forget the secret, you can delete the existing secret and create a new one.
46
+
Segment uses the service principal to access your Databricks workspace and associated APIs.
47
+
1. Follow the Databricks [guide](https://docs.databricks.com/en/administration-guide/users-groups/service-principals.html#manage-service-principals-in-your-account){:target="_blank"} for adding a service principal to your account. This name can be anything, but Segment recommends something that identifies the purpose (for example, "Segment Storage Destinations"). Note the Application ID that Databricks generates for later use. Segment doesn't require Account admin or Marketplace admin roles.
48
+
2. (*OAuth only*) Follow the Databricks instructions to [generate an OAuth secret](https://docs.databricks.com/en/dev-tools/authentication-oauth.html#step-2-create-an-oauth-secret-for-a-service-principal){:target="_blank"}. Note the secret generated by Databricks for later use. Once you navigate away from this page, the secret is no longer visible. If you lose or forget the secret, delete the existing secret and create a new one.
49
49
50
50
### Step 3: Enable entitlements for the service principal on the workspace
Copy file name to clipboardExpand all lines: src/connections/storage/databricks-delta-lake/databricks-delta-lake-azure.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,11 +28,11 @@ As you set up Databricks, keep the following key terms in mind.
28
28
29
29
## Set up Databricks with Azure
30
30
31
-
Use the following eight steps to setup your Databricks destination with Azure.
31
+
Use the following eight steps to setup your Databricks Delta Lake destination with Azure.
32
32
33
33
### Step 1: Find your Databricks Workspace URL
34
34
35
-
Your Databricks Workspace URL is used by you and Segment to access your workspace API.
35
+
You'll use the Databricks workspace URL, along with Segment, to access your workspace API.
36
36
37
37
Check your browser's address bar when in your workspace. The workspace URL will look something like: `https://<workspace-deployment-name>.azuredatabricks.net`. Remove any characters after this portion and note this value for later use.
38
38
@@ -108,7 +108,7 @@ This catalog is the target catalog where Segment lands your schemas/tables.
108
108
1. Follow the Databricks guide for [creating a catalog](https://learn.microsoft.com/en-us/azure/databricks/data-governance/unity-catalog/create-catalogs){:target="_blank"}.
109
109
- Select the storage location you created earlier. The catalog name can be any valid catalog name (for example, "Segment"). Note this name for later use.
110
110
2. Select the newly-created catalog.
111
-
1. Click the Permissions tab, then **Grant**.
111
+
1. Click the Permissions tab, then click **Grant**.
112
112
2. Select the Segment service principal from the dropdown.
113
113
3. Check `ALL PRIVILEGES`, then click **Grant**.
114
114
@@ -118,4 +118,4 @@ This step links a Segment source to your Databricks workspace/catalog.
118
118
1. Navigate to `https://app.segment.com/<WORKSPACE_SLUG>/destinations/catalog/databricks-delta-lake`.
119
119
2. Click **Add Destination**, select a source, then click **Next**.
120
120
3. Enter the name for your destination, then click **Create destination**.
121
-
4. Enter the connection settings using the values noted above (leave the Service Principal fields blank).
121
+
4. Enter the connection settings using the values noted above (leave the service principal fields blank).
0 commit comments