Enum Error 

pub enum Error {
    Io {
        path: PathBuf,
        source: Error,
    },
    Arrow(ArrowError),
    DictionaryFull(&'static str),
    BadMagic {
        path: PathBuf,
    },
    BadChecksum {
        path: PathBuf,
        expected: u32,
        actual: u32,
    },
    MissingMetadata {
        path: PathBuf,
        key: &'static str,
    },
    Undecodable {
        path: PathBuf,
        source: ArrowError,
    },
    NetworkFilesystem {
        path: PathBuf,
        fs: String,
    },
    NotWritable {
        path: PathBuf,
        source: Error,
    },
    WalFrameTooLarge {
        len: usize,
        max: u32,
    },
    WalCorrupt {
        path: PathBuf,
        why: &'static str,
    },
    WalVersion {
        path: PathBuf,
        found: u16,
        expected: u16,
    },
}

Variants

Io

Fields

path: PathBuf

source: Error

Arrow(ArrowError)

DictionaryFull(&'static str)

A dictionary key space filled up mid-append. The caller’s response is to seal the current block and retry into a fresh one, never to fail the RPC.

BadMagic

Fields

path: PathBuf

BadChecksum

Fields

path: PathBuf

expected: u32

actual: u32

MissingMetadata

Fields

path: PathBuf

key: &'static str

Undecodable

Every way arrow-rs can refuse a block body: a misaligned buffer, a dictionary that will not decode, a ZSTD frame that will not decompress. One variant because they arrive through one call and the source is what says which — and named for the refusal rather than for alignment, because a headline of “buffers are not aligned” over a corrupt ZSTD frame sends the reader to the wrong half of the file at 3am.

Misalignment is the case worth naming in the message anyway: it is the one Mira opts into detecting, with with_require_alignment(true). The arrow-rs default is to silently memcpy the whole body out of the mapping, turning a zero-copy read into a full allocation with no signal.

Fields

path: PathBuf

source: ArrowError

NetworkFilesystem

The data directory is on a filesystem Mira’s read path cannot survive. See block::check_filesystem.

Fields

path: PathBuf

fs: String

NotWritable

The data directory exists but cannot be written to. See block::check_writable.

Fields

path: PathBuf

source: Error

WalFrameTooLarge

An export bigger than the WAL will frame. Distinct from a corrupt length on read: this one is the caller’s fault and is answerable with a 4xx, so it must not be confused with the file being damaged.

Fields

len: usize

max: u32

WalCorrupt

A WAL frame did not survive the trip. Expected exactly once, at the tail of the last segment after a crash; anywhere else it is damage. See wal::Wal::replay for why this ends a segment rather than the process.

Fields

path: PathBuf

why: &'static str

WalVersion

A WAL segment written by a different build. Refused rather than guessed at, for the same reason a block with an unknown format version is: a frame layout is not self-describing enough to parse hopefully.

Fields

path: PathBuf

found: u16

expected: u16

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<ArrowError> for Error

fn from(source: ArrowError) -> Self

Converts to this type from the input type.