CREATE COMPUTE POOL¶

構文¶

CREATE COMPUTE POOL [ IF NOT EXISTS ] <name>
  [ FOR APPLICATION <app-name> ]
  MIN_NODES = <num>
  MAX_NODES = <num>
  INSTANCE_FAMILY = <instance_family_name>
  [ AUTO_RESUME = { TRUE | FALSE } ]
  [ INITIALLY_SUSPENDED = { TRUE | FALSE } ]
  [ AUTO_SUSPEND_SECS = <num>  ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
  [ COMMENT = '<string_literal>' ]

必須パラメーター¶

name

コンピューティングプールの識別子（つまり名前）を指定する文字列。アカウントに対して一意である必要があります。特殊文字や大文字小文字を区別するための引用符付きの名前はサポートされていません。

MIN_NODES = num

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

MAX_NODES = num

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

INSTANCE_FAMILY = instance_family_name

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

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

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

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

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

INSTANCE_FAMILY, Snowflake Service Consumption Table Mapping	vCPU	メモリ（GiB）	ストレージ（GB）	帯域制限（Gbps）	GPU	GPU あたりの GPU メモリ（GiB）	ノード制限	説明
CPU_X64_XS 、 . CPU | XS	1	6	100	最大12.5	なし	なし	50	Snowpark Containersで利用可能な最小インスタンス。コストの節約と使い始めに最適です。
CPU_X64_S、 . CPU | S	3	13	100	最大12.5	なし	なし	50	コストを節約しながら複数のサービス/ジョブをホストするのに最適です。
CPU_X64_M, . CPU | M	6	28	100	最大12.5	なし	なし	50	フルスタックのアプリケーションや複数のサービスがある場合に最適です。
CPU_X64_L、 . CPU | L	28	116	100	12.5	なし	なし	50	非常に多くの数の CPUs、メモリ、ストレージを必要とするアプリケーションの場合。
HIGHMEM_X64_S, . High-Memory CPU | S	6	58	100	AWS: 最大12.5, Azure: 8	なし	なし	50	メモリ負荷の高いアプリケーションの場合。
HIGHMEM_X64_M、 . ハイメモリ CPU | M . (AWS のみ)	28	240	100	12.5	なし	なし	50	1台のマシンで複数のメモリ負荷の高いアプリケーションをホストする場合。
HIGHMEM_X64_M、 . ハイメモリ CPU | M . (Azureのみ)	28	244	100	16	なし	なし	50	1台のマシンで複数のメモリ負荷の高いアプリケーションをホストする場合。
HIGHMEM_X64_L, . High-Memory CPU | L . (AWS のみ)	124	984	100	50	なし	なし	20	大規模なインメモリデータを処理するために利用可能な最大の AWS ハイメモリマシン。
HIGHMEM_X64_SL、 . ハイメモリ CPU | L . （Azureのみ）	92	654	100	32	なし	なし	20	大規模なインメモリデータを処理するために利用可能な最大のAzureハイメモリマシン。
GPU_NV_S、 . GPU | S . （AWS のみ。パリと大阪リージョンは除く）	6	27	300（NVMe）	最大10	1 NVIDIA A10G	24	10	Snowpark Containersを始めるのに利用できる最小の NVIDIA GPU サイズ。
GPU_NV_M、 . GPU | M . （AWS のみ。パリと大阪リージョンは除く）	44	178	3.4 TB （NVMe）	40	4 NVIDIA A10G	24	10	コンピュータービジョンや LLMs/VLMs などの負荷の高い GPU 使用シナリオに最適化。
GPU_NV_L、 . GPU | L . （AWS のみ。リクエストにより AWS US 西部および US 東部リージョンのみで利用可能。リクエストにより他のリージョンでも可用性が限定される場合あり）	92	1112	6.8 TB （NVMe）	400	8 NVIDIA A100	40	要リクエスト	LLMs やクラスタリングなど、特殊で高度な GPU ケースのための最大の GPU インスタンス。
GPU_NV_XS、 . GPU | XS . （Azureのみ。スイス北部および UAE 北部リージョンは除く）	3	26	100	8	1 NVIDIA T4	16	10	Snowpark Containersを始めるのに利用できる最小のAzure NVIDIA GPU サイズ。
GPU_NV_SM、 . GPU | SM . （Azureのみ。中央 US リージョンは除く）	32	424	100	40	1 NVIDIA A10	24	10	Snowpark Containersを始めるのに利用できる最小のAzure NVIDIA GPU サイズ。
GPU_NV_2M、 . GPU | 2M . （Azureのみ。中央 US リージョンは除く）	68	858	100	80	2 NVIDIA A10	24	5	コンピュータービジョンや LLMs/VLMs などの負荷の高い GPU 使用シナリオに最適化。
GPU_NV_3M、 . GPU | 3M . （Azureのみ。北ヨーロッパおよび UAE 北部リージョンは除く）	44	424	100	40	2 NVIDIA A100	80	要リクエスト	コンピュータービジョンや LLMs/VLMs などのメモリ負荷の高い GPU 使用シナリオに最適化。
GPU_NV_SL、 . GPU | SL . （Azureのみ。北ヨーロッパおよび UAE 北部リージョンは除く）	92	858	100	80	4 NVIDIA A100	80	要リクエスト	LLMs やクラスタリングなど、特殊で高度な GPU ケースのための最大の GPU インスタンス。

次の点に注意してください。

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

• ノード制限列は、Snowflakeアカウントが特定の INSTANCE_FAMILY 型に対してプロビジョニングできるノードの最大数を示します。限度の拡大については、担当者にお問い合わせください。

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

FOR APPLICATION app_name

Snowflake Native App名を指定します。指定された場合、コンピューティングプールはNative Appによってのみ使用されます。 SHOW COMPUTE POOLS コマンドの出力には、コンピューティングプールがアプリ専用に作成されたかどうかを示す is_exclusive と application の列があり、アプリ名が表示されます。

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がコンピューティングプールを自動的に中断させるまでの非アクティブの秒数。非アクティブなコンピューティングプールとは、プール内のどのノード上でもサービスやジョブが現在アクティブではないプールのことです。 auto_suspend_secs が0に設定されている場合、Snowflakeはコンピューティングプールを自動的に中断しません。

デフォルト: 3600秒

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

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

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

ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。

COMMENT = 'string_literal'

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

デフォルト: 値なし

アクセス制御の要件¶

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

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

セキュリティ保護可能なオブジェクト に対して 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;

代替インターフェイス¶

• Snowflake REST APIs

  • コンピューティングプールを作成（または既存のものを変更）する エンドポイント

• Snowflake Python APIs

  • compute_pool.ComputePoolCollection.create メソッド

• Snowflake CLI

  • snow object create コマンド