SHOW COMPUTE POOLS

列出您具有访问权限的账户中的 计算池。

小技巧

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

另请参阅：

CREATE COMPUTE POOL、ALTER COMPUTE POOL、DESCRIBE COMPUTE POOL、DROP COMPUTE POOL

语法

SHOW COMPUTE POOLS [ LIKE '<pattern>' ]
                   [ STARTS WITH '<name_string>' ]
                   [ LIMIT <ROWS> [ FROM '<name-string>' ] ]
Copy

参数

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回 相同的 结果：

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且 区分大小写。

例如，以下字符串会返回 不同的 结果：

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows [ FROM 'name_string' ]

（可选）限制返回的最大行数，同时还对结果启用“分页”功能。返回的实际行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

可选的 FROM 'name_string' 分子句实际上会充当结果的“游标”。这样就可以提取对象名称与指定字符串匹配的第一行之后的指定行数：

  • 该字符串必须放在单引号内并且 区分大小写。

  • 该字符串不必包含完整的对象名称；支持部分名称。

默认：无值（不对输出应用限制）

备注

对于支持 FROM 'name_string' 和 STARTS WITH 'name_string' 的 SHOW 子句，您可以将这两个子句组合在同一语句中。但是，两个条件都必须满足，否则它们相互抵消，不返回任何结果。

此外，对象按名称的字典顺序返回，因此 FROM 'name_string' 仅返回字典值高于 STARTS WITH 'name_string' 所返回行的行。

例如：

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' 不会返回任何结果。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' 不会返回任何结果。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' 将返回结果（如果有任何行与输入字符串匹配）。

访问控制要求

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

权限

对象

备注

以下任何一项权限：OWNERSHIP、USAGE、MONITOR 或者 OPERATE

计算池

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

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

输出

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

列

描述

name

计算池名称。

state

计算池的状态。有关更多信息，请参阅 计算池生命周期。

min_nodes

计算池的最小节点数。

max_nodes

计算池的最大节点数。

instance_family

计算池中节点的计算类型。

num_services

计算池上运行的服务数。

num_jobs

计算池上运行的作业数。

auto_suspend_secs

Snowflake 自动暂停计算池之前处于非活动状态的秒数。

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 使用量的 预算 名称。

使用说明

  • 以前缀 is_ 开头的列返回 Y (yes) 或 N (no)。

  • 该命令不需要正在运行的仓库即可执行。

  • 该命令 最多 返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定；即使应用了筛选器，也不会返回任何超过 1 万条限制的记录。

    要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中查询相应的视图（如果存在）。

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

示例

以下命令列出了您在当前账户中具有访问权限的计算池：

SHOW COMPUTE POOLS;
Copy

以下命令列出了一个计算池：

SHOW COMPUTE POOLS LIMIT 1;
Copy

以下命令列出了名称包含“tu”的计算池：

SHOW COMPUTE POOLS LIKE '%tu%';
Copy

以下命令列出了两个名称包含“my_pool”的计算池：

SHOW COMPUTE POOLS LIKE '%my_pool%' LIMIT 2;
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 |
|-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------|
| 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:47:08.150 -0700 | TEST_ROLE    | NULL    | false        | NULL        | NULL   |
| TUTORIAL_COMPUTE_POOL_2 | SUSPENDED |         1 |         1 | CPU_X64_XS      |            0 |        0 |              3600 | true        |            0 |          0 |            0 | 2024-01-15 21:23:09.744 -0800 | 2024-04-06 15:24:50.541 -0700 | 2024-08-18 13:46:08.110 -0700 | ACCOUNTADMIN | NULL    | false        | NULL        | NULL   |
+-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------+
语言: 中文