db.collection.createIndex()

데이터 정렬 및 인덱스 사용

collection 수준에서 데이터 정렬을 지정한 경우:

• 인덱스를 생성할 때 데이터 정렬을 지정하지 않으면 MongoDB는 collection의 기본 데이터 정렬을 사용하여 인덱스를 생성합니다.

• 인덱스를 생성할 때 데이터 정렬을 지정하면 MongoDB는 지정된 데이터 정렬로 인덱스를 생성합니다.

동일한 키에 서로 다른 데이터 정렬을 사용하여 여러 인덱스를 생성할 수 있습니다. 키 패턴은 같지만 데이터 정렬이 다른 고유한 인덱스를 만들려면 고유한 인덱스 이름을 입력해야 합니다.

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

예를 들어, 컬렉션 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에는 숫자 필드 score 및 price와 문자열 필드 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" } )

데이터 비정렬 및 비숨김 옵션

데이터 정렬 옵션을 제외하고, 한 세트의 인덱스 옵션으로 인덱스를 생성한 다음 다른 인덱스 옵션으로 동일한 인덱스를 다시 생성하려고 하면 MongoDB는 옵션을 변경하거나 인덱스를 다시 생성하지 않습니다.

인덱스를 제거하고 다시 생성하지 않고도 숨김 옵션을 변경할 수 있습니다. 자세한 내용은 숨김 옵션을 참조하세요.

다른 인덱스 옵션을 변경하려면 기존 인덱스를 db.collection.dropIndex()로 제거한 후 새 옵션으로 db.collection.createIndex()를 실행하세요.

데이터 정렬 옵션

동일한 키에 서로 다른 데이터 정렬을 사용하여 여러 인덱스를 생성할 수 있습니다. 키 패턴은 같지만 데이터 정렬이 다른 고유한 인덱스를 만들려면 고유한 인덱스 이름을 입력해야 합니다.

숨겨진 옵션

기존 인덱스를 숨기거나 숨김 해제하려면 다음 mongosh 메서드를 사용할 수 있습니다:

• db.collection.hideIndex()

• db.collection.unhideIndex()

예를 들면 다음과 같습니다.

• 인덱스의 hidden 옵션을 true(으)로 변경하려면 db.collection.hideIndex() 메서드를 사용하며 다음과 같습니다.

  db.restaurants.hideIndex( { borough: 1, ratings: 1 } );

• 인덱스의 hidden 옵션을 false(으)로 변경하려면 db.collection.unhideIndex() 메서드를 사용하며 다음과 같습니다.

  db.restaurants.unhideIndex( { borough: 1, city: 1 } );

단일 필드 경로에 와일드카드 인덱스 생성

products_catalog 문서에 product_attributes 필드가 포함될 수 있는 컬렉션을 가정해 보겠습니다. product_attributes 필드에는 내장된 문서 및 배열을 포함하여 임의의 중첩 필드가 포함될 수 있습니다.

db.products_catalog.insertMany( [
  {
    _id : ObjectId("5c1d358bf383fbee028aea0b"),
    product_name: "Blaster Gauntlet",
    product_attributes: {
      price: {
        cost: 299.99,
        currency: "USD"
      }
    }
  },
  {
    _id: ObjectId("5c1d358bf383fbee028aea0c"),
    product_name: "Super Suit",
    product_attributes: {
      superFlight: true,
      resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
    }
  }
] )

다음 작업은 product_attributes 필드에 와일드카드 인덱스를 생성합니다.

use inventory
db.products_catalog.createIndex( { "product_attributes.$**" : 1 } )

이 와일드카드 인덱스를 사용하면 MongoDB는 product_attributes의 모든 스칼라 값을 인덱싱합니다. 필드가 중첩된 문서 또는 배열인 경우 와일드카드 인덱스는 문서/배열로 되풀이되어 문서/배열의 모든 스칼라 필드를 인덱싱합니다.

와일드카드 인덱스는 product_attributes 또는 중첩된 필드 중 하나에 대한 임의의 단일 필드 쿼리를 지원할 수 있습니다.

db.products_catalog.find( { "product_attributes.superFlight" : true } )
db.products_catalog.find( { "product_attributes.maxSpeed" : { $gt : 20 } } )
db.products_catalog.find( { "product_attributes.elements" : { $eq: "water" } } )

모든 필드 경로에 와일드카드 인덱스 생성

products_catalog 문서에 product_attributes 필드가 포함될 수 있는 컬렉션을 가정해 보겠습니다. product_attributes 필드에는 내장된 문서 및 배열을 포함하여 임의의 중첩 필드가 포함될 수 있습니다.

db.products_catalog.insertMany( [
  {
    _id : ObjectId("5c1d358bf383fbee028aea0b"),
    product_name: "Blaster Gauntlet",
    product_attributes: {
      price: {
        cost: 299.99,
        currency: "USD"
      }
    }
  },
  {
    _id: ObjectId("5c1d358bf383fbee028aea0c"),
    product_name: "Super Suit",
    product_attributes: {
      superFlight: true,
      resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
    }
  }
] )

다음 작업은 모든 스칼라 필드(_id 필드 제외)에 와일드카드 인덱스을 생성합니다.

use inventory
db.products_catalog.createIndex( { "$**" : 1 } )

MongoDB는 이 와일드카드 인덱스를 사용하여 collection의 각 문서에 대한 모든 스칼라 필드를 인덱싱합니다. 지정된 필드가 중첩된 문서 또는 배열인 경우 와일드카드 인덱스는 문서/배열에 대해 재귀적으로 작업을 수행하여 문서/배열의 모든 스칼라 필드를 인덱싱합니다.

생성된 인덱스는 collection에 있는 문서 내의 임의 필드에 대한 쿼리를 지원할 수 있습니다.

db.products_catalog.find( { "product_price" : { $lt : 25 } } )
db.products_catalog.find( { "product_attributes.elements" : { $eq: "water" } } )

와일드카드 인덱스 커버리지에 특정 필드 포함

products_catalog 문서에 product_attributes 필드가 포함될 수 있는 컬렉션을 가정해 보겠습니다. product_attributes 필드에는 내장된 문서 및 배열을 포함하여 임의의 중첩 필드가 포함될 수 있습니다.

db.products_catalog.insertMany( [
  {
    _id : ObjectId("5c1d358bf383fbee028aea0b"),
    product_name: "Blaster Gauntlet",
    product_attributes: {
      price: {
        cost: 299.99,
        currency: "USD"
      }
    }
  },
  {
    _id: ObjectId("5c1d358bf383fbee028aea0c"),
    product_name: "Super Suit",
    product_attributes: {
      superFlight: true,
      resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
    }
  }
] )

다음 작업은 와일드카드 인덱스을 생성하고 wildcardProjection 옵션을 사용하여 인덱스에 product_attributes.elements 및 product_attributes.resistance 필드의 스칼라 값만 포함합니다.

use inventory
db.products_catalog.createIndex(
  { "$**" : 1 },
  {
    "wildcardProjection" : {
      "product_attributes.elements" : 1,
      "product_attributes.resistance" : 1
    }
  }
)

"$**" 패턴은 문서의 모든 필드를 포함합니다. 인덱스를 지정한 필드로 제한하려면 wildcardProjection 필드를 사용합니다. wildcardProjection에 대한 전체 문서는 wildcard 인덱스에 대한 옵션을 참조하세요.

필드가 중첩된 문서 또는 배열인 경우 와일드카드 인덱스가 해당 필드로 재귀되어 문서 또는 배열의 모든 스칼라 필드를 인덱싱합니다.

와일드카드 인덱스는 wildcardProjection에 포함된 모든 스칼라 필드에 대한 쿼리를 지원합니다.

db.products_catalog.find( { "product_attributes.elements" : { $eq: "Water" } } )
db.products_catalog.find( { "product_attributes.resistance" : "Bludgeoning" } )

와일드카드 인덱스 커버리지에서 특정 필드 생략

products_catalog 문서에 product_attributes 필드가 포함될 수 있는 컬렉션을 가정해 보겠습니다. product_attributes 필드에는 내장된 문서 및 배열을 포함하여 임의의 중첩 필드가 포함될 수 있습니다.

db.products_catalog.insertMany( [
  {
    _id : ObjectId("5c1d358bf383fbee028aea0b"),
    product_name: "Blaster Gauntlet",
    product_attributes: {
      price: {
        cost: 299.99,
        currency: "USD"
      }
    }
  },
  {
    _id: ObjectId("5c1d358bf383fbee028aea0c"),
    product_name: "Super Suit",
    product_attributes: {
      superFlight: true,
      resistance: [ "Bludgeoning", "Piercing", "Slashing" ]
    }
  }
] )

이 예시에서는 와일드카드 인덱스와 wildcardProjection 문서를 사용해 컬렉션에 포함된 각 문서의 스칼라 필드를 인덱싱합니다.

와일드카드 인덱스는 product_attributes.elements 및 product_attributes.resistance 필드를 제외합니다:

use inventory
db.products_catalog.createIndex(
  { "$**" : 1 },
  {
    "wildcardProjection" : {
      "product_attributes.elements" : 0,
      "product_attributes.resistance" : 0
    }
  }
)

와일드카드 패턴 "$**"에는 문서의 모든 필드가 포함됩니다. 그러나 wildcardProjection 필드는 지정된 필드를 인덱스에서 제외합니다.

wildcardProjection에 대한 전체 문서는 wildcard 인덱스에 대한 옵션을 참조하세요.

필드가 중첩된 문서 또는 배열인 경우 와일드카드 인덱스는 문서/배열로 반복되어 문서/배열의 모든 스칼라 필드를 인덱싱합니다.

인덱스는 wildcardProjection 기준으로 제외된 필드를 제외한 모든 스칼라 필드에 대한 쿼리를 지원할 수 있습니다.

db.products_catalog.find( { "product_attributes.maxSpeed" : { $gt: 25 } } )
db.products_catalog.find( { "product_attributes.superStrength" : true } )