記錄資料表的過期時間

根據預設，S3 資料表中的記錄不會過期。為了協助將資料表的儲存成本降至最低，您可以啟用和設定資料表的記錄過期時間。使用此選項時，Amazon S3 會在記錄過期時自動從資料表中移除記錄。

如果您啟用資料表的記錄過期，請在記錄過期之前，指定要在資料表中保留記錄的天數。這可以是從 1 天到 2，147，483，647 天的任何天數。例如，若要保留資料表記錄一年，請指定365天數。然後，記錄會保留 365 天。365 天後，記錄會過期，Amazon S3 會自動將其移除。

您可以為存放特定 AWS 服務目前 Amazon S3 Storage Lens 和 Amazon SageMaker Catalog 特定資料集的 AWS 受管資料表啟用和設定記錄過期。記錄過期選項目前不適用於其他 AWS 受管資料表。例外是 Amazon S3 中繼資料日誌資料表。日誌資料表使用您在服務層級指定的不同記錄過期設定。如需為此類資料表設定記錄過期的資訊，請參閱 到期的日誌資料表記錄。請注意，記錄過期選項不適用於您建立的 S3 資料表。

啟用資料表的記錄過期後，您可以隨時將其停用。然後，Amazon S3 會停止過期並從資料表中移除記錄。

記錄過期的運作方式

當記錄早於您在資料表的記錄過期設定中指定的天數時，記錄過期會自動從 S3 資料表中移除記錄。為了判斷記錄何時過期，Amazon S3 會使用記錄中的特定時間戳記。時間戳記資料欄的選擇直接衍生自資料表的資料表結構描述。您不需要指定要使用的時間戳記欄。資料表由 管理， AWS 而當您啟用資料表的記錄過期時，Amazon S3 會自動選擇要使用的適當資料欄。

您可以為存放特定 Amazon S3 Storage Lens 指標或特定 Amazon SageMaker Catalog 中繼資料的 AWS 受管資料表啟用和設定記錄過期設定。記錄過期選項適用於這些服務的下列 AWS 受管資料表：

啟用資料表的記錄過期後，Amazon S3 會開始執行記錄過期任務，以對資料表執行下列操作：

移除也基於資料表維護組態設定中的快照過期和未參考的檔案移除設定。若要進一步了解這些設定，請參閱 資料表的維護。

設定資料表的記錄過期

您可以使用 Amazon S3 主控台、Amazon S3 REST API、 AWS Command Line Interface (AWS CLI) 或 AWS SDKs 來啟用、設定和以其他方式管理 SAmazon S3 資料表的記錄過期設定。 Amazon S3

在您嘗試對資料表執行這些任務之前，請確定您具有下列 AWS Identity and Access Management (IAM) 許可：

下列各節說明如何使用 Amazon S3 主控台和 來啟用、設定和停用資料表的記錄過期設定 AWS CLI。若要使用 Amazon S3 REST API 或 AWS SDK 執行這些任務，請使用 PutTableRecordExpirationConfiguration操作。如需詳細資訊，請參閱《Amazon Simple Storage Service API 參考》中的使用 Amazon S3 進行開發。

{
    "status": "enabled",
        "settings": {
            "days": 30
        {
}

{
    "status": "disabled"
}

aws s3tables put-table-record-expiration-configuration \
    --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table \
    --value file://./record-expiration-config.json

監控資料表的記錄過期

若要監控 S3 資料表的記錄過期操作的狀態和結果，請使用 GetTableRecordExpirationJobStatus操作，或者，如果您使用的是 AWS CLI，請執行 get-table-record-expiration-job-status命令。在您的請求中，指定資料表的 Amazon Resource Name (ARN)。

例如，下列 AWS CLI 命令會擷取資料表儲存貯體中特定資料表的記錄過期操作狀態。若要使用此範例，請以您自己的資訊取代 user input placeholders。

aws s3tables get-table-record-expiration-job-status \
    --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table

如果您的請求成功，您會收到回應，提供詳細資訊，例如 Amazon S3 最近何時執行資料表的記錄過期操作，以及該執行的狀態。如果最近執行成功，回應也包含處理指標，例如，移除的資料檔案和記錄數目，以及移除的資料總大小。如果在最近一次執行期間發生錯誤，回應會包含失敗訊息，說明執行失敗的原因。

考量事項

當您設定和管理 AWS 受管 S3 資料表的記錄過期設定時，請記住下列事項：