Skip to content

Commit 63d9b3b

Browse files
authored
DOCSP-44120-clarify-mongosync-sharding-behavior (#487) (#496)
* 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 fcf3ff8 commit 63d9b3b

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
@@ -111,6 +111,19 @@ for sharded collections on the destination cluster. For each sharded collection,
111111
``mongosync`` creates twice as many chunks as there are shards in the
112112
destination cluster.
113113

114+
Chunk Distribution
115+
''''''''''''''''''
116+
117+
``mongosync`` does not preserve chunk distribution from the source to
118+
the destination, even with multiple ``mongosync`` instances. It is not
119+
possible to reproduce a particular pre-split of chunks from a source
120+
cluster on the destination cluster.
121+
122+
The only sharding configuration that ``mongosync`` preserves from the
123+
source cluster to the destination cluster is the sharding key. Once the
124+
migration finishes, you can enable the destination cluster's balancer which
125+
distributes documents independently of the source cluster's distribution.
126+
114127
Primary Shards
115128
''''''''''''''
116129

0 commit comments

Comments
 (0)