ALTER ALERT

Snowflake logo in black (no text) プレビュー機能 --- オープン

すべてのアカウントで利用可能。

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

こちらもご参照ください。

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> 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 をご参照ください。

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 権限を持つ任意のロール）は、このカスタムロールを任意のアラート所有者ロールに付与して、自身のアラートの変更を許可できます。カスタムロールとロール階層を作成する手順については、 アクセス制御の構成 をご参照ください。

  • Regarding metadata:

    注意

    Customers should ensure that no personal data (other than for a User object), sensitive data, export-controlled data, or other regulated data is entered as metadata when using the Snowflake service. For more information, see Snowflakeのメタデータフィールド.

例

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

言語: 日本語