Skip to main content

uqa_storage_sqlite/vector_index/diskann/live/
runtime.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7use super::{
8    invalid, DiskANNIndexParams, DiskANNReadLimits, DocId, RetainedDiskANNIndex,
9    RetainedSQLiteDiskANNCanonical, SQLiteDiskANNHandle, StorageBackendResult, StorageReadControl,
10};
11use uqa_storage::diskann_index::{
12    build::DiskANNTemporaryBudget, DiskANNIndexOptions, DiskANNPersistentOwner, DiskANNQueryRead,
13};
14
15impl DiskANNPersistentOwner for SQLiteDiskANNHandle {
16    type Snapshot = RetainedDiskANNIndex<RetainedSQLiteDiskANNCanonical>;
17    fn dimensions(&self) -> u32 {
18        self.canonical.index.dimensions
19    }
20    fn parameters(&self) -> DiskANNIndexParams {
21        self.parameters
22    }
23    fn read_limits(&self) -> DiskANNReadLimits {
24        self.limits
25    }
26    fn control(&self) -> &StorageReadControl {
27        &self.control
28    }
29    fn query_metadata(
30        &self,
31    ) -> StorageBackendResult<uqa_storage::diskann_index::DiskANNQueryMetadata> {
32        let canonical = self.retain_current()?;
33        let source = canonical
34            .selected_source(&*self.resolver, &self.control)?
35            .ok_or_else(|| invalid("live native index has no published generation"))?;
36        uqa_storage::diskann_index::DiskANNQueryMetadata::capture(
37            &canonical,
38            &*source,
39            self.parameters,
40            self.limits,
41            &self.control,
42        )
43    }
44    fn snapshot(&self) -> StorageBackendResult<Self::Snapshot> {
45        Self::snapshot(self)
46    }
47    fn count(&self) -> StorageBackendResult<usize> {
48        self.metadata()?.vector_count(&self.control)
49    }
50    fn contains_document(&self, document: DocId) -> StorageBackendResult<bool> {
51        self.metadata()?.contains_vectors(document, &self.control)
52    }
53    fn replace(&self, document: DocId, vectors: &[Vec<f32>]) -> StorageBackendResult<()> {
54        Self::replace(self, document, vectors).map(|_| ())
55    }
56    fn rebuild(
57        &self,
58        options: DiskANNIndexOptions,
59        temporary: &DiskANNTemporaryBudget,
60        clear: bool,
61    ) -> StorageBackendResult<()> {
62        let source = self
63            .canonical
64            .retain_for_index(&self.index, &self.control)?;
65        self.validate(
66            &source.index_scope(&*self.resolver, &self.control)?,
67            options.parameters,
68        )?;
69        if clear {
70            self.canonical.clear_index(
71                &source,
72                &self.index,
73                &*self.resolver,
74                options,
75                temporary,
76                &self.control,
77            )
78        } else {
79            self.canonical.rebuild_source(
80                source,
81                &*self.resolver,
82                options,
83                temporary,
84                &self.control,
85            )
86        }
87    }
88}
89
90impl SQLiteDiskANNHandle {
91    fn metadata(&self) -> StorageBackendResult<RetainedSQLiteDiskANNCanonical> {
92        let source = self.retain_current()?;
93        source
94            .selected_source(&*self.resolver, &self.control)?
95            .ok_or_else(|| invalid("live native index has no published generation"))?;
96        Ok(source)
97    }
98}