db.collection.distinct()

在本页面

  • 定义

  • 选项

  • 行为

  • 例子

定义

  • db.collection. distinct(字段,查询,选项)

    • 在单个集合或视图中查找指定字段的不同值,并在 array 中返回结果。
参数类型描述
field要为其返回不同值的字段。
query文献一个查询,指定从中检索不同值的文档。
options文献可选的。指定选项的文档。见选项。

db.collection.distinct()方法在不同命令周围提供 wrapper。

注意
结果不得大于最大BSON 大小。如果结果超过最大 BSON 大小,请使用聚合管道使用$group operator 检索不同的值,如使用聚合管道检索不同的值中所述。

选项

{ collation: <document> }
领域类型描述
collation文献可选的。
指定要用于操作的整理。
整理允许用户为 string 比较指定 language-specific 规则,例如字母和重音标记的规则。
排序规则选项具有以下语法:
排序规则:{
locale:<string>,
caseLevel:<boolean>,
caseFirst:<string>,
strength:<int>,
numericOrdering:<boolean>,
alternate:<string>,
maxVariable:<string>,
backwards :<boolean>
}
指定排序规则时,locale字段是必填字段;所有其他校对字段都是可选的。有关字段的说明,请参阅整理文件。
如果未指定排序规则但集合具有默认排序规则(请参阅db.createCollection()),则操作将使用为集合指定的排序规则。
如果没有为集合或操作指定排序规则,MongoDB 使用先前版本中用于 string 比较的简单二进制比较。
您无法为操作指定多个排序规则。对于 example,您不能为每个字段指定不同的排序规则,或者如果使用排序执行查找,则不能对查找使用一个排序规则,而对排序使用另一个排序规则。
version 3.4 中的新内容。

行为

在分片 cluster中,不同命令可以_ret 孤儿文件。

Array Fields

如果指定的field的 value 是 array,则db.collection.distinct()将 array 的每个元素视为单独的 value。

例如,如果某个字段的 value 为[ 1, [1], 1 ],则db.collection.distinct()将1[1]1视为单独的值。

对于 example,请参阅返回 Array 字段的不同值。

索引使用

如果可能,db.collection.distinct()操作可以使用索引。

索引也可以覆盖 db.collection.distinct()操作。有关索引涵盖的查询的详细信息,请参阅涵盖查询。

例子

这些示例使用包含以下文档的inventory集合:

{ "_id": 1, "dept": "A", "item": { "sku": "111", "color": "red" }, "sizes": [ "S", "M" ] }
{ "_id": 2, "dept": "A", "item": { "sku": "111", "color": "blue" }, "sizes": [ "M", "L" ] }
{ "_id": 3, "dept": "B", "item": { "sku": "222", "color": "blue" }, "sizes": "S" }
{ "_id": 4, "dept": "A", "item": { "sku": "333", "color": "black" }, "sizes": [ "S" ] }

返回字段的不同值

以下 example 从inventory集合中的所有文档返回字段dept的不同值:

db.inventory.distinct( "dept" )

该方法返回以下 array 不同的dept值:

[ "A", "B" ]

返回嵌入字段的不同值

以下 example 从inventory集合中的所有文档返回嵌入在item字段中的字段sku的不同值:

db.inventory.distinct( "item.sku" )

该方法返回以下 array 不同的sku值:

[ "111", "222", "333" ]

也可以看看
点符号有关访问嵌入文档中的字段的信息

返回 Array 字段的不同值

以下 example 从inventory集合中的所有文档返回字段sizes的不同值:

db.inventory.distinct( "sizes" )

该方法返回以下 array 不同的sizes值:

[ "M", "S", "L" ]

有关distinct()和 array 字段的信息,请参阅行为部分。

使用 distinct 指定 Query

以下 example 从dept等于"A"的文档中返回嵌入在item字段中的字段sku的不同值:

db.inventory.distinct( "item.sku", { dept: "A" } )

该方法返回以下 array 不同的sku值:

[ "111", "333" ]

指定排序规则

version 3.4 中的新内容。

整理允许用户为 string 比较指定 language-specific 规则,例如字母和重音标记的规则。

集合myColl具有以下文档:

{ _id: 1, category: "café", status: "A" }
{ _id: 2, category: "cafe", status: "a" }
{ _id: 3, category: "cafE", status: "a" }

以下聚合操作包括整理选项:

db.myColl.distinct( "category", {}, { collation: { locale: "fr", strength: 1 } } )

有关归类字段的说明,请参阅整理文件。