MongoDB $ addToSet

MongoDBでは、$addToSet 値がすでに配列に存在しない限り、演算子は配列に値を追加します。

$pushに似ています $pushを除く演算子値がすでに存在する場合でも、値を追加します。

例

productsというコレクションがあるとします。次のドキュメントを使用：

db.products.find()

結果：

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

$addToSetを使用できますそれらの配列の1つに値を追加します。

例：

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

出力：

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

コレクションをもう一度見て、変更を確認しましょう：

db.products.find()

結果：

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

重複する値

配列にすでに存在する値を挿入しようとしても、何も起こりません。つまり、$addToSet 値がまだ存在しない場合にのみ値を挿入します。

すでに存在する値を挿入しようとする例を次に示します。

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

出力：

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

このメッセージは、一致するドキュメントが1つあったことを示しています（つまり、_idを持つドキュメント） 1の）、ただし変更はありませんでした。

前の例では、"nModified" : 1を見ました。、ただし、この例では、"nModified" : 0が表示されます。。これは、前の例で値を挿入したときに値が存在しなかったためですが、この例ではすでに存在しています。

コレクションをもう一度見ると、これを確認できます：

db.products.find()

結果：

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

複数の値を追加

$eachを使用できます配列に複数の値を追加する修飾子。

例：

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

出力：

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

それでは、コレクションをもう一度確認しましょう：

db.products.find()

結果：

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

ドキュメント2の配列に2つの値が期待どおりに追加されていることがわかります。

アレイをアレイに追加する

配列全体を配列に追加することもできます。これを行うと、配列全体が独自の個別の配列として追加されます。

次のようなコレクションがあるとします。

db.foo.find()

結果：

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

次のように配列を配列に追加できます：

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

出力：

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

コレクションを確認してください：

db.foo.find()

結果：

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