Enum QueryError 

#[non_exhaustive]
pub enum QueryError {
    Overloaded {
        attempts: u32,
        source: Box<Error<QueryError>>,
    },
    Submit(Error<QueryError>),
    AsyncRequested,
    Async(Box<AsyncQueryResponse>),
    Poll(Error<GetResultError>),
    Result(ResultError),
}

Error returned by the enhanced query (Client::query / [execute_query]).

Marked #[non_exhaustive]: new variants may be added without a breaking change, so downstream matches should carry a wildcard arm.

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.

Overloaded

HTTP 429 (OVERLOADED) retries were exhausted (by retry count or by the deadline budget). Distinct from a generic 503 so callers can treat transient admission shedding differently from a hard resource error.

Fields

attempts: u32

How many requests were made before giving up.

source: Box<Error<QueryError>>

The last 429 response, for context.

Submit(Error<QueryError>)

Query submission failed with a non-429 status, or a transport/decode error occurred. Carries the same error shape as the generated query op, so all non-overload errors propagate unchanged.

AsyncRequested

query was called on a request with async = true. That opts into an asynchronous submission whose acknowledgement the synchronous-results path cannot return, so the request is rejected up front (before any round-trip). Use Client::submit_query for async queries.

Async(Box<AsyncQueryResponse>)

The server fell back to asynchronous execution (HTTP 202) — e.g. a request with async_after_ms whose synchronous attempt timed out — so there are no inline rows to return. The acknowledgement (carrying the query_run_id to poll) is passed through untouched; or call Client::submit_query directly.

Poll(Error<GetResultError>)

An API error while polling or paginating the result during auto-follow (other than the 409 that signals a failed result).

Result(ResultError)

A result-lifecycle error during auto-follow. Match this to handle the whole ResultError family at once.

Trait Implementations

impl Debug for QueryError

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

Formats the value using the given formatter.

impl Display for QueryError

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

Formats the value using the given formatter.

impl Error for QueryError

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<ResultError> for QueryError

fn from(e: ResultError) -> Self

Converts to this type from the input type.