SHOW EVENTS
[{FROM | IN} schema_name]
[LIKE 'pattern' | WHERE expr]
このステートメントは、セクション25.4「イベントスケジューラの使用」 で説明されているイベントマネージャイベントに関する情報を表示します。 これには、これらのイベントが示される元のデータベースに対する EVENT 権限が必要です。
SHOW EVENTS は、そのもっとも単純な形式では、現在のスキーマ内のすべてのイベントを一覧表示します。
mysql> SELECT CURRENT_USER(), SCHEMA();
+----------------+----------+
| CURRENT_USER() | SCHEMA() |
+----------------+----------+
| jon@ghidora | myschema |
+----------------+----------+
1 row in set (0.00 sec)
mysql> SHOW EVENTS\G
*************************** 1. row ***************************
Db: myschema
Name: e_daily
Definer: jon@ghidora
Time zone: SYSTEM
Type: RECURRING
Execute at: NULL
Interval value: 1
Interval field: DAY
Starts: 2018-08-08 11:06:34
Ends: NULL
Status: ENABLED
Originator: 1
character_set_client: utf8mb4
collation_connection: utf8mb4_0900_ai_ci
Database Collation: utf8mb4_0900_ai_ci
特定のスキーマのイベントを表示するには、FROM 句を使用します。 たとえば、test スキーマのイベントを表示するには、次のステートメントを使用します。
SHOW EVENTS FROM test;
LIKE 句 (存在する場合) は、どのイベント名と照合するかを示します。 セクション26.55「SHOW ステートメントの拡張」で説明されているように、WHERE 句を指定すると、より一般的な条件を使用して行を選択できます。
SHOW EVENTS 出力には、次のカラムがあります:
-
Dbイベントが属するスキーマ (データベース) の名前。
-
Nameイベントの名前。
-
Definerイベントを作成したユーザーのアカウント (
'形式)。user_name'@'host_name' -
Time zoneイベントのタイムゾーン。イベントのスケジュールに使用され、イベントの実行時にイベント内で有効なタイムゾーンです。 デフォルト値は
SYSTEMです。 -
Typeイベントの繰返しタイプ。
ONE TIME(一時) またはRECURRING(繰返し)。 -
Execute Atワンタイムイベントの場合、これは、イベントの作成に使用される
CREATE EVENTステートメントのAT句、またはイベントを変更した最後のALTER EVENTステートメントで指定されたDATETIME値です。 このカラムに表示された値は、イベントのAT句に含まれた、INTERVAL値の加算または減算に影響します。 たとえば、イベントがON SCHEDULE AT CURRENT_TIMESTAMP + '1:6' DAY_HOURを使用して作成され、イベントが 2018-02-09 の 14:05:30 に作成された場合、カラムに表示される値は'2018-02-10 20:05:30'になります。 イベントのタイミングがAT句ではなくEVERY句で決定される場合 (つまり、イベントが繰り返しである場合)、このカラムの値はNULLになります。 -
Interval Value繰返しイベントの場合、イベント実行間で待機する間隔の数。 一時的なイベントの場合、このカラムの値は常に
NULLです。 -
Interval Field繰返しイベントが繰り返される前に待機する間隔に使用される時間単位。 一時的なイベントの場合、このカラムの値は常に
NULLです。 -
Starts繰返しイベントの開始日時。 これは
DATETIME値として表示され、このイベントの開始日付と開始時間が定義されていない場合はNULLです。 一時的なイベントの場合、このカラムは常にNULLです。 定義にSTARTS句が含まれる繰返しイベントの場合、このカラムには対応するDATETIME値が含まれます。Execute Atカラムと同様に、この値は使用される式を解決します。 イベントのタイミングに影響するSTARTS句がない場合、このカラムはNULLです -
Ends定義に
ENDS句が含まれる繰返しイベントの場合、このカラムには対応するDATETIME値が含まれます。Execute Atカラムと同様に、この値は使用される式を解決します。 イベントのタイミングに影響するENDS句がない場合、このカラムはNULLです。 -
Statusイベントステータス。
ENABLED、DISABLED、SLAVESIDE_DISABLEDのいずれか。SLAVESIDE_DISABLEDは、イベントの作成が、レプリケーションソースとして機能する別の MySQL サーバーで発生し、レプリカとして機能している現在の MySQL サーバーにレプリケートされたが、そのイベントがレプリカで現在実行されていないことを示します。 詳細は、セクション17.5.1.16「呼び出される機能のレプリケーション」 の情報を参照してください。 -
Originatorイベントが作成された MySQL サーバーのサーバー ID。レプリケーションで使用されます。 この値は、ソースサーバーで実行された場合、
ALTER EVENTによって、そのステートメントが発生したサーバーのサーバー ID に更新されることがあります。 デフォルト値は 0 です。 -
character_set_clientイベント作成時の
character_set_clientシステム変数のセッション値。 -
collation_connectionイベント作成時の
collation_connectionシステム変数のセッション値。 -
Database Collationイベントが関連付けられているデータベースの照合。
SLAVESIDE_DISABLED および Originator カラムの詳細は、セクション17.5.1.16「呼び出される機能のレプリケーション」 を参照してください。
SHOW EVENTS によって表示される時間は、セクション25.4.4「イベントメタデータ」で説明されているように、このイベントのタイムゾーンで示されます。
イベント情報は、INFORMATION_SCHEMA EVENTS テーブルからも入手できます。 セクション26.14「INFORMATION_SCHEMA EVENTS テーブル」を参照してください。
イベントのアクションステートメントは、SHOW EVENTS の出力には表示されません。 SHOW CREATE EVENT または INFORMATION_SCHEMA EVENTS テーブルを使用します。