Skip to main content

Error

Enum Error 

Source
#[non_exhaustive]
pub enum Error {
Show 56 variants Backtraced { source: Box<Self>, backtrace: Box<Backtrace>, }, Arrow(ArrowError), CheckpointWrite(String), EngineDataType(String), Extract(&'static str, &'static str), ScalarConversion(ScalarConversionError), Generic(String), GenericError { source: Box<dyn Error + Send + Sync + 'static>, }, MaxCatalogVersion(String), LogTailVersionsNotContiguous { first_version: Version, second_version: Version, }, IOError(Error), InternalError(String), Parquet(ParquetError), ObjectStore(Error), ObjectStorePath(Error), Reqwest(Error), FileNotFound(String), MissingColumn(String), InvalidPartitionValues(String), UnexpectedColumnType(String), MissingData(String), MissingVersion, DeletionVector(String), InvalidSelectionVector(String), InvalidTransactionState(String), InvalidUrl(ParseError), MalformedJson(Error), MissingMetadata, MissingProtocol, InvalidProtocol(String), MissingMetadataAndProtocol, ParseError(String, DataType), JoinFailure(String), Utf8Error(Utf8Error), ParseIntError(ParseIntError), InvalidColumnMappingMode(String), InvalidTableLocation(String), InvalidDecimal(String), InvalidGeoParams(String), InvalidStructData(String), InvalidExpressionEvaluation(String), InvalidLogPath(String), FileAlreadyExists(String), Unsupported(String), ChecksumWriteUnsupported(String), ParseIntervalError(ParseIntervalError), ChangeDataFeedUnsupported(Version), RowTrackingChangeFeedUnsupported(Version), ChangeDataFeedIncompatibleSchema(String, String), InvalidCheckpoint(String), LiteralExpressionTransformError(Error), Schema(String), StatsValidation(String), LogHistory(Box<LogHistoryError>), PlanResultTypeMismatch { expected: &'static str, actual: &'static str, }, Cancelled,
}
Expand description

All the types of errors that the kernel can run into

Variants (Non-exhaustive)§

This enum is marked as 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.
§

Backtraced

This is an error that includes a backtrace. To have a particular type of error include such backtrace (when RUST_BACKTRACE=1), annotate the error with #[error(transparent)] and then add the error type and enum variant to the from_with_backtrace! macro invocation below. See IOError for an example.

Fields

§source: Box<Self>
§backtrace: Box<Backtrace>
§

Arrow(ArrowError)

Available on crate feature default-engine-base only.

An error performing operations on arrow data

§

CheckpointWrite(String)

§

EngineDataType(String)

User tried to convert engine data to the wrong type

§

Extract(&'static str, &'static str)

Could not extract the specified type

§

ScalarConversion(ScalarConversionError)

A scalar could not be converted into the requested Rust value.

§

Generic(String)

A generic error with a message

§

GenericError

A generic error wrapping another error

Fields

§source: Box<dyn Error + Send + Sync + 'static>

Source error

§

MaxCatalogVersion(String)

An error involving the maximum catalog-ratified version when building a snapshot.

§

LogTailVersionsNotContiguous

The supplied log tail contains adjacent versions that are not contiguous.

Fields

§first_version: Version

Earlier version in the invalid adjacent pair.

§second_version: Version

Later version in the invalid adjacent pair.

§

IOError(Error)

Some kind of std::io::Error

§

InternalError(String)

An internal error that means kernel found an unexpected situation, which is likely a bug

§

Parquet(ParquetError)

Available on crate feature default-engine-base only.

An error enountered while working with parquet data

§

ObjectStore(Error)

Available on crate feature default-engine-base only.

An error interacting with the object_store crate

§

ObjectStorePath(Error)

Available on crate feature default-engine-base only.

An error working with paths from the object_store crate

§

Reqwest(Error)

Available on crate feature default-engine-base only.
§

FileNotFound(String)

A specified file could not be found

§

MissingColumn(String)

A column was requested, but not found

§

InvalidPartitionValues(String)

The connector-provided partition values are invalid (missing/extra/duplicate keys, or a value type does not match the schema column type).

§

UnexpectedColumnType(String)

A column was specified with a specific type, but it is not of that type

§

MissingData(String)

Data was expected, but not found

§

MissingVersion

A version for the delta table could not be found in the log

§

DeletionVector(String)

An error occurred while working with deletion vectors

§

InvalidSelectionVector(String)

A selection vector is larger than data length

§

InvalidTransactionState(String)

Transaction state is invalid for the requested operation

§

InvalidUrl(ParseError)

A specified URL was invalid

§

MalformedJson(Error)

serde encountered malformed json

§

MissingMetadata

There was no metadata action in the delta log

§

MissingProtocol

There was no protocol action in the delta log

§

InvalidProtocol(String)

Invalid protocol action was read from the log

§

MissingMetadataAndProtocol

Neither metadata nor protocol could be found in the delta log

§

ParseError(String, DataType)

A string failed to parse as the specified data type

§

JoinFailure(String)

A tokio executor failed to join a task

§

Utf8Error(Utf8Error)

Could not convert to string from utf-8

§

ParseIntError(ParseIntError)

Could not parse an integer

§

InvalidColumnMappingMode(String)

§

InvalidTableLocation(String)

Asked for a table at an invalid location

§

InvalidDecimal(String)

Precision or scale not compliant with delta specification

§

InvalidGeoParams(String)

Invalid CRS or other parameter for a Geometry / Geography type

§

InvalidStructData(String)

Inconsistent data passed to struct scalar

§

InvalidExpressionEvaluation(String)

Expressions did not parse or evaluate correctly

§

InvalidLogPath(String)

Unable to parse the name of a log path

§

FileAlreadyExists(String)

The file already exists at the path, prohibiting a non-overwrite write

§

Unsupported(String)

Some functionality is currently unsupported

§

ChecksumWriteUnsupported(String)

Cannot write a version checksum (CRC) file for this snapshot

§

ParseIntervalError(ParseIntervalError)

Parsing error when attempting to deserialize an interval

§

ChangeDataFeedUnsupported(Version)

§

RowTrackingChangeFeedUnsupported(Version)

Row tracking (delta.enableRowTracking) must be enabled for the entire version range of a row-tracking change feed, but it is not enabled at the given version.

§

ChangeDataFeedIncompatibleSchema(String, String)

§

InvalidCheckpoint(String)

Invalid checkpoint files

§

LiteralExpressionTransformError(Error)

Error while transforming a schema + leaves into an Expression of literals

§

Schema(String)

Schema mismatch has occurred or invalid/not-kernel-supported schema used somewhere

§

StatsValidation(String)

Validation error for file statistics (e.g., missing required clustering column stats)

§

LogHistory(Box<LogHistoryError>)

Error during log history operations (timestamp queries, version lookups)

§

PlanResultTypeMismatch

Available on crate feature declarative-plans only.

Fields

§expected: &'static str
§actual: &'static str
§

Cancelled

The operation was cancelled via a CancellationToken.

Surfaced by cancellation-aware reads as a terminal error, distinct from normal iterator exhaustion. See CancellableIterator for the enforced contract.

Implementations§

Source§

impl Error

Source

pub fn generic_err(source: impl Into<Box<dyn Error + Send + Sync>>) -> Self

Source

pub fn generic(msg: impl ToString) -> Self

Source

pub fn file_not_found(path: impl ToString) -> Self

Source

pub fn missing_column(name: impl ToString) -> Self

Source

pub fn unexpected_column_type(name: impl ToString) -> Self

Source

pub fn invalid_partition_values(msg: impl ToString) -> Self

Source

pub fn missing_data(name: impl ToString) -> Self

Source

pub fn deletion_vector(msg: impl ToString) -> Self

Source

pub fn engine_data_type(msg: impl ToString) -> Self

Source

pub fn join_failure(msg: impl ToString) -> Self

Source

pub fn invalid_table_location(location: impl ToString) -> Self

Source

pub fn invalid_column_mapping_mode(mode: impl ToString) -> Self

Source

pub fn invalid_decimal(msg: impl ToString) -> Self

Source

pub fn invalid_geo_params(msg: impl ToString) -> Self

Available on crate feature geo-type-in-dev only.
Source

pub fn invalid_struct_data(msg: impl ToString) -> Self

Source

pub fn invalid_expression(msg: impl ToString) -> Self

Source

pub fn internal_error(msg: impl ToString) -> Self

Source

pub fn invalid_protocol(msg: impl ToString) -> Self

Source

pub fn invalid_transaction_state(msg: impl ToString) -> Self

Source

pub fn unsupported(msg: impl ToString) -> Self

Source

pub fn change_data_feed_unsupported(version: impl Into<Version>) -> Self

Source

pub fn invalid_checkpoint(msg: impl ToString) -> Self

Source

pub fn schema(msg: impl ToString) -> Self

Source

pub fn stats_validation(msg: impl ToString) -> Self

Source

pub fn plan_result_type_mismatch( expected: &'static str, actual: &'static str, ) -> Self

Available on crate feature declarative-plans only.
Source

pub fn with_backtrace(self) -> Self

Trait Implementations§

Source§

impl Debug for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for Error

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl From<!> for Error

This impl is needed so the ? operator can auto-convert Result<T, Infallible> to DeltaResult<T>. For example, TryFrom impls for infallible conversions use Infallible as their error type, and this allows those results to be propagated with ? in functions returning DeltaResult. The match is unreachable since Infallible has no variants.

Source§

fn from(value: Infallible) -> Self

Converts to this type from the input type.
Source§

impl From<ArrowError> for Error

Available on crate feature default-engine-base only.
Source§

fn from(value: ArrowError) -> Self

Converts to this type from the input type.
Source§

impl From<Box<LogHistoryError>> for Error

Source§

fn from(source: Box<LogHistoryError>) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(source: Error) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(source: Error) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(value: Error) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(value: Error) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Available on crate feature default-engine-base only.
Source§

fn from(value: Error) -> Self

Converts to this type from the input type.
Source§

impl From<LogHistoryError> for Error

Source§

fn from(e: LogHistoryError) -> Self

Converts to this type from the input type.
Source§

impl From<ParquetError> for Error

Source§

fn from(source: ParquetError) -> Self

Converts to this type from the input type.
Source§

impl From<ParseError> for Error

Source§

fn from(source: ParseError) -> Self

Converts to this type from the input type.
Source§

impl From<ParseIntError> for Error

Source§

fn from(source: ParseIntError) -> Self

Converts to this type from the input type.
Source§

impl From<ParseIntervalError> for Error

Source§

fn from(source: ParseIntervalError) -> Self

Converts to this type from the input type.
Source§

impl From<ScalarConversionError> for Error

Source§

fn from(source: ScalarConversionError) -> Self

Converts to this type from the input type.
Source§

impl From<Utf8Error> for Error

Source§

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Error

§

impl !UnwindSafe for Error

§

impl Freeze for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnsafeUnpin for Error

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AsAny for T
where T: Any + Send + Sync,

Source§

fn any_ref(&self) -> &(dyn Any + Sync + Send + 'static)

Obtains a dyn Any reference to the object: Read more
Source§

fn as_any(self: Arc<T>) -> Arc<dyn Any + Sync + Send> ⓘ

Obtains an Arc<dyn Any> reference to the object: Read more
Source§

fn into_any(self: Box<T>) -> Box<dyn Any + Sync + Send>

Converts the object to Box<dyn Any>: Read more
Source§

fn type_name(&self) -> &'static str

Convenient wrapper for std::any::type_name, since Any does not provide it and Any::type_id is useless as a debugging aid (its Debug is just a mess of hex digits).
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> FoldWithOption for T

Source§

fn fold_with<U>(self, opt: Option<U>, f: impl FnOnce(Self, U) -> Self) -> Self

Available on crate feature internal-api only.
Applies an optional fold operation f to self if opt is Some; otherwise returns self unchanged. Read more
Source§

fn try_fold_with<U, E>( self, opt: Option<U>, f: impl FnOnce(Self, U) -> Result<Self, E>, ) -> Result<Self, E>

Available on crate feature internal-api only.
Fallible fold_with: applies Result-returning f to self if opt is Some, otherwise returns self unchanged (wrapped in Ok).
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T> ToStringFallible for T
where T: Display,

Source§

fn try_to_string(&self) -> Result<String, TryReserveError>

ToString::to_string, but without panic on OOM.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<KernelType, ArrowType> TryIntoArrow<ArrowType> for KernelType
where ArrowType: TryFromKernel<KernelType>,

Source§

fn try_into_arrow(self) -> Result<ArrowType, ArrowError>

Available on crate feature arrow-conversion and (crate features arrow-conversion or declarative-plans or default-engine-base) only.
Source§

impl<KernelType, ArrowType> TryIntoKernel<KernelType> for ArrowType
where KernelType: TryFromArrow<ArrowType>,

Source§

fn try_into_kernel(self) -> Result<KernelType, ArrowError>

Available on crate feature arrow-conversion and (crate features arrow-conversion or declarative-plans or default-engine-base) only.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more