(mongodb >=1.0.0)
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。
bulk
不包含任何寫入操作,則拋出 MongoDB\Driver\Exception\InvalidArgumentException。bulk
已經執行,則拋出 MongoDB\Driver\Exception\InvalidArgumentException。MongoDB\Driver\BulkWrite 物件不能多次執行。"session"
選項與未確認的寫入關注一起使用,則拋出 MongoDB\Driver\Exception\InvalidArgumentException。
版本 | 說明 |
---|---|
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」資料庫)上執行寫入操作將會失敗。