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, DROP 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> ]
                                                    [ NOTIFY_USERS = ( <user_name> [ , <user_name> , ... ] ) ] } ]
                                            [ TRIGGERS triggerDefinition [ triggerDefinition ... ] ]
Copy

Wobei:

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

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 = num

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 = timestamp | 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.

Wenn Sie ein Datum ohne Zeitangabe angeben, wird die aktuelle Zeit verwendet.

Wenn Sie eine Uhrzeit einstellen, ohne eine Zeitzone anzugeben, wird UTC als Standardzeitzone verwendet.

END_TIMESTAMP = timestamp

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

NOTIFY_USERS = ( user_name [ , user_name , ... ] )

Gibt die Liste der Benutzer an, die E-Mail-Benachrichtigungen von den Ressourcenmonitoren erhalten sollen. Enthält eine Benutzer-ID Leer- oder Sonderzeichen oder wird zwischen Groß- und Kleinschreibung unterschieden, muss der Bezeichner in Anführungszeichen gesetzt werden (z. B. „Mary Smith“). Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

Die Benutzer-ID user_name ist der Wert der Spalte name aus der Ausgabe von SHOW USERS.

Jeder aufgelistete Benutzer muss eine verifizierte E-Mail-Adresse haben. Eine Anleitung zum Überprüfen von E-Mail-Adressen über die Weboberfläche finden Sie unter:

E-Mail-Benachrichtigungen für Nicht-Administrator-Benutzer ersetzen nicht die E-Mail-Benachrichtigungen für Administratoren. Alle Kontoadministratoren, bei denen E-Mail-Benachrichtigungen aktiviert sind, erhalten weiterhin E-Mail-Benachrichtigungen.

Bemerkung

  • Für Nicht-Administrator-Benutzer gelten folgende Einschränkungen:

    • Benutzer, die keine Administratoren sind, werden per E-Mail benachrichtigt, ihnen werden aber keine Benachrichtigungen auf der klassischen Weboberfläche angezeigt.

    • Nicht-Administrator-Benutzer können keine Ressourcenmonitore erstellen.

    • Benachrichtigungen sind auf Ressourcenmonitore einzelner Warehouses beschränkt. Nicht-Administrator-Benutzer können keine Benachrichtigungen von Ressourcenmonitoren auf Kontoebene erhalten.

    • Benutzer, die keine Administratoren sind, können keine anderen Benutzer für die Benachrichtigung zuweisen.

TRIGGERS ... (auch Aktionen)

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

  • ON threshold PERCENT (Schwellenwert als 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.

  • Der Parameter TRIGGERS ist nicht additiv (d. h. er 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.

  • Wenn in einem Ressourcenmonitor die Parameter frequency und start_timestamp eingestellt sind, wird der Tag für die Rücksetzung der Credit-Nutzung auf Grundlage dieser Parameter berechnet. Die Uhrzeit, zu der die Credit-Nutzung auf 0 zurückgesetzt wird, ist 12:00 Uhr UTC, unabhängig von der in start_timestamp angegebenen Uhrzeit.

  • Wenn Sie end_timestamp angeben, endet die Überwachung zum angegebenen Datum und der angegebenen Uhrzeit, und alle zugewiesenen Warehouses werden zu diesem Zeitpunkt angehalten, auch wenn das Credit-Kontingent nicht erreicht wurde.

    In diesem Fall wird eine Benachrichtigung gesendet, die besagt, dass der Ressourcenmonitor einen bestimmten Prozentsatz seines Kontingents erreicht und eine Aktion zum sofortigen Anhalten ausgelöst hat. Der Prozentsatz des Kontingents spiegelt die Anzahl der im aktuellen Intervall bis zum Enddatum verbrauchten Credits wider und entspricht möglicherweise nicht dem von Ihnen festgelegten Schwellenwert.

  • Wenn sich in der Benachrichtigungsliste Nicht-Administrator-Benutzer befinden, gelten die folgenden Hinweise:

    • Wenn ein Benutzer keine verifizierte E-Mail-Adresse hat, schlägt die SQL-Anweisung fehl.

    • Wenn einer der Benutzer in der Benachrichtigungsliste seine E-Mail-Adresse ändert und die neue E-Mail-Adresse nicht verifiziert ist, schlägt die Benachrichtigung fehl.

    • Die Benachrichtigungsliste ist auf eine maximale Anzahl von 5 Nicht-Administrator-Benutzern beschränkt.

    • Kontoadministratoren können die Benachrichtigungsliste von Nicht-Administrator-Benutzern in der Ausgabe von SHOW RESOURCE MONITORS in der Spalte notify_user einsehen.

  • Metadaten:

    Achtung

    Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Beispiele

Geben Sie ein neues Credit-Kontingent für den Ressourcenmonitor limiter 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;
Copy

Ändern Sie einen Ressourcenmonitor so, dass er Benachrichtigungen an drei Benutzer sendet, wenn 80 % des Credit-Kontingents erreicht sind. In diesem Beispiel enthält user_name für zwei der Benutzer ein Leerzeichen und ist daher in doppelte Anführungszeichen gesetzt:

ALTER RESOURCE MONITOR limiter
  SET CREDIT_QUOTA = 2000
      NOTIFY_USERS = (JDOE, "Jane Smith", "John Doe")
  TRIGGERS ON 80 PERCENT DO NOTIFY
           ON 100 PERCENT DO SUSPEND_IMMEDIATE
Copy