Struct PlanCache 

pub struct PlanCache { /* private fields */ }

查询计划缓存

双缓存架构：

• parse_cache：SQL → AST（解析结果缓存）
• optimize_cache：SQL → 优化分析（优化结果缓存）

锁顺序约定：parse_cache → optimize_cache → access_order → table_index → stats （按此顺序加锁，避免死锁）

Implementations

impl PlanCache

pub fn new(max_size: usize, default_ttl: Option<Duration>) -> Self

创建新的查询计划缓存

• max_size：最大缓存条目数（LRU 淘汰）
• default_ttl：默认 TTL（None 表示永不过期）

pub fn get_or_parse(&self, sql: &str) -> Result<Arc<Statement>, String>

获取或解析 SQL

命中缓存时返回 AST + stats.parse_hits++ + LRU touch。 未命中时解析 SQL + 存入缓存 + stats.parse_misses++。

pub fn get_or_optimize(&self, sql: &str) -> Option<Arc<String>>

获取或优化 SQL

命中缓存时返回优化分析 + stats.optimize_hits++ + LRU touch。 未命中时返回 None + stats.optimize_misses++（调用方应执行优化后调用 store_optimize）。

pub fn store_optimize(&self, sql: &str, analysis: Arc<String>)

存储优化结果

在 get_or_optimize 返回 None 后，调用方执行优化并存储结果。

pub fn invalidate_table(&self, table: &str) -> usize

表级精确失效

失效所有引用指定表的缓存条目，返回失效条目数。

pub fn invalidate_all(&self)

全量清空缓存

pub fn stats(&self) -> PlanCacheStatsSnapshot

获取统计快照

pub fn size(&self) -> usize

当前缓存大小

impl PlanCache

pub fn eviction_count(&self) -> u64

v7.3.0 任务 1.5：淘汰数原子计数器

pub fn with_config(config: &PlanCacheConfig) -> Self

v7.3.0 任务 1.5：从 PlanCacheConfig 创建缓存

pub fn get_or_parse_with_types( &self, sql: &str, param_types: &[DbType], ) -> Result<Arc<Statement>, String>

v7.3.0 任务 1.5：带参数类型指纹的 get_or_parse

相同 SQL 不同参数类型生成不同指纹，避免错误命中。

pub fn access_count(&self, hash: u64) -> u32

v7.4.0 任务 3.3：获取 key 的访问次数（LRU-K 统计）

pub fn lru_k(&self) -> u32

v7.4.0 任务 3.3：LRU-K 的 K 值

pub fn parse_hit_rate(&self) -> f64

v7.4.0 任务 3.3：解析缓存命中率

pub fn adjust_capacity(&mut self) -> bool

v7.4.0 任务 3.3：自适应容量调整

根据命中率动态调整缓存大小：

• 命中率 > 80%：扩容（上限 max_capacity）
• 命中率 < 30%：缩容（下限 min_capacity）
• 其他：保持不变

pub fn capacity(&self) -> usize

v7.4.0 任务 3.3：当前最大容量

Trait Implementations

impl Default for PlanCache

fn default() -> Self

Returns the “default value” for a type.