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/unify/profiles-sync/tables.md
+48-5Lines changed: 48 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,9 +75,15 @@ Initially, Segment generates two profiles for the first three calls. In the fina
75
75
76
76
Profiles Sync tracks and provides information about these events through a set of tables, which you’ll learn about in the next section.
77
77
78
-
## Tables Segment lands
79
78
80
-
Using the events from the profile merge case study, Segment would land the following tables as part of Profiles Sync.
79
+
## Profile raw tables
80
+
81
+
Profile raw tables contain records of changes to your Segment profiles and Identity Graph over time.
82
+
83
+
With raw tables, you have full control over the materialization of Profiles in your warehouse, as well as increased observibility.
84
+
85
+
Raw tables contain complete historical data when using historical backfill.
86
+
81
87
82
88
### The id_graph_updates table
83
89
@@ -88,7 +94,7 @@ The `id_graph_updates` table maps between the following:
88
94
89
95
As a result, this table contains information about the creation and merging of profiles, as well as the specific events that triggered those changes.
90
96
91
-
Using the profile merge scenario, Segment would generate three new entries to this table:
97
+
Using the events from the profile merge case study, Segment would generate three new entries to this table:
92
98
93
99
<divstyle="overflow-x:auto;"markdown=1>
94
100
@@ -159,9 +165,24 @@ In the event that two profiles merge, Segment only updates the `profile_traits_u
159
165
160
166
From the `profile_traits_updates` table, use Segment's [open-source dbt models](https://github.com/segmentio/profiles-sync-dbt){:target="_blank"}, or your own tools to materialize the [`profile_traits`](#the-profile-traits-table) table with all profiles and associated profile traits in your data warehouse.
161
167
162
-
### The identifies, page, screens, and track tables
168
+
## Event type tables
169
+
170
+
Event type tables provide a complete history for each type of event. Segment syncs events based on the event sources you've connected to Unify.
171
+
172
+
Identity Resolution processes these events, and includes a `segment_id`, enabling the data to be joined into a single Profile record.
173
+
174
+
> success ""
175
+
> Event type tables will have 2 months of historical data on backfill.
176
+
177
+
Event type tables includes the following tables:
178
+
179
+
-`Identify`
180
+
-`Page`
181
+
-`Group`
182
+
-`Screen`
183
+
-`Alias`
184
+
-`Track`
163
185
164
-
These tables show the instrumented events themselves. Entries in these tables reflect payloads that you instrument according to the Segment spec.
165
186
166
187
These event tables are similar to the tables landed by Segment warehouse integrations, with the following exceptions:
167
188
@@ -220,13 +241,31 @@ If your space has the same name as a source connected to your Segment Warehouse
220
241
Follow the steps below to change your schema name:
221
242
{% endcomment %}
222
243
244
+
## Track event tables
245
+
246
+
Track event tables provide a complete event history, with one table for each unique named Track event. Segment syncs events based on the event sources you've connected to Unify.
247
+
248
+
These tables include a full set of Track event properties, with one column for each property.
249
+
250
+
Segment's Identity Resolution has processed these events, which contain a `segment_id`, enabling the data to be joined into a single profile record.
251
+
252
+
> success ""
253
+
> These tables will have two months of historical data on backfill.
254
+
255
+
> info ""
256
+
> To view and select individual track tables, edit your sync settings after you enable Profiles Sync, and wait for the initial sync to complete.
257
+
258
+
259
+
223
260
## Tables Segment materializes
224
261
225
262
With Profiles Sync, you can access the following three tables that Segment materializes for a more complete view of your profile:
These materialized tables provide a snapshot of your Segment profiles, batch updated according to your sync schedule.
268
+
230
269
Visit the [selective sync](/docs/unify/profiles-sync/#using-selective-sync) setup page to enable the following materialized tables, which Segment disables by default.
231
270
232
271
You can also use [historical backfill](/docs/unify/profiles-sync/#using-historical-backfill) with tables Segment materializes.
@@ -312,6 +351,10 @@ This table has the following columns:
312
351
|`timestamp`| The UTC-converted timestamp set by the Segment library. |
313
352
314
353
354
+
<!--
355
+
To do: add some info here about when customers might want to materialize tables themselves
0 commit comments