Enum ColumnarError 

#[non_exhaustive]
pub enum ColumnarError {
    Codec(CodecError),
    TruncatedSegment {
        expected: usize,
        got: usize,
    },
    InvalidMagic([u8; 4]),
    IncompatibleVersion {
        reader_major: u8,
        segment_major: u8,
        segment_minor: u8,
    },
    FooterCrcMismatch {
        stored: u32,
        computed: u32,
    },
    ColumnOutOfRange {
        index: usize,
        count: usize,
    },
    SchemaMismatch {
        expected: usize,
        got: usize,
    },
    EmptyMemtable,
    Serialization(String),
    TypeMismatch {
        column: String,
        expected: String,
    },
    JsonParse {
        column: String,
        source: Error,
    },
    RangeParse {
        column: String,
        literal: String,
    },
    MsgpackSerialize {
        column: String,
        source: Error,
    },
    MsgpackDeserialize {
        column: String,
        source: MsgpackError,
    },
    NullViolation(String),
    DuplicatePrimaryKey,
    PrimaryKeyNotFound,
    SegmentIdExhausted,
    Corruption {
        segment_id: Option<String>,
        reason: String,
        offset: Option<u64>,
    },
    MemtableCellCorrupt {
        column: String,
        row: usize,
        reason: String,
    },
    WalRowCorrupt {
        offset: usize,
        reason: String,
    },
    StringCellNotUtf8 {
        column: String,
        row: usize,
    },
    MissingKek,
    KekRequired,
    EncryptionFailed(String),
    DecryptionFailed(String),
    BudgetExhausted(MemError),
}

Errors from columnar segment encoding, decoding, and validation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Codec(CodecError)

TruncatedSegment

Fields

expected: usize

got: usize

InvalidMagic([u8; 4])

IncompatibleVersion

Fields

reader_major: u8

segment_major: u8

segment_minor: u8

FooterCrcMismatch

Fields

stored: u32

computed: u32

ColumnOutOfRange

Fields

index: usize

count: usize

SchemaMismatch

Fields

expected: usize

got: usize

EmptyMemtable

Serialization(String)

TypeMismatch

Fields

column: String

expected: String

JsonParse

Fields

column: String

source: Error

RangeParse

Fields

column: String

literal: String

MsgpackSerialize

Fields

column: String

source: Error

MsgpackDeserialize

Fields

column: String

source: MsgpackError

NullViolation(String)

DuplicatePrimaryKey

PrimaryKeyNotFound

SegmentIdExhausted

Corruption

Structural corruption detected while parsing a segment header or footer.

offset is the byte position from the start of the segment where the problem was detected. segment_id is None when the parse fails before the id can be resolved (e.g. inside the footer itself).

Fields

segment_id: Option<String>

reason: String

offset: Option<u64>

MemtableCellCorrupt

A memtable cell whose bytes do not hold a value of its declared type.

The memtable writer encodes every cell it stores, so this is in-memory corruption. The read is refused rather than answered with NULL.

Fields

column: String

row: usize

reason: String

WalRowCorrupt

A columnar WAL row whose bytes do not decode.

offset is the byte position in the row where decoding stopped. The decode is refused rather than answered with NULL or replacement characters.

Fields

offset: usize

reason: String

StringCellNotUtf8

A string column cell whose bytes are not UTF-8 at segment write time.

The memtable push stores only valid UTF-8, so these bytes were damaged in memory. The segment write is refused rather than written with wrong block statistics.

Fields

column: String

row: usize

MissingKek

Segment is encrypted (starts with SEGV) but no KEK was supplied.

KekRequired

Segment is plaintext (NDBS) but a KEK is configured (policy violation).

EncryptionFailed(String)

AES-256-GCM encryption of the segment payload failed.

DecryptionFailed(String)

AES-256-GCM decryption of the segment payload failed.

BudgetExhausted(MemError)

Memory budget exhausted or global ceiling exceeded.

Trait Implementations

impl Debug for ColumnarError

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

Formats the value using the given formatter.

impl Display for ColumnarError

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

Formats the value using the given formatter.

impl Error for ColumnarError

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<CodecError> for ColumnarError

fn from(source: CodecError) -> Self

Converts to this type from the input type.

impl From<MemError> for ColumnarError

fn from(source: MemError) -> Self

Converts to this type from the input type.