db.dropDatabase()

ロック

この操作では、排他（X）データベース ロックのみが使用されます。

ユーザー管理

このコマンドは、現在のデータベースに関連付けられているユーザーは削除しません。関連付けられているユーザーを削除するには、削除するデータベースでdropAllUsersFromDatabaseコマンドを実行します。

Indexes

db.dropDatabase()メソッドとdropDatabaseコマンドは、データベースを削除する前に、ターゲット データベース内のコレクションに対して進行中のインデックスのビルドを中止します。 インデックスのビルドを中止すると、ビルドされたインデックスを削除するのと同じ効果があります。

レプリカセットまたはシャーディングされたレプリカセットの場合、プライマリでインデックスを中止しても、セカンダリでのインデックス構築は同時に中止されません。MongoDB は、指定されたインデックスの進行中の構築をプライマリで中止しようとし、成功した場合には関連する abort の oplog エントリを作成します。進行中の構築が複製されたセカンダリ ノードは、インデックス構築をコミットまたは中止する前に、プライマリからのコミットまたは中止の oplog エントリを待ちます。

レプリカセットとシャーディングされたクラスター

レプリカセット

少なくとも、 db.dropDatabase()は、データベース内のすべてのコレクションの削除がレプリカセット ノードの大部分に伝播するまで待機します（つまり は書込み保証（write concern） "majority"を使用します）。

メソッドに書込み保証 (write concern)を指定することができます。過半数よりも少ないユーザーからの承認を必要とする書込み保証 (write concern)を指定した場合、メソッドは書込み保証 (write concern) "majority" を使用します。

過半数以上の承認を必要とする書き込み保証を指定した場合、メソッドでは指定した書き込み保証が使用されます。

シャーディングされたクラスター

シャーディングされたクラスターで発行されると、MongoDB は指定された書込み保証 (write concern) を "majority" に変換します。

削除されたデータベースと同じ名前で新しいデータベースを作成する場合は、mongos で dropDatabase コマンドを実行する必要があります

これにより、すべてのクラスター ノードがメタデータ キャッシュを更新します。これには、新しいデータベースのプライマリ シャードのロケーションが含まれます。 そうしないと、読み取りのデータが失われる可能性があり、正しいシャードにデータが書き込まれない可能性があります。 回復するには、手動で中断する必要があります。

MongoDB 5.0 以降では、管理データベースまたはコンフィギュレーションデータベースを mongos から削除しようとすると、dropDatabase コマンドと db.dropDatabase() メソッドによってエラーが返されます。

警告

管理データベースまたはコンフィギュレーションデータベースを削除 (drop) すると、クラスターが使用できない状態になる可能性があります。

変更ストリーム

db.dropDatabase() メソッドと dropDatabase コマンドは、削除されたデータベースまたは削除されたデータベース内のコレクションで開かれているすべての Change Streams に対して無効化を作成します。