DynamoDB - AWS Serverless Application Model
SintaxePropriedadesExemplos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

DynamoDB

O objeto que descreve um tipo de fonte de evento DynamoDB. Para obter mais informações, consulte Uso do AWS Lambda com o Amazon DynamoDB no Guia do desenvolvedor do AWS Lambda.

O AWS SAM gera um recurso AWS::Lambda::EventSourceMapping quando esse tipo de evento é definido.

Sintaxe

Para declarar esta entidade no modelo do AWS Serverless Application Model (AWS SAM), use a seguinte sintaxe:

Propriedades

BatchSize

O número máximo de itens a serem recuperados em um único lote.

Tipo: inteiro

Obrigatório: não

Padrão: 100

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade BatchSize de um recurso AWS::Lambda::EventSourceMapping.

Mínimo: 1

Maximum: 1000

BisectBatchOnFunctionError

Se a função retornar um erro, divida o lote em dois e tente novamente.

Tipo: booliano

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade BisectBatchOnFunctionError de um recurso AWS::Lambda::EventSourceMapping.

DestinationConfig

Uma fila do Amazon Simple Queue Service (Amazon SQS) ou um destino do tópico do Amazon Simple Notification Service (Amazon SNS) para registros descartados.

Tipo: DestinationConfig

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade DestinationConfig de um recurso AWS::Lambda::EventSourceMapping.

Enabled

Desabilita o mapeamento de origens de eventos para pausar a sondagem e a invocação.

Tipo: booliano

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade Enabled de um recurso AWS::Lambda::EventSourceMapping.

FilterCriteria

Um objeto que define os critérios para determinar se o Lambda deve processar um evento. Para obter mais informações, consulte Filtrando eventos do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Tipo: FilterCriteria

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade FilterCriteria de um recurso AWS::Lambda::EventSourceMapping.

FunctionResponseTypes

Uma lista de tipos de resposta atuais aplicados ao mapeamento da origem do evento. Para obter mais informações, consulte Relatar falhas de itens em lote no Guia do desenvolvedor do AWS Lambda.

Valores válidos: ReportBatchItemFailures

Tipo: lista

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade FunctionResponseTypes de um recurso AWS::Lambda::EventSourceMapping.

KmsKeyArn

O nome do recurso da Amazon (ARN) da chave para criptografar informações relacionadas a esse evento.

Tipo: string

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade KmsKeyArn de um recurso AWS::Lambda::EventSourceMapping.

MaximumBatchingWindowInSeconds

O máximo de tempo para reunir registros antes de invocar a função, em segundos.

Tipo: inteiro

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade MaximumBatchingWindowInSeconds de um recurso AWS::Lambda::EventSourceMapping.

MaximumRecordAgeInSeconds

A idade máxima de um registro que o Lambda envia a uma função para processamento.

Tipo: inteiro

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade MaximumRecordAgeInSeconds de um recurso AWS::Lambda::EventSourceMapping.

MaximumRetryAttempts

O número máximo de vezes para tentar novamente quando a função retorna um erro.

Tipo: inteiro

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade MaximumRetryAttempts de um recurso AWS::Lambda::EventSourceMapping.

MetricsConfig

Uma configuração opcional para obter métricas aprimoradas para os mapeamentos da origem do evento que capturam cada estágio do processamento. Para obter um exemplo, consulte Evento do MetricsConfig.

Tipo: MetricsConfig

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade MetricsConfig de um recurso AWS::Lambda::EventSourceMapping.

ParallelizationFactor

O número de lotes a serem processados de cada fragmento simultaneamente.

Tipo: inteiro

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade ParallelizationFactor de um recurso AWS::Lambda::EventSourceMapping.

StartingPosition

A posição em um fluxo da qual você deseja iniciar a leitura.

  • AT_TIMESTAMP – Especifique um tempo a partir do qual iniciar a leitura dos registros.

  • LATEST – Leia somente registros novos.

  • TRIM_HORIZON – Processe todos os registros disponíveis.

Valores válidos: AT_TIMESTAMP | LATEST | TRIM_HORIZON

Tipo: string

Obrigatório: Sim

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade StartingPosition de um recurso AWS::Lambda::EventSourceMapping.

StartingPositionTimestamp

O tempo a partir do qual iniciar a leitura, em segundos no horário do Unix. Defina StartingPositionTimestamp quando StartingPosition é especificado como .AT_TIMESTAMP

Tipo: duplo

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade StartingPositionTimestamp de um recurso AWS::Lambda::EventSourceMapping.

Stream

O nome de recurso da Amazon (ARN) do fluxo do DynamoDB.

Tipo: string

Obrigatório: Sim

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade EventSourceArn de um recurso AWS::Lambda::EventSourceMapping.

TumblingWindowInSeconds

A duração, em segundos, de uma janela de processamento. O intervalo válido é de 1 a 900 (15 minutos).

Para obter mais informações, consulte Janelas caindo no Guia do desenvolvedor do AWS Lambda.

Tipo: inteiro

Obrigatório: não

Compatibilidade CloudFormation: essa propriedade é passada diretamente para a propriedade TumblingWindowInSeconds de um recurso AWS::Lambda::EventSourceMapping.

Exemplos

Evento do MetricsConfig

Veja a seguir um exemplo de um recurso que usa a propriedade MetricsConfig para capturar cada estágio de processamento para seus mapeamentos da origem do evento.

Resources:
  FilteredEventsFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: s3://sam-demo-bucket/metricsConfig.zip
      Handler: index.handler
      Runtime: nodejs16.x
      Events:
        KinesisStream:
          Type: Kinesis
          Properties:
            Stream: !GetAtt KinesisStream.Arn
            StartingPosition: LATEST
            MetricsConfig:
              Metrics:
              - EventCount

Fonte de eventos do DynamoDB para a tabela existente do DynamoDB

Fonte de eventos do DynamoDB para uma tabela do DynamoDB que já existe em uma conta AWS.

YAML

Events:
  DDBEvent:
    Type: DynamoDB
    Properties:
      Stream: arn:aws:dynamodb:us-east-1:123456789012:table/TestTable/stream/2016-08-11T21:21:33.291
      StartingPosition: TRIM_HORIZON
      BatchSize: 10
      Enabled: false

Evento do DynamoDB para tabela do DynamoDB declarado no modelo

Evento do DynamoDB para uma tabela do DynamoDB declarada no mesmo arquivo de modelo.

YAML

Events:
  DDBEvent:
    Type: DynamoDB
    Properties:
      Stream: 
        !GetAtt MyDynamoDBTable.StreamArn   # This must be the name of a DynamoDB table declared in the same template file
      StartingPosition: TRIM_HORIZON
      BatchSize: 10
      Enabled: false