Enum CommitError 

#[non_exhaustive]
pub enum CommitError {
    Conflict {
        expected: u64,
        found: u64,
        backtrace: Backtrace,
    },
    Storage {
        source: StorageError,
    },
    Protocol {
        source: TableProtocolError,
        backtrace: Backtrace,
    },
    CommitDeserialization {
        version: u64,
        source: Error,
        backtrace: Backtrace,
    },
    CommitSerialization {
        version: u64,
        source: Error,
        backtrace: Backtrace,
    },
    CurrentVersionParse {
        contents: String,
        source: ParseIntError,
        backtrace: Backtrace,
    },
    InvalidPersistedPath {
        description: String,
        path: String,
        source: Box<StorageError>,
    },
    InvalidIndexSpec {
        source: IndexSpecError,
        backtrace: Backtrace,
    },
    TableSchemaCompatibility {
        source: Box<SchemaCompatibilityError>,
    },
    SegmentEntityIdentitySchema {
        path: String,
        source: Box<SchemaCompatibilityError>,
    },
    SegmentMetadata {
        source: Box<SegmentMetaError>,
    },
    UninitializedTableState {
        backtrace: Backtrace,
    },
    CommitVersionMismatch {
        expected: u64,
        found: u64,
        backtrace: Backtrace,
    },
    DuplicateLiveSegmentPath {
        path: String,
        backtrace: Backtrace,
    },
    MissingTableMetadata {
        current_version: u64,
        backtrace: Backtrace,
    },
    CoverageIndexKindMismatch {
        expected: IndexKind,
        actual: IndexKind,
        pointer_version: u64,
        backtrace: Box<Backtrace>,
    },
    MissingLogicalSchemaForSegments {
        backtrace: Backtrace,
    },
    InvalidSegmentEntityLayout {
        path: String,
        entity_column_count: usize,
        layout: SegmentEntityLayout,
        backtrace: Backtrace,
    },
    VersionOverflow {
        current_version: u64,
        backtrace: Backtrace,
    },
    EmptyCurrentPointer {
        path: String,
        backtrace: Backtrace,
    },
    AmbiguousOutcome {
        commit_path: String,
        operation_error: Box<StorageError>,
        cleanup_error: Box<StorageError>,
    },
}

Errors that can occur while reading or writing the commit log.

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.

Conflict

The caller’s expected_version does not match the CURRENT pointer.

Fields

expected: u64

The version the caller expected to be current.

found: u64

The actual current version found.

backtrace: Backtrace

Backtrace for debugging.

Storage

Underlying storage error while working with the log or CURRENT file.

Backtraces are delegated to the inner StorageError.

Fields

source: StorageError

Underlying storage error returned by the storage backend.

Protocol

The table protocol is incompatible with this operation.

Fields

source: TableProtocolError

Complete table protocol failure.

backtrace: Backtrace

Backtrace captured at the transaction-log boundary.

CommitDeserialization

A commit payload could not be decoded from JSON.

Fields

version: u64

Commit version being decoded.

source: Error

JSON decoding failure.

backtrace: Backtrace

Backtrace captured at the transaction-log boundary.

CommitSerialization

A commit payload could not be encoded as JSON.

Fields

version: u64

Commit version being encoded.

source: Error

JSON encoding failure.

backtrace: Backtrace

Backtrace captured at the transaction-log boundary.

CurrentVersionParse

The CURRENT pointer is not an unsigned transaction-log version.

Fields

contents: String

Invalid trimmed CURRENT contents.

source: ParseIntError

Integer parsing failure.

backtrace: Backtrace

Backtrace captured at the transaction-log boundary.

InvalidPersistedPath

A persisted table-relative path is invalid.

Fields

description: String

Kind of persisted path being validated.

path: String

Rejected persisted path.

source: Box<StorageError>

Structured path validation failure.

InvalidIndexSpec

A persisted ordered-index specification is invalid.

Fields

source: IndexSpecError

Ordered-index validation failure.

backtrace: Backtrace

Backtrace captured while rebuilding table state.

TableSchemaCompatibility

Persisted table schema and ordered-index metadata are incompatible.

Fields

source: Box<SchemaCompatibilityError>

Complete schema compatibility failure.

SegmentEntityIdentitySchema

A persisted single-entity segment identity is incompatible with the table schema.

Fields

path: String

Persisted segment path.

source: Box<SchemaCompatibilityError>

Complete entity identity compatibility failure.

SegmentMetadata

Persisted segment metadata violates its registered ordered-index domain.

Fields

source: Box<SegmentMetaError>

Complete segment metadata validation failure.

UninitializedTableState

Rebuilding table state was requested before the first commit.

Fields

backtrace: Backtrace

Backtrace captured at the state rebuild boundary.

CommitVersionMismatch

A commit file name and its payload disagree on the version.

Fields

expected: u64

Version selected by the commit file name.

found: u64

Version stored in the payload.

backtrace: Backtrace

Backtrace captured while rebuilding table state.

DuplicateLiveSegmentPath

More than one live AddSegment action uses the same path.

Fields

path: String

Repeated live segment path.

backtrace: Backtrace

Backtrace captured while rebuilding table state.

MissingTableMetadata

No table metadata was found while replaying the selected commits.

Fields

current_version: u64

Latest commit version included in the replay.

backtrace: Backtrace

Backtrace captured while rebuilding table state.

CoverageIndexKindMismatch

A persisted coverage pointer describes a different ordered index.

Fields

expected: IndexKind

Ordered-index kind from table metadata.

actual: IndexKind

Ordered-index kind stored in the coverage pointer.

pointer_version: u64

Commit version that supplied the pointer.

backtrace: Box<Backtrace>

Backtrace captured while rebuilding table state.

MissingLogicalSchemaForSegments

Persisted segments exist without the logical schema needed to validate them.

Fields

backtrace: Backtrace

Backtrace captured while rebuilding table state.

InvalidSegmentEntityLayout

A persisted segment entity layout is incompatible with the table metadata.

Fields

path: String

Persisted segment path.

entity_column_count: usize

Number of entity columns configured by the table.

layout: SegmentEntityLayout

Rejected persisted layout.

backtrace: Backtrace

Backtrace captured while rebuilding table state.

VersionOverflow

Incrementing the transaction-log version would overflow u64.

Fields

current_version: u64

Current version that cannot be incremented.

backtrace: Backtrace

Backtrace captured at the version calculation boundary.

EmptyCurrentPointer

The CURRENT pointer contains no version.

Fields

path: String

Table-relative CURRENT path.

backtrace: Backtrace

Backtrace captured at the transaction-log boundary.

AmbiguousOutcome

A commit operation failed and its newly-created commit file may remain.

Fields

commit_path: String

Path of the commit file that may remain unpublished.

operation_error: Box<StorageError>

Write, sync, or publish failure that triggered cleanup.

cleanup_error: Box<StorageError>

Failure encountered while removing the unpublished commit file.

Trait Implementations

impl Debug for CommitError

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

Formats the value using the given formatter.

impl Display for CommitError

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

Formats the value using the given formatter.

impl Error for CommitError

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 CommitError

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 AppendError

where CommitError: Into<CommitError>,

fn from(error: CommitError) -> Self

Converts to this type from the input type.

impl From<CommitError> for CreateTableError

where CommitError: Into<CommitError>,

fn from(error: CommitError) -> Self

Converts to this type from the input type.

impl From<CommitError> for OpenTableError

where CommitError: Into<CommitError>,

fn from(error: CommitError) -> Self

Converts to this type from the input type.

impl From<CommitError> for OptimizeError

where CommitError: Into<CommitError>,

fn from(error: CommitError) -> Self

Converts to this type from the input type.

impl From<CommitError> for TableStateAccessError

where CommitError: Into<CommitError>,

fn from(error: CommitError) -> Self

Converts to this type from the input type.

impl From<TableProtocolError> for CommitError

where TableProtocolError: Into<TableProtocolError>,

fn from(error: TableProtocolError) -> Self

Converts to this type from the input type.