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

87 lines
2.8 KiB
Markdown
Raw Normal View History

---
toc_priority: 44
toc_title: TTL
---
# Манипуляции с TTL таблицы {#manipuliatsii-s-ttl-tablitsy}
2020-12-17 08:02:46 +00:00
## MODIFY TTL {#modify-ttl}
Вы можете изменить [TTL для таблицы](../../../engines/table-engines/mergetree-family/mergetree.md#mergetree-column-ttl) запросом следующего вида:
``` sql
ALTER TABLE table-name MODIFY TTL ttl-expression
```
2020-12-24 19:45:19 +00:00
## REMOVE TTL {#remove-ttl}
2020-12-17 08:02:46 +00:00
2021-01-12 09:00:31 +00:00
Удалить табличный TTL можно запросом следующего вида:
2020-12-17 08:02:46 +00:00
```sql
2021-01-12 09:00:31 +00:00
ALTER TABLE table_name REMOVE TTL
2020-12-17 08:02:46 +00:00
```
**Пример**
2021-01-12 09:00:31 +00:00
Создадим таблицу с табличным `TTL` и заполним её данными:
```sql
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');
```
2021-01-12 09:00:31 +00:00
Выполним `OPTIMIZE` для принудительной очистки по `TTL`:
2020-12-17 08:02:46 +00:00
```sql
OPTIMIZE TABLE table_with_ttl FINAL;
2021-01-12 09:00:31 +00:00
SELECT * FROM table_with_ttl;
2020-12-17 08:02:46 +00:00
```
В результате видно, что вторая строка удалена.
```text
┌─────────event_time────┬──UserID─┬─────Comment──┐
│ 2020-12-11 12:44:57 │ 1 │ username1 │
└───────────────────────┴─────────┴──────────────┘
2020-12-17 08:02:46 +00:00
```
2021-01-12 09:00:31 +00:00
Удаляем табличный `TTL`:
2020-12-17 08:02:46 +00:00
```sql
ALTER TABLE table_with_ttl REMOVE TTL;
2021-01-12 09:00:31 +00:00
```
Заново вставляем удаленную строку и снова принудительно запускаем очистку по `TTL` с помощью `OPTIMIZE`:
```sql
2020-12-17 08:02:46 +00:00
INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'username2');
OPTIMIZE TABLE table_with_ttl FINAL;
2021-01-12 09:00:31 +00:00
SELECT * FROM table_with_ttl;
2020-12-17 08:02:46 +00:00
```
2021-01-12 09:00:31 +00:00
`TTL` больше нет, поэтому данные не удаляются:
2020-12-17 08:02:46 +00:00
```text
┌─────────event_time────┬──UserID─┬─────Comment──┐
│ 2020-12-11 12:44:57 │ 1 │ username1 │
│ 2020-08-11 12:44:57 │ 2 │ username2 │
└───────────────────────┴─────────┴──────────────┘
2020-12-17 08:02:46 +00:00
```
### Смотрите также
- Подробнее о [свойстве TTL](../../../engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl).
2021-01-12 09:00:31 +00:00
[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/ttl/) <!--hide-->