ALTER BUDGET¶

Nom complet : SNOWFLAKE.CORE.BUDGET

Modifie les propriétés d’un budget personnalisé :

Renomme le budget.
Active ou désactive une balise.
Active ou désactive le commentaire.

Voir aussi :: CREATE BUDGET, SHOW BUDGET, DROP BUDGET

Syntaxe¶

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET COMMENT

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

Copy

Paramètres¶

name

Spécifie l’identificateur (c’est-à-dire le nom) du budget.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

SET ...

Spécifie une ou plusieurs propriétés de budget à définir.

COMMENT = 'string_literal': Active le commentaire du budget. Pour ce faire, vous pouvez utiliser la commande COMMENT.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Quotas de balises pour les objets et les colonnes.

UNSET ...

Spécifie un(e) ou plusieurs propriétés et/ou paramètres à désactiver pour le budget, qui les réinitialise aux valeurs par défaut :

COMMENT
TAG tag_name [ , tag_name ... ]

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

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège / Rôle	Objet	Remarques
ADMIN	Budget	Le rôle utilisé pour modifier les propriétés d’un budget personnalisé doit se voir attribuer ce rôle d’instance.

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

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

Notes sur l’utilisation¶

Vous ne pouvez modifier les propriétés que pour un budget personnalisé.
Pour faire référence à cette classe par son nom incomplet, incluez la base de données et le schéma de la classe dans votre chemin de recherche.

Exemples¶

Définissez la balise dept du budget my_budget dans le schéma actuel :

ALTER SNOWFLAKE.CORE.BUDGET my_budget SET TAG dept = 'finance';

Copy