Skip to content

Commit 044bd3f

Browse files
committed
Update table organization
1 parent e9c6a2c commit 044bd3f

File tree

1 file changed

+48
-5
lines changed

1 file changed

+48
-5
lines changed

src/unify/profiles-sync/tables.md

Lines changed: 48 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -75,9 +75,15 @@ Initially, Segment generates two profiles for the first three calls. In the fina
7575

7676
Profiles Sync tracks and provides information about these events through a set of tables, which you’ll learn about in the next section.
7777

78-
## Tables Segment lands
7978

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+
8187

8288
### The id_graph_updates table
8389

@@ -88,7 +94,7 @@ The `id_graph_updates` table maps between the following:
8894

8995
As a result, this table contains information about the creation and merging of profiles, as well as the specific events that triggered those changes.
9096

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:
9298

9399
<div style="overflow-x:auto;" markdown=1>
94100

@@ -159,9 +165,24 @@ In the event that two profiles merge, Segment only updates the `profile_traits_u
159165

160166
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.
161167

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`
163185

164-
These tables show the instrumented events themselves. Entries in these tables reflect payloads that you instrument according to the Segment spec.
165186

166187
These event tables are similar to the tables landed by Segment warehouse integrations, with the following exceptions:
167188

@@ -220,13 +241,31 @@ If your space has the same name as a source connected to your Segment Warehouse
220241
Follow the steps below to change your schema name:
221242
{% endcomment %}
222243

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+
223260
## Tables Segment materializes
224261

225262
With Profiles Sync, you can access the following three tables that Segment materializes for a more complete view of your profile:
226263
- [`user_traits`](#the-user_traits-table)
227264
- [`user_identifiers`](#the-user_identifiers-table)
228265
- [`profile_merges`](#the-profile_merges-table)
229266

267+
These materialized tables provide a snapshot of your Segment profiles, batch updated according to your sync schedule.
268+
230269
Visit the [selective sync](/docs/unify/profiles-sync/#using-selective-sync) setup page to enable the following materialized tables, which Segment disables by default.
231270

232271
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:
312351
| `timestamp` | The UTC-converted timestamp set by the Segment library. |
313352

314353

354+
<!--
355+
To do: add some info here about when customers might want to materialize tables themselves
356+
357+
-->
315358
## Tables you materialize
316359

317360
> info "dbt model definitions package"

0 commit comments

Comments
 (0)