Skip to main content

uqa_engine/capabilities/
query_semantics.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Supply read-only function and view metadata to SQL semantic analysis.
8
9use crate::Engine;
10use uqa_sql::{
11    ast::{FunctionBinding, FunctionVolatility},
12    plan::QueryPlan,
13    SQLError,
14};
15
16impl uqa_sql::semantics::volatility::VolatilityCatalog for Engine {
17    fn host_function_volatility(&self, name: &str) -> Option<FunctionVolatility> {
18        self.registered_runtime_function_volatility(name)
19    }
20
21    fn routine_volatility_with_control(
22        &self,
23        name: &str,
24        binding: Option<&FunctionBinding>,
25        control: &uqa_core::memory::ProductionControl<'_>,
26    ) -> Result<Option<FunctionVolatility>, SQLError> {
27        self.sql_routine_volatility_with_control(name, binding, control)
28    }
29
30    fn routine_volatilities(
31        &self,
32        name: &str,
33        binding: Option<&FunctionBinding>,
34    ) -> Option<Vec<FunctionVolatility>> {
35        let overloads = match binding {
36            Some(binding) if binding.builtin => None,
37            Some(binding) => self.lookup_bound_sql_functions_by_binding(binding),
38            None => self
39                .lookup_visible_sql_functions_for_analysis(name)
40                .ok()
41                .flatten(),
42        }?;
43        Some(
44            overloads
45                .iter()
46                .map(|function| function.def.volatility)
47                .collect(),
48        )
49    }
50
51    fn view_query(&self, name: &str) -> Result<Option<QueryPlan>, SQLError> {
52        self.view_plan(name)
53    }
54
55    fn with_view_query(
56        &self,
57        name: &str,
58        read: &mut dyn FnMut(&QueryPlan) -> Result<bool, SQLError>,
59    ) -> Result<Option<bool>, SQLError> {
60        self.with_view_definition(name, |view| {
61            (view.kind == crate::StoredViewKind::View).then(|| read(&view.definition.query))
62        })?
63        .flatten()
64        .transpose()
65    }
66}