/ /

문서 업데이트

개요

이 가이드 에서는 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 값을 업데이트 . Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

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)

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

다수 문서 업데이트

다음 예시 에서는 update_many() 메서드를 사용하여 cuisine 값이 "Pizza"인 모든 문서를 업데이트 . 업데이트 후 문서의 cuisine 값은 "Pasta"입니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

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

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

업데이트 작업 사용자 지정

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

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

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

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

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

데이터 정렬

업데이트 작업을 수행할 때 운전자 사용할 데이터 정렬 을 지정할 수 있습니다.

데이터 정렬은 대소문자 및 악센트 표시와 같이 문자열 비교를 위한 언어별 규칙 설정하다 입니다.

데이터 정렬을 지정하려면 Collation 클래스 또는 Python 사전의 인스턴스 만듭니다. Collation 생성자에 전달하거나 사전에 키로 포함할 수 있는 옵션 목록은 MongoDB Server 매뉴얼의 데이터 정렬 을 참조하세요.

팁

데이터 정렬 가져오기

Collation 클래스의 인스턴스 만들려면 pymongo.collation에서 가져와야 합니다.

다음 예시 이전 예시 와 동일한 업데이트 작업을 수행하지만 기본값 데이터 정렬은 fr_CA입니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

from pymongo.collation import Collation
restaurants = database["restaurants"]
query_filter = {'cuisine' : 'Pizza'}
update_operation = { '$set' : 
    { 'cuisine' : 'Pasta' }
}
result = restaurants.update_many(query_filter, update_operation,
                                 collation=Collation(locale='fr_CA'))

from pymongo.collation import Collation
restaurants = database["restaurants"]
query_filter = {'cuisine' : 'Pizza'}
update_operation = { '$set' : 
    { 'cuisine' : 'Pasta' }
}
result = await restaurants.update_many(query_filter, update_operation,
                                       collation=Collation(locale='fr_CA'))

참고

작업 데이터 정렬 재정의 기본값

작업의 일부로 데이터 정렬을 지정하면 컬렉션 의 기본값 데이터 정렬이 재정의됩니다.

반환 값

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

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

추가 정보

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

API 문서

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

돌아가기

커서에서 데이터 액세스

문서 교체