db.コレクション.dropIndexes()（mongoshメソッド）

定義

db.collection.dropIndexes()

指定された 1 つまたは複数のインデックス（_id フィールドのインデックスと最後に残ったシャード キー インデックスを除く）をコレクションから削除します。

この方法を使用すると、次のことができます。

• コレクションから _id インデックス以外を削除します。

  db.collection.dropIndexes()

• コレクションから指定したインデックスを削除します。 インデックスを指定するには、次のいずれかのメソッドを渡します。

  • インデックス仕様ドキュメント（インデックスが テキストインデックスでない限り、インデックス名を使用して削除します）:

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

  • インデックス名

    db.collection.dropIndexes( "a_1_b_1" )

    Tip

    インデックスの名前を取得するには、db.collection.getIndexes() メソッドを使用します。

• コレクションから指定したインデックスを削除します。 削除するインデックスを複数指定するには、 メソッドにインデックス名の配列を渡します。

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

  インデックス名の配列に存在しないインデックスが含まれている場合、メソッドは指定されたインデックスを削除せずにエラーを出します。

  Tip

  インデックスの名前を取得するには、db.collection.getIndexes() メソッドを使用します。

db.collection.dropIndexes()メソッドでは、次の任意パラメーターが使われます。

Parameter	タイプ	説明
indexes	string またはドキュメントまたは string の配列	オプション。 削除するインデックスを指定します。 _id インデックス以外のすべてをコレクションから削除するには、パラメーターを省略します。 単一のインデックスを削除するには、インデックス名、インデックス仕様ドキュメント（インデックスがテキストインデックスの場合を除く）、またはインデックス名の配列のいずれかを指定します。テキストインデックスを削除するには、インデックス指定ドキュメントの代わりにインデックス名またはインデックス名の配列を指定します。 複数のインデックスを削除するには 、インデックス名の配列を指定します。

動作

MongoDB 6.0以降、最後に残っているシャードキー互換インデックスを削除するために使用しようとすると、 db.collection.dropIndexes()によりエラーが発生します。 "*"をdb.collection.dropIndexes()に渡すと、 _idインデックスと最後に残っているシャードキー互換インデックス（存在する場合）を 除く すべてのインデックスが削除されます。

MongoDB 5.2以降では、別のインデックスでビルドが進行中の場合でも、 db.collection.dropIndexes()を使用して同じコレクションの既存のインデックスを削除できます。 以前のバージョンでは、インデックスのビルドが進行中に別のインデックスを削除しようとするとBackgroundOperationInProgressForNamespaceエラーが発生していました。