clickhouse-cloud-api 0.3.1

Typed Rust client for the ClickHouse Cloud API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Error types for the ClickHouse Cloud API client.

/// Errors that can occur when using the client.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// HTTP transport error.
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    /// JSON serialization/deserialization error.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    /// API returned an error response.
    #[error("API error (status {status}): {message}")]
    Api { status: u16, message: String },

    /// Operation requires a different auth mode than the client was configured with.
    #[error("auth mismatch: {0}")]
    AuthMismatch(String),

    /// The Query API reported the service is idled and asked for an explicit
    /// wake confirmation (HTTP 206 `Confirm wake service`). Retry the query
    /// with `wake_service` set to wake the service and run it.
    #[error("service is idle; retry the query with wake_service to wake it")]
    ServiceIdle,

    /// The Query API reported the service is stopped (HTTP 206 `Service is
    /// stopped`). A stopped service is never woken by the Query API; it must
    /// be started explicitly.
    #[error("service is stopped; it must be started before it can be queried")]
    ServiceStopped,
}