Docs Menu

Docs HomeMongoDB Manual

sh.disableAutoMerger()

On this page

  • Definition
  • Syntax
  • Method Field
  • Behavior
  • Example
  • Learn More
sh.disableAutoMerger(namespace)

New in version 7.0.

Disables automatic chunk merges for a namespace.

sh.disableAutoMerger() is a mongosh helper method. It is effectively the same as running the configureCollectionBalancing command with the enableAutoMerger field set to false.

Important

mongosh Method

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

For the database command, see the configureCollectionBalancing command.

For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.

For the legacy mongo shell documentation, refer to the documentation for the corresponding MongoDB Server release:

mongo shell v4.4

sh.disableAutoMerger( <namespace> )

The method takes the following field:

Field
Type
Necessity
Description
namespace
String
Required
Namespace in the format "<database>.<collection>". Method enables automatic chunk merges for the supplied namespace.

When the method runs, it stops the AutoMerger. Any in progress operations issued by the AutoMerger are completed.

The following example disables automatic chunk merges for "testDatabase.myCollection". Run the example from mongos:

sh.disableAutoMerger( "testDatabase.myCollection" )
←  sh.commitReshardCollection()sh.disableBalancing() →