Skip to content

Commit 3236e2c

Browse files
cmastrcmastr
committed
additional linked fixes
1 parent 84a2c3d commit 3236e2c

File tree

3 files changed

+32
-8
lines changed

3 files changed

+32
-8
lines changed

‎src/engage/audiences/linked-audiences.md

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,15 +43,41 @@ This triggers a compute for the audience (where the audience conditions run on y
4343

4444
#### Event conditions
4545

46-
As you're building your Linked Audience, you can choose from the following event conditions:
46+
As you're building your Linked Audience, you can choose from the following conditions:
4747

48-
| Event Conditions | Description |
48+
| Conditions | Description |
4949
|---------------------------|---------------------------------------|
5050
| Associated with an entity | Creates a condition that filters profiles associated with entity relationships defined in the [Data Graph](/docs/unify/linked-profiles/data-graph/). With this condition, you can traverse the full nested entity relationship and filter your audience on entity column values. Note: you can only create nested entity conditions up to four levels in depth. For example, an entity condition that queries for relationships between Profiles, Accounts, Credit Cards, and Transactions has four levels of depth. |
5151
| Where profile trait | Creates a condition that filters profiles with a specific trait. |
5252
| Part of an audience | Creates a condition that filters profiles that are part of an existing linked or classic audience. |
5353
| Performed event | Creates a condition that filters profiles on their event history. Users can also filter on event property values.|
5454

55+
#### Error States
56+
57+
As you’re building or maintaining your audience, you may encounter an error or warning message about possible impacts to your audience. Below are some common reasons errors occur, along with suggested troubleshooting steps.
58+
59+
| Failure | External message | Workflow implication |
60+
|---|---|---|
61+
| Parse error | An unknown error occurred. Execution will retry. If the problem persists, please contact Segment support. | Terminate and execute next run |
62+
| Graph missing entity | Entity missing from Data Graph: <entity> | Terminate and execute next run |
63+
| Graph missing column for entity | Entity column missing from Data Graph for Entity <entity> and Column: <column> | Terminate and execute next run |
64+
| No columns exist for entity | No columns exist for entity in Data Graph: <entity> | Terminate and execute next run |
65+
| Missing join key between entities | Join key missing from Data Graph for relation: <relationship> | Terminate and execute next run |
66+
| Join key is wrong type | Relationship key should be a string: <relationship> | Terminate and execute next run |
67+
| Entity relationship not in Data Graph (we know the entity) | Entity relationship not in Data Graph for entity <entity> | Terminate and execute next run |
68+
| Entity relationship not in Data Graph (we know the relationship slug) | Entity relationship not in Data Graph for relationship: <relationship slug> | Terminate and execute next run |
69+
| Entity relationship not in Data Graph (we know the entity and relationship slug) | Entity relationship not in Data Graph for entity: <entity> and relationship: <relationship slug> | Terminate and execute next run |
70+
| Query fails for unknown internal error | An unexpected error occurred. Execution will retry. If the problem persists, please contact Segment support. | Retry |
71+
| Update model fails | An unexpected error occurred. Execution will retry. If the problem persists, please contact Segment support. | Retry |
72+
| Kick off rETL job | An unexpected error occurred. Execution will retry. If the problem persists, please contact Segment support. | Retry |
73+
| Warehouse errors | Pass through warehouse errors | Terminate and execute next run |
74+
| SQL Compilation execution | Examples: extract phase failed: An unexpected Snowflake error occurred trying to execute your model query: 000904 (42000): SQL compilation error: error line 30 at position 61 invalid identifier 'EV.PROPERTIES' extract phase failed: An unexpected Snowflake error occurred trying to execute your model query: 000904 (42000): SQL compilation error: error line 23 at position 19 invalid identifier 'UPDATES.TRAITS' | |
75+
| Duplicate records for ID | Examples: extract phase failed: Duplicate records have been detected. This could be because the model query returned multiple records for the same ID column (MATCHID), or the Segment records table itself has duplicate records. | |
76+
| Check results | An unknown error occurred. Execution will retry. If the problem persists, please contact Segment support. | Retry |
77+
| Extract results | Execution is paused due to an identified operational issue. | Pause for manual intervention |
78+
| Process results | Execution is paused due to an identified operational issue. | Set retl_results_processed = true on success Set retl_results_processed = false on failure Set lock Abort other execution attempts Page Compute |
79+
| Load results | Execution is paused due to an identified operational issue. | |
80+
5581
#### Edit an audience
5682
To edit an audience:
5783
1. Navigate to **Engage > Audiences**, and select the audience you'd like to edit.

‎src/unify/linked-profiles/index.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,8 @@ beta: true
55
hidden: true
66
---
77

8-
> info "Linked Profiles is in private beta"
9-
> Linked Profiles is in private beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
10-
8+
> info "Linked Profiles is in public beta"
9+
> Linked Profiles is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
1110
> warning ""
1211
> Linked Profiles currently only supports workspaces in the United States.
1312

‎src/unify/linked-profiles/setup-guides/snowflake-setup.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,8 @@ beta: true
55
hidden: true
66
---
77

8-
> info "Linked Profiles is in private beta"
9-
> Linked Profiles (Data Graph, Linked Events, and Linked Audiences) is in private beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
10-
8+
> > info "Linked Profiles is in public beta"
9+
> Linked Profiles (Data Graph, Linked Events, and Linked Audiences) is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
1110
1211
On this page, you'll learn how to connect your Snowflake data warehouse to Segment.
1312

0 commit comments

Comments
 (0)