db.collection.dropIndex()

정의

db.collection.dropIndex(index)

드라이버가 포함된 MongoDB

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

C#Java SyncNode.jsPyMongoCC++GoJava RSKotlin CoroutineKotlin SyncPHPMongoidRustScala

모두 보기

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

참고

• _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 Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

행동

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

예시

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 } )