更改数据保留期 - Amazon Kinesis Data Streams
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

更改数据保留期

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

您可以通过 Kinesis Data Streams 控制台或使用IncreaseStreamRetentionPeriodDecreaseStreamRetentionPeriod操作来更新保留期。利用 Kinesis Data Streams 控制台,您可以同时批量编辑多个数据流的保留期。您可以使用IncreaseStreamRetentionPeriod操作或 Kinesis Data Streams 控制台将保留期延长至最长 8760 小时(365 天)。您可以使用该DecreaseStreamRetentionPeriod操作或 Kinesis Data Streams 控制台将保留期缩短至至少 24 小时。两个操作的请求语法均包括流名称和保留期(以小时为单位)。最后,您可以通过调用 DescribeStream 操作来检查流的当前保留期。

以下是使用 Amazon 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 定价