Struct DynamicQuery 

pub struct DynamicQuery { /* private fields */ }

DynamicQuery

Entity-name-driven structural read request. The session resolves fields, ordering, indexes, and projection against the accepted schema; no generated entity descriptor participates. Preparation admits at most 128 input levels, 4,096 input nodes and 2 MiB of variable payload across the request, before cloning or lowering it. These limits also apply to trusted reads. Construction and explicit cloning of caller-owned input are not admission operations.

Implementations

impl DynamicQuery

pub fn new(entity: impl Into<String>) -> DynamicQuery

Start one dynamic read for an accepted entity name.

pub fn filter(self, filter: impl Into<FilterExpr>) -> DynamicQuery

Add one filter expression, joined with prior filters by AND.

pub fn order_by(self, order: OrderTerm) -> DynamicQuery

Append one deterministic ordering term.

pub fn select<I, S>(self, fields: I) -> DynamicQuery

where I: IntoIterator<Item = S>, S: Into<String>,

Select explicit fields in scalar output order.

Grouped execution rejects an explicit scalar selection because group keys and aggregates define its output contract.

pub const fn limit(self, limit: u32) -> DynamicQuery

Bound scalar traversal totals or the number of groups in one grouped page.

Scalar resumed pages subtract previously emitted rows from this limit; reaching it ends traversal even when more matching rows exist. The public read envelope independently bounds each scalar page. Grouped continuation reapplies this limit on each page, so following its cursor can return more groups in total than the limit.

pub fn group_by(self, field: impl Into<String>) -> DynamicQuery

Append one accepted field to the grouped key in declaration order.

pub fn aggregate(self, aggregate: AggregateExpr) -> DynamicQuery

Append one grouped aggregate in declaration order.

pub const fn grouped_limits( self, max_groups: u32, max_group_bytes: u32, ) -> DynamicQuery

Set explicit hard limits for grouped execution.

Ordinary public reads additionally enforce their built-in admission ceilings. Zero values are rejected before execution.

pub fn cursor(self, cursor: impl Into<String>) -> DynamicQuery

Continue a grouped page from one opaque cursor returned by IcyDB.

Trait Implementations

impl Clone for DynamicQuery

fn clone(&self) -> DynamicQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DynamicQuery

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

Formats the value using the given formatter.

impl Drop for DynamicQuery

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.