diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md index 5e886470d99..4995c04f712 100644 --- a/docs/en/operations/settings/settings.md +++ b/docs/en/operations/settings/settings.md @@ -1864,6 +1864,28 @@ Default value: `0`. - [Synchronicity of ALTER Queries](../../sql-reference/statements/alter/index.md#synchronicity-of-alter-queries) - [Mutations](../../sql-reference/statements/alter/index.md#mutations) +## ttl_only_drop_parts {#ttl_only_drop_parts} + +Enables or disables complete dropping of data parts where all rows are expired in [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) tables. + +When `ttl_only_drop_parts` is disabled (by default), the ClickHouse server only deletes expired rows according to their TTL. + +When `ttl_only_drop_parts` is enabled, the ClickHouse server drops a whole part when all rows in it are expired. + +Dropping whole parts instead of partial cleaning TTL-d rows allows to have shorter `merge_with_ttl_timeout` times and lower impact on system performance. + +Possible values: + +- 0 — Complete dropping of data parts is disabled. +- 1 — Complete dropping of data parts is enabled. + +Default value: `0`. + +**See Also** + +- [CREATE TABLE query clauses and settings](../../engines/table-engines/mergetree-family/mergetree.md#mergetree-query-clauses) (`merge_with_ttl_timeout` setting) +- [Table TTL](../../engines/table-engines/mergetree-family/mergetree.md#mergetree-table-ttl) + ## lock_acquire_timeout {#lock_acquire_timeout} Defines how many seconds locking request waits before failing. diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md index e8d3f1057df..62c40c90540 100644 --- a/docs/ru/operations/settings/settings.md +++ b/docs/ru/operations/settings/settings.md @@ -1621,5 +1621,26 @@ SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1; - [Синхронность запросов ALTER](../../sql-reference/statements/alter/index.md#synchronicity-of-alter-queries) - [Мутации](../../sql-reference/statements/alter/index.md#mutations) +## ttl_only_drop_parts {#ttl_only_drop_parts} + +Для таблиц [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) включает или отключает возможность полного удаления кусков данных, в которых все записи устарели. + +Когда настройка `ttl_only_drop_parts` отключена (т.е. по умолчанию), сервер лишь удаляет устаревшие записи в соответствии с их временем жизни (TTL). + +Когда настройка `ttl_only_drop_parts` включена, сервер целиком удаляет куски данных, в которых все записи устарели. + +Удаление целых кусков данных вместо удаления отдельных записей позволяет устанавливать меньший таймаут `merge_with_ttl_timeout` и уменьшает нагрузку на сервер, что способствует росту производительности. + +Возможные значения: + +- 0 — Возможность удаления целых кусков данных отключена. +- 1 — Возможность удаления целых кусков данных включена. + +Значение по умолчанию: `0`. + +**См. также** + +- [Секции и настройки запроса CREATE TABLE](../../engines/table-engines/mergetree-family/mergetree.md#mergetree-query-clauses) (настройка `merge_with_ttl_timeout`) +- [Table TTL](../../engines/table-engines/mergetree-family/mergetree.md#mergetree-table-ttl) [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/settings/settings/)