Tutorial: Erste Schritte mit Budgets¶

Einführung¶

Dieses Tutorial führt Sie in die Überwachung der Credit-Nutzung auf Kontoebene mit Budgets ein. Dazu wird ein Kontobudget eingerichtet und ein benutzerdefiniertes Budget erstellt, das eine Gruppe von bestimmten Objekten überwacht.

Mit Budgets können Sie die Credit-Nutzung für die Computekosten der unterstützten Objekte überwachen, einschließlich der Credit-Nutzung für Wartungsaufgaben im Hintergrund und serverlose Features. Mit Budgets können Sie für jedes Budget ein monatliches Ausgabenlimit festlegen und erhalten eine Benachrichtigung per E-Mail, wenn Ihre aktuellen Ausgaben das monatliche Ausgabenlimit voraussichtlich überschreiten werden.

Sie können dieses Tutorial mit einem Arbeitsblatt in Snowsight oder mit einem CLI-Client wie SnowSQL durchführen. Einige Teile dieses Tutorials können mit Snowsight durchgeführt werden.

Am Ende dieses Tutorials werden Sie wissen, wie Sie Folgendes tun können:

• Erstellen benutzerdefinierter Rollen zur Überwachung und Verwaltung von Budgets

• Erteilen der erforderlichen Berechtigungen, um Objekte zu einem benutzerdefinierten Budget hinzuzufügen

• Aktivieren und Einrichten eines Kontobudgets

• Erstellen eines benutzerdefinierten Budgets und Hinzufügen von Objekten zu diesem Budget

Benachrichtigungsintegration erstellen¶

Budgets verwenden eine Benachrichtigungsintegration, um Benachrichtigungs-E-Mails zu senden, wenn die aktuelle Credit-Nutzung voraussichtlich das monatliche Ausgabenlimit überschreitet. Die Liste ALLOWED_RECIPIENTS muss die verifizierten E-Mail-Adressen der Benutzer enthalten, die Benachrichtigungen erhalten sollen.

Eine Benachrichtigungsintegration ist erforderlich, wenn Sie das Tutorial mit SQL absolvieren. Führen Sie die unten beschriebenen Schritte aus, um eine zu erstellen.

Wenn Sie Snowsight verwenden, um ein Budget einzurichten, wird die Benachrichtigungsintegration automatisch für Sie erstellt. Wenn Sie Snowsight verwenden, um Ihre Budgets einzurichten, können Sie zum nächsten Schritt springen.

1. Führen Sie die folgende Anweisung aus, um eine Benachrichtigungsintegration zu erstellen. Verwenden Sie Ihre in der ALLOWED_RECIPIENTS-Liste enthaltene verifizierte E-Mail-Adresse:

   USE ROLE ACCOUNTADMIN;
   
   CREATE NOTIFICATION INTEGRATION budgets_notification_integration
     TYPE=EMAIL
     ENABLED=TRUE
     ALLOWED_RECIPIENTS=('<YOUR_EMAIL_ADDRESS>');
   

   Copy

2. Nachdem Sie die Benachrichtigungsintegration erstellt haben, weisen Sie der SNOWFLAKE-Anwendung die Berechtigung USAGE zu. Diese Berechtigung ist erforderlich, damit Budgets die Benachrichtigungsintegration zum Versenden von E-Mails nutzen kann.

   Führen Sie die folgende Anweisung aus, um die USAGE-Berechtigung für die Benachrichtigungsintegration zu erteilen:

   GRANT USAGE ON INTEGRATION budgets_notification_integration
     TO APPLICATION snowflake;
   

   Copy

Datenbank, Schema und benutzerdefinierte Rollen erstellen¶

In diesem Schritt werden die folgenden Objekte für das Tutorial erstellt, um Budgets zu erstellen, zu verwalten und zu überwachen:

• Eine Datenbank und ein Schema, in denen die benutzerdefinierten Budgets erstellt werden sollen

• Eine benutzerdefinierte Rolle zum Verwalten des Kontobudgets

• Eine benutzerdefinierte Rolle zum Überwachen des Kontobudgets

• Eine benutzerdefinierte Rolle zum Erstellen benutzerdefinierter Budgets

1. Erstellen Sie mit den folgenden Schritten eine Datenbank und ein Schema, um ein benutzerdefiniertes Budget erstellen zu können:

   SQLSnowsight

   1. Erstellen Sie die Datenbank und das Schema, in dem Sie das benutzerdefinierte Budget erstellen möchten:

      USE ROLE ACCOUNTADMIN;
      
      CREATE DATABASE budgets_db;
      
      CREATE SCHEMA budgets_db.budgets_schema;
      

      Copy

2. Erstellen Sie die benutzerdefinierte Rolle account_budget_admin für den Budgetadministrator des Kontobudgets. Der Budgetadministrator des Kontobudgets kann die folgenden Aktionen für das Kontobudget ausführen:

   • Aktivieren und Deaktivieren des Kontobudgets

   • Festlegen des Ausgabenlimits

   • Bearbeiten der Benachrichtigungseinstellungen

   • Überwachen der Credit-Nutzung für das Konto

   USE ROLE ACCOUNTADMIN;
   
   CREATE ROLE account_budget_admin;
   
   GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_ADMIN TO ROLE account_budget_admin;
   
   GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE TO ROLE account_budget_admin;
   

   Copy

3. Erstellen Sie die benutzerdefinierte Rolle account_budget_monitor, die den Kontobudgetüberwachern zugewiesen werden soll. Ein Kontobudgetüberwacher kann die folgenden Aktionen für das Kontobudget ausführen:

   • Überwachen der Credit-Nutzung für das Konto

   • Sehen Sie sich die Einstellungen für E-Mail-Benachrichtigungen an.

   • Sehen Sie sich die monatliche Ausgabenlimit für das Konto an.

   USE ROLE ACCOUNTADMIN;
   
   CREATE ROLE account_budget_monitor;
    
   GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_VIEWER TO ROLE account_budget_monitor;
   
   GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE TO ROLE account_budget_monitor;
   

   Copy

4. Erstellen Sie eine benutzerdefinierte Rolle budget_owner mit der erforderlichen Rolle und den erforderlichen Berechtigungen, um benutzerdefinierte Budgets im Schema budgets_db.budgets_schema zu erstellen:

   USE ROLE ACCOUNTADMIN;
      
   CREATE ROLE budget_owner;
     
   GRANT USAGE ON DATABASE budgets_db TO ROLE budget_owner;
   GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_owner;
   
   GRANT DATABASE ROLE SNOWFLAKE.BUDGET_CREATOR TO ROLE budget_owner;
   
   GRANT CREATE SNOWFLAKE.CORE.BUDGET ON SCHEMA budgets_db.budgets_schema
     TO ROLE budget_owner;
   

   Copy

5. Erstellen Sie zwei benutzerdefinierte Rollen zum Verwalten und Überwachen benutzerdefinierter Budgets. Diese Rollen werden später im Tutorial mit zusätzlichen Berechtigungen ausgestattet, nachdem das benutzerdefinierte Budget erstellt wurde. Um die benutzerdefinierten Rollen zu erstellen, gehen Sie folgendermaßen vor:

   1. Erstellen Sie eine benutzerdefinierte Rolle budget_admin, die ein benutzerdefiniertes Budget verwalten und überwachen kann:

      USE ROLE ACCOUNTADMIN;
      
      CREATE ROLE budget_admin;
      
      GRANT USAGE ON DATABASE budgets_db TO ROLE budget_admin;
      
      GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_admin;
      
      GRANT DATABASE ROLE SNOWFLAKE.USAGE_VIEWER TO ROLE budget_admin;
      

      Copy

   1. Erstellen Sie eine benutzerdefinierte Rolle budget_monitor, die ein benutzerdefiniertes Budget überwachen kann:

   USE ROLE ACCOUNTADMIN;
   
   CREATE ROLE budget_monitor;
   
   GRANT USAGE ON DATABASE budgets_db TO ROLE budget_monitor;
   
   GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_monitor;
   
   GRANT DATABASE ROLE SNOWFLAKE.USAGE_VIEWER TO ROLE budget_monitor;
   

   Copy

6. Weisen Sie sich selbst die benutzerdefinierten Budgetrollen zu, die Sie in zukünftigen Schritten des Tutorials benötigt werden:

   SQLSnowsight

   1. Weisen Sie sich selbst die Rolle account_budget_admin zu:

      GRANT ROLE account_budget_admin
        TO USER <YOUR_USER_NAME>;
      

      Copy

   2. Weisen Sie sich selbst die Rolle account_budget_monitor zu:

      GRANT ROLE account_budget_monitor
        TO USER <YOUR_USER_NAME>;
      

      Copy

   3. Weisen Sie sich selbst die Rolle budget_owner zu:

      GRANT ROLE budget_owner
        TO USER <YOUR_USER_NAME>;
      

      Copy

   4. Weisen Sie sich selbst die Rolle budget_monitor zu:

      GRANT ROLE budget_monitor
        TO USER <YOUR_USER_NAME>;
      

      Copy

In diesem Abschnitt haben Sie benutzerdefinierte Rollen zur Verwaltung und Überwachung von Budgets erstellt und benutzerdefinierte Budgets erstellt.

Objekte für das benutzerdefinierte Budget erstellen¶

In diesem Schritt erstellen Sie Objekte, die einem benutzerdefinierten Budget hinzugefügt werden sollen, und erteilen den benutzerdefinierten Rollen, die Sie im vorherigen Schritt erstellt haben, die erforderlichen Berechtigungen. Sie werden die folgenden Objekte erstellen:

• Ein Warehouse, dem ein benutzerdefiniertes Budget hinzugefügt werden soll

• Ein Datenbank, dem ein benutzerdefiniertes Budget hinzugefügt werden soll

1. Erstellen Sie ein Warehouse, und erteilen Sie den von Ihnen erstellten benutzerdefinierten Rollen die Berechtigungen USAGE und APPLYBUDGET für dieses Warehouse. Die Berechtigung APPLYBUDGET ist erforderlich, um ein Objekt zu einem Budget hinzuzufügen.

   SQLSnowsight

   1. Erstellen Sie das Warehouse na_finance_wh:

      CREATE WAREHOUSE na_finance_wh;
      

      Copy

   2. Weisen den benutzerdefinierte Budgetrollen die USAGE-Berechtigung zu:

      GRANT USAGE ON WAREHOUSE na_finance_wh TO ROLE account_budget_admin;
      GRANT USAGE ON WAREHOUSE na_finance_wh TO ROLE account_budget_monitor;
      GRANT USAGE ON WAREHOUSE na_finance_wh TO ROLE budget_admin;
      GRANT USAGE ON WAREHOUSE na_finance_wh TO ROLE budget_owner;
      GRANT USAGE ON WAREHOUSE na_finance_wh TO ROLE budget_monitor;
      

      Copy

   3. Weisen Sie der Rolle budget_owner die Berechtigung APPLYBUDGET für das Warehouse zu:

      GRANT APPLYBUDGET ON WAREHOUSE na_finance_wh TO ROLE budget_owner;
      

      Copy

2. Erstellen Sie eine Datenbank, und erteilen Sie der von Ihnen erstellten benutzerdefinierten Budget-Eigentümerrolle die Berechtigung APPLYBUDGET für diese Datenbank. Die Berechtigung APPLYBUDGET ist erforderlich, um ein Objekt zu einem Budget hinzuzufügen.

   SQLSnowsight

   1. Erstellen Sie eine Datenbank:

      CREATE DATABASE na_finance_db;
      

      Copy

   2. Weisen Sie der Rolle budget_owner die Berechtigung APPLYBUDGET für die Datenbank zu:

      GRANT APPLYBUDGET ON DATABASE  na_finance_db TO ROLE budget_owner;
      

      Copy

In diesem Abschnitt haben Sie die Objekte erstellt, die einem benutzerdefinierten Budget hinzugefügt werden sollen, und die Berechtigung APPLYBUDGET erteilt, die zum Hinzufügen dieser Objekte zu einem Budget erforderlich ist. Sie haben auch die Datenbank und das Schema erstellt, in dem das benutzerdefinierte Budget erstellt werden soll, sowie die Berechtigung USAGE erteilt, die zum Erstellen eines Budgets im Schema erforderlich ist. Jetzt können Sie Budgets aktivieren, erstellen und einrichten.

Kontobudget aktivieren und einrichten¶

Das Kontobudget überwacht die Credit-Nutzung für die Computekosten aller von Budgets unterstützten Objekte des Kontos, einschließlich der Wartungsaufgaben im Hintergrund (z. B. Automatic Clustering) und der serverlosen Features. Das Kontobudget muss aktiviert werden, bevor es mit der Überwachung der Credit-Nutzung beginnen kann. Nach der Aktivierung können Sie das monatliche Ausgabenlimit für das Konto sowie die E-Mail-Liste der Benachrichtigungsempfänger festlegen. Budgets senden eine Benachrichtigung per E-Mail, wenn die Credit-Nutzung voraussichtlich das monatliche Ausgabenlimit überschreitet.

Führen Sie zum Aktivieren und Einrichten des Kontobudgets die folgenden Schritte aus:

In diesem Abschnitt haben Sie das Kontobudget aktiviert und das Ausgabenlimit sowie die E-Mail-Adresse für den Erhalt von Budgetbenachrichtigungen festgelegt.

Kundenspezifisches Budget erstellen¶

Nachdem Sie nun Ihr Kontobudget aktiviert und eingerichtet haben, erstellen Sie ein benutzerdefiniertes Budget, um die Credit-Nutzung auf Ihrem Konto für eine bestimmte Gruppe von Objekten zu überwachen. Für dieses Tutorial fügen Sie das Warehouse na_finance_wh und die Datenbank na_finance_db zum benutzerdefinierten Budget hinzu.

Erstellen Sie benutzerdefinierte Budgets mit den folgenden Schritten:

1. Verwenden Sie die Rolle budget_owner, um das Budget na_finance_budget in budgets_db.budgets_schema zu erstellen:

   USE ROLE budget_owner;
   USE SCHEMA budgets_db.budgets_schema;
   USE WAREHOUSE na_finance_wh;
   
   CREATE SNOWFLAKE.CORE.BUDGET na_finance_budget();
   

   Copy

2. Stellen Sie die monatliche Ausgabenbeschränkung und die Liste der E-Mail-Benachrichtigungen für das Budget na_finance_budget wie folgt ein:

   SQLSnowsight

   1. Setzen Sie das monatliche Ausgabenlimit auf 500 Credits:

      CALL na_finance_budget!SET_SPENDING_LIMIT(500);
      

      Copy

   2. Um die Benachrichtigungsliste einzurichten, verwenden Sie Ihre verifizierte E-Mail-Adresse und die im ersten Schritt des Tutorials erstellte Benachrichtigungsintegration:

      CALL na_finance_budget!SET_EMAIL_NOTIFICATIONS('budgets_notification_integration',
                                                     '<YOUR_EMAIL_ADDRESS>');
      

      Copy

   3. Fügen Sie die Datenbank na_finance_db und das Warehouse na_finance_wh zum Budget na_finance_budget hinzu:

      CALL na_finance_budget!ADD_RESOURCE(
        SYSTEM$REFERENCE('database', 'na_finance_db', 'SESSION', 'applybudget'));
      
      CALL na_finance_budget!ADD_RESOURCE(
        SYSTEM$REFERENCE('warehouse', 'na_finance_wh', 'SESSION', 'applybudget'));
      

      Copy

3. Weisen Sie den benutzerdefinierten Rollen, die Sie in einem früheren Schritt erstellt haben, Instanzrollen zu.

   1. Weisen Sie der Rolle budget_admin die erforderlichen Rollen und Berechtigungen zu, damit die Rolle budget_admin das benutzerdefinierte Budget na_finance_budget ändern und überwachen kann:

      USE ROLE budget_owner;
      
      GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.na_finance_budget!ADMIN
        TO ROLE budget_admin;
      

      Copy

   2. Weisen Sie der Rolle budget_monitor die VIEWER-Instanzrolle zu, damit die Rolle budget_monitor das benutzerdefinierte Budget na_finance_budget überwachen kann:

      USE ROLE budget_owner;
      
      GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.na_finance_budget!VIEWER
        TO ROLE budget_monitor;
      

      Copy

In diesem Abschnitt haben Sie ein benutzerdefiniertes Budget erstellt, Objekte für das zu überwachende Budget hinzugefügt und die E-Mail-Adresse eingerichtet, die Budgetbenachrichtigungen erhalten soll.

Überwachen der Credit-Nutzung¶

Sie haben alle Schritte des Tutorials ausgeführt, um Ihr Kontobudget zu aktivieren, ein benutzerdefiniertes Budget zu erstellen und benutzerdefinierte Rollen zu erstellen, um sowohl Konten als auch benutzerdefinierte Budgets zu überwachen und zu verwalten. Das Auffüllen der Daten zur Credit-Nutzung für Ihre Budgets nimmt einige Zeit in Anspruch.

Das Budget-Feature verwendet serverlose Aufgaben, um Credit-Nutzungsdaten für die Budgets in Ihrem Konto zu sammeln. Nachdem Sie das Kontobudget aktiviert oder ein benutzerdefiniertes Budget erstellt haben, dauert es eine Weile, bis die serverlose Aufgabe ausgeführt wird. Nachdem die Daten zur Credit-Nutzung verfügbar sind, können Sie die Credit-Nutzung für Budgets mit Snowsight überwachen.

Um die Credit-Nutzung zu überwachen, nachdem die Nutzungsdaten verfügbar sind, gehen Sie wie folgt vor:

USE ROLE account_budget_monitor;

CALL snowflake.local.account_root_budget!GET_SPENDING_HISTORY(
  TIME_LOWER_BOUND => DATEADD('days', -7, CURRENT_TIMESTAMP()),
  TIME_UPPER_BOUND => CURRENT_TIMESTAMP()
);

USE ROLE account_budget_monitor;

CALL snowflake.local.account_root_budget!GET_SERVICE_TYPE_USAGE(
   SERVICE_TYPE => 'SEARCH_OPTIMIZATION',
   TIME_DEPART => 'day',
   USER_TIMEZONE => 'UTC',
   TIME_LOWER_BOUND => DATEADD('day', -7, CURRENT_TIMESTAMP()),
   TIME_UPPER_BOUND => CURRENT_TIMESTAMP()
);

USE ROLE budget_monitor;

CALL budgets_db.budgets_schema.na_finance_budget!GET_SPENDING_HISTORY(
  TIME_LOWER_BOUND => DATEADD('days', -7, CURRENT_TIMESTAMP()),
  TIME_UPPER_BOUND => CURRENT_TIMESTAMP()
);

Bereinigung, Zusammenfassung und zusätzliche Ressourcen¶

Herzlichen Glückwunsch! Sie haben dieses Tutorial erfolgreich abgeschlossen.

Nachdem die Daten zur Credit-Nutzung für Ihr Kontobudget und Ihr benutzerdefiniertes Budget bereitgestellt wurden, können Sie mit Überwachen von Budgets mit Snowsight fortfahren.

USE ROLE budget_owner;

DROP SNOWFLAKE.CORE.BUDGET budgets_db.budgets_schema.na_finance_budget;

USE ROLE ACCOUNTADMIN;

DROP DATABASE na_finance_db;
DROP WAREHOUSE na_finance_wh;
DROP DATABASE budgets_db;

USE ROLE ACCOUNTADMIN;

DROP ROLE budget_monitor;
DROP ROLE budget_admin;
DROP ROLE budget_owner;

USE ROLE ACCOUNTADMIN;

DROP ROLE account_budget_monitor;
DROP ROLE account_budget_admin;

USE ROLE ACCOUNTADMIN;

DROP NOTIFICATION INTEGRATION budgets_notification_integration;