Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

ALTER TABLE ... MODIFY TTL

View as MarkdownEdit this pageReport an issueSet up docs MCP

有効期限 (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');

有効期限 (TTL) のクリーンアップを強制するには、OPTIMIZE を実行します。

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 │
└───────────────────────┴─────────┴──────────────┘

関連項目

Navigation