MongoDB\Collection::createIndex()

정의

MongoDB\Collection::createIndex()

collection에 대한 인덱스를 만듭니다.

function createIndex(
    array|object $key,
    array $options = []
): string

매개변수

$key : 배열|객체

인덱싱할 필드와 인덱스 순서를 지정합니다.

예를 들어 다음은 username 필드에 내림차순 인덱스를 지정합니다.

[ 'username' => -1 ]

$options : 배열

원하는 옵션을 지정하는 배열입니다.

$options 매개변수는 인덱스 옵션 과 명령 옵션을 모두 허용합니다. 다음은 인덱스 옵션의 비완전한 목록입니다. 인덱스 옵션의 전체 목록은 MongoDB 매뉴얼의 createIndexes 명령 참조를 참조하세요.

인덱스 옵션 (비제한적)

데이터 정렬	배열|객체	데이터 정렬 을 통해 사용자는 string 비교를 위한 언어별 규칙(예: 대소문자 및 악센트 표시 규칙)을 지정할 수 있습니다. 데이터 정렬을 지정할 때 locale 필드는 필수입니다. 다른 모든 데이터 정렬 필드는 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요. 데이터 정렬이 지정되지 않았지만 컬렉션에 기본 데이터 정렬이 있는 경우, 작업은 컬렉션에 지정된 데이터 정렬을 사용합니다. 컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다.
expireAfterSeconds	integer	TTL 인덱스를 생성합니다.
이름	문자열	인덱스를 고유하게 식별하는 이름입니다. 기본적으로 MongoDB는 키를 기반으로 인덱스 이름을 생성합니다.
부분 필터 표현식	배열|객체	부분 인덱스 를 만듭니다.
희박	부울	희소 인덱스를 생성합니다.
unique	부울	고유 인덱스를 생성합니다.

명령 옵션

이름	유형	설명
comment	혼합	사용자가 데이터베이스 프로파일러, currentOp 출력 및 로그를 통해 작업을 추적하는 데 도움이 되는 임의의 주석을 지정할 수 있습니다. 이 옵션은 MongoDB 4.4부터 사용할 수 있으며 이전 서버 버전에 대해 지정된 경우 실행 시 예외가 발생합니다. 버전 1.13에 새로 추가되었습니다.
commitQuorum	문자열|정수	프라이머리가 인덱스를 준비됨으로 표시하기 전에 프라이머리를 포함한 복제본 세트의 데이터 보유 노드가 인덱스 빌드를 성공적으로 완료해야 하는 멤버의 수를 지정합니다. 이 옵션은 쓰기 고려 (write concern)의 w 필드에 더하기 "votingMembers" 에 대해 동일한 값을 허용하며, 이는 모든 투표 데이터 보유 노드를 나타냅니다. 이 기능은 4.4 이전의 서버 버전에서는 지원되지 않으며, 사용 시 실행 시 예외가 발생합니다. 버전 1.7에 추가 되었습니다.
최대 시간 (MS)	integer	커서에서 작업을 처리하는 데 걸리는 누적 시간 제한(밀리초)입니다. MongoDB는 중단 지점 이후 가장 빠른 시점에 작업을 중단합니다. 버전 1.3에 새로 추가되었습니다.
Session	MongoDB\Driver\Session	작업과 연결할 클라이언트 세션입니다. 버전 1.3에 새로 추가되었습니다.
쓰기 고려	MongoDB\Driver\WriteConcern	작업에 사용할 고려를 씁니다 . 기본값은 컬렉션의 쓰기 고려입니다. 트랜잭션의 일부로 개별 작업에 대한 쓰기 고려를 지정할 수 없습니다. 대신 트랜잭션을시작할 때 writeConcern 옵션을 설정합니다.

Return Values

생성된 인덱스의 이름(문자열)입니다.

오류/예외

옵션이 사용되지만 선택한 서버에서 지원되지 않는 경우 MongoDB\Exception\UnsupportedException입니다(예: collation, readConcern, writeConcern).

MongoDB\Exception\InvalidArgumentException 매개변수 또는 옵션의 구문 분석과 관련된 오류의 경우입니다.

MongoDB\ 드라이버\Exception\RuntimeException 확장 수준의 다른 오류(예: 연결 오류).

예시

<?php
$collection = (new MongoDB\Client)->selectCollection('test', 'restaurants');
$indexName = $collection->createIndex(['borough' => 1, 'cuisine' => 1]);
var_dump($indexName);

string(19) "borough_1_cuisine_1"

<?php
$collection = (new MongoDB\Client)->selectCollection('test', 'restaurants');
$indexName = $collection->createIndex(
   ['borough' => 1],
   [
       'partialFilterExpression' => [
           'borough' => ['$exists' => true],
       ],
   ]
);
var_dump($indexName);

string(9) "borough_1"

다음도 참조하세요.

• MongoDB\Collection::createIndexes()

• 인덱스를 사용하여 쿼리 최적화

• MongoDB 매뉴얼의 createIndexes 명령 참조

• MongoDB 매뉴얼의 인덱스 문서