Enum Error 

pub enum Error {
    NotFound,
    TxnClosed,
    TxnReadOnly,
    TxnConflict,
    Io(Error),
    InvalidFormat(String),
    ChecksumMismatch,
    RecoveryIncomplete {
        recovered_entries: usize,
        stop_offset: u64,
        reason: String,
    },
    CorruptedSegment {
        segment_id: u64,
        reason: String,
    },
    DimensionMismatch {
        expected: usize,
        actual: usize,
    },
    UnsupportedMetric {
        metric: String,
    },
    InvalidVector {
        index: usize,
        reason: String,
    },
    InvalidFilter(String),
    MemoryLimitExceeded {
        limit: usize,
        requested: usize,
    },
    SpillFailed {
        reason: String,
    },
    CastFailed {
        from_type: String,
        to_type: String,
        reason: String,
    },
    PathExists(PathBuf),
    AlreadyOpen {
        path: PathBuf,
        lock_path: PathBuf,
        holder: String,
    },
    InvalidParameter {
        param: String,
        reason: String,
    },
    IndexNotFound {
        name: String,
    },
    CorruptedIndex {
        name: String,
        reason: String,
    },
    UnsupportedIndexVersion {
        found: u32,
        supported: u32,
    },
    UnknownOption {
        key: String,
    },
    InvalidColumnType {
        column: String,
        expected: String,
    },
    IndexBusy {
        operation: String,
    },
    Columnar(ColumnarError),
    ContainerFormat(FormatError),
    S3(String),
    MissingCredentials(String),
}

The error type for AlopexDB operations.

Variants

NotFound

The requested key was not found.

TxnClosed

The transaction has already been closed (committed or rolled back).

TxnReadOnly

Read-only トランザクションで書き込み操作を試みた。

TxnConflict

A transaction conflict occurred (e.g., optimistic concurrency control failure).

Io(Error)

An underlying I/O error occurred.

InvalidFormat(String)

The on-disk format is invalid or corrupted.

ChecksumMismatch

A checksum validation failed.

RecoveryIncomplete

WAL recovery stopped before completion.

Fields

recovered_entries: usize

Number of entries recovered before stopping.

stop_offset: u64

Byte offset where recovery stopped.

reason: String

Reason for stopping.

CorruptedSegment

On-disk segment is corrupted (e.g., checksum failure).

Fields

segment_id: u64

Segment identifier.

reason: String

Reason for corruption detection.

DimensionMismatch

A vector with an unexpected dimension was provided.

Fields

expected: usize

Expected dimension.

actual: usize

Dimension of the provided vector.

UnsupportedMetric

A metric that is not supported was requested.

Fields

metric: String

Name of the unsupported metric.

InvalidVector

A vector value is invalid for the requested operation.

Fields

index: usize

Zero-based index of the offending vector.

reason: String

Reason for invalidation.

InvalidFilter(String)

A filter expression is malformed or unsupported.

MemoryLimitExceeded

Memory usage exceeded configured limit.

Fields

limit: usize

Maximum allowed memory (bytes).

requested: usize

Requested memory (bytes) that triggered the limit.

SpillFailed

External spill operation failed.

Fields

reason: String

Stable failure description.

CastFailed

A DataFrame scalar cast failed.

Fields

from_type: String

Source type name.

to_type: String

Target type name.

reason: String

Stable failure code.

PathExists(PathBuf)

The provided path already exists and cannot be overwritten.

AlreadyOpen

The data directory is already open somewhere else (issue #181).

Alopex’s storage engine has exactly one writer per data directory: the WAL is a fixed-length ring addressed from an in-memory offset and SSTable ids come from a process-local counter, so a second writer overwrites the first one’s bytes. Opening therefore takes an OS-level exclusive lock, and this is what a caller that lost the race sees.

The message deliberately contains the stable, greppable phrase already open by another process; tests and user-facing tooling match on that substring rather than on the whole rendering, which varies with the holder diagnostics (unavailable on Windows — see 裁定 D10).

Fields

path: PathBuf

The data directory that could not be opened.

lock_path: PathBuf

The lock file guarding it.

holder: String

Best-effort description of the current holder, or unknown.

InvalidParameter

An index configuration parameter is invalid.

Fields

param: String

Name of the invalid parameter.

reason: String

Description of the expected range or constraint.

IndexNotFound

An index with the requested name was not found.

Fields

name: String

Name of the missing index.

CorruptedIndex

An index failed integrity checks.

Fields

name: String

Name of the corrupted index.

reason: String

Description of the corruption.

UnsupportedIndexVersion

The stored index version is unsupported by this binary.

Fields

found: u32

Version detected in storage.

supported: u32

Highest supported version.

UnknownOption

An unknown configuration or runtime option was provided.

Fields

key: String

Name of the option.

InvalidColumnType

A column type does not match the expected layout.

Fields

column: String

Column name.

expected: String

Expected type description.

IndexBusy

The index is busy and cannot serve the requested operation.

Fields

operation: String

Operation that was attempted.

Columnar(ColumnarError)

Errors originating from columnar components.

ContainerFormat(FormatError)

The unified .alopex container format rejected a read or write.

S3(String)

An S3 operation failed.

MissingCredentials(String)

Required credentials are missing.

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

fn from(source: ColumnarError) -> Self

Converts to this type from the input type.

impl From<Error> for ColumnarError

fn from(err: CoreError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FormatError> for Error

fn from(source: FormatError) -> Self

Converts to this type from the input type.