Docs Home → 애플리케이션 개발 → Python 드라이버 → PyMongo
문서 교체
개요
이 가이드에서는 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 | Specifies whether the replace operation performs an upsert operation if no
documents match the query filter. For more information, see the upsert
statement
in the MongoDB Server manual. Defaults to False |
bypass_document_validation | Specifies whether the replace operation bypasses document validation. This lets you
replace documents that don't meet the schema validation requirements, if any
exist. For more information about schema validation, see Schema
Validation in the MongoDB
Server manual. Defaults to False. |
collation | Specifies the kind of language collation to use when sorting
results. For more information, see Collation
in the MongoDB Server manual. |
hint | Gets or sets the index to scan for documents.
For more information, see the hint statement
in the MongoDB Server manual. |
session | An instance of ClientSession. |
let | A Map of parameter names and values. Values must be constant or closed
expressions that don't reference document fields. For more information,
see the let statement in the
MongoDB Server manual. |
comment | A comment to attach to the operation. For more information, see the insert command
fields guide in the
MongoDB Server manual. |
다음 코드는 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 | The number of documents that matched the query filter, regardless of
how many were updated. |
modified_count | The number of documents modified by the update operation. If an updated
document is identical to the original, it is not included in this
count. |
raw_result | The raw result document returned by the server. |
upserted_id | The ID of the document that was upserted in the database, if the driver
performed an upsert. Otherwise None. |
추가 정보
쿼리 필터 생성에 대해 자세히 알아보려면 쿼리 지정 가이드를 참조하세요.
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.