/ /

$minN（聚合累加器）

定义

$minN

返回群组内的最小 n 个值。如果该组包含的元素少于 n 个，$minN 返回该组中的所有元素。

注意

消歧

本页介绍了 $minN 用作 累加器 时的情况。累加器对一组输入文档返回聚合值，如总和、最大值或最小值。

您还可以在这些其他上下文中使用 $minN：

$minN (expression)，返回数组中的 n 个最小值。
$minN (window function)，用于 $setWindowFields 阶段以从特定窗口中的文档返回最小 n 值。

语法

{
   $minN:
      {
         input: <expression>,
         n: <expression>
      }
}

字段	类型	说明
`input`	表达式(expression)	对每个输入文档进行评估的表达式，以确定输入值。每组保留最小的 `n` 个值。
`n`	表达式(expression)	确定每组返回的最大结果数。`n` 必须求值为正数。

行为

结果类型

$minN 比较不同类型的值时，类型的顺序遵循 BSON 比较顺序。

Null 和缺失值

$minN 过滤掉空值和缺失值。

考虑以下聚合，返回组中的最小 n 值：

db.aggregate( [
   {
      $documents: [
         { playerId: "PlayerA", gameId: "G1", score: 1 },
         { playerId: "PlayerB", gameId: "G1", score: 2 },
         { playerId: "PlayerC", gameId: "G1", score: 3 },
         { playerId: "PlayerD", gameId: "G1" },
         { playerId: "PlayerE", gameId: "G1", score: null }
      ]
   },
   {
      $group:
      {
         _id: "$gameId",
         minimumThreeScores:
            {
               $minN:
                  {
                     input: "$score",
                     n: 4
                  }
            }
      }
   }
] )

在本例中：

$documents 创建包含玩家分数的字面文档。
$group 按 gameId 对文档进行分组。此示例只有一个 gameId、G1。
PlayerD 分数缺失，且PlayerE的score为空。这些值都被忽略。
minimumThreeScores 字段指定为具有 input : "$score" 特征的 $minN，并以数组形式返回。
由于只有 3 个文档具有 scores，$minN 返回最少 3 个 score 字段，即使 n = 4。

[
   {
   _id: 'G1',
   minimumThreeScores: [ 1, 2, 3 ]
   }
]

$minN 和 $bottomN 累加器的比较

$minN 和 $bottomN 累加器都会从组中返回 n 值，但它们的区别在于如何确定返回哪些值。

当您要比较的值与您要返回的值相同时，使用 $minN。$minN 通过直接比较输入来选取最小的 n 个值。
当您想将排序顺序与输出分开定义时，请使用 $bottomN。$bottomN 允许您指定 sortBy 密钥，以确定哪些文档是 "bottom"，并指定 output 表达式以控制返回的值。

示例

本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息，请参阅加载示例数据集。如果您对示例数据库进行了任何修改，您可能需要删除并重新创建数据库，才能运行此页面上的示例。

找到单个类型的最少三个评级

可以使用 $minN 累加器查找单个类型中的前三个最低 IMDb 评分。

db.movies.aggregate( [
   {
      $match: { genres: "Horror" }
   },
   {
      $group:
         {
            _id: "Horror",
            minThreeRatings:
               {
                  $minN:
                  {
                     input: "$imdb.rating",
                     n: 3
                  }
               }
         }
   }
] )

[ { _id: 'Horror', minThreeRatings: [ 2, 2, 2.2 ] } ]

示例管道：

使用 $match 过滤器结果，以查找 Horror 包含在 genres 数组中的电影。
使用 $group 将所有匹配的文档分组到单个组中。
指定 $minN 的输入，使用 input: "$imdb.rating"。
使用 $minN 返回针对 Horror 类型并且包含 n: 3 的三个 IMDb 评分最低的条目。

查找多个类别中的最低三个评分

您可以使用 $minN 累加器查找每个类型中的最低 n 个 IMDb 评分。

db.movies.aggregate( [
   {
      $unwind: "$genres"
   },
   {
      $group:
         {
            _id: "$genres",
            minThreeRatings:
               {
                  $minN:
                     {
                        input: "$imdb.rating",
                        n: 3
                     }
               }
         }
   },
   { $sort: { _id: 1 } },
   { $limit: 5 }
] )

[
  { _id: 'Action', minThreeRatings: [ 2, 2, 2.1 ] },
  { _id: 'Adventure', minThreeRatings: [ 2.1, 2.3, 2.4 ] },
  { _id: 'Animation', minThreeRatings: [ 2.7, 4, 4.1 ] },
  { _id: 'Biography', minThreeRatings: [ 2.3, 2.7, 3.5 ] },
  { _id: 'Comedy', minThreeRatings: [ 1.6, 1.9, 1.9 ] }
]

示例管道：

使用 $unwind 在 genres 数组中针对每个流派创建单独的文档。
使用 $group 按 genres 对结果分组。
使用 $minN 返回每个类型的三个最低 IMDb 评分条目，并且包含 n: 3。
指定 $minN 的输入，使用 input: "$imdb.rating"。
使用 $sort 可按类型字母顺序对结果进行排序。
将输出限制为五份文档，以提高可读性。

基于分组键动态设置 n

您可以动态地赋值 n 的值。在此示例中，$cond 表达式用于 rated 字段。

db.movies.aggregate( [
   { $match: { rated: { $in: [ "G", "PG", "PG-13", "R" ] } } },
   {
      $group:
         {
            _id: { "rated": "$rated" },
            minMovies:
               {
                  $minN:
                     {
                        input: "$imdb.rating",
                        n: { $cond: { if: { $eq: [ "$rated", "R" ] }, then: 3, else: 1 } }
                     }
               }
         }
   }
] )

[
  { _id: { rated: 'PG' }, minMovies: [ 1.6 ] },
  { _id: { rated: 'G' }, minMovies: [ 1.6 ] },
  { _id: { rated: 'R' }, minMovies: [ 2, 2.2, 2.2 ] },
  { _id: { rated: 'PG-13' }, minMovies: [ 1.9 ] }
]

示例管道：

过滤器，用于显示评分为 G、PG、PG-13 或 R 的电影。
按照 rated (内容评级) 将电影分组。
指定 $minN 的输入，使用 input: "$imdb.rating"。
使用 $cond 表达式返回针对 R 评级的电影的 3 条最少记录，和针对所有其他评级的 1 条最少记录。

在输出中，R 评级返回 3 个条目，而 G、PG 和 PG-13 评级则各自返回 1 个条目。