drop（データベースコマンド）

定義

drop

dropコマンドは、データベースからコレクション全体を削除します。

Tip

mongoshでは、このコマンドは drop()ヘルパー メソッドを通じて実行することもできます。

ヘルパー メソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。 便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、 データベースコマンドを使用します。

互換性

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

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

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

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

構文

コマンドの構文は次のとおりです。

db.runCommand(
   {
     drop: <collection_name>,
     writeConcern: <document>,
     comment: <any>
   }
)

コマンドフィールド

このコマンドは、次のフィールドを使用します。

mongoshは同等のヘルパー メソッドdb.collection.drop()を提供します。

動作

• MongoDB 5.0以降、 dropコマンドとdb.collection.drop()メソッドでは、認識されないパラメータが渡された場合にエラーが発生します。

• このコマンドでは、削除対象のコレクションに関連付けられているインデックスも削除されます。

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

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

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

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

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

  警告

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