Budgets personnalisés¶

Héritage de balises¶

L’ajout d’une balise à un budget suit tous les objets avec cette balise, y compris les objets qui ont hérité de la balise d’un objet parent. Par exemple, si une base de données possède une balise, les tables de la base de données héritent de la balise et seront suivies par un budget. Étant donné qu’un budget suit l’utilisation en fonction d’une paire balise/valeur, si vous remplacez la valeur de la balise au niveau de la table, le suivi de l’utilisation associée à la table par le budget peut changer. Par exemple, supposons que vous ayez un budget qui suit les objets avec la balise team = 'eng'. Si la base de données possède la balise team = 'eng', mais une table de la base de données possède la balise team = 'IT', le budget ne surveillera pas les coûts associés à cette table.

Dans le contexte des budgets, les balises ne sont pas héritées d’un compte, car le budget du compte est destiné à répondre à ce cas d’utilisation.

Pour plus d’informations, notamment sur la manière de remplacer les valeurs des balises, voir Héritage de balises.

Suivi d’un objet avec plusieurs budgets¶

Plusieurs budgets peuvent ajouter la même paire balise/valeur, ce qui signifie que plus de budgets peuvent suivre l’utilisation du crédit du même objet. Par exemple, supposons que vous ajoutiez la balise cost_center = 'eng' à la fois à budget_1 et à budget_2. Quand un entrepôt avec la balise cost_center = 'eng' consomme des crédits, ces derniers seront comptabilisés dans la limite de crédit à la fois de budget_1 et de budget_2.

Un objet peut également être suivi par plusieurs budgets s’il possède plusieurs balises. Par exemple, supposons qu’un entrepôt possède deux balises : cost_center = 'finance' et stage = 'dev'. Vous pouvez créer un budget qui suit cost_center = 'finance' et un autre qui suit stage = 'dev'. Les crédits consommés par l’entrepôt seront comptabilisés dans la limite de crédit des deux budgets.

Limites et considérations¶

Lorsque vous utilisez des balises pour surveiller des objets, gardez à l’esprit les points suivants :

• Lorsque vous modifiez une balise sur un objet, il peut s’écouler jusqu’à six heures avant que le changement soit répercuté dans les budgets qui utilisent des balises.

• Actuellement, les alertes ne peuvent pas être surveillées avec des balises. Vous devez les ajouter individuellement.

• Les modifications apportées aux balises au cours des deux premiers jours du mois sont répercutées dans l’utilisation du mois précédent.

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.

L’exemple suivant crée un rôle nommé budget_owner et accorde 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 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é.

Utiliser l”Snowsight pour créer un budget personnalisé¶

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

4. Sélectionner (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électionner + Tag & resources, puis ajoutez les balises et les ressources que vous souhaitez ajouter au budget personnalisé.

   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.

   • Si vous ajoutez directement des objets individuels, vous ne pouvez ajouter un objet qu’à un seul budget personnalisé. Dans ce cas, 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. Ce comportement ne s’applique pas à l’utilisation de balises pour ajouter des objets aux budgets ; un objet avec une ou plusieurs balises peut être inclus dans plusieurs budgets personnalisés si vous utilisez des balises pour ajouter l’objet aux budgets.

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é.

Utiliser les commandes SQL pour créer un budget personnalisé¶

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 des notifications pour le budget afin de recevoir des notifications lorsque votre utilisation du crédit devrait dépasser vos limites de dépenses.

   Voir Notifications pour les budgets.

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 Ajouter des objets à un budget personnalisé ou les supprimer.

Exemple de rôle personnalisé¶

Accorder au rôle personnalisé budget_admin la possibilité de surveiller et de modifier le budget my_budget dans le schéma budgets_db.budgets_schema :

• Accordez les privilèges requis et le rôle d’instance au rôle personnalisé budget_admin pour le budget my_budget dans le schéma budgets_db.budgets_schema :

  GRANT USAGE ON DATABASE budgets_db TO ROLE budget_admin;
  
  GRANT USAGE ON SCHEMA budget_db.budgets_schema TO ROLE budget_admin;
  
  GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
     TO ROLE budget_admin;
  
  GRANT DATABASE ROLE SNOWFLAKE.USAGE_VIEWER TO ROLE budget_admin;
  

  Copy

• Accordez le privilège APPLYBUDGET sur les objets et les balises à ajouter ou à retirer d’un budget personnalisé. Cette étape est nécessaire pour chaque objet ou balise à ajouter ou à supprimer.

  Par exemple, pour permettre au rôle budget_admin d’ajouter la base de données db1 au budget personnalisé my_budget, exécutez les instructions suivantes :

  GRANT USAGE ON DATABASE db1 TO ROLE budget_admin;
  
  GRANT APPLYBUDGET ON DATABASE db1 TO ROLE budget_admin;
  

  Copy

Utiliser l”Snowsight pour ajouter des balises à un budget personnalisé ou les supprimer¶

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

4. Sélectionnez le budget à modifier.

5. Dans le tableau de bord, sélectionnez. (icône de modification).

6. Sélectionnez + Tags & resources.

7. Développer Tags et naviguez jusqu’à la balise que vous souhaitez ajouter.

8. Effectuez au choix :

   • Si la balise a un liste des valeurs autorisées, sélectionnez une ou plusieurs valeurs.

   • Si la balise peut être définie sur une valeur quelconque, spécifiez la valeur.

9. Sélectionnez Done.

Utiliser les commandes SQL pour ajouter des balises à un budget personnalisé ou les supprimer¶

Le rôle utilisé pour ajouter une balise à un budget ou la supprimer doit avoir le privilège APPLYBUDGET sur la balise. 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 balises déjà présentes dans le budget personnalisé, appelez la méthode <budget_name> !GET_LINKED_TAGS du budget. Par exemple, pour afficher la liste des balises 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_TAGS();

Les balises doivent être ajoutées à un budget ou supprimées par référence.

1. Vous pouvez ajouter la balise cost_mgmt_db.tags.cost_center au budget my_budget en suivant les étapes ci-dessous :

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

      GRANT APPLYBUDGET ON TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. Transmettez une référence pour la balise cost_center à la méthode d’instance ADD_TAG en exécutant l’instruction suivante : La valeur de la balise est définie sur finance.

      CALL budgets_db.budgets_schema.my_budget!ADD_TAG(
         SELECT SYSTEM$REFERENCE('TAG',
            'cost_mgmt_db.tags.cost_center',
            'SESSION',
            'applybudget'),
            'finance');
      

      Copy

      La fonction SYSTEM$REFERENCE crée une référence à la balise cost_center, avec le privilège APPLYBUDGET accordé à la balise. Cela permet au budget de surveiller les objets de votre compte qui ont la paire balise/valeur spécifiée 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_TAG 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 »).

2. Vous pouvez supprimer la balise cost_center 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 TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. Supprimez la balise en transmettant une référence à la méthode de l’instance REMOVE_TAG :

      CALL budgets_db.budgets_schema.my_budget!REMOVE_TAG(
         SELECT SYSTEM$REFERENCE('TAG',
            'cost_mgmt_db.tags.cost_center',
            'SESSION',
            'applybudget'),
            'finance');
      

      Copy

Utiliser l”Snowsight pour ajouter ou supprimer des objets d’un budget personnalisé¶

1. Connectez-vous à Snowsight.

2. Sélectionnez Admin » Cost Management.

3. Sélectionnez Budgets.

4. Sélectionnez le budget à modifier.

5. Dans le tableau de bord, sélectionnez. (icône de modification).

6. Sélectionnez + Tags & resources, puis sélectionnez les objets que vous souhaitez ajouter au budget personnalisé.

   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.

   • Si vous ajoutez directement des objets individuels, vous ne pouvez ajouter un objet qu’à un seul budget personnalisé. Dans ce cas, 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. Ce comportement ne s’applique pas à l’utilisation de balises pour ajouter des objets aux budgets ; un objet avec une ou plusieurs balises peut être inclus dans plusieurs budgets personnalisés si vous utilisez des balises pour ajouter l’objet aux budgets.

7. Sélectionnez Done.

Utiliser les commandes SQL pour ajouter ou supprimer des objets d’un budget personnalisé¶

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 <budget_name>!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(
         SELECT 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 »).

      Note

      Si vous souhaitez ajouter une Snowflake Native App à un budget, lorsque vous appelez SYSTEM$REFERENCE, spécifiez 'DATABASE' (et non 'APPLICATION') pour l’argument object_type.

      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

      Si vous ajoutez directement des objets individuels, vous ne pouvez ajouter un objet qu’à un seul budget personnalisé. Dans ce cas, 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. Ce comportement ne s’applique pas à l’utilisation de balises pour ajouter des objets aux budgets ; un objet avec une ou plusieurs balises peut être inclus dans plusieurs budgets personnalisés si vous utilisez des balises pour ajouter l’objet aux budgets.

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(
         SELECT SYSTEM$REFERENCE('DATABASE', 'db1', 'SESSION', 'applybudget'));
      

      Copy