MongoDB\Driver\BulkWrite::insert
(mongodb >=1.0.0)
MongoDB\Driver\BulkWrite::insert — 대량에 삽입 작업 추가
설명
public MongoDB\Driver\BulkWrite::insert(array|object $document
): mixed
MongoDB\Driver\BulkWrite에 삽입 작업을 추가합니다.
매개변수
document
(array|object)- 삽입할 문서입니다.
반환 값
삽입된 문서의 _id
를 반환합니다. document
에 _id
가 없으면 삽입을 위해 생성된 MongoDB\BSON\ObjectId가 반환됩니다.
오류/예외
- 인수 구문 분석 오류에 대해 MongoDB\Driver\Exception\InvalidArgumentException을 던집니다.
변경 로그
버전 | 설명 |
---|---|
PECL mongodb 1.3.0 | 삽입된 문서의 _id 는 항상 반환됩니다. 이전에는 MongoDB\BSON\ObjectId가 생성된 경우에만 메서드가 값을 반환했습니다. |
Examples
예제 #1 MongoDB\Driver\BulkWrite::insert() 예제
<?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');
$result = $manager->executeBulkWrite('db.collection', $bulk);
?>
위의 예는 다음과 유사한 결과를 출력합니다.
object(MongoDB\BSON\ObjectId)#3 (1) { ["oid"]=> string(24) "54d51146bd21b91405401d92" } NULL NULL