カテゴリ：: テーブル関数

CORTEX_SEARCH_DATA_SCAN¶

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

構文¶

CORTEX_SEARCH_DATA_SCAN(
      SERVICE_NAME => '<string>' )

引数¶

必須：

SERVICE_NAME => 'string'

Cortex Search Serviceの名前。

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

修飾されていない名前（service_name）
部分修飾名（schema_name.service_name）
完全修飾名（database_name.schema_name.service_name）

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

出力¶

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

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

使用上の注意¶

Cortex Searchには OPERATE 権限が必要です。詳細は、アクセス制御権限をご参照ください。

例¶

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

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

テーブル関数を使用して、Cortex Search Service 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]           |
+ ---------------------------------------------------------- + --------------- + -------- + ------------------------------ +