MongoDB\ClientBulkWrite::insertOne()

정의

MongoDB\ClientBulkWrite::insertOne()

대량 쓰기 (write) 명령에서 삽입 작업을 지정합니다. 이 메서드는 호출된 MongoDB\ClientBulkWrite 인스턴스를 반환합니다.

function insertOne(
    array|object $document,
    mixed &$id = null
): self

매개변수

$document : 배열|객체

컬렉션에 삽입할 문서입니다.

$id : 혼합

선택적 출력 변수에 저장 문서의 _id 필드 값을 캡처합니다.

오류/예외

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

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

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

행동

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

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

다음도 참조하세요.

• 대량 쓰기 작업 가이드 의 클라이언트 대량 쓰기 섹션