SHOW EVENTS [FROMschema_name
] [LIKEpattern
]
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 Type: RECURRING Execute at: NULL Interval value: 10 Interval field: INTERVAL_SECOND Starts: 2006-02-09 10:41:23 Ends: 0000-00-00 00:00:00 Status: ENABLED 1 row in set (0.01 sec)
SHOW EVENTS
のアウトプット内のカラム —
INFORMATION_SCHEMA.EVENTS
テーブル内のカラムに似ているけれど同一ではない
— がここに表されています。
Db
:イベントが定義されるスキーマ(データベース)
Name
:イベント名。
Definer
:イベントを作成したユーザアカウント。(
)
username
@hostname
Type
:ONE TIME
(一時的な)か RECURRING
の2つのうちの1つの値。
Execute
At
:一時的なイベントが実行される時の日付と時刻。DATETIME
値として表示されます。
自動更新イベントにとっては、このカラムの値はいつでも
NULL
です。
Interval
Value
:自動更新イベントの為の、イベント実行の間のインターバルの回数。
一時的イベントにとっては、このカラムの値はいつでも
NULL
です。
Interval
Field
:自動更新イベントが、次の実行までの間のインターバルに利用される時間単位。
一時的イベントにとっては、このカラムの値はいつでも
NULL
です。
Starts
:自動更新イベント開始の日付と時間。これは
DATETIME
値として表示され、これはそのイベントに開始の日付と時間が定義されない時は空白です。(MySQL
5.1.8 以前は、このような場合
'0000-00-00 00:00:00'
がデフォルトでした。)
一時的イベントにとっては、このカラムの値はいつでも
NULL
です。
Ends
:自動更新イベント終了の日付と時間。これは、そのイベント終了の日付と時刻が定義されていなければ、DATETIME
値として表示され、デフォルトは
'0000-00-00 00:00:00'
になります。
一時的イベントにとっては、このカラムの値はいつでも
NULL
です。
Status
:イベント
ステータスENABLED
か
DISABLED
のうちの1つです。
アクション ステートメントは SHOW
EVENTS
のアウトプット内に表示されていない事に注意してください。
注意:Starts
と Ends
('0000-00-00
00:00:00'
以外)を表示する値は、現在はユニバーサル
タイムを利用しています。しかし、ユニバーサル
タイムのこのコンテキスト内での利用は変更される予定ですので、アプリケーション内でこれに依存するべきでは有りません。
(バグ #16420)項21.20. 「INFORMATION_SCHEMA EVENTS
テーブル」
もご参照ください。
異なるスキーマのイベントを見るには、FROM
条項を利用できます。例えば、もし
test
スキーマが前出の例の中で選択されていたら、次のステートメントを利用して
myschema
上で定義されたイベントを見る事ができました。
SHOW EVENTS FROM myschema;
LIKE
にパターンを1つプラスした物を利用して、イベント名上でこのステートメントに返されたリストをフィルタする事ができます。
このステートメントは、MySQL 5.1.6 で追加されました。
項21.20. 「INFORMATION_SCHEMA EVENTS
テーブル」 もご参照下さい。
注意:MySQL 5.1.11
とそれ以前のバージョンでは、SHOW
EVENTS
は現在のユーザが定義者であるイベントだけを表示し、SHOW
FULL EVENTS
ステートメントは、与えられたスキーマ上で全てのユーザによって定義されたイベントを見る為に利用されていました。SHOW
FULL EVENTS
は MySQL 5.1.12
で削除されました。