Struct FindManyOperation 

pub struct FindManyOperation<E: QueryEngine, M: Model> {
    pub extra_projections: Vec<ScalarProjection>,
    /* private fields */
}

A query operation that finds multiple records.

Example

let users = client
    .user()
    .find_many()
    .r#where(user::email::contains("@example.com"))
    .order_by(user::created_at::desc())
    .skip(0)
    .take(10)
    .exec()
    .await?;

Fields

extra_projections: Vec<ScalarProjection>

Extra scalar-subquery columns appended to the SELECT clause. Used by relation-aggregate virtual fields (@count, @sum, …).

Implementations

impl<E: QueryEngine, M: Model + FromRow> FindManyOperation<E, M>

pub fn new(engine: E) -> Self

Create a new FindMany operation.

pub fn include(self, spec: IncludeSpec) -> Self

Eager-load a relation alongside the main query.

Each .include() call appends one follow-up SELECT that fetches the target rows for every parent returned by this find. Children get stitched onto the parent slice by the ModelRelationLoader impl emitted by #[derive(Model)].

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

Add a filter condition.

pub fn order_by(self, order: impl Into<OrderBy>) -> Self

Set the order by clause.

pub fn skip(self, n: u64) -> Self

Skip a number of records.

pub fn take(self, n: u64) -> Self

Take a limited number of records.

pub fn select(self, select: impl Into<Select>) -> Self

Select specific fields.

pub fn distinct( self, columns: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Make the query distinct.

pub fn cursor(self, cursor: Cursor) -> Self

Set cursor for cursor-based pagination.

pub fn with_where_input<W: WhereInput<Model = M>>(self, w: W) -> Self

Apply a typed WhereInput. AND-composes with any previously set filter — same semantics as calling .r#where(...) again.

pub fn with_include_input<I: IncludeInput<Model = M>>(self, i: I) -> Self

Apply a typed IncludeInput. Merges into any previously set includes (later wins on conflicting relation names).

pub fn with_select_input<S: SelectInput<Model = M>>(self, s: S) -> Self

Apply a typed SelectInput.

pub fn with_order_by_input<O: OrderByInput<Model = M>>(self, o: O) -> Self

Apply a typed OrderByInput (replaces current).

impl<E, M> FindManyOperation<E, M>

where E: QueryEngine + SupportsScalarSubqueryInSelect, M: Model + FromRow,

pub fn with_scalar_projection(self, proj: ScalarProjection) -> Self

Append a scalar-subquery projection to the SELECT list.

Available only on engines that implement SupportsScalarSubqueryInSelect. SQL backends (Postgres, MySQL, SQLite, MSSQL, DuckDB, SQLx) all satisfy this bound; MongoDB, ScyllaDB, and Cassandra do not — calling this method on those engines is a compile-time error.

impl<E: QueryEngine, M: Model + FromRow> FindManyOperation<E, M>

pub fn build_sql(&self, dialect: &dyn SqlDialect) -> (String, Vec<FilterValue>)

Build the SQL query.

pub async fn exec(self) -> QueryResult<Vec<M>>

where M: Send + 'static + ModelRelationLoader<E>,

Execute the query.

After the main SELECT hydrates the parent rows, any pending .include() specs are dispatched through ModelRelationLoader::load_relation which issues one additional SELECT per relation and stitches the children onto the parent slice.