ALTER COMPUTE POOL

修改现有 计算池 的属性。

小技巧

您还可以使用 Snowflake REST APIs 来执行此操作。有关详细信息，请参阅以下 REST 端点：

另请参阅：

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>' ]

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 自动暂停计算池的不活动秒数。不活动意味着计算池中的任何节点上都没有正在运行的服务或作业。

COMMENT = 'string_literal'

指定计算池的注释。

UNSET ...

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

  • AUTO_SUSPEND_SECS

  • AUTO_RESUME

  • COMMENT

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

OPERATE

计算池

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

MODIFY

计算池

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

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

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

使用说明

  • 关于元数据：

    注意

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

示例

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

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE
Copy
语言: 中文