/ /

Update Documents

Overview

在本指南中，您可以学习如何使用C++驱动程序更新MongoDB集合中的文档。您可以调用 update_one() 方法更新单个文档，也可以调用 update_many() 方法更新多个文档。

样本数据

本指南中的示例使用Atlas示例数据集的sample_restaurants数据库中的restaurants集合。要从C++应用程序访问权限此集合，请实例化一个连接到Atlas 集群的mongocxx::client ，并将以下值分配给db和collection变量：

auto db = client["sample_restaurants"];
auto collection = db["restaurants"];

要学习如何创建免费的MongoDB Atlas 集群并加载示例数据集，请参阅MongoDB 入门指南。

更新操作

您可以使用以下方法在 MongoDB 中执行更新操作：

update_one()，更新匹配搜索条件的第一个文档
update_many()，更新与搜索条件匹配的所有文档

每种更新方法都需要以下参数：

查询过滤文档：指定要更新的文档。有关查询筛选器的更多信息，请参阅MongoDB Server手册中的查询筛选器文档部分。
更新文档：指定更新操作符或要执行的更新类型，以及要更改的字段和值。有关更新操作符及其用法的列表，请参阅MongoDB Server手册中的字段更新操作符指南。

更新一个文档

以下示例使用update_one()方法将restaurants集合中某一文档的name值从"Bagels N Buns"更新为"2 Bagels 2 Buns" ：

auto query_filter = make_document(kvp("name", "Bagels N Buns"));
auto update_doc = make_document(kvp("$set", make_document(kvp("name", "2 Bagels 2 Buns"))));
auto result = collection.update_one(query_filter.view(), update_doc.view());

更新多个文档

以下示例使用update_many()方法更新cuisine值为"Pizza"的所有文档。更新后，文档的cuisine值为"Pasta" 。

auto query_filter = make_document(kvp("cuisine", "Pizza"));
auto update_doc = make_document(kvp("$set", make_document(kvp("cuisine", "Pasta"))));
auto result = collection.update_many(query_filter.view(), update_doc.view());

自定义更新操作

您可以通过将mongocxx::options::update类的实例作为可选参数传递来修改update_one()和update_many()方法的行为。下表描述了您可以在mongocxx::options::update实例中设立的字段：

字段	说明
`upsert`	指定在没有文档与查询过滤匹配的情况下，更新操作是否执行更新或插入（upsert）操作。有关更多信息，请参阅MongoDB Server手册中的更新或插入（upsert）声明。默认为 `false`。
`bypass_document_validation`	指定更新操作是否绕过文档验证。这样，您就可以更新不符合模式验证要求的文档（如果存在）。有关模式验证的更多信息，请参阅MongoDB Server手册中的模式验证。默认为 `false`。
`collation`	指定对结果进行排序时要使用的语言排序规则类型。有关更多信息，请参阅 MongoDB Server 手册中的排序规则。
`array_filters`	指定如果操作修改大量字段，则更新应用于哪些大量元素。
`hint`	设置扫描文档的索引。有关更多信息，请参阅MongoDB Server手册中的提示声明。
`write_concern`	设置操作的写关注（write concern）。有关更多信息，请参阅MongoDB Server手册中的写关注。
`let`	指定包含值列表的文档，以提高操作的可读性。值必须是常量或不引用文档字段的闭合表达式。有关更多信息，请参阅MongoDB Server手册中的 let声明。
`comment`	要附加到操作的注释。有关更多信息，请参阅 MongoDB Server 手册中的插入命令字段指南。

以下示例使用 update_many() 方法查找 borough 值为 "Manhattan" 的所有文档。然后，它将这些文档中的 borough 值更新为 "Manhattan (north)"。由于 upsert 选项设立为 true，因此，如果查询筛选条件与任何现有文档都不匹配， C++驱动程序将插入一个新文档。

mongocxx::options::update opts{};
opts.upsert(true);
auto query_filter = make_document(kvp("borough", "Manhattan"));
auto update_doc = make_document(kvp("$set", make_document(kvp("borough", "Manhattan (north)"))));
auto result = collection.update_many(query_filter.view(), update_doc.view(), opts);

返回值

update_one()和update_many()方法返回mongocxx::result::update类的实例。该类包含以下成员函数：

function	说明
`matched_count()`	返回与查询过滤匹配的文档数，无论有多少文档已更新。
`modified_count()`	返回更新操作修改的文档数。如果更新后的文档与原始文档相同，则不计入此计数。
`result()`	返回操作的原始结果文档。
`upserted_count()`	返回已更新或插入到数据库中的文档数。
`upserted_id()`	如果驱动程序执行了更新或插入（upsert），则返回在数据库中更新或插入的文档的ID。

以下示例使用update_many()方法将匹配文档的name字段从"Dunkin' Donuts"更新为"Dunkin'" 。它调用modified_count()成员函数来打印已修改文档的数量：

auto query_filter = make_document(kvp("name", "Dunkin' Donuts"));
auto update_doc = make_document(kvp("$set", make_document(kvp("name", "Dunkin'"))));
auto result = collection.update_many(query_filter.view(), update_doc.view());
std::cout << "Modified documents: " << result->modified_count() << std::endl;

Modified documents: 206