Skip to main content
gpudb_api::errors
Source 
pub enum KineticaError 
    Http(String),
    Avro(String),
    Api(String),
    Unauthorized(String),
    HostnameRegexFailure(String),
    Connection(String),
    Config(String),
    FailoverDisabled(String),
    HaUnavailable(String),
    Exit(String),
    Internal,
    Caused 
        message: String,
        source: Box<KineticaError>,
    ,

The main error type for all Kinetica operations.

All API calls return Result<T, KineticaError> to handle various failure modes.

The variant tells what kind of failure it was: a request that failed on every cluster it could reach is a KineticaError::Connection. The URL a request failed at is in its message.

​
Examples

​
Variants

​
Http(String)

HTTP/network communication error

​
Avro(String)

Avro serialization/deserialization error

Server-side API error (returned by Kinetica)

​
Unauthorized(String)

Unauthorized access error (authentication failed)

​
HostnameRegexFailure(String)

Hostname regex mismatch error

​
Connection(String)

Connection error (server not reachable or not running)

​
Config(String)

Configuration error (invalid parameters, missing permissions, etc.)

​
FailoverDisabled(String)

HA failover is disabled

​
HaUnavailable(String)

HA failover unavailable (all clusters tried)

​
Exit(String)

Server exit/shutdown in progress

​
Internal

Internal client error

​
Caused

An error reported in terms of the one that caused it.

Recovery paths use this to report what actually went wrong while keeping the underlying failure reachable through std::error::Error::source — a retry’s own failure is usually a consequence of the original, and replacing it loses the only useful message.

​
Fields

message: String
source: Box<KineticaError>

​
Implementations

Source

​
pub fn caused(message: impl Into<String>, source: KineticaError) -> Self

Reports message, keeping source as the underlying cause.

See KineticaError::Caused.

Source

​
pub fn message(&self) -> String

The error’s message without the kind of error before it.

The error underneath this one, following the chain to its root.

Returns self when nothing is attached. Useful for inspecting what actually failed when an error has been re-reported by a recovery path.

​
Trait Implementations

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source

​
fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source

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

Formats the value using the given formatter. Read more
Source

​
fn fmt(&self, __formatter: &mut Formatter<’_>) -> Result

Formats the value using the given formatter. Read more
Source

​
fn source(&self) -> Option<&(dyn Error + ‘static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source

​
fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

Read more
1.0.0 · Source

​
fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source

​
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. Read more
Converts to this type from the input type.
Converts to this type from the input type.
Source

​
fn from(error: QueueError<T>) -> Self

Converts to this type from the input type.