Skip to main content

uqa_engine/capabilities/
view_creation.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Bind view lifecycle operations to actual transaction, registry, and role state.
8use crate::Engine;
9use uqa_execution::schema::view_creation::{
10    self,
11    context::{
12        MaterializedViewAccess, MaterializedViewWrite, ViewCreationCatalog, ViewCreationContext,
13        ViewCreationTransactions, ViewCreationWrite, ViewOwnerQuery, ViewPlanBinding,
14        ViewQueryOwners,
15    },
16};
17use uqa_sql::{
18    catalog::stored_view::StoredView, plan::QueryPlan, RowSchema, SQLError, SQLParam, SQLResult,
19};
20use uqa_storage::StorageBackendResult;
21
22impl Engine {
23    pub fn register_view(
24        &self,
25        name: &str,
26        body: uqa_sql::ast::SelectStmt,
27    ) -> Result<(), SQLError> {
28        view_creation::register_view(self, name, body)
29    }
30    fn view_creation_context(&self) -> ViewCreationContext<'_> {
31        ViewCreationContext {
32            catalog: self,
33            identities: self.catalog_identity_reservation_context(),
34            views: self,
35            locks: self,
36            namespace: self.relation_creation_context(),
37            names: self,
38            owners: self,
39            access: self,
40            bindings: self,
41            routines: self,
42            regroles: self,
43            aliases: self,
44            rewrite: self.view_rewrite_context(),
45            queries: self,
46            query_owners: self,
47            publication: self,
48            changes: self,
49            notices: &self.runtime.notices,
50        }
51    }
52}
53impl ViewCreationTransactions for Engine {
54    fn with_view_creation(&self, write: ViewCreationWrite<'_>) -> Result<(), SQLError> {
55        self.with_implicit_definition_transaction(|engine| write(&engine.view_creation_context()))
56    }
57    fn with_materialized_view_creation(
58        &self,
59        write: MaterializedViewWrite<'_>,
60    ) -> Result<Option<u64>, SQLError> {
61        self.with_implicit_definition_transaction(|engine| write(&engine.view_creation_context()))
62    }
63}
64impl ViewCreationCatalog for Engine {
65    fn synchronize(&self) -> StorageBackendResult<()> {
66        self.synchronize_catalog_registries()
67    }
68}
69impl ViewPlanBinding for Engine {
70    fn lock_relations(&self, plan: &QueryPlan) -> Result<(), SQLError> {
71        uqa_execution::query::locking::lock_query_relations(self.row_lock_context(), plan)
72    }
73    fn bind_relations(&self, plan: &mut QueryPlan) -> Result<bool, SQLError> {
74        self.bind_stored_query_relations(plan, "CREATE VIEW", true)
75    }
76    fn bind_routines(
77        &self,
78        plan: &mut QueryPlan,
79        params: &[SQLParam],
80    ) -> Result<RowSchema, SQLError> {
81        let scope = super::query_scope::new_for_catalog_binding(self);
82        uqa_execution::query::binding::bind_query_plan_routines_for_storage(
83            self, plan, params, &scope, None,
84        )
85    }
86    fn bind_type_identities(&self, plan: &mut QueryPlan) -> Result<(), SQLError> {
87        uqa_sql::binding::stored_types::bind_query_plan_type_identities(plan, &mut |name| {
88            uqa_sql::FunctionTypeResolver::resolve_type_name(self, name)
89        })
90    }
91}
92
93impl MaterializedViewAccess for Engine {
94    fn ensure_maintenance(&self, name: &str, view: &StoredView) -> Result<(), SQLError> {
95        uqa_sql::catalog::security::view_ownership::ensure_materialized_view_maintenance(
96            self.view_ownership_context(),
97            name,
98            view,
99        )
100    }
101}
102impl ViewQueryOwners for Engine {
103    fn with_owner(
104        &self,
105        owner: &uqa_sql::catalog::roles::RoleReference,
106        operation: ViewOwnerQuery<'_>,
107    ) -> Result<SQLResult, SQLError> {
108        self.with_current_user_context(owner, || operation(self))
109    }
110}
111
112impl Engine {
113    pub(crate) fn view_ownership_context(
114        &self,
115    ) -> uqa_sql::catalog::security::view_ownership::ViewOwnershipContext<'_> {
116        uqa_sql::catalog::security::view_ownership::ViewOwnershipContext {
117            session: self,
118            roles: self,
119            schemas: self,
120        }
121    }
122    pub(crate) fn ensure_view_owner(
123        &self,
124        name: &str,
125        view: &StoredView,
126    ) -> Result<String, SQLError> {
127        uqa_sql::catalog::security::view_ownership::ensure_view_owner(
128            self.view_ownership_context(),
129            name,
130            view,
131        )
132    }
133}
134impl uqa_sql::catalog::security::view_ownership::ViewOwnerSchemas for Engine {
135    fn schema_security(
136        &self,
137        schema: &str,
138    ) -> Option<uqa_sql::catalog::security::BoundSchemaSecurity> {
139        self.schema_security_for_privilege(schema)
140    }
141}
142
143impl uqa_execution::catalog::view::ViewIdentityAllocation for Engine {
144    fn allocate_identity(&self) -> StorageBackendResult<[u8; 16]> {
145        crate::new_view_object_id()
146    }
147}