문서 업데이트

이 페이지의 내용

개요

샘플 데이터
업데이트 작업
하나의 문서 업데이트
다수 문서 업데이트
업데이트 작업 사용자 지정
반환 값
추가 정보
API 문서

개요

이 가이드에서는 update_one() 또는 update_many() 메서드를 사용하여 PyMongo를 사용하여 MongoDB 컬렉션의 문서를 업데이트하는 방법을 배울 수 있습니다.

샘플 데이터

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

업데이트 작업

다음 방법을 사용하여 MongoDB에서 업데이트 작업을 수행할 수 있습니다.

update_one()검색 조건과 일치하는 첫 번째 문서가 업데이트됩니다.
update_many()검색 조건과 일치하는 모든 문서가 업데이트됩니다.

각 업데이트 방법에는 다음 매개변수가 필요합니다.

업데이트할 문서를 결정하는 쿼리 필터 문서입니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션 을 참조하세요.
업데이트 연산자 (수행할 업데이트의 종류)와 변경해야 하는 필드 및 값을 지정하는 업데이트 문서입니다. 업데이트 연산자 목록과 그 사용법은 MongoDB Server 매뉴얼의 필드 업데이트 연산자 가이드 페이지 를 참조하세요.

하나의 문서 업데이트

다음 예제에서는 update_one() 메서드를 사용하여 restaurants 컬렉션에 있는 "Bagels N Buns" 문서의 name 값을 업데이트합니다.

restaurants = database["restaurants"]
query_filter = {'name' : 'Bagels N Buns'}
update_operation = { '$set' : 
    { 'name' : '2 Bagels 2 Buns' }
}
result = restaurants.update_one(query_filter, update_operation)

다수 문서 업데이트

다음 예제에서는 update_many() 메서드를 사용하여 cuisine 값이 "Pizza" 인 모든 문서를 업데이트합니다. 업데이트 후 문서의 cuisine 값은 "Pasta" 입니다.

restaurants = database["restaurants"]
query_filter = {'cuisine' : 'Pizza'}
update_operation = { '$set' : 
    { 'cuisine' : 'Pasta' }
}
result = restaurants.update_many(query_filter, update_operation)

업데이트 작업 사용자 지정

update_one() 및 update_many() 메서드는 선택적으로 추가 매개변수를 허용하며, 이는 업데이트 작업을 구성하는 데 사용할 수 있는 옵션을 나타냅니다. 추가 옵션을 지정하지 않으면 드라이버는 업데이트 작업을 사용자 지정하지 않습니다.

속성	설명
`upsert`	Specifies whether the update 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 update operation bypasses document validation. This lets you update 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.
`array_filters`	A list of filters that specifies which array elements an update applies to.
`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 for more information.

다음 코드는 update_many() 메서드를 사용하여 borough 필드의 값이 "Manhattan" 인 모든 문서를 찾습니다. 그런 다음 이러한 문서의 borough 값을 "Manhattan (north)" 로 업데이트합니다. upsert 옵션이 True 로 설정되어 있기 때문에 쿼리 필터가 기존 문서와 일치하지 않는 경우 PyMongo는 새 문서를 삽입합니다.

restaurants = database["restaurants"]
query_filter = {'borough' : 'Manhattan'}
update_operation = { '$set' : 
    { 'borough' : 'Manhattan (north)' }
}
result = restaurants.update_many(query_filter, update_operation, upsert = True)

반환 값

update_one() 및 update_many() 메서드는 각각 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 설명서를 참조하세요.

돌아가기

문서 삽입

문서 교체