Enum PgError 

pub enum PgError {
    Connection(String),
    Protocol(String),
    Auth(String),
    Query(String),
    QueryServer(PgServerError),
    NoRows,
    Io(Error),
    Encode(String),
    Timeout(String),
    PoolExhausted {
        max: usize,
    },
    PoolClosed,
}

Error type for PostgreSQL driver operations.

Variants

Connection(String)

TCP / TLS connection failure with the PostgreSQL server.

Protocol(String)

Wire-protocol framing or decoding error.

Auth(String)

Authentication failure (bad password, unsupported mechanism, etc.).

Query(String)

Query execution error returned by the backend (e.g. constraint violation).

QueryServer(PgServerError)

Structured server error with SQLSTATE and optional detail/hint fields.

NoRows

The query returned zero rows when at least one was expected.

Io(Error)

I/O error (preserves inner error for chaining)

Encode(String)

Encoding error (parameter limit, etc.)

Timeout(String)

Operation timed out (connection, acquire, query)

PoolExhausted

Pool exhausted — all connections are in use

Fields

max: usize

Maximum pool size that was reached.

PoolClosed

Pool is closed and no longer accepting requests

Implementations

impl PgError

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

Return structured server error fields when available.

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

Return SQLSTATE code when available.

pub fn is_prepared_statement_retryable(&self) -> bool

True when a cached prepared statement can be self-healed by clearing local statement state and retrying once.

pub fn is_prepared_statement_already_exists(&self) -> bool

True when server reports the prepared statement name already exists.

This typically means local cache eviction drifted from server state (e.g. local entry dropped while backend statement still exists). Callers can retry once without Parse after preserving local mapping.

pub fn is_transient_server_error(&self) -> bool

True when the error is a transient server condition that may succeed on retry. Covers serialization failures, deadlocks, standby unavailability, connection exceptions, and prepared-statement staleness.

Callers should pair this with a bounded retry loop and backoff.

Trait Implementations

impl Debug for PgError

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

Formats the value using the given formatter.

impl Display for PgError

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

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

fn from(e: EncodeError) -> Self

Converts to this type from the input type.

impl From<Error> for PgError

fn from(e: Error) -> Self

Converts to this type from the input type.