db.collection.dropIndexes() (mongosh method方法)

Definition定义

db.collection.dropIndexes()

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. 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, omit the parameter.要从集合中删除除_id索引之外的所有索引，请省略该参数。 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. 要删除单个索引，请指定索引名称、索引规范文档（除非索引是text索引）或索引名称的数组。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, specify an array of the index names.若要删除多个索引，请指定一个索引名称数组。

Compatibility兼容性

This method is available in deployments hosted in the following environments:此方法在以下环境中托管的部署中可用：

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud：云中MongoDB部署的完全托管服务

• MongoDB Enterprise: The subscription-based, self-managed version of MongoDB：MongoDB的基于订阅的自我管理版本
• MongoDB Community: The source-available, free-to-use, and self-managed version of MongoDB：MongoDB的源代码可用、免费使用和自我管理版本

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.

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错误。