$ elemMatch（投影）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 查询和投影运算符 > 投影算子 > $ elemMatch（投影）

也可以看看

$ elemMatch（查询）

在本页面

定义
使用注意事项
例子

定义¶

$elemMatch¶: 所述$elemMatch操作者的限制的内容 <array>从查询结果字段只包含第一匹配元件$elemMatch的条件。

使用注意事项¶

无论是$操作者和$elemMatch操作者投射第一从基于条件的阵列匹配元件。

该$操作项目根据从查询语句中的一些条件集合中的每个文件的第一个匹配的数组元素。

该$elemMatch投影算需要一个明确的条件的说法。这使您可以基于查询中没有的条件进行投影，或者如果您需要基于阵列的嵌入式文档中的多个字段进行投影。有关示例，请参见数组字段限制。

db.collection.find()在操作的观点不支持$elemMatch投影操作。

您不能在中指定$text查询表达式 $elemMatch。

例子¶

$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投影仅返回第一所述的匹配元件students ，其中阵列school字段具有值102：

复制

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

该操作返回以下文档，这些文档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投影可以指定多个字段的标准：

以下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) 算子

MongoDB 中文手册

$ elemMatch（投影）

定义¶

使用注意事项¶

例子¶

邮政编码搜索¶

$elemMatch有多个字段¶

`$elemMatch`有多个字段¶