Skip to content
SrvDB

Handling errors

Exception When
ValueError Invalid input: wrong dimension, NaN or infinity, k < 1, empty or duplicate ids, metadata that is not a JSON object, unknown mode, a call that does not fit the current mode
BlockingIOError The database is already open elsewhere
OSError The operating system reported an I/O failure (disk full, permissions, …)
RuntimeError An internal fault, including a corrupt database file

Input is validated before anything is written, so a rejected call leaves the database unchanged.

try:
    db.add(ids, vectors, metas)
except ValueError as e:
    log.warning("rejected batch: %s", e)    # fix the input and retry
except OSError:
    raise                                    # disk problem: stop

Messages say what went wrong and how to fix it. They never contain your vectors or metadata.

Rust

Section titled “Rust”

The public API returns srvdb::Result<T> with a typed srvdb::Error:

match db.search(&query, 10) {
    Ok(hits) => { /* ... */ }
    Err(srvdb::Error::DimensionMismatch { expected, actual }) => { /* ... */ }
    Err(e) => return Err(e.into()),
}

Variants: InvalidInput, DimensionMismatch, InvalidState, Locked, Corrupt, Io, Internal.