PHP Conference Japan 2024

MongoDB\Driver\Server::executeBulkWrite

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeBulkWrite在此伺服器上執行一或多個寫入操作

說明

final public MongoDB\Driver\Server::executeBulkWrite(字串 $namespace, MongoDB\Driver\BulkWrite $bulk, 陣列|MongoDB\Driver\WriteConcern|null $options = null): MongoDB\Driver\WriteResult

在此伺服器上執行一或多個寫入操作。

可以使用一或多個不同類型的寫入操作(例如更新、刪除和插入)來建構 MongoDB\Driver\BulkWrite。驅動程式將嘗試以盡可能少的請求將相同類型的操作發送到伺服器,以優化往返次數。

"writeConcern" 選項的預設值將從活動交易(由 "session" 選項指示)推斷,然後是 連線 URI

參數

namespace (字串)

完整的命名空間(例如 "databaseName.collectionName")。

bulk (MongoDB\Driver\BulkWrite)

要執行的寫入操作。

選項

選項
選項名稱 類型 說明
session MongoDB\Driver\Session

要與操作關聯的階段作業。

writeConcern MongoDB\Driver\WriteConcern

要套用於操作的寫入關注。

返回值

成功時返回 MongoDB\Driver\WriteResult

錯誤/例外

更新日誌

版本 說明
PECL mongodb 1.4.4 如果 "session" 選項與未確認的寫入關注一起使用,則將拋出 MongoDB\Driver\Exception\InvalidArgumentException
PECL mongodb 1.4.0 第三個參數現在是一個 options 陣列。為了向下相容,這個參數仍然接受 MongoDB\Driver\WriteConcern 物件。
PECL mongodb 1.3.0 如果 bulk 不包含任何寫入操作,現在會拋出 MongoDB\Driver\Exception\InvalidArgumentException。先前會拋出 MongoDB\Driver\Exception\BulkWriteException

注意事項

注意確保伺服器能夠執行寫入操作是呼叫者的責任。例如,在次要節點(不包括其「local」資料庫)上執行寫入操作將會失敗。

新增註解

使用者貢獻的註解

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