sh.enableAutoSplit

Description

sh.enableAutoSplit()

Enables the autosplit flag in the config.settings collection. When auto-splitting is enabled for a sharded cluster, MongoDB automatically splits chunks based on the shard key values the chunk represents to keep the chunks from growing too large.

You can only run sh.enableAutoSplit() from a mongosh session that is connected to a mongos instance. sh.enableAutoSplit() errors if run on a mongod instance.

Note

Starting in MongoDB 6.0.3, automatic chunk splitting is not performed. This is because of balancing policy improvements. Auto-splitting commands still exist, but do not perform an operation.

In MongoDB versions earlier than 6.0.3, sh.startBalancer() also enables auto-splitting for the sharded cluster.

Tip

See also:

• Manage Sharded Cluster Balancer

• Sharded Cluster Balancer