ALTER ALERT¶

既存のアラートのプロパティを変更し、既存のアラートを中断または再開します。

こちらもご参照ください。: CREATE ALERT、 DESCRIBE ALERT、 DROP ALERT、 SHOW ALERTS

構文¶

ALTER ALERT [ IF EXISTS ] <name> { RESUME | SUSPEND };

ALTER ALERT [ IF EXISTS ] <name> SET
  [ WAREHOUSE = <string> ]
  [ SCHEDULE = '{ <number> MINUTE | USING CRON <expr> <time_zone> }' ]
  [ COMMENT = <string> ]

ALTER ALERT [ IF EXISTS ] <name> UNSET
  [ WAREHOUSE ]
  [ SCHEDULE ]
  [ COMMENT ]
  [ , ... ]

ALTER ALERT [ IF EXISTS ] <name> MODIFY CONDITION EXISTS (<condition>)

ALTER ALERT [ IF EXISTS ] <name> MODIFY ACTION <action>

Copy

パラメーター¶

name

変更するアラートの識別子。識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

RESUME | SUSPEND

アラートで実行するアクションを指定します。

RESUME は、中断しているアラートをアクティブにします。
SUSPEND は、アラートを「中断」状態にします。

アラートスケジュールが間隔（つまり、 num MINUTE）に設定されている場合は、あいまいさを避けるため、アラート再開時にスケジュールの 基本間隔時間 が現在の時刻にリセットされます。

基本間隔時間は、現在のクロックタイムから間隔カウンターを開始します。たとえば、アラートが 10 MINUTE で作成され、アラートが9:03 AM に再開される場合、アラートは9:13 AM、9:23 AM というように実行されます。絶対精度を確保するために最善を尽くしますが、保証されるのは、設定間隔の前にアラートが実行されないようにすることのみです（たとえば、現在の例では、アラートは最初に9:14 AM に実行されることはあっても、9:12 AM に実行されることは決してありません）。

SET ...

アラートに設定する1つ（または複数）のプロパティを指定します（空白、コンマ、または改行で区切り）。設定できるプロパティの詳細については、 CREATE ALERT をご参照ください。

UNSET ...

アラートの設定を解除する1つ（または複数）のプロパティやセッションパラメーターを指定します。これにより、デフォルトにリセットされます。

単一の ALTER ステートメントで複数のプロパティ/パラメーターをリセットできます。ただし、各プロパティ/パラメーターはコンマで区切る必要があります。プロパティ/パラメーターをリセットするときは、名前のみを指定します。プロパティ/パラメーターの値を指定すると、エラーが返されます。

MODIFY CONDITION EXISTS (condition)

アラートの条件を表す SQL ステートメントを指定します。次のコマンドを使用できます。

ステートメントが1つ以上の行を返す場合にアラートのアクションが実行されます。

MODIFY ACTION action

条件が1つ以上の行を返す場合に実行する SQL ステートメントを指定します。

メール通知を送信するには、 SYSTEM$SEND_EMAIL() ストアドプロシージャを呼び出します。

アクセス制御の要件¶

この SQL コマンドを実行するには、少なくとも次の権限を持つロールが必要です。

アラートを再開するには、
- アラートに対する OWNERSHIP 権限を持つロールには、 EXECUTE ALERT グローバル権限も必要です。
- ALTER ALERT を実行するロールには、アラートに対する OPERATE または OWNERSHIP 権限が必要です。
アラートを中断するには、 ALTER ALERT を実行するロールにアラートに対する OPERATOR または OWNERSHIP 権限が必要です。
アラートのプロパティを変更するには、 ALTER ALERT を実行するロールにアラートに対する OWNERSHIP 権限が必要です。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

指定された権限のセットを使用してカスタムロールを作成する手順については、カスタムロールの作成をご参照ください。

セキュリティ保護可能なオブジェクトに対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、アクセス制御の概要をご参照ください。

使用上の注意¶

アラートが再開されると、Snowflakeは、アラートに対する OWNERSHIP 権限を持つロールが、アラートに割り当てられたウェアハウスに対する USAGE 権限、および EXECUTE ALERT グローバル権限を持っていることを確認します。権限がない場合は、エラーが生成されます。
アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）のみが、ロールに EXECUTE ALERT 権限を付与できます。使いやすくするために、カスタムロール（例: alert_admin）を作成し、このロールに EXECUTE ALERT 権限を割り当てることをお勧めします。権限を付与できるロール（例: SECURITYADMIN または MANAGE GRANTS 権限を持つ任意のロール）は、このカスタムロールを任意のアラート所有者ロールに付与して、自身のアラートの変更を許可できます。カスタムロールとロール階層を作成する手順については、アクセス制御の構成をご参照ください。

例¶

アラートの中断と再開をご参照ください。