DOCS-19209 configureCollectionBalancing (#745)

* DOCS-19209 Roughs in new content

* DOCS-19209 Adds reference link

* DOCS-19209 Nav adjustment

* DOCS-19209 configureCOllectionBalancing description

* DOCS-19209 Parameter table

* DOCS-19209 Example code blocks

* DOCS-19209 Adds optional flag

* DOCS-19209 Adjusts reference text

* DOCS-19209 Expands example text

* DOCS-19209 Vale fixes

* DOCS-19209 Updates modifying chunk size page for new command

* DOCS-19209 Reorder sections on Modify Chunk Size

* DOCS-19209 Notes that chunk sizes can be changed for collection

* DOCS-19209 Adds version notice

* DOCS-19209 Removes version added marker

* DOCS-19209 vale checks

* DOCS-19209 Navigation fix

* DOCS-19209 Internal Review Fixes, per Ian Fogelman

* DOCS-19209 Internal Review Fixes, per Ian Fogelman

* DOCS-19209 Internal Review Fixes, per Ian Fogelman

* DOCS-19209 Internal Review Fixes, per Ian Fogelman

* DOCS-19209 Internal Review Fixes, per Ian Fogelman

* DOCS-19209 Removes enableAutoSplitter from configureCollectionBalancing doc

* DOCS-19209 Further removes changes calling out collection-level autosplit

* DOCS-19209 reverts changes on core/charding-data-partitioning

* Fixes per Tommaso

Author: kennethdyer

source/reference/command.txt

@@ -472,6 +472,12 @@ Sharding Commands
 
        .. versionadded:: 5.0
 
+   * - :dbcommand:`configureCollectionBalancing`
+
+     - Configures balancer settings on a sharded collection.
+
+       .. versionadded:: 5.3
+
    * - :dbcommand:`enableSharding`
 
      - Enables sharding on a specific database.

source/reference/command/configureCollectionBalancing.txt

@@ -0,0 +1,101 @@
+================================
+configureCollectionBalancing
+================================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+.. meta::
+   :description: configureCollectionBalancing
+   :keywords: configureCollectionBalancing
+
+Definition
+------------
+
+.. dbcommand:: configureCollectionBalancing
+
+   .. versionadded:: 5.3
+
+   Configures balancer settings for a sharded collection, such as
+   setting the chunk size for and defragmenting the collection.
+
+   To run :dbcommand:`configureCollectionBalancing`, use the
+   :method:`db.adminCommand` method:
+
+   .. code-block:: none
+
+      db.adminCommand( {
+         configureCollectionBalancing: "<collection>",
+         chunkSize: <num>,
+         defragmentCollection: <bool>
+      } )
+
+   :dbcommand:`configureCollectionBalancing` has the following fields:
+
+   .. list-table::
+      :header-rows: 1
+      :widths: 20 20 80
+
+      * - Field
+        - Type
+        - Description
+      * - ``configureCollectionBalancing``
+        - string
+        - Required: The name of the database and sharded collection to configure.
+      * - ``chunkSize``
+        - integer
+        - Optional: Sets the chunk size in MiB for the collection.
+      * - ``defragmentCollection``
+        - boolean
+        - Optional: Causes the balancer to defragment the collection.
+
+
+For more information, see :ref:`Data Partioning with Chunks
+<sharding-data-partitioning>`.
+
+Examples
+----------
+
+Configure Chunk Size
+~~~~~~~~~~~~~~~~~~~~~~
+
+To change the chunk size for a sharded collection, use
+the ``chunkSize`` option:
+
+.. code-block:: javascript
+
+   db.adminCommand( {
+      configureCollectionBalancing: "test.students",
+      chunkSize: 10
+   } )
+
+Use this command to change the chunk size for the given collection.
+
+.. warning::
+
+   By default, MongoDB cannot move a chunk if the number of documents in
+   the chunk is greater than 1.3 times the result of dividing the
+   configured chunk size by the average document size.
+
+   To find the average document size, see the ``avgObjSize`` field in the
+   output of the :method:`db.collection.stats()` method.
+
+For more information, see :ref:`Chunk Size <sharding-chunk-size>`.
+
+Defragment Collections
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+To tell the balancer to defragment a sharded collection, use the
+``defragmentCollection``  option:
+
+.. code-block:: javascript
+
+   db.adminCommand( {
+      configureCollectionBalancing: "test.students",
+      defragmentCollection: true
+   } )
+
+Use this command to have the balancer defragment a sharded collection.

source/reference/command/nav-sharding.txt

@@ -80,6 +80,12 @@ Sharding Commands
 
        .. versionadded:: 5.0
 
+   * - :dbcommand:`configureCollectionBalancing`
+
+     - Configures balancer settings on a sharded collection.
+
+       .. versionadded:: 5.3
+
    * - :dbcommand:`enableSharding`
 
      - Enables sharding on a specific database.
@@ -194,6 +200,7 @@ Sharding Commands
    /reference/command/cleanupOrphaned
    /reference/command/cleanupReshardCollection
    /reference/command/commitReshardCollection
+   /reference/command/configureCollectionBalancing
    /reference/command/enableSharding
    /reference/command/flushRouterConfig
    /reference/command/getShardMap