CORTEX_SEARCH_BATCH

Cortex Search 서비스에 쿼리 배치를 제출해 엔티티 해석, 중복 제거, 대상 매칭, 클러스터링 같은 고처리량 오프라인 사용 사례를 지원하는 테이블 함수예요.

출처: 공식 문서

본문

이 테이블 함수는 엔티티 해석, 중복 제거, 대상 매칭(audience matching), 클러스터링 같은 고처리량 오프라인 사용 사례를 위해 Cortex Search 서비스에 쿼리 배치를 제출합니다.

배치 검색은 대화형 검색 트래픽과 독립적으로 확장되는 전용 서버리스 컴퓨트를 사용합니다. 비용 고려 사항, 사용 참고 사항, 예제를 포함한 전체 가이드는 Batch Cortex Search를 참고하세요.

구문 (Syntax)

CORTEX_SEARCH_BATCH(
      SERVICE_NAME => '<string>'
      [, QUERY => <string_column> ]
      [, MULTI_INDEX_QUERY => <variant_column> ]
      [, FILTER => <variant_column> ]
      [, LIMIT => <integer> ]
      [, OPTIONS => <variant_column> ]
)

인자 (Arguments)

필수:

쿼리할 Cortex Search 서비스의 완전히 한정된 이름(fully-qualified name)입니다.

다음 중 하나를 지정할 수 있습니다:

한정되지 않은 이름 (service_name)
부분적으로 한정된 이름 (schema_name.service_name)
완전히 한정된 이름 (database_name.schema_name.service_name)

선택:

서비스를 검색하는 데 사용할 쿼리 문자열을 포함하는 열입니다.

서비스 인덱스에 대해 검색할 하나 이상의 벡터 또는 키워드 쿼리 입력을 지정하는 객체를 포함하는 열입니다. 자세한 내용은 multi_index_query를 참고하세요.

검색 결과에 적용할 필터 객체를 포함하는 열입니다.

쿼리당 반환할 최대 결과 수입니다. 기본값: 10.

선택적 per-query 설정이 있는 VARIANT 객체를 포함하는 열입니다. 지원되는 키:

scoring_config: 쿼리의 랭킹을 사용자 지정합니다. Customize scoring을 참고하세요.
replicas: 쿼리를 제공하는 인덱스 복사본 수 (기본값: 2). 더 높은 값은 작업을 더 빨리 완료합니다.

참고 (Note): QUERY, MULTI_INDEX_QUERY 또는 FILTER 중 적어도 하나를 지정해야 합니다.

출력 (Output)

이 함수는 각 쿼리와 일치하는 인덱스된 서비스 데이터의 열을 관련성 점수 포함해 반환합니다.

사용 참고 사항 (Usage notes)

소스 테이블의 쿼리 열을 전달하려면 LATERAL 조인과 함께 사용하세요.
재랭킹(reranking)은 배치 검색 쿼리에 지원되지 않습니다. scoring_config의 재랭커 설정은 무시됩니다.
배치 검색은 현재 serving에서 일시 중지된(suspended) 서비스를 쿼리할 수 있습니다.
배치 및 대화형 쿼리는 별도의 컴퓨트를 사용하며 리소스를 두고 경쟁하지 않습니다.
2,000개 미만의 쿼리에서는 대화형 Cortex Search API가 일반적으로 더 빠른 결과를 제공합니다.
Cortex Search 서비스를 대화형으로 쿼리할 때와 동일한 권한이 필요합니다.

자세한 사용 참고 사항과 비용 정보는 Batch Cortex Search를 참고하세요.

예제 (Examples)

제출된 제품 이름을 표준 카탈로그(golden catalog)와 매칭합니다:

SELECT
  q.product, s.*
FROM submitted_products AS q,
LATERAL CORTEX_SEARCH_BATCH(
    SERVICE_NAME => 'my_db.my_schema.golden_product_service',
    QUERY => q.product,
    LIMIT => 2
) AS s;

CORTEX_SEARCH_BATCH