定义
从数组开头返回指定数量的元素。
注意
消歧
本页介绍 $firstN 当作为 表达式 使用时,它会从数组开头返回指定数量的元素。
您还可以在这些其他上下文中使用 $firstN:
$firstN (accumulator),用于分组以返回每个组的前n个元素。$firstN (window function),用于在$setWindowFields阶段中,从特定窗口的文档中返回前n个值。
语法
{ $firstN: { input: <expression>, n: <expression> } }选项
字段 | 类型 | 说明 |
|---|---|---|
| 表达式(expression) | 要返回前 |
| 表达式(expression) |
|
行为
$firstN会按照它们在输入数组中出现的相同顺序返回元素。$firstN不过滤输入数组中的null值。不能指定小于
1的n值。如果指定的
n大于或等于input数组中的元素数,$firstN会返回整个input数组。如果
input解析为非数组值,则聚合操作将出错。
例子
本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息,请参阅 加载示例数据集。如果您对示例数据库进行了任何修改,您可能需要删除并重新创建数据库,才能运行此页面上的示例。
以下示例使用 $firstN 操作符返回每部电影的前三名演员。cast 节点将在由 $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 } }] )前面的管道:
使用
$match作为过滤器,过滤出三部特定电影。使用
$addFields和$firstN创建一个新字段firstThreeCast,包含来自cast数组和n: 3的前三个元素。使用
$project来在输出中仅包含title、cast和firstThreeCast字段。使用 `
$sort` 按标题对结果进行排序。