/ /

문서 업데이트

개요

이 가이드 에서는 MongoDB PHP 라이브러리를 사용하여 MongoDB 컬렉션 의 문서를 업데이트 하는 방법을 학습 수 있습니다. MongoDB\Collection::updateOne() 메서드를 호출하여 단일 문서 를 업데이트 하거나 MongoDB\Collection::updateMany() 메서드를 호출하여 여러 문서를 업데이트 할 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 을 사용합니다. PHP 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 MongoDB\Client 를 인스턴스화하고 $collection 변수에 다음 값을 할당합니다.

$collection = $client->sample_restaurants->restaurants;

무료 MongoDB 배포서버 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면, MongoDB 시작하기 가이드 참조하세요.

업데이트 작업

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

MongoDB\Collection::updateOne()검색 조건과 일치하는 첫 번째 문서가 업데이트됩니다.
MongoDB\Collection::updateMany()검색 조건과 일치하는 모든 문서가 업데이트됩니다.

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

쿼리 필터하다 문서: 업데이트 할 문서를 지정합니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션 을 참조하세요.
문서업데이트 : 업데이트 연산자 또는 수행할 업데이트 의 종류, 변경할 필드 및 값을 지정합니다. 업데이트 연산자 목록 및 사용법은 MongoDB Server 매뉴얼의 필드 업데이트 연산자 가이드 를 참조하세요.

하나의 문서 업데이트

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

$result = $collection->updateOne(
    ['name' => 'Bagels N Buns'],
    ['$set' => ['name' => '2 Bagels 2 Buns']],
);

다수 문서 업데이트

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

$result = $collection->updateMany(
    ['cuisine' => 'Pizza'],
    ['$set' => ['cuisine' => 'Pasta']],
);

업데이트 작업 사용자 지정

옵션 값을 매개 변수로 지정하는 배열 을 전달하여 updateOne() 및 updateMany() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 배열 에서 설정하다 수 있는 몇 가지 옵션을 설명합니다.

옵션	설명
`upsert`	쿼리 필터하다 와 일치하는 문서가 없는 경우 업데이트 작업에서 업서트 작업을 수행할지 여부를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 업서트 성명서 참조하세요. 기본값은 `false` 입니다.
`bypassDocumentValidation`	업데이트 작업에서 문서 유효성 검사 우회할지 여부를 지정합니다. 이를 통해 스키마 유효성 검사 요구 사항을 충족하지 않는 문서(있는 경우)를 업데이트 수 있습니다. 스키마 유효성 검사 에 대한 자세한 내용은 MongoDB Server 매뉴얼의 스키마 유효성 검사 참조하세요. 기본값은 `false` 입니다.
`sort`	`updateOne()` 에만 적용됩니다. 업데이트 작업을 수행하기 전에 문서에 적용 할 정렬 순서를 지정합니다.
`collation`	결과를 정렬할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세히 학습 이 페이지의 데이터 정렬 섹션을 참조하세요.
`arrayFilters`	작업이 배열 필드를 수정하는 경우 업데이트 를 적용할 배열 요소를 지정합니다.
`hint`	문서를 스캔할 인덱스 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 성명서 참조하세요.
`writeConcern`	작업에 대한 쓰기 고려 (write concern) 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 쓰기 고려를 참조하세요.
`let`	작업 가독성을 높이기 위해 값 목록이 포함된 문서 지정합니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 매뉴얼의 let 성명서 참조하세요.
`comment`	작업에 첨부할 주석입니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드를 참조하세요.

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

$result = $collection->updateMany(
    ['borough' => 'Manhattan'],
    ['$set' => ['borough' => 'Manhattan (north)']],
    ['upsert' => true],
);

데이터 정렬

작업에 대한 데이터 정렬을 지정하려면 collation 옵션을 설정하는 $options 배열 매개변수를 작업 메서드에 전달합니다. 데이터 정렬 규칙을 구성하는 배열 에 collation 옵션을 할당합니다.

다음 표에서는 데이터 정렬을 구성하기 위해 설정하다 수 있는 필드에 대해 설명합니다.

필드	설명
`locale`	(필수) 국제 구성 요소 유니코드(ICU) 국가 및 언어 설정 및 언어 설정을 지정합니다. 지원되는 국가 및 언어 설정 목록은 MongoDB Server 매뉴얼의 데이터 정렬 국가 및 언어 설정 및 기본 매개변수를 참조하세요. 데이터 유형: `string`
`caseLevel`	(선택 사항) 대소문자 비교를 포함할지 여부를 지정합니다. 로 설정하다 하면 `true` 비교 동작은 `strength` 필드 의 값에 따라 달라집니다. - 가 `strength` `1`인 경우 PHP 라이브러리는 기본 문자와 대소문자를 비교합니다. - 가 `strength` `2`인 경우 PHP 라이브러리는 기본 문자, 발음 부호, 기타 세컨더리 차이점 및 대소문자를 비교합니다. - 이(가) `strength` 다른 값인 경우 이 필드 무시됩니다. 로 설정하다 `false` 하면 PHP 라이브러리에 강도 수준 `1` 또는 에서 대소문자 비교가 포함되지 `2` 않습니다. 데이터 유형: `bool` 기본값: `false`
`caseFirst`	(선택 사항) 3차 수준 비교 시 대소문자 차이의 정렬 순서를 지정합니다. 데이터 유형: `string` 기본값: `"off"`
`strength`	(선택 사항) ICU 문서에 정의된 대로 수행할 비교 수준을 지정합니다. 데이터 유형: `int` 기본값: `3`
`numericOrdering`	(선택 사항) 운전자 숫자 문자열을 숫자로 비교할지 여부를 지정합니다. 로 설정하다 `true` 하면 PHP 라이브러리는 숫자 문자열을 숫자로 비교합니다. 예시 들어, 문자열 '10'와 '2'를 비교할 때 라이브러리는 문자열의 숫자 값을 사용하고 '10'를 ' '보다 큰 것으로 취급합니다.2 로 설정하다 `false` 하면 PHP 라이브러리는 숫자 문자열을10문자열로 비교합니다. 예시 를 들어 ' 문자열과 '2' 문자열을 비교할 때 라이브러리는 한 번에 한 문자씩10비교하여 ' '을 ' '보다 작은 것으로2취급합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 제한을 참조하세요. 데이터 유형: `bool` 기본값: `false`
`alternate`	(선택 사항) 라이브러리가 비교 목적으로 공백과 문장 부호를 기본 문자로 간주할지 여부를 지정합니다. 데이터 유형: `string` 기본값: `"non-ignorable"`
`maxVariable`	(선택 사항) 필드 `alternate` 로 설정하다 경우 라이브러리에서 무시할 수 있는 것으로 간주하는 문자를 `"shifted"` 지정합니다. 데이터 유형: `string` 기본값: `"punct"`
`backwards`	(선택 사항) 분음 부호가 포함된 문자열을 문자열 뒤쪽에서 앞쪽으로 정렬할지 여부를 지정합니다. 데이터 유형: `bool` 기본값: `false`

데이터 정렬 및 각 필드에 사용할 수 있는 값에 대해 자세히 학습하려면 MongoDB Server 매뉴얼의 데이터 정렬 항목을 참조하세요.

반환 값

updateOne() 및 updateMany() 메서드는 MongoDB\UpdateResult 클래스의 인스턴스 를 반환합니다. 이 클래스에는 다음과 같은 멤버 함수가 포함되어 있습니다.

기능	설명
`getMatchedCount()`	업데이트된 문서 수에 관계없이 쿼리 필터하다 와 일치하는 문서 수를 반환합니다.
`getModifiedCount()`	업데이트 작업으로 수정된 문서 수를 반환합니다. 업데이트된 문서 원본과 동일한 경우 이 계산에 포함되지 않습니다.
`isAcknowledged()`	서버 쓰기 (write) 작업을 승인했는지 여부를 나타내는 부울을 반환합니다.
`getUpsertedCount()`	데이터베이스 에 업서트된 문서 수를 반환합니다.
`getUpsertedId()`	운전자 업서트 수행한 경우 데이터베이스 에 업서트된 문서 의 ID 반환합니다.

다음 예시 에서는 updateMany() 메서드를 사용하여 일치하는 문서의 name 필드 를 'Dunkin' Donuts' 에서 'Dunkin'' 로 업데이트 합니다. getModifiedCount() 멤버 함수를 호출하여 수정된 문서 수를 출력합니다.

$result = $collection->updateMany(
    ['name' => 'Dunkin\' Donuts'],
    ['$set' => ['name' => 'Dunkin\'']],
);
echo 'Modified documents: ', $result->getModifiedCount();

Modified documents: 206

빌더 업데이트

MongoDB\Builder\Update 클래스를 사용하여 IDE 코드 완성 및 PHP 유형 검사를 지원 하는 업데이트 문서를 구성할 수 있습니다. Update 클래스는 $set, $inc, $unset와 같은 MongoDB 업데이트 연산자에 해당하는 팩토리 메서드를 제공합니다.

업데이트 빌더를 사용하려면 다음 클래스를 애플리케이션 으로 가져옵니다.

use MongoDB\Builder\Query;
use MongoDB\Builder\Update;

다음 예시 Update::set() 팩토리 메서드를 사용하여 restaurants 컬렉션 에서 name 값이 'Bagels N Buns' 인 첫 번째 일치 문서 에서 name 필드 '2 Bagels 2 Buns' 로 업데이트 .

$result = $collection->updateOne(
    Query::query(name: Query::eq('Bagels N Buns')),
    Update::set(name: '2 Bagels 2 Buns'),
);

한 번의 작업으로 여러 업데이트 연산자를 적용 하려면 연산자를 MongoDB\Builder\Update 생성자에 전달합니다. 다음 예시 Update::set() 과 Update::unset() 를 결합하여 cuisine 필드 Pasta 로 설정하다 하고 cuisine 값이 'Pizza'인 모든 문서에서 grades 필드 제거 .

$result = $collection->updateMany(
    Query::query(cuisine: Query::eq('Pizza')),
    new Update(
        Update::set(cuisine: 'Pasta'),
        Update::unset('grades'),
    ),
);

빌더 클래스에 대해 자세히 학습하고 더 많은 예제를 보려면 빌더를 사용한 작업 가이드를 참조하세요.

추가 정보

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

API 문서

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

돌아가기

커서에서 데이터 액세스

문서 교체