db.collection.getIndexes()
이 페이지의 내용
드라이버가 포함된 MongoDB
이 페이지에서는 mongosh
메서드를 설명합니다. MongoDB 드라이버에서 해당 메서드를 보려면 프로그래밍 언어의 해당 페이지를 참조하세요.
정의
db.collection.getIndexes()
숨겨진 인덱스를 포함하여 컬렉션의 기존 인덱스를 식별하고 설명하는 문서 목록이 있는 배열을 반환합니다.
컬렉션에서
db.collection.getIndexes()
를 호출해야 합니다. 예를 들면 다음과 같습니다.db.collection.getIndexes() collection
을 인덱스 정보를 반환할 collection의 이름으로 변경합니다.
호환성
이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
참고
이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하십시오.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
행동
Atlas search 인덱스
getIndexes()
Atlas Search 인덱스에 관한 정보를 반환하지 않습니다. Atlas Search 인덱스에 대한 자세한 내용을 보려면 $listSearchIndexes
를 사용하세요.
클라이언트 연결 해제
MongoDB 4.2부터 db.collection.getIndexes()
를 발급한 클라이언트가 작업이 완료되기 전에 연결을 끊는 경우, MongoDB는 db.collection.getIndexes()
를 사용하여 를killOp
을 종료로 표시합니다.
복제본 세트 구성원 국가 제한
복제본 세트 노드에서 실행하는 경우 listIndexes
연산을 수행하려면 노드가 PRIMARY
또는 SECONDARY
상태여야 합니다. 노드가 STARTUP2
와 같은 다른 상태이면 연산 오류가 발생합니다.
와일드카드 인덱스
MongoDB 6.3, 6.0.5 및 5.0.16부터 wildcardProjection
필드는 인덱스 프로젝션을 제출된 형식으로 저장합니다. 이전 버전의 서버에서는 프로젝션을 정규화된 형태로 저장했을 수 있습니다.
서버는 인덱스를 동일한 방식으로 사용하지만 listIndexes
및 db.collection.getIndexes()
명령의 출력에는 차이가 있을 수 있습니다.
필요한 액세스 권한
액세스 제어가 적용된 상태에서 db.collection.getIndexes()
를 실행하려면 사용자에게 컬렉션에 대한 listIndexes
권한이 있어야 합니다.
기본 제공 역할 read
는 데이터베이스의 컬렉션에 대해 db.collection.getIndexes()
를 실행하는 데 필요한 권한을 제공합니다.
출력
db.collection.getIndexes()
컬렉션에 대한 인덱스 정보를 담고 있는 문서 배열을 반환합니다. 예시:
[ { "v" : 2, "key" : { "_id" : 1 }, "name" : "_id_" }, { "v" : 2, "key" : { "status" : 1 }, "name" : "status_1" }, { "v" : 2, "key" : { "points" : 1 }, "name" : "points_1" } ]
인덱스 정보에는 인덱스 생성에 사용된 키와 옵션이 포함됩니다. 인덱스 옵션 hidden
은 값이 true
인 경우에만 사용할 수 있습니다.
키 및 인덱스 옵션에 대한 자세한 내용은 db.collection.createIndex()
을(를) 참조하세요.