ALTER TABLE ... MODIFY TTL | ClickHouse Docs

修改生存时间 (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;

表中的第二行已被删除。

┌─────────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 已被移除，因此第二行不会被删除：

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

另请参阅

更多信息请参见生存时间 (TTL) 表达式。
使用生存时间 (TTL) 修改列。