DESCRIBE COMPUTE POOL¶

描述计算池的属性。

DESCRIBE 可以缩写为 DESC。

小技巧

您还可以使用 Snowflake REST APIs 来执行此操作。有关信息，请参阅提取计算池（REST 端点参考）。

另请参阅：: CREATE COMPUTE POOL、ALTER COMPUTE POOL、DROP COMPUTE POOL、SHOW COMPUTE POOLS

语法¶

DESC[RIBE] COMPUTE POOL <name>

Copy

参数¶

name

指定要描述的计算池的标识符。

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

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

输出¶

命令输出在以下列中提供计算池属性和元数据：

列	描述
`name`	计算池名称。
`state`	计算池的当前状态。
`min_nodes`	计算池的最小节点数。
`max_nodes`	计算池的最大节点数。
`instance_family`	指定计算池中节点的机器类型。
`num_services`	计算池上运行的服务和作业数。
`num_jobs`	计算池上运行的作业数。
`auto_suspend_secs`	指定计算池自动挂起之前处于非活动状态的秒数。
`auto_resume`	指定是否在 Snowflake 尝试启动服务或作业时自动恢复计算池。
`active_nodes`	计算池中处于活动状态的节点数（一个或多个服务或作业在运行）。
`idle_nodes`	计算池中处于空闲状态的节点数（没有任何服务或作业在运行）。
`target_nodes`	表示 Snowflake 为您的计算池定位的节点数。如果 `active_nodes` 与 `target_nodes` 不相等，则 Snowflake 将自动扩缩集群以添加或移除节点。以下示例说明了如何解释 `target_nodes` 列中的值。示例 1：假设在 CREATE COMPUTE POOL 命令中，您指定 MIN_NODES=1 且 MAX_NODES=3。当 Snowflake 预置节点时，`active_nodes` 和 `idle_nodes` 列中的初始值为 0，`target_nodes` 列中的初始值为 1。（`target_nodes` 列中的值与您为 MIN_NODES 参数指定的值相同。）这表明 Snowflake 正在预置的计算池中应该有一个节点。在 Snowflake 预置一个节点后，`idle_nodes` 列中的值为 1（假设没有正在运行的服务）。`target_nodes` 列中的值仍为 1，表示计算池中应该有一个节点。示例 2：由于自动扩缩或最小节点数发生变化（通过 ALTER COMPUTE POOL ...SET MIN_NODES），Snowflake 可能会尝试向现有计算池添加节点。当 Snowflake 预置节点时，`state` 列中的值为 `resizing`。要确定 Snowflake 添加了多少个节点，请检查 `target_nodes` 列中的值。例如，假设 `active_nodes` 列中的值为 1，`idle_nodes` 列中的值为 0，您通过将 MIN_NODES 属性从 1 更新为 2 来调整计算池的大小。在这种情况下，`target_nodes` 列中的值为 2（计算池中应有的节点数）。由此可以推断出 Snowflake 预置了一个额外的节点。
`created_on`	计算池的创建日期和时间。
`resumed_on`	暂停的计算池恢复的日期和时间。
`updated_on`	使用 ALTER COMPUTE POOL 更新计算池的日期和时间。
`owner`	拥有计算池的角色。
`comment`	指定计算池的注释。
`is_exclusive`	如果计算池是专门为 Snowflake Native App 而创建，则为 `true`；否则为 `false`。
`application`	如果计算池是专门为应用程序创建的，则应填写Snowflake Native App 的名称。否则，显示 NULL。
`budget`	监控计算池 Credit 使用量的预算名称。
`error_code`	错误代码（如果有）与 STATUS_MESSAGE 相关。否则，此字段为空。例如，当您调整计算池的大小时：如果 Snowflake 遇到容量错误（无法预置新节点），Snowflake 将返回错误代码 392507。请注意，容量错误表示您为计算池节点请求的实例类型目前不可用于云提供商。您可以等待容量变为可用，也可以创建一个包含不同实例系列的新计算池。如果您有待处理的服务（包括作业服务）并且 Snowflake 无法扩展您的计算池，Snowflake 将返回错误代码 392508。
`status_message`	关于计算池状态的可选消息。例如：创建计算池后，如果您运行 DESC COMPUTE POOL 命令，输出可能包含状态消息：“Compute pool is starting for last 1 minute”。如果 Snowflake 在预置节点时遇到容量错误，输出可能会包含以下状态消息：“Compute pool is starting for the last 3 minutes.We have observed CAPACITY_ERROR.” 如果您有待处理的服务（包括作业服务）并且 Snowflake 无法扩展您的计算池，则输出可能会包含状态消息：“Compute Pool has reached the maximum node limit.Consider increasing max_nodes using the ALTER COMPUTE POOL command.”

访问控制要求¶

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

权限	对象	备注
MONITOR	计算池

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

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

使用说明¶

若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。

示例¶

以下示例描述了名为 tutorial_compute_pool 的计算池：

DESCRIBE COMPUTE POOL tutorial_compute_pool;

Copy

示例输出：

+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+
| name                  | state  | min_nodes | max_nodes | instance_family | num_services | num_jobs | auto_suspend_secs | auto_resume | active_nodes | idle_nodes | target_nodes | created_on                    | resumed_on                    | updated_on                    | owner     | comment | is_exclusive | application | budget | error_code | status_message |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------|
| TUTORIAL_COMPUTE_POOL | ACTIVE |         1 |         1 | CPU_X64_XS      |            3 |        0 |              3600 | true        |            1 |          0 |            1 | 2024-02-24 20:41:31.978 -0800 | 2024-08-08 11:27:01.775 -0700 | 2024-08-18 13:29:08.124 -0700 | TEST_ROLE | NULL    | false        | NULL        | NULL   |            |                |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+