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 コマンドを使用します。

is_interactive

ウェアハウスが インタラクティブなウェアハウス かどうか（Y）または（N）現在、インタラクティブなウェアハウス機能は |aws|（AWS）でのみ使用できます。

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

追加のクラスター（マルチクラスターウェアハウス内）がいつ自動的に開始およびシャットダウンされるかを決定するポリシー。

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。

generation

ウェアハウスの:doc:`世代</user-guide/warehouses-gen2>`タイプ。

ウェアハウスに指定できるプロパティの詳細については、 CREATE WAREHOUSE をご参照ください。

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。

    出力列を参照する場合は、列名に:ref:二重引用符<label-delimited_identifier>`で囲まれた識別子を使用します。たとえば、出力列 ``type` を選択するには、 SELECT "type" を指定します。

    SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

  • コマンドは、コマンドを実行するために使用されるロールのアクセス権限によって決定された通り、指定されたオブジェクトタイプに対して 最大 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 | generation |
|---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------------------------|---------------------+
| 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  | 1                 +
| 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  | 2                 +
| 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   | 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 | NULL             +
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+-----------------+---------------------+

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  |
+------------------------------+-----------+--------------------+---------+