ALTER SERVICE

Snowpark Container Servicesサービス 構成を変更したり、サービスのコードをアップグレードしたり、サービスを中断または再開できます。次を実行できます。

  • 実行中のサービスに修正を適用する。たとえば、サービスの中断や再開、実行中のサービスインスタンス数の更新などです。

  • サービスの再起動後にのみ有効になる変更を適用する。例えば、クエリのデフォルトのウェアハウスを指定します。

  • Snowflakeがサービスをシャットダウンする必要がある修正を適用し、新しいコードを使用して再起動する。例えば、更新されたサービスコードをデプロイする場合です。

こちらもご参照ください。

CREATE SERVICEDESCRIBE SERVICEDROP SERVICESHOW SERVICES

構文

ALTER SERVICE [ IF EXISTS ] <name> { SUSPEND | RESUME }

ALTER SERVICE [ IF EXISTS ] <name>
  {
    FROM @<stage>
    SPECIFICATION_FILE = '<yaml_file_stage_path>'
    |
    FROM SPECIFICATION <specification_text>
  }

ALTER SERVICE [ IF EXISTS ] <name> SET [ MIN_INSTANCES = <num> ]
                                       [ MAX_INSTANCES = <num> ]
                                       [ QUERY_WAREHOUSE = <warehouse_name> ]
                                       [ AUTO_RESUME = { TRUE | FALSE } ]
                                       [ COMMENT = '<string_literal>' ]

ALTER SERVICE [ IF EXISTS ] <name> UNSET { MIN_INSTANCES      |
                                           MAX_INSTANCES      |
                                           QUERY_WAREHOUSE    |
                                           AUTO_RESUME        |
                                           COMMENT
                                         }
                                         [ , ... ]
Copy

パラメーター

name

変更するサービスの識別子を指定します。

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

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

{ SUSPEND | RESUME }

サービスを中断または再開するかどうかを指定します。

サービスを中断すると、Snowflakeはシャットダウンしてコンテナを削除します。中断したサービスを後で再開する場合、Snowflakeはコンテナを再作成します。つまり、Snowflakeはリポジトリからイメージを取得し、コンテナを起動します。リポジトリ内のイメージが更新された場合、Snowflakeは更新されたイメージを使用してコンテナを再作成することに注意してください。

サービス関数を使用して、またはパブリックエンドポイント(イングレス)を呼び出して、中断したサービスを起動すると、Snowflakeは自動的にサービスを再開します。

FROM stage

仕様ファイルが保管されているSnowflake内部ステージを指定します。例えば、「@tutorial_stage」です。

SPECIFICATION_FILE = 'yaml_file_stage_path'

ステージのサービス仕様ファイルへのパスを指定します。例えば、「/some-dir/echo_spec.yaml」です。

FROM SPECIFICATION specification_text

サービス仕様を指定します。ドル記号($$)のペアを使用して、仕様文字列の開始と終了を区切ることができます。

SET ...

サービスの1つ以上の指定されたプロパティまたはパラメーターを設定します。

MIN_INSTANCES = num

サービスインスタンスの最小数を指定します。

MAX_INSTANCES = num

サービスインスタンスの最大数を指定します。

QUERY_WAREHOUSE = warehouse_name

サービスコンテナがクエリを実行するためにSnowflakeに接続するけれども、使用するウェアハウスを明示的に指定しない場合に使用するウェアハウス。

AUTO_RESUME = { TRUE | FALSE }

サービス関数が呼び出されたときやリクエストを受信したときに、自動的にサービスを再開するかどうかを指定します。

COMMENT = 'string_literal'

コンピューティングプールのコメントを指定します。

UNSET ...

サービスの設定を解除する1つ(または複数)のプロパティ、パラメーター、またはその両方を指定します。これにより、デフォルトにリセットされます(CREATE SERVICE をご覧ください)。

  • MIN_INSTANCES

  • MAX_INSTANCES

  • QUERY_WAREHOUSE

  • AUTO_RESUME

  • COMMENT

アクセス制御の要件

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

権限

オブジェクト

メモ

OPERATE

サービス

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

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

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

使用上の注意

  • メタデータについて:

    注意

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

サービスを一時停止する。

ALTER SERVICE echo_service SUSPEND;
Copy

既存のサービスの MIN_INSTANCES と MAX_INSTANCES プロパティを変更する。

ALTER SERVICE echo_service SET MIN_INSTANCES=3 MAX_INSTANCES=5;
Copy