uqa-sql 0.5.0

PostgreSQL-compatible SQL compiler built on libpg_query
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

//
// Unified Query Algebra
//
// Copyright (c) 2023-2026 Cognica, Inc.
//

//! Declaration validation and binding for stored schema expressions.

use crate::{
    ast::{ColumnDef, FunctionVolatility},
    SQLError,
};
use crate::{expr::EngineHook, semantics::sets::SetFunctionCatalog};

/// Definition lookup and planner capability for stored schema expressions.
pub trait SchemaExpressionCatalog:
    EngineHook + SetFunctionCatalog + super::dependencies::oid_alias::OidAliasInput
{
    /// Analyze original stored syntax, then plan a copy to classify its remaining functions. The planner owns simplification; the returned catalog expression retains its dependencies.
    fn plan_schema_expression(
        &self,
        expression: &crate::ast::Expr,
        columns: &[ColumnDef],
    ) -> Result<super::expressions::PlannedSchemaExpression, SQLError>;
    fn registered_runtime_function_volatility(&self, name: &str) -> Option<FunctionVolatility>;
    fn schema_expression_columns(&self, table: &str) -> Result<Option<Vec<ColumnDef>>, SQLError>;
}

/// Routine metadata and immutable namespace inputs for schema expression binding.
pub struct SchemaBindingContext<'a, 'q> {
    pub catalog: &'a dyn SchemaExpressionCatalog,
    pub binding: &'a crate::binding::context::BindingContext<'q>,
}