CREATE COMPUTE POOL¶

構文¶

CREATE COMPUTE POOL [ IF NOT EXISTS ] <name>
  MIN_NODES = <num>
  MAX_NODES = <num>
  INSTANCE_FAMILY = <instance_family_name>
  [ AUTO_RESUME = { TRUE | FALSE } ]
  [ INITIALLY_SUSPENDED = { TRUE | FALSE } ]
  [ AUTO_SUSPEND_SECS = <num>  ]
  [ COMMENT = '<string_literal>' ]

必須パラメーター¶

name

コンピュートプールの識別子（つまり名前）を指定する文字列。アカウントに対して一意である必要があります。

また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません（例: "My object"）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

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

MIN_NODES = num

コンピュートプールの最小ノード数を指定します。この値は0より大きい必要があります。詳細については、 コンピューティングプールの作成 をご参照ください。

MAX_NODES = num

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

INSTANCE_FAMILY = instance_family_name

コンピュートプールのノードにプロビジョニングするマシンのタイプを指定します。マシンタイプは、コンピュートプールのコンピュートリソースの量を決定するため、コンピュートプールの実行中に消費されるクレジットの数を決定します。

次の表の INSTANCE_FAMILY の値は3のカテゴリに分類できます。

• ジェネリックインスタンスタイプ: CPU、メモリ、ディスクのバランスを提供します。これには GPU は含まれません。これらのインスタンスファミリー名は「CPU」で始まります。

• 高メモリのインスタンスタイプ: ジェネリックインスタンスタイプに似ていますが、より多くのメモリを提供します。これらのインスタンスファミリー名は「HighMemory」で始まります。

• GPU がアタッチされたインスタンスタイプ: これらのインスタンスファミリー名は「GPU」で始まります。

消費テーブル マッピング	INSTANCE_FAMILY	vCPU	メモリ（GiB）	ストレージ（GiB）	GPU	GPU あたりの GPU メモリ（GiB）	説明
CPU | XS	CPU_X64_XS	2	8	250	なし	なし	Snowpark Containersで利用可能な最小インスタンス。コストの節約と使い始めに最適です。
CPU | S	CPU_X64_S	4	16	250	なし	なし	コストを節約しながら複数のサービス/ジョブをホストするのに最適です。
CPU | M	CPU_X64_M	8	32	250	なし	なし	フルスタックのアプリケーションや複数のサービスがある場合に最適です。
CPU | L	CPU_X64_L	32	128	250	なし	なし	非常に多くの数の CPUs、メモリ、ストレージを必要とするアプリケーションの場合。
ハイメモリ CPU | S	HIGHMEM_X64_S	8	64	250	なし	なし	メモリ負荷の高いアプリケーションの場合。
ハイメモリ CPU | M	HIGHMEM_X64_M	32	256	250	なし	なし	1台のマシンで複数のメモリ負荷の高いアプリケーションをホストする場合。
ハイメモリ CPU | L	HIGHMEM_X64_L	128	1024	250	なし	なし	大規模なインメモリデータを処理するために利用可能な最大のハイメモリマシン。
GPU | S	GPU_NV_S	8	32	250	1 NVIDIA A10G	24	Snowpark Containersを始めるのに利用できる最小の NVIDIA GPU サイズ。
GPU | M	GPU_NV_M	48	192	250	4 NVIDIA A10G	24	コンピュータービジョンや LLMs/VLMs などの負荷の高い GPU 使用シナリオに最適化。
GPU | L	GPU_NV_L	192	2048	250	8 NVIDIA A100	40	LLMs やクラスタリングなど、特殊で高度な GPU ケースのための最大の GPU インスタンス。

最初の列見出しの消費テーブルリンクは、特定の INSTANCE_FAMILY のクレジット消費率に関する情報を提供します。

オプションのパラメーター¶

AUTO_RESUME = { TRUE | FALSE }

サービスやジョブの送信時にコンピュートプールを自動的に再開するかどうかを指定します。

• AUTO_RESUME が FALSE の場合、コンピュートプール上でサービスやジョブを開始する前に、明示的に（ALTER COMPUTE POOL RESUME を使用して）コンピュートプールを再開する必要があります。

• AUTO_RESUME が TRUE の場合、一時停止されたコンピュートプールで新しいサービスを開始すると、Snowflakeはコンピュートプールを開始します。同様に、サービス関数を呼び出すか、ingress（サービスの使用 を参照）にアクセスすることでサービスを使用すると、Snowflakeは以前に一時停止していたコンピュートプールを起動し、サービスを再開します。

デフォルト: TRUE

INITIALLY_SUSPENDED = { TRUE | FALSE }

コンピュートプールが最初に一時停止状態で作成されるかどうかを指定します。INITIALLY_SUSPENDED を TRUE に設定してコンピュートプールを作成すると、Snowflakeはコンピュートプールの作成時に要求されたノードをプロビジョニングしません。一時停止されたコンピュートプールは、 ALTER COMPUTE POOL ... RESUME を使って起動できます。

デフォルト: FALSE

AUTO_SUSPEND_SECS = num

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

デフォルト: 3600秒

COMMENT = 'string_literal'

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

デフォルト: 値なし

アクセス制御の要件¶

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

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

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

使用上の注意¶

• メタデータについて:

  注意

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

例¶

1ノードのコンピュートプールを作成します。このコマンド例では、最低限必要なパラメーターを指定しています。

CREATE COMPUTE POOL tutorial_compute_pool
  MIN_NODES = 1
  MAX_NODES = 1
  INSTANCE_FAMILY = CPU_X64_XS;

次のコマンドは、オプションの AUTO_RESUME パラメーターを指定します。

CREATE COMPUTE POOL tutorial_compute_pool
  MIN_NODES = 1
  MAX_NODES = 1
  INSTANCE_FAMILY = CPU_X64_XS
  AUTO_RESUME = FALSE;