<budget_name>!ADD_TAG

Fügt ein Tag zu einem kundenspezifischen Budget hinzu. Das Tag muss durch Referenz hinzugefügt werden.

Siehe auch:

<budget_name>!REMOVE_TAG, <budget_name>!GET_LINKED_TAGS

Syntax

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

Argumente

'tag_reference'

Die Darstellung einer serialisierten Zeichenfolge, die in ein Tag aufgelöst wird. Diese Zeichenfolge ist die Ausgabe der Funktion SYSTEM$REFERENCE.

reference_statement

Eine SYSTEM$REFERENCE Anweisung, die eine Referenz für das dem Budget hinzuzufügende Tag erzeugt.

'tag_value'

Der Wert des Tags, das Sie dem Budget hinzufügen.

Rückgabewerte

Gibt einen VARCHAR-Wert zurück, der angibt, ob das Tag erfolgreich zum Budget hinzugefügt wurde oder nicht.

Wenn das Objekt nicht zum Tag hinzugefügt werden konnte, gibt die Funktion eine Fehlermeldung zurück.

Anforderungen an die Zugriffssteuerung

Die folgenden Berechtigungen und Rollen sind erforderlich, um diese Methode für ein kundenspezifisches Budget aufzurufen:

  • ADMIN-Instanzrolle für die Budgetinstanz.

  • USAGE-Berechtigung für die Datenbank und das Schema, die die Budgetinstanz enthalten.

  • Die USAGE-Berechtigung für die Datenbank und das Schema, die das Tag enthalten.

  • APPLYBUDGET-Berechtigung für das hinzuzufügende Tag.

Weitere Informationen dazu finden Sie unter Rollen und Berechtigungen für Budgets.

Nutzungshinweise

  • Sie können Tags nur zu kundenspezifischen Budgets hinzufügen.

  • Wenn Sie diese Methode aufrufen, wird das Objekt nicht zurückgegeben. Aus diesem Grund können Sie keine Methodenverkettung verwenden, um eine andere Methode mit dem Rückgabewert dieser Methode aufzurufen. Rufen Sie jede Methode in einer separaten SQL-Anweisung auf.

Beispiele

Rufen Sie die Tag-Referenz ab, bevor Sie die Methode aufrufen, um ein Tag hinzuzufügen.

In der folgenden Anweisung wird eine Referenz für das cost_center-Tag erstellt und zurückgegeben:

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

Die Anweisung gibt die Referenz in der Ausgabe zurück.

ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2

Die folgende Anweisung verwendet das Zeichenfolgenliteral für diese Referenz, um die Tag/Wert-Kombination cost_center = 'sales' zum Budget budget_db.budget_schema.my_budget hinzuzufügen:

CALL budget_db.budget_schema.my_budget!ADD_TAG(
  'ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2',
  'sales');
Copy
Fügen Sie die SYSTEM$REFERENCE-Funktion direkt im Argument hinzu

Nach dem Ausführen der folgenden Anweisung verfolgt das Budget alle Objekte, die mit der Tag/Wert-Kombination team_tag = 'finance' getaggt sind.

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