Docs Menu
Docs Home
/
MongoDBマニュアル
/
参照
/
データベース コマンド
/
管理

drop

項目一覧

  • 定義
  • 互換性
  • 構文
  • コマンドフィールド
  • 動作

定義

drop

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

Tip

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

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

互換性

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

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

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

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

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

構文

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

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

コマンドフィールド

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

フィールド
説明

drop

削除するコレクションの名前。

writeConcern

任意。 コマンドの drop書込み保証（ write concern ） を表すドキュメント。デフォルトの書込み保証を使用する場合は省略します。

シャーディングされたシャーディングされたクラスターで発行すると、mongos は drop コマンドとそのヘルパーdb.collection.drop() の書込み保証 (write concern)保証を "majority" に変換します。

comment

任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。

コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

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

動作

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

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

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

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

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

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

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

    警告

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

リソースのロック

dropは、操作中、指定されたコレクションに対する排他ロックを取得します。 コレクションに対する後続のすべての操作は、 dropがロックを解放するまで待機する必要があります。

戻る

currentOp

次へ

dropDatabase