Enum SplitError 

pub enum SplitError {
    Tablet(TabletError),
    Fault(Fault),
    MetaPlane(MetaRejectionReason),
    TabletData(TabletDataError),
    SourceNotActive {
        tablet: TabletId,
        state: TabletState,
    },
    UnboundedMidpoint,
    UnsplittableBounds,
    InvalidSplitKey {
        key: Key,
    },
    InvalidPlan(String),
    KeyOutsideSource(Key),
    SourceRetained {
        tablet: TabletId,
        pins: usize,
    },
    CannotAbort {
        tablet: TabletId,
        phase: SplitPhase,
    },
}

The one error type of the split surface: planning, execution, and resume.

Variants

Tablet(TabletError)

Descriptor, layout, or persisted-progress failure. Always fail closed.

Fault(Fault)

An armed fault hook fired (crash-resume tests).

MetaPlane(MetaRejectionReason)

The meta plane refused a descriptor write or the publication.

TabletData(TabletDataError)

A keyspace or child-sink seam operation failed.

SourceNotActive

The split was initiated against a source that is not serving.

Fields

tablet: TabletId

The source tablet.

state: TabletState

Its current state.

UnboundedMidpoint

A midpoint cannot be derived when either endpoint is unbounded.

UnsplittableBounds

No key lies strictly between the two endpoints (immediate successors).

InvalidSplitKey

The explicit split key does not partition the source into two halves.

Fields

key: Key

The rejected key.

InvalidPlan(String)

The plan is structurally inconsistent.

KeyOutsideSource(Key)

The applied keyspace holds a key outside the source partition (the children cannot own it; fail closed instead of dropping it).

SourceRetained

Step 10’s release condition is not met yet; retry when the pins drain.

Fields

tablet: TabletId

The retained source.

pins: usize

Old-generation pins still outstanding.

CannotAbort

The split already published its routing change (spec section 12.5 step 8); rolling it back would double-serve the keyspace. Only a split that has not reached SplitPhase::Published can abort.

Fields

tablet: TabletId

The source tablet.

phase: SplitPhase

The phase the split had durably reached.

Trait Implementations

impl Debug for SplitError

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

Formats the value using the given formatter.

impl Display for SplitError

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

Formats the value using the given formatter.

impl Error for SplitError

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 From<Fault> for SplitError

fn from(source: Fault) -> Self

Converts to this type from the input type.

impl From<MetaRejectionReason> for SplitError

fn from(source: MetaRejectionReason) -> Self

Converts to this type from the input type.

impl From<SplitError> for RuntimeError

fn from(source: SplitError) -> Self

Converts to this type from the input type.

impl From<TabletDataError> for SplitError

fn from(source: TabletDataError) -> Self

Converts to this type from the input type.

impl From<TabletError> for SplitError

fn from(source: TabletError) -> Self

Converts to this type from the input type.