Struct SealedRingDb 

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

Sealed (immutable) ring-query database.

Obtained by calling RingDb::build() or RingDb::load().

The hot side (vectors + norms) is owned by the compute backend. The cold side (payloads) lives in a file-backed mmap via T::Store.

Implementations

impl<T: Payload> SealedRingDb<T>

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

Execute a ring query and return matching vector IDs.

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

Execute a range query: all vectors with distance in [d_min, d_max].

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

Execute a disk query: all vectors within radius d_max.

pub fn query_disk_intersection( &self, q: &DiskIntersectionQuery<'_>, ) -> Result<QueryResult>

Execute a disk-intersection query: all vectors inside every disk.

Returned hit distances are measured against the first disk.

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

Fetch and deserialize the payload for a single vector ID.

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

Fetch and deserialize payloads for a slice of 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.

impl<T: Payload> SealedRingDb<T>

where T::Store: RefPayloadStore<T>,

pub fn fetch_pod(&self, id: u32) -> &T

Fetch a zero-copy reference to the payload for a single vector ID.

Returns a &T pointing directly into the mmap — O(1), no allocation, no deserialization. Only available for #[payload(storage = "pod")] types.

pub fn fetch_pods<'a>(&'a self, ids: &[u32]) -> Vec<&'a T>

Fetch zero-copy references to payloads for a slice of IDs, in order.