Struct Db 

pub struct Db { /* private fields */ }

A vecdb database: a handle to a directory that holds one or more collections. Cheap to clone-by-reopen; owns no file handles itself — each Collection it hands out owns its own storage.

Implementations

impl Db

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Open (creating if absent) a database rooted at path.

path is a directory. A .vecdb suffix is conventional but not required — the directory holds the per-collection files.

pub fn path(&self) -> &Path

Root directory of this database.

pub fn create_collection( &self, name: impl Into<String>, dimension: usize, ) -> Result<Collection>

Create a new collection with default HNSW config. Errors if a collection of that name already exists.

pub fn create_collection_with( &self, config: CollectionConfig, ) -> Result<Collection>

Create a new collection from a full CollectionConfig.

pub fn create_collection_quantized( &self, name: impl Into<String>, dimension: usize, ) -> Result<Collection>

Create a new collection whose in-memory index uses int8 scalar quantization (~4× smaller index; on-disk vectors stay float32).

pub fn create_collection_binary( &self, name: impl Into<String>, dimension: usize, ) -> Result<Collection>

Create a new collection whose in-memory index uses 1-bit binary quantization (~32× smaller; coarse Hamming distance — best paired with a full-precision rerank of top candidates).

pub fn collection(&self, name: &str) -> Result<Collection>

Open an existing collection. Errors with CollectionNotFound if absent.

pub fn open_or_create(&self, name: &str, dimension: usize) -> Result<Collection>

Open the collection if it exists, otherwise create it with default HNSW config at dimension.

pub fn collection_exists(&self, name: &str) -> bool

Whether a collection with this name exists on disk (by its .db file).

pub fn list_collections(&self) -> Result<Vec<String>>

Sorted names of all collections in this database (scans *.db files).

pub fn drop_collection(&self, name: &str) -> Result<()>

Delete a collection and all its files from disk.

Trait Implementations

impl Clone for Db

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Db

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

Formats the value using the given formatter.