sh.commitReshardCollection.txt

============================
sh.commitReshardCollection()
============================

.. default-domain:: mongodb

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

Definition
----------

.. method:: sh.commitReshardCollection(namespace)

   .. versionadded:: 5.0

   During a resharding operation, MongoDB does not block writes until
   the estimated duration to complete the resharding operation is
   below **two seconds**.

   If the current estimate is above two seconds but the time frame is
   acceptable to you, you can finish resharding faster. The
   :method:`sh.commitReshardCollection()` method blocks writes early and
   forces the resharding operation to complete.

   .. |dbcommand| replace:: :dbcommand:`commitReshardCollection` command
   .. include:: /includes/fact-mongosh-shell-method-alt.rst

Compatibility
-------------

This method is available in deployments hosted in the following environments: 

.. include:: /includes/fact-environments-atlas-only.rst

.. include:: /includes/fact-environments-atlas-support-no-free.rst

.. include:: /includes/fact-environments-onprem-only.rst

Syntax
------

The :method:`sh.commitReshardCollection()` method has the following
syntax:

.. code-block:: javascript

   sh.commitReshardCollection( <namespace> )

Parameter
~~~~~~~~~

The :method:`sh.commitReshardCollection()` method takes the following
parameter:

.. list-table::
   :header-rows: 1
   :widths: 20 20 60

   * - Parameter
     - Type
     - Description

   * - :ref:`namespace <method-commitReshardCollection-namespace>`

     - String

     - .. _method-commitReshardCollection-namespace:

       The name of the collection to shard in the form
       ``"<database>.<collection>"``.

Example
-------

Commit a Resharding Operation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The following command forces the :ref:`resharding operation
<sharding-resharding>` on the ``sales.orders`` to block writes and
complete:

.. code-block:: javascript

   sh.commitReshardCollection("sales.orders")

.. seealso::

   :ref:`sharding-resharding`