Edit Report a Bug

    MongoWriteBatch::execute

    (PECL mongo >= 1.5.0)

    MongoWriteBatch::execute — Выполняет пакет операций записи

    Описание

    final public MongoWriteBatch::execute ( array $write_options ) : array

    Выполняет пакет операций записи.

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

    write_options

    Смотрите MongoWriteBatch::__construct.

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

    Возвращает массив, содержащий статистическую информацию для полного пакета. Если пакет нужно было разделить на несколько пакетов, возвращаемое значение будет агрегировать значения из отдельных пакетов и возвращать только итог.

    Если пакет был пустым, возвращается массив, содержащий только поле 'ok' (как TRUE), хотя ничего не будет отправлено (NOOP).

    Ключ массива Значение Возвращается для типа пакета
    nInserted Количество вставленных документов MongoWriteBatch::COMMAND_INSERT batch
    nMatched Количество документов, соответствующих критериям запроса MongoWriteBatch::COMMAND_UPDATE batch
    nModified Количество документов, которые действительно необходимо изменить MongoWriteBatch::COMMAND_UPDATE batch
    nUpserted Количество отправленных документов MongoWriteBatch::COMMAND_UPDATE batch
    nRemoved Количество удаленных документов MongoWriteBatch::COMMAND_DELETE batch
    ok Индикатор успешности выполнения команды All

    Ошибки

    Исключение MongoWriteConcernException выдается при сбое.

    Примеры

    Пример #1 Пример использования MongoWriteBatch::add()

    Пакетная операция вставки

    <?php
    $mc     = new MongoClient("localhost");
    $collection = $mc->selectCollection("test", "test");


    $docs = array();
    $docs[] = array("my" => "demo");
    $docs[] = array("is" => "working");
    $docs[] = array("pretty" => "well");

    $batch = new MongoInsertBatch($collection);
    foreach(    $docs as $document) {
            $batch->add($document);
    }
    $retval = $batch->execute(array("w" => 1));
    var_dump($retval);
    ?>

    Результат выполнения данного примера:

    array(2) {
  ["nInserted"]=>
  int(3)
  ["ok"]=>
  bool(true)
}

    Пример #2 Пример использования MongoWriteBatch::add()

    Пакетная операция обновления

    <?php
    $mc     = new MongoClient("localhost");
    $collection = $mc->selectCollection("test", "test");


    $item1 = array(
            "q" => array("my" => "demo"),
            "u" => array('$set' => array("try" => 1)),
            "multi"  => false, /* значение по умолчанию */
            "upsert" => false, /* значение по умолчанию */
    );
    $item2 = array(
            "q" => array("is" => "working"),
            "u" => array('$set' => array("try" => 2)),
            "multi" => true,
    );
    $item3 = array(
            "q" => array("created" => "new-document"),
            "u" => array('$set' => array("try" => 3)),
            "upsert" => true,
    );

    $batch = new MongoUpdateBatch($collection);
    $batch->add($item1);
    $batch->add($item2);
    $batch->add($item3);
    $retval = $batch->execute(array("w" => 1));
    var_dump($retval);

    ?>

    Результат выполнения данного примера:

    array(4) {
  ["nMatched"]=>
  int(18)
  ["nModified"]=>
  int(2)
  ["nUpserted"]=>
  int(0)
  ["ok"]=>
  bool(true)
}

    Пример #3 Пример использования MongoWriteBatch::add()

    Пакетная операция удаления

    <?php
    $mc     = new MongoClient("localhost");
    $collection = $mc->selectCollection("test", "test");


    $item1 = array(
            "q" => array("my" => "demo"),
            "limit" => 1,
    );
    $item2 = array(
            "q" => array("try" => 3),
            "limit" => 1,
    );


    $batch = new MongoDeleteBatch($collection);
    $batch->add($item1);
    $batch->add($item2);
    $retval = $batch->execute(array("w" => 1));
    var_dump($retval);
    ?>

    Результат выполнения данного примера:

    array(2) {
  ["nRemoved"]=>
  int(1)
  ["ok"]=>
  bool(true)
}
    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top