Skip to main content

uqa_execution/query/subqueries/
context.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Borrow query contexts only when an uncached subquery needs execution.
8
9use crate::catalog::services::{CatalogSession, CatalogSnapshotSource};
10use crate::query::{
11    runtime::QueryMemorySettings, sources::SourceContext, statement::context::QueryContext,
12    CteScope,
13};
14use crate::scalar::plan::PhysicalSubqueryRunner;
15use uqa_sql::{expr::EngineHook, semantics::volatility::VolatilityCatalog, SQLError};
16
17/// Bind native query services at the execution boundary, after cache and correlation checks.
18pub trait SubqueryQueryContexts<S: Clone + 'static> {
19    fn query_context(&self) -> QueryContext<'_, S>;
20    fn source_context(&self) -> SourceContext<'_, S>;
21}
22
23pub type SubqueryProbe<'a> =
24    &'a mut dyn FnMut(&dyn EngineHook, &dyn PhysicalSubqueryRunner) -> Result<bool, SQLError>;
25
26/// Lend scoped callbacks to a physical predicate without allocating a callback object per row.
27pub trait ScopedSubqueryHooks<S: Clone>: Sync {
28    fn with_hooks(&self, scope: &CteScope<S>, probe: SubqueryProbe<'_>) -> Result<bool, SQLError>;
29}
30
31#[derive(Clone)]
32pub struct SubqueryServices<'a, S: Clone + 'static> {
33    pub routines: &'a dyn uqa_sql::routines::RoutineResolution,
34    pub catalog: &'a dyn CatalogSnapshotSource,
35    pub session: &'a dyn CatalogSession,
36    pub volatility: &'a dyn VolatilityCatalog,
37    pub queries: &'a dyn SubqueryQueryContexts<S>,
38    pub hooks: &'a dyn ScopedSubqueryHooks<S>,
39}
40
41impl<S: Clone + 'static> Copy for SubqueryServices<'_, S> {}
42
43impl<S: Clone + 'static> SubqueryServices<'_, S> {
44    pub(super) fn production_resources(
45        &self,
46    ) -> Result<uqa_core::memory::OwnedProductionControl, SQLError> {
47        self.queries.source_context().ctes.production_resources()
48    }
49}
50
51pub struct SubqueryContext<'a, S: Clone + 'static> {
52    pub services: SubqueryServices<'a, S>,
53    pub memory: &'a dyn QueryMemorySettings,
54    pub ctes: &'a CteScope<S>,
55    pub function_hook: &'a dyn EngineHook,
56    pub subquery_runner: &'a dyn PhysicalSubqueryRunner,
57}