Catégories :

Fonctions système (informations)

SYSTEM$SHOW_BUDGETS_FOR_RESOURCE

Renvoie une chaîne contenant une liste des budgets qui suivent une ressource spécifiée (par exemple, une table ou un schéma). Actuellement, une ressource peut être suivie par un seul budget.

Voir aussi :

<budget_name>!GET_LINKED_RESOURCES

Syntaxe

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

Arguments

'resource_domain'

Domaine de la ressource. Vous pouvez spécifier l’une des valeurs suivantes :

  • compute_pool

  • database

  • materialized_view

  • pipe

  • schema

  • table

  • task

  • warehouse

'resource_name'

Nom de la ressource (par exemple, le nom de la table).

Renvoie

Renvoie une valeur VARCHAR contenant la liste délimitée par des virgules des noms entièrement qualifiés des budgets de la ressource. La liste est entourée de crochets.

Si aucun budget ne suit la ressource spécifiée, la fonction renvoie une chaîne contenant une paire vide de crochets ([]).

Notes sur l’utilisation

  • Actuellement, une ressource ne peut être suivie que par un seul budget.

  • Si une ressource a été automatiquement ajoutée à un budget (par exemple, parce qu’une table se trouve dans une base de données qui a été ajoutée à un budget), la fonction renvoie ce budget. Contrairement à la méthode <budget_name>!GET_LINKED_RESOURCES, cette fonction vous permet de déterminer si une ressource a été ajoutée automatiquement à un budget.

Exemples

L’exemple suivant renvoie la liste des budgets qui suivent le schéma nommé my_db.my_schema :

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]                         |
+---------------------------------------------------------------+

L’exemple suivant renvoie la liste des budgets qui suivent la table nommée my_db.my_schema.my_table. Dans cet exemple, la table n’est suivie par aucun budget, la fonction renvoie donc une liste vide.

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') |
|-----------------------------------------------------------------------|
| []                                                                    |
+-----------------------------------------------------------------------+