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