GraphQL은 자바스크립트 응용프로그램에서 데이터를 효율적으로 가져오기 위한 쿼리 언어입니다. GraphQL 쿼리에서 변수를 사용하여 쿼리를 보다 동적으로 만들 수 있습니다. 이 글에서는 GraphQL 쿼리 언어에서 변수를 어떻게 사용하는지에 대해 설명하겠습니다.

쿼리 변수 정의하기

GraphQL에서 쿼리 변수를 정의하는 방법은 간단합니다. 일반적으로 $ 기호를 사용하여 변수를 정의합니다. 쿼리 변수의 이름과 타입을 지정할 수 있습니다.

예시:

query ($userId: ID!) {
  user(id: $userId) {
    name
    email
  }
}

위의 예시에서 ($userId: ID!)는 userId라는 쿼리 변수의 타입을 ID로 지정하고, !는 해당 변수가 필수라는 것을 나타냅니다.

쿼리 변수 사용하기

쿼리 변수를 사용할 때에는 아래와 같이 쿼리 정의 부분 뒤에 ($변수이름: 타입) 형식으로 정의하고, 실제 쿼리 안에서는 변수를 $변수이름으로 참조합니다.

예시:

query GetUserInfo($userId: ID!) {
  user(id: $userId) {
    name
    email
  }
}

변수 전달하기

GraphQL 쿼리를 실행할 때 쿼리 변수의 값은 클라이언트에서 전달해야 합니다. 대부분의 경우 GraphQL 클라이언트 라이브러리에서는 쿼리를 실행할 때 변수 값을 전달할 수 있는 방법을 제공합니다.

예시(node.js):

const result = await client.query({
  query: GET_USER_INFO,
  variables: { userId: '123' }
});

위의 예시에서 variables 속성을 통해 쿼리 변수의 실제 값을 전달하고 있습니다.

결론

GraphQL 쿼리 언어에서 변수를 사용하면 쿼리를 더 동적으로 만들 수 있으며, 일반적으로 데이터 가져오기 작업에 유용하게 활용됩니다.

이상으로 GraphQL 쿼리 언어에서 쿼리 변수 사용법에 대해 알아보았습니다.

참고 자료

• GraphQL 공식 문서