类别：

:doc:`/sql-reference/functions-system`（信息）

SYSTEM$SHOW_BUDGETS_FOR_RESOURCE

返回一个字符串，其中包含跟踪指定资源（例如，表或架构）的 预算 列表。目前，一个资源可由一项预算跟踪。

另请参阅：

<budget_name>!GET_LINKED_RESOURCES

语法

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

实参

'resource_domain'

资源的域。您可以指定以下值中的一个：

  • compute_pool

  • database

  • materialized_view

  • pipe

  • schema

  • table

  • task

  • warehouse

'resource_name'

资源的名称（例如，表的名称）。

返回

返回一个 VARCHAR 值，其中包含资源预算的完全限定名称的逗号分隔列表。该列表置于方括号之间。

如果没有跟踪指定资源的预算，该函数将返回包含一对空方括号 ([]) 的字符串。

使用说明

  • 目前，一个资源仅可由一项预算跟踪。

  • 如果有资源被自动添加到预算中（例如，由于一个表位于已添加到预算的数据库中），则此函数将返回该预算。不同于 <budget_name>!GET_LINKED_RESOURCES 方法，该函数允许您确定资源是否自动添加到预算中。

示例

以下示例返回跟踪名为 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]                         |
+---------------------------------------------------------------+

以下示例返回跟踪名为 my_db.my_schema.my_table 的表的预算列表。在本例中，没有任何预算跟踪该表，因此该函数会返回一个空列表。

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') |
|-----------------------------------------------------------------------|
| []                                                                    |
+-----------------------------------------------------------------------+
语言: 中文