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>' ]
[ 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 Modèle d’application avec rôle principal et rôles secondaires.
Notes sur l’utilisation¶
Les colonnes qui commencent par le préfixe
is_renvoient soitY(oui), soitN(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
nameNom de l’entrepôt.
stateQue l’entrepôt soit :
actif/en cours d’exécution (
STARTED), inactif (SUSPENDED) ou en redimensionnement (RESIZING).
typeType d’entrepôt. STANDARD et SNOWPARK-OPTIMIZED sont les seuls types actuellement pris en charge.
sizeTaille de l’entrepôt virtuel (X-Small, Small, Medium, Large, X-Large, etc.)
min_cluster_countNombre minimum de clusters pour l’entrepôt virtuel (multi-clusters) (toujours 1 pour les entrepôts virtuels à un cluster).
max_cluster_countNombre maximum de clusters pour l’entrepôt virtuel (multi-clusters) (toujours 1 pour les entrepôts virtuels à un cluster).
started_clustersNombre de clusters démarrés actuellement.
runningNombre d’instructions SQL exécutées par l’entrepôt virtuel.
queuedNombre d’instructions SQL mises en file d’attente pour l’entrepôt virtuel.
is_defaultSi l’entrepôt virtuel est la valeur par défaut de l’utilisateur actuel.
is_currentSi 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_suspendPé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
nullindique que l’entrepôt ne se suspend jamais automatiquement.
auto_resumeSi l’entrepôt virtuel, si suspendu, reprend automatiquement lorsqu’une requête lui est soumise.
availablePourcentage de ressources de calcul de l’entrepôt virtuel qui sont provisionnées et disponibles.
provisioningPourcentage de ressources de calcul de l’entrepôt virtuel qui sont en cours de provisionnement.
quiescingPourcentage de ressources de calcul de l’entrepôt virtuel qui exécutent des instructions SQL, mais qui seront éteintes à la fin des requêtes.
otherPourcentage des ressources de calcul de l’entrepôt virtuel qui sont dans un état autre que
available,provisioning, ouquiescing.
created_onDate et heure de création de l’entrepôt virtuel.
resumed_onDate et heure du dernier démarrage ou redémarrage de l’entrepôt virtuel.
updated_onDate 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.
ownerRôle qui possède l’entrepôt virtuel.
commentCommentaire pour l’entrepôt virtuel.
enable_query_accelerationSi la fonction Service Query Acceleration est activée pour l’entrepôt.
query_acceleration_max_scale_factorFacteur d’échelle maximum pour le service d’accélération des requêtes.
resource_monitorID 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,uuidCes cinq colonnes sont à usage interne et seront supprimées dans une prochaine version.
scaling_policyStraté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.
budgetNom du budget si l’objet est contrôlé par un budget. sinon, NULL.
owner_role_typeType 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_constraintSi 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.
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 | 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 +
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+---------------------+
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 | 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 +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+