Enum tikv_client::Error

pub enum Error {
    Unimplemented,
    DuplicateKeyInsertion,
    ResolveLockError(Vec<LockInfo>),
    InvalidTransactionType,
    OperationAfterCommitError,
    OnePcFailure,
    NoPrimaryKey,
    UnsupportedMode,
    NoCurrentRegions,
    EntryNotFoundInRegionCache,
    Io(Error),
    Channel(RecvError),
    Grpc(Error),
    GrpcAPI(Status),
    Url(InvalidUri),
    Canceled(Canceled),
    RegionError(Box<Error>),
    UndeterminedError(Box<Error>),
    KeyError(Box<KeyError>),
    ExtractedErrors(Vec<Error>),
    MultipleKeyErrors(Vec<Error>),
    ColumnFamilyError(String),
    JoinError(JoinError),
    RegionForKeyNotFound {
        key: Vec<u8>,
    },
    RegionForRangeNotFound {
        range: BoundRange,
    },
    RegionNotFoundInResponse {
        region_id: u64,
    },
    LeaderNotFound {
        region_id: u64,
    },
    MaxScanLimitExceeded {
        limit: u32,
        max_limit: u32,
    },
    InvalidSemver(Error),
    KvError {
        message: String,
    },
    InternalError {
        message: String,
    },
    StringError(String),
    PessimisticLockError {
        inner: Box<Error>,
        success_keys: Vec<Vec<u8>>,
    },
}

An error originating from the TiKV client or dependencies.

Variants

Unimplemented

Feature is not implemented.

DuplicateKeyInsertion

Duplicate key insertion happens.

ResolveLockError(Vec<LockInfo>)

Failed to resolve a lock

InvalidTransactionType

Will raise this error when using a pessimistic txn only operation on an optimistic txn

OperationAfterCommitError

It’s not allowed to perform operations in a transaction after it has been committed or rolled back.

OnePcFailure

We tried to use 1pc for a transaction, but it didn’t work. Probably should have used 2pc.

NoPrimaryKey

An operation requires a primary key, but the transaction was empty.

UnsupportedMode

For raw client, operation is not supported in atomic/non-atomic mode.

NoCurrentRegions

EntryNotFoundInRegionCache

Io(Error)

Wraps a std::io::Error.

Channel(RecvError)

Wraps a std::io::Error.

Grpc(Error)

Wraps a grpcio::Error.

GrpcAPI(Status)

Wraps a grpcio::Error.

Url(InvalidUri)

Wraps a grpcio::Error.

Canceled(Canceled)

Represents that a futures oneshot channel was cancelled.

RegionError(Box<Error>)

Errors caused by changes of region information

UndeterminedError(Box<Error>)

Whether the transaction is committed or not is undetermined

KeyError(Box<KeyError>)

Wraps crate::proto::kvrpcpb::KeyError

ExtractedErrors(Vec<Error>)

Multiple errors generated from the ExtractError plan.

MultipleKeyErrors(Vec<Error>)

Multiple key errors

ColumnFamilyError(String)

Invalid ColumnFamily

JoinError(JoinError)

Can’t join tokio tasks

RegionForKeyNotFound

Fields

key: Vec<u8>

No region is found for the given key.

RegionForRangeNotFound

Fields

range: BoundRange

RegionNotFoundInResponse

Fields

region_id: u64

No region is found for the given id. note: distinguish it with the RegionNotFound error in errorpb.

LeaderNotFound

Fields

region_id: u64

No leader is found for the given id.

MaxScanLimitExceeded

Fields

limit: u32

max_limit: u32

Scan limit exceeds the maximum

InvalidSemver(Error)

KvError

Fields

message: String

A string error returned by TiKV server

InternalError

Fields

message: String

StringError(String)

PessimisticLockError

Fields

inner: Box<Error>

success_keys: Vec<Vec<u8>>

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

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<Canceled> for Error

fn from(source: Canceled) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<InvalidUri> for Error

fn from(source: InvalidUri) -> Self

Converts to this type from the input type.

impl From<JoinError> for Error

fn from(source: JoinError) -> Self

Converts to this type from the input type.

impl From<RecvError> for Error

fn from(source: RecvError) -> Self

Converts to this type from the input type.

impl From<Status> for Error

fn from(source: Status) -> Self

Converts to this type from the input type.