db.collection.dropIndex()

이 페이지의 내용

정의

행동
예시

드라이버가 포함된 MongoDB

이 페이지에서는 mongosh 메서드를 설명합니다. MongoDB 드라이버에서 해당 메서드를 보려면 프로그래밍 언어의 해당 페이지를 참조하세요.

C#Java Sync Node.js PyMongo C C++Go Java RS Kotlin Coroutine Kotlin Sync PHP Mongoid Rust Scala

정의

db.collection.dropIndex(index)

지정된 인덱스를 컬렉션에서 제거합니다.

참고

_id 필드에서 기본 인덱스를 제거할 수 없습니다.
_id가 아닌 모든 인덱스를 삭제하기 위해 db.collection.dropIndex("*")를 지정할 수 없습니다. 대신 db.collection.dropIndexes()를 사용하세요.

db.collection.dropIndex() 메서드에 해당하는 인덱스 이름 또는 인덱스 사양 문서를 가져오려면 db.collection.getIndexes() 메서드를 사용하세요.

db.collection.dropIndex() 메서드는 다음 매개 변수를 사용합니다.

Parameter	유형	설명
`index`	문자열 또는 문서	필수 사항입니다. 제거할 인덱스를 지정합니다. 인덱스 이름 또는 인덱스 사양 문서로 인덱스를 지정할 수 있습니다. 텍스트 인덱스를 제거하려면 인덱스 이름을 지정하세요. `_id`가 아닌 모든 인덱스를 삭제하기 위해 `"*"`를 지정할 수는 없습니다. 대신 `db.collection.dropIndexes()`를 사용하세요. `db.collection.dropIndex()`에 지정된 인덱스가 아직 빌드 중이면 `db.collection.dropIndex()`가 진행 중인 빌드를 중지하려고 시도합니다. 인덱스 빌드를 중지하면 빌드된 인덱스를 제거하는 것과 동일한 효과가 있습니다. 자세한 내용은 진행 중인 인덱스 빌드 중지를 참조하세요.

행동

MongoDB 5.2부터는 db.collection.dropIndex()를 사용하여 다른 인덱스에서 빌드가 진행 중이더라도 동일한 컬렉션에서 기존 인덱스를 제거할 수 있습니다. 이전 버전에서는 인덱스 빌드가 진행 중일 때 다른 인덱스를 제거하려고 하면 BackgroundOperationInProgressForNamespace 오류가 발생했습니다.

리소스 잠금

db.collection.dropIndex()은 작업 기간 동안 지정된 컬렉션에 대한 배타 락을 얻습니다. 컬렉션에 대한 모든 후속 작업은 db.collection.dropIndex()이 잠금을 해제할 때까지 기다려야 합니다.

진행 중인 인덱스 빌드 중지

db.collection.dropIndex()에 지정된 인덱스가 아직 빌드 중이면 db.collection.dropIndex()가 진행 중인 빌드를 중지하려고 시도합니다. 인덱스 빌드를 중지하면 빌드된 인덱스를 제거하는 것과 동일한 효과가 있습니다.

복제본 세트의 경우, 프라이머리에서 db.collection.dropIndex()를 실행합니다. 프라이머리는 인덱스 빌드를 중단하고 관련 "abortIndexBuild" oplog 항목을 생성합니다. "abortIndexBuild" oplog 항목을 복제하는 세컨더리는 진행 중인 인덱스 빌드를 중지하고 빌드 작업을 삭제합니다. 인덱스 빌드 프로세스에 관한 자세한 설명은 인덱스 빌드 프로세스를 참조하세요.

currentOp을 사용하여 createIndexes 또는 db.collection.createIndexes() 작업과 관련된 인덱스 빌드를 식별합니다. 예는 활성 인덱싱 작업을 참조하세요.

Hidden Indexes

MongoDB는 쿼리 플래너에서 인덱스를 숨기거나 숨김 해제하는 기능을 제공합니다. 플래너에서 인덱스를 숨기면 실제로 인덱스를 제거하지 않고도 인덱스 제거의 잠재적 영향을 평가할 수 있습니다.

평가 후 사용자가 인덱스를 제거하기로 결정하면 숨겨진 인덱스를 제거할 수 있습니다. 즉, 인덱스를 제거하기 위해 먼저 숨기기를 해제할 필요가 없습니다.

하지만 영향이 부정적이라면 사용자는 제거된 인덱스를 다시 만들지 않고도 인덱스 숨김을 해제할 수 있습니다. 또한 인덱스는 숨겨진 상태에서도 완전히 유지되므로 숨김을 해제하면 인덱스를 즉시 사용할 수 있습니다.

숨겨진 인덱스에 대한 자세한 내용은 숨겨진 인덱스를 참조하세요.

예시

pets 컬렉션을 살펴보겠습니다. pets 컬렉션에서 db.collection.getIndexes() 메서드를 호출하면 다음과 같은 인덱스가 반환됩니다.

[
   {
      "v" : 2,
      "key" : {
         "_id" : 1
      },
      "name" : "_id_"
   },
   {
      "v" : 2,
      "key" : {
         "cat" : -1
      },
      "name" : "catIdx"
   },
   {
      "v" : 2,
      "key" : {
         "cat" : 1,
         "dog" : -1
      },
      "name" : "cat_1_dog_-1"
   }
]

필드 cat의 단일 필드 인덱스는 catIdx라는 사용자 지정 이름을 가지며[1] { "cat" : -1 }라는 인덱스 사양 문서가 있습니다.

인덱스 catIdx를 제거하려면 인덱스 이름을 사용할 수 있습니다:

db.pets.dropIndex( "catIdx" )

또는 인덱스 사양 문서 { "cat" : -1 }을 사용할 수 있습니다.

db.pets.dropIndex( { "cat" : -1 } )

[1]	인덱스 생성 중에 사용자가 인덱스 이름을 지정하지 않으면 시스템에서 인덱스 키 필드와 값을 밑줄로 연결하여 이름을 생성합니다(예: `cat_1`).

돌아가기

db.collection.drop

db.collection.dropIndexes()