テーブル TTL の操作

注記

古いデータの管理に関する TTL の使用方法の詳細を探している場合は、TTL でデータを管理するユーザーガイドをご覧ください。以下のドキュメントでは、既存の TTL ルールを変更または削除する方法を示します。

TTL を変更する

次の形式のリクエストでテーブル TTL を変更できます。

ALTER TABLE [db.]table_name [ON CLUSTER cluster] MODIFY TTL ttl_expression;

TTL を削除する

TTL プロパティは、次のクエリを使用してテーブルから削除できます。

ALTER TABLE [db.]table_name [ON CLUSTER cluster] REMOVE TTL

例

テーブル TTL を考慮してください：

CREATE TABLE table_with_ttl
(
    event_time DateTime,
    UserID UInt64,
    Comment String
)
ENGINE MergeTree()
ORDER BY tuple()
TTL event_time + INTERVAL 3 MONTH
SETTINGS min_bytes_for_wide_part = 0;

INSERT INTO table_with_ttl VALUES (now(), 1, 'username1');

INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'username2');

OPTIMIZE を実行して TTL クリーンアップを強制します：

OPTIMIZE TABLE table_with_ttl FINAL;
SELECT * FROM table_with_ttl FORMAT PrettyCompact;

2 行目がテーブルから削除されました。

┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
└───────────────────────┴─────────┴──────────────┘

次に、次のクエリを使用してテーブルの TTL を削除します：

ALTER TABLE table_with_ttl REMOVE TTL;

削除した行を再挿入し、再び OPTIMIZE で TTL クリーンアップを強制します：

INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'username2');
OPTIMIZE TABLE table_with_ttl FINAL;
SELECT * FROM table_with_ttl FORMAT PrettyCompact;

TTL はもはや存在しないため、2 行目は削除されません：

┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
│   2020-08-11 12:44:57 │       2 │    username2 │
└───────────────────────┴─────────┴──────────────┘

関連情報

TTL 表現の詳細。
TTL 付きのカラムを変更する。

TTL を変更する​

TTL を削除する​

TTL を変更する

TTL を削除する