Relationship design patterns in GraphQL

Introduction

Relationship design patterns help organize how data connects in a database. They make it easy to find and use related information.

When you want to link customers to their orders in a shopping app.

When you need to connect students to their classes in a school system.

When you want to show which authors wrote which books in a library.

When you want to track employees and their departments in a company.

Syntax

GraphQL

type Parent {
  id: ID!
  children: [Child!]!
}

type Child {
  id: ID!
  parent: Parent!
}

Use type to define objects and their relationships.

Use lists [] to show one-to-many relationships.

Examples

This shows a one-to-many relationship: one author has many books.

GraphQL

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

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

This shows a many-to-many relationship: students can join many classes, and classes have many students.

GraphQL

type Student {
  id: ID!
  name: String!
  classes: [Class!]!
}

type Class {
  id: ID!
  title: String!
  students: [Student!]!
}

Sample Program

This example shows a one-to-many relationship where one user can have many posts.

GraphQL

type User {
  id: ID!
  name: String!
  posts: [Post!]!
}

type Post {
  id: ID!
  title: String!
  content: String!
  author: User!
}

Important Notes

Always define clear relationships to avoid confusion when querying data.

Use non-nullable fields (with !) to ensure important links are always present.

Summary

Relationship patterns connect data types to show how they relate.

One-to-many and many-to-many are common patterns.

GraphQL uses types and fields to define these connections clearly.