コンピュートプールの管理¶
コンピューティングプールは、SnowflakeがSnowpark Container Servicesのジョブやサービスを実行する1つ以上の仮想マシン(VM)ノードの集まりです。
コンピューティングプールに関する詳細については、 Snowpark Container Services: コンピューティングプールの操作 をご参照ください。
このトピックでは、サービスを使用して次のタスクを実行する方法を説明します。
リスト表示やドロップなどの一般的な操作では、 Snowflake CLI は Snowflakeオブジェクトの管理 で説明されている snow object
コマンドを使用します。
コンピューティングプールの作成¶
4 GB のメモリを持つ2つの CPUs で構成される「pool_1」という名前のコンピューティングプールを作成するには、次のような spcs pool create コマンドを入力します。
snow spcs compute-pool create "pool_1" --min-nodes 2 --max-nodes 2 --family "CPU_X64_XS"
インスタンスファミリの詳細については、 SQL CREATE COMPUTE POOL
コマンドをご参照ください。
プロジェクト定義からのコンピューティングプールの作成¶
snowflake.yml
プロジェクト定義ファイルからコンピューティングプールを作成し、 snow spcs compute-pool deploy
コマンドを実行します。
snowflake.yml
プロジェクト定義ファイルのサンプルは次のとおりです。
definition_version: 2
entities:
my_compute_pool:
type: compute-pool
identifier:
name: my_compute_pool
min_nodes: 1
max_nodes: 2
instance_family: CPU_X64_XS
auto_resume: true
initially_suspended: true
auto_suspend_seconds: 60
comment: "My compute pool"
tags:
- name: my_tag
value: tag_value
以下のテーブルは、コンピューティングプールプロジェクト定義のプロパティを表しています。
プロパティ |
定義 |
---|---|
タイプ required, string |
|
識別子 optional, string |
エンティティのSnowflake識別子。この値には次のような形式があります。
|
インスタンス・ファミリー required, string |
インスタンスファミリーの名前。使用可能なインスタンスファミリーのリストについては、 CREATE COMPUTE POOL INSTANCE_FAMILY パラメーターを参照してください。 |
min_nodes optional, string |
コンピューティングプールの最小ノード数。この値は0より大きい必要があります。 デフォルト: |
max_nodes optional, int |
コンピューティングプールの最大ノード数。 |
auto_resume optional, boolean |
サービスやジョブが投入されたときに、コンピューティングプールを自動的に再開するかどうか。 デフォルト: |
initially_suspended optional, boolean |
コンピューティングプールを最初に一時停止状態で作成するかどうか。 デフォルト: |
auto_suspend_seconds optional, int |
Snowflakeがコンピューティングプールを自動的に一時停止するまでの非アクティブの秒数。 デフォルト: |
コメント optional, string |
コンピューティングプールに関連付けるコメント。 |
tags optional, Tag sequence |
コンピューティングプールのタグ名と値。詳細については、 オブジェクトのタグクォータ をご参照ください |
コンピューティングプールを作成してステージにデプロイするには、次の手順を実行します。
現在のディレクトリをプロジェクト定義ファイルのあるディレクトリに変更します。
以下のような
snow spcs compute-pool deploy
コマンドを実行します。snow spcs compute-pool deploy
+---------------------------------------------------------------------+ | key | value | |--------+------------------------------------------------------------| | status | Compute pool MY_COMPUTE_POOL successfully created. | +---------------------------------------------------------------------+
コンピューティングプールの一時停止と再開¶
注釈
現在のロールには、コンピューティングプールを一時停止または再開するための OPERATE 権限が必要です。
コンピューティングプールを一時停止するには、次のようなコマンドを入力します。
snow spcs compute-pool suspend tutorial_compute_pool
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
一時停止されたコンピューティングプールを再開するには、次のようなコマンドを入力します。
snow spcs compute-pool resume tutorial_compute_pool
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
コンピューティングプールのプロパティやパラメーターのセットと解除¶
注釈
プロパティを設定するには、現在のロールにコンピューティングプールに対する MODIFY 権限が必要です。
プロパティまたはパラメーターを設定するには、次のようなコマンドを入力します。
snow spcs compute-pool set tutorial_compute_pool --min-nodes 2 --max-nodes 4
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
プロパティまたはパラメーターをデフォルト値にリセットするには、次のようなコマンドを入力します。
snow spcs compute-pool unset tutorial_compute_pool --auto-resume
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
コンピューティングプール内のすべてのサービスを停止する¶
コンピューティングプールを停止すると、コンピューティングプールで実行されているすべてのサービスが削除されますが、コンピューティングプール自体は停止しません。
コンピューティングプールを停止するには、次のような spcs compute-pool stop-all コマンドを入力します。
snow spcs compute-pool stop-all "pool_1"