$all

本页内容

兼容性

语法
行为
示例
附加示例

$all: 操作符$all操作符选择字段值是一个包含所有指定元素的数组的文档。

兼容性

您可以在以下环境中使用$all

MongoDB Atlas：云中MongoDB部署的全托管服务

MongoDB企业版：基于订阅的自托管MongoDB版本
MongoDB社区版：源代码可用、免费使用和自托管的MongoDB版本

语法

要指定一个 $all 表达式，请使用以下原型

{ <field>: { $all: [ <value1> , <value2> ... ] } }

行为

相当于 `$and` 操作

$all 与指定的值相当于一个 $and 操作；即以下语句

{ tags: { $all: [ "ssl" , "security" ] } }

相当于

{ $and: [ { tags: "ssl" }, { tags: "security" } ] }

嵌套数组

当传入一个嵌套数组的数组（例如 [ [ "A" ] ]）时，$all 匹配包含嵌套数组作为元素的文档的字段（例如 field: [ [ "A" ], ... ]），或者字段等于嵌套数组（例如 field: [ "A" ]）。

例如，考虑以下查询 [1]

db.articles.find( { tags: { $all: [ [ "ssl", "security" ] ] } } )

查询相当于

db.articles.find( { $and: [ { tags: [ "ssl", "security" ] } ] } )

这相当于

db.articles.find( { tags: [ "ssl", "security" ] } )

因此，$all 表达式匹配包含 tags 字段是包含嵌套数组 [ "ssl", "security" ] 的数组或等于该嵌套数组的文档

tags: [ [ "ssl", "security" ], ... ]
tags: [ "ssl", "security" ]

[1]	仅含有一个元素的 `$all` 表达式仅用于说明，因为如果只需匹配单个元素，则 `$all` 表达式是不必要的。相反，当匹配单个元素时，使用“包含”表达式（即 `arrayField: element`）更为合适。

示例

以下示例使用包含以下文档的 inventory 集合：

{
   _id: ObjectId("5234cc89687ea597eabee675"),
   code: "xyz",
   tags: [ "school", "book", "bag", "headphone", "appliance" ],
   qty: [
          { size: "S", num: 10, color: "blue" },
          { size: "M", num: 45, color: "blue" },
          { size: "L", num: 100, color: "green" }
        ]
}
{
   _id: ObjectId("5234cc8a687ea597eabee676"),
   code: "abc",
   tags: [ "appliance", "school", "book" ],
   qty: [
          { size: "6", num: 100, color: "green" },
          { size: "6", num: 50, color: "blue" },
          { size: "8", num: 100, color: "brown" }
        ]
}
{
   _id: ObjectId("5234ccb7687ea597eabee677"),
   code: "efg",
   tags: [ "school", "book" ],
   qty: [
          { size: "S", num: 10, color: "blue" },
          { size: "M", num: 100, color: "blue" },
          { size: "L", num: 100, color: "green" }
        ]
}
{
   _id: ObjectId("52350353b2eff1353b349de9"),
   code: "ijk",
   tags: [ "electronics", "school" ],
   qty: [
          { size: "M", num: 100, color: "green" }
        ]
}

使用 `$all` 匹配值

以下操作使用 $all 操作符查询 inventory 集合，查找 tags 字段的值为包含 appliance、school 和 book 元素的数组。

db.inventory.find( { tags: { $all: [ "appliance", "school", "book" ] } } )

上述查询返回以下文档

{
   _id: ObjectId("5234cc89687ea597eabee675"),
   code: "xyz",
   tags: [ "school", "book", "bag", "headphone", "appliance" ],
   qty: [
          { size: "S", num: 10, color: "blue" },
          { size: "M", num: 45, color: "blue" },
          { size: "L", num: 100, color: "green" }
        ]
}
{
   _id: ObjectId("5234cc8a687ea597eabee676"),
   code: "abc",
   tags: [ "appliance", "school", "book" ],
   qty: [
          { size: "6", num: 100, color: "green" },
          { size: "6", num: 50, color: "blue" },
          { size: "8", num: 100, color: "brown" }
        ]
}

使用 `$all` 与 `$elemMatch`

如果字段包含文档数组，可以使用 $all 与 $elemMatch 操作符。

以下操作查询inventory集合中的文档，其中qty字段的值是一个数组，其元素与$elemMatch标准匹配

db.inventory.find( {
                     qty: { $all: [
                                    { "$elemMatch" : { size: "M", num: { $gt: 50} } },
                                    { "$elemMatch" : { num : 100, color: "green" } }
                                  ] }
                   } )

查询返回以下文档

{
   "_id" : ObjectId("5234ccb7687ea597eabee677"),
   "code" : "efg",
   "tags" : [ "school", "book"],
   "qty" : [
             { "size" : "S", "num" : 10, "color" : "blue" },
             { "size" : "M", "num" : 100, "color" : "blue" },
             { "size" : "L", "num" : 100, "color" : "green" }
           ]
}
{
   "_id" : ObjectId("52350353b2eff1353b349de9"),
   "code" : "ijk",
   "tags" : [ "electronics", "school" ],
   "qty" : [
             { "size" : "M", "num" : 100, "color" : "green" }
           ]
}

存在$all操作符以支持数组查询。但您可以使用$all操作符来选择非数组字段，如下例所示

db.inventory.find( { "qty.num": { $all: [ 50 ] } } )

然而，使用以下形式来表达相同的查询

db.inventory.find( { "qty.num" : 50 } )

这两个查询都将选择所有inventory集合中num字段的值为50的文档。

注意

在大多数情况下，MongoDB不会将数组视为集合。此操作符为此方法提供了一个显著的例外。

其他示例

有关查询数组的更多示例，请参阅

有关查询的更多示例，请参阅查询文档。

提示

另请参阅

db.collection.find()

数组查询

下一步

$elemMatch

兼容性

语法

行为

相当于 $and 操作