修改文档

更新文档模式

在 MongoDB 中，所有更改文档的方法都遵循相同的模式

这些方法接受以下参数

• 一个查询过滤器，用于匹配一个或多个要更改的文档

• 一个更新文档，指定字段和值更改

Rust 驱动程序提供了以下更改文档的方法

• update_one()

• update_many()

• replace_one()

您可以通过使用复合操作在一次操作中检索和修改数据。有关更多信息，请参阅有关复合操作.

《_id》字段

在MongoDB的集合中，每个文档都有一个唯一且不可变的_id字段。如果您尝试通过更新或替换操作更改_id字段，驱动程序将抛出WriteError异常，并且不会执行任何更新。

参数

每个方法都接受一个查询筛选器和至少包含一个更新运算符的更新文档。更新运算符指定要执行更新的类型，并包含描述更改的字段和值。更新文档使用以下格式

doc! { "<update operator>": doc! { "<field>": <value> } }

要在单个更新文档中指定多个更新，请使用以下格式

doc! {
    "<update operator>": doc!{"<field>": <value>},
    "<update operator>": doc!{"<field>": <value>},
    ...
}

有关更新运算符和描述的完整列表，请参阅MongoDB服务器手册：更新运算符和描述列表。

返回值

update_one() 和 update_many() 方法在操作成功时返回一个 UpdateResult 类型。该 UpdateResult 类型包含以下属性，用于描述操作

如果多个文档与您传递给 UpdateOne() 的查询过滤器匹配，则方法选择并更新第一个匹配的文档。如果没有文档与查询过滤器匹配，则更新操作不会进行任何更改。

更新示例

以下文档描述了某公司的员工

{
  "_id": ObjectId('4337'),
  "name": "Shelley Olson",
  "department": "Marketing",
  "role": "Director",
  "bonus": 3000
},
{
  "_id": ObjectId('4902'),
  "name": "Remi Ibrahim",
  "department": "Marketing",
  "role": "Consultant",
  "bonus": 1800
}

此示例使用 update_many() 方法执行更新操作。该 update_many() 方法需要以下参数

• 一个查询过滤器，以匹配 department 字段值为 "Marketing" 的文档

• 一个包含以下更新的更新文档

  • 一个 $set 运算符，用于将 department 的值更改为 "Business Operations" 并将 role 更改为 "Analytics Specialist"

  • 一个用于增加bonus值的$inc运算符，增加量为500

let update_doc = doc! {
        "$set": doc! { "department": "Business Operations",
                      "role": "Analytics Specialist" },
        "$inc": doc! { "bonus": 500 }
};
let res = my_coll
    .update_many(doc! { "department": "Marketing" }, update_doc)
    .await?;
println!("Modified documents: {}", res.modified_count);

Modified documents: 2

以下文档反映了先前更新操作的结果变化

{
  "_id": ObjectId('4337'),
  "name": "Shelley Olson",
  "department": "Business Operations",
  "role": "Analytics Specialist",
  "bonus": 3500
},
{
  "_id": ObjectId('4902'),
  "name": "Remi Ibrahim",
  "department": "Business Operations",
  "role": "Analytics Specialist",
  "bonus": 2300
}

按ObjectId更新示例

以下文档描述了一家公司的员工

{
  "_id": ObjectId('4274'),
  "name": "Jill Millerton",
  "department": "Marketing",
  "role": "Consultant"
}

此示例通过指定一个查询过滤器来匹配文档的唯一_id值来查询前面的文档。然后，代码使用update_one()方法执行更新操作。update_one()方法接受以下参数

• 查询过滤器匹配一个_id字段值为ObjectId('4274')的文档

• 更新文档，创建将name字段的值设置为"Jill Gillison"的指令

let id = ObjectId::from_str("4274").expect("Could not convert to ObjectId");
let filter_doc = doc! { "_id": id };
let update_doc = doc! {
        "$set": doc! { "name": "Jill Gillison" }
};
let res = my_coll
    .update_one(filter_doc, update_doc)
    .await?;
println!("Modified documents: {}", res.modified_count);

Modified documents: 1

以下文档反映了先前更新操作的结果变化

{
  "_id": ObjectId('4274'),
  "name": "Jill Gillison",
  "department": "Marketing",
  "role": "Consultant"
}

参数

replace_one() 方法接受一个查询过滤器和一份 替换文档，其中包含将替换现有文档的字段和值。替换文档使用以下格式

doc! { "<field>": <value>, "<field>": <value>, ... }

返回值

replace_one 方法在操作成功时返回一个 UpdateResult 类型。该类型包含以下属性，用于描述操作

如果您传递给 replace_one() 的查询过滤器匹配多个文档，则该方法将选择并替换第一个匹配的文档。如果没有文档匹配查询过滤器，替换操作不会进行任何更改。

替换示例

以下文档描述了一家公司的员工

{
  "_id": ObjectId('4501'),
  "name": "Matt DeGuy",
  "role": "Consultant",
  "team_members": [ "Jill Gillison", "Susan Lee" ]
}

此示例使用 replace_one() 方法用以下字段替换前面的文档

• 一个 name 值为 "Susan Lee"

• 一个 role 值为 "Lead Consultant"

• 一个 team_members 值为 [ "Jill Gillison" ]

let replace_doc = doc! {
    "name": "Susan Lee",
    "role": "Lead Consultant",
    "team_members": vec! [ "Jill Gillison" ]
};
let res = my_coll
    .replace_one(doc! { "name": "Matt DeGuy" }, replace_doc)
    .await?;
println!(
    "Matched documents: {}\nModified documents: {}",
    res.matched_count, res.modified_count
);

Matched documents: 1
Modified documents: 1

替换的文档包含替换文档的内容和不可变的 _id 字段

{
  "_id": ObjectId('4501'),
  "name": "Susan Lee",
  "role": "Lead Consultant",
  "team_members": [ "Jill Gillison" ]
}

API 文档

要了解更多关于本指南中提到的方法和类型，请参阅以下API文档

• update_one()

• update_many()

• 更新结果

• 更新选项

• replace_one()

• 替换选项

• 写入错误