Kategorien:

DDL für Warehouses und Ressourcenmonitore

ALTER RESOURCE MONITOR

Ändert die Eigenschaften und Trigger für einen vorhandenen Ressourcenmonitor. Verwenden Sie diesen Befehl, um das Credit-Kontingent zu erhöhen oder zu verringern oder die Trigger für einen Ressourcenmonitor zu ändern/ersetzen.

Siehe auch:

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

Syntax

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 ... ] ] }

Wobei:

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

Parameter

Name

Gibt den Bezeichner für den zu ändernden Ressourcenmonitor an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

SET ...

CREDIT_QUOTA = Zahl

Gibt die Anzahl der Credits an, die dem Ressourcenmonitor monatlich zugewiesen werden. Wenn die Gesamtnutzung für alle dem Monitor zugeordneten Warehouses diese Zahl für das aktuelle Wiederholungsintervall (d. h. den Abrechnungszeitraum) erreicht hat, wird der Ressourcenmonitor als bei 100 % des Kontingents betrachtet.

Wenn für einen Ressourcenmonitor kein Wert angegeben ist, hat der Monitor kein Kontingent und wird innerhalb des angegebenen Intervalls nie eine Nutzung von 100 % erreichen.

FREQUENCY = MONTHLY | DAILY | WEEKLY | YEARLY | NEVER

Das Intervall, in dem die Credit-Nutzung auf 0 zurückgesetzt wird.

Wenn Sie NEVER für die Häufigkeit angeben, wird die Credit-Nutzung für das Warehouse nicht zurückgesetzt.

START_TIMESTAMP = Zeitstempel | IMMEDIATELY

Datum und Uhrzeit, zu der der Ressourcenmonitor beginnt, die Credit-Nutzung für die zugewiesenen Warehouses zu überwachen.

Wenn Sie als Startzeitstempel IMMEDIATELY angeben, wird der aktuelle Zeitstempel verwendet.

END_TIMESTAMP = Zeitstempel

Datum und Uhrzeit, zu der der Ressourcenmonitor die zugewiesenen Warehouses anhält.

TRIGGERS ... (auch Aktionen)

Gibt einen oder mehrere Trigger für den Ressourcenmonitor an. Jede Triggerdefinition enthält Folgendes:

  • ON Schwellenwert PERCENT (Nutzungsprozentsatz; Werte größer als 100 werden unterstützt)

  • DO SUSPEND | SUSPEND_IMMEDIATE | NOTIFY (Aktion, die ausgeführt wird, wenn der Schwellenwert erreicht ist).

Weitere Details dazu finden Sie unter CREATE RESOURCE MONITOR.

Nutzungshinweise

  • Wenn für einen Ressourcenmonitor ein SUSPEND- oder SUSPEND_IMMEDIATE-Trigger aktiv ist und der Triggerschwellenwert für das angegebene Frequenzintervall erreicht wurde, wodurch verhindert wird, dass alle dem Ressourcenmonitor zugeordneten Warehouses gestartet bzw. fortgesetzt werden, können Sie mit diesem Befehl entweder das Credit-Kontingent über den Triggerschwellenwert erhöhen oder den Trigger durch einen neuen Trigger mit einem höheren Schwellenwert ersetzen.

    Nach Erhöhung des Credit-Kontingents oder des Triggerschwellenwerts für den Ressourcenmonitor können die dem Ressourcenmonitor zugeordneten Warehouses gestartet oder fortgesetzt werden.

  • Die SET-Aktion für Trigger ist nicht additiv (d. h. sie entfernt alle vorhandenen Trigger für den Ressourcenmonitor und ersetzt sie durch die angegebenen Trigger).

    Um die vorhandenen Trigger zu ergänzen, müssen Sie daher die neuen Trigger angeben und die bestehenden Trigger replizieren.

Beispiele

Geben Sie ein neues Credit-Kontingent für den limiter-Ressourcenmonitor an, und ersetzen Sie die vorhandenen Trigger für den Monitor durch einen neuen Satz von Triggern:

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