Enum SqliteStoreError 

pub enum SqliteStoreError {
    Io(Error),
    Sqlite(Error),
    SchemaFromTheFuture {
        domain: String,
        found: i64,
        supported: i64,
    },
    UnsupportedSchemaPredecessor {
        domain: String,
        found: i64,
        supported: i64,
        allowed: Vec<i64>,
    },
    SchemaFingerprintMismatch {
        domain: String,
        version: i64,
        detail: String,
    },
    UnledgeredDomainObjects {
        domain: String,
        objects: Vec<String>,
    },
    MigrationFailed {
        domain: String,
        version: i64,
        name: String,
        source: Error,
    },
    MigrationBrokeTransaction {
        domain: String,
        version: i64,
        name: String,
    },
    LedgerMalformed {
        detail: String,
    },
    WalNotEstablished {
        path: PathBuf,
        actual: String,
    },
    InvalidMigrationList {
        domain: String,
        detail: String,
    },
    OpenRefused {
        path: PathBuf,
        profile: &'static str,
        detail: String,
    },
    MaintenanceFenceHeld {
        path: PathBuf,
    },
}

Errors produced by the shared SQLite mechanics.

Variants

Io(Error)

Filesystem-level failure (creating parent directories, fence lock files, …).

Sqlite(Error)

Underlying SQLite failure.

SchemaFromTheFuture

The file’s schema ledger records a version newer than this binary supports. This is a refusal, not a corruption: a newer binary has migrated the file and this binary must not touch it. Surfaces report it as a typed, health-visible certification failure (a rollback candidate fails cleanly) rather than crash-looping.

Fields

domain: String

found: i64

supported: i64

UnsupportedSchemaPredecessor

The ledger records a real domain version, but that version is not one of the exact released predecessors this binary is willing to upgrade. This covers both versions below the compatibility floor and gaps between an allowed predecessor and the current schema. Refusal happens before schema or ledger mutation.

Fields

domain: String

found: i64

supported: i64

allowed: Vec<i64>

SchemaFingerprintMismatch

A ledger row names an otherwise allowed current or released version, but the domain-owned catalog does not exactly match that version’s frozen schema fingerprint. The row alone is not authority to reinterpret a candidate or partially migrated schema.

Fields

domain: String

version: i64

detail: String

UnledgeredDomainObjects

A file has no ledger row for a domain but already contains one or more objects owned by that domain. At the 0.8.10 compatibility floor this is neither a fresh domain nor an authenticated released predecessor: silently running idempotent DDL over it would bless an unknown or unreleased candidate schema.

Fields

domain: String

objects: Vec<String>

MigrationFailed

A registered migration failed while being applied. The surrounding transaction is rolled back; the file is left at its prior version.

Fields

domain: String

version: i64

name: String

source: Error

MigrationBrokeTransaction

A migration body ended the runner’s IMMEDIATE transaction (COMMIT or ROLLBACK, with or without re-BEGINning a fresh one), separating its schema work from the ledger stamp. Custody is verified after every body via a runner-owned savepoint; the domain is left unstamped.

Fields

domain: String

version: i64

name: String

LedgerMalformed

The meerkat_schema ledger table exists but is not the pinned shape (domain TEXT PRIMARY KEY, version INTEGER NOT NULL), carries more than one row for a domain, or records a non-positive version. This is corrupt or foreign ledger state: it is refused, never healed by re-running migrations over it.

Fields

detail: String

WalNotEstablished

The Primary profile asked SQLite to establish journal_mode=WAL and SQLite reported a different effective mode without raising an error (the journal-mode pragma can silently keep the old mode). The connection does not satisfy the profile’s durability policy.

Fields

path: PathBuf

actual: String

InvalidMigrationList

A domain registered an invalid migration list (non-contiguous or not starting at version 1). This is a programming error in the store crate, caught before any file is touched.

Fields

domain: String

detail: String

OpenRefused

The connection profile refused the requested open (for example a non-creating profile pointed at a missing file).

Fields

path: PathBuf

profile: &'static str

detail: String

MaintenanceFenceHeld

The exclusive maintenance fence is held for this database: storage is under offline maintenance and the operation must not proceed. (Also returned by crate::fence::ExclusiveFence::acquire when in-flight operations did not drain within the deadline.)

Fields

path: PathBuf

Trait Implementations

impl Debug for SqliteStoreError

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

Formats the value using the given formatter.

impl Display for SqliteStoreError

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

Formats the value using the given formatter.

impl Error for SqliteStoreError

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 SqliteStoreError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SqliteStoreError

fn from(source: Error) -> Self

Converts to this type from the input type.