Struct StorageQueryPlanner 

pub struct StorageQueryPlanner { /* private fields */ }

Production-grade query planner that optimizes storage access patterns.

Examples

use ipfrs_storage::storage_query_planner::{
    StorageQueryPlanner, SqpPlannerConfig, SqpQuery, SqpPredicate, SqpOp, SqpValue,
};

let planner = StorageQueryPlanner::new(SqpPlannerConfig::default());
let mut query = SqpQuery::new(1);
query.predicates.push(SqpPredicate::new("age", SqpOp::Gt, SqpValue::Int(18)));
let plan = planner.plan(&query);
assert!(plan.estimated_rows > 0);

Implementations

impl StorageQueryPlanner

pub fn new(config: SqpPlannerConfig) -> Self

Create a new planner with the given configuration.

pub fn register_index( &self, name: impl Into<String>, cardinality: u64, selectivity: f64, ) -> SqpIndexId

Register a new index and return its assigned SqpIndexId.

If an index with the same name already exists its statistics are updated in place and the existing ID is returned.

pub fn index_stat(&self, id: SqpIndexId) -> Option<SqpIndexStat>

Look up the stat record for a registered index.

pub fn plan(&self, query: &SqpQuery) -> SqpQueryPlan

Generate an optimised plan for query (no caching).

pub fn plan_cached(&self, query: &SqpQuery) -> SqpQueryPlan

Generate or retrieve a cached plan for query.

pub fn invalidate_cache(&self)

Invalidate the entire plan cache.

pub fn invalidate_for_index(&self, id: SqpIndexId)

Remove all cached plans that reference the given index.

pub fn estimate_cost(&self, plan: &SqpQueryPlan) -> f64

Re-estimate the cost of an already-built plan.

This applies the configured cost model independently of plan generation, making it useful for comparing alternative plans.

pub fn explain(&self, plan: &SqpQueryPlan) -> String

Produce a human-readable description of a plan.

pub fn planner_stats(&self) -> SqpPlannerStats

Return aggregate planner statistics.

pub fn recent_history(&self, n: usize) -> Vec<SqpQueryRecord>

Return the most recent N planning records from history.

Trait Implementations

impl Default for StorageQueryPlanner

fn default() -> Self

Returns the “default value” for a type.