sh.updateZoneKeyRange()

Create the Zones创建分区

Use sh.addShardToZone() to create the zones:使用sh.addShardToZone()创建分区：

sh.addShardToZone("shardA", "DC1")
sh.addShardToZone("shardB", "DC2")

Create the Zone Ranges创建分区范围

Use sh.updateZoneKeyRange() to create the ranges for the empty contacts collection in the exampledb database:使用sh.updateZoneKeyRange()为exampledb数据库中的空contacts集合创建范围：

sh.updateZoneKeyRange(
    "exampledb.contacts",
    { zip: 10001 },
    { zip: 10090 },
    "DC1"
);

sh.updateZoneKeyRange(
    "exampledb.contacts",
    { zip: 90001 },
    { zip: 96054 },
    "DC2"
);

Shard the Collection粉碎集合

Use sh.shardCollection() to shard the collection contacts:使用sh.shardCollection()对集合contacts进行分片：

sh.shardCollection("exampledb.contacts",  { zip: 1 } );

Review the Created Chunks and Distribution查看创建的区块和分布

To see the created chunks and distribution, run the sh.status() operation:要查看创建的区块和分布，请运行sh.status()操作：

sh.status()

The method returns:该方法返回：

--- Sharding Status ---
  sharding version: {
    "_id" : 1,
    "minCompatibleVersion" : 5,
    "currentVersion" : 6,
    "clusterId" : ObjectId("5b80c06d35a961fd0ae1986d")
  }
  shards:
        {  "_id" : "shardA",  "host" : "shardA/mongodb0.example.net:27018,mongodb1.example.net:27018,mongodb2.example.net:27018",  "state" : 1,  "tags" : [ "DC1" ] }
        {  "_id" : "shardB",  "host" : "shardB/mongodb3.example.net:27018,mongodb4.example.net:27018,mongodb5.example.net:27018",  "state" : 1,  "tags" : [ "DC2" ] }
  active mongoses:
        "4.2.0" : 2
  autosplit:
        Currently enabled: yes
  balancer:
        Currently enabled:  yes
        Currently running:  no
        Failed balancer rounds in last 5 attempts:  0
        Migration Results for the last 24 hours:
                No recent migrations
  databases:
        {  "_id" : "config",  "primary" : "config",  "partitioned" : true }
        {  "_id" : "exampledb",  "primary" : "shardA",  "partitioned" : true,  "version" : {  "uuid" : UUID("6c351bcf-acd2-4fd9-82d8-9f6bd7321558"),  "lastMod" : 1 } }
                exampledb.contacts
                        shard key: { "zip" : 1 }
                        unique: false
                        balancing: true
                        chunks:
                                shardA   3
                                shardB   2
                        { "zip" : { "$minKey" : 1 } } -->> { "zip" : 10001 } on : shardA Timestamp(1, 0)
                        { "zip" : 10001 } -->> { "zip" : 10090 } on : shardA Timestamp(1, 1)
                        { "zip" : 10090 } -->> { "zip" : 90001 } on : shardB Timestamp(1, 2)
                        { "zip" : 90001 } -->> { "zip" : 96054 } on : shardB Timestamp(1, 3)
                        { "zip" : 96054 } -->> { "zip" : { "$maxKey" : 1 } } on : shardA Timestamp(1, 4)
                          tag: DC1  { "zip" : 10001 } -->> { "zip" : 10090 }
                          tag: DC2  { "zip" : 90001 } -->> { "zip" : 96054 }

For the collection, sharding operation created 5 chunks (two chunks that correspond to the zone ranges and the other three to cover all other values) across shardA and shardB.对于集合，分片操作在shardA和shardB之间创建了5个块（两个块对应于区域范围，另外三个块覆盖所有其他值）。

Create the Zones创建分区

The planned shard key is { "_id" : "hashed", "facility" : 1 }. 计划的分片键为{ "_id" : "hashed", "facility" : 1 }。Since the hashed field is the prefix (i.e. the first field in the shard key), create a single zone using sh.addShardToZone():由于哈然而 字段是前缀（即分片键中的第一个字段），因此使用sh.addShardToZone()创建一个区域：

sh.addShardToZone("shardA", "FacilityAlpha")
sh.addShardToZone("shardB", "FacilityAlpha")

Create the Zone Ranges创建分区范围

Initial chunk distribution on a compound hashed shard key with a hashed prefix requires a single zone range with MinKey for all lower-bound fields and MaxKey for all upper-bound fields.具有哈希前缀的复合哈希分片键上的初始区块分布需要一个单独的区域范围，所有下界字段为MinKey，所有上界字段为MaxKey。

Use sh.updateZoneKeyRange() to create a single range:使用sh.updateZoneKeyRange()创建单个范围：

sh.updateZoneKeyRange(
   "examples.metrics",
   { "_id" : MinKey, "facility" : MinKey },
   { "_id" : MaxKey, "facility" : MaxKey },
   "FacilityAlpha"
);

Shard the Collection分片集合

Use sh.shardCollection() with presplitHashedZones: true to shard the collection and perform initial chunk creation and distribution:使用sh.shardCollection()和presplitHashedZones: true对集合进行分片，并执行初始区块创建和分发：

sh.shardCollection(
  "examples.metrics",
  { "_id" : "hashed", "facility" : 1 },
  false,
  { presplitHashedZones: true }
)

Review the Created Chunks and Distribution查看创建的区块和分布

To see the created chunks and distribution, run the sh.status() operation:要查看创建的区块和分布，请运行sh.status()操作：

sh.status()

The output resembles the following (content omitted for readability):输出类似于以下内容（为了可读性，省略了内容）：

--- Sharding Status ---

databases:
  {  "_id" : "config",  "primary" : "config",  "partitioned" : true }
  {  "_id" : "examples",  "primary" : "shardA",  "partitioned" : true,  "version" : {  "uuid" : UUID("245f8abf-a363-48b0-8208-2a5b577bbb4e"),  "lastMod" : 1 } }
    examples.metrics
      shard key: { "_id" : "hashed", "facility" : 1 }
      unique: false
      balancing: true
      chunks:
        shardA  2
        shardB  2
      { "_id" : { "$minKey" : 1 }, "facility" : { "$minKey" : 1 } } -->> { "_id" : NumberLong("-4611686018427387902"), "facility" : { "$minKey" : 1 } } on : shardA Timestamp(1, 0)
      { "_id" : NumberLong("-4611686018427387902"), "facility" : { "$minKey" : 1 } } -->> { "_id" : NumberLong(0), "facility" : { "$minKey" : 1 } } on : shardA Timestamp(1, 1)
      { "_id" : NumberLong(0), "facility" : { "$minKey" : 1 } } -->> { "_id" : NumberLong("4611686018427387902"), "facility" : { "$minKey" : 1 } } on : shardB Timestamp(1, 2)
      { "_id" : NumberLong("4611686018427387902"), "facility" : { "$minKey" : 1 } } -->> { "_id" : { "$maxKey" : 1 }, "facility" : { "$maxKey" : 1 } } on : shardB Timestamp(1, 3)

        tag: FacilityAlpha  { "_id" : { "$minKey" : 1 }, "facility" : { "$minKey" : 1 } } -->> { "_id" : { "$maxKey" : 1 }, "facility" : { "$maxKey" : 1 } }

The sharding operation produced 4 chunks in total. Two chunks correspond to the absolute lower and upper bounds. 分片操作总共产生了4个块。两个块对应于绝对的下限和上限。One zone was created on shardA and shardB corresponding to FacilityAlpha. 在与FacilityAlpha对应的shardA和shardB上创建了一个区域。The zone was subdivided into 2 chunks using the hashed field.使用散列字段将该区域细分为2个块。

Create the Zones创建分区

Use the sh.addShardToZone() command to create the zones.使用sh.addShardToZone()命令创建分区。

sh.addShardToZone("shardA", "FacilityAlpha")
sh.addShardToZone("shardB", "FacilityBaker")

Create the Zone Ranges创建分区范围

The planned shard key is {"facility" : 1, "_id" : "hashed"}. 计划的分片键为{"facility" : 1, "_id" : "hashed"}。The facility field has two possible values: FacilityAlpha and FacilityBaker.facility字段有两个可能的值：FacilityAlpha和FacilityBaker。

Initial chunk distribution on a compound hashed shard key where the hashed field is not the prefix requires one zone range for each combination of distinct prefix field values (i.e. all fields preceding the hashed field). 在散列字段不是前缀的复合散列分片键上的初始块分布要求不同前缀字段值的每个组合（即散列字段之前的所有字段）具有一个区域范围。Since facility has two distinct prefix values, the collection requires exactly two zone ranges that cover those values.由于facility有两个不同的前缀值，因此集合正好需要两个覆盖这些值的区域范围。

• The lower bound range specifies MinKey for all non-prefix fields.下限范围为所有非前缀字段指定MinKey。
• The upper-bound range has at least one prefix field that differs from its lower-bound counterpart.上限范围至少有一个前缀字段与其下限对应字段不同。

Use sh.updateZoneKeyRange() to create the range for "facility": "FacilityAlpha":使用sh.updateZoneKeyRange()为"facility": "FacilityAlpha"创建范围：

sh.updateZoneKeyRange(
   "examples.metrics",
   { "facility": "FacilityAlpha", "_id" : MinKey },
   { "facility": "FacilityBaker", "_id" : MinKey },
   "FacilityAlpha"
);

• Since zone range upper bounds are exclusive, this range only covers documents with the distinct shard key prefix value "facilty" : "FacilityAlpha" and all possible values of _id.由于区域范围的上限是排他性的，因此该范围仅涵盖具有不同分片键前缀值"facilty" : "FacilityAlpha"和_id的所有可能值的文档。

Use sh.updateZoneKeyRange() to create the range for "facility": "FacilityBaker":使用sh.updateZoneKeyRange()为"facility": "FacilityBaker"创建范围：

sh.updateZoneKeyRange(
   "examples.metrics",
   { "facility": "FacilityBaker", "_id" : MinKey },
   { "facility": MaxKey, "_id" : MinKey },
   "FacilityBaker"
);

• While the upper bound of this range can technically capture other values of facility, the initial chunk distribution logic relies on the assumption that no other distinct values for facility exist. 虽然该范围的上限在技术上可以捕获facility的其他值，但初始块分布逻辑依赖于不存在facility的其他不同值的假设。Since the collection only contains documents where facility is FacilityAlpha or FacilityBaker, this range only covers documents with the distinct shard key prefix value "facility" : "FacilityBaker" and all possible values of _id.由于集合仅包含facility为FacilityAlpha或FacilityBaker的文档，因此此范围仅涵盖具有不同分片键前缀值"facility" : "FacilityBaker"和所有可能值_id的文档。

Shard the Collection分片集合

Use sh.shardCollection() with presplitHashedZones: true to shard the collection and perform initial chunk creation and distribution:使用sh.shardCollection()和presplitHashedZones: true对集合进行分片，并执行初始区块创建和分发：

sh.shardCollection(
  "examples.metrics",
  { "facility" : 1, "_id" : "hashed"},
  false,
  { presplitHashedZones: true }
)

Review the Created Chunks and Distribution查看创建的区块和分布

To see the created chunks and distribution, run the sh.status() operation:要查看创建的区块和分布，请运行sh.status()操作：

sh.status()

The output resembles the following (content omitted for readability):输出类似于以下内容（为了可读性，省略了内容）：

--- Sharding Status ---

  databases:
    {  "_id" : "config",  "primary" : "config",  "partitioned" : true }
    {  "_id" : "examples",  "primary" : "shardA",  "partitioned" : true,  "version" : {  "uuid" : UUID("6c351bcf-acd2-4fd9-82d8-9f6bd7321558"),  "lastMod" : 1 } }
      examples.metrics
        shard key: { "facility" : 1, "_id" : "hashed" }
        unique: false
        balancing: true
        chunks:
          shardA  3
          shardB  3
        { "facility" : { "$minKey" : 1 }, "_id" : { "$minKey" : 1 } } -->> { "facility" : "FacilityAlpha", "_id" : { "$minKey" : 1 } } on : shard1 Timestamp(1, 0)
        { "facility" : "FacilityAlpha", "_id" : { "$minKey" : 1 } } -->> { "facility" : "FacilityAlpha", "_id" : NumberLong(0) } on : shard1 Timestamp(1, 1)
        { "facility" : "FacilityAlpha", "_id" : NumberLong(0) } -->> { "facility" : "FacilityBaker", "_id" : { "$minKey" : 1 } } on : shard1 Timestamp(1, 2)
        { "facility" : "FacilityBaker", "_id" : { "$minKey" : 1 } } -->> { "facility" : "FacilityBaker", "_id" : NumberLong(0) } on : shard2 Timestamp(1, 3)
        { "facility" : "FacilityBaker", "_id" : NumberLong(0) } -->> { "facility" : { "$maxKey" : 1 }, "_id" : { "$minKey" : 1 } } on : shard2 Timestamp(1, 4)
        { "facility" : { "$maxKey" : 1 }, "_id" : { "$minKey" : 1 } } -->> { "facility" : { "$maxKey" : 1 }, "_id" : { "$maxKey" : 1 } } on : shard2 Timestamp(1, 5)

          tag: FacilityAlpha  { "facility" : "FacilityAlpha", "_id" : { "$minKey" : 1 } } -->> { "facility" : "FacilityBaker", "_id" : { "$minKey" : 1 } }
          tag: FacilityBaker  { "facility" : "FacilityBaker", "_id" : { "$minKey" : 1 } } -->> { "facility" : { "$maxKey" : 1 }, "_id" : { "$minKey" : 1 } }

The sharding operation produced 6 chunks in total. Two chunks correspond to the absolute lower and upper bounds. 分片操作总共产生了6个块。两个块对应于绝对的下限和上限。Two zones were created, one on shardA and one on shardB, corresponding to FacilityAlpha and FacilityBaker. 创建了两个区域，一个在shardA上，另一个在shardB上，分别对应于FacilityAlpha和FacilityBaker。Each of these zones has been further subdivided into 2 chunks using the hashed field.使用散列字段将这些区域中的每个区域进一步细分为2个块。