# Enum db_sqlx_maria::dev::Error

[−]

    #[non_exhaustive]
    pub enum Error {
    Show 15 variants    Configuration(Box<dyn Error + Send + Sync + 'static, Global>),
        Database(Box<dyn DatabaseError + 'static, Global>),
        Io(Error),
        Tls(Box<dyn Error + Send + Sync + 'static, Global>),
        Protocol(String),
        RowNotFound,
        TypeNotFound {
            type_name: String,
        },
        ColumnIndexOutOfBounds {
            index: usize,
            len: usize,
        },
        ColumnNotFound(String),
        ColumnDecode {
            index: String,
            source: Box<dyn Error + Send + Sync + 'static, Global>,
        },
        Decode(Box<dyn Error + Send + Sync + 'static, Global>),
        PoolTimedOut,
        PoolClosed,
        WorkerCrashed,
        Migrate(Box<MigrateError, Global>),
    }

Expand description

Represents all the ways a method can fail within SQLx.

## Variants (Non-exhaustive)

This enum is marked as 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.

### `Configuration(Box<dyn Error + Send + Sync + 'static, Global>)`

Error occurred while parsing a connection string.

### `Database(Box<dyn DatabaseError + 'static, Global>)`

Error returned from the database.

### `Io(Error)`

Error communicating with the database backend.

### `Tls(Box<dyn Error + Send + Sync + 'static, Global>)`

Error occurred while attempting to establish a TLS connection.

### `Protocol(String)`

Unexpected or invalid data encountered while communicating with the database.

This should indicate there is a programming error in a SQLx driver or there is something corrupted with the connection to the database itself.

### `RowNotFound`

No rows returned by a query that expected to return at least one row.

### `TypeNotFound`

#### Fields

`type_name: String`

Type in query doesn’t exist. Likely due to typo or missing user type.

### `ColumnIndexOutOfBounds`

#### Fields

`index: usize`
`len: usize`

Column index was out of bounds.

### `ColumnNotFound(String)`

No column found for the given name.

### `ColumnDecode`

#### Fields

`index: String`
`source: Box<dyn Error + Send + Sync + 'static, Global>`

Error occurred while decoding a value from a specific column.

### `Decode(Box<dyn Error + Send + Sync + 'static, Global>)`

Error occurred while decoding a value.

### `PoolTimedOut`

A `Pool::acquire` timed out due to connections not becoming available or because another task encountered too many errors while trying to open a new connection.

### `PoolClosed`

`Pool::close` was called while we were waiting in `Pool::acquire`.

### `WorkerCrashed`

A background worker has crashed.

### `Migrate(Box<MigrateError, Global>)`

## Implementations

### impl Error

#### pub fn into_database_error(
self
) -> Option<Box<dyn DatabaseError + 'static, Global>>

#### pub fn as_database_error(&self) -> Option<&(dyn DatabaseError + 'static)>

## Trait Implementations

### impl Debug for Error

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

Formats the value using the given formatter. Read more

### impl Display for Error

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

Formats the value using the given formatter. Read more

### impl Error for Error

#### fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any. Read more

source

#### fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (`backtrace`)

Returns a stack backtrace, if available, of where this error occurred. Read more

1.0.0 · source

#### fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

Read more
1.0.0 · source

#### fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

### impl<E> From<E> for Error where
E: DatabaseError,

#### fn from(error: E) -> Error

Converts to this type from the input type.

### impl From<Error> for Error

#### fn from(source: Error) -> Error

Converts to this type from the input type.

### impl From<InvalidDNSNameError> for Error

#### fn from(error: InvalidDNSNameError) -> Error

Converts to this type from the input type.

### impl From<MigrateError> for Error

#### fn from(error: MigrateError) -> Error

Converts to this type from the input type.

## Auto Trait Implementations

### impl !RefUnwindSafe for Error

### impl Send for Error

### impl Sync for Error

### impl Unpin for Error

### impl !UnwindSafe for Error

## Blanket Implementations

source

### impl<T> Any for T where
T: 'static + ?Sized,

source

#### fn type_id(&self) -> TypeId

Gets the `TypeId` of `self`. Read more

source

### impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

#### fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

### impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

#### fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

### impl<T> From<T> for T

const: unstable · source

#### fn from(t: T) -> T

Returns the argument unchanged.

source

### impl<T> Instrument for T

source

#### fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided `Span`, returning an `Instrumented` wrapper. Read more

source

#### fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current `Span`, returning an `Instrumented` wrapper. Read more

source

### impl<T, U> Into<U> for T where
U: From<T>,

const: unstable · source

#### fn into(self) -> U

Calls `U::from(self)`.

That is, this conversion is whatever the implementation of `From<T> for U` chooses to do.

source

### impl<T> Same<T> for T

#### type Output = T

Should always be `Self`

source

### impl<T> ToString for T where
T: Display + ?Sized,

source

#### default fn to_string(&self) -> String

Converts the given value to a `String`. Read more

source

### impl<T, U> TryFrom<U> for T where
U: Into<T>,

#### type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

#### fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

source

### impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

#### type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

const: unstable · source

#### fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

### impl<V, T> VZip<V> for T where
V: MultiLane<T>,

#### fn vzip(self) -> V

source

### impl<T> WithSubscriber for T

source

#### fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,

Attaches the provided `Subscriber` to this type, returning a `WithDispatch` wrapper. Read more

source

#### fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default `Subscriber` to this type, returning a `WithDispatch` wrapper. Read more