Kategorien:

Systemfunktionen (Informationen)

SYSTEM$SHOW_BUDGETS_FOR_RESOURCE

Gibt eine Zeichenfolge mit einer Liste der Budgets zurück, die eine bestimmte Ressource (z. B. eine Tabelle oder ein Schema) verfolgen. Derzeit kann eine Ressource über ein Budget verfolgt werden.

Siehe auch:

<budget_name>!GET_LINKED_RESOURCES

Syntax

SYSTEM$SHOW_BUDGETS_FOR_RESOURCE( '<resource_domain>' , '<resource_name>' )
Copy

Argumente

'resource_domain'

Domäne der Ressource. Sie können einen der folgenden Werte angeben:

  • compute_pool

  • database

  • materialized_view

  • pipe

  • schema

  • table

  • task

  • warehouse

'resource_name'

Name der Ressource (zum Beispiel der Name der Tabelle).

Rückgabewerte

Gibt einen VARCHAR-Wert zurück, der die durch Kommas getrennte Liste der voll qualifizierten Namen der Budgets für die Ressource enthält. Die Liste ist von eckigen Klammern umgeben.

Wenn es keine Budgets gibt, die die angegebene Ressource verfolgen, gibt die Funktion eine Zeichenfolge zurück, die ein leeres Paar eckiger Klammern enthält ([]).

Nutzungshinweise

  • Derzeit kann eine Ressource nur von einem Budget verfolgt werden.

  • Wenn eine Ressource automatisch zu einem Budget hinzugefügt wurde (z. B. weil sich eine Tabelle in einer Datenbank befindet, die zu einem Budget hinzugefügt wurde), gibt die Funktion dieses Budget zurück. Anders als bei der Methode <budget_name>!GET_LINKED_RESOURCES können Sie mit dieser Funktion feststellen, ob eine Ressource automatisch zu einem Budget hinzugefügt wurde.

Beispiele

Das folgende Beispiel gibt die Liste der Budgets zurück, die das Schema namens my_db.my_schema verfolgen:

SELECT SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('SCHEMA', 'my_db.my_schema');
Copy
+---------------------------------------------------------------+
| SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('SCHEMA', 'MY_DB.MY_SCHEMA') |
|---------------------------------------------------------------|
| [BUDGETS_DB.BUDGETS_SCHEMA.MY_BUDGET]                         |
+---------------------------------------------------------------+

Das folgende Beispiel gibt die Liste der Budgets zurück, die die Tabelle mit dem Namen my_db.my_schema.my_table verfolgen. In diesem Beispiel wird die Tabelle von keinem Budget verfolgt, daher gibt die Funktion eine leere Liste zurück.

SELECT SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('TABLE', 'my_db.my_schema.my_table');
Copy
+-----------------------------------------------------------------------+
| SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('TABLE', 'MY_DB.MY_SCHEMA.MY_TABLE') |
|-----------------------------------------------------------------------|
| []                                                                    |
+-----------------------------------------------------------------------+