スキーマ:

ORGANIZATION_USAGE

ALERT_HISTORY ビュー

重要

この表示は組織アカウントでのみ利用可能です。詳細については、 組織アカウントのプレミアムビュー をご参照ください。

このOrganization Usageビューでは、 アラート の使用履歴を取得できます。ビューでは、履歴内のアラートの実行ごとに1行が表示されます。

組織レベルの列

列名

データ型

説明

ORGANIZATION_NAME

VARCHAR

組織の名前。

ACCOUNT_LOCATOR

VARCHAR

システムが生成したアカウントの識別子。

ACCOUNT_NAME

VARCHAR

ユーザー定義のアカウント識別子。

追加列

列名

データ型

説明

NAME

VARCHAR

アラートの名前。

DATABASE_NAME

VARCHAR

アラートを含むデータベースの名前。

SCHEMA_NAME

VARCHAR

アラートを含むスキーマの名前。

ACTION

VARCHAR

アラートのアクションとして機能する SQL ステートメントのテキスト。

ACTION_QUERY_ID

VARCHAR

アラートのアクションとして実行される SQL ステートメントの内部/システム生成識別子。

CONDITION

VARCHAR

アラートの条件として機能する SQL ステートメントのテキスト。

CONDITION_QUERY_ID

VARCHAR

アラートの条件として実行される SQL ステートメントの内部/システム生成識別子。

ERROR_CODE

NUMBER

アラートがエラーを返した場合、または実行に失敗した場合(例: 現在のユーザーがアラートを実行する権限を持っていない場合)のエラーコード。

ERROR_MESSAGE

VARCHAR

アラートがエラーを返した場合のエラーメッセージ。

STATE

VARCHAR

アラートのステータス。これは、次のいずれかになります。

  • SCHEDULED: アラートは、 SCHEDULED_TIME 列で指定された時刻に実行されます。このステータスは、 新規データに関するアラート には適用されません。

  • EXECUTING: アラートの条件またはアクションは現在実行中です。

  • FAILED: アラートは失敗しました。アラート条件またはアラートアクションのいずれかで、実行を妨げるエラーが発生しました。

  • CANCELLED: アラートの実行がキャンセルされました(例: アラートが中断された場合)。

  • CONDITION_FALSE: 条件は正常に評価されましたが、データは返されませんでした。その結果、アクションが実行されませんでした。このステータスは、 新規データに関するアラート には適用されません。

  • CONDITION_FAILED: 条件の評価に失敗しました。失敗の詳細については、 ERROR_CODE 列と ERROR_MESSAGE 列を確認してください。

  • ACTION_FAILED: 条件は正常に評価されましたが、アクションの実行は失敗しました。失敗の詳細については、 ERROR_CODE 列と ERROR_MESSAGE 列を確認してください。

  • TRIGGERED: 条件が正常に評価され、アクションが正常に実行されました。

SCHEDULED_TIME

TIMESTAMP_LTZ

スケジュールされたアラートの実行開始時刻。

私たちは、絶対的な精度を保証するために最善の努力をしますが、アラートがスケジュール時間の 前に 実行されないことだけを保証することに注意してください。

COMPLETED_TIME

TIMESTAMP_LTZ

アラートが完了した時刻、または SCHEDULED_TIME が将来の場合、またはアラートがまだ実行中の場合は NULL になります。

DATABASE_ID

NUMBER

スキーマを含むデータベースの内部/システム生成識別子。

SCHEMA_ID

NUMBER

スキーマの内部/システム生成識別子。

SCHEDULED_FROM

VARCHAR

何がアラートを開始したかを指定します。列には以下の値のいずれかが含まれます。

  • SCHEDULE: CREATE ALERT の SCHEDULE 句に記述されているように、アラートは正常に実行されるようにスケジュールされました。

  • EXECUTE ALERT: アラートは EXECUTE ALERT を使用して実行されるようにスケジュールされました。

  • TRIGGER: 基になるテーブルまたはビューに新しいデータが含まれているため、 新しいデータに関するアラート が実行されました。

使用上の注意

  • ビューの遅延は最大24時間です。

  • パフォーマンスを向上させるには、 COMPLETED_TIME または SCHEDULED_TIME 列でクエリをフィルターします。

完了したアラート実行の最新10件の記録を取得します。

SELECT account_name, name, condition, condition_query_id, action, action_query_id, state
  FROM snowflake.organization_usage.alert_history
  LIMIT 10;
Copy

過去1時間に完了したアラート実行の記録を取得します。

SELECT account_name, name, condition, condition_query_id, action, action_query_id, state
FROM snowflake.organization_usage.alert_history
WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());
Copy