Struct KeyValueDiskANNHandle 

pub struct KeyValueDiskANNHandle { /* private fields */ }

A session-bound handle to an already published index. Replacements join the session’s original transaction; snapshots own fixed canonical and physical views independently of subsequent writes, undo and session closure. Structural creation, rebuilding and removal belong to the catalog lifecycle owner.

Implementations

impl KeyValueDiskANNHandle

pub fn replace( &self, document: DocId, vectors: &[Vec<f32>], ) -> StorageBackendResult<DiskANNVectorVersion>

Atomically replace a complete tensor; an empty slice deletes its vector membership while preserving the replacement origin. Catalog checks and commit requirements are evaluated with the canonical write, not in a preceding read transaction.

pub fn snapshot( &self, ) -> StorageBackendResult<RetainedDiskANNIndex<RetainedDiskANNCanonical>>

Prepare one current query view. The returned VectorIndex can be reused and nested without rereading resident PQ data, and keeps its captured generation after this handle advances or closes.

Trait Implementations

impl DiskANNPersistentOwner for KeyValueDiskANNHandle

type Snapshot = RetainedDiskANNIndex<RetainedDiskANNCanonical>

fn dimensions(&self) -> u32

fn parameters(&self) -> DiskANNIndexParams

fn read_limits(&self) -> DiskANNReadLimits

fn control(&self) -> &StorageReadControl

fn query_metadata(&self) -> StorageBackendResult<DiskANNQueryMetadata>

Read the selected manifest and canonical identity on one provider view without preparing graph, PQ or origin readers.

fn snapshot(&self) -> StorageBackendResult<Self::Snapshot>

fn count(&self) -> StorageBackendResult<usize>

fn contains_document(&self, document: DocId) -> StorageBackendResult<bool>

fn replace( &self, document: DocId, vectors: &[Vec<f32>], ) -> StorageBackendResult<()>

fn rebuild( &self, options: DiskANNIndexOptions, temporary: &DiskANNTemporaryBudget, clear: bool, ) -> StorageBackendResult<()>