ALTER COMPUTE POOL¶

修改现有计算池的属性。

小技巧

除了 SQL，您还可以使用其他接口，如 Snowflake REST APIs、Snowflake Python APIs 和 Snowflake CLI。请参阅备用接口。

另请参阅：: 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;

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

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

Copy

参数¶

name

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

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

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

{ SUSPEND | RESUME }

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

STOP ALL

删除所有服务并取消在计算池中执行的作业。然后，Snowflake 会从计算池中移除所有容器。

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。

有关在语句中指定标签的信息，请参阅对象和列的标签配额。

COMMENT = 'string_literal': 指定计算池的注释。

UNSET ...

指定要为计算池取消设置的一个（或多个）属性和/或参数，这会将它们重置为默认值（请参阅 CREATE COMPUTE POOL）：

AUTO_SUSPEND_SECS
AUTO_RESUME
COMMENT

访问控制要求¶

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

权限	对象	备注
OPERATE	计算池	要暂停或恢复计算池，角色需要这些权限。
MODIFY	计算池	要更改计算池和设置属性，角色需要此权限。

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

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

使用说明¶

关于元数据：

注意

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

示例¶

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

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE

Copy

备用接口¶

Snowflake REST APIs
Snowflake Python APIs
- compute_pool.ComputePoolResource.create_or_alter 方法
Snowflake CLI
- 不支持