Menu Docs

Página inicial do DocsDesenvolver aplicaçõesManual do MongoDB

$size

Nesta página

  • Compatibilidade
  • Exemplos adicionais
$size

O operador $size corresponde a qualquer array com o número de elementos especificados pelo argumento.

Você pode utilizar o $size para implantações hospedadas nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações MongoDB na nuvem

Considere os seguintes exemplos:

db.collection.find( { field: { $size: 2 } } );

Esta query retorna todos os documentos em collection onde field é uma array com 2 elementos. Por exemplo, a expressão acima retornará { field: [ red, green ] } e { field: [ apple, lime ] } , mas não { field: fruit } ou { field: [ orange, lemon, grapefruit ] }. Para fazer a correspondência de campos com apenas um elemento em uma array, use $size com um valor de 1, como segue:

db.collection.find( { field: { $size: 1 } } );

$size não aceita faixas de valores. Para selecionar documentos com base em campos com diferentes números de elementos, crie um campo de contador que você incrementa ao adicionar elementos a um campo.

As queries não podem usar índices para a parte de uma query $size , embora as outras partes de uma query possam usar índices, se aplicável.

Para obter exemplos adicionais da queries de arrays, consulte:

Para obter exemplos adicionais de query, consulte:

Dica

Veja também:

← $elemMatch (query)