(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — 在此服务器上执行写入数据库命令
$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”数据库)上执行写入操作将会失败。