ALTER COMPUTE POOL¶

構文¶

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

ALTER COMPUTE POOL [ IF EXISTS ] <name> STOP ALL;

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
                                              }
                                              [ , ... ]

パラメーター¶

name

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

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

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

{ SUSPEND | RESUME }

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

STOP ALL

すべてのサービスをドロップし、コンピューティングプールで実行中のジョブをキャンセルします。その後、Snowflakeはコンピューティングプールからすべてのコンテナを削除します。

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

Identifies the placement group of the compute pool. Use the SHOW COMPUTE POOLS and DESCRIBE COMPUTE POOL commands to review the assignment of the compute pool into placement groups.

INSTANCE_FAMILY = instance_family_name

Identifies the type of machine you want to provision for the nodes in the compute pool. The machine type determines the amount of compute resources in the compute pool and, therefore, the number of credits consumed while the compute pool is running. For a list of available instance family names, see instance families.

INSTANCE_FAMILY can be altered only when a compute pool is fully suspended. Upon resuming, Snowflake uses the new instance type to provision the compute pool.

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: The placement group can only be unset when the compute pool is fully suspended.

• COMMENT

アクセス制御の要件¶

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

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

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

使用上の注意¶

• メタデータについて:

  注意

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

例¶

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

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE

The following example sets the "CPU_X64_S" as the INSTANCE_FAMILTY for a compute pool. Because the compute pool must be stopped to change the instance family, the compute pool is first suspended:

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;