Enum DatabaseError 

#[non_exhaustive]
pub enum DatabaseError {
    DatabaseEngineError(Error),
    QueryBuildingError(Error),
    TypeMismatch {
        expected: String,
        found: String,
    },
    ValueDecode(Box<dyn Error + Send + Sync + 'static>),
    MigrationError(MigrationEngineError),
    RecordNotFound {
        primary_key: DbValue,
    },
    ForeignKeyNotFound,
    UniqueViolation,
    BulkInsertModelTooLarge {
        field_count: usize,
        limit: usize,
    },
    BulkInsertNoValueColumns,
    BulkInsertReturnDataInvalid {
        expected: usize,
        actual: usize,
    },
}

Available on crate feature db only.

An error that can occur when interacting with the database.

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.

DatabaseEngineError(Error)

Database engine error.

QueryBuildingError(Error)

Error when building query.

TypeMismatch

Type mismatch in database value.

Fields

expected: String

The expected type.

found: String

The type that was found.

ValueDecode(Box<dyn Error + Send + Sync + 'static>)

Error when decoding database value.

MigrationError(MigrationEngineError)

Error when applying migrations.

RecordNotFound

A record could not be found in the database.

Fields

primary_key: DbValue

The primary key of the record that was not found.

ForeignKeyNotFound

Foreign Key could not be retrieved from the database because the record was not found.

UniqueViolation

Error when a unique constraint is violated in the database.

BulkInsertModelTooLarge

Single model has more fields than database parameter limit.

Fields

field_count: usize

The number of fields in the model.

limit: usize

The database parameter limit.

BulkInsertNoValueColumns

Attempted bulk create with a model that only contains Auto fields.

BulkInsertReturnDataInvalid

Data returned by the bulk insert does not match the expected number of rows.

Fields

expected: usize

The expected number of rows.

actual: usize

The actual number of rows returned.

Implementations

impl DatabaseError

pub fn value_decode(error: impl Error + 'static + Send + Sync) -> Self

Creates a new database error from a value decode error.

Trait Implementations

impl Debug for DatabaseError

fn fmt(&self, __derive_more_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<DatabaseError> for Error

fn from(err: DatabaseError) -> Self

Converts to this type from the input type.

impl From<DatabaseError> for DbStoreError

Available on crate feature json only.

fn from(source: DatabaseError) -> Self

Converts to this type from the input type.

impl From<Error> for DatabaseError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DatabaseError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<MigrationEngineError> for DatabaseError

fn from(source: MigrationEngineError) -> Self

Converts to this type from the input type.