/ /

$firstN（累加器运算符）

定义

$firstN

返回群组内前 n 个元素的聚合。结果仅在分组阶段的输入数据具有定义的排序顺序时才有意义。如果该组包含的元素少于 n 个，$firstN 返回该组中的所有元素。

$firstN 累加器可在以下阶段使用：

注意

消歧

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

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

$firstN (expression), 从数组开头返回指定数量的元素。
$firstN (window function)，用于在 $setWindowFields 阶段中，从特定窗口的文档中返回前 n 个值。

语法

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

选项

字段	类型	说明
`input`	表达式(expression)	`input` 表达式将对输入组中的每个文档进行计算，并且前 `n` 个结果将得以保留。
`n`	表达式(expression)	The number of elements that `$firstN` returns from the group. For an example of setting `n` dynamically based on the group key, see Set n Based on the Group Key.

行为

Null 和缺失值

$firstN 不筛选空值。
$firstN 将缺失值转换为空。

比较 $firstN 和 $topN

$firstN和$topN累加器都可以实现类似的结果。

一般来说：

如果进入$group的文档已经排序，则应使用$firstN 。
如果您要排序并选择顶部的 n 元素，则可以使用 $topN 通过一个累加器完成这两项任务。

示例

The examples on this page use the movies collection in the sample_mflix sample dataset. To learn how to load the sample dataset into your MongoDB deployment, see Import Sample Data Into Your Atlas Deployment.

查找针对单一类型的前三部电影

可以使用 $firstN 累加器查找单一类型中的前三部电影。

db.movies.aggregate( [
   {
      $match: { genres: "Horror" }
   },
   {    
      $sort: { year: 1 }
   },
   {
      $group:
         {
            _id: "Horror",
            firstThreeMovies:
               {
                  $firstN:
                  {
                     input: [ "$title", "$year" ],
                     n: 3
                  }
               }
         }
   }
] )

[
  {
    _id: 'Horror',
    firstThreeMovies: [
      [ 'Dr. Jekyll and Mr. Hyde', 1931 ],
      [ 'Dracula', 1931 ],
      [ 'The Black Cat', 1934 ]
    ]
  }
]

前面的管道：

使用 $match 过滤器结果，以查找 Horror 包含在 genres 数组中的电影。
按 year 升序对结果进行排序。
将所有结果文档分组为单一组。
指定使用input : ["$title", "$year"]为$firstN输入的字段。
使用 $firstN 返回具有 n: 3 的 Horror 类型的前三个文档。

查找多个类型中的前三部电影

可以使用 $firstN 累加器查找每个类型中的前 n 个输入字段。

db.movies.aggregate( [
   {
      $unwind: "$genres"
   },
   {
      $sort: { year: 1 }
   },
   {
      $group:
         {
            _id: "$genres",
            movies:
               {
                  $firstN:
                     {
                        input: [ "$title", "$year" ],
                        n: 3
                     }
               }
         }
   },
   { $sort: { _id: 1 } },
   { $limit: 5 }
] )

[
  {
    _id: 'Action',
    movies: [
      [ 'The Perils of Pauline', 1914 ],
      [ 'From Hand to Mouth', 1919 ],
      [ "For Heaven's Sake", 1926 ]
    ]
  },
  {
    _id: 'Adventure',
    movies: [
      [ 'Robin Hood', 1922 ],
      [ 'Peter Pan', 1924 ],
      [ 'The Thief of Bagdad', 1924 ]
    ]
  },
  {
    _id: 'Animation',
    movies: [
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [ 'Gertie the Dinosaur', 1914 ]
    ]
  },
  {
    _id: 'Biography',
    movies: [ [ 'Regeneration', 1915 ], [ 'Salomè', 1922 ], [ 'Napoleon', 1927 ] ]
  },
  {
    _id: 'Comedy',
    movies: [
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [ 'Gertie the Dinosaur', 1914 ]
    ]
  }
]

前面的管道：

使用 $unwind 在 genres 数组中针对每个流派创建单独的文档。
按 year 升序对结果进行排序。
使用 $group 按 genres 对结果进行分组。
使用 $firstN 返回每个具有 n: 3 的类型的前三个文档。
指定使用input : ["$title", "$year"]为$firstN输入的字段。
将输出限制为五份文档，以提高可读性。

根据群组密钥设置 n

您可以根据组密钥动态地赋值 n 的值。在此示例中，$cond 表达式使用 rated 字段更改 n 的值：

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

[
  { _id: { rated: 'PG-13' }, movies: [ "'night, Mother" ] },
  {
    _id: { rated: 'PG' },
    movies: [ '*batteries not included', '...And God Created Woman', '1776' ]
  },
  { _id: { rated: 'G' }, movies: [ '101 Dalmatians' ] },
  { _id: { rated: 'R' }, movies: [ '$' ] }
]

前面的管道：

过滤器，用于显示评分为 G、PG、PG-13 或 R 的电影。
对结果按 title 进行字母顺序排序。
按 rated (电影评级) 对电影进行分组。
使用 $cond 表达式，对于 PG 级别的电影，返回 3 部电影；对于所有其他级别，返回 1 部电影。

在输出中，PG 评级返回 3 部电影，而 G、PG-13 和 R 评级则各自返回 1 部电影。

了解详情