MongoDBでフィールドの存在を確認する方法｜$exists演算子の使い方を解説

MongoDBでは、$exists演算子を使用することで、特定のフィールドがドキュメント内に存在するかどうかを確認できます。この記事では、実際にサンプルコレクションを作成しながら、$exists演算子の具体的な使い方をわかりやすく解説します。

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

まず、insertOne()メソッドを使ってドキュメントを含むコレクションを作成します。ここでは学生情報を格納する「checkFieldExistsDemo」というコレクションを使用します。

> db.checkFieldExistsDemo.insertOne({"StudentFirstName":"John","StudentGender":"Male","StudentMongoDBScore":89});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd909611a844af18acdffbd")
}
> db.checkFieldExistsDemo.insertOne({"StudentFirstName":"Emma","StudentGender":"Female","StudentMongoDBScore":58});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd909781a844af18acdffbe")
}
> db.checkFieldExistsDemo.insertOne({"StudentFirstName":"Carol","StudentGender":"Male","StudentMongoDBScore":77});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd909871a844af18acdffbf")
}
> db.checkFieldExistsDemo.insertOne({"StudentFirstName":"David","StudentMongoDBScore":98});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd909a31a844af18acdffc0")
}

上記の例では4件のドキュメントを挿入しています。注目すべき点は、最後のDavidのドキュメントにはStudentGenderフィールドが存在しないことです。この違いを利用して、$exists演算子の動作を確認していきます。

コレクション内の全ドキュメントを表示する

find()メソッドにpretty()を組み合わせると、コレクション内のすべてのドキュメントを見やすい整形された形式で表示できます。

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

実行すると以下の出力が得られます。

{
   "_id" : ObjectId("5cd909611a844af18acdffbd"),
   "StudentFirstName" : "John",
   "StudentGender" : "Male",
   "StudentMongoDBScore" : 89
}
{
   "_id" : ObjectId("5cd909781a844af18acdffbe"),
   "StudentFirstName" : "Emma",
   "StudentGender" : "Female",
   "StudentMongoDBScore" : 58
}
{
   "_id" : ObjectId("5cd909871a844af18acdffbf"),
   "StudentFirstName" : "Carol",
   "StudentGender" : "Male",
   "StudentMongoDBScore" : 77
}
{
   "_id" : ObjectId("5cd909a31a844af18acdffc0"),
   "StudentFirstName" : "David",
   "StudentMongoDBScore" : 98
}

$exists演算子でフィールドの存在を確認する

MongoDBでフィールドが存在するかどうかを確認するには、以下のようにクエリを記述します。

> db.checkFieldExistsDemo.find({"StudentMongoDBScore":98, "StudentGender":{"$exists": false}},{'StudentFirstName': 1, '_id':0});

実行結果は以下の通りです。

{ "StudentFirstName" : "David" }

クエリの解説

このクエリを構成する各条件の意味は以下の通りです。

• "StudentMongoDBScore":98 — StudentMongoDBScoreが98であるドキュメントを検索対象とします。
• "StudentGender":{"$exists": false} — StudentGenderフィールドが存在しないドキュメントのみを抽出します。
• {'StudentFirstName': 1, '_id':0} — 出力結果にはStudentFirstNameフィールドのみを表示し、_idは非表示にします（プロジェクションの指定）。

その結果、StudentGenderフィールドを持たないDavidのドキュメントだけが取得されました。

$exists演算子を使う際のポイント

• {"field": {"$exists": true}} — 指定したフィールドが存在するドキュメントを取得します。
• {"field": {"$exists": false}} — 指定したフィールドが存在しないドキュメントを取得します。
• 値がnullのフィールドも「存在する」とみなされるため、意図しない結果を避けたい場合は$type演算子との組み合わせも検討しましょう。

このように、$exists演算子を使えば、スキーマが柔軟なMongoDBにおいても、特定のフィールドを持つ・持たないドキュメントを簡単に検索できます。データの整合性チェックや集計処理の前処理など、さまざまな場面で活用できる便利な演算子なので、ぜひ覚えておきましょう。