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

Настройки сеанса ClickHouse в автоматически сгенерированной группе query_cache_*.

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

​

query_cache_compress_entries

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

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

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

​

query_cache_for_subqueries

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

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

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

​

query_cache_max_entries

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

Это ограничение не распространяется на кэш запросов на диске (настройка query_cache_on_disk_cache_name): количество его записей ограничивается размером базового файлового кэша.

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

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

​

query_cache_max_size_in_bytes

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

Это ограничение не распространяется на кэш запросов на диске (настройка query_cache_on_disk_cache_name): общий объём его записей ограничивается размером базового файлового кэша.

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

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

​

query_cache_min_query_duration

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

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

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

​

query_cache_min_query_runs

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

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

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

​

query_cache_nondeterministic_function_handling

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

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

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

​

query_cache_on_disk_cache_name

Имя файлового кэша (записи в разделе filesystem_caches конфигурации сервера), в котором хранятся на диске записи кэша запросов. Если имя задано (и включена настройка use_query_cache), результаты запросов дополнительно кэшируются в указанном файловом кэше и отдаются из него. Кэш запросов на диске вмещает больше данных, чем кэш запросов в памяти, сохраняется после перезапуска сервера и работает независимо от кэша запросов в памяти: настройки enable_reads_from_query_cache_on_disk и enable_writes_to_query_cache_on_disk управляют им отдельно от кэша запросов в памяти. Эти записи — обычные записи файлового кэша: они не защищены от удаления и вытесняются по тем же правилам, что и любые другие данные в нём. SYSTEM CLEAR FILESYSTEM CACHE '<name>' удаляет их вместе со всем остальным содержимым файлового кэша, а SYSTEM CLEAR QUERY CACHE удаляет записи кэша запросов на диске из файлового кэша, заданного этой настройкой, не затрагивая остальные данные. Для результатов запросов рекомендуется использовать отдельный файловый кэш.

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

• Пустая строка — кэш запросов на диске отключён
• Имя заранее настроенного файлового кэша

​

query_cache_on_disk_codec

Кодек сжатия записей кэша запросов, хранящихся на диске (см. query_cache_on_disk_cache_name). Влияет только на запись: чтение от этой настройки не зависит, поскольку сжатые данные являются самоописывающимися.

​

query_cache_share_between_users

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

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

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

​

query_cache_squash_partial_results

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

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

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

​

query_cache_system_table_handling

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

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

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

​

query_cache_tag

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

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

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

​

query_cache_ttl

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

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

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