MongoDBで配列内に値を含まないドキュメントを照合するには？$nin演算子の使い方

MongoDBでは、配列フィールドが特定の値を含まないドキュメントを検索したい場合、$nin 演算子を使用します。$nin は「not in」を意味し、指定した配列内のいずれの値とも一致しないドキュメントだけを抽出することができます。

サンプルコレクションの作成

まず、ドキュメントを含むコレクションを作成しましょう。

> db.demo180.insertOne({"Scores":["80","90","110"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e3988a69e4f06af551997fb")
}
> db.demo180.insertOne({"Scores":["110","70","60"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e3988b79e4f06af551997fc")
}
> db.demo180.insertOne({"Scores":["40","70","1010"]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e3988cc9e4f06af551997fd")
}

登録済みドキュメントの確認

find() メソッドを使って、コレクション内のすべてのドキュメントを表示します。

> db.demo180.find();

このクエリを実行すると、以下のような出力が得られます。

{ "_id" : ObjectId("5e3988a69e4f06af551997fb"), "Scores" : [ "80", "90", "110" ] }
{ "_id" : ObjectId("5e3988b79e4f06af551997fc"), "Scores" : [ "110", "70", "60" ] }
{ "_id" : ObjectId("5e3988cc9e4f06af551997fd"), "Scores" : [ "40", "70", "1010" ] }

$nin を使ったドキュメントの照合

次に、配列フィールド Scores 内に「110」と「90」のいずれも含まないドキュメントを照合するクエリを見てみましょう。集計パイプラインの $match ステージと組み合わせて $nin を使用します。

> db.demo180.aggregate({ "$match": { "Scores": { "$nin": ["110","90"] } } }).pretty();

このクエリを実行すると、以下の出力が得られます。

{
   "_id" : ObjectId("5e3988cc9e4f06af551997fd"),
   "Scores" : [ "40", "70", "1010" ]
}

結果の解説

出力結果を見ると、「110」または「90」を含む最初と2番目のドキュメントは除外され、どちらの値も含まない3番目のドキュメントのみが返されていることがわかります。

$nin 演算子は、配列フィールドに対して「指定した値がひとつでも含まれていたら除外する」という動作をするため、ブラックリスト方式のフィルタリングに非常に便利です。find() メソッドでも同様に利用できるため、用途に応じて使い分けるとよいでしょう。