MongoDB\Client::bulkWrite()

2.1版本新增。

定义

MongoDB\Client::bulkWrite()

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

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

我们建议使用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	写关注用于操作。默认为集合的写关注。无法将单个操作的写关注指定为事务的一部分。相反，请在`writeConcern` 启动事务时设置选项。

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

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

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

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

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

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

后退

addSubscriber()

来年

createClientEncryption()