MongoDB\Driver\BulkWrite::insert
(mongodb >=0.2.0)
MongoDB\Driver\BulkWrite::insert — Add a insert operation to the bulk
説明
public MongoDB\Driver\ObjectID MongoDB\Driver\BulkWrite::insert
( array|object
$document
)
パラメータ
-
document -
A document to add to the insert bulk.
返り値
If the document did not have an _id, a
BSON\ObjectID will be generated and returned.
Otherwise no value is returned.
エラー / 例外
- 引数のパースに失敗した場合に MongoDB\Driver\InvalidArgumentException をスローします。
例
例1 MongoDB\Driver\BulkWrite::insert() example
<?php
$bulk = new MongoDB\Driver\BulkWrite(true);
$document1 = array(
"title" => "Example#1",
);
$document2 = array(
"_id" => "custom pregenerated ID",
"title" => "Example#1",
);
$document3 = array(
"_id" => new BSON\ObjectID,
"title" => "Example#1",
);
$_id1 = $bulk->insert($document1);
$_id2 = $bulk->insert($document2);
$_id3 = $bulk->insert($document3);
var_dump($_id1, $_id2, $_id3);
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
$writeConcern = new MongoDB\Driver\WriteConcern(MongoDB\Driver\WriteConcern::MAJORITY, 1000);
$result = $manager->executeBulkWrite("databaseName.collectionName", $bulk, $writeConcern);
?>
上の例の出力は、 たとえば以下のようになります。
object(BSON\ObjectID)#3 (1) {
["oid"]=>
string(24) "54d51146bd21b91405401d92"
}
NULL
NULL
参考
- MongoDB\Driver\Manager::executeBulkWrite() - Execute one or more write operations
- MongoDB\Driver\Manager::executeInsert() - Convenience method for a single insert operation
- MongoDB\Driver\WriteResult
- BSON\ObjectID
- BSON\Persistable
忘却曲線を使ってこの知識を確実に記憶に残す
