MongoDB\Driver\BulkWriteCommand::__construct

    (mongodb >=2.1.0)

    MongoDB\Driver\BulkWriteCommand::__construct — Create a new BulkWriteCommand

    Опис

    public MongoDB\Driver\BulkWriteCommand::__construct(?array $options = null)

    Constructs a new MongoDB\Driver\BulkWriteCommand, which may be used to perform many insert, update, and delete operations on multiple collections in a single request using the » bulkWrite command introduced in MongoDB 8.0. This differs from MongoDB\Driver\BulkWrite, which is supported by all server versions but limited to a single collection.

    After all write operations have been added, this object may be executed with MongoDB\Driver\Manager::executeBulkWriteCommand().

    Параметри

    options (array)

    options
    Option Type Description Default
    bypassDocumentValidation bool

    If true, allows insert and update operations to circumvent document level validation.

    		false
    comment mixed

    An arbitrary comment to help trace the operation through the database profiler, currentOp output, and logs.

    let array|object

    Карта назв і значень параметрів. Значення мають бути константами або закритими виразами, які не посилаються на поля документа. Тоді параметри можуть бути доступні як змінні в контексті агрегатного виразу (напр. $$var).

    Цей параметр доступний у MongoDB 5.0+, тож його застосування у старіших версіях викине виключення під час виконання.

    ordered bool

    Whether the operations in this bulk write should be executed in the order in which they were specified. If false, writes will continue to be executed if an individual write fails. If true, writes will stop executing if an individual write fails.

    		true
    verboseResults bool

    Whether detailed results for each successful operation should be included in the returned MongoDB\Driver\BulkWriteCommandResult.

    		false

    Помилки/виключення

    Приклади

    Приклад #1 MongoDB\Driver\BulkWriteCommand::__construct() example

    <?php

    $manager     = new MongoDB\Driver\Manager;

    $bulk = new MongoDB\Driver\BulkWriteCommand;

    // Delete documents from both collections
    $bulk->deleteMany('db.coll_one', []);
    $bulk->deleteMany('db.coll_two', []);

    // Insert documents into two collections
    $bulk->insertOne('db.coll_one', ['_id' => 1]);
    $bulk->insertOne('db.coll_two', ['_id' => 2]);
    $bulk->insertOne('db.coll_two', ['_id' => 3]);

    // Update a document in "coll_one"
    $bulk->updateOne('db.coll_one', ['_id' => 1], ['$set' => ['x' => 1]]);

    $result = $manager->executeBulkWriteCommand($bulk);

    printf("Inserted %d document(s)\n", $result->getInsertedCount());
    printf("Updated %d document(s)\n", $result->getModifiedCount());

    ?>

    Поданий вище приклад виведе:

    Inserted 3 document(s)
Updated  1 document(s)

    Прогляньте також

    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.
    To Top