Edit

Share via

getMore

APPLIES TO: MongoDB vCore

The getMore command is used to retrieve extra batches of documents from an existing cursor. This command is useful when dealing with large datasets that can't be fetched in a single query due to size limitations. The command allows clients to paginate through the results in manageable chunks with commands that return a cursor. For example, find and aggregate, to return subsequent batches of documents currently pointed to by the cursor.

Syntax

The syntax for the getMore command is as follows:

{
   getMore: <cursor-id>,
   collection: <collection-name>,
   batchSize: <number-of-documents>
}
  • getMore: The unique identifier for the cursor from which to retrieve more documents.
  • collection: The name of the collection associated with the cursor.
  • batchSize: (Optional) The number of documents to return in the batch. If not specified, the server uses the default batch size.

Examples

Example 1: Retrieve more documents from a cursor

Assume you have a cursor with the ID 1234567890 from the stores collection. The following command retrieves the next batch of documents:

{
   getMore: 1234567890,
   collection: "stores",
   batchSize: 5
}

Example 2: Retrieve more documents without specifying batch size

If you don't specify the batchSize, the server uses the default batch size:

{
   getMore: 1234567890,
   collection: "stores"
}

Related content