Skip to main content

uqa_execution/mutation/rows/
context.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Row metadata and scoped expressions used to construct mutation row images.
8
9use crate::{
10    catalog::context::CatalogContext, query::relational::QueryExpressionFactory,
11    FunctionTypeResolver,
12};
13use uqa_core::DocId;
14use uqa_sql::SQLError;
15use uqa_storage::DocumentMetadata;
16
17pub use uqa_sql::semantics::mutation_rows::MutationRowCatalog;
18
19/// Tuple provenance from the statement's read generation and write transaction.
20pub trait MutationTupleMetadata: Sync {
21    /// Read the canonically bound storage relation identity without constructing a database-wide catalog for each row image.
22    fn table_relation_oid(&self, table: &str) -> Result<i64, SQLError>;
23    fn document_metadata(
24        &self,
25        table: &str,
26        doc_id: DocId,
27    ) -> Result<Option<DocumentMetadata>, SQLError>;
28    fn tuple_version_xid(&self) -> Result<u32, SQLError>;
29}
30
31#[derive(Clone, Copy)]
32pub struct MutationRowContext<'a> {
33    pub catalog: CatalogContext<'a>,
34    pub relations: &'a dyn MutationRowCatalog,
35    pub tuples: &'a dyn MutationTupleMetadata,
36}
37
38#[derive(Clone)]
39pub struct MutationExpressionContext<'a, S: Clone + 'static> {
40    pub types: &'a dyn FunctionTypeResolver,
41    pub expressions: &'a dyn QueryExpressionFactory<S>,
42}
43impl<S: Clone + 'static> Copy for MutationExpressionContext<'_, S> {}