$and

互換性

次の環境でホストされる配置には $and を使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

$andの構文は次のとおりです。

{ $and: [ { <expression1> }, { <expression2> } , ... , { <expressionN> } ] }

動作

MongoDB のクエリ オプティマイザでは、$and 式の句を評価する際に、実行に最適なプランを選択するために、$and 式の句を満たすのにどのインデックスを役立てることができるのかが検討されます。

クエリ エンジンでクエリが最適化されるよう、$and はエラーを次のように処理します。

• $and に指定した式が単独で評価されるとエラーが発生する場合、その式を含む $and でエラーが発生することがありますが、必ずしもエラーが発生するわけではありません。

• $and に最初に指定した式の後に式を指定すると、最初の式が false と評価されていてもエラーが発生することがあります。

たとえば、次のクエリでは、 $x が 0 の場合、常にエラーが発生します。

db.example.find( {
   $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] }
} )

$and に複数の式を指定した次のクエリでは、$x が 0 であるドキュメントがある場合にエラーが発生することがあります。

db.example.find( {
   $and: [
      { x: { $ne: 0 } },
      { $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] } }
   ]
} )

MongoDB Shell (mongosh)を含む、ほとんどのプログラミング言語とドライバーは、同じオブジェクトレベルで重複するキーを持つオブジェクトの構築を許可していません。以下に例を挙げます。

db.inventory.find( { price: { $in: [ 7.99, 3.99 ], $in: [ 4.99, 1.99 ] } } )

フィールド名 price には同じオブジェクトレベルで重複する演算子があるため、前のクエリは無効です。サーバーに送信されたクエリは、意図したものと異なります。クエリを動作させるには、次の明示的な AND を使用します。

db.inventory.find( {
   $and: [
      { price: { $in: [ 7.99, 3.99 ] } },
      { price: { $in: [ 4.99, 1.99 ] } }
   ]
} )

前のクエリは、両方の条件が満たされていることを明示的にチェックします。price 配列には、各 $in セットから少なくとも1つの値が含まれている必要があります。詳細については「例」を参照してください。

例

この例は同じフィールドの複数の式と一致します。

次のクエリを考えてみましょう。

db.inventory.find( { $and: [ { price: { $ne: 1.99 } }, { price: { $exists: true } } ] } )

クエリは、次の条件を満たす inventory コレクション内のすべてのドキュメントを選択します。

• price フィールドの値が1.99 と等しくない、かつ

• price フィールドが存在する。

このクエリを簡素化するには、price フィールドの演算子式を、暗黙的にネストされた AND を持つ単一のクエリオブジェクトに統合します：

db.inventory.find( { price: { $ne: 1.99, $exists: true } } )

特に同じフィールドで重複した条件が存在する場合は、書き換えは必ずしも可能ではありません。以下がその例です。

db.inventory.find( { status: { $ne: "closed", $ne: "archived" } } )

前のクエリでは、同じプロジェクトレベルで $ne が status フィールドで複数回使用されているため無効です。代わりに、$nin を使用します。

db.inventory.find( { status: { $nin: [ "closed", "archived" ] } } )

意向に基づいてクエリを書き換えます。次のクエリを検討します。

db.inventory.find( {
   $and: [
      { status: "new" },
      { status: "processing" }
   ]
} )

status がnew または processing のいずれかであるドキュメントを検索するには、$in を使用します。

db.inventory.find( { status: { $in: [ "new", "processing" ] } } )

status フィールドが [ "new", "processing" ] の配列で、ドキュメントに new と processing の両方が含まれている場合は、$all を使用します。

db.inventory.find( { status: { $all: [ "new", "processing" ] } } )

前のクエリは意味的に AND と同じですが、配列フィールドをクエリする場合は $all がより明確です。

フィールド名の重複と同様に、クエリで使用される演算子の重複にも同様の考慮が適用されます。

詳細

• find()

• $ne

• $exists

• $in

• $all