定义
返回数组的第一个元素。
注意
消歧
本页面介绍了 $first 用作表达式时的情况,它返回数组的第一个元素。
您还可以在这些其他上下文中使用 $first:
$first (accumulator), 在分组中使用,以返回来自每个组的第一个值。$first (window function),用于$setWindowFields阶段,返回窗口中第一个文档的值。
语法
{ $first: <expression> }<expression> 的计算结果必须为数组。
行为
如果操作数表达式求值为数组,则
$first返回该数组中的第一个元素。如果数组为空,
$first返回null。如果表达式计算结果为
null或引用缺失的字段,$first返回null。
例子
本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息,请参阅 加载示例数据集。如果您对示例数据库进行了任何修改,您可能需要删除并重新创建数据库,才能运行此页面上的示例。
以下示例使用 $first 返回每部电影的头号演员。在 sample_mflix 数据集中,cast 数组按照计费顺序列出了演员,因此,第一个元素是主演演员:
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Pulp Fiction", "Forrest Gump" ] } } }, { $addFields: { topBilledActor: { $first: "$cast" } } }, { $project: { _id: 0, title: 1, cast: 1, topBilledActor: 1 } }, { $sort: { title: 1 } }] )在前面的管道中:
$match三部特定电影的过滤器。$addFields与$first创建一个新字段topBilledActor,包含cast数组的第一个元素。$project在输出中仅包含title、cast和topBilledActor字段。$sort按标题排序结果。