<budget_name>!SET_SPENDING_LIMIT¶

構文¶

<budget_name>!SET_SPENDING_LIMIT(<number>)

引数¶

number

月ごとの予算に割り当てられたクレジット数。予算に割り当てられているすべてのオブジェクトの使用量の合計が当月のこの数値に達すると、その予算は支出制限の100%に達したとみなされます。

アカウント予算では、すべての サポートされたオブジェクト がクレジット使用状況に貢献します。

予算に値が指定されていない場合、予算には支出制限がなく、使用率が100%に達することはなく、通知もトリガーされません。

デフォルト: -1（支出制限なし）。

戻り値¶

The spending limit has been updated to <n> credits.

アクセス制御の要件¶

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

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

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

• アカウント予算 の結果を表示するには、以下のロールが必要です。

  アカウント予算の BUDGET_ADMIN アプリケーションロール。

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

使用上の注意¶

• number 引数は正の整数にする必要があります。

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

例¶

アカウント予算の支出制限を500クレジット/月に設定します。

CALL snowflake.local.account_root_budget!SET_SPENDING_LIMIT(500);

予算 my_database.my_schema.my_budget の支出制限を100クレジット/月に設定します。

CALL my_database.my_schema.my_budget!SET_SPENDING_LIMIT(100);