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

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.

Fields of NoDiagnostics

function: &'static str

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

Diagnostics

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

Fields of Diagnostics

record: DiagnosticRecord

Diagnostic record returned by the ODBC driver manager

function: &'static str

ODBC API call which produced the diagnostic record

AbortedConnectionStringCompletion

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

UnsupportedOdbcApiVersion(DiagnosticRecord)

An error returned if we fail to set the ODBC version

Tuple Fields of UnsupportedOdbcApiVersion

0: DiagnosticRecord

FailedReadingInput(Error)

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

Tuple Fields of FailedReadingInput

0: Error

InvalidRowArraySize

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.

Fields of InvalidRowArraySize

record: DiagnosticRecordsize: 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, __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