dropDatabase
정의
dropDatabase
dropDatabase
명령은 현재 데이터베이스를 삭제하고 관련 데이터 파일을 삭제합니다.명령의 형식은 다음과 같습니다.
{ dropDatabase: 1, writeConcern: <document>, comment: <any> } 이 명령은 다음과 같은 선택적 필드를 사용합니다.
필드 | 설명 | |
---|---|---|
writeConcern | 선택 사항.보다 큰 경우 사용할 쓰기
복제본 세트에서 실행될 때 지정된 쓰기 고려 (write concern)로 인해 쓰기 고려 (write concern) 샤드 클러스터에서 실행되면 MongoDB는 지정된 쓰기 고려를 동작도 참조하세요. | |
comment | 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. |
mongosh
는 도우미 메서드 db.dropDatabase()
도 제공합니다.
행동
잠금
작업에는 배타적 (X) 데이터베이스 잠금만 사용됩니다.
사용자 관리
이 명령은 현재 데이터베이스와 연결된 사용자를 삭제하지 않습니다. 연결된 사용자를 삭제하려면 삭제하려는 데이터베이스에서 dropAllUsersFromDatabase
명령을 실행합니다.
색인
db.dropDatabase()
메서드와 dropDatabase
명령은 데이터베이스를 제거하기 전에 대상 데이터베이스의 컬렉션에서 진행 중인 인덱스 빌드를 중단합니다. 인덱스 빌드를 중단하면 빌드된 인덱스를 제거하는 것과 동일한 효과가 있습니다.
복제본 세트 또는 샤드 복제본 세트의 경우 기본 인덱스에서 인덱스를 중단해도 보조 인덱스 빌드가 동시에 중단되지는 않습니다. MongoDB가 프라이머리 인덱스에서 지정된 인덱스에 대해 진행 중인 빌드를 중단하려고 시도하고 성공하면 연결된 abort
oplog 항목을 생성합니다. 복제된 진행 중인 빌드가 있는 세컨더리 멤버는 인덱스 빌드를 커밋하거나 중단하기 전에 프라이머리에서 oplog 항목을 커밋하거나 중단할 때까지 기다립니다.
복제본 세트 및 샤드 클러스터
- 복제본 세트
최소한
dropDatabase
(은)는 데이터베이스의 모든 컬렉션 제거가 대부분의 복제본 세트 노드에 전파될 때까지 기다립니다(즉, 쓰기 고려"majority"
(을)를 사용합니다).과반수보다 적은 수의 승인이 필요한 쓰기 고려를 지정하는 경우 명령은 쓰기 고려
"majority"
를 사용합니다.과반수 이상의 승인이 필요한 쓰기 고려를 지정하면 명령은 지정된 쓰기 고려를 사용합니다.
- 샤드 클러스터
샤드 클러스터에서 실행되면 MongoDB는 지정된 쓰기 고려를
"majority"
로 변환합니다.삭제된 데이터베이스와 동일한 이름으로 새 데이터베이스를 생성하려면
mongos
에서dropDatabase
명령을 실행해야 합니다.이렇게 하면 모든 클러스터 노드가 새 데이터베이스의 프라이머리 샤드 위치를 포함하는 메타데이터 캐시를 새로 고칠 수 있습니다. 그렇지 않으면 읽기 데이터를 놓칠 수 있으며 올바른 샤드에 데이터를 쓰지 못할 수도 있습니다. 복구하려면 수동으로 개입해야 합니다.
MongoDB 5.0부터는
mongos
에서 관리 데이터베이스 또는 config 데이터베이스를 제거하려고 할 경우,dropDatabase
명령 및db.dropDatabase()
메서드가 오류를 반환합니다.경고
관리 데이터베이스 또는 config 데이터베이스를 삭제하면 클러스터가 사용할 수 없는 상태가 될 수 있습니다.
변경 스트림
db.dropDatabase()
메서드와 dropDatabase
는 제거된 데이터베이스에서 열렸거나 제거된 데이터베이스의 컬렉션에서 열린 모든 Change Streams에 대해 무효화를 생성합니다.
예제
mongosh
의 다음 예에서는 use
<database>
작업을 사용하여 현재 데이터베이스를 temp
데이터베이스로 전환한 다음 dropDatabase
명령을 사용하여 temp
데이터베이스를 삭제합니다.
use temp db.runCommand( { dropDatabase: 1 } )