- 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:
Syntax¶
SYSTEM$SHOW_BUDGETS_FOR_RESOURCE( '<resource_domain>' , '<resource_name>' )
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');
+---------------------------------------------------------------+
| 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');
+-----------------------------------------------------------------------+
| SYSTEM$SHOW_BUDGETS_FOR_RESOURCE('TABLE', 'MY_DB.MY_SCHEMA.MY_TABLE') |
|-----------------------------------------------------------------------|
| [] |
+-----------------------------------------------------------------------+