SHOW COMPUTE POOLS¶

Répertorie les pools de calcul de votre compte pour lesquels vous avez des privilèges d’accès.

Voir aussi :: CREATE COMPUTE POOL , ALTER COMPUTE POOL, DESCRIBE COMPUTE POOL , DROP COMPUTE POOL

Syntaxe¶

SHOW COMPUTE POOLS [ LIKE '<pattern>' ]
                   [ STARTS WITH '<name_string>' ]
                   [ LIMIT <ROWS> [ FROM '<name-string>' ] ]

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

STARTS WITH 'name_string'

(Facultatif) Filtre la sortie de commande en fonction des caractères qui apparaissent au début du nom de l’objet. La chaîne doit être délimitée par des guillemets simples et est sensible à la casse.

Par exemple, les chaînes suivantes renvoient des résultats différents :

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. Par défaut : aucune valeur (aucun filtrage n’est appliqué à la sortie)

LIMIT rows [ FROM 'name_string' ]

(Facultatif) Limite le nombre maximum de lignes retournées, tout en permettant la « pagination » des résultats. Le nombre réel de lignes renvoyées peut être inférieur à la limite spécifiée. Par exemple, le nombre d’objets existants est inférieur à la limite spécifiée.

La sous-clause facultative FROM 'name_string' sert effectivement de « curseur » pour les résultats. Ceci permet de récupérer le nombre spécifié de lignes suivant la première ligne dont le nom d’objet correspond à la chaîne spécifiée :

La chaîne doit être délimitée par des guillemets simples et est sensible à la casse.
La chaîne n’a pas besoin d’inclure le nom complet de l’objet ; les noms partiels sont pris en charge.

Par défaut : aucune valeur (aucune limite n’est appliquée à la sortie)

Note

Pour les commandes SHOW qui prennent en charge les clauses FROM 'name_string' et STARTS WITH 'name_string', vous pouvez combiner ces deux clauses dans la même instruction. Cependant, les deux conditions doivent être remplies ou elles s’annulent mutuellement et aucun résultat n’est renvoyé.

De plus, les objets sont retournés dans l’ordre lexicographique par nom, donc FROM 'name_string' ne retourne que les lignes ayant une valeur lexicographique plus élevée que les lignes retournées par STARTS WITH 'name_string'

Par exemple :

... STARTS WITH 'A' LIMIT ... FROM 'B' ne donnerait aucun résultat.
... STARTS WITH 'B' LIMIT ... FROM 'A' ne donnerait aucun résultat.
... STARTS WITH 'A' LIMIT ... FROM 'AB' donnerait des résultats (si des lignes correspondent aux chaînes d’entrée).

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège	Objet	Remarques
N’importe lequel de ces privilèges : OWNERSHIP, USAGE, MONITOR ou OPERATE	Pool de calcul

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Sortie¶

La sortie de commande fournit les propriétés du pool de calcul et les métadonnées dans les colonnes suivantes :

Colonne	Description
`name`	Nom du pool de calcul.
`state`	État du pool de calcul. Pour plus d’informations, voir Cycle de vie d’un pool de calcul.
`min_nodes`	Nombre minimum de nœuds dans le pool de calcul.
`max_nodes`	Nombre maximal de nœuds dans le pool de calcul.
`instance_family`	Type de machine des nœuds dans le pool de calcul.
`num_services`	Nombre de services fonctionnant sur le pool de calcul.
`num_jobs`	Nombre de tâches en cours d’exécution sur le pool de calcul.
`auto_suspend_secs`	Nombre de secondes d’inactivité après lesquelles Snowflake suspend automatiquement le pool de calcul.
`auto_resume`	Spécifie s’il faut reprendre automatiquement un pool de calcul lorsque Snowflake démarre un service ou une tâche.
`active_nodes`	Nombre de nœuds du pool de calcul qui sont actifs (au moins un service ou au moins une tâche sont en cours d’exécution).
`idle_nodes`	Nombre de nœuds du pool de calcul qui sont inactifs (aucun service ou aucune tâche n’est en cours d’exécution).
`target_nodes`	Indique le nombre de nœuds que Snowflake cible pour votre pool de calcul. Si `active_nodes` n’est pas égal aux `target_nodes`, alors Snowflake mettra automatiquement à l’échelle le cluster pour ajouter ou supprimer les nœuds. Les exemples suivants montrent comment interpréter les valeurs dans la colonne `target_nodes`. Exemple 1 : Supposons que, dans une commande CREATE COMPUTE POOL, vous spécifiez MIN_NODES=1 et MAX_NODES=3. Pendant que Snowflake provisionne un nœud, la valeur initiale dans les colonnes `active_nodes` et `idle_nodes` est 0 et la valeur dans la colonne `target_nodes` est 1. (La valeur dans la colonne `target_nodes` est la même que la valeur que vous avez spécifiée pour le paramètre MIN_NODES.) Cela indique qu’il doit y avoir un nœud dans le pool de calcul que Snowflake provisionne. Une fois que Snowflake a provisionné un nœud, la valeur dans la colonne `idle_nodes` est 1 (en supposant qu’aucun service n’est en cours d’exécution). La valeur dans la colonne `target_nodes` est toujours 1, indiquant qu’il devrait y avoir un nœud dans le pool de calcul. Exemple 2 : Snowflake peut essayer d’ajouter un nœud à un pool de calcul existant en raison de la mise à l’échelle automatique ou de modifications du nombre minimal de nœuds (via ALTER COMPUTE POOL … SET MIN_NODES). Pendant que Snowflake provisionne un nœud, la valeur dans la colonne `state` est `resizing`. Pour déterminer le nombre de nœuds ajoutés par Snowflake, vérifiez la valeur dans la colonne `target_nodes`. Par exemple, supposons que la valeur dans la colonne `active_nodes` est 1, que la valeur dans la colonne `idle_nodes` est 0 et que vous redimensionniez le pool de calcul en mettant à jour la propriété MIN_NODES en remplaçant sa valeur de 1 par 2. Dans ce cas, la valeur dans la colonne `target_nodes` est 2 (le nombre de nœuds qui doivent être dans le pool de calcul). À partir de cela, vous pouvez en déduire que Snowflake provisionne un nœud supplémentaire.
`created_on`	Date et heure de création du pool de calcul.
`resumed_on`	Date et heure de reprise du pool de calcul suspendu.
`updated_on`	Date et heure auxquelles le pool de calcul a été mis à jour à l’aide de ALTER COMPUTE POOL.
`owner`	Rôle qui est propriétaire du pool de calcul.
`comment`	Spécifie un commentaire pour le pool de calcul.
`is_exclusive`	`true` si le pool de calcul est créé exclusivement pour une Snowflake Native App ; `false` dans le cas contraire.
`application`	Nom de la Snowflake Native App si le pool de calcul est créé exclusivement pour l’app. Sinon, NULL.
`budget`	Le nom du budget qui surveille l’utilisation du crédit du pool de calcul.

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.

Exemples¶

La commande suivante répertorie les pools de calcul pour lesquels vous disposez de privilèges d’accès dans le compte actuel :

SHOW COMPUTE POOLS;

Copy

La commande suivante répertorie un pool de calcul :

SHOW COMPUTE POOLS LIMIT 1;

Copy

La commande suivante répertorie les pools de calcul dont le nom contient « tu » :

SHOW COMPUTE POOLS LIKE '%tu%';

Copy

La commande suivante répertorie deux pools de calcul dont le nom contient « my_pool »:

SHOW COMPUTE POOLS LIKE '%my_pool%' LIMIT 2;

Copy

Exemple de sortie :

+-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------+
| name                    | state     | min_nodes | max_nodes | instance_family | num_services | num_jobs | auto_suspend_secs | auto_resume | active_nodes | idle_nodes | target_nodes | created_on                    | resumed_on                    | updated_on                    | owner        | comment | is_exclusive | application | budget |
|-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------|
| TUTORIAL_COMPUTE_POOL   | ACTIVE    |         1 |         1 | CPU_X64_XS      |            3 |        0 |              3600 | true        |            1 |          0 |            1 | 2024-02-24 20:41:31.978 -0800 | 2024-08-08 11:27:01.775 -0700 | 2024-08-18 13:47:08.150 -0700 | TEST_ROLE    | NULL    | false        | NULL        | NULL   |
| TUTORIAL_COMPUTE_POOL_2 | SUSPENDED |         1 |         1 | CPU_X64_XS      |            0 |        0 |              3600 | true        |            0 |          0 |            0 | 2024-01-15 21:23:09.744 -0800 | 2024-04-06 15:24:50.541 -0700 | 2024-08-18 13:46:08.110 -0700 | ACCOUNTADMIN | NULL    | false        | NULL        | NULL   |
+-------------------------+-----------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+--------------+-------------+--------+