Definición
$switchEvalúa una serie de expresiones de casos. Cuando encuentra una expresión que se evalúa como
true,$switchejecuta una expresión especificada y sale del flujo de control.$switchtiene la siguiente sintaxis:$switch: { branches: [ { case: <expression>, then: <expression> }, { case: <expression>, then: <expression> }, ... ], default: <expression>}Los objetos en el arreglo
branchesdeben contener únicamente un campocasey un campothen.OperandoDescripciónbranchesUn arreglo de documentos de la sucursal control. Cada rama es un documento con los siguientes campos:
then- Puede ser cualquier expresión válida.
El arreglo
branchesdebe contener al menos un documento de sucursal.defaultopcional. La ruta a seguir si ninguna expresión de rama
caseevalúa atrue.Aunque es opcional, si
defaultno se especifica y ninguna ramacaseevalúa como verdadera,$switchdevuelve un error.
Comportamiento
Las diversas instrucciones de caso no necesitan ser mutuamente exclusivas. $switch ejecuta la primera rama que encuentra que se evalúa en true. Si ninguna de las ramas se evalúa como verdadera, $switch ejecuta la opción default.
Las siguientes condiciones hacen que $switch falle con un error:
El campo
branchesfalta o no es un arreglo con al menos una entrada.Un objeto en el arreglo
branchesno contiene un campocase.Un objeto en el arreglo
branchesno contiene un campothen.Un objeto en el arreglo
branchescontiene un campo que no escaseothen.No se especifica
defaulty ningúncaseevalúatrue.
Ejemplo | Resultados |
|---|---|
|
|
|
|
|
|
Ejemplo
El siguiente ejemplo utiliza la colección movies del conjunto de datos de muestra sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en su implementación, consulte Cargar el conjunto de datos de muestra.
Esta operación de agregación utiliza $switch para mostrar un mensaje específico basado en la calificación de cada película. La etapa $match limita los resultados a las tres películas más largas del conjunto de datos de muestra:
db.movies.aggregate( [ { $match: { runtime: { $gt: 800 } } }, { $project: { _id: 0, title: 1, summary: { $switch: { branches: [ { case: { $gte: [ "$imdb.rating", 9 ] }, then: "Doing great!" }, { case: { $and: [ { $gte: [ "$imdb.rating", 8 ] }, { $lt: [ "$imdb.rating", 9 ] } ] }, then: "Doing pretty well." }, { case: { $lt: [ "$imdb.rating", 8 ] }, then: "Needs improvement." } ], default: "No rating found." } } } }, { $sort: { title: 1 } }] )[ { title: 'Baseball', summary: 'Doing great!' }, { title: 'Centennial', summary: 'Doing pretty well.' }, { title: 'Taken', summary: 'Needs improvement.' }]Tip