Skip to content

Commit 9a3ebaa

Browse files
author
Sam Kleinman
committed
DOCS-983: edits
1 parent 1e53770 commit 9a3ebaa

File tree

2 files changed

+15
-15
lines changed

2 files changed

+15
-15
lines changed
Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
.. warning::
22

3-
Be careful when splitting chunks. When you shard a collection that
4-
has existing data, MongoDB automatically creates chunks to evenly
5-
spread the collection. Performing additional splits requires
6-
knowledge of the resulting chunk sizes by numbers of documents and by
7-
size. You do not want splits that cause some chunks to be much larger
8-
than others. This leads to balancing based on count of chunks, not on
9-
their size, which may cause extreme load/data-distribution problems.
3+
Be careful when splitting data in a sharded collection to create
4+
new chunks. When you shard a collection that has existing data,
5+
MongoDB automatically creates chunks to evenly distribute the
6+
collection. To effectively split data in a sharded you must
7+
consider the number of documents in a chunk and the average
8+
document size to create a uniform chunk size. When chunks have
9+
irregular sizes, shards may have an equal number of chunks but have
10+
very different data sizes. Avoid creating splits that lead to a
11+
collection with differently sized chunks.

source/tutorial/manage-chunks-in-sharded-cluster.txt

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -103,13 +103,12 @@ chunk splits.
103103
Create Chunks (Pre-Splitting)
104104
-----------------------------
105105

106-
Pre-splitting lets you preemptively split chunks in an empty collection
107-
and is used *only* in certain situations.
108-
In most situations a :term:`sharded cluster` will create and distribute
109-
chunks automatically without user intervention. However, in a limited
110-
number of use profiles, MongoDB cannot create enough chunks or
111-
distribute data fast enough to support required throughput.
112-
For example, if:
106+
Pre-splitting the chunk ranges in an empty sharded collection, allows
107+
clients to insert data into an already-partitioned collection. In most
108+
situations a :term:`sharded cluster` will create and distribute chunks
109+
automatically without user intervention. However, in a limited number
110+
of use profiles, MongoDB cannot create enough chunks or distribute
111+
data fast enough to support required throughput. For example, if:
113112

114113
- you must partition an existing data collection that resides on a
115114
single shard.
@@ -384,4 +383,3 @@ bulk insert operations:
384383
and see :ref:`Shard Key Internals <sharding-internals-shard-keys>` (in
385384
particular, :ref:`sharding-internals-operations-and-reliability` and
386385
:ref:`sharding-internals-choose-shard-key`).
387-

0 commit comments

Comments
 (0)