SHOW WAREHOUSES

계정에서 액세스 권한이 있는 모든 가상 웨어하우스(virtual warehouse)를 나열하는 명령이에요.

출처: 문서

본문

계정에서 액세스 권한이 있는 모든 가상 웨어하우스를 나열해요.

구문

SHOW WAREHOUSES
  [ LIKE '<pattern>' ]
  [ WITH PRIVILEGES <objectPrivilege> [ , <objectPrivilege> [ , ... ] ] ]

매개변수

LIKE 'pattern'

선택적으로 객체 이름으로 명령 출력을 필터링해요. 필터는 SQL 와일드카드 문자(%와 _)를 지원하며 대소문자를 구분하지 않는 패턴 매칭을 사용해요. 예를 들어 다음 패턴들은 같은 결과를 반환해요:

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

기본값: 값 없음(출력에 필터링이 적용되지 않음).

WITH PRIVILEGES object_privilege [ , object_privilege [ , ... ] ]

선택적으로 현재 사용자의 활성 역할이 객체에 대해 지정된 권한 목록의 모든 권한을 부여받은 객체로 행을 제한해요. 권한 목록에 CREATE <object> 권한이 포함되면, 명령은 보조 역할(secondary role)에 권한이 부여된 객체를 제외해요. 이는 기본 역할(primary role)만 객체를 만들 권한이 있기 때문이에요. 자세한 내용은 기본 역할과 보조 역할을 통한 승인(Authorization through primary role and secondary roles)을 참고해요.

출력

출력의 컬럼은 다음 정보를 제공해요. 쿼리 가속 서비스(Query Acceleration Service) 기능이 활성화된 계정의 경우 출력은 추가 정보를 제공해요.

컬럼	설명
name	웨어하우스의 이름이에요.
state	웨어하우스가 활성/실행 중(STARTED)인지, 비활성(SUSPENDED)인지, 크기 조정 중(RESIZING)인지 여부예요.
type	웨어하우스 유형이에요. 현재 지원되는 유형은 STANDARD와 SNOWPARK-OPTIMIZED뿐이에요.
size	웨어하우스의 크기예요(X-Small, Small, Medium, Large, X-Large 등).
min_cluster_count	(멀티 클러스터) 웨어하우스의 최소 클러스터 수예요(단일 클러스터 웨어하우스에는 항상 1).
max_cluster_count	(멀티 클러스터) 웨어하우스의 최대 클러스터 수예요(단일 클러스터 웨어하우스에는 항상 1).
started_clusters	현재 시작된 클러스터 수예요.
running	웨어하우스가 실행 중인 SQL 문 수예요.
queued	웨어하우스에 큐잉된 SQL 문 수예요.
is_default	웨어하우스가 현재 사용자의 기본값인지 여부예요.
is_current	웨어하우스가 세션에 사용 중인지 여부예요. 세션에 한 번에 하나의 웨어하우스만 사용할 수 있어요. 세션의 웨어하우스를 지정하거나 변경하려면 USE WAREHOUSE 명령을 사용해요.
is_interactive	웨어하우스가 인터랙티브 웨어하우스인지(Y) 아닌지(N)예요. 현재 인터랙티브 웨어하우스 기능은 Amazon Web Services(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_max_scale_factor	쿼리 가속 서비스의 최대 배율(scale factor)이에요.
resource_monitor	웨어하우스에 명시적으로 할당된 리소스 모니터의 ID예요. 웨어하우스의 월별 크레딧 사용량을 제어해요.
actives, pendings, failed, suspended, uuid	이 다섯 컬럼은 내부용이며 향후 릴리스에서 제거될 거예요.
scaling_policy	멀티 클러스터 웨어하우스에서 추가 클러스터가 자동으로 시작·종료되는 시기를 결정하는 정책이에요.
owner_role_type	객체를 소유하는 역할의 유형으로, 예를 들어 ROLE이에요. Snowflake Native App이 객체를 소유하면 값은 APPLICATION이에요. 객체를 삭제하면 삭제된 객체에는 소유 역할이 없으므로 Snowflake는 NULL을 반환해요.
resource_constraint	type이 SNOWPARK-OPTIMIZED면 MEMORY_1X, MEMORY_1X_x86, MEMORY_16X, MEMORY_16X_x86, MEMORY_64X, MEMORY_64X_x86 중 하나예요. 그렇지 않으면 NULL이에요.
generation	웨어하우스의 세대(generation) 유형이에요.

웨어하우스에 지정할 수 있는 속성에 대한 자세한 내용은 CREATE WAREHOUSE를 참고해요.

사용 메모

이 명령은 실행에 웨어하우스가 필요하지 않아요.
이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
MANAGE GRANTS 액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만 MANAGE GRANTS 권한을 가져요.
이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.
이 명령은 명령을 실행하는 역할의 액세스 권한에 따라 지정한 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 1만 개를 초과하는 결과를 보려면 Snowflake 정보 스키마의 해당 뷰(존재하는 경우)를 쿼리해요.

예제

볼 권한이 있는, 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  |
+------------------------------+-----------+--------------------+---------+

더 알아보기 (Learn more)

See also: ALTER WAREHOUSE, CREATE WAREHOUSE, DESCRIBE WAREHOUSE, DROP WAREHOUSE