本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
更改数据保留期
Amazon Kinesis Data Streams 支持更改数据流的数据记录保留期。Kinesis 数据流是数据记录的有序序列,可用于执行实时写入和读取。因此,数据记录临时存储在您的流的分片中。从添加记录开始,到记录不再可供访问为止的时间段称为保留期。默认情况下,Kinesis 数据流的记录存储时间从 24 小时到 8760 小时(365 天)不等。
您可以通过 Kinesis Data Streams 控制台或使用IncreaseStreamRetentionPeriod和DecreaseStreamRetentionPeriod操作来更新保留期。利用 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 定价