<budget_name>!ADD_SHARED_RESOURCE¶

構文¶

<budget_name>!ADD_SHARED_RESOURCE( '<domain>' [ , '<instance>' ] )

引数¶

'domain'

予算に追加するリソースの型。有効な値:

• AI FUNCTION

• CORTEX CODE

• CORTEX AGENT

• SNOWFLAKE INTELLIGENCE

2番目の引数を指定しない限り、予算は指定されたドメイン内のすべてのリソースの消費を追跡します。

'instance'

オプション。選択した domain 内の特定のリソースを指定し、予算に追加します。

インスタンスレベルの選択をサポートするドメインの場合（AI FUNCTION および CORTEX CODE）、この引数を使用すると、特定の関数やインターフェースを追跡できます。

2番目の引数を指定しない場合、予算はドメイン内のすべてのインスタンスを追跡します。

例：

• AI 関数：AI_CLASSIFY、 AI_COMPLETE

• Cortex Code：CORTEX_CODE_CLI、 CORTEX_CODE_SNOWSIGHT

インスタンスレベルの選択はすべてのドメインに適用されるわけではありません。例：CORTEX AGENT および SNOWFLAKE INTELLIGENCE は現在ドメインレベルでのみ追跡されます。

戻り値¶

リソースが正常に予算に追加されたかどうかを示す VARCHAR 値を返します。

リソースを予算に追加できなかった場合、関数はエラーメッセージを返します。

アクセス制御の要件¶

カスタム予算でこのメソッドを呼び出すには、以下の権限とロールが必要です。

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

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

• 追加されたリソース（スキーマオブジェクト向け）を含んでいるデータベースとスキーマに対する USAGE 権限。

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

使用上の注意¶

• カスタム予算 には共有リソースのみを追加できます。

• このメソッドの結果を確認するには、:doc:`GET_BUDGET_SCOPE</sql-reference/classes/budget/methods/get_budget_scope>`メソッドを呼び出します。

• 指定されたエンティティタイプのすべてのオブジェクトが追加された場合（例：すべての AI 関数）、そのタイプの個別のリソースを追加することはできません。

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

例¶

すべての AI 関数を予算に追加します。

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION');

特定の AI 関数を予算に追加します。

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION', 'AI_CLASSIFY');

すべてのCortex Codeのワークロードを予算に追加します。

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE');

Cortex Code CLI ワークロードを予算に追加します。

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE', 'CORTEX_CODE_CLI');

Cortex Code Snowsightワークロードを予算に追加します。

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE', 'CORTEX_CODE_SNOWSIGHT');

Cortex Agentのワークロードを予算に追加します。

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX AGENT');

すべてのSnowflakeインテリジェンスのワークロードを予算に追加します。

CALL finance_budget!ADD_SHARED_RESOURCE('SNOWFLAKE INTELLIGENCE');