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
+9-8Lines changed: 9 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ Using a practical example of how Segment connects and then merges anonymous prof
9
9
10
10
## Case study: anonymous site visits lead to profile merge
11
11
12
-
To help illustrate the possible entries and values populated into Profiles Sync tables, consider the following scenario.
12
+
To help illustrate the possible entries and values populated into Profiles Sync tables, view the event tabs below and consider the following scenario.
13
13
14
14
Suppose the following four events lead to the creation of two separate profiles:
15
15
@@ -79,7 +79,7 @@ Profiles Sync tracks and provides information about these events through a set o
79
79
80
80
Using the events from the profile merge case study, Segment would land the following tables as part of Profiles Sync.
81
81
82
-
### The `id_graph_updates` table
82
+
### The id_graph_updates table
83
83
84
84
The `id_graph_updates` table maps between the following:
85
85
@@ -109,7 +109,7 @@ Segment shows the complete history of every profile. If, later, `profile_1` merg
109
109
110
110
If you’ll use Profiles Sync to build models, refer to the `id_graph` model, which can help you put together a complete view of a customer.
111
111
112
-
### The `external_id_mapping_updates` table
112
+
### The external_id_mapping_updates table
113
113
114
114
This table maps Segment-generated identifiers, like `segment_id`, to external identifiers that your users provide.
115
115
@@ -127,7 +127,7 @@ The anonymous site visits sample used earlier would generate the following event
127
127
128
128
In this table, Segment shows three observed identifiers. For each of the three identifiers, Segment outputs the Segment ID initially associated with the identifier.
129
129
130
-
### `identifies`, `page`, `screens`, and track tables
130
+
### The identifies, page, screens, and track tables
131
131
132
132
These tables show the instrumented events themselves. Entries in these tables reflect payloads that you instrument according to the Segment spec.
133
133
@@ -189,11 +189,11 @@ Follow the steps below to change your schema name:
189
189
> To get started with your table materializations, try Segment's [open-source dbt models](https://github.com/segmentio/profiles-sync-dbt){:target="_blank"}, or materialize views with your own tools.
190
190
191
191
> warning ""
192
-
> Please note that dbt models are in beta and need modifications to run efficiently on BigQuery, Synapse, and Postgres warehouses. Segment is actively working on this feature.
192
+
> Please note that dbt models are in beta and need modifications to run efficiently on BigQuery, Synapse, and Postgres warehouses. Segment is actively working on this feature.
193
193
194
194
Every customer profile (or `canonical_segment_id`) will be represented in each of the following tables.
195
195
196
-
### `id_graph` table
196
+
### The id_graph table
197
197
198
198
This table represents the current state of your identity graph, showing only where a `segment_id` is now understood to point.
199
199
@@ -204,9 +204,10 @@ The most recent entry for each `segment_id` from `id_graph_updates` reflects thi
204
204
|`profile_1`|`profile_1`| 2022-05-02 14:01:00 |
205
205
|`profile_2`|`profile_1`| 2022-06-22 10:48:00 |
206
206
207
+
207
208
Segment drops most diagnostic information from this table, since it’s designed for reference use. In this case, you’d learn that any data references to `profile_2` or `profile_1` now map to the same customer, `profile_1`.
208
209
209
-
### `external_id_mapping` table
210
+
### The external_id_mapping table
210
211
211
212
Use this table to view the full, current-state mapping between each external identifier you’ve observed and its corresponding, fully-merged `canonical_segment_id`.
212
213
@@ -219,7 +220,7 @@ In the case study example, you’d see the following:
Use the `profile_traits` table for a singular view of your customer. With this table, you can view all custom traits, computed traits, SQL traits, audiences, and journeys associated with a profile in a single row.
0 commit comments