hawdb-sql 0.13.0

An embedded Rust graph database for local data-plane workloads
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

// Copyright 2026 Nowledge
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
pub struct RelationalSqlStageTimings {
    /// Time spent parsing SQL on a template-cache miss. Cache hits report zero.
    pub parse_nanos: u64,
    /// Time spent resolving the bound-neutral template against current schema state.
    pub bind_nanos: u64,
    /// Time spent selecting access paths, enumerating joins, and lowering execution state.
    pub plan_nanos: u64,
    /// Time spent executing the prepared relational operators.
    pub execute_nanos: u64,
}

impl RelationalSqlStageTimings {
    pub const fn total_nanos(self) -> u64 {
        self.parse_nanos
            .saturating_add(self.bind_nanos)
            .saturating_add(self.plan_nanos)
            .saturating_add(self.execute_nanos)
    }
}

#[doc(hidden)]
pub fn elapsed_nanos(started: hawdb_core::time::Instant) -> u64 {
    u64::try_from(started.elapsed().as_nanos()).unwrap_or(u64::MAX)
}

#[doc(hidden)]
pub fn measure_nanos<T>(nanos: &mut u64, operation: impl FnOnce() -> T) -> T {
    let started = hawdb_core::time::Instant::now();
    let output = operation();
    *nanos = nanos.saturating_add(elapsed_nanos(started));
    output
}