Struct EnvConfig 

pub struct EnvConfig {
    pub compute_query_id: ComputeQueryId,
    pub explain_no_costs: bool,
    pub stats_frozen: bool,
    pub plan_deterministic: bool,
    pub disable_topk: bool,
    pub disable_joinfold: bool,
    pub random_seed: Option<u64>,
}

Frozen snapshot of SPG_TEST_* env vars + programmatic overrides.

Every field defaults to “production behaviour”; only flips when explicitly set via env var (EnvConfig::from_env) or builder (EnvConfig::builder).

Fields

compute_query_id: ComputeQueryId

SPG_TEST_COMPUTE_QUERY_ID=regress — strip query-id annotations from EXPLAIN output (regression-test mode).

explain_no_costs: bool

SPG_TEST_EXPLAIN_NO_COSTS=1 — suppress nondeterministic cost / elapsed annotations in EXPLAIN output. Used so EXPLAIN diffs are byte-equal across runs and machines.

stats_frozen: bool

SPG_TEST_STATS_FROZEN=1 — freeze the ANALYZE-derived statistics snapshot. ANALYZE becomes a no-op; INSERT/UPDATE auto-stats refresh stops firing. Pins cost-model inputs across runs.

plan_deterministic: bool

SPG_TEST_PLAN_DETERMINISTIC=1 — disable cost-based plan-cache and join-order decisions; fall back to a lexical / signature-hash tie break so the chosen plan is invariant w.r.t. stats jitter.

disable_topk: bool

SPG_TEST_DISABLE_TOPK=1 — disable the aggregate top-K LIMIT fast path (select_nth_unstable_by). Forces the full-sort fallback so two plans can be diffed for the same ORDER BY + LIMIT query.

disable_joinfold: bool

SPG_TEST_DISABLE_JOINFOLD=1 — disable the v7.37 joinfold rewrite. Lets oracle / regression harnesses compare un-folded plans against the folded baseline.

random_seed: Option<u64>

SPG_TEST_RANDOM_SEED=N — seed every nondeterministic source (hash maps that need a seed, randomised tie-breakers, …) to a deterministic value. None means “production: derive from clock”.

Implementations

impl EnvConfig

pub fn from_env() -> Self

Read every SPG_TEST_* env var exactly once. Called by hosts (spg-server, spg-embedded, tests) at engine init; the engine itself is #![no_std] and never touches env directly on its hot path.

Only available when the std feature (default) is enabled.

pub fn builder() -> EnvConfigBuilder

Builder-style override for programmatic GUC injection (used by permutation runner / oracle runner / unit tests that build an engine without env vars).

Trait Implementations

impl Clone for EnvConfig

fn clone(&self) -> EnvConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EnvConfig

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

Formats the value using the given formatter.

impl Default for EnvConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for EnvConfig

impl PartialEq for EnvConfig

fn eq(&self, other: &EnvConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for EnvConfig