PHP Conference Japan 2024

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

在此服务器上执行命令。

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

注意 此方法不适用于执行» 插入» 更新» 删除命令。建议用户使用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