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 lorsqu'ils ne sont pas explicitement fournis, 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

MongoDB\Driver\BulkWriteCommandResult::getInsertedCount() - Renvoie le nombre de documents insérés
MongoDB\Driver\BulkWriteCommandResult::isAcknowledged() - Renvoie si l'écriture a été reconnue
MongoDB\Driver\BulkWriteCommand::insertOne() - Ajoute une opération insertOne

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.