BulkWriteResult()

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

속성

BulkWriteResult()에는 다음과 같은 속성이 있습니다.

BulkWriteResult.nInserted

Bulk.insert() 메서드를 사용하여 삽입한 문서 수입니다. Bulk.find.upsert() 옵션을 사용한 작업을 통해 삽입된 문서의 경우 nUpserted 필드를 대신 참조하세요.

BulkWriteResult.nMatched

업데이트 또는 교체를 위해 선택한 기존 문서 수입니다. 업데이트/교체 작업으로 인해 기존 문서가 변경되지 않는 경우(예: $set 표현식은 값을 현재 값으로 업데이트하며, nMatched 는 nModified 보다 클 수 있습니다.

BulkWriteResult.nModified

업데이트되거나 교체된 기존 문서 수입니다. 필드 값을 현재 값으로 설정하는 등 업데이트/교체 작업으로 인해 기존 문서가 변경되지 않는 경우 nModified 는 nMatched 보다 작을 수 있습니다. 삽입된 문서는 nModified 의 수에 영향을 주지 않습니다. 대신 nInserted 및 nUpserted 필드를 참조하세요.

BulkWriteResult.nRemoved

제거된 문서 수입니다.

BulkWriteResult.nUpserted

Bulk.find.upsert() 옵션을 사용한 작업을 통해 삽입된 문서 수입니다.

BulkWriteResult.upserted

Bulk.find.upsert() 옵션을 사용한 작업을 통해 삽입된 각 문서에 대한 정보가 포함된 문서 배열입니다.

각 문서에는 다음 정보가 포함되어 있습니다.

BulkWriteResult.upserted.index

대량 작업 목록의 작업을 식별하는 정수로, 0부터 시작하는 인덱스를 사용합니다.

BulkWriteResult.upserted._id

삽입된 문서의 _id 값입니다.

BulkWriteResult.writeErrors

업데이트 작업 중에 발생한 쓰기 고려와 관련이 없는 오류에 관한 정보가 포함된 문서 배열입니다. writeErrors 배열에는 오류가 발생한 각 쓰기 작업에 대한 오류 문서가 포함되어 있습니다.

각 오류 문서에는 다음과 같은 필드가 포함되어 있습니다.

BulkWriteResult.writeErrors.index

대량 작업 목록에서 쓰기 작업을 식별하는 정수로, 0부터 시작하는 인덱스를 사용합니다. Bulk.getOperations() 도 참조하세요.

BulkWriteResult.writeErrors.code

오류를 식별하는 정수 값입니다.

BulkWriteResult.writeErrors.errmsg

오류에 대한 설명입니다.

BulkWriteResult.writeErrors.op

실패한 작업을 식별하는 문서입니다. 인스턴스, 업데이트/대체 작업 오류가 발생하면 쿼리, 업데이트, multi 및 upsert 옵션을 지정하는 문서가 반환됩니다. 삽입 작업은 작업에서 삽입하려고 시도한 문서를 반환합니다.

BulkWriteResult.writeConcernError

쓰기 고려 (write concern) 와 관련된 오류를 설명하는 문서입니다.

버전 에서 5.0.30 변경됨: BulkWriteResult() 에서 수신하면 하나 이상의 쓰기 (write) 오류가 발생하더라도 쓰기 고려 (write concern) 오류가 항상 mongos 보고됩니다. 이전 릴리스에서는 쓰기 (write) 오류가 발생하면 가 쓰기 BulkWriteResult() 고려 (write concern) 오류를 보고하지 않을 수 있었습니다.

각 오류 문서에는 다음과 같은 필드가 포함되어 있습니다.

BulkWriteResult.writeConcernError.code

쓰기 문제 오류의 원인을 식별하는 정수 값입니다.

BulkWriteResult.writeConcernError.errmsg

쓰기 관련 오류의 원인에 대한 설명입니다.

BulkWriteResult.writeConcernError.errInfo.writeConcern

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

해당 작업에 사용되는 쓰기 관련 객체입니다. 쓰기 문제 객체 필드에 대한 자세한 내용은 쓰기 문제 사양을 참조하세요.

쓰기 고려 객체에는 쓰기 문제의 원본을 나타내는 다음 필드도 포함될 수 있습니다.

BulkWriteResult.writeConcernError.errInfo.writeConcern.provenance

쓰기 문제가 발생한 위치를 나타내는 문자열 값입니다(쓰기 문제 provenance 라고도 함). 다음 표에는 이 필드에 사용할 수 있는 값과 그 의미가 나와 있습니다.

출처	설명
clientSupplied	쓰기 우려 사항은 애플리케이션에서 지정되었습니다.
customDefault	쓰기 고려는 사용자 정의된 기본값에서 비롯된 것입니다. setDefaultRWConcern을 참조하십시오.
getLastErrorDefaults	쓰기 고려는 복제본 세트의 settings.getLastErrorDefaults 필드에서 발생했습니다.
implicitDefault	쓰기 고려는 다른 모든 쓰기 고려 사양이 없는 상태에서 서버에서 발생했습니다.