Surveillance de l’utilisation du crédit à l’aide de Budgets¶

Budget du compte et budgets personnalisés¶

Pour commencer à utiliser les budgets dans Snowflake, activez le budget du compte. Le budget du compte contrôle les dépenses pour tous les objets pris en charge par dans le compte. Pour recevoir des notifications concernant le budget, définissez la limite de dépenses et indiquez les adresses e-mail qui recevront les notifications.

Vous pouvez également créer des budgets personnalisés pour surveiller les limites de dépenses pour un groupe spécifique d’objets pris en charge. Vous pouvez créer un budget personnalisé dans n’importe quelle base de données et n’importe quel schéma. Comme pour le budget du compte, vous devez définir la limite de dépenses et les adresses e-mail de notification afin de recevoir les courriels de notification.

Limite de dépenses et intervalle de temps¶

La limite de dépenses est exprimée en crédits Snowflake et n’est utilisée qu’à des fins d’alerte et de notification. La limite de dépenses est fixée pour un intervalle de temps d’un mois civil.

L’intervalle de temps commence à 12:00AM UTC le premier jour du mois et se termine à 11:59PM UTC le dernier jour du mois. Si un budget est créé après le premier jour du mois, le premier intervalle de suivi correspond à la période allant jusqu’au dernier jour du mois en cours, puis il est réinitialisé le premier du mois suivant.

Si vous activez votre budget de compte après le premier du mois, les données du début du mois sont rétablies et utilisées pour déterminer si vous allez dépasser votre limite de dépenses pour le mois.

Si vous créez un budget personnalisé après le premier du mois, les données historiques du mois ne sont pas remplies. Les prévisions de dépenses futures sont basées sur l’utilisation du crédit dans les jours qui suivent l’activation du budget.

Objets pris en charge¶

La liste des objets pris en charge contribue à la limite de dépenses pour le budget du compte. Pour un budget personnalisé, vous pouvez sélectionner des objets spécifiques à surveiller.

Un budget peut surveiller les objets suivants :

• Tables

• Vues matérialisées

• Schémas

• Bases de données

• Entrepôts virtuels

• Canaux

• Tâches

Notifications Budgets¶

Un budget envoie une notification d’alerte quotidienne lorsque les dépenses courantes sont en passe de dépasser la limite de dépenses, sur la base de prévisions chronologiques. Pour recevoir des notifications d’alerte automatiques, vous devez procéder comme suit :

• Fixer une limite de dépenses pour le budget.

• Mettre en place des notifications par courriel pour le budget.

Voici un exemple d’e-mail de notification :

Vous pouvez désactiver les notifications par e-mail pour un budget en appelant la méthode SET_NOTIFICATION_MUTE_FLAG.

Rôles et privilèges requis pour créer des budgets¶

Vous pouvez utiliser un rôle personnalisé pour créer des budgets personnalisés dans votre compte. Accordez le rôle et le privilège de base de données suivants au rôle personnalisé :

• Le rôle de base de données SNOWFLAKE SNOWFLAKE.BUDGET_CREATOR.

• Le privilège CREATE SNOWFLAKE.CORE.BUDGET sur le schéma dans lequel créer le budget.

Par exemple, créez un rôle budget_admin 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 :

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;

Rôles d’application pour gérer le budget du compte¶

Vous pouvez attribuer les rôles d’application suivants à un rôle personnalisé dans votre compte pour modifier ou contrôler le budget du compte.

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_ADMIN TO ROLE budget_admin;

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_VIEWER TO ROLE budget_monitor;

Rôles d’instance pour gérer les budgets personnalisés¶

Chaque budget personnalisé a des rôles d’instance que vous pouvez accorder à d’autres rôles pour voir ou modifier le budget :

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

Exploration des coûts¶

Vous pouvez afficher les coûts des tâches sans serveur en utilisant Snowsight ou Vue SERVERLESS_TASK_HISTORY d’Account Usage. Pour plus d’informations sur l’affichage des coûts en fonction du type de service, voir Exploration des coûts de calcul.

Vous pouvez afficher les coûts de stockage en utilisant Snowsight ou en interrogeant les vues Account Usage et Utilisation de l’organisation. Pour plus d’informations sur l’affichage des coûts de stockage, voir Exploration des coûts de stockage.

Activation du budget du compte¶

Activez le budget du compte, fixez la limite de dépenses pour le compte et indiquez les adresses e-mail à utiliser pour recevoir des notifications lorsque l’utilisation du crédit dépasse la limite de dépenses.

Vous pouvez activer le budget du compte en utilisant Snowsight ou SQL.

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

1. Connectez-vous à Snowsight.

2. Select Admin » Cost Management

3. Sélectionnez Budgets.

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

   Note

   Si vous ne voyez pas l’icône Ajouter un budget, vous devez d’abord activer le budget du compte.

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.

   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.

Lorsque vous ajoutez des adresses e-mail pour les notifications en utilisant Snowsight, Snowflake crée ou met à jour une intégration de notification par e-mail nommée default_budget_notification_integration dans un processus d’arrière-plan. Si l’intégration des notifications existe, Snowflake ajoute toutes les nouvelles adresses e-mail que vous avez saisies aux adresses électroniques existantes dans la liste.

Si l’intégration de la notification n’existe pas, Snowflake la crée et accorde le privilège USAGE. Pour plus d’informations, voir les étapes décrites à la section sur le budget du compte.

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 :

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

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

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

   Copy

3. 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éé de NOTIFICATION INTEGRATION par e-mail, voir les étapes à la section sur le budget du compte pour en créer une.

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

   Copy

5. Pour ajouter des objets à votre budget personnalisé, vous devez passer une référence à la méthode ADD_RESOURCE du budget. Par exemple, pour ajouter une table nommée t1 au budget nommé my_budget :

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

   Copy

   L’instruction SYSTEM$REFERENCE crée une référence à un objet TABLE, t1, avec le privilège APPLYBUDGET accordé à la table. 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 »).

6. Accordez le rôle d’instance ADMIN à votre rôle personnalisé budget_admin :

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

   Copy

Vous ne pouvez pas activer le budget du compte¶

Il existe plusieurs raisons pour lesquelles il se peut que vous ne puissiez pas activer le budget de votre compte :

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

Vous ne pouvez pas créer de budget personnalisé¶

Il existe de nombreuses raisons pour lesquelles vous ne pouvez pas créer un budget personnalisé.

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

Vous ne pouvez pas activer de budget personnalisé¶

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

Vous ne pouvez pas appeler de méthodes sur le budget du compte¶

Il y a plusieurs raisons pour lesquelles l’appel d’une méthode sur le budget du compte peut échouer.

-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

La fonction Budgets n’est pas disponible pour votre compte¶

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