MongoDB $addToSet

V MongoDB, $addToSet operátor přidá hodnotu do pole, pokud hodnota již v poli není přítomna.

Je to podobné jako $push operátor, kromě $push přidá hodnotu, i když je již přítomna.

Příklad

Předpokládejme, že máme kolekci nazvanou products s následujícími dokumenty:

db.products.find()

Výsledek:

{ "_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" ] }

Můžeme použít $addToSet k připojení hodnoty k jednomu z těchto polí.

Příklad:

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

Výstup:

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

Pojďme se znovu podívat na naši sbírku a ověřit změnu:

db.products.find()

Výsledek:

{ "_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" ] }

Duplicitní hodnoty

Pokud se pokusíte vložit hodnotu, která již v poli existuje, nic se nestane. Jinými slovy, $addToSet pouze vloží hodnotu, pokud ještě neexistuje.

Zde je příklad pokusu o vložení hodnoty, která již existuje.

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

Výstup:

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

Tato zpráva nám říká, že existuje jeden odpovídající dokument (tj. dokument s _id z 1 ), ale nedošlo k žádným úpravám.

V předchozím příkladu jsme viděli "nModified" : 1 , ale v tomto příkladu vidíme "nModified" : 0 . Je to proto, že hodnota neexistovala, když jsme ji vložili do předchozího příkladu, ale v tomto příkladu již existuje.

Můžeme si to ověřit, když se znovu podíváme na sbírku:

db.products.find()

Výsledek:

{ "_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" ] }

Přidat více hodnot

Můžete použít $each modifikátor pro připojení více hodnot k poli.

Příklad:

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

Výstup:

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

Nyní znovu zkontrolujeme sbírku:

db.products.find()

Výsledek:

{ "_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" ] }

Vidíme, že tyto dvě hodnoty byly připojeny k poli v dokumentu 2 podle očekávání.

Přidat pole do pole

K poli můžete také připojit celé pole. Když to uděláte, celé pole se připojí jako vlastní samostatné pole.

Předpokládejme, že máme sbírku jako je tato:

db.foo.find()

Výsledek:

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

Pole můžeme připojit k poli takto:

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

Výstup:

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

Zkontrolujte sbírku:

db.foo.find()

Výsledek:

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