db.collection.dropIndexes()

정의

db.collection.dropIndexes()

컬렉션에서 지정된 인덱스(_id 필드의 인덱스와 마지막 남은 샤드 키 인덱스 제외)를 제거합니다.

이 메서드를 사용하여 다음을 수행할 수 있습니다.

• collection에서 _id 인덱스를 제외한 모든 항목을 제거합니다.

  db.collection.dropIndexes()

• collection에서 지정된 인덱스를 제거합니다. 인덱스를 지정하려면 다음 중 하나를 사용하여 메서드를 전달합니다.

  • 인덱스 사양 문서(인덱스가 텍스트 인덱스가 아닌 경우, 인덱스 이름을 사용하여 제거):

    db.collection.dropIndexes( { a: 1, b: 1 } )

  • 인덱스 이름

    db.collection.dropIndexes( "a_1_b_1" )

    팁

    인덱스 이름을 가져오려면 db.collection.getIndexes() 메서드를 사용하세요.

• collection에서 지정된 인덱스를 삭제합니다. 삭제할 인덱스를 여러 개 지정하려면 메서드에 인덱스 이름 배열을 전달합니다.

  db.collection.dropIndexes( [ "a_1_b_1", "a_1", "a_1__id_-1" ] )

  인덱스 이름 배열에 존재하지 않는 인덱스가 포함되어 있으면 메서드는 지정된 인덱스를 제거하지 않고 오류를 발생시킵니다.

  팁

  인덱스 이름을 가져오려면 db.collection.getIndexes() 메서드를 사용하세요.

db.collection.dropIndexes() 메서드는 다음과 같은 선택적 매개변수를 사용합니다.

Parameter	유형	설명
indexes	문자열 또는 문자열의 문서 또는 배열	선택 사항. 제거할 인덱스를 한 개 또는 여러 개 지정하세요. collection에서 _id 인덱스를 제외한 모든 항목을 제거하려면 매개변수를 생략합니다. 단일 인덱스를 제거하려면 인덱스 이름, 인덱스 사양 문서(텍스트 인덱스가 아닌 경우) 또는 인덱스 이름의 배열을 지정합니다. 텍스트 인덱스를 제거하려면 인덱스 사양 문서 대신 인덱스 이름 또는 인덱스 이름의 배열을 지정합니다. 여러 인덱스를 삭제하려면 인덱스 이름의 배열을 지정합니다.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

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

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

행동

MongoDB 6.0부터는 db.collection.dropIndexes()를 사용하여 마지막 남은 샤드 키 호환 인덱스를 제거하려고 하면 오류가 발생합니다. "*"를 db.collection.dropIndexes()에 전달하면 _id 인덱스와 마지막 남은 샤드 키 호환 인덱스(있는 경우)를 제외한 모든 인덱스가 제거됩니다.

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