Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

$switch (operador de expresión de agregación)

$switch

Evalúa una serie de expresiones de casos. Cuando encuentra una expresión que se evalúa como true, $switch ejecuta una expresión especificada y sale del flujo de control.

$switch tiene la siguiente sintaxis:

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

Los objetos en el arreglo branches deben contener únicamente un campo case y un campo then.

Operando
Descripción

branches

Un arreglo de documentos de la sucursal control. Cada rama es un documento con los siguientes campos:

  • case
    Puede ser cualquier expresión válida que se resuelva en un boolean. Si el resultado no es un boolean, se fuerza a un valor booleano. Puede encontrar más información sobre cómo MongoDB evalúa las expresiones como verdaderas o falsas aquí.
  • then
    Puede ser cualquier expresión válida.

El arreglo branches debe contener al menos un documento de sucursal.

default

opcional. La ruta a seguir si ninguna expresión de rama case evalúa a true.

Aunque es opcional, si default no se especifica y ninguna rama case evalúa como verdadera, $switch devuelve un error.

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 branches falta o no es un arreglo con al menos una entrada.

  • Un objeto en el arreglo branches no contiene un campo case.

  • Un objeto en el arreglo branches no contiene un campo then.

  • Un objeto en el arreglo branches contiene un campo que no es case o then.

  • No se especifica default y ningún case evalúa true.

Ejemplo
Resultados
{ $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"

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.' }]
Califique esta página