MongoDB聚合运算符:$switch
$switch
聚合运算符评估一系列case表达式,当找到一个计算结果为
true
的表达式时,
$switch
会执行指定的表达式并脱离控制流。
语法
$switch: {
branches: [
{
case: <expression>, then: <expression> },
{
case: <expression>, then: <expression> },
...
],
default: <expression>
}
branches
数组中的对象必须仅包含case
字段和then
字段。
branches
:控制分支文档的数组,数组至少要有一个元素,分支为包含以下字段的文档:case
:可解析为布尔值的表达式,如果不是布尔类型,则强制转换为布尔类型then
:可以是任何合法的表达式
default
:可选字段,没有分支表达式为true时的路径。尽管是可选的,但如果未指定默认值并且没有分支为true时$switch
将返回错误。
使用
各种case
语句不需要相互排斥,$switch
会执行第一个结果为true
的分支,如果没有分支为true,$switch
执行默认选项。
以下情况会导致$switch
出错:
- 分支字段缺失或不是至少有一个条目的数组。
- 分支数组中的对象不包含
case
字段。 - 分支数组中的对象不包含
then
字段。 - 分支数组中的对象包含
case
或then
以外的字段。 - 未指定默认值,且
case
值均为true
第一个符合条件的分支
{
$switch: {
branches: [
{
case: {
$eq: [ 0, 5 ] }, then: "equals" },
{
case