Docs Menu

$out

On this page

  • Permissions Required
  • Syntax
  • Fields
  • Options
  • Examples

$out takes documents returned by the aggregation pipeline and writes them to a specified collection. The $out operator must be the last stage in the aggregation pipeline. In Atlas Data Lake, you can use $out to write data from any one of the supported data stores or multiple supported data stores when using federated queries to any one of the following:

  • S3 buckets with read and write permissions
  • Atlas cluster namespace

You must connect to your Data Lake to use $out.

Option
Type
Description
Necessity
background
boolean

Flag to run aggregation operations in the background. If omitted, defaults to false. When set to true, Atlas Data Lake runs the queries in the background.

{ "background" : true }

Use this option if you want to submit other new queries without waiting for currently running queries to complete or disconnect your Data Lake connection while the queries continue to run in the background.

Optional

Run Query in the background

The following example shows $out syntax for running an aggregation pipeline that ends with the $out stage in the background.

Tip
See also:
Give Feedback
© 2021 MongoDB, Inc.

About

  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.