Enum DbError 

pub enum DbError {
    DatabaseConnection(String),
    DatabaseOperation(String),
    DatabaseOperationClassified {
        message: String,
        kind: DatabaseErrorKind,
    },
    CommitOutcomeUnknown {
        message: String,
        kind: Option<DatabaseErrorKind>,
    },
    RetryExhausted,
    NonRetryable(String),
}

Errors returned by database helpers.

Variants

DatabaseConnection(String)

A database connection could not be established.

DatabaseOperation(String)

A database query, transaction, or setup operation failed.

DatabaseOperationClassified

A database operation error with a driver-native classification.

Fields

message: String

kind: DatabaseErrorKind

CommitOutcomeUnknown

The commit response was lost after the transaction may have been committed.

Fields

message: String

kind: Option<DatabaseErrorKind>

RetryExhausted

Retry loop exhausted without a final operation error.

NonRetryable(String)

Operation failed with an error that should not be retried.

Implementations

impl DbError

pub fn database_connection(error: impl Display) -> Self

Creates a database-connection error from a displayable error.

pub fn database_operation(error: impl Display) -> Self

Creates a database-operation error from a displayable error.

pub fn database_operation_classified( error: impl Display, kind: DatabaseErrorKind, ) -> Self

Creates a database-operation error while preserving its driver-native classification.

pub fn commit_outcome_unknown( error: impl Display, kind: Option<DatabaseErrorKind>, ) -> Self

Creates an error for a commit whose final server-side outcome is unknown.

pub fn database_error_kind(&self) -> Option<DatabaseErrorKind>

Returns the driver-native classification, when one was available.

pub fn commit_outcome_is_unknown(&self) -> bool

Returns whether this error came from a commit with an unknown final outcome.

pub fn non_retryable(error: impl Display) -> Self

Creates a non-retryable error from a displayable error.

pub fn is_retryable(&self) -> bool

Returns whether the error is considered retryable by retry::with_retry.

Only connection failures and driver-classified transient locking conflicts (deadlock, serialization failure, lock timeout) qualify. Unclassified operation errors are not retried: without a driver classification there is no evidence the operation failed in a retry-safe way, so callers see the failure immediately.

Trait Implementations

impl Debug for DbError

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

Formats the value using the given formatter.

impl Display for DbError

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

Formats the value using the given formatter.

impl Error for DbError

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<DbErr> for DbError

fn from(value: DbErr) -> Self

Converts to this type from the input type.