Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
Mongo쉬 방법
/
컬렉션

db.collection.deleteOne()

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 행동
  • 예시

드라이버가 포함된 MongoDB

이 페이지에서는 mongosh 메서드를 설명합니다. MongoDB 드라이버에서 해당 메서드를 보려면 프로그래밍 언어의 해당 페이지를 참조하세요.

C#Java SyncNode.jsPyMongoC++GoJava RSKotlin CoroutineKotlin SyncPHPMongoidRustScala

정의

db.collection.deleteOne()

컬렉션에서 단일 문서를 제거합니다.

반환합니다:다음이 포함된 문서입니다.

  • 작업이 쓰기 고려로 실행된 경우 부울 acknowledged를 true로, 쓰기 고려가 비활성화된 경우 false로 설정합니다.

  • deletedCount 삭제된 문서 수 포함

호환성

다음 환경에서 호스팅되는 배포에 db.collection.deleteOne() 사용할 수 있습니다.

  • MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

구문

deleteOne() 메서드의 형식은 다음과 같습니다.

db.collection.deleteOne(
    <filter>,
    {
      writeConcern: <document>,
      collation: <document>,
      hint: <document|string>
    }
)

deleteOne() 메서드는 다음 매개변수를 사용합니다.

Parameter
유형
설명
문서

쿼리 연산자를 사용하여 삭제 기준을 지정합니다.

컬렉션에서 반환된 첫 번째 문서를 삭제하려면 빈 문서 { }를 지정합니다.

문서

선택 사항입니다. 쓰기 고려를 표현하는 문서입니다. 기본 쓰기 고려를 사용하지 않으려면 생략하세요.

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

문서

선택 사항.

작업에 사용할 데이터 정렬을 지정합니다.

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

데이터 정렬 옵션의 구문은 다음과 같습니다:

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

데이터 정렬을 지정할 때 locale 필드는 필수이고, 다른 데이터 정렬 필드는 모두 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.

데이터 정렬이 지정되지 않았지만 컬렉션에 기본 데이터 정렬이 있는 경우( db.createCollection() 참조), 작업은 컬렉션에 지정된 데이터 정렬을 사용합니다.

컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다.

한 연산에 대해 여러 데이터 정렬을 지정할 수 없습니다. 예를 들어 필드별로 서로 다른 데이터 정렬을 지정할 수 없으며 정렬과 함께 찾기를 수행하는 경우 찾기 와 정렬에서 각각 다른 데이터 정렬을 사용하는 것은 허용되지 않습니다.

문서

선택 사항입니다. 쿼리 조건자를 지원하는 데 사용할 인덱스를 지정하는 문서 또는 문자열입니다.

이 옵션은 인덱스 사양 문서 또는 인덱스 이름 문자열을 사용할 수 있습니다.

존재하지 않는 인덱스를 지정하면 연산 오류가 발생합니다.

예시를 보려면 삭제 작업에 hint 지정을 참조하세요.

행동

삭제 순서

db.collection.deleteOne()(은)는 필터와 일치하는 첫 번째 문서를 삭제합니다. 정확한 삭제를 위해 _id(과)와 같은 고유 인덱스의 일부인 필드를 사용합니다.

샤드 컬렉션

샤딩된 컬렉션에서 db.collection.deleteOne()을 사용하려면 다음을 수행합니다.

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

  • limit: 1 를 설정하면 쿼리 사양에 샤드 키 또는 _id 필드를 제공할 필요가 없습니다.

트랜잭션

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

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

중요

대부분의 경우 분산 트랜잭션은 단일 문서 쓰기에 비해 더 큰 성능 비용이 발생하므로 분산 트랜잭션의 가용성이 효과적인 스키마 설계를 대체할 수는 없습니다. 대부분의 시나리오에서 비정규화된 데이터 모델 (내장된 문서 및 배열) 은 계속해서 데이터 및 사용 사례에 최적일 것입니다. 즉, 대부분의 시나리오에서 데이터를 적절하게 모델링하면 분산 트랜잭션의 필요성이 최소화됩니다.

추가 트랜잭션 사용 고려 사항(예: 런타임 제한 및 oplog 크기 제한)은 프로덕션 고려사항을 참조하세요.

oplog 항목

db.collection.deleteOne() 작업이 문서를 성공적으로 삭제하면 이 작업은 oplog에 항목을 추가합니다. 이 작업이 실패하거나 삭제할 문서를 찾지 못하면 oplog에 항목을 추가하지 않습니다.

예시

단일 문서 삭제

orders 컬렉션에는 다음과 같은 구조의 문서가 있습니다.

db.orders.insertOne(
   {
      _id: ObjectId("563237a41a4d68582c2509da"),
      stock: "Brent Crude Futures",
      qty: 250,
      type: "buy-limit",
      limit: 48.90,
      creationts: ISODate("2015-11-01T12:30:15Z"),
      expiryts: ISODate("2015-11-01T12:35:15Z"),
      client: "Crude Traders Inc."
   }
)

다음 작업은 _id: ObjectId("563237a41a4d68582c2509da")로 순서를 삭제합니다.

try {
   db.orders.deleteOne( { _id: ObjectId("563237a41a4d68582c2509da") } );
} catch (e) {
   print(e);
}

이 연산은 다음을 반환합니다.

{ acknowledged: true, deletedCount: 1 }

다음 연산은 expiryts가 ISODate("2015-11-01T12:40:15Z")보다 큰 첫 번째 문서를 삭제합니다.

try {
   db.orders.deleteOne( { expiryts: { $lt: ISODate("2015-11-01T12:40:15Z") } } );
} catch (e) {
   print(e);
}

이 연산은 다음을 반환합니다.

{ acknowledged: true, deletedCount: 1 }

쓰기 고려를 포함하는 deleteOne()

3명으로 구성된 멤버 복제본 세트가 있는 경우 다음 작업은 majority의 w 및 100의 wtimeout 을 지정합니다.

try {
   db.orders.deleteOne(
       { _id: ObjectId("563237a41a4d68582c2509da") },
       { w: "majority", wtimeout: 100 }
   );
} catch (e) {
   print (e);
}

승인이 wtimeout 제한보다 오래 걸리면 다음 예외가 발생합니다.

WriteConcernError({
   code: 64,
   errmsg: "waiting for replication timed out",
   errInfo: {
     wtimeout: true,
     writeConcern: {
       w: "majority",
       wtimeout: 100,
       provenance: "getLastErrorDefaults"
     }
   }
})

팁

다음도 참조하세요.

WriteResult.writeConcernError

데이터 정렬 지정

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

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

db.restaurants.insertMany( [
   { _id: 1, category: "café", status: "A" },
   { _id: 2, category: "cafe", status: "a" },
   { _id: 3, category: "cafE", status: "a" }
] )

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

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

hint 삭제 작업에 지정

mongosh에서 다음 문서를 사용하여 students 컬렉션을 생성하세요.

db.members.insertMany( [
   { _id: 1, student: "Richard", grade: "F", points: 0 },
   { _id: 2, student: "Jane", grade: "A", points: 60 },
   { _id: 3, student: "Adam", grade: "F", points:  0 },
   { _id: 4, student: "Ronan", grade: "D", points: 20 },
   { _id: 5, student: "Noah", grade: "F", points:  0 },
   { _id: 6, student: "Henry", grade: "A", points: 86 }
] )

컬렉션에 다음 인덱스를 만듭니다:

db.members.createIndex( { grade: 1 } )

다음 업데이트 작업은 인덱스 { grade: 1 }을(를) 사용하도록 명시적으로 암시합니다.

db.members.deleteOne(
   { points: { $lte: 20 }, grade: "F" },
   { hint: { grade: 1 } }
)

참고

존재하지 않는 인덱스를 지정하면 연산 오류가 발생합니다.

삭제 명령은 다음을 반환합니다.

{ acknowledged: true, deletedCount: 1 }

사용된 인덱스를 보려면 $indexStats 파이프라인을 사용할 수 있습니다.

db.members.aggregate( [ { $indexStats: { } }, { $sort: { name: 1 } } ] )

$indexStats 출력의 accesses.ops 필드는 인덱스를 사용한 작업의 수를 나타냅니다.

팁

다음도 참조하세요.

여러 문서를 삭제하려면 다음을 참조하세요. db.collection.deleteMany()

돌아가기

db.collection.deleteMany

다음

db.collection.distinct

이 페이지의 내용