Expressões de condição da transação

As expressões de condição da transação estão disponíveis em solicitações de todos os quatro tipos de operações em TransactWriteItems, ou seja, PutItem, DeleteItem, UpdateItem e ConditionCheck.

Em PutItem, DeleteItem e UpdateItem, a expressão de condição da transação é opcional. Em ConditionCheck, a expressão de condição da transação é necessária.

Exemplo 1

A função transacional DeleteItem a seguir não tem uma expressão de condição. Como resultado, ele exclui o item no DynamoDB.

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

export function request(ctx) {
  const { postId } = ctx.args;
  return {
    operation: 'TransactWriteItems',
    transactItems: [
      {
        table: 'posts',
        operation: 'DeleteItem',
        key: util.dynamodb.toMapValues({ postId }),
      }
    ],
  };
}

Exemplo 2

O manipulador da solicitação da função transacional DeleteItem a seguir possui uma expressão de condição da transação que permite que a operação seja bem-sucedida apenas se o autor dessa postagem for igual a determinado nome.

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

export function request(ctx) {
  const { postId, authorName} = ctx.args;
  return {
    operation: 'TransactWriteItems',
    transactItems: [
      {
        table: 'posts',
        operation: 'DeleteItem',
        key: util.dynamodb.toMapValues({ postId }),
        condition: util.transform.toDynamoDBConditionExpression({
          authorName: { eq: authorName },
        }),
      }
    ],
  };
}

Se a verificação de condição falhar, causará TransactionCanceledException e os detalhes de erro serão retornados em ctx.result.cancellationReasons. Observe que, por padrão, o item antigo no DynamoDB que fez a verificação da condição falhar será retornado em ctx.result.cancellationReasons.

Especificação de uma condição

Os objetos da solicitação PutItem, UpdateItem e DeleteItem permitem que uma seção condition opcional seja especificada. Se omitida, nenhuma verificação de condição é feita. Se especificada, a condição deve ser verdadeira para que a operação seja bem-sucedida. A ConditionCheck deve ter uma seção condition a ser especificada. A condição deve ser verdadeira para que toda a transação seja bem-sucedida.

A seção condition tem a seguinte estrutura:

type TransactConditionCheckExpression = {
  expression: string;
  expressionNames?: { [key: string]: string };
  expressionValues?: { [key: string]: string };
  returnValuesOnConditionCheckFailure: boolean;
};

Os campos a seguir especificam a condição: