/ /

/ /

MongoDB\Client::bulkWrite()

2.1版本新增。

定义

MongoDB\Client::bulkWrite()

跨多个命名空间执行多个写入操作。

function bulkWrite(
    BulkWriteCommand|ClientBulkWrite $bulk,
    array $options = []
): MongoDB\BulkWriteCommandResult

参数

$bulk ：MongoDB\ClientBulkWrite 或

BulkWriteCommand

提示

首选 ClientBulkWrite API

我们建议使用 ClientBulkWrite 构建器类和方法在批量写入命令中指定写入操作，而不是使用 BulkWriteCommand 类。ClientBulkWrite 提供了一个 Fluent API ，其中包含与 MongoDB\Collection 类中的增删改查方法类似的方法。

表示已组装的批量写入命令或构建器。MongoDB\Client::bulkWrite() 支持 deleteMany()、deleteOne()、insertOne()、replaceOne()、updateMany() 和 updateOne() 操作。

$options : array

指定所需选项的数组。

名称	类型	说明
会话	MongoDB\Driver\Session	与操作相关联的客户端会话。
writeConcern	MongoDB\Driver\WriteConcern	写关注用于操作。默认为集合的写关注。无法将单个操作的写关注（write concern）指定为ACID 事务的一部分。相反，请在启动ACID 事务时设立`writeConcern` 选项。

Return Values

一个MongoDB\BulkWriteCommandResult对象。

错误/异常

MongoDB\Exception\UnsupportedException，如果所选服务器使用了选项但不支持选项（例如collation、readConcern、writeConcern）。

MongoDB\Exception\InvalidArgumentException 用于与参数或选项解析相关的错误。

MongoDB\ 驱动程序\Exception\RuntimeException 用于扩展级别的其他错误（例如连接错误）。

MongoDB\ 驱动程序\Exception\BulkWriteCommandException 以了解与写入操作相关的错误。您可以检查 getWriteErrors() 返回的值，以确定错误的性质。

行为

如果引发MongoDB\ 驱动程序\Exception\BulkWriteCommandException，您可以调用getWriteErrors() 并检查返回大量中的信息，以确定错误的性质。

示例，写入操作可能已成功应用于主节点 (primary node in the replica set)服务器，但未能满足写关注（write concern）。或者，写入操作可能彻底失败，示例由于违反了唯一键约束。

对于批量写入，结果可能表明多个写入操作成功和/或出错。如果 ordered 选项为 true，则在遇到第一个错误和抛出异常之前，某些操作可能已成功。如果 ordered 选项为 false，则可能遇到多个错误。

另请参阅

后退

addSubscriber()

来年

createClientEncryption()