DOCS-11604,DOCS-11425, DOCS-11637: system collection restrictions, getMore restrictions, update txn operations pages (part1)

Author: kay-kim

source/includes/apiargs-dbcommand-aggregate-field.yaml

@@ -25,7 +25,8 @@ arg_name: field
 description: |
   Specifies to return the information on the processing of the pipeline.
 
-  .. versionadded:: 2.6
+  Not available in :doc:`multi-document transactions </core/transactions>`.
+
 interface: dbcommand
 name: explain
 operation: aggregate

source/includes/apiargs-dbcommand-delete-field.yaml

@@ -37,6 +37,9 @@ description: |
   A document expressing the :doc:`write concern </reference/write-concern>`
   of the :dbcommand:`delete` command. Omit to use the default write
   concern.
+
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: dbcommand
 name: writeConcern
 operation: delete

source/includes/apiargs-dbcommand-insert-field.yaml

@@ -36,6 +36,9 @@ description: |
   A document that expresses the :doc:`write concern </reference/write-concern>`
   of the :dbcommand:`insert` command. Omit to use the default write
   concern.
+
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: dbcommand
 name: writeConcern
 operation: insert

source/includes/apiargs-method-db.collection.aggregate-options.yaml

@@ -4,7 +4,7 @@ description: |
   Specifies to return the information on the processing of the pipeline. See
   :ref:`example-aggregate-method-explain-option` for an example.
 
-  .. versionadded:: 2.6
+  Not available in :doc:`multi-document transactions </core/transactions>`.
 optional: true
 type: boolean
 operation: db.collection.aggregate

source/includes/apiargs-method-db.collection.bulkWrite-params.yaml

@@ -32,6 +32,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+   
 interface: method
 name: writeConcern
 operation: db.collection.bulkWrite

source/includes/apiargs-method-db.collection.deleteMany-param.yaml

@@ -17,6 +17,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.deleteMany

source/includes/apiargs-method-db.collection.deleteOne-param.yaml

@@ -18,6 +18,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.deleteOne

source/includes/apiargs-method-db.collection.findAndModify-param.yaml

@@ -99,6 +99,8 @@ description: |
   A document expressing the :doc:`write concern </reference/write-concern>`.
   Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
   .. versionadded:: 3.2
 interface: method
 name: writeConcern

source/includes/apiargs-method-db.collection.insert-param.yaml

@@ -16,7 +16,8 @@ description: |
   </reference/write-concern>`. Omit to use the default write concern.
   See :ref:`insert-wc`.
 
-  .. versionadded:: 2.6
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.insert

source/includes/apiargs-method-db.collection.insertMany-param.yaml

@@ -13,6 +13,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.insertMany

source/includes/apiargs-method-db.collection.insertOne-param.yaml

@@ -13,6 +13,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.insertOne

source/includes/apiargs-method-db.collection.remove-param.yaml

@@ -32,7 +32,8 @@ description: |
   </reference/write-concern>`. Omit to use the default write concern.
   See :ref:`remove-wc`.
 
-  .. versionadded:: 2.6
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.remove

source/includes/apiargs-method-db.collection.replaceOne-param.yaml

@@ -44,6 +44,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.replaceOne

source/includes/apiargs-method-db.collection.save-param.yaml

@@ -14,7 +14,8 @@ description: |
   </reference/write-concern>`. Omit to use the default write concern.
   See :ref:`save-wc`.
 
-  .. versionadded:: 2.6
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.save

source/includes/apiargs-method-db.collection.updateMany-param.yaml

@@ -47,6 +47,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.updateMany

source/includes/apiargs-method-db.collection.updateOne-param.yaml

@@ -47,6 +47,8 @@ description: |
   A document expressing the :doc:`write concern
   </reference/write-concern>`. Omit to use the default write concern.
 
+  .. include:: /includes/extracts/transactions-operations-write-concern.rst
+
 interface: method
 name: writeConcern
 operation: db.collection.updateOne

source/reference/command/aggregate.txt

@@ -56,6 +56,27 @@ For more information about the aggregation pipeline
 :doc:`/core/aggregation-pipeline`, :doc:`/reference/aggregation`, and
 :doc:`/core/aggregation-pipeline-limits`.
 
+Transactions
+------------
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+However, the following stages are not allowed within transactions:
+
+- :pipeline:`$collStats`
+- :pipeline:`$currentOp`
+- :pipeline:`$indexStats`
+- :pipeline:`$listLocalSessions`
+- :pipeline:`$listSessions`
+- :pipeline:`$out`
+
+You also cannot specify the ``explain`` option.
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+.. |operation| replace:: :dbcommand:`aggregate`
+
+
 Example
 -------
 

source/reference/command/delete.txt

@@ -62,6 +62,9 @@ Definition
 Behavior
 --------
 
+Limits
+~~~~~~
+
 The total size of all the queries (i.e. the ``q`` field values) in the
 ``deletes`` array must be less than or equal to the :limit:`maximum
 BSON document size <BSON Document Size>`.
@@ -70,6 +73,18 @@ The total number of delete documents in the ``deletes`` array must be
 less than or equal to the :limit:`maximum bulk size
 <Bulk Operation Size>`.
 
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+.. include:: /includes/extracts/transactions-operations-write-concern.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+.. |operation| replace:: :dbcommand:`delete`
+
+
 Examples
 --------
 

source/reference/command/distinct.txt

@@ -63,6 +63,15 @@ Index Use
 
 .. include:: /includes/extracts/fact-distinct-command-index-use.rst
 
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+.. |operation| replace:: :dbcommand:`distinct`
+
 Examples
 --------
 

source/reference/command/find.txt

@@ -59,6 +59,18 @@ Definition
 
    .. include:: /includes/apiargs/dbcommand-find-field.rst
 
+Behavior
+--------
+
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+.. |operation| replace:: :dbcommand:`find`
+
 Examples
 --------
 

source/reference/command/findAndModify.txt

@@ -154,6 +154,20 @@ Comparisons with the ``update`` Method
 
 .. include:: /includes/fact-findAndModify-update-comparison.rst
 
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+If ``upsert: true``, the collection must already exist.
+
+.. include:: /includes/extracts/transactions-operations-write-concern.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+
+.. |operation| replace:: :dbcommand:`findAndModify`
+
 Examples
 --------
 

source/reference/command/geoSearch.txt

@@ -25,11 +25,25 @@ geoSearch
 Behavior
 --------
 
+Limit
+~~~~~
+
 Unless specified otherwise, the :dbcommand:`geoSearch` command
 limits results to 50 documents.
 
-.. important:: :dbcommand:`geoSearch` is not supported for sharded
-   clusters.
+Sharded Clusters
+~~~~~~~~~~~~~~~~
+
+:dbcommand:`geoSearch` is not supported for sharded clusters.
+
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+.. |operation| replace:: :dbcommand:`distinct`
 
 Examples
 --------

source/reference/command/insert.txt

@@ -45,15 +45,36 @@ Definition
 Behavior
 --------
 
+Size Limit
+~~~~~~~~~~
+
 The total size of all the ``documents`` array elements must be less
 than or equal to the :limit:`maximum BSON document size
 <BSON Document Size>`.
 
 The total number of documents in the ``documents`` array must be less
 than or equal to the :limit:`maximum bulk size <Bulk Operation Size>`.
 
+Document Validation
+~~~~~~~~~~~~~~~~~~~
+
 .. include:: /includes/extracts/bypassDocumentValidation-insert.rst
 
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+The collection must already exist. An insert operation that
+would result in the creation of a new collection are not allowed in a
+transaction.
+
+.. include:: /includes/extracts/transactions-operations-write-concern.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+.. |operation| replace:: :dbcommand:`insert`
+
 Examples
 --------
 

source/reference/method/db.collection.bulkWrite.txt

@@ -311,6 +311,17 @@ encountered, the number of successful write operations are displayed instead
 of the inserted ``_id`` values. Ordered operations display the single error 
 encountered while unordered operations display each error in an array.
 
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+For insert and ``upsert: true`` operations, the collection must already
+exist.
+
+.. include:: /includes/extracts/transactions-operations-write-concern.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
 
 Examples
 --------

source/reference/method/db.collection.deleteMany.txt

@@ -46,7 +46,7 @@ Behavior
 Capped Collections
 ~~~~~~~~~~~~~~~~~~
 
-:method:`~db.collection.deleteMany()` throws a ``WriteError`` exception 
+:method:`db.collection.deleteMany()` throws a ``WriteError`` exception 
 if used on a :term:`capped collection`. To remove all documents from a capped 
 collection, use :method:`db.collection.drop()` instead.
 
@@ -60,6 +60,17 @@ To delete a single document, use :method:`db.collection.deleteOne()` instead.
 Alternatively, use a field that is a part of a :term:`unique index` such as 
 ``_id``. 
 
+Transactions
+~~~~~~~~~~~~
+
+.. include:: /includes/extracts/transactions-supported-operation.rst
+
+.. include:: /includes/extracts/transactions-operations-write-concern.rst
+
+.. include:: /includes/extracts/transactions-usage.rst
+
+.. |operation| replace:: :method:`db.collection.deleteMany()`
+
 Examples
 --------