MongoDB\Collection::dropIndexes()

定义

MongoDB\Collection::dropIndexes()

删除collection中的所有索引，但_id字段上所需的索引除外。

function dropIndexes(array $options = []): array|object

参数

$indexName ：细绳| MongoDB\Model\IndexInfo

要删除的索引的名称或模型对象。使用MongoDB\Collection::listIndexes()方法查看集合上的现有索引。

$options : array

指定所需选项的数组。

名称	类型	说明
comment	混合	允许用户指定任意注释，以帮助通过数据库分析器、 currentOp输出和日志跟踪操作。自 MongoDB 4.4 起此选项可用，如果为旧服务器版本指定，则会在执行时导致异常。 1.13 版本中的新增功能。
maxTimeMS	整型	处理游标操作的累计时间限制（以毫秒为单位）。MongoDB 最早会在中断点之后中止操作。 1.3 版本中的新增功能。
会话	MongoDB\Driver\Session	与操作相关联的客户端会话。 1.3 版本中的新增功能。
typeMap	阵列	应用游标的类型映射，决定如何将BSON文档转换为PHP值。默认为集合的类型映射。这将用于返回的命令结果文档。
writeConcern	MongoDB\Driver\WriteConcern	写关注用于操作。默认为集合的写关注。无法将单个操作的写关注（write concern）指定为ACID 事务的一部分。相反，请在启动ACID`writeConcern` 事务时设立选项。

Return Values

包含dropIndexes命令的结果文档的大量或对象。返回类型将取决于typeMap选项。

错误/异常

MongoDB\Exception\UnsupportedException，如果所选服务器使用了选项但不支持选项（例如collation、readConcern、writeConcern）。

MongoDB\Exception\InvalidArgumentException 用于与参数或选项解析相关的错误。

MongoDB\ 驱动程序\Exception\RuntimeException 用于扩展级别的其他错误（例如连接错误）。

例子

以下操作会从test数据库的restaurantscollection中删除所有索引：

<?php
$collection = (new MongoDB\Client)->test->restaurants;
$result = $collection->dropIndexes();
var_dump($result);

而输出将类似如下所示：

object(MongoDB\Model\BSONDocument)#9 (1) {
  ["storage":"ArrayObject":private]=>
  array(3) {
    ["nIndexesWas"]=>
    int(3)
    ["msg"]=>
    string(38) "non-_id indexes dropped for collection"
    ["ok"]=>
    float(1)
  }
}

另请参阅

后退

dropIndex()

来年

dropSearchIndex()