GraphQL이란?

Source: Dev.to

개요

• Facebook에서 개발
• API를 위한 쿼리 언어
• API 요청 및 응답의 데이터 형식이 비슷해 사용하기 쉬움
• REST는 아키텍처(디자인)이고, GraphQL은 언어(DSL)임

REST 예시

HTTP 메서드를 사용해 엔드포인트에 요청을 보냄:

curl https://api.bmf-tech.com/v1/configs

[
  {
    "id": 1,
    "name": "title",
    "alias_name": "Title",
    "value": "bmf-tech",
    "created_at": "2017-09-25 23:08:23",
    "deleted_at": null
  }
]

GraphQL 예시

단일 엔드포인트에 쿼리를 보냄:

curl https://api.bmf-tech.com/api

{
  configs {
    id
    name
    alias_name
    value
    created_at
    updated_at
    deleted_at
  }
}

[
  {
    "id": 1,
    "name": "title",
    "alias_name": "Title",
    "value": "bmf-tech",
    "created_at": "2017-09-25 23:08:23",
    "deleted_at": null
  }
]

비교 요약

실무 고려사항

• 로드 계산: GraphQL은 반환되는 객체 수 등에 기반한 로드 계산 방법이 필요할 때가 많음.
• 문서화: GraphQL 스키마 자체가 자체 문서화 역할을 하므로 외부 문서는 덜 중요함.
• 라이브러리: 구현 시 쿼리 파싱을 위한 라이브러리가 일반적으로 필요함.
• 성능: REST보다 본질적으로 빠른 것은 아니며, 라운드‑트립 감소가 주요 이점임.
• 데이터 양: 두 접근 방식 모두 페이로드 크기를 제어하기 위해 페이지네이션이나 필드 선택이 필요함.
• 모니터링: GraphQL은 단일 엔드포인트를 사용하므로 쿼리 수준 성능을 추적하기 위한 추가 도구가 필요할 수 있음.
• 캐싱: 표준 HTTP 캐싱이 적용되지 않으므로 대체 캐싱 전략을 검토해야 함.

GraphQL을 고려해야 할 상황

• 많은 컴포넌트와 복잡한 UI를 가진 애플리케이션으로, 요청 수가 병목이 되는 경우.
• 클라이언트가 여러 라운드‑트립 없이 다양한 형태의 데이터를 받아야 할 때.

참고 자료

• graphql.org – 공식 GraphQL 문서
• facebook/graphql RFCs – 사양 및 제안서
• “A small rebuttal to What is GraphQL suitable for” – 사용 사례에 대한 토론
• “Memo when implementing GraphQL API in a Rails app” – 실전 구현 노트
• “Explaining GraphQL from a beginner’s perspective” – REST와 GraphQL을 비교한 입문 가이드