Enum SqlCatalogError 

pub enum SqlCatalogError {
    RetryableSchemaChanged {
        descriptor: String,
    },
    CollectionDeactivated {
        name: String,
        retention_expires_at_ns: u64,
    },
}

Errors surfaced by SqlCatalog implementations.

Only one variant today — callers pattern-match directly and map the retryable case to SqlError::RetryableSchemaChanged via the From impl in error.rs. The enum shape is kept despite having a single variant so future variants can be added without a breaking change.

Variants

RetryableSchemaChanged

A DDL drain is in progress on the descriptor at the version the planner wanted to acquire a lease on. Callers should retry the whole plan after a short backoff — by then either the drain has completed (new descriptor version available in the cache) or the retry budget is exhausted and a typed error surfaces to the client.

Fields

descriptor: String

Human-readable identifier for the descriptor, e.g. "collection orders". Used in log / trace output.

CollectionDeactivated

Collection is soft-deleted (DROP COLLECTION run, retention window still active). Distinct from Ok(None) = absent so the planner can surface an actionable error with an UNDROP hint rather than a generic “unknown table”.

Fields

name: String

retention_expires_at_ns: u64

Wall-clock nanoseconds when retention elapses and the collection is hard-deleted by the GC sweeper.

Trait Implementations

impl Clone for SqlCatalogError

fn clone(&self) -> SqlCatalogError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SqlCatalogError

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

Formats the value using the given formatter.

impl Display for SqlCatalogError

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

Formats the value using the given formatter.

impl Error for SqlCatalogError

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<SqlCatalogError> for SqlError

fn from(e: SqlCatalogError) -> Self

Converts to this type from the input type.