GraphQL이란?

• REST를 대체, RESTful API와 달리 클라이언트가 필요한 데이터를 서버에서 직접 요청할 수 있는 유연한 방식으로 데이터를 가져올 수 있습니다.

  • 클라이언트가 어떤 데이터가 필요한지 명시적으로 선언할 수 있도록 해줍니다.
  • 클라이언트가 데이터 스키마에 정의된 필드와 관련된 정보를 요청하면, 서버는 해당 요청에 따라 데이터를 반환합니다.
  • 불필요한 데이터의 전송을 최소화하고, 클라이언트와 서버 간의 효율적인 통신을 가능케 합니다.

• 다양한 데이터 소스에서 데이터를 통합하고 관리할 수 있는 강력한 기능을 제공하며, 클라이언트와 서버 간의 통신을 단순하게 만들어줍니다. 이는 특히 모바일 애플리케이션과 웹 애플리케이션에서 데이터 송수신에 있어 유용하게 활용됩니다.

• 다양한 데이터 소스로부터 필요한 데이터를 가져오기 위해 단일 API 호출로 구성될 수 있습니다. 이는 여러 데이터베이스, 마이크로서비스, 외부 API 등 다양한 소스로부터 데이터를 효율적으로 가져올 수 있는 강력한 기능을 제공합니다.

• 유연성을 제공하여 API 관리자가 기존 쿼리에 영향을 주지 않고도 필드를 추가하거나 제거할 수 있습니다. 클라이언트는 요청 시 필요한 필드만 지정하므로, 서버 측에서 필드를 조정하거나 업데이트할 때에도 클라이언트 측 코드에 큰 변화가 없습니다.

• GraphQL은 쿼리와 변형으로 나뉩니다. 쿼리는 데이터를 읽는 데 사용되며, 변형은 데이터를 생성(Create), 업데이트(Update), 삭제(Delete)하는 데 사용됩니다. 이러한 구조는 GraphQL을 통해 데이터를 읽고 쓰는 모든 작업을 효율적으로 처리할 수 있게 해줍니다.

GraphQL의 장점과 단점은 다음과 같습니다

장점:

유연한 데이터 요청: 클라이언트가 필요한 데이터를 명시적으로 요청할 수 있어, Over-fetching과 Under-fetching을 방지하고 필요한 데이터만 가져올 수 있습니다.

단일 엔드포인트: RESTful API와 달리 단일 엔드포인트를 사용하므로 여러 요청을 병합하고 다양한 데이터를 한 번에 가져올 수 있습니다.

자체 문서화: GraphQL은 스키마를 사용하여 데이터 구조를 정의하므로 자체적으로 문서화되어 API를 이해하고 사용하기 쉽습니다.

클라이언트 요구사항 충족: 클라이언트 측에서 필요한 데이터를 가져오는 데 있어 필요한 요구사항을 충족시킬 수 있어 유연성이 뛰어납니다.

백엔드 변경 용이성: 필드를 추가하거나 변경하더라도 기존 API에 영향을 덜 주며, 기존 코드를 변경할 필요 없이 새로운 기능을 도입할 수 있습니다.

단점:

복잡성: GraphQL을 처음 접하는 개발자에게는 RESTful API보다 학습 곡선이 높을 수 있습니다. 복잡한 쿼리와 스키마 설정 등을 다루어야 하기 때문입니다.

캐싱 어려움: RESTful API보다는 캐싱이 어려울 수 있습니다. 각 요청은 고유한 쿼리이므로 일부 캐싱 전략은 추가 작업이 필요할 수 있습니다.

보안 문제: 과도한 권한이나 쿼리 요청을 방지하기 위해 보안을 강화하는 것이 필요할 수 있습니다.

대용량 파일 전송: 대용량 파일 업로드 및 다운로드와 같은 작업에는 RESTful API보다는 적합하지 않을 수 있습니다.