Retrieve Distinct Values
Overview
使用 distinct()方法检索集合中指定字段的所有不同值。
示例文档
要按照本指南中的示例进行操作，请使用以下代码片段将描述餐厅的文档插入到myDB.restaurantscollection中：
const myDB = client.db("myDB"); const myColl = myDB.collection("restaurants"); await myColl.insertMany([ { "_id": 1, "restaurant": "White Bear", "borough": "Queens", "cuisine": "Chinese" }, { "_id": 2, "restaurant": "Via Carota", "borough": "Manhattan", "cuisine": "Italian" }, { "_id": 3, "restaurant": "Borgatti's", "borough": "Bronx", "cuisine": "Italian" }, { "_id": 4, "restaurant": "Tanoreen", "borough": "Brooklyn", "cuisine": "Middle Eastern" }, { "_id": 5, "restaurant": "Äpfel", "borough": "Queens", "cuisine": "German" }, { "_id": 6, "restaurant": "Samba Kitchen", "borough": "Manhattan", "cuisine": "Brazilian" }, ]);
注意
您的查询操作可能会返回对包含匹配文档的游标的引用。 要学习；了解如何检查存储在游标中的数据，请参阅游标基础知识页面。
distinct
distinct()方法需要一个文档字段作为参数。 您可以指定以下可选参数来调整方法输出：
用于优化结果的
query参数用于设置排序规则的
options参数
文档字段参数
传递文档字段的名称以返回该字段的唯一值的列表。
例子
“ Queens ”和“ Manhattan ”行政区值在样本文档中均出现多次。 但是，以下示例将检索borough字段的唯一值：
// specify "borough" as the field to return values for const cursor = myColl.distinct("borough"); for await (const doc of cursor) { console.dir(doc); }
此代码输出以下borough值：
[ "Bronx", "Brooklyn", "Manhattan", "Queens" ]
查询参数
您可以指定查询参数，为与查询匹配的文档返回唯一值。
有关构建查询过滤器的更多信息，请访问指定一个查询。
例子
以下示例输出cuisine字段的不同值，但不包括“ Brooklyn ”中的餐馆：
// exclude Brooklyn restaurants from the output const query = { borough: { $ne: "Brooklyn" }}; // find the filtered distinct values of "cuisine" const cursor = myColl.distinct("cuisine", query); for await (const doc of cursor) { console.dir(doc); }
在这种情况下，查询筛选器匹配除“ Brooklyn ”之外的每个行政区值。 这会防止distinct()输出一个cuisine值“ Middle Eastern ”。 该代码输出以下值：
[ "Brazilian", "Chinese", "German", "Italian" ]
选项参数
您可以通过将collation字段定义为options参数来指定distinct()方法的排序规则。 此字段允许您设置字符串排序和比较的区域规则。
有关应用排序规则的说明，请参阅排序规则。
注意
使用options参数时，您还必须指定query参数。 如果不想使用查询筛选器，请将查询定义为{} 。
例子
以下示例使用collation字段在输出不同的restaurant值时指定德语排序约定：
// define an empty query document const query = {}; // specify German string ordering conventions const options = { collation: { locale: "de" }}; const cursor = myColl.distinct("restaurant", query, options); for await (const doc of cursor) { console.dir(doc); }
在这种情况下，德语字符串排序约定会将以“?”开头的单词放在以“B”开头的单词之前。 该代码输出以下内容：
[ "Äpfel", "Borgatti's", "Samba Kitchen", "Tanoreen", "Via Carota", "White Bear" ]
Without specifying a collation field, the output order would follow default binary collation rules. 这些规则将以 "?" 开头的单词放在首字母不带重音的单词之后：
[ "Borgatti's", "Samba Kitchen", "Tanoreen", "Via Carota", "White Bear", "Äpfel" ]
更多信息
有关检索非重复值的可运行示例，请参阅检索字段的非重复值。
API 文档
如要进一步了解 distinct() 方法及其参数，您可以访问 API 文档。