Enum ExecutorError 

#[non_exhaustive]
pub enum ExecutorError {
    Parse {
        source: ParserError,
    },
    Analysis {
        source: AnalysisError,
    },
    Plan {
        source: PlannerError,
    },
    DataException {
        subclass: DataExceptionSubclass,
        message: String,
        span: SourceSpan,
    },
    DependentObjectStillExists {
        message: String,
        span: SourceSpan,
    },
    GraphTypeViolation {
        message: String,
        span: SourceSpan,
    },
    InvalidReference {
        name: String,
        span: SourceSpan,
    },
    UnboundParameter {
        name: DbString,
        span: SourceSpan,
    },
    InvalidParameterType {
        name: DbString,
        expected: Cow<'static, str>,
        actual: &'static str,
        span: SourceSpan,
    },
    UnknownFunction {
        name: String,
        span: SourceSpan,
    },
    FunctionArityMismatch {
        name: String,
        expected: &'static str,
        actual: usize,
        span: SourceSpan,
    },
    InvalidFunctionModifier {
        name: String,
        modifier: &'static str,
        span: SourceSpan,
    },
    FeatureNotSupportedYet {
        feature: &'static str,
        span: SourceSpan,
    },
    DuplicateObject {
        kind: &'static str,
        name: DbString,
        span: SourceSpan,
    },
    InvalidTransactionState {
        detail: &'static str,
        span: SourceSpan,
    },
    TransactionAlreadyActive {
        span: SourceSpan,
    },
    NoActiveTransaction {
        span: SourceSpan,
    },
    InFailedTransaction {
        span: SourceSpan,
    },
    SessionClosed {
        span: SourceSpan,
    },
    Cancelled {
        span: SourceSpan,
    },
    Timeout {
        deadline: Instant,
        elapsed: Duration,
        span: SourceSpan,
    },
    RowCapExceeded {
        cap: usize,
        span: SourceSpan,
    },
    ProgramLimitExceeded {
        detail: &'static str,
        span: SourceSpan,
    },
    GraphMutation {
        source: GraphError,
        span: SourceSpan,
    },
    Flush {
        provider_tag: ProviderTag,
        reason: String,
    },
    Procedure {
        source: ProcedureError,
        span: SourceSpan,
    },
    ImplementationDefined {
        detail: &'static str,
    },
}

Query execution failure.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Parse

Source text failed to parse before execution.

Fields

source: ParserError

Underlying parser error.

Analysis

Semantic analysis failed before execution.

Fields

source: AnalysisError

Underlying analyzer error.

Plan

Planning failed before execution.

Fields

source: PlannerError

Underlying planner error.

DataException

Runtime data exception such as arithmetic overflow or division by zero.

Fields

subclass: DataExceptionSubclass

ISO Table 8 subclass selected by the emitting runtime site.

message: String

Human-readable diagnostic message.

span: SourceSpan

Source span for the failing expression.

DependentObjectStillExists

A graph mutation would leave a dependent object behind.

Fields

message: String

Human-readable diagnostic message.

span: SourceSpan

Source span for the failing mutation.

GraphTypeViolation

A closed-graph operation violated the bound graph type.

Fields

message: String

Human-readable diagnostic message.

span: SourceSpan

Source span for the failing graph-type operation.

InvalidReference

Runtime reference lookup failed for a malformed row or dynamic access.

Fields

name: String

Missing or malformed reference name.

span: SourceSpan

Source span requiring the reference.

UnboundParameter

A $name parameter was referenced but not bound on the session.

Maps to GQLSTATUS 22G03 per ISO/IEC 39075:2024 section 23.1 Table 8.

Fields

name: DbString

Parameter name without the leading $.

span: SourceSpan

Source span requiring the parameter.

InvalidParameterType

A bound $name parameter had the wrong type for its runtime position.

Maps to GQLSTATUS 22G03 per ISO/IEC 39075:2024 section 23.1 Table 8.

Fields

name: DbString

Parameter name without the leading $.

expected: Cow<'static, str>

Human-readable expected type.

actual: &'static str

Human-readable actual type.

span: SourceSpan

Source span requiring the parameter.

UnknownFunction

Scalar function name was not registered in the v1.1 closed set.

Maps to GQLSTATUS 22G03 per ISO/IEC 39075:2024 section 23.1 Table 8.

Fields

name: String

Function name as written by the caller.

span: SourceSpan

Source span for the function call.

FunctionArityMismatch

Scalar function received the wrong number of arguments.

Maps to GQLSTATUS 22G03 per ISO/IEC 39075:2024 section 23.1 Table 8.

Fields

name: String

Function name as written by the caller.

expected: &'static str

Human-readable arity contract.

actual: usize

Actual argument count.

span: SourceSpan

Source span for the function call.

InvalidFunctionModifier

Scalar function call used an aggregate-only modifier.

Maps to GQLSTATUS 22G03 per ISO/IEC 39075:2024 section 23.1 Table 8.

Fields

name: String

Function name as written by the caller.

modifier: &'static str

Rejected modifier.

span: SourceSpan

Source span for the function call.

FeatureNotSupportedYet

Construct is ISO-legal but not yet implemented in the evaluator surface.

Maps to GQLSTATUS 42N01, a selene-db implementation-defined subclass under standard class 42 per ISO/IEC 39075:2024 section 23.1. The message is deliberately version-agnostic so it does not go stale across releases.

Fields

feature: &'static str

Stable feature tag.

span: SourceSpan

Source span requiring the feature.

DuplicateObject

Catalog object name collides with an existing declaration.

Fields

kind: &'static str

Object class.

name: DbString

Colliding object name.

span: SourceSpan

Source span of the duplicate name.

InvalidTransactionState

Transaction state does not permit the requested executor operation.

Fields

detail: &'static str

Stable detail tag asserted by tests.

span: SourceSpan

Source span requiring a write transaction.

TransactionAlreadyActive

START TRANSACTION was requested while an explicit transaction exists.

Fields

span: SourceSpan

Source span for the transaction-control statement.

NoActiveTransaction

COMMIT or ROLLBACK was requested without an explicit transaction.

Fields

span: SourceSpan

Source span for the transaction-control statement.

InFailedTransaction

Statement was issued while the explicit transaction is aborted.

Fields

span: SourceSpan

Source span for the rejected statement.

SessionClosed

A GQL-request was issued against a session closed by SESSION CLOSE.

Maps to GQLSTATUS 2DN01, a selene-db implementation-defined subclass under standard class 2D per ISO/IEC 39075:2024 section 23.1 (section 7.3).

Fields

span: SourceSpan

Source span for the rejected request.

Cancelled

Caller-requested cooperative cancellation interrupted the statement.

Fields

span: SourceSpan

Source span for the cancellation checkpoint.

Timeout

The statement deadline elapsed before completion.

Fields

deadline: Instant

Deadline configured on the session.

elapsed: Duration

Duration since the deadline elapsed.

span: SourceSpan

Source span for the timeout checkpoint.

RowCapExceeded

The statement produced more outermost result rows than allowed.

Fields

cap: usize

Maximum allowed outermost result rows.

span: SourceSpan

Source span for the result boundary.

ProgramLimitExceeded

An implementation-defined program limit was exceeded.

Fields

detail: &'static str

Stable limit detail asserted by tests.

span: SourceSpan

Source span for the limit boundary.

GraphMutation

The graph mutation funnel rejected a write.

Fields

source: GraphError

Underlying graph-layer error.

span: SourceSpan

Source span for the write site.

Flush

Commit-critical durability provider flush failed.

Fields

provider_tag: ProviderTag

Durable provider tag.

reason: String

Human-readable provider failure reason.

Procedure

Procedure registry execution failed.

Fields

source: ProcedureError

Underlying procedure error.

span: SourceSpan

Source span for the CALL site.

ImplementationDefined

Implementation-defined executor surface not supported by this brief.

Fields

detail: &'static str

Stable detail tag asserted by tests.

Implementations

impl ExecutorError

pub fn gqlstatus(&self) -> GqlStatus

Map this executor failure to its GQLSTATUS code.

Trait Implementations

impl Debug for ExecutorError

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

Formats the value using the given formatter.

impl Diagnostic for ExecutorError

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn help<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for ExecutorError

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

Formats the value using the given formatter.

impl Error for ExecutorError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.