Why relationships model real data in GraphQL - See It in Action

Modeling Real Data Relationships with GraphQL

📖 Scenario: You are building a simple GraphQL API for a library system. The library has authors and books. Each book is written by one author, and each author can write many books. This relationship models how real-world data is connected.

🎯 Goal: Create GraphQL types to represent Author and Book with a relationship between them. Then write a query to fetch authors and their books, showing how relationships model real data.

📋 What You'll Learn

Create a GraphQL type called Author with fields id (ID!), name (String!), and books ([Book!]!)

Create a GraphQL type called Book with fields id (ID!), title (String!), and author (Author!)

Create a query type with a field authors that returns a list of Author

Write a GraphQL query to fetch all authors with their id, name, and the title of each book they wrote

💡 Why This Matters

🌍 Real World

Modeling relationships like authors and books is common in real databases and APIs. GraphQL lets you express these connections clearly.

💼 Career

Understanding how to model and query related data is essential for backend developers, API designers, and anyone working with databases or GraphQL.

1

Define the Author and Book types

Create GraphQL types called Author and Book. Author should have fields id of type ID! and name of type String!. Book should have fields id of type ID! and title of type String!.

GraphQL

# Define Author and Book types with id and name/title fields

Need a hint?

Start by defining two types with the required fields. Don't add relationships yet.

2

Add relationship fields between Author and Book

Add a field called books to the Author type that returns a list of Book (type [Book!]!). Add a field called author to the Book type that returns an Author (type Author!).

GraphQL

type Author {
  id: ID!
  name: String!
  # Add books field here
}

type Book {
  id: ID!
  title: String!
  # Add author field here
}

Need a hint?

Think about how one author can have many books, and each book has one author.

3

Create the root Query type to fetch authors

Create a Query type with a field called authors that returns a list of Author (type [Author!]!).

GraphQL

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

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

# Define Query type here

Need a hint?

The Query type is the entry point for fetching data in GraphQL.

4

Write a GraphQL query to fetch authors and their books

Write a GraphQL query named GetAuthorsWithBooks that fetches all authors with their id, name, and for each book, fetch the title.

GraphQL

# Write the GraphQL query below

Need a hint?

Use nested fields to get books inside authors.