$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