Skip to main content

qualia_cli/bench/
sparql_bench.rs

1use qualia_core_db::sparql_library::sparql_executor::QueryExecutor;
2use qualia_core_db::sparql_library::sparql_parser::parse_sparql;
3use qualia_core_db::sparql_library::sparql_planner::QueryPlanner;
4use qualia_core_db::NQuin;
5use std::path::Path;
6use std::time::Instant;
7
8#[derive(Debug)]
9pub enum BenchError {
10    Format(String),
11}
12
13impl std::fmt::Display for BenchError {
14    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
15        match self {
16            BenchError::Format(s) => write!(f, "{}", s),
17        }
18    }
19}
20impl std::error::Error for BenchError {}
21
22/// CLI: .
23pub fn run_sparql_suite(database_volume_path: &Path) -> Result<(), BenchError> {
24    println!(
25        "Initializing Memory-Mapped Volume: {:?}",
26        database_volume_path
27    );
28    let start_init = Instant::now();
29
30    // The resident executor remains a benchmark compatibility path, but it
31    // opens a front-manifested logical root as one graph.
32    let all_quins: Vec<NQuin> = qualia_core_db::q42_reader::read_q42_quins(database_volume_path)
33        .map_err(|e| BenchError::Format(format!("Failed to open Q42 volume: {e}")))?;
34
35    println!(
36        "Volume loaded into memory: {} quins in {} μs",
37        all_quins.len(),
38        start_init.elapsed().as_micros()
39    );
40
41    let query_point_lookup = "
42        PREFIX yago: <http://yago-knowledge.org/resource/>
43        SELECT ?birthPlace ?date
44        WHERE {
45            yago:Albert_Einstein yago:wasBornIn ?birthPlace .
46            <<yago:Albert_Einstein yago:wasBornIn ?birthPlace>> yago:occurredOnDate ?date .
47        }
48    ";
49
50    println!("Running SPARQL-star Point Lookup Benchmark...");
51
52    let parse_timer = Instant::now();
53    let (ast, ctx) = parse_sparql(query_point_lookup).map_err(|e| BenchError::Format(e))?;
54    let plan = QueryPlanner::plan(&ast, &ctx).map_err(|e| BenchError::Format(e))?;
55    println!(
56        "Query compiled in: {} μs",
57        parse_timer.elapsed().as_micros()
58    );
59
60    let query_timer = Instant::now();
61    let executor = QueryExecutor::new(&all_quins);
62    let results = executor
63        .execute(&plan, &ctx)
64        .map_err(|e| BenchError::Format(e))?;
65    let latency = query_timer.elapsed();
66
67    println!(
68        "Query execution completed safely in: {} μs",
69        latency.as_micros()
70    );
71    println!("Found {} results.", results.len());
72    Ok(())
73}