Créer et activer des budgets personnalisés¶

Créer un rôle personnalisé pour gérer le budget du compte¶

Vous pouvez créer un rôle personnalisé pour activer et modifier le budget du compte. Un utilisateur qui se voit attribuer ce rôle peut agir en tant qu’administrateur du budget et 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.

Pour obtenir la liste complète des rôles et privilèges requis pour le rôle d’administrateur du budget, voir Rôles et privilèges Budgets.

Par exemple, créez le rôle account_budget_admin et donnez-lui la possibilité de contrôler et de gérer le budget du 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;

Activation et configuration du budget du compte à l’aide de Snowsight¶

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

4. Si vous y êtes invité, sélectionnez un entrepôt.

5. Dans le coin supérieur droit du tableau de bord, sélectionnez Set up Account Budget.

6. Saisissez la limite de dépenses cible pour le compte.

7. Saisissez les adresses e-mail qui recevront les courriels de notification.

   Note

   Chaque adresse e-mail ajoutée pour les notifications de budget doit être vérifiée. La configuration des e-mails de notification échoue si une adresse e-mail de la liste n’est pas vérifiée.

8. Sélectionnez Finish Setup.

Activation et configuration du budget du compte à l’aide de SQL¶

1. Activer le budget du compte en utilisant la méthode budget_racine_compte!ACTIVATE :

   CALL snowflake.local.account_root_budget!ACTIVATE();
   

   Copy

2. Fixer la limite de dépenses à l’aide de la méthode <nom_budget>!SET_SPENDING_LIMIT :

   CALL snowflake.local.account_root_budget!SET_SPENDING_LIMIT(1000);
   

   Copy

3. Créez une intégration de notification avec les adresses e-mail qui recevront les notifications de budget.

   Note

   Chaque adresse e-mail ajoutée pour les notifications de budget doit être vérifiée. La configuration des notifications par e-mail échoue si une adresse e-mail de la liste n’est pas vérifiée.

   Cette étape est facultative. Si vous disposez d’une intégration de notification existante avec des adresses e-mail vérifiées dans la liste ALLOWED_RECIPIENTS , passez à l’étape suivante.

   CREATE NOTIFICATION INTEGRATION budgets_notification_integration
     TYPE=EMAIL
     ENABLED=TRUE
     ALLOWED_RECIPIENTS=('costadmin@example.com','budgetadmin@example.com');
   

   Copy

   Pour plus d’informations sur la création d’une intégration de notification, voir Créer une intégration des notifications par e-mail.

4. Accordez le privilège USAGE sur l’intégration des notifications à l’application SNOWFLAKE. Le privilège USAGE permet au budget d’utiliser l’intégration de notification pour envoyer des e-mails :

   GRANT USAGE ON INTEGRATION budgets_notification_integration
     TO APPLICATION snowflake;
   

   Copy

5. Définissez la notification par e-mail pour le budget du compte en utilisant la méthode <nom_budget>!SET_EMAIL_NOTIFICATIONS :

   CALL snowflake.local.account_root_budget!SET_EMAIL_NOTIFICATIONS(
      'budgets_notification_integration',
      'costadmin@example.com, budgetadmin@example.com');
   

   Copy

Après avoir activé et configuré le budget du compte, vous pouvez permettre à un utilisateur qui n’est pas administrateur de surveiller le budget du compte en utilisant un rôle personnalisé. Pour plus d’informations, voir Créer un rôle personnalisé pour surveiller le budget du compte.

Créer un rôle personnalisé pour créer des budgets¶

Vous pouvez utiliser un rôle personnalisé pour créer des budgets dans votre compte. Pour obtenir la liste complète des privilèges et des rôles qui doivent être accordés à un rôle pour créer un budget personnalisé, voir Rôles et privilèges Budgets.

Par exemple, créez un rôle budget_owner et accordez le rôle et les privilèges requis pour créer des budgets personnalisés dans le schéma budgets_db.budgets_schema. L’exemple suivant doit être exécuté en utilisant le rôle ACCOUNTADMIN :

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;

Si vous souhaitez permettre à un rôle autre que le propriétaire du budget de modifier les paramètres d’un budget personnalisé, vous pouvez créer un rôle personnalisé avec des privilèges de modification. Pour plus d’informations, voir Créer un rôle personnalisé pour gérer un budget personnalisé.

Création d’un budget personnalisé à l’aide de Snowsight¶

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

4. Dans le coin supérieur droit du tableau de bord, sélectionnez (Ajouter un budget).

5. Entrez un Budget name.

6. Sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer votre budget.

7. Entrez le Spending limit.

8. Indiquez les adresses e-mail qui reçoivent les notifications.

   Note

   Chaque adresse e-mail ajoutée pour les notifications de budget doit être vérifiée. La configuration des e-mails de notification échoue si une adresse e-mail de la liste n’est pas vérifiée.

9. Sélectionnez Resources to monitor.

   • Pour ajouter une base de données, développez Databases pour sélectionner une base de données.

   • Pour ajouter des objets dans un schéma, développez le schéma pour obtenir la liste des objets disponibles. Développez la catégorie d’objets (par exemple, Tables ou Tasks) pour sélectionner les objets.

   • Pour ajouter un entrepôt, développez Warehouses et sélectionnez un entrepôt.

   • Pour ajouter un pool de calcul, développez Compute Pools pour sélectionner un pool de calcul.

   Note

   • Lorsque vous sélectionnez une base de données ou un schéma, tous les objets pris en charge (par exemple, les tables) contenus dans la base de données ou le schéma sont également ajoutés au budget.

   • Vous ne pouvez ajouter un objet qu’à un seul budget personnalisé. Si un objet est actuellement inclus dans un budget personnalisé et que vous ajoutez cet objet à un deuxième budget personnalisé, Budgets supprime l’objet du premier budget personnalisé sans émettre d’avertissement.

Après avoir créé et configuré un budget personnalisé, vous pouvez créer un rôle personnalisé pour permettre aux administrateurs ne possédant pas de compte de surveiller les ressources et l’utilisation du budget. Pour plus d’informations, voir Créer un rôle personnalisé pour surveiller un budget personnalisé.

Création d’un budget personnalisé à l’aide de SQL¶

Créez un budget personnalisé, puis définissez la limite de dépenses et les adresses e-mail de notification.

1. Examinez les budgets existants dans votre compte :

   Note

   L’instruction suivante renvoie les budgets pour lesquels vous disposez de privilèges d’accès. Seul un utilisateur ayant le rôle ACCOUNTADMIN peut voir tous les budgets du compte.

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

2. Créez le budget my_budget dans budgets_db.budgets_schema en utilisant la commande CREATE BUDGET :

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

   Copy

3. Fixez une limite de dépenses mensuelles. Par exemple, fixez la limite de dépenses à 500 crédits par mois :

   CALL my_budget!SET_SPENDING_LIMIT(500);
   

   Copy

4. Définissez l’intégration de la notification et les adresses e-mail :

   Note

   • Si vous n’avez pas encore créé d’intégration de notification par e-mail, voir les étapes à la section sur le budget du compte pour en créer une.

   • Pour envoyer des notifications, l’application SNOWFLAKE doit se voir accorder le privilège USAGE sur l’intégration de notification :

     GRANT USAGE ON INTEGRATION budgets_notification_integration
       TO APPLICATION snowflake;
     

     Copy

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

   Copy

Après avoir créé et configuré un budget personnalisé, vous pouvez créer un rôle personnalisé pour permettre aux administrateurs ne possédant pas de compte de surveiller les ressources et l’utilisation du budget. Pour plus d’informations, voir Créer un rôle personnalisé pour surveiller un budget personnalisé.

Pour ajouter des objets à votre nouveau budget, consultez Ajout et suppression d’objets dans un budget personnalisé.

Créer un rôle personnalisé pour gérer un budget personnalisé¶

Pour contrôler et modifier un budget personnalisé, vous pouvez accorder des privilèges et des rôles d’instance à un rôle personnalisé. Pour obtenir la liste complète des privilèges et des rôles qui doivent être accordés à un rôle pour modifier un budget personnalisé, voir Rôles et privilèges Budgets.

Ajouter ou supprimer des objets d’un budget personnalisé à l’aide de Snowsight¶

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

4. Sélectionnez le budget à modifier.

5. Dans le coin supérieur droit du tableau de bord, sélectionnez (icône de modification).

6. Sélectionnez + Resources.

   • Pour ajouter ou supprimer une base de données, développez Databases pour sélectionner ou désélectionner une base de données.

   • Pour ajouter ou supprimer des objets dans un schéma, développez le schéma pour obtenir la liste des objets disponibles. Développez la catégorie d’objets (par exemple, Tables ou Tasks) pour sélectionner ou désélectionner des objets.

   • Pour ajouter ou supprimer un entrepôt, développez Warehouses pour sélectionner ou désélectionner un entrepôt.

   • Pour ajouter ou supprimer un pool de calcul, développez Compute Pools pour sélectionner ou désélectionner un pool de calcul.

   Note

   • Lorsque vous sélectionnez une base de données ou un schéma, tous les objets pris en charge (par exemple, les tables) contenus dans la base de données ou le schéma sont également ajoutés au budget.

   • Vous ne pouvez ajouter un objet qu’à un seul budget personnalisé. Si un objet est actuellement inclus dans un budget personnalisé et que vous ajoutez cet objet à un deuxième budget personnalisé, Budgets supprime l’objet du premier budget personnalisé sans émettre d’avertissement.

7. Sélectionnez Done.

Ajoutez ou supprimez des objets d’un budget personnalisé à l’aide de SQL¶

Le rôle utilisé pour ajouter ou supprimer un objet d’un budget doit avoir le privilège APPLYBUDGET sur l’objet. Pour plus d’informations, voir les exemples à la section Créer un rôle personnalisé pour gérer un budget personnalisé.

Pour consulter la liste des objets déjà présents dans le budget personnalisé, appelez la méthode <nom_budget>!GET_LINKED_RESOURCES du budget. Par exemple, pour afficher la liste des objets du budget my_budget dans le schéma budgets_db.budgets_schema , exécutez l’instruction suivante :

CALL budgets_db.budgets_schema.my_budget!GET_LINKED_RESOURCES();

L’instruction renvoie la sortie suivante :

+-------------+-----------------+-----------+-------------+---------------+
| RESOURCE_ID | NAME            | DOMAIN    | SCHEMA_NAME | DATABASE_NAME |
|-------------+-----------------+-----------+-------------+---------------|
|         326 | DB1             | DATABASE  | NULL        | NULL          |
|         157 | MY_WH           | WAREHOUSE | NULL        | NULL          |
+-------------+-----------------+-----------+-------------+---------------+

Les objets doivent être ajoutés ou supprimés d’un budget par référence.

1. Vous pouvez ajouter la table t1 au budget my_budget en suivant les étapes suivantes :

   1. Accordez le privilège APPLYBUDGET sur la table au rôle budget_admin en exécutant l’instruction suivante :

      GRANT APPLYBUDGET ON TABLE t1 TO ROLE budget_admin;
      

      Copy

   2. Transmettez une référence pour la table t1 à la méthode d’instance ADD_RESOURCE en exécutant l’instruction suivante :

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

      Copy

      La fonction SYSTEM$REFERENCE crée une référence à un objet TABLE, t1, avec le privilège APPLYBUDGET accordé à la table. Cela permet au budget de surveiller l’objet spécifié dans votre compte. Le troisième paramètre de la fonction spécifie la portée de la référence ; dans ce cas, « SESSION » crée une référence avec la portée de la session. Les références transmises à la méthode ADD_RESOURCE pour un budget peuvent être créées avec n’importe quelle portée de référence transitoire (c’est-à-dire que le troisième paramètre peut être soit « SESSION », soit « CALL »).

      Pour obtenir la liste complète des objets et des privilèges, voir Types d’objets pris en charge et privilèges pour les références.

      Note

      Vous ne pouvez ajouter un objet qu’à un seul budget personnalisé. Si un objet est actuellement inclus dans un budget personnalisé et que vous ajoutez cet objet à un deuxième budget personnalisé, Budgets supprime l’objet du premier budget personnalisé sans émettre d’avertissement.

2. Vous pouvez supprimer la base de données db1 du budget my_budget en procédant comme suit :

   1. Accordez le privilège APPLYBUDGET sur la base de données au rôle budget_admin en exécutant l’instruction suivante :

      GRANT APPLYBUDGET ON DATABASE db1 TO ROLE budget_admin;
      

      Copy

   2. Supprimez la base de données en transmettant une référence à la méthode de l’instance REMOVE_RESOURCE :

      CALL budgets_db.budgets_schema.my_budget!REMOVE_RESOURCE(
         SYSTEM$REFERENCE('DATABASE', 'db1', 'SESSION', 'applybudget'));
      

      Copy

Créer un rôle personnalisé pour surveiller le budget du compte¶

Vous pouvez créer un rôle personnalisé pour permettre aux utilisateurs qui ne sont pas administrateurs du compte de surveiller le budget du compte. Pour obtenir la liste complète des privilèges et des rôles qui doivent être accordés à un rôle pour contrôler le budget du compte, voir Rôles et privilèges Budgets.

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;

Créer un rôle personnalisé pour surveiller un budget personnalisé¶

Vous pouvez créer un rôle personnalisé pour permettre aux utilisateurs qui ne sont pas administrateurs de comptes de contrôler les budgets personnalisés. Pour obtenir la liste complète des privilèges et des rôles qui doivent être accordés à un rôle pour assurer le suivi d’un budget personnalisé, voir Rôles et privilèges Budgets.

USE ROLE custom_budget_owner;

GRANT USAGE ON DATABASE budgets_db TO ROLE budget_monitor;

GRANT USAGE ON SCHEMA budget_db.budgets_schema TO ROLE budget_monitor;

GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!VIEWER
  TO ROLE budget_monitor;

GRANT DATABASE ROLE SNOWFLAKE.USAGE_VIEWER TO ROLE budget_monitor;

Surveillance de budgets à l’aide de Snowsight¶

Vous pouvez visualiser les dépenses budgétaires actuelles et historiques en utilisant la page Budgets dans Snowsight.

Vous pouvez visualiser les dépenses budgétaires actuelles et historiques en utilisant la page Budgets dans Snowsight.

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

Dans la vue Current Month d’un budget, vous pouvez examiner l’utilisation du crédit par jour jusqu’au jour en cours. Vous pouvez voir si vous risquez de dépasser votre budget pour le mois. Le graphique à barres continue jusqu’à la fin du mois avec votre utilisation du crédit projetée basée sur votre utilisation du crédit réelle pour le mois. La ligne Spending limit indique la limite de dépenses à partir de laquelle une notification de budget est déclenchée.

Sélectionnez (mois à afficher) pour filtrer la vue par Current Month ou des périodes plus longues.

Vous pouvez comparer Spend (utilisation actuelle du crédit) à Interval (temps restant dans le mois en cours) pour voir si vos dépenses dépassent votre budget mensuel.

Vous pouvez filtrer la vue en sélectionnant Budgets ou Resources :

• Vous pouvez sélectionner un budget personnalisé dans la vue Budgets pour obtenir des détails sur un budget spécifique.

  Note

  La liste Service Type pour un budget personnalisé comprend un type Unused Resources. Ce type de service est affiché lorsqu’un objet dans un budget n’a pas de données d’utilisation du crédit à afficher. Cela peut se produire si l’objet n’a pas d’utilisation du crédit pour les coûts de calcul, ou si vous avez récemment ajouté un objet à un budget et que la tâche d’arrière-plan sans serveur n’a pas encore été exécutée.

• Dans la vue Resources, vous pouvez filtrer et trier par Service Type, objet Name et Credit Usage.

Surveillance de budgets à l’aide de SQL¶

Pour surveiller le budget du compte, vous devez disposer des privilèges requis. Pour plus d’informations, voir Créer un rôle personnalisé pour surveiller le budget du compte.

Utilisez le rôle account_budget_monitor pour voir l’historique des dépenses pour le budget du compte :

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

Vous pouvez surveiller l’historique des dépenses par type de service. Pour voir l’historique des dépenses de la fonction sans serveur d’optimisation de la recherche pour le budget du compte au cours de la semaine écoulée, exécutez les instructions suivantes :

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

Pour surveiller un budget personnalisé, vous devez disposer des privilèges requis. Pour plus d’informations, voir Créer un rôle personnalisé pour surveiller un budget personnalisé.

Utilisez le rôle budget_monitor pour voir l’historique des dépenses pour un budget personnalisé. Par exemple, pour voir l’historique des dépenses du budget personnalisé na_finance_budget dans le schéma budgets_db.budgets_schema, exécutez les instructions suivantes :

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

Vous pouvez surveiller l’historique des dépenses par type de service. Par exemple, pour consulter l’historique des dépenses pour les vues matérialisées incluses dans le budget, exécutez les instructions suivantes :

USE ROLE budget_monitor;

CALL budgets_db.budgets_schema.na_finance_budget!GET_SERVICE_TYPE_USAGE(
   SERVICE_TYPE => 'MATERIALIZED_VIEW',
   TIME_DEPART => 'day',
   USER_TIMEZONE => 'UTC',
   TIME_LOWER_BOUND => DATEADD('day', -7, CURRENT_TIMESTAMP()),
   TIME_UPPER_BOUND => CURRENT_TIMESTAMP()
);

Pour plus d’informations, voir Méthodes Budgets.

Désactivation du budget du compte avec Snowsight¶

Vous pouvez désactiver le budget du compte en utilisant la page Budgets :

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

4. Sélectionnez le menu … plus en haut à droite.

5. Sélectionnez Deactivate account budget.

Désactivation du budget du compte avec SQL¶

Vous pouvez utiliser la méthode budget_racine_compte!DEACTIVATE pour désactiver le budget du compte :

CALL snowflake.local.account_root_budget!DEACTIVATE();