제거
정의
drop
drop
명령은 데이터베이스에서 전체 컬렉션을 제거합니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
참고
이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하십시오.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령의 구문은 다음과 같습니다.
db.runCommand( { drop: <collection_name>, writeConcern: <document>, comment: <any> } )
명령 필드
이 명령은 다음 필드를 사용합니다.
필드 | 설명 |
---|---|
drop | 제거할 컬렉션의 이름입니다. |
writeConcern | 선택 사항입니다. 샤딩된 클러스터에서 실행하는 경우 |
comment | 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. |
mongosh
는 이에 상응하는 헬퍼 메서드 db.collection.drop()
를 제공합니다.
행동
MongoDB 5.0 부터 인식할 수 없는 매개 변수를 전달하면
drop
명령과db.collection.drop()
메서드에서 오류가 발생합니다.이 명령은 삭제된 컬렉션 과 관련된 모든 인덱스도 제거합니다.
db.collection.drop()
메서드 및drop
명령은 컬렉션 을 삭제하기 전에 대상 컬렉션 에서 진행 중인 모든 인덱스 빌드를 중단합니다.복제본 세트 또는 샤드 복제본 세트의 경우 기본 인덱스에서 인덱스를 중단해도 보조 인덱스 빌드가 동시에 중단되지는 않습니다. MongoDB가 프라이머리 인덱스에서 지정된 인덱스에 대해 진행 중인 빌드를 중단하려고 시도하고 성공하면 연결된
abort
oplog 항목을 생성합니다. 복제된 진행 중인 빌드가 있는 세컨더리 멤버는 인덱스 빌드를 커밋하거나 중단하기 전에 프라이머리에서 oplog 항목을 커밋하거나 중단할 때까지 기다립니다.drop
명령과 해당 헬퍼 는 삭제된 컬렉션 에서 열린 Change Streams 모든db.collection.drop()
에 대한 무효화 를 생성합니다.컬렉션을 제거하면 관련된 영역/태그 범위가 삭제됩니다.
MongoDB 부터 5.0 관리 데이터베이스 또는 config 데이터베이스 에서 컬렉션 을
drop
db.collection.drop()
삭제하려고 하면 명령과mongos
메서드가 { } 오류를 반환합니다. 이러한 컬렉션을 삭제하려면 config 서버 에 연결하여 해당 서버에서 명령을 실행 합니다.경고
관리 데이터베이스 또는 config 데이터베이스에서 collection을 제거하면 클러스터가 사용할 수 없는 상태가 될 수 있습니다.
리소스 잠금
drop
은 작업 기간 동안 지정된 컬렉션에 대한 배타 락을 얻습니다. 컬렉션에 대한 모든 후속 작업은 drop
이 잠금을 해제할 때까지 기다려야 합니다.