ALTER COMPUTE POOL¶

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

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

Syntaxe¶

ALTER COMPUTE POOL [ IF EXISTS ] <name> { SUSPEND | RESUME }

ALTER COMPUTE POOL [ IF EXISTS ] <name> STOP ALL;

ALTER COMPUTE POOL [ IF EXISTS ] <name> SET [ MIN_NODES = <num> ]
                                            [ MAX_NODES = <num> ]
                                            [ AUTO_RESUME = { TRUE | FALSE } ]
                                            [ AUTO_SUSPEND_SECS = <num> ]
                                            [ COMMENT = '<string_literal>' ]

ALTER COMPUTE POOL [ IF EXISTS ] <name> UNSET { AUTO_SUSPEND_SECS |
                                                AUTO_RESUME       |
                                                COMMENT
                                              }
                                              [ , ... ]

Copy

Paramètres¶

name

Indique l’identificateur du pool de calcul à modifier.

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 de détails, voir Exigences relatives à l’identificateur.

STOP ALL

Suspend tous les services et annule les tâches exécutées dans le pool de calcul. Snowflake supprime ensuite tous les conteneurs du pool de calcul.

SET ...

Définit une ou plusieurs propriétés ou paramètres spécifiés pour le pool de calcul :

MIN_NODES = num: Spécifie le nombre minimum de nœuds du pool de calcul.
MAX_NODES = num: Spécifie le nombre maximal de nœuds de pool de calcul.
AUTO_RESUME = { TRUE | FALSE }: Indique s’il faut reprendre automatiquement un pool de calcul lorsqu’une tâche ou un service lui est soumis. Si AUTO_RESUME est défini sur FALSE, vous devez reprendre explicitement le pool de calcul (en utilisant ALTER COMPUTE POOL <nom> RESUME) avant de pouvoir démarrer un service ou une tâche sur le pool de calcul.
AUTO_SUSPEND_SECS = num: Nombre de secondes d’inactivité après lesquelles vous souhaitez que Snowflake suspende automatiquement le pool de calcul. L’inactivité signifie qu’aucun service ou aucune tâche n’est en cours d’exécution sur un nœud du pool de calcul.
COMMENT = 'string_literal': Spécifie un commentaire pour le pool de calcul.

UNSET ...

Spécifie une ou plusieurs propriétés et/ou un ou plusieurs paramètres à désactiver pour le pool de calcul, qui les réinitialise aux valeurs par défaut (voir CREATE COMPUTE POOL) :

AUTO_SUSPEND_SECS
AUTO_RESUME
COMMENT

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
OPERATE	Pool de calcul	Pour suspendre ou reprendre un pool de calcul, le rôle doit disposer de ces autorisations.
MODIFY	Pool de calcul	Pour modifier le pool de calcul et définir les propriétés, le rôle doit disposer de cette autorisation.

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¶

Concernant les métadonnées :

Attention

Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples¶

L’exemple suivant définit les propriétés MAX_NODES et AUTO_RESUME pour un pool de calcul :

ALTER COMPUTE POOL tutorial_compute_pool SET
  MAX_NODES = 5
  AUTO_RESUME = FALSE

Copy