唯一索引

唯一索引单场¶

例如，要user_id在members集合的字段 上创建唯一索引，请在mongo外壳程序中使用以下操作 ：

db.members.createIndex( { "user_id": 1 }, { unique: true } )

独特的复合指数¶

您还可以对复合索引实施唯一约束。如果对复合索引使用唯一约束 ，则MongoDB将对索引键值的组合实施唯一性。

例如，要在集合的，和字段上创建唯一索引groupNumber，请在外壳程序中使用以下操作：lastnamefirstnamemembersmongo

db.members.createIndex( { groupNumber: 1, lastname: 1, firstname: 1 }, { unique: true } )

所创建的索引实施唯一的组合的 groupNumber，lastname和firstname的值。

再举一个例子，考虑一个包含以下文档的集合：

{ _id: 1, a: [ { loc: "A", qty: 5 }, { qty: 10 } ] }

在和上创建唯一的复合多键索引：a.loca.qty

db.collection.createIndex( { "a.loc": 1, "a.qty": 1 }, { unique: true } )

唯一索引允许将以下文档插入集合中，因为该索引对和值的组合强制唯一性 ：a.loca.qty

db.collection.insert( { _id: 2, a: [ { loc: "A" }, { qty: 5 } ] } )
db.collection.insert( { _id: 3, a: [ { loc: "A", qty: 10 } ] } )

限制¶

如果集合已经包含违反索引唯一约束的数据，则MongoDB无法在指定的索引字段上创建唯一索引。

您不能在哈希索引上指定唯一约束。

在副本集和分片群集上构建唯一索引¶

对于副本集和分片群集，使用滚动过程创建唯一索引要求您在该过程中停止对集合的所有写操作。如果在此过程中无法停止对集合的所有写操作，请不要使用滚动过程。而是通过以下方式在集合上构建唯一索引：

• db.collection.createIndex()在主数据库上发布副本集，或者
• db.collection.createIndex()在上 mongos为分片群集发行。

跨单独文档的唯一约束¶

唯一约束适用于集合中的单独文档。也就是说，唯一索引可防止单独的文档的索引键具有相同的值。

因为该约束适用于单独的文档，所以对于唯一的 多键索引，文档可能具有导致重复索引键值的数组元素，只要该文档的索引键值不重复另一个文档的索引键值即可。在这种情况下，重复的索引条目仅被插入索引一次。

例如，考虑包含以下文档的集合：

{ _id: 1, a: [ { loc: "A", qty: 5 }, { qty: 10 } ] }
{ _id: 2, a: [ { loc: "A" }, { qty: 5 } ] }
{ _id: 3, a: [ { loc: "A", qty: 10 } ] }

在a.loc和上创建唯一的复合多键索引a.qty：

db.collection.createIndex( { "a.loc": 1, "a.qty": 1 }, { unique: true } )

如果集合中没有其他文档的索引关键字值为，则唯一索引允许将以下文档插入到集合中。{ "a.loc": "B", "a.qty": null }

db.collection.insert( { _id: 4, a: [ { loc: "B" }, { loc: "B" } ] } )

唯一索引，并且缺少字段¶

如果文档在唯一索引中没有索引字段的值，则索引将为此文档存储一个空值。由于存在独特的约束，MongoDB将只允许一个缺少索引字段的文档。如果有多个文档没有索引字段的值或缺少索引字段，则索引构建将失败，并出现重复的键错误。

例如，一个集合在上具有唯一索引x：

db.collection.createIndex( { "x": 1 }, { unique: true } )

x如果集合尚不包含缺少该字段的文档，则唯一索引允许插入 不包含该字段的文档x：

db.collection.insert( { y: 1 } )

但是，x如果集合中已经包含缺少该字段的文档，则在插入没有该字段的文档时，唯一索引错误x：

db.collection.insert( { z: 1 } )

由于违反了对字段值的唯一约束，因此该操作无法插入文档x：

WriteResult({
   "nInserted" : 0,
   "writeError" : {
      "code" : 11000,
      "errmsg" : "E11000 duplicate key error index: test.collection.$a.b_1 dup key: { : null }"
   }
})

独特的部分索引¶

部分索引仅索引集合中符合指定过滤器表达式的文档。如果同时指定 partialFilterExpression和约束，则唯一约束仅适用于满足过滤器表达式的文档。

如果文档不满足过滤条件，则具有唯一性约束的部分索引不会阻止不符合唯一性约束的文档的插入。有关示例，请参见 具有唯一约束的部分索引。

分片集群和唯一索引¶

您不能在哈希索引上指定唯一约束。

对于远程分片集合，只有以下索引可以是 唯一的：

• 分片键上的索引

• 一个复合索引，其中片键是一个前缀

• 默认_id索引；不过，该_id指数仅实施每碎片的唯一性约束，如果该_id字段是不是分片键或片键的前缀。

  唯一性与_id索引

  如果该_id字段不是分片密钥或分片密钥的前缀，则_id索引仅对每个分片强制执行唯一性约束，而不对每个分片实施唯一性约束。

  例如，考虑一个跨越两个分片A和B的分片集合（具有分片键）。由于该键不是分片键的一部分，因此该集合中可能有一个文档的值在分片A中，而另一个文档的 值在分片B中。 。{x: 1}_id_id1_id1

  如果该_id字段既不是分片密钥，也不是分片密钥的前缀，则MongoDB希望应用程序在_id各个分片上强制值的唯一性。

唯一的索引约束意味着：

• 对于要分片的集合，如果该集合具有其他唯一索引，则无法分片该集合。
• 对于已经分片的集合，不能在其他字段上创建唯一索引。