Struct Query 

pub struct Query<E>
where
    E: EntityKind,
{ /* private fields */ }

Query

Typed, declarative query intent for a specific entity type.

This intent is:

• schema-agnostic at construction
• normalized and validated only during planning
• free of access-path decisions

Implementations

impl<E> Query<E>

where E: EntityKind,

pub const fn new(consistency: ReadConsistency) -> Query<E>

Create a new intent with an explicit missing-row policy. MissingOk favors idempotency and may mask index/data divergence on deletes. Use Strict to surface missing rows during scan/delete execution.

pub const fn mode(&self) -> QueryMode

Return the intent mode (load vs delete).

pub fn filter(self, predicate: Predicate) -> Query<E>

Add a predicate, implicitly AND-ing with any existing predicate.

pub fn filter_expr(self, expr: FilterExpr) -> Result<Query<E>, QueryError>

Apply a dynamic filter expression.

pub fn sort_expr(self, expr: SortExpr) -> Result<Query<E>, QueryError>

Apply a dynamic sort expression.

pub fn order_by(self, field: impl AsRef<str>) -> Query<E>

Append an ascending sort key.

pub fn order_by_desc(self, field: impl AsRef<str>) -> Query<E>

Append a descending sort key.

pub fn delete(self) -> Query<E>

Mark this intent as a delete query.

pub fn limit(self, limit: u32) -> Query<E>

Apply a limit to the current mode.

Load limits bound result size; delete limits bound mutation size. For load queries, any use of limit or offset requires an explicit order_by(...) so pagination is deterministic.

pub fn offset(self, offset: u32) -> Query<E>

Apply an offset to a load intent.

Any use of offset or limit requires an explicit order_by(...).

pub fn explain(&self) -> Result<ExplainPlan, QueryError>

Explain this intent without executing it.

pub fn plan(&self) -> Result<ExecutablePlan<E>, QueryError>

Plan this intent into an executor-ready plan.

Trait Implementations

impl<E> Debug for Query<E>

where E: Debug + EntityKind, <E as EntityKey>::Key: Debug,

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

Formats the value using the given formatter.