Skip to content

minor copy edits to tag aware sharding docs #668

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 21, 2013
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions source/administration/operational-segregation.txt
Original file line number Diff line number Diff line change
Expand Up @@ -45,9 +45,9 @@ Specifically, with MongoDB, you can:

- combine the above features in a single distributed deployment, on a
per-operation (for read and write operations) and collection (for
chunk distribution in sharded clusters distribution.) basis.
chunk distribution in sharded clusters distribution) basis.

For full documentation of these features see the following
For full documentation of these features, see the following
documentation in the MongoDB Manual:

- :ref:`Read Preferences <read-preference>`, which controls how drivers
Expand All @@ -59,11 +59,11 @@ documentation in the MongoDB Manual:

- :ref:`Replica Set Tags <replica-set-configuration-tag-sets>`, which
control how applications create and interact with custom groupings
of replica set members to create custom application specific read
of replica set members to create custom application-specific read
preferences and write concerns.

- :ref:`Tag Aware Sharding <tag-aware-sharding>`, which allows MongoDB
administrators to define an application specific balancing policy,
administrators to define an application-specific balancing policy,
to control how documents belonging to specific ranges of a shard key
distribute to shards in the :term:`sharded cluster`.

Expand Down
14 changes: 7 additions & 7 deletions source/administration/tag-aware-sharding.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,14 @@ sharding in MongoDB deployments.

.. note::

Shard key rage tags are entirely distinct from :ref:`replica set member
Shard key range tags are entirely distinct from :ref:`replica set member
tags <replica-set-read-preference-tag-sets>`.

Behavior and Operations
-----------------------

Tags in a sharded cluster are pieces of metadata that dictate the
policy and behavior of the cluster balancer :term:`balancer`. Using
policy and behavior of the cluster :term:`balancer`. Using
tags, you may associate individual shards in a cluster with one or
more tags. Then, you can assign this tag string to a range
of :term:`shard key` values for a sharded collection. When migrating a
Expand All @@ -53,10 +53,10 @@ tags, if tagged shards are not balanced. [#specific-tagged-migrations]_
that:

- :term:`Shard key` values between ``100`` and ``200`` have tags to
direct corresponding chunks on shards tagged ``NYC``.
direct corresponding chunks to shards tagged ``NYC``.

- Shard Key values between ``200`` and ``300`` have tags to direct
corresponding chunks on shards tagged ``SFO``.
corresponding chunks to shards tagged ``SFO``.

In this cluster, the balancer will migrate a chunk with shard key
values ranging between ``150`` and ``220`` to a shard tagged
Expand Down Expand Up @@ -162,7 +162,7 @@ View Existing Shard Tags
The output from :method:`sh.status()` lists tags associated with a
shard, if any, for each shard. A shard's tags exist in the shard's
document in the :data:`~config.shards` collection of the ``config``
database. To return all shards with a specific tag use a sequence of
database. To return all shards with a specific tag, use a sequence of
operations that resemble the following, which will return only those
shards tagged with ``NYC``:

Expand All @@ -174,10 +174,10 @@ shards tagged with ``NYC``:
You can find tag ranges for all :term:`namespaces <namespace>` in the
:data:`~config.tags` collection of the ``config`` database. The output
of :method:`sh.status()` displays all tag ranges. To return all shard
key ranges tagged with ``NYC`` issue the following sequence of
key ranges tagged with ``NYC``, issue the following sequence of
commands:

.. code-block:: javascript

use config
db.shards.find({ tags: "NYC" })
db.tags.find({ tags: "NYC" })
2 changes: 1 addition & 1 deletion source/data-center-awareness.txt
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ MongoDB provides a number of features that allow application
developers and database administrators to customize the behavior of a
:term:`sharded cluster` or :term:`replica set` deployment so that
MongoDB may be *more* "data center aware," or allow operational
separation and segregation based on location.
separation and location-based separation.

MongoDB also supports segregation based
on functional parameters, to ensure that certain :program:`mongod`
Expand Down