インデックスの管理

既存のインデックスを表示

MongoDB Shell

Compass

次のセクションでは、コレクションまたはデータベース全体の既存のインデックスを表示する方法について説明します。

コレクションのすべてのインデックスの一覧表示

コレクションのすべてのインデックスのリストを返すには、db.collection.getIndexes() メソッドまたは、ドライバーの同様のメソッドを使用します。

例えば、 peopleコレクションのすべてのインデックスを表示するには、次のコマンドを実行します。

db.people.getIndexes()

データベースのすべてのインデックスの一覧表示

データベース内のすべてのコレクション インデックスを一覧表示するには、 mongoshで次のコマンドを実行します。

db.getCollectionNames().forEach(function(collection) {
    indexes = db[collection].getIndexes();
    print("Indexes for " + collection + ":");
    printjson(indexes);
});

特定の種類のインデックスの一覧表示

すべてのデータベース内のすべてのコレクションの特定のタイプ（ハッシュやテキストなど）のすべてのインデックスを一覧表示するには、 mongoshで次のコマンドを実行します。

// The following finds all hashed indexes
db.adminCommand("listDatabases").databases.forEach(function(d){
    let mdb = db.getSiblingDB(d.name);
    mdb.getCollectionInfos({ type: "collection" }).forEach(function(c){
      let currentCollection = mdb.getCollection(c.name);
      currentCollection.getIndexes().forEach(function(idx){
        let idxValues = Object.values(Object.assign({}, idx.key));
        if (idxValues.includes("hashed")) {
          print("Hashed index: " + idx.name + " on " + d.name + "." + c.name);
          printjson(idx);
        };
      });
    });
});

MongoDB Compass のコレクションにあるすべてのインデックスのリストを表示するには、左側のペインで対象のコレクションをクリックし、 Indexesタブを選択します。

このタブに表示される情報の詳細については、 Compass のドキュメント を参照してください。

インデックスを削除する

既存のインデックスを削除する方法については、「インデックスの削除」を参照してください。

MongoDB Compass でインデックスを削除する方法については、「 Compass でのインデックスの管理 」を参照してください。

インデックスを変更する

db.siteAnalytics.createIndex( { "url": 1 } )

url_1

db.siteAnalytics.createIndex( { "url": 1, "dummyField": 1 } )

url_1_dummyField_1

db.siteAnalytics.dropIndex( { "url_1" } )

{ nIndexesWas: 3, ok: 1 }

db.siteAnalytics.createIndex( { "url": 1 }, { "unique": true } )

url_1

db.siteAnalytics.dropIndex( { "url_1_dummyField_1" } )

{ nIndexesWas: 3, ok: 1 }

db.siteAnalytics.getIndexes()

[
  { v: 2, key: { _id: 1 }, name: '_id_' },
  { v: 2, key: { url: 1 }, name: 'url_1', unique: true }
]

シャード間で一貫性のないインデックスを見つける

コレクションのチャンクを含む各シャードにまったく同じインデックス（インデックスオプションを含む）がない場合、シャーディングされたコレクションのインデックスには一貫性がありません。通常の操作では一貫性のないインデックスは発生しないはずですが、次のような一貫性のないインデックスが発生する可能性があります。

• ユーザーが unique キー制約を使用してインデックスを作成していて、1 つのシャードに重複ドキュメントを含むチャンクが含まれている場合。このような場合、インデックスの作成操作は、重複のないシャードでは成功するものの、重複のあるシャードでは成功しない可能性があります。

• ユーザーが複数のシャードにわたってインデックスをローリング処理で作成している（複数のシャードにわたって手作業でインデックスを 1 つずつ構築している）時、関連付けられたシャードのインデックス作成に失敗した場合、または異なる仕様で誤ったインデックスを構築した場合。

コンフィギュレーションサーバーのプライマリにより、デフォルトでは、シャーディングされたコレクションのシャード間でのインデックスの不整合がチェックされます。コマンドserverStatusがコンフィギュレーションサーバーのプライマリで実行されると、フィールドshardedIndexConsistencyが返され、インデックスの不整合があるシャーディングされたコレクションの数を報告します。

shardedIndexConsistencyでインデックスの不一致が報告された場合は、シャーディングされたコレクションに対してcheckMetadataConsistency を使用してcheckIndexes: true コマンドを実行し、不整合を見つけることができます。

1. checkMetadataConsistencyコマンドを実行します。

   db.runCommand( {
      checkMetadataConsistency: 1,
      checkIndexes: true
   } )

2. コレクションに一貫性のないインデックスがある場合、checkMetadataConsistency コマンドは、一貫性のないインデックスに関する次のような詳細を返します。

   {
     cursor: {
       id: Long('0'),
       ns: 'test.$cmd.aggregate',
       firstBatch: [
         {
           type: 'InconsistentIndex',
           description: 'Found an index of a sharded collection that is inconsistent between different shards',
           details: {
             namespace: 'test.reviews',
             info: {
               missingFromShards: [],
               inconsistentProperties: [
                 { k: 'expireAfterSeconds', v: Long('600') },
                 { k: 'expireAfterSeconds', v: 3600 }
               ],
               indexName: 'reviewDt_1'
             }
           }
         },
         {
           type: 'InconsistentIndex',
           description: 'Found an index of a sharded collection that is inconsistent between different shards',
           details: {
             namespace: 'test.reviews',
             info: {
               missingFromShards: [ 'shard02' ],
               inconsistentProperties: [],
               indexName: 'page_1_score_1'
             }
           }
         }
       ]
     },
     ok: 1,
     '$clusterTime': {
       clusterTime: Timestamp({ t: 1752574769, i: 1 }),
       signature: {
         hash: Binary.createFromBase64('AAAAAAAAAAAAAAAAAAAAAAAAAAA=', 0),
         keyId: Long('0')
       }
     },
     operationTime: Timestamp({ t: 1752574760, i: 1 })
   }

   出力には、シャーディングされたコレクションtest.reviews に 2つの不整合があることが示されています。

   1. reviewDt_1 という名前のインデックスには、コレクションのシャード間で一貫性のないプロパティがあります。特に expireAfterSeconds プロパティが異なります。

   2. page_1_score_1 という名前のインデックスが shard02のコレクションにありません。

特定のシャードのコレクションからインデックスが欠落しているという不整合を解決するには、

次のいずれかを実行できます。

• インデックス構築db.collection.createIndex()をインスタンスから mongos発行します。この操作では、インデックスがないシャードにのみコレクションのインデックスが構築されます。

  -あるいは-

• 影響を受けたシャードでコレクションのローリングインデックス構築を実行します。

  注意

  ローリング インデックスはデプロイに影響可能性があります。 このインデックス構築 をいつ使用するかについては、「 ローリング インデックス ビルド 」を参照してください。

シャード間でインデックス プロパティが異なる箇所を解決するには、

影響を受けるシャード上のコレクションから誤ったインデックスを削除し、インデックスを再構築します。インデックスを再構築するには、次のいずれかを実行します。

• インデックス構築db.collection.createIndex()をインスタンスから mongos発行します。この操作では、インデックスがないシャードにのみコレクションのインデックスが構築されます。

  -あるいは-

• 影響を受けたシャードでコレクションのローリングインデックス構築を実行します。

  注意

  ローリング インデックスはデプロイに影響可能性があります。 このインデックス構築 をいつ使用するかについては、「 ローリング インデックス ビルド 」を参照してください。

あるいは、expireAfterSeconds プロパティに不整合がある場合は、インデックスを削除して再構築する代わりに collMod コマンドを実行して秒数をアップデートすることもできます。