Docs Menu

Docs HomeMongoDB Manual

sh.startBalancer()

On this page

  • Definition
  • Behavior
sh.startBalancer(timeout, interval)

Changed in version 6.1.

Starts 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.startBalancer() also enables auto-splitting for the sharded cluster.

The method can take the following options:

Parameter
Type
Description
timeout
integer

Optional. Time limit for enabling the balancer.

Defaults to 60000 milliseconds.

interval
integer
Optional. The frequency (in milliseconds) at which to check if a balancing round has started.

You can only run sh.startBalancer() on a mongos instance. sh.startBalancer() errors if run on mongod instance.

The mongosh shell method sh.startBalancer() is a wrapper around the balancerStart command. As such, the method does not wait for balancing to start.

In earlier versions, the method waited for the balancing to start.

Tip

See also:

←  sh.splitFind()sh.status() →

On this page

Give Feedback
© 2022 MongoDB, Inc.

About

  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2022 MongoDB, Inc.