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

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.

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

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

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

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

  • 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 ein Nicht-Administrator-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.

  • Hinweis zu 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 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;

Ändern Sie einen Ressourcenmonitor so, dass er Benachrichtigungen an drei Benutzer sendet, wenn 80 % des Credit-Kontingents erreicht sind. In diesem Beispiel enthält der Benutzername 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