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