MongoDB\ClientBulkWrite::withCollection()

定义

MongoDB\ClientBulkWrite::withCollection()

MongoDB\ClientBulkWrite从提供的MongoDB\Collection 实例返回 的更新实例。此方法允许您在与创建ClientBulkWrite 时使用的集合不同的集合上添加后续写入操作。

此方法不会构建新的 BulkWriteCommand ，也不会就地编辑ClientBulkWrite 实例。

function withCollection(
    Collection $collection,
): self

在 ClientBulkWrite实例上调用此方法时，不能混合使用与不同 Manager 对象关联的 Collection 实例。这是因为该库将完整的 BulkWriteCommand 发送到单个服务器。

参数

$collection : MongoDB\Collection

要设立为写入操作目标的 Collection实例在调用 withCollection() 后添加到 ClientBulkWrite实例。

Return Values

具有相同 BulkWriteCommand 规范但更新的目标命名空间的新 ClientBulkWrite实例。

错误/异常

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

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

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

另请参阅

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