Struct PgvectorAdapter 

pub struct PgvectorAdapter { /* private fields */ }

A search backend that stores and queries vectors via pgvector.

Compile-time availability of the postgres connection depends on the live-db feature flag. Without it, all methods return BackendError::Adapter("live-db feature required").

Implementations

impl PgvectorAdapter

pub fn new(table: impl Into<String>) -> Result<Self, BackendError>

Create a new adapter for the given table (stub without live-db).

Only validates the table name; all operational methods will return an error until the live-db feature is enabled.

Errors

Returns Err if table fails the allowlist regex validation.

pub fn ensure_schema(&mut self, dim: usize) -> Result<(), BackendError>

Create the vector extension and the vectors table if they do not exist.

Errors

Returns Err when the live-db feature is disabled, or on any postgres::Error.

pub fn ensure_index(&self, lists: u32) -> Result<(), BackendError>

Create an approximate nearest-neighbour index on the embedding column.

lists controls the number of IVFFlat lists. If 0, defaults to 100.

Errors

Returns Err when the live-db feature is disabled, or on any postgres::Error.

pub fn table(&self) -> &str

The table name used by this adapter.

Trait Implementations

impl SearchBackend for PgvectorAdapter

fn ingest( &mut self, vectors: &[(VectorId, Vec<f32>)], ) -> Result<(), BackendError>

Store the supplied (VectorId, Vec<f32>) pairs.

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

Return the top_k nearest vectors to query by cosine similarity, sorted descending.

fn remove(&mut self, vector_ids: &[VectorId]) -> Result<(), BackendError>

Remove vectors by id.

fn len(&self) -> usize

Number of vectors currently stored.

fn dim(&self) -> Option<usize>

The locked dimension, or None if no vectors have been ingested yet.

fn is_empty(&self) -> bool

Returns true if no vectors are stored.