Enum TxConflict 

#[non_exhaustive]
pub enum TxConflict {
    Serialization,
    Deadlock,
    LockTimeout,
    Busy,
}

A concurrency conflict the engine raised: this transaction lost, and the only correct response is to run the whole thing again.

The point of the type is that it is matchable. Serialization failures arrive as engine-specific codes on engine-specific error types; without a classification a caller ends up matching on message text, which is a bug waiting for a locale or a version bump. A backend that reports one of these constructs a TxConflictError; a caller asks TxConflict::of.

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.

Serialization

The engine could not serialize this transaction against a concurrent one — PostgreSQL 40001 (could not serialize access …).

Deadlock

A deadlock was detected and this transaction was picked as the victim — PostgreSQL 40P01, MySQL 1213 (ER_LOCK_DEADLOCK, SQLSTATE 40001: InnoDB reports its serialization failures this way).

LockTimeout

A lock wait timed out — PostgreSQL 55P03, MySQL 1205 (ER_LOCK_WAIT_TIMEOUT).

Busy

SQLite could not take the lock it needed — SQLITE_BUSY / SQLITE_LOCKED, which is how SQLite says “serialize elsewhere”.

Implementations

impl TxConflict

pub fn as_str(self) -> &'static str

A short stable name, for logs and assertions.

pub fn of(e: &ExecError) -> Option<TxConflict>

Classify an error: Some when a backend reported a concurrency conflict, None otherwise. Every variant means the same thing to a caller — retry the transaction from the top.

Trait Implementations

impl Clone for TxConflict

fn clone(&self) -> TxConflict

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for TxConflict

impl Debug for TxConflict

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

Formats the value using the given formatter.

impl Display for TxConflict

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

Formats the value using the given formatter.

impl Eq for TxConflict

impl Hash for TxConflict

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TxConflict

fn eq(&self, other: &TxConflict) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TxConflict