Skip to main content

uqa_sql/assignment/
mod.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! SQL assignment conversion and catalog-defined domain constraints.
8
9use crate::expr::EngineHook;
10use crate::{ast::Expr, catalog::domain::DomainCatalog, RowSchema, SQLError};
11use uqa_core::Value;
12
13/// Domain metadata and bound check evaluation required by assignment conversion.
14pub trait AssignmentContext: EngineHook + DomainCatalog {
15    fn evaluate_domain_check(
16        &self,
17        expression: &Expr,
18        row: &dyn crate::expr::RowLookup,
19        schema: &RowSchema,
20    ) -> Result<Value, SQLError>;
21
22    /// External adapters return the selected output spelling. Native catalogs admit visibility and name construction before producing it.
23    fn domain_display_name_with_control(
24        &self,
25        oid: u32,
26        control: &uqa_core::memory::ProductionControl<'_>,
27    ) -> Result<uqa_core::memory::Produced<String>, SQLError> {
28        control.check()?;
29        let name = self
30            .resolve_regtype_output(&crate::ColumnType::Regtype, i64::from(oid))
31            .map_err(SQLError::Internal)?
32            .ok_or_else(|| SQLError::Internal("domain type has no catalog display name".into()))?;
33        let (value, memory) = control
34            .retain_external_value(Value::Str(name))?
35            .into_parts();
36        let Value::Str(name) = value else {
37            unreachable!("domain output name")
38        };
39        Ok(control.finish(name, memory)?)
40    }
41
42    /// Native evaluation keeps lowering, binding and execution under this control; external callbacks own their construction and return an admitted result.
43    fn evaluate_domain_check_with_control(
44        &self,
45        expression: &Expr,
46        row: &dyn crate::expr::RowLookup,
47        schema: &RowSchema,
48        control: &uqa_core::memory::ProductionControl<'_>,
49    ) -> Result<uqa_core::memory::Produced<Value>, SQLError> {
50        control.check()?;
51        Ok(control.retain_external_value(self.evaluate_domain_check(expression, row, schema)?)?)
52    }
53}
54
55pub mod conversion;
56pub mod domain;
57pub mod vectors;
58
59#[cfg(test)]
60mod tests;
61
62pub mod routines;
63
64pub mod columns;
65pub mod containers;
66pub mod path;
67pub mod targets;