/ /

문서 업데이트

개요

이 가이드 에서는 Ruby 운전자 사용하여 update_one 및 update_many 메서드를 통해 MongoDB 컬렉션 의 문서를 업데이트 방법을 학습 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 사용합니다. Ruby 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 Mongo::Client 객체 만들고 database 및 collection 변수에 다음 값을 할당합니다.

database = client.use('sample_restaurants')
collection = database[:restaurants]

무료 MongoDB Atlas 클러스터 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB 시작하기 가이드 를 참조하세요.

업데이트 작업

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

update_one: 검색 기준과 일치하는 첫 번째 문서 를 업데이트합니다.
update_many: 검색 기준과 일치하는 모든 문서 를 업데이트합니다.

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

업데이트 하려는 문서와 일치하는쿼리 필터하다 입니다. 쿼리 필터에 대해 자세히 학습 쿼리 지정 가이드 참조하세요.
업데이트 연산자, 업데이트할 필드 및 값을 지정하는 업데이트 문서 입니다. 업데이트 연산자 수행할 업데이트 유형을 지정합니다. 업데이트 연산자 목록을 보고 사용법에 대해 학습 MongoDB Server 매뉴얼의 필드 업데이트 연산자 가이드 페이지를 참조하세요.

하나의 문서 업데이트 예시

다음 예시 update_one 메서드를 사용하여 name 필드 의 값이 "Happy Garden"인 첫 번째 문서 찾습니다. 그런 다음 $set 연산자 사용하여 name 필드 값을 "Mountain House"(으)로 업데이트 .

filter = { name: 'Happy Garden' }
update = { '$set' => { name: 'Mountain House' } }
single_result = collection.update_one(filter, update)
puts "#{single_result.modified_count} document(s) updated."

1 document(s) updated

다수 문서 업데이트 예시

다음 예시 update_many 메서드를 사용하여 name 필드 값이 "Starbucks"인 모든 문서를 업데이트 . 업데이트 문서 $rename 연산자 사용하여 address 필드 의 이름을 location로 변경합니다.

filter = { name: 'Starbucks' }
update = { '$rename' => { address: 'location' } }
many_result = collection.update_many(filter, update)
puts "#{many_result.modified_count} document(s) updated."

11 document(s) updated

업서트 옵션

upsert 매개변수를 사용하면 update_one() 및 update_many() 연산을 사용하여 조건부 연산을 수행할 수 있습니다.

지정된 문서 있으면 명령이 해당 문서를 업데이트합니다.
지정된 문서 존재하지 않으면 명령은 지정된 매개 변수를 사용하여 새 문서 만듭니다.

자세한 내용은 이 페이지의 업데이트 예제 수정 섹션 또는 옵션 표 를 참조하세요.

업데이트 작업 사용자 지정

update_one 및 update_many 메서드는 업데이트 작업을 구성하는 옵션을 허용합니다. 이러한 옵션을 개별적으로 매개 변수로 전달하거나 옵션이 포함된 Hash 객체 만들어 객체 매개 변수로 전달할 수 있습니다. 옵션을 지정하지 않으면 운전자 기본값 설정으로 업데이트 작업을 수행합니다.

다음 표에서는 업데이트 작업을 구성하는 데 사용할 수 있는 옵션에 대해 설명합니다.

옵션	설명
`upsert`	쿼리 필터하다 와 일치하는 문서가 없는 경우 업데이트 작업이 업서트 작업을 수행할지 여부입니다. 자세한 내용은 MongoDB Server 매뉴얼의 업서트 성명서 참조하세요. 기본값: `false`
`bypass_document_validation`	업데이트 작업이 문서 유효성 검사 우회하는지 여부입니다. 이를 통해 스키마 유효성 검사 요구 사항을 충족하지 않는 문서(있는 경우)를 업데이트 수 있습니다. 스키마 유효성 검사 에 대한 자세한 내용은 MongoDB Server 매뉴얼의 스키마 유효성 검사 참조하세요. 기본값: `false`
`collation`	결과를 정렬할 때 사용할 언어 데이터 정렬입니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬을 참조하세요.
`array_filters`	업데이트 를 적용할 배열 요소를 선택하기 위해 지정하는 필터 목록입니다.
`hint`	문서를 일치시킬 때 사용할 인덱스입니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 성명서 참조하세요.
`let`	작업에 대한 최상위 변수를 설정하다 위한 매개변수 이름 및 값의 맵입니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 매뉴얼의 let 성명서 참조하세요.

수정 업데이트 예시

이 예시 $equal 연산자 사용하여 name 필드 값이 "Sunrise Pizzeria"인 문서를 일치시킵니다. 그런 다음 $set 연산자 사용하여 일치하는 첫 번째 문서 의 borough 필드 값을 "Queens" 로, cuisine 필드 값을 "Italian"로 설정하다 .

upsert 옵션이 true로 설정하다 있기 때문에 쿼리 필터하다 기존 문서와 일치하지 않는 경우 운전자 필터하다 의 필드와 값이 포함된 새 문서 삽입하고 문서를 업데이트 .

filter = { 'name' => 'Sunrise Pizzeria' }
update = { '$set' => { borough: 'Queens', cuisine: 'Italian' } }
upsert_result = collection.update_one(filter, update, upsert: true)
puts "#{upsert_result.modified_count} document(s) updated."

1 document(s) updated

반환 값

update_one 및 update_many 메서드는 각각 Result 객체 반환합니다. Result 인스턴스 에서 다음 메서드 액세스 할 수 있습니다.

메서드	설명
`matched_count`	수행된 업데이트 수에 관계없이 쿼리 필터하다 와 일치하는 문서 수입니다.
`modified_count`	업데이트 작업으로 수정된 문서 수입니다. 업데이트된 문서 원본과 동일한 경우 이 계산에 포함되지 않습니다.
`acknowledged?`	서버 결과를 승인한 경우 `true` 를 반환합니다.
`upserted_count`	운전자 업서트 수행한 경우 데이터베이스 에 업서트된 문서 수를 반환합니다.
`upserted_ids`	운전자 업서트 수행한 경우 데이터베이스 에 업서트된 문서 의 `_id` 값을 반환합니다.

팁

다른 Result 메서드를 호출하기 전에 acknowledged? 메서드의 값을 확인하세요. acknowledged? 메서드가 false을 반환하고 Result 객체 에서 다른 메서드를 호출하려고 하면 운전자 InvalidOperation 예외가 발생합니다. 서버 쓰기 (write) 작업을 승인하지 않으면 운전자 이러한 값을 결정할 수 없습니다.

추가 정보

Ruby 운전자 사용하여 문서를 업데이트 방법을 보여주는 실행 가능한 코드 예제를 보려면 문서 삽입을 참조하세요.

API 문서

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

돌아가기

커서에서 데이터 액세스

문서 교체