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>' ]
[ WITH PRIVILEGES <objectPrivilege> [ , <objectPrivilege> [ , ... ] ] ]
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).
WITH PRIVILEGES object_privilege [ , object_privilege [ , ... ] ]Limita opcionalmente as linhas a objetos para os quais a função ativa do usuário atual tenha recebido todos os privilégios especificados na lista no objeto.
Se um privilégio CREATE <objeto> estiver incluso na lista de privilégios, o comando excluirá objetos para os quais funções secundárias receberam privilégios. Isso ocorre porque somente a função primária tem autorização para criar objetos. Para obter mais informações, consulte Modelo de aplicação com funções primárias e secundárias.
Notas de uso¶
As colunas que começam com o prefixo
is_retornamY(sim) ouN(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
nameNome do warehouse.
stateSe o warehouse estiver:
ativo/em execução (
STARTED), inativo (SUSPENDED) ou redimensionando (RESIZING).
typeTipo de warehouse. STANDARD e SNOWPARK-OPTIMIZED são os únicos tipos compatíveis atualmente.
sizeTamanho do warehouse (X-Small, Small, Small, Medium, Large, X-Large etc.)
min_cluster_countNúmero mínimo de clusters para o warehouse (multicluster) (sempre 1 para warehouses monocluster).
max_cluster_countNúmero máximo de clusters para o warehouse (multicluster) (sempre 1 para warehouses monocluster).
started_clustersNúmero de clusters iniciados atualmente.
runningNúmero de instruções SQL que estão sendo executadas pelo warehouse.
queuedNúmero de instruções SQL em fila para o warehouse.
is_defaultSe o warehouse é o padrão para o usuário atual.
is_currentSe 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_suspendPeríodo de inatividade, em segundos, após o qual um warehouse em execução será automaticamente suspenso e deixará de usar créditos.
Um valor de
nullindica que o warehouse nunca é suspenso automaticamente.
auto_resumeSe o warehouse, se suspenso, é automaticamente retomado quando uma consulta é enviada ao warehouse.
availablePorcentagem dos recursos de computação do warehouse que são provisionados e estão disponíveis.
provisioningPorcentagem dos recursos de computação do warehouse que estão em processo de provisionamento.
quiescingPorcentagem dos recursos de computação do warehouse que estão executando instruções SQL, mas serão desligados quando as consultas forem concluídas.
otherPorcentagem dos recursos de computação do warehouse que estão em um estado diferente de
available,provisioningouquiescing.
created_onData e hora da criação do warehouse.
resumed_onData e hora em que o warehouse foi iniciado ou reiniciado pela última vez.
updated_onData 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.
ownerFunção proprietária do warehouse.
commentComentário para o warehouse.
enable_query_accelerationSe o Query Acceleration Service está habilitado para o warehouse.
query_acceleration_max_scale_factorFator de escala máximo para o Query Acceleration Service.
resource_monitorID do monitor de recursos explicitamente atribuído ao warehouse; controla o uso mensal de crédito do warehouse.
actives,pendings,failed,suspended,uuidEstas cinco colunas são para uso interno e serão removidas em um lançamento futuro.
scaling_policyPolítica que determina quando clusters adicionais (em um warehouse multicluster) são automaticamente iniciados e encerrados.
budgetNome do orçamento se o objeto for monitorado por um orçamento. Caso contrário, NULL.
owner_role_typeO tipo de função que possui o objeto, por exemplo
ROLE. . Se um Snowflake Native App possui o objeto, o valor éAPPLICATION. . Snowflake retorna NULL se você excluir o objeto porque um objeto excluído não tem uma função de proprietário.
resource_constraintSe o tipo for
SNOWPARK-OPTIMIZED, um dos seguintes:
MEMORY_1X,MEMORY_1X_x86,MEMORY_16X,MEMORY_16X_x86,MEMORY_64X,MEMORY_64X_x86.Caso contrário,
NULL.
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%';
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+---------------------+
| 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 +
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+---------------------+
Mostre warehouses aos quais você concedeu os privilégios MODIFY e 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 +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+