SHOW WAREHOUSES

列出您账户中您拥有访问权限的所有仓库。

另请参阅：

ALTER WAREHOUSE、CREATE WAREHOUSE、DESCRIBE WAREHOUSE、DROP WAREHOUSE

语法

SHOW WAREHOUSES [ LIKE '<pattern>' ]
Copy

参数

LIKE 'pattern'

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

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

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

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

使用说明

  • 以前缀 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_factor

Query Acceleration Service 的 最大缩放因子。

resource_monitor

显式分配给仓库的 资源监视器 的 ID；控制仓库每月的 Credit 使用情况。

actives、pendings、failed、suspended、uuid

这五列仅供内部使用，未来的版本中会将其移除。

scaling_policy

确定何时自动启动和关闭（多聚类仓库中的）附加聚类的策略。

budget

预算 名称（如果对象受预算监控）。否则，显示 NULL。

owner_role_type

拥有对象的角色类型是 ROLE 或 DATABASE_ROLE。. 如果 Snowflake Native App 拥有该对象，则该值为 APPLICATION。. 如果您删除该对象，则 Snowflake 会返回 NULL，原因是删除的对象不具有所有者角色。

有关可以为仓库指定的属性的更多信息，请参阅 CREATE WAREHOUSE。

示例

显示名称以 test 开头且您有权限查看的仓库：

SHOW WAREHOUSES LIKE 'test%';
Copy
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+
| 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 |
|---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------|-----------------|
| 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            |
| 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            |
| 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            |
| 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            |
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+
语言: 中文