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

更改数据保留期

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 定价