SHOW WAREHOUSES

Lista todos os warehouses em sua conta para os quais você tem privilégios de acesso.

Consulte também:

ALTER WAREHOUSE , CREATE WAREHOUSE , DESCRIBE WAREHOUSE , DROP WAREHOUSE

Sintaxe

SHOW WAREHOUSES [ LIKE '<pattern>' ]
Copy

Parâmetros

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

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

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

Notas de uso

  • As colunas que começam com o prefixo is_ retornam Y (sim) ou N (não).

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna um máximo de 10 mil registros para o tipo de objeto especificado, como ditado pelos privilégios de acesso para a função usada para executar o comando; quaisquer registros acima do limite 10 mil não são retornados, mesmo com um filtro aplicado.

    Para visualizar resultados para os quais existem mais de 10.000 registros, consulte a visualização correspondente (se houver) em Snowflake Information Schema.

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Saída

As colunas na saída fornecem as seguintes informações. Para contas com o recurso Query Acceleration Service habilitado, a saída fornece informações adicionais.

Coluna

Descrição

name

Nome do warehouse

state

Se o warehouse está ativo/em funcionamento (STARTED), inativo (SUSPENDED) ou redimensionado (RESIZING).

type

Tipo de warehouse; STANDARD e SNOWPARK-OPTIMIZED são os únicos tipos suportados no momento.

size

Tamanho do warehouse (X-Small, Small, Small, Medium, Large, X-Large etc.)

min_cluster_count

Número mínimo de clusters para o warehouse (multicluster) (sempre 1 para warehouses monocluster).

max_cluster_count

Número máximo de clusters para o warehouse (multicluster) (sempre 1 para warehouses monocluster).

started_clusters

Número de clusters iniciados atualmente.

running

Número de instruções SQL que estão sendo executadas pelo warehouse.

queued

Número de instruções SQL em fila para o warehouse.

is_default

Se o warehouse é o padrão para o usuário atual.

is_current

Se o warehouse está em uso para a sessão. Apenas um warehouse pode ser utilizado de cada vez para uma sessão. Para especificar ou mudar o warehouse para uma sessão, use o comando USE WAREHOUSE.

auto_suspend

Período de inatividade, em segundos, após o qual um warehouse em funcionamento é suspenso automaticamente e para de usar créditos; um valor null indica que o warehouse nunca é suspenso automaticamente.

auto_resume

Se o warehouse, se suspenso, é automaticamente retomado quando uma consulta é enviada ao warehouse.

available

Porcentagem dos recursos de computação do warehouse que são provisionados e estão disponíveis.

provisioning

Porcentagem dos recursos de computação do warehouse que estão em processo de provisionamento.

quiescing

Porcentagem dos recursos de computação do warehouse que estão executando instruções SQL, mas serão desligados quando as consultas forem concluídas.

other

Porcentagem dos recursos de computação do warehouse que estão em um estado diferente de available, provisioning ou quiescing.

created_on

Data e hora da criação do warehouse.

resumed_on

Data e hora em que o warehouse foi iniciado ou reiniciado pela última vez.

updated_on

Data e hora da última atualização do warehouse, que inclui a mudança de qualquer uma das propriedades do warehouse ou a mudança do estado (STARTED, SUSPENDED, RESIZING) do warehouse.

owner

Função proprietária do warehouse.

comment

Comentário para o warehouse.

enable_query_acceleration

Se o Query Acceleration Service está habilitado para o warehouse.

query_acceleration_max_scale_factor

Fator de escala máximo para o Query Acceleration Service.

resource_monitor

ID do monitor de recursos explicitamente atribuído ao warehouse; controla o uso mensal de crédito do warehouse.

actives , pendings , failed , suspended , uuid

Estas cinco colunas são para uso interno e serão removidas em um lançamento futuro.

scaling_policy

Política que determina quando clusters adicionais (em um warehouse multicluster) são automaticamente iniciados e encerrados.

budget

Nome do orçamento se o objeto for monitorado por um orçamento. Caso contrário, NULL.

owner_role_type

O tipo de função que possui o objeto, ROLE ou DATABASE_ROLE. . Se um Snowflake Native App possuir o objeto, o valor será APPLICATION. . Snowflake retornará NULL se você excluir o objeto porque um objeto excluído não tem função de proprietário.

Para obter mais informações sobre as propriedades que podem ser especificadas para um warehouse, consulte CREATE WAREHOUSE.

Exemplos

Mostrar warehouses com nomes que começam com test que você tem privilégios para visualizar:

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