Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

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

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

text_index_dictionary_block_frontcoding_compression

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

Сжатие front-coding по умолчанию для блоков словаря текстового индекса. Можно переопределить явным аргументом индекса dictionary_block_frontcoding_compression.

text_index_dictionary_block_size

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

Размер блока словаря по умолчанию для текстовых индексов. Может быть переопределён явно заданным аргументом индекса dictionary_block_size.

text_index_max_memory_usage_before_flush

Тип
NonZeroUInt64
По умолчанию
1073741824
История версий
ВерсияЗначение по умолчаниюКомментарий
26.81073741824Новая настройка. Предыдущее значение отключает сброс по объёму памяти, сохраняя поведение до версии 26.8

Максимальный оценочный объём памяти, удерживаемый построителем текстового индекса перед сбросом временного сегмента.

text_index_max_processed_tokens_before_flush

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

Максимальное количество обработанных токенов, накопленных построителем текстового индекса до сброса временного сегмента.

text_index_posting_list_block_size

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

Размер блока списка вхождений по умолчанию для текстовых индексов (в строках). Может быть переопределён явно указанным аргументом индекса posting_list_block_size.

text_index_posting_list_codec

Тип
TextIndexPostingListCodec
По умолчанию
none
История версий
ВерсияЗначение по умолчаниюКомментарий
26.6noneНовая настройка

Кодек списка вхождений по умолчанию для текстовых индексов. Эту настройку можно переопределить, явно указав аргумент индекса posting_list_codec.

text_index_serialization_version

Тип
MergeTreeTextIndexSerializationVersion
По умолчанию
v2_with_positions
История версий
ВерсияЗначение по умолчаниюКомментарий
26.8v2_with_positionsРазрешает использовать формат текстового индекса 'v2_with_positions', сохраняющий позиции токенов для фразового поиска. При использовании более старой compatibility возвращается к 'v1_with_codec', чтобы новые серверы продолжали записывать формат, доступный для чтения старыми серверами во время поэтапного обновления.
26.6v1_with_codecНовая настройка. Управляет версией формата текстовых индексов на диске. При использовании более старой compatibility возвращается к 'v0_initial', чтобы новые серверы продолжали записывать предыдущий формат, доступный для чтения старыми серверами во время поэтапного обновления.

Предпочтительная версия формата сериализации на диске для записи текстовых индексов.

Эта настройка задаёт предпочтение, а не строгое ограничение: если настроенная версия не может представить индекс, автоматически выбирается более новая версия, способная это сделать, и запись текстового индекса никогда не завершается сбоем из-за этой настройки.

Во время поэтапного обновления зафиксируйте формат с помощью настройки compatibility на уровне профиля на уже обновлённых серверах, чтобы они продолжали записывать формат, который старые серверы всё ещё могут читать.

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

  • v0_initial — Исходный формат. Не сохраняет тип кодека списка вхождений.
  • v1_with_codec — Сохраняет тип кодека списка вхождений в заголовке текстового индекса.
  • v2_with_positions — Сохраняет позиции токенов для индексов с support_phrase_search.
Navigation