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 查询表达式。

示例

$elemMatch 投影运算符的示例使用一个包含以下文档的集合 schools：

{
 _id: 1,
 zipcode: "63109",
 students: [
              { name: "john", school: 102, age: 10 },
              { name: "jess", school: 102, age: 11 },
              { name: "jeff", school: 108, age: 15 }
           ]
}
{
 _id: 2,
 zipcode: "63110",
 students: [
              { name: "ajax", school: 100, age: 7 },
              { name: "achilles", school: 100, age: 8 },
           ]
}
{
 _id: 3,
 zipcode: "63109",
 students: [
              { name: "ajax", school: 100, age: 7 },
              { name: "achilles", school: 100, age: 8 },
           ]
}
{
 _id: 4,
 zipcode: "63109",
 students: [
              { name: "barney", school: 102, age: 7 },
              { name: "ruth", school: 102, age: 16 },
           ]
}

邮政编码搜索

如下 find() 操作将查询 zipcode 字段值为 63109 的所有文档。$elemMatch 投影仅返回 school 字段的值为 102 的 students 数组中的第一个匹配元素：

db.schools.find( { zipcode: "63109" },
                 { students: { $elemMatch: { school: 102 } } } )

此操作将返回 zipcode 等于 63109 的以下文档，并使用 $elemMatch 投影 students 数组：

{ "_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 投影可指定针对多个字段的条件：

如下 find() 操作将查询 zipcode 字段值为 63109 的所有文档。投影包括 students 数组的第一个匹配元素，其中 school 字段的值为 102，并且 age 字段大于 10：

db.schools.find( { zipcode: "63109" },
                 { students: { $elemMatch: { school: 102, age: { $gt: 10} } } } )

此操作将返回 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 条件相匹配。

提示

$ (projection) 运算符

后退

来年

$slice

提示

定义

使用注意事项

返回的元素

字段排序

限制

示例

邮政编码搜索

$elemMatch （针对多个字段）

提示

`$elemMatch` （针对多个字段）