MongoDB\Driver\Server::executeBulkWrite

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeBulkWrite在此服务器上执行一个或多个写入操作

描述

final public MongoDB\Driver\Server::executeBulkWrite(string $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

错误/异常

变更日志

版本 描述
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”数据库)上执行写入操作将失败。

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top