WriteResult()

정의

WriteResult()

mongosh 쓰기 메서드의 결과 상태를 포함하는 래퍼입니다.

팁

참조:

• db.collection.insert()

• db.collection.update()

• db.collection.remove()

참고

db.collection.insert() 및 db.collection.update()는 더 이상 사용되지 않습니다.

교체 메서드가 반환하는 결과는 다른 형식을 갖습니다. WriteResult()와 비슷한 출력의 경우 db.collection.bulkWrite() 사용을 고려해 보세요.

호환성

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

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

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

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

속성

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

WriteResult.nInserted

upserted 문서를 제외하고 삽입된 문서 수입니다. 업서트를 통해 삽입된 문서 수는 WriteResult.nUpserted에서 확인하세요.

WriteResult.nMatched

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

WriteResult.nModified

업데이트된 기존 문서의 수입니다. 필드 값을 현재 값으로 설정하는 등 업데이트/교체 작업으로 인해 문서가 변경되지 않는 경우 nModified는 nMatched보다 작을 수 있습니다.

WriteResult.nUpserted

업서트로 삽입된 문서 수입니다.

WriteResult._id

upsert가 삽입한 문서의 _id입니다. upsert로 인해 삽입이 발생하는 경우에만 반환됩니다.

WriteResult.nRemoved

제거된 문서 수입니다.

WriteResult.writeError

쓰기 고려 오류를 제외하고 쓰기 작업 중에 발생한 모든 오류에 대한 정보가 들어 있는 문서입니다.

WriteResult.writeError.code

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

WriteResult.writeError.errmsg

오류에 대한 설명입니다.

WriteResult.writeError.errInfo

쓰기 (write) 쓰기 고려 (write concern) 중에 발생한 쓰기 (write) 오류에 관한 정보가 포함된 문서 입니다. 작업이 문서 유효성 검사 에 실패하면 서버 는 이 필드 아래에 문서 가 컬렉션의 유효성 검사기 표현식 과 일치하지 않는 이유를 설명하는 오류를 생성합니다.

WriteResult.writeConcernError

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

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

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

WriteResult.writeConcernError.code

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

WriteResult.writeConcernError.errmsg

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

WriteResult.writeConcernError.errInfo.writeConcern

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

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

WriteResult.writeConcernError.errInfo.writeConcern.provenance

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

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