OPTIONS
翻译或纠错本页面

sh.shardCollection()

定义

sh.shardCollection(namespace, key, unique)

使用 key 作为 shard key 对一个集合开启分片. sh.shardCollection() 接收以下参数:

Parameter Type Description
namespace string The namespace of the collection to shard.
key document A document that specifies the shard key to use to partition and distribute objects among the shards. A shard key may be one field or multiple fields. A shard key with multiple fields is called a “compound shard key.”
unique Boolean When true, ensures that the underlying index enforces a unique constraint. Hashed shard keys do not support unique constraints.

2.4 新版功能: 使用格式 {field: "hashed"} 来创建:term:`哈希片键 <hashed shard key>.哈希片键不可以是复合索引.

注意事项

在执行 shardCollection 之后,MongoDB没有提供取消集群分片的方法.另外,执行 shardCollection 之后,集合的片键与文档中的片键值也不能够被修改.

示例

以下的操作在 records 数据库中的 people 集合上使用 zipcode 作为片键对此集合开启了分片.

sh.shardCollection("records.people", { zipcode: 1} )

额外信息

参见 shardCollection 获得命令的其他选项, 分片分片介绍 查看分片的概览,:doc:/tutorial/deploy-shard-cluster 查看部署教程,:ref:sharding-shard-key 查看如何人选取一个片键.