MicroService Architecture ‐ Service Communications Patterns(GraphQL) - thought-corner/backend-roadmap GitHub Wiki

GraphQL 개요

• A query language for APIs
• 2015년 Facebook에서 개발
• 클라이언트가 필요한 데이터 구조를 정의 → 동일한 데이터 구조가 서버로부터 반환된다.
  • 모든 가능한 데이터 스키마 생성 가능하다.
  • 클라이언트에서 쿼리를 요청하면 검증 후에 쿼리를 실행한다.
• API를 위한 쿼리 및 조작 언어 → 기존 데이터를 가지고 쿼리를 수행할 수 있는 방법을 제공한다.
  • 클라이언트가 필요한 것을 정확하게 요청해서 얻을 수 있다.
• 단일 요청에서 여러 소스에 접근하여 데이터를 가져올 수 있다.
  • 네트워크 호출 감소
  • 한 리소스의 특성과 리소스 간의 특정 리소스 참조가 가능
  • 애플리케이션에 필요한 데이터만 가져와 오버페치를 감소
• 기존 쿼리에 영향을 주지 않고 새로운 필드와 유형 추가가 가능하다.

GraphQL 장/단점

• 장점
  • 데이터를 얻기 위해 여러 번 호출하지 않고 특정 필드만 선택하여 쿼리를 제공할 수 있다.
  • 단일 요청으로 애플리케이션에 필요한 모든 데이터를 가져온다.
  • 기존 쿼리에 대한 중단없이 새로운 API 기능을 추가한다.
  • 쿼리하기 전에 데이터에 대해 설명하여 강력하게 정의된 데이터 유형을 사용할 수 있다.
  • 객체 간의 관계가 그래픽 구조로 정의된 계층적 구조로 제공된다.
• 단점
  • 한 번의 요청에 너무 많은 중첩 필드 데이터를 요청하는 경우 성능에 문제가 될 수 있다.(최대 깊이 고려)
  • 간단한 캐시 구현도 어려워진다.
  • REST API에서는 특정 시간에 특정 양의 요청만 허용하는 Rate Limit이 가능하나 GraphQL에서는 어렵다.