Enum Error 

pub enum Error {
    InvalidInput {
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    DatasetAlreadyExists {
        uri: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    SchemaMismatch {
        difference: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    DatasetNotFound {
        path: String,
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    CorruptFile {
        path: Path,
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    NotSupported {
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    CommitConflict {
        version: u64,
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    IncompatibleTransaction {
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    RetryableCommitConflict {
        version: u64,
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    TooMuchWriteContention {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Timeout {
        message: String,
        location: &'static Location<'static>,
    },
    Internal {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    PrerequisiteFailed {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Unprocessable {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Arrow {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Schema {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    NotFound {
        uri: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    IO {
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Index {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    IndexNotFound {
        identity: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    InvalidTableLocation {
        message: String,
    },
    Stop,
    Wrapped {
        error: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Cloned {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Execution {
        message: String,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    InvalidRef {
        message: String,
    },
    RefConflict {
        message: String,
    },
    RefNotFound {
        message: String,
    },
    Cleanup {
        message: String,
    },
    VersionNotFound {
        message: String,
    },
    VersionConflict {
        message: String,
        major_version: u16,
        minor_version: u16,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    Namespace {
        source: Box<dyn Error + Send + Sync>,
        location: &'static Location<'static>,
        backtrace: MaybeBacktrace,
    },
    External {
        source: Box<dyn Error + Send + Sync>,
    },
    FieldNotFound {
        source: FieldNotFoundError,
    },
    DiskCapExceeded {
        cap_bytes: u64,
        used_bytes: u64,
        location: &'static Location<'static>,
    },
    Fenced {
        reason: FenceReason,
        message: String,
        location: &'static Location<'static>,
    },
}

Variants

InvalidInput

Fields

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

DatasetAlreadyExists

Fields

uri: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

SchemaMismatch

Fields

difference: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

DatasetNotFound

Fields

path: String

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

CorruptFile

Fields

path: Path

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

NotSupported

Fields

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

CommitConflict

Fields

version: u64

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

IncompatibleTransaction

Fields

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

RetryableCommitConflict

Fields

version: u64

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

TooMuchWriteContention

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

Timeout

Fields

message: String

location: &'static Location<'static>

Internal

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

PrerequisiteFailed

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

Unprocessable

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

Arrow

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

Schema

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

NotFound

Fields

uri: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

IO

Fields

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

Index

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

IndexNotFound

Fields

identity: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

InvalidTableLocation

Fields

message: String

Stop

Stream early stop

Wrapped

Fields

error: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

Cloned

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

Execution

Fields

message: String

location: &'static Location<'static>

backtrace: MaybeBacktrace

InvalidRef

Fields

message: String

RefConflict

Fields

message: String

RefNotFound

Fields

message: String

Cleanup

Fields

message: String

VersionNotFound

Fields

message: String

VersionConflict

Fields

message: String

major_version: u16

minor_version: u16

location: &'static Location<'static>

backtrace: MaybeBacktrace

Namespace

Fields

source: Box<dyn Error + Send + Sync>

location: &'static Location<'static>

backtrace: MaybeBacktrace

External

External error passed through from user code.

This variant preserves errors that users pass into Lance APIs (e.g., via streams with custom error types). The original error can be recovered using Error::into_external or inspected using Error::external_source.

Fields

source: Box<dyn Error + Send + Sync>

FieldNotFound

A requested field was not found in a schema.

Fields

source: FieldNotFoundError

DiskCapExceeded

Fields

cap_bytes: u64

used_bytes: u64

location: &'static Location<'static>

Fenced

A writer has been fenced and must stop (see FenceReason). The message keeps the Writer fenced prefix for legacy string consumers; new code should match on Error::fence_reason.

Fields

reason: FenceReason

message: String

location: &'static Location<'static>

Implementations

impl Error

pub fn backtrace(&self) -> Option<&Backtrace>

Returns the captured Rust backtrace, if available.

Always returns None when the backtrace feature is not enabled.

pub fn corrupt_file(path: Path, message: impl Into<String>) -> Error

pub fn corrupt_file_named(name: &str, message: impl Into<String>) -> Error

Reports a corrupt file when the caller only has a logical/section name rather than the real file path (for example, a decoder that validates an in-memory buffer and does not know where it came from).

name is carried in the path field of the resulting Error::CorruptFile variant and is NOT a filesystem path; callers that have the real path should use Self::corrupt_file instead.

pub fn invalid_input(message: impl Into<String>) -> Error

pub fn invalid_input_source(source: Box<dyn Error + Send + Sync>) -> Error

pub fn io(message: impl Into<String>) -> Error

pub fn fenced_by_peer(message: impl Into<String>) -> Error

A successor writer claimed a higher epoch; this writer lost ownership.

pub fn writer_poisoned(message: impl Into<String>) -> Error

Our WAL persistence failed; in-memory state may have diverged from the durable WAL, so the writer must be reopened to replay.

pub fn fence_reason(&self) -> Option<FenceReason>

The FenceReason if this is Error::Fenced, else None. Prefer this over matching the error message to decide how to react to a fence.

pub fn io_source(source: Box<dyn Error + Send + Sync>) -> Error

pub fn dataset_already_exists(uri: impl Into<String>) -> Error

pub fn dataset_not_found( path: impl Into<String>, source: Box<dyn Error + Send + Sync>, ) -> Error

pub fn version_conflict( message: impl Into<String>, major_version: u16, minor_version: u16, ) -> Error

pub fn not_found(uri: impl Into<String>) -> Error

pub fn is_not_found(&self) -> bool

Return whether this error or one of its typed sources is a missing object.

pub fn wrapped(error: Box<dyn Error + Send + Sync>) -> Error

pub fn schema(message: impl Into<String>) -> Error

pub fn not_supported(message: impl Into<String>) -> Error

pub fn not_supported_source(source: Box<dyn Error + Send + Sync>) -> Error

pub fn internal(message: impl Into<String>) -> Error

pub fn timeout(message: impl Into<String>) -> Error

pub fn namespace(message: impl Into<String>) -> Error

pub fn namespace_source(source: Box<dyn Error + Send + Sync>) -> Error

pub fn arrow(message: impl Into<String>) -> Error

pub fn execution(message: impl Into<String>) -> Error

pub fn cloned(message: impl Into<String>) -> Error

pub fn schema_mismatch(difference: impl Into<String>) -> Error

pub fn unprocessable(message: impl Into<String>) -> Error

pub fn too_much_write_contention(message: impl Into<String>) -> Error

pub fn prerequisite_failed(message: impl Into<String>) -> Error

pub fn index(message: impl Into<String>) -> Error

pub fn index_not_found(identity: impl Into<String>) -> Error

pub fn commit_conflict_source( version: u64, source: Box<dyn Error + Send + Sync>, ) -> Error

pub fn retryable_commit_conflict_source( version: u64, source: Box<dyn Error + Send + Sync>, ) -> Error

pub fn incompatible_transaction_source( source: Box<dyn Error + Send + Sync>, ) -> Error

pub fn disk_cap_exceeded(cap_bytes: u64, used_bytes: u64) -> Error

pub fn external(source: Box<dyn Error + Send + Sync>) -> Error

Create an External error from a boxed error source.

pub fn field_not_found( field_name: impl Into<String>, candidates: Vec<String>, ) -> Error

Create a FieldNotFound error with the given field name and available candidates.

pub fn external_source(&self) -> Option<&Box<dyn Error + Send + Sync>>

Returns a reference to the external error source if this is an External variant.

This allows downcasting to recover the original error type.

pub fn into_external(self) -> Result<Box<dyn Error + Send + Sync>, Error>

Consumes the error and returns the external source if this is an External variant.

Returns Err(self) if this is not an External variant, allowing for chained handling.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

where Error: Debug + Display,

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

fn backtrace(&self) -> Option<&Backtrace>

Returns a Backtrace that may be printed.

fn iter_chain(&self) -> ChainCompat<'_, '_>

where Self: AsErrorSource,

Returns an iterator for traversing the chain of errors, starting with the current error and continuing with recursive calls to Error::source.

impl From<&ArrowError> for Error

fn from(e: &ArrowError) -> Error

Converts to this type from the input type.

impl From<ArrowError> for Error

fn from(e: ArrowError) -> Error

Converts to this type from the input type.

impl From<Box<dyn Error + Send + Sync>> for Error

where Box<dyn Error + Send + Sync>: Into<Box<dyn Error + Send + Sync>>,

fn from(error: Box<dyn Error + Send + Sync>) -> Error

Converts to this type from the input type.

impl From<CommitError> for Error

fn from(e: CommitError) -> Error

Converts to this type from the input type.

impl From<DataFusionError> for Error

Available on crate feature datafusion only.

fn from(e: DataFusionError) -> Error

Converts to this type from the input type.

impl From<DecodeError> for Error

fn from(e: DecodeError) -> Error

Converts to this type from the input type.

impl From<EncodeError> for Error

fn from(e: EncodeError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Error

Converts to this type from the input type.

impl From<FieldNotFoundError> for Error

where FieldNotFoundError: Into<FieldNotFoundError>,

fn from(error: FieldNotFoundError) -> Error

Converts to this type from the input type.

impl From<JoinError> for Error

fn from(e: JoinError) -> Error

Converts to this type from the input type.

impl From<NamespaceError> for Error

Converts a NamespaceError into a lance_core::Error.

The original NamespaceError is preserved in the source field and can be extracted via downcasting for programmatic error handling.

fn from(err: NamespaceError) -> Error

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(e: ParseError) -> Error

Converts to this type from the input type.

impl From<ParserError> for Error

Available on crate feature datafusion only.

fn from(e: ParserError) -> Error

Converts to this type from the input type.

impl From<TokenizerError> for Error

Available on crate feature datafusion only.

fn from(e: TokenizerError) -> Error

Converts to this type from the input type.

impl From<UnknownEnumValue> for Error

fn from(e: UnknownEnumValue) -> Error

Converts to this type from the input type.