説明
- 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)