ALTER CORTEX SEARCH SERVICE

既存の Cortex Search Service のプロパティを変更します。

構文

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name>
  { SUSPEND | RESUME } [ { INDEXING | SERVING } ]

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name> SET
  [ TARGET_LAG = { '<num> { seconds | minutes | hours | days }' } ]
  [ WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>' ];
Copy

パラメーター

name

変更するCortex Search Serviceの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

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

{ SUSPEND | RESUME } ...

Cortex Search Serviceのインデックス作成、サービス提供、またはその両方を一時停止または再開します。中断または再開するレイヤーを示すために、以下のキーワードのいずれかを指定することができます。

INDEXING

Cortex Search Serviceのインデックス層を示すターゲット。詳細については、 使用上の注意 をご参照ください。

SERVING

Cortex Search Serviceのサービングレイヤーを示すターゲット。詳細については、 使用上の注意 をご参照ください。

どちらのキーワードも指定しない場合、インデックス作成レイヤーとサービングレイヤーの両方が一時停止または再開されます。

SET ...

Cortex Search Serviceに設定する1つ以上の指定されたプロパティまたはパラメーターを設定します。

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

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

WAREHOUSE = warehouse_name

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

COMMENT = 'string_literal'

アプリケーションのコメントを追加するか、既存のコメントを上書きします。

アクセス制御の要件

権限

オブジェクト

OWNERSHIP

プロパティを変更したいCortex Search Service。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

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

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

使用上の注意

注意

Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

INDEXING および SERVING 状態

INDEXING はCortex Search Serviceのインデックス層を示すターゲットです。RUNNING 状態の時、サービスのソース・クエリによって参照されるベース・テーブルが変更されると、検索インデックスの一部として保存されているマテリアライズド・データが更新されます。これらのリフレッシュには、ウェアハウスの計算とベクトルの埋め込みという形でコストがかかります。SUSPENDED 状態の時、ベーステーブルの変更はリフレッシュのトリガーとならず、Cortex Search Serviceのクエリ可能なデータにも反映されません。

SERVING は、Cortex Search Serviceのサービングレイヤーを示すターゲットです。サービスがクエリ可能になるためには、このターゲットが RUNNING の状態でなければなりません。中断状態にある場合、Cortex Search Serviceは、Cortex Search サービス費用という形での請求は発生しません。

詳細なコストについては、 コストの考慮事項 をご参照ください。

Cortex Search Serviceの INDEXING 、 SERVING レイヤーは独立して管理することができます。例えば、 SERVING が実行状態で、 INDEXING が中断中であっても、サービスにクエリすることができます。ただし、 INDEXING が再開され、リフレッシュが正常に完了するまでは、 TARGET_LAG にかかわらず、ベースデータの変更はサービスに反映されません。

逆に、 SERVING が中断している間に INDEXING が実行されている場合、インデックスは更新を続けます。SERVING が再開されると、クエリ可能になるロードされたインデックスには、最新のソース・データが反映されます。

SERVING 、 INDEXING のどちらのキーワードも指定されていない場合、両方のターゲットが指定されたアクションの影響を受けます。

例

以下の例では、 mysvc というCortex Search Serviceが使用するウェアハウスを、 my_new_wh に変更しています。

ALTER CORTEX SEARCH SERVICE mysvc SET WAREHOUSE = my_new_wh;
Copy

以下の例では、 mysvc というCortex Search Serviceのコメントフィールドを new_comment に設定しています。

ALTER CORTEX SEARCH SERVICE mysvc SET COMMENT = 'new_comment';
Copy

以下の例では、 mysvc というCortex Search Serviceのターゲット更新ラグを、 1 hour に変更しています。

ALTER CORTEX SEARCH SERVICE mysvc SET TARGET_LAG = '1 hour';
Copy

次の例では、 mysvc という名前のCortex Search Serviceのサービングを一時停止します。

ALTER CORTEX SEARCH SERVICE mysvc SUSPEND SERVING;
Copy
言語: 日本語