Enum odbc_api::Error

pub enum Error {
    FailedSettingConnectionPooling,
    FailedAllocatingEnvironment,
    NoDiagnostics {
        function: &'static str,
    },
    Diagnostics {
        record: DiagnosticRecord,
        function: &'static str,
    },
    AbortedConnectionStringCompletion,
    UnsupportedOdbcApiVersion(DiagnosticRecord),
    FailedReadingInput(Error),
    InvalidRowArraySize {
        record: DiagnosticRecord,
        size: usize,
    },
}

Error type used to indicate a low level ODBC call returned with SQL_ERROR.

Variants

FailedSettingConnectionPooling

Setting connection pooling option failed. Exclusively emitted by crate::Environment::set_connection_pooling.

FailedAllocatingEnvironment

Allocating the environment itself fails. Further diagnostics are not available, as they would be retrieved using the envirorment handle. Exclusively emitted by crate::Environment::new.

NoDiagnostics

Fields

function: &'static str

ODBC API call which returned error without producing a diagnostic record.

This should never happen, given that ODBC driver manager and ODBC driver do not have any Bugs. Since we may link vs a bunch of these, better to be on the safe side.

Diagnostics

Fields

record: DiagnosticRecord

Diagnostic record returned by the ODBC driver manager

function: &'static str

ODBC API call which produced the diagnostic record

SQL Error had been returned by a low level ODBC function call. A Diagnostic record is obtained and associated with this error.

AbortedConnectionStringCompletion

A user dialog to complete the connection string has been aborted.

UnsupportedOdbcApiVersion(DiagnosticRecord)

Tuple Fields

0: DiagnosticRecord

An error returned if we fail to set the ODBC version

FailedReadingInput(Error)

Tuple Fields

0: Error

An error emitted by an std::io::ReadBuf implementation used as an input argument.

InvalidRowArraySize

Fields

record: DiagnosticRecord

size: usize

Driver returned “invalid attribute” then setting the row array size. Most likely the array size is to large. Instead of returing “option value changed (SQLSTATE 01S02)” like suggested in https://docs.microsoft.com/en-us/sql/odbc/reference/syntax/sqlsetstmtattr-function the driver returned an error instead.

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

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