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');

Выполните 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;

Повторно вставьте удалённую строку и принудительно запустите очистку TTL с помощью OPTIMIZE:

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

См. также

Navigation