db.collection.remove()

쓰기 고려

remove() 메서드는 기본 쓰기 고려를 사용하는 delete 명령을 사용합니다. 다른 쓰기 고려를 지정하려면 옵션 매개변수에 쓰기 고려를 포함합니다.

쿼리 고려 사항

기본적으로 remove()는 query 표현식과 일치하는 모든 문서를 제거합니다. 단일 문서만 제거하는 작업으로 제한하려면 justOne 옵션을 지정합니다. 지정된 순서대로 정렬된 단일 문서를 삭제하려면 findAndModify() 메서드를 사용합니다.

여러 문서를 제거할 때, 제거 작업은 컬렉션에 대한 다른 읽기 및/또는 쓰기 작업에 끼어들 수 있습니다.

Time Series 컬렉션

time series 컬렉션에는 remove() 메서드를 사용할 수 없습니다.

샤드 컬렉션

justOne: true 옵션을 지정하는 분할된 컬렉션에 대해 remove() 작업을 사용하는 방법:

• 하나의 샤드만 대상으로 하는 경우 쿼리 사양에서 부분 샤드 키를 사용할 수 있습니다.

• 쿼리 사양에서 샤드 키 또는 _id 필드를 제공할 수 있습니다.

트랜잭션

db.collection.remove()는 분산 트랜잭션 내에서 사용할 수 있습니다.

트랜잭션에서 실행되는 경우 작업에 대한 쓰기 고려를 명시적으로 설정하지 마세요. 트랜잭션에 쓰기 고려를 사용하려면 트랜잭션 및 쓰기 고려를 참조하세요.

컬렉션에서 모든 문서 제거

컬렉션의 모든 문서를 제거하려면 빈 쿼리 문서 {}를 사용하여 remove 메서드를 호출합니다. 다음 작업은 bios 컬렉션에서 모든 문서를 삭제합니다.

db.bios.remove( { } )

이 작업은 drop() 메서드와 동일하지 않습니다.

컬렉션에서 모든 문서를 제거하려면 drop() 메서드를 사용하여 인덱스를 포함한 전체 컬렉션을 삭제한 다음 컬렉션을 다시 만들고 인덱스를 다시 빌드하는 것이 더 효율적일 수 있습니다.

조건과 일치하는 모든 문서 제거

삭제 기준과 일치하는 문서를 제거하려면 <query> 매개 변수를 사용하여 remove() 메서드를 호출합니다.

다음 작업은 qty가 20보다 큰 컬렉션 products에서 모든 문서를 제거합니다.

db.products.remove( { qty: { $gt: 20 } } )

기본 쓰기 우려 재정의

복제본 세트에 대한 다음 작업은 qty가 20보다 큰 products 컬렉션에서 모든 문서를 제거하고 wtimeout이 5000밀리초인 w: 2의 쓰기 고려를 지정합니다. 이 작업은 쓰기가 프라이머리와 세컨더리 모두에 전파된 후 반환거나 5초 후에 시간 초과됩니다.

db.products.remove(
    { qty: { $gt: 20 } },
    { writeConcern: { w: "majority", wtimeout: 5000 } }
)

조건과 일치하는 단일 문서 제거

삭제 기준과 일치하는 첫 번째 문서를 제거하려면 query 기준과 justOne 매개 변수를 true 또는 1로 설정해 remove 메서드를 호출합니다.

다음 작업은 qty가 20보다 큰 컬렉션 products에서 첫 번째 문서를 제거합니다.

db.products.remove( { qty: { $gt: 20 } }, true )

데이터 정렬 지정

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

컬렉션 myColl에는 다음 문서가 있습니다.

{ _id: 1, category: "café", status: "A" }
{ _id: 2, category: "cafe", status: "a" }
{ _id: 3, category: "cafE", status: "a" }

다음 작업에는 데이터 정렬 옵션이 포함됩니다.

db.myColl.remove(
   { category: "cafe", status: "A" },
   { collation: { locale: "fr", strength: 1 } }
)

에서 변수 사용 let

명령의 다른 곳에서 액세스할 수 있는 변수를 정의하려면 let 옵션을 사용합니다.

컬렉션 cakeFlavors을 만듭니다:

db.cakeFlavors.insertMany( [
   { _id: 1, flavor: "chocolate" },
   { _id: 2, flavor: "strawberry" },
   { _id: 3, flavor: "cherry" }
] )

다음 예제에서는 let에 targetFlavor 변수를 정의하고 이 변수를 사용하여 딸기 케이크 맛을 검색합니다.

db.cakeFlavors.remove(
   { $expr: { $eq: [ "$flavor", "$$targetFlavor" ] } },
   { let : { targetFlavor: "strawberry" } }
)

성공적인 결과

remove()는 작업 상태가 포함된 WriteResult() 객체를 반환합니다. 성공하면 WriteResult() 객체에는 제거된 문서 수에 대한 정보가 포함됩니다.

WriteResult({ "nRemoved" : 4 })

우려 사항 오류 쓰기

remove() 메서드에서 쓰기 고려 오류가 발생하면 결과에는 WriteResult.writeConcernError 필드가 포함됩니다.

WriteResult({
  "nRemoved" : 7,
  "writeConcernError" : {
    "code" : 64,
    "codeName" : "WriteConcernFailed",
    "errmsg" : "waiting for replication timed out",
    "errInfo" : {
      "wtimeout" : true,
      "writeConcern" : {
        "w" : "majority",
        "wtimeout" : 1,
        "provenance" : "getLastErrorDefaults"
      }
    }
  }
})

쓰기 우려와 관련이 없는 오류

remove() 메서드에서 쓰기 고려가 아닌 오류가 발생하면 결과에 WriteResult.writeError 필드가 포함됩니다.

WriteResult({
   "nRemoved" : 0,
   "writeError" : {
      "code" : 2,
      "errmsg" : "unknown top level operator: $invalidFieldName"
   }
})