Amazon Kinesis Data Streams
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

更改数据保留期

Amazon Kinesis Data Streams 支持更改流的数据记录保留期。Kinesis data stream是数据记录的有序序列,可用于执行实时写入和读取。因此,数据记录临时存储在您的流的分片中。从添加记录开始,到记录不再可供访问为止的时间段称为保留期。Kinesis data stream 默认情况下存储记录 24 小时起,最高可存储 168 小时。

可以使用 IncreaseStreamRetentionPeriod 操作将保留期增加至 168 小时。可以使用 DecreaseStreamRetentionPeriod 操作将保留期缩短至 24 小时(最小值)。两个操作的请求语法均包括流名称和保留期(以小时为单位)。最后,您可以通过调用 DescribeStream 操作来检查流的当前保留期。

这两个操作都简单。以下是使用 AWS CLI 更改保留期的示例:

aws kinesis increase-stream-retention-period --stream-name retentionPeriodDemo --retention-period-hours 72

在增加保留期后的数分钟内,Kinesis Data Streams 会使处于旧保留期内的记录可继续访问。例如,将保留期从 24 小时更改为 48 小时意味着,在 23 小时 55 分钟之前添加到流中的记录在 24 小时之后仍可用。

在缩短保留期后,Kinesis Data Streams 几乎会立即使比新保留期更早的记录不可供访问。因此,在调用 DecreaseStreamRetentionPeriod 操作时务必小心谨慎。

设置数据保留期以确保在出现问题时,您的使用者可以在数据过期之前读取数据。您应该仔细考虑所有可能的情况,例如记录处理逻辑出现问题,或者下游依赖关系长时间断开。将保留期视为安全网,可留出更多时间供您的数据使用者恢复。使用保留期 API 操作,您可以主动设置此项,或者积极响应操作事件。

对于保留期设置为 24 小时以上的流,将收取额外费用。有关更多信息,请参阅Amazon Kinesis Data Streams 定价