MongoDB\Client::bulkWrite()

버전 2.1에 추가 되었습니다.

정의

MongoDB\Client::bulkWrite()

여러 네임스페이스에 걸쳐 여러 쓰기 (write) 작업을 수행합니다.

function bulkWrite(
    BulkWriteCommand|ClientBulkWrite $bulk,
    array $options = []
): MongoDB\BulkWriteCommandResult

매개변수

$bulk : MongoDB\ClientBulkWrite 또는

BulkWriteCommand

팁

ClientBulkWrite API 선호

대량 쓰기 (write) 명령에서 쓰기 (write) 작업을 지정하려면 BulkWriteCommand 클래스를 사용하는 대신 ClientBulkWrite 빌더 클래스 및 메서드를 사용하는 것이 좋습니다. ClientBulkWrite 는 MongoDB\Collection 클래스의 CRUD 메서드와 유사한 메서드를 갖춘 유창한 API 제공합니다.

어셈블된 대량 쓰기 (write) 명령 또는 빌더를 나타냅니다. MongoDB\Client::bulkWrite() 는 deleteMany(), deleteOne(), insertOne(), replaceOne(), updateMany() 및 updateOne() 연산을 지원합니다.

$options : 배열

원하는 옵션을 지정하는 배열입니다.

이름	유형	설명
Session	MongoDB\Driver\Session	작업과 연결할 클라이언트 세션입니다.
쓰기 고려	MongoDB\Driver\WriteConcern	작업에 사용할 고려를 씁니다 . 기본값은 컬렉션의 쓰기 고려입니다. 트랜잭션의 일부로 개별 작업에 대한 쓰기 고려를 지정할 수 없습니다. 대신 트랜잭션을시작할 때 `writeConcern` 옵션을 설정합니다.

Return Values

MongoDB\BulkWriteCommandResult 객체입니다.

오류/예외

옵션이 사용되지만 선택한 서버에서 지원되지 않는 경우 MongoDB\Exception\UnsupportedException입니다(예: collation, readConcern, writeConcern).

MongoDB\Exception\InvalidArgumentException 매개변수 또는 옵션의 구문 분석과 관련된 오류의 경우입니다.

MongoDB\ 드라이버\Exception\RuntimeException 확장 수준의 다른 오류(예: 연결 오류).

쓰기 (write) 작업과 관련된 오류에 대한MongoDB\ 드라이버 \Exception\BulkWriteCommandException. getWriteErrors() 가 반환한 값을 검사하여 오류의 특성을 확인할 수 있습니다.

행동

MongoDB\ 드라이버\Exception\BulkWriteCommandException 이 발생하면 getWriteErrors() 를 호출하고 반환된 배열 의 정보를 검사하여 오류의 특성을 확인할 수 있습니다.

예시 를 들어, 쓰기 (write) 작업이 프라이머리 서버 에 성공적으로 적용되었지만 쓰기 고려 (write concern) 충족하지 못했을 수 있습니다. 또는 쓰기 (write) 작업이 완전히 실패했을 수도 있습니다( 예시 : 고유 키 제약 조건 위반).

대량 쓰기 (write) 의 경우 결과에 여러 번의 성공적인 쓰기 (write) 작업 및/또는 오류가 표시될 수 있습니다. ordered 옵션이 true인 경우 첫 번째 오류가 발생하고 예외가 발생하기 전에 일부 작업이 성공했을 수 있습니다. ordered 옵션이 false인 경우 여러 오류가 발생했을 수 있습니다.

다음도 참조하세요.

돌아가기

addSubscriber()

createClientEncryption()