Skip to main content

uqa_execution/operator_tree/query/
functions.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Registry dispatch, retrieval execution and final ranked row limits.
8
9use super::RetrievalQueryContext;
10use crate::operator_tree::runtime::{execute_tree, expect_posting_output};
11use crate::query::graph_lifecycle::{run_graph_create, run_graph_drop};
12use uqa_core::ScoredEntry;
13use uqa_sql::{
14    registry::{lookup, FunctionKind},
15    SQLError, SQLParam, ScalarExpr,
16};
17
18impl RetrievalQueryContext<'_> {
19    pub fn function(
20        &self,
21        table: &str,
22        signal_table: &str,
23        name: &str,
24        args: &[ScalarExpr],
25        params: &[SQLParam],
26        top_k: Option<usize>,
27    ) -> Result<Vec<ScoredEntry>, SQLError> {
28        let kind = lookup(name).ok_or_else(|| SQLError::UnknownFunction(name.to_string()))?;
29        match kind {
30            FunctionKind::GraphCreate => {
31                run_graph_create(self.graphs, args, params, self.binding.hook)
32            }
33            FunctionKind::GraphDrop => run_graph_drop(self.graphs, args, params, self.binding.hook),
34            FunctionKind::GraphExists
35            | FunctionKind::GraphLabelCreate
36            | FunctionKind::GraphLabelDrop
37            | FunctionKind::GraphAlter
38            | FunctionKind::UQAHighlight
39            | FunctionKind::UQAFacets
40            | FunctionKind::ScoreBM25
41            | FunctionKind::ScoreBayesianBM25
42            | FunctionKind::DeepLearn
43            | FunctionKind::Convolve
44            | FunctionKind::Pool
45            | FunctionKind::Flatten
46            | FunctionKind::Dense
47            | FunctionKind::Softmax
48            | FunctionKind::Layer
49            | FunctionKind::Model => Err(SQLError::Unsupported(format!(
50                "row-emitting dispatch for `{name}` is handled elsewhere"
51            ))),
52            FunctionKind::TextMatch
53            | FunctionKind::BayesianMatch
54            | FunctionKind::FTSMatch
55            | FunctionKind::BayesianMatchWithPrior
56            | FunctionKind::SparseThreshold
57            | FunctionKind::KNNMatch
58            | FunctionKind::CalibratedVectorMatch
59            | FunctionKind::FuseLogOdds
60            | FunctionKind::PositiveEvidencePool
61            | FunctionKind::BayesianEvidenceFusion
62            | FunctionKind::GraphPagerank
63            | FunctionKind::GraphHits
64            | FunctionKind::GraphBetweenness
65            | FunctionKind::GraphTraverse
66            | FunctionKind::GraphNeighbors
67            | FunctionKind::MultiFieldMatch
68            | FunctionKind::StagedRetrieval
69            | FunctionKind::DeepPredict
70            | FunctionKind::TraverseMatch
71            | FunctionKind::TemporalTraverse
72            | FunctionKind::RPQ
73            | FunctionKind::GraphEdges
74            | FunctionKind::AttentionFusion
75            | FunctionKind::LearnedFusion => {
76                let tree = self.binding.lower_function(name, args, params)?;
77                let tree = match top_k {
78                    Some(k) => self.planner.text_top_k(table, tree, k)?,
79                    None => tree,
80                };
81                let posting = expect_posting_output(
82                    execute_tree(&self.trees, table, signal_table, params, &tree)?,
83                    name,
84                )?;
85                let posting = match top_k {
86                    Some(k) => posting.ranked().select_top_k(k),
87                    None => posting,
88                };
89                Ok(posting
90                    .entries()
91                    .iter()
92                    .map(|entry| ScoredEntry {
93                        doc_id: entry.doc_id,
94                        score: entry.payload.score,
95                    })
96                    .collect())
97            }
98        }
99    }
100}