Docs 菜单
Docs 主页
/ / /
Node.js
/ /

替换文档

您可以使用.replaceOne()集合 替换单个文档方法。 replaceOne()接受查询文档和替换文档。 如果该查询与集合中的某个文档匹配,则会用所提供的替换文档替换与该查询匹配的第一个文档。 此操作会删除原始文档中的所有字段和值,并将其替换为替换文档中的字段和值。 除非您在替换文档中明确指定新的_id值,否则_id字段的值保持不变。

您可以使用可选的 options 参数来指定其他选项,例如 upsert。如果将 upsert 选项字段设置为 true,该方法会在没有文档匹配查询的情况下插入一个新文档。

如果在执行过程中发生错误,replaceOne() 方法会抛出异常。例如,如果您指定的值违反了唯一索引规则,replaceOne() 会抛出 duplicate key error

注意

如果您的应用程序在更新后需要该文档,请使用 collection.findOneAndReplace()方法,其接口与replaceOne()类似。 您可以将findOneAndReplace()配置为返回原始匹配文档或替换文档。

注意

可以使用此示例连接到 MongoDB 实例,并与包含样本数据的数据库进行交互。如需了解有关连接到 MongoDB 实例和加载样本数据集的更多信息,请参阅使用示例指南

运行前一示例应能看到以下输出:

Modified 1 document(s)
← 更新多个文档