One-to-one relationships in GraphQL - Mini Project: Build & Apply

One-to-One Relationships in GraphQL

📖 Scenario: You are building a simple GraphQL API for a small library system. Each Book has exactly one Author, and each Author has exactly one Biography. You want to model these one-to-one relationships clearly in your GraphQL schema.

🎯 Goal: Create a GraphQL schema that defines the Book, Author, and Biography types with one-to-one relationships between them. You will start by defining the basic types, then add fields to link them, and finally complete the schema with the necessary queries.

📋 What You'll Learn

Define a Book type with fields id (ID!), title (String!), and author (Author).

Define an Author type with fields id (ID!), name (String!), and biography (Biography).

Define a Biography type with fields id (ID!) and text (String!).

Add a root Query type with a field book that returns a Book by id.

Ensure the one-to-one relationships are represented by linking the types correctly.

💡 Why This Matters

🌍 Real World

One-to-one relationships are common in real-world data models, such as a user profile linked to a single account or a product linked to a single detailed description.

💼 Career

Understanding how to model one-to-one relationships in GraphQL is essential for backend developers building APIs that reflect real-world data accurately and efficiently.

1

Define the basic types

Create the GraphQL types Book, Author, and Biography with the following fields exactly: Book has id: ID! and title: String!; Author has id: ID! and name: String!; Biography has id: ID! and text: String!.

GraphQL

# Define the Book, Author, and Biography types with the specified fields

Need a hint?

Start by writing type Book { id: ID! title: String! } and similarly for Author and Biography.

2

Add one-to-one relationship fields

Add the field author: Author to the Book type and the field biography: Biography to the Author type to represent the one-to-one relationships.

GraphQL

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

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

type Biography {
  id: ID!
  text: String!
}

Need a hint?

Inside Book, add author: Author. Inside Author, add biography: Biography.

3

Add the root Query type

Create a root Query type with a field book that takes an argument id: ID! and returns a Book.

GraphQL

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

type Author {
  id: ID!
  name: String!
  biography: Biography
}

type Biography {
  id: ID!
  text: String!
}

# Add Query type here

Need a hint?

Define type Query { book(id: ID!): Book } to allow fetching a book by its ID.

4

Complete the schema with one-to-one relationships

Ensure the full schema includes the Book, Author, Biography types with their one-to-one fields and the Query type as defined. The schema should be a complete GraphQL schema ready for use.

GraphQL

# Review and finalize the schema

Need a hint?

Make sure all types and fields are included exactly as specified to represent the one-to-one relationships.