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

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

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

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

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

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

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

この図に基づいて、

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

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

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

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

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

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

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

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

• 中断アクションのクレジットしきい値が増加します。

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

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

リソースモニター通知¶

リソースモニターは、アクションのしきい値に達すると、実行されたアクションに基づいて、次の通知のいずれかを生成します。

• 実行中のすべてのクエリが完了すると、割り当てられたウェアハウスは中断されます。

• 割り当てられたウェアハウスで実行中のすべてのクエリはキャンセルされ、ウェアハウスは即時中断になります。

• しきい値に達しましたが、アクションは実行されていません。

通知は、通知の受信を有効にしたすべてのアカウント管理者と、ウェアハウスモニターの通知リストにある管理者アカウント以外のユーザーに送信されます。管理者以外のユーザーをアカウントモニターの通知リストに追加することはできません。

リソースモニター用 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 <権限> をご参照ください。

アカウント管理者のみが、 Classic Console を介してリソースモニターを表示および管理できることに注意してください。

通知受信の有効化¶

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

Snowsight:

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

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

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

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

   注釈

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

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

Classic Console:

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

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

2. 右上の名前の横にあるドロップダウンメニューを選択してから、 Preferences » Notifications を選択します。

3. いずれかのオプションを選択します。

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

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

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

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

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

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

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

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

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

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

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

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

Snowsight:

注釈

Snowsight を使用して、リソースモニターのタイプをウェアハウスからアカウントに変更することはできません。代わりに、 SQL を使用してください。 SQL セクションの例 をご参照ください。

1. Snowsight にサインインし、 Admin » Cost Management に移動します。

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

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

Classic Console:

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

2. リソースモニターを選択します。

3. 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:

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

Snowsight を使用して、リソースモニターのタイプをウェアハウスからアカウントに変更することはできません。代わりに、 SQL を使用してください。 SQL セクションの例 をご参照ください。

Classic Console:

リソースモニターを作成または変更するときに、モニタータイプを Account に設定できます。

• リソースモニターの作成の詳細については、 リソースモニターの作成 をご参照ください。

• リソースモニターの変更の詳細については、 リソースモニターの変更 をご参照ください。

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 にサインインし、 Admin » Cost Management に移動します。

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

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

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

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

Classic Console:

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

2. リソースモニターを選択します。

3. Edit を選択します。

4. モニターにまだウェアハウスが割り当てられていない場合は、 Monitor Level を選択し、次に Warehouse を選択します。

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

SQL:

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

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

ALTER WAREHOUSE my_wh SET RESOURCE_MONITOR = my_rm;

Copy

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

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

Snowsight:

1. Snowsight にサインインし、 Admin » Cost Management に移動します。

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

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

Classic Console:

注釈

ACCOUNTADMIN ロールを持つユーザーのみが Classic Console を使用してリソースモニターを表示できます。

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

SQL:

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

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

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

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