MongoDB\Driver\BulkWrite::insert

(mongodb >=1.0.0)

MongoDB\Driver\BulkWrite::insert — Add an insert operation to the bulk

说明

public mixed MongoDB\Driver\BulkWrite::insert ( array|object $document )

Adds an insert operation to the MongoDB\Driver\BulkWrite.

参数

document ( array|object ): A document to insert.

返回值

If the document did not have an _id, a MongoDB\BSON\ObjectID will be generated and returned; otherwise, no value is returned.

错误／异常

Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.

范例

Example #1 MongoDB\Driver\BulkWrite::insert() example

  <?php

$bulk  = new  MongoDB \ Driver \ BulkWrite ;

 $document1  = [ 'title'  =>  'one' ];
 $document2  = [ '_id'  =>  'custom ID' ,  'title'  =>  'two' ];
 $document3  = [ '_id'  => new  MongoDB \ BSON \ ObjectID ,  'title'  =>  'three' ];

 $_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 ( 'db.collection' ,  $bulk ,  $writeConcern );

 ?>

以上例程的输出类似于：

object(MongoDB\BSON\ObjectID)#3 (1) {
  ["oid"]=>
  string(24) "54d51146bd21b91405401d92"
}
NULL
NULL

参见

MongoDB\Driver\Manager::executeBulkWrite() - Execute one or more write operations
MongoDB\Driver\WriteResult
MongoDB\BSON\ObjectID
MongoDB\BSON\Persistable