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/linked-profiles/linked-events.md
+36-10Lines changed: 36 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -81,19 +81,45 @@ The table below shows the data warehouses Linked Events supports. View the Segme
81
81
|[BigQuery](/docs/unify/linked-profiles/setup-guides/bigquery-setup/)| 1. Add your credentials to the database that has tables with the entities you want to enrich your event with. <br> 2. Test your connection. |
82
82
|[Redshift](/docs/unify/linked-profiles/setup-guides/redshift-setup/)| 1. Select the Redshift cluster you want to connect. <br> 2. [Configure](/docs/connections/storage/catalog/redshift/#networking) the correct network and security settings. |
83
83
84
-
## Step 2: Add entities
85
84
86
-
After you connect your warehouse, use the Data graph overview page (**Unify > Data graph**) to view entities Segment has synced from your data warehouse, add a new entity, and view data warehouse settings.
85
+
## Step 2: Build your Data Graph
87
86
88
-
To add a new entity:
89
-
1. Click **Add entity**.
90
-
2. Select the table(s) from your warehouse that you'll use as an entity.
91
-
3. For each table you select, choose a primary key from the drop-down menu.
92
-
- The primary key uniquely identifies rows in your table.
93
-
4. Click **Add entities**.
87
+
The [Data Graph](/unify/linked-profiles/data-graph/) is a semantic layer that represents a subset of relevant business data that you'll use to enrich events in downstream tools. Use the configuration language spec below to add models to build out your Data Graph.
94
88
95
-
> success ""
96
-
> If you don't see data you need, or have recently updated your warehouse, click **Refresh** to update the schema and tables list.
89
+
### Deleting and editing entities and/or relationships from your Data Graph
90
+
91
+
Each Unify space has one Data Graph. The current version is v0.0.6 but this may change in the future as Segment accepts feedback about the process.
92
+
93
+
> warning ""
94
+
> Deleting and/or editing entities and relationships to the Data Graph may lead to errors if these entities or relationships are referenced in existing Linked Audiences and Linked Events. Segment recommends creating a new Linked Audience or Linked Event. <br><br> Please note that while you can delete relationships or entities from the Data Graph, these relationships will still show up in the Linked Audience Builder and Linked Events.
95
+
96
+
### Defining entities
97
+
98
+
> warning ""
99
+
> Snowflake schemas are case sensitive, so you'll need to reflect the schema, table, and column names based on how you case them in Snowflake.
100
+
101
+
An entity is a stateful representation of a business object. The entity corresponds to a table in the warehouse that represents that entity.
|`entity`| A unique slug for the entity, which is immutable and treated as a delete if you make changes. The slug must be in all lowercase, and supports dashes or underscores (for example, `account-entity` or `account_entity`). |
107
+
|`name`| A unique label which will display across Segment. |
108
+
|`table_ref`| Define the table reference. In order to specify a connection to your table in Snowflake, a fully qualified table reference is required: `[database name].[schema name].[table name]`. |
109
+
|`primary_key`| The unique identifier for the given table. Should be a column with unique values per row. |
110
+
| (Optional) `enrichment_enabled = true`| Indicate if you plan to also reference the entity table for [Linked Events](/docs/unify/linked-profiles/linked-events/). |
111
+
112
+
113
+
114
+
```python
115
+
# Define an entity and optionally indicate if the entity will be referenced for Linked Events (event enrichment)
0 commit comments