翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# レコードの有効期限 (TTL)
<a name="feature-store-time-to-live"></a>

Amazon SageMaker Feature Store には、有効期限 (TTL) (`TtlDuration`) を使用して、有効期限に達した後にレコードをオンラインストアから完全に削除するオプションがあります。レコードは、レコードの `EventTime` に `TtlDuration` を加えた値、つまり `ExpiresAt` = `EventTime` \$1 `TtlDuration` に達すると期限切れになります。`TtlDuration` は、特徴量グループレベルで適用して、デフォルトで特徴量グループ内のすべてのレコードに `TtlDuration` が設定されるようにすることも、個別のレコードレベルで適用することもできます。`TtlDuration` を指定しない場合、デフォルト値は `null` となり、レコードは上書きされるまでオンラインストアに残ります。

`TtlDuration` を使用して削除されたレコードは、完全に削除されるかオンラインストアから完全に削除され、削除されたレコードはオフラインストアに追加されます。完全削除と削除モードの詳細については、「Amazon SageMaker API リファレンスガイド」の「[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)」を参照してください。レコードがハード削除されると、直ちに 特徴量ストア API でのアクセスができなくなります。

**重要**  
通常、TTL は期限が切れた項目を数日以内に削除します。テーブルのサイズとアクティビティレベルによっては、期限切れの項目の実際の削除オペレーションが異なる場合があります。TTL はバックグラウンドプロセスであることを意図しているため、TTL を介して項目の有効期限切れや削除に使用される容量の性質は可変です (無料)。DynamoDB テーブルから項目を削除する方法の詳細については、「[仕組み: DynamoDB の有効期限 (TTL)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/howitworks-ttl.html)」を参照してください。

`TtlDuration` は `Unit` と `Value` を含む辞書である必要があり、`Unit` は、値「秒」、「分」、「時間」、「日」、または「週」を持つ文字列でなければならず、`Value` は 1 以上の整数である必要があります。`TtlDuration` は `CreateFeatureGroup`、`UpdateFeatureGroup`、`PutRecord` API を使用するときに適用できます。[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)、[https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/update_feature_group.html](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/update_feature_group.html)、[https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-featurestore-runtime/client/put_record.html#](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-featurestore-runtime/client/put_record.html#) API については、「SDK for Python (Boto3) documentation」でリクエストとレスポンスの構文を参照してください。
+ `TtlDuration` を (`CreateFeatureGroup` または `UpdateFeatureGroup` API を使用して) 特徴量グループレベルで適用すると、適用された `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 の実行後に特徴量グループに追加されたレコードは、デフォルトでイベント時間の 4 週間後に期限切れになります。**

```
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` API を使用しているときに有効期限 `ExpiresAt` を (UTC 時間 ISO-8601 形式で) 表示するには、`ExpirationTimeResponse` を `ENABLED` に設定する必要があります。[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)、[https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-featurestore-runtime/client/get_record.html#get-record](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-featurestore-runtime/client/get_record.html#get-record)、[https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-featurestore-runtime/client/batch_get_record.html#batch-get-record](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-featurestore-runtime/client/batch_get_record.html#batch-get-record) API については、「SDK for Python (Boto3) documentation」でリクエストとレスポンスの構文を参照してください。