Enum duckdb::Error

#[non_exhaustive]
pub enum Error {
    DuckDBFailure(Error, Option<String>),
    FromSqlConversionFailure(usize, Type, Box<dyn Error + Send + Sync + 'static>),
    IntegralValueOutOfRange(usize, i128),
    Utf8Error(Utf8Error),
    NulError(NulError),
    InvalidParameterName(String),
    InvalidPath(PathBuf),
    ExecuteReturnedResults,
    QueryReturnedNoRows,
    InvalidColumnIndex(usize),
    InvalidColumnName(String),
    InvalidColumnType(usize, String, Type),
    StatementChangedRows(usize),
    ToSqlConversionFailure(Box<dyn Error + Send + Sync + 'static>),
    InvalidQuery,
    MultipleStatement,
    InvalidParameterCount(usize, usize),
}

Enum listing possible errors from duckdb.

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.

DuckDBFailure(Error, Option<String>)

An error from an underlying DuckDB call.

Tuple Fields of DuckDBFailure

0: Error1: Option<String>

FromSqlConversionFailure(usize, Type, Box<dyn Error + Send + Sync + 'static>)

Error when the value of a particular column is requested, but it cannot be converted to the requested Rust type.

Tuple Fields of FromSqlConversionFailure

0: usize1: Type2: Box<dyn Error + Send + Sync + 'static>

IntegralValueOutOfRange(usize, i128)

Error when DuckDB gives us an integral value outside the range of the requested type (e.g., trying to get the value 1000 into a u8). The associated usize is the column index, and the associated i64 is the value returned by SQLite.

Tuple Fields of IntegralValueOutOfRange

0: usize1: i128

Utf8Error(Utf8Error)

Error converting a string to UTF-8.

Tuple Fields of Utf8Error

0: Utf8Error

NulError(NulError)

Error converting a string to a C-compatible string because it contained an embedded nul.

Tuple Fields of NulError

0: NulError

InvalidParameterName(String)

Error when using SQL named parameters and passing a parameter name not present in the SQL.

Tuple Fields of InvalidParameterName

0: String

InvalidPath(PathBuf)

Error converting a file path to a string.

Tuple Fields of InvalidPath

0: PathBuf

ExecuteReturnedResults

Error returned when an execute call returns rows.

QueryReturnedNoRows

Error when a query that was expected to return at least one row (e.g., for query_row) did not return any.

InvalidColumnIndex(usize)

Error when the value of a particular column is requested, but the index is out of range for the statement.

Tuple Fields of InvalidColumnIndex

0: usize

InvalidColumnName(String)

Error when the value of a named column is requested, but no column matches the name for the statement.

Tuple Fields of InvalidColumnName

0: String

InvalidColumnType(usize, String, Type)

Error when the value of a particular column is requested, but the type of the result in that column cannot be converted to the requested Rust type.

Tuple Fields of InvalidColumnType

0: usize1: String2: Type

StatementChangedRows(usize)

Error when a query that was expected to insert one row did not insert any or insert many.

Tuple Fields of StatementChangedRows

0: usize

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

Error available for the implementors of the ToSql trait.

Tuple Fields of ToSqlConversionFailure

0: Box<dyn Error + Send + Sync + 'static>

InvalidQuery

Error when the SQL is not a SELECT, is not read-only.

MultipleStatement

Error when the SQL contains multiple statements.

InvalidParameterCount(usize, usize)

Error when the number of bound parameters does not match the number of parameters in the query. The first usize is how many parameters were given, the 2nd is how many were expected.

Tuple Fields of InvalidParameterCount

0: usize1: usize

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, f: &mut Formatter<'_>) -> Result

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.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

impl From<FromSqlError> for Error

The conversion isn’t precise, but it’s convenient to have it to allow use of get_raw(…).as_…()? in callbacks that take Error.

fn from(err: FromSqlError) -> Error

Performs the conversion.

impl From<NulError> for Error

fn from(err: NulError) -> Error

Performs the conversion.

impl From<Utf8Error> for Error

fn from(err: Utf8Error) -> Error

Performs the conversion.

impl PartialEq<Error> for Error

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.