CREATE CORTEX SEARCH SERVICE¶

構文¶

CREATE [ OR REPLACE ] CORTEX SEARCH SERVICE [ IF NOT EXISTS ] <name>
  ON <search_column>
  ATTRIBUTES <col_name> [ , ... ]
  WAREHOUSE = <warehouse_name>
  TARGET_LAG = '<num> { seconds | minutes | hours | days }'
  [ EMBEDDING_MODEL = <embedding_model_name> ]
  [ INITIALIZE = { ON_CREATE | ON_SCHEDULE } ]
  [ COMMENT = '<comment>' ]
AS <query>;

CREATE [ OR REPLACE ] CORTEX SEARCH SERVICE <name>
  TEXT INDEXES <text_column_name> [ , ... ]
  VECTOR INDEXES <column_specification> [ , ... ]
  ATTRIBUTES <col_name> [ , ... ]
  WAREHOUSE = <warehouse_name>
  TARGET_LAG = '<num> { seconds | minutes | hours | days }'
  [ INITIALIZE = { ON_CREATE | ON_SCHEDULE } ]
  [ COMMENT = '<comment>' ]
AS <query>;

必須パラメーター¶

name

Cortex Search Service用のノートブックの識別子（つまり、名前）を指定する文字列。ノートブックが作成されるスキーマに対して一意にする必要があります。

また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません（例: "My object"）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

ON search_column

Specifies the text column in the base table that you wish to search on, for single-index Cortex Search. This column must be a text value.

TEXT INDEXES text_column_name [, ... ]

Specifies comma-separated text columns in the base table to search on, for multi-index Cortex Search. Columns must be text values.

VECTOR INDEXES column_specification [ , ... ]

ベクトル類似性検索の列を指定します。列の仕様には次が含まれます。

• 管理されたベクトル埋め込み: text_column_name (model='embedding_model'):ベクトル生成に使用するテキスト列と埋め込みモデルを指定します。サポートされている埋め込みモデル のいずれかを使用する必要があります。モデルが指定されていない場合、デフォルトのモデル snowflake-arctic-embed-m-v1.5 が使用されます。

• ユーザー提供のベクトル埋め込み: vector_column_name:ユーザーが提供するベクトル埋め込み列を指定します。

• 管理されたクエリ埋め込みを持つユーザー提供のベクトル埋め込み: vector_column_name(query_model='embedding_model'):ユーザーが提供するベクトル埋め込み列と、クエリ時にテキスト埋め込みに使用される埋め込みモデルを指定します。query_model は Cortex SearchでサポートされるSnowflake管理埋め込みモデル のいずれかである必要があります。query_model が指定されていない場合、ユーザー提供のベクトル列はベクトル埋め込みクエリと一緒にのみ使用できます。

ベクトル埋め込みの動作については、 使用上の注意 をご参照ください。

ATTRIBUTES col_name [ , ... ]

サービスにクエリを発行する際にフィルタリングしたいベーステーブルの列のリストをカンマ区切りのリストで指定します。属性列は、明示的な列挙またはワイルドカード（*）を使用して、ソース・クエリに含める必要があります。

WAREHOUSE = warehouse_name

ソースクエリを実行し、検索インデックスを構築し、 TARGET_LAG ターゲットに従って更新し続けるために使用するウェアハウスを指定します。

TARGET_LAG = 'num { seconds | minutes | hours | days }'

Cortex Search Serviceのコンテンツがソースクエリで指定されたベーステーブルの更新から遅れる最大時間を指定します。

オプションのパラメーター¶

EMBEDDING_MODEL = <embedding_model_name>

Cortex Search Serviceで使用する埋め込みモデルを指定するオプションパラメーター。このプロパティは、Cortex Search Serviceを作成した後に変更することはできません。プロパティを変更するには、 CREATE OR REPLACE CORTEX SEARCH SERVICE コマンドでCortex Search Serviceを再作成します。

一部の埋め込みモデルは、Cortex Searchの特定のクラウドリージョンでのみ利用可能です。リージョン/モデル別の可用性リストについては、 Cortex Searchリージョン別可用性 をご参照ください。

入力トークンが100万件処理されるごとに、各モデルに異なるコストが発生する場合があります。100万トークンあたりのクレジット単位での各コストについては、 Snowflakeサービス利用テーブル をご参照ください。

EMBEDDING_MODEL が指定されていない場合は、デフォルトのモデルが使用されます。デフォルトモデルは Snowflake-arctic-embed-m-v1.5 です。

INITIALIZE

Cortex Search Serviceの初期 更新 の動作を指定します。このプロパティは、サービス作成後に変更することはできません。プロパティを変更するには、Cortex Search Serviceを CREATE OR REPLACE CORTEX SEARCH SERVICE コマンドで置き換えます。

ON_CREATE

Cortex Search Serviceの作成時に同期的に更新します。この更新に失敗すると、サービスの作成に失敗し、エラーメッセージが表示されます。

ON_SCHEDULE

次のスケジュールでCortex Search Serviceを更新します。

Cortex Search Serviceは、更新スケジュール処理が実行されたときに入力されます。Cortex Search Serviceの作成時にはデータは入力されません。サービスをクエリしようとすると、最初のスケジュール更新がまだ発生していないため、次のようなエラーが表示されることがあります。

Your service has not yet been loaded into our serving system. Please retry your request in a few minutes.

デフォルト: ON_CREATE

COMMENT = 'comment'

サービスのコメントを指定します。

AS query

サービスが作成されるベース・テーブルを定義するクエリを指定します。

アクセス制御の要件¶

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意¶

• Cortex Searchサービスのソースクエリを実行するために使用されるウェアハウスのサイズは、各リフレッシュの速度とコストに影響します。より大きなウェアハウスは、ビルドとリフレッシュの時間を短縮します。ただし、このプレビュー期間中、Snowflake は Cortex Search サービスに MEDIUM 以下のウェアハウスサイズを使用することを推奨します。

• Snowflake では、他のワークロードと干渉しないように、Cortex Search サービスごとに専用のウェアハウスを使用することを推奨しています。

• 検索インデックスはcreate文の一部として構築されるため、 CREATE CORTEX SEARCH SERVICE 文は大きなデータセットの場合、完了までに時間がかかることがあります。

• マルチインデックスの検索サービスを作成する場合は、検索結果の最高の品質を確保するために VECTORINDEXES 句で少なくとも1つの列を指定する必要があります。ベクトルインデックスを持たないサービスを作成しようとすると、エラーが返されます。

• TEXTINDEXES 句、 VECTORINDEXES 句、またはその両方で列を指定できます。

  • テキストインデックスとして指定された列は、キーワード（レキシカル）検索に使用できます。テキストインデックスをクエリすると、結果はレキシカル類似度に基づいてスコアリングされます。

  • ベクトルインデックスとして指定された列は、ベクトル（セマンティック）検索に使用できます。ベクトルインデックスをクエリすると、結果はセマンティック類似度に基づいてスコアリングされます。

• テキストインデックスとベクトルインデックスの両方として指定された列は、どちらのタイプの検索にも使用されます。

• 各ベクトルインデックス列は、埋め込みを管理するために3つのメソッドのいずれかを使用します。

  • 管理されたベクトル埋め込み:Snowflakeは、テキスト列が ON または VECTOR INDEXES 句で指定された場合に、ベクトル埋め込みを計算します。サポートされている埋め込みモデル のいずれかを使用する必要があります。

  • ユーザー提供のベクトル埋め込み:あなたは Snowflakeが提供するベクトル埋め込みモデル またはCortex Search Serviceによる取り込み前の外部ホスト埋め込みモデルを使ったベクトル埋め込みの計算と、クエリ時のテキスト入力に責任があります。

  • 管理されたクエリ埋め込みを持つユーザー提供のベクトル埋め込み:あなたは、Cortex Search Serviceによる取り込みの前に Cortex SearchでサポートされるSnowflake管理埋め込みモデル のいずれかを使ってベクトル埋め込みを計算する責任があります。クエリ時に、Cortex Searchは指定された query_model を使用してテキストクエリを埋め込みます。

変更追跡の要件¶

Cortex Search Serviceを作成する際、クエリするテーブルで変更追跡が有効になっていない場合、Snowflakeは自動的にそれらのテーブルで変更追跡を有効にしようとします。増分リフレッシュをサポートするには、Cortex Search Serviceで使用されるすべての基本オブジェクトに対して、 ゼロ以外のTime Travel保持期間 で変更追跡を有効にする必要があります。

ベースオブジェクトが変更されると、Cortex Search Serviceも変更されます。ベースオブジェクトを再作成する場合は、変更追跡を再度有効にする必要があります。

変更追跡の有効化の詳細については、 変更の追跡を有効にする をご参照ください。

• OR REPLACE 句と IF NOT EXISTS 句は互いに排他的です。この2つを同じステートメントで使うことはできません。

• CREATE OR REPLACE <オブジェクト> ステートメントはアトミックです。つまり、オブジェクトが置き換えられると、単一のトランザクションで、古いオブジェクトが削除されて新しいオブジェクトが作成されます。

Examples¶

snowflake-arctic-embed-l-v2.0 埋め込みモデルを使用して、 mysvc という名前のCortex Searchサービスを作成します。

CREATE OR REPLACE CORTEX SEARCH SERVICE mysvc
  ON transcript_text
  ATTRIBUTES region,agent_id
  WAREHOUSE = mywh
  TARGET_LAG = '1 hour'
  EMBEDDING_MODEL = 'snowflake-arctic-embed-l-v2.0'
AS (
  SELECT
      transcript_text,
      date,
      region,
      agent_id
  FROM support_db.public.transcripts_etl
);

mysvc という名前のCortex Searchサービスを作成し、 TARGET_LAG 期間（1時間）が経過した後に最初の更新が実行されるようにスケジュールします。

CREATE OR REPLACE CORTEX SEARCH SERVICE mysvc
  ON transcript_text
  ATTRIBUTES region
  WAREHOUSE = mywh
  TARGET_LAG = '1 hour'
  INITIALIZE = ON_SCHEDULE
AS SELECT * FROM support_db.public.transcripts_etl;

テーブル business_directory を検索する business_search_service という名前のマルチインデックス検索サービスを作成する条件:

• name および address はテキストインデックスとして指定されているため、キーワード検索のみで検索可能です。

• description はベクトルインデックスとして指定されるため、管理されたベクトル埋め込みと snowflake-arctic-embed-m-v1.5 モデルを使用したベクトル（セマンティック）検索の対象となります。

-- Generate sample data
CREATE OR REPLACE TABLE business_directory (name TEXT, address TEXT, description TEXT);
INSERT INTO business_directory VALUES
    ('Joe''s Coffee', '123 Bean St, Brewtown','A cozy café known for artisan espresso and baked goods.'),
    ('Sparkle Wash', '456 Clean Ave, Sudsville', 'Eco-friendly car wash with free vacuum service.'),
    ('Tech Haven', '789 Circuit Blvd, Siliconia', 'Computer store offering the latest gadgets and tech repair services.'),
    ('Joe''s Wash n'' Fold', '456 Apple Ct, Sudsville', 'Laundromat offering coin laundry and premium wash and fold services.'),
    ('Circuit Town', '459 Electron Dr, Sudsville', 'Technology store selling used computer parts at discounted prices.')
;

-- Create the Cortex Search Service
CREATE OR REPLACE CORTEX SEARCH SERVICE business_search_service
    TEXT INDEXES name, address
    VECTOR INDEXES description (model='snowflake-arctic-embed-m-v1.5')
    WAREHOUSE = mywh
    TARGET_LAG = '1 hour'
    AS ( SELECT * FROM business_directory );

custom_vector_search_service というカスタムベクトル埋め込みを持つマルチインデックスのCortex Search Serviceを作成します。このサービスは、テキスト列（document_contents）と、テキスト列に対応する埋め込みを含むユーザー提供の別のベクトル埋め込み列（document_embedding）を持つテーブルを検索します。

-- Generate sample data
CREATE OR REPLACE TABLE business_documents (
  document_contents VARCHAR,
  document_embedding VECTOR(FLOAT, 3)
);
INSERT INTO business_documents VALUES
  ('Quarterly financial report for Q1 2024: Revenue increased by 15%, with expenses stable. Highlights include strategic investments in marketing and technology.', [1, 1, 1]::VECTOR(float, 3)),
  ('IT manual for employees: Instructions for usage of internal technologies, including hardware and software guides and commonly asked tech questions.', [2, 2, 2]::VECTOR(float, 3)),
  ('Employee handbook 2024: Updated policies on remote work, health benefits, and company culture initiatives.', [2, 3, 2]::VECTOR(float, 3)),
  ('Marketing strategy document: Target audience segmentation for upcoming product launch.', [1, -1, -1]::VECTOR(float, 3))
;

-- Create the Cortex Search Service
CREATE OR REPLACE CORTEX SEARCH SERVICE custom_vector_search_service
  TEXT INDEXES (document_contents)
  VECTOR INDEXES (document_embedding)
  WAREHOUSE = mywh
  TARGET_LAG = '1 minute'
  AS SELECT * FROM business_documents;

ユーザー管理のベクトル埋め込みと管理クエリ埋め込みを使用したサービス managed_vector_search_service を作成します。

-- Generate sample data
CREATE OR REPLACE TABLE business_documents (
  document_contents VARCHAR
);

INSERT INTO business_documents VALUES
  ('Quarterly financial report for Q1 2024: Revenue increased by 15%, with expenses stable. Highlights include strategic investments in marketing and technology.'),
  ('IT manual for employees: Instructions for usage of internal technologies, including hardware and software guides and commonly asked tech questions.'),
  ('Employee handbook 2024: Updated policies on remote work, health benefits, and company culture initiatives.'),
  ('Marketing strategy document: Target audience segmentation for upcoming product launch.');

-- Add managed vector embeddings
ALTER TABLE business_documents ADD COLUMN document_embeddings VECTOR(FLOAT, 768);
UPDATE business_documents SET document_embeddings = AI_EMBED('snowflake-arctic-embed-m-v1.5', document_contents);

-- Create the Cortex Search Service
CREATE OR REPLACE CORTEX SEARCH SERVICE managed_vector_search_service
  TEXT INDEXES document_contents
  VECTOR INDEXES document_embedding(query_model='snowflake-arctic-embed-m-v1.5')
  WAREHOUSE = mywh
  TARGET_LAG = '1 minute'
  AS SELECT * FROM business_documents;