SHOW WAREHOUSES¶

Liste tous les entrepôts virtuels de votre compte pour lesquels vous avez des privilèges d’accès.

Voir aussi :: ALTER WAREHOUSE , CREATE WAREHOUSE , DESCRIBE WAREHOUSE , DROP WAREHOUSE

Syntaxe¶

SHOW WAREHOUSES [ LIKE '<pattern>' ]

Copy

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).

Notes sur l’utilisation¶

Les colonnes qui commencent par le préfixe is_ renvoient soit Y (oui), soit N (non).
L’exécution de la commande ne nécessite pas un entrepôt virtuel en cours d’exécution.
La commande retourne un maximum de 10 000 enregistrements pour le type d’objet spécifié, comme dicté par les privilèges d’accès pour le rôle utilisé pour exécuter la commande ; tous les enregistrements au-dessus de la limite de 10 000 enregistrements ne sont pas retournés, même avec un filtre appliqué.

Pour afficher les résultats pour lesquels il existe plus de 10 000 enregistrements, interrogez la vue correspondante (s’il en existe une) dans Schéma d’information de Snowflake.

Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

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 virtuel
`state`	Si l’entrepôt est actif/en cours d’exécution (`STARTED`), inactif (`SUSPENDED`) ou en cours de 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 `null` indique que l’entrepôt virtuel ne sera jamais automatiquement suspendu.
`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`, ou `quiescing`.
`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.
`budget`	Nom du budget si l’objet est contrôlé par un budget. sinon, NULL.
`owner_role_type`	Type de rôle qui possède l’objet, soit `ROLE` ou `DATABASE_ROLE`. . Si une Snowflake Native App est propriétaire de l’objet, la valeur est `APPLICATION`. . Snowflake renvoie NULL si vous supprimez l’objet, car un objet supprimé n’a pas de rôle propriétaire.

Pour plus d’informations sur les propriétés pouvant être spécifiées pour un entrepôt, voir CREATE WAREHOUSE.

Exemples¶

Afficher les entrepôts dont le nom commence par test que vous avez le privilège d’afficher :

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