MongoDB\Driver\BulkWriteCommandResult::getUpdateResults
(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommandResult::getUpdateResults — Returns verbose results for successful updates
参数
此函数没有参数。
返回值
Returns a document containing the result of each successful update
operation, or null if verbose results were not requested. The document
keys will correspond to the index of the write operation from
MongoDB\Driver\BulkWriteCommand.
错误/异常
- Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.
- Throws MongoDB\Driver\Exception\LogicException if the write was not acknowledged.
示例
示例 #1 MongoDB\Driver\BulkWriteCommandResult::getUpdateResults() example
<?php
$manager = new MongoDB\Driver\Manager;
$bulk = new MongoDB\Driver\BulkWriteCommand(['verboseResults' => true]);
$bulk->insertOne('db.coll', ['x' => 1]);
$bulk->updateOne('db.coll', ['x' => 1], ['$set' => ['y' => 3]]);
$bulk->updateOne('db.coll', ['x' => 2], ['$set' => ['y' => 1]], ['upsert' => true]);
$bulk->updateOne('db.coll', ['x' => 3], ['$set' => ['y' => 2]], ['upsert' => true]);
$bulk->deleteMany('db.coll', []);
$result = $manager->executeBulkWriteCommand($bulk);
var_dump($result->getUpdateResults()->toPHP());
?>以上示例的输出类似于:
object(stdClass)#16 (3) {
["1"]=>
object(stdClass)#7 (2) {
["matchedCount"]=>
object(MongoDB\BSON\Int64)#5 (1) {
["integer"]=>
string(1) "1"
}
["modifiedCount"]=>
object(MongoDB\BSON\Int64)#6 (1) {
["integer"]=>
string(1) "1"
}
}
["2"]=>
object(stdClass)#11 (3) {
["matchedCount"]=>
object(MongoDB\BSON\Int64)#8 (1) {
["integer"]=>
string(1) "1"
}
["modifiedCount"]=>
object(MongoDB\BSON\Int64)#9 (1) {
["integer"]=>
string(1) "0"
}
["upsertedId"]=>
object(MongoDB\BSON\ObjectId)#10 (1) {
["oid"]=>
string(24) "67f7eb9b1f198bbcb880d575"
}
}
["3"]=>
object(stdClass)#15 (3) {
["matchedCount"]=>
object(MongoDB\BSON\Int64)#12 (1) {
["integer"]=>
string(1) "1"
}
["modifiedCount"]=>
object(MongoDB\BSON\Int64)#13 (1) {
["integer"]=>
string(1) "0"
}
["upsertedId"]=>
object(MongoDB\BSON\ObjectId)#14 (1) {
["oid"]=>
string(24) "67f7eb9b1f198bbcb880d576"
}
}
}
参见
- MongoDB\Driver\BulkWriteCommandResult::getMatchedCount() - Returns the number of documents selected for update
- MongoDB\Driver\BulkWriteCommandResult::getModifiedCount() - Returns the number of existing documents updated
- MongoDB\Driver\BulkWriteCommandResult::getUpsertedCount() - Returns the number of documents upserted
- MongoDB\Driver\BulkWriteCommandResult::isAcknowledged() - Returns whether the write was acknowledged