Struct Engine 

pub struct Engine { /* private fields */ }

Per-table engine handle.

One engine wraps one VectorStore table. The store is held behind an Arc so multiple handles can share the same underlying state (the registry never duplicates a store; it just hands out further Engine clones).

Implementations

impl Engine

pub fn in_memory(schema: TableSchema) -> Result<Self, StoreError>

Build a fresh in-memory engine for schema.

The schema’s name becomes the engine’s table name. The returned engine is the only handle on the new store; if the registry wants a second handle it should Engine::clone this one.

Errors

Surfaces any StoreError from VectorStore::create_table.

pub fn with_store(store: Arc<VectorStore>, table: String) -> Self

Wrap an existing VectorStore that already holds the table. Used by embedders that want to share a store across many engines.

pub fn table_name(&self) -> &str

Bound table name.

pub fn store(&self) -> &Arc<VectorStore>

Borrow the underlying VectorStore.

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

Insert or overwrite a vector row.

Errors

Forwards every StoreError from VectorStore::upsert.

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

Fetch the row at key.

Errors

Forwards every StoreError from VectorStore::get.

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

Delete the row at key.

Errors

Forwards every StoreError from VectorStore::delete.

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

Run a top-k ANN search.

Errors

Forwards every StoreError from VectorStore::search.

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

Per-table snapshot statistics.

Errors

Forwards every StoreError from VectorStore::stats.

Trait Implementations

impl Clone for Engine

fn clone(&self) -> Engine

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Engine

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

Formats the value using the given formatter.