Docs Menu
Docs Home
/
MongoDB 매뉴얼
/ / /

BulkWriteResult()

이 페이지의 내용

  • 호환성
  • 속성
  • writeErrors 예외
  • writeConcernError 예외
BulkWriteResult()

Bulk.execute() 메서드의 결과를 포함하는 래퍼입니다.

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

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

BulkWriteResult 다음과 같은 속성이 있습니다.

BulkWriteResult.acknowledged

대량 쓰기가 승인되었는지 여부를 나타내는 부울입니다.

BulkWriteResult.deletedCount

삭제된 문서 수입니다.

BulkWriteResult.insertedCount

삽입된 문서 수입니다.

BulkWriteResult.insertedIds
mongosh 버전
설명
예시

v1.x

ObjectId에 의해 삽입된 문서의 배열입니다.

[ ObjectId(...), ObjectId(...), ObjectId(...) ]

v2.x

삽입된 각 문서 인덱스에서 해당 ObjectId로 매핑합니다.

{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

BulkWriteResult.matchedCount

일치하는 문서 수입니다.

BulkWriteResult.modifiedCount

수정된 문서 수입니다.

BulkWriteResult.upsertedCount

업서트된 문서 수입니다.

BulkWriteResult.upsertedIds
mongosh 버전
설명
예시

v1.x

ObjectId에 의해 업서트된 배열입니다.

[ ObjectId(...), ObjectId(...), ObjectId(...) ]

v2.x

업서트된 각 문서 인덱스에서 해당 ObjectId로 매핑합니다.

{ 0: ObjectId(...), 1: ObjectId(...), 2: ObjectId(...) }`

대량 쓰기를 처리하는 동안 쓰기 오류가 발생하면 mongosh는 다음 필드가 있는 writeErrors 속성이 포함된 예외를 발생시킵니다.

writeErrors

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

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

writeErrors.index

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

writeErrors.code

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

writeErrors.errmsg

오류에 대한 설명입니다.

writeErrors.op

실패한 작업을 식별하는 문서입니다. 예를 들어 업데이트 또는 교체 작업 오류가 발생하면 쿼리, 업데이트, multiupsert 옵션을 지정하는 문서가 반환됩니다. 삽입 작업은 작업에서 삽입하려고 시도한 문서를 반환합니다.

대량 쓰기를 처리하는 동안 쓰기 고려 오류가 발생하면 mongosh는 다음 필드가 있는 writeConcernError 속성을 포함하는 예외를 발생시킵니다.

writeConcernError

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

버전 7.1에서 변경됨: BulkWriteResult() 에서 수신하면 하나 이상의 쓰기 (write) 오류가 발생하더라도 항상 쓰기 고려 (write concern) 고려 오류가 mongos 보고됩니다.

이전 릴리스에서는 쓰기 (write) 오류가 발생하면 BulkWriteResult() 가 쓰기 고려 (write concern) 오류를 보고하지 않을 수 있었습니다.

writeConcernError 문서에는 다음 필드가 포함되어 있습니다.

writeConcernError.code

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

writeConcernError.errmsg

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

writeConcernError.errInfo.writeConcern

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

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

writeConcernError.errInfo.writeConcern.provenance

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

출처
설명

clientSupplied

쓰기 우려 사항은 애플리케이션에서 지정되었습니다.

customDefault

쓰기 고려는 사용자 정의된 기본값에서 비롯된 것입니다. setDefaultRWConcern을 참조하십시오.

getLastErrorDefaults

쓰기 고려는 복제본 세트의 settings.getLastErrorDefaults 필드에서 발생했습니다.

implicitDefault

쓰기 고려는 다른 모든 쓰기 고려 사양이 없는 상태에서 서버에서 발생했습니다.

돌아가기

BSONRegExp