Enum OptimizeError 

#[non_exhaustive]
pub enum OptimizeError {
    Protocol {
        source: TableProtocolError,
        backtrace: Backtrace,
    },
    NotApplicable {
        table_root: String,
    },
    MixedSegmentRewrite {
        source: Box<EntityRewriteError>,
    },
    InvalidSegmentBounds {
        source: IndexValueError,
        backtrace: Backtrace,
    },
    SchemaValidation {
        source: Box<SchemaCompatibilityError>,
    },
    CoverageSidecar {
        source: Box<CoverageSidecarError>,
    },
    InvalidStagedPath {
        description: &'static str,
        path: String,
        source: Box<StorageError>,
    },
    InvalidStagedPlan {
        reason: String,
        backtrace: Backtrace,
    },
    CountOverflow {
        field: &'static str,
        backtrace: Backtrace,
    },
    Commit {
        source: CommitError,
    },
    Rollback {
        source: Box<OptimizeError>,
        cleanup_errors: Vec<StorageError>,
    },
}

Errors owned by an entity-layout optimization operation.

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.

Protocol

The table protocol does not permit this client to optimize.

Fields

source: TableProtocolError

Complete table protocol failure.

backtrace: Backtrace

Backtrace captured at the optimization boundary.

NotApplicable

Entity-layout optimization requires at least one entity column.

Fields

table_root: String

User-facing table root.

MixedSegmentRewrite

Staging replacements for one mixed segment failed.

Fields

source: Box<EntityRewriteError>

Complete mixed-segment rewrite failure.

InvalidSegmentBounds

Live segment bounds cannot be ordered in one native index domain.

Fields

source: IndexValueError

Complete bounds validation failure.

backtrace: Backtrace

Backtrace captured because index value validation does not own one.

SchemaValidation

Optimization cannot use the table’s canonical schema.

Fields

source: Box<SchemaCompatibilityError>

Complete schema compatibility failure.

CoverageSidecar

A coverage sidecar required to validate a staged plan could not be read.

Fields

source: Box<CoverageSidecarError>

Complete coverage sidecar failure.

InvalidStagedPath

A staged replacement path failed table-relative storage validation.

Fields

description: &'static str

Role of the rejected path in the staged replacement.

path: String

Rejected table-relative path.

source: Box<StorageError>

Complete storage path validation failure.

InvalidStagedPlan

A staged optimization plan violated an atomic publication invariant.

Fields

reason: String

Failed plan invariant.

backtrace: Backtrace

Backtrace captured at the failed internal invariant.

CountOverflow

An optimization count could not be represented without wrapping.

Fields

field: &'static str

Report or version field that overflowed.

backtrace: Backtrace

Backtrace captured at the failed internal arithmetic boundary.

Commit

Publishing the optimization transaction failed.

Fields

source: CommitError

Complete transaction-log failure.

Rollback

Optimization failed and one or more owned staged objects could not be removed.

Fields

source: Box<OptimizeError>

Original optimization failure that triggered rollback.

cleanup_errors: Vec<StorageError>

Typed cleanup failure for every staged object that could not be removed.

Trait Implementations

impl Debug for OptimizeError

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

Formats the value using the given formatter.

impl Display for OptimizeError

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

Formats the value using the given formatter.

impl Error for OptimizeError

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 OptimizeError

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<CommitError> for OptimizeError

where CommitError: Into<CommitError>,

fn from(error: CommitError) -> Self

Converts to this type from the input type.

impl From<CoverageSidecarError> for OptimizeError

where CoverageSidecarError: Into<CoverageSidecarError>,

fn from(error: CoverageSidecarError) -> Self

Converts to this type from the input type.

impl From<EntityRewriteError> for OptimizeError

where EntityRewriteError: Into<EntityRewriteError>,

fn from(error: EntityRewriteError) -> Self

Converts to this type from the input type.

impl From<IndexValueError> for OptimizeError

where IndexValueError: Into<IndexValueError>,

fn from(error: IndexValueError) -> Self

Converts to this type from the input type.

impl From<SchemaCompatibilityError> for OptimizeError

where SchemaCompatibilityError: Into<SchemaCompatibilityError>,

fn from(error: SchemaCompatibilityError) -> Self

Converts to this type from the input type.

impl From<TableProtocolError> for OptimizeError

where TableProtocolError: Into<TableProtocolError>,

fn from(error: TableProtocolError) -> Self

Converts to this type from the input type.