カテゴリ:

テーブル関数

CORTEX_SEARCH_DATA_SCAN

このテーブル関数は、 Cortex Search Service によりインデックス付けされたデータを、ソースクエリで定義された列と検索列用に埋め込まれた計算済みベクトルを含めて返します。

構文

CORTEX_SEARCH_DATA_SCAN(
      SERVICE_NAME => '<string>' )
Copy

引数

必須:

SERVICE_NAME => 'string'

Cortex Search Serviceの名前。

以下のいずれかを指定できます。

  • 修飾されていない名前(service_name

  • 部分修飾名(schema_name.service_name

  • 完全修飾名(database_name.schema_name.service_name

オブジェクト名解決の詳細情報については、 オブジェクト名解決 をご参照ください。

出力

この関数は、ソースクエリで指定されたすべての列と、検索列の埋め込みを返します。埋め込み列は、 VECTOR データ型 で、 _GENERATED_EMBEDDINGS_{MODEL_NAME} という名前です。

列の順序は、埋め込み列が最後に追加されたソースクエリの列の順序と同じです。

使用上の注意

transcript_search_service という名前のCortex Search Serviceが次のように定義されているとします。

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
);
Copy

Cortex Search Serviceの作成については、 Cortex Searchの概要 をご参照ください。

テーブル関数を使用して、Cortex Search Service transcript_search_service のコンテンツを取得できます。

SELECT
  *
FROM
  TABLE (
    CORTEX_SEARCH_DATA_SCAN (
      SERVICE_NAME => 'transcript_search_service'
    )
  );
Copy
+ ---------------------------------------------------------- + --------------- + -------- + ------------------------------ +
|                      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]           |
+ ---------------------------------------------------------- + --------------- + -------- + ------------------------------ +