Struct FindManyOperation 

pub struct FindManyOperation<E: QueryEngine, M: Model> { /* 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?;

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 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.