Skip to main content

uqa_engine/capabilities/
relation_alteration.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Bind relation metadata, rename dependencies and role-transfer catalogs to their current owners.
8use crate::Engine;
9use std::collections::BTreeMap;
10use uqa_core::RelationIdentity;
11use uqa_execution::schema::{
12    relation_alteration::{
13        RelationRenameDependencies, RoleTargetSchemaAccess, RoleTransferContext,
14    },
15    sequences::role_ownership::{OwnedSequenceSecurityCatalog, OwnedSequenceSecurityRead},
16};
17use uqa_sql::catalog::roles::RoleReference;
18use uqa_sql::{
19    catalog::resolution::RelationResolution, schema::relation_alteration::RelationAlterNames,
20    SQLError,
21};
22use uqa_storage::StorageBackendResult;
23
24impl Engine {
25    pub(crate) fn role_transfer_context(&self) -> RoleTransferContext<'_> {
26        RoleTransferContext {
27            roles: self,
28            session: self,
29            schemas: self,
30            locks: self,
31        }
32    }
33}
34impl RelationAlterNames for Engine {
35    fn resolve_relation_kind(&self, name: &str) -> Result<RelationResolution, SQLError> {
36        self.resolve_visible_relation_kind(name)
37    }
38    fn relation_kind_at(&self, name: &str) -> Result<Option<&'static str>, String> {
39        Engine::relation_kind_at(self, name).map_err(|error| error.to_string())
40    }
41}
42impl RelationRenameDependencies for Engine {
43    fn rewrite_views(
44        &self,
45        renames: &BTreeMap<RelationIdentity, RelationIdentity>,
46    ) -> StorageBackendResult<()> {
47        self.rewrite_view_relation_references(renames)
48    }
49    fn rewrite_routines(
50        &self,
51        from: &RelationIdentity,
52        to: &RelationIdentity,
53    ) -> Result<(), String> {
54        self.rewrite_routine_relation_references(from, to)
55            .map_err(|error| error.to_string())
56    }
57    fn rename_events(
58        &self,
59        from: &RelationIdentity,
60        to: &RelationIdentity,
61    ) -> StorageBackendResult<()> {
62        uqa_execution::schema::events::rename_relation_events(
63            &self.event_catalog_context(),
64            from,
65            to,
66        )
67    }
68}
69impl RoleTargetSchemaAccess for Engine {
70    fn require_schema_create(&self, schema: &str, role: &RoleReference) -> Result<(), SQLError> {
71        self.require_schema_privilege(
72            schema,
73            role,
74            crate::schema_security::SchemaAclPrivilege::Create,
75        )
76    }
77}
78impl OwnedSequenceSecurityCatalog for Engine {
79    fn owned_sequences(&self, table_object_id: [u8; 16]) -> Vec<RelationIdentity> {
80        self.durable
81            .sequences
82            .read()
83            .iter()
84            .filter_map(|(relation, state)| {
85                state
86                    .owner
87                    .is_some_and(|owner| owner.table_object_id == table_object_id)
88                    .then_some(relation.clone())
89            })
90            .collect()
91    }
92    fn security_registry(&self) -> OwnedSequenceSecurityRead<'_> {
93        Box::new(self.durable.sequence_security.read())
94    }
95}