SHOW WAREHOUSES¶
Répertorie tous les entrepôts virtuels de votre compte pour lesquels vous disposez de privilèges d’accès.
- Voir aussi :
ALTER WAREHOUSE , CREATE WAREHOUSE , DESCRIBE WAREHOUSE , DROP WAREHOUSE
Syntaxe¶
SHOW WAREHOUSES
[ LIKE '<pattern>' ]
[ WITH PRIVILEGES <objectPrivilege> [ , <objectPrivilege> [ , ... ] ] ]
Paramètres¶
LIKE 'pattern'
(Facultatif) Filtre la sortie de commande par nom d’objet. Le filtre utilise une concordance de motif insensible à la casse avec prise en charge des caractères génériques SQL (
%
et_
).Par exemple, les motifs suivants donnent les mêmes résultats :
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
. Par défaut : aucune valeur (aucun filtrage n’est appliqué à la sortie).
WITH PRIVILEGES object_privilege [ , object_privilege [ , ... ] ]
Limite éventuellement les lignes aux objets pour lesquels le rôle actif de l’utilisateur actuel a reçu tous les privilèges spécifiés dans la liste sur l’objet.
Si un privilège <objet> CREATE est inclus dans la liste des privilèges, la commande exclut les objets pour lesquels des privilèges ont été accordés aux rôles secondaires. C’est parce que seul le rôle principal a l’autorisation de créer des objets. Pour plus d’informations, voir Autorisation par le biais d’un rôle primaire et de rôles secondaires.
Sortie¶
Les colonnes de la sortie fournissent les informations suivantes. Pour les comptes pour lesquels la fonction Service Query Acceleration est activée, la sortie fournit des informations supplémentaires.
Colonne
Description
name
Nom de l’entrepôt.
state
Que l’entrepôt soit :
actif/en cours d’exécution (
STARTED
), inactif (SUSPENDED
) ou en redimensionnement (RESIZING
).
type
Type d’entrepôt. STANDARD et SNOWPARK-OPTIMIZED sont les seuls types actuellement pris en charge.
size
Taille de l’entrepôt virtuel (X-Small, Small, Medium, Large, X-Large, etc.)
min_cluster_count
Nombre minimum de clusters pour l’entrepôt virtuel (multi-clusters) (toujours 1 pour les entrepôts virtuels à un cluster).
max_cluster_count
Nombre maximum de clusters pour l’entrepôt virtuel (multi-clusters) (toujours 1 pour les entrepôts virtuels à un cluster).
started_clusters
Nombre de clusters démarrés actuellement.
running
Nombre d’instructions SQL exécutées par l’entrepôt virtuel.
queued
Nombre d’instructions SQL mises en file d’attente pour l’entrepôt virtuel.
is_default
Si l’entrepôt virtuel est la valeur par défaut de l’utilisateur actuel.
is_current
Si l’entrepôt virtuel est utilisé pour la session.
Un seul entrepôt virtuel peut être utilisé à la fois pour une session. Pour spécifier ou modifier l’entrepôt virtuel d’une session, utilisez la commande USE WAREHOUSE.
auto_suspend
Période d’inactivité, en secondes, après laquelle un entrepôt en cours de fonctionnement sera automatiquement suspendu et cessera d’utiliser les crédits.
Une valeur de
null
indique que l’entrepôt ne se suspend jamais automatiquement.
auto_resume
Si l’entrepôt virtuel, si suspendu, reprend automatiquement lorsqu’une requête lui est soumise.
available
Pourcentage de ressources de calcul de l’entrepôt virtuel qui sont provisionnées et disponibles.
provisioning
Pourcentage de ressources de calcul de l’entrepôt virtuel qui sont en cours de provisionnement.
quiescing
Pourcentage de ressources de calcul de l’entrepôt virtuel qui exécutent des instructions SQL, mais qui seront éteintes à la fin des requêtes.
other
Pourcentage des ressources de calcul de l’entrepôt virtuel qui sont dans un état autre que
available
,provisioning
, ouquiescing
.
created_on
Date et heure de création de l’entrepôt virtuel.
resumed_on
Date et heure du dernier démarrage ou redémarrage de l’entrepôt virtuel.
updated_on
Date et heure de la dernière mise à jour de l’entrepôt virtuel, ce qui comprend la modification des propriétés de l’entrepôt virtuel ou la modification de l’état (
STARTED
,SUSPENDED
,RESIZING
) de l’entrepôt virtuel.
owner
Rôle qui possède l’entrepôt virtuel.
comment
Commentaire pour l’entrepôt virtuel.
enable_query_acceleration
Si la fonction Service Query Acceleration est activée pour l’entrepôt.
query_acceleration_max_scale_factor
Facteur d’échelle maximum pour le service d’accélération des requêtes.
resource_monitor
ID du moniteur de ressources explicitement affecté à l’entrepôt ; contrôle l’utilisation mensuelle du crédit pour l’entrepôt.
actives
,pendings
,failed
,suspended
,uuid
Ces cinq colonnes sont à usage interne et seront supprimées dans une prochaine version.
scaling_policy
Stratégie qui détermine quand des clusters supplémentaires (dans un entrepôt virtuels de plusieurs clusters) sont automatiquement démarrés et arrêtés.
owner_role_type
Type de rôle qui possède l’objet, par exemple
ROLE
. . Si une Snowflake Native App est propriétaire de l’objet, la valeur estAPPLICATION
. . Snowflake renvoie NULL si vous supprimez l’objet, car un objet supprimé n’a pas de rôle propriétaire.
resource_constraint
Si le type est
SNOWPARK-OPTIMIZED
, l’un des :
MEMORY_1X
,MEMORY_1X_x86
,MEMORY_16X
,MEMORY_16X_x86
,MEMORY_64X
,MEMORY_64X_x86
.Sinon,
NULL
.
Pour plus d’informations sur les propriétés pouvant être spécifiées pour un entrepôt, voir CREATE WAREHOUSE.
Notes sur l’utilisation¶
La commande ne nécessite pas l’exécution d’un entrepôt en cours d’exécution.
La commande ne renvoie que les objets pour lesquels le rôle actuel de l’utilisateur s’est vu accorder au moins un privilège d’accès.
Le privilège d’accès MANAGE GRANTS permet implicitement à son titulaire de voir tous les objets du compte. Par défaut, seuls l’administrateur du compte (utilisateurs avec le rôle ACCOUNTADMIN) et l’administrateur de sécurité (utilisateurs avec le rôle SECURITYADMIN) ont le privilège MANAGE GRANTS.
Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN qui traite la sortie sous forme de table à interroger. Vous pouvez également utiliser l”opérateur de canal pour interroger la sortie de cette commande.
La commande renvoie un maximum de dix mille enregistrements pour le type d’objet spécifié, conformément aux privilèges d’accès du rôle utilisé pour exécuter la commande. Aucun enregistrement au-delà de la limite de dix mille enregistrements n’est renvoyé, même si un filtre a été appliqué.
Pour afficher les résultats pour lesquels il existe plus de dix mille enregistrements, interrogez la vue correspondante (le cas échéant) dans Schéma d’information de Snowflake.
Exemples¶
Afficher les entrepôts dont le nom commence par test
que vous avez le privilège d’afficher :
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 |
|---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------------------------|---------------------+
| 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 +
| 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 +
| 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 +
| 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 +
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+-----------------+---------------------+
Afficher les entrepôts pour lesquels vous avez obtenu les privilèges MODIFY et OPERATE sur :
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 +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+-----------------+---------------------+
Affichez certains détails sur les entrepôts en filtrant et en réorganisant les données à partir de la sortie SHOW WAREHOUSES complète. Cette procédure stockée exécute une commande SHOW WAREHOUSES, puis appelle la fonction RESULT_SCAN pour filtrer et transformer le jeu de résultats de la commande SQL la plus récente. Vous pouvez utiliser cette technique pour générer différents types de rapports si vous n’avez pas besoin de la sortie complète d’une commande 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 |
+------------------------------+-----------+--------------------+---------+