Skip to content

Commit 1f83891

Browse files
authored
DOCSP-44120-clarify-mongosync-sharding-behavior (#487) (#497)
* DOCSP-44120-mongosync-sharding-behavior * DOCSP-44120-mongosync-sharding-behavior * DOCSP-44120-mongosync-sharding-behavior * DOCSP-44120-FAQ * DOCSP-44120 tech edit * DOCSP-44120 tech edit (cherry picked from commit aba042e)
1 parent caa84f3 commit 1f83891

File tree

2 files changed

+21
-0
lines changed

2 files changed

+21
-0
lines changed

source/faq.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -187,3 +187,11 @@ Does ``mongosync`` Support TTL Indexes?
187187
{+c2c-product-name+} supports syncing :ref:`index-feature-ttl` from the source
188188
to the destination cluster.
189189

190+
191+
Can I customize chunk distributions when syncing into a sharded cluster?
192+
------------------------------------------------------------------------
193+
194+
No, you can't configure ``mongosync`` to customize chunk distributions
195+
on a destination sharded cluster. ``mongosync`` samples each collection
196+
during initialization to determine how to distribute documents
197+
efficiently across the destination cluster’s shards after migration.

source/reference/mongosync/mongosync-behavior.txt

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,19 @@ for sharded collections on the destination cluster. For each sharded collection,
7474
``mongosync`` creates twice as many chunks as there are shards in the
7575
destination cluster.
7676

77+
Chunk Distribution
78+
''''''''''''''''''
79+
80+
``mongosync`` does not preserve chunk distribution from the source to
81+
the destination, even with multiple ``mongosync`` instances. It is not
82+
possible to reproduce a particular pre-split of chunks from a source
83+
cluster on the destination cluster.
84+
85+
The only sharding configuration that ``mongosync`` preserves from the
86+
source cluster to the destination cluster is the sharding key. Once the
87+
migration finishes, you can enable the destination cluster's balancer which
88+
distributes documents independently of the source cluster's distribution.
89+
7790
Primary Shards
7891
''''''''''''''
7992

0 commit comments

Comments
 (0)