MongoDBの$addToSet演算子で重複のない値を取得・表示する方法

MongoDBの$addToSet演算子は、セット（配列）に重複する要素が追加されないよう保証するための演算子です。すでに存在する値を追加しようとしても、それは自動的に無視されます。この記事では、この演算子を使って配列フィールドから重複のない値を取得・表示する手順を解説します。

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

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

> db.getDistinctDemo.insertOne({"Values":[100,200]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cef69f9ef71edecf6a1f69d")
}
> db.getDistinctDemo.insertOne({"Values":[300,100]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cef6a07ef71edecf6a1f69e")
}

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

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

> db.getDistinctDemo.find().pretty();

実行すると、次のような出力が得られます。

{
    "_id" : ObjectId("5cef69f9ef71edecf6a1f69d"),
    "Values" : [
        100,
        200
    ]
}
{
    "_id" : ObjectId("5cef6a07ef71edecf6a1f69e"),
    "Values" : [
        300,
        100
    ]
}

2つのドキュメントはどちらも「100」という値を持っています。これが重複要素にあたります。

$addToSetで重複のない値をまとめる

続いて、aggregate()メソッドと$groupステージを組み合わせて、配列フィールドの値を重複なく1つのセットにまとめるクエリを見てみましょう。

> db.getDistinctDemo.aggregate([
    { "$group": { "_id": 0,
        "MyValues": { "$addToSet": "$Values" }
    } }
]);

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

{ "_id" : 0, "MyValues" : [ [ 300, 100 ], [ 100, 200 ] ] }

ここでのポイントは、$addToSetが「配列全体」を1つの要素として比較している点です。[300, 100]と[100, 200]は互いに異なる配列なので、どちらもそのままセットに残ります。

応用：$unwindで個別の値に展開する

配列の中身をバラして、数値単位で重複を排除したい場合は、$unwindステージを先に適用します。

> db.getDistinctDemo.aggregate([
    { "$unwind": "$Values" },
    { "$group": { "_id": 0,
        "MyValues": { "$addToSet": "$Values" }
    } }
]);

実行結果は次のとおりです。

{ "_id" : 0, "MyValues" : [ 300, 100, 200 ] }

このように$unwindと$addToSetを組み合わせれば、すべてのドキュメントにまたがった完全にユニークな値の一覧を簡単に取得できます。なお、通常の$pushは重複を許可して追記するのに対し、$addToSetは重複を自動的に除外する点が大きな違いです。用途に応じて使い分けるとよいでしょう。