$cond（集計）

項目一覧

定義

互換性
構文
例

MongoDB5.0 は 10 月2024 をもってサポートを終了します。このバージョンのドキュメントはサポート対象外になりました。配置をアップグレードするには、 MongoDB を参照してください。5.0 60アップグレード手順。

定義

$cond: ブール式を評価して、指定された2つの戻り値のうちの1つを返します。

互換性

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

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

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

$cond 式は次の 2 つの構文のいずれかをとります。

{ $cond: { if: <boolean-expression>, then: <true-case>, else: <false-case> } }

または:

{ $cond: [ <boolean-expression>, <true-case>, <false-case> ] }

$cond はいずれの構文でも 3 つのすべての引数（if-then-else）を必要とします。

<boolean-expression> が true と評価された場合、$cond は<true-case> 式の値を評価して返します。それ以外の場合、$cond は <false-case> 式の値を評価して返します。

引数には任意の有効な式を使用できます。式の詳細については、「式」を参照してください。

Tip

以下も参照してください。

$switch

例

次の例では、以下のドキュメントを含む inventory コレクションを使用しています。

{ "_id" : 1, "item" : "abc1", qty: 300 }
{ "_id" : 2, "item" : "abc2", qty: 200 }
{ "_id" : 3, "item" : "xyz1", qty: 250 }

次の集計操作では $cond 式を使用して、qty の値が 250 以上である場合は discount の値を 30 に設定し、qty の値が 250 未満の場合は 20 に設定します。

db.inventory.aggregate(
   [
      {
         $project:
           {
             item: 1,
             discount:
               {
                 $cond: { if: { $gte: [ "$qty", 250 ] }, then: 30, else: 20 }
               }
           }
      }
   ]
)

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

{ "_id" : 1, "item" : "abc1", "discount" : 30 }
{ "_id" : 2, "item" : "abc2", "discount" : 20 }
{ "_id" : 3, "item" : "xyz1", "discount" : 30 }

次の操作では、$cond 式の配列構文を使用して、同じ結果を返します。

db.inventory.aggregate(
   [
      {
         $project:
           {
             item: 1,
             discount:
               {
                 $cond: [ { $gte: [ "$qty", 250 ] }, 30, 20 ]
               }
           }
      }
   ]
)

戻る

$concatArrays

$convert