Enum QueryError 

pub enum QueryError {
    ParseError(String),
    TableNotFound(String),
    ColumnNotFound {
        table: String,
        column: String,
    },
    ParameterNotFound(usize),
    TypeMismatch {
        expected: String,
        actual: String,
    },
    UnsupportedFeature(String),
    SqlTooComplex {
        kind: &'static str,
        value: usize,
        limit: usize,
    },
    ConstraintViolation(String),
    DuplicatePrimaryKey {
        table: String,
        key: Vec<Value>,
    },
    CorrelatedCardinalityExceeded {
        estimated: u64,
        cap: u64,
    },
    AsOfBeforeRetentionHorizon {
        requested_ns: i64,
        horizon_ns: i64,
    },
    Store(StoreError),
    Json(Error),
}

Errors that can occur during query parsing and execution.

Variants

ParseError(String)

SQL syntax or parsing error.

TableNotFound(String)

Table not found in schema.

ColumnNotFound

Column not found in table.

Fields

table: String

column: String

ParameterNotFound(usize)

Query parameter not provided.

TypeMismatch

Type mismatch between expected and actual value.

Fields

expected: String

actual: String

UnsupportedFeature(String)

SQL feature not supported.

SqlTooComplex

SQL input exceeds a complexity limit (depth or token budget). Pre-parse guard that rejects pathological inputs which would trigger super-linear behavior in the upstream SQL parser.

Fields

kind: &'static str

Which budget was exceeded (e.g., paren_depth, not_tokens).

value: usize

Observed value.

limit: usize

Configured limit.

ConstraintViolation(String)

Constraint violation (e.g., NOT NULL violation, type constraint).

Generic catch-all for non-uniqueness constraint failures. Duplicate primary keys raise Self::DuplicatePrimaryKey instead so SDK callers can pattern-match without parsing message strings.

DuplicatePrimaryKey

Duplicate primary-key value detected on INSERT.

Carries the table name and the rejected key tuple so callers can short-circuit retry/upsert flows without parsing the error string. Notebar’s webhook-dedup loop (try-INSERT-then-SELECT) is the canonical consumer.

Fields

table: String

Name of the table whose primary key was violated.

key: Vec<Value>

Rejected key tuple (one element per primary-key column).

CorrelatedCardinalityExceeded

Correlated subquery row-evaluation cap exceeded.

Emitted before the correlated-loop executor runs when the estimated product of outer rows × inner rows per iteration exceeds the configured cap (default 10_000_000; see QueryEngine::with_correlated_cap). Fails fast rather than consuming memory. See docs/reference/sql/correlated-subqueries.md.

Fields

estimated: u64

cap: u64

AsOfBeforeRetentionHorizon

Requested AS OF TIMESTAMP precedes the earliest retained event.

Emitted when a FOR SYSTEM_TIME AS OF '<iso>' / AS OF TIMESTAMP query asks for a wall-clock instant older than the oldest entry in the timestamp-to-offset index (typically a freshly-opened database, or a timestamp predating any write). Distinguished from a general “no offset found” error so callers can surface the retention horizon to the user.

requested_ns is the caller-supplied Unix-nanosecond timestamp; horizon_ns is the earliest wall-clock instant the index can answer for (or 0 when the log is empty).

Shipped with v0.6.0 Tier 2 #6 (AS OF TIMESTAMP time-travel).

Fields

requested_ns: i64

horizon_ns: i64

Store(StoreError)

Underlying store error.

Json(Error)

JSON serialization/deserialization error.

Trait Implementations

impl Debug for QueryError

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

Formats the value using the given formatter.

impl Display for QueryError

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

Formats the value using the given formatter.

impl Error for QueryError

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<Error> for QueryError

fn from(source: Error) -> QueryError

Converts to this type from the input type.

impl From<QueryError> for KimberliteError

fn from(source: QueryError) -> Self

Converts to this type from the input type.

impl From<RbacError> for QueryError

fn from(err: RbacError) -> QueryError

Converts to this type from the input type.

impl From<StoreError> for QueryError

fn from(source: StoreError) -> QueryError

Converts to this type from the input type.