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

当前缓存大小

Trait Implementations

impl Default for PlanCache

fn default() -> Self

Returns the “default value” for a type.