Skip to main content

RetainedSQLiteDiskANNCanonical

Struct RetainedSQLiteDiskANNCanonical 

Source
pub struct RetainedSQLiteDiskANNCanonical { /* private fields */ }
Expand description

A fixed native canonical source. Each visitor borrows one vector; it must not reenter this source. Failure invalidates any partial output.

Implementations§

Source§

impl RetainedSQLiteDiskANNCanonical

Source

pub fn next_change_after( &self, after: Option<DocId>, control: &StorageReadControl, ) -> StorageBackendResult<Option<DiskANNChangeIdentity>>

Return each currently journaled document once on this canonical view, including an empty replacement. This does not establish the coverage of a published generation.

Source§

impl RetainedSQLiteDiskANNCanonical

Source

pub fn into_vector_index( self, resolver: &dyn DiskANNIndexResolver, limits: DiskANNReadLimits, control: &StorageReadControl, ) -> StorageBackendResult<Option<RetainedDiskANNIndex<Self>>>

Consume the retained native view into the common read-only VectorIndex owner without copying canonical vectors or reconstructing the graph.

Source

pub fn query( &self, resolver: &dyn DiskANNIndexResolver, limits: DiskANNReadLimits, control: &StorageReadControl, ) -> StorageBackendResult<Option<DiskANNQuery<'_>>>

Prepare the common Storage document search on this native canonical/catalog view and its selected physical source.

Source

pub fn selected_source( &self, resolver: &dyn DiskANNIndexResolver, control: &StorageReadControl, ) -> StorageBackendResult<Option<Arc<KeyValueDiskANNSource>>>

Select physical graph data on this native canonical/catalog view, retaining private publication resources without advancing the SQL snapshot or loading page/PQ bodies.

Source§

impl RetainedSQLiteDiskANNCanonical

Source

pub fn index_scope( &self, resolver: &dyn DiskANNIndexResolver, control: &StorageReadControl, ) -> StorageBackendResult<DiskANNIndexScope>

Resolve the index incarnation from this source’s fixed native catalog view through the SQL owner.

Source

pub fn index_parameters(&self) -> Option<DiskANNIndexParams>

Source

pub fn require_current_index( &self, read: &dyn KeyValueRead, batch: &mut dyn KeyValueBatch, control: &StorageReadControl, ) -> StorageBackendResult<()>

Recheck the captured native definitions and stage committed requirements on one publication command’s raw record reader/batch. This does not publish a generation or complete the caller’s transaction.

Source

pub fn origin( &self, document: DocId, control: &StorageReadControl, ) -> StorageBackendResult<Option<DiskANNVectorVersion>>

Return an origin only after verifying its complete contiguous native canonical ordinal set. An origin with zero ordinals denotes an explicit empty replacement.

Source

pub fn visit_document( &self, document: DocId, control: &StorageReadControl, visit: &mut DiskANNCanonicalVectorVisitor<'_>, ) -> StorageBackendResult<Option<DiskANNVectorVersion>>

Stream all visible ordinals with their original coordinate bits, independently of navigation, scoring or document candidate selection.

Trait Implementations§

Source§

impl DiskANNCanonicalRead for RetainedSQLiteDiskANNCanonical

Source§

fn population_counts( &self, generation: DiskANNGeneration, control: &StorageReadControl, ) -> StorageBackendResult<Option<DiskANNCanonicalCounts>>

Exact owner-maintained counts for this canonical view and the requested build coverage. Unsupported associations return None; this operation must not enumerate documents, journals or origin pages to reconstruct counts.
Source§

fn corpus_fingerprint( &self, control: &StorageReadControl, ) -> StorageBackendResult<Option<[u8; 32]>>

Identity of the complete selected canonical field, independent of graph generations. Unsupported sources cannot authorize fixed-model reuse.
Source§

fn read_vector( &self, document: DocId, ordinal: u32, control: &StorageReadControl, ) -> StorageBackendResult<Option<BudgetedVec<f32>>>

Own one canonical ordinal so consumers can compare independent fixed sources without nested provider callbacks. Physical owners override this default with bounded point reads.
Source§

fn check_control( &self, control: &StorageReadControl, ) -> StorageBackendResult<()>

Check the retained source’s original controls and the invoking control, including queries that need no provider reads.
Source§

fn dimensions(&self) -> u32

The canonical width, shared by every ordinal on this source.
Source§

fn next_document_after( &self, after: Option<DocId>, control: &StorageReadControl, ) -> StorageBackendResult<Option<DocId>>

Return the least live document strictly after after from the union of canonical keys and origin keys. Include empty replacements and unstamped canonical values; read key metadata only, with bounded workspace.
Source§

fn origin( &self, document: DocId, control: &StorageReadControl, ) -> StorageBackendResult<Option<DiskANNVectorVersion>>

Validate the complete ordinal set before returning its origin. Absence and an explicit empty replacement remain distinct.
Source§

fn visit_document( &self, document: DocId, control: &StorageReadControl, visit: &mut DiskANNCanonicalVectorVisitor<'_>, ) -> StorageBackendResult<Option<DiskANNVectorVersion>>

Stream every visible ordinal, preserving coordinate bits and checking the complete tensor’s origin and shape. Use bounded point reads and a reusable charged vector buffer.
Source§

fn visit_all( &self, control: &StorageReadControl, visit: &mut dyn FnMut(u64, u32, DiskANNVectorVersion, &[f32]) -> Result<(), StorageBackendError>, ) -> Result<(), StorageBackendError>

Stream the entire fixed source in document/ordinal order without retaining a corpus directory. Empty replacements are validated but emit no vectors; unstamped values fail instead of disappearing from the corpus.
Source§

impl DiskANNQueryRead for RetainedSQLiteDiskANNCanonical

Source§

fn document_origin( &self, document: DocId, control: &StorageReadControl, ) -> StorageBackendResult<Option<DiskANNCanonicalOrigin>>

Return the selected mutation and complete tensor cardinality after validating its ordinal-key coverage. This metadata probe must not decode coordinate values or inspect graph pages; empty replacements return Some with count zero.
Source§

fn next_change_after( &self, after: Option<DocId>, control: &StorageReadControl, ) -> StorageBackendResult<Option<DiskANNChangeIdentity>>

Return current journaled documents in strictly increasing order, including empty replacements. Validate the immutable change envelope against its current canonical origin; skip obsolete versions without loading their values.
Source§

fn unversioned_vectors(&self) -> Option<&Arc<dyn VectorRead>>

An independently retained complete value view used when an index definition changed. Origins exposed by this source cover only tensors verified equal to its actual versioned source; the remaining tensors join the ordinary uncovered-candidate stream without fabricated mutation versions.
Source§

fn vector_count( &self, control: &StorageReadControl, ) -> Result<usize, StorageBackendError>

Count visible ordinals from complete origin metadata without decoding coordinates or preparing a graph reader.
Source§

fn contains_vectors( &self, document: u64, control: &StorageReadControl, ) -> Result<bool, StorageBackendError>

Test nonempty membership using complete canonical metadata on this exact view.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.