MongoDB $size

No MongoDB, o $size operador de pipeline de agregação conta e retorna o número total de itens em uma matriz.

O $size operador aceita um argumento. O argumento pode ser qualquer expressão válida que resolva para uma matriz.

Exemplo

Suponha que tenhamos uma coleção chamada test com os seguintes documentos:

{ "_id" : 1, "data" : [ ] }
{ "_id" : 2, "data" : [ "a" ] }
{ "_id" : 3, "data" : [ "a", "b" ] }
{ "_id" : 4, "data" : [ "a", "b", "c" ] }
{ "_id" : 5, "data" : [ 1, 1, 1, 1 ] }

Podemos usar $size para retornar o número de itens nas matrizes nos respectivos data Campos.

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2, 3, 4, 5 ] } } },
     {
       $project:
          {
            _id: 0,
            data: 1,
            result: { $size: [ "$data" ] }
          }
     }
   ]
)

Resultado:

{ "data" : [ ], "result" : 0 }
{ "data" : [ "a" ], "result" : 1 }
{ "data" : [ "a", "b" ], "result" : 2 }
{ "data" : [ "a", "b", "c" ], "result" : 3 }
{ "data" : [ 1, 1, 1, 1 ], "result" : 4 }

Matrizes aninhadas

O $size operador não desce em matrizes aninhadas e conta seus elementos. Ele avalia a matriz do nível superior.

Suponha que temos o seguinte documento em nossa coleção:

{ "data" : [ [ 1, 2 ], 3 ], "result" : 2 }

E aplicamos $size para isso:

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 6 ] } } },
     {
       $project:
          {
            _id: 0,
            data: 1,
            result: { $size: [ "$data" ] }
          }
     }
   ]
)

Resultado:

{ "data" : [ [ 1, 2 ], 3 ], "result" : 2 }

A matriz aninhada é contada como um elemento (independentemente de quantos elementos ela contém).

Tipos de dados incorretos

O argumento pode ser qualquer expressão válida, desde que resolva para uma matriz. Se não resolver para uma matriz, um erro será produzido.

Suponha que temos o seguinte documento:

{ "_id" : 7, "data" : 3 }

Os data campo não resolve para uma matriz.

Veja o que acontece quando aplicamos $size para esse campo:

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 7 ] } } },
     {
       $project:
          {
            _id: 0,
            data: 1,
            result: { $size: [ "$data" ] }
          }
     }
   ]
)

Resultado:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "The argument to $size must be an array, but was of type: double",
	"code" : 17124,
	"codeName" : "Location17124"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
example@sqldat.com/mongo/shell/assert.js:639:17
example@sqldat.com/mongo/shell/assert.js:729:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1058:12
@(shell):1:1

A mensagem de erro nos diz que The argument to $size must be an array, but was of type: double .

Campos ausentes

Se o campo não existir no documento, um erro será retornado.

Suponha que temos o seguinte documento:

{ "_id" : 8 }

E aplicamos $size a esse documento:

db.test.aggregate(
   [
     { $match: { _id: { $in: [ 8 ] } } },
     {
       $project:
          {
            _id: 0,
            data: 1,
            result: { $size: [ "$data" ] }
          }
     }
   ]
)

Resultado:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "The argument to $size must be an array, but was of type: missing",
	"code" : 17124,
	"codeName" : "Location17124"
} : aggregate failed :
example@sqldat.com/mongo/shell/utils.js:25:13
example@sqldat.com/mongo/shell/assert.js:18:14
_asseexample@sqldat.com/mongo/shell/assert.js:639:17
example@sqldat.com/mongo/shell/assert.js:729:16
example@sqldat.com/mongo/shell/db.js:266:5
example@sqldat.com/mongo/shell/collection.js:1058:12
@(shell):1:1