MongoDB 벡터 검색 쿼리 실행

개요

이 가이드 에서는 MongoDB 벡터 검색 기능 사용하여 문서에서 검색을 수행하는 방법을 학습 수 있습니다. PHP 라이브러리를 사용하면 애그리게이션 빌더를 사용하여 MongoDB Vector Search 쿼리를 수행할 수 있습니다.

MongoDB Vector Search에 대해 자세히 학습 MongoDB Vector Search 개요를 참조하세요. PHP 라이브러리에 대한 MongoDB Vector Search 구현 내부적으로 $vectorSearch 집계 연산자 사용하여 쿼리를 수행합니다. 이 연산자 에 대해 자세히 학습 Atlas 문서에서 $vectorSearch 참조를 확인하세요.

벡터 검색 애그리게이션 단계

애그리게이션 빌더를 사용하여 MongoDB Vector Search 쿼리를 수행하려면 다음 클래스를 애플리케이션 으로 가져옵니다.

use MongoDB\Builder\Pipeline;
use MongoDB\Builder\Stage;

집계 파이프라인 에서 $vectorSearch 단계를 만들려면 다음 작업을 수행합니다.

1. 파이프라인 단계를 저장 Pipeline 인스턴스 를 만듭니다.

2. Stage::vectorSearch() 메서드를 호출하여 MongoDB Vector Search 단계를 만듭니다.

3. vectorSearch() 메서드 본문 내에서 벡터 쿼리 에 대한 기준을 지정합니다.

다음 코드는 기본 MongoDB Vector Search 쿼리를 구성하기 위한 템플릿을 보여줍니다.

$pipeline = new Pipeline(
    Stage::vectorSearch(
        /* MongoDB Vector Search query specifications
        index: '<index name>',
        path: '<path to embeddings>', ...*/
    ),
);

다음 매개변수를 vectorSearch() 메서드에 전달해야 합니다.

벡터 검색 쿼리 예제

이 섹션에서는 애그리게이션 빌더를 사용하여 MongoDB Vector Search 쿼리를 수행하는 방법에 대해 학습 봅니다. 이 섹션의 예제에서는 sample_mflix.embedded_movies 컬렉션 의 샘플 데이터를 사용합니다.

$pipeline = new Pipeline(
    Stage::vectorSearch(
        index: 'vector',
        path: 'plot_embedding',
        queryVector: [-0.0016261312, -0.028070757, -0.011342932],
        numCandidates: 150,
        limit: 5,
    ),
    Stage::project(
        _id: 0,
        title: 1,
    ),
);
$cursor = $collection->aggregate($pipeline);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

{"title":"Thrill Seekers"}
{"title":"About Time"}
{"title":"Timecop"}
// Results truncated

$pipeline = new Pipeline(
    Stage::vectorSearch(
        index: 'vector',
        path: 'plot_embedding',
        queryVector: [-0.0016261312, -0.028070757, -0.011342932],
        numCandidates: 150,
        limit: 5,
    ),
    Stage::project(
        _id: 0,
        title: 1,
        score: ['$meta' => 'vectorSearchScore'],
    ),
);
$cursor = $collection->aggregate($pipeline);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

{"title":"Thrill Seekers","score":0.927734375}
{"title":"About Time","score":0.925750732421875}
{"title":"Timecop","score":0.9241180419921875}
// Results truncated

벡터 검색 옵션

vectorSearch() 메서드를 사용하여 다양한 유형의 MongoDB Vector Search 쿼리를 수행할 수 있습니다. 원하는 쿼리 에 따라 다음 선택적 매개변수를 vectorSearch()에 전달할 수 있습니다.

이러한 매개변수에 대해 자세히 $vectorSearch 학습 Atlas 문서에서 연산자 참조의 필드 섹션을 참조하세요.