Skip to content

Commit 78d2e21

Browse files
committed
EM feedback
1 parent 2eca2b9 commit 78d2e21

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

src/unify/profiles-sync/profiles-sync-setup/databricks-profiles-sync.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,10 +40,12 @@ A SQL warehouse is required for compute. Segment recommends the following size:
4040
- **Type** Serverless otherwise Pro
4141
- **Clusters**: Minimum of 2 - Maximum of 6
4242

43-
To improve the query performance of the Delta Lake, Segment recommends creating compact jobs per table using OPTIMIZE following [Databricks recommendations](https://docs.databricks.com/en/delta/optimize.html#){:target="_blank"}.
4443

4544
> success ""
46-
> Segment recommends manually starting your SQL warehouse in advance. If the SQL warehouse isn't running, Segment attempts to start the SQL warehouse to validate the connection when you hit the **Test Connection** button during setup.
45+
> To improve the query performance of the Delta Lake, Segment recommends creating compact jobs per table using OPTIMIZE following [Databricks recommendations](https://docs.databricks.com/en/delta/optimize.html#){:target="_blank"}. <br>
46+
47+
> info ""
48+
> Segment recommends manually starting your SQL warehouse in advance. If the SQL warehouse isn't running, Segment attempts to start the SQL warehouse to validate the connection and may experience a timeout when you hit the **Test Connection** button during setup.
4749
4850

4951
## Set up Databricks for Profiles Sync
@@ -89,9 +91,13 @@ Next, add SQL warehouse details about your compute resource.
8991

9092
### Step 5: Add the principal service client ID and client secret
9193

94+
> warning ""
95+
> Be sure to note the principal ID and the client secret Databricks generates in this step for later use.
96+
9297
Segment uses the service principal to access your Databricks workspace and associated APIs.
93-
1. Follow the [Databricks guide for adding a service principal to your account](https://docs.databricks.com/en/administration-guide/users-groups/service-principals.html#manage-service-principals-in-your-account){:target="_blank"}. This name can be anything, but Segment recommends something that identifies the purpose (for example, "Segment Profiles Sync"). Note the Application ID that Databricks generates for later use. Segment doesn't require Account admin or Marketplace admin roles.
94-
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.
98+
1. Follow the [Databricks guide for adding a service principal to your account](https://docs.databricks.com/en/administration-guide/users-groups/service-principals.html#manage-service-principals-in-your-account){:target="_blank"}. This name can be anything, but Segment recommends something that identifies the purpose (for example, "Segment Profiles Sync"). Note the principal application ID that Databricks generates for later use. Segment doesn't require Account admin or Marketplace admin roles.
99+
2. 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.
100+
95101

96102

97103
Once you've configured your warehouse, test the connection and click **Next**.

0 commit comments

Comments
 (0)