跳至主要内容

表 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;

第二行已从表中删除。

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

另请参阅