I can't find in the formal documentation of AWS Kinesis
any explicit reference between TRIM_HORIZON
and the checkpoint, and also any reference between LATEST
and the checkpoint.
Can you confirm my theory:
TRIM_HORIZON
- In case the application-name is new, then I will read all the records available in the stream. Else, application-name was already used, then I will read from my last checkpoint.
LATEST
- In case the application-name is new, then I will read all the records in the stream which added after I subscribed to the stream. Else, application-name was already used, I will read messages from my last checkpoint.
The difference between TRIM_HORIZON
and LATEST
is only in case the application-name is new.
TRIM_HORIZON : Start streaming at the last untrimmed record in the shard, which is the oldest data record in the shard. LATEST : Start streaming just after the most recent record in the shard, so that you always read the most recent data in the shard. Type: String.
A shard iterator specifies the shard position from which to start reading data records sequentially. The position is specified using the sequence number of a data record in a shard.
What is the retention period supported by Kinesis Data Streams? The default retention period of 24 hours covers scenarios where intermittent lags in processing require catch-up with the real-time data.
A shard iterator provides information about how to retrieve the stream records from within a shard. Use the shard iterator in a subsequent GetRecords request to read the stream records from the shard. A shard iterator expires 15 minutes after it is returned to the requester.
AT_TIMESTAMP
-- from specific time stamp
TRIM_HORIZON
-- all the available messages in Kinesis stream from the beginning (same as earliest in Kafka)
LATEST
-- from the latest messages , i.e current message that just came into Kinesis/Kafka and all the incoming messages from that time onwords
From GetShardIterator documentation (which lines up with my experience using Kinesis):
In the request, you can specify the shard iterator type
AT_TIMESTAMP
to read records from an arbitrary point in time,TRIM_HORIZON
to cause ShardIterator to point to the last untrimmed record in the shard in the system (the oldest data record in the shard), orLATEST
so that you always read the most recent data in the shard.
Basically, the difference is whether you want to start from the oldest record (TRIM_HORIZON
), or from "right now" (LATEST
- skipping data between latest checkpoint and now).
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With