문서 교체하기
.replaceOne() 컬렉션 을 사용하여 단일 문서 를 바꿀 수 있습니다. 메서드. replaceOne()
는 쿼리 문서 와 대체 문서 를 허용합니다. 쿼리 가 컬렉션 의 문서 와 일치하면 쿼리 와 일치하는 첫 번째 문서 를 제공된 대체 문서 로 대체합니다. 이 작업은 원본 문서 의 모든 필드와 값을 제거하고 대체 문서 의 필드와 값으로 바꿉니다. 대체 문서 에서 _id
에 대한 새 값을 명시적으로 지정하지 않는 한 _id
필드 값은 동일하게 유지됩니다.
선택적 options
매개 변수를 사용해 upsert
같은 추가 옵션을 지정할 수 있습니다. upsert
옵션 필드를 true
로 설정하면 메서드는 쿼리와 일치하는 문서가 없을 때 새 문서를 삽입합니다.
실행 중에 오류가 발생하면 replaceOne()
메서드에서 예외가 발생합니다. 예를 들어, 고유 인덱스 규칙을 위반하는 값을 지정하면 replaceOne()
duplicate key error
이(가) 발생합니다.
참고
업데이트 후 애플리케이션에 문서가 필요한 경우 collection.findOneAndReplace() 메서드 를 replaceOne()
와 유사한 인터페이스를 가진 메서드입니다. 일치하는 원본 문서 또는 대체 문서를 반환하도록 findOneAndReplace()
를 구성할 수 있습니다.
예시
참고
이 예시를 사용하여 MongoDB 인스턴스에 연결하고 샘플 데이터가 포함된 데이터베이스와 상호 작용할 수 있습니다. MongoDB 인스턴스에 연결하고 샘플 데이터 세트를 로드하는 방법에 대해 자세히 알아보려면 사용 예제 가이드를 참조하세요.
앞의 예시를 실행하면 다음과 같은 출력이 표시됩니다.
Modified 1 document(s)