PHP Conference Japan 2024

MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeWriteCommand執行寫入的資料庫命令

描述

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

在主要伺服器上執行命令。

此方法將套用特定於寫入命令的邏輯(例如 » drop)。"writeConcern" 選項的預設值將從活動交易(由 "session" 選項指示)推斷,然後從連線 URI推斷。

注意 此方法不適合用於執行 » insert» update» delete 命令。建議使用者對這些操作使用 MongoDB\Driver\Manager::executeBulkWrite()

參數

db (string)

執行命令的資料庫名稱。

command (MongoDB\Driver\Command)

要執行的命令。

options

options
選項 類型 描述
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

參見

新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。
To Top