- カテゴリ:
システム関数 (情報)
SYSTEM$SHOW_BUDGETS_FOR_RESOURCE¶
指定されたリソース(例えば、テーブルやスキーマ)を追跡する 予算 のリストを含む文字列を返します。現在、リソースは1つの予算で追跡できます。
- こちらもご参照ください。
構文¶
SYSTEM$SHOW_BUDGETS_FOR_RESOURCE( '<resource_domain>' , '<resource_name>' )
引数¶
'resource_domain'
リソースのドメイン。次の値のいずれかを指定できます。
compute_pool
database
materialized_view
pipe
schema
table
task
warehouse
'resource_name'
リソースの名前(テーブル名など)。
戻り値¶
リソースの予算の完全修飾名のコンマ区切りリストを含む VARCHAR 値を返します。リストは角括弧で囲まれています。
指定されたリソースを追跡する予算がない場合、関数は空の角括弧([]
)のペアを含む文字列を返します。
使用上の注意¶
現在、リソースを追跡できるのは1つの予算だけです。
リソースが自動的に予算に追加された場合(例えば、データベースにテーブルがあり、それが予算に追加された場合)、関数はその予算を返します。 <budget_name>!GET_LINKED_RESOURCES メソッドとは異なり、この関数ではリソースが予算に自動的に追加されたかどうかを判断することができます。
例¶
次の例は、 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') |
|-----------------------------------------------------------------------|
| [] |
+-----------------------------------------------------------------------+