Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

настройки сеанса query_cache_*

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

query_cache_compress_entries

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

Сжимает записи в кэше запросов. Снижает расход памяти кэша запросов ценой замедления записи в него и чтения из него.

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

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

query_cache_for_subqueries

Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.50Новая настройка, которая включает применение `use_query_cache` ко всем подзапросам. Без нее подзапросы кэшируются только при явном включении для каждого подзапроса через `SETTINGS use_query_cache = true`.

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

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

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

query_cache_max_entries

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

Максимальное количество результатов запросов, которые текущий пользователь может хранить в кэше запросов. 0 означает отсутствие ограничений.

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

  • Неотрицательное целое число >= 0.

query_cache_max_size_in_bytes

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

Максимальный объём памяти (в байтах), который текущий пользователь может выделить для кэша запросов. 0 означает отсутствие ограничений.

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

  • Положительное целое число >= 0.

query_cache_min_query_duration

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

Минимальная длительность выполнения запроса в миллисекундах, необходимая для сохранения его результата в кэш запросов.

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

  • Неотрицательное целое число >= 0.

query_cache_min_query_runs

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

Минимальное количество выполнений SELECT-запроса, после которого его результат сохраняется в кэше запросов.

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

  • Целое число >= 0.

query_cache_nondeterministic_function_handling

Тип
QueryResultCacheNondeterministicFunctionHandling
По умолчанию
throw

Определяет, как кэш запросов обрабатывает запросы SELECT с недетерминированными функциями, такими как rand() или now().

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

  • 'throw' - сгенерировать исключение и не кэшировать результат запроса.
  • 'save' - кэшировать результат запроса.
  • 'ignore' - не кэшировать результат запроса и не генерировать исключение.

query_cache_share_between_users

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

Если этот параметр включен, результаты SELECT-запросов, кэшированные в кэше запросов, могут быть доступны другим пользователям. Не рекомендуется включать этот параметр по соображениям безопасности.

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

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

query_cache_squash_partial_results

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

Объединяет частичные блоки результатов в блоки размером max_block_size. Снижает производительность операций вставки в кэш запросов, но повышает степень сжатия записей кэша (см. query_cache_compress-entries).

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

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

query_cache_system_table_handling

Тип
QueryResultCacheSystemTableHandling
По умолчанию
throw
История версий
ВерсияЗначение по умолчаниюКомментарий
24.4throwКэш запросов больше не сохраняет результаты запросов к системным таблицам

Управляет тем, как кэш запросов обрабатывает запросы SELECT к системным таблицам, то есть к таблицам в базах данных system.* и information_schema.*.

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

  • 'throw' — Сгенерировать исключение и не кэшировать результат запроса.
  • 'save' — Кэшировать результат запроса.
  • 'ignore' — Не кэшировать результат запроса и не генерировать исключение.

query_cache_tag

История версий
ВерсияЗначение по умолчаниюКомментарий
24.8Новая настройка для назначения меток записям кэша запросов.

Строка, которая используется как метка для записей кэша запросов. Одинаковые запросы с разными тегами кэш запросов считает разными.

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

  • Любая строка

query_cache_ttl

Тип
Seconds
По умолчанию
60

Спустя указанное число секунд записи в кэше запросов считаются устаревшими.

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

  • Положительное целое число >= 0.
Navigation