Relationship design patterns in GraphQL - Step-by-Step Execution

Concept Flow - Relationship design patterns

Define Entities

↓

Choose Relationship Type

↓

One-to-One

↓

Link Entities Directly

↓

One-to-Many

↓

Use List Field in One Entity

↓

Many-to-Many

↓

Create Join Entity or List Fields

↓

Query Relationships

↓

Return Related Data

Start by defining entities, then pick the relationship type (one-to-one, one-to-many, many-to-many), design fields accordingly, and finally query related data.

Execution Sample

GraphQL

type Author {
  id: ID!
  name: String!
  books: [Book!]!
}

type Book {
  id: ID!
  title: String!
  author: Author!
}

Defines a one-to-many relationship where one Author has many Books, and each Book has one Author.

Execution Table

Step	Action	Entity State	Relationship Field	Result
1	Define Author entity	Author: {id, name}	books: [Book!]!	Author can have many Books
2	Define Book entity	Book: {id, title}	author: Author!	Each Book linked to one Author
3	Create Author instance	Author(id=1, name='Alice')	books: []	Author has no books yet
4	Create Book instance	Book(id=101, title='GraphQL Basics')	author: Author(1)	Book linked to Author Alice
5	Add Book to Author.books	Author(1).books = [Book(101)]	books updated	Author now has one book
6	Query Author with books	Author(1)	books: [Book(101)]	Returns Author Alice with her book
7	Query Book with author	Book(101)	author: Author(1)	Returns Book with Author Alice
8	End	-	-	Relationship setup complete

💡 All entities defined and linked; queries return related data as expected

Variable Tracker

Variable	Start	After Step 3	After Step 4	After Step 5	Final
Author	undefined	Author(id=1, name='Alice', books=[])	Author(id=1, name='Alice', books=[])	Author(id=1, name='Alice', books=[Book(101)])	Author(id=1, name='Alice', books=[Book(101)])
Book	undefined	undefined	Book(id=101, title='GraphQL Basics', author=Author(1))	Book(id=101, title='GraphQL Basics', author=Author(1))	Book(id=101, title='GraphQL Basics', author=Author(1))

Key Moments - 3 Insights

Why does the Author entity have a list of Books but each Book has only one Author?

Because this models a one-to-many relationship: one Author can write many Books, but each Book has only one Author. See execution_table rows 1, 2, and 5.

How do we link a Book to its Author in the data?

By setting the Book's author field to reference the Author instance, as shown in execution_table row 4.

What happens if we query an Author's books before adding any Book?

The books list is empty, meaning no related Books yet. See execution_table row 3.

Visual Quiz - 3 Questions

Look at the execution_table at step 5, what is the Author's books list?

A [Book(101)]

B []

C [Author(1)]

D undefined

💡 Hint

Check the 'Relationship Field' column at step 5 in execution_table

At which step is the Book linked to the Author?

A Step 3

B Step 4

C Step 6

D Step 2

💡 Hint

Look at the 'Action' and 'Result' columns in execution_table for when Book.author is set

If we remove the books field from Author, what relationship type is lost?

A One-to-One

B Many-to-Many

C One-to-Many

D No relationship

💡 Hint

Refer to concept_flow and execution_table rows 1 and 5 about the list field in Author

Concept Snapshot

Relationship design patterns in GraphQL:
- Define entities as types
- Use fields to represent relationships
- One-to-One: single object field
- One-to-Many: list field in one entity
- Many-to-Many: join entity or lists in both
- Query nested fields to get related data

Full Transcript

This visual execution shows how to design relationships in GraphQL schemas. We start by defining two entities: Author and Book. Author has a list field 'books' representing many Books, and Book has a single 'author' field linking back to Author. We create instances of Author and Book, link the Book to the Author by setting the author field, and add the Book to the Author's books list. Queries then return the Author with their books or a Book with its author. This models a one-to-many relationship. Key moments include understanding why Author has a list of Books and how linking is done by referencing instances. The quiz tests understanding of these steps and relationship types.