<budget_name>!GET_BUDGET_SCOPE

:doc:`カスタム予算</user-guide/budgets>`に追加されたリソースとタグを返します。どのリソース消費が予算によって追跡されているかの判断に役立ちます。

リストに以下は含まれません。

  • 自動的に追加されたオブジェクト(たとえば、 Snowflake Native App によって作成され所有されているコンピューティングプールやウェアハウス)

  • タグが予算に追加されたときに追加されたオブジェクト。

構文

<budget_name>!GET_BUDGET_SCOPE()

戻り値

このメソッドは、次のキーを持つJSONオブジェクトを返します。

resource_tags

予算に追加されたリソースタグ。これらのタグが付加されているリソースは、予算に属します。以下のフィールドを含みます。

operator

リソースタグのマッチングに使用されるロジック。次のいずれかの値になります。

  • UNION:リソースが:code:`tags`配列内のタグと値のペアのいずれかでタグ付けされている場合、そのリソースは予算に含まれます。

  • INTERSECTION: リソースが予算に含まれるには、:code:`tags`配列内の*すべての*タグと値のペアがタグ付けされている必要があります。

tags

次のフィールドを持つタグオブジェクトの配列。

tagId

タグの内部識別子。

tagDatabase

タグを含むデータベース。

tagSchema

タグを含むスキーマ。

tagName

タグの名前。

tagValues

タグに関連付けられたタグ値の配列。

resources

予算に直接追加されたリソースの配列。各オブジェクトには次のフィールドが含まれます。

resourceId

リソースの内部識別子。

resourceName

リソースの名前。

resourceDomain

リソースのドメイン(例:WAREHOUSEDATABASETABLE)。

schemaName

リソースを含むスキーマ。

databaseName

リソースを含むデータベース。

アクセス制御の要件

カスタム予算の結果を表示するには、以下の最小権限とロールが必要です。

  • 予算インスタンスの ADMIN インスタンスロール

  • 予算インスタンスを含んでいるデータベースとスキーマに対する USAGE 権限。

詳細については、 Budgetのロールと権限 をご参照ください。

使用上の注意

  • このメソッドは カスタム予算 インスタンスに対してのみ呼び出すことができます。

  • このメソッドを呼び出しても、オブジェクトは返されません。このため、メソッドの連結を使って、このメソッドの戻り値で別のメソッドを呼び出すことはできません。換わりに、各メソッドを別々の SQL ステートメントで呼び出します。

:code:`budget_db.budget_schema.my_budget`予算に追加されたすべてのリソースとタグを取得します。

CALL budget_db.budget_schema.my_budget!GET_BUDGET_SCOPE();