MongoDB\Driver\BulkWriteCommandResult::getInsertResults

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommandResult::getInsertResults — Renvoie les rĂ©sultats dĂ©taillĂ©s des insertions rĂ©ussies

Description

final public function MongoDB\Driver\BulkWriteCommandResult::getInsertResults(): ?MongoDB\BSON\Document

Depuis que les champs _id des documents insérés sont générés par l'extension, la valeur de insertedId dans chaque résultat correspondra à la valeur de retour de MongoDB\Driver\BulkWriteCommand::insertOne() pour l'opération d'insertion correspondante.

Liste de paramĂštres

Cette fonction ne contient aucun paramĂštre.

Valeurs de retour

Renvoie un document contenant les résultats de chaque opération d'insertion ou null si les résultats détaillés n'ont pas été demandés. Les clés du document correspondront à l'index de l'opération d'écriture de MongoDB\Driver\BulkWriteCommand.

Erreurs / Exceptions

  • Lance une exception MongoDB\Driver\InvalidArgumentException lors d'une erreur survenue pendant l'analyse d'un argument.
  • LĂšve une exception MongoDB\Driver\Exception\LogicException si l'Ă©criture n’a pas Ă©tĂ© reconnue.

Exemples

Exemple #1 Exemple de MongoDB\Driver\BulkWriteCommandResult::getInsertResults()

<?php

$manager = new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand(['verboseResults' => true]);

$generatedId = $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($generatedId);

var_dump($result->getInsertResults()->toPHP());

?>

RĂ©sultat de l'exemple ci-dessus est similaire Ă  :

object(MongoDB\BSON\ObjectId)#3 (1) {
  ["oid"]=>
  string(24) "67f7ee69783dcce702097b41"
}
object(stdClass)#8 (1) {
  ["0"]=>
  object(stdClass)#7 (1) {
    ["insertedId"]=>
    object(MongoDB\BSON\ObjectId)#6 (1) {
      ["oid"]=>
      string(24) "67f7ee69783dcce702097b41"
    }
  }
}

Voir aussi

Found A Problem?

Learn How To Improve This Page ‱ Submit a Pull Request ‱ Report a Bug
add a note

User Contributed Notes

There are no user contributed notes for this page.