MySQL :: MySQL 8.3 Reference Manual :: 29.12.5 Performance Schema Stage Event Tables

version 8.3

8.0 current
5.7

8.0 Japanese

MySQL 8.3 Reference Manual / ... / Performance Schema Stage Event Tables

29.12.5 性能模式阶段事件表

29.12.5.1 events_stages_current 表
29.12.5.2 events_stages_history 表
29.12.5.3 events_stages_history_long 表

性能模式instrument阶段，这些阶段是语句执行过程中的步骤，例如解析语句、打开表或执行文件排序操作。阶段对应于线程状态，显示在 SHOW PROCESSLIST 或 Information Schema PROCESSLIST 表中。阶段开始和结束时状态值发生变化。

在事件层次结构中，等待事件嵌套在阶段事件中，阶段事件嵌套在语句事件中，语句事件嵌套在事务事件中。

这些表存储阶段事件：

events_stages_current：每个线程的当前阶段事件。
events_stages_history：每个线程最近结束的阶段事件。
events_stages_history_long：所有线程最近结束的阶段事件。

以下部分描述阶段事件表。还有汇总表，聚合阶段事件信息；见第 29.12.20.2 节，“阶段汇总表”。

有关三个阶段事件表之间的关系的更多信息，请参见第 29.9 节，“性能模式当前和历史事件表”。

配置阶段事件收集

要控制是否收集阶段事件，设置相关仪器和消费者的状态：

The setup_instruments 表包含以 stage 开头的仪器名称。使用这些仪器来启用或禁用个别阶段事件类的收集。
The setup_consumers 表包含与当前和历史阶段事件表名称对应的消费者值。使用这些消费者来过滤阶段事件的收集。

除了提供语句进度信息的仪器外，阶段仪器默认情况下是禁用的。例如：

mysql> SELECT NAME, ENABLED, TIMED
       FROM performance_schema.setup_instruments
       WHERE NAME RLIKE 'stage/sql/[a-c]';
+----------------------------------------------------+---------+-------+
| NAME                                               | ENABLED | TIMED |
+----------------------------------------------------+---------+-------+
| stage/sql/After create                             | NO      | NO    |
| stage/sql/allocating local table                   | NO      | NO    |
| stage/sql/altering table                           | NO      | NO    |
| stage/sql/committing alter table to storage engine | NO      | NO    |
| stage/sql/Changing master                          | NO      | NO    |
| stage/sql/Checking master version                  | NO      | NO    |
| stage/sql/checking permissions                     | NO      | NO    |
| stage/sql/cleaning up                              | NO      | NO    |
| stage/sql/closing tables                           | NO      | NO    |
| stage/sql/Connecting to master                     | NO      | NO    |
| stage/sql/converting HEAP to MyISAM                | NO      | NO    |
| stage/sql/Copying to group table                   | NO      | NO    |
| stage/sql/Copying to tmp table                     | NO      | NO    |
| stage/sql/copy to tmp table                        | NO      | NO    |
| stage/sql/Creating sort index                      | NO      | NO    |
| stage/sql/creating table                           | NO      | NO    |
| stage/sql/Creating tmp table                       | NO      | NO    |
+----------------------------------------------------+---------+-------+

提供语句进度信息的阶段仪器默认情况下是启用和计时的：

mysql> SELECT NAME, ENABLED, TIMED
       FROM performance_schema.setup_instruments
       WHERE ENABLED='YES' AND NAME LIKE "stage/%";
+------------------------------------------------------+---------+-------+
| NAME                                                 | ENABLED | TIMED |
+------------------------------------------------------+---------+-------+
| stage/sql/copy to tmp table                          | YES     | YES   |
| stage/sql/Applying batch of row changes (write)      | YES     | YES   |
| stage/sql/Applying batch of row changes (update)     | YES     | YES   |
| stage/sql/Applying batch of row changes (delete)     | YES     | YES   |
| stage/innodb/alter table (end)                       | YES     | YES   |
| stage/innodb/alter table (flush)                     | YES     | YES   |
| stage/innodb/alter table (insert)                    | YES     | YES   |
| stage/innodb/alter table (log apply index)           | YES     | YES   |
| stage/innodb/alter table (log apply table)           | YES     | YES   |
| stage/innodb/alter table (merge sort)                | YES     | YES   |
| stage/innodb/alter table (read PK and internal sort) | YES     | YES   |
| stage/innodb/buffer pool load                        | YES     | YES   |
| stage/innodb/clone (file copy)                       | YES     | YES   |
| stage/innodb/clone (redo copy)                       | YES     | YES   |
| stage/innodb/clone (page copy)                       | YES     | YES   |
+------------------------------------------------------+---------+-------+

阶段消费者默认情况下是禁用的：

mysql> SELECT *
       FROM performance_schema.setup_consumers
       WHERE NAME LIKE 'events_stages%';
+----------------------------+---------+
| NAME                       | ENABLED |
+----------------------------+---------+
| events_stages_current      | NO      |
| events_stages_history      | NO      |
| events_stages_history_long | NO      |
+----------------------------+---------+

要在服务器启动时控制阶段事件收集，使用以下行在 my.cnf 文件中：

启用：

[mysqld]
performance-schema-instrument='stage/%=ON'
performance-schema-consumer-events-stages-current=ON
performance-schema-consumer-events-stages-history=ON
performance-schema-consumer-events-stages-history-long=ON

禁用：

[mysqld]
performance-schema-instrument='stage/%=OFF'
performance-schema-consumer-events-stages-current=OFF
performance-schema-consumer-events-stages-history=OFF
performance-schema-consumer-events-stages-history-long=OFF

要在运行时控制阶段事件收集，更新 setup_instruments 和 setup_consumers 表：

启用：

UPDATE performance_schema.setup_instruments
SET ENABLED = 'YES', TIMED = 'YES'
WHERE NAME LIKE 'stage/%';

UPDATE performance_schema.setup_consumers
SET ENABLED = 'YES'
WHERE NAME LIKE 'events_stages%';

禁用：

UPDATE performance_schema.setup_instruments
SET ENABLED = 'NO', TIMED = 'NO'
WHERE NAME LIKE 'stage/%';

UPDATE performance_schema.setup_consumers
SET ENABLED = 'NO'
WHERE NAME LIKE 'events_stages%';

仅收集特定阶段事件，请启用相应的阶段仪器。要仅收集特定阶段事件表的阶段事件，请启用阶段仪器，但仅启用相应的阶段消费者。

有关配置事件收集的更多信息，请参阅第 29.3 节，“性能架构启动配置”和第 29.4 节，“性能架构运行时配置”。

阶段事件进度信息

性能架构阶段事件表包含两个列，共同提供每行的阶段进度指示器：

WORK_COMPLETED：阶段完成的工作单元数
WORK_ESTIMATED：阶段预期的工作单元数

每个列如果没有提供进度信息，则为空。NULL。对信息的解释完全取决于仪器实现。性能架构表提供了存储进度数据的容器，但不对指标本身的语义做任何假设：

一个 “工作单元” 是一个整数指标，它在执行期间不断增加，例如处理的字节数、行数、文件数或表数。特定仪器对 “工作单元” 的定义留给提供数据的仪器代码。
WORK_COMPLETED 值可以一次增加一个或多个单位，取决于仪器代码。
WORK_ESTIMATED 值可以在阶段期间更改，取决于仪器代码。

阶段事件进度指示器的仪器可以实现以下行为：

无进度仪器

这是最典型的情况，未提供进度数据。WORK_COMPLETED 和 WORK_ESTIMATED 列都是 NULL。
无限进度仪器

只有 WORK_COMPLETED 列是有意义的。没有数据提供给 WORK_ESTIMATED 列，它显示为 0。

通过查询 events_stages_current 表来监控会话，监控应用程序可以报告已经完成的工作量，但无法报告阶段是否即将完成。目前，没有阶段是这样仪器的。
有界进度仪器

WORK_COMPLETED 和 WORK_ESTIMATED 列都是有意义的。

这种进度指示器适合具有定义完成标准的操作，例如后面描述的表复制仪器。通过查询 events_stages_current 表来监控会话，监控应用程序可以报告已经完成的工作量，并可以报告阶段的完成百分比，通过计算 WORK_COMPLETED / WORK_ESTIMATED 比率。

阶段/sql/copy 到 tmp 表仪器说明了进度指示器如何工作。在执行 ALTER TABLE 语句期间，阶段/sql/copy 到 tmp 表阶段将被使用，这个阶段可能需要很长时间，取决于要复制的数据大小。

表复制任务具有定义的终止（所有行复制），并且阶段/sql/copy 到 tmp 表阶段被仪器来提供有界进度信息：工作单元是复制的行数，WORK_COMPLETED 和 WORK_ESTIMATED 都是有意义的，它们的比率表示任务完成百分比。

要启用仪器和相关的消费者，请执行以下语句：

UPDATE performance_schema.setup_instruments
SET ENABLED='YES'
WHERE NAME='stage/sql/copy to tmp table';

UPDATE performance_schema.setup_consumers
SET ENABLED='YES'
WHERE NAME LIKE 'events_stages_%';

要查看正在进行的 ALTER TABLE 语句的进度，请从 events_stages_current 表中选择。

PREV HOME UP NEXT