Enum StoreError 

pub enum StoreError {
    Io(Error),
    PageCorrupted {
        page_id: PageId,
        expected: u32,
        actual: u32,
    },
    KeyTooLong {
        len: usize,
        max: usize,
    },
    ValueTooLarge {
        len: usize,
        max: usize,
    },
    InvalidPageMagic {
        expected: u32,
        actual: u32,
    },
    UnsupportedPageVersion(u8),
    InvalidSuperblockMagic,
    SuperblockCorrupted,
    NonSequentialBatch {
        expected: u64,
        actual: u64,
    },
    TableNotFound(TableId),
    PageOverflow {
        needed: usize,
        available: usize,
    },
    EntryTooLarge {
        key: Key,
        entry_size: usize,
        page_budget: usize,
    },
    BTreeInvariant(String),
    DuplicateKey(Key),
    PageNotFound(PageId),
    ReadOnly,
}

Errors that can occur during store operations.

Variants

Io(Error)

Filesystem I/O error.

PageCorrupted

Page CRC32 checksum mismatch - data corruption detected.

Fields

page_id: PageId

expected: u32

actual: u32

KeyTooLong

Key exceeds maximum allowed length.

Fields

len: usize

max: usize

ValueTooLarge

Value exceeds maximum size that fits in a page.

Fields

len: usize

max: usize

InvalidPageMagic

Page has invalid magic bytes.

Fields

expected: u32

actual: u32

UnsupportedPageVersion(u8)

Page has unsupported version.

InvalidSuperblockMagic

Superblock has invalid magic bytes.

SuperblockCorrupted

Superblock CRC mismatch.

NonSequentialBatch

Batch position is not sequential.

Fields

expected: u64

actual: u64

TableNotFound(TableId)

Table not found.

PageOverflow

Page overflow - not enough space for insert.

Fields

needed: usize

available: usize

EntryTooLarge

A single B+tree leaf entry (one key + its version chain) has grown larger than what fits on a page, so splitting the leaf can’t help. The typical cause is repeated upsert-in-place on the same primary key — every overwrite appends a version to the MVCC chain, so a hot row that’s updated dozens of times accumulates a chain whose serialized_size exceeds the page byte budget.

v0.9.0 surfaced this as the generic StoreError::PageOverflow inside to_page, which left callers with no actionable signal. v0.9.1 promotes it to a typed variant carrying the offending key + sizes so the SDK can render a clear error and the operator can pinpoint the hot row. Proper version-chain compaction driven by a retention horizon is v0.10.0 work.

Fields

key: Key

The key whose version chain exceeded the page budget.

entry_size: usize

Total serialized size of the leaf entry (key + version chain

• per-version overhead).

page_budget: usize

The page-level byte budget the entry must fit into. Equal to PAGE_SIZE - PAGE_HEADER_SIZE - CRC_SIZE.

BTreeInvariant(String)

Internal B+tree invariant violation.

DuplicateKey(Key)

Duplicate key in batch.

PageNotFound(PageId)

Page not found in cache or on disk.

ReadOnly

Store is read-only.

Trait Implementations

impl Debug for StoreError

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

Formats the value using the given formatter.

impl Display for StoreError

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

Formats the value using the given formatter.

impl Error for StoreError

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 StoreError

fn from(source: Error) -> Self

Converts to this type from the input type.