UpdateItem

UpdateItem 요청을 사용하면 AWS AppSync DynamoDB 함수에 DynamoDB에 UpdateItem 요청을 하도록 지시하고 다음을 지정할 수 있습니다.

UpdateItem 요청의 구조는 다음과 같습니다.

type DynamoDBUpdateItemRequest = {
  operation: 'UpdateItem';
  key: { [key: string]: any };
  update: {
    expression: string;
    expressionNames?: { [key: string]: string };
    expressionValues?: { [key: string]: any };
  };
  condition?: ConditionCheckExpression;
  customPartitionKey?: string;
  populateIndexFields?: boolean;
  _version?: number;
};

필드는 다음과 같이 정의됩니다.

UpdateItem 필드

DynamoDB에서 업데이트된 항목은 자동으로 GraphQL 및 JSON 기본 유형으로 변환되며 컨텍스트 결과(context.result)에서 사용할 수 있습니다.

DynamoDB 유형 변환에 대한 자세한 내용은 유형 시스템(응답 매핑)을 참조하세요.

JavaScript 해석기에 대한 자세한 내용은 JavaScript 해석기 개요를 참조하세요.

예 1

다음 예제는 GraphQL 뮤테이션 upvote(id: ID!)를 위한 함수 요청 핸들러입니다.

이 예에서 DynamoDB의 항목에는 1씩 증가하는 upvotes 및 version 필드가 있습니다.

import { util } from '@aws-appsync/utils';
export function request(ctx) {
  const { id } = ctx.args;
  return {
    operation: 'UpdateItem',
    key: util.dynamodb.toMapValues({ id }),
    update: {
      expression: 'ADD #votefield :plusOne, version :plusOne',
      expressionNames: { '#votefield': 'upvotes' },
      expressionValues: { ':plusOne': { N: 1 } },
    },
  };
}

예제 2

다음 예제는 GraphQL 뮤테이션 updateItem(id: ID!, title: String, author: String, expectedVersion: Int!)을 위한 함수 요청 핸들러입니다.

다음은 인수를 조사해 클라이언트에서 제공한 인수만 포함하는 업데이트 표현식을 동적으로 생성하는 복잡한 예입니다. 예를 들어, title 및 author는 생략되면 업데이트되지 않습니다. 인수가 지정되어 있으나 그 값이 null이면 DynamoDB의 객체에서 해당 필드가 삭제됩니다. 마지막으로, 이 작업에는 DynamoDB에 현재 있는 항목에 expectedVersion으로 설정된 version 필드가 있는지 확인하는 조건이 있습니다.

import { util } from '@aws-appsync/utils';
export function request(ctx) {
  const { args: { input: { id, ...values } } } = ctx;

  const condition = {
    id: { attributeExists: true },
    version: { eq: values.expectedVersion },
  };
  values.expectedVersion += 1;
  return dynamodbUpdateRequest({ keys: { id }, values, condition });
}


/**
 * Helper function to update an item
 * @returns an UpdateItem request
 */
function dynamodbUpdateRequest(params) {
  const { keys, values, condition: inCondObj } = params;

  const sets = [];
  const removes = [];
  const expressionNames = {};
  const expValues = {};

  // Iterate through the keys of the values
  for (const [key, value] of Object.entries(values)) {
    expressionNames[`#${key}`] = key;
    if (value) {
      sets.push(`#${key} = :${key}`);
      expValues[`:${key}`] = value;
    } else {
      removes.push(`#${key}`);
    }
  }

  let expression = sets.length ? `SET ${sets.join(', ')}` : '';
  expression += removes.length ? ` REMOVE ${removes.join(', ')}` : '';

  const condition = JSON.parse(
    util.transform.toDynamoDBConditionExpression(inCondObj)
  );

  return {
    operation: 'UpdateItem',
    key: util.dynamodb.toMapValues(keys),
    condition,
    update: {
      expression,
      expressionNames,
      expressionValues: util.dynamodb.toMapValues(expValues),
    },
  };
}

DynamoDB UpdateItem API에 대한 자세한 내용은 DynamoDB API 문서를 참조하십시오.