Struct ExplainOutput 

pub struct ExplainOutput {
    pub plan: QueryPlan,
    pub actual_stats: Option<ActualStats>,
    pub node_stats: Vec<NodeStats>,
    pub cost_factors: Option<OperationCostFactors>,
    pub calibration_source: Option<String>,
    pub feedback_calibration: Option<FeedbackCalibration>,
}

EXPLAIN output with optional ANALYZE stats and cost model metadata.

Fields

plan: QueryPlan

The query plan.

actual_stats: Option<ActualStats>

Actual execution statistics (only with ANALYZE).

node_stats: Vec<NodeStats>

Per-node execution statistics (only with ANALYZE).

cost_factors: Option<OperationCostFactors>

Effective cost factors used for this plan. None when EXPLAIN is called without ANALYZE.

calibration_source: Option<String>

Calibration source: "histogram" if calibrated, "default" otherwise. None when EXPLAIN is called without ANALYZE.

feedback_calibration: Option<FeedbackCalibration>

Runtime CBO calibration from the EMA feedback loop (issue #469 Phase 2).

Present only in EXPLAIN ANALYZE output once the feedback loop is warm (≥ 10 vector query samples on this collection).

Implementations

impl ExplainOutput

pub fn plan_only(plan: QueryPlan) -> Self

Creates an EXPLAIN-only output (no actual stats, no cost metadata).

pub fn with_stats( plan: QueryPlan, actual_stats: ActualStats, node_stats: Vec<NodeStats>, ) -> Self

Creates an EXPLAIN ANALYZE output with actual stats (cost metadata not yet populated).

pub fn with_feedback_calibration( self, ms_per_cost_unit: f64, sample_count: u64, ) -> Self

Attaches CBO feedback calibration (issue #469 Phase 2).

Populates feedback_calibration with the EMA-adjusted ms_per_cost_unit and the sample count from the feedback loop. Call this after with_stats when the collection’s QueryPlanner has accumulated enough samples for a stable EMA.

pub fn with_cost_metadata(self, stats: &CoreCollectionStats) -> Self

Populates cost factors and calibration source from collection stats.

If calibrated_cost_factors is Some in the stats, uses those factors and sets calibration_source to "histogram". Otherwise, uses the default factors and sets calibration_source to "default".

Trait Implementations

impl Clone for ExplainOutput

fn clone(&self) -> ExplainOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExplainOutput

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExplainOutput

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ExplainOutput

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.