Budgetsを使用したクレジット使用状況のモニタリング¶

アカウント予算およびカスタム予算¶

Snowflakeで予算の使用を開始するには、 アカウント予算をアクティブ化 します。アカウント予算は、アカウント内のすべての サポートオブジェクト の支出をモニターします。予算に関する通知を受け取るには、支出制限を設定し、通知を受け取るメールアドレスを指定します。

また、 カスタム予算を作成 して、サポートされているオブジェクトの特定のグループの支出制限をモニターすることもできます。どのようなデータベースやスキーマでもカスタム予算を作成できます。アカウント予算と同様に、支出制限と通知メールを受け取るための通知メールアドレスを設定する必要があります。

支出制限と時間間隔¶

支出制限はSnowflakeクレジットで表示され、警告と通知の目的のみに使用されます。支出制限は、1暦月の時間間隔で設定されます。

時間間隔は、月の初日の12:00AM UTC で始まり、月の最終日の11:59PM UTC で終わります。予算が月の初日以降に作成された場合、最初の監視間隔は当月の最終日までの期間となり、翌月の初日にリセットされます。

月初以降に アカウント予算 を有効にした場合、月初からのデータがバックフィルされ、その月の支出制限を超えるかどうかを判断するために使用されます。

月初以降に カスタム予算 を作成した場合、その月の履歴データは バックフィルされません。将来の支出予測は、予算が有効になってから数日間のクレジットの使用状況に基づいて行われます。

サポートされているオブジェクト¶

サポートされるオブジェクトのリストは、すべてアカウント予算の支出制限に貢献します。カスタム予算では、監視する特定のオブジェクトを選択できます。

予算では、次のオブジェクトをモニターできます。

• テーブル

• マテリアライズドビュー

• スキーマ

• データベース

• ウェアハウス

• パイプ

• タスク

予算の通知¶

予算により、時系列予測に基づき、現在の支出が支出制限を超えそうな場合、毎日アラート通知が送信されます。自動アラート通知を受信するには、次を実行する必要があります。

• 予算の支出制限を設定する。

• 予算のメール通知を設定する。

以下は、通知メールの例です。

SET_NOTIFICATION_MUTE_FLAG メソッドを呼び出すことで、予算のメール通知を無効にできます。

Budgets作成に必要なロールと権限¶

カスタムロールを使用して、アカウントにカスタム予算を作成できます。カスタムロールに次のデータベースロールと権限を付与します。

• SNOWFLAKE データベースロール SNOWFLAKE.BUDGET_CREATOR。

• 予算を作成するスキーマに対する CREATE SNOWFLAKE.CORE.BUDGET 権限。

たとえば、 budget_admin ロールを作成し、スキーマ budgets_db.budgets_schema でカスタム予算を作成するために必要なロールと権限を付与します。

CREATE ROLE budget_admin;

GRANT DATABASE ROLE SNOWFLAKE.BUDGET_CREATOR TO ROLE budget_admin;

GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_admin;

GRANT CREATE SNOWFLAKE.CORE.BUDGET ON SCHEMA budgets_db.budgets_schema
  TO ROLE budget_admin;

アカウント予算を管理するアプリケーションロール¶

アカウントのカスタムロールに次のアプリケーションロールを付与し、アカウント予算を変更または監視できます。

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_ADMIN TO ROLE budget_admin;

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_VIEWER TO ROLE budget_monitor;

カスタム予算を管理するインスタンスロール¶

各カスタム予算にはインスタンスロールがあり、他のロールに付与して予算を表示または変更できます。

GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
  TO ROLE budget_admin;

コストの調査¶

サーバーレスタスクのコストは、 Snowsight またはAccount Usage SERVERLESS_TASK_HISTORY ビュー を使用して表示できます。サービスの種類に基づくコストの表示に関する詳細情報については、 コンピューティングコストの調査 をご参照ください。

ストレージのコストは、 Snowsight を使用するか、Account Usageおよび組織の使用状況ビューをクエリすると表示できます。ストレージコストの表示の詳細については、 ストレージコストの調査 をご参照ください。

アカウント予算をアクティブ化する¶

アカウント予算をアクティブ化し、アカウントの支出制限を設定し、クレジットの使用状況が支出制限を超えた場合に通知を受け取るためのメールアドレスを指定します。

Snowsight または SQL を使用してアカウント予算をアクティブ化できます。

Snowsightを使用したカスタム予算の作成¶

1. Snowsight にサインインします。

2. Select Admin » Cost Management

3. Budgets を選択します。

4. ダッシュボードの右上隅で、 （Budgetを追加）を選択します。

   注釈

   Budgetを追加アイコンが表示されない場合は、まず アカウント予算 をアクティブにする必要があります。

5. Budget name を入力します。

6. 予算を作成するデータベースとスキーマを選択します。

7. Spending limit を入力します。

8. 通知を受け取るメールアドレスを入力します。

   注釈

   予算の通知用に追加された各メールアドレスは、 検証済み である必要があります。リスト内のメールアドレスが 検証されていない 場合、通知メールの設定は失敗します。

9. Resources to monitor を選択します。

   • データベースを追加するには、 Databases を展開してデータベースを選択します。

   • スキーマにオブジェクトを追加するには、スキーマを展開して利用可能なオブジェクトをリストします。オブジェクトのカテゴリ（例: Tables または Tasks）を展開してオブジェクトを選択します。

   • ウェアハウスを追加するには、 Warehouses を展開してウェアハウスを選択します。

   注釈

   データベースまたはスキーマを選択すると、データベースまたはスキーマに含まれる サポートされたオブジェクト （例: テーブル）もすべて予算に追加されます。

Snowsight を使用して通知用のメールアドレスを追加すると、Snowflakeはバックグラウンドプロセスで default_budget_notification_integration という名前のメール通知統合を作成または更新します。通知統合が存在する場合、Snowflakeは入力した新しいメールアドレスをリスト内の既存のメールアドレスに追加します。

通知統合が存在しない場合、Snowflakeは通知統合を作成して USAGE 権限を付与します。詳細については、 アカウント予算セクションで説明されているステップ をご参照ください。

SQL を使用したカスタム予算の作成¶

カスタム予算を作成してから、支出制限と通知メールアドレスを設定します。

1. アカウントの既存の予算を確認します。

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

2. CREATE SNOWFLAKE.CORE.BUDGET コマンドを使用して budgets_db.budgets_schema に予算 my_budget を作成します。

   USE SCHEMA budgets_db.budgets_schema;
   
   CREATE SNOWFLAKE.CORE.BUDGET my_budget();
   

   Copy

3. 支出制限を月500クレジットに設定します。

   CALL my_budget!SET_SPENDING_LIMIT(500);
   

   Copy

4. 通知統合とメールアドレスを設定します。

   注釈

   メール NOTIFICATION INTEGRATION をまだ作成していない場合は、 アカウント予算セクションのステップ を参照して作成してください。

   CALL my_budget!SET_EMAIL_NOTIFICATIONS('budgets_notification_integration',
                                          'costadmin@example.com');
   

   Copy

5. カスタム予算にオブジェクトを追加するには、予算の ADD_RESOURCE メソッドへの参照を渡す必要があります。たとえば、 t1 という名前のテーブルを my_budget という名前の予算に追加します。

   CALL budgets_db.budgets_schema.my_budget!ADD_RESOURCE(
      SYSTEM$REFERENCE('TABLE', 't1', 'SESSION', 'applybudget'));
   

   Copy

   SYSTEM$REFERENCE ステートメントは、 APPLYBUDGET 権限をテーブルに付与した TABLE オブジェクト t1 への参照を作成します。関数の3番目のパラメーターは、参照のスコープを指定し、この場合、「SESSION」はセッションスコープの参照を作成します。予算の ADD_RESOURCE メソッドに渡される参照は、任意の一時的な参照スコープで作成できます（つまり、3番目のパラメーターは「SESSION」または「CALL」のいずれかにできます）。

6. ADMIN インスタンスロールをカスタム budget_admin ロールに付与します。

   GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
     TO ROLE budget_admin;
   

   Copy

アカウント予算をアクティブ化できない¶

アカウント予算をアクティブ化できない理由は複数あります。

Unknown user-defined function SNOWFLAKE.LOCAL.ACTIVATE

FAILURE: Uncaught exception of type 'BUDGET_ALREADY_ACTIVATED' on line X at position X

CALL SNOWFLAKE.LOCAL.ACCOUNT_ROOT_BUDGET!GET_CONFIG();

-20000 (P0001): Uncaught exception of type 'NO_PERMISSION_TO_ACTIVATE_BUDGET' on line X at position X

カスタム予算を作成できない¶

カスタム予算を作成できない理由は複数あります。

FAILURE: SQL access control error: Insufficient privileges to operate on class 'BUDGET'

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

カスタム予算をアクティブ化できない¶

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

アカウント予算のメソッドを呼び出すことができない¶

アカウント予算でメソッドを呼び出すと失敗する理由は複数あります。

-20000 (P0001): Uncaught exception of type 'FUNCTION_NOT_SUPPORTED_FOR_ACCOUNT_ROOT_BUDGET' on line 11 at position 18

-20000 (P0001): Uncaught exception of type 'ACCOUNT_ROOT_BUDGET_NOT_ACTIVATED' on line X at position X

アカウントでBudgets機能を使用できない¶

FAILURE: SQL compilation error: Class 'SNOWFLAKE.CORE.BUDGET' does not exist or not authorized.

000002 (0A000): Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 : Unsupported feature 'TOK_RESOURCE_GROUP'.