Enum hdbconnect_impl::HdbError

#[non_exhaustive]
pub enum HdbError {
    Deserialization {
        source: DeserializationError,
    },
    Serialization {
        source: SerializationError,
    },
    Cesu8,
    Cesu8AsBytes {
        bytes: Vec<u8>,
    },
    ConnParams {
        source: Box<dyn Error + Send + Sync + 'static>,
    },
    DbError {
        source: ServerError,
    },
    Decompression {
        source: DecompressError,
    },
    TlsServerName,
    TlsProtocol {
        source: Error,
    },
    Evaluation(&'static str),
    ExecutionResults(Vec<ExecutionResult>),
    Impl(&'static str),
    ImplDetailed(String),
    Poison,
    SessionClosingTransactionError,
    Io {
        source: Error,
    },
    Usage(&'static str),
    UsageDetailed(String),
}

A list specifying categories of HdbError.

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.

Deserialization

Fields

source: DeserializationError

The causing Error.

Deserialization of a ResultSet, a Row, a single HdbValue, or an OutputParameter failed (methods try_into()).

Serialization

Fields

source: SerializationError

The causing Error.

Serialization of a ParameterDescriptor or a ParameterRow failed.

Cesu8

Some error occured while decoding CESU-8. This indicates a server issue!

Cesu8AsBytes

Fields

bytes: Vec<u8>

Decoding CESU-8 failed, original bytes are available.

ConnParams

Fields

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

The causing Error.

Erroneous Connection Parameters, e.g. from a malformed connection URL.

DbError

Fields

source: ServerError

The causing Error.

Database server responded with an error; the contained ServerError describes the conrete reason.

Decompression

Fields

source: DecompressError

The causing Error.

Decompression

TlsServerName

TLS set up failed because the server name was not valid.

TlsProtocol

Fields

source: Error

The causing Error.

TLS protocol error.

Evaluation(&'static str)

Error occured while evaluating an HdbResponse or an HdbReturnValue.

ExecutionResults(Vec<ExecutionResult>)

Database server responded with at least one error.

Impl(&'static str)

Implementation error.

ImplDetailed(String)

Implementation error.

Poison

Error occured in thread synchronization.

SessionClosingTransactionError

An error occurred on the server that requires the session to be terminated.

Io

Fields

source: Error

The causing Error.

Error occured in communication with the database.

Usage(&'static str)

Error caused by wrong usage.

UsageDetailed(String)

Error caused by wrong usage.

Implementations

impl HdbError

pub fn server_error(&self) -> Option<&ServerError>

Returns the contained ServerError, if any.

This method helps in case you need programmatic access to e.g. the error code.

Example:

    if let Err(hdberror) = hdb_result {
        if let Some(server_error) = hdberror.server_error() {
            let sys_m_error_code: (i32, String, String) = connection
                .query(&format!(
                    "select * from SYS.M_ERROR_CODES where code = {}",
                    server_error.code()
                ))?.try_into()?;
            println!("sys_m_error_code: {:?}", sys_m_error_code);
        }
    }

pub fn inner(&self) -> Option<&dyn Error>

Reveal the inner error

Trait Implementations

impl Debug for HdbError

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

Formats the value using the given formatter.

impl Display for HdbError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for HdbError

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

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.

impl From<DecompressError> for HdbError

fn from(source: DecompressError) -> Self

Converts to this type from the input type.

impl From<DeserializationError> for HdbError

fn from(source: DeserializationError) -> Self

Converts to this type from the input type.

impl From<Error> for HdbError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HdbError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<HdbError> for DeserializationError

fn from(e: HdbError) -> Self

Converts to this type from the input type.

impl<G> From<PoisonError<G>> for HdbError

fn from(_error: PoisonError<G>) -> Self

Converts to this type from the input type.

impl From<SerializationError> for HdbError

fn from(source: SerializationError) -> Self

Converts to this type from the input type.

impl From<ServerError> for HdbError

fn from(source: ServerError) -> Self

Converts to this type from the input type.