Enum sqlx::Error

pub enum Error {
    Io(Error),
    UrlParse(ParseError),
    Database(Box<dyn DatabaseError + 'static>),
    NotFound,
    FoundMoreThanOne,
    ColumnNotFound(Box<str>),
    Protocol(Box<str>),
    PoolTimedOut,
    PoolClosed,
    Decode(DecodeError),
    // some variants omitted
}

A generic error that represents all the ways a method can fail inside of SQLx.

Variants

Io(Error)

Error communicating with the database.

UrlParse(ParseError)

Connection URL was malformed.

Database(Box<dyn DatabaseError + 'static>)

An error was returned by the database.

NotFound

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

FoundMoreThanOne

More than one row was returned by a query that expected to return exactly one row.

ColumnNotFound(Box<str>)

Column was not found in Row during [Row::try_get].

Protocol(Box<str>)

Unexpected or invalid data was encountered. This would indicate that we received data that we were not expecting or it was in a format we did not understand. This generally means either there is a programming error in a SQLx driver or something with the connection or the database database itself is corrupted.

Context is provided by the included error message.

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.

Decode(DecodeError)

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

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

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

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

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

fn description(&self) -> &str

Deprecated since 1.41.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

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

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<DecodeError> for Error

fn from(err: DecodeError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.

impl From<ErrorKind> for Error

fn from(err: ErrorKind) -> Error

Performs the conversion.

impl From<ParseError> for Error

fn from(err: ParseError) -> Error

Performs the conversion.

impl<'_> From<ProtocolError<'_>> for Error

fn from(err: ProtocolError) -> Error

Performs the conversion.

impl<T> From<T> for Error where
    T: 'static + DatabaseError, 

fn from(err: T) -> Error

Performs the conversion.