説明
- V4.3.x系では、このビューはV4.3.2バージョンから導入されました。
- V4.2.x系では、このビューはV4.2.1 BP5バージョンとV4.2.4バージョンから導入されました。
機能の概要
ビュー information_schema.events は、すべてのイベント情報を記録するために使用されます。
フィールドの説明
| フィールド名 | タイプ | NULLを許容するか | 説明 |
|---|---|---|---|
| EVENT_CATALOG | varchar(64) | NO | イベントが属するディレクトリ名。この値は常にdefです。defは、システムビュー内のオブジェクトがデフォルトディレクトリに属することを示すための汎用的な識別子です。 |
| EVENT_SCHEMA | varchar(128) | NO | イベントが属するデータベース名。 |
| EVENT_NAME | varchar(64) | NO | イベントの名前。 |
| DEFINER | varchar(93) | NO | イベントを作成したユーザー。 |
| TIME_ZONE | varchar(64) | NO | イベントのタイムゾーン。つまり、イベントのスケジューリングや実行時に適用されるタイムゾーンです。デフォルト値はSYSTEMです。 |
| EVENT_BODY | varchar(8) | NO | イベントのDO句で使用されるステートメントの言語。この値は常にSQLです。 |
| EVENT_definition | mediumtext | YES | イベントのDO句を構成するSQLステートメントのテキスト。 |
| EVENT_TYPE | varchar(9) | NO | イベントの繰り返しタイプ。一回限りのものまたは繰り返し実行されるもののいずれかです。 |
| EXECUTE_AT | datetime | YES | 一回限りのイベントの開始時間。繰り返し実行されるイベントの場合、NULLとなります。 |
| INTERVAL_VALUE | varchar(256) | YES | 繰り返し実行されるイベントにおいて、イベントの実行間隔として待機する回数を表します。一回限りのイベントの場合、この値は常にNULLです。 |
| INTERVAL_FIELD | varchar(18) | YES | 繰り返し実行されるイベントが繰り返し実行される前に待機する時間単位として使用される時間間隔。一回限りのイベントの場合、この値は常にNULLです。 |
| SQL_MODE | text | NO | イベントの作成または変更時に有効なSQLモード、およびイベント実行時に使用されるSQLモード。 |
| STARTS | datetime | YES | 定期的なイベントの開始日時。イベントに開始日時が定義されていない場合は、NULLとなります。一回限りのイベントの場合、この列は常にNULLです。 |
| ENDS | datetime | YES | ENDS句を含む定義を持つ定期イベントの場合、この列には対応するDATETIME値が含まれます。EXECUTE_AT列と同様に、この値は使用される任意の式を解釈します。イベントのタイミングに影響を与えるENDS句がない場合、この列はNULLです。 |
| STATUS | varchar(18) | NO | イベントの状態。値は以下のとおりです：
|
| ON_COMPLETION | varchar(12) | NO | 値は次のとおりです：
|
| CREATED | datetime | YES | イベントの作成日時。 |
| LAST_ALTERED | datetime | YES | イベントの最終変更日時。 |
| LAST_EXECUTED | datetime | YES | イベントが最後に実行された日付と時刻。イベントが一度も実行されていない場合、この列はNULLになります。LAST_EXECUTEDはイベントの開始時間を表します。そのため、ENDS列の値は決してLAST_EXECUTEDより小さくなることはありません。 |
| EVENT_COMMENT | text | YES | イベントにコメントがある場合は、そのコメントテキストです。なければ、この値は空になります。 |
| ORIGINATOR | bigint(0) unsigned | NO | イベントを作成したMySQLサーバーのサービスIDで、レプリケーションで使用されます。レプリケーションソース上でALTER EVENTステートメントを実行すると、この値はそのステートメントが発生した時点でのサーバーのサービスIDに更新される可能性があります。デフォルト値は0です。 |
| CHARACTER_SET_CLIENT | varchar(32) | NO | イベント作成時のセッションのcharacter_set_clientシステム変数の値です。 |
| COLLATION_CONNECTION | varchar(32) | NO | イベント作成時のセッションのcollation_connectionシステム変数の値です。 |
| DATABASE_COLLATION | varchar(32) | NO | イベントに関連付けられたデータベースの照合順序です。 |
クエリ例
e_1という名前のイベントを作成します。このイベントは、西暦3000年1月1日00:00:00にスケジュールされ、SQL文SELECT 1を実行します。obclient> CREATE EVENT e_1 ON SCHEDULE AT "3000-01-01 00:00:00" DO SELECT 1;e_1イベントのすべての情報を照会します。obclient> SELECT * FROM information_schema.events\Gクエリ結果は次のとおりです：
*************************** 1. row *************************** EVENT_CATALOG: def EVENT_SCHEMA: test EVENT_NAME: e_1 DEFINER: root@% TIME_ZONE: SYSTEM EVENT_BODY: SQL EVENT_DEFINITION: select 1; EVENT_TYPE: ONE TIME EXECUTE_AT: 3000-01-01 00:00:00 INTERVAL_VALUE: NULL INTERVAL_FIELD: NULL SQL_MODE: ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION STARTS: NULL ENDS: NULL STATUS: ENABLED ON_COMPLETION: NOT PRESERVE CREATED: 2024-06-26 11:29:08 LAST_ALTERED: 2024-06-26 11:29:08 LAST_EXECUTED: NULL EVENT_COMMENT: NULL ORIGINATOR: NULL CHARACTER_SET_CLIENT: NULL COLLATION_CONNECTION: NULL DATABASE_COLLATION: NULL 1 row in set (0.002 sec)