Skip to main content

selector_anchor_ms

Function selector_anchor_ms 

Source
fn selector_anchor_ms(
    at: &Option<AtModifier>,
    stmt: &EvalStmt,
) -> Result<Option<i64>>
Expand description

The selector’s @ anchor in milliseconds since the Unix epoch, or None when it has none.

start() and end() stay symbolic in the AST, because only the statement knows which evaluation range they name, so they are resolved against stmt.start and stmt.end here. The offset is not folded in: [RangeWindow] keeps anchor and offset apart and ends the window at anchor_ms - offset_ms at run time.

An anchor decouples the window’s read range from the statement’s: it reads (anchor_ms - offset_ms - range_ms, anchor_ms - offset_ms], which for an anchor like @ 1234 can lie entirely outside [stmt.start - range_ms, stmt.end]. Whoever binds the scan therefore has to derive its range from the window’s anchor, offset and range rather than from stmt.start and stmt.end; a scan bound to the statement alone leaves such a window with no samples, and the query silently returns empty instead of failing.