Null (Valor Vazio)
Última atualização: 2026-10-09
Null (Valor Vazio)
Null significa que o campo guarda um valor vazio, distinto de um campo ausente. Uma consulta como `{ field: null }` corresponde tanto a valores null quanto a campos ausentes; combine com `$exists` para diferenciá-los. Convenção: null = explicitamente vazio, ausente = nunca definido.
| Categoria | Tipos BSON |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ field: null }
db.users.find({ field: null })
db.users.find({ field: { $eq: null, $exists: true } })Retorno：O próprio valor null; as consultas retornam documentos correspondentes
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// Null: valor null vs campo ausente
use shop
db.users.find({ phone: null })
db.users.find({ phone: { $eq: null, $exists: true } })Saída：
// Primeiro: usuários cujo phone é null ou ausente. Segundo: apenas aqueles com phone null📌 Notas
- null e ausente são estados diferentes com semânticas diferentes
- { field: null } equivale a { field: { $eq: null } } e inclui campos ausentes
- A string vazia '' é um valor de string e nunca corresponde a null
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QConsultar null retorna documentos onde o campo está ausente?
ASim. { field: null } corresponde tanto a valores null quanto a campos ausentes.
QNull é o mesmo que string vazia ''?
ANão. '' é um valor de string enquanto null é vazio; consultas por um nunca correspondem ao outro.
QComo correspondo apenas documentos onde o campo é null?
AUse { field: { $eq: null, $exists: true } } para que $exists exclua campos ausentes.
