Enum SqlError 

pub enum SqlError {
    Parse {
        detail: String,
    },
    UnknownTable {
        name: String,
    },
    UnknownColumn {
        table: String,
        column: String,
    },
    AmbiguousColumn {
        column: String,
    },
    TypeMismatch {
        detail: String,
    },
    Unsupported {
        detail: String,
    },
    InvalidFunction {
        detail: String,
    },
    InvalidWindowFrame {
        detail: String,
    },
    MissingField {
        field: String,
        context: String,
    },
    RetryableSchemaChanged {
        descriptor: String,
    },
    ReservedIdentifier {
        name: String,
        reason: &'static str,
    },
    UnsupportedConstraint {
        feature: String,
        hint: String,
    },
    InvalidRecursiveSetOp {
        op: String,
    },
    InvalidRecursiveSelfRef {
        cte_name: String,
        reason: String,
    },
    RecursiveColumnMismatch {
        cte_name: String,
        anchor_cols: usize,
        declared_cols: usize,
    },
    RecursionDepthExceeded {
        cte_name: String,
        max_depth: usize,
    },
    CollectionDeactivated {
        name: String,
        retention_expires_at_ns: u64,
        undrop_hint: String,
    },
}

Errors produced during SQL parsing, resolution, or planning.

Variants

Parse

Fields

detail: String

UnknownTable

Fields

name: String

UnknownColumn

Fields

table: String

column: String

AmbiguousColumn

Fields

column: String

TypeMismatch

Fields

detail: String

Unsupported

Fields

detail: String

InvalidFunction

Fields

detail: String

InvalidWindowFrame

Fields

detail: String

MissingField

Fields

field: String

context: String

RetryableSchemaChanged

A descriptor the planner depends on is being drained by an in-flight DDL. Callers (pgwire handlers) should retry the whole statement after a short backoff. Propagated from SqlCatalogError::RetryableSchemaChanged.

Fields

descriptor: String

ReservedIdentifier

Identifier is a NodeDB reserved keyword. Use a quoted identifier to bypass.

Fields

name: String

reason: &'static str

UnsupportedConstraint

An unsupported SQL constraint was used in a DDL statement.

Rendered as SQLSTATE 0A000 (feature_not_supported). The feature field names the constraint keyword and hint points to the NodeDB equivalent.

Fields

feature: String

hint: String

InvalidRecursiveSetOp

WITH RECURSIVE used a set operator other than UNION or UNION ALL.

Only UNION and UNION ALL are permitted in the recursive term of a WITH RECURSIVE CTE. INTERSECT and EXCEPT are rejected because they cannot guarantee termination in standard iterative evaluation.

Fields

op: String

InvalidRecursiveSelfRef

The recursive self-reference is absent, appears more than once, or appears inside a subquery, aggregate, or the nullable side of an outer join.

Fields

cte_name: String

reason: String

RecursiveColumnMismatch

The anchor SELECT produces a different number of columns than the column list declared on the CTE (or the recursive arm).

Fields

cte_name: String

anchor_cols: usize

declared_cols: usize

RecursionDepthExceeded

The recursive CTE exceeded the configured max_recursion_depth.

This is a runtime error produced by the executor, not the planner.

Fields

cte_name: String

max_depth: usize

CollectionDeactivated

Collection is soft-deleted (within retention window). Propagated from SqlCatalogError::CollectionDeactivated; the pgwire layer renders this as sqlstate 42P01 with an UNDROP COLLECTION <name> hint in the message.

Fields

name: String

retention_expires_at_ns: u64

undrop_hint: String

Trait Implementations

impl Debug for SqlError

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

Formats the value using the given formatter.

impl Display for SqlError

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

Formats the value using the given formatter.

impl Error for SqlError

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.

impl From<ExprParseError> for SqlError

fn from(e: ExprParseError) -> Self

Converts to this type from the input type.

impl From<ParserError> for SqlError

fn from(e: ParserError) -> Self

Converts to this type from the input type.

impl From<SqlCatalogError> for SqlError

fn from(e: SqlCatalogError) -> Self

Converts to this type from the input type.

impl PartialEq for SqlError

fn eq(&self, other: &SqlError) -> 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 SqlError