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 <オブジェクト> 権限が権限リストに含まれている場合、コマンドはセカンダリ・ロールに権限が付与されているオブジェクトを除外します。これは、プライマリ・ロールだけがオブジェクトを作成する権限を持っているからです。詳細については、 施行モデル: プライマリロールおよびセカンダリロール をご参照ください。
使用上の注意¶
プレフィックス
is_
で始まる列は、Y
(はい)またはN
(いいえ)のいずれかを返します。このコマンドは、実行中のウェアハウスを必要としません。
コマンドは、コマンドを実行するために使用されるロールのアクセス権によって決定された通り、指定されたオブジェクトタイプに対して 最大 10Kのレコードを返します。フィルタが適用されていても、10Kの制限を超えるレコードは返されません。
10Kを超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー(存在する場合)をクエリします。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
出力¶
出力の列は、次の情報を提供します。 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
プロビジョニング中のウェアハウスコンピューティングリソースの割合。
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。ウェアハウスの毎月のクレジット使用状況を制御します。
actives
、pendings
、failed
、suspended
、uuid
これらの5つの列は内部用であり、将来のリリースで削除される予定です。
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 +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+