$nin (original) (raw)

$nin

$nin selects the documents where:

the specified field value is not in the specified array or
the specified field does not exist.

You can use $nin for deployments hosted in the following environments:

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud
MongoDB Enterprise: The subscription-based, self-managed version of MongoDB
MongoDB Community: The source-available, free-to-use, and self-managed version of MongoDB

The $nin operator has the following form:


{ field: { $nin: [ <value1>, <value2> ... <valueN> ] } }

If the field holds an array, then the $nin operator selects the documents whose field holds an array with no element equal to a value in the specified array (for example, <value1>,<value2>, and so on).

For comparison of different BSON type values, see the specified BSON comparison order.

Create the inventory collection:


db.inventory.insertMany( [

   { "item": "Pens", "quantity": 350, "tags": [ "school", "office" ] },

   { "item": "Erasers", "quantity": 15, "tags": [ "school", "home" ] },

   { "item": "Maps", "tags": [ "office", "storage" ] },

   { "item": "Books", "quantity": 5, "tags": [ "school", "storage", "home" ] }

] )

The following query selects all documents from the inventorycollection where the quantity does not equal either 5 or 15.

The query also matches documents that do not have a quantityfield.


db.inventory.find( { quantity: { $nin: [ 5, 15 ] } }, { _id: 0 } )

Example output:


{ item: 'Pens', quantity: 350, tags: [ 'school', 'office' ] },

{ item: 'Maps', tags: [ 'office', 'storage' ] }

Set the exclude field to true for documents that don't have the"school" tag.


db.inventory.updateMany(

    { tags: { $nin: [ "school" ] } },

    { $set: { exclude: true } }

)

updateMany() also selects a document when the document does not contain the field $nin is matching on.

The inequality operator $nin is not very selective since it often matches a large portion of the index. As a result, in many cases, a $nin query with an index may perform no better than a $nin query that must scan all documents in a collection. See also Query Selectivity.