Renvoie les résultats détaillés des insertions réussies

# 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

- 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open