GraphQL 튜토리얼: GraphQL이란 무엇인가

최근 몇 년 동안 GraphQL이라는 언어를 자주 보았을 것입니다. 그렇다면 GraphQL은 무엇인가요? 사용 사례는 무엇인가요? 이 튜토리얼에서는 GraphQL의 기본 사항을 소개하므로, GraphQL에 대해 더 배우고 싶다면 놓치지 마세요.

GraphQL이란?

GraphQL은 API를 위한 쿼리 언어이자 서버 측 런타임 엔진입니다. API 쿼리에 대한 완전한 사양을 제공하여 서버가 중복 없이 필요한 데이터만 반환할 수 있도록 합니다. RESTful API와는 달리, GraphQL 요청은 더 적은 요청을 필요로 하며 개발자에게 반환되는 결과에 대한 더 많은 확신을 제공합니다.

GraphQL 사용 시나리오

개발자들은 더 빠르고 효율적으로 작업하고 싶어하며 GraphQL의 타입 시스템은 그들이 앱의 데이터 모델에 맞는 정확한 데이터 필드를 서버로부터 지정할 수 있게 해줍니다. GraphQL은 계속해서 더욱 인기를 얻고 있으며, 여기에는:

복잡한 데이터 구조를 가진 API 설계: 복잡한 계층 데이터 구조를 가진 API 설계는 RESTful API에서 어려울 수 있습니다. 그러나 GraphQL은 클라이언트가 필요한 데이터 구조를 명확하게 정의할 수 있기 때문에 복잡한 데이터 구조를 가진 API 설계를 쉽게 만들어 줍니다.
모바일 애플리케이션 및 단일 페이지 애플리케이션(SPA) 개발: 모바일 애플리케이션과 SPA는 종종 여러 API 엔드포인트에서 데이터를 가져와야 합니다. 그러나 GraphQL을 사용하면 하나의 API 엔드포인트에서 필요한 데이터를 가져올 수 있어 네트워크 트래픽을 줄이고 성능을 개선합니다.
프론트엔드와 백엔드 분리: GraphQL은 프론트엔드와 백엔드를 분리할 수 있게 해 주어 두 팀이 독립적으로 개발할 수 있도록 합니다. 이는 개발 과정을 가속화하고 팀 생산성을 향상시킵니다.
사용자 정의 쿼리 및 인증: GraphQL은 클라이언트가 필요한 데이터를 사용자 정의할 수 있게 해 줍니다. GraphQL은 또한 유연한 인증 및 권한 부여 기능을 제공하여 높은 보안이 필요한 애플리케이션에 적합합니다.

전반적으로 GraphQL은 복잡한 데이터 구조를 가진 API 설계, 고성능 모바일 애플리케이션 및 SPA 개발, 프론트엔드와 백엔드 분리와 같은 다양한 상황에서 유용합니다.

GraphQL의 역사

GraphQL은 2012년 Facebook에 의해 모바일 애플리케이션의 데이터 가져오기 및 조작을 향상시키기 위한 내부 프로젝트로 생성되었습니다.

2015년에 Facebook은 GraphQL을 공개하여 GitHub, Twitter와 같은 주요 기술 회사들 사이에서 널리 채택되었습니다. 그 선언적이고 유연한 데이터 쿼리 기능은 현대 개발 생태계의 필수 요소로 빠르게 자리 잡았습니다.

2018년에는 GraphQL 재단이 설립되어 개방형 개발 및 커뮤니티 주도의 거버넌스를 지원하며 효율적인 API 구축을 위한 강력한 도구로서의 입지를 더욱 공고히 했습니다. 오늘날 GraphQL은 계속해서 발전하고 개발자들이 API를 설계하고 상호작용하는 방식을 혁신하고 있습니다.

GraphQL 사양: 스키마, 필드, 쿼리 및 매개변수

GraphQL 스키마는 GraphQL API에서 사용할 수 있는 타입, 쿼리, 변형 및 구독 필드를 정의합니다. 다음은 기본 용어의 정의입니다:

객체 타입: 데이터 모델의 객체 필드를 정의하는 데 사용됩니다. 예를 들어, 사용자 객체는 이름과 이메일 같은 필드를 가집니다.
필드: 쿼리를 실행할 때 GraphQL 서버가 검색할 수 있는 데이터 타입을 정의합니다. 필드는 일반적으로 객체 타입에 속하지만 때때로 스칼라 타입으로 정의됩니다. 스칼라 타입에는 문자열, 정수, 부동 소수점 수, 불리언 값, ID 등이 포함됩니다.
쿼리: GraphQL API의 쿼리에 대한 진입점을 정의합니다. 쿼리는 GraphQL 서버에서 데이터를 검색하는 데 사용됩니다.
변형: GraphQL API의 변형에 대한 진입점을 정의합니다. 변형은 GraphQL 서버의 데이터를 변경하는 데 사용됩니다.
구독: GraphQL API에 구독하는 진입점을 정의합니다. 구독은 GraphQL 서버로부터 실시간 데이터 업데이트를 받는 데 사용됩니다.

스키마

데이터 모델은 객체 엔터티의 데이터 구조와 그들 간의 관계를 정의하는 데 사용됩니다. 예를 들어, 객체가 어떤 속성을 가지고 있는지를 명시합니다. 다음 다이어그램은 데이터를 쿼리하기 위한 쿼리와 두 개의 반환 객체인 Header와 Query를 정의하는 완전한 데이터 모델을 나타냅니다.

필드

GraphQL 쿼리에서 서버는 요청된 각 필드에 대한 정확한 결과와 함께 요청된 데이터 구조를 클라이언트에 반환합니다. 서버에서 반환된 응답 필드는 클라이언트에서 요청한 필드와 일치합니다. 다음 다이어그램에서 보듯이, 위에서 정의된 예를 기반으로 두 개의 필드가 요청되었고, 두 개의 필드 결과가 반환되었습니다. 사용된 참고 도구는 APOLLO입니다.

매개변수

데이터를 쿼리할 때 매개변수를 전달하여 쿼리 기준을 지정할 수 있습니다. 예를 들어, 다음 다이어그램에서 사람 객체는 관련 속성 데이터를 검색하기 위해 id 매개변수로 쿼리됩니다. 실제 id는 쿼리에 대해 아래의 변수 섹션에 입력할 수 있습니다. 사용된 참고 도구는 APOLLO입니다.