Enum SQLError 

pub enum SQLError {
    Parse(String),
    Unsupported(String),
    NotificationRequiresSubscription,
    UnknownTable(String),
    UnknownColumn(String),
    AmbiguousColumn(String),
    UnknownFunction(String),
    TypeMismatch(String),
    BadArity {
        name: String,
        expected: String,
        actual: usize,
    },
    MissingParam(usize),
    VectorDimMismatch {
        expected: usize,
        actual: usize,
    },
    Cancelled(QueryCancelled),
    Routine {
        sqlstate: String,
        message: String,
    },
    Diagnostic {
        sqlstate: String,
        message: String,
        detail: Option<String>,
        hint: Option<String>,
    },
    Internal(String),
}

Variants

Parse(String)

Unsupported(String)

NotificationRequiresSubscription

The host configured this SQL session to require an independently owned notification subscription.

UnknownTable(String)

UnknownColumn(String)

AmbiguousColumn(String)

UnknownFunction(String)

TypeMismatch(String)

BadArity

Fields

name: String

expected: String

actual: usize

MissingParam(usize)

VectorDimMismatch

Fields

expected: usize

actual: usize

Cancelled(QueryCancelled)

Routine

Error raised by (or on behalf of) a user-defined SQL / PL/pgSQL routine. Carries an explicit SQLSTATE so EXCEPTION WHEN <condition> handlers and SQLSTATE / SQLERRM report the same code PostgreSQL would.

Fields

sqlstate: String

message: String

Diagnostic

A primary SQL error with separate PostgreSQL diagnostic fields. SQLERRM and Display expose only the primary message; protocol clients receive detail and hint independently.

Fields

sqlstate: String

message: String

detail: Option<String>

hint: Option<String>

Internal(String)

Implementations

impl SQLError

pub const fn code(&self) -> Option<&'static str>

Stable application error code, separate from the five-character SQLSTATE. Ordinary SQL errors do not acquire an application code.

pub fn undefined_function_call(signature: &str) -> Self

ParseFuncOrColumn’s error when no function matches a call: signature is the name with its argument types, as func_signature_string spells it.

pub fn ambiguous_function_call(signature: &str) -> Self

ParseFuncOrColumn’s error when more than one function matches a call equally well.

pub fn function_call_resolution( sqlstate: &str, signature: &str, suffix: &str, ) -> Self

A failed call resolution in ParseFuncOrColumn’s terms: 42883 when no function matches and 42725 when no candidate is best, each with its hint.

pub fn unknown_qualified_column(qualifier: &str, column: &str) -> Self

pub fn sqlstate(&self) -> Option<&str>

PostgreSQL SQLSTATE code for the error, mirroring the the current exception-to-state mapping. None for errors that do not carry a defined SQLSTATE.

pub fn detail(&self) -> Option<&str>

PostgreSQL DETAIL field, reported separately from the primary message.

pub fn hint(&self) -> Option<&str>

PostgreSQL HINT field, reported separately from the primary message.

Trait Implementations

impl Clone for SQLError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SQLError

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

Formats the value using the given formatter.

impl Display for SQLError

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

Formats the value using the given formatter.

impl Error for SQLError

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.

impl From<&SQLError> for DeferredSQLError

fn from(error: &SQLError) -> Self

Converts to this type from the input type.

impl From<CatalogRetentionError> for SQLError

fn from(error: CatalogRetentionError) -> Self

Converts to this type from the input type.

impl From<DeferredSQLError> for SQLError

fn from(error: DeferredSQLError) -> Self

Converts to this type from the input type.

impl From<Error> for SQLError

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<MemoryError> for SQLError

fn from(error: MemoryError) -> Self

Converts to this type from the input type.

impl From<QueryCancelled> for SQLError

fn from(source: QueryCancelled) -> Self

Converts to this type from the input type.

impl From<SQLError> for SequenceValueError

fn from(source: SQLError) -> Self

Converts to this type from the input type.

impl From<ValueRetentionError> for SQLError

fn from(error: ValueRetentionError) -> Self

Converts to this type from the input type.