2020-08-25 15:38:36 +00:00
|
|
|
|
---
|
|
|
|
|
toc_priority: 44
|
|
|
|
|
toc_title: TTL
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Манипуляции с TTL таблицы {#manipuliatsii-s-ttl-tablitsy}
|
|
|
|
|
|
2020-12-17 08:02:46 +00:00
|
|
|
|
## MODIFY TTL {#modify-ttl}
|
|
|
|
|
|
2020-08-25 15:38:36 +00:00
|
|
|
|
Вы можете изменить [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` и заполним её данными:
|
2020-12-29 23:24:41 +00:00
|
|
|
|
|
|
|
|
|
```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
|
2020-12-29 23:24:41 +00:00
|
|
|
|
┌─────────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
|
2020-12-29 23:24:41 +00:00
|
|
|
|
┌─────────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-->
|