Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Настройки таблиц семейства MergeTree allow_*

Эти настройки доступны в system.merge_tree_settings и автоматически генерируются на основе исходного кода ClickHouse.

allow_coalescing_columns_in_partition_or_order_key

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.60Новая настройка, позволяющая использовать коалесцируемые столбцы в партиции или ключе сортировки.

Если параметр включен, коалесцируемые столбцы в таблице CoalescingMergeTree можно использовать в партиции или ключе сортировки.

allow_commit_order_projection

Экспериментальная возможность
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.40новая настройка

Включает проекции, сохраняющие порядок коммита: они хранят виртуальные столбцы _block_number и _block_offset, что позволяет сохранять исходный порядок вставки при слияниях. Требует включения enable_block_number_column и enable_block_offset_column.

allow_dimensions_outside_sorting_key

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.70Теперь AggregatingMergeTree отклоняет при создании таблицы схемы, в которых столбец не входит ни в ключ сортировки, ни в меру — состояние агрегатной функции; ранее такие схемы допускались (старое поведение соответствует значению 'true').

В AggregatingMergeTree фоновые слияния схлопывают строки с одинаковым значением ключа сортировки, объединяя их состояния агрегатной функции. Столбец, который не входит ни в ключ сортировки, ни в меру — состояние агрегатной функции (AggregateFunction или SimpleAggregateFunction), считается измерением: после слияния в нём сохраняется произвольное значение из одной из схлопнутых строк, что незаметно приводит к неверным результатам в запросах, которые используют GROUP BY или фильтрацию по этому столбцу (см. https://github.com/ClickHouse/ClickHouse/issues/751).

По умолчанию такая схема отклоняется при создании таблицы. Включите этот параметр, если столбец функционально зависит от ключа сортировки (то есть все схлопнутые строки имеют одно и то же значение) и такое поведение является намеренным.

Проверка применяется только к таблицам, которые действительно агрегируют данные (то есть имеют хотя бы один столбец с состоянием агрегатной функции), и пропускается, если включён allow_tuple_element_aggregation.

allow_floating_point_partition_key

Тип
Bool
По умолчанию
0

Разрешает использовать число с плавающей запятой в качестве ключа партиционирования.

Возможные значения:

  • 0 — Использование ключа партиционирования с плавающей запятой запрещено.
  • 1 — Использование ключа партиционирования с плавающей запятой разрешено.

allow_minmax_index_for_json

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.70По умолчанию запрещает создание индекса пропуска данных minmax для JSON-столбцов, поскольку сериализация индекса не может обрабатывать неоднородные значения Field

Разрешает создавать индексы пропуска данных minmax для JSON-столбцов (Object). По умолчанию отключено, поскольку сериализация индекса minmax не может обрабатывать неоднородные значения Field, которые могут содержаться в JSON-столбцах.

allow_nullable_key

Тип
Bool
По умолчанию
0

Разрешает использовать типы Nullable в качестве первичных ключей.

allow_part_offset_column_in_projections

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.81Теперь в проекциях можно использовать столбец _part_offset.
25.50Новая настройка: до стабилизации она предотвращает создание проекций со столбцом смещения родительской части.

Разрешает использовать столбец '_part_offset' в SELECT-запросе проекций.

allow_reduce_blocking_parts_task

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.21Теперь SMT по умолчанию удаляет устаревшие блокирующие части из ZooKeeper
25.10Синхронизация с Cloud

Фоновая задача, сокращающая количество блокирующих частей для таблиц shared merge tree. Только в ClickHouse Cloud

allow_remote_fs_zero_copy_replication

Экспериментальная возможность
Тип
Bool
По умолчанию
0

Не используйте эту настройку в продакшне, так как она ещё не готова.

allow_summing_columns_in_partition_or_order_key

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
25.40Новая настройка, позволяющая использовать суммируемые столбцы партиции или ключа сортировки

При включении позволяет использовать суммируемые столбцы в таблице SummingMergeTree в партиции или ключе сортировки.

allow_suspicious_indices

Тип
Bool
По умолчанию
0

Отклонять первичные/вторичные индексы и ключи сортировки с одинаковыми выражениями

allow_tuple_element_aggregation

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.60новая настройка

Если настройка включена, отдельные элементы в столбцах Tuple участвуют в агрегации при merge в SummingMergeTree, AggregatingMergeTree и CoalescingMergeTree. Вложенные Tuple рекурсивно разворачиваются, так что все конечные элементы агрегируются независимо. Эта настройка неизменяема и должна быть указана при создании таблицы.

allow_vertical_merges_from_compact_to_wide_parts

Тип
Bool
По умолчанию
1

Разрешает вертикальные слияния из compact-частей в части Wide. Этот параметр должен иметь одинаковое значение на всех репликах.

Navigation