カスタム予算¶

タグ継承¶

タグを予算に追加すると、親オブジェクトからタグを継承したオブジェクトを含め、そのタグを持つすべてのオブジェクトが追跡されます。たとえば、データベースにタグがある場合、データベース内のテーブルはタグを継承し、予算によって追跡されます。予算はタグ/値ペアに基づいて使用状況を追跡するため、テーブルレベルでタグの値を上書きすると、予算がテーブルに関連付けられた使用状況を追跡するかどうか変更される可能性があります。たとえば、タグ team = 'eng' を持つオブジェクトを追跡する予算があるとします。データベースにタグ team = 'eng' があり、データベース内のテーブルにタグ team = 'IT' がある場合、予算はそのテーブルに関連するコストを監視しません。

予算のコンテキストでは、アカウント予算はそのユースケースを達成することを目的としているため、タグはアカウントから継承されません。

タグ値の上書き方法などの詳細については、タグ継承 をご参照ください。

複数の予算を持つオブジェクトの追跡¶

複数の予算は同じタグ/値ペアを追加できます。つまり、複数の予算は同じオブジェクトのクレジット使用状況を追跡できます。たとえば、タグ cost_center = 'eng' を budget_1 と budget_2 の両方に追加するとします。タグ cost_center = 'eng' を持つウェアハウスがクレジットを消費すると、budget_1 と budget_2 両方のクレジット上限に対してカウントされます。

オブジェクトに複数のタグがある場合は、複数の予算がオブジェクトを追跡することもできます。たとえば、ウェアハウスに2つのタグ（cost_center = 'finance' および stage = 'dev'）があるとします。cost_center = 'finance' を追跡する予算と stage = 'dev' を追跡する予算を作成できます。ウェアハウスによって消費されたクレジットは、両方の予算のクレジット上限に対してカウントされます。

制限と考慮事項¶

タグを使用してオブジェクトを監視する場合は、次の点に注意してください。

• オブジェクトのタグを変更すると、タグを使用する予算に変更が反映されるまでに最大6時間かかる場合があります。

• 現在、アラートはタグを使用して監視することはできません。個別に追加する必要があります。

• 月の最初の2日間にタグを変更すると、前月の使用状況に反映されます。

予算を作成するためにカスタムロールを作成する¶

カスタムロールを使用して、アカウントに予算を作成できます。カスタム予算を作成するためにロールに付与する必要がある権限とロールの包括的なリストについては、 Budgetのロールと権限 をご参照ください。

以下の例では、 budget_owner ロールというロールを作成し、スキーマ budgets_db.budgets_schema でカスタム予算を作成するために必要なロールと権限を付与しています。この例は ACCOUNTADMIN ロールを使用して実行する必要があります。

USE ROLE ACCOUNTADMIN;
   
CREATE ROLE budget_owner;
  
GRANT USAGE ON DATABASE budgets_db TO ROLE budget_owner;
GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_owner;

GRANT DATABASE ROLE SNOWFLAKE.BUDGET_CREATOR TO ROLE budget_owner;

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

予算所有者以外のロールがカスタム予算の設定を変更できるようにする場合は、変更権限を持つカスタムロールを作成することができます。詳細については、 カスタム予算を管理するカスタムロールを作成する をご参照ください。

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

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

2. ナビゲーションメニューで Admin » Cost management を選択します。

3. Select the Budgets tab.

4. Select + Budget.

5. Basic Information ページで、次の手順を実行します。

   1. Location to store ドロップダウンから、予算を作成するデータベースとスキーマの名前を選択します。

   2. Name フィールドで、カスタム予算の名前を指定します。

   3. Budget (credits per month) フィールドで、予算の支出制限を指定します。

   4. 予算更新間隔 を減らして支出をより密接に観察できるようにするには、 Enable low latency budget を選択します。

   5. Threshold フィールドで、予算制限の割合を指定します。Snowflakeが支出制限のこの割合を超えると判断した場合、通知が送信されます。

   6. In the Notify field, enter email addresses to receive notification emails.

      注釈

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

   7. Select Next.

6. On the Budget scope page, add the objects that you want to add to the custom budget.

   • タグを使用 してオブジェクトによる消費を追跡するには、次のステップを実行します。

     1. Select the Tags on resources drop-down list.

     2. 適切なタグを見つけて展開し、1つ以上の値を選択します。

     3. Done を選択します。

   • 予算に個々のオブジェクトを追加する場合は、以下の手順を実行します。

     1. Select the Resources drop-down list.

     2. 1つ以上のオブジェクトを選択します。

     3. Done を選択します。

        注釈

        If you are directly adding individual objects, you can only add an object to one custom budget. In this case, if an object is currently included in one custom budget and you add that object to a second custom budget, Budgets removes the object from the first custom budget without issuing a warning.

        この動作は、タグを使用してオブジェクトを予算に追加する場合には適用されません。タグを使用してオブジェクトを予算に追加する場合、1つ以上のタグを持つオブジェクトを複数のカスタム予算に含めることができます。

7. Select Create.

カスタム予算を作成して設定した後、カスタムロールを作成して、アカウント管理者以外の人が予算のリソースと使用状況をモニターできるようにすることができます。詳細については、 カスタム予算をモニターするカスタムロールを作成する をご参照ください。

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

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

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

   注釈

   次のステートメントは、アクセス権限を持っている予算を返します。ACCOUNTADMIN ロールを持つユーザーだけが、アカウント内のすべての予算を見ることができます。

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

2. CREATE 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. 予算に関する通知をセットし、クレジットの使用状況が支出制限を超えると予想される場合に通知を受け取れるようにします。

   予算に関する通知 をご参照ください。

カスタム予算を作成して設定した後、カスタムロールを作成して、アカウント管理者以外の人が予算のリソースと使用状況をモニターできるようにすることができます。詳細については、 カスタム予算をモニターするカスタムロールを作成する をご参照ください。

新しい予算にオブジェクトを追加するには、 カスタム予算に対してオブジェクトを追加または削除する をご参照ください。

カスタムロールの例¶

カスタムロール budget_admin にスキーマ budgets_db.budgets_schema の予算をモニターして変更する権限 my_budget を付与します。

• スキーマ budgets_db.budgets_schema の予算 my_budget のカスタムロール budget_admin に、必要な権限とインスタンスロールを付与します。

  GRANT USAGE ON DATABASE budgets_db TO ROLE budget_admin;
  
  GRANT USAGE ON SCHEMA budget_db.budgets_schema TO ROLE budget_admin;
  
  GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
     TO ROLE budget_admin;
  
  GRANT DATABASE ROLE SNOWFLAKE.USAGE_VIEWER TO ROLE budget_admin;
  

  Copy

• カスタム予算に追加またはカスタム予算から削除するオブジェクトとタグに、APPLYBUDGET 権限を付与します。このステップは、追加または削除するオブジェクトまたはタグごとに必要です。

  たとえば、ロール budget_admin がデータベース db1 をカスタム予算 my_budget に追加できるようにするには、以下のステートメントを実行します。

  GRANT USAGE ON DATABASE db1 TO ROLE budget_admin;
  
  GRANT APPLYBUDGET ON DATABASE db1 TO ROLE budget_admin;
  

  Copy

Snowsight を使用してカスタム予算に対してタグを追加または削除する¶

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

2. ナビゲーションメニューで Admin » Cost management を選択します。

3. Budgets を選択します。

4. 編集する予算を選択します。

5. ダッシュボードで、|sf-pencil-icon|（編集アイコン）を選択します。

6. + Tags & resources を選択します。

7. Tags を展開し、追加するタグにナビゲートします。

8. 次のいずれかを実行します。

   • タグに 許可された値のリスト がある場合は、1つ以上の値を選択します。

   • タグを任意の値に設定できる場合は、値を指定します。

9. Done を選択します。

SQL コマンドを使用して、カスタム予算に対してタグを追加または削除する¶

予算からタグを追加または削除するために使用されるロールには、タグに対する APPLYBUDGET 権限が必要です。詳細については、 カスタム予算を管理するカスタムロールを作成する セクションの例をご参照ください。

カスタム予算に既にあるタグのリストを確認するには、予算の <budget_name>!GET_LINKED_TAGS メソッドを呼び出します。たとえば、budgets_db.budgets_schema スキーマの予算 my_budget にあるタグのリストを見るには、以下のステートメントを実行します。

CALL budgets_db.budgets_schema.my_budget!GET_LINKED_TAGS();

タグの予算への追加や予算からの削除は、 参照 によって行う必要があります。

1. 以下の手順で、タグ cost_mgmt_db.tags.cost_center を予算 my_budget に追加できます。

   1. 以下のステートメントを実行することで、 budget_admin ロールにタグに対する APPLYBUDGET 権限を付与します。

      GRANT APPLYBUDGET ON TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. :doc:` ADD_TAG</sql-reference/classes/budget/methods/add_tag>`インスタンスメソッドにタグ cost_center の参照を渡すには、以下のステートメントを実行します。タグの値は finance に設定されます。

      CALL budgets_db.budgets_schema.my_budget!ADD_TAG(
         SELECT SYSTEM$REFERENCE('TAG',
            'cost_mgmt_db.tags.cost_center',
            'SESSION',
            'applybudget'),
            'finance');
      

      Copy

      SYSTEM$REFERENCE 関数は、タグに対する APPLYBUDGET 権限が付与された、 タグ cost_center の参照を作成します。これにより、予算はアカウントに指定されたタグ/値ペアを持つアカウント内のオブジェクトを監視できるようになります。関数の3番目のパラメーターは、参照のスコープを指定し、この場合、「SESSION」はセッションスコープの参照を作成します。予算の ADD_TAG メソッドに渡される参照は、任意の一時的な参照スコープで作成できます（つまり、3番目のパラメーターは「SESSION」または「CALL」のいずれかにできます）。

2. 以下の手順で、予算 my_budget からタグ `cost_center ` を削除できます。

   1. 以下のステートメントを実行することで、 budget_admin ロールにテーブルに対する APPLYBUDGET 権限を付与します。

      GRANT APPLYBUDGET ON TAG cost_center TO ROLE budget_admin;
      

      Copy

   2. REMOVE_TAG インスタンスメソッドに参照を渡してタグを削除します。

      CALL budgets_db.budgets_schema.my_budget!REMOVE_TAG(
         SELECT SYSTEM$REFERENCE('TAG',
            'cost_mgmt_db.tags.cost_center',
            'SESSION',
            'applybudget'),
            'finance');
      

      Copy

Snowsight を使用してカスタム予算からオブジェクトを追加または削除する¶

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

2. ナビゲーションメニューで Admin » Cost management を選択します。

3. Budgets を選択します。

4. 編集する予算を選択します。

5. ダッシュボードで、|sf-pencil-icon|（編集アイコン）を選択します。

6. + Tags & resources を選択して、カスタム予算に追加するオブジェクトを選択します。

   注釈

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

   • If you are directly adding individual objects, you can only add an object to one custom budget. In this case, if an object is currently included in one custom budget and you add that object to a second custom budget, Budgets removes the object from the first custom budget without issuing a warning.

     この動作は、タグを使用してオブジェクトを予算に追加する場合には適用されません。タグを使用してオブジェクトを予算に追加する場合、1つ以上のタグを持つオブジェクトを複数のカスタム予算に含めることができます。

7. Done を選択します。

SQL コマンドを使用して、カスタム予算からオブジェクトを追加または削除する¶

予算からオブジェクトを追加または削除するために使用されるロールには、オブジェクトに対する APPLYBUDGET 権限が必要があります。詳細については、 カスタム予算を管理するカスタムロールを作成する セクションの例をご参照ください。

カスタム予算に既にあるオブジェクトのリストを確認するには、予算の <budget_name>!GET_LINKED_RESOURCES メソッドを呼び出します。例えば、 budgets_db.budgets_schema スキーマの予算 my_budget にあるオブジェクトのリストを見るには、以下のステートメントを実行します。

CALL budgets_db.budgets_schema.my_budget!GET_LINKED_RESOURCES();

ステートメントは、次の出力を返します。

+-------------+-----------------+-----------+-------------+---------------+
| RESOURCE_ID | NAME            | DOMAIN    | SCHEMA_NAME | DATABASE_NAME |
|-------------+-----------------+-----------+-------------+---------------|
|         326 | DB1             | DATABASE  | NULL        | NULL          |
|         157 | MY_WH           | WAREHOUSE | NULL        | NULL          |
+-------------+-----------------+-----------+-------------+---------------+

オブジェクトの予算への追加や予算からの削除は、 参照 によって行う必要があります。

1. 以下の手順で、テーブル t1 を予算 my_budget に追加できます。

   1. 以下のステートメントを実行することで、 budget_admin ロールにテーブルに対する APPLYBUDGET 権限を付与します。

      GRANT APPLYBUDGET ON TABLE t1 TO ROLE budget_admin;
      

      Copy

   2. ADD_RESOURCE のインスタンスメソッドにテーブル t1 の参照を渡すには、以下のステートメントを実行します。

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

      Copy

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

      注釈

      予算に Snowflake Native App を追加する場合は、 SYSTEM$REFERENCE を呼び出す際、 object_type 引数に 'DATABASE' （'APPLICATION' ではない）を指定します。

      オブジェクトと権限の包括的なリストについては、 参照のサポートされるオブジェクト型と権限 をご参照ください。

      注釈

      If you are directly adding individual objects, you can only add an object to one custom budget. In this case, if an object is currently included in one custom budget and you add that object to a second custom budget, Budgets removes the object from the first custom budget without issuing a warning.

      この動作は、タグを使用してオブジェクトを予算に追加する場合には適用されません。タグを使用してオブジェクトを予算に追加する場合、1つ以上のタグを持つオブジェクトを複数のカスタム予算に含めることができます。

2. 以下の手順で、予算 my_budget からデータベース db1 を削除できます。

   1. 以下のステートメントを実行することで、 budget_admin ロールにテーブルに対する APPLYBUDGET 権限を付与します。

      GRANT APPLYBUDGET ON DATABASE db1 TO ROLE budget_admin;
      

      Copy

   2. REMOVE_RESOURCE インスタンスメソッドに参照を渡してデータベースを削除します。

      CALL budgets_db.budgets_schema.my_budget!REMOVE_RESOURCE(
         SELECT SYSTEM$REFERENCE('DATABASE', 'db1', 'SESSION', 'applybudget'));
      

      Copy