Struct QueryPlanner 

pub struct QueryPlanner { /* private fields */ }

Unified query planner that handles the complete optimization pipeline.

Unlike the basic Optimizer, QueryPlanner supports ExecutionContext throughout the entire pipeline, enabling context-aware optimizations for both logical and physical plans.

Implementations

impl QueryPlanner

pub fn new(ctx: ExecutionContext) -> Self

Creates a new QueryPlanner with the given execution context.

The planner is initialized with default optimization passes:

• Logical: NotSimplification, AndPredicatePass, CrossProductPass, ImplicitJoinsPass, OuterJoinSimplification, PredicatePushdown, JoinReorder
• Context-aware logical: IndexSelection
• Physical: TopNPushdown, OrderByIndexPass, LimitSkipByIndexPass

pub fn with_logical_passes( ctx: ExecutionContext, passes: Vec<Box<dyn OptimizerPass>>, ) -> Self

Creates a QueryPlanner with custom logical passes.

Context-aware passes (IndexSelection, OrderByIndexPass, etc.) are still applied automatically using the provided context.

pub fn context(&self) -> &ExecutionContext

Returns a reference to the execution context.

pub fn plan(&self, plan: LogicalPlan) -> PhysicalPlan

Plans a logical query into an optimized physical plan.

This is the main entry point that runs the complete optimization pipeline:

1. Apply context-free logical optimizations
2. Apply context-aware logical optimizations (IndexSelection)
3. Convert to physical plan
4. Apply physical optimizations (TopNPushdown, OrderByIndexPass, LimitSkipByIndexPass)

pub fn optimize_logical(&self, plan: LogicalPlan) -> LogicalPlan

Optimizes only the logical plan without converting to physical.

Useful for debugging or when you need to inspect the optimized logical plan.

pub fn to_physical(&self, plan: LogicalPlan) -> PhysicalPlan

Converts a logical plan to physical and applies physical optimizations.

Assumes the logical plan has already been optimized.