configureCollectionBalancing (database command数据库命令)

Command Fields命令字段

configureCollectionBalancing has the following fields:具有以下字段：

For more information, see Data Partitioning with Chunks.有关更多信息，请参阅使用块进行数据分区。

To configure the chunk defragmentation throttling time parameter, see chunkDefragmentationThrottlingMS.要配置块分片整理限制时间参数，请参阅chunkDefragmentationThrottlingMS。

To learn about defragmenting sharded collections, see Defragment Sharded Collections.要了解分片化集合的分片整理，请参阅分片化集合。

Default Behavior When chunkSize Is Not Specified未指定chunkSize时的默认行为

If you do not specify chunkSize for a collection and no custom size has been set previously, the global default chunkSize is used for balancing.如果您没有为集合指定chunkSize，并且之前没有设置自定义大小，则使用全局默认chunkSize进行平衡。

Specifying指定 chunkSize:0

If you use configureCollectionBalancing with chunkSize: 0, the per-collection chunkSize is reset and the global default chunkSize is used for balancing.如果将configureCollectionBalancing与chunkSize:0一起使用，则重置每个集合的chunkSize，并使用全局默认chunkSize进行平衡。

For more information on configuring default chunkSize, see Modify Range Size in a Sharded Cluster.有关配置默认chunkSize的更多信息，请参阅修改分片群集中的范围大小。

Default Behavior When enableAutoMerger Is Not Specified未指定启用AutoMerger时的默认行为

If you do not specify enableAutoMerger for a collection and no custom automerging behavior has been previously set, it defaults to true and will be taken into account by the AutoMerger.如果您没有为集合指定enableAutoMerger，并且之前没有设置自定义自动合并行为，则默认为true，AutoMerger会将其考虑在内。

Parameter Validation参数验证

Starting in 8.2, MongoDB validates the spelling of parameters that you pass to configureCollectionBalancing. If you misspell a parameter, configureCollectionBalancing fails to execute and returns an error.从8.2开始，MongoDB会验证您传递给configureCollectionBalancing的参数的拼写。如果参数拼写错误，configureCollectionBalancing将无法执行并返回错误。

Configure Chunk Size配置块大小

To change the chunk size for a sharded collection, use the chunkSize option:要更改分片集合的块大小，请使用chunkSize选项：

db.adminCommand( {
   configureCollectionBalancing: "test.students",
   chunkSize: 256
} )

Use this command to change the chunk size for the given collection.使用此命令更改给定集合的块大小。

For more information, see Range Size.有关详细信息，请参阅范围大小。

Defragment Collections分片整理集合

To tell the balancer to defragment a sharded collection, use the defragmentCollection option:要告诉平衡器对分片集合进行分片整理，请使用defragmentCollection选项：

db.adminCommand( {
   configureCollectionBalancing: "test.students",
   defragmentCollection: true
} )

Use this command to have the balancer defragment a sharded collection. To monitor the chunk defragmentation process, use the balancerCollectionStatus command.使用此命令让平衡器对分片集合进行分片整理。要监视块分片整理过程，请使用balancerCollectionStatus命令。

To learn more about defragmenting sharded collections, see Defragment Sharded Collections.要了解有关对分片集合进行分片整理的更多信息，请参阅分片集合分片整理。

Reconfigure and Defragment Collections重新配置和分片整理集合

To defragment a sharded collection while updating the chunk size, use the defragmentCollection option and the chunkSize option together:要在更新块大小时对分片集合进行分片整理，请同时使用defragmentCollection选项和chunkSize选项：

db.adminCommand( {
   configureCollectionBalancing: "test.students",
   chunkSize: 512,
   defragmentCollection: true
} )

Disable the AutoMerger on a Collection禁用集合上的自动合并

To explicitly disable the AutoMerger on a collection, set the enableAutoMerger option to false:要明确禁用集合上的AutoMerger，请将enableAutoMerger选项设置为false：

db.adminCommand( {
   configureCollectionBalancing: "test.students",
   enableAutoMerger: false
} )

Disable Balancing on a Collection禁用集合上的平衡

To explicitly disable the balancer on a collection, set the enableBalancing option to false:要显式禁用集合上的平衡器，请将enableBalancing选项设置为false：

db.adminCommand( {
   configureCollectionBalancing: "test.students",
   enableBalancing: false
} )