색인 관리

기존 인덱스 보기

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 키 제약 조건을 사용하여 인덱스를 생성 중이고 하나의 샤드에 중복 문서가 있는 청크가 포함되어 있는 경우와 같이 일관성 없는 인덱스가 발생할 수 있습니다. 이러한 경우 인덱스 생성 작업은 중복이 없는 샤드에서는 성공할 수 있지만 중복이 있는 샤드에서는 실패할 수 있습니다.

• 사용자가 샤드 전체에 걸쳐 인덱스를 롤링 방식(즉, 샤드 전체에 걸쳐 하나씩 수동으로 인덱스를 생성)으로 생성하는 경우, 연결된 샤드에 대한 인덱스를 생성하지 못하거나 다른 사양으로 인덱스를 잘못 생성하는 경우입니다.

기본적으로 config 서버 프라이머리에서 샤드 컬렉션의 샤드에서 일관적이지 않은 인덱스를 확인하며, serverStatus 명령이 config 서버 프라이머리에서 실행되는 경우 일관성 없는 인덱스가 존재하는 샤드 컬렉션의 수를 보고하는 shardedIndexConsistency 필드를 반환합니다.

shardedIndexConsistency에서 인덱스 불일치를 보고하면 불일치를 찾을 때까지 샤딩된 컬렉션에 다음 파이프라인을 실행할 수 있습니다.

1. 다음 집계 파이프라인을 정의합니다.

   const pipeline = [
       // Get indexes and the shards that they belong to.
       {$indexStats: {}},
       // Attach a list of all shards which reported indexes to each document from $indexStats.
       {$group: {_id: null, indexDoc: {$push: "$$ROOT"}, allShards: {$addToSet: "$shard"}}},
       // Unwind the generated array back into an array of index documents.
       {$unwind: "$indexDoc"},
       // Group by index name.
       {
           $group: {
               "_id": "$indexDoc.name",
               "shards": {$push: "$indexDoc.shard"},
               // Convert each index specification into an array of its properties
               // that can be compared using set operators.
               "specs": {$push: {$objectToArray: {$ifNull: ["$indexDoc.spec", {}]}}},
               "allShards": {$first: "$allShards"}
           }
       },
       // Compute which indexes are not present on all targeted shards and
       // which index specification properties aren't the same across all shards.
       {
           $project: {
               missingFromShards: {$setDifference: ["$allShards", "$shards"]},
               inconsistentProperties: {
                    $setDifference: [
                        {$reduce: {
                            input: "$specs",
                            initialValue: {$arrayElemAt: ["$specs", 0]},
                            in: {$setUnion: ["$$value", "$$this"]}}},
                        {$reduce: {
                            input: "$specs",
                            initialValue: {$arrayElemAt: ["$specs", 0]},
                            in: {$setIntersection: ["$$value", "$$this"]}}}
                    ]
                }
           }
       },
       // Only return output that indicates an index was inconsistent, i.e. either a shard was missing
       // an index or a property on at least one shard was not the same on all others.
       {
           $match: {
               $expr:
                   {$or: [
                       {$gt: [{$size: "$missingFromShards"}, 0]},
                       {$gt: [{$size: "$inconsistentProperties"}, 0]},
                   ]
               }
           }
       },
       // Output relevant fields.
       {$project: {_id: 0, indexName: "$$ROOT._id", inconsistentProperties: 1, missingFromShards: 1}}
   ];

2. 테스트할 샤딩 컬렉션에 대한 집계 파이프라인을 실행합니다. 예를 들어 test.reviews 샤딩 컬렉션이 관련 샤드 전반에 일관적이지 않은 인덱스를 보유한 경우 테스트를 위해 아래를 실행합니다.

   db.getSiblingDB("test").reviews.aggregate(pipeline)

   컬렉션에 일관성 없는 인덱스가 포함된 경우 해당 컬렉션의 집계는 이러한 인덱스의 상세 정보를 반환합니다.

   { "missingFromShards" : [ "shardB" ], "inconsistentProperties" : [ ], "indexName" : "page_1_score_1" }
   { "missingFromShards" : [ ], "inconsistentProperties" : [ { "k" : "expireAfterSeconds", "v" : 60 }, { "k" : "expireAfterSeconds", "v" : 600 } ], "indexName" : "reviewDt_1" }

   반환된 문서에 샤드된 collection test.reviews에 대한 두 가지 불일치가 있습니다:

   1. shardB의 컬렉션에서 page_1_score_1 이라는 인덱스가 누락되었습니다.

   2. reviewDt_1 이라는 인덱스에는 컬렉션의 샤드 전체에 일관적이지 않은 속성이 포함되며, 특히 expireAfterSeconds 속성이 다릅니다.

특정 샤드의 컬렉션에서 인덱스가 누락된 불일치를 해결하려면,

둘 중 하나를 수행하면 됩니다.

• 영향을 받는 샤드에서 컬렉션에 대해 롤링 인덱스 빌드를 수행합니다.

  -또는-

• mongos 인덱스에서 db.collection.createIndex() 인스턴스 빌드를 실행합니다. 이 작업은 인덱스가 누락된 샤드에 대해 컬렉션의 인덱스를 작성합니다.

샤드 전반에서 인덱스 속성이 다른 상황을 해결하려면,

컬렉션에서 해당 샤드에 관한 정확하지 않은 인덱스를 제거하고 인덱스를 다시 작성합니다. 다음 두 가지 중 한 가지 방법으로 인덱스를 다시 작성할 수 있습니다.

• 해당 샤드에 관한 컬렉션에 롤링 인덱스 빌드를 실행합니다.

  -또는-

• mongos 인덱스에서 db.collection.createIndex() 인스턴스 빌드를 실행합니다. 이 작업은 인덱스가 누락된 샤드에 대해 컬렉션의 인덱스를 작성합니다.

또는 불일치가 expireAfterSeconds 속성인 경우 인덱스를 제거하고 다시 작성하는 대신 collMod 명령을 실행하여 시간(초)을 업데이트할 수 있습니다.