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> [ , ... ] ] ]
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).

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

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 est APPLICATION. . 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%';
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 | 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;
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 | 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();
Copy
+------------------------------+-----------+--------------------+---------+
| 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  |
+------------------------------+-----------+--------------------+---------+