Überwachen der Credit-Nutzung mit Budgets¶

Kontobudget und kundenspezifische Budgets¶

Um mit der Verwendung von Budgets in Snowflake zu beginnen, aktivieren Sie das Kontobudget. Das Kontobudget überwacht die Ausgaben für alle unterstützten Objekte des Kontos. Um Benachrichtigungen für das Budget zu erhalten, legen Sie das Ausgabenlimit fest, und geben Sie dann die E-Mail-Adressen an, an die die Benachrichtigungen gesendet werden sollen.

Sie können auch kundenspezifische Budgets erstellen, um die Ausgabenlimits für eine bestimmte Gruppe von unterstützten Objekten zu überwachen. Sie können kundenspezifische Budgets in jeder Datenbank und jedem Schema erstellen. Wie beim Kontobudget müssen Sie das Ausgabenlimit und die E-Mail-Adressen festlegen, an die die Benachrichtigungs-E-Mails gesendet werden.

Ausgabenlimit und Zeitintervall¶

Das Ausgabenlimit wird in Snowflake-Credits ausgedrückt und dient nur zu Warn- und Benachrichtigungszwecken. Das Ausgabenlimit wird mit einem Zeitintervall von einem Kalendermonat festgelegt.

Das Zeitintervall beginnt um 12:00 Uhr UTC am ersten Tag des Monats und endet um 11:59 Uhr UTC am letzten Tag des Monats. Wenn ein Budget nach dem ersten Tag des Monats erstellt wird, ist das erste Überwachungsintervall der Zeitraum bis zum letzten Tag des aktuellen Monats und wird dann am ersten des folgenden Monats zurückgesetzt.

Wenn Sie Ihr Kontobudget nach dem Ersten des Monats aktivieren, werden die Daten vom Monatsanfang zurückgerechnet und verwendet, um festzustellen, ob Sie Ihr Ausgabenlimit für den Monat überschreiten werden.

Wenn Sie nach dem Monatsersten ein kundenspezifisches Budget erstellen, werden die historischen Daten für den Monat nicht rückwirkend aufgefüllt. Die Prognosen für künftige Ausgaben basieren auf der Credit-Nutzung in den Tagen nach der Freigabe des Budgets.

Unterstützte Objekte¶

Die Liste der unterstützten Objekte, die zum Ausgabenlimit für das Kontobudget beitragen. Bei einem kundenspezifischen Budget können Sie bestimmte Objekte zur Überwachung auswählen.

Ein Budget kann die folgenden Objekte überwachen:

• Tabellen

• Materialisierte Ansichten

• Schemas

• Datenbanken

• Warehouses

• Pipes

• Aufgaben

Benachrichtigungen zu Budgets¶

Ein Budget sendet täglich eine Benachrichtigung, wenn bei dem aktuellen Verbrauch auf Basis von Zeitreihenprognosen ein Überschreiten des Ausgabenlimits droht. Um automatische Benachrichtigungen zu erhalten, müssen Sie Folgendes tun:

• Legen Sie ein Ausgabenlimit für das Budget fest.

• Richten Sie E-Mail-Benachrichtigungen für das Budget ein.

Das folgende Beispiel zeigt eine Benachrichtigungs-E-Mail:

Sie können E-Mail-Benachrichtigungen für ein Budget deaktivieren, indem Sie die Methode SET_NOTIFICATION_MUTE_FLAG aufrufen.

Erforderliche Rollen und Berechtigungen zum Erstellen von Budgets¶

Sie können eine kundenspezifische Rolle verwenden, um kundenspezifische Budgets in Ihrem Konto zu erstellen. Weisen Sie der kundenspezifischen Rolle die folgende Datenbankrolle und Berechtigung zu:

• Rolle SNOWFLAKE.BUDGET_CREATOR der SNOWFLAKE-Datenbank

• Berechtigung CREATE SNOWFLAKE.CORE.BUDGET für das Schema, in dem das Budget erstellt werden soll.

Erstellen Sie z. B. eine Rolle budget_admin, und weisen Sie die erforderliche Rolle und die erforderlichen Berechtigungen zu, um kundenspezifische Budgets im Schema budgets_db.budgets_schema zu erstellen:

CREATE ROLE budget_admin;

GRANT DATABASE ROLE SNOWFLAKE.BUDGET_CREATOR TO ROLE budget_admin;

GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_admin;

GRANT CREATE SNOWFLAKE.CORE.BUDGET ON SCHEMA budgets_db.budgets_schema
  TO ROLE budget_admin;

Anwendungsrollen zum Verwalten des Kontobudgets¶

Sie können einer kundenspezifischen Rolle in Ihrem Konto die folgenden Anwendungsrollen zuweisen, um das Kontobudget zu ändern oder zu überwachen.

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_ADMIN TO ROLE budget_admin;

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_VIEWER TO ROLE budget_monitor;

Instanzrollen zum Verwalten von kundenspezifischen Budgets¶

Jedes kundenspezifische Budget verfügt über Instanzrollen, die anderen Rollen zur Anzeige oder Änderung des Budgets zugewiesen werden können:

GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
  TO ROLE budget_admin;

Untersuchen der Kosten¶

Sie können die Kosten von serverlosen Aufgaben mithilfe von Snowsight oder der Account Usage-Ansicht Ansicht SERVERLESS_TASK_HISTORY anzeigen. Weitere Informationen zur Anzeige der Kosten nach Diensttyp finden Sie unter Untersuchen der Computekosten.

Sie können die durch die Speicherung entstandenen Kosten mit Snowsight oder durch Abfrage der Account Usage- und Organization Usage-Ansichten einsehen. Weitere Informationen zur Anzeige der Speicherkosten finden Sie unter Untersuchen der Speicherkosten.

Aktivieren des Kontobudgets¶

Aktivieren Sie das Kontobudget, legen Sie das Ausgabenlimit für das Konto fest, und geben Sie die E-Mail-Adressen an, die Benachrichtigungen erhalten sollen, wenn die Credit-Nutzung das Ausgabenlimit überschreitet.

Sie können das Kontobudget aktivieren, indem Sie Snowsight oder SQL verwenden.

Kundenspezifisches Budget mit Snowsight erstellen¶

1. Melden Sie sich bei Snowsight an.

2. Select Admin » Cost Management

3. Wählen Sie Budgets aus.

4. Wählen Sie in der rechten oberen Ecke des Dashboards die Option (Budget hinzufügen) aus.

   Bemerkung

   Wenn Sie das Symbol für „Budget hinzufügen“ nicht sehen, müssen Sie zuerst das Kontobudget aktivieren.

5. Geben Sie einen Budget name ein.

6. Wählen Sie die Datenbank und das Schema aus, in denen Sie Ihr Budget erstellen möchten.

7. Geben Sie unter Spending limit das Ausgabenlimit ein.

8. Geben Sie die E-Mail-Adressen ein, an die Benachrichtigungen gesendet werden sollen.

   Bemerkung

   Jede für Budgetbenachrichtigungen hinzugefügte E-Mail-Adresse muss verifiziert sein. Das Einrichten der Benachrichtigungs-E-Mail schlägt fehl, wenn eine E-Mail-Adresse in der Liste nicht verifiziert ist.

9. Wählen Sie Resources to monitor aus.

   • Um eine Datenbank hinzuzufügen, erweitern Sie Databases, und wählen Sie dann die Datenbank aus.

   • Um Objekte eines Schemas hinzuzufügen, erweitern Sie das Schema, um die verfügbaren Objekte aufzulisten. Erweitern Sie die Objektkategorie (z. B. Tables oder Tasks), um Objekte auszuwählen.

   • Um ein Warehouse hinzuzufügen, erweitern Sie Warehouses, und wählen Sie ein Warehouse aus.

   Bemerkung

   Wenn Sie eine Datenbank oder ein Schema auswählen, werden alle unterstützten Objekte (z. B. Tabellen), die in der Datenbank oder dem Schema enthalten sind, ebenfalls zum Budget hinzugefügt.

Wenn Sie E-Mail-Adressen für Benachrichtigungen mit Snowsight hinzufügen, erstellt oder aktualisiert Snowflake eine E-Mail-Benachrichtigungsintegration namens default_budget_notification_integration in einem Hintergrundprozess. Wenn die Benachrichtigungsintegration vorhanden ist, fügt Snowflake alle neuen E-Mail-Adressen, die Sie eingegeben haben, zu den in der Liste vorhandenen E-Mail-Adressen hinzu.

Wenn die Benachrichtigungsintegration nicht vorhanden ist, erstellt Snowflake diese und erteilt die USAGE-Berechtigung. Weitere Informationen dazu finden Sie unter den Schritten, die im Abschnitt zum Kontobudget beschrieben sind.

Kundenspezifisches Budget mit SQL erstellen¶

Erstellen Sie ein kundenspezifisches Budget, und legen Sie dann das Ausgabenlimit und die E-Mail-Adressen für Benachrichtigungen fest.

1. Überprüfen Sie die vorhandenen Budgets in Ihrem Konto:

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

2. Erstellen Sie das Budget my_budget in budgets_db.budgets_schema mit dem Befehl CREATE SNOWFLAKE.CORE.BUDGET:

   USE SCHEMA budgets_db.budgets_schema;
   
   CREATE SNOWFLAKE.CORE.BUDGET my_budget();
   

   Copy

3. Setzen Sie das Ausgabenlimit auf 500 Credits pro Monat:

   CALL my_budget!SET_SPENDING_LIMIT(500);
   

   Copy

4. Legen Sie die Benachrichtigungsintegration und die E-Mail-Adressen fest:

   Bemerkung

   Wenn Sie noch keine NOTIFICATION INTEGRATION für E-Mail-Benachrichtigungen erstellt haben, lesen Sie die Schritte im Kontobudget-Abschnitt, um eine solche Integration zu erstellen.

   CALL my_budget!SET_EMAIL_NOTIFICATIONS('budgets_notification_integration',
                                          'costadmin@example.com');
   

   Copy

5. Um Objekte zu Ihrem kundenspezifischen Budget hinzuzufügen, müssen Sie einen Verweis auf die ADD_RESOURCE-Methode des Budgets übergeben. So fügen Sie beispielsweise eine Tabelle mit dem Namen t1 zum Budget mit dem Namen my_budget hinzu:

   CALL budgets_db.budgets_schema.my_budget!ADD_RESOURCE(
      SYSTEM$REFERENCE('TABLE', 't1', 'SESSION', 'applybudget'));
   

   Copy

   Die SYSTEM$REFERENCE-Anweisung erstellt eine Referenz auf ein TABLE-Objekt t1 mit der Berechtigung APPLYBUDGET für die Tabelle. Der dritte Parameter der Funktion gibt den Geltungsbereich für die Referenz an, d. h. in diesem Fall wird mit ‚SESSION‘ eine Referenz erstellt, deren Geltungsbereich die Sitzung ist. Referenzen, die an die Methode ADD_RESOURCE für ein Budget übergeben werden, können mit einem beliebigen transienten Referenzbereich erstellt werden (d. h. der dritte Parameter kann entweder ‚SESSION‘ oder ‚CALL‘ sein).

6. Weisen Sie Ihrer kundenspezifische Rolle budget_admin die Instanzrolle ADMIN zu:

   GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
     TO ROLE budget_admin;
   

   Copy

Sie können das Kontobudget nicht aktivieren¶

Es gibt mehrere Gründe, warum Sie Ihr Kontobudget nicht aktivieren können.

Unknown user-defined function SNOWFLAKE.LOCAL.ACTIVATE

FAILURE: Uncaught exception of type 'BUDGET_ALREADY_ACTIVATED' on line X at position X

CALL SNOWFLAKE.LOCAL.ACCOUNT_ROOT_BUDGET!GET_CONFIG();

-20000 (P0001): Uncaught exception of type 'NO_PERMISSION_TO_ACTIVATE_BUDGET' on line X at position X

Sie können kein kundenspezifisches Budget erstellen¶

Es gibt mehrere Gründe, warum Sie kein kundenspezifisches Budget erstellen können.

FAILURE: SQL access control error: Insufficient privileges to operate on class 'BUDGET'

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

Sie können ein kundenspezifisches Budget nicht aktivieren¶

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

Sie können für das Kontobudget keine Methoden aufrufen¶

Es gibt mehrere Gründe, warum das Aufrufen einer Methode für das Kontobudget fehlschlagen kann.

-20000 (P0001): Uncaught exception of type 'FUNCTION_NOT_SUPPORTED_FOR_ACCOUNT_ROOT_BUDGET' on line 11 at position 18

-20000 (P0001): Uncaught exception of type 'ACCOUNT_ROOT_BUDGET_NOT_ACTIVATED' on line X at position X

Das Budgets-Feature ist bei Ihrem Konto nicht verfügbar¶

FAILURE: SQL compilation error: Class 'SNOWFLAKE.CORE.BUDGET' does not exist or not authorized.

000002 (0A000): Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 : Unsupported feature 'TOK_RESOURCE_GROUP'.