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 コマンドは、削除されたコレクションで開かれた 変更ストリーム の 無効化イベント を作成します。

• The db.collection.drop() method and drop command abort any in-progress index builds on the target collection before dropping the collection.

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

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

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

  警告

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

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

  重要

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

例

db.students.drop()

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