<budget_name>!REMOVE_TAG

Entfernt eine Tag/Wert-Kombination aus einem kundenspezifischen Budget. Das Tag muss durch Referenz entfernt werden.

Siehe auch:

<budget_name>!ADD_TAG, <budget_name>!GET_LINKED_TAGS

Syntax

<budget_name>!REMOVE_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 einen Verweis auf das Tag erzeugt, das aus dem Budget entfernt werden soll.

'tag_value'

Gibt den Wert der Tag/Wert-Kombination an, die Sie aus dem Budget entfernen.

Wenn das Tag mit einem anderen Wert zum Budget hinzugefügt wurde, ist das Tag nach dem Entfernen dieser spezifischen Tag/Wert-Kombination weiterhin mit dem Budget verknüpft.

Rückgabewerte

Gibt einen VARCHAR-Wert zurück, der angibt, ob die Tag/Wert-Kombination erfolgreich aus dem Budget entfernt wurde oder nicht.

Wenn das Tag nicht aus dem Budget entfernt werden konnte, gibt die Funktion eine Fehlermeldung zurück.

Anforderungen an die Zugriffssteuerung

Die folgenden Mindestberechtigungen 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 zu entfernende Tag.

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

Nutzungshinweise

  • Diese Methode kann nur bei Instanzen des Typs kundenspezifisches Budget aufgerufen werden.

  • 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 die Tag/Wert-Kombination zu entfernen.

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!REMOVE_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 keine Objekte mehr, die mit der Tag/Wert-Kombination team_tag = 'finance' getaggt sind.

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