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

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

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

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

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

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

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

この図に基づいて、

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

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

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

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

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

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

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

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

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

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

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

リソースモニター通知¶

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

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

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

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

通知は、通知の受信を有効にしたすべてのアカウント管理者と通知リストにある管理者アカウント以外のユーザーに送信されます。

デフォルトスケジュールによるリソースモニターの作成¶

デフォルトスケジュールを使用するリソースモニターを作成するには（監視をすぐに開始し、各暦月の最初の日にリセットするには）、次を実行します。

Classic Web Interface

1. ACCOUNTADMIN システムロールを使用します。

2. Account » Resource Monitors » Create Resource Monitor をクリックします。

3. 名前とクォータを入力します。

4. アカウントまたは個々のウェアハウスのモニターにリソースモニターを使用するかどうかを指定します。

5. 少なくとも1つの一時停止アクションのしきい値を入力します。また、最大5つの通知アクションを指定して、ウェアハウスを一時停止せずにアラートを送信することもできます。

SQL

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

1. CREATE RESOURCE MONITOR コマンドを実行しますが、スケジューリングプロパティは指定しません。

2. ALTER WAREHOUSE コマンドを実行してウェアハウスをリソースモニターに割り当てる、 または、 ALTER ACCOUNT コマンドを使用してアカウントのリソースモニターを設定します。

例:

• すぐに監視を開始し、各月の初めにリセットし、使用済みクレジットがクレジットクォータの100%に達すると、割り当てられたウェアハウスを一時停止するモニターを作成するには、次を実行します。

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
    TRIGGERS ON 100 PERCENT DO SUSPEND;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

  SUSPEND アクションは、現在実行中のクエリが完了するのを待ってから、ウェアハウスを一時停止します。これは、トリガーが起動する前に開始されたクエリが完了するまで実行され、クォータに達した後でもウェアハウスがクレジットを消費することを意味します。

• 最初の例と同様のモニターを作成しますが、クォータに達した後にアカウント内のすべてのウェアハウスがクレジットを消費しないように90%で一時停止し、100%で即時一時停止します。

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
    TRIGGERS ON 90 PERCENT DO SUSPEND
             ON 100 PERCENT DO SUSPEND_IMMEDIATE;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

  この例では、使用状況が90%に達すると通知が生成され、割り当てられたウェアハウスが一時停止されます。これにより、ウェアハウスは新しいクエリを実行できなくなりますが、現在実行中のクエリは完了できます。割り当てられたウェアハウスの使用状況が100%に達すると、通知が生成され、ウェアハウスは即時一時停止され、現在実行中のすべてのクエリがキャンセルされます。

• 最初の例と同様、割り当てられたウェアハウスがクォータを10%を超え、使用済みクレジットがクォータの半分と4分の3ポイントに達するとアカウント管理者に警告する2つの通知アクションを含むモニターを作成するには、次を実行します。

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
     TRIGGERS ON 50 PERCENT DO NOTIFY
              ON 75 PERCENT DO NOTIFY
              ON 100 PERCENT DO SUSPEND
              ON 110 PERCENT DO SUSPEND_IMMEDIATE;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

  この例では：

  • 50%および75%の使用状況に達すると、通知を有効化したすべてのアカウント管理者にアラート通知が送信されますが、他のアクションは実行されません。

  • 使用状況が100%に達すると、割り当てられたウェアハウスは一時停止されます。

  • 使用状況が110%に達したときにウェアハウスがまだ実行されている場合、即時一時停止されます。

カスタムスケジュールによるリソースモニターの作成¶

デフォルト以外のスケジュールを使用するリソースモニターを作成するには、次を実行します。

Classic Web Interface

1. ACCOUNTADMIN システムロールを使用します。

2. Account » Resource Monitors » Create Resource Monitor をクリックします。

3. 名前とクォータを入力します。

4. アカウントまたは個々のウェアハウスのモニターにリソースモニターを使用するかどうかを指定します。

5. Schedule フィールドで Customize リンクをクリックし、必要に応じて次のプロパティの1つ以上を指定します。

   • 指定した頻度に基づいて使用済みクレジットをリセットします。

   • クレジット使用状況の監視をすぐに開始するか、後で開始します。

   • クレジットクォータのしきい値に達しているかどうかに関係なく、指定された終了日時にウェアハウスを一時停止します。

6. 少なくとも1つの一時停止アクションのしきい値を入力します。また、最大5つの通知アクションを指定して、ウェアハウスを一時停止せずにアラートを送信することもできます。

SQL

次の1つ以上のスケジューリングプロパティを使用して、 CREATE RESOURCE MONITOR コマンドを実行します。

• FREQUENCY

• START_TIMESTAMP

• END_TIMESTAMP

例:

• （現在のタイムスタンプに基づいて）即時開始し、同じ日付に毎月リセットし、終了日時がなく、使用済みクレジットがクォータの100%に達したときに割り当てられたウェアハウスを一時停止するアカウントレベルのリソースモニターを作成するには、次を実行します。

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=1000
      FREQUENCY = MONTHLY
      START_TIMESTAMP = IMMEDIATELY
      TRIGGERS ON 100 PERCENT DO SUSPEND;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  

• 将来の特定の日時に開始し、同じ日付に毎週リセットし、終了日時がなく、割り当てられた2つのウェアハウスの異なるしきい値で2つの異なる一時停止アクションを実行するリソースモニターを作成するには、次を実行します。

  USE ROLE ACCOUNTADMIN;
  
  CREATE OR REPLACE RESOURCE MONITOR limit1 WITH CREDIT_QUOTA=2000
      FREQUENCY = WEEKLY
      START_TIMESTAMP = '2019-03-04 00:00 PST'
      TRIGGERS ON 80 PERCENT DO SUSPEND
               ON 100 PERCENT DO SUSPEND_IMMEDIATE;
  
  ALTER WAREHOUSE wh1 SET RESOURCE_MONITOR = limit1;
  
  ALTER WAREHOUSE wh2 SET RESOURCE_MONITOR = limit1;