$firstN (先頭 N アキュムレータ)

最終更新：2026-10-09

$firstN (先頭 N アキュムレータ)

$firstN は、グループの先頭 N ドキュメント（入力順）のフィールドの配列を返すアキュムレータで、MongoDB 5.2 以降で利用できます。$topN と $top の関係と同様に $first と関連しますが、ソート規則ではなく入力順に従います。n は定数式にもできます。

📝 構文

{ $group: { _id: <key>, firstN: { $firstN: { input: <expression>, n: <number> } } } }

戻り値：グループの最初の 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 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて