db. 集合.drop()（mongosh方法）

带驱动程序的 MongoDB

此页面记录了mongosh方法。要查看MongoDB驾驶员中的等效方法，请参阅您的编程语言的相应页面：

定义

db.collection.drop(<options>)

从数据库中删除集合或视图。该方法还会删除与删除的集合关联的任何索引。drop() 是 drop 命令的包装器。

返回：	`true`

注意

如果指定的集合不存在， db.collection.drop() 仍返回 true。

此方法可用于以下环境中托管的部署：

注意

所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。

drop()方法采用以下形式：

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

drop() 方法接受带有以下字段的可选文档：

字段	说明
writeConcern	可选.表达 `drop()` 操作的写关注（write concern）的文档。省略以使用默认的写关注（write concern）。在分片集群上发出时，`mongos` 将 `drop` 命令和其辅助程序 `db.collection.drop()` 的写关注转换为 `"majority"`。

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 始终删除指定的集合以及与加密字段相关的任何内部集合。

对于运行 MongoDB 5.0 或更高版本的分片集群，无需执行任何特殊动作。使用 drop() 方法，然后创建具有相同名称的新集合。

db.collection.drop() 在操作期间获得对指定集合的独占锁。对集合的所有后续操作都必须等到 db.collection.drop() 释放该锁为止。

以下操作会删除当前数据库中的 students 集合。

db.students.drop()

以下操作会删除当前数据库中的 students 集合。该操作使用 1 写关注：

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