<budget_name>!GET_BUDGET_SCOPE¶
:doc:`カスタム予算</user-guide/budgets>`に追加されたリソースとタグを返します。どのリソース消費が予算によって追跡されているかの判断に役立ちます。
リストに以下は含まれません。
自動的に追加されたオブジェクト(たとえば、 Snowflake Native App によって作成され所有されているコンピューティングプールやウェアハウス)
タグが予算に追加されたときに追加されたオブジェクト。
構文¶
戻り値¶
このメソッドは、次のキーを持つJSONオブジェクトを返します。
resource_tags予算に追加されたリソースタグ。これらのタグが付加されているリソースは、予算に属します。以下のフィールドを含みます。
operatorリソースタグのマッチングに使用されるロジック。次のいずれかの値になります。
tags次のフィールドを持つタグオブジェクトの配列。
tagIdタグの内部識別子。
tagDatabaseタグを含むデータベース。
tagSchemaタグを含むスキーマ。
tagNameタグの名前。
tagValuesタグに関連付けられたタグ値の配列。
resources予算に直接追加されたリソースの配列。各オブジェクトには次のフィールドが含まれます。
resourceIdリソースの内部識別子。
resourceNameリソースの名前。
resourceDomainリソースのドメイン(例:
WAREHOUSE、DATABASE、TABLE)。schemaNameリソースを含むスキーマ。
databaseNameリソースを含むデータベース。
アクセス制御の要件¶
カスタム予算の結果を表示するには、以下の最小権限とロールが必要です。
予算インスタンスの ADMIN インスタンスロール。
予算インスタンスを含んでいるデータベースとスキーマに対する USAGE 権限。
詳細については、 Budgetのロールと権限 をご参照ください。
使用上の注意¶
このメソッドは カスタム予算 インスタンスに対してのみ呼び出すことができます。
このメソッドを呼び出しても、オブジェクトは返されません。このため、メソッドの連結を使って、このメソッドの戻り値で別のメソッドを呼び出すことはできません。換わりに、各メソッドを別々の SQL ステートメントで呼び出します。
例¶
:code:`budget_db.budget_schema.my_budget`予算に追加されたすべてのリソースとタグを取得します。