dropIndexes

在此页面上

定义

兼容性
语法
命令字段
行为
示例

定义

dropIndexes: 在 6.0 版本中进行了更改。
dropIndexes命令从指定集合中删除一个或多个索引（ _id字段上的索引和最后剩余的分片键索引（如果存在）除外）。
提示
在mongosh中，该命令还运行通过 db.collection.dropIndex()和db.collection.dropIndexes()辅助方法运行。
辅助方法对 mongosh 用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。

兼容性

此命令可用于以下环境中托管的部署：

MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

注意

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

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令具有以下语法：

db.runCommand(
   {
     dropIndexes: <string>,
     index: <string|document|arrayofstrings>,
     writeConcern: <document>, comment: <any>
   }
)

命令字段

该命令接受以下字段：

字段	类型	说明
dropIndexes	字符串	要删除索引的集合名称。
索引（index）	字符串或文档或字符串数组	要删除的一个或多个索引。要从集合中删除除 `_id` 索引和最后剩下的分片键索引（如果存在）之外的所有索引，请指定 `""`。要删除单个索引*，请指定索引名称、索引规范文档（除非该索引是文本索引）或索引名称的数组。要删除文本索引，请指定索引名称，而不是索引规范文档。如果此索引是最后剩下的分片键索引，则 `dropIndexes` 会引发错误。要删除多个索引，请指定索引名称的数组。
writeConcern	文档	可选。表达命令写关注（write concern） `drop`的文档。省略以使用默认的写关注（write concern）。
`comment`	any	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 `attr.command.cursor.comment` 字段中。 `command.comment` 字段中的数据库分析器输出。 `currentOp` 输出，在 `command.comment` 字段。注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

行为

从 MongoDB 6.0 开始，如果您尝试使用它来删除最后剩下的分片键兼容索引，dropIndexes 会引发错误。将 "*" 传递给 dropIndexes 会删除除 _id 索引和最后剩下的分片键兼容索引（如果存在）之外的所有索引。

从 MongoDB 5.2 开始，即使另一个索引正在构建中，也可以使用 dropIndexes 删除同一个集合上的现有索引。在早期版本中，尝试在进行中的索引构建期间删除其他索引会导致 BackgroundOperationInProgressForNamespace 错误。

仅终止相关查询

dropIndexes 操作只会终止使用被删除索引的查询。这可能包括在查询规划中考虑索引的查询。

资源锁定

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

索引名称

如果该方法传递给包含不存在索引的索引名称数组，则该方法会出错，但不会删除任何指定索引。

`_id` Index

不能删除 _id 字段上的默认索引。

text Indexes

要删除文本索引，请指定索引名称而不是索引规范文档。

停止进行中的索引构建

如果为 dropIndexes 指定的索引仍在构建中，dropIndexes 会尝试停止正在进行的构建。停止索引构建与删除已构建的索引效果相同。

对于副本集，请在主节点上运行 dropIndexes。主节点停止索引构建并创建关联的“abortIndexBuild”oplog 条目。复制“abortIndexBuild”oplog 条目的从节点会停止正在进行的索引构建并放弃构建作业。有关索引构建过程的详细文档，请参阅索引构建流程。

使用 currentOp 确定与 createIndexes 或 db.collection.createIndexes() 操作相关的索引构建。有关示例，请参阅主动索引操作。

Hidden Indexes

MongoDB 提供对查询规划器隐藏或取消隐藏索引的功能。通过向规划器隐藏索引，您可以评估在不实际删除索引的情况下删除索引的潜在影响。

如果经过评估后，用户决定删除该索引，则您可以删除隐藏索引；即不需要先取消隐藏才能删除。

如有不利影响，用户可以取消隐藏索引，而不必重新创建已删除的索引。由于索引在隐藏期间得到完全维护，因此一旦取消隐藏，索引就立即可用。

有关隐藏索引的更多信息，请参阅隐藏索引。

示例

要删除所有非_id 索引，请为"*" 指定index 。
```
db.runCommand( { dropIndexes: "collection", index: "*" } )
```
要删除单个索引，请通过指定要删除的索引的名称来发出命令。例如，要删除名为 age_1 的索引，请使用以下命令：
```
db.runCommand( { dropIndexes: "collection", index: "age_1" })
```
mongosh提供了辅助方法db.collection.dropIndex()和db.collection.dropIndexes() ：
```
db.collection.dropIndex("age_1");
```
要删除多个索引，请通过指定索引名称数组来发出命令：
```
db.runCommand( { dropIndexes: "collection", index: [ "age_1", "age_1_status_1" ] } )
```

提示

另请参阅：

后退

dropConnections

来年

filemd5

定义

提示

兼容性

注意

语法