Struct DbError 

pub struct DbError {
    pub severity: SmallString<8>,
    pub code: SmallString<5>,
    pub message: String,
    pub detail: Option<String>,
    pub hint: Option<String>,
    pub position: Option<i32>,
    pub constraint: Option<String>,
    pub table: Option<String>,
    pub column: Option<String>,
    pub schema: Option<String>,
    pub data_type: Option<String>,
}

A structured ErrorResponse / NoticeResponse from the server.

Fields

severity: SmallString<8>

Localized severity (ERROR, FATAL, …).

Stored inline; only values longer than 8 bytes (unusual localizations) spill onto the heap.

code: SmallString<5>

SQLSTATE code.

The wire protocol bounds this to five bytes, so it is always stored inline and decoding it never allocates.

message: String

Primary human-readable message.

detail: Option<String>

Optional detail.

hint: Option<String>

Optional hint.

position: Option<i32>

Optional 1-based character position in the query.

constraint: Option<String>

Optional constraint name.

table: Option<String>

Optional table name.

column: Option<String>

Optional column name.

schema: Option<String>

Optional schema name.

data_type: Option<String>

Optional data type name.

Implementations

impl DbError

pub fn class(&self) -> &str

Returns the SQLSTATE class (the first two characters), e.g. 23 for integrity constraint violations.

Returns "" when no code was reported. The code is server-supplied and may contain arbitrary bytes, so a short or non-ASCII code is truncated at a character boundary rather than panicking.

pub fn is_data_exception(&self) -> bool

true for SQLSTATE class 22 (data exception).

pub fn is_integrity_violation(&self) -> bool

true for SQLSTATE class 23 (integrity constraint violation).

pub fn is_unique_violation(&self) -> bool

true for 23505 (unique violation).

pub fn is_foreign_key_violation(&self) -> bool

true for 23503 (foreign key violation).

pub fn is_retryable(&self) -> bool

true for 40P01 (deadlock detected) or 40001 (serialization failure), both of which are safe to retry.

Trait Implementations

impl Clone for DbError

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 DbError

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

Formats the value using the given formatter.

impl Default for DbError

fn default() -> Self

Returns the “default value” for a type.

impl Display for DbError

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

Formats the value using the given formatter.

impl Error for DbError

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<DbError> for Error

fn from(err: DbError) -> Self

Converts to this type from the input type.