コンソールにサインインする
Amazon DynamoDB
開発者ガイド (API バージョン 2012-08-10)

AWS ドキュメント » Amazon DynamoDB » 開発者ガイド » DynamoDB の操作 » DynamoDB での項目の操作 » Time To Live » Time To Live の有効化

Time To Live の有効化

このセクションでは、DynamoDB コンソールまたは CLI を使用して Time To Live を有効にする方法について説明します。代わりに API を使用する場合は、「Amazon DynamoDB API Reference」を参照してください。

Time To Live の有効化 (コンソール)

DynamoDB コンソールを使用して Time To Live を有効にするには:

  1. https://console.aws.amazon.com/dynamodb/home にある DynamoDB コンソールを開きます。

  2. [Tables] を選択し、変更するテーブルを選択します。

  3. [Table details] で、[TTL attribute] の横にある [Manage TTL] を選択します。

  4. [Manage TTL] ダイアログボックスで、[Enable TTL] を選択してから [TTL attribute] の名前を入力します。

    [Manage TTL] には 3 つの設定があります。

    • [Enable TTL] – テーブルで TTL を有効または無効にするには、これを選択します。変更が完全に処理されるまでに最大で 1 時間かかる場合があります。

    • [TTL Attribute] – 項目の TTL タイムスタンプを保存する DynamoDB 属性の名前。

    • [24-hour backup streams] – テーブルで DynamoDB ストリーム を有効にするには、これを選択します。バックアップのために DynamoDB ストリーム を使用できる方法の詳細については、「DynamoDB ストリーム と Time To Live」を参照してください。

  5. (オプション) TTL を有効化するときに削除される項目のいくつかをプレビューするには、[Run preview] を選択します。

    警告

    これにより、項目のサンプルリストが表示されます。TTL によって削除される項目の完全なリストは表示されません。

  6. [Continue] を選択して設定を保存し、TTL を有効にします。

これで TTL を有効にしたので、DynamoDB コンソールで項目を表示すると、TTL 属性は TTL とマークされます。

属性の上にマウスカーソルを合わせると、項目が期限切れになる日時を表示できます。

Time To Live の有効化 (CLI)

[TTLExample] テーブルで TTL を有効にするには: 

aws dynamodb update-time-to-live --table-name TTLExample --time-to-live-specification "Enabled=true, AttributeName=ttl"

[TTLExample] テーブルで TTL を記述するには: 

aws dynamodb describe-time-to-live --table-name TTLExample
{
    "TimeToLiveDescription": {
        "AttributeName": "ttl", 
        "TimeToLiveStatus": "ENABLED"
    }
}

BASH シェルおよび CLI を使用して Time To Live 属性が設定された項目を [TTLExample] テーブルに追加するには: 

EXP=`date -d '+5 days' +%s`
aws dynamodb put-item --table-name "TTLExample" --item '{"id": {"N": "1"}, "ttl": {"N": "'$EXP'"}}'

この例では、現在の日付から開始し、有効期限を作成するために 5 日を追加します。次に、有効期限をエポック時間形式に変換してから、最後に項目を [TTLExample] テーブルに追加します。

注記

Time To Live の有効期限の値を設定する 1 つの方法は、有効期限に追加する秒数を計算することです。たとえば、5 日は 432000 秒です。ただし、多くの場合は最初に日付で開始し、そこから作業を開始することをお勧めします。

現在の時間をエポック時間形式で取得するのは非常に簡単です。以下に例を示します。

  • Linux ターミナル: date +%s

  • Python: import time; long(time.time())

  • Java: System.currentTimeMillis() / 1000L

  • JavaScript: Math.floor(Date.now() / 1000)