Enum SqliteError 

pub enum SqliteError {
    RequestReadStopped(StorageError),
    Rusqlite(Error),
    InvalidData(String),
    InheritedWriterTransaction,
    WriterSettlementUnknown,
    WriterPoisoned,
    WriterPoolCheckoutTimeout {
        timeout: Duration,
    },
    CapacityFloor {
        volume: String,
        available_bytes: u64,
        floor_bytes: u64,
        required_headroom_bytes: u64,
    },
    CapacityUnavailable {
        phase: CapacityUnavailablePhase,
        message: String,
    },
    VolumeLeaseReentry {
        holder_site: String,
        requester_site: String,
    },
    WalCeilingOffsetOverflow {
        bytes: u64,
    },
    WalCeilingUnsupported {
        bytes: u64,
        backend_kind: &'static str,
    },
    WalCeilingBelowMinimum {
        bytes: u64,
        page_size: u64,
        minimum_bytes: u64,
    },
    WalCapacityUnavailable {
        bytes: u64,
        capability: &'static str,
    },
    InvalidConfig(String),
    Io(Error),
    Migration {
        version: u32,
        error: String,
    },
}

Errors produced by the SQLite storage backend.

Variants

RequestReadStopped(StorageError)

A request-scoped read or store acquisition stopped, or read cleanup failed.

Rusqlite(Error)

Underlying rusqlite driver error.

InvalidData(String)

Data invariant violation (corrupt row, unexpected schema state).

InheritedWriterTransaction

A pooled connection contained a transaction from an earlier owner. Its prior side effects cannot be attributed to the new request.

WriterSettlementUnknown

The writer could not prove transaction settlement before retirement.

WriterPoisoned

An earlier write on this database could not prove its settlement, so every later write is refused before it starts. Only the write whose settlement failed reports an unknown outcome; this one never ran.

WriterPoolCheckoutTimeout

The process-local writer mutex was not acquired within the pool’s configured finite checkout deadline. This stage happens before SQLite executes, so callers must not conflate it with SQLite busy/locked or checkpoint starvation.

The display text intentionally retains the historical InvalidData prefix for compatibility while the variant supplies stable structural classification (ADR-135 F6).

Fields

timeout: Duration

Pool checkout deadline that elapsed.

CapacityFloor

A file-backed writer was refused before SQLite began the operation because the volume’s free space had reached its configured reserve.

Fields

volume: String

available_bytes: u64

floor_bytes: u64

required_headroom_bytes: u64

CapacityUnavailable

A new logical write could not resolve its volume, acquire its lease, or sample available space.

Fields

phase: CapacityUnavailablePhase

message: String

VolumeLeaseReentry

The thread asking for a volume’s write lease already holds it, so waiting could never succeed. This is a nested write, not lock contention, and it is refused at once instead of at the deadline.

Fields

holder_site: String

requester_site: String

WalCeilingOffsetOverflow

A configured WAL ceiling cannot be represented by SQLite’s signed file-offset arithmetic.

Fields

bytes: u64

WalCeilingUnsupported

A WAL ceiling was enabled for a backend that cannot produce a WAL.

Fields

bytes: u64

backend_kind: &'static str

WalCeilingBelowMinimum

One committed WAL frame cannot fit, even immediately after reset.

Fields

bytes: u64

page_size: u64

minimum_bytes: u64

WalCapacityUnavailable

A valid enabled policy cannot run until its WAL I/O limiter exists.

Fields

bytes: u64

capability: &'static str

InvalidConfig(String)

A PoolConfig value violated a validated invariant at configuration load time (e.g. ADR-131 Decision 2’s write_admission_deadline_ms range). Fires before any connection is opened, and is never silently clamped into range.

Io(Error)

Filesystem I/O error.

Migration

A versioned migration failed to apply.

Fields

version: u32

The migration version number that failed.

error: String

Human-readable description of the failure.

Implementations

impl SqliteError

pub fn wal_capacity_stage(&self) -> Option<&'static str>

Stable structured stage for an ADR-194 WAL-capacity failure.

Trait Implementations

impl Debug for SqliteError

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

Formats the value using the given formatter.

impl Display for SqliteError

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

Formats the value using the given formatter.

impl Error for SqliteError

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 SqliteError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SqliteError

fn from(source: Error) -> Self

Converts to this type from the input type.