コンピュートプールの管理

コンピューティングプールは、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"
Copy

インスタンスファミリの詳細については、 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
Copy

以下のテーブルは、コンピューティングプールプロジェクト定義のプロパティを表しています。

コンピューティングプールプロジェクト定義プロパティ

プロパティ

定義

タイプ

required, string

compute-pool でなければなりません。

識別子

optional, string

エンティティのSnowflake識別子。この値には次のような形式があります。

  • 文字列識別子テキスト

    identifier: my-compute-pool
    
    Copy

    引用符で囲まれていない識別子と引用符で囲まれた識別子の両方がサポートされています。引用符で囲まれた識別子を使用するには、 YAML の値に引用符で囲みます(例えば、 "My Compute Pool")。

  • オブジェクト

    identifier:
      name: my-compute-pool
      schema: my-schema # optional
      database: my-db # optional
    
    Copy

    注釈

    schema または database を指定し、 name プロパティに完全修飾名を使用するとエラーが発生します(mydb.schema1.my-app など)。

インスタンス・ファミリー

required, string

インスタンスファミリーの名前。使用可能なインスタンスファミリーのリストについては、 CREATE COMPUTE POOL INSTANCE_FAMILY パラメーターを参照してください。

min_nodes

optional, string

コンピューティングプールの最小ノード数。この値は0より大きい必要があります。

デフォルト: 1

max_nodes

optional, int

コンピューティングプールの最大ノード数。

auto_resume

optional, boolean

サービスやジョブが投入されたときに、コンピューティングプールを自動的に再開するかどうか。

デフォルト: True

initially_suspended

optional, boolean

コンピューティングプールを最初に一時停止状態で作成するかどうか。true の場合、Snowflakeはコンピューティングプール作成時にリクエストされたノードをプロビジョニングしません。

デフォルト: False

auto_suspend_seconds

optional, int

Snowflakeがコンピューティングプールを自動的に一時停止するまでの非アクティブの秒数。

デフォルト: 3600

コメント

optional, string

コンピューティングプールに関連付けるコメント。

tags

optional, Tag sequence

コンピューティングプールのタグ名と値。詳細については、 オブジェクトのタグクォータ をご参照ください

コンピューティングプールを作成してステージにデプロイするには、次の手順を実行します。

  1. 現在のディレクトリをプロジェクト定義ファイルのあるディレクトリに変更します。

  2. 以下のような snow spcs compute-pool deploy コマンドを実行します。

    snow spcs compute-pool deploy
    
    Copy
    +---------------------------------------------------------------------+
    | key    | value                                                      |
    |--------+------------------------------------------------------------|
    | status | Compute pool MY_COMPUTE_POOL successfully created.         |
    +---------------------------------------------------------------------+
    

コンピューティングプールの一時停止と再開

注釈

現在のロールには、コンピューティングプールを一時停止または再開するための OPERATE 権限が必要です。

コンピューティングプールを一時停止するには、次のようなコマンドを入力します。

snow spcs compute-pool suspend tutorial_compute_pool
Copy
+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

一時停止されたコンピューティングプールを再開するには、次のようなコマンドを入力します。

snow spcs compute-pool resume tutorial_compute_pool
Copy
+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

コンピューティングプールのプロパティやパラメーターのセットと解除

注釈

プロパティを設定するには、現在のロールにコンピューティングプールに対する MODIFY 権限が必要です。

プロパティまたはパラメーターを設定するには、次のようなコマンドを入力します。

snow spcs compute-pool set tutorial_compute_pool --min-nodes 2 --max-nodes 4
Copy
+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

プロパティまたはパラメーターをデフォルト値にリセットするには、次のようなコマンドを入力します。

snow spcs compute-pool unset tutorial_compute_pool --auto-resume
Copy
+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

コンピューティングプール内のすべてのサービスを停止する

コンピューティングプールを停止すると、コンピューティングプールで実行されているすべてのサービスが削除されますが、コンピューティングプール自体は停止しません。

コンピューティングプールを停止するには、次のような spcs compute-pool stop-all コマンドを入力します。

snow spcs compute-pool stop-all "pool_1"
Copy