ALTER COMPUTE POOL

既存の コンピュートプール のプロパティを変更します。

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

CREATE COMPUTE POOL、 DESCRIBE COMPUTE POOL、 DROP COMPUTE POOL、 SHOW COMPUTE POOLS

構文

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

ALTER COMPUTE POOL [ IF EXISTS ] <name> STOP ALL  [ OF TYPE <workload_type> [ , ... ] ]

ALTER COMPUTE POOL [ IF EXISTS ] <name> SET [ MIN_NODES = <num> ]
                                            [ MAX_NODES = <num> ]
                                            [ AUTO_RESUME = { TRUE | FALSE } ]
                                            [ AUTO_SUSPEND_SECS = <num> ]
                                            [ PLACEMENT_GROUP = '<placement_group_name>' ]
                                            [ INSTANCE_FAMILY = <instance_family_name> ]
                                            [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ]
                                            [ COMMENT = '<string_literal>' ]

ALTER COMPUTE POOL [ IF EXISTS ] <name> UNSET { AUTO_SUSPEND_SECS |
                                                AUTO_RESUME       |
                                                PLACEMENT_GROUP   |
                                                COMMENT
                                              }
                                              [ , ... ]
Copy

パラメーター

name

変更するコンピュートプールの識別子を指定します。

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

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

{ SUSPEND | RESUME }

コンピューティングプールを中断するか、または中断していたコンピューティングプールを再開します。コンピューティングプールを中断すると、Snowflakeはコンピューティングプール内のすべてのサービスを中断しますが、ジョブは終了状態（DONE または FAILED）になるまで実行され続け、その後コンピューティングプールノードは解放されます。

STOP ALL  OF TYPE workload_type [ , ... ]

すべてのサービスをドロップし、コンピューティングプールで実行中のジョブをキャンセルします。その後、Snowflakeはコンピューティングプールからすべてのコンテナを削除します。オプションの OF TYPE 句が指定された場合、Snowflakeは指定されたワークロードタイプのサービスのみを停止します。使用可能なワークロードタイプのリストについては、 ALLOWED_SPCS_WORKLOAD_TYPES をご参照ください。

フィルターは大文字と小文字を区別しません。

SET ...

コンピュートプールに1つ以上の指定されたプロパティやパラメーターを設定します。

MIN_NODES = num

コンピュートプールの最小ノード数を指定します。

MAX_NODES = num

コンピュートプールの最大ノード数を指定します。

AUTO_RESUME = { TRUE | FALSE }

サービスやジョブの送信時にコンピュートプールを自動的に再開するかどうかを指定します。AUTO_RESUME が FALSE の場合、コンピュートプール上でサービスやジョブを開始する前に、明示的に（ALTER COMPUTE POOL <name> RESUMEを使用して）コンピュートプールを再開する必要があります。

AUTO_SUSPEND_SECS = num

Snowflakeがコンピュートプールを自動的に一時停止させるまでの非アクティブの秒数。非アクティブとは、コンピュートプール内のどのノード上でもサービスやジョブが実行されていないことを意味します。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、 Tag quotas をご参照ください。

PLACEMENT_GROUP = placement_group_name

コンピューティングプールの配置グループ を識別します。SHOW COMPUTE POOLS コマンドおよび DESCRIBE COMPUTE POOL コマンドを使用して、コンピューティングプールの配置グループへの割り当てを精査します。

INSTANCE_FAMILY = instance_family_name

コンピュートプールのノードにプロビジョニングするマシンのタイプを指定します。マシンタイプは、コンピュートプールのコンピュートリソースの量を決定するため、コンピュートプールの実行中に消費されるクレジットの数を決定します。使用可能なインスタンスファミリー名のリストについては、 インスタンスファミリー をご参照ください。

INSTANCE_FAMILY は、コンピューティングプールが完全に一時停止している場合にのみ変更できます。再開時に、Snowflakeは新しいインスタンス型を使用してコンピューティングプールをプロビジョニングします。

COMMENT = 'string_literal'

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

UNSET ...

Specifies one or more properties and/or parameters to unset for the compute pool, which resets them to the defaults. For more information, see CREATE COMPUTE POOL:

  • AUTO_SUSPEND_SECS

  • AUTO_RESUME

  • PLACEMENT_GROUP:配置グループは、コンピューティングプールが完全に一時停止している場合にのみ設定解除できます。

  • COMMENT

アクセス制御の要件

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

権限

オブジェクト

注意

OPERATE

コンピューティングプール

コンピュートプールを一時停止または再開するには、ロールにこれらの権限が必要です。

MODIFY

コンピューティングプール

コンピュートプールを変更し、プロパティを設定するには、ロールにこの権限が必要です。

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

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

使用上の注意

  • メタデータについて:

    注意

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

例

以下の例では、コンピュートプールに MAX_NODES と AUTO_RESUME プロパティを設定しています。

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE
Copy

次の例では、「CPU_X64_S」をコンピューティングプールの INSTANCE_FAMILTY として設定します。インスタンスファミリーを変更するにはコンピューティングプールを停止する必要があるため、最初にコンピューティングプールが一時停止されます。

ALTER COMPUTE POOL tutorial_compute_pool SUSPEND;
ALTER COMPUTE POOL tutorial_compute_pool SET
  INSTANCE_FAMILY = CPU_X64_S;
ALTER COMPUTE POOL tutorial_compute_pool RESUME;
Copy
言語: 日本語