<budget_name>!ADD_RESOURCE_TAG

Fügt ein Tag zu einem kundenspezifischen Budget hinzu. Alle Ressourcen, die mit dem angegebenen Tag-Wert-Paar getaggt sind, sind im Budget enthalten.

Syntax

<budget_name>!ADD_RESOURCE_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.

  • Snowflake zeigt die Nutzung für die hinzugefügten Ressourcen erst an, wenn das Budget aktualisiert wurde, was bis zu sechs Stunden dauern kann. Wenn Sie die Nutzung früher anzeigen möchten, führen Sie die Methode REFRESH_USAGE aus.

  • 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_RESOURCE_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_RESOURCE_TAG(
    (SELECT SYSTEM$REFERENCE('TAG', 'cost_mgmt_db.tags.team_tag', 'SESSION', 'APPLYBUDGET')),
    'finance');
Copy