$setDifference (集合の差)
最終更新：2026-10-09
$setDifference (集合の差)
$setDifference は、最初の配列には含まれるが 2 番目の配列には含まれない要素を、重複を除去して返します。代表的な用途は、ユーザーが購入したがお気に入り登録していない商品の特定や、2 つの名前リストの差分取得です。両方の引数は配列でなければならず、null 要素は無視されます。結果の順序は保証されず、重複除去後の位置関係も維持されません。集合演算子は配列を集合として扱い、$setIntersection や $setUnion と同族です。
| カテゴリ | 集合・条件・変換 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh（シェル） |
📝 構文
{ $setDifference: [ <arrayA>, <arrayB> ] }⚙️ パラメータ
| 配列A | 減算の対象となる集合。 |
|---|---|
| 配列B | 減算する集合。 |
戻り値：A に含まれ B に含まれない要素の（重複排除された）配列。いずれかの引数が null の場合は null
▶ 例
以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：
// $setDifference: 購入済みだがお気に入りではない商品
db.users.aggregate([
{ $project: {
notFav: { $setDifference: ['$bought', '$favorites'] }
} }
])出力：
{ '_id': 1, 'notFav': [ 'skuB' ] }📌 注意事項
- 結果は重複が除去され順序も保証されない。位置に依存しないこと
- null 要素は無視され、結果に影響しない
- 両方の引数が配列でなければエラー
🏷️ 関連タグ
💡 関連ケース
さらなる実践ケースを近日公開予定。
📚 関連チュートリアル
❓ よくある質問
Q結果は重複が除去されますか？
Aはい — 集合の意味論により各要素は 1 回だけ現れます。
Q入力の順序は保持されますか？
A保証されません — 後段で順序に依存しないでください。
Q$filter との違いは？
A$filter は要素ごとに条件で除去します。$setDifference は別の配列に対する集合の差を計算します。
