db.collection.dropIndexes()

Definition定义

db.collection.dropIndexes()

Important

mongosh Method

This page documents a mongosh method. 本页记录了一个mongosh方法。This is not the documentation for database commands or language-specific drivers, such as Node.js.这不是数据库命令或特定语言驱动程序（如Node.js）的文档。

For the database command, see the dropIndexes command.有关数据库命令，请参阅dropIndexes命令。

For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.有关MongoDB API驱动程序，请参阅特定语言的MongoDB驱动程序文档。

For the legacy mongo shell documentation, refer to the documentation for the corresponding MongoDB Server release:对于遗留的mongoshell文档，请参阅相应MongoDB Server版本的文档：

mongo shell v4.4

Drops the specified index or indexes (except the index on the _id field and the last remaining shard key index) from a collection.从集合中删除指定的一个或多个索引（_id字段上的索引和最后一个剩余的分片键索引除外）。

You can use the method to:您可以使用该方法：

• Drop all but the _id index from a collection.从集合中删除除_id索引之外的所有索引。

  db.collection.dropIndexes()

• Drop a specified index from a collection. 从集合中删除指定的索引。To specify the index, you can pass the method either:要指定索引，可以传递以下方法之一：
  • The index specification document (unless the index is a text index in which case, use the index name to drop):索引规范文档（除非索引是text索引，否则请使用索引名称删除）：

    db.collection.dropIndexes( { a: 1, b: 1 } )

  • The index name:索引名称：

    db.collection.dropIndexes( "a_1_b_1" )

    Tip

    To get the names of the indexes, use the db.collection.getIndexes() method.要获取索引的名称，请使用db.collection.getIndexes()方法。

• Drop specified indexes from a collection. 从集合中删除指定的索引。(Available starting in MongoDB 4.2)（从MongoDB 4.2开始提供）. To specify multiple indexes to drop, pass the method an array of index names:。若要指定要删除的多个索引，请向该方法传递一个索引名称数组：

  db.collection.dropIndexes( [ "a_1_b_1", "a_1", "a_1__id_-1" ] )

  If the array of index names includes a non-existent index, the method errors without dropping any of the specified indexes.如果索引名称数组包含不存在的索引，则该方法将在不删除任何指定索引的情况下出错。

  Tip

  To get the names of the indexes, use the db.collection.getIndexes() method.要获取索引的名称，请使用db.collection.getIndexes()方法。

The db.collection.dropIndexes() method takes the following optional parameter:db.collection.dropIndexes()方法采用以下可选参数：

Parameter参数	Type类型	Description描述
indexes	string or document or array of strings字符串、文档或字符串数组	Optional.可选的。Specifies the index or indexes to drop.指定要删除的索引。 To drop all but the _id index from the collection从集合中删除除_id索引以外的所有索引, omit the parameter.，省略参数。 To drop a single index若要删除单个索引, specify either the index name, the index specification document (unless the index is a text index), or an array of the index name. ，请指定索引名称、索引规范文档（除非索引是文本索引）或索引名称的数组。To drop a text index, specify the index name or an array of the index name instead of the index specification document.若要删除text索引，请指定索引名称或索引名称的数组，而不是索引规范文档。 To drop multiple indexes若要删除多个索引 (Available starting in MongoDB 4.2)（从MongoDB 4.2开始提供）, specify an array of the index names. ，指定索引名称的数组。

Behavior行为

Starting in MongoDB 6.0, db.collection.dropIndexes() raises an error if you attempt to use it to remove the last remaining shard key compatible index. 从MongoDB 6.0开始，如果您试图使用db.collection.dropIndexes()来删除最后一个剩余的分片键兼容索引，则会引发错误。Passing "*" to db.collection.dropIndexes() drops all indexes except the _id index and the last remaining shard key compatible index, if one exists.将"*"传递给db.collection.dropIndexes()将删除除_id索引和最后一个剩余的分片键兼容索引（如果存在）之外的所有索引。

Starting in MongoDB 5.2, you can use db.collection.dropIndexes() to drop existing indexes on the same collection even if there is a build in progress on another index. 从MongoDB 5.2开始，您可以使用db.collection.dropIndexes()删除同一集合上的现有索引，即使在另一个索引上正在进行构建。In earlier versions, attempting to drop a different index during an in-progress index build results in a BackgroundOperationInProgressForNamespace error.在早期版本中，在正在进行的索引生成过程中尝试删除其他索引会导致BackgroundOperationInProgressForNamespace错误。