修改文档

更新文档模式

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

这些方法采用以下参数：

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

• 指定字段和值更改的更新文档

• （可选）用于修改方法默认行为的选项类型

Rust 驱动程序提供以下方法来更改文档：

• update_one()

• update_many()

• replace_one()

您可以使用复合操作在一个操作中检索和修改数据。要了解更多信息，请参阅复合操作指南。

_id 字段

MongoDB collection中的每个文档都有一个唯一且不可变的_id字段。如果您尝试通过更新或替换操作更改_id字段，驱动程序将引发WriteError并且不会执行更新。

参数

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

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

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

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

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

更新操作还采用UpdateOptions参数。 要了解如何修改更新方法的行为，请参阅本指南的修改更新和替换行为部分。

返回值

如果操作成功， 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"

  • $inc操作符，用于将bonus的值增加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, None)
    .await?;
println!("Modified documents: {}", res.modified_count);

以下文档反映了前面的更新操作所产生的更改：

{
  "_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, None)
    .await?;
println!("Modified documents: {}", res.modified_count);

以下文档反映了上述更新操作导致的变更：

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

参数

replace_one()方法采用查询筛选器和替换文档，其中包含将替换现有文档的字段和值。 替换文档使用以下格式：

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

替换操作还采用UpdateOptions参数。要了解如何修改replace_one()方法的行为，请参阅本指南的修改更新和替换行为部分。

返回值

如果操作成功， replace_one方法会返回UpdateResult类型。 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, None)
    .await?;
println!(
    "Matched documents: {}\nModified documents: {}",
    res.matched_count, res.modified_count
);

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

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

API 文档

要进一步了解本指南所提及的方法和类型，请参阅以下 API 文档：

• update_one()

• update_many()

• UpdateResult

• UpdateOptions

• replace_one()

• ReplaceOptions

• WriteError