Struct Query 

pub struct Query {
    pub space: SpaceId,
    pub snapshot: SnapshotId,
    pub range: Option<SpatialRange>,
    pub key_range: Option<(u128, u128)>,
    pub as_of: Option<RevisionId>,
    pub include_tombstones: bool,
}

A read query against a snapshot. Queries are pure descriptors — the storage layer executes them.

Fields

space: SpaceId

snapshot: SnapshotId

range: Option<SpatialRange>

Spatial bounds to filter records by. None = all records in the space.

key_range: Option<(u128, u128)>

Precomputed Hilbert key interval [min, max] for block pruning. Takes precedence over range when set; None falls back to range.

as_of: Option<RevisionId>

Only return records at or before this revision. Defaults to the snapshot’s own revision when None.

include_tombstones: bool

Include tombstoned (deleted) records in results.

Implementations

impl Query

pub fn new(space: SpaceId, snapshot: SnapshotId) -> Self

Build a query pinned to a specific space and snapshot.

pub fn with_range(self, range: SpatialRange) -> Self

Add a spatial range filter.

pub fn with_key_range(self, lo: u128, hi: u128) -> Self

Set a precomputed Hilbert key interval, taking precedence over range.

pub fn as_of(self, revision: RevisionId) -> Self

Restrict results to records at or before revision.

pub fn include_tombstones(self) -> Self

Include tombstoned records in query results.

pub fn with_bounds(self, min: Vec<u32>, max: Vec<u32>) -> Self

Convenience helper to set range bounds from raw coordinate vectors.

Trait Implementations

impl Clone for Query

fn clone(&self) -> Query

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Query

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Query

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Query

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.