createIndexes

문자열

인덱스를 생성할 컬렉션입니다.

배열

생성할 인덱스를 지정합니다. 배열의 각 문서는 별도의 인덱스를 지정합니다.

문서

선택 사항입니다. 쓰기 고려를 표현하는 문서입니다. 기본 쓰기 고려를 사용하지 않으려면 생략하세요.

정수 또는 문자열

선택 사항입니다. 프라이머리 등 데이터를 보유하는 복제본 세트 멤버의 최소 수(즉, 쿼럼 커밋)이며, 이는 프라이머리가 indexes를 준비됨으로 표시하기 전에 성공적인 인덱스 빌드를 보고해야 합니다.

MongoDB v5.0부터는 "votingMembers"로 commit quorum is set될 때 일부 중단된 인덱스 빌드를 다시 시작할 수 있습니다.

쿼럼 커밋의 복제본 세트 노드에서 members[n].buildIndexes가 true로 설정되어 있어야 합니다. 투표 노드에 members[n].buildIndexes가 false로 설정된 경우 기본 "votingMembers" 쿼럼 커밋을 사용할 수 없습니다. 모든 노드를 members[n].buildIndexes true로 구성하거나 다른 쿼럼 커밋을 선택합니다.

는 다음과 같은 값을 지원합니다.

• "votingMembers" - 모든 데이터를 보유하는 투표 복제본 세트 멤버(기본값)입니다. "투표" 멤버는 members[n].votes가 0보다 큰 모든 복제본 세트 노드를 말합니다.

• "majority" - 데이터 보유 복제본 세트 멤버의 단순 과반수입니다.

• <int> - 특정 수의 데이터를 보유하는 복제본 세트 멤버입니다.

• 0 - 쿼럼 투표 동작을 사용하지 않도록 설정합니다. 멤버는 인덱스 작성을 동시에 시작하지만 인덱스 작성을 완료하기 전에 투표하거나 쿼럼을 기다리지 않습니다. 쿼럼 커밋이 0인 인덱스 빌드를 시작하는 경우 나중에 setIndexCommitQuorum를 사용하여 쿼럼 커밋을 수정할 수 없습니다.

• 복제본 세트 태그 이름.

any

선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.

• mongod 로그 메시지( attr.command.cursor.comment 필드).

• 데이터베이스 프로파일러 출력의 command.comment 필드에 있습니다.

• currentOp{command.comment 5} 필드에 출력을 입력합니다.

댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다.

문서

인덱스의 필드를 지정합니다. 각 필드에 대해 키는 인덱싱할 필드 이름이고 값은 인덱스 방향 또는 인덱스 유형인 키-값 쌍을 지정합니다. 방향을 지정하는 경우, 오름차순이면 1, 내림차순이면 -1을 지정합니다.

MongoDB는 다음과 같은 여러 가지 인덱스 유형을 지원합니다.

• text

• 지리 공간

• 해시 인덱스

자세한 내용은 인덱스 유형을 참조하세요.

와일드카드 인덱스는 사용자가 사용자 지정 필드 또는 컬렉션의 다양한 필드에 대해 쿼리하는 워크로드를 지원합니다.

• 특정 필드와 해당 하위 경로 또는 문서의 모든 필드에 와일드카드 인덱스를 생성할 수 있습니다.

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

문자열

인덱스를 고유하게 식별하는 이름입니다.

부울

선택 사항입니다. 고유 인덱스를 생성하여 인덱스 키 값이 인덱스의 기존 값과 일치하는 문서의 삽입 또는 업데이트를 collection에서 허용하지 않도록 합니다.

고유 인덱스를 생성하려면 true를 지정합니다. 기본값은 false입니다.

해시된 인덱스에는 이 옵션을 사용할 수 없습니다.

문서

선택 사항. 지정된 경우 인덱스는 필터 표현식과 일치하는 문서만 참조합니다. 자세한 내용은 부분 인덱스를 참조하세요.

필터 표현식에는 다음이 포함될 수 있습니다.

• 등식 표현식(예 field: value 또는 $eq 연산자 사용),

• $exists: true 표현식입니다,

• $gt, $gte, $lt, $lte expressions,

• $type 표현식,

• $and 연산자

• $or 연산자

• $in 연산자

클라이언트 사이드 필드 수준 암호화 또는 Queryable Encryption을 사용하는 경우 partialFilterExpression 은 암호화된 필드를 참조할 수 없습니다.

모든 MongoDB 인덱스 유형에 partialFilterExpression 옵션을 지정할 수 있습니다.

부울

선택 사항. true인 경우 인덱스는 지정된 필드가 있는 문서만 참조합니다. 이러한 인덱스는 공간을 덜 사용하지만 일부 상황(특히 정렬)에서는 다르게 동작합니다. 기본값은 false입니다. 자세한 내용은 희소 인덱스를 참조하세요.

다음 인덱스 유형은 기본적으로 희박하며 이 옵션을 무시합니다.

• 2dsphere

• 2d

• Text

다른 유형의 키와 함께 2dsphere 인덱스 키를 포함하는 복합 인덱스의 경우, 2dsphere 인덱스 필드만이 인덱스가 문서를 참조하는지 여부를 결정합니다.

MongoDB는 부분 인덱스를 생성하는 옵션을 제공합니다. 이는 희소 인덱스 기능의 상위 집합을 제공하므로 대신 선호됩니다.

integer

선택 사항. MongoDB가 이 컬렉션에 문서를 보관하는 기간을 제어하기 위해 TTL(Time To Live)로 초 단위의 값을 지정합니다. 이 옵션은 TTL 인덱스에만 적용됩니다. 자세한 내용은 TTL을 설정하여 컬렉션에서 데이터 만료하기를 참조하세요.

MongoDB 5.0 이전에 생성된 TTL 인덱스를 사용하거나 MongDB 5.0에서 생성된 데이터를 5.0 이전 설치와 동기화하려는 경우 잘못된 구성 문제를 방지하려면 NaN을 사용하여 구성된 인덱스를 참조하세요.

TTL 인덱스 expireAfterSeconds 값은 0 과 2147483647 사이여야 합니다.

부울

선택 사항입니다. 쿼리 플래너에서 인덱스를 숨길지 여부를 결정하는 플래그입니다. 숨겨진 인덱스는 쿼리 계획 선택의 일부로 평가되지 않습니다.

기본값은 false입니다.

문서

선택 사항입니다. 사용자가 인덱스를 생성할 때 인덱스별로 스토리지 엔진을 구성할 수 있습니다.

storageEngine 옵션은 다음과 같은 형식이어야 합니다:

storageEngine: { <storage-engine-name>: <options> }

인덱스를 만들 때 지정한 스토리지 엔진 구성 옵션은 다른 스토리지 엔진을 사용하는 멤버가 있는 복제본 세트를 지원하기 위해 복제 중에 유효성이 검사되고 oplog에 기록됩니다.

문서

선택 사항. 텍스트 인덱스의 경우 필드 및 가중치 쌍을 포함하는 문서입니다. 가중치는 1~99,999 범위의 정수이며, 인덱싱된 다른 필드에 대한 해당 필드의 중요도를 점수 측면에서 나타냅니다. 인덱싱된 일부 필드 또는 모든 필드에 가중치를 지정할 수 있습니다. 점수를 조정하려면 자체 관리형 배포에서 텍스트 검색 결과에 가중치 할당하기를 참조하세요. 기본값은 1입니다.

문자열

선택 사항. 텍스트 인덱스의 경우 이 언어는 중지 단어 목록과 어간 및 토크나이저에 대한 규칙을 결정합니다. 자세한 내용과 예시는 사용 가능한 언어에 대한 자체 관리형 배포의 텍스트 검색 언어 및 자체 관리형 배포의 텍스트 인덱스에 대한 기본 언어 지정을 참조하세요. 기본값은 english입니다.

문자열

선택 사항입니다. 텍스트 인덱스에서 컬렉션 문서의 필드 이름으로, 문서의 재정의 언어를 포함합니다. 기본값은 language입니다. 예시는 자체 관리 배포에서 텍스트 인덱스의 기본 언어 지정을 참조하세요.

integer

선택 사항. text 인덱스 버전 번호입니다. 사용자는 이 옵션을 사용하여 기본 버전 번호를 재정의할 수 있습니다.

사용 가능한 버전은 자체 관리형 배포에 대한 텍스트 인덱스 버전을 참조하세요.

integer

선택 사항. 2dsphere 인덱스 버전 번호입니다. 사용자는 이 옵션을 사용하여 기본 버전 번호를 재정의할 수 있습니다.

사용 가능한 버전은 2dsphere 인덱스를 참고하세요.

integer

선택 사항. 2D 인덱스의 경우 위치 데이터의 저장된 geohash 값의 정밀도 수입니다.

bits 값의 범위는 1에서 32까지입니다. 기본값은 26입니다.

숫자

선택 사항입니다. 2d 인덱스의 경우 경도 및 위도 값의 하한 포함 경계입니다. 기본값은 -180.0입니다.

숫자

선택 사항입니다. 2D 인덱스의 경우 경도 및 위도 값의 상한값입니다. 기본값은 180.0입니다.

문서

선택 사항입니다. 인덱스의 데이터 정렬을 지정합니다.

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

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

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

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

데이터 정렬 옵션의 구문은 다음과 같습니다:

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

데이터 정렬을 지정할 때 locale 필드는 필수이고, 다른 데이터 정렬 필드는 모두 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.

문서

선택 사항.

사용자가 { "$**" : 1} 키 패턴을 사용하여 와일드카드 인덱스에서 특정 필드 경로를 포함하거나 제외할 수 있습니다. 이 옵션은 모든 문서 필드에 와일드카드 인덱스를 생성하는 경우에만 유효합니다. 특정 필드 경로 및 해당 하위 필드에 와일드카드 인덱스를 생성하는 경우에는 이 옵션을 지정할 수 없습니다(예: { "path.to.field.$**" : 1 }).

wildcardProjection 옵션은 다음과 같은 형식을 취합니다.

wildcardProjection: {
  "path.to.field.a" : <value>,
  "path.to.field.b" : <value>
}

<value> 다음 중 하나일 수 있습니다.

• 1 또는 true를 입력하여 와일드카드 인덱스에 필드를 포함시킵니다.

• 0 또는 false를 입력하여 와일드카드 인덱스에서 필드를 제외합니다.

와일드카드 인덱스는 기본적으로 _id 필드를 생략합니다. 와일드카드 인덱스에 _id 필드를 포함하려면 해당 필드를 wildcardProjection 문서에 명시적으로 포함해야 합니다.

{
  "wildcardProjection" : {
    "_id" : 1,
    "<field>" : 0|1
  }
}

wildcardProjection 문서의 모든 명령문은 포함문 또는 제외문이어야 합니다. 제외문과 함께 _id 필드를 포함할 수도 있습니다. 이는 규칙의 유일한 예외입니다.