Struct VectorStore 

pub struct VectorStore { /* private fields */ }

Per-table store front.

Implementations

impl VectorStore

pub fn open(backend: Arc<dyn Backend>) -> Result<Self, StoreError>

Build a new store on top of backend and rehydrate every schema / row that the backend already persists. The rehydration walks every row in every table and rebuilds the HNSW indexes from scratch; for the MVP this is preferable to persisting the HNSW topology because the table sizes we care about (up to ~10 million vectors) rebuild in seconds.

Errors

Surfaces any backend error encountered during the rehydration walk.

pub fn in_memory() -> Self

Build a fresh in-memory store. Convenience for tests and embedders that do not need persistence.

pub fn create_table(&self, schema: TableSchema) -> Result<(), StoreError>

Register a new TableSchema.

Errors

StoreError::TableExists when the schema’s name is already in use.

pub fn tables(&self) -> Vec<TableSchema>

List every registered table.

pub fn upsert( &self, table: &str, key: RowKey, vector: &[f32], metadata: HashMap<String, Value>, ) -> Result<(), StoreError>

Insert or overwrite a vector row.

The vector slice is encoded with the table’s codec and fed to the HNSW index in f32 form. Re-inserts (same key) replace the prior row in the row store and link a fresh HNSW node, soft-deleting the prior one.

Errors

StoreError::UnknownTable when the table is not registered, StoreError::DimensionMismatch when the vector’s dimension does not match the table dimension, and StoreError::Encoding / StoreError::Index / StoreError::Backend for the underlying failures.

pub fn get( &self, table: &str, key: &[u8], ) -> Result<Option<VectorRow>, StoreError>

Fetch the row at (table, key).

Errors

StoreError::UnknownTable for an unregistered table; StoreError::Backend for a backend failure.

pub fn delete(&self, table: &str, key: &[u8]) -> Result<bool, StoreError>

Delete the row at (table, key). Returns true when present.

Errors

StoreError::UnknownTable for an unregistered table; StoreError::Backend for a backend failure.

pub fn search( &self, table: &str, query: &[f32], k: usize, ef: Option<usize>, ) -> Result<Vec<(VectorRow, f32)>, StoreError>

Run a top-k ANN search against table with query.

ef overrides the index’s default search beam width.

Errors

StoreError::UnknownTable for an unregistered table; StoreError::DimensionMismatch when the query dimension does not match the table dimension.

pub fn stats(&self, table: &str) -> Result<TableStats, StoreError>

Per-table snapshot statistics: live row count, soft- deleted node count, dimension, codec.

Errors

StoreError::UnknownTable for an unregistered table.