32.MongoDB替换更新

30.MongoDB首条更新

---

30.1 知识点

MongoDB updateOne

updateOne 是 MongoDB 中用于更新集合中匹配的第一条文档的操作。如果查询条件匹配到多条文档，它只会更新第一条文档。

语法

db.collection.updateOne(
   <filter>,          // 查询条件，用于匹配文档
   <update>,          // 更新操作符或替换文档
   {
      // 可选，默认为 false。如果为 true，则会在没有匹配文档时插入一条新文档。
      upsert: <boolean>,    
      writeConcern: <document>,  // 可选，用于指定写入的确认级别
      collation: <document>      // 可选，用于指定排序规则
   }
)

• <filter>: 查询条件，用于匹配需要更新的文档。
• <update>: 更新操作，可以使用更新操作符（如 $set, $inc）或直接替换整个文档。
• upsert: 如果设置为 true，当没有匹配到任何文档时，会创建一条新文档。
• writeConcern: 写入确认配置。
• collation: 指定字符串比较规则（如大小写敏感性、语言环境等）。

场景

• 部分字段更新：当需要更新文档中的某些字段时，比如修改用户的邮箱、状态等。
• 计数器更新：如对访问量、库存数量等字段进行递增或递减操作。
• 条件更新：只更新匹配特定条件的文档。
• 插入或更新（Upsert）：如果文档不存在，则插入新文档；如果存在，则更新。

示例

使用 $set 更新字段

假设我们有一个集合 users，文档如下：

db.users.insertOne(
   { "_id": 1, "name": "Alice", "age": 25, "email": "alice@example.com" }
)

更新 age 字段为 26：

db.users.updateOne(
   { "name": "Alice" },       // 查询条件
   { $set: { "age": 26 } }    // 更新操作
)

执行后，文档变为：

{ "_id": 1, "name": "Alice", "age": 26, "email": "alice@example.com" }

添加新字段

为文档添加一个新字段 status，值为 "active"：

db.users.updateOne(
   { "name": "Alice" },       // 查询条件
   { $set: { "status": "active" } } // 更新操作
)

执行后，文档变为：

{ "_id": 1, "name": "Alice", "age": 26, "email": "alice@example.com", "status": "active" }

递增字段值（计数器）

假设我们有一个集合 users，文档如下：

db.users.insertOne(
   { "_id": 2, "name": "top", "age": 50 }
)

将 age 减少 5：

db.users.updateOne(
   { "name": "top" },       // 查询条件
   { $inc: { "age": -5 } }   // 递增操作
)

执行后，文档变为：

{ "_id": 2, "name": "top", "age": 45 }

使用 $unset 删除字段

删除文档中的 email 字段：

db.users.updateOne(
   { "name": "Alice" },       // 查询条件
   { $unset: { "email": "" } } // 删除字段
)

执行后，文档变为：

{ "_id": 1, "name": "Alice", "age": 26, "status": "active" }

使用 upsert 插入或更新

假设我们尝试更新一个不存在的文档。如果文档不存在，就插入一条新文档。

db.users.updateOne(
   { "name": "Bob" },         // 查询条件
   { $set: { "age": 30, "email": "bob@example.com" } }, // 更新操作
   { upsert: true }           // 启用 upsert
)

如果 name 为 "Bob" 的文档不存在，会插入新文档：

{ "_id": ObjectId("..."), "name": "Bob", "age": 30, "email": "bob@example.com" }

注意事项

1. 只更新第一条匹配文档：

   • 如果查询条件匹配到多条文档，updateOne 仅会更新第一条。
   • 如果需要更新所有匹配文档，使用 updateMany。

2. upsert 的使用：

   • upsert 插入的新文档会包含查询条件中指定的字段和更新操作符的字段。
   • 如果查询条件中使用了 $ 操作符（如 $gte），则不会被插入到新文档中。

3. 安全性：

   • 如果查询条件过于宽泛，可能会意外更新错误的文档。
   • 在生产环境中，建议先使用 find() 检查查询条件是否匹配到正确的文档。

4. 字段操作符的优先级：

   • 如果同时使用 $set 和 $unset 操作符，$unset 会移除字段，而 $set 会重新添加字段。

5. 性能：

   • 如果没有索引支持，查询条件可能会导致全集合扫描（Collection Scan），从而影响性能。
   • 为常用的查询字段创建索引。

总结

• updateOne 是 MongoDB 中最常用的更新操作之一，用于更新匹配的第一条文档。
• 支持多种更新操作符，如 $set（设置字段）、$inc（递增字段）、$unset（删除字段）等。
• 可以通过 upsert 实现插入或更新，在文档不存在时自动插入新文档。
• 使用时需注意查询条件的范围，避免意外更新其他文档。

---

---

转载请注明来源，欢迎对文章中的引用来源进行考证，欢迎指出任何有错误或不够清晰的表达。可以在下面评论区评论，也可以邮件至 785293209@qq.com