ALTER WAREHOUSE¶

Syntaxe¶

ALTER WAREHOUSE [ IF EXISTS ] [ <name> ] { SUSPEND | RESUME [ IF SUSPENDED ] }

ALTER WAREHOUSE [ IF EXISTS ] [ <name> ] ABORT ALL QUERIES

ALTER WAREHOUSE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER WAREHOUSE [ IF EXISTS ] <name> SET [ objectProperties ]
                                         [ objectParams ]

ALTER WAREHOUSE [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER WAREHOUSE [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER WAREHOUSE [ IF EXISTS ] <name> UNSET { <property_name> | <param_name> } [ , ... ]

Où :

objectProperties ::=
  WAREHOUSE_TYPE = { STANDARD | 'SNOWPARK-OPTIMIZED' }
  WAREHOUSE_SIZE = { XSMALL | SMALL | MEDIUM | LARGE | XLARGE | XXLARGE | XXXLARGE | X4LARGE | X5LARGE | X6LARGE }
  RESOURCE_CONSTRAINT = { STANDARD_GEN_1 | STANDARD_GEN_2 | MEMORY_1X | MEMORY_1X_x86 | MEMORY_16X | MEMORY_16X_x86 | MEMORY_64X | MEMORY_64X_x86 }
  WAIT_FOR_COMPLETION = { TRUE | FALSE }
  MAX_CLUSTER_COUNT = <num>
  MIN_CLUSTER_COUNT = <num>
  SCALING_POLICY = { STANDARD | ECONOMY }
  AUTO_SUSPEND = { <num> | NULL }
  AUTO_RESUME = { TRUE | FALSE }
  RESOURCE_MONITOR = <monitor_name>
  COMMENT = '<string_literal>'
  ENABLE_QUERY_ACCELERATION = { TRUE | FALSE }
  QUERY_ACCELERATION_MAX_SCALE_FACTOR = <num>

Copy

objectParams ::=
  MAX_CONCURRENCY_LEVEL = <num>
  STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num>
  STATEMENT_TIMEOUT_IN_SECONDS = <num>

Copy

Propriétés/Paramètres¶

name

Spécifie l’identifiant de l’entrepôt à 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.

Note

Un identifiant d’entrepôt est requis ou facultatif selon ce qui suit :

• Lors de la reprise ou de la suspension d’un entrepôt ou de l’annulation des requêtes d’un entrepôt, si un entrepôt est actuellement utilisé pour la session, l’identifiant peut être omis.

• Lors du renommage d’un entrepôt ou de toute autre opération sur un entrepôt, l’identifiant doit être spécifié.

{ SUSPEND | RESUME [ IF SUSPENDED ] }

Spécifie l’action à effectuer sur l’entrepôt :

• SUSPEND supprime tous les nœuds de calcul d’un entrepôt et place l’entrepôt dans un état ’Suspendu’.

• RESUME [ IF SUSPENDED ] amène un entrepôt suspendu à un état ’En cours’ utilisable en configurant des ressources de calcul.

  La clause IF SUSPENDED facultative spécifie si la commande ALTER WAREHOUSE se termine avec succès lors de la reprise d’un entrepôt déjà en cours d’exécution :

  • Si omise, la commande échoue et renvoie une erreur si l’entrepôt est déjà en cours d’exécution.

  • Si elle est spécifiée, la commande est exécutée avec succès, que l’entrepôt soit en cours d’exécution ou non.

ABORT ALL QUERIES

Annule toutes les requêtes en cours d’exécution ou en file d’attente sur l’entrepôt.

RENAME TO new_name

Indique un nouvel identifiant de l’entrepôt ; il doit être unique pour votre compte.

Pour plus de détails, voir Exigences relatives à l’identificateur.

SET ...

Spécifie un (ou plusieurs) paramètre(s)/propriété(s) à définir pour l’entrepôt (séparés par des espaces, des virgules ou de nouvelles lignes).

WAREHOUSE_TYPE = { STANDARD | 'SNOWPARK-OPTIMIZED' }

Spécifie le type d’entrepôt.

Valeurs valides:

• STANDARD, 'STANDARD'

• 'SNOWPARK-OPTIMIZED'

Par défaut:

STANDARD

Note

• Pour utiliser une valeur contenant un trait d’union ('SNOWPARK-OPTIMIZED'), vous devez la mettre entre guillemets simples, comme indiqué.

WAREHOUSE_SIZE = string_constant

Spécifie la taille de l’entrepôt virtuel. La taille détermine le nombre de ressources de calcul dans chaque cluster et, par conséquent, le nombre de crédits consommés pendant le fonctionnement de l’entrepôt.

Pour plus d’informations, voir Redimensionnement d’un entrepôt.

Valeurs valides:

• XSMALL , 'X-SMALL'

• SMALL

• MEDIUM

• LARGE

• XLARGE , 'X-LARGE'

• XXLARGE , X2LARGE , '2X-LARGE'

• XXXLARGE , X3LARGE , '3X-LARGE'

• X4LARGE , '4X-LARGE'

• X5LARGE , '5X-LARGE'

• X6LARGE , '6X-LARGE'

Par défaut:

XSMALL

Note

• La taille par défaut des entrepôts optimisés pour Snowpark est MEDIUM.

• Les tailles X5LARGE et X6LARGE pour les entrepôts optimisés par Snowpark ne sont pris en charge qu’avec la contrainte de ressource MEMORY_16X.

• Les tailles X5LARGE et X6LARGE ne sont pas prises en charge pour les entrepôts standard qui utilisent la contrainte de ressource STANDARD_GEN_2.

• Pour utiliser une valeur contenant un trait d’union (par exemple, '2X-LARGE'), vous devez la mettre entre guillemets simples, comme indiqué.

• Pour bloquer le renvoi immédiat d’un résultat par la commande ALTER WAREHOUSE jusqu’à ce que le redimensionnement soit terminé, ajoutez le paramètre WAIT_FOR_COMPLETION .

• La limite supérieure de la propriété MAX_CLUSTER_COUNT dépend de la taille de l’entrepôt. Lorsque vous modifiez WAREHOUSE_SIZE pour lui donner une valeur supérieure à MEDIUM, il se peut que vous deviez réduire MAX_CLUSTER_COUNT en même temps. Pour connaître la limite supérieure de MAX_CLUSTER_COUNT pour chaque taille d’entrepôt, voir Limite supérieure du nombre de clusters pour un entrepôt multicluster.

• Les entrepôts de tailles supérieures 5X-Large et 6X-Large sont généralement disponibles dans toutes les régions Amazon Web Services (AWS) et Microsoft Azure.

  Des entrepôts de tailles supérieures sont disponibles en avant-première dans les régions US (nécessite la prise en charge FIPS sur ARM).

RESOURCE_CONSTRAINT = { STANDARD_GEN_1 | STANDARD_GEN_2 | MEMORY_1X | MEMORY_1X_x86 | MEMORY_16X | MEMORY_16X_x86 | MEMORY_64X | MEMORY_64X_x86 }

Fonctionnalité en avant-première — Ouvrir

Les contraintes de ressources 1 TB (MEMORY_64X et MEMORY_64X_x86) sont disponibles en tant que fonctionnalité en aperçu. Les contraintes de ressources 1 TB sont disponibles uniquement sur la plateforme Cloud d’Amazon Web Services (AWS).

Toutes les autres tailles de contraintes de ressources MEMORY_* sont généralement disponibles et le sont pour toutes les plateformes Cloud.

Spécifie la mémoire et l’architecture CPU pour les entrepôts optimisés par Snowpark, ou les capacités de génération 1 ou de génération 2 pour les entrepôts standard.

La table suivante inclut les valeurs valides pour la propriété, la mémoire disponible, CPU l’architecture, et la taille minimale de l’entrepôt requise pour le resource_constraint paramètre. Pour plus d’informations sur les régions et les fournisseurs de services Cloud où les entrepôts standards de génération 2 sont disponibles, voir Entrepôts standard de génération 2 de Snowflake.

Valeurs valides:

Valeur	Mémoire (jusqu’à)	Architecture CPU	Taille minimale d’entrepôt requise	Taille maximale d’entrepôt
STANDARD_GEN_1	16 GB	Standard	XSMALL	X6LARGE
STANDARD_GEN_2	16 GB	Standard (génération 2)	XSMALL	X4LARGE
MEMORY_1X	16 GB	Standard	XSMALL	X4LARGE
MEMORY_1X_x86	16 GB	x86	XSMALL	X4LARGE
MEMORY_16X	256 GB	Standard	MEDIUM	X6LARGE
MEMORY_16X_x86	256 GB	x86	MEDIUM	X4LARGE
MEMORY_64X	1 TB	Standard	LARGE	X4LARGE
MEMORY_64X_x86	1 TB	x86	LARGE	X4LARGE

Valeur par défaut:

MEMORY_16X pour les entrepôts optimisés par Snowpark. STANDARD_GEN_1 pour les entrepôts standards.

WAIT_FOR_COMPLETION = { TRUE | FALSE }

Lors du redimensionnement d’un entrepôt, vous pouvez utiliser ce paramètre pour bloquer le renvoi d’une valeur par la commande ALTER WAREHOUSE jusqu’à ce que le redimensionnement ait fini de provisionner toutes ses ressources de calcul. Ce blocage du retour de la commande lors du redimensionnement d’un entrepôt plus grand sert à vous informer que vos ressources de calcul ont été entièrement provisionnées et que l’entrepôt est maintenant prêt à exécuter des requêtes en utilisant toutes les nouvelles ressources.

Valeurs valides:

• TRUE : la commande ALTER WAREHOUSE se bloque jusqu’à la fin du redimensionnement de l’entrepôt.

• FALSE : la commande ALTER WAREHOUSE renvoie immédiatement une valeur, avant la fin du redimensionnement de l’entrepôt.

Par défaut:

FALSE

Note

• La valeur de ce paramètre n’est pas conservée et doit être définie sur TRUE à chaque exécution si vous voulez que le redimensionnement de l’entrepôt soit terminé avant le renvoi d’une valeur par cette commande.

• Si elle est définie sur TRUE et que vous interrompez la commande ALTER WAREHOUSE, seule l’attente est interrompue et le redimensionnement de l’entrepôt sera effectué. Pour redonner à l’entrepôt sa taille d’origine, vous devrez exécuter une autre commande ALTER WAREHOUSE.

• Ce paramètre doit être utilisé avec le paramètre WAREHOUSE_SIZE, sinon une exception sera levée.

MAX_CLUSTER_COUNT = num

Spécifie le nombre maximum de clusters pour un entrepôt multi-clusters. Pour un entrepôt à un seul cluster, cette valeur est toujours 1.

Valeurs valides:

1 à une limite supérieure qui varie en fonction de la taille de l’entrepôt.

Notez que spécifier une valeur supérieure à 1 indique que l’entrepôt est un entrepôt multi-clusters ; cependant, la valeur ne peut être définie que sur une valeur supérieure dans Snowflake Enterprise Edition (ou supérieure).

• La limite supérieure de la propriété MAX_CLUSTER_COUNT dépend de la taille de l’entrepôt. Lorsque vous modifiez WAREHOUSE_SIZE pour lui donner une valeur supérieure à MEDIUM, il se peut que vous deviez réduire MAX_CLUSTER_COUNT en même temps. Pour connaître la limite supérieure de MAX_CLUSTER_COUNT pour chaque taille d’entrepôt, voir Limite supérieure du nombre de clusters pour un entrepôt multicluster.

Pour plus d’informations sur les entrepôts à clusters multiples, voir Entrepôts multi-clusters.

Par défaut:

1 (entrepôt à un seul cluster)

Astuce

Pour Snowflake Enterprise Edition (ou une version supérieure), nous recommandons de toujours régler la valeur supérieure à 1 pour aider à maintenir la haute disponibilité et la performance optimale de l’entrepôt (multi-clusters). Cela permet également d’assurer la continuité dans l’éventualité peu probable d’une défaillance de cluster.

MIN_CLUSTER_COUNT = num

Spécifie le nombre minimum de clusters pour un entrepôt multi-clusters.

Valeurs valides:

1 à la valeur de MAX_CLUSTER_COUNT. La limite supérieure de MAX_CLUSTER_COUNT varie en fonction de la taille de l’entrepôt.

MIN_CLUSTER_COUNT doit être égal ou inférieur à MAX_CLUSTER_COUNT :

• Si les deux paramètres sont égaux, l’entrepôt fonctionne en mode maximisé.

• Si MIN_CLUSTER_COUNT est inférieur à MAX_CLUSTER_COUNT, l’entrepôt fonctionne en mode Mise à l’échelle automatique.

Pour plus d’informations, y compris la limite supérieure pour chaque taille d’entrepôt, voir Entrepôts multi-clusters.

Par défaut:

1

SCALING_POLICY = { STANDARD | ECONOMY }

Paramètre d’objet qui spécifie la politique de démarrage et d’arrêt automatiques des clusters dans un entrepôt multi-clusters fonctionnant en mode « Mise à l’échelle automatique ».

Pour une description détaillée de ce paramètre, voir Définition de la politique de mise à l’échelle d’un entrepôt multi-clusters.

AUTO_SUSPEND = { num | NULL }

Indique le nombre de secondes d’inactivité après lesquelles un entrepôt est automatiquement suspendu.

Valeurs valides:

Tout nombre entier 0 ou supérieur, ou NULL :

• Le processus en arrière-plan qui suspend un entrepôt s’exécute environ toutes les 30 secondes. Par conséquent, le paramètre de cette propriété n’est pas destiné à permettre un contrôle précis de la suspension d’entrepôt.

• La définition d’une valeur inférieure à 30 ou d’une valeur qui n’est pas un multiple de 30 est autorisée, mais il se peut qu’elle n’entraîne pas le comportement prévu en raison de l’intervalle d’interrogation de 30 secondes pour la suspension d’entrepôt.

• La définition d’une valeur 0 ou NULL signifie que l’entrepôt n’est jamais suspendu.

Par défaut:

600 (l’entrepôt est automatiquement suspendu après 10 minutes d’inactivité)

Important

Définir la valeur AUTO_SUSPEND sur 0 ou NULL n’est pas recommandé à moins que vos charges de travail de requête nécessitent un entrepôt en cours d’exécution continue. Notez que cela peut entraîner une consommation importante de crédit (et des frais correspondants), en particulier pour les grands entrepôts.

Pour plus de détails, voir Considérations relatives aux entrepôts.

AUTO_RESUME = { TRUE | FALSE }

Indique s’il faut reprendre automatiquement un entrepôt lorsqu’une instruction (par exemple, une requête) SQL lui est soumise. Si cette valeur est définie sur FALSE, l’entrepôt ne redémarre que lorsqu’il est explicitement repris en utilisant ALTER WAREHOUSE ou via l’interface Web de Snowflake.

Valeurs valides:

• TRUE : l’entrepôt reprend lorsqu’une nouvelle requête est soumise.

• FALSE : l’entrepôt ne reprend que lorsqu’il est explicitement repris en utilisant ALTER WAREHOUSE ou via l’interface Web de Snowflake.

Par défaut:

TRUE (l’entrepôt reprend automatiquement lorsqu’une instruction SQL lui est soumise)

INITIALLY_SUSPENDED = { TRUE | FALSE }

Non applicable lors de la modification d’un entrepôt

RESOURCE_MONITOR = monitor_name

Indique l’identificateur d’un moniteur de ressources explicitement affecté à l’entrepôt. Lorsqu’un moniteur de ressources est explicitement affecté à un entrepôt, il contrôle les crédits mensuels utilisés par l’entrepôt (et tous les autres entrepôts auxquels le moniteur est affecté).

Valeurs valides:

Tout moniteur de ressources existant.

Pour plus de détails, voir Utilisation de moniteurs de ressources.

Par défaut:

Aucune valeur (aucun moniteur de ressources affecté à l’entrepôt)

Astuce

Pour afficher tous les moniteurs de ressources et leurs identificateurs, utilisez la commande SHOW RESOURCE MONITORS.

COMMENT = 'string_literal'

Ajoute un commentaire ou remplace un commentaire existant pour l’entrepôt.

MAX_CONCURRENCY_LEVEL = num

Paramètre d’objet qui spécifie le niveau de simultanéité des instructions SQL (requêtes et DML) exécutées par un cluster d’entrepôts. Lorsque le niveau est atteint :

• Pour un entrepôt à un seul cluster ou un entrepôt à plusieurs clusters (en mode maximisé), des instructions supplémentaires sont mises en file d’attente jusqu’à ce que des ressources soient disponibles.

• Pour un entrepôt multi-clusters (en mode « Mise à l’échelle automatique »), des clusters supplémentaires sont démarrés.

Ce paramètre peut être utilisé conjointement avec le paramètre STATEMENT_QUEUED_TIMEOUT_IN_SECONDS pour s’assurer qu’un entrepôt n’est jamais en attente.

Pour une description détaillée de ce paramètre, voir MAX_CONCURRENCY_LEVEL.

STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = num

Paramètre objet qui spécifie le temps, en secondes, pendant lequel une instruction SQL (requête, DDL, DML, etc.) peut être mise en file d’attente sur un entrepôt avant qu’elle soit annulée par le système.

Ce paramètre peut être utilisé conjointement avec le paramètre MAX_CONCURRENCY_LEVEL pour s’assurer qu’un entrepôt n’est jamais en attente.

Pour une description détaillée de ce paramètre, voir STATEMENT_QUEUED_TIMEOUT_IN_SECONDS.

STATEMENT_TIMEOUT_IN_SECONDS = num

Paramètre objet qui spécifie le temps, en secondes, au bout duquel une instruction SQL en cours d’exécution (requête, DDL, DML, etc.) est annulée par le système.

Pour une description détaillée de ce paramètre, voir STATEMENT_TIMEOUT_IN_SECONDS.

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 Quota de balise pour les objets.

ENABLE_QUERY_ACCELERATION = { TRUE | FALSE }

Indique s’il faut activer le service d’accélération des requêtes pour les requêtes qui dépendent de cet entrepôt pour les ressources de calcul.

Fonctionnalité Enterprise Edition

Query Acceleration Service nécessite Enterprise Edition (ou une édition supérieure). Pour en savoir plus sur la mise à niveau, veuillez contacter le support Snowflake.

Valeurs valides:

• TRUE active Query Acceleration

• FALSE désactive Query Acceleration

Par défaut:

FALSE : Query Acceleration est désactivé

QUERY_ACCELERATION_MAX_SCALE_FACTOR = num

Spécifie le facteur d’échelle maximum pour la location de ressources informatiques pour l’accélération des requêtes. Le facteur d’échelle est utilisé comme un multiplicateur basé sur la taille de l’entrepôt.

En définissant la valeur QUERY_ACCELERATION_MAX_SCALE_FACTOR à 0, on élimine la limite et on permet aux requêtes de louer autant de ressources que nécessaire et autant de ressources que disponibles pour traiter la requête.

Quelle que soit la valeur de QUERY_ACCELERATION_MAX_SCALE_FACTOR, la quantité de ressources informatiques disponibles pour l’accélération des requêtes est limitée par les ressources disponibles dans le service et le nombre d’autres requêtes simultanées. Pour plus de détails, reportez-vous à Ajustement du facteur d’échelle.

Valeurs valides:

De 0 jusqu’à 100

Par défaut:

8

UNSET ...

Spécifie une (ou plusieurs) propriété(s) et/ou paramètres à désactiver pour la base de données, qui les réinitialise aux valeurs par défaut :

• property_name

• param_name

  • TAG tag_name [ , tag_name ... ]

Vous pouvez réinitialiser plusieurs propriétés/paramètres avec une seule instruction ALTER ; cependant, chaque propriété/paramètre doit être séparé(e) par une virgule. De plus, lorsque vous réinitialisez une propriété/un paramètre, vous ne spécifiez que le nom ; aucune valeur n’est requise.

Note

UNSET peut être utilisé pour annuler toutes les propriétés et tous les paramètres d’un entrepôt, excepté WAREHOUSE_SIZE, qui ne peut être modifié qu’avec SET.

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

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

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¶

• Un entrepôt n’a pas besoin d’être suspendu pour définir ou modifier ses propriétés, sauf son type.

• Pour changer le type d’entrepôt, l’entrepôt doit être dans l’état suspended. Exécutez l’instruction suivante pour suspendre un entrepôt :

  ALTER WAREHOUSE mywh SUSPEND;
  

  Copy

• Lorsque la taille de l’entrepôt est modifiée, la modification n’a aucune incidence sur les instructions, y compris les requêtes, qui sont en cours d’exécution. Une fois les instructions terminées et les ressources de calcul entièrement provisionnées, la nouvelle taille est utilisée pour toutes les instructions suivantes.

• La suspension d’un entrepôt n’annule pas les requêtes en cours de traitement par l’entrepôt au moment où il est suspendu. Au lieu de cela, l’entrepôt termine les requêtes, puis éteint les ressources de calcul utilisées pour les traiter. Pendant cette période, l’entrepôt est en mode quiescing. Lorsque toutes les ressources de calcul sont éteintes, le statut de l’entrepôt devient « Suspendu ».

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

• La reprise d’un entrepôt virtuel optimisé pour Snowpark peut prendre plus de temps que celle d’un entrepôt standard.

• Les entrepôts optimisés par Snowpark ne prennent pas en charge l”accélération des requêtes.

• La spécification de la clause IF EXISTS exige que le rôle utilisé ou un rôle dans la hiérarchie des rôles actifs ait les privilèges d’entrepôt appropriés sur l’entrepôt.

Facturation et tarification¶

Pour obtenir des informations sur la consommation de crédits de l’entrepôt optimisé par Snowpark, voir Table 1(a): Snowflake Credit Table for Virtual Warehouse Services dans la table Snowflake Service Consumption Table.

Exemples¶

Renommez l’entrepôt wh1 en wh2 :

ALTER WAREHOUSE IF EXISTS wh1 RENAME TO wh2;

Reprenez un entrepôt nommé my_wh puis modifiez la taille de l’entrepôt pendant qu’il est en cours d’exécution :

ALTER WAREHOUSE my_wh RESUME;

ALTER WAREHOUSE my_wh SET warehouse_size=MEDIUM;

Modifier les ressources mémoire à 256 GB et définir l’architecture CPU à x86 pour l’entrepôt optimisé par Snowpark so_warehouse :

ALTER WAREHOUSE so_warehouse SET
  RESOURCE_CONSTRAINT = 'MEMORY_16X_x86';