ClickHouse/docs/ru/sql-reference/statements/alter/ttl.md

slug	sidebar_position	sidebar_label
/ru/sql-reference/statements/alter/ttl	44	TTL

Манипуляции с TTL таблицы

MODIFY TTL

Вы можете изменить TTL для таблицы запросом следующего вида:

ALTER TABLE [db.]table-name [ON CLUSTER cluster] MODIFY TTL ttl-expression

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

В результате видно, что вторая строка удалена.

┌─────────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;

TTL больше нет, поэтому данные не удаляются:

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

Смотрите также

• Подробнее о свойстве TTL.
• Изменить столбец с TTL.