MongoDB\Driver\BulkWrite::delete

(mongodb >=1.0.0)

MongoDB \ Driver \ Bulkwrite :: delete - 대량에 삭제 작업 추가


설명

public MongoDB\Driver\BulkWrite::delete(array|object $filter, array $deleteOptions = ?): void

MongoDB\Driver\BulkWrite에 삭제 작업을 추가합니다.


매개변수

filter (array|object)
» query predicate. 빈 술어는 컬렉션의 모든 문서와 일치합니다.

참고: 쿼리 기준을 평가할 때 MongoDB는 PHP의 비교​​유형 저글링 규칙과 다른 » BSON 유형에 대한 자체 비교 규칙에 따라 유형과 값을 비교합니다. 특수 BSON 유형을 일치시킬 때 쿼리 기준은 해당 BSON 클래스를 사용해야 합니다(예: » ObjectId와 일치시키기 위해 MongoDB\BSON\ObjectId 사용).

deleteOptions

deleteOptions

Option Type 설명 Default
collation array|object » 데이터 정렬을 통해 사용자는 문자 대소문자 및 악센트 표시 규칙과 같은 문자열 비교를 위한 언어별 규칙을 지정할 수 있습니다. 데이터 정렬을 지정할 때 "로케일" 필드는 필수입니다. 다른 모든 데이터 정렬 필드는 선택 사항입니다. 필드에 대한 설명은 » 데이터 정렬 문서를 참조하세요.

데이터 정렬이 지정되지 않았지만 컬렉션에 기본 데이터 정렬이 있는 경우 작업은 컬렉션에 대해 지정된 데이터 정렬을 사용합니다. 컬렉션 또는 작업에 대해 데이터 정렬이 지정되지 않은 경우 MongoDB는 문자열 비교를 위해 이전 버전에서 사용된 단순 이진 비교를 사용합니다.

이 옵션은 MongoDB 3.4 이상에서 사용할 수 있으며 이전 서버 버전에 대해 지정된 경우 실행 시 예외가 발생합니다.

hint string|array|object 인덱스 사양. 인덱스 이름을 문자열 또는 인덱스 키 패턴으로 지정하십시오. 지정된 경우 쿼리 시스템은 힌트 인덱스를 사용하는 계획만 고려합니다.

이 옵션은 MongoDB 4.4 이상에서 사용할 수 있으며 이전 서버 버전에 대해 지정된 경우 실행 시 예외가 발생합니다.

limit bool 일치하는 모든 문서 삭제(false) 또는 첫 번째 일치하는 문서만 삭제(true) false

반환 값

값이 반환되지 않습니다.


오류/예외


변경 로그

버전 설명
PECL mongodb 1.8.0 "hint" 옵션을 추가했습니다.
PECL mongodb 1.2.0 "collation" 옵션을 추가했습니다.

Examples

예제 #1 MongoDB\Driver\BulkWrite::delete() 예제

                  
<?php

$bulk = new MongoDB\Driver\BulkWrite;
$bulk->delete(['x' => 1], ['limit' => 1]);
$bulk->delete(['x' => 2], ['limit' => 0]);

$manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');
$result = $manager->executeBulkWrite('db.collection', $bulk);

?>
                  
                

기타