ALTER COMPUTE POOL

修改现有 计算池 的属性。

另请参阅：

CREATE COMPUTE POOL、DESCRIBE COMPUTE POOL、DROP COMPUTE POOL、SHOW COMPUTE POOLS

语法

ALTER COMPUTE POOL [ IF EXISTS ] <name> { SUSPEND | RESUME }

ALTER COMPUTE POOL [ IF EXISTS ] <name> STOP ALL  [ OF TYPE <workload_type> [ , ... ] ]

ALTER COMPUTE POOL [ IF EXISTS ] <name> SET [ MIN_NODES = <num> ]
                                            [ MAX_NODES = <num> ]
                                            [ AUTO_RESUME = { TRUE | FALSE } ]
                                            [ AUTO_SUSPEND_SECS = <num> ]
                                            [ PLACEMENT_GROUP = '<placement_group_name>' ]
                                            [ INSTANCE_FAMILY = <instance_family_name> ]
                                            [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ]
                                            [ COMMENT = '<string_literal>' ]

ALTER COMPUTE POOL [ IF EXISTS ] <name> UNSET { AUTO_SUSPEND_SECS |
                                                AUTO_RESUME       |
                                                PLACEMENT_GROUP   |
                                                COMMENT
                                              }
                                              [ , ... ]
Copy

参数

name

指定要更改的计算池的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

{ SUSPEND | RESUME }

暂停计算池或恢复以前暂停的计算池。暂停计算池时，Snowflake 会暂停该计算池中的所有服务，但作业会继续运行，直到达到最终状态（DONE 或 FAILED），之后将释放计算池节点。

STOP ALL  OF TYPE workload_type [ , ... ]

删除所有服务并取消在计算池中执行的作业。然后，Snowflake 会从计算池中移除所有容器。如果指定了可选的 OF TYPE 子句，Snowflake 仅停止指定工作负载类型的服务。有关可用工作负载类型的列表，请参阅 ALLOWED_SPCS_WORKLOAD_TYPES。

筛选器不区分大小写。

SET ...

为计算池设置一个或多个指定的属性或参数：

MIN_NODES = num

指定计算池节点的最小数量。

MAX_NODES = num

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

AUTO_RESUME = { TRUE | FALSE }

指定在向计算池提交服务或作业时是否会自动恢复计算池。如果 AUTO_RESUME 是 FALSE时，您需要显式恢复计算池（使用 ALTER COMPUTE POOL <name> RESUME），然后才能在计算池上启动服务或作业。

AUTO_SUSPEND_SECS = num

您希望 Snowflake 自动暂停计算池的不活动秒数。不活动意味着计算池中的任何节点上都没有正在运行的服务或作业。

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

指定 标签 名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅 Tag quotas。

PLACEMENT_GROUP = placement_group_name

标识 计算池的放置群组。使用 SHOW COMPUTE POOLS 和 DESCRIBE COMPUTE POOL 命令可查看计算池在放置组中的分配情况。

INSTANCE_FAMILY = instance_family_name

标识要为计算池中的节点预置的机器类型。机器类型决定了计算池中的计算资源量，因此也决定了计算池运行时消耗的 Credit。有关可用实例系列名称的列表，请参阅 实例系列。

仅当计算池处于完全暂停状态时，才能更改 INSTANCE_FAMILY。恢复后，Snowflake 会使用新的实例类型来预置计算池。

COMMENT = 'string_literal'

指定计算池的注释。

UNSET ...

Specifies one or more properties and/or parameters to unset for the compute pool, which resets them to the defaults. For more information, see CREATE COMPUTE POOL:

  • AUTO_SUSPEND_SECS

  • AUTO_RESUME

  • PLACEMENT_GROUP：选择使用 时默认使用的角色和仓库。仅当计算池完全暂停时，才能取消设置放置群组。

  • COMMENT

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

OPERATE

计算池

要暂停或恢复计算池，角色需要这些权限。

MODIFY

计算池

要更改计算池和设置属性，角色需要此权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 关于元数据：

    注意

    客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

示例

以下示例将设置计算池的 MAX_NODES 和 AUTO_RESUME 属性：

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE
Copy

以下示例将“CPU_X64_S”设置为计算池的 INSTANCE_FAMILTY。由于必须停止计算池才能更改实例系列，因此首先暂停计算池：

ALTER COMPUTE POOL tutorial_compute_pool SUSPEND;
ALTER COMPUTE POOL tutorial_compute_pool SET
  INSTANCE_FAMILY = CPU_X64_S;
ALTER COMPUTE POOL tutorial_compute_pool RESUME;
Copy
语言: 中文