Skip to main content

uqa_execution/mutation/insert/source/
binding.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Bind INSERT SELECT preparation to the source query's read generation.
8use super::InsertSelectConsumer;
9use crate::query::{consumer::QueryRowConsumer, statement::consumer::QueryConsumerFactory};
10use std::rc::Rc;
11use uqa_sql::SQLError;
12
13/// The session owner retains a live or frozen generation for the lifetime of one bound sink.
14pub trait InsertSelectBinding<S: Clone + 'static> {
15    fn bind<'a>(
16        &'a self,
17        snapshot: Option<&S>,
18        consumer: Rc<InsertSelectConsumer<S>>,
19        destination: Option<crate::mutation::returning::ReturningDestination<'a>>,
20    ) -> Result<Rc<dyn QueryRowConsumer + 'a>, SQLError>;
21}
22pub struct InsertSelectOutput<'a, S: Clone + 'static> {
23    pub binding: &'a dyn InsertSelectBinding<S>,
24    pub destination: Option<crate::mutation::returning::ReturningDestination<'a>>,
25    pub consumer: Rc<InsertSelectConsumer<S>>,
26}
27impl<'consumer, S: Clone + 'static> QueryConsumerFactory<'consumer, S>
28    for InsertSelectOutput<'consumer, S>
29{
30    fn bind(
31        self: Rc<Self>,
32        generation: Option<&S>,
33    ) -> Result<Rc<dyn QueryRowConsumer + 'consumer>, SQLError> {
34        self.binding
35            .bind(generation, Rc::clone(&self.consumer), self.destination)
36    }
37}