$filter（聚合）

在此页面上

定义

兼容性
语法
行为
例子

MongoDB5.0 已于 10 月2024 结束生命周期。不再支持此版本的文档。要升级5.0 部署，请参阅 MongoDB6 。0 升级程序。

定义

$filter: 版本 3.2 中的新增功能。
根据指定条件选择要返回的数组的子集。返回一个数组，其中仅包含与条件匹配的元素。返回的元素按原始顺序排列。

兼容性

可以使用 $filter 查找托管在以下环境中的部署：

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

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

$filter 通过以下语法实现：

{
    $filter:
      {
         input: <array>,
         cond: <expression>,
         as: <string>,
         limit: <number expression>
      }
}

字段	规范
`input`	解析为数组的表达式。如果 `input` 解析为 `null` 或指向缺失的字段，则 `$filter` 返回 `null`。如果 `input` 解析为非数组、非 null 值，则管道将出错。
`cond`	可解析为布尔值的表达式，它可用于确定输出数组中是否应包含某一元素。该表达式使用 `as` 中指定的变量名称来单独引用 `input` 数组的每个元素。
`as`	可选。代表 `input` 数组中每个元素的变量名称。如果未指定名称，则变量名称默认为`this`。
`limit`	可选。一个数字表达式，用于限制`$filter` 返回的匹配大量元素的数量。您指定的限制不能小于`1` 。匹配的大量元素按照它们在输入大量中出现的顺序返回。如果指定的`limit` 大于匹配大量元素的数量，`$filter` 将返回所有匹配的大量元素。如果限值为`null` ，`$filter` 将返回所有匹配的大量元素。

有关表达式的更多信息，请参阅表达式。

行为

例子

结果

{
  $filter: {
     input: [ 1, "a", 2, null, 3.1, NumberLong(4), "5" ],
     as: "num",
     cond: { $and: [
        { $gte: [ "$$num", NumberLong("-9223372036854775807") ] },
        { $lte: [ "$$num", NumberLong("9223372036854775807") ] }
      ] }
  }
}

[ 1, 2, 3.1, NumberLong(4) ]

例子

集合 sales 包含以下文档：

{
   _id: 0,
   items: [
     { item_id: 43, quantity: 2, price: 10 },
     { item_id: 2, quantity: 1, price: 240 }
   ]
}
{
   _id: 1,
   items: [
     { item_id: 23, quantity: 3, price: 110 },
     { item_id: 103, quantity: 4, price: 5 },
     { item_id: 38, quantity: 1, price: 300 }
   ]
}
{
    _id: 2,
    items: [
       { item_id: 4, quantity: 1, price: 23 }
    ]
}

以下示例将筛选 items 数组，从而使其仅包含 price 大于或等于 100 的文档：

db.sales.aggregate([
   {
      $project: {
         items: {
            $filter: {
               input: "$items",
               as: "item",
               cond: { $gte: [ "$$item.price", 100 ] }
            }
         }
      }
   }
])

操作结果如下：

{
   "_id" : 0,
   "items" : [
      { "item_id" : 2, "quantity" : 1, "price" : 240 }
   ]
}
{
   "_id" : 1,
   "items" : [
      { "item_id" : 23, "quantity" : 3, "price" : 110 },
      { "item_id" : 38, "quantity" : 1, "price" : 300 }
   ]
}
{ "_id" : 2, "items" : [ ] }

后退

$expMovingAvg

来年

$first