ALTER COMPUTE POOL¶

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> ]
                                            [ PLACEMENT_GROUP = '<placement_group_name>' ]
                                            [ INSTANCE_FAMILY = <instance_family_name> ]
                                            [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ]
                                            [ COMMENT = '<string_literal>' ]

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

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

{ SUSPEND | RESUME }

Suspension d’un pool de calcul ou reprise d’un pool de calcul précédemment suspendu. Lorsque vous suspendez un pool de calcul, Snowflake suspend tous les services du pool de calcul, mais les tâches continuent de s’exécuter jusqu’à ce qu’elles atteignent un état final (DONE ou FAILED), après quoi les nœuds du pool de calcul sont libérés.

STOP ALL

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

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Tag quotas.

PLACEMENT_GROUP = placement_group_name

Identifies the placement group of the compute pool. Use the SHOW COMPUTE POOLS and DESCRIBE COMPUTE POOL commands to review the assignment of the compute pool into placement groups.

INSTANCE_FAMILY = instance_family_name

Identifies the type of machine you want to provision for the nodes in the compute pool. The machine type determines the amount of compute resources in the compute pool and, therefore, the number of credits consumed while the compute pool is running. For a list of available instance family names, see instance families.

INSTANCE_FAMILY can be altered only when a compute pool is fully suspended. Upon resuming, Snowflake uses the new instance type to provision the compute pool.

COMMENT = 'string_literal'

Spécifie un commentaire pour le pool de calcul.

UNSET ...

Specifies one or more properties and/or parameters to unset for the compute pool, which resets them to the defaults. For more information, see CREATE COMPUTE POOL:

• AUTO_SUSPEND_SECS

• AUTO_RESUME

• PLACEMENT_GROUP: The placement group can only be unset when the compute pool is fully suspended.

• COMMENT

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

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

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

The following example sets the « CPU_X64_S » as the INSTANCE_FAMILTY for a compute pool. Because the compute pool must be stopped to change the instance family, the compute pool is first suspended:

ALTER COMPUTE POOL tutorial_compute_pool SUSPEND;
ALTER COMPUTE POOL tutorial_compute_pool SET
  INSTANCE_FAMILY = CPU_X64_S;
ALTER COMPUTE POOL tutorial_compute_pool RESUME;