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_volatilities(
22        &self,
23        name: &str,
24        binding: Option<&FunctionBinding>,
25    ) -> Option<Vec<FunctionVolatility>> {
26        let overloads = match binding {
27            Some(binding) if binding.builtin => None,
28            Some(binding) => self.lookup_bound_sql_functions_by_binding(binding),
29            None => self
30                .lookup_visible_sql_functions_for_analysis(name)
31                .ok()
32                .flatten(),
33        }?;
34        Some(
35            overloads
36                .iter()
37                .map(|function| function.def.volatility)
38                .collect(),
39        )
40    }
41
42    fn view_query(&self, name: &str) -> Result<Option<QueryPlan>, SQLError> {
43        self.view_plan(name)
44    }
45
46    fn with_view_query(
47        &self,
48        name: &str,
49        read: &mut dyn FnMut(&QueryPlan) -> Result<bool, SQLError>,
50    ) -> Result<Option<bool>, SQLError> {
51        self.with_view_definition(name, |view| {
52            (view.kind == crate::StoredViewKind::View).then(|| read(&view.definition.query))
53        })?
54        .flatten()
55        .transpose()
56    }
57}