Struct VectorCollection 

pub struct VectorCollection { /* private fields */ }

Scale-aware vector collection

Implementations

impl VectorCollection

pub fn open(conn: &Arc<SochConnection>, name: &str) -> Result<Self>

Open or create a vector collection

pub fn create( conn: &Arc<SochConnection>, name: &str, dimension: usize, ) -> Result<Self>

Create a new collection with specified dimension

pub fn train_pq(&mut self) -> Result<()>

Train the Product Quantizer on existing vectors

Should be called after adding sufficient vectors (at least 1000). Training improves search quality significantly.

pub fn is_pq_trained(&self) -> bool

Check if PQ is trained

pub fn name(&self) -> &str

Get collection name

pub fn dimension(&self) -> usize

Get vector dimension

pub fn len(&self) -> usize

Get number of vectors

pub fn is_empty(&self) -> bool

Check if empty

pub fn add(&mut self, ids: &[&str], vectors: &[Vec<f32>]) -> Result<()>

Add vectors (auto-promotes backend if needed)

pub fn add_one(&mut self, id: &str, vector: Vec<f32>) -> Result<()>

Add a single vector

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

Search for nearest neighbors

pub fn get(&self, id: &str) -> Option<Vec<f32>>

Get vector by ID

pub fn delete(&mut self, id: &str) -> Result<bool>

Delete vector by ID

pub fn stats(&self) -> VectorStats

Get statistics

pub fn compression_ratio(&self) -> Option<f32>

Get compression ratio if PQ is trained

pub fn migrate_batch(&mut self) -> Result<usize>

Migrate a batch of vectors (call periodically during idle time)