icydb-core 0.187.3

IcyDB — A schema-first typed query engine and persistence runtime for Internet Computer canisters
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! Module: db::session::query::planning
//! Responsibility: session-owned planned/compiled query adapter surfaces.
//! Does not own: cache internals, executor dispatch, explain rendering, or query intent construction.
//! Boundary: maps cached lower access plans into query-owned plan DTOs.

use crate::{
    db::{
        DbSession, Query, QueryError,
        query::intent::{CompiledQuery, PlannedQuery},
    },
    traits::{CanisterKind, EntityKind},
};

impl<C: CanisterKind> DbSession<C> {
    /// Compile one typed query using only indexes currently visible for the recovered store.
    pub(in crate::db) fn compile_query_with_visible_indexes<E>(
        &self,
        query: &Query<E>,
    ) -> Result<CompiledQuery<E>, QueryError>
    where
        E: EntityKind<Canister = C>,
    {
        let (prepared_plan, _) = self.cached_shared_query_plan_for_entity::<E>(query)?;

        Ok(CompiledQuery::from_plan(
            prepared_plan.logical_plan().clone(),
        ))
    }

    /// Build one logical planned-query shell using only indexes currently visible for the recovered store.
    pub(in crate::db) fn planned_query_with_visible_indexes<E>(
        &self,
        query: &Query<E>,
    ) -> Result<PlannedQuery<E>, QueryError>
    where
        E: EntityKind<Canister = C>,
    {
        let (prepared_plan, _) = self.cached_shared_query_plan_for_entity::<E>(query)?;

        Ok(PlannedQuery::from_plan(
            prepared_plan.logical_plan().clone(),
        ))
    }
}