#[non_exhaustive]pub enum Error {
Show 16 variants
Unknown,
NoResult,
ConnectionFailed,
PathConflict {
active: String,
requested: String,
},
InvalidData(String),
PathError,
Io(Error),
Nul(NulError),
InsufficientPermissions,
NonUtf8Sequence(FromUtf8Error),
InvalidUtf8(Utf8Error),
EngineVersionUnavailable,
EngineCallFailed {
call: &'static str,
},
QueryError(String),
ConnectionsStillOpen {
count: usize,
},
EngineShutDown,
}Expand description
Errors that can occur when using chdb-rust.
This enum represents all possible errors that can be returned by the library.
Most errors are self-explanatory, with QueryError containing the actual error
message from the underlying chDB library.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
Unknown
An unknown error has occurred.
NoResult
No result was returned from the query.
ConnectionFailed
Failed to establish a connection to chDB.
PathConflict
The engine is already bound to a different data path.
One engine per process serves one storage path. An in-memory connection
counts as a path of its own, since the engine binds :memory: when none
is given.
Fields
InvalidData(String)
Invalid data was encountered.
PathError
Invalid path was provided.
Io(Error)
An I/O error occurred.
Nul(NulError)
A null byte was found in a string where it’s not allowed.
InsufficientPermissions
Insufficient permissions to access the directory.
NonUtf8Sequence(FromUtf8Error)
The data contains invalid UTF-8 sequences.
InvalidUtf8(Utf8Error)
The result data is not valid UTF-8.
Returned by QueryResult::data_str,
which checks the bytes in place rather than copying them first.
The linked library cannot report which chdb-core release it is.
chdb_version() arrived in chdb-core v26.7.0; an older library does not
export it, so there is nothing to call. Deliberately not answered with
SELECT version(), which reports a ClickHouse version — a different
scheme, and so not a substitute.
EngineCallFailed
A chDB call reported failure without saying why.
call names the C function, so the two cases this covers — a shutdown
that could not stop every engine thread, and an insert-stream append
that failed with no error recorded on the stream — can be told apart.
QueryError(String)
A query execution error occurred.
This contains the error message from the underlying chDB library, which typically includes details about SQL syntax errors, missing tables, etc.
ConnectionsStillOpen
Shutdown was asked for while connections were still open.
The engine refuses this rather than tearing itself down under a live connection. Close every connection and drop every result first.
EngineShutDown
The engine was shut down earlier in this process.
runtime::shutdown is one-way: once it
succeeds the library is closed for business for the rest of the process.
Trait Implementations§
Source§impl Error for Error
impl Error for Error
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()