Enum Error

pub enum Error {
    FailedSettingConnectionPooling,
    FailedAllocatingEnvironment,
    NoDiagnostics {
        function: &'static str,
    },
    Diagnostics {
        record: Record,
        function: &'static str,
    },
    AbortedConnectionStringCompletion,
    UnsupportedOdbcApiVersion(Record),
    FailedReadingInput(Error),
    InvalidRowArraySize {
        record: Record,
        size: usize,
    },
    UnableToRepresentNull(Record),
    OracleOdbcDriverDoesNotSupport64Bit(Record),
    TooLargeColumnBufferSize {
        buffer_index: u16,
        num_elements: usize,
        element_size: usize,
    },
    TooLargeValueForBuffer {
        indicator: Option<usize>,
        buffer_index: 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

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

record: Record

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

An error returned if we fail to set the ODBC version

FailedReadingInput(Error)

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

InvalidRowArraySize

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

Fields

record: Record

size: usize

UnableToRepresentNull(Record)

OracleOdbcDriverDoesNotSupport64Bit(Record)

There are plenty of issues in the net about Oracle ODBC driver not supporting 64Bit. This message, should make it easier identify what is going on, since the message emmitted by, Oracles ODBC driver is a bit cryptic: [Oracle][ODBC]Invalid SQL data type <-25>.

TooLargeColumnBufferSize

Fields

buffer_index: u16

Zero based column buffer index. Note that this is different from the 1 based column index.

num_elements: usize

element_size: usize

usize::MAX may be used to indicate a missing aupper bound of an element.

TooLargeValueForBuffer

Fields

indicator: Option<usize>

Length of the complete value in bytes as reported by the ODBC driver. If the length is not known, this is None.

buffer_index: usize

Index of the buffer in which the truncation occurred.

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

Returns the lower-level source of this error, if any.

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

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.