Amazon DynamoDB · AsyncAPI Specification

Amazon DynamoDB Streams

Version 2012-08-10

Amazon DynamoDB Streams captures a time-ordered sequence of item-level modifications in any DynamoDB table and stores this information in a log for up to 24 hours. Applications can access this log and view the data items as they appeared before and after they were modified, in near-real time. DynamoDB Streams writes stream records in near-real time so that you can build applications that consume these streams and take action based on the contents. A stream record contains information about a data modification to a single item in a DynamoDB table. Stream records are organized into groups called shards. Each shard acts as a container for multiple stream records and contains information required for accessing and iterating through these records. Stream records can be configured to capture one of four view types: KEYS_ONLY (only the key attributes of the modified item), NEW_IMAGE (the entire item as it appears after modification), OLD_IMAGE (the entire item as it appeared before modification), or NEW_AND_OLD_IMAGES (both the new and old images of the item).

View Spec View on GitHub AWSCloudDatabaseDocument StoreKey-ValueManaged ServiceNoSQLServerlessAsyncAPIWebhooksEvents

Channels

streamRecord
A DynamoDB Stream for a specific table. When DynamoDB Streams is enabled on a table, every modification to data items in the table is captured as a stream record. Each stream record is written in near-real time and appears in the stream in the order in which the actual modifications occurred. Stream records are organized into shards, which are containers for stream records.
lambdaTrigger
DynamoDB Streams can be configured as an event source for AWS Lambda. Lambda polls the stream and invokes the function synchronously with a batch of stream records. The event source mapping controls the batch size, starting position, and error handling behavior.

Messages

✉
StreamRecordInsert
Item Insert Stream Record
A stream record generated when a new item is inserted
✉
StreamRecordModify
Item Modify Stream Record
A stream record generated when an existing item is modified
✉
StreamRecordRemove
Item Remove Stream Record
A stream record generated when an item is deleted
✉
LambdaStreamEvent
Lambda DynamoDB Stream Event
Batch of DynamoDB stream records delivered to a Lambda function

Servers

https
production
Amazon DynamoDB Streams regional endpoint. Stream records are accessed via the DynamoDB Streams API using HTTP/JSON protocol with AWS SigV4 authentication.
https
lambda-trigger
AWS Lambda integration endpoint. DynamoDB Streams can trigger Lambda functions automatically via event source mapping, providing a serverless stream processing pattern.