リソースモニターの操作¶

リソースモニターのプロパティ¶

リソースモニターはSnowflakeのファーストクラスオブジェクトであり、次のプロパティで構成されています。

リソースモニターの割り当て¶

アカウントレベルで単一のモニターを設定して、アカウント内のすべてのウェアハウスのクレジット使用状況を制御できます。

加えて、1つ以上のウェアハウスをリソースモニターに割り当てることができるため、割り当てられた各ウェアハウスのクレジット使用状況を制御できます。ただし、ウェアハウスはアカウントレベル下の1つのリソースモニターにのみ割り当てることができます。

次の図は、1つのリソースモニターがアカウントレベルで設定され、個々のウェアハウスが他の2つのリソースモニターに割り当てられるシナリオを示しています。

この図に基づいて、

• アカウント全体のクレジットクォータは、リソースモニター1によって制御される間隔（月、週など）で5000です。間隔内でこのクォータに達すると、リソースモニターに定義されたアクション（一時停止、 即時一時停止 など）が5つのウェアハウスすべてに適用されます。

• ウェアハウス3は、間隔内で最大1000クレジットを消費できます。

• ウェアハウス4と5は、間隔内で合計で最大2500クレジットを消費できます。

アカウントのクォータに最初に達した場合、ウェアハウス3、4、および5によって消費される実際のクレジットはクォータよりも少ない場合があることに注意してください。

ウェアハウスの一時停止と再開¶

リソースモニターの使用クレジットは、指定された間隔内で割り当てられたすべてのウェアハウスによって消費されたクレジットの合計と、同じ間隔内でそれらのウェアハウスをサポートするために使用されたクラウドサービスを反映します。モニターに 一時停止 または 即時一時停止 アクションが定義されており、使用済みクレジットがアクションのしきい値に達すると、モニターに割り当てられたウェアハウスはすべて一時停止され、次の条件のいずれかが満たされるまで再開できません。

• モニターの開始日によって決まる次の間隔（ある場合）が開始されます。

• モニターのクレジットクォータが増加します。

• 一時停止アクションのクレジットしきい値が増加します。

• これで、ウェアハウスはモニターに割り当てられなくなります。

• モニターはドロップされます。

ウェアハウスレベルのリソースモニターは、クラウドサービスによるクレジットの使用状況をモニターできますが、中断することはできません。仮想ウェアハウスが中断された後も、そのウェアハウスに対して実行される後続のクエリにより、追加のクラウドサービスコストが発生する可能性があります。クラウドサービスのクレジット使用状況の情報については、 クラウドサービスのクレジット使用状況 をご参照ください。

リソースモニター通知¶

リソースモニターが アクション のしきい値に達すると、以下のような通知を生成します。

Resource Monitor MY_ACCOUNT_MONITOR has reached 50% of its MONTHLY
quota of 500 credits which has triggered a <action> action.

<アクション> は以下のいずれかのアクションです。

• NOTIFY

• SUSPEND

• SUSPEND_IMMEDIATE

通知の動作は、リソースモニターの タイプ と、個々のユーザーに対して通知が 有効 になっているかどうかによって異なります。通知は以下のように送信されます。

• ウェアハウス モニターの場合、以下のユーザーに通知が送信されます。

  • リソースモニターの通知を有効にしているすべてのアカウント管理者。

  • リソースモニターの通知リストにある管理者以外のユーザー。

• アカウント モニターの場合、以下のユーザーに通知が送信されます。

  • 通知を有効にしている場合、リソースモニターのOWNERSHIP権限を持つアカウント管理者。

  • All account administrators who have enabled notifications using Snowsight.

  注釈

  管理者以外のユーザーを アカウント モニターの通知リストに追加することはできません。

リソースモニター用 DDL¶

Snowflakeには、リソースモニターを作成および使用/管理するための次の DDL コマンドが用意されています。

• CREATE RESOURCE MONITOR

• ALTER RESOURCE MONITOR

• SHOW RESOURCE MONITORS

• DROP RESOURCE MONITOR

さらに、以下の DDL コマンドを使用して、ウェアハウスにリソースモニターを割り当てたり、ウェアハウスがモニターに割り当てられているかどうかを判断することができます。

• CREATE WAREHOUSE または ALTER WAREHOUSE

• SHOW WAREHOUSES

リソースモニターのアクセス制御権限¶

デフォルトでは、リソースモニターはアカウント管理者のみが作成できるため、アカウント管理者のみが表示および管理できます。

ただし、特定のリソースモニターで次の権限が付与されているロールは、必要に応じて、 SQL を使用してリソースモニターを表示および変更できます。

• MONITOR

• MODIFY

詳細については、 アクセス制御権限 および GRANT <権限> ... TO ROLE をご参照ください。

Note that only account administrators can view and manage resource monitors via the Snowsight.

通知受信の有効化¶

リソースモニターからの通知を受け取る前に、ウェブインターフェイスで通知を有効にし、メールを確認する必要があります。

Snowsight:

通知を有効にするには、次の手順に従います。

1. メールアドレスの確認が済んでいない場合は、確認を行ってください。メールアドレスの確認方法については、 メールアドレスを確認する をご参照ください。

2. ユーザー名を選択してから、 Profile を選択します

3. Notifications には、 Enable notifications from resource monitors を選択します。

   注釈

   • メールアドレスの確認を行っていない場合、確認を行うまで Notifications オプションは使用できません。

   • Notifications では、次のケースで Enable notifications from resource monitors オプションは、ACCOUNTADMIN ロールを持つユーザーのみ使用できます。

     • アカウントにリソースモニターが割り当てられていて、アカウント管理者がそのアカウントモニターに対してOWNERSHIP権限を持っている場合。

     • アカウントにウェアハウスモニターがいる場合。すべてのアカウント管理者はウェアハウスモニターの通知を受け取ることができます。

リソースモニターの作成¶

リソースモニターは、ウェブインターフェイスまたは SQL を使用して作成できます。ただし、リソースモニターを作成できるのは、アカウント管理者（ACCOUNTADMIN ロールのあるユーザー）のみです。

500個を超えるウェアハウスにリソースモニターを割り当てることはできません。

リソースモニターの変更¶

既存のリソースモニターの次のプロパティを変更できます。

• モニターのクレジットクォータを増減します。

• モニターのスケジュール（頻度、開始タイムスタンプ、終了タイムスタンプ）をカスタマイズします。

• アクションを追加または削除するか、既存のアクションのしきい値の割合を変更します。

• モニターでアカウントを監視している場合、個々のウェアハウスを監視するように変換します。

• モニターが個々のウェアハウスを監視している場合は、次を実行します。

  • リストからウェアハウスを追加または削除します。

  • アカウントを監視するために変換します。

リソースモニターは、ウェブインターフェイスまたは SQL を使用して変更できます。

Snowsight:

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

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

3. Resource Monitors を選択してから、リソースモニターを選択します。

4. 右上の More メニュー（...）を選択します。Edit を選択します。

SQL:

• クォータを変更する、スケジュールをカスタマイズする、またはアクションを追加/削除/変更するには、 ALTER RESOURCE MONITOR ステートメントを実行します。

  たとえば、リソースモニター limit1 のクレジットクォータを 3000 に増やすには、次のステートメントを実行します。

  ALTER RESOURCE MONITOR limit1 SET CREDIT_QUOTA=3000;
  

  Copy

  その他の例については、 例 をご参照ください。

• モニタータイプを変更するには、 ALTER WAREHOUSE または ALTER ACCOUNT ステートメントを実行します。

  例えば、現在ウェアハウスを監視しているリソースモニター my_rm を、アカウント my_account を監視するように変更するには、次の手順を実行します。

  1. リソースモニター my_rm が監視しているすべてのウェアハウスを見つけます。my_rm の resource_monitor 列を確認します。

     SHOW WAREHOUSES;
     

     Copy

     次の結果が返されます。

     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     | name   | state     | type     | size    | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on                    | resumed_on                    | updated_on                    | owner        | comment | resource_monitor | actives | pendings | failed | suspended | uuid       | budget | owner_role_type |
     |--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------|
     | MY_WH1 | STARTED   | STANDARD | X-Small |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:37:36.223 -0800 | 2024-01-17 14:37:36.325 -0800 | 2024-01-17 14:47:49.854 -0800 | MY_ROLE      |         | null             |       0 |        0 |      0 |         1 | 1222706972 | NULL   | ROLE            |
     | MY_WH2 | SUSPENDED | STANDARD | X-Small |       0 |      0 | N          | Y          |          600 | true        |           |              |           |       | 2023-12-20 13:50:50.972 -0800 | 2024-01-17 14:28:39.170 -0800 | 2024-01-17 14:37:57.560 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         1 | 1222706948 | NULL   | ROLE            |
     | MY_WH3 | SUSPENDED | STANDARD | Small   |       0 |      0 | N          | N          |          600 | true        |           |              |           |       | 2024-01-17 14:26:26.911 -0800 | 2024-01-17 14:33:39.260 -0800 | 2024-01-17 14:38:31.192 -0800 | ACCOUNTADMIN |         | MY_RM            |       0 |        0 |      0 |         2 | 1222706960 | NULL   | ROLE            |
     +--------+-----------+----------+---------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+------------------+---------+----------+--------+-----------+------------+--------+-----------------+
     

     リソースモニター my_rm は2つのウェアハウス my_wh2 と my_wh3 を監視しています。

  2. 次のステートメントを実行して、両方のウェアハウスのリソースモニターを削除します。

     ALTER WAREHOUSE my_wh2 UNSET RESOURCE_MONITOR;
     
     ALTER WAREHOUSE my_wh3 UNSET RESOURCE_MONITOR;
     

     Copy

  3. 次のステートメントを実行して、アカウントを監視するようにリソースモニターを変更します。

     ALTER ACCOUNT my_account SET RESOURCE_MONITOR = my_rm;
     

     Copy

管理者以外のユーザーへのリソースモニター通知の送信¶

管理者以外のユーザーは、 ウェアハウスモニター のメール通知のみを受け取ることができます。管理者以外の各ユーザーは、認証済みのメールアドレスを持っている必要があります。CREATE RESOURCE MONITOR または ALTER RESOURCE MONITOR コマンドを使用して、ウェアハウスモニターに管理者以外のユーザーを5人まで追加できます。

たとえば、ユーザー user1 と user2 をウェアハウスモニター my_warehouse_rm に追加するには、次のステートメントを実行します。

ALTER RESOURCE MONITOR my_warehouse_rm
  SET NOTIFY_USERS = (USER1, USER2);

詳細については、 ALTER RESOURCE MONITOR トピックの NOTIFY_USERSパラメーター および 使用上の注意 をご参照ください。

SQL を使用してリソースモニターを作成する際に、管理者以外のユーザーをリソースモニターの通知リストに追加するには、 CREATE RESOURCE MONITOR をご参照ください。

アカウントのリソースモニターの設定¶

リソースモニターは、ウェブインターフェイスまたは SQL を通じてアカウントに設定できます。

Snowsight:

リソースモニターを作成するときに、モニタータイプをアカウントに設定できます。詳細については、 リソースモニターの作成 をご参照ください。

SQL:

SQL では、このタスクは2つのステップで実行されます。

1. CREATE RESOURCE MONITOR コマンドを使用してリソースモニターを作成します（存在していない場合）。

   リソースモニターが存在する場合、ウェアハウスレベルのリソースモニターをアカウントのモニターに変更するには、 「リソースモニターの変更」セクションの例 をご参照ください。

2. ALTER ACCOUNT コマンドを使用して、作成したリソースモニターをアカウントのモニターとして設定します。

   たとえば、アカウントリソースモニターを my_account_rm に設定するには、次のステートメントを実行します。

   USE ROLE ACCOUNTADMIN;
   
   CREATE RESOURCE MONITOR my_account_rm WITH CREDIT_QUOTA=10000
     TRIGGERS ON 100 PERCENT DO SUSPEND;
   
   ALTER ACCOUNT SET RESOURCE_MONITOR = my_account_rm;
   

   Copy

既存のリソースモニターのモニタータイプをウェアハウスモニターからアカウントモニターに変更するには、 「リソースモニターの変更」セクションの例 をご参照ください。

アカウントにリソースモニターが設定されているかどうかを表示するには、ウェブインターフェイスまたは SHOW RESOURCE MONITORS コマンドを使用します。リソースモニターの LEVEL 列には、アカウントまたは個々のウェアハウスに設定されているかどうかが表示されます。

リソースモニターへのウェアハウスの割り当て¶

ウェアハウスは、ウェブインターフェイスまたは SQL を介して既存のリソースモニターに割り当てることができます。

Snowsight:

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

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

3. Resource Monitors を選択してから、リソースモニターを選択します。

4. 右上の More メニュー（...）を選択します。Edit を選択します。

5. Monitor Type が Account の場合、 Warehouse を選択します。

6. Warehouse を選択し、監視するウェアハウスを選択します。

SQL:

ALTER WAREHOUSE コマンドを使用して、ウェアハウスをリソースモニターに割り当てます。

たとえば、リソースモニター my_rm を使ってウェアハウス my_wh を監視するには、次のステートメントを実行します。

ALTER WAREHOUSE my_wh SET RESOURCE_MONITOR = my_rm;

Copy

リソースモニターの表示¶

リソースモニターは、ウェブインターフェイスまたは SQL で表示できます。

Snowsight:

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

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

3. Resource Monitors を選択すると、自分のロールに MODIFY または MONITOR 権限が付与されているリソースモニターのリストが表示されます。アカウント管理者ユーザーは、すべてのリソースモニターを表示できます。

4. リソースモニターを選択すると、リソースモニターの設定、現在のクレジット使用状況、リソースモニターの権限を持つロールのリストに関する詳細情報が表示されます。

5. Account » Resource Monitors を選択します。

SQL:

ACCOUNTADMIN ロール、またはリソースモニターに対する MONITOR または MODIFY 権限が付与されたロールを使用して、 SHOW RESOURCE MONITORS ステートメントを実行します。

さらに、任意のロールを使用して SHOW WAREHOUSES ステートメントを実行することにより、ロールが所有する（またはロールに USAGE 権限が付与されている）ウェアハウスを表示できます。出力には、ウェアハウスが割り当てられているリソースモニター（ある場合）が含まれます。

リソースモニターの複製¶

リソースモニターは、 複製またはフェールオーバーグループ を使用して、ソースアカウントからターゲットアカウントに複製できます。詳細については、 リソースモニターの複製 をご参照ください。