SHOW WAREHOUSES¶
アクセス権限を持っているアカウント内の 仮想ウェアハウス をすべてリストします。
- こちらもご参照ください。
ALTER WAREHOUSE、 CREATE WAREHOUSE、 DESCRIBE WAREHOUSE、 DROP WAREHOUSE
構文¶
SHOW WAREHOUSES
[ LIKE '<pattern>' ]
[ WITH PRIVILEGES <objectPrivilege> [ , <objectPrivilege> [ , ... ] ] ]
パラメーター¶
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（
%および_）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし（フィルタリングは出力に非適用）。
WITH PRIVILEGES object_privilege [ , object_privilege [ , ... ] ]オプションで、現在のユーザーの アクティブなロール が、オブジェクトのリストで指定されたすべての権限を付与されているオブジェクトに行を制限します。
CREATE <オブジェクト> 権限が権限リストに含まれている場合、コマンドはセカンダリ・ロールに権限が付与されているオブジェクトを除外します。これは、プライマリ・ロールだけがオブジェクトを作成する権限を持っているからです。詳細については、 プライマリ・ロールとセカンダリ・ロールによる権限付与 をご参照ください。
出力¶
出力の列は、次の情報を提供します。 Query Acceleration Service 機能が有効になっているアカウントの場合、出力は次の追加情報を提供します。
列
説明
nameウェアハウスの名前。
stateウェアハウスがあるかどうか。
アクティブ/実行中（
STARTED）、非アクティブ（SUSPENDED）、またはサイズ変更（RESIZING）。
typeウェアハウスのタイプ。ウェアハウスのタイプ。現在サポートされているタイプは STANDARD と SNOWPARK-OPTIMIZED のみです。
sizeウェアハウスのサイズ（XS、S、M、L、XLなど）
min_cluster_count（マルチクラスター）ウェアハウスのクラスターの最小数（単一クラスターのウェアハウスの場合は常に1）。
max_cluster_count（マルチクラスター）ウェアハウスのクラスターの最大数（単一クラスターのウェアハウスの場合は常に1）。
started_clusters現在開始されているクラスターの数。
runningウェアハウスによって実行されている SQL ステートメントの数。
queuedウェアハウスのキューに入れられている SQL ステートメントの数。
is_defaultウェアハウスが現在のユーザーのデフォルトであるか。
is_currentウェアハウスがセッションで使用されているか。
セッションで一度に使用できるウェアハウスは1つだけです。セッションのウェアハウスを指定または変更するには、 USE WAREHOUSE コマンドを使用します。
auto_suspend実行中のウェアハウスがクレジットの使用を自動的に一時停止および停止するまでの非アクティブ期間（秒単位）。
値が
nullの場合は、ウェアハウスが自動的に一時停止しないことを示します。
auto_resumeウェアハウスが一時停止された場合、クエリがウェアハウスに送信された時点で自動的に再開するか。
availableプロビジョニングされて利用可能なウェアハウスコンピューティングリソースの割合。
provisioningプロビジョニング中のウェアハウスコンピューティングリソースの割合。
quiescingSQL ステートメントを実行しているが、クエリが完了するとシャットダウンされるウェアハウスコンピューティングリソースの割合。
other
available、provisioning、 またはquiescing以外の状態にあるウェアハウスコンピューティングリソースの割合。
created_onウェアハウスが作成された日時。
resumed_onウェアハウスが最後に開始または再起動された日時。
updated_onウェアハウスのプロパティの変更またはウェアハウスの状態（
STARTED、SUSPENDED、RESIZING）の変更を含む、ウェアハウスが最後に更新された日時。
ownerウェアハウスを所有するロール。
commentウェアハウスについてのコメント。
enable_query_accelerationQuery Acceleration Service がウェアハウスで有効になっているかどうか。
query_acceleration_max_scale_factorQuery Acceleration Serviceの 最大スケールファクター。
resource_monitorウェアハウスに明示的に割り当てられた リソースモニター の ID。ウェアハウスの毎月のクレジット使用状況を制御します。
actives、pendings、failed、suspended、uuidこれらの5つの列は内部用であり、将来のリリースで削除される予定です。
scaling_policy追加のクラスター（マルチクラスターウェアハウス内）がいつ自動的に開始およびシャットダウンされるかを決定するポリシー。
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 をご参照ください。
使用上の注意¶
このコマンドの実行には、稼働中のウェアハウスは必要ありません。
このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。
MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。このコマンドの出力をクエリするには、 パイプ演算子 を使用することもできます。
コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 1万件の記録を返します。1万件を超える記録は、フィルターを適用しても返されません。
1万件を超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー（存在する場合）をクエリします。
例¶
表示する権限のある 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | ROLE | NULL +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+-----------------+---------------------+
SHOW WAREHOUSES の完全な出力からデータをフィルターして並べ替えることで、ウェアハウスに関する特定の詳細を表示します。このストアドプロシージャは、 SHOW WAREHOUSES コマンドを実行し、 RESULT_SCAN 関数を呼び出して、最新の SQL コマンドからの結果セットをフィルターし、変換します。SHOW コマンドの出力全体を必要としない場合は、このテクニックを使ってさまざまなタイプのレポートを作成することができます。
CREATE OR REPLACE PROCEDURE started_and_suspended_warehouses()
RETURNS TABLE(name VARCHAR, status VARCHAR, type VARCHAR, size VARCHAR)
LANGUAGE SQL
AS
$$
DECLARE
res RESULTSET;
BEGIN
SHOW WAREHOUSES;
res := (SELECT "name" name, "state" state, "type" type, "size" size
FROM TABLE(RESULT_SCAN(LAST_QUERY_ID(-1)))
WHERE "state" IN ('STARTED','SUSPENDED')
ORDER BY "state", "name");
RETURN TABLE(res);
END;
$$
;
CALL started_and_suspended_warehouses();
+------------------------------+-----------+--------------------+---------+
| NAME | STATUS | TYPE | SIZE |
|------------------------------+-----------+--------------------+---------|
| COMPUTE_WH | STARTED | STANDARD | X-Small |
| DEFAULT_SIZE | SUSPENDED | STANDARD | Small |
| DEFAULT_SIZE_2 | SUSPENDED | STANDARD | X-Small |
| MEDIUM | SUSPENDED | SNOWPARK-OPTIMIZED | Medium |
| PRIV_WH | SUSPENDED | STANDARD | X-Small |
| SYSTEM$STREAMLIT_NOTEBOOK_WH | SUSPENDED | STANDARD | X-Small |
| XSMALL | SUSPENDED | STANDARD | Medium |
+------------------------------+-----------+--------------------+---------+