/ /

/ /

문서 교체

개요

이 가이드에서는 PyMongo를 사용하여 MongoDB 컬렉션의 문서에서 바꾸기 작업을 수행하는 방법을 배울 수 있습니다. 바꾸기 작업은 업데이트 작업과 다르게 수행됩니다. 업데이트 작업은 대상 문서에서 지정된 필드만 수정합니다. 바꾸기 작업은 대상 문서의 모든 필드를 제거하고 새 필드로 바꿉니다.

업데이트 작업에 대해 자세히 알아보려면 문서 업데이트 가이드를 참조하세요.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants.restaurants 컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 PyMongo 시작하기 튜토리얼을 참조하세요.

대체 작업

replace_one() 메서드를 사용하여 MongoDB에서 바꾸기 작업을 수행할 수 있습니다. 이 메서드는 Atlas Search 기준과 일치하는 첫 번째 문서에서 _id 필드를 제외한 모든 필드를 제거합니다. 그런 다음 지정한 필드와 값을 문서에 삽입합니다.

필수 매개변수

이 replace_one() 메서드에는 다음 매개 변수가 필요합니다.

교체할 문서를 결정하는 쿼리 필터하다 문서 입니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션 을 참조하세요.
새 문서에 삽입할 필드와 값을 지정하는 대체 문서입니다.

replaceOne

다음 예제에서는 replace_one() 메서드를 사용하여 문서의 필드와 값을 name 필드 값 "Pizza Town" 로 바꿉니다.

restaurants = database["restaurants"]
query_filter = {"name" : "Pizza Town"}
replace_document = { "name" : "Mongo's Pizza",
                     "cuisine" : "Pizza",
                     "address" : {
                         "street" : "123 Pizza St",
                         "zipCode" : "10003"
                     },
                     "borough" : "Manhattan"
                   }
result = restaurants.replace_one(query_filter, replace_document)

중요

_id 필드의 값은 변경할 수 없습니다. 대체 문서에서 _id 필드 값을 지정하는 경우 기존 문서의 _id 값과 일치해야 합니다.

대체 작업 사용자 지정

replace_one() 메서드는 선택적으로 추가 매개변수를 허용하며, 이는 대체 작업을 구성하는 데 사용할 수 있는 옵션입니다. 추가 옵션을 지정하지 않으면 드라이버는 바꾸기 작업을 사용자 지정하지 않습니다.

속성	설명
`upsert`	쿼리 필터와 일치하는 문서가 없는 경우 대체 작업이 업서트 작업을 수행할지 여부를 지정합니다. 자세한 내용은 MongoDB Server 수동의 업서트 성명서 를 참조하세요. 기본값은 `False`입니다.
`bypass_document_validation`	바꾸기 작업에서 문서 유효성 검사 우회할지 여부를 지정합니다. 이를 통해 스키마 유효성 검사 요구 사항을 충족하지 않는 문서(있는 경우)를 대체할 수 있습니다. 스키마 유효성 검사 에 대한 자세한 내용은 MongoDB Server 매뉴얼의 스키마 유효성 검사 참조하세요. 기본값은 `False` 입니다.
`collation`	결과를 정렬할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 을 참조하세요.
`hint`	문서를 스캔할 인덱스를 가져오거나 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 설명 을 참조하세요.
`session`	`ClientSession` 의 인스턴스입니다.
`let`	매개변수 이름과 값의 맵입니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 매뉴얼의 let 문 을 참조하세요.
`comment`	작업에 첨부할 주석입니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드를 참조하세요.

다음 코드는 replace_one() 메서드를 사용하여 name 필드의 값이 "Food Town" 인 첫 번째 문서를 찾은 다음 이 문서를 "Food World" 이라는 새 문서로 바꿉니다. upsert 옵션이 True 로 설정되어 있기 때문에 쿼리 필터가 기존 문서와 일치하지 않는 경우 드라이버는 새 문서를 삽입합니다.

restaurants = database["restaurants"]
query_filter = {"name" : "Food Town"}
replace_document = { "name" : "Food World",
                     "cuisine" : "Mixed",
                     "address" : {
                         "street" : "123 Food St",
                         "zipCode" : "10003"
                     },
                     "borough" : "Manhattan"
                   }
result = restaurants.replace_one(query_filter, replace_document, upsert = True)

반환 값

replace_one() 메서드는 UpdateResult 객체를 반환합니다. UpdateResult 유형에는 다음과 같은 속성이 포함되어 있습니다.

속성	설명
`matched_count`	업데이트된 문서 수에 관계없이 쿼리 필터와 일치하는 문서 수입니다.
`modified_count`	업데이트 작업으로 수정된 문서 수입니다. 업데이트된 문서가 원본과 동일한 경우 이 계산에 포함되지 않습니다.
`raw_result`	서버에서 반환한 원시 결과 문서입니다.
`upserted_id`	드라이버가 업서트를 수행한 경우 데이터베이스에 업서트된 문서의 ID입니다. 그렇지 않으면 `None`.

추가 정보

쿼리 필터 생성에 대해 자세히 알아보려면 쿼리 지정 가이드를 참조하세요.

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

돌아가기

문서 업데이트

문서 삭제