diff --git a/source/fundamentals/crud/read-operations/change-streams.txt b/source/fundamentals/crud/read-operations/change-streams.txt index f346ea26..9fb71085 100644 --- a/source/fundamentals/crud/read-operations/change-streams.txt +++ b/source/fundamentals/crud/read-operations/change-streams.txt @@ -210,9 +210,16 @@ of ``Watch()`` and ``WatchAsync()``: include expanded events in a change stream, create the change stream cursor and set this parameter to ``True``. - * - ``BatchSize`` - - | Specifies the maximum number of change events to return in each batch of the - response from the MongoDB cluster. + * - ``batchSize`` + - | Specifies the maximum number of documents that a change + stream can return in each batch, which applies to ``Watch()`` or + ``WatchAsync()``. If the ``batchSize`` option is not set, watch functions have an + initial batch size of ``101`` documents and a maximum size of 16 mebibytes (MiB) + for each subsequent batch. This option can + enforce a smaller limit than 16 MiB, but not a larger one. If + you set ``batchSize`` to a limit that result in batches + larger than 16 MiB, this option has no effect and ``Watch()`` + or ``WatchAsync()`` uses the default batch size. * - ``Collation`` - | Specifies the collation to use for the change stream cursor. diff --git a/source/fundamentals/crud/read-operations/retrieve.txt b/source/fundamentals/crud/read-operations/retrieve.txt index abd171f6..bce5fa11 100644 --- a/source/fundamentals/crud/read-operations/retrieve.txt +++ b/source/fundamentals/crud/read-operations/retrieve.txt @@ -205,7 +205,13 @@ You can configure the commonly used options with the following methods: - Description * - ``BatchSize`` - - | Gets or sets the number of documents to hold in a cursor at a given time. + - | Gets or sets the maximum number of documents within each + batch returned in a query result. If ``batchSize`` is not set, the ``Find()`` + method has an initial batch size of ``101`` documents and a maximum size of 16 + mebibytes (MiB) for each subsequent batch. This option can enforce a smaller + limit than 16 MiB, but not a larger one. If you set ``batchSize`` to a limit that + results in batches larger than 16 MiB, this option has no effect and the + ``Find()`` method uses the default batch size. * - ``Collation`` - | Sets the collation options.