Travailler avec des moniteurs de ressources

Pour aider à contrôler les coûts et éviter l’utilisation inattendue de crédits liée à l’exécution des entrepôts, Snowflake fournit des moniteurs de ressources. Un entrepôt virtuel consomme des crédits Snowflake pendant son fonctionnement.

Un moniteur de ressources peut être utilisé pour surveiller l’utilisation du crédit par les entrepôts virtuels et les services Cloud nécessaires pour prendre en charge ces entrepôts. Si vous le souhaitez, l’entrepôt peut être suspendu lorsqu’il atteint une limite de crédit.

Le nombre de crédits consommés dépend de la taille de l’entrepôt et de sa durée de fonctionnement.

Des limites peuvent être définies pour un intervalle ou une plage de dates précis. Lorsque ces limites sont proches et/ou atteintes, le moniteur de ressources peut déclencher diverses actions, telles que l’envoi de notifications d’alerte et/ou la suspension des entrepôts gérés par les utilisateurs.

Les moniteurs de ressources ne peuvent être créés que par les administrateurs de compte (c’est-à-dire les utilisateurs ayant le rôle ACCOUNTADMIN). Cependant, les administrateurs de compte peuvent choisir d’autoriser les utilisateurs ayant d’autres rôles à afficher et modifier les moniteurs de ressources à l’aide de SQL.

Dans ce chapitre :

Vue d’ensemble

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.

Quota de crédit

Le quota de crédit spécifie le nombre de crédits Snowflake alloués au moniteur pour l’intervalle de fréquence spécifié. Tout nombre peut être spécifié.

En outre, Snowflake suit les crédits/quotas utilisés dans l’intervalle de fréquence spécifié par tous les entrepôts affectés au moniteur. À l’intervalle spécifié, ce nombre est réinitialisé sur 0.

Les quotas de crédit représentent les crédits consommés à la fois par les entrepôts virtuels gérés par les utilisateurs et les entrepôts virtuels utilisés par les services Cloud.

Par exemple, votre limite de surveillance des ressources est fixée à 1 000 crédits, si votre entrepôt consomme 700 crédits et que les services Cloud consomment 300 crédits dans un intervalle ou une plage de dates spécifiés, une alerte sera déclenchée.

Note

Les limites du moniteur de ressources ne prennent pas en compte l’ajustement quotidien de 10 % pour les services Cloud. Snowflake utilise toute la consommation de crédit par la couche de services Cloud pour calculer si une limite a été atteinte, même si cette consommation n’est jamais facturée. Pour plus d’informations sur le calcul des crédits et des ajustements des services Cloud, voir Comprendre la facturation pour l’utilisation des services Cloud.

Pour obtenir des instructions sur la façon d’afficher l’utilisation de votre crédit de services Cloud, consultez Découverte des coûts de calcul.

Niveau de moniteur

Cette propriété spécifie si le moniteur de ressources est utilisé pour surveiller l’utilisation du crédit pour l’ensemble de votre compte (c’est-à-dire tous les entrepôts du compte) ou pour un ensemble spécifique d’entrepôts individuels.

Si cette propriété n’est pas définie, le moniteur de ressources ne surveille aucune utilisation de crédit. Il reste simplement en sommeil.

Planification

La planification par défaut pour un moniteur de ressources spécifie qu’il commence à surveiller l’utilisation du crédit immédiatement et que les crédits utilisés sont réinitialisés à 0 au début de chaque mois du calendrier (c’est-à-dire au début du cycle de facturation Snowflake standard).

Toutefois, vous pouvez éventuellement personnaliser la planification d’un moniteur de ressources à l’aide des propriétés suivantes :

Fréquence

Intervalle auquel les crédits utilisés sont réinitialisés relatif à la date de début spécifiée.

Valeurs prises en charge :

  • Quotidien

  • Hebdomadaire

  • Mensuelle

  • Annuelle

  • Jamais (les crédits utilisés ne sont jamais réinitialisés ; les entrepôts attribués continuent d’utiliser des crédits jusqu’à ce que le quota de crédit soit atteint)

Début

Date et heure (c’est-à-dire l’horodatage) auxquelles le moniteur de ressources commence à surveiller les entrepôts assignés.

Valeurs prises en charge :

  • Immédiatement (c’est-à-dire l’horodatage actuel)

  • Plus tard (c’est-à-dire tout horodatage futur)

De plus, Snowflake utilise cette date pour déterminer quand réinitialiser les crédits utilisés, en fonction de la fréquence spécifiée. Notez cependant que, quelle que soit l’heure spécifiée dans la date et l’heure de début, les moniteurs de ressources se réinitialisent à 12:00 AM UTC. Par exemple, si le début est 15-juillet-2019 (lundi) à 8:00 AM :

  • Fréquence = Mensuelle : les crédits utilisés sont réinitialisés à 12:00 AM UTC le 15e jour de chaque mois suivant.

  • Fréquence = Hebdomadaire : les crédits utilisés sont réinitialisés à 12:00 AM UTC chaque lundi suivant.

Notez que si vous spécifiez le dernier jour d’un mois comme date de début, Snowflake réinitialise les crédits utilisés le dernier jour de tous les mois suivants, quel que soit le nombre de jours de chaque mois. Par exemple, si vous définissez la date de début au 31 janvier, Snowflake réinitialise ensuite les crédits utilisés pour le moniteur de ressources au 28 février (ou 29 février dans une année bissextile), 31 mars, 30 avril, etc.

Fin

Date et heure (c.-à-d. horodatage) auxquelles Snowflake suspend les entrepôts associés au moniteur de ressources, que les crédits utilisés aient atteint ou non l’un des seuils définis pour les actions du moniteur de ressources (voir la section suivante dans ce chapitre).

Valeurs prises en charge : tout horodatage futur.

Notez que cette propriété n’est pas couramment utilisée.

Important

Si vous choisissez de personnaliser la planification d’un moniteur de ressources, la fréquence est relative à la date de début spécifiée, ce qui diffère de la planification par défaut.

De plus, si vous spécifiez une fréquence, vous devez également spécifier une date et une heure de début, et inversement (c.-à-d. que vous ne pouvez pas en définir un élément sans définir l’autre).

Actions

Également appelée déclencheurs, chaque action spécifie un seuil, sous forme de pourcentage du quota de crédit du moniteur de ressources, ainsi que l’action à exécuter lorsque le seuil est atteint dans l’intervalle spécifié. Notez que les actions prennent en charge des seuils supérieurs à 100.

Les moniteurs de ressources prennent en charge les actions suivantes :

Notifier et suspendre

Envoyer une notification (à tous les administrateurs de compte avec les notifications activées) et suspendre tous les entrepôts assignés une fois que toutes les instructions exécutées par les entrepôts sont terminées.

Avertir et suspendre immédiatement

Envoyer une notification (à tous les administrateurs de compte avec les notifications activées) et suspendre immédiatement tous les entrepôts assignés, ce qui annule toutes les instructions exécutées par les entrepôts à ce moment.

Notifier

N’effectuer aucune action, mais envoyer une notification d’alerte (à tous les administrateurs de compte avec les notifications activées).

Chaque moniteur de ressources peut avoir les actions suivantes :

  • Une action Suspendre.

  • Une action Suspendre immédiatement.

  • Jusqu’à cinq actions Notifier.

Note

Un moniteur de ressources doit avoir au moins une action définie. Si aucune action n’a été définie, rien ne se produit lorsque les crédits utilisés atteignent le seuil.

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 moniteur peut se voir affecter un ou plusieurs entrepôts, contrôlant ainsi l’utilisation des crédits 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 :

Warehouse and resource monitor relationships

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.

Important

  • Un moniteur des ressources au niveau du compte ne remplace pas l’affectation du moniteur des ressources pour des entrepôts individuels. Si le moniteur de ressources du compte ou le moniteur de ressources de l’entrepôt atteint son seuil défini et si une action de suspension a été définie, l’entrepôt est suspendu.

  • Un moniteur de ressources au niveau du compte ne contrôle pas l’utilisation du crédit par les ressources de calcul fournies par Snowflake pour les fonctionnalités sans serveur (par exemple, Snowpipe, le reclustering automatique et les vues matérialisées). Pour une liste complète des fonctionnalités, voir Fonctionnalités sans serveur.

  • Un moniteur de ressources au niveau de l’entrepôt peut surveiller, mais ne peut pas suspendre, l’utilisation du crédit par les services Cloud. Après la suspension d’un entrepôt virtuel, les requêtes ultérieures exécutées sur cet entrepôt peuvent encore entraîner des coûts supplémentaires liés aux services Cloud. Pour plus de détails sur l’utilisation du crédit pour les services Cloud, voir Utilisation du crédit des services Cloud.

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.

Astuce

Les moniteurs de ressources ne sont pas destinés à contrôler strictement la consommation sur une base horaire, ils sont destinés à suivre et à contrôler la consommation de crédits sur une base définie (ou « intervalle », comme quotidien, hebdomadaire, mensuel, etc.). En outre, ils ne sont pas destinés à fixer des limites précises sur l’utilisation du crédit (c’est-à-dire jusqu’au niveau des crédits individuels). Par exemple, lorsque les seuils de quota de crédit sont atteints pour un moniteur de ressources, les entrepôts affectés peuvent prendre un certain temps pour se mettre en pause, même lorsque l’action est Suspendre immédiatement, consommant ainsi des crédits supplémentaires.

Si vous souhaitez appliquer vos quotas de manière stricte, nous vous recommandons ce qui suit :

  • Utiliser des zones de marge dans les seuils de quota pour les actions (par exemple, fixer un seuil à 90 % au lieu de 100 %).

    Cela vous aidera à vous assurer que votre utilisation de crédit ne dépasse pas le quota.

  • Pour contrôler plus strictement l’utilisation du crédit pour des entrepôts individuels, affectez un seul entrepôt à chaque moniteur de ressources.

    Lorsque plusieurs entrepôts sont assignés au même moniteur de ressources, ils partagent les mêmes seuils de quota, ce qui peut entraîner une utilisation du crédit pour un entrepôt ayant une incidence sur les autres entrepôts affectés.

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 compte qui ont activé la réception des notifications et à tous les utilisateurs non-administrateurs dans la liste de notifications.

Important

Les notifications peuvent être reçues par les administrateurs de compte via l”Classic Console et/ou par e-mail. Cependant, les notifications sont par défaut désactivées :

  • Pour recevoir des notifications, chaque administrateur de compte doit explicitement activer les notifications via ses préférences dans l”Classic Console. Voir Activation de la réception des notifications pour les administrateurs de comptes.

  • De plus, si un administrateur de compte choisit de recevoir des notifications par e-mail, il doit fournir (et vérifier) une adresse e-mail valide avant de recevoir tout e-mail.

Les notifications pour les utilisateurs non-administrateurs sont uniquement disponibles par e-mail.

DDL pour les moniteurs de ressources

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

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 :

Privilèges de contrôle d’accès pour les 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 de détails, 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 des notifications pour les administrateurs de comptes

En tant qu’administrateur de compte, vous devez activer les notifications pour vous dans l”Classic Console avant de pouvoir recevoir les notifications générées par les moniteurs de ressources.

Avant de pouvoir activer les notifications par e-mail, vous devez vérifier votre adresse e-mail. Voir Vérification de votre adresse e-mail dans la console classique.

Pour activer les notifications dans l”Classic Console :

  1. Utilisez le rôle système ACCOUNTADMIN . Si ce n’est pas le cas, sélectionnez Switch role » ACCOUNTADMIN dans le menu déroulant à côté de votre nom dans le coin supérieur droit.

  2. Dans le même menu déroulant, 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.

Important

Vous devez assigner au moins un entrepôt à un moniteur de ressources ou définir le moniteur au niveau du compte pour qu’il commence à surveiller/suivre l’utilisation du crédit :

  • Dans l’interface Web, vous devez le faire au moment de la création.

  • Dans SQL, vous devez d’abord créer le moniteur de ressources, puis lui affecter un ou plusieurs entrepôts en exécutant la requête ALTER WAREHOUSE au cours d’une étape distincte.

De plus, pour recevoir des notifications lorsque des actions de moniteur de ressources sont déclenchées, vous devez activer les notifications.

Création d’un moniteur de ressources avec une planification par défaut

Pour créer un moniteur de ressources qui utilise la planification par défaut (c.-à-d. qui commence la surveillance immédiatement et qui est réinitialisé le premier jour de chaque mois du calendrier) :

Classic Console
  1. Utilisez le rôle système ACCOUNTADMIN .

  2. Cliquez sur Account Account tab » Resource Monitors » Create Resource Monitor.

  3. Entrez un nom et un quota.

  4. Indiquez si le moniteur des ressources sera utilisé pour le suivi de votre compte ou d’entrepôts individuels.

  5. Entrez un seuil pour au moins une des actions de suspension. Vous pouvez également spécifier jusqu’à cinq actions de notification qui envoient simplement des alertes sans suspendre aucun entrepôt.

SQL

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

  1. Exécutez une commande CREATE RESOURCE MONITOR, mais ne spécifiez aucune propriété de planification.

  2. Exécutez une commande ALTER WAREHOUSE pour affecter des entrepôts au moniteur de ressources ou une commande ALTER ACCOUNT pour définir le moniteur de ressources du compte.

Par exemple :

  • Pour créer un moniteur qui commence la surveillance immédiatement, se réinitialise au début de chaque mois et suspend l’entrepôt affecté lorsque les crédits utilisés atteignent 100 % du quota de crédit, procédez comme suit :

    USE ROLE ACCOUNTADMIN;
    
    CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
      TRIGGERS ON 100 PERCENT DO SUSPEND;
    
    ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
    
    Copy

    L’action SUSPEND attend que les requêtes en cours d’exécution soient terminées avant de suspendre l’entrepôt. Cela signifie qu’une requête a démarré avant que les feux de déclenchement n’aboutissent, et que l’entrepôt consomme des crédits même après que le quota a été atteint.

  • Pour créer un moniteur similaire au premier exemple, mais qui suspend l’entrepôt à 90 % et le suspend immédiatement à 100 % pour empêcher tous les entrepôts du compte de consommer des crédits une fois le quota atteint, procédez comme suit :

    USE ROLE ACCOUNTADMIN;
    
    CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
      TRIGGERS ON 90 PERCENT DO SUSPEND
               ON 100 PERCENT DO SUSPEND_IMMEDIATE;
    
    ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
    
    Copy

    Dans cet exemple, une notification est générée et les entrepôts affectés sont suspendus lorsque 90 % de leur utilisation est atteinte, ce qui empêche les entrepôts d’exécuter de nouvelles requêtes, mais permet de terminer les requêtes en cours. Si les entrepôts affectés atteignent 100 % d’utilisation, une notification est générée et les entrepôts sont immédiatement suspendus, annulant toutes les requêtes en cours d’exécution.

  • Pour créer un moniteur similaire au premier exemple, mais qui laisse l’entrepôt affecté dépasser de 10 % le quota et inclut également deux actions de notification pour alerter les administrateurs du compte lorsque les crédits utilisés atteignent la moitié autorisée et les trois quarts du quota, procédez comme suit :

    USE ROLE ACCOUNTADMIN;
    
    CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
       TRIGGERS ON 50 PERCENT DO NOTIFY
                ON 75 PERCENT DO NOTIFY
                ON 100 PERCENT DO SUSPEND
                ON 110 PERCENT DO SUSPEND_IMMEDIATE;
    
    ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
    
    Copy

    Dans cet exemple :

    • Lorsque 50 % et 75 % d’utilisation sont atteints, une notification d’alerte est envoyée à tous les administrateurs de compte qui ont activé les notifications, mais aucune autre action n’est effectuée.

    • Lorsque 100 % d’utilisation est atteint, l’entrepôt affecté est suspendu.

    • Si l’entrepôt est toujours en cours d’exécution lorsque une utilisation à 110 % est atteinte, il est immédiatement suspendu.

Création d’un moniteur de ressources avec une planification personnalisée

Pour créer un moniteur de ressources utilisant une planification différente de celle par défaut :

Classic Console
  1. Utilisez le rôle système ACCOUNTADMIN .

  2. Cliquez sur Account Account tab » Resource Monitors » Create Resource Monitor.

  3. Entrez un nom et un quota.

  4. Indiquez si le moniteur des ressources sera utilisé pour le suivi de votre compte ou d’entrepôts individuels.

  5. Dans le champ Schedule, cliquez sur le lien Customize et spécifiez une ou plusieurs des propriétés suivantes, comme vous le souhaitez :

    • Réinitialisez les crédits utilisés en fonction de la fréquence spécifiée.

    • Commencez à surveiller l’utilisation du crédit immédiatement ou à une date et une heure ultérieures.

    • Suspendez les entrepôts à la date et l’heure de fin spécifiées, que le seuil de quota de crédit ait été atteint ou non.

  6. Entrez un seuil pour au moins une des actions de suspension. Vous pouvez également spécifier jusqu’à cinq actions de notification qui envoient simplement des alertes sans suspendre aucun entrepôt.

SQL

Exécutez une commande CREATE RESOURCE MONITOR avec une ou plusieurs des propriétés de planification suivantes :

  • FREQUENCY

  • START_TIMESTAMP

  • END_TIMESTAMP

Par exemple :

  • Pour créer un moniteur de ressources au niveau du compte qui démarre immédiatement (en fonction de l’horodatage actuel), se réinitialise mensuellement le même jour, n’a pas de date ou d’heure de fin et suspend l’entrepôt affecté lorsque les crédits utilisés atteignent 100 % du quota, procédez comme suit :

    USE ROLE ACCOUNTADMIN;
    
    CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
        FREQUENCY = MONTHLY
        START_TIMESTAMP = IMMEDIATELY
        TRIGGERS ON 100 PERCENT DO SUSPEND;
    
    ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
    
    Copy
  • Pour créer un moniteur de ressources qui démarre à une date et à une heure spécifiques dans le futur, se réinitialise chaque semaine le même jour, n’a pas de date ni d’heure de fin et effectue deux actions de suspension différentes à des seuils différents sur les deux entrepôts affectés, procédez comme suit :

    USE ROLE ACCOUNTADMIN;
    
    CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=2000
        FREQUENCY = WEEKLY
        START_TIMESTAMP = '2019-03-04 00:00 PST'
        TRIGGERS ON 80 PERCENT DO SUSPEND
                 ON 100 PERCENT DO SUSPEND_IMMEDIATE;
    
    ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
    
    ALTER WAREHOUSE wh2 SET RESOURCE_MONITOR = limit1;
    
    Copy

Note

Vous ne pouvez pas modifier la planification personnalisée d’un moniteur de ressources pour lequel la valeur par défaut a été rétablie. Vous devez supprimer le moniteur et en créer un nouveau.

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.

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

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

Note

La modification de l’une de ces propriétés n’affecte pas les crédits utilisés à ce jour pour le moniteur. Toutes les modifications n’affectent les crédits utilisés qu’après leur enregistrement.

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

Classic Console

En utilisant le rôle système ACCOUNTADMIN :

  1. Cliquez sur Account Account tab » Resource Monitors.

  2. Cliquez sur le moniteur de ressources.

  3. Cliquez sur Edit.

SQL
  • Pour modifier le quota, personnalisez la planification ou ajoutez/supprimez/modifiez des actions :

    En utilisant le rôle système ACCOUNTADMIN ou un rôle qui a reçu le privilège MODIFY sur le moniteur de ressources, exécutez une commande ALTER RESOURCE MONITOR .

  • Pour modifier le niveau de surveillance :

    En utilisant le rôle système ACCOUNTADMIN , exécutez une commande ALTER WAREHOUSE ou ALTER ACCOUNT .

    Notez que pour modifier un entrepôt, le rôle ACCOUNTADMIN doit également disposer du privilège MODIFY sur l’entrepôt.

Par exemple, pour faire passer le quota de crédit de limit1 à 3000 :

ALTER RESOURCE MONITOR limit1 SET CREDIT_QUOTA=3000;
Copy

Note

Si un moniteur de ressources a une planification personnalisée, vous ne pouvez pas rétablir la planification par défaut. Vous devez supprimer le moniteur et en créer un nouveau.

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 :

Classic Console

Le processus est identique à celui de la création ou de la modification d’un moniteur de ressources (voir les instructions dans ce chapitre).

SQL

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

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

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

Par exemple :

USE ROLE ACCOUNTADMIN;

CREATE RESOURCE MONITOR accountmax WITH CREDIT_QUOTA=10000
  TRIGGERS ON 100 PERCENT DO SUSPEND;

ALTER ACCOUNT SET RESOURCE_MONITOR = accountmax;
Copy

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.

Important

  • Un moniteur de ressources au niveau du compte contrôle uniquement les entrepôts virtuels créés de façon explicite dans votre compte. Il ne contrôle pas l’utilisation du crédit par les entrepôts fournis par Snowflake pour les fonctionnalités sans serveur (par exemple, pour Snowpipe, Clustering automatique et les vues matérialisées). Pour une liste complète des fonctionnalités, voir Fonctionnalités sans serveur.

  • Un moniteur de ressources au niveau de l’entrepôt peut surveiller, mais ne peut pas suspendre, l’utilisation du crédit par les services Cloud. Le moniteur ne peut suspendre que les entrepôts virtuels gérés par les utilisateurs et créés dans votre compte. Après la suspension d’un entrepôt virtuel géré par un utilisateur, les requêtes ultérieures exécutées sur cet entrepôt peuvent encore entraîner des coûts supplémentaires liés aux services Cloud. Pour plus de détails sur l’utilisation du crédit pour les services Cloud, voir Utilisation du crédit des services Cloud.

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.

Seuls les administrateurs de comptes (utilisateurs ayant le rôle ACCOUNTADMIN) peuvent affecter des entrepôts aux moniteurs de ressources. Ce rôle doit également disposer du privilège MODIFY sur chaque entrepôt.

Classic Console
  1. Cliquez sur Account Account tab » Resource Monitors.

  2. Cliquez sur le moniteur de ressources.

  3. Cliquez sur Edit.

  4. Dans Monitor Level, ajoutez les entrepôts de votre choix. Si aucun entrepôt n’a déjà été attribué au moniteur, sélectionnez d’abord Warehouse dans la liste, puis un ou plusieurs entrepôts.

SQL

Exécutez une commande ALTER WAREHOUSE.

Par exemple, en utilisant le moniteur de ressources (limit1) d’un exemple précédent, affectez un autre entrepôt au moniteur :

ALTER WAREHOUSE wh3 SET RESOURCE_MONITOR = limit1;
Copy

Affichage des moniteurs de ressources

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

Classic Console

En utilisant le rôle ACCOUNTADMIN :

  1. Cliquez sur Account Account tab » Resource Monitors.

SQL

En utilisant le rôle ACCOUNTADMIN ou un rôle auquel le privilège MONITOR ou MODIFY a été accordé sur le moniteur de ressources souhaité :

Exécutez une commande SHOW RESOURCE MONITORS .

En outre, avec n’importe quel rôle, vous pouvez exécuter la commande SHOW WAREHOUSES pour visualiser 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.

Note

Pour les comptes fournisseurs ayant créé des comptes de lecteur, Snowflake fournit une vue supplémentaire, RESOURCE_MONITORS. Cette vue peut être utilisée pour interroger l’utilisation du moniteur de ressources dans les comptes de lecteur du fournisseur. Pour plus de détails, voir Account Usage.