Struct SessionDeleteQuery 

pub struct SessionDeleteQuery<'a, C: CanisterKind, E: EntityKind<Canister = C>> { /* private fields */ }

SessionDeleteQuery

Fluent, session-bound delete query wrapper that keeps query intent pure while routing execution through the DbSession boundary.

Implementations

impl<'a, C: CanisterKind, E: EntityKind<Canister = C>> SessionDeleteQuery<'a, C, E>

pub const fn query(&self) -> &Query<E>

pub fn key(self, key: impl Into<Key>) -> Self

Delete by primary key.

pub fn many<I>(self, keys: I) -> Self

where I: IntoIterator<Item = E::PrimaryKey>,

Delete multiple entities by primary key.

Semantics:

• Equivalent to WHERE pk IN (…)
• Uses key-based access (ByKey / ByKeys)
• Missing keys are ignored in MissingOk mode
• Strict mode treats missing rows as corruption

pub fn filter(self, predicate: Predicate) -> Self

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

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

Apply a dynamic filter expression.

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

Apply a dynamic sort expression.

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

Append an ascending sort key.

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

Append a descending sort key.

pub fn limit(self, limit: u32) -> Self

Apply a delete limit to bound mutation size.

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

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

pub fn execute(&self) -> Result<Response<E>, QueryError>

pub fn delete_rows(&self) -> Result<Response<E>, QueryError>

Execute a delete query and return the deleted rows.

impl<C: CanisterKind, E: EntityKind<Canister = C, PrimaryKey = ()>> SessionDeleteQuery<'_, C, E>

pub fn only(self) -> Self

Delete the singleton entity identified by the unit primary key ().

Semantics:

• Equivalent to DELETE … WHERE pk = ()
• Uses key-based access (ByKey)
• MissingOk mode is idempotent
• Strict mode treats missing row as corruption