DESCRIBE COMPUTE POOL

描述 计算池 的属性。

DESCRIBE 可以缩写为 DESC。

小技巧

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

另请参阅：

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.”

访问控制要求

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

权限

对象

备注

MONITOR

计算池

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

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

使用说明

  • To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

    The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.

示例

以下示例描述了名为 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   |            |                |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+

备用接口

语言: 中文