MongoDB $addToSet

In MongoDB, de $addToSet operator voegt een waarde toe aan een array, tenzij de waarde al aanwezig is in de array.

Het is vergelijkbaar met de $push operator, behalve dat $push voegt de waarde toe, zelfs als de waarde al aanwezig is.

Voorbeeld

Stel dat we een verzameling hebben met de naam products met de volgende documenten:

db.products.find()

Resultaat:

{ "_id" : 1, "product" : "Bat", "sizes" : [ "S", "M", "L" ] }
{ "_id" : 2, "product" : "Hat", "sizes" : [ "S", "L", "XL" ] }
{ "_id" : 3, "product" : "Cap", "sizes" : [ "S", "M", "L", "XL" ] }

We kunnen $addToSet . gebruiken om een ​​waarde aan een van die arrays toe te voegen.

Voorbeeld:

db.products.update(
   { _id: 1 },
   { $addToSet: { sizes: "XL" } }
)

Uitgang:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

Laten we onze collectie nog eens bekijken om de wijziging te verifiëren:

db.products.find()

Resultaat:

{ "_id" : 1, "product" : "Bat", "sizes" : [ "S", "M", "L", "XL" ] }
{ "_id" : 2, "product" : "Hat", "sizes" : [ "S", "L", "XL" ] }
{ "_id" : 3, "product" : "Cap", "sizes" : [ "S", "M", "L", "XL" ] }

Dubbele waarden

Als u een waarde probeert in te voegen die al in de array bestaat, gebeurt er niets. Met andere woorden, $addToSet voegt de waarde alleen in als deze nog niet bestaat.

Hier is een voorbeeld van een poging om een ​​waarde in te voegen die al bestaat.

db.products.update(
   { _id: 1 },
   { $addToSet: { sizes: "XL" } }
)

Uitgang:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 0 })

Dit bericht vertelt ons dat er één overeenkomend document was (d.w.z. het document met een _id van 1 ), maar er waren geen wijzigingen.

In het vorige voorbeeld zagen we "nModified" : 1 , maar in dit voorbeeld zien we "nModified" : 0 . Dat komt omdat de waarde niet bestond toen we deze in het vorige voorbeeld invoegden, maar in dit voorbeeld wel.

We kunnen dit verifiëren door de collectie opnieuw te bekijken:

db.products.find()

Resultaat:

{ "_id" : 1, "product" : "Bat", "sizes" : [ "S", "M", "L", "XL" ] }
{ "_id" : 2, "product" : "Hat", "sizes" : [ "S", "L", "XL" ] }
{ "_id" : 3, "product" : "Cap", "sizes" : [ "S", "M", "L", "XL" ] }

Meerdere waarden toevoegen

U kunt de $each . gebruiken modifier om meerdere waarden aan een array toe te voegen.

Voorbeeld:

db.products.update(
   { _id: 2 },
   { 
     $addToSet: { 
        sizes: {
           $each: [ "XXL", "XXXL" ]
        }
      } 
    }
)

Uitgang:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

Laten we nu de collectie nog eens bekijken:

db.products.find()

Resultaat:

{ "_id" : 1, "product" : "Bat", "sizes" : [ "S", "M", "L", "XL" ] }
{ "_id" : 2, "product" : "Hat", "sizes" : [ "S", "L", "XL", "XXL", "XXXL" ] }
{ "_id" : 3, "product" : "Cap", "sizes" : [ "S", "M", "L", "XL" ] }

We kunnen zien dat de twee waarden zoals verwacht aan de array in document 2 zijn toegevoegd.

Een array aan de array toevoegen

U kunt ook een hele array aan de array toevoegen. Wanneer u dit doet, wordt de hele array toegevoegd als zijn eigen afzonderlijke array.

Stel dat we een collectie hebben zoals deze:

db.foo.find()

Resultaat:

{ "_id" : 1, "bar" : [ 1, 5, 3 ] }
{ "_id" : 2, "bar" : [ 8, 17, 18 ] }
{ "_id" : 3, "bar" : [ 15, 11, 8 ] }

We kunnen een array als volgt aan een array toevoegen:

db.foo.update(
   { _id: 1 },
   { $addToSet: { bar: [ 7, 8, 9] } }
)

Uitgang:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

Bekijk de collectie:

db.foo.find()

Resultaat:

{ "_id" : 1, "bar" : [ 1, 5, 3, [ 7, 8, 9 ] ] }
{ "_id" : 2, "bar" : [ 8, 17, 18 ] }
{ "_id" : 3, "bar" : [ 15, 11, 8 ] }