db. コレクション.drop()（mongoshメソッド）

定義

db.collection.drop(<options>)

データベースからコレクションまたは ビューを削除します。このメソッドでは、削除されたコレクションに関連付けられているインデックスも削除されます。drop() は、drop コマンドのラッパーです。

次の値を返します。	true

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

drop()メソッドの形式は次のとおりです。

db.collection.drop( { writeConcern: <document> } )

drop() メソッドは、次のフィールドを持つ任意のドキュメントを受け取ります。

動作

• drop()メソッドとdrop コマンドは、削除されたコレクションで開かれた 変更ストリーム の 無効化イベント を作成します。

• db.collection.drop() メソッドと drop コマンドは、コレクションを削除する前に、ターゲット コレクションで進行中のインデックス構築を中止します。

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

• コレクションを削除すると、それに関連付けられたゾーンやタグの範囲も削除されます。

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

  警告

  管理データベースまたは構成データベース内のコレクションを削除すると、クラスターが使用できない状態になる可能性があります。

• MongoDB 6.0 以降では、drop() により、指定されたコレクションと暗号化されたフィールドに関連するあらゆる内部コレクションが削除されます。

  重要

  mongosh drop() メソッドの動作は、ドライバーの drop メソッドの動作と異なります。指定されたコレクションと暗号化されたフィールドに関連する内部コレクションの両方を削除するには、ドライバーの接続で自動暗号化が有効になっている必要があります。指定されたコレクションと暗号化されたフィールドに関連する内部コレクションの両方が mongosh により必ず削除されます。

例

db.students.drop()

db.students.drop( { writeConcern: { w: 1, j: true } } )