|
2 | 2 | title: Data Graph
|
3 | 3 | plan: unify
|
4 | 4 | redirect_from:
|
5 |
| - - "/unify/linked-profiles/data-graph" |
6 |
| - - "/unify/data-graph/data-graph" |
| 5 | + - '/unify/linked-profiles/data-graph' |
| 6 | + - '/unify/data-graph/data-graph' |
7 | 7 | ---
|
8 | 8 |
|
9 | 9 | The Data Graph acts as a semantic layer that allows businesses to define relationships between various entity datasets in the warehouse — such as accounts, subscriptions, households, and products — with the Segment Profile. It makes these relational datasets easily accessible to business teams for targeted and personalized customer engagements.
|
@@ -178,7 +178,7 @@ The first step in creating a Data Graph is to define your entities. An entity co
|
178 | 178 | | Parameters | Definition |
|
179 | 179 | | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
180 | 180 | | `entity` | An immutable slug for the entity, and will be treated as a delete if you make changes. The slug must be in all lowercase, and supports dashes or underscores (e.g `account-entity` or `account_entity`). |
|
181 |
| -| (Optional) `description` | An optional descriptor used to add additional context to the entity | |
| 181 | +| `description` (*Optional*) | An optional descriptor used to add additional context to the entity. | |
182 | 182 | | `name` | A label displayed throughout your Segment space for Linked Events, Linked Audiences, etc. This name can be modified at any time. |
|
183 | 183 | | `table_ref` | Defines the fully qualified table reference: `[database name].[schema name].[table name]`. Segment flexibly supports tables, views and materialized views. |
|
184 | 184 | | `primary_key` | The unique identifier for the given table. Must be a column with unique values per row. |
|
@@ -246,12 +246,12 @@ Now define your relationships between your entities. Similar to the concept of [
|
246 | 246 |
|
247 | 247 | This is the first level of relationships and a unique type of relationship between the Segment profile entity and a related entity.
|
248 | 248 |
|
249 |
| -| Parameters | Definition | |
250 |
| -| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
251 |
| -| `relationship` | An immutable slug for the relationship, and will be treated as a delete if you make changes. The slug must be in all lowercase, and supports dashes or underscores (like `user-account` or `user_account`) | |
252 |
| -| `name` | A label displayed throughout your Segment space for Linked Events, Linked Audiences, etc. This name can be modified at any time | |
253 |
| -| (Optional) `description` | An optional descriptor used to add additional context to the relationship | |
254 |
| -| `related_entity` | References your already defined entity | |
| 249 | +| Parameters | Definition | |
| 250 | +| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
| 251 | +| `relationship` | An immutable slug for the relationship, and will be treated as a delete if you make changes. The slug must be in all lowercase, and supports dashes or underscores (like `user-account` or `user_account`) | |
| 252 | +| `name` | A label displayed throughout your Segment space for Linked Events, Linked Audiences, etc. This name can be modified at any time | |
| 253 | +| `description` (*Optional*) | An optional descriptor used to add additional context to the relationship. | |
| 254 | +| `related_entity` | References your already defined entity | |
255 | 255 |
|
256 | 256 | To define a profile-to-entity relationship, reference your entity table and depending on your table columns, choose to join on one of the following:
|
257 | 257 |
|
@@ -313,13 +313,13 @@ data_graph {
|
313 | 313 |
|
314 | 314 | For 1:many relationships, define the join on between the two entity tables using the spec below.
|
315 | 315 |
|
316 |
| -| Parameters | Definition | |
317 |
| -| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
318 |
| -| `relationship` | An immutable slug for the relationship, and will be treated as a delete if you make changes. The slug must be in all lowercase, and supports dashes or underscores (like `user-account` or `user_account`) | |
319 |
| -| `name` | A label displayed throughout your Segment space for Linked Events, Linked Audiences, and so on. This name can be modified at any time | |
320 |
| -| (Optional) `description` | An optional descriptor used to add additional context to the relationship | |
321 |
| -| `related_entity` | References your already defined entity | |
322 |
| -| `join_on` | Defines relationship between the two entity tables `[lefty entity slug].[column name] = [right entity slug].[column name]`. Note that since you’re referencing the entity slug for the join on, you do not need to define the full table reference | |
| 316 | +| Parameters | Definition | |
| 317 | +| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
| 318 | +| `relationship` | An immutable slug for the relationship, and will be treated as a delete if you make changes. The slug must be in all lowercase, and supports dashes or underscores (like `user-account` or `user_account`) | |
| 319 | +| `name` | A label displayed throughout your Segment space for Linked Events, Linked Audiences, and so on. This name can be modified at any time | |
| 320 | +| `description` (*Optional*) | An optional descriptor used to add additional context to the relationship. | |
| 321 | +| `related_entity` | References your already defined entity | |
| 322 | +| `join_on` | Defines relationship between the two entity tables `[lefty entity slug].[column name] = [right entity slug].[column name]`. Note that since you’re referencing the entity slug for the join on, you do not need to define the full table reference | |
323 | 323 |
|
324 | 324 | **Example:**
|
325 | 325 |
|
|
0 commit comments