GraphQL

핵심 개념

Schema

서버가 제공하는 타입, 필드, 관계를 정의한 명세로, 클라이언트가 어떤 데이터를 어떻게 요청할 수 있는지의 계약 역할을 합니다.

Query

데이터를 조회하기 위한 요청으로, 클라이언트가 필요한 필드만 선택해 서버에 전달합니다.

Mutation

데이터를 생성·수정·삭제하는 등 서버 상태를 변경할 때 사용하는 요청 타입입니다.

Resolver

스키마에 정의된 각 필드의 실제 값을 어떻게 가져올지 구현하는 서버 측 함수입니다.

Codegen

스키마 정의로부터 클라이언트 코드의 타입이나 훅을 자동으로 생성해 API 연동의 타입 안전성을 높이는 도구입니다.

기본 스키마와 쿼리 예시

User 타입과 조회 쿼리를 스키마로 정의하고, 클라이언트는 필요한 필드(name, email)만 선택해 요청합니다.

# 스키마 정의
type User {
  id: ID!
  name: String!
  email: String!
}

type Query {
  user(id: ID!): User
}

# 클라이언트가 보내는 쿼리
query GetUser {
  user(id: "1") {
    name
    email
  }
}