<nom_budget>!SET_SPENDING_LIMIT¶

Syntaxe¶

<budget_name>!SET_SPENDING_LIMIT(<number>)

Arguments¶

number

Le nombre de crédits alloués au budget par mois. Lorsque l’utilisation totale de tous les objets affectés au budget atteint ce nombre pour le mois en cours, le budget est considéré comme étant à 100 % de la limite de dépenses.

Pour le budget du compte, tous les objets pris en charge par contribuent à l’utilisation du crédit.

Si aucune valeur n’est spécifiée pour un budget, celui-ci n’a pas de limite de dépenses, n’atteindra jamais 100 % d’utilisation et ne déclenchera pas de notifications.

Valeur par défaut : -1 (pas de limite de dépenses).

Renvoie¶

The spending limit has been updated to <n> credits.

Exigences en matière de contrôle d’accès¶

• Les privilèges et rôles minimaux suivants sont nécessaires pour afficher les résultats des budgets personnalisés :

  • Rôle d’instance ADMIN <label-budgets_instance_roles> pour l’instance de budget.

  • Privilège USAGE sur la base de données et le schéma contenant l’instance de budget.

• Le rôle suivant est requis pour afficher les résultats du budget du compte :

  Rôle d’application BUDGET_ADMIN <label-budgets_application_roles> pour le budget du compte.

Pour plus d’informations, voir Rôles et privilèges Budgets.

Notes sur l’utilisation¶

• L’argument number doit être un entier positif.

• Le fait d’appeler cette méthode ne renvoie pas l’objet. Pour cette raison, vous ne pouvez pas utiliser le chaînage de méthodes pour appeler une autre méthode sur la valeur de retour de cette méthode. Au lieu de cela, appelez chaque méthode dans une instruction SQL distincte.

Exemples¶

Fixer la limite de dépenses pour le budget du compte à 500 crédits par mois :

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

Fixez la limite de dépenses pour le budget my_database.my_schema.my_budget à 100 crédits par mois.

CALL my_database.my_schema.my_budget!SET_SPENDING_LIMIT(100);