$ switch（聚合）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 聚合管道运营商 > $ switch（聚合）

在本页面

定义
行为
例

定义¶

$switch¶

3.4版的新功能。

计算一系列案例表达式。当它找到一个计算结果为的表达式时true，$switch执行一个指定的表达式并退出控制流程。

$switch 具有以下语法：

复制

$switch: {
   branches: [
      { case: <expression>, then: <expression> },
      { case: <expression>, then: <expression> },
      ...
   ],
   default: <expression>
}

branches数组中的对象必须仅包含一个case 字段和一个then字段。

操作数	描述
`branches`	控件分支文档的数组。每个分支都是具有以下字段的文档： `case` 可以是任何可解析为的有效表达式`boolean`。如果结果不是a `boolean`，则将其强制为布尔值。有关MongoDB如何将表达式评估为true或false的更多信息，请参见此处。 `then` 可以是任何有效的表达式。该`branches`数组必须包含至少一个分支文档。
`default`	可选的。如果没有分支`case`表达式的结果为的路径`true`。尽管是可选的，但如果`default`未指定，并且没有分支`case`求值为true，则`$switch` 返回错误。

行为¶

各种case语句不必相互排斥。 $switch执行它发现的第一个分支，结果为true。如果没有一个分支的结果为true，则 $switch执行该default选项。

以下情况导致$switch失败并显示错误：

该branches字段丢失或不是具有至少一个条目的数组。
branches数组中的对象不包含case 字段。
branches数组中的对象不包含then 字段。
branches数组中的对象包含case或以外的其他字段 then。
default未指定No ，并且没有case计算为true。

例结果

例	结果
{ $switch: { branches: [ { case: { $eq: [ 0, 5 ] }, then: "equals" }, { case: { $gt: [ 0, 5 ] }, then: "greater than" }, { case: { $lt: [ 0, 5 ] }, then: "less than" } ] } }	`"less than"`
{ $switch: { branches: [ { case: { $eq: [ 0, 5 ] }, then: "equals" }, { case: { $gt: [ 0, 5 ] }, then: "greater than" } ], default: "Did not match" } }	`"Did not match"`
{ $switch: { branches: [ { case: "this is true", then: "first case" }, { case: false, then: "second case" } ], default: "Did not match" } }	`"First case"`

{
   $switch: {
      branches: [
         { case: { $eq: [ 0, 5 ] }, then: "equals" },
         { case: { $gt: [ 0, 5 ] }, then: "greater than" },
         { case: { $lt: [ 0, 5 ] }, then: "less than" }
      ]
   }
}

"less than"

{
   $switch: {
      branches: [
         { case: { $eq: [ 0, 5 ] }, then: "equals" },
         { case: { $gt: [ 0, 5 ] }, then: "greater than" }
      ],
      default: "Did not match"
   }
}

"Did not match"

{
   $switch: {
      branches: [
         { case: "this is true", then: "first case" },
         { case: false, then: "second case" }
      ],
      default: "Did not match"
   }
}

"First case"

例子¶

名为的集合grades包含以下文档：

复制

{ "_id" : 1, "name" : "Susan Wilkes", "scores" : [ 87, 86, 78 ] }
{ "_id" : 2, "name" : "Bob Hanna", "scores" : [ 71, 64, 81 ] }
{ "_id" : 3, "name" : "James Torrelio", "scores" : [ 91, 84, 97 ] }

以下汇总操作用于$switch根据每个学生的平均分数显示特定的消息。

复制

db.grades.aggregate( [
  {
    $project:
      {
        "name" : 1,
        "summary" :
        {
          $switch:
            {
              branches: [
                {
                  case: { $gte : [ { $avg : "$scores" }, 90 ] },
                  then: "Doing great!"
                },
                {
                  case: { $and : [ { $gte : [ { $avg : "$scores" }, 80 ] },
                                   { $lt : [ { $avg : "$scores" }, 90 ] } ] },
                  then: "Doing pretty well."
                },
                {
                  case: { $lt : [ { $avg : "$scores" }, 80 ] },
                  then: "Needs improvement."
                }
              ],
              default: "No scores found."
            }
         }
      }
   }
] )

该操作返回以下内容：

复制

{ "_id" : 1, "name" : "Susan Wilkes", "summary" : "Doing pretty well." }
{ "_id" : 2, "name" : "Bob Hanna", "summary" : "Needs improvement." }
{ "_id" : 3, "name" : "James Torrelio", "summary" : "Doing great!" }

也可以看看

$cond