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>) -> Self

Start one dynamic read for an accepted entity name.

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

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

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

Append one deterministic ordering term.

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

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) -> Self

Limit the number of returned rows.

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

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

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

Append one grouped aggregate in declaration order.

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

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>) -> Self

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

Trait Implementations

impl Clone for DynamicQuery

fn clone(&self) -> Self

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

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.