/ /

$maxN（窗口函数）

定义

$maxN

返回一个大量，其中包含窗口内最多 n 个元素。

注意

$maxN 的其他用途

本页介绍了用作窗口函数的 $maxN。

您还可以在其他上下文中使用 $maxN：

$maxN (accumulator)，返回群组内的 n 最大值。
$maxN (expression)，返回大量中最大的 n 值。

语法

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $maxN: {
               input: <expression>,
               n: <expression>
            },
            window: {
               documents: [ <lower boundary>, <upper boundary> ]
            }
         }
      }
   }
}

选项

字段	类型	说明
`input`	表达式(expression)	表达式对窗口中的每个文档进行计算。 `$maxN` 会返回 `n` 的最大值。
`n`	表达式(expression)	`$maxN` 从窗口返回的元素数量。必须解析为正整数。如果窗口包含的元素少于 `n` 个，`$maxN` 将返回窗口中的所有元素。

行为

Null 和缺失值

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

例子

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

此示例使用 $setWindowFields 中的 $maxN 返回每年评分最高的三部电影。该窗口跨越整个分区，因此同一年的每个文档都会收到相同的 topThreeRatedInYear 值。

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1999, 2001 ] },
         "imdb.rating": { $gte: 8.5 }
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         sortBy: { "imdb.rating": -1 },
         output: {
            topThreeRatedInYear: {
               $maxN: {
                  input: [ "$imdb.rating", "$title" ],
                  n: 3
               },
               window: {
                  documents: [ "unbounded", "unbounded" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         "imdb.rating": 1,
         topThreeRatedInYear: 1
      }
   },
   {
      $sort: { year: 1, "imdb.rating": -1 }
   }
] )

[
  {
    imdb: { rating: 8.9 },
    year: 1999,
    title: 'Fight Club',
    topThreeRatedInYear: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    imdb: { rating: 8.7 },
    year: 1999,
    title: 'The Matrix',
    topThreeRatedInYear: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    title: 'Eddie Izzard: Dress to Kill',
    year: 1999,
    imdb: { rating: 8.7 },
    topThreeRatedInYear: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    imdb: { rating: 8.5 },
    year: 1999,
    title: 'The Green Mile',
    topThreeRatedInYear: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    title: 'Band of Brothers',
    year: 2001,
    imdb: { rating: 9.6 },
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  },
  {
    title: 'The Blue Planet',
    year: 2001,
    imdb: { rating: 9.2 },
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  },
  {
    imdb: { rating: 8.8 },
    year: 2001,
    title: 'The Lord of the Rings: The Fellowship of the Ring',
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  },
  {
    imdb: { rating: 8.6 },
    year: 2001,
    title: 'Spirited Away',
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  },
  {
    title: 'Promises',
    year: 2001,
    imdb: { rating: 8.5 },
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  }
]

上述管道：

使用 $match过滤在 1999 或 2001 上映且 IMDb 评级为 8.5 或更高的电影。
使用 $setWindowFields 按 year 对电影进行分区，并按 imdb.rating 降序对它们进行排序。该阶段使用 $maxN 和 n: 3 从跨越整个分区 (documents: ["unbounded", "unbounded"]) 的窗口创建 topThreeRatedInYear。
使用 $project 可仅在输出中包含 title、year、imdb.rating 和 topThreeRatedInYear 字段。
使用 $sort 按年份升序和评级降序对结果进行排序。

了解详情

聚合管道限制