MongoDB\Collection::updateSearchIndex()

정의

MongoDB\Collection::updateSearchIndex()

collection에 대한 Atlas Search 검색 인덱스를 업데이트합니다.

function updateSearchIndex(
    string $name,
    array|object $definition,
    array $options = []
): void

이 명령은 MongoDB Atlas 에 호스팅된 배포에서만 실행할 수 있으며, 10 이상의 Atlas 클러스터 계층이 필요합니다. 로컬 Atlas 배포서버 를 개발에도 사용할 수 있습니다.

매개변수

$name : 문자열

업데이트할 인덱스의 이름입니다.

$definition : 배열|객체

업데이트된 Atlas Search 인덱스 정의를 설명하는 문서입니다. 지정된 정의가 Atlas Search 인덱스의 이전 정의를 대체합니다. 정의 구문에 대한 자세한 내용은 Atlas Search 인덱스 정의 구문을 참조하세요.

$options : 배열

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

이름	유형	설명
comment	혼합	사용자가 데이터베이스 프로파일러, currentOp 출력 및 로그를 통해 작업을 추적하는 데 도움이 되는 임의의 주석을 지정할 수 있습니다.

오류/예외

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

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

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

행동

Atlas Search 인덱스는 비동기적으로 managed 됩니다. 인덱스 를 생성하거나 업데이트한 후 주기적으로 MongoDB\Collection::listSearchIndexes() 를 실행하고 queryable 출력 필드 를 확인하여 사용할 준비가 되었는지 확인할 수 있습니다.

다음도 참조하세요.

• MongoDB\Collection::createSearchIndex()

• MongoDB\Collection::createSearchIndexes()

• MongoDB\Collection::dropSearchIndex()

• MongoDB\Collection::listSearchIndexes()

• MongoDB 매뉴얼의 updateSearchIndex 명령 참조

• MongoDB 매뉴얼의 Atlas Search 문서