MongoDB\Driver\WriteResult::getUpsertedIds

(mongodb >=1.0.0)

MongoDB\Driver\WriteResult::getUpsertedIdsReturns an array of identifiers for upserted documents

说明

final public MongoDB\Driver\WriteResult::getUpsertedIds ( void ) : array

参数

此函数没有参数。

返回值

Returns an array of identifiers (i.e. "_id" field values) for upserted documents. The array keys will correspond to the index of the write operation (from MongoDB\Driver\BulkWrite) responsible for the upsert.

错误/异常

范例

Example #1 MongoDB\Driver\WriteResult::getUpsertedIds() example

<?php

$manager 
= new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWrite;
$bulk->insert(['x' => 1]);
$bulk->update(['x' => 1], ['$set' => ['y' => 3]]);
$bulk->update(['x' => 2], ['$set' => ['y' => 1]], ['upsert' => true]);
$bulk->update(['x' => 3], ['$set' => ['y' => 2]], ['upsert' => true]);
$bulk->delete(['x' => 1]);

$result $manager->executeBulkWrite('db.collection'$bulk);

var_dump($result->getUpsertedIds());

?>

以上例程的输出类似于:

array(2) {
  [2]=>
  object(MongoDB\BSON\ObjectId)#4 (1) {
    ["oid"]=>
    string(24) "580e62a224f2302f191b880b"
  }
  [3]=>
  object(MongoDB\BSON\ObjectId)#5 (1) {
    ["oid"]=>
    string(24) "580e62a224f2302f191b880c"
  }
}

参见

相关文章
php mongodb driver cursor returns the server associated with this cursorphp mongodb driver cursor returns an array containing all results for this cursorphp mongodb driver readpreference returns the readpreference s maxstalenessseconds optionphp mongodb driver readpreference returns the readpreference s mode optionphp mongodb driver server returns an array of information about this serverphp mongodb driver server returns an array of tags describing this server in a replica setphp mongodb driver server returns an integer denoting the type of this serverphp mongodb driver writeerror returns the index of the write operation corresponding to this writeerrorphp mongodb driver writeerror returns additional metadata for the writeerrorphp mongodb driver exception writeexception returns the writeresult for the failed write operationphp mongodb driver writeresult returns the number of documents deletedphp mongodb driver writeresult returns the number of documents inserted excluding upserts php mongodb driver writeresult returns the number of documents selected for updatephp mongodb driver writeresult returns the number of existing documents updatedphp mongodb driver writeresult returns the server associated with this write resultphp mongodb driver writeresult returns the number of documents inserted by an upsertphp mongodb driver writeresult returns an array of identifiers for upserted documentsphp mongodb driver writeresult returns any write concern error that occurredphp mongodb driver writeresult returns any write errors that occurredphp mongodb driver writeresult returns whether the write was acknowledged
关注编程学问公众号