/ /

/ /

$setOnInsert（更新操作符）

定义

$setOnInsert

如果使用更新或插入（upsert） : true 的更新操作导致插入文档，则$setOnInsert 会将指定值分配给文档中的字段。如果更新操作未导致插入，则$setOnInsert 不会执行任何操作。

您可以指定 upsert 选项用于：

db.collection.updateOne(
   <query>,
   { $setOnInsert: { <field1>: <value1>, ... } },
   { upsert: true }
)

要在嵌入式文档或数组中指定 <field>，请使用点符号。

从 MongoDB 5.0 开始，更新操作符按字典顺序处理具有基于字符串的名称的文档字段。具有数字名称的字段按数字顺序处理。详情请参阅更新操作符行为。

从MongoDB5.0 开始，当您将等更新操作符符与空操作数表达式()mongod $setOnInsert一起使用时，{ } 不再引发错误。空更新不会导致任何更改，也不会创建oplog条目（意味着该操作为“不操作”）。

products 集合不包含任何文档。

db.products.updateOne(
  { _id: 1 },
  {
     $set: { item: "apple" },
     $setOnInsert: { defaultQty: 100 }
  },
  { upsert: true }
)

MongoDB使用<query> 通过创建新文档。_id: 1 $setOnInsert按指定方式更新文档。

products 集合包含新插入的文档：

{ "_id" : 1, "item" : "apple", "defaultQty" : 100 }

如果db.collection.updateOne()与现有文档匹配，MongoDB 只应用$set操作。