Skip to content

Commit 215f670

Browse files
authored
Backports DOCSP-26654 to v6.0 (#2280)
1 parent 88d1be9 commit 215f670

File tree

4 files changed

+27
-7
lines changed

4 files changed

+27
-7
lines changed

source/core/sharding-balancer-administration.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,8 +59,8 @@ The :term:`balancer` attempts to minimize the impact by:
5959

6060
See also :ref:`range-migration-queuing`.
6161

62-
- Starting a balancing round **only** when the difference in the amount
63-
of data between the shard with the most data for a sharded collection
62+
- Starting a balancing round only when the **difference in the amount
63+
of data** between the shard with the most data for a sharded collection
6464
and the shard with the least data for that collection reaches the
6565
:ref:`migration threshold <sharding-migration-thresholds>`.
6666

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Starting in MongoDB 6.1, automatic chunk splitting is not performed.
1+
Starting in MongoDB 6.0, automatic chunk splitting is not performed.
22
This is because of balancing policy improvements. Auto-splitting commands
33
still exist, but do not perform an operation. For details, see
4-
:ref:`release-notes-6.1-balancing-policy-changes`.
4+
:ref:`release-notes-6.0-balancing-policy-changes`.

source/reference/method/sh.disableAutoSplit.txt

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,10 @@ sh.disableAutoSplit
1010
:depth: 1
1111
:class: singlecol
1212

13+
.. note::
14+
15+
.. include:: /includes/autosplit-no-operation.rst
16+
1317
Description
1418
-----------
1519

@@ -20,9 +24,6 @@ Description
2024
MongoDB automatically splits chunks based on the shard key values
2125
the chunk represents to keep the chunks from growing too large.
2226

23-
Auto-splitting is enabled by default. For more
24-
information on chunk splits, see :ref:`sharding-chunk-splits`.
25-
2627
You can only run :method:`sh.disableAutoSplit()` from a
2728
:binary:`~bin.mongosh` session that is connected to a
2829
:binary:`~bin.mongos` instance. :method:`sh.disableAutoSplit()`

source/release-notes/6.0.txt

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -406,6 +406,25 @@ To configure the audit log, see
406406
Sharding
407407
--------
408408

409+
.. _release-notes-6.0-balancing-policy-changes:
410+
411+
Balancing Policy Changes
412+
~~~~~~~~~~~~~~~~~~~~~~~~
413+
414+
Starting in MongoDB 6.0, data in sharded clusters is distributed based on data
415+
size rather than number of chunks. As a result, you should be aware of the
416+
following significant changes in sharded cluster data distribution behavior:
417+
418+
- The balancer distributes ranges of data rather than chunks. The balancing
419+
policy looks for evenness of data distribution rather than chunk distribution.
420+
421+
- Chunks are not subject to auto-splitting. Instead, chunks are split only when
422+
moved across shards.
423+
424+
- A chunk is now referred to as a range.
425+
426+
- ``moveRange`` has replaced ``moveChunk``.
427+
409428
Default Chunk Size Increased from 64 MB to 128 MB
410429
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
411430

0 commit comments

Comments
 (0)