> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# use_query_* 会话设置

> ClickHouse 中 use_query_* 生成组的会话设置。

这些设置可在 [system.settings](https://clickhouse.com/docs/zh/reference/system-tables/settings.md) 中查看，并由 [源文件](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) 自动生成。

## use\_query\_cache

类型

Bool

默认值

0

启用后，`SELECT` 查询可使用[查询缓存](https://clickhouse.com/docs/zh/concepts/features/performance/caches/query-cache.md)。参数 [enable\_reads\_from\_query\_cache](https://clickhouse.com/docs/zh/reference/settings/session-settings/enable.md#enable_reads_from_query_cache)
和 [enable\_writes\_to\_query\_cache](https://clickhouse.com/docs/zh/reference/settings/session-settings/enable.md#enable_writes_to_query_cache) 可进一步控制缓存的使用方式。

可能的值：

* 0 - 已禁用
* 1 - 已启用

## use\_query\_condition\_cache

类型

Bool

默认值

1

启用[查询条件缓存](https://clickhouse.com/docs/zh/concepts/features/performance/caches/query-condition-cache.md)。该缓存会存储数据分区片段中不满足 `WHERE` 子句条件的粒度范围，
并将这些信息作为临时索引在后续查询中复用。

可能的值：

* 0 - 禁用
* 1 - 启用

## use\_query\_condition\_cache\_for\_time\_conditions

类型

Bool

默认值

1

从 `MergeTree` 表读取数据时，为涉及当前时间的条件 (例如 `WHERE time >= now() - INTERVAL 10 DAY`) 启用[查询条件缓存](https://clickhouse.com/docs/zh/concepts/features/performance/caches/query-condition-cache.md)。从文件和对象存储 (`file`、`s3` 等) 读取数据时，查询条件缓存仅用于确定性的条件，不受此设置影响。

此类条件是非确定性的 (会随时钟变化) ，因此无法直接缓存。为此，系统会将折叠后的当前时间常量舍入到时间网格上，从而推导出一个确定性的条件，例如 `WHERE time >= '2026-08-09 12:34:56'` 会变为 `WHERE time >= '2026-08-09 00:00:00'` (读取缓存时向下舍入，写入缓存时向上舍入，以保证缓存结果的正确性) 。网格步长与该常量和当前时间之间的距离成正比 (参见 [`query_condition_cache_time_condition_grid_factor`](https://clickhouse.com/docs/zh/reference/settings/session-settings/other#query_condition_cache_time_condition_grid_factor)) ，并限制在一秒到一天之间。

如果该常量已与网格对齐 (例如 `WHERE time >= today() - 10` 或 `WHERE time >= toStartOfDay(now())`) ，则缓存在整个网格单元内都有效，例如一直到当天结束。否则，只有针对时间下界的条件才能复用缓存，例如 `WHERE time >= now() - INTERVAL 10 DAY`：在某个网格单元内写入的缓存条目会在下一个网格单元内被使用。未对齐的上界 (例如 `WHERE time < now()`) ，无论是单独出现，还是作为滑动窗口的一部分 (如 `WHERE time >= now() - INTERVAL 10 DAY AND time < now()`) ，都无法被后续查询复用，因为后续查询的条件并不包含在先前查询的条件之内。

只有同时启用 `use_query_condition_cache`，此设置才会生效。

可选值：

* 0 - 已禁用
* 1 - 已启用

## use\_query\_condition\_cache\_for\_top\_k

类型

Bool

默认值

1

为采用 `ORDER BY <column> LIMIT n` (TopK) 优化 (基于动态过滤或跳过索引) 的查询启用[查询条件缓存](https://clickhouse.com/docs/zh/concepts/features/performance/caches/query-condition-cache.md)。禁用时，此类读取既不会查找缓存，也不会填充缓存。

此类查询在执行期间可能会根据运行时阈值跳过粒度，因此其缓存条目会按 TopK 执行计划参数和所读取的 parts 集合进行分区 (对于 `File` 表，则按所读取的文件集合及其版本进行分区；对于数据湖表，则按其快照进行分区)。除非同时启用 `use_query_condition_cache`，否则此设置不会生效。

可选值：

* 0 - 已禁用
* 1 - 已启用
