PHP Conference Japan 2024

MongoDB\Driver\Server::executeReadWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Server::executeReadWriteCommand在此伺服器上執行讀寫資料庫命令

說明

final public MongoDB\Driver\Server::executeReadWriteCommand(字串 $db, MongoDB\Driver\Command $command, ?陣列 $options = null): MongoDB\Driver\Cursor

在此伺服器上執行指令。

此方法將套用特定於讀寫指令的邏輯(例如 » aggregate)。"readConcern""writeConcern" 選項的預設值將從有效交易(由 "session" 選項指示)推斷,然後再從連線 URI推斷。

參數

db (字串)

要執行指令的資料庫名稱。

command (MongoDB\Driver\Command)

要執行的指令。

選項

選項
選項 類型 說明
readConcern MongoDB\Driver\ReadConcern

套用於操作的讀取關注。

此選項在 MongoDB 3.2+ 中可用,如果為較舊的伺服器版本指定,則會在執行時導致例外。

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