Struct ExecutionMetadata 

pub struct ExecutionMetadata {
    pub compile_duration: Duration,
    pub execute_duration: Duration,
    pub query_shape_id: String,
    pub rows_returned: Option<u64>,
    pub outcome: Outcome,
}

Timing and result facts about one query execution.

Returned alongside the result rather than reported from inside the execution path, so the caller decides what to do with it — record a metric, attach it to a span, log it, or ignore it. Keeping the decision out here is what lets the same execution path serve an instrumented server and an uninstrumented script.

Fields

compile_duration: Duration

PyQL → SQL compilation. Zero on a compile-cache hit, which is itself the signal that the cache is working.

execute_duration: Duration

Time in the database, from handing over the SQL to having the rows.

query_shape_id: String

See CompiledQuery::shape_id.

rows_returned: Option<u64>

None for a statement that returns no rows, which is distinct from Some(0) — a query that ran and matched nothing.

outcome: Outcome

Implementations

impl ExecutionMetadata

pub fn total_duration(&self) -> Duration

Compile plus execute — what a caller timing “the query” means.

Trait Implementations

impl Clone for ExecutionMetadata

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecutionMetadata

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

Formats the value using the given formatter.