替换文档
此版本的文档已存档,不再提供支持。 查看最新文档,了解如何升级您的 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)