Skip to main content

What is a Relationship?

A Relationship defines how two entities are connected. If entities are the nouns of your context graph, relationships are the verbs. Examples:
  • Customer places Order
  • Order contains Product
  • Employee works on Project
  • Account belongs to Organization
Relationships transform a collection of entities into a navigable context graph.

Why Relationships Matter

Without relationships, you only have isolated concepts. With relationships, you can answer questions like:
  • Which customers bought this product?
  • Which invoices belong to this account?
  • Who is responsible for this deal?
  • How are these two entities connected?

Relationships Bring Meaning to Structure

Entities define what exists. Relationships define how those things interact. Relationships can represent many kinds of connections:
  • Ownership
  • Containment
  • Events
  • Hierarchies
  • Associations
Some examples:
Source EntityRelationshipTarget Entity
CustomerplacesOrder
OrdercontainsProduct
EmployeemanagesAccount
DepartmentincludesEmployee
InvoicereferencesContract

Anatomy of a Relationship

Every relationship has a clear structure.

1. A Source Entity

The starting point of the relationship. Example: Customer

2. A Target Entity

The destination entity. Example: Order

3. A Relationship Type

A description of how they connect. Example:
  • Customer places Order
The relationship type should be:
  • Clear
  • Directional
  • Expressed in plain language

4. Mapping Logic

Just like entities, relationships are grounded in real data. A relationship definition includes:
  • Which Source fields connect the entities
  • Join keys or matching rules
This mapping turns raw foreign keys, file references, or identifiers into meaningful connections.

Relationships Power Graph Exploration

Once relationships are defined, you can:
  • Traverse from one entity to another
  • Filter by relationship paths
  • Ask questions using chat
  • Discover indirect connections
The richer your relationships, the more useful your graph becomes.

What’s Next

With entities and relationships defined, you have a working context graph. From here you can:
  • Explore the graph visually
  • Ask questions using Chat
  • Use Query Explorer to explore entity and relationship definitions
  • Analyze logs and artifacts