Docs Menu

Docs HomeMongoDB Manual

balancerStop

On this page

  • Definition
  • Syntax
  • Example
balancerStop

Disables the balancer in a sharded cluster. If a balancing round is in progress, the operation waits for balancing to complete.

Starting in MongoDB 4.2, the command disables auto-splitting for the sharded cluster. To enable auto-splitting when the balancer is disabled, you can use sh.enableAutoSplit().

You can only issue the balancerStop against the admin database on a mongos instance.

The command has the following syntax:

db.adminCommand(
{
balancerStop: 1,
maxTimeMS: <number>
}
)
Field
Type
Description
balancerStop
any
Any value.
maxTimeMS
integer

Time limit for disabling the balancer.

Defaults to 60000 milliseconds.

To stop the balancer thread, connect to a mongos instance and issue the following command:

db.adminCommand( { balancerStop: 1 } )

Tip

See also:

←  balancerStatuscheckShardingIndex →
Share Feedback
© 2022 MongoDB, Inc.

About

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