$ne

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 Criar queries seletivas.

arrays

Ao comparar arrays, $ne encontra documentos onde o array do documento é diferente do array especificado em $ne. Especificamente, $ne corresponde a qualquer um desses documentos onde os arrays:

• têm valores de elemento ou strings diferentes

• ter elementos em uma ordem diferente

• possuem um número diferente de elementos

• estão faltando em um documento

Por exemplo, a query a seguir retorna documentos inventory em que a array type é diferente de [ "hardware", "fasteners" ]:

db.inventory.find( { type: { $ne: [ "hardware", "fasteners" ] } } )

O exemplo completo a seguir adiciona um array type a dois documentos inventory e executa uma consulta com $ne:

// Update the nuts document to include a type array
db.inventory.updateOne(
   { item: "nuts" },
   { $set: { type: [ "hardware" ] } }
)
// Update the bolts document to include a type array
db.inventory.updateOne(
   { item: "bolts" },
   { $set: { type: [ "hardware", "fasteners" ] } }
)
// Find documents where the type array differs from [ "hardware", "fasteners" ]
db.inventory.find( { type: { $ne: [ "hardware", "fasteners" ] } } )

A saída exibe o documento nuts porque o array difere de [ "hardware", "fasteners" ], e o documento washers porque não possui um array type:

[
  {
    _id: ObjectId('679d26907c5a58595234305c'),
    item: 'nuts',
    quantity: 30,
    carrier: { name: 'Shipit', fee: 3 },
    type: [ 'hardware' ]
  },
  {
    _id: ObjectId('679d26907c5a58595234305e'),
    item: 'washers',
    quantity: 10,
    carrier: { name: 'Shipit', fee: 1 }
  }
]

A query a seguir inverte os elementos no array:

db.inventory.find( { type: { $ne: [ "fasteners", "hardware" ] } } )

Como o array type no documento bolts é [ "hardware", "fasteners" ], que difere de [ "fasteners", "hardware" ], a query retorna o documento bolts, além dos documentos nuts e washers:

[
   {
      _id: ObjectId('679d26907c5a58595234305c'),
      item: 'nuts',
      quantity: 30,
      carrier: { name: 'Shipit', fee: 3 },
      type: [ 'hardware' ]
   },
   {
      _id: ObjectId('679d26907c5a58595234305d'),
      item: 'bolts',
      quantity: 50,
      carrier: { name: 'Shipit', fee: 4 },
      type: [ 'hardware', 'fasteners' ]
   },
   {
      _id: ObjectId('679d26907c5a58595234305e'),
      item: 'washers',
      quantity: 10,
      carrier: { name: 'Shipit', fee: 1 }
   }
]

$ne corresponde a documentos em que o array não contém o valor especificado e a documentos que não possuem o array. Por exemplo:

db.inventory.find( { type: { $ne: "fasteners" } } )

A query retorna o documento nuts porque o array [ "hardware" ] difere de "fasteners". Além disso, a query retorna o documento washers porque o documento não possui um array type. Saída da query:

[
   {
      _id: ObjectId('679d26907c5a58595234305c'),
      item: 'nuts',
      quantity: 30,
      carrier: { name: 'Shipit', fee: 3 },
      type: [ 'hardware' ]
   },
   {
      _id: ObjectId('679d26907c5a58595234305e'),
      item: 'washers',
      quantity: 10,
      carrier: { name: 'Shipit', fee: 1 }
   }
]