<budget_name> !ADD_TAG

Ajoute une balise à un budget personnalisé. La balise doit être ajoutée par référence.

Voir aussi :

<budget_name> !REMOVE_TAG, <budget_name> !GET_LINKED_TAGS

Syntaxe

<budget_name>!ADD_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 à ajouter au budget.

'tag_value'

La valeur de la balise que vous ajoutez au budget.

Renvoie

Renvoie une valeur VARCHAR qui indique si la balise a été ajoutée avec succès au budget.

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

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

Les privilèges et rôles suivants sont nécessaires pour appeler cette méthode pour 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 d’ajout.

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

Notes sur l’utilisation

  • Vous ne pouvez ajouter des balises qu’aux budgets personnalisés.

  • 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érez la référence de la balise avant d’appeler la méthode pour ajouter une balise.

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!ADD_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 suivra tous les objets qui sont identifiés avec la combinaison balise/valeur team_tag = 'finance'.

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