Catégories :

Moniteur d’entrepôt et de ressources DDL

ALTER RESOURCE MONITOR

Modifie les propriétés et les déclencheurs d’un moniteur de ressources existant. Utilisez cette commande pour augmenter ou diminuer le quota de crédit, modifier des informations de programmation, ou changer/remplacer les déclencheurs pour un moniteur de ressources.

Voir aussi :

CREATE RESOURCE MONITOR , SHOW RESOURCE MONITORS , ALTER WAREHOUSE , ALTER ACCOUNT

Syntaxe

ALTER RESOURCE MONITOR [ IF EXISTS ] <name> SET { [ CREDIT_QUOTA = <num> ]
                                                  [ FREQUENCY = { MONTHLY | DAILY | WEEKLY | YEARLY | NEVER } ]
                                                  [ START_TIMESTAMP = { <timestamp> | IMMEDIATELY } ]
                                                  [ END_TIMESTAMP = <timestamp> ]
                                                  [ TRIGGERS triggerDefinition [ triggerDefinition ... ] ] }

Où :

triggerDefinition ::=
   ON <threshold> PERCENT DO { SUSPEND | SUSPEND_IMMEDIATE | NOTIFY }

Paramètres

nom

Indique l’identifiant du moniteur de ressources à 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.

SET ...

CREDIT_QUOTA = nb

Indique le nombre de crédits alloués au moniteur de ressources par intervalle de fréquence. Lorsque l’utilisation totale de tous les entrepôts affectés au moniteur atteint ce nombre pour l’intervalle de fréquence en cours, le moniteur de ressources est considéré comme étant à 100 % du quota.

Si aucune valeur n’est spécifiée pour un moniteur de ressources, le moniteur n’a pas de quota et n’atteindra jamais 100 % d’utilisation dans l’intervalle spécifié.

FREQUENCY = MONTHLY | DAILY | WEEKLY | YEARLY | NEVER

Intervalle de fréquence auquel l’utilisation du crédit est réinitialisée à 0.

Si vous spécifiez NEVER pour la fréquence, l’utilisation du crédit pour l’entrepôt ne sera pas réinitialisée.

START_TIMESTAMP = horodatage | IMMEDIATELY

Date et heure auxquelles le moniteur de ressources commence à surveiller l’utilisation des crédits pour les entrepôts attribués.

Si vous spécifiez IMMEDIATELY pour l’horodatage de début, l’horodatage actuel est utilisé.

END_TIMESTAMP = horodatage

Date et heure auxquelles le moniteur de ressources suspend les entrepôts attribués.

TRIGGERS ... (aka actions)

Spécifie un ou plusieurs déclencheurs pour le moniteur de ressources. Chaque définition de déclenchement est constituée des éléments suivants :

  • ON seuil PERCENT (pourcentage d’utilisation ; les valeurs supérieures à 100 sont prises en charge)

  • DO SUSPEND | SUSPEND_IMMEDIATE | NOTIFY (action à effectuer lorsque le seuil est atteint).

Pour plus de détails, voir CREATE RESOURCE MONITOR.

Notes sur l’utilisation

  • Si un déclencheur SUSPEND ou SUSPEND_IMMEDIATE est actif pour un moniteur de ressources et que le seuil de déclenchement a été atteint pour l’intervalle de fréquence spécifié, empêchant ainsi le démarrage/la reprise de tous les entrepôts assignés, vous pouvez utiliser cette commande pour augmenter le quota de crédit au-dessus du seuil de déclenchement ou remplacer le déclencheur par un nouveau déclencheur dont le seuil est plus élevé.

    Dès que le quota de crédit ou le seuil de déclenchement du moniteur de ressources a été augmenté, les entrepôts assignés peuvent être lancés ou repris.

  • L’action SET pour les déclencheurs n’est pas cumulable (c’est-à-dire qu’elle supprime tous les déclencheurs existants pour le moniteur de ressources et les remplace par les déclencheurs indiqués).

    Par conséquent, pour apporter des modifications aux déclencheurs existants, vous devez spécifier les nouveaux déclencheurs et répliquer les déclencheurs existants.

Exemples

Spécifier un nouveau quota de crédit pour le moniteur de ressources limiter et remplacer les déclencheurs existants pour le moniteur par un nouvel ensemble de déclencheurs :

ALTER RESOURCE MONITOR limiter
  SET CREDIT_QUOTA=2000
      TRIGGERS ON 80 PERCENT DO NOTIFY
               ON 100 PERCENT DO SUSPEND_IMMEDIATE;