문서 메뉴
문서 홈
/
MongoDB 매뉴얼

색인

이 페이지의 내용

  • 사용 사례
  • 시작하기
  • 세부 정보
  • 기본 _id 인덱스
  • 인덱스 만들기
  • 인덱스 유형
  • 색인 속성
  • 인덱스 사용하기
  • 인덱스 및 데이터 정렬
  • 지원되는 쿼리
  • 인덱스 교차
  • 제한 사항
  • 추가 고려 사항

인덱스는 MongoDB에서 쿼리를 효율적으로 실행할 수 있도록 지원합니다. 인덱스가 없는 경우 MongoDB는 컬렉션의 모든 문서를 스캔하여 쿼리 결과를 반환해야 합니다. 쿼리에 적합한 인덱스가 있는 경우 MongoDB는 인덱스를 사용하여 스캔해야 하는 문서 수를 제한합니다.

인덱스는 쿼리 성능을 향상시키지만 인덱스를 추가하면 쓰기 작업의 성능에 부정적인 영향을 미칩니다. 쓰기 대 읽기 비율이 높은 컬렉션의 경우 각 삽입은 인덱스도 업데이트해야 하므로 비용이 많이 듭니다.

애플리케이션이 동일한 필드에서 반복적으로 쿼리를 실행하는 경우 해당 필드에 인덱스를 생성하여 성능을 개선할 수 있습니다. 예를 들어 다음 시나리오를 가정해 보겠습니다.

시나리오
인덱스 유형
인사부에서는 직원 ID로 직원을 검색해야 하는 경우가 많습니다. 쿼리 성능을 향상시키기 위해 직원 ID 필드에 인덱스를 생성할 수 있습니다.
단일 필드 인덱스

영업 사원은 위치별로 고객 정보를 조회해야 하는 경우가 많습니다. 위치는 state, cityzipcode 같은 필드를 포함하는 내장된 객체에 저장됩니다. 해당 객체에 대한 쿼리 성능을 향상시키기 위해 location 객체에 인덱스를 생성할 수 있습니다.

참고

내장된 문서에 인덱스를 만들면 내장된 문서 전체를 지정하는 쿼리만 인덱스를 사용합니다. 문서 내의 특정 필드에 대한 쿼리는 인덱스를 사용하지 않습니다.

내장된 문서의 단일 필드 인덱스
식료품점 관리자는 재고가 부족한 품목을 파악하기 위해 이름과 수량으로 재고 품목을 자주 조회할 수 있습니다. 쿼리 성능을 향상시키기 위해 itemquantity 필드에 단일 인덱스을 생성할 수 있습니다.

MongoDB Atlas 에서 드라이버 메서드 또는 MongoDB Shell을 사용하여 인덱스를 만들고 관리할 수 있습니다. MongoDB Atlas는 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스입니다.

MongoDB Atlas에서 호스팅되는 배포의 경우, MongoDB Atlas UI 또는 Atlas CLI를 사용하여 인덱스를 생성하고 관리할 수 있습니다. MongoDB Atlas에는 느린 쿼리를 개선하기 위한 인덱스를 추천하고, 영향을 기준으로 추천 인덱스의 순위를 지정하고, 삭제할 인덱스를 권장하는 Performance Advisor도 포함되어 있습니다.

MongoDB Atlas UI 또는 Atlas CLI에서 인덱스를 생성하고 관리하는 방법에 관한 자세한 내용은 인덱스 생성, 보기, 제거 및 숨기기를 참조하세요.

MongoDB Atlas Performance Advisor에 관한 자세한 내용은 느린 쿼리 모니터링 및 개선을 참조하세요.

드라이버 메서드 또는 MongoDB Shell을 사용하여 인덱스를 생성하고 managed 수 있습니다. 자세히 알아보려면 이 페이지의 리소스를 참조하세요.

인덱스는 컬렉션 데이터 집합의 일부분을 탐색하기 쉬운 형태로 저장하는 특수 데이터 구조입니다. MongoDB 인덱스는 B-트리 데이터 구조를 사용합니다.

인덱스는 특정 필드 또는 필드 세트의 값을 필드 값에 따라 정렬하여 저장합니다. 인덱스 항목의 순서는 효율적인 동등성 매치 및 범위 기반 쿼리 작업을 지원합니다. 또한 MongoDB는 인덱스의 순서를 사용하여 정렬된 결과를 반환할 수 있습니다.

다음 다이어그램은 인덱스를 사용하여 일치하는 문서를 선택하고 정렬하는 쿼리를 보여줍니다.

인덱스를 사용하여 정렬된 결과를 선택하고 반환하는 쿼리의 다이어그램입니다. 인덱스는 ``score`` 값을 오름차순으로 저장합니다. MongoDB는 오름차순 또는 내림차순으로 인덱스를 탐색하여 정렬된 결과를 반환할 수 있습니다.
클릭하여 확대

기본적으로 MongoDB의 인덱스는 다른 데이터베이스 시스템의 인덱스와 유사합니다. MongoDB는 컬렉션 수준에서 인덱스를 정의하고 MongoDB 컬렉션에 있는 문서의 모든 필드 또는 하위 필드에 대한 인덱스를 지원합니다.

MongoDB는 컬렉션 생성 중에 _id 필드에 고유 인덱스 를 생성합니다. _id 인덱스는 클라이언트가 _id 필드에 동일한 값을 가진 두 문서를 삽입하는 것을 방지합니다. 이 인덱스는 _id 필드에 삭제할 수 없습니다.

참고

샤드 cluster 에서 필드를 샤드 _id 키로 사용하지 않는 경우 애플리케이션은 오류를 방지하기 위해 _id 필드 값의 고유성을 보장 해야 합니다. 이 작업은 대부분 자동 생성된 표준 ObjectId를 사용하여 수행됩니다.


➤ 오른쪽 상단의 언어 선택 드롭다운 메뉴를 사용하여 이 페이지에 있는 예제의 언어를 설정하세요.


[1] MongoDB 인덱스는 B-트리 데이터 구조를 사용합니다.

인덱스의 기본 이름은 밑줄을 구분자로 사용하여 인덱싱된 키와 인덱스에서의 각 키 방향(예: 1 또는 -1)을 연결한 것입니다. 예를 들어 { item : 1, quantity: -1 } 에 생성된 인덱스의 이름은 item_1_quantity_-1 입니다.

기본값보다 사람이 더 읽기 쉬운 사용자 지정 이름(예: 사용자 지정 이름)을 사용하여 인덱스를 생성할 수 있습니다. 예를 들어, 기존 인벤토리의 데이터를 채우기 위해 products collection을 자주 쿼리 애플리케이션을 생각해 보겠습니다. createIndex() 다음 메서드는 item 및 에 라는 인덱스를 생성합니다.quantity query for inventory

db.products.createIndex(
{ item: 1, quantity: -1 } ,
{ name: "query for inventory" }
)

db.collection.getIndexes() 메서드를 사용하여 인덱스 이름을 볼 수 있습니다. 생성된 인덱스의 이름은 변경할 수 없습니다. 대신 인덱스를 삭제하고 새 이름으로 다시 생성해야 합니다.

MongoDB는 특정 유형의 데이터 및 쿼리를 지원하기 위해 다양한 인덱스 유형을 제공합니다.

MongoDB에서 정의한 _id 인덱스 외에도 MongoDB는 문서의 단일 필드에 대해 사용자 정의 오름차순/내림차순 인덱스 생성을 지원합니다.

'score' 필드에 대한 인덱스 다이어그램은 오름차순으로 표시됩니다.

단일 필드 인덱스 및 정렬 작업의 경우 정렬 순서(예: MongoDB는 어느 방향으로든 인덱스를 탐색할 수 있으므로 인덱스 키의 오름차순 또는 내림차순)는 중요하지 않습니다.

단일 필드 인덱스에 대한 자세한 내용은 단일 필드 인덱스 및 단일 필드 인덱스정렬을 참조하세요.

MongoDB는 여러 필드, 즉 복합 인덱스에서 사용자 정의 인덱스도 지원합니다.

복합 인덱스에 나열된 필드의 순서는 중요합니다. 예를 들어 복합 인덱스가 { userid: 1, score: -1 } 로 구성된 경우, 인덱스는 먼저 userid 을 기준으로 정렬한 다음 각 userid 값 내에서 score 을 기준으로 정렬합니다.

'userid' 필드(오름차순) 및 'score' 필드(내림차순)에 대한 복합 인덱스 다이어그램입니다. 인덱스는 먼저 'userid' 필드를 기준으로 정렬한 다음 'score' 필드를 기준으로 정렬합니다.

복합 인덱스 및 정렬 작업의 경우 정렬 순서(예: 오름차순 또는 내림차순)은 인덱스 키가 인덱스가 정렬 작업을 지원할 수 있는지 여부를 결정할 수 있습니다. 복합 인덱스에서 인덱스 순서가 결과에 미치는 영향에 대한 자세한 내용은 정렬 순서 를 참조하세요.

다음도 참조하세요.

MongoDB는 멀티키 인덱스 를 사용하여 배열에 저장된 콘텐츠를 인덱싱합니다. 배열 값이 포함된 필드를 인덱싱하는 경우, MongoDB는 배열의 모든 고유 요소에 대해 별도의 인덱스 항목을 생성합니다. 이러한 멀티키 인덱스 를 사용하면 쿼리에서 배열의 요소를 일치시켜 배열이 포함된 문서를 선택할 수 있습니다. MongoDB는 인덱싱된 필드에 배열 값이 포함된 경우 다중 키 인덱스를 만들지 여부를 자동으로 결정합니다. 즉, 멀티키 유형을 명시적으로 지정할 필요가 없습니다.

``addr.zip`` 필드의 멀티키 인덱스 다이어그램 입니다. ``addr`` 필드에는 주소 문서 배열이 포함되어 있습니다. 주소 문서에는 ``zip`` 필드가 포함되어 있습니다.

멀티키 인덱스에 대한 자세한 내용은 멀티키 인덱스멀티키 인덱스 바운드 를 참조하세요.

지리 공간적 좌표 데이터의 효율적인 쿼리를 지원하기 위해 MongoDB는 두 가지 특수 인덱스, 즉 결과를 반환할 때 평면 기하학을 사용하는 2d 인덱스 와 구형 기하학을 사용하여 결과를 반환하는 2dsphere 인덱스 를 제공합니다.

이 인덱스는 희소 인덱스 입니다. 희소 인덱스를 사용하여 복합 인덱스 를 만들려면 먼저 희소 복합 인덱스 사용에 대한 특별 고려 사항을 검토하세요.

지리 공간적 인덱스에 대한 간략한 소개는 지리 공간적 인덱스를 참조하세요.

MongoDB Atlas에서 호스팅되는 데이터의 경우 Atlas Search 인덱스를 사용하여 전체 텍스트 검색을 지원할 수 있습니다. 자세한 내용은 Atlas Search 인덱스 생성을 참조하세요.

자체 관리형(비Atlas) 배포서버의 경우, MongoDB는 컬렉션에서 문자열 콘텐츠 검색을 지원하는 text 인덱스 유형을 제공합니다. 자체 관리형 텍스트 인덱스에 대해 자세히 알아보려면 텍스트 인덱스를 참조하세요.

이 인덱스는 희소 인덱스 입니다. 희소 인덱스를 사용하여 복합 인덱스 를 만들려면 먼저 희소 복합 인덱스 사용에 대한 특별 고려 사항을 검토하세요.

해시 기반 샤딩 을 지원하기 위해 MongoDB는 필드 값의 해시를 인덱싱하는 해시 인덱스 유형을 제공합니다. 이러한 인덱스는 범위에 따라 값이 더 무작위로 분포되지만 동등성 매치 지원하며 범위 기반 쿼리는 지원할 수 없습니다.

MongoDB 5.3부터는 클러스터형 컬렉션을 사용하여 컬렉션을 만들 수 있습니다. 클러스터형 인덱스를 사용하여 만든 컬렉션을 클러스터형 인덱스라고 합니다.

클러스터형 컬렉션을 참조하세요.

MongoDB 4.2부터는 와일드카드 인덱스를 사용하여 여러 필드, 임의 필드 또는 알 수 없는 필드에 대한 쿼리를 지원할 수 있습니다. 와일드카드 인덱스를 만들 때 $** 를 지정하여 모든 필드 또는 모든 값을 나타내면 단일 명령으로 다음을 인덱싱할 수 있습니다.

  • 필드의 모든 값

  • 문서의 모든 필드

  • 특정 필드 경로를 제외한 문서의 모든 필드

  • 문서의 여러 특정 필드

자세한 내용은 와일드카드 인덱스를 참조하세요.

인덱스의 고유한 속성으로 인해 MongoDB는 인덱싱된 필드에 대해 중복된 값을 거부합니다. 고유 제약 조건 외에 고유 인덱스는 다른 MongoDB 인덱스와 기능적으로 상호 교환 가능합니다.

부분 인덱스 는 지정된 필터 표현식을 충족하는 collection의 문서만 인덱싱합니다. collection에 있는 문서의 하위 집합을 인덱싱하면 부분 인덱스의 스토리지 요구 사항이 줄어들고 인덱스 생성 및 유지 관리에 드는 성능 비용이 절감됩니다.

부분 인덱스는 희소 인덱스 기능의 상위 세트를 제공하므로 희소 인덱스보다 선호됩니다.

인덱스의 희소 속성은 인덱스에 인덱스된 필드가 있는 문서에 대한 항목만 포함하도록 합니다. 인덱스는 인덱싱된 필드 가 없는 문서를 건너뜁니다.

희소 인덱스 옵션과 고유 인덱스 옵션을 결합하여 인덱싱된 필드에 중복된 값이 있는 문서를 삽입하는 것을 방지하고 인덱싱된 필드가 없는 문서의 인덱싱을 건너뛸 수 있습니다.

TTL 는 MongoDB가 일정 시간이 지나면 collection에서 문서를 자동으로 제거하는 데 사용할 수 있는 특수 인덱스입니다. 이는 시스템에서 생성한 이벤트 데이터, 로그, 세션 정보와 같이 데이터베이스에 한정된 기간 동안만 유지되는 특정 유형의 정보에 이상적입니다.

구현 지침은 TTL을 설정하여 컬렉션에서 데이터 만료를 참조하세요.

버전 4.4에 추가되었습니다.

숨겨진 인덱스쿼리 플래너에 표시되지 않으며 쿼리를 지원하는 데 사용할 수 없습니다.

플래너에서 인덱스를 숨김으로써 사용자는 실제로 인덱스를 삭제하지 않고도 인덱스 삭제로 인한 잠재적인 영향을 평가할 수 있습니다. 영향이 부정적인 경우 사용자는 삭제된 인덱스를 다시 생성할 필요 없이 인덱스 숨기기를 해제할 수 있습니다. 그리고 인덱스는 숨겨진 동안 완전히 유지되므로 숨김이 해제되면 인덱스를 즉시 사용할 수 있습니다.

_id 인덱스를 제외한 모든 인덱스를 숨길 수 있습니다.

인덱스는 읽기 작업의 효율성을 향상시킬 수 있습니다. 쿼리 성능 분석 튜토리얼에서는 인덱스가 있는 쿼리와 인덱스가 없는 쿼리의 실행 통계 예제를 제공합니다.

MongoDB가 사용할 인덱스를 선택하는 방법에 대한 자세한 내용은 쿼리 옵티마이저를 참조하세요.

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

문자열 비교에 인덱스를 사용하려면 작업에서 동일한 데이터 정렬도 지정해야 합니다. 즉, 작업에서 다른 데이터 정렬을 지정하는 경우 데이터 정렬이 있는 인덱스는 인덱싱된 필드에서 문자열 비교를 수행하는 작업을 지원할 수 없습니다.

경고

데이터 정렬로 구성된 인덱스는 ICU 데이터 정렬 키를 사용하여 정렬 순서를 지정하므로, 데이터 정렬이 없는 인덱스의 경우 데이터 정렬 인식 인덱스 키가 인덱스 키보다 클 수 있습니다.

예를 들어, 컬렉션 myColl에는 대조 로케일이 "fr" 인 문자열 필드 category에 대한 색인이 있습니다.

db.myColl.createIndex( { category: 1 }, { collation: { locale: "fr" } } )

인덱스와 동일한 데이터 정렬을 지정하는 다음 쿼리 작업에서는 인덱스를 사용할 수 있습니다.

db.myColl.find( { category: "cafe" } ).collation( { locale: "fr" } )

하지만 기본적으로 '단순' 바이너리 데이터 정렬기를 사용하는 다음 쿼리 작업에서는 인덱스를 사용할 수 없습니다.

db.myColl.find( { category: "cafe" } )

인덱스 접두사 키가 문자열, 배열 및 내장된 문서가 아닌 복합 인덱스의 경우, 다른 데이터 정렬을 지정하는 작업에서도 인덱스를 사용하여 인덱스 접두사 키에 대한 비교를 지원할 수 있습니다.

예를 들어, 컬렉션 myColl에는 숫자 필드 scoreprice와 문자열 필드 category에 복합 인덱스가 있습니다. 인덱스는 문자열 비교를 위해 데이터 정렬 로캘 "fr"를 사용하여 만들어집니다.

db.myColl.createIndex(
{ score: 1, price: 1, category: 1 },
{ collation: { locale: "fr" } } )

문자열 비교에 "simple" 이진 데이터 정렬을 사용하는 다음 작업에서는 인덱스를 사용할 수 있습니다.

db.myColl.find( { score: 5 } ).sort( { price: 1 } )
db.myColl.find( { score: 5, price: { $gt: NumberDecimal( "10" ) } } ).sort( { price: 1 } )

색인이 생성된 category 필드의 문자열 비교를 위해 "simple" 이진 데이터 정렬을 사용하는 다음 작업은 색인을 사용하여 쿼리의 score: 5 부분만 수행할 수 있습니다.

db.myColl.find( { score: 5, category: "cafe" } )

중요

내장된 문서 키를 비롯한 문서 키와의 일치는 단순 이진 비교를 사용합니다. 즉, "foo.bár"와 같은 키에 대한 쿼리는 "foo.bar" 키와 일치하지 않습니다. 이는 강도 매개변수에 설정한 값에 관계없이 적용됩니다.

데이터 정렬에 대한 자세한 내용은 데이터 정렬 참조 페이지를 참조하세요.

다음 인덱스는 단순 바이너리 비교만 지원하며 데이터 정렬은 지원하지 않습니다.

쿼리 기준과 쿼리 프로젝션 에 인덱싱된 필드 포함되는 경우, MongoDB는 문서를 스캔하거나 문서를 메모리로 가져오지 않고 인덱스에서 직접 결과를 반환합니다. 이러한 포함된 쿼리는 매우 효율적일 수 있습니다.

인덱스만 사용하여 쿼리 기준과 일치하고 결과를 반환하는 쿼리의 다이어그램입니다. MongoDB는 쿼리를 수행하기 위해 인덱스 외부의 데이터를 검사할 필요가 없습니다.
클릭하여 확대

포함된 쿼리에 대한 자세한 내용은 포함된 쿼리를 참조하세요 .

MongoDB는 인덱스의 교차점을 사용하여 쿼리를 처리할 수 있습니다. 복합 쿼리 조건을 지정하는 쿼리의 경우, 한 인덱스가 쿼리 조건의 일부를 충족할 수 있고 다른 인덱스가 쿼리 조건의 다른 부분을 충족할 수 있다면 MongoDB는 두 인덱스의 교집합을 사용하여 쿼리를 수행할 수 있습니다. 복합 인덱스를 사용하는 것과 인덱스 교차를 사용하는 것이 더 효율적인지 여부는 특정 쿼리와 시스템에 따라 다릅니다.

인덱스 교차에 대한 자세한 내용은 인덱스 교차를 참조하세요 .

인덱스 키 길이 또는 collection당 인덱스 수와 같은 특정 제한 사항이 인덱스에 적용됩니다. 자세한 내용은 인덱스 제한 사항 을 참조하세요.

인덱스는 쿼리 성능을 향상시킬 수 있지만 인덱스는 몇 가지 운영 고려 사항도 제공합니다. 자세한 내용 은 인덱스에 대한 운영 고려 사항을 참조하세요.

인덱스를 빌드하는 동안 애플리케이션의 성능이 저하되거나 인덱싱되는 collection에 대한 읽기/쓰기 액세스가 제한될 수 있습니다.

인덱스 빌드 프로세스에 대한 자세한 내용은 채워진 collection 에 대한 인덱스 빌드, 특히 복제된 환경에서 의 인덱스 빌드 섹션을 참조하세요.

일부 드라이버는 1 NumberLong(1) 을(를) 사용하여 인덱스 순서를 지정합니다. 결과 인덱스는 동일합니다.

← 맵-리듀스에서 애그리게이션 파이프라인으로의 전환