Operadores de consulta e projeção

Nesta página

Compatibilidade

Seletores de query
Operadores de projeção
Operadores diversos

O MongoDB 5.0 é o fim da vida útil a partir de de 2024 outubro. Esta versão da documentação não é mais suportada. Para atualizar sua 5.0 implantação do, consulte o MongoDB 6.0 procedimentos de atualização.

Observação

Para obter detalhes sobre um operador específico, incluindo sintaxe e exemplos, clique no link para a página de referência do operador.

Compatibilidade

Você pode usar operadores de query e projeção para sistemas hospedados nos seguintes ambientes:

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

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Dica

Você pode utilizar operadores ao consultar seus dados com métodos mongosh, a IU do Atlas ou o Compass.

Seletores de query

Comparação

Para comparação de diferentes valores dos tipos de BSON, consulte a ordem de comparação de BSON especificada.

Nome	Descrição
`$eq`	Corresponde aos valores que são iguais a um valor especificado.
`$gt`	Corresponde aos valores que são maiores que um valor especificado.
`$gte`	Corresponde aos valores que são maiores ou iguais a um valor especificado.
`$in`	Corresponde a qualquer um dos valores especificados em uma array.
`$lt`	Corresponde a valores que são menores do que um valor especificado.
`$lte`	Corresponde a valores menores ou iguais a um valor especificado.
`$ne`	Corresponde a todos os valores que não são iguais a um valor especificado.
`$nin`	Não corresponde a nenhum dos valores especificados em uma array.

Lógica

Nome	Descrição
`$and`	Une cláusulas de query com um `AND` lógico e retorna todos os documentos que correspondem às condições de ambas as cláusulas.
`$not`	Inverte o efeito de uma expressão de query e retorna documentos que não correspondem à expressão de query.
`$nor`	Une cláusulas de query com um `NOR` lógico e retorna todos os documentos que não correspondem a ambas as cláusulas.
`$or`	Une cláusulas de query com um `OR` lógico e retorna todos os documentos que correspondem às condições de qualquer cláusula.

Elemento

Nome	Descrição
`$exists`	Corresponde a documentos que têm o campo especificado.
`$type`	Seleciona documentos se um campo for do tipo especificado.

Avaliação

Nome	Descrição
`$expr`	Permite o uso de expressões de aggregation dentro da linguagem de query.
`$jsonSchema`	Valide documentos em relação ao JSON schema fornecido.
`$mod`	Executa uma operação de módulo no valor de um campo e seleciona documentos com um resultado especificado.
`$regex`	Seleciona documentos onde os valores correspondem a uma expressão regular especificada.
`$text`	Executa pesquisa de texto. `$text` fornece recursos de query de texto para implantações autogerenciadas (não Atlas). Para dados hospedados no MongoDB Atlas, o MongoDB oferece uma solução aprimorada de query de texto completo, Atlas Search.
`$where`	Corresponde a documentos que satisfazem uma expressão JavaScript.

Geoespacial

Nome	Descrição
`$geoIntersects`	Seleciona geometrias que interseccionam com uma geometria GeoJSON. O índice 2dsphere suporta `$geoIntersects`.
`$geoWithin`	Seleciona geometrias dentro de uma geometria GeoJSON delimitadora. Os índices 2dsphere e 2d suportam `$geoWithin`.
`$near`	Retorna objetos geoespaciais próximos a um ponto. Requer um índice geoespacial. Os índices 2dsphere e 2d suportam `$near`.
`$nearSphere`	Retorna objetos geoespaciais próximos a um ponto em uma esfera. Requer um índice geoespacial. Os índices 2dsphere e 2d suportam `$nearSphere`.

Array

Nome	Descrição
`$all`	Corresponde a arrays que contêm todos os elementos especificados na query.
`$elemMatch`	Seleciona documentos se o elemento no campo de array corresponder a todas as condições `$elemMatch` especificadas.
`$size`	Seleciona documentos se o campo de array tiver um tamanho especificado.

Bitwise

Nome	Descrição
`$bitsAllClear`	Corresponde aos valores numéricos ou binários em que todos os bits em um conjunto de posições de bit têm um valor de `0`.
`$bitsAllSet`	Corresponde aos valores numéricos ou binários em que todos os bits em um conjunto de posições de bit têm um valor de `1`.
`$bitsAnyClear`	Corresponde aos valores numéricos ou binários em que qualquer bit de um conjunto de posições de bit tem um valor de `0`.
`$bitsAnySet`	Corresponde aos valores numéricos ou binários em que qualquer bit de um conjunto de posições de bit tem um valor de `1`.

Operadores de projeção

Nome	Descrição
`$`	Projeta o primeiro elemento em uma array que corresponde à condição de query.
`$elemMatch`	Projeta o primeiro elemento em uma array que corresponde à condição `$elemMatch` especificada.
`$meta`	Projeta a pontuação do documento atribuída durante a operação `$text`. `$text` fornece recursos de query de texto para implantações autogerenciadas (não Atlas). Para dados hospedados no MongoDB Atlas, o MongoDB oferece uma solução aprimorada de query de texto completo, Atlas Search.
`$slice`	Limita o número de elementos projetados de uma array. Suporta pular e limitar fatias.

Operadores diversos

Nome	Descrição
`$comment`	Adiciona um comentário a um predicado de query.
`$rand`	Gera uma flutuação aleatória entre 0 e 1.

Voltar

Operadores

Consulta de comparação