Verwenden von Ressourcenmonitoren¶

Eigenschaften von Ressourcenmonitoren¶

Ein Ressourcenmonitor ist ein First-Class-Objekt in Snowflake mit folgenden Eigenschaften:

Zuweisung von Ressourcenmonitoren¶

Auf Kontoebene kein ein Monitor eingerichtet werden, um die Credit-Nutzung aller Warehouses in Ihrem Konto zu kontrollieren.

Außerdem können einem Ressourcenmonitor ein oder mehrere Warehouses zugewiesen werden, wodurch die Credit-Nutzung für jedes ihm zugewiesene Warehouse überwacht wird. Beachten Sie jedoch, dass jedes Warehouse nur einem einzigen Ressourcenmonitor unterhalb der Kontoebene zugewiesen werden kann.

Die folgende Abbildung veranschaulicht ein Szenario, in dem ein Ressourcenmonitor auf Kontoebene festgelegt ist und einzelne Warehouses zwei anderen Ressourcenmonitoren zugewiesen sind:

Aus dieser Abbildung kann Folgendes entnommen werden:

• Das Credit-Kontingent für das gesamte Konto beträgt 5.000 pro Intervall (Monat, Woche usw.), das von Ressourcenmonitor 1 überwacht wird. Wenn dieses Kontingent innerhalb des Intervalls erreicht wird, werden die für den Ressourcenmonitor definierten Aktionen (Anhalten, Sofort Anhalten usw.) für alle fünf Warehouses durchgesetzt.

• Warehouse 3 kann maximal 1.000 Credits pro Intervall verbrauchen.

• Warehouse 4 und 5 können zusammen maximal 2.500 Credits pro Intervall verbrauchen.

Beachten Sie, dass die von den Warehouses 3, 4 und 5 tatsächlich verbrauchten Credits geringer sein können als deren Kontingent, wenn das Kontingent für das Konto zuerst erreicht wird.

Anhalten und Fortsetzen von Warehouses¶

Die verbrauchten Credits für einen Ressourcenmonitor spiegeln die Summe der Credits wider, die von allen zugewiesenen Warehouses innerhalb des angegebenen Intervalls verbraucht wurden, zusammen mit den Clouddiensten, die in demselben Intervall zur Unterstützung dieser Warehouses genutzt wurden. Wenn für einen Monitor die Aktion Anhalten oder Sofort anhalten festgelegt wurde und die verbrauchten Credits den Schwellenwert für die Aktion erreicht haben, werden alle dem Monitor zugewiesenen Warehouses angehalten und können erst wieder fortgesetzt werden, wenn eine der folgenden Bedingungen erfüllt ist:

• Das nächste Intervall, sofern vorhanden, beginnt gemäß Startdatum des Monitors.

• Das Credit-Kontingent für den Monitor wird erhöht.

• Der Credit-Schwellenwert für die „Anhalten“-Aktion wird erhöht.

• Das Warehouse ist nicht mehr länger dem Ressourcenmonitor zugewiesen.

• Der Monitor wird gelöscht.

Benachrichtigungen von Ressourcenmonitoren¶

Wenn ein Ressourcenmonitor den Schwellenwert für eine Aktion erreicht, generiert er auf Basis der durchgeführten Aktion eine der folgenden Benachrichtigungen:

• Die zugewiesenen Warehouses werden nach Abschluss aller aktiven Abfragen angehalten.

• Alle aktiven Abfragen in den zugewiesenen Warehouses werden abgebrochen und die Warehouses sofort angehalten.

• Ein Schwellenwert wurde erreicht, es wurde jedoch keine Aktion ausgeführt.

Die Benachrichtigung wird an alle Kontoadministratoren gesendet, die den Empfang von Benachrichtigungen aktiviert haben, und an die Nicht-Administrator-Benutzer, die in der Benachrichtigungsliste eines Warehouse-Monitors aufgeführt sind. Nicht-Administrator-Benutzer können nicht in die Benachrichtigungsliste für einen Kontomonitor aufgenommen werden.

DDL für Ressourcenmonitore¶

Snowflake bietet die folgenden DDL-Befehle zum Erstellen und Verwenden/Verwalten von Ressourcenmonitoren:

• CREATE RESOURCE MONITOR

• ALTER RESOURCE MONITOR

• SHOW RESOURCE MONITORS

• DROP RESOURCE MONITOR

Darüber hinaus können die folgenden DDL-Befehle verwendet werden, um einem Warehouse einen Ressourcenmonitor zuzuordnen und anzuzeigen, ob ein Warehouse einem Monitor zugeordnet ist:

• CREATE WAREHOUSE oder ALTER WAREHOUSE

• SHOW WAREHOUSES

Zugriffssteuerungsrechte für Ressourcenmonitore¶

Standardmäßig können Ressourcenmonitore nur von Kontoadministratoren erstellt und daher nur von diesen angezeigt und gewartet werden.

Rollen, denen die folgenden Berechtigungen für bestimmte Ressourcenmonitore gewährt wurden, können den Ressourcenmonitor jedoch bei Bedarf mit SQL anzeigen und ändern:

• MONITOR

• MODIFY

Weitere Informationen dazu finden Sie unter Zugriffssteuerungsrechte und GRANT <Berechtigungen>.

Beachten Sie, dass nur Kontoadministratoren die Berechtigung haben, Ressourcenmonitore über die klassische Weboberfläche anzuzeigen und zu verwalten.

Aktivieren des Empfangs von Benachrichtigungen¶

Bevor Sie Benachrichtigungen von Ressourcenmonitoren erhalten können, müssen Sie Benachrichtigungen über die Weboberfläche aktivieren und Ihre E-Mail verifizieren.

Snowsight:

Um Benachrichtigungen zu aktivieren, führen Sie die folgenden Schritte aus:

1. Verifizieren Sie Ihre E-Mail-Adresse, falls Sie dies noch nicht getan haben. Eine Anleitung zum Verifizieren Ihrer E-Mail-Adresse finden Sie unter E-Mail-Adresse verifizieren.

2. Wählen Sie Ihren Benutzernamen aus, und wählen Sie dann Profile aus.

3. Wählen Sie unter Notifications die Option Enable notifications from resource monitors aus.

   Bemerkung

   • Die Option Notifications ist nur verfügbar, wenn Ihre E-Mail-Adresse verifiziert wurde.

   • In Notifications ist die Option Enable notifications from resource monitors nur für Benutzer mit der Rolle ACCOUNTADMIN verfügbar.

Classic Console:

Um Benachrichtigungen zu aktivieren, führen Sie die folgenden Schritte aus:

1. Verifizieren Sie Ihre E-Mail-Adresse, falls Sie dies noch nicht getan haben. Eine Anleitung zum Verifizieren Ihrer E-Mail-Adresse finden Sie unter Überprüfen Ihrer E-Mail-Adresse über die klassische Konsole.

2. Wählen Sie in dem Dropdown-Menü neben Ihrem Namen in der oberen rechten Ecke die Option Preferences » Notifications aus.

3. Wählen Sie eine der Optionen aus.

Erstellen von Ressourcenmonitoren¶

Ressourcenmonitore können entweder über die Weboberfläche oder mit SQLerstellt werden. Allerdings können Ressourcenmonitore nur von Kontoadministratoren (d. h, Benutzer mit der Rolle ACCOUNTADMIN) erstellt werden.

Ändern von Ressourcenmonitoren¶

Sie können die folgenden Eigenschaften für einen vorhandenen Ressourcenmonitor ändern:

• Credit-Kontingent für den Monitor erhöhen oder verringern

• Zeitplan des Monitors anpassen (Frequenz, Startzeitstempel und Endzeitstempel)

• Aktionen hinzufügen/entfernen oder Schwellenwert-Prozentsätze für vorhandene Aktionen ändern

• Monitor auf Kontoebene in einen Monitor zur Überwachung eines einzelnen Warehouse umwandeln

• Wenn der Monitor einzelne Warehouses überwacht:

  • Warehouse hinzufügen oder aus der Liste entfernen

  • Monitor umwandeln, um Konto zu überwachen

Ressourcenmonitore können entweder über die Weboberfläche oder mit SQL geändert werden.

Snowsight:

Bemerkung

Sie können Snowsight nicht verwenden, um den Ressourcenmonitortyp von Warehouse in Konto zu ändern. Verwenden Sie stattdessen SQL. Ein Beispiel dazu finden Sie im SQL-Abschnitt.

1. Melden Sie sich bei Snowsight an, und navigieren Sie zu Admin » Cost Management.

2. Wählen Sie Resource Monitors aus, und wählen Sie dann einen Ressourcenmonitor aus.

3. Wählen Sie in der rechten oberen Ecke das Menü More (…) aus. Wählen Sie Edit aus.

Classic Console:

1. Wählen Sie Account » Resource Monitors aus.

2. Wählen Sie einen Ressourcenmonitor aus.

3. Wählen Sie Edit aus.

SQL:

• Führen Sie die Anweisung ALTER RESOURCE MONITOR aus, um das Kontingent zu ändern, den Zeitplan anzupassen oder Aktionen hinzuzufügen, zu entfernen oder zu ändern.

  Um beispielsweise das Credit-Kontingent für den Ressourcenmonitor limit1 auf 3000 zu erhöhen, führen Sie die folgende Anweisung aus:

  ALTER RESOURCE MONITOR limit1 SET CREDIT_QUOTA=3000;
  

  Copy

  Weitere Beispiele finden Sie unter Beispiele.

• Um den Monitortyp zu ändern, führen Sie eine ALTER WAREHOUSE- oder eine ALTER ACCOUNT-Anweisung aus.

  Um beispielsweise den Ressourcenmonitor my_rm, der derzeit Warehouses überwacht, in einen Monitor für das Konto my_account zu ändern, führen Sie die folgenden Schritte aus:

  1. Suchen Sie alle Warehouses, die der Ressourcenmonitor my_rm überwacht. Prüfen Sie dazu die Spalte resource_monitor auf den Eintrag my_rm:

     SHOW WAREHOUSES;
     

     Copy

     Die Anweisung gibt die folgenden Ergebnisse zurück:

     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     | name   | state     | type     | size    | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on                    | resumed_on                    | updated_on                    | owner        | comment | resource_monitor | actives | pendings | failed | suspended | uuid       | budget | owner_role_type |
     |--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------|
     | MY_WH1 | STARTED   | STANDARD | X-Small |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:37:36.223 -0800 | 2024-01-17 14:37:36.325 -0800 | 2024-01-17 14:47:49.854 -0800 | MY_ROLE      |         | null             |       0 |        0 |      0 |         1 | 1222706972 | NULL   | ROLE            |
     | MY_WH2 | SUSPENDED | STANDARD | X-Small |       0 |      0 | N          | Y          |          600 | true        |           |              |           |       | 2023-12-20 13:50:50.972 -0800 | 2024-01-17 14:28:39.170 -0800 | 2024-01-17 14:37:57.560 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         1 | 1222706948 | NULL   | ROLE            |
     | MY_WH3 | SUSPENDED | STANDARD | Small   |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:26:26.911 -0800 | 2024-01-17 14:33:39.260 -0800 | 2024-01-17 14:38:31.192 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         2 | 1222706960 | NULL   | ROLE            |
     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     

     Der Ressourcenmonitor my_rm überwacht zwei Warehouse: my_wh2 und my_wh3.

  2. Entfernen Sie den Ressourcenmonitor für beide Warehouses, indem Sie die folgenden Anweisungen ausführen:

     ALTER WAREHOUSE my_wh2 UNSET RESOURCE_MONITOR;
     
     ALTER WAREHOUSE my_wh3 UNSET RESOURCE_MONITOR;
     

     Copy

  3. Ändern Sie den Ressourcenmonitor so, dass er das Konto überwacht, indem Sie die folgende Anweisung ausführen:

     ALTER ACCOUNT my_account SET RESOURCE_MONITOR = my_rm;
     

     Copy

Ressourcenmonitor-Benachrichtigungen an Nicht-Administrator-Benutzer senden¶

Benutzer, die keine Administratoren sind, können E-Mail-Benachrichtigungen von Ressourcenmonitoren erhalten, die Warehouses überwachen. Jeder Nicht-Administrator-Benutzer muss über eine verifizierte E-Mail-Adresse verfügen. Mit dem Befehl CREATE RESOURCE MONITOR oder ALTER RESOURCE MONITOR können Sie bis zu fünf Nicht-Administrator-Benutzer zu einem Warehouse-Monitor hinzufügen.

Um beispielsweise die Benutzer user1 und user2 zum Warehouse-Monitor my_warehouse_rm hinzuzufügen, führen Sie die folgende Anweisung aus:

ALTER RESOURCE MONITOR my_warehouse_rm
  SET NOTIFY_USERS = (USER1, USER2);

Weitere Informationen dazu finden Sie unter dem Parameter NOTIFY_USERS und in den Nutzungshinweise unter dem Thema ALTER RESOURCE MONITOR.

Informationen zum Hinzufügen von Nicht-Administrator-Benutzern in die Benachrichtigungsliste für einen Ressourcenmonitor, wenn Sie einen Ressourcenmonitor mit SQL erstellen, finden Sie unter CREATE RESOURCE MONITOR.

Ressourcenmonitor für Ihr Konto einrichten¶

Ein Ressourcenmonitor für Ihr Konto kann über die Weboberfläche oder mit SQL eingerichtet werden:

Snowsight:

Sie können den Monitortyp auf Konto einstellen, wenn Sie einen Ressourcenmonitor erstellen. Weitere Informationen dazu finden Sie unter Erstellen von Ressourcenmonitoren.

Sie können Snowsight nicht verwenden, um den Ressourcenmonitortyp von Warehouse in Konto zu ändern. Verwenden Sie stattdessen SQL. Ein Beispiel dazu finden Sie im SQL-Abschnitt.

Classic Console:

Sie können den Monitortyp auf Account setzen, wenn Sie einen Ressourcenmonitor erstellen oder ändern:

• Weitere Informationen zum Erstellen eines Ressourcenmonitors finden Sie unter Erstellen von Ressourcenmonitoren.

• Weitere Informationen zum Ändern eines Ressourcenmonitors finden Sie unter Ändern von Ressourcenmonitoren.

SQL:

Mit SQL wird diese Aufgabe in zwei Schritten ausgeführt:

1. Verwenden Sie den Befehl CREATE RESOURCE MONITOR, um den Ressourcenmonitor zu erstellen (falls er noch nicht vorhanden ist).

   Wenn der Ressourcenmonitor vorhanden ist, können Sie einen Ressourcenmonitor auf Warehouse-Ebene so ändern, dass er ein Konto überwacht. Ein Beispiel dazu finden Sie im Abschnitt Ändern eines Ressourcenmonitors.

2. Verwenden Sie den Befehl ALTER ACCOUNT, um den von Ihnen erstellten Ressourcenmonitor als Monitor für Ihr Konto festzulegen.

   Um beispielsweise den Konto-Ressourcenmonitor auf my_account_rm zu setzen, führen Sie die folgende Anweisung aus:

   USE ROLE ACCOUNTADMIN;
   
   CREATE RESOURCE MONITOR my_account_rm WITH CREDIT_QUOTA=10000
     TRIGGERS ON 100 PERCENT DO SUSPEND;
   
   ALTER ACCOUNT SET RESOURCE_MONITOR = my_account_rm;
   

   Copy

Ein Beispiel dazu, wie Sie den Monitortyp eines vorhandenen Ressourcenmonitors von einem Warehouse-Monitor in einen Konto-Monitor ändern können, finden Sie im Abschnitt Ändern eines Ressourcenmonitors.

Um anzuzeigen, ob ein Ressourcenmonitor für Ihr Konto eingerichtet ist, verwenden Sie die Weboberfläche oder den Befehl SHOW RESOURCE MONITORS. In der Spalte LEVEL eines Ressourcenmonitors wird angezeigt, ob dieser für Ihr Konto oder für einzelne Warehouses festgelegt ist.

Zuweisen von Warehouses zu Ressourcenmonitoren¶

Warehouses können einem Ressourcenmonitor über die Weboberfläche oder mit SQL zugewiesen werden:

Snowsight:

1. Melden Sie sich bei Snowsight an, und navigieren Sie zu Admin » Cost Management.

2. Wählen Sie Resource Monitors aus, und wählen Sie dann einen Ressourcenmonitor aus.

3. Wählen Sie in der rechten oberen Ecke das Menü More (…) aus. Wählen Sie Edit aus.

4. Wenn Monitor Type auf Account eingestellt ist, wählen Sie Warehouse aus.

5. Wählen Sie Warehouse aus, um die zu überwachenden Warehouses auszuwählen.

Classic Console:

1. Wählen Sie Account » Resource Monitors aus.

2. Wählen Sie einen Ressourcenmonitor aus.

3. Wählen Sie Edit aus.

4. Wenn dem Monitor noch kein Warehouse zugewiesen ist, wählen Sie zuerst Monitor Level und anschließend Warehouse aus.

5. Wählen Sie Warehouse aus, und wählen Sie die zu überwachenden Warehouses aus.

SQL:

Verwenden Sie den Befehl ALTER WAREHOUSE, um ein Warehouse einem Ressourcenmonitor zuzuweisen.

Um beispielsweise Warehouse my_wh mit Ressourcenmonitor my_rm zu überwachen, führen Sie die folgende Anweisung aus:

ALTER WAREHOUSE my_wh SET RESOURCE_MONITOR = my_rm;

Copy

Anzeigen von Ressourcenmonitoren¶

Ressourcenmonitore können über die Weboberfläche oder mit SQL angezeigt werden:

Snowsight:

1. Melden Sie sich bei Snowsight an, und navigieren Sie zu Admin » Cost Management.

2. Wählen Sie Resource Monitors aus, um eine Liste der Ressourcenmonitore anzuzeigen, für die Ihre Rolle die Berechtigung MODIFY oder MONITOR erhalten hat. Kontoadministrator-Benutzern werden alle Ressourcenmonitore angezeigt.

3. Wählen Sie einen Ressourcenmonitor aus, um detaillierte Informationen über die Einstellungen des Ressourcenmonitors, die aktuelle Credit-Nutzung und eine Liste der Rollen mit Berechtigungen für den Ressourcenmonitor anzuzeigen.

Classic Console:

Bemerkung

Nur Benutzer mit der Rolle ACCOUNTADMIN können Ressourcenmonitore über die klassische Konsole anzeigen.

1. Wählen Sie Account » Resource Monitors aus.

SQL:

Verwenden Sie die Rolle ACCOUNTADMIN oder eine Rolle, der die Berechtigung MONITOR oder MODIFY für den gewünschten Ressourcenmonitor zugewiesen wurde, und führen Sie eine SHOW RESOURCE MONITORS-Anweisung aus.

Darüber hinaus können Sie mit jeder Rolle die Anweisung SHOW WAREHOUSES ausführen, um die Warehouses anzuzeigen, die sich im Eigentum der Rolle befinden (oder für die der Rolle die Berechtigung USAGE erteilt wurde). In der Ausgabe wird, falls vorhanden, der Ressourcenmonitor angezeigt, dem das Warehouse zugewiesen ist.

Replizieren von Ressourcenmonitoren¶

Ressourcenmonitore können unter Verwendung einer Replikations- oder Failover-Gruppe von einem Quellkonto in Zielkonten repliziert werden. Weitere Informationen dazu finden Sie unter Replikation von Ressourcenmonitoren.