ALTER ALERT¶
既存のアラートのプロパティを変更し、既存の アラート を中断または再開します。
- こちらもご参照ください。
構文¶
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>
パラメーター¶
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 権限を持つ任意のロール)は、このカスタムロールを任意のアラート所有者ロールに付与して、自身のアラートの変更を許可できます。カスタムロールとロール階層を作成する手順については、 アクセス制御の構成 をご参照ください。
例¶
アラートの中断と再開 をご参照ください。