定义
返回窗口中第一个文档的表达式值。
注意
消歧
本页介绍了用作窗口函数的 $first。
您还可以在其他上下文中使用 $first：
$first (accumulator)，用于分组以返回每个群组中的第一个值。$first (expression)，返回大量的第一个元素。
语法
{ $setWindowFields: { ... output: { <field>: { $first: <expression> } } } }
行为
$first窗口函数对 null 值和缺失值有以下行为：
$first将缺失字段值转换为null。$first对于空窗口，返回null。
例子
本页上的示例使用 sample_mflix 数据集中的数据。有关如何将此数据集加载到自管理MongoDB 部署中的详细信息，请参阅加载样本数据集。如果对示例数据库进行了任何修改，则可能需要删除并重新创建数据库才能运行本页上的示例。
此示例使用 $setWindowFields 按 year 对电影进行分区，按 imdb.rating 降序对电影进行排序，并确定每年评分最高的电影。每个文档都包含一个字段，显示当年上映的收视率最高的电影的标题：
db.movies.aggregate( [ { $match: { year: { $in: [ 1999, 2000, 2001 ] }, "imdb.rating": { $gte: 8.5 } } }, { $setWindowFields: { partitionBy: "$year", sortBy: { "imdb.rating": -1 }, output: { topRatedMovieInYear: { $first: "$title", window: { documents: [ "unbounded", "unbounded" ] } } } } }, { $project: { _id: 0, title: 1, year: 1, "imdb.rating": 1, topRatedMovieInYear: 1 } }, { $sort: { year: 1, "imdb.rating": -1 } } ] )
在前面的管道中：
$match筛选从 1999-2001 且 IMDb 评分为 8.5 或更高的电影。$setWindowFields按year对电影进行分区，并按imdb.rating降序对电影进行排序。该阶段使用$first和定义为documents: [ "unbounded", "unbounded" ]的窗口来返回每年分区中收视率最高的电影的标题。$project在输出中仅包括title、year、imdb.rating和topRatedMovieInYear。$sort按年份和评级对结果进行排序。