Enum SegmentCoverageError 

#[non_exhaustive]
pub enum SegmentCoverageError {
    Storage {
        path: String,
        source: StorageError,
    },
    ParquetRead {
        path: String,
        source: ParquetError,
        backtrace: Backtrace,
    },
    RowGroupTask {
        path: String,
        source: JoinError,
        backtrace: Backtrace,
    },
    OrderedIndexColumn {
        source: ParquetIndexColumnError,
    },
    IndexValue {
        path: String,
        column: String,
        expected_domain: &'static str,
        detail: String,
    },
    IndexIntervalMapping {
        path: String,
        source: IndexIntervalMappingError,
    },
    DuplicateIndexInterval {
        path: String,
        example_identity: Option<EntityIdentity>,
        example_index_interval: IndexInterval,
    },
    EntityColumnNotFound {
        path: String,
        column: String,
    },
    EntityColumnUnsupportedType {
        path: String,
        column: String,
        datatype: String,
    },
    EntityColumnHasNull {
        path: String,
        column: String,
    },
    EntityColumnEmpty {
        path: String,
        column: String,
    },
    EntityIdentity {
        path: String,
        source: EntityIdentityError,
    },
}

Errors that can occur when reading or computing segment coverage.

Coverage computation typically:

1. Reads the Parquet segment file from storage.
2. Inspects the Parquet schema to locate the registered index column.
3. Validates that the column matches the registered index domain.
4. Streams projected index values and maps them to index interval IDs.
5. Stores the IDs in a RoaringTreemap for efficient serialization.

Errors at any stage are captured here with context about the segment path, column name, and raw values involved.

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.

Storage

Storage layer failed to read the segment file at the given path.

This may indicate the file is missing, inaccessible, or suffered an I/O error.

Fields

path: String

The path to the segment file that could not be read.

source: StorageError

The underlying storage error that caused this failure.

ParquetRead

Parquet format violation or metadata read error.

This may indicate the file is corrupted, truncated, or uses an unsupported Parquet feature.

Fields

path: String

The path to the segment file with a Parquet format error.

source: ParquetError

The underlying Parquet library error.

backtrace: Backtrace

The backtrace at the time the error occurred.

RowGroupTask

A parallel row-group scan task failed before returning its typed result.

Fields

path: String

Segment path being scanned.

source: JoinError

Tokio task failure, including panic or cancellation details.

backtrace: Backtrace

Backtrace captured while joining the row-group task.

OrderedIndexColumn

The registered ordered-index column is missing or incompatible.

Fields

source: ParquetIndexColumnError

Exact registered and observed Parquet column details.

IndexValue

A projected ordered-index value cannot be represented in its registered domain.

Fields

path: String

Path to the segment file.

column: String

Registered ordered-index column.

expected_domain: &'static str

Registered ordered-index domain.

detail: String

Value decoding failure.

IndexIntervalMapping

Ordered-index interval mapping failed.

Fields

path: String

The path to the segment file.

source: IndexIntervalMappingError

Index interval mapping failure.

DuplicateIndexInterval

Two rows for the same entity occupy one ordered-index interval.

Fields

path: String

Path to the segment file.

example_identity: Option<EntityIdentity>

Complete entity identity, or None for a table without entity columns.

example_index_interval: IndexInterval

Logical ordered-index interval occupied by both rows.

EntityColumnNotFound

A configured entity column is missing from the segment.

Fields

path: String

Path to the segment file.

column: String

Missing configured entity column.

EntityColumnUnsupportedType

A configured entity column has an unsupported Arrow type.

Fields

path: String

Path to the segment file.

column: String

Configured entity column.

datatype: String

Observed Arrow type.

EntityColumnHasNull

A configured entity column contains a null value.

Fields

path: String

Path to the segment file.

column: String

Configured entity column.

EntityColumnEmpty

The segment has no rows from which to construct an entity identity.

Fields

path: String

Path to the segment file.

column: String

First configured entity column.

EntityIdentity

Ordered entity components could not form a complete identity.

Fields

path: String

Path to the segment file.

source: EntityIdentityError

Identity validation failure.

Trait Implementations

impl Debug for SegmentCoverageError

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

Formats the value using the given formatter.

impl Display for SegmentCoverageError

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

Formats the value using the given formatter.

impl Error for SegmentCoverageError

where Self: 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 SegmentCoverageError

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<ParquetIndexColumnError> for SegmentCoverageError

where ParquetIndexColumnError: Into<ParquetIndexColumnError>,

fn from(error: ParquetIndexColumnError) -> Self

Converts to this type from the input type.

impl From<SegmentCoverageError> for AppendError

where SegmentCoverageError: Into<SegmentCoverageError>,

fn from(error: SegmentCoverageError) -> Self

Converts to this type from the input type.