Struct PlanCache 

pub struct PlanCache { /* private fields */ }

Implementations

impl PlanCache

pub fn new() -> Self

pub fn set_max_entries(&mut self, n: usize)

v6.5.6 — runtime cap override. Operator-tunable via SPG_PLAN_CACHE_MAX env at startup. Minimum 1; values above the compile-time PLAN_CACHE_MAX_ENTRIES are clamped down to it (defensive backstop against runaway configs).

pub fn max_entries(&self) -> usize

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn get_snapshot(&self, sql: &str) -> Option<&PreparedPlan>

Read-only peek without LRU promotion. Used by introspection and v6.3.1 tests that want to inspect a cached plan’s metadata without mutating the cache.

pub fn get(&mut self, sql: &str) -> Option<&PreparedPlan>

Returns the cached plan if present and promotes it to most- recently-used. Returns None on miss.

pub fn insert(&mut self, sql: String, plan: PreparedPlan)

Inserts (or replaces) the plan. Evicts the oldest entry if we’d exceed PLAN_CACHE_MAX_ENTRIES.

pub fn clear(&mut self)

pub fn evict(&mut self, sql: &str) -> Option<PreparedPlan>

v6.3.1 will use this for explicit invalidation. v6.3.0 exposes it for tests + future use.

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

v6.3.1 will use this to evict every plan that references a specific table.

Trait Implementations

impl Clone for PlanCache

fn clone(&self) -> PlanCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PlanCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PlanCache

fn default() -> Self

Returns the “default value” for a type.