DESCRIBE COMPUTE POOL¶

Décrit les propriétés d’un pool de calcul.

DESCRIBE peut être abrégé en DESC.

Voir aussi :: CREATE COMPUTE POOL , ALTER COMPUTE POOL, DROP COMPUTE POOL , SHOW COMPUTE POOLS

Syntaxe¶

DESC[RIBE] COMPUTE POOL <name>

Copy

Paramètres¶

name

Indique l’identificateur du pool de calcul à décrire.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

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 actuel du 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`	Spécifie le type de machine des nœuds du pool de calcul.
`num_services`	Le nombre de services et de tâches en cours d’exécution sur le pool de calcul.
`num_jobs`	Nombre de tâches en cours d’exécution sur le pool de calcul.
`auto_suspend_secs`	Indique le nombre de secondes d’inactivité après lesquelles un pool de calcul est automatiquement suspendu.
`auto_resume`	Spécifie s’il faut reprendre automatiquement un pool de calcul lorsque Snowflake tente de démarrer 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.
`error_code`	Code d’erreur, le cas échéant, relatif au STATUS_MESSAGE. Sinon, ce champ est vide. Par exemple, lorsque vous redimensionnez un pool de calcul : Si Snowflake rencontre une erreur de capacité (les nouveaux nœuds ne peuvent pas être provisionnés), Snowflake renvoie le code d’erreur 392507. Notez que l’erreur de capacité indique que le type d’instance que vous avez demandé pour votre nœud de pool de calcul n’est actuellement pas disponible auprès du fournisseur de cloud. Vous pouvez soit attendre que la capacité soit disponible, soit créer un nouveau pool de calcul avec une famille d’instances différente. Si vous avez des services en attente (y compris des services de travail) et que Snowflake ne peut pas faire évoluer votre pool de calcul, Snowflake renvoie le code d’erreur 392508.
`status_message`	Message facultatif sur le statut du pool de calcul. Par exemple : Après avoir créé un pool de calcul, si vous exécutez la commande DESC COMPUTE POOL, la sortie peut inclure le message de statut : « Le pool de calcul démarre depuis la dernière minute ». Si Snowflake rencontre une erreur de capacité lors du provisionnement d’un nœud, la sortie peut inclure le message de statut : « Le pool de calcul démarre depuis les 3 dernières minutes. Nous avons observé une CAPACITY_ERROR. » Si vous avez des services en attente (y compris des services de tâche) et que Snowflake ne peut pas faire évoluer votre pool de calcul, la sortie peut inclure le message de statut : « Le pool de calcul a atteint la limite maximale de nœuds. Envisagez d’augmenter max_nodes en utilisant la commande ALTER COMPUTE POOL. »

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

Notes sur l’utilisation¶

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¶

L’exemple suivant décrit le pool de calcul nommé tutorial_compute_pool :

DESCRIBE COMPUTE POOL tutorial_compute_pool;

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 | error_code | status_message |
|-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------|
| 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:29:08.124 -0700 | TEST_ROLE | NULL    | false        | NULL        | NULL   |            |                |
+-----------------------+--------+-----------+-----------+-----------------+--------------+----------+-------------------+-------------+--------------+------------+--------------+-------------------------------+-------------------------------+-------------------------------+-----------+---------+--------------+-------------+--------+------------+----------------+