查询结果缓存

启用后，Databend 会缓存并持久化每个已执行查询的结果。这能显著缩短查询响应时间。

缓存使用条件

仅当满足所有条件时，才会复用缓存中的查询结果：

条件	要求
缓存已启用	当前会话中 enable_query_result_cache = 1
相同查询	查询文本必须完全匹配 (区分大小写)
执行时间	原始查询运行时间 ≥ query_result_cache_min_execute_secs
结果大小	缓存结果 ≤ query_result_cache_max_bytes
TTL 有效	缓存生成时间 < query_result_cache_ttl_secs
数据一致性	表数据自缓存后未变更 (除非 query_result_cache_allow_inconsistent = 1)
会话范围	缓存作用域为会话级别

自动缓存失效

默认配置下 (query_result_cache_allow_inconsistent = 0)，当底层表数据变更时缓存结果自动失效。这确保数据一致性，但可能降低高频更新场景的缓存效率。

快速入门

在会话中启用查询结果缓存：

-- 启用查询结果缓存
SET enable_query_result_cache = 1;

-- 可选：缓存所有查询 (含快速查询)
SET query_result_cache_min_execute_secs = 0;

配置参数

参数	默认值	描述
enable_query_result_cache	0	启用/禁用查询结果缓存
query_result_cache_allow_inconsistent	0	允许使用底层数据变更后的缓存结果
query_result_cache_max_bytes	1048576	单条缓存结果最大字节数
query_result_cache_min_execute_secs	1	触发缓存的最小执行时间
query_result_cache_ttl_secs	300	缓存有效期 (5 分钟)

性能示例

以下演示 TPC-H Q1 查询的缓存效果：

1. 启用缓存

SET enable_query_result_cache = 1;
SET query_result_cache_min_execute_secs = 0;

2. 首次执行 (无缓存)

SELECT
    l_returnflag,
    l_linestatus,
    sum(l_quantity) as sum_qty,
    sum(l_extendedprice) as sum_base_price,
    sum(l_extendedprice * (1 - l_discount)) as sum_disc_price,
    sum(l_extendedprice * (1 - l_discount) * (1 + l_tax)) as sum_charge,
    avg(l_quantity) as avg_qty,
    avg(l_extendedprice) as avg_price,
    avg(l_discount) as avg_disc,
    count(*) as count_order
FROM lineitem
WHERE l_shipdate <= add_days(to_date('1998-12-01'), -90)
GROUP BY l_returnflag, l_linestatus
ORDER BY l_returnflag, l_linestatus;

结果：4 行，耗时 21.492 秒 (处理 600M 行)

3. 验证缓存条目

SELECT sql, query_id, result_size, num_rows FROM system.query_cache;

4. 二次执行 (缓存命中)

重复执行相同查询。

结果：4 行，耗时 0.164 秒 (处理 0 行)

缓存管理

监控缓存

SELECT * FROM system.query_cache;

访问缓存结果

SELECT * FROM RESULT_SCAN(LAST_QUERY_ID());

缓存生命周期

缓存结果在以下情况自动清除：

• TTL 过期 (默认：5 分钟)
• 结果超限 (默认：1MB)
• 会话终止 (缓存作用域为会话级别)
• 数据变更 (自动失效确保一致性)
• 表结构变更 (Schema 修改触发失效)

会话作用域

查询结果缓存按会话隔离。各会话维护独立缓存，会话结束时自动清理。