(mongodb >=1.0.0)
MongoDB\Driver\Server::executeBulkWrite — 在此服务器上执行一个或多个写入操作
$namespace, MongoDB\Driver\BulkWrite $bulk, array|MongoDB\Driver\WriteConcern|null $options = null): MongoDB\Driver\WriteResult在此服务器上执行一个或多个写入操作。
一个 MongoDB\Driver\BulkWrite 可以使用一个或多个不同类型的写入操作(例如更新、删除和插入)构建。驱动程序将尝试以尽可能少的请求将相同类型的操作发送到服务器,以优化往返次数。
"writeConcern" 选项的默认值将从活动事务(由 "session" 选项指示)推断,然后是 连接 URI。
namespace (string)一个完全限定的命名空间(例如 "databaseName.collectionName")。
bulk (MongoDB\Driver\BulkWrite)要执行的写入操作。
选项
| 选项 | 类型 | 描述 |
|---|---|---|
| session | MongoDB\Driver\Session |
要与操作关联的会话。 |
| writeConcern | MongoDB\Driver\WriteConcern |
要应用于操作的写入关注。 |
成功时返回 MongoDB\Driver\WriteResult。
bulk 不包含任何写入操作,则抛出 MongoDB\Driver\Exception\InvalidArgumentException。bulk 已经被执行,则抛出 MongoDB\Driver\Exception\InvalidArgumentException。 MongoDB\Driver\BulkWrite 对象不能被执行多次。"session" 选项与未确认的写入关注一起使用,则抛出 MongoDB\Driver\Exception\InvalidArgumentException。
| 版本 | 描述 |
|---|---|
| PECL mongodb 1.4.4 |
如果 "session" 选项与未确认的写入关注一起使用,则将抛出 MongoDB\Driver\Exception\InvalidArgumentException。 |
| PECL mongodb 1.4.0 | 第三个参数现在是 options 数组。为了向后兼容,此参数仍将接受 MongoDB\Driver\WriteConcern 对象。 |
| PECL mongodb 1.3.0 |
如果 bulk 不包含任何写入操作,则现在抛出 MongoDB\Driver\Exception\InvalidArgumentException。以前,会抛出 MongoDB\Driver\Exception\BulkWriteException。 |
注意: 确保服务器能够执行写入操作是调用者的责任。例如,在辅助节点(不包括其“本地”数据库)上执行写入操作将失败。