PolarDB:TTL の使用ガイド

TTL を指定してテーブルを作成する

以下のいずれかの方法で、TTL を指定したテーブルを作成できます。

t1 という名前のテーブルを作成し、データの作成時間を表す TTL タイムスタンプ列として created_at を指定します。 created_at の生存時間 (TTL) の値を設定して、データの削除をコントロールします。

• created_at の最大 TTL を 100 秒に設定します。

  CREATE TABLE `t1` (
    `a` INT PRIMARY KEY,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    KEY idx_created_at (`created_at`)
  )ENGINE=InnoDB  TTL='created_at@100';

  説明

  TTL='created_at@100' の設定は、テーブル内の行が 100 秒後に有効期限切れになることを意味します。期限切れデータは、後続のクリーンアッププロセスで削除されます。

• created_at の最大 TTL を 3 時間に設定します。

  CREATE TABLE `t1` (
    `a` INT PRIMARY KEY,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    KEY idx_created_at (`created_at`)
  )ENGINE=InnoDB  TTL='created_at' + INTERVAL 3 HOUR;

  説明

  • TTL ='created_at'+ INTERVAL 3 HOUR の設定は、3 時間の TTL を構成します。3 時間以上経過したデータは自動的に削除されます。

  • この TTL（生存時間）構文では、YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE、SECOND の複数の時間単位がサポートされています。データ管理のニーズに最も適した単位を選択してください。

テーブルの TTL を変更する

以下のいずれかの方法で、テーブルの TTL プロパティを変更できます。

t1 テーブルの TTL を、created_at カラムの生存時間（TTL）値を調整することで変更します。

• created_at の最大 TTL を 10,000 秒に設定します。

  ALTER TABLE `t1` TTL='created_at@10000';

  説明

  created_at カラムに TTL を 10,000 秒に設定すると、データは作成後 10,000 秒経過時点で削除されます。

• created_at の最大 TTL を 3 日間に設定します。

  ALTER TABLE `t1` TTL='created_at' + INTERVAL 3 DAY;

  説明

  created_at タイムスタンプに 3 日間を加算すると、有効期限が 3 日後に設定されます。3 日以上経過したデータは自動的に削除されます。

テーブルから TTL を削除する

ALTER TABLE t1 TTL = '';

テーブルの TTL 設定を照会する

SHOW CREATE TABLE `t1` FULL;

CREATE TABLE `t1` (  
`a` INT PRIMARY KEY,  
`created_at` TIMESTAMP DEFAULT 
CURRENT_TIMESTAMP,  
 KEY idx_created_at (`created_at`)
)ENGINE=InnoDB  TTL='created_at@259200';