Enum VectorError 

#[non_exhaustive]
pub enum VectorError {
    BudgetExhausted(MemError),
    DimensionMismatch {
        expected: usize,
        got: usize,
    },
    StoredDimensionMismatch {
        expected: usize,
        got: usize,
    },
    InvalidFilterBitmap {
        detail: String,
    },
    InvalidInput {
        detail: String,
    },
    VectorUnavailable {
        id: u32,
    },
    VectorDecodeFailed {
        id: u32,
        detail: String,
    },
    UnsupportedVersion {
        found: u8,
        expected: u8,
    },
    InvalidMagic,
    DeserializationFailed(String),
    CheckpointEncryptedNoKey,
    CheckpointPlaintextKeyRequired,
    CheckpointEncryptionError {
        detail: String,
    },
    CheckpointSerializationError {
        detail: String,
    },
    CheckpointDeserializationError {
        detail: String,
    },
    SegmentIo(Error),
}

Errors from vector index operations.

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.

BudgetExhausted(MemError)

DimensionMismatch

An input vector — a search query or an inserted vector — has a different dimension from the index. The caller’s input is wrong; the index is intact.

Fields

expected: usize

got: usize

StoredDimensionMismatch

Stored data — a PQ code, a segment backing, a materialized node vector — disagrees with the index dimension. The stored data is corrupt or belongs to another index.

Fields

expected: usize

got: usize

InvalidFilterBitmap

A serialized pre-filter bitmap does not decode. Searching without it would return rows the filter excludes, so the search fails instead.

Fields

detail: String

InvalidInput

An index build or training call received input it cannot use: an empty training set, a zero dimension, or parameters that do not fit.

Fields

detail: String

VectorUnavailable

A node’s vector could not be materialized: the node is out of range, or its local storage is empty and no segment backing supplies the data.

An empty local storage means the index was restored from a graph-only checkpoint; the vectors live in an external segment that must be attached with crate::HnswIndex::with_backing before any caller copies vectors out of the index.

Fields

id: u32

VectorDecodeFailed

A node’s dtype-encoded bytes could not be decoded to f32.

Fields

id: u32

detail: String

UnsupportedVersion

Fields

found: u8

expected: u8

InvalidMagic

DeserializationFailed(String)

CheckpointEncryptedNoKey

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

CheckpointPlaintextKeyRequired

Checkpoint file is plaintext but a KEK was configured (policy violation).

CheckpointEncryptionError

AES-256-GCM encryption/decryption or envelope framing of a checkpoint failed.

Fields

detail: String

CheckpointSerializationError

rkyv or MessagePack serialization of a vector checkpoint failed.

Fields

detail: String

CheckpointDeserializationError

rkyv or MessagePack deserialization of a vector checkpoint failed.

Fields

detail: String

SegmentIo(Error)

I/O error from segment file operations (open, mmap, metadata).

Trait Implementations

impl Debug for VectorError

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

Formats the value using the given formatter.

impl Display for VectorError

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

Formats the value using the given formatter.

impl Error for VectorError

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 VectorError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<MemError> for VectorError

fn from(source: MemError) -> Self

Converts to this type from the input type.