addShardToZone( shard, zone )
New in version 3.4: Associates a shard with a zone. MongoDB associates this shard with the given zone. Chunks that are covered by the zone are assigned to shards associated with the zone.
Parameter Type Description shard string
The name of the shard to which to associate the zone.
The name of the zone to associate with the shard.
You can associate a zone with multiple shards, and a shard can associate with multiple zones.
See the zone manual page for more information on zones in sharded clusters.
MongoDB effectively ignores zones that do not have at least one range of shard key values associated with it.
To associate a range of shard key values with a zone, use the
For sharded clusters that enforce access control, you must authenticate as a user whose privileges include either:
shardscollection in the
configdatabase; or, alternatively,
enableShardingon the cluster resource (Starting in version 3.6.16).
The following example adds three zones,
NRT, associating each to a shard:
A shard can associate with multiple zones. The following example associates
shard0000 associates with both the
LGA zone and the
JFK zone. In a balanced cluster, MongoDB routes reads and writes covered by either zone to