$elemMatch（投影操作符）

返回的元素

$ 操作符和 $elemMatch 操作符都会根据条件从数组中投射第一个匹配元素。

$ 操作符根据查询语句中的某些条件投影一个集合中的每个文档的第一个匹配数组元素。

$elemMatch 投影运算符接受显式条件参数。这允许您根据不在查询中的条件进行投影，或者如果您需要根据数组的嵌入式文档中的多个字段进行投影。有关示例，请参阅数组字段限制。

字段排序

无论文档中的字段顺序如何，现有字段的 $elemMatch 投影都会在包含其他现有字段之后返回此字段。

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

db.players.insertOne( {
   name: "player1",
   games: [ { game: "abc", score: 8 }, { game: "xyz", score: 5 } ],
   joined: new Date("2020-01-01"),
   lastLogin: new Date("2020-05-01")
} )

以下投影会在投影中包含的其他现有字段之后返回 games 字段，即使在文档中，该字段位于 joined 和 lastLogin 字段之前：

db.players.find( {}, { games: { $elemMatch: { score: { $gt: 5 } } }, joined: 1, lastLogin: 1 } )

换言之，该操作会返回以下文档：

{
   "_id" : ObjectId("5edef64a1c099fff6b033977"),
   "joined" : ISODate("2020-01-01T00:00:00Z"),
   "lastLogin" : ISODate("2020-05-01T00:00:00Z"),
   "games" : [ { "game" : "abc", "score" : 8 } ]
}

限制

• 针对视图的 db.collection.find() 操作不支持 $elemMatch 投影运算符。

• 无法在 $elemMatch 中指定 $text 查询运算符。

邮政编码搜索

该操作返回以下 zipcode 值为 "63109" 的文档，并使用 $elemMatch 投影 students大量：该操作返回以下 zipcode 值为 "63109" 的文档，并投影 students大量，使用 $elemMatch：

[
  { "_id": 1, "students": [ { "name": "john", "school": 102, "age": 10 } ] },
  { "_id": 3 },
  { "_id": 4, "students": [ { "name": "barney", "school": 102, "age": 7 } ] }
]

• 对于 _id 等于 1 的文档，students 数组包含多个 school 字段等于 102 的元素。但是，$elemMatch 投影只会返回数组中第一个匹配的元素。

• _id 等于 3 的文档在结果中不包含 students 字段，因为其 students 数组中没有与 $elemMatch 条件匹配的元素。

$elemMatch （针对多个字段）

$elemMatch 投影可针对多个字段指定条件。

该操作返回 zipcode 值为 "63109" 的三个文档： 该操作返回 zipcode 值为 "63109" 的三个文档：

[
  { "_id": 1, "students": [ { "name": "jess", "school": 102, "age": 11 } ] },
  { "_id": 3 },
  { "_id": 4, "students": [ { "name": "ruth", "school": 102, "age": 16 } ] }
]

_id 等于 3 的文档不包含 students 字段，因为没有任何数组元素与 $elemMatch 条件相匹配。

$elemMatch的参数与$elemMatch所投影的大量元素相匹配。 如果将字段名称指定为$elemMatch的等式，则会尝试匹配大量中的对象。 示例， $elemMatch尝试为投影中的以下内容匹配大量中的对象而不是标量值：

前面的示例返回 zipcode 值为 "63109" 的文档，但这些文档仅包含 _id字段，因为投影操作未找到匹配元素。

该操作返回 zipcode 值为 "63109" 的三个文档。返回的文档包括 _id字段和 athletics大量的匹配元素（如果有）。该操作返回 zipcode 值为 "63109" 的三个文档。返回的文档包括 _id字段和 athletics大量的匹配元素（如果有）。

[
  { "_id": 1 },
  { "_id": 3, "athletics": [ "basketball" ] },
  { "_id": 4 }
]

_id等于3的文档是唯一符合$elemMatch条件的文档。