GraphQL의 스칼라 유형

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GraphQL 객체 유형에는 이름과 필드가 있으며 이러한 필드에는 하위 필드가 있을 수 있습니다. 궁극적으로 객체 유형의 필드는 쿼리의 리프를 나타내는 스칼라 유형으로 해석되어야 합니다. 객체 유형과 스칼라에 대한 자세한 내용은 GraphQL 웹 사이트의 스키마 및 유형을 참조하세요.

기본 GraphQL 스칼라 세트 외에도 AWS 접두사로 시작하는 서비스 정의 스칼라를 사용할 AWS AppSync 수 있습니다. AWS AppSync 는 사용자 정의(사용자 지정) 스칼라 생성을 지원하지 않습니다. 기본 스칼라 또는 AWS 스칼라를 사용해야 합니다.

AWS를 사용자 지정 객체 형식의 접두사로 사용할 수 없습니다.

다음 섹션은 스키마 입력에 대한 참조입니다.

기본 스칼라

GraphQL은 다음과 같은 디폴트 스칼라를 정의합니다.

AWS AppSync 스칼라

AWS AppSync 는 다음과 같은 스칼라를 정의합니다.

스키마 예제 사용

다음 예제 GraphQL 스키마는 모든 사용자 지정 스칼라를 '객체'로 사용하고 기본 put, get 및 list 작업에 대한 해석기 요청 및 응답 템플릿을 보여줍니다. 마지막으로 예제는 쿼리 및 뮤테이션을 실행할 때 이를 사용하는 방법을 보여줍니다.

type Mutation {
    putObject(
        email: AWSEmail,
        json: AWSJSON,
        date: AWSDate,
        time: AWSTime,
        datetime: AWSDateTime,
        timestamp: AWSTimestamp,
        url: AWSURL,
        phoneno: AWSPhone,
        ip: AWSIPAddress
    ): Object
}

type Object {
    id: ID!
    email: AWSEmail
    json: AWSJSON
    date: AWSDate
    time: AWSTime
    datetime: AWSDateTime
    timestamp: AWSTimestamp
    url: AWSURL
    phoneno: AWSPhone
    ip: AWSIPAddress
}

type Query {
    getObject(id: ID!): Object
    listObjects: [Object]
}

schema {
    query: Query
    mutation: Mutation
}

putObject에 대한 요청 템플릿의 모양은 다음과 같습니다. putObject는 PutItem 작업을 사용하여 Amazon DynamoDB 테이블에서 항목을 생성하거나 업데이트합니다. 참고로 이 코드 조각에는 데이터 소스로 구성된 Amazon DynamoDB 테이블이 없습니다. 다음은 예시용으로만 사용되고 있습니다.

{
    "version" : "2017-02-28",
    "operation" : "PutItem",
    "key" : {
        "id": $util.dynamodb.toDynamoDBJson($util.autoId()),
    },
    "attributeValues" : $util.dynamodb.toMapValuesJson($ctx.args)
}

putObject의 응답 템플릿은 다음과 같은 결과를 반환합니다.

$util.toJson($ctx.result)

getObject에 대한 요청 템플릿의 모양은 다음과 같습니다. getObject는 GetItem 작업을 시작하여 주어진 기본 키와 함께 항목에 대한 속성 집합을 반환합니다. 참고로 이 코드 조각에는 데이터 소스로 구성된 Amazon DynamoDB 테이블이 없습니다. 다음은 예시용으로만 사용되고 있습니다.

{
    "version": "2017-02-28",
    "operation": "GetItem",
    "key": {
        "id": $util.dynamodb.toDynamoDBJson($ctx.args.id),
    }
}

getObject의 응답 템플릿은 다음과 같은 결과를 반환합니다.

$util.toJson($ctx.result)

listObjects에 대한 요청 템플릿의 모양은 다음과 같습니다. listObjects는 Scan 작업을 사용하여 하나 이상의 항목과 속성을 반환합니다. 참고로 이 코드 조각에는 데이터 소스로 구성된 Amazon DynamoDB 테이블이 없습니다. 다음은 예시용으로만 사용되고 있습니다.

{
    "version" : "2017-02-28",
    "operation" : "Scan",
}

listObjects의 응답 템플릿은 다음과 같은 결과를 반환합니다.

$util.toJson($ctx.result.items)

다음은 이 스키마를 GraphQL 쿼리와 함께 사용하는 몇 가지 예제입니다.

mutation CreateObject {
    putObject(email: "example@example.com"
        json: "{\"a\":1, \"b\":3, \"string\": 234}"
        date: "1970-01-01Z"
        time: "12:00:34."
        datetime: "1930-01-01T16:00:00-07:00"
        timestamp: -123123
        url:"https://amazon.com"
        phoneno: "+1 555 764 4377"
        ip: "127.0.0.1/8"
    ) {
        id
        email
        json
        date
        time
        datetime
        url
        timestamp
        phoneno
        ip
    }
}

query getObject {
    getObject(id:"0d97daf0-48e6-4ffc-8d48-0537e8a843d2"){
        email
        url
        timestamp
        phoneno
        ip
    }
}

query listObjects {
    listObjects {
        json
        date
        time
        datetime
    }
}