Enum Error 

pub enum Error {
    Database(Error),
    UniqueViolation {
        index: Option<String>,
    },
    ForeignKeyViolation {
        constraint: Option<String>,
    },
    Deadlock,
    LockWaitTimeout,
    Read {
        path: PathBuf,
        source: Error,
    },
    DuplicateMigration {
        name: String,
    },
    InvalidMigrationName {
        name: String,
    },
    DuplicateTimestamp {
        first: String,
        second: String,
    },
    MigrationsLocked {
        seconds: u64,
    },
    MigrationFailed {
        name: String,
        source: Error,
    },
    RollbackFailed {
        name: String,
        source: Error,
    },
    UnknownMigration {
        name: String,
    },
    InvalidIdentifier(String),
    UnsupportedDriver {
        scheme: String,
    },
    Unsupported {
        operation: &'static str,
        driver: &'static str,
    },
    NotFillable {
        table: &'static str,
        column: String,
    },
    NotFound {
        table: &'static str,
    },
    BlockingInRuntime,
}

Any error from Orbit. Driver errors that have a variant here are classified; the rest come through unchanged as Database.

Variants

Database(Error)

The database rejected a connection, a query, or a statement, and no other variant fits.

UniqueViolation

An insert or update broke a unique index or primary key. index is the index name when the server reports it.

Fields

index: Option<String>

ForeignKeyViolation

A row refers to a missing parent, or a parent is still referenced. constraint is the foreign key name when the server reports it.

Fields

constraint: Option<String>

Deadlock

The database rolled back the whole transaction to break a deadlock. Run it again.

LockWaitTimeout

A lock was not released in time. Only the statement failed; the transaction is still open.

Read

A file could not be read, such as a migration’s up.sql.

Fields

path: PathBuf

source: Error

DuplicateMigration

Two migrations have the same name.

Fields

name: String

InvalidMigrationName

A migration name does not start with a 14-digit timestamp and an underscore.

Fields

name: String

DuplicateTimestamp

Two migrations share a timestamp, so their order is not defined.

Fields

first: String

second: String

MigrationsLocked

Another process is running migrations and did not finish within the lock timeout.

Fields

seconds: u64

MigrationFailed

A migration’s up.sql failed. The run stopped there; earlier migrations stay applied.

Fields

name: String

source: Error

RollbackFailed

A migration’s down.sql failed. The rollback stopped there.

Fields

name: String

source: Error

UnknownMigration

A migration is recorded as applied, but this migrator has no folder for it, so it cannot be rolled back. name is the version: the 14-digit timestamp prefix recorded in the table.

Fields

name: String

InvalidIdentifier(String)

A table or column name is empty or contains a quote character (a backtick or a double quote). The same rule applies to every database.

UnsupportedDriver

The URL’s scheme names a database whose Cargo feature is not enabled, or no database. scheme is the part before the first :, never the password.

Fields

scheme: String

Unsupported

The database has no equivalent for this operation. operation names it and driver names the database. See docs/laravel-differences.md for each case.

Fields

operation: &'static str

driver: &'static str

NotFillable

A column is not in the model’s FILLABLE list.

Fields

table: &'static str

column: String

NotFound

A query that must find a row found none.

Fields

table: &'static str

BlockingInRuntime

A blocking call ran on a thread that runs async code. Run it inside spawn_blocking.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(error: Error) -> Self

Classifies the driver error by its kind, then by the driver’s error code where the kind does not say enough. Anything else is kept as Database.