Bulk.find.replaceOne() (mongosh method方法)

Description描述

Bulk.find.replaceOne(<document>)

Adds a single document replacement operation to a bulk operations list. Use the Bulk.find() method to specify the condition that determines which document to replace. The Bulk.find.replaceOne() method limits the replacement to a single document.将单个文档替换操作添加到批量操作列表中。使用Bulk.find()方法指定确定替换哪个文档的条件。Bulk.find.replaceOne()方法将替换限制为单个文档。

Bulk.find.replaceOne() accepts the following parameter:接受以下参数：

Parameter参数	Type类型	Description描述
replacement	document文档	A replacement document that completely replaces the existing document. Contains only field and value pairs.完全替换现有文档的替换文档。仅包含字段和值对。 The sum of the associated <query> document from the Bulk.find() and the replacement document must be less than or equal to the maximum BSON document size.来自Bulk.find()的关联<query>文档和替换文档的总和必须小于或等于BSON文档的最大大小。

To specify an upsert for this operation, see Bulk.find.upsert().要为此操作指定upsert，请参阅Bulk.find.upsert()。

To specify the index to use for the associated Bulk.find(), see Bulk.find.hint().要指定用于关联的Bulk.find()的索引，请参阅Bulk.find.hint()。

Compatibility兼容性

This command is available in deployments hosted in the following environments:此命令在以下环境中托管的部署中可用：

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud：云中MongoDB部署的完全托管服务

Example示例

The following example initializes a Bulk() operations builder for the items collection, and adds various replaceOne() operations to the list of operations.以下示例初始化items集合的Bulk()操作生成器，并将各种replaceOne()操作添加到操作列表中。

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( { item: "abc123" } ).replaceOne( { item: "abc123", status: "P", points: 100 } );
bulk.execute();