$or（集計）

定義

$or

1 つまたは複数の式を評価し、いずれかの式がtrueであればtrueを返します。それ以外の場合、 $orはfalseを返します。

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

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

式の詳細については、「式」を参照してください。

動作

falseブール値に加えて、 $orは、次のnull 、 0 、 undefined値をfalseとして評価します。 $orは、ゼロ以外の数値と配列を含む他のすべての値をtrueとして評価します。

例	結果
`{ $or: [ true, false ] }`	`true`
`{ $or: [ [ false ], false ] }`	`true`
`{ $or: [ null, 0, undefined ] }`	`false`
`{ $or: [ ] }`	`false`

Error Handling

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

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

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

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

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

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

例

以下のドキュメントを持つinventoryコレクションを検討してください。

db.inventory.insertMany( [
   { _id: 1, item: "abc1", description: "product 1", qty: 300 },
   { _id: 2, item: "abc2", description: "product 2", qty: 200 },
   { _id: 3, item: "xyz1", description: "product 3", qty: 250 },
   { _id: 4, item: "VWZ1", description: "product 4", qty: 300 },
   { _id: 5, item: "VWZ2", description: "product 5", qty: 180 }
] )

次の操作では、 $or演算子を使用して、 qtyが250より大きいか、または200より小さいかどうかを判断します。

db.inventory.aggregate(
   [
     {
       $project:
          {
            item: 1,
            result: { $or: [ { $gt: [ "$qty", 250 ] }, { $lt: [ "$qty", 200 ] } ] }
          }
     }
   ]
)

この操作は次の結果を返します。

{ _id: 1, item: "abc1", result: true }
{ _id: 2, item: "abc2", result: false }
{ _id: 3, item: "xyz1", result: false }
{ _id: 4, item: "VWZ1", result: true }
{ _id: 5, item: "VWZ2", result: true }

戻る

$objectToArray

$pow