#### 13.7.7.2 SHOW BINLOG EVENTS 语句

[](<>)

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

显示二进制日志中的事件。如果您不指定`'*`日志名称`*'`，显示第一个二进制日志。`显示 BINLOG 事件`需要[`复制奴隶`](privileges-provided.html#priv_replication-slave)特权。

这`限制`子句的语法与[`选择`](select.html)陈述。看[第 13.2.10 节，“SELECT 语句”](select.html).

笔记

发行[`显示 BINLOG 事件`](show-binlog-events.html)没有`限制`子句可能会启动一个非常耗费时间和资源的过程，因为服务器将二进制日志的完整内容返回给客户端（其中包括服务器执行的所有修改数据的语句）。作为替代[`显示 BINLOG 事件`](show-binlog-events.html)， 使用[**mysqlbinlog**](mysqlbinlog.html)实用程序将二进制日志保存到文本文件以供以后检查和分析。看[第 4.6.9 节，“mysqlbinlog - 处理二进制日志文件的实用程序”](mysqlbinlog.html).

[`显示 BINLOG 事件`](show-binlog-events.html)为二进制日志中的每个事件显示以下字段：

-   `日志名称`

    正在列出的文件的名称。

-   `位置`

    事件发生的位置。

-   `事件类型`

    描述事件类型的标识符。

-   `服务器编号`

    发起事件的服务器的服务器 ID。

-   `End_log_pos`

    下一个事件开始的位置，等于`位置`加上活动的规模。

-   `信息`

    有关事件类型的更多详细信息。此信息的格式取决于事件类型。

    对于压缩的事务有效载荷，`Transaction_payload_event`首先作为单个单元打印，然后将其解包并打印其中的每个事件。

    一些与用户和系统变量设置相关的事件不包括在输出中[`显示 BINLOG 事件`](show-binlog-events.html).要完整覆盖二进制日志中的事件，请使用[**mysqlbinlog**](mysqlbinlog.html).

[`显示 BINLOG 事件`](show-binlog-events.html)做*不是*使用中继日志文件。您可以使用[`显示中继日志事件`](show-relaylog-events.html)以此目的。
