Skip to content

Commit a2d574a

Browse files
committed
Data Graph edits
1 parent e8fe0be commit a2d574a

File tree

1 file changed

+16
-18
lines changed

1 file changed

+16
-18
lines changed

src/unify/linked-profiles/data-graph.md

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -21,10 +21,10 @@ To use the Data Graph, you'll need the following:
2121

2222

2323
> info ""
24-
> Linked Profiles follows Zero Copy principles. This means that Segment doesn't copy entities to store in Segment. Segment stores and processes all data in the U.S.
24+
> Linked Profiles follows Zero Copy principles, and doesn't copy entities to store in Segment. Segment stores and processes all data in the United States.
2525
2626
> warning ""
27-
> Don't send any personal health information (PHI) with the Data Graph.
27+
> Don't send any personal health information with the Data Graph.
2828
2929
## Step 1: Set up your data warehouse
3030

@@ -37,9 +37,7 @@ Before setting up the Data Graph, you'll need to set up your data warehouse. Use
3737

3838
Linked Profiles uses [Segment's Reverse ETL](/docs/connections/reverse-etl/) infrastructure to pull data from your warehouse.
3939

40-
To track what data has been sent to Segment on previous syncs, Segment stores delta/diffs in tables within a single schema called `_segment_reverse_etl` within your data warehouse.
41-
42-
You can choose which database/project within your warehouse this data lives in.
40+
To track what data has been sent to Segment on previous syncs, Segment stores delta/diffs in tables within a single schema called `_segment_reverse_etl` in your data warehouse. You can choose which database/project in your warehouse this data lives in.
4341

4442

4543
## Step 2: Connect your warehouse to the Data Graph
@@ -50,7 +48,7 @@ You can choose which database/project within your warehouse this data lives in.
5048
To connect your warehouse to the data graph:
5149

5250
1. In your Segment workspace, navigate to **Unify**, and select **Data Graph**.
53-
- This should be the Unify space with Profiles Sync already set up.
51+
- This should be a Unify space with Profiles Sync already set up.
5452
2. Click **Connect warehouse**.
5553
3. Select your warehouse type.
5654
4. Enter your warehouse credentials.
@@ -78,7 +76,7 @@ While you can delete relationships or entities from the Data Graph, these relati
7876
Use the parameters, defintions, and examples below to help you define entities.
7977

8078
> warning ""
81-
> Snowflake schemas are case sensitive. You'll need to use the uppercase schema, table, and column names if that's how you have it in Snowflake.
79+
> Snowflake schemas are case sensitive. You'll need to use the uppercase schema, table, and column names if that's how you have them in Snowflake.
8280
8381
#### Profile
8482

@@ -110,10 +108,10 @@ An entity is a stateful representation of a business object. The entity correspo
110108
| Parameters | Definition |
111109
| ----------- | --------------------------------------------------------------------- |
112110
| `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`). |
113-
| `name` | A unique label which will display across the app. |
114-
| `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]`. |
115-
| `primary_key` | This is the unique identifier for the given table and should be a column with unique values per row. |
116-
| (Optional) `enrichment_enabled = true | Indicate if you plan to also reference the entity table for [Linked Events](/docs/unify/linked-profiles/linked-events/). |
111+
| `name` | A unique label which will display across Segment. |
112+
| `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]`. |
113+
| `primary_key` | The unique identifier for the given table. Should be a column with unique values per row. |
114+
| (Optional) `enrichment_enabled = true` | Indicate if you plan to also reference the entity table for [Linked Events](/docs/unify/linked-profiles/linked-events/). |
117115

118116

119117

@@ -132,15 +130,15 @@ entity "account" {
132130
Use the following relationship, parameters, and examples to help you relate entities.
133131

134132
> warning ""
135-
> Snowflake schemas are case sensitive, so you'll need to reflect the uppercase schema, table, and column names based on how you have it in Snowflake.
133+
> Snowflake schemas are case sensitive, so you'll need to reflect the uppercase schema, table, and column names based on how you have them in Snowflake.
136134
137135
#### Relate Entity to Profile
138136

139137
| Parameters | Definition |
140138
| ----------- | --------------------------------------------------------------------- |
141139
| `relationship` | A unique slug for the relationship, which is immutable and treated as a delete if you make changes. The slug must be in all lowercase and will support dashes or underscores (for example, `user-account` or `user_account`). |
142-
| `name` | This should be a unique label that displays throughout your Segment space. |
143-
| ``related_entity` | Reference your already defined entity. |
140+
| `name` | A unique label that displays throughout your Segment space. |
141+
| `related_entity` | Reference your already defined entity. |
144142

145143

146144
A profile can be related to an entity in two ways:
@@ -214,12 +212,12 @@ data_graph {
214212
If you're relating entities with a junction table:
215213

216214
- `Junction_table`: Define relationships between two entities tables joined by a junction table.
217-
- `table_ref`: Define the table reference to the join table. In order to specify a connection to your table in Snowflake, a fully qualified table reference is required `[database name].[schema name].[table name]`
215+
- `table_ref`: Define the table reference to the join table. In order to specify a connection to your table in Snowflake, a fully qualified table reference is required: `[database name].[schema name].[table name]`.
218216
- `primary_key`: The unique identifier on the join table and should be a column with unique values per row.
219-
- `left_join_on`: Define relationship between the two entity tables `[left entity name].[column name] = [junction table column name]`.
220-
- `right_join_on`: Define relationship between the two entity tables `[junction table column name] = [right entity name].[column name]`.
217+
- `left_join_on`: Define relationship between the two entity tables: `[left entity name].[column name] = [junction table column name]`.
218+
- `right_join_on`: Define relationship between the two entity tables: `[junction table column name] = [right entity name].[column name]`.
221219

222-
Note that schema.table is implied within the junction table column name and doesn't need to be provided.
220+
Note that `schema.table` is implied within the junction table column name and doesn't need to be provided.
223221

224222
Attributes from a junction table are not referenceable with the Audience Builder. If you'd like to reference an additional column on the junction table for filtering, you must first define it as an entity and explicitly define a relationship name.
225223

0 commit comments

Comments
 (0)