Skip to main content

uqa_engine/
prepared.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7use super::Engine;
8
9impl Engine {
10    pub fn register_prepared(
11        &self,
12        name: String,
13        definition: uqa_sql::ast::Statement,
14    ) -> Result<(), uqa_sql::SQLError> {
15        self.with_direct_read_snapshot(|engine| {
16            uqa_execution::statement::prepared::register_statement(
17                &engine.prepared_registration_context(),
18                name,
19                definition,
20            )
21        })
22    }
23
24    pub(crate) fn prepared_parameter_types(
25        &self,
26        name: &str,
27    ) -> Option<Vec<Option<uqa_sql::ast::ColumnType>>> {
28        self.session
29            .prepared
30            .read()
31            .get(name)
32            .map(|entry| entry.parameter_types.clone())
33    }
34
35    pub fn lookup_prepared(&self, name: &str) -> Option<uqa_planner::UnifiedPlan> {
36        self.session
37            .prepared
38            .read()
39            .get(name)
40            .map(|entry| entry.plan.as_ref().unwrap_or(&entry.logical_plan).clone())
41    }
42
43    /// Invalidate executable plans without removing connection-owned definitions.
44    /// Catalog changes are checked when each statement is next executed, so a
45    /// dropped dependency cannot make unrelated commands or rollback fail.
46    pub(crate) fn invalidate_prepared_plans(&self) {
47        uqa_execution::statement::prepared::invalidation::invalidate_execution_plans_with_routines(
48            self.session.prepared.write().values_mut(),
49            &self.session.routine_bodies,
50        );
51    }
52
53    /// Read original input syntax again after a binding dependency changes.
54    pub(crate) fn invalidate_prepared_analysis(&self) {
55        uqa_execution::statement::prepared::invalidation::PreparedCatalogChange::GlobalCatalog
56            .invalidate_with_routines(
57                self.session.prepared.write().values_mut(),
58                &self.session.routine_bodies,
59            );
60    }
61
62    pub fn deallocate_prepared(&self, name: Option<&str>) {
63        match name {
64            Some(name) => {
65                self.session.prepared.write().remove(name);
66            }
67            None => self.session.prepared.write().clear(),
68        }
69    }
70}