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>  ]
  [ COMMENT = '<string_literal>' ]

必填参数¶

name

指定计算池的标识符（即名称）的字符串；对于您的账户，该字符串必须是唯一的。不支持带引号的特殊字符名称或区分大小写的名称。

MIN_NODES = num

指定计算池的最小节点数。此值必须大于 0。有关更多信息，请参阅 创建计算池。

MAX_NODES = num

指定计算池的最大节点数。

INSTANCE_FAMILY = instance_family_name

标识要为计算池中的节点预置的机器类型。 机器类型决定了计算池中的计算资源量，因此也决定了计算池运行时消耗的 Credit。

下表中的 INSTANCE_FAMILY 值可分为 3 个类别：

• 通用实例类型： 提供 CPU、内存和磁盘平衡。这不包括 GPU。这些实例族名称以“CPU”开头。

• 高内存实例类型：与通用实例类型类似，但这些实例类型可提供更多内存。这些实例族名称以“HighMemory”开头。

• 附有 GPU 的实例类型：这些实例族名称以“GPU”开头。

INSTANCE_FAMILY、Snowflake 服务消耗表 映射	vCPU	内存 (GiB)	存储 (GiB)	带宽限制 (Gbps)	GPU	每个 GPU 的 GPU 内存 (GiB)	节点限制	描述
CPU_X64_XS、. CPU | XS	1	6	100	高达 12.5	不适用	不适用	50	可用于 Snowpark 容器的最小实例。非常适合节省成本和入门。
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、. 高内存 CPU | S	6	58	100	AWS：高达 12.5，Azure：8	不适用	不适用	50	适用于内存密集型应用程序。
HIGHMEM_X64_M、. 高内存 CPU | M :newline:`.`（仅限 AWS）	28	240	100	12.5	不适用	不适用	50	适用于在单台机器上托管多个内存密集型应用程序。
HIGHMEM_X64_M、. 高内存 CPU | M :newline:`.`（仅限 Azure）	28	244	100	16	不适用	不适用	50	适用于在单台机器上托管多个内存密集型应用程序。
HIGHMEM_X64_L、. 高内存 CPU | L :newline:`.`（仅限 AWS）	124	984	100	50	不适用	不适用	20	可用于处理大量内存中数据的最大 AWS 高内存机器。
HIGHMEM_X64_SL、. 高内存 CPU | L :newline:`.`（仅限 Azure）	92	654	100	32	不适用	不适用	20	可用于处理大量内存中数据的最大 Azure 高内存机器。
GPU_NV_S、. GPU | S :newline:`.`（仅限 AWS，巴黎和大阪地区除外）	6	27	100	高达 10	1 个 NVIDIA A10G	24	10	我们为开始使用 Snowpark 容器提供的最小 NVIDIA GPU 大小。
GPU_NV_M、. GPU | M :newline:`.`（仅限 AWS，巴黎和大阪地区除外）	44	178	100	40	4 个 NVIDIA A10G	24	10	针对密集型 GPU 使用场景进行了优化，如 Computer Vision 或 LLMs/VLMs。
GPU_NV_L、. GPU | L :newline:`.`（仅限 AWS，AWS US 西部和 US 东部地区可按需提供；其他地区可能能够在申请后有限提供）	92	1112	100	400	8 个 NVIDIA A100	40	按请求	LLMs 和群集等特殊和高级 GPU 案例的最大 GPU 实例。
GPU_NV_XS、. GPU | XS :newline:`.`（仅限 Azure，瑞士北部和 UAE 北部地区除外）	3	26	100	8	1 个 NVIDIA T4	16	10	我们为 Snowpark 容器提供的 Azure NVIDIA GPU 最小规格，助您快速入门。
GPU_NV_SM、. GPU | SM :newline:`.`（仅限 Azure，US 中部地区除外）	32	424	100	40	1 个 NVIDIA A10	24	10	为 Snowpark 容器提供的 Azure NVIDIA GPU 最小规格，助您快速入门。
GPU_NV_2M、. GPU | 2M :newline:`.`（仅限 Azure，中部 US 地区除外）	68	858	100	80	2 个 NVIDIA A10	24	5	针对密集型 GPU 使用场景进行了优化，如 Computer Vision 或 LLMs/VLMs。
GPU_NV_3M、. GPU | 3M :newline:`.`（仅限 Azure，北欧和 UAE 北部地区除外）	44	424	100	40	2 个 NVIDIA A100	80	按请求	针对内存密集型 GPU 使用场景进行了优化，如 Computer Vision 或 LLMs/VLMs。
GPU_NV_SL、. GPU | SL . （仅限 Azure，北欧和 UAE 北部地区除外）	92	858	100	80	4 个 NVIDIA A100	80	按请求	LLMs 和群集等特殊和高级 GPU 案例的最大 GPU 实例。

请注意以下事项：

• 第一列标题中的“消耗表”链接提供有关特定 INSTANCE_FAMILY 的 Credit 使用率的信息。

• 节点限制列指示 Snowflake 账户可以为特定 INSTANCE_FAMILY 类型预置的最大节点数。请联系客户代表以提高限制。

可选参数¶

FOR APPLICATION app_name

指定 Snowflake Native App 名称。如果已指定，计算池只能由本地应用程序使用。SHOW COMPUTE POOLS 命令的输出包括 is_exclusive 和 application 列（用于指示计算池是否专门为应用程序创建），并提供应用程序名称。

AUTO_RESUME = { TRUE | FALSE }

指定在向计算池提交服务或作业时是否会自动恢复计算池。

• 如果 AUTO_RESUME 是 FALSE时，您需要显式恢复计算池（使用 ALTER COMPUTE POOL RESUME），然后才能在计算池上启动服务或作业。

• 如果 AUTO_RESUME 是 TRUE，在暂停的计算池上启动新服务时，Snowflake 将启动计算池。同样，当您通过调用服务函数或访问入口来使用服务时（请参阅 使用服务），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 秒

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;