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/reverse-etl/index.md
+22-20Lines changed: 22 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -65,16 +65,9 @@ To add your first model:
65
65
5. Click **Preview** to see a preview of the results of your SQL query. The data from the preview is extracted from the first 10 records of your warehouse.
66
66
6. Click **Next**.
67
67
7. Enter your **Model Name**.
68
-
8. Select the Schedule type for the times you want the model’s data to be extracted from your warehouse. You can choose from:
69
-
***Interval**: Extractions perform based on a selected time cycle.
70
-
***Day and time**: Extractions perform at specific times on selected days of the week.
71
-
9. Select how often you want the schedule to sync in **Schedule configuration**.
72
-
* For an **Interval** schedule type, you can choose from: 15 minutes, 30 minutes, 1 hour, 2 hours, 4 hours, 6 hours, 8 hours, 12 hours, 1 day.
73
-
* 15 minutes is considered real-time for warehouse syncs
74
-
* For a **Day and time** schedule type, you can choose the day(s) you’d like the schedule to sync as well as the time. You can only choose to sync the extraction at the top of the hour.
75
-
10. Click **Create Model**.
68
+
8. Click **Create Model**.
76
69
77
-
To add multiple models to your source, repeat steps 1-10 above.
70
+
To add multiple models to your source, repeat steps 1-8 above.
78
71
79
72
### Step 3: Add a destination
80
73
Once you’ve added a model, you need to add a destination. In Reverse ETL, destinations are the business tools or apps you use that Segment syncs the data from your warehouse to.
@@ -103,24 +96,33 @@ To create a mapping:
103
96
1. Navigate to **Conections > Destinations** and select the **Reverse ETL** tab.
104
97
2. Select the destination that you want to create a mapping for.
105
98
3. Click **Add Mapping**.
106
-
2. Select the model to sync from.
107
-
3. Select the **Action** you want to sync and click **Next**.
99
+
4. Select the model to sync from.
100
+
5. Select the **Action** you want to sync and click **Next**.
108
101
* Actions determine the information sent to the destination. The list of Actions will be unique to each destination.
109
-
4. In the **Select record to map and send** section, select which records to send to your destination after Segment completes extracting data based on your model. You can choose from:
102
+
6. In the **Select record to map and send** section, select which records to send to your destination after Segment completes extracting data based on your model. You can choose from:
110
103
* Added records
111
104
* Updated records
112
105
* Added or updated records
113
106
* Deleted records
114
-
5. Select a test record to preview the fields that you can map to your destination in the **Add test record** field.
115
-
6. Define how to map the record columns from your model to your destination in the **Select Mappings** section.
116
-
* You map the fields that come from your source, to fields that the destination expects to find. Fields on the destination side depend on the type of action selected.
117
-
* If you're setting up a destination action, depending on the destination, some mapping fields may require data to be in the form of an object or array. See the [supported objects and arrays for mapping](#supported-object-and-arrays).
118
-
7. Click **Create Mapping**.
119
-
8. Select the destination you’d like to enable on the **My Destinations** page under **Reverse ETL > Destinations**.
120
-
9. Turn the toggle on for the **Mapping Status**. Events that match the trigger condition in the mapping will be sent to the destination.
107
+
7. Select a test record to preview the fields that you can map to your destination in the **Add test record** field.
108
+
8. Select the Schedule type for the times you want the model’s data to be extracted from your warehouse. You can choose from:
109
+
***Interval**: Extractions perform based on a selected time cycle.
110
+
***Day and time**: Extractions perform at specific times on selected days of the week.
111
+
9. Select how often you want the schedule to sync in **Schedule configuration**.
112
+
* For an **Interval** schedule type, you can choose from: 15 minutes, 30 minutes, 1 hour, 2 hours, 4 hours, 6 hours, 8 hours, 12 hours, 1 day.
113
+
* 15 minutes is considered real-time for warehouse syncs
114
+
* For a **Day and time** schedule type, you can choose the day(s) you’d like the schedule to sync as well as the time.
115
+
* You can only choose to start the **Extraction** at the top of the hour.
116
+
* Scheduling multiple **Extractions** to start at the same time inside the same data warehouse can cause extracion errors
117
+
10. Define how to map the record columns from your model to your destination in the **Select Mappings** section.
118
+
* You map the fields that come from your source, to fields that the destination expects to find. Fields on the destination side depend on the type of action selected.
119
+
* If you're setting up a destination action, depending on the destination, some mapping fields may require data to be in the form of an object or array. See the [supported objects and arrays for mapping](#supported-object-and-arrays).
120
+
11. Click **Create Mapping**.
121
+
12. Select the destination you’d like to enable on the **My Destinations** page under **Reverse ETL > Destinations**.
122
+
13. Turn the toggle on for the **Mapping Status**. Events that match the trigger condition in the mapping will be sent to the destination.
121
123
* If you disable the mapping state to the destination, events that match the trigger condition in the mapping won’t be sent to the destination.
122
124
123
-
To add multiple mappings from your warehouse to your destination, repeat steps 1-9 above.
125
+
To add multiple mappings from your warehouse to your destination, repeat steps 1-13 above.
124
126
125
127
## Using Reverse ETL
126
128
After you've followed [all four steps](/docs/connections/reverse-etl/#getting-started) and set up your source, model, destination, and mappings for Reverse ETL, your data will extract and sync to your destination(s) right away if you chose an interval schedule. If you set your data to extract at a specific day and time, the extraction will take place then.
0 commit comments