Changed in version 6.1.
Disables the balancer in a sharded cluster.
Starting in MongoDB 6.1, automatic chunk splitting is not performed. This is because of balancing policy improvements. Auto-splitting commands still exist, but do not perform an operation. For details, see Balancing Policy Changes.
In MongoDB versions earlier than 6.1,
sh.stopBalancer()also disables auto-splitting for the sharded cluster.
This page documents a
mongoshmethod. This is not the documentation for database commands or language-specific drivers, such as Node.js.
For the database command, see the
For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.
For the legacy
mongoshell documentation, refer to the documentation for the corresponding MongoDB Server release:
The method can take the following options:ParameterTypeDescription
Time limit for disabling the balancer.
Defaults to 60000 milliseconds.
intervalintegerThe interval (in milliseconds) at which to check if the balancing round has stopped.
If a balancing round is in progress, the operation waits for balancing to complete.