$ elemMatch（查询）_MonogDB 中文网

MongoDB 中文手册

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

在本页面

定义
行为
例子
其他例子

也可以看看

$ elemMatch（投影）

定义¶

$elemMatch¶

所述$elemMatch操作者匹配包含与匹配的所有指定的查询标准中的至少一个元素的数组字段的文档。

复制

{ <field>: { $elemMatch: { <query1>, <query2>, ... } } }

如果仅<query>在$elemMatch表达式中指定一个条件，则无需使用 $elemMatch。

行为¶

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

例子¶

匹配元素¶

给定scores集合中的以下文件：

复制

{ _id: 1, results: [ 82, 85, 88 ] }
{ _id: 2, results: [ 75, 88, 89 ] }

以下查询仅匹配results 数组包含至少一个大于或等于80且小于的元素的那些文档85。

复制

db.scores.find(
   { results: { $elemMatch: { $gte: 80, $lt: 85 } } }
)

该查询返回以下文档，因为该元素82大于或等于80且小于85

复制

{ "_id" : 1, "results" : [ 82, 85, 88 ] }

有关在数组元素上指定多个条件的更多信息，请参见为数组元素指定多个条件。

嵌入式文档数组¶

给定survey集合中的以下文件：

复制

{ _id: 1, results: [ { product: "abc", score: 10 }, { product: "xyz", score: 5 } ] }
{ _id: 2, results: [ { product: "abc", score: 8 }, { product: "xyz", score: 7 } ] }
{ _id: 3, results: [ { product: "abc", score: 7 }, { product: "xyz", score: 8 } ] }

下面的查询仅那些文档，其中匹配results 数组包含与两个的至少一种元素product等于 "xyz"和score大于或等于8。

复制

db.survey.find(
   { results: { $elemMatch: { product: "xyz", score: { $gte: 8 } } } }
)

具体来说，查询与以下文档匹配：

复制

{ "_id" : 3, "results" : [ { "product" : "abc", "score" : 7 }, { "product" : "xyz", "score" : 8 } ] }

单查询条件¶

如果在$elemMatch 表达式中指定单个查询谓词，$elemMatch则没有必要。

例如，考虑以下示例，其中$elemMatch 仅指定一个查询谓词：{ product: "xyz" }

复制

db.survey.find(
   { results: { $elemMatch: { product: "xyz" } } }
)

由于$elemMatch仅指定一个条件，因此该 $elemMatch表达式不是必需的，而是可以使用以下查询：

复制

db.survey.find(
   { "results.product": "xyz" }
)

其他例子¶

有关查询数组的其他示例，请参见：

有关查询的其他示例，请参见：

查询文件

也可以看看

db.collection.find()