MongoDB\Driver\Server::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Server::executeWriteCommand在该服务器上执行写入数据库命令

描述

final public MongoDB\Driver\Server::executeWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

在该服务器上执行命令。

此方法将应用特定于写入命令的逻辑(例如 » drop)。"writeConcern" 选项的默认值将从活动事务(由 "session" 选项指示)推断,然后从 连接 URI 推断。

注意: 此方法不打算用于执行 » insert» update» delete 命令。建议用户使用 MongoDB\Driver\Server::executeBulkWrite() 进行这些操作。

参数

db (string)

要执行命令的数据库名称。

command (MongoDB\Driver\Command)

要执行的命令。

选项

选项
选项 类型 描述
session MongoDB\Driver\Session

与操作关联的会话。

writeConcern MongoDB\Driver\WriteConcern

要应用于操作的写入关注。

警告

如果您使用的是具有正在进行的事务的 "session",则不能指定 "readConcern""writeConcern" 选项。这将导致抛出 MongoDB\Driver\Exception\InvalidArgumentException。相反,您应该在使用 MongoDB\Driver\Session::startTransaction() 创建事务时设置这两个选项。

返回值

成功时返回 MongoDB\Driver\Cursor

错误/异常

变更日志

版本 描述
PECL mongodb 1.4.4 如果 "session" 选项与未确认的写入关注一起使用,则将抛出 MongoDB\Driver\Exception\InvalidArgumentException

注释

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

另请参见

添加注释

用户贡献的注释

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