pub struct Aggregate<'a, Session = ImplicitSession, T = Document> { /* private fields */ }
Expand description
Run an aggregation operation. Construct with Database::aggregate
or
Collection::aggregate
.
Implementations§
source§impl<'a, Session, T> Aggregate<'a, Session, T>
impl<'a, Session, T> Aggregate<'a, Session, T>
sourcepub fn with_options(self, value: impl Into<Option<AggregateOptions>>) -> Self
pub fn with_options(self, value: impl Into<Option<AggregateOptions>>) -> Self
Set all options. Note that this will replace all previous values set.
sourcepub fn allow_disk_use(self, value: bool) -> Self
pub fn allow_disk_use(self, value: bool) -> Self
Set the AggregateOptions::allow_disk_use
option.
sourcepub fn batch_size(self, value: u32) -> Self
pub fn batch_size(self, value: u32) -> Self
Set the AggregateOptions::batch_size
option.
sourcepub fn bypass_document_validation(self, value: bool) -> Self
pub fn bypass_document_validation(self, value: bool) -> Self
Set the AggregateOptions::bypass_document_validation
option.
sourcepub fn collation(self, value: Collation) -> Self
pub fn collation(self, value: Collation) -> Self
Set the AggregateOptions::collation
option.
sourcepub fn comment(self, value: impl Into<Bson>) -> Self
pub fn comment(self, value: impl Into<Bson>) -> Self
Set the AggregateOptions::comment
option.
sourcepub fn hint(self, value: Hint) -> Self
pub fn hint(self, value: Hint) -> Self
Set the AggregateOptions::hint
option.
sourcepub fn max_await_time(self, value: Duration) -> Self
pub fn max_await_time(self, value: Duration) -> Self
Set the AggregateOptions::max_await_time
option.
sourcepub fn max_time(self, value: Duration) -> Self
pub fn max_time(self, value: Duration) -> Self
Set the AggregateOptions::max_time
option.
sourcepub fn read_concern(self, value: ReadConcern) -> Self
pub fn read_concern(self, value: ReadConcern) -> Self
Set the AggregateOptions::read_concern
option.
sourcepub fn selection_criteria(self, value: SelectionCriteria) -> Self
pub fn selection_criteria(self, value: SelectionCriteria) -> Self
Set the AggregateOptions::selection_criteria
option.
sourcepub fn write_concern(self, value: WriteConcern) -> Self
pub fn write_concern(self, value: WriteConcern) -> Self
Set the AggregateOptions::write_concern
option.
sourcepub fn let_vars(self, value: Document) -> Self
pub fn let_vars(self, value: Document) -> Self
Set the AggregateOptions::let_vars
option.
source§impl<'a, T> Aggregate<'a, ImplicitSession, T>
impl<'a, T> Aggregate<'a, ImplicitSession, T>
sourcepub fn session(
self,
value: impl Into<&'a mut ClientSession>,
) -> Aggregate<'a, ExplicitSession<'a>>
pub fn session( self, value: impl Into<&'a mut ClientSession>, ) -> Aggregate<'a, ExplicitSession<'a>>
Use the provided session when running the operation.
source§impl<'a, Session, T> Aggregate<'a, Session, T>
impl<'a, Session, T> Aggregate<'a, Session, T>
sourcepub fn with_type<U>(self) -> Aggregate<'a, Session, U>
pub fn with_type<U>(self) -> Aggregate<'a, Session, U>
Use the provided type for the returned cursor.
#[derive(Deserialize)]
struct PipelineOutput {
len: usize,
}
let aggregate_cursor = database
.aggregate(pipeline)
.with_type::<PipelineOutput>()
.await?;
let aggregate_results: Vec<PipelineOutput> = aggregate_cursor.try_collect().await?;
source§impl<'a, T> Aggregate<'a, ImplicitSession, T>
impl<'a, T> Aggregate<'a, ImplicitSession, T>
source§impl<'a, T> Aggregate<'a, ExplicitSession<'a>, T>
impl<'a, T> Aggregate<'a, ExplicitSession<'a>, T>
sourcepub fn run(self) -> Result<SessionCursor<T>>
Available on crate feature sync
only.
pub fn run(self) -> Result<SessionCursor<T>>
sync
only.Synchronously execute this action.
Trait Implementations§
source§impl<'a, T> Action for Aggregate<'a, ExplicitSession<'a>, T>
impl<'a, T> Action for Aggregate<'a, ExplicitSession<'a>, T>
source§impl<'a, T> Action for Aggregate<'a, ImplicitSession, T>
impl<'a, T> Action for Aggregate<'a, ImplicitSession, T>
source§impl<'a, T> IntoFuture for Aggregate<'a, ExplicitSession<'a>, T>
impl<'a, T> IntoFuture for Aggregate<'a, ExplicitSession<'a>, T>
source§type Output = Result<SessionCursor<T>, Error>
type Output = Result<SessionCursor<T>, Error>
source§type IntoFuture = AggregateSessionFuture<'a, T>
type IntoFuture = AggregateSessionFuture<'a, T>
source§fn into_future(self) -> Self::IntoFuture
fn into_future(self) -> Self::IntoFuture
source§impl<'a, T> IntoFuture for Aggregate<'a, ImplicitSession, T>
impl<'a, T> IntoFuture for Aggregate<'a, ImplicitSession, T>
source§type IntoFuture = AggregateFuture<'a, T>
type IntoFuture = AggregateFuture<'a, T>
source§fn into_future(self) -> Self::IntoFuture
fn into_future(self) -> Self::IntoFuture
Auto Trait Implementations§
impl<'a, Session, T> Freeze for Aggregate<'a, Session, T>where
Session: Freeze,
impl<'a, Session = ImplicitSession, T = Document> !RefUnwindSafe for Aggregate<'a, Session, T>
impl<'a, Session, T> Send for Aggregate<'a, Session, T>
impl<'a, Session, T> Sync for Aggregate<'a, Session, T>
impl<'a, Session, T> Unpin for Aggregate<'a, Session, T>
impl<'a, Session = ImplicitSession, T = Document> !UnwindSafe for Aggregate<'a, Session, T>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> FmtForward for T
impl<T> FmtForward for T
source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.source§impl<T> Pointable for T
impl<T> Pointable for T
source§impl<T> Tap for T
impl<T> Tap for T
source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read moresource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read moresource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read moresource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read moresource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.