<budget_name> !REMOVE_TAG

Supprime une combinaison balise/valeur d’un budget personnalisé. La balise doit être supprimée par référence.

Voir aussi :

<budget_name> !ADD_TAG, <budget_name> !GET_LINKED_TAGS

Syntaxe

<budget_name>!REMOVE_TAG(
    { '<tag_reference>' | <reference_statement> },
    'tag_value' )
Copy

Arguments

'tag_reference'

La représentation sérialisée de la chaîne qui se résout en une balise. Cette chaîne est la sortie de la fonction SYSTEM$REFERENCE.

reference_statement

Une instruction SYSTEM$REFERENCE qui crée une référence pour la balise à supprimer du budget.

'tag_value'

Spécifie la valeur de la combinaison balise/valeur que vous supprimez du budget.

Si la balise a été ajoutée au budget avec une valeur différente, la balise continue d’être associée au budget après avoir supprimé cette combinaison balise/valeur spécifique.

Renvoie

Renvoie une valeur VARCHAR qui indique si la combinaison balise/valeur a été supprimée avec succès du budget.

Si la balise n’a pas pu être supprimée du budget, la fonction renvoie un message d’erreur.

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

Les privilèges et rôles minimaux suivants sont nécessaires pour appeler cette méthode sur un budget personnalisé :

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

  • Privilège USAGE sur la base de données et le schéma contenant la balise.

  • Privilège APPLYBUDGET sur la balise en cours de suppression.

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

Notes sur l’utilisation

  • Cette méthode ne peut être appelée que pour les instances de budget personnalisé.

  • 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

Récupérer la référence de la balise avant d’appeler la méthode pour supprimer la combinaison balise/valeur.

L’instruction suivante crée et renvoie une référence pour la balise cost_center :

SELECT SYSTEM$REFERENCE(
  'TAG',
  'cost_mgmt_db.tags.cost_center',
  'SESSION',
  'APPLYBUDGET');
Copy

L’instruction renvoie la référence dans la sortie.

ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2

L’instruction suivante utilise le littéral de chaîne pour cette référence afin d’ajouter la combinaison balise/valeur cost_center = 'sales' au budget budget_db.budget_schema.my_budget :

CALL budget_db.budget_schema.my_budget!REMOVE_TAG(
  'ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2',
  'sales');
Copy
Inclut la fonction SYSTEM$REFERENCE dans l’argument directement

Après avoir exécuté l’instruction suivante, le budget ne suivra plus les objets qui sont identifiés avec la combinaison balise/valeur team_tag = 'finance'.

CALL budget_db.budget_schema.my_budget!REMOVE_TAG(
    (SELECT SYSTEM$REFERENCE('TAG', 'cost_mgmt_db.tags.team_tag', 'SESSION', 'APPLYBUDGET')),
    'finance');
Copy
Langage: Français