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() メソッドを使用します。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

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

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