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/segment-app/extensions/dbt.md
+20-3Lines changed: 20 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ With Segment's dbt integration, you can:
10
10
- Use centralized dbt models to set up Reverse ETL.
11
11
- Trigger Reverse ETL syncs from dbt jobs.
12
12
13
-
<!--This page explains... -->
13
+
This page explains how to set up a dbt Model and then use the model with Reverse ETL.
14
14
15
15
> info ""
16
16
> Extensions, including Segment's dbt integration, is currently in public beta and is governed by Segment's [First Access and Beta Preview Terms](https://www.twilio.com/en-us/legal/tos){:target="_blank"}.
@@ -34,7 +34,7 @@ To set up the dbt integration, you'll need:
34
34
35
35
Follow these steps to connect the Git repository that stores your dbt Models:
36
36
37
-
1. In your Segment Workspace, go to **Settings > Extensions**.
37
+
1. In your Segment Workspace, navigate to **Settings > Extensions**.
38
38
2. Click **Set up Git sync**.
39
39
3. On the **Configure service credentials** page, select a service and protocol, add your SSH private key, then click **Next**.
40
40
4. In the **Connect source** window, select a Reverse ETL warehouse source from the dropdown, then click **Save**.
@@ -47,6 +47,23 @@ You can also use dbt Cloud to schedule Reverse ETL syncs after a dbt Cloud job s
47
47
48
48
To set up dbt Cloud:
49
49
50
-
1. In your Segment Workspace, go to **Settings > Extensions**.
50
+
1. In your Segment Workspace, navigate to **Settings > Extensions**.
51
51
2. Click **Manage dbt CLoud**.
52
52
3. Add your dbt Cloud API key, and, optionally, a custom subdomain. Click **Save**.
53
+
54
+
### Model syncs
55
+
56
+
After you set up dbt, Segment runs an initial sync to load models from your connected Git repository. This initial sync lets you use the most recent models when you set up Reverse ETL. In addition to Segment's initial dbt sync, you can also trigger manual dbt model syncs.
57
+
58
+
### Use a model with Reverse ETL
59
+
60
+
After you've successfully set up dbt with a warehouse and connected to your Git repository, you can select dbt models for use with Reverse ETL by following these steps:
61
+
62
+
1. In your Segment Workspace, navigate to **Connections > Sources** and select the Reverse ETL tab.
63
+
2. Click **+Add Reverse ETL source** , select your source, then click **Add Model**.
64
+
3. Click **dbt Models** as your modeling method, then select and preview a model from the dbt model dropdown.
65
+
4. Add a primary key, then click **Preview your model**.
66
+
5. Click **Next**.
67
+
6. Enter your **Model Name**, then click **Create Model**.
68
+
69
+
To change a connected model, ensure that you've removed it from all active Reverse ETL syncs.
0 commit comments