Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB
$ne
Nesta página
Definição
$ne$neseleciona os documentos onde o valor do campo especificado não é igual ao valor especificado. Isso inclui documentos que não contêm o campo especificado.Para comparação de diferentes valores dos tipos de BSON, consulte a ordem de comparação de BSON especificada.
Compatibilidade
Você pode utilizar o $ne para implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações MongoDB na nuvem
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão código-disponível, de uso gratuito e autogerenciada do MongoDB
Sintaxe
O operador $ne tem o seguinte formato:
{ field: { $ne: value } }
Observação
Se o valor do operador $ne for nulo, consulte Filtro de Não Igualdade para obter mais informações.
Exemplos
Os exemplos a seguir usam a collection inventory . Para criar a coleção, execute o seguinte comando insertMany() em mongosh:
db.inventory.insertMany( [ { "item": "nuts", "quantity": 30, "carrier": { "name": "Shipit", "fee": 3 } }, { "item": "bolts", "quantity": 50, "carrier": { "name": "Shipit", "fee": 4 } }, { "item": "washers", "quantity": 10, "carrier": { "name": "Shipit", "fee": 1 } } ] )
Corresponder campos de documentos que não são iguais
Selecione todos os documentos na collection inventory onde quantity não é igual a 20. Esta query também seleciona documentos que não possuem o campo quantity:
db.inventory.find( { quantity: { $ne: 20 } } )
O equivalente SQL a esta query é:
SELECT * FROM INVENTORY WHERE QUANTITIY != 20
Atualização baseada em campos de documentos incorporados não iguais
O exemplo a seguir define o campo price com base em uma comparação $ne com um campo em um documento incorporado. A operação updateMany() procura um documento incorporado, carrier, com um subcampo chamado fee. Ela usa $set para atualizar o campo price para 9.99 em cada documento em que fee tem um valor que não é igual a 1 ou onde o subcampo fee não existe:
db.inventory.updateMany( { "carrier.fee" : { $ne: 1 } }, { $set: { "price": 9.99 } } )
O equivalente SQL a esta query é:
UPDATE INVENTORY SET PRICE = '9.99' WHERE carrierfee != 1
O operador de desigualdade $ne não é muito seletivo, pois geralmente corresponde a uma grande parte do índice. Como resultado, em muitos casos, uma query $ne com um índice pode não ter um desempenho melhor do que uma query $ne que deve verificar todos os documentos em uma collection. Consulte também Seletividade de query.