Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Настройки сеанса use_skip_indexes_*

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

use_skip_indexes

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

Использовать индексы пропуска данных при выполнении запроса.

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

  • 0 — Отключено.
  • 1 — Включено.

use_skip_indexes_for_disjunctions

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

Вычисляет фильтры в предложении WHERE со смешанными условиями AND и OR с использованием индексов пропуска данных. Пример: WHERE A = 5 AND (B = 5 OR C = 5). Если настройка отключена, индексы пропуска данных по-прежнему используются для вычисления условий в предложении WHERE, но они должны содержать только секции, объединенные AND.

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

  • 0 — Отключено.
  • 1 — Включено.

use_skip_indexes_for_top_k

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
26.51По умолчанию включает использование индексов пропуска данных для фильтрации TopK
25.120Новая настройка.

Включает использование индексов пропуска данных для фильтрации TopK.

Если настройка включена и для столбца в запросе ORDER BY <column> LIMIT n существует индекс minmax, оптимизатор попытается использовать его, чтобы пропускать гранулы, не влияющие на итоговый результат. Это может уменьшить задержку выполнения запроса.

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

  • 0 — Отключено.
  • 1 — Включено.

use_skip_indexes_if_final

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

Управляет тем, используются ли индексы пропуска данных при выполнении запроса с модификатором FINAL.

Индексы пропуска данных могут исключать строки (гранулы), содержащие самые свежие данные, что может приводить к некорректным результатам запроса с модификатором FINAL. Если эта настройка включена, индексы пропуска данных применяются даже с модификатором FINAL, что потенциально повышает производительность. Корректность результатов по-прежнему зависит от настройки use_skip_indexes_if_final_exact_mode, которая включена по умолчанию и сканирует дополнительные части, пересекающиеся с диапазонами, возвращаемыми индексом пропуска данных. Риск пропустить недавние обновления возникает, только если эта настройка отключена.

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

  • 0 — Отключено.
  • 1 — Включено.

use_skip_indexes_if_final_exact_mode

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.61Изменено значение настройки по умолчанию
25.50Эта настройка была добавлена, чтобы запрос FINAL возвращал корректные результаты при использовании индекса пропуска данных

Определяет, будут ли гранулы, возвращаемые индексом пропуска данных, расширяться в более новых частях, чтобы при выполнении запроса с модификатором FINAL возвращались корректные результаты.

Использование индекса пропуска данных может исключать строки (гранулы), содержащие самые свежие данные, что может приводить к некорректным результатам. Эта настройка позволяет обеспечить корректность результатов за счет сканирования более новых частей, пересекающихся с диапазонами, возвращаемыми индексом пропуска данных. Отключать эту настройку следует только в том случае, если для приложения допустимы приблизительные результаты, основанные на просмотре индекса пропуска данных.

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

  • 0 — Отключено.
  • 1 — Включено.

use_skip_indexes_on_data_read

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
26.21Текстовый индекс теперь имеет статус GA
26.10Включено по умолчанию
25.90Новая настройка

Включает использование индексов пропуска данных при чтении данных.

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

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

  • 0 — Отключено.
  • 1 — Включено.
Navigation