$addToSet (ユニーク配列アキュムレータ)

最終更新：2026-10-09

$addToSet (ユニーク配列アキュムレータ)

$addToSet は、$group 中に各ドキュメントの式の結果を配列へ追加していくアキュムレータで、重複を自動的に除去します — 同じ値は 1 回だけ現れます。$push に似ますがユニーク性を保証します。タグや顧客リストなど重複排除の用途に向きます。要素の順序は保証されません。

📝 構文

{ $group: { _id: <key>, tags: { $addToSet: "$field" } } }

戻り値：式結果を重複排除した配列

▶ 例

以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：

// $addToSet: 顧客ごとのユニークなアイテム
db.orders.aggregate([
  { $group: { _id: '$cust_id', items: { $addToSet: '$item' } } }
])

出力：

{ "_id": "A123", "items": ["Pen", "Book"] }

📌 注意事項

• 要素はユニークで、重複は 1 つに潰れる
• 順序は保証されない。必要なら自分で整列する
• 重複判定は BSON の等値性（型と値が同じ）に基づく

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて