Write data to Amazon Kinesis Data Streams - Amazon Kinesis Data Streams
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Write data to Amazon Kinesis Data Streams

A producer is an application that writes data to Amazon Kinesis Data Streams. You can build producers for Kinesis Data Streams using the Amazon SDK for Java and the Kinesis Producer Library (KPL).

If you are new to Kinesis Data Streams, start by becoming familiar with the concepts and terminology presented in What is Amazon Kinesis Data Streams? and Use the Amazon CLI to perform Amazon Kinesis Data Streams operations.

Important

Kinesis Data Streams supports changes to the data record retention period of your data stream. For more information, see Change the data retention period.

To put data into the stream, you must specify the name of the stream, a partition key, and the data blob to be added to the stream. The partition key is used to determine which shard in the stream the data record is added to.

All the data in the shard is sent to the same worker that is processing the shard. Which partition key you use depends on your application logic. The number of partition keys should typically be much greater than the number of shards. This is because the partition key is used to determine how to map a data record to a particular shard. If you have enough partition keys, the data can be evenly distributed across the shards in a stream.

Topics