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 catalog: &'a dyn CatalogSnapshotSource,
34    pub session: &'a dyn CatalogSession,
35    pub volatility: &'a dyn VolatilityCatalog,
36    pub queries: &'a dyn SubqueryQueryContexts<S>,
37    pub hooks: &'a dyn ScopedSubqueryHooks<S>,
38}
39
40impl<S: Clone + 'static> Copy for SubqueryServices<'_, S> {}
41
42pub struct SubqueryContext<'a, S: Clone + 'static> {
43    pub services: SubqueryServices<'a, S>,
44    pub memory: &'a dyn QueryMemorySettings,
45    pub ctes: &'a CteScope<S>,
46    pub function_hook: &'a dyn EngineHook,
47    pub subquery_runner: &'a dyn PhysicalSubqueryRunner,
48}