기본 쿼리 생성(JavaScript)

에 로그인 AWS Management Console 하고 AppSync 콘솔을 엽니다.

1. API 대시보드에서 GraphQL API를 선택합니다.

2. 사이드바에서 스키마를 선택합니다.

스키마와 데이터 원본의 세부 정보를 입력합니다. 자세한 내용은 스키마 설계 및 데이터 원본 연결 섹션을 참조하세요.

스키마 편집기 옆에는 해석기라는 창이 있습니다. 이 상자에는 스키마 창에 정의된 형식 및 필드 목록이 있습니다. 필드에 해석기를 연결할 수 있습니다. 주로 필드 작업에 해석기를 연결하게 될 것입니다. 이 섹션에서는 간단한 쿼리 구성을 살펴보겠습니다. 쿼리 유형에서 쿼리 필드 옆에 있는 연결을 선택합니다.

해석기 연결 페이지의 해석기 유형에서 파이프라인 또는 단위 해석기 중에서 선택할 수 있습니다. 이러한 유형에 대한 자세한 내용은 해석기를 참조하세요. 이 안내서에서는 pipeline resolvers를 활용합니다.

해석기 런타임의 경우 APPSYNC_JS를 선택하여 JavaScript 런타임을 활성화하세요.

이 API에 캐싱을 활성화할 수 있습니다. 그러나 지금은 이 기능을 끄는 것이 좋습니다. 생성(Create)을 선택합니다.

해석기 편집 페이지에는 해석기 핸들러 및 응답(사전 및 사후 단계)에 대한 로직을 구현할 수 있게 해주는 해석기 코드라는 코드 편집기가 있습니다. 자세한 내용은 JavaScript 해석기 개요를 참조하세요.

import {util} from '@aws-appsync/utils';

export function request(ctx) {
    return {};
}

export function response(ctx) {
    return ctx.prev.result;
}

이 섹션 아래에는 함수라는 테이블이 있습니다. 함수를 사용하면 여러 해석기에서 재사용할 수 있는 코드를 구현할 수 있습니다. 코드를 계속 다시 작성하거나 복사하는 대신, 소스 코드를 함수로 저장하여 필요할 때마다 해석기에 추가되도록 할 수 있습니다.

함수는 파이프라인 작업 목록의 대부분을 구성합니다. 해석기에서 여러 함수를 사용하는 경우 함수 순서를 설정하면 해당 순서대로 순차적으로 실행됩니다. 이러한 함수는 요청 함수가 실행된 후와 응답 함수가 시작되기 전에 실행됩니다.

새 함수를 추가하려면 함수에서 함수 추가를 선택한 다음 새 함수 생성을 선택합니다. 또는 선택할 수 있는 함수 생성 버튼이 표시될 수도 있습니다.

1. 데이터 원본을 선택합니다. 이 항목은 해석기가 작동하는 데이터 원본이 됩니다.

   참고

   이 예제에서는 id로 Post 객체를 검색하는 getPost에 대한 해석기를 연결합니다. 이 스키마에 대한 DynamoDB 테이블을 이미 설정했다고 가정해 보겠습니다. 파티션 키는 id로 설정되어 있고 비어 있습니다.

2. Function name을 입력합니다.

3. 함수 코드에서 함수의 동작을 구현해야 합니다. 헷갈릴 수도 있지만 각 함수에는 고유한 로컬 요청 및 응답 핸들러가 있습니다. 요청이 실행되면 요청을 처리하기 위한 데이터 원본 간접 호출이 수행되고, 응답 핸들러가 데이터 원본 응답을 처리합니다. 결과는 컨텍스트 객체에 저장됩니다. 이후에는 목록의 다음 함수가 실행되거나 마지막 함수인 경우 사후 단계 응답 핸들러로 전달됩니다.

   참고

   이 예제에서는 데이터 원본에서 Post 객체 목록을 가져오는 getPost에 해석기를 연결합니다. 요청 함수는 테이블에서 데이터를 요청하고, 테이블은 컨텍스트(ctx)에 응답을 전달한 다음, 응답은 컨텍스트에 결과를 반환합니다. AWS AppSync의 강도는 다른 AWS 서비스와의 상호 연결성에 있습니다. DynamoDB를 사용하고 있기 때문에 이와 같은 작업을 단순화할 수 있는 일련의 작업이 있습니다. 다른 데이터 원본 유형에 대한 몇 가지 보일러플레이트 예제도 있습니다.

   코드는 다음과 같습니다.

   import { util } from '@aws-appsync/utils';
   
   /**
    * Performs a scan on the dynamodb data source
    */
   export function request(ctx) {
     return { operation: 'Scan' };
   }
   
   /**
    * return a list of scanned post items
    */
   export function response(ctx) {
     return ctx.result.items;
   }

   이 단계에서는 두 가지 함수를 추가했습니다.

   • request: 요청 핸들러는 데이터 원본에 대해 검색 작업을 수행합니다. 인수에는 컨텍스트 객체(ctx) 또는 특정 작업을 수행하는 모든 해석기에 사용할 수 있는 일부 데이터가 포함됩니다. 예를 들어 권한 부여 데이터, 해석 중인 필드 이름 등이 포함될 수 있습니다. 반환 문은 Scan 작업을 수행합니다(예시는 여기를 참조). DynamoDB로 작업 중이므로 해당 서비스의 일부 작업을 사용할 수 있습니다. 스캔은 테이블 내 모든 항목에 대한 기본 가져오기를 수행합니다. 이 작업의 결과는 응답 핸들러로 전달되기 전에 컨텍스트 객체에 result 컨테이너로 저장됩니다. request는 파이프라인에서 응답보다 먼저 실행됩니다.

   • response: request의 출력을 반환하는 응답 핸들러입니다. 인수는 업데이트된 컨텍스트 객체이고, 반환 문은 ctx.prev.result입니다. 이 시점에서는 이 값에 익숙하지 않을 수 있습니다. ctx는 컨텍스트 객체를 나타냅니다. prev는 파이프라인에서의 이전 작업을 나타내며, 여기에서는 request였습니다. result에는 파이프라인을 통과하는 해석기의 결과가 포함됩니다. 종합해 보면 ctx.prev.result는 마지막으로 수행된 작업, 즉 요청 핸들러의 결과를 반환합니다.

4. 완료했으면 생성을 선택합니다.

해석기 화면으로 돌아가서 함수 아래에서 함수 추가 드롭다운을 선택하고 함수를 함수 목록에 추가합니다.

저장을 선택하여 해석기를 업데이트합니다.

에 로그인 AWS Management Console 하고 AppSync 콘솔을 엽니다.

1. API 대시보드에서 GraphQL API를 선택합니다.

2. 사이드바에서 스키마를 선택합니다.

해석기 섹션 및 변형 유형에서 필드 옆에 있는 연결을 선택합니다.

해석기 연결 페이지의 해석기 유형에서 pipeline resolvers를 선택합니다. 참고로 해석기에 대한 추가 정보는 여기에서 확인할 수 있습니다. 해석기 런타임의 경우 APPSYNC_JS를 선택하여 JavaScript 런타임을 활성화하세요.

이 API에 캐싱을 활성화할 수 있습니다. 그러나 지금은 이 기능을 끄는 것이 좋습니다. 생성(Create)을 선택합니다.

함수 추가를 선택한 다음 새 함수 생성을 선택합니다. 또는 선택할 수 있는 함수 생성 버튼이 표시될 수도 있습니다.

1. 데이터 원본을 선택합니다. 변형을 사용하여 조작할 데이터가 들어 있는 원본이어야 합니다.

2. Function name을 입력합니다.

3. 함수 코드에서 함수의 동작을 구현해야 합니다. 이는 변형이므로 요청은 간접적으로 호출된 데이터 원본에서 일부 상태 변경 작업을 수행하는 것이 이상적입니다. 결과는 응답 함수에 의해 처리됩니다.

   참고

   createPost는 파라미터를 데이터로 사용하여 테이블에 새 Post를 추가하거나 '퍼팅'합니다. 다음과 같이 추가할 수 있습니다.

   import { util } from '@aws-appsync/utils';
   
   /**
    * Sends a request to `put` an item in the DynamoDB data source
    */
   export function request(ctx) {
     return {
       operation: 'PutItem',
       key: util.dynamodb.toMapValues({id: util.autoId()}),
       attributeValues: util.dynamodb.toMapValues(ctx.args.input),
     };
   }
   
   /**
    * returns the result of the `put` operation
    */
   export function response(ctx) {
     return ctx.result;
   }

   이 단계에서 request 및 response 함수도 추가했습니다.

   • request: 요청 핸들러는 컨텍스트를 인수로 받아들입니다. 요청 핸들러 반환 문은 내장된 DynamoDB 작업인 PutItem 명령을 수행합니다(예시는 여기 또는 여기 참조). PutItem 명령은 파티션 key 값(util.autoid()에서 자동으로 생성됨)과 컨텍스트 인수 입력의 attributes(요청 시 전달할 값)를 가져와 DynamoDB 테이블에 Post 객체를 추가합니다. key는 id이고 attributes는 date 및 title 필드 인수입니다. 둘 다 DynamoDB 테이블에서 작동하도록 util.dynamodb.toMapValues 도우미를 통해 미리 형식이 지정되어 있습니다.

   • response: 응답은 업데이트된 컨텍스트를 수락하고 요청 핸들러의 결과를 반환합니다.

4. 완료했으면 생성을 선택합니다.

해석기 화면으로 돌아가서 함수 아래에서 함수 추가 드롭다운을 선택하고 함수를 함수 목록에 추가합니다.

저장을 선택하여 해석기를 업데이트합니다.