テーブルのデフォルトの有効期限 (TTL) 値を更新する - Amazon Keyspaces (Apache Cassandra 向け)

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

テーブルのデフォルトの有効期限 (TTL) 値を更新する

既存のテーブルを新しいTTLデフォルト値で更新できます。TTL 値は秒単位で設定され、設定可能な最大値は 630,720,000 秒です。これは 20 年に相当するものです。

テーブルTTLで を有効にすると、Amazon Keyspaces は行ごとに追加の TTL関連メタデータの保存を開始します。さらに、 TTLは有効期限タイムスタンプを使用して、行または列の有効期限を追跡します。タイムスタンプは、行メタデータとして保存されるため、行のストレージコストに関係します。

TTL がテーブルに対して有効になったら、特定の行または列のテーブルのTTLデフォルト設定を CQLDMLステートメントで上書きできます。詳細については、「INSERT ステートメントを使用して、新しい行のカスタム有効期限 (TTL) 値を設定します。」および「UPDATE ステートメントを使用して、行と列のカスタム有効期限 (TTL) 設定を編集する」を参照してください。

TTL この機能を有効にすると、テーブルに対して無効にすることはできません。テーブルの を 0 default_time_to_liveに設定すると、新しいデータのデフォルトの有効期限は無効になりますが、TTLこの機能を無効にしたり、テーブルを元の Amazon Keyspaces ストレージメタデータに戻したり、書き込み動作に戻したりすることはありません。

コンソール、、CQLまたは を使用して、既存のテーブルのデフォルトの有効期限設定を更新するには、次の手順に従います。 AWS CLI.

Console
コンソールを使用してテーブルのTTLデフォルト値を更新する

  1. にサインインする AWS Management Console、ホーム で Amazon Keyspaces https://console.aws.amazon.com/keyspaces/コンソールを開きます。

  2. 更新するテーブルを選択し、次に [Additional settings (追加設定)] タブを選択します。

  3. 有効期限 (TTL) に進み、編集 を選択します。

  4. デフォルトTTL期間 には、有効期限を入力し、秒、日、年などの時間単位を選択します。Amazon Keyspaces では、値が秒単位で保存されます。これにより、既存の行のTTL値は変更されません。

  5. TTL 設定が定義されたら、変更の保存 を選択します。

Cassandra Query Language (CQL)
を使用してテーブルのTTLデフォルト値を更新する CQL

  1. を使用してALTER TABLE、テーブルのデフォルトの有効期限 (TTL) 設定を編集できます。テーブルのTTLデフォルト設定を 30 日を表す 2,592,000 秒に更新するには、次のステートメントを使用できます。

    ALTER TABLE my_table WITH default_time_to_live = 2592000;

  2. 更新されたテーブルTTLの設定を確認するには、次の例に示すように cqlshDESCRIBEステートメントを使用します。出力には、テーブルのTTLデフォルト設定が として表示されますdefault_time_to_live。

    DESC TABLE my_table;

    ステートメントの出力はこの例のようになります。

    CREATE TABLE my_keyspace.my_table (
    id int PRIMARY KEY,
    date timestamp,
    name text
) WITH bloom_filter_fp_chance = 0.01
    AND caching = {'class': 'com.amazonaws.cassandra.DefaultCaching'}
    AND comment = ''
    AND compaction = {'class': 'com.amazonaws.cassandra.DefaultCompaction'}
    AND compression = {'class': 'com.amazonaws.cassandra.DefaultCompression'}
    AND crc_check_chance = 1.0
    AND dclocal_read_repair_chance = 0.0
    AND default_time_to_live = 2592000
    AND gc_grace_seconds = 7776000
    AND max_index_interval = 2048
    AND memtable_flush_period_in_ms = 3600000
    AND min_index_interval = 128
    AND read_repair_chance = 0.0
    AND speculative_retry = '99PERCENTILE';
CLI
を使用してテーブルのTTLデフォルト値を更新する AWS CLI

  1. を使用してupdate-table、テーブルのTTLデフォルト値を編集できます。テーブルのTTLデフォルト設定を 30 日を表す 2,592,000 秒に更新するには、次のステートメントを使用できます。

    aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --default-time-to-live '2592000'

  2. 更新されたTTLデフォルト値を確認するには、次のステートメントを使用できます。

    aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'

    ステートメントの出力は次の例のようになります。

    {
    "keyspaceName": "myKeyspace",
    "tableName": "myTable",
    "resourceArn": "arn:aws:cassandra:us-east-1:123SAMPLE012:/keyspace/myKeyspace/table/myTable",
    "creationTimestamp": "2024-09-02T10:52:22.190000+00:00",
    "status": "ACTIVE",
    "schemaDefinition": {
        "allColumns": [
            {
                "name": "id",
                "type": "int"
            },
            {
                "name": "date",
                "type": "timestamp"
            },
            {
                "name": "name",
                "type": "text"
            }
        ],
        "partitionKeys": [
            {
                "name": "id"
            }
        ],
        "clusteringKeys": [],
        "staticColumns": []
    },
    "capacitySpecification": {
        "throughputMode": "PAY_PER_REQUEST",
        "lastUpdateToPayPerRequestTimestamp": "2024-09-02T10:52:22.190000+00:00"
    },
    "encryptionSpecification": {
        "type": "AWS_OWNED_KMS_KEY"
    },
    "pointInTimeRecovery": {
        "status": "DISABLED"
    },
    "ttl": {
        "status": "ENABLED"
    },
    "defaultTimeToLive": 2592000,
    "comment": {
        "message": ""
    },
    "replicaSpecifications": []
}