Skip to content

Commit f48f686

Browse files
committed
Add Reverse ETL steps
1 parent 2080c4c commit f48f686

File tree

1 file changed

+20
-3
lines changed
  • src/segment-app/extensions

1 file changed

+20
-3
lines changed

src/segment-app/extensions/dbt.md

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ With Segment's dbt integration, you can:
1010
- Use centralized dbt models to set up Reverse ETL.
1111
- Trigger Reverse ETL syncs from dbt jobs.
1212

13-
<!-- This page explains... -->
13+
This page explains how to set up a dbt Model and then use the model with Reverse ETL.
1414

1515
> info ""
1616
> 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:
3434

3535
Follow these steps to connect the Git repository that stores your dbt Models:
3636

37-
1. In your Segment Workspace, go to **Settings > Extensions**.
37+
1. In your Segment Workspace, navigate to **Settings > Extensions**.
3838
2. Click **Set up Git sync**.
3939
3. On the **Configure service credentials** page, select a service and protocol, add your SSH private key, then click **Next**.
4040
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
4747

4848
To set up dbt Cloud:
4949

50-
1. In your Segment Workspace, go to **Settings > Extensions**.
50+
1. In your Segment Workspace, navigate to **Settings > Extensions**.
5151
2. Click **Manage dbt CLoud**.
5252
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

Comments
 (0)