Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ /

Consulta para campos nulos ou ausentes

Nesta página

  • Filtro de equalização
  • Filtro de não igualdade
  • Verificação de Tipo
  • Verificação de existência
  • Query de campos null ou ausentes com o MongoDB Atlas

Você pode fazer query de null ou campos ausentes no MongoDB usando os seguintes métodos:

  • O driver da sua linguagem de programação.

  • A UI do MongoDB Atlas. Para saber mais, consulte Consulta de campos nulos ou ausentes com o MongoDB Atlas.

  • MongoDB Compass.


➤ Use o menu suspenso Selecione a linguagem no canto superior direito para definir a linguagem dos exemplos a seguir ou selecione MongoDB Compass.


Diversos operadores de query no MongoDB tratam valores null de forma diferente.

A query retorna ambos os documentos na coleção.

Para query campo que existem e não são nulos, use o filtro { $ne : null } . A query { item : { $ne : null } } corresponde a documentos onde o campo item existe e tem um valor não nulo.

A query retorna somente o documento onde o campo item tem um valor de null.

As seguintes queries de exemplo para documentos que não contêm um campo. [1]

A query retorna somente o documento que não contém o campo item.

Dica

Veja também:

Documentação de referência para os operadores $type e $exists .

[1] Os usuários não podem mais utilizar a query $type: 0 como sinônimo de $exists:false. Para fazer query de campos nulos ou ausentes, consulte Fazer query de campos nulos ou ausentes.

O exemplo nesta seção utiliza o conjunto de dados de treinamento de amostra. Para saber como carregar o conjunto de dados de amostra em sua implantação do MongoDB Atlas, consulte Carregar Dados de Amostra.

Para executar query de um null ou um campo ausente no MongoDB Atlas, siga estas etapas:

1
  1. Na IU do Atlas, clique em Database na barra lateral.

  2. Para a implantação do banco de dados que contém os dados de amostra, clique em Browse Collections.

  3. No painel de navegação esquerdo, selecione o banco de dados sample_training.

  4. Selecione a collection companies.

2

Clique no botão Insert Document para exibir a caixa de diálogo e, em seguida, em Insert para inserir um documento com o campo _id apenas.

3

Para encontrar um documento que contenha um valor null ou ausente, especifique um query filter document no campo Filter. Um documento de filtro de query usa operadores de query para especificar as condições de pesquisa.

Diversos operadores de query no MongoDB tratam valores null de forma diferente. Para aplicar um filtro de query, copie cada um dos seguintes documentos na barra de pesquisa Filter e clique em Apply.

Utilize o seguinte filtro de query para combinar documentos que contêm um campo description com um valor null ou que não contêm o campo description:

{ description : null }

Utilize o seguinte filtro de query para corresponder apenas a documentos que contêm um campo description com um valor null. Esse filtro especifica que o valor do campo deve ser Tipo de BSON Null (Tipo de BSON 10):

{ description : { $type: 10 } }

Use o seguinte filtro de query para corresponder somente a documentos que não contêm o campo description. Somente o documento inserido anteriormente deve ser exibido:

{ description : { $exists: false } }
← Campos do projeto para retornar da consulta