Enum StorageError

pub enum StorageError<T> {
    CollectionIdReused(GlobalId),
    SinkIdReused(GlobalId),
    IdentifierMissing(GlobalId),
    IdentifierInvalid(GlobalId),
    UpdateBeyondUpper(GlobalId),
    ReadBeforeSince(GlobalId),
    InvalidUppers(Vec<InvalidUpper<T>>),
    IngestionInstanceMissing {
        storage_instance_id: StorageInstanceId,
        ingestion_id: GlobalId,
    },
    ExportInstanceMissing {
        storage_instance_id: StorageInstanceId,
        export_id: GlobalId,
    },
    DataflowError(DataflowError),
    InvalidAlter(AlterError),
    InvalidUsage(String),
    ResourceExhausted(&'static str),
    ShuttingDown(&'static str),
    CollectionMetadataAlreadyExists(GlobalId),
    PersistShardAlreadyInUse(ShardId),
    PersistSchemaEvolveRace {
        global_id: GlobalId,
        shard_id: ShardId,
        schema_id: SchemaId,
        relation_desc: RelationDesc,
    },
    PersistInvalidSchemaEvolve {
        global_id: GlobalId,
        shard_id: ShardId,
    },
    TxnWalShardAlreadyExists,
    MissingSubsourceReference {
        ingestion_id: GlobalId,
        reference: UnresolvedItemName,
    },
    RtrTimeout(GlobalId),
    RtrDropFailure(GlobalId),
    Generic(Error),
    ReadOnly,
}

Variants

CollectionIdReused(GlobalId)

The source identifier was re-created after having been dropped, or installed with a different description.

SinkIdReused(GlobalId)

The sink identifier was re-created after having been dropped, or installed with a different description.

IdentifierMissing(GlobalId)

The source identifier is not present.

IdentifierInvalid(GlobalId)

The provided identifier was invalid, maybe missing, wrong type, not registered, etc.

UpdateBeyondUpper(GlobalId)

The update contained in the appended batch was at a timestamp equal or beyond the batch’s upper

ReadBeforeSince(GlobalId)

The read was at a timestamp before the collection’s since

InvalidUppers(Vec<InvalidUpper<T>>)

The expected upper of one or more appends was different from the actual upper of the collection

IngestionInstanceMissing

The (client for) the requested cluster instance is missing.

Fields

storage_instance_id: StorageInstanceId

ingestion_id: GlobalId

ExportInstanceMissing

The (client for) the requested cluster instance is missing.

Fields

storage_instance_id: StorageInstanceId

export_id: GlobalId

DataflowError(DataflowError)

Dataflow was not able to process a request

InvalidAlter(AlterError)

Response to an invalid/unsupported ALTER.. command.

InvalidUsage(String)

The controller API was used in some invalid way. This usually indicates a bug.

ResourceExhausted(&'static str)

The specified resource was exhausted, and is not currently accepting more requests.

ShuttingDown(&'static str)

The specified component is shutting down.

CollectionMetadataAlreadyExists(GlobalId)

Collection metadata already exists for ID.

PersistShardAlreadyInUse(ShardId)

Some other collection is already writing to this persist shard.

PersistSchemaEvolveRace

Raced with some other process while trying to evolve the schema of a Persist shard.

Fields

global_id: GlobalId

shard_id: ShardId

schema_id: SchemaId

relation_desc: RelationDesc

PersistInvalidSchemaEvolve

We tried to evolve the schema of a Persist shard in an invalid way.

Fields

global_id: GlobalId

shard_id: ShardId

TxnWalShardAlreadyExists

Txn WAL shard already exists.

MissingSubsourceReference

The item that a subsource refers to is unexpectedly missing from the source.

Fields

ingestion_id: GlobalId

reference: UnresolvedItemName

RtrTimeout(GlobalId)

We failed to determine the real-time-recency timestamp.

RtrDropFailure(GlobalId)

The collection was dropped before we could ingest its external frontier.

Generic(Error)

A generic error that happens during operations of the storage controller.

ReadOnly

We are in read-only mode and were asked to do a something that requires writing.

Trait Implementations

impl<T: Debug> Debug for StorageError<T>

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

Formats the value using the given formatter.

impl<T: Display + 'static> Display for StorageError<T>

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

Formats the value using the given formatter.

impl<T: Debug + Display + 'static> Error for StorageError<T>

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<T> From<AlterError> for StorageError<T>

fn from(error: AlterError) -> Self

Converts to this type from the input type.

impl<T> From<DataflowError> for StorageError<T>

fn from(error: DataflowError) -> Self

Converts to this type from the input type.