Перейти к основному содержанию
Перейти к основному содержанию

Операции с TTL таблицы

Примечание

Если вам нужны подробные сведения об использовании TTL для управления старыми данными, ознакомьтесь с руководством Управление данными с помощью TTL. В приведённом ниже материале показано, как изменить или удалить существующее правило TTL.

ИЗМЕНЕНИЕ TTL​

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

ALTER TABLE [db.]имя_таблицы [ON CLUSTER кластер] MODIFY TTL ttl_выражение;

УДАЛЕНИЕ TTL​

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

ALTER TABLE [db.]имя_таблицы [ON 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, 'имя_пользователя1');

INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'имя_пользователя2');

Выполните 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 │
└───────────────────────┴─────────┴──────────────┘

См. также