MongoDB\ClientBulkWrite::createWithCollection()

정의

MongoDB\ClientBulkWrite::createWithCollection()

제공된 MongoDB\ClientBulkWrite 인스턴스 에서 빌더의 인스턴스 만듭니다. 에 쓰기 (write) 작업을 MongoDB\Collection 추가하여 ClientBulkWrite 라이브러리가 서버 로 보내는 새 BulkWriteCommand 를 만들수 있습니다.

function createWithCollection(
    Collection $collection,
    array $options = []
): self

매개변수

$collection : MongoDB\Collection

대량 쓰기 (write) 작업의 대상으로 설정하다 Collection 인스턴스 입니다.

$options : 배열

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

이름	유형	설명
bypassDocumentValidation	부울	true인 경우: 쓰기 (write) 작업이 문서 수준 유효성 검사 무시합니다. 기본값은 false입니다.
comment	혼합	사용자가 데이터베이스 프로파일러, currentOp 출력 및 로그를 통해 작업을 추적하는 데 도움이 되는 임의의 주석을 지정할 수 있습니다.
하자	배열|객체	매개변수 이름과 값의 맵입니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 그런 다음 매개변수는 애그리게이션 표현식 컨텍스트에서 변수로 액세스될 수 있습니다(예: $$var). 이 기능 MongoDB 서버 버전 6.0 및 이전 버전에서는 지원되지 않습니다. 이 옵션을 사용하면 서버 실행 시 예외를 반환합니다.
주문됨	부울	true인 경우: 단일 쓰기 (write) 실패하면 나머지 쓰기를 수행하지 않고 작업이 중지되고 예외가 발생합니다. false인 경우: 단일 쓰기 (write) 실패하면 나머지 쓰기(있는 경우)로 작업을 계속하고 예외를 발생시킵니다. 기본값은 true입니다.
verboseResults	부울	상세 결과를 반환할지 여부를 지정합니다. 기본값은 false입니다.

Return Values

빈 BulkWriteCommand 사양이 있는 새 ClientBulkWrite 인스턴스 입니다.

오류/예외

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

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

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

다음도 참조하세요.

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