$ne

Esta versão da documentação foi arquivada e não é mais suportada. Para atualizar seu sistema do 5.0, consulte osprocedimentos de atualização do MongoDB 6.0 .

Definição

$ne

$ne seleciona 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 o pedido de comparação de BSON especificado.

Compatibilidade

Você pode utilizar o $ne para implantações hospedadas 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

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 coleção 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 } } )

{
 _id: ObjectId("61ba667dfe687fce2f042420"),
 item: 'nuts',
 quantity: 30,
 carrier: { name: 'Shipit', fee: 3 }
},
{
 _id: ObjectId("61ba667dfe687fce2f042421"),
 item: 'bolts',
 quantity: 50,
 carrier: { name: 'Shipit', fee: 4 }
},
{
 _id: ObjectId("61ba667dfe687fce2f042422"),
 item: 'washers',
 quantity: 10,
 carrier: { name: 'Shipit', fee: 1 }
}

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 } }
)

{
 _id: ObjectId("61ba66e2fe687fce2f042423"),
 item: 'nuts',
 quantity: 30,
 carrier: { name: 'Shipit', fee: 3 },
 price: 9.99
},
{
 _id: ObjectId("61ba66e2fe687fce2f042424"),
 item: 'bolts',
 quantity: 50,
 carrier: { name: 'Shipit', fee: 4 },
 price: 9.99
},
{
 _id: ObjectId("61ba66e2fe687fce2f042425"),
 item: 'washers',
 quantity: 10,
 carrier: { name: 'Shipit', fee: 1 }
}

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.

Saiba mais

Voltar

$lte

$nin