MongoDB\Driver\BulkWriteCommandResult::getInsertResults

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommandResult::getInsertResults — Возвращает подробную информацию о результатах успешных операций вставки

Описание

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

Значение insertedId в каждом результате соответствует значению, которое метод MongoDB\Driver\BulkWriteCommand::insertOne() возвращает после добавления конкретной операции вставки, включая значения полей _id, которые модуль автоматически генерирует при вставке документов.

Список параметров

Сигнатура функции не содержит параметров.

Возвращаемые значения

Метод возвращает документ, который содержит результаты каждой успешной операции вставки, или null, если подробные результаты не запрашивались. Ключи документа соответствуют индексу операции записи из объекта MongoDB\Driver\BulkWriteCommand.

Ошибки

При ошибке парсинга аргумента метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException.
При записи без подтверждения метод выбрасывает исключение MongoDB\Driver\Exception\LogicException.

Примеры

Пример #1 Пример получения подробных результатов об операциях вставки методом 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());

?>

Вывод приведённого примера будет похож на:

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"
    }
  }
}

Смотрите также

MongoDB\Driver\BulkWriteCommandResult::getInsertedCount() - Возвращает количество вставленных документов
MongoDB\Driver\BulkWriteCommandResult::isAcknowledged() - Возвращает информацию о подтверждении записи
MongoDB\Driver\BulkWriteCommand::insertOne() - Добавляет операцию insertOne

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы