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

# 记录的生存时间 (TTL) 持续时间
<a name="feature-store-time-to-live"></a>

A SageMaker mazon Feature Store 提供了在达到存活时间 (TTL) 时长 () 后从在线商店硬删除记录的选项。`TtlDuration`该记录将在达到记录的 `EventTime` 加上 `TtlDuration` 或者 `ExpiresAt` = `EventTime` \$1 `TtlDuration` 后过期。可以在特征组级别应用 `TtlDuration`（此时，特征组中的所有记录默认情况下都将拥有 `TtlDuration`），也可以在单个记录级别应用。如果 `TtlDuration` 未指定，则默认值为 `null`，记录将保留在在线存储中，直到被覆盖。

使用 `TtlDuration` 删除的记录会被硬删除或完全从在线存储中删除，删除的记录将添加到离线存储中。有关硬删除和删除模式的更多信息，请参阅 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_DeleteRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_DeleteRecord.html)Amazon SageMaker API 参考指南。当记录被硬删除时，该记录会立即无法使用功能商店 APIs进行访问。

**重要**  
TTL 通常会在几天内删除过期的项目。根据表的大小和活动性级别，过期项目的实际删除操作可能会有所不同。由于 TTL 注定是一个后台流程，因此，用于通过 TTL 过期和删除项目的容量实质上是可变的（但是免费的）。有关如何从 DynamoDB 表中删除项目的更多信息，请参阅[工作方式：DynamoDB 生存时间 (TTL)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/howitworks-ttl.html)。

`TtlDuration`必须是包含 a `Unit` 和 a 的字典`Value`，其中`Unit`必须是值为 “秒”、“分钟”、“小时”、“天” 或 “周” 的字符串，并且`Value`必须是大于或等于 1 的整数。 `TtlDuration`可以在使用`CreateFeatureGroup``UpdateFeatureGroup`、和时应用`PutRecord` APIs。有关、和，请参阅 Python 开发工具包 (Boto3) 文档中的请求和响应语法。[https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/create_feature_group.html#SageMaker.Client.create_feature_group](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/create_feature_group.html#SageMaker.Client.create_feature_group) APIs
+ 在功能组级别（使用`CreateFeatureGroup`或 `UpdateFeatureGroup` APIs）应用时`TtlDuration`，应用的`TtlDuration`将成为自*调用 API 之时起添加到要素组的所有记录的*默认值`TtlDuration`。使用 `UpdateFeatureGroup` API 应用 `TtlDuration` 时，这*不会* 成为调用 API *之前* 创建的记录的默认 `TtlDuration`。

  要从现有特征组中移除默认 `TtlDuration`，请使用 `UpdateFeatureGroup` API 并将 `TtlDuration` `Unit` 和 `Value` 设置为 `null`。
+ 在记录级别应用 `TtlDuration`（例如，使用 `PutRecord` API）时，`TtlDuration` 持续时间将应用于该记录，并取代特征组级别的默认 `TtlDuration`。
+ 在特征组级别应用 `TtlDuration` 时，可能需要几分钟才能使 `TtlDuration` 生效。
+ 如果在没有在线存储的情况下使用 `TtlDuration`，则会收到 `Validation Exception (400)` 错误消息。

以下示例代码显示了如何在更新特征组时应用 `TtlDuration`，这样，*在运行 API 后* 添加到该特征组的记录默认情况下将在其事件时间的四周后过期。

```
import boto3

sagemaker_client = boto3.client("sagemaker")
feature_group_name = '<YOUR_FEATURE_GROUP_NAME>'

sagemaker_client.update_feature_group(
    FeatureGroupName=feature_group_name,
    OnlineStoreConfig={
        TtlDuration:{
            Unit: "Weeks",
            Value: 4
        }
    }
)
```

您可以使用 `DescribeFeatureGroup` API 查看默认 `TtlDuration`。

要在使用`GetRecord`或`BatchGetRecord` APIs 时查看到期时间`ExpiresAt`（UTC 时间 ISO-8601 格式），必须`ExpirationTimeResponse`将`ENABLED`设置为。有关、和，请参阅 Python 开发工具包 (Boto3) 文档中的请求和响应语法。[https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/describe_feature_group.html#describe-feature-group](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/describe_feature_group.html#describe-feature-group) APIs