Enum DatabaseError 

pub enum DatabaseError {
    WriteConflict,
    SnapshotTooOld(Box<dyn Error + Send + Sync>),
    TransactionConsumed,
    DatabaseBackend(Box<dyn Error + Send + Sync>),
    Other(Error),
}

Error type for database operations

Variants

WriteConflict

Write-write conflict during optimistic transaction commit. This occurs when two transactions attempt to modify the same key.

SnapshotTooOld(Box<dyn Error + Send + Sync>)

The backend could not tell whether this transaction conflicted with another one, because its snapshot is older than the write history the backend still keeps around for conflict detection.

This is not a conflict: it says nothing about whether any other transaction touched the same keys, only that the transaction was open for too many intervening writes to check. Nothing was written, and rerunning the whole operation against a fresh transaction is the only supported recovery — the failed transaction cannot be committed again.

The usual cause is a transaction held open across something slow.

TransactionConsumed

The transaction has already been consumed (committed or dropped). Operations cannot be performed on a consumed transaction.

DatabaseBackend(Box<dyn Error + Send + Sync>)

Error from the underlying database backend (e.g., RocksDB I/O errors).

Other(Error)

Other database error

Implementations

impl DatabaseError

pub fn other<E: Error + Send + Sync + 'static>(error: E) -> Self

Create a DatabaseError from any error type

pub fn backend<E: Error + Send + Sync + 'static>(error: E) -> Self

Create a DatabaseBackend error from any error type

pub fn snapshot_too_old<E: Error + Send + Sync + 'static>(error: E) -> Self

Create a SnapshotTooOld error, preserving the backend’s own error

Trait Implementations

impl Debug for DatabaseError

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

Formats the value using the given formatter.

impl Display for DatabaseError

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

Formats the value using the given formatter.

impl Error for DatabaseError

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<Box<dyn Error + Send + Sync>> for DatabaseError

fn from(source: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.

impl From<DatabaseError> for ApiError

fn from(err: DatabaseError) -> Self

Converts to this type from the input type.

impl From<Error> for DatabaseError

fn from(error: Error) -> Self

Converts to this type from the input type.