Enum QueryErrorCode 

pub enum QueryErrorCode {
    Cancelled,
    UnsupportedPipelineContract,
    UnsupportedOperator,
    UnsupportedExpression,
    UnsupportedType,
    InvalidPlan,
    InvalidAttemptCorrelation,
    InvalidConfiguration,
    GraphInputInvalid,
    CudfInvalidInput,
    CudfUnsupported,
    SizeOverflow,
    HostMaterializationLimitExceeded,
    CudfTemporaryFailure,
    CudfPersistentFailure,
    CudfDependencyFailure,
    AlgorithmDidNotConverge,
    SourceAccessDenied,
    SourceUnauthenticated,
    SourceObjectNotFound,
    SourceTemporaryFailure,
    CudfInvariantViolation,
    MemoryReservationFailed,
    ServiceOverloaded,
    QueryBudgetUnavailable,
    QueryMemoryLimitExceeded,
    DeviceOutOfMemory,
    DeviceAllocationFailed,
    DeviceFault,
    CleanupFailed,
    InternalInvariantViolation,
    Internal,
}

Stable, machine-readable native-engine error codes.

Codes describe the closest actionable cause. QueryErrorKind and QueryErrorStatus are derived from the code; consumers should not infer those policies from variant names.

Variants

Cancelled

Query execution was cancelled by the caller.

UnsupportedPipelineContract

A compiled pipeline contract refuses a plan that must execute natively.

Identifies a capability rejection. Malformed plans report as InvalidPlan.

UnsupportedOperator

A specific operator within an otherwise recognizable plan is unsupported.

UnsupportedExpression

An expression or expression form is unsupported.

UnsupportedType

A data type, physical representation, or type combination is unsupported.

InvalidPlan

The native IR violates executor invariants or cannot be validated.

Use this when the plan is malformed for the native engine. A well-formed plan outside the supported catalogue is reported with an Unsupported* code.

InvalidAttemptCorrelation

Caller-supplied execution-attempt correlation is invalid or oversized.

InvalidConfiguration

A service, backend, or device configuration value is invalid or inconsistent with the discovered hardware.

Unlike Self::InvalidPlan, the input is deployment configuration, not a query plan. The same configuration fails again until it changes.

GraphInputInvalid

Runtime graph inputs violate an engine-owned graph-operation contract.

This code describes materialized edge or side-input data. InvalidPlan describes malformed native IR.

CudfInvalidInput

cuDF rejected an input, including permanent NotFound conditions.

CudfUnsupported

cuDF reported a permanent unsupported capability.

SizeOverflow

A host materialization size computation overflowed the platform range. The same request cannot be retried safely without changing its shape.

HostMaterializationLimitExceeded

One unsplittable Arrow host row exceeds the configured deterministic materialization ceiling.

CudfTemporaryFailure

cuDF reported a temporary dependency/runtime failure.

CudfPersistentFailure

cuDF reported a persistent dependency/runtime failure.

The failure has been observed to recur or is known to continue. Stop automatic retries and escalate or wait for intervention.

CudfDependencyFailure

cuDF reported a permanent dependency failure.

AlgorithmDidNotConverge

An iterative native algorithm reached its configured iteration bound.

SourceAccessDenied

Source object storage denied access to the requested object or metadata.

SourceUnauthenticated

Source object storage lacked valid authentication credentials.

SourceObjectNotFound

Source object storage could not find the requested object.

SourceTemporaryFailure

Source object storage failed with a retryable transport or service error.

CudfInvariantViolation

cuDF reported an invariant or execution-context violation.

MemoryReservationFailed

The native admission controller could not reserve requested memory.

Represents a temporary resource condition driving retry or backoff decisions, separate from cuDF allocator failures.

ServiceOverloaded

The service admission layer rejected the query because shared bounded capacity is saturated.

QueryBudgetUnavailable

The requested query cap cannot fit on any eligible device after subtracting resident ownership.

QueryMemoryLimitExceeded

The query domain rejected an actual or exact-required allocation over the query’s fixed memory cap.

DeviceOutOfMemory

A device allocation failed with confirmed physical-memory provenance.

DeviceAllocationFailed

A device allocation failed without confirmed physical-memory provenance.

DeviceFault

A persistent device or CUDA runtime fault made the affected device unavailable.

CleanupFailed

Cleanup or synchronization could not establish safe release of the attempt’s device resources.

InternalInvariantViolation

An owner, provenance, ledger, or stream-routing invariant was violated.

Internal

An internal native-engine bug or unreachable condition.

Implementations

impl QueryErrorCode

pub const ALL: &'static [Self]

Every native error code supported by this engine release.

This list keeps adapter projections and status policy mechanically auditable when a new code is introduced.

pub const fn as_str(self) -> &'static str

Stable snake-case code label used in reports and error text.

pub const fn kind(self) -> QueryErrorKind

Returns the stable coarse error category for this code.

pub const fn status(self) -> QueryErrorStatus

Returns the retry/remediation status for this code.

Trait Implementations

impl Clone for QueryErrorCode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for QueryErrorCode

impl Debug for QueryErrorCode

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

Formats the value using the given formatter.

impl Display for QueryErrorCode

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

Formats the value using the given formatter.

impl Eq for QueryErrorCode

impl From<QueryErrorCode> for TriageCode

fn from(code: QueryErrorCode) -> Self

Converts to this type from the input type.

impl Hash for QueryErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for QueryErrorCode

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for QueryErrorCode

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for QueryErrorCode

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for QueryErrorCode