/ /

문서 삭제

개요

이 가이드 에서는 삭제 작업 을 수행하여 MongoDB PHP 라이브러리를 사용하여 MongoDB 컬렉션 에서 문서를 제거 하는 방법을 학습 수 있습니다.

삭제 작업은 MongoDB 컬렉션에서 하나 이상의 문서를 제거합니다. MongoDB\Collection::deleteOne() 또는 MongoDB\Collection::deleteMany() 메서드를 사용하여 삭제 작업을 수행할 수 있습니다.

샘플 데이터

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

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

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

삭제 작업

다음 방법을 사용하여 삭제 작업을 수행할 수 있습니다.

MongoDB\Collection::deleteOne()Atlas Search 기준과 일치 하는 첫 번째 문서를 삭제합니다.
MongoDB\Collection::deleteMany()Atlas Search 기준과 일치하는 모든 문서 를 삭제합니다.

각 삭제 메서드에는 제거할 문서를 결정하기 위한 검색 기준을 지정하는 쿼리 필터하다 문서 가 필요합니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션 을 참조하세요.

문서 하나 삭제

다음 예시 에서는 deleteOne() 메서드를 사용하여 restaurants 컬렉션 에서 name 값이 'Ready Penny Inn' 인 문서 를 제거 합니다.

$collection->deleteOne(['name' => 'Ready Penny Inn']);

여러 문서 삭제

다음 예시 에서는 deleteMany() 메서드를 사용하여 restaurants 컬렉션 에서 borough 값이 'Brooklyn' 인 모든 문서를 제거 합니다.

$collection->deleteMany(['borough' => 'Brooklyn']);

삭제 작업 수정

옵션 값을 매개 변수로 지정하는 배열 을 전달하여 MongoDB\Collection::deleteOne() 및 MongoDB\Collection::deleteMany() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 배열 에서 설정하다 수 있는 옵션에 대해 설명합니다.

옵션	설명
`collation`	문자열을 비교할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 이 페이지의 데이터 정렬 섹션을 참조하십시오.
`writeConcern`	작업에 대한 쓰기 고려 (write concern) 설정합니다. 이 옵션의 기본값은 컬렉션의 쓰기 고려 (write concern). 자세한 내용은 MongoDB Server 매뉴얼의 쓰기 고려를 참조하세요.
`hint`	문서를 스캔할 인덱스를 가져오거나 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 설명 을 참조하세요.
`let`	작업 가독성을 높이기 위해 값 목록이 포함된 문서 지정합니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 매뉴얼의 let 성명서 참조하세요.
`session`	작업과 연결할 클라이언트 세션을 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 세션을 참조하세요.
`comment`	작업에 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 삭제 명령 필드 가이드 참조하세요.

데이터 정렬

작업에 대한 데이터 정렬을 지정하려면 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`	(선택 사항) 분음 부호가 포함된 string이 string의 뒤쪽에서 앞쪽으로 정렬되는지 지정합니다. 데이터 유형: `bool` 기본값: `false`

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

예시

다음 예시 에서는 deleteMany() 메서드를 호출하여 restaurants 컬렉션 에서 'Mongo' string 이 포함된 name 값이 있는 모든 문서를 삭제 합니다. 또한 배열 매개변수에 comment 옵션을 설정하여 작업에 주석을 추가합니다.

$collection->deleteMany(
    ['name' => new MongoDB\BSON\Regex('Mongo')],
    ['comment' => 'Deleting Mongo restaurants'],
);

참고

앞의 예시 에서 deleteMany() 메서드를 deleteOne() 로 바꾸면 라이브러리는 'Mongo' 을 포함하는 name 값이 있는 첫 번째 문서 만 삭제합니다.

반환 값

MongoDB\Collection::deleteOne() 및 MongoDB\Collection::deleteMany() 메서드는 MongoDB\DeleteResult 객체 를 반환합니다. 이 클래스에는 다음과 같은 멤버 함수가 포함되어 있습니다.

isAcknowledged()는 작업이 승인되었는지 여부를 나타내는 부울을 반환합니다.
getDeletedCount(), 삭제된 문서 수를 반환합니다. 쓰기 (write) 작업이 승인되지 않은 경우 이 메서드는 오류를 발생시킵니다.

쿼리 필터하다 가 어떤 문서와도 일치하지 않으면 운전자 는 어떤 문서도 삭제 하지 않고 getDeletedCount() 은 0 을 반환합니다.

예시

다음 예시 에서는 deleteMany() 메서드를 호출하여 cuisine 값이 'Greek' 인 문서를 삭제 합니다. 그런 다음 getDeletedCount() 멤버 함수를 호출하여 삭제된 문서 수를 출력합니다.

$result = $collection->deleteMany(['cuisine' => 'Greek']);
echo 'Deleted documents: ', $result->getDeletedCount(), PHP_EOL;

Deleted documents: 111

API 문서

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

돌아가기

문서 교체

대량 쓰기 작업