Tutoriel : Premiers pas avec les budgets¶

Introduction¶

Ce tutoriel vous présente la surveillance de l’utilisation du crédit au niveau du compte avec Budgets en configurant le budget du compte et en créant un budget personnalisé qui surveille un groupe d’objets spécifiés.

Avec Budgets, vous pouvez surveiller l’utilisation du crédit pour les coûts de calcul des objets pris en charge, y compris l’utilisation du crédit pour les tâches de maintenance en arrière-plan et les fonctions sans serveur. Budgets vous permet de fixer une limite de dépenses mensuelle pour chaque budget et vous envoie un e-mail de notification lorsque vos dépenses actuelles devraient dépasser la limite de dépenses mensuelle.

Vous pouvez effectuer ce tutoriel en utilisant une feuille de calcul dans Snowsight ou en utilisant un client CLI tel que SnowSQL. Certaines parties de ce tutoriel peuvent être réalisées à l’aide de Snowsight.

À la fin de ce tutoriel, vous saurez comment effectuer les opérations suivantes :

• Créez des rôles personnalisés pour surveiller et gérer les budgets.

• Accordez les privilèges nécessaires pour ajouter des objets à un budget personnalisé.

• Activez et mettez en place un compte budget.

• Créez un budget personnalisé et ajoutez-y des objets.

Créer une intégration de notification¶

Budgets utilise une intégration de notification pour envoyer des e-mails de notification lorsque l’utilisation actuelle du crédit devrait dépasser la limite de dépenses mensuelle. La liste ALLOWED_RECIPIENTS doit inclure les adresses e-mail vérifiées des utilisateurs qui doivent recevoir les notifications de budgets.

Une intégration de la notification est nécessaire si vous effectuez le tutoriel à l’aide de SQL. Suivez les étapes ci-dessous pour en créer un.

Lorsque vous utilisez Snowsight pour établir un budget, l’intégration de la notification est automatiquement créée pour vous. Si vous utilisez Snowsight pour établir vos budgets, vous pouvez passer à l’étape suivante.

1. Exécutez l’instruction suivante pour créer une intégration de notification. Utilisez votre adresse e-mail vérifiée dans la liste ALLOWED_RECIPIENTS :

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

   Copy

2. Après avoir créé l’intégration de notification, accordez le privilège USAGE à l’application SNOWFLAKE. Ce privilège est nécessaire pour que Budgets puisse utiliser l’intégration des notifications pour envoyer des e-mails.

   Exécutez l’instruction suivante pour accorder le privilège USAGE à l’intégration de notification :

   GRANT USAGE ON INTEGRATION budgets_notification_integration
     TO APPLICATION snowflake;
   

   Copy

Créer une base de données, un schéma et des rôles personnalisés¶

Dans cette étape, les objets suivants sont créés pour que le tutoriel puisse créer, gérer et contrôler les budgets :

• Une base de données et un schéma dans lesquels créer des budgets personnalisés.

• Un rôle personnalisé pour gérer le budget du compte.

• Un rôle personnalisé pour surveiller le budget du compte.

• Un rôle personnalisé pour créer des budgets personnalisés.

1. Créez une base de données et un schéma dans lesquels vous pourrez créer un budget personnalisé en suivant les étapes suivantes:

   SQLSnowsight

   1. Créez la base de données et le schéma dans lesquels vous allez créer le budget personnalisé :

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

      Copy

2. Créez un rôle personnalisé account_budget_admin pour l’administrateur du budget du compte. L’administrateur du budget du compte peut effectuer les actions suivantes sur le budget du compte :

   • Activer ou désactiver le budget du compte.

   • Définir une limite de dépense.

   • Modifier les paramètres de notification.

   • Surveiller l’utilisation du crédit pour le compte.

   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. Créer un rôle personnalisé account_budget_monitor à accorder aux contrôleurs du budget de compte. Un contrôleur du budget de compte peut effectuer les actions suivantes sur le budget du compte :

   • Surveiller l’utilisation du crédit pour le compte.

   • Voir les paramètres de notification par e-mail.

   • Voir la limite de dépenses mensuelles pour le compte.

   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. Créer un rôle personnalisé budget_owner avec le rôle et les privilèges requis pour créer des budgets personnalisés dans le schéma budgets_db.budgets_schema :

   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. Créer deux rôles personnalisés pour gérer et surveiller les budgets personnalisés. Ces rôles se verront attribuer des privilèges supplémentaires plus loin dans le tutoriel, après la création du budget personnalisé. Pour créer les rôles personnalisés, procédez comme suit :

   1. Créez un rôle budget_admin personnalisé qui peut gérer et surveiller un budget personnalisé :

      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. Créez un rôle budget_monitor personnalisé qui peut surveiller un budget personnalisé :

   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. Accordez-vous des rôles de budgets personnalisés à utiliser dans les étapes ultérieures du tutoriel :

   SQLSnowsight

   1. Accordez-vous le rôle account_budget_admin :

      GRANT ROLE account_budget_admin
        TO USER <YOUR_USER_NAME>;
      

      Copy

   2. Accordez-vous le rôle account_budget_monitor :

      GRANT ROLE account_budget_monitor
        TO USER <YOUR_USER_NAME>;
      

      Copy

   3. Accordez-vous le rôle budget_owner :

      GRANT ROLE budget_owner
        TO USER <YOUR_USER_NAME>;
      

      Copy

   4. Accordez-vous le rôle budget_monitor :

      GRANT ROLE budget_monitor
        TO USER <YOUR_USER_NAME>;
      

      Copy

Dans cette section, vous avez créé des rôles personnalisés pour gérer et surveiller des budgets et créer des budgets personnalisés.

Créer les objets pour le budget personnalisé¶

Dans cette étape, créez des objets à ajouter à un budget personnalisé et accordez des privilèges aux rôles personnalisés que vous avez créés à l’étape précédente. Vous allez créer les objets suivants :

• Un entrepôt à ajouter à un budget personnalisé.

• Une base de données à ajouter à un budget personnalisé.

1. Créez un entrepôt et accordez les privilèges USAGE et APPLYBUDGET sur l’entrepôt aux rôles personnalisés que vous avez créés. Le privilège APPLYBUDGET est nécessaire pour ajouter un objet à un budget.

   SQLSnowsight

   1. Créez un entrepôt na_finance_wh :

      CREATE WAREHOUSE na_finance_wh;
      

      Copy

   2. Accordez le privilège USAGE à des rôles de budgets personnalisés :

      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. Accordez le privilège APPLYBUDGET sur l’entrepôt au rôle budget_owner :

      GRANT APPLYBUDGET ON WAREHOUSE na_finance_wh TO ROLE budget_owner;
      

      Copy

2. Créez une base de données et accordez le privilège APPLYBUDGET sur la base de données au rôle de propriétaire de budget personnalisé que vous avez créé. Le privilège APPLYBUDGET est nécessaire pour ajouter un objet à un budget.

   SQLSnowsight

   1. Créer une base de données :

      CREATE DATABASE na_finance_db;
      

      Copy

   2. Attribuez le privilège APPLYBUDGET sur la base de données au rôle budget_owner :

      GRANT APPLYBUDGET ON DATABASE  na_finance_db TO ROLE budget_owner;
      

      Copy

Dans cette section, vous avez créé les objets à ajouter à un budget personnalisé et accordé le privilège APPLYBUDGET nécessaire pour ajouter ces objets à un budget. Vous avez également créé la base de données et le schéma dans lesquels créer le budget personnalisé et vous avez accordé le privilège USAGE nécessaire à la création d’un budget dans le schéma. Vous êtes maintenant prêt à activer, créer et établir des budgets.

Activer et configurer le budget de compte¶

Le budget de compte surveille l’utilisation du crédit pour les coûts de calcul de tous les objets pris en charge par Budgets dans le compte, y compris les tâches de maintenance en arrière-plan (par exemple, le clustering automatique) et les fonctions sans serveur. Le budget de compte doit être activé avant de pouvoir commencer à surveiller l’utilisation du crédit. Une fois qu’il est activé, vous pouvez définir la limite de dépenses mensuelles pour le compte et la liste des e-mails des destinataires des notifications. Budgets envoie un e-mail de notification lorsque l’utilisation du crédit en cours devrait dépasser la limite de dépenses mensuelle.

Activer et configurer le budget de compte à l’aide des étapes suivantes :

Dans cette section, vous avez activé le budget du compte et défini la limite de dépenses ainsi que l’adresse e-mail pour recevoir les notifications de budget.

Création d’un budget personnalisé¶

Maintenant que vous avez activé et configuré le budget de votre compte, créez un budget personnalisé pour surveiller l’utilisation du crédit de votre compte pour un groupe d’objets donné. Pour ce tutoriel, ajoutez l’entrepôt na_finance_wh et na_finance_db au budget personnalisé.

Créez des budgets personnalisés en suivant les étapes suivantes :

1. Utilisez le rôle budget_owner pour créer le budget na_finance_budget dans budgets_db.budgets_schema :

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

   Copy

2. Définissez la limite des dépenses mensuelles et la liste des notifications par e-mail pour le budget na_finance_budget en suivant les étapes suivantes :

   SQLSnowsight

   1. Fixez la limite de dépenses mensuelles à 500 crédits :

      CALL na_finance_budget!SET_SPENDING_LIMIT(500);
      

      Copy

   2. Pour configurer la liste de notification, utilisez votre adresse e-mail vérifiée et l’intégration de notification créée à la première étape du tutoriel :

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

      Copy

   3. Ajoutez la base de données na_finance_db et l’entrepôt na_finance_wh au budget na_finance_budget :

      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. Attribuez des rôles d’instance aux rôles personnalisés que vous avez créés à l’étape précédente.

   1. Accordez les rôles et privilèges nécessaires au rôle budget_admin pour permettre au rôle budget_admin de modifier et de surveiller le budget personnalisé na_finance_budget :

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

      Copy

   2. Accordez le rôle d’instance VIEWER au rôle budget_monitor pour permettre au rôle budget_monitor de surveiller le budget personnalisé na_finance_budget :

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

      Copy

Dans cette section, vous avez créé un budget personnalisé, ajouté des objets à surveiller dans le cadre du budget et configuré l’adresse e-mail pour recevoir les notifications relatives au budget.

Contrôle de l’utilisation du crédit¶

Vous avez effectué toutes les étapes du tutoriel pour activer le budget de votre compte, créer un budget personnalisé et créer des rôles personnalisés pour surveiller et gérer à la fois le budget de compte et le budget personnalisé. Les données relatives à l’utilisation du crédit pour vos budgets prennent un certain temps à être alimentées.

Budgets utilise des tâches sans serveur pour collecter les données d’utilisation du crédit pour les budgets de votre compte. Après avoir activé le budget de compte ou créé un budget personnalisé, il faut un certain temps pour que la tâche sans serveur s’exécute. Une fois que les données relatives à l’utilisation du crédit sont disponibles, vous pouvez suivre l’utilisation du crédit pour les budgets à l’aide de Snowsight.

Pour surveiller l’utilisation du crédit après la mise à disposition des données d’utilisation, procédez comme suit :

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()
);

Nettoyage, résumé et ressources supplémentaires¶

Félicitations ! Vous avez terminé ce tutoriel.

Une fois que les données relatives à l’utilisation du crédit sont renseignées pour votre budget de compte et votre budget personnalisé, voir Surveillance de budgets à l’aide de Snowsight.

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;