#[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
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.
Arrow(ArrowError)
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
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
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)
default-engine-base only.An error enountered while working with parquet data
ObjectStore(Error)
default-engine-base only.An error interacting with the object_store crate
ObjectStorePath(Error)
default-engine-base only.An error working with paths from the object_store crate
Reqwest(Error)
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
declarative-plans only.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
impl Error
pub fn generic_err(source: impl Into<Box<dyn Error + Send + Sync>>) -> Self
pub fn generic(msg: impl ToString) -> Self
pub fn file_not_found(path: impl ToString) -> Self
pub fn missing_column(name: impl ToString) -> Self
pub fn unexpected_column_type(name: impl ToString) -> Self
pub fn invalid_partition_values(msg: impl ToString) -> Self
pub fn missing_data(name: impl ToString) -> Self
pub fn deletion_vector(msg: impl ToString) -> Self
pub fn engine_data_type(msg: impl ToString) -> Self
pub fn join_failure(msg: impl ToString) -> Self
pub fn invalid_table_location(location: impl ToString) -> Self
pub fn invalid_column_mapping_mode(mode: impl ToString) -> Self
pub fn invalid_decimal(msg: impl ToString) -> Self
pub fn invalid_geo_params(msg: impl ToString) -> Self
geo-type-in-dev only.pub fn invalid_struct_data(msg: impl ToString) -> Self
pub fn invalid_expression(msg: impl ToString) -> Self
pub fn internal_error(msg: impl ToString) -> Self
pub fn invalid_protocol(msg: impl ToString) -> Self
pub fn invalid_transaction_state(msg: impl ToString) -> Self
pub fn unsupported(msg: impl ToString) -> Self
pub fn change_data_feed_unsupported(version: impl Into<Version>) -> Self
pub fn invalid_checkpoint(msg: impl ToString) -> Self
pub fn schema(msg: impl ToString) -> Self
pub fn stats_validation(msg: impl ToString) -> Self
pub fn plan_result_type_mismatch( expected: &'static str, actual: &'static str, ) -> Self
declarative-plans only.pub fn with_backtrace(self) -> Self
Trait Implementations§
Source§impl Error for Error
impl Error for Error
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()
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.
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
fn from(value: Infallible) -> Self
Source§impl From<ArrowError> for Error
Available on crate feature default-engine-base only.
impl From<ArrowError> for Error
default-engine-base only.Source§fn from(value: ArrowError) -> Self
fn from(value: ArrowError) -> Self
Source§impl From<Box<LogHistoryError>> for Error
impl From<Box<LogHistoryError>> for Error
Source§fn from(source: Box<LogHistoryError>) -> Self
fn from(source: Box<LogHistoryError>) -> Self
Source§impl From<LogHistoryError> for Error
impl From<LogHistoryError> for Error
Source§fn from(e: LogHistoryError) -> Self
fn from(e: LogHistoryError) -> Self
Source§impl From<ParquetError> for Error
impl From<ParquetError> for Error
Source§fn from(source: ParquetError) -> Self
fn from(source: ParquetError) -> Self
Source§impl From<ParseError> for Error
impl From<ParseError> for Error
Source§fn from(source: ParseError) -> Self
fn from(source: ParseError) -> Self
Source§impl From<ParseIntError> for Error
impl From<ParseIntError> for Error
Source§fn from(source: ParseIntError) -> Self
fn from(source: ParseIntError) -> Self
Source§impl From<ParseIntervalError> for Error
impl From<ParseIntervalError> for Error
Source§fn from(source: ParseIntervalError) -> Self
fn from(source: ParseIntervalError) -> Self
Source§impl From<ScalarConversionError> for Error
impl From<ScalarConversionError> for Error
Source§fn from(source: ScalarConversionError) -> Self
fn from(source: ScalarConversionError) -> Self
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> AsAny for T
impl<T> AsAny for T
Source§fn any_ref(&self) -> &(dyn Any + Sync + Send + 'static)
fn any_ref(&self) -> &(dyn Any + Sync + Send + 'static)
dyn Any reference to the object: Read moreSource§fn as_any(self: Arc<T>) -> Arc<dyn Any + Sync + Send> ⓘ
fn as_any(self: Arc<T>) -> Arc<dyn Any + Sync + Send> ⓘ
Arc<dyn Any> reference to the object: Read moreSource§fn into_any(self: Box<T>) -> Box<dyn Any + Sync + Send>
fn into_any(self: Box<T>) -> Box<dyn Any + Sync + Send>
Box<dyn Any>: Read moreSource§fn type_name(&self) -> &'static str
fn type_name(&self) -> &'static str
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> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> FoldWithOption for T
impl<T> FoldWithOption for T
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
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 moreSource§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
Source§impl<T> ToStringFallible for Twhere
T: Display,
impl<T> ToStringFallible for Twhere
T: Display,
Source§fn try_to_string(&self) -> Result<String, TryReserveError>
fn try_to_string(&self) -> Result<String, TryReserveError>
ToString::to_string, but without panic on OOM.
Source§impl<KernelType, ArrowType> TryIntoArrow<ArrowType> for KernelTypewhere
ArrowType: TryFromKernel<KernelType>,
impl<KernelType, ArrowType> TryIntoArrow<ArrowType> for KernelTypewhere
ArrowType: TryFromKernel<KernelType>,
Source§fn try_into_arrow(self) -> Result<ArrowType, ArrowError>
fn try_into_arrow(self) -> Result<ArrowType, ArrowError>
arrow-conversion and (crate features arrow-conversion or declarative-plans or default-engine-base) only.Source§impl<KernelType, ArrowType> TryIntoKernel<KernelType> for ArrowTypewhere
KernelType: TryFromArrow<ArrowType>,
impl<KernelType, ArrowType> TryIntoKernel<KernelType> for ArrowTypewhere
KernelType: TryFromArrow<ArrowType>,
Source§fn try_into_kernel(self) -> Result<KernelType, ArrowError>
fn try_into_kernel(self) -> Result<KernelType, ArrowError>
arrow-conversion and (crate features arrow-conversion or declarative-plans or default-engine-base) only.