$size (agregación)

Definición

$size

Cuenta y devuelve el número total de elementos en una matriz.

Compatibilidad

Puedes usar $size para implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

$size tiene la siguiente sintaxis:

{ $size: <expression> }

El argumento de puede $size ser cualquier expresión, siempre que se resuelva en un array. Para más información sobre expresiones, consulte Expresiones.

Comportamiento

El argumento de$sizedebe resolverse en una matriz. Si el argumento de$sizefalta o no se resuelve en una matriz, se genera un error en$size.

Ejemplo

Considere una colección inventory con los siguientes documentos:

{ "_id" : 1, "item" : "ABC1", "description" : "product 1", colors: [ "blue", "black", "red" ] }
{ "_id" : 2, "item" : "ABC2", "description" : "product 2", colors: [ "purple" ] }
{ "_id" : 3, "item" : "XYZ1", "description" : "product 3", colors: [ ] }
{ "_id" : 4, "item" : "ZZZ1", "description" : "product 4 - missing colors" }
{ "_id" : 5, "item" : "ZZZ2", "description" : "product 5 - colors is string", colors: "blue,red" }

La siguiente operación de canalización de agregación utiliza el operador para devolver la cantidad de elementos en $size la colors matriz:

db.inventory.aggregate([
   {
      $project: {
         item: 1,
         numberOfColors: { $cond: { if: { $isArray: "$colors" }, then: { $size: "$colors" }, else: "NA"} }
      }
   }
] )

La operación devuelve lo siguiente:

{ "_id" : 1, "item" : "ABC1", "numberOfColors" : 3 }
{ "_id" : 2, "item" : "ABC2", "numberOfColors" : 1 }
{ "_id" : 3, "item" : "XYZ1", "numberOfColors" : 0 }
{ "_id" : 4, "item" : "ZZZ1", "numberOfColors" : "NA" }
{ "_id" : 5, "item" : "ZZZ2", "numberOfColors" : "NA" }