distinct

数组字段

如果指定的 field 值是数组，则 distinct 将数组的每个元素视为一个单独的值。

例如，如果某一字段的值为 [ 1, [1], 1 ]，则 distinct 会将 1、[1] 和 1 视为不同的值。

有关示例，请参阅为数组字段返回不同值。

索引使用

在可能的情况下，distinct 操作可以使用索引。

索引还可以涵盖 distinct 操作。有关索引涵盖的查询的详细信息，请参阅涵盖的查询。

事务

如要在事务中执行不同的操作：

• 对于未分片的集合，可以使用 db.collection.distinct() 方法 / distinct 命令以及具有 $group 阶段的聚合管道。

• 对于分片集合，不能使用 db.collection.distinct() 方法或 distinct 命令。

  要找到分片集合的不同值，请改用带有 $group 阶段的聚合管道。有关详细信息，请参阅 去重操作。

客户端断开连接

从 MongoDB 4.2 开始，如果在操作完成之前，发出 distinct 的客户端断开连接，MongoDB 将使用killOp 将 distinct 标记为终止。

副本集节点状态限制

若要在副本集节点上运行，distinct 操作要求该节点处于 PRIMARY 或 SECONDARY 状态。如果该节点处于其他状态，如 STARTUP2，则操作错误。

返回字段的非重复值

以下示例将返回 inventory 集合的所有文档中字段 dept 的不同值：

db.runCommand ( { distinct: "inventory", key: "dept" } )

该命令返回一个文档，其中包含名为values的字段，其中包含不同的 dept 值：

{
   "values" : [ "A", "B" ],
   "ok" : 1
}

返回嵌入式字段的非重复值

以下示例针对 inventory 集合的所有文档，从中返回嵌入 item 字段中的字段 sku 的非重复值：

db.runCommand ( { distinct: "inventory", key: "item.sku" } )

该命令返回一个文档，其中包含名为values的字段，其中包含不同的 sku 值：

{
  "values" : [ "111", "222", "333" ],
  "ok" : 1
}

返回数组字段的非重复值

以下示例将返回 inventory 集合的所有文档中字段 sizes 的不同值：

db.runCommand ( { distinct: "inventory", key: "sizes" } )

该命令返回一个文档，其中包含名为values的字段，其中包含不同的 sizes 值：

{
  "values" : [ "M", "S", "L" ],
  "ok" : 1
}

有关 distinct 和数组字段的信息，请参阅行为一节。

使用以下项指定查询： distinct

对于 dept 等于 "A" 的文档，以下示例从中返回嵌入 item 字段中的字段 sku 的非重复值：

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

该命令返回一个文档，其中包含名为values的字段，其中包含不同的 sku 值：

{
  "values" : [ "111", "333" ],
  "ok" : 1
}

指定排序规则

排序规则允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。

集合 myColl 包含以下文档：

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

以下聚合操作包括排序规则选项：

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

有关排序规则字段的说明，请参阅排序规则文档。

覆盖默认读关注

若要覆盖 "local" 的默认读取关注级别，请使用 readConcern 选项。

对副本集执行以下操作可以指定读关注 "majority"，以读取确认已写入大多数节点的数据的最新副本。

db.runCommand(
   {
     distinct: "restaurants",
     key: "rating",
     query: { cuisine: "italian" },
     readConcern: { level: "majority" }
   }
)

为确保单个线程可以读取自己的写入内容，请对副本集的主节点使用 "majority" 读关注和 "majority" 写关注。