Utilisation de moniteurs de ressources¶

Propriétés du moniteur de ressources¶

Un moniteur de ressources est un objet de première classe dans Snowflake composé des propriétés suivantes.

Affectation de moniteurs de ressources¶

Un simple moniteur peut également être paramétré au niveau du compte pour contrôler l’utilisation des crédits pour tous les entrepôts de votre compte.

En outre, un ou plusieurs entrepôts peuvent être affectés à un moniteur de ressources, qui contrôle ainsi l’utilisation du crédit pour chaque entrepôt qui lui est affecté. Notez toutefois qu’un entrepôt ne peut être affecté qu’à un seul moniteur de ressources en dessous du niveau du compte.

Le diagramme suivant illustre un scénario dans lequel un moniteur de ressources est défini au niveau du compte et des entrepôts individuels sont affectés à deux autres moniteurs de ressources :

Sur la base de ce diagramme :

• Le quota de crédit pour l’ensemble du compte est de 5 000 pour l’intervalle (mois, semaine, etc.), tel que contrôlé par le Moniteur de ressources 1 ; si ce quota est atteint dans l’intervalle, les actions définies pour le moniteur de ressources (Suspendre, Suspendre immédiatement, etc.) sont appliquées pour les cinq entrepôts.

• L’entrepôt 3 peut consommer un maximum de 1 000 crédits par intervalle.

• Les entrepôts 4 et 5 peuvent consommer un total combiné maximum de 2 500 crédits pour l’intervalle.

Attention, les crédits réels consommés par les entrepôts 3, 4 et 5 peuvent être inférieurs à leurs quotas si le quota du compte est atteint en premier.

Suspension et reprise de l’entrepôt¶

Les crédits utilisés pour un moniteur de ressources reflètent la somme des crédits consommés par tous les entrepôts affectés dans l’intervalle spécifié, ainsi que les services Cloud utilisés pour prendre en charge ces entrepôts pendant le même intervalle. Si une action Suspendre ou Suspendre immédiatement est définie sur un moniteur et que ses crédits utilisés atteignent le seuil, les entrepôts affectés au moniteur sont suspendus et ne peuvent pas être repris tant qu’une des conditions suivantes n’est pas remplie :

• Le cas échéant, l’intervalle suivant commence, en fonction de la date de début du moniteur.

• Le quota de crédit du moniteur est augmenté.

• Le seuil de crédit pour l’action de suspension est augmenté.

• Les entrepôts ne sont plus affectés au moniteur.

• Le moniteur est détruit.

Notifications du moniteur de ressources¶

Lorsqu’un moniteur de ressources atteint le seuil d’une action, il génère l’une des notifications suivantes, en fonction de l’action effectuée :

• Les entrepôts affectés seront suspendus une fois toutes les requêtes en cours terminées.

• Toutes les requêtes en cours d’exécution dans les entrepôts assignés seront annulées et les entrepôts suspendus immédiatement.

• Un seuil a été atteint, mais aucune action n’a été effectuée.

La notification est envoyée à tous les administrateurs de comptes qui ont activé la réception des notifications et à tous les utilisateurs non-administrateurs de la liste de notifications d’un moniteur d’entrepôts. Les utilisateurs non-administrateurs ne peuvent pas être ajoutés à la liste de notifications d’un moniteur de compte.

DDL des moniteurs de ressources¶

Snowflake fournit les commandes DDL suivantes pour créer et utiliser/gérer les moniteurs de ressources :

• CREATE RESOURCE MONITOR

• ALTER RESOURCE MONITOR

• SHOW RESOURCE MONITORS

• DROP RESOURCE MONITOR

En outre, les commandes DDL suivantes peuvent être utilisées pour affecter un moniteur de ressources à un entrepôt, et voir si un entrepôt est affecté à un moniteur :

• CREATE WAREHOUSE ou ALTER WAREHOUSE

• SHOW WAREHOUSES

Privilèges de contrôle d’accès des moniteurs de ressources¶

Par défaut, les moniteurs de ressources ne peuvent être créés que par les administrateurs de compte et ne peuvent donc être consultés et gérés que par ces personnes.

Cependant, les rôles qui ont reçu les privilèges suivants sur des moniteurs de ressources spécifiques peuvent visualiser et modifier le moniteur de ressources selon les besoins en utilisant SQL :

• MONITOR

• MODIFY

Pour plus d’informations, voir Privilèges de contrôle d’accès et GRANT <privilèges>.

Notez que seuls les administrateurs de comptes peuvent visualiser et gérer les moniteurs de ressources via l”Classic Console.

Activation de la réception de notifications¶

Avant de pouvoir recevoir des notifications des moniteurs de ressources, vous devez activer les notifications dans l’interface Web et vérifier votre adresse e-mail.

Snowsight:

Pour activer les notifications, procédez comme suit :

1. Vérifiez votre adresse e-mail, si vous ne l’avez pas encore fait. Pour savoir comment vérifier votre adresse e-mail, voir Vérifier votre adresse e-mail.

2. Sélectionnez votre nom d’utilisateur, puis sélectionnez Profile

3. Pour Notifications, sélectionnez Enable notifications from resource monitors.

   Note

   • Si vous n’avez pas vérifié votre adresse e-mail, l’option Notifications n’est pas disponible tant que vous ne l’avez pas fait.

   • Dans Notifications, l’option Enable notifications from resource monitors n’est accessible qu’aux utilisateurs ayant le rôle ACCOUNTADMIN.

Classic Console:

Pour activer les notifications, procédez comme suit :

1. Vérifiez votre adresse e-mail, si vous ne l’avez pas encore fait. Pour savoir comment vérifier votre adresse e-mail, voir Vérification de votre adresse e-mail dans la console classique.

2. Sélectionnez le menu déroulant à côté de votre nom dans le coin supérieur droit, puis sélectionnez Preferences » Notifications.

3. Sélectionnez l’une des options.

Création de moniteurs de ressources¶

Les moniteurs de ressources peuvent être créés via l’interface Web ou SQL ; cependant, seuls les administrateurs de compte (c’est-à-dire les utilisateurs dotés du rôle ACCOUNTADMIN) peuvent créer des moniteurs de ressources.

Modification d’un moniteur de ressources¶

Vous pouvez modifier les propriétés suivantes pour un moniteur de ressources existant :

• Augmentez ou diminuez le quota de crédit du moniteur.

• Personnalisez la planification (fréquence, horodatage de début et horodatage de fin) du moniteur.

• Ajoutez ou supprimez des actions, ou modifiez les pourcentages de seuil pour les actions existantes.

• Si le moniteur surveille votre compte, convertissez-le pour surveiller des entrepôts individuels.

• Si le moniteur surveille des entrepôts individuels :

  • Ajoutez ou supprimez des entrepôts de la liste.

  • Convertissez-le pour surveiller votre compte.

Les moniteurs de ressources peuvent être modifiés via l’interface Web ou SQL.

Snowsight:

Note

Vous ne pouvez pas utiliser Snowsight pour remplacer le type de moniteur de ressources qui surveille un entrepôt par un type qui surveille un compte. Utilisez plutôt SQL. Voir l”exemple à la section SQL.

1. Connectez-vous à Snowsight et naviguez jusqu’à Admin » Cost Management.

2. Sélectionnez Resource Monitors, puis sélectionnez un moniteur de ressources.

3. Sélectionnez le menu More (…) dans le coin supérieur droit. Sélectionnez Edit.

Classic Console:

1. Sélectionnez Account » Resource Monitors.

2. Sélectionnez un moniteur de ressources.

3. Sélectionnez Edit.

SQL:

• Pour modifier le quota, personnaliser la planification ou ajouter/supprimer/modifier des actions, exécutez une instruction ALTER RESOURCE MONITOR.

  Par exemple, pour augmenter le quota de crédit du moniteur de ressources limit1 jusqu’à 3000, exécutez l’instruction suivante :

  ALTER RESOURCE MONITOR limit1 SET CREDIT_QUOTA=3000;
  

  Copy

  Pour plus d’exemples, voir Exemples.

• Pour modifier le type de moniteur, exécutez une instruction ALTER WAREHOUSE ou ALTER ACCOUNT.

  Par exemple, pour modifier le moniteur de ressources my_rm, qui surveille actuellement des entrepôts, afin qu’il surveille le compte my_account, procédez comme suit :

  1. Recherchez tous les entrepôts que le moniteur de ressources my_rm surveille. Vérifiez si la colonne resource_monitor contient my_rm :

     SHOW WAREHOUSES;
     

     Copy

     Renvoie les résultats suivants :

     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     | name   | state     | type     | size    | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on                    | resumed_on                    | updated_on                    | owner        | comment | resource_monitor | actives | pendings | failed | suspended | uuid       | budget | owner_role_type |
     |--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------|
     | MY_WH1 | STARTED   | STANDARD | X-Small |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:37:36.223 -0800 | 2024-01-17 14:37:36.325 -0800 | 2024-01-17 14:47:49.854 -0800 | MY_ROLE      |         | null             |       0 |        0 |      0 |         1 | 1222706972 | NULL   | ROLE            |
     | MY_WH2 | SUSPENDED | STANDARD | X-Small |       0 |      0 | N          | Y          |          600 | true        |           |              |           |       | 2023-12-20 13:50:50.972 -0800 | 2024-01-17 14:28:39.170 -0800 | 2024-01-17 14:37:57.560 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         1 | 1222706948 | NULL   | ROLE            |
     | MY_WH3 | SUSPENDED | STANDARD | Small   |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:26:26.911 -0800 | 2024-01-17 14:33:39.260 -0800 | 2024-01-17 14:38:31.192 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         2 | 1222706960 | NULL   | ROLE            |
     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     

     Le moniteur de ressources my_rm surveille deux entrepôts my_wh2 et my_wh3.

  2. Supprimez le moniteur de ressources pour les deux entrepôts en exécutant les instructions suivantes :

     ALTER WAREHOUSE my_wh2 UNSET RESOURCE_MONITOR;
     
     ALTER WAREHOUSE my_wh3 UNSET RESOURCE_MONITOR;
     

     Copy

  3. Modifiez le moniteur de ressources de sorte qu’il surveille le compte en exécutant l’instruction suivante :

     ALTER ACCOUNT my_account SET RESOURCE_MONITOR = my_rm;
     

     Copy

Envoi de notifications du moniteur de ressources à des utilisateurs non-administrateurs¶

Les utilisateurs non-administrateurs peuvent recevoir des notifications par e-mail de la part des moniteurs de ressources qui surveillent les entrepôts. Chaque utilisateur non-administrateur doit disposer d’une adresse e-mail vérifiée. Vous pouvez ajouter jusqu’à cinq utilisateurs non-administrateurs à un moniteur d’entrepôt via la commande CREATE RESOURCE MONITOR ou ALTER RESOURCE MONITOR.

Par exemple, pour ajouter les utilisateurs user1 et user2 au moniteur d’entrepôt my_warehouse_rm, exécutez l’instruction suivante :

ALTER RESOURCE MONITOR my_warehouse_rm
  SET NOTIFY_USERS = (USER1, USER2);

Pour plus d’informations, voir les paramètres NOTIFY_USERS, et Notes sur l’utilisation dans le chapitre ALTER RESOURCE MONITOR.

Pour ajouter des utilisateurs non-administrateurs à la liste de notifications d’un moniteur de ressources lorsque vous créez un moniteur de ressources à l’aide de SQL, voir CREATE RESOURCE MONITOR.

Configuration d’un moniteur de ressources pour votre compte¶

Un moniteur de ressources peut être défini pour votre compte via l’interface Web ou SQL.

Snowsight:

Vous pouvez définir le type de moniteur sur compte lorsque vous créez un moniteur de ressources. Pour plus d’informations, voir Création de moniteurs de ressources.

Vous ne pouvez pas utiliser Snowsight pour remplacer le type de moniteur de ressources qui surveille un entrepôt par un type qui surveille un compte. Utilisez plutôt SQL. Voir l”exemple à la section SQL.

Classic Console:

Vous pouvez définir le type de moniteur sur Account lorsque vous créez ou modifiez un moniteur de ressources :

• Pour plus d’informations sur la création d’un moniteur de ressources, voir Création de moniteurs de ressources.

• Pour plus d’informations sur la modification d’un moniteur de ressources, voir Modification d’un moniteur de ressources.

SQL:

Dans SQL, cette tâche est effectuée en deux étapes :

1. Utilisez la commande CREATE RESOURCE MONITOR pour créer le moniteur de ressources (s’il n’existe pas déjà).

   Si le moniteur de ressources existe, pour modifier un moniteur de ressources au niveau de l’entrepôt afin qu’il surveille un compte, voir l’exemple à la section Modification d’un moniteur de ressources.

2. Utilisez la commande ALTER ACCOUNT pour définir le moniteur de ressources que vous avez créé comme moniteur pour votre compte.

   Par exemple, pour définir le moniteur de ressources de compte sur my_account_rm, exécutez les instructions suivantes :

   USE ROLE ACCOUNTADMIN;
   
   CREATE RESOURCE MONITOR my_account_rm WITH CREDIT_QUOTA=10000
     TRIGGERS ON 100 PERCENT DO SUSPEND;
   
   ALTER ACCOUNT SET RESOURCE_MONITOR = my_account_rm;
   

   Copy

Pour remplacer le type de moniteur d’un moniteur de ressources existant qui surveille un entrepôt par un moniteur de compte, voir l’exemple à la section Modification d’un moniteur de ressources.

Pour voir si un moniteur de ressources est configuré pour votre compte, utilisez l’interface Web ou la commande SHOW RESOURCE MONITORS . La colonne LEVEL d’un moniteur de ressources indique s’il est défini pour votre compte ou pour des entrepôts individuels.

Affectation d’entrepôts à un moniteur de ressources¶

Les entrepôts peuvent être affectés à un moniteur de ressources existant via l’interface Web ou SQL.

Snowsight:

1. Connectez-vous à Snowsight et naviguez jusqu’à Admin » Cost Management.

2. Sélectionnez Resource Monitors, puis sélectionnez un moniteur de ressources.

3. Sélectionnez le menu More (…) dans le coin supérieur droit. Sélectionnez Edit.

4. Si Monitor Type est Account, sélectionnez Warehouse.

5. Sélectionnez Warehouse pour déterminer les entrepôts à surveiller.

Classic Console:

1. Sélectionnez Account » Resource Monitors.

2. Sélectionnez un moniteur de ressources.

3. Sélectionnez Edit.

4. Si le moniteur n’a pas encore d’entrepôts affectés, sélectionnez Monitor Level, puis Warehouse.

5. Sélectionnez Warehouse et déterminez les entrepôts à surveiller.

SQL:

Utilisez la commande ALTER WAREHOUSE pour affecter un entrepôt à un moniteur de ressources.

Par exemple, pour surveiller l’entrepôt my_wh avec le moniteur de ressources my_rm, exécutez l’instruction suivante :

ALTER WAREHOUSE my_wh SET RESOURCE_MONITOR = my_rm;

Copy

Affichage des moniteurs de ressources¶

Les moniteurs de ressources peuvent être affichés via l’interface Web ou SQL.

Snowsight:

1. Connectez-vous à Snowsight et naviguez jusqu’à Admin » Cost Management.

2. Sélectionnez Resource Monitors pour afficher la liste des moniteurs de ressources pour lesquels votre rôle a obtenu le privilège MODIFY ou MONITOR. Les utilisateurs administrateurs de comptes peuvent voir tous les moniteurs de ressources.

3. Sélectionnez un moniteur de ressources pour afficher des informations détaillées sur les paramètres du moniteur de ressources, l’utilisation du crédit actuelle et une liste des rôles disposant de privilèges sur le moniteur de ressources.

Classic Console:

Note

Seuls les utilisateurs ayant le rôle ACCOUNTADMIN peuvent afficher les moniteurs de ressources via Classic Console.

1. Sélectionnez Account » Resource Monitors.

SQL:

À l’aide du rôle ACCOUNTADMIN ou d’un rôle auquel le privilège MONITOR ou MODIFY a été accordé sur le moniteur de ressources, exécutez une instruction SHOW RESOURCE MONITORS.

En outre, avec n’importe quel rôle, vous pouvez exécuter une instruction SHOW WAREHOUSES pour afficher les entrepôts appartenant au rôle en question (ou pour lesquels le rôle a reçu un privilège USAGE). La sortie comprend le moniteur de ressources auquel l’entrepôt est affecté, le cas échéant.

Réplication de moniteurs de ressources¶

Les moniteurs de ressources peuvent être répliqués d’un compte source vers des comptes cibles à l’aide d’un groupe de réplication ou de basculement. Pour plus d’informations, voir Réplication de moniteurs de ressources.