<budget_name>!GET_BUDGET_SCOPE

Gibt die Ressourcen und Tags zurück, die einem kundenspezifischen Budget hinzugefügt wurden. Hilft dabei zu bestimmen, welcher Ressourcenverbrauch vom Budget erfasst wird.

Die Liste enthält Folgendes nicht:

  • Objekte, die automatisch hinzugefügt wurden (z. B. Computepools und Warehouses, die von einer Snowflake Native App erstellt wurden und ihr gehören).

  • Objekte, die hinzugefügt wurden, als ein Tag zum Budget hinzugefügt wurde.

Syntax

<budget_name>!GET_BUDGET_SCOPE()

Rückgabewerte

Die Methode gibt ein JSON-Objekt mit den folgenden Schlüsseln zurück:

resource_tags

Die Ressourcen-Tags, die dem Budget hinzugefügt wurden. Ressourcen gehören zum Budget, wenn sie mit diesen Tags getaggt sind. Enthält die folgenden Felder:

operator

Die für Ressourcen-Tags verwendete Abgleichlogik. Einer der folgenden Werte kann es sein:

  • UNION: Eine Ressource ist im Budget enthalten, wenn sie mit einem der Tag-Wert-Paare im Array tags getaggt ist.

  • INTERSECTION: Eine Ressource muss mit allen Tag-Wert-Paaren im Array tags getaggt sein, das in das Budget aufgenommen werden soll.

tags

Ein Array von Tag-Objekten mit jeweils den folgenden Feldern:

tagId

Interner Bezeichner für das Tag.

tagDatabase

Datenbank, die das Tag enthält.

tagSchema

Schema, das das Tag enthält.

tagName

Name des Tags.

tagValues

Array der mit dem Tag verbundenen Tag-Werte.

resources

Ein Array von Ressourcen, die direkt dem Budget hinzugefügt wurden. Jedes Objekt enthält die folgenden Felder:

resourceId

Interner Bezeichner für die Ressource.

resourceName

Name der Ressource.

resourceDomain

Domäne der Ressource (z. B. WAREHOUSE, DATABASE, TABLE).

schemaName

Schema, das die Ressource enthält.

databaseName

Datenbank, die die Ressource enthält.

Anforderungen an die Zugriffssteuerung

Die folgenden Mindestberechtigungen und Rollen sind erforderlich, um die Ergebnisse für kundenspezifische Budgets anzuzeigen:

  • ADMIN-Instanzrolle für die Budgetinstanz.

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

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.

Beispiel

Alle Ressourcen und Tags abrufen, die dem Budget budget_db.budget_schema.my_budget hinzugefügt wurden:

CALL budget_db.budget_schema.my_budget!GET_BUDGET_SCOPE();