Struct SparseVectorManager 

pub struct SparseVectorManager { /* private fields */ }

Manages sparse inverted indexes for every (collection, field) pair.

Implementations

impl SparseVectorManager

pub fn new() -> Self

Create an empty manager.

pub fn index_key(collection: &str, field: &str) -> String

Build the "{collection}:{field}" index key.

An empty field maps to the default field name so callers that do not name a field still address a stable index.

pub fn is_empty(&self) -> bool

Whether no collection has any sparse index.

pub fn index_count(&self) -> usize

Number of live indexes.

pub fn index_document( &mut self, collection: &str, field: &str, doc_id: &str, vector: &SparseVector, )

Insert or replace doc_id’s sparse vector for (collection, field).

pub fn remove_document( &mut self, collection: &str, field: &str, doc_id: &str, ) -> bool

Remove doc_id from one (collection, field) index.

Returns true when the document was present.

pub fn remove_document_all_fields( &mut self, collection: &str, doc_id: &str, ) -> usize

Remove doc_id from every sparse index belonging to collection.

Used by the document-delete path, which knows the collection and the document ID but not which fields carried sparse vectors.

pub fn index_document_fields( &mut self, collection: &str, doc_id: &str, fields: &HashMap<String, Value>, )

Reconcile every sparse index of collection against a document’s fields.

String fields that parse as a sparse-vector literal ('{12: 0.5}') are indexed under their own field name. A field that does not parse is not an error — it is simply not a sparse column — but the document is then removed from that field’s index so a column that stops holding a sparse vector cannot leave stale postings behind.

pub fn search( &self, collection: &str, field: &str, query: &SparseVector, top_k: usize, ) -> Vec<SparseHit>

Top-k documents for (collection, field) by dot product, descending.

An absent index yields no hits rather than an error — a collection that has never been written simply has nothing to match.

pub fn checkpoint_data(&self) -> &HashMap<String, SparseInvertedIndex>

Borrow every index for checkpoint serialization.

pub fn load_checkpoint(&mut self, indices: HashMap<String, SparseInvertedIndex>)

Install indexes restored from a checkpoint, replacing current state.

Trait Implementations

impl Default for SparseVectorManager

fn default() -> Self

Returns the “default value” for a type.