|
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