SHOW WAREHOUSES¶
列出您账户中您拥有访问权限的所有仓库。
语法¶
SHOW WAREHOUSES
[ LIKE '<pattern>' ]
[ WITH PRIVILEGES <objectPrivilege> [ , <objectPrivilege> [ , ... ] ] ]
参数¶
LIKE 'pattern'（可选）按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配，并支持 SQL 通配符（
%和_）。例如，以下模式返回 相同的 结果：
... LIKE '%testing%' ...... LIKE '%TESTING%' .... 默认：无值（不对输出应用筛选）。
WITH PRIVILEGES object_privilege [ , object_privilege [ , ... ] ]可选地将行限制为以下对象：其当前用户的 活动角色 已被授予对该对象的列表中的所有指定权限。
如果权限列表中包含 CREATE <object> 权限，则该命令将排除已授予次要角色权限的对象。这是因为只有主要角色有权创建对象。有关更多信息，请参阅 具有主要角色和次要角色的执行模型。
使用说明¶
以前缀
is_开头的列返回Y(yes) 或N(no)。该命令不需要正在运行的仓库即可执行。
该命令 最多 返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定；即使应用了筛选器，也不会返回任何超过 1 万条限制的记录。
要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中查询相应的视图（如果存在）。
若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。
输出¶
输出中的列提供了以下信息。对于启用了 Query Acceleration Service 功能的账户，输出还可提供更多信息。
列
描述
name仓库的名称。
state仓库是否处于以下状态：
活动/正在运行 (
STARTED)、非活动 (SUSPENDED) 或正在调整大小 (RESIZING)。
type仓库类型。当前仅支持 STANDARD 和 SNOWPARK-OPTIMIZED 两种类型。
size仓库的大小（X-小、小、中、大、X-大等）
min_cluster_count（多聚类）仓库的最小聚类数量（对于单聚类仓库始终为 1）。
max_cluster_count（多聚类）仓库的最大聚类数量（对于单聚类仓库始终为 1）。
started_clusters当前已启动的聚类数量。
running仓库正在执行的 SQL 语句数量。
queued仓库已排队的 SQL 语句数量。
is_default仓库是否为当前用户的默认仓库。
is_current会话是否正在使用该仓库。
在一个会话中，每次只能使用一个仓库。要指定或更改会话的仓库，请使用 USE WAREHOUSE 命令。
auto_suspend处于非活动状态的时间（以秒为单位），在此时间之后，正在运行的仓库将自动暂停运行并停止使用 Credit。
null值表示仓库永不自动暂停。
auto_resume当向仓库提交查询时，暂停的仓库是否会自动恢复。
available已预置且可用的仓库计算资源的百分比。
provisioning正在预置的仓库计算资源的百分比。
quiescing正在执行 SQL 语句，但查询完成后就会关闭的仓库计算资源的百分比。
other处于
available、provisioning或quiescing以外状态的仓库计算资源的百分比。
created_on仓库创建的日期和时间。
resumed_on仓库上次启动或重新启动的日期和时间。
updated_on仓库上次更新的日期和时间，“更新”包括更改仓库的任意属性或更改仓库的状态（
STARTED、SUSPENDED、RESIZING）。
owner拥有仓库的角色。
comment对仓库进行的评论。
enable_query_acceleration仓库是否启用了 Query Acceleration Service。
query_acceleration_max_scale_factorQuery Acceleration Service 的 最大缩放因子。
resource_monitor显式分配给仓库的 资源监视器 的 ID；控制仓库每月的 Credit 使用情况。
actives、pendings、failed、suspended、uuid这五列仅供内部使用，未来的版本中会将其移除。
scaling_policy确定何时自动启动和关闭（多聚类仓库中的）附加聚类的策略。
budget预算 名称（如果对象受预算监控）。否则为 NULL。
owner_role_type拥有对象的角色类型，例如
ROLE。. 如果 Snowflake Native App 拥有该对象，则该值为APPLICATION。. 如果您删除该对象，则 Snowflake 会返回 NULL，原因是删除的对象不具有所有者角色。
resource_constraint如果类型为
SNOWPARK-OPTIMIZED，则为以下大小之一：
MEMORY_1X、MEMORY_1X_x86、MEMORY_16X、MEMORY_16X_x86、MEMORY_64X、MEMORY_64X_x86。否则为
NULL。
有关可以为仓库指定的属性的更多信息，请参阅 CREATE WAREHOUSE。
示例¶
显示名称以 test 开头且您有权限查看的仓库：
SHOW WAREHOUSES LIKE 'test%';
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+---------------------+
| name | state | type | size | min_cluster_count | max_cluster_count | started_clusters | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on | resumed_on | updated_on | owner | comment | enable_query_acceleration | query_acceleration_max_scale_factor | resource_monitor | actives | pendings | failed | suspended | uuid | scaling_policy | budget | owner_role_type | resource_constraint |
|---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------|-----------------|---------------------+
| TEST1 | SUSPENDED | STANDARD | Medium | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-01-27 14:57:07.768 -0800 | 2023-05-10 16:17:49.258 -0700 | 2023-05-10 16:17:49.258 -0700 | MY_ROLE | | true | 8 | null | 0 | 0 | 0 | 4 | 76064 | STANDARD | NULL | ROLE | NULL +
| TEST2 | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-01-27 14:57:07.953 -0800 | 1969-12-31 16:00:00.000 -0800 | 2023-01-27 14:57:08.356 -0800 | MY_ROLE | | true | 16 | MYTEST_RM | 0 | 0 | 0 | 1 | 76116 | STANDARD | MYBUDGET | ROLE | NULL +
| TEST3 | SUSPENDED | STANDARD | Small | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-08-08 10:26:45.534 -0700 | 2023-08-08 10:26:45.681 -0700 | 2023-08-08 10:26:45.681 -0700 | MY_ROLE | | false | 8 | null | 0 | 0 | 0 | 2 | 19464517 | STANDARD | NULL | ROLE | NULL +
| TEST4 | RESUMING | SNOWPARK-OPTIMIZED | Large | 1 | 1 | 0 | 0 | 0 | N | Y | 600 | true | | | | | 2023-09-21 17:29:58.165 -0700 | 2023-09-21 17:29:58.165 -0700 | 2023-09-21 17:29:58.207 -0700 | MY_ROLE | | false | 8 | null | 0 | 0 | 0 | 0 | 19464585 | STANDARD | NULL | ROLE | MEMORY_16X_X86 +
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+---------------------+
显示您对其拥有 MODIFY 和 OPERATE 权限的仓库：
SHOW WAREHOUSES WITH PRIVILEGES MODIFY, OPERATE;
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+
| name | state | type | size | min_cluster_count | max_cluster_count | started_clusters | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on | resumed_on | updated_on | owner | comment | enable_query_acceleration | query_acceleration_max_scale_factor | resource_monitor | actives | pendings | failed | suspended | uuid | scaling_policy | budget | owner_role_type |
|------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+
| TEST_WH | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | Y | Y | 600 | true | | | | | 2023-01-27 14:57:07.768 -0800 | 2024-07-30 13:39:24.118 -0700 | 2024-07-30 13:39:24.118 -0700 | TEST_ROLE | | true | 32 | TEST_RM | 0 | 0 | 0 | 1 | 76056 | STANDARD | KATS_RENAMED_TEST_BUDGET | ROLE | NULL +
| SNOWPARK_DEMO | SUSPENDED | STANDARD | X-Large | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-01-27 14:57:07.903 -0800 | 2023-04-10 11:47:03.146 -0700 | 2023-04-10 11:47:03.146 -0700 | ACCOUNTADMIN | Created by straut for Snowpark quickstart | false | 8 | null | 0 | 0 | 0 | 16 | 76104 | STANDARD | NULL | ROLE | NULL +
| TASTY_DEV_WH | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | N | N | 60 | true | | | | | 2023-10-25 16:25:43.681 -0700 | 2023-10-25 16:25:43.681 -0700 | 2023-10-25 16:25:43.711 -0700 | SYSADMIN | developer warehouse for tasty bytes | false | 8 | null | 0 | 0 | 0 | 1 | 19464633 | STANDARD | NULL | ROLE | NULL +
| TB_DOCS_WH | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | N | N | 60 | true | | | | | 2024-07-24 15:02:32.172 -0700 | 2024-07-24 15:33:30.502 -0700 | 2024-07-24 15:33:30.502 -0700 | SYSADMIN | developer warehouse for tasty bytes | false | 8 | null | 0 | 0 | 0 | 1 | 19465097 | STANDARD | NULL | ROLE | NULL +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+