(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。 |
注意: 确保服务器能够执行写入操作是调用者的责任。例如,在辅助节点(不包括其“本地”数据库)上执行写入操作将失败。