13.7.7.2 SHOW BINLOG EVENTS ステートメント

SHOW BINLOG EVENTS
   [IN 'log_name']
   [FROM pos]
   [LIMIT [offset,] row_count]

バイナリログ内のイベントを表示します。 'log_name' を指定しない場合は、最初のバイナリログが表示されます。 SHOW BINLOG EVENTS には、REPLICATION SLAVE 権限が必要です。

LIMIT 句の構文は、SELECT ステートメントの場合と同じです。セクション13.2.10「SELECT ステートメント」を参照してください。

注記

SHOW BINLOG EVENTS を LIMIT 句なしで発行すると、サーバーはクライアントに (サーバーによって実行された、データを変更するすべてのステートメントを含む) バイナリログの完全な内容を返すため、時間とリソースを大量に消費するプロセスが開始される可能性があります。あとの調査や分析のためにバイナリログをテキストファイルに保存するには、SHOW BINLOG EVENTS の代わりに mysqlbinlog ユーティリティーを使用してください。セクション4.6.8「mysqlbinlog — バイナリログファイルを処理するためのユーティリティー」を参照してください。

SHOW BINLOG EVENTS では、バイナリログのイベントごとに次のフィールドが表示されます:

Log_name
リストされるファイルの名前。
Pos
イベントが発生する位置。
Event_type
イベントタイプを説明する識別子。
Server_id
イベントが発生したサーバーのサーバー ID。
End_log_pos
次のイベントが開始される位置。これは、Pos にイベントのサイズを加えたものです。
Info
イベントタイプの詳細情報。この情報の形式は、イベントタイプによって異なります。

圧縮されたトランザクションペイロードの場合、Transaction_payload_event は最初に単一のユニットとして印刷されてから解凍され、その内部の各イベントが印刷されます。

SHOW BINLOG EVENTS からの出力には、ユーザーおよびシステム変数の設定に関連した一部のイベントが含まれていません。バイナリログ内のイベントを完全に取得するには、mysqlbinlog を使用します。

SHOW BINLOG EVENTS は、リレーログファイルを操作しません。この目的には、SHOW RELAYLOG EVENTS を使用できます。