CORTEX_SEARCH_DATA_SCAN

CORTEX_SEARCH_DATA_SCAN (Cortex Search 데이터 스캔)

이 테이블 함수는 Cortex Search 서비스가 인덱싱한 데이터를 반환해요. 여기에는 소스 쿼리에 정의된 열과 검색 열에 대해 계산된 벡터 임베딩이 포함돼요.

출처: Snowflake SQL Reference - CORTEX_SEARCH_DATA_SCAN

본문

구문

CORTEX_SEARCH_DATA_SCAN(
 SERVICE_NAME => '<string>' )

인자

필수:

SERVICE_NAME => 'string'

Cortex Search 서비스의 이름이에요.

다음 중 하나를 지정할 수 있어요.

  • 한정되지 않은 이름(service_name)

  • 부분적으로 한정된 이름(schema_name.service_name)

  • 완전히 한정된 이름(database_name.schema_name.service_name)

객체 이름 확인에 대한 자세한 내용은 객체 이름 확인(Object Name Resolution)을 참고하세요.

출력

이 함수는 소스 쿼리에 지정된 모든 열과 검색 열에 대한 임베딩을 반환해요. 임베딩 열은 VECTOR 데이터 타입이며 _GENERATED_EMBEDDINGS_{MODEL_NAME}로 이름이 지정돼요.

열의 순서는 소스 쿼리의 열 순서와 같고, 임베딩 열이 끝에 추가돼요.

사용 시 참고 사항

  • Cortex Search에 대한 OPERATE 권한이 필요해요. 자세한 내용은 접근 제어 권한(Access control privileges)을 참고하세요.

예시

다음과 같이 정의된 transcript_search_service라는 Cortex Search 서비스가 있다고 가정해요.

CREATE OR REPLACE CORTEX SEARCH SERVICE transcript_search_service
 ON transcript_text
 ATTRIBUTES region
 WAREHOUSE = cortex_search_wh
 TARGET_LAG = '1 day'
 AS (
 SELECT
 transcript_text,
 region,
 agent_id,
 FROM support_transcripts
);

Cortex Search 서비스 생성 방법은 Cortex Search 개요(Cortex Search Overview)를 참고하세요.

테이블 함수를 사용해 Cortex Search 서비스 transcript_search_service의 내용을 검색할 수 있어요.

SELECT
 *
FROM
 TABLE (
 CORTEX_SEARCH_DATA_SCAN (
 SERVICE_NAME => 'transcript_search_service'
 )
 );
+ ---------------------------------------------------------- + --------------- + -------- + ------------------------------ +
| transcript_text                                            | region          | agent_id | _GENERATED_EMBEDDINGS_MY_MODEL |
| ---------------------------------------------------------- | --------------- | -------- | ------------------------------ |
| 'My internet has been down since yesterday, can you help?'  | 'North America' | 'AG1001' | [0.1, 0.2, 0.3, 0.4]           |
| 'I was overcharged for my last bill, need an explanation.'  | 'Europe'        | 'AG1002' | [0.1, 0.2, 0.3, 0.4]           |
+ ---------------------------------------------------------- + --------------- + -------- + ------------------------------ +

더 알아보기