$firstN（前 N 元素累加器）

最后更新：2026-10-09

$firstN（前 N 元素累加器）

$firstN 是累加器，返回组内前 N 个文档的指定字段值数组（按输入顺序），自 MongoDB 5.2 起可用。与 $first 的关系类似 $topN 与 $top，但它依赖输入顺序而非排序规则。n 可为常量或表达式。

📝 语法

{ $group: { _id: <键>, firstN: { $firstN: { input: <表达式>, n: <数字> } } } }

返回值：组内前 N 条文档的表达式值数组

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $firstN：取每组最早 3 条的价格
db.sales.aggregate([
  { $sort: { date: 1 } },
  { $group: { _id: '$item', first3: { $firstN: { input: '$price', n: 3 } } } }
])

运行结果：

{ "_id": "Pen", "first3": [20, 25, 30] }

📌 注意事项

• 需要 MongoDB 5.2 及以上版本
• 顺序依赖输入，先 $sort 才有意义
• n 支持表达式动态指定

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们