Struct SealedRingDb 

pub struct SealedRingDb<T = ()> { /* private fields */ }

Sealed (immutable) ring-query database.

Obtained by calling RingDb::build() or RingDb::load(). Vectors can no longer be inserted — only queries and payload fetches are allowed.

The hot side (vectors + norms) is owned by the compute backend. The cold side (payloads) lives in an anonymous mmap managed by [PayloadStore].

Implementations

impl<T: Serialize + DeserializeOwned> SealedRingDb<T>

pub fn query(&self, q: &RingQuery<'_>) -> Result<QueryResult, RingDbError>

Execute a ring query and return matching vector IDs.

The ring [d - lambda, d + lambda] is converted to [d_min, d_max] internally; negative lower bounds are clamped to 0.

pub fn query_range( &self, q: &RangeQuery<'_>, ) -> Result<QueryResult, RingDbError>

Execute a range query and return matching vector IDs.

Returns all vectors whose Euclidean distance to the query lies in [d_min, d_max].

pub fn query_disk(&self, q: &DiskQuery<'_>) -> Result<QueryResult, RingDbError>

Execute a disk query and return matching vector IDs.

Returns all vectors within Euclidean distance d_max of the query (i.e. the full ball of radius d_max, equivalent to d_min = 0).

pub fn fetch_payload(&self, id: u32) -> Result<T, RingDbError>

Fetch the payload for a single vector ID.

Reads and deserializes from the cold mmap. Call this after query to retrieve metadata for the matching vectors.

pub fn fetch_payloads(&self, ids: &[u32]) -> Result<Vec<T>, RingDbError>

Fetch payloads for a slice of vector IDs, in order.

pub fn len(&self) -> usize

Number of vectors stored.

pub fn is_empty(&self) -> bool

Returns true if the database contains no vectors.

pub fn dims(&self) -> usize

Number of dimensions per vector.

pub fn backend_name(&self) -> &str

Name of the backend currently in use.