Enum Error 

pub enum Error {
    Io(Error),
    Storage(String),
    SqlParse(String),
    QueryExecution(String),
    QueryTimeout(String),
    QueryCancelled(String),
    Transaction(String),
    TypeConversion(String),
    Config(String),
    Encryption(String),
    Protocol(String),
    VectorIndex(String),
    MultiTenant(String),
    Audit(String),
    Compression(String),
    BranchMerge(String),
    MergeConflict(String),
    ConstraintViolation(String),
    LockPoisoned(String),
    Generic(String),
}

Database error type

All errors from HeliosDB Lite operations are represented by this enum. Each variant includes a human-readable message describing the error.

Creating Errors

Use the constructor methods for creating errors:

use heliosdb_nano::Error;

let err = Error::storage("Table not found: users");
let err = Error::transaction("Deadlock detected");
let err = Error::query_timeout("Query exceeded 30s limit");

Variants

Io(Error)

I/O error

Storage(String)

Storage error

SqlParse(String)

SQL parsing error

QueryExecution(String)

Query execution error

QueryTimeout(String)

Query timeout error

QueryCancelled(String)

Query cancelled error

Transaction(String)

Transaction error

TypeConversion(String)

Type conversion error

Config(String)

Invalid configuration

Encryption(String)

Encryption error

Protocol(String)

Protocol error

VectorIndex(String)

Vector index error

MultiTenant(String)

Multi-tenancy error

Audit(String)

Audit error

Compression(String)

Compression error

BranchMerge(String)

Branch merge error

MergeConflict(String)

Merge conflict error

ConstraintViolation(String)

Constraint violation error (FK, CHECK, UNIQUE)

LockPoisoned(String)

Lock poisoning error (mutex/rwlock poisoned)

Generic(String)

Generic error

Implementations

impl Error

pub fn storage(msg: impl Into<String>) -> Self

Create a storage error

pub fn sql_parse(msg: impl Into<String>) -> Self

Create a SQL parse error

pub fn query_execution(msg: impl Into<String>) -> Self

Create a query execution error

pub fn query_timeout(msg: impl Into<String>) -> Self

Create a query timeout error

pub fn query_cancelled(msg: impl Into<String>) -> Self

Create a query cancelled error

pub fn transaction(msg: impl Into<String>) -> Self

Create a transaction error

pub fn type_conversion(msg: impl Into<String>) -> Self

Create a type conversion error

pub fn config(msg: impl Into<String>) -> Self

Create a config error

pub fn encryption(msg: impl Into<String>) -> Self

Create an encryption error

pub fn protocol(msg: impl Into<String>) -> Self

Create a protocol error

pub fn vector_index(msg: impl Into<String>) -> Self

Create a vector index error

pub fn multi_tenant(msg: impl Into<String>) -> Self

Create a multi-tenant error

pub fn audit(msg: impl Into<String>) -> Self

Create an audit error

pub fn compression(msg: impl Into<String>) -> Self

Create a compression error

pub fn branch_merge(msg: impl Into<String>) -> Self

Create a branch merge error

pub fn merge_conflict(msg: impl Into<String>) -> Self

Create a merge conflict error

pub fn constraint_violation(msg: impl Into<String>) -> Self

Create a constraint violation error (FK, CHECK, UNIQUE)

pub fn network(msg: impl Into<String>) -> Self

Create a network error

pub fn authentication(msg: impl Into<String>) -> Self

Create an authentication error

pub fn io(msg: impl Into<String>) -> Self

Create an I/O error from a message

pub fn internal(msg: impl Into<String>) -> Self

Create an internal error

pub fn execution(msg: impl Into<String>) -> Self

Create an execution error

pub fn lock_poisoned(msg: impl Into<String>) -> Self

Create a lock poisoning error

pub fn resource_limit(msg: impl Into<String>) -> Self

Create a resource limit error

pub fn deadlock(msg: impl Into<String>) -> Self

Create a deadlock error

pub fn ha(msg: impl Into<String>) -> Self

Create a high availability error

pub fn switchover(msg: impl Into<String>) -> Self

Create a switchover error

pub fn replication(msg: impl Into<String>) -> Self

Create a replication error

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)>

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

fn from(err: 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(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MySqlError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<ParserError> for Error

fn from(err: ParserError) -> Self

Converts to this type from the input type.