Struct CachedPlan 

pub struct CachedPlan {
    pub plan: QueryPlan,
    pub cached_at: Instant,
    pub access_count: u64,
    pub last_accessed: Instant,
    pub shape_key: Option<String>,
    pub exact_query: Option<Arc<str>>,
    pub state: CacheEntryState,
    pub expected_rows_scanned: Option<u64>,
    pub last_observed_rows_scanned: Option<u64>,
    pub parameter_count: usize,
    pub replan_pending: bool,
}

A cached query plan with metadata

Fields

plan: QueryPlan

The compiled query plan

cached_at: Instant

When this plan was cached

access_count: u64

Number of times this plan was accessed

last_accessed: Instant

Last access time

shape_key: Option<String>

Query shape key used for parameter-insensitive cache grouping.

exact_query: Option<Arc<str>>

Last exact query string stored in this slot.

state: CacheEntryState

Runtime activation state inspired by Mongo’s active/inactive plan cache.

expected_rows_scanned: Option<u64>

Moving expectation for storage reads (rows_scanned) on this shape.

last_observed_rows_scanned: Option<u64>

Last observed runtime reads for the shape.

parameter_count: usize

Number of literal binds expected by the cached shape skeleton.

replan_pending: bool

When true, the next cache lookup forces a fresh replan.

Implementations

impl CachedPlan

pub fn new(plan: QueryPlan) -> Self

Create a new cached plan

pub fn with_shape_key(self, shape_key: impl Into<String>) -> Self

pub fn with_exact_query(self, query: impl Into<String>) -> Self

pub fn with_parameter_count(self, parameter_count: usize) -> Self

pub fn is_expired(&self, ttl: Duration) -> bool

Check if the plan has expired

pub fn touch(&mut self)

Record an access

pub fn matches_exact_query(&self, query: &str) -> bool

pub fn needs_replan(&self) -> bool

pub fn record_observation(&mut self, rows_scanned: u64)

Trait Implementations

impl Clone for CachedPlan

fn clone(&self) -> CachedPlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachedPlan

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

Formats the value using the given formatter.