GraphQL 유형, 해석기 및 연산자

필드 매핑

App Services는 컬렉션 스키마의 필드를 GraphQL 형식의 필드에 직접 매핑하려고 시도합니다. GraphQL 사양에 설명된 유효한 이름의 정의는 가능한 모든 유효한 문서 필드 이름을 지원하지 않으므로 App Services에서는 다음 변환 규칙을 적용하여 생성된 GraphQL 유형에서 필드 이름을 결정합니다.

• 지원되지 않는 문자를 제거합니다

• 선행 숫자 제거

• 카멜 표기법으로 변환

• 이중 밑줄로 시작하는 필드는 생략하세요(예: __myField).

BSON Type 매핑

GraphQL 유형 시스템은 스키마에서 사용할 수 있는 BSON types와 유사하지만 동일하지는 않습니다. App Services는 스키마의 BSON types와 지원되는 GraphQL 유형 간의 매핑을 자동으로 시도합니다. 필드 유형에 해당하는 GraphQL이 없는 경우, App Services는 생성된 GraphQL 문서 유형에 해당 필드를 포함하지 않습니다.

다음 표에는 스키마에서 사용할 수 있는 BSON 유형과 매핑되는 GraphQL 유형이 나열되어 있습니다.

쿼리 입력

QueryInput 객체는 문서가 쿼리에 포함되기 위해 하나 이상의 조건 세트를 정의합니다. 객체에는 문서 유형의 필드와 App Services가 각 필드 유형에 따라 자동으로 생성하는 연산자 필드가 포함될 수 있습니다.

• 문서 필드: QueryInput 필드의 이름이 문서 유형의 필드와 동일한 경우, 입력 필드에 지정된 값과 문서의 필드 값이 같으면 App Services와 문서가 일치합니다.

  예시

  다음 쿼리에는 rated 및 year라는 두 개의 필드가 있는 QueryInput이 포함되어 있습니다. 이 두 필드 이름은 모두 Movie 문서 유형에 정의되어 있으므로 App Services에서 두 필드 이름에 대해 동등성 매치를 수행합니다.

  이 쿼리는 2000년에 개봉한 모든 영화 중 R등급을 받은 영화의 제목을 반환합니다.

  movies(query: { rated: "R", year: 2000 }) {
    title
  }

• 연산자 필드: QueryInput 필드가 쿼리된 유형에 대해 유효한 연산자 필드인 경우 연산자가 true로 평가되면 App Services는 문서를 일치시킵니다.

  예시

  다음 쿼리에는 rated_in 및 year_gt(이)라는 두 개의 필드가 있는 QueryInput이(가) 포함되어 있습니다. 두 필드는 모두 연산자 필드이므로 App Services는 각 연산자를 평가하여 문서가 일치하는지 확인합니다.

  이 쿼리는 2000년 이후에 출시된 영화 중 G등급 또는 PG-13등급을 받은 모든 영화의 제목을 반환합니다.

  movies(query: { rated_in: ["G", "PG-13"], year_gt: 2000 }) {
    title
  }

<Field Name>_<Operator>: <Operator Value>

movies(query: { year_gt: 2000 }) {
  title
  year
}

movies(query: { year_gte: 2000 }) {
  title
  year
}

movies(query: { year_lt: 2000 }) {
  title
  year
}

movies(query: { year_lte: 2000 }) {
  title
  year
}

movies(query: { year_ne: 2000 }) {
  title
  year
}

movies(query: { cast_in: ["Emma Stone", "Ryan Gosling"] }) {
  title
  year
}

movies(query: { rated_nin: ["G", "PG-13"] }) {
  title
  year
}

<Operator>: [<QueryInput>, ...]

query {
  movies(query: { AND: [{ rated: "PG-13" }, { runtime_lt: 120 }] }) {
    title
    year
  }
}

query {
  movies(query: { OR: [{ rated: "G" }, { rated: "PG-13" }] }) {
    title
    year
  }
}

<Field Name>_<Operator>: <Operator Value>

query {
  movies(query: { year_exists: false }) {
    _id
    title
  }
}

InsertInput

InsertInput 객체는 컬렉션에 삽입할 문서를 정의합니다. 문서는 GraphQL 문서 유형을 따라야 하며 필수 필드를 모두 포함해야 합니다.

insertOneMovie(input: {
  title: "My Fake Film",
  rated: "UNRATED",
  year: 2020
}) {
  title
}

UpdateInput

UpdateInput 객체는 문서에서 하나 이상의 필드에 대한 새 값을 정의합니다. 업데이트된 문서에는 새 필드 값이 포함되어 있습니다. 지정하지 않은 필드는 변경되지 않은 상태로 유지됩니다. 업데이트된 값은 GraphQL 문서 유형을 준수해야 합니다.

updateOneMovie(
  query: { title: "My Fake Film" }
  set: { title: "My Super Real Film" }
) {
  title
}

RelationInput

RelationInput는 변경된 문서의 관계 필드에 대한 새로운 관련 문서 집합을 정의합니다. 관련 컬렉션에 이미 있는 문서를 link 필드로 참조하거나 create 필드를 사용하여 관련 컬렉션에 새 문서를 삽입할 수 있습니다.

link 와 create를 동시에 사용할 수 없습니다. 둘 다 지정하면 create 작업이 우선되고 link는 무시됩니다.

type RelationInput {
  link: [ObjectId]
  create: [InsertInput]
}

updateOneMovie(
  query: { title: "My Fake Film" }
  set: {
    reviews: {
      link: ["", ""]
      create: []
    }
  }
) {
  title
}

SortByInput

SortByInput 열거형은 쿼리에서 반환되는 문서의 정렬 순서를 정의합니다. object 또는 array 유형이 없는 루트 수준 필드를 기준으로 오름차순 및 내림차순으로 정렬할 수 있습니다. GraphQL API는 중첩 정렬을 지원하지 않습니다.

App Services는 각 필드에 대해 두 개의 정렬 열거형 값을 생성합니다. 각 값은 필드 이름과 정렬 방향(ASC 또는 DESC)을 결합한 대문자로 된 식별자입니다.

movies(sortBy: YEAR_DESC) {
  title
}

단일 문서 찾기

단일 문서 쿼리 필드는 collection에 포함된 데이터 유형과 동일한 이름을 사용합니다. 쿼리된 유형의 단일 문서를 반환하고 다음 매개변수를 허용합니다.

query {
  movie(query: { title: "The Matrix" }) {
    title
    year
    runtime
    director
  }
}

여러 문서 찾기

다중 문서 쿼리 필드는 컬렉션에 포함된 데이터 유형과 동일한 이름을 사용하지만 유형 이름에 "s"가 붙습니다. 쿼리된 유형의 문서 배열을 반환하고 다음 매개변수를 허용합니다.

query {
  movies(
    query: { year: 2000 }
    limit: 100
    sortBy: TITLE_ASC
  ) {
    title
    year
    runtime
    director
  }
}

단일 문서 삽입

이 단일 문서 삽입 변형 필드는 insertOne<Type>(이)라는 이름을 사용합니다. 여기서 <Type>은(는) 컬렉션에 포함된 데이터 유형의 단수형 이름입니다. 이 필드는 삽입된 문서를 반환하고 다음 매개변수를 허용합니다.

mutation {
  insertOneMovie(data: {
    title: "Little Women"
    director: "Greta Gerwig"
    year: 2019
    runtime: 135
  }) {
    _id
    title
  }
}

여러 문서를 삽입합니다.

다중 문서 삽입 변형 필드는 insertMany<Type>s이라는 이름을 사용하며, 여기서 <Type>은 컬렉션에 포함된 데이터 유형의 단수형 이름입니다. 이 필드는 삽입된 문서를 반환하고 다음 매개 변수를 허용합니다.

mutation {
  insertManyMovies(data: [
    {
      title: "Little Women"
      director: "Greta Gerwig"
      year: 2019
      runtime: 135
    },
    {
      title: "1917"
      director: "Sam Mendes"
      year: 2019
      runtime: 119
    }
  ]) {
    _id
    title
  }
}

단일 문서 업데이트

단일 문서 업데이트 변형 필드는 updateOne<Type>(이)라는 이름을 사용합니다. 여기서 <Type>은(는) collection에 포함된 데이터 유형의 단수형 이름입니다. 업데이트된 문서를 반환하고 다음 매개 변수를 허용합니다.

mutation {
  updateOneMovie(
    query: { title: "The Room" }
    set: { runtime: 99 }
  ) {
    _id
    title
  }
}

여러 문서 업데이트하기

이 복수 문서 업데이트 변형 필드는 updateMany<Type>s이라는 이름을 사용합니다. 여기서 <Type>은 컬렉션에 포함된 데이터 유형의 단수형 이름입니다. 일치하고 수정된 필드 수를 설명하는 UpdateManyPayload 문서를 반환하고 다음 매개변수를 허용합니다.

mutation {
  updateManyMovies(
    query: { director: "Tommy Wiseau" }
    set: { director: "Tom Wiseau" }
  ) {
    matchedCount
    modifiedCount
  }
}

단일 문서 업로드

이 단일 문서 업서트 변형 필드는 upsertOne<Type>(이)라는 이름을 사용합니다. 여기서 <Type>은(는) 컬렉션에 포함된 데이터 유형의 단수형 이름입니다. 이 해석기는 해당 쿼리 매개변수와 일치하는 문서를 업데이트하고, 쿼리와 일치하는 문서가 없는 경우 새 문서를 삽입합니다. 아울러 업서트된 문서를 반환하고 다음 매개변수를 허용합니다.

mutation {
  upsertOneMovie(
    query: { title: "Blacksmith Scene" }
    data: {
      title: "Sandcastles in the Sand",
      director: "Robin Scherbatsky"
      runtime: 90
      year: 2002
    }
  ) {
    _id
    title
  }
}

단일 문서 교체하기

이 단일 문서 대체 변형 필드는 replaceOne<Type>(이)라는 이름을 사용합니다. 여기서 <Type>은(는) 컬렉션에 포함된 데이터 유형의 단수형 이름입니다. 이 필드는 대체된 문서를 반환하고 다음 매개변수를 허용합니다.

mutation {
  replaceOneMovie(
    query: { title: "Blacksmith Scene" }
    data: {
      title: "Sandcastles in the Sand",
      director: "Robin Scherbatsky"
      runtime: 90
      year: 2002
    }
  ) {
    _id
    title
  }
}

단일 문서 삭제

이 단일 문서 삭제 변형 필드는 deleteOne<Type>(이)라는 이름을 사용합니다. 여기서 <Type>은(는) 컬렉션에 포함된 데이터 유형의 단수형 이름입니다. 이 필드는 삭제된 문서를 반환하고 다음 매개변수를 허용합니다.

mutation {
  deleteOneMovie(query: { title: "The Room" }) {
    _id
    title
    year
    runtime
    director
  }
}

여러 문서 삭제

이 복수 문서 삭제 변형 필드는 deleteMany<Type>s(이)라는 이름을 사용합니다. 여기서 <Type>은(는) 컬렉션에 포함된 데이터 유형의 단수형 이름입니다. 이 필드는 삭제된 문서의 수를 설명하고 다음 매개변수를 허용하는 DeleteManyPayload 문서를 반환합니다.

mutation {
  deleteManyMovies(query: { director: "Tommy Wiseau" }) {
    deletedCount
  }
}