- 类别:
:doc:`/sql-reference/functions-system`(信息)
SYSTEM$SHOW_BUDGETS_FOR_RESOURCE¶
返回一个字符串,其中包含跟踪指定资源(例如,表或架构)的 预算 列表。
语法¶
SYSTEM$SHOW_BUDGETS_FOR_RESOURCE( '<resource_domain>' , '<resource_name>' )
实参¶
'resource_domain'
资源的域。您可以指定以下值中的一个:
compute_pool
database
materialized_view
pipe
schema
table
task
warehouse
'resource_name'
资源的名称(例如,表的名称)。
返回¶
返回一个 VARCHAR 值,其中包含资源预算的完全限定名称的逗号分隔列表。该列表置于方括号之间。
如果没有跟踪指定资源的预算,该函数将返回包含一对空方括号 ([]
) 的字符串。
使用说明¶
该函数的输出包含因以下任意原因而涉及该资源的预算:
资源已直接添加到预算中。
资源的标签/值组合已添加到预算中。
资源属于已添加到预算的对象(例如,数据库)。
示例¶
以下示例返回跟踪名为 my_db.my_schema
的架构的预算列表:
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] |
+---------------------------------------------------------------+
以下示例返回跟踪名为 my_db.my_schema.my_table
的表的预算列表。在本例中,没有任何预算跟踪该表,因此该函数会返回一个空列表。
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') |
|-----------------------------------------------------------------------|
| [] |
+-----------------------------------------------------------------------+