linkrs-query 0.1.0

Query engine, parser, and executor for Linkrs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! Runtime statistics feedback module
//!
//! Provide a lightweight mechanism for collecting execution feedback, which can be used to dynamically adjust selective estimation models.
//! Uses an exponentially weighted moving average (EWMA) algorithm to correct selectivity estimates.
//!
//! ## Module Structure
//!
//! “Fingerprint” – Refers to the process of generating and normalizing fingerprints (digital representations of unique patterns).
//! “Collector” – The component responsible for executing the feedback collection process.
//! “Trigger” – A mechanism for automatically triggering feedback.
//! “Selectivity” refers to the process of carefully selecting and applying appropriate corrections or measures in a targeted manner. In other words, it involves managing various factors or elements in a way that is tailored to achieve specific goals or outcomes.
//! `query` – The structure that contains feedback regarding the execution of the query.
//! “History” – Querying the feedback history management system.

pub mod cardinality;
pub mod collector;
pub mod decision;
pub mod factor;
pub mod fingerprint;
pub mod history;
pub mod query;
pub mod selectivity;
pub mod trigger;

// Re-export the main types.
pub use cardinality::CardinalityFeedbackManager;
pub use decision::{DecisionFeedbackStore, DecorrelationAdvice};
pub use factor::FeedbackDrivenFactor;
pub use fingerprint::{generate_query_fingerprint, normalize_query};
pub use history::QueryFeedbackHistory;
pub use query::{OperatorFeedback, QueryExecutionFeedback};
pub use selectivity::{FeedbackDrivenSelectivity, SelectivityFeedbackManager};
pub use trigger::{AutoFeedbackConfig, AutoFeedbackTrigger};

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_module_integration() {
        let mut selectivity = FeedbackDrivenSelectivity::new(0.1);
        selectivity.update_with_feedback(0.15);

        let query_feedback = QueryExecutionFeedback::new("fp_123".to_string());

        let history = QueryFeedbackHistory::new(10);
        // Add feedback to verify that the “history” functionality is working properly.
        history.add_feedback(query_feedback.clone());

        let config = AutoFeedbackConfig::new();

        assert!(selectivity.corrected_selectivity() > 0.0);
        assert_eq!(query_feedback.query_fingerprint, "fp_123");
        assert_eq!(history.total_feedback_count(), 1);
        assert!(config.enabled);
    }
}