drop（数据库命令）

定义

drop

drop命令从数据库中删除整个集合。

提示

在 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() 会为在删除的集合上打开的任何MongoDB Change Streams创建无效事件。

• 删除集合将删除其关联的区域/标记范围。

• 从MongoDB5.0 开始，如果您尝试从 删除 管理员数据库drop 或db.collection.drop() 配置数据库 中的集合，mongos 命令和 方法会返回错误。要删除这些集合，请连接到配置服务器并在其中运行命令。

  警告

  删除管理员数据库或配置数据库中的集合会使集群处于不可用状态。