Enum PgError 

pub enum PgError {
    Io(Error),
    Protocol(String),
    Auth(String),
    Server(Box<ServerError>),
    ConnectionClosed,
    NoRows,
    TypeConversion(String),
    StatementNotCached,
    BufferOverflow,
    WouldBlock,
    Timeout,
    PoolTimeout,
    PoolExhausted,
    PoolValidationFailed,
}

Errors returned by chopin-pg operations.

Variants

Io(Error)

I/O error from the underlying socket.

Protocol(String)

Protocol violation or unexpected message from server.

Auth(String)

Authentication failure.

Server(Box<ServerError>)

Server-sent error response with rich diagnostic fields.

ConnectionClosed

Connection is closed or in an invalid state.

NoRows

Query returned no rows when one was expected.

TypeConversion(String)

Type conversion error.

StatementNotCached

Statement not found in cache.

BufferOverflow

Buffer overflow — message too large.

WouldBlock

Would block — operation cannot complete without blocking.

Timeout

I/O operation timed out (application-level timeout).

PoolTimeout

Pool: timed out waiting for a connection.

PoolExhausted

Pool: all connections are in use.

PoolValidationFailed

Pool: connection failed validation.

Implementations

impl PgError

pub fn classify(&self) -> ErrorClass

Classify this error for retry decisions.

pub fn is_transient(&self) -> bool

Returns true if this error is transient and the operation can be retried.

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

Get the SQLSTATE code, if this is a server error.

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

Get the hint from the server, if available.

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

Get the detail from the server, if available.

pub fn from_fields(fields: &[(u8, String)]) -> PgError

Build a Server error from parsed error/notice fields.

Trait Implementations

impl Debug for PgError

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

Formats the value using the given formatter.

impl Display for PgError

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

Formats the value using the given formatter.

impl Error for PgError

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

fn from(e: Error) -> PgError

Converts to this type from the input type.

impl From<PgError> for OrmError

fn from(e: PgError) -> Self

Converts to this type from the input type.