Enum ProtocolError

#[non_exhaustive]
pub enum ProtocolError {
    UnexpectedResponse(CqlResponseKind),
    PreparedStatementIdsMismatch,
    RepreparedIdChanged {
        statement: String,
        expected_id: Vec<u8>,
        reprepared_id: Vec<u8>,
    },
    UseKeyspace(UseKeyspaceProtocolError),
    SchemaVersionFetch(SchemaVersionFetchError),
    NonfinishedPagingState,
    InvalidCqlType {
        typ: String,
        position: usize,
        reason: String,
    },
    PartitionKeyExtraction,
    Tracing(TracingProtocolError),
    RepreparedIdMissingInBatch,
}

A protocol error.

It indicates an inconsistency between CQL protocol and server’s behavior. In some cases, it could also represent a misuse of internal driver API - a driver bug.

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.

UnexpectedResponse(CqlResponseKind)

Received an unexpected response when RESULT or ERROR was expected.

PreparedStatementIdsMismatch

Prepared statement id mismatch.

RepreparedIdChanged

Prepared statement id changed after repreparation.

Fields

statement: String

expected_id: Vec<u8>

reprepared_id: Vec<u8>

UseKeyspace(UseKeyspaceProtocolError)

USE KEYSPACE protocol error.

SchemaVersionFetch(SchemaVersionFetchError)

A protocol error appeared during schema version fetch.

NonfinishedPagingState

A result with nonfinished paging state received for unpaged query.

InvalidCqlType

Failed to parse CQL type.

Fields

typ: String

position: usize

reason: String

PartitionKeyExtraction

Unable extract a partition key based on prepared statement’s metadata.

Tracing(TracingProtocolError)

A protocol error occurred during tracing info fetch.

RepreparedIdMissingInBatch

Driver tried to reprepare a statement in the batch, but the reprepared statement’s id is not included in the batch.

Trait Implementations

impl Clone for ProtocolError

fn clone(&self) -> ProtocolError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ProtocolError

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

Formats the value using the given formatter.

impl Display for ProtocolError

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

Formats the value using the given formatter.

impl Error for ProtocolError

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<ProtocolError> for NewSessionError

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for QueryError

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.

impl From<SchemaVersionFetchError> for ProtocolError

fn from(source: SchemaVersionFetchError) -> Self

Converts to this type from the input type.

impl From<TracingProtocolError> for ProtocolError

fn from(source: TracingProtocolError) -> Self

Converts to this type from the input type.

impl From<UseKeyspaceProtocolError> for ProtocolError

fn from(source: UseKeyspaceProtocolError) -> Self

Converts to this type from the input type.