SHOW COMPUTE POOLS

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

另请参阅：

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

计算池中处于空闲状态的节点数（没有任何服务或作业在运行）。

created_on

计算池的创建日期和时间。

resumed_on

计算池恢复挂起的日期和时间。

updated_on

使用 ALTER COMPUTE POOL 更新计算池的日期和时间。

owner

拥有计算池的角色。

comment

指定计算池的注释。

使用说明

  • 以前缀 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 | created_on                    | resumed_on                    | updated_on                    | owner        | comment |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------|
| TUTORIAL_COMPUTE_POOL | ACTIVE |         1 |         1 | CPU_X64_XS      |            3 |        1 |                0 | false       |            1 |          0 | 2023-04-09 11:20:36.824 -0700 | 2023-04-09 11:20:36.818 -0700 | 2023-05-26 19:59:31.228 -0700 | ACCOUNTADMIN | NULL    |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+------------------+-------------+--------------+------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+
语言: 中文