/ /

$firstN (表达式)

定义

$firstN

从大量开头返回指定数量的元素。

注意

消歧

本页介绍了用作表达式时的 $firstN，该表达式从大量的开头返回指定数量的元素。

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

$firstN (accumulator)，用于分组，返回每个群组的前 n 个元素。
$firstN (window function)，在 $setWindowFields 阶段用于返回特定窗口中文档的前 n 值。

语法

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

选项

字段	类型	说明
`input`	表达式(expression)	要返回前 `n` 个元素的大量。
`n`	表达式(expression)	`$firstN` 返回的元素数量。必须解析为正整数。

行为

$firstN 会按照它们在输入数组中出现的相同顺序返回元素。
$firstN 不会过滤掉输入大量中的 null 值。
不能指定小于 1 的 n 值。
如果指定的 n 大于或等于 input大量中的元素数量，$firstN 将返回整个 input大量。
如果 input 解析为非数组值，则聚合操作将出错。

例子

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

以下示例使用 $firstN操作符返回每部电影的前三名演员。转换成员将在 $addFields 创建的新字段firstThreeCast 中返回。

db.movies.aggregate( [
   {
      $match: {
         title: { $in: [ "The Godfather", "Spirited Away", "The Dark Knight" ] }
      }
   },
   {
      $addFields: {
         firstThreeCast: { $firstN: { input: "$cast", n: 3 } }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         cast: 1,
         firstThreeCast: 1
      }
   },
   {
      $sort: { title: 1 }
   }
] )

[
  {
    title: 'Spirited Away',
    cast: [ 'Rumi Hiiragi', 'Miyu Irino', 'Mari Natsuki', 'Takashi Naitè' ],
    firstThreeCast: [ 'Rumi Hiiragi', 'Miyu Irino', 'Mari Natsuki' ]
  },
  {
    title: 'The Dark Knight',
    cast: [ 'Christian Bale', 'Heath Ledger', 'Aaron Eckhart', 'Michael Caine' ],
    firstThreeCast: [ 'Christian Bale', 'Heath Ledger', 'Aaron Eckhart' ]
  },
  {
    title: 'The Godfather',
    cast: [ 'Marlon Brando', 'Al Pacino', 'James Caan', 'Richard S. Castellano' ],
    firstThreeCast: [ 'Marlon Brando', 'Al Pacino', 'James Caan' ]
  }
]

上述管道：

使用 $match过滤出三部特定电影。
使用 $addFields 和 $firstN 创建一个新字段firstThreeCast，其中包含 cast大量和 n: 3 的前三个元素。
使用 $project 可仅在输出中包含 title、cast 和 firstThreeCast 字段。
使用 $sort 按标题对结果进行排序。

了解详情