Tip
MongoDB also provides the MongoDB还提供了Mongo.bulkWrite() method for performing bulk write operations.Mongo.bulkWrite()方法来执行批量写入操作。
Description描述
Bulk()Bulk operations builder used to construct a list of write operations to perform in bulk for a single collection.批量操作生成器用于构建一个写操作列表,以便对单个集合批量执行。To instantiate the builder, use either the要实例化构建器,请使用db.collection.initializeOrderedBulkOp()or thedb.collection.initializeUnorderedBulkOp()method.db.collection.initializeOrderedBulkOp()或db.collection.initializeUnorderedBulkOp()方法。
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部署的完全托管服务
Note
This command is supported in all MongoDB Atlas clusters. 所有MongoDB Atlas集群都支持此命令。For information on Atlas support for all commands, see Unsupported Commands.有关Atlas支持所有命令的信息,请参阅不支持的命令。
Ordered and Unordered Bulk Operations有序和无序批量操作
The builder can construct the list of operations as ordered or unordered.构建器可以按顺序或无序构造操作列表。
Ordered Operations有序操作
With an ordered operations list, MongoDB executes the write operations in the list serially. If an error occurs during the processing of one of the write operations, MongoDB will return without processing any remaining write operations in the list.使用有序操作列表,MongoDB按顺序执行列表中的写入操作。如果在处理其中一个写入操作时发生错误,MongoDB将返回,而不处理列表中的任何剩余写入操作。
Use 使用db.collection.initializeOrderedBulkOp() to create a builder for an ordered list of write commands.db.collection.initializeOrderedBulkOp()为写入命令的有序列表创建构建器。
When executing an 在执行ordered list of operations, MongoDB groups the operations by the operation type and contiguity; i.e. contiguous operations of the same type are grouped together. ordered操作列表时,MongoDB会根据操作类型和连续性对操作进行分组;即,将相同类型的连续操作分组在一起。For example, if an ordered list has two insert operations followed by an update operation followed by another insert operation, MongoDB groups the operations into three separate groups: first group contains the two insert operations, second group contains the update operation, and the third group contains the last insert operation. This behavior is subject to change in future versions.例如,如果一个有序列表有两个插入操作、一个更新操作和另一个插入操作,MongoDB会将这些操作分为三个单独的组:第一组包含两个插入运算,第二组包含更新运算,第三组包含最后一个插入运算。此行为在未来的版本中可能会发生变化。
Bulk() operations in mongosh and comparable methods in the drivers do not have a limit for the number of operations in a group. mongosh中的Bulk()操作和驱动程序中的类似方法对组中的操作数量没有限制。To see how the operations are grouped for bulk operation execution, call 要查看如何为批量操作执行对操作进行分组,请在执行后调用Bulk.getOperations() after the execution.Bulk.getOperations()。
Executing an 在分片集合上执行有序操作列表通常比执行ordered list of operations on a sharded collection will generally be slower than executing an unordered list since with an ordered list, each operation must wait for the previous operation to finish.unordered列表慢,因为使用ordered列表,每个操作都必须等待前一个操作完成。
Unordered Operations无序操作
With an unordered operations list, MongoDB can execute in parallel, as well as in a nondeterministic order, the write operations in the list. If an error occurs during the processing of one of the write operations, MongoDB will continue to process remaining write operations in the list.使用无序操作列表,MongoDB可以并行执行列表中的写入操作,也可以以不确定的顺序执行。如果在处理其中一个写入操作时发生错误,MongoDB将继续处理列表中的其余写入操作。
Use 使用db.collection.initializeUnorderedBulkOp() to create a builder for an unordered list of write commands.db.collection.initializeUnorderedBulkOp()为无序的写入命令列表创建构建器。
When executing an 当执行unordered list of operations, MongoDB groups the operations. unordered操作列表时,MongoDB会对操作进行分组。With an unordered bulk operation, the operations in the list may be reordered to increase performance. As such, applications should not depend on the ordering when performing 对于无序批量操作,列表中的操作可以重新排序以提高性能。因此,应用程序在执行unordered bulk operations.unordered批量操作时不应依赖于顺序。
Bulk() operations in mongosh and comparable methods in the drivers do not have a limit for the number of operations in a group. mongosh中的Bulk()操作和驱动程序中的类似方法对组中的操作数量没有限制。To see how the operations are grouped for bulk operation execution, call 要查看如何为批量操作执行对操作进行分组,请在执行后调用Bulk.getOperations() after the execution.Bulk.getOperations()。
Transactions事务
Bulk() can be used inside distributed transactions.可以在分布式事务中使用。
For 对于Bulk.insert() operations, the collection must already exist.Bulk.insert()操作,集合必须已经存在。
For 对于Bulk.find.upsert(), if the operation results in an upsert, the collection must already exist.Bulk.find.upsert(),如果操作导致异常,则集合必须已经存在。
Do not explicitly set the write concern for the operation if run in a transaction. To use write concern with transactions, see Transactions and Write Concern.如果在事务中运行,则不要显式设置操作的写入关注。要对事务使用写关注,请参阅事务和写关注。
Important
In most cases, a distributed transaction incurs a greater performance cost over single document writes, and the availability of distributed transactions should not be a replacement for effective schema design. 在大多数情况下,分布式事务比单文档写入产生更大的性能成本,分布式事务的可用性不应取代有效的模式设计。For many scenarios, the denormalized data model (embedded documents and arrays) will continue to be optimal for your data and use cases. That is, for many scenarios, modeling your data appropriately will minimize the need for distributed transactions.对于许多场景,非规范化数据模型(嵌入式文档和数组)将继续是数据和用例的最佳选择。也就是说,对于许多场景,适当地对数据进行建模将最大限度地减少对分布式事务的需求。
For additional transactions usage considerations (such as runtime limit and oplog size limit), see also Production Considerations.有关其他事务使用注意事项(如运行时限制和oplog大小限制),另请参阅生产注意事项。
Methods方法
The Bulk() builder has the following methods:Bulk()生成器有以下方法:
Bulk.insert() | |
Bulk.find() | |
Bulk.find.delete() | |
Bulk.find.deleteOne() | |
Bulk.find.remove() | Bulk.find.delete().Bulk.find.delete()的别名。 |
Bulk.find.removeOne() | Bulk.find.deleteOne().Bulk.find.deleteOne()的别名。 |
Bulk.find.replaceOne() | |
Bulk.find.updateOne() | |
Bulk.find.update() | multi update operation to a list of operations.multi更新操作添加到操作列表中。 |
Bulk.find.upsert() | upsert: true for an update operation.upsert: true。 |
Bulk.execute() | |
Bulk.getOperations() | Bulk() operations object.Bulk()操作对象中执行的写入操作数组。 |
Bulk.toJSON() | Bulk() operations object.Bulk()操作对象中的操作数和批处理数。 |
Bulk.toString() | Bulk.toJSON() results as a string.Bulk.toJSON()结果。 |