MongoDB\ClientBulkWrite::createWithCollection()

定义

MongoDB\ClientBulkWrite::createWithCollection()

从提供的MongoDB\ClientBulkWriteMongoDB\Collection 实例创建 构建器的实例。您可以向ClientBulkWrite 添加写入操作，以创建库发送到服务器的新 BulkWriteCommand 。

function createWithCollection(
    Collection $collection,
    array $options = []
): self

参数

$collection : MongoDB\Collection

要设立为批量写入操作目标的 Collection实例。

$options : array

指定所需选项的数组。

名称	类型	说明
bypassDocumentValidation	布尔	如果为 true：写入操作会忽略文档级验证。 默认为 false。
comment	混合	使用户可以指定任意注释来帮助通过数据库分析器、currentOp 输出和日志来跟踪操作。
let	数组|对象	参数名称和值的映射。值必须是常量或不引用文档字段的封闭表达式。然后可以在聚合表达式上下文中将参数作为变量进行访问（例如 $$var）。 MongoDB 服务器 6.0 及更早版本不支持此功能。如果使用，服务器将在执行时返回异常。
ordered	布尔	如果为 true：当单次写入失败时，操作将停止，而不执行剩余的写入，并抛出异常。 如果为 false：当单次写入失败时，该操作将继续执行剩余的写入（如果有），并引发异常。 默认为 true。
verboseResults	布尔	指定是否返回详细结果。 默认为 false。

Return Values

一个新的 ClientBulkWrite实例，其 BulkWriteCommand 规范为空。

错误/异常

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

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

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

另请参阅

• 批量写入操作指南的客户端批量写入部分