Logo
활용 가이드
활용 가이드메타 값

메타 값

메타 값을 가져오고 필터링하려면, 메타 키를 허용 목록에 추가해야 합니다.

커스텀 포스트, 사용자, 댓글, 분류체계(태그 및 카테고리)의 메타 값을 가져오려면, 해당 타입에서 metaValue 필드(단일 값) 및 metaValues 필드(값의 배열)를 쿼리하면 됩니다.

  • Post.metaValue
  • Post.metaValues
  • GenericCustomPost.metaValue
  • GenericCustomPost.metaValues
  • User.metaValue
  • User.metaValues
  • Comment.metaValue
  • Comment.metaValues
  • PostTag.metaValue
  • PostTag.metaValues
  • PostCategory.metaValue
  • PostCategory.metaValues
  • GenericTag.metaValue
  • GenericTag.metaValues
  • GenericCategory.metaValue
  • GenericCategory.metaValues

여러 메타 값을 한 번에 쿼리하기

meta 필드(위와 동일한 타입에 대응)를 사용하여, 여러 메타 항목을 JSON 객체로 쿼리할 수 있습니다.

JSON 객체의 구조는 다음과 같습니다.

  • 키: 메타 키
  • 값: 값의 목록(메타 값이 스칼라인 경우, 1개의 요소를 가진 목록으로 반환됩니다)

메타 키 쿼리하기

metaKeys 필드(위와 동일한 타입에 대응)를 사용하여, 엔티티에서 허용된 모든 메타 키의 목록을 가져올 수 있습니다.

이 필드는 「민감한」 데이터 요소입니다.

메타로 필터링하기

커스텀 포스트, 댓글, 사용자, 분류체계(태그 및 카테고리)는 metaQuery 입력을 사용하여 메타로 필터링할 수도 있습니다.

이 입력은 meta_query 인수를 지정하는 방법(get_posts, get_users 등의 함수에 대해)을 개선한 것으로, GraphQL 스키마에서 타입 유효성 검사가 엄격하게 적용되며 의미 있는 조합만 공개됩니다.

이는 "oneof" 입력 필드 compareBy를 사용하여 구현되며, 4가지 선택지가 제공됩니다. 선택한 옵션에 따라 비교에 사용할 수 있는 연산자가 달라집니다.

compareBy 입력사용 가능한 연산자
1. keyEXISTS
NOT EXISTS
2. numericValue=
!=
>
>=
<
\<=
3. stringValue=
!=
LIKE
NOT LIKE
REGEXP
NOT REGEXP
RLIKE
4. arrayValueIN
NOT IN
BETWEEN
NOT BETWEEN

또한, key로 비교하는 경우에는 입력 value를 지정할 필요가 없습니다.

metaQuery에 여러 항목을 전달할 수 있으며, 목록의 첫 번째 항목에 입력 relation을 지정함으로써 조건을 AND 또는 OR로 결합할지 여부를 결정할 수 있습니다.