變更資料保留期

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操作來檢查流的當前保留期。

以下是使用 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 定價。